Zabbix Documentation 2.0

2.23.03.23.4In development:4.0Unsupported versions:1.82.02.4

User Tools

Site Tools

This translation is older than the original page and might be outdated. See what has changed.

Sidebar

jp:manual:appendix:triggers:functions

1 サポートされているトリガー関数

トリガー条件式の中でサポートされているすべての関数を、次に示します:

関数 パラメータ サポートされている値のデータ型
説明
abschange 無視 浮動小数、整数、文字列、テキスト、ログ
直近とその1つ前の値の差を、絶対値で返します。
文字列の場合は、以下の値を返します:
0 - 値が等しい
1 - 値が異なる
avg 秒数または回数 浮動小数、整数
期間の平均値。最初のパラメータで期間を秒単位で設定するか、収集した値の数(ハッシュマーク#を先頭につけます。例えば#5 - 直近5回)で設定します。\\関数は2番目の省略可能なパラメータtime_shiftを使用できます。現在の平均値と、time_shift秒遡った平均値を比較する必要がある場合に便利です。たとえば、avg(3600,86400)は1日前の1時間の平均値を返します。パラメータtime_shiftはZabbix 1.8.2以降でサポートされています。
change 無視 浮動小数、整数、文字列、テキスト、ログ
最新値と前回値の差を返します。
文字列の場合は、以下の値を返します:
0 - 値が等しいl
1 - 値が異なる
count 秒数または回数 浮動小数、整数、文字列、テキスト、ログ
期間内に収集された値の数. 最初のパラメータで期間を秒単位で設定するか、収集した値の数(ハッシュマーク#を先頭につけます。)で設定します。
関数は、2番目の省略可能なパラメータpattern、3番目のパラメータoperation、4番目のパラメータtime_shiftを利用できます。
pattern:整数アイテム - 正確に一致;浮動小数: 値が±0.00001の許容範囲内にあれば一致\\サポートされている演算子 *:
eq - 等しい
ne - 等しくない
gt - より大きい
ge - 以上
lt - 未満
le - 以下
like (テキスト検索のみ) - 値にパターンが含まれれば一致とみなします。
*整数アイテムと浮動小数アイテム:演算子 eq(デフォルト)、ne、gt、ge、lt、le がサポートされています。
*文字列アイテム、テキストアイテム、ログアイテム: like(デフォルト)、eq、ne がサポートされています。

count(600) - 直近600秒の間にヒストリに保存されている値の数
count(600,12) - ヒストリに保存されている値のうち「12」の出現回数を返します。
count(600,12,"gt") - 直近600秒の間にヒストリに保存されている値のうち「12」よりも大きい値の正確な出現回数を返します。
count(#10,12,"gt") - 直近10個の値のうち「12」よりも大きい値の正確な出現回数を返します。
count(600,12,"gt",86400) - 24時間前にヒストリに保存されている直近10個の値のうち「12」よりも大きい値の正確な出現回数を返します。
count(600,,,86400) - 24時間前の直近600秒の値の数を返します。
#numパラメータと文字列の演算子は、Zabbix 1.8.2以降でサポートされています。
time_shift パラメータと文字列の演算子は、Zabbix 1.8.2以降でサポートされています。 time_shift の使用例については、avg() 関数を参照してください。
date 無視 すべて
現在日付をYYYYMMDD形式で返します。
例: 20031025
dayofmonth 無視 すべて
1~31日までの日付を返します。
この機能はZabbix 1.8.5からサポートされています。
dayofweek 無視 すべて
曜日を1(月曜日)から7(日曜日)までの範囲で返します。月曜 - 1、日曜 - 7.
delta 秒数または回数 浮動小数、整数
期間内の最大値と最小値の差分を返します。( max()-min() と同じ値)最初のパラメータで期間を秒単位で設定するか、収集した値の数(ハッシュマーク#を先頭につけます)で設定します。
Zabbix 1.8.2以降では、2番目の省略可能なパラメータ time_shift がサポートされています。使用例については関数 avg () を参照してください。
diff 無視 浮動小数、整数、文字列、テキスト、ログ
以下の値を返します:
1 - 最新値と前回値が異なる
0 - それ以外
fuzzytime sec 浮動小数、整数
タイムスタンプ(アイテムの値)とZabbixサーバ時刻の差が N 秒以内なら1、それ以外なら0を返します。
通常は system.localtime と組み合わせて、ローカル時刻とZabbixサーバのローカル時刻が同期しているかどうかをチェックします。
iregexp 1番目 - 文字列、2番目 - 秒数または回数 文字列、ログ、テキスト
この関数はregexpに類似していますが、大文字と小文字は区別されません。
last 秒数または回数 浮動小数、整数、文字列、ログ、テキスト
最新値を返します。以下のパラメータを使用します:
秒数 - 無視
#回数 - N番目の値
ここでの#回数は、他の関数とは違った働きをすることを覚えておいておいてください。
例えば:
last(0) 常にlast(#1)と等しい
last(#3) - 3番目に新しい値(3つの新しい値ではありません)
また、関数は2番目の省略可能なパラメータtime_shiftを受け入れます。例えば:
last(0,86400) )は1日前の直近の値を返します。
ヒストリの1秒以内に2つ以上の値が存在する場合、値の正確な順序は保証されません。\\パラメータ #回数 は、Zabbix 1.6.2 以降でサポートされています。
パラメータ time_shift は、Zabbix 1.8.2以降でサポートされています。 使用例については関数avg()を参照してください。
logeventid 文字列 ログ
最新のログのエントリのイベントIDが、指定した正規表現に一致するかどうかをチェックします。パラメータでPOSIX形式の正規表現を定義します。
以下の値を返します:
0 - 一致しない
1 - 一致する
この関数は、Zabbix 1.8.5以降でサポートされています。
logseverity 無視 log
最終ログエントリの深刻度を返します。パラメータは無視されます。
0 - デフォルトの深刻度
N - 深刻度(整数、Windowsイベントログの場合に有効)。ZabbixはWindowsイベントログのフィールド情報からログの深刻度を取得します。
logsource 文字列 ログ
最終ログエントリの「ソース」がパラメータと一致するかどうかをチェックします。
0 - 一致しない
1 - 一致する
通常は、Windowsイベントログのチェックに使用します。例: logsource(“VMWare Server”)
max 秒数または回数 浮動小数、整数
期間内の最大値を返します。最初のパラメータで期間を秒単位で設定するか、収集した値の数(ハッシュマーク#を先頭につけます)で設定します。
Zabbix 1.8.2以降では、2番目の省略可能なパラメータ time_shift がサポートされています。使用例については関数avg()を参照してください。
min 秒数または回数 浮動小数、整数
期間内の最小値を返します。最初のパラメータで期間を秒単位で設定するか、収集した値の数(ハッシュマーク#を先頭につけます)で設定します。
Zabbix 1.8.2以降では、2番目の省略可能なパラメータ time_shift がサポートされています。使用例については関数avg()を参照してください。
nodata 秒数 すべて
以下の値を返します:
1 - 期間内(秒単位)にデータを1つも受信しない場合。期間として30秒以上の値を指定する必要があります。
0 - それ以外
now 無視 すべて
エポック(1970年1月1日00時00分00秒UTC)を起点とした経過秒数を返します。
prev 無視 浮動小数、整数、文字列、テキスト、ログ
前回値を返します。パラメータは無視されます。
last(#2)と同じ
regexp 1番目 - 文字列, 2番目 - 秒数または#回数 文字列、ログ、テキスト
最新値が正規表現と一致するかどうかをチェックします。パラメータにはPOSIX形式の正規表現を指定します。
省略可能な2番目のパラメータでは、分析する秒数または行数を指定します。この場合、複数の値が処理されます。
この関数では大文字と小文字は区別されます。
以下の値を返します:
1 - 見つかった
0 - それ以外
str 1番目 - 文字列, 2番目 - 秒数または#回数 文字列、ログ、テキスト
最新値で文字列を検索します。パラメータには検索する文字列を指定します。大文字と小文字は区別されます。
省略可能な2番目のパラメータでは、分析する秒数または行数を指定します。この場合、複数の値が処理されます。
以下の値を返します:
1 - 見つかった
0 - それ以外
strlen 秒数または回数 文字列、ログ、テキスト
最新の値の長さを文字数で返します。(バイト数ではありません)
パラメータはlast関数と同じように機能します。(この表の上の方を参照してください)
例:
strlen(0) - strlen(#1) と同じです。
strlen(#3) - 直近3番目の値の長さ
strlen(0,86400) - 1日前の直近の値の長さ
この関数は、Zabbix 1.8.4以降でサポートされています。
sum 秒数または回数 浮動小数、整数
期間内の値の合計値を返します。最初のパラメータで期間を秒単位で設定するか、収集した値の数(ハッシュマーク#を先頭につけます)で設定します。
Zabbix 1.8.2以降では、2番目の省略可能なパラメータ time_shift がサポートされています。使用例については関数avg()を参照してください。
time 無視 すべて
現在の時刻をHHMMSS形式で返します。例:123055

1)すべての関数は、数値型の値のみを返します。例えば、文字列との比較はサポートされていません。
2)いくつかの関数は非数字型のパラメータでは使用できません。
3)文字列の変数は二重引用符で囲みます。そうしないと、誤って解釈される可能性があります。


本ページは2013/06/02時点の原文を基にしておりますので、内容は必ずしも最新のものとは限りません。
最新の情報は右上の「Translations of this page」から英語版を参照してください。