上位アイテム

概要

Top itemsウィジェットは、選択したアイテムのトップ/ボトム値を表示し、そのパフォーマンスの概要を素早く把握できます。

デフォルトでは、ウィジェットは直近24時間の値を表示します。 この期間は、管理 > 一般 > GUI（最大履歴表示期間）で変更できます。

アイテム値をクリックすると、アイテムメニューが開きます。

設定

設定するには、タイプとして Top items を選択します:

すべてのウィジェットに共通のパラメータに加えて、次の固有オプションを設定できます:
ホストグループ ホストグループを選択します。
または、ホストグループのデータソースとして、互換性のあるウィジェットを選択します。
このフィールドはオートコンプリート対応のため、グループ名の入力を開始すると一致するグループのドロップダウン候補が表示されます。
このパラメータは、テンプレートダッシュボードでウィジェットを設定する場合は使用できません。
ホスト ホストを選択します。
または、ホストのデータソースとして、互換性のあるウィジェットまたはダッシュボードを選択します。
このフィールドはオートコンプリート対応のため、ホスト名の入力を開始すると一致するホストのドロップダウン候補が表示されます。
このパラメータは、テンプレートダッシュボードでウィジェットを設定する場合は使用できません。
ホストタグ ウィジェットに表示するホストデータの数を制限するタグを指定します。
特定のタグおよびタグ値を含めることも除外することもできます。複数の条件を設定できます。タグ名の一致は常に大文字と小文字を区別します。

各条件で使用できる演算子は次のとおりです:
Exists - 指定したタグ名を含める;
Equals - 指定したタグ名と値を含める（大文字と小文字を区別）;
Contains - タグ値に入力した文字列を含む指定タグ名を含める（部分一致、大文字と小文字を区別しない）;
Does not exist - 指定したタグ名を除外する;
Does not equal - 指定したタグ名と値を除外する（大文字と小文字を区別）;
Does not contain - タグ値に入力した文字列を含む指定タグ名を除外する（部分一致、大文字と小文字を区別しない）。

条件の計算タイプは2種類あります:
And/Or - すべての条件を満たす必要があります。同じタグ名を持つ条件は Or 条件でグループ化されます;
Or - いずれか1つの条件を満たせば十分です。
レイアウト レイアウトオプションを選択します:
Horizontal - ホスト名を左側に表示します;
Vertical - ホスト名を上部に表示します。
障害を表示 ステータスに基づいて表示する障害をフィルタリングします（all、unsuppressed、none）。
障害は色付きのアイテム値で示され、アイテム列の表示設定より優先されます。色は障害の深刻度に基づきます。深刻度は Administration > General > Trigger displaying options でカスタマイズできます。障害の深刻度は、障害を更新すると変更できます。
アイテム 表示するアイテムパターンまたは特定のアイテムを追加します（列の設定を参照）。
詳細設定
ホストの並び順 ホスト列/行の並び順オプションを選択します。
並び順の基準 ホストの並び順を次の基準で指定します:
Host name - ホスト名で並べ替えます;
Item value - 選択したアイテムの値で並べ替えます。
順序 表示する値を高い順または低い順のどちらにするかを選択します:
TopN - 上位N件の値;
BottomN - 下位N件の値。
N の値は Limit フィールドで指定します。
Limit 表示可能なホスト数の上限を入力します（範囲 1-1000、既定値 10）。
この値が 順序 フィールドの N の値になります。
アイテムの並び順 アイテム列/行の並び順オプションを選択します。
並び順の基準 アイテムの並び順を次の基準で指定します:
Item value - アイテム値で並べ替えます;
Item name - アイテム名で並べ替えます;
Host - 選択したホストパターンで並べ替えます。
順序 表示する値を高い順または低い順のどちらにするかを選択します:
TopN - 上位N件の値;
BottomN - 下位N件の値。
N の値は Limit フィールドで指定します。
Limit 表示可能なアイテム数の上限を入力します（範囲 1-1000、既定値 10）。
この値が 順序 フィールドの N の値になります。
列ヘッダーを表示 列ヘッダーの表示オプションを選択します:
Off - 列ヘッダーを表示しません;
Horizontal - ヘッダー内のテキストを横向きに表示します;
Vertical - ヘッダー内のテキストを縦向きに表示します。

カラムの設定

アイテムカラムを設定するには、アイテムパラメータで追加をクリックします。

共通のカラムパラメータ:
アイテムパターン ワイルドカード文字を使用して、1つまたは複数のアイテムパターンを指定します。
または、アイテムを選択します。
テンプレートダッシュボードでウィジェットを設定する場合、テンプレートで設定されたアイテムのみ選択できます。
アイテムタグ ウィジェットに表示されるアイテムデータの数を制限するタグを指定します。
特定のタグやタグ値を含めたり除外したりできます。複数の条件を設定できます。タグ名の一致は常に大文字と小文字を区別します。

各条件にはいくつかの演算子があります:
存在する - 指定したタグ名を含める;
等しい - 指定したタグ名と値を含める(大文字・小文字を区別);
含む - タグ値が入力した文字列を含むタグ名を含める(部分一致、大文字・小文字を区別しない);
存在しない - 指定したタグ名を除外する;
等しくない - 指定したタグ名と値を除外する(大文字・小文字を区別);
含まない - タグ値が入力した文字列を含むタグ名を除外する(部分一致、大文字・小文字を区別しない)。

条件には2つの計算タイプがあります:
And/Or - すべての条件を満たす必要があり、同じタグ名の条件はOr条件でグループ化されます;
Or - いずれか1つの条件を満たせば十分です。
ベースカラー 表示が「バー」または「インジケーター」に設定されている場合、カラムの背景色または塗りつぶし色を選択します。
ベースカラーはしきい値やハイライトカラーで上書きされる場合があります。
値の表示形式 アイテム値の表示形式: 数値またはテキスト。

選択したオプションによって、利用可能な追加パラメータが決まります。各形式のパラメータリストを参照してください。

数値の値に対する列パラメータ:
Display 値の表示方法を定義します:
As is - 通常のテキストとして表示;
Bar - 単色で塗りつぶされたバーとして表示;
Indicators - 区切られた色付きバーとして表示;
Sparkline - ミニ折れ線グラフとして表示。
Min バー/インジケーター表示の最小値。
Max バー/インジケーター表示の最大値。
Width スライダーを使用するか、0から10の範囲の値を手動で入力して、グラフ線の太さを設定します。
このパラメータはSparkline表示でのみ使用されます。
Fill スライダーを使用するか、0から10の範囲の値を手動で入力して、塗りつぶし色の透明度を設定します。
このパラメータはSparkline表示でのみ使用されます。
Color 線と塗りつぶしの色を選択します。
このパラメータはSparkline表示でのみ使用されます。
時間範囲および履歴データ選択に関連するフィールドの説明については、Advanced configurationを参照してください。
Thresholds 背景色/塗りつぶし色を変更するしきい値を指定します。
リストは保存時に昇順でソートされます。
Sparklineでは、しきい値はアイテムの最新の値にのみ適用されます。
Decimal places 値とともに表示する小数点以下の桁数を指定します。
Advanced configuration
History data 履歴またはトレンドからデータを取得します:
Auto - 自動選択;
History - 履歴データを取得;
Trends - トレンドデータを取得。
このパラメータは数値アイテムの値でのみ使用できます。テキスト値のデータは常に履歴から取得されます。
Aggregation function 選択したTime period内で使用する集計関数を指定します:
min - 最小値を表示;
max - 最大値を表示;
avg - 平均値を表示;
count - 値の件数を表示;
sum - 値の合計を表示;
first - 最初の値を表示;
last - 最後の値を表示。
not usedを選択した場合、最新の値が表示されます（集計なし）。

集計を使用すると、最新の値の代わりに、選択した期間（5分、1時間、1日）の集計値を表示できます。
min、max、avg、sumでは数値データのみ表示できます。countでは、非数値データは数値に変換されます。
Time period 値の集計に使用する時間範囲を指定します。時間範囲のdata sourceを選択します:
Dashboard - ダッシュボードのtime period selectorを使用;
Widget - 互換性のあるウィジェットを使用（Widgetパラメータで設定）;
Custom - FromおよびToパラメータで設定したカスタム時間範囲を使用; 設定されている場合、ウィジェット右上に時計アイコンが表示され、マウスオーバー時に設定時刻が示されます。
ウィジェットのTime period設定に関係なく、互換性のあるウィジェットは引き続き時間範囲のデータソースとして使用できます。
このパラメータは、Aggregation functionが"not used"に設定されている場合は使用できません。
Widget 時間範囲のデータソースとして、互換性のあるウィジェットを入力または選択します。
このパラメータは、Time periodが"Widget"に設定されている場合に使用できます。
From 時間範囲の開始時刻を入力または選択します。
Relative time syntax (now, now/d, now/w-1w など) がサポートされています。
このパラメータは、Time periodが"Custom"に設定されている場合に使用できます。
To 時間範囲の終了時刻を入力または選択します。
Relative time syntax (now, now/d, now/w-1w など) がサポートされています。
このパラメータは、Time periodが"Custom"に設定されている場合に使用できます。
Aggregate columns チェックを入れると、列のアイテムパターンに一致するすべてのアイテムを1つの結合列/行にグループ化します。一致したアイテムの値は、選択したColumn aggregation functionを使用して集計され、Combined column nameの下に表示されます。デフォルト: オフ（未チェック）。このパラメータは、Display value asがNumericの場合にのみ表示されます。
Column aggregation function グループ化されたアイテムパターンの値をどのように結合するかを選択します。使用可能なオプション: min、max、avg、count、sum（デフォルト）。このパラメータは、Aggregate columnsにチェックが入っている場合にのみ表示されます。
Combined column name 集計列の表示名を入力します。このフィールドは、Aggregate columnsにチェックが入っている場合は必須で、結合された値の列ヘッダーになります。

テキストの値に対する列パラメータ:
Highlights 一致した場合に背景色/塗りつぶし色を変更する正規表現を指定します。