8 値のマッピング

概要

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

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

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

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

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

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

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

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

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

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

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

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

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

設定

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

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

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

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

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つのドットでそれ以上のマッピングがあることを示します。

値のマッピング例

あらかじめ定義されているエージェントアイテム Zabbix agent ping は、テンプレートレベルの値のマッピング「Zabbix agent ping status」を使用して、その値を表示します。

アイテムの設定フォームでは、値のマッピング フィールドでこの値のマッピングへの参照を見つけることができます。

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

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

あらかじめ定義された値のマッピングがない場合、「1」だけが表示され、理解しにくい場合があります。