OpenTelemetry를 사용하여 Kubernetes에서 NGINX를 모니터링하세요.

시작하기 전에

다음 사항을 확인하십시오:

• 유효한 뉴렐릭 클러스터

• NGINX에서 HTTP 스텁 상태 모듈을 활성화해야 합니다.

• 모니터가 필요한 각 NGINX 파드에 app 및 role 레이블을 추가합니다.

• Helm installed

  OpenTelemetry 수집기 구성

  Helm 사용하여 OpenTelemetry Collector 쿠버네티스 클러스터에 구현합니다. 수집기는 NGINX 파드에서 메트릭을 자동으로 검색하고 수집합니다.

  1단계: 사용자 정의 value.yaml 설정 만들기

  OpenTelemetry Collector values.yaml을 기반으로 사용자 지정 values.yaml 파일을 다운로드하거나 생성하세요.

  values.yaml 파일에서 다음 섹션을 업데이트하세요.

  1. 모드를 구현으로 설정합니다.

     mode: deployment

     카피

  2. 이미지 저장소를 교체하세요:

     image:
       repository: otel/opentelemetry-collector-contrib

     카피

  3. 클러스터 역할 구성:

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

     카피

  4. 리소스 제한을 구성합니다.

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

     카피

  5. 전체 설정 섹션을 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]

     카피

     구성 매개변수

     다음 표에서는 주요 설정 시위에 대해 설명합니다.

     매개변수	설명
     <YOUR_STUB_STATUS_PORT>	NGINX 스텁 상태 포트(예: 80, 8080)로 교체하십시오.
     <YOUR_STUB_STATUS_PATH>	NGINX 스텁 상태 경로(예: basic_status)로 바꿔주세요.
     <CLUSTER_NAME>	뉴렐릭에서 식별할 수 있도록 쿠버네티스 클러스터 이름으로 바꾸세요.
     <YOUR_NEWRELIC_OTLP_ENDPOINT>	해당 지역의 OTLP 엔드포인트로 업데이트하세요. OTLP 엔드포인트 문서를 참조하십시오.
     <YOUR_NEW_RELIC_LICENSE_KEY>	귀하의 뉴렐릭 피규어 키로 교체하세요
     app 그리고 role 레이블	NGINX를 식별하는 데 사용되는 파드 레이블 (레이블에 맞게 규칙을 업데이트하세요)
     basic_status	NGINX 스텁 상태 엔드포인트 경로 (다른 경로를 사용하는 경우 업데이트하세요)
     collection_interval	수집 간격(초). 기본값은 다음과 같이 설정되어 있습니다. 30s
     send_batch_size	전송하기 전에 일괄 처리할 메트릭 수입니다. 기본값은 다음과 같이 설정되어 있습니다. 1024
     timeout	일괄 처리된 메트릭을 전송하기 전에 대기할 시간 제한(초)입니다. 기본값은 다음과 같이 설정되어 있습니다. 30s

  2단계: Helm을 사용하여 설치

  OpenTelemetry Collector Helm 차트 설치 가이드를 따라 사용자 지정 values.yaml 파일을 사용하여 수집기를 설치하십시오.

  예시 명령어:

  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

  3단계: 구현, 배포 및 데이터 수집 확인

  1. 파드가 실행 중인지 확인하십시오.

     bash

     카피

     $
     kubectl get pods -n newrelic --watch

     newrelic 네임스페이스에서 OpenTelemetry Collector 파드가 Running 상태로 표시되는 것을 확인해야 합니다.

  2. 데이터 수집을 확인하려면 뉴렐릭에서 NRQL 쿼리를 실행하세요. 클러스터 이름을 실제 클러스터 이름으로 바꾸세요.

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

     카피

NGINX 파드에서 이미 nginx-prometheus-exporter 를 사이드카로 실행 중이거나 Prometheus 기반 모니터링 스택에서 마이그레이션하는 경우 이 접근 방식을 사용하세요.

시작하기 전에

다음 사항을 확인하십시오:

• 유효한 뉴렐릭 클러스터

• 모니터해야 하는 각 NGINX 파드에서 HTTP stub status 모듈을 활성화합니다.

• 모니터가 필요한 각 NGINX 파드에 app 및 role 레이블을 추가합니다.

• Helm installed

  NRDOT 수집기 ― Helm 설치

  계속하기 전에 nr-k8s-otel-collector 에 대한 기본 Kubernetes OpenTelemetry Helm 설치 를 완료하세요.

  1. deployment.configMap.extraConfig 의 values.yaml 아래에 다음 섹션을 추가합니다:

     중요

     deployment.configMap.extraConfig에서 pipelines: 은(는) service: 아래에 중첩되지 않고 루트 수준에서 정의되어야 합니다. Helm 차트 템플릿은 extraConfig.pipelines 을(를) service.pipelines에, extraConfig.service.extensions 을(를) service.extensions에 매핑합니다.

     확장:

     extensions:
       health_check:
         endpoint: 0.0.0.0:13133
       k8s_observer:
         auth_type: serviceAccount
         observe_nodes: true
         observe_pods: 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:
       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, "")

     카피

     서비스 확장:

     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
           - memory_limiter
         exporters:
           - otlphttp/newrelic

     카피

     구성 매개변수

     다음 표에서는 주요 설정 시위에 대해 설명합니다.

     매개변수	설명
     <CLUSTER_NAME>	귀하의 쿠버네티스 클러스터 이름입니다. 뉴렐릭에서 식별하는 데 사용됩니다.
     <YOUR_LICENSE_KEY>	귀하의 뉴렐릭 라이선스 키입니다.
     app 그리고 role 레이블	NGINX 파드를 검색하는 데 사용되는 파드 레이블입니다. 파드 레이블과 일치하도록 rule 을(를) 업데이트합니다.
     name == "metrics"	receiver_creator가 감시하는 9113 의 명명된 컨테이너 포트입니다. 파드 사양의 포트 이름과 일치해야 합니다.
     scrape_interval	Prometheus 메트릭을 스크랩하는 빈도입니다. 기본값: 30s .

  2. 실행 중인 Helm 릴리스에 업데이트된 값을 적용합니다:

     bash

     카피

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

  OTel Collector Contrib ― Helm 설치

  1단계: 사용자 정의 value.yaml 설정 만들기

  OpenTelemetry Collector values.yaml을 기반으로 사용자 지정 values.yaml 파일을 다운로드하거나 생성하세요.

  values.yaml 파일에서 다음 섹션을 업데이트하세요.

  1. 모드를 구현으로 설정합니다.

     mode: deployment

     카피

  2. 이미지 저장소를 교체하세요:

     image:
       repository: otel/opentelemetry-collector-contrib

     카피

  3. 클러스터 역할 구성:

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

     카피

  4. 리소스 제한을 구성합니다.

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

     카피

  5. 전체 config 섹션을 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]

     카피

     구성 매개변수

     다음 표에서는 주요 설정 시위에 대해 설명합니다.

     매개변수	설명
     <CLUSTER_NAME>	귀하의 쿠버네티스 클러스터 이름입니다. 뉴렐릭에서 식별하는 데 사용됩니다.
     <YOUR_NEW_RELIC_LICENSE_KEY>	귀하의 뉴렐릭 라이선스 키입니다.
     <YOUR_NEWRELIC_OTLP_ENDPOINT>	해당 리전의 OTLP 엔드포인트입니다. OTLP 엔드포인트 문서 를 참조하세요.
     app 그리고 role 레이블	NGINX 파드를 검색하는 데 사용되는 파드 레이블입니다. 파드 레이블과 일치하도록 rule 을(를) 업데이트합니다.
     name == "metrics"	receiver_creator가 감시하는 9113 의 명명된 컨테이너 포트입니다. 파드 사양의 포트 이름과 일치해야 합니다.
     scrape_interval	Prometheus 메트릭을 스크랩하는 빈도입니다. 기본값: 30s .

  2단계: Helm을 사용하여 설치

  OpenTelemetry Collector Helm 차트 설치 가이드를 따라 사용자 지정 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

  3단계: 구현, 배포 및 데이터 수집 확인

  1. 수집기 파드가 실행 중인지 확인합니다:

     bash

     카피

     $
     kubectl get pods -n newrelic --watch

  2. 수집기 로그에서 성공적인 파드 검색 및 스크랩을 확인합니다:

     bash

     카피

     $
     kubectl logs -n newrelic -l app.kubernetes.io/name=opentelemetry-collector -f

     NGINX 파드를 검색하는 receiver_creator/nginx_prom 을(를) 참조하는 줄을 찾습니다.

  3. 뉴렐릭에서 NRQL 쿼리를 실행하여 데이터가 도착하는지 확인합니다. <CLUSTER_NAME> 을(를) 클러스터 이름으로 바꿉니다:

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

     카피