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 os 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 registros Cloud 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 Cloud 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.
O 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 métricas no console
No console Firebase, é possível acessar as métricas de tráfego e utilização do serviço Cloud Run que alimenta seu app da Web.
No menu de contexto do console Firebase (um menu de três pontos no canto superior direito) para o lançamento atual, selecione Ver métricas Cloud Run. Você poderá monitorar o número de solicitações que chegam ao serviço do Cloud Run, incluindo a decomposição por código de resposta para entender a taxa de erros do app.
Você também vai encontrar métricas de latência de solicitação e utilização do contêiner (como utilização da CPU e da memória) para entender a performance e a escalonabilidade do app.
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.