# Criar um gráfico do CloudWatch com uma expressão de pesquisa
<a name="create-search-expression"></a>

No console do CloudWatch, você poderá acessar o recurso de pesquisa quando adicionar um gráfico a um painel, ou usando a visualização **Metrics** (Métricas). 

Não é possível criar um alarme com base em uma expressão **SEARCH**. Isso ocorre porque as expressões de pesquisa retornam várias séries temporais, e um alarme baseado em uma expressão matemática pode observar apenas uma série temporal.

**Para adicionar um gráfico com uma expressão de pesquisa a um painel existente**

1. Abra o console do CloudWatch, em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Dashboards (Painéis)** e selecione um painel.

1. Escolha **Add widget (Adicionar widget)**.

1. Selecione **Line (Linha)** ou **Stacked area (Área empilhada)** e depois selecione **Configure (Configurar)**.

1. Na guia **Graphed metrics (Métricas em gráfico)**, selecione **Add a math expression (Adicionar uma expressão matemática)**.

1.  Para **Details (Detalhes)**, insira a expressão de pesquisa que você deseja. Por exemplo, **SEARCH('\$1AWS/EC2,InstanceId\$1 MetricName="CPUUtilization"', 'Average')** 

1. (Opcional) Para adicionar outra expressão de pesquisa ou expressão matemática ao gráfico, selecione **Add a math expression (Adicionar uma expressão matemática)**

1. (Opcional) Depois de adicionar uma expressão de pesquisa, você pode especificar um rótulo dinâmico para aparecer na legenda do gráfico para cada métrica. Os rótulos dinâmicos exibem uma estatística sobre a métrica e são atualizados automaticamente quando o painel ou o gráfico é atualizado. Para adicionar um rótulo dinâmico, escolha **Graphed metrics (Métricas em gráfico)** e **Dynamic labels (Rótulos dinâmicos)**.

   Por padrão, os valores dinâmicos que você adiciona ao rótulo aparecem no início do rótulo. Em seguida, você pode clicar no valor do **Label (Rótulo)** para a métrica para editar o rótulo. Para obter mais informações, consulte [Usar rótulos dinâmicos](graph-dynamic-labels.md).

1. (Opcional) Para adicionar uma única métrica ao gráfico, selecione a guia **All metrics (Todas as métricas)** e analise a métrica desejada.

1. (Opcional) Para alterar o período mostrado no gráfico, selecione **custom (personalizar)** na parte superior do gráfico, ou um dos períodos à esquerda de **custom (personalizar)**.

1. <a name="horizontal-annotations"></a> (Opcional) As anotações horizontais ajudam os usuários do painel a ver rapidamente quando uma métrica aumentou bastante até determinado nível ou se a métrica está dentro de um intervalo predefinido. Para adicionar uma anotação horizontal, selecione **Graph options (Opções do gráfico)** e **Add horizontal annotation (Adicionar anotação horizontal)**:

   1. Em **Label (Rótulo)**, insira um rótulo para a anotação.

   1. Em **Value (Valor)**, insira o valor da métrica em que a anotação horizontal aparece.

   1. Em **Fill**, especifique se o preenchimento do sombreamento deve ser usado com essa anotação. Por exemplo, selecione `Above` ou `Below` para a área correspondente ser preenchida. Se você especificar `Between`, outro campo `Value` será exibido e a área do gráfico entre os dois valores será preenchida.

   1. Em **Axis (Eixos)**, especifique se os números em `Value` se referem à métrica associada ao eixo Y esquerdo ou direito, caso o gráfico inclua várias métricas.

      Você pode alterar a cor de preenchimento de uma anotação, escolhendo a cor no quadrado de cores na coluna à esquerda da anotação. 

   Repita essas etapas para adicionar várias anotações horizontais ao mesmo gráfico.

   Para ocultar uma anotação, desmarque a caixa de seleção na coluna da esquerda para essa anotação.

   Para excluir uma anotação, selecione **x** na coluna **Actions (Ações)**.

1. <a name="vertical-annotations"></a> (Opcional) Anotações verticais ajudam você a marcar as etapas em um gráfico, como eventos operacionais ou o início e o fim de uma implantação. Para adicionar uma anotação vertical, selecione **Graph options (Opções de gráfico)** e **Add vertical annotation (Adicionar anotação vertical)**:

   1. Em **Label (Rótulo)**, insira um rótulo para a anotação. Para exibir apenas a data e hora na anotação, mantenha o campo **Label (Rótulo)** em branco.

   1. Para **Date (Data)**, especifique a data e hora onde a anotação vertical aparece.

   1. Para **Fill (Preencher)**, especifique se deseja usar preenchimento do sombreamento antes ou depois de uma anotação vertical, ou entre duas anotações verticais. Por exemplo, selecione `Before` ou `After` para a área correspondente ser preenchida. Se você especificar `Between`, outro campo `Date` será exibido e a área do gráfico entre os dois valores será preenchida.

   Repita essas etapas para adicionar várias anotações verticais ao mesmo gráfico.

   Para ocultar uma anotação, desmarque a caixa de seleção na coluna da esquerda para essa anotação.

   Para excluir uma anotação, selecione **x** na coluna **Actions (Ações)**.

1. Selecione **Create widget (Criar widget)**.

1. Escolha **Save dashboard (Salvar painel)**.

**Para usar a visualização Metrics (Métricas) para criar gráficos de métricas pesquisadas**

1. Abra o console do CloudWatch, em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Metrics** (Métricas), **All metrics** (Todas as métricas).

1. No campo de pesquisa, insira os tokens a serem pesquisados: por exemplo, **cpuutilization t2.small**.

   Os resultados que correspondem à pesquisa aparecem.

1. Para criar um gráfico de todas as métricas que correspondem à pesquisa, selecione **Graph search (Criar gráfico da pesquisa)**.

   ou

   Para refinar a pesquisa, escolha um dos namespaces que apareceram nos resultados de pesquisa.

1. Se tiver selecionado um namespace para refinar os resultados, você poderá fazer o seguinte: 

   1. Para criar um gráfico de uma ou mais métricas, marque a caixa de seleção ao lado de cada métrica. Para selecionar todas as métricas, marque a caixa de seleção na linha de cabeçalho da tabela.

   1. Para refinar a pesquisa, passe o mouse sobre o nome de uma métrica e selecione **Add to search (Adicionar à pesquisa)** ou **Search for this only (Pesquisar apenas por isto)**.

   1. Para visualizar a ajuda para uma métrica, selecione o nome da métrica e escolha **What is this? (O que é isso?)**.

   As métricas selecionadas aparecem no gráfico.

1. (Opcional) Selecione um dos botões na barra de pesquisa para editar a parte do termo de pesquisa.

1. (Opcional) Para adicionar o gráfico a um painel, selecione **Actions (Ações)** e **Add to dashboard (Adicionar ao painel)**.