# KPI

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

<figure><img src="/files/Egvmzph8OnHRmR5Gv2zQ" 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の例](/platform/ja/user-guide/live-dashboards/live-dashboards-nql-examples.md#livedashboardsnqlexamples-kpiwidget)ドキュメントを参照してください。
{% endhint %}

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

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

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

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

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

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

     <figure><img src="/files/9W2OZhxYoqKxKIKsTdyZ" alt="1 Threshold example"><figcaption><p>1つのしきい値の例</p></figcaption></figure>

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

     <figure><img src="/files/ZirrsJkruIOfCawi85Jp" 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%のしきい値を表します。 |
| 期間      | しきい値は秒数として解釈されます。                          |
| バイト     | しきい値はバイト数として解釈されます。                        |

***

関連トピック

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/kpi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.