Logs

A página Logs do projeto separa três origens que costumam ser confundidas. Elas têm autores diferentes, e chamar as três de "logs" faz alguém procurar um erro da aplicação num lugar onde só existe narrativa da publicação.

Aba	Quem escreveu	Quando procurar aqui
Runtime	A sua aplicação, em stdout e stderr	A aplicação subiu e algo está errado no comportamento dela
Build	O construtor da imagem	A publicação falhou antes de subir
Plataforma	O Zero, enquanto publicava	Entender o que a plataforma fez e em que ordem

"A plataforma disse que a versão está no ar" e "a aplicação disse que não conectou no banco" são frases de autores diferentes.

Runtime

A saída padrão e a saída de erro dos processos da sua aplicação. A aba abre nas últimas linhas do período, com a mais recente embaixo, e acompanha ao vivo: cada linha nova aparece em até alguns segundos.

• Escolha o período — última hora, 6 horas, 24 horas ou 7 dias — e, se houver mais de um serviço, o serviço.
• Filtre por nível e busque por texto.
• Pausar congela a tela para ler com calma; Retomar ao vivo volta a acompanhar sem perder o que chegou no meio tempo.
• Se você subir para ler, a tela fica onde está e mostra Linhas novas ↓ quando chegar algo.
• Carregar anteriores traz as linhas de antes, dentro do período.
• Baixar entrega um arquivo com o período inteiro, com os filtros escolhidos — da linha mais antiga para a mais recente, com o serviço, o ambiente, a instância e o nível de cada linha.
• Copie o que está na tela com Copiar tudo.

A tela guarda até 5.000 linhas. Quando o acompanhamento passa disso, as mais antigas saem da tela — e continuam no arquivo de Baixar.

Por quanto tempo o log fica guardado

• 7 dias. Depois disso, as linhas são apagadas.
• Até 50.000 linhas por serviço, por dia (UTC). Uma aplicação que passa disso — um laço que imprime o mesmo erro sem parar, por exemplo — tem o resto daquele dia descartado, e a tela avisa: um serviço atingiu o limite de 50000 linhas num dia. A gravação volta no dia seguinte.
• Uma linha com mais de 8 KB é cortada no limite, e a tela avisa.

Com a CLI, o mesmo log: zero logs --project <projeto> --follow acompanha ao vivo, e zero logs --project <projeto> --all --from 7d > app.log grava o período inteiro num arquivo. Ver CLI.

Se ainda não há aplicação executando, a resposta é explícita: ainda não há execução. Nunca uma lista vazia — vazio significaria "executou e não escreveu nada", e confundir os dois manda você procurar o problema no lugar errado.

Para a aplicação aparecer aqui, ela precisa escrever em stdout/stderr. Aplicações que escrevem em arquivo dentro do container não são coletadas.

Build

A saída completa do construtor da imagem, escolhendo a publicação. A tela abre no fim do build, que é onde está o motivo de uma falha; um build muito longo mostra as últimas 5.000 linhas, e Baixar traz o build inteiro.

A saída é gravada nos dois desfechos — sucesso e falha. Quem investiga um build lento, ou um que produziu a imagem errada, precisa do log de um que deu certo.

É a aba que responde "por que quebrou" quando a publicação falha em Construindo. Ver Como a imagem é construída.

Plataforma

O que o Zero registrou enquanto publicava: as etapas, as transições e os motivos. É a narrativa da operação, em linguagem de produto.

O mesmo conteúdo aparece na aba Eventos da página de um deployment, ali restrito àquela publicação.

Segredos

Credenciais que apareçam na saída são mascaradas antes da gravação — inclusive as que vêm em mensagens de ferramentas externas. O contexto ao redor é preservado: uma linha inteiramente mascarada resolve o vazamento e cria um log inútil.

Erros comuns

Sintoma	Causa provável	O que fazer
A aba Runtime não mostra nada	Ainda não há execução, ou a aplicação não escreve em stdout	Confira o estado da publicação e como sua aplicação registra log
As linhas novas não aparecem	O acompanhamento está pausado, ou você subiu na lista	Clique em Retomar ao vivo, ou em Linhas novas ↓
"Um serviço atingiu o limite de 50000 linhas num dia"	A aplicação escreveu mais de 50.000 linhas naquele dia	Procure o laço que repete a mesma linha; a gravação volta no dia seguinte
Não encontro uma linha de mais de uma semana	O log fica guardado por 7 dias	Para guardar por mais tempo, baixe o log periodicamente
O log do build está vazio	A publicação falhou antes do build	Veja Tentativas de publicação no projeto
Não encontro o erro que vi no navegador	O erro é da aplicação, não da plataforma	Aba Runtime, não Plataforma

Próximos passos

• Tráfego e consumo
• Acompanhar uma publicação
• Problemas comuns