3 保存前処理の例

概要

このセクションでは、保存前処理のステップを使用していくつかの実用的なタスクを実行する例を紹介します。

VMwareイベントログレコードのフィルタリング

この例では、正規表現に一致前処理ステップを使用して、VMwareイベントログから不要なイベントをフィルタリングします。

1. 稼働中のVMware Hypervisorホストで、vmware.eventlogアイテムが存在し、正常に動作していることを確認します。
ホスト作成時にVMwareテンプレートがリンクされている場合、イベントログアイテムはすでにハイパーバイザー上に存在している可能性があることに注意してください。

2. VMware Hypervisorホストで、ログ型の依存アイテムを作成し、イベントログアイテムをそのマスターアイテムとして設定します。

3. 依存アイテムの前処理タブで、追加をクリックして前処理ステップを作成し、ドロップダウンから正規表現に一致を選択します。次に、以下のいずれかのパターンを指定します。

• すべてのログイベントをフィルタリングする場合:

.* logged in .*

• "User" の後にあるユーザー名を含む行をフィルタリングする場合:

\bUser\s+\K\S+

または、正規表現前処理ステップを使用して、一致するグループを抽出し、出力を制御することもできます。

• "logged in" を含むログイベント全体を抽出して出力するには、次のパラメータを指定します。

Pattern: .*logged in.*
Output: \0

• "User" に続くユーザー名を抽出して出力するには、次のように指定します。

Pattern: User (.*?)(?=\ )
Output: \1

取得した値の型の確認

この例では、取得したアイテムの値の型が数値であるかどうかを確認するために、カスタム乗数 の前処理ステップを使用します。

アイテムの Preprocessing タブで、Custom multiplier 前処理ステップを選択し、次のパラメータを指定します（取得した値に 1 を乗算します）。

1

サポートされていない値のチェック

この例では、サポートされていない値のチェック前処理ステップを使用して、アイテム値が取得できなかったかどうかを確認します。

Zabbixサーバー/プロキシポーラープロセスがアイテム値の収集を試みる際に、次のような結果が返される可能性があります。

• 有効な結果を返す。
• 最初は有効に見えても、後でサポート対象外になる可能性がある結果を返す（例：前処理後の値の型の不一致により）
• 値の収集エラーを返し、アイテムがサポート対象外になる。一般的な原因は次のとおりです。
• 不明なアイテムキー（Zabbixエージェント、シンプルチェック、またはZabbix内部アイテム）
• 不明なOID（SNMPエージェント）、不明なセンサー（IPMIエージェント）、またはJMXメトリックなし（JMXエージェント）
• トラップファイルを読み取れない（SNMPトラップ）
• スクリプトが見つからない（外部チェック）
• そのようなURLがない（HTTPエージェント、ブラウザ）
• ログインに失敗した（SSHエージェント、TELNETエージェント）
• 無効な数式構文（計算）、JavaScript構文エラー（スクリプト）、または無効なSQL（データベースモニター）

アイテム値の収集エラーを検出して処理するには、サポートされていない値をチェック 前処理ステップを使用できます。

このステップは常に最初に実行され、前処理開始前に発生したエラーのみを検出することに注意してください。

アイテムの 前処理 タブで、 サポートされていない値をチェック 前処理ステップを選択し、以下のいずれかのパラメータを指定します。

• すべてのエラーの場合:

Parameter: any error

• "接続できません"を含むエラーの場合:

Parameter: error matches
Pattern: (?i)cannot connect

次に、失敗時にカスタムオプションを使用して、値（この場合はエラー）を破棄するか、カスタム値を設定するか、カスタムエラーメッセージを返します。 破棄 された値はデータベースに保存されないため、トリガーは評価されず、トレンドデータも生成されませんのでご注意ください。