As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Use EventBridge eventos da Amazon para rastrear o status da gravação de tela
Com a Amazon EventBridge, você pode visualizar o status das [gravações de tela do agente](agent-screen-recording.md) quase em tempo real. O evento para cada gravação de tela do agente inclui success/failure status, códigos de falha com descrições, local da gravação, tamanho da gravação, versão do cliente instalado e horários de início e término da gravação de tela.
Você pode se integrar a outros AWS serviços para obter informações analíticas ou de monitoramento das gravações de tela do agente:
+ Consulte com o [Amazon CloudWatch Log Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)
+ Receba alertas quase em tempo real em um painel do [Amazon Quick](https://aws.amazon.com/quicksight/)
+ Crie relatórios agregados fora do Amazon Connect
+ Conecte suas outras soluções personalizadas de pipeline de dados com a Amazon EventBridge
**Topics**
+ [Formatos de carga útil de EventBridge eventos da Amazon](#eventbridge-payload-formats)
+ [Crie uma regra para corresponder aos EventBridge eventos da Amazon](#create-eventbridge-rule)
+ [Configurar o destino da EventBridge regra criada pela Amazon](#configure-eventbridge-target)
## Formatos de carga útil de EventBridge eventos da Amazon
### Evento com status de gravação de tela - INICIADO
Esse evento é emitido quando um contato é aceito pelo agente, o que pode ocorrer antes do início da gravação, para cada contato com a gravação de tela do agente ativada.
```
{
"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",
}
}
}
```
### Evento com status de gravação de tela - CONCLUÍDO
Esse evento é emitido quando a gravação de tela termina na área de trabalho do agente. Isso não significa que a gravação de tela foi enviada com sucesso para o seu bucket do 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",
}
}
}
```
### Evento com status de gravação de tela - PUBLICADO
Esse evento é emitido quando a gravação de tela é carregada com sucesso no seu bucket do Amazon S3. Os detalhes incluem a localização do bucket do Amazon S3, o tamanho da gravação e a duração da gravação.
```
{
"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
}
}
}
```
### Evento com status de gravação de tela - FALHA
Esse evento é emitido se a gravação da tela falhar. Os detalhes sobre as informações de falha são fornecidos como uma estimativa do possível motivo da falha que somos capazes de 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": "2.0.3.0",
},
"failureInfo": {
"code": "UNKNOWN",
"message": "UNKNOWN",
"source": "Unknown failure"
},
"recordingInfo": {
"startTime": "2026-01-01T00:00:00.000Z"
}
}
}
```
## Crie uma regra para corresponder aos EventBridge eventos da Amazon
Para se inscrever em EventBridge eventos da Amazon para obter o status de gravação de tela, você precisa criar uma EventBridge regra da Amazon que corresponda à fonte definida do evento e ao tipo de detalhe do evento. Isso pode ser feito por meio do AWS console ou das AWS CDK bibliotecas.
### Crie uma regra usando o AWS console
No AWS console, crie uma nova regra em Amazon EventBridge → Ônibus → Regras.
#### Use o barramento de eventos padrão
![\[A página Criar regra mostrando a seleção padrão do ônibus de eventos.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-eventbridge-event-rule.png)
#### Use um modelo de padrão de evento
Selecione o padrão de evento definido nas listas suspensas.
![\[O menu suspenso Origem do evento mostrando aws.connect selecionado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-eventbridge-event-source.png)
![\[O padrão de evento mostrando o status de gravação de tela alterado foi selecionado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-eventbridge-event-pattern.png)
Se o tipo de evento não estiver aparecendo na lista suspensa, você também pode criar o mesmo padrão usando o **padrão personalizado (editor JSON**) com:
```
{
"source": [ "aws.connect" ],
"detailType": [ "Screen Recording Status Changed" ]
}
```
### Crie uma regra usando AWS CDK
Como alternativa, se você gerencia AWS recursos com AWS CDK, aqui está um exemplo de trecho de TypeScript código para criar uma regra da 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" ]
}
});
```
## Configurar o destino da EventBridge regra criada pela Amazon
A Amazon EventBridge oferece suporte a vários AWS serviços como alvos. Dependendo de suas necessidades, é flexível criar seu próprio pipeline de processamento de eventos com outros AWS serviços. É possível definir até cinco destinos para cada regra. Para obter mais informações, consulte as [ EventBridge metas da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) no *Guia EventBridge do usuário da Amazon*.
### Grupo de CloudWatch registros da Amazon como um exemplo de destino
O exemplo a seguir usa um [grupo de CloudWatch registros da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) como destino.
![\[A configuração do Target mostrando o grupo de CloudWatch registros selecionado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/screen-recording-eventbridge-target-cwl.png)
No AWS CDK código, crie o recurso e adicione-o à EventBridge regra da 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)));
```
#### Exemplo de consultas do Amazon CloudWatch Log Insights
Usando a linguagem de consulta do Amazon CloudWatch Insights, aqui estão alguns exemplos de consultas:
+ **Exemplo de consulta sobre a taxa de sucesso**
```
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
```
+ **Exemplo de consulta para obter contagens de cada status de gravação**
```
fields @timestamp, @message, detail
| stats count(*) as Count group by detail.recordingStatus as recordingStatus
```
+ **Exemplo de consulta sobre contatos com falha com os códigos de falha mais comuns**
```
fields @timestamp, @message, detail
| filter detail.recordingStatus = "FAILED"
| stats count(*) as Count group by detail.failureInfo.code as FailureCode
| sort by Count desc
```
+ **Exemplo de consulta sobre agentes com mais contatos falhados**
```
fields @timestamp, @message, detail
| filter detail.recordingStatus = "FAILED"
| stats count(*) as Count group by detail.agentArn as AgentArn
| sort by Count desc
```