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
nota
En qué se diferencian los filtros métricos y las consultas de CloudWatch Logs
Los filtros de métricas se diferencian de las consultas de CloudWatch Logs Insights en que se agrega un valor numérico específico a un filtro de métricas cada vez que se encuentra un registro coincidente. Para obtener más información, consulte Configuración de valores de métrica para un filtro de métricas.
Para obtener información sobre cómo consultar sus grupos de CloudWatch registros con el lenguaje de consulta de Amazon Logs Insights, consulteCloudWatch Registra la sintaxis de consulta del idioma Insights.
Ejemplos de patrones de filtro genéricos
Para obtener más información sobre la sintaxis del patrón de filtro genérico aplicable a los filtros de métricas, así como a los filtros de suscripción y a los eventos de registro de filtros, consulte Sintaxis de patrones de filtros para filtros de métricas, filtros de suscripción y eventos de registro de filtros, que incluye los siguientes ejemplos:
Sintaxis de expresiones regulares (regex) compatibles
Coincidencia de términos en eventos de registro no estructurado
Términos coincidentes en los eventos de JSON registro
Coincidencia de términos en eventos de registro delimitados por espacios
Los filtros métricos permiten buscar y filtrar los datos de registro que entran en CloudWatch los registros, extraer observaciones métricas de los datos de registro filtrados y transformar los puntos de datos en una métrica de CloudWatch registros. Usted define los términos y patrones que se deben buscar en los datos de registro a medida que se envían a CloudWatch Logs. Los filtros de métricas se asignan a grupos de registro y todos los filtros asignados a un grupo de registro 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 métrico que cuente el número de veces que ERRORaparece la palabra en sus eventos de registro.
Puede asignar unidades de medida y dimensiones a una métrica. Por ejemplo, si crea un filtro métrico que cuente el número de veces que ERRORaparece la palabra en el registro de eventos, puede especificar una dimensión a la que se llame ErrorCode
para mostrar el número total de eventos de registro que contienen la palabra ERRORy filtrar los datos según los códigos de error notificados.
sugerencia
Al asignar una unidad de medida a una métrica, asegúrese de especificar la correcta. Si cambia la unidad más adelante, es posible que el cambio no surta efecto. Para ver la lista completa de las unidades CloudWatch compatibles, consulta MetricDatumla Amazon CloudWatch API Reference.
Temas
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 especificas un valor predeterminado, CloudWatch no se mostrarán los datos cuando el filtro de métricas no encuentre ninguna coincidencia. Se recomienda especificar un valor predeterminado, incluso si el valor es 0. Establecer un valor predeterminado ayuda a CloudWatch informar los datos con mayor precisión y CloudWatch evita la agregación de métricas irregulares. CloudWatch agrega e informa los valores de las métricas 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, muestra CloudWatch el 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 a partir de valores de eventos de JSON registro o delimitados por espacios
Puede usar la CloudWatch consola o AWS CLI crear filtros de métricas que publiquen las dimensiones con las métricas que generan los eventos de registro JSON delimitados por espacios. Las dimensiones son pares de nombre/valor y solo están disponibles para los patrones de filtro delimitados por espaciosJSON. Puede crear filtros métricos JSON 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:
Dimensiones en la guía del CloudWatch usuario de Amazon
Ejemplo: extraer campos de un registro de Apache y asignar dimensiones en la Guía del usuario de Amazon CloudWatch Logs
importante
Las dimensiones contienen valores que recopilan cargos igual que las métricas personalizadas. Para evitar cargos inesperados, no especifique campos de alta cardinalidad, como IPAddress
o requestID
, como dimensiones.
Si extrae métricas de eventos de registro, se le cobran como métricas personalizadas. Para evitar que contraiga cargos elevados accidentales, es posible que Amazon desactive su filtro de métrica si genera 1000 pares de nombre/valor diferentes para las dimensiones especificadas en un plazo determinado.
Puede crear alarmas de facturación que le notifiquen los cargos estimados. Para obtener más información, consulte Crear una alarma de facturación para controlar AWS los cargos estimados.
Los siguientes ejemplos contienen fragmentos de código que describen cómo especificar las dimensiones en un filtro de JSON métricas.
En los ejemplos siguientes, se incluyen fragmentos de código que describen cómo especificar dimensiones en un filtro de métricas delimitado por espacios.
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étrica de ejemplo para mostrar cómo se puede publicar un valor numérico de un evento de JSON registro en una métrica.
{ $.latency = * } metricValue: $.latency
Para crear un filtro de métricas que publique un valor en un evento de registro
Abra la CloudWatch consola en https://console.aws.amazon.com/cloudwatch/
. -
En el panel de navegación, elija Logs (Registros) y, luego, Log groups (Grupos de registro).
-
Seleccione o cree un grupo de registro.
Para obtener información sobre cómo crear un grupo de registros, consulte Crear un grupo de CloudWatch registros en Logs en la Guía del usuario de Amazon CloudWatch Logs.
-
Elija Actions (Acciones) y, a continuación, seleccione Create metric filter (Crear filtro de métrica).
-
En Filter Pattern (Patrón de filtro), ingrese
{ $.latency = * }
y, a continuación, elija Next (Siguiente). -
En Metric name (Nombre de métrica), escriba myMetric.
-
En Metric Value (Valor de métrica), escriba
$.latency
. (Opcional) En Default Value (Valor predeterminado), ingrese 0 y, a continuación, elija Next (Siguiente).
Se recomienda especificar un valor predeterminado, incluso si el valor es 0. Establecer un valor predeterminado ayuda a CloudWatch informar los datos con mayor precisión y CloudWatch evita la agregación de métricas irregulares. CloudWatch agrega e informa los valores de las métricas cada minuto.
Elija Create metric filter (Crear filtro de métricas).
El filtro de métricas de ejemplo coincide con el término "latency"
del evento de JSON registro del ejemplo y publica un valor numérico de 50 en la métrica myMetric.
{
"latency": 50,
"requestType": "GET"
}