本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Connect Customer 中的流量块：获取指标
<a name="get-queue-metrics"></a>

默认情况下，此区块返回当前队列的队列指标。您可以选择返回不同 queue/channel 组合的指标，或联系人级别的指标，例如联系人在队列中的位置。指标以属性形式返回，可通过 JsonPath 或 “检查联系人属性” 块引用。

## 说明
<a name="get-metrics-description"></a>
+ 检索近乎实时的队列指标，延迟 5-10 秒，以做出更精细的路由决策。
+ 您可以根据队列或座席状态路由联系人，例如队列中的联系人数或可用的座席。
+  默认情况下，队列指标将跨所有通道聚合，并作为属性返回。
+  默认情况下使用当前队列。
+ 对于基于座席的指标（例如在线座席、空闲座席或工作中的座席），如果没有座席，则不会返回任何指标。
+ 对于队列的预计等待时间，该指标仅在提供单个频道时才会返回。
+ 以下是可以检索的指标：
  + 队列名称 
  + 队列 ARN 
  + [队列中的联系人](metrics-definitions.md#contacts-in-queue)
  + [队列中最早的联系人](metrics-definitions.md#oldest-real-time)
  + [座席在线](metrics-definitions.md#online-agents)
  + [座席可用](metrics-definitions.md#available-real-time)
  + [座席工作中](metrics-definitions.md#staffed-agents)
  + [座席联系后续工作](metrics-definitions.md#agent-after-contact-work)
  + [座席繁忙](metrics-definitions.md#agents-on-contact)
  + [缺少座席](metrics-definitions.md#agent-non-response)（座席无响应）
  + [无成效座席](metrics-definitions.md#agent-non-productive)
  + [排队预计等待时间 ](metrics-definitions.md#estimated-wait-time)
  + [联系人预计等待时间 ](metrics-definitions.md#estimated-wait-time)
  + [队列中的联系人位置 ](metrics-definitions.md#position-in-queue)
+ 您可以选择按渠道（例如语音或聊天）返回指标。您还可以按队列或座席进行筛选。使用这些选项，您可以知道队列中有多少聊天和语音联系人，以及是否有代理可以处理这些联系人。
+ 您可以根据队列状态路由联系人，例如队列中的联系人数或可用的座席。队列指标将跨所有通道聚合，并作为属性返回。默认情况下使用当前队列。
+ 在 “**获取指标” ** 块之后，使用检查指标值并根据这些值定义路由逻辑，例如队列中的联系人数、可用代理的数量和队列中最早的联系人。[检查联系属性](check-contact-attributes.md)

## 支持的渠道
<a name="get-metrics-channels"></a>

下表列出了此数据块如何路由正在使用指定渠道的联系人。


| 频道 | 是否支持？ | 
| --- | --- | 
| 语音 | 是 | 
| Chat | 是 | 
| 任务 | 是 | 
| 电子邮件 | 是 | 

## 流类型
<a name="get-metrics-types"></a>

您可以在以下[流类型](create-contact-flow.md#contact-flow-types)中使用此数据块：
+ 所有流

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

下图显示了 “**获取指标” ** 块的 “**属性**” 页面。它被配置为检索**语音**频道的指标。

![获取指标块的属性页面。](https://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/get-metrics-properties1.png)


您可以按渠道、队列或代理检索指标。
+ 如果您没有指定渠道，则它会返回所有渠道的指标。
+ 如果您没有指定队列，则它会返回当前队列的指标。
+ 动态属性只能返回一个通道的指标。

例如，下图显示了为**聊天**频道配置的 ** “**属性” 页面，以及**BasicQueue**。如果您选择这些设置，则**获取队列指标**将仅返回的指标 BasicQueue，筛选后仅包含聊天联系人。

![“属性”页面的可选参数部分。](https://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/get-metrics-properties3.png)


## 配置提示
<a name="get-metrics-tips"></a>

### 在“设置联系人属性”数据块中指定渠道
<a name="get-metrics-tips1"></a>

动态属性只能返回一个通道的指标。

在 “**获取指标” ** 区块中使用动态属性之前，您需要在[设置联系属性](set-contact-attributes.md)块中设置属性并指定哪个频道。

当您使用文本动态设置通道时，如下图所示，请为属性值输入**语音**或**聊天**。此值不区分大小写。

![“设置联系人属性”数据块的属性页面，值设置为“聊天”。](https://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/get-metrics-properties2.png)


### 在 “获取指标” 块之后使用 “检查联系人属性” 区块
<a name="get-metrics-tips2"></a>

在 “**获取指标” ** 区块之后，根据返回的指标向分支添加一个[检查联系属性](check-contact-attributes.md)区块。使用以下步骤：

1. 在 “**获取指标” 后**，添加 “**检查联系人属性” ** 区块。

1. 在**检查联系属性**数据块中，将**要检查的属性**设置为**队列指标**。

1. 在 “**值**” 下拉框中，您可以看到 “**获取指标” ** 块可以检查的指标列表。选择要用于路由决策的指标。  
![“要检查的属性”部分，可用指标的下拉列表。](https://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/get-metrics-block-returned-metrics.png)

**Contact-level 指标**  
**联系人预计等待时间**和队列中的**联系人位置**是联系人级别的指标。只有当您在 “获取指标” ** 区块中启用 “**获取联系人指标” 时，它们才会出现在**队列指标**命名空间**中。**在流程中，将它们引用为`$.Metrics.Contact.EstimatedWaitTime`和`$.Metrics.Contact.PositionInQueue`。有关返回属性的完整列表，请参阅[联系人指标属性](connect-attrib-list.md#attribs-contact-metrics-table)。  
**联系预计等待时间**需要[连接客户](enable-nextgeneration-amazonconnect.md)。

### 为什么 Get metrics 区块会引发错误
<a name="get-metrics-tips3"></a>

在以下情况下，**获取指标**块会引发错误：

1. 您可以在流中添加此数据块。

1.  Real-time 指标报告返回空指标，因为没有发生任何活动。

1. 由于没有指标可显示，**Get metrics ** 块会引发错误。

## 已配置的数据块
<a name="get-metrics-configured"></a>

下图显示了该数据块已配置好的样子。它有两个分支：**成功**和**错误**。

![已配置的 “获取指标” 区块。](https://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/get-metrics-configured.png)


## 场景
<a name="get-metrics-scenarios"></a>

有关使用此数据块的场景，请参阅以下主题：
+ [如何在 “连接客户” 中引用联系人属性](how-to-reference-attributes.md)