A geração de registros e as métricas são ferramentas importantes para depurar e monitorar códigos. O App Hosting oferece acesso rápido para conferir logs e métricas dos serviços do Google Cloud que alimentam seu app da Web: Cloud Run, Cloud Build e Cloud CDN.
Usando a sintaxe de geração de registros padrão, como console.log do Node.js, é possível gravar entradas de registro em Cloud Logging.
Conferir 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.
Cada back-end também tem uma guia Usage com vários gráficos de uso para a atividade e o uso do app. Os dados representados incluem a largura de banda e as solicitações do CDN, a CPU e a utilização da memória do Cloud Run e muito mais.
Você pode encontrar outras métricas de utilização do Cloud Run (como a utilização da CPU e da memória) no console do Google Cloud.
Conferir registros no console
No menu de contexto do console Firebase (um menu de três pontos no canto superior direito) para um lançamento, você pode ter acesso rápido para conferir os detalhes e erros da revisão Cloud Run, bem como os logs de build.
Esses registros contêm informações úteis para depurar implantações de App Hosting. Por exemplo, o registro Cloud Run registra quando package.json
não é encontrado.
O registro de build mostra a saída do build, permitindo que você classifique
se os erros ocorreram na configuração do framework ou na
configuração App Hosting. Ele também mostra suas configurações básicas de runConfig
e indica quando as configurações estão ausentes 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 você quiser registrar eventos personalizados, escreva 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 do código para um
gerenciador de rota do Next.js,
faça o seguinte:
- 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.
console.log é transmitido para Cloud Logging no código
renderizado pelo servidor do app. Os eventos relacionados à renderização estática são enviados
para registros Cloud Build, enquanto a renderização do servidor é enviada para registros
Cloud Run.
Conferir erros do servidor
O Cloud Error Reporting consolida os erros da sua instância App Hosting Cloud Run. Você pode configurar o Error Reporting para notificar você quando novos erros surgirem.