VM 拡張機能をモニタリングする

このドキュメントでは、Cloud Monitoring を使用して、Compute Engine インスタンスで VM Extension Manager によって管理されている VM 拡張機能をモニタリングする方法について説明します。拡張機能の健全性とリソース消費量をモニタリングすると、CPU とメモリ使用量を追跡し、VM フリート全体でインストールまたはランタイムの障害を検出できます。

このドキュメントでは、次のタスクを行う方法を学びます。

始める前に

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

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

    コンソール

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

    gcloud

    1. Google Cloud CLI をインストールし、フェデレーション ID を使用して gcloud CLI にログインします。ログイン後、次のコマンドを実行して Google Cloud CLI を初期化します。

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

    • REST

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

      Google Cloud CLI をインストールし、フェデレーション ID を使用して gcloud CLI にログインします。

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

始める前に

拡張機能をモニタリングする前に、次の前提条件を満たしていることを確認してください。

必要な IAM 権限

指標のモニタリング、ダッシュボードの作成、アラート ポリシーの構成に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

指標のモニタリング、ダッシュボードの作成、アラート ポリシーの構成に必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

  • 指標とダッシュボードを表示する: プロジェクトに対するモニタリング閲覧者（roles/monitoring.viewer）
  • ダッシュボードとアラート ポリシーを作成して管理する: プロジェクトに対するモニタリング編集者（roles/monitoring.editor）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

これらの事前定義ロールには、指標のモニタリング、ダッシュボードの作成、アラート ポリシーの構成に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

指標のモニタリング、ダッシュボードの作成、アラート ポリシーの構成を行うには、次の権限が必要です。

  • ダッシュボードを表示する: プロジェクトの monitoring.dashboards.get
  • ダッシュボードを作成する: プロジェクトの monitoring.dashboards.create
  • アラートを設定する: プロジェクトの monitoring.alertPolicies.create

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

VM 拡張機能で使用可能な指標

Monitoring で VM 拡張機能をモニタリングするために、次の指標を使用できます。

指標名 指標タイプ 説明
VM 拡張機能の適用ステータス compute.googleapis.com/vm_extensions/extension/enforcement_status Compute Engine VM 拡張機能の適用ステータス。ラベルには extension_name と status が含まれます。

拡張機能名の一覧については、サポートされている拡張機能をご覧ください。

status に指定できる値は次のとおりです。

  • ENFORCEMENT_STATE_UNSPECIFIED
  • INSTALLING
  • INSTALL_FAILED
  • INSTALLED
  • ROLLING_BACK
  • ROLLBACK_FAILED
  • ROLLED_BACK
  • INCOMPATIBLE
  • REMOVING
  • SERVICE_DISABLED
  • APPLYING_CONFIG
VM 拡張機能のヘルス ステータス compute.googleapis.com/vm_extensions/extension/health_status VM 拡張機能のヘルス ステータス。ラベルには extension_name と status が含まれます。

拡張機能名の一覧については、サポートされている拡張機能をご覧ください。

status に指定できる値は次のとおりです。

  • HEALTH_STATUS_UNSPECIFIED
  • STARTING
  • RUNNING
  • STOPPING
  • STOPPED
  • CRASHED
VM 拡張機能の最大 CPU 使用率 compute.googleapis.com/vm_extensions/extension/cpu/max_usage VM 拡張機能が使用する最大 CPU 時間（%）。
VM 拡張機能の最大メモリ使用バイト数 compute.googleapis.com/vm_extensions/extension/memory/used_bytes VM 拡張機能が使用する最大メモリ（バイト単位）。

カスタム モニタリング ダッシュボードを作成する

ユースケースに最も関連性の高い VM 拡張機能グラフを含む Monitoring ダッシュボードを構築できます。ダッシュボードにグラフを追加するには、次の操作を行います。

  1. Google Cloud コンソールで [Monitoring] を選択します。

    [Monitoring] に移動

  2. ナビゲーション パネルで [ダッシュボード] を選択します。
  3. [CREATE DASHBOARD] をクリックします。
  4. [ウィジェットを追加] をクリックします。
  5. [ウィジェットを追加] ウィンドウで、[Data] として [指標] を選択します。
  6. 指標を選択するには、[指標を選択] メニューを開き、次の操作を行います。
    1. [有効なリソース] で [VM インスタンス] を選択します。
    2. [指標カテゴリ] で、[Vm_extensions] を選択します。
    3. [指標] で、[VM Extension Health Status] などの指標を選択します。使用可能な指標のリストについては、VM 拡張機能で使用可能な指標をご覧ください。
    4. [適用] をクリックします。

ダッシュボードにいくつでもグラフを追加できます。詳細については、カスタム ダッシュボードの作成と管理をご覧ください。

アラート ポリシーを設定する

Monitoring を使用すると、指標が指定されたしきい値を超えたときのアラートを作成し、通知を受け取ることができます。たとえば、拡張機能のヘルス ステータスが CRASHED に変更されたときに通知を受け取ることができます。

アラート ポリシーを作成するには、次の操作を行います。

  1. Google Cloud コンソールで [モニタリング] を選択します。

    [Monitoring] に移動

  2. ナビゲーション パネルで [アラート] を選択します。
  3. [ポリシーを作成] をクリックします。
  4. [アラート ポリシーを作成] ページで、次の手順に沿ってアラートの条件を構成します。
    1. 指標を選択するには、[指標を選択] メニューを開き、次の操作を行います。
      1. [有効なリソース] で [VM インスタンス] を選択します。
      2. [指標カテゴリ] で、[Vm_extensions] を選択します。
      3. [指標] で、[VM Extension Enforcement Status] などの指標を選択します。使用可能な指標の一覧については、VM 拡張機能で使用可能な指標をご覧ください。
      4. [適用] をクリックします。
    2. status ラベルが INSTALL_FAILED と等しいかどうかなど、トリガー条件を構成します。
  5. 表示される手順に沿って、通知チャンネルを追加し、ポリシーに名前を付けます。
  6. [ポリシーを作成] をクリックします。

詳細については、アラート ポリシーを作成するをご覧ください。

次のステップ