Pular para o conteúdo principal
Esta página responde a perguntas frequentes sobre os recursos do ClickStack, incluindo alertas, dashboards, drill-downs e descoberta de métricas.

​
Alertas

O ClickStack oferece dois tipos de alertas:
  • Alertas de busca — acionam notificações quando a contagem de resultados de logs ou traces correspondentes em uma janela de tempo excede ou fica abaixo de um limiar.
  • Alertas de gráficos do dashboard — acionam notificações quando uma métrica plotada em um tile do dashboard ultrapassa um limiar definido.
Ambos os tipos de alerta usam condições de limiar estáticas. Para ver todos os detalhes, consulte Alertas.
Proporções entre duas métricas e valores de p95 e p99 podem ser plotados em um tile do dashboard usando a UI do chart builder. Em seguida, você pode criar alertas baseados em limiar nesses tiles.No entanto, o ClickStack atualmente não oferece suporte a:
  • Alertas em consultas SQL personalizadas para métricas.
  • Regras de alerta com múltiplas condições ou múltiplas métricas combinadas em um único alerta.
  • Condições de alerta dinâmicas ou baseadas em detecção de anomalias (a detecção de anomalias está planejada).
Se você precisar criar um alerta para uma métrica complexa, a abordagem recomendada é primeiro criar a visualização como um gráfico no dashboard e, depois, associar um alerta de limiar a esse gráfico.
As visões materializadas são usadas automaticamente pelo ClickStack em alertas, quando aplicável. No entanto, no momento, visões materializadas não têm suporte em fontes de dados de métricas do OpenTelemetry. Para métricas, o ClickStack funciona melhor com o schema padrão de métricas OpenTelemetry do ClickHouse. Para saber mais sobre visões materializadas, consulte Visões materializadas.

​
Dashboards e drill-downs

O ClickStack oferece suporte a filtros suspensos personalizados em dashboards, preenchidos com dados consultados no ClickHouse. Esses filtros permitem restringir dinamicamente todos os tiles de um dashboard a um valor específico (por exemplo, um nome de serviço, ambiente ou host).No momento, o ClickStack não oferece suporte a variáveis de dashboard reutilizáveis no estilo das variáveis de template do Grafana. Como o ClickStack funciona exclusivamente com o ClickHouse como fonte de dados, os recursos de drill-down e filtragem podem ser fornecidos nativamente, sem exigir uma camada de abstração de variáveis.Para saber mais sobre como criar dashboards e aplicar filtros, consulte Dashboards.
O ClickStack oferece suporte aos seguintes fluxos de trabalho de drill-down:
  • Filtragem no nível do dashboard — filtros Lucene ou SQL e ajustes no intervalo de tempo aplicados no nível do dashboard são propagados para todos os tiles.
  • Filtros personalizados de dashboard — dashboards personalizados oferecem controles de filtro explícitos, preenchidos com valores dos seus dados, permitindo que os usuários definam o escopo de todos os tiles sem escrever consultas manualmente.
  • Clique para visualizar eventos — clicar em dados em um tile do dashboard e selecionar View Events leva à página Busca com filtros relevantes para dados de logs e traces.
  • Drill-downs de dashboards pré-configurados — os dashboards Services, ClickHouse e Kubernetes incluem uma navegação de drill-down integrada mais avançada entre abas.
No momento, drill-downs em vários níveis de um dashboard personalizado para outro (dashboard → dashboard → visualização detalhada) não são compatíveis.
O drill-down View Events funciona melhor com dados de logs e traces. Como os dados de métrica não podem ser visualizados na página Busca, fazer drill-down a partir de um tile de métrica levará a logs próximos ao intervalo de tempo selecionado.

​
Descoberta de métricas

Metric Attribute ExplorerOs nomes das métricas podem ser encontrados no menu suspenso de nome da métrica no chart builder. Quando uma métrica é selecionada, o painel Metric Attribute Explorer exibe a descrição da métrica, as unidades e os atributos disponíveis, juntamente com seus valores. Isso permite navegar pelos atributos e adicioná-los como filtros ou campos de agrupamento diretamente no painel.No momento, não há uma página dedicada para pesquisar métricas, semelhante à experiência de pesquisa de logs. Melhorar a descoberta de métricas é uma área em desenvolvimento ativo.
Não. Embora consultas SQL possam ser usadas hoje para descobrir métricas, essa não é a abordagem pretendida de longo prazo. Ferramentas aprimoradas para descoberta de métricas estão sendo desenvolvidas ativamente.

​
Leitura complementar

  • Alertas — alertas de pesquisa, alertas de gráficos de dashboard e integrações por webhook.
  • Dashboards — criação de visualizações, montagem de dashboards e aplicação de filtros.
  • Busca — consultas em logs e traces com sintaxe Lucene e SQL.
  • Esquemas — esquemas de dados do OpenTelemetry para logs, traces e métricas.
  • Arquitetura — componentes do ClickStack e como eles se integram.
Última modificação em 10 de junho de 2026