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

# Bloco de fluxo no Amazon Connect: obtenha métricas
<a name="get-queue-metrics"></a>

Por padrão, esse bloco retorna métricas de fila para a fila atual. Opcionalmente, você pode optar por retornar métricas para uma queue/channel combinação diferente ou métricas em nível de contato, como a posição do contato na fila. As métricas são retornadas como atributos que podem ser referenciados por meio JSONPath do bloco Verificar atributos de contato.

## Description
<a name="get-metrics-description"></a>
+ Recupera métricas de fila quase em tempo real com um atraso de cinco a dez segundos para decisões de roteamento mais granulares. 
+ Você pode rotear contatos com base no status da fila, como o número de contatos na fila ou os atendentes disponíveis. 
+  As métricas de fila são agregadas em todos os canais por padrão e retornadas como atributos. 
+  A fila atual é usada por padrão. 
+ Para métricas baseadas em atendentes (como atendentes on-line, disponíveis ou com equipe), se não houver atendentes, nenhuma métrica será retornada.
+ Para o tempo de espera estimado da fila, a métrica só retornaria quando houvesse um único canal fornecido.
+ A seguir estão as métricas que podem ser recuperadas:
  + Nome da fila 
  + ARN da fila 
  + [Contatos na fila](metrics-definitions.md#contacts-in-queue)
  + [Contato mais antigo na fila](metrics-definitions.md#oldest-real-time)
  + [Agentes online](metrics-definitions.md#online-agents)
  + [Agentes disponíveis](metrics-definitions.md#available-real-time)
  + [Agentes fornecidos](metrics-definitions.md#staffed-agents)
  + [Trabalho pós-contato do atendente](metrics-definitions.md#agent-after-contact-work)
  + [Agentes ocupados](metrics-definitions.md#agents-on-contact)
  + [Agentes perdidos](metrics-definitions.md#agent-non-response) (sem resposta do agente)
  + [Agentes não produtivos](metrics-definitions.md#agent-non-productive)
  + [Tempo de espera estimado da fila](metrics-definitions.md#estimated-wait-time)
  + [Tempo estimado de espera do contato](metrics-definitions.md#estimated-wait-time)
  + [Posição de contato na fila](metrics-definitions.md#position-in-queue)
+ É possível optar por retornar métricas por canal, por exemplo, voz ou bate-papo. Você também pode filtrar por fila ou agente. Essas opções permitem que você saiba quantos contatos de bate-papo e voz estão em uma fila e se tem agentes disponíveis para lidar com esses contatos. 
+ Você pode rotear contatos com base no status da fila, como o número de contatos na fila ou os agentes disponíveis. As métricas de fila são agregadas em todos os canais e retornadas como atributos. A fila atual é usada por padrão.
+ Depois de um bloco **Obter métricas**, use [Check contact atributes (Verificar atributos de contato)](check-contact-attributes.md) a para verificar os valores das métricas e definir a lógica de roteamento com base neles, como número de contatos em uma fila, número de agentes disponíveis e contato mais antigo em uma fila. 

## Canais compatíveis
<a name="get-metrics-channels"></a>

A tabela a seguir lista como esse bloco direciona um contato que está usando o canal especificado. 


| Canal | Compatível? | 
| --- | --- | 
| Voz | Sim | 
| Chat | Sim | 
| Tarefa | Sim | 
| E-mail | Sim | 

## Tipos de fluxo
<a name="get-metrics-types"></a>

É possível usar esse bloco nos seguintes [tipos de fluxo](create-contact-flow.md#contact-flow-types):
+ Todos os fluxos

## Propriedades
<a name="get-metrics-properties"></a>

A imagem a seguir mostra a página **Propriedades** do bloco **Obter métricas**. Ele está configurado para recuperar métricas para o canal **Voz**.

![A página de propriedades do bloco Obter métricas.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/get-metrics-properties1.png)


Você pode recuperar métricas por canal, and/or fila ou agente.
+ Se você não especificar um canal, ele retornará métricas para todos os canais. 
+ Se não especificar uma fila, serão retornadas métricas para a fila atual.
+ Os atributos dinâmicos só podem retornar métricas para um canal. 

Por exemplo, a imagem a seguir mostra a página **Propriedades** configurada para o canal **Chat **BasicQueue****e. Se você escolher essas configurações, a opção **Obter métricas da fila** retornará métricas somente para o BasicQueue, filtradas para incluir somente contatos do chat. 

![A seção de parâmetros opcionais da página Propriedades.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/get-metrics-properties3.png)


## Dicas de configuração
<a name="get-metrics-tips"></a>

### Especificar um canal no bloco Ver atributos do contato
<a name="get-metrics-tips1"></a>

Os atributos dinâmicos só podem retornar métricas para um canal.

Antes de usar atributos dinâmicos no bloco **Obter métricas**, você precisa definir os atributos no [Set contact attributes (Definir atributos do contato)](set-contact-attributes.md) bloco e especificar qual canal.

Quando um canal é definido dinamicamente usando texto, como mostrado na imagem a seguir, para o valor do atributo, insira **Voz** ou **Chat**. Esse valor não diferencia letras maiúsculas de minúsculas. 

![A página de propriedades do bloco Definir atributos do contato, Valor definido como chat.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/get-metrics-properties2.png)


### Usando o bloco Verificar atributos de contato após o bloco Obter métricas
<a name="get-metrics-tips2"></a>

Depois de um bloco **Obter métricas**, adicione um [Check contact atributes (Verificar atributos de contato)](check-contact-attributes.md) bloco à ramificação com base nas métricas retornadas. Use as seguintes etapas:

1. Depois de **Obter métricas**, adicione um bloco **Verificar atributos de contato**.

1. No bloco **Verificar atributos do contato**, defina **Atributos para verificar** como **Métricas da fila**.

1. Na caixa suspensa **Valor**, você verá uma lista de métricas que podem ser verificadas pelo bloco **Obter métricas**. Escolha a métrica que deseja usar para a decisão de roteamento.   
![Seção Atributos para verificar, lista suspensa de métricas disponíveis.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/get-metrics-block-returned-metrics.png)

### Por que o bloco Get metrics gera um erro
<a name="get-metrics-tips3"></a>

O bloco **Obter métricas** gera um erro no seguinte cenário: 

1. Você adiciona este bloco ao seu fluxo.

1. O relatório Métricas em tempo real retorna métricas vazias porque nenhuma atividade está ocorrendo.

1. O bloco **Obter métricas** gera um erro porque não há métricas para exibir.

## Bloco configurado
<a name="get-metrics-configured"></a>

A imagem a seguir mostra um exemplo da aparência deste bloco quando configurado. Tem dois ramos: **Êxito** e **Erro**.

![Um bloco Get metrics configurado.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/get-metrics-configured.png)


## Cenários
<a name="get-metrics-scenarios"></a>

Consulte estes tópicos para ver cenários que usam este bloco:
+ [Como fazer referência a atributos de contato no Amazon Connect](how-to-reference-attributes.md)