Monitoree NGINX autohospedado con OpenTelemetry

Monitoree sus servidores NGINX autohospedados con OpenTelemetry para enviar métricas de rendimiento y telemetry data a New Relic.

Puede elegir entre tres opciones de recolector:

NRDOT: Distribución de New Relic de OpenTelemetry
OTel Collector Contrib: OpenTelemetry Collector estándar con componentes aportados por la comunidad
Prometheus Receiver: para entornos que ya ejecutan nginx-prometheus-exporter

Antes de que empieces

Asegúrese de tener:

Clave de licenciade New Relic válida
NGINX con el módulo HTTP stub status habilitado
Uno de los siguientes recopiladores instalados en un host Linux:
- recolector NRDOT, o
- OpenTelemetry Collector Contrib
Acceso a la red desde el host de Linux a:
- Punto final de estado de stub HTTP de NGINX
- El extremo OTLPde New Relic

Configurar el monitoreo de NGINX

Seleccione su recolector preferido y siga los pasos:

Puede utilizar el recolector NRDOT para monitorear su servidor NGINX. El recolector NRDOT es una distribución preconfigurada que incluye componentes específicos de New Relic.

Para instalar y configurar el recolector NRDOT, siga estos pasos:

Sugerencia

Si algún paso de verificación falla, instale los componentes faltantes antes de continuar. ¿Necesitas ayuda para instalar el recolector NRDOT? Consulte la sección de instalación del respositorio nrdot-collector-releases.

Durante la instalación use export collector_distro="nrdot-collector"

Configure el recolector NRDOT para extraer métricas de su extremo de estado stub de NGINX y enviarlas a New Relic.

Importante

Elija su enfoque de monitoreo:

Monitoreo solo de NGINX (esta guía): monitorea solo el rendimiento y las métricas de su servidor web NGINX
Monitoreo completo del servidor: monitorea NGINX además de todo su servidor (uso de CPU, memoria, espacio en disco, logs del sistema)

Si desea monitorear todo su servidor, no solo NGINX, use en su lugar la configuración predeterminada del recolector NRDOT y agréguele la configuración del receptor de NGINX.

Cree el archivo de configuración /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 configuración

La siguiente tabla describe los parámetros de configuración clave:

Parámetro	Descripción
`<YOUR_STUB_STATUS_ENDPOINT>`	Reemplace con el extremo de estado stub de NGINX (por ejemplo, `http://127.0.0.1/basic_status`)
`<DEPLOYMENT_NAME>`	Reemplace con un nombre de despliegue único para este servidor NGINX (por ejemplo, `production-web-01`, `staging-api`, `prod-lb-01`)
`collection_interval`	Intervalo en segundos para recopilar métricas. El valor predeterminado está establecido en `30s`
`timeout`	Tiempo de espera en segundos antes de enviar las métricas agrupadas por lotes. El valor predeterminado está establecido en `30s`
`send_batch_size`	Número de métricas a agrupar en lotes antes de enviarlas. El valor predeterminado está establecido en `1024`

Actualice la configuración del recolector NRDOT para utilizar su archivo de configuración de NGINX y establezca el extremo OTLP.

Determine su extremo OTLP según su región de New Relic. Consulte Configurar extremo, puerto y protocolo para obtener la lista completa de extremos y puertos admitidos para su región.

Importante

Su clave de licencia ya está configurada en /etc/nrdot-collector/nrdot-collector.conf durante la instalación. Solo necesita actualizar la ruta del archivo de configuración y el extremo OTLP.

Actualice el archivo de configuración del recolector:

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

Además de las métricas, puede enviar logs de acceso y error de NGINX a New Relic para una monitorización y solución de problemas integrales. Estos logs complementan las métricas principales de NGINX y proporcionan información detallada a nivel de solicitud.

Sugerencia

Omita este paso si solo necesita métricas básicas de NGINX y no requiere logs de solicitud detallados.

Para configurar NGINX para generar logs con formato JSON, agregue esto a su configuración de 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...
}

Recargue NGINX para aplicar los cambios:

bash

$sudo nginx -t && sudo nginx -s reload

Para configurar el recolector para el reenvío de logs, agregue estas secciones a su /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]

Establecer permisos y aplicar la configuración. Permita que el recolector lea los archivos de log de 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

Ahora que todo está configurado, inicie el recolector NRDOT y verifique que los datos fluyan a New Relic.

Inicie el recolector:
1. Aplique los cambios de configuración:
bash
```
$sudo systemctl daemon-reload
$sudo systemctl restart nrdot-collector.service
```
1. Verifique que el servicio se esté ejecutando:
bash
```
$sudo systemctl status nrdot-collector.service
```
Salida esperada: Active: active (running) sin errores recientes
Verifique la recopilación de datos:
1. Verifique los logs de inicio:
bash
```
$sudo journalctl -u nrdot-collector.service -n 20
```
1. Generar tráfico de prueba (para crear métricas):
bash
```
$# Make a few requests to your NGINX server
$curl http://localhost
```
Espere a que aparezcan los datos iniciales en New Relic; luego, acceda a su dashboard de NGINX para verificar la recolección de datos.

Sugerencia

Si algún paso de verificación falla, instale los componentes faltantes antes de continuar. ¿Necesita ayuda para instalar el recolector? Consulte la guía de instalación de OpenTelemetry Collector.

Configure el OpenTelemetry Collector para extraer métricas de su punto final de estado stub de NGINX y enviarlas a New Relic.

Importante

Antes de editar: respalde su configuración existente: sudo cp /etc/otelcol-contrib/config.yaml /etc/otelcol-contrib/config.yaml.backup

Edite su archivo de configuración del recolector (normalmente /etc/otelcol-contrib/config.yaml) y agregue las siguientes secciones. Si ya tiene secciones de receptores, procesadores o exportadores, combínelas con su configuración existente:

Configurar el 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 los procesadores para metadatos y agrupación por lotes:

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 el exportador de 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 todo con un pipeline:

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

Parámetro de configuración

La siguiente tabla describe los parámetros de configuración clave:

Parámetro	Descripción
`<YOUR_STUB_STATUS_ENDPOINT>`	Reemplace con el extremo de estado stub de NGINX (por ejemplo, `http://127.0.0.1/basic_status`)
`<DEPLOYMENT_NAME>`	Reemplace con un nombre de despliegue único para este servidor NGINX (por ejemplo, `production-web-01`, `staging-api`, `prod-lb-01`)
`collection_interval`	Intervalo en segundos para recopilar métricas. El valor predeterminado está establecido en `30s`
`timeout`	Tiempo de espera en segundos antes de enviar las métricas agrupadas por lotes. El valor predeterminado está establecido en `30s`
`send_batch_size`	Número de métricas a agrupar en lotes antes de enviarlas. El valor predeterminado está establecido en `1024`

Configure la autenticación segura para que el OpenTelemetry Collector pueda enviar datos a su cuenta de New Relic. Este paso configura variables de entorno para mantener seguras sus credenciales.

Obtenga sus credenciales de New Relic:
- Clave de licencia: obtenga su clave de licencia de la página de la UI de claves de API
- Extremo OTLP: use el extremo de su región de los extremos OTLP de New Relic

Configurar las credenciales:

Crea un directorio de anulación de systemd:

bash

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

Cree el archivo de configuración del entorno:

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

Además de las métricas, puede enviar los logs de acceso y errores de NGINX a New Relic para un monitoreo y resolución de problemas integrales. Estos logs complementan las métricas principales de NGINX y proporcionan información valiosa y detallada a nivel de solicitud.

Sugerencia

Omita este paso si solo necesita métricas básicas de NGINX y no requiere logs de solicitud detallados.

Para configurar NGINX para generar logs con formato JSON, agregue esto a su configuración de 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...
}

Recargue NGINX para aplicar los cambios:
bash
```
$sudo nginx -t && sudo nginx -s reload
```

Para configurar el recolector para el reenvío de logs, agregue estas secciones a su /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]

Establecer permisos y aplicar la configuración. Permita que el recolector lea los archivos de log de 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

Ahora que todo está configurado, inicie el recopilador de OpenTelemetry y verifique que los datos fluyan a New Relic.

Inicie el recolector:
1. Aplique los cambios de configuración:
bash
```
$sudo systemctl daemon-reload
$sudo systemctl restart otelcol-contrib.service
```
1. Verifique que el servicio se esté ejecutando:
bash
```
$sudo systemctl status otelcol-contrib.service
```
Salida esperada: Active: active (running) sin errores recientes
Verifique la recopilación de datos:
1. Verifique los logs de inicio:
bash
```
$sudo journalctl -u otelcol-contrib.service -n 20
```
1. Generar tráfico de prueba (para crear métricas):
bash
```
$# Make a few requests to your NGINX server
$curl http://localhost
```
Espere a que aparezcan los datos iniciales en New Relic; luego, acceda a su dashboard de NGINX para verificar la recolección de datos.

Utilice este enfoque si ya tiene nginx-prometheus-exporter ejecutándose en su entorno, o si está migrando desde un stack de monitoreo basado en Prometheus.

Sugerencia

Recomendado: si aún no tiene un exportador de Prometheus en ejecución, use las pestañas recolector NRDOT u OpenTelemetry Collector Contrib en su lugar. Se conectan directamente al extremo de estado de stub de NGINX sin necesitar un componente exportador adicional.

Esta configuración funciona tanto con NRDOT como con OTel Collector Contrib. Colóquelo en la ubicación de configuración adecuada:

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

Sugerencia

Haga una copia de seguridad de su configuración existente antes de realizar cambios:

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

Reemplace el contenido del archivo con la siguiente configuración:

Importante

Reemplace <YOUR_STUB_STATUS_ENDPOINT> con su URL de estado de stub de NGINX (por ejemplo, http://127.0.0.1:8080/nginx_status) y <DEPLOYMENT_NAME> con un nombre único 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 configuración

Parámetro	Descripción
`<YOUR_STUB_STATUS_ENDPOINT>`	Su URL de estado stub de NGINX (por ejemplo, `http://127.0.0.1:8080/nginx_status`). Utilizado como el atributo de recurso `nginx.server.endpoint`.
`<DEPLOYMENT_NAME>`	Nombre único para este servidor NGINX (por ejemplo, `production-web-01`). Aparece en los dashboards de New Relic.
`targets`	Dirección del nginx-prometheus-exporter (predeterminado `localhost:9113`). Actualice si se ejecuta en un host o puerto diferente.
`scrape_interval`	Con qué frecuencia recolectar métricas del exportador. Predeterminado: `30s`.

Cree una anulación de systemd para inyectar las variables de entorno requeridas. Reemplace <collector-service> con el nombre de su servicio de recolector (nrdot-collector o otelcol-contrib):

bash

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

Cree el archivo /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"

Reemplace YOUR_NEW_RELIC_LICENSE_KEY con su .

Sugerencia

Para cuentas de la UE, use OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.eu01.nr-data.net:4318. Consulte Configurar extremo, puerto y protocolo para obtener la lista completa de extremos regionales.

Aplique la configuración y reinicie el recolector. Reemplace <collector-service> con nrdot-collector o otelcol-contrib:

bash

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

Verifique que el servicio se esté ejecutando:

bash

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

Salida esperada: Active: active (running) sin errores.

Después de unos minutos, ejecute esta consulta NRQL para confirmar que los datos están fluyendo. Reemplace <DEPLOYMENT_NAME> con el valor que estableció en la configuración:

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

Espere a que aparezcan los datos iniciales en New Relic; luego, acceda a su dashboard de NGINX para verificar la recolección de datos.

Ver tus datos en New Relic

Una vez que su configuración esté completa y los datos fluyan, puede acceder a sus métricas de NGINX en los dashboards de New Relic y crear alertas personalizadas.

Para obtener instrucciones completas sobre cómo acceder a los dashboards, consultar datos con NRQL y crear alertas, consulte Buscar y consultar sus datos de NGINX.

Resolución de problemas

Si encuentra problemas durante la configuración, utilice esta guía de solución de problemas para diagnosticar y resolver los problemas comunes.

Obteniendo 404 No encontrado:

bash

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

Soluciones:

Verifique que la ruta de la ubicación coincida con la URL de su solicitud
Verifique que la configuración se haya agregado al bloque de servidor correcto
Ejecute sudo nginx -T | grep -A5 nginx_status para confirmar que la configuración está cargada

Obteniendo 403 Prohibido:

Asegúrese de que está probando desde la IP correcta del servidor <NGINX_SERVER_IP>
Verifique sus directivas allow/deny en la configuración de NGINX
Verifique que no haya otras restricciones de acceso que bloqueen la solicitud

Conexión rechazada:

Verifique si NGINX se está ejecutando: sudo systemctl status nginx
Verifique que el puerto configurado no esté bloqueado: sudo netstat -tlnp | grep :<YOUR_LOCAL_PORT>
Verifique las reglas del firewall si corresponde

Verifique el estado del servicio:

bash

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

Causas y soluciones comunes:

Errores de sintaxis YAML - Corrija la sangría y los problemas de sintaxis
Variables de entorno faltantes - Verifique que las credenciales estén configuradas en el archivo de entorno
Problemas de permisos de archivos - Ejecutar sudo chown ${collector_distro}:${collector_distro} /etc/${collector_distro}/config.yaml
URLs de extremo no válidas - Verifique el extremo de NGINX y el extremo OTLP de New Relic
Configuración de componentes faltante - Asegúrese de que todos los receptores, procesadores y exportadores a los que se hace referencia en la sección de canalizaciones de servicio estén realmente definidos en sus respectivas secciones de configuración anteriores

Reinicie después de las correcciones:

bash

$sudo systemctl restart ${collector_distro}.service

Diagnóstico paso a paso:

Verifique que el estado de la stub de NGINX funcione:
bash
```
$curl http://<NGINX_SERVER_IP>:<YOUR_LOCAL_PORT>/nginx_status
```
Debería devolver las estadísticas de conexión.
Verifique que Collector se esté ejecutando y esté en buen estado:
bash
```
$sudo systemctl status ${collector_distro}.service
$sudo journalctl -u ${collector_distro} -n 20
```
Los logs proporcionarán contexto detallado si hay algún problema de configuración o tiempo de ejecución con el OpenTelemetry Collector.

Compruebe los datos con NRQL:

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

No aparecen logs en New Relic:

bash

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

Problemas comunes:

Errores de permisos de archivo - Agregar el recolector al grupo adm: sudo usermod -a -G adm ${collector_distro}
Rutas de archivo incorrectas - Verifique las ubicaciones de los archivos de log en su configuración

Próximos pasos

Obtén más información sobre tus datos:

Busque y consulte sus datos de NGINX - Acceda a paneles, cree consultas personalizadas y configure alertas
Referencia de métricas y atributos de NGINX OpenTelemetry - Referencia completa de métricas con descripciones y ejemplos
Visión general de NGINX OpenTelemetry - Comprenda las métricas recopiladas, los atributos y los casos de uso

Explore la supervisión relacionada:

Monitorear NGINX Plus con OpenTelemetry - Para implementaciones comerciales de NGINX Plus
Monitorear NGINX en Kubernetes - Para entornos en contenedores

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

Monitoree NGINX autohospedado con OpenTelemetry

Antes de que empieces

Configurar el monitoreo de NGINX

Sugerencia

Paso 1: configurar el recolector NRDOT

Importante

Parámetro de configuración

Paso 2: configura el ambiente y actualiza la ruta de configuración

Importante

Paso 3: (opcional) reenviar los logs de NGINX

Sugerencia

Paso 4: Iniciar la monitorización

Sugerencia

Paso 1: configura el OpenTelemetry Collector

Importante

Parámetro de configuración

Paso 2: configurar la autenticación

Paso 3: (opcional) reenviar los logs de NGINX

Sugerencia

Paso 4: Iniciar la monitorización

Sugerencia

Paso 1: configurar el recolector

Sugerencia

Importante

Parámetro de configuración

Paso 2: Establecer variables de entorno

Sugerencia

Paso 3: inicie el recolector

Paso 4: Verifique los datos en New Relic

Ver tus datos en New Relic

Resolución de problemas

Problemas de estado de stub de NGINX

El servicio del Collector no se iniciará

No aparecen datos en New Relic

Problemas de reenvío de logs

Próximos pasos

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

Monitoree NGINX autohospedado con OpenTelemetry

Antes de que empieces .css-21sua1{background:none;border:none;width:0;padding:0;}

Configurar el monitoreo de NGINX

Sugerencia

Paso 2: configura el ambiente y actualiza la ruta de configuración

Paso 3: (opcional) reenviar los logs de NGINX

Paso 4: Iniciar la monitorización

Sugerencia

Paso 1: configura el OpenTelemetry Collector

Paso 2: configurar la autenticación

Paso 3: (opcional) reenviar los logs de NGINX

Paso 4: Iniciar la monitorización

Sugerencia

Paso 1: configurar el recolector

Paso 2: Establecer variables de entorno

Paso 3: inicie el recolector

Paso 4: Verifique los datos en New Relic

Ver tus datos en New Relic

Resolución de problemas

Problemas de estado de stub de NGINX

El servicio del Collector no se iniciará

No aparecen datos en New Relic

Problemas de reenvío de logs

Próximos pasos

Antes de que empieces