Pourquoi mon Amazon Q Developer ne reçoit-il pas de messages d'Amazon SNS ?

Brève description

Les notifications de votre rubrique Amazon SNS n'ont pas été transmises à Amazon Q Developer pour l'une des raisons suivantes :

• Le canal de communication entre Amazon Q Developer et le canal Slack est incorrectement configuré.
• Le canal de communication entre la rubrique SNS et Amazon Q Developer est incorrectement configuré.

Résolution

Activer CloudWatch Logs pour Amazon Q Developer

Si ce n'est pas déjà fait, activez Amazon CloudWatch Logs pour Amazon Q Developer dans les applications de chat afin de consulter les messages d'erreur.

Vérifier que vous avez correctement configuré le canal de communication entre Amazon Q Developer et le canal Slack

S'assurer que le canal Slack n'est ni archivé ni supprimé

Si un canal Slack est archivé ou supprimé, il ne peut pas recevoir de messages et Slack désactive toutes les applications.

Pour désarchiver un canal, consultez la page Archiver ou supprimer un canal sur le site Web de Slack.

Remarque : vous ne pouvez pas restaurer un canal Slack supprimé. Si le canal Slack auquel vous êtes abonné est supprimé, créez un nouveau canal Slack, puis configurez-le pour recevoir des notifications relatives à votre rubrique.

Vérifier que vous avez installé l'application de chat sur votre espace de travail Slack

Consultez les journaux CloudWatch de votre application de chat pour détecter l'erreur « account_inactive ». Si l'erreur « account_inactive » s'affiche, cela signifie que votre application de chat ne s'est pas installée sur votre espace de travail Slack.

Pour installer l'application de chat sur votre espace de travail Slack, suivez les instructions du didacticiel : Démarrer avec Slack.

(Pour les canaux privés Slack uniquement) Vérifier que vous avez ajouté l'application de chat au canal Slack

Consultez les journaux CloudWatch de votre application de chat pour détecter l'erreur « channel_not_found ». Si vous n'avez pas ajouté votre application de chat au canal privé, cette erreur s'affiche.

Pour ajouter Amazon Q Developer à un canal Slack privé, exécutez la commande /invite @Amazon Q du canal privé.

Pour Slack, Amazon Chime et Microsoft Teams

Vérifiez que vous avez correctement configuré le canal de communication entre la rubrique SNS et Amazon Q Developer.

Vérifier que vous avez abonné Amazon Q Developer à votre rubrique Amazon SNS

Procédez comme suit :

1. Ouvrez la console Amazon Q Developer.
2. Dans le volet de navigation, sous Configured clients (Clients configurés), choisissez Slack, Amazon Chime ou Microsoft Teams.
3. Sélectionnez votre canal Slack dans la configuration de l'espace de travail Slack, le webhook de la liste de webhooks Amazon Chime ou votre canal Microsoft Teams.
4. Sélectionnez Edit (Modifier).
5. Dans le volet Details (Détails), sous Topics (Rubriques), recherchez votre rubrique SNS. Si la rubrique n'est pas répertoriée, abonnez votre rubrique SNS à Amazon Q Developer.

Vérifier que vous avez répertorié le point de terminaison Amazon Q Developer en tant qu'abonnement à la rubrique pour votre rubrique Amazon SNS

Procédez comme suit :

1. Ouvrez la console Amazon SNS.
2. Dans le volet de navigation, choisissez Topics (Rubriques), puis sélectionnez le nom de votre rubrique SNS.
3. Sous Subscriptions (Abonnements), recherchez le point de terminaison Amazon Q Developer suivant : https://global.sns-api.chatbot.amazonaws.com. Si le point de terminaison Amazon Q Developer ne figure pas dans la liste d'abonnements aux rubriques, vous devez abonner votre rubrique SNS à Amazon Q Developer.
   Remarque : Utilisez votre configuration Amazon Q Developer pour envoyer une notification de test.

S'assurer de ne pas publier manuellement des messages dans un format non pris en charge

Amazon Q Developer prend en charge les messages publiés manuellement dans une rubrique SNS. Toutefois, le format du message doit être compatible avec Amazon Q Developer. Tout service configuré pour envoyer des messages doit envoyer des notifications Amazon SNS à Amazon Q Developer uniquement via les services pris en charge par Amazon Q Developer.

Vérifier qu'Amazon Q Developer prend en charge les messages de service AWS publiés

Consultez les journaux CloudWatch de votre application de chat pour détecter l'erreur « Event Received is not supported ». Si une erreur « Event Received is not supported » s'affiche, cela signifie qu'Amazon Q Developer ne prend pas en charge le message de service AWS publié dans votre rubrique.

Pour obtenir une liste des services AWS pris en charge par Amazon Q Developer, consultez la section Surveillance des services AWS à l'aide d'Amazon Q Developer dans les applications de chat.

S'assurer que la rubrique Amazon SNS accorde les autorisations requises afin qu'un autre service AWS puisse publier des messages

Procédez comme suit :

1. Ouvrez la console Amazon SNS.
2. Dans le volet de navigation, sélectionnez Topics (Rubriques).
3. Sélectionnez la rubrique SNS à laquelle vous avez abonné Amazon Q Developer.
4. Choisissez l'onglet Access policy (Stratégie d'accès).
5. Consultez la section Statement (Instruction) de la stratégie d'accès. Assurez-vous que la stratégie autorise le service AWS approprié à exécuter l'action d'API SNS:Publish.
6. Si votre stratégie d'accès Amazon SNS n'autorise pas le service AWS approprié à publier des événements sur votre rubrique, mettez-la à jour. Dans la section Details (Détails) de votre page de rubrique, choisissez Edit (Modifier). Développez la section Access policy (Stratégie d'accès), puis ajoutez le contrôle d'accès approprié.
   Remarque : pour obtenir des exemples de stratégies d'accès à Amazon SNS, consultez la section Configurer les rubriques Amazon SNS pour les notifications.

Vérifier que la diffusion brute de messages n'est pas activée pour votre rubrique Amazon SNS

Amazon Q Developer n'accepte pas la diffusion brute des messages. Pour vérifier que la diffusion brute des messages n'est pas activée dans votre rubrique SNS, procédez comme suit :

1. Ouvrez la console Amazon SNS.
2. Dans le volet de navigation, choisissez Topics (Rubriques), puis sélectionnez le nom de votre rubrique SNS.
3. Dans le volet Details (Détails), pour Raw message delivery (Diffusion brute des messages), vérifiez si le statut est activé ou désactivé.
4. Si le statut est activé, procédez comme suit : Sélectionnez Edit (Modifier). Désélectionnez Enable raw message delivery (Activer la diffusion brute des messages) pour désactiver la diffusion brute des messages. Sélectionnez Save changes (Enregistrer les modifications).

Veiller à inclure les autorisations de stratégie de clé AWS KMS requises

Remarque : cette vérification ne s'applique qu'aux rubriques SNS pour lesquelles le chiffrement côté serveur est activé.

Votre stratégie de clé AWS Key Management Service (AWS KMS) doit autoriser le service qui envoie les messages à publier sur vos rubriques SNS chiffrées.

Votre stratégie de clé AWS KMS doit inclure la section suivante :

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

Important : Remplacez events.amazonaws.com par le principal du service AWS pour le service qui publie vos rubriques SNS chiffrées.

Vérifier que les services AWS ne publient pas de messages sur votre rubrique Amazon SNS à un rythme supérieur à 10 notifications par seconde

Amazon Q Developer autorise 10 événements par seconde. Amazon Q Developer limite les messages supplémentaires lorsqu'il reçoit plus de 10 événements par seconde.

Pour vérifier si vous avez des événements limités, consultez la métrique CloudWatch, EventsThrottled (Événements limités), dans votre outil CloudWatch Metrics pour Amazon Q Developer.

(Pour Amazon EventBridge) S'assurer qu'EventBridge prend en charge les notifications d'événements que les services AWS envoient à la destination de votre client Amazon Q Developer

Utilisez un transformeur d'entrée EventBridge pour générer des notifications personnalisées, puis transférez les notifications vers une rubrique SNS. Surveillez la rubrique SNS et envoyez des notifications aux canaux Microsoft Teams, Amazon Chime ou Slack configurées avec Amazon Q Developer. Les notifications personnalisées d'Amazon Q Developer doivent suivre le format du schéma d'événements.

Pour plus d'informations, consultez la section Services pris en charge pour Amazon Q Developer dans les applications de chat.

Informations connexes

Résolution des problèmes liés à Amazon Q Developer dans les applications de chat

Comment utiliser des webhooks pour publier des messages Amazon SNS sur Amazon Chime, Slack ou Microsoft Teams ?