2 ロケーションでサポートされているユーザーマクロ
概要
このセクションには、ユーザー定義マクロがサポートされている場所の一覧が含まれています。
アクション、ネットワークディスカバリ、プロキシ、およびこのページのその他の場所セクションに記載されているすべての場所では、グローバルレベルのユーザーマクロのみがサポートされています。 記載された場所では、ホストレベルおよびテンプレートレベルのマクロは展開されません。
マクロの値をカスタマイズするには（たとえば、特定の部分文字列を短縮または抽出する場合）、マクロ関数を使用できます。
アクション
アクションでは、ユーザーマクロを次のフィールドで使用できます。
| ロケーション | 複数のマクロ/テキストとの混合1 | |
|---|---|---|
| トリガーベースの通知とコマンド | yes | |
| トリガーベースの内部通知 | yes | |
| 障害の更新通知 | yes | |
| サービスベースの通知とコマンド | yes | |
| サービス更新通知 | yes | |
| 期間 | no | |
| オペレーション | ||
| デフォルトの操作ステップ期間 | no | |
| ステップ期間 | no | |
ホスト/ホストプロトタイプ
ホスト および ホスト プロトタイプ の設定では、ユーザーマクロを次のフィールドで使用できます。
| 場所 | 複数のマクロ/テキストとの混在1 | |
|---|---|---|
| インターフェース IP/DNS | DNS のみ | |
| インターフェースポート | いいえ | |
| SNMP v1, v2 | ||
| SNMP コミュニティ | はい | |
| SNMP v3 | ||
| コンテキスト名 | はい | |
| セキュリティ名 | はい | |
| 認証パスフレーズ | はい | |
| プライバシーパスフレーズ | はい | |
| IPMI | ||
| ユーザー名 | はい | |
| パスワード | はい | |
| タグ2 | ||
| タグ名 | はい | |
| タグ値 | はい | |
アイテム / アイテムプロトタイプ
アイテム または アイテム プロトタイプ の設定では、ユーザーマクロを次のフィールドで使用できます。
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| アイテム名 | yes | |
| アイテムキーのパラメーター | yes4 | |
| 更新間隔 | no | |
| カスタム間隔 | no | |
| タイムアウト（サポートされているアイテムタイプで利用可能） | no | |
| 保存期間（履歴とトレンド） | no | |
| 説明 | yes | |
| 計算/集計アイテム | ||
| 式（式の定数と関数パラメーター、アイテムキーのパラメーター、（集計アイテムのみ）フィルター条件（ホストグループ名とタグ名）） | yes | |
| データベースモニター | ||
| ユーザー名 | yes | |
| パスワード | yes | |
| SQLクエリ | yes | |
| HTTPエージェント | ||
| URL3 | yes | |
| クエリフィールド | yes | |
| リクエストボディ | yes | |
| ヘッダー（名前と値） | yes | |
| 必須ステータスコード | yes | |
| HTTPプロキシ | yes | |
| HTTP認証ユーザー名 | yes | |
| HTTP認証パスワード | yes | |
| SSL証明書ファイル | yes | |
| SSLキーファイル | yes | |
| SSLキーパスワード | yes | |
| 許可されたホスト | yes | |
| JMXエージェント | ||
| JMXエンドポイント | yes | |
| スクリプトアイテム | ||
| パラメーター名と値 | yes | |
| ブラウザーアイテム | ||
| パラメーター名と値 | yes | |
| SNMPエージェント | ||
| SNMP OID | yes | |
| SSHエージェント | ||
| ユーザー名 | yes | |
| 公開鍵ファイル | yes | |
| 秘密鍵ファイル | yes | |
| パスワード | yes | |
| スクリプト | yes | |
| TELNETエージェント | ||
| ユーザー名 | yes | |
| パスワード | yes | |
| スクリプト | yes | |
| Zabbixトラッパー | ||
| 許可されたホスト | yes | |
| タグ2 | ||
| タグ名 | yes | |
| タグ値 | yes | |
| 前処理ステップ | ||
| パラメーター（カスタムスクリプトを含む） | yes | |
| カスタムエラー処理パラメーター（値を設定 および エラーを設定 フィールド） | yes | |
Low-level discovery
low-level discovery ルール では、ユーザーマクロを次のフィールドで使用できます。
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| Key parameters | yes | |
| Update interval | no | |
| Custom interval | no | |
| Timeout (available for supported item types) | no | |
| Delete lost resources | no | |
| Disable lost resources | no | |
| Description | yes | |
| SNMP エージェント | ||
| SNMP OID | yes | |
| SSH エージェント | ||
| Username | yes | |
| Public key file | yes | |
| Private key file | yes | |
| Password | yes | |
| Script | yes | |
| TELNET エージェント | ||
| Username | yes | |
| Password | yes | |
| Script | yes | |
| Zabbix trapper | ||
| Allowed hosts | yes | |
| Database monitor | ||
| Username | yes | |
| Password | yes | |
| SQL query | yes | |
| JMX エージェント | ||
| JMX endpoint | yes | |
| HTTP エージェント | ||
| URL3 | yes | |
| Query fields | yes | |
| Request body | yes | |
| Headers (names and values) | yes | |
| Required status codes | yes | |
| HTTP authentication username | yes | |
| HTTP authentication password | yes | |
| Filters | ||
| Regular expression | yes | |
| Overrides | ||
| Filters: regular expression | yes | |
| Operations: update interval (for item prototypes) | no | |
| Operations: history storage period (for item prototypes) | no | |
| Operations: trend storage period (for item prototypes) | no | |
ネットワークディスカバリ
ネットワークディスカバリルール では、次のフィールドでユーザー マクロを使用できます。
| ロケーション | 複数のマクロ/テキストとの混合1 | |
|---|---|---|
| 監視間隔 | no | |
| SNMP v1, v2 | ||
| SNMP コミュニティ | yes | |
| SNMP OID | yes | |
| SNMP v3 | ||
| コンテキスト名 | yes | |
| セキュリティ名 | yes | |
| 認証パスフレーズ | yes | |
| プライバシーパスフレーズ | yes | |
| SNMP OID | yes | |
プロキシ
プロキシ の設定では、ユーザーマクロを次のフィールドで使用できます。
| 場所 | 複数のマクロ/テキストとの混在1 | |
|---|---|---|
| アクティブエージェントのアドレス > ポート（プロキシがグループに属している場合） | いいえ | |
| インターフェースのアドレスとポート（パッシブプロキシの場合） | いいえ | |
| アイテムタイプのタイムアウト | いいえ | |
プロキシグループ
プロキシグループ 構成では、以下のフィールドでユーザーマクロを使用できます。
| 場所 | 複数のマクロ/テキストとの混在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）、確認テキストを含む | yes | |
| webhook | ||
| JavaScriptスクリプト | no | |
| JavaScriptスクリプトのパラメーター名 | no | |
| JavaScriptスクリプトのパラメーター値 | yes | |
| ダッシュボード | ||
| Top hosts ダッシュボードウィジェットのデータ型 Text の列 | yes | |
| Item value および Gauge ダッシュボードウィジェットの Description パラメーター | yes | |
| Honeycomb ダッシュボードウィジェットのプライマリ/セカンダリラベルの Text パラメーター | yes | |
| URL ダッシュボードウィジェットの URL3 パラメーター | yes | |
| アラート → メディアタイプ → メッセージテンプレート | ||
| 件名 | yes | |
| メッセージ | yes | |
| アラート → メディアタイプ → スクリプト | ||
| スクリプトパラメーター | yes | |
| アラート → メディアタイプ → メディアタイプ | ||
| Email メディアタイプの Username および Password フィールド（Authentication が "Username and password" に設定されている場合; secret macros を推奨） | yes | |
| ユーザー → ユーザー → メディア | ||
| 有効時 | no | |
| 管理 → 一般 → GUI | ||
| 稼働時間 | no | |
| 管理 → 一般 → タイムアウト | ||
| アイテムタイプのタイムアウト | no | |
| 管理 → 一般 → コネクター | ||
| URL | yes | |
| ユーザー名 | yes | |
| パスワード | yes | |
| Bearer token | yes | |
| タイムアウト | no | |
| HTTPプロキシ | yes | |
| SSL証明書ファイル | yes | |
| SSLキー ファイル | yes | |
| SSLキー パスワード | yes | |
Zabbix でサポートされるすべてのマクロの完全な一覧については、supported macros を参照してください。
脚注
1 1つのフィールド内で複数のマクロ、またはマクロとテキストが混在する形式がその場所でサポートされていない場合、1つのマクロでフィールド全体を埋める必要があります。
2 タグ名と値で使用されるマクロは、イベント生成プロセス中にのみ解決されます。
3 secret macro を含む URL は機能しません。これは、それらの中のマクロが "******" として解決されるためです。
4 Zabbix trapper アイテムのアイテムキーではマクロはサポートされていません。