Documentation
Table of Contents
7 ゲージ
概要
ゲージウィジェットは、単一項目の値をゲージとして表示します。
設定時、ウィジェットは以下の要素で構成されます：
- 項目説明（例：「CPU使用率」、「速度」）
- 項目値（例：「30.70」、「19.80」）
- 項目値の単位（例：「%」、「km/h」）
- ゲージの目盛り（例：「0%/100%」、「0/100/180/200」） -ゲージアーク（ゲージ値アークとゲージしきい値アーク） -ゲージ針
ウィジェットは詳細設定オプションを使用して視覚的に微調整でき、多様なビジュアルスタイルを作成できます：
ゲージウィジェットは数値のみ表示可能です。二進値の表示はサポートされていません。ゲージウィジェットをクリックすると、該当項目のグラフが表示されます。
設定
設定するには、タイプとしてゲージを選択します。
すべてのウィジェットに共通する共通パラメータに加えて、以下の固有のオプションを設定できます。
| アイテム | アイテムを選択します。 または、アイテムのデータソースとして互換性のあるウィジェットを選択します。 このフィールドはオートコンプリート機能を備えているため、アイテム名を入力し始めると、一致するアイテムのドロップダウンが表示されます。 数値データを返すアイテムのみを選択できることに注意してください。 |
| 最小 | ゲージの最小値を入力します。 サフィックス（例："1d"、"2w"、"4K"、"8G"）がサポートされています。値のマッピングがサポートされています。 |
| 最大 | ゲージの最大値を入力します。 サフィックス (例: "1d"、"2w"、"4K"、"8G") がサポートされています。値のマッピング がサポートされています。 |
| 色 | カラーピッカーから色を選択します。 値アーク - ゲージ値アークの色を選択します。 アーク背景 - ゲージ値アークとゲージしきい値アークの背景色を選択します。 背景 - ウィジェットの背景色を選択します。 "D" はデフォルトの色を表し、フロントエンドのテーマによって異なります。しきい値 が設定されている場合、値アーク のデフォルトの色はしきい値の色によって異なります。デフォルトの色に戻すには、カラーピッカーの デフォルトを使用 ボタンをクリックします。 |
| 表示 | チェックボックスをオンにすると、説明、値、値アーク、針、スケール（アークの開始時と終了時のゲージの最小値と最大値）の各ゲージ要素が表示されます。非表示にするには、チェックを外します。少なくとも 1 つの要素を選択する必要があります。 ゲージ値アークまたはゲージしきい値アーク（詳細設定 オプションを参照）が表示されている場合は、ゲージの針とスケールを表示できます。また、ゲージの針が表示されている場合は、値が針の下に配置され、針が非表示の場合は、値がゲージアークの下部に揃えられることにも注意してください。 |
| ホストを上書き | ホストのデータソースとして、互換性のあるウィジェットまたはダッシュボードを選択します。 このパラメーターは、テンプレートダッシュボードでウィジェットを設定する場合は使用できません。 |
| 詳細設定 | 詳細設定ラベルをクリックすると、詳細設定オプションが表示されます。また、表示フィールドで選択したゲージ要素を調整することもできます。 |
Advanced configuration
Advanced configuration options are available in the collapsible Advanced configuration section.
| Angle | Select the gauge angle (180° or 270°). |
| Description | |
| Description | Enter the item description. This description may override the default item name. Multiline descriptions are supported. A combination of text and supported macros is possible. {HOST.*}, {ITEM.*}, {INVENTORY.*} and user macros are supported. |
| Size | Enter the font size height for the item description (in percent, relative to the total widget height). |
| Vertical position | Select the vertical position of the item description (top or bottom, relative to the gauge arc). |
| Bold | Mark the checkbox to display the item description in bold. |
| Color | Select the item description color from the color picker. "D" stands for the default color, which depends on the frontend theme. To return to the default value, click the Use default button in the color picker. |
| Value | |
| Decimal places | Enter the number of decimal places to display with the value. This option affects only items that return numeric (float) data. |
| Size | Enter the font size height for the value (in percent, relative to the gauge arc height). |
| Bold | Mark the checkbox to display the value in bold. |
| Color | Select the value color from the color picker. "D" stands for the default color, which depends on the frontend theme. To return to the default value, click the Use default button in the color picker. |
| Arc | Mark the checkbox to display the gauge value arc. |
| Arc size | Enter the size height of the gauge value arc (in percent, relative to the gauge arc radius). |
| Units | |
| Units | Mark the checkbox to display units with the item value. If you enter a unit name, it will override the units set in the item configuration. |
| Size | Enter the font size height for the item units (in percent, relative to the gauge arc height). |
| Bold | Mark the checkbox to display item units in bold. |
| Position | Select the position of the item units (above, below, before or after, relative to the item value). This option is ignored for the following time-related units: unixtime, uptime, s. |
| Color | Select the item units color from the color picker. "D" stands for the default color, which depends on the frontend theme. To return to the default value, click the Use default button in the color picker. |
| Needle | |
| Needle | Mark the checkbox to display the gauge needle. If the needle is displayed, the value is placed under the needle; if the needle is hidden, the value is aligned with the bottom of the gauge arc. |
| Color | Select the gauge needle color from the color picker. "D" stands for the default color; if Thresholds are not set, the default color depends on the frontend theme; if Thresholds are set, the default color depends on the threshold color. To return to the default value, click the Use default button in the color picker. |
| Scale | |
| Scale | Mark the checkbox to display the minimum and maximum value of the gauge at the beginning and end of the gauge scale. |
| Show units | Mark the checkbox to display units with the minimum and maximum value of the gauge. |
| Size | Enter the font size height for the minimum and maximum value of the gauge (in percent, relative to the gauge arc height). |
| Decimal places | Enter the number of decimal places to display with the minimum and maximum value of the gauge. This option affects only items that return numeric (float) data. |
| Thresholds | |
| Thresholds | Click Add to add a threshold, select a threshold color from the color picker, and specify a numeric value. The thresholds list will be sorted in ascending order when saved. Note that the colors configured as thresholds will be displayed correctly only for numeric items. Suffixes (for example, "1d", "2w", "4K", "8G") are supported. Value mappings are supported. |
| Show labels | Mark the checkbox to display threshold values as labels on the gauge scale. |
| Show arc | Mark the checkbox to display the gauge thresholds arc. |
| Arc size | Enter the size height of the gauge thresholds arc (in percent, relative to the gauge arc radius). |
The information displayed by the gauge widget can be downloaded as a .png image using the widget menu.
A screenshot of the widget will be saved to the Downloads folder.