Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Sintaxis del patrón de filtro para filtros métricos

Los filtros de métricas le permiten buscar y filtrar los datos de registro que entran en los Registros de CloudWatch, extraer observaciones métricas de los datos de registro filtrados y transformar los puntos de datos en una métrica de Registros de CloudWatch. Se definen los términos y patrones que hay que buscar en los datos de registro a medida que se envían a los Registros de CloudWatch. Los filtros de métricas se asignan a grupos de registro y todos los filtros asignados a un grupo de registros se aplican a sus flujos de registro.

Cuando un filtro de métricas coincide con un término, incrementa el recuento de la métrica a un valor numérico especificado. Por ejemplo, puede crear un filtro de métricas cuente cuántas veces aparece la palabra ERROR en los eventos de registro.

Puede asignar unidades de medida y dimensiones a una métrica. Por ejemplo, si crea un filtro de métricas que cuenta las veces que aparece la palabra ERROR en los eventos de registro, puede especificar una dimensión denominada ErrorCode para mostrar el número total de eventos de registro que contienen la palabra ERROR y filtrar los datos por códigos de error notificados.

Configuración de valores de métrica para un filtro de métricas

Al crear un filtro de métricas, defina el patrón de filtro y especifique el valor y el valor predeterminado de la métrica. Puede establecer valores de métrica en números, identificadores con nombre o identificadores numéricos. Si no especifica un valor predeterminado, CloudWatch no informará de los datos cuando el filtro de métricas no encuentre ninguna coincidencia. Se recomienda especificar un valor predeterminado, incluso si el valor es 0. La configuración de un valor predeterminado ayuda a CloudWatch a generar informes de datos con mayor precisión e impide que CloudWatch agregue métricas irregulares. CloudWatch agrega e informa los valores de métrica cada minuto.

Cuando el filtro de métricas encuentra una coincidencia en los eventos de registro, incrementa el recuento de la métrica según el valor de esta. Si el filtro de métricas no encuentra ninguna coincidencia, CloudWatch informa del valor predeterminado de la métrica. Por ejemplo, su grupo de registro publica dos registros cada minuto, el valor de la métrica es 1 y el valor predeterminado es 0. Si el filtro de métricas encuentra coincidencias en ambos registros en el primer minuto, el valor de la métrica para ese minuto es 2. Si el filtro de métricas no encuentra coincidencias en ninguno de los registros durante el segundo minuto, el valor predeterminado para ese minuto es 0. Si asigna dimensiones a las métricas que generan los filtros de métricas, no puede especificar los valores predeterminados para esas métricas.

También puede configurar un filtro de métricas para incrementar una métrica con un valor extraído de un evento de registro, en lugar de un valor estático. Para obtener más información, consulte Uso de valores en eventos de registro para aumentar el valor de una métrica.

Publicar dimensiones con métricas de valores en JSON o eventos de registro delimitados por espacios

Puede utilizar la consola de CloudWatch o la CLI de AWS para crear filtros de métricas que publican dimensiones con métricas que JSON y eventos de registro delimitados por espacios generan. Las dimensiones son pares de nombre/valor y solo están disponibles para patrones de filtro JSON y delimitados por espacios. Puede crear filtros de métricas JSON y delimitados por espacios con hasta tres dimensiones. Para obtener más información sobre las dimensiones y sobre cómo asignarlas a las métricas, consulte las siguientes secciones:

Uso de valores en eventos de registro para aumentar el valor de una métrica

Puede crear filtros de métricas que publiquen los valores numéricos que se encuentran en los eventos de registro. El procedimiento de esta sección utiliza el siguiente filtro de métricas de ejemplo para mostrar cómo se puede publicar un valor numérico en un evento de registro JSON en una métrica.

{ $.latency = * } metricValue: $.latency

El filtro de métricas de ejemplo coincide con el término "latency" en el evento de registro JSON de muestra y publica un valor numérico de 50 en la métrica myMetric.

{
"latency": 50,
"requestType": "GET"
}