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 のステップでは、任意の前回値と時刻を指定できます。サーバー は各前処理ステップの結果を返します。
技術的なエラーまたは入力検証エラーはすべて、テストウィンドウ上部のエラーボックスに表示されます。
実際の値のテスト
実際の値に対して前処理をテストするには、次の手順を実行します。
- Get value from host チェックボックスをオンにします
- ホストパラメータ（ホストアドレス、ポート、プロキシ名/なし）およびアイテム固有の詳細（SNMPv2コミュニティやSNMPv3セキュリティ認証情報など）を入力または確認します。これらのフィールドはコンテキストに応じて動作します。
- 値は可能な場合は事前入力されます。つまり、エージェントを必要とするアイテムでは、ホストの選択されたエージェントインターフェースから情報が取得されます
- テンプレートアイテムでは、値を手動で入力する必要があります
- プレーンテキストのマクロ値は解決されます
- フィールド値（または値の一部）がシークレットまたはVaultマクロである場合、そのフィールドは空になり、手動で入力する必要があります。アイテムパラメータにシークレットマクロ値が含まれている場合、次の警告メッセージが表示されます: "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
- アイテムタイプのコンテキストで不要な場合、フィールドは無効になります（例: 計算アイテムではホストアドレスとプロキシのフィールドは無効です）
- Get value and test をクリックして前処理をテストします
アイテム設定フォームで値マッピング（'Show value' フィールド）を指定している場合、アイテムテストダイアログには最終結果の後に 'Result with value map applied' という別の行が表示されます。
ホストから実際の値を取得する際に固有のパラメータ:
| Parameter | Description |
|---|---|
| Get value from host | このチェックボックスをオンにすると、ホストから実際の値を取得します。 |
| Host address | ホストアドレスを入力します。 このフィールドには、アイテムのホストインターフェースのアドレスが自動的に入力されます。 |
| Port | ホストのポートを入力します。 このフィールドには、アイテムのホストインターフェースのポートが自動的に入力されます。 |
| Additional fields for SNMP interfaces (SNMP version, SNMP community, Context name, etc.) |
SNMPインターフェース（v1、v2、v3）の設定に関する詳細は、Configuring SNMP monitoring を参照してください。 これらのフィールドには、アイテムのホストインターフェースから自動的に値が入力されます。 |
| Proxy | ホストがプロキシで監視されている場合は、プロキシを指定します。 このフィールドには、ホストのプロキシ（存在する場合）が自動的に入力されます。 |
| Value | ホストから取得した値です。 パラメータフィールドまたは表示/編集ボタン をクリックすると、値またはコードブロックのテキストエリアウィンドウが開きます。値は最大512KBまでに切り詰められ、Webインターフェース上でのみ切り詰められます。結果が切り詰められた場合は、警告アイコンが表示されます。警告の説明はマウスオーバーで表示されます。512KBを超えるデータも、Zabbixサーバーによって完全に処理されることに注意してください。 |
その他のパラメータについては、上記の仮想値のテストを参照してください。