1 集計関数
特に明記されていない限り、ここに記載されているすべての関数は以下でサポートされています:
集計関数は以下のいずれかで動作します:
- アイテムの履歴、例:
min(/host/key,1h) - foreach関数を唯一のパラメータとして、例:
min(last_foreach(/*/key))（計算アイテムのみ; トリガーでは使用不可）
関数は追加情報なしでリストされています。関数をクリックすると詳細が表示されます。
| 関数 | 説明 |
|---|---|
| avg | 指定した評価期間内のアイテムの平均値。 |
| bucket_percentile | ヒストグラムのバケットからパーセンタイルを計算します。 |
| count | foreach関数によって返された配列内の値の数。 |
| histogram_quantile | ヒストグラムのバケットからφ分位数を計算します。 |
| item_count | フィルター条件に一致する設定済みアイテムの数。 |
| kurtosis | 指定した評価期間内に収集された値の確率分布の「尖度」。 |
| mad | 指定した評価期間内に収集された値の中央値絶対偏差。 |
| max | 指定した評価期間内のアイテムの最大値。 |
| min | 指定した評価期間内のアイテムの最小値。 |
| skewness | 指定した評価期間内に収集された値の確率分布の非対称性。 |
| stddevpop | 指定した評価期間内に収集された値の母標準偏差。 |
| stddevsamp | 指定した評価期間内に収集された値の標本標準偏差。 |
| sum | 指定した評価期間内に収集された値の合計。 |
| sumofsquares | 指定した評価期間内に収集された値の二乗和。 |
| varpop | 指定した評価期間内に収集された値の母分散。 |
| varsamp | 指定した評価期間内に収集された値の標本分散。 |
共通パラメータ
/host/keyは、ホストのアイテム履歴を参照する関数に共通する必須の第1パラメータです(sec|#num)<:time shift>は、ホストのアイテム履歴を参照する関数に共通する第2パラメータで、以下を意味します:
関数の詳細
関数パラメータに関する一般的な注意事項:
- 関数パラメータはカンマで区切ります
- オプションの関数パラメータ（またはパラメータの一部）は
<>で示されます - 関数固有のパラメータは各関数で説明されています
/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個の値の平均値
avg(/host/proc.num,5m)>300 #直近5分間のプロセス数の平均が300を超えている場合のトリガー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))のエイリアスです。
例:
bucket_percentile(/*/http_request_duration_seconds_bucket[*],5m,95) #5分間の95パーセンタイル応答時間を計算
bucket_percentile(/*/apiserver_request_duration_seconds_bucket[*],10m,99) #99パーセンタイルのAPIレイテンシを計算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 - 必要なパターン（文字列引数は二重引用符で囲む必要があります）。operatorが3番目のパラメータとして指定されている場合にサポートされます。
コメント:
- 履歴関連のforeach関数（max_foreach、avg_foreachなど）でcount()を使用すると、パフォーマンスに影響する可能性があります。一方、設定データのみを扱うexists_foreach()を使用した場合、そのような影響はありません。
- オプションのパラメータoperatorまたはpatternは、カンマの後に空のまま残すことはできず、完全に省略する必要があります。
- 3番目のパラメータとしてbitandを使用する場合、4番目の
patternパラメータは、'/'で区切られた2つの数値として指定できます: 比較値/マスク。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サーバーで使用）の違いにより、小数点以下4桁目に影響する場合があることにも注意してください。
例:
count(max_foreach(/*/net.if.in[*],1h)) #calculate the number of net.if.in items that received data in the last hour until now
count(last_foreach(/*/vfs.fs.size[*,pused]),"gt",95) #calculate the number of file systems with over 95% of disk space usedhistogram_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/system.cpu.util[,user],5m)>5 #5分間のCPU使用率の急激なスパイクでトリガーmad(/host/key,(sec|#num)<:time shift>)
定義された評価期間内に収集された値の中央値絶対偏差です。参照: 中央値絶対偏差。
サポートされる値の型: Float, Integer。
サポートされるforeach関数: last_foreach。
パラメータ: 共通パラメータを参照してください。
例:
last(/host/system.cpu.util[,user])>avg(/host/system.cpu.util[,user],1h)+3*mad(/host/system.cpu.util[,user],1h) #最後のCPU使用率の値が統計的に有意な場合にトリガー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時間における最大値と最小値の差を計算
max(last_foreach(/*/vfs.fs.size[*,pused]?[group="Linux servers"])) #すべてのLinuxサーバーにおけるディスク使用率の最大値を返す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時間における最大値と最小値の差を計算します（値の差分）
min(last_foreach(/*/vfs.file.contents["/sys/class/net/enp0s3/operstate"]?[group="Linux servers"])) #すべてのLinuxサーバーにまたがる任意のインターフェースの最小の稼働状態を返しますskewness(/host/key,(sec|#num)<:time shift>)
定義された評価期間内に収集された値における確率分布の非対称性です。参照: Skewness。
サポートされる値の型: Float, Integer。
サポートされるforeach関数: last_foreach。
パラメータ: 共通パラメータを参照してください。
例:
skewness(/host/vm.memory.size[used],5m)<-20 #trigger on sudden negative drops indicating crashes/restartsstddevpop(/host/key,(sec|#num)<:time shift>)
定義された評価期間内に収集された値の母標準偏差です。参照: 標準偏差。
サポートされる値の型: Float, Integer。
サポートされるforeach関数: last_foreach。
パラメータ: 共通パラメータを参照してください。
例:
stddevpop(/host/system.cpu.util[,user],10m)>7 #CPU使用率の変動が大きい場合にトリガー（10分間の母標準偏差が7を超える）stddevsamp(/host/key,(sec|#num)<:time shift>)
定義された評価期間内に収集された値の標本標準偏差です。関連項目: 標準偏差。
サポートされる値の型: Float, Integer。
サポートされるforeach関数: last_foreach。
パラメータ: 共通パラメータを参照してください。
この関数が動作するには、少なくとも2つのデータ値が必要です。
例:
stddevsamp(/host/system.cpu.util[,user],10m)>7 #CPU使用率の変動が大きい場合のトリガー（10分間の標本標準偏差が7を超える）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(last_foreach(/*/net.if.in[*]?[group="Linux servers"])) #Linux servers内のすべてのホストにおける受信ネットワークトラフィックの最新値の合計sumofsquares(/host/key,(sec|#num)<:time shift>)
定義された評価期間内に収集された値の二乗和です。
サポートされる値の型: Float, Integer。
サポートされるforeach関数: last_foreach。
パラメータ: 共通パラメータを参照してください。
例:
sumofsquares(/host/calculated.net.if.rate,1m) #ネットワークトラフィック率（受信と送信）の二乗和
sumofsquares(last_foreach(/*/net.if.in[*]?[group="Linux servers"])) #すべてのLinuxサーバーにおける最新の受信ネットワークトラフィック値の二乗和varpop(/host/key,(sec|#num)<:time shift>)
定義された評価期間内に収集された値の母分散です。あわせて参照: 分散。
サポートされる値の型: Float, Integer。
サポートされるforeach関数: last_foreach。
パラメータ: 共通パラメータを参照してください。
例:
varpop(/host/system.cpu.util[,user],10m)>50 #CPU使用率の変動が大きい場合のトリガー（10分間の分散が50を超える）varsamp(/host/key,(sec|#num)<:time shift>)
定義された評価期間内に収集された値の標本分散です。以下も参照してください: Variance。
サポートされる値の型: Float, Integer。
サポートされるforeach関数: last_foreach。
パラメータ: 共通パラメータを参照してください。
この関数が動作するには、少なくとも2つのデータ値が必要です。
例:
varsamp(/host/system.cpu.util[,user],10m)>50 #trigger if CPU usage fluctuates heavily (sample variance is above 50 over 10 minutes)サポートされているすべての関数を参照してください。