> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/ja/references/references-classic/search-and-information-display-classic/types-of-widgets-classic.md).
# ウィジェットの種類（クラシック）
### 概要
この記事では、メトリクスの計算に関連するデータを視覚的に表示するための様々なタイプのウィジェットをダッシュボードに使用する方法について探ります。 これらのウィジェットは、Basicモジュール内のダッシュボードで使用でき、メトリクスの視覚化を個別に選択できます。
これらに類似したウィジェットは、Service Monitoringモジュール内のダッシュボードでも見つけることができますが、種類とレイアウトは固定されています。 Software Meteringモジュールでは、ダッシュボードに表示されるウィジェットは1種類しかなく、BasicやService Monitoringモジュールのダッシュボードに表示されるウィジェットとは完全に異なります。
### KPI
*KPI* (Key Performance Indicator) ウィジェットは、主に表現されたメトリクスまたはメトリクスの内部価値を反映する単一の数値で構成されます。
KPIウィジェットの数値は、絶対値または相対値（パーセンテージ）です。 パーセンテージは、関連するメトリクスの定義に比率計算が含まれている場合にのみ存在します。 比率計算は、メトリクス自体の値と、追加で提供されたInvestigationによって返される値の比較として定義されます。 この追加のInvestigationは、通常、メトリクスの値を計算するInvestigationより制約の少ないバージョンです。
#### 値の変動
KPIウィジェットは主な数値に加えて、メトリクスの値の前回の値に対する変動を示す二次的な数値も含めることができます。 この場合、「前回」の意味はダッシュボードで選択した時間枠に依存します。 さらに関連するメトリクスの定義に指定された場合、KPIウィジェットはメトリクスの価値の増加または減少が良いか悪いかを示します。 これは変動数値の隣にある緑（良い）または赤（悪い）の矢印で視覚的に表示されます。 メトリクスの価値の変動が必ずしも良いとも悪いとも判断しない場合、矢印は青になります。
#### しきい値越えの表示
メトリクスの定義には、通常、正常、心配（オプション）、悪いとみなされる値の範囲を制限するしきい値が含まれることがあります。 KPIウィジェットは、主要なKPI数値の前に色付きのドットとしてそのような情報を表示するように構成できます。 ドットの色は、値が正常範囲（緑）、心配範囲（黄色）、または悪い範囲（赤）のいずれかにあるかを反映します。 ドットは、2つの設定しきい値が心配範囲を定義するときのみ黄色になります。
#### KPIウィジェットの例
以下の例は、CPUの問題を抱えたデバイスの数をカウントするメトリクスに関連するKPIウィジェットを示しています。 関連するメトリクスの定義には比率（CPUの問題を抱えたデバイス数を総デバイス数と比較したもの）が含まれており、これがウィジェットのメインの数値です。 メトリクスの値が増加することは明らかに悪いことであり、それはCPUの問題を持つデバイスが増えていることを意味するため、増加は赤い矢印で表示されます。
2つのしきい値が定義されています：
* 総デバイス数の最大10％がCPUの問題を抱えている場合、その状況は正常と見なされます。
* 総デバイス数の10％から20％の間にCPU問題を抱えるデバイスが存在する場合、その状況は心配されると見なされます。
* 総デバイス数の20％以上がCPUの問題を抱えている場合、その状況は悪いと見なされます。
単一のKPIウィジェットは、複数のメトリクスの値を表示できます。 各メトリクスの視覚化は、KPIウィジェット内で縦または横に配置できます。
KPIウィジェットは、カウントと数量のメトリクスに対応しています。 トップメトリクスは単一の数値として表示することはできません。
### テーブル
\_テーブル\_ウィジェットは、メトリクスの値（またはメトリクス群）をグリッドに配置します。 テーブルウィジェットをダッシュボードに追加して、トップメトリクスまたはカウントおよび数量のメトリクスのグループを表示します。
#### トップメトリクスの表示
テーブルウィジェットにトップメトリクスを表示するとき、テーブルは上位オブジェクトのリストを行として表示し、列はトップメトリクスの構成で選択された表示フィールドとなります。 テーブルウィジェットの設定で表示されるフィールドの数を制限できます。 メトリクスの定義に必要でないものだけを非表示にできます。
単一のテーブルウィジェットは、最大で1つのトップメトリクスを表示し、ウィジェット全体を占有します。 したがって、1つのテーブルウィジェット内でトップメトリクスと他のトップメトリクスや別の種類のメトリクスを組み合わせることはできません。
#### カウントおよび数量のメトリクス
テーブルウィジェットでのカウントおよび数量のメトリクスの表示は非常に柔軟です。 これらのタイプのメトリクスを最大50個まで単一のテーブルウィジェットに追加できます。
各メトリクスについて、表示する項目を選択できます：
* メトリクス自体の値
* メトリクスの定義に指定された計算された比率値
メトリクスがしきい値を定義している場合、表示する項目を選択できます：
* ステータス（緑、黄色、または赤のドット）と値
* ステータスのみ
* 値のみ
また、メトリクスの前回の値に対する変動を表示するオプションを選択できます。 これらの選択肢は、KPIウィジェットで見られるものと非常に似ています。
値は次の基準に基づいてテーブルの行や列に整理できます：
* 階層
* メトリクス名
* 追加したウィジェットのグループ化基準、メトリクスの定義で指定された場合
選択した特定のメトリクスに応じて、すべての組み合わせが許可されるわけではありませんので注意してください。
### ラインチャート
\_ラインチャート\_は、時間の経過に伴うメトリクス（またはメトリクス群）の値の歴史的な変化をグラフィカルに表示します。 ラインチャートは、メトリクスの歴史上の重要なイベントを視覚化し、異なるメトリクスの値を時間と共に比較し、トレンドを発見するのを可能にします。
1つのラインチャートには最大5つのメトリクスを追加できます。 同じラインチャートのすべてのメトリクスは同じ単位で表現されている必要があり、ここでの「単位」は広い意味で理解される必要があります。 例えば、デバイスやバイナリのような異なるオブジェクトのカウントメトリクスを同じラインチャートに追加できます。 これは単位が互換性があるため可能で、すべてのオブジェクト数を表しています。 カウントメトリクスとうまくイベントの数を測定する数量メトリクスを混ぜることさえ可能です。 しかし、デバイスをカウントするメトリクスとデバイスの平均起動時間を測定するメトリクスを混ぜることはできません。なぜなら、デバイスの数は時間単位と互換性がないからです。
#### ラインがしきい値を超えるケース
チャートの各ラインは、メトリクスの定義にコンピュート比率が指定されている場合、メトリクスの値または計算された比率を表すように設定できます。
メトリクスで定義されたしきい値は、オプションで水平線としてラインチャートに表示できます。
* 1つの定義されたしきい値は単一の赤いラインとして表示されます。
* 2つの定義されたしきい値は、しきい値で指定されたレベルで黄色と赤の水平線として表示されます。
* しきい値を超えるポイントは対応する色で表示されます。
しきい値を表示することを選択した場合でも、メトリクスのすべての値が指定された限界を超えていない場合、水平線はグラフに表示されないことがあります。 しきい値の表示は、グラフに1つのメトリクスを表示する場合にのみ利用可能であり、複数のメトリクスに対して同じラインチャートでしきい値が表示されると混乱を招く可能性があるためです。
#### 縦軸のスケール設定
ラインチャートのスケールを次のように設定します：
* **自動**: Portalが縦軸の範囲を代表するメトリクスの値に適応させます
* **固定**: ラインチャートで表せる最小および最大値を指定します。 これは、表されているメトリクスの値の範囲を事前に知っている場合（例えば、スコアに基づくメトリクス）に便利です。 さらに、固定スケールはダッシュボード内のラインチャートの比較を有利にします。 指定:
* **from**: ラインチャートの縦軸の最小値
* **to**: ラインチャートの縦軸の最大値
#### 横軸の期間
ラインチャートは、ダッシュボードで選択された時間枠を超えて過去まで広がります。 ダッシュボードで期間を選択すると（日、週、月、四半期）、ラインチャートの各ポイントはその期間に集計されたメトリクスの値を表します。 ラインの最後のポイントはダッシュボードで選択された日付に対応しており、左の値は過去の値です。 ラインチャートが過去にどれだけ遡るかは、選択された時間枠と利用可能な履歴データの量に依存します。 最小スパンは、Portalがますます多くのデータを計算するにつれて最大スパンに徐々に拡大します：
| 時間枠 | ラインチャート最小スパン | ラインチャート最大スパン |
| --- | ------------ | ------------ |
| 日 | 30日（1か月） | 60日（2か月） |
| 週 | 12週（3か月） | 52週（1年） |
| 月 | 12ヶ月（1年） | 24ヶ月（2年） |
| 四半期 | 8四半期（2年） | 16四半期（4年） |
ラインチャートウィジェットは、カウントおよび数量のメトリクスに対応していますが、トップメトリクスの表示には適していません。
### バーチャート
\_バーチャート\_は、カウントまたは数量のメトリクスの値を水平バーでグラフィカルに表示し、結果を一目で比較できるようにします。
#### チャート内のバーの配置
バーチャートで表示されるメトリクスによって、測定された値を表すバーの配置が異なる場合があります：
* バーが1つのメトリクスを表示する場合、以下に従ってバーを配置します：
* カウントまたは数量メトリクスの定義で選択されたグループ化基準。
* 階層。 メトリクスの作成時に2つのグループ化基準（または一切選ばない）を選択した場合、これがバーを配置するために使用できる唯一の方法です。
* バーが複数のメトリクスを表示する場合、バーは必ずメトリクスによって配置されます。
バーの結果を次の基準で並べ替えます：
* 値
* メトリクスの名前
* 階層内のノード
* *group by* オプションのラベル
重要な値を最初に見るためには、バーチャートを値の降順で並べ替えることが最善です。
バーにカウントメトリクスがある場合、その値または次の2つの比率のいずれかを表示するオプションを選択します：
**メトリクスで定義された比率**
メトリクスで定義された比率は、メトリクスと比率定義の条件によって決定された任意のグループを比較するため、各バーの値は独立して計算され、ウィジェット内のすべてのバーの合計が一般的に100％にはなりません。 このオプションは、カウントメトリクスが実際に比率を定義している場合にのみ有効です。
**全体の比率**
バーチャートでは、メトリクスで定義された比率よりも、ウィジェット内で観察されたオブジェクトの総数に対する各グループ化オプションの分布を表示する方が望ましいことが多いです。 ウィジェット内に全体の比率を表示するバーは合計で100％になり、関連するカウントメトリクスが比率を定義していなくてもこのオプションは有効です。
#### バーがしきい値を超えた場合
しきい値が定義されたメトリクスを表示するバーチャートでは、**Threshold**ボックスをオンにしてしきい値が超えたかどうかを視覚化します。 バーは、説明したように、緑、黄色（二つのしきい値のあるメトリクスの場合）、または赤として表示されます。 メトリクスがしきい値を定義していない場合、または**Threshold**ボックスをチェックしない場合、バーは青で表示されます。 同じバー伝票で複数のメトリクスが表示される場合、それぞれが独立して色付けされます。
#### バー伝票の高さ
バー伝票の高さを設定するには、伝票で見たい**最小バー数**を選択します：
* 表示可能なバーの数が設定された最小値より少ない場合、ウィジェットは空のスペースを空白行で埋めます。 最小を過剰に設定すると、ダッシュボードのスペースが無駄になりますので注意してください。
* 設定された最小値よりも多くのバーが表示可能な場合でも、ダッシュボードにスペースがある限り、超過したバーは直接表示される可能性があります。 そうでない場合、チャートの右下に小さな下向きの矢印が表示されます。
バー伝票の上にカーソルを置くと、小さな矢印がスライダーに変わります。 スライダーを使ってバー伝票のすべての値をスクロールします。 スクロール後にバー伝票を離れると、チャートの上または下、または両方により多くの結果がある場合に小さな矢印が表示されます。
#### バー伝票の水平スケール
バー伝票の幅は、表示するための最大値に充分なスペースを確保するよう自動調整されます。 1つのメトリクスのみがある場合、バー伝票のスケールを最大値に固定することが可能です。 バー伝票の設定で、**自動**または**固定**を選択できます。 後者の場合、チャートが表示する最大値を指定します。 固定された最大値をバーが超えた場合、ウィジェットは新しい最大値に合わせて自動的にリサイズされます。
### タイトルウィジェット
タイトルウィジェットは、複数の他のウィジェットを同じタイトルの下にグループ化することができます。 タイトルウィジェット自体がメトリックを保持するわけではなく、メトリックの結果を表示する他のウィジェットのための傘のような役割を果たします。
タイトルウィジェットは、異なる種類のウィジェットを論理的なセットに整理するのに特に便利で、ダッシュボードのレイアウト設計に柔軟性を提供します。
### 互換性マトリックス
すべての種類のウィジェットがすべてのタイプのメトリックを表示できるわけではありません。 以下の表は、メトリックの種類と、それを表示できるウィジェットとの互換性マトリックスを示しています。
| メトリックタイプ | KPI | テーブル | 折れ線グラフ | 棒グラフ |
| --------- | --- | ---- | ------ | ---- |
| カウントメトリック | OK | OK | 同一単位 | 同一単位 |
| 量メトリック | OK | OK | 同一単位 | 同一単位 |
| トップメトリック | - | 一つのみ | - | - |
同一単位
チャートに複数のメトリックを追加する場合、メトリックは同じ単位でなければなりません。
一つのみ
このウィジェットは最大で一つのメトリックしか受け入れません。
***
関連タスク
* [メトリックの作成](/platform/ja/user-guide/using-finder-classic/monitoring-it-custom-metrics-with-finder-classic/creating-a-metric-with-finder-classic.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.nexthink.com/platform/ja/references/references-classic/search-and-information-display-classic/types-of-widgets-classic.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
