Logs, métricas e solução de problemas

Comece pela etapa que falha: sincronização do código-fonte, compilação, inicialização, roteamento ou requisição ao aplicativo. Logs de compilação e de execução respondem a perguntas diferentes.

Ler logs

Abra as visualizações Logs ou Observabilidade no painel, ou use a CLI a partir do projeto local vinculado:

adios logs --build
adios logs --runtime --lines 100
adios logs --runtime --follow
adios logs --http
adios logs --errors

Usar --build-id YOUR_BUILD_ID para inspecionar uma compilação específica. Use --region ou --replica para filtrar os logs de execução quando várias instâncias estiverem ativas. Pare o acompanhamento de logs em tempo real com Ctrl+C.

Diagnosticar uma implantação que falhou

Sintoma	Primeiras verificações
Falha na instalação ou compilação da dependência	Log de compilação, arquivo de lock, versão do ambiente de execução, comando de compilação e credenciais de dependências privadas.
A compilação funciona, mas a inicialização falha	Comando de início, caminho de saída, variáveis de ambiente necessárias e log de execução.
Falha na verificação de saúde	Porta configurada, interface de escuta, caminho de saúde, código de estado, prontidão da aplicação.
A URL gerada funciona, mas o domínio personalizado falha	Verificação de propriedade do domínio, destino DNS, TLS e rota atual.
A conexão com o banco de dados falha	Equipe, nome de hospedeiro privado, versão, credenciais, saúde do serviço, contexto região/rede.
A prévia difere da produção	Revisão do código-fonte, ambiente, manifesto, artefato de compilação e versão ativa.
A tarefa da IA está bloqueada	Erro de execução, conexão com o provedor, modelo selecionado, financiamento e aprovação pendente.

Confira o status da implantação solicitada e sua URL pública. Uma versão anterior saudável pode continuar atendendo requisições enquanto uma nova compilação falha.

Métricas e incidentes

Use as visualizações Observabilidade para inspecionar a telemetria disponível para esse workload e período. Confira as unidades exibidas, os horários das fontes e as lacunas antes de comparar requisições, CPU, memória ou outras medidas. Uma amostra ausente não representa uma medida de zero, e um ambiente de execução parado pode produzir dados de forma diferente de um ambiente ativo.

Ao investigar um incidente, relacione a implantação ou alteração do código-fonte aos logs de execução e ao período afetado. Mantenha segredos e dados privados de requisições fora de capturas de tela ou relatos públicos de problemas.

Compartilhar evidências úteis

Registre a equipe, workload, ID da compilação ou execução, região, horário aproximado em UTC, comando usado e a resposta de erro ou trecho de log. Inclua o comportamento esperado e um exemplo mínimo para reprodução. Remova tokens bearer, senhas, cookies e dados pessoais antes de compartilhar fora da equipe.

Para erros de status HTTP e paginação da API, consulte Erros da API. Para persistência e recuperação, consulte armazenamento.