메인 콘텐츠로 건너뛰기
이 가이드는 다음을 통합합니다:
✖️ 로그✖️ ️️메트릭✅ 트레이스
로그를 ClickStack으로 보내려면 OpenTelemetry collector를 통해 전송하십시오.

시작하기

OpenTelemetry 패키지 설치

다음 명령으로 OpenTelemetry 패키지를 설치하십시오.

OpenTelemetry + 로거 포매터 구성

다음으로, OpenTelemetry tracing instrumentation을 초기화하고 Rails 로거의 로그 메시지 포매터를 구성해야 로그가 자동으로 트레이스와 연결되도록 할 수 있습니다. 사용자 지정 포매터가 없으면 로그와 트레이스는 ClickStack에서 자동으로 연관되지 않습니다. config/initializers 폴더에서 hyperdx.rb라는 파일을 생성하고 다음을 추가하십시오:

환경 변수 설정

이제 OpenTelemetry collector를 통해 telemetry를 ClickStack으로 전송할 수 있도록 셸에서 다음 환경 변수를 설정해야 합니다:
OTEL_SERVICE_NAME 환경 변수는 HyperDX 앱에서 서비스를 식별하는 데 사용되며, 원하는 이름으로 자유롭게 지정할 수 있습니다. OTEL_EXPORTER_OTLP_HEADERS 환경 변수에는 HyperDX 앱의 Team Settings → API Keys에서 확인할 수 있는 API Key가 포함됩니다.
마지막 수정일 2026년 6월 10일