

# Ejemplos de expresiones de búsqueda de CloudWatch
<a name="search-expression-examples"></a>

Los siguientes ejemplos ilustran otros usos y sintaxis de expresiones de búsqueda. Comencemos con una búsqueda de `CPUUtilization` en todas las instancias de la región y luego veremos las variaciones.

Este ejemplo muestra una línea para cada instancia de la región, que muestra la métrica `CPUUtilization` del espacio de nombres `AWS/EC2`.

```
SEARCH(' {AWS/EC2,InstanceId} MetricName="CPUUtilization" ', 'Average')
```

Si `InstanceId` se cambia por `InstanceType`, el gráfico cambia para mostrar una línea para cada tipo de instancia utilizado en la región. Los datos de todas las instancias de cada tipo se agrupan en una línea para ese tipo de instancia.

```
SEARCH(' {AWS/EC2,InstanceType} MetricName="CPUUtilization" ', 'Average')
```

El siguiente ejemplo agrupa la métrica `CPUUtilization` por tipo de instancia y muestra una línea para cada tipo de instancia que incluye la cadena `micro`.

```
SEARCH('{AWS/EC2,InstanceType} InstanceType=micro MetricName="CPUUtilization" ', 'Average')
```

Este ejemplo acota los resultados del ejemplo anterior, al cambiar `InstanceType` por una búsqueda exacta de instancias t2.micro.

```
SEARCH('{AWS/EC2,InstanceType} InstanceType="t2.micro" MetricName="CPUUtilization" ', 'Average')
```

La siguiente búsqueda elimina la parte `{metric schema}` de la consulta, por lo que la métrica `CPUUtilization` de todos los espacios de nombres aparece en el gráfico. Esta búsqueda puede devolver bastantes resultados, ya que el gráfico incluye varias líneas para la métrica `CPUUtilization` de cada servicio de AWS, agrupadas por dimensiones diferentes. 

```
SEARCH('MetricName="CPUUtilization" ', 'Average')
```

Para reducir un poco estos resultados, puede especificar dos espacios de nombres de métricas específicos. 

```
SEARCH('MetricName="CPUUtilization" AND ("AWS/ECS" OR "AWS/ES") ', 'Average')
```

El ejemplo anterior es la única manera de hacer una búsqueda de varios espacios de nombres con una sola consulta de búsqueda, ya que solo se puede especificar un esquema de métrica en cada consulta. Sin embargo, para estructurar más la búsqueda, podría utilizar dos consultas en el gráfico, tal y como se muestra en el siguiente ejemplo. Este ejemplo también añade más estructura al especificar la dimensión que se va a utilizar para agrupar los datos de Amazon ECS.

```
SEARCH('{AWS/ECS ClusterName}, MetricName="CPUUtilization" ', 'Average')
SEARCH(' {AWS/EBS} MetricName="CPUUtilization" ', 'Average')
```

En el siguiente ejemplo se devuelve la métrica Elastic Load Balancing denominada `ConsumedLCUs`, además de todas las métricas o dimensiones de Elastic Load Balancing que contienen el token `flow`. 

```
SEARCH('{AWS/NetworkELB, LoadBalancer} "ConsumedLCUs" OR flow ', 'Maximum')
```

En el ejemplo siguiente se utiliza la agrupación anidada. Devuelve las métricas de Lambda para `Errors` de todas las funciones y las `Invocations` de funciones con nombres que incluyen las cadenas de `ProjectA` o `ProjectB`.

```
SEARCH('{AWS/Lambda,FunctionName} MetricName="Errors" OR (MetricName="Invocations" AND (ProjectA OR ProjectB)) ', 'Average')
```

El siguiente ejemplo muestra todas las métricas personalizadas, salvo las métricas generadas por servicios de AWS.

```
SEARCH('NOT Namespace=AWS ', 'Average')
```

El siguiente ejemplo muestra las métricas con nombres de métrica, espacios de nombres, nombres de dimensión y valores de dimensión que contienen la cadena `Errors` como parte de su nombre.

```
SEARCH('Errors', 'Average')
```

El siguiente ejemplo acota esa búsqueda para que solo se devuelvan coincidencias exactas. Por ejemplo, esta búsqueda busca el nombre de métrica `Errors`, pero no las métricas llamadas `ConnectionErrors` o `errors`.

```
SEARCH(' "Errors" ', 'Average')
```

En el siguiente ejemplo se muestra cómo especificar nombres que contengan espacios o caracteres especiales en la parte del esquema de métrica del término de búsqueda.

```
SEARCH('{"Custom-Namespace", "Dimension Name With Spaces"}, ErrorCount ', 'Maximum')
```

## Ejemplos de expresiones de búsqueda para la observabilidad entre cuentas de CloudWatch
<a name="search-expression-examples"></a>

**Ejemplos de observabilidad entre cuentas de CloudWatch**

Si inicia sesión en una cuenta configurada como cuenta de supervisión para la observabilidad entre cuentas de CloudWatch, puede usar la función **SEARCH** (BUSCAR) para obtener métricas de cuentas de origen especificadas. Para obtener más información, consulte [Observabilidad entre cuentas de CloudWatch](CloudWatch-Unified-Cross-Account.md).

En el siguiente ejemplo se recuperan todas las métricas de Lambda de la cuenta con ID 111122223333.

```
SEARCH(' AWS/Lambda :aws.AccountId = 111122223333 ', 'Average')
```

En el siguiente ejemplo se recuperan todas las métricas `AWS/EC2` de dos cuentas: 111122223333 y 777788889999.

```
SEARCH(' AWS/EC2 :aws.AccountId = (111122223333 OR 777788889999) ', 'Average')
```

En el siguiente ejemplo se recuperan todas las métricas `AWS/EC2` de la cuenta de origen 111122223333 y de la propia cuenta de supervisión.

```
SEARCH(' AWS/EC2 :aws.AccountId = (111122223333 OR 'LOCAL') ', 'Average')
```

En el siguiente ejemplo, se recupera el `SUM` de la métrica `MetaDataToken` de la cuenta `444455556666` con la dimensión `InstanceId`.

```
SEARCH('{AWS/EC2,InstanceId} :aws.AccountId=444455556666 MetricName=\"MetadataNoToken\"','Sum')
```