Documentation
1 集計関数
特に明記されていない限り、ここにリストされているすべての機能は次の言語でサポートされています。
集計関数は次のいずれかで機能します。
- アイテムの履歴。例:
min(/host/key,1h) - foreach 関数 のパラメータ。例:
min(last_foreach(/*/key))
関数パラメーターに関する一般的な注意事項。
- 関数パラメータはコンマで区切られます。
- オプションの関数パラメーター (またはパラメーター部分) は
<>で示されます - 機能固有のパラメーターは、各機能で説明されています
/host/keyと(sec|#num)<:time shift>はパラメータを引用符で囲んではいけません
共通パラメータ
/host/keyはホストアイテムの履歴を参照する関数の一般的なパラメーターの一つ目です。必須です。(sec|#num)<:time shift>は、ホストのアイテム履歴を参照する関数の一般的なパラメーターの二つ目です。
関数の詳細
関数のパラメータに関する一般的な注意事項:
- 関数のパラメータはカンマで区切ります。
- オプションの関数パラメータ（またはパラメータ部分）は、
<>で示されます。 - 関数固有のパラメータは、各関数で説明されています。
/host/keyおよび(sec|#num)<:timeshift>パラメータは引用符で囲んではいけません。
avg(/host/key,(sec|#num)<:time shift>)
定義された評価期間内のアイテムの平均値
サポートされる値の型: Float、Integer
サポートされる foreach 関数: avg_foreach、count_foreach、exists_foreach、last_foreach、max_foreach、min_foreach、sum_foreach
パラメーター: 共通パラメーター を参照してください。
時間シフトは、現在の平均値と少し前の平均値を比較する必要がある場合に便利です。
例:
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は追加パラメーターをサポートしていることに注意してください。
- アイテムフィルター - アイテムフィルター を参照してください。
- 期間 - 期間 を参照してください。
- 演算子 (二重引用符で囲む必要があります)。サポートされている
operator:
eq - 等しい
ne - 等しくない
gt - 大きい
ge - 以上
lt - 小さい
le - 以下
like - パターンを含む場合に一致（大文字と小文字を区別）
bitand - ビット単位のAND
regexp -patternで指定された正規表現と大文字と小文字を区別して一致
iregexp -patternで指定された正規表現と大文字と小文字を区別せずに一致 - pattern - 必要なパターン（文字列引数は二重引用符で囲む必要があります）。3番目のパラメータに operator が指定されている場合にサポートされます。
コメント:
- count() を履歴関連の foreach 関数（max_foreach、avg_foreach など）で使用するとパフォーマンスに影響する可能性がありますが、設定データのみで機能する 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パラメータには通常の正規表現またはグローバル（'@'で始まる）正規表現を指定できます。グローバル正規表現の場合、大文字と小文字の区別はグローバル正規表現設定から継承されます。正規表現マッチングのため、浮動小数点値は常に「.」の後に4桁の小数点以下で表されます。また、大きな数値の場合、10進数（データベースに保存される）と2進数（Zabbixサーバーで使用される）の表現の違いが、4桁目の小数点以下の桁数に影響を与える可能性があることに注意してください。
例:
count(max_foreach(/*/net.if.in[*],1h)) #過去1時間から現在までにデータを受信したnet.if.inアイテムの数
count(last_foreach(/*/vfs.fs.dependent.size[*,pused]),"gt",95) #ディスク使用率が95%を超えているファイルシステムの数histogram_quantile(quantile,bucket1,value1,bucket2,value2,...)
ヒストグラムのバケットからφ-分位点を計算します。
サポートされている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)) 関数のエイリアスとして機能します。
例:
kurtosis(/host/key,(sec|#num)<:timeshift>)
定義された評価期間内に収集された値の確率分布の"裾野度"。Kurtosis も参照してください。
サポートされている値の型: Float、Integer
サポートされている foreach 関数: last_foreach
パラメータ: 共通パラメータ を参照してください。
例:
mad(/host/key,(sec|#num)<:timeshift>)
定義された評価期間内に収集された値の絶対偏差の中央値 絶対偏差の中央値も参照してください。
サポートされている値の型: Float、Integer
サポートされているforeach関数: last_foreach
パラメーター: 共通パラメーターを参照してください。
例:
max(/host/key,(sec|#num)<:timeshift>)
定義された評価期間内における項目の最高値
サポートされる値の型: Float、Integer
サポートされる foreach 関数: avg_foreach、count_foreach、exists_foreach、last_foreach、max_foreach、min_foreach、sum_foreach
パラメーター: 共通パラメーター を参照してください。
例:
min(/host/key,(sec|#num)<:timeshift>)
定義された評価期間内における項目の最小値
サポートされる値の型: Float、Integer
サポートされる foreach 関数: avg_foreach、count_foreach、exists_foreach、last_foreach、max_foreach、min_foreach、sum_foreach
パラメーター: 共通パラメーター を参照してください。
例:
skewness(/host/key,(sec|#num)<:timeshift>)
定義された評価期間内に収集された値の確率分布の非対称性。Skewness も参照してください。
サポートされている値の型: Float、Integer
サポートされている foreach 関数: last_foreach
パラメーター: 共通パラメーター を参照してください。
例:
stddevpop(/host/key,(sec|#num)<:timeshift>)
定義された評価期間内に収集された値の母標準偏差。標準偏差も参照してください。
サポートされている値の型: Float、Integer
サポートされているforeach関数: last_foreach
パラメーター: 共通パラメーターを参照してください。
例:
stddevsamp(/host/key,(sec|#num)<:timeshift>)
定義された評価期間内に収集された値の標本標準偏差。標準偏差も参照してください。
サポートされている値の型: Float、Integer
サポートされているforeach関数: last_foreach
パラメーター: 共通パラメーターを参照してください。
この関数が動作するには、少なくとも2つのデータ値が必要です。
例:
sum(/host/key,(sec|#num)<:timeshift>)
定義された評価期間内に収集された値の合計
サポートされる値の型: Float、Integer
サポートされる foreach 関数: avg_foreach、count_foreach、exists_foreach、last_foreach、max_foreach、min_foreach、sum_foreach
パラメーター: 共通パラメーター を参照してください。
例:
sumofsquares(/host/key,(sec|#num)<:timeshift>)
定義された評価期間内に収集された値の平方和
サポートされる値の型: Float、Integer
サポートされるforeach関数: last_foreach
パラメーター: 共通パラメーターを参照してください。
例:
varpop(/host/key,(sec|#num)<:timeshift>)
定義された評価期間内に収集された値の母分散。分散も参照してください。
サポートされている値の型: Float、Integer
サポートされているforeach関数: last_foreach
パラメーター: 共通パラメーターを参照してください。
例:
varsamp(/host/key,(sec|#num)<:timeshift>)
定義された評価期間内に収集された値の標本分散。分散も参照してください。
サポートされている値の型: Float、Integer
サポートされているforeach関数: last_foreach
パラメーター: 共通パラメーターを参照してください。
この関数が動作するには、少なくとも2つのデータ値が必要です。
例:
サポートされているすべての関数を参照してください。