Perché il mio Amazon Q Developer non riceve messaggi da Amazon SNS?

Breve descrizione

Amazon Q Developer non ha ricevuto notifiche dal topic Amazon SNS per uno dei seguenti motivi:

• Il canale di comunicazione tra Amazon Q Developer e il canale Slack non è configurato correttamente.
• Il canale di comunicazione tra il topic SNS e Amazon Q Developer non è configurato correttamente.

Risoluzione

Attiva CloudWatch Logs per Amazon Q Developer

Se non l'hai già fatto, attiva Amazon CloudWatch Logs per Amazon Q Developer nelle applicazioni di chat per esaminare i messaggi di errore.

Verifica di aver configurato correttamente il canale di comunicazione tra Amazon Q Developer e il canale Slack

Assicurati che il canale Slack non sia archiviato o eliminato

Se un canale Slack viene archiviato o eliminato, non può ricevere messaggi e Slack disattiva tutte le app.

Per annullare l'archiviazione di un canale, consulta Archiviare o eliminare un canale sul sito web Slack.

Nota: non puoi ripristinare un canale Slack eliminato. Se il canale Slack con cui è stata effettuata la sottoscrizione è stato eliminato, crea un nuovo canale Slack e configuralo per ricevere notifiche dal topic.

Verifica di aver installato l'applicazione di chat nel workspace Slack

Controlla in CloudWatch Logs per le applicazioni di chat se è presente l'errore "account_inactive". Se trovi l'errore "account_inactive", significa che l'applicazione di chat non è stata installata nel workspace Slack.

Per installare l'applicazione di chat nel workspace Slack, segui le istruzioni fornite in Tutorial: Get started with Slack (Tutorial: inizia a usare Slack).

(Solo per canali Slack privati) Verifica di aver aggiunto l'applicazione di chat al canale Slack

Controlla in CloudWatch Logs per le applicazioni di chat se è presente l'errore "channel_not_found". Se non hai aggiunto l'applicazione di chat al canale privato, ricevi questo errore.

Per aggiungere Amazon Q Developer a un canale Slack privato, esegui il comando /invite @Amazon Q nel canale privato.

Per Slack, Amazon Chime e Microsoft Teams

Verifica di aver configurato correttamente il canale di comunicazione tra il topic SNS e Amazon Q Developer.

Verifica di aver effettuato per Amazon Q Developer la sottoscrizione del topic Amazon SNS

Completa i seguenti passaggi:

1. Apri la console Amazon Q Developer.
2. Nel pannello di navigazione, in Configured clients (Client configurati), scegli Slack, Amazon Chime o Microsoft Teams.
3. Seleziona il canale Slack nella configurazione del workspace Slack, il webhook nell'elenco dei webhook di Amazon Chime o il canale Microsoft Teams.
4. Scegli Edit (Modifica).
5. Nel pannello Details (Dettagli), alla voce Topics (Argomenti), cerca il topic SNS. Se il topic non è elencato, effettua per Amazon Q Developer la sottoscrizione del topic SNS.

Verifica di aver inserito l'endpoint di Amazon Q Developer per la sottoscrizione del topic Amazon SNS

Completa i seguenti passaggi:

1. Apri la console Amazon SNS.
2. Nel pannello di navigazione scegli Topics (Argomenti), quindi seleziona il nome del topic SNS.
3. In Subscriptions (Sottoscrizioni), cerca il seguente endpoint di Amazon Q Developer: https://global.sns-api.chatbot.amazonaws.com. Se l'endpoint di Amazon Q Developer non figura come sottoscrizione del topic, devi effettuare per Amazon Q Developer la sottoscrizione del topic SNS.
   Nota: utilizza la configurazione di Amazon Q Developer per inviare una notifica di prova.

Assicurati di non pubblicare manualmente messaggi in un formato non supportato

Amazon Q Developer supporta messaggi pubblicati manualmente su un topic SNS. Tuttavia, il formato del messaggio deve essere compatibile con Amazon Q Developer. Qualsiasi servizio AWS configurato per inviare messaggi deve inviare notifiche Amazon SNS ad Amazon Q Developer solo tramite i servizi supportati da Amazon Q Developer.

Verifica che Amazon Q Developer supporti i messaggi del servizio AWS pubblicati

Controlla in CloudWatch Logs per le applicazioni di chat se è presente l'errore "Event Received is not supported". Se ricevi l'errore "Event Received is not supported", significa che Amazon Q Developer non supporta il messaggio del servizio pubblicato nel topic.

Per un elenco dei servizi supportati da Amazon Q Developer, consulta Monitoring AWS services using Amazon Q Developer in chat applications (Monitoraggio dei servizi AWS utilizzando Amazon Q Developer nelle applicazioni di chat).

Assicurati che il topic Amazon SNS conceda le autorizzazioni necessarie per la pubblicazione di messaggi da parte di un altro servizio AWS

Completa i seguenti passaggi:

1. Apri la console Amazon SNS.
2. Nel pannello di navigazione, scegli Topics (Argomenti).
3. Seleziona il topic SNS che hai sottoscritto per Amazon Q Developer.
4. Scegli la scheda Access policy (Policy di accesso).
5. Controlla la sezione Statement (Istruzione) della policy di accesso. Assicurati che la policy consenta al servizio corretto di eseguire l'azione API SNS:Publish.
6. Se la policy di accesso di Amazon SNS non consente al servizio corretto di pubblicare eventi nel topic, aggiorna la policy. Nella sezione Details (Dettagli) della pagina del topic scegli Edit (Modifica). Espandi la sezione Access policy (Policy di accesso), quindi aggiungi il controllo dell'accesso corretto.
   Nota: per esempi di policy di accesso di Amazon SNS, consulta Configure Amazon SNS topics for notifications (Configura gli argomenti di Amazon SNS per le notifiche).

Verifica che il topic Amazon SNS non abbia la consegna di messaggi non elaborati attivata

Amazon Q Developer non accetta la consegna di messaggi non elaborati. Per verificare che il topic SNS non abbia la consegna di messaggi non elaborati attivata, completa i seguenti passaggi:

1. Apri la console Amazon SNS.
2. Nel pannello di navigazione scegli Topics (Argomenti), quindi seleziona il nome del topic SNS.
3. Nel pannello Details (Dettagli), alla voce Raw message delivery (Consegna di messaggi non elaborati), controlla se lo stato è enabled (abilitato) o disabled (disabilitato).
4. Se lo stato è enabled (abilitato), completa le seguenti azioni: Scegli Edit (Modifica). Deseleziona Enable raw message delivery (Abilita consegna di messaggi non elaborati) per disabilitare la consegna di messaggi non elaborati. Scegli Save changes (Salva modifiche).

Assicurati di includere le autorizzazioni della policy della chiave AWS KMS richieste

Nota: Questo controllo è applicabile solo ai topic SNS con crittografia lato server attivata.

La policy della chiave del Servizio AWS di gestione delle chiavi (AWS KMS) deve consentire la pubblicazione del servizio che invia messaggi nei topic SNS crittografati.

La policy della chiave AWS KMS deve includere la seguente sezione:

{  "Sid": "Allow CWE to use the key",  "Effect": "Allow",  "Principal": {    "Service": "service.amazonaws.com"  },  "Action": [    "kms:Decrypt",    "kms:GenerateDataKey"  ],  "Resource": "*"}

Importante: sostituisci events.amazonaws.com con il principale del servizio AWS per il servizio che pubblica i topic SNS crittografati.

Verifica che i servizi AWS non pubblichino messaggi nel topic Amazon SNS con una frequenza superiore a 10 notifiche al secondo

Amazon Q Developer consente 10 eventi al secondo. Amazon Q Developer limita i messaggi aggiuntivi quando riceve più di 10 eventi al secondo.

Per verificare se sono presenti eventi limitati, consulta la metrica CloudWatch EventsThrottled in CloudWatch Metrics per Amazon Q Developer.

(Per Amazon EventBridge) Assicurati che EventBridge supporti le notifiche di eventi inviate dai servizi AWS alla destinazione del client Amazon Q Developer

Utilizza un trasformatore di input EventBridge per generare notifiche personalizzate e inoltrarle a un topic SNS. Monitora il topic SNS e invia notifiche ai canali Microsoft Teams, Amazon Chime o Slack configurati con Amazon Q Developer. Le notifiche personalizzate di Amazon Q Developer devono seguire il formato schema eventi.

Per ulteriori informazioni, consulta Supported services for Amazon Q Developer in chat applications (Servizi supportati per Amazon Q Developer nelle applicazioni di chat).

Informazioni correlate

Troubleshooting Amazon Q Developer in chat applications (Risoluzione dei problemi di Amazon Q Developer nelle applicazioni di chat)

Come posso utilizzare webhook per pubblicare messaggi di Amazon SNS su Amazon Chime, Slack o Microsoft Teams?