通知チャンネルを管理

このドキュメントでは、Cloud Monitoring アラートポリシーで使用可能な、サポートされている通知チャネルの種類を紹介し、Google Cloud Console を使用して通知チャネルを構成する方法について説明します。通知チャネルは、アラートポリシーの条件が満たされたことを通知するために Monitoring が使用するメカニズムです。たとえば、サポートチームにメールを送信し、さらに Pub/Sub トピックを公開するように Monitoring を構成できます。

Cloud Monitoring API を使用して通知チャネルを構成するには、通知チャネルの管理をご覧ください。

アラートポリシーの通知については、次のページをご覧ください。

問題の発生からアラートが作成されるまでの間の遅延については、通知レイテンシをご覧ください。
アラートポリシーに対して生成される通知の数については、インシデントごとの通知をご覧ください。

デフォルトでは、アラートポリシーはインシデントが作成された場合にのみ通知を送信します。インシデントが開かれたときと閉じたときに通知を受け取るには、アラートポリシーを編集し、[通知] セクションで [Notify on incident closure] を選択します。

準備

通知チャンネルを構成するには、指標スコープのスコープ対象プロジェクトに対して次のいずれかの Identity and Access Management ロールを持っている必要があります。

モニタリング通知チャネルの編集者
モニタリング編集者
モニタリング管理者
プロジェクト編集者
プロジェクトオーナー

これらのロールの詳細については、アクセス制御をご覧ください。

通知チャンネルを作成する

アラートポリシーを作成するときに、構成されている通知チャネルを選択してポリシーに追加できます。通知チャネルを事前に構成することも、アラートポリシーの作成プロセスの一環として構成することもできます。詳しくは、オンデマンドでチャネルを作成するをご覧ください。

Cloud Console を使用して通知チャネルを作成するには、次の表に示すチャネル固有の手順を行います。

Email

メール通知チャネルを追加する手順は次のとおりです。

Cloud Console で、[モニタリング] を選択します。

[モニタリング] に移動
[アラート]、[通知チャネルを編集] の順にクリックします。
[メール] セクションで [新しく追加] をクリックします。
ダイアログの項目を入力し、[保存] をクリックします。

アラートポリシーの作成中にメールチャネルを作成できます。詳しくは、オンデマンドでチャネルを作成するをご覧ください。

アラートポリシーの通知チャネルとしてグループのメールアドレスを使用する場合は、alerting-noreply@google.com からのメールを受け入れるようにグループを構成します。

モバイルアプリ

Cloud Console モバイルアプリで、どこからでも Cloud Console リソースと Monitoring の情報をモニタリングできます。Cloud Console モバイルアプリ通知は、特定のデバイスまたは特定のユーザーに送信されます。

Cloud Console モバイルアプリ通知チャンネルのリスト。

デバイスは、通知チャンネルを作成した特定のデバイスにのみ通知を送信することを示します。デバイススコープの通知チャンネルの場合、[表示名] フィールドにはデバイス情報が含まれます。
ユーザーは、Cloud Console モバイルアプリがインストールされているすべてのデバイスに通知を送信することを示します。

チャンネルが作成されると、Cloud Monitoring によって通知スコープが決定されます。スコープを選択または変更することはできません。

特定の Google Cloud プロジェクトの Cloud Console モバイルアプリ通知チャンネルを構成する手順は次のとおりです。

モバイルデバイスのアプリストアから Cloud Console モバイルアプリをインストールします。
Cloud Console モバイルアプリに表示するプロジェクトを選択します。

プロジェクトを選択すると、アプリと選択した Google Cloud プロジェクトの間でデータ交換が行われます。通知チャネルが存在しない場合は自動的に作成され、数分後に [通知チャネル] ページの [モバイルデバイス] セクションに表示されます。

アラートポリシーの通知チャンネルとしてモバイルデバイスを追加するには、アラートの [通知] セクションで [Google Cloud Console（モバイル）] を選択し、リストからモバイルデバイスを選択します。

PagerDuty

PagerDuty と統合すれば、Monitoring との一方向または双方向の同期が可能になります。構成に関係なく、以下のようになります。

Monitoring でインシデントが作成された場合、そのインシデントは PagerDuty で開かれます。
PagerDuty を使用して Monitoring のインシデントを閉じることはできません。

一方向の同期を使用し、PagerDuty でインシデントを解決した場合、PagerDuty のインシデントの状態は Monitoring のインシデントの状態から切り離されます。PagerDuty でインシデントを解決した場合、そのインシデントは PagerDuty で完全にクローズされ、再び開くことはできません。

双方向の同期を使用する場合、PagerDuty が表示する状態は、Monitoring により制御されます。PagerDuty でインシデントを解決し、Monitoring がインシデントを開いている場合、そのインシデントは PagerDuty で再度開かれます。

PagerDuty の通知を設定するには、次の手順を行います。

PagerDuty で: PagerDuty サイトで PagerDuty アカウントを作成します。
PagerDuty の Stackdriver 統合ガイド†に記載されている手順に従って、PagerDuty と Monitoring の統合を完了します。
Stackdriver 統合ガイドのスクリーンショットには、プロダクト名が「Stackdriver」と表示されているため、最新ではありません。このガイドに記載されている手順は正確です。
PagerDuty 通知チャネルを追加します。
1. Cloud Console で、[モニタリング] を選択します。
  [モニタリング] に移動
2. [アラート]、[通知チャネルを編集] の順にクリックします。
3. [PagerDuty] セクションで、[Add new] をクリックします。
4. [表示名] を入力します。この名前は、統合を追加したときに PagerDuty に指定した名前と一致する必要があります。
5. PagerDuty によって生成された Integration Service Key を [Service Key] フィールドに入力します。
6. [保存] をクリックします。
（省略可）双方向同期を構成する場合は、次の操作を行います。
1. PagerDuty を開きます。
2. [Configuration] を選択して [Services] を選択し、統合の構成時に入力したサービス名を選択します。
3. [設定を編集] をクリックして [インシデントの作成] を選択し、[アラートとインシデントの作成] をクリアします。

アラートポリシーを作成するときは、[通知] セクションで [PagerDuty] を選択し、PagerDuty 設定を選択します。

PagerDuty の JSON パケットの形式は次のとおりです。

 {
     "description": A string of various fields in the incident,
     "details": JSON payload with schema version 1.2.
 }

details フィールドの例とスキーマを表示するには、次のセクションを展開します。

JSON の例

デフォルトでは、アラートバックエンドはバージョン 1.2 形式の JSON パケットを生成しようとします。この形式の詳細については、次のセクションをご覧ください。

以下は、そのようなパケットの例です。


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

スキーマの構造、バージョン 1.2

このセクションでは、ペイロードスキーマのバージョン 1.2 について説明します。アラートポリシーの構成、インシデントの状態、モニタリング対象リソースによっては、返されたパケットにフィールドが一部不足しているものや、フィールドの値が空になっているものがある場合があります。一部のフィールドでは、値として埋め込み構造が使用されます。値の内容が状況に応じて変わるので、埋め込み構造が参照を通じて記述されます。

返されたパケットでは、フィールドの順序は任意です。以下の説明では、関連するグループに整理されます。

{
  "version": "1.2",
  "incident": {

    インシデントに関する情報。

    "incident_id": 文字列。このインシデント用に生成された ID。
    "scoping_project_id": 文字列。指標スコープをホストするプロジェクト ID。
    "scoping_project_number": 数字。スコープ対象プロジェクトのプロジェクト番号。
    "url": 文字列。このインシデントの Google Cloud Console URL。
    "started_at": 数字。インシデントが開かれた時間（Unix エポック秒数）。
    "ended_at": 数字。インシデントが閉じた時間（Unix エポック秒数）。state が closed の場合にのみ入力されます。
    "state": 文字列。インシデントの状態: open または closed。open の場合、ended_at は null です。
    "summary": 文字列。インシデント用に生成された概要テキスト。
    "apigee_url" : 文字列。このインシデントの Apigee URL（Apigee リソースタイプ Environment および Proxy* のみ）。
    "observed_value": 文字列。アラートをトリガー / 解決した観測値（条件が期限切れの場合は空欄の可能性あり）。

    インシデントが開かれたモニタリング対象リソースに関する情報。

    "resource": {
      "type": 文字列。アラートの対象であるモニタリング対象リソースタイプの識別子。例: gce_instance。モニタリング対象リソースのリストをご覧ください。
      "labels": オブジェクト。モニタリング対象リソースに関連付けられたラベルの Key-Value ペア。
    },
    "resource_type_display_name": 文字列。モニタリング対象リソースタイプの表示名。
    "resource_id": 文字列。モニタリング対象リソースのインスタンス ID。resource.labels.instance_id と同じ値。
    "resource_display_name": 文字列。モニタリング対象リソースの表示名。
    "resource_name": 文字列。このモニタリング対象リソース用に生成された名前。他のフィールドの値が含まれます。

    時系列データの指標タイプに関する情報。

    "metric": {
      "type": 文字列。アラートを受ける指標タイプの識別子。例: compute.googleapis.com/instance/cpu/utilization。指標の一覧をご覧ください。
      "displayName": 文字列。指標タイプの表示名。
      "labels": オブジェクト。指標に関連付けられたラベルの Key-Value ペア。
    },
    "metadata": {
      "system_labels": オブジェクト。システムメタデータラベルの Key-Value ペア。
      "user_labels": オブジェクト。ユーザーメタデータラベルの Key-Value ペア。
    },

    インシデントを開いた / 解決したアラートポリシーと条件に関する情報。
    値は、関連する AlertPolicy オブジェクトから取得されます。

    "policy_name": 文字列。アラートポリシーの表示名。
    "policy_user_labels": オブジェクト。ポリシーにアタッチされた任意のユーザーラベルの Key-Value ペア。
    "documentation": オブジェクト。Documentation 形式の埋め込み構造。
    "condition": オブジェクト。Condition 形式の埋め込み構造。
    "condition_name": 文字列。条件の表示名。condition.displayName と同じ値。
    "threshold_value": 文字列。この条件のしきい値（条件にしきい値が該当しない場合は空欄の可能性あり）。
  },
}

非推奨ポリシー

ペイロードスキーマには、Google Cloud Platform 利用規約のセクション 1.4（d）に記載されている Google Cloud 非推奨ポリシーが適用されます。なお、生成されたフィールド値の形式は、スキーマによって管理されず、予告なく変更される場合があります。たとえば、incident.summary、incident.documentation.content、incident.url は、フィールドに関連するデータを含むように作られていますが、スキーマがこうしたフィールドを正確にパースすることを保証する制約はありません。値全体はまとめて使用でき、非推奨ポリシーを遵守していることを期待できますが、生成されたフィールドのパースに頼りすぎないようにしてください。

SMS

SMS 通知を設定するには、次の手順を行います。

Cloud Console で、[モニタリング] を選択します。

[モニタリング] に移動
[アラート]、[通知チャネルを編集] の順にクリックします。
[SMS] セクションで、[新しく追加] をクリックします。
ダイアログの項目を入力し、[保存] をクリックします。

アラートポリシーを設定したら、[SMS] 通知タイプを選択し、リストから確認済みの電話番号を選択します。

Slack

Monitoring と Slack を統合すると、新しいインシデントが作成されたときに、アラートポリシーで Slack チャンネルに投稿できるようになります。 Slack 通知を設定する方法は次のとおりです。

Slackの場合: Slack サイトで Slack ワークスペースとチャネルを作成します。チャネル URL をメモしておきます。
Cloud Console で、[モニタリング] を選択します。

[Monitoring] に移動
[アラート]、[Edit notification channel] の順にクリックします。
[Slack] セクションで、[新規追加] をクリックして Slack のログインページを開きます。
1. Slack ワークスペースを選択します。
2. [許可] をクリックして Cloud Monitoring の Slack ワークスペースへのアクセスを有効にします。この操作を行うと、通知チャンネルの Monitoring 構成ページに戻ります。
3. 通知に使用する Slack チャンネルの名前を入力します。
4. Slack 通知チャンネルの表示名を入力します。
5. （省略可）Cloud Monitoring と Slack ワークスペースの間の接続をテストするには、[テスト通知を送信する] をクリックします。接続に成功すると、指定した Slack 通知チャネルにメッセージ This is a test alert notification... が表示されます。通知チャネルで通知の受信を確認してください。
通知に使用する Slack チャネルがプライベートチャネルの場合は、Monitoring アプリをそのチャネルに手動で招待する必要があります。
1. Slack を開きます。
2. Monitoring の通知として指定したチャネルに移動します。
3. チャネルで次のメッセージを入力して送信することで、Monitoring アプリをチャネルに招待します。
```
/invite @Google Cloud Monitoring
```
  Monitoring で通知チャネルを作成するときに指定したチャネルに、Monitoring アプリを招待するようにしてください。Monitoring アプリをパブリックチャネルに招待する方法は省略可能です。
アラートポリシーを作成するときは、[通知] セクションの [Slack] を選択し、Slack の構成を選択します。

Webhook

Webhooks 通知を設定するには、次の手順を行います。

webhook ハンドラ: Monitoring から webhook データを受信するパブリックエンドポイント URL を指定します。
Cloud Console で、[モニタリング] を選択します。

[モニタリング] に移動
[アラート]、[通知チャネルを編集] の順にクリックします。
[PagerDuty] セクションで、[新しく追加] をクリックします。
ダイアログの項目をすべて入力します。
[接続をテストする] をクリックして、テストペイロードを Webhook エンドポイントに送信します。受信側エンドポイントに移動して配信を確認します。
[保存] をクリックします。

アラートポリシーを作成する場合は、[通知] セクションで [Webhook] を選択し、webhook 構成を選択します。

JSON の例

以下は、そのようなパケットの例です。


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

スキーマの構造、バージョン 1.2

返されたパケットでは、フィールドの順序は任意です。以下の説明では、関連するグループに整理されます。

基本認証

Cloud Monitoring から送信された Webhook リクエストに加えて、基本的な認証では、ユーザー名とパスワードに HTTP 仕様が使用されます。Cloud Monitoring では、サーバーが適切な WWW-Authenticate ヘッダーで 401 応答を返す必要があります。基本認証の詳細については、次を参照してください。

トークン認証

トークン認証では、エンドポイント URL のクエリ文字列パラメータと、サーバーがそれ自体と Monitoring の間で秘密であると期待するキーが必要です。トークンを含む URL の例を次に示します。

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

Monitoring がインシデントをエンドポイント URL に送信した場合、サーバーは接続されたパラメータを検証できます。この認証方法は、SSL/TLS を使用して HTTP リクエストを暗号化し、スヌーパにトークンを知られないようにする場合に最も効果的です。

Python でのサーバー例については、このサンプルサーバーをご覧ください。

非推奨ポリシー

Pub/Sub

このセクションでは、Pub/Sub 通知チャネルの構成方法について説明します。冗長性を確保するため、複数の通知チャネルを作成することをおすすめします。Pub/Sub は別の配信メカニズムを使用するため、Cloud Console モバイルアプリ、PagerDuty、Webhooks、Slack と Pub/Sub をペアリングすることをおすすめします。

Pub/Sub 通知チャネルを構成するには:

Pub/Sub API を有効にしてトピックを作成する
トピックの通知チャネルを構成する
サービスアカウントを承認する
アラートポリシーで通知チャネルを設定する

アラート通知を受信するには、Pub/Sub サブスクリプションを作成する必要もあります。サブスクリプションがトピックとは異なるプロジェクトにある場合は、サブスクライバープロジェクトでサービスアカウントを作成し、roles/pubsub.subscriber のロールを付与します。

始める前に

Google Cloud プロジェクトの最初の通知チャネルを追加すると、Cloud Monitoring によってそのプロジェクトのサービスアカウントが作成されます。また、サービスアカウントに Identity and Access Management ロールの Monitoring Notification Service Agent が付与されます。サービスアカウントを使用すると、Monitoring がこのプロジェクトの Pub/Sub ベースの通知チャンネルに通知を送信できます。

サービスアカウントの形式は次のとおりです。

service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

通知サービスアカウントの名前には、一意の Cloud プロジェクト番号が含まれます。プロジェクトの名前、ID、番号は、Cloud Console のプロジェクトのダッシュボードで確認できます。また、次のコマンドでも取得できます。

gcloud projects describe PROJECT_ID --format="value(project_number)"

サービスアカウントを表示して編集するには、Google Cloud Console または Google Cloud CLI を使用します。

Pub/Sub API を有効にしてトピックを作成する

Cloud プロジェクトで Pub/Sub API を有効にします:
Pub/Sub API を有効にする
1. Pub/Sub トピックを作成する Cloud プロジェクトを選択します。
2. プロンプトが表示されたら、[有効にする] をクリックします。[API が有効です] と表示されている場合、操作は必要ありません。
Pub/Sub トピックを作成します。トピックの作成方法については、トピックの作成をご覧ください。たとえば、Google Cloud CLI を使用して notificationTopic というトピックを作成するには、次のコマンドを実行します。
```
gcloud pubsub topics create notificationTopic
```

次に、Pub/Sub 通知チャネルを構成します。

トピックの通知を構成する

Pub/Sub 通知チャネルを作成するには、Monitoring API、Google Cloud CLI または Cloud Console を使用します。通知チャネルを作成したら、通知サービスアカウントに、通知チャネルとして使用する各トピックの公開を許可します。

Monitoring API または Google Cloud CLI を使用した通知チャネルの作成については、チャネルの作成をご覧ください。

Cloud Console を使用して通知チャネルを作成する手順は次のとおりです。

Cloud Console で、[モニタリング] を選択します。

[モニタリング] に移動
作成した Pub/Sub トピックを含む Cloud プロジェクトを選択します。
[アラート]、[通知チャネルを編集] の順にクリックします。
[Pub/Sub] セクションで、[新しく追加] をクリックします。

[作成した Pub/Sub Channel] ダイアログに、Monitoring によって作成されたサービスアカウントの名前が表示されます。
サービスアカウントを承認するサービスアカウントは、すべてのトピックまたは特定のトピックを公開できます。
- すべてのトピックを公開するには、[ロールを管理] を選択し、[Pub/Sub パブリッシャー] のロールを追加します。
  
  通知チャネルを構成する手順が完了したら、次のサービスアカウントを承認するというセクションをスキップし、アラートポリシーで通知チャネルを設定するに進みます。
- 特定のトピックを公開するには、通知チャネルの構成が完了した後、次のステップに進んで、特定のトピックを公開するサービスアカウントに承認します。サービスアカウントを承認する手順については、サービスアカウントを承認するをご覧ください。
チャネルの表示名と Pub/Sub トピック名を入力します。
（省略可）チャネルが正しく構成されていることを確認するには、[テスト通知を送信] をクリックします。
[チャンネルを追加] を選択します。

次に、サービスアカウントを承認します。

サービスアカウントを承認します

承認を使用すると、通知チャネルとして使用する各 Pub/Sub トピックを公開するように通知サービスアカウントを設定できます。このセクションでは、次の操作を行う方法について説明します。

特定のトピックのサービスアカウントを承認します。
すべてのトピックのサービスアカウントを承認します。

特定のトピックのサービスアカウントを承認する

Google Cloud Console と Google Cloud CLI を使用すると、サービスアカウントに特定のトピックの公開を許可できます。このセクションでは、両方のアプローチについて説明します。

Google Cloud Console を使用して特定のトピックのサービスアカウントを認証する手順は次のとおりです。

Pub/Sub の [トピック] ページに移動します。
[トピック] に移動
トピックを選択します。
[権限] タブで、[プリンシパルを追加] を選択します。
[新しいプリンシパル] フィールドに、通知サービスアカウントの名前を入力します。サービスアカウントの命名規則は次のとおりです。
```
service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
```
[Pub/Sub パブリッシャー] ロールを選択し、[保存] を選択します。

Google Cloud CLI を使用して、特定のトピックのサービスアカウントを承認するには、トピックの pubsub.publisher IAM ロールをサービスアカウントに付与します。たとえば、次のコマンドは、notificationTopic トピックの IAM ロールを構成します。

gcloud pubsub topics add-iam-policy-binding \
projects/PROJECT_NUMBER/topics/notificationTopic --role=roles/pubsub.publisher \
--member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

add-iam-policy-binding コマンドが正常に実行されると、次のようなレスポンスが返されます。

 Updated IAM policy for topic [notificationTopic].
 bindings:
 ‐ members:
    ‐ serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
    role: roles/pubsub.publisher
 etag: BwWcDOIw1Pc=
 version: 1

詳細については、pubsub topics add-iam-policy-binding リファレンスページをご覧ください。

すべてのトピックのサービスアカウントを承認する

すべてのトピックのサービスアカウントを承認する方法は次のとおりです。

[IAM] ページに移動します。
[IAM] に移動
次のスクリーンショットに示すように、[Google 提供のロール付与を含む] を選択します。
次の形式のサービスアカウントを検索します。
```
service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
```
サービスアカウントが表示されていない場合は、ページを再読み込みします。
通知サービスアカウントの [編集] を選択し、[別のロールを追加] を選択してから、[Pub/Sub パブリッシャー] ロールを追加します。

次に、アラートポリシーで通知チャネルを設定します。

アラートポリシーで通知チャネルを設定する

アラートポリシーで Pub/Sub 通知チャネルを使用するには、チャネルタイプとして [Pub/Sub] を選択し、トピックを選択します。

スキーマの例

JSON パケットとスキーマの例を表示するには、以下のセクションを展開してください。

JSON の例

以下は、そのようなパケットの例です。


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

スキーマの構造、バージョン 1.2

返されたパケットでは、フィールドの順序は任意です。以下の説明では、関連するグループに整理されます。

非推奨ポリシー

オンデマンドでチャネルを作成する

アラートポリシーに通知チャネルを追加する際は、リストからチャネルを選択する必要があります。アラートポリシーを作成するときにオプションのリストを更新するには、次のプロセスを使用します。

通知ダイアログで、[通知チャネルを管理] をクリックします。新しいブラウザタブの [通知チャネル] ウィンドウに移動します。
新しい通知チャネルを追加するには、チャネルの種類を見つけて [新しく追加] をクリックし、以前の表に含まれるチャネル固有の手順を行います。
元のタブに戻り、通知ダイアログで [更新] をクリックします。
更新されたリストから [通知チャネル] を選択します。

通知チャンネルを編集、削除する

Cloud Console を使用して通知チャネルを編集または削除するには、次の操作を行います。

Cloud Console で [モニタリング] を選択するか、次のボタンをクリックします。

[Monitoring] に移動
Monitoring のナビゲーションパネルで、 [アラート] をクリックします。
[Edit notification channels] をクリックします。

[通知チャネル] ダッシュボードには、通知チャネルの種類ごとにセクションがあります。各セクションには、その種類のすべての構成が一覧表示されます。
- エントリを変更するには、[編集] をクリックします。変更が完了したら、[保存] をクリックします。
- エントリを削除するには、[削除] をクリックします。確認ダイアログで、[削除] をクリックします。

通知チャンネルを管理

準備

通知チャンネルを作成する

Email

モバイル アプリ

PagerDuty

JSON の例

スキーマの構造、バージョン 1.2

非推奨ポリシー

SMS

Slack

Webhook

JSON の例

スキーマの構造、バージョン 1.2

基本認証

トークン認証

非推奨ポリシー

Pub/Sub

始める前に

Pub/Sub API を有効にしてトピックを作成する

トピックの通知を構成する

サービス アカウントを承認します

特定のトピックのサービス アカウントを承認する

すべてのトピックのサービス アカウントを承認する

アラート ポリシーで通知チャネルを設定する

スキーマの例

JSON の例

スキーマの構造、バージョン 1.2

非推奨ポリシー

オンデマンドでチャネルを作成する

通知チャンネルを編集、削除する

モバイルアプリ

サービスアカウントを承認します

特定のトピックのサービスアカウントを承認する

すべてのトピックのサービスアカウントを承認する

アラートポリシーで通知チャネルを設定する