Configuración de métricas personalizadas

Angie puede recopilar métricas numéricas personalizadas en memoria compartida y exponerlas a través de la API de estadísticas en tiempo real en /status/http/metric_zones/. Esto lo proporciona el módulo HTTP Metric.

Nota

Esta guía trata las métricas del tráfico HTTP. Para el tráfico TCP y UDP, consulte el módulo Stream Metric, que expone sus zonas en /status/stream/metric_zones/.

Módulos relacionados

• Módulo HTTP Metric: crea las zonas y las actualiza.

• Módulo API: sirve las zonas en la rama metric_zones.

Pasos de configuración

1. Defina una zona de métricas en el bloque http:

   • metric_zone crea una zona con un modo de métrica única.

   • metric_complex_zone crea una zona con múltiples métricas nombradas.

2. Actualice las métricas en el procesamiento de solicitudes con la directiva metric. Use un par clave=valor (ambos son valores complejos), y elija la etapa de actualización con on= (request, response, o end).

3. Exponga la API con una location:

   location /status/ {
       api /status/http/metric_zones/;
   }
   

Ejemplo

Contar solicitudes por host y exponer las métricas en la API:

http {
    metric_zone requests:128k count;

    server {
        listen 80;

        location / {
            metric requests $host=1;
        }

        location /status/ {
            api /status/http/metric_zones/;
        }
    }
}

Notas

• Si expire=on está configurado en la zona y la memoria compartida está llena, las entradas usadas menos recientemente caducan. Si expire=off, las nuevas actualizaciones se descartan y el contador discarded aumenta.

• Si discard_key está configurado, las métricas de las entradas caducadas se agregan bajo esa clave en la salida de la API.

• Las claves y valores están limitados a 255 bytes; las claves más largas se truncan en la API.

• Un valor vacío se trata como 0, y un valor no vacío sin un número inicial se trata como 1.