Skip to main content
otelgen is a small Go CLI that generates synthetic OTLP logs, traces and metrics. Use it to confirm that an existing ClickStack OpenTelemetry collector is accepting data and that events surface in the ClickStack UI. This guide assumes the collector is already running with OTLP endpoints on 4317 (gRPC) and 4318 (HTTP).
1

Prerequisites

This guide assumes you have started Open Source ClickStack using the instructions for the all-in-one image, and that the OTLP endpoints (4317 gRPC and 4318 HTTP) are reachable. You also need the ingestion API key from the ClickStack UI under Team Settings > API Keys.
2

Install otelgen

Install with Homebrew:
Or install with Go:
3

Set environment variables

Export the collector endpoint and the ingestion API key:
4

Generate traces

Send a short burst of multi-span traces:
--rate is traces per second and --duration is the run length in seconds. --insecure enables plaintext gRPC against the local collector.
5

Generate logs

6

Generate metrics

The metrics subcommands don’t honor --duration. Run the command and press Ctrl+C after a few seconds to stop it.
otelgen also supports gauge, histogram, up-down-counter and exponential-histogram subcommands under metrics.
7

Verify in ClickStack

Visit http://localhost:8080 to open the ClickStack UI. In the Search view, switch the source between Logs and Traces to confirm new events. Set the time range to Last 15 minutes. Open the Chart Explorer, select Metrics, and chart one of the metric names produced by otelgen (for example otelgen.metrics.sum) to verify metrics ingestion.