1 保存前処理のテスト
テスト
前処理ステップのテストは、複雑な前処理パイプラインが、アイテム値の受信と前処理を待つことなく、期待どおりの結果を生成することを確認するのに役立ちます。
以下のテストが可能です。
- 仮想的な値に対するテスト
- ホストからの実際の値に対するテスト
各前処理ステップは個別にテストすることも、すべてのステップをまとめてテストすることもできます。アクションブロックのテストまたはすべてのステップをテストボタンをクリックすると、テストウィンドウが開きます。
仮想値のテスト
| Parameter | Description |
|---|---|
| Get value from host | 仮想値をテストする場合は、このチェックボックスをオフにしてください。 参照先: 実値のテスト。 |
| Value | テストする入力値を入力します。 パラメータ欄または表示/編集ボタン  をクリックすると、値またはコードブロックを入力するためのテキストエリアウィンドウが開きます。 |
| Not supported | サポートされていない値をテストする場合は、このチェックボックスをオンにします。 このオプションは、Check for not supported value の前処理ステップをテストする際に便利です。 |
| 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 を超えるデータも、Zabbix サーバー側では引き続き完全に処理される点に注意してください。 ステップのテストに失敗した場合は、エラーアイコンが表示されます。エラーの説明はマウスオーバーで表示されます。 ステップに "Custom on fail" が指定され、そのアクションが実行された場合は、前処理テストステップ行の直後に新しい行が表示され、実行されたアクションとその結果（エラーまたは値）が示されます。 |
| Result | すべてのステップをまとめてテストした場合（Test all steps ボタンをクリックした場合）、前処理ステップの最終結果がすべてのケースで表示されます。 アイテムの値タイプへの変換タイプも表示されます。たとえば Result converted to Numeric (unsigned) のように表示されます。テスト結果は、Webインターフェースに送信される際に最大 512KB まで切り詰められます。結果が切り詰められた場合は、警告アイコンが表示されます。警告の説明はマウスオーバーで表示されます。512KB を超えるデータも、Zabbix サーバー側では引き続き完全に処理される点に注意してください。 |
各前処理ステップの結果を確認するには、Test をクリックします。
テスト値は、個別のステップまたはすべてのステップのいずれについても、テストセッション間で保存されます。これにより、ユーザーは前処理ステップやアイテム設定を変更した後でも、情報を再入力せずにテストウィンドウへ戻ることができます。ただし、ページを更新すると値は失われます。
テストは Zabbix サーバーによって実行されます。Webインターフェースは対応するリクエストをサーバーに送信し、結果を待機します。リクエストには入力値と前処理ステップ（展開済みのユーザーマクロを含む）が含まれます。Change および Throttling ステップでは、任意の前回値と時刻を指定できます。サーバーは各前処理ステップの結果を返します。
すべての技術的エラーまたは入力検証エラーは、テストウィンドウ上部のエラーボックスに表示されます。
実際の値のテスト
実際の値に対して前処理をテストするには、次の手順を実行します。
- Get value from host チェックボックスをオンにします
- ホストのパラメータ（ホストアドレス、ポート、プロキシ名/なし）およびアイテム固有の詳細（SNMPv2 コミュニティや SNMPv3 セキュリティ認証情報など）を入力または確認します。これらのフィールドはコンテキストに応じて動作します。
- 可能な場合、値は事前入力されます。つまり、エージェントを必要とするアイテムでは、ホストの選択されたエージェントインターフェースから情報が取得されます
- テンプレートアイテムでは、値を手動で入力する必要があります
- プレーンテキストのマクロ値は解決されます
- フィールド値（または値の一部）が secret または Vault マクロである場合、そのフィールドは空になり、手動で入力する必要があります。アイテムパラメータに secret マクロ値が含まれている場合は、次の警告メッセージが表示されます: "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）の設定に関する詳細は、SNMP監視の設定 を参照してください。 これらのフィールドは、アイテムのホストインターフェースから自動的に入力されます。 |
| Proxy | ホストがプロキシで監視されている場合は、プロキシを指定します。 このフィールドには、ホストのプロキシ（存在する場合）が自動的に入力されます。 |
| Value | ホストから取得した値です。 パラメータフィールドまたは表示/編集ボタン をクリックすると、値またはコードブロックのテキストエリアウィンドウが開きます。値は最大 512KB まで切り捨てられ、Webインターフェース上でのみ切り捨てられます。結果が切り捨てられた場合は、警告アイコンが表示されます。警告の説明はマウスオーバーで表示されます。512KB を超えるデータも Zabbix サーバーによって完全に処理されることに注意してください。 |
その他のパラメータについては、上記の 仮想値のテスト を参照してください。