AWS Systems Manager Incident Manager は新規顧客に公開されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[AWS Systems Manager Incident Manager 可用性の変更](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-manager-availability-change.html)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Incident Manager でのレスポンダーのチャットチャネルの作成と統合
のツールである Incident Manager は AWS Systems Manager、インシデント対応者がインシデント中に*チャットチャネル*を介して直接通信できるようにします。*チャットチャネル*は、チャット[アプリケーションで Amazon Q Developer で設定したチャット](https://docs.aws.amazon.com/chatbot/latest/adminguide/)ルームです。次に、このチャネルを Incident Manager の対応計画に接続します。
インシデント中に、応答者はチャットチャネルを使用してインシデントについて互いに連絡を取ります。また、Incident Manager は、インシデントに関する更新や通知をチャットチャネルに直接プッシュします。Incident Manager は、これらの通知をチャットルーム設定で指定した 1 つ以上の Amazon Simple Notification Service (Amazon SNS) トピックを使用して送信します。
チャットアプリケーションの Amazon Q Developer と Incident Manager は、次のアプリケーションでチャットチャネルをサポートしています。
+ Slack
+ Microsoft Teams
+ Amazon Chime
インシデントで使用するチャットチャネルをセットアップするプロセスは、3 つの異なる Amazon Web Services サービスのタスクで構成されています。
**Topics**
+ [タスク 1: チャットチャネルの Amazon SNS トピックを作成または更新する](#sns-topic)
+ [タスク 2: チャットアプリケーションで Amazon Q Developer にチャットチャネルを作成する](#chat-create)
+ [タスク 3: Incident Manager の対応計画にチャットチャネルを追加する](#response-plan)
+ [チャットチャネルを通じた対話](#chat-interact)
## タスク 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 トピックを作成](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html)」の手順を行います。
**注記**
トピックを作成した後、トピックを編集してアクセスポリシーを更新します。
1. 作成したトピックを選択し、トピックの Amazon リソースネーム (ARN) を `arn:aws:sns:us-east-2:111122223333:My_SNS_topic` などの形式でメモするかコピーします。
1. **[編集]** を選択し、**[アクセスポリシー]** セクションを展開して、デフォルト以外の追加のアクセス許可を設定します。
1. 以下のステートメントをポリシーの **[ステートメント]** 配列に追加します。
```
{
"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`。
1. **[Save changes]** (変更の保存) をクリックします。
1. レプリケーションセットに含まれる各リージョンでこの処理を繰り返します。
## タスク 2: チャットアプリケーションで Amazon Q Developer にチャットチャネルを作成する
チャットチャネルは、Slack、Microsoft Teams、または Amazon Chime で作成できます。対応計画ごとに必要なチャットチャネルは 1 つだけです。
チャットチャネルについては、最小特権のプリンシパルに従うことをお勧めします (タスクを完了するために必要以上のアクセス許可をユーザーに与えない)。また、チャットアプリケーションのチャットチャネルで Amazon Q Developer のメンバーシップを定期的に確認する必要があります。レビューは、適切な応答者および他のステークホルダーのみがチャットチャネルにアクセスできることを確認するのに役立ちます。
チャットアプリケーションで Amazon Q Developer で作成されたSlackチャネルおよびMicrosoft Teamsチャネルでは、インシデント対応者は Slackまたは Microsoft Teamsアプリケーションから直接多数の Incident Manager CLI コマンドを実行できます。詳細については、「[チャットチャネルを通じた対話](#chat-interact)」を参照してください。
**重要**
チャットチャネルに追加するユーザーは、エスカレーション計画または対応計画に記載されている連絡先と同じである必要があります。また、ステークホルダーおよびインシデントオブザーバーなどのユーザーをチャットチャネルに追加することもできます。
チャットアプリケーションの Amazon Q Developer に関する一般的な情報については、[「Amazon Q Developer in chat applications Administrator Guide](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html)*」の「What is Amazon Q Developer in chat applications*」を参照してください。
チャネルを作成するアプリケーションを以下から選択してください。
------
#### [ Slack ]
この手順のステップでは、すべてのチャネルユーザーが Incident Manager でチャットコマンドを使用できるようにするために、推奨されるアクセス許可設定を示します。サポートされているチャットコマンドを使用すると、インシデント対応者はSlackチャットチャネルから直接インシデントを更新して操作できます。詳細については、「[チャットチャネルを通じた対話](#chat-interact)」を参照してください。
**でチャットチャネルを作成するには Slack**
+ [「Amazon Q Developer in chat applications 管理者ガイド」の「チュートリアル: の使用を開始するSlack](https://docs.aws.amazon.com/chatbot/latest/adminguide/slack-setup.html)」のステップに従い、設定に以下を含めます。 **
+ ステップ 10 の **[ロール設定]** で **[チャネルロール]** を選択します。
+ ステップ 10d の **[ポリシーテンプレート]** で、**[Incident Manager のアクセス許可]** を選択します。
+ ステップ 11 の **[チャネルガードレールのポリシー]** の、**[ポリシー名]** で [[`AWSIncidentManagerResolverAccess`]](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AWSIncidentManagerResolverAccess$jsonEditor) を選択します。
+ ステップ 12 の **[SNS トピック]** セクションで、以下の操作を行います。
+ **リージョン 1 ** AWS リージョン では、レプリケーションセットに含まれる を選択します。
+ **[トピック 1]** で、そのリージョンで作成した SNS トピックを選択し、チャットチャネルへのインシデント通知の送信に使用します。
+ レプリケーションセット内のリージョンを追加するたびに、**[別のリージョンを追加]** を選択し、リージョンおよび SNS トピックを追加します。
------
#### [ Microsoft Teams ]
この手順のステップでは、すべてのチャネルユーザーが Incident Manager でチャットコマンドを使用できるようにするために、推奨されるアクセス許可設定を示します。サポートされているチャットコマンドを使用すると、インシデント対応者はMicrosoft Teamsチャットチャネルから直接インシデントを更新して操作できます。詳細については、「[チャットチャネルを通じた対話](#chat-interact)」を参照してください。
**でチャットチャネルを作成するには Microsoft Teams**
+ [「Amazon Q Developer in chat applications 管理者ガイド」の「チュートリアル: の使用を開始するMicrosoft Teams](https://docs.aws.amazon.com/chatbot/latest/adminguide/teams-setup.html)」のステップに従い、設定に以下を含めます。 **
+ ステップ 10 の **[ロール設定]** で **[チャネルロール]** を選択します。
+ ステップ 10d の **[ポリシーテンプレート]** で、**[Incident Manager のアクセス許可]** を選択します。
+ ステップ 11 の **[チャネルガードレールのポリシー]** の、**[ポリシー名]** で [[`AWSIncidentManagerResolverAccess`]](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AWSIncidentManagerResolverAccess$jsonEditor) を選択します。
+ ステップ 12 の **[SNS トピック]** セクションで、以下の操作を行います。
+ **リージョン 1 ** AWS リージョン では、レプリケーションセットに含まれる を選択します。
+ **[トピック 1]** で、そのリージョンで作成した SNS トピックを選択し、チャットチャネルへのインシデント通知の送信に使用します。
+ レプリケーションセット内のリージョンを追加するたびに、**[別のリージョンを追加]** を選択し、リージョンおよび SNS トピックを追加します。
------
#### [ Amazon Chime ]
**Amazon Chime でチャットチャネルを作成するには**
+ [「Amazon Q Developer in chat applications 管理者ガイド」の「チュートリアル: Amazon Chime の使用を開始する](https://docs.aws.amazon.com/chatbot/latest/adminguide/chime-setup.html)」のステップに従い、設定に以下を含めます。 **
+ ステップ 11 の **[ポリシーテンプレート]** で、**[Incident Manager のアクセス許可]** を選択します。
+ ステップ 12 の **[SNS トピック]** セクションで、Amazon Chime ウェブフックに通知を送信する SNS トピックを選択します。
+ **リージョン 1 ** AWS リージョン では、レプリケーションセットに含まれる を選択します。
+ **[トピック 1]** で、そのリージョンで作成した SNS トピックを選択し、チャットチャネルへのインシデント通知の送信に使用します。
+ レプリケーションセット内のリージョンを追加するたびに、**[別のリージョンを追加]** を選択し、リージョンおよび SNS トピックを追加します。
**注記**
インシデント応答者が Slackおよびチャットチャネルで使用できるMicrosoft Teamsチャットコマンドは、Amazon Chime ではサポートされていません。
------
## タスク 3: Incident Manager の対応計画にチャットチャネルを追加する
対応計画を作成または更新するときに、応答者が連絡を取り、最新情報を受け取るためのチャットチャネルを追加できます。
「[対応計画の作成](response-plans.md#response-plans-create)」の手順に従うときは、セクション「**[(オプション) インシデント対応チャットチャネルの指定](response-plans.md#chat-channel)**」で、この対応計画に関連するインシデントに使用するチャネルを選択してください。
## チャットチャネルを通じた対話
Slack および のチャネルの場合Microsoft Teams、Incident Manager は、次の`ssm-incidents`コマンドを使用して、応答者がチャットチャネルから直接インシデントとやり取りできるようにします。
+ [start-incident](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/start-incident.html)
+ [list-response-plan](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/list-response-plan.html)
+ [get-response-plan](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/get-response-plan.html)
+ [create-timeline-event](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/create-timeline-event.html)
+ [delete-timeline-event](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/delete-timeline-event.html)
+ [get-incident-record](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/get-incident-record.html)
+ [get-timeline-event](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/get-timeline-event.html)
+ [list-incident-records](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/list-incident-records.html)
+ [list-timeline-events](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/list-timeline-events.html)
+ [list-related-items](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/list-related-items.html)
+ [update-related-items](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/update-related-items.html)
+ [update-incident-record](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/update-incident-record.html)
+ [update-timeline-event](https://docs.aws.amazon.com/cli/latest/reference/ssm-incidents/update-timeline-event.html)
アクティブなインシデントのチャットチャネルでコマンドを実行するには、以下の形式を使用します。{{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
```