[comment]: # ({364afe17-6fe0d1f1})
# 6 ゲージ
[comment]: # ({/364afe17-6fe0d1f1})
[comment]: # ({4c03826a-822e017f})
#### 概要
*Gauge* ウィジェットは、単一の数値アイテムの値をゲージとして表示します。
重要なメトリクスを監視したり、しきい値を可視化したり、急激な変化を検出したりするのに役立ちます。
{width="600"}
ウィジェットでは、次の内容を表示するように設定できます。
- アイテムの説明（Used space: {ITEM.LASTVALUE}, Temperature）
- アイテムの値と単位（21 %, 18.7 °C, 1.2 bar）
- ゲージの目盛り（1GB/24GB/28GB/32GB, -50/-40/-30/etc.）
- ゲージの弧（ゲージ値の弧とゲージしきい値の弧）
- ゲージの針
ウィジェットをクリックすると、そのアイテムの [simple graph](/manual/config/visualization/graphs/simple) が開きます。
*Gauge* ウィジェットに表示される情報は、[widget menu](/manual/web_interface/frontend_sections/dashboards#widget-menu) で *Download image* オプションを選択すると PNG 画像としてダウンロードできます。
[comment]: # ({/4c03826a-822e017f})
[comment]: # ({30857b45-3aa15745})
#### 設定
設定するには、タイプとして *Gauge* を選択します。
{width="600"}
すべてのウィジェットに[共通](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters)のパラメータに加えて、以下の固有オプションを設定できます。
| | |
|--|--------|
|*Item*|アイテムを選択します。
または、アイテムの[データソース](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters)として互換性のあるウィジェットを選択します。
このフィールドはオートコンプリートに対応しているため、アイテム名の入力を開始すると、一致するアイテムのドロップダウンが表示されます。
[numeric](/manual/config/items/item#configuration) データ（バイナリデータを除く）を返すアイテムのみ選択できることに注意してください。|
|*Min*|ゲージの最小値を入力します。
[接尾辞](/manual/appendix/suffixes)（たとえば "1d"、"2w"、"4K"、"8G"）をサポートしています。[値のマッピング](/manual/config/items/mapping)をサポートしています。|
|*Max*|ゲージの最大値を入力します。
[接尾辞](/manual/appendix/suffixes)（たとえば "1d"、"2w"、"4K"、"8G"）をサポートしています。[値のマッピング](/manual/config/items/mapping)をサポートしています。|
|*Colors*|カラーピッカーから色を選択します。
**Value arc** - ゲージの値アークの色を選択します。
**Arc background** - ゲージの値アークおよびゲージしきい値アークの背景色を選択します。
**Background** - ウィジェットの背景色を選択します。
"D" はデフォルト色を表し、これはWebインターフェースのテーマに依存します。[*Thresholds*](#advanced-configuration) が設定されている場合、**Value arc** のデフォルト色はしきい値の色に依存します。デフォルト色に戻すには、カラーピッカーの *Use default* ボタンをクリックします。|
|*Show*|対応するゲージ要素（説明、値、値アーク、針、目盛り（ゲージアークの開始位置と終了位置にあるゲージの最小値と最大値））を表示するには、チェックボックスをオンにします。非表示にするにはオフにします。少なくとも1つの要素を選択する必要があります。
ゲージの針と目盛りは、ゲージの値アークまたはゲージしきい値アーク（[高度な設定](#advanced-configuration)オプションを参照）が表示されている場合に表示できます。また、ゲージの針が表示されている場合、値は針の下に配置されます。針が非表示の場合、値はゲージアークの下端に揃えて表示されます。|
|*Override host*|ホストの[データソース](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters)として、互換性のあるウィジェットまたはダッシュボードの[host selector](/manual/web_interface/time_period_selector#host-selector)を選択します。
このパラメータは、[テンプレートダッシュボード](/manual/config/templates/template#adding-dashboards)でウィジェットを設定する場合は使用できません。|
|*Advanced configuration*|*Advanced configuration* ヘッダーをクリックすると、[高度な設定](#advanced-configuration)オプションが表示されます。ここでは、*Show* フィールドで選択したゲージ要素を調整することもできます。|
[comment]: # ({/30857b45-3aa15745})
[comment]: # ({0ace07fa-139a1aaa})
##### 詳細設定
詳細設定オプションは、折りたたみ可能な*詳細設定*セクションで利用できます。
{width="600"}
| | |
|--|--------|
|*角度*|ゲージの角度（180°または270°）を選択します。|
|***説明***|<|
|*説明*|アイテムの説明を入力します。この説明はデフォルトのアイテム名を上書きする場合があります。
複数行の説明がサポートされています。テキストとサポートされているマクロの組み合わせが可能です。
{HOST.\*}、{ITEM.\*}、{INVENTORY.\*}およびユーザーマクロがサポートされています。|
|*サイズ*|アイテムの説明のフォントサイズの高さを入力します（パーセント、ウィジェット全体の高さに対する割合）。|
|*垂直位置*|アイテムの説明の垂直位置（ゲージアークに対して上または下）を選択します。|
|*太字*|チェックボックスをオンにすると、アイテムの説明が太字で表示されます。|
|*色*|カラーピッカーからアイテムの説明の色を選択します。
"D"はデフォルト色を表し、フロントエンドのテーマによって異なります。デフォルト色に戻すには、カラーピッカーの*デフォルトを使用*ボタンをクリックします。|
|***値***|<|
|*小数点以下の桁数*|値とともに表示する小数点以下の桁数を入力します。
このオプションは、[数値（浮動小数点）](/manual/config/items/item#configuration)データを返すアイテムにのみ影響します。|
|*サイズ*|値のフォントサイズの高さを入力します（パーセント、ゲージアークの高さに対する割合）。|
|*太字*|チェックボックスをオンにすると、値が太字で表示されます。|
|*色*|カラーピッカーから値の色を選択します。
"D"はデフォルト色を表し、フロントエンドのテーマによって異なります。デフォルト色に戻すには、カラーピッカーの*デフォルトを使用*ボタンをクリックします。|
|***単位***|<|
|*単位*|チェックボックスをオンにすると、アイテム値とともに単位が表示されます。
単位名を入力すると、[アイテム設定](/manual/config/items/item#configuration)で設定された単位を上書きします。|
|*サイズ*|アイテム単位のフォントサイズの高さを入力します（パーセント、ゲージアークの高さに対する割合）。|
|*太字*|チェックボックスをオンにすると、アイテム単位が太字で表示されます。|
|*位置*|アイテム単位の位置（値に対して上、下、前、後）を選択します。
このオプションは、次の[時間関連の単位](/manual/config/items/item#configuration)（unixtime、uptime、s）には無視されます。|
|*色*|カラーピッカーからアイテム単位の色を選択します。
"D"はデフォルト色を表し、フロントエンドのテーマによって異なります。デフォルト色に戻すには、カラーピッカーの*デフォルトを使用*ボタンをクリックします。|
|***値アーク***|<|
|*アークサイズ*|ゲージ値アークのサイズの高さを入力します（パーセント、ゲージアーク半径に対する割合）。|
|***針***|<|
|*色*|カラーピッカーからゲージ針の色を選択します。
"D"はデフォルト色を表し、フロントエンドのテーマによって異なります。*しきい値*が設定されている場合、針のデフォルト色はしきい値の色に依存します。デフォルト色に戻すには、カラーピッカーの*デフォルトを使用*ボタンをクリックします。|
|***目盛り***|<|
|*単位を表示*|チェックボックスをオンにすると、ゲージの最小値と最大値に単位が表示されます。|
|*サイズ*|ゲージの最小値と最大値のフォントサイズの高さを入力します（パーセント、ゲージアークの高さに対する割合）。|
|*小数点以下の桁数*|ゲージの最小値と最大値とともに表示する小数点以下の桁数を入力します。
このオプションは、[数値（浮動小数点）](/manual/config/items/item#configuration)データを返すアイテムにのみ影響します。|
|***しきい値***|<|
|*しきい値*|*追加*をクリックしてしきい値を追加し、カラーピッカーからしきい値の色を選択し、数値を指定します。
しきい値リストは保存時に昇順でソートされます。
しきい値として設定された色は、数値アイテムに対してのみ正しく表示されることに注意してください。
[サフィックス](/manual/appendix/suffixes)（例："1d"、"2w"、"4K"、"8G"）がサポートされています。[値のマッピング](/manual/config/items/mapping)もサポートされています。|
|*ラベルを表示*|チェックボックスをオンにすると、しきい値がゲージ目盛りのラベルとして表示されます。|
|*アークを表示*|チェックボックスをオンにすると、ゲージしきい値アークが表示されます。|
|*アークサイズ*|ゲージしきい値アークのサイズの高さを入力します（パーセント、ゲージアーク半径に対する割合）。|
[comment]: # ({/0ace07fa-139a1aaa})