アプリケーション ログの書き込み

App Engine で実行中のアプリケーションにリクエストが送信されると、リクエストとレスポンスの詳細が自動的に記録されます。これらの情報は、Google Cloud Platform Console の Stackdriver ログビューアで確認できます。

ログの保持ポリシーとログエントリの最大サイズについては、割り当てポリシーをご覧ください。ログを長期にわたって保存する場合は、Cloud Storage にログをエクスポートできます。また、BigQuery や Pub/Sub にエクスポートする場合は、ログに対してさらに処理を行うこともできます。

使用可能なログのリストについては、App Engine スタンダード環境ログをご覧ください。

アプリケーション ログの書き込み

アプリケーションがリクエストを処理するときに、そのロギング メッセージを stdoutstderr に書き込むことができます。出力には stdout、エラーには stderr を使用して、アプリケーション ログを作成します。これらのファイルは自動的に収集され、ログビューアで表示できます。この場合、ログビューアのフィルタリングに使用可能なログレベルは提供されません。ただし、ログビューアにはテキストやタイムスタンプなどの他のフィルタが用意されています。サイズを制限するために、ログビューアでは最新のエントリだけが保持されます。

Node.js アプリからログ項目を出力するには、次のログレベルの console.log() 関数または console.error() 関数を使用します。

  • console.log() が出力する項目のログレベルは INFO
  • console.error() が出力する項目のログレベルは ERROR
  • 内部システム メッセージのログレベルは DEBUG

Node.js アプリでは、オプションで Bunyan または Winston プラグインを使用するか、Node.js 用の Stackdriver Logging クラウド クライアント ライブラリを直接使用することができます。詳細については、Node.js 用 Stackdriver Logging の設定をご覧ください。

アプリケーション ログの表示

アプリケーションのログを表示するには、ログビューアを使用します。

  1. GCP Console で [Stackdriver] > [ロギング] ページの順に移動します。

    ログビューア ページに移動

  2. ページ上部で、既存の GCP プロジェクトを選択します。

  3. プルダウンメニューから、リソースタイプとして [GAE アプリケーション] を選択して App Engine ログを表示します。

ログビューアのプルダウン メニューやその他のコンポーネントを使用して、関連するエントリのログをフィルタリングしたり検索したりできます。詳細については、ログビューアのフィルタ インターフェースをご覧ください。

アプリケーション ログのフィルタリング

ログビューアでラベル検索またはテキスト検索を使用してログエントリをフィルタリングする方法については、基本ログフィルタをご覧ください。

高度なログフィルタを作成して一連のログエントリを詳細に指定する方法については、高度なログフィルタをご覧ください。

特定のインスタンス、サービス、バージョンに関するログを表示するには、ログビューアで当該リソースの ID を指定してログをフィルタリングします。サービス ID とバージョン ID は、App Engine ダッシュボードで確認できます。

ログビューアでは、同じ trace によって相互に関連付けられたログエントリを親子関係の形式で表示できます。

ログエントリを相互に関連付ける手順については、GitHub のドキュメントをご覧ください。

ログエントリを相互に関連付けた後、次の手順で関連するログエントリを表示します。

  1. ログビューアで App Engine ログを開きます。詳細は、アプリケーション ログの表示をご覧ください。

  2. ログエントリの左にある小さな黒い三角をクリックして request ログを展開します。request ログとアプリログがネストされた形式で表示されます。

補足:

  • 親子関係の子に相当するログエントリの最も高い severity が最上位のエントリに自動的には適用されることはありません。この動作を望む場合は、最も高い severity を最上位のエントリに手動で設定してください。
  • 最上位のログの httpRequest.requestUrl フィールドを設定してください。
このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

Node.js 用 App Engine スタンダード環境に関するドキュメント