[comment]: # translation:outdated

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

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

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

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

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

[comment]: # ({/dfeb4d97-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]: # ({74a90176-f30645e0})
#### Hosts/host prototypes

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

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

[comment]: # ({/74a90176-f30645e0})

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

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

|ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|キー|<|yes|
|監視間隔|<|no|
|監視間隔のカスタマイズ|<|no|
|ヒストリの保存期間|<|no|
|トレンドの保存期間|<|no|
|説明|<|yes|
|*計算*|<|<|
| |式|yes|
|*データベースモニタ*|<|<|
| |ユーザー名|yes|
|^|パスワード|yes|
|^|SQLクエリ|yes|
|*HTTP エージェント*|<|<|
| |URL^[3](supported_by_location_user#footnotes)^|yes|
|^|クエリフィールド|yes|
|^|タイムアウト|no|
|^|リクエストボディ|yes|
|^|ヘッダ (名前と 値)|yes|
|^|要求ステータスコード|yes|
|^|HTTP プロキシ|yes|
|^|HTTP 認証のユーザー名|yes|
|^|HTTP 認証のパスワード|yes|
|^|SSl 証明書ファイル|yes|
|^|SSl 秘密鍵ファイル|yes|
|^|SSl 秘密鍵パスワード|yes|
|^|許可されたホスト|yes|
|*JMX エージェント*|<|<|
| |JMX エンドポイント|yes|
|*スクリプト*|<|<|
| |パラメータの名前と値|yes|
|*SNMP エージェント*|<|<|
| |SNMP OID|yes|
|*SSH エージェント*|<|<|
| |ユーザー名|yes|
|^|公開鍵ファイル|yes|
|^|秘密鍵ファイル|yes|
|^|パスワード|yes|
|^|スクリプト|yes|
|*TELNET エージェント*|<|<|
| |ユーザー名|yes|
|^|パスワード|yes|
|^|実行するスクリプト|yes|
|*Zabbix トラッパー*|<|<|
| |許可されたホスト|yes|
|*タグ*^[2](supported_by_location_user#footnotes)^|<|<|
| |タグ名|yes|
|^|タグ値yes|
|*前処理*|<|<|
| |ステップ パラメーター (カスタム スクリプトを含む)|yes|

[comment]: # ({/8f12bfe5-d51563d6})

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

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

|ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|キー|<|yes|
|監視間隔|<|no|
|監視間隔のカスタマイズ|<|no|
|存在しなくなったリソースの保持期間|<|no|
|説明|<|yes|
|*SNMPエージェント*|<|<|
| |SNMP OID|yes|
|*SSHエージェント*|<|<|
| |ユーザー名|yes|
|^|公開鍵ファイル|yes|
|^|秘密鍵ファイル|yes|
|^|パスワード|yes|
|^|実行するスクリプト|yes|
|*TELNETエージェント*|<|<|
| |ユーザー名|yes|
|^|パスワード|yes|
|^|実行するスクリプト|yes|
|*Zabbixトラッパー*|<|<|
| |許可されたホスト|yes|
|*データベースモニタ*|<|<|
| |ユーザー名|yes|
|^|パスワード|yes|
|^|SQL クエリ|yes|
|*JMX エージェント*|<|<|
| |JMX エンドポイント|yes|
|*HTTP エージェント*|<|<|
| |URL^[3](supported_by_location_user#footnotes)^|yes|
|^|クエリフィールド|yes|
|^|タイムアウト|no|
|^|リクエストボディ|yes|
|^|ヘッダー (名前と値)|yes|
|^|要求ステータスコード|yes|
|^|HTTP認証ユーザー名|yes|
|^|HTTP認証パスワード|yes|
|*フィルター*|<|<|
| |正規表現|yes|
|*オーバーライド*|<|<|
| |フィルター: 正規表現|yes|
|^|実行内容の作成: 監視間隔 (アイテムのプロトタイプ)|no|
|^|実行内容の作成: ヒストリの保存期間 (アイテムのプロトタイプ)|no|
|^|実行内容の作成: トレンドの保存期間 (アイテムのプロトタイプ)|no|

[comment]: # ({/e2469945-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]: # ({1fbebf42-575d88fc})
#### プロキシ

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

|ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|インターフェースポート (パッシブプロキシ)|<|no|

[comment]: # ({/1fbebf42-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]: # ({cc768849-c78b04ef})
#### トリガー

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

|ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|名前|<|yes|
|運用データ|<|yes|
|条件式 (定数と関数パラメーターのみ。シークレットマクロはサポートされていません)|<|yes|
|説明|<|yes|
|URL^[3](supported_by_location_user#footnotes)^|<|yes|
|クローズに利用するタグ名|<|yes|
|*タグ*^[2](supported_by_location_user#footnotes)^|<|<|
| |タグ名|yes|
|^|タグ値|yes|

[comment]: # ({/cc768849-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]: # ({f452cc81-efe84e1d})
#### 他のロケーション

ユーザー マクロはここにリストされているロケーションに加えて、次のフィールドで使用できます。

|ロケーション|<|複数マクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^|
|-|------------------------------|----------|
|グローバルスクリプト (script, SSH, Telnet, IPMI), 確認テキストを含む|<|yes|
|Webhooks|<|<|
| |JavaScript スクリプト|no|
|^|JavaScript スクリプトパラメータ名|no|
|^|JavaScript スクリプトパラメータ値|yes|
|*監視データ → ダッシュボード*|<|<|
| |*アイテム値* ダッシュボード ウィジェットの説明フィールド|yes|
|^|URL^[3](supported_by_location_user#footnotes)^ および*動的 URL* ダッシュボード ウィジェットのフィールド|yes|
|*管理 → ユーザー → メディア*|<|<|
| |アクティブ時|no|
|*管理 → 一般設定 → 表示設定*|<|<|
| |ワーキングタイム|no|
|*管理 → メディアタイプ → メッセージテンプレート*|<|<|
| |件名|yes|
|^|メッセージ|yes|

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

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

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

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

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

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

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