A geração de registros e as métricas são ferramentas importantes para depurar e monitorar códigos. App Hosting oferece acesso rápido para visualizar registros e métricas dos serviços Google Cloud que alimentam seu app da Web: Cloud Run, Cloud Build e Cloud CDN.
Usando a sintaxe padrão de geração de registros, como console.log do Node.js, é possível gravar entradas de registro em Cloud Logging.
Ver o uso no console
Cada back-end tem uma guia Visão geral, com um resumo do tráfego do app (contagem de solicitações) e da taxa de erros nos últimos sete dias.
Na guia Registros de um back-end, é possível ver e filtrar "Registros de build" (de Cloud Build) e "Registros de tempo de execução" (de Cloud Run e do Cloud CDN).
Cada back-end também tem uma guia Uso com vários gráficos de uso para atividade e uso do seu app. Os dados representados incluem largura de banda e solicitações da CDN, utilização de CPU e memória Cloud Run e muito mais.
Você encontra outras métricas de utilização para Cloud Run (como utilização da CPU e da memória) no console do Google Cloud.
Ver registros no console
No menu de contexto do console Firebase (um menu de três pontos na parte superior direita) de um lançamento, você pode acessar rapidamente os detalhes e erros da revisão Cloud Run e os registros de build.
Esses registros contêm informações úteis para depurar suas implantações do App Hosting. Por exemplo, o registro Cloud Run observa quando package.json
não é encontrado.
O registro de build mostra a saída do build, permitindo que você trie
se ocorreram erros na configuração do framework ou na configuração
do App Hosting. Ele também mostra suas configurações básicas de runConfig e indica quando as configurações estão faltando ou quando apphosting.yaml não existe:
> next build
▲ Next.js 14.1.4
- Environments: .env
...
Route (app) Size First Load JS
┌ λ / 4.79 kB 214 kB
├ λ /_not-found 882 B 85.3 kB
└ λ /restaurant/[id] 5.28 kB 207 kB
+ First Load JS shared by all 84.4 kB
├ chunks/69-6678c81190a8fe82.js 29 kB
├ chunks/fd9d1056-51920e345d2966e8.js 53.4 kB
└ other shared chunks (total) 1.98 kB
Gravar registros em Cloud Logging
Se quiser registrar eventos personalizados, grave em Cloud Logging de
Cloud Run, onde o código renderizado pelo servidor é executado. Use chamadas de geração de registros padrão do JavaScript, como console.log e console.error. Por exemplo, para gravar uma entrada personalizada de código para um gerenciador de rotas do Next.js, faça algo assim:
- Os comandos
console.log()têm o nível de registro INFO. - Os comandos
console.info()têm o nível de registro INFO. - Os comandos
console.warn()têm o nível de registro ERROR. - Os comandos
console.error()têm o nível de registro ERROR. - As mensagens internas do sistema têm o nível de registro DEBUG.
Observe que console.log transmite para Cloud Logging no código renderizado pelo servidor do seu app. Os eventos relacionados à renderização estática são enviados para os registros Cloud Build, enquanto a renderização do servidor é enviada para os registros Cloud Run.
Ver erros do servidor
O Cloud Error Reporting consolida erros da sua instância App Hosting Cloud Run. Você pode configurar o Cloud Error Reporting para notificar quando novos erros surgirem.