1 集計計算

概要

集計計算は、Zabbixサーバーによって複数のアイテムから情報を収集し、使用する集計関数に応じて集計を計算できる計算アイテムタイプです。

集計計算では、監視対象のホストでエージェントを実行する必要はありません。

構文

集計を取得するには、サポートされている aggregate functions のいずれかを使用します: avg、max、min、sum などです。
次に、foreach 関数を唯一のパラメータとして追加し、必要なアイテムを選択するためのアイテムフィルターを指定します:

aggregate_function(function_foreach(/host/key?[group="host group"],timeperiod))

foreach 関数（例: avg_foreach、count_foreach など）は、選択された各アイテムごとに 1 つの集計値を返します。
アイテムは、アイテム履歴からアイテムフィルター（/host/key?[group="host group"]）を使用して選択されます。
詳細は foreach functions を参照してください。

一部のアイテムに指定期間のデータがない場合、それらは計算から除外されます。
データを持つアイテムがない場合、関数はエラーを返します。

また、集計のパラメータとして複数のアイテムを列挙することもできます:

aggregate_function(function(/host/key,parameter),function(/host2/key2,parameter),...)

ここでの function は、履歴/トレンド関数でなければなりません。

ユーザーマクロと低レベルディスカバリーマクロは、次の箇所でサポートされています:

• アイテムキーのパラメータ
• 関数パラメータ
• フィルター条件（ホストグループ名とタグ名）
• 式の定数

集計計算は、次の場合にサポートされなくなることがあります:

• 参照されているアイテムが 1 つも見つからない場合（アイテムキーが正しくない、アイテムが存在しない、または含まれるグループがすべて正しくない場合に発生することがあります）
• 関数を計算するためのデータがない場合

使用例

集計のためのキーの例です。

例 1

ホストグループ「MySQL Servers」のディスク総容量。

sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"]))

例 2

ホスト上で net.if.in[*] に一致するすべてのアイテムの最新値の合計。

sum(last_foreach(/host/net.if.in[*]))

例 3

ホストグループ「MySQL Servers」の平均プロセッサー負荷。

avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"]))

例 4

ホストグループ「MySQL Servers」の1秒あたりのクエリ数の5分間平均。

avg(avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m))

例 5

特定のタグを持つ複数のホストグループ内のすべてのホストにおける平均CPU負荷。

avg(last_foreach(/*/system.cpu.load?[(group="Servers A" or group="Servers B" or group="Servers C") and (tag="Service:" or tag="Importance:High")]))

例 6

ホストグループ全体の最新のアイテム値の合計に対して使用される計算。

sum(last_foreach(/*/net.if.out[eth0,bytes]?[group="video"])) / sum(last_foreach(/*/nginx_stat.sh[active]?[group="video"])) 

例 7

ホストグループ 'Zabbix servers' におけるサポートされていないアイテムの合計数。

sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="Zabbix servers"]))

例 8

すべてのホストにわたる DNS チェックの最新の数値結果の合計。 表示されているアイテム形式は、可能なキーの一例として net.dns[192.0.2.1,example.com,A] です。

sum(last_foreach(/*/net.dns[*,*,*]))

ワイルドカードは、キー内のパラメータ数と一致している必要があることに注意してください（ここでは net.dns に 3 つのパラメータがあります: ip, name, type）。

正しい/誤った構文の例

式（関数呼び出しを含む）は、履歴、トレンド、または foreach 関数 のパラメータとして使用できません。 ただし、これらの関数自体は、他の（履歴系ではない）関数パラメータで使用できます。

次のような式では:

sum(sum_foreach(//resptime[*],5m))/sum(count_foreach(//resptime[*],5m))

式の両方の部分が常に同じ値の集合を持つことは保証できません。 式の一方の部分が評価されている間に、要求された期間の新しい値が到着する可能性があり、その結果、式のもう一方の部分は異なる値の集合を持つことになります。