메인 콘텐츠로 건너뛰기
ClickStack는 OpenTelemetry(OTel) collector를 사용하여 Kubernetes 클러스터에서 로그, 메트릭, Kubernetes 이벤트를 수집한 뒤 ClickStack로 전달합니다. 네이티브 OTel 로그 포맷을 지원하므로 추가적인 벤더별 구성은 필요하지 않습니다. 이 가이드에서는 다음 항목을 통합합니다:
  • 로그
  • 인프라 메트릭
애플리케이션 수준의 메트릭 또는 APM/트레이스를 전송하려면 애플리케이션에도 해당 언어 통합을 추가해야 합니다.
이 가이드는 게이트웨이로 ClickStack OTel collector를 배포하고 수집 API key로 보호되었다고 가정합니다.

OTel Helm 차트 구성 파일 만들기

각 노드와 클러스터 자체에서 로그와 메트릭을 모두 수집하려면 별도의 OpenTelemetry collector 2개를 배포해야 합니다. 하나는 각 노드의 로그와 메트릭을 수집하기 위해 데몬셋으로 배포하고, 다른 하나는 클러스터 자체의 로그와 메트릭을 수집하기 위해 배포로 배포합니다.

API Key 시크릿 생성

HyperDX의 수집 API Key를 사용해 새로운 Kubernetes 시크릿을 생성합니다. 이 시크릿은 아래에서 설치할 구성 요소가 ClickStack OTel collector로 데이터를 안전하게 수집하는 데 사용됩니다:
또한 ClickStack OTel collector의 위치를 지정하는 ConfigMap을 생성합니다:

데몬셋 구성 만들기

데몬셋은 클러스터의 각 노드에서 로그와 메트릭을 수집하지만 Kubernetes 이벤트나 클러스터 전반의 메트릭은 수집하지 않습니다. 데몬셋 매니페스트를 다운로드하세요:

배포 구성 만들기

Kubernetes 이벤트와 클러스터 전반의 메트릭을 수집하려면 별도의 OpenTelemetry collector를 배포 형태로 배포해야 합니다. 배포 매니페스트를 다운로드하세요:

OpenTelemetry collector 배포

이제 OpenTelemetry Helm 차트를 사용해 Kubernetes 클러스터에 OpenTelemetry collector를 배포할 수 있습니다. OpenTelemetry Helm 리포지토리를 추가하세요:
위 구성을 사용해 차트를 설치합니다:
copy
이제 Kubernetes 클러스터의 메트릭, 로그, Kubernetes 이벤트가 HyperDX에 표시되어야 합니다.

리소스 태그를 파드로 전달하기 (권장)

애플리케이션 수준의 로그, 메트릭, 트레이스를 Kubernetes 메타데이터와 (예: 파드 이름, 네임스페이스 등) 연관시키려면 OTEL_RESOURCE_ATTRIBUTES 환경 변수를 사용해 Kubernetes 메타데이터를 애플리케이션으로 전달해야 합니다. 다음은 환경 변수를 사용해 Kubernetes 메타데이터를 애플리케이션으로 전달하는 배포 예시입니다:
마지막 수정일 2026년 7월 2일