ログと指標の表示

ロギングと指標は、コードのデバッグとモニタリングに重要なツールです。 App Hosting を使用すると、ウェブアプリを強化する Google Cloud サービス( Cloud RunCloud Build、Cloud CDN)のログと指標にすばやくアクセスできます。

Node.js の console.log などの標準のロギング構文を使用して、Cloud Logging にログ エントリを書き込むことができます。

コンソールで使用状況を表示する

各バックエンドには [概要] タブがあり、過去 7 日間のアプリのトラフィック(リクエスト数)とエラー率の概要が表示されます。

バックエンドの [ログ] タブでは、「ビルドログ」 (Cloud Build から)と「ランタイムログ」(Cloud Run と Cloud CDN から)を表示してフィルタできます。

各バックエンドには [使用量] タブもあり、アプリのアクティビティと使用量のグラフがいくつか表示されます。表示されるデータには、CDN の帯域幅とリクエスト、Cloud Run CPU とメモリの使用率などが含まれます。

Cloud Run のその他の使用率指標(CPU 使用率やメモリ使用率など)は、Google Cloud コンソールで確認できます。

コンソールでログを表示する

Firebase コンソールのコンテキスト メニュー(右上の 3 つのドットのメニュー)から、 ロールアウトの Cloud Run リビジョン の詳細とエラー、ビルドログにすばやくアクセスできます。

これらのログには、App Hosting デプロイのデバッグに役立つ情報が含まれています。たとえば、Cloud Run ログには、package.json が見つからない場合の情報が記録されます。

ビルドログにはビルドの出力が表示されるため、フレームワークの構成でエラーが発生したのか、 構成でエラーが発生したのかをトリアージできます。App Hostingまた、基本的な runConfig 設定も表示され、設定が欠落している場合や apphosting.yaml が存在しない場合も示されます。

> 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

Cloud Logging にログを書き込む

カスタム イベントをロギングする場合は、サーバーサイド レンダリング コードが実行される Cloud RunからCloud Loggingに書き込むことができます。console.logconsole.error などの標準の JavaScript ロギング呼び出しを使用します。たとえば、 Next.js ルート ハンドラのコードからカスタム エントリを書き込むには、 次のようにします。

  • console.log() コマンドのログレベルは INFO です。
  • console.info() コマンドのログレベルは INFO です。
  • console.warn() コマンドのログレベルは ERROR です。
  • console.error() コマンドのログレベルは ERROR です。
  • 内部システム メッセージのログレベルは DEBUG です。

console.log は、アプリの サーバーサイド レンダリング コードで Cloud Logging にパイプ処理されます。静的レンダリングに関連するイベントは Cloud Build ログに送信され、サーバーサイド レンダリングは Cloud Run ログに送信されます。

サーバーエラーを表示する

Cloud Error Reporting は、App Hosting Cloud Run インスタンスのエラーを統合します。 必要に応じて、 新しいエラーが発生したときに通知するように Cloud Error Reporting を構成できます