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

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

始める前に

  • VM Extension Manager のドキュメントを読む。
  • ログ エクスプローラの使用方法を確認します。
  • まだ設定していない場合は、認証を設定します。認証では、 Google Cloud サービスと API にアクセスするための ID が確認されます。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。

    このページのサンプルをどのように使うかに応じて、タブを選択してください。

    コンソール

    Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。

    gcloud

    1. Google Cloud CLI をインストールします。インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。

      gcloud init

      外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

  • デフォルトのリージョンとゾーンを設定します。

    • REST

    このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

      Google Cloud CLI をインストールします。

      外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

    詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

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="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": "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: この拡張機能を必要とするサービスが無効になっています。