VM 拡張機能のログを表示する

VM Extension Manager を使用して Compute Engine インスタンス（VM）の拡張機能を管理する場合、各 VM のゲスト エージェントは拡張機能の適用に関するイベントをログに記録します。 Cloud Logging を使用して、ログ エクスプローラでこれらのログを表示し、VM 拡張機能に関する問題をモニタリングして トラブルシューティングします。

始める前に

VM 拡張機能のログを表示する

VM 拡張機能のログを表示するには、 Google Cloud コンソール、Google Cloud CLI、または REST を使用します。

コンソール

  1. Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。

    [ログ エクスプローラ] に移動

  2. [クエリ] フィールドに次のクエリを入力します。

    resource.type="gce_instance"
resource.labels.instance_id="INSTANCE_ID"
jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent"
jsonPayload.extensionName="EXTENSION_NAME"
timestamp >= START_TIME
timestamp <= END_TIME

    次のように置き換えます。

    • INSTANCE_ID: VM インスタンスの ID。
    • EXTENSION_NAME: 拡張機能の名前（ops-agent など）。
    • START_TIME: 時間範囲の開始（2024-01-01T00:00:00Z など）。
    • END_TIME: 時間範囲の終了（2024-02-01T00:00:00Z など）。

    クエリの例:

    resource.type="gce_instance"
resource.labels.instance_id="projects/7654321/zones/us-central1-a/instances/123456"
jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent"
jsonPayload.extensionName="ops-agent"
timestamp >= "2024-01-01T00:00:00Z"
timestamp <= "2024-02-01T01:00:00Z"

  3. [クエリを実行] をクリックします。

gcloud

VM 拡張機能のログを検索するには、logging read コマンドを使用します。次に例を示します。

gcloud logging read 'resource.type="gce_instance" AND \
    resource.labels.instance_id="INSTANCE_ID" AND \
    jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" AND \
    jsonPayload.extensionName="YOUR_EXTENSION_NAME" AND \
    timestamp >= "START_TIME" AND \
    timestamp <= "END_TIME"'

次のように置き換えます。

  • INSTANCE_ID: VM インスタンスの ID。
  • YOUR_EXTENSION_NAME: 拡張機能の名前（ops-agent など）。
  • START_TIME: 時間範囲の開始（2024-01-01T00:00:00Z など）。
  • END_TIME: 時間範囲の終了（2024-02-01T00:00:00Z など）。

REST

Logging V2 API へのリクエストを発行します。リクエストの本文には filter パラメータを含める必要があります。次に例を示します。

POST https://logging.googleapis.com/v2/entries:list

{
  "filter": "resource.type="gce_instance" AND
            "resource.labels.instance_id="INSTANCE_ID" AND
            "jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" AND
            "jsonPayload.extensionName="EXTENSION_NAME" AND
            "timestamp >= "START_TIME" AND
            "timestamp <= "END_TIME",
  "pageSize": 10,
  "resourceNames": [
    "projects/PROJECT_ID"
  ]
}

次のように置き換えます。

  • INSTANCE_ID: VM インスタンスの ID。
  • EXTENSION_NAME: 拡張機能の名前（ops-agent など）。
  • START_TIME: 時間範囲の開始（2024-01-01T00:00:00Z など）。
  • END_TIME: 時間範囲の終了（2024-02-01T00:00:00Z など）。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。

VM 拡張機能イベントのログエントリ

VM 拡張機能イベントのログエントリの例を次に示します。

{
  "insertId": "rsiudxbck",
  "jsonPayload": {
    "eventMessage": "Enforcement State: Installing ops-agent@4bda61add3e5c989.; Extension Health: Plugin is running ok",
    "timestamp": "2026-03-23T16:13:40.496755675Z",
    "extensionName": "ops-agent",
    "revisionId": "4bda61add3e5c989",
    "@type": "type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent",
    "eventType": "INSTALLED"
  },
  "resource": {
    "type": "gce_instance",
    "labels": {
      "project_id": "27654321",
      "instance_id": "projects/7654321/zones/us-west1-a/instances/1234567",
      "zone": "us-west1-a"
    }
  },
  "timestamp": "2026-03-23T16:13:40.496854498Z",
  "severity": "INFO",
  "logName": "projects/my-project/logs/compute.googleapis.com%2Fvm_extension_policies",
  "receiveTimestamp": "2026-03-23T16:13:40.906133199Z"
}

ログエントリの詳細

次の表に、VM 拡張機能のログに表示されるパラメータを示します。

フィールド 説明
eventMessage 適用状態や拡張機能のヘルスなど、イベントを説明するメッセージ。
extensionName 拡張機能の名前（ops-agent など）。

サポートされている拡張機能とその名前の一覧については、サポートされている拡張機能をご覧ください。
extensionVersion インストール用に選択された拡張機能のバージョン。 このバージョンは、拡張機能ポリシーで固定されているバージョンか、固定されていない場合は 最新バージョンです。
revisionId 拡張機能バージョンの特定のバイナリ。各拡張機能バージョンには、さまざまなオペレーティング システムをサポートするための複数のリビジョンを含めることができます。Google は、特定の VM に適したリビジョンを自動的に選択します。このリビジョン ID を Google サポートチームに提供すると、VM に適切なバイナリが選択されたかどうかをデバッグできます。
eventType イベントのタイプ。次のいずれかの値になります。
  • CRASHED: 拡張機能がクラッシュしました。この値は、拡張機能が一度インストールされて正常に起動したが、その後実行を停止したことを示します。
  • INSTALL_FAILED: 拡張機能のインストールに失敗しました。
  • INSTALLED: 拡張機能がインストールされ、正常に起動しました。
  • ROLLBACK_FAILED: 拡張機能のロールバックに失敗しました。
  • ROLLED_BACK: 拡張機能のロールバックが成功しました。
  • INCOMPATIBLE: 拡張機能リビジョンの候補のいずれも、インストール要件（オペレーティング システムやアーキテクチャなど）を満たしていません。
  • SERVICE_DISABLED: この拡張機能を必要とするサービスが無効になっています。