Descripción general

Se utilizan muchos tipos de registros para realizar un seguimiento de las tendencias, como los KPI, durante largos períodos de tiempo. Generar métricas a partir de sus registros es una forma rentable de resumir datos provenientes de registros de alto volumen, como los registros de CDN, registros de flujo de VPC, registros de firewall y registros de red. Utilice el procesador Generar métricas para generar métricas de conteo, gauge o distribución a partir de registros que coincidan con una consulta, y envíe las métricas a su destino.

Nota: Las métricas generadas a partir de registros y enviadas a Datadog son Métricas personalizadas y se facturan en consecuencia. Consulte Custom Metrics Billing para obtener más información.

Configuración

Para configurar el procesador:

Haga clic en Manage Metrics para crear nuevas métricas o editar las existentes. Esto abre un panel lateral.

• Si aún no ha creado ninguna métrica, ingrese los parámetros de la métrica como se describe en la sección Agregar una métrica para crear una métrica.
• Si ya ha creado métricas, haga clic en la fila de la métrica en la tabla de resumen para editarla o eliminarla. Utilice la barra de búsqueda para encontrar una métrica específica por su nombre y, luego, seleccione la métrica para editarla o eliminarla. Haga clic en Add Metric para agregar otra métrica.

Agregar una métrica

1. Ingrese una consulta de filtro. Consulte Sintaxis de búsqueda de registros para obtener más información.
   • Solo se procesan los registros que coinciden con el filtro.
   • Todos los registros, independientemente de si coinciden con la consulta de filtro, se envían al siguiente paso de la canalización.
   • Nota: Dado que un solo procesador puede generar múltiples métricas, puede definir una consulta de filtro diferente para cada métrica.
2. Ingrese un nombre para la métrica.
3. En la sección Define parameters, seleccione el tipo de métrica (conteo, gauge o distribución). Consulte el ejemplo de métrica de conteo y el ejemplo de métrica de distribución. Consulte también Tipos de métricas para obtener más información.
   • Para los tipos de métricas gauge y distribución, seleccione un campo de registro que tenga un valor numérico (o una cadena numérica analizable) que se utilice para el valor de la métrica generada.
   • Para el tipo de métrica de distribución, el valor del campo de registro puede ser una matriz de valores numéricos (analizables), que se utiliza para el conjunto de muestras de la métrica generada.
   • El campo Group by determina cómo se agrupan los valores de las métricas. Por ejemplo, si tiene cientos de servidores distribuidos en cuatro regiones, agrupar por región le permite graficar una línea para cada región. Los campos enumerados en la configuración Group by se establecen como etiquetas en la métrica configurada.
4. Haga clic en Add Metric.

Configure un destino de métricas

1. En el procesador Generar métricas, haga clic en Add Metrics Destination.
   Nota: Si está utilizando Pipeline Simulation, regrese a la página de la canalización para configurar su destino de métricas. Haga clic en Back to pipeline en la esquina superior derecha de la página Pipeline Simulation.
2. Datadog Metrics es el destino predeterminado. Para seleccionar un destino diferente, haga clic en el icono de lápiz en el destino Datadog Metrics y seleccione Change metrics destination.
3. Seleccione su destino y siga las instrucciones de configuración para el destino específico.

Tipos de métricas

Puede generar estos tipos de métricas para sus registros. Consulte la documentación de Tipos de métricas y Distribuciones para obtener más detalles.

Ejemplo de métrica de conteo

Para este ejemplo de registro status:error:

{"status": "error", "env": "prod", "host": "ip-172-25-222-111.ec2.internal"}

Para crear una métrica de conteo que cuente el número de registros que contienen "status":"error" y los agrupe por env y host, ingrese la siguiente información:

Ejemplo de métrica de distribución

Para este ejemplo de un registro de respuesta de API:

{
    "timestamp": "2018-10-15T17:01:33Z",
    "method": "GET",
    "status": 200,
    "request_body": "{"information"}",
    "response_time_seconds: 10
}

Para crear una métrica de distribución que mida el tiempo promedio que toma realizar una llamada a la API, ingrese la siguiente información:

Convertir marca de tiempo de cadena a formato de marca de tiempo

El procesador Generate Metrics solo puede usar el campo de registro timestamp para establecer la marca de tiempo de la métrica si el campo de registro es de tipo marca de tiempo. Si el campo timestamp es una cadena, se utiliza en su lugar la hora en que se procesa el registro. Para usar el registro timestamp, debe convertir la cadena a un tipo de marca de tiempo antes de enviar el registro al procesador Generar métricas.

Para convertir una cadena de marca de tiempo al formato de marca de tiempo:

1. Agregue un Custom Processor a su canalización antes del procesador Generar métricas.
2. Agregue una función con el siguiente script personalizado:

   .timestamp = parse_timestamp!(.timestamp, format: "%+")
   

   See parse_timestamp for more information.

Métricas de salud

Para métricas de componentes y métricas de búfer del procesador emitidas por todos los procesadores, consulte la documentación de métricas de uso de canalizaciones.

Métricas del procesador Generar métricas

• Utilice la etiqueta component_id para filtrar o agrupar por componentes individuales.
• La etiqueta component_type es generate_metrics para las métricas de este procesador.

pipelines.generated_metrics_from_logs_total

Descripción: La cantidad de métricas generadas a partir de eventos de registro por el procesador.

Tipo de métrica: count