17 アイテムの値

概要

このウィジェットは、単一のアイテムの値を目立つ形で表示するのに便利です。
これは最新の値だけでなく、過去の一定期間における集計値を表示することもできます。

値そのものに加えて、必要に応じて次の要素も表示できます。

  • メトリクスの時刻
  • アイテムの説明
  • 値の変化インジケーター
  • 値の背景色
  • アイテムの単位

このウィジェットでは、数値および文字列の値を表示できます。バイナリ値の表示はサポートされていません。
文字列の値は1行で表示され、必要に応じて切り詰められます。アイテムに値がない場合は、「No data」と表示されます。

変化インジケーターは、常に過去の同じ期間と比較します。たとえば、最新の値は直前の値と比較され、最新の1か月はその前の1か月と比較されます。なお、集計における前の期間は、元の期間と同じ長さの期間で、終了時刻が元の期間の開始時刻の直前となるように計算されます。

値をクリックすると、数値アイテムの場合はアドホックグラフ、文字列アイテムの場合は最新データが表示されます。

このウィジェットおよびその中のすべての要素は、高度な設定オプションを使用して視覚的に細かく調整でき、多様なビジュアルスタイルを作成できます。

設定

設定するには、ウィジェットタイプとして Item value を選択します:

すべてのウィジェットに共通のパラメータに加えて、次の固有オプションを設定できます:
Item アイテムを選択します。
または、アイテムのdata sourceとして互換性のあるウィジェットを選択します。
Show 該当する要素（説明、値、時刻、変化インジケーター）を表示するには、チェックボックスをオンにします。非表示にするにはオフにします。少なくとも1つの要素を選択する必要があります。
Override host ホストのdata sourceとして互換性のあるウィジェットまたはダッシュボードを選択します。
このパラメータは、テンプレートダッシュボードでウィジェットを設定する場合は使用できません。
Advanced configuration Advanced configuration 見出しをクリックすると、advanced configuration オプションが表示されます。

詳細設定

折りたたみ可能な 詳細設定 セクションで詳細設定オプションを利用できます。これらは、表示 フィールドで選択された要素に対してのみ有効です（上記参照）。

さらに、詳細設定ではウィジェット全体の背景色を変更できます（静的または動的）。
説明
説明 アイテムの説明を入力します。この説明は、デフォルトのアイテム名を上書きできます。複数行の説明に対応しています。テキストと対応マクロの組み合わせも可能です。
{HOST.*}, {ITEM.*}, {INVENTORY.*} およびユーザーマクロがサポートされています。
水平位置 アイテム説明の水平位置を選択します - 左、右、または中央。
垂直位置 アイテム説明の垂直位置を選択します - 上、下、または中央。
サイズ アイテム説明のフォントサイズの高さを入力します（ウィジェット全体の高さに対するパーセント）。
太字 チェックボックスをオンにすると、アイテム説明を太字で表示します。
色 カラーピッカーからアイテム説明の色を選択します。
D はデフォルト色を表します（Webインターフェースのテーマに依存します）。デフォルト値に戻すには、カラーピッカーの デフォルトを使用 ボタンをクリックします。
値
小数点以下桁数 値とともに表示する小数点以下の桁数を選択します。この値は浮動小数点アイテムにのみ影響します。単位が "s" に設定されているアイテムでは、この値が 0 より大きい場合（デフォルトは 2）、ウィジェットは最も大きい時間単位を丸めて数値を表示し（例: "10.43m"）、値を完全な時間文字列に変換しません。0 に設定すると、秒は人間が読みやすい時間文字列に変換されます（例: "4h 56m 30s"）。
サイズ 小数点以下桁数のフォントサイズの高さを入力します（ウィジェット全体の高さに対するパーセント）。
水平位置 アイテム値の水平位置を選択します - 左、右、または中央。
垂直位置 アイテム値の垂直位置を選択します - 上、下、または中央。
サイズ アイテム値のフォントサイズの高さを入力します（ウィジェット全体の高さに対するパーセント）。
アイテム値のサイズが優先されることに注意してください。ほかの要素は、値のためにスペースを譲る必要があります。ただし変更インジケーターがある場合、値が大きすぎると、変更インジケーターを表示するために切り詰められます。
太字 チェックボックスをオンにすると、アイテム値を太字で表示します。
色 カラーピッカーからアイテム値の色を選択します。
D はデフォルト色を表します（Webインターフェースのテーマに依存します）。デフォルト値に戻すには、カラーピッカーの デフォルトを使用 ボタンをクリックします。
単位
単位 チェックボックスをオンにすると、アイテム値とともに単位を表示します。単位名を入力すると、アイテム設定の単位よりも優先されます。
位置 アイテム単位の位置を選択します - 値の上、下、前、または後。
サイズ アイテム単位のフォントサイズの高さを入力します（ウィジェット全体の高さに対するパーセント）。
太字 チェックボックスをオンにすると、アイテム単位を太字で表示します。
色 カラーピッカーからアイテム単位の色を選択します。
D はデフォルト色を表します（Webインターフェースのテーマに依存します）。デフォルト値に戻すには、カラーピッカーの デフォルトを使用 ボタンをクリックします。
時刻 (アイテム履歴の時計値)
水平位置 時刻の水平位置を選択します - 左、右、または中央。
垂直位置 時刻の垂直位置を選択します - 上、下、または中央。
サイズ 時刻のフォントサイズの高さを入力します（ウィジェット全体の高さに対するパーセント）。
太字 チェックボックスをオンにすると、時刻を太字で表示します。
色 カラーピッカーから時刻の色を選択します。
D はデフォルト色を表します（Webインターフェースのテーマに依存します）。デフォルト値に戻すには、カラーピッカーの デフォルトを使用 ボタンをクリックします。
変更インジケーター カラーピッカーから変更インジケーターの色を選択します。変更インジケーターは次のとおりです。
↑ - アイテム値が上昇（数値アイテムの場合）
↓ - アイテム値が下降（数値アイテムの場合）
↕ - アイテム値が変更（文字列アイテムおよび値マッピングのあるアイテムの場合）
D はデフォルト色を表します（Webインターフェースのテーマに依存します）。デフォルト値に戻すには、カラーピッカーの デフォルトを使用 ボタンをクリックします。
変更インジケーターの縦サイズは値のサイズと同じです（数値アイテムでは値の整数部分）。
上昇および下降インジケーターは、値が 1 つだけの場合は表示されないことに注意してください。
背景色 カラーピッカーからウィジェット全体の背景色を選択します。
D はデフォルト色を表します（Webインターフェースのテーマに依存します）。デフォルト値に戻すには、カラーピッカーの デフォルトを使用 ボタンをクリックします。
しきい値 ウィジェット全体の動的背景色を設定します。追加 をクリックしてしきい値を追加し、カラーピッカーから背景色を選択して、数値を指定します。アイテム値がしきい値以上になると、背景色が変わります。
保存時に一覧は昇順で並べ替えられます。
動的背景色は数値アイテムでのみ正しく表示されることに注意してください。
集計関数 選択した 期間 内で使用する集計関数を指定します。
min - 最小値を表示;
max - 最大値を表示;
avg - 平均値を表示;
count - 値の件数を表示;
sum - 値の合計を表示;
first - 最初の値を表示;
last - 最後の値を表示。
使用しない を選択すると、最新の値が表示されます（集計なし）。

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

この設定は数値データにのみ適用されます。非数値データは常に履歴から取得されます。

複数の要素を同じスペースに配置することはできません。同じスペースに配置された場合は、エラーメッセージが表示されます。