AWS Systems Manager Incident Manager 不再向新客户开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [AWS Systems Manager Incident Manager 可用性变更](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-manager-availability-change.html)。 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 在事件管理器中为响应者创建和集成聊天频道 事件管理器是一个工具 AWS Systems Manager，它使事件响应者能够在事件发生期间通过*聊天渠道*直接进行沟通。*聊天频道*是您在 [Amazon Q Developer 中的聊天应用程序中设置的聊天室](https://docs.aws.amazon.com/chatbot/latest/adminguide/)。然后，您可以将该频道连接到 Incident Manager 中的响应计划。 在事件发生期间，响应者使用聊天频道就事件相互沟通。Incident Manager 还会将有关事件的所有更新和通知直接推送到聊天频道。它会使用您在聊天室配置中指定的一个或多个 Amazon Simple Notification Service (Amazon SNS) 主题发送这些通知。 聊天应用程序中的 Amazon Q Developer 和事件管理器支持以下应用程序中的聊天频道： + Slack + Microsoft Teams + Amazon Chime 在事件中设置聊天频道的过程包括在三种不同的 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 使用与响应计划关联的一个或多个主题，向事件响应者发送有关事件的通知。 在响应计划中，您可以在事件通知中加入一个或多个 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}}" } } } ``` 按{{placeholder values}}如下方式替换： + {{sns-topic-arn}}是您为该区域创建的主题的亚马逊资源名称 (ARN)，格式为。`arn:aws:sns:us-east-2:111122223333:My_SNS_topic` + {{account-id}}是您正在 AWS 账户 使用的的 ID，例如`111122223333`。 1. 选择**保存更改**。 1. 在复制集中包含的每个区域重复该过程。 ## 任务 2：在 Amazon Q Developer 的聊天应用程序中创建聊天频道 你可以在Slack、或 Amazon Chim Microsoft Teams e 中创建聊天频道。每个响应计划只需一个聊天频道。 对于您的聊天频道，我们建议您遵循最低权限原则（不要向用户提供超过完成任务所需的权限）。您还应该定期在聊天应用程序聊天频道中查看您的 Amazon Q 开发者的成员资格。查看有助于检查只有相应的响应者和其他利益相关者才能访问聊天频道。 在 Amazon Q Developer 的聊天应用程序中创建的SlackMicrosoft Teams频道和频道中，事件响应者可以直接从Slack或Microsoft Teams应用程序运行多个 Incident Manager CLI 命令。有关更多信息，请参阅 [通过聊天频道进行互动](#chat-interact)。 **重要** 您添加到聊天频道的用户必须与上报或响应计划中列出的联系人相同。您还可以向聊天频道添加其他用户，例如利益相关者和事件观察者。 有关聊天应用程序中的 Amazon Q Develo [per 的一般信息，请参阅聊天应用程序中的 Amazon Q 开发者*管理员指南中的聊天应用程序中的 Amazon Q 开发者*是什么](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html)。 从以下应用程序中进行选择以创建您的频道： ------ #### [ Slack ] 该步骤提供了建议的权限设置，允许所有频道用户使用 Incident Manager 的聊天命令。使用支持的聊天命令，您的事件响应者可以直接从Slack聊天频道更新事件并与之互动。有关信息，请参阅[通过聊天频道进行互动](#chat-interact)。 **要在中创建聊天频道 Slack** + 按照《*Amazon Q 聊天应用程序开发者管理员指南》Slack中的 “[教程：入门](https://docs.aws.amazon.com/chatbot/latest/adminguide/slack-setup.html)” 中的*步骤进行操作，并在您的配置中包含以下内容。 + 在步骤 10 中，对于**角色设置**，选择**频道角色**。 + 在步骤 10d 中，对于**策略模板**，选择 **Incident Manager 权限**。 + 在步骤 11 中，对于**频道防护机制策略**，在**策略名称**中，选择 [https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AWSIncidentManagerResolverAccess$jsonEditor](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 开发者聊天应用程序管理员指南》Microsoft Teams中的 “[教程：入门](https://docs.aws.amazon.com/chatbot/latest/adminguide/teams-setup.html)” 中的*步骤进行操作，并在您的配置中包括以下内容： + 在步骤 10 中，对于**角色设置**，选择**频道角色**。 + 在步骤 10d 中，对于**策略模板**，选择 **Incident Manager 权限**。 + 在步骤 11 中，对于**频道防护机制策略**，在**策略名称**中，选择 [https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AWSIncidentManagerResolverAccess$jsonEditor](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 聊天应用程序开发者管理员指南》中的 “教程：开始使用 Amazon Chime](https://docs.aws.amazon.com/chatbot/latest/adminguide/chime-setup.html)*” 中的*步骤进行操作，并在您的配置中包含以下内容： + 在步骤 11 中，对于**策略模板**，选择 **Incident Manager 权限**。 + 在步骤 12 中，在 **SNS 主题**部分，选择将向 Amazon Chime Webhook 发送通知的 SNS 主题： + 对于**区域 1** AWS 区域 ，选择您的复制集中包含的。 + 对于**主题 1**，选择您在该区域创建的 SNS 主题，用于向聊天频道发送事件通知。 + 对于复制集中的每个其他区域，请选择**添加其他区域**，然后添加其他区域和 SNS 主题。 **注意** Amazon Chime 不支持事件响应人员可以在Microsoft Teams聊天频道中Slack使用的聊天命令。 ------ ## 任务 3：将聊天频道添加到 Incident Manager 的响应计划中 创建或更新响应计划时，您可以添加聊天渠道，供响应者通过聊天频道进行沟通和接收更新。 按照 [制定响应计划](response-plans.md#response-plans-create) 中的步骤操作时，在 **[（可选）指定事件响应聊天频道](response-plans.md#chat-channel)** 部分中，选择要用于处理与该响应计划相关的事件的频道。 ## 通过聊天频道进行互动 对于Slack和中的频道Microsoft Teams，事件管理器允许响应者使用以下`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 ```