Text-to-Chart

O recurso Text-to-Chart do ClickStack permite criar visualizações descrevendo, em texto simples, o que você quer ver. Em vez de selecionar manualmente métricas, filtros e campos de agrupamento, você pode digitar um prompt como "taxas de erro por serviço nas últimas 24 horas", e o ClickStack gerará automaticamente o gráfico correspondente.

Esse recurso usa um modelo de linguagem de grande porte (LLM) para converter seu prompt de texto em uma consulta e, em seguida, criar a visualização no Chart Explorer. Ele funciona com qualquer fonte de dados configurada.

O Text-to-Chart requer uma chave de API da Anthropic. Defina a variável de ambiente ANTHROPIC_API_KEY ao iniciar o ClickStack.

Para implantações open source, passe a chave como variável de ambiente. O método varia de acordo com o tipo de implantação:

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

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

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

Navegue até o Chart Explorer

Selecione Chart Explorer no menu esquerdo do HyperDX.

Selecione uma fonte de dados

Escolha a fonte de dados que você quer visualizar — por exemplo, Logs, Traces ou Metrics.

Insira um prompt de texto

Na parte superior do Chart Explorer, localize o campo do Assistente de IA. Digite uma descrição em linguagem natural do gráfico que você quer criar. Por exemplo:

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

O ClickStack converte o prompt em uma consulta e exibe a visualização automaticamente.

A forma mais rápida de testar o Text-to-Chart é com a imagem Docker do Modo Local e o dataset de demonstração remoto:

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

Acesse localhost:8080. Para se conectar aos dados de demonstração, vá para Team Settings e crie uma nova conexão com os seguintes detalhes:

• Connection Name: Demo
• Host: https://sql-clickhouse.clickhouse.com
• Username: otel_demo
• Password: Deixe em branco

Em seguida, altere cada um dos sources — Logs, Traces, Metrics e Sessions — para usar o banco de dados otel_v2. Para ver todos os detalhes sobre como configurar sources, consulte o guia do demo dataset remoto.

Depois de se conectar, abra o Chart Explorer e teste prompts com os logs, traces e metrics disponíveis.

Os prompts a seguir demonstram casos de uso comuns ao trabalhar com dados de observabilidade:

Os prompts podem fazer referência a qualquer coluna ou atributo disponível nas suas fontes de dados configuradas. Quanto mais específico for o prompt, mais preciso será o gráfico gerado.

• No momento, o Text-to-Chart oferece suporte ao Anthropic como provedor de LLM. O suporte a outros provedores, incluindo o OpenAI, está planejado para versões futuras.
• Apenas logs e traces são compatíveis como fontes de dados. Métricas do Prometheus ainda não são compatíveis.
• A precisão do gráfico depende da clareza do prompt e da estrutura dos dados subjacentes. Se um gráfico gerado não corresponder ao esperado, tente reformular o prompt ou especificar explicitamente os nomes das colunas.

• Do texto para gráficos: uma maneira mais rápida de visualizar com o ClickStack — post do blog que apresenta o recurso
• Dashboards e visualizações — criação manual de gráficos com o Chart Explorer
• Busca — sintaxe de busca em texto completo e por propriedades
• Configuração — todas as variáveis de ambiente do ClickStack