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 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 ambiente de execução" (do Cloud Run e do Cloud CDN).
Cada back-end também tem uma guia Uso com vários gráficos de uso para atividade e uso do seu app. Os dados representados incluem largura de banda e solicitações da CDN, Cloud Run uso de CPU e uso da memória, e muito mais.
É possível encontrar outras métricas de utilização para Cloud Run (como uso da CPU e da memória) no console do Google Cloud.
Ver registros no console
No menu de contexto do console do Firebase (um menu de três pontos no canto superior direito) para um lançamento, é possível acessar rapidamente os detalhes e erros da revisão do Cloud Run, além de criar registros.
Esses registros contêm informações úteis para depurar as implantações do App Hosting. Por exemplo, o registro Cloud Run indica quando package.json
não é encontrado.
O registro de build mostra a saída do build, permitindo que você faça uma triagem
para saber se ocorreram erros na configuração do framework ou na
configuração do App Hosting. Ele também mostra as 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, grave em Cloud Logging de
Cloud Run, onde o código renderizado pelo servidor é executado. Use chamadas de geração de registros padrão em JavaScript, como console.log e console.error. Por exemplo,
para gravar uma entrada personalizada do código para um
manipulador de rota do Next.js,
faça algo como:
export async function GET(request) {
console.log("Handling GET request");
return Response.json({ message: "Hello, world!" });
}
- 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 é canalizado 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 de servidor
O Cloud Error Reporting consolida os erros da instância do App Hosting Cloud Run. Se quiser, configure o Cloud Error Reporting para notificar você quando novos erros surgirem.