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 il messaggio di errore "account_inactive". Se trovi il messaggio di 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 il messaggio di errore "channel_not_found". Se non hai aggiunto l'applicazione di chat al canale privato, ricevi questo messaggio di 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 la sottoscrizione del topic Amazon SNS per Amazon Q Developer

Completa i seguenti passaggi:

1. Apri la console Amazon Q Developer.
2. Nel pannello di navigazione, in 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 Modifica.
5. Nel pannello Dettagli, alla voce Argomenti, cerca il topic SNS. Se il topic non è elencato, effettua la sottoscrizione del topic SNS per Amazon Q Developer.

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 Argomenti, quindi seleziona il nome del topic SNS.
3. In 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 la sottoscrizione del topic SNS per Amazon Q Developer.
   Nota: utilizza la configurazione di Amazon Q Developer per inviare una notifica di prova.

Assicurati di non pubblicare manualmente messaggi nel topic SNS in un formato non supportato da Amazon Q Developer

Amazon Q Developer supporta i messaggi pubblicati manualmente in un topic SNS. Tuttavia, il formato del messaggio deve essere compatibile con Amazon Q Developer. Qualsiasi servizio 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 nel topic Amazon SNS

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

Per un elenco dei servizi AWS 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 Argomenti.
3. Seleziona il topic SNS che hai sottoscritto per Amazon Q Developer.
4. Scegli la scheda Policy di accesso.
5. Esamina la sezione Statement (Istruzione) della policy di accesso. Assicurati che la policy consenta al servizio AWS corretto di eseguire l'azione API SNS:Publish.
6. Se la policy di accesso di Amazon SNS non consente al servizio AWS corretto di pubblicare eventi nel topic, aggiorna la policy:
   Nella sezione Dettagli della pagina del topic, scegli Modifica.
   Espandi la sezione Policy di accesso, quindi aggiungi il controllo dell'accesso corretto.

Nota: per esempi di policy di accesso di Amazon SNS, consulta Configura i topic di Amazon SNS per le notifiche.

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

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 abilitata, completa i seguenti passaggi:

1. Apri la console Amazon SNS.
2. Nel pannello di navigazione, scegli Argomenti, quindi seleziona il nome del topic SNS.
3. Nel pannello Dettagli, alla voce Consegna di messaggi non elaborati, controlla se lo stato è abilitata o disabilitato.
4. Se lo stato è abilitato, completa le seguenti azioni:
   Scegli Modifica.
   Deseleziona Abilita consegna di messaggi non elaborati per disabilitare la consegna di messaggi non elaborati.
   Scegli Salva le 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. Se Amazon Q Developer riceve più di 10 eventi al secondo, i messaggi aggiuntivi vengono limitati.

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

(Per Amazon EventBridge) Assicurati che EventBridge supporti le notifiche di eventi inviate dai servizi AWS alla destinazione del cliente 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?