1 保存前処理のテスト

テスト

複雑な前処理パイプラインが期待通りの結果をもたらすことを確認するために、前処理ステップのテストは有用です。アイテム値が受信されて前処理されるのを待つ必要はありません。

テスト可能な内容:

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

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

仮想値のテスト

パラメータ	説明
ホストから値を取得	仮想値をテストしたい場合は、このチェックボックスを未選択のままにします。 関連: 実際の値のテスト
値	テストする入力値を入力します。 パラメータフィールドをクリックするか、表示/編集ボタン をクリックすると、値やコードブロックを入力するためのテキストエリアウィンドウが開きます。
未サポート	未サポートの値をテストする場合は、このチェックボックスを選択します。 このオプションは、未サポート値のチェックの前処理ステップをテストするのに便利です。
エラー	エラーテキストを入力します。 このフィールドは、ホストから値を取得が未選択で、未サポートが選択されている場合に有効になります。 ホストから値を取得が選択されている場合、このフィールドにはホストからの実際のエラーメッセージが入力されます(読み取り専用)。
時刻	入力値の時刻が表示されます: now (読み取り専用)。
前回の値	比較するための前回の入力値を入力します。 変化およびスロットリングの前処理ステップのみ。
前回の時刻	比較するための前回の入力値の時刻を入力します。 変化およびスロットリングの前処理ステップのみ。 デフォルト値は、アイテムの「更新間隔」フィールド値に基づきます(「1m」の場合、このフィールドにはnow-1mが入力されます)。何も指定されていない場合やユーザーがホストにアクセスできない場合、デフォルトはnow-30sです。
マクロ	マクロが使用されている場合、それらが値とともに一覧表示されます。値はテスト目的で編集可能ですが、変更はテストの範囲内でのみ保存されます。
改行シーケンス	複数行の入力値に対する改行シーケンスを選択します: LF - LF(ラインフィード)シーケンス CRLF - CRLF(キャリッジリターン+ラインフィード)シーケンス。
前処理ステップ	前処理ステップが一覧表示され、テストボタンをクリックした後に各ステップのテスト結果が表示されます。 テスト結果は、フロントエンドに送信される際に最大512KBまでに切り捨てられます。テスト結果はコピーできます(切り捨てられた512KBまで)。結果が切り捨てられた場合は、警告アイコンが表示されます。警告の説明はマウスオーバーで表示されます。512KBを超えるデータもZabbixサーバーでは完全に処理されることに注意してください。 ステップがテストで失敗した場合、エラーアイコンが表示されます。エラーの説明はマウスオーバーで表示されます。 ステップに「失敗時のカスタム」が指定され、そのアクションが実行された場合、前処理テストステップ行の直後に新しい行が表示され、どのアクションが実行され、どのような結果(エラーまたは値)が得られたかが示されます。
結果	前処理ステップをすべて一緒にテストした場合(「すべてのステップをテスト」ボタンをクリックした場合)に、テストの最終結果が表示されます。 アイテムの値タイプへの変換タイプも表示されます(例: Result converted to Numeric (unsigned))。 テスト結果は、フロントエンドに送信される際に最大512KBまでに切り捨てられます。最終結果もコピーできます(切り捨てられた512KBまで)。結果が切り捨てられた場合は、警告アイコンが表示されます。警告の説明はマウスオーバーで表示されます。512KBを超えるデータもZabbixサーバーでは完全に処理されることに注意してください。

テストをクリックすると、各前処理ステップの後の結果が表示されます。

テスト値は、個々のステップまたはすべてのステップのテストセッション間で保存されるため、ユーザーは前処理ステップやアイテムの設定を変更した後でも、テストウィンドウに戻って情報を再入力する必要がありません。ただし、ページをリフレッシュすると値は失われます。

テストはZabbixサーバーによって実行されます。フロントエンドは対応するリクエストをサーバーに送信し、結果を待ちます。リクエストには、入力値と前処理ステップ(展開されたユーザーマクロ付き)が含まれます。変化およびスロットリングステップの場合、オプションで前回の値と時刻を指定できます。サーバーは各前処理ステップの結果を返します。

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

実際の値でのテスト

実際の値に対して前処理をテストするには:

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

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

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

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

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