Visualizar registros e métricas

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 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.

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 da CDN, utilização de CPU e memória do Cloud Run e muito mais.

No console do Google Cloud, você encontra outras métricas de utilização do Cloud Run, como utilização da CPU e da memória.

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 informa 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, 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 de código para um processador 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.