호스트

호스트에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

1. Prometheus 플러그인 활성화를 통해 OpenMetrics 메트릭이 Kong 서비스에 노출되는지 확인합니다. Agent가 Kong 메트릭을 수집하기 전에 이를 먼저 설정해야 합니다.

2. Agent 구성 디렉터리의 루트에서 conf.d/ 폴더에 있는 kong.d/conf.yaml 파일에 이 구성 블록을 추가하여 Kong 메트릭 수집을 시작합니다. 사용 가능한 모든 구성 옵션은 샘플 kong.d/conf.yaml을 참조하세요.

   init_config:
   
   instances:
     ## @param openmetrics_endpoint - string - required
     ## OpenMetrics 형식으로 메트릭을 노출하는 URL입니다.
     #
     - openmetrics_endpoint: http://localhost:8001/metrics
   

3. 에이전트를 재시작합니다.

참고: 점검의 현재 버전(1.17.0+)은 메트릭 수집을 위해 OpenMetrics를 사용하며 Python 3이 필요합니다. 호스트가 Python 3을 사용할 수 없거나 이 점검의 레거시 버전을 사용하려면 다음 config을 참조하세요.

로그 수집

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

Kong 액세스 로그는 NGINX에서 생성되므로 기본 위치는 NGINX 파일과 동일합니다.

1. 로그 수집은 Datadog 에이전트에서 기본적으로 비활성화되어 있습니다. datadog.yaml 파일에서 활성화합니다.

   logs_enabled: true
   

2. Kong 로그 수집을 시작하려면 kong.d/conf.yaml 파일에 다음 구성 블록을 추가합니다.

   logs:
     - type: file
       path: /var/log/nginx/access.log
       service: '<SERVICE>'
       source: kong
   
     - type: file
       path: /var/log/nginx/error.log
       service: '<SERVICE>'
       source: kong
   

   path 및 service 파라미터 값을 변경하고 환경에 맞춰 설정합니다. 사용 가능한 모든 설정 옵션은 샘플kong.d/conf.yaml을 참조하세요.

3. 에이전트를 재시작합니다.

컨테이너화된 환경

Prometheus 플러그인 활성화를 통해 OpenMetrics 메트릭이 Kong 서비스에 노출되는지 확인합니다. Agent 가 Kong 메트릭을 수집하기 전에 이를 먼저 구성해야 합니다. 컨테이너화된 환경의 경우 아래 파라미터 적용에 대한 지침은 자동탐지 통합 템플릿을 참조하세요.

메트릭 수집

로그 수집

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

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