Pular para o conteúdo principal

Gerenciamento de KPIs

KPIs (Indicadores-Chave de Desempenho) são métricas que se atualizam automaticamente em um cronograma. Eles alimentam seus dashboards, o Business Pulse e o sistema de alertas.

Captura de tela da página de gerenciamento de KPIs mostrando a aba de KPIs Ativos com uma lista de KPIs, seus cronogramas e botões de ação

Entendendo KPIs​

Um KPI é definido por:

  • Nome — Rótulo legível (ex.: "Receita Mensal")
  • Consulta SQL — A consulta que calcula o valor da métrica
  • Cronograma — Uma expressão cron definindo com que frequência ele se atualiza (ex.: a cada hora, diariamente às 6h)
  • Status — Ativo (executando no cronograma) ou Pausado

Criando KPIs​

Método 1: Planejador com IA​

A forma mais rápida de criar KPIs é com o Planejador com IA:

  1. Vá em Dashboards → KPIs → aba Planejador
  2. Descreva seus objetivos de negócio na caixa de texto
  3. Clique em Gerar Sugestões

Captura de tela do Planejador de KPIs mostrando sugestões de KPI geradas por IA com nome, consulta SQL, cronograma e toggles de ativação

A IA irá sugerir KPIs relevantes com base nos seus dados e objetivos. Para cada sugestão, você pode:

  • Visualizar o nome, descrição, consulta SQL e cronograma
  • Editar qualquer campo antes de ativar
  • Configurar o preenchimento retroativo — quanto de dados históricos calcular inicialmente
  • Ativar para começar a coletar dados

Método 2: Assistente de Contexto de Negócio​

Durante a configuração do Contexto de Negócio, a IA realiza uma análise de viabilidade e sugere KPIs como parte do processo. Você pode selecionar quais deseja criar.

Método 3: Criação Manual​

Usuários avançados podem criar KPIs diretamente fornecendo:

  • Uma consulta SQL que retorne um valor numérico
  • Uma expressão cron para o cronograma
  • Um nome e descrição

Gerenciando KPIs​

Lista de KPIs​

A aba de KPIs Ativos mostra todos os seus KPIs com:

ColunaDescrição
NomeRótulo do KPI
CronogramaCronograma legível (ex.: "Todos os dias às 6:00")
Próxima ExecuçãoQuando o KPI será atualizado novamente
StatusAtivo ✅ ou Pausado ⏸️

Ações​

AçãoDescrição
Ver DetalhesVisualizar valores históricos e tendências
Alternar PulseAdicionar/remover do Business Pulse no Dashboard Inicial (máx. 6)
Pausar/RetomarParar temporariamente ou reiniciar a coleta de dados
Executar AgoraDisparar um cálculo imediato
ExcluirRemover permanentemente (digite "delete" para confirmar)

Business Pulse​

Marque até 6 KPIs como "Pulse" para exibi-los em destaque no Dashboard Inicial. Os KPIs do Pulse mostram:

  • Valor atual com formatação
  • Indicador de tendência (▲ subindo / ▼ descendo / — estável)
  • Mini gráfico sparkline dos valores recentes

Captura de tela da seção Business Pulse no Dashboard Inicial mostrando 4 KPIs favoritos com valores, tendências e sparklines

Visualização Detalhada do KPI​

Clique em qualquer KPI para ver sua página de detalhes:

Captura de tela de uma página de detalhes de KPI mostrando o valor atual, gráfico de dados históricos e metadados

  • Valor Atual — Último valor calculado
  • Gráfico Histórico — Gráfico de todos os valores históricos
  • Metadados — Cronograma, fuso horário, unidade de medida, configurações de visibilidade
  • Executar Agora — Executar a consulta imediatamente
info

Dicas de Cronograma: Cronogramas comuns incluem:

  • 0 6 * * * — Diariamente às 6:00
  • 0 */4 * * * — A cada 4 horas
  • 0 9 * * 1 — Toda segunda-feira às 9:00
  • 0 0 1 * * — Primeiro dia de cada mês à meia-noite

A plataforma mostra versões legíveis: "Todos os dias às 6:00"