메인 콘텐츠로 건너뛰기
Elastic Stack는 애플리케이션을 계측하기 위한 두 가지 유형의 언어별 SDK를 제공합니다:
  1. Elastic Official APM agents – 이는 Elastic Stack에서 사용하도록 특별히 제작되었습니다. 현재 이러한 SDK에 대해서는 직접적인 마이그레이션 경로가 없습니다. 이를 사용하는 애플리케이션은 해당하는 ClickStack SDKs를 사용해 다시 계측해야 합니다.
  2. Elastic Distributions of OpenTelemetry (EDOT SDKs) – 이는 표준 OpenTelemetry SDK의 Elastic 배포판이며, .NET, Java, Node.js, PHP, Python에서 사용할 수 있습니다. 애플리케이션이 이미 EDOT SDK를 사용하고 있다면 코드를 다시 계측할 필요가 없습니다. 대신 SDK가 ClickStack에 포함된 OTLP collector로 텔레메트리 데이터를 내보내도록 재구성하면 됩니다. 자세한 내용은 “Migrating EDOT SDKs”를 참조하십시오.
가능하면 ClickStack SDKs를 사용하십시오표준 OpenTelemetry SDK도 지원하지만, 각 언어에서는 ClickStack-distributed SDKs를 사용하는 것을 강력히 권장합니다. 이러한 배포판에는 ClickStack 파이프라인 및 UI와 원활하게 작동하도록 설계된 추가 계측, 향상된 기본 설정, 사용자 지정 확장 기능이 포함되어 있습니다. ClickStack SDKs를 사용하면 기본 OpenTelemetry 또는 EDOT SDK에서는 제공되지 않는 예외 스택 트레이스와 같은 고급 기능을 활용할 수 있습니다.

​
EDOT SDK 마이그레이션

ClickStack의 OpenTelemetry 기반 SDK와 마찬가지로, Elastic Distributions of the OpenTelemetry SDKs(EDOT SDKs)는 공식 OpenTelemetry SDK를 맞춤화한 버전입니다. 예를 들어, EDOT Python SDK는 Elastic Observability와 원활하게 작동하도록 설계된 OpenTelemetry Python SDK의 벤더 맞춤형 배포판입니다. 이 SDK는 표준 OpenTelemetry 라이브러리를 기반으로 하므로 ClickStack으로의 마이그레이션은 간단하며, instrumentation을 다시 설정할 필요가 없습니다. 텔레메트리 데이터를 ClickStack OpenTelemetry Collector로 전송하도록 구성만 조정하면 됩니다. 구성은 표준 OpenTelemetry 방식에 따릅니다. Python에서는 일반적으로 OpenTelemetry Zero-Code Instrumentation 문서에 설명된 것처럼 환경 변수를 통해 이를 설정합니다. 일반적인 EDOT SDK 구성은 다음과 같습니다: 
export OTEL_RESOURCE_ATTRIBUTES=service.name=<app-name>
export OTEL_EXPORTER_OTLP_ENDPOINT=https://my-deployment.ingest.us-west1.gcp.cloud.es.io
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=ApiKey P....l"
ClickStack로 마이그레이션하려면 endpoint가 로컬 OTLP collector를 가리키도록 업데이트하고 Authorization header를 변경하세요: 
export OTEL_RESOURCE_ATTRIBUTES=service.name=<app-name>
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
export OTEL_EXPORTER_OTLP_HEADERS="authorization=<YOUR_INGESTION_API_KEY>"
수집 API key는 HyperDX 애플리케이션에서 생성되며 Team Settings → API Keys에서 확인할 수 있습니다.
마지막 수정일 2026년 6월 10일