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 也會直接將事件的任何更新和通知推送至聊天頻道。它使用您在聊天室組態中指定的一或多個 Amazon Simple Notification Service (Amazon SNS) 主題傳送這些通知。 聊天應用程式中的 Amazon Q Developer 和 Incident Manager 支援下列應用程式中的聊天頻道： + 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 主題納入事件通知。根據最佳實務，您應該在新增至複寫集的每個 中建立 SNS AWS 區域 主題。 **提示** 如需更線性的設定工作流程，建議您先設定 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 Resource Name (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 Resource Name (ARN)，格式為 `arn:aws:sns:us-east-2:111122223333:My_SNS_topic`。 + {{account-id}} 是您正在使用 AWS 帳戶 之 的 ID，例如 `111122223333`。 1. 選擇**儲存變更**。 1. 在複寫集中包含的每個區域中重複此程序。 ## 任務 2：在聊天應用程式中在 Amazon Q Developer 中建立聊天頻道 您可以在 Slack、 Microsoft Teams或 Amazon Chime 中建立聊天頻道。每個回應計畫只需要一個聊天頻道。 對於您的聊天頻道，我們建議您遵循最低權限主體 （不要為使用者提供比完成其任務所需的更多許可）。您也應該在聊天應用程式聊天頻道中定期檢閱 Amazon Q 開發人員的成員資格。檢閱有助於檢查只有適當的回應者和其他利益相關者可以存取您的聊天頻道。 在聊天應用程式中於 Amazon Q Developer 建立的Slack頻道和Microsoft Teams頻道中，事件回應者可以直接從 Slack或Microsoft Teams應用程式執行多個 Incident Manager CLI 命令。如需詳細資訊，請參閱[透過聊天頻道互動](#chat-interact)。 **重要** 您新增至聊天頻道的使用者必須是呈報或回應計劃中列出的相同聯絡人。您也可以將其他使用者新增至聊天頻道，例如利益相關者和事件觀察者。 如需聊天應用程式中 Amazon Q Developer 的一般資訊，請參閱[聊天應用程式中 Amazon Q Developer 管理員指南中的聊天應用程式中什麼是](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html) *Amazon Q Developer*。 從下列應用程式中選擇，在 中建立您的頻道： ------ #### [ 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 不支援在 Slack和聊天頻道中使用哪些事件回應程式的Microsoft Teams聊天命令。 ------ ## 任務 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 ```