Monitorar a instância do Amazon Connect usando o CloudWatch - Amazon Connect

Monitorar a instância do Amazon Connect usando o CloudWatch

O Amazon Connect envia dados sobre a instância para as métricas do CloudWatch, para que você possa coletar, visualizar e analisar as métricas do CloudWatch para a central de atendimento virtual do Amazon Connect. Você pode usar esses dados para monitorar as principais métricas operacionais e configurar alarmes. Os dados sobre a central de atendimento são enviados ao CloudWatch a cada minuto.

Ao visualizar o painel de métricas do CloudWatch, você pode especificar o intervalo de atualização dos dados exibidos. Os valores exibidos no painel vão refletir os valores do intervalo de atualização que você definir. Por exemplo, se você definir o intervalo de atualização como um minuto, os valores serão exibidos por um período de um minuto. Você pode selecionar um intervalo de atualização de 10 segundos, mas o Amazon Connect não envia dados com uma frequência maior do que a cada minuto. As métricas enviadas para o CloudWatch ficam disponíveis por duas semanas e, em seguida, são descartadas. Para saber mais sobre métricas no CloudWatch, consulte o Guia do usuário do Amazon CloudWatch.

nota

Se sua instância do Amazon Connect foi criada em ou antes de outubro de 2018, você precisará fornecer permissão ao Amazon Connect para começar a publicar métricas de chat em sua conta do CloudWatch. Para fazer isso, crie uma política do IAM com a seguinte permissão e anexe-a ao perfil de serviço do Amazon Connect. Você pode encontrar o perfil de serviço do Amazon Connect na página Visão geral da conta da instância do Amazon Connect.

{ "Effect": "Allow", "Action": "cloudwatch:PutMetricData", "Resource": "*", "Condition": { "StringEquals": { "cloudwatch:namespace": "AWS/Connect" } } }

Métricas do Amazon Connect enviadas ao CloudWatch

O namespace AWS/Connect inclui as métricas a seguir.

Métrica Descrição
CallsBreachingConcurrencyQuota

O número total de chamadas de voz que ultrapassa a cota de chamadas simultâneas para a instância. Para saber o número total de chamadas que violam a cota, dê uma olhada na estatística Soma.

Por exemplo, suponha que seu centro de contatos tenha os seguintes volumes e sua cota de serviço é 100 chamadas simultâneas:

  • 0:00: 125 chamadas simultâneas. Esse valor equivale a 25 acima da cota.

  • 0:04: 135 chamadas simultâneas. Esse valor equivale a 35 acima da cota.

  • 0:10: 150 chamadas simultâneas. Esse valor equivale a 50 acima da cota.

CallsBreachingConcurrencyQuota = 110: o número total de chamadas de voz que excedeu a cota entre 0:00 e 0:10.

Unidade: contagem

Dimensão:

  • InstanceId: o ID da instância

  • MetricGroup: VoiceCalls

CallBackNotDialableNumber

O número de vezes em que uma chamada de retorno para um cliente na fila não pôde ser discada porque o número do cliente estava em um país para o qual as chamadas de saída não são permitidas na instância. Os países permitidos em uma instância são definidos pelas cotas de serviço.

Unidade: contagem

Dimensões:

  • InstanceId o ID da instância

  • MetricGroup: ContactFlow

  • ContactFlowName: o nome do fluxo

CallRecordingUploadError

O número de gravações de chamadas que não foram carregadas no bucket do Amazon S3 configurado para a instância. Este é o bucket especificado nas configurações de Data Storage (Armazenamento físico de dados) > Call Recordings (Gravações de chamadas) da instância.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: CallRecordings

CallsPerInterval

O número de chamadas de voz, de entrada e de saída, recebidas ou colocadas por segundo na instância.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: VoiceCalls

ChatsBreachingActiveChatQuota

O número total de solicitações válidas feitas para iniciar um chat que excedeu a cota de chats ativos simultâneos da instância. Para saber o número total de solicitações chat que violam a cota, dê uma olhada na estatística Soma.

Por exemplo, suponha que sua central de atendimento tenha os seguintes volumes e sua cota de serviço seja 2500 chats ativos simultâneos:

  • 0:00: 2525 chats ativos simultâneos. Esse valor equivale a 25 acima da cota.

  • 0:04: 2535 chats ativos simultâneos. Esse valor equivale a 35 acima da cota.

  • 0:10: 2550 chats ativos simultâneos. Esse valor equivale a 50 acima da cota.

ChatsBreachingActiveChatsQuota = 110: o número total de chats que excederam a cota entre 0:00 e 0:10.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Chats

ConcurrentActiveChats

O número de chats ativos simultâneos na instância na hora em que os dados são exibidos no painel. O valor exibido para essa métrica é o número de chats ativos simultâneos na hora em que o painel é exibido e não uma soma para todo o intervalo do conjunto de intervalos de atualização. Todos os chats ativos são incluídos, não apenas os chats ativos que estão conectados aos atendentes.

Embora todas as estatísticas estejam disponíveis no CloudWatch para chats ativos simultâneos, você pode estar mais interessado em ver a estatística Máxima/média. A estatística Sum (Soma) não é tão útil aqui.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Chats

ConcurrentActiveChatsPercentage

A porcentagem da cota de serviço dos chats ativos simultâneos usada na instância. É calculada da seguinte forma:

  • ConcurrentActiveChats / ConfiguredConcurrentActiveChatsLimit

Onde ConfiguredConcurrentActiveChatsLimit são os chats ativos simultâneos por instância configurados para sua instância.

Unidade: porcentagem (a saída é exibida como um número inteiro. Por exemplo, 1% dos chats é mostrado como 1, não como 0,01.)

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Chats

ConcurrentCalls

O número de chamadas de voz ativas simultâneas na instância na hora em que os dados são exibidos no painel. O valor exibido para essa métrica é o número de chamadas ativas simultâneas na hora em que o painel é exibido e não uma soma para todo o intervalo do conjunto de intervalos de atualização. Todas as chamadas de voz ativas são incluídas, não apenas as chamadas ativas que estão conectadas aos agentes.

Embora todas as estatísticas estejam disponíveis no CloudWatch para chamadas de voz simultâneas, você pode estar mais interessado em ver a estatística Máxima/média. A estatística Sum (Soma) não é tão útil aqui.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: VoiceCalls

ConcurrentCallsPercentage

A porcentagem da cota de serviço das chamadas de voz ativas simultâneas usada na instância. É calculada da seguinte forma:

  • ConcurrentCalls / ConfiguredConcurrentCallsLimit

Unidade: percentual (a saída é exibida como decimal)

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: VoiceCalls

ConcurrentTasks
nota

Os dados do ConcurrentTasks são enviados ao CloudWatch a cada cinco minutos.

O número de tarefas ativas simultâneas na instância na hora em que os dados são exibidos no painel. O valor exibido para essa métrica é o número de tarefas ativas simultâneas na hora em que o painel é exibido e não uma soma para todo o intervalo do conjunto de intervalos de atualização. Todas as tarefas de voz ativas são incluídas, não apenas as tarefas ativas que estão conectadas aos atendentes.

Embora todas as estatísticas estejam disponíveis no CloudWatch para tarefas simultâneas, você pode estar mais interessado em ver a estatística Máxima/média. A estatística Sum (Soma) não é tão útil aqui.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Tarefas

ConcurrentTasksPercentage
nota

Os dados do ConcurrentTasksPercentage são enviados ao CloudWatch a cada cinco minutos.

A porcentagem da cota de serviço das tarefas ativas simultâneas usada na instância. É calculada da seguinte forma:

  • ConcurrentTasks / ConfiguredConcurrentTasksLimit

Onde ConfiguredConcurrentTasksLimit são as Tarefas simultâneas por instância configuradas para sua instância.

Unidade: porcentagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Tarefas

ContactFlowErrors

O número de vezes em que a ramificação de erro para um fluxo foi executada.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: ContactFlow

  • ContactFlowName: o nome do fluxo

ContactFlowFatalErrors

O número de vezes em que houve falha na execução de um fluxo devido a um erro do sistema.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: ContactFlow

  • ContactFlowName: o nome do fluxo

LongestQueueWaitTime

O maior tempo, em segundos, que um contato esperou em uma fila. Este é o período que um contato esperou em uma fila durante o intervalo de atualização selecionado no painel do CloudWatch, como 1 minuto ou 5 minutos.

Unidade: segundos

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Queue (Fila)

  • QueueName: o nome da fila

MissedCalls

O número de chamadas de voz que foram perdidas por agentes durante o intervalo de atualização selecionado, como 1 minuto ou 5 minutos. Uma chamada perdida é uma que não foi atendida por um agente em até 20 segundos.

Para monitorar o total de chamadas perdidas em um determinado período, examine a estatística Soma no CloudWatch.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: VoiceCalls

MisconfiguredPhoneNumbers

O número de chamadas em que houve falha porque o número de telefone não estava associado a um fluxo.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: VoiceCalls

PublicSigningKeyUsage

O número de vezes em que uma chave de segurança de fluxo (chave de assinatura pública) foi usada para criptografar as informações do cliente em um fluxo.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • SigningKeyId: o ID da chave de assinatura

QueueCapacityExceededError

O número de chamadas que foram rejeitadas porque a fila estava cheia.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Queue (Fila)

  • QueueName: o nome da fila

QueueSize

O número de contatos na fila. O valor reflete o número de contatos na fila no momento em que o painel é acessado, e não pela duração do período do relatório.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Queue (Fila)

  • QueueName: o nome da fila

SuccessfulChatsPerInterval

O número de chats iniciados na instância para o intervalo definido.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Chats

TasksBreachingConcurrencyQuota

O número total de tarefas que ultrapassa a cota de tarefas simultâneas para a instância. Para saber o número total de tarefas que violam a cota, dê uma olhada na estatística Soma.

Por exemplo, suponha que sua central de atendimento tenha os seguintes volumes e sua cota de serviço seja 2500 tarefas simultâneas:

  • 0:00: 2525 tarefas simultâneas. Esse valor equivale a 25 acima da cota.

  • 0:04: 2535 tarefas simultâneas. Esse valor equivale a 35 acima da cota.

  • 0:10: 2550 tarefas simultâneas. Esse valor equivale a 50 acima da cota.

TasksBreachingConcurrencyQuota = 110: o número total de tarefas que excederam a cota entre 0:00 e 0:10.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Tarefas

TasksExpired

Tarefas que expiraram após estarem ativas por sete dias.

Para monitorar o total de tarefas que expiraram em um determinado período, examine a estatística Soma no CloudWatch.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Tarefas

  • ContactId: o ID do contato da tarefa

TasksExpiryWarningReached

Tarefas que estiveram ativas por 6 dias e 22 horas e atingiram o limite de aviso de expiração.

Para monitorar o total de tarefas que atingiram o limite de aviso de expiração em um determinado período, examine a estatística Soma no CloudWatch.

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: Tarefas

  • ContactId: o ID do contato da tarefa

ThrottledCalls

O número de chamadas de voz que foram rejeitadas porque a taxa de chamadas por segundo excedeu a cota máxima com suporte. Para aumentar a taxa de chamadas com suporte, solicite um aumento na cota de serviço para chamadas ativas simultâneas por instância.

Para monitorar o total de chamadas limitadas em um determinado período, examine a estatística Soma no CloudWatch.

Unidade: segundos

Unidade: contagem

Dimensões:

  • InstanceId: o ID da instância

  • MetricGroup: VoiceCalls

ToInstancePacketLossRate

A taxa de perda de pacotes para chamadas na instância, relatada a cada 10 segundos. Cada ponto de dados está entre 0 e 100. A taxa de perda de pacotes para chamadas na instância aparece como uma porcentagem entre 0 e 1.

Unidade: Percentual

Dimensões:

  • Participant (Participante): Agent (Agente)

  • Type of Connection (Tipo de conexão): WebRTC

  • Instance ID (ID da instância): o ID da instância

  • Stream Type (Tipo de fluxo): Voice (Voz)

Dimensões de métricas do Amazon Connect no CloudWatch

No CloudWatch, uma dimensão é um par de nome/valor que identifica exclusivamente uma métrica. No painel, as métricas são agrupadas por dimensão. Ao visualizar as métricas no painel, apenas as métricas com dados serão exibidas. Se não houver atividade durante o intervalo de atualização para o qual há uma métrica, os dados da instância não serão exibidos no painel.

As seguintes dimensões são usadas no painel do CloudWatch para as métricas do Amazon Connect.

Dimensão das métricas de fluxo

nota

Os nomes das filas devem conter somente os seguintes caracteres para que sejam exibidos no CloudWatch: caracteres alfanuméricos (0-9, A-Z, a-z), ponto final (.), hífen (-), subtraço (_), barra (/), cerquilha (#), dois pontos (:), vírgula (,), cifrão ($), arroba (@), barra vertical (|), “E” comercial (&), chaves ({ e }), sinal de adição (+), interrogação (?), sinal de porcentagem (%) e o caractere de espaço.

Filtra os dados de métrica por fluxo. Inclui as seguintes métricas:

  • ContactFlowErrors

  • ContactFlowFatalErrors

  • PublicSigningKeyUsage

Dimensão das métricas de contato

Filtra os dados de métrica por contatos. Inclui as seguintes métricas:

  • TasksExpiryWarningReached

  • TasksExpired

Dimensão das métricas da instância

Filtra os metadados por instância. Inclui as seguintes métricas:

  • CallsBreachingConcurrencyQuota

  • CallsPerInterval

  • CallRecordingUploadError

  • ChatsBreachingActiveChatQuota

  • ConcurrentActiveChats

  • ConcurrentActiveChatsPercentage

  • ConcurrentCalls

  • ConcurrentCallsPercentage

  • ConcurrentTasks

  • ConcurrentTasksPercentage

  • MisconfiguredPhoneNumbers

  • MissedCalls

  • SuccessfulChatsPerInterval

  • TasksBreachingConcurrencyQuota

  • ThrottledCalls

ID da instância, participante, tipo de fluxo, tipo de conexão

Filtra os dados da métrica por conexão. Inclui as seguintes métricas:

  • ToInstancePacketLossRate

Dimensão das métricas de filas

nota

Se uma fila tiver um nome de dimensão em caracteres não ASCII, você não poderá vê-la no CloudWatch.

Filtra os dados da métrica por fila. Inclui as seguintes métricas:

  • CallBackNotDialableNumber

  • LongestQueueWaitTime

  • QueueCapacityExceededError

  • QueueSize

Métricas do Amazon Connect Voice ID enviadas ao CloudWatch

O namespace VoiceID inclui as métricas a seguir.

RequestLatency

O tempo decorrido para a solicitação.

Frequência: 1 minuto

Unidade: milissegundos

Dimensão: API

UserErrors

O número de contagens de erros devidos a solicitações incorretas do usuário.

Frequência: 1 minuto

Unidade: contagem

Dimensão: API

SystemErrors

O número de contagens de erros devidos a um erro de serviço interno.

Frequência: 1 minuto

Unidade: contagem

Dimensão: API

Throttles

O número de solicitações rejeitadas por excederem a taxa máxima permitida para o envio de solicitações.

Frequência: 1 minuto

Unidade: contagem

Dimensão: API

ActiveSessions

O número de sessões ativas no domínio. Sessões ativas são sessões com status pendente ou em andamento.

Frequência: 1 minuto

Unidade: contagem

Dimensão: Domínio

ActiveSpeakerEnrollmentJobs

O número de trabalhos de inscrição em lote ativos no domínio. Os trabalhos ativos são aqueles com status Pendente ou InProgress.

Frequência: 15 minutos

Unidade: contagem

Dimensão: Domínio

ActiveFraudsterRegistrationJobs

O número de trabalhos de registro em lote ativos no domínio. Os trabalhos ativos são aqueles com status Pendente ou InProgress.

Frequência: 15 minutos

Unidade: contagem

Dimensão: Domínio

Speakers

O número de locutores no domínio.

Frequência: 15 minutos

Unidade: contagem

Dimensão: Domínio

Fraudsters

O número de fraudadores no domínio.

Frequência: 15 minutos

Unidade: contagem

Dimensão: Domínio

Dimensões de métricas do Amazon Connect Voice ID

As seguintes dimensões são usadas no painel do CloudWatch para as métricas do Amazon Connect Voice ID. Ao visualizar as métricas no painel, apenas as métricas com dados serão exibidas. Se não houver atividade durante o intervalo de atualização para o qual há uma métrica, os dados da instância não serão exibidos no painel.

Dimensão de métricas da API

Esta dimensão limita os dados a uma das seguintes operações do Voice ID:

  • DeleteFraudster

  • EvaluateSession

  • ListSpeakers

  • DeleteSpeaker

  • OptOutSpeaker

Dimensão de métricas do domínio

O domínio do Voice ID em que a inscrição, a autenticação ou o registro é realizado.

Métricas de Amazon AppIntegrations enviadas para o CloudWatch

O namespace AWS/AppIntegrations inclui as métricas a seguir.

RecordsDownloaded

O número de registros que foram baixados como parte da execução de um fluxo do AppFlow para uma integração de dados.

Frequência: 1 minuto

Unidade: contagem

Estatísticas válidas: Máximo, Soma, Mínimo, Média

RecordsFailed

O número de registros que não foram baixados como parte da execução de um fluxo do AppFlow para uma integração de dados.

Frequência: 1 minuto

Unidade: contagem

Estatísticas válidas: Máximo, Soma, Mínimo, Média

DataDownloaded

O número de bytes que foram baixados como parte da execução de um fluxo do AppFlow para uma integração de dados.

Frequência: 1 minuto

Unidade: bytes

Estatísticas válidas: Máximo, Soma, Mínimo, Média

DataProcessingDuration

O tempo necessário para processar e baixar dados como parte de uma única execução de fluxo do AppFlow para uma integração de dados.

Frequência: 1 minuto

Unidade: milissegundos

Estatísticas válidas: Máximo, Soma, Mínimo, Média

EventsReceived

O número de eventos que foram emitidos da aplicação de origem de terceiros (Salesforce, Zendesk) e recebidos no barramento de eventos.

Frequência: 1 minuto

Unidade: contagem

Estatísticas válidas: Máximo, Soma, Mínimo, Média

EventsProcessed

O número de eventos que foram processados e encaminhados para serem avaliados de acordo com as regras que você configurou em uma integração de eventos.

Frequência: 1 minuto

Unidade: contagem

Estatísticas válidas: Máximo, Soma, Mínimo, Média

EventsThrottled

O número de eventos que foram limitados porque a taxa de emissão de eventos excedeu a cota máxima suportada.

Frequência: 1 minuto

Unidade: bytes

Estatísticas válidas: Máximo, Soma, Mínimo, Média

EventsFailed

O número de eventos que não foram processados devido a eventos de terceiros malformados ou sem suporte e outros erros de processamento.

Frequência: 1 minuto

Unidade: bytes

Estatísticas válidas: Máximo, Soma, Mínimo, Média

EventProcessingDuration

O tempo necessário para processar e encaminhar um evento a ser avaliado de acordo com as regras que você configurou em uma integração de eventos.

Frequência: 1 minuto

Unidade: milissegundos

Estatísticas válidas: Máximo, Soma, Mínimo, Média

Dimensões de métricas do Amazon AppIntegrations

É possível usar as seguintes dimensões para refinar as métricas do AppIntegrations.

Dimensão Descrição
AccountId

ID da conta da AWS

ClientId

Entidade principal de serviço do cliente

IntegrationARN

ARN da integração de eventos ou dados

IntegrationType

DataIntegration ou EventIntegration

Region

Região da integração de dados ou eventos

Métricas do Amazon Connect Customer Profiles

O namespace AWS/CustomerProfiles inclui as métricas a seguir.

Métricas de exportação em tempo real enviadas para o CloudWatch

As duas métricas a seguir serão publicadas no CloudWatch para cada tarefa de exportação. Essas métricas fornecerão informações sobre as tarefas do fluxo de exportação e permitirão que você configure os fluxos do Kinesis com base no caso de uso. No caso de limitação, essas métricas permitirão que você provisione o fluxo do Kinesis para garantir a entrega no destino.

EventsProcessed

Número de registros transmitidos em um fluxo do Kinesis.

Unidade: contagem

EventsThrottled

Número de tentativas de PutRecord que encontraram exceção de limitação.

Unidade: contagem

Dimensões de métricas do Amazon Connect Customer Profiles

É possível usar as seguintes dimensões para refinar as métricas do Customer Profiles.

Dimensão Descrição
DomainName

Nome de domínio do Customer Profiles

DestinationType

Tipo de destino. O valor disponível é: Kinesis

DestinationName

Nome do destino. Nome do fluxo de dados do Kinesis para DestinationType: Kinesis.

Usar métricas do CloudWatch para calcular a cota de chamadas simultâneas

Importante

As informações de cálculo de ConcurrentCallsPercentage não são as mesmas de ConcurrentTasksPercentage e ConcurrentChatPercentage.

  • As métricas emitidas para ConcurrentCallsPercentage estão em decimal e não são multiplicadas por 100. A métrica representa uma porcentagem da cota total.

  • Para ConcurrentTasksPercentage e ConcurrentChatPercentage, o valor é multiplicado por 100. Isso resulta na cota total.

  • As métricas emitidas estão corretas e não há discrepância nos dados.

Veja como calcular o uso da cota para chamadas simultâneas.

Com chamadas ativas no sistema, consulte ConcurrentCalls e ConcurrentCallsPercentage. Calcule quanto da sua cota foi usada:

  • (ConcurrentCalls / ConcurrentCallsPercentage)

Por exemplo, se a quantidade de ConcurrentCalls for 20 e a de ConcurrentCallsPercentage for 50, sua cota de uso será calculada como (20/0,5) = 40. Sua cota total é de 40 chamadas.

Usar métricas do CloudWatch para calcular a cota de chats ativos simultâneos

Veja como calcular sua cota para chats ativos simultâneos.

Com chats ativos no sistema, consulte ConcurrentActiveChats e ConcurrentChatsPercentage. Calcular a cota:

  • (ConcurrentActiveChats / ConcurrentActiveChatsPercentage) * 100

Por exemplo, se a quantidade de ConcurrentActiveChats for 1000 e ConcurrentActiveChatsPercentage for 50, sua cota será calculada como (1000/50)*100 = 2000. Sua cota total é de 2000 chats.

Usar métricas do CloudWatch para calcular a cota de tarefas simultâneas

Veja como calcular sua cota para tarefas simultâneas.

Com tarefas ativas no sistema, consulte ConcurrentTasks e ConcurrentTasksPercentage. Calcular a cota:

  • (ConcurrentTasks / ConcurrentTasksPercentage)*100

Por exemplo, se a quantidade de ConcurrentTasks for 20 e a ConcurrentTasksPercentage for 50, sua cota será calculada como (20/50)*100 = 40. Sua cota total é de 40 tarefas.