APRENDER. PRATICAR. EVOLUIR.Especificar o resultado que será contado
Um indicador começa numa pergunta de negócio. “Os pedidos ficam resolvidos em tempo útil?” ainda não define uma medida executável. Num serviço fictício, escolhemos pedido único como unidade, admissão como início e conclusão como estado final relevante. O compromisso didático é quatro horas, incluindo a fronteira exata. Definimos também a população: pedidos admitidos até ao instante de observação, com uma janela completa de quatro horas já decorrida. A medida verifica se o pedido está concluído nesse instante e se a conclusão ocorreu dentro da janela. Esta última regra importa quando há reaberturas. Não é uma definição universal de SLA. Antes de aplicar uma regra semelhante no trabalho, confirma o significado com negócio, operação e responsáveis pelos dados. Regista exceções, calendário, versão e finalidade para impedir que equipas calculem números diferentes com o mesmo nome.
Dar o mesmo tempo de observação aos pedidos
À hora doze, um pedido admitido à hora onze só teve uma hora para terminar. Chamá-lo atrasado num indicador de quatro horas seria prematuro. No exercício, I, J e K ainda não têm a janela completa e ficam numa categoria explícita. I já terminou, mas continua fora do denominador principal para que a seleção não inclua apenas sucessos rápidos entre os pedidos recentes. Isso não obriga a esconder a conclusão: o relatório mantém o estado de cada pedido e pode apresentar separadamente resultados preliminares. H entrou à hora oito e termina à hora doze; a janela já decorreu e a fronteira inclusiva permite contar o resultado. Em produção, distingue tempo corrido, horas úteis e calendários de serviço. O exercício usa horas corridas inteiras para tornar as decisões inspecionáveis.
Tratar reaberturas sem reiniciar silenciosamente o relógio
C entra à hora dois, termina à hora três e reabre à hora quatro. No relatório da hora doze está aberto, apesar da conclusão histórica. A regra fornecida conserva a admissão original, pelo que já acumula dez horas. À hora catorze termina novamente, com duração de doze horas desde a entrada. Outra organização pode medir primeira resposta, primeira resolução e resolução estável como indicadores distintos. O erro é trocar essas definições sem informar quem usa o resultado. Preserva eventos em vez de guardar apenas o último estado atual, pois precisas de reconstruir o estado modelado para o instante analisado. Uma reabertura pode revelar falha de qualidade, nova necessidade ou classificação incorreta. O indicador sinaliza a condição; a causa exige investigação antes de recomendar uma mudança.
Ler a média juntamente com quem ficou de fora
Dos oito pedidos com janela completa à hora doze, seis estão concluídos. As suas durações somam vinte e seis horas, produzindo uma média de cerca de 4,33 horas. Essa média descreve apenas os seis concluídos. C e E continuam abertos e já acumularam dez e oito horas, respetivamente. Se incluíres a duração até à conclusão para os fechados e a idade atual para os abertos, obténs quarenta e quatro horas divididas por oito, ou 5,5 horas. É uma medida diferente, que não deve receber o nome de duração média final. Também não prevê quando os pedidos pendentes terminarão. Apresenta número de casos, regra de inclusão e idade do trabalho pendente. Uma média de concluídos pode melhorar enquanto a fila esquecida envelhece.
Validar os dados antes de confiar na precisão
O script rejeita identidade duplicada de pedido, eventos com a mesma identidade e conteúdo contraditório, estados desconhecidos e transições temporalmente impossíveis. Uma retransmissão idêntica do mesmo evento não duplica o pedido. Estas regras detetam problemas no contrato modelado, mas não provam que todos os acontecimentos reais chegaram ao sistema. Um log pode estar atrasado, uma equipa pode trabalhar fora da ferramenta e dois relógios podem não estar alinhados. Confirma a cobertura e a atualização da fonte com quem a mantém. Se falta evidência de conclusão, distingue “não há registo” de “sabemos que não concluiu”. No conjunto sintético, a completude é uma condição explícita de construção. Transferir essa condição para produção sem prova pode transformar desconhecimento em aparente incumprimento.
Exercício original: eventos e pergunta
Admissão por pedido, em horas desde o início: A=0, B=1, C=2, D=3, E=4, F=5, G=6, H=8, I=9, J=10, K=11, L=13. Eventos: A conclui a 3; B a 7; C conclui a 3, reabre a 4 e conclui a 14; D conclui a 8; E não tem conclusão; F a 8; G a 11; H a 12; I a 11; J a 14; K a 16. L ainda não tem eventos. A janela é de quatro horas corridas, inclusiva, desde a admissão. A conclusão tem de ser o estado atual no instante observado. O conjunto é fictício e completo por construção. Antes de executar: à hora doze, identifica os pedidos com janela completa, os que cumprem o prazo, os concluídos tarde e os ainda abertos. Calcula a média apenas dos concluídos e a média do tempo até à conclusão ou observação. Explica por que não são a mesma medida.
Análise comentada e limites
Análise comentada: A a H têm janela completa. A, F e H cumprem; B, D e G concluíram tarde; C e E continuam abertos. Resultado: 3/8 = 37,5%. Os seis concluídos somam 26 horas, média 26/6 = 4,33 horas aproximadamente. C e E somam mais 18 horas até à observação, dando 44/8 = 5,5 horas na medida mista de tempo decorrido. I, J e K são recentes; L ainda não entrou. Não usar a conclusão futura de K no relatório da hora doze. O script fornece 36 verificações destas regras e de entradas inválidas.
python3 content/labs/cbap-outcome-windows/run.py --output /tmp/cbap-outcomes.json
# Inspect observations.at12 and each request outcome.À hora doze, A, F e H cumprem a regra entre oito pedidos com janela completa: 3/8 = 37,5%. I está concluído, mas ainda não pertence a essa população.
Armadilhas comuns
Contar sucessos recentes sem incluir os restantes pedidos recentes; reiniciar o relógio na reabertura; chamar média global à média dos concluídos; assumir que ausência de log prova falha.
Tópicos relacionados: Métricas e critérios de aceitação · Qualidade de dados · Limitações da solução
Um resultado só é interpretável com população, janela, estado, origem e limites explícitos. A precisão da divisão não corrige uma definição errada.
Referência: CBAP competencies · CBAP six-knowledge-area blueprint, May 2026 handbook