Warum erhält mein Amazon Q Developer keine Nachrichten von Amazon SNS?

Kurzbeschreibung

Die Benachrichtigungen des Amazon SNS-Themas haben Amazon Q Developer aus einem der folgenden Gründe nicht erreicht:

• Der Kommunikationskanal zwischen Amazon Q Developer und dem Slack-Kanal ist falsch konfiguriert.
• Der Kommunikationskanal zwischen dem SNS-Thema und Amazon Q Developer ist falsch konfiguriert.

Lösung

CloudWatch Logs für Amazon Q Developer aktivieren

Falls du dies noch nicht getan hast, aktiviere Amazon CloudWatch Logs für Amazon Q Developer in Chat-Anwendungen, um Fehlermeldungen zu überprüfen.

Sicherstellen, dass du den Kommunikationskanal zwischen Amazon Q Developer und dem Slack-Kanal korrekt konfiguriert hast

Sicherstellen, dass der Slack-Kanal nicht archiviert oder gelöscht wird

Wenn du einen Slack-Kanal gelöscht oder archiviert hast, kann der Kanal keine Nachrichten empfangen und Slack deaktiviert alle Apps.

Um die Archivierung eines Kanals aufzuheben, siehe Kanal archivieren oder löschen auf der Slack-Website.

Hinweis: Du kannst einen gelöschten Slack-Kanal nicht wiederherstellen. Wenn der abonnierte Slack-Kanal gelöscht wird, erstelle einen neuen Slack-Kanal und konfiguriere ihn so, dass er Benachrichtigungen von deinem Thema empfängt.

Sich vergewissern, dass du die Chat-Anwendung in deinem Slack-Workspace installiert hast

Überprüfe die CloudWatch Logs deiner Chat-Anwendungen auf den Fehler „account_inactive“. Wenn du den Fehler „account_inactive“ findest, wurde deine Chat-Anwendung nicht in deinem Slack-Workspace installiert.

Um die Chat-Anwendung in deinem Slack-Workspace zu installieren, folge den Anweisungen in Tutorial: Get started with Slack (Tutorial: Erste Schritte mit Slack).

(Nur für private Slack-Kanäle) Sich vergewissern, dass du die Chat-Anwendung zum Slack-Kanal hinzugefügt hast

Überprüfe die CloudWatch Logs deiner Chat-Anwendungen auf den Fehler „channel_not_found“. Wenn du deine Chat-Anwendung nicht zum privaten Kanal hinzugefügt hast, tritt dieser Fehler auf.

Um Amazon Q Developer zu einem privaten Slack-Kanal hinzuzufügen, führe den Befehl /invite @Amazon Q im privaten Kanal aus.

Für Slack, Amazon Chime und Microsoft Teams

Stelle sicher, dass du den Kommunikationskanal zwischen dem SNS-Thema und Amazon Q Developer richtig konfiguriert hast.

Sicherstellen, dass du Amazon Q Developer für das Amazon SNS-Thema abonniert hast

Führe die folgenden Schritte aus:

1. Öffne die Amazon Q Developer-Konsole.
2. Wähle im Navigationsbereich unter Configured clients (Konfigurierte Clients) Slack, Amazon Chime oder Microsoft Teams aus.
3. Wähle den Slack-Kanal in der Slack-Workspace-Konfiguration, Webhook in der Amazon Chime-Webhooks-Liste oder den Microsoft Teams-Kanal aus.
4. Wähle Edit (Bearbeiten) aus.
5. Suche im Bereich Details unter Topics (Themen) nach dem SNS-Thema. Wenn das Thema nicht aufgeführt ist, abonniere dein SNS-Thema für Amazon Q Developer.

Sicherstellen, dass du den Amazon Q Developer-Endpunkt als Themenabonnement für das Amazon SNS-Thema aufgeführt hast

Führe die folgenden Schritte aus:

1. Öffne die Amazon SNS-Konsole.
2. Wähle im Navigationsbereich Topics (Themen) und dann den Namen des SNS-Themas aus.
3. Suche unter Subscriptions (Abonnements) nach dem folgenden Amazon Q Developer-Endpunkt: https://global.sns-api.chatbot.amazonaws.com. Wenn der Amazon Q Developer-Endpunkt nicht als Themenabonnement aufgeführt ist, musst du das SNS-Thema zu Amazon Q Developer abonnieren.
   Hinweis: Verwende deine Amazon Q Developer-Konfiguration, um eine Testbenachrichtigung zu senden.

Stelle sicher, dass du Nachrichten nicht manuell in einem nicht unterstützten Format veröffentlichst

Amazon Q Developer unterstützt manuell veröffentlichte Nachrichten an ein SNS-Thema. Das Format der Nachricht muss jedoch mit Amazon Q Developer kompatibel sein. Jeder AWS-Service, der zum Senden von Nachrichten konfiguriert ist, darf Amazon SNS-Benachrichtigungen nur über die von Amazon Q Developer unterstützten Services an Amazon Q Developer senden.

Stelle sicher, dass Amazon Q Developer die veröffentlichten AWS-Service-Nachrichten unterstützt

Überprüfe die CloudWatch Logs deiner Chat-Anwendungen auf den Fehler „Event Received is not supported“. Wenn du einen Fehler „Event Received is not supported“ siehst, unterstützt Amazon Q Developer die für dein Thema veröffentlichte Servicenachricht nicht.

Eine Liste der Services, die Amazon Q Developer unterstützt, findest du unter Monitoring AWS services using Amazon Q Developer in chat applications (Überwachung von AWS-Services mit Amazon Q Developer in Chat-Anwendungen).

Sicherstellen, dass das Amazon SNS-Thema die erforderlichen Berechtigungen für einen anderen AWS-Service zum Veröffentlichen von Nachrichten gewährt

Führe die folgenden Schritte aus:

1. Öffne die Amazon SNS-Konsole.
2. Wähle im Navigationsbereich Topics (Themen) aus.
3. Wähle das SNS-Thema aus, für das du Amazon Q Developer abonniert hast.
4. Wähle die Registerkarte Access policy (Zugriffsrichtlinie) aus.
5. Lies den Abschnitt Statement (Anweisung) der Zugriffsrichtlinie. Stelle sicher, dass die Richtlinie dem richtigen Service erlaubt, die API-Aktion SNS:Publish auszuführen.
6. Wenn deine Amazon SNS-Zugriffsrichtlinie dem richtigen Service nicht erlaubt, Ereignisse in deinem Thema zu veröffentlichen, aktualisiere die Richtlinie. Wähle im Abschnitt Details der Themenseite die Option Edit (Bearbeiten). Erweitere den Abschnitt Access policy (Zugriffsrichtlinie) und füge dann die richtige Zugriffskontrolle hinzu.
   Hinweis: Beispiele für Amazon SNS-Zugriffsrichtlinien findest du unter Konfigurieren von Amazon-SNS-Themen für Benachrichtigungen.

Sicherstellen, dass für das Amazon SNS-Thema die Zustellung von Nachrichten im Rohformat nicht aktiviert ist

Amazon Q Developer akzeptiert keine Zustellung von Nachrichten im Rohformat. Gehe wie folgt vor, um zu überprüfen, ob für das SNS-Thema die Zustellung von Nachrichten im Rohformat nicht aktiviert ist:

1. Öffne die Amazon SNS-Konsole.
2. Wähle im Navigationsbereich Topics (Themen) und dann den Namen des SNS-Themas aus.
3. Prüfe im Bereich Details für Raw message delivery (Übermittlung unformatierter Nachrichten), ob der Status enabled (aktiviert) oder disabled (deaktiviert) ist.
4. Wenn der Status enabled (aktiviert) ist, ergreife die folgenden Maßnahmen: Wähle Edit (Bearbeiten) aus. Lösche die Option Enable raw message delivery (Übermittlung unformatierter Nachrichten aktivieren), um die Zustellung von Rohnachrichten zu deaktivieren. Wähle Save changes (Änderungen speichern).

Sicherstellen, dass du die erforderlichen AWS-KMS-Schlüssel-Richtlinienberechtigungen angibst

Hinweis: Diese Überprüfung gilt nur für SNS-Themen, bei denen die serverseitige Verschlüsselung aktiviert ist.

Die Schlüsselrichtlinie für den AWS Key Management Service (AWS KMS) muss dem Service, der Nachrichten sendet, die Veröffentlichung in den verschlüsselten SNS-Themen ermöglichen.

Die AWS-KMS-Schlüsselrichtlinie muss den folgenden Abschnitt enthalten:

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

Wichtig: Ersetze events.amazonaws.com durch den AWS Service Principal für den Service, der deine verschlüsselten SNS-Themen veröffentlicht.

Sicherstellen, dass AWS-Services keine Nachrichten zum Amazon SNS-Thema mit einer Rate von mehr als 10 Benachrichtigungen pro Sekunde veröffentlichen

Amazon Q Developer erlaubt 10 Ereignisse pro Sekunde. Amazon Q Developer drosselt zusätzliche Nachrichten, wenn mehr als 10 Ereignisse pro Sekunde empfangen werden.

Um zu überprüfen, ob gedrosselte Ereignisse vorliegen, überprüfe die CloudWatch-Metrik EventsThrottled in deinen CloudWatch-Metriken für Amazon Q Developer.

(Für Amazon EventBridge) Sicherstellen, dass EventBridge die Ereignisbenachrichtigungen unterstützt, die AWS-Services an das Amazon Q Developer-Client-Ziel senden

Verwende einen EventBridge-Eingabe-Transformator, um benutzerdefinierte Benachrichtigungen zu generieren und leite die Benachrichtigungen dann an ein SNS-Thema weiter. Überwache das SNS-Thema und sende Benachrichtigungen an die konfigurierten Microsoft Teams-, Amazon Chime- oder Slack-Kanäle mit Amazon Q Developer. Die benutzerdefinierten Amazon Q Developer-Benachrichtigungen müssen dem Format Ereignisschema folgen.

Weitere Informationen findest du unter Supported services for Amazon Q Developer in chat applications (Unterstützte Services für Amazon Q Developer in Chat-Anwendungen).

Weitere Informationen

Troubleshooting Amazon Q Developer in chat applications (Fehlerbehebung für Amazon Q Developer in Chat-Anwendungen)

Wie verwende ich Webhooks, um Amazon-SNS-Nachrichten in Amazon Chime, Slack oder Microsoft Teams zu veröffentlichen?