翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Connect のフローブロック: メトリクスの取得
<a name="get-queue-metrics"></a>

デフォルトでは、このブロックは現在のキューのキューメトリクスを返します。オプションで、別のキュー/チャネルの組み合わせのメトリクスを返すか、キュー内の問い合わせの位置などの問い合わせレベルのメトリクスを返すかを選択できます。メトリクスは、JSONPath または問い合わせ属性の確認ブロックを介して参照できる属性として返されます。

## 説明
<a name="get-metrics-description"></a>
+ 5～10 秒の遅延でほぼリアルタイムでキューメトリクスを取得して、より詳細なルーティングを決定します。
+ キュー内の問い合わせや稼動可能なエージェントの数など、キューまたはエージェントのステータスに基づいてコンタクトをルーティングできます。
+  キューメトリクスは、デフォルトですべてのチャネルにわたり集約され、属性として返されます。
+  デフォルトでは、現在のキューが使用されます。
+ エージェントベースのメトリクス (オンラインのエージェント、稼働可能なエージェント、配置されたエージェントなど) については、エージェントがいない場合にはメトリクスは返されません。
+ キューの推定待機時間の場合、メトリクスは 1 つのチャネルが指定されている場合にのみ返されます。
+ 取得できるメトリクスは次のとおりです。
  + キュー名 
  + キュー 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 | はい | 
| タスク | はい | 
| E メール | はい | 

## フロータイプ
<a name="get-metrics-types"></a>

このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー

## プロパティ
<a name="get-metrics-properties"></a>

次の図は、**メトリクスの取得**ブロックの**プロパティ**ページを示しています。**[音声]** チャネルのメトリクスを取得するように設定されています。

![メトリクスの取得ブロックのプロパティページ。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-properties1.png)


メトリクスをチャネル別、キュー別、エージェント別に取得できます。
+ チャネルを指定しないと、すべてのチャネルのメトリクスが返されます。
+ キューを指定しないと、現在のキューのメトリクスが返されます。
+ 動的属性は、1 つのチャネルのメトリクスのみを返すことができます。

例えば、次の画像は、**[チャット]** チャネルと **[BasicQueue]** について設定された **[プロパティ]** ページを示しています。これらの設定を選択した場合、**[キューメトリクスの取得]** は、チャットコンタクトのみを含むようにフィルターされた BasicQueue のメトリクスを返します。

![[プロパティ] ページの [オプションパラメータ] セクション。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-properties3.png)


## 設定のヒント
<a name="get-metrics-tips"></a>

### [問い合わせ属性の設定] ブロックでのチャネルの指定
<a name="get-metrics-tips1"></a>

動的属性は、1 つのチャネルのメトリクスのみを返すことができます。

**メトリクスの取得**ブロックで動的属性を使用する前に、[コンタクト属性の設定](set-contact-attributes.md)ブロックで属性を設定し、どのチャネルを指定する必要があります。

次の図に示すように、テキストを使用してチャネルを動的に設定する場合は、属性値として「**Voice**」または「**Chat**」と入力します (この値は大文字と小文字が区別されません)。

![[コンタクト属性の設定] ブロックの [プロパティ] ページ、[値] が [チャット] に設定されています。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-properties2.png)


### メトリクスの取得ブロックの後に問い合わせ属性の確認ブロックを使用する
<a name="get-metrics-tips2"></a>

**Get metrics **ブロックの後に、返されたメトリクスに基づいて分岐する[コンタクト属性を確認する](check-contact-attributes.md)ブロックを追加します。以下のステップを使用します。

1. **メトリクスを取得**したら、**問い合わせ属性の確認**ブロックを追加します。

1. [**問い合わせ属性を確認する**] ブロックで、[**確認する属性**] を [**キューメトリクス**] に設定します。

1. Value ****ドロップダウンボックスには、Get metrics ブロックでチェックできる**メトリクス**のリストが表示されます。ルーティングの決定に使用するメトリクスを選択します。  
![[確認する属性] セクション、使用可能なメトリクスのドロップダウンリスト。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-block-returned-metrics.png)

### Get metrics ブロックがエラーをスローする理由
<a name="get-metrics-tips3"></a>

**メトリクスの取得**ブロックは、次のシナリオでエラーをスローします。

1. フローにこのブロックを追加する。

1. リアルタイムのメトリクスレポートで、アクティビティが行われていないため、空のメトリクスが返される。

1. 表示する**メトリクスがないため、メトリクスの取得**ブロックはエラーをスローします。

## 設定されているブロック
<a name="get-metrics-configured"></a>

次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** の 2 つのブランチがあります。

![設定されたメトリクスの取得ブロック。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-configured.png)


## シナリオ
<a name="get-metrics-scenarios"></a>

このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect で問い合わせ属性を参照する方法](how-to-reference-attributes.md)