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 Metric.

Pasos de Configuración#

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

  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.