View a markdown version of this page

Monitore eventos de falha na avaliação de desempenho - Amazon Connect
Step-by-step guiaExemplo de EventBridge carga útilErros comuns

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.

  2. Escolha Criar regra com o barramento de eventos padrão selecionado.

    O botão Criar regra com o barramento de eventos padrão selecionado.

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

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

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

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

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

  8. 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.
    CloudWatch detalhe do registro mostrando os metadados e o motivo da falha.

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_SUBMISSION_FAILED 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_FILE_ERROR O envio automático da avaliação de contatos falhou devido a um erro searching/retrieving/parsing no arquivo de análise.
INTERNAL_SERVER_ERROR O envio automático da avaliação de contatos falhou devido a um erro interno do servidor. Aguarde atrasos no processamento.
QUOTA_EXCEEDED_ERROR 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_BUCKET_ACCESS_DENIED A exportação do JSON de avaliação de contatos falhou devido a permissões insuficientes.
S3_STORAGE_NOT_CONFIGURED O bucket S3 de exportação não está configurado para sua instância.
INTERNAL_SERVER_ERROR 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.