Logs: compilações e requisições do seu site
Os logs dizem o que aconteceu e quando: cada criação e publicação do projeto, e cada requisição que executou o código do seu site no último dia. Use-os para descobrir por que um formulário, uma tarefa agendada ou uma página não está se comportando.
Dois tipos de registro
| Ver | O que ele mostra | Até quando no passado |
|---|---|---|
| Builds | Cada construção, alteração e publicação deste projeto, e as etapas por que cada uma passou. | As últimas 40 |
| Requests | As requisições e os erros do site, do mais recente ao mais antigo. | As últimas 24 horas, até 100 por vez |
As tarefas agendadas e os webhooks mantêm logs próprios, por trinta dias: Runs em Tarefas agendadas e Deliveries em Webhooks. As mensagens enviadas pelos seus formulários ficam em Settings, Forms.
Criações
Cada entrada diz o que foi pedido (com as palavras do pedido), quem pediu, quando e quanto tempo levou. Quando nenhuma pessoa iniciou, aparece Briks. À direita fica o status:
| Status | Significado |
|---|---|
| Waiting | Na fila, atrás de outros trabalhos. |
| Running | Em andamento agora. |
| Done | Concluído. |
| Failed | Parou antes do fim. |
| Stopped | Foi interrompido antes de terminar. |
Clique em uma entrada para ver suas etapas, cada uma com o horário em que aconteceu. Uma etapa que deu errado aparece em vermelho. Uma entrada com falha termina com: Não terminou. Nada mudou no site publicado, e nenhum crédito foi cobrado por isso.
Para ver o mesmo trabalho em tempo real, com a prévia ao lado, use o estúdio: veja Acompanhar uma criação.
Solicitações
Requests mostra as chamadas que executaram o código do seu próprio site: as rotas /api e as visitas às páginas enquanto um teste A/B divide os visitantes entre duas versões. Páginas comuns, imagens e arquivos são entregues como estão, por isso não aparecem. As mensagens enviadas por um formulário de contato também não aparecem, pois vão direto para a Briks, sem passar pelo código do seu site.
Cada linha mostra a hora, o método e o caminho (GET pede algo, POST envia algo), quanto tempo levou em milissegundos e o status com que o site respondeu, ou nenhuma resposta. As linhas que o próprio código do seu site escreveu mostram a mensagem e um nível, como error ou warning. Clique em uma linha para ver a mensagem completa, a data e o id da requisição.
| Status | O que significa |
|---|---|
| 2xx, como 200 | Funcionou. |
| 4xx, como 400 ou 404 | A solicitação foi recusada: algo estava faltando ou errado nela, ou não existe nada nesse caminho. |
| 5xx, como 500 | O código do site falhou ao responder. |
Filtros
| Filtro | Opções | Use para |
|---|---|---|
| Search | Qualquer texto: um caminho, uma mensagem, um id de requisição | Encontre uma rota ou um erro. |
| Level | All levels, Errors, Warnings | Mostrar só os problemas que o código relatou. |
| Status | Any status, Succeeded, 4xx, 5xx | Mostre apenas as requisições que foram recusadas ou que falharam. |
Defina-os e pressione Show. O endereço da página os guarda, então você pode salvar uma visualização filtrada nos favoritos. No requests in the last day significa que nada executou o código do site em 24 horas. Se a página disser Logs cannot be read right now, tente de novo em um minuto.
Diagnostique um formulário com falha
Procure a entrada
Onde: Settings, Forms
Toda mensagem enviada por um visitante fica guardada aqui, as últimas 100 na tela. Cada uma mostra quando chegou e de qual página, depois emailed, not emailed ou preview.
Se aparecer prévia
Onde: Settings, Forms
O site não foi publicado em produção, então as respostas são guardadas, mas não enviadas por email. Veja Publicar em produção.
Se aparece como enviado por e-mail, mas nada chegou
Onde: Your inbox
As entradas vão para a pessoa que criou o projeto ou, se ela tiver saído, para o primeiro Owner do espaço de trabalho. Confira essa caixa de entrada, inclusive a pasta de spam.
Se ele não estiver lá
Onde: The live site
A mensagem não chegou ao Briks. Envie uma você mesmo. Se o formulário responder que foram enviadas mensagens demais daqui, um limite foi atingido: até 5 mensagens de um visitante em 10 minutos e até 300 por dia para o site.
Se outra ferramenta deve ficar com ele
Onde: Settings, Webhooks, Deliveries
Defina Status como Failed e pressione Show. Abra a entrega para ler o que a outra ferramenta respondeu e use Send again depois de corrigir.
Diagnosticar uma tarefa agendada com falha
Ler a execução
Onde: Settings, Scheduled tasks, Runs
Abra a execução que falhou. Ela mostra o que o endereço respondeu, como answered 500, e o início da resposta.
Encontre o erro
Onde: Settings, Logs, Requests
Se a tarefa chama uma rota do seu site, busque pelo caminho dela, como
/api/daily-summary, e defina Level como Errors. A mensagem diz o que deu errado no código.Peça a correção
Onde: Studio
Cole o erro no chat do estúdio com uma frase sobre a tarefa: A rota do resumo diário falha com este erro toda manhã. Veja Fazer alterações.
Tente de novo
Onde: Settings, Scheduled tasks
Depois que a correção é publicada, abra os três pontos da tarefa e escolha Run now. O resultado aparece na hora.
Uma execução marcada como Skipped não falhou: as chamadas do dia do projeto acabaram. As execuções voltam depois da meia-noite UTC. Os limites dos planos estão na página Tarefas agendadas.
Diagnosticar uma página lenta
Requests mede tudo o que executa o código do seu site, então é onde olhar quando uma página que carrega o conteúdo pelas rotas do site parece lenta. Apps e dashboards costumam funcionar assim.
Abra a página e anote a hora
Onde: The live site
Carregue você mesmo a página lenta uma vez, para que as requisições dela estejam entre as mais recentes.
Leia os horários
Onde: Settings, Logs, Requests
Olhe os milissegundos ao lado de cada requisição feita naquele momento. Uma rota levando vários segundos enquanto as outras levam algumas centenas de milissegundos é a culpada.
Restrinja a busca
Onde: Settings, Logs, Requests
Procure o caminho dessa rota para ver se ela é sempre lenta ou só às vezes, e se Warnings ou Errors aparecem ao lado dela.
Peça uma correção
Onde: Studio
Diga ao estúdio qual rota está lenta e o quanto, junto com a página que ela serve.
Se nada lento aparecer, a demora não está no código do seu site. As páginas, as imagens e os arquivos são entregues como estão, então olhe o que a página carrega, como imagens grandes ou um vídeo, e descreva no estúdio o que parece lento.
Exemplo prático: um app de reservas que parou de salvar
Nenhuma reserva nova chegava desde a manhã, embora o telefone não parasse de tocar com pessoas dizendo que o formulário não fazia nada.
Em Requests, com Status definido como 5xx, todo POST /api/bookings desde as 9:12 respondeu 500. A linha de erro ao lado dizia que faltava um campo obrigatório.
Desde esta manhã, toda reserva falha com um erro 500 em /api/bookings. O log diz que o campo de porte do pet está ausente. Removemos esse campo do formulário ontem.
A alteração foi publicada, e a próxima reserva em Requests respondeu 200.