ClickStack OpenTelemetry collector 설치
Managed ClickStack로 데이터를 보내려면 gateway 역할로 OTel collector를 배포해야 합니다. OpenTelemetry와 호환되는 계측은 HTTP 또는 gRPC를 통한 OTLP로 이 collector에 이벤트를 전송합니다.ClickStack OpenTelemetry collector 사용을 권장합니다이렇게 하면 표준화된 수집, 강제 적용되는 스키마(schema), 그리고 ClickStack UI(HyperDX)와 즉시 호환되는 이점을 누릴 수 있습니다. 기본 스키마를 사용하면 소스를 자동으로 감지하고 컬럼 매핑도 미리 구성할 수 있습니다.
collector로 데이터 보내기
Managed ClickStack로 데이터를 보내려면 OpenTelemetry Collector가 제공하는 다음 엔드포인트로 OpenTelemetry 계측을 지정하십시오.
- HTTP (OTLP):
http://localhost:4318
- gRPC (OTLP):
localhost:4317
OpenTelemetry를 지원하는 language SDKs 및 telemetry 라이브러리의 경우 애플리케이션에서 OTEL_EXPORTER_OTLP_ENDPOINT 환경 변수를 설정하면 됩니다:OTel collector의 contrib 배포판을 agent 역할로 배포하는 경우, OTLP exporter를 사용해 ClickStack collector로 전송할 수 있습니다. 이 구조화된 로그 파일을 수집하는 agent 구성 예시는 아래와 같습니다.ClickStack OpenTelemetry collector는 다음을 포함한 대부분의 ClickStack 배포판에 포함되어 있습니다.ClickStack OpenTelemetry collector 설치
ClickStack OTel collector는 스택의 다른 구성 요소와 별도로 독립 실행형으로 배포할 수도 있습니다.HyperDX-only 배포판을 사용하는 경우, 데이터를 ClickHouse로 직접 전달하는 것은 사용자 책임입니다. 다음과 같은 방법으로 수행할 수 있습니다.ClickStack OpenTelemetry collector 사용을 권장합니다이를 통해 표준화된 수집, 강제 적용되는 스키마, 그리고 HyperDX UI와의 기본 호환성의 이점을 누릴 수 있습니다. 기본 스키마를 사용하면 source 자동 감지와 사전 구성된 컬럼 매핑을 활용할 수 있습니다.
collector로 데이터 전송
ClickStack으로 데이터를 전송하려면 OpenTelemetry 계측이 OpenTelemetry collector에서 제공하는 다음 엔드포인트를 가리키도록 설정하십시오.
- HTTP (OTLP):
http://localhost:4318
- gRPC (OTLP):
localhost:4317
OpenTelemetry를 지원하는 language SDKs 및 텔레메트리 라이브러리의 경우, 애플리케이션에서 OTEL_EXPORTER_OTLP_ENDPOINT 환경 변수를 설정하기만 하면 됩니다:또한 API 수집 키가 포함된 인증 헤더가 필요합니다. 해당 키는 HyperDX 앱의 Team Settings → API Keys에서 확인할 수 있습니다.언어 SDK의 경우, 이후 init 함수에서 설정하거나 OTEL_EXPORTER_OTLP_HEADERS 환경 변수를 통해 설정할 수 있습니다. 예:에이전트도 마찬가지로 모든 OTLP 통신에 이 authorization 헤더를 포함해야 합니다. 예를 들어, 에이전트 역할로 OTel collector의 contrib 배포판을 배포하는 경우 OTLP exporter를 사용할 수 있습니다. 이 구조화된 로그 파일을 수집하는 예시 에이전트 구성은 아래와 같습니다. authorization 키를 지정해야 하며, <YOUR_API_INGESTION_KEY>를 참조하십시오. 
