개요

본 점검은 Kubernetes NGINX Ingress Controller를 모니터링합니다. F5 NGINX Ingress Controller를 모니터링하려면 Datadog Prometheus 통합을 설정하세요. 이를 통해 NGINX Prometheus Exporter가 제공한 목록 중에서 원하는 메트릭을 모니터링할 수 있습니다.

설정

설치

nginx-ingress-controller 점검은 Datadog Agent 패키지에 포함되어 있으므로 서버에 별도로 설치할 필요가 없습니다.

설정

메트릭 수집

기본적으로 NGINX 메트릭은 nginx-ingress-controller에서 수집됩니다. 그러나 수신 컨트롤러에서 정규 nginx 점검을 실행하는 것이 더 편리할 수 있습니다.

그러려면 에이전트에서 NGINX 상태 페이지에 접근할 수 있도록 하세요. 컨트롤러에 nginx-status-ipv4-whitelist 설정을 사용하고 컨트롤러 포드에 Autodiscovery 주석을 추가하세요.

예를 들어, 이 주석에서 nginx와 nginx-ingress-controller 점검과 로그 수집을 활성화합니다.

사용 가능한 모든 구성 옵션은 샘플 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;
      }
    }

참고: 히스토그램 메트릭(예: nginx_ingress.controller.response.* 메트릭)은 기본적으로 수집되지 않으며, 추가 collect_nginx_histograms 인스턴스 구성 파라미터를 true로 설정해야 합니다. 히스토그램 메트릭은 태그 카디널리티가 높으므로 파라미터 기본값은 false입니다.

로그 수집

에이전트 버전 > 6.0에서 사용 가능

Datadog Agent에서는 로그 수집이 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 Kubernetes 로그 수집을 참고하세요.

검증

Agent 상태 하위 명령을 실행하고 Checks 섹션에서 nginx_ingress_controller를 찾습니다.

수집한 데이터

Metrics

이벤트

NGINX Ingress Controller에는 이벤트가 포함되어 있지 않습니다.

서비스 점검

NGINX Ingress Controller에는 서비스 점검이 포함되어 있지 않습니다.

트러블슈팅

도움이 필요하세요? Datadog 지원 팀에 문의하세요.