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 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.
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.
A guia Registros de um back-end permite visualizar e filtrar "Registros de build" (do Cloud Build) e "Registros de execução" (do Cloud Run e Cloud CDN).
Cada back-end também tem uma guia Uso com vários gráficos de uso para atividade e uso do app. Os dados representados incluem largura de banda e solicitações de CDN, utilização de CPU e memória do Cloud Run e muito mais.
É possível encontrar outras métricas de utilização do Cloud Run (como utilização de CPU e memória) no console do Google Cloud.
Ver registros no console
No menu de contexto do console Firebase (um menu de três pontos no canto superior direito) de um lançamento, você pode acessar rapidamente os detalhes e erros da revisão Cloud Run bem como os registros de build.
Esses registros contêm informações úteis para depurar suas App Hosting
implantações. Por exemplo, o Cloud Run registro 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 no framework ou na
App Hosting configuração. Ele também mostra as configurações básicas de runConfig settings,
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 no Cloud Logging
Se você quiser registrar eventos personalizados, poderá gravar em Cloud Logging de
Cloud Run, onde o código renderizado pelo servidor é executado. Use chamadas de geração de registros JavaScript padrão, como console.log e console.error. Por exemplo,
para gravar uma entrada personalizada do código para um
gerenciador de rotas do Next.js,
faça algo como:
- 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 é transmitido para Cloud Logging no
código renderizado pelo servidor do app. Os eventos relacionados à renderização estática são enviados
para os registros do Cloud Build, enquanto a renderização do servidor é enviada para os registros do Cloud Run.
Ver erros do servidor
O Cloud Error Reporting consolida erros da instância App Hosting Cloud Run. Opcionalmente, é possível configurar o Cloud Error Reporting para enviar uma notificação quando novos erros surgirem.