Monitoree sus servidores NGINX Plus que se ejecutan en un host utilizando el recolector NRDOT (recomendado) o el OpenTelemetry Collector para enviar métricas y telemetry data a New Relic.
Esta integración aprovecha el prometheusreceiver de OpenTelemetry y el nginx-prometheus-exporter para supervisar las métricas de rendimiento, las estadísticas de conexión y el estado del servidor de NGINX Plus. La rica API HTTP en NGINX Plus proporciona métricas significativamente más detalladas en comparación con el módulo de estado básico stub en NGINX estándar.

Dashboard disponible a través de New Relic NGINX OpenTelemetry Monitor quickstart.
Antes de que empieces
Asegúrese de tener:
Clave de licenciade New Relic válida
Versión de NGINX Plus R13 o superior
NGINX Plus con el módulo API HTTP habilitado
Expositor de Prometheus de NGINX NGINX Prometheus exporter instalado y en ejecución junto con tu instancia de NGINX Plus para exponer métricas de la API HTTP en formato Prometheus
Uno de los siguientes recopiladores instalados en un host Linux:
- recolector NRDOT (recomendado: distribución de OpenTelemetry de New Relic), o
- OpenTelemetry Collector Contrib (opción alternativa)
Acceso a la red desde el host de Linux a:
- Punto final de la API HTTP de NGINX Plus
- Un extremo de New Relic OTLP
Configurar el monitoreo de NGINX Plus
Seleccione su recolector preferido y siga los pasos de configuración:
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"
Configurar el recolector NRDOT
Configure el recolector NRDOT para extraer métricas de su exportador Prometheus de NGINX Plus y enviarlas a New Relic.
Configurar el ambiente y actualizar la ruta de configuración
Actualice la configuración del recolector NRDOT para utilizar su archivo de configuración de NGINX Plus 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 se configuró en /etc/nrdot-collector/nrdot-collector.conf durante la instalación. Solo necesita actualizar la ruta del archivo de configuración y el endpoint OTLP.
Actualice el archivo de configuración del recolector:
$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) Reenviar los logs de NGINX
Extienda la configuración de su recopilador para incluir logs de acceso y errores si desea eventos de log junto con las métricas.
Iniciar el monitoreo
Ahora que todo está configurado, inicie el recolector NRDOT y verifique que los datos fluyan a New Relic.
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.
Configurar el recolector OpenTelemetry
Configure el OpenTelemetry Collector para extraer métricas de su exportador Prometheus de NGINX Plus y enviarlas a New Relic.
Configurar la autenticación
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$export collector_distro="otelcol-contrib"$sudo mkdir -p /etc/systemd/system/${collector_distro}.service.d- Cree el archivo de configuración del entorno:
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) Reenviar los logs de NGINX
Extienda la configuración de su recopilador para incluir logs de acceso y errores si desea eventos de log junto con las métricas.
Iniciar el monitoreo
Ahora que todo está configurado, inicie el recopilador de OpenTelemetry y verifique que los datos fluyan a New Relic.
Buscar y utilizar datos
- Vaya a one.newrelic.com > Integrations & Agents.
- Seleccione Dashboards y haga clic en el dashboard NGINX OTel overview.
- En la ventana emergente, seleccione su cuenta.
- Haga clic en [View dashboard] y vea sus datos de NGINX Plus en New Relic.
Las métricas de NGINX Plus se adjuntan al tipo de evento Metric. Puede consultar estos datos con fines de solución de problemas o para crear gráficos y dashboards personalizados.
Métricas recopiladas
El recopilador de OpenTelemetry extrae métricas del exportador de NGINX Prometheus, que expone las métricas de la API HTTP de NGINX Plus en formato Prometheus.
A continuación se muestran las métricas de NGINX Plus disponibles:
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
- Introducción a NRQL: aprenda el lenguaje de consulta de New Relic para el análisis avanzado de datos
- Crear condiciones de alerta NRQL - Configure alertas personalizadas basadas en sus métricas de NGINX Plus
Explore la supervisión relacionada:
- Monitorear NGINX autoalojado con OpenTelemetry - Para despliegues estándar de NGINX
- Monitorear NGINX en Kubernetes con OpenTelemetry - Para entornos en contenedores