1 サポートされているマクロ（場所別）

概要

次の表で、Zabbix によってサポートされているマクロの完全なリストを示します。

• Xは、その場所で「サポートされている」という意味です。
• 番号付きのマクロ構文{MACRO<1-9>}を使用すれば、トリガー条件式へ現れる順番にホストを参照できます。同様に、{HOST.IP1}、{HOST.IP2}、{HOST.IP3}といったマクロは、トリガー条件式が1番目、2番目、3番目のホストを含む場合、これらのホストのIPへ展開されます。

脚注

¹ 1.8以降、マップラベルのマクロがサポートされています。

² Zabbix 2.0.3以降、アイテムキーのパラメータでサポートされているHOST.*マクロは、インターフェースを含んでいるアイテムのタイプでしか動作しません。すなわち、これらのマクロは、「Zabbixエージェント（アクティブ）」、「計算」などのタイプでは動作しません。

³ コンテキストに応じて、マクロの展開の仕方が異なります。2.0.1以前のバージョンでは、リモートコマンド実行、GUIスクリプト、アイテムキーのパラメータ、インターフェースIP/DNSフィールドのコンテキスト中で、メインエージェントインターフェースのみが情報源と見なされます。2.0.2以降および2.2.0以降のwebシナリオでは、マクロはメインエージェントインターフェースを使用しますが、これが存在しない場合、メインSNMPインターフェースが使用されます。SNMPも存在しない場合、メインJMXインターフェースが使用されます。JMXも存在しない場合、メインIPMIインターフェースが使用されます。2.0.3以降、アイテムキーのパラメータ中で、アイテムに選択されるインターフェースが使用されます。

⁴ avg、last、max、min関数（パラメータとして秒で表します）のみが、マップラベルのこのマクロでサポートされます。

⁵ 2.0.3以降サポートされています。

⁶ Zabbix 2.2.0以降サポートされています。{HOST.*}マクロおよびユーザー定義マクロ{$MACRO}は、webシナリオの名前、変数の両フィールドおよびシナリオステップの名前、URL、POST、要求文字列の各フィールドでサポートされています。{$MACRO}は、webシナリオの認証（ユーザーならびにパスワード）、エージェント、HTTPプロキシの各フィールドおよびシナリオステップの[要求ステータスコード]フィールドでもサポートされています。

⁷ Zabbix 2.2.0以降サポートされています。avg、last、max、min関数（パラメータとして秒で表します）のみが、グラフ名のこのマクロ内でサポートされています。{HOST.HOST<1-9>}マクロは、マクロ内のホストとして使用できます。
例：

 * {Cisco switch:ifAlias[{#SNMPINDEX}].last(0)}
        * {{HOST.HOST}:ifAlias[{#SNMPINDEX}].last(0)}

⁸ 2.2.2以降サポートされています。

ユーザーマクロへの追加サポート

Zabbix 2.0以降のユーザー定義可能マクロは、一覧で示す場所以外にも、多くの場所でサポートされています：

*ホスト
         *インターフェース IP/DNS
         *インターフェースポート
       
       *パッシブプロキシ
         *インターフェースポート
       
       *アイテム
         *SNMPv3セキュリティ名
         *SNMPv3 auth pass
         *SNMPv3 priv pass
         *SNMPv1/v2コミュニティ
         *SNMP OID
         *SSHユーザー名
         *SSH公開鍵
         *SSH秘密鍵
         *SSHパスワード
         *Telnetユーザー名
         *Telnetパスワード
         *アイテム[[jp:manual:config:items:itemtypes:calculated#configurable_fields|計算式]]
         *トラッパーアイテムの「許可されたホスト」フィールド（//Zabbix 2.2以降//）
       
       *ディスカバリ
         *SNMPv3セキュリティ名
         *SNMPv3 auth pass
         *SNMPv3 priv pass
         *SNMPv1/v2コミュニティ
         *SNMP OID

ローレベルディスカバリで使用されるマクロ

ローレベルディスカバリ関数 - {#MACRO}内で使用されるタイプのマクロが存在します。これは、LLDルールで使用されるマクロであり、ファイルシステム名、ネットワークインターフェース、SNMP OIDの実際の値を返します。

これらのマクロは、アイテム、トリガー、グラフの各プロトタイプを作成する際に使用できます。これらのマクロはその後、実際のファイルシステムやネットワークインターフェースなどを発見した時点で実際の値に置き換えられ、これが実際のアイテム、トリガー、グラフを作成する際の土台となります。

LLDマクロを使用できるのは以下のとおりです：

*以下のアイテムのプロトタイプ
         *名前
         *キーのパラメータ
         * SNMP OID
         *アイテム計算式
         * SSH、Telnet両スクリプト
         *データベース監視アイテムのパラメータ 
       *以下のトリガーのプロトタイプ
         *名前
         *条件式（アイテムキーのプロトタイプを参照する場合に限り、独立型の定数として） 
         *以下のグラフのプロトタイプ
         *名前

ローレベルディスカバリマクロの中には、ZabbixのLLD関数とともにあらかじめパッケージ済みのものもあります

{#FSNAME}、{#FSTYPE}、{#IFNAME}、{#SNMPINDEX}、{#SNMPVALUE}。ただし、カスタムのローレベルディスカバリルールを作成する際、これらの名前は必ずしも使用しなくても構いません。他のLLDマクロ名を使用し、その名前を参照しても構いません。

本ページは2014/08/05時点の原文を基にしておりますので、内容は必ずしも最新のものとは限りません。
最新の情報は、英語版のZabbix2.2マニュアルを参照してください。