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 visualizar registros e métricas da Serviços em nuvem que potencializam seu app da Web: Cloud Run, Cloud Build e Cloud CDN.
Usar a sintaxe de geração de registros padrão, como Node.js console.log, é possível gravar
entradas para Cloud Logging.
Mostrar registros no console
No menu de contexto do console do Firebase (um menu de três pontos no canto superior direito) para uma lançamento, tenha acesso rápido à revisão Cloud Run e erros, além de registros Cloud Build.
Esses registros contêm informações úteis para depurar o App Hosting
implantações. Por exemplo, o registro Cloud Run observa quando package.json
não foi encontrado.
O registro Cloud Build exibe a saída do build, permitindo que você faça a triagem
se ocorreram erros na configuração do framework ou
App Hosting. Ela também mostra as configurações básicas do runConfig,
e indica quando as configurações estão ausentes ou quando apphosting.yaml não
existente:
> 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 usando
Cloud Run, em que o código renderizado pelo servidor é executado. Usar padrão
Chamadas de geração de registros JavaScript, como console.log e console.error. Por exemplo:
para criar uma entrada personalizada a partir do código
Gerenciador de rotas 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 canaliza para Cloud Logging na
código renderizado pelo servidor para seu app. Eventos relacionados à renderização estática são enviados
para registros Cloud Build, enquanto a renderização do servidor é enviada para Cloud Run
ou de sistemas operacionais de contêineres.
Conferir métricas no console
No console do Firebase, é possível acessar as métricas de tráfego e utilização de o serviço Cloud Run que alimenta seu app da Web.
No menu de contexto do console do Firebase (um menu de três pontos no canto superior direito) para a lançamento atual, selecione Ver Cloud Run métricas. Você será capaz de monitorar o número de solicitações que chegam ao serviço do Cloud Run, incluindo detalhamento por código de resposta para entender a taxa de erro do seu app.
Você também vai encontrar a latência da solicitação e métricas de uso do contêiner (como e uso de memória) para entender o desempenho do app e escalonabilidade.
Ver erros do servidor
Cloud Error Reporting consolida erros da sua instância App Hosting Cloud Run. Também é possível configurar Cloud Error Reporting para notificar você quando surgem novos erros.