en-us	#### History  Retrieve historical values gathered by Zabbix monitoring processes for presentation or further processing.  [History API](/manual/api/reference/history)
ja	#### ヒストリ  Zabbix監視プロセスによって収集された過去の値を取得し、表示やさらなる処理を行うことができます。  [History API](/manual/api/reference/history)

en-us	# History  This class is designed to work with history data.  Object references:\  -   [History](/manual/api/reference/history/object#history)  Available methods:\  -   [history.get](/manual/api/reference/history/get) - retrieving     history data.
ja	# History  このクラスは、ヒストリデータを操作するためのものです。  オブジェクトリファレンス :\  -   [History](/manual/api/reference/history/object#history)  利用可能なメソッド :\  -   [history.get](/manual/api/reference/history/get) - ヒストリデータの取得

en-us	 ### HMAC function for JavaScript  A new function has been added to the JavaScript engine allowing to return HMAC hash:  -   `hmac('<hash type>',key,string)`  This is useful for cases when hash-based message authentication code (HMAC) is required for signing requests. MD5 and SHA256 hash types are supported, e. g.:     -   `hmac('md5',key,string)`    -   `hmac('sha256',key,string)`
ja	 ### JavaScript用のHMAC関数  JavaScriptエンジンに新しい関数が追加され、HMACハッシュを返すことができるようになりました：  -   `hmac('<hash type>',key,string)`  これは、リクエストの署名にハッシュベースのメッセージ認証コード(HMAC)が必要な場合に役立ちます。 MD5およびSHA256ハッシュタイプがサポートされています。例：     -   `hmac('md5',key,string)`    -   `hmac('sha256',key,string)`

en-us	#### Host access from several user groups  A user may belong to any number of user groups. These groups may have different access permissions to hosts.  Therefore, it is important to know what hosts an unprivileged user will be able to access as a result. For example, let us consider how access to host **X** (in Hostgroup 1) will be affected in various situations for a user who is in user groups A and B.  -   If Group A has only *Read* access to Hostgroup 1, but Group B     *Read-write* access to Hostgroup 1, the user will get **Read-write**     access to 'X'.  ::: noteimportant “Read-write” permissions have precedence over “Read” permissions starting with Zabbix 2.2. :::  -   In the same scenario as above, if 'X' is simultaneously also in     Hostgroup 2 that is **denied** to Group A or B, access to 'X' will     be **unavailable**, despite a *Read-write* access to Hostgroup 1. -   If Group A has no permissions defined and Group B has a *Read-write*     access to Hostgroup 1, the user will get **Read-write** access to     'X'. -   If Group A has *Deny* access to Hostgroup 1 and Group B has a     *Read-write* access to Hostgroup 1, the user will get access to 'X'     **denied**.
ja	#### 複数のユーザーグループからのホストアクセス  ユーザーは、任意の数のユーザーグループに所属することができます。これらのグループは、ホストに対する異なるアクセス権限を持つことができます。  したがって、非特権ユーザーが結果的にどのホストにアクセスできるようになるかを知ることは重要です。例えば、ユーザーグループAとBに属するユーザーにとって、(ホストグループ1に属する)ホスト**X** へのアクセスが様々な状況でどのように影響されるかを考えてみましょう。  -   グループAがホストグループ1への*表示のみ*のアクセス権しか持っておらず、グループBがホストグループ1への*表示/設定*アクセス権を持っている場合、ユーザーは'X'への **表示/設定**アクセス権を取得することになります。  ::: noteimportant Zabbix2.2以降から権限"表示/設定"は権限"表示のみ"より優先されます。 :::  -   上記と同じシナリオで、'X'が同時にグループAまたはBに**拒否**されているホストグループ2にも属している場合、ホストグループ1への*表示/設定*のアクセス権があるにもかかわらず、'X'へのアクセスは**不可能**となります。 -   グループAに何の権限も定義されておらず、グループBにホストグループ1への*表示/設定*のアクセス権がある場合、そのユーザーは'X'への*表示/設定*のアクセス権を得ることができます。 -   グループAがホストグループ1への*拒否*のアクセス権を持っており、グループBがホストグループ1への*表示/設定*のアクセス権を持っている場合、そのユーザーは'Xへの*拒否*のアクセス権を得ます。

en-us	##### Host configuration  A host must be configured to process IPMI checks. An IPMI interface must be added, with the respective IP and port numbers, and IPMI authentication parameters must be defined.  See the [configuration of hosts](/manual/config/hosts/host) for more details.
ja	##### ホストの設定  IPMI チェックを処理するために、ホストを設定する必要があります。<br> IPMI インターフェイスをを追加し、それぞれの IPアドレス およびポート番号を指定し、IPMI 認証パラメーターを定義する必要があります。  詳細は、[configuration of hosts](/manual/config/hosts/host) を参照してください。

en-us	#### Host configuration  To use VMware simple checks the host must have the following user macros defined:  -   **{$VMWARE.URL}** - VMware service (vCenter or ESX hypervisor) SDK     URL (<https://servername/sdk>) -   **{$VMWARE.USERNAME}** - VMware service user name -   **{$VMWARE.PASSWORD}** - VMware service {$VMWARE.USERNAME} user     password
ja	#### ホストの構成  VMwareシンプルチェックを使用するには、ホストに以下のユーザーマクロが定義されている必要があります。 <br>  - **{$VMWARE.URL}** - VMwareサービス(vCenterまたはESXハイパーバイザー) SDK URL (<https://servername/sdk>) - **{$VMWARE.USERNAME}** - VMwareサービスのユーザー名 - **{$VMWARE.PASSWORD}** - VMware サービス {$VMWARE.USERNAME} ユーザー名 パスワード

en-us	##### Host configuration  You can specify that an individual host should be monitored by a proxy in the [host configuration](/manual/config/hosts/host) form, using the *Monitored by proxy* field.  ![](../../../assets/en/manual/proxies/proxy_set.png)  Host [mass update](/manual/config/hosts/hostupdate) is another way of specifying that hosts should be monitored by a proxy.
ja	##### ホストの設定  *Monitored by proxy*フィールドを使用して、[host configuration](/manual/config/hosts/host)フォームでプロキシによって個々のホストを監視するように指定できます。  ![](../../../assets/en/manual/proxies/proxy_set.png)  ホストの[一括更新](/manual/config/hosts/hostupdate)は、ホストをプロキシで監視指定するもう1つの方法です。

en-us	# host.create
ja	# host.create

en-us	##### Host creation  A host is added if the *Add host* operation is selected. A host is also added, even if the *Add host* operation is missing, if you select operations resulting in actions on a host. Such operations are:  -   enable host -   disable host -   add host to a host group -   link template to a host  Created hosts are added to the *Discovered hosts* group (by default, configurable in *Administration* → *General* → *[Other](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). If you wish hosts to be added to another group, add a *Remove from host groups* operation (specifying "Discovered hosts") and also add an *Add to host groups* operation (specifying another host group), because a host must belong to a host group.
ja	##### ホストの作成  *ホストの追加*操作が選択されている場合にホストが追加されますが、 *ホストの追加*操作を選択していない場合でも、ホストでアクションが発生する操作を選択すると、ホストも追加されます。そのような操作は次のとおりです。  -   ホストを有効にする -   ホストを無効にする -   ホストをホストグループに追加する -   テンプレートをホストにリンクする  作成されたホストは*Discovered hosts *グループに追加されます。（デフォルトでは、*管理*→*一般*→*[その他](/manual/web_interface/frontend_sections/administration/general#other_parameters)*で設定可能） ホストを別のグループに追加する場合は* Remove from hostgroups*操作を追加します。（"Discovered hosts"を指定）また、ホストはホストグループに属している必要があるため、*Add to host groups*操作（追加先は別のホストグループを指定）を追加します。

en-us	# host.delete
ja	# host.delete

en-us	#### Host editing as popup  The form for host creation and editing is now opened in a modal (popup) window, in *Configuration* → *Hosts*, *Monitoring* → *Hosts* and in any page, where there is a host menu or other direct link to the host configuration.  Direct links to the host edit page still work and are opening the host edit page in full page.
ja	#### ホスト定義編集をポップアップで表示  ホストメニューやホスト設定への直接リンクがある、*設定*→*ホスト*、*監視データ*→*ホスト*、および任意のページで、ホスト定義の作成と編集のためのフォームがモーダル（ポップアップ）ウィンドウで開かれます。  ホスト編集ページへの直接リンクはまだ機能しており、全画面でホスト編集ページを開きます。

en-us	# host.get
ja	# host.get

en-us	##### Host graph tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |graphs|<|\-|<|<|Root element for graphs.| |<|name|x|`string`|<|Graph name.| |<|width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| |<|height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| |<|yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| |<|yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| |<|show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| |<|show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| |<|type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| |<|show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| |<|show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| |<|percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| |<|percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| |<|ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| |<|ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1|<|\-|<|<|Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| |ymax\_item\_1|<|\-|<|<|Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| |graph\_items|<|x|<|<|Root element for graph items.| |<|sortorder|\-|`integer`|<|Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| |<|drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| |<|color|\-|`string`|<|Element color (6 symbols, hex).| |<|yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| |<|calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| |<|type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item|<|x|<|<|Individual item.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.|
ja	##### Host graph タグ  |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |graphs|<|\-|<|<|Root element for graphs.| |<|name|x|`string`|<|Graph name.| |<|width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| |<|height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| |<|yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| |<|yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| |<|show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| |<|show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| |<|type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| |<|show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| |<|show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| |<|percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| |<|percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| |<|ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| |<|ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1|<|\-|<|<|Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| |ymax\_item\_1|<|\-|<|<|Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| |graph\_items|<|x|<|<|Root element for graph items.| |<|sortorder|\-|`integer`|<|Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| |<|drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| |<|color|\-|`string`|<|Element color (6 symbols, hex).| |<|yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| |<|calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| |<|type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item|<|x|<|<|Individual item.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.|

en-us	#### host group  Changes:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: `hosts` and `templates` fields are now required.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: added strict validation of the method parameters.\
ja	#### ホストグループ  変更点:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: `hosts` と `templates` のフィールド入力が必須になりました。\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: メソッドパラメーターのバリデーションが強化されました。\

en-us	#### hostgroup  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: the parameter `uuid` can now be updated.\
ja	#### ホストグループ  変更点:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: パラメーター `uuid` が更新できるようになりました。\

en-us	# hostgroup.create
ja	# hostgroup.create

en-us	# hostgroup.delete
ja	# hostgroup.delete

en-us	# hostgroup.get
ja	# hostgroup.get

en-us	# hostgroup.massadd
ja	# hostgroup.massadd

en-us	# hostgroup.massremove
ja	# hostgroup.massremove

en-us	# hostgroup.massupdate
ja	# hostgroup.massupdate

en-us	# > Host group object  The following objects are directly related to the `hostgroup` API.
ja	# > Host groupオブジェクト  次のオブジェクトは、`hostgroup`APIに直接関連しています。

en-us	### Host group  The host group object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|*(readonly)* ID of the host group.| |**name**<br>(required)|string|Name of the host group.| |flags|integer|*(readonly)* Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.| |internal|integer|*(readonly)* Whether the group is used internally by the system. An internal group cannot be deleted.<br><br>Possible values:<br>0 - *(default)* not internal;<br>1 - internal.| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.|
ja	### Host group  host group object オブジェクトは、以下のプロパティを持ちます。  |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |groupid|string|*(readonly)* ID of the host group.| |**name**<br>(required)|string|Name of the host group.| |flags|integer|*(readonly)* Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.| |internal|integer|*(readonly)* Whether the group is used internally by the system. An internal group cannot be deleted.<br><br>Possible values:<br>0 - *(default)* not internal;<br>1 - internal.| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.|

en-us	# Host group  This class is designed to work with host groups.  Object references:\  -   [Host group](/manual/api/reference/hostgroup/object#host_group)  Available methods:\  -   [hostgroup.create](/manual/api/reference/hostgroup/create) -     creating new host groups -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) -     deleting host groups -   [hostgroup.get](/manual/api/reference/hostgroup/get) - retrieving     host groups -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) -     adding related objects to host groups -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) -     removing related objects from host groups -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) -     replacing or removing related objects from host groups -   [hostgroup.update](/manual/api/reference/hostgroup/update) -     updating host groups
ja	# Host group  このクラスは、ホストグループを操作するためのものです。  オブジェクトリファレンス :\  -   [Host group](/manual/api/reference/hostgroup/object#host_group)  利用可能なメソッド :\  -   [hostgroup.create](/manual/api/reference/hostgroup/create) - 新しいホストグループの作成 -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) - ホストグループの削除 -   [hostgroup.get](/manual/api/reference/hostgroup/get) - ホストグループの取得 -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - ホストグループへ関連オブジェクトの追加 -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - ホストグループから関連オブジェクトの削除 -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - ホストグループの関連するオブジェクトを交換または削除 -   [hostgroup.update](/manual/api/reference/hostgroup/update) - ホストグループの更新

en-us	# hostgroup.update
ja	# hostgroup.update

en-us	# hostinterface.create
ja	# hostinterface.create

en-us	# hostinterface.delete
ja	# hostinterface.delete

en-us	# hostinterface.get
ja	# hostinterface.get

en-us	# hostinterface.massadd
ja	# hostinterface.massadd

en-us	# hostinterface.massremove
ja	# hostinterface.massremove

en-us	# > Host interface object  The following objects are directly related to the `hostinterface` API.
ja	# > Host interfaceオブジェクト  次のオブジェクトは、`hostinterface`APIに直接関連しています。

en-us	# hostinterface.replacehostinterfaces
ja	# hostinterface.replacehostinterfaces

en-us	# Host interface  This class is designed to work with host interfaces.  Object references:\  -   [Host     interface](/manual/api/reference/hostinterface/object#host_interface)  Available methods:\  -   [hostinterface.create](/manual/api/reference/hostinterface/create) -     creating new host interfaces -   [hostinterface.delete](/manual/api/reference/hostinterface/delete) -     deleting host interfaces -   [hostinterface.get](/manual/api/reference/hostinterface/get) -     retrieving host interfaces -   [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) -     adding host interfaces to hosts -   [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) -     removing host interfaces from hosts -   [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) -     replacing host interfaces on a host -   [hostinterface.update](/manual/api/reference/hostinterface/update) -     updating host interfaces
ja	# Host interface  このクラスは、ホストインターフェースを操作するためのものです。  オブジェクトリファレンス :\  -   [Host interface](/manual/api/reference/hostinterface/object#host_interface)  利用可能なメソッド :\  -   [hostinterface.create](/manual/api/reference/hostinterface/create) - 新しいホストインターフェースの作成 -   [hostinterface.delete](/manual/api/reference/hostinterface/delete) - ホストインターフェースの削除 -   [hostinterface.get](/manual/api/reference/hostinterface/get) - ホストインターフェースの取得 -   [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - ホストへホストインターフェースの追加 -   [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - ホストからホストインターフェースの削除 -   [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - ホストのホストインターフェースの置換 -   [hostinterface.update](/manual/api/reference/hostinterface/update) - ホストインターフェースの更新

en-us	# hostinterface.update
ja	# hostinterface.update

en-us	### Host inventory  The host inventory object has the following properties.  ::: notetip Each property has it's own unique ID number, which is used to associate host inventory fields with items. :::  |ID|Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|--|------| |4|alias|string|Alias.| |11|asset\_tag|string|Asset tag.| |28|chassis|string|Chassis.| |23|contact|string|Contact person.| |32|contract\_number|string|Contract number.| |47|date\_hw\_decomm|string|HW decommissioning date.| |46|date\_hw\_expiry|string|HW maintenance expiry date.| |45|date\_hw\_install|string|HW installation date.| |44|date\_hw\_purchase|string|HW purchase date.| |34|deployment\_status|string|Deployment status.| |14|hardware|string|Hardware.| |15|hardware\_full|string|Detailed hardware.| |39|host\_netmask|string|Host subnet mask.| |38|host\_networks|string|Host networks.| |40|host\_router|string|Host router.| |30|hw\_arch|string|HW architecture.| |33|installer\_name|string|Installer name.| |24|location|string|Location.| |25|location\_lat|string|Location latitude.| |26|location\_lon|string|Location longitude.| |12|macaddress\_a|string|MAC address A.| |13|macaddress\_b|string|MAC address B.| |29|model|string|Model.| |3|name|string|Name.| |27|notes|string|Notes.| |41|oob\_ip|string|OOB IP address.| |42|oob\_netmask|string|OOB host subnet mask.| |43|oob\_router|string|OOB router.| |5|os|string|OS name.| |6|os\_full|string|Detailed OS name.| |7|os\_short|string|Short OS name.| |61|poc\_1\_cell|string|Primary POC mobile number.| |58|poc\_1\_email|string|Primary email.| |57|poc\_1\_name|string|Primary POC name.| |63|poc\_1\_notes|string|Primary POC notes.| |59|poc\_1\_phone\_a|string|Primary POC phone A.| |60|poc\_1\_phone\_b|string|Primary POC phone B.| |62|poc\_1\_screen|string|Primary POC screen name.| |68|poc\_2\_cell|string|Secondary POC mobile number.| |65|poc\_2\_email|string|Secondary POC email.| |64|poc\_2\_name|string|Secondary POC name.| |70|poc\_2\_notes|string|Secondary POC notes.| |66|poc\_2\_phone\_a|string|Secondary POC phone A.| |67|poc\_2\_phone\_b|string|Secondary POC phone B.| |69|poc\_2\_screen|string|Secondary POC screen name.| |8|serialno\_a|string|Serial number A.| |9|serialno\_b|string|Serial number B.| |48|site\_address\_a|string|Site address A.| |49|site\_address\_b|string|Site address B.| |50|site\_address\_c|string|Site address C.| |51|site\_city|string|Site city.| |53|site\_country|string|Site country.| |56|site\_notes|string|Site notes.| |55|site\_rack|string|Site rack location.| |52|site\_state|string|Site state.| |54|site\_zip|string|Site ZIP/postal code.| |16|software|string|Software.| |18|software\_app\_a|string|Software application A.| |19|software\_app\_b|string|Software application B.| |20|software\_app\_c|string|Software application C.| |21|software\_app\_d|string|Software application D.| |22|software\_app\_e|string|Software application E.| |17|software\_full|string|Software details.| |10|tag|string|Tag.| |1|type|string|Type.| |2|type\_full|string|Type details.| |35|url\_a|string|URL A.| |36|url\_b|string|URL B.| |37|url\_c|string|URL C.| |31|vendor|string|Vendor.|
ja	### Host インベントリ  Host インベントリオブジェクトは、以下のプロパティを持ちます。  ::: notetip 各プロパティには固有のID番号があり、ホストインベントリフィールドと item の関連付けに使用されます。 :::  |ID|プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|--|------| |4|alias|string|Alias.| |11|asset\_tag|string|Asset tag.| |28|chassis|string|Chassis.| |23|contact|string|Contact person.| |32|contract\_number|string|Contract number.| |47|date\_hw\_decomm|string|HW decommissioning date.| |46|date\_hw\_expiry|string|HW maintenance expiry date.| |45|date\_hw\_install|string|HW installation date.| |44|date\_hw\_purchase|string|HW purchase date.| |34|deployment\_status|string|Deployment status.| |14|hardware|string|Hardware.| |15|hardware\_full|string|Detailed hardware.| |39|host\_netmask|string|Host subnet mask.| |38|host\_networks|string|Host networks.| |40|host\_router|string|Host router.| |30|hw\_arch|string|HW architecture.| |33|installer\_name|string|Installer name.| |24|location|string|Location.| |25|location\_lat|string|Location latitude.| |26|location\_lon|string|Location longitude.| |12|macaddress\_a|string|MAC address A.| |13|macaddress\_b|string|MAC address B.| |29|model|string|Model.| |3|name|string|Name.| |27|notes|string|Notes.| |41|oob\_ip|string|OOB IP address.| |42|oob\_netmask|string|OOB host subnet mask.| |43|oob\_router|string|OOB router.| |5|os|string|OS name.| |6|os\_full|string|Detailed OS name.| |7|os\_short|string|Short OS name.| |61|poc\_1\_cell|string|Primary POC mobile number.| |58|poc\_1\_email|string|Primary email.| |57|poc\_1\_name|string|Primary POC name.| |63|poc\_1\_notes|string|Primary POC notes.| |59|poc\_1\_phone\_a|string|Primary POC phone A.| |60|poc\_1\_phone\_b|string|Primary POC phone B.| |62|poc\_1\_screen|string|Primary POC screen name.| |68|poc\_2\_cell|string|Secondary POC mobile number.| |65|poc\_2\_email|string|Secondary POC email.| |64|poc\_2\_name|string|Secondary POC name.| |70|poc\_2\_notes|string|Secondary POC notes.| |66|poc\_2\_phone\_a|string|Secondary POC phone A.| |67|poc\_2\_phone\_b|string|Secondary POC phone B.| |69|poc\_2\_screen|string|Secondary POC screen name.| |8|serialno\_a|string|Serial number A.| |9|serialno\_b|string|Serial number B.| |48|site\_address\_a|string|Site address A.| |49|site\_address\_b|string|Site address B.| |50|site\_address\_c|string|Site address C.| |51|site\_city|string|Site city.| |53|site\_country|string|Site country.| |56|site\_notes|string|Site notes.| |55|site\_rack|string|Site rack location.| |52|site\_state|string|Site state.| |54|site\_zip|string|Site ZIP/postal code.| |16|software|string|Software.| |18|software\_app\_a|string|Software application A.| |19|software\_app\_b|string|Software application B.| |20|software\_app\_c|string|Software application C.| |21|software\_app\_d|string|Software application D.| |22|software\_app\_e|string|Software application E.| |17|software\_full|string|Software details.| |10|tag|string|Tag.| |1|type|string|Type.| |2|type\_full|string|Type details.| |35|url\_a|string|URL A.| |36|url\_b|string|URL B.| |37|url\_c|string|URL C.| |31|vendor|string|Vendor.|

en-us	##### Host item tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |items|<|\-|<|<|Root element for items.| |<|name|x|`string`|<|Item name.| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULATED<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Item type.| |<|snmp\_oid|\-|`string`|<|SNMP object ID.<br><br>Required by SNMP items.| |<|key|x|`string`|<|Item key.| |<|delay|\-|`string`|Default: 1m|Update interval of the item.<br><br>Note that `delay` will be always '0' for trapper items.<br><br>Accepts seconds or a time unit with suffix (30s, 1m, 2h, 1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| |<|history|\-|`string`|Default: 90d|A time unit of how long the history data should be stored. Time unit with suffix, user macro or LLD macro.| |<|trends|\-|`string`|Default: 365d|A time unit of how long the trends data should be stored. Time unit with suffix, user macro or LLD macro.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Item status.| |<|value\_type|\-|`string`|0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (default)<br>4 - TEXT|Received value type.| |<|allowed\_hosts|\-|`string`|<|List of IP addresses (comma delimited) of hosts allowed sending data for the item.<br><br>Used by trapper and HTTP agent items.| |<|units|\-|`string`|<|Units of returned values (bps, B, etc).| |<|params|\-|`text`|<|Additional parameters depending on the type of the item:<br>- executed script for Script, SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items.| |<|ipmi\_sensor|\-|`string`|<|IPMI sensor.<br><br>Used only by IPMI items.| |<|authtype|\-|`string`|Authentication type for SSH agent items:<br>0 - PASSWORD (default)<br>1 - PUBLIC\_KEY<br><br>Authentication type for HTTP agent items:<br>0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication type.<br><br>Used only by SSH and HTTP agent items.| |<|username|\-|`string`|<|Username for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX agent, password should also be specified together with the username or both properties should be left blank.| |<|password|\-|`string`|<|Password for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>When used by JMX agent, username should also be specified together with the password or both properties should be left blank.| |<|publickey|\-|`string`|<|Name of the public key file.<br><br>Required for SSH agent items.| |<|privatekey|\-|`string`|<|Name of the private key file.<br><br>Required for SSH agent items.| |<|description|\-|`text`|<|Item description.| |<|inventory\_link|\-|`string`|0 - NONE<br><br>Capitalized host inventory field name. For example:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.| |<|logtimefmt|\-|`string`|<|Format of the time in log entries.<br>Used only by log items.| |<|interface\_ref|\-|`string`|Format: `if<N>`|Reference to the host interface.| |<|jmx\_endpoint|\-|`string`|<|JMX endpoint.<br><br>Used only by JMX agent items.| |<|url|\-|`string`|<|URL string.<br><br>Required only for HTTP agent items.| |<|allow\_traps|\-|`string`|0 - NO (default)<br>1 - YES|Allow to populate value as in a trapper item.<br><br>Used only by HTTP agent items.| |<|follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP response redirects while pooling data.<br><br>Used only by HTTP agent items.| |headers|<|\-|<|<|Root element for HTTP(S) request headers, where header name is used as key and header value as value.<br>Used only by HTTP agent items.| |<|name|x|`string`|<|Header name.| |<|value|x|`string`|<|Header value.| |<|http\_proxy|\-|`string`|<|HTTP(S) proxy connection string.<br><br>Used only by HTTP agent items.| |<|output\_format|\-|`string`|0 - RAW (default)<br>1 - JSON|How to process response.<br><br>Used only by HTTP agent items.| |<|post\_type|\-|`string`|0 - RAW (default)<br>2 - JSON<br>3 - XML|Type of post data body.<br><br>Used only by HTTP agent items.| |<|posts|\-|`string`|<|HTTP(S) request body data.<br><br>Used only by HTTP agent items.| |query\_fields|<|\-|<|<|Root element for query parameters.<br><br>Used only by HTTP agent items.| |<|name|x|`string`|<|Parameter name.| |<|value|\-|`string`|<|Parameter value.| |<|request\_method|\-|`string`|0 - GET (default)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Request method.<br><br>Used only by HTTP agent items.| |<|retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|What part of response should be stored.<br><br>Used only by HTTP agent items.| |<|ssl\_cert\_file|\-|`string`|<|Public SSL Key file path.<br><br>Used only by HTTP agent items.| |<|ssl\_key\_file|\-|`string`|<|Private SSL Key file path.<br><br>Used only by HTTP agent items.| |<|ssl\_key\_password|\-|`string`|<|Password for SSL Key file.<br><br>Used only by HTTP agent items.| |<|status\_codes|\-|`string`|<|Ranges of required HTTP status codes separated by commas. Supports user macros.<br>Example: 200,200-{$M},{$M},200-400<br><br>Used only by HTTP agent items.| |<|timeout|\-|`string`|<|Item data polling request timeout. Supports user macros.<br><br>Used by HTTP agent and Script items.| |<|verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host name in URL is in Common Name field or a Subject Alternate Name field of host certificate.<br><br>Used only by HTTP agent items.| |<|verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host certificate is authentic.<br><br>Used only by HTTP agent items.| |parameters|<|\-|<|<|Root element for user-defined parameters.<br><br>Used only by Script items.| |<|name|x|`string`|<|Parameter name.<br><br>Used only by Script items.| |<|value|\-|`string`|<|Parameter value.<br><br>Used only by Script items.| |value map|<|\-|<|<|Value map.| |<|name|x|`string`|<|Name of the value map to use for the item.| |preprocessing|<|\-|<|<|Root element for item value preprocessing.| |step|<|\-|<|<|Individual item value preprocessing step.| |<|type|x|`string`|1 - MULTIPLIER<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculated as (received value-previous value))<br>10 - CHANGE\_PER\_SECOND (calculated as (received value-previous value)/(time now-time of last check))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |<|parameters|\-|<|<|Root element for parameters of the item value preprocessing step.| |<|parameter|x|`string`|<|Individual parameter of the item value preprocessing step.| |<|error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (default)<br>1 - DISCARD\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Action type used in case of preprocessing step failure.| |<|error\_handler\_params|\-|`string`|<|Error handler parameters used with 'error\_handler'.| |master\_item|<|\-|<|<|Individual item master item.<br><br>Required by dependent items.| |<|key|x|`string`|<|Dependent item master item key value.<br><br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.| |triggers|<|\-|<|<|Root element for simple triggers.| |<|*For trigger element tag values, see host [trigger tags](/manual/xml_export_import/hosts#host_trigger_tags).*|<|<|<|<| |tags|<|\-|<|<|Root element for item tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.|
ja	##### Host item タグ  |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |items|<|\-|<|<|Root element for items.| |<|name|x|`string`|<|Item name.| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULATED<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Item type.| |<|snmp\_oid|\-|`string`|<|SNMP object ID.<br><br>Required by SNMP items.| |<|key|x|`string`|<|Item key.| |<|delay|\-|`string`|Default: 1m|Update interval of the item.<br><br>Note that `delay` will be always '0' for trapper items.<br><br>Accepts seconds or a time unit with suffix (30s, 1m, 2h, 1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| |<|history|\-|`string`|Default: 90d|A time unit of how long the history data should be stored. Time unit with suffix, user macro or LLD macro.| |<|trends|\-|`string`|Default: 365d|A time unit of how long the trends data should be stored. Time unit with suffix, user macro or LLD macro.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Item status.| |<|value\_type|\-|`string`|0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (default)<br>4 - TEXT|Received value type.| |<|allowed\_hosts|\-|`string`|<|List of IP addresses (comma delimited) of hosts allowed sending data for the item.<br><br>Used by trapper and HTTP agent items.| |<|units|\-|`string`|<|Units of returned values (bps, B, etc).| |<|params|\-|`text`|<|Additional parameters depending on the type of the item:<br>- executed script for Script, SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items.| |<|ipmi\_sensor|\-|`string`|<|IPMI sensor.<br><br>Used only by IPMI items.| |<|authtype|\-|`string`|Authentication type for SSH agent items:<br>0 - PASSWORD (default)<br>1 - PUBLIC\_KEY<br><br>Authentication type for HTTP agent items:<br>0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication type.<br><br>Used only by SSH and HTTP agent items.| |<|username|\-|`string`|<|Username for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX agent, password should also be specified together with the username or both properties should be left blank.| |<|password|\-|`string`|<|Password for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>When used by JMX agent, username should also be specified together with the password or both properties should be left blank.| |<|publickey|\-|`string`|<|Name of the public key file.<br><br>Required for SSH agent items.| |<|privatekey|\-|`string`|<|Name of the private key file.<br><br>Required for SSH agent items.| |<|description|\-|`text`|<|Item description.| |<|inventory\_link|\-|`string`|0 - NONE<br><br>Capitalized host inventory field name. For example:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.| |<|logtimefmt|\-|`string`|<|Format of the time in log entries.<br>Used only by log items.| |<|interface\_ref|\-|`string`|Format: `if<N>`|Reference to the host interface.| |<|jmx\_endpoint|\-|`string`|<|JMX endpoint.<br><br>Used only by JMX agent items.| |<|url|\-|`string`|<|URL string.<br><br>Required only for HTTP agent items.| |<|allow\_traps|\-|`string`|0 - NO (default)<br>1 - YES|Allow to populate value as in a trapper item.<br><br>Used only by HTTP agent items.| |<|follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP response redirects while pooling data.<br><br>Used only by HTTP agent items.| |headers|<|\-|<|<|Root element for HTTP(S) request headers, where header name is used as key and header value as value.<br>Used only by HTTP agent items.| |<|name|x|`string`|<|Header name.| |<|value|x|`string`|<|Header value.| |<|http\_proxy|\-|`string`|<|HTTP(S) proxy connection string.<br><br>Used only by HTTP agent items.| |<|output\_format|\-|`string`|0 - RAW (default)<br>1 - JSON|How to process response.<br><br>Used only by HTTP agent items.| |<|post\_type|\-|`string`|0 - RAW (default)<br>2 - JSON<br>3 - XML|Type of post data body.<br><br>Used only by HTTP agent items.| |<|posts|\-|`string`|<|HTTP(S) request body data.<br><br>Used only by HTTP agent items.| |query\_fields|<|\-|<|<|Root element for query parameters.<br><br>Used only by HTTP agent items.| |<|name|x|`string`|<|Parameter name.| |<|value|\-|`string`|<|Parameter value.| |<|request\_method|\-|`string`|0 - GET (default)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Request method.<br><br>Used only by HTTP agent items.| |<|retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|What part of response should be stored.<br><br>Used only by HTTP agent items.| |<|ssl\_cert\_file|\-|`string`|<|Public SSL Key file path.<br><br>Used only by HTTP agent items.| |<|ssl\_key\_file|\-|`string`|<|Private SSL Key file path.<br><br>Used only by HTTP agent items.| |<|ssl\_key\_password|\-|`string`|<|Password for SSL Key file.<br><br>Used only by HTTP agent items.| |<|status\_codes|\-|`string`|<|Ranges of required HTTP status codes separated by commas. Supports user macros.<br>Example: 200,200-{$M},{$M},200-400<br><br>Used only by HTTP agent items.| |<|timeout|\-|`string`|<|Item data polling request timeout. Supports user macros.<br><br>Used by HTTP agent and Script items.| |<|verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host name in URL is in Common Name field or a Subject Alternate Name field of host certificate.<br><br>Used only by HTTP agent items.| |<|verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host certificate is authentic.<br><br>Used only by HTTP agent items.| |parameters|<|\-|<|<|Root element for user-defined parameters.<br><br>Used only by Script items.| |<|name|x|`string`|<|Parameter name.<br><br>Used only by Script items.| |<|value|\-|`string`|<|Parameter value.<br><br>Used only by Script items.| |value map|<|\-|<|<|Value map.| |<|name|x|`string`|<|Name of the value map to use for the item.| |preprocessing|<|\-|<|<|Root element for item value preprocessing.| |step|<|\-|<|<|Individual item value preprocessing step.| |<|type|x|`string`|1 - MULTIPLIER<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculated as (received value-previous value))<br>10 - CHANGE\_PER\_SECOND (calculated as (received value-previous value)/(time now-time of last check))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |<|parameters|\-|<|<|Root element for parameters of the item value preprocessing step.| |<|parameter|x|`string`|<|Individual parameter of the item value preprocessing step.| |<|error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (default)<br>1 - DISCARD\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Action type used in case of preprocessing step failure.| |<|error\_handler\_params|\-|`string`|<|Error handler parameters used with 'error\_handler'.| |master\_item|<|\-|<|<|Individual item master item.<br><br>Required by dependent items.| |<|key|x|`string`|<|Dependent item master item key value.<br><br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.| |triggers|<|\-|<|<|Root element for simple triggers.| |<|*For trigger element tag values, see host [trigger tags](/manual/xml_export_import/hosts#host_trigger_tags).*|<|<|<|<| |tags|<|\-|<|<|Root element for item tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.|

en-us	##### Host low-level discovery rule tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |discovery\_rules|<|\-|<|<|Root element for low-level discovery rules.| |<|*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*|<|<|<|<| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| |<|lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter|<|<|<|<|Individual filter.| |<|evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| |<|formula|\-|`string`|<|Custom calculation formula for filter conditions.| |conditions|<|\-|<|<|Root element for filter conditions.| |<|macro|x|`string`|<|Low-level discovery macro name.| |<|value|\-|`string`|<|Filter value: regular expression or global regular expression.| |<|operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| |<|formulaid|x|`character`|<|Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |lld\_macro\_paths|<|\-|<|<|Root element for LLD macro paths.| |<|lld\_macro|x|`string`|<|Low-level discovery macro name.| |<|path|x|`string`|<|Selector for value which will be assigned to the corresponding macro.| |preprocessing|<|\-|<|<|LLD rule value preprocessing.| |step|<|\-|<|<|Individual LLD rule value preprocessing step.| |<|*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*|<|<|<|<| |<|type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes|<|\-|<|<|Root element for trigger prototypes.| |<|*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*|<|<|<|<| |graph\_prototypes|<|\-|<|<|Root element for graph prototypes.| |<|*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*|<|<|<|<| |host\_prototypes|<|\-|<|<|Root element for host prototypes.| |<|*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*|<|<|<|<| |item\_prototypes|<|\-|<|<|Root element for item prototypes.| |<|*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*|<|<|<|<| |master\_item|<|\-|<|<|Individual item prototype master item/item prototype data.| |<|key|x|`string`|<|Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.|
ja	##### Host low-level discovery rule タグ  |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |discovery\_rules|<|\-|<|<|Root element for low-level discovery rules.| |<|*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*|<|<|<|<| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| |<|lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter|<|<|<|<|Individual filter.| |<|evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| |<|formula|\-|`string`|<|Custom calculation formula for filter conditions.| |conditions|<|\-|<|<|Root element for filter conditions.| |<|macro|x|`string`|<|Low-level discovery macro name.| |<|value|\-|`string`|<|Filter value: regular expression or global regular expression.| |<|operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| |<|formulaid|x|`character`|<|Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |lld\_macro\_paths|<|\-|<|<|Root element for LLD macro paths.| |<|lld\_macro|x|`string`|<|Low-level discovery macro name.| |<|path|x|`string`|<|Selector for value which will be assigned to the corresponding macro.| |preprocessing|<|\-|<|<|LLD rule value preprocessing.| |step|<|\-|<|<|Individual LLD rule value preprocessing step.| |<|*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*|<|<|<|<| |<|type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes|<|\-|<|<|Root element for trigger prototypes.| |<|*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*|<|<|<|<| |graph\_prototypes|<|\-|<|<|Root element for graph prototypes.| |<|*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*|<|<|<|<| |host\_prototypes|<|\-|<|<|Root element for host prototypes.| |<|*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*|<|<|<|<| |item\_prototypes|<|\-|<|<|Root element for item prototypes.| |<|*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*|<|<|<|<| |master\_item|<|\-|<|<|Individual item prototype master item/item prototype data.| |<|key|x|`string`|<|Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.|

en-us	Host markers displayed on the map have the color of the host's most serious problem and green color if a host has no problems. Clicking on a host marker allows viewing the host's visible name and the number of unresolved problems grouped by severity. Clicking on the visible name will open [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu).  Hosts displayed on the map can be filtered by problem severity. Press on the filter icon in the widget's upper right corner and mark the required severities.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget_filter.png)
ja	マップに表示されるホストマーカーはホストの最も深刻な障害の色です。ホストに障害がない場合は緑色になります。 ホストマーカーをクリックすると、ホストの表示名と深刻度別にグループ化された未解決の障害の数を表示できます。 表示されている名前をクリックすると、[ホストメニュー](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu)が開きます。  マップに表示されるホストは障害の深刻度でフィルタリングできます。 ウィジェットの右上隅にあるフィルターアイコンを押して、表示したい深刻度をチェックします。  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget_filter.png)

en-us	# host.massadd
ja	# host.massadd

en-us	# host.massremove
ja	# host.massremove

en-us	# host.massupdate
ja	# host.massupdate

en-us	#### Host menu  Clicking on a host in the *Problems* widget brings up the host menu. It includes links to host inventory, latest data, problems, graphs, dashboards, web scenarios and configuration. Note that host configuration is available for Admin and Superadmin users only.  ![](../../../../../assets/en/manual/web_interface/host_menu.png)  [Global scripts](/manual/web_interface/frontend_sections/administration/scripts) can also be run from the host menu. These scripts need to have their scope defined as 'Manual host action' to be available in the host menu.  The host menu is accessible by clicking on a host in several other frontend sections:  -   Monitoring → [Problems](problems) -   Monitoring → [Problems](problems) → Event details -   Monitoring → [Hosts](hosts) -   Monitoring → Hosts → [Web     Monitoring](/manual/web_interface/frontend_sections/monitoring/hosts/web) -   Monitoring → [Latest data](latest_data) -   Monitoring → [Maps](maps) -   Reports → [Triggers top     100](/manual/web_interface/frontend_sections/reports/triggers_top)
ja	#### ホストメニュー  *障害*ウィジェットでホストをクリックすると、ホストメニューが表示されます。 ホストインベントリ、最新データ、障害、グラフ、ダッシュボード、Webシナリオ、および設定へのリンクが含まれています。 ホストの設定は管理者およびスーパー管理者ユーザーのみが使用できます。  ![](../../../../../assets/en/manual/web_interface/host_menu.png)  [グローバルスクリプト](/manual/web_interface/frontend_sections/administration/scripts)はホストメニューから実行することもできます。 これらのスクリプトをホストメニューで使用するには、スコープを'手動ホストアクション'として定義する必要があります。  ホストメニューには、他のいくつかのフロントエンドセクションでホストをクリックしてアクセスできます。  -   監視データ → [障害](problems) -   監視データ → [障害](problems) → イベント詳細 -   監視データ → [ホスト](hosts) -   監視データ → ホスト → [Web監視](/manual/web_interface/frontend_sections/monitoring/hosts/web) -   監視データ → [最新データ](latest_data) -   監視データ → [マップ](maps) -   レポート → [障害発生数上位100項目](/manual/web_interface/frontend_sections/reports/triggers_top)

en-us	##### Hostname parameter  To perform [active checks](/manual/appendix/items/activepassive#active_checks) on a host Zabbix agent needs to have the hostname defined. Moreover, the hostname value set on the agent side should exactly match the "[Host name](/manual/config/hosts/host)" configured for the host in the frontend.  The hostname value on the agent side can be defined by either the **Hostname** or **HostnameItem** parameter in the agent [configuration file](/manual/appendix/config/zabbix_agentd_win) - or the default values are used if any of these parameters are not specified.  The default value for **HostnameItem** parameter is the value returned by the "system.hostname" agent key and for Windows platform it returns the NetBIOS host name.  The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it.  The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it.  The "system.hostname" key supports two optional parameters - *type* and *transform*.  *Type* parameter determines the type of the name the item should return. Supported values:  -   *netbios* (default) - returns the NetBIOS host name which is limited     to 15 symbols and is in the UPPERCASE only; -   *host* - case-sensitive, returns the full, real Windows host name (without a domain); -   *shorthost* (supported since Zabbix 5.4.7) - returns part of the     hostname before the first dot. It will return a full string if the     name does not contain a dot.  *Transform* parameter is supported since Zabbix 5.4.7 and allows to specify additional transformation rule for the hostname. Supported values:  -   *none* (default) - use the original letter case; -   *lower* - convert the text into lowercase.  So, to simplify the configuration of zabbix\_agentd.conf file and make it unified, two different approaches could be used.  1.  leave **Hostname** or **HostnameItem** parameters undefined and     Zabbix agent will use NetBIOS host name as the hostname; 2.  leave **Hostname** parameter undefined and define **HostnameItem**     like this:\     **HostnameItem=system.hostname\[host\]** - for Zabbix agent to use     the full, real (case sensitive) Windows host name as the hostname\     **HostnameItem=system.hostname\[shorthost,lower\]** - for Zabbix     agent to use only part of the hostname before the first dot,     converted into lowercase.  Host name is also used as part of Windows service name which is used for installing, starting, stopping and uninstalling the Windows service. For example, if Zabbix agent configuration file specifies `Hostname=Windows_db_server`, then the agent will be installed as a Windows service "`Zabbix Agent [Windows_db_server]`". Therefore, to have a different Windows service name for each Zabbix agent instance, each instance must use a different host name.  
ja	##### Hostname parameter  To perform [active checks](/manual/appendix/items/activepassive#active_checks) on a host Zabbix agent needs to have the hostname defined. Moreover, the hostname value set on the agent side should exactly match the "[Host name](/manual/config/hosts/host)" configured for the host in the frontend.  The hostname value on the agent side can be defined by either the **Hostname** or **HostnameItem** parameter in the agent [configuration file](/manual/appendix/config/zabbix_agentd_win) - or the default values are used if any of these parameters are not specified.  The default value for **HostnameItem** parameter is the value returned by the "system.hostname" agent key and for Windows platform it returns the NetBIOS host name.  The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it.  The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it.  The "system.hostname" key supports two optional parameters - *type* and *transform*.  *Type* parameter determines the type of the name the item should return. Supported values:  -   *netbios* (default) - returns the NetBIOS host name which is limited     to 15 symbols and is in the UPPERCASE only; -   *host* - returns the full, real (case-sensitive) Windows host name; -   *shorthost* (supported since Zabbix 5.4.7) - returns part of the     hostname before the first dot. It will return a full string if the     name does not contain a dot.  *Transform* parameter is supported since Zabbix 5.4.7 and allows to specify additional transformation rule for the hostname. Supported values:  -   *none* (default) - use the original letter case; -   *lower* - convert the text into lowercase.  So, to simplify the configuration of zabbix\_agentd.conf file and make it unified, two different approaches could be used.  1.  leave **Hostname** or **HostnameItem** parameters undefined and     Zabbix agent will use NetBIOS host name as the hostname; 2.  leave **Hostname** parameter undefined and define **HostnameItem**     like this:\     **HostnameItem=system.hostname\[host\]** - for Zabbix agent to use     the full, real (case sensitive) Windows host name as the hostname\     **HostnameItem=system.hostname\[shorthost,lower\]** - for Zabbix     agent to use only part of the hostname before the first dot,     converted into lowercase.  Host name is also used as part of Windows service name which is used for installing, starting, stopping and uninstalling the Windows service. For example, if Zabbix agent configuration file specifies `Hostname=Windows_db_server`, then the agent will be installed as a Windows service "`Zabbix Agent [Windows_db_server]`". Therefore, to have a different Windows service name for each Zabbix agent instance, each instance must use a different host name.  

en-us	##### Hostname parameter  To perform [active checks](/manual/appendix/items/activepassive#active_checks) on a host Zabbix agent needs to have the hostname defined. Moreover, the hostname value set on the agent side should exactly match the "[Host name](/manual/config/hosts/host)" configured for the host in the frontend.  The hostname value on the agent side can be defined by either the **Hostname** or **HostnameItem** parameter in the agent [configuration file](/manual/appendix/config/zabbix_agentd_win) - or the default values are used if any of these parameters are not specified.  The default value for **HostnameItem** parameter is the value returned by the "system.hostname" agent key. For Windows, it returns result of the gethostname() function, which queries namespace providers to determine the local host name. If no namespace provider responds, the NetBIOS name is returned.  The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified, the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it.  The "system.hostname" key supports two optional parameters - *type* and *transform*.  *Type* parameter determines the type of the name the item should return. Supported values:  -   *netbios* (default) - returns the NetBIOS host name which is limited     to 15 symbols and is in the UPPERCASE only; -   *host* - case-sensitive, returns the full, real Windows host name (without a domain); -   *shorthost* (supported since Zabbix 5.4.7) - returns part of the     hostname before the first dot. It will return a full string if the     name does not contain a dot.  *Transform* parameter is supported since Zabbix 5.4.7 and allows to specify additional transformation rule for the hostname. Supported values:  -   *none* (default) - use the original letter case; -   *lower* - convert the text into lowercase.  So, to simplify the configuration of zabbix\_agentd.conf file and make it unified, two different approaches could be used.  1.  leave **Hostname** or **HostnameItem** parameters undefined and     Zabbix agent will use NetBIOS host name as the hostname; 2.  leave **Hostname** parameter undefined and define **HostnameItem**     like this:\     **HostnameItem=system.hostname\[host\]** - for Zabbix agent to use     the full, real (case sensitive) Windows host name as the hostname\     **HostnameItem=system.hostname\[shorthost,lower\]** - for Zabbix     agent to use only part of the hostname before the first dot,     converted into lowercase.  Host name is also used as part of Windows service name which is used for installing, starting, stopping and uninstalling the Windows service. For example, if Zabbix agent configuration file specifies `Hostname=Windows_db_server`, then the agent will be installed as a Windows service "`Zabbix Agent [Windows_db_server]`". Therefore, to have a different Windows service name for each Zabbix agent instance, each instance must use a different host name.
ja	##### Hostnameパラメータ  ホストで[アクティブチェック](/manual/appendix/items/activepassive#active_checks)を実行するには、Zabbixエージェントでホスト名を定義する必要があります。また、エージェント側で設定するホスト名の値は、フロントエンドのホストに設定されている"[ホスト名](/manual/config/hosts/host)"と完全に一致している必要があります。  エージェント側のホスト名値は、エージェント[構成ファイル](/manual/appendix/config/zabbix_agentd_win)の**Hostname**または**HostnameItem**パラメーターのいずれかで定義できます。これらのパラメーターは指定されていない場合、デフォルト値が使用されます。  **HostnameItem**パラメータのデフォルト値は"system.hostname"エージェントキーによって返される値です。 Windowsの場合、gethostname()関数の結果を返します。この関数は、名前空間プロバイダーにクエリを実行して、ローカルホスト名を決定します。名前空間プロバイダーが応答しない場合は、NetBIOS名が返されます。  **Hostname**のデフォルト値は**HostnameItem**パラメーターによって返される値です。したがってこれらのパラメーターが両方とも設定されていない場合、ホスト名はホストのNetBIOS名になります。 ZabbixエージェントはNetBIOSホスト名を使用して、Zabbixサーバーからアクティブなチェックのリストを取得し、結果をサーバーに送信します。  "system.hostname"キーは、*type*と*transform*の2つのオプションパラメーターをサポートします。  *Type*パラメーターは、アイテムが返す名前のタイプを決定します。 サポートされている値：  -   *netbios* (default) - 15シンボルに制限された大文字のみのNetBIOSホスト名を返します。 -   *host* - 大文字と小文字が区別された、完全な実際のWindowsホスト名（ドメインなし）を返します。 -   *shorthost* （Zabbix 5.4.7以降でサポート）- 最初のドットの前のホスト名の一部を返します。名前にドットが含まれていない場合は、完全な文字列が返されます。  *Transform*パラメータはZabbix5.4.7以降でサポートされており、ホスト名に追加の変換ルールを指定できます。 サポートされている値：  -   *none* (default) - 元の大大文字小文字を使用します。 -   *lower* - テキストを小文字に変換します。  したがって、zabbix\_agentd.confファイルの設定を簡素化し、統合するために、2つの異なるアプローチができます。  1.  **Hostname**または**HostnameItem**パラメータを未定義のままにすると、Zabbixエージェントはホスト名としてNetBIOSホスト名を使用します。 2.  ** Hostname **パラメータを未定義のままにして、**HostnameItem**を次のように定義します。\**HostnameItem=system.hostname\[host\]** - Zabbixエージェントが完全な実際の（大文字と小文字を区別する）Windowsホスト名をホスト名として使用する場合\**HostnameItem=system.hostname\[shorthost,lower\]** - Zabbixエージェントが最初のドットの前のホスト名の一部のみを使用し、小文字に変換する場合。  ホスト名は、Windowsサービスのインストール、開始、停止、およびアンインストールに使用されるWindowsサービス名の一部としても使用されます。たとえば、Zabbixエージェント設定ファイルで `Hostname=Windows_db_server`が指定されている場合、エージェントはWindowsサービス" `ZabbixAgent[Windows_db_server]`"としてインストールされます。したがって、Zabbixエージェントインスタンスごとに異なるWindowsサービス名を使用するには、インスタンスごとに異なるホスト名を使用する必要があります。

en-us	##### Host naming  When adding hosts, a host name is the result of reverse DNS lookup or IP address if reverse lookup fails. Lookup is performed from the Zabbix server or Zabbix proxy, depending on which is doing the discovery. If lookup fails on the proxy, it is not retried on the server. If the host with such a name already exists, the next host would get **\_2** appended to the name, then **\_3** and so on.  It is also possible to override DNS/IP lookup and instead use an item value for host name, for example:  -   You may discover multiple servers with Zabbix agent running using a     Zabbix agent item for discovery and assign proper names to them     automatically, based on the string value returned by this item -   You may discover multiple SNMP network devices using an SNMP agent     item for discovery and assign proper names to them automatically,     based on the string value returned by this item  If the host name has been set using an item value, it is not updated during the following discovery checks. If it is not possible to set host name using an item value, default value (DNS name) is used.  If a host already exists with the discovered IP address, a new host is not created. However, if the discovery action contains operations (link template, add to host group, etc), they are performed on the existing host.
ja	##### ホストの命名  ホストを追加する場合、ホスト名は逆引きDNSルックアップの結果または逆引きルックアップが失敗した場合のIPアドレスです。ルックアップは、検出を行っているZabbixサーバーまたはZabbixプロキシから実行されます。プロキシでルックアップが失敗した場合でもサーバーで再試行されません。同じ名前のホストがすでに存在する場合、次のホストには名前に**\_2 **を追加し、また次のホストには**\_3**というように追加されます。  DNS/IPルックアップをオーバーライドして、ホスト名にアイテム値を使用することもできます。次に例を示します。  -   検出用のZabbixエージェントアイテムを使用して実行されているZabbixエージェントで、複数のサーバーを検出し、このアイテムによって返される文字列値に基づいて、適切な名前をサーバーに自動的に割り当てる -   SNMPエージェントアイテムを使用して、複数のSNMPネットワークデバイスを検出し、このアイテムによって返される文字列値に基づいて、適切な名前を自動的に割り当てる  ホスト名がアイテム値を使用して設定されている場合、次の検出チェックでもホスト名は更新されません。項目値でホスト名を設定できない場合は、デフォルト値（DNS名）を使用します。  検出されたIPアドレスを持つホストがすでに存在する場合、新しいホストは作成されません。ただし、検出アクションに操作（リンクテンプレート、ホストグループへの追加など）が含まれている場合、それらは既存のホストで実行されます。

en-us	# > Host object  The following objects are directly related to the host API.
ja	# > Hostオブジェクト  次のオブジェクトは、hostAPIに直接関連しています。

en-us	#### host prototype  Changes:\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.get`: dropped support of properties `group_prototypeid`, `hostid`, `templateid` of group link and group prototype API objects.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.update`: dropped the ability to modify the readonly fields `host`, `name`, `custom_interfaces`, `interfaces`, `groupLinks`, `groupPrototypes`, `templates`, `tags`, `macros`, `inventory_mode` of inherited host prototypes.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.create`, `hostprototype.update`, `hostprototype.delete`: added strict validation of the method parameters.\
ja	#### ホストプロトタイプ  変更点:\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.get`: グループリンクとグループプロトタイプAPIオブジェクトのプロパティ`group_prototypeid`, `hostid`, `templateid` のサポートを廃止しました。\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.update`: 継承されたホストプロトタイプの読み込み専用フィールド `host`, `name`, `custom_interfaces`, `interfaces`, `groupLinks`, `groupPrototypes`, `templates`, `tags`, `macros`, `inventory_mode` を編集不可にしました。\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.create`, `hostprototype.update`, `hostprototype.delete`: メソッドパラメーターのバリデーションを強化しました。\

en-us	#### hostprototype  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: the parameter `uuid` can now be updated.\
ja	#### ホストプロトタイプ  変更点:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: パラメーター `uuid` が更新できるようになりました。\

en-us	# hostprototype.create
ja	# hostprototype.create

en-us	# hostprototype.delete
ja	# hostprototype.delete

en-us	# hostprototype.get
ja	# hostprototype.get

en-us	# > Host prototype object  The following objects are directly related to the `hostprototype` API.
ja	# > Host prototypeオブジェクト  次のオブジェクトは、`hostprototype`APIに直接関連しています。

en-us	#### Host prototypes  Host prototypes can be created with the low-level discovery rule. When virtual machines are discovered, these prototypes become real hosts. Prototypes, before becoming discovered, cannot have their own items and triggers, other than those from the linked templates. Discovered hosts will belong to an existing host.  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes.png)  In order for hosts created from a prototype to have unique host names, the *Host name* field must contain at least one [low-level discovery macro](/manual/config/macros/lld_macros).  Since Zabbix 5.2, discovered hosts may be configured with custom interfaces or inherit the IP of a host the discovery rule belongs to (default). To add one or more custom interface, switch the *Interface* selector from *Inherit* to *Custom* mode, then press ![add\_link.png](../../assets/en/manual/config/add_link.png) and select the required interface type from the drop-down menu that appears. All supported types of interfaces can be defined for a host prototype: Zabbix agent, SNMP, JMX, IPMI. Interface fields support low-level discovery macros and [user macros](/manual/config/macros/user_macros). If several custom interfaces are specified - use the *Default* column to specify the primary interface.  Notes:  -   If *Custom* is selected, but no interfaces have been specified the     hosts will be created without interfaces. -   If *Inherit* is selected for a host prototype that belongs to a     template, discovered hosts will inherit the interface of a host to     which the template is linked to.  ::: notewarning  A host will not be created, if the host interface contains incorrect data  :::  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes_if2.png)  LLD macros can also be used for the visible name, host group prototype fields, tag values, or values of host prototype user macros.  Other options that can be specified for a host prototype are:  -   Linkage to existing host groups -   Template linkage -   Encryption  If *Create enabled* is checked, the host will be added in an enabled state. If unchecked, the host will be added, but in a disabled state.  If *Discover* is checked (default), the host will be created. If unchecked, the host will not be created, unless this setting is overridden in the [discovery rule](/manual/discovery/low_level_discovery#override). This functionality provides additional flexibility when creating discovery rules.  Discovered hosts are prefixed with the name of the discovery rule that created them, in the host list. Discovered hosts can be manually deleted. Discovered hosts will also be automatically deleted, based on the *Keep lost resources period (in days)* value of the discovery rule. Most of the configuration options are read-only, except for enabling/disabling the host and host inventory. Discovered hosts cannot have host prototypes of their own.
ja	#### ホストプロトタイプ  ホストプロトタイプは、ローレベルディスカバリルールで作成することができます。 <br> 仮想マシンが検出されると、このプロトタイプは実際のホストになります。 <br> プロトタイプは、検出される前に、リンクされたテンプレートの item および trigger 以外の <br> 独自の item および trigger を持つことができません。 <br> 発見されたホストは、既存のホストに属します。 <br>  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes.png)  プロトタイプから作成されたホストが一意なホスト名を持つためには、*Host name* フィールドに 少なくとも1つの[low-level discovery macro](/manual/config/macros/lld_macros)を含む必要があります。  Zabbix5.2以降、検出されたホストはカスタムインターフェイスで設定することができます。 <br> またはディスカバリルールが属するホストのIPを継承することができます(デフォルト) <br> カスタムインターフェイスを1つ以上追加するには、*インターフェイス*セレクタを  <br> *Inherit* から *Custom* モードに切り替えて、次に ![add\_link.png](../../assets/en/manual/config/add_link.png)  を押して、 <br> 表示されるドロップダウンメニューから必要なインターフェイスの種類を選択します。 <br> すべてのホストプロトタイプには、サポートされている全ての種類のインタフェースを定義することができます。 <br> Zabbix agent, SNMP, JMX, IPMI. Interface fields support low-level discovery macros and [user macros](/manual/config/macros/user_macros) <br> インタフェースフィールドは、ローレベルディスカバリーマクロとユーザマクロ(/manual/config/macros/user_macros)をサポートします。 <br> 複数のカスタム・インターフェースが指定されている場合、*Default* 列を使用してプライマリ・インターフェースを指定します。 <br>  注意事項  - *Custom* を選択し、インターフェイスを指定しなかった場合、ホストはインターフェイスなしで作成されます。 <br> - テンプレートに属するホストのプロトタイプで *Inherit* が選択されている場合、検出されたホストは、 <br>   テンプレートに属するホストのインターフェースを継承します。 <br>  ::: notewarning  ホストインターフェイスに不正なデータが含まれている場合、ホストは作成されません。 :::  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes_if2.png)  LLDマクロは、可視名、ホスト・グループ・プロトタイプ・フィールド、タグ値、ホスト・ <br> プロトタイプ・ユーザー・マクロの値にも使用できます。<br>  その他、ホストプロトタイプに指定可能なオプションは以下の通り:  -   既存ホストへのリンク -   テンプレートへのリンク -   暗号化  *Create enabled* がチェックされている場合、ホストは有効な状態で追加されます。 <br> チェックされていない場合、ホストは追加されますが、無効な状態になります。 <br>  *Discover* がチェックされている場合 (デフォルト)、ホストが作成されます。 <br> もしチェックされていない場合、[discovery rule](/manual/discovery/low_level_discovery#override)でこの設定が上書きされない限り、 <br> ホストは作成されません。この機能により、検出ルール作成時の柔軟性がさらに高まります。 <br>  検出されたホストは、ホスト一覧の中で、それらを作成したディスカバリルールの名前の前に表示されます。 <br> 検出されたホストは、手動で削除することができます。 <br> 検出されたホストは、ディスカバリルールの *Keep lost resources period (in days)* の値に基づいて <br> 自動的に削除されることもあります。 <br> ホストおよびホストインベントリの有効化/無効化を除いて、ほとんどの設定オプションは読み取り専用です。 <br> 検出されたホストは、それ自身のホストプロトタイプを持つことはできません。 <br>

en-us	### Host prototype tag  The host prototype tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host prototype tag name.| |value|string|Host prototype tag value.|
ja	### Host prototype tag  Host prototype tagオブジェクトには、次のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**tag**<br>(必須)|string|ホストプロトタイプタグ名| |value|string|ホストプロトタイプタグ値|

en-us	### Host prototype  The host prototype object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host prototype.| |**host**<br>(required)|string|Technical name of the host prototype.| |name|string|Visible name of the host prototype.<br><br>Default: `host` property value.| |status|integer|Status of the host prototype.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |templateid|string|*(readonly)* ID of the parent template host prototype.| |discover|integer|Host prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new hosts will be discovered;<br>1 - new hosts will not be discovered and existing hosts will be marked as lost.| |custom\_interfaces|integer|Source of interfaces for hosts created by the host prototype.<br><br>Possible values:<br>0 - *(default)* inherit interfaces from parent host;<br>1 - use host prototypes custom interfaces.| |uuid|string|Universal unique identifier, used for linking imported host prototypes to already existing ones. Used only for host prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.|
ja	### Host prototype  host prototype オブジェクトには、次のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |hostid|string|*（読み取り専用）*ホストプロトタイプのID。| |**host**<br>(必須)|string|ホストプロトタイプの名前| |name|string|ホストプロトタイプの表示名<br><br>デフォルト:`host`プロパティ値| |status|integer|ホストプロトタイプのステータス<br><br>値は次のとおり<br>0 - *（デフォルト）*監視対象ホスト<br>1 - 監視対象外ホスト| |inventory\_mode|integer|ホストインベントリ作成モード<br><br>値は次のとおり<br>-1 - *（デフォルト）*無効<br>0 - 手動<br>1 - 自動| |templateid|string|*（読み取り専用）*親テンプレートホストプロトタイプのID| |discover|integer|ホストプロトタイプの検出ステータス<br><br>値:<br>0 - *（デフォルト）*新しいホストが検出されます<br>1 - 新しいホストは検出されず、既存のホストは失われたものとしてマークされます| |custom\_interfaces|integer|ホストプロトタイプによって作成されたホストのインターフェースのソース<br><br>値:<br>0 - *（デフォルト）*親ホストからインターフェースを継承<br>1 - ホストプロトタイプのカスタムインターフェースを使用| |uuid|string|インポートされたホストプロトタイプを既存のプロトタイプにリンクするために使用されるユニバーサル一意識別子。 テンプレートのホストプロトタイプにのみ使用されます。指定されていない場合は自動生成されます。<br><br>updateの場合、このフィールドは*読み取り専用*です。|

en-us	# Host prototype  This class is designed to work with host prototypes.  Object references:\  -   [Host     prototype](/manual/api/reference/hostprototype/object#host_prototype) -   [Host prototype     inventory](/manual/api/reference/hostprototype/object#host_prototype_inventory) -   [Group link](/manual/api/reference/hostprototype/object#group_link) -   [Group     prototype](/manual/api/reference/hostprototype/object#group_prototype)  Available methods:\  -   [hostprototype.create](/manual/api/reference/hostprototype/create) -     creating new host prototypes -   [hostprototype.delete](/manual/api/reference/hostprototype/delete) -     deleting host prototypes -   [hostprototype.get](/manual/api/reference/hostprototype/get) -     retrieving host prototypes -   [hostprototype.update](/manual/api/reference/hostprototype/update) -     updating host prototypes
ja	# Host prototype  このクラスは、ホストプロトタイプを操作するためのものです。  オブジェクトリファレンス :\  -   [Host prototype](/manual/api/reference/hostprototype/object#host_prototype) -   [Host prototype inventory](/manual/api/reference/hostprototype/object#host_prototype_inventory) -   [Group link](/manual/api/reference/hostprototype/object#group_link) -   [Group prototype](/manual/api/reference/hostprototype/object#group_prototype)  利用可能なメソッド :\  -   [hostprototype.create](/manual/api/reference/hostprototype/create) - 新しいホストプロトタイプの作成 -   [hostprototype.delete](/manual/api/reference/hostprototype/delete) - ホストプロトタイプの削除 -   [hostprototype.get](/manual/api/reference/hostprototype/get) - ホストプロトタイプの取得 -   [hostprototype.update](/manual/api/reference/hostprototype/update) - ホストプロトタイプの更新

en-us	# hostprototype.update
ja	# hostprototype.update

en-us	##### Host removal  Hosts discovered by a network discovery rule are removed automatically from *Monitoring* → *Discovery* if a discovered entity is not in the rule's IP range any more. Hosts are removed immediately.
ja	##### ホストの削除  ネットワーク検出ルールによって検出されたホストは、検出されたエンティティがルールのIP範囲内にない場合、*監視*→*検出*からすぐ自動的に削除されます。

en-us	#### Hosts and host groups  Manage host groups, hosts and everything related to them, including host interfaces, host macros and maintenance periods.  [Host API](/manual/api/reference/host) | [Host group API](/manual/api/reference/hostgroup) | [Host interface API](/manual/api/reference/hostinterface) | [User macro API](/manual/api/reference/usermacro) | [Value map API](/manual/api/reference/valuemap) | [Maintenance API](/manual/api/reference/maintenance)
ja	#### ホストとホストグループ  ホストグループとホスト、およびホストインタフェース、ホストマクロ、メンテナンス期間など、ホストに関連するすべてのものを管理します。  [Host API](/manual/api/reference/host) | [Host group API](/manual/api/reference/hostgroup) | [Host interface API](/manual/api/reference/hostinterface) | [User macro API](/manual/api/reference/usermacro) | [Value map API](/manual/api/reference/valuemap) | [Maintenance API](/manual/api/reference/maintenance)

en-us	#### Hosts/host prototypes  In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring#host_prototypes) configuration, user macros can be used in the following fields:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interface IP/DNS|<|DNS only| |Interface port|<|no| |*SNMP v1, v2*|<|<| | |SNMP community|yes| |*SNMP v3*|<|<| | |Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |*IPMI*|<|<| | |Username|yes| |^|Password|yes| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes|
ja	#### 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|

en-us	#### Hosts/host prototypes  In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring#host_prototypes) configuration, user macros can be used in the following fields:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |--------|-|------------------------------------------------------------------------| |Interface IP/DNS|<|DNS only| |Interface port|<|no| |*SNMP v1, v2*|<|<| |<|SNMP community|yes| |*SNMP v3*|<|<| |<|Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |*IPMI*|<|<| |<|Username|yes| |^|Password|yes| |//Tags //|<|<| |<|Tag names|yes| |^|Tag values|yes|  
ja	#### Hosts/host prototypes  In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring#host_prototypes) configuration, user macros can be used in the following fields:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |--------|-|------------------------------------------------------------------------| |Interface IP/DNS|<|DNS only| |Interface port|<|no| |*SNMP v1, v2*|<|<| |<|SNMP community|yes| |*SNMP v3*|<|<| |<|Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |*IPMI*|<|<| |<|Username|yes| |^|Password|yes| |//Tags //|<|<| |<|Tag names|yes| |^|Tag values|yes|  

en-us	##### Host tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |groups|<|x|<|<|Root element for host groups.| |<|name|x|`string`|<|Host group name.| |hosts|<|\-|<|<|Root element for hosts.| |<|host|x|`string`|<|Unique host name.| |<|name|\-|`string`|<|Visible host name.| |<|description|\-|`text`|<|Host description.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Host status.| |<|ipmi\_authtype|\-|`string`|-1 - DEFAULT (default)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS|IPMI session authentication type.| |<|ipmi\_privilege|\-|`string`|1 - CALLBACK<br>2 - USER (default)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM|IPMI session privilege level.| |<|ipmi\_username|\-|`string`|<|Username for IPMI checks.| |<|ipmi\_password|\-|`string`|<|Password for IPMI checks.| |proxy|<|\-|<|<|Proxy.| |<|name|x|`string`|<|Name of the proxy (if any) that monitors the host.| |templates|<|\-|<|<|Root element for linked templates.| |<|name|x|`string`|<|Template name.| |interfaces|<|\-|<|<|Root element for host interfaces.| |<|default|\-|`string`|0 - NO<br>1 - YES (default)|Whether this is the primary host interface.<br>There can be only one primary interface of one type on a host.| |<|type|\-|`string`|1 - ZABBIX (default)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Interface type.| |<|useip|\-|`string`|0 - NO<br>1 - YES (default)|Whether to use IP as the interface for connecting to the host (if not, DNS will be used).| |<|ip|\-|`string`|<|IP address, can be either IPv4 or IPv6.<br><br>Required if the connection is made via IP.| |<|dns|\-|`string`|<|DNS name.<br><br>Required if the connection is made via DNS.| |<|port|\-|`string`|<|Port number. Supports user macros.| |<|interface\_ref|x|`string`|Format: `if<N>`|Interface reference name to be used in items.| |details|<|\-|<|<|Root element for interface details.| |<|version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (default)<br>3 - SNMP\_V3|Use this SNMP version.| |<|community|\-|`string`|<|SNMP community.<br><br>Required by SNMPv1 and SNMPv2 items.| |<|contextname|\-|`string`|<|SNMPv3 context name.<br><br>Used only by SNMPv3 items.| |<|securityname|\-|`string`|<|SNMPv3 security name.<br><br>Used only by SNMPv3 items.| |<|securitylevel|\-|`string`|0 - NOAUTHNOPRIV (default)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|SNMPv3 security level.<br><br>Used only by SNMPv3 items.| |<|authprotocol|\-|`string`|0 - MD5 (default)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|SNMPv3 authentication protocol.<br><br>Used only by SNMPv3 items.| |<|authpassphrase|\-|`string`|<|SNMPv3 authentication passphrase.<br><br>Used only by SNMPv3 items.| |<|privprotocol|\-|`string`|0 - DES (default)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 privacy protocol.<br><br>Used only by SNMPv3 items.| |<|privpassphrase|\-|`string`|<|SNMPv3 privacy passphrase.<br><br>Used only by SNMPv3 items.| |<|bulk|\-|`string`|0 - NO<br>1 - YES (default)|Use bulk requests for SNMP.| |items|<|\-|<|<|Root element for items.| |<|*For item element tag values, see host [item](/manual/xml_export_import/hosts#host_item_tags) tags.*|<|<|<|<| |tags|<|\-|<|<|Root element for host tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.| |macros|<|\-|<|<|Root element for macros.| |<|macro|x|<|<|User macro name.| |<|type|\-|`string`|0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT|Type of the macro.| |<|value|\-|`string`|<|User macro value.| |<|description|\-|`string`|<|User macro description.| |inventory|<|\-|<|<|Root element for host inventory.| |<|<inventory\_property>|\-|<|<|Individual inventory property.<br><br>All available inventory properties are listed under the respective tags, e.g. <type>, <name>, <os> (see example above).| |inventory\_mode|<|\-|`string`|-1 - DISABLED<br>0 - MANUAL (default)<br>1 - AUTOMATIC|Inventory mode.| |valuemaps|<|\-|<|<|Root element for host value maps.| |<|name|x|`string`|<|Value map name.| |<|mapping|\-|<|<|Root element for mappings.| |<|value|x|`string`|<|Value of a mapping.| |<|newvalue|x|`string`|<|New value of a mapping.|
ja	##### Host タグ  |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |groups|<|x|<|<|Root element for host groups.| |<|name|x|`string`|<|Host group name.| |hosts|<|\-|<|<|Root element for hosts.| |<|host|x|`string`|<|Unique host name.| |<|name|\-|`string`|<|Visible host name.| |<|description|\-|`text`|<|Host description.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Host status.| |<|ipmi\_authtype|\-|`string`|-1 - DEFAULT (default)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS|IPMI session authentication type.| |<|ipmi\_privilege|\-|`string`|1 - CALLBACK<br>2 - USER (default)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM|IPMI session privilege level.| |<|ipmi\_username|\-|`string`|<|Username for IPMI checks.| |<|ipmi\_password|\-|`string`|<|Password for IPMI checks.| |proxy|<|\-|<|<|Proxy.| |<|name|x|`string`|<|Name of the proxy (if any) that monitors the host.| |templates|<|\-|<|<|Root element for linked templates.| |<|name|x|`string`|<|Template name.| |interfaces|<|\-|<|<|Root element for host interfaces.| |<|default|\-|`string`|0 - NO<br>1 - YES (default)|Whether this is the primary host interface.<br>There can be only one primary interface of one type on a host.| |<|type|\-|`string`|1 - ZABBIX (default)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Interface type.| |<|useip|\-|`string`|0 - NO<br>1 - YES (default)|Whether to use IP as the interface for connecting to the host (if not, DNS will be used).| |<|ip|\-|`string`|<|IP address, can be either IPv4 or IPv6.<br><br>Required if the connection is made via IP.| |<|dns|\-|`string`|<|DNS name.<br><br>Required if the connection is made via DNS.| |<|port|\-|`string`|<|Port number. Supports user macros.| |<|interface\_ref|x|`string`|Format: `if<N>`|Interface reference name to be used in items.| |details|<|\-|<|<|Root element for interface details.| |<|version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (default)<br>3 - SNMP\_V3|Use this SNMP version.| |<|community|\-|`string`|<|SNMP community.<br><br>Required by SNMPv1 and SNMPv2 items.| |<|contextname|\-|`string`|<|SNMPv3 context name.<br><br>Used only by SNMPv3 items.| |<|securityname|\-|`string`|<|SNMPv3 security name.<br><br>Used only by SNMPv3 items.| |<|securitylevel|\-|`string`|0 - NOAUTHNOPRIV (default)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|SNMPv3 security level.<br><br>Used only by SNMPv3 items.| |<|authprotocol|\-|`string`|0 - MD5 (default)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|SNMPv3 authentication protocol.<br><br>Used only by SNMPv3 items.| |<|authpassphrase|\-|`string`|<|SNMPv3 authentication passphrase.<br><br>Used only by SNMPv3 items.| |<|privprotocol|\-|`string`|0 - DES (default)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 privacy protocol.<br><br>Used only by SNMPv3 items.| |<|privpassphrase|\-|`string`|<|SNMPv3 privacy passphrase.<br><br>Used only by SNMPv3 items.| |<|bulk|\-|`string`|0 - NO<br>1 - YES (default)|Use bulk requests for SNMP.| |items|<|\-|<|<|Root element for items.| |<|*For item element tag values, see host [item](/manual/xml_export_import/hosts#host_item_tags) tags.*|<|<|<|<| |tags|<|\-|<|<|Root element for host tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.| |macros|<|\-|<|<|Root element for macros.| |<|macro|x|<|<|User macro name.| |<|type|\-|`string`|0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT|Type of the macro.| |<|value|\-|`string`|<|User macro value.| |<|description|\-|`string`|<|User macro description.| |inventory|<|\-|<|<|Root element for host inventory.| |<|<inventory\_property>|\-|<|<|Individual inventory property.<br><br>All available inventory properties are listed under the respective tags, e.g. <type>, <name>, <os> (see example above).| |inventory\_mode|<|\-|`string`|-1 - DISABLED<br>0 - MANUAL (default)<br>1 - AUTOMATIC|Inventory mode.| |valuemaps|<|\-|<|<|Root element for host value maps.| |<|name|x|`string`|<|Value map name.| |<|mapping|\-|<|<|Root element for mappings.| |<|value|x|`string`|<|Value of a mapping.| |<|newvalue|x|`string`|<|New value of a mapping.|

en-us	### Host tag  The host tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host tag name.| |value|string|Host tag value.|
ja	### Host tag  Host tag オブジェクトは、以下のプロパティを持ちます。  |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**tag**<br>(required)|string|Host tag name.| |value|string|Host tag value.|

en-us	### Host  The host object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host.| |**host**<br>(required)|string|Technical name of the host.| |description|text|Description of the host.| |flags|integer|*(readonly)* Origin of the host.<br><br>Possible values:<br>0 - a plain host;<br>4 - a discovered host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |ipmi\_authtype|integer|IPMI authentication algorithm.<br><br>Possible values are:<br>-1 - *(default)* default;<br>0 - none;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|IPMI password.| |ipmi\_privilege|integer|IPMI privilege level.<br><br>Possible values are:<br>1 - callback;<br>2 - *(default)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI username.| |maintenance\_from|timestamp|*(readonly)* Starting time of the effective maintenance.| |maintenance\_status|integer|*(readonly)* Effective maintenance status.<br><br>Possible values are:<br>0 - *(default)* no maintenance;<br>1 - maintenance in effect.| |maintenance\_type|integer|*(readonly)* Effective maintenance type.<br><br>Possible values are:<br>0 - *(default)* maintenance with data collection;<br>1 - maintenance without data collection.| |maintenanceid|string|*(readonly)* ID of the maintenance that is currently in effect on the host.| |name|string|Visible name of the host.<br><br>Default: `host` property value.| |proxy\_hostid|string|ID of the proxy that is used to monitor the host.| |status|integer|Status and function of the host.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |tls\_connect|integer|Connections to host.<br><br>Possible values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_accept|integer|Connections from host.<br><br>Possible bitmap values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_issuer|string|Certificate issuer.| |tls\_subject|string|Certificate subject.| |tls\_psk\_identity|string|*(write-only)* PSK identity. Required if either `tls_connect` or `tls_accept` has PSK enabled.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |tls\_psk|string|*(write-only)* The preshared key, at least 32 hex digits. Required if either `tls_connect` or `tls_accept` has PSK enabled.|
ja	### Host  host オブジェクトは以下のプロパティを持ちます。  |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |hostid|string|*(readonly)* ID of the host.| |**host**<br>(required)|string|Technical name of the host.| |description|text|Description of the host.| |flags|integer|*(readonly)* Origin of the host.<br><br>Possible values:<br>0 - a plain host;<br>4 - a discovered host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |ipmi\_authtype|integer|IPMI authentication algorithm.<br><br>Possible values are:<br>-1 - *(default)* default;<br>0 - none;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|IPMI password.| |ipmi\_privilege|integer|IPMI privilege level.<br><br>Possible values are:<br>1 - callback;<br>2 - *(default)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI username.| |maintenance\_from|timestamp|*(readonly)* Starting time of the effective maintenance.| |maintenance\_status|integer|*(readonly)* Effective maintenance status.<br><br>Possible values are:<br>0 - *(default)* no maintenance;<br>1 - maintenance in effect.| |maintenance\_type|integer|*(readonly)* Effective maintenance type.<br><br>Possible values are:<br>0 - *(default)* maintenance with data collection;<br>1 - maintenance without data collection.| |maintenanceid|string|*(readonly)* ID of the maintenance that is currently in effect on the host.| |name|string|Visible name of the host.<br><br>Default: `host` property value.| |proxy\_hostid|string|ID of the proxy that is used to monitor the host.| |status|integer|Status and function of the host.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |tls\_connect|integer|Connections to host.<br><br>Possible values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_accept|integer|Connections from host.<br><br>Possible bitmap values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_issuer|string|Certificate issuer.| |tls\_subject|string|Certificate subject.| |tls\_psk\_identity|string|*(write-only)* PSK identity. Required if either `tls_connect` or `tls_accept` has PSK enabled.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |tls\_psk|string|*(write-only)* The preshared key, at least 32 hex digits. Required if either `tls_connect` or `tls_accept` has PSK enabled.|

en-us	# Host  This class is designed to work with hosts.  Object references:\  -   [Host](/manual/api/reference/host/object#host) -   [Host inventory](/manual/api/reference/host/object#host_inventory)  Available methods:\  -   [host.create](/manual/api/reference/host/create) - creating new     hosts -   [host.delete](/manual/api/reference/host/delete) - deleting hosts -   [host.get](/manual/api/reference/host/get) - retrieving hosts -   [host.massadd](/manual/api/reference/host/massadd) - adding related     objects to hosts -   [host.massremove](/manual/api/reference/host/massremove) - removing     related objects from hosts -   [host.massupdate](/manual/api/reference/host/massupdate) - replacing     or removing related objects from hosts -   [host.update](/manual/api/reference/host/update) - updating hosts
ja	# Host  このクラスは、ホストを操作するためのものです。  オブジェクトリファレンス :\  -   [Host](/manual/api/reference/host/object#host) -   [Host inventory](/manual/api/reference/host/object#host_inventory)  利用可能なメソッド :\  -   [host.create](/manual/api/reference/host/create) - 新しいホストの作成 -   [host.delete](/manual/api/reference/host/delete) - ホストの削除 -   [host.get](/manual/api/reference/host/get) - ホストの取得 -   [host.massadd](/manual/api/reference/host/massadd) - ホストへ関連オブジェクトの追加 -   [host.massremove](/manual/api/reference/host/massremove) - ホストから関連オブジェクトの削除 -   [host.massupdate](/manual/api/reference/host/massupdate) - ホストの関連オブジェクトを交換または削除 -   [host.update](/manual/api/reference/host/update) - ホストの更新

en-us	##### Host trigger tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |triggers|<|\-|<|<|Root element for triggers.| |<|expression|x|`string`|<|Trigger expression.| |<|recovery\_mode|\-|`string`|0 - EXPRESSION (default)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Basis for generating OK events.| |<|recovery\_expression|\-|`string`|<|Trigger recovery expression.| |<|name|x|`string`|<|Trigger name.| |<|correlation\_mode|\-|`string`|0 - DISABLED (default)<br>1 - TAG\_VALUE|Correlation mode (no event correlation or event correlation by tag).| |<|correlation\_tag|\-|`string`|<|The tag name to be used for event correlation.| |<|url|\-|`string`|<|URL associated with the trigger.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Trigger status.| |<|priority|\-|`string`|0 - NOT\_CLASSIFIED (default)<br>1 - INFO<br>2 - WARNING<br>3 - AVERAGE<br>4 - HIGH<br>5 - DISASTER|Trigger severity.| |<|description|\-|`text`|<|Trigger description.| |<|type|\-|`string`|0 - SINGLE (default)<br>1 - MULTIPLE|Event generation type (single problem event or multiple problem events).| |<|manual\_close|\-|`string`|0 - NO (default)<br>1 - YES|Manual closing of problem events.| |dependencies|<|\-|<|<|Root element for dependencies.| |<|name|x|`string`|<|Dependency trigger name.| |<|expression|x|`string`|<|Dependency trigger expression.| |<|recovery\_expression|\-|`string`|<|Dependency trigger recovery expression.| |tags|<|\-|<|<|Root element for event tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.|
ja	##### Host trigger タグ  |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |triggers|<|\-|<|<|Root element for triggers.| |<|expression|x|`string`|<|Trigger expression.| |<|recovery\_mode|\-|`string`|0 - EXPRESSION (default)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Basis for generating OK events.| |<|recovery\_expression|\-|`string`|<|Trigger recovery expression.| |<|name|x|`string`|<|Trigger name.| |<|correlation\_mode|\-|`string`|0 - DISABLED (default)<br>1 - TAG\_VALUE|Correlation mode (no event correlation or event correlation by tag).| |<|correlation\_tag|\-|`string`|<|The tag name to be used for event correlation.| |<|url|\-|`string`|<|URL associated with the trigger.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Trigger status.| |<|priority|\-|`string`|0 - NOT\_CLASSIFIED (default)<br>1 - INFO<br>2 - WARNING<br>3 - AVERAGE<br>4 - HIGH<br>5 - DISASTER|Trigger severity.| |<|description|\-|`text`|<|Trigger description.| |<|type|\-|`string`|0 - SINGLE (default)<br>1 - MULTIPLE|Event generation type (single problem event or multiple problem events).| |<|manual\_close|\-|`string`|0 - NO (default)<br>1 - YES|Manual closing of problem events.| |dependencies|<|\-|<|<|Root element for dependencies.| |<|name|x|`string`|<|Dependency trigger name.| |<|expression|x|`string`|<|Dependency trigger expression.| |<|recovery\_expression|\-|`string`|<|Dependency trigger recovery expression.| |tags|<|\-|<|<|Root element for event tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.|

en-us	# host.update
ja	# host.update

en-us	##### Host web scenario tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |httptests|<|\-|<|<|Root element for web scenarios.| |<|name|x|`string`|<|Web scenario name.| |<|delay|\-|`string`|Default: 1m|Frequency of executing the web scenario. Seconds, time unit with suffix or user macro.| |<|attempts|\-|`integer`|1-10 (default: 1)|The number of attempts for executing web scenario steps.| |<|agent|\-|`string`|Default: Zabbix|Client agent. Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.| |<|http\_proxy|\-|`string`|<|Specify an HTTP proxy to use, using the format: `http://[username[:password]@]proxy.example.com[:port]`| |variables|<|\-|<|<|Root element for scenario-level variables (macros) that may be used in scenario steps.| |<|name|x|`text`|<|Variable name.| |<|value|x|`text`|<|Variable value.| |headers|<|\-|<|<|Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|x|`text`|<|Header name.| |<|value|x|`text`|<|Header value.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Web scenario status.| |<|authentication|\-|`string`|0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication method.| |<|http\_user|\-|`string`|<|User name used for basic, HTTP or NTLM authentication.| |<|http\_password|\-|`string`|<|Password used for basic, HTTP or NTLM authentication.| |<|verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Verify the SSL certificate of the web server.| |<|verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Verify that the Common Name field or the Subject Alternate Name field of the web server certificate matches.| |<|ssl\_cert\_file|\-|`string`|<|Name of the SSL certificate file used for client authentication (must be in PEM format).| |<|ssl\_key\_file|\-|`string`|<|Name of the SSL private key file used for client authentication (must be in PEM format).| |<|ssl\_key\_password|\-|`string`|<|SSL private key file password.| |steps|<|x|<|<|Root element for web scenario steps.| |<|name|x|`string`|<|Web scenario step name.| |<|url|x|`string`|<|URL for monitoring.| |query\_fields|<|\-|<|<|Root element for query fields - an array of HTTP fields that will be added to the URL when performing a request.| |<|name|x|`string`|<|Query field name.| |<|value|\-|`string`|<|Query field value.| |posts|<|\-|<|<|HTTP POST variables as a string (raw post data) or as an array of HTTP fields (form field data).| |<|name|x|`string`|<|Post field name.| |<|value|x|`string`|<|Post field value.| |variables|<|\-|<|<|Root element of step-level variables (macros) that should be applied after this step.<br><br>If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix| |<|name|x|`string`|<|Variable name.| |<|value|x|`string`|<|Variable value.| |headers|<|\-|<|<|Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|x|`string`|<|Header name.| |<|value|x|`string`|<|Header value.| |<|follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP redirects.| |<|retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|HTTP response retrieve mode.| |<|timeout|\-|`string`|Default: 15s|Timeout of step execution. Seconds, time unit with suffix or user macro.| |<|required|\-|`string`|<|Text that must be present in the response. Ignored if empty.| |<|status\_codes|\-|`string`|<|A comma delimited list of accepted HTTP status codes. Ignored if empty. For example: 200-201,210-299| |tags|<|\-|<|<|Root element for web scenario tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.|
ja	##### Host web scenario タグ  |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |httptests|<|\-|<|<|Root element for web scenarios.| |<|name|x|`string`|<|Web scenario name.| |<|delay|\-|`string`|Default: 1m|Frequency of executing the web scenario. Seconds, time unit with suffix or user macro.| |<|attempts|\-|`integer`|1-10 (default: 1)|The number of attempts for executing web scenario steps.| |<|agent|\-|`string`|Default: Zabbix|Client agent. Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.| |<|http\_proxy|\-|`string`|<|Specify an HTTP proxy to use, using the format: `http://[username[:password]@]proxy.example.com[:port]`| |variables|<|\-|<|<|Root element for scenario-level variables (macros) that may be used in scenario steps.| |<|name|x|`text`|<|Variable name.| |<|value|x|`text`|<|Variable value.| |headers|<|\-|<|<|Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|x|`text`|<|Header name.| |<|value|x|`text`|<|Header value.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Web scenario status.| |<|authentication|\-|`string`|0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication method.| |<|http\_user|\-|`string`|<|User name used for basic, HTTP or NTLM authentication.| |<|http\_password|\-|`string`|<|Password used for basic, HTTP or NTLM authentication.| |<|verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Verify the SSL certificate of the web server.| |<|verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Verify that the Common Name field or the Subject Alternate Name field of the web server certificate matches.| |<|ssl\_cert\_file|\-|`string`|<|Name of the SSL certificate file used for client authentication (must be in PEM format).| |<|ssl\_key\_file|\-|`string`|<|Name of the SSL private key file used for client authentication (must be in PEM format).| |<|ssl\_key\_password|\-|`string`|<|SSL private key file password.| |steps|<|x|<|<|Root element for web scenario steps.| |<|name|x|`string`|<|Web scenario step name.| |<|url|x|`string`|<|URL for monitoring.| |query\_fields|<|\-|<|<|Root element for query fields - an array of HTTP fields that will be added to the URL when performing a request.| |<|name|x|`string`|<|Query field name.| |<|value|\-|`string`|<|Query field value.| |posts|<|\-|<|<|HTTP POST variables as a string (raw post data) or as an array of HTTP fields (form field data).| |<|name|x|`string`|<|Post field name.| |<|value|x|`string`|<|Post field value.| |variables|<|\-|<|<|Root element of step-level variables (macros) that should be applied after this step.<br><br>If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix| |<|name|x|`string`|<|Variable name.| |<|value|x|`string`|<|Variable value.| |headers|<|\-|<|<|Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|x|`string`|<|Header name.| |<|value|x|`string`|<|Header value.| |<|follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP redirects.| |<|retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|HTTP response retrieve mode.| |<|timeout|\-|`string`|Default: 15s|Timeout of step execution. Seconds, time unit with suffix or user macro.| |<|required|\-|`string`|<|Text that must be present in the response. Ignored if empty.| |<|status\_codes|\-|`string`|<|A comma delimited list of accepted HTTP status codes. Ignored if empty. For example: 200-201,210-299| |tags|<|\-|<|<|Root element for web scenario tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.|

en-us	#### - Housekeeper  The housekeeper is a periodical process, executed by Zabbix server. The process removes outdated information and information deleted by user.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_housekeeper1.png)  In this section housekeeping tasks can be enabled or disabled on a per-task basis separately for: events and alerts/IT services/user sessions/history/trends. Audit housekeeping settings are available in a separate [menu section](/manual/web_interface/frontend_sections/administration/general#audit_log).  If housekeeping is enabled, it is possible to set for how many days data records will be kept before being removed by the housekeeper.  Deleting an item/trigger will also delete problems generated by that item/trigger.  Also, an event will only be deleted by the housekeeper if it is not associated with a problem in any way. This means that if an event is either a problem or recovery event, it will not be deleted until the related problem record is removed. The housekeeper will delete problems first and events after, to avoid potential problems with stale events or problem records.  For history and trends an additional option is available: *Override item history period* and *Override item trend period*. This option allows to globally set for how many days item history/trends will be kept (1 hour to 25 years; or "​0"​), in this case overriding the values set for individual items in *History storage period/Trend storage period* fields in [item configuration](/manual/config/items/item). Note, that the storage period will not be overridden for items that have configuration option *Do not keep history* and/or *Do not keep trends* enabled.  It is possible to override the history/trend storage period even if internal housekeeping is disabled. Thus, when using an external housekeeper, the history storage period could be set using the history *Data storage period* field.  ::: noteimportant If using TimescaleDB, in order to take full advantage of TimescaleDB automatic partitioning of history and trends tables, *Override item history period* and *Override item trend period* options must be enabled as well as *Enable internal housekeeping* option for history and trends. Otherwise, the data kept in these tables will still be stored in partitions, however, the housekeeper will be cleaning the history and trends by deleting individual records rather than by dropping outdated partitions. When dropping of outdated partitions is enabled, Zabbix server and frontend will no longer keep track of deleted items and history for deleted items will be cleared when an outdated partition is deleted. :::  [Time suffixes](/manual/appendix/suffixes) are supported in the period fields, e.g. 1d (one day), 1w (one week). The minimum is 1 day (1 hour for history), the maximum - 25 years.  *Reset defaults* button allows to revert any changes made.  
ja	#### - Housekeeper  The housekeeper is a periodical process, executed by Zabbix server. The process removes outdated information and information deleted by user.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_housekeeper1.png)  In this section housekeeping tasks can be enabled or disabled on a per-task basis separately for: events and alerts/IT services/user sessions/history/trends. Audit housekeeping settings are available in a separate [menu section](/manual/web_interface/frontend_sections/administration/general#audit_log).  If housekeeping is enabled, it is possible to set for how many days data records will be kept before being removed by the housekeeper.  Deleting an item/trigger will also delete problems generated by that item/trigger.  Also, an event will only be deleted by the housekeeper if it is not associated with a problem in any way. This means that if an event is either a problem or recovery event, it will not be deleted until the related problem record is removed. The housekeeper will delete problems first and events after, to avoid potential problems with stale events or problem records.  For history and trends an additional option is available: *Override item history period* and *Override item trend period*. This option allows to globally set for how many days item history/trends will be kept (1 hour to 25 years; or "​0"​), in this case overriding the values set for individual items in *History storage period/Trend storage period* fields in [item configuration](/manual/config/items/item). Note, that the storage period will not be overridden for items that have configuration option *Do not keep history* and/or *Do not keep trends* enabled.  It is possible to override the history/trend storage period even if internal housekeeping is disabled. Thus, when using an external housekeeper, the history storage period could be set using the history *Data storage period* field.  ::: noteimportant If using TimescaleDB, in order to take full advantage of TimescaleDB automatic partitioning of history and trends tables, *Override item history period* and *Override item trend period* options must be enabled as well as *Enable internal housekeeping* option for history and trends. Otherwise, the data kept in these tables will still be stored in partitions, however, the housekeeper will be cleaning the history and trends by deleting individual records rather than by dropping outdated partitions. When dropping of outdated partitions is enabled, Zabbix server and frontend will no longer keep track of deleted items and history for deleted items will be cleared when an outdated partition is deleted. :::  [Time suffixes](/manual/appendix/suffixes) are supported in the period fields, e.g. 1d (one day), 1w (one week). The minimum is 1 day (1 hour for history), the maximum - 25 years.  *Reset defaults* button allows to revert any changes made.  

en-us	#### - Housekeeper  The housekeeper is a periodical process, executed by Zabbix server. The process removes outdated information and information deleted by user.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_housekeeper1.png)  In this section housekeeping tasks can be enabled or disabled on a per-task basis separately for: events and alerts/IT services/user sessions/history/trends. Audit housekeeping settings are available in a separate [menu section](/manual/web_interface/frontend_sections/administration/general#audit_log).  If housekeeping is enabled, it is possible to set for how many days data records will be kept before being removed by the housekeeper.  Deleting an item/trigger will also delete problems generated by that item/trigger.  Also, an event will only be deleted by the housekeeper if it is not associated with a problem in any way. This means that if an event is either a problem or recovery event, it will not be deleted until the related problem record is removed. The housekeeper will delete problems first and events after, to avoid potential problems with stale events or problem records.  For history and trends an additional option is available: *Override item history period* and *Override item trend period*. This option allows to globally set for how many days item history/trends will be kept (1 hour to 25 years; or "0"), in this case overriding the values set for individual items in *History storage period/Trend storage period* fields in [item configuration](/manual/config/items/item). Note, that the storage period will not be overridden for items that have configuration option *Do not keep history* and/or *Do not keep trends* enabled.  It is possible to override the history/trend storage period even if internal housekeeping is disabled. Thus, when using an external housekeeper, the history storage period could be set using the history *Data storage period* field.  ::: noteimportant If using TimescaleDB, in order to take full advantage of TimescaleDB automatic partitioning of history and trends tables, *Override item history period* and *Override item trend period* options must be enabled as well as *Enable internal housekeeping* option for history and trends. Otherwise, the data kept in these tables will still be stored in partitions, however, the housekeeper will be cleaning the history and trends by deleting individual records rather than by dropping outdated partitions. When dropping of outdated partitions is enabled, Zabbix server and frontend will no longer keep track of deleted items and history for deleted items will be cleared when an outdated partition is deleted. :::  [Time suffixes](/manual/appendix/suffixes) are supported in the period fields, e.g. 1d (one day), 1w (one week). The minimum is 1 day (1 hour for history), the maximum - 25 years.  *Reset defaults* button allows to revert any changes made.
ja	#### - データの保存期間  ハウスキーピングは定期的なプロセスで、Zabbixサーバーによって実行されます。 このプロセスでは、古い情報とユーザーによって削除された情報が削除されます。  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_housekeeper1.png)  このセクションでハウスキーピングタスクをタスクごと個別に有効または無効にできます。イベントとアラート/ITサービス/ユーザーセッション/履歴/トレンド。 監査データ保存設定は、別の[メニューセクション](/manual/web_interface/frontend_sections/administration/general#audit_log)で利用できます。  データの保存が有効になっている場合、削除されるまでにデータレコードが保持される日数を設定できます。  アイテム/トリガーを削除すると、そのアイテム/トリガーによって生成された問題も削除されます。  またイベントは、障害に関連付けられていない場合にのみ、ハウスキーパーによって削除されます。 これは、イベントが障害または回復イベントのいずれかである場合、関連する障害レコードが削除されるまで削除されないことを意味します。 ハウスキーパーは、古いイベントや障害レコードに関する潜在的な問題を回避するために、最初に障害を削除し、その後にイベントを削除します。  履歴とトレンドについては、追加のオプションを使用できます：*アイテムのヒストリの保存期間設定を上書き*および*アイテムのヒストリの保存期間設定を上書き*です。 このオプションを使用すると、アイテムのヒストリ/トレンドを保持する日数（1時間から25年、つまり「0」）をグローバルに設定できます。この場合、*履歴保存期間/トレンド保存期間*の個々のアイテムに設定された値が上書きされます。注意： [アイテム構成](/manual/config/items/item)のフィールド設定オプション*ヒストリを保持しない*および/または*トレンドを保持しない*が有効になっているアイテムの保存期間は上書きされません。  内部ハウスキーピングが無効になっている場合でも、ヒストリ/トレンド保存期間を上書きすることができます。 したがって、外部ハウスキーパーを使用する場合、ヒストリ保存期間は、履歴*データ保存期間*フィールドを使用して設定できます。  ::: noteimportant TimescaleDBを使用する場合、ヒストリとトレンドテーブルのTimescaleDB自動パーティション化を最大限に活用するには、アイテムのヒストリの保存期間設定を上書き*および*アイテムのヒストリの保存期間設定を上書き*オプションを有効にする必要があります。また、ヒストリとトレンドの*内部ハウスキーピング*オプションを有効にする必要があります。 それ以外の場合これらのテーブルに保持されているデータは引き続きパーティションに保存されますが、ハウスキーパーは、古いパーティションを削除するのではなく、個々のレコードを削除することでヒストリとトレンドをクリーンアップします。 古いパーティションのドロップが有効になっている場合、Zabbixサーバーとフロントエンドは削除されたアイテムを追跡しなくなり、古いパーティションが削除されると削除されたアイテムの履歴がクリアされます。 :::  [タイムサフィックス](/manual/appendix/suffixes)は期間フィールドでサポートされています。 1d（1日）、1w（1週間）。 最短は1日（履歴は1時間）、最長は25年です。  *デフォルトにリセット*ボタンを使用すると、行った変更を元に戻すことができます。

en-us	#### housekeeping  Changes:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) added support of property `hk_events_service`.\
ja	#### ハウスキーピング  変更点:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) プロパティ `hk_events_service` のサポートを開始しました。\

en-us	# housekeeping.get
ja	# housekeeping.get

en-us	# > Housekeeping object  The following objects are directly related to the `housekeeping` API.
ja	# > Housekeepingオブジェクト  次のオブジェクトは、`housekeeping`APIに直接関連しています。

en-us	### Housekeeping  The settings object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hk\_events\_mode|integer|Enable internal housekeeping for events and alerts.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_events\_trigger|string|Trigger data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_events\_service|string|Service data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_internal|string|Internal data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_discovery|string|Network discovery data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_autoreg|string|Autoregistration data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_services\_mode|integer|Enable internal housekeeping for services.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_services|string|Services data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_audit\_mode|integer|Enable internal housekeeping for audit.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_audit|string|Audit data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_sessions\_mode|integer|Enable internal housekeeping for sessions.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_sessions|string|Sessions data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_history\_mode|integer|Enable internal housekeeping for history.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_history\_global|integer|Override item history period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_history|string|History data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 90d.| |hk\_trends\_mode|integer|Enable internal housekeeping for trends.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_trends\_global|integer|Override item trend period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_trends|string|Trends data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |db\_extension|string|*(readonly)* Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.| |compression\_status|integer|Enable TimescaleDB compression for history and trends.<br><br>Possible values:<br>0 - *(default)* Off;<br>1 - On.| |compress\_older|string|Compress history and trends records older than specified period. Accepts seconds and time unit with suffix.<br><br>Default: 7d.| |compression\_availability|integer|*(readonly)* Compression availability.<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.|
ja	### Housekeeping  settings オブジェクトは、以下のプロパティを持ちます。  |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |hk\_events\_mode|integer|Enable internal housekeeping for events and alerts.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_events\_trigger|string|Trigger data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_events\_service|string|Service data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_internal|string|Internal data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_discovery|string|Network discovery data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_autoreg|string|Autoregistration data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_services\_mode|integer|Enable internal housekeeping for services.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_services|string|Services data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_audit\_mode|integer|Enable internal housekeeping for audit.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_audit|string|Audit data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_sessions\_mode|integer|Enable internal housekeeping for sessions.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_sessions|string|Sessions data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_history\_mode|integer|Enable internal housekeeping for history.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_history\_global|integer|Override item history period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_history|string|History data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 90d.| |hk\_trends\_mode|integer|Enable internal housekeeping for trends.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_trends\_global|integer|Override item trend period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_trends|string|Trends data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |db\_extension|string|*(readonly)* Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.| |compression\_status|integer|Enable TimescaleDB compression for history and trends.<br><br>Possible values:<br>0 - *(default)* Off;<br>1 - On.| |compress\_older|string|Compress history and trends records older than specified period. Accepts seconds and time unit with suffix.<br><br>Default: 7d.| |compression\_availability|integer|*(readonly)* Compression availability.<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.|

en-us	# Housekeeping  This class is designed to work with housekeeping.  Object references:\  -   [Housekeeping](/manual/api/reference/housekeeping/object#housekeeping)  Available methods:\  -   [housekeeping.get](/manual/api/reference/housekeeping/get) -     retrieve housekeeping -   [housekeeping.update](/manual/api/reference/housekeeping/update) -     update housekeeping
ja	# Housekeeping  このクラスは、ハウスキーピングを操作するためのものです。  オブジェクトリファレンス :\  -   [Housekeeping](/manual/api/reference/housekeeping/object#housekeeping)  利用可能なメソッド :\  -   [housekeeping.get](/manual/api/reference/housekeeping/get) - ハウスキーピングの取得 -   [housekeeping.update](/manual/api/reference/housekeeping/update) - ハウスキーピングの更新

en-us	# housekeeping.update
ja	# housekeeping.update

en-us	#### How it works  In log monitoring you may encounter lines similar to these:      Line1: Application 1 stopped     Line2: Application 2 stopped     Line3: Application 1 was restarted     Line4: Application 2 was restarted  The idea of event correlation is to be able to match the problem event from Line1 to the resolution from Line3 and the problem event from Line2 to the resolution from Line4, and close these problems one by one:      Line1: Application 1 stopped     Line3: Application 1 was restarted #problem from Line 1 closed      Line2: Application 2 stopped     Line4: Application 2 was restarted #problem from Line 2 closed  To do this you need to tag these related events as, for example, "Application 1" and "Application 2". That can be done by applying a regular expression to the log line to extract the tag value. Then, when events are created, they are tagged "Application 1" and "Application 2" respectively and problem can be matched to the resolution.
ja	#### 仕組み  ログモニタリングでは、以下のような行が表示されることがあります:      Line1: Application 1 stopped     Line2: Application 2 stopped     Line3: Application 1 was restarted     Line4: Application 2 was restarted  イベント相関の考え方は、Line1からの問題イベントとLine3からの解決、Line2からの問題イベントとLine4からの解決を<br> 一致させ、これらの問題を1つずつ解決することができることです:      Line1: Application 1 stopped     Line3: Application 1 was restarted #problem from Line 1 closed      Line2: Application 2 stopped     Line4: Application 2 was restarted #problem from Line 2 closed  そのためには、これらの関連するイベントに、例えば "アプリケーション1" や "アプリケーション2" のようなタグを付ける<br> 必要があります。これは、ログラインに正規表現を適用して、タグの値を抽出することで実現できます。その後、イベントが<br> 作成されると、それぞれ "アプリケーション1" と "アプリケーション2" というタグが付けられ、問題を解決するために<br> 照合することができます。

en-us	#### How to  To begin with, you need to create a PHP file and save it as `local/conf/brand.conf.php`. The contents of the file should be the following:  ``` {.php} <?php  return []; ```  This will hide the links to Zabbix Support and Zabbix Integrations.
ja	#### ハウツー  まずPHPファイルを作成し、`local/conf/brand.conf.php`として保存する必要があります。ファイルの内容は次のとおりです。  ``` {.php} <?php  return []; ```  これにより、ZabbixサポートとZabbix統合へのリンクが非表示になります。

en-us	#### HP OpenView  Zabbix can be configured to send messages to OpenView server. The following steps must be performed:
ja	#### HP OpenView  Zabbixは、メッセージを OpenView サーバーに送信するように設定できます。 次の手順を実行する必要があります。

en-us	### HTML support in Geomap attribution dropped  The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped. If this field already contains HTML, it will be rendered as plain text after the upgrade.  In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*.
ja	### Geomap アトリビューションでの HTML サポートが終了  [Geomap ダッシュボード ウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) の帰属テキストからHTML サポートが廃止され、プレーン テキストのみを含めることができるようになりました。 このフィールドに既に HTML が含まれている場合、アップグレード後にはプレーン テキストとして表示されます。  [地理マップ](/manual/web_interface/frontend_sections/administration/general#geographical-maps) の設定 [管理] → [全般] セクションで、[属性] フィールドは、[タイル プロバイダー] が [その他] に設定されている場合にのみ表示されるようになりました。

en-us	### HTML support in Geomap attribution dropped  The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped.  In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*.
ja	### Geomap アトリビューションの HTML サポートの終了  [Geomap ダッシュボードウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) のアトリビューションテキストはプレーンテキストのみ対応になりました。HTMLのサポートは終了しました。  [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) の設定では、 管理 → 一般 セクションで、*アトリビューション* 欄は、*タイルプロバイダー* が *その他* に設定されている場合のみ表示されるようになりました。

en-us	### HTTP authentication  HTTP or web server-based authentication (for example: Basic Authentication, NTLM/Kerberos) can be used to check user names and passwords. Note that a user must exist in Zabbix as well, however its Zabbix password will not be used.  ::: noteimportant Be careful! Make sure that web server authentication is configured and works properly before switching it on. :::  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/auth_http.png)  Configuration parameters:  |Parameter|Description| |--|--------| |*Enable HTTP authentication*|Mark the checkbox to enable HTTP authentication.| |*Default login form*|Specify whether to direct non-authenticated users to:<br>**Zabbix login form** - standard Zabbix login page.<br>**HTTP login form** - HTTP login page.<br>It is recommended to enable web-server based authentication for the `index_http.php` page only. If *Default login form* is set to 'HTTP login page' the user will be logged in automatically if web server authentication module will set valid user login in the `$_SERVER` variable.<br>Supported `$_SERVER` keys are `PHP_AUTH_USER`, `REMOTE_USER`, `AUTH_USER`.| |*Remove domain name*|A comma-delimited list of domain names that should be removed from the username.<br>E.g. `comp,any` - if username is 'Admin\@any', 'comp\\Admin', user will be logged in as 'Admin'; if username is 'notacompany\\Admin', login will be denied.| |*Case sensitive login*|Unmark the checkbox to disable case-sensitive login (enabled by default) for usernames.<br>E.g. disable case-sensitive login and log in with, for example, 'ADMIN' user even if the Zabbix user is 'Admin'.<br>*Note* that with case-sensitive login disabled the login will be denied if multiple users exist in Zabbix database with similar usernames (e.g. Admin, admin).|  ::: noteclassic In case of web server authentication all users (even with [frontend access](/manual/config/users_and_usergroups/usergroup#configuration) set to LDAP/Internal) will be authenticated by the web server, not by Zabbix! :::  ::: notetip For internal users who are unable to log in using HTTP credentials (with HTTP login form set as default) leading to the 401 error, you may want to add a `ErrorDocument 401 /index.php?form=default` line to basic authentication directives, which will redirect to the regular Zabbix login form. :::
ja	### HTTP認証の設定  HTTPまたはWebサーバーベースの認証（例：Basic認証、NTLM / Kerberos）を使用して、ユーザー名とパスワードを確認できます。ユーザーはZabbixにも存在する必要がありますが、そのZabbixパスワードは使用されないことに注意してください。  ::: noteimportant オンにする前に、Webサーバー認証が構成され、正しく機能していることを確認してください。 :::  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/auth_http.png)  設定値:  |パラメーター|説明| |---------|-----------| |*HTTP認証の有効化*|チェックボックスをオンにすると、HTTP認証が有効になります。| |*デフォルトのログイン画面*|認証されていないユーザーをどの画面に誘導するかを指定します：<br>**Zabbixのログイン画面** - 標準のZabbixログインページ<br>**HTTPのログイン画面** - HTTPログインページ<br>`index_http.php`ページに対してのみWebサーバーベースの認証を有効にすることをお勧めします。 *デフォルトのログイン画面*が'HTTPログインページ'に設定されている場合、Webサーバー認証モジュールが`$_SERVER`変数に有効なユーザーログインを設定すると、ユーザーは自動的にログインします。<br>サポートされている`$_SERVER`キーは`PHP_AUTH_USER`, `REMOTE_USER`,`AUTH_USER`です。| |*ドメイン名の削除*|ユーザー名から削除する必要があるドメイン名のカンマ区切りのリスト。<br>例： `comp,any` - ユーザー名が'Admin\@any','comp\\Admin'の場合、ユーザーは'Admin'としてログインします。ユーザー名が'notacompany\\Admin'の場合、ログインは拒否されます。| |*ログイン時に大文字小文字を区別*|ユーザー名の大文字と小文字を区別するログイン(デフォルトで有効)を無効にするには、チェックボックスをオフにします。<br>例:大文字と小文字を区別するログインを無効にすると、ユーザーが'Admin'でログインしたの場合でも'ADMIN'ユーザーでログインします。<br> *注*大文字と小文字を区別するログインを無効にすると、Zabbixデータベースに同様のユーザー名を持つ複数のユーザーが存在する場合 (例:Admin, admin)、ログインが拒否されることに注意してください。|  ::: noteclassic Webサーバー認証の場合、すべてのユーザー（[フロントエンドアクセス](/manual/config/users_and_usergroups/usergroup#configuration) がLDAP/Internalに設定されている場合でも）は、ZabbixではなくWebサーバーによって認証されます。 :::  ::: notetip HTTP資格情報（HTTPログインフォームがデフォルトとして設定されている）を使用してログインできず、401エラーが発生する内部ユーザーは、Basic認証ディレクティブに `ErrorDocument 401/index.php?form=default`行を追加すると、通常のZabbixログイン画面にリダイレクトされます。 :::

en-us	### HTTP field  The HTTP field object defines a name and value that is used to specify variable, HTTP header, POST form field data of query field data. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of header / variable / POST or GET field.| |**value**<br>(required)|string|Value of header / variable / POST or GET field.|
ja	### HTTP field  HTTP fieldオブジェクトは、クエリフィールドデータの変数、HTTPヘッダー、POSTフォームフィールドデータを指定するために使用される名前と値を定義します。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**name**<br>(必須)|string|ヘッダー/変数/POSTまたはGETフィールドの名前| |**value**<br>(必須)|string|ヘッダー/変数/POSTまたはGETフィールドの値|

en-us	#### HttpRequest  ::: noteimportant "HttpRequest" is a new name for this object since Zabbix 5.4. Previously it was called "CurlHttpRequest". Method names have also been changed in Zabbix 5.4. The old object/method names are now deprecated and their support will be discontinued after Zabbix 6.0. :::  This object encapsulates cURL handle allowing to make simple HTTP requests. Errors are thrown as exceptions.  ::: noteimportant The initialization of multiple `HttpRequest` objects is limited to 10 per script execution. :::  |Method|Description| |--|--------| |`addHeader(value)`|Adds HTTP header field. This field is used for all following requests until cleared with the `clearHeader()` method.<br>The total length of header fields that can be added to a single `HttpRequest` object is limited to 128 Kbytes (special characters and header names included).| |`clearHeader()`|Clears HTTP header. If no header fields are set, `HttpRequest` will set Content-Type to application/json if the data being posted is JSON-formatted; text/plain otherwise.| |`connect(url)`|Sends HTTP CONNECT request to the URL and returns the response.| |`customRequest(method, url, data)`|Allows to specify any HTTP method in the first parameter. Sends the method request to the URL with optional *data* payload and returns the response.| |`delete(url, data)`|Sends HTTP DELETE request to the URL with optional *data* payload and returns the response.| |`getHeaders(<asArray>)`|Returns the object of received HTTP header fields.<br>The `asArray` parameter may be set to "true" (e.g. `getHeaders(true)`), "false" or be undefined. If set to "true" the received HTTP header field values will be returned as arrays; this should be used to retrieve the field values of multiple same-name headers.<br>If not set or set to "false", the received HTTP header field values will be returned as strings.| |`get(url, data)`|Sends HTTP GET request to the URL with optional *data* payload and returns the response.| |`head(url)`|Sends HTTP HEAD request to the URL and returns the response.| |`options(url)`|Sends HTTP OPTIONS request to the URL and returns the response.| |`patch(url, data)`|Sends HTTP PATCH request to the URL with optional *data* payload and returns the response.| |`put(url, data)`|Sends HTTP PUT request to the URL with optional *data* payload and returns the response.| |`post(url, data)`|Sends HTTP POST request to the URL with optional *data* payload and returns the response.| |`getStatus()`|Returns the status code of the last HTTP request.| |`setProxy(proxy)`|Sets HTTP proxy to "proxy" value. If this parameter is empty then no proxy is used.| |`setHttpAuth(bitmask, username, password)`|Sets enabled HTTP authentication methods (HTTPAUTH\_BASIC, HTTPAUTH\_DIGEST, HTTPAUTH\_NEGOTIATE, HTTPAUTH\_NTLM, HTTPAUTH\_NONE) in the 'bitmask' parameter.<br>The HTTPAUTH\_NONE flag allows to disable HTTP authentication.<br>Examples:<br>`request.setHttpAuth(HTTPAUTH_NTLM \| HTTPAUTH_BASIC, username, password)`<br>`request.setHttpAuth(HTTPAUTH_NONE)`| |`trace(url, data)`|Sends HTTP TRACE request to the URL with optional *data* payload and returns the response.|  Example:  ```javascript try {     Zabbix.log(4, 'jira webhook script value='+value);        var result = {         'tags': {             'endpoint': 'jira'         }     },     params = JSON.parse(value),     req = new HttpRequest(),     fields = {},     resp;        req.addHeader('Content-Type: application/json');     req.addHeader('Authorization: Basic '+params.authentication);        fields.summary = params.summary;     fields.description = params.description;     fields.project = {"key": params.project_key};     fields.issuetype = {"id": params.issue_id};     resp = req.post('https://jira.example.com/rest/api/2/issue/',         JSON.stringify({"fields": fields})     );        if (req.getStatus() != 201) {         throw 'Response code: '+req.getStatus();     }        resp = JSON.parse(resp);     result.tags.issue_id = resp.id;     result.tags.issue_key = resp.key; } catch (error) {     Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));     Zabbix.log(4, 'jira issue creation failed : '+error);        result = {}; }    return JSON.stringify(result); ```
ja	#### HttpRequest  このオブジェクトは、単純な HttpRequest を行うための cURL ハンドルをカプセル化したものです。エラーは例外として投げられます  ::: noteimportant HttpRequestはZabbix 5.4から採用された新しい名称です。以前はCurlHttpRequestと呼ばれていました。 Zabbix 5.4からメソッド名も変更されました。旧オブジェクト/メソッド名は非推奨となり、Zabbix 6.0以降サポートは廃止となります。 :::  |Method|Description| |--|--------| |`addHeader(value)`|HTTPヘッダーフィールドを追加します。このフィールドは、`clearHeader()`メソッドでクリアされるまで、以降のすべてのリクエストに使用されます。<br>単一の`HttpRequest`オブジェクトに追加できるヘッダーフィールドの合計長は、128KBに制限されています (特殊文字とヘッダー名を含む)。| |`clearHeader()`|HTTPヘッダーをクリアします。ヘッダーフィールドが設定されていない場合、`HttpRequest`は、投稿されるデータがJSON形式であればContent-Typeをapplication/jsonに設定し、それ以外の場合はtext/plainに設定します。| |`connect(url)`|HTTP CONNECT リクエストを URL に送信し、応答を返します。| |`customRequest(method, url, data)`|最初のパラメータで任意の HTTP メソッドを指定できます。オプションの *data* ペイロードを含むメソッド要求を URL に送信し、応答を返します。| |`delete(url, data)`|オプションの *data* ペイロードを含む HTTP DELETE リクエストを URL に送信し、応答を返します。| |`getHeaders(<asArray>)`|受信したHTTPヘッダーフィールドのオブジェクトを返します。<br>`asArray`パラメータは、"true"(例: `getHeaders(true)`)、"false"、または未定義に設定できます。"true"に設定すると、受信したHTTPヘッダーフィールドの値は配列として返されます。これは、複数の同じ名前のヘッダーのフィールド値を取得するために使用する必要があります。<br>設定されていないか、"false"に設定されている場合、受信した HTTPヘッダーフィールドの値は文字列として返されます。| |`get(url, data)`|オプションの*data*ペイロードを含むHTTP GETリクエストをURLに送信し、応答を返します。| |`head(url)`|HTTP HEADリクエストをURLに送信し、応答を返します。| |`options(url)`|HTTP OPTIONSリクエストをURLに送信し、応答を返します。| |`patch(url, data)`|オプションの*data*ペイロードを含むHTTP PATCH要求をURLに送信し、応答を返します。| |`put(url, data)`|オプションの*data*ペイロードを含むHTTP PUTリクエストをURLに送信し、応答を返します。| |`post(url, data)`|オプションの*data*ペイロードを含むHTTP POSTリクエストをURLに送信し、応答を返します。| |`getStatus()`|最後のHTTPリクエストのステータス コードを返します。| |`setProxy(proxy)`|HTTPプロキシを"proxy"値に設定します。このパラメータが空の場合、プロキシは使用されません。| |`setHttpAuth(bitmask, username, password)`|'bitmask'パラメータで有効なHTTP認証方法(HTTPAUTH\_BASIC、HTTPAUTH\_DIGEST、HTTPAUTH\_NEGOTIATE、HTTPAUTH\_NTLM、HTTPAUTH\_NONE)を設定します。<br>HTTPAUTH\_NONEフラグを使用すると、HTTP認証を無効にできます。<br>例:<br>`request.setHttpAuth(HTTPAUTH_NTLM \| HTTPAUTH_BASIC、ユーザー名、パスワード)`<br>`request.setHttpAuth(HTTPAUTH_NONE)`| |`trace(url, data)`|オプションの*data*ペイロードを含むHTTP TRACE要求をURLに送信し、応答を返します。|  例:  ``` {.java} try {     Zabbix.log(4, 'jira webhook script value='+value);        var result = {         'tags': {             'endpoint': 'jira'         }     },     params = JSON.parse(value),     req = new HttpRequest(),     fields = {},     resp;        req.addHeader('Content-Type: application/json');     req.addHeader('Authorization: Basic '+params.authentication);        fields.summary = params.summary;     fields.description = params.description;     fields.project = {"key": params.project_key};     fields.issuetype = {"id": params.issue_id};     resp = req.post('https://jira.example.com/rest/api/2/issue/',         JSON.stringify({"fields": fields})     );        if (req.getStatus() != 201) {         throw 'Response code: '+req.getStatus();     }        resp = JSON.parse(resp);     result.tags.issue_id = resp.id;     result.tags.issue_key = resp.key; } catch (error) {     Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));     Zabbix.log(4, 'jira issue creation failed : '+error);        result = {}; }    return JSON.stringify(result); ```

en-us	#### HTTPS checks  Web scenarios and HTTP agent items using the https protocol, Zabbix agent checks `net.tcp.service[https...]` and `net.tcp.service.perf[https...]` may fail if the target server is configured to disallow TLS v1.0 protocol or below. Please see [ZBX-9879](https://support.zabbix.com/browse/ZBX-9879) for more information and available workarounds.
ja	#### HTTPSチェック  httpsプロトコルを使用するWebシナリオとHTTPエージェントのアイテムは、 <br> Zabbix agent が `net.tcp.service[https...]` と `net.tcp.service.perf[https...]` をチェックします。 <br> net.tcp.service.perf[https...]`は、ターゲットサーバがTLS v.1.0を許可しないように設定されている場合、失敗する可能性があります。 <br> [ZBX-9879](https://support.zabbix.com/browse/ZBX-9879)を参照してください。 <br>

en-us	# HTTP template operation  Steps to ensure correct operation of templates that collect metrics with [HTTP agent](/manual/config/items/itemtypes/http):  1\. Create a host in Zabbix and specify an IP address or DNS name of the monitoring target as the main interface. This is needed for the {HOST.CONN} macro to resolve properly in the template items.\ 2. [Link](/manual/config/templates/linking#linking_a_template) the template to the host created in step 1 (if the template is not available in your Zabbix installation, you may need to import the template's .xml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions).\ 3. Adjust the values of mandatory macros as needed.\ 4. Configure the instance being monitored to allow sharing data with Zabbix - see instructions in the *Additional steps/comments* column.  ::: notetip  This page contains only a minimum set of macros and setup steps that are required for proper template operation. A detailed description of a template, including the full list of macros, items and triggers, is available in the template's Readme.md file (accessible by clicking on a template name).  :::  |Template|Mandatory macros|Additional steps/comments| |--------|----------------|-------------------------| |[Apache by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_http)|**{$APACHE.STATUS.HOST}** - the hostname or IP address of Apache status page (default: 127.0.0.1).<br>**{$APACHE.STATUS.PATH}** - the URL path (default: server-status?auto).<br>**{$APACHE.STATUS.PORT}** - the port of Apache status page (default: 80).<br>**{$APACHE.STATUS.SCHEME}** - the request scheme. Supported: http (default), https.|Apache module mod\_status should be set (see Apache [documentation](https://httpd.apache.org/docs/current/mod/mod_status.html) for details).<br>To check availability, run:<br>`httpd -M 2>/dev/null \| grep status_module`<br><br>Apache configuration example:<br>`<Location "/server-status">`<br>`SetHandler server-status`<br>`Require host example.com`<br>`</Location>`| |[Asterisk by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/tel/asterisk_http)|**{$AMI.PORT}** - AMI port number for checking service availability (default: 8088).<br>**{$AMI.SECRET}** - the Asterisk Manager secret (default: zabbix).<br>**{$AMI.URL}** - the Asterisk Manager API URL in the format<br>`<scheme>://<host>:<port>/<prefix>/rawman`<br>(default: http://asterisk:8088/asterisk/rawman).<br>**{$AMI.USERNAME}** - the Asterisk Manager name.|1\. Enable the [mini-HTTP Server](https://wiki.asterisk.org/wiki/display/AST/Asterisk+Builtin+mini-HTTP+Server).<br><br>2. Add the option `webenabled=yes` to the general section of *manager.conf* file.<br><br>3. Create *Asterisk Manager* user in the Asterisk instance.| |[ClickHouse by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/clickhouse_http/README.md)|**{$CLICKHOUSE.PORT}** - the port of ClickHouse HTTP endpoint (default: 8123).<br>**{$CLICKHOUSE.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$CLICKHOUSE.USER}**, **{$CLICKHOUSE.PASSWORD}** - ClickHouse login credentials (default username: zabbix, password: zabbix\_pass).<br>If you don't need authentication, remove headers from HTTP agent type items.|Create a ClickHouse user with a 'web' profile and permission to view databases (see ClickHouse [documentation](https://clickhouse.tech/docs/en/operations/settings/settings-users/) for details).<br><br>See template's *Readme.md* file for a ready-to-use zabbix.xml file configuration.| |[Cloudflare by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/cloudflare_http/README.md)|**{$CLOUDFLARE.API.TOKEN}** - Cloudflare API token value (default: \`<change>\`).<br>**{$CLOUDFLARE.ZONE\_ID}** - Cloudflare Site Zone ID (default: \`<change>\`).|Cloudflare API Tokens are available in the Cloudflare account under *My Profile→ API Tokens*.<br>Zone ID is available in the Cloudflare account under *Account Home → Site*.| |[DELL PowerEdge R720 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r720_http/README.md),<br>[DELL PowerEdge R740 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r740_http/README.md),<br>[DELL PowerEdge R820 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r820_http/README.md),<br>[DELL PowerEdge R840 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r840_http/README.md)|**{$API.URL}** - Dell iDRAC Redfish API URL in the format `<scheme>://<host>:<port>` (default: <Put your URL here>)<br>**{$API.USER}**, **{$API.PASSWORD}** - Dell iDRAC login credentials (default: not set).|In the Dell iDRAC interface of your server:<br>1. Enable Redfish API .<br>2. Create a user for monitoring with read-only permissions.| |[Elasticsearch Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/elasticsearch_http/README.md)|**{$ELASTICSEARCH.PORT}** - the port of the Elasticsearch host (default: 9200).<br>**{$ELASTICSEARCH.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$ELASTICSEARCH.USERNAME}**, **{$ELASTICSEARCH.PASSWORD}** - login credentials, required only if used for Elasticsearch authentication.|<| |[Etcd by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/etcd_http/README.md)|**{$ETCD.PORT}**- the port used by Etcd API endpoint (default: 2379).<br>**{$ETCD.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$ETCD.USER}**, **{$ETCD.PASSWORD}** - login credentials, required only if used for Etcd authentication.|Metrics are collected from /metrics endpoint; to specify the endpoint's location use `--listen-metrics-urls` flag (see Etcd [documentation](https://github.com/etcd-io/website/blob/master/content/docs/v3.4.0/op-guide/configuration.md#--listen-metrics-urls) for details).<br><br>To verify, whether Etcd is configured to allow metric collection, run:<br>`curl -L http://localhost:2379/metrics`<br><br>To check, if Etcd is accessible from Zabbix proxy or Zabbix server run:<br>`curl -L http:%%//<etcd_node_adress>:2379/metrics%%`<br><br>The template should be added to each node with Etcd.| |[GitLab by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/gitlab_http)|**{$GITLAB.PORT}** - the port of GitLab web endpoint (default: 80)<br>**{$GITLAB.URL}** - GitLab instance URL (default: localhost)|This template works with self-hosted GitLab instances; metrics are collected from the `/metrics` endpoint.<br><br>To access the metrics, the client IP address must be explicitly allowed (see [GitLab documentation](https://docs.gitlab.com/ee/administration/monitoring/ip_whitelist.html) for details).<br><br>Note, that certain metrics may not be available for a particular GitLab instance version and configuration.| |[Hadoop by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/hadoop_http/README.md)|**{$HADOOP.NAMENODE.HOST}** - the Hadoop NameNode host IP address or FQDN (default: NameNode).<br>**{$HADOOP.NAMENODE.PORT}** - the Hadoop NameNode web-UI port (default: 9870).<br>**{$HADOOP.RESOURCEMANAGER.HOST}** - the Hadoop ResourceManager host IP address or FQDN (default: ResourceManager).<br>**{$HADOOP.RESOURCEMANAGER.PORT}** - the Hadoop ResourceManager web-UI port (default: 8088).|Metrics are collected by polling the Hadoop API remotely using an HTTP agent and JSONPath preprocessing. Zabbix server (or proxy) executes direct requests to ResourceManager, NodeManagers, NameNode, DataNodes APIs.| |[HAProxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_http/README.md)|**{$HAPROXY.STATS.PATH}** - the path of HAProxy Stats page (default: stats).<br>**{$HAPROXY.STATS.PORT}** - the port of the HAProxy Stats host or container (default: 8404).<br>**{$HAPROXY.STATS.SCHEME}** - the request scheme. Supported: http (default), https.|HAProxy Stats page should be set up (see HAProxy [blog post](https://www.haproxy.com/blog/exploring-the-haproxy-stats-page/) for details or template's Readme.md for configuration example).| |[HashiCorp Vault by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vault_http/README.md)|**{$VAULT.API.PORT}** - the port on which the Vault listens for API requests (default: 8200).<br>**{$VAULT.API.SCHEME}** - the API request scheme. Supported: http (default), https.<br>**{$VAULT.HOST}** - Vault host name (default: <PUT YOUR VAULT HOST>).<br>**{$VAULT.TOKEN}** - Vault authorization token (default: <PUT YOUR AUTH TOKEN>).|1\. Configure the Vault API (see [official documentation](https://www.vaultproject.io/docs/configuration) for details).<br>2. Create a Vault service token, then copy and paste it into {$VAULT.TOKEN} macro value in Zabbix.| |[Hikvision camera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cctv/hikvision/README.md)|**{$HIKVISION\_ISAPI\_PORT}** - ISAPI port on a device (default: 80).<br>**{$USER}**, **{$PASSWORD}** - camera login credentials (default username: admin, password: 1234).|<| |[InfluxDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/influxdb_http/README.md)|**{$INFLUXDB.API.TOKEN}** - InfluxDB API authorization token (default: \`\`).<br>**{$INFLUXDB.URL}** - InfluxDB instance URL in the format `<scheme>://<host>:<port>` (default: http://localhost:8086).|This template collects internal service metrics from the InfluxDB /metrics endpoint of self-hosted InfluxDB instances.<br><br>See InfluxDB [documentation](https://docs.influxdata.com/influxdb/v2.0/security/tokens/) for details.| |[Jenkins by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jenkins/README.md)|**{$JENKINS.API.KEY}** - API key to access Metrics Servlet; required for common metrics (default: \`\`).<br>**{$JENKINS.API.TOKEN}** - API token for HTTP BASIC authentication; required for monitoring computers and builds (default: \`\`).<br>**{$JENKINS.URL}** - Jenkins URL in the format `<scheme>://<host>:<port>`; required for monitoring computers and builds (default: \`\`).<br>**{$JENKINS.USER}** - username for HTTP BASIC authentication; required for monitoring computers and builds (default: zabbix).|Metrics are collected by requests to Metrics API.<br><br>For common metrics: install and configure Metrics plugin parameters according to the [official documentation](https://plugins.jenkins.io/metrics/). Issue an API key for access to the Metrics Servlet, then use it as {$JENKINS.API.KEY} macro value.<br><br>For monitoring computers and builds: create an API token for the Jenkins user that will be used for monitoring, then use it as {$JENKINS.API.TOKEN} macro value. See Jenkins [documentation](https://www.jenkins.io/doc/book/system-administration/authenticating-scripted-clients/) for details.| |[Microsoft SharePoint by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md)|**{$SHAREPOINT.URL}** - portal page URL, for example *http://sharepoint.companyname.local/* (default: \`\`).<br>**{$SHAREPOINT.ROOT}** - a root directory; only the specified directory and all its subfolders will be monitored (default: /Shared Documents)<br>**{$SHAREPOINT.USER}**, **{$SHAREPOINT.PASSWORD}** - SharePoint login credentials (default: not set).|The template contains additional macros, which can be used to filter out certain dictionaries and types during LLD process (see template's [Readme.md](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md) for the description of available filter macros).| |[NetApp AFF A700 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/netapp_aff_a700_http/README.md)|**{$URL}** - AFF700 cluster URL address (default: ' ' )<br>**{$USERNAME}**, **{PASSWORD}** - AFF700 login credentials (default: not set).|Create a host for AFF A700 with cluster management IP as the Zabbix agent interface.| |[NGINX by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_http/README.md)|**{$NGINX.STUB\_STATUS.HOST}** - the hostname or IP address of NGINX stub\_status host or container (default: localhost).<br>**{$NGINX.STUB\_STATUS.PATH}** - the path of NGINX stub\_status page (default: basic\_status).<br>**{$NGINX.STUB\_STATUS.PORT}** - the port of NGINX stub\_status host or container (default: 80).<br>**{$NGINX.STUB\_STATUS.SCHEME}** - the request scheme. Supported: http (default), https.|`'ngx_http_stub_status_module` should be set up (see NGINX [documentation](https://nginx.org/en/docs/http/ngx_http_stub_status_module.html) for details or template's Readme.md for configuration example).<br>To check availability, run:<br>`nginx -V 2>&1 \| grep -o with-http_stub_status_module`| |[NGINX Plus by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_plus_http/README.md)|**{$NGINX.API.ENDPOINT}** - NGINX Plus API URL in the format `<scheme>://<host>:<port>/<location>/` (default: ' ').|1\. Enable NGINX Plus API (see NGINX [documentation](https://www.nginx.com/products/nginx/live-activity-monitoring/) for details).<br>2. Set the macro {$NGINX.API.ENDPOINT}<br>3. If required, use other template macros to filter out discovery operations and discover only required zones and upstreams.| |[PHP-FPM by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md)|**{$PHP\_FPM.HOST}** - a hostname or an IP of PHP-FPM status host or container (default: localhost).<br>**{$PHP\_FPM.PING.PAGE}** - PHP-FPM ping page path (default:ping).<br>**{$PHP\_FPM.PORT}** - the port of PHP-FPM status host or container (default: 80).<br>**{$PHP\_FPM.PROCESS\_NAME}** - PHP-FPM process name (default: php-fpm).<br>**{$PHP\_FPM.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$PHP\_FPM.STATUS.PAGE}** - PHP-FPM status page path (default:`status`).|1\. Open the php-fpm configuration file and enable the status page:<br>`pm.status_path = /status`<br>`ping.path = /ping`<br><br>2. Validate the syntax: `$ php-fpm7 -t`<br><br>3. Reload the php-fpm service.<br><br>4. In the Nginx Server Block (virtual host) configuration file, add (see template's *Readme.md* for an expanded example with comments):<br>`location ~ ^/(status\|ping)$ {`<br>`access_log off;`<br>`fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;`<br>`fastcgi_index index.php;`<br>`include fastcgi_params;`<br>`fastcgi_pass 127.0.0.1:9000;`<br>`}`<br><br>5. Check the syntax: `$ nginx -t`<br><br>6. Reload Nginx<br><br>7. Verify: `curl -L 127.0.0.1/status`| |[RabbitMQ cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_http/README.md)|**{$RABBITMQ.API.CLUSTER\_HOST}** - the hostname or IP address of RabbitMQ cluster API endpoint (default: 127.0.0.1).<br>**{$RABBITMQ.API.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$RABBITMQ.API.USER}**, **{$RABBITMQ.API.PASSWORD}** - RabbitMQ login credentials (default username: zbx\_monitor, password: zabbix).|Enable RabbitMQ management plugin (see [RabbitMQ documentation](https://www.rabbitmq.com/management.html)).<br><br>To create a RabbitMQ user with necessary permissions for monitoring, run:<br>'' rabbitmqctl add\_user zbx\_monitor <PASSWORD> ''<br>`rabbitmqctl set_permissions -p / zbx_monitor %% "" "" ".*"%%`<br>`rabbitmqctl set_user_tags zbx_monitor monitoring`<br><br>If the cluster consists of several nodes, it is recommended to assign the cluster template to a separate balancing host. In case of a single-node installation, the cluster template can be assigned to the host with a node template.| |[TiDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tidb_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 10080)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with TiDB server of PingCAP TiDB cluster.<br>Internal service metrics are collected from TiDB /metrics endpoint and TiDB monitoring API.| |[TiDB PD by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_pd_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 2379)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with PD server of PingCAP TiDB cluster.<br>Internal service metrics are collected from PD /metrics endpoint and TiDB monitoring API.| |[TiDB TiKV by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tikv_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 20180)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with TiKV server of PingCAP TiDB cluster.<br>Internal service metrics are collected from TiKV /metrics endpoint.| |[Travis CI by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/travis_http/README.md)|**{$TRAVIS.API.TOKEN}** - Travis API Token (default: not set)<br>**{$TRAVIS.API.URL}** - Travis API URL (default: api.travis-ci.com).|Travis API authentication token can be found in the *User → Settings → API authentication* section.<br>{$TRAVIS.API.URL} format for a private project is *api.travis-ci.com*.<br>{$TRAVIS.API.URL} format for an enterprise project is *api.example.com* (replace example.com with the domain Travis CI is running on).| |[VMWare SD-WAN VeloCloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md)|**{$VELOCLOUD.TOKEN}** - VMware SD-WAN Orchestrator API Token (default: \`\`).<br>**{$VELOCLOUD.URL}** - VMware SD-WAN Orchestrator URL, for example, *velocloud.net* (default: \`\`).|API token should be created in the VMware SD-WAN Orchestrator (see [VMware documentation](https://docs.vmware.com/en/VMware-SD-WAN/4.0/vmware-sd-wan-operator-guide/GUID-C150D536-A75F-47C1-8AFF-17C417F40C1D.html) for details).| |[ZooKeeper by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zookeeper_http/README.md)|**{$ZOOKEEPER.COMMAND\_URL}** - admin.commandURL; the URL for listing and issuing commands relative to the root URL (default: commands).<br>**{ZOOKEEPER.PORT}** - admin.serverPort; the port the embedded Jetty server listens on (default: 8080).<br>**{$ZOOKEEPER.SCHEME}** - the request scheme. Supported: http (default), https.|Metrics are collected from each ZooKeeper node by requests to AdminServer (enabled by default). See [ZooKeeper documentation](https://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_adminserver_config) to enable or configure AdminServer.|  
ja	# HTTP template operation  Steps to ensure correct operation of templates that collect metrics with [HTTP agent](/manual/config/items/itemtypes/http):  1\. Create a host in Zabbix and specify an IP address or DNS name of the monitoring target as the main interface. This is needed for the {HOST.CONN} macro to resolve properly in the template items.\ 2. [Link](/manual/config/templates/linking#linking_a_template) the template to the host created in step 1 (if the template is not available in your Zabbix installation, you may need to import the template's .xml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions).\ 3. Adjust the values of mandatory macros as needed.\ 4. Configure the instance being monitored to allow sharing data with Zabbix - see instructions in the *Additional steps/comments* column.  ::: notetip  This page contains only a minimum set of macros and setup steps that are required for proper template operation. A detailed description of a template, including the full list of macros, items and triggers, is available in the template's Readme.md file (accessible by clicking on a template name).  :::  |Template|Mandatory macros|Additional steps/comments| |--------|----------------|-------------------------| |[Apache by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_http)|**{$APACHE.STATUS.HOST}** - the hostname or IP address of Apache status page (default: 127.0.0.1).<br>**{$APACHE.STATUS.PATH}** - the URL path (default: server-status?auto).<br>**{$APACHE.STATUS.PORT}** - the port of Apache status page (default: 80).<br>**{$APACHE.STATUS.SCHEME}** - the request scheme. Supported: http (default), https.|Apache module mod\_status should be set (see Apache [documentation](https://httpd.apache.org/docs/current/mod/mod_status.html) for details).<br>To check availability, run:<br>`httpd -M 2>/dev/null \| grep status_module`<br><br>Apache configuration example:<br>`<Location "/server-status">`<br>`SetHandler server-status`<br>`Require host example.com`<br>`</Location>`| |[Asterisk by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/tel/asterisk_http)|**{$AMI.PORT}** - AMI port number for checking service availability (default: 8088).<br>**{$AMI.SECRET}** - the Asterisk Manager secret (default: zabbix).<br>**{$AMI.URL}** - the Asterisk Manager API URL in the format<br>`<scheme>://<host>:<port>/<prefix>/rawman`<br>(default: http://asterisk:8088/asterisk/rawman).<br>**{$AMI.USERNAME}** - the Asterisk Manager name.|1\. Enable the [mini-HTTP Server](https://wiki.asterisk.org/wiki/display/AST/Asterisk+Builtin+mini-HTTP+Server).<br><br>2. Add the option `webenabled=yes` to the general section of *manager.conf* file.<br><br>3. Create *Asterisk Manager* user in the Asterisk instance.| |[ClickHouse by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/clickhouse_http/README.md)|**{$CLICKHOUSE.PORT}** - the port of ClickHouse HTTP endpoint (default: 8123).<br>**{$CLICKHOUSE.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$CLICKHOUSE.USER}**, **{$CLICKHOUSE.PASSWORD}** - ClickHouse login credentials (default username: zabbix, password: zabbix\_pass).<br>If you don't need authentication, remove headers from HTTP agent type items.|Create a ClickHouse user with a 'web' profile and permission to view databases (see ClickHouse [documentation](https://clickhouse.tech/docs/en/operations/settings/settings-users/) for details).<br><br>See template's *Readme.md* file for a ready-to-use zabbix.xml file configuration.| |[Cloudflare by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/cloudflare_http/README.md)|**{$CLOUDFLARE.API.TOKEN}** - Cloudflare API token value (default: \`<change>\`).<br>**{$CLOUDFLARE.ZONE\_ID}** - Cloudflare Site Zone ID (default: \`<change>\`).|Cloudflare API Tokens are available in the Cloudflare account under *My Profile→ API Tokens*.<br>Zone ID is available in the Cloudflare account under *Account Home → Site*.| |[DELL PowerEdge R720 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r720_http/README.md),<br>[DELL PowerEdge R740 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r740_http/README.md),<br>[DELL PowerEdge R820 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r820_http/README.md),<br>[DELL PowerEdge R840 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r840_http/README.md)|**{$API.URL}** - Dell iDRAC Redfish API URL in the format `<scheme>://<host>:<port>` (default: <Put your URL here>)<br>**{$API.USER}**, **{$API.PASSWORD}** - Dell iDRAC login credentials (default: not set).|In the Dell iDRAC interface of your server:<br>1. Enable Redfish API .<br>2. Create a user for monitoring with read-only permissions.| |[Elasticsearch Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/elasticsearch_http/README.md)|**{$ELASTICSEARCH.PORT}** - the port of the Elasticsearch host (default: 9200).<br>**{$ELASTICSEARCH.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$ELASTICSEARCH.USERNAME}**, **{$ELASTICSEARCH.PASSWORD}** - login credentials, required only if used for Elasticsearch authentication.|<| |[Etcd by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/etcd_http/README.md)|**{$ETCD.PORT}**- the port used by Etcd API endpoint (default: 2379).<br>**{$ETCD.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$ETCD.USER}**, **{$ETCD.PASSWORD}** - login credentials, required only if used for Etcd authentication.|Metrics are collected from /metrics endpoint; to specify the endpoint's location use `--listen-metrics-urls` flag (see Etcd [documentation](https://github.com/etcd-io/website/blob/master/content/docs/v3.4.0/op-guide/configuration.md#--listen-metrics-urls) for details).<br><br>To verify, whether Etcd is configured to allow metric collection, run:<br>`curl -L http://localhost:2379/metrics`<br><br>To check, if Etcd is accessible from Zabbix proxy or Zabbix server run:<br>`curl -L http:%%//<etcd_node_adress>:2379/metrics%%`<br><br>The template should be added to each node with Etcd.| |[GitLab by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/gitlab_http)|**{$GITLAB.PORT}** - the port of GitLab web endpoint (default: 80)<br>**{$GITLAB.URL}** - GitLab instance URL (default: localhost)|This template works with self-hosted GitLab instances; metrics are collected from the `/metrics` endpoint.<br><br>To access the metrics, the client IP address must be explicitly allowed (see [GitLab documentation](https://docs.gitlab.com/ee/administration/monitoring/ip_whitelist.html) for details).<br><br>Note, that certain metrics may not be available for a particular GitLab instance version and configuration.| |[Hadoop by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/hadoop_http/README.md)|**{$HADOOP.NAMENODE.HOST}** - the Hadoop NameNode host IP address or FQDN (default: NameNode).<br>**{$HADOOP.NAMENODE.PORT}** - the Hadoop NameNode web-UI port (default: 9870).<br>**{$HADOOP.RESOURCEMANAGER.HOST}** - the Hadoop ResourceManager host IP address or FQDN (default: ResourceManager).<br>**{$HADOOP.RESOURCEMANAGER.PORT}** - the Hadoop ResourceManager web-UI port (default: 8088).|Metrics are collected by polling the Hadoop API remotely using an HTTP agent and JSONPath preprocessing. Zabbix server (or proxy) executes direct requests to ResourceManager, NodeManagers, NameNode, DataNodes APIs.| |[HAProxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_http/README.md)|**{$HAPROXY.STATS.PATH}** - the path of HAProxy Stats page (default: stats).<br>**{$HAPROXY.STATS.PORT}** - the port of the HAProxy Stats host or container (default: 8404).<br>**{$HAPROXY.STATS.SCHEME}** - the request scheme. Supported: http (default), https.|HAProxy Stats page should be set up (see HAProxy [blog post](https://www.haproxy.com/blog/exploring-the-haproxy-stats-page/) for details or template's Readme.md for configuration example).| |[HashiCorp Vault by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vault_http/README.md)|**{$VAULT.API.PORT}** - the port on which the Vault listens for API requests (default: 8200).<br>**{$VAULT.API.SCHEME}** - the API request scheme. Supported: http (default), https.<br>**{$VAULT.HOST}** - Vault host name (default: <PUT YOUR VAULT HOST>).<br>**{$VAULT.TOKEN}** - Vault authorization token (default: <PUT YOUR AUTH TOKEN>).|1\. Configure the Vault API (see [official documentation](https://www.vaultproject.io/docs/configuration) for details).<br>2. Create a Vault service token, then copy and paste it into {$VAULT.TOKEN} macro value in Zabbix.| |[Hikvision camera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cctv/hikvision/README.md)|**{$HIKVISION\_ISAPI\_PORT}** - ISAPI port on a device (default: 80).<br>**{$USER}**, **{$PASSWORD}** - camera login credentials (default username: admin, password: 1234).|<| |[InfluxDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/influxdb_http/README.md)|**{$INFLUXDB.API.TOKEN}** - InfluxDB API authorization token (default: \`\`).<br>**{$INFLUXDB.URL}** - InfluxDB instance URL in the format `<scheme>://<host>:<port>` (default: http://localhost:8086).|This template collects internal service metrics from the InfluxDB /metrics endpoint of self-hosted InfluxDB instances.<br><br>See InfluxDB [documentation](https://docs.influxdata.com/influxdb/v2.0/security/tokens/) for details.| |[Jenkins by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jenkins/README.md)|**{$JENKINS.API.KEY}** - API key to access Metrics Servlet; required for common metrics (default: \`\`).<br>**{$JENKINS.API.TOKEN}** - API token for HTTP BASIC authentication; required for monitoring computers and builds (default: \`\`).<br>**{$JENKINS.URL}** - Jenkins URL in the format `<scheme>://<host>:<port>`; required for monitoring computers and builds (default: \`\`).<br>**{$JENKINS.USER}** - username for HTTP BASIC authentication; required for monitoring computers and builds (default: zabbix).|Metrics are collected by requests to Metrics API.<br><br>For common metrics: install and configure Metrics plugin parameters according to the [official documentation](https://plugins.jenkins.io/metrics/). Issue an API key for access to the Metrics Servlet, then use it as {$JENKINS.API.KEY} macro value.<br><br>For monitoring computers and builds: create an API token for the Jenkins user that will be used for monitoring, then use it as {$JENKINS.API.TOKEN} macro value. See Jenkins [documentation](https://www.jenkins.io/doc/book/system-administration/authenticating-scripted-clients/) for details.| |[Microsoft SharePoint by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md)|**{$SHAREPOINT.URL}** - portal page URL, for example *http://sharepoint.companyname.local/* (default: \`\`).<br>**{$SHAREPOINT.ROOT}** - a root directory; only the specified directory and all its subfolders will be monitored (default: /Shared Documents)<br>**{$SHAREPOINT.USER}**, **{$SHAREPOINT.PASSWORD}** - SharePoint login credentials (default: not set).|The template contains additional macros, which can be used to filter out certain dictionaries and types during LLD process (see template's [Readme.md](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md) for the description of available filter macros).| |[NetApp AFF A700 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/netapp_aff_a700_http/README.md)|**{$URL}** - AFF700 cluster URL address (default: ' ' )<br>**{$USERNAME}**, **{PASSWORD}** - AFF700 login credentials (default: not set).|Create a host for AFF A700 with cluster management IP as the Zabbix agent interface.| |[NGINX by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_http/README.md)|**{$NGINX.STUB\_STATUS.HOST}** - the hostname or IP address of NGINX stub\_status host or container (default: localhost).<br>**{$NGINX.STUB\_STATUS.PATH}** - the path of NGINX stub\_status page (default: basic\_status).<br>**{$NGINX.STUB\_STATUS.PORT}** - the port of NGINX stub\_status host or container (default: 80).<br>**{$NGINX.STUB\_STATUS.SCHEME}** - the request scheme. Supported: http (default), https.|`'ngx_http_stub_status_module` should be set up (see NGINX [documentation](https://nginx.org/en/docs/http/ngx_http_stub_status_module.html) for details or template's Readme.md for configuration example).<br>To check availability, run:<br>`nginx -V 2>&1 \| grep -o with-http_stub_status_module`| |[NGINX Plus by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_plus_http/README.md)|**{$NGINX.API.ENDPOINT}** - NGINX Plus API URL in the format `<scheme>://<host>:<port>/<location>/` (default: ' ').|1\. Enable NGINX Plus API (see NGINX [documentation](https://www.nginx.com/products/nginx/live-activity-monitoring/) for details).<br>2. Set the macro {$NGINX.API.ENDPOINT}<br>3. If required, use other template macros to filter out discovery operations and discover only required zones and upstreams.| |[PHP-FPM by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md)|**{$PHP\_FPM.HOST}** - a hostname or an IP of PHP-FPM status host or container (default: localhost).<br>**{$PHP\_FPM.PING.PAGE}** - PHP-FPM ping page path (default:ping).<br>**{$PHP\_FPM.PORT}** - the port of PHP-FPM status host or container (default: 80).<br>**{$PHP\_FPM.PROCESS\_NAME}** - PHP-FPM process name (default: php-fpm).<br>**{$PHP\_FPM.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$PHP\_FPM.STATUS.PAGE}** - PHP-FPM status page path (default:`status`).|1\. Open the php-fpm configuration file and enable the status page:<br>`pm.status_path = /status`<br>`ping.path = /ping`<br><br>2. Validate the syntax: `$ php-fpm7 -t`<br><br>3. Reload the php-fpm service.<br><br>4. In the Nginx Server Block (virtual host) configuration file, add (see template's *Readme.md* for an expanded example with comments):<br>`location ~ ^/(status\|ping)$ {`<br>`access_log off;`<br>`fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;`<br>`fastcgi_index index.php;`<br>`include fastcgi_params;`<br>`fastcgi_pass 127.0.0.1:9000;`<br>`}`<br><br>5. Check the syntax: `$ nginx -t`<br><br>6. Reload Nginx<br><br>7. Verify: `curl -L 127.0.0.1/status`| |[RabbitMQ cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_http/README.md)|**{$RABBITMQ.API.CLUSTER\_HOST}** - the hostname or IP address of RabbitMQ cluster API endpoint (default: 127.0.0.1).<br>**{$RABBITMQ.API.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$RABBITMQ.API.USER}**, **{$RABBITMQ.API.PASSWORD}** - RabbitMQ login credentials (default username: zbx\_monitor, password: zabbix).|Enable RabbitMQ management plugin (see [RabbitMQ documentation](https://www.rabbitmq.com/management.html)).<br><br>To create a RabbitMQ user with necessary permissions for monitoring, run:<br>'' rabbitmqctl add\_user zbx\_monitor <PASSWORD> ''<br>`rabbitmqctl set_permissions -p / zbx_monitor %% "" "" ".*"%%`<br>`rabbitmqctl set_user_tags zbx_monitor monitoring`<br><br>If the cluster consists of several nodes, it is recommended to assign the cluster template to a separate balancing host. In case of a single-node installation, the cluster template can be assigned to the host with a node template.| |[TiDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tidb_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 10080)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with TiDB server of PingCAP TiDB cluster.<br>Internal service metrics are collected from TiDB /metrics endpoint and TiDB monitoring API.| |[TiDB PD by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_pd_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 2379)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with PD server of PingCAP TiDB cluster.<br>Internal service metrics are collected from PD /metrics endpoint and TiDB monitoring API.| |[TiDB TiKV by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tikv_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 20180)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with TiKV server of PingCAP TiDB cluster.<br>Internal service metrics are collected from TiKV /metrics endpoint.| |[Travis CI by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/travis_http/README.md)|**{$TRAVIS.API.TOKEN}** - Travis API Token (default: not set)<br>**{$TRAVIS.API.URL}** - Travis API URL (default: api.travis-ci.com).|Travis API authentication token can be found in the *User → Settings → API authentication* section.<br>{$TRAVIS.API.URL} format for a private project is *api.travis-ci.com*.<br>{$TRAVIS.API.URL} format for an enterprise project is *api.example.com* (replace example.com with the domain Travis CI is running on).| |[VMWare SD-WAN VeloCloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md)|**{$VELOCLOUD.TOKEN}** - VMware SD-WAN Orchestrator API Token (default: \`\`).<br>**{$VELOCLOUD.URL}** - VMware SD-WAN Orchestrator URL, for example, *velocloud.net* (default: \`\`).|API token should be created in the VMware SD-WAN Orchestrator (see [VMware documentation](https://docs.vmware.com/en/VMware-SD-WAN/4.0/vmware-sd-wan-operator-guide/GUID-C150D536-A75F-47C1-8AFF-17C417F40C1D.html) for details).| |[ZooKeeper by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zookeeper_http/README.md)|**{$ZOOKEEPER.COMMAND\_URL}** - admin.commandURL; the URL for listing and issuing commands relative to the root URL (default: commands).<br>**{ZOOKEEPER.PORT}** - admin.serverPort; the port the embedded Jetty server listens on (default: 8080).<br>**{$ZOOKEEPER.SCHEME}** - the request scheme. Supported: http (default), https.|Metrics are collected from each ZooKeeper node by requests to AdminServer (enabled by default). See [ZooKeeper documentation](https://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_adminserver_config) to enable or configure AdminServer.|  

en-us	#### httptest  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `httptest.update`: the parameter `uuid` can now be updated.\
ja	#### httptest  変更点:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `httptest.update`: パラメーター `uuid` が更新できるようになりました。\

en-us	# httptest.create
ja	# httptest.create

en-us	# httptest.delete
ja	# httptest.delete

en-us	# httptest.get
ja	# httptest.get

en-us	# httptest.update
ja	# httptest.update

en-us	#### Hysteresis  Sometimes an interval is needed between problem and recovery states, rather than a simple threshold. For example, if we want to define a trigger that reports a problem when server room temperature goes above 20°C and we want it to stay in the problem state until the temperature drops below 15°C, a simple trigger threshold at 20°C will not be enough.  Instead, we need to define a trigger expression for the problem event first (temperature above 20°C). Then we need to define an additional recovery condition (temperature below 15°C). This is done by defining an additional *Recovery expression* parameter when [defining](/manual/config/triggers/trigger) a trigger.  In this case, problem recovery will take place in two steps:  -   First, the problem expression (temperature above 20°C) will have to     evaluate to FALSE -   Second, the recovery expression (temperature below 15°C) will have     to evaluate to TRUE  The recovery expression will be evaluated only when the problem event is resolved first.  ::: notewarning The recovery expression being TRUE alone does not resolve a problem if the problem expression is still TRUE! :::
ja	#### ヒステリシス(Hysteresis)  問題状態と回復状態の間に単純な閾値ではなく、インターバルが必要な場合があります。<br> 例えば、サーバルームの温度が20℃以上になったときに問題を報告する trigger を定義し、温度が15℃以下に下がるまで<br> 問題状態を維持したい場合、20℃の単純な trigger 閾値では十分ではありません。<br>  その代わりに、最初に問題が発生した問題事象（温度が20℃以上）に対する trigger 式を定義する必要があります。<br> 次に、回復条件（温度15℃以下）を追加で定義する必要があります。<br> これは、次のように定義することで行われます。*Recovery expression* パラメータを定義し、[defining](/manual/config/triggers/trigger) trigger<br>を定義します。  この場合、問題の回復は2つのステップで行われます。  - まず、問題式(20℃以上の温度)は、"FALSE" に評価されなければなりません。 - 次に、リカバリー式(温度15℃以下)を "TRUE" に評価します。  回復式は、問題事象が先に解決された場合にのみ評価されます。  ::: notewarning リカバリー式が "TRUE" であることだけでは、問題式がまだ "TRUE" である場合に問題を解決することができません！ :::

en-us	#### ICMP pings  Zabbix uses external utility **fping** for processing of ICMP pings.  The utility is not part of Zabbix distribution and has to be additionally installed. If the utility is missing, has wrong permissions or its location does not match the location set in the Zabbix server/proxy configuration file ('FpingLocation' parameter), ICMP pings (**icmpping**, **icmppingloss**, **icmppingsec**) will not be processed.  See also: [known issues](/manual/installation/known_issues#simple_checks)  **fping** must be executable by the user Zabbix daemons run as and setuid root. Run these commands as user **root** in order to set up correct permissions:      chown root:zabbix /usr/sbin/fping     chmod 4710 /usr/sbin/fping  After performing the two commands above check ownership of the **fping** executable. In some cases the ownership can be reset by executing the chmod command.  Also check, if user zabbix belongs to group zabbix by running:      groups zabbix  and if it's not add by issuing:      usermod -a -G zabbix zabbix  Defaults, limits and description of values for ICMP check parameters:  |Parameter|Unit|Description|Fping's flag|Defaults set by|<|Allowed limits<br>by Zabbix|<| |--|--|--------|-|--|--|--|--| |||||**fping**|**Zabbix**|**min**|**max**| |packets|number|number of request packets to a target|-C||3|1|10000| |interval|milliseconds|time to wait between successive packets|-p|1000||20|unlimited| |size|bytes|packet size in bytes<br>56 bytes on x86, 68 bytes on x86_64|-b|56 or 68||24|65507| |timeout|milliseconds|**fping v3.x** - timeout to wait after last packet sent, affected by *-C* flag<br> **fping v4.x** - individual timeout for each packet|-t|**fping v3.x** - 500<br>**fping v4.x** - inherited from *-p* flag, but not more than 2000||50|unlimited|  In addition Zabbix uses fping options *-i interval ms* (do not mix up with the item parameter *interval* mentioned in the table above, which corresponds to fping option *-p*) and *-S source IP address* (or *-I* in older fping versions). Those options are auto-detected by running checks with different option combinations. Zabbix tries to detect the minimal value in milliseconds that fping allows to use with *-i* by trying 3 values: 0, 1 and 10. The value that first succeeds is then used for subsequent ICMP checks. This process is done by each [ICMP pinger](/manual/concepts/server#server_process_types) process individually.  Auto-detected fping options are invalidated every hour and detected again on the next attempt to perform ICMP check. Set DebugLevel>=4 in order to view details of this process in the server or proxy log file.  ::: notewarning Warning: fping defaults can differ depending on platform and version - if in doubt, check fping documentation. :::  Zabbix writes IP addresses to be checked by any of three *icmpping\** keys to a temporary file, which is then passed to **fping**. If items have different key parameters, only ones with identical key parameters are written to a single file.\ All IP addresses written to the single file will be checked by fping in parallel, so Zabbix icmp pinger process will spend fixed amount of time disregarding the number of IP addresses in the file.
ja	#### ICMP ping  ZabbixはICMP pingの処理に外部ユーティリティ**fping**を使用しています。  このユーティリティはZabbixの配布物には含まれていないため、追加でインストールする必要があります。<br> ユーティリティがない場合、パーミッションが正しくない場合、またはユーティリティの場所が<br> Zabbix server / proxy 設定ファイル('FpingLocation'パラメータ)で設定した場所と一致しない場合、 ICMP Ping(**icmpping**, **icmppingloss**, **icmppingsec**) は処理されません。  [既知の問題](/manual/installation/known_issues#シンプルチェック) もあわせて参照してください。  **fping**は、Zabbix daemon が実行されるユーザで実行可能である必要があります。setuid root で実行する必要があります。<br> 正しいパーミッションを設定するために、ユーザ**root**として以下のコマンドを実行してください。<br>      shell> chown root:zabbix /usr/sbin/fping     shell> chmod 4710 /usr/sbin/fping  上記 2 つのコマンドを実行した後、**fping** 実行ファイルの所有権を確認します。 場合によっては、chmod コマンドを実行することで、所有権をリセットできる場合があります。  また、ユーザ zabbix がグループ zabbix に属しているかどうかも確認してください。      shell> groups zabbix  zabbix グループに追加されていない場合は、以下を実行してください。      shell> usermod -a -G zabbix zabbix  ICMPチェックパラメータのデフォルト値、制限値の説明:  |パラメータ|単位|説明|Fpingのflag|デフォルト値|<|制限値 <br>by Zabbix|<| |--|--|--------|-|--|--|--|--| |||||**fping**|**Zabbix**|**min**|**max**| |packets|number|number of request packets to a target|-C||3|1|10000| |interval|milliseconds|time to wait between successive packets|-p|1000||20|unlimited| |size|bytes|packet size in bytes<br>56 bytes on x86, 68 bytes on x86_64|-b|56 or 68||24|65507| |timeout|milliseconds|**fping v3.x** - timeout to wait after last packet sent, affected by *-C* flag<br> **fping v4.x** - individual timeout for each packet|-t|**fping v3.x** - 500<br>**fping v4.x** - inherited from *-p* flag, but not more than 2000||50|unlimited|  さらに、Zabbix は fping オプションとして、*-i interval ms* (上表の item パラメータ *interval* と混同しないように注意してください) と*-S source IP address*(旧fpingバージョンでは*-I*)を使用します。これらのオプションは、異なるオプションの組み合わせでチェックを実行することで、自動的に検出されます。Zabbixは、fping が *-i* で使用できる最小値をミリ秒単位で検出するため、0、1、10の3つの値を試します。最初に成功した値がその後のICMPチェックに使われます。この処理は、各[ICMP pinger](/manual/concepts/server#サーバープロセスの種類)プロセスが個別に行います。  自動検出された fping オプションは、1時間ごとに無効化され、次回のICMP検査時に再度検出されます。このプロセスの詳細を表示するには、DebugLevel>=4 に設定します。server またはproxy のログファイルにこのプロセスの詳細が表示されます。  ::: notewarning 警告: fping のデフォルトは、プラットフォームとバージョンによって異なる場合があります。fping のドキュメントを確認してください。 :::  Zabbixは、3つの**icmpping**キーでチェックするIPアドレスを一時ファイルに書き込み、このファイルを**fping**に渡します。item キーパラメータが異なる項目は、キーパラメータが同一のもののみ1つのファイルに書き込まれます。1つのファイルに書き込まれた全てのIPアドレスを並列にfpingでチェックするため、Zabbixのicmpピンガープロセスはファイル内のIPアドレスの数に関係なく、一定の時間を費やします。

en-us	##### Icon highlighting  If a map element is in problem status, it is highlighted with a round circle. The fill color of the circle corresponds to the severity color of the problem. Only problems on or above the selected severity level will be displayed with the element. If all problems are acknowledged, a thick green border around the circle is displayed.  Additionally:  -   a host in [maintenance](/manual/maintenance) is highlighted with an     orange, filled square. Note that maintenance highlighting has     priority over the problem severity highlighting (since Zabbix 6.0.5,      only if the map element is host). -   a disabled (not-monitored) host is highlighted with a gray, filled     square.  Highlighting is displayed if the *Icon highlighting* check-box is marked in map [configuration](/manual/config/visualization/maps/map#creating_a_map).
ja	##### アイコンの強調表示  マップ要素に障害がある場合、丸い円で強調表示されます。 円の塗りつぶしの色は、問題の深刻度の色に対応しています。 選択した深刻度レベル以上の問題のみが要素とともに表示されます。 すべての障害が確認されると、円の周りに太い緑色の境界線が表示されます。  さらに：  -   [メンテナンス](/manual/maintenance)のホストは、オレンジ色の塗りつぶされた四角で強調表示されます。 メンテナンスの強調表示は、問題の深刻度の強調表示よりも優先されることに注意してください（Zabbix 6.0.5以降、マップ要素がホストの場合のみ） -   無効になっている（監視されていない）ホストは、灰色の塗りつぶされた四角で強調表示されます。  マップ[設定](/manual/config/visualization/maps/map#creating_a_map)で*アイコンの強調表示*チェックボックスがマークされている場合、強調表示されます。

en-us	#### iconmap  Changes:\ [ZBXNEXT-6914](https://support.zabbix.com/browse/ZBXNEXT-6914) `iconmap.create`, `iconmap.update`: dropped support of the icon mapping object property `sortorder`.\
ja	#### アイコンマップ  変更点:\ [ZBXNEXT-6914](https://support.zabbix.com/browse/ZBXNEXT-6914) `iconmap.create`, `iconmap.update`: iconmapオブジェクトのプロパティ `sortorder`のサポートを終了しました。\

en-us	# iconmap.create
ja	# iconmap.create

en-us	# iconmap.delete
ja	# iconmap.delete

en-us	# iconmap.get
ja	# iconmap.get

en-us	# > Icon map object  The following objects are directly related to the `iconmap` API.
ja	# > Icon mapオブジェクト  次のオブジェクトは、`iconmap`APIに直接関連しています。

en-us	### Icon mapping  The icon mapping object defines a specific icon to be used for hosts with a certain inventory field value. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmappingid|string|*(readonly)* ID of the icon map.| |**iconid**<br>(required)|string|ID of the icon used by the icon mapping.| |**expression**<br>(required)|string|Expression to match the inventory field against.| |**inventory\_link**<br>(required)|integer|ID of the host inventory field.<br><br>Refer to the [host inventory object](/manual/api/reference/host/object#host_inventory) for a list of supported inventory fields.| |iconmapid|string|*(readonly)* ID of the icon map that the icon mapping belongs to.| |sortorder|integer|*(readonly)* Position of the icon mapping in the icon map.|
ja	### Icon mapping  アイコンマッピングオブジェクトは、特定のインベントリフィールド値を持つホストに使用される特定のアイコンを定義します。 以下のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |iconmappingid|string|*（読み取り専用）*アイコンマップのID| |**iconid**<br>(必須)|string|アイコンマッピングで使用されるアイコンのID| |**expression**<br>(必須)|string|インベントリフィールド照合式| |**inventory\_link**<br>(必須)|integer|ホストインベントリフィールドのID<br><br>サポートされているインベントリフィールドのリストについては、[ホストインベントリオブジェクト](/manual/api/reference/host/object#host_inventory)を参照してください。 |iconmapid|string|*(必須)* アイコンマッピングが属するアイコンマップのID| |sortorder|integer|*(必須)* アイコンマップ内のアイコンマッピングの位置|

en-us	#### - Icon mapping  This section allows creating the mapping of certain hosts with certain icons. Host inventory field information is used to create the mapping.  The mappings can then be used in [network map configuration](/manual/config/ visualization/maps/map) to assign appropriate icons to matching hosts automatically.  To create a new icon map, click on *Create icon map* in the top right corner.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_icon_map.png){width="600"}  Configuration parameters:  |Parameter|Description| |---------|-----------| |*Name*|Unique name of icon map.| |*Mappings*|A list of mappings. The order of mappings determines which one will have priority. You can move mappings up and down the list with drag-and-drop.| |*Inventory field*|Host inventory field that will be looked into to seek a match.| |*Expression*|Regular expression describing the match.| |*Icon*|Icon to use if a match for the expression is found.| |*Default*|Default icon to use.|
ja	#### - アイコンのマッピング  このセクションでは、特定のアイコンを使用してホストのマッピングを作成できます。ホストインベントリフィールド情報は、マッピングの作成に使用されます。  マッピングを[ネットワークマップ設定](/manual/config/ visualization/maps/map)に使用して、一致するホストに適切なアイコンを自動的に割り当てることもできます。  新しいアイコンマップを作成するには、右上隅にある*アイコンのマッピング作成*をクリックします。  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_icon_map.png){width="600"}  設定値  |パラメータ|詳細| |---------|-----------| |*名前*|一意なアイコンマップ名| |*マッピング*|マッピングのリスト。順序によってどちらが優先されるかが決まります。ドラッグアンドドロップでマッピングをリストの上下に移動できます。| |*インベントリフィールド*|一致するものを探すために検索されるホストインベントリフィールド| |*条件式*|一致する正規表現| |*アイコン*|式に一致するものが見つかった場合に使用するアイコン| |*標準*|デフォルトで使われるアイコン|

en-us	# Icon map  This class is designed to work with icon maps.  Object references:\  -   [Icon map](/manual/api/reference/iconmap/object#icon_map) -   [Icon mapping](/manual/api/reference/iconmap/object#icon_mapping)  Available methods:\  -   [iconmap.create](/manual/api/reference/iconmap/create) - create new     icon maps -   [iconmap.delete](/manual/api/reference/iconmap/delete) - delete icon     maps -   [iconmap.get](/manual/api/reference/iconmap/get) - retrieve icon     maps -   [iconmap.update](/manual/api/reference/iconmap/update) - update icon     maps
ja	# Icon map  このクラスは、アイコンマップを操作するためのものです。  オブジェクトリファレンス :\  -   [Icon map](/manual/api/reference/iconmap/object#icon_map) -   [Icon mapping](/manual/api/reference/iconmap/object#icon_mapping)  利用可能なメソッド :\  -   [iconmap.create](/manual/api/reference/iconmap/create) - 新しいアイコンマップを作成する -   [iconmap.delete](/manual/api/reference/iconmap/delete) - アイコンマップを削除する -   [iconmap.get](/manual/api/reference/iconmap/get) - アイコンマップを取得する -   [iconmap.update](/manual/api/reference/iconmap/update) - アイコンマップを更新する

en-us	# iconmap.update
ja	# iconmap.update

en-us	If access rights to persistent storage files are removed during agent operation or other errors occur (e.g. disk full) then errors are logged into the agent log file but the log item does not become NOTSUPPORTED.
ja	agent 操作中に永続的ストレージファイルへのアクセス権が削除されたり、他のエラー(例：ディスクフル)が発生した場合、 エラーは agent ログファイルに記録されますが、ログ item がNOTSUPPORTEDになることはありません。

en-us	##### If installed as package  Zabbix agent runs as a daemon process. The agent can be started by executing:      service zabbix-agent start  This will work on most of GNU/Linux systems. On other systems you may need to run:      /etc/init.d/zabbix-agent start  Similarly, for stopping/restarting/viewing status of Zabbix agent, use the following commands:      service zabbix-agent stop     service zabbix-agent restart     service zabbix-agent status
ja	##### パッケージでインストールした場合  Zabbixエージェントは、デーモンプロセスとして実行されます。エージェントは以下のように実行して起動します：      shell> service zabbix-agent start  これは、ほとんどのGNU/Linuxで動きます。他のシステムでは、以下のように実行します：      shell> /etc/init.d/zabbix-agent start  同様に、Zabbixエージェントを停止、再起動、状態表示するためには、以下のコマンドを使用します：      shell> service zabbix-agent stop     shell> service zabbix-agent restart     shell> service zabbix-agent status

en-us	##### If installed as package  Zabbix proxy runs as a daemon process. The proxy can be started by executing:      service zabbix-proxy start  This will work on most of GNU/Linux systems. On other systems you may need to run:      /etc/init.d/zabbix-proxy start  Similarly, for stopping/restarting/viewing status of Zabbix proxy, use the following commands:      service zabbix-proxy stop     service zabbix-proxy restart     service zabbix-proxy status
ja	##### パッケージインストールされている場合  Zabbixプロキシはデーモンプロセスとして実行されます。プロキシは以下を実行することで開始できます。      shell> service zabbix-proxy start  これはほとんどのGNU/Linuxシステムで機能します。他のシステムでは以下の場合もあります。      shell> /etc/init.d/zabbix-proxy start  同様にZabbixプロキシのステータスを停止/再開/表示するには、次のコマンドを使用します。      shell> service zabbix-proxy stop     shell> service zabbix-proxy restart     shell> service zabbix-proxy status

en-us	##### If installed as package  Zabbix server runs as a daemon process. The server can be started by executing:      service zabbix-server start  This will work on most of GNU/Linux systems. On other systems you may need to run:      /etc/init.d/zabbix-server start  Similarly, for stopping/restarting/viewing status, use the following commands:      service zabbix-server stop     service zabbix-server restart     service zabbix-server status
ja	##### パッケージを使用してインストールした場合  Zabbixサーバーは、デーモンプロセスとして起動されます。サーバーの起動には以下のように実行します：      shell> service zabbix-server start  これは、ほとんどのGNU/Linuxシステムで動きます。他のシステムでは、以下のように実行する必要があるかもしれません：      shell> /etc/init.d/zabbix-server start  同様に、停止、再起動、ステータス表示には以下のように実行します：      shell> service zabbix-server stop     shell> service zabbix-server restart     shell> service zabbix-server status

en-us	##### If the webhook test fails  -   *"Media type test failed."* message is displayed, followed by     additional failure details.
ja	##### Webhook テストが失敗した場合  -   *"Media type test failed. "* というメッセージが表示され、その後に失敗の詳細が表示されます。

en-us	##### If the webhook test is successful  -   *"Media type test successful."* message is displayed -   Server response appears in the gray *Response* field -   Response type (JSON or String) is specified below the *Response*     field
ja	##### Webhookテストが成功した場合  -   *"Media type test successful. "* のメッセージが表示されます。 -   灰色の *Response* フィールドにサーバーの応答が表示されます。 -   レスポンスの種類（JSONまたはString）は、*Response* フィールドの下に表示されます。

en-us	# image.create
ja	# image.create

en-us	# image.delete
ja	# image.delete

en-us	# image.get
ja	# image.get

en-us	# > Image object  The following objects are directly related to the `image` API.
ja	# > Imageオブジェクト  次のオブジェクトは、`image`APIに直接関連しています。

en-us	#### - Images  The Images section displays all the images available in Zabbix. Images are stored in the database.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_images.png){width="600"}  The *Type* dropdown allows you to switch between icon and background images:  -   Icons are used to display [network     map](/manual/config/visualization/maps/map) elements -   Backgrounds are used as background images of network maps  **Adding image**  You can add your own image by clicking on the *Create icon* or *Create background* button in the top right corner.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_img_upload.png)  Image attributes:  |Parameter|Description| |---------|-----------| |*Name*|Unique name of an image.| |*Upload*|Select the file (PNG, JPEG, GIF) from a local system to be uploaded to Zabbix.<br>*Note* that it may be possible to upload other formats that will be converted to PNG during upload. GD library is used for image processing, therefore formats that are supported depend on the library version used (2.0.28 or higher is required by Zabbix).|  ::: noteclassic Maximum size of the upload file is limited by the value of ZBX\_MAX\_IMAGE\_SIZE that is 1024x1024 bytes or 1 MB.\ \ The upload of an image may fail if the image size is close to 1 MB and the `max_allowed_packet` MySQL configuration parameter is at a default of 1MB. In this case, increase the [max\_allowed\_packet](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet) parameter. :::
ja	#### - イメージ  イメージセクションには、Zabbixで利用可能なすべての画像が表示されます。画像はデータベースに保存されます。  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_images.png){width="600"}  *タイプ*ドロップダウンを使用すると、アイコンと背景画像を切り替えることができます。  -   アイコンは[ネットワークマップ](/manual/config/visualization/maps/map)要素を表示するために使用されます -   背景はネットワークマップの背景画像として使用されます  **イメージの追加**  右上隅にある[アイコンの作成]または[背景の作成]ボタンをクリックして、独自の画像を追加できます。  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_img_upload.png)  画像属性：  |パラメータ|詳細| |---------|-----------| |*名前*|画像の一意の名前| |*アップロード*|Zabbixにアップロードするファイル（PNG、JPEG、GIF）をローカルシステムから選択します。<br>*注意*アップロード中にPNGに変換される他の形式をアップロードできる場合があります。 GDライブラリが画像処理に使用されるため、サポートされるフォーマットは使用するライブラリのバージョンによって異なります（Zabbix 2.0.28以降が必要です）|  ::: noteclassic アップロードファイルの最大サイズは、1024x1024バイトまたは1MBのZBX\_MAX\_IMAGE\_SIZEの値によって制限されます。画像サイズが1MBに近く、 `max_allowed_pa​​cket`の場合、画像のアップロードが失敗することがあります。 MySQL設定パラメーターのデフォルトは1MBです。この場合[max\_allowed\_packet](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet)パラメーターを増やします。 :::

en-us	# Image  This class is designed to work with images.  Object references:\  -   [Image](/manual/api/reference/image/object#image)  Available methods:\  -   [image.create](/manual/api/reference/image/create) - create new     images -   [image.delete](/manual/api/reference/image/delete) - delete images -   [image.get](/manual/api/reference/image/get) - retrieve images -   [image.update](/manual/api/reference/image/update) - update images
ja	# Image  このクラスは、画像を操作するためのものです。  オブジェクトリファレンス :\  -   [Image](/manual/api/reference/image/object#image)  利用可能なメソッド :\  -   [image.create](/manual/api/reference/image/create) - 新しい画像を作成する -   [image.delete](/manual/api/reference/image/delete) - 画像を削除する -   [image.get](/manual/api/reference/image/get) - 画像を取得する -   [image.update](/manual/api/reference/image/update) - 画像を更新する

en-us	# image.update
ja	# image.update

en-us	 ### Implementation details  The high availability (HA) cluster is an opt-in solution and it is supported for Zabbix server. The native HA solution is designed to be simple in use, it will work across sites and does not have specific requirements for the databases that Zabbix recognizes. Users are free to use the native Zabbix HA solution, or a third-party HA solution, depending on what best suits the high availability requirements in their environment.  The solution consists of multiple zabbix\_server instances or nodes. Every node:  -   is configured separately -   uses the same database -   may have several modes: active, standby, unavailable, stopped  Only one node can be active (working) at a time. A standby node runs only one  process - the HA manager. A standby node does no data collection,  processing or other regular server activities; they do not listen  on ports; they have minimum database connections.  Both active and standby nodes update their last access time every 5 seconds. Each standby node monitors the last access time of the active node. If the last access time of the active node is over 'failover delay' seconds, the standby node switches itself to be the active node and assigns 'unavailable' status to the previously active node.  The active node monitors its own database connectivity - if it is lost for more than `failover delay-5` seconds, it must stop all processing and switch to standby mode. The active node also monitors the status of the standby nodes - if the last access time of a standby node is over 'failover delay' seconds, the standby node is assigned the 'unavailable' status.  The nodes are designed to be compatible across minor Zabbix versions.
ja	 ### 実装の詳細  高可用性 (HA) クラスターはオプトインソリューションであり、Zabbixサーバーでサポートされています。 ネイティブHAソリューションは、簡単に使用できるように設計されており、複数のサイトで機能し、Zabbixが認識するデータベースに関する特定の要件はありません。 ユーザーは、環境の高可用性要件に最適なものに応じて、ネイティブのZabbix HAソリューションまたはサードパーティのHAソリューションを自由に使用できます。  このソリューションは複数のzabbix\_serverインスタンスまたはノードで構成されています。 すべてのノードについて :  -   個別に構成 -   同じデータベースを使用 -   いくつかのモードがあるかもしれません : アクティブ、スタンバイ、使用不可、停止  一度にアクティブ (稼働) できるノードは 1 つだけです。 スタンバイノードは、HAマネージャーという1つのプロセスのみを実行します。スタンバイノードは、データの収集、処理、その他の通常のサーバーの仕事を行いません。 ポートをリッスンしません。 データベース接続は最小限です。  アクティブノードとスタンバイノードは両方とも、最終アクセス時刻を5秒ごとに更新します。各スタンバイノードは、アクティブノードの最終アクセス時刻を監視します。アクティブノードの最終アクセス時刻が'failover delay'秒を超えている場合、スタンバイノードは自身をアクティブノードに切り替え、以前のアクティブノードに'使用不可'ステータスを割り当てます。  アクティブノードは自身のデータベース接続を監視します。接続が`failover delay-5`秒を超えて失われた場合は、すべての処理を停止してスタンバイモードに切り替ります。 アクティブノードは、スタンバイノードのステータスも監視します。スタンバイノードの最終アクセス時刻が'failover delay'秒を超えている場合、スタンバイノードには'使用不可'ステータスが割り当てられます。  ノードは、Zabbixのマイナーバージョン間で互換性があるように設計されています。

en-us	#### Important notes  -   Database monitoring items will become unsupported if no *odbc poller* processes are started in the server or proxy configuration. To activate ODBC pollers, set *StartODBCPollers* parameter in Zabbix [server](/manual/appendix/config/zabbix_server) configuration file or, for checks performed by proxy, in Zabbix [proxy](/manual/appendix/config/zabbix_proxy) configuration file. -   Zabbix does not limit the query execution time. It is up to the user     to choose queries that can be executed in a reasonable amount of     time. -   The [Timeout](/manual/appendix/config/zabbix_server) parameter value     from Zabbix server is used as the ODBC login timeout (note that     depending on ODBC drivers the login timeout setting might be     ignored). -   The SQL command must return a result set like any query with     `select ...`. The query syntax will depend on the RDBMS which will     process them. The syntax of request to a storage procedure must be     started with `call` keyword.
ja	#### 重要な注意事項  - server または proxy 設定で*odbc poller*プロセスが起動されていない場合、データベース監視項目はサポートされなくなります。   ODBCポーラーを起動するには、Zabbix [server](/manual/appendix/config/zabbix_server) 設定ファイルで   *StartODBCPollers*パラメータを設定するか、proxy で実行するチェックの場合はZabbix [proxy] (/manual/appendix/config/zabbix_proxy) 設定ファイルで   *StartODBCPollers* パラメータを設定します。 - Zabbixはクエリの実行時間を制限していません。妥当な時間で実行できるクエリを選択することはユーザにゆだねられています。 - Zabbix server の[Timeout](/manual/appendix/config/zabbix_server)パラメータの値はODBCログインタイムアウトとして   使用されます(ODBCドライバによっては、ログインタイムアウト設定が無視される場合があることに注意してください)。 - SQL コマンドは、`select ...` を使用した他のクエリと同様に結果セットを返す必要があります。   問い合わせの構文は、それを処理するRDBMSに依存します。ストレージプロシージャへのリクエストの構文は `call` キーワードで   開始する必要があります。

en-us	#### Important notes  -   If more than one user macro with context exists, Zabbix will try to     match the simple context macros first and then context macros with     regular expressions in an undefined order.  ::: notewarning Do not create different context macros matching the same string to avoid undefined behavior. :::  -   If a macro with its context is not found on host, linked templates     or globally, then the macro without context is searched for. -   Only low-level discovery macros are supported in the context. Any     other macros are ignored and treated as plain text.  Technically, macro context is specified using rules similar to [item key](/manual/config/items/item/key) parameters, except macro context is not parsed as several parameters if there is a `,` character:  -   Macro context must be quoted with `"` if the context contains a `}`     character or starts with a `"` character. Quotes inside quoted     context must be escaped with the `\` character. -   The `\` character itself is not escaped, which means it's impossible     to have a quoted context ending with the `\` character - the macro     {$MACRO:"a:\\b\\c\\"} is invalid. -   The leading spaces in context are ignored, the trailing spaces are     not:     -   For example {$MACRO:A} is the same as {$MACRO: A}, but not         {$MACRO:A }. -   All spaces before leading quotes and after trailing quotes are     ignored, but all spaces inside quotes are not:     -   Macros {$MACRO:"A"}, {$MACRO: "A"}, {$MACRO:"A" } and {$MACRO:         "A" } are the same, but macros {$MACRO:"A"} and {$MACRO:" A "}         are not.  The following macros are all equivalent, because they have the same context: {$MACRO:A}, {$MACRO: A} and {$MACRO:"A"}. This is in contrast with item keys, where 'key\[a\]', 'key\[ a\]' and 'key\["a"\]' are the same semantically, but different for uniqueness purposes.
ja	#### 重要事項  -   コンテキストを持つ複数のユーザー マクロが存在する場合、Zabbix は最初に単純なコンテキスト マクロを照合し、次にコンテキスト マクロを未定義の順序で正規表現と照合しようとします。  ::: notewarning 未定義の動作を避けるために、同じ文字列に一致する別のコンテキスト マクロを作成しないでください。 :::  -   コンテキストを持つマクロがホスト、リンクされたテンプレート、またはグローバルで見つからない場合、コンテキストのないマクロが検索されます。 -   コンテキストでは、ローレベルディスカバリマクロのみがサポートされています。 その他のマクロはすべて無視され、プレーン テキストとして扱われます。  技術的には、マクロ コンテキストは [item key](/manual/config/items/item/key) パラメータと同様のルールを使用して指定されますが、`,` 文字がある場合、マクロ コンテキストは複数のパラメータとして解析されません。  -   コンテキストに `}` 文字が含まれている場合、または `"` 文字で始まる場合、マクロ コンテキストは `"` で引用する必要があります。 引用されたコンテキスト内の引用符は、`\` 文字でエスケープする必要があります。 -   `\` 文字自体はエスケープされません。つまり、`\` 文字で終わる引用符付きコンテキストを持つことは不可能です - マクロ {$MACRO:"a:\\b\\c\\"} は無効です。 -   コンテキスト内の先頭のスペースは無視されますが、末尾のスペースは無視されます:     -   たとえば、{$MACRO:A} は {$MACRO: A} と同じですが、{$MACRO:A } とは異なります。 -   先頭の引用符の前と末尾の引用符の後のすべてのスペースは無視されますが、引用符内のすべてのスペースは無視されません。     -   マクロ {$MACRO:"A"}、{$MACRO: "A"}、{$MACRO:"A" }、および {$MACRO: "A" } は同じですが、マクロ {$MACRO:"A"} および {$MACRO:" A "} ではありません。  {$MACRO:A}、{$MACRO: A}、および {$MACRO:"A"} のマクロは、同じコンテキストを持っているため、すべて同等です。 これは、'key\[a\]'、'key\[ a\]'、および 'key\["a"\]' が意味的に同じである項目キーとは対照的ですが、一意性のために異なります。

en-us	 ### Important notes  - Make sure to back up the database before the upgrade. - If the database uses partitions, contact the DB administrator or Zabbix support team for help. - Stopping Zabbix server for the time of the upgrade is strongly recommended. However, if absolutely necessary, there is a way to perform an upgrade while the server is running (only for MySQL, MariaDB and PostgreSQL without TimescaleDB). - CSV files can be removed after a successful upgrade to primary keys. - Optionally, Zabbix frontend may be switched to [maintenance mode](/manual/web_interface/maintenance_mode). - Upgrade to primary keys should be done after upgrading Zabbix server to 6.0. - On proxy, history tables that are not used can be upgraded by executing history_pk_prepare.sql.
ja	### 重要事項  - アップグレードの前に、必ずデータベースをバックアップしてください。 - データベースがパーティションを使用している場合は、DB 管理者または Zabbix サポート チームにお問い合わせください。 - アップグレード中は Zabbix サーバーを停止することを強くお勧めします。 ただし、どうしても必要な場合には、サーバー実行中にアップグレードを実行する方法があります (TimescaleDB を使用しない MySQL、MariaDB、および PostgreSQL のみ)。 - CSV ファイルは、プライマリ キーへのアップグレードが成功した後に削除できます。 - 必要に応じて、Zabbix フロントエンドを [メンテナンス モード](/manual/web_interface/maintenance_mode) に切り替えることができます。 - Zabbix サーバーを 6.0 にアップグレードした後、主キーへのアップグレードを行う必要があります。 - プロキシでは、使用されていない履歴テーブルは history_pk_prepare.sql を実行してアップグレードできます。

en-us	#### Important rules  -   A whitelist without a deny rule is only allowed for system.run\[\*\]     items. For all other items, AllowKey parameters are not allowed     without a DenyKey parameter; in this case Zabbix agent **will not     start** with only AllowKey parameters. -   The order matters. The specified parameters are checked one by one     according to their appearance order in the configuration file:     -   As soon as an item key matches an allow/deny rule, the item is         either allowed or denied; and rule checking stops. So if an item         matches both an allow rule and a deny rule, the result will         depend on which rule comes first.     -   The order affects also EnableRemoteCommands parameter (if used). -   Unlimited numbers of AllowKey/DenyKey parameters is supported. -   AllowKey, DenyKey rules do not affect HostnameItem,     HostMetadataItem, HostInterfaceItem configuration parameters. -   Key pattern is a wildcard expression where the wildcard (\*)     character matches any number of any characters in certain position.     It might be used in both the key name and parameters. -   If a specific item key is disallowed in the agent configuration, the     item will be reported as unsupported (no hint is given as to the     reason); -   Zabbix agent with --print (-p) command line option will not show     keys that are not allowed by configuration; -   Zabbix agent with --test (-t) command line option will return     "Unsupported item key." status for keys that are not allowed by     configuration; -   Denied remote commands will not be logged in the agent log (if     LogRemoteCommands=1).
ja	#### 重要ルール  - deny ルールのないホワイトリストは、system.run[ \*] アイテムに対してのみ許可されます。その他のアイテムでは、   DenyKey パラメータがない場合、AllowKey パラメータを使用することはできません。 -   順番は重要です。指定されたパラメータは、設定ファイル内の表示順に従って1つずつチェックされます:     -  item キーが allow / deny ルールに一致すると、item は許可または拒否され、ルールチェックは停止されます。     したがって、ある item が allow ルールと deny ルールの両方にマッチした場合、どちらのルールが先に来るかによって     結果が異なります。     -   この順序は、EnableRemoteCommands パラメータにも影響します。（使用する場合） -   AllowKey / DenyKey パラメータは無制限に使用できます。 -   AllowKey、DenyKeyルールは、HostnameItem、HostMetadataItem、HostInterfaceItem 構成パラメータには影響しません。 -   キーパターンは、ワイルドカード (\*) 文字が特定の位置にある任意の数の文字と一致するワイルドカード式です。     キー名とパラメーターの両方で使用することができます。 -   特定の item キーが agent 構成で許可されていない場合、その item はサポートされていないと報告されます。     (理由のヒントは与えられません)。 -   Zabbix agent に --print (-p) コマンドラインオプションを指定すると、設定により許可されていないキーは表示されません。 -   Zabbix agent の--test(-t)コマンドラインオプションを使用すると、設定で許可されていないキーに対して      "Unsupported item key."というステータスが返されます。 -  拒否されたリモートコマンドは agent ログに記録されません。(LogRemoteCommands=1 の場合)

en-us	##### Importing data  Import initial schema:      # cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix  For proxy with PostgreSQL (or SQLite):      # cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix     # cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db
ja	##### データのインポート  初期スキーマのインポートには、以下のコマンドラインを実行します:    # cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix  PostgreSQL (または SQLite)を使用するproxy用には、以下のコマンドラインを実行します:    # cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix<br>   # cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db

en-us	#### Importing data with Timescale DB  With TimescaleDB, in addition to the import command for PostgreSQL, also run:      # cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix  ::: notewarning TimescaleDB is supported with Zabbix server only. :::
ja	#### TimescaleDBによるデータのインポート  TimescaleDBでは、PostgreSQLのインポートコマンドに加えて、さらに以下のコマンドを実行します:    # cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix  ::: notewarning TimescaleDBはZabbix server でのみサポートされています。 :::

en-us	#### Importing hosts and items  Import the host and items contained in the XML string. If any items in XML are missing, they will be deleted from the database, and everything else will be left unchanged.  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "configuration.import",     "params": {         "format": "xml",         "rules": {             "valueMaps": {                 "createMissing": true,                 "updateExisting": false             },             "hosts": {                 "createMissing": true,                 "updateExisting": true             },             "items": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             }         },         "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>5.4</version><date>2020-03-13T15:31:45Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><hosts><host><host>Export host</host><name>Export host</name><groups><group><name>Zabbix servers</name></group></groups><interfaces><interface><interface_ref>if1</interface_ref></interface></interfaces><items><item><name>Item</name><key>item.key</key><delay>30s</delay><valuemap><name>Host status</name></valuemap><interface_ref>if1</interface_ref><request_method>POST</request_method></item></items><valuemaps><valuemap><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></host></hosts></zabbix_export>"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": true,     "id": 1 } ```
ja	#### ホストとアイテムのインポート  XML 文字列に含まれるホストと item をインポートします。XML に含まれる item が欠落している場合、その item は<br> データベースから削除され、それ以外は変更されずに残ります。   Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "configuration.import",     "params": {         "format": "xml",         "rules": {             "valueMaps": {                 "createMissing": true,                 "updateExisting": false             },             "hosts": {                 "createMissing": true,                 "updateExisting": true             },             "items": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             }         },         "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>5.4</version><date>2020-03-13T15:31:45Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><hosts><host><host>Export host</host><name>Export host</name><groups><group><name>Zabbix servers</name></group></groups><interfaces><interface><interface_ref>if1</interface_ref></interface></interfaces><items><item><name>Item</name><key>item.key</key><delay>30s</delay><valuemap><name>Host status</name></valuemap><interface_ref>if1</interface_ref><request_method>POST</request_method></item></items><valuemaps><valuemap><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></host></hosts></zabbix_export>"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": true,     "id": 1 } ```

en-us	#### Importing hosts and items  Import the template and items contained in the YAML string. If any items in YAML are missing, they will be shown as deleted, and everything else will be left unchanged.  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "configuration.import",     "params": {         "format": "xml",         "rules": {             "groups": {                 "createMissing": true,                 "updateExisting": true             },             "templates": {                 "createMissing": true,                 "updateExisting": true             },             "items": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             },             "triggers": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             },             "discoveryRules": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             },             "valueMaps": {                 "createMissing": true,                 "updateExisting": false             }         },         "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><zabbix_export><version>5.4</version><date>2021-05-27T07:12:07Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><templates><template><uuid>e1bde9bf2f0544f5929f45b82502e744</uuid><template>Export template</template><name>Export template</name><groups><group><name>Zabbix servers</name></group></groups><items><item><uuid>3237bc89226e42ed8207574022470e83</uuid><name>Item</name><key>item.key</key><delay>30s</delay><valuemap><name>Host status</name></valuemap><triggers><trigger><uuid>bd1ed0089e4b4f35b762c9d6c599c348</uuid><expression>last(/Export template/item.key)=0</expression><name>Trigger</name></trigger></triggers></item></items><discovery_rules><discovery_rule><uuid>c91616bcf4a44f349539a1b40cb0979d</uuid><name>Discovery rule</name><key>rule.key</key><item_prototypes><item_prototype><uuid>7e164881825744248b3039af3435cf4b</uuid><name>Item prototype</name><key>prototype.key</key></item_prototype></item_prototypes></discovery_rule></discovery_rules><valuemaps><valuemap><uuid>7e666857c5df4af3a338349586f2afc3</uuid><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ``` {.java} {    "jsonrpc":"2.0",    "result":{       "templates":{          "updated":[             {                "before":{                   "uuid":"e1bde9bf2f0544f5929f45b82502e744",                   "template":"Export template",                   "name":"Export template"                },                "after":{                   "uuid":"e1bde9bf2f0544f5929f45b82502e744",                   "template":"Export template",                   "name":"Export template"                },                "items":{                   "added":[                      {                         "after":{                            "uuid":"3237bc89226e42ed8207574022470e83",                            "name":"Item",                            "key":"item.key",                            "delay":"30s",                            "valuemap":{                               "name":"Host status"                            }                         },                         "triggers":{                            "added":[                               {                                  "after":{                                     "uuid":"bd1ed0089e4b4f35b762c9d6c599c348",                                     "expression":"last(/Export template/item.key)=0",                                     "name":"Trigger"                                  }                               }                            ]                         }                      }                   ],                   "removed":[                      {                         "before":{                            "uuid":"bd3e7b28b3d544d6a83ed01ddaa65ab6",                            "name":"Old Item",                            "key":"ite_old.key",                            "delay":"30s",                            "valuemap":{                               "name":"Host status"                            }                         }                      }                   ]                },                "discovery_rules":{                   "updated":[                      {                         "before":{                            "uuid":"c91616bcf4a44f349539a1b40cb0979d",                            "name":"Discovery rule",                            "key":"rule.key"                         },                         "after":{                            "uuid":"c91616bcf4a44f349539a1b40cb0979d",                            "name":"Discovery rule",                            "key":"rule.key"                         },                         "item_prototypes":{                            "updated":[                               {                                  "before":{                                     "uuid":"7e164881825744248b3039af3435cf4b",                                     "name":"Old item prototype",                                     "key":"prototype_old.key"                                  },                                  "after":{                                     "uuid":"7e164881825744248b3039af3435cf4b",                                     "name":"Item prototype",                                     "key":"prototype.key"                                  }                               }                            ]                         }                      }                   ]                }             }          ]       }    },    "id":1 } ```
ja	#### ホストと item の インポート  YAML文字列に含まれるテンプレートと item を インポートします。YAMLに含まれていない項目がある場合、それらは削除された<br> ものとして表示され、それ以外は変更されずに残ります。  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "configuration.import",     "params": {         "format": "xml",         "rules": {             "groups": {                 "createMissing": true,                 "updateExisting": true             },             "templates": {                 "createMissing": true,                 "updateExisting": true             },             "items": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             },             "triggers": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             },             "discoveryRules": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             },             "valueMaps": {                 "createMissing": true,                 "updateExisting": false             }         },         "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><zabbix_export><version>5.4</version><date>2021-05-27T07:12:07Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><templates><template><uuid>e1bde9bf2f0544f5929f45b82502e744</uuid><template>Export template</template><name>Export template</name><groups><group><name>Zabbix servers</name></group></groups><items><item><uuid>3237bc89226e42ed8207574022470e83</uuid><name>Item</name><key>item.key</key><delay>30s</delay><valuemap><name>Host status</name></valuemap><triggers><trigger><uuid>bd1ed0089e4b4f35b762c9d6c599c348</uuid><expression>last(/Export template/item.key)=0</expression><name>Trigger</name></trigger></triggers></item></items><discovery_rules><discovery_rule><uuid>c91616bcf4a44f349539a1b40cb0979d</uuid><name>Discovery rule</name><key>rule.key</key><item_prototypes><item_prototype><uuid>7e164881825744248b3039af3435cf4b</uuid><name>Item prototype</name><key>prototype.key</key></item_prototype></item_prototypes></discovery_rule></discovery_rules><valuemaps><valuemap><uuid>7e666857c5df4af3a338349586f2afc3</uuid><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ``` {.java} {    "jsonrpc":"2.0",    "result":{       "templates":{          "updated":[             {                "before":{                   "uuid":"e1bde9bf2f0544f5929f45b82502e744",                   "template":"Export template",                   "name":"Export template"                },                "after":{                   "uuid":"e1bde9bf2f0544f5929f45b82502e744",                   "template":"Export template",                   "name":"Export template"                },                "items":{                   "added":[                      {                         "after":{                            "uuid":"3237bc89226e42ed8207574022470e83",                            "name":"Item",                            "key":"item.key",                            "delay":"30s",                            "valuemap":{                               "name":"Host status"                            }                         },                         "triggers":{                            "added":[                               {                                  "after":{                                     "uuid":"bd1ed0089e4b4f35b762c9d6c599c348",                                     "expression":"last(/Export template/item.key)=0",                                     "name":"Trigger"                                  }                               }                            ]                         }                      }                   ],                   "removed":[                      {                         "before":{                            "uuid":"bd3e7b28b3d544d6a83ed01ddaa65ab6",                            "name":"Old Item",                            "key":"ite_old.key",                            "delay":"30s",                            "valuemap":{                               "name":"Host status"                            }                         }                      }                   ]                },                "discovery_rules":{                   "updated":[                      {                         "before":{                            "uuid":"c91616bcf4a44f349539a1b40cb0979d",                            "name":"Discovery rule",                            "key":"rule.key"                         },                         "after":{                            "uuid":"c91616bcf4a44f349539a1b40cb0979d",                            "name":"Discovery rule",                            "key":"rule.key"                         },                         "item_prototypes":{                            "updated":[                               {                                  "before":{                                     "uuid":"7e164881825744248b3039af3435cf4b",                                     "name":"Old item prototype",                                     "key":"prototype_old.key"                                  },                                  "after":{                                     "uuid":"7e164881825744248b3039af3435cf4b",                                     "name":"Item prototype",                                     "key":"prototype.key"                                  }                               }                            ]                         }                      }                   ]                }             }          ]       }    },    "id":1 } ```

en-us	#### Importing  To import hosts, do the following:  -   Go to: *Configuration* → *Hosts* -   Click on *Import* to the right -   Select the import file -   Mark the required options in import rules -   Click on *Import*  ![](../../../assets/en/manual/xml_export_import/import_hosts.png)  A success or failure message of the import will be displayed in the frontend.  Import rules:  |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise it will not remove them.<br>If *Delete missing* is marked for template linkage, existing template linkage not present in the import file will be removed from the host along with all entities inherited from the potentially unlinked templates (items, triggers, etc).|
ja	#### Import  ホストを Import するには、次のようにします。  - *Configuration*→*Hosts*をクリックします。 - 右側の*Import*をクリックします。 - import ファイルを選択します。 - import ルールの必要なオプションにマークを付けます - *Import*をクリックします。  ![](../../../assets/en/manual/xml_export_import/import_hosts.png)  import の成功または失敗のメッセージは、フロントエンドに表示されます。  Import ルール:  |Rule|Description| |----|-----------| |*Update existing*|既存の要素は、import ファイルから取得したデータで更新されます。そうでない場合は、更新されません。| |*Create new*|import は、import ファイルのデータを使用して新しい要素を追加します。そうでない場合は、追加されません。| |*Delete missing*|import は、import ファイルに存在しない既存の要素を削除します。そうでない場合は、削除されません。<br> テンプレート・リンクに *Delete missing* が指定されている場合、import ファイルに存在しない既存のテンプレート・リンクは、 リンクされていない可能性のあるテンプレートから継承されたすべてのエンティティ（アイテム、トリガーなど）と共にホストから削除されます。|

en-us	#### Importing  To import media types, do the following:  -   Go to: *Administration* → *Media types* -   Click on *Import* to the right -   Select the import file -   Mark the required options in import rules -   Click on *Import*  ![](../../../assets/en/manual/xml_export_import/import_media.png)  A success or failure message of the import will be displayed in the frontend.  Import rules:  |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise it will not remove them.|
ja	#### インポート  メディアタイプをインポートするには、次のようにします。  - *管理* → *メディアタイプ* に移動します。 - 右側の*インポート*をクリックします。 - インポートするファイルを選択します。 - インポートルールの必要なオプションにマークを付けます。 - *インポート*をクリックします。  ![](../../../assets/en/manual/xml_export_import/import_media.png)  インポートの成功または失敗のメッセージがWebインターフェースに表示されます。  インポートルール:  |ルール|説明| |----|-----------| |*既存の設定を上書Update existing*|既存の要素は、import ファイルから取得したデータで更新されます。そうでない場合は、更新されません。| |*新規作成*|import ファイルのデータを使用して新しい要素を追加します。そうでない場合は、追加されません。| |*存在しない場合に削除*|インポートファイルに存在しない既存の要素を削除します。そうでない場合は、削除されません。|

en-us	#### Importing  To import network maps, do the following:  -   Go to: *Monitoring* → *Maps* -   Click on *Import* to the right -   Select the import file -   Mark the required options in import rules -   Click on *Import*  ![](../../../assets/en/manual/xml_export_import/import_maps.png)  All mandatory input fields are marked with a red asterisk.  A success or failure message of the import will be displayed in the frontend.  Import rules:  |Rule|Description| |----|-----------| |*Update existing*|Existing maps will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new maps using data from the import file. Otherwise it will not add them.|  If you uncheck both map options and check the respective options for images, images only will be imported. Image importing is only available to Super Admin users.  ::: notewarning If replacing an existing image, it will affect all maps that are using this image. :::
ja	#### import  ネットワークマップを import するには、次のようにします。  - *Monitoring* → *Maps* に移動します。 - 右側の*Import*をクリックします。 - import  ファイルを選択します。 - import ルールの必要なオプションにマークを付けます。 - *import* をクリックします。  ![](../../../assets/en/manual/xml_export_import/import_maps.png)  すべての必須入力項目には赤いアスタリスクが表示されます。  import  の成功または失敗のメッセージは、フロントエンドに表示されます。  Import ルール:  |Rule|Description| |----|-----------| |*Update existing*|Existing maps will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new maps using data from the import file. Otherwise it will not add them.|  マップのオプションを両方ともオフにし、イメージのオプションをそれぞれオンにすると、イメージのみが import されます。 <br> 画像の import は、Super Adminユーザのみ可能です。  ::: notewarning 既存の画像を置き換える場合、この画像を使用しているすべてのマップに影響します。 :::

en-us	#### Importing  To import templates, do the following:  -   Go to: *Configuration* → *Templates* -   Click on *Import* to the right -   Select the import file -   Mark the required options in import rules -   Click on *Import*  ![](../../../assets/en/manual/xml_export_import/import_templates.png)  All mandatory input fields are marked with a red asterisk.  Import rules:  |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise, they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise, it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise, it will not remove them.<br>If *Delete missing* is marked for template linkage, existing template linkage not present in the import file will be unlinked. Since Zabbix 6.0.13, entities (items, triggers, graphs, etc.) inherited from the unlinked templates will not be removed (unless the *Delete missing* option is selected for each entity as well).|  On the next screen, you will be able to view the content of a template being imported. If this is a new template all elements will be listed in green. If updating an existing template, new template elements are highlighted in green; removed template elements are highlighted in red; elements that have not changed are listed on a gray background.  ![](../../../assets/en/manual/xml_export_import/import_templates1.png){width="600"}  The menu on the left can be used to navigate through the list of changes. Section *Updated* highlights all changes made to existing template elements. Section *Added* lists new template elements. The elements in each section are grouped by element type; press on the gray arrow down to expand or collapse the group of elements.  ![](../../../assets/en/manual/xml_export_import/templates_import_menu.png)  Review template changes, then press *Import* to perform template import. A success or failure message of the import will be displayed in the frontend.
ja	#### インポート  テンプレートをインポートするには、次の操作を行います。  - *設定* → *テンプレート* に移動します。 - 右側の*インポート*をクリックします。 - インポートファイルを選択します。 - インポートルールで必要なオプションをマークします。 - *インポート*をクリックします。  ![](../../../assets/en/manual/xml_export_import/import_templates.png)  すべての必須入力項目には赤いアスタリスクが表示されます。  インポートルール:  |ルール|説明| |----|-----------| |*Update existing*|既存の要素は、インポートファイルから取得したデータで更新されます。そうでない場合は、更新されません。| |*Create new*|インポートファイルのデータを使用して新しい要素を追加します。そうでない場合は、追加されません。| |*Delete missing*|インポートファイルに存在しない既存の要素は削除されます。そうでない場合は、削除されません。テンプレート・リンクに *Delete missing* が指定されている場合、インポート・ファイルに存在しない既存のテンプレート・リンケージは、リンクされていない可能性のあるテンプレートから継承されたすべてのエンティティ（アイテム、トリガーなど）と共にテンプレートから削除されます。|  次の画面では、インポートされたテンプレートの内容を確認することができます。 新しいテンプレートであれば、すべての要素が緑色で表示されます。 既存のテンプレートを更新する場合、新しいテンプレート要素は緑色でハイライトされ、削除されたテンプレート要素は赤色で、変更のない要素は灰色の背景で表示されます。  ![](../../../assets/en/manual/xml_export_import/import_templates1.png){width="600"}  左のメニューから、変更点の一覧を表示することができます。 セクション*Updated*は、既存のテンプレート要素に加えられたすべての変更点をハイライト表示します。 セクション *Added* は、新しいテンプレート要素をリストアップします。 各セクションの要素は、要素の種類によってグループ化されています。 グレーの矢印を押して、要素のグループを展開または折りたたみます。  ![](../../../assets/en/manual/xml_export_import/templates_import_menu.png)  テンプレートの変更を確認し、*インポート*を押してテンプレートのインポートを実行します。 フロントエンドにインポートの成功または失敗のメッセージが表示されます。

en-us	### Improved performance of history syncers  The performance of history syncers has been improved by introducing a new read-write lock. This reduces locking between history syncers, trappers and proxy pollers by using a shared read lock while accessing the configuration cache. The new lock can be write locked only by the configuration syncer performing a configuration cache reload.
ja	### history syncersのパフォーマンス改善  history syncerのパフォーマンスは、新しいread-writeロックを導入することで改善されました。 これにより、構成キャッシュにアクセスしながら共有読み取りロックを使用して、history syncer、trapper、proxy poller間のロックが削減されます。 新しいロックは、構成キャッシュリロードを実行するconfiguration syncerによってのみロックされた書き込みができます。

en-us	### Improved performance of history syncers  The performance of history syncers has been improved by introducing a new read-write lock. This reduces locking between history syncers, trappers and proxy pollers by using a shared read lock while accessing the configuration cache. The new lock can be write locked only by the configuration syncer performing a configuration cache reload.
ja	### history syncersのパフォーマンス改善  history syncerのパフォーマンスは、新しいread-writeロックを導入することで改善されました。 これにより、構成キャッシュにアクセスしながら共有読み取りロックを使用して、history syncer、trapper、proxy poller間のロックが削減されます。 新しいロックは、構成キャッシュリロードを実行するconfiguration syncerによってのみロックされた書き込みができます。

en-us	##### In accepting-side log:      ...failed to accept an incoming connection: from 127.0.0.1: support for TLS was not compiled in
ja	##### 受付側ログ:      ...failed to accept an incoming connection: from 127.0.0.1: support for TLS was not compiled in

en-us	In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)  for all widgets, you may set the following specific options:  |   |   | |--|--------| |*Host groups*|Host groups to display data for.| |*Hosts*|Hosts to display data for.| |*Host tags*|Specify tags to limit the number of hosts displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met| |*Columns*|Add data [columns](#column-configuration) to display.<br>The column order determines their display from left to right.<br>Columns can be reordered by dragging up and down by the handle before the column name.| |*Order*|Specify the ordering of rows:<br>**Top N** - in descending order by the *Order column* aggregated value<br>**Bottom N** - in ascending order by the *Order column* aggregated value | |*Order column*|Specify the column from the defined *Columns* list to use for *Top N* or *Bottom N* ordering.| |*Host count*|Count of host rows to be shown (1-100).|
ja	すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。  |   |   | |--|--------| |*ホストグループ*|データを表示するホストグループ| |*ホスト*|データを表示するホスト| |*ホストのタグ*|タグを指定して、ウィジェットに表示されるホストの数を制限します。 特定のタグとタグ値を含めたり除外したりすることができます。 いくつかの条件を設定できます。 タグ名の照合では常に大文字と小文字が区別されます。<br><br>各条件で使用できる演算子はいくつかあります。<br>**Exists** - 指定されたタグ名を含める<br>**Equals** - 指定されたタグ名と値を含める（大文字と小文字を区別）<br> **Contains** - タグ値に入力された文字列が含まれる場合に指定されたタグ名を含める（文字列の部分一致、大文字と小文字を区別しない）<br>**Does not exist** - 指定されたタグ名を除外する<br>**Does not equal**-指定されたタグ名と値を除外する（大文字と小文字を区別）<br>**Does not contain** - タグ値に入力された文字列が含まれる指定されたタグ名を除外する（文字列の部分一致、大文字と小文字を区別しない）<br>条件には2つの計算タイプがあります：<br>**And/Or** - すべての条件が満たされる必要があり、同じタグ名を持つ条件はOr条件によってグループ化されます<br >**Or** - 1つの条件が満たされる| |*列*|表示するデータ[列](#columns)を追加します。<br>列の順序によって、左から右への表示が決まります。<br>列名の前のハンドルを上下にドラッグすると、列の順序を変更できます。| |*表示順序*|行の順序を指定します。<br>**上位N** - *順序用列*集計値の降順<br>**下位N** - *順序用列*集計値の昇順| |*順序用列*|定義された*列*リストから列を指定して、*上位N*または*下位N*の順序付けに使用します。| |*ホスト数*|表示するホストの行数 (1 - 100)|

en-us	In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)  for all widgets, you may set the following specific options:  |   |   | |---|---| |*Host groups*|Select host groups to be displayed on the map. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups. Scroll down to select. Click on 'x' to remove selected groups. <br>If nothing is selected in both *Host groups* and *Hosts* fields, all hosts with valid coordinates will be displayed.| |*Hosts*|Select hosts to be displayed all the map. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts. Scroll down to select. Click on 'x' to remove selected hosts. <br>If nothing is selected in both *Host groups* and *Hosts* fields, all hosts with valid coordinates will be displayed.| |*Tags*|Specify tags to limit the number of hosts displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met| |*Initial view*|Comma-separated center coordinates and an optional zoom level to display when the widget is initially loaded in the format `<latitude>,<longitude>,<zoom>`<br>If initial zoom is specified, the Geomap widget is loaded at the given zoom level. Otherwise, initial zoom is calculated as half of the [max zoom](/manual/web_interface/frontend_sections/administration/general#geographical_maps) for the particular tile provider.<br>The initial view is ignored if the default view is set (see below).<br>Examples:<br>=> 40.6892494,-74.0466891,14<br>=> 40.6892494,-122.0466891|
ja	すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。  |   |   | |---|---| |*ホストグループ*|マップに表示するホストグループを選択します。 このフィールドはオートコンプリートであるため、グループの名前を入力し始めると、一致するグループ名がドロップダウンで表示されます。 スクロールして選択します。 'x'をクリックして選択したグループを削除できます。 <br> * ホストグループ*フィールドと*ホスト*フィールドの両方で何も選択されていない場合、有効な座標を持つすべてのホストが表示されます。| |*ホスト*|すべてのマップを表示するホストを選択します。 このフィールドはオートコンプリートであるため、ホストの名前を入力し始めると、一致するホスト名がドロップダウンで表示されます。スクロールして選択します。 'x'をクリックして選択したホストを削除できます。 <br> *ホストグループ*フィールドと*ホスト*フィールドの両方で何も選択されていない場合、有効な座標を持つすべてのホストが表示されます。| |*タグ*|タグを指定して、ウィジェットに表示されるホストの数を制限します。 特定のタグとタグ値を含めたり除外したりすることができます。 いくつかの条件を設定できます。 タグ名の照合では常に大文字と小文字が区別されます。<br>条件ごとに使用できる演算子がいくつかあります。<br>**Exists** - 指定されたタグ名を含める<br>**Equals** - 指定されたタグ名と値を含める（大文字と小文字を区別）<br> **Contains** - タグ値に入力された文字列が含まれる場合に指定されたタグ名を含める（文字列の部分一致、大文字と小文字を区別しない）<br>**Does not exist** - 指定されたタグ名を除外する<br>**Does not equal**-指定されたタグ名と値を除外する（大文字と小文字を区別）<br>**Does not contain** - タグ値に入力された文字列が含まれる指定されたタグ名を除外する（文字列の部分一致、大文字と小文字を区別しない）<br>条件には2つの計算タイプがあります：<br>**And/Or** - すべての条件が満たされる必要があり、同じタグ名を持つ条件はOr条件によってグループ化されます<br >**Or** - 1つの条件が満たされる| |*初期表示位置*|ウィジェットが最初に`<latitude>、<longitude>、<zoom>`の形式でロードされたときに表示する、カンマ区切りの中心座標とオプションのズームレベル<br>初期ズームが指定されている場合、ジオマップウィジェットは 与えられたズームレベルで表示します。 それ以外の場合、初期ズームは特定のタイルプロバイダーの[最大ズーム](/manual/web_interface/frontend_sections/administration/general#geographical_maps)の半分として計算されます。<br>デフォルトビューが設定されている場合、初期ビューは無視されます（以下を参照）<br>例：<br>=>40.6892494,-74.0466891,14<br>=>40.6892494,-122.0466891|