OpenTelemetry를 사용하여 자체 호스팅 NGINX Plus를 모니터링하세요.

OpenTelemetry Collector 사용하여 호스트에서 실행 중인 NGINX Plus 서버를 모니터링하여 인덱스 및 델메트리 데이터를 뉴렐릭으로 보냅니다.

이 통합은 OpenTelemetry prometheusreceiver 및 nginx-prometheus-exporter를 활용하여 NGINX Plus 성능 지표, 연결 통계 및 서버 상태를 모니터링합니다. NGINX Plus의 풍부한 HTTP API는 표준 NGINX의 기본 스텁 상태 모듈에 비해 훨씬 더 자세한 메트릭을 제공합니다.

시작하기 전에

시작하기 전에 다음 사항을 확인하세요.

• 뉴렐릭 계정라이선스 키

• NGINX Plus 버전 R13 이상

• HTTP API 모듈이 활성화된 NGINX Plus

• NGINX Plus 인스턴스와 함께 NGINX Prometheus 익스포터를 설치 및 실행하여 HTTP API 메트릭을 Prometheus 형식으로 노출합니다.

• Linux 호스트에 OpenTelemetry Collector Contrib이 설치 및 실행 중입니다.

• 리눅스 호스트에서 네트워크로의 접근:

  • NGINX Plus HTTP API 엔드포인트
  • 뉴렐릭 OTLP 엔포인트의 누구든

설정을 확인하세요

NGINX Plus 버전을 확인하세요:

$
nginx -V 2>&1 | grep -o "nginx/[0-9.]*"

예상 출력: nginx/1.25.0 이상 (R13+)

OpenTelemetry Collector를 확인하세요:

$
otelcol-contrib --version

예상 출력: 버전 정보 (최소 버전 0.88.0 필요)

네트워크 연결 상태를 테스트하세요:

$
# For US region
$
curl -I https://otlp.nr-data.net:4318/v1/metrics
$
# For EU region
$
curl -I https://otlp.eu01.nr-data.net:4318/v1/metrics

예상 출력: HTTP/2 405 (메서드가 허용되지 않음이 예상됩니다)

1단계: NGINX Plus 구성

NGINX Plus 서버에서 메트릭을 노출하도록 HTTP API 모듈을 구성하고 활성화하십시오.

server {
    listen 8080;
    server_name localhost;

    location /api {
        api write=on;
        # Restrict access as needed
        allow 127.0.0.1;
        deny all;
    }
}

$
sudo nginx -t && sudo nginx -s reload

$
curl -I http://127.0.0.1:8080/api/9 2>/dev/null | head -n 1 | cut -d$' ' -f1,2

HTTP/1.1 200

2단계: OpenTelemetry Collector 구성

OpenTelemetry Collector NGINX Plus Prometheus exporter에서 데이터를 수집하여 뉴렐릭으로 전송하도록 구성하십시오.

$
# Download and install the exporter
$
wget https://github.com/nginx/nginx-prometheus-exporter/releases/latest/download/nginx-prometheus-exporter_linux_amd64.tar.gz
$
tar -xzf nginx-prometheus-exporter_linux_amd64.tar.gz
$
sudo mv nginx-prometheus-exporter /usr/local/bin/
$

$
# Run the exporter (customize the -nginx.scrape-uri as needed)
$
nginx-prometheus-exporter -nginx.scrape-uri=http://127.0.0.1:8080/api

3단계: 수집기를 위한 환경 변수 설정

수출자가 인증할 수 있도록 뉴렐릭 라이선스 키및 OTLP 엔드포인트를 수집기 서비스에 삽입하세요.

$
sudo mkdir -p /etc/systemd/system/otelcol-contrib.service.d

$
cat <<EOF | sudo tee /etc/systemd/system/otelcol-contrib.service.d/environment.conf
$
[Service]
$
Environment="NEWRELIC_OTLP_ENDPOINT=YOUR_OTLP_ENDPOINT"
$
Environment="NEWRELIC_LICENSE_KEY=YOUR_LICENSE_KEY"
$
EOF

$
sudo systemctl daemon-reload
$
sudo systemctl restart otelcol-contrib.service

4단계: 데이터 수집 검증

OpenTelemetry Collector NGINX Plus 데이터를 성공적으로 수집하여 뉴럴릭으로 전송하는지 확인하십시오.

$
sudo journalctl -u otelcol-contrib.service -n 20

$
# Make a few requests to your NGINX Plus server
$
curl http://localhost

5단계: (선택 사항) NGINX 로그 전달

지표와 함께 로그 이벤트를 원할 경우 액세스 및 오류 로그를 포함하도록 수집기 설정을 확장하세요.

NGINX Plus 로그 형식 구성

로그를 전달하기 전에 구조화된 로그인 형식을 사용하도록 NGINX Plus를 구성하세요. 액세스 및 오류 로그 구성에 대한 자세한 내용은 NGINX 로깅 문서를 참조하십시오.

로그인 포워딩을 위한 OpenTelemetry Collector 구성

1. NGINX 액세스 로그 파일과 오류 로그 파일의 전체 경로를 기록해 두세요. 기본값은 일반적으로 /var/log/nginx/access.log 과 /var/log/nginx/error.log 입니다.

2. /etc/otelcol-contrib/config.yaml 업데이트하여 filelog 수신기와 로그 파이프라인을 추가합니다.

   receivers:
     prometheus:
       # existing Prometheus receiver configuration
     filelog/nginx_access_logs:
       include:
         - /var/log/nginx/access.log
     filelog/nginx_error_logs:
       include:
         - /var/log/nginx/error.log
   
   processors:
     batch:
       # existing settings
     filter/nginx_metrics:
       # existing settings
     resourcedetection:
       # existing settings
     resource/nginx:
       # existing settings
     transform/nginx_metrics:
       # existing settings
     transform/nginx_access_logs:
       log_statements:
         - context: resource
           statements:
             - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
             - set(attributes["logtype"], "nginx")
     transform/nginx_error_logs:
       log_statements:
         - context: resource
           statements:
             - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
             - set(attributes["logtype"], "nginx-error")
   
   exporters:
     # existing exporter setup
   
   service:
     pipelines:
       metrics/nginx:
         receivers: [prometheus]
         processors: [batch, filter/nginx_metrics, resourcedetection, resource/nginx, transform/nginx_metrics]
         exporters: [otlphttp/newrelic]
       logs/nginx-access:
         receivers: [filelog/nginx_access_logs]
         processors: [batch, resource/nginx, transform/nginx_access_logs]
         exporters: [otlphttp/newrelic]
       logs/nginx-error:
         receivers: [filelog/nginx_error_logs]
         processors: [batch, resource/nginx, transform/nginx_error_logs]
         exporters: [otlphttp/newrelic]

   카피

3. otelcol-contrib 사용자에게 로그 파일에 대한 읽기 권한을 부여하십시오.

   bash

   카피

   $
   sudo usermod -a -G adm otelcol-contrib
   $
   sudo chmod 644 /var/log/nginx/access.log
   $
   sudo chmod 644 /var/log/nginx/error.log

4. 변경 사항을 적용하려면 수집기를 다시 시작하십시오.

   bash

   카피

   $
   sudo systemctl restart otelcol-contrib

데이터 찾기 및 사용

1. one.newrelic.com > Integrations & Agents 로 이동하세요.
2. Dashboards 선택하고 NGINX OTel overview [NGINX OTel 개요] 대시보드를 클릭합니다.
3. 팝업 창에서 계정을 선택하세요.
4. 대시보드 보기를 클릭하고 뉴렐릭에서 NGINX Plus 데이터를 확인하세요.

NGINX Plus 메트릭은 Metric 이벤트 유형 에 연결됩니다. 문제 해결, 해결 목적으로 이 데이터를 쿼리 하거나 사용자 정의 차트 및 대시보드를 생성할 수 있습니다.

수집된 지표

OpenTelemetry Collector는 NGINX Prometheus 익스포터 에서 메트릭을 수집합니다. 이 익스포터는 NGINX Plus HTTP API 메트릭을 Prometheus 형식으로 제공합니다.

다음은 사용 가능한 NGINX Plus 메트릭입니다.

다음 단계

데이터에 대해 자세히 알아보세요:

• NGINX 데이터 찾기 및 쿼리 - 대시보드에 액세스하고 사용자 정의 쿼리를 생성하고 알림 설정
• NRQL소개 - 고급 데이터 분석을 위한 뉴렐릭의 쿼리 언어를 알아보세요.
• NRQL 공지 조건 생성 - NGINX Plus 지표를 기반으로 사용자 정의 알림 설정

관련 모니터링 정보를 살펴보세요:

• OpenTelemetry사용하여 자체 호스팅 NGINX 모니터링 - 표준 NGINX 구현의 경우 배포
• 컨테이너 환경에서 OpenTelemetry를 사용하여 Kubernetes의 NGINX를 모니터링하세요 -
• NGINX OpenTelemetry 개요 - 수집되는 메트릭, 속성 및 사용 사례 이해하기
• OpenTelemetry 모범 사례 - OpenTelemetry 설정 최적화

NGINX Plus 리소스:

• NGINX Prometheus 익스포터 문서 - 기술 세부 정보 및 고급 설정
• NGINX Plus API 문서 - 완벽한 API 참조 및 기능