ロケーションでサポートされるユーザーマクロ
概要
このセクションには、ユーザー定義可能なマクロがサポートされている場所のリストが含まれています。
アクション、ネットワークディスカバリ、プロキシ、およびこのページのその他の場所セクションにリストされているすべての場所では、グローバルレベルのユーザーマクロのみがサポートされます。 これらの場所では、ホストレベルおよびテンプレートレベルのマクロは解決されません。
マクロ値をカスタマイズするには（たとえば、短縮したり特定の部分文字列を抽出したりする場合）、マクロ関数を使用できます。
アクション
アクションでは、ユーザーマクロを次のフィールドで使用できます。
| ロケーション | 複数のマクロ/テキストとの混合1 | |
|---|---|---|
| トリガーベースの通知とコマンド | yes | |
| トリガーベースの内部通知 | yes | |
| 障害の更新通知 | yes | |
| サービスベースの通知とコマンド | yes | |
| サービス更新通知 | yes | |
| 期間 | no | |
| オペレーション | ||
| デフォルトの操作ステップ期間 | no | |
| ステップ期間 | no | |
ホスト/ホストプロトタイプ
ホストおよびホストプロトタイプの設定では、ユーザーマクロを次のフィールドで使用できます。
| 場所 | 複数のマクロ/テキストとの組み合わせ1 | |
|---|---|---|
| インターフェースのIP/DNS | DNSのみ | |
| インターフェースのポート | いいえ | |
| SNMP | ||
| SNMPコミュニティ | はい | |
| 最大繰り返し回数 | いいえ | |
| リトライ | いいえ | |
| コンテキスト名 | はい | |
| セキュリティ名 | はい | |
| 認証パスフレーズ | はい | |
| プライバシーパスフレーズ | はい | |
| IPMI | ||
| ユーザー名 | はい | |
| パスワード | はい | |
| タグ2 | ||
| タグ名 | はい | |
| タグの値 | はい | |
アイテム / アイテムのプロトタイプ
アイテムまたはアイテムのプロトタイプの設定では、ユーザーマクロを次のフィールドで使用できます。
| 場所 | 複数のマクロ / テキストとの組み合わせ1 | |
|---|---|---|
| アイテム名 | はい | |
| アイテムキーのパラメータ | はい4 | |
| 更新間隔 | いいえ | |
| カスタム間隔 | いいえ | |
| タイムアウト（サポートされているアイテムタイプで使用可能） | いいえ | |
| 保存期間（ヒストリとトレンド） | いいえ | |
| 説明 | はい | |
| 計算 / 集計アイテム | ||
| 数式（式の定数と関数パラメータ、アイテムキーのパラメータ、（集計アイテムのみ）フィルター条件（ホストグループ名とタグ名）） | はい | |
| データベースモニター | ||
| ユーザー名 | はい | |
| パスワード | はい | |
| SQLクエリ | はい | |
| HTTPエージェント | ||
| URL3 | はい | |
| クエリフィールド | はい | |
| リクエストボディ | はい | |
| ヘッダー（名前と値） | はい | |
| 必須ステータスコード | はい | |
| HTTPプロキシ | はい | |
| HTTP認証ユーザー名 | はい | |
| HTTP認証パスワード | はい | |
| SSL証明書ファイル | はい | |
| SSLキーファイル | はい | |
| SSLキーパスワード | はい | |
| 許可されたホスト | はい | |
| JMXエージェント | ||
| JMXエンドポイント | はい | |
| スクリプトアイテム | ||
| パラメータ名と値 | はい | |
| ブラウザアイテム | ||
| パラメータ名と値 | はい | |
| Telemetryクエリアイテム | ||
| タイムシフト | いいえ | |
| ルックバック制限 | いいえ | |
| 粒度 | いいえ | |
| 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 | |
プロキシ
プロキシの設定では、ユーザーマクロを次のフィールドで使用できます。
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| Address for active agents > Port (プロキシがグループに属している場合) | no | |
| Interface address and port (passive proxy の場合) | no | |
| アイテムタイプのタイムアウト | no | |
プロキシグループ
プロキシグループの設定では、ユーザーマクロを次のフィールドで使用できます。
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| フェイルオーバー期間 | no | |
| プロキシの最小数 | no | |
テンプレート
テンプレートの設定では、次のフィールドでユーザー マクロを使用できます。
トリガー
トリガーの設定では、以下のフィールドでユーザーマクロを使用できます。
| 場所 | 複数マクロ/テキストとの混在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スクリプトのパラメータ値 | はい | |
| ダッシュボード | ||
| 上位ホストダッシュボードウィジェットのデータ型がテキストの列 | はい | |
| アイテムの値およびゲージダッシュボードウィジェットの説明パラメータ | はい | |
| ハニカムダッシュボードウィジェットのプライマリ/セカンダリラベルのテキストパラメータ | はい | |
| URLダッシュボードウィジェットのURL3パラメータ | はい | |
| 監視 > 障害、ホスト、最新データ | ||
| カスタムテキスト列 | はい | |
| データ収集 > テンプレート、ホスト | ||
| カスタムテキスト列 | はい | |
| データ収集 > イベント処理 | ||
| CEPルールの期間フィールド | はい | |
| CEPルールの容量フィールド | はい | |
| アラート > メディアタイプ > メッセージテンプレート | ||
| 件名 | はい | |
| メッセージ | はい | |
| アラート > メディアタイプ > スクリプト | ||
| スクリプトパラメータ | はい | |
| アラート > メディアタイプ > メディアタイプ | ||
| メールメディアタイプのユーザー名およびパスワードフィールド（認証が「ユーザー名とパスワード」に設定されている場合。シークレットマクロを推奨） | はい | |
| ユーザー > ユーザー > メディア | ||
| 有効期間 | はい | |
| 管理 > 一般 > GUI | ||
| 稼働時間 | いいえ | |
| 管理 > 一般 > タイムアウト | ||
| アイテムタイプのタイムアウト | いいえ | |
| 管理 > 一般 > コネクター | ||
| URL | はい | |
| ユーザー名 | はい | |
| パスワード | はい | |
| Bearerトークン | はい | |
| タイムアウト | いいえ | |
| HTTPプロキシ | はい | |
| SSL証明書ファイル | はい | |
| SSLキー ファイル | はい | |
| SSLキーパスワード | はい | |
Zabbixでサポートされているすべてのマクロの完全な一覧については、サポートされているマクロを参照してください。
脚注
1 あるフィールドで複数のマクロ、またはマクロとテキストの混在がその場所でサポートされていない場合は、1つのマクロでフィールド全体を埋める必要があります。
2 タグ名と値で使用されるマクロは、イベント生成プロセス中にのみ解決されます。
3 secret macro を含む URL は機能しません。これは、その中のマクロが "******" として解決されるためです。
4 Zabbix trapper アイテムのアイテムキーではマクロはサポートされていません。