8 値のマッピング

概要

値のマッピングを使用すると、数値/文字列の値と文字列表現の間のマッピングを使用して、受信した値をよりユーザーフレンドリーな表現に設定できます。

たとえば、アイテムの値が "0" または "1" の場合、値のマッピングを使用してこれらの値をよりユーザーフレンドリーな方法で表現できます。

  • 0 → 利用不可
  • 1 → 利用可能

データバックアップタイプの値のマッピングは、次のように設定できます。

  • F → フル
  • D → 差分
  • I → 増分

電圧の値の範囲は、次のように設定できます。

  • <=209 → 低
  • 210-230 → OK
  • >=231 → 高

値のマッピングは、Zabbixフロントエンドおよびメディアタイプによって送信される通知で使用されます。

受信した値を設定された表現に置き換える処理は、Zabbixフロントエンドとサーバーの両方で実行されます。 ただし、サーバーが置換を処理するのは、次の場合のみです。

値のマッピングはテンプレートまたはホストで設定します。 一度設定すると、該当するテンプレートまたはホスト内のすべてのアイテムで利用できます。 アイテムを設定する際に、値のマッピングパラメータで事前に設定した値のマッピング名を指定します。

値のマッピングの継承はありません。ホストやテンプレートは、リンクされたテンプレートから値のマッピングを継承しません。 ホスト上のテンプレートアイテムは、テンプレートで設定された値のマッピングを引き続き使用します。

値のマッピングは、数値（整数）、数値（浮動小数点）、文字列の情報タイプを持つアイテムで使用できます。

値のマッピングは、該当するテンプレートまたはホストとともにエクスポート/インポートされます。 また、ホストおよびテンプレートの一括更新フォームを使用して一括更新することもできます。

設定

値のマッピングを設定するには、次の手順に従います。

1. ホストまたはテンプレートの設定フォームを開きます。

2. 値のマッピングタブで、追加をクリックして新しい値のマッピングを追加するか、既存のマッピング名をクリックして編集します。

値のマッピングのパラメータ:

パラメータ 説明
名前 値のマッピングセットの一意の名前。
マッピング 数値または文字列の値を文字列表現にマッピングする個別のルール。

マッピングはルールの順序に従って適用されます。ルールはドラッグして並べ替えることができます。
タイプ マッピングのタイプ:
等しい - 等しい値がマッピングされます。
以上 - 等しい値または大きい値がマッピングされます。
以下 - 等しい値または小さい値がマッピングされます。
範囲内 - 範囲内の値がマッピングされます。範囲は<number1>-<number2>または<number>として指定します。複数の範囲にも対応しています（例: 1-10,101-110,201）。
正規表現 - 正規表現に一致する値がマッピングされます（グローバル正規表現には対応していません）。
デフォルト - 特定のマッピングが設定されていない、その他すべての値がマッピングされます。

範囲のマッピングでは、数値の値タイプ（以上、以下、範囲内）のみがサポートされます。
値 受信値（マッピングタイプに応じて、範囲または正規表現を含めることができます）。
マッピング先 受信値に対応する文字列表現（最大64文字）。

必須入力フィールドには、赤いアスタリスクが付いています。

一覧で値のマッピングを表示する場合、最初の3つのマッピングのみが表示され、さらにマッピングが存在することを示す3つのドットが表示されます。

値のマッピングの例

定義済みのエージェントアイテム Zabbix agent ping の 1 つでは、値を表示するためにテンプレートレベルの値のマッピング「Zabbix agent ping status」を使用しています。

アイテム設定フォームでは、Value mapping フィールドにこの値のマッピングへの参照があります。

このマッピングは、Monitoring → Latest data セクションで「Up」（括弧内に生の値）を表示するために使用されます。

Latest data セクションでは、表示される値は 20 文字に短縮されます。 値のマッピングが使用されている場合、この短縮はマッピングされた値には適用されず、生の値（括弧内に表示される値）にのみ適用されます。

定義済みの値のマッピングがない場合は「1」としか表示されないため、理解しにくい可能性があります。