Cálculos e fórmulas
Por trás de cada número do painel há um cálculo: uma contagem, uma soma, uma média, um percentual. A escolha do cálculo muda o resultado e, às vezes, a decisão. A média de conformidade de uma unidade não é o mesmo que a mediana; a quantidade de coletas não é o mesmo que a quantidade de não conformidades; e uma taxa de aprovação precisa dividir as aprovadas pelo total certo.
As funções cobrem os cálculos mais comuns com um clique. As fórmulas combinam funções para criar indicadores próprios: taxas, percentuais do total, variação em relação ao mês anterior, saldo de estoque, pontuação ponderada.
Funções de cálculo
Ao abrir uma métrica no editor de gráficos, a aba Quick function lista as funções disponíveis:
| Função | Na tela | Calcula | Quando usar |
|---|---|---|---|
| Contagem | Count (Count of records) | Quantidade de registros | Quantas coletas, auditorias, entrevistas. |
| Contagem de valores únicos | Unique count | Quantos valores diferentes um campo tem | Quantas unidades auditadas, quantos auditores ativos. |
| Soma | Sum | Soma dos valores | Total de ocorrências, de itens, de horas, de quantidades. |
| Média | Average | Soma dividida pela quantidade | Resultado médio de auditorias, temperatura média, nota média. |
| Mediana | Median | O valor do meio, com metade dos valores acima e metade abaixo | Tempos e valores com extremos que distorcem a média. |
| Mínimo e máximo | Minimum / Maximum | O menor e o maior valor | Pior e melhor resultado, menor e maior temperatura. |
| Percentil | Percentile | O valor abaixo do qual está um percentual dos registros | "90% dos atendimentos levam até X minutos." |
| Posição percentual | Percentile rank | O percentual de registros abaixo de um valor | "Que parte das câmaras ficou abaixo de 4 °C?" |
| Último valor | Last value | O valor da coleta mais recente | Leituras atuais: nível de tanque, horímetro, estoque. |
| Desvio padrão | Standard deviation | O quanto os valores variam em torno da média | Estabilidade de um processo (pesos, temperaturas). |
| Soma acumulada | Cumulative sum | A soma dos períodos anteriores mais o atual | Total acumulado de coletas ao longo do ano. |
| Diferença | Differences | A diferença em relação ao período anterior | Quanto o indicador subiu ou caiu de um mês para o outro. |
| Média móvel | Moving average | A média dos últimos N períodos | Suavizar oscilações diárias para ver a tendência. |
Soma acumulada, diferença e média móvel são calculadas sobre o agrupamento por data do eixo horizontal. Use-as em gráficos com Date histogram.
Média ou mediana
O editor costuma escolher Median ao colocar um campo numérico no gráfico. Para indicadores de resultado (notas, percentuais de conformidade), o usual é a média. Veja a diferença com cinco auditorias de uma unidade:
| Resultados | Média | Mediana |
|---|---|---|
| 90, 88, 85, 84, 30 | 75,4 | 85 |
A média é puxada para baixo pela auditoria de 30; a mediana a ignora. Se o indicador oficial é a média, use Average em todos os gráficos, para os números do painel baterem com os relatórios.
Contagem de registros e contagem de ocorrências
Count of records conta coletas (registros), não respostas "Sim" nem ocorrências.
- Para contar as coletas com uma resposta específica, use Count of records com um filtro (por exemplo,
status : "Reprovado"). - Para contar ocorrências registradas como número (por exemplo, opções com valor 1 para "Sim"), use Sum do campo.
- Num índice transposto, cada coleta vira vários registros: use Sum do campo de valor.
- Numa pergunta de seleção múltipla, uma coleta é contada em cada opção marcada.
Fórmulas
Uma fórmula combina funções, números e operações. Para usar:
- Abra a métrica no editor de gráficos.
- Clique na aba Formula.
- Digite a fórmula. O editor sugere funções e campos enquanto você escreve, e mostra a documentação de cada função no botão de ajuda.
- Em Value format, escolha o formato do resultado (por exemplo, Percent para uma taxa).
Elementos de uma fórmula
| Elemento | Exemplo | Observação |
|---|---|---|
| Função sobre um campo | average(temperatura) | As mesmas funções da tabela acima, com os nomes em inglês: count, unique_count, sum, average, median, min, max, percentile, last_value, standard_deviation. |
| Campo com hífen | average('perc-total') | Nomes com hífen ou caracteres especiais vão entre aspas simples. |
| Contagem de registros | count() | Sem campo. |
| Filtro numa função | count(kql='status : "Reprovado"') | O parâmetro kql recebe uma expressão da barra de busca, entre aspas simples. |
| Deslocamento no tempo | average('perc-total', shift='1M') | O mesmo cálculo no mês anterior. Outros valores: 1d, 1w, 3M, 1y. |
| Operações | + - * / e parênteses | Seguem a ordem usual da matemática. |
| Funções matemáticas | round(x, 1), abs(x), clamp(x, 0, 100), pow(x, 2), sqrt(x) | Arredondar, valor absoluto, limitar a uma faixa, potência, raiz. |
| Totais do conjunto | overall_sum(count()), overall_average(...) | O total ou a média de todos os grupos do gráfico, para calcular participações. |
O filtro kql='...' fica entre aspas simples, e os valores dentro dele, entre aspas duplas: count(kql='aprovacao : "Necessita ajustes"'). Se o valor tiver um apóstrofo, escreva \' no lugar dele.
Fórmulas prontas
| Indicador | Fórmula | Formato |
|---|---|---|
| Taxa de reprovação | count(kql='status : "Reprovado"') / count() | Percent |
| Taxa de aprovação entre as avaliadas (ignora as não avaliadas) | count(kql='status : "Aprovado"') / count(kql='status : *') | Percent |
| Positividade (positivos entre os testados) | count(kql='resultado : "Positivo"') / count(kql='testado : "Sim"') | Percent |
| Encaminhamento dos positivos | count(kql='encaminhado : "Sim" and resultado : "Positivo"') / count(kql='resultado : "Positivo"') | Percent |
| Participação de cada grupo no total | count() / overall_sum(count()) | Percent |
| Fora da faixa de temperatura | count(kql='temperatura > 4 or temperatura < 0') / count() | Percent |
| Primeira vez (por exemplo, entrevistados que nunca participaram) | count(kql='ja-participou : "Não"') / count() | Percent |
| Saldo a partir de uma leitura de espaço vazio (capacidade menos o vazio medido) | 500 - last_value('espaco-vazio', kql='espaco-vazio : *') | Number |
| Ocupação percentual de um tanque | (500 - last_value('espaco-vazio', kql='espaco-vazio : *')) / 500 | Percent |
| Percentual sobre o máximo de pontos | sum(pontos) / sum('pontos-possiveis') | Percent |
| Média ponderada de duas notas (peso 2 e peso 1) | (average('nota-pratica') * 2 + average('nota-teorica')) / 3 | Number |
| Não conformidades por auditoria | sum('qtd-nc') / count() | Number |
last_value traz o valor da coleta mais recente. Se essa coleta não tiver o campo preenchido, o resultado fica vazio. O filtro kql='campo : *' faz a função considerar só as coletas com o campo preenchido.
Uma taxa calculada por divisão (por exemplo, 0.25) deve usar o formato Percent, que mostra 25%. Um campo que já vem multiplicado por 100 do formulário (por exemplo, 85) deve usar o formato Number com sufixo %. Misturar os dois gera valores como 0,85% ou 8.500%.
Variação em relação ao período anterior
| Indicador | Fórmula | Formato |
|---|---|---|
| Variação percentual em relação ao mês anterior | average('perc-total') / average('perc-total', shift='1M') - 1 | Percent |
| Diferença em pontos em relação ao mês anterior | average('perc-total') - average('perc-total', shift='1M') | Number |
| Coletas em relação ao mesmo período do ano anterior | count() / count(shift='1y') - 1 | Percent |
Num card, coloque o valor atual como métrica principal e a variação como métrica secundária, com cor por valor (verde para positivo, vermelho para negativo).
Se o período anterior não tiver coletas, a divisão não tem resultado e o gráfico mostra um valor vazio. Isso é esperado. Para evitar o vazio, escolha um período em que os dois intervalos tenham coletas.
Valor fixo
A aba Static value define um número fixo numa dimensão. É usada principalmente para:
- Metas em linhas de referência.
- Mínimo, máximo e meta de medidores.
- Máximo de um card com barra de progresso.
Opções avançadas de uma métrica
Em Advanced, dentro de cada métrica:
| Opção | O que faz |
|---|---|
| Filter by | Aplica um filtro só a essa métrica. Veja Filtro numa métrica. |
| Time shift | Calcula a métrica deslocada no tempo. Veja Comparar com o período anterior. |
| Reduced time range | Usa só o trecho final do período (por exemplo, a última hora), útil para leituras "atuais" em painéis de acompanhamento. |
Quando calcular no formulário
Algumas regras ficam melhores no próprio formulário, como campo calculado, do que numa fórmula do painel:
- Regras com várias condições sobre a mesma coleta ("positivo se A ou pelo menos duas entre B, C e D").
- Classificações que precisam aparecer na resposta e nos relatórios do formulário (por exemplo, "Aprovado" ou "Reprovado").
- Pontuações por tag, como
sumByTageavgByTag.
O resultado chega pronto ao índice, e o painel só precisa contar, somar ou tirar a média. Veja Campos calculados e tags.