View a markdown version of this page

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

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 os 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 instalada do cliente e horários de início e término da gravação de tela.

nota

O rastreamento do status da gravação de tela com a Amazon EventBridge está disponível em todas as AWS regiões que oferecem suporte à gravação de tela do agente Connect Customer, exceto AWS GovCloud (US-West).

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:

  • Consulta com o Amazon CloudWatch Log Insights

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

  • Crie relatórios agregados fora do Connect Customer

  • 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 ser 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": "3.0.2.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 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": "3.0.2.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 em seu bucket do Amazon S3. Os detalhes incluem a localização do bucket do Amazon S3, o tamanho 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": "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 com status de gravação de tela - FALHA

Esse evento é emitido se a gravação da tela falhar. As informações de falha incluem uma estimativa do melhor esforço 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": "3.0.2.0",  
    },  
    "failureInfo": {  
      "code": "UNKNOWN",  
      "message": "Unknown failure",  
      "source": "UNKNOWN"  
    },  
    "recordingInfo": {  
      "startTime": "2026-01-01T00:00:00.000Z"  
    }  
  }  
}

A tabela a seguir lista os valores possíveis no failureInfo objeto.

código message origem
CLIENT_LOCAL_NETWORK_ACCESS_BLOCKED A política de acesso à rede local do navegador bloqueou a conexão com o aplicativo Amazon Connect Client CLIENT
CLIENT_APP_NOT_RUNNING O aplicativo Amazon Connect Client não está sendo executado no desktop do agente CLIENT
CLIENT_UNSUPPORTED_OS O sistema operacional do agente não é compatível com gravação de tela CLIENT
CLIENT_AUTH_ERROR Falha na autenticação do aplicativo Amazon Connect Client CLIENT
CLIENT_CONNECTION_ERROR O aplicativo Amazon Connect Client não está conectado CLIENT
MULTIPLE_CCP_INTERACTION Detectou várias interações do navegador com o CCP CLIENT
USER_ERROR A solicitação encontrou um erro de configuração do usuário CLIENT
SERVICE_ISSUE A solicitação encontrou uma exceção de serviço SERVICE
UNKNOWN Falha desconhecida UNKNOWN

Crie uma regra para corresponder aos EventBridge eventos da Amazon

Para assinar EventBridge eventos da Amazon para obter o status de gravação de tela, você precisa criar uma EventBridge regra da Amazon que corresponda à fonte e ao tipo de detalhe do evento definidos. 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 barramento de eventos.

Use um padrão de evento modelo

Selecione o padrão de evento definido nas listas suspensas.

O menu suspenso Fonte 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" ]  
    }  
});

Configure o destino da EventBridge regra Amazon criada

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 exemplo de destino

O exemplo a seguir usa um grupo de CloudWatch registros da Amazon como alvo.

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 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 a maioria dos contatos falhados 

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