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

ウィジェットで以下を表示するように設定できます:
ウィジェットをクリックすると、数値アイテムの場合はアドホックグラフ、文字列アイテムの場合は最新データが開きます。
設定するには、ウィジェットタイプとしてアイテム値を選択します:

すべてのウィジェットに共通のパラメータに加えて、以下の固有のオプションを設定できます:
| アイテム | アイテムを選択します。 または、アイテムのデータソースとして互換性のあるウィジェットを選択します。 バイナリデータを返すアイテムはサポートされていません。 |
| 表示 | それぞれの要素(説明、値、時刻、変化インジケーター、スパークライン)を表示するにはチェックボックスをマークします。非表示にするにはチェックを外します。少なくとも1つの要素を選択する必要があります。 |
| ホストの上書き | ホストのデータソースとして互換性のあるウィジェットまたはダッシュボードのホストセレクターを選択します。 このパラメータは、テンプレートダッシュボードでウィジェットを設定する場合は利用できません。 |
| 詳細設定 | 詳細設定ラベルをクリックすると、詳細設定オプションが表示されます。 |
詳細設定オプションは、折りたたみ可能な詳細設定セクションで利用でき、表示フィールドで選択された要素にのみ適用されます(上記参照)。
複数の要素が同じスペースを占有することはできません。同じスペースに配置した場合はエラーメッセージが表示されますのでご注意ください。
これらのパラメータは、ウィジェット全体の背景色(静的または動的)と値を表示するための集計関数を決定します。

| 背景色 | カラーピッカーからウィジェット全体の背景色を選択します。Dはデフォルト色(フロントエンドのテーマによって異なります)を表します。デフォルト値に戻すには、カラーピッカーのデフォルトを使用ボタンをクリックします。 |
| しきい値 | ウィジェット全体の動的な背景色を設定します。追加をクリックしてしきい値を追加し、カラーピッカーから背景色を選択し、数値を指定します。アイテム値がしきい値と等しいかそれ以上になると、背景色が変わります。 リストは保存時に昇順でソートされます。 動的な背景色は数値アイテムに対してのみ正しく表示されることに注意してください。 |
| 集計関数 | 使用する集計関数を指定します: min - 最小値を表示; max - 最大値を表示; avg - 平均値を表示; count - 値の数を表示; sum - 値の合計を表示; first - 最初の値を表示; last - 最後の値を表示; 使用しない - 最新の値を表示(集計なし)。 集計を使用すると、最新の値の代わりに選択した間隔(5分、1時間、1日など)の集計値を表示できます。 min、max、avg、sumでは数値データのみ表示できます。countでは非数値データが数値に変換されます。 |
| 期間 | 値を集計するために使用する期間。期間のデータソースとしてデータソースを選択します: ダッシュボード - ダッシュボードの期間セレクターを使用; ウィジェット - 互換性のあるウィジェット(ウィジェットパラメータで設定)を使用; カスタム - 開始および終了パラメータで設定したカスタム期間を使用; 設定されている場合、ウィジェットの右上隅に時計アイコンが表示され、マウスオーバーで設定された時間が表示されます。 ウィジェットの期間設定に関係なく、互換性のあるウィジェットは引き続き期間のデータソースとして使用できます。 このパラメータは、集計関数が「使用しない」に設定されている場合は利用できません。 |
| ウィジェット | 期間のデータソースとして互換性のあるウィジェットを入力または選択します。 このパラメータは、期間が「ウィジェット」に設定されている場合に利用できます。 |
| 開始 | 期間の開始を入力または選択します。 相対時間構文( now、now/d、now/w-1wなど)がサポートされています。このパラメータは、期間が「カスタム」に設定されている場合に利用できます。 |
| 終了 | 期間の終了を入力または選択します。 相対時間構文( now、now/d、now/w-1wなど)がサポートされています。このパラメータは、期間が「カスタム」に設定されている場合に利用できます。 |
| 履歴データ | 履歴またはトレンドからデータを取得します: 自動 - 自動選択; 履歴 - 履歴データを取得; トレンド - トレンドデータを取得。 この設定は数値データにのみ適用されます。非数値データは常に履歴から取得されます。 |
これらのパラメータは、アイテムの説明をどのように表示するかを決定します。

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

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

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

変化インジケーターは以下の通りです:
注意:
Dはデフォルト色(フロントエンドテーマによって異なります)を表します。デフォルト値に戻すには、カラーピッカーのデフォルトを使用ボタンをクリックします。
変化インジケーターの縦サイズは値のサイズ(数値アイテムの場合は値の整数部分)と同じです。
これらのパラメータは、スパークラインチャートの表示方法を決定します。

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