자동탐지로 엔드포인트 점검

개요

클러스터 점검 기능은 자동탐지가 가능하며 쿠버네티스(Kubernetes) 서비스와 같은 로드 밸런스 클러스터 서비스 점검을 합니다. _엔드포인트 점검_해당 장치를 연장하여 쿠버네티스 서비스로 관리되는 각 엔드포인트를 모니터링합니다.

클러스터 에이전트는 쿠버네티스 서비스의 자동탐지 주석을 기반으로 엔드포인트 점검 설정을 찾습니다. 그 후에 클러스터 에이전트는 이러한 설정을 개별적으로 작동하기 위해 노드 관련 에이전트에게 보냅니다. 엔드포인트 점검은 모니터링되는 쿠버네티스 서비스의 엔드포인트를 지원하는 파드와 같은 노드를 활용하는 에이전트에 보냅니다. 이 디스패칭 로직을 통해 에이전트는 이미 수집된 각각의 파드에 파드 및 컨테이너 태그를 추가할 수 있습니다.

에이전트는 10초마다 클러스터 에이전트와 연결하며 작동할 설정 점검을 검색합니다. 엔드 포인트 점검으로부터 나온 메트릭은 평가된 IP 주소를 기반으로 한 서비스 태그, 쿠버네티스 태그, 호스트 태그 그리고 kube_endpoint_ip 태그와 함께 제출합니다.

버저닝; 이 기능은 Datadog 에이전트 v6.12.0+ 그리고 Datadog 클러스터 에이전트 v1.3.0+ 위한 쿠버네티스를 지원합니다. 클러스터 에이전트 v1.4.0를 먼저 살펴보면, 클러스터 에이전트는 파드를 지원하지 않는 엔드포인드의 모든 엔드포인트 점검을 규칙적인 클러스터 점검으로 바꿉니다. 이 기능을 활용하기 위해 클러스터 점검 기능(엔드포인트 점검 기능 추가 외)을 사용하세요.

참고: 만약 서비스 뒤 파드가 정적이라면, ad.datadoghq.com/endpoints.resolve 주석을 추가해야 합니다. Datadog 클러스터 에이전트는 점검을 엔드포인트 점검으로 예약하고 클러스터 점검 실행자로 보냅니다. 쿠버네티스 API 서버로 주석을 추가하는 예시는 여기에서 참조하세요.

예: 엔드포인트 관련 서비스

아래 예시에서, NGINX용 쿠버네티스 배포는 3개의 파드로 생성되었습니다.

# kubectl get pods --selector app=nginx -o wide
NAME READY STATUS RESTARTS AGE IP NODE
nginx-66d557f4cf-m4c7t 1/1 Running 0 3d 10.0.0.117 gke-cluster-default-pool-4658d5d4-k2sn
nginx-66d557f4cf-smsxv 1/1 Running 0 3d 10.0.1.209 gke-cluster-default-pool-4658d5d4-p39c
nginx-66d557f4cf-x2wzq 1/1 Running 0 3d 10.0.1.210 gke-cluster-default-pool-4658d5d4-p39c

서비스도 만들어졌습니다. 이 세 가지 엔드포인트를 통해 파드에 연결됩니다.

# kubectl get service nginx -o wide
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE SELECTOR
nginx ClusterIP 10.3.253.165 <none> 80/TCP 1h app=nginx

# kubectl get endpoints nginx -o yaml
...
- addresses:
- ip: 10.0.0.117
nodeName: gke-cluster-default-pool-4658d5d4-k2sn
targetRef:
kind: Pod
name: nginx-66d557f4cf-m4c7t
...
- ip: 10.0.1.209
nodeName: gke-cluster-default-pool-4658d5d4-p39c
targetRef:
kind: Pod
name: nginx-66d557f4cf-smsxv
...
- ip: 10.0.1.210
nodeName: gke-cluster-default-pool-4658d5d4-p39c
targetRef:
kind: Pod
name: nginx-66d557f4cf-x2wzq
...

서비스 기반 클러스터 점검이 서비스의 하나의 IP 주소를 테스트하는 동안, 이 서비스와 관련된 각각 세 개의 엔드포인트의 점검이 예약됩니다.

설계상 엔드포인트 점검은 nginx서비스의 엔드포인트를 지원하는 파드와 동일한 노드에서 작동되는 에이전트로 보냅니다. 이 예시에서 에이전트는 gke-cluster-default-pool-4658d5d4-k2sn와 gke-cluster-default-pool-4658d5d4-p39c노드에서 작동되고 nginx 파드에 대해 점검을 합니다.

엔드포인트 점검 디스패칭 설치

kind: DatadogAgent
apiVersion: datadoghq.com/v2alpha1
metadata:
  name: datadog
spec:
  features:
    clusterChecks:
      enabled: true

datadog:
clusterChecks:
enabled: true
# (...)
clusterAgent:
enabled: true
# (...)

DD_EXTRA_CONFIG_PROVIDERS="kube_endpoints"
DD_EXTRA_LISTENERS="kube_endpoints"

DD_EXTRA_CONFIG_PROVIDERS="kube_endpoints kube_services"
DD_EXTRA_LISTENERS="kube_endpoints kube_services"

DD_EXTRA_CONFIG_PROVIDERS="엔드포인드점검 클러스터점검"

설정 점검 설치하기

정적 설정 파일을 이용한 설정

클러스터 에이전트 v1.18.0+에서는 쿠버네티스 엔드포인트를 대상으로 지정하기 위해 점검 설정에서advanced_ad_identifiers와 자동탐지 템플릿 변수를 사용할 수 있습니다(예시 보기).

예: 쿠버네티스 엔드포인트 HTTP 점검

쿠버네티스 서비스의 엔드포인트에 대해 HTTP 점검을 실행하려면,

#(...)
clusterAgent:
confd:
<INTEGRATION_NAME>.yaml: |-
advanced_ad_identifiers:
- kube_endpoints:
name: "<ENDPOINTS_NAME>"
namespace: "<ENDPOINTS_NAMESPACE>"
cluster_check: true
init_config:
instances:
- url: "http://%%host%%"
 name: "<EXAMPLE_NAME>"

advanced_ad_identifiers:
  - kube_endpoints:
     name: "<ENDPOINTS_NAME>"
     namespace: "<ENDPOINTS_NAMESPACE>"
cluster_check: true
init_config:
instances:
 - url: "http://%%host%%"
name: "<EXAMPLE_NAME>"

쿠버네티스 서비스 주석을 이용한 설정

주석을 추가하는 서비스 구문은 쿠버네티스 파드 주석 달기와 유사합니다.

ad.datadoghq.com/endpoints.check_names: '[<INTEGRATION_NAME>]'
ad.datadoghq.com/endpoints.init_configs: '[<INIT_CONFIG>]'
ad.datadoghq.com/endpoints.instances: '[<INSTANCE_CONFIG>]'
ad.datadoghq.com/endpoints.logs: '[<LOGS_CONFIG>]'

이 구문은 각 엔드포인트의 IP로 대체되는 %%host%% 템플릿 변수를 지원합니다. kube_namespace,kube_service 그리고 kube_endpoint_ip 태그가 인스턴스에 자동으로 추가됩니다.

참고: 커스텀 엔드포인트 로그 설정은 쿠버네티스 로그 파일 수집이 아닌 도커(Docker) 소켓 로그 수집 중에만 지원됩니다.

예: 서비스의 엔드포인트 NGINX 점검으로 NGINX 지원 서비스 HTTP 점검

이 서비스는 nginx 배포 파드와 연결됩니다. 이 설정을 기반으로:

• 이 서비스를 지원하는 각 NGINX 파드에 대해 nginx 기반 엔드포인트 점검을 보냅니다. 이 점검은 NGINX 파드와 같은 각 노드의 에이전트에 의해 작동됩니다(파드 IP를 %%host%%로 사용).
• http_check 기반 클러스터 점검은 클러스터의 단일 에이전트로 보냅니다. 이 점검은 서비스의 IP를 %%host%%로 사용하여 각 엔드포인트에 자동으로 로드 밸런스를 맞춥니다.
• 점검은 합쳐진 서비스 태깅 레이블에 해당하는 env:prod, service:my-nginx 그리고version:1.19.0 태그와 함께 보냅니다.

apiVersion: v1
kind: Service
metadata:
name: nginx
labels:
app: nginx
tags.datadoghq.com/env: "prod"
tags.datadoghq.com/service: "my-nginx"
tags.datadoghq.com/version: "1.19.0"
annotations:
ad.datadoghq.com/endpoints.check_names: '["nginx"]'
ad.datadoghq.com/endpoints.init_configs: '[{}]'
ad.datadoghq.com/endpoints.instances: |
[
{
"name": "My Nginx Service Endpoints",
"nginx_status_url": "http://%%host%%:%%port%%/nginx_status"
}
]
ad.datadoghq.com/service.check_names: '["http_check"]'
ad.datadoghq.com/service.init_configs: '[{}]'
ad.datadoghq.com/service.instances: |
[
{
"name": "My Nginx Service",
"url": "http://%%host%%"
}
]
ad.datadoghq.com/endpoints.logs: '[{"source":"nginx","service":"webapp"}]'
spec:
ports:
- port: 80
protocol: TCP
selector:
app: nginx

Additional helpful documentation, links, and articles:

클러스터 에이전트설명서 클러스터 점검설명서 엔드포인트 점검 트러블슈팅설명서