Monitore o NGINX auto-hospedado com OpenTelemetry

Monitore seus servidores NGINX auto-hospedados com o OpenTelemetry para enviar métricas de desempenho e dados de telemetria para o New Relic.

Você pode escolher entre três opções de coletor:

NRDOT: Distribuição New Relic do OpenTelemetry
OTel Collector Contrib: Coletor OpenTelemetry padrão com componentes contribuídos pela comunidade
Prometheus Receiver: para ambientes que já executam o nginx-prometheus-exporter

Antes de você começar

Certifique-se de ter:

Chave de licençada New Relic válida
NGINX com o módulo HTTP stub status habilitado
Um dos seguintes coletores instalado em um host Linux:
- coletor NRDOT, ou
- OpenTelemetry Collector Contrib
Acesso à rede do host Linux para:
- Endpoint de status stub HTTP do NGINX
- Endpoint OTLPda New Relic

Configurar o monitoramento do NGINX

Escolha seu coletor preferido e siga as etapas:

Você pode usar o coletor NRDOT para monitorar seu servidor NGINX. O coletor NRDOT é uma distribuição pré-configurada que inclui componentes específicos da New Relic.

Para instalar e configurar o coletor NRDOT, siga estas etapas:

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 para coletar métricas do seu endpoint de status stub do NGINX e enviá-las para o New Relic.

Importante

Escolha sua abordagem de monitoramento:

Monitoramento exclusivo do NGINX (este guia): monitora apenas o desempenho e as métricas do seu servidor web NGINX
Monitoramento completo do servidor: monitora o NGINX e todo o seu servidor (uso da CPU, memória, espaço em disco, logs do sistema)
Se você quiser monitorar todo o seu servidor, não apenas o NGINX, use a configuração padrão do coletor NRDOT em vez disso e adicione a configuração do receiver do NGINX a ela.

Crie o arquivo de configuração /etc/nrdot-collector/nginx-config.yaml:

receivers:
  nginx:
    endpoint: <YOUR_STUB_STATUS_ENDPOINT>  # Replace with your stub status URL
    collection_interval: 30s                      # How often to collect metrics
    metrics:
      nginx.requests:
        enabled: true
      nginx.connections_accepted:
        enabled: true
      nginx.connections_handled:
        enabled: true
      nginx.connections_current:
        enabled: true

processors:
  # Detect system information
  resourcedetection:
    detectors: [system]
    system:
      resource_attributes:
        host.name:
          enabled: false
        host.id:
          enabled: true

  # Add NGINX-specific identification
  resource/nginx:
    attributes:
      - key: nginx.server.endpoint
        value: "<YOUR_STUB_STATUS_ENDPOINT>"  # Replace with your endpoint
        action: upsert
      - key: nginx.deployment.name
        value: "<DEPLOYMENT_NAME>"                    # Replace with your deployment name
        action: upsert
  
  # Batch metrics for efficient sending
  batch:
    timeout: 30s
    send_batch_size: 1024

  # Transform metrics for better display in New Relic
  transform/nginx_metrics:
    metric_statements:
      - context: resource
        statements:
          # Customize the display name as needed for your New Relic dashboard
          - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
  
  transform/metadata_nullify:
    metric_statements:
      - context: metric
        statements:
          - set(description, "")
          - set(unit, "")

exporters:
  otlp_http:
    endpoint: ${env:YOUR_NEWRELIC_OTLP_ENDPOINT}
    headers:
      api-key: ${env:YOUR_NEW_RELIC_LICENSE_KEY}

service:
  pipelines:
    metrics/nginx:
      receivers: [nginx]
      processors: [resourcedetection, resource/nginx, batch, transform/nginx_metrics, transform/metadata_nullify]
      exporters: [otlp_http]

Parâmetro de configuração

A tabela a seguir descreve os principais parâmetros de configuração:

Parâmetro	Descrição
`<YOUR_STUB_STATUS_ENDPOINT>`	Substitua pelo endpoint de status stub do NGINX (por exemplo, `http://127.0.0.1/basic_status` )
`<DEPLOYMENT_NAME>`	Substitua por um nome de implantação exclusivo para este servidor NGINX (por exemplo, `production-web-01` , `staging-api` , `prod-lb-01` )
`collection_interval`	Intervalo em segundos para coletar métricas. O valor padrão é definido como `30s`
`timeout`	Tempo limite em segundos para aguardar antes de enviar métricas em lote. O valor padrão é definido como `30s`
`send_batch_size`	Número de métricas a serem agrupadas em lote antes de enviar. O valor padrão é definido como `1024`

Atualize a configuração do coletor NRDOT para usar seu arquivo de configuração NGINX 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á está 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:

bash

$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-config.yaml
$sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/nginx-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

Além das métricas, você pode enviar logs de acesso e erro do NGINX para o New Relic para monitoramento e solução de problemas abrangentes. Esses logs complementam as métricas principais do NGINX e fornecem insights detalhados no nível da solicitação.

Dica

Ignore esta etapa se você só precisa de métricas básicas do NGINX e não precisa de logs de solicitação detalhados.

Para configurar o NGINX para gerar logs formatados em JSON, adicione isso à sua configuração do NGINX (/etc/nginx/nginx.conf):

http {
    # JSON log format for better parsing
    log_format json_combined escape=json
    '{'
      '"time":"$time_local",'
      '"remote_addr":"$remote_addr",'
      '"request":"$request",'
      '"status":$status,'
      '"bytes_sent":$body_bytes_sent,'
      '"request_time":$request_time,'
      '"referer":"$http_referer",'
      '"user_agent":"$http_user_agent"'
    '}';

    # Use the JSON format for access logs
    access_log /var/log/nginx/access.log json_combined;
    error_log /var/log/nginx/error.log warn;

    # Your existing configuration...
}

Recarregue o NGINX para aplicar as alterações:
bash
```
$sudo nginx -t && sudo nginx -s reload
```

Para configurar o coletor para encaminhamento de logs, adicione estas seções ao seu /etc/nrdot-collector/nginx-config.yaml:

receivers:
  # Your existing nginx receiver...
  nginx:
    # existing configuration...

  # Add log receivers
  filelog/nginx_access:
    include:
      - /var/log/nginx/access.log

  filelog/nginx_error:
    include:
      - /var/log/nginx/error.log

processors:
  # Your existing processors...

  # Add log processor
  transform/nginx_access_logs:
    log_statements:
    - context: resource
      statements:
        - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
        - set(attributes["logtype"], "nginx")
  transform/nginx_error_logs:
    log_statements:
    - context: resource
      statements:
        - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
        - set(attributes["logtype"], "nginx-error")

service:
  pipelines:
    # Your existing metrics pipeline...

    # Add log pipelines
    logs/nginx-access:
      receivers: [filelog/nginx_access]
      processors: [resource/nginx, batch, transform/nginx_access_logs]
      exporters: [otlp_http]

    logs/nginx-error:
      receivers: [filelog/nginx_error]
      processors: [resource/nginx, batch, transform/nginx_error_logs]
      exporters: [otlp_http]

Defina permissões e aplique a configuração. Permitir que o coletor leia os arquivos de log do NGINX:

bash

$# Add collector user to adm group (has read access to logs)
$sudo usermod -a -G adm nrdot-collector
$
$# Ensure log files are readable
$sudo chmod 644 /var/log/nginx/access.log
$sudo chmod 644 /var/log/nginx/error.log

Agora que tudo está configurado, inicie o coletor NRDOT e verifique se os dados estão fluindo para o New Relic.

Inicie o coletor:
1. Aplique as alterações de configuração:
bash
```
$sudo systemctl daemon-reload
$sudo systemctl restart nrdot-collector.service
```
1. Verifique se o serviço está em execução:
bash
```
$sudo systemctl status nrdot-collector.service
```
Saída esperada: Active: active (running) sem erros recentes
Verifique a coleta de dados:
1. Verifique os logs de inicialização:
bash
```
$sudo journalctl -u nrdot-collector.service -n 20
```
1. Gere tráfego de teste (para criar métricas):
bash
```
$# Make a few requests to your NGINX server
$curl http://localhost
```
Aguarde um tempo para que os dados iniciais apareçam no New Relic e, em seguida, acesse seu dashboard do NGINX para verificar a coleta de dados.

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.

Configure o OpenTelemetry Collector para coletar métricas do seu endpoint de status stub do NGINX e enviá-las para o New Relic.

Importante

Antes de editar: faça backup da sua configuração existente: sudo cp /etc/otelcol-contrib/config.yaml /etc/otelcol-contrib/config.yaml.backup

Edite o arquivo de configuração do seu coletor (normalmente /etc/otelcol-contrib/config.yaml) e adicione as seguintes seções. Se você já tiver seções de receptores, processadores ou exportadores, mescle-as com sua configuração existente:

Configure o receptor NGINX:

receivers:
  nginx:
    endpoint: <YOUR_STUB_STATUS_ENDPOINT>  # Replace with your stub status URL
    collection_interval: 30s                      # How often to collect metrics
    metrics:
      nginx.requests:
        enabled: true
      nginx.connections_accepted:
        enabled: true
      nginx.connections_handled:
        enabled: true
      nginx.connections_current:
        enabled: true

Configure os processadores para metadados e batching:

processors:
  # Detect system information
  resourcedetection:
    detectors: [system]
    system:
      resource_attributes:
        host.name:
          enabled: false
        host.id:
          enabled: true

  # Add NGINX-specific identification
  resource/nginx:
    attributes:
      - key: nginx.server.endpoint
        value: "<YOUR_STUB_STATUS_ENDPOINT>"  # Replace with your endpoint
        action: upsert
      - key: nginx.deployment.name
        value: "<DEPLOYMENT_NAME>"                    # Replace with your deployment name
        action: upsert

  # Batch metrics for efficient sending
  batch:
    timeout: 30s
    send_batch_size: 1024

  # Transform metrics for better display in New Relic
  transform/nginx_metrics:
    metric_statements:
      - context: resource
        statements:
          # Customize the display name as needed for your New Relic dashboard
          - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
  
  transform/metadata_nullify:
    metric_statements:
      - context: metric
        statements:
          - set(description, "")
          - set(unit, "")

Configure o exportador New Relic:

exporters:
  # Send metrics to New Relic via OTLP
  otlp_http:
    endpoint: ${env:YOUR_NEWRELIC_OTLP_ENDPOINT}
    headers:
      api-key: ${env:YOUR_NEW_RELIC_LICENSE_KEY}

Conecte tudo com um pipeline:

service:
  pipelines:
    metrics/nginx:
      receivers: [nginx]
      processors: [resourcedetection, resource/nginx, batch, transform/nginx_metrics, transform/metadata_nullify]
      exporters: [otlp_http]

Parâmetro de configuração

A tabela a seguir descreve os principais parâmetros de configuração:

Parâmetro	Descrição
`<YOUR_STUB_STATUS_ENDPOINT>`	Substitua pelo endpoint de status stub do NGINX (por exemplo, `http://127.0.0.1/basic_status` )
`<DEPLOYMENT_NAME>`	Substitua por um nome de implantação exclusivo para este servidor NGINX (por exemplo, `production-web-01` , `staging-api` , `prod-lb-01` )
`collection_interval`	Intervalo em segundos para coletar métricas. O valor padrão é definido como `30s`
`timeout`	Tempo limite em segundos para aguardar antes de enviar métricas em lote. O valor padrão é definido como `30s`
`send_batch_size`	Número de métricas a serem agrupadas em lote antes de enviar. O valor padrão é definido como `1024`

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

$sudo mkdir -p /etc/systemd/system/otelcol-contrib.service.d

Crie o arquivo de configuração do ambiente:

bash

$cat <<EOF | sudo tee /etc/systemd/system/otelcol-contrib.service.d/environment.conf
$[Service]
$Environment="NEWRELIC_OTLP_ENDPOINT=<YOUR_NEWRELIC_OTLP_ENDPOINT>"  # Replace with your region's endpoint
$Environment="NEWRELIC_LICENSE_KEY=YOUR_NEW_RELIC_LICENSE_KEY"
$EOF

Além de métricas, você pode enviar logs de acesso e erro do NGINX para o New Relic para monitoramento e resolução de problemas abrangentes. Esses logs complementam as métricas principais do NGINX e fornecem insights detalhados em nível de requisição.

Dica

Ignore esta etapa se você só precisa de métricas básicas do NGINX e não precisa de logs de solicitação detalhados.

Para configurar o NGINX para gerar logs formatados em JSON, adicione isso à sua configuração do NGINX (/etc/nginx/nginx.conf):

http {
    # JSON log format for better parsing
    log_format json_combined escape=json
    '{'
      '"time":"$time_local",'
      '"remote_addr":"$remote_addr",'
      '"request":"$request",'
      '"status":$status,'
      '"bytes_sent":$body_bytes_sent,'
      '"request_time":$request_time,'
      '"referer":"$http_referer",'
      '"user_agent":"$http_user_agent"'
    '}';

    # Use the JSON format for access logs
    access_log /var/log/nginx/access.log json_combined;
    error_log /var/log/nginx/error.log warn;

    # Your existing configuration...
}

Recarregue o NGINX para aplicar as alterações:
bash
```
$sudo nginx -t && sudo nginx -s reload
```

Para configurar o coletor para encaminhamento de logs, adicione estas seções ao seu /etc/otelcol-contrib/config.yaml:

receivers:
  # Your existing nginx receiver...
  nginx:
    # existing configuration...

  # Add log receivers
  filelog/nginx_access:
    include:
      - /var/log/nginx/access.log

  filelog/nginx_error:
    include:
      - /var/log/nginx/error.log

processors:
  # Your existing processors...

  # Add log processor
  transform/nginx_access_logs:
    log_statements:
    - context: resource
      statements:
        - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
        - set(attributes["logtype"], "nginx")
  transform/nginx_error_logs:
    log_statements:
    - context: resource
      statements:
        - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
        - set(attributes["logtype"], "nginx-error")

service:
  pipelines:
    # Your existing metrics pipeline...

    # Add log pipelines
    logs/nginx-access:
      receivers: [filelog/nginx_access]
      processors: [resource/nginx, batch, transform/nginx_access_logs]
      exporters: [otlp_http]

    logs/nginx-error:
      receivers: [filelog/nginx_error]
      processors: [resource/nginx, batch, transform/nginx_error_logs]
      exporters: [otlp_http]

Defina permissões e aplique a configuração. Permitir que o coletor leia os arquivos de log do NGINX:

bash

$# Add collector user to adm group (has read access to logs)
$sudo usermod -a -G adm otelcol-contrib
$
$# Ensure log files are readable
$sudo chmod 644 /var/log/nginx/access.log
$sudo chmod 644 /var/log/nginx/error.log

Agora que tudo está configurado, inicie o OpenTelemetry Collector e verifique se os dados estão fluindo para o New Relic.

Inicie o coletor:
1. Aplique as alterações de configuração:
bash
```
$sudo systemctl daemon-reload
$sudo systemctl restart otelcol-contrib.service
```
1. Verifique se o serviço está em execução:
bash
```
$sudo systemctl status otelcol-contrib.service
```
Saída esperada: Active: active (running) sem erros recentes
Verifique a coleta de dados:
1. Verifique os logs de inicialização:
bash
```
$sudo journalctl -u otelcol-contrib.service -n 20
```
1. Gere tráfego de teste (para criar métricas):
bash
```
$# Make a few requests to your NGINX server
$curl http://localhost
```
Aguarde um tempo para que os dados iniciais apareçam no New Relic e, em seguida, acesse seu dashboard do NGINX para verificar a coleta de dados.

Use essa abordagem se você já tiver o nginx-prometheus-exporter em execução no seu ambiente ou se estiver migrando de uma stack de monitoramento baseada no Prometheus.

Dica

Recomendado: se você ainda não tem um exportador Prometheus em execução, use as guias do coletor NRDOT ou do OpenTelemetry Collector Contrib em vez disso. Eles se conectam diretamente ao endpoint de status stub do NGINX sem precisar de um componente exportador adicional.

Esta configuração funciona tanto com o NRDOT quanto com o OTel Collector Contrib. Coloque-o no local de configuração apropriado:

NRDOT: /etc/nrdot-collector/config.yaml

OTel Collector Contrib: /etc/otelcol-contrib/config.yaml

Dica

Faça backup da sua configuração existente antes de fazer alterações:

bash

$# For NRDOT
$sudo cp /etc/nrdot-collector/config.yaml /etc/nrdot-collector/config.yaml.backup
$
$# For OTel Collector Contrib
$sudo cp /etc/otelcol-contrib/config.yaml /etc/otelcol-contrib/config.yaml.backup

Substitua o conteúdo do arquivo pela seguinte configuração:

Importante

Substitua <YOUR_STUB_STATUS_ENDPOINT> pela sua URL de status stub do NGINX (por exemplo, http://127.0.0.1:8080/nginx_status) e <DEPLOYMENT_NAME> por um nome exclusivo para este servidor NGINX.

receivers:
  prometheus/nginx:
    config:
      scrape_configs:
        - job_name: nginx
          scrape_interval: 30s
          static_configs:
            - targets: ["localhost:9113"]  # Update if exporter runs on a different port

processors:
  resourcedetection/prom:
    detectors: [system]
    system:
      resource_attributes:
        host.name:
          enabled: false
        host.id:
          enabled: true

  resource/nginx_prom:
    attributes:
      - key: nginx.server.endpoint
        value: "<YOUR_STUB_STATUS_ENDPOINT>"  # Replace with your stub status URL
        action: upsert
      - key: nginx.deployment.name
        value: "<DEPLOYMENT_NAME>"            # Replace with a unique server name
        action: upsert
      # Strip prometheus receiver auto-labels — absent from nginxreceiver output
      - key: service.name
        action: delete
      - key: service.instance.id
        action: delete
      - key: net.host.name
        action: delete
      - key: net.host.port
        action: delete
      - key: server.address
        action: delete
      - key: server.port
        action: delete

  # Rename prometheus metric names to nginxreceiver schema names
  metricstransform/nginx_prom:
    transforms:
      - include: nginx_http_requests_total
        action: update
        new_name: nginx.requests
      - include: nginx_connections_accepted
        action: update
        new_name: nginx.connections_accepted
      - include: nginx_connections_handled
        action: update
        new_name: nginx.connections_handled
      - include: ^nginx_connections_(?P<state>active|reading|writing|waiting)$
        match_type: regexp
        action: combine
        new_name: nginx.connections_current

  # Keep only the 4 renamed nginx.* metrics
  filter/nginx_prom_only:
    metrics:
      include:
        match_type: regexp
        metric_names:
          - ^nginx\..*

  transform/nginx_metrics_prom:
    metric_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))

  transform/metadata_nullify_prom:
    metric_statements:
      - context: metric
        statements:
          - set(description, "")
          - set(unit, "")

  batch/nginx_prom:
    timeout: 30s
    send_batch_size: 1024

exporters:
  otlphttp/nginx_prom:
    endpoint: ${env:OTEL_EXPORTER_OTLP_ENDPOINT}
    headers:
      api-key: ${env:NEW_RELIC_LICENSE_KEY}

service:
  pipelines:
    metrics/nginx_prometheus:
      receivers: [prometheus/nginx]
      processors:
        - resourcedetection/prom
        - resource/nginx_prom
        - metricstransform/nginx_prom
        - filter/nginx_prom_only
        - transform/nginx_metrics_prom
        - transform/metadata_nullify_prom
        - batch/nginx_prom
      exporters: [otlphttp/nginx_prom]

Parâmetro de configuração

Parâmetro	Descrição
`<YOUR_STUB_STATUS_ENDPOINT>`	Sua URL de status stub do NGINX (por exemplo, `http://127.0.0.1:8080/nginx_status` ). Usado como o atributo de recurso `nginx.server.endpoint` .
`<DEPLOYMENT_NAME>`	Nome exclusivo para este servidor NGINX (por exemplo, `production-web-01` ). Aparece nos dashboards do New Relic.
`targets`	Endereço do nginx-prometheus-exporter (padrão `localhost:9113` ). Atualize se estiver em execução em um host ou porta diferente.
`scrape_interval`	Com que frequência coletar métricas do exportador. Padrão: `30s` .

Crie um override do systemd para injetar as variáveis de ambiente necessárias. Substitua <collector-service> pelo nome do seu serviço de coletor (nrdot-collector ou otelcol-contrib):

bash

$sudo mkdir -p /etc/systemd/system/<collector-service>.service.d

Crie o arquivo /etc/systemd/system/<collector-service>.service.d/environment.conf:

[Service]
Environment="OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.nr-data.net:4318"
Environment="NEW_RELIC_LICENSE_KEY=YOUR_NEW_RELIC_LICENSE_KEY"

Substitua YOUR_NEW_RELIC_LICENSE_KEY pelo seu .

Dica

Para contas da UE, use OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.eu01.nr-data.net:4318. Consulte Configurar endpoint, porta e protocolo para obter a lista completa de endpoints regionais.

Aplique a configuração e reinicie o coletor. Substitua <collector-service> por nrdot-collector ou otelcol-contrib:

bash

$sudo systemctl daemon-reload
$sudo systemctl restart <collector-service>.service

Verifique se o serviço está em execução:

bash

$sudo systemctl status <collector-service>.service
$sudo journalctl -u <collector-service>.service -n 20

Saída esperada: Active: active (running) sem erros.

Após alguns minutos, execute esta consulta NRQL para confirmar que os dados estão fluindo. Substitua <DEPLOYMENT_NAME> pelo valor definido na configuração:

FROM Metric SELECT *
WHERE metricName LIKE 'nginx.%'
  AND nginx.deployment.name = '<DEPLOYMENT_NAME>'
SINCE 10 minutes ago

Aguarde um tempo para que os dados iniciais apareçam no New Relic e, em seguida, acesse seu dashboard do NGINX para verificar a coleta de dados.

Visualize seus dados no New Relic

Depois que sua configuração estiver concluída e os dados estiverem fluindo, você poderá acessar suas métricas NGINX nos dashboards do New Relic e criar alertas personalizados.

Para instruções completas sobre como acessar dashboards, consultar dados com NRQL e criar alertas, veja Encontre e consulte seus dados do NGINX.

Resolução de problemas

Se você encontrar problemas durante a configuração, use este guia de solução de problemas para diagnosticar e resolver problemas comuns.

Obtendo 404 Not Found:

bash

$curl http://<NGINX_SERVER_IP>:<YOUR_LOCAL_PORT>/nginx_status

Soluções:

Verifique se o caminho do local corresponde à URL da sua solicitação
Verifique se a configuração foi adicionada ao bloco de servidor correto
Execute sudo nginx -T | grep -A5 nginx_status para confirmar se a configuração foi carregada

Obtendo 403 Proibido:

Certifique-se de que você está testando do IP do servidor correto <NGINX_SERVER_IP>
Verifique suas diretivas allow/deny na configuração do NGINX
Verifique se nenhuma outra restrição de acesso está bloqueando a solicitação

Conexão recusada:

Verifique se o NGINX está em execução: sudo systemctl status nginx
Verifique se a sua porta configurada não está bloqueada: sudo netstat -tlnp | grep :<YOUR_LOCAL_PORT>
Verifique as regras do firewall, se aplicável

Verifique o status do serviço:

bash

$sudo systemctl status ${collector_distro}.service
$sudo journalctl -u ${collector_distro}.service -n 50

Causas e correções comuns:

Erros de sintaxe YAML - Corrija a indentação e os problemas de sintaxe
Variáveis de ambiente ausentes - Verifique se as credenciais estão definidas no arquivo de ambiente
Problemas de permissão de arquivo - Execute sudo chown ${collector_distro}:${collector_distro} /etc/${collector_distro}/config.yaml
URLs de endpoint inválidas - Verifique o endpoint NGINX e o endpoint New Relic OTLP
Configurações de componentes ausentes - Certifique-se de que todos os receivers, processors e exporters referenciados na seção de pipelines de serviço estejam realmente definidos em suas respectivas seções de configuração acima

Reinicie após as correções:

bash

$sudo systemctl restart ${collector_distro}.service

Diagnóstico passo a passo:

Verifique se o status stub do NGINX funciona:
bash
```
$curl http://<NGINX_SERVER_IP>:<YOUR_LOCAL_PORT>/nginx_status
```
Deve retornar estatísticas de conexão.
Verifique se o Collector está em execução e íntegro:
bash
```
$sudo systemctl status ${collector_distro}.service
$sudo journalctl -u ${collector_distro} -n 20
```
Os logs fornecerão contexto detalhado se houver algum problema de configuração ou tempo de execução com o OpenTelemetry Collector.

Verifique se há dados com NRQL:

FROM Metric SELECT * WHERE nginx.deployment.name LIKE '%production%' LIMIT 1

Nenhum log aparecendo no New Relic:

bash

$# Check Collector logs for file errors
$sudo journalctl -u ${collector_distro} -f | grep -i "filelog\|error"

Problemas comuns:

Erros de permissão de arquivo - Adicione o coletor ao grupo adm: sudo usermod -a -G adm ${collector_distro}
Caminhos de arquivo errados - Verifique os locais dos arquivos de log em sua configuração

Próximos passos

Saiba mais sobre seus dados:

Encontre e consulte seus dados do NGINX - Acesse dashboards, crie consultas personalizadas e configure alertas
Referência de métricas e atributos do NGINX OpenTelemetry - Referência completa de métricas com descrições e exemplos
Visão geral do NGINX OpenTelemetry - Entenda as métricas coletadas, atributos e casos de uso

Explore o monitoramento relacionado:

Monitore o NGINX Plus com OpenTelemetry - Para implantações comerciais do NGINX Plus
Monitorar NGINX no Kubernetes - Para ambientes conteinerizados

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

Monitore o NGINX auto-hospedado com OpenTelemetry

Antes de você começar

Configurar o monitoramento do NGINX

Dica

Etapa 1: configurar o coletor NRDOT

Importante

Parâmetro de configuração

Etapa 2: configure o ambiente e atualize o caminho de configuração

Importante

Etapa 3: (Opcional) Encaminhar logs do NGINX

Dica

Etapa 4: Comece a monitorar

Dica

Etapa 1: Configurar o OpenTelemetry Collector

Importante

Parâmetro de configuração

Etapa 2: configurar a autenticação

Etapa 3: (Opcional) Encaminhar logs do NGINX

Dica

Etapa 4: Comece a monitorar

Dica

Etapa 1: configurar o coletor

Dica

Importante

Parâmetro de configuração

Etapa 2: definir variáveis de ambiente

Dica

Etapa 3: inicie o coletor

Etapa 4: verifique os dados no New Relic

Visualize seus dados no New Relic

Resolução de problemas

Problemas de status stub do NGINX

O serviço do Collector não será iniciado

Nenhum dado aparece no New Relic

Problemas de encaminhamento de logs

Próximos passos

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

Monitore o NGINX auto-hospedado com OpenTelemetry

Antes de você começar .css-21sua1{background:none;border:none;width:0;padding:0;}

Configurar o monitoramento do NGINX

Dica

Etapa 2: configure o ambiente e atualize o caminho de configuração

Etapa 3: (Opcional) Encaminhar logs do NGINX

Etapa 4: Comece a monitorar

Dica

Etapa 1: Configurar o OpenTelemetry Collector

Etapa 2: configurar a autenticação

Etapa 3: (Opcional) Encaminhar logs do NGINX

Etapa 4: Comece a monitorar

Dica

Etapa 1: configurar o coletor

Etapa 2: definir variáveis de ambiente

Etapa 3: inicie o coletor

Etapa 4: verifique os dados no New Relic

Visualize seus dados no New Relic

Resolução de problemas

Problemas de status stub do NGINX

O serviço do Collector não será iniciado

Nenhum dado aparece no New Relic

Problemas de encaminhamento de logs

Próximos passos

Antes de você começar