Monitorea NGINX en Kubernetes con OpenTelemetry

Supervise sus servidores NGINX que se ejecutan en clústeres de Kubernetes utilizando el OpenTelemetry Collector para enviar métricas y datos de telemetría 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.

Antes de que empieces

Asegúrese de tener:

Una cuenta de New Relic con un
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

Instalar y configurar el OpenTelemetry Collector

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.

Cree un secreto de Kubernetes para almacenar sus credenciales de New Relic. Reemplace YOUR_LICENSE_KEY y YOUR_OTLP_ENDPOINT con sus valores reales. Consulte la documentación de configuración del punto final OTLP para seleccionar el punto final apropiado para su región.

bash

$kubectl create secret generic newrelic-licenses --from-literal=NEWRELIC_LICENSE_KEY=YOUR_LICENSE_KEY --from-literal=NEWRELIC_OTLP_ENDPOINT=YOUR_OTLP_ENDPOINT -n newrelic --create-namespace

Cree un archivo values.yaml para configurar el recopilador de OpenTelemetry. Actualice los marcadores de posición para el nombre de su clúster, las etiquetas de pod de NGINX, el puerto y la ruta del estado de prueba.

opentelemetry-collector:
  mode: deployment

  image:
    repository: otel/opentelemetry-collector-contrib
    pullPolicy: IfNotPresent

  command:
    name: otelcol-contrib

  resources:
    limits:
      cpu: 500m
      memory: 300Mi
    requests:
      cpu: 100m
      memory: 100Mi

  extraEnvs:
    - name: NEWRELIC_LICENSE_KEY
      valueFrom:
        secretKeyRef:
          name: newrelic-licenses
          key: NEWRELIC_LICENSE_KEY
    - name: NEWRELIC_OTLP_ENDPOINT
      valueFrom:
        secretKeyRef:
          name: newrelic-licenses
          key: NEWRELIC_OTLP_ENDPOINT
    - name: K8S_NODE_NAME
      valueFrom:
        fieldRef:
          fieldPath: spec.nodeName
    - name: K8S_CLUSTER_NAME
      value: nginx-cluster # Update with your cluster name

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

  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`:<stub_status_port>/status'
              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`:<stub_status_port>/status'
                nginx.port: '<stub_status_port>'

    processors:
      batch:
        send_batch_size: 1024
        timeout: 30s

      resource/cluster:
        attributes:
          - key: k8s.cluster.name
            value: "${env:K8S_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"])

    exporters:
      otlphttp:
        endpoint: "${env:NEWRELIC_OTLP_ENDPOINT}"
        headers:
          api-key: "${env:NEWRELIC_LICENSE_KEY}"

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

Instale el gráfico de Helm utilizando su archivo values.yaml.

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

Asegúrese de que los pods se hayan iniciado correctamente:
bash
```
$kubectl get pods -n newrelic --watch
```
Debería ver pods con nombres como nginx-otel-collector-<hash> en un estado Running en el espacio de nombres newrelic.
Ejecuta una consulta NRQL en New Relic para confirmar que los datos están llegando. Reemplaza el nombre del clúster con el valor que estableciste en el archivo de valores:
```
FROM Metric
SELECT *
WHERE metricName LIKE 'nginx.%'
  AND instrumentation.provider = 'opentelemetry'
  AND k8s.cluster.name = 'nginx-cluster'
SINCE 10 minutes ago
```

Buscar y utilizar datos

Vaya a one.newrelic.com > Integrations & Agents.
Seleccione Dashboards y haga clic en NGINX OTel overview dashboard.
En la ventana emergente, seleccione su cuenta.
Haga clic en [View dashboard] y vea sus datos de NGINX en New Relic.

Las métricas de NGINX están adjuntas al Metric tipo de evento. Puede consultar estos datos con fines de solución de problemas o para crear gráficos y dashboards personalizados.

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 obtener una referencia completa de métricas y atributos: Consulte Referencia de métricas y atributos de NGINX OpenTelemetry para obtener descripciones detalladas de todas las métricas, tipos y atributos de recursos para implementaciones de Kubernetes.

Próximos pasos

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

Encuentre y consulte sus datos de NGINX: acceda a los dashboards, cree consultas personalizadas y configure alertas
Referencia de métricas y atributos de NGINX OpenTelemetry - Referencia completa de métricas con descripciones y ejemplos
Descripción general de NGINX OpenTelemetry - Comprenda las métricas, los atributos y los casos de uso recopilados
Documentación del receptor NGINX - Detalles técnicos y configuración avanzada

Explore la supervisión relacionada:

Monitoree NGINX Plus con OpenTelemetry - Para implementaciones comerciales de NGINX Plus
Monitorear NGINX autohospedado con OpenTelemetry - Para implementaciones de servidor tradicionales
Mejores prácticas de OpenTelemetry - Optimice su configuración de OpenTelemetry

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

Antes de que empieces

Instalar y configurar el OpenTelemetry Collector

Crear secreto de Kubernetes para credenciales

Crear configuración values.yaml

Instalar con Helm

Verifique la implementación y la recopilación de datos

Buscar y utilizar datos

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

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

Instalar y configurar el OpenTelemetry Collector

Crear configuración values.yaml

Instalar con Helm

Verifique la implementación y la recopilación de datos

Buscar y utilizar datos

Referencia de métricas y atributos

Próximos pasos

Antes de que empieces