Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

otelgen으로 합성 OpenTelemetry 데이터 생성

View as MarkdownEdit this pageReport an issueSet up docs MCP

otelgen은 합성 OTLP 로그, 트레이스, 메트릭을 생성하는 간단한 Go CLI입니다. 이를 사용해 기존 ClickStack OpenTelemetry collector가 데이터를 수신하는지, 그리고 이벤트가 ClickStack UI에 표시되는지 확인할 수 있습니다.

이 가이드에서는 collector가 이미 실행 중이며 4317(gRPC) 및 4318(HTTP)에서 OTLP 엔드포인트를 제공한다고 가정합니다.

사전 요구 사항

이 가이드는 Managed ClickStack 시작하기 가이드를 완료했으며, otelgen을 실행하는 머신에서 OTLP gRPC (4317) 및 HTTP (4318) 엔드포인트에 연결할 수 있는 OpenTelemetry collector가 실행 중이라고 가정합니다. collector를 보호하기 위해 OTLP_AUTH_TOKEN을 설정했다면, 해당 값을 준비해 두십시오.

otelgen 설치

Homebrew로 설치합니다:

brew install krzko/tap/otelgen

또는 Go로 설치합니다:

go install github.com/krzko/otelgen@latest

환경 변수 설정

collector 엔드포인트와, collector가 보호되어 있다면 인증 토큰을 export합니다:

export OTEL_ENDPOINT=<host>:4317
export OTLP_AUTH_TOKEN=<your_otlp_auth_token>

collector의 호스트와 포트를 사용하십시오. collector가 동일한 머신에서 실행 중이라면 localhost:4317입니다.

trace 생성

여러 스팬으로 구성된 trace를 짧게 전송합니다:

otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \
  --header "authorization=${OTLP_AUTH_TOKEN}" \
  --protocol grpc --insecure \
  --rate 2 --duration 10 \
  traces multi

--rate는 초당 trace 수이고 --duration은 초 단위 실행 시간입니다. --insecure는 gRPC 연결에서 TLS를 비활성화하며, otelgen을 collector의 plaintext OTLP 포트로 전송할 때 필요합니다.

로그 생성

otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \
  --header "authorization=${OTLP_AUTH_TOKEN}" \
  --protocol grpc --insecure \
  --rate 2 --duration 10 \
  logs multi

메트릭 생성

metrics 하위 명령은 --duration을 적용하지 않습니다. 명령을 실행한 뒤 몇 초 후 Ctrl+C를 눌러 중지하십시오.

otelgen --otel-exporter-otlp-endpoint ${OTEL_ENDPOINT} \
  --header "authorization=${OTLP_AUTH_TOKEN}" \
  --protocol grpc --insecure \
  --rate 2 \
  metrics sum

otelgen은 metrics 아래에서 gauge, histogram, up-down-counter, exponential-histogram 하위 명령도 지원합니다.

ClickStack에서 확인

ClickHouse Cloud 콘솔에서 ClickStack UI를 여십시오. Search 보기에서 source를 Logs와 Traces 사이에서 전환하여 새 이벤트를 확인합니다. 시간 범위를 Last 15 minutes로 설정합니다. Chart Explorer를 열고 Metrics를 선택한 다음, otelgen이 생성한 메트릭 이름 중 하나(예: otelgen.metrics.sum)를 chart로 표시하여 메트릭 수집을 확인합니다.

Navigation