2 マクロ

Zabbixにはマクロが豊富に用意されており、様々な状況で使用できます。マクロを活用することで、Zabbixの設定にかかる時間を短縮し、透過性を高めることができます。

サポートされているマクロのリスト

Zabbixでサポートされている全マクロのリストを以下に示します。

グローバルマクロとホストレベルマクロ

より柔軟性を高めるため、テンプレートレベルマクロと同様に、Zabbixはグローバルとホストレベルのマクロをサポートします。これらのマクロは特別な記法を持っています: {$MACRO}. アイテムキーとトリガー式のなかでマクロを使用できます。

マクロ名には以下の文字を使用できます: A-Z , 0-9 , _ , .

Zabbixは、以下の優先順位に従いマクロを置き換えます。

1. ホストマクロ(最初に確認)
2. ホストのテンプレートに定義されたマクロ。Zabbixは、テンプレートの継承を考慮しながら、さらに深いレベルのテンプレートを確認します。
3. グローバルマクロ(最後に確認)

つまり、ホストにマクロがない場合、Zabbixはホストテンプレートでマクロを検索します。ホストテンプレートにもマクロが見つからない場合、グローバルテンプレート(ある場合)が使用されます。

Zabbixでマクロが見つからない場合、マクロは置き換えられません。

グローバルとホストレベルのマクロによって、Zabbix設定のメンテナンスがさらに容易になります。

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

1. ホストに固有の属性(パスワード、ポート番号、ファイル名、正規表現など)を含むテンプレートを利用する
2. ワンクリックによるグローバルな設定変更と微調整のためのグローバルマクロ

例1

アイテム "Status of SSH daemon" のキーにおけるホストマクロの使用:

ssh,{$SSH_PORT}

例2

トリガー "CPU load is too high" におけるホストマクロの使用:

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

<note tip>値の量を関数パラメータ(max(#3)など)として使用する場合、以下のようにマクロにハッシュマークを使用します。 :::

例3

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

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

この例の関数min()では、トリガー関数のパラメータとしてマクロを使用できることに注意してください。