18 アイテム値

概要

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

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

  • メトリクスの時刻
  • アイテムの説明
  • 値の変化インジケーター
  • 値の背景色
  • アイテムの単位
  • 指定した期間の値を示すスパークラインチャート

このウィジェットでは、数値および文字列の値を表示できます。バイナリ値の表示には対応していません。 文字列の値は1行で表示され、必要に応じて省略されます。アイテムに値がない場合は、「データなし」と表示されます。

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

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

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

設定

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

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

詳細設定

詳細設定オプションは、折りたたみ可能な詳細設定セクションで利用でき、表示フィールドで選択された要素にのみ適用されます(上記参照)。

複数の要素が同じスペースを占有することはできません。同じスペースに配置した場合はエラーメッセージが表示されますのでご注意ください。

ウィジェット共通パラメータ

これらのパラメータでは、ウィジェット全体の背景色（静的または動的）と、値の表示に使用する集計関数を設定します。
背景色 カラーピッカーからウィジェット全体の背景色を選択します。
D はデフォルトの色（Webインターフェースのテーマによって異なります）を表します。デフォルト値に戻すには、カラーピッカーの デフォルトを使用 ボタンをクリックします。
しきい値 ウィジェット全体の動的な背景色を設定します。追加 をクリックしてしきい値を追加し、カラーピッカーから背景色を選択して、数値を指定します。アイテムの値がしきい値以上になると、背景色が変わります。
保存時に、リストは昇順に並べ替えられます。
動的な背景色が正しく表示されるのは、数値アイテムの場合のみです。
集計関数 選択した 期間 内で使用する集計関数を指定します。
min - 最小値を表示します。
max - 最大値を表示します。
avg - 平均値を表示します。
count - 値の件数を表示します。
sum - 値の合計を表示します。
first - 最初の値を表示します。
last - 最後の値を表示します。
使用しない を選択すると、最新の値が表示されます（集計なし）。

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

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

これらのパラメータは、アイテムの説明をどのように表示するかを決定します。
説明 アイテムの説明を入力します。この説明はデフォルトのアイテム名を上書きする場合があります。複数行の説明がサポートされています。テキストとサポートされているマクロの組み合わせが可能です。
{HOST.*}、{ITEM.*}、{INVENTORY.*}およびユーザーマクロがサポートされています。
水平位置 アイテム説明の水平位置を選択します（左、右、中央）。
垂直位置 アイテム説明の垂直位置を選択します（上、下、中央）。
サイズ アイテム説明のフォントサイズの高さを入力します（ウィジェット全体の高さに対するパーセント）。
太字 チェックボックスをオンにすると、アイテム説明が太字で表示されます。
色 カラーピッカーからアイテム説明の色を選択します。
Dはデフォルト色（フロントエンドテーマによって異なります）を表します。デフォルト値に戻すには、カラーピッカーのデフォルトを使用ボタンをクリックします。
値

これらのパラメータは、アイテム値の表示方法を決定します。
小数点以下の桁数 値に表示する小数点以下の桁数を選択します。この値はfloat型のアイテムにのみ影響します。単位が「s」に設定されているアイテムの場合、この値が0より大きい場合（デフォルトは2）、ウィジェットは最も重要な時間単位を四捨五入し、値を完全な時間文字列に変換する代わりに数値（例：「10.43m」）を表示します。0に設定すると、秒が人間が読みやすい時間文字列（例：「4h 56m 30s」）に変換されます。
サイズ 小数点以下の桁数のフォントサイズの高さを入力します（ウィジェット全体の高さに対するパーセント）。
水平位置 アイテム値の水平位置を選択します（左、右、中央）。
垂直位置 アイテム値の垂直位置を選択します（上、下、中央）。
サイズ アイテム値のフォントサイズの高さを入力します（ウィジェット全体の高さに対するパーセント）。
アイテム値のサイズが優先されることに注意してください。他の要素は値のためにスペースを譲る必要があります。ただし、変化インジケーターがある場合、値が大きすぎると変化インジケーターを表示するために切り捨てられます。
太字 チェックボックスをオンにすると、アイテム値が太字で表示されます。
色 カラーピッカーからアイテム値の色を選択します。
Dはデフォルト色（フロントエンドテーマによる）を表します。デフォルト値に戻すには、カラーピッカーのデフォルトを使用ボタンをクリックします。
単位
単位 チェックボックスをオンにすると、アイテム値に単位が表示されます。単位名を入力すると、アイテム設定の単位を上書きします。
位置 アイテム単位の位置を選択します（値の上、下、前、後）。
サイズ アイテム単位のフォントサイズの高さを入力します（ウィジェット全体の高さに対するパーセント）。
太字 チェックボックスをオンにすると、アイテム単位が太字で表示されます。
色 カラーピッカーからアイテム単位の色を選択します。
Dはデフォルト色（フロントエンドテーマによる）を表します。デフォルト値に戻すには、カラーピッカーのデフォルトを使用ボタンをクリックします。
時刻

これらのパラメータは、時刻(アイテム履歴のクロック値)をどのように表示するかを決定します。
水平位置 時刻の水平位置を選択します - 左、右、中央。
垂直位置 時刻の垂直位置を選択します - 上、下、中央。
サイズ 時刻のフォントサイズの高さを入力します(ウィジェット全体の高さに対するパーセント)。
太字 チェックボックスをオンにすると、時刻が太字で表示されます。
色 カラーピッカーから時刻の色を選択します。
Dはデフォルト色(フロントエンドのテーマによって異なります)を表します。デフォルト値に戻すには、カラーピッカーのデフォルトを使用ボタンをクリックします。
変化インジケーター

このセクションでは、カラーピッカーから変化インジケーターの色を選択できます。

変化インジケーターは次のとおりです。

  • ↑ - アイテムの値が増加（数値アイテムの場合）
  • ↓ - アイテムの値が減少（数値アイテムの場合）
  • ↕ - アイテムの値が変化（文字列アイテムおよび値のマッピングが設定されたアイテムの場合）

D はデフォルトの色（Webインターフェースのテーマによって異なります）を表します。デフォルト値に戻すには、カラーピッカーの デフォルトを使用 ボタンをクリックします。

変化インジケーターの縦方向のサイズは、値のサイズ（数値アイテムの場合は値の整数部分）と同じです。

上昇および下降のインジケーターは、値が1つだけの場合は表示されないことに注意してください。

スパークライン

これらのパラメータは、スパークラインチャートの表示方法を決定します。
Width スライダーを使用するか、0 から 10 の範囲で値を手動入力して、グラフ線の太さを設定します。
Color 線と塗りつぶしの色を選択します。
Fill スライダーを使用するか、0 から 10 の範囲で値を手動入力して、塗りつぶし色の透明度レベルを設定します。
Time period スパークラインチャートに含める値の期間を指定します:
Dashboard - ダッシュボードの期間を使用します;
Widget - 指定したウィジェットの期間を使用します;
Custom - カスタム期間を使用します。
Widget ウィジェットを選択します。
このパラメータは、Time period が "Widget" に設定されている場合にのみ表示されます。
From 期間の開始を選択します（デフォルト値は now-1h）。相対時間の構文を参照してください。
このパラメータは、Time period が "Custom" に設定されている場合にのみ表示されます。
To 期間の終了を選択します（デフォルト値は now）。相対時間の構文を参照してください。
このパラメータは、Time period が "Custom" に設定されている場合にのみ表示されます。
History data 履歴データまたはトレンドデータからデータを取得します:
Auto - 自動選択;
History - 履歴データを取得します;
Trends - トレンドデータを取得します。