1 保存前処理のテスト

テスト

前処理ステップのテストは、複雑な前処理パイプラインが、アイテム値の受信と前処理を待つことなく、期待どおりの結果を生成することを確認するのに役立ちます。

以下のテストが可能です。

• 仮想的な値に対するテスト
• ホストからの実際の値に対するテスト

各前処理ステップは個別にテストすることも、すべてのステップをまとめてテストすることもできます。アクションブロックのテストまたはすべてのステップをテストボタンをクリックすると、テストウィンドウが開きます。

仮想値のテスト

パラメーター	説明
ホストから値を取得	仮想値をテストする場合は、このチェックボックスをオフにしてください。 関連項目: 実際の値のテスト。
値	テストする入力値を入力します。 パラメーターフィールドまたは表示/編集ボタン をクリックすると、値またはコードブロックを入力するためのテキストエリアウィンドウが開きます。
サポートされていません	サポートされていない値をテストするには、このチェックボックスをオンにします。 このオプションは、サポートされていない値の確認前処理ステップをテストするのに便利です。
エラー	エラーテキストを入力します。 このフィールドは、ホストから値を取得のチェックが外れていて、サポートされていませんがチェックされている場合に有効になります。 ホストから値を取得がチェックされている場合、このフィールドにはホストからの実際のエラーメッセージ（読み取り専用）が入力されます。
時刻	入力値の時刻が表示されます: now (読み取り専用)。
前の値	比較する前の入力値を入力します。 変更および調整前処理ステップのみ。
前回の時刻	比較対象となる前回の入力値の時刻を入力します。 変更およびスロットルの前処理手順でのみ使用できます。 デフォルト値は、項目の '更新間隔' フィールドの値に基づきます（'1分'の場合、このフィールドにはnow-1分が入力されます）何も指定されていない場合、またはユーザーがホストにアクセスできない場合は、デフォルト値はnow-30sです。
マクロ	マクロが使用されている場合は、マクロとその値が表示されます。値はテスト目的で編集可能ですが、変更はテストコンテキスト内でのみ保存されます。
行末シーケンス	複数行の入力値の行末シーケンスを選択します。 LF - LF（改行）シーケンス CRLF - CRLF（復帰改行）シーケンス。
前処理手順	前処理手順が表示されます。 テストボタンをクリックすると、各ステップのテスト結果が表示されます。 テスト結果は、フロントエンドに送信される際に最大512KBのサイズに切り詰められます。結果が切り詰められた場合は、警告アイコンが表示されます。警告の説明はマウスオーバー時に表示されます。512KBを超えるデータも、Zabbixサーバーによって完全に処理されることに注意してください。 ステップがテストに失敗した場合は、エラーアイコンが表示されます。エラーの説明はマウスオーバー時に表示されます。 ステップに"失敗時にカスタム"が指定され、そのアクションが実行された場合、前処理テストステップの行の直後に新しい行が表示され、実行されたアクションとその結果（エラーまたは値）が表示されます。

各前処理ステップ後の結果を確認するには、テストをクリックしてください。

テスト値は、個々のステップまたはすべてのステップのテストセッション間で保存されるため、ユーザーは前処理ステップまたはアイテムの設定を変更した後、情報を再入力することなくテストウィンドウに戻ることができます。ただし、ページを更新すると値は失われます。

テストはZabbixサーバーによって実行されます。フロントエンドは対応するリクエストをサーバーに送信し、結果を待機します。リクエストには、入力値と前処理ステップ（拡張ユーザーマクロを含む）が含まれます。変更ステップとスロットリングステップでは、オプションで以前の値と時刻を指定できます。サーバーは各前処理ステップの結果を応答します。

すべての技術的エラーまたは入力検証エラーは、テストウィンドウ上部のエラーボックスに表示されます。

実数値のテスト

実数値に対して前処理をテストするには、以下の手順に従います。

• ホストから値を取得 チェックボックスをオンにします。
• ホストパラメータ（ホストアドレス、ポート、プロキシ名/プロキシ番号）とアイテム固有の詳細（SNMPv2コミュニティやSNMPv3セキュリティ認証情報など）を入力または確認します。これらのフィールドはコンテキストに応じて異なります。
  • 可能な場合、つまりエージェントを必要とするアイテムの場合は、ホストの選択されたエージェントインターフェースから情報を取得して、値が事前に入力されます。
  • テンプレートアイテムの場合は、値を手動で入力する必要があります。
  • プレーンテキストのマクロ値は解決されます。
  • フィールド値（または値の一部）がシークレットマクロまたはVaultマクロの場合、フィールドは空になり、手動で入力する必要があります。アイテムパラメータにシークレットマクロ値が含まれている場合、次の警告メッセージが表示されます。"アイテムにはシークレット値を持つユーザー定義マクロが含まれています。これらのマクロの値は手動で入力する必要があります。"
  • アイテムタイプで不要なフィールドは無効になります（例：計算アイテムではホストアドレスとプロキシフィールドは無効になります）。
• 前処理をテストするには、値を取得してテスト をクリックします。

アイテム設定フォーム（'値を表示' フィールド）で値のマッピングを指定した場合、アイテムテストダイアログには最終結果の後に「'マップを適用した結果'という別の行が表示されます。

ホストから実際の値を取得するためのパラメーター：

パラメーター	説明
ホストから値を取得	ホストから実際の値を取得するには、このチェックボックスをオンにします。
ホストアドレス	ホストアドレスを入力します。 このフィールドには、アイテムホストインターフェースのアドレスが自動的に入力されます。
ポート	ホストポートを入力します。 このフィールドには、アイテムホストインターフェースのポートが自動的に入力されます。
SNMPインターフェースの追加フィールド (SNMPバージョン、SNMPコミュニティ、コンテキスト名など)	SNMPインターフェース(v1、v2、v3)の設定に関する詳細は、SNMP監視の設定を参照してください。 これらのフィールドには、アイテムホストインターフェースから自動的に入力されます。
プロキシ	ホストがプロキシによって監視されている場合は、プロキシを指定します。 このフィールドには、ホストのプロキシ(存在する場合)が自動的に入力されます。
値	ホストから取得した値です。 パラメータフィールドまたは表示/編集ボタン をクリックすると、値またはコードブロックのテキストエリアウィンドウが開きます。 値はフロントエンドでのみ、最大512KBのサイズに切り捨てられます。結果が切り捨てられた場合は、警告アイコンが表示されます。マウスオーバーすると警告の説明が表示されます。512KBを超えるデータも、Zabbixサーバーによって完全に処理されることに注意してください。

その他のパラメータについては、上記の仮説値のテストを参照してください。