13. Logging e observabilidade

Quando a automação roda sem alguém olhando a tela, registros, métricas e rastreamentos contam o que aconteceu e ajudam a localizar a origem de uma falha.

Este é o capítulo 13 de 25 da apostila Python para Automação e Scripts. Ele aproveita a base construída em Configuração, ambiente e segredos e dá mais um passo no desenvolvimento da automação. Ao final, estaremos preparados para estudar Testes e isolamento de dependências.

Começando pela situação real

Agora o programa começa a conversar com pessoas e com o ambiente. Argumentos, configuração, registros e testes tornam seu comportamento previsível para quem executa e para quem precisa corrigir um problema. Em Logging e observabilidade, observaremos como essa parte se liga ao conjunto, mantendo claros o contrato de entrada, o processamento, os efeitos e a conferência do resultado.

Ao ler os exemplos, não tente decorar chamadas isoladas. Pergunte o que entra, qual estado muda, o que sai e como a falha aparece. Essa sequência aproxima a sintaxe do problema que ela resolve e cria uma base que continuará útil quando a biblioteca ou o ambiente mudar.

Nível de logging

O primeiro conceito do capítulo é Nível de logging. Ele fornece a base para interpretar os demais recursos sem confundir o nome de uma ferramenta com o comportamento que ela realmente oferece.

Nível de logging classifica eventos por severidade para filtragem e operação. Em termos simples, essa definição descreve uma promessa feita pelo programa: dadas certas condições, esperamos um comportamento específico. Antes de usar o recurso, identifique essas condições e pense no que deveria acontecer tanto no caminho normal quanto diante de uma entrada inadequada.

Na prática, usar DEBUG para diagnóstico, INFO para fluxo, WARNING para anomalia e ERROR para falha. Transforme essa orientação em passos visíveis: defina a entrada, aplique a operação, observe a saída e registre a condição de sucesso. Assim, o código continua ligado à finalidade da tarefa.

Uma forma de conferir o entendimento é observar o seguinte critério: configuração altera verbosidade sem mudar o código. Esse critério deve aparecer em um teste, em uma saída controlada ou em outro efeito que possa ser reproduzido.

Logger hierárquico

Depois de compreender Nível de logging, podemos avançar para Logger hierárquico. As duas ideias se conectam porque uma automação precisa preservar o contrato à medida que os dados percorrem novas etapas.

Logger hierárquico organiza emissores por nomes e propaga registros a handlers conforme configuração. Em termos simples, essa definição descreve uma promessa feita pelo programa: dadas certas condições, esperamos um comportamento específico. Antes de usar o recurso, identifique essas condições e pense no que deveria acontecer tanto no caminho normal quanto diante de uma entrada inadequada.