用途：将 OpenTelemetry collector 接入 ClickHouse Cloud 上的 Managed ClickStack 服务，把日志、链路和指标写入服务的 otel 数据库，并在 ClickStack 中确认数据可见。所有云与 SQL 操作通过 clickhousectl 完成。
主要能力：支持两条路径。路径一在本地部署新的 ClickStack 发行版 collector，可用单独 docker 命令或 docker compose 文件（推荐）。路径二为已有 gateway 角色的 collector 添加 ClickHouse exporter 配置。最终会创建专用 hyperdx_ingest SQL 用户并授予所需权限（首次写入时创建 otel.* schema），生成跨多个服务、严重级别、span 状态和指标类型的合成遥测数据，并引导用户在 Cloud 控制台完成 ClickStack 入门。
使用方式：先选择路径与部署模式；批量允许 openssl、clickhousectl、jq、docker、curl 等命令前缀；创建 0600 权限的 collector.env，密钥本地生成且不打印；用 clickhousectl cloud auth login --api-key 完成 API key 认证（OAuth 只读，无法创建用户或执行写查询）；解析服务并确认状态为 running；创建用户时本地计算 SHA-256 哈希，避免明文密码进入 SQL 或错误回显。
限制：完整的 Kubernetes 部署（Helm、K8s Secrets）不在范围内。密码需满足 ClickHouse Cloud 的大小写与特殊字符要求，且不能含 @、:、/、?、#、% 等会破坏连接 URL 的字符。env 文件使用无引号的 KEY=VALUE。部分沙箱会把 curl | sh 安装和 CREATE USER/GRANT 标记为需显式批准。资料未提供具体价格、平台支持范围或效果保证。