Referencia de métricas y atributos de NGINX OpenTelemetry

Esta referencia cubre todas las métricas y atributos recopilados por el receptor OpenTelemetry NGINX, aplicable tanto a implementaciones en host como en Kubernetes.

Métricas principales de NGINX

El nginxreceiver de OpenTelemetry Collector Contrib recopila las siguientes métricas del módulo de estado stub de NGINX:

Métrica	Descripción	Tipo
`nginx.connections_accepted`	El número total de conexiones de cliente aceptadas. Utilice esto para rastrear las tasas de aceptación de conexiones a lo largo del tiempo.	Suma
`nginx.connections_handled`	El número total de conexiones manejadas. Generalmente, el valor del parámetro es el mismo que nginx.connections_accepted a menos que se hayan alcanzado algunos límites de recursos (por ejemplo, el límite worker_connections). Una brecha entre aceptadas y manejadas sugiere restricciones de recursos.	Suma
`nginx.connections_current`	El número actual de conexiones nginx por estado. Los estados incluyen: activo (conexiones activas totales), reading (leyendo encabezados de solicitud), writing (escribiendo respuestas), waiting (conexiones keep-alive esperando la siguiente solicitud).	Suma
`nginx.requests`	Número total de solicitudes realizadas al servidor desde que se inició. Utilice los cálculos de tasa para derivar las solicitudes por segundo para el monitoreo del rendimiento.	Suma

Consejos de planificación de capacidad:

Las conexiones altas waiting pueden indicar oportunidades de ajuste de keep-alive
La brecha entre accepted y handled conexiones sugiere restricciones de recursos
Las relaciones solicitud-conexión ayudan a optimizar las configuraciones de los trabajadores

Atributos de recursos

Los atributos de recursos brindan contexto sobre su implementación de NGINX y varían según si está utilizando la implementación en el host o en Kubernetes.

atributo común

Atributo	Descripción	Valores de ejemplo
`state`	El estado de una conexión (aplicable a la métrica `nginx.connections_current`)	`active`, `reading`, `writing`, `waiting`
`nginx.server.endpoint`	La URL del punto final de estado stub de NGINX	`http://localhost:8080/stub_status`

Atributos de implementación en el host

Atributo	Descripción	Valores de ejemplo
`nginx.deployment.name`	Un nombre único para identificar esta implementación de NGINX	`production-web-01`, `staging-api`
`nginx.display.name`	Un nombre fácil de mostrar que combina el prefijo "server" con el nombre de la implementación	`server:production-web-01`
`host.name`	El nombre de host del sistema donde se está ejecutando NGINX	`web-server-01.example.com`
`host.id`	El identificador único del sistema host	`i-1234567890abcdef0`
`logtype`	El tipo de log que se está recopilando (solo aplicable a los logs). Utilizado por las reglas de análisis integradas de New Relic. Este atributo solo está disponible cuando el reenvío de logs está habilitado.	`nginx` (para logs de acceso), `nginx-error` (para logs de errores)

Atributos de implementación de Kubernetes

Atributo	Descripción	Valores de ejemplo
`k8s.cluster.name`	El nombre del clúster de Kubernetes	`nginx-cluster`, `production-k8s`
`k8s.namespace.name`	El espacio de nombres de Kubernetes donde se está ejecutando el pod de NGINX	`default`, `web-services`, `production`
`k8s.pod.name`	El nombre del pod de Kubernetes que ejecuta NGINX	`nginx-deployment-7d4b8c6f9-x5z8w`
`nginx.deployment.name`	Establecido en el nombre del pod para implementaciones de Kubernetes	`nginx-deployment-7d4b8c6f9-x5z8w`
`nginx.display.name`	Un nombre para mostrar completo que incluye información del clúster, el espacio de nombres y el pod	`server:k8s:nginx-cluster:default:pod:nginx-deployment-7d4b8c6f9-x5z8w:nginx:8080`

Detalles de la recopilación de métricas

Frecuencia de recopilación

Intervalo predeterminado: 30 segundos
Configurable: Se puede ajustar en la configuración de OpenTelemetry Collector

Fuente de datos

Todas las métricas se recopilan del módulo stub_status de NGINX, que debe estar habilitado y configurado para exponer un punto final HTTP.

Tipos métricos

Sumar métricas: Valores acumulativos que representan totales a lo largo del tiempo
Cálculos de tasa: Utilice la función rate() de New Relic para convertir las métricas acumulativas en tasas por segundo para el monitoreo

Guías de configuración:

Monitoree NGINX en entornos autohospedados - Configuración completa para implementaciones en el host
Monitoree NGINX en Kubernetes - Configuración completa para implementaciones de Kubernetes

Uso de datos:

Encuentre y consulte sus datos de NGINX - Dashboards, consultas NRQL y alertas

Referencia técnica:

Documentación del receptor NGINX - Detalles técnicos de OpenTelemetry

Te ofrecemos esta traducción automática para facilitar la lectura.