이 참조는 호스트 및 Kubernetes 구현 모두에 적용 가능한 OpenTelemetry NGINX 수신기에서 수집한 모든 지표 및 속성을 다루고 있습니다.
핵심 NGINX 메트릭
OpenTelemetry Collector Contrib의 nginxreceiver는 NGINX 스텁 상태 모듈에서 다음 메트릭을 수집합니다.
미터법 | 설명 | 유형 |
|---|---|---|
| 승인된 클라이언트 연결의 총 개수입니다. 이 기능을 사용하여 시간 경과에 따른 연결 수락률을 추적하십시오. | 합집합 |
| 처리된 연결의 총 수입니다. 일반적으로, 수행하는 값은 nginx.connections_accepted와 동일합니다. 일부 리소스 제한(예: worker_connections 제한)에 도달하지 않는 한. 수용된 양과 처리된 양 사이의 차이는 자원 제약을 시사합니다. | 합집합 |
| 주별 현재 Nginx 연결 수. 상태에는 활성 (총 활성 연결 수), 읽기 (요청 헤더 읽기), 쓰기 (응답 쓰기), 대기 (다음 요청을 기다리는 유지 연결)가 포함됩니다. | 합집합 |
| 서버 가동 이후 서버에 대한 총 requests 횟수입니다. 성능 분석을 위해 속도 계산을 사용하여 초당 requests 도출합니다. | 합집합 |
용량 계획 수립 팁:
- 높은
waiting연결 수는 유지 튜닝 기회를 나타낼 수 있습니다. accepted과handled연결 사이의 간격은 자원 제약을 시사합니다.- 요청 대비 연결 비율은 워커 설정을 최적화하는 데 도움이 됩니다.
리소스 속성
리소스 속성은 NGINX 구현, 배포에 대한 컨텍스트를 제공하며 온호스트 또는 Kubernetes 구현, 배포를 사용하는지 여부에 따라 달라집니다.
공통 속성
기인하다 | 설명 | 예시 값 |
|---|---|---|
| 연결 상태( |
|
| NGINX 스텁 상태 엔드포인트 URL |
|
호스트 구현, 배포 속성
기인하다 | 설명 | 예시 값 |
|---|---|---|
| 이 NGINX 구현을 식별하는 고유한 이름, 배포 |
|
| "서버" 접두사와 구현, 배포 이름을 결합한 보기 편한 이름 |
|
| NGINX가 실행 중인 시스템의 호스트명 |
|
| 호스트 시스템의 고유 식별자 |
|
| 수집되는 로그 유형 (로그에만 해당). 뉴렐릭의 내장 구문 분석 규칙 에서 사용됩니다. 이 속성은 로그 포워딩이 활성화된 경우에만 사용할 수 있습니다. |
|
Kubernetes 구현, 배포 속성
기인하다 | 설명 | 예시 값 |
|---|---|---|
| 쿠버네티스 클러스터의 이름 |
|
| NGINX 파드가 실행 중인 Kubernetes 네임스페이스 |
|
| NGINX를 실행하는 Kubernetes 파드의 이름 |
|
| Kubernetes 구현, 배포에 대한 패드 이름으로 설정 |
|
| 클러스터, 지우스페이스, 파드 정보를 포함한 종합 표시 이름 |
|
컬렉션 상세 정보
수집 빈도
- 기본 간격: 30초
- 설정 가능: OpenTelemetry Collector 설정에서 조정할 수 있습니다.
데이터 소스
모든 메트릭은 NGINX stub_status 모듈 에서 수집되며, 이 모듈은 HTTP 엔드포인트를 노출하도록 활성화 및 구성되어 있어야 합니다.
측정항목 유형
- 합계: 시간에 따른 총합을 나타내는 누적 값
- 속도 계산: 뉴렐릭의
rate()함수를 사용하여 누적 지표를 초당 속도로 변환하여 관찰합니다.
관련 문서
설치 가이드:
- 자체 호스팅 환경에서 NGINX 모니터링 - 호스트 내 구현을 위한 전체 설정, 배포
- Kubernetes에서 NGINX 모니터링 - Kubernetes 구현, 배포에 대한 전체 설정
데이터 사용량:
- NGINX 데이터 찾기 및 쿼리 - Dashboards, NRQL 쿼리 및 알림
기술 참고 자료:
- NGINX 수신기 문서 - OpenTelemetry 기술 세부 정보