29 トップアイテム

概要

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

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

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

設定

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

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

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

条件には2つの計算タイプがあります:
And/Or - すべての条件を満たす必要があり、同じタグ名の条件はOr条件でグループ化されます;
Or - いずれか1つの条件を満たせば十分です。
レイアウト レイアウトオプションを選択します:
水平 - ホスト名が左側に表示されます;
垂直 - ホスト名が上部に表示されます。
障害の表示 障害のステータス（すべて、抑制されていない、なし）に基づいて表示する障害をフィルタリングします。
障害は、アイテム値の色で示され、アイテム列の表示設定を上書きします。色は障害の深刻度に基づいており、管理 > 一般 > トリガー表示オプションでカスタマイズできます。障害の深刻度は、障害の更新時に変更できます。
アイテム 表示するアイテムパターンまたは特定のアイテムを追加します（列の設定を参照）。
詳細設定
ホストの並び順 ホスト列/行の並び順オプションを選択します。
並び替え基準 ホストの並び順:
ホスト名 - ホスト名で並び替え;
アイテム値 - 選択したアイテムの値で並び替え。
順序 最も高い値または最も低い値のいずれかを表示するかを選択します:
TopN - 上位N件;
BottomN - 下位N件。
Nの値は制限フィールドで選択します。
制限 表示可能なホストの制限値を入力します（範囲1-1000、デフォルト10）。
この値が順序フィールドのNの値になります。
アイテムの並び順 アイテム列/行の並び順オプションを選択します。
並び替え基準 アイテムの並び順:
アイテム値 - アイテム値で並び替え;
アイテム名 - アイテム名で並び替え;
ホスト - 選択したホストパターンで並び替え。
順序 最も高い値または最も低い値のいずれかを表示するかを選択します:
TopN - 上位N件;
BottomN - 下位N件。
Nの値は制限フィールドで選択します。
制限 表示可能なアイテムの制限値を入力します（範囲1-1000、デフォルト10）。
この値が順序フィールドのNの値になります。
列ヘッダーの表示 列ヘッダーの表示オプションを選択します:
オフ - 列ヘッダーを表示しない;
水平 - ヘッダーにテキストを水平に表示;
垂直 - ヘッダーにテキストを垂直に表示。

カラムの設定

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

共通のカラムパラメータ:
アイテムパターン ワイルドカード文字を使用して、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 一致した場合に背景色/塗りつぶし色を変更する正規表現を指定します。