18 アイテム値

概要

アイテム値ウィジェットは、単一の数値または文字列アイテムの値を表示します。 重要なメトリクスを監視したり、しきい値を可視化したり、データの急激な変化を検出したりするのに便利です。

ウィジェットで以下を表示するように設定できます:

  • メトリクスのタイムスタンプ (2024-11-21 09:57:30)
  • アイテムの説明 (Load average (1m), Agent status)
  • アイテムの値、変化の指標、単位 (0.47 ↓, 99 ↑ Mbps)
  • 背景色
  • 指定した期間の値のスパークラインチャート

ウィジェットをクリックすると、数値アイテムの場合はアドホックグラフ、文字列アイテムの場合は最新データが開きます。

設定

設定するには、ウィジェットタイプとして アイテムの値 を選択します。

すべてのウィジェットに共通のパラメータに加えて、以下の固有のオプションを設定できます。
アイテム アイテムを選択します。
または、アイテムのデータソースとして互換性のあるウィジェットを選択します。
バイナリデータを返すアイテムはサポートされていません。
表示 チェックボックスをオンにすると、対応する要素を表示します: 説明、値、時刻、変化インジケーター、スパークライン。オフにすると非表示になります。少なくとも1つの要素を選択する必要があります。
ホストの上書き ホストのデータソースとして、互換性のあるウィジェットまたはダッシュボードのホストセレクターを選択します。
このパラメータは、テンプレートダッシュボードでウィジェットを設定する場合は使用できません。
高度な設定 高度な設定 ラベルをクリックすると、高度な設定オプションが表示されます。

詳細設定

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

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

汎用ウィジェットパラメータ

これらのパラメータは、ウィジェット全体の背景色（静的または動的）と、値の表示に使用する集計関数を決定します。
背景色 カラーピッカーからウィジェット全体の背景色を選択します。
D はデフォルトの色を表します（Webインターフェースのテーマに依存します）。デフォルト値に戻すには、カラーピッカーの Use default ボタンをクリックします。
しきい値 ウィジェット全体の動的な背景色を設定します。Add をクリックしてしきい値を追加し、カラーピッカーから背景色を選択して、数値を指定します。アイテムの値がしきい値以上になると、背景色が変わります。
リストは保存時に昇順でソートされます。
動的な背景色が正しく表示されるのは、数値アイテムの場合のみであることに注意してください。
集計関数 選択した 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" に設定されている場合に使用できます。
履歴データ 履歴またはトレンドからデータを取得します:
Auto - 自動選択。
History - 履歴データを取得します。
Trends - トレンドデータを取得します。

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

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

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

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

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

変化インジケーターは以下の通りです:

  • ↑ - アイテム値が上昇（数値アイテムの場合）
  • ↓ - アイテム値が下降（数値アイテムの場合）
  • ↕ - アイテム値が変化（文字列アイテムおよび値のマッピングがあるアイテムの場合）

注意:

  • 値が1つだけの場合、上昇（↑）および下降（↓）インジケーターは表示されません。
  • 値は常に同じスコープ内で比較されます。例:
    • 最新の値は前の値と比較されます。
    • 月次の値は前月と比較されます。
    • 集計の場合、前の期間は選択した期間と同じ期間で、選択した期間が始まる直前に終了します。

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

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

スパークライン

これらのパラメータは、スパークラインチャートの表示方法を決定します。
幅 グラフの線の太さをスライダーで設定するか、0から10の範囲で値を手動で入力します。
色 線と塗りつぶしの色を選択します。
塗りつぶし スライダーで塗りつぶしの透明度を設定するか、0から10の範囲で値を手動で入力します。
期間 スパークラインチャートに含める値の期間を指定します。期間のデータソースを選択します:
ダッシュボード - ダッシュボードの期間セレクターを使用;
ウィジェット - 互換性のあるウィジェットを使用（ウィジェットパラメータで設定）;
カスタム - 開始および終了パラメータで設定したカスタム期間を使用; 設定されている場合、ウィジェットの右上隅に時計アイコンが表示され、マウスオーバーで設定された時間が表示されます。
ウィジェットの期間設定に関係なく、互換性のあるウィジェットは引き続き期間のデータソースとして使用できます。
このパラメータは、集約関数が「使用しない」に設定されている場合は利用できません。
ウィジェット 期間のデータソースとして互換性のあるウィジェットを入力または選択します。
このパラメータは、期間が「ウィジェット」に設定されている場合に利用できます。
開始 期間の開始を入力または選択します。
相対時間構文（now、now/d、now/w-1wなど）がサポートされています。
このパラメータは、期間が「カスタム」に設定されている場合に利用できます。
終了 期間の終了を入力または選択します。
相対時間構文（now、now/d、now/w-1wなど）がサポートされています。
このパラメータは、期間が「カスタム」に設定されている場合に利用できます。
履歴データ 履歴またはトレンドからデータを取得します:
自動 - 自動選択;
履歴 - 履歴データを取得;
トレンド - トレンドデータを取得;