개요

레드햇(Red Hat) OpenShift는 엔터프라이즈 애플리케이션 개발 및 배포를 위한 쿠버네티스(Kubernetes) 컨테이너 오케스트레이터에 기반한 오픈 소스 컨테이너 애플리케이션 플랫폼입니다.

본 README에서는 에이전트에서 OpenShift 전용 메트릭 수집을 활성화하는 데 필요한 설정을 설명합니다. 여기에 설명된 데이터는 kubernetes_apiserver 점검이 수집합니다. 해당 점검을 설정하여 openshift.* 메트릭을 수집합니다.

설정

설치

본 코어는 OpenShift 3.11 및 OpenShift 4 모두 지원하나 OpenShift 4에서 가장 잘 작동합니다.

에이전트를 설치하려면, 일반 쿠버네티스(Kubernetes) 지침은 에이전트 설치 지침을, OpenShift 설정 예제는 쿠버네티스(Kubernetes) 배포 페이지를 참조하세요.

또는 Datadog 오퍼레이터를 사용하여 Datadog 에이전트를 설치 및 관리할 수 있습니다. Datadog 오퍼레이터는 OpenShift OperatorHub로 설치할 수 있습니다.

보안 컨텍스트 제약 조건 설정

위의 설치 지침에 링크된 방법 중 하나로 Datadog 에이전트를 배포하는 경우, 데이터를 수집하려면 에이전트 및 클러스터 에이전트에 대한 보안 컨텍스트 제약 조건(SCC)을 포함해야 합니다. 배포와 관련된 하단 지침을 따르세요.

datadog:
  #(...)

agents:
  podSecurity:
    securityContextConstraints:
      create: true

clusterAgent:
  podSecurity:
    securityContextConstraints:
      create: true

ports:
  - containerPort: 8125
    name: dogstatsdport
    protocol: UDP
  - containerPort: 8126
    name: traceport
    protocol: TCP

모든 기능을 위한 커스텀 Datadog

기본적으로 Helm 차트와 Datadog 오퍼레이터가 SCC를 관리합니다. 대신 직접 관리하려면 활성화한 기능에 따른 올바른 설정을 포함해야 합니다.

SELinux가 허용 모드이거나 비활성화되어 있는 경우, 모든 기능을 활용하려면 hostaccess SCC를 활성화하세요. SELinux가 강제 모드인 경우, Datadog 에이전트 포드에 spc_t 유형을 부여할 것을 권장합니다. 에이전트를 배포하기 위해서 Datadog 에이전트 서비스 계정 생성 후에 적용할 수 있는 다음 Datadog 에이전트 SCC를 사용할 수 있습니다. 이는 다음 권한을 부여합니다.

• allowHostPorts: true: DogStatsD / 애플리케이션 성능 모니터링(APM) / 로그 수집을 노드 IP에 바인딩합니다.
• allowHostPID: true: Unix 소켓이 제출한 DogStatsD 메트릭에 대한 출처 감지를 활성화합니다.
• volumes: hostPath: 도커(Docker) 소켓과 호스트 proc 및 cgroup 폴더에 액세스하여 메트릭을 수집합니다.
• SELinux type: spc_t: 도커(Docker) 소켓과 모든 프로세스의 proc 및 cgroup 폴더에 액세스하여 메트릭을 수집합니다. 자세한 내용은 최고 권한 컨테이너 개념 도입을 참조하세요.

참고: 도커(Docker) 소켓은 루트 그룹이 소유하므로, 도커(Docker) 메트릭을 가져오려면 에이전트의 권한을 상향시켜야 할 수도 있습니다. 루트 사용자로 에이전트 프로세스를 실행하려면 다음을 사용하여 SCC를 설정합니다.

runAsUser:
  type: RunAsAny

로그 수집

Datadog 에이전트의 로그 수집은 OpenShift에서 다른 쿠버네티스(Kubernetes) 클러스터와 거의 동일하게 설정됩니다. Datadog 오퍼레이터와 Helm 차트는 /var/log/pods 디렉토리에 마운트되며, Datadog 에이전트 포드는 각 호스트에 있는 포드와 컨테이너의 로그를 모니터링하는 데 사용합니다. 그러나 Datadog 오퍼레이터를 사용하려면 추가 SELinux 옵션을 적용하여 에이전트가 해당 로그 파일을 읽을 수 있는 권한을 부여해야 합니다.

자세한 기본 정보는 쿠버네티스(Kubernetes) 로그 수집을, 설정 예시는 배포 페이지를 참조하세요.

APM

쿠버네티스(Kubernetes)에는 애플리케이션 포드에서 Datadog 에이전트 포드로 데이터를 라우팅하는 세 가지 중요 옵션이 있습니다. Unix 도메인 소켓(UDS), HostIP:HostPort 옵션(TCP/IP), 쿠버네티스(Kubernetes) 서비스입니다. Datadog 오퍼레이터와 Helm 차트는 리소스 효율이 가장 높기 때문에, 기본적으로 UDS 옵션을 사용합니다. 그러나 에이전트 포드와 애플리케이션 포드 모두에서 권한 승격된 SCC 및 SELinux 옵션이 필요하기 때문에 해당 옵션은 OpenShift에서는 제대로 동작하지 않습니다.

Datadog은 이를 방지하기 위해 UDS 옵션을 명시적 비활성화할 것을 권장합니다. 이를 통해 어드미션 컨트롤러가 해당 설정을 삽입하는 것을 방지할 수 있습니다.

자세한 기본 정보는 쿠버네티스(Kubernetes) 애플리케이션 성능 모니터링(APM) - 트레이스 수집을, 설정 예시는 배포 페이지를 참조하세요.

검증

kubernetes_apiserver 참조

수집한 데이터

메트릭

이벤트

OpenShift 점검은 이벤트를 포함하지 않습니다.

서비스 점검

OpenShift 점검은 서비스 점검을 포함하지 않습니다.

트러블슈팅

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