Agent v5의 쿠버네티스(Kubernetes) Agent 기본 사용법

문서 > 에이전트 > 에이전트 가이드 > Agent v5의 쿠버네티스(Kubernetes) Agent 기본 사용법

Datadog Agent v5는 최대 쿠버네티스 버전 1.8까지 지원합니다. 최신 버전의 쿠버네티스는 Datadog Agent v6를 사용해야 합니다.

개요

쿠버네티스에서 실시간 메트릭을 받아 다음과 같이 활용할 수 있습니다.

쿠버네티스 상태 시각화 및 모니터링
Kubernetes 실패 복구 및 이벤트 알림 확인

쿠버네티스의 경우, Agent를 DaemonSet로 실행하시길 권장합니다. 도커(Docker) 이미지는 활성화된 도커와 쿠버네티스 통합 모두에서 사용할 수 있습니다.

또한, 호스트에서 Datadog Agent를 실행하고 설정하여 쿠버네티스 메트릭을 수집할 수 있습니다.

Kubernetes 설정

설치

컨테이너 설치

쿠버네티스 덕분에 Datadog Agent를 모든 노드에 자동 배포하는 DaemonSets의 장점을 활용할 수 있습니다(또는 nodeSelectors를 사용해 특정 노드에만 배포할 수도 있습니다).

쿠버네티스 클러스터에서 DaemonSets 옵션을 지원하지 않는다면 각 쿠버네티스 노드의 배포 콘텐츠로서 Datadog Agent를 설치하세요.

쿠버네티스에서 RBAC를 사용한다면 Datadog-쿠버네티스 통합에서 RBAC 권한을 설정하는 방법을 알아보세요.

다음의 dd-agent.yaml 매니페스트(Manifest)를 생성합니다.


apiVersion: extensions/v1beta1
metadata:
  name: dd-agent
spec:
  template:
    metadata:
      labels:
        app: dd-agent
      name: dd-agent
    spec:
      containers:
      - image: gcr.io/datadoghq/docker-dd-agent:latest
        imagePullPolicy: Always
        name: dd-agent
        ports:
          - containerPort: 8125
            name: dogstatsdport
            protocol: UDP
        env:
          - name: API_KEY
            value: "DATADOG_API_KEY"
          - name: KUBERNETES
            value: "yes"
        volumeMounts:
          - name: dockersocket
            mountPath: /var/run/docker.sock
          - name: procdir
            mountPath: /host/proc
            readOnly: true
          - name: cgroups
            mountPath: /host/sys/fs/cgroup
            readOnly: true
      volumes:
        - hostPath:
            path: /var/run/docker.sock
          name: dockersocket
        - hostPath:
            path: /proc
          name: procdir
        - hostPath:
            path: /sys/fs/cgroup
          name: cgroups

DATADOG_API_KEY를 API 키로 대체하거나 쿠버네티스 시크릿을 사용해 API 키를 환경 변수로 설정합니다.

명령어로 DaemonSet을 배포합니다.
```
kubectl create -f dd-agent.yaml
```

참조: 매니페스트는 자동탐지, 자동 설정 기능을 활성화합니다. 이를 비활성화하려면 SD_BACKEND 환경 변수 정의를 제거하세요. 자동탐지를 설정하는 방법은 자동탐지 가이드를 참조하시기 바랍니다.

호스트 설치

dd-check-kubernetes 패키지를 수동 설치하거나 즐겨 사용하는 설정 관리자로 설치하세요.

설정

kubernetes.yaml 파일을 편집해 서버나 포트를 지정하고, 모니터링할 마스터를 설정하세요.


instances:
    host: localhost
    port: 4194
    method: http

사용할 수 있는 모든 설정 옵션의 목록은 샘플 kubernetes.yaml에서 확인할 수 있습니다

검증

컨테이너 실행

환경에서 DaemonSet으로 실행 중인 Datadog Agent를 확인하려면 다음을 실행하세요.

kubectl get daemonset

Agent가 배포되었다면 아래 텍스트와 비슷한 출력값이 표시됩니다. 여기서 desired 및 current는 클러스터에서 실행 중인 노드 개수와 동일합니다.

NAME       DESIRED   CURRENT   NODE-SELECTOR   AGE
dd-agent   3         3         <none>          11h

Agent 점검 실행

Agent의 info 하위 명령어를 실행하고 점검(Checks) 섹션의 kubernetes를 찾습니다.

Checks
======
    kubernetes
    -----------
      - instance #0 [OK]
      - Collected 39 metrics, 0 events & 7 service checks

쿠버네티스 상태 설정

설치

컨테이너 설치

버전 1.2.0 이상의 쿠버네티스를 실행 중이라면 kube-state-metrics 프로젝트를 사용해 추가 메트릭을 Datadog로 보낼 수 있습니다(아래 메트릭 목록에서 kubernetes_state 접두어로 알아볼 수 있습니다).

kube-state-metrics를 실행하려면 kube-state-metrics 서비스를 배포하는 다음의 매니페스트를 사용해 kube-state-metrics.yaml 파일을 생성하세요.

apiVersion: extensions/v1beta1
metadata:
  name: kube-state-metrics
spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: kube-state-metrics
    spec:
      containers:
      - name: kube-state-metrics
        image: gcr.io/google_containers/kube-state-metrics:v1.2.0
        ports:
        - name: metrics
          containerPort: 8080
        resources:
          requests:
            memory: 30Mi
            cpu: 100m
          limits:
            memory: 50Mi
            cpu: 200m
---
apiVersion: v1
metadata:
  annotations:
    prometheus.io/scrape: 'true'
  labels:
    app: kube-state-metrics
  name: kube-state-metrics
spec:
  ports:
  - name: metrics
    port: 8080
    targetPort: metrics
    protocol: TCP
  selector:
    app: kube-state-metrics

이제 다음을 실행해 배포하세요.

kubectl create -f kube-state-metrics.yaml

위의 매니페스트는 Google에서 공개한 kube-state-metrics 컨테이너를 사용합니다. 이는 Quay에서도 사용할 수 있습니다. 직접 구축하고자 하시는 분은 공식 프로젝트 설명서를 참조하세요.

쿠버네티스 상태 메트릭(Kubernetes State Metrics) 서비스를 다른 URL이나 포트에서 실행하기로 설정한 경우, conf.d/kubernetes_state.yaml의 kube_state_url 파라미터를 설정한 다음 Agent를 재부팅하여 Datadog Agent를 구성할 수 있습니다. 더 자세한 정보가 필요하신 분은 kubernetes_state.yaml.example 파일을 참조하세요. 자동탐지를 사용하신다면 kube state URL이 자동으로 설정되어 관리됩니다.

호스트 설치

dd-check-kubernetes_state 패키지를 수동으로, 또는 즐겨 사용하는 설정 관리자로 설치하세요(CentOS/AWS에서는 rpm 패키지를 다운로드하고 설치 가이드를 참조하세요). 다음으로 kubernetes_state.yaml 파일을 수정해 서버와 포트를 지정하고, 모니터링할 마스터를 설정합니다. 사용할 수 있는 모든 설정 옵션의 목록은 샘플 kubernetes_state.yaml에서 확인할 수 있습니다.

검증

컨테이너 검증

환경에서 DaemonSet으로 실행 중인 Datadog Agent를 확인하려면 다음을 실행하세요.

kubectl get daemonset

Agent가 배포되면 아래 텍스트와 유사한 출력이 표시됩니다. 여기서 desired 및 current는 클러스터에서 실행 중인 노드 수와 같습니다.

NAME       DESIRED   CURRENT   NODE-SELECTOR   AGE
dd-agent   3         3         <none>          11h

Agent 점검 검증

Agent의 info 하위 명령어를 실행하고 점검(Checks) 섹션의 kubernetes_state를 찾습니다.

Checks
======
    kubernetes_state
    -----------
      - instance #0 [OK]
      - Collected 39 metrics, 0 events & 7 service checks

쿠버네티스 DNS 설정

설치

dd-check-kube_dns 패키지를 수동 설치하거나 즐겨 사용하는 설정 관리자로 설치하세요.

설정

다음으로 kube_dns.yaml 파일을 수정해 서버와 포트를 지정하고, 모니터링할 마스터를 설정합니다. 사용할 수 있는 모든 설정 옵션의 목록은 샘플 kube_dns.yaml 에서 확인할 수 있습니다.

서비스 탐지 사용

쿠버네티스 워커 노드마다 하나의 dd-agent 팟을 사용하는 경우, kube-dns 팟에서 다음의 어노테이션을 사용해 데이터를 자동으로 수집할 수 있습니다.


apiVersion: v1
metadata:
  annotations:
    service-discovery.datadoghq.com/kubedns.check_names: '["kube_dns"]'
    service-discovery.datadoghq.com/kubedns.init_configs: '[{}]'
    service-discovery.datadoghq.com/kubedns.instances: '[[{"prometheus_endpoint":"http://%%host%%:10055/metrics", "tags":["dns-pod:%%host%%"]}]]'

참조:

“dns-pod” 태그가 타겟 DNS 팟 IP를 추적한다는 점에 유의하시기 바랍니다. 다른 태그는 서비스 탐지를 사용해 정보를 폴링(polling)하는 dd-agent와 연관됩니다.
서비스 탐지 어노테이션은 팟에 적용해야 합니다. 배포 시에는 어노테이션을 템플릿 스펙의 메타데이터에 추가하세요.

검증

Agent의 info 하위 명령어를 실행하고 점검(Checks) 섹션의 kube_dns를 찾습니다.

Checks
======
    kube_dns
    -----------
      - instance #0 [OK]
      - Collected 39 metrics, 0 events & 7 service checks