1 保存前処理のテスト

テスト

前処理ステップのテストは、複雑な前処理パイプラインが期待どおりの結果を返すことを確認するのに役立ちます。これにより、アイテムの値が受信されて前処理されるのを待たずに済みます。

テストできる内容は次のとおりです。

  • 仮想的な値に対して
  • ホストからの実際の値に対して

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

仮想値のテスト

Parameter Description
Get value from host 仮想値をテストしたい場合は、このチェックボックスをオフのままにします。
参照: 実値のテスト。
Value テストする入力値を入力します。
パラメータ欄または表示/編集ボタン をクリックすると、値またはコードブロックを入力するためのテキストエリアウィンドウが開きます。
Not supported サポートされていない値をテストする場合は、このチェックボックスをオンにします。
このオプションは、サポートされていない値の確認 の前処理ステップをテストする際に便利です。
Error エラーテキストを入力します。
このフィールドは、Get value from host がオフで、かつ Not supported がオンの場合に有効になります。
Get value from host がオンの場合、このフィールドにはホストからの実際のエラーメッセージが入力されます（読み取り専用）。
Time 入力値の時刻が表示されます: now（読み取り専用）。
Previous value 比較対象となる前回の入力値を入力します。
Change および Throttling の前処理ステップでのみ使用します。
Previous time 比較対象となる前回の入力値の時刻を入力します。
Change および Throttling の前処理ステップでのみ使用します。
デフォルト値は、アイテムの 'Update interval' フィールドの値に基づきます（'1m' の場合、このフィールドには now-1m が入力されます）。何も指定されていない場合、またはユーザーがホストへのアクセス権を持たない場合、デフォルトは now-30s です。
Macros マクロが使用されている場合は、その値とともに一覧表示されます。値はテスト用に編集できますが、変更はテストのコンテキスト内でのみ保存されます。
End of line sequence 複数行の入力値に対する行末シーケンスを選択します:
LF - LF（改行）シーケンス
CRLF - CRLF（キャリッジリターン+改行）シーケンス。
Preprocessing steps 前処理ステップが一覧表示されます。Test ボタンをクリックすると、各ステップのテスト結果が表示されます。
テスト結果は Webインターフェース に送信される際、最大 512KB に切り詰められます。テスト結果は（切り詰められた 512KB を超えない範囲で）コピーできます。結果が切り詰められた場合は、警告アイコンが表示されます。警告の説明はマウスオーバーで表示されます。512KB を超えるデータも Zabbix サーバー によって完全に処理される点に注意してください。
ステップのテストに失敗した場合は、エラーアイコンが表示されます。エラーの説明はマウスオーバーで表示されます。
ステップに対して "Custom on fail" が指定され、そのアクションが実行された場合は、前処理テストステップ行の直後に新しい行が表示され、実行されたアクションとその結果（エラーまたは値）が示されます。
Result すべてのステップをまとめてテストした場合（Test all steps ボタンをクリックした場合）、前処理ステップの最終結果がすべてのケースで表示されます。
アイテムの値の型への変換タイプも表示されます。たとえば Result converted to Numeric (unsigned) のように表示されます。
テスト結果は Webインターフェース に送信される際、最大 512KB に切り詰められます。最終結果は（切り詰められた 512KB を超えない範囲で）コピーできます。結果が切り詰められた場合は、警告アイコンが表示されます。警告の説明はマウスオーバーで表示されます。512KB を超えるデータも Zabbix サーバー によって完全に処理される点に注意してください。

各前処理ステップの後の結果を表示するには、Test をクリックします。

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

テストは Zabbix サーバー によって実行されます。Webインターフェース は対応するリクエストをサーバー に送信し、結果を待機します。リクエストには入力値と前処理ステップ（展開済みのユーザーマクロを含む）が含まれます。Change および Throttling のステップでは、任意の前回値と時刻を指定できます。サーバー は各前処理ステップの結果を返します。

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

実際の値をテストする

実際の値に対して前処理をテストするには、次の手順を実行します。

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

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

ホストから実際の値を取得する場合に固有のパラメータ：

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

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