Überwachen Sie Fehlerereignisse bei der Leistungsbewertung - Amazon Connect-Kunde

View a markdown version of this page

Überwachen Sie Fehlerereignisse bei der Leistungsbewertung - Amazon Connect-Kunde
Step-by-step AnleitungBeispiel für eine EventBridge NutzlastHäufige Fehler

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Überwachen Sie Fehlerereignisse bei der Leistungsbewertung

Mithilfe EventBridge von und können Sie Fehler bei automatisierten Auswertungen sowie bei S3-Exporten von Kontaktauswertungen überwachen CloudWatch. Sie können diese Ereignisse verwenden, um Fehler zu untersuchen und zu beheben. Die folgende Anleitung ist eine schrittweise Anleitung zum Erstellen benutzerdefinierter EventBridge Regeln zur Überwachung von Fehlern bei der Leistungsbewertung.

Step-by-step Anleitung

Dies ist eine Anleitung zum Erstellen einer EventBridge Regel zum Protokollieren von Ereignissen, bei denen Connect Customer die automatische Bewertung nicht erfolgreich eingereicht hat, und zum Protokollieren von S3-Exporten von Kontaktbewertungen in Ihrer AWS Konsole.

  1. Loggen Sie sich in Ihr AWS Konto ein und navigieren Sie zur EventBridge Konsole. Wählen Sie im Abschnitt Busse die Option Regeln aus.

    Die Registerkarte Regeln im Abschnitt Busse in der EventBridge Konsole.

  2. Wählen Sie Regel erstellen, wobei der Standard-Event-Bus ausgewählt ist.

    Klicken Sie auf die Schaltfläche „Regel erstellen“, wobei der Standard-Event-Bus ausgewählt ist.

  3. Geben Sie der Regel einen Namen und wählen Sie Regel mit einem Ereignismuster als Regeltyp aus. Wählen Sie Weiter aus.

    Der Regelname und die Option Regel mit einem Ereignismuster sind ausgewählt.

  4. Wenn unter Ereignisse AWS-Ereignisse oder EventBridge Partnerereignisse ausgewählt sind, wählen Sie unter Ereignismuster die Option Musterformular verwenden aus. Hier definieren Sie das Muster, nach dem die Regel ausgelöst werden soll.

  5. Geben Sie Amazon Connect ein und wählen Sie es in der AWS-Service-Dropdownliste aus, um die Ereignistypen einzugrenzen. Wählen Sie im Drop-down-Menü unten den gewünschten Ereignistyp aus. Wählen Sie Weiter, nachdem das Muster eingerichtet ist.

    Um EventBridge Ereignistypen zu abonnieren, erstellen Sie eine benutzerdefinierte EventBridge Regel, die den folgenden Kriterien entspricht:

    • "source" = "aws.connect"

    • "detail-type" kann einer der folgenden sein:

      • "Contact Lens Automated Evaluation Submission Failed"

      • "Contact Lens Evaluation Export Failed"

    Das Ereignismuster, bei dem Amazon Connect als AWS-Service ausgewählt wurde.

  6. Im nächsten Schritt können Sie die Ziele so konfigurieren, dass sie process/receive den entsprechenden Ereignissen entsprechen. Wählen Sie der Einfachheit halber unter Ziel auswählen die Option CloudWatch Protokollgruppe aus und wählen Sie eine Protokollgruppe aus.

  7. Wählen Sie Weiter und fahren Sie mit dem letzten Schritt „Überprüfen und Erstellen“ fort. Wählen Sie erneut Regel erstellen aus, um die Regelerstellung abzuschließen.

  8. Wenn sich die Regel nun im Status Aktiviert befindet und ein passendes Ereignis eintritt, sollten die entsprechenden Protokolle in der konfigurierten CloudWatch Protokollgruppe mit den entsprechenden IDs im Metadatenbereich und dem Fehlergrund im Datenbereich angezeigt werden.

    CloudWatch Protokollgruppe, in der übereinstimmende EventBridge Ereignisse angezeigt werden.
    CloudWatch Protokolldetail mit Metadaten und Fehlerursache.

Beispiel für eine EventBridge Nutzlast

Im Folgenden finden Sie ein Beispiel für eine EventBridge Nutzlast, wenn die Regel erfüllt wird:

{  
  "version": "0",  
  "id": "00005435-d12d-c93b-d9d2-b64cba85fbb6",
  "detail-type": "Contact Lens Automated Evaluation Submission Failed",  
  "source": "aws.connect",  
  "account": "Your AWS account ID",  
  "time": "2025-10-02T10:34:56Z",  
  "region": "us-west-2",
  "resources": [],  
  "detail": {  
    "version": "1.0.0",  
    "metadata": {  
      "contactId": "4266f8e9-8420-4ee7-96cd-515d2edae1f2",
      "instanceId": "d9b0b09d-7dab-47e5-9f82-d6787fbc068c",
      "formId": "8b1365bd-1415-41a9-a491-af226e1bda4e"
    },  
    "data": {  
      "reasonCode": "ANALYSIS_FILE_ERROR",
      "message": "Automated contact evaluation submission failed due to an error when searching/retrieving/parsing the analysis file."
    }  
  }  
}

Häufige Fehler

Die folgenden Fehler können auftreten, wenn das System nach mehreren Wiederholungsversuchen letztendlich die Auswertungen nicht verarbeiten kann.

Fehler bei der automatisierten Einreichung der Bewertung

Fehler Fehlermeldung
AUTOMATED_SUBMISSION_FAILED Die automatische Übermittlung der Kontaktbewertung ist fehlgeschlagen, da einige der Fragen nicht beantwortet werden konnten. Bitte überprüfen Sie das Bewertungsformular oder die Connect-Customer-Regelkonfigurationen.
ANALYSIS_FILE_ERROR Die automatische Übermittlung der Kontaktbewertung ist aufgrund eines Fehlers beim searching/retrieving /parsen der Analysedatei fehlgeschlagen.
INTERNAL_SERVER_ERROR Die automatische Übermittlung der Kontaktbewertung ist aufgrund eines internen Serverfehlers fehlgeschlagen. Bitte rechnen Sie mit einer verzögerten Bearbeitung.
QUOTA_EXCEEDED_ERROR Die automatische Übermittlung der Kontaktbewertung ist fehlgeschlagen, da das verbleibende Kontingent für den Einsatz generativer KI zur automatischen Beantwortung von Bewertungsfragen für den Kontakt nicht ausreicht.

Fehler beim Export von S3 bei der Evaluierung

Fehler Fehlermeldung
S3_BUCKET_ACCESS_DENIED Der JSON-Export der Kontaktbewertung ist aufgrund unzureichender Berechtigungen fehlgeschlagen.
S3_STORAGE_NOT_CONFIGURED Der Export-S3-Bucket ist nicht für Ihre Instance konfiguriert.
INTERNAL_SERVER_ERROR Der JSON-Export der Kontaktbewertung ist aufgrund eines internen Serverfehlers fehlgeschlagen. Bitte rechnen Sie mit einer verzögerten Lieferung der Exportdatei.