Monitore seus servidores NGINX Plus em execução em um host usando o coletor NRDOT (recomendado) ou o OpenTelemetry Collector para enviar métricas e dados de telemetria para o New Relic.
Esta integração utiliza o prometheusreceiver do OpenTelemetry e o nginx-prometheus-exporter para monitorar as métricas de desempenho, estatísticas de conexão e integridade do servidor do NGINX Plus. A rica API HTTP no NGINX Plus fornece métricas significativamente mais detalhadas em comparação com o módulo de status stub básico no NGINX padrão.

Dashboard disponível através do quickstart New Relic NGINX OpenTelemetry Monitor.
Antes de você começar
Certifique-se de ter:
Chave de licençada New Relic válida
Versão NGINX Plus R13 ou superior
NGINX Plus com o módulo HTTP API habilitado
Exportador NGINX Prometheus instalado e em execução junto com sua instância NGINX Plus para expor métricas da API HTTP no formato Prometheus
Um dos seguintes coletores instalado em um host Linux:
- coletor NRDOT (recomendado - distribuição OpenTelemetry da New Relic), ou
- OpenTelemetry Collector Contrib (opção alternativa)
Acesso à rede do host Linux para:
- Endpoint da API HTTP do NGINX Plus
- Um endpoint New Relic OTLP
Configurar o monitoramento do NGINX Plus
Escolha seu coletor preferido e siga os passos de configuração:
Dica
Se alguma etapa de verificação falhar, instale os componentes ausentes antes de continuar. Precisa de ajuda para instalar o coletor NRDOT? Consulte a seção de instalação do repositório nrdot-collector-releases.
Durante a instalação, use export collector_distro="nrdot-collector"
Configure o coletor NRDOT
Configure o coletor NRDOT para coletar métricas do seu exportador Prometheus do NGINX Plus e enviá-las para o New Relic.
Configure o ambiente e atualize o caminho de configuração
Atualize a configuração do coletor NRDOT para usar seu arquivo de configuração do NGINX Plus e defina o endpoint OTLP.
Determine o endpoint OTLP com base na sua região da New Relic. Consulte Configurar endpoint, porta e protocolo para obter a lista completa de endpoints e portas suportadas para sua região.
Importante
Sua chave de licença já foi configurada em /etc/nrdot-collector/nrdot-collector.conf durante a instalação. Você só precisa atualizar o caminho do arquivo de configuração e o endpoint OTLP.
Atualize o arquivo de configuração do coletor:
$export collector_distro="nrdot-collector"$export otlp_endpoint="YOUR_NEWRELIC_OTLP_ENDPOINT" # Replace with your region's endpoint$
$# Update the config file path to point to nginx-plus-config.yaml$sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/nginx-plus-config.yaml"|' /etc/${collector_distro}/${collector_distro}.conf$
$# Add the OTLP endpoint$echo "OTEL_EXPORTER_OTLP_ENDPOINT=${otlp_endpoint}" | sudo tee -a /etc/${collector_distro}/${collector_distro}.conf > /dev/null(Opcional) Encaminhar logs do NGINX
Estenda a configuração do seu coletor para incluir logs de acesso e erros se você quiser eventos de log junto com as métricas.
Comece a monitorar
Agora que tudo está configurado, inicie o coletor NRDOT e verifique se os dados estão fluindo para o New Relic.
Dica
Se alguma etapa de verificação falhar, instale os componentes ausentes antes de continuar. Precisa de ajuda para instalar o coletor? Consulte o guia de instalação do OpenTelemetry Collector.
Configurar o coletor OpenTelemetry
Configure o OpenTelemetry Collector para coletar métricas do seu exportador Prometheus do NGINX Plus e enviá-las para o New Relic.
Configurar autenticação
Configure a autenticação segura para que o OpenTelemetry Collector possa enviar dados para sua conta New Relic. Esta etapa configura variáveis de ambiente para manter suas credenciais seguras.
Obtenha suas credenciais do New Relic:
- Chave de licença: obtenha sua chave de licença na página da interface de chaves de API
- Endpoint OTLP: use o endpoint da sua região dos endpoints New Relic OTLP
Configure as credenciais:
- Crie um diretório de substituição do systemd:
bash$export collector_distro="otelcol-contrib"$sudo mkdir -p /etc/systemd/system/${collector_distro}.service.d- Crie o arquivo de configuração do ambiente:
bash$cat <<EOF | sudo tee /etc/systemd/system/${collector_distro}.service.d/environment.conf$[Service]$Environment="NEWRELIC_OTLP_ENDPOINT=<`YOUR_NEWRELIC_OTLP_ENDPOINT>`"$Environment="NEWRELIC_LICENSE_KEY=`<YOUR_NEW_RELIC_LICENSE_KEY>`"$EOF
(Opcional) Encaminhar logs do NGINX
Estenda a configuração do seu coletor para incluir logs de acesso e erros se você quiser eventos de log junto com as métricas.
Comece a monitorar
Agora que tudo está configurado, inicie o OpenTelemetry Collector e verifique se os dados estão fluindo para o New Relic.
Encontre e use dados
- Acesse one.newrelic.com > Integrations & Agents.
- Selecione Dashboards e clique no dashboard NGINX OTel overview.
- Na janela pop-up, selecione sua conta.
- Clique em [View dashboard] e veja seus dados do NGINX Plus no New Relic.
As métricas do NGINX Plus são anexadas ao Metric tipo de evento. Você pode consultar esses dados para fins de solução de problemas ou para criar gráficos e dashboards personalizados.
Métricas coletadas
O OpenTelemetry Collector coleta métricas do NGINX Prometheus exporter, que expõe métricas da API HTTP do NGINX Plus no formato Prometheus.
Abaixo estão as métricas do NGINX Plus disponíveis:
Próximos passos
Saiba mais sobre seus dados:
- Encontre e consulte seus dados do NGINX - Acesse dashboards, crie consultas personalizadas e configure alertas
- Introdução ao NRQL - Aprenda a linguagem de consulta do New Relic para análise avançada de dados
- Crie condições de alerta NRQL - Configure alertas personalizados com base em suas métricas do NGINX Plus
Explore o monitoramento relacionado:
- Monitore o NGINX auto-hospedado com OpenTelemetry - Para implantações padrão do NGINX
- Monitore o NGINX no Kubernetes com OpenTelemetry - Para ambientes conteinerizados