Referência de métricas e atributos do NGINX OpenTelemetry

Esta referência abrange todas as métricas e atributos coletados pelo receptor OpenTelemetry NGINX, aplicável a implantações on-host e Kubernetes.

Métricas principais do NGINX

O nginxreceiver do OpenTelemetry Collector Contrib coleta as seguintes métricas do módulo de status stub do NGINX:

Métrica	Descrição	Tipo
`nginx.connections_accepted`	O número total de conexões de clientes aceitas. Use isso para rastrear as taxas de aceitação de conexão ao longo do tempo.	Soma
`nginx.connections_handled`	O número total de conexões tratadas. Geralmente, o valor do parâmetro é o mesmo que nginx.connections_accepted a menos que alguns limites de recursos tenham sido atingidos (por exemplo, o limite worker_connections). Uma lacuna entre aceito e tratado sugere restrições de recursos.	Soma
`nginx.connections_current`	O número atual de conexões nginx por estado. Os estados incluem: active (total de conexões ativas), reading (lendo os cabeçalhos da requisição), writing (escrevendo respostas), waiting (conexões keep-alive aguardando a próxima requisição).	Soma
`nginx.requests`	Número total de solicitações feitas ao servidor desde que foi iniciado. Use cálculos de taxa para derivar solicitações por segundo para monitoramento de desempenho.	Soma

Dicas de planejamento de capacidade:

Altas waiting conexões podem indicar oportunidades de ajuste de keep-alive
A diferença entre accepted e handled conexões sugere restrições de recursos
As taxas de requisição para conexão ajudam a otimizar as configurações do worker

Atributos de recurso

Os atributos de recurso fornecem contexto sobre sua implantação do NGINX e variam dependendo se você está usando a implantação no host ou no Kubernetes.

Atributo comum

Atributo	Descrição	Valores de exemplo
`state`	O estado de uma conexão (aplicável à métrica `nginx.connections_current`)	`active`, `reading`, `writing`, `waiting`
`nginx.server.endpoint`	A URL do endpoint de status stub do NGINX	`http://localhost:8080/stub_status`

Atributos de implantação no host

Atributo	Descrição	Valores de exemplo
`nginx.deployment.name`	Um nome exclusivo para identificar esta implantação do NGINX	`production-web-01`, `staging-api`
`nginx.display.name`	Um nome amigável para exibição que combina o prefixo "servidor" com o nome da implantação	`server:production-web-01`
`host.name`	O nome do host do sistema onde o NGINX está em execução	`web-server-01.example.com`
`host.id`	O identificador exclusivo do sistema host	`i-1234567890abcdef0`
`logtype`	O tipo de log que está sendo coletado (aplicável apenas a logs). Usado pelas regras de análise integradas do New Relic. Este atributo está disponível somente quando o encaminhamento de log está ativado.	`nginx` (para logs de acesso), `nginx-error` (para logs de erro)

Atributos de implantação do Kubernetes

Atributo	Descrição	Valores de exemplo
`k8s.cluster.name`	O nome do cluster Kubernetes	`nginx-cluster`, `production-k8s`
`k8s.namespace.name`	O namespace do Kubernetes onde o pod do NGINX está sendo executado	`default`, `web-services`, `production`
`k8s.pod.name`	O nome do pod do Kubernetes executando o NGINX	`nginx-deployment-7d4b8c6f9-x5z8w`
`nginx.deployment.name`	Definido para o nome do pod para implantações do Kubernetes	`nginx-deployment-7d4b8c6f9-x5z8w`
`nginx.display.name`	Um nome de exibição abrangente, incluindo informações do cluster, namespace e pod	`server:k8s:nginx-cluster:default:pod:nginx-deployment-7d4b8c6f9-x5z8w:nginx:8080`

Detalhes da coleta de métricas

Frequência de coleta

Intervalo padrão: 30 segundos
Configurável: Pode ser ajustado na configuração do OpenTelemetry Collector

Fonte de dados

Todas as métricas são coletadas do módulo stub_status do NGINX, que deve ser habilitado e configurado para expor um endpoint HTTP.

Tipos métricos

Somar métricas: Valores cumulativos que representam totais ao longo do tempo
Cálculos de taxa: Use a função rate() do New Relic para converter métricas cumulativas em taxas por segundo para monitoramento

Guias de configuração:

Monitorar o NGINX em ambientes auto-hospedados - Configuração completa para implantações no host
Monitore o NGINX no Kubernetes - Configuração completa para implantações do Kubernetes

Uso de dados:

Encontre e consulte seus dados do NGINX - Dashboards, consultas NRQL e alertas

Referência técnica:

Documentação do receptor NGINX - Detalhes técnicos do OpenTelemetry

Esta tradução de máquina é fornecida para sua comodidade.