Incident Manager でのチャットチャネルの操作 - Incident Manager

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Incident Manager でのチャットチャネルの操作

AWS Systems Manager の一機能である Incident Manager により、インシデント応答者はインシデント中にチャットチャネルを通じて直接連絡を取ることができます。チャットチャネルは、AWS Chatbot でセットアップするチャットルームです。次に、このチャネルを Incident Manager の対応計画に接続します。

インシデント中に、応答者はチャットチャネルを使用してインシデントについて互いに連絡を取ります。また、Incident Manager は、インシデントに関する更新や通知をチャットチャネルに直接プッシュします。Incident Manager は、これらの通知をチャットルーム設定で指定した 1 つ以上の Amazon Simple Notification Service (Amazon SNS) トピックを使用して送信します。

AWS Chatbot および Incident Manager は、以下のアプリケーションのチャットチャネルをサポートしています。

  • Slack

  • Microsoft Teams

  • Amazon Chime

インシデントで使用するチャットチャネルをセットアップするプロセスは、3 つの異なる Amazon Web Services サービスのタスクで構成されています。

タスク 1: チャットチャネルの Amazon SNS トピックを作成または更新する

Amazon SNS は、パブリッシャーからサブスクライバー (生産者および消費者とも呼ばれます) へのメッセージ配信を提供するマネージドサービスです。発行者は、論理アクセスポイントおよび通信チャネルであるトピックにメッセージを送信することで、受信者と非同期的に通信します。Incident Manager は、ユーザーが対応計画に関連付けた 1 つ以上のトピックを使用して、インシデントに関する通知をインシデント応答者に送信します。

対応計画では、1 つ以上の Amazon SNS トピックをインシデント通知に含めることができます。ベストプラクティスとして、レプリケーションセットに追加した各 AWS リージョン に SNS トピックを作成する必要があります。

ヒント

より線形なセットアップワークフローを実現するには、まず Amazon SNS トピックを Incident Manager で使用するように設定することをお勧めします。設定が完了したら、チャットチャネルを作成できます。

チャットチャネルの Amazon SNS トピックを作成または更新するには
  1. 「Amazon Simple Notification Service デベロッパーガイド」の「Amazon SNS トピックを作成」の手順を行います。

    注記

    トピックを作成した後、トピックを編集してアクセスポリシーを更新します。

  2. 作成したトピックを選択し、トピックの Amazon リソースネーム (ARN) を arn:aws:sns:us-east-2:111122223333:My_SNS_topic などの形式でメモするかコピーします。

  3. [編集] を選択し、[アクセスポリシー] セクションを展開して、デフォルト以外の追加のアクセス許可を設定します。

  4. 以下のステートメントをポリシーの [ステートメント] 配列に追加します。

    { "Sid": "IncidentManagerSNSPublishingPermissions", "Effect": "Allow", "Principal": { "Service": "ssm-incidents.amazonaws.com" }, "Action": "SNS:Publish", "Resource": "sns-topic-arn", "Condition": { "StringEqualsIfExists": { "AWS:SourceAccount": "account-id" } } }

    プレースホルダーの値を以下のように置き換えます。

    • sns-topic-arn は、このリージョン用に作成したトピックの Amazon リソースネーム (ARN) で、形式は arn:aws:sns:us-east-2:111122223333:My_SNS_topic です。

    • account-id は、ユーザーが作業している AWS アカウント の ID (111122223333 など) です。

  5. [Save changes] (変更の保存) をクリックします。

  6. レプリケーションセットに含まれる各リージョンでこの処理を繰り返します。

タスク 2: AWS Chatbot でチャットチャネルを作成する

チャットチャネルは、Slack、Microsoft Teams、または Amazon Chime で作成できます。対応計画ごとに必要なチャットチャネルは 1 つだけです。

チャットチャネルについては、最小特権のプリンシパルに従うことをお勧めします (タスクを完了するために必要以上のアクセス許可をユーザーに与えない)。また、AWS Chatbot チャットチャネルのメンバーシップも定期的に確認する必要があります。レビューは、適切な応答者および他のステークホルダーのみがチャットチャネルにアクセスできることを確認するのに役立ちます。

AWS Chatbot が有効な Slack チャネルおよび Microsoft Teams チャネルでは、インシデント応答者は Slack または Microsoft Teams アプリケーションから複数の Incident Manager CLI コマンドを直接実行できます。詳細については、「チャットチャネルを通じた対話」を参照してください。

重要

チャットチャネルに追加するユーザーは、エスカレーション計画または対応計画に記載されている連絡先と同じである必要があります。また、ステークホルダーおよびインシデントオブザーバーなどのユーザーをチャットチャネルに追加することもできます。

AWS Chatbot の一般情報については、「AWS Chatbot Administrator Guide」の「What is AWS Chatbot」を参照してください。

チャネルを作成するアプリケーションを以下から選択してください。

Slack

この手順のステップでは、すべてのチャネルユーザーが Incident Manager でチャットコマンドを使用できるようにするために、推奨されるアクセス許可設定を示します。サポートされているチャットコマンドを使用すると、インシデント応答者は Slack チャットチャネルから直接インシデントを更新して、対話できます。詳細については、チャットチャネルを通じた対話を参照してください。

Slack でチャットチャネルを作成するには
  • 「AWS Chatbot Administrator Guide」の「Tutorial: Get started with Slack」の手順に従い、設定に以下を含めてください。

    • ステップ 10 の [ロール設定][チャネルロール] を選択します。

    • ステップ 10d の [ポリシーテンプレート] で、[Incident Manager のアクセス許可] を選択します。

    • ステップ 11 の [チャネルガードレールのポリシー] の、[ポリシー名][AWSIncidentManagerResolverAccess] を選択します。

    • ステップ 12 の [SNS トピック] セクションで、以下の操作を行います。

      • [リージョン 1] で、レプリケーションセットに含まれる AWS リージョン を選択します。

      • [トピック 1] で、そのリージョンで作成した SNS トピックを選択し、チャットチャネルへのインシデント通知の送信に使用します。

      • レプリケーションセット内のリージョンを追加するたびに、[別のリージョンを追加] を選択し、リージョンおよび SNS トピックを追加します。

Microsoft Teams

この手順のステップでは、すべてのチャネルユーザーが Incident Manager でチャットコマンドを使用できるようにするために、推奨されるアクセス許可設定を示します。サポートされているチャットコマンドを使用すると、インシデント応答者は Microsoft Teams チャットチャネルから直接インシデントを更新して、対話できます。詳細については、チャットチャネルを通じた対話を参照してください。

Microsoft Teams でチャットチャネルを作成するには
  • 「AWS Chatbot Administrator Guide」の「Tutorial: Get started with Microsoft Teams」の手順に従い、設定に以下を含めてください。

    • ステップ 10 の [ロール設定][チャネルロール] を選択します。

    • ステップ 10d の [ポリシーテンプレート] で、[Incident Manager のアクセス許可] を選択します。

    • ステップ 11 の [チャネルガードレールのポリシー] の、[ポリシー名][AWSIncidentManagerResolverAccess] を選択します。

    • ステップ 12 の [SNS トピック] セクションで、以下の操作を行います。

      • [リージョン 1] で、レプリケーションセットに含まれる AWS リージョン を選択します。

      • [トピック 1] で、そのリージョンで作成した SNS トピックを選択し、チャットチャネルへのインシデント通知の送信に使用します。

      • レプリケーションセット内のリージョンを追加するたびに、[別のリージョンを追加] を選択し、リージョンおよび SNS トピックを追加します。

Amazon Chime
Amazon Chime でチャットチャネルを作成するには
  • 「AWS Chatbot Administrator Guide」の「Tutorial: Get started with Amazon Chime」の手順に従い、設定に以下を含めてください。

    • ステップ 11 の [ポリシーテンプレート] で、[Incident Manager のアクセス許可] を選択します。

    • ステップ 12 の [SNS トピック] セクションで、Amazon Chime ウェブフックに通知を送信する SNS トピックを選択します。

      • [リージョン 1] で、レプリケーションセットに含まれる AWS リージョン を選択します。

      • [トピック 1] で、そのリージョンで作成した SNS トピックを選択し、チャットチャネルへのインシデント通知の送信に使用します。

      • レプリケーションセット内のリージョンを追加するたびに、[別のリージョンを追加] を選択し、リージョンおよび SNS トピックを追加します。

注記

インシデント応答者が Slack や Microsoft Teams のチャットチャネルで使用できるチャットコマンドは、Amazon Chime ではサポートされていません。

タスク 3: Incident Manager の対応計画にチャットチャネルを追加する

対応計画を作成または更新するときに、応答者が連絡を取り、最新情報を受け取るためのチャットチャネルを追加できます。

対応計画の作成」の手順に従うときは、セクション「(オプション) インシデント対応チャットチャネルの指定」で、この対応計画に関連するインシデントに使用するチャネルを選択してください。

チャットチャネルを通じた対話

Slack および Microsoft Teams のチャネルの場合、Incident Manager を使用すると、応答者は以下の ssm-incidents コマンドを使用してチャットチャネルから直接インシデントと対話できるようになります。

アクティブなインシデントのチャットチャネルでコマンドを実行するには、以下の形式を使用します。cli-options は、コマンドに含めるオプションに置き換えてください。

@aws ssm-incidents cli-options

例:

@aws ssm-incidents start-incident --response-plan-arn arn:aws:ssm-incidents::111122223333:response-plan/test-response-plan-chat --region us-east-2
@aws ssm-incidents create-timeline-event --event-data "\"example timeline event"\" --event-time 2023-03-31 T20:30:00.000 --event-type Custom Event --incident-record-arn arn:aws:ssm-incidents::111122223333:incident-record/MyResponsePlanChat/98c397e6-7c10-aa10-9b86-f199aEXAMPLE
@aws ssm-incidents list-incident-records