# KPI

KPIウィジェットは単一の数値を表示します。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-214bfd85f62a435950830e195acf63cf7a5c8ba4%2Fdash-1662385654.png?alt=media" alt="Examples of the KPI widget"><figcaption></figcaption></figure>

## データの形状 <a href="#kpi-datashape" id="kpi-datashape"></a>

`<kpi>`

## NQL構造 <a href="#kpi-nqlstructure" id="kpi-nqlstructure"></a>

{% hint style="info" %}
KPIウィジェットのクエリ例については、[Live Dashboards NQLの例](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards-nql-examples#livedashboardsnqlexamples-kpiwidget)ドキュメントを参照してください。
{% endhint %}

集計 - 最も一般的に使用される

```
...
要約 <kpi> = <sum() | count() | avg() | max() | min()>
```

## KPIウィジェットに特化した視覚化フィールドの設定 <a href="#linechart-linechartspecificsettings" id="linechart-linechartspecificsettings"></a>

{% hint style="info" %}
このウィジェットに特化していない残りの設定フィールドを埋める方法を学ぶために、[Live Dashboardsの管理](https://docs.nexthink.com/platform/ja/user-guide/managing-live-dashboards#filling-in-widget-visualization-fields)ドキュメントを参照してください。
{% endhint %}

[ウィジェットの追加](https://docs.nexthink.com/platform/ja/user-guide/managing-live-dashboards#adding-widgets)/[ウィジェットの編集](https://docs.nexthink.com/platform/ja/user-guide/managing-live-dashboards#managing-widgets)ポップアップで**KPI**オプションを**チャートタイプ**のドロップダウンから選択した後:

1. KPIのメトリックの表示名を作成するために\*\*ラベル（オプション）\*\*フィールドを使用します。
   * テキストには特殊文字を含めることができます。 **ラベル**フィールドには50文字の制限があります。
2. メトリックの解釈方法、計算方法、またはメトリックの微妙な点を説明するために、\*\*ウィジェットの説明（オプション）\*\*を入力してください。
   * ウィジェットの説明は、ダッシュボードのKPIウィジェットの隣にある情報アイコンにカーソルを合わせることで表示されます。
3. 該当する場合は、**パーセンテージとして表示**オプションを選択してください。 システムが数値を100倍し、パーセント記号を追加します。
4. KPIウィジェットに素早く視覚的に問題を識別するために、カラフルなアイコンを追加する**評価**のしきい値を設定します。 選択肢:
   * **1つのしきい値**: KPIは評価を**良好**または**悪い**として表示します。

     <figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-f8f002fd808bc9b269d178a2a1138b48a043028b%2Fdash-1666103696.png?alt=media" alt="1 Threshold example"><figcaption><p>1つのしきい値の例</p></figcaption></figure>

     * システムは>=オペレーターを使用してしきい値を評価します。 上記の例は次のように評価されます:
       * **良好**: メトリックが< 0.2の場合
       * **悪い**: メトリックが>= 0.2の場合
     * **反転**を選択して良好と悪いの条件を反転します。 反転した場合、上記の例は次のように評価されます:
       * **悪い**: メトリックが< 0.2の場合
       * **良好**: メトリックが>= 0.2の場合
   * **2つのしきい値**: KPIは評価を**良好**、**普通**または**悪い**の3つの状態で表示します。

     <figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-e25176bc1892f76857af661969d5e7c929ac1828%2Fdash-1666103939.png?alt=media" alt="2 thresholds example"><figcaption><p>2つのしきい値の例</p></figcaption></figure>

     * システムは>=オペレーターを使用してしきい値を評価します。 上記の例は次のように評価されます:
       * **良好**: メトリックが< 0.1の場合
       * **普通**: メトリックが>= 0.1 かつメトリックが< 0.4の場合
       * **悪い**: メトリックが>= 0.4の場合
     * **反転**を選択して良好と悪いの条件を反転します。 反転した場合、上記の例は次のように評価されます:
       * **悪い**: メトリックが< 0.1の場合
       * **普通**: メトリックが>= 0.1 かつメトリックが< 0.4の場合
       * **良好**: メトリックが>= 0.4の場合

\
しきい値には、小数または整数、正または負の数字などの数値のみを入力してください。 タイプ文字が入力された値の場合、しきい値の単位として次の表を参照してください:

| タイプ文字   | しきい値                                       |
| ------- | ------------------------------------------ |
| パーセンテージ | しきい値を小数として入力してください。 例えば、0.9は90%のしきい値を表します。 |
| 期間      | しきい値は秒数として解釈されます。                          |
| バイト     | しきい値はバイト数として解釈されます。                        |

***

関連トピック

* [折れ線グラフ](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/line-chart)
* [棒グラフ](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/bar-chart)
* [単一メトリックゲージチャート](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/single-metric-gauge-chart)
* [複数メトリックゲージチャート](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/multi-metric-gauge-chart)
* [テーブル](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/table)
* [見出し](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/heading)
* [フィルタウィジェット](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/filter-widget)
* [期間選択](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/timeframe-picker)