🔎 Observabilidade: ler o painel e achar a falha no log

Novo aqui? Um painel (ou dashboard) é a tela onde a plataforma de execução mostra tudo que rodou: cada vez que sua automação disparou, aparece uma linha nova — com data, hora e um status (sucesso ou falha). É o "extrato bancário" da sua automação: você não precisa entender como o banco processa por dentro, só sabe ler se a conta fechou certo.

No painel do Trigger.dev (a plataforma usada no módulo 4.6), cada execução vira uma linha clicável. Clicar nela abre os detalhes — inclusive o log, que é o assunto do próximo tópico.

Legenda: à esquerda, a lista de execuções com status colorido. À direita, o que aparece ao clicar numa execução que falhou — o log, linha por linha, mostrando exatamente onde e por que travou.

Novo aqui? Um log é a lista de eventos que a automação foi anotando enquanto rodava — tipo um diário de bordo. Cada linha registra "o que aconteceu" e "a que horas". Não é código: é texto simples, em ordem cronológica, contando a história do que a automação tentou fazer.

Você não precisa saber ler TypeScript. Precisa saber ler o log. É a frase mais importante deste módulo. O log conta a história em português (ou em mensagens claras) mesmo quando o código por trás é técnico — porque quem escreveu a task (o Claude Code, seguindo suas instruções) normalmente deixa mensagens legíveis em cada etapa importante.

Quando uma execução aparece com status de falha no painel, o processo é sempre o mesmo: clique nela, abra o log, e desça até achar a primeira linha marcada como erro. Não precisa ler tudo com atenção igual — as linhas normais só confirmam que "até aqui, tudo bem"; o que importa é onde a história muda de rumo.

Lembra do módulo 4.5? Se a automação foi bem desenhada, com retentativa, você vai ver algumas tentativas registradas no log antes do erro final — isso é normal e não significa que está tudo quebrado, significa que o sistema tentou se recuperar sozinho e não conseguiu daquela vez.

Achou a linha vermelha? Não precisa decifrá-la sozinho. Volte ao Claude Code, cole o trecho do log (com contexto de algumas linhas antes e depois) e peça uma investigação — ele lê código com naturalidade e traduz o problema pra você em português.

Objetivo: pedir pro Claude Code investigar uma falha real, usando o log copiado do painel como evidência — sem você precisar entender o erro técnico primeiro.

Minha automação "" falhou na execução de
. Colei abaixo o trecho
do log a partir de onde os erros aparecem. Me explique, em português
simples, o que provavelmente deu errado e sugira uma correção. Se for
algo relacionado a uma variável de ambiente/chave de API, me diga qual
delas conferir no painel — sem eu precisar mexer no código.

--- log colado ---

--- fim do log ---

Como verificar: a resposta do agente deve apontar uma causa provável em linguagem simples (ex.: "a chave de API parece estar errada ou vencida" ou "o serviço externo demorou mais que o tempo limite") e uma ação concreta — corrigir o código, recadastrar uma chave, ou aumentar um tempo de espera. Se a resposta ficar vaga, peça: "aponte exatamente qual linha do log te fez concluir isso".

Observabilidade não é um evento único — é um hábito. Automação publicada sem ninguém olhando o painel de vez em quando é automação que pode estar falhando há dias sem você saber.

A boa notícia: você não precisa ficar checando manualmente todo dia. A maioria das plataformas permite configurar um alerta (por e-mail ou mensagem) que avisa automaticamente quando uma execução falha — assim o painel só precisa da sua atenção quando algo realmente pede.

Você percorreu o caminho inteiro: entendeu por que local não basta (4.1), o pipeline código → repositório → nuvem (4.2), a separação entre teste e produção (4.3), como proteger segredos (4.4), por que quebrar tudo em tarefas pequenas com retentativa (4.5), publicou uma automação de verdade (4.6) e agora sabe ler o painel quando algo falha (4.7).

Esse é o conjunto completo de habilidades pra qualquer automação sua sair do seu laptop e virar algo que roda de verdade, sozinho, com segurança. A próxima trilha muda de assunto: como dar ao seu agente a capacidade de enxergar telas e construir interfaces visuais.