8 グラフ

概要

グラフウィジェットは、数値アイテムデータをベクターベースのグラフとして表示します。 傾向の追跡、問題の発見、時間の経過やホスト間での値の比較に役立ちます。

グラフにマウスオーバーすると、値の降順で並べ替えられたアイテムの一覧を含むツールチップが表示されます。

ツールチップ内のアイテムにマウスオーバーすると、そのグラフが強調表示されます（他は薄く表示されます）。また、そのアイテムを選択すると、そのデータが他のウィジェットにbroadcastsされます。

グラフは、Y軸の値を反転して表示することもできます。これは視覚的な表示にのみ影響し、元の値は変更されません。

従来のグラフ（クラシック）ウィジェットも利用できます。

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

設定

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

データセット

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

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

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

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

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

テンプレートダッシュボード でウィジェットを設定する場合、ホストパターンを指定するパラメータは使用できません。また、アイテムリストを指定するパラメータでは、テンプレートで設定されたアイテム のみを選択できます。
描画 メトリックの描画タイプを選択します。
選択可能な描画タイプ: Line（既定）、Points、Staircase、Bar。
なお、Line/Staircase グラフにデータポイントが 1 つしかない場合、描画タイプに関係なく点として描画されます。点のサイズは線幅から計算されますが、線幅がそれより小さくても 3 ピクセル未満にはなりません。
スタック表示 チェックボックスをオンにすると、データをスタック表示（塗りつぶし領域の表示）します。
このオプションは、Points の描画タイプが選択されている場合は無効です。
幅 線幅を設定します。
このオプションは、Line または Staircase の描画タイプが選択されている場合に使用できます。
点のサイズ 点のサイズを設定します。
このオプションは、Points の描画タイプが選択されている場合に使用できます。
透明度 透明度レベルを設定します。
塗りつぶし 塗りつぶしレベルを設定します。
このオプションは、Line または Staircase の描画タイプが選択されている場合に使用できます。
欠損データ 欠損データの表示方法を選択します:
なし - ギャップは空白のままにします;
接続 - 2 つの境界値を接続します;
0 として扱う - 欠損データを 0 として表示します;
最後に取得した値 - 欠損データを最後に取得した値と同じ値で表示します。Points および Bar の描画タイプには適用されません。
ホストを上書き ホストの データソース として、互換性のあるウィジェットまたはダッシュボードの ホストセレクター を選択します。
このパラメータは、テンプレートダッシュボード でウィジェットを設定する場合は使用できません。
Y軸 Y 軸をグラフのどちら側に表示するかを選択します。
値を反転 チェックボックスをオンにすると、グラフに表示する前にすべての Y 軸の値に -1 を掛けます。
これは表示上の見た目にのみ影響し、元のデータは変更されません。
このオプションは、ツールチップ、凡例、またはパーセンタイル線には影響しません。軸に Simple triggers オプションが選択されている場合、トリガーしきい値は反転して表示されます。
時間シフト 必要に応じて時間シフトを指定します。
このフィールドでは 時間サフィックス を使用できます。負の値も指定できます。
集計関数 選択した 集計間隔 内で、各アイテムまたはデータセット全体に対して使用する集計関数を指定します:
min - 最小値を表示します;
max - 最大値を表示します;
avg - 平均値を表示します;
sum - 値の合計を表示します;
count - 値の件数を表示します;
first - 最初の値を表示します;
last - 最後の値を表示します。
not used を選択すると、すべての値が表示されます（集計なし）。

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

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

この設定は、更新間隔が短い長期間のグラフを表示する場合（たとえば、10 分ごとに収集された 1 年分の値）に便利です。
データセットラベル グラフの データセット 設定およびグラフの 凡例（集計データセットの場合）に表示されるデータセットラベルを指定します。
データセットラベル を指定したものも含め、すべてのデータセットには番号が付けられます。ラベルを指定しない場合、データセットには番号に基づいて自動的にラベルが付けられます（例: "Data set #2"、"Data set #3" など）。データセットの番号は、データセットの並べ替え/ドラッグ後に再計算されます。
長すぎるデータセットラベルは、表示領域に収まるように短縮されます（例: "Number of proc..."）。
アイテムタグ ウィジェットに表示するアイテムをフィルタリングするタグを指定します。
特定のタグおよびタグ値を含めることも除外することもできます。複数の条件を設定できます。
タグ名の一致では常に大文字と小文字が区別されます。

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

条件の計算タイプは 2 種類あります:
And/Or - すべての条件を満たす必要があります。同じタグ名を持つ条件は Or 条件でグループ化されます;
Or - いずれか 1 つの条件を満たせば十分です。
データセット設定の詳細

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

  • 移動アイコンをクリックして、データセットを一覧内の別の位置へドラッグします。
  • 展開アイコンをクリックして、データセットの詳細を展開します。 展開すると、このアイコンは 折りたたみアイコンに変わります。
  • 色アイコンをクリックして、カラーピッカーを開きます。 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つまたは複数のアイテムを選択すると、それらがデータセットのアイテムリストとグラフに表示されます。

グラフでの集計

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

集計機能の使用例として、次のようなものがあります。

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

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

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

凡例に対して Show aggregation function を選択すると、凡例およびツールチップでは、集計関数を接頭辞として付けたうえで、アイテムが括弧内に表示されます。 グラフに Data set label が指定されている場合、ラベルは集計関数を接頭辞として付けたうえで、括弧内に表示されます。

表示オプション

表示オプションタブでは、履歴データの選択を定義できます。
履歴データの選択 グラフデータのソースを設定します:
Auto - 従来のグラフアルゴリズムに従ってデータを取得します（デフォルト）。
History - 履歴のデータ。
Trends - トレンドのデータ。
シンプルトリガー チェックボックスをオンにすると、シンプルトリガーのトリガーしきい値を表示します。しきい値は、トリガーの深刻度の色を使用した破線として描画されます。
シンプルトリガーとは、式内の1つのアイテムに対して1つの関数（last、max、min、avg のみ）を持つトリガーです。
描画できるトリガーは最大3つです。表示するには、トリガーが描画範囲内にある必要があることに注意してください。
稼働時間 チェックボックスをオンにすると、グラフに稼働時間を表示します。稼働時間（稼働日）はグラフでは白い背景で表示され、非稼働時間は灰色で表示されます（デフォルトの Original blue Webインターフェーステーマの場合）。
ラベル内のホスト名 グラフの凡例およびグラフデータにマウスオーバーしたときに表示されるツールチップにホスト名を表示するかどうかを選択します:
Auto - データセット全体で複数のホストが存在する場合にのみホスト名を表示します（デフォルト）。
Show - ホスト名を表示します。
Hide - ホスト名を非表示にします。
このパラメータは、テンプレートダッシュボードでウィジェットを設定する場合は使用できません。
パーセンタイル線（左） チェックボックスをオンにしてパーセンタイル値を入力すると、指定したパーセンタイルをグラフの左Y軸に線として表示します。
たとえば 95% パーセンタイルを設定すると、値の95パーセントがその下に入る水準にパーセンタイル線が表示されます。
パーセンタイル線（右） チェックボックスをオンにしてパーセンタイル値を入力すると、指定したパーセンタイルをグラフの右Y軸に線として表示します。
たとえば 95% パーセンタイルを設定すると、値の95パーセントがその下に入る水準にパーセンタイル線が表示されます。

期間

期間タブでは、グラフにデータを表示する期間を設定できます。
期間 期間のデータソースを選択します:
ダッシュボード - ダッシュボードの期間セレクターを使用します;
ウィジェット - 互換性のあるウィジェット（ウィジェットパラメーターで設定）を使用します;
カスタム - FromおよびToパラメーターで設定したカスタム期間を使用します。設定されている場合、ウィジェットの右上隅に時計アイコンが表示され、マウスオーバーで設定された時間が表示されます。
ウィジェットの期間設定に関係なく、互換性のあるウィジェットは引き続き期間のデータソースとして使用できることに注意してください。
ウィジェット 期間のデータソースとして互換性のあるウィジェットを入力または選択します。
このパラメーターは、期間が「ウィジェット」に設定されている場合に利用できます。
From 期間の開始を入力または選択します。
相対時間構文（now、now/d、now/w-1wなど）がサポートされています。
このパラメーターは、期間が「カスタム」に設定されている場合に利用できます。
To 期間の終了を入力または選択します。
相対時間構文（now、now/d、now/w-1wなど）がサポートされています。
このパラメーターは、期間が「カスタム」に設定されている場合に利用できます。

軸

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

凡例

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

障害

障害タブでは、障害の表示をカスタマイズできます。
障害を表示 このチェックボックスをオンにすると、グラフ上に障害が表示されます（デフォルトではオフ）。
選択したアイテムのみ このチェックボックスをオンにすると、選択したアイテムの障害のみがグラフに表示されます。
障害ホスト グラフに表示する障害ホストを選択します。

ワイルドカードパターンを使用できます（例：*は0文字以上に一致します）。
ワイルドカードパターンを指定するには、文字列を手動で入力し、Enterを押します。
入力中は、ドロップダウンに一致するすべてのホストが表示されます。

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

各条件にはいくつかの演算子があります：
存在する - 指定したタグ名を含める;
等しい - 指定したタグ名と値を含める（大文字・小文字を区別）;
含む - タグ値が入力した文字列を含むタグ名を含める（部分一致、大文字・小文字を区別しない）;
存在しない - 指定したタグ名を除外する;
等しくない - 指定したタグ名と値を除外する（大文字・小文字を区別）;
含まない - タグ値が入力した文字列を含むタグ名を除外する（部分一致、大文字・小文字を区別しない）。

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

オーバーライド

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

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

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

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