8 グラフ
概要
グラフウィジェットは、ベクター画像描画技術を使用してZabbixが収集したデータを可視化するための、モダンで汎用性の高い方法を提供します。 このグラフウィジェットは、Zabbix 4.0以降でサポートされています。Zabbix 4.0より前にサポートされていたグラフウィジェットも、グラフ (クラシック) として引き続き使用できることに注意してください。 詳細については、ダッシュボードページのウィジェットの追加 セクションも参照してください。

グラフウィジェットに表示される情報は、ウィジェットメニュー で 画像をダウンロード オプションを選択することで、PNG画像としてダウンロードできます。
設定
設定するにはタイプとしてグラフを選択します。

データセット
データセットタブでは、データセットを追加してグラフ用のデータを選択できます。 追加できるデータセットには2種類あります。
- アイテムパターン - 一致するアイテムのデータが表示されます。単一のベースカラーを選択するか、パレットの行を選択して、一致した各アイテムに異なる色を割り当てることができます。
- アイテムリスト - 選択したアイテムのデータが表示されます。各アイテムの色をピッカーから個別に選択できます。
デフォルトでは、アイテムパターン データセットが追加されます。
| データセット | アイテムパターン データセットの場合: ホストパターンとアイテムパターンを選択または入力します。これらのパターンに一致するアイテムのデータがグラフに表示されます。最大50個のアイテムを表示できます。 選択にはワイルドカードパターンを使用できます(たとえば、 * は0文字以上に一致する結果を返します)。ワイルドカードパターンを指定するには、文字列を手動で入力して Enter を押します。 ワイルドカード記号は常に解釈されるため、たとえば item* という名前のアイテムがあり、他にも一致するアイテム(たとえば item2、item3)が存在する場合、そのアイテムだけを個別に追加することはできません。 「アイテムパターン」データセットでは、ホストパターンとアイテムパターンの指定は必須です。 あわせて参照: データセット設定の詳細。 アイテムリスト データセットの場合: アイテムの追加 ボタンをクリックして、グラフ用のアイテムを選択します。 ウィジェットの追加 ボタンをクリックして、アイテムのdata sourceとして互換性のあるウィジェットを選択することもできます。 「アイテムリスト」データセットでは、アイテムまたはウィジェットの指定は必須です。 あわせて参照: データセット設定の詳細。 数値型のアイテムのみ使用できます。 テンプレートダッシュボードでウィジェットを設定する場合、ホストパターンを指定するためのパラメータは使用できず、アイテムリストを指定するためのパラメータではテンプレート上で設定されたアイテムのみ選択できます。 |
|
| 描画 | メトリクスの描画タイプを選択します。 選択可能な描画タイプ: 線(デフォルト)、ポイント、階段、棒。 線/階段グラフにデータポイントが1つしかない場合は、描画タイプに関係なくポイントとして描画されます。ポイントサイズは線幅から計算されますが、線幅がそれ未満であっても3ピクセル未満にはなりません。 |
|
| 積み上げ | チェックボックスをオンにすると、データを積み上げ表示します(塗りつぶし領域を表示)。 このオプションは、ポイント 描画タイプが選択されている場合は無効です。 |
|
| 幅 | 線幅を設定します。 このオプションは、線 または 階段 描画タイプが選択されている場合に使用できます。 |
|
| ポイントサイズ | ポイントサイズを設定します。 このオプションは、ポイント 描画タイプが選択されている場合に使用できます。 |
|
| 透明度 | 透明度レベルを設定します。 | |
| 塗りつぶし | 塗りつぶしレベルを設定します。 このオプションは、線 または 階段 描画タイプが選択されている場合に使用できます。 |
|
| 欠損データ | 欠損データの表示方法を選択します。 なし - ギャップは空白のままになります。 接続 - 両端の2つの値を接続します。 0として扱う - 欠損データを0値として表示します。 直前の値 - 欠損データを最後に判明している値と同じ値で表示します。ポイント および 棒 描画タイプには適用されません。 |
|
| ホストを上書き | ホストのdata sourceとして、互換性のあるウィジェットまたはダッシュボードを選択します。 このパラメータは、テンプレートダッシュボードでウィジェットを設定する場合は使用できません。 |
|
| Y軸 | Y軸を表示するグラフの側を選択します。 | |
| 時間シフト | 必要に応じて時間シフトを指定します。 このフィールドではtime suffixesを使用できます。負の値も使用できます。 |
|
| 集計関数 | 使用する集計関数を指定します。 min - 最小値を表示します。 max - 最大値を表示します。 avg - 平均値を表示します。 sum - 値の合計を表示します。 count - 値の件数を表示します。 first - 最初の値を表示します。 last - 最後の値を表示します。 none - すべての値を表示します(集計なし)。 集計を使用すると、すべての値の代わりに、選択した間隔(5分、1時間、1日)の集計値を表示できます。あわせて参照: グラフでの集計。 |
|
| 集計間隔 | 値を集計する間隔を指定します。 このフィールドではtime suffixesを使用できます。サフィックスのない数値は秒として扱われます。 ウィジェットがトレンドに基づく履歴データを表示するよう設定されている場合(履歴データの選択 が トレンド または 自動 に設定されている場合)、1時間の倍数となる集計間隔(例: 3600、60m、1h、3h など)を使用することを推奨します。トレンドには1時間単位で集計された値が保存されるため、1時間の倍数でない集計間隔(例: 100s、7min、15min、90min など)を使用すると、解釈しにくい結果になる可能性があります。 |
|
| 集計 | 集計方法を指定します。 各アイテム - データセット内の各アイテムを個別に集計して表示します。 データセット - データセット内のすべてのアイテムを集計し、1つの値として表示します。 |
|
| 近似 | グラフの縦1ピクセルあたりに複数の値が存在する場合に表示する値を指定します。 all - 最小値、最大値、平均値を表示します。 min - 最小値を表示します。 max - 最大値を表示します。 avg - 平均値を表示します。 この設定は、更新間隔が短い長期間のグラフ(たとえば、10分ごとに収集された1年分の値)を表示する場合に便利です。 |
|
| データセットラベル | グラフの データセット 設定およびグラフの 凡例(集計されたデータセットの場合)に表示されるデータセットラベルを指定します。 データセットラベル が指定されているものも含め、すべてのデータセットには番号が付けられます。ラベルが指定されていない場合、データセットには番号に応じて自動的にラベルが付けられます(例: 「データセット #2」、「データセット #3」など)。データセットの番号は、データセットの並べ替え/ドラッグ後に再計算されます。 長すぎるデータセットラベルは、表示領域に収まるように短縮されます(例: 「プロセス数...」)。 |
|
データセット設定の詳細
既存のデータセットは一覧で表示されます。次の操作を行えます。
移動アイコンをクリックし、データセットをドラッグして一覧内の別の位置に移動します。
展開アイコンをクリックして、データセットの詳細を展開します。展開すると、このアイコンは
折りたたみアイコンに変わります。
色アイコンをクリックして、カラーピッカーを開きます。16進コードを入力するか、単色のスウォッチを選択するか、Palette タブに切り替えて定義済みの色の行を選択できます。選択した色は、Item list データセットには直接適用され、Item patterns では生成される色合いのベースとして使用されます。Tab キーでダイアログ内のコントロール間を移動し、矢印キーでスウォッチまたはパレットの行を移動し、Enter キーで選択し、Esc キーでキャンセルします。- Add new data set ボタンをクリックすると、ホストおよびアイテムパターンを選択できる空のデータセットが追加されます。 Add new data set ボタンの横にある下向きアイコンをクリックすると、ドロップダウンメニューが表示され、新しい Item patterns または Item list データセットを追加したり、現在開いているデータセットを Clone したりできます。すべてのデータセットが折りたたまれている場合、Clone オプションは使用できません。

アイテムパターンデータセットには、ホストパターン フィールドと アイテムパターン フィールドがあり、どちらも完全名またはワイルドカード記号(*)を含むパターンを認識します。
この機能により、選択したパターンを含むすべてのホスト名とアイテム名を選択できます。
アイテムパターン フィールドにアイテム名またはアイテムパターンを入力している間、ドロップダウンリストには、選択したホスト名に属するアイテムのみが表示されます。
例えば、ホストパターン フィールドにパターン z* を入力すると、ドロップダウンリストにはこのパターンを含むすべてのホスト名、すなわち z*、Zabbix server、Zabbix proxy が表示されます。
Enter を押すと、このパターンが受け入れられ、z* として表示されます。
同様に、アイテムパターン フィールドにパターン a* を入力すると、ドロップダウンリストにはこのパターンを含むすべてのアイテム名、すなわち a*、Available memory、Available memory in % が表示されます。

Enter を押すと、パターンが受け入れられ、**a*** として表示されます。

その後、グラフには選択したホスト名に属するすべてのアイテムが表示されます。

アイテムリストデータセットには、グラフに表示するアイテムを追加できる アイテムの追加 ボタンがあります。
また、ウィジェットの追加 ボタンをクリックすると、アイテムのデータソースとして互換性のあるウィジェットを追加することもできます。

たとえば、アイテムの追加 ボタンをクリックすると、ホスト パラメータを含むポップアップウィンドウが開きます。
ホストを選択すると、選択可能なそのホストのすべてのアイテムが一覧に表示されます。

1つ以上のアイテムを選択すると、それらはデータセットのアイテム一覧とグラフに表示されます。

Aggregation in graphs
Aggregation allows displaying an aggregated value (minimum, maximum, average, etc.) over a specified time interval (5 minutes, an hour, a day, etc.) instead of all individual values. Within a data set, aggregation can be applied either to each item separately or to the entire data set.
Some use cases for the aggregation function can be as follows:
- The average request count to an Nginx server per day.
- The lowest disk space among clusters per week.
In the following example, the "max" aggregation function is applied to the item with an aggregation interval of five minutes:

The example demonstrates the maximum CPU load over five minutes (aggregated from one-minute average values), compared to the average CPU load over five minutes.

When Show aggregation function is selected for the legend, items are displayed in parentheses, prefixed by the aggregation function in the legend and the tooltip. If Data set label is specified for a graph, the label is displayed in parentheses, prefixed by the aggregation function.
表示オプション
表示オプションタブでは、履歴データの選択を定義できます。

| 履歴データの選択 | グラフデータのソースを設定します。 自動 - クラシックグラフのアルゴリズムに従ってデータを取得します(デフォルト)。 履歴 - 履歴からのデータ。 トレンド - トレンドからのデータ。 |
| シンプルトリガー | チェックボックスをオンにすると、シンプルトリガーのトリガーしきい値を表示します。しきい値は、トリガーの深刻度の色を使用した破線として描画されます。 シンプルトリガーとは、式内の1つのアイテムに対して1つの関数( last、max、min、avg のみ)を持つトリガーです。描画できるトリガーは最大3つです。表示するには、トリガーが描画範囲内にある必要があることに注意してください。 |
| 稼働時間 | チェックボックスをオンにすると、グラフ上に稼働時間を表示します。稼働時間(稼働日)はグラフでは白い背景で表示され、非稼働時間は灰色で表示されます(デフォルトのWebインターフェーステーマ Original blue の場合)。 |
| パーセンタイル線(左) | チェックボックスをオンにしてパーセンタイル値を入力すると、指定したパーセンタイルをグラフの左Y軸上の線として表示します。 たとえば 95% パーセンタイルを設定した場合、パーセンタイル線は値の95パーセントがその下に入るレベルに表示されます。 |
| パーセンタイル線(右) | チェックボックスをオンにしてパーセンタイル値を入力すると、指定したパーセンタイルをグラフの右Y軸上の線として表示します。 たとえば 95% パーセンタイルを設定した場合、パーセンタイル線は値の95パーセントがその下に入るレベルに表示されます。 |
期間
期間タブでは、グラフに表示するデータの期間を設定できます。

| 期間 | 期間のデータソースを選択します。詳細はdata sourceを参照してください。 ダッシュボード - 期間セレクターをデータソースとして設定します。 ウィジェット - ウィジェットパラメータで指定した互換性のあるウィジェットをデータソースとして設定します。 カスタム - 開始および終了パラメータで指定した期間をデータソースとして設定します。設定すると、ウィジェットの右上隅に時計アイコンが表示され、マウスオーバー時に設定された時刻が示されます。 |
| ウィジェット | 期間のデータソースとして使用する互換性のあるウィジェットを入力または選択します。 このパラメータは、期間が「ウィジェット」に設定されている場合に使用できます。 |
| 開始 | 期間の開始を入力または選択します。 Relative time syntax( now、now/d、now/w-1w など)をサポートしています。このパラメータは、期間が「カスタム」に設定されている場合に使用できます。 |
| 終了 | 期間の終了を入力または選択します。 Relative time syntax( now、now/d、now/w-1w など)をサポートしています。このパラメータは、期間が「カスタム」に設定されている場合に使用できます。 |
軸
軸タブでは、軸の表示方法をカスタマイズできます。

| 左Y | このチェックボックスをオンにすると、左Y軸が表示されます。 データセットタブまたはオーバーライドタブのいずれかで未選択の場合、このチェックボックスは無効になることがあります。 |
| 右Y | このチェックボックスをオンにすると、右Y軸が表示されます。 データセットタブまたはオーバーライドタブのいずれかで未選択の場合、このチェックボックスは無効になることがあります。 |
| X軸 | このチェックボックスをオフにすると、X軸を非表示にします(デフォルトでオン)。 |
| スケール | ドロップダウンからグラフ軸の値のスケールを選択します。 線形 - 軸の値は一定量ずつ増加します(例: 10、20、30)。一定の変化をするデータや、小~中程度の範囲を扱うデータに適しています。 対数 - 軸の値は指数関数的に増加します(例: 10、100、1000)。急激に変化するデータや、大きな範囲を扱うデータに適しています。 |
| 最小 | 対応する軸の最小値を設定します。 Y軸の表示範囲の最小値を指定します。 |
| 最大 | 対応する軸の最大値を設定します。 Y軸の表示範囲の最大値を指定します。 |
| 単位 | ドロップダウンからグラフ軸の値の単位を選択します。 自動 - 軸の値は、データセット内の最初のアイテムの単位を使用して表示されます。 固定 - 軸の値は、value入力フィールドで指定した単位を使用して表示されます。フィールドを空欄のままにすると、数値のみが表示されます。 |
凡例
凡例タブでは、グラフの凡例をカスタマイズできます。

| 凡例を表示 | このチェックボックスをオフにすると、グラフ上の凡例が非表示になります(デフォルトでオン)。 |
| 最小/平均/最大を表示 | このチェックボックスをオンにすると、凡例にアイテムの最小値、平均値、最大値が表示されます。 |
| 集計関数を表示 | このチェックボックスをオンにすると、凡例に集計関数が表示されます。 |
| 行 | 凡例の行の表示モードを選択します。 固定 - 表示される行数は、行数パラメータの値によって決まります。 可変 - 表示される行数は、設定されたアイテム数によって決まり、最大行数パラメータの値を超えません。 |
| 行数/ 最大行数 |
行が「固定」に設定されている場合、表示する凡例の行数を設定します(1~10)。 行が「可変」に設定されている場合、表示する凡例の最大行数を設定します(1~10)。 |
| 列数 | 表示する凡例の列数を設定します(1~4)。 このパラメータは、最小/平均/最大を表示がオフの場合に使用できます。 |
障害
障害タブでは、障害の表示をカスタマイズできます。

| 障害を表示 | このチェックボックスをオンにすると、グラフ上で障害の表示が有効になります(デフォルトではオフ、つまり無効)。 |
| 選択したアイテムのみ | このチェックボックスをオンにすると、グラフには選択したアイテムの障害のみが表示されます。 |
| 障害ホスト | グラフに表示する障害ホストを選択します。 ワイルドカードパターンを使用できます(たとえば、 * は0文字以上に一致する結果を返します)。ワイルドカードパターンを指定するには、文字列を手動で入力して Enter を押します。 入力中は、一致するすべてのホストがドロップダウンに表示されることに注意してください。 このパラメータは、テンプレートダッシュボードでウィジェットを設定する場合は使用できません。 |
| 深刻度 | グラフに表示する障害を絞り込むため、障害の深刻度を選択します。 深刻度が1つも選択されていない場合は、すべての障害が表示されます。 |
| 障害 | グラフに表示する障害名を指定します。 |
| 障害タグ | ウィジェットに表示する障害数を制限するため、障害タグを指定します。 特定のタグおよびタグ値を含めることも除外することもできます。複数の条件を設定できます。タグ名の一致では常に大文字と小文字が区別されます。 各条件では、次の演算子を使用できます。 Exists - 指定したタグ名を含めます。 Equals - 指定したタグ名と値を含めます(大文字と小文字を区別)。 Contains - タグ値に入力した文字列が含まれる指定タグ名を含めます(部分一致、大文字と小文字を区別しない)。 Does not exist - 指定したタグ名を除外します。 Does not equal - 指定したタグ名と値を除外します(大文字と小文字を区別)。 Does not contain - タグ値に入力した文字列が含まれる指定タグ名を除外します(部分一致、大文字と小文字を区別しない)。 条件の計算タイプは2種類あります。 And/Or - すべての条件を満たす必要があります。同じタグ名を持つ条件は Or 条件でグループ化されます。 Or - いずれか1つの条件を満たせば十分です。 |
オーバーライド
オーバーライドタブでは、データセットに対してカスタムオーバーライドを追加できます。

オーバーライドは、* ワイルドカードを使用して1つのデータセットに複数のアイテムを選択しており、それらのアイテムのデフォルトの表示方法(例えば、デフォルトの基本色やその他のプロパティ)を変更したい場合に便利です。
既存のオーバーライド(存在する場合)は一覧に表示されます。新しいオーバーライドを追加するには、次の手順を実行します。
- 次の
ボタンをクリックします - オーバーライドの対象となるホストとアイテムを選択します。あるいは、ホストパターンとアイテムパターンを入力することもできます。ワイルドカードパターンを使用できます(例えば、
*は0文字以上に一致する結果を返します)。ワイルドカードパターンを指定するには、文字列を手動で入力して Enter を押します。入力中は、一致するすべてのホストがドロップダウンに表示されることに注意してください。ワイルドカード記号は常に解釈されるため、例えば "item*" という名前のアイテムがあっても、他に一致するアイテム(例: item2、item3)が存在する場合、それだけを個別に追加することはできません。ホストパターンおよびアイテムパターンのパラメータは必須です。 テンプレートダッシュボード でウィジェットを設定する場合、ホストパターンを指定するためのパラメータは使用できません。 アイテム一覧を指定するためのパラメータでは、テンプレートダッシュボード でウィジェットを設定する場合、テンプレート上で設定されたアイテム のみ選択できます。 - 次の
をクリックして、オーバーライドパラメータを選択します。少なくとも1つのオーバーライドパラメータを選択する必要があります。各パラメータの説明については、上記の データセット タブを参照してください。