[comment]: # translation:outdated

[comment]: # ({d428738a-d428738a})
# 2 ロケーションでサポートされているユーザーマクロ

[comment]: # ({/d428738a-d428738a})

[comment]: # ({0586ac4e-f0afb8e0})
#### 概要

このセクションには、[ユーザー定義](/manual/config/macros/user_macros)マクロがサポートされている場所の一覧が含まれています。

::: noteclassic
*アクション*、*ネットワークディスカバリ*、*プロキシ*、およびこのページの*その他の場所*セクションに記載されているすべての場所では、グローバルレベルのユーザーマクロのみがサポートされています。
記載された場所では、ホストレベルおよびテンプレートレベルのマクロは展開されません。
:::

::: noteclassic
マクロの値をカスタマイズするには（たとえば、特定の部分文字列を短縮または抽出する場合）、[マクロ関数](/manual/config/macros/macro_functions)を使用できます。
:::

[comment]: # ({/0586ac4e-f0afb8e0})

[comment]: # ({bb611c5d-7cb4c86b})
#### アクション

[アクション](/manual/config/notifications/action)では、ユーザーマクロを次のフィールドで使用できます。

|ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|トリガーベースの通知とコマンド|<|yes|
|トリガーベースの内部通知|<|yes|
|障害の更新通知|<|yes|
|サービスベースの通知とコマンド|<|yes|
|サービス更新通知|<|yes|
|期間|<|no|
|*オペレーション*|<|<|
| |デフォルトの操作ステップ期間|no|
|^|ステップ期間|no|

[comment]: # ({/bb611c5d-7cb4c86b})

[comment]: # ({9d1364cf-f30645e0})
#### ホスト/ホストプロトタイプ

[ホスト](/manual/config/hosts/host) および [ホスト
プロトタイプ](/manual/vm_monitoring/example#create-a-host-prototype) の設定では、ユーザーマクロを次のフィールドで使用できます。

|場所|<|複数のマクロ/テキストとの混在^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|インターフェース IP/DNS|<|DNS のみ|
|インターフェースポート|<|いいえ|
|*SNMP v1, v2*|<|<|
| |SNMP コミュニティ|はい|
|*SNMP v3*|<|<|
| |コンテキスト名|はい|
|^|セキュリティ名|はい|
|^|認証パスフレーズ|はい|
|^|プライバシーパスフレーズ|はい|
|*IPMI*|<|<|
| |ユーザー名|はい|
|^|パスワード|はい|
|*タグ*^[2](supported_by_location_user#footnotes)^|<|<|
| |タグ名|はい|
|^|タグ値|はい|

[comment]: # ({/9d1364cf-f30645e0})

[comment]: # ({7be6d794-d51563d6})
#### アイテム / アイテムのプロトタイプ

[アイテム](/manual/config/items/item) または [アイテムの
プロトタイプ](/manual/discovery/low_level_discovery/item_prototypes)
の設定では、以下のフィールドでユーザーマクロを使用できます。

|場所|<|複数のマクロ/テキストとの混在^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|アイテム名|<|はい|
|アイテムキーのパラメータ|<|はい|
|更新間隔|<|いいえ|
|カスタム間隔|<|いいえ|
|タイムアウト（[サポートされている](/manual/web_interface/frontend_sections/administration/general#timeouts)アイテムタイプで使用可能）|<|いいえ|
|保存期間（履歴およびトレンド）|<|いいえ|
|説明|<|はい|
|*計算/集計アイテム*|<|<|
| |数式（式の定数および関数パラメータ、アイテムキーのパラメータ、（*集計アイテムのみ*）フィルター条件（ホストグループ名およびタグ名））|はい|
|*データベースモニタ*|<|<|
| |ユーザー名|はい|
|^|パスワード|はい|
|^|SQLクエリ|はい|
|*HTTPエージェント*|<|<|
| |URL^[3](supported_by_location_user#footnotes)^|はい|
|^|クエリフィールド|はい|
|^|リクエストボディ|はい|
|^|ヘッダー（名前と値）|はい|
|^|必要なステータスコード|はい|
|^|HTTPプロキシ|はい|
|^|HTTP認証ユーザー名|はい|
|^|HTTP認証パスワード|はい|
|^|SSl証明書ファイル|はい|
|^|SSlキーファイル|はい|
|^|SSlキーパスワード|はい|
|^|許可されたホスト|はい|
|*JMXエージェント*|<|<|
| |JMXエンドポイント|はい|
|*スクリプトアイテム*|<|<|
| |パラメータ名と値|はい|
|*ブラウザアイテム*|<|<|
| |パラメータ名と値|はい|
|*SNMPエージェント*|<|<|
| |SNMP OID|はい|
|*SSHエージェント*|<|<|
| |ユーザー名|はい|
|^|公開鍵ファイル|はい|
|^|秘密鍵ファイル|はい|
|^|パスワード|はい|
|^|スクリプト|はい|
|*TELNETエージェント*|<|<|
| |ユーザー名|はい|
|^|パスワード|はい|
|^|スクリプト|はい|
|*Zabbixトラッパー*|<|<|
| |許可されたホスト|はい|
|*タグ*^[2](supported_by_location_user#footnotes)^|<|<|
| |タグ名|はい|
|^|タグ値|はい|
|*前処理ステップ*|<|<|
| |パラメータ（カスタムスクリプトを含む）|はい|
| |カスタムエラー処理パラメータ（*Set value to* および *Set error to* フィールド）|はい|

[comment]: # ({/7be6d794-d51563d6})

[comment]: # ({2e0d1dad-747bd0ca})
#### ローレベルディスカバリ

[ローレベルディスカバリ
ルール](/manual/discovery/low_level_discovery#configuring_low-level_discovery)では、
ユーザーマクロを以下のフィールドで使用できます。

|場所|<|複数のマクロ/テキストとの混在^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|キーのパラメータ|<|はい|
|更新間隔|<|いいえ|
|カスタム間隔|<|いいえ|
|タイムアウト（[サポートされている](/manual/web_interface/frontend_sections/administration/general#timeouts)アイテムタイプで利用可能）|<|いいえ|
|失われたリソースの削除|<|いいえ|
|失われたリソースの無効化|<|いいえ|
|説明|<|はい|
|*SNMPエージェント*|<|<|
| |SNMP OID|はい|
|*SSHエージェント*|<|<|
| |ユーザー名|はい|
|^|公開鍵ファイル|はい|
|^|秘密鍵ファイル|はい|
|^|パスワード|はい|
|^|スクリプト|はい|
|*TELNETエージェント*|<|<|
| |ユーザー名|はい|
|^|パスワード|はい|
|^|スクリプト|はい|
|*Zabbixトラッパー*|<|<|
| |許可されたホスト|はい|
|*データベースモニタ*|<|<|
| |ユーザー名|はい|
|^|パスワード|はい|
|^|SQLクエリ|はい|
|*JMXエージェント*|<|<|
| |JMXエンドポイント|はい|
|*HTTPエージェント*|<|<|
| |URL^[3](supported_by_location_user#footnotes)^|はい|
|^|クエリフィールド|はい|
|^|リクエストボディ|はい|
|^|ヘッダー（名前と値）|はい|
|^|必要なステータスコード|はい|
|^|HTTP認証のユーザー名|はい|
|^|HTTP認証のパスワード|はい|
|*フィルター*|<|<|
| |正規表現|はい|
|*オーバーライド*|<|<|
| |フィルター: 正規表現|はい|
|^|操作: 更新間隔（アイテムのプロトタイプ用）|いいえ|
|^|操作: 履歴保存期間（アイテムのプロトタイプ用）|いいえ|
|^|操作: トレンド保存期間（アイテムのプロトタイプ用）|いいえ|

[comment]: # ({/2e0d1dad-747bd0ca})

[comment]: # ({7c6ab06a-95f2f372})
#### ネットワークディスカバリ

[ネットワークディスカバリルール](/manual/discovery/network_discovery/rule) では、次のフィールドでユーザー マクロを使用できます。

|ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|監視間隔|<|no|
|*SNMP v1, v2*|<|<|
| |SNMP コミュニティ|yes|
|^|SNMP OID|yes|
|*SNMP v3*|<|<|
| |コンテキスト名|yes|
|^|セキュリティ名|yes|
|^|認証パスフレーズ|yes|
|^|プライバシーパスフレーズ|yes|
|^|SNMP OID|yes|

[comment]: # ({/7c6ab06a-95f2f372})

[comment]: # ({3962fa7e-575d88fc})
#### プロキシ

[プロキシ](/manual/distributed_monitoring/proxies#configuration)
の設定では、ユーザーマクロを次のフィールドで使用できます。

|場所|<|複数のマクロ/テキストとの混在^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|*アクティブエージェントのアドレス > ポート*（プロキシがグループに属している場合）|<|いいえ|
|インターフェースのアドレスとポート（パッシブプロキシの場合）|<|いいえ|
|アイテムタイプのタイムアウト|<|いいえ|

[comment]: # ({/3962fa7e-575d88fc})

[comment]: # ({76ff2b0f-dbeb9eca})
#### プロキシグループ

[プロキシグループ](/manual/distributed_monitoring/proxies/ha#configuring-a-proxy-group)
構成では、以下のフィールドでユーザーマクロを使用できます。

|場所|<|複数のマクロ/テキストとの混在^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|フェイルオーバー期間|<|いいえ|
|プロキシの最小数|<|いいえ|

[comment]: # ({/76ff2b0f-dbeb9eca})

[comment]: # ({d5117b03-32b6aef1})
#### テンプレート

[テンプレート](/manual/config/templates/template)の設定では、次のフィールドでユーザー マクロを使用できます。

|ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|*タグ*^[2](supported_by_location_user#footnotes)^|<|<|
| |タグ名|yes|
|^|タグ値|yes|

[comment]: # ({/d5117b03-32b6aef1})

[comment]: # ({0d27e496-c78b04ef})
#### トリガー

[トリガー](/manual/config/triggers/trigger) の設定では、ユーザーマクロを以下のフィールドで使用できます。

|場所|<|複数のマクロ/テキストとの混在^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|名前|<|はい|
|運用データ|<|はい|
|条件式（定数および関数パラメータ内のみ。シークレットマクロはサポートされません）|<|はい|
|一致用タグ|<|はい|
|メニューエントリ名|<|はい|
|メニューエントリURL^[3](supported_by_location_user#footnotes)^|<|はい|
|説明|<|はい|
|*タグ*^[2](supported_by_location_user#footnotes)^|<|<|
| |タグ名|はい|
|^|タグ値|はい|

[comment]: # ({/0d27e496-c78b04ef})

[comment]: # ({423f6587-78f1f511})
#### Web シナリオ

[Webシナリオ](/manual/web_monitoring)の設定では、次のフィールドでユーザー マクロを使用できます。

|ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|名前|<|yes|
|監視間隔|<|no|
|エージェント|<|yes|
|HTTPプロキシ|<|yes|
|変数 (値のみ)|<|yes|
|ヘッダー (名前と値)|<|yes|
|*ステップ*|<|<|
| |名前|yes|
|^|URL^[3](supported_by_location_user#footnotes)^|yes|
|^|変数 (値のみ)|yes|
|^|ヘッダー (名前と変数)|yes|
|^|タイムアウト|no|
|^|要求文字列|yes|
|^|要求ステータスコード|no|
|*認証*|<|<|
| |ユーザー|yes|
|^|パスワード|yes|
|^|SSL 証明書ファイル|yes|
|^|SSL 秘密鍵ファイル|yes|
|^|SSL 秘密鍵パスワード|yes|
|*タグ*^[2](supported_by_location_user#footnotes)^|<|<|
| |タグ名|yes|
|^|タグ値|yes|

[comment]: # ({/423f6587-78f1f511})

[comment]: # ({1052c243-efe84e1d})
#### その他の場所

ここに記載されている場所に加えて、ユーザーマクロは以下のフィールドでも使用できます。

|場所|<|複数のマクロ/テキストとの混在^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|グローバルスクリプト（URL、スクリプト、SSH、Telnet、IPMI）、確認テキストを含む|<|はい|
|webhook|<|<|
| |JavaScriptスクリプト|いいえ|
|^|JavaScriptスクリプトパラメータ名|いいえ|
|^|JavaScriptスクリプトパラメータ値|はい|
|*ダッシュボード*|<|<|
| |*Top hosts* ダッシュボードウィジェットのデータ型 *Text* の列|はい|
|^|*Item value* および *Gauge* ダッシュボードウィジェットの *Description* パラメータ|はい|
|^|*Honeycomb* ダッシュボードウィジェットの Primary/Secondary label *Text* パラメータ|はい|
|^|*URL* ダッシュボードウィジェットの *URL*^[3](supported_by_location_user#footnotes)^ パラメータ|はい|
|*ユーザー → ユーザー → メディア*|<|<|
| |アクティブ時間|いいえ|
|*管理 → 一般 → GUI*|<|<|
| |稼働時間|いいえ|
|*管理 → 一般 → タイムアウト*|<|<|
| |アイテムタイプのタイムアウト|いいえ|
|*管理 → 一般 → コネクタ*|<|<|
| |URL|はい|
|^|ユーザー名|はい|
|^|パスワード|はい|
|^|Bearerトークン|はい|
|^|タイムアウト|いいえ|
|^|HTTPプロキシ|はい|
|^|SSL証明書ファイル|はい|
|^|SSLキーファイル|はい|
|^|SSLキーのパスワード|はい|
|*アラート → メディアタイプ → メッセージテンプレート*|<|<|
| |件名|はい|
|^|メッセージ|はい|
|*アラート → メディアタイプ → スクリプト*|<|<|
| |スクリプトパラメータ|はい|
|*アラート → メディアタイプ → メディアタイプ*|<|<|
| |*Email* メディアタイプの *Username* および *Password* フィールド（*Authentication* が「Username and password」に設定されている場合。[secret macros](/manual/config/macros/user_macros#configuration) の使用を推奨）|はい|

Zabbixでサポートされているすべてのマクロの完全な一覧については、[サポートされているマクロ](/manual/appendix/macros/supported_by_location)を参照してください。

[comment]: # ({/1052c243-efe84e1d})

[comment]: # ({3f947571-5a370e78})
##### 脚注

^**1**^ フィールド内の複数のマクロまたはテキストと混合されたマクロがそのロケーションでサポートされていない場合は、1 つのマクロでフィールド全体を埋める必要があります。

^**2**^ タグ名と値で使用されるマクロは、イベント生成プロセス中にのみ解決されます。

^**3**^ [シークレットマクロ](/manual/config/macros/user_macros#configuration)を含む URL は機能しません。それらのマクロは"\*\*\*\*\*\*"のように解決されます。

[comment]: # ({/3f947571-5a370e78})