View a markdown version of this page

Utilisez les EventBridge événements Amazon pour suivre l'état de l'enregistrement d'écran - Amazon Connect
Formats de charge utile des EventBridge événements AmazonCréez une règle correspondant aux EventBridge événements AmazonConfigurer la cible de la EventBridge règle Amazon créée

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.

Utilisez les EventBridge événements Amazon pour suivre l'état de l'enregistrement d'écran

Avec Amazon EventBridge, vous pouvez consulter l'état des enregistrements d'écran des agents en temps quasi réel. L'événement associé à chaque enregistrement d'écran d'agent inclut le success/failure statut, les codes d'erreur avec descriptions, l'emplacement de l'enregistrement, la taille de l'enregistrement, la version du client installé et les heures de début et de fin de l'enregistrement d'écran.

Vous pouvez intégrer d'autres AWS services pour obtenir des informations analytiques ou de surveillance sur les enregistrements d'écran des agents :

  • Requête avec Amazon CloudWatch Log Insights

  • Recevez des alertes en temps quasi réel dans un tableau de bord Amazon Quick

  • Créez des rapports agrégés en dehors d'Amazon Connect

  • Connectez vos autres solutions de pipeline de données personnalisées à Amazon EventBridge

Formats de charge utile des EventBridge événements Amazon

Événement avec statut d'enregistrement d'écran - INITIÉ

Cet événement est émis lorsqu'un contact est accepté par l'agent, c'est-à-dire avant le début de l'enregistrement, pour chaque contact pour lequel l'enregistrement d'écran de l'agent est activé.

{  
  "version": "0",  
  "id": "the_event_id_from_eventbridge",  
  "detail-type": "Screen Recording Status Changed",  
  "source": "aws.connect",  
  "account": "your_aws_account_id",  
  "time": "2026-01-01T00:00:00Z",  
  "region": "us-west-2",  
  "resources": [  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"  
  ],  
  "detail": {  
    "version": "1.0",  
    "recordingStatus": "INITIATED",  
    "eventDeduplicationId": "unique_uuid",  
    "instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",  
    "contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",  
    "agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",  
    "clientInfo": {  
      "appVersion": "2.0.3.0",  
    }  
  }  
}

Événement avec statut d'enregistrement d'écran - TERMINÉ

Cet événement est émis lorsque l'enregistrement d'écran se termine sur le poste de travail de l'agent. Cela ne signifie pas que l'enregistrement d'écran a été correctement chargé dans votre compartiment Amazon S3.

{  
  "version": "0",  
  "id": "the_event_id_from_eventbridge",  
  "detail-type": "Screen Recording Status Changed",  
  "source": "aws.connect",  
  "account": "your_aws_account_id",  
  "time": "2026-01-01T00:00:00Z",  
  "region": "us-west-2",  
  "resources": [  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"  
  ],  
  "detail": {  
    "version": "1.0",  
    "recordingStatus": "COMPLETED",  
    "eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",  
    "instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",  
    "contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",  
    "agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",  
    "clientInfo": {  
      "appVersion": "2.0.3.0",  
    },  
    "recordingInfo": {  
      "startTime": "2026-01-01T00:00:00.000Z",  
      "endTime": "2026-01-01T00:00:00.000Z",  
    }  
  }  
}

Événement avec statut d'enregistrement d'écran - PUBLIÉ

Cet événement est émis lorsque l'enregistrement d'écran est correctement chargé dans votre compartiment Amazon S3. Les détails incluent l'emplacement du compartiment Amazon S3, la taille de l'enregistrement et la durée de l'enregistrement.

{  
  "version": "0",  
  "id": "the_event_id_from_eventbridge",  
  "detail-type": "Screen Recording Status Changed",  
  "source": "aws.connect",  
  "account": "your_aws_account_id",  
  "time": "2026-01-01T00:00:00Z",  
  "region": "us-west-2",  
  "resources": [  
    "contactArn",  
    "instanceArn"  
  ],  
  "detail": {  
    "version": "1.0",  
    "recordingStatus": "PUBLISHED",  
    "eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",  
    "instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",  
    "contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",  
    "agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",  
    "clientInfo": {  
      "appVersion": "2.0.3.0",  
    },  
    "recordingInfo": {  
      "startTime": "2026-01-01T00:00:00.000Z",  
      "endTime": "2026-01-01T00:00:00.000Z",  
      "publishTime": "2026-01-01T00:00:00.000Z",  
      "location": "s3://your-bucket-name/object-prefix/object-key",  
      "durationInMillis": 100000,  
      "sizeInBytes": 1000000  
    }  
  }  
}

Événement avec statut d'enregistrement d'écran - ÉCHEC

Cet événement est émis en cas d'échec de l'enregistrement d'écran. Les informations détaillées sur les défaillances sont fournies à titre d'estimation optimale de la cause possible de la défaillance que nous sommes en mesure de détecter.

{  
  "version": "0",  
  "id": "the_event_id_from_eventbridge",  
  "detail-type": "Screen Recording Status Changed",  
  "source": "aws.connect",  
  "account": "your_aws_account_id",  
  "time": "2026-01-01T00:00:00Z",  
  "region": "us-west-2",  
  "resources": [  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/cccccccc-cccc-cccc-cccc-ccccccccccccc",  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"  
  ],  
  "detail": {  
    "version": "1.0",  
    "recordingStatus": "FAILED",  
    "eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",  
    "instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",  
    "contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/cccccccc-cccc-cccc-cccc-ccccccccccccc",  
    "agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",  
    "clientInfo": {  
      "appVersion": "2.0.3.0",  
    },  
    "failureInfo": {  
      "code": "UNKNOWN",  
      "message": "UNKNOWN",  
      "source": "Unknown failure"  
    },  
    "recordingInfo": {  
      "startTime": "2026-01-01T00:00:00.000Z"  
    }  
  }  
}

Créez une règle correspondant aux EventBridge événements Amazon

Pour vous abonner aux EventBridge événements Amazon afin de connaître le statut de l'enregistrement d'écran, vous devez créer une EventBridge règle Amazon correspondant à la source d'événement et au type de détail de l'événement définis. Cela peut être réalisé par le biais de la AWS console ou AWS CDK des bibliothèques.

Création d'une règle à l'aide de la AWS console

Dans la AWS console, créez une nouvelle règle dans Amazon EventBridge → Bus → Règles.

Utiliser le bus d'événements par défaut

La page Créer une règle affiche la sélection par défaut du bus d'événements.

Utiliser un modèle de modèle d'événement

Sélectionnez le modèle d'événement défini dans les listes déroulantes.

La liste déroulante Source de l'événement indiquant aws.connect sélectionnée.
Le modèle d'événement indiquant que l'état de l'enregistrement d'écran a changé est sélectionné.

Si le type d'événement n'apparaît pas dans la liste déroulante, vous pouvez également créer le même modèle à l'aide du modèle personnalisé (éditeur JSON) avec :

{  
  "source": [ "aws.connect" ],  
  "detailType": [ "Screen Recording Status Changed" ]  
}

Créez une règle à l'aide de AWS CDK

Sinon, si vous gérez AWS des ressources avec AWS CDK, voici un exemple d'extrait de TypeScript code pour créer une règle Amazon EventBridge  :

import { Rule } from 'aws-cdk-lib/aws-events';  
  
const eventBridgeRule = new Rule(this, 'YourEventBridgeRuleLogicalName', {  
    ruleName: 'your-event-bridge-rule-name',  
    description: 'your rule description',  
    eventPattern: {  
        source: [ "aws.connect" ],  
        detailType: [ "Screen Recording Status Changed" ]  
    }  
});

Configurer la cible de la EventBridge règle Amazon créée

Amazon EventBridge prend en charge un certain nombre de AWS services en tant que cibles. En fonction de vos besoins, il est possible de créer votre propre pipeline de traitement des événements avec d'autres AWS services. Vous pouvez définir jusqu’à cinq cibles pour chaque règle. Pour plus d'informations, consultez les EventBridge cibles Amazon dans le guide de EventBridge l'utilisateur Amazon.

Groupe de CloudWatch logs Amazon comme exemple de cible

L'exemple suivant utilise un groupe de CloudWatch logs Amazon comme cible.

La configuration cible indiquant le groupe de CloudWatch journaux sélectionné.

Dans AWS CDK le code, créez la ressource et ajoutez-la à la EventBridge règle Amazon :

import { LogGroup, RetentionDays } from "aws-cdk-lib/aws-logs";  
import { CloudWatchLogGroup } from 'aws-cdk-lib/aws-events-targets';  
   
const logGroup = new LogGroup(this, 'YourLogGroupLogicalName', {  
    logGroupName: '"/aws/events/your-log-group-name',  
    retention: RetentionDays.ONE_YEAR  
});  
  
eventBridgeRule.addTarget(new CloudWatchLogGroup((logGroup)));

Exemple de requêtes Amazon CloudWatch Log Insights

À l'aide du langage de requête Amazon CloudWatch Insights, voici quelques exemples de requêtes :

  • Exemple de requête sur le taux de réussite

    fields @timestamp, @message, detail  
| stats sum(detail.recordingStatus= "PUBLISHED") as Count_Success,   
  sum(detail.recordingStatus= "INITIATED") as Count_Total,   
  Count_Success / Count_Total as Success_Ratio

  • Exemple de requête pour obtenir le décompte de chaque statut d'enregistrement

    fields @timestamp, @message, detail  
| stats count(*) as Count group by detail.recordingStatus as recordingStatus

  • Exemple de requête sur les contacts défaillants avec les codes d'erreur les plus courants

    fields @timestamp, @message, detail  
| filter detail.recordingStatus = "FAILED"   
| stats count(*) as Count group by detail.failureInfo.code as FailureCode  
| sort by Count desc

  • Exemple de requête sur les agents ayant le plus de contacts ratés

    fields @timestamp, @message, detail  
| filter detail.recordingStatus = "FAILED"   
| stats count(*) as Count group by detail.agentArn as AgentArn  
| sort by Count desc