Strumento di gestione degli incidenti AWS Systems Manager non è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, vedi [modifica della Strumento di gestione degli incidenti AWS Systems Manager disponibilità](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-manager-availability-change.html).
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Creazione e integrazione di canali di chat per i soccorritori in Incident Manager
Incident Manager, uno strumento di AWS Systems Manager, offre ai soccorritori la possibilità di comunicare direttamente attraverso i *canali di chat* durante un incidente. Un *canale di chat* è una chat room che configuri in [Amazon Q Developer nelle applicazioni di chat](https://docs.aws.amazon.com/chatbot/latest/adminguide/). Quindi connetti questo canale a un piano di risposta in Incident Manager.
Durante un incidente, i soccorritori utilizzano il canale di chat per comunicare tra loro in merito all'incidente. Incident Manager invia inoltre eventuali aggiornamenti e notifiche sull'incidente direttamente al canale di chat. Invia queste notifiche utilizzando uno o più argomenti di Amazon Simple Notification Service (Amazon SNS) specificati nella configurazione della chat room.
Amazon Q Developer nelle applicazioni di chat e Incident Manager supportano i canali di chat nelle seguenti applicazioni:
+ Slack
+ Microsoft Teams
+ Amazon Chime
Il processo di configurazione di un canale di chat da utilizzare negli incidenti consiste in attività in tre diversi servizi Amazon Web Services.
**Topics**
+ [Attività 1: creare o aggiornare argomenti Amazon SNS per il tuo canale di chat](#sns-topic)
+ [Attività 2: creare un canale di chat in Amazon Q Developer nelle applicazioni di chat](#chat-create)
+ [Attività 3: aggiungi il canale di chat a un piano di risposta in Incident Manager](#response-plan)
+ [Interagire tramite il canale di chat](#chat-interact)
## Attività 1: creare o aggiornare argomenti Amazon SNS per il tuo canale di chat
**Amazon SNS è un servizio gestito che fornisce il recapito dei messaggi dagli editori agli abbonati (noti anche come produttori e consumatori).** Gli editori comunicano in modo asincrono con gli abbonati creando e inviando messaggi a un *argomento*, che rappresenta un punto di accesso logico e un canale di comunicazione. Incident Manager utilizza uno o più argomenti associati a un piano di risposta per inviare notifiche relative a un incidente ai soccorritori.
In un piano di risposta, puoi includere uno o più argomenti di Amazon SNS nelle notifiche degli incidenti. Come best practice, dovresti creare un argomento SNS in ognuno dei temi Regione AWS che hai aggiunto al tuo set di replica.
**Suggerimento**
Per un flusso di lavoro di configurazione più lineare, ti consigliamo di configurare prima gli argomenti di Amazon SNS da utilizzare con Incident Manager. Una volta configurato, puoi creare il canale di chat.
**Per creare o aggiornare argomenti di Amazon SNS per il tuo canale di chat**
1. Segui i passaggi indicati nell'[argomento Creazione di un Amazon SNS nella Guida per gli sviluppatori di Amazon Simple](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) *Notification Service*.
**Nota**
Dopo aver creato l'argomento, lo modifichi per aggiornarne la politica di accesso.
1. Seleziona l'argomento che hai creato e annota o copia l'Amazon Resource Name (ARN) dell'argomento, in un formato come. `arn:aws:sns:us-east-2:111122223333:My_SNS_topic`
1. Scegli **Modifica**, quindi espandi la sezione **Politica di accesso** per configurare autorizzazioni di accesso aggiuntive oltre a quelle predefinite.
1. **Aggiungi la seguente dichiarazione all'array Statement della policy:**
```
{
"Sid": "IncidentManagerSNSPublishingPermissions",
"Effect": "Allow",
"Principal": {
"Service": "ssm-incidents.amazonaws.com"
},
"Action": "SNS:Publish",
"Resource": "sns-topic-arn",
"Condition": {
"StringEqualsIfExists": {
"AWS:SourceAccount": "account-id"
}
}
}
```
Sostituisci *placeholder values* come segue:
+ *sns-topic-arn*è l'Amazon Resource Name (ARN) dell'argomento che hai creato per questa regione, nel formato. `arn:aws:sns:us-east-2:111122223333:My_SNS_topic`
+ *account-id*è l'ID dell'ambiente in Account AWS cui stai lavorando, ad esempio`111122223333`.
1. Scegli **Save changes** (Salva modifiche).
1. Ripetere il processo in ogni regione inclusa nel set di replica.
## Attività 2: creare un canale di chat in Amazon Q Developer nelle applicazioni di chat
Puoi creare un canale di chat in SlackMicrosoft Teams, o Amazon Chime. È necessario un solo canale di chat per ogni piano di risposta.
Per i tuoi canali di chat, ti consigliamo di seguire il principio del privilegio minimo (non fornire agli utenti più autorizzazioni di quelle necessarie per completare le loro attività). Inoltre, dovresti controllare regolarmente l'iscrizione del tuo sviluppatore Amazon Q nei canali di chat delle applicazioni di chat. Le recensioni aiutano a verificare che solo i rispondenti appropriati e le altre parti interessate abbiano accesso ai tuoi canali di chat.
Nei Slack canali e nei Microsoft Teams canali creati in Amazon Q Developer nelle applicazioni di chat, i soccorritori possono eseguire una serie di comandi CLI di Incident Manager direttamente Slack dall'Microsoft Teamsapplicazione or. Per ulteriori informazioni, consulta [Interagire tramite il canale di chat](#chat-interact).
**Importante**
Gli utenti che aggiungi al tuo canale di chat devono essere gli stessi contatti elencati nel tuo piano di escalation o di risposta. Puoi anche aggiungere altri utenti ai canali di chat, come le parti interessate e gli osservatori degli incidenti.
Per informazioni generali su Amazon Q Developer nelle applicazioni di chat, consulta [What is Amazon Q Developer in chat applications](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html) nella *Amazon Q Developer in chat applications Administrator Guide*.
Scegli tra le seguenti applicazioni in cui creare il tuo canale:
------
#### [ Slack ]
I passaggi di questa procedura forniscono le impostazioni di autorizzazione consigliate per consentire a tutti gli utenti del canale di utilizzare i comandi di chat con Incident Manager. Utilizzando i comandi di chat supportati, i soccorritori possono aggiornare l'incidente e interagire con esso direttamente dal canale di Slack chat. Per informazioni, consulta [Interagire tramite il canale di chat](#chat-interact).
**Per creare un canale di chat in Slack**
+ Segui i passaggi indicati nel [Tutorial: Inizia Slack](https://docs.aws.amazon.com/chatbot/latest/adminguide/slack-setup.html) nella *Guida per amministratori delle applicazioni Amazon Q Developer in chat* e includi quanto segue nella tua configurazione.
+ Nel passaggio 10, per **le impostazioni del ruolo**, scegli il **ruolo del canale**.
+ Nel passaggio 10d, per i **modelli di policy**, seleziona **Autorizzazioni di Incident Manager**.
+ Nel passaggio 11, per le **politiche di Channel Guardrail**, per il **nome della politica**, scegli. [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)
+ Nel passaggio 12, nella sezione **Argomenti SNS**, procedi come segue:
+ Per la **Regione 1**, selezionane Regione AWS una inclusa nel set di replica.
+ Per **gli argomenti 1**, seleziona l'argomento SNS che hai creato in quella regione da utilizzare per inviare notifiche di incidenti al canale di chat.
+ Per ogni regione aggiuntiva del set di replica, scegli **Aggiungi un'altra regione e aggiungi** gli argomenti aggiuntivi su Regioni e SNS.
------
#### [ Microsoft Teams ]
I passaggi di questa procedura forniscono le impostazioni di autorizzazione consigliate per consentire a tutti gli utenti del canale di utilizzare i comandi di chat con Incident Manager. Utilizzando i comandi di chat supportati, i soccorritori possono aggiornare l'incidente e interagire con esso direttamente dal canale di Microsoft Teams chat. Per informazioni, consulta [Interagire tramite il canale di chat](#chat-interact).
**Per creare un canale di chat in Microsoft Teams**
+ Segui i passaggi indicati nel [Tutorial: Inizia Microsoft Teams](https://docs.aws.amazon.com/chatbot/latest/adminguide/teams-setup.html) nella *Guida per amministratori delle applicazioni Amazon Q Developer in chat* e includi quanto segue nella tua configurazione:
+ Nel passaggio 10, per **le impostazioni del ruolo**, scegli il **ruolo del canale**.
+ Nel passaggio 10d, per i **modelli di policy**, seleziona **Autorizzazioni di Incident Manager**.
+ Nel passaggio 11, per le **politiche di Channel Guardrail**, per il **nome della politica**, scegli. [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)
+ Nel passaggio 12, nella sezione **Argomenti SNS**, procedi come segue:
+ Per la **Regione 1**, selezionane Regione AWS una inclusa nel set di replica.
+ Per **gli argomenti 1**, seleziona l'argomento SNS che hai creato in quella regione da utilizzare per inviare notifiche di incidenti al canale di chat.
+ Per ogni regione aggiuntiva del set di replica, scegli **Aggiungi un'altra regione e aggiungi** gli argomenti aggiuntivi su Regioni e SNS.
------
#### [ Amazon Chime ]
**Per creare un canale di chat in Amazon Chime**
+ Segui i passaggi indicati nel [Tutorial: Inizia a usare Amazon Chime](https://docs.aws.amazon.com/chatbot/latest/adminguide/chime-setup.html) nella *Guida per amministratori delle applicazioni Amazon Q Developer in chat* e includi quanto segue nella tua configurazione:
+ Nel passaggio 11, per i **modelli di policy**, seleziona le **autorizzazioni di Incident Manager**.
+ Nel passaggio 12, nella sezione **Argomenti SNS**, seleziona gli argomenti SNS che invieranno notifiche al webhook Amazon Chime:
+ Per la **regione 1**, seleziona un elemento incluso nel Regione AWS set di replica.
+ Per **gli argomenti 1**, seleziona l'argomento SNS che hai creato in quella regione da utilizzare per inviare notifiche di incidenti al canale di chat.
+ Per ogni regione aggiuntiva del set di replica, scegli **Aggiungi un'altra regione e aggiungi** gli argomenti aggiuntivi su Regioni e SNS.
**Nota**
I comandi di chat, che i soccorritori possono utilizzare nei canali di Microsoft Teams chat Slack e nei canali di chat, non sono supportati in Amazon Chime.
------
## Attività 3: aggiungi il canale di chat a un piano di risposta in Incident Manager
Quando crei o aggiorni un piano di risposta, puoi aggiungere canali di chat tramite i quali i soccorritori possono comunicare e ricevere aggiornamenti.
Quando segui i passaggi indicati nella sezione [Creazione di un piano di risposta](response-plans.md#response-plans-create) **[(Facoltativo) Specificare un canale di chat per la risposta agli incidenti](response-plans.md#chat-channel)**, seleziona il canale che desideri utilizzare per gli incidenti relativi a questo piano di risposta.
## Interagire tramite il canale di chat
Per i canali in Slack andMicrosoft Teams, Incident Manager consente ai soccorritori di interagire con gli incidenti direttamente dal canale di chat utilizzando i seguenti comandi: `ssm-incidents`
+ [inizio-incidente](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)
Per eseguire comandi nel canale di chat di un incidente attivo, utilizza il seguente formato. Sostituisci *cli-options* con qualsiasi opzione da includere in un comando.
```
@aws ssm-incidents cli-options
```
Esempio:
```
@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
```