このドキュメントでは、Cloud Logging バケットに転送されたログエントリを見つける方法について説明します。ログバケットは、ログデータを保持する Google Cloud プロジェクトの Cloud Logging ストレージ コンテナです。ログシンクを作成して、ログのすべてまたは一部を Cloud Logging の任意のバケットに転送できます。この柔軟性により、ログを保存する Google Cloud プロジェクトと、ログとともに保存する他のログを選択できます。
Cloud Logging バケットに転送されたログはすぐに使用できます。
他の宛先に転送されたログを表示する方法については、次のドキュメントをご覧ください。
始める前に
ログバケットの作成と管理の方法については、次のドキュメントをご覧ください。
シンクのコンセプトについては、転送と保存のモデルの概要: シンクをご覧ください。
ログを転送する方法については、サポートされている宛先にログを転送するをご覧ください。
ログを表示する
ログバケット内の個々のログエントリのトラブルシューティングと表示を行う手順は次のとおりです。
-
Google Cloud コンソールで [ログ エクスプローラ] ページに移動します。
このページを検索バーで検索する場合は、小見出しが「Logging」の結果を選択します。
- [アクション] ツールバーで [範囲を絞り込む] を選択します。
- [範囲を絞り込む] ダイアログで、[ログビュー] を選択します。
ログビューを 1 つ以上選択し、[適用] をクリックします。
クエリの実行方法については、ログ エクスプローラでクエリを作成するをご覧ください。
ログ分析を使用するようにアップグレードされたログバケットに保存されているログエントリに対して分析を行うには、次の操作を行います。
-
Google Cloud コンソールで、[ログ分析] ページに移動します。
このページを検索バーで検索する場合は、小見出しが「Logging」の結果を選択します。
[ログビュー] リストで、ビューを見つけて、[クエリ] を選択します。[クエリ] ペインには、クエリ対象のログビューを含むデフォルトのクエリが入力されます。
[クエリ] ペインでクエリを入力することや、表示されているクエリを編集することもできます。
ログバケット内のすべてのログをクエリするには、ログバケットの
_AllLogsビューを選択します。ツールバーで、[クエリを実行] をクリックします。
クエリが実行され、クエリの結果が [結果] タブに表示されます。
ツールバー オプションを使用して、クエリをフォーマットし、クエリを消去して、BigQuery SQL リファレンス ドキュメントを開くことができます。
クエリの実行方法については、ログ分析でログをクエリして表示するをご覧ください。
ログエントリの構成
Logging のログエントリは、LogEntry 型のオブジェクトです。
LogEntry リファレンスで [LOG_ID] と呼ばれる同じログタイプのログエントリは、通常同じ形式です。次の表にログエントリの例を示します。
syslog
Compute Engine の syslog の例を次に示します。
{ insertId: "4zymupf98ac6v" jsonPayload: { message: "Jul 15 13:36:33 my-instance dhclient[328]: DHCPACK of 10.240.0.48 from 169.254.169.254" } logName: "projects/my-gcp-project-id/logs/syslog" receiveTimestamp: "2024-07-15T13:36:33.400534415Z" resource: { labels: { instance_id: "0123456789" (instance_name: my-instance) project_id: "my-gcp-project-id" zone: "us-central1-a" } type: "gce_instance" } timestamp: "2024-07-15T13:36:33.097822178Z" } request_log
App Engine request_log のログエントリには、RequestLog 型のオブジェクトを持つ protoPayload フィールドがあります。
{ httpRequest: { status: 200 } insertId: "669525c0000d39d1eab2bb03" labels: {1} logName: "projects/my-gcp-project-id/logs/appengine.googleapis.com%2Frequest_log" operation: {4} protoPayload: { @type: "type.googleapis.com/google.appengine.logging.v1.RequestLog" appEngineRelease: "1.9.71" appId: "s~my-gcp-project-id" startTime: "2024-07-15T13:36:00.861387Z" ... } receiveTimestamp: "2024-07-15T13:36:01.169966997Z" resource: {2} spanId: "7925702051311044593" timestamp: "2024-07-15T13:36:00.861387Z" trace: "projects/my-gcp-project-id/traces/8a4fab4bd4fbafac2a0fa901c1485847" resource: { labels: { module_id: "default" project_id: "my-gcp-project-id" version_id: "20200221t133337" zone: "us14" } type: "gae_app" } } activity
activity ログは管理アクティビティの監査ログです。そのペイロードは、AuditLog 型の JSON 表現です。
{ insertId: "dlu8qwc69c" labels: { compute.googleapis.com/root_trigger_id: "a97f30b1-45ab-4c12-9309-8e8af3bb011f" } logName: "projects/my-gcp-project-id/logs/cloudaudit.googleapis.com%2Factivity" operation: { id: "operation-1721047950764-61d48b3bf2b65-1ba1f256-82e9b5fd" last: true producer: "compute.googleapis.com" } protoPayload: { @type: "type.googleapis.com/google.cloud.audit.AuditLog" authenticationInfo: {...} methodName: "v1.compute.instances.insert" request: {...} requestMetadata: {...} resourceName: "projects/my-gcp-project-id/zones/us-central1-f/instances/my-instance" serviceName: "compute.googleapis.com" } receiveTimestamp: "2024-07-15T12:52:41.376292847Z" resource: { labels: { instance_id: "2891866457752773984" (instance_name: my-instance) project_id: "my-gcp-project-id" zone: "us-central1-f" } type: "gce_instance" } severity: "NOTICE" timestamp: "2024-07-15T12:52:40.965840Z" } トラブルシューティング
シンクの宛先にログがないように見える場合や、シンクがログを正しく転送していないと思われる場合は、転送とシンクのトラブルシューティングをご覧ください。
料金
Cloud Logging では、サポートされている宛先へのログの転送で料金を請求されることはありませんが、宛先で料金が発生する場合があります。_Required ログバケットを除き、Cloud Logging では、ログバケットへのログのストリーミングと、ログバケットのデフォルト保持期間よりも長い保存に対して料金が請求されます。
Cloud Logging では、ログのコピー、ログスコープまたは分析ビューの作成、ログ エクスプローラまたはログ分析のページから発行されたクエリには課金されません。
詳細については、次のドキュメントをご覧ください。
- Google Cloud Observability の料金ページの Cloud Logging セクション。
ログデータを他の Google Cloud サービスに転送する場合の費用:
- VPC フローログの生成料金は、Cloud Logging から Virtual Private Cloud フローログを送信して除外した後に適用されます。