

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Surveillez les défaillances liées à l'évaluation des performances
<a name="performance-evaluation-events"></a>

Vous pouvez surveiller les échecs des évaluations automatisées ainsi que les exportations S3 des évaluations de contacts à l'aide de EventBridge et CloudWatch. Vous pouvez utiliser ces événements pour étudier et corriger les défaillances. Le guide suivant décrit le processus de création de EventBridge règles personnalisées pour surveiller les défaillances liées à l'évaluation des performances.

## Step-by-step guide
<a name="performance-evaluation-events-guide"></a>

Ce guide explique comment créer une EventBridge règle pour enregistrer les échecs de soumission d'évaluations automatiques à Amazon Connect et les échecs d'exportation S3 des évaluations de contacts dans votre AWS console.

1. Connectez-vous à votre AWS compte et accédez à la EventBridge console. Choisissez **Règles** dans la section **Bus**.  
![\[L'onglet Règles sous la section Bus de la EventBridge console.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/perf-eval-eventbridge-rules-tab.png)

1. Choisissez **Créer une règle** avec le bus d'événements sélectionné par défaut.  
![\[Le bouton Créer une règle avec le bus d'événements sélectionné par défaut.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/perf-eval-eventbridge-create-rule.png)

1. Donnez un nom à la règle et sélectionnez **Règle avec un modèle d'événement** pour le type de règle. Choisissez **Suivant**.  
![\[Nom de la règle et option Règle avec modèle d'événement sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/perf-eval-eventbridge-rule-name.png)

1. Lorsque les **événements AWS ou les événements EventBridge partenaires** sont sélectionnés sous **Événements**, sélectionnez l'option **Utiliser le formulaire de modèle** sous **Modèle d'événement**. C'est ici que vous allez définir le modèle à utiliser pour déclencher la règle.

1. Tapez et sélectionnez **Amazon Connect** dans la liste déroulante des **services AWS** pour affiner les types d'événements. Sélectionnez le type d'événement souhaité dans le menu déroulant ci-dessous. Choisissez **Next** une fois le schéma configuré.

   Pour vous abonner à des types d' EventBridge événements, créez une EventBridge règle personnalisée correspondant aux critères suivants :
   + `"source"` = `"aws.connect"`
   + `"detail-type"`, les valeurs suivantes sont possibles :
     + `"Contact Lens Automated Evaluation Submission Failed"`
     + `"Contact Lens Evaluation Export Failed"`  
![\[Le modèle d'événement avec Amazon Connect sélectionné comme service AWS.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/perf-eval-eventbridge-event-pattern.png)

1. L'étape suivante vous permet de configurer la ou les cibles pour process/receive les événements correspondants. Pour plus de simplicité, sélectionnez l'option de **groupe de CloudWatch journaux** sous **Sélectionnez une cible** et choisissez un groupe de journaux.

1. Choisissez **Suivant** et passez à l'étape finale de **révision et de création**. Choisissez **Créer une règle** une fois de plus pour terminer le processus de création de règles.

1. Désormais, si la règle est à l'état **Activé** et qu'un événement correspondant se produit, les journaux correspondants doivent apparaître dans le groupe de CloudWatch journaux configuré avec le nom correspondant dans la IDs section des métadonnées et le motif de l'échec dans la section des données.  
![\[CloudWatch groupe de journaux affichant les EventBridge événements correspondants.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/perf-eval-cloudwatch-log-group.png)  
![\[CloudWatch détail du journal indiquant les métadonnées et la raison de l'échec.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/perf-eval-cloudwatch-log-detail.png)

## Exemple de EventBridge charge utile
<a name="performance-evaluation-events-payload"></a>

Voici un exemple de EventBridge charge utile lorsque la règle correspond :

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

## Erreurs courantes
<a name="performance-evaluation-events-errors"></a>

Les erreurs suivantes peuvent se produire lorsque le système ne parvient finalement pas à traiter les évaluations après plusieurs tentatives.

### Erreurs de soumission automatique des évaluations
<a name="automated-evaluation-submission-errors"></a>


| Erreur | Message d’erreur | 
| --- | --- | 
| AUTOMATED\$1SUBMISSION\$1FAILED | La soumission automatique de l'évaluation des contacts a échoué car certaines questions n'ont pas pu être répondues. Vérifiez l'évaluation à partir and/or des configurations de règles Amazon Connect. | 
| ANALYSIS\$1FILE\$1ERROR | La soumission automatique de l'évaluation des contacts a échoué en raison d'une erreur searching/retrieving/parsing dans le fichier d'analyse. | 
| INTERNAL\$1SERVER\$1ERROR | La soumission automatique de l'évaluation des contacts a échoué en raison d'une erreur interne du serveur. Veuillez vous attendre à un délai de traitement. | 
| QUOTA\$1EXCEEDED\$1ERROR | La soumission automatique de l'évaluation des contacts a échoué car le quota restant pour utiliser Gen AI pour répondre automatiquement aux questions d'évaluation du contact est insuffisant. | 

### Evaluation : erreurs d'exportation S3
<a name="evaluation-s3-export-errors"></a>


| Erreur | Message d’erreur | 
| --- | --- | 
| S3\$1BUCKET\$1ACCESS\$1DENIED | L'exportation JSON d'évaluation des contacts a échoué en raison d'autorisations insuffisantes. | 
| S3\$1STORAGE\$1NOT\$1CONFIGURED | Le compartiment S3 d'exportation n'est pas configuré pour votre instance. | 
| INTERNAL\$1SERVER\$1ERROR | L'exportation JSON d'évaluation des contacts a échoué en raison d'une erreur interne du serveur. Veuillez vous attendre à un retard de livraison du fichier d'exportation. | 