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á.
# Monitore eventos de falha na avaliação de desempenho
Você pode monitorar falhas de avaliações automatizadas, bem como exportações S3 de avaliações de contato usando e. EventBridge CloudWatch Você pode usar esses eventos para investigar e corrigir falhas. O guia a seguir mostra o processo de criação de EventBridge regras personalizadas para monitorar eventos de falha na avaliação de desempenho.
## Step-by-step guia
Este é um guia sobre como criar uma EventBridge regra para registrar eventos de envio de avaliação automática falhados do Amazon Connect e exportações malsucedidas de avaliações de contatos do Amazon Connect para o S3 em seu console. AWS
1. Faça login na sua AWS conta e navegue até o EventBridge console. Escolha **Regras** na seção **Ônibus**.
![\[A guia Regras na seção Ônibus no EventBridge console.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/perf-eval-eventbridge-rules-tab.png)
1. Escolha **Criar regra** com o barramento de eventos padrão selecionado.
![\[O botão Criar regra com o barramento de eventos padrão selecionado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/perf-eval-eventbridge-create-rule.png)
1. Dê um nome à regra e selecione **Regra com um padrão de evento** para o tipo de regra. Escolha **Próximo**.
![\[O nome da regra e a opção Regra com um padrão de evento selecionada.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/perf-eval-eventbridge-rule-name.png)
1. Com **eventos da AWS ou eventos de EventBridge parceiros** selecionados em **Eventos**, selecione a opção **Usar formulário padrão** em **Padrão de evento**. É aqui que você definirá o padrão correspondente para acionar a regra.
1. Digite e selecione **Amazon Connect** na lista suspensa do **serviço AWS** para restringir os tipos de eventos. Selecione o tipo de evento desejado no menu suspenso abaixo. Escolha **Avançar** quando o padrão estiver configurado.
Para se inscrever em tipos de EventBridge eventos, crie uma EventBridge regra personalizada que corresponda ao seguinte:
+ `"source"` = `"aws.connect"`
+ `"detail-type"` pode ser um dos seguintes:
+ `"Contact Lens Automated Evaluation Submission Failed"`
+ `"Contact Lens Evaluation Export Failed"`
![\[O padrão de eventos com o Amazon Connect selecionado como o serviço da AWS.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/perf-eval-eventbridge-event-pattern.png)
1. A próxima etapa permite que você configure o (s) destino (s) para process/receive os eventos correspondentes. Para simplificar, selecione a opção de **grupo de CloudWatch registros** em **Selecionar um destino** e escolha um grupo de registros.
1. Escolha **Avançar** e avance para a etapa final de **revisão e criação**. Escolha **Criar regra** mais uma vez para concluir o processo de criação da regra.
1. Agora, se a regra estiver no estado **Ativado** e ocorrer um evento correspondente, os registros correspondentes deverão aparecer no grupo de CloudWatch registros configurado com o relevante IDs na seção de metadados e o motivo da falha na seção de dados.
![\[CloudWatch grupo de registros mostrando EventBridge eventos correspondentes.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/perf-eval-cloudwatch-log-group.png)
![\[CloudWatch detalhe do registro mostrando os metadados e o motivo da falha.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/perf-eval-cloudwatch-log-detail.png)
## Exemplo de EventBridge carga útil
Veja a seguir um exemplo de EventBridge carga útil quando a regra é correspondida:
```
{
"version": "0",
"id": "00005435-d12d-c93b-d9d2-b64cba85fbb6",
"detail-type": "Contact Lens Automated Evaluation Submission Failed",
"source": "aws.connect",
"account": "Your AWS account ID",
"time": "2025-10-02T10:34:56Z",
"region": "us-west-2",
"resources": [],
"detail": {
"version": "1.0.0",
"metadata": {
"contactId": "4266f8e9-8420-4ee7-96cd-515d2edae1f2",
"instanceId": "d9b0b09d-7dab-47e5-9f82-d6787fbc068c",
"formId": "8b1365bd-1415-41a9-a491-af226e1bda4e"
},
"data": {
"reasonCode": "ANALYSIS_FILE_ERROR",
"message": "Automated contact evaluation submission failed due to an error when searching/retrieving/parsing the analysis file."
}
}
}
```
## Erros comuns
Os erros a seguir podem ocorrer quando o sistema eventualmente não consegue processar as avaliações após várias tentativas.
### Erros automatizados de envio de avaliações
| Erro | Mensagem de erro |
| --- | --- |
| AUTOMATED\$1SUBMISSION\$1FAILED | O envio automático da avaliação de contatos falhou porque algumas das perguntas não puderam ser respondidas. Verifique o formulário de avaliação das configurações and/or das regras do Amazon Connect. |
| ANALYSIS\$1FILE\$1ERROR | O envio automático da avaliação de contatos falhou devido a um erro searching/retrieving/parsing no arquivo de análise. |
| INTERNAL\$1SERVER\$1ERROR | O envio automático da avaliação de contatos falhou devido a um erro interno do servidor. Aguarde atrasos no processamento. |
| QUOTA\$1EXCEEDED\$1ERROR | O envio automático da avaliação de contato falhou porque a cota restante para usar o Gen AI para responder automaticamente às perguntas de avaliação do contato é insuficiente. |
### Erros de exportação de avaliação do S3
| Erro | Mensagem de erro |
| --- | --- |
| S3\$1BUCKET\$1ACCESS\$1DENIED | A exportação do JSON de avaliação de contatos falhou devido a permissões insuficientes. |
| S3\$1STORAGE\$1NOT\$1CONFIGURED | O bucket S3 de exportação não está configurado para sua instância. |
| INTERNAL\$1SERVER\$1ERROR | A exportação do JSON de avaliação do contato falhou devido a um erro interno do servidor. Aguarde um atraso na entrega do arquivo de exportação. |