[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)^|<|<|
| |タグ名|はい|
|^|タグ値|はい|
|*プリプロセス手順*|<|<|
| |パラメータ(カスタムスクリプトを含む)|はい|
| |カスタムエラーハンドリングパラメータ(*値を設定*および*エラーを設定*フィールド)|はい|

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

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

[ローレベルディスカバリ
ルール](/manual/discovery/low_level_discovery#configuring-lowlevel-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]: # ({/04aa381c-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]: # ({f63f6226-efe84e1d})
#### その他の場所

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

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

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

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

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

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

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

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

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