Monitorea NGINX en Kubernetes con OpenTelemetry

Monitoree sus servidores NGINX que se ejecutan en clúster de Kubernetes utilizando el recolector NRDOT (recomendado) o el recolector OpenTelemetry contrib para enviar métricas y telemetry data a New Relic.

Esta integración específica de Kubernetes descubre automáticamente los pods de NGINX en su clúster y recopila métricas sin configuración manual para cada instancia. Aprovecha el nginxreceiver de OpenTelemetry y el receivercreator para monitorear dinámicamente las métricas de rendimiento de NGINX, las estadísticas de conexión y el estado del servidor en su entorno en contenedores.

Configurar el monitoreo de NGINX

Seleccione su recolector preferido y siga los pasos:

Antes de que empieces

Asegúrese de tener:

Clave de licenciade New Relic válida
Habilite el módulo HTTP stub status en el pod de NGINX que necesita ser monitoreado
Agrega las etiquetas app y role a cada pod de NGINX que necesite ser monitoreado
Para la instalación con manifiesto: complete la instalación base del manifiesto de OpenTelemetry para Kubernetes

Para la instalación con Helm: complete la instalación base con Helm de OpenTelemetry en Kubernetes

Configurar el recolector NRDOT

Instale el recolector NRDOT utilizando manifiestos de Kubernetes o Helm.

Después de completar la instalación del manifiesto base de OpenTelemetry para Kubernetes, configure el monitoreo de NGINX siguiendo estos pasos:

Actualice la imagen del recolector para usar el recolector NRDOT.
En los archivos deployment.yaml y daemonset.yaml de su directorio local rendered, actualice la imagen a:
```
image: newrelic/nrdot-collector:latest
```

Actualice el deployment-configmap.yaml para el monitoreo de NGINX:

Seleccione una de las siguientes opciones de configuración según sus requisitos de monitoreo:

Importante

Esta opción monitorea solo NGINX y elimina la recopilación de otras métricas de Kubernetes. Eliminarás recolectores adicionales más adelante para evitar la ingestión de métricas no deseadas.

Reemplace el contenido debajo de deployment-config.yaml: | con la siguiente configuración específica de NGINX:

extensions:
  health_check:
    endpoint: 0.0.0.0:13133
  k8s_observer:
    auth_type: serviceAccount
    observe_pods: true
    observe_nodes: true

receivers:
  receiver_creator/nginx:
    watch_observers: [k8s_observer]
    receivers:
      nginx:
        rule: type == "pod" && labels["app"] == "nginx" && labels["role"] == "reverse-proxy"  # Update with your labels
        config:
          endpoint: 'http://`endpoint`:<YOUR_STUB_STATUS_PORT>/<YOUR_STUB_STATUS_PATH>'  # Update port and path as needed
          metrics:
            nginx.requests:
              enabled: true
            nginx.connections_accepted:
              enabled: true
            nginx.connections_handled:
              enabled: true
            nginx.connections_current:
              enabled: true
          collection_interval: 30s
        resource_attributes:
          nginx.server.endpoint: 'http://`endpoint`:<YOUR_STUB_STATUS_PORT>/<YOUR_STUB_STATUS_PATH>'  # Update port and path as needed
          nginx.port: '<YOUR_STUB_STATUS_PORT>'  # Update to match your configuration

processors:
  batch:
    send_batch_max_size: 1000
    timeout: 30s
    send_batch_size: 800

  memory_limiter:
    check_interval: 1s
    limit_percentage: 80
    spike_limit_percentage: 25

  resource/cluster:
    attributes:
      - key: k8s.cluster.name
        value: "<CLUSTER_NAME>"  # Replace with your cluster name
        action: insert

  transform/nginx:
    metric_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat([
              "server",
              "k8s",
              attributes["k8s.cluster.name"],
              attributes["k8s.namespace.name"],
              "pod",
              attributes["k8s.pod.name"],
              "nginx",
              attributes["nginx.port"]
            ], ":"))
          - set(attributes["nginx.deployment.name"], attributes["k8s.pod.name"])
  
  transform/metadata_nullify:
    metric_statements:
      - context: metric
        statements:
          - set(description, "")
          - set(unit, "")

exporters:
  otlp_http/newrelic:
    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
    headers:
      api-key: ${env:NR_LICENSE_KEY}

service:
  extensions: [health_check, k8s_observer]
  pipelines:
    metrics/nginx:
      receivers: [receiver_creator/nginx]
      processors: [batch, resource/cluster, transform/nginx, transform/metadata_nullify, memory_limiter]
      exporters: [otlp_http/newrelic]

Parámetro de configuración

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

Parámetro	Descripción
`<YOUR_STUB_STATUS_PORT>`	Reemplace con su puerto de estado de stub de NGINX (por ejemplo, 80, 8080)
`<YOUR_STUB_STATUS_PATH>`	Reemplace con su ruta de estado de stub de NGINX (por ejemplo, basic_status)
`<CLUSTER_NAME>`	Reemplace con el nombre de su clúster de Kubernetes para su identificación en New Relic
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	Actualice con el extremo OTLP de su región. Consulte la documentación del extremo OTLP
`app` y `role` etiquetas	Etiquetas de pod utilizadas para identificar los pods de NGINX (actualice la regla para que coincida con sus etiquetas)
`collection_interval`	Intervalo en segundos para recopilar métricas. El valor predeterminado está establecido en `30s`
`send_batch_max_size`	Número máximo de métricas a agrupar en lotes antes de enviar. El valor predeterminado está establecido en `1000`
`timeout`	Tiempo de espera en segundos antes de enviar las métricas agrupadas por lotes. El valor predeterminado está establecido en `30s`

Agregue las siguientes secciones a su deployment-configmap.yaml existente:

Extensiones para agregar:

extensions:
  health_check:
    endpoint: 0.0.0.0:13133
  k8s_observer:
    auth_type: serviceAccount
    observe_pods: true
    observe_nodes: true

Receptores a agregar:

receivers:
  receiver_creator/nginx:
    watch_observers: [k8s_observer]
    receivers:
      nginx:
        rule: type == "pod" && labels["app"] == "nginx" && labels["role"] == "reverse-proxy"  # Update with your labels
        config:
          endpoint: 'http://`endpoint`:<YOUR_STUB_STATUS_PORT>/<YOUR_STUB_STATUS_PATH>'  # Update port and path as needed
          metrics:
            nginx.requests:
              enabled: true
            nginx.connections_accepted:
              enabled: true
            nginx.connections_handled:
              enabled: true
            nginx.connections_current:
              enabled: true
          collection_interval: 30s
        resource_attributes:
          nginx.server.endpoint: 'http://`endpoint`:<YOUR_STUB_STATUS_PORT>/<YOUR_STUB_STATUS_PATH>'  # Update port and path as needed
          nginx.port: '<YOUR_STUB_STATUS_PORT>'  # Update to match your configuration

Procesadores para agregar:

processors:
  resource/cluster:
    attributes:
      - key: k8s.cluster.name
        value: "<CLUSTER_NAME>"  # Replace with your cluster name
        action: insert

  transform/nginx:
    metric_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat([
              "server",
              "k8s",
              attributes["k8s.cluster.name"],
              attributes["k8s.namespace.name"],
              "pod",
              attributes["k8s.pod.name"],
              "nginx",
              attributes["nginx.port"]
            ], ":"))
          - set(attributes["nginx.deployment.name"], attributes["k8s.pod.name"])
  
  transform/metadata_nullify:
    metric_statements:
      - context: metric
        statements:
          - set(description, "")
          - set(unit, "")

Pipelines de servicio para agregar:

service:
  extensions: [health_check, k8s_observer]  # Add to existing extensions
  pipelines:
    metrics/nginx:
      receivers: [receiver_creator/nginx]
      processors: [batch, resource/cluster, transform/nginx, transform/metadata_nullify, memory_limiter]
      exporters: [otlphttp/newrelic]

Parámetro de configuración

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

Parámetro	Descripción
`<YOUR_STUB_STATUS_PORT>`	Reemplace con su puerto de estado de stub de NGINX (por ejemplo, 80, 8080)
`<YOUR_STUB_STATUS_PATH>`	Reemplace con su ruta de estado de stub de NGINX (por ejemplo, basic_status)
`<CLUSTER_NAME>`	Reemplace con el nombre de su clúster de Kubernetes para su identificación en New Relic
`app` y `role` etiquetas	Etiquetas de pod utilizadas para identificar los pods de NGINX (actualice la regla para que coincida con sus etiquetas)
`collection_interval`	Intervalo en segundos para recopilar métricas. El valor predeterminado está establecido en `30s`
`memory_limiter`	Procesador utilizado en la configuración existente de Kubernetes para limitar el uso de memoria

Aplique los manifiestos actualizados y reinicie el despliegue.
1. Para el monitoreo de solo NGINX, ejecute estos comandos:
bash
```
$kubectl apply -n newrelic -R -f rendered
$kubectl delete daemonset nr-k8s-otel-collector-daemonset -n newrelic
$kubectl delete deployment nr-k8s-otel-collector-kube-state-metrics -n newrelic
$kubectl rollout restart deployment nr-k8s-otel-collector-deployment -n newrelic
```
1. Para el monitoreo de K8s + NGINX, ejecute estos comandos:
bash
```
$kubectl apply -n newrelic -R -f rendered
$kubectl rollout restart deployment nr-k8s-otel-collector-deployment -n newrelic
```

Actualice su values.yaml para el chart de Helm nr-k8s-otel-collector con los siguientes cambios:

a. Actualice el respositorio de la imagen del recolector y la etiqueta para usar NRDOT:

images:
  collector:
    repository: newrelic/nrdot-collector
    tag: latest

b. Agregue las siguientes secciones bajo deployment.extraConfig:

Importante

En deployment.extraConfig, pipelines: debe definirse en el nivel raíz —no anidado debajo de service:. La plantilla de chart de Helm mapea extraConfig.pipelines en service.pipelines y extraConfig.service.extensions en service.extensions.

Extensiones:

extensions:
  health_check:
    endpoint: 0.0.0.0:13133
  k8s_observer:
    auth_type: serviceAccount
    observe_pods: true
    observe_nodes: true

Receptores:

receivers:
  receiver_creator/nginx:
    watch_observers: [k8s_observer]
    receivers:
      nginx:
        rule: type == "pod" && labels["app"] == "nginx" && labels["role"] == "reverse-proxy"  # Update with your labels
        resource_attributes:
          nginx.server.endpoint: 'http://`endpoint`:<YOUR_STUB_STATUS_PORT>/<YOUR_STUB_STATUS_PATH>'  # Update port and path as needed
          nginx.port: '<YOUR_STUB_STATUS_PORT>'  # Update to match your configuration
        config:
          endpoint: 'http://`endpoint`:<YOUR_STUB_STATUS_PORT>/<YOUR_STUB_STATUS_PATH>'  # Update port and path as needed
          metrics:
            nginx.requests:
              enabled: true
            nginx.connections_accepted:
              enabled: true
            nginx.connections_handled:
              enabled: true
            nginx.connections_current:
              enabled: true
          collection_interval: 30s

Procesadores:

processors:

  resource/cluster:
    attributes:
      - key: k8s.cluster.name
        value: "<CLUSTER_NAME>"  # Replace with your cluster name
        action: insert

  transform/nginx:
    metric_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat([
              "server",
              "k8s",
              attributes["k8s.cluster.name"],
              attributes["k8s.namespace.name"],
              "pod",
              attributes["k8s.pod.name"],
              "nginx",
              attributes["nginx.port"]
            ], ":"))
          - set(attributes["nginx.deployment.name"], attributes["k8s.pod.name"])

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

Extensiones de servicio:

service:
  extensions: [health_check, k8s_observer]

Pipelines:

pipelines:
  metrics/nginx:
    receivers: [receiver_creator/nginx]
    processors: [batch, resource/cluster, transform/nginx, transform/metadata_nullify, memory_limiter]
    exporters: [otlphttp/newrelic]

Parámetro de configuración

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

Parámetro	Descripción
`<YOUR_STUB_STATUS_PORT>`	Reemplace con su puerto de estado de stub de NGINX (por ejemplo, 80, 8080)
`<YOUR_STUB_STATUS_PATH>`	Reemplace con su ruta de estado de stub de NGINX (por ejemplo, basic_status)
`<CLUSTER_NAME>`	Reemplace con el nombre de su clúster de Kubernetes para su identificación en New Relic
`app` y `role` etiquetas	Etiquetas de pod utilizadas para identificar los pods de NGINX (actualice la regla para que coincida con sus etiquetas)
`collection_interval`	Intervalo en segundos para recopilar métricas. El valor predeterminado está establecido en `30s`
`send_batch_max_size`	Número máximo de métricas a agrupar en lotes antes de enviar. El valor predeterminado está establecido en `1000`
`timeout`	Tiempo de espera en segundos antes de enviar las métricas agrupadas por lotes. El valor predeterminado está establecido en `30s`
`memory_limiter`	Procesador utilizado para limitar el uso de memoria. `limit_percentage` establece el porcentaje máximo de memoria antes de que comience la limitación

Aplique los valores actualizados a su release de Helm en ejecución:

bash

$helm upgrade nr-k8s-otel-collector newrelic/nr-k8s-otel-collector \
>  --namespace newrelic \
>  --reuse-values \
>  -f values.yaml

Antes de que empieces

Asegúrese de tener:

Clave de licenciade New Relic válida
Habilite el módulo HTTP stub status en el pod de NGINX que necesita ser monitoreado
Agrega las etiquetas app y role a cada pod de NGINX que necesite ser monitoreado

Helm instalado

Configurar el recolector OpenTelemetry

Implemente el OpenTelemetry Collector en su clúster de Kubernetes usando Helm. El recopilador descubrirá y extraerá automáticamente métricas de sus pods NGINX.

Descargue o cree un archivo values.yaml personalizado basado en el values.yaml de OpenTelemetry Collector.

Actualice las siguientes secciones en su archivo values.yaml:

Establecer el modo en despliegue:
```
mode: deployment
```

Reemplace el repositorio de imágenes:

image:
  repository: otel/opentelemetry-collector-contrib

Configurar rol de clúster:

clusterRole:
  create: true
  rules:
    - apiGroups: [""]
      resources: ["pods", "nodes", "nodes/stats", "nodes/proxy"]
      verbs: ["get", "list", "watch"]
    - apiGroups: ["apps"]
      resources: ["replicasets"]
      verbs: ["get", "list", "watch"]

Configurar los límites de recursos:

resources:
  limits:
    cpu: 250m
    memory: 512Mi

Reemplace toda la sección de configuración con la configuración de monitoreo de NGINX:

config:
     extensions:
       health_check:
         endpoint: 0.0.0.0:13133
       k8s_observer:
         auth_type: serviceAccount
         observe_pods: true
         observe_nodes: true

     receivers:
       receiver_creator/nginx:
         watch_observers: [k8s_observer]
         receivers:
           nginx:
             rule: type == "pod" && labels["app"] == "nginx" && labels["role"] == "reverse-proxy" # Update with your labels
             config:
               endpoint: 'http://`endpoint`:<YOUR_STUB_STATUS_PORT>/<YOUR_STUB_STATUS_PATH>'  # Update port and path as needed
               metrics:
                 nginx.requests:
                   enabled: true
                 nginx.connections_accepted:
                   enabled: true
                 nginx.connections_handled:
                   enabled: true
                 nginx.connections_current:
                   enabled: true
               collection_interval: 30s
             resource_attributes:
               nginx.server.endpoint: 'http://`endpoint`:<YOUR_STUB_STATUS_PORT>/<YOUR_STUB_STATUS_PATH>'  # Update port and path as needed
               nginx.port: '<YOUR_STUB_STATUS_PORT>'  # Update to match your configuration

     processors:
       batch:
         send_batch_size: 1024
         timeout: 30s

       resource/cluster:
         attributes:
           - key: k8s.cluster.name
             value: "<CLUSTER_NAME>"  # Replace with your cluster name
             action: insert

       transform/nginx:
         metric_statements:
           - context: resource
             statements:
               - set(attributes["nginx.display.name"], Concat([
                   "server",
                   "k8s",
                   attributes["k8s.cluster.name"],
                   attributes["k8s.namespace.name"],
                   "pod",
                   attributes["k8s.pod.name"],
                   "nginx",
                   attributes["nginx.port"]
                   ], ":"))
               - set(attributes["nginx.deployment.name"], attributes["k8s.pod.name"])

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

     exporters:
       otlp_http/newrelic:
         endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"  # Update for your region
         headers:
           api-key: "<YOUR_NEW_RELIC_LICENSE_KEY>"  # Replace with your New Relic license key

     service:
       extensions: [health_check, k8s_observer]
       pipelines:
         metrics/nginx:
           receivers: [receiver_creator/nginx]
           processors: [batch, resource/cluster, transform/nginx, transform/metadata_nullify]
           exporters: [otlp_http/newrelic]

Parámetro de configuración

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

Parámetro	Descripción
`<YOUR_STUB_STATUS_PORT>`	Reemplace con su puerto de estado de stub de NGINX (por ejemplo, 80, 8080)
`<YOUR_STUB_STATUS_PATH>`	Reemplace con su ruta de estado de stub de NGINX (por ejemplo, basic_status)
`<CLUSTER_NAME>`	Reemplace con el nombre de su clúster de Kubernetes para su identificación en New Relic
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	Actualice con el extremo OTLP de su región. Consulte la documentación del extremo OTLP
`<YOUR_NEW_RELIC_LICENSE_KEY>`	Reemplace con su clave de licencia de New Relic
`app` y `role` etiquetas	Etiquetas de pod utilizadas para identificar los pods de NGINX (actualice la regla para que coincida con sus etiquetas)
`basic_status`	Ruta del extremo de estado de stub de NGINX (actualice si usa una ruta diferente)
`collection_interval`	Intervalo en segundos para recopilar métricas. 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`
`timeout`	Tiempo de espera en segundos antes de enviar las métricas agrupadas por lotes. El valor predeterminado está establecido en `30s`

Siga la guía de instalación del chart de Helm de OpenTelemetry Collector para instalar el recolector utilizando su archivo values.yaml personalizado.

Comandos de ejemplo:

bash

$helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts
$helm repo update
$helm upgrade my-opentelemetry-collector open-telemetry/opentelemetry-collector -f your-custom-values.yaml -n newrelic --create-namespace --install

Verifique que los pods se estén ejecutando:
bash
```
$kubectl get pods -n newrelic --watch
```
Debería ver los pods del OpenTelemetry Collector en un estado Running en el namespace newrelic.

Ejecuta una consulta NRQL en New Relic para verificar la recopilación de datos. Reemplace el nombre del clúster con el nombre de su clúster:

FROM Metric
SELECT *
WHERE metricName LIKE 'nginx.%'
  AND instrumentation.provider = 'opentelemetry'
  AND k8s.cluster.name = 'your-cluster-name'
SINCE 10 minutes ago

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.

Referencia de métricas y atributos

Esta integración recopila las mismas métricas principales de NGINX que la implementación en el host, con atributos de recursos específicos de Kubernetes adicionales para la identificación del clúster, el espacio de nombres y el pod.

Para una referencia completa de métricas y atributos: Consulte la referencia de métricas y atributos de NGINX OpenTelemetry para obtener descripciones detalladas de todas las métricas, tipos y atributos de recursos para los despliegues de Kubernetes.

Próximos pasos

Explore la supervisión relacionada:

Monitorear NGINX Plus con OpenTelemetry - Para implementaciones comerciales de NGINX Plus
Monitorear NGINX autohospedado con OpenTelemetry - Para implementaciones de servidores tradicionales

Recursos específicos de Kubernetes:

OpenTelemetry Collector en Kubernetes - Configuraciones avanzadas del recopilador

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

Monitorea NGINX en Kubernetes con OpenTelemetry

Configurar el monitoreo de NGINX

Antes de que empieces

Configurar el recolector NRDOT

Instalación con manifiesto

Monitoreo exclusivo de NGINX

Importante

Parámetro de configuración

Monitoreo de K8s + NGINX

Parámetro de configuración

Instalación con Helm

Importante

Parámetro de configuración

Antes de que empieces

Configurar el recolector OpenTelemetry

Paso 1: crear configuración personalizada values.yaml

Parámetro de configuración

Paso 2: instalar con Helm

Paso 3: verifique el despliegue y la recopilación de datos

Ver tus datos en New Relic

Referencia de métricas y atributos

Próximos pasos

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

Monitorea NGINX en Kubernetes con OpenTelemetry

Configurar el monitoreo de NGINX .css-21sua1{background:none;border:none;width:0;padding:0;}

Antes de que empieces

Configurar el recolector NRDOT

Instalación con Helm

Antes de que empieces

Configurar el recolector OpenTelemetry

Paso 1: crear configuración personalizada values.yaml

Paso 2: instalar con Helm

Paso 3: verifique el despliegue y la recopilación de datos

Ver tus datos en New Relic

Referencia de métricas y atributos

Próximos pasos

Configurar el monitoreo de NGINX