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

VM 拡張機能の健全性とパフォーマンスをモニタリングすると、リソース使用量を管理し、Compute Engine インスタンスのフリート全体で問題を解決できます。Cloud Monitoring ダッシュボードを使用して、CPU やメモリ使用量などのリソース使用量を可視化し、インストール失敗などのイベントが発生したときに通知を受け取るようにアラート ポリシーを構成できます。

このドキュメントでは、Cloud Monitoring を使用して Compute Engine インスタンス上の VM Extension Manager で管理される VM 拡張機能をモニタリングする方法について説明します。これにより、次のことが可能になります。

始める前に

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

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

    コンソール

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

    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 にログインする必要があります。

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

始める前に

拡張機能をモニタリングする前に、次の操作が完了していることを確認してください。

必要な 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. コンソールで [**Monitoring**] を選択します。 Google Cloud

    [Monitoring] に移動

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

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

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

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

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

    [Monitoring] に移動

  2. ナビゲーション パネルで [アラート] を選択します。
  3. [ポリシーを作成] をクリックします。
  4. [アラート ポリシーを作成] ページで、アラートの条件と通知チャネルを定義します。
    1. 指標を選択するには、[指標を選択] メニューを開き、次の操作を行います。
      1. For the [Active resources], select [VM Instance].
      2. [指標カテゴリ] で、[Vm_extensions] を選択します。
      3. [**指標**] で、**VM 拡張機能 の適用ステータス** などの指標を選択します。使用可能な指標のリストについては、 VM 拡張機能のモニタリングに使用できる指標 をご覧ください。
      4. [適用] をクリックします。
    2. status ラベルが INSTALL_FAILED かどうかを確認するなど、トリガー条件を構成します。
  5. プロンプトに沿って通知チャネルを追加し、ポリシーに名前を付けます。
  6. [ポリシーを作成] をクリックします。

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

次のステップ