8 グラフ

概要

グラフウィジェットは、ベクター画像描画技術を使用して Zabbix によって収集されたデータを可視化する、最新かつ多用途な方法を提供します。 このグラフウィジェットは Zabbix 4.0 以降でサポートされています。なお、Zabbix 4.0 より前でサポートされていたグラフウィジェットも、引き続き Graph (classic) として使用できます。 詳細については、Dashboards ページの ウィジェットの追加 セクションも参照してください。

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

設定

設定するにはタイプとしてグラフを選択します。

データセット

データセット タブでは、データセットを追加してグラフに表示するデータを選択できます。 追加できるデータセットには 2 種類あります。

  • アイテムパターン - 一致するアイテムのデータが表示されます。単一の基本色を選択するか、パレットの行を選んで、各一致アイテムに個別の色を割り当てることができます。
  • アイテムリスト - 選択したアイテムのデータが表示されます。各アイテムの色は、ピッカーで個別に選択できます。

デフォルトでは、アイテムパターン のデータセットが追加されます。
データセット アイテムパターン のデータセットの場合:
ホストとアイテムのパターンを選択または入力します。これらのパターンに一致するアイテムのデータがグラフに表示されます。最大 50 アイテムまで表示できます。
選択にはワイルドカードパターンを使用できます（たとえば、* は 0 文字以上に一致する結果を返します）。
ワイルドカードパターンを指定するには、文字列を手動で入力して Enter を押します。
ワイルドカード記号は常に解釈されるため、たとえば item* という名前のアイテムを、他に一致するアイテム（たとえば item2、item3）がある場合に個別に追加することはできません。
アイテムパターン のデータセットでは、ホストとアイテムのパターンを指定することが必須です。
参照: データセット設定の詳細。

アイテムリスト のデータセットの場合:
アイテムを追加 ボタンをクリックして、グラフに表示するアイテムを選択します。
ウィジェットを追加 ボタンをクリックして、アイテムの データソース として互換性のあるウィジェットを選択することもできます。
アイテムリスト のデータセットでは、アイテムまたはウィジェットの指定が必須です。
参照: データセット設定の詳細。

数値型のアイテムのみ使用できます。

テンプレートダッシュボード でウィジェットを設定する場合、ホストパターンを指定するパラメーターは使用できません。また、アイテムリストを指定するパラメーターでは、テンプレートで設定されたアイテム のみを選択できます。
描画 メトリックの描画タイプを選択します。
使用可能な描画タイプ: Line（デフォルト）、Points、Staircase、Bar。
なお、ライン/階段グラフにデータポイントが 1 つしかない場合、描画タイプに関係なくポイントとして描画されます。ポイントサイズは線幅から計算されますが、線幅がそれより小さくても 3 ピクセル未満にはなりません。
Stacked チェックボックスをオンにすると、データを積み上げ表示します（塗りつぶし領域が表示されます）。
このオプションは、Points の描画タイプが選択されている場合は無効です。
Width 線幅を設定します。
このオプションは、Line または Staircase の描画タイプが選択されている場合に使用できます。
Point size ポイントサイズを設定します。
このオプションは、Points の描画タイプが選択されている場合に使用できます。
Transparency 透明度を設定します。
Fill 塗りつぶしレベルを設定します。
このオプションは、Line または Staircase の描画タイプが選択されている場合に使用できます。
Missing data 欠損データの表示方法を選択します:
None - ギャップは空のままです;
Connected - 2 つの境界値を接続します;
Treat as 0 - 欠損データを 0 として表示します;
Last known - 欠損データを最後に取得した値と同じ値で表示します。Points および Bar の描画タイプには適用されません。
Override host ホストのデータソースとして、互換性のあるウィジェットまたはダッシュボードを選択します。
このパラメーターは、テンプレートダッシュボード でウィジェットを設定する場合は使用できません。
Y-axis Y 軸をグラフのどちら側に表示するかを選択します。
Time shift 必要に応じて時間シフトを指定します。
このフィールドでは 時間サフィックス を使用できます。負の値も指定できます。
Aggregation function 選択した Aggregation interval 内で、各アイテムまたはデータセット全体に対して使用する集計関数を指定します:
min - 最小値を表示します;
max - 最大値を表示します;
avg - 平均値を表示します;
sum - 合計値を表示します;
count - 値の件数を表示します;
first - 最初の値を表示します;
last - 最後の値を表示します。
not used を選択すると、すべての値が表示されます（集計なし）。

min、max、avg、sum では数値データのみ表示できます。count では、非数値データは数値に変換されます。
参照: グラフでの集計。
Aggregation interval 値を集計する間隔を指定します。
このフィールドでは 時間サフィックス を使用できます。サフィックスのない数値は秒として扱われます。

ウィジェットが トレンド に基づいて履歴データを表示するよう設定されている場合（History data selection が Trends または Auto に設定されている場合）、1 時間の倍数となる集計間隔を使用することを推奨します（例: 3600、60m、1h、3h など）。トレンドは 1 時間単位で集計された値を保存するため、1 時間の倍数ではない集計間隔（例: 100s、7min、15min、90min など）を使用すると、結果の解釈が難しくなる場合があります。
Aggregate 集計するかどうかを指定します:
Each item - データセット内の各アイテムを個別に集計して表示します;
Data set - データセット内のすべてのアイテムを集計し、1 つの値として表示します。
Approximation 縦方向のグラフ 1 ピクセルあたりに複数の値が存在する場合に表示する値を指定します:
all - 最小値、最大値、平均値を表示します;
min - 最小値を表示します;
max - 最大値を表示します;
avg - 平均値を表示します。

この設定は、更新間隔が短い長期間のグラフを表示する場合に便利です（たとえば、10 分ごとに収集された 1 年分の値）。
Data set label グラフの データセット 設定およびグラフの Legend（集計データセットの場合）に表示されるデータセットラベルを指定します。
Data set label を指定したものを含め、すべてのデータセットには番号が付けられます。ラベルが指定されていない場合、データセットには番号に基づいて自動的にラベルが付けられます（例: "Data set #2"、"Data set #3" など）。データセットの番号は、データセットの並べ替え/ドラッグ後に再計算されます。
長すぎるデータセットラベルは、表示領域に収まるように短縮されます（例: "Number of proc..."）。
データセット設定の詳細

既存のデータセットは一覧で表示されます。次の操作が可能です。

  • 移動アイコンをクリックして、データセットを一覧内の別の場所へドラッグします。
  • 展開アイコンをクリックして、データセットの詳細を展開します。展開すると、このアイコンは 折りたたみアイコンに変わります。
  • 色アイコンをクリックして、カラーピッカーを開きます。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***として表示されます。

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

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

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

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

グラフにおける集計

集計を使用すると、すべての個別の値の代わりに、指定した時間間隔（5分、1時間、1日など）にわたる集計値（最小、最大、平均など）を表示できます。 データセット内では、集計を各アイテムごとに個別に適用することも、データセット全体に適用することもできます。

集計関数の使用例は、次のとおりです。

  • Nginx サーバーへの1日あたりの平均リクエスト数。
  • クラスター間での1週間あたりの最小ディスク空き容量。

次の例では、5分の集計間隔を持つアイテムに「max」集計関数が適用されています。

この例では、5分間の最大CPU負荷（1分ごとの平均値から集計）を、5分間の平均CPU負荷と比較しています。

凡例で 集計関数を表示 を選択すると、アイテムは凡例とツールチップ内で集計関数を前置した括弧付きで表示されます。 グラフに データセットラベル を指定すると、ラベルは集計関数を前置した括弧付きで表示されます。

表示オプション

表示オプション タブでは、履歴データの選択を定義できます。
履歴データの選択 グラフデータのソースを設定します:
Auto - データは従来のグラフアルゴリズムに従って取得されます（デフォルト）;
History - 履歴からのデータ;
Trends - トレンドからのデータ。
Simple triggers チェックボックスをオンにすると、単純なトリガーのしきい値を表示します。しきい値は、トリガーの重要度の色を使用した破線で描画されます。
単純なトリガーとは、式内で1つのアイテムに対して1つの関数（last、max、min、avg のみ）を持つトリガーです。
描画できるトリガーは最大3つです。なお、トリガーが表示されるには、描画範囲内にある必要があります。
Working time チェックボックスをオンにすると、グラフ上に稼働時間を表示します。稼働時間（営業日）はグラフ上で白い背景として表示され、非稼働時間は灰色で表示されます（Original blue のデフォルトの Webインターフェース テーマの場合）。
Percentile line (left) チェックボックスをオンにしてパーセンタイル値を入力すると、指定したパーセンタイルをグラフの左Y軸上の線として表示します。
たとえば95%のパーセンタイルを設定すると、パーセンタイル線は値の95%がその下に収まる位置に表示されます。
Percentile line (right) チェックボックスをオンにしてパーセンタイル値を入力すると、指定したパーセンタイルをグラフの右Y軸上の線として表示します。
たとえば95%のパーセンタイルを設定すると、パーセンタイル線は値の95%がその下に収まる位置に表示されます。

時間期間

時間期間 タブでは、グラフに表示するデータの時間期間を設定できます。
時間期間 時間期間の データソース を選択します:
Dashboard - 時間期間 セレクターをデータソースとして設定します;
Widget - Widget パラメーターで指定された互換性のあるウィジェットをデータソースとして設定します;
Custom - From および To パラメーターで指定された時間期間をデータソースとして設定します; 設定すると、ウィジェットの右上隅に時計アイコンが表示され、マウスオーバー時に設定時刻が示されます。
Widget 時間期間のデータソースとして、互換性のあるウィジェットを入力または選択します。
このパラメーターは、時間期間 が "Widget" に設定されている場合に使用できます。
From 時間期間の開始を入力または選択します。
相対時間の構文 (now, now/d, now/w-1w, など) がサポートされています。
このパラメーターは、時間期間 が "Custom" に設定されている場合に使用できます。
To 時間期間の終了を入力または選択します。
相対時間の構文 (now, now/d, now/w-1w, など) がサポートされています。
このパラメーターは、時間期間 が "Custom" に設定されている場合に使用できます。

軸

軸タブでは、軸の表示方法をカスタマイズできます。
左Y 左Y軸を表示するには、このチェックボックスをオンにします。
このチェックボックスは、データセットまたはオーバーライドタブで選択解除されている場合は無効になります。
右Y 右Y軸を表示するには、このチェックボックスをオンにします。
このチェックボックスは、データセットまたはオーバーライドタブで選択解除されている場合は無効になります。
X軸 このチェックボックスをオフにすると、X軸が非表示になります（デフォルトでオン）。
スケール グラフ軸の値のスケールをドロップダウンから選択します：
リニア - 軸の値が一定の量で増加します（例：10、20、30）。データが安定して変化する場合や、範囲が小～中程度の場合に適しています。
対数 - 軸の値が指数関数的に増加します（例：10、100、1000）。データが急激に変化する場合や、範囲が大きい場合に適しています。
最小 対応する軸の最小値を設定します。
Y軸の表示範囲の最小値を指定します。
最大 対応する軸の最大値を設定します。
Y軸の表示範囲の最大値を指定します。
単位 グラフ軸の値の単位をドロップダウンから選択します：
自動 - 軸の値はデータセット内の最初のアイテムの単位で表示されます。
静的 - 軸の値は値入力フィールドで指定した単位で表示されます。フィールドが空白の場合は、数値のみが表示されます。

凡例

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

問題

問題 タブでは、障害の表示をカスタマイズできます。
障害を表示 このチェックボックスをオンにすると、グラフ上に障害を表示できます（未チェック、つまり既定では無効）。
選択したアイテムのみ このチェックボックスをオンにすると、選択したアイテムの障害のみをグラフに表示します。
障害ホスト グラフに表示する障害ホストを選択します。

ワイルドカードパターンを使用できます（たとえば、* は 0 文字以上に一致する結果を返します）。
ワイルドカードパターンを指定するには、文字列を手動で入力して Enter を押します。
入力中は、一致するすべてのホストがドロップダウンに表示されることに注意してください。

このパラメーターは、テンプレートダッシュボード でウィジェットを設定する場合は使用できません。
深刻度 グラフに表示する障害を絞り込むために、障害の深刻度を選択します。
深刻度が選択されていない場合、すべての障害が表示されます。
障害 グラフに表示する障害の名前を指定します。
障害タグ ウィジェットに表示する障害数を制限するために、障害タグを指定します。
特定のタグおよびタグ値を含めることも除外することもできます。複数の条件を設定できます。タグ名の一致では常に大文字と小文字が区別されます。

各条件で使用できる演算子は次のとおりです。
Exists - 指定したタグ名を含める;
Equals - 指定したタグ名と値を含める（大文字と小文字を区別）;
Contains - タグ値に入力した文字列を含む指定したタグ名を含める（部分一致、大文字と小文字を区別しない）;
Does not exist - 指定したタグ名を除外する;
Does not equal - 指定したタグ名と値を除外する（大文字と小文字を区別）;
Does not contain - タグ値に入力した文字列を含む指定したタグ名を除外する（部分一致、大文字と小文字を区別しない）。

条件の計算タイプは 2 つあります。
And/Or - すべての条件を満たす必要があります。同じタグ名を持つ条件は Or 条件でグループ化されます。
Or - いずれか 1 つの条件を満たせば十分です。

オーバーライド

オーバーライド タブでは、データセットに対してカスタムのオーバーライドを追加できます。

オーバーライドは、* ワイルドカードを使用してデータセットに複数のアイテムを選択し、それらのアイテムの既定の表示方法（たとえば、既定のベースカラーやその他のプロパティ）を変更したい場合に便利です。

既存のオーバーライドがある場合は、一覧で表示されます。新しいオーバーライドを追加するには、次の手順を実行します。

  • 次のボタンをクリックします。
  • オーバーライド対象のホストとアイテムを選択します。代わりに、ホストおよびアイテムのパターンを入力することもできます。ワイルドカードパターンを使用できます（たとえば、* は 0 個以上の文字に一致する結果を返します）。ワイルドカードパターンを指定するには、文字列を手動で入力して Enter を押します。入力中は、一致するすべてのホストがドロップダウンに表示されることに注意してください。ワイルドカード記号は常に解釈されるため、たとえば item2、item3 など他に一致するアイテムがある場合、"item*" という名前のアイテムを個別に追加することはできません。ホストパターンとアイテムパターンのパラメータは必須です。 ホストパターンを指定するパラメータは、テンプレートダッシュボード でウィジェットを設定する場合は使用できません。 アイテム一覧を指定するパラメータでは、テンプレートダッシュボード でウィジェットを設定する場合に、テンプレートで設定されたアイテム のみを選択できます。
  • 次のボタンをクリックして オーバーライドパラメータを選択します。少なくとも 1 つのオーバーライドパラメータを選択する必要があります。パラメータの説明については、上記の データセット タブを参照してください。