Text-to-Chart

ClickStack 的 Text-to-Chart 功能可让你通过用自然语言描述想查看的内容来创建可视化。你无需手动选择指标、过滤器和分组字段，只需输入类似“过去 24 小时内按服务划分的错误率”这样的提示词，ClickStack 就会自动生成相应的图表。

该功能使用大语言模型 (LLM) 将文本提示词转换为查询，然后在 Chart Explorer 中生成可视化。它适用于任何已配置的数据源。

前置条件

Text-to-Chart 需要一个 Anthropic API 密钥。启动 ClickStack 时，请设置 ANTHROPIC_API_KEY 环境变量。

对于开源部署，请将该密钥作为环境变量传入。具体方式因部署类型而异：

docker run -e ANTHROPIC_API_KEY='<YOUR_KEY>' -p 8080:8080 -p 4317:4317 -p 4318:4318 clickhouse/clickstack-all-in-one:latest

docker run -e ANTHROPIC_API_KEY='<YOUR_KEY>' -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx-local

将该变量添加到 .env 文件中，或直接在 docker-compose.yaml 中设置：

services:
  app:
    environment:
      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY}

使用 --set 传入该密钥：

helm install my-hyperdx hyperdx/hdx-oss-v2 \
  --set env[0].name=ANTHROPIC_API_KEY \
  --set env[0].value=<YOUR_KEY>

前往Chart Explorer

在 HyperDX 中，从左侧菜单选择 Chart Explorer。

选择数据源

选择要可视化的数据源，例如日志、链路追踪 或指标。

输入文本提示词

在Chart Explorer顶部找到 AI 助手 输入框。输入你想创建的图表的自然语言描述。例如：

ClickStack 会将提示词转换为查询，并自动渲染可视化结果。

试用 Text-to-Chart 最快捷的方式，是使用本地模式 Docker 镜像和远程演示数据集：

docker run -e ANTHROPIC_API_KEY='<YOUR_KEY>' -p 8080:8080 clickhouse/clickstack-local:latest

访问 localhost:8080。要连接到演示数据，请前往 团队设置，并使用以下信息创建新连接：

然后将各个数据源——日志、链路追踪、指标和会话——修改为使用 otel_v2 数据库。有关配置数据源的完整说明，请参阅远程演示数据集指南。

连接完成后，打开 Chart Explorer，使用可用的日志、链路追踪和指标试试这些提示词。

以下提示词展示了处理可观测性数据时的常见用法：

提示词	数据源	描述
`Error count by service over time`	日志	以图表形式展示各服务的错误频率
`Average request duration grouped by endpoint`	链路追踪	展示各端点的延迟模式
`P99 latency by service`	链路追踪	识别各服务的尾延迟
`Count of 5xx status codes over the last 6 hours`	日志	跟踪服务器错误趋势

提示词可以引用已配置数据源中任何可用的列或 attribute。提示词越具体，生成的图表就越准确。