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

# [新規] カスタムメトリクス
<a name="custom-metrics-topic"></a>

## 概要
<a name="custom-metrics-overview"></a>

Connect インスタンスで Ultimate AI が有効になっている場合は、メトリクスプリミティブの高度なフィルターと関数を使用してカスタムメトリクスを作成および管理し、ダッシュボードで使用できるようにすることができます。

**Topics**

## カスタムメトリクスを管理する
<a name="manage-custom-metrics"></a>

ダッシュボードとレポートには、インスタンス内のすべてのカスタムメトリクスを一覧表示する「カスタムメトリクス」がダッシュボードタブに表示されます。カスタムダッシュボードを介して作成されたカスタムサービスレベルのメトリクスが一覧表示され、ここで管理することもできます。

検索テキストボックスに を入力して、メトリクス名または説明に対して文字マッチングクイック検索を実行できます。

メトリクスを選択して、編集、削除、またはクローンを作成できます。リストページのメトリクス名をクリックすると、カスタムメトリクスのフルビューが表示されます。

![\[ダッシュボードとレポートの検索機能を備えたカスタムメトリクステーブル。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/dashboard-custom-metric-table-with-search.png)


## カスタムメトリクスの作成、編集
<a name="create-or-edit-custom-metrics"></a>

カスタムメトリクスを作成または編集するには、「カスタムメトリクス」セクションの「ダッシュボードとレポート」ページに移動します。「メトリクスの作成」ボタンをクリックしてメトリクスを作成するか、既存のメトリクスを選択して「編集」ボタンをクリックします。

カスタムメトリクスを作成するときは、メトリクスがサービスレベル設定用か、 メトリクスビルダーを使用して高度なメトリクス用かを選択する必要があります。
+ **サービスレベル設定** - 除外基準を設定し、サービスレベル計算の応答時間、中止時間のしきい値を定義します。
+ **Metric Builder** - 数学演算と関数を使用して、メトリクスプリミティブを使用して高度なカスタムメトリクスを作成します。詳細については[、カスタムメトリクスプリミティブ](https://docs.aws.amazon.com/connect/latest/adminguide/metric-primitive-definitions.html)を参照してください。

### サービスレベル設定
<a name="custom-metrics-service-level-config"></a>
+ **[メトリクス名]**:- 一意の名前を入力します (最大 128 文字)
+ **[説明 (オプション)]**: メトリクスの目的に関する詳細を入力します (最大 500 文字)
+ **[目標時間]**: サービスレベルのしきい値を指定します。
  + **[長さ]**: 1 秒から 7 日までの値を入力します
  + **[単位]**: 秒、分、時間、または日を選択する
+ **[除外されたコンタクトの結果]**: 分母から除外するコンタクトのタイプを選択します。
  + **[転送済みのコンタクト]**
  + **[コールバックが発生したコンタクト]**
  + **[X で中止されたコンタクト (秒/分/時/日)]**
+ これらの設定を行うと、サービスレベル計算プレビューが自動的に更新されます。プレビューには以下が表示されます。
  + 計算式。
  + メトリクスが測定する内容に関するわかりやすい説明。
  + 指定したコンタクトタイプを除く、目標時間内に応答したコンタクトの割合。

![\[カスタムサービスレベルメトリクスの設定オプションを表示するサービスレベル設定エディタ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/dashboard-service-level-editor.png)


### Metrics Builder
<a name="metrics-builder"></a>

Metrics Builder は、メトリクスプリミティブと数学演算子を使用して高度なカスタムメトリクスを定義できるインタラクティブなエディタです。プリミティブと演算子の完全なリスト、および高度なカスタムメトリクスの例については、[リンク](https://docs.aws.amazon.com/connect/latest/adminguide/metric-primitive-definitions.html)を参照してください。

**Metric Builder を使用してカスタムメトリクスを作成する手順:**

1. メインダッシュボードページの「メトリクスの作成」ボタンをクリックします。

1. 「カスタムメトリクスの作成」ページで、「メトリクスビルダー」オプションを選択します。

1. カスタムメトリクスのコンポーネントを定義することから始めます。

1. たとえば、チャットのチャネルサブタイプである SMS である、処理された問い合わせの合計の割合を計算するレートメトリクスを作成します。

   1. 「対応したコンタクト」に「M1」または任意の変数名を指定し、オプションのフィルターを追加します。チャネル =「チャット」とサブタイプ =「SMS」です。

   1. 次に、別のメトリクスプリミティブに「M2」を指定します。例えば、フィルターのない「対応したコンタクト」などです。

1. 定義で「100 \$1 SUM(M1) / SUM(M2)」を指定します。これは、チャット SMS チャネルで処理されたすべての問い合わせと、処理されたすべての問い合わせの合計を定義するレートメトリクスです。

1. 表示形式を「パーセント」として選択します。

1. オプションのフィールド陽性トレンドインジケータに適切な値を選択します。

1. メトリクスに一意の名前を指定します。

1. メトリクスに適切な説明を追加します。

1. フォームにエラーがあるかどうかを確認します。エラーがなければ、ページの下部にある「保存」ボタンが自動的に有効になります。

1. ページの下部にある「保存」をクリックして、カスタムメトリクスを作成します。

1. このカスタムメトリクスがウィジェットに追加されると、適切なグループ化がメトリクスに適用されます。

**コンポーネント**

コンポーネントは、定義エディタを介して入力されるメトリクス式の変数として参照できるメトリクスプリミティブまたはベースメトリクス式を表します。
+ 最大 5 つのメトリクスコンポーネントを追加できます。
+ コンポーネント識別子
  + アンダースコアまたは文字で始まり、その後に文字、数字、アンダースコアのみが続きます。
  + 追加されたコンポーネント間で一意である必要があります。
+ メトリクス
  + それぞれのコンポーネントにアタッチするメトリクスプリミティブ。
  + リンク[https://docs.aws.amazon.com/connect/latest/adminguide/metric-primitive-definitions.html](https://docs.aws.amazon.com/connect/latest/adminguide/metric-primitive-definitions.html)を参照して、さまざまなコンポーネント間でどのメトリクスプリミティブを一緒に使用できるかを確認してください。
+ フィルターとしきい値
  + 選択したメトリクスにフィルターとしきい値を適用します。
  + 既存のフィルターとしきい値は、新しいメトリクスを選択すると削除されます。
  + 選択したメトリクスに最大 5 つのフィルターを適用できます。
  + 特定のフィルターに対して最大 10 個の値を選択できます。
  + サポートされているフィルター値については、[リンク](https://docs.aws.amazon.com/connect/latest/adminguide/metric-primitive-definitions.html#supported-metric-filters)を参照してください。
  + オプションです。

**注記**  
`Current Contact` カテゴリのメトリクスプリミティブを利用するカスタムメトリクスは、最大 1 つのコンポーネントのみをサポートできます。

**定義:**

コンポーネント識別子、使用可能な数学演算子、関数を使用して式を定義します。式が評価され、カスタムメトリクス値が計算されます。
+ サポートされている数学演算子、関数、サンプル式については、[リンク](https://docs.aws.amazon.com/connect/latest/adminguide/metric-primitive-definitions.html)を参照してください。
+ 定義セクションでは、ユーザーは少なくとも 1 つのコンポーネントを追加する必要があります。
+ 式では最大 1024 文字を使用できます。

**注記**  
このセクションは無効になっており、`Current Contact`メトリクスプリミティブを使用してカスタムメトリクスを構築する場合は使用できません。

**Example**  
**表示形式:**  
ダッシュボードの計算されたカスタムメトリクス値の表示形式を指定します。  
+ パーセント - 計算されたカスタムメトリクス値表示の最後に追加された「%」
+ 整数 - 計算されたカスタムメトリクスの整数値。計算されたメトリクスが「3.141592」の場合、値は「3.00」になります。
+ Double - 計算されたカスタムメトリクスの 10 進値。計算メトリクスが「3.141592」の場合、小数点以下第 3 位を四捨五入すると、表示される値は「3.142」になります。
+ 秒 - 計算されたカスタムメトリクスの「HH:MM:SS」形式の値。
**ポジティブトレンドインジケータ:**  
+ 正 - 変更が緑色の矢印で表示されます
+ 負 - 変更が赤い矢印で表示されます
+ 中立 - 変更はインジケータなしで表示されます。
+ オプションです。
**メトリクス名:**  
+ 最大 128 文字
+ 一意である必要があります
**説明:**  
+ 最大 500 文字
+ オプションです。
エディタを使用する場合の一般的なコールアウト  
+ メトリクスビルダーにアクセスするには、Connect インスタンスで Ultimate AI が有効になっている必要があります。
+ メトリクスビルダーを使用して作成されたメトリクスは、Ultimate AI が無効になると編集できません。

![\[高度なカスタムメトリクスを作成するためのコンポーネント、定義、および設定オプションを示す Metric Builder エディタ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/dashboard-metric-builder-editor.png)


## カスタムメトリクスの表示
<a name="view-custom-metric"></a>

カスタムメトリクスを表示するには、ダッシュボードとレポートに移動し、インスタンス内のすべてのカスタムメトリクスを一覧表示するダッシュボードタブの「カスタムメトリクス」セクションでカスタムメトリクスの名前をクリックします。カスタムメトリクスを表示すると、次の情報が表示されます。

**カスタムメトリクスの詳細:**
+ メトリクス名: カスタムメトリクスに割り当てた名前
+ ステータス: メトリクスが「公開済み」で使用可能かどうかを示します
+ 説明: メトリクスの目的の簡単な説明
+ 作成方法: メトリクスの作成方法を示します (サービスレベルまたは Metric Builder)
+ 作成日: メトリクスを作成した日付、時刻、ユーザー
+ 変更: メトリクスを最後に変更した日付、時刻、ユーザー
+ ARN: メトリクスの Amazon リソースネームの一意の識別子。GMDv2 API のクエリに使用できます。

**コンポーネント:**
+ コンポーネント識別子: 各コンポーネントのリファレンス ID (M1, M2 など)
+ メトリクス: 計算に使用される基本メトリクス (処理された問い合わせ、キューに入れられた問い合わせなど)
+ フィルターとしきい値: メトリクスに適用される条件 (キュー時間 (ms) <= 12000 など)
+ 定義: カスタムメトリクスの計算に使用される数式 (例: 100 \$1 SUM(M1) / SUM(M2))

**表示設定:**
+ 表示形式: メトリクス値の表示方法 (パーセントなど)
+ 肯定的な傾向インジケータ: 肯定的な傾向がどのように示されているか (中立など)

ページの上部にあるアクションボタンを使用して、カスタムメトリクスを管理することもできます。
+ 削除: カスタムメトリクスを削除する
+ クローン: カスタムメトリクスのコピーを作成する
+ 編集: カスタムメトリクスの設定を変更する

## カスタムメトリクスのクローンを作成する
<a name="clone-custom-metric"></a>

カスタムメトリクスのクローンを作成すると、既存のカスタムメトリクス計算をコピーし、変更を加えて新しいカスタムメトリクスとして保存できます。クローンは、インスタンス内のすべてのカスタムメトリクスを一覧表示する Dashboards タブの「カスタムメトリクス」セクションでカスタムメトリクスを選択し、クローンボタンをクリックすることで、ダッシュボードとレポートで実行できます。また、カスタムメトリクスビューページに移動し、クローンボタンをクリックして実行することもできます。

## カスタムメトリクスの削除
<a name="delete-custom-metric"></a>

カスタムメトリクスは、カスタムメトリクスリストまたはメトリクスビューページから削除できます。カスタムメトリクスを削除すると、システムは誤って削除されないように確認する必要があります。

**カスタムメトリクスを削除するには:**

1. **ダッシュボードとレポートに移動し、ダッシュボードタブの**「カスタムメトリクス」セクションで削除するカスタムメトリクスを見つけます。

1. 削除するメトリクス**の削除**ボタンをクリックします (またはメトリクスを開き、ビューページ****から削除をクリックします）。

1. 確認ダイアログが表示され、誤って削除されないように「確認」と入力する必要があります。

1. 削除をクリックしてメトリクスを完全に削除するか、キャンセルをクリックして削除プロセスを中止します。

**重要**  
重要な考慮事項:  
このアクションは永続的であり、元に戻すことはできません。削除されると、メトリクスとそれに関連するすべてのデータがインスタンスから削除されます。
ダッシュボードへの影響: 削除されたメトリクスがダッシュボードで使用された場合、それらのウィジェットにはメトリクスが使用できなくなったことを示すエラーメッセージが表示されます。

## ダッシュボードウィジェットにカスタムメトリクスを追加する
<a name="add-custom-metric-to-dashboard"></a>

作成したカスタムメトリクスをダッシュボードウィジェットに追加して、データを視覚化およびモニタリングできます。ウィジェット編集メニューからカスタムメトリクスを追加できます。任意の[ダッシュボードウィジェット](https://docs.aws.amazon.com/connect/latest/adminguide/dashboard-customize-widgets.html#dashboard-changing-metrics)からアクション****アイコンを選択し、**編集**を選択します。

**ダッシュボードウィジェットにカスタムメトリクスを追加するには:**

1. [ダッシュボードウィジェット](https://docs.aws.amazon.com/connect/latest/adminguide/dashboard-customize-widgets.html#dashboard-changing-metrics)から **[アクション]** アイコンを選択し、**[編集]** を選択します。

1. 編集パネルには、利用可能なメトリクスのリストがカテゴリ別に整理されています。

   1. 標準メトリクス (プロアクティブインテントエンゲージメント率、リファレンス数、レスポンス完了率など)

   1. インスタンスで使用可能な**カスタムメトリクス**のリストを示すカスタムメトリクスセクション。

   1. カスタムメトリクスを追加するには:

      1. 上部の検索フィールドを使用して、特定のメトリクスを名前で検索する

      1. **カスタムメトリクス**セクションをスクロールして、使用可能なオプションを参照する

      1. リストから追加するカスタムメトリクスをクリックします。

1. **メトリクスの追加**をクリックして、ウィジェットに選択内容を含めます。
**注記**  
ウィジェットには、追加できるメトリクスの数に制限があります。インターフェイスには、追加できるメトリクスの数が表示されます (例：「最大 1 つまで追加できます」）。

1. **保存**をクリックしてウィジェットに変更を適用するか、**キャンセル**をクリックして変更を破棄します。