View a markdown version of this page

Monitora gli eventi di errore nella valutazione delle prestazioni - Amazon Connect
Step-by-step guidaEsempio EventBridge di payloadErrori comuni

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Monitora gli eventi di errore nella valutazione delle prestazioni

Puoi monitorare gli errori delle valutazioni automatiche e le esportazioni S3 delle valutazioni dei contatti utilizzando e. EventBridge CloudWatch È possibile utilizzare questi eventi per analizzare e correggere gli errori. La seguente guida illustra il processo di creazione di EventBridge regole personalizzate per monitorare gli eventi di errore nella valutazione delle prestazioni.

Step-by-step guida

Questa è una guida su come creare una EventBridge regola per registrare gli eventi di invio della valutazione automatica non riusciti di Amazon Connect e le esportazioni S3 non riuscite delle valutazioni dei contatti nella tua console. AWS

  1. Accedi al tuo AWS account e accedi alla console. EventBridge Scegli Regole nella sezione Autobus.

    La scheda Regole nella sezione Autobus della EventBridge console.

  2. Scegli Crea regola con il bus degli eventi predefinito selezionato.

    Il pulsante Crea regola con l'Event bus predefinito selezionato.

  3. Assegna un nome alla regola e seleziona Regola con uno schema di eventi per il tipo di regola. Scegli Next (Successivo).

    Il nome della regola e l'opzione Regola con un modello di evento selezionata.

  4. Con gli eventi AWS o gli eventi dei EventBridge partner selezionati in Eventi, seleziona l'opzione del modulo Use pattern in Event pattern. Qui è dove definirai lo schema da seguire per attivare la regola.

  5. Digita e seleziona Amazon Connect nel menu a discesa dei servizi AWS per restringere i tipi di eventi. Seleziona il tipo di evento desiderato nel menu a discesa in basso. Scegli Avanti una volta impostato il pattern.

    Per iscriverti ai tipi di EventBridge eventi, crea una EventBridge regola personalizzata che corrisponda alla seguente:

    • "source" = "aws.connect"

    • "detail-type"Il valore di può essere uno dei seguenti:

      • "Contact Lens Automated Evaluation Submission Failed"

      • "Contact Lens Evaluation Export Failed"

    Il modello di eventi con Amazon Connect selezionato come servizio AWS.

  6. Il passaggio successivo consente di configurare le destinazioni in base process/receive agli eventi corrispondenti. Per semplicità, seleziona l'opzione del gruppo di CloudWatch log in Seleziona una destinazione e scegli un gruppo di log.

  7. Scegli Avanti e passa alla fase finale di revisione e creazione. Scegli Crea regola ancora una volta per completare il processo di creazione della regola.

  8. Ora, se la regola è nello stato Abilitato e si verifica un evento corrispondente, i log corrispondenti dovrebbero apparire nel gruppo di CloudWatch log configurato con i relativi IDs dati nella sezione dei metadati e il motivo dell'errore nella sezione dati.

    CloudWatch gruppo di log che mostra gli eventi corrispondenti EventBridge .
    CloudWatch dettaglio del registro che mostra i metadati e il motivo dell'errore.

Esempio EventBridge di payload

Di seguito è riportato un esempio di EventBridge payload quando la regola viene soddisfatta:

{  
  "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."
    }  
  }  
}

Errori comuni

I seguenti errori possono verificarsi quando il sistema alla fine non riesce a elaborare le valutazioni dopo più tentativi.

Errori automatici di invio delle valutazioni

Errore Messaggio di errore
AUTOMATED_SUBMISSION_FAILED L'invio automatico della valutazione dei contatti non è riuscito perché non è stato possibile rispondere ad alcune domande. Verifica il modulo di valutazione delle configurazioni and/or delle regole di Amazon Connect.
ANALYSIS_FILE_ERROR L'invio automatico della valutazione dei contatti non è riuscito a causa di un errore searching/retrieving/parsing nel file di analisi.
INTERNAL_SERVER_ERROR L'invio automatico della valutazione dei contatti non è riuscito a causa di un errore interno del server. Vi preghiamo di aspettarvi un ritardo nell'elaborazione.
QUOTA_EXCEEDED_ERROR L'invio automatico della valutazione dei contatti non è riuscito perché la quota residua per l'utilizzo di Gen AI per rispondere automaticamente alle domande di valutazione per il contatto è insufficiente.

Errori di esportazione S3 di valutazione

Errore Messaggio di errore
S3_BUCKET_ACCESS_DENIED L'esportazione JSON di valutazione dei contatti non è riuscita a causa di autorizzazioni insufficienti.
S3_STORAGE_NOT_CONFIGURED Il bucket S3 di esportazione non è configurato per la tua istanza.
INTERNAL_SERVER_ERROR L'esportazione JSON per la valutazione dei contatti non è riuscita a causa di un errore interno del server. Si prevede un ritardo nella consegna del file di esportazione.