Serverless App Engine:連絡先の管理

連絡先の作成

連絡先管理ページに移動するには、まず SAE コンソールにログインし、[アプリケーション] > [アプリケーション] に移動し、リージョンと名前空間を選択し、アプリケーション名をクリックしてから、左側のナビゲーションウィンドウで[通知とアラート] > [連絡先管理] を選択します。

1. 「通知オブジェクト」ページで、「連絡先」タブに移動し、「連絡先の作成」をクリックします。

2. 「[連絡先の作成]」ダイアログボックスで、連絡先の詳細を入力し、「[OK]」をクリックします。

   [電話番号] または [メール] の少なくとも 1 つを指定してください。各電話番号とメールアドレスは、1 つの連絡先にのみ紐づけることができます。DingTalk チャットボットを設定する場合は、代わりに [DingTalk/Lark/WeCom] タブを使用してください。

   パラメーター	説明
   名前	連絡先の名前。
   電話番号	電話とショートメッセージ通知を有効にします。検証済みの電話番号のみが通知ポリシーで使用できます。詳細については、「電話番号の検証」をご参照ください。
   メール	メール通知を有効にします。
   連絡先グループ	この連絡先を追加する連絡先グループ。詳細については、「連絡先グループの作成」をご参照ください。
   電話通知が失敗した場合の再送信方法	電話の呼び出しが失敗した場合のフォールバックメソッドです。[連絡先] タブの [その他] > [連絡先のデフォルト設定] で、すべての連絡先に対してグローバルデフォルトを設定します。
   ユーザー ID	データ処理とクエリに使用される識別子。

連絡先を作成した後は、[連絡先] タブでその連絡先を検索、編集、または削除できます。

電話番号の検証

電話番号は、通知ポリシーで使用する前に検証する必要があります。認証コードは検証対象の電話番号に送信されます。連絡先は、検証を完了するためにその番号にアクセスできる必要があります。

1. 「[連絡先]」タブで、検証する番号を持つ連絡先を選択します。「[通知オブジェクト]」ページの：SAE は、選択した各番号に検証リンク付きのショートメッセージを送信します。

   • 単一の電話番号を検証するには、連絡先を見つけ、電話番号の横にある[未検証]をクリックします。

   • 複数の番号を一度に検証するには、連絡先を選択して、[一括検証] をクリックします。

2. 各連絡先は、ショートメッセージの URL をブラウザで開きます。

3. 検証ページで、連絡先は番号を確認し、[検証] をクリックします。

デフォルトのフォールバック方法の設定

電話通知が失敗した場合、SAE はフォールバック方法を使用してアラートを再送信します。すべての連絡先に対してグローバルデフォルトを設定します。

1. 「通知オブジェクト」ページの「連絡先」タブで、「その他」＞「連絡先のデフォルト設定」を選択します。

2. フォールバックメソッドを選択し、[OK] をクリックします。

個別の連絡先は、連絡先を作成または編集するときに、[電話による通知が失敗した場合の通知の再送信方法] パラメーターを使用して、このデフォルトをオーバーライドできます。

前提条件

少なくとも 1 つの連絡先が存在する必要があります。詳細については、「連絡先の作成」をご参照ください。

連絡先グループの作成

1. 通知オブジェクト ページの [連絡先] タブで、[連絡先グループの作成] をクリックします。

2. [連絡先グループの作成] ダイアログボックスで、[グループ名] に名前を入力し、[アラート連絡先] リストから連絡先を選択し、[OK] をクリックします。

連絡先グループは、[連絡先] タブの [すべての連絡先] リストに表示されます。

連絡先グループの管理

連絡先グループを作成した後、[連絡先] タブから管理します：

操作	手順
編集	グループの右側にある をクリックし、[グループの編集] を選択します。名前またはメンバーを変更し、[OK] をクリックします。
メンバーの表示	グループの左側にある アイコンをクリックします。
削除	グループの右側にある をクリックし、[グループの削除] を選択します。その後、確認します。

前提条件

カスタムチャットボットが追加された DingTalk グループ、およびチャットボットの Webhook URL。詳細については、「DingTalk チャットボットの Webhook URL の取得」をご参照ください。

DingTalk チャットボットの追加

1. [通知オブジェクト]ページで、[DingTalk/Lark/WeCom] タブをクリックし、[DingTalk] をクリックします。

2. [DingTalk チャットボットの作成] パネルで、パラメーターを設定し、[OK] をクリックします。

   DingTalk グループでアラートを受信するには、通知ポリシーで [通知メソッド] を [DingTalk] に設定します。詳細については、「通知ポリシーを設定する」をご参照ください。

   パラメーター	説明
   名前	DingTalk チャットボットの名前です。
   署名キー	オプションです。 指定した場合、DingTalk は署名キーを使用してリクエストを認証します。 空欄の場合、認証はキーワード Alert を含むホワイトリストを使用します。
   チャットボットの Webhook URL	DingTalk チャットボットの Webhook URL です。
   DingTalk チャットボットが日次統計を送信するかどうか	有効にした場合、日次サマリーを送信する時刻を入力します。 形式は HH:SS で、カンマで区切ります。 各サマリーには、その日に生成された合計アラート数、解決済みアラート、および未解決アラートが含まれます。
   カードコンテンツの設定	アラート通知カードのスタイルとコンテンツをカスタマイズします。

DingTalk グループでのアラート管理

DingTalk グループでアラート通知を受信した後、グループ内で直接表示および管理します。詳細については、「指定されたグループチャットでのアラート処理」をご参照ください。

ステップ 1: Webhook URL の取得

1. Lark を開き、ログインします。

2. [+] > [新しいグループ] をクリックして、アラートを受信するためのグループを作成します。

3. 「[グループ設定]」を開き、「[BOTs]」タブに移動して、「[BOT の追加]」をクリックします。

4. [カスタムボット] を選択し、名前と説明を設定して、[追加] をクリックします。

5. Webhook  URL をコピーします。「キーワードの設定」で、「アラート」と入力し、「保存」をクリックします。

ステップ 2: SAE で Webhook を作成する

1. [通知オブジェクト] ページで、[Webhook インテグレーション] タブに移動し、[Webhook の作成] をクリックします。

2. [Webhook の作成] パネルで、パラメーターを設定します。 通知テンプレートの例 (Lark)：

   パラメーター	説明
   [Webhook 名]	Webhook の名前。
   [Post/Get]	リクエストメソッド。 URL は 100 文字を超えることはできません。 Lark の場合は、[Post] を選択し、ステップ 1 の Webhook URL を貼り付けます。
   [ヘッダー/パラメーター]	追加のリクエストヘッダーまたはパラメーター。 合計で最大 6 エントリ、合計で最大 200 文字です。 デフォルトのヘッダーは Content-Type: text/plain; charset=UTF-8 です。 Lark の場合は、Arms-Content-Type: json と Content-Type: application/json を追加します。
   [通知テンプレート]	アラートが発生したときに送信されるメッセージ本文 (POST のみ)。 アラート内容のプレースホルダーとして $content を使用します。 最大 500 文字です。 詳細については、「通知テンプレートと Webhook テンプレートの設定」をご参照ください。
   [アラートをクリアするためのテンプレート]	アラートが解消されたときに送信されるメッセージ本文 (POST のみ)。 最大 500 文字です。

   {
     "msg_type": "text",
     "content": {
       "text": "アラート名: {{ .commonLabels.alertname }}\n{{if .commonLabels.clustername }}クラスター名: {{ .commonLabels.clustername }}\n{{ end }}{{if eq \"app\" .commonLabels._aliyun_arms_involvedObject_kind }}アプリケーション名: {{ .commonLabels._aliyun_arms_involvedObject_name }}\n{{ end }}アラートが解決された時刻: {{ .endTime }} \n通知ポリシー: {{ .dispatchRuleName }} \n通知内容: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
     }
   }

   アラートクリアテンプレートの例 (Lark):

   {
     "msg_type": "text",
     "content": {
       "text": "Alert name: {{ .commonLabels.alertname }}\n{{if .commonLabels.clustername }}Cluster name: {{ .commonLabels.clustername }}\n{{ end }}{{if eq \"app\" .commonLabels._aliyun_arms_involvedObject_kind }}Application name: {{ .commonLabels._aliyun_arms_involvedObject_name }}\n{{ end }}Time when the alert is resolved: {{ .endTime }} \nNotification policy: {{ .dispatchRuleName }} \nNotification content: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
     }
   }

3. [テスト送信] をクリックして Webhook が動作していることを確認し、次に [OK] をクリックします。

   Webhook には 5 秒のタイムアウトがあります。5 秒以内に応答がない場合、通知は失敗します。

ステップ 3: Webhook を通知ポリシーにアタッチする

通知ポリシーを作成または編集する際は、[通知オブジェクト] を [ユニバーサル Webhook] に設定し、使用する Webhook を選択します。詳細については、「通知ポリシーの設定」をご参照ください。