8 値のマッピング

概要

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

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

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

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

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

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

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

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

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

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

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

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

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

設定

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

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

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

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

Parameter Description
Name 値マッピングセットの一意の名前。
Mappings 数値/文字列の値を文字列表現にマッピングする個別のルール。

マッピングはルールの順序に従って適用され、ドラッグして並べ替えることができます。
Type マッピングの種類:
equals - 等しい値をマッピングします;
is greater than or equals - 等しい値またはそれより大きい値をマッピングします;
is less than or equals - 等しい値またはそれより小さい値をマッピングします;
in range - 範囲内の値をマッピングします。範囲は <number1>-<number2> または <number> で表します。複数の範囲を指定できます（例: 1-10,101-110,201）;
regexp - 正規表現 に一致する値をマッピングします（グローバル正規表現はサポートされていません）;
default - 個別のマッピングが設定されていない、その他すべての値をマッピングします。

範囲のマッピングでは、数値型（is greater than or equals、is less than or equals、in range）のみサポートされます。
Value 入力値（マッピングの種類に応じて、範囲または正規表現を含む場合があります）。
Mapped to 入力値に対する文字列表現（最大 64 文字）。

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

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

値マッピングの例

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

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

このマッピングは、監視 > 最新データ セクションで「Up」（括弧内に生の値）を表示するために使用されます。

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

事前定義された値マッピングがない場合は、「1」しか表示されず、理解しにくいかもしれません。