[Metrics] Como usar filtros e variáveis nos dashboards

Filtros e variáveis deixam os dashboards do Groner Metrics reaproveitáveis: você escreve a consulta uma vez e ela se ajusta ao período, à loja ou a qualquer valor escolhido. Nas consultas, os dois são usados no formato {{chave}}.

Filtros (interativos)

Os filtros aparecem no topo do dashboard. Quando o usuário muda o valor, todos os widgets reagem juntos. Exemplos: período, loja, origem.

Tipos de filtro: texto, número, data, período (intervalo), seleção e multi-seleção. As opções de seleção podem ser fixas ou vir de uma consulta SQL.

Variáveis fixas

São valores que você define uma vez (texto, número, data ou lista), ou que são obtidos por uma consulta. Servem para IDs de status, metas e parâmetros usados em vários widgets.

Passo a passo

1. Com o dashboard em modo edição, crie o filtro ou a variável e dê uma chave, por exemplo loja.
2. Na consulta do widget, use {{loja}} onde o valor deve entrar.
3. Teste a consulta e salve.

Dica: ao pedir uma consulta para a IA, ela já considera os filtros criados no dashboard.

Veja também

• [Metrics] Como montar o seu primeiro dashboard
• [Metrics] SQL ou IA: as duas formas de montar uma consulta
• [Metrics] O que são widgets: gráfico, KPI e tabela
• [Metrics] Como compartilhar um dashboard com quem não tem login

Atualizado em: 08/10/2026