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.
Creación de métricas a partir de eventos de registro mediante filtros
Puede buscar y filtrar los datos de registro que entran en CloudWatch los registros creando uno o más filtros de métricas. Los filtros métricos definen los términos y patrones que se deben buscar en los datos de registro a medida que se envían a CloudWatch los registros. CloudWatch Logs utiliza estos filtros de métricas para convertir los datos de registro en CloudWatch métricas numéricas que se pueden representar gráficamente o activar una alarma.
Al crear una métrica a partir de un filtro de registro, también puede optar por asignar dimensiones y una unidad a la métrica. Si especifica una unidad, asegúrese de especificar la correcta cuando cree el filtro. Cambiar la unidad del filtro más tarde no tendrá ningún efecto.
Si un grupo de registros con una suscripción utiliza la transformación de registros, el patrón de filtro se aplica a las versiones transformadas de los eventos del registro. Para obtener más información, consulte Transforma los registros durante la ingestión.
nota
Los filtros de métricas solo se admiten en los grupos de registro de la clase de registro Estándar. Para obtener más información acerca de las clases de registros, consulte Clases de registro.
Puede usar cualquier tipo de CloudWatch estadística, incluidas las estadísticas de percentiles, al ver estas métricas o configurar las alarmas.
nota
Las métricas admiten estadísticas de percentiles solo si ninguno de sus valores es negativo. Si configura el filtro de métricas para que pueda notificar números negativos, las estadísticas de percentiles no estarán disponibles para esa métrica cuando tenga valores de números negativos. Para obtener más información, consulte Percentiles.
Los filtros no pueden filtrar datos retroactivamente. Los filtros solo publican los puntos de datos de métricas para eventos que ocurran después de la creación del filtro. Los resultados filtrados devuelven las primeras 50 líneas, que no se mostrarán si la marca temporal en los resultados filtrados es anterior al momento de la creación de la métrica.
Contenido
Conceptos
Cada filtro de métrica se compone de los siguientes elementos principales:
- valor predeterminado
-
El valor registrado en el filtro de métricas durante un periodo cuando se ingieren registros, pero no se encuentra ningún registro coincidente. Al configurar este valor como 0, garantiza que los datos se registran durante cada periodo, lo que impide métricas “irregulares” con periodos en los que no hay datos coincidentes. Si no se ingieren registros durante un periodo de un minuto, no se notifica ningún valor.
Si asigna dimensiones a una métrica creada por un filtro de métrica, no puede asignar un valor predeterminado a esa métrica.
- dimensiones
-
Las dimensiones son los pares de valor de clave que definen aún más una métrica. Puede asignar dimensiones a la métrica creada a partir de un filtro de métrica. Dado que las dimensiones forman parte del identificador único de una métrica, cada vez que se extrae un par nombre/valor único de sus registros, se crea una nueva variación de esa métrica.
- patrón de filtro
-
Una descripción simbólica de cómo CloudWatch los registros deben interpretar los datos de cada evento de registro. Por ejemplo, una entrada de registro puede contener las marcas temporales, direcciones IP, cadenas, etc. Puede utilizar el patrón para especificar lo que hay que buscar en el archivo de registro.
- nombre de métrica
-
El nombre de la CloudWatch métrica en la que se debe publicar la información de registro supervisada. Por ejemplo, puede publicar en una métrica llamada ErrorCount.
- espacio de nombres de métrica
-
El espacio de nombres de destino de la nueva CloudWatch métrica.
- valor de métrica
-
El valor numérico para publicar en la métrica cada vez que se encuentra un registro coincidente. Por ejemplo, si está contando las incidencias de un término determinado como “Error”, el valor será “1” para cada incidencia. Si está contando los bytes transferidos, puede incrementar según el número real de bytes encontrados en el evento de registro.