Monitore o NGINX no Kubernetes com OpenTelemetry

Monitore seus servidores NGINX em execução em clusters Kubernetes usando o OpenTelemetry Collector para enviar métricas e dados de telemetria para o New Relic.

Esta integração específica do Kubernetes descobre automaticamente os pods NGINX em seu cluster e coleta métricas sem configuração manual para cada instância. Ele utiliza o nginxreceiver e o receivercreator OpenTelemetry para monitorar dinamicamente as métricas de desempenho do NGINX, estatísticas de conexão e integridade do servidor em seu ambiente em contêineres.

Antes de você começar

Certifique-se de ter:

Uma conta New Relic com uma
Habilite o módulo HTTP stub status no pod do NGINX que precisa ser monitorado
Adicione os rótulos app e role a cada pod NGINX que precisa ser monitorado

Instale e configure o OpenTelemetry Collector

Implante o OpenTelemetry Collector em seu cluster Kubernetes usando Helm. O coletor descobrirá e coletará automaticamente métricas de seus pods NGINX.

Crie um segredo do Kubernetes para armazenar suas credenciais do New Relic. Substitua YOUR_LICENSE_KEY e YOUR_OTLP_ENDPOINT pelos seus valores reais. Consulte a documentação de configuração do endpoint OTLP para selecionar o endpoint apropriado para sua região.

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

Crie um arquivo values.yaml para configurar o OpenTelemetry Collector. Atualize os espaços reservados para o nome do seu cluster, rótulos de pod do NGINX, porta e caminho de status stub.

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 o gráfico Helm usando seu arquivo 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

Certifique-se de que os pods foram iniciados com sucesso:
bash
```
$kubectl get pods -n newrelic --watch
```
Você deve ver pods com nomes como nginx-otel-collector-<hash> em um estado Running no namespace newrelic.

Execute uma consulta NRQL no New Relic para confirmar se os dados estão chegando. Substitua o nome do cluster pelo valor definido no arquivo de valores:

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

Encontre e use dados

Acesse one.newrelic.com > Integrations & Agents.
Selecione Dashboards e clique em NGINX OTel overview dashboard.
Na janela pop-up, selecione sua conta.
Clique em [View dashboard] e veja seus dados do NGINX no New Relic.

As métricas do NGINX são anexadas ao Metric tipo de evento. Você pode consultar esses dados para fins de solução de problemas ou para criar gráficos e dashboards personalizados.

Referência de métricas e atributos

Esta integração coleta as mesmas métricas principais do NGINX que a implantação no host, com atributos de recursos específicos do Kubernetes adicionais para identificação de cluster, namespace e pod.

Para referência completa de métricas e atributos: Consulte Referência de métricas e atributos do NGINX OpenTelemetry para descrições detalhadas de todas as métricas, tipos e atributos de recursos para implantações do Kubernetes.

Próximos passos

Saiba mais sobre seus dados:

Encontre e consulte seus dados do NGINX - Acesse dashboards, crie consultas personalizadas e configure alertas
Referência de métricas e atributos do NGINX OpenTelemetry - Referência completa de métricas com descrições e exemplos
Visão geral do NGINX OpenTelemetry - Entenda as métricas, atributos e casos de uso coletados
Documentação do receptor NGINX - Detalhes técnicos e configuração avançada

Explore o monitoramento relacionado:

Monitore o NGINX Plus com OpenTelemetry - Para implantações comerciais do NGINX Plus
Monitore o NGINX auto-hospedado com OpenTelemetry - Para implantações tradicionais de servidor
Melhores práticas do OpenTelemetry - Otimize sua configuração do OpenTelemetry

Recursos específicos do Kubernetes:

OpenTelemetry Collector no Kubernetes - Configurações avançadas do coletor

Esta tradução de máquina é fornecida para sua comodidade.

Monitore o NGINX no Kubernetes com OpenTelemetry

Antes de você começar

Instale e configure o OpenTelemetry Collector

Crie um segredo do Kubernetes para credenciais

Criar configuração values.yaml

Instalar com Helm

Verificar a implantação e a coleta de dados

Encontre e use dados

Referência de métricas e atributos

Próximos passos

Esta tradução de máquina é fornecida para sua comodidade.

Monitore o NGINX no Kubernetes com OpenTelemetry

Antes de você começar .css-21sua1{background:none;border:none;width:0;padding:0;}

Instale e configure o OpenTelemetry Collector

Criar configuração values.yaml

Instalar com Helm

Verificar a implantação e a coleta de dados

Encontre e use dados

Referência de métricas e atributos

Próximos passos

Antes de você começar