View a markdown version of this page

Use EventBridge eventos da Amazon para rastrear o status da gravação de tela - Amazon Connect
Formatos de carga útil de EventBridge eventos da AmazonCrie uma regra para corresponder aos EventBridge eventos da AmazonConfigurar o destino da EventBridge regra criada pela Amazon

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 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

  • Receba alertas quase em tempo real em um painel do Amazon Quick

  • Crie relatórios agregados fora do Amazon Connect

  • Conecte suas outras soluções personalizadas de pipeline de dados com a Amazon EventBridge

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.

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.
O padrão de evento mostrando o status de gravação de tela alterado foi selecionado.

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 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 como destino.

A configuração do Target mostrando o grupo de CloudWatch registros selecionado.

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