前処理のテスト

テスト

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

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

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

各前処理ステップは個別にテストでき、すべてのステップをまとめてテストすることもできます。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サーバーによって完全に処理されることに注意してください。

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