1 集計関数

特に明記されていない限り、ここに記載されているすべての関数は以下でサポートされています:

• トリガー式
• 計算アイテム
• 式マクロ

集計関数は以下のいずれかで動作します:

• アイテムの履歴、例: min(/host/key,1h)
• foreach関数を唯一のパラメータとして、例: min(last_foreach(/*/key))（計算アイテムのみ; トリガーでは使用不可）

関数は追加情報なしでリストされています。関数をクリックすると詳細が表示されます。

共通パラメータ

• /host/key は、ホストのアイテム履歴を参照する関数に共通する必須の第1パラメータです
• (sec|#num)<:time shift> は、ホストのアイテム履歴を参照する関数に共通する第2パラメータで、以下を意味します:
  • sec - 秒単位の最大評価期間 （時間のサフィックスを使用できます）、または
  • #num - 直近に収集された値における最大評価範囲 （ハッシュ記号が前に付く場合）
  • time shift （任意）- 評価時点を過去に移動できます。time shift の指定方法の詳細は、こちらを参照してください。

関数の詳細

関数パラメータに関する一般的な注意事項:

• 関数パラメータはカンマで区切ります
• オプションの関数パラメータ（またはパラメータの一部）は < >で示されます
• 関数固有のパラメータは各関数で説明されています
• /host/key および (sec|#num)<:time shift> パラメータは 決して引用符で囲まないでください

avg(/host/key,(sec|#num)<:time shift>)

定義された評価期間内のアイテムの平均値。
サポートされている値の型: Float、Integer。
サポートされているforeach関数: avg_foreach、count_foreach、exists_foreach、last_foreach、max_foreach、min_foreach、sum_foreach。

パラメータ: 共通パラメータを参照。

time shiftは、現在の平均値と過去の平均値を比較する必要がある場合に便利です。

例:

avg(/host/key,1h) #現在までの直近1時間の平均値
avg(/host/key,1h:now-1d) #現在から25時間前から24時間前までの1時間の平均値
avg(/host/key,#5) #最新5つの値の平均値
avg(/host/key,#5:now-1d) #直近24時間で受信した値を除いた最新5つの値の平均値

bucket_percentile(item filter,time period,percentage)

ヒストグラムのバケットからパーセンタイルを計算します。

パラメータ:

• item filter - item filterを参照してください。
  
• time period - time periodを参照してください。
  
• percentage - パーセンテージ (0-100)。

コメント:

• 計算アイテムでのみサポートされています。
• この関数は histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1)) のエイリアスです。

count(func_foreach(item filter,<time period>),<operator>,<pattern>)

foreach関数によって返される配列内の値の数です。
サポートされるforeach関数: avg_foreach、count_foreach、exists_foreach、last_foreach、max_foreach、min_foreach、sum_foreach。

パラメータ:

• func_foreach - 返された値の数をカウントする対象のforeach関数。foreach関数を参照してください。count_foreachおよびbucket_rate_foreachは追加パラメータをサポートすることに注意してください。
• item filter - アイテムフィルターを参照してください。
  
• time period - 期間を参照してください。
  
• operator（二重引用符で囲む必要があります）。サポートされるoperators:
  eq - 等しい
  ne - 等しくない
  gt - より大きい
  ge - 以上
  lt - より小さい
  le - 以下
  like - パターンを含む場合に一致（大文字・小文字を区別）
  bitand - ビット単位AND
  regexp - patternで指定された正規表現との大文字・小文字を区別する一致
  iregexp - patternで指定された正規表現との大文字・小文字を区別しない一致
  
• pattern - 必要なパターン（文字列引数は二重引用符で囲む必要があります）。3番目のパラメータでoperatorが指定されている場合にサポートされます。

コメント:

• 履歴関連のforeach関数（max_foreach、avg_foreachなど）でcount()を使用すると、パフォーマンスに影響する可能性があります。一方、設定データのみを扱うexists_foreach()を使用した場合、そのような影響はありません。
• オプションのパラメータoperatorまたはpatternは、カンマの後に空のまま残すことはできず、完全に省略する必要があります。
• 3番目のパラメータとしてbitandを使用する場合、4番目のpatternパラメータは、'/'で区切られた2つの数値として指定できます: number_to_compare_with/mask。count()は値とmaskの「ビット単位AND」を計算し、その結果をnumber_to_compare_withと比較します。「ビット単位AND」の結果がnumber_to_compare_withと等しい場合、その値がカウントされます。
  number_to_compare_withとmaskが等しい場合は、maskのみを指定できます（'/'は不要）。
• 3番目のパラメータとしてregexpまたはiregexpを使用する場合、4番目のpatternパラメータには通常の正規表現またはグローバル（'@'で始まる）正規表現を指定できます。グローバル正規表現の場合、大文字・小文字の区別はグローバル正規表現の設定を継承します。regexp一致の目的では、浮動小数点値は常に小数点以下4桁で表現されます。また、大きな数値では10進表現（データベースに保存）と2進表現（Zabbix serverで使用）の違いが小数点以下4桁目に影響する可能性があることにも注意してください。

例:

count(max_foreach(/*/net.if.in[*],1h)) #現時点までの直近1時間にデータを受信したnet.if.inアイテムの数
count(last_foreach(/*/vfs.fs.size[*,pused]),"gt",95) #ディスク使用率が95%を超えるファイルシステムの数

histogram_quantile(quantile,bucket1,value1,bucket2,value2,...)

ヒストグラムのバケットから φ-quantile を計算します。
サポートされているforeach関数: bucket_rate_foreach。

パラメータ:

• quantile - 0 ≤ φ ≤ 1;
  
• bucketN, valueN - 手動で入力されたパラメータのペア（2組以上）または bucket_rate_foreach の応答。

コメント:

• 計算アイテムでのみサポートされています。
• 機能的には PromQL の 'histogram_quantile' に対応します。
• 最後の 'Infinity' バケット（"+inf"）の値が 0 に等しい場合は -1 を返します。

例:

histogram_quantile(0.75,1.0,last(/host/rate_bucket[1.0]),"+Inf",last(/host/rate_bucket[Inf]))
histogram_quantile(0.5,bucket_rate_foreach(//item_key,30s))

item_count(item filter)

フィルター条件に一致する、設定内の既存アイテム数です。
サポートされる値の型: Integer。

パラメータ:

• item filter - アイテム選択の条件です。ホストグループ、ホスト、アイテムキー、タグによる参照が可能です。ワイルドカードをサポートしています。詳細はitem filterを参照してください。
  

コメント:

• 計算アイテムでのみサポートされています。
• count(exists_foreach(item_filter)) 関数のエイリアスとして動作します。

例:

item_count(/*/agent.ping?[group="Host group 1"]) #「Host group 1」内で *agent.ping* アイテムを持つホスト数

kurtosis(/host/key,(sec|#num)<:time shift>)

定義された評価期間内で収集された値の確率分布の「尖度」。詳細は Kurtosis を参照してください。
対応する値の型: Float, Integer。
対応するforeach関数: last_foreach。

パラメータ: 共通パラメータを参照してください。

例:

kurtosis(/host/key,1h) #直近1時間の尖度

mad(/host/key,(sec|#num)<:time shift>)

定義された評価期間内に収集された値の中央値絶対偏差。詳細は中央値絶対偏差を参照してください。
サポートされている値の型: Float, Integer。
サポートされているforeach関数: last_foreach。

パラメータ: 共通パラメータを参照してください。

例:

mad(/host/key,1h) #直近1時間の中央値絶対偏差

max(/host/key,(sec|#num)<:time shift>)

定義された評価期間内のアイテムの最大値。
サポートされている値の型: Float, Integer。
サポートされているforeach関数: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach。

パラメータ: 共通パラメータを参照。

例:

max(/host/key,1h) - min(/host/key,1h) #現在までの直近1時間の最大値と最小値の差分(値のデルタ)を計算する

min(/host/key,(sec|#num)<:time shift>)

定義された評価期間内のアイテムの最小値。
サポートされている値の型: Float, Integer。
サポートされているforeach関数: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach。

パラメータ: 共通パラメータを参照。

例:

max(/host/key,1h) - min(/host/key,1h) #現在までの直近1時間の最大値と最小値の差分を計算する（値のデルタ）

skewness(/host/key,(sec|#num)<:time shift>)

定義された評価期間内で収集された値の確率分布の非対称性。詳細はSkewnessを参照してください。
サポートされる値の型: Float, Integer。
サポートされるforeach関数: last_foreach。

パラメータ: 共通パラメータを参照してください。

例:

skewness(/host/key,1h) #直近1時間の歪度

stddevpop(/host/key,(sec|#num)<:time shift>)

定義された評価期間内に収集された値の母標準偏差。参照: 標準偏差。
サポートされている値の型: Float, Integer。
サポートされているforeach関数: last_foreach。

パラメータ: 共通パラメータを参照してください。

例:

stddevpop(/host/key,1h) #現在までの直近1時間の母標準偏差

stddevsamp(/host/key,(sec|#num)<:time shift>)

定義された評価期間内に収集された値の標本標準偏差。参照: 標準偏差。
サポートされている値の型: Float, Integer。
サポートされているforeach関数: last_foreach。

パラメータ: 共通パラメータを参照。

この関数が動作するには、少なくとも2つのデータ値が必要です。

例:

stddevsamp(/host/key,1h) #直近1時間の標本標準偏差

sum(/host/key,(sec|#num)<:time shift>)

定義された評価期間内に収集された値の合計。
サポートされている値の型: Float, Integer。
サポートされているforeach関数: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach。

パラメータ: 共通パラメータを参照。

例:

sum(/host/key,1h) #直近1時間の値の合計

sumofsquares(/host/key,(sec|#num)<:time shift>)

定義された評価期間内に収集された値の二乗和。
サポートされている値の型: Float, Integer。
サポートされているforeach関数: last_foreach。

パラメータ: 共通パラメータを参照。

例:

sumofsquares(/host/key,1h) #現在までの直近1時間の二乗和

varpop(/host/key,(sec|#num)<:time shift>)

定義された評価期間内に収集された値の母分散。分散も参照してください。
サポートされている値の型: Float, Integer。
サポートされているforeach関数: last_foreach。

パラメータ: 共通パラメータを参照してください。

例:

varpop(/host/key,1h) #現在までの直近1時間の母分散

varsamp(/host/key,(sec|#num)<:time shift>)

定義された評価期間内に収集された値の標本分散。詳細は分散を参照してください。
サポートされる値の型: Float, Integer。
サポートされるforeach関数: last_foreach。

パラメータ: 共通パラメータを参照してください。

この関数を動作させるには、少なくとも2つのデータ値が必要です。

例:

varsamp(/host/key,1h) #現在までの直近1時間の標本分散

サポートされているすべての関数を参照してください。