2 ユーザーマクロ

概要

Zabbixでは、標準でサポートされているマクロに加えて、より柔軟性を持たせるためにユーザーマクロがサポートされています。

ユーザーマクロは、グローバル、テンプレート、ホストレベルで定義できます。これらのマクロには特別な構文があります。

{$MACRO}

Zabbixは、以下の優先順位でマクロを解決します。

1. ホストレベルのマクロ（最初にチェックされる）
2. ホストの第1レベルテンプレート（ホストに直接リンクされているテンプレート）で定義されたマクロ（テンプレートIDでソート）
3. ホストの第2レベルテンプレートで定義されたマクロ（テンプレートIDでソート）
4. ホストの第3レベルテンプレートで定義されたマクロ（テンプレートIDでソート）、以下同様
5. グローバルマクロ（最後にチェックされる）

つまり、ホストにマクロが存在しない場合、Zabbixは深さを増しながらホストテンプレート内でマクロを探します。それでも見つからない場合、存在すればグローバルマクロが使用されます。

Zabbixがマクロを見つけられない場合、そのマクロは解決されません。

ユーザーマクロは以下で使用できます。

• アイテム名
• アイテムキーのパラメータ
• アイテムの更新間隔および柔軟な間隔
• トリガー名および説明
• トリガー式のパラメータおよび定数（例を参照）
• その他多くの場所 - 完全なリストを参照

グローバルマクロとホストマクロの一般的な使用例

• グローバルマクロを複数の場所で使用し、マクロの値を変更すると、ワンクリックですべての場所に設定変更が適用されます。
• ホスト固有の属性（パスワード、ポート番号、ファイル名、正規表現など）を持つテンプレートを活用します。

設定

ユーザーマクロを定義するには、Webインターフェース内の対応する場所に移動します。

• グローバルマクロの場合は、Administration → Macros を開きます
• ホストおよびテンプレートレベルのマクロの場合は、ホストまたはテンプレートのプロパティを開き、 Macros タブを探します

ユーザーマクロには、次の属性があります。

ユーザーマクロを設定する際は、以下のコンテキスト固有の動作に注意してください。

• ユーザーマクロがテンプレートのアイテムまたはトリガーで使用される場合は、それらのマクロをテンプレートにも追加することを検討してください（グローバルに定義されている場合でも）。そうすることで、テンプレートをXMLにエクスポートして別のシステムにインポートした後も、Text タイプのマクロは期待どおりに動作します（シークレットマクロの値は exported されません）
• ユーザーマクロがトリガー式で使用される場合、それらのマクロはパラメータまたは定数を参照している場合にのみ展開されます。ホスト、アイテムキー、関数、演算子、または別のトリガー式を参照している場合は展開されません（シークレットマクロはトリガー式では使用できません）
• ユーザーマクロが、ホストプロトタイプを持つローレベルディスカバリルールが設定されたホストで使用される場合、discovered hosts はそのホストで定義されたすべてのユーザーマクロを継承します

例

例 1

"Status of SSH daemon" item キーにホストレベルマクロを使用する。

net.tcp.service[ssh,,{$SSH_PORT}]

この項目は、複数のホストで {$SSH_PORT} の値が定義されている場合に、複数のホストに割り当てることができます。

例 2

"CPU load is too high" トリガー でのホストレベルマクロの使用:

last(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}

このようなトリガーは、個々のホストで編集するのではなく、テンプレート上で作成されることになります。

例 3

"CPU load is too high" トリガーで2つのマクロを使用する:

min(/ca_001/system.cpu.load[,avg1],{$CPULOAD_PERIOD})>{$MAX_CPULOAD}

マクロはトリガー関数（この例では関数min()）のパラメータとして使用することができることに注意。

例 4

agent の利用不可条件と item の更新間隔を同期させる。:

• {INTERVAL} マクロを定義し、item の更新間隔に使用する。
• {INTERVAL} を agent 使用不可トリガーのパラメータとして使用する。

nodata(/ca_001/agent.ping,{$INTERVAL})=1

例5

勤務時間の設定を集中管理する:

• グローバルマクロ{$WORKING_HOURS}を1-5,09:00-18:00に設定する
• 管理 → 一般 → GUIの勤務時間フィールドで使用する
• ユーザー → ユーザーのメディアタブの有効期間フィールドで使用する
• 勤務時間中により頻繁にアイテムのポーリングを行うために使用する

• アクションの期間条件で使用する
• 必要に応じて管理 → マクロで勤務時間を調整する

例 6

ホストプロトタイプマクロを使用して、検出されたホストの item を設定します:

ホストプロトタイプで、{$SNMPVALUE} を {#SNMPVALUE}low-level discovery マクロ値として定義します:

• ホストプロトタイプに Generic SNMPv2 テンプレートを割り当てます。
• {SNMPVALUE} を使用します。汎用SNMPv2テンプレート項目の SNMP OID* フィールドに {$SNMPVALUE} を使用します。

ユーザーマクロのコンテキスト

user macros with context を参照してください。