VM 拡張機能の健全性とパフォーマンスをモニタリングすると、Compute Engine インスタンスのフリート全体でリソース使用量を管理し、問題を解決できます。Cloud Monitoring ダッシュボードを使用して、CPU やメモリ使用量などのリソース使用率を可視化し、インストール失敗などのイベントが発生したときに通知を受け取るようにアラート ポリシーを構成できます。
このドキュメントでは、Cloud Monitoring を使用して Compute Engine インスタンスで VM Extension Manager によって管理される VM 拡張機能をモニタリングする方法について説明します。このドキュメントは、次の操作を行う際に役立ちます。
始める前に
-
まだ設定していない場合は、認証を設定します。認証では、 Cloud de Confiance by S3NS サービスと API にアクセスするための ID が確認されます。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール
Cloud de Confiance コンソールを使用して Cloud de Confiance by S3NS サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
-
Google Cloud CLI をインストールし、 フェデレーション ID を使用して gcloud CLI にログインします。ログイン後、次のコマンドを実行して Google Cloud CLI を初期化します。
gcloud init
-
- デフォルトのリージョンとゾーンを設定します。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Google Cloud CLI をインストールし、 フェデレーション ID を使用して gcloud CLI にログインします。
詳細については、 Cloud de Confiance 認証ドキュメントの REST を使用して認証するをご覧ください。
始める前に
拡張機能をモニタリングする前に、次のことを完了していることを確認してください。
- 拡張機能ポリシーを作成して VM 拡張機能をインストールする。
- VM Extension Manager の基本を確認します。
- モニタリングの保持期間と モニタリングの料金を確認します。
必要な 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 が含まれます。拡張機能の名前の一覧については、サポートされている拡張機能をご覧ください。
|
| VM 拡張機能の健全性ステータス | compute.googleapis.com/vm_extensions/extension/health_status |
VM 拡張機能のヘルス ステータス。ラベルには extension_name と status が含まれます。拡張機能名の一覧については、サポートされている拡張機能をご覧ください。 status に指定できる値は次のとおりです。
|
| 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 ダッシュボードを構築できます。ダッシュボードにグラフを追加する手順は次のとおりです。
- Cloud de Confiance コンソールで [モニタリング] を選択します。
- ナビゲーション パネルで [ダッシュボード] を選択します。
- [CREATE DASHBOARD] をクリックします。
- [ウィジェットを追加] をクリックします。
- [ウィジェットを追加] ウィンドウで、[Data] として [指標] を選択します。
- 指標を選択するには、[指標を選択] メニューを開き、次の操作を行います。
- [有効なリソース] で [VM インスタンス] を選択します。
- [指標カテゴリ] で、[Vm_extensions] を選択します。
- [指標] で、VM 拡張機能の健全性ステータスなどの指標を選択します。使用可能な指標の一覧については、VM 拡張機能のモニタリングに使用可能な指標をご覧ください。
- [適用] をクリックします。
ダッシュボードにいくつでもグラフを追加できます。詳細については、カスタム ダッシュボードの作成と管理をご覧ください。
アラート ポリシーを設定する
Monitoring を使用すると、指標が指定されたしきい値を超えたときのアラートを作成し、通知を受け取ることができます。たとえば、拡張機能のヘルス ステータスが CRASHED に変更されたときに通知を受け取ることができます。
- Cloud de Confiance コンソールで [モニタリング] を選択します。
- ナビゲーション パネルで [アラート] を選択します。
- [ポリシーを作成] をクリックします。
- [アラート ポリシーを作成] ページで、アラートの条件と通知チャネルを定義します。
- 指標を選択するには、[指標を選択] メニューを開き、次の操作を行います。
- [有効なリソース] で、[VM インスタンス] を選択します。
- [指標カテゴリ] で、[Vm_extensions] を選択します。
- [指標] で、[VM 拡張機能の適用ステータス] などの指標を選択します。使用可能な指標の一覧については、VM 拡張機能のモニタリングに使用可能な指標をご覧ください。
- [適用] をクリックします。
statusラベルがINSTALL_FAILEDかどうかを確認するなど、トリガー条件を構成します。
- 指標を選択するには、[指標を選択] メニューを開き、次の操作を行います。
- プロンプトに沿って、通知チャンネルを追加し、ポリシーに名前を付けます。
- [ポリシーを作成] をクリックします。
詳細については、アラート ポリシーを作成するをご覧ください。