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

NRDOT 수집기 (권장) 또는 OpenTelemetry Collector 사용하여 호스트에서 실행 중인 NGINX Plus 서버를 모니터링하여 지표 및 셸메트리 데이터를 뉴렐릭으로 보냅니다.

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

대시보드는 뉴렐릭 NGINX OpenTelemetry Monitor 퀵스타트를 통해 사용할 수 있습니다.

시작하기 전에

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

유효한 뉴렐릭 클러스터
NGINX Plus 버전 R13 이상
HTTP API 모듈이 활성화된 NGINX Plus
NGINX Plus 인스턴스와 함께 NGINX Prometheus 익스포터를 설치 및 실행하여 HTTP API 메트릭을 Prometheus 형식으로 노출합니다.
Linux 호스트에 다음 수집기 중 하나가 설치되어 있어야 합니다.
- NRDOT 수집기 (권장 - 뉴렐릭의 OpenTelemetry 배포판) 또는
- OpenTelemetry Collector Contrib (대체 옵션)
Linux 호스트에서 네트워크 액세스 대상:
- NGINX Plus HTTP API 엔드포인트
- A 뉴렐릭 OTLP 엔드포인트

NGINX Plus 모니터링 설정

선호하는 수집기를 선택하고 설정 단계를 따르세요.

팁

검증 단계에서 오류가 발생하면 누락된 구성 요소를 설치한 후 계속 진행하십시오. NRDOT 수집기 설치에 도움이 필요하신가요? nrdot-수집기-releases의 설치 섹션을 확인하세요.

설치 중 사용 export collector_distro="nrdot-collector"

NRDOT 수집기를 구성합니다.

NGINX Plus Prometheus exporter에서 데이터를 스크랩하여 뉴렐릭으로 보내도록 NRDOT 수집기를 구성하십시오.

NRDOT 수집기의 경우 기본 설정을 대체하는 독립형 NGINX Plus 모니터링 설정 파일을 생성합니다.

중요

Standalone vs. Combined 모델: 이 설정은 NGINX Plus 서버에만 적용됩니다. 호스트 대역폭(CPU, 메모리, 디스크) 또는 시스템 로그도 필요한 경우 hostmetrics 및 filelog 수신기가 포함된 NRDOT 수집기의 기본 설정을 사용하고 prometheus 수신기를 추가하십시오.

다음 내용으로 /etc/nrdot-collector/nginx-plus-config.yaml 생성하세요:

receivers:
  prometheus:
    config:
      scrape_configs:
        - job_name: 'nginx-plus'
          scrape_interval: 30s
          static_configs:
            - targets: ['<YOUR_PROMETHEUS_EXPORTER_ENDPOINT>']
processors:
  batch:
    send_batch_size: 1024
    timeout: 30s
  filter/nginx_metrics:
    metrics:
      include:
        match_type: regexp
        metric_names:
          - "nginxplus_connections_.*"
          - "nginxplus_http_requests_.*"
          - "nginxplus_ssl_.*"
      exclude:
        match_type: regexp
        metric_names:
          - "nginxplus_server_.*"
          - "nginxplus_location_zone_.*"
          - "nginxplus_cache_.*"
          - "nginxplus_stream_server_.*"
          - "nginxplus_upstream_.*"
          - "nginxplus_stream_upstream_.*"
          - "nginxplus_stream_zone_sync_zone_.*"
          - "nginxplus_resolver_.*"
          - "nginxplus_limit_request_.*"
          - "nginxplus_limit_connection_.*"
          - "nginxplus_stream_limit_connection_.*"
          - "nginxplus_worker_.*"
  resource/nginx:
    attributes:
      - key: nginx.server.endpoint
        value: "<YOUR_API_STATUS_ENDPOINT>"  # Replace with your endpoint
        action: insert
      - key: nginx.deployment.name
        value: "<DEPLOYMENT_NAME>"                    # Replace with your deployment server name
        action: insert
  resourcedetection:
    detectors: [system]
    system:
      resource_attributes:
        host.name:
          enabled: true
        host.id:
          enabled: true
  transform/nginx:
    metric_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
      - context: resource
        statements:
          - delete_key(attributes, "service.name")
  transform/metadata_nullify:
    metric_statements:
      - context: metric
        statements:
          - set(description, "")
          - set(unit, "")
exporters:
  otlp_http:
    endpoint: ${env:YOUR_NEWRELIC_OTLP_ENDPOINT}
    headers:
      api-key: ${env:YOUR_NEW_RELIC_LICENSE_KEY}
service:
  pipelines:
    metrics/nginx:
      receivers: [prometheus]
      processors: [batch, filter/nginx_metrics, resourcedetection, resource/nginx, transform/nginx, transform/metadata_nullify]
      exporters: [otlp_http]

구성 매개변수

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

매개변수	설명
`<YOUR_PROMETHEUS_EXPORTER_ENDPOINT>`	프로메테우스 익스포터 엔드포인트(예: '127.0.0.1:9113')로 바꾸세요.
`<YOUR_API_STATUS_ENDPOINT>`	NGINX Plus 서버의 API 상태 엔드포인트로 교체하십시오(예: http:/127.0.0.1/api/9).
`<DEPLOYMENT_NAME>`	이 NGINX Plus 서버에 대한 고유한 구현 및 배포 이름으로 대체하십시오(예: `production-web-01` , `staging-api` , `prod-lb-01` ).
`scrape_interval`	수집 간격(초). 기본값은 다음과 같이 설정되어 있습니다. `30s`
`send_batch_size`	전송하기 전에 일괄 처리할 메트릭 수입니다. 기본값은 다음과 같이 설정되어 있습니다. `1024`
`timeout`	일괄 처리된 메트릭을 전송하기 전에 대기할 시간 제한(초)입니다. 기본값은 다음과 같이 설정되어 있습니다. `30s`

기본적으로 설정은 핵심 정보(연결, HTTP requests 및 SSL)만 수집합니다. 추가 경로 카테고리를 활성화하려면:

아래 열거형 목록 에서 활성화하려는 열거형을 선택하고 해당 열거형이 속하는 범주를 기록해 두십시오.
filter/nginx_metrics 프로세서에서 해당 메트릭 접두사를 exclude 에서 include 로 이동합니다.
예시: HTTP 서버 영역 메트릭 활성화

exclude 섹션에서 이 줄을 찾으세요:

filter/nginx_metrics:
  metrics:
    include:
    # existing include metrics
    exclude:
      match_type: regexp
      metric_names:
        - "nginxplus_server_.*"

include 섹션으로 이동하세요:

filter/nginx_metrics:
  metrics:
    include:
      match_type: regexp
      metric_names:
        - "nginxplus_connections_.*"
        - "nginxplus_http_requests_.*"
        - "nginxplus_ssl_.*"
        - "nginxplus_server_.*"  # Added to enable server zone metrics
    exclude:
      match_type: regexp
      metric_names:
        # Remove "nginxplus_server_.*" from here
        - "nginxplus_location_zone_.*"
        - "nginxplus_cache_.*"
        # ... rest of exclude list

변경 사항을 적용한 후에는 수집기를 다시 시작하십시오.
bash
```
$sudo systemctl restart nrdot-collector.service
```

환경을 구성하고 구성 경로를 업데이트합니다.

NRDOT 수집기 구성을 업데이트하여 NGINX Plus 구성 파일을 사용하고 OTLP 엔드포인트를 설정하십시오.

귀하의 뉴렐릭 지역을 기준으로 OTLP 포인트를 결정하세요. 해당 지역에 대해 지원되는 엔드포인트 및 포트의 전체 목록은 엔드포인트, 포트 및 프로토콜 구성을 참조하세요.

중요

라이선스 키는 설치 중에 /etc/nrdot-collector/nrdot-collector.conf 에 이미 구성되었습니다. 설정 파일 경로와 OTLP 엔드포인트만 업데이트하면 됩니다.

수집기 설정 파일을 업데이트합니다.

bash

$export collector_distro="nrdot-collector"
$export otlp_endpoint="YOUR_NEWRELIC_OTLP_ENDPOINT"  # Replace with your region's endpoint
$
$# Update the config file path to point to nginx-plus-config.yaml
$sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/nginx-plus-config.yaml"|' /etc/${collector_distro}/${collector_distro}.conf
$
$# Add the OTLP endpoint
$echo "OTEL_EXPORTER_OTLP_ENDPOINT=${otlp_endpoint}" | sudo tee -a /etc/${collector_distro}/${collector_distro}.conf > /dev/null

(선택 사항) NGINX 로그 전달

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

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

/etc/nrdot-collector/nginx-plus-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:
    # Your existing metrics pipeline...

    # Add log pipelines
    logs/nginx-access:
      receivers: [filelog/nginx_access_logs]
      processors: [batch, resource/nginx, transform/nginx_access_logs]
      exporters: [otlp_http]
    logs/nginx-error:
      receivers: [filelog/nginx_error_logs]
      processors: [batch, resource/nginx, transform/nginx_error_logs]
      exporters: [otlp_http]

수집기 사용자에게 로그 파일에 대한 읽기 권한을 부여하십시오.

bash

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

변경 사항을 적용하려면 수집기를 다시 시작하십시오.
bash
```
$sudo systemctl restart nrdot-collector
```

모니터링 시작

이제 모든 설정이 완료되었으므로 NRDOT 수집기를 시작하고 데이터가 뉴렐릭으로 전송되는지 확인하십시오.

설정 변경 사항을 적용합니다.

bash

$sudo systemctl daemon-reload
$sudo systemctl restart nrdot-collector.service

서비스가 실행 중인지 확인하십시오.
bash
```
$sudo systemctl status nrdot-collector.service
```
예상 출력: Active: active (running) (최근 오류 없음)

시작 로그를 확인하세요:

bash

$sudo journalctl -u nrdot-collector.service -n 20

테스트 트래픽 생성(생성하기 위해):

bash

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

뉴렐릭에 초기 데이터가 나타날 때까지 기다린 후 NGINX 에 접속하여 데이터 수집을 확인하십시오.

팁

검증 단계에서 오류가 발생하면 누락된 구성 요소를 설치한 후 계속 진행하십시오. 수집기 설치에 도움이 필요하신가요? OpenTelemetry Collector 설치 가이드를 확인하세요.

OpenTelemetry 수집기 구성

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

중요

편집하기 전에: 기존 설정을 백업하세요. sudo cp /etc/otelcol-contrib/config.yaml /etc/otelcol-contrib/config.yaml.backup

수집기 설정 파일(일반적으로 /etc/otelcol-contrib/config.yaml)을 편집하고 다음 섹션을 추가합니다. 이미 수신자, 처리자 또는 수출자 섹션이 있는 경우 기존 설정과 병합하십시오.

receivers:
  prometheus:
    config:
      scrape_configs:
        - job_name: 'nginx-plus'
          scrape_interval: 30s
          static_configs:
            - targets: ['<YOUR_PROMETHEUS_EXPORTER_ENDPOINT>']
processors:
  batch:
    send_batch_size: 1024
    timeout: 30s
  filter/nginx_metrics:
    metrics:
      include:
        match_type: regexp
        metric_names:
          - "nginxplus_connections_.*"
          - "nginxplus_http_requests_.*"
          - "nginxplus_ssl_.*"
      exclude:
        match_type: regexp
        metric_names:
          - "nginxplus_server_.*"
          - "nginxplus_location_zone_.*"
          - "nginxplus_cache_.*"
          - "nginxplus_stream_server_.*"
          - "nginxplus_upstream_.*"
          - "nginxplus_stream_upstream_.*"
          - "nginxplus_stream_zone_sync_zone_.*"
          - "nginxplus_resolver_.*"
          - "nginxplus_limit_request_.*"
          - "nginxplus_limit_connection_.*"
          - "nginxplus_stream_limit_connection_.*"
          - "nginxplus_worker_.*"
  resource/nginx:
    attributes:
      - key: nginx.server.endpoint
        value: "<YOUR_API_STATUS_ENDPOINT>"  # Replace with your endpoint
        action: insert
      - key: nginx.deployment.name
        value: "<DEPLOYMENT_NAME>"                    # Replace with your deployment name
        action: insert
  resourcedetection:
    detectors: [system]
    system:
      resource_attributes:
        host.name:
          enabled: true
        host.id:
          enabled: true
  transform/nginx:
    metric_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
      - context: resource
        statements:
          - delete_key(attributes, "service.name")
  transform/metadata_nullify:
    metric_statements:
      - context: metric
        statements:
          - set(description, "")
          - set(unit, "")
exporters:
  otlp_http:
    endpoint: ${env:YOUR_NEWRELIC_OTLP_ENDPOINT}
    headers:
      api-key: ${env:YOUR_NEW_RELIC_LICENSE_KEY}
service:
  pipelines:
    metrics/nginx:
      receivers: [prometheus]
      processors: [batch, filter/nginx_metrics, resourcedetection, resource/nginx, transform/nginx, transform/metadata_nullify]
      exporters: [otlp_http]

구성 매개변수

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

매개변수	설명
`<YOUR_PROMETHEUS_EXPORTER_ENDPOINT>`	프로메테우스 익스포터 엔드포인트(예: '127.0.0.1:9113')로 바꾸세요.
`<YOUR_API_STATUS_ENDPOINT>`	NGINX Plus 서버의 API 상태 엔드포인트로 교체하십시오(예: http:/127.0.0.1/api/9).
`<DEPLOYMENT_NAME>`	이 NGINX Plus 서버에 대한 고유한 구현 및 배포 이름으로 대체하십시오(예: `production-web-01` , `staging-api` , `prod-lb-01` ).
`scrape_interval`	지표를 수집하는 간격입니다. 기본값은 다음과 같이 설정되어 있습니다. `30s`
`send_batch_size`	전송하기 전에 일괄 처리할 메트릭 수입니다. 기본값은 다음과 같이 설정되어 있습니다. `1024`
`timeout`	일괄 처리 전 최대 대기 시간. 기본값은 다음과 같이 설정되어 있습니다. `30s`
`nginx.display.name`	뉴렐릭에서 NGINX 서버의 표시 이름 형식 (자동으로 "server: `<DEPLOYMENT_NAME>` "으로 생성됨)

기본적으로 설정은 핵심 정보(연결, HTTP requests 및 SSL)만 수집합니다. 서버 영역, 위치 영역 또는 캐시 영역과 같은 추가 영역 범주를 활성화하려면 다음을 수행하십시오.

아래 목록 에서 활성화할 옵션을 선택하세요. 해당 영역이 어떤 범주에 속하는지 기록해 두세요(예: HTTP 서버 영역, 위치 영역, 캐시).

filter/nginx_metrics 프로세서에서 해당 메트릭 접두사를 exclude 에서 include 로 이동합니다.

예시: HTTP 서버 영역 메트릭 활성화

exclude 섹션에서 이 줄을 찾으세요:

filter/nginx_metrics:
  metrics:
    include:
    # existing include metrics
    exclude:
      match_type: regexp
      metric_names:
        - "nginxplus_server_.*"

include 섹션으로 이동하세요:

filter/nginx_metrics:
  metrics:
    include:
      match_type: regexp
      metric_names:
        - "nginxplus_connections_.*"
        - "nginxplus_http_requests_.*"
        - "nginxplus_ssl_.*"
        - "nginxplus_server_.*"  # Added to enable server zone metrics
    exclude:
      match_type: regexp
      metric_names:
        # Remove "nginxplus_server_.*" from here
        - "nginxplus_location_zone_.*"
        - "nginxplus_cache_.*"
        # ... rest of exclude list

변경 사항을 적용한 후에는 수집기를 다시 시작하십시오.
bash
```
$sudo systemctl restart otelcol-contri.service
```

인증 설정

OpenTelemetry Collector 뉴릭 계정으로 데이터를 전송할 수 있도록 보안 인증을 구성하십시오. 이 단계에서는 자격 증명을 안전하게 보호하기 위한 환경 변수를 설정합니다.

뉴렐릭 자격증을 취득하세요:
- 인스턴스 키: API 키 UI 페이지에서 인스턴스 키를 가져옵니다.
- OTLP 엔드포인트: 뉴렐릭 OTLP엔드포인트에서 해당 지역의 엔드포인트를 사용하세요.

자격 증명을 구성하세요:

systemd 오버라이드 디렉터리를 생성합니다.

bash

$export collector_distro="otelcol-contrib"
$sudo mkdir -p /etc/systemd/system/${collector_distro}.service.d

환경 설정 파일을 생성합니다.

bash

$cat <<EOF | sudo tee /etc/systemd/system/${collector_distro}.service.d/environment.conf
$[Service]
$Environment="NEWRELIC_OTLP_ENDPOINT=<`YOUR_NEWRELIC_OTLP_ENDPOINT>`"
$Environment="NEWRELIC_LICENSE_KEY=`<YOUR_NEW_RELIC_LICENSE_KEY>`"
$EOF

(선택 사항) NGINX 로그 전달

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

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

/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:
    # Your existing metrics pipeline...

    # Add log pipelines
    logs/nginx-access:
      receivers: [filelog/nginx_access_logs]
      processors: [batch, resource/nginx, transform/nginx_access_logs]
      exporters: [otlp_http]
    logs/nginx-error:
      receivers: [filelog/nginx_error_logs]
      processors: [batch, resource/nginx, transform/nginx_error_logs]
      exporters: [otlp_http]

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

변경 사항을 적용하려면 수집기를 다시 시작하십시오.
bash
```
$sudo systemctl restart otelcol-contrib
```

모니터링 시작

이제 모든 설정이 완료되었으므로 OpenTelemetry Collector 시작하고 데이터가 뉴렐릭으로 제대로 전송되는지 확인하십시오.

설정 변경 사항을 적용합니다.

bash

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

서비스가 실행 중인지 확인하십시오.
bash
```
$sudo systemctl status otelcol-contrib.service
```
예상 출력: Active: active (running) (최근 오류 없음)

시작 로그를 확인하세요:

bash

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

테스트 트래픽 생성(생성하기 위해):

bash

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

뉴렐릭에 초기 데이터가 나타날 때까지 기다린 후 NGINX 에 접속하여 데이터 수집을 확인하십시오.

데이터 찾기 및 사용

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

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

수집된 지표

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

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

미터법	설명	유형
`nginxplus_connections_accepted`	허용된 클라이언트 연결	합집합
`nginxplus_connections_active`	활성 클라이언트 연결	계량기
`nginxplus_connections_dropped`	클라이언트 연결이 끊어졌습니다	합집합
`nginxplus_connections_idle`	유휴 클라이언트 연결	계량기

미터법	설명	유형
`nginxplus_http_requests_total`	총 HTTP requests	합집합
`nginxplus_http_requests_current`	현재 HTTP requests	계량기

미터법	설명	유형
`nginxplus_ssl_handshakes`	SSL 핸드셰이크 성공	합집합
`nginxplus_ssl_handshakes_failed`	SSL 핸드셰이크 실패	합집합
`nginxplus_ssl_session_reuses`	SSL 핸드셰이크 중 세션 재사용	합집합

중요

참고: 이러한 기능은 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 (선택 사항) NRDOT 수집기에 대한 추가 메트릭 활성화 또는 (선택 사항) OpenTelemetry Collector Contrib에 대한 추가 메트릭 활성화를 참조하십시오.

미터법	설명	유형
`nginxplus_server_zone_processing`	현재 처리 중인 고객 requests	계량기
`nginxplus_server_zone_requests`	총 고객 requests	합집합
`nginxplus_server_zone_responses`	고객에게 발송된 총 응답 수	합집합
`nginxplus_server_zone_responses_codes`	코드별로 클라이언트에게 전송된 총 응답 수	합집합
`nginxplus_server_zone_discarded`	응답을 보내지 않고 완료된 요청	합집합
`nginxplus_server_zone_received`	클라이언트로부터 수신한 바이트	합집합
`nginxplus_server_zone_sent`	클라이언트로 전송된 바이트	합집합
`nginxplus_server_ssl_handshakes`	SSL 핸드셰이크 성공	합집합
`nginxplus_server_ssl_handshakes_failed`	SSL 핸드셰이크 실패	합집합
`nginxplus_server_ssl_session_reuses`	SSL 핸드셰이크 중 세션 재사용	합집합

중요

미터법	설명	유형
`nginxplus_location_zone_requests`	총 고객 requests	합집합
`nginxplus_location_zone_responses`	고객에게 발송된 총 응답 수	합집합
`nginxplus_location_zone_responses_codes`	코드별로 클라이언트에게 전송된 총 응답 수	합집합
`nginxplus_location_zone_discarded`	응답을 보내지 않고 완료된 요청	합집합
`nginxplus_location_zone_received`	클라이언트로부터 수신한 바이트	합집합
`nginxplus_location_zone_sent`	클라이언트로 전송된 바이트	합집합

중요

미터법	설명	유형
`nginxplus_cache_size`	캐시의 전체 크기	계량기
`nginxplus_cache_max_size`	캐시의 최대 크기	계량기
`nginxplus_cache_cold`	캐시가 콜드 캐시로 간주되나요?	계량기
`nginxplus_cache_hit_responses`	총 리치히트 개수	합집합
`nginxplus_cache_hit_bytes`	리치 히트에서 반환된 총 바이트 수	합집합
`nginxplus_cache_stale_responses`	부실한 총 개수	합집합
`nginxplus_cache_stale_bytes`	오래된 쿠키에서 반환된 총 바이트 수	합집합
`nginxplus_cache_updating_responses`	캐시 업데이트 중 총 캐시 히트 횟수	합집합
`nginxplus_cache_updating_bytes`	캐시 업데이트 중 캐시에서 반환된 총 바이트 수	합집합
`nginxplus_cache_revalidated_responses`	캐시 재검증 총 횟수	합집합
`nginxplus_cache_revalidated_bytes`	캐시 재검증에서 반환된 총 바이트 수	합집합
`nginxplus_cache_miss_responses`	총 캐시 미스 횟수	합집합
`nginxplus_cache_miss_bytes`	캐시 미스로 인해 반환된 총 바이트 수	합집합
`nginxplus_cache_expired_responses`	TTL이 만료된 총 리치 히트 수	합집합
`nginxplus_cache_expired_bytes`	만료된 TTL을 가진 캐시 히트에서 반환된 총 바이트 수	합집합
`nginxplus_cache_expired_responses_written`	TTL이 만료된 캐시 히트의 총 개수가 캐시에 기록되었습니다.	합집합
`nginxplus_cache_expired_bytes_written`	TTL이 만료된 쿠키 히트에서 캐시에 쓴 총 바이트 수	합집합
`nginxplus_cache_bypass_responses`	캐시 바이패스 총 횟수	합집합
`nginxplus_cache_bypass_bytes`	캐시 바이패스에서 반환된 총 바이트 수	합집합
`nginxplus_cache_bypass_responses_written`	캐시에 기록된 캐시 바이패스의 총 횟수	합집합
`nginxplus_cache_bypass_bytes_written`	캐시 바이패스를 통해 캐시에 기록된 총 바이트 수	합집합

기인하다	설명	예시 값
`server_zone`	서버 영역의 이름(HTTP 서버 영역 메트릭에 적용됨)	`example.com`, `api.example.com`
`code`	HTTP 응답 상태 코드(응답에 적용됨)	`1xx`, `2xx` , `3xx` , `4xx` , `5xx` , `200` , `404` , `500`
`location_zone`	위치 영역의 이름	`/api`, `/images` , `/static`
`cache`	캐시의 이름	`my_cache`, `static_cache`
`nginx.server.endpoint`	NGINX Plus API 엔드포인트 URL	`http://localhost:8080/api`
`nginx.deployment.name`	이 NGINX Plus 구현을 식별하는 고유한 이름, 배포	`production-web-01`, `staging-api`
`nginx.display.name`	"서버" 접두사와 구현, 배포 이름을 결합한 보기 편한 이름	`server:production-web-01`
`host.name`	NGINX Plus가 실행 중인 시스템의 호스트명	`web-server-01.example.com`
`host.id`	호스트 시스템의 고유 식별자	`i-1234567890abcdef0`
`logtype`	수집되는 로그 유형 (로그에만 해당). 뉴렐릭의 내장 구문 분석 규칙 에서 사용됩니다. 이 속성은 로그 포워딩이 활성화된 경우에만 사용할 수 있습니다.	`nginx` (접근 로그용), `nginx-error` (오류 로그용)

다음 단계

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

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

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

OpenTelemetry사용하여 자체 호스팅 NGINX 모니터링 - 표준 NGINX 구현의 경우 배포
컨테이너 환경에서 OpenTelemetry를 사용하여 Kubernetes의 NGINX를 모니터링하세요 -

사용자의 편의를 위해 제공되는 기계 번역입니다.

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

시작하기 전에 .css-21sua1{background:none;border:none;width:0;padding:0;}

NGINX Plus 모니터링 설정

팁

NRDOT 수집기를 구성합니다.

2단계: (선택 사항) 추가 기능을 활성화합니다.

환경을 구성하고 구성 경로를 업데이트합니다.

중요

(선택 사항) NGINX 로그 전달

1단계: NGINX Plus 로그 형식 구성

2단계: 로그 포워딩을 위한 NRDOT 수집기 구성

모니터링 시작

1단계: 수집기를 시작합니다

2단계: 데이터 수집 검증

팁

OpenTelemetry 수집기 구성

1단계: 수집기 구성 설정

2단계: (선택 사항) 추가 기능을 활성화합니다.

인증 설정

(선택 사항) NGINX 로그 전달

1단계: NGINX Plus 로그 형식 구성

2단계: 로그인 포워딩을 위한 OpenTelemetry Collector 구성

모니터링 시작

1단계: 수집기를 시작합니다

2단계: 데이터 수집 검증

데이터 찾기 및 사용

수집된 지표

사이

HTTP

SSL

HTTP 서버 영역

위치 영역

은닉처

속성

다음 단계

시작하기 전에