28 上位アイテム

概要

Top items ウィジェットでは、アイテムのグループに対する上位（または下位）の値を表示できます。

アイテムは直接選択することも、パターンで選択することもでき、列の並び順や強調表示をカスタマイズできます。

障害アイテムの色は障害の深刻度の色に基づいており、障害の更新 画面で調整できます。

デフォルトでは、直近24時間以内の値のみが表示されます。この制限は、最新データの件数が多いページでの初回読み込み時間を改善することを目的として導入されました。この制限は、Administration → General → GUI の Max history display period オプションで設定できます。

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

設定

設定するには、タイプとして 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 - 障害を表示しません。
注意 障害状態が表示される場合、アイテム列の設定からの表示スタイル設定よりも優先されます。
アイテム 表示するアイテムパターンまたは特定のアイテムを追加します（列の設定を参照）。
詳細設定
ホストの並び順 ホスト列/行の並び順オプションを選択します。
並び順の基準 ホストの並び順を次のいずれかで指定します:
Host name - ホスト名で並べ替えます;
Item value - 選択したアイテムの値で並べ替えます。
順序 表示する値の高い順または低い順を選択します:
TopN - 上位N件の値;
BottomN - 下位N件の値。
N の値は Limit フィールドで指定します。
Limit 表示するホスト数の上限を入力します（範囲 1-1000、既定値 10）。
この値が Order フィールドの N の値になります。
アイテムの並び順 アイテム列/行の並び順オプションを選択します。
並び順の基準 アイテムの並び順を次のいずれかで指定します:
Item value - アイテム値で並べ替えます;
Item name - アイテム名で並べ替えます;
Host - 選択したホストパターンで並べ替えます。
順序 表示する値の高い順または低い順を選択します:
TopN - 上位N件の値;
BottomN - 下位N件の値。
N の値は Limit フィールドで指定します。
Limit 表示するアイテム数の上限を入力します（範囲 1-1000、既定値 10）。
この値が Order フィールドの N の値になります。
列ヘッダーを表示 列ヘッダーの表示オプションを選択します:
Off - 列ヘッダーを表示しません;
Horizontal - ヘッダー内のテキストを横向きに表示します;
Vertical - ヘッダー内のテキストを縦向きに表示します。

カラムの設定

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

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

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

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

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

数値値の列パラメータ:
表示 値の表示方法を定義します:
そのまま - 通常のテキストとして表示;
バー - 単色の塗りつぶしバーとして表示;
インジケーター - 区切られた単色の塗りつぶしバーとして表示;
スパークライン - ミニ折れ線グラフとして表示。
最小 バー/インジケーター表示の最小値。
最大 バー/インジケーター表示の最大値。
幅 スライダーを使用するか、0 から 10 の範囲で値を手動入力して、グラフ線の太さを設定します。
このパラメータはスパークライン表示でのみ使用されます。
塗りつぶし スライダーを使用するか、0 から 10 の範囲で値を手動入力して、塗りつぶし色の透明度を設定します。
このパラメータはスパークライン表示でのみ使用されます。
色 線と塗りつぶしの色を選択します。
このパラメータはスパークライン表示でのみ使用されます。
時間期間と履歴データの選択に関連するフィールドの説明については、詳細設定 を参照してください。
しきい値 背景/塗りつぶし色を変更するしきい値を指定します。
保存時にリストは昇順に並べ替えられます。
スパークラインでは、しきい値はアイテムの最新値にのみ適用されます。
小数点以下桁数 値とともに表示する小数点以下の桁数を指定します。
詳細設定
集計関数 選択した 時間期間 内で使用する集計関数を指定します:
min - 最小値を表示;
max - 最大値を表示;
avg - 平均値を表示;
count - 値の件数を表示;
sum - 値の合計を表示;
first - 最初の値を表示;
last - 最後の値を表示。
使用しない を選択すると、最新の値が表示されます（集計なし）。

集計を使用すると、最新の値ではなく、選択した間隔（5 分、1 時間、1 日）の集計値を表示できます。
min、max、avg、sum では数値データのみ表示できます。count では、非数値データは数値に変換されます。
時間期間 値の集計に使用する時間期間を指定します:
ダッシュボード - ダッシュボードの時間期間を使用;
ウィジェット - 指定したウィジェットの時間期間を使用;
カスタム - カスタムの時間期間を使用。
集計関数 が "使用しない" に設定されている場合、このパラメータは表示されません。
ウィジェット ウィジェットを選択します。
このパラメータは 時間期間 が "ウィジェット" に設定されている場合にのみ表示されます。
開始 開始時刻を選択します（デフォルト値 now-1h）。相対時間の構文 を参照してください。
このパラメータは 時間期間 が "カスタム" に設定されている場合にのみ表示されます。
終了 終了時刻を選択します（デフォルト値 now）。相対時間の構文 を参照してください。
このパラメータは 時間期間 が "カスタム" に設定されている場合にのみ表示されます。
履歴データ 履歴またはトレンドからデータを取得します:
自動 - 自動選択;
履歴 - 履歴データを取得;
トレンド - トレンドデータを取得。
このパラメータは数値アイテム値でのみ使用できます。テキスト値の場合、データは常に履歴から取得されます。

テキスト値の列パラメータ:
ハイライト 背景/塗りつぶし色を変更する一致条件として使用する正規表現を指定します。