Text-to-Chart

Возможность Text-to-Chart в ClickStack позволяет создавать визуализации, просто описывая обычным текстом, что вы хотите увидеть. Вместо того чтобы вручную выбирать метрики, фильтры и поля для группировки, вы можете ввести промпт, например “уровень ошибок по сервисам за последние 24 часа”, и ClickStack автоматически создаст соответствующий график. Эта возможность использует большую языковую модель (LLM), чтобы преобразовать ваш текстовый промпт в запрос, а затем создать визуализацию в Chart Explorer. Она работает с любым настроенным источником данных.

Предварительные требования

Для Text-to-Chart требуется API-ключ Anthropic. При запуске ClickStack задайте переменную окружения ANTHROPIC_API_KEY. Для развертываний с открытым исходным кодом передайте ключ через переменную окружения. Способ зависит от типа развертывания:

Docker (All-in-One или локальный режим)
Docker (только HyperDX)
Docker Compose
Helm

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>

Использование Text-to-Chart

Перейдите в Chart Explorer

В левом меню HyperDX выберите Chart Explorer.

Выберите источник данных

Выберите источник данных, который хотите визуализировать, — например, журналы, Traces или Metrics.

Введите текстовый промпт

В верхней части страницы Chart Explorer найдите поле ввода AI Assistant. Введите на естественном языке описание диаграммы, которую хотите создать. Например:

Show error rates by service over the last 24 hours
Latency breakdown by endpoint
Count of events over time grouped by severity

ClickStack преобразует промпт в запрос и автоматически построит визуализацию.

Пробуем с демо-данными

Самый быстрый способ попробовать Text-to-Chart — воспользоваться Docker-образом Local Mode и удалённым демо-набором данных:

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

Перейдите по адресу localhost:8080. Чтобы подключиться к демо-данным, перейдите в Team Settings и создайте новое подключение со следующими данными:

Connection Name: Demo
Host: https://sql-clickhouse.clickhouse.com
Username: otel_demo
Password: Оставьте пустым

Затем измените каждый из источников — журналы, Traces, Metrics и Sessions — так, чтобы они использовали базу данных otel_v2. Подробные сведения о настройке источников см. в руководстве по удалённому демо-набору данных. После подключения откройте Chart Explorer и попробуйте промпты для доступных журналов, трассировок и метрик.

Примеры промптов

Следующие промпты демонстрируют типичные сценарии использования при работе с данными обсервабилити:

Промпт	Источник данных	Описание
`Error count by service over time`	Журналы	Показывает частоту ошибок по сервисам во времени
`Average request duration grouped by endpoint`	Traces	Показывает характер латентности для каждой конечной точки
`P99 latency by service`	Traces	Помогает выявить хвостовую латентность по сервисам
`Count of 5xx status codes over the last 6 hours`	Журналы	Отслеживает динамику серверных ошибок

Промпты могут ссылаться на любой столбец или атрибут, доступный в настроенных источниках данных. Чем конкретнее промпт, тем точнее будет сгенерированный график.

Ограничения

Text-to-Chart сейчас поддерживает только Anthropic в качестве провайдера LLM. Поддержка других провайдеров, включая OpenAI, планируется в будущих релизах.
В качестве источников данных поддерживаются только журналы и трассировки. Метрики Prometheus пока не поддерживаются.
Точность диаграммы зависит от ясности промпта и структуры исходных данных. Если созданная диаграмма не соответствует ожиданиям, попробуйте переформулировать промпт или явно указать имена столбцов.

Дополнительные материалы

От текста к графикам: более быстрый способ создавать визуализации в ClickStack — пост в блоге, представляющий эту возможность
Панели мониторинга и визуализации — ручное создание графиков с помощью Chart Explorer
Поиск — синтаксис полнотекстового поиска и поиска по свойствам
Конфигурация — все переменные окружения ClickStack

Возможности

Руководства

Предварительные требования

Использование Text-to-Chart

Перейдите в Chart Explorer

Выберите источник данных

Введите текстовый промпт

Пробуем с демо-данными

Примеры промптов

Ограничения

Дополнительные материалы

​Предварительные требования

​Использование Text-to-Chart

​Перейдите в Chart Explorer

​Выберите источник данных

​Введите текстовый промпт

​Пробуем с демо-данными

​Примеры промптов

​Ограничения

​Дополнительные материалы

Предварительные требования

Использование Text-to-Chart

Перейдите в Chart Explorer

Выберите источник данных

Введите текстовый промпт

Пробуем с демо-данными

Примеры промптов

Ограничения

Дополнительные материалы