アラート ポリシーを管理する

このドキュメントでは、 Google Cloud コンソールを使用してアラート ポリシーを編集、一覧表示、表示する方法について説明します。たとえば、App Hub アプリケーションに関連付けられるようにポリシーを編集する方法について説明します。このページでは、ポリシーの JSON 表現を表示する方法、カスタム ダッシュボードにアラート ポリシーを追加する方法についても説明します。これにより、指標データと同じコンテキストでポリシーを表示できます。

このドキュメントでは、Cloud Monitoring API を使用したアラート ポリシーの編集、一覧表示、表示方法については説明しません。詳細については、API によるアラート ポリシーの管理をご覧ください。

この機能は Google Cloud プロジェクトでのみサポートされています。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ管理用フォルダの管理プロジェクトを選択します。

始める前に

アラート ポリシーを保存する Google Cloud プロジェクトで、次の操作を行います。

1. Google Cloud コンソールを使用してアラート ポリシーを作成および変更するために必要な権限を取得するには、プロジェクトに対する Monitoring 編集者（roles/monitoring.editor）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

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

   Cloud Monitoring のロールの詳細については、Identity and Access Management を使用してアクセスを制御するをご覧ください。

2. アラート ポリシーの一般的なコンセプトに精通している必要があります。詳細については、アラートの概要をご覧ください。

アラート ポリシーを編集、一覧表示、削除する

1. Google Cloud コンソールで、[notifications アラート] ページに移動します。

   [アラート] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] の結果を選択します。

   アラート ページには、概要情報、インシデント、アラート ポリシーが一覧表示されたペインが表示されます。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ管理用フォルダの管理プロジェクトを選択します。

3. [ポリシー] ペインで [すべてのポリシーを表示] をクリックします。

   [ポリシー] ページには、すべてのポリシーが表示され、フィルタバーと、各ポリシーに対してポリシーを編集、コピー、削除するためのオプションがあります。

   • アラート ポリシーのリストをフィルタリングするには、次のいずれかを行います。

     • フィルタバーに名前を入力します。たとえば、名前に Example が含まれるポリシーのみを表示するには、Example を入力します。大文字と小文字を区別する比較では、ポリシーが一覧表示されているかどうかがテストされます。
     • [ポリシーをフィルタする] をクリックし、フィルタ プロパティを選択して、フィルタの値を入力するか、メニューから値を選択します。

     複数のフィルタを追加する場合、論理 AND でフィルタを結合します。

4. 省略可: ポリシーの詳細を表示するには、ポリシーの名前をクリックします。[ポリシーの詳細] ページについては、アラート ポリシーの表示をご覧ください。

5. 省略可: ポリシーを編集またはコピーするには、more_vert [その他のオプション] をクリックして、対応するオプションを選択します。ポリシーの編集方法とコピー方法は、指標ベースのアラート ポリシーの作成方法と似ています。ただし、変更できないフィールドもあります。完了したら、[ポリシーを保存] をクリックします。

6. 省略可: ポリシーを削除するには、more_vert [その他のオプション] をクリックし、[削除] を選択します。確認ダイアログで [削除] を選択します。

   ダッシュボードにアラート ポリシーのデータを表示するグラフが含まれている場合、アラート ポリシーが削除されると、そのグラフにデータが表示されなくなります。詳細については、アラート ポリシー ウィジェットにデータが表示されないをご覧ください。

アラート ポリシーを表示する

1. Google Cloud コンソールで、[notifications アラート] ページに移動します。

   [アラート] に移動

   このページを検索バーで検索する場合は、小見出しが「Monitoring」の結果を選択します。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ管理用フォルダの管理プロジェクトを選択します。

3. すべてのポリシーを一覧表示するには、[ポリシー] ペインで [すべてのポリシーを表示] をクリックします。

4. 表示するポリシーを見つけて選択します。

   アラート ポリシーの詳細ページが開きます。ここでは、ポリシーをモニタリングまたは編集し、インシデントや通知などの関連データを表示できます。また、次の操作も行うことができます。

   • グラフに表示されるデータの期間を変更します。グラフの解像度は限られており、一部の期間についてはすべての測定値が表示されない場合があります。

   • アラートを編集してユーザー定義のラベルを追加します。このラベルはインシデントと通知に含まれます。詳細については、インシデントにラベルでアノテーションを付けるをご覧ください。

   • ポリシーの有効状態を変更します。ポリシーが無効になっている場合、通知は届きません。

アラート ポリシーの JSON 表現を表示する

Cloud Monitoring API を使用してアラート ポリシーを作成または変更する場合は、そのポリシーの JSON 表現を API メソッドに指定します。API ドキュメントを参考にして、自分で JSON を作成することもできます。別の方法として、 Google Cloud コンソールを使用してポリシーを作成し、そのポリシーをローカル システムにダウンロードすることもできます。ダウンロードした JSON ファイルは、編集して他のポリシーのテンプレートとして使用できます。JSON で記述されるポリシーの例については、サンプル ポリシーをご覧ください。

アラート ポリシーの JSON 表現をダウンロードするには、次の操作を行います。

1. Google Cloud コンソールで、[notifications アラート] ページに移動します。

   [アラート] に移動

   このページを検索バーで検索する場合は、小見出しが「Monitoring」の結果を選択します。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ管理用フォルダの管理プロジェクトを選択します。
3. 表示するポリシーを見つけて、ポリシー名をクリックし、[ポリシーの詳細] ページを開きます。
4. get_app [JSON] をクリックします。

編集時にアラート ポリシーの JSON 表現を表示するには、code[コードを表示] をクリックします。

ダッシュボードにアラート ポリシーを追加する

指標データと同じコンテキストでアラート ポリシーを表示するには、そのポリシーをカスタム ダッシュボードに追加します。このダッシュボードを表示すると、追加したアラート ポリシーごとにグラフが表示されます。これらのグラフには、ポリシーのモニタリング対象指標、しきい値、対応待ちのインシデント数が表示されます。これらのグラフには、ポリシーを表示または編集するためのリンクも含まれています。

1 つの条件を含むポリシーをカスタム ダッシュボードに追加できます。複数の条件を含むポリシーは、アラート コンテキストからのみ表示できます。

アラート ポリシーの概要をカスタム ダッシュボードに表示する手順は、次のとおりです。

1. Google Cloud コンソールで [ ダッシュボード] ページに移動します。

   [ダッシュボード] に移動

   このページを検索バーで検索する場合は、小見出しが「Monitoring」の結果を選択します。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ管理用フォルダの管理プロジェクトを選択します。
3. ダッシュボードを選択するか、[ダッシュボードを作成] をクリックします。
4. ツールバーで [add ウィジェットを追加] をクリックします。
5. [ウィジェットを追加] ダイアログで、notifications [アラート ポリシー] を選択します。
6. [arrow_drop_down アラート ポリシー] をクリックして、アラート ポリシーを選択します。[アラート ポリシー] メニューからは単一条件のアラート ポリシーのみを選択できます。
7. 変更をダッシュボードに適用するには、ツールバーで [適用] をクリックします。変更を破棄するには、[キャンセル] をクリックします。

次のスクリーンショットは、アラート ポリシーのグラフを示しています。

この例では、アラート ポリシーにより、2 つの異なる仮想マシンの CPU 使用率がモニタリングされています。点線は、条件のしきい値（50% に設定されている）を示しています。No incidents というラベルが付いた緑色のチップは、アラート ポリシーに対応待ちのインシデントがないことを示しています。対応待ちのインシデント数を示すチップ上にマウスポインタを置くと、根拠となるアラート ポリシーにリンクするダイアログが開きます。

詳細については、ダッシュボードにアラート ポリシーとインシデントを表示するをご覧ください。

アラート ポリシーを App Hub アプリケーションに関連付ける

アラート ポリシーにユーザー定義ラベルを追加すると、App Hub アプリケーションの一部であるサービスまたはワークロードに関連付けることができます。これらのラベルはインシデントと通知に含まれており、アラート ポリシーはアプリケーション モニタリング ダッシュボードにも表示されます。ラベルの詳細については、インシデントにラベルでアノテーションを付けるをご覧ください。

Google Cloud コンソールを使用してアラート ポリシーをワークロードまたはサービスに関連付けるには、次の操作を行います。

1. Google Cloud コンソールで、[notifications アラート] ページに移動します。

   [アラート] に移動

   このページを検索バーで検索する場合は、小見出しが「Monitoring」の結果を選択します。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ管理用フォルダの管理プロジェクトを選択します。
3. アラート ポリシーを見つけて、more_vert [さらに表示] をクリックし、[編集] を選択して、[通知と名前] セクションに移動します。
4. [アプリケーション ラベル] セクションで、アプリケーションを選択してから、ワークロードまたはサービスを選択します。
5. [ポリシーを保存] をクリックします。

これらの手順を完了すると、次のキーを持つラベルがアラート ポリシーに添付されます。これらのラベルは、アプリケーションとサービスまたはワークロードを識別します。

• apphub_application_location
• apphub_application_id
• apphub_service_id または apphub_workload_id

Google Cloud CLI、Terraform、または Cloud Monitoring API を使用して、アラート ポリシーにユーザーラベルを追加することもできます。ただし、前述の例に示したラベルキーを使用する必要があります。詳しくは以下をご覧ください。

• API によるアラート ポリシーの管理。
• Terraform を使用してアラート ポリシーを管理する。