ClickStack - 示例日志、跟踪和指标

以下示例假设您已按照一体化镜像的说明启动 ClickStack，并连接到本地 ClickHouse 实例或 ClickHouse Cloud 实例。

HyperDX 在 ClickHouse Cloud

此示例数据集也可以与 ClickHouse Cloud 中的 HyperDX 一起使用，仅需对流程进行稍微调整。如使用 ClickHouse Cloud 中的 HyperDX，用户需要本地运行 Open Telemetry 收集器，如此部署模型的入门指南中所述。

导航至 HyperDX UI

如果在本地部署，请访问 http://localhost:8080 以访问 HyperDX UI。如果在 ClickHouse Cloud 中使用 HyperDX，请从左侧菜单中选择您的服务和 HyperDX。

复制摄取 API 密钥

HyperDX 在 ClickHouse Cloud

如果在 ClickHouse Cloud 中使用 HyperDX，此步骤并不是必需的，因为目前不支持摄取密钥。

导航至 Team Settings，从 API Keys 部分复制 Ingestion API Key。此 API 密钥确保通过 OpenTelemetry 收集器的数据摄取是安全的。

下载示例数据

为了用示例数据填充 UI，请下载以下文件：

示例数据


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

# or

# wget https://storage.googleapis.com/hyperdx/sample.tar.gz

此文件包含我们的公共 OpenTelemetry 演示中的示例日志、指标和跟踪 - 一个简单的微服务电子商务商店。将此文件复制到您选择的目录中。

加载示例数据

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

首先，导出上面复制的 API 密钥。

HyperDX 在 ClickHouse Cloud

如果在 ClickHouse Cloud 中使用 HyperDX，此步骤并不是必需的，因为目前不支持摄取密钥。


# export API key
export CLICKSTACK_API_KEY=<YOUR_INGESTION_API_KEY>

运行以下命令将数据发送至 OTel 收集器：

for filename in $(tar -tf sample.tar.gz); do
  endpoint="http://localhost:4318/v1/${filename%.json}"
  echo "loading ${filename%.json}"
  tar -xOf sample.tar.gz "$filename" | while read -r line; do
    echo "$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 收集器发送数据。在生产环境中，这些源可以是语言客户端，甚至是其他 OTel 收集器。

返回到 Search 视图，您应该看到数据已开始加载（如果数据未呈现，请将时间范围调整为 Last 1 hour）：