Serverless App Engine:連絡先の管理

連絡先を作成する

1. SAE コンソール にログインします。左側のナビゲーションウィンドウで、[アプリケーション] > [アプリケーション] を選択します。[アプリケーション] ページで、上部のナビゲーションバーでリージョンを選択し、[名前空間] ドロップダウンリストから名前空間を選択し、目的のアプリケーション名をクリックします。

   

2. 左側のナビゲーションウィンドウで、[通知とアラート] > [連絡先管理] を選択します。

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

4. [連絡先を作成] ダイアログボックスで、パラメーターを設定し、[OK] をクリックします。次の表でパラメーターについて説明します。

   パラメーター	説明
   名前	連絡先の名前。
   電話番号	連絡先の携帯電話番号を指定すると、電話とショートメッセージで連絡先に通知できます。 説明 通知ポリシーでは、確認済みの携帯電話番号のみを指定できます。詳細については、「携帯電話番号を確認する」をご参照ください。
   メール	連絡先のメールアドレスを指定すると、メールで連絡先に通知できます。
   連絡先グループ	連絡先を追加する連絡先グループを選択します。連絡先グループの作成方法については、「連絡先グループ」をご参照ください。
   電話通知が失敗した場合の通知再送信方法	電話通知が失敗した場合の通知再送信方法を選択します。このパラメーターのグローバルデフォルト設定は、[連絡先] タブで指定できます。詳細については、「通知を再送信するためのデフォルト方法を指定する」をご参照ください。
   ユーザー ID	異なるユーザーを識別し、データの処理、情報のクエリ、またはその他の操作を実行する際に利便性を提供するために使用されるユーザー ID です。

   説明

   • [電話番号] と [メール] パラメーターの少なくとも 1 つを指定する必要があります。各携帯電話番号またはメールアドレスは、1 つの連絡先にのみ使用できます。

   • DingTalk チャットボットを作成する場合は、[dingtalk/lark/wecom] タブで DingTalk チャットボットを作成します。詳細については、「DingTalk チャットボット」をご参照ください。

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

携帯電話番号を確認する

通知ポリシーで携帯電話番号を指定する前に、番号を確認する必要があります。

1. SAE コンソール にログインします。左側のナビゲーションウィンドウで、[アプリケーション] > [アプリケーション] を選択します。[アプリケーション] ページで、上部のナビゲーションバーでリージョンを選択し、[名前空間] ドロップダウンリストから名前空間を選択し、目的のアプリケーション名をクリックします。

   

2. 左側のナビゲーションウィンドウで、[通知とアラート] > [連絡先管理] を選択します。

3. [連絡先] タブの [通知オブジェクト] ページで、携帯電話番号を確認する 1 つ以上の連絡先を選択します。

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

   • 複数の連絡先の携帯電話番号を一度に確認するには、連絡先を選択し、[一括確認] をクリックします。

   その後、システムは携帯電話番号を確認するために連絡先にショートメッセージを送信します。

4. 連絡先はブラウザを使用して、ショートメッセージ内の URL にアクセスします。

5. 表示される確認ページで、番号を確認し、[確認] をクリックします。

通知を再送信するためのデフォルト方法を指定する

電話通知が失敗した場合に通知を再送信するためのデフォルト方法を指定できます。

1. SAE コンソール にログインします。左側のナビゲーションウィンドウで、[アプリケーション] > [アプリケーション] を選択します。[アプリケーション] ページで、上部のナビゲーションバーでリージョンを選択し、[名前空間] ドロップダウンリストから名前空間を選択し、目的のアプリケーション名をクリックします。

   

2. 左側のナビゲーションウィンドウで、[通知とアラート] > [連絡先管理] を選択します。

3. [連絡先] タブの [通知オブジェクト] ページで、[詳細] > [連絡先のデフォルト設定] を選択します。

4. 表示されるダイアログボックスで、通知を再送信する方法を選択し、[OK] をクリックします。

前提条件

連絡先が作成されています。詳細については、「連絡先を作成する」をご参照ください。

連絡先グループを作成する

1. SAE コンソール にログインします。左側のナビゲーションウィンドウで、[アプリケーション] > [アプリケーション] を選択します。[アプリケーション] ページで、上部のナビゲーションバーでリージョンを選択し、[名前空間] ドロップダウンリストから名前空間を選択し、目的のアプリケーション名をクリックします。

   

2. 左側のナビゲーションウィンドウで、[通知とアラート] > [連絡先管理] を選択します。

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

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

   連絡先グループを作成すると、[連絡先] タブの [すべての連絡先] リストに連絡先グループが表示されます。

連絡先グループを管理する

連絡先グループを作成した後、[連絡先] タブで連絡先グループを検索、変更、または削除できます。

• 連絡先グループを変更するには、連絡先グループの右側にある > [グループの編集] を選択します。表示されるダイアログボックスで、連絡先グループの名前または連絡先を変更し、[OK] をクリックします。

• 連絡先グループ内の連絡先を表示するには、連絡先グループの左側にある アイコンをクリックします。

• 連絡先グループを削除するには、連絡先グループの右側にある > [グループの削除] を選択します。表示されるメッセージで、[OK] をクリックします。

  重要

  • 連絡先グループを削除する前に、連絡先グループが通知ポリシーに追加されていないことを確認してください。追加されている場合、アラート通知の送信に失敗する可能性があります。

  • 現在のアカウントを使用して作成された連絡先グループのみを削除できます。

SAE コンソールでアラート通知を受信するために使用される DingTalk グループを作成する

1. DingTalk クライアントで作成した DingTalk グループにカスタムチャットボットを作成し、チャットボットの Webhook URL を取得します。詳細については、「DingTalk チャットボットの Webhook URL を取得する」をご参照ください。

2. SAE コンソール にログインします。左側のナビゲーションウィンドウで、[アプリケーション] > [アプリケーション] を選択します。[アプリケーション] ページで、上部のナビゲーションバーでリージョンを選択し、[名前空間] ドロップダウンリストから名前空間を選択し、目的のアプリケーション名をクリックします。

   

3. 左側のナビゲーションウィンドウで、[通知とアラート] > [連絡先管理] を選択します。 [通知オブジェクト] ページで、[dingtalk/lark/wecom] タブをクリックし、[dingtalk] をクリックします。

4. [dingtalk チャットボットを作成] パネルで、パラメーターを設定し、[OK] をクリックします。次の表でパラメーターについて説明します。

   説明

   DingTalk グループでアラート通知を受信するには、通知ポリシーで [通知方法] パラメーターを [dingtalk] に設定する必要があります。詳細については、「通知ポリシーを設定する」をご参照ください。

   パラメーター	説明
   名前	DingTalk チャットボットの名前を指定します。
   署名キー	オプション。署名キーを指定すると、署名キーを使用して DingTalk 認証が実行されます。署名キーを指定しない場合、デフォルトではホワイトリストが認証に使用されます。ホワイトリストのキーワードは アラート です。
   チャットボット Webhook URL	DingTalk チャットボットの Webhook URL を入力します。
   DingTalk チャットボットが日次統計を送信するかどうか	このオプションを選択した場合は、日次統計を送信する時点を入力する必要があります。複数の時点はコンマ (,) で区切ります。時点は HH:SS 形式で指定します。 ARMS が指定した時点で送信する情報には、当日生成されたアラートの総数、解決されたアラートの数、および解決されるアラートの数が含まれます。
   カードコンテンツの設定	アラート通知カードのスタイルとコンテンツをカスタマイズします。

DingTalk グループでアラートを管理する

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

手順 1：Webhook URL を取得する

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

2. [+] アイコンをクリックし、[新しいグループ] をクリックして、アラート通知を受信するために使用される Lark グループを作成します。

3. [グループ設定] アイコンをクリックします。次に、[ボット] タブをクリックします。[ボット] タブで、[ボットを追加] をクリックします。

4. [ボットを追加] パネルで、[カスタムボット] を選択します。次に、[ボット名] パラメーターと [説明] パラメーターを設定し、[追加] をクリックします。

5. Webhook URL をコピーし、[キーワードを設定] を選択し、キーワード [アラート] を入力し、[保存] をクリックします。

手順 2：Webhook を作成する

1. SAE コンソール にログインします。左側のナビゲーションウィンドウで、[アプリケーション] > [アプリケーション] を選択します。[アプリケーション] ページで、上部のナビゲーションバーでリージョンを選択し、[名前空間] ドロップダウンリストから名前空間を選択し、目的のアプリケーション名をクリックします。

   

2. 左側のナビゲーションウィンドウで、[通知とアラート] > [連絡先管理] を選択します。

3. [webhook 統合] タブの [通知オブジェクト] ページで、[webhook を作成] をクリックします。

4. [webhook を作成] パネルで、パラメーターを設定し、[OK] をクリックします。次の表でパラメーターについて説明します。

5. 設定が完了したら、[テスト送信] をクリックして Webhook が設定されているかどうかを確認します。次に、[OK] をクリックします。

   パラメーター	説明
   Webhook 名	Webhook の名前。
   Post/Get	リクエストメソッド。 URL は 100 文字を超えることはできません。 この例では、Post が選択され、「手順 1：Webhook URL を取得する」でコピーされた Webhook URL が貼り付けられます。
   ヘッダー/パラメーター	リクエストヘッダー。長さは 200 文字を超えることはできません。[追加] をクリックして、ヘッダーまたはパラメーターを追加します。デフォルトのリクエストヘッダーは Content-Type: text/plain; charset=UTF-8 です。ヘッダーとパラメーターの総数は 6 を超えることはできません。 この例では、次の ヘッダー が使用されます。 Arms-Content-Type: json Content-Type: application/json
   通知テンプレート	アラートがトリガーされたときに使用される通知テンプレート。このパラメーターは、Post を選択した場合にのみ使用できます。 $content プレースホルダーを使用して通知コンテンツを指定できます。コンテンツは 500 文字を超えることはできません。詳細については、「通知テンプレートと Webhook テンプレートを設定する」をご参照ください。 次の形式で通知テンプレートを指定します。 { "Alert name":"{{ .commonLabels.alertname }}{{if .commonLabels.clustername }}", "Cluster name":"{{ .commonLabels.clustername }} {{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}", "Application name":"{{ .commonLabels._aliyun_arms_involvedObject_name }} {{ end }}", "Notification policy":"{{ .dispatchRuleName }}", "Alert time":"{{ .startTime }}", "Notification content":"{{ for .alerts }} {{ .annotations.message }} {{ 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 }}Notification policy: {{ .dispatchRuleName }} \nAlert time: {{ .startTime }} \nNotification content: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}" } }
   アラートをクリアするためのテンプレート	アラートがクリアされたときに使用される通知テンプレート。このパラメーターは、Post を選択した場合にのみ使用できます。 $content プレースホルダーを使用して通知コンテンツを指定できます。コンテンツは 500 文字を超えることはできません。詳細については、「通知テンプレートと Webhook テンプレートを設定する」をご参照ください。 次の形式で通知テンプレートを指定します。 { "Alert name":"{{ .commonLabels.alertname }}{{if .commonLabels.clustername }}", "Cluster name":"{{ .commonLabels.clustername }} {{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}", "Application name":"{{ .commonLabels._aliyun_arms_involvedObject_name }} {{ end }}", "Notification policy":"{{ .dispatchRuleName }}", "Time when the alert is resolved":"{{ .endTime }}", "Notification content":"{{ for .alerts }} {{ .annotations.message }} {{ 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: {{ .startTime }} \nNotification policy: {{ .dispatchRuleName }} \nNotification content: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}" } }

手順 3：通知ポリシーを設定する

通知ポリシーを作成または変更するときに、[通知オブジェクト] パラメーターを [ユニバーサル Webhook] に設定し、Webhook を選択します。詳細については、「通知ポリシーを設定する」をご参照ください。