# Crear un gráfico de CloudWatch con una expresión de búsqueda
<a name="create-search-expression"></a>

En la consola de CloudWatch, puede acceder a la función de búsqueda cuando agrega un gráfico a un panel o mediante la vista **Metrics** (Métricas). 

No es posible crear una alarma con una expresión **SEARCH** (de búsqueda). Esto se debe a que las expresiones de búsqueda devuelven varias series temporales, y una alarma basada en una expresión matemática sólo puede ver una serie temporal.

**Para añadir un gráfico con una expresión de búsqueda a un panel existente**

1. Abra la consola de CloudWatch en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. En el panel de navegación, elija **Dashboards (Paneles)** y seleccione un panel.

1. Elija **Add widget (Añadir widget)**.

1. Elija **Line (Línea)** o **Stacked area (Área apilada)** y seleccione **Configure (Configurar)**.

1. En la pestaña **Graphed metrics (Métricas diagramadas)**, elija **Add a math expression (Añadir una expresión matemática)**.

1.  En **Details (Detalles)**, escriba la expresión de búsqueda que desee. Por ejemplo: ., **SEARCH('\$1AWS/EC2,InstanceId\$1 MetricName="CPUUtilization"', 'Average')** 

1. (Opcional) Para añadir otra expresión de búsqueda o expresión matemática al gráfico, elija **Add a math expresión (Añadir una expresión matemática)**.

1. (Opcional) Después de añadir una expresión de búsqueda, puede especificar una etiqueta dinámica para que aparezca en la leyenda del gráfico de cada métrica. Las etiquetas dinámicas muestran una estadística acerca de la métrica y se actualizan automáticamente cuando se actualiza el panel o el gráfico. Para añadir una etiqueta dinámica, elija **Graphed metrics (Métricas representadas gráficamente)** y, a continuación, **Dynamic labels (Etiquetas dinámicas)**.

   De forma predeterminada, los valores dinámicos que añade a la etiqueta aparecen al principio de la etiqueta. A continuación, puede elegir el valor de **Label (Etiqueta)** de la métrica para editar la etiqueta. Para obtener más información, consulte [Uso de etiquetas dinámicas](graph-dynamic-labels.md).

1. (Opcional) Para añadir una sola métrica al gráfico, elija la pestaña **All metrics (Todas las métricas)** y desplácese hasta la métrica que desee.

1. (Opcional) Para cambiar el intervalo de tiempo que se muestra en el gráfico, elija **custom (personalizado)** en la parte superior del gráfico o uno de los períodos de tiempo a la izquierda de **custom (personalizado)**.

1. <a name="horizontal-annotations"></a> (Opcional) Las anotaciones horizontales ayudan a los usuarios del panel a ver rápidamente cuándo una métrica ha aumentado hasta un determinado nivel o si la métrica está dentro de un intervalo predefinido. Para añadir una anotación horizontal, elija **Graph options (Opciones de gráfico)** y después **Add horizontal annotation (Añadir anotación horizontal)**:

   1. En **Label (Etiqueta)**, escriba la etiqueta de la anotación.

   1. En **Value (Valor)**, escriba el valor de métrica en el que aparece la anotación horizontal.

   1. En **Fill**, especifique si se usará sombreado de relleno con esta anotación. Por ejemplo, elija `Above` o `Below` para el área correspondiente que se rellenará. Si especifica `Between`, aparece otro campo `Value` y se rellena el área del gráfico entre los dos valores.

   1. En **Axis (Eje)**, especifique si los números de `Value` hacen referencia a la métrica asociada con el eje Y izquierdo o con el eje Y derecho, en caso de que el gráfico incluya varias métricas.

      Puede cambiar el color de relleno de una anotación eligiendo el cuadrado de color en la columna izquierda de la anotación. 

   Repita estos pasos para agregar varias anotaciones horizontales al mismo gráfico.

   Para ocultar una anotación, quite la marca de la casilla en la columna izquierda de dicha anotación.

   Para eliminar una anotación, elija **x** en la columna **Actions**.

1. <a name="vertical-annotations"></a> (Opcional) Las anotaciones verticales le ayudan a marcar hitos en un gráfico como, por ejemplo, eventos operativos o el principio y el final de una implementación. Para añadir una anotación vertical, elija **Graph options (Opciones del gráfico)** y después **Add vertical annotation (Añadir anotación vertical)**:

   1. En **Label (Etiqueta)**, escriba la etiqueta de la anotación. Para mostrar solo la fecha y la hora en la anotación, deje el campo **Label (Etiqueta)** vacío.

   1. Para **Date (Fecha)**, especifique la fecha y la hora en que aparece la anotación vertical.

   1. En **Fill (Relleno)**, especifique si se utiliza sombreado de relleno antes o después de una anotación vertical o entre dos anotaciones verticales. Por ejemplo, elija `Before` o `After` para el área correspondiente que se rellenará. Si especifica `Between`, aparece otro campo `Date` y se rellena el área del gráfico entre los dos valores.

   Repita estos pasos para agregar varias anotaciones verticales al mismo gráfico.

   Para ocultar una anotación, quite la marca de la casilla en la columna izquierda de dicha anotación.

   Para eliminar una anotación, elija **x** en la columna **Actions**.

1. Elija **Create widget** (Crear widget).

1. Elija **Save dashboard (Guardar panel)**.

**Para utilizar la vista de métricas para representar gráficamente las métricas buscadas**

1. Abra la consola de CloudWatch en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. En el panel de navegación, seleccione **Métricas** y, a continuación, **Todas las métricas**.

1. En el campo de búsqueda, escriba los tokens que desea buscar (por ejemplo, )., **cpuutilization t2.small**.

   Se muestran los resultados que coinciden con su búsqueda.

1. Para representar gráficamente todas las métricas que coinciden con su búsqueda, elija **Graph search (Diagramar búsqueda)**.

   o

   Para acotar la búsqueda, elija uno de los espacios de nombres que apareció en los resultados de la búsqueda.

1. Si ha seleccionado un espacio de nombres para restringir los resultados, puede hacer lo siguiente: 

   1. Para representar gráficamente una o varias métricas, seleccione la casilla de verificación junto a cada métrica. Para seleccionar todas las métricas, seleccione la casilla de verificación en la fila de encabezado de la tabla.

   1. Para acotar la búsqueda, coloque el cursor sobre un nombre de métrica y elija **Add to search (Añadir a búsqueda)** o **Search for this only (Buscar solo esto)**.

   1. Para ver la ayuda de una métrica, elija el nombre de la métrica y, a continuación, seleccione **What is this?**.

   Las métricas seleccionadas aparecen en el gráfico.

1. (Opcional) Seleccione uno de los botones de la barra de búsqueda para editar esa parte del término de búsqueda.

1. (Opcional) Para agregar su gráfico a un panel, elija **Actions (Acciones)** y después **Add to dashboard (Añadir al panel)**.