메인 콘텐츠로 건너뛰기
ClickStack은 텔레메트리 데이터(로그 및 트레이스) 수집에 OpenTelemetry 표준을 사용합니다. 트레이스는 자동 인스트루먼테이션으로 생성되므로, 트레이싱을 활용하기 위해 수동 인스트루먼테이션을 할 필요는 없습니다. 이 가이드에서 통합하는 항목:
✅ 로그✅ 메트릭✅ 트레이스

시작하기

OpenTelemetry instrumentation 패키지 설치

OpenTelemetry 및 HyperDX Go 패키지를 설치하려면 아래 명령을 사용하세요. 추적 정보가 올바르게 추가되도록 현재 제공되는 instrumentation 패키지를 확인하고 필요한 패키지를 설치하는 것이 좋습니다.

네이티브 HTTP server 예시 (net/http)

이 예시에서는 net/http/otelhttp를 사용하겠습니다.
주석이 포함된 섹션을 참고하여 Go 애플리케이션에 계측을 추가하는 방법을 알아보십시오.

Gin 애플리케이션 예시

이 예시에서는 gin-gonic/gin을 사용하겠습니다.
주석이 있는 섹션을 참고하여 Go 애플리케이션에 계측을 적용하는 방법을 알아보십시오.

환경 변수 설정

그런 다음 셸에서 다음 환경 변수를 설정하여 OpenTelemetry collector를 통해 텔레메트리를 ClickStack으로 전송하십시오:
OTEL_EXPORTER_OTLP_HEADERS 환경 변수에는 HyperDX 앱의 Team Settings → API Keys에서 확인할 수 있는 API Key가 포함됩니다.
마지막 수정일 2026년 7월 2일