Monitorea NGINX en Kubernetes con OpenTelemetry

Monitoree sus servidores NGINX que se ejecutan en clúster de Kubernetes para enviar métricas 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 como sidecar

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
```

Agregue las siguientes secciones bajo deployment.extraConfig en su values.yaml:

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

Use este enfoque si ya tiene nginx-prometheus-exporter ejecutándose como sidecar en sus pod de NGINX, 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.

Antes de que empieces

Asegúrese de tener:

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

Helm instalado

Complete la instalación base de Helm de OpenTelemetry para Kubernetes para nr-k8s-otel-collector antes de continuar.

Agregue las siguientes secciones bajo deployment.configMap.extraConfig en su values.yaml:

Importante

En deployment.configMap.extraConfig, pipelines: debe definirse en el nivel raíz — no anidado bajo service:. La plantilla del 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_nodes: true
    observe_pods: true

Receptores:

receivers:
  receiver_creator/nginx_prom:
    watch_observers:
      - k8s_observer
    receivers:
      prometheus:
        rule: type == "port" && pod.labels["app"] == "nginx" && pod.labels["role"] == "reverse-proxy" && name == "metrics"  # Update with your pod labels
        config:
          config:
            scrape_configs:
              - job_name: nginx_prom
                metrics_path: /metrics
                scrape_interval: 30s
                static_configs:
                  - targets:
                      - '`endpoint`'
        resource_attributes:
          nginx.port: "9113"  # Update if nginx-prometheus-exporter runs on a different port
          nginx.server.endpoint: http://`endpoint`/metrics

Procesadores:

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

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

  filter/nginx_prom_only:
    metrics:
      include:
        match_type: regexp
        metric_names:
          - ^nginx\..*

  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_prometheus:
    receivers:
      - receiver_creator/nginx_prom
    processors:
      - batch
      - resource/cluster
      - metricstransform/nginx_prom
      - filter/nginx_prom_only
      - 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
`<CLUSTER_NAME>`	Nombre de su clúster de Kubernetes. Utilizado para identificación en New Relic.
`<YOUR_LICENSE_KEY>`	Su clave de licencia de New Relic.
`app` y `role` etiquetas	Etiquetas de pod utilizadas para descubrir pod de NGINX. Actualice el `rule` para que coincida con las etiquetas de su pod.
`name == "metrics"`	El puerto de contenedor con nombre en `9113` que el receiver_creator vigila. Debe coincidir con el nombre del puerto en la especificación de su pod.
`scrape_interval`	Con qué frecuencia recolectar métricas de Prometheus. Predeterminado: `30s` .

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

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 del receptor Prometheus:

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_prom:
      watch_observers: [k8s_observer]
      receivers:
        prometheus:
          rule: type == "port" && pod.labels["app"] == "nginx" && pod.labels["role"] == "reverse-proxy" && name == "metrics"  # Update with your pod labels
          config:
            config:
              scrape_configs:
                - job_name: nginx_prom
                  metrics_path: /metrics
                  scrape_interval: 30s
                  static_configs:
                    - targets:
                        - '`endpoint`'
          resource_attributes:
            nginx.port: "9113"  # Update if nginx-prometheus-exporter runs on a different port
            nginx.server.endpoint: http://`endpoint`/metrics

  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

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

    filter/nginx_prom_only:
      metrics:
        include:
          match_type: regexp
          metric_names:
            - ^nginx\..*

    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:
    otlphttp/newrelic:
      endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"  # Replace with your region's endpoint
      headers:
        api-key: "<YOUR_NEW_RELIC_LICENSE_KEY>"   # Replace with your license key

  service:
    extensions: [health_check, k8s_observer]
    pipelines:
      metrics/nginx_prometheus:
        receivers: [receiver_creator/nginx_prom]
        processors: [batch, resource/cluster, metricstransform/nginx_prom, filter/nginx_prom_only, transform/nginx, transform/metadata_nullify]
        exporters: [otlphttp/newrelic]

Parámetro de configuración

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

Parámetro	Descripción
`<CLUSTER_NAME>`	Nombre de su clúster de Kubernetes. Utilizado para identificación en New Relic.
`<YOUR_NEW_RELIC_LICENSE_KEY>`	Su clave de licencia de New Relic.
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	El extremo OTLP de su región. Consulte la documentación del extremo OTLP .
`app` y `role` etiquetas	Etiquetas de pod utilizadas para descubrir pod de NGINX. Actualice el `rule` para que coincida con las etiquetas de su pod.
`name == "metrics"`	El puerto de contenedor con nombre en `9113` que el receiver_creator vigila. Debe coincidir con el nombre del puerto en la especificación de su pod.
`scrape_interval`	Con qué frecuencia recolectar métricas de Prometheus. Predeterminado: `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.

bash

$helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts
$helm repo update
$helm upgrade --install nginx-otel-collector open-telemetry/opentelemetry-collector \
>  --namespace newrelic --create-namespace \
>  -f values.yaml

Verifique que los pod del recolector se estén ejecutando:
bash
```
$kubectl get pods -n newrelic --watch
```
Revise los logs del recolector para verificar el descubrimiento exitoso de pods y la recolección:
bash
```
$kubectl logs -n newrelic -l app.kubernetes.io/name=opentelemetry-collector -f
```
Busque líneas que hagan referencia a receiver_creator/nginx_prom descubriendo sus pod de NGINX.

Ejecute una consulta NRQL en New Relic para confirmar que los datos están llegando. Reemplace <CLUSTER_NAME> con el nombre de su clúster:

FROM Metric SELECT *
WHERE metricName LIKE 'nginx.%'
  AND instrumentation.provider = 'opentelemetry'
  AND k8s.cluster.name = '<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

Sugerencia

Antes de que empieces

Recolector NRDOT — instalación de Helm

Importante

Parámetro de configuración

OTel Collector Contrib — instalación de Helm

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

Sugerencia

Antes de que empieces

Recolector NRDOT — instalación de Helm

OTel Collector Contrib — instalación de Helm

Ver tus datos en New Relic

Referencia de métricas y atributos

Próximos pasos

Configurar el monitoreo de NGINX