2 ロケーションでサポートされているユーザーマクロ
概要
このセクションには、ユーザー定義マクロがサポートされている場所の一覧が含まれています。
アクション、ネットワークディスカバリ、プロキシ、およびこのページのその他の場所セクションに記載されているすべての場所では、グローバルレベルのユーザーマクロのみがサポートされています。 上記の場所では、ホストレベルおよびテンプレートレベルのマクロは展開されません。
マクロ値をカスタマイズするには（たとえば、特定の部分文字列を短縮または抽出する場合）、マクロ関数を使用できます。
アクション
アクションでは、ユーザーマクロを次のフィールドで使用できます。
| ロケーション | 複数のマクロ/テキストとの混合1 | |
|---|---|---|
| トリガーベースの通知とコマンド | yes | |
| トリガーベースの内部通知 | yes | |
| 障害の更新通知 | yes | |
| サービスベースの通知とコマンド | yes | |
| サービス更新通知 | yes | |
| 期間 | no | |
| オペレーション | ||
| デフォルトの操作ステップ期間 | no | |
| ステップ期間 | no | |
ホスト/ホストプロトタイプ
ホスト および ホスト プロトタイプ の設定では、ユーザーマクロを次のフィールドで使用できます。
| 場所 | 複数のマクロ/テキストとの混在1 | |
|---|---|---|
| インターフェースのIP/DNS | DNSのみ | |
| インターフェースのポート | いいえ | |
| SNMP v1、v2 | ||
| SNMPコミュニティ | はい | |
| SNMP v3 | ||
| コンテキスト名 | はい | |
| セキュリティ名 | はい | |
| 認証パスフレーズ | はい | |
| プライバシーパスフレーズ | はい | |
| IPMI | ||
| ユーザー名 | はい | |
| パスワード | はい | |
| タグ2 | ||
| タグ名 | はい | |
| タグ値 | はい | |
アイテム / アイテムのプロトタイプ
アイテム または アイテムの プロトタイプ の設定では、ユーザーマクロを以下のフィールドで使用できます。
| 場所 | 複数のマクロ/テキストとの混在1 | |
|---|---|---|
| アイテム名 | はい | |
| アイテムキーのパラメータ | はい | |
| 更新間隔 | いいえ | |
| カスタム間隔 | いいえ | |
| タイムアウト（サポートされているアイテムタイプで利用可能） | いいえ | |
| 保存期間（履歴およびトレンド） | いいえ | |
| 説明 | はい | |
| 計算/集計アイテム | ||
| 数式（式定数および関数パラメータ、アイテムキーのパラメータ、（集計アイテムのみ）フィルター条件（ホストグループ名およびタグ名）） | はい | |
| データベースモニタ | ||
| ユーザー名 | はい | |
| パスワード | はい | |
| SQLクエリ | はい | |
| HTTPエージェント | ||
| URL3 | はい | |
| クエリフィールド | はい | |
| リクエストボディ | はい | |
| ヘッダー（名前と値） | はい | |
| 必要なステータスコード | はい | |
| HTTPプロキシ | はい | |
| HTTP認証ユーザー名 | はい | |
| HTTP認証パスワード | はい | |
| SSl証明書ファイル | はい | |
| SSlキーファイル | はい | |
| SSlキーパスワード | はい | |
| 許可されたホスト | はい | |
| JMXエージェント | ||
| JMXエンドポイント | はい | |
| スクリプトアイテム | ||
| パラメータ名と値 | はい | |
| ブラウザアイテム | ||
| パラメータ名と値 | はい | |
| SNMPエージェント | ||
| SNMP OID | はい | |
| SSHエージェント | ||
| ユーザー名 | はい | |
| 公開鍵ファイル | はい | |
| 秘密鍵ファイル | はい | |
| パスワード | はい | |
| スクリプト | はい | |
| TELNETエージェント | ||
| ユーザー名 | はい | |
| パスワード | はい | |
| スクリプト | はい | |
| Zabbixトラッパー | ||
| 許可されたホスト | はい | |
| タグ2 | ||
| タグ名 | はい | |
| タグ値 | はい | |
| 前処理ステップ | ||
| パラメータ（カスタムスクリプトを含む） | はい | |
| カスタムエラー処理パラメータ（値を設定 および エラーを設定 フィールド） | はい | |
ローレベルディスカバリ
ローレベルディスカバリ ルールでは、 ユーザーマクロを以下のフィールドで使用できます。
| 場所 | 複数のマクロ/テキストとの混在1 | |
|---|---|---|
| キーのパラメータ | はい | |
| 更新間隔 | いいえ | |
| カスタム間隔 | いいえ | |
| タイムアウト（サポートされているアイテムタイプで使用可能） | いいえ | |
| 失われたリソースの削除 | いいえ | |
| 失われたリソースの無効化 | いいえ | |
| 説明 | はい | |
| SNMPエージェント | ||
| SNMP OID | はい | |
| SSHエージェント | ||
| ユーザー名 | はい | |
| 公開鍵ファイル | はい | |
| 秘密鍵ファイル | はい | |
| パスワード | はい | |
| スクリプト | はい | |
| TELNETエージェント | ||
| ユーザー名 | はい | |
| パスワード | はい | |
| スクリプト | はい | |
| Zabbixトラッパー | ||
| 許可されたホスト | はい | |
| データベースモニタ | ||
| ユーザー名 | はい | |
| パスワード | はい | |
| SQLクエリ | はい | |
| JMXエージェント | ||
| JMXエンドポイント | はい | |
| HTTPエージェント | ||
| URL3 | はい | |
| クエリフィールド | はい | |
| リクエストボディ | はい | |
| ヘッダー（名前と値） | はい | |
| 必要なステータスコード | はい | |
| HTTP認証のユーザー名 | はい | |
| HTTP認証のパスワード | はい | |
| フィルター | ||
| 正規表現 | はい | |
| オーバーライド | ||
| フィルター: 正規表現 | はい | |
| 操作: 更新間隔（アイテムプロトタイプ用） | いいえ | |
| 操作: 履歴保存期間（アイテムプロトタイプ用） | いいえ | |
| 操作: トレンド保存期間（アイテムプロトタイプ用） | いいえ | |
ネットワークディスカバリ
ネットワークディスカバリルール では、次のフィールドでユーザー マクロを使用できます。
| ロケーション | 複数のマクロ/テキストとの混合1 | |
|---|---|---|
| 監視間隔 | no | |
| SNMP v1, v2 | ||
| SNMP コミュニティ | yes | |
| SNMP OID | yes | |
| SNMP v3 | ||
| コンテキスト名 | yes | |
| セキュリティ名 | yes | |
| 認証パスフレーズ | yes | |
| プライバシーパスフレーズ | yes | |
| SNMP OID | yes | |
プロキシ
プロキシ の設定では、ユーザーマクロを以下のフィールドで使用できます。
| 場所 | 複数のマクロ/テキストとの混在1 | |
|---|---|---|
| Address for active agents > Port（プロキシがグループに属している場合） | いいえ | |
| インターフェースのアドレスとポート（パッシブプロキシの場合） | いいえ | |
| アイテムタイプのタイムアウト | いいえ | |
プロキシグループ
プロキシグループ 構成では、以下のフィールドでユーザーマクロを使用できます。
| 場所 | 複数のマクロ/テキストとの混在1 | |
|---|---|---|
| フェイルオーバー期間 | いいえ | |
| プロキシの最小数 | いいえ | |
テンプレート
テンプレートの設定では、次のフィールドでユーザー マクロを使用できます。
トリガー
トリガーの設定では、ユーザーマクロを以下のフィールドで使用できます。
| 場所 | 複数のマクロ/テキストとの混在1 | |
|---|---|---|
| 名前 | はい | |
| 運用データ | はい | |
| 条件式（定数および関数パラメータ内のみ。シークレットマクロはサポートされません） | はい | |
| 一致用タグ | はい | |
| メニューエントリ名 | はい | |
| メニューエントリURL3 | はい | |
| 説明 | はい | |
| タグ2 | ||
| タグ名 | はい | |
| タグの値 | はい | |
Web シナリオ
Webシナリオの設定では、次のフィールドでユーザー マクロを使用できます。
| ロケーション | 複数のマクロ/テキストとの混合1 | |
|---|---|---|
| 名前 | yes | |
| 監視間隔 | no | |
| エージェント | yes | |
| HTTPプロキシ | yes | |
| 変数 (値のみ) | yes | |
| ヘッダー (名前と値) | yes | |
| ステップ | ||
| 名前 | yes | |
| URL3 | yes | |
| 変数 (値のみ) | yes | |
| ヘッダー (名前と変数) | yes | |
| タイムアウト | no | |
| 要求文字列 | yes | |
| 要求ステータスコード | no | |
| 認証 | ||
| ユーザー | yes | |
| パスワード | yes | |
| SSL 証明書ファイル | yes | |
| SSL 秘密鍵ファイル | yes | |
| SSL 秘密鍵パスワード | yes | |
| タグ2 | ||
| タグ名 | yes | |
| タグ値 | yes | |
その他の場所
ここに記載されている場所に加えて、ユーザーマクロは以下の フィールドでも使用できます。
| 場所 | 複数のマクロ/テキストとの混在1 | |
|---|---|---|
| グローバルスクリプト（URL、スクリプト、SSH、Telnet、IPMI）、確認テキストを含む | はい | |
| webhook | ||
| JavaScriptスクリプト | いいえ | |
| JavaScriptスクリプトパラメータ名 | いいえ | |
| JavaScriptスクリプトパラメータ値 | はい | |
| ダッシュボード | ||
| Top hosts ダッシュボードウィジェットのデータ型 Text の列 | はい | |
| Item value および Gauge ダッシュボードウィジェットの Description パラメータ | はい | |
| Honeycomb ダッシュボードウィジェットの Primary/Secondary label の Text パラメータ | はい | |
| URL ダッシュボードウィジェットの URL3 パラメータ | はい | |
| ユーザー → ユーザー → メディア | ||
| アクティブ時間 | いいえ | |
| 管理 → 一般 → GUI | ||
| 稼働時間 | いいえ | |
| 管理 → 一般 → タイムアウト | ||
| アイテムタイプのタイムアウト | いいえ | |
| 管理 → 一般 → コネクタ | ||
| URL | はい | |
| ユーザー名 | はい | |
| パスワード | はい | |
| Bearerトークン | はい | |
| タイムアウト | いいえ | |
| HTTPプロキシ | はい | |
| SSL証明書ファイル | はい | |
| SSLキーファイル | はい | |
| SSLキーのパスワード | はい | |
| アラート → メディアタイプ → メッセージテンプレート | ||
| 件名 | はい | |
| メッセージ | はい | |
| アラート → メディアタイプ → スクリプト | ||
| スクリプトパラメータ | はい | |
| アラート → メディアタイプ → メディアタイプ | ||
| Email メディアタイプの Username および Password フィールド（Authentication が「Username and password」に設定されている場合。secret macros の使用を推奨） | はい | |
Zabbixでサポートされているすべてのマクロの完全な一覧については、サポートされているマクロを参照してください。
脚注
1 フィールド内の複数のマクロまたはテキストと混合されたマクロがそのロケーションでサポートされていない場合は、1 つのマクロでフィールド全体を埋める必要があります。
2 タグ名と値で使用されるマクロは、イベント生成プロセス中にのみ解決されます。
3 シークレットマクロを含む URL は機能しません。それらのマクロは"******"のように解決されます。