Supported OS
개요 이 점검은 Kubernetes NGINX 수신 컨트롤러 를 모니터링합니다. F5 NGINX 수신 컨트롤러를 모니터링하려면 Datadog Prometheus 통합 을 설정하세요. 이를 통해 NGINX Prometheus Exporter 에서 제공한 목록 중에서 원하는 메트릭을 모니터링할 수 있습니다.
설정 설치 nginx-ingress-controller
점검은 Datadog 에이전트 패키지에 포함되어 있으므로 서버에 추가 설치할 필요가 없습니다.
구성 호스트 호스트에서 에이전트를 실행하는 경우, 에이전트의 구성 디렉터리 루트에 있는 conf.d/
폴더 내 nginx_ingress_controller.d/conf.yaml
파일을 편집하세요. 사용 가능한 설정 옵션 전체를 보려면 [nginx_ingress_controller.d/conf.yaml 샘플][3]을 참고하세요.
컨테이너화 컨테이너화된 환경의 경우 자동탐지 통합 템플릿 에 다음 파라미터를 적용하는 방법이 안내되어 있습니다.
메트릭 수집 기본적으로 NGINX 메트릭은 nginx-ingress-controller
에서 수집됩니다. 그러나 수신 컨트롤러에서 정규 nginx
점검을 실행하는 것이 더 편리할 수 있습니다.
그러려면 에이전트에서 NGINX 상태 페이지에 접근할 수 있도록 하세요. 컨트롤러에 nginx-status-ipv4-whitelist
설정을 사용하고 컨트롤러 포드에 Autodiscovery 주석을 추가하세요.
예를 들어, 이 주석에서 nginx
와 nginx-ingress-controller
점검과 로그 수집을 활성화합니다.
파라미터 값 <INTEGRATION_NAME>
["nginx","nginx_ingress_controller"]
<INIT_CONFIG>
[{},{}]
<INSTANCE_CONFIG>
[{"nginx_status_url": "http://%%host%%:18080/nginx_status"},{"prometheus_url": "http://%%host%%:10254/metrics"}]
사용 가능한 모든 구성 옵션은 nginx_ingress_controller.d/conf.yaml 샘플 을 참고하세요.
참고 : nginx-ingress-controller
0.23.0+ 버전의 경우, 18080
포트를 리스닝하는 nginx
서버가 제거되었습니다. 그러나 구성 configmap에 다음 http-snippet
을 추가해 복원할 수 있습니다.
http-snippet: |
server {
listen 18080;
location /nginx_status {
allow all;
stub_status on;
}
location / {
return 404;
}
}
로그 수집 Agent 버전 6.0 이상에서 사용 가능
Datadog 에이전트에서 로그 수집은 기본값으로 비활성화되어 있습니다. 이를 활성화하려면 Kubernetes 로그 수집 을 참고하세요.
파라미터 값 <LOG_CONFIG>
[{"service": "controller", "source": "nginx-ingress-controller"}]
검증 에이전트의 상태 하위 명령을 실행 하고 Checks 섹션에서 nginx_ingress_controller
를 찾습니다.
수집한 데이터 메트릭 nginx_ingress.controller.cpu.time (count)Cpu usage in secondsShown as second nginx_ingress.controller.last.reload.success (gauge)Whether the last configuration reload attempt was successful nginx_ingress.controller.mem.resident (gauge)Resident memory size in bytesShown as byte nginx_ingress.controller.mem.virtual (gauge)Virtual memory size in bytesShown as byte nginx_ingress.controller.reload.success (count)Cumulative number of Ingress controller reload operations nginx_ingress.controller.request.duration.count (gauge)The count of request processing time nginx_ingress.controller.request.duration.sum (gauge)The sum of request processing timeShown as millisecond nginx_ingress.controller.request.size.count (gauge)The count of request size nginx_ingress.controller.request.size.sum (gauge)The sum of request sizeShown as byte nginx_ingress.controller.requests (count)The total number of client requestsShown as request nginx_ingress.controller.response.duration.count (gauge)Count of response duration per Ingress nginx_ingress.controller.response.duration.sum (gauge)Sum of response duration per IngressShown as second nginx_ingress.controller.response.size.count (gauge)Count of response size per Ingress nginx_ingress.controller.response.size.sum (gauge)Sum of response size per IngressShown as byte nginx_ingress.controller.upstream.latency.count (gauge)[Deprecated] Count of upstream service latency per Ingress nginx_ingress.controller.upstream.latency.quantile (gauge)[Deprecated] Quantiles of upstream service latency per IngressShown as second nginx_ingress.controller.upstream.latency.sum (gauge)[Deprecated] Sum of upstream service latency per IngressShown as second nginx_ingress.nginx.bytes.read (count)Number of bytes readShown as byte nginx_ingress.nginx.bytes.write (count)Number of bytes writtenShown as byte nginx_ingress.nginx.connections.current (gauge)Current number of client connections with stateShown as connection nginx_ingress.nginx.connections.total (count)Total number of connections with stateShown as connection nginx_ingress.nginx.cpu.time (count)Cpu usage in secondsShown as second nginx_ingress.nginx.mem.resident (gauge)Resident memory size in bytesShown as byte nginx_ingress.nginx.mem.virtual (gauge)Virtual memory size in bytesShown as byte nginx_ingress.nginx.process.count (gauge)Number of nginx processesShown as process nginx_ingress.nginx.requests.total (count)Total number of client requestsShown as request
이벤트 NGINX Ingress Controller에는 이벤트가 포함되어 있지 않습니다.
서비스 점검 NGINX Ingress Controller에는 서비스 점검이 포함되어 있지 않습니다.
트러블슈팅 도움이 필요하신가요? Datadog 지원팀 에 문의하세요.