Formats de charge utile des EventBridge événements Amazon Créez une règle adaptée aux EventBridge événements Amazon Configurer la cible de la EventBridge règle Amazon créée

Utilisez Amazon EventBridge Events 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é à l'enregistrement d'écran de chaque agent comprend l' success/failure état, les codes d'erreur avec description, l'emplacement de l'enregistrement, la taille de l'enregistrement, la version du client installée et les heures de début et de fin de l'enregistrement d'écran.

Note

Le suivi de l'état de l'enregistrement d'écran avec Amazon EventBridge est disponible dans toutes les AWS régions qui prennent en charge l'enregistrement d'écran par les agents Connect Customer, à l'exception de AWS GovCloud (US-West).

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 sur un tableau de bord Amazon Quick
Créez des rapports agrégés en dehors de Connect Customer
Connectez vos autres solutions de pipeline de données personnalisées à Amazon EventBridge

Table des matières

Formats de charge utile des EventBridge événements Amazon
Créez une règle adaptée aux EventBridge événements Amazon
Configurer la cible de la EventBridge règle Amazon créée

Formats de charge utile des EventBridge événements Amazon

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

Cet événement est émis lorsqu'un contact est accepté par l'agent, peut-être 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": "3.0.2.0",  
    }  
  }  
}

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

Cet événement est émis à la fin de l'enregistrement d'écran sur le poste de travail de l'agent. Cela ne signifie pas que l'enregistrement d'écran a été chargé avec succès 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": "3.0.2.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 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": "3.0.2.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/connect/your-instance-alias/object-prefix/object-key",  
      "durationInMillis": 100000,  
      "sizeInBytes": 1000000  
    }  
  }  
}

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

Cet événement est émis en cas d'échec de l'enregistrement d'écran. Les informations sur les défaillances incluent une estimation de la raison 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": "3.0.2.0",  
    },  
    "failureInfo": {  
      "code": "UNKNOWN",  
      "message": "Unknown failure",  
      "source": "UNKNOWN"  
    },  
    "recordingInfo": {  
      "startTime": "2026-01-01T00:00:00.000Z"  
    }  
  }  
}

Le tableau suivant répertorie les valeurs possibles de l'failureInfoobjet.

code	message	source
`CLIENT_LOCAL_NETWORK_ACCESS_BLOCKED`	La politique d'accès au réseau local du navigateur a bloqué la connexion à l'application cliente Amazon Connect.	`CLIENT`
`CLIENT_APP_NOT_RUNNING`	L'application cliente Amazon Connect ne s'exécute pas sur le bureau de l'agent	`CLIENT`
`CLIENT_UNSUPPORTED_OS`	Le système d'exploitation de l'agent n'est pas pris en charge pour l'enregistrement d'écran	`CLIENT`
`CLIENT_AUTH_ERROR`	L'application cliente Amazon Connect n'a pas pu s'authentifier	`CLIENT`
`CLIENT_CONNECTION_ERROR`	L'application cliente Amazon Connect n'est pas connectée	`CLIENT`
`MULTIPLE_CCP_INTERACTION`	Plusieurs interactions du navigateur avec CCP ont été détectées	`CLIENT`
`USER_ERROR`	La demande a rencontré une erreur de configuration utilisateur	`CLIENT`
`SERVICE_ISSUE`	La demande a rencontré une exception de service	`SERVICE`
`UNKNOWN`	Défaillance inconnue	`UNKNOWN`

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

Pour vous abonner à Amazon EventBridge Events et bénéficier du statut d'enregistrement d'écran, vous devez créer une EventBridge règle Amazon correspondant à la source et au type de détails de l'événement définis. Cela peut être réalisé via la AWS console ou AWS CDK les bibliothèques.

Créez une règle à l'aide du 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 qui affiche la sélection du bus d'événements par défaut.

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 de la source de l'événement indiquant aws.connect sélectionné.

Le modèle d'événement indiquant que l'état de l'enregistrement d'écran a été modifié 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 de Custom pattern (é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 la section EventBridge Objectifs Amazon dans le guide de EventBridge l'utilisateur Amazon.

Le groupe de CloudWatch journaux Amazon comme exemple de cible

L'exemple suivant utilise un groupe de CloudWatch journaux 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)));

Exemples 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 compte de chaque état 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'échec 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 dont les contacts ont échoué le plus


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

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Téléchargement des fichiers journaux pour l’application d’enregistrement d’écran

FAQ sur les fonctionnalités d’enregistrement d’écran