

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
<a name="performance-evaluation-events"></a>

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
<a name="performance-evaluation-events-guide"></a>

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.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/perf-eval-eventbridge-rules-tab.png)

1. Scegli **Crea regola** con il bus degli eventi predefinito selezionato.  
![\[Il pulsante Crea regola con l'Event bus predefinito selezionato.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/perf-eval-eventbridge-create-rule.png)

1. 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.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/perf-eval-eventbridge-rule-name.png)

1. 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.

1. 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.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/perf-eval-eventbridge-event-pattern.png)

1. 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.

1. 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.

1. 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 .\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/perf-eval-cloudwatch-log-group.png)  
![\[CloudWatch dettaglio del registro che mostra i metadati e il motivo dell'errore.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/perf-eval-cloudwatch-log-detail.png)

## Esempio EventBridge di payload
<a name="performance-evaluation-events-payload"></a>

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
<a name="performance-evaluation-events-errors"></a>

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
<a name="automated-evaluation-submission-errors"></a>


| Errore | Messaggio di errore | 
| --- | --- | 
| AUTOMATED\$1SUBMISSION\$1FAILED | 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\$1FILE\$1ERROR | L'invio automatico della valutazione dei contatti non è riuscito a causa di un errore searching/retrieving/parsing nel file di analisi. | 
| INTERNAL\$1SERVER\$1ERROR | 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\$1EXCEEDED\$1ERROR | 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
<a name="evaluation-s3-export-errors"></a>


| Errore | Messaggio di errore | 
| --- | --- | 
| S3\$1BUCKET\$1ACCESS\$1DENIED | L'esportazione JSON di valutazione dei contatti non è riuscita a causa di autorizzazioni insufficienti. | 
| S3\$1STORAGE\$1NOT\$1CONFIGURED | Il bucket S3 di esportazione non è configurato per la tua istanza. | 
| INTERNAL\$1SERVER\$1ERROR | 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. | 