ClickStack - 示例日志、链路追踪和指标

以下示例假定你已经按照一体化镜像的使用说明启动了 ClickStack，并已连接到本地 ClickHouse 实例或 ClickHouse Cloud 实例。

ClickHouse Cloud 中的 HyperDX

此示例数据集也可以配合 ClickHouse Cloud 中的 HyperDX 使用，只需对流程进行少量调整，具体如文中所述。如果在 ClickHouse Cloud 中使用 HyperDX，用户需要按照该部署模型的入门指南在本地运行一个 OpenTelemetry 收集器。

导航到 HyperDX UI

本地部署时,访问 http://localhost:8080 即可进入 HyperDX UI。若使用 ClickHouse Cloud 中的 HyperDX,请在左侧菜单中依次选择您的服务和 HyperDX。

复制摄取 API 密钥

ClickHouse Cloud 中的 HyperDX

如果在 ClickHouse Cloud 中使用 HyperDX,则不需要执行此步骤,因为目前不支持摄取密钥。

导航至 Team Settings 并从 API Keys 部分复制 Ingestion API Key。此 API key 可确保通过 OpenTelemetry collector 摄取的数据是安全的。

下载示例数据

为了在 UI 中填充示例数据,请下载以下文件:

示例数据

# curl
curl -O https://storage.googleapis.com/hyperdx/sample.tar.gz
# 或者
# wget https://storage.googleapis.com/hyperdx/sample.tar.gz

此文件包含来自我们公开的 OpenTelemetry demo 的示例日志、指标和追踪数据——这是一个基于微服务架构的简单电商应用。请将此文件复制到您选择的目录中。

加载示例数据

要加载此数据,只需将其发送到已部署的 OpenTelemetry (OTel) 收集器的 HTTP 端点。

首先,导出上文复制的 API 密钥。

ClickHouse Cloud 中的 HyperDX

如果在 ClickHouse Cloud 中使用 HyperDX,则不需要执行此步骤,因为目前不支持摄取密钥。

# 导出 API 密钥
export CLICKSTACK_API_KEY=<YOUR_INGESTION_API_KEY>

运行以下命令将数据发送到 OTel collector：

for filename in $(tar -tf sample.tar.gz); do
  endpoint="http://localhost:4318/v1/${filename%.json}"
  echo "正在加载 ${filename%.json}"
  tar -xOf sample.tar.gz "$filename" | while read -r line; do
    printf '%s\n' "$line" | curl -s -o /dev/null -X POST "$endpoint" \
    -H "Content-Type: application/json" \
    -H "authorization: ${CLICKSTACK_API_KEY}" \
    --data-binary @-
  done
done

这模拟了 OTLP 日志、追踪和指标数据源向 OTel collector 发送数据。在生产环境中,这些数据源可能是语言客户端,甚至是其他 OTel collector。

返回到 Search 视图,您应该会看到数据已开始加载(如果数据未显示,请将时间范围调整为 Last 1 hour):