Formatos de carga útil de EventBridge eventos de Amazon Crea una regla que coincida con los EventBridge eventos de Amazon Configura el objetivo de la regla de Amazon creada EventBridge

Usa EventBridge los eventos de Amazon para rastrear el estado de la grabación de pantalla

Con Amazon EventBridge, puedes ver el estado de las grabaciones de pantalla de los agentes prácticamente en tiempo real. El evento de la grabación de pantalla de cada agente incluye el success/failure estado, los códigos de error con descripciones, la ubicación de la grabación, el tamaño de la grabación, la versión del cliente instalada y las horas de inicio y finalización de la grabación de pantalla.

nota

El seguimiento del estado de las grabaciones de pantalla con Amazon EventBridge está disponible en todas las AWS regiones que admiten la grabación de pantalla de los agentes de Connect Customer, excepto AWS GovCloud (US-West).

Puedes integrarte con otros AWS servicios para obtener información analítica o de seguimiento sobre las grabaciones de pantalla de los agentes:

Realice consultas con Amazon CloudWatch Log Insights
Reciba alertas prácticamente en tiempo real en un panel de control de Amazon Quick
Crea informes agregados fuera de Connect Customer
Conecta tus otras soluciones personalizadas de canalización de datos con Amazon EventBridge

Contenido

Formatos de carga útil de EventBridge eventos de Amazon
Crea una regla que coincida con los EventBridge eventos de Amazon
Configura el objetivo de la regla de Amazon creada EventBridge

Formatos de carga útil de EventBridge eventos de Amazon

Evento con estado de grabación de pantalla: INICIADO

Este evento se emite cuando el agente acepta un contacto, lo que puede ocurrir antes de que comience la grabación, por cada contacto que tenga habilitada la grabación de pantalla del agente.


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

Evento con estado de grabación de pantalla: COMPLETADO

Este evento se emite cuando finaliza la grabación de pantalla en el escritorio del agente. Esto no significa que la grabación de pantalla se haya subido correctamente a su bucket de 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",  
    }  
  }  
}

Evento con estado de grabación de pantalla: PUBLICADO

Este evento se emite cuando la grabación de pantalla se carga correctamente en su bucket de Amazon S3. Los detalles incluyen la ubicación del bucket de Amazon S3, el tamaño y la duración de la grabación.


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

Evento con estado de grabación de pantalla: FALLIDO

Este evento se emite si se produce un error en la grabación de la pantalla. La información sobre el error incluye una estimación, según el mejor esfuerzo, del posible motivo del error que podemos detectar.


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

En la tabla siguiente se enumeran los valores posibles del failureInfo objeto.

code	message	origen
`CLIENT_LOCAL_NETWORK_ACCESS_BLOCKED`	La política de acceso a la red local del navegador bloqueó la conexión a la aplicación cliente Amazon Connect	`CLIENT`
`CLIENT_APP_NOT_RUNNING`	La aplicación cliente Amazon Connect no se ejecuta en el escritorio del agente	`CLIENT`
`CLIENT_UNSUPPORTED_OS`	El sistema operativo del agente no es compatible con la grabación de pantalla	`CLIENT`
`CLIENT_AUTH_ERROR`	La aplicación cliente de Amazon Connect no se pudo autenticar	`CLIENT`
`CLIENT_CONNECTION_ERROR`	La aplicación cliente Amazon Connect no está conectada	`CLIENT`
`MULTIPLE_CCP_INTERACTION`	Se detectaron múltiples interacciones del navegador con CCP	`CLIENT`
`USER_ERROR`	La solicitud encontró un error de configuración de usuario	`CLIENT`
`SERVICE_ISSUE`	La solicitud encontró una excepción de servicio	`SERVICE`
`UNKNOWN`	Fallo desconocido	`UNKNOWN`

Crea una regla que coincida con los EventBridge eventos de Amazon

Para suscribirte a EventBridge los eventos de Amazon y comprobar el estado de las grabaciones de pantalla, debes crear una EventBridge regla de Amazon que coincida con la fuente y el tipo de detalle del evento definidos. Esto se puede lograr a través de la AWS consola o AWS CDK de las bibliotecas.

Cree una regla mediante el AWS Consola

En la AWS consola, cree una nueva regla en Amazon EventBridge → Autobuses → Reglas.

Usa el bus de eventos predeterminado

La página de creación de reglas muestra la selección predeterminada del bus de eventos.

Utilice una plantilla de patrón de eventos

Seleccione el patrón de eventos definido en las listas desplegables.

El menú desplegable Fuente del evento que muestra aws.connect seleccionado.

Se ha seleccionado el patrón de eventos que muestra el estado de grabación de la pantalla modificado.

Si el tipo de evento no aparece en la lista desplegable, también puedes crear el mismo patrón usando el patrón personalizado (editor JSON) con:


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

Crea una regla usando AWS CDK

Como alternativa, si gestionas AWS los recursos con AWS CDK, aquí tienes un fragmento de TypeScript código de ejemplo para crear una regla de 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" ]  
    }  
});

Configura el objetivo de la regla de Amazon creada EventBridge

Amazon EventBridge admite varios AWS servicios como objetivos. En función de tus necesidades, es flexible crear tu propio proceso de procesamiento de eventos con otros AWS servicios. Puede definir hasta cinco destinos para cada regla. Para obtener más información, consulte EventBridge los objetivos de Amazon en la Guía del EventBridge usuario de Amazon.

El grupo de CloudWatch registros de Amazon como objetivo de ejemplo

En el siguiente ejemplo, se utiliza un grupo de CloudWatch registros de Amazon como objetivo.

La configuración de destino muestra el grupo de CloudWatch registros seleccionado.

En el AWS CDK código, cree el recurso y agréguelo a la EventBridge regla de 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)));

Ejemplos de consultas de Amazon CloudWatch Log Insights

Con el lenguaje de consulta de Amazon CloudWatch Insights, estos son algunos ejemplos de consultas:

Ejemplo de consulta sobre la tasa de éxito


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

Ejemplo de consulta para obtener los recuentos del estado de cada grabación


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

Ejemplo de consulta sobre los contactos fallidos con los códigos de error más comunes


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

Ejemplo de consulta sobre los agentes con la mayoría de los contactos fallidos


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

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Descarga de los archivos de registro de la aplicación de grabación de pantalla

Preguntas frecuentes sobre las capacidades de grabación de pantalla