otelgen으로 합성 OpenTelemetry 데이터 생성

otelgen은 합성 OTLP 로그, 트레이스, 메트릭을 생성하는 간단한 Go CLI입니다. 이를 사용해 기존 ClickStack OpenTelemetry collector가 데이터를 수신하는지, 그리고 이벤트가 ClickStack UI에 표시되는지 확인할 수 있습니다. 이 가이드에서는 collector가 이미 실행 중이며 4317(gRPC) 및 4318(HTTP)에서 OTLP 엔드포인트를 제공한다고 가정합니다.

관리형 ClickStack
ClickStack Open Source

사전 요구 사항

이 가이드는 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입니다.

보호되지 않은 collectorClickStack OpenTelemetry collector는 기본적으로 인증되지 않습니다. OTLP_AUTH_TOKEN을 설정하기 위해 collector 보호를 수행하지 않았다면, 여기서는 OTLP_AUTH_TOKEN을 생략하고 아래 명령에서 --header 플래그를 제거하십시오.

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로 표시하여 메트릭 수집을 확인합니다.

사전 요구 사항

이 가이드는 all-in-one image용 안내에 따라 Open Source ClickStack을 시작했으며, OTLP 엔드포인트(4317 gRPC 및 4318 HTTP)에 연결할 수 있다고 가정합니다. 또한 HyperDX UI의 Team Settings > API Keys에서 수집 API key를 확인해야 합니다.

otelgen 설치

Homebrew로 설치합니다:

brew install krzko/tap/otelgen

또는 Go로 설치합니다:

go install github.com/krzko/otelgen@latest

환경 변수 설정

collector 엔드포인트와 수집 API key를 export합니다:

export OTEL_ENDPOINT=localhost:4317
export CLICKSTACK_API_KEY=<your_ingestion_api_key>

traces 생성

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

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

--rate는 초당 trace 수이고, --duration은 실행 시간(초)입니다. --insecure는 로컬 collector에 대해 plaintext gRPC를 사용하도록 설정합니다.

logs 생성

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

메트릭 생성

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

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

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

ClickStack에서 확인

ClickStack UI를 열려면 http://localhost:8080에 접속하십시오. 검색 보기에서 source를 Logs와 Traces로 전환하며 새 이벤트가 들어왔는지 확인합니다. time range를 Last 15 minutes로 설정합니다. Chart Explorer를 열고 Metrics를 선택한 다음, otelgen이 생성한 메트릭 이름 중 하나(예: otelgen.metrics.sum)를 chart로 표시하여 메트릭 수집을 확인합니다.