clickstack-otel-collector

SKILL.md

Set up an OpenTelemetry collector for Managed ClickStack

This skill wires an OpenTelemetry collector into a Managed ClickStack service running on
ClickHouse Cloud, sends rich synthetic telemetry through it, and confirms the data is actually
visible in ClickStack. It uses clickhousectl
for all cloud and SQL operations.

Scope. This skill supports two paths, chosen in Step 0:

Deploy a new collector locally. You can do this two ways: individual docker commands,
or a docker compose file (recommended, fewer commands and one file to start/stop). Make the
user aware of both up front and let them pick in Step 0; do not assume plain docker. Either
way runs the ClickStack distribution of the collector, preconfigured for Managed ClickStack.

Configure your own existing collector by adding the ClickHouse exporter configuration.
We give you the exact config to drop in; you reload your collector. Use this if you already
run a collector in a gateway role.

A full Kubernetes deployment (Helm, secrets in K8s Secrets) is out of scope here; the config
we generate in path 2 can be applied to a collector running anywhere.