en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.Oracle.CallTimeout|no|1-30|global timeout|The maximum wait time in seconds for a request to be completed.| |Plugins.Oracle.ConnectTimeout|no|1-30|global timeout|The maximum wait time in seconds for a connection to be established.| |Plugins.Oracle.CustomQueriesPath|no|<|<|Full pathname of a directory containing .sql files with custom queries.<br>Disabled by default.<br>Example: `/etc/zabbix/oracle/sql`| |Plugins.Oracle.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.Oracle.Sessions.<SessionName>.Password|no|<|<|Named session password.<br>**<SessionName>** - name of a session for using in item keys.| |Plugins.Oracle.Sessions.<SessionName>.Service|no|<|<|Named session service name to be used for connection (SID is not supported).<br>Supported for: *Oracle*.<br>**<PluginName>** - name of the plugin.<br>**<SessionName>** -name of a session for using in item keys.| |Plugins.Oracle.Sessions.<SessionName>.Uri|no|<|tcp://localhost:1521|Named session connection string for Oracle.<br>**<SessionName>** - name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `tcp` scheme is supported; a scheme can be omitted (since version 5.2.3).<br>A port can be omitted (default=1521).<br>Examples: `tcp://127.0.0.1:1521`<br>`localhost`| |Plugins.Oracle.Sessions.<SessionName>.User|no|<|<|Named session username.<br>**<SessionName>** - name of a session for using in item keys.|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/config/items/plugins)
ja	#### パラメータ  |パラメータ|必須|範囲|デフォルト|説明| |--|--|--|--|----------| |Plugins.Oracle.CallTimeout|no|1-30|global timeout|リクエストが完了するまでの最大待機時間（秒単位）| |Plugins.Oracle.ConnectTimeout|no|1-30|global timeout|接続が確立されるまでの最大待機時間（秒単位）| |Plugins.Oracle.CustomQueriesPath|no|<|<|カスタムクエリを含む.sqlファイルを含むディレクトリのフルパス名<br>デフォルトでは無効になっています<br>例: `/etc/zabbix/oracle/sql`| |Plugins.Oracle.KeepAlive|no|60-900|300|未使用のプラグイン接続が閉じられるまでの最大待機時間（秒単位）| |Plugins.Oracle.Sessions.<SessionName>.Password|no|<|<|名前付きセッションパスワード<br>**<SessionName>** - アイテムキーで使用するセッション名| |Plugins.Oracle.Sessions.<SessionName>.Service|no|<|<|接続に使用される名前付きセッションサービス名（SIDはサポートされていません）<br>サポート対象：*Oracle*<br>**<PluginName>** - プラグインの名前<br>**<SessionName> ** - アイテムキーで使用するセッション名| |Plugins.Oracle.Sessions.<SessionName>.Uri|no|<|tcp://localhost:1521|Oracleの名前付きセッション接続文字列<br>**<SessionName>** - アイテムキーで使用するセッション名<br><br>埋め込みクレデンシャルを含めないでください（無視されます）<br>必須 URI形式に一致します<br>`tcp`スキームのみがサポートされています。 スキームは省略できます（バージョン5.2.3以降）<br>ポートは省略できます（デフォルト= 1521）<br>例: `tcp://127.0.0.1:1521`<br>`localhost`| |Plugins.Oracle.Sessions.<SessionName>.User|no|<|<|名前付きセッションのユーザー名<br>**<SessionName>** - アイテムキーで使用するセッションの名前|  参考情報:  -   一般的なZabbixエージェント2の設定パラメータの説明 : [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2)/[Zabbix agent 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) -   [プラグイン](/manual/config/items/plugins)の設定手順

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.Redis.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.Redis.Sessions.<SessionName>.Password|no|<|<|Named session password.<br>**<SessionName>** - name of a session for using in item keys.| |Plugins.Redis.Sessions.<SessionName>.Uri|no|<|tcp://localhost:6379|Connection string of a named session.<br>**<SessionName>** - name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`; a scheme can be omitted (since version 5.2.3).<br>A port can be omitted (default=6379).<br>Examples: `tcp://localhost:6379`<br>`localhost`<br>`unix:/var/run/redis.sock`| |Plugins.Redis.Sessions.<SessionName>.User|no|<|<|Named session username.<br>**<SessionName>** - name of a session for using in item keys.| |Plugins.Redis.Timeout|no|1-30|global timeout|Request execution timeout (how long to wait for a request to complete before shutting it down).|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/config/items/plugins)
ja	#### パラメーター  |パラメータ|必須|範囲|デフォルト|説明| |--|--|--|--|----------| |Plugins.Redis.KeepAlive|no|60-900|300|未使用のプラグイン接続が閉じられるまでの最大待機時間（秒単位）| |Plugins.Redis.Sessions.<SessionName>.Password|no|<|<|名前付きセッションパスワード<br>**<SessionName>** - アイテムキーで使用するセッションの名前| |Plugins.Redis.Sessions.<SessionName>.Uri|no|<|tcp://localhost:6379|名前付きセッションの接続文字列<br>**<SessionName>** - アイテムキーで使用するセッションの名前<br><br>埋め込み資格情報を含めることはできません（<br>URI形式と一致する必要があります<br>サポートされているスキーム: `tcp`,` unix`; スキームは省略できます（バージョン5.2.3以降）<br>ポートは省略できます（デフォルト= 6379）<br>例`tcp://localhost:6379`<br>`localhost`<br>`unix:/var/run/redis.sock`| |Plugins.Redis.Sessions.<SessionName>.User|no|<|<|名前付きセッションのユーザー名<br>**<SessionName>** - アイテムキーで使用するセッションの名前| |Plugins.Redis.Timeout|no|1-30|global timeout|リクエストの実行タイムアウト（リクエストが完了するのを待ってからシャットダウンするまでの時間）|  参考情報:  -   一般的なZabbixエージェント2の設定パラメータの説明 : [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2)/[Zabbix agent 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) -   [プラグイン](/manual/config/items/plugins)の設定手順

en-us	#### Parameters  Parameters in this file that could be of interest to users:  -   ZBX\_MIN\_PERIOD  Minimum graph period, in seconds. One minute by default.  -   GRAPH\_YAXIS\_SIDE\_DEFAULT  Default location of Y axis in simple graphs and default value for drop down box when adding items to custom graphs. Possible values: 0 - left, 1 - right.  Default: 0  -   ZBX\_SESSION\_NAME (available since 4.0.0)  String used as the name of the Zabbix frontend session cookie.  Default: zbx\_sessionid  -   ZBX\_DATA\_CACHE\_TTL (available since 5.2.0)  TTL timeout in seconds used to invalidate data cache of [Vault response](/manual/config/secrets). Set 0 to disable Vault response caching.  Default: 60  -   SUBFILTER\_VALUES\_PER\_GROUP (available since 6.0.5)  Number of subfilter values per group (For example, in the [latest data](/manual/web_interface/frontend_sections/monitoring/latest_data) subfilter).  Default: 1000
ja	#### パラメータ  ユーザーが関心を持つ可能性のあるこのファイルのパラメーター  -   ZBX\_MIN\_PERIOD  最小グラフ期間（秒単位）。デフォルトは1分。  -   GRAPH\_YAXIS\_SIDE\_DEFAULT  単純なグラフのY軸のデフォルトの位置と、カスタムグラフにアイテムを追加するときのドロップダウンボックスのデフォルト値。設定可能な値：0 - 左 1 - 右 デフォルト：0  -   ZBX\_SESSION\_NAME (4.0.0以降で利用可能)  ZabbixフロントエンドセッションのCookie名として使用される文字列。 デフォルト：zbx\_sessionid  -   ZBX\_DATA\_CACHE\_TTL (5.2.0以降で利用可能)  [Vault response](/manual/config/secrets)のデータキャッシュ無効化までのTTLタイムアウト（秒単位）。 Vault response キャッシュを無効にするには、0を設定します。 デフォルト： 60

en-us	### Parameters  `(string/array)` IDs of hosts to return scripts for.
ja	### パラメータ  `(string/array)` スクリプトを返すホストのID

en-us	### Parameters  `(string/array)` Triggers to delete the trigger dependencies from.
ja	### パラメータ  `(string/array)` トリガーの依存関係を削除するトリガー

en-us	#### Parameters  The following parameters are available for this item:  -   **active** - memory currently in use or very recently used, and so     it is in RAM -   **anon** - memory not associated with a file (cannot be re-read from     it) -   **available** - available memory, calculated differently depending     on the platform (see the table below) -   **buffers** - cache for things like file system metadata -   **cached** - cache for various things -   **exec** - executable code, typically from a (program) file -   **file** - cache for contents of recently accessed files -   **free** - memory that is readily available to any entity requesting     memory -   **inactive** - memory that is marked as not used -   **pavailable** - 'available' memory as percentage of 'total'     (calculated as `available`/`total`\*100) -   **pinned** - same as 'wired' -   **pused** - 'used' memory as percentage of 'total' (calculated as     `used`/`total`\*100) -   **shared** - memory that may be simultaneously accessed by multiple     processes -   **slab** - total amount of memory used by the kernel to cache data     structures for its own use -   **total** - total physical memory available -   **used** - used memory, calculated differently depending on the     platform (see the table below) -   **wired** - memory that is marked to always stay in RAM. It is never     moved to disk.  ::: notewarning Some of these parameters are platform-specific and might not be available on your platform. See [Items supported by platform](/manual/appendix/items/supported_by_platform) for details. :::  Platform-specific calculation of **available** and **used**:  |Platform|**"available"**|**"used"**| |--------|---------------|----------| |*AIX*|free + cached|real memory in use| |*FreeBSD*|inactive + cached + free|active + wired + cached| |*HP UX*|free|total - free| |*Linux<3.14*|free + buffers + cached|total - free| |*Linux 3.14+*<br>(also backported to 3.10 on RHEL 7)|/proc/meminfo, see "MemAvailable" in Linux kernel [documentation](https://www.kernel.org/doc/Documentation/filesystems/proc.txt) for details.<br>Note that free + buffers + cached is no longer equal to 'available' due to not all the page cache can be freed and low watermark being used in calculation.|total - free| |*NetBSD*|inactive + execpages + file + free|total - free| |*OpenBSD*|inactive + free + cached|active + wired| |*OSX*|inactive + free|active + wired| |*Solaris*|free|total - free| |*Win32*|free|total - free|  ::: noteimportant The sum of *vm.memory.size\[used\]* and *vm.memory.size\[available\]* does not necessarily equal total. For instance, on FreeBSD:\ \* Active, inactive, wired, cached memories are considered used, because they store some useful information.\ \* At the same time inactive, cached, free memories are considered available, because these kinds of memories can be given instantly to processes that request more memory.\ \ So inactive memory is both used and available simultaneously. Because of this, the *vm.memory.size\[used\]* item is designed for informational purposes only, while *vm.memory.size\[available\]* is designed to be used in triggers. :::
ja	#### パラメーター  このアイテムでは、次のパラメーターを使用できます。  -   **active** - 現在使用されている、または最近使用されたメモリで、RAMにあるもの -   **anon** - ファイルと関係ないメモリ（ファイルから再読み込みできないメモリ） -   **available** - プラットフォーム毎に異なる方法で計算された使用可能なメモリ（下の表を参照） -   **buffers** - ファイルシステムのメタデータのようなもののキャッシュ -   **cached** - さまざまなもののキャッシュ -   **exec** - 実行コード。通常、（プログラム）ファイルから実行されます。 -   **file** - 最近アクセスされたファイルコンテンツのキャッシュ -   **free** - メモリを必要とするどんな項目に対しても使用できるメモリ -   **inactive** - 使用されていないメモリ -   **pavailable** - 'total'に対する'available'メモリのパーセンテージ（`available`/`total`\*100として計算） -   **pinned** - "wired”と同じ。 -   **pused** - "total"に対する"used"メモリのパーセンテージ（"used"/"total"\*100として計算） -   **shared** - 複数のプロセスによって同時にアクセスできるメモリ -   **slab** - カーネルが自身のデータ構造をキャッシュするために使用するメモリの総量 -   **total** - 使用可能な物理メモリの合計 -   **used** - プラットフォーム毎に異なる方法で計算された使用済みメモリ（下の表を参照） -   **wired** - 常にRAMにあると示されているメモリ。このメモリはディスクには移動されません。  ::: notewarning これらのパラメータの一部はプラットフォーム固有であり、ご使用のプラットフォームでは使用できない場合があります。 詳細については、[プラットフォームでサポートされているアイテム](/manual/appendix/items/supported_by_platform)を参照してください。 :::  **available**および**used**のプラットフォーム別計算方法：  |プラットフォーム|**"available"**|**"used"**| |--------|---------------|----------| |*AIX*|free + cached|使用中の実メモリ| |*FreeBSD*|inactive + cached + free|active + wired + cached| |*HP UX*|free|total - free| |*Linux<3.14*|free + buffers + cached|total - free| |*Linux 3.14+*<br>(RHEL7では3.10にもバックポートされています)|/proc/meminfoのMemAvailable値、MemAvailableの詳細についてはLinuxカーネル[ドキュメント](https://www.kernel.org/doc/Documentation/filesystems/proc.txt)を参考ください。<br>free + buffers + cachedはすべてのページキャッシュを解放できず、計算に低ウォーターマークが使用されているため'available'と等しくなくなりました。|total - free| |*NetBSD*|inactive + execpages + file + free|total - free| |*OpenBSD*|inactive + free + cached|active + wired| |*OSX*|inactive + free|active + wired| |*Solaris*|free|total - free| |*Win32*|free|total - free|  ::: noteimportant vm.memory.size\[used\]とvm.memory.size\[available\]の合計はtotalと必ずしも同じではありません。 たとえばFreeBSDの場合、\ \* active、inactive、wired、cachedのメモリは、いくつかの有用な情報を格納しているため、使用済みと見なされます。\ \* 同時に、inactive、cached、free のメモリは、もっとメモリを必要とするプロセスにすぐに使用されるので、使用可能であるとみなされます。\  このように、inactiveメモリはusedと同時にavailableでもあります。このため、vm.memory.size[available]はトリガーで使用されるために設計されていますが、vm.memory.size[used]アイテムは、情報提供の目的のみに設計されています。 :::

en-us	### Parameters  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |extend|boolean|Whether to prolong the user session.<br><br>Default value: "true". Setting the value to "false" allows to check the user session without prolonging it.<br><br>Used if `sessionid` is set.| |sessionid|string|User session ID.<br><br>**Required** if `token` is not set.| |token|string|User [API token](/manual/web_interface/frontend_sections/administration/general#api-tokens).<br><br>**Required** if `sessionid` is not set.|
ja	### パラメータ  このメソッドは、次のパラメーターを受け入れます。  |パラメータ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |extend|boolean|ユーザーセッションを延長するかどうか。<br><br>デフォルト値: "true"。 値を"false"に設定すると、ユーザーセッションを延長せずにセッションを確認できます。<br><br>"sessionid"が設定されている場合に使用されます。| |sessionid|string|ユーザー セッションID<br><br>"token"が設定されていない場合は**必須**| |token|string|ユーザー [APIトークン](/manual/web_interface/frontend_sections/administration/general#api-tokens)<br><br>"sessionid"が設定されていない場合は**必須**|

en-us	#### Parameter - unquoted string  If the key parameter is an unquoted string, any Unicode character is allowed except comma and right square bracket (\]). Unquoted parameter cannot start with left square bracket (\[).  ![](../../../../../assets/en/manual/config/key_param_unquoted_string.png)
ja	#### パラメータ - 二重引用符(")がない文字列  キーパラメータに二重引用符がない文字列の場合、カンマと右大括弧（\]）を除く全てのUnicode文字が使用可能です。 <br> 二重引用符で囲まれていないパラメータで、左大括弧（\[）で始まる文字列は使用できません。 <br>  ![](../../../../../assets/en/manual/config/key_param_unquoted_string.png)

en-us	##### Passive and active checks  Zabbix agents can perform passive and active checks.  In a [passive check](/manual/appendix/items/activepassive#passive_checks) the agent responds to a data request. Zabbix server (or proxy) asks for data, for example, CPU load, and Zabbix agent sends back the result.  [Active checks](/manual/appendix/items/activepassive#active_checks) require more complex processing. The agent must first retrieve a list of items from Zabbix server for independent processing. Then it will periodically send new values to the server.  Whether to perform passive or active checks is configured by selecting the respective monitoring [item type](/manual/config/items/itemtypes/zabbix_agent). Zabbix agent processes items of type 'Zabbix agent' or 'Zabbix agent (active)'.
ja	##### パッシブチェックとアクティブチェック  Zabbixエージェントは、パッシブチェックとアクティブチェックを行うことができます。  [パッシブチェック](/manual/appendix/items/activepassive#passive_checks)では、エージェントはデータの要求に対して応答します。Zabbixサーバー（またはプロキシ）が、例えばCPU負荷のデータを要求すると、Zabbixエージェントが結果を返却します。  [アクティブチェック](/manual/appendix/items/activepassive#active_checks)では、より複雑な処理が求められます。Zabbixエージェントは、独立した処理のために、最初にZabbixサーバーからアイテムのリストを取得します。その後、定期的に新しい値をZabbixサーバーに送信します。  パッシブチェック、アクティブチェックのどちらで動作するかは、それぞれの監視対象の[アイテムのタイプ](/manual/config/items/itemtypes/zabbix_agent)を選択することによって設定されます。Zabbixエージェントは、アイテムの「Zabbixエージェント」または「Zabbixエージェント(アクティブ)」のタイプを処理します。

en-us	#### Passive checks  A passive check is a simple data request. Zabbix server or proxy asks for some data (for example, CPU load) and Zabbix agent sends back the result to the server.  **Server request**  For definition of header and data length please refer to [protocol details](/manual/appendix/protocols/header_datalen).      <item key>  **Agent response**      <DATA>[\0<ERROR>]  Above, the part in square brackets is optional and is only sent for not supported items.  For example, for supported items:  1.  Server opens a TCP connection 2.  Server sends **<HEADER><DATALEN>agent.ping** 3.  Agent reads the request and responds with     **<HEADER><DATALEN>1** 4.  Server processes data to get the value, '1' in our case 5.  TCP connection is closed  For not supported items:  1.  Server opens a TCP connection 2.  Server sends **<HEADER><DATALEN>vfs.fs.size\[/nono\]** 3.  Agent reads the request and responds with     **<HEADER><DATALEN>ZBX\_NOTSUPPORTED\\0Cannot obtain     filesystem information: \[2\] No such file or directory** 4.  Server processes data, changes item state to not supported with the     specified error message 5.  TCP connection is closed
ja	#### パッシブチェック  パッシブチェックは単純なデータリクエストです。 Zabbixサーバーまたはプロキシがデータ（CPU負荷など）を要求し、Zabbixエージェントがデータをサーバーに送り返します。  **サーバーリクエスト**  ヘッダーとデータ長の定義については、[プロトコルの詳細](/manual/appendix/protocols/header_datalen)を参照してください。      <item key>  **エージェントの応答**      <DATA>[\0<ERROR>]  上記の角括弧内の部分はオプションであり、サポートされていないアイテムに対してのみ送信されます。  サポートされているアイテムの場合：  1.  サーバーがTCP接続を開きます 2.  サーバーが**<HEADER><DATALEN>agent.ping**を送信します 3.  エージェントはリクエストを読み取り、**<HEADER><DATALEN>1**で応答します 4.  サーバーはデータを処理して値を取得します。今回の場合は"1"です。 5.  TCP接続が閉じられます  サポートされていないアイテムの場合：  1.  サーバーがTCP接続を開きます 2.  サーバーは**<HEADER><DATALEN>vfs.fs.size\[/nono\]**を送信します 3.  エージェントはリクエストを読み取り、次のレスポンスを返します。**<HEADER><DATALEN>ZBX\_NOTSUPPORTED\\0Cannot obtain filesystem information: \[2\] No such file or directory** 4.  サーバーはデータを処理し、アイテムの状態をサポートされていない状態に変更し、指定されたエラーメッセージを表示します 5.  TCP接続が閉じられます

en-us	#### Passive proxy
ja	#### パッシブプロキシ

en-us	##### Passphrase authentication  SSH checks provide two authentication methods, a user/password pair and key-file based.  If you do not intend to use keys, no additional configuration is required, besides linking libssh2/libssh to Zabbix, if you're building from source.
ja	##### パスフレーズ認証  SSHチェックには、ユーザ/パスワードペアとキーファイルベースの2つの認証方法があります。  鍵を使用しない場合、ソースからビルドする場合は、libssh2/libsshをZabbixにリンクする以外に、追加の設定は必要ありません。

en-us	#### Password requirements  Custom password complexity requirements can now be provided for Zabbix internal [authentication method](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication). To prevent Zabbix users from setting weak passwords, it is possible to enforce the following restrictions:  -   Set the minimum password length. -   Require a password to contain a combination of uppercase and     lowercase letters, digits, and/or special characters. -   Prohibit usage of most common and easily guessable passwords.
ja	#### パスワードの要件  Zabbixのパスワードの複雑さの要件を内部[認証方法](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication) で指定できるようになりました。Zabbixユーザが脆弱なパスワードを設定することを防ぐため、以下のような制限をかけることができます：  - パスワードの最小の長さを設定する。 - パスワードには、大文字と小文字、数字、特殊文字を組み合わせたものを要求する。大文字、小文字、数字、特殊文字を含むパスワードを設定する。 - 最も一般的で容易に推測可能なパスワードの使用を禁止する。

en-us	 #### PCRE2 support Support for PCRE2 has been added and Zabbix installation packages for RHEL 7 and newer, SLES (all versions), Debian 9 and newer, Ubuntu 16.04 and newer have been updated to use PCRE2. PCRE is still supported, but Zabbix can only be compiled with one of the libraries PCRE or PCRE2, both cannot be used at the same time.
ja	 #### PCRE2のサポート RHEL 7以降、SLES(全バージョン)、Debian 9以降、Ubuntu 16.04以降のZabbixインストールパッケージがPCRE2のサポートが追加されました。 PCREは引き続きサポートされていますが、ZabbixはPCREまたはPCRE2のどちらか一方のライブラリでコンパイルする必要があり、両方を同時に使用することはできません。

en-us	 ##### PCRE2 support Support for PCRE2 has been added. PCRE is still supported, but Zabbix can only be compiled with one of the libraries PCRE or PCRE2, both cannot be used at the same time.   The following Zabbix installation packages have been updated and now use PCRE2:  - RHEL 7 and newer - SLES (all versions) - Debian 9 and newer - Ubuntu 16.04 and newer  Please note that after switching to PCRE2, you may need to update some regular expressions. In particular, the pattern  ```^[\w-\.]``` needs to be changed to ```^[-\\w\\.]```  to continue working correctly - see [Known issues](/manual/installation/known_issues#invalid-regular-expressions-after-switching-to-pcre2) for a more detailed explanation.
ja	 ##### PCRE2のサポート PCRE2のサポートが追加されました。PCREは引き続きサポートされていますが、Zabbixは、PCREまたはPCRE2のどちらかのライブラリを使ってコンパイルすることができ、両方を同時に使用することはできません。   以下のZabbixのインストールパッケージが更新され、PCRE2が使用できるようになりました：  - RHEL 7以降 - SLES (すべてのバージョン) - Debian 9以降 - Ubuntu 16.04以降  PCRE2に移行後、いくつかの正規表現を更新する必要があることに注意してください。特にパターン ```^[\w-\.]``` は ```^[-\\w\\.]```  に変更しないと正常に機能しません - 詳細は[既知の問題点](/manual/installation/known_issues#invalid-regular-expressions-after-switching-to-pcre2)を確認してください。 

en-us	 #### PCRE2 support Support for PCRE2 has been added. PCRE is still supported, but Zabbix can only be compiled with one of the libraries PCRE or PCRE2, both cannot be used at the same time.   The following Zabbix installation packages have been updated and now use PCRE2: - RHEL/CentOS 7 and newer - SLES (all versions) - Debian 9 and newer - Ubuntu 16.04 and newer  Please note that after switching to PCRE2, you may need to update some regular expressions. In particular, the pattern ^[\w-\.] needs to be changed to ^[-\w\.] to continue working  correctly - see [Known issues](manual/installation/known_issues#invalid_regular_expressions_after_switching_to_pcre2) for a more detailed explanation.   
ja	 #### PCRE2 support Support for PCRE2 has been added and all Zabbix installation packages have been updated to use PCRE2. PCRE is still supported, but Zabbix can only be compiled with one of the libraries PCRE or PCRE2, both cannot be used at the same time.  Please note that after switching to PCRE2, you may need to update some regular expressions. In particular, the pattern ^[\w-\.] needs to be changed to ^[-\w\.] to continue working  correctly - see [Known issues](manual/installation/known_issues#invalid_regular_expressions_after_switching_to_pcre2) for a more detailed explanation.   

en-us	 #### PCRE2 support  Zabbix now supports both PCRE and PCRE2. Zabbix packages for RHEL 7 and newer, SLES (all versions), Debian 9 and newer, Ubuntu 16.04 and newer have been updated to compile with PCRE2 instead of PCRE. When compiling from sources, users can choose to specify ''--with-libpcre'' or ''--with-libpcre2'' flag. If you are upgrading an existing installation, changing PCRE to PCRE2 may lead to some regular expressions behaving differently - see [Known issues](/manual/installation/known_issues#invalid-regular-expressions-after-switching-to-pcre2) for details.
ja	 #### PCRE2サポート  ZabixはPCREとPCRE2の両方をサポートするようになりました。 RHEL 7以降、SLES(全バージョン)、Debian 9以降、Ubuntu 16.04以降のZabbixパッケージは、PCREの代わりにPCRE2でコンパイルするように更新されました。 ソースからコンパイルする場合、ユーザーは ''--with-libpcre'' または ''--with-libpcre2'' フラグを選択することができます。 既存のインストールをアップグレードする場合、PCRE を PCRE2 に変更すると、いくつかの正規表現の動作が変わることがあります。 詳細については、[既知の問題点](/manual/installation/known_issues#invalid-regular-expressions-after-switching-to-pcre2) を参照してください。

en-us	#### Performance counter parameters  You can deploy some PerfCounter parameters for the monitoring of Windows performance counters.  For example, you can add these to the Zabbix agent configuration file:         PerfCounter=UserPerfCounter1,"\Memory\Page Reads/sec",30        or        PerfCounter=UserPerfCounter2,"\4\24",30  With such parameters in place, you can then simply use *UserPerfCounter1* or *UserPerfCounter2* as the keys for creating the respective items.  Remember to restart Zabbix agent after making changes to the configuration file.
ja	#### パフォーマンスカウンタパラメーター  Windowsのパフォーマンスカウンタを監視するために、いくつかのPerfCounterパラメータを導入することができます。  例えば、Zabbixエージェント設定ファイルに以下を追加することができます。         PerfCounter=UserPerfCounter1,"\Memory\Page Reads/sec",30        または        PerfCounter=UserPerfCounter2,"\4\24",30  このようなパラメータを設定すると、それぞれの item を作成するためのキーとして *UserPerfCounter1* または *UserPerfCounter2* を<br> 使用するだけでよくなります。  設定ファイルを変更した後は、Zabbixエージェントを再起動することを忘れないでください。

en-us	#### Performance  Using some internal items may negatively affect performance. These items are:  -   `zabbix[host,,items]` -   `zabbix[host,,items_unsupported]` -   `zabbix[hosts]` -   `zabbix[items]` -   `zabbix[items_unsupported]` -   `zabbix[queue]` -   `zabbix[required_performance]` -   `zabbix[stats,,,queue]` -   `zabbix[triggers]`  The [System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix) and [Queue](/manual/web_interface/frontend_sections/administration/queue)  frontend sections are also affected.
ja	#### パフォーマンス  いくつかの内部チェックアイテムを使用すると、パフォーマンスに悪影響を及ぼす可能性があります。そのアイテムは以下の通り:  -   `zabbix[host,,items]` -   `zabbix[host,,items_unsupported]` -   `zabbix[hosts]` -   `zabbix[items]` -   `zabbix[items_unsupported]` -   `zabbix[queue]` -   `zabbix[required_performance]` -   `zabbix[stats,,,queue]` -   `zabbix[triggers]`  The [システム情報](/manual/web_interface/frontend_sections/reports/status_of_zabbix) と [キュー](/manual/web_interface/frontend_sections/administration/queue) のWebインターフェースも影響を受けます。

en-us	### Performing requests  Once you've set up the frontend, you can use remote HTTP requests to call the API. To do that you need to send HTTP POST requests to the `api_jsonrpc.php` file located in the frontend directory. For example, if your Zabbix frontend is installed under *http://example.com/zabbix*, the HTTP request to call the `apiinfo.version` method may look like this:  ```yaml POST http://example.com/zabbix/api_jsonrpc.php HTTP/1.1 Content-Type: application/json-rpc  {     "jsonrpc": "2.0",     "method": "apiinfo.version",     "id": 1,     "auth": null,     "params": {} } ```  The request must have the `Content-Type` header set to one of these values: `application/json-rpc`, `application/json` or `application/jsonrequest`.
ja	### リクエストの実行  フロントエンドを設定したら、リモートHTTPリクエストを使用してAPIを呼び出すことができます。 これを行うには、フロントエンドディレクトリにある`api_jsonrpc.php`ファイルにHTTP POSTリクエストを送信する必要があります。 たとえば、Zabbixフロントエンドが *http://example.com/zabbix* にインストールされている場合、`apiinfo.version`メソッドを呼び出すHTTPリクエストは次のようになります。  ```yaml POST http://example.com/zabbix/api_jsonrpc.php HTTP/1.1 Content-Type: application/json-rpc  { "jsonrpc": "2.0", "method": "apiinfo.version", "id": 1, "auth": null, "params": {} } ```  リクエストの`Content-Type`ヘッダーは、`application/json-rpc`、`application/json`または`application/jsonrequest`のいずれかの値に設定されている必要があります。

en-us	**Permissions**  Flexible permissions to services have been implemented on [user role](/manual/web_interface/frontend_sections/administration/user_roles) level. Read-write or read-only access can be granted to all, none or selected services (based on name or tags).
ja	**サービスのパーミッション設定**  サービスに対する柔軟なパーミッションが[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)の レベルで実装されました。(サービス名やタグに基づいて)選択されたサービスに対して、読み書きまたは読み取り専用アクセス権限を与えることができます。

en-us	#### Permissions  The *Permissions* tab contains information on:  -   The user role. Users cannot change their own role. -   The user type (User, Admin, Super Admin) that is defined in the role     configuration. -   Host groups the user has access to. Users of type 'User' and 'Admin'     do not have access to any host groups and hosts by default. To get     the access they need to be included in user groups that have access     to respective host groups and hosts. -   Access rights to sections and elements of Zabbix frontend, modules,     and API methods. Elements to which access is allowed are displayed     in green color. Light gray color means that access to the element is     denied. -   Rights to perform certain actions. Actions that are allowed are     displayed in green color. Light gray color means that a user does     not have the rights to perform this action.  See the [User permissions](permissions) page for details.
ja	#### アクセス権  パーミッション*タブには、以下の情報が含まれています:  -   ユーザーロール。ユーザーは自分のロールを変更することはできません。 -   ロール設定で定義されたユーザータイプ（User、Admin、Super Admin） -   そのユーザーがアクセスできるホストグループ。タイプ 'User' および 'Admin' のユーザーは、デフォルトではどのホストグループおよび     ホストへのアクセス権も持っていません。アクセス権を得るには、それぞれのホストグループおよびホストへのアクセス権を持つ     ユーザグループに含まれる必要があります。 -   Zabbixフロントエンド、モジュール、APIメソッドのセクションとエレメントへのアクセス権。アクセスが許可されているエレメントは     緑色で表示されます。薄い灰色は、その要素へのアクセスが拒否されていることを意味します。 -   特定のアクションを実行する権利。許可されているアクションは、緑色で表示されます。薄い灰色は、ユーザーがそのアクションを実行する     権利を持っていないことを意味します。  詳しくは、[ユーザ権限](permissions) のページをご覧ください。

en-us	#### Permissions to dashboards  Permissions to dashboards for regular users and users of 'Admin' type are limited in the following way:  -   They can see and clone a dashboard if they have at least READ rights     to it; -   They can edit and delete dashboard only if they have READ/WRITE     rights to it; -   They cannot change the dashboard owner.
ja	#### ダッシュボードへのアクセス許可  通常のユーザーおよび'管理者'タイプのユーザーのダッシュボードへのアクセス許可は、次のように制限されます。  -   ダッシュボードに対する読み取り権限が少なくともある場合は、ダッシュボードを表示して複製できます。 -   ダッシュボードに対する読み取り/書き込み権限がある場合にのみ、ダッシュボードを編集および削除できます。 -   ダッシュボードの所有者を変更することはできません。

en-us	#### Permissions to host groups  Access to any host data in Zabbix is granted to [user groups](/manual/config/users_and_usergroups/usergroup) on the host group level only.  That means that an individual user cannot be directly granted access to a host (or host group). It can only be granted access to a host by being part of a user group that is granted access to the host group that contains the host.
ja	#### ホストグループへのパーミッション  Zabbixのホストに紐づくデータへのアクセスは、ホストグループ単位に[ユーザーグループ](/manual/config/users_and_usergroups/usergroup)毎に許可されます。  つまり、個々のユーザが直接ホスト(またはホストグループ)へのアクセスを許可されることはありません。ホストを含​​むホストグループへのアクセスを許可されているユーザーグループに所属することによってのみ、ホストへのアクセスを許可できます。

en-us	### Permission  The permission object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**id**<br>(required)|string|ID of the host group to add permission to.| |**permission**<br>(required)|integer|Access level to the host group.<br><br>Possible values:<br>0 - access denied;<br>2 - read-only access;<br>3 - read-write access.|
ja	### Permission  permission オブジェクトには次のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**id**<br>(必須)|string|アクセス許可を追加するホストグループのID| |**permission**<br>(必須)|integer|ホストグループへのアクセスレベル<br><br>可能な値：<br>0 - アクセス拒否<br>2  - 読み取り専用<br>3 - 読み取り/書き込み可|

en-us	#### PHP 7.2  Zabbix frontend requires PHP version **7.2 or newer**.
ja	#### PHP 7.2  Zabbixフロントエンドの動作には、PHPバージョン **7.2以降** が必要です。

en-us	#### PHP 7.2  Zabbix frontend requires PHP version **7.2 or newer**.
ja	#### PHP 7.2  ZabbixのWebインターフェースの動作には、**7.2.5以降**が必要です。

en-us	#### PHP 7.2  Zabbix frontend requires PHP version **7.2 or newer** starting with Zabbix 5.0.  See [instructions](/manual/installation/frontend/frontend_on_debian) for installing Zabbix frontend on distributions with PHP versions below 7.2.
ja	#### PHP 7.2  Zabbix 5.0 以降のフロントエンドには、PHP バージョン **7.2 以降** が必要です。  PHP バージョン 7.2 未満のディストリビューションに Zabbix フロントエンドをインストールするには、[手順](/manual/installation/frontend/frontend_on_debian) を参照してください。

en-us	#### PHP 7.3 opcache configuration  If "opcache" is enabled in the PHP 7.3 configuration, Zabbix frontend may show a blank screen when loaded for the first time. This is a registered [PHP bug](https://bugs.php.net/bug.php?id=78015). To work around this, please set the "opcache.optimization\_level" parameter to `0x7FFFBFDF` in the PHP configuration (php.ini file).
ja	#### PHP 7.3のopcacheの設定  PHP 7.3の設定で "opcache" が有効な場合、ZabbixのWebインターフェースを初めて読み込んだときに、 <br> 空白の画面が表示されることがあります。これは登録された[PHP bug](https://bugs.php.net/bug.php?id=78015)です。 <br> この問題を回避するには、php.ini の opcache.optimization_levelパラメータを`0x7FFFBFDF`に設定してください。 <br>

en-us	 ### PHP 8 support  PHP 8.0 and 8.1 is now supported.
ja	### PHP 8 のサポート  PHP 8.0 および 8.1 がサポートされるようになりました。

en-us	### PHP support  The maximum supported version for PHP is now 8.2.
ja	### PHPのサポート  PHPのサポートバージョンとして8.2までをサポート。

en-us	#### PHP support  The maximum supported version for PHP is now 8.3.
ja	#### PHPのサポート  PHPのサポートバージョンが8.3までになりました。

en-us	## Platforms
ja	## プラットフォーム

en-us	## Plugins
ja	## プラグイン

en-us	## Plugins
ja	## プラグイン

en-us	## Plugins
ja	## プラグイン

en-us	## Plugins
ja	## プラグイン

en-us	## Plugins
ja	## プラグイン

en-us	#### Plugins  All metrics supported by Zabbix agent 2 are collected by plugins.
ja	#### プラグイン  Zabbix agent 2 でサポートされているすべてのメトリックは、プラグインによって収集されます。

en-us	#### Positional macros no longer supported  The support for positional macros in item name ($1, $2...$9), deprecated since Zabbix 4.0, has been fully removed.
ja	#### 位置指定マクロはサポートされなくなりました  アイテム名の位置指定マクロ($1, $2...$9)のサポートはZabbix 4.0から非推奨となり、完全に削除されました。

en-us	##### Positional macros no longer supported  The support for positional macros in item name ($1, $2...$9), deprecated since Zabbix 4.0, has been fully removed.
ja	##### 位置指定マクロはサポートされなくなりました  アイテム名の位置指定マクロ($1, $2...$9)のサポートはZabbix 4.0から非推奨となり、完全に削除されました。

en-us	 #### Possible deadlocks with MySQL/MariaDB  When running under high load, and with more than one LLD worker involved, it is possible to run into a deadlock caused by an  InnoDB error related to the row-locking strategy (see [upstream bug](https://github.com/mysql/mysql-server/commit/7037a0bdc83196755a3bf3e935cfb3c0127715d5)).  The error has been fixed in MySQL since 8.0.29, but not in MariaDB. For more details, see [ZBX-21506](https://support.zabbix.com/browse/ZBX-21506).
ja	 #### MySQL/MariaDBでのデッドロックの可能性  負荷が高く、複数のLLD処理が実行されている場合、行ロック処理に関するInnoDBエラーが原因でデッドロックが発生する可能性があります。（[upstream bug](https://github.com/mysql/mysql-server/commit/7037a0bdc83196755a3bf3e935cfb3c0127715d5)参照）  このエラーは、MySQL 8.0.29で修正されましたが、MariaDBでは修正されていません。詳細は、[ZBX-21506](https://support.zabbix.com/browse/ZBX-21506)を参照してください。

en-us	##### Possible error messages  You may encounter a situation when no data is displayed and the following error message appears:  ![](../../../../../assets/en/manual/web_interface/error_message_1.png){width="600"}  Error message in this case is the following:      Cannot display item queue. Permission denied  This happens when PHP configuration parameters $ZBX\_SERVER\_PORT or $ZBX\_SERVER in zabbix.conf.php point to existing Zabbix server which uses different database.
ja	##### 表示可能性のあるエラーメッセージ  データが表示されず、次のエラーメッセージが表示される場合があります。  ![](../../../../../assets/en/manual/web_interface/error_message_1.png){width="600"}  この場合のエラーメッセージは次のとおりです。      Cannot display item queue. Permission denied  これは、zabbix.conf.phpのPHP構成パラメーター$ZBX\_SERVER\_PORTまたは$ZBX\_SERVERが、異なるデータベースを使用する既存のZabbixサーバーを指している場合に発生します。

en-us	 ### Possible to build Zabbix agent 2 offline  Zabbix agent 2 now can be built offline. The source tarball now includes the `src/go/vendor` directory, which should make sure  that golang is not forced to download dependency modules automatically. It is still possible to update to the latest modules manually by using `go mod tidy` or `go get` commands.
ja	 ### Zabbixエージェント2をオフラインでビルド可能  Zabbixエージェント2をオフラインでビルドすることができます。ソースのtarball内に`src/go/vendor`ディレクトリが含まれるようになりました。golangは依存モジュールを自動的にダウンロードする必要がありません。`go mod tidy`か`go get`コマンドを使用することで最新のモジュールにアップデートすることができます。

en-us	 ### PostgreSQL 15 support  PostgreSQL 15 is now supported. Note that TimescaleDB **does not** support PostgreSQL 15 yet.
ja	 ### PostgreSQL 15 対応  PostgreSQL 15に対応しました。ただし、TimescaleDBはまだPostgreSQL 15をサポートして**いません**。 

en-us	 [PostgreSQL Agent 2 template](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent2?at=refs%2Fheads%2Frelease%2F5.0) has been updated:  A trigger for detecting checksum failures has been added to the Dbstat item of the PostgreSQL Agent 2 template. According to [PostgreSQL documentation](https://www.postgresql.org/docs/), you can use checksums on data pages to help detect corruption by the I/O system that would otherwise be silent.
ja	 [PostgreSQL Agent 2 template](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent2?at=refs%2Fheads%2Frelease%2F5.0)が更新されました。  PostgreSQL Agent 2 テンプレートのDbstatアイテムにチェックサム失敗を検出するトリガーが追加されました。 [PostgreSQLドキュメント](https://www.postgresql.org/docs/)によると、データページでチェックサムを使用すると、通常はサイレントになるI/Oシステムによる破損を検出するのに役立ちます。

en-us	#### PostgreSQL  Export and import must be performed in tmux/screen, so that the session isn't dropped.  ##### Upgrading tables  * Rename tables using `history_pk_prepare.sql`.  ``` sudo -u zabbix psql zabbix < /usr/share/doc/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ```  * Export current history, import it to the temp table,  and insert it into new tables while ignoring duplicates  ``` \copy history_old TO '/tmp/history.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history (  itemid                   bigint                                    NOT NULL,  clock                    integer         DEFAULT '0'               NOT NULL,  value                    DOUBLE PRECISION DEFAULT '0.0000'          NOT NULL,  ns                       integer         DEFAULT '0'               NOT NULL ); \copy temp_history FROM '/tmp/history.csv' DELIMITER ',' CSV INSERT INTO history_uint SELECT * FROM temp_history ON CONFLICT (itemid,clock,ns) DO NOTHING;  \copy history_uint_old TO '/tmp/history_uint.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_uint (  itemid                   bigint                                    NOT NULL,  clock                    integer         DEFAULT '0'               NOT NULL,  value                    numeric(20)     DEFAULT '0'               NOT NULL,  ns                       integer         DEFAULT '0'               NOT NULL ); \copy temp_history_uint FROM '/tmp/history_uint.csv' DELIMITER ',' CSV INSERT INTO history_uint SELECT * FROM temp_history_uint ON CONFLICT (itemid,clock,ns) DO NOTHING;  \copy history_str_old TO '/tmp/history_str.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_str (  itemid                   bigint                                    NOT NULL,  clock                    integer         DEFAULT '0'               NOT NULL,  value                    varchar(255)    DEFAULT ''                NOT NULL,  ns                       integer         DEFAULT '0'               NOT NULL ); \copy temp_history_str FROM '/tmp/history_str.csv' DELIMITER ',' CSV INSERT INTO history_str (itemid,clock,value,ns) SELECT * FROM temp_history_str ON CONFLICT (itemid,clock,ns) DO NOTHING;  \copy history_log_old TO '/tmp/history_log.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_log (  itemid                   bigint                                    NOT NULL,  clock                    integer         DEFAULT '0'               NOT NULL,  timestamp                integer         DEFAULT '0'               NOT NULL,  source                   varchar(64)     DEFAULT ''                NOT NULL,  severity                 integer         DEFAULT '0'               NOT NULL,  value                    text            DEFAULT ''                NOT NULL,  logeventid               integer         DEFAULT '0'               NOT NULL,  ns                       integer         DEFAULT '0'               NOT NULL ); \copy temp_history_log FROM '/tmp/history_log.csv' DELIMITER ',' CSV INSERT INTO history_log SELECT * FROM temp_history_log ON CONFLICT (itemid,clock,ns) DO NOTHING;  \copy history_text_old TO '/tmp/history_text.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_text (  itemid                   bigint                                    NOT NULL,  clock                    integer         DEFAULT '0'               NOT NULL,  value                    text            DEFAULT ''                NOT NULL,  ns                       integer         DEFAULT '0'               NOT NULL ); \copy temp_history_text FROM '/tmp/history_text.csv' DELIMITER ',' CSV INSERT INTO history_text SELECT * FROM temp_history_text ON CONFLICT (itemid,clock,ns) DO NOTHING; ```  * Verify that everything works as supposed  * Drop old tables  ``` DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ```  Consider using the following tips to improve insert performance:  * [PostgreSQL: Bulk Loading Huge Amounts of Data](https://www.cybertec-postgresql.com/en/postgresql-bulk-loading-huge-amounts-of-data) * [Checkpoint Distance and Amount of WAL](https://www.cybertec-postgresql.com/en/checkpoint-distance-and-amount-of-wal)  
ja	#### PostgreSQL  Export and import must be performed in tmux/screen, so that the session isn't dropped.  ##### Upgrading tables  * Rename tables using [history_pk_prepare.sql](https://git.zabbix.com/projects/ZBX/repos/zabbix/commits/f3b9848e458867c5b834e4f299944e8e90eb0d37)  * Export current history, import it to the temp table,  and insert it into new tables while ignoring duplicates  ``` \copy history_old TO '/tmp/history.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history (  itemid                   bigint                                    NOT NULL,  clock                    integer         DEFAULT '0'               NOT NULL,  value                    DOUBLE PRECISION DEFAULT '0.0000'          NOT NULL,  ns                       integer         DEFAULT '0'               NOT NULL ); \copy temp_history FROM '/tmp/history.csv' DELIMITER ',' CSV INSERT INTO history_uint SELECT * FROM temp_history ON CONFLICT (itemid,clock,ns) DO NOTHING;  \copy history_uint_old TO '/tmp/history_uint.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_uint (  itemid                   bigint                                    NOT NULL,  clock                    integer         DEFAULT '0'               NOT NULL,  value                    numeric(20)     DEFAULT '0'               NOT NULL,  ns                       integer         DEFAULT '0'               NOT NULL ); \copy temp_history_uint FROM '/tmp/history_uint.csv' DELIMITER ',' CSV INSERT INTO history_uint SELECT * FROM temp_history_uint ON CONFLICT (itemid,clock,ns) DO NOTHING;  \copy history_str_old TO '/tmp/history_str.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_str (  itemid                   bigint                                    NOT NULL,  clock                    integer         DEFAULT '0'               NOT NULL,  value                    varchar(255)    DEFAULT ''                NOT NULL,  ns                       integer         DEFAULT '0'               NOT NULL ); \copy temp_history_str FROM '/tmp/history_str.csv' DELIMITER ',' CSV INSERT INTO history_str (itemid,clock,value,ns) SELECT * FROM temp_history_str ON CONFLICT (itemid,clock,ns) DO NOTHING;  \copy history_log_old TO '/tmp/history_log.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_log (  itemid                   bigint                                    NOT NULL,  clock                    integer         DEFAULT '0'               NOT NULL,  timestamp                integer         DEFAULT '0'               NOT NULL,  source                   varchar(64)     DEFAULT ''                NOT NULL,  severity                 integer         DEFAULT '0'               NOT NULL,  value                    text            DEFAULT ''                NOT NULL,  logeventid               integer         DEFAULT '0'               NOT NULL,  ns                       integer         DEFAULT '0'               NOT NULL ); \copy temp_history_log FROM '/tmp/history_log.csv' DELIMITER ',' CSV INSERT INTO history_log SELECT * FROM temp_history_log ON CONFLICT (itemid,clock,ns) DO NOTHING;  \copy history_text_old TO '/tmp/history_text.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_text (  itemid                   bigint                                    NOT NULL,  clock                    integer         DEFAULT '0'               NOT NULL,  value                    text            DEFAULT ''                NOT NULL,  ns                       integer         DEFAULT '0'               NOT NULL ); \copy temp_history_text FROM '/tmp/history_text.csv' DELIMITER ',' CSV INSERT INTO history_text SELECT * FROM temp_history_text ON CONFLICT (itemid,clock,ns) DO NOTHING; ```  * Verify that everything works as supposed  * Drop old tables  ``` DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ```  Consider using the following tips to improve insert performance:  * [PostgreSQL: Bulk Loading Huge Amounts of Data](https://www.cybertec-postgresql.com/en/postgresql-bulk-loading-huge-amounts-of-data) * [Checkpoint Distance and Amount of WAL](https://www.cybertec-postgresql.com/en/checkpoint-distance-and-amount-of-wal)  

en-us	### PostgreSQL  Export and import must be performed in tmux/screen to ensure that the session isn't dropped. For installations with TimescaleDB, skip this section and proceed to [PostgreSQL + TimescaleDB](#postgresql-timescaledb-v2xv1x).  See also: [Important notes](#important-notes)  #### Table upgrade  * Rename tables using `history_pk_prepare.sql`:  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ```  #### Migration with stopped server  * Export current history, import it to the temp table,  then insert the data into new tables while ignoring duplicates:  ``` {.sql} INSERT INTO history SELECT * FROM history_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_uint SELECT * FROM history_uint_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_str SELECT * FROM history_str_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_log SELECT * FROM history_log_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_text SELECT * FROM history_text_old ON CONFLICT (itemid,clock,ns) DO NOTHING; ```  See tips for improving INSERT performance: [PostgreSQL: Bulk Loading Huge Amounts of Data](https://www.cybertec-postgresql.com/en/postgresql-bulk-loading-huge-amounts-of-data), [Checkpoint Distance and Amount of WAL](https://www.cybertec-postgresql.com/en/checkpoint-distance-and-amount-of-wal).  * Follow [post-migration instructions](#after-migration) to drop the old tables.
ja	### PostgreSQL  セッションがドロップされないように、エクスポートとインポートは tmux/screen で実行する必要があります。 TimescaleDB を使用してインストールする場合は、このセクションをスキップして [PostgreSQL + TimescaleDB](#postgresql-timescaledb-v2xv1x) に進んでください。  参照：[重要事項](#important-notes)  #### テーブルのアップグレード  * `history_pk_prepare.sql` を使用してテーブルの名前を変更します。  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ```  #### 停止したサーバーでの移行  * 現在の履歴をエクスポートして一時テーブルにインポートし、新しいテーブルにデータを重複を無視して挿入します。  ``` {.sql} INSERT INTO history SELECT * FROM history_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_uint SELECT * FROM history_uint_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_str SELECT * FROM history_str_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_log SELECT * FROM history_log_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_text SELECT * FROM history_text_old ON CONFLICT (itemid,clock,ns) DO NOTHING; ```  INSERT パフォーマンスを改善するためのヒントを参照してください: [PostgreSQL: 膨大な量のデータの一括読み込み](https://www.cybertec-postgresql.com/en/postgresql-bulk-loading-huge-amounts-of-data)、[チェックポイント距離 および WAL の量](https://www.cybertec-postgresql.com/en/checkpoint-distance-and-amount-of-wal)。  * [移行後の手順](#after-migration) に従って、古いテーブルを削除します。

en-us	#### PostgreSQL  If a value contains a non-ASCII character in non UTF8 encoding - this will lead to a failed SQL query (PGRES\_FATAL\_ERROR:ERROR invalid byte sequence for encoding) and data will not be stored. An appropriate warning message will be written to the *zabbix\_server.log*.\ Relevant for at least PostgreSQL version 9.1.3
ja	#### PostgreSQL  少なくともPostgreSQLバージョン9.1.3では、値に非UTF8エンコーディングの非ASCII文字が含まれている場合、SQLクエリが失敗し(PGRES\_FATAL\_ERROR:ERROR invalid byte sequence for encoding)データは保存されません。 適切な警告メッセージが*zabbix\_server.log*に書き込まれます。

en-us	 ### PostgreSQL  |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |pgsql.autovacuum.count\[uri,<username>,<password>,<dbName>\]|<|<|<| |The number of autovacuum workers.|Integer |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.| | |pgsql.archive\[uri,<username>,<password>,<dbName>\]|<|<|<| |Information about archived files.|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|| |pgsql.bgwriter\[uri,<username>,<password>,<dbName>\]|<|<|<| |Combined number of checkpoints for the database cluster, broken down by checkpoint type.|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|| |pgsql.cache.hit\[uri,<username>,<password>,<dbName>\]|<|<|<| |PostgreSQL buffer cache hit rate.|Float |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.| | |pgsql.connections\[uri,<username>,<password>,<dbName>\]|<|<|<| |Connections by type.|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|| |pgsql.custom.query\[uri,<username>,<password>,queryName,<args...>\]|<|<|<| |Returns result of a custom query.|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**queryName** - name of a custom query, must match SQL file name without an extension. <br> **args** - one or several comma-separated arguments to pass to a query. | | |pgsql.dbstat\[uri,<username>,<password>,dbName\]|<|<|<| |Collects statistics per database. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|| |pgsql.dbstat.sum\[uri,<username>,<password>,<dbName>\]|<|<|<| |Summarized data for all databases in a cluster.|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|| |pgsql.db.age\[uri,<username>,<password>,dbName\]|<|<|<| |Age of the oldest FrozenXID of the database.|Integer |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.| | |pgsql.db.bloating\_tables\[uri,<username>,<password>,<dbName>\]|<|<|<| |The number of bloating tables per database.|Integer |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.| | |pgsql.db.discovery\[uri,<username>,<password>,<dbName>\]|<|<|<| |List of the PostgreSQL databases. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.| | |pgsql.db.size\[uri,<username>,<password>,dbName\]|<|<|<| |Database size in bytes.|Integer |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.| | |pgsql.locks\[uri,<username>,<password>,<dbName>\]|<|<|<| |Information about granted locks per database. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|| |pgsql.oldest.xid\[uri,<username>,<password>,<dbName>\]|<|<|<| |Age of the oldest XID.|Integer |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.| | |pgsql.ping\[uri,<username>,<password>,<dbName>\]|<|<|<| |Tests whether a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues).|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.| | |pgsql.queries\[uri,<username>,<password>,<dbName>,timePeriod\]|<|<|<| |Measures query execution time.|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.<br>**timePeriod** - execution time limit for count of slow queries (must be a positive integer).|This item is supported since Zabbix 6.0.3| |pgsql.replication.count\[uri,<username>,<password>\]|<|<|<| |The number of standby servers.|Integer |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.| | |pgsql.replication.process\[uri,<username>,<password>\]|<|<|<| | Flush lag, write lag and replay lag per each sender process.|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.| | |pgsql.replication.process.discovery\[uri,<username>,<password>\]|<|<|<| | Replication process name discovery.|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.| | |pgsql.replication.recovery\_role\[uri,<username>,<password>\]|<|<|<| |Recovery status.|0 - master mode<br>1 - recovery is still in progress (standby mode)|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.| | |pgsql.replication.status\[uri,<username>,<password>\]|<|<|<| |The status of replication.|0 - streaming is down<br>1 - streaming is up<br>2 - master mode|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.| | |pgsql.replication\_lag.b\[uri,<username>,<password>\]|<|<|<| |Replication lag in bytes.|Integer |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.| | |pgsql.replication\_lag.sec\[uri,<username>,<password>\]|<|<|<| |Replication lag in seconds.|Integer |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.| | |pgsql.uptime\[uri,<username>,<password>,<dbName>\]|<|<|<| |PostgreSQL uptime in milliseconds.|Float |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.| | |pgsql.version\[uri,<username>,<password>,<dbName>\]|<|<|<| |Returns PostgreSQL version.|String|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.| | |pgsql.wal.stat\[uri,<username>,<password>,<dbName>\]|<|<|<| |WAL statistics.|JSON object |**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.||
ja	### PostgreSQL  |キー|<|<|<| |--|--|------|------| |**説明**|**戻り値**|**パラメータ**|**コメント**| |pgsql.autovacuum.count\[uri,<username>,<password>, <dbName>\]|<|<|<| |オートバキューム ワーカーの数|数値|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名| | |pgsql.archive\[uri,<username>,<password>, <dbName>\]|<|<|<| |アーカイブされたファイルに関する情報|JSONJSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名|返されたデータは依存アイテムによって処理されます:<br>**pgsql.archive.count\_archived\_files** - 正常にアーカイブされた WAL ファイルの数<br>**pgsql.archive.failed\_trying\_to\_archive** - WALファイルのアーカイブに失敗した回数<br>**pgsql.archive.count\_files\_to\_archive** - アーカイブするファイルの数<br>**pgsql.archive.size\_files\_to\_archive** - アーカイブするファイルのサイズ| |pgsql.bgwriter\[uri,<username>,<password>, <dbName>\]|<|<|<| |データベース クラスタのチェックポイントの合計数。チェックポイント タイプ別に分類されています。|JSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名|返されたデータは依存アイテムによって処理されます:<br>**pgsql.bgwriter.buffers\_alloc** - 割り当てられたバッファの数<br>**pgsql.bgwriter.buffers\_backend** - バックエンドによって直接書き込まれたバッファの数<br>**pgsql.bgwriter.maxwritten\_clean** - 書き込みバッファが多すぎたため、バックグラウンド ライターがクリーニング スキャンを停止した回数<br>**pgsql.bgwriter.buffers\_backend\_fsync** - バックエンドがバックグラウンド ライターの代わりに独自の fsync 呼び出しを実行しなければならなかった回数<br>**pgsql.bgwriter.buffers\_clean** - バックグラウンド ライターによって書き込まれたバッファの数<br>**pgsql.bgwriter.buffers\_checkpoint** - チェックポイント中に書き込まれたバッファ数<br>**pgsql.bgwriter.checkpoints\_timed** - 実行されたスケジュール済みチェックポイント数<br>**pgsql.bgwriter.checkpoints\_req** - 要求されて実行されたチェックポイント数<br>**pgsql.bgwriter.checkpoint\_write\_time** - ファイルがディスクに書き込まれるチェックポイント処理に費やされた合計時間 (ミリ秒単位)<br>**pgsql.bgwriter.sync\_time** - ファイルがディスクと同期されるチェックポイント処理に費やされた合計時間| |pgsql.cache.hit\[uri,<username>,<password>, <dbName>\]|<|<|<| |PostgreSQL バッファ キャッシュ ヒット率|数値(浮動小数)|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名| | |pgsql.connections\[uri,<username>,<password>, <dbName>\]|<|<|<| |タイプ別接続.|JSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名|返されたデータは依存アイテムによって処理されます:<br>**pgsql.connections.active** - バックエンドがクエリを実行中<br>**pgsql.connections.fastpath\_function\_call** - バックエンドが高速パス関数を実行中<br>**pgsql.connections.idle** - バックエンドが新しいクライアント コマンドを待っています<br>**pgsql.connections.idle\_in\_transaction** - バックエンドはトランザクション内にありますが、現在クエリを実行していません<br>**pgsql.connections.prepared** - 準備された接続数<br>**pgsql.connections.total** - 接続の総数<br>**pgsql.connections.total\_pct** - PostgreSQL サーバーの'max\connections'設定に関する合計接続数のパーセンテージ。<br>**pgsql.connections.waiting** - クエリ内の接続数<br>**pgsql.connections.idle\_in\_transaction\_aborted** - バックエンドはトランザクション内にありますが、現在クエリを実行しておらず、トランザクション内のステートメントの 1 つがエラーを引き起こしました| |pgsql.custom.query\[uri,<username>,<password>,queryName\[,args...\]\]|<|<|<| |カスタム クエリの結果を返します|JSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**queryName** - カスタム クエリの名前。拡張子を除いた SQL ファイル名と一致する必要があります <br> **args**(オプション) - クエリに渡す引数| | |pgsql.dbstat\[uri,<username>,<password>, dbName\]|<|<|<| |データベースごとに統計を収集します。[ローレベルディスカバリ](/manual/discovery/low_level_discovery/examples/systemd) に使用|JSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名|返されたデータは依存アイテムによって処理されます:<br>**pgsql.dbstat.numbackends\["{\#DBNAME}"\]** - このデータベースのバックエンドによるデータ ファイル ブロックの読み取り時間 (ミリ秒単位)<br>**pgsql.dbstat.sum.blk\_read\_time\["{\#DBNAME}"\]** - このデータベースのバックエンドによるデータ ファイル ブロックの読み取り時間 (ミリ秒単位)<br>**pgsql.dbstat.sum.blk\_write\_time\["{\#DBNAME}"\]** - このデータベースでバックエンドがデータ ファイル ブロックを書き込むのにかかった時間 (ミリ秒単位)<br>**pgsql.dbstat.sum.checksum\_failures\["{\#DBNAME}"\]** - (共有オブジェクトで) 検出されたデータ ページ チェックサム エラーの数、またはデータ チェックサムが有効でない場合は NULL (PostgreSQL バージョン 12 のみ)<br>**pgsql.dbstat.blks\_read.rate\["{\#DBNAME}"\]** - このデータベースで読み取られたディスク ブロック数<br>**pgsql.dbstat.deadlocks.rate\["{\#DBNAME}"\]** - このデータベースで検出されたデッドロック数<br>**pgsql.dbstat.blks\_hit.rate\["{\#DBNAME}"\]** - ディスク ブロックがバッファ キャッシュ内ですでに見つかったため、読み取りが不要になった回数 (これには、オペレーティング システムのファイル システム キャッシュではなく、PostgreSQL Pro バッファ キャッシュ内のヒットのみが含まれます)<br>**pgsql.dbstat.xact\_rollback.rate\["{\#DBNAME}"\]** - このデータベース内のロールバックされたトランザクションの数<br>**pgsql.dbstat.xact\_commit.rate\["{\#DBNAME}"\]** - このデータベースでコミットされたトランザクションの数<br>**pgsql.dbstat.tup\_updated.rate\["{\#DBNAME}"\]** - このデータベースでクエリによって更新された行数<br>**pgsql.dbstat.tup\_returned.rate\["{\#DBNAME}"\]** - このデータベースのクエリによって返される行数<br>**pgsql.dbstat.tup\_inserted.rate\["{\#DBNAME}"\]** - このデータベースのクエリによって挿入された行数<br>**pgsql.dbstat.tup\_fetched.rate\["{\#DBNAME}"\]** - このデータベースでクエリによってフェッチされた行数<br>**pgsql.dbstat.tup\_deleted.rate\["{\#DBNAME}"\]** - このデータベースでクエリによって削除された行数<br>**pgsql.dbstat.conflicts.rate\["{\#DBNAME}"\]** - このデータベースでリカバリとの競合が原因でキャンセルされたクエリの数 (競合はスタンバイ サーバーでのみ発生します)<br>**pgsql.dbstat.temp\_files.rate\["{\#DBNAME}"\]** - このデータベースでクエリによって作成された一時ファイルの数。 log\_temp\_files の設定や、一時ファイルが作成された理由 (並べ替えやハッシュなど) に関係なく、すべての一時ファイルがカウントされます。<br>**pgsql.dbstat.temp\_bytes.rate\["{\#DBNAME}"\]** - このデータベースのクエリによって一時ファイルに書き込まれたデータの合計量。 log\_temp\_files の設定や、一時ファイルが作成された理由 (並べ替えやハッシュなど) に関係なく、すべての一時ファイルのデータが含まれます。| |pgsql.dbstat.sum\[uri,<username>,<password>, <dbName>\]|<|<|<| |クラスター内のすべてのデータベースの要約データ|JSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名|返されたデータは依存アイテムによって処理されます:<br>**pgsql.dbstat.numbackends** - このデータベースに現在接続されているバックエンドの数<br>**pgsql.dbstat.sum.blk\_read\_time** - このデータベースのバックエンドによるデータ ファイル ブロックの読み取り時間 (ミリ秒単位)<br>**pgsql.dbstat.sum.blk\_write\_time** - このデータベースでバックエンドがデータ ファイル ブロックを書き込む時間 (ミリ秒単位)<br>**pgsql.dbstat.sum.checksum\_failures** - (共有オブジェクトで) 検出されたデータ ページ チェックサム エラーの数、またはデータ チェックサムが有効になっていない場合は NULL (PostgreSQL バージョン 12 のみ)<br>**pgsql.dbstat.sum.xact\_commit** - このデータベースでコミットされたトランザクションの数<br>**pgsql.dbstat.sum.conflicts** - スタンバイ サーバーでのリカバリとの競合によるクエリのキャンセルに関するデータベース統計<br>**pgsql.dbstat.sum.deadlocks** - このデータベースで検出されたデッドロックの数<br>**pgsql.dbstat.sum.blks\_read** - このデータベースで読み取られたディスク ブロックの数<br>**pgsql.dbstat.sum.blks\_hit** - バッファ キャッシュ内でディスク ブロックが既に見つかったため、読み取りは不要だった回数 (PostgreSQL Pro バッファ キャッシュ内のヒットのみが含まれます)<br>**pgsql.dbstat.sum.temp\_bytes** - このデータベースのクエリによって一時ファイルに書き込まれたデータの合計量。 log\_temp\_files の設定や、一時ファイルが作成された理由 (並べ替えやハッシュなど) に関係なく、すべての一時ファイルのデータが含まれます。<br>**pgsql.dbstat.sum.temp\_files** - このデータベースでクエリによって作成された一時ファイルの数。 log\_temp\_files の設定や、一時ファイルが作成された理由 (並べ替えやハッシュなど) に関係なく、すべての一時ファイルがカウントされます。<br>**pgsql.dbstat.sum.xact\_rollback** - このデータベースでロールバックされたトランザクションの数<br>**pgsql.dbstat.sum.tup\_deleted** - このデータベースでクエリによって削除された行数<br>**pgsql.dbstat.sum.tup\_fetched** - このデータベースでクエリによってフェッチされた行数<br>**pgsql.dbstat.sum.tup\_inserted** - このデータベースのクエリによって挿入された行数<br>**pgsql.dbstat.sum.tup\_returned** - このデータベースのクエリによって返される行数<br>**pgsql.dbstat.sum.tup\_updated** - このデータベースでクエリによって更新された行数| |pgsql.db.age\[uri,<username>,<password>, dbName\]|<|<|<| |データベースの最も古い FrozenXID の経過時間。 [ローレベルディスカバリ](/manual/discovery/low_level_discovery/examples/systemd)に使用|数値|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名| | |pgsql.db.bloating\_tables\[uri,<username>,<password>, <dbName>\]|<|<|<| |データベースあたりの肥大化したテーブルの数。 [ローレベルディスカバリ](/manual/discovery/low_level_discovery/examples/systemd)に使用|数値|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名| | |pgsql.db.discovery\[uri,<username>,<password>, <dbName>\]|<|<|<| |PostgreSQLデータベースのリスト。[ローレベルディスカバリ](/manual/discovery/low_level_discovery/examples/systemd)に使用|JSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名| | |pgsql.db.size\[uri,<username>,<password>, dbName\]|<|<|<| |データベースのサイズ (バイト単位)。 [ローレベルディスカバリ](/manual/discovery/low_level_discovery/examples/systemd)に使用|数値|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名| | |pgsql.locks\[uri,<username>,<password>, <dbName>\]|<|<|<| |データベースごとに付与されたロックに関する情報。 [ローレベルディスカバリ](/manual/discovery/low_level_discovery/examples/systemd)に使用|JSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名|返されたデータは依存アイテムによって処理されます:<br>**pgsql.locks.shareupdateexclusive\["{\#DBNAME}"\]** - 共有更新の排他ロックの数<br>**pgsql.locks.accessexclusive\["{\#DBNAME}"\]** - アクセス排他ロックの数<br>**pgsql.locks.accessshare\["{\#DBNAME}"\]** - アクセス共有ロックの数<br>**pgsql.locks.exclusive\["{\#DBNAME}"\]** - 排他ロックの数<br>**pgsql.locks.rowexclusive\["{\#DBNAME}"\]** - 行排他ロックの数<br>**pgsql.locks.rowshare\["{\#DBNAME}"\]** - 行共有ロックの数<br>**pgsql.locks.share\["{\#DBNAME}"\]** - 共有ロックの数<br>**pgsql.locks.sharerowexclusive\["{\#DBNAME}"\]** - 共有行の排他ロックの数| |pgsql.oldest.xid\[uri,<username>,<password>, <dbName>\]|<|<|<| |最古の XID の経過時間|数値|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名| | |pgsql.ping\[uri,<username>,<password>, <dbName>\]|<|<|<| |接続が有効かどうかをテストします|1 - 接続成功<br><br>0 - 接続失敗(AUTH や構成の問題を含むエラーが表示される等)|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名| | |pgsql.queries\[uri,<username>,<password>, <dbName>,timePeriod\]|<|<|<| |クエリの実行時間測定|JSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名<br>**timePeriod** - スロークエリの実行時間制限 (正の整数である必要があります)|返されたデータは依存アイテムによって処理されます:<br> **pgsql.queries.mro.time_max\["{\#DBNAME}"]** - 最大メンテナンスクエリ時間<br>**pgsql.queries.query.time_max\["{\#DBNAME}"]** - 最大クエリ時間<br>**pgsql.queries.tx.time_max\["{\#DBNAME}"]** - 最大トランザクションクエリ時間<br>**pgsql.queries.mro.slow_count\["{\#DBNAME}"]** - スローメンテナンスクエリ数<br>**pgsql.queries.query.slow_count\["{\#DBNAME}"]** - スロークエリ数<br>**pgsql.queries.tx.slow_count\["{\#DBNAME}"]** - スロートランザクションクエリ数<br>**pgsql.queries.mro.time_sum\["{\#DBNAME}"]** - 合計メンテナンス クエリ時間<br>**pgsql.queries.query.time_sum\["{\#DBNAME}"]** - 合計クエリ時間<br>**pgsql.queries.tx.time_sum\["{\#DBNAME}"]** - 合計トランザクション クエリ時間<br><br> この項目は Zabbix 6.0.3 以降でサポートされています| |pgsql.replication.count\[uri,<username>,<password>\]|<|<|<| |スタンバイ サーバー数|数値|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報| | |pgsql.replication.process\[uri,<username>,<password>\]|<|<|<| | 各送信プロセスごとのフラッシュ ラグ、書き込みラグ、リプレイ ラグ|JSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報| | |pgsql.replication.process.discovery\[uri,<username>,<password>\]|<|<|<| | レプリケーション プロセス名検出|JSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報| | |pgsql.replication.recovery\_role\[uri,<username>,<password>\]|<|<|<| |回復状態|0 - マスターモード<br>1 - 回復進行中(スタンバイモード)|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報| | |pgsql.replication.status\[uri,<username>,<password>\]|<|<|<| |レプリケーションステータス|0 - ストリーミングダウン<br>1 - ストリーミングアップ<br>2 - マスター モード|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報| | |pgsql.replication\_lag.b\[uri,<username>,<password>\]|<|<|<| |レプリケーションラグ (バイト単位)|数値|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報| | |pgsql.replication\_lag.sec\[uri,<username>,<password>\]|<|<|<| |秒単位のレプリケーション ラグ|数値|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報| | |pgsql.uptime\[uri,<username>,<password>, <dbName>\]|<|<|<| |PostgreSQL の稼働時間 (ミリ秒)|数値(浮動小数)|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名| | |pgsql.wal.stat\[uri,<username>,<password>, <dbName>\]|<|<|<| |WAL統計|JSONオブジェクト|**uri** - URIまたはセッション名<br>**username, password** - PostgreSQL 資格情報<br>**dbName** - データベース名|返されたデータは依存アイテムによって処理されます:<br>**pgsql.wal.count** - WALファイル数<br>**pgsql.wal.write** - 使用された WAL lsn (バイト単位)|

en-us	 #### PostgreSQL metrics  A new [item](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#postgresql) has been added to PostgreSQL plugin for Zabbix agent 2. The metric **pgsql.queries** is used for monitoring query execution time. 
ja	#### PostgreSQLのメトリクス  Zabbixエージェント2のPostgreSQLプラグインに新しい[アイテム](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#postgresql)が追加されました。 メトリック **pgsql.queries** は、クエリの実行時間を監視するために使用されます。

en-us	 ### PostgreSQL plugin loadable  The PostgreSQL [plugin](/manual/config/items/plugins#loadable) is now loadable in Zabbix agent 2 (previously built-in).  See also: [PostgreSQL loadable plugin](https://git.zabbix.com/projects/AP/repos/postgresql/browse?at=refs%2Fheads%2Frelease%2F6.0) repository
ja	 ### PostgreSQL プラグインがロード可能に  PostgreSQL [プラグイン](/manual/config/items/plugins#loadable) が Zabbix エージェント 2 でロード可能になりました。(以前は組み込み)  参照: [PostgreSQL のロード可能なプラグイン](https://git.zabbix.com/projects/AP/repos/postgresql/browse?at=refs%2Fheads%2Frelease%2F6.0) リポジトリ

en-us	 ### PostgreSQL plugin moved to loadable plugins  The PostgreSQL [plugin](/manual/config/items/plugins#loadable) is no longer built-in in Zabbix agent 2. Instead it is now a loadable plugin in the agent 2.  This change may/will break automations with Ansible, Chef, etc, because it is no longer possible to pull the plugin repository directly.  See also: [PostgreSQL loadable plugin](https://git.zabbix.com/projects/AP/repos/postgresql/browse) repository
ja	### PostgreSQL プラグインはロード可能なプラグインに移動しました  PostgreSQL [プラグイン](/manual/config/items/plugins#loadable) は、Zabbix エージェント 2 に組み込まれなくなり、ロード可能なプラグインになりました。  この変更により、プラグイン リポジトリを直接プルすることができなくなったため、Ansible、Chef などの自動化が機能しなくなる可能性があります。   [PostgreSQL loadable plugin](https://git.zabbix.com/projects/AP/repos/postgresql/browse) リポジトリを参照してください。

en-us	 #### PostgreSQL plugin parameters  The following PostgreSQL plugin parameters are no longer mandatory if Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect is set to *verify_ca* or *verify_full*:  -   Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile -   Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile
ja	 #### PostgreSQLプラグインのパラメータ  Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnectが*verify_ca*または*verify_full*に設定されている場合、次のPostgreSQLプラグインパラメーターは必須ではなくなりました。  -   Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile -   Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile

en-us	 #### PostgreSQL-TimescaleDB combination no longer checked  Zabbix no longer checks for the supported PostgreSQL-TimescaleDB combination. As before, Zabbix does check for the supported PostgreSQL version or TimescaleDB version separately.
ja	 #### PostgreSQL-TimescaleDBの組み合わせはチェックされなくなりました  Zabbixは、サポートされているPostgreSQL-TimescaleDBの組み合わせをチェックしなくなりました。 以前と同様に、ZabbixはサポートされているPostgreSQLバージョンまたはTimescaleDBバージョンを個別にチェックします。

en-us	 ### PostgreSQL + TimescaleDB  Export and import must be performed in tmux/screen to ensure that the session isn't dropped. Zabbix server should be down during the upgrade.  See also: [Important notes](#important-notes)  * Rename tables using `history_pk_prepare.sql`.  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ``` * Run TimescaleDB hypertable migration scripts (compatible with both TSDB v2.x and v1.x version) based on compression settings:   * If compression is enabled (on default installation), run scripts from `database/postgresql/tsdb_history_pk_upgrade_with_compression`:     ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ```   * If compression is disabled, run scripts from `database/postgresql/tsdb_history_pk_upgrade_no_compression`:     ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ```  See also: [Tips](https://blog.timescale.com/blog/13-tips-to-improve-postgresql-insert-performance/) for improving INSERT performance.  * Follow [post-migration instructions](#after-migration) to drop the old tables.
ja	### PostgreSQL + TimescaleDB  セッションがドロップされないように、エクスポートとインポートは tmux/screen で実行する必要があります。 アップグレード中は、Zabbix サーバーがダウンしている必要があります。  参照: [重要事項](#important-notes)  * `history_pk_prepare.sql` を使用してテーブルの名前を変更します。  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ``` * 圧縮設定に基づいて、TimescaleDB ハイパーテーブル移行スクリプト (TSDB v2.x と v1.x の両方のバージョンと互換性があります) を実行します。    * 圧縮が有効になっている場合 (デフォルトインストール)`database/postgresql/tsdb_history_pk_upgrade_with_compression` からスクリプトを実行します。      ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ``` * 圧縮が無効になっている場合は、`database/postgresql/tsdb_history_pk_upgrade_no_compression` からスクリプトを実行します     ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ```  INSERT のパフォーマンスを向上させるための [ヒント](https://blog.timescale.com/blog/13-tips-to-improve-postgresql-insert-performance/) も参照してください。  * [移行後の手順](#after-migration) に従って、古いテーブルを削除します。

en-us	#### PostgreSQL  You need to have database user with permissions to create database objects.   If you are installing from Zabbix **packages**, proceed to the [instructions](https://www.zabbix.com/download) for your platform.  If you are installing Zabbix from sources:  * Create a database user.  The following shell command will create user `zabbix`. Specify a password when prompted and repeat the password (note, you may first be asked for `sudo` password):  ``` shell> sudo -u postgres createuser --pwprompt zabbix ```  * Create a database.  The following shell command will create the database `zabbix` (last parameter) with the previously created user as the owner (`-O zabbix`).  ``` shell> sudo -u postgres createdb -O zabbix -E Unicode -T template0 zabbix ```  * Import the initial schema and data (assuming you are in the root directory of Zabbix sources).   For a Zabbix proxy database, only `schema.sql` should be imported (no images.sql nor data.sql).  ``` shell> cd database/postgresql shell> cat schema.sql | sudo -u zabbix psql zabbix # stop here if you are creating database for Zabbix proxy shell> cat images.sql | sudo -u zabbix psql zabbix shell> cat data.sql | sudo -u zabbix psql zabbix ```  ::: noteimportant The above commands are provided as an example that will work in most of GNU/Linux installations. You can use different commands, e. g. "psql -U <username>" depending on how your system/database are configured. If you have troubles setting up the database please consult your Database administrator.  :::
ja	#### PostgreSQL  データベースオブジェクトを作成する権限を持つデータベースユーザーが必要です。  Zabbix**パッケージ**からインストールする場合は、お使いのプラットフォームの[手順](https://www.zabbix.com/download)を確認してください。  Zabbixをソースからインストールする場合：  * データベースユーザーの作成  次のシェルコマンドは、ユーザー`zabbix`を作成します。プロンプトが表示されたらパスワードを指定し、パスワードを繰り返し入力します（最初に`sudo`のパスワード入力を求められる場合があります）  ```  shell> sudo -u postgres createuser --pwprompt zabbix ```  * データベースの作成  次に以前に作成したユーザーを所有者（-O zabbix）としてデータベース `zabbix`（最後のパラメーター）を設定します。  ``` shell> sudo -u postgres createdb -O zabbix -E Unicode -T template0 zabbix ```  * 初期スキーマとデータをインポートします (Zabbixソースのルートディレクトリにいると仮定します)。  Zabbixプロキシデータベースの場合、schema.sqlのみをインポートする必要があります（images.sqlもdata.sqlもインポートしないでください）。  ``` shell> cd database/postgresql shell> cat schema.sql | sudo -u zabbix psql zabbix ＃Zabbixプロキシ用のデータベースを作成している場合は、ここで停止します shell> cat images.sql | sudo -u zabbix psql zabbix shell> cat data.sql | sudo -u zabbix psql zabbix ```  ::: noteimportant 上記のコマンドは、ほとんどのGNU/Linuxインストールで機能する例として提供されています。他にもさまざまなコマンドを使用できますが（例：「psql -U <ユーザー名>」）、システム/データベースの構成方法によって異なります。データベースの設定で問題が発生した場合は、データベース管理者に相談してください。 :::

en-us	 ### Post-migration  For all databases, once the migration is completed, do the following:  * Verify that everything works as expected.  * Drop old tables:  ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ```
ja	### 移行後の手順  すべてのデータベースで、移行完了後に次の手順を実施します。  * すべてが想定どおりに機能することを確認します。  * 古いテーブルを削除:  ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ```

en-us	#### - Potential errors  Functions return -1 in such situations:  -   specified evaluation period contains no data;  ```{=html} <!-- --> ``` -   result of mathematical operation is not defined[^3];  ```{=html} <!-- --> ``` -   numerical complications (unfortunately, for some sets of input data     range and precision of double-precision floating-point format become     insufficient)[^4].  ::: notetip No warnings or errors are flagged if chosen fit poorly describes provided data or there is just too few data for accurate prediction. :::
ja	#### 潜在的なエラー  このような場合、関数は -1 を返します。  - 指定された評価期間内にデータがない。  ```{=html} <!-- --> ``` - 算術演算の結果が定義されていない[^3]  ```{=html} <!-- --> ``` - 数値の複雑さ(残念ながら、入力データによっては倍精度浮動小数点フォーマットの範囲と精度が不十分となる)[^4]があります。  ::: notetip 選択された fit が提供されたデータをうまく説明できない場合や、正確な予測のためにデータが少なすぎる場合、<br> 警告やエラーは表示されません。 :::

en-us	#### Predefined scripts  All scripts (webhook, script, SSH, Telnet, IPMI) that are available for action operations are defined in [global scripts](/manual/web_interface/frontend_sections/administration/scripts).  For example:      sudo /etc/init.d/apache restart   In this case, Zabbix will try to restart an Apache process. With this command, make sure that the command is executed on Zabbix agent (click the *Zabbix agent* button against *Execute on*).  ::: noteimportant Note the use of **sudo** - Zabbix user does not have permissions to restart system services by default. See below for hints on how to configure **sudo**. :::  ::: noteclassic Zabbix agent should run on the remote host and accept incoming connections. Zabbix agent executes commands in background. :::  Remote commands on Zabbix agent are executed without timeout by the system.run\[,nowait\] key and are not checked for execution results. On Zabbix server and Zabbix proxy, remote commands are executed with timeout as set in the TrapperTimeout parameter of zabbix\_server.conf or zabbix\_proxy.conf file and are [checked](/manual/appendix/command_execution#exit_code_checking) for execution results.
ja	#### 定義済みスクリプト  アクション操作に使用できるすべてのスクリプト (Webhook、スクリプト、SSH、Telnet、IPMI) は、[グローバル スクリプト](/manual/web_interface/frontend_sections/administration/scripts) で定義されています。  例:      sudo /etc/init.d/apache restart   この場合、Zabbix は Apache プロセスの再起動を試みます。 このコマンドを使用して、コマンドが Zabbix エージェントで実行されることを確認します (*Zabbix agent* の*実行*ボタンをクリックします)。  ::: noteimportant **sudo** の使用に注意してください。Zabbix ユーザーには、デフォルトでシステム サービスを再起動する権限がありません。 **sudo** の設定方法に関するヒントについては、以下を参照してください。 :::  ::: noteclassic Zabbix エージェントはリモート ホストで実行され、着信接続を受け入れる必要があります。 Zabbix エージェントはバックグラウンドでコマンドを実行します。 :::  Zabbix エージェントのリモート コマンドは、system.run\[,nowait\] キーによってタイムアウトなしで実行され、実行結果はチェックされません。 Zabbix サーバーと Zabbix プロキシでは、リモート コマンドは、zabbix\_server.conf または zabbix\_proxy.conf ファイルの TrapperTimeout パラメータで設定されたタイムアウトで実行され、実行結果について [チェック](/manual/appendix/command_execution#exit_code_checking) されます。

en-us	#### Prediction functions  |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**forecast** (/host/key,(sec\|\#num)<:time shift>,time,<fit>,<mode>)|<|<| |Future value, max, min, delta or avg of the item.|See [common parameters](#common-parameters).<br><br>**time** - forecasting horizon in seconds (time suffixes can be used); negative values are supported<br><br>**fit** (optional; must be double-quoted) - function used to fit historical data<br><br>Supported `fits`:<br>*linear* - linear function<br>*polynomialN* - polynomial of degree N (1 <= N <= 6)<br>*exponential* - exponential function<br>*logarithmic* - logarithmic function<br>*power* - power function<br><br>Note that:<br>*linear* is default, *polynomial1* is equivalent to *linear*<br><br>**mode** (optional; must be double-quoted) - demanded output<br><br>Supported `modes`:<br>*value* - value (default)<br>*max* - maximum<br>*min* - minimum<br>*delta* - *max*-*min*<br>*avg* - average<br><br>Note that:<br>*value* estimates item value at the moment `now` + `time`<br>*max*, *min*, *delta* and *avg* investigate item value estimate on the interval between `now` and `now` + `time`|Supported value types: float, int<br><br>If value to return is larger than 1.7976931348623157E+308 or less than -1.7976931348623157E+308, return value is cropped to 1.7976931348623157E+308 or -1.7976931348623157E+308 correspondingly.<br><br>Becomes unsupported only if misused in expression (wrong item type, invalid parameters), otherwise returns -1 in case of errors.<br><br>Examples:<br>=> **forecast**(/host/key,**\#10**,**1h**) → forecast item value in one hour based on the last 10 values<br>=> **forecast**(/host/key,**1h**,**30m**) → forecast item value in 30 minutes based on the last hour data<br>=> **forecast**(/host/key,**1h:now-1d**,**12h**) → forecast item value in 12 hours based on one hour one day ago<br>=> **forecast**(/host/key,**1h**,**10m**,"exponential") → forecast item value in 10 minutes based on the last hour data and exponential function<br>=> **forecast**(/host/key,**1h**,**2h**,"polynomial3","max") → forecast the maximum value the item can reach in the next two hours based on last hour data and cubic (third degree) polynomial<br>=> **forecast**(/host/key,**\#2**,**-20m**) → estimate the item value 20 minutes ago based on the last two values (this can be more precise than using last(), especially if item is updated rarely, say, once an hour)<br><br>See also additional information on [predictive trigger functions](/manual/config/triggers/prediction).| |**timeleft** (/host/key,(sec\|\#num)<:time shift>,threshold,<fit>)|<|<| |Time in seconds needed for an item to reach a specified threshold.|See [common parameters](#common-parameters).<br><br>**threshold** - value to reach ([unit suffixes](/manual/appendix/suffixes) can be used)<br><br>**fit** (optional; must be double-quoted) - see forecast()|Supported value types: float, int<br><br>If value to return is larger than 1.7976931348623157E+308, return value is cropped to 1.7976931348623157E+308.<br><br>Returns 1.7976931348623157E+308 if threshold cannot be reached.<br><br>Becomes unsupported only if misused in the expression (wrong item type, invalid parameters), otherwise returns -1 in case of errors.<br><br>Examples:<br>=> **timeleft**(/host/key,**\#10**,**0**) → time until the item value reaches zero based on the last 10 values<br>=> **timeleft**(/host/key,**1h**,**100**) → time until the item value reaches 100 based on the last hour data<br>=> **timeleft**(/host/key,**1h:now-1d**,**100**) → time until the item value reaches 100 based on one hour one day ago<br>=> **timeleft**(/host/key,**1h**,**200**,"polynomial2") → time until the item value reaches 200 based on the last hour data and assumption that the item behaves like quadratic (second degree) polynomial<br>See also additional information on [predictive trigger functions](/manual/config/triggers/prediction).|
ja	#### 予測関数  |関数|<|<| |--|--|--| |**説明**|**関数固有のパラメーター**|**コメント**| |**forecast** (/host/key,(sec\|\#num)<:time shift>,time,<fit>,<mode>)|<|<| |アイテムの将来の値、最大、最小、デルタ、平均|[共通パラメーター](#common-parameters)を参照<br><br>**time** - 秒単位の予測期間 (タイムサフィックスを使用できます)。 負の値がサポートされています<br><br>**fit** (オプション。二重引用符で囲む必要があります) - 履歴データの適合に使用される関数<br><br>サポートされている'fits':<br>*linear* - 線形関数<br>*polynomialN* - 次数 N の多項式 (1 <= N <= 6)<br>*exponential* - 指数関数<br>*logarithmic* - 対数関数<br>*power* - パワー関数<br><br>注意:<br>*linear* はデフォルトです。 *polynomial1* は *linear* と同等です。<br><br>**mode** (オプション。二重引用符で囲む必要があります) - 要求された出力<br><br>サポートされている'mode':<br>*value* - 値 (デフォルト)<br>*max* - 最大<br>*min* - 最小<br>*delta* - *最大*-*最小*<br>*avg* - 平均<br><br>注意:<br>*value*は現時点でのアイテムの推定値 `now` + `time`<br>*max*, *min*, *delta*, *avg*は'now'と'now'+'time'の間隔でアイテム値の見積もりを調べる|サポートされている値の型: float, int<br><br>返される値が 1.7976931348623157E+308 より大きい場合、または -1.7976931348623157E+308 より小さい場合、戻り値は 1.7976931348623157E+308 または -1.7976931348623157E+308 にトリミングされます。 <br><br>式が誤用された場合 (間違ったアイテムタイプや無効なパラメーター等)にのみサポートされなくなります。それ以外の場合でエラーの場合は -1が返されます。<br><br>例:<br>=> **forecast**(/host/key,**\#10**,**1h**) → 過去 10 個の値に基づいて 1 時間のアイテム値を予測<br>=> **forecast**(/host/key,**1h**,**30m**) → 過去 1 時間のデータに基づいて 30 分間のアイテム値を予測<br>=> **forecast**(/host/key,**1h:now-1d**,**12h**) → 1 日前の 1 時間に基づいて 12 時間後のアイテム値を予測<br>=> **forecast**(/host/key,**1h**,**10m**,"exponential") → 過去 1 時間のデータと指数関数に基づいて 10 分間のアイテム値を予測<br>=> **forecast**(/host/key,**1h**,**2h**,"polynomial3","max") → 過去 1 時間のデータと 3 次 (3 次) 多項式に基づいてアイテムが次の 2 時間で到達できる最大値を予測<br>=> **forecast**(/host/key,**\#2**,**-20m**) → 最後の 2 つの値に基づいて 20 分前の項目の値を予測(これはlast() を使用するよりも正確です。特に1 時間に 1 回などアイテムがめったに更新されない場合等)<br><br>[予測トリガー機能](/manual/config/triggers/prediction) に関する追加情報も参照してください。| |**timeleft** (/host/key,(sec\|\#num)<:time shift>,threshold,<fit>)|<|<| |アイテムが指定されたしきい値に達するまでに必要な時間 (秒)|[共通パラメーター](#common-parameters)を参照<br><br>**threshold** - しきい値 ([単位サフィックス](/manual/appendix/suffixes) を使用できます)<br><br>**fit** (オプション。二重引用符で囲む必要があります) - Forecast()を参照してください|サポートされている値の型: float,int<br><br>返される値が 1.7976931348623157E+308 より大きい場合、戻り値は 1.7976931348623157E+308 にトリミングされます。<br><br>しきい値に到達できない場合、1.7976931348623157E+308 を返します。<br><br>式で誤用された場合 (間違ったアイテムタイプや無効なパラメーター等)にのみサポートされなくなります。それ以外のエラーは -1 が返されます。<br><br>例:<br>=> **timeleft**(/host/key, **\#10**,**0**) → 最後の 10 個の値に基づいて、アイテム値がゼロになるまでの時間<br>=> **timeleft**(/host/key,**1h**,**100**) → 過去1時間のデータに基づいてアイテム値が100になるまでの時間<br>=> **timeleft**(/host/key,**1h:now-1d**,**100**) → 1 日前の 1 時間に基づいてアイテム値が 100 になるまでの時間<br>=> **timeleft**(/host/key,**1h**,**200**,"polynomial2") → 過去 1 時間のデータと、アイテムが 2 次多項式のように動作するという仮定に基づいて、アイテムの値が 200 に達するまでの時間<br>[予測トリガー関数](/manual/config/triggers/prediction) に関する追加情報も参照してください。|

en-us	#### Pre-installation summary  Review a summary of settings.  ![](../../../assets/en/manual/installation/install_5.png){width="550"}
ja	#### インストール前の概要  設定の概要を確認します。  ![](../../../assets/en/manual/installation/install_5.png){width="550"}

en-us	##### Preparation  Zabbix agent is distributed as a zip archive. After you download the archive you need to unpack it. Choose any folder to store Zabbix agent and the configuration file, e. g.      C:\zabbix  Copy bin\\zabbix\_agentd.exe and conf\\zabbix\_agentd.conf files to c:\\zabbix.  Edit the c:\\zabbix\\zabbix\_agentd.conf file to your needs, making sure to specify a correct "Hostname" parameter.
ja	##### 準備  Zabbix エージェント は、zip アーカイブとして配布されます。 アーカイブをダウンロードしたら展開する必要があります。Zabbix エージェント本体と設定ファイルを保存するフォルダを選択してください。例:      C:\zabbix  bin\\zabbix\_agentd.exe とconf\\zabbix\_agentd.conf filesを c:\\zabbixにコピーしてください。  c:\\zabbix\\zabbix\_agentd.conf ファイルを必要に応じて編集し、特に"Hostname" パラメータは正しいことを確かめてください。

en-us	##### Preparing frontend  Make sure that Zabbix server address:port is **not defined** in the  frontend configuration (found in `conf/zabbix.conf.php` of the frontend  files directory).  ![](../../../../assets/en/manual/config/frontend_conf_server_port.png){width="600"}  Zabbix frontend will autodetect the active node by reading settings  from the nodes table in Zabbix database. Node address of the active node  will be used as the Zabbix server address.
ja	##### Webインターフェースの準備  Webインターフェースの設定ファイル(Webインターフェースのファイルがあるディレクトリ内の`conf/zabbix.conf.php`)内で、Zabbixサーバーの アドレス:ポート番号 が **設定されていない** ことを確認してください。  ![](../../../../assets/en/manual/config/frontend_conf_server_port.png){width="600"}  ZabbixのWebインターフェースは、Zabbixデータベースのノードテーブルから設定を読み取って、アクティブノードを自動的に検出します。アクティブノードのノードアドレスがZabbixサーバーのアドレスとして使用されます。

en-us	 ## Preprocessing
ja	 ## 保存前処理

en-us	#### Preprocessing queue  Preprocessing queue is a FIFO data structure that stores values preserving the order in which values are reviewed by preprocessing manager. There are multiple exceptions to FIFO logic:  -   Internal items are enqueued at the beginning of the queue -   Dependent items are always enqueued after the master item  To visualize the logic of preprocessing queue, we can use the following diagram:  ![](../../../../../assets/en/manual/appendix/items/queue_processing.gif)  Values from the preprocessing queue are flushed from the beginning of the queue to the first unprocessed value. So, for example, preprocessing manager will flush values 1, 2 and 3, but will not flush value 5 as value 4 is not processed yet:  ![](../../../../../assets/en/manual/appendix/items/queue_flush.png)  Only two values will be left in queue (4 and 5) after flushing, values are added into local data cache of preprocessing manager and then values are transferred from local cache into history cache. Preprocessing manager can flush values from local data cache in single item mode or in bulk mode (used for dependent items and values received in bulk).
ja	#### プリプロセスキュー  プリプロセスキューは、プリプロセスマネージャーによって値がレビューされる順序を維持したまま値を格納するFIFOデータ構造です。FIFOロジックにはいくつかの例外があります:  - 内部アイテムはキューの先頭にエンキューされます - 依存アイテムは常に親アイテムの後にエンキューされます  プリプロセスキューのロジックを視覚化するために、次の図を使用します。  ![](../../../../../assets/en/manual/appendix/items/queue_processing.gif)  プリプロセスキューからの値は、キューの先頭から最初の未処理キューにフラッシュされます。<br> したがって、例えば、プリプロセスマネージャは、値1、2、3 をフラッシュしますが、値4 はまだ処理されていないため、<br> 値5 はフラッシュしません。  ![](../../../../../assets/en/manual/appendix/items/queue_flush.png)  フラッシュ後、キューには2つの値（4と5）だけが残され、プリプロセッシングマネージャのローカルデータキャッシュに追加され、<br> その後、値がローカルキャッシュからヒストリーキャッシュに転送されます。<br> プリプロセッシングマネージャは、ローカルデータキャッシュから、単一 item モードまたはバルクモード<br> （依存する item や一括して受け取った値に使用）で値をフラッシュすることができます。

en-us	#### Preprocessing test result truncation  When [testing preprocessing steps](/manual/config/items/preprocessing#testing), test results are now truncated to a maximum size of 512KB when sent to the frontend. Note that data larger than 512KB is still processed fully by Zabbix server.
ja	#### 前処理テスト結果の切り捨て  [前処理ステップをテストする](/manual/config/items/preprocessing#testing)とき、テスト結果はフロントエンドに送信されるときに最大サイズ512KBに切り詰められるようになりました。  512KBを超えるデータは、依然としてZabbixサーバーによって完全に処理されることに注意してください。

en-us	#### Preprocessing  The **Preprocessing** tab allows to define transformation rules to apply to the result of discovery. One or several transformations are possible in this step. Transformations are executed in the order in which they are defined. All preprocessing is done by Zabbix server.  See also:  -   [Preprocessing     details](/manual/config/items/preprocessing/preprocessing_details) -   [Preprocessing testing](/manual/config/items/preprocessing#testing)  ![](../../../assets/en/manual/discovery/low_level_discovery/lld_fs_b.png)   |Type|<|<| |-|----------|----------------------------------------| | |*Transformation*|Description| |Text|<|<| |<|*Regular expression*|Match the received value to the <pattern> regular expression and replace value with the extracted <output>. The regular expression supports extraction of maximum 10 captured groups with the \\N sequence.<br>Parameters:<br>**pattern** - regular expression<br>**output** - output formatting template. An \\N (where N=1…9) escape sequence is replaced with the Nth matched group. A \\0 escape sequence is replaced with the matched text.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error handling options: either to discard the value, set a specified value or set a specified error message.| |^|*Replace*|Find the search string and replace it with another (or nothing). All occurrences of the search string will be replaced.<br>Parameters:<br>**search string** - the string to find and replace, case-sensitive (required)<br>**replacement** - the string to replace the search string with. The replacement string may also be empty effectively allowing to delete the search string when found.<br>It is possible to use escape sequences to search for or replace line breaks, carriage return, tabs and spaces "\\n \\r \\t \\s"; backslash can be escaped as "\\\\" and escape sequences can be escaped as "\\\\n". Escaping of line breaks, carriage return, tabs is automatically done during low-level discovery.<br>Supported since 5.0.0.| |Structured data|<|<| |<|*JSONPath*|Extract value or fragment from JSON data using [JSONPath functionality](/manual/config/items/preprocessing/jsonpath_functionality).<br>If you mark the *Custom on fail* checkbox, the item will not become unsupported in case of failed preprocessing step and it is possible to specify custom error handling options: either to discard the value, set a specified value or set a specified error message.| |<|*XML XPath*|Extract value or fragment from XML data using XPath functionality.<br>For this option to work, Zabbix server must be compiled with libxml support.<br>Examples:<br>`number(/document/item/value)` will extract `10` from `<document><item><value>10</value></item></document>`<br>`number(/document/item/@attribute)` will extract `10` from `<document><item attribute="10"></item></document>`<br>`/document/item` will extract `<item><value>10</value></item>` from `<document><item><value>10</value></item></document>`<br>Note that namespaces are not supported.<br>Supported since 4.4.0.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error handling options: either to discard the value, set a specified value or set a specified error message.| |<|*CSV to JSON*|Convert CSV file data into JSON format.<br>For more information, see: [CSV to JSON preprocessing](/manual/config/items/preprocessing/csv_to_json#csv_header_processing).<br>Supported since 4.4.0.| |^|*XML to JSON*|Convert data in XML format to JSON.<br>For more information, see: [Serialization rules](/manual/config/items/preprocessing/javascript/javascript_objects#serialization_rules).<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error handling options: either to discard the value, set a specified value or set a specified error message.| |Custom scripts|<|<| |<|*JavaScript*|Enter JavaScript code in the block that appears when clicking in the parameter field or on *Open*.<br>Note that available JavaScript length depends on the [database used](/manual/config/items/item#custom_script_limit).<br>For more information, see: [Javascript preprocessing](/manual/config/items/preprocessing/javascript)| |Validation|<|<| |<|*Does not match regular expression*|Specify a regular expression that a value must not match.<br>E.g. `Error:(.*?)\.`<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error handling options: either to discard the value, set a specified value or set a specified error message.| |^|*Check for error in JSON*|Check for an application-level error message located at JSONpath. Stop processing if succeeded and message is not empty; otherwise continue processing with the value that was before this preprocessing step. Note that these external service errors are reported to user as is, without adding preprocessing step information.<br>E.g. `$.errors`. If a JSON like `{"errors":"e1"}` is received, the next preprocessing step will not be executed.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error handling options: either to discard the value, set a specified value or set a specified error message.| |^|*Check for error in XML*|Check for an application-level error message located at xpath. Stop processing if succeeded and message is not empty; otherwise continue processing with the value that was before this preprocessing step. Note that these external service errors are reported to user as is, without adding preprocessing step information.<br>No error will be reported in case of failing to parse invalid XML.<br>Supported since 4.4.0.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error handling options: either to discard the value, set a specified value or set a specified error message.| |Throttling|<|<| |<|*Discard unchanged with heartbeat*|Discard a value if it has not changed within the defined time period (in seconds).<br>Positive integer values are supported to specify the seconds (minimum - 1 second). Time suffixes can be used in this field (e.g. 30s, 1m, 2h, 1d). User macros and low-level discovery macros can be used in this field.<br>Only one throttling option can be specified for a discovery item.<br>E.g. `1m`. If identical text is passed into this rule twice within 60 seconds, it will be discarded.<br>*Note*: Changing item prototypes does not reset throttling. Throttling is reset only when preprocessing steps are changed.| |Prometheus|<|<| |<|*Prometheus to JSON*|Convert required Prometheus metrics to JSON.<br>See [Prometheus checks](/manual/config/items/itemtypes/prometheus) for more details.|  Note that if the discovery rule has been applied to the host via template then the content of this tab is read-only.
ja	#### 保存前処理  **保存前処理**タブでは、検出結果に適用する変換ルールを定義できます。 このステップでは、1つまたは複数の変換が可能です。 変換は定義された順序で実行されます。 すべての保存前処理はZabbixサーバーによって行われます。  参照：  -   [保存前処理の詳細](/manual/config/items/preprocessing/preprocessing_details) -   [保存前処理のテスト](/manual/config/items/preprocessing#testing)  ![](../../../assets/en/manual/discovery/low_level_discovery/lld_fs_b.png)  |タイプ|<|<| |-|----------|----------------------------------------| | |*トランスフォーメーション*|説明| |テキスト|<|<| |<|*正規表現*|受信した値を<pattern>正規表現に一致させ、値を抽出した<output>に置き換えます。 正規表現は、\\Nシーケンスで最大10個のキャプチャされたグループの抽出をサポートします。<br>パラメータ：<br>**pattern** - 正規表現<br>**output** - 出力フォーマットテンプレート。\\N（N = 1…9）のエスケープシーケンスは、N番目に一致するグループに置き換えられます。\\0エスケープシーケンスは一致したテキストに置き換えられます。<br>*失敗時のカスタマイズ*チェックボックスをオンにすると、値を破棄、値を設定、 エラーメッセージを設定いずれかのカスタムエラー処理オプションを指定できます。| |^|*置換*|検索文字列を見つけて、別の文字列に置き換え（または削除し）ます。 検索文字列のすべての出現箇所が置き換えられます。パラメーター：<br> **search string** - 検索して置換する文字列、大文字と小文字を区別（必須）<br> **replacement** - 検索文字列を置き換える文字列。 置換文字列が空の場合は見つかった検索文字列を削除します。<br>エスケープシーケンスを使用して、改行、キャリッジリターン、タブ、スペース "\\n \\r \\t \\s"を検索または置換することができます。 バックスラッシュは「\\\\」としてエスケープでき、エスケープシーケンスは"\\\\n"としてエスケープできます。 改行、キャリッジリターン、タブのエスケープは、ローレベルディスカバリ中に自動的に実行されます。<br>5.0.0以降でサポートされています。| |構造化データ|<|<| |<|*JSONPath*|[JSONPath機能](/manual/config/items/preprocessing/jsonpath_functionality)を使用してJSONデータから値またはフラグメントを抽出します。<br>*失敗時のカスタマイズ*チェックボックスをオンにすると、前処理ステップが失敗した場合に実行されるカスタムエラー処理オプションを指定できます。 値を破棄するか、設定する値を指定するか、設定するエラーメッセージを指定してください。| |<|*XML XPath*|XPath機能を使用してXMLデータから値またはフラグメントを抽出します。<br>このオプションを機能させるには、Zabbixサーバーをlibxmlサポートでコンパイルする必要があります。<br>例：<br> `number(/ document/item/value)`から10を抽出<br>`<document><item><value>10</ value></ item></ document>`<br> `number(/document/item/@attribute)`から10を抽出<br>`<document><item attribute="10"></ item></ document>`<br>`/document/item`から<item><value>10</value></item>を抽出`<document><item><value>10</ value></ item></document>`<br>名前付けはサポートされていませんないことに注意してください。<br>4.4.0以降でサポートされています。<br>*失敗時のカスタマイズ*チェックボックスをオンにすると、前処理ステップが失敗した場合に実行されるカスタムエラー処理オプションを指定できます。 値を破棄するか、設定する値を指定するか、設定するエラーメッセージを指定してください。| |<|*CSVからJSON*|CSVファイルデータをJSON形式に変換します。<br>詳細については[CSVからJSONへの前処理](/manual/config/items/preprocessing/csv_to_json#csv_header_processing)を参照してください。<br>4.4.0以降でサポートされています。| |^|*XMLからJSON*|XML形式のデータをJSONに変換します。<br>詳細については、[シリアル化ルール](/manual/config/items/preprocessing/javascript/javascript_objects#serialization_rules)を参照してください。<br>*失敗時のカスタマイズ*チェックボックスをオンにすると、カスタムエラー処理オプションを指定できます。 値を破棄するか、設定する値を指定するか、設定するエラーメッセージを指定してください。| |カスタムスクリプト|<|<| |<|*JavaScript*|パラメータフィールドをクリックしたとき、または*クリックして表示または変更*をクリックしたときに表示されるブロックにJavaScriptコードを入力します。<br>使用可能なJavaScriptの長さは[使用するデータベース](/manual/config/items/item#custom_script_limit)によって異なります。<br >詳細については、[Javascriptの前処理](/manual/config/items/preprocessing/javascript)を参照してください。| |バリデーション|<|<| |<|*正規表現と一致しない*|値が一致してはならない正規表現を指定します。<br>例：`Error:(.*?)\.`<br>*失敗時のカスタマイズ*チェックボックスをオンにすると、カスタムエラー処理オプションを指定できます：値を破棄するか、指定された値を設定するか、指定されたエラーメッセージを設定します。| |^|*JSON内のエラーチェック*|JSONpathにあるアプリケーションレベルのエラーメッセージを確認します。 成功し、メッセージが空でない場合は処理を停止します。 それ以外の場合は、この保存前処理ステップの前の値で処理を続行します。 これらの外部サービスエラーは、保存前処理ステップ情報を追加せずに、そのままユーザーに報告されることに注意してください。<br>例：`$.errors`が`{"errors":"e1"}``のようなJSONを受信した場合、次の保存前処理ステップは実行されません。<br>*失敗時のカスタマイズ*チェックボックスをオンにすると、カスタムエラー処理オプションを指定できます。 値を破棄するか、設定する値を指定するか、設定するエラーメッセージを指定してください| |^|*XML内のエラーチェック*|xpathにあるアプリケーションレベルのエラーメッセージを確認します。 成功し、メッセージが空でない場合は処理を停止します。 それ以外の場合は、この保存前処理ステップの前の値で処理を続行します。 これらの外部サービスエラーは、保存前処理ステップ情報を追加せずに、そのままユーザーに報告されることに注意してください。<br>無効なXMLの解析に失敗しても、エラーは報告されません。<br>4.4.0以降でサポートされています。<br>*失敗時のカスタマイズ*チェックボックスをオンにすると、カスタムエラー処理オプションを指定できます。 値を破棄するか、設定する値を指定するか、設定するエラーメッセージを指定してください| |絞り込み|<|<| |<|*指定秒内に変化が無ければ破棄*|定義された期間（秒単位）内に値が変更されなかった場合は、値を破棄します。<br>秒を指定するために正の整数値がサポートされています。（最小 - 1秒） このフィールドではタイムサフィックスを使用できます。（30s,1m,2h,1d など） このフィールドではユーザーマクロとローレベルディスカバリマクロを使用できます。<br>ディスカバリアイテムに指定できるスロットルオプションは1つだけです。<br>例：`1m` 同一のテキストが60秒以内に2回このルールに渡された場合、そのテキストは破棄されます。<br> *注*：アイテムのプロトタイプを変更しても、スロットリングはリセットされません。 スロットリングは保存前処理ステップが変更された場合にのみリセットされます。| |Prometheus|<|<| |<|*PrometheusからJSON*|PrometheusメトリックをJSONに変換します。<br>詳細については[Prometheusチェック](/manual/config/items/itemtypes/prometheus)を参照してください。|  テンプレートを介してディスカバリルールがホストに適用されている場合、このタブのコンテンツは読み取り専用であることに注意してください。

en-us	#### Preprocessing workers  Zabbix server configuration file allows users to set count of preprocessing worker processes. StartPreprocessors configuration parameter should be used to set number of pre-forked instances of preprocessing workers. Optimal number of preprocessing workers can be determined by many factors, including the count of "preprocessable" items (items that require to execute any preprocessing steps), count of data gathering processes, average step count for item preprocessing, etc.  But assuming that there is no heavy preprocessing operations like parsing of large XML / JSON chunks, number of preprocessing workers can match total number of data gatherers. This way, there will mostly (except for the cases when data from gatherer comes in bulk) be at least one unoccupied preprocessing worker for collected data.  ::: notewarning Too many data gathering processes (pollers, unreachable pollers, ODBC pollers, HTTP pollers, Java pollers, pingers, trappers, proxypollers) together with IPMI manager, SNMP trapper and preprocessing workers can exhaust the per-process file descriptor limit for the preprocessing manager. This will cause Zabbix server to stop (usually shortly after the start, but sometimes it can take more time). The configuration file should be revised or the limit should be raised to avoid this situation. :::
ja	#### プリプロセスワーカー  Zabbixサーバ設定ファイルでは、プリプロセスワーカープロセスの数を設定することができます。<br> StartPreprocessors 設定パラメータを使用して、フォークされたプリプロセスワーカーインスタンスの数を設定する必要があります。<br> 最適なプリプロセスワーカーの数は、"プリプロセッシング可能な"アイテムの数など、多くの要因によって決まります。<br> データ収集プロセスの数、item の前処理にかかる平均ステップ数などです。<br>  しかし、大きなXML/JSONチャンクのパースなどの重いプリプロセスがないと仮定すると、<br> プリプロセスワーカーの数はデータ収集プロセスの総数と一致させることができます。この方法では、ほとんどの場合<br> （ギャザラーからのデータが大量に来る場合を除く）、少なくとも1つの空いたプリプロセスワーカーが存在することになります。<br>  ::: notewarning データ収集プロセスが多すぎる (ポーラ、到達不能ポーラ、ODBC ポーラ、HTTP ポーラ、Java ポーラ、pingers、trappers,<br> プロキシポーラ) ケースで、IPMI マネージャ、SNMP トラッパ、プリプロセスワーカーを一緒に使用すると、<br> プリプロセスマネージャのプロセスごとのファイルディスクリプタを使い果たす可能性があります。<br> この場合、Zabbixサーバは停止します。(通常は起動後すぐに停止しますが、もっと時間がかかる場合もあります)<br> この状況を回避するために、設定ファイルを修正するか、制限値を上げる必要があります。<br> :::

en-us	### Pre-requisites  Install MySQL database from the [official repository](https://dev.mysql.com/downloads/repo/yum/).  See [MySQL documentation](https://dev.mysql.com/doc/mysql-yum-repo-quick-guide/en/) for details on how to use MySQL repo.  MySQL server is ready to accept secure connections using a self-signed certificate.  To see, which users are using an encrypted connection, run the following query (Performance Schema should be turned ON):      mysql> SELECT sbt.variable_value AS tls_version, t2.variable_value AS cipher, processlist_user AS user, processlist_host AS host              FROM performance_schema.status_by_thread  AS sbt             JOIN performance_schema.threads AS t ON t.thread_id = sbt.thread_id             JOIN performance_schema.status_by_thread AS t2 ON t2.thread_id = t.thread_id             WHERE sbt.variable_name = 'Ssl_version' and t2.variable_name = 'Ssl_cipher'             ORDER BY tls_version;
ja	### 前提条件  [公式リポジトリ](https://dev.mysql.com/downloads/repo/yum/)からMySQLデータベースをインストールします。  MySQLリポジトリの使用方法詳細については[MySQLのドキュメント](https://dev.mysql.com/doc/mysql-yum-repo-quick-guide/en/)を参照してください。  MySQLサーバーは、自己署名証明書を使用して安全な接続を受け入れる準備ができています。  暗号化された接続を使用しているユーザーを確認するには、次のクエリを実行します（パフォーマンススキーマをオンにする必要があります）：      mysql> SELECT sbt.variable_value AS tls_version, t2.variable_value AS cipher, processlist_user AS user, processlist_host AS host                  FROM performance_schema.status_by_thread  AS sbt                 JOIN performance_schema.threads AS t ON t.thread_id = sbt.thread_id                 JOIN performance_schema.status_by_thread AS t2 ON t2.thread_id = t.thread_id                 WHERE sbt.variable_name = 'Ssl_version' and t2.variable_name = 'Ssl_cipher'                 ORDER BY tls_version;

en-us	### Pre-requisites  Install the PostgreSQL database using the [official repository](https://www.postgresql.org/download/linux/redhat/).  PostgreSQL is not configured to accept TLS connections out-of-the-box. Please follow instructions from PostgreSQL documentation for [certificate preparation with postgresql.conf](https://www.postgresql.org/docs/13/ssl-tcp.html) and also for [user access control](https://www.postgresql.org/docs/13/auth-pg-hba-conf.html) through ph\_hba.conf.  By default, the PostgreSQL socket is binded to the localhost, for the network remote connections allow to listen on the real network interface.  PostgreSQL settings for all [modes](/manual/appendix/install/db_encrypt#terminology) can look like this:  **/var/lib/pgsql/13/data/postgresql.conf:**      ...     ssl = on     ssl_ca_file = 'root.crt'     ssl_cert_file = 'server.crt'     ssl_key_file = 'server.key'     ssl_ciphers = 'HIGH:MEDIUM:+3DES:!aNULL'     ssl_prefer_server_ciphers = on     ssl_min_protocol_version = 'TLSv1.3'     ...  For access control adjust */var/lib/pgsql/13/data/pg\_hba.conf*:      ...     ### require     hostssl all all 0.0.0.0/0 md5      ### verify CA     hostssl all all 0.0.0.0/0 md5 clientcert=verify-ca      ### verify full     hostssl all all 0.0.0.0/0 md5 clientcert=verify-full     ...
ja	### 前提条件  [公式リポジトリ](https://www.postgresql.org/download/linux/redhat/)を使用してPostgreSQLデータベースをインストールします。  PostgreSQLは、すぐにTLS接続を受け入れるように構成されていません。[postgresql.confを使用した証明書の準備](https://www.postgresql.org/docs/13/ssl-tcp.html)およびph\_hba.confを介した[ユーザーアクセス制御](https://www.postgresql.org/docs/13/auth-pg-hba-conf.html)については、PostgreSQLのドキュメントの指示に従ってください。  デフォルトでは、PostgreSQLソケットはローカルホストにバインドされています。これは、ネットワークリモート接続が実際のネットワークインターフェイスでリッスンできるようにするためです。  すべての[モード](/manual/appendix/install/db_encrypt#terminology) のPostgreSQL設定は次のようになります。  **/var/lib/pgsql/13/data/postgresql.conf:**         ...        ssl = on        ssl_ca_file = 'root.crt'        ssl_cert_file = 'server.crt'        ssl_key_file = 'server.key'        ssl_ciphers = 'HIGH:MEDIUM:+3DES:!aNULL'        ssl_prefer_server_ciphers = on        ssl_min_protocol_version = 'TLSv1.3'        ...  アクセス制御については*/var/lib/pgsql/13/data/pg\_hba.conf*を調整します。         ...        ### require        hostssl all all 0.0.0.0/0 md5                ### verify CA        hostssl all all 0.0.0.0/0 md5 clientcert=verify-ca                ### verify full        hostssl all all 0.0.0.0/0 md5 clientcert=verify-full        ...

en-us	 ### Pre-requisites  Prior to configuring service monitoring, you need to have the hosts configured:  - *HA node 1* with at least one trigger and a tag (preferably set on a trigger level) `component:HA node 1` - *HA node 2* with at least one trigger and a tag (preferably set on a trigger level) `component:HA node 2`
ja	### 前提条件  サービス監視を設定する前に、ホストを設定する必要があります。  - *HA node 1*と少なくとも1つのトリガーとタグ（できればトリガーレベルで設定） `component：HA node 1` - *HA node 2*と少なくとも1つのトリガーとタグ（できればトリガーレベルで設定） `component：HA node 2`

en-us	 #### Primary keys  Primary keys are now used for all tables, including history tables, in new installations.  There is no automatic upgrade to primary keys for existing installations.  Instructions for a **manual upgrade** of history tables to primary keys in  pre-existing installations are available for  [MySQL/MariaDB](/manual/appendix/install/db_primary_keys#mysql),  [PostgreSQL](/manual/appendix/install/db_primary_keys#postgresql),  [TimescaleDB v1](/manual/appendix/install/db_primary_keys#timescaledb-v1) and  [v2](/manual/appendix/install/db_primary_keys#timescaledb-v2),  and [Oracle](/manual/appendix/install/db_primary_keys#oracle).  
ja	 #### Primary keys  Primary keys are now used for all tables, including history tables, in new installations.  There is no automatic upgrade to primary keys for existing installations.  Instructions for a **manual upgrade** of history tables to primary keys in  pre-existing installations are available for  [MySQL/MariaDB](manual/appendix/install/db_primary_keys#mysql),  [PostgreSQL](manual/appendix/install/db_primary_keys#posgresql),  [TimescaleDB v1](manual/appendix/install/db_primary_keys#timescaledb-v1) and  [v2](manual/appendix/install/db_primary_keys#timescaledb-v2),  and [Oracle](manual/appendix/install/db_primary_keys#oracle).  

en-us	 #### Primary keys  Primary keys are now used for all tables, including history tables, in new installations.  There is no automatic upgrade to primary keys for existing installations.  Instructions for a **manual upgrade** of history tables to primary keys in  pre-existing installations are available for  [MySQL/MariaDB](/manual/appendix/install/db_primary_keys#mysql),  [PostgreSQL](/manual/appendix/install/db_primary_keys#postgresql),  [TimescaleDB v1](/manual/appendix/install/db_primary_keys#timescaledb-v1) and  [v2](/manual/appendix/install/db_primary_keys#timescaledb-v2),  and [Oracle](/manual/appendix/install/db_primary_keys#oracle).  
ja	 #### Primary keys  Primary keys are now used for all tables, including history tables, in new installations.  There is no automatic upgrade to primary keys for existing installations.  Instructions for a **manual upgrade** of history tables to primary keys in  pre-existing installations are available for  [MySQL/MariaDB](manual/appendix/install/db_primary_keys#mysql),  [PostgreSQL](manual/appendix/install/db_primary_keys#posgresql),  [TimescaleDB v1](manual/appendix/install/db_primary_keys#timescaledb-v1) and  [v2](manual/appendix/install/db_primary_keys#timescaledb-v2),  and [Oracle](manual/appendix/install/db_primary_keys#oracle).  

en-us	 #### Primary keys  Primary keys are now used for all tables, including history tables, in new installations.  There is no automatic upgrade to primary keys for existing installations. Instructions for a **manual upgrade** of history tables to primary keys in pre-existing installations are available for [MySQL/MariaDB](/manual/appendix/install/db_primary_keys#mysql),  [PostgreSQL](/manual/appendix/install/db_primary_keys#postgresql),  [TimescaleDB v1](/manual/appendix/install/db_primary_keys#timescaledb-v1) and  [v2](/manual/appendix/install/db_primary_keys#timescaledb-v2),  and [Oracle](/manual/appendix/install/db_primary_keys#oracle).
ja	 #### プライマリーキー  新規インストール時に、ヒストリテーブルを含むすべてのテーブルでプライマリーキーを使用するようになりました。  既存環境のプライマリーキーへの自動アップグレードはありません。 Instructions for a **manual upgrade** of history tables to primary keys in pre-existing installations are available for ヒストリテーブルを既存のインストールのプライマリーキーに**手動アップグレード**する手順は、次のリンクを参照してください。 [MySQL/MariaDB](/manual/appendix/install/db_primary_keys#mysql)、 [PostgreSQL](/manual/appendix/install/db_primary_keys#postgresql)、 [TimescaleDB v1](/manual/appendix/install/db_primary_keys#timescaledb-v1)、 [v2](/manual/appendix/install/db_primary_keys#timescaledb-v2)、 [Oracle](/manual/appendix/install/db_primary_keys#oracle)。

en-us	 ##### Primary keys  Primary keys are now used for all tables, including history tables, in new installations.  There is no automatic upgrade to primary keys for existing installations.  Instructions for a **manual upgrade** of history tables to primary keys in  pre-existing installations are available for  [MySQL/MariaDB](/manual/appendix/install/db_primary_keys#mysql),  [PostgreSQL](/manual/appendix/install/db_primary_keys#postgresql),  [TimescaleDB v1](/manual/appendix/install/db_primary_keys#timescaledb-v1) and  [v2](/manual/appendix/install/db_primary_keys#timescaledb-v2),  and [Oracle](/manual/appendix/install/db_primary_keys#oracle).
ja	### プライマリーキー  新規インストール時に、履歴テーブルを含むすべてのテーブルでプライマリーキーを使用するようになりました。  既存環境への主キーの自動アップグレードはありません。 <br> 履歴テーブルを主キーに **手動で**アップグレードする方法については以下のリンクを参照してください。 <br>  [MySQL/MariaDB](/manual/appendix/install/db_primary_keys#mysql)  <br> [PostgreSQL](/manual/appendix/install/db_primary_keys#postgresql)  <br> [TimescaleDB v1](/manual/appendix/install/db_primary_keys#timescaledb-v1)  and [v2](/manual/appendix/install/db_primary_keys#timescaledb-v2)  <br> [Oracle](/manual/appendix/install/db_primary_keys#oracle) <br>

en-us	#### Principle of least privilege  The principle of least privilege should be used at all times for Zabbix. This principle means that user accounts (in Zabbix frontend) or process user (for Zabbix server/proxy or agent) have only those privileges that are essential to perform intended functions. In other words, user accounts at all times should run with as few privileges as possible.  ::: noteimportant Giving extra permissions to 'zabbix' user will allow it to access configuration files and execute operations that can compromise the overall security of the infrastructure. :::  When implementing the least privilege principle for user accounts, Zabbix [frontend user types](/manual/config/users_and_usergroups/permissions) should be taken into account. It is important to understand that while a "Admin" user type has less privileges than "Super Admin" user type, it has administrative permissions that allow managing configuration and execute custom scripts.  ::: noteclassic Some information is available even for non-privileged users. For example, while *Administration* → *Scripts* is not available for non-Super Admins, scripts themselves are available for retrieval by using Zabbix API. Limiting script permissions and not adding sensitive information (like access credentials, etc) should be used to avoid exposure of sensitive information available in global scripts. :::
ja	#### 最小権限の原則  Zabbixでは常に最小権限の原則を使用する必要があります。 この原則は、ユーザーアカウント(Webインターフェース) またはプロセスユーザー(Zabbixサーバー/プロキシ/エージェント) が、意図した機能を実行するために必要な権限のみを持つことを意味します。 言い換えると、ユーザーアカウントは常に、できるだけ少ない権限で実行する必要があります。  ::: noteimportant 'zabbix'ユーザーに追加の権限を与えると、設定ファイルにアクセスし、インフラストラクチャ全体のセキュリティを侵害する可能性のある操作を実行できるようになります。 :::  ユーザー アカウントに最小権限の原則を実装する場合、Zabbix [Webインターフェースのユーザータイプ](/manual/config/users_and_usergroups/permissions)を考慮する必要があります。 "Admin"ユーザータイプの権限は"Super Admin"ユーザータイプよりも低いですが、設定の管理やカスタムスクリプトの実行を許可する管理権限があることを理解することが重要です。  ::: noteclassic 一部の情報は、権限を持たないユーザーでも利用できます。 たとえば、*管理* → *スクリプト* はSuper Admin以外は利用できませんが、スクリプト自体はZabbix APIを使用して取得できます。 グローバルスクリプトで利用可能な機密情報の公開を避けるために、スクリプトのアクセス許可を制限し、機密情報 (アクセス資格情報など) を追加しないようにする必要があります。 :::

en-us	#### Problem event popup  The problem event popup includes the list of problem events for this trigger and, if defined, the trigger description and a clickable URL.  ![](../../../../../assets/en/manual/web_interface/problem_event_popup.png){width="600"}  To bring up the problem event popup:  -   roll a mouse over the problem duration in the *Duration* column of     the *Problems* widget. The popup disappears once you remove the     mouse from the duration. -   click on the duration in the *Duration* column of the *Problems*     widget. The popup disappears only if you click on the duration     again.
ja	#### 障害イベントのポップアップ  障害イベントのポップアップには、このトリガーの障害イベントのリストと、定義されている場合はトリガーの説明とクリック可能な URL が含まれます。  ![](../../../../../assets/en/manual/web_interface/problem_event_popup.png){width="600"}  障害のイベントポップアップを表示するには:  -   *障害*ウィジェットの*継続期間*列で障害期間にマウスオーバーします。 期間からマウスを離すとポップアップが消えます。 -   *障害*ウィジェットの*継続期間*列の期間をクリックします。 期間をもう一度クリックするとポップアップが消えます。

en-us	#### Problem events  A problem event is created:  -   when a trigger expression evaluates to TRUE if the trigger is in OK     state; -   each time a trigger expression evaluates to TRUE if multiple problem     event generation is enabled for the trigger.
ja	#### 障害イベント  次のとき、障害イベントが作成されます。  -   トリガーが正常ステータスの場合、トリガー式がTRUEと評価されたときに。 -   トリガーに対して複数の障害イベントの生成が有効になっている場合、トリガー式がTRUEと評価されるたびに。

en-us	# problem.get
ja	# problem.get

en-us	#### Problems  Retrieve problems according to the given parameters.  [Problem API](/manual/api/reference/problem)
ja	#### 障害  指定されたパラメータに従って、障害を取得します。  [Problem API](/manual/api/reference/problem)

en-us	### Problem tag  Problem tags allow linking services with problem events. The problem tag object has the following properties.  | Property              | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                 | |-----------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------| | **tag**<br>(required) | string                                              | Problem tag name.                                                                           | | operator              | integer                                             | Mapping condition operator.<br><br>Possible values:<br>0 - *(default)* equals;<br>2 - like. | | value                 | string                                              | Problem tag value.                                                                          |
ja	### Problem tag  Problem tagを使用すると、サービスを障害イベントにリンクできます。 Problem tagオブジェクトには、次のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |-----------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------| |**tag**<br>(必須)|string|障害タグ名| |operator|integer|マッピング条件演算子<br><br>使用可能な値：<br> 0 - *(デフォルト)*等しい<br>2 - like| |value|string|障害タグ値|

en-us	 #### Problem tags  Problem tags are used to match problems and services. These tags are specified at the primary service configuration tab.   Only child services of the lowest hierarchy level may have problem tags defined and be directly correlated to problems. If problem tags match,  the service status will change to the same status as the problem has. In case of several problems, a service will have the status of the most severe one. Status of a  parent service is then calculated based on child services statuses according to Status calculation rules.   If several tags are specified, *AND* logic is used: a problem must have all tags  specified in the service configuration to be mapped to the service.   ![](../../../assets/en/manual/config/problem_tags.png){width=600}   :::noteclassic A problem in Zabbix inherits tags from the whole chain of templates, hosts, items, web scenarios, and triggers. Any of these tags can be used for matching problems to services. ::: 
ja	#### 問題タグ  問題タグは、問題とサービスを照合するために使用されます。これらのタグは、プライマリサービス設定タブで指定されます。  ![](../../../assets/en/manual/config/problem_tags.png){width=600}  Zabbixは問題タグをチェックして、いずれかのサービスの問題タグ一致ルールに一致するかどうかを確認します。サービスには、いくつかの問題タグルールが定義されている場合があります。この場合、問題タグはすべての条件を満たす必要があります。  ::: noteclassic Zabbixの問題は、テンプレート、ホスト、アイテム、Webシナリオ、およびトリガーのチェーン全体からタグを継承します。これらのタグはいずれも、問題をサービスに一致させるために使用できます。 :::  問題タグが一致すると、サービスステータスは問題と同じステータスに変わります。いくつかの問題が発生した場合、サービスは最もレベルの高いステータスになります。  最下位の階層レベルの子サービスのみが問題タグを定義し、問題に直接関連付けることができます。次に、親サービスのステータスは、ステータス計算ルールに従って子サービスのステータスに基づいて計算されます。

en-us	### Problem tag  The problem tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Problem tag name.| |value|string|Problem tag value.|
ja	### Problem tag  障害タグオブジェクトには、次のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |tag|string|障害タグ名| |value|string|障害タグ値|

en-us	### Problem tag  The problem tag object is used to define which problems must be suppressed when the maintenance comes into effect. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Problem tag name.| |operator|integer|Condition operator.<br><br>Possible values:<br>0 - Equals;<br>2 - *(default)* Contains.| |value|string|Problem tag value.|  Tags can only be specified for maintenance periods with data collection (`"maintenance_type":0`).
ja	### 障害タグ  障害タグオブジェクトは、メンテナンスが有効になったときにどの障害を抑制しなければならないかを定義するために使用されます。 以下のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**tag**<br>(必須)|string|障害タグ名| |operator|integer|条件演算子<br><br>可能な値:<br>0 - 等しい<br>2 - *(デフォルト)*含む| |value|string|障害タグ値|  タグはデータ収集(`"maintenance_type ":0`)を使用したメンテナンス期間にのみ指定できます。

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

en-us	##### Problem update window  If a problem arises for a trigger with the *Manual close* flag, you can open the [problem update](/manual/acknowledges#updating_problems) popup window of that problem and close the problem manually.  To close the problem, check the *Close problem* option in the form and click on *Update*.  ![](../../../../assets/en/manual/config/close_problem1.png)  All mandatory input fields are marked with a red asterisk.  The request is processed by Zabbix server. Normally it will take a few seconds to close the problem. During that process *CLOSING* is displayed in *Monitoring* → *Problems* as the status of the problem.
ja	##### 問題の更新ウィンドウ  *手動クローズ*フラグの付いたトリガーに問題が発生した場合、[問題の認識](/manual/acknowledges#updating-problems)ポップアップウィンドウを開いて、<br> 手動で問題を閉じることができます。  問題を閉じるには、フォームの *Close problem*（障害のクローズ） オプションをチェックし、*Update*（更新） をクリックします。  ![](../../../../assets/en/manual/config/close_problem1.png)  すべての必須入力項目には赤いアスタリスクが表示されます。  リクエストはZabbixサーバによって処理されます。通常、問題を解決するのに数秒かかります。この間、問題のステータスとして<br> *監視データ* → *障害* に *解決済* が表示されます。

en-us	##### Problem with dots  So far so good. But what if an attribute name or a hash key contains dot symbol? Here is an example:      jmx[com.example:Type=Hello,all.fruits.apple.weight]  That's a problem. How to tell Zabbix that attribute name is "all.fruits", not just "all"? How to distinguish a dot that is part of the name from the dot that separates an attribute name and hash keys?  Before **2.0.4** Zabbix Java gateway was unable to handle such situations and users were left with UNSUPPORTED items. Since 2.0.4 this is possible, all you need to do is to escape the dots that are part of the name with a backslash:      jmx[com.example:Type=Hello,all\.fruits.apple.weight]  Same way, if your hash key contains a dot you escape it:      jmx[com.example:Type=Hello,all\.fruits.apple.total\.weight]
ja	##### ドットの問題  ここまではいい。しかし、属性名やハッシュキーにドット記号が含まれている場合はどうでしょうか。 以下はその例です。      jmx[com.example:Type=Hello,all.fruits.apple.weight]  これは問題です。属性名が "all" ではなく "all.fruits" であることをZabbixに伝えるにはどうすればよいですか？ 名前の一部であるドットと属性名やハッシュキーの区切りであるドットを区別する方法は？  **2.0.4** 以前のZabbix Java gateway はこのような状況に対応することができず、ユーザは UNSUPPORTED item が 表示されたままになっていました。2.0.4以降では、名前の一部であるドットをバックスラッシュでエスケープすることで、 この問題を解決することができます。      jmx[com.example:Type=Hello,all\.fruits.apple.weight]  同じように、ハッシュキーにドットが含まれている場合は、それをエスケープします。      jmx[com.example:Type=Hello,all\.fruits.apple.total\.weight]

en-us	##### Process data  |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**proc.cpu.util**\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]|<|<|<| |Process CPU utilization percentage.|Float|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**type** - CPU utilization type:<br>*total* (default), *user*, *system*<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**mode** - data gathering mode: *avg1* (default), *avg5*, *avg15*<br>**zone** - target zone: *current* (default), *all*. This parameter is supported on Solaris only.|Examples:<br>=> proc.cpu.util\[,root\] → CPU utilization of all processes running under the "root" user<br>=> proc.cpu.util\[zabbix\_server,zabbix\] → CPU utilization of all zabbix\_server processes running under the zabbix user<br><br>The returned value is based on single CPU core utilization percentage. For example CPU utilization of a process fully using two cores is 200%.<br><br>The process CPU utilization data is gathered by a collector which supports the maximum of 1024 unique (by name, user and command line) queries. Queries not accessed during the last 24 hours are removed from the collector.<br><br>*Note* that when setting the `zone` parameter to *current* (or default) in case the agent has been compiled on a Solaris without zone support, but running on a newer Solaris where zones are supported, then the agent will return NOTSUPPORTED (the agent cannot limit results to only the current zone). However, *all* is supported in this case.<br><br>This key is supported since Zabbix 3.0.0 and is available on several platforms (see [Items supported by platform](/manual/appendix/items/supported_by_platform)).| |**proc.mem**\[<name>,<user>,<mode>,<cmdline>,<memtype>\]|<|<|<| |Memory used by process in bytes.|Integer - with `mode` as *max*, *min*, *sum*<br><br>Float - with `mode` as *avg*|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**mode** - possible values:<br>*avg*, *max*, *min*, *sum* (default)<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**memtype** - [type of memory](/manual/appendix/items/proc_mem_notes) used by process|Examples:<br>=> proc.mem\[,root\] → memory used by all processes running under the "root" user<br>=> proc.mem\[zabbix\_server,zabbix\] → memory used by all zabbix\_server processes running under the zabbix user<br>=> proc.mem\[,oracle,max,oracleZABBIX\] → memory used by the most memory-hungry process running under oracle having oracleZABBIX in its command line<br><br>*Note*: When several processes use shared memory, the sum of memory used by processes may result in large, unrealistic values.<br><br>See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).<br><br>When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.mem[,,,apache2]`), one extra process will be counted, as the agent will count itself.<br><br>The `memtype` parameter is supported on several [platforms](/manual/appendix/items/supported_by_platform) since Zabbix 3.0.0.| |**proc.num**\[<name>,<user>,<state>,<cmdline>,<zone>\]|<|<|<| |The number of processes.|Integer|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**state** (*disk* and *trace* options since version 3.4.0) - possible values:<br>*all* (default),<br>*disk* - uninterruptible sleep,<br>*run* - running,<br>*sleep* - interruptible sleep,<br>*trace* - stopped,<br>*zomb* - zombie<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**zone** - target zone: *current* (default), *all*. This parameter is supported on Solaris only.|Examples:<br>=> proc.num\[,mysql\] → number of processes running under the mysql user<br>=> proc.num\[apache2,www-data\] → number of apache2 processes running under the www-data user<br>=> proc.num\[,oracle,sleep,oracleZABBIX\] → number of processes in sleep state running under oracle having oracleZABBIX in its command line<br><br>See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).<br><br>On Windows, only the `name` and `user` parameters are supported.<br><br>When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.num[,,,apache2]`), one extra process will be counted, as the agent will count itself.<br><br>*Note* that when setting the `zone` parameter to *current* (or default) in case the agent has been compiled on a Solaris without zone support, but running on a newer Solaris where zones are supported, then the agent will return NOTSUPPORTED (the agent cannot limit results to only the current zone). However, *all* is supported in this case.|
ja	##### プロセスデータ  |アイテムキー|<|<|<| |--|--|------|------| |説明|戻り値|パラメータ|コメント| |**proc.cpu.util**\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]|<|<|<| |プロセスの CPU 使用率|Float|**name** - プロセス名 (デフォルトは *すべてのプロセス*)<br>**user** - ユーザー名 (デフォルトは *すべてのユーザー*)<br>**type** - CPU 使用率のタイプ:<br>*total* (デフォルト), *user*, *system*<br>**cmdline** - コマンドラインでフィルター([正規表現](/manual/regular_expressions#overview)です)<br>**mode** - データ収集モード: *avg1* (デフォルト), *avg5*, *avg15*<br>**zone** - ターゲットゾーン: *current* (デフォルト), *all*. このパラメータは、Solaris でのみサポートされています|例:<br>=> proc.cpu.util\[,root\] → "root"ユーザーの下で実行されているすべてのプロセスの CPU 使用率<br>=> proc.cpu.util\[zabbix\_server,zabbix\] → zabbix ユーザーの下で実行されているすべての zabbix\_server プロセスの CPU 使用率<br><br>返される値は、単一の CPU コアの使用率に基づいています。 たとえば、2 つのコアを完全に使用するプロセスの CPU 使用率は 200% です。<br><br>プロセスの CPU 使用率データは、最大 1024 個の一意の (名前、ユーザー、およびコマンド ラインによる) クエリをサポートするコレクターによって収集されます。 過去 24 時間にアクセスされなかったクエリは、コレクターから削除されます。<br><br>*注意* エージェントがゾーンをサポートしていない Solaris でコンパイルされているが、ゾーンがサポートされている新しい Solaris で実行されている場合、`zone` パラメータを *current* (またはデフォルト) に設定すると、エージェントは NOTSUPPORTED を返します。 (エージェントは結果を現在のゾーンのみに制限することはできません)。 ただし、この場合は *all* がサポートされます。<br><br>このキーは Zabbix 3.0.0 以降でサポートされており、複数のプラットフォームで利用できます ([プラットフォームでサポートされている項目](/manual/appendix/items/supported_by_platform)を参照))| |**proc.mem**\[<name>,<user>,<mode>,<cmdline>,<memtype>\]|<|<|<| |プロセスが使用するメモリ (バイト単位)|Integer - `mode`が*max*, *min*, *sum*の時<br><br>Float - `mode`が*avg*の時|**name** - プロセス名(デフォルトは*すべてのプロセス*)<br>**user** - ユーザー名 (デフォルトは *すべてのユーザー*)<br>**mode** - 使用可能な値:<br>*avg*, *max*, *min*, *sum* (デフォルト)<br>**cmdline** - コマンドラインでフィルター([正規表現](/manual/regular_expressions#overview)です)<br>**memtype** - [メモリの種類](/manual/appendix/items/proc_mem_notes)プロセスで使用|例:<br>=> proc.mem\[,root\] → "root"ユーザーの下で実行されているすべてのプロセスで使用されるメモリ<br>=> proc.mem\[zabbix\_server,zabbix\] → zabbix ユーザーの下で実行されているすべての zabbix\_server プロセスによって使用されるメモリ<br>=> proc.mem\[,oracle,max,oracleZABBIX\] → コマンドラインに oracleZABBIX が含まれているオラクルの下で実行されている、最もメモリを消費するプロセスによって使用されるメモリ<br><br>*注意*: 複数のプロセスが共有メモリを使用する場合、プロセスが使用するメモリの合計は、非現実的な大きな値になる可能性があります。<br><br>[注意事項](/manual/appendix/items/proc_mem_num_notes)を参照して`name` および `cmdline` パラメータ (Linux 固有) でプロセスを選択します。<br><br>このアイテムがコマンド ラインから呼び出され、コマンド ライン パラメーターが含まれている場合 (たとえばエージェント テスト モードで: `zabbix_agentd -t proc.mem[,,,apache2]`)、1 つ余分なプロセスが実行されているようにみえます。これはエージェントが自分自身をカウントするためです。<br><br>`memtype`パラメータは、Zabbix 3.0.0 以降のいくつかの [プラットフォーム](/manual/appendix/items/supported_by_platform)でサポートされています。| |**proc.num**\[<name>,<user>,<state>,<cmdline>,<zone>\]|<|<|<| |プロセス数|Integer|**name** - プロセス名 (デフォルトは*すべてのプロセス*)<br>**user** - ユーザー名 (デフォルトは *すべてのユーザー*)<br>**state** (*disk* および *trace* オプションはバージョン 3.4.0 以降) - 使用可能な値:<br>*all* (デフォルト),<br>*disk* - 中断不能なsleep,<br>*run* - 実行中,<br>*sleep* - 中断可能なsleep,<br>*trace* - 停止,<br>*zomb* - ゾンビプロセス<br>**cmdline** - コマンドラインでフィルター([正規表現](/manual/regular_expressions#overview)です)<br>**zone** - ターゲットゾーン: *current* (デフォルト), *all*. このパラメータはSolaris でのみサポートされています。|例:<br>=> proc.num\[,mysql\] → mysql ユーザーの下で実行されているプロセスの数<br>=> proc.num\[apache2,www-data\] → www-data ユーザーの下で実行されている apache2 プロセスの数<br>=> proc.num\[,oracle,sleep,oracleZABBIX\] → コマンド ラインに oracleZABBIX を含む Oracle で実行されているスリープ状態のプロセスの数<br><br>[注意事項](/manual/appendix/items/proc_mem_num_notes)を参照して`name` および `cmdline` パラメータ (Linux 固有) でプロセスを選択します。<br><br>Windows では、`name` および `user` パラメータのみがサポートされています。<br><br>このアイテムがコマンド ラインから呼び出され、コマンド ライン パラメーターが含まれている場合 (たとえばエージェント テスト モードで: `zabbix_agentd -t proc.mem[,,,apache2]`)、1 つ余分なプロセスが実行されているようにみえます。これはエージェントが自分自身をカウントするためです。<br><br>*注意* エージェントがゾーンをサポートしていない Solaris でコンパイルされているが、ゾーンがサポートされている新しい Solaris で実行されている場合、`zone` パラメータを *current* (またはデフォルト) に設定すると、エージェントは NOTSUPPORTED を返します。 (エージェントは結果を現在のゾーンのみに制限することはできません)。 ただし、この場合は *all* がサポートされます。|

en-us	 ## Processes
ja	 ## プロセス

en-us	#### Processes modifying their commandline  Some programs use modifying their commandline as a method for displaying their current activity. A user can see the activity by running `ps` and `top` commands. Examples of such programs include *PostgreSQL*, *Sendmail*, *Zabbix*.  Let's see an example from Linux. Let's assume we want to monitor a number of Zabbix agent processes.  `ps` command shows processes of interest as      $ ps -fu zabbix     UID        PID  PPID  C STIME TTY          TIME CMD     ...     zabbix    6318     1  0 12:01 ?        00:00:00 sbin/zabbix_agentd -c /home/zabbix/ZBXNEXT-1078/zabbix_agentd.conf     zabbix    6319  6318  0 12:01 ?        00:00:01 sbin/zabbix_agentd: collector [idle 1 sec]                               zabbix    6320  6318  0 12:01 ?        00:00:00 sbin/zabbix_agentd: listener #1 [waiting for connection]                 zabbix    6321  6318  0 12:01 ?        00:00:00 sbin/zabbix_agentd: listener #2 [waiting for connection]                 zabbix    6322  6318  0 12:01 ?        00:00:00 sbin/zabbix_agentd: listener #3 [waiting for connection]                 zabbix    6323  6318  0 12:01 ?        00:00:00 sbin/zabbix_agentd: active checks #1 [idle 1 sec]                        ...  Selecting processes by name and user does the job:      $ zabbix_get -s localhost -k 'proc.num[zabbix_agentd,zabbix]'     6  Now let's rename `zabbix_agentd` executable to `zabbix_agentd_30` and restart it.  `ps` now shows      $ ps -fu zabbix     UID        PID  PPID  C STIME TTY          TIME CMD     ...     zabbix    6715     1  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30 -c /home/zabbix/ZBXNEXT-1078/zabbix_agentd.conf     zabbix    6716  6715  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30: collector [idle 1 sec]                               zabbix    6717  6715  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30: listener #1 [waiting for connection]                 zabbix    6718  6715  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30: listener #2 [waiting for connection]                 zabbix    6719  6715  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30: listener #3 [waiting for connection]                 zabbix    6720  6715  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30: active checks #1 [idle 1 sec]                        ...  Now selecting processes by name and user produces an incorrect result:      $ zabbix_get -s localhost -k 'proc.num[zabbix_agentd_30,zabbix]'     1  Why a simple renaming of executable to a longer name lead to quite different result ?  Zabbix agent starts with checking the process name. `/proc/<pid>/status` file is opened and the line `Name` is checked. In our case the `Name` lines are:      $ grep Name /proc/{6715,6716,6717,6718,6719,6720}/status     /proc/6715/status:Name:   zabbix_agentd_3     /proc/6716/status:Name:   zabbix_agentd_3     /proc/6717/status:Name:   zabbix_agentd_3     /proc/6718/status:Name:   zabbix_agentd_3     /proc/6719/status:Name:   zabbix_agentd_3     /proc/6720/status:Name:   zabbix_agentd_3  The process name in `status` file is truncated to 15 characters.  A similar result can be seen with `ps` command:      $ ps -u zabbix       PID TTY          TIME CMD     ...      6715 ?        00:00:00 zabbix_agentd_3      6716 ?        00:00:01 zabbix_agentd_3      6717 ?        00:00:00 zabbix_agentd_3      6718 ?        00:00:00 zabbix_agentd_3      6719 ?        00:00:00 zabbix_agentd_3      6720 ?        00:00:00 zabbix_agentd_3      ...  Obviously, that is not equal to our `proc.num[]` `name` parameter value `zabbix_agentd_30`. Having failed to match the process name from `status` file the Zabbix agent turns to `/proc/<pid>/cmdline` file.  How the agent sees the "cmdline" file can be illustrated with running a command      $ for i in 6715 6716 6717 6718 6719 6720; do cat /proc/$i/cmdline | awk '{gsub(/\x0/,"<NUL>"); print};'; done     sbin/zabbix_agentd_30<NUL>-c<NUL>/home/zabbix/ZBXNEXT-1078/zabbix_agentd.conf<NUL>     sbin/zabbix_agentd_30: collector [idle 1 sec]<NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL>...     sbin/zabbix_agentd_30: listener #1 [waiting for connection]<NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL>...     sbin/zabbix_agentd_30: listener #2 [waiting for connection]<NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL>...     sbin/zabbix_agentd_30: listener #3 [waiting for connection]<NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL>...     sbin/zabbix_agentd_30: active checks #1 [idle 1 sec]<NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL>...  `/proc/<pid>/cmdline` files in our case contain invisible, non-printable null bytes, used to terminate strings in *C* language. The null bytes are shown as "<NUL>" in this example.  Zabbix agent checks "cmdline" for the main process and takes a `zabbix_agentd_30`, which matches our `name` parameter value `zabbix_agentd_30`. So, the main process is counted by item `proc.num[zabbix_agentd_30,zabbix]`.  When checking the next process, the agent takes `zabbix_agentd_30: collector [idle 1 sec]` from the `cmdline` file and it does not meet our `name` parameter `zabbix_agentd_30`. So, only the main process which does not modify its commandline, gets counted. Other agent processes modify their command line and are ignored.  This example shows that the `name` parameter cannot be used in `proc.mem[]` and `proc.num[]` for selecting processes in this case.  Using `cmdline` parameter with a proper regular expression produces a correct result:      $ zabbix_get -s localhost -k 'proc.num[,zabbix,,zabbix_agentd_30[ :]]'     6  Be careful when using `proc.mem[]` and `proc.num[]` items for monitoring programs which modify their commandlines.  Before putting `name` and `cmdline` parameters into `proc.mem[]` and `proc.num[]` items, you may want to test the parameters using `proc.num[]` item and `ps` command.
ja	#### コマンドラインを変更するプロセス  一部のプログラムでは、現在のアクティビティを表示する方法としてコマンドラインの変更を使用しています。 ユーザーは、`ps`および`top`コマンドを実行することでアクティビティを確認できます。 このようなプログラムとしては*PostgreSQL*,*Sendmail*,*Zabbix*が含まれます。  Linuxでの例を見てみましょう。 いくつかのZabbixエージェントプロセスを監視したいとします。  `ps`コマンドは、対象のプロセスを次のように表示します      $ ps -fu zabbix     UID        PID  PPID  C STIME TTY          TIME CMD     ...     zabbix    6318     1  0 12:01 ?        00:00:00 sbin/zabbix_agentd -c /home/zabbix/ZBXNEXT-1078/zabbix_agentd.conf     zabbix    6319  6318  0 12:01 ?        00:00:01 sbin/zabbix_agentd: collector [idle 1 sec]                               zabbix    6320  6318  0 12:01 ?        00:00:00 sbin/zabbix_agentd: listener #1 [waiting for connection]                 zabbix    6321  6318  0 12:01 ?        00:00:00 sbin/zabbix_agentd: listener #2 [waiting for connection]                 zabbix    6322  6318  0 12:01 ?        00:00:00 sbin/zabbix_agentd: listener #3 [waiting for connection]                 zabbix    6323  6318  0 12:01 ?        00:00:00 sbin/zabbix_agentd: active checks #1 [idle 1 sec]                        ...  名前とユーザーでプロセスを選択すると次のようになります。      $ zabbix_get -s localhost -k 'proc.num[zabbix_agentd,zabbix]'     6  次に`zabbix_agentd`実行可能ファイルの名前を`zabbix_agentd_30`に変更して再起動します。  `ps` now shows      $ ps -fu zabbix     UID        PID  PPID  C STIME TTY          TIME CMD     ...     zabbix    6715     1  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30 -c /home/zabbix/ZBXNEXT-1078/zabbix_agentd.conf     zabbix    6716  6715  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30: collector [idle 1 sec]                               zabbix    6717  6715  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30: listener #1 [waiting for connection]                 zabbix    6718  6715  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30: listener #2 [waiting for connection]                 zabbix    6719  6715  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30: listener #3 [waiting for connection]                 zabbix    6720  6715  0 12:53 ?        00:00:00 sbin/zabbix_agentd_30: active checks #1 [idle 1 sec]                        ...  名前とユーザーでプロセスを選択すると、誤った結果が生成されます。      $ zabbix_get -s localhost -k 'proc.num[zabbix_agentd_30,zabbix]'     1  なぜ実行可能ファイルの名前を長い名前に変更するだけで、結果がまったく異なるのでしょう？  Zabbixエージェントはプロセス名の確認から始めます。`/proc/<pid>/status`ファイルが開かれ、行`Name`がチェックされます。 この場合`Name`行は次のとおりです。      $ grep Name /proc/{6715,6716,6717,6718,6719,6720}/status     /proc/6715/status:Name:   zabbix_agentd_3     /proc/6716/status:Name:   zabbix_agentd_3     /proc/6717/status:Name:   zabbix_agentd_3     /proc/6718/status:Name:   zabbix_agentd_3     /proc/6719/status:Name:   zabbix_agentd_3     /proc/6720/status:Name:   zabbix_agentd_3  `status`ファイルのプロセス名は15文字に切り捨てられます。  同様の結果は`ps`コマンドで見ることができます。      $ ps -u zabbix       PID TTY          TIME CMD     ...      6715 ?        00:00:00 zabbix_agentd_3      6716 ?        00:00:01 zabbix_agentd_3      6717 ?        00:00:00 zabbix_agentd_3      6718 ?        00:00:00 zabbix_agentd_3      6719 ?        00:00:00 zabbix_agentd_3      6720 ?        00:00:00 zabbix_agentd_3      ...  明らかにこれは `proc.num[]``name`パラメータ値`zabbix_agentd_30`と違います。`status`ファイルのプロセス名と一致しなかった場合、Zabbixエージェントは`/proc/<pid>/cmdline`ファイルに変わります。  エージェントが"cmdline"ファイルをどのように見るかは、コマンドを実行することで確認できます。      $ for i in 6715 6716 6717 6718 6719 6720; do cat /proc/$i/cmdline | awk '{gsub(/\x0/,"<NUL>"); print};'; done     sbin/zabbix_agentd_30<NUL>-c<NUL>/home/zabbix/ZBXNEXT-1078/zabbix_agentd.conf<NUL>     sbin/zabbix_agentd_30: collector [idle 1 sec]<NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL>...     sbin/zabbix_agentd_30: listener #1 [waiting for connection]<NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL>...     sbin/zabbix_agentd_30: listener #2 [waiting for connection]<NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL>...     sbin/zabbix_agentd_30: listener #3 [waiting for connection]<NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL>...     sbin/zabbix_agentd_30: active checks #1 [idle 1 sec]<NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL><NUL>...  この場合の`/proc/<pid>/cmdline`ファイルには、*C*言語の文字列を終了するために使用される非表示の出力不可能なヌルバイトが含まれています。 この例ではヌルバイトは"<NUL>"として示されています。  Zabbixエージェントはメインプロセスの"cmdline"をチェックし、'name'パラメータ値'zabbix_agentd_30'と一致する'zabbix_agentd_30'を取得します。よって、メインプロセスはアイテム`proc.num[zabbix_agentd_30,zabbix]`によってカウントされます。  次のプロセスをチェックするとき、エージェントは`cmdline`ファイルから`zabbix_agentd_30: collector [idle 1 sec]`を取得しようとしますが、`name`パラメータが`zabbix_agentd_30`を満たすことができません。したがって、コマンドラインを変更しないメインプロセスのみがカウントされます。 他のエージェントプロセスはコマンドラインを変更し、無視されます。  このことから今回の例では、プロセスを選択するために`proc.mem[]`と`proc.num[]`で`name`パラメータを使用できないことを示しています。  適切な正規表現で`cmdline`パラメータを使用すると、正しい結果が得られます。      $ zabbix_get -s localhost -k 'proc.num[,zabbix,,zabbix_agentd_30[ :]]'     6  コマンドラインを変更するプログラムを監視するために`proc.mem[]`と`proc.num[]`の項目を使用するときは注意してください。  `name`および`cmdline`パラメータを`proc.mem[]`および`proc.num[]`アイテムに入れる前に、`proc.num[]`アイテムおよび`ps`コマンドを使用してパラメータをテストすることをお勧めします。

en-us	#### Process user  Zabbix agent on UNIX is designed to run as a non-root user. It will run as whatever non-root user it is started as. So you can run agent as any non-root user without any issues.  If you will try to run it as 'root', it will switch to a hardcoded 'zabbix' user, which must be present on your system. You can only run agent as 'root' if you modify the 'AllowRoot' parameter in the agent configuration file accordingly.
ja	#### プロセス ユーザー  UNIX 上の Zabbix エージェントは、root 以外のユーザーとして実行するように設計されています。起動時からroot 以外のユーザーとして実行されます。なので、root 以外のユーザーでエージェントを実行しても何も問題ありません。  単純に「root」として実行しようとすると、システムから提供されている「zabbix」ユーザーに切り替わるようハードコードされています。 エージェントの設定ファイルの「AllowRoot」パラメーターを適切に変更することによって「root」としてエージェントを実行できます。

en-us	##### Process user  Zabbix proxy is designed to run as a non-root user. It will run as whatever non-root user it is started as. So you can run proxy as any non-root user without any issues.  If you will try to run it as 'root', it will switch to a hardcoded 'zabbix' user, which must be present on your system. You can only run proxy as 'root' if you modify the 'AllowRoot' parameter in the proxy configuration file accordingly.
ja	##### プロセスユーザー  Zabbixプロキシはroot以外のユーザーとして実行するように設計されていて、起動されたroot以外のユーザーとして実行されます。したがってroot以外のユーザーで問題なくプロキシを起動できます。  'root'として実行しようとすると、ハードコードされた'zabbix'ユーザーに切り替わります。これはシステムに存在している必要があります。プロキシ設定ファイルの`AllowRoot`パラメータを変更した場合にのみ、「root」としてプロキシを実行できます。

en-us	##### Process user  Zabbix server is designed to run as a non-root user. It will run as whatever non-root user it is started as. So you can run server as any non-root user without any issues.  If you will try to run it as 'root', it will switch to a hardcoded 'zabbix' user, which must be [present](/manual/installation/install) on your system. You can only run server as 'root' if you modify the 'AllowRoot' parameter in the server configuration file accordingly.  If Zabbix server and [agent](agent) are run on the same machine it is recommended to use a different user for running the server than for running the agent. Otherwise, if both are run as the same user, the agent can access the server configuration file and any Admin level user in Zabbix can quite easily retrieve, for example, the database password.
ja	##### プロセス起動ユーザー  Zabbixサーバーは、非rootユーザーで動作するように設計されています。起動されたどんな非rootユーザーでも起動すれば動作します。したがって、非rootユーザーで問題なくサーバーを実行できます。  'root'として起動しようとするとハードコードされた'zabbix'ユーザーに切り替わります。このユーザーは、システム上に[存在する](/manual/installation/install)必要があります。サーバーの設定ファイル内の'AllowRoot'パラメーターを変更した時のみ、'root'で実行させることができます。  Zabbixサーバーと[Zabbixエージェント](agent)が同じマシン上で動作する場合、サーバーの実行とエージェントの実行に、異なるユーザーを使用することをお勧めします。どちらも同じユーザーで実行されている場合、エージェントはサーバーの設定ファイルにアクセスでき、Zabbix内のどの管理レベルのユーザーでも、極めて容易にデータベースのパスワード等を取得することができてしまいます。

en-us	#### Prometheus query language  Zabbix Prometheus preprocessing [query language](/manual/config/items/itemtypes/prometheus) now supports two additional label matching operators:  -   **!=** -- select labels that are not equal to the provided string; -   **!\~** -- select labels that do not regex-match the provided     string.
ja	#### Prometheusのクエリ  ZabbixのPrometheus保存前処理での[クエリ言語](/manual/config/items/itemtypes/prometheus)で、以下の2つのラベルマッチングオペレータがサポートされるようになりました。  -   **!=** -- 指定された文字列と等しくないラベルを選択します -   **!\~** -- 指定された文字列と正規表現一致しないラベルを選択します

en-us	#### Prometheus to JSON  Data from Prometheus can be used for low-level discovery. In this case data in JSON format are needed and the *Prometheus to JSON* preprocessing option will return exactly that.  For more details, see [Discovery using Prometheus data](/manual/discovery/low_level_discovery/examples/prometheus).
ja	#### PrometheusからJSONへ  Prometheusからのデータローレベルディスカバリーに使用することができます。この場合、JSON形式のデータが必要で、<br> *Prometheus to JSON* プリプロセッシングオプションはまさにそのデータを返します。  詳しくは、[Discovery using Prometheus data](/manual/discovery/low_level_discovery/examples/prometheus)を参照してください。

en-us	##### Prometheus to JSON  In the discovery rule, go to the Preprocessing tab and select the *Prometheus to JSON* preprocessing option. Data in JSON format are needed for discovery and the *Prometheus to JSON* preprocessing option will return exactly that, with the following attributes:  -   metric name -   metric value -   help (if present) -   type (if present) -   labels (if present) -   raw line  For example, querying `wmi_logical_disk_free_bytes`:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rule_prom_json.png)  from these Prometheus lines:      # HELP wmi_logical_disk_free_bytes Free space in bytes (LogicalDisk.PercentFreeSpace)     # TYPE wmi_logical_disk_free_bytes gauge     wmi_logical_disk_free_bytes{volume="C:"} 3.5180249088e+11     wmi_logical_disk_free_bytes{volume="D:"} 2.627731456e+09     wmi_logical_disk_free_bytes{volume="HarddiskVolume4"} 4.59276288e+08  will return:  ``` {.java} [     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "C:"          },         "value": "3.5180249088e+11",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"C:\"} 3.5180249088e+11"     },     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "D:"          },         "value": "2.627731456e+09",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"D:\"} 2.627731456e+09"     },     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "HarddiskVolume4"          },         "value": "4.59276288e+08",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"HarddiskVolume4\"} 4.59276288e+08"     } ] ```
ja	##### プロメテウスからJSON  ディスカバリルールで[保存前処理]タブに移動し、*PrometheusからJSON*オプションを選択します。 ディスカバリにはJSON形式のデータが必要であり、*PrometheusからJSON*オプションは、次の属性を使用してそれを返します。  -   metric name -   metric value -   help (if present) -   type (if present) -   labels (if present) -   raw line  例：`wmi_logical_disk_free_bytes`をクエリします。  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rule_prom_json.png)  これらのプロメテウスラインから：      # HELP wmi_logical_disk_free_bytes Free space in bytes (LogicalDisk.PercentFreeSpace)     # TYPE wmi_logical_disk_free_bytes gauge     wmi_logical_disk_free_bytes{volume="C:"} 3.5180249088e+11     wmi_logical_disk_free_bytes{volume="D:"} 2.627731456e+09     wmi_logical_disk_free_bytes{volume="HarddiskVolume4"} 4.59276288e+08  以下のように返します  ``` {.java} [     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "C:"          },         "value": "3.5180249088e+11",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"C:\"} 3.5180249088e+11"     },     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "D:"          },         "value": "2.627731456e+09",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"D:\"} 2.627731456e+09"     },     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "HarddiskVolume4"          },         "value": "4.59276288e+08",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"HarddiskVolume4\"} 4.59276288e+08"     } ] ```

en-us	#### Property labels  Some of the objects properties are marked with short labels to describe their behavior. The following labels are used:  -   *readonly* - the value of the property is set automatically and     cannot be defined or changed by the client; -   *constant* - the value of the property can be set when creating an     object, but cannot be changed after.
ja	#### プロパティラベル  いくつかのオブジェクトのプロパティは、その動作を説明するために短いラベルでマークされています。<br> 以下のラベルが使用されます:  - *readonly* - プロパティの値は自動的に設定され、クライアントによって定義または変更されることはありません。 - *constant* - プロパティの値は、オブジェクトの作成時に設定することができますが、その後変更することはできません。

en-us	| Property                       | [Type](/manual/api/reference_commentary#data_types) | Description                                                                           | |--------------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------| | **name**<br>(required)         | string                                              | Name of the excluded downtime.                                                        | | **period\_from**<br>(required) | integer                                             | Starting time of the excluded downtime (inclusive).<br><br>Possible values: timestamp. | | **period\_to**<br>(required)   | integer                                             | Ending time of the excluded downtime (exclusive).<br><br>Possible values: timestamp.  |
ja	|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--------------------------------|------------------------------|---------------------------------------------------------------------------------------| |**name**<br>(必須)|string|除外されたダウンタイムの名前| |**period\_from**<br>(必須)|integer|除外されたダウンタイムの開始時刻（指定日含む）<br><br>可能な値：タイムスタンプ| |**period\_to**<br>(必須)|integer|除外されたダウンタイムの終了時間（指定日含まず）<br><br>可能な値：タイムスタンプ|

en-us	| Property                       | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                                         | |--------------------------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------| | **period\_from**<br>(required) | integer                                             | Starting time of the recurrent weekly period of time (inclusive).<br><br>Possible values: number of seconds (counting from Sunday). | | **period\_to**<br>(required)   | integer                                             | Ending time of the recurrent weekly period of time (exclusive).<br><br>Possible values: number of seconds (counting from Sunday).   |
ja	|プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--------------------------------|-----------------------------------------------------|--------------------------------------------------------------------------------------------| |**period\_from**<br>(必須)|integer|繰り返される毎週の期間の開始時刻(指定日含む)<br><br>使用可能な値：(日曜日から数えた)秒数| |**period\_to**<br>(必須)|integer|繰り返される毎週の期間の終了時間(指定日含まない)<br><br>可能な値：(日曜日から数えた)秒数|

en-us	##### Protection against brute force attacks  In case of five consecutive failed login attempts, Zabbix interface will pause for 30 seconds in order to prevent brute force and dictionary attacks.  The IP address of a failed login attempt will be displayed after a successful login.
ja	##### ブルートフォース攻撃からの保護  ログイン試行が5回連続して失敗した場合、Zabbixインターフェースはブルートフォース攻撃と辞書攻撃を防ぐために30秒間一時停止します。  失敗したログイン試行のIPアドレスは、ログイン成功時に表示されます。

en-us	##### Protection from overloading  If Zabbix server was down for some time, and proxies have collected a lot of data,  and then the server starts, it may get overloaded (history cache usage stays at 95-100% for some time).  This overload could result in a performance hit, where checks are processed slower  than they should. Protection from this scenario was implemented to avoid problems that arise  due to overloading history cache.  When Zabbix server history cache is full the history cache write access is being  throttled, stalling server data gathering processes. The most common history cache  overload case is after server downtime when proxies are uploading gathered data. To avoid  this proxy throttling was added (currently it cannot be disabled).  Zabbix server will stop accepting data from proxies when history cache usage reaches 80%.  Instead those proxies will be put on a throttling list. This will continue until the cache usage  falls down to 60%. Now server will start accepting data from proxies one by one, defined by the  throttling list. This means the first proxy that attempted to upload data during the throttling  period will be served first and until it's done the server will not accept data from other proxies.  This throttling mode will continue until either cache usage hits 80% again or falls down to 20%  or the throttling list is empty. In the first case the server will stop accepting proxy data again.  In the other two cases the server will start working normally, accepting data from all proxies.  The above information can be illustrated in the following table:  |History write <br>cache usage|Zabbix server mode|Zabbix server action| |--|--|------| |Reaches 80% |Wait|Stops accepting proxy data, but maintains a *throttling list* (prioritized list of proxies to be contacted later).| |Drops to 60% |Throttled|Starts processing throttling list, but still not accepting proxy data.| |Drops to 20% |Normal|Drops the throttling list and starts accepting proxy data normally.|  You may use the `zabbix[wcache,history,pused]` internal item to correlate this behavior of Zabbix  server with a metric.
ja	##### 過負荷からの保護  Zabbixサーバーがしばらくダウンして、その間にプロキシが大量のデータを収集した後にZabbixサーバーが起動すると、サーバーが過負荷になる可能性があります。（履歴キャッシュの使用率はしばらくの間95〜100％のままです）この過負荷により、パフォーマンスが低下し、チェック処理が本来よりも遅くなる可能性があります。このシナリオからの保護は、履歴キャッシュの過負荷によって発生する問題を回避するために実装されました。  Zabbixサーバーの履歴キャッシュがいっぱいになると、履歴キャッシュの書き込みアクセスが制限され、サーバーのデータ収集プロセスが停止します。最も一般的な履歴キャッシュの過負荷のケースは、プロキシが収集したデータをアップロードしているサーバーのダウンタイム後です。このプロキシスロットリングを回避するために履歴キャッシュの書き込みアクセス制限が追加されました。（現在、無効にすることはできません）  履歴キャッシュの使用率が80％に達すると、Zabbixサーバーはプロキシからのデータの受け入れを停止します。代わりに、これらのプロキシはスロットルリストに追加されます。これは、キャッシュ使用量が60％に低下するまで続きます。60%に低下後、サーバーはスロットリングリストで定義されたプロキシからのデータの受け入れを1つずつ再開します。これは、スロットリング期間中にデータをアップロードしようとした最初のプロキシが最初に提供され、それが完了するまで、サーバーは他のプロキシからのデータを受け入れないことを意味します。  このスロットリングモードは、キャッシュ使用量が再び80％に達するか、20％に低下するか、スロットリングリストが空になるまで続きます。80％のケースでは、サーバーはプロキシデータの受け入れを再び停止します。他の2つのケースでは、サーバーは正常に動作を開始し、すべてのプロキシからのデータを受け入れます。  上記情報を次の表に示します:  |書き込み履歴 <br>キャッシュの使用状況|Zabbix サーバー モード|Zabbix サーバー アクション| |--|--|------| |80%到達 |Wait|プロキシ データの受け入れを停止しますが、*スロットリング リスト* (後で連絡するプロキシの優先順位付けされたリスト) を維持します。| |60%に低下 |Throttled|スロットリングリストの処理を開始しますが、まだプロキシ データを受け入れません。| |20%に低下 |Normal|スロットリングリストを削除し、通常どおりプロキシ データの受け入れを開始します。|  `zabbix[wcache,history,pused]`内部アイテムを使用して、Zabbixサーバーのこの動作をメトリックと関連付けることができます。

en-us	##### - Providing history export callbacks  ::: noteimportant History export via module is no longer supported by Zabbix proxy since Zabbix 4.0.0. :::  Module can specify functions to export history data by type: Numeric (float), Numeric (unsigned), Character, Text and Log:  ``` {.c} typedef struct {     void    (*history_float_cb)(const ZBX_HISTORY_FLOAT *history, int history_num);     void    (*history_integer_cb)(const ZBX_HISTORY_INTEGER *history, int history_num);     void    (*history_string_cb)(const ZBX_HISTORY_STRING *history, int history_num);     void    (*history_text_cb)(const ZBX_HISTORY_TEXT *history, int history_num);     void    (*history_log_cb)(const ZBX_HISTORY_LOG *history, int history_num); } ZBX_HISTORY_WRITE_CBS; ```  Each of them should take "history" array of "history\_num" elements as arguments. Depending on history data type to be exported, "history" is an array of the following structures, respectively:  ``` {.c} typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     double      value; } ZBX_HISTORY_FLOAT;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     zbx_uint64_t    value; } ZBX_HISTORY_INTEGER;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     const char  *value; } ZBX_HISTORY_STRING;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     const char  *value; } ZBX_HISTORY_TEXT;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     const char  *value;     const char  *source;     int     timestamp;     int     logeventid;     int     severity; } ZBX_HISTORY_LOG; ```  Callbacks will be used by Zabbix server history syncer processes in the end of history sync procedure after data is written into Zabbix database and saved in value cache.  :::noteimportant In case of internal error in history export module it is recommended that module is written in such a way that it does not block whole monitoring until it recovers but discards data instead and allows Zabbix server to continue running. :::
ja	##### - history のエクスポートコールバックを提供する  ::: noteimportant モジュール経由の履歴エクスポートはZabbix 4.0.0以降、Zabbixプロキシではサポートされなくなりました。 :::  モジュールはhistory データをエクスポートする関数をタイプ別に指定することができます。<br> 数値(float)、Numeric (unsigned)、Character、Text、Log<br>  ``` {.c} typedef struct {     void    (*history_float_cb)(const ZBX_HISTORY_FLOAT *history, int history_num);     void    (*history_integer_cb)(const ZBX_HISTORY_INTEGER *history, int history_num);     void    (*history_string_cb)(const ZBX_HISTORY_STRING *history, int history_num);     void    (*history_text_cb)(const ZBX_HISTORY_TEXT *history, int history_num);     void    (*history_log_cb)(const ZBX_HISTORY_LOG *history, int history_num); } ZBX_HISTORY_WRITE_CBS; ```  それぞれ、"history_num" 要素の "history" 配列を引数として受け取る必要があります。<br> エクスポートされる history のデータ型に応じて、"history" は以下の構造体の配列となります。<br>  ``` {.c} typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     double      value; } ZBX_HISTORY_FLOAT;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     zbx_uint64_t    value; } ZBX_HISTORY_INTEGER;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     const char  *value; } ZBX_HISTORY_STRING;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     const char  *value; } ZBX_HISTORY_TEXT;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     const char  *value;     const char  *source;     int     timestamp;     int     logeventid;     int     severity; } ZBX_HISTORY_LOG; ```  コールバックはZabbix server の history 同期プロセスで使用されます。<br> Zabbixデータベースにデータが書き込まれ、値キャッシュに保存された後、history 同期処理の終了時に使用されます。<br>  :::noteimportant history エクスポートモジュールに内部エラーが発生した場合、回復するまで監視全体をブロックするのではなく、<br> 代わりにデータを破棄してZabbixサーバの実行を継続させるようにモジュールを記述することを推奨します。<br> :::

en-us	#### Proxies  A listing of existing proxies with their details is displayed.  ![](../../../../../assets/en/manual/web_interface/proxies1.png){width="600"}  Displayed data:  |Column|Description| |------|-----------| |*Name*|Name of the proxy. Clicking on the proxy name opens the proxy [configuration form](/manual/distributed_monitoring/proxies#configuration).| |*Mode*|Proxy mode is displayed - *Active* or *Passive*.| |*Encryption*|Encryption status for connections from the proxy is displayed:<br>**None** - no encryption<br>**PSK** - using pre-shared key<br>**Cert** - using certificate<br>| |*Last seen (age)*|The time when the proxy was last seen by the server is displayed.| |*Host count*|The number of enabled hosts assigned to the proxy is displayed.| |*Item count*|The number of enabled items on enabled hosts assigned to the proxy is displayed.| |*Required performance (vps)*|Required proxy performance is displayed (the number of values that need to be collected per second).| |*Hosts*|All hosts monitored by the proxy are listed. Clicking on the host name opens the host configuration form.|  To configure a new proxy, click on the *Create proxy* button in the top right-hand corner.
ja	#### プロキシ  既存のプロキシとその詳細のリストが表示されます。  ![](../../../../../assets/en/manual/web_interface/proxies1.png){width="600"}  表示情報  |列|詳細| |------|-----------| |*名前*|プロキシの名前。プロキシ名をクリックするとプロキシ[設定フォーム](/manual/distributed_monitoring/proxies#configuration)が開きます。| |*モード*|プロキシモードが表示されます。 - *アクティブ*または*パッシブ*| |*暗号化*|プロキシからの接続暗号化ステータスが表示されます。<br>**None** - 暗号化無し<br>**PSK** - 事前共有キー使用<br>**Cert** - 証明書使用<br>| |*最新データ受信時刻 (経過時間)*|サーバーがプロキシを最後に確認した時刻が表示されます。| |*ホスト数*|プロキシに割り当てられている有効なホストの数が表示されます。| |*アイテム数*|プロキシに割り当てられた有効なホスト上の有効なアイテムの数が表示されます。| |*要求パフォーマンス(vps)*|必要なプロキシパフォーマンスが表示されます（1秒あたりに収集する必要のある値の数）| |*ホスト*|プロキシによって監視されているすべてのホストが一覧表示されます。ホスト名をクリックすると、ホスト設定フォームが開きます。|  To configure a new proxy, click on the *Create proxy* button in the top right-hand corner.

en-us	#### Proxies  In a [proxy](/manual/distributed_monitoring/proxies#configuration) configuration, user macros can be used in the following field:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interface port (for passive proxy)|<|no|
ja	#### プロキシ  [プロキシ](/manual/distributed_monitoring/proxies#configuration) の設定では、次のフィールドでユーザー マクロを使用できます。  |ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |インターフェースポート (パッシブプロキシ)|<|no|

en-us	#### Proxies  Manage the proxies used in your distributed monitoring setup.  [Proxy API](/manual/api/reference/proxy)
ja	#### プロキシ  分散監視設定で使用されるZabbixプロキシを管理します。  [Proxy API](/manual/api/reference/proxy)

en-us	#### proxy  Changes:\ [ZBXNEXT-6889](https://support.zabbix.com/browse/ZBXNEXT-6889) `proxy.create`, `proxy.update`: dropped support of `interface.interfaceid` and `interface.hostid` properties.\
ja	#### プロキシ  変更点:\ [ZBXNEXT-6889](https://support.zabbix.com/browse/ZBXNEXT-6889) `proxy.create`, `proxy.update`: プロパティ `interface.interfaceid`, `interface.hostid` のサポートを終了しました。\

en-us	##### Proxy config request  The `proxy config` request is sent by proxy to obtain proxy configuration data. This request is sent every `ConfigFrequency` (proxy configuration parameter) seconds.  |name|<|<|<|value type|description| |-|-|-|----------|----------|----------------------------------------| |proxy→server:|<|<|<|<|<| |**request**|<|<|<|*string*|'proxy config'| |**host**|<|<|<|*string*|Proxy name.| |**version**|<|<|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<|<|<| |**request**|<|<|<|*string*|'proxy config'| |**<table>**|<|<|<|*object*|One or more objects with <table> data.| | |**fields**|<|<|*array*|Array of field names.| |^| |\-|<|*string*|Field name.| |^|**data**|<|<|*array*|Array of rows.| |^| |\-|<|*array*|Array of columns.| |^|^| |\-|*string*,*number*|Column value with type depending on the column type in database schema.| |proxy→server:|<|<|<|<|<| |**response**|<|<|<|*string*|Request success information ('success' or 'failed').|  Example:  proxy→server:  ``` {.javascript} {   "request": "proxy config",   "host": "Proxy #12",   "version":"5.4.0" } ```  server→proxy:  ``` {.javascript} {     "globalmacro":{         "fields":[             "globalmacroid",             "macro",             "value"         ],         "data":[             [                 2,                 "{$SNMP_COMMUNITY}",                 "public"             ]         ]     },     "hosts":{         "fields":[             "hostid",             "host",             "status",             "ipmi_authtype",             "ipmi_privilege",             "ipmi_username",             "ipmi_password",             "name",             "tls_connect",             "tls_accept",             "tls_issuer",             "tls_subject",             "tls_psk_identity",             "tls_psk"         ],         "data":[             [                 10001,                 "Linux",                 3,                 -1,                 2,                 "",                 "",                 "Linux",                 1,                 1,                 "",                 "",                 "",                 ""             ],             [                 10050,                 "Zabbix Agent",                 3,                 -1,                 2,                 "",                 "",                 "Zabbix Agent",                 1,                 1,                 "",                 "",                 "",                 ""             ],             [                 10105,                 "Logger",                 0,                 -1,                 2,                 "",                 "",                 "Logger",                 1,                 1,                 "",                 "",                 "",                 ""             ]         ]     },     "interface":{         "fields":[             "interfaceid",             "hostid",             "main",             "type",             "useip",             "ip",             "dns",             "port",             "bulk"         ],         "data":[             [                 2,                 10105,                 1,                 1,                 1,                 "127.0.0.1",                 "",                 "10050",                 1             ]         ]     },     ... } ```  proxy→server:  ``` {.javascript} {   "response": "success" } ```
ja	##### プロキシコンフィグリクエスト  `proxy config`リクエストはプロキシ設定データを取得するためにプロキシによって送信されます。 このリクエストは、 `ConfigFrequency`（プロキシ設定パラメータ）秒ごとに送信されます。  |名前|<|<|<|値の型|説明| |-|-|-|----------|----------|----------------------------------------| |プロキシからサーバー:|<|<|<|<|<| |**request**|<|<|<|*string*|'proxy config'| |**host**|<|<|<|*string*|プロキシ名| |**version**|<|<|<|*string*|プロキシバージョン (<メジャー>.<マイナー>.<ビルド>)| |サーバーからプロキシ:|<|<|<|<|<| |**request**|<|<|<|*string*|'proxy config'| |**<table>**|<|<|<|*object*|<table>データを持つ1つ以上のオブジェクト| | |**fields**|<|<|*array*|フィールド名の配列| |^| |\-|<|*string*|フィールド名| |^|**data**|<|<|*array*|行の配列| |^| |\-|<|*array*|列の配列| |^|^| |\-|*string*,*number*|データベーススキーマの列タイプに応じたタイプの列値| |プロキシからサーバー:|<|<|<|<|<| |**response**|<|<|<|*string*|リクエストの成否 ('success'または'failed')|  例:  プロキシからサーバー:  ``` {.javascript} {   "request": "proxy config",   "host": "Proxy #12",   "version":"5.4.0" } ```  サーバーからプロキシ:  ``` {.javascript} {     "globalmacro":{         "fields":[             "globalmacroid",             "macro",             "value"         ],         "data":[             [                 2,                 "{$SNMP_COMMUNITY}",                 "public"             ]         ]     },     "hosts":{         "fields":[             "hostid",             "host",             "status",             "ipmi_authtype",             "ipmi_privilege",             "ipmi_username",             "ipmi_password",             "name",             "tls_connect",             "tls_accept",             "tls_issuer",             "tls_subject",             "tls_psk_identity",             "tls_psk"         ],         "data":[             [                 10001,                 "Linux",                 3,                 -1,                 2,                 "",                 "",                 "Linux",                 1,                 1,                 "",                 "",                 "",                 ""             ],             [                 10050,                 "Zabbix Agent",                 3,                 -1,                 2,                 "",                 "",                 "Zabbix Agent",                 1,                 1,                 "",                 "",                 "",                 ""             ],             [                 10105,                 "Logger",                 0,                 -1,                 2,                 "",                 "",                 "Logger",                 1,                 1,                 "",                 "",                 "",                 ""             ]         ]     },     "interface":{         "fields":[             "interfaceid",             "hostid",             "main",             "type",             "useip",             "ip",             "dns",             "port",             "bulk"         ],         "data":[             [                 2,                 10105,                 1,                 1,                 1,                 "127.0.0.1",                 "",                 "10050",                 1             ]         ]     },     ... } ```  プロキシからサーバー:  ``` {.javascript} {   "response": "success" } ```

en-us	##### Proxy config request  The `proxy config` request is sent by server to provide proxy configuration data. This request is sent every `ProxyConfigFrequency` (server configuration parameter) seconds.  |name|<|<|<|value type|description| |-|-|-|----------|----------|----------------------------------------| |server→proxy:|<|<|<|<|<| |**request**|<|<|<|*string*|'proxy config'| |**<table>**|<|<|<|*object*|One or more objects with <table> data.| | |**fields**|<|<|*array*|Array of field names.| |^| |\-|<|*string*|Field name.| |^|**data**|<|<|*array*|Array of rows.| |^| |\-|<|*array*|Array of columns.| |^|^| |\-|*string*,*number*|Column value with type depending on the column type in database schema.| |proxy→server:|<|<|<|<|<| |**response**|<|<|<|*string*|Request success information ('success' or 'failed').| |**version**|<|<|<|*string*|Proxy version (<major>.<minor>.<build>).|  Example:  server→proxy:  ``` {.javascript} {     "request": "proxy config",     "globalmacro":{         "fields":[             "globalmacroid",             "macro",             "value"         ],         "data":[             [                 2,                 "{$SNMP_COMMUNITY}",                 "public"             ]         ]     },     "hosts":{         "fields":[             "hostid",             "host",             "status",             "ipmi_authtype",             "ipmi_privilege",             "ipmi_username",             "ipmi_password",             "name",             "tls_connect",             "tls_accept",             "tls_issuer",             "tls_subject",             "tls_psk_identity",             "tls_psk"         ],         "data":[             [                 10001,                 "Linux",                 3,                 -1,                 2,                 "",                 "",                 "Linux",                 1,                 1,                 "",                 "",                 "",                 ""             ],             [                 10050,                 "Zabbix Agent",                 3,                 -1,                 2,                 "",                 "",                 "Zabbix Agent",                 1,                 1,                 "",                 "",                 "",                 ""             ],             [                 10105,                 "Logger",                 0,                 -1,                 2,                 "",                 "",                 "Logger",                 1,                 1,                 "",                 "",                 "",                 ""             ]         ]     },     "interface":{         "fields":[             "interfaceid",             "hostid",             "main",             "type",             "useip",             "ip",             "dns",             "port",             "bulk"         ],         "data":[             [                 2,                 10105,                 1,                 1,                 1,                 "127.0.0.1",                 "",                 "10050",                 1             ]         ]     },     ... } ```  proxy→server:  ``` {.javascript} {   "response": "success",   "version": "5.4.0" } ```
ja	##### プロキシ設定のリクエスト  `proxy config`リクエストは、プロキシ設定データを提供するためにサーバーによって送信されます。 このリクエストは`ProxyConfigFrequency`（サーバー設定パラメーター）秒ごとに送信されます。  |名前|<|<|<|値の型|説明| |-|-|-|----------|----------|----------------------------------------| |サーバーからプロキシ:|<|<|<|<|<| |**request**|<|<|<|*string*|'proxy config'| |**<table>**|<|<|<|*object*|テーブルのデータを持つ1つ以上のオブジェクト| | |**fields**|<|<|*array*|フィールド名の配列| |^| |\-|<|*string*|フィールド名| |^|**data**|<|<|*array*|配列の行| |^| |\-|<|*array*|配列の列| |^|^| |\-|*string*,*number*|データベーススキーマの列タイプに応じたタイプの列値| |プロキシからサーバー:|<|<|<|<|<| |**response**|<|<|<|*string*|リクエストの成功情報('success'または'failed')| |**version**|<|<|<|*string*|プロキシバージョン(<メジャー>.<マイナー>.<ビルド>)|  例:  サーバーからプロキシ:  ``` {.javascript} {     "request": "proxy config",     "globalmacro":{         "fields":[             "globalmacroid",             "macro",             "value"         ],         "data":[             [                 2,                 "{$SNMP_COMMUNITY}",                 "public"             ]         ]     },     "hosts":{         "fields":[             "hostid",             "host",             "status",             "ipmi_authtype",             "ipmi_privilege",             "ipmi_username",             "ipmi_password",             "name",             "tls_connect",             "tls_accept",             "tls_issuer",             "tls_subject",             "tls_psk_identity",             "tls_psk"         ],         "data":[             [                 10001,                 "Linux",                 3,                 -1,                 2,                 "",                 "",                 "Linux",                 1,                 1,                 "",                 "",                 "",                 ""             ],             [                 10050,                 "Zabbix Agent",                 3,                 -1,                 2,                 "",                 "",                 "Zabbix Agent",                 1,                 1,                 "",                 "",                 "",                 ""             ],             [                 10105,                 "Logger",                 0,                 -1,                 2,                 "",                 "",                 "Logger",                 1,                 1,                 "",                 "",                 "",                 ""             ]         ]     },     "interface":{         "fields":[             "interfaceid",             "hostid",             "main",             "type",             "useip",             "ip",             "dns",             "port",             "bulk"         ],         "data":[             [                 2,                 10105,                 1,                 1,                 1,                 "127.0.0.1",                 "",                 "10050",                 1             ]         ]     },     ... } ```  プロキシからサーバー:  ``` {.javascript} {   "response": "success",   "version": "5.4.0" } ```

en-us	##### Proxy configuration  HA cluster nodes (servers) must be listed in the configuration of either  passive or active Zabbix proxy.  For a passive proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy,  separated by a **comma**.  ``` Server=zabbix-node-01,zabbix-node-02 ```  For an active proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy,  separated by a **semicolon**. ``` Server=zabbix-node-01;zabbix-node-02 ```
ja	##### Zabbixプロキシの設定  HAクラスターノード (サーバー) は、パッシブまたはアクティブモードの Zabbix プロキシの設定ファイルにリスト化されている必要があります。  パッシブプロキシの場合、ノード名をプロキシ設定ファイルの Server [パラメータ](/manual/appendix/config/zabbix_proxy) に **カンマ** 区切りでリスト化する必要があります。  ``` Server=zabbix-node-01,zabbix-node-02 ```  アクティブプロキシの場合、ノード名をプロキシ設定ファイルの Server [パラメータ](/manual/appendix/config/zabbix_proxy) に **セミコロン** 区切りでリスト化する必要があります。  ``` Server=zabbix-node-01;zabbix-node-02 ```

en-us	# proxy.create
ja	# proxy.create

en-us	##### Proxy data request  The `proxy data` request is sent by proxy to provide host interface availability, history, discovery and autoregistration data. This request is sent every `DataSenderFrequency` (proxy configuration parameter) seconds.  |name|<|value type|description| |-|----------|----------|----------------------------------------| |proxy→server:|<|<|<| |**request**|<|*string*|'proxy data'| |**host**|<|*string*|Proxy name.| |**session**|<|*string*|Data session token.| |**interface availability**|<|*array*|*(optional)* Array of interface availability data objects.| | |**interfaceid**|*number*|Interface identifier.| |^|**available**|*number*|Interface availability:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - unknown<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - available<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - unavailable| |^|**error**|*string*|Interface error message or empty string.| |**history data**|<|*array*|*(optional)* Array of history data objects.| | |**itemid**|*number*|Item identifier.| |^|**clock**|*number*|Item value timestamp (seconds).| |^|**ns**|*number*|Item value timestamp (nanoseconds).| |^|**value**|*string*|*(optional)* Item value.| |^|**id**|*number*|Value identifier (ascending counter, unique within one data session).| |^|**timestamp**|*number*|*(optional)* Timestamp of log type items.| |^|**source**|*string*|*(optional)* Eventlog item source value.| |^|**severity**|*number*|*(optional)* Eventlog item severity value.| |^|**eventid**|*number*|*(optional)* Eventlog item eventid value.| |^|**state**|*string*|*(optional)* Item state:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Last log size of log type items.| |^|**mtime**|*number*|*(optional)* Modification time of log type items.| |**discovery data**|<|*array*|*(optional)* Array of discovery data objects.| | |**clock**|*number*|Discovery data timestamp.| |^|**druleid**|*number*|Discovery rule identifier.| |^|**dcheckid**|*number*|Discovery check identifier or null for discovery rule data.| |^|**type**|*number*|Discovery check type:<br><br>**-1** discovery rule data<br>**0**, *SVC\_SSH* - SSH service check<br>**1**, *SVC\_LDAP* - LDAP service check<br>**2**, *SVC\_SMTP* - SMTP service check<br>**3**, *SVC\_FTP* - FTP service check<br>**4**, *SVC\_HTTP* - HTTP service check<br>**5**, *SVC\_POP* - POP service check<br>**6**, *SVC\_NNTP* - NNTP service check<br>**7**, *SVC\_IMAP* - IMAP service check<br>**8**, *SVC\_TCP* - TCP port availability check<br>**9**, *SVC\_AGENT* - Zabbix agent<br>**10**, *SVC\_SNMPv1* - SNMPv1 agent<br>**11**, *SVC\_SNMPv2* - SNMPv2 agent<br>**12**, *SVC\_ICMPPING* - ICMP ping<br>**13**, *SVC\_SNMPv3* - SNMPv3 agent<br>**14**, *SVC\_HTTPS* - HTTPS service check<br>**15**, *SVC\_TELNET* - Telnet availability check| |^|**ip**|*string*|Host IP address.| |^|**dns**|*string*|Host DNS name.| |^|**port**|*number*|*(optional)* Service port number.| |^|**key\_**|*string*|*(optional)* Item key for discovery check of type **9** *SVC\_AGENT*| |^|**value**|*string*|*(optional)* Value received from the service, can be empty for most services.| |^|**status**|*number*|*(optional)* Service status:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Service UP<br>**1**, *DOBJECT\_STATUS\_DOWN* - Service DOWN| |**autoregistration**|<|*array*|*(optional)* Array of autoregistration data objects.| | |**clock**|*number*|Autoregistration data timestamp.| |^|**host**|*string*|Host name.| |^|**ip**|*string*|*(optional)* Host IP address.| |^|**dns**|*string*|*(optional)* Resolved DNS name from IP address.| |^|**port**|*string*|*(optional)* Host port.| |^|**host\_metadata**|*string*|*(optional)* Host metadata sent by the agent (based on HostMetadata or HostMetadataItem agent configuration parameter).| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - remote command result| |^|**status**|*number*|Remote-command execution status:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - remote command completed successfully<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - remote command failed| |^|**error**|*string*|*(optional)* Error message.| |^|**parent\_taskid**|*number*|Parent task ID.| |**more**|<|*number*|*(optional)* 1 - there are more history data to send.| |**clock**|<|*number*|*(optional)* Data transfer timestamp (seconds).| |**ns**|<|*number*|*(optional)* Data transfer timestamp (nanoseconds).| |**version**|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Request success information ('success' or 'failed').| |**upload**|<|*string*|Upload control for historical data (history, autoregistration, host availability, network discovery):<br>**enabled** - normal operation<br>**disabled** - server is not accepting data (possibly due to internal cache over limit)| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - remote command| |^|**clock**|*number*|Task creation time.| |^|**ttl**|*number*|Time in seconds after which the task expires.| |^|**commandtype**|*number*|Remote-command type:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - use custom script<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - use IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - use SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - use Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - use global script (currently functionally equivalent to custom script)| |^|**command**|*string*|Remote command to execute.| |^|**execute\_on**|*number*|Execution target for custom scripts:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - execute script on agent<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - execute script on server<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - execute script on proxy| |^|**port**|*number*|*(optional)* Port for Telnet and SSH commands.| |^|**authtype**|*number*|*(optional)* Authentication type for SSH commands.| |^|**username**|*string*|*(optional)* User name for Telnet and SSH commands.| |^|**password**|*string*|*(optional)* Password for Telnet and SSH commands.| |^|**publickey**|*string*|*(optional)* Public key for SSH commands.| |^|**privatekey**|*string*|*(optional)* Private key for SSH commands.| |^|**parent\_taskid**|*number*|Parent task ID.| |^|**hostid**|*number*|Target host ID.|  Example:  proxy→server:  ``` {.javascript} {     "request": "proxy data",     "host": "Proxy #12",      "session": "12345678901234567890123456789012",     "interface availability": [         {             "interfaceid": 1,             "available": 1,             "error": ""     },         {             "interfaceid": 2,             "available": 2,             "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused"     },         {             "interfaceid": 3,             "available": 1,             "error": ""     },         {             "interfaceid": 4,             "available": 1,             "error": ""     }     ],     "history data":[         {             "itemid":"12345",             "clock":1478609647,             "ns":332510044,             "value":"52956612",             "id": 1         },         {             "itemid":"12346",             "clock":1478609647,             "ns":330690279,             "state":1,             "value":"Cannot find information for this network interface in /proc/net/dev.",             "id": 2         }     ],     "discovery data":[         {             "clock":1478608764,             "drule":2,             "dcheck":3,             "type":12,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         },         {             "clock":1478608764,             "drule":2,             "dcheck":null,             "type":-1,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         }     ],     "auto registration":[         {             "clock":1478608371,             "host":"Logger1",             "ip":"10.3.0.1",             "dns":"localhost",             "port":"10050"         },         {             "clock":1478608381,             "host":"Logger2",             "ip":"10.3.0.2",             "dns":"localhost",             "port":"10050"         }     ],     "tasks":[         {             "type": 2,             "clock":1478608371,             "ttl": 600,             "commandtype": 2,             "command": "restart_service1.sh",             "execute_on": 2,             "port": 80,             "authtype": 0,             "username": "userA",             "password": "password1",             "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",             "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",             "parent_taskid": 10,             "hostid": 10070         },         {             "type": 2,             "clock":1478608381,             "ttl": 600,             "commandtype": 1,             "command": "restart_service2.sh",             "execute_on": 0,             "authtype": 0,             "username": "",             "password": "",             "publickey": "",             "privatekey": "",             "parent_taskid": 20,             "hostid": 10084         }     ],     "tasks":[         {             "type": 0,             "status": 0,             "parent_taskid": 10         },         {             "type": 0,             "status": 1,             "error": "No permissions to execute task.",             "parent_taskid": 20         }     ],      "version":"5.4.0" } ```  server→proxy:  ``` {.javascript} {   "response": "success",   "upload": "enabled",   "tasks":[       {          "type": 1,          "clock": 1478608371,          "ttl": 600,          "commandtype": 2,          "command": "restart_service1.sh",          "execute_on": 2,          "port": 80,          "authtype": 0,          "username": "userA",          "password": "password1",          "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",          "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",          "parent_taskid": 10,          "hostid": 10070       },       {          "type": 1,          "clock": 1478608381,          "ttl": 600,          "commandtype": 1,          "command": "restart_service2.sh",          "execute_on": 0,          "authtype": 0,          "username": "",          "password": "",          "publickey": "",          "privatekey": "",          "parent_taskid": 20,          "hostid": 10084       }   ] } ```
ja	##### プロキシデータリクエスト  `proxy data`リクエストはプロキシによって送信され、ホストインターフェイスの可用性、ヒストリ、ディスカバリ、および自動登録データを提供します。 このリクエストは`DataSenderFrequency`（プロキシ設定パラメータ）秒ごとに送信されます。  |名前|<|値の型|説明| |-|----------|----------|----------------------------------------| |プロキシからサーバー:|<|<|<| |**request**|<|*string*|'proxy data'| |**host**|<|*string*|プロキシ名| |**session**|<|*string*|データセッショントークン| |**interface availability**|<|*array*|*(オプション)* インターフェイス可用性データオブジェクトの配列| | |**interfaceid**|*number*|インターフェースID| |^|**available**|*number*|インターフェースの可用性<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - 不明<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - 使用可能<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - 使用不可| |^|**error**|*string*|インターフェースエラーメッセージまたは空白| |**history data**|<|*array*|*(オプション)* ヒストリデータオブジェクトの配列| | |**itemid**|*number*|アイテムID| |^|**clock**|*number*|アイテム値のタイムスタンプ (秒)| |^|**ns**|*number*|アイテム値のタイムスタンプ (ナノ秒)| |^|**value**|*string*|*(オプション)* アイテム値| |^|**id**|*number*|ID (1つのデータセッション内で一意の昇順カウンター)| |^|**timestamp**|*number*|*(オプション)* ログタイプアイテムのタイムスタンプ| |^|**source**|*string*|*(オプション)* イベントログアイテムのソース値| |^|**severity**|*number*|*(オプション)* イベントログアイテムの深刻度| |^|**eventid**|*number*|*(オプション)* イベントログアイテムのイベントログID| |^|**state**|*string*|*(オプション)* アイテムの状態<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(オプション)* ログタイプアイテムの最後のログサイズ| |^|**mtime**|*number*|*(オプション)* ログタイプの項目の時刻を変更| |**discovery data**|<|*array*|*(オプション)* ディスカバリデータオブジェクトの配列| | |**clock**|*number*|ディスカバリデータのタイムスタンプ| |^|**druleid**|*number*|ディスカバリルールID| |^|**dcheckid**|*number*|ディスカバリーチェックIDまたはヌルのディスカバリー・ルール・データ| |^|**type**|*number*|ディスカバリチェックタイプ:<br><br>**-1** ディスカバリルールデータ<br>**0**, *SVC\_SSH* - SSHサービスチェック<br>**1**, *SVC\_LDAP* - LDAPサービスチェック<br>**2**, *SVC\_SMTP* - SMTPサービスチェック<br>**3**, *SVC\_FTP* - FTPサービスチェック<br>**4**, *SVC\_HTTP* - HTTPサービスチェック<br>**5**, *SVC\_POP* - POPサービスチェック<br>**6**, *SVC\_NNTP* - NNTPサービスチェック<br>**7**, *SVC\_IMAP* - IMAPサービスチェック<br>**8**, *SVC\_TCP* - TCPポートの可用性チェック<br>**9**, *SVC\_AGENT* - Zabbixエージェント<br>**10**, *SVC\_SNMPv1* - SNMPv1エージェント<br>**11**, *SVC\_SNMPv2* - SNMPv2エージェント<br>**12**, *SVC\_ICMPPING* - ICMPピング<br>**13**, *SVC\_SNMPv3* - SNMPv3エージェント<br>**14**, *SVC\_HTTPS* - HTTPSサービスチェック<br>**15**, *SVC\_TELNET* - Telnetの可用性チェック| |^|**ip**|*string*|ホストのIPアドレス| |^|**dns**|*string*|ホストのDNS名| |^|**port**|*number*|*(オプション)* サービスポート番号| |^|**key\_**|*string*|*(オプション)* タイプのディスカバリーチェック用アイテムキー **9** *SVC\_AGENT*| |^|**value**|*string*|*(オプション)* サービスから受け取った値は、ほとんどのサービスで空になります| |^|**status**|*number*|*(オプション)* サービスステータス:<br><br>**0**, *DOBJECT\_STATUS\_UP* - サービスアップ<br>**1**, *DOBJECT\_STATUS\_DOWN* - サービスダウン| |**auto registration**|<|*array*|*(オプションl)* オートレジストレーションデータオブジェクトの配列| | |**clock**|*number*|オートレジストレーションデータのタイムスタンプ| |^|**host**|*string*|ホスト名| |^|**ip**|*string*|*(オプション)* IPアドレス| |^|**dns**|*string*|*(オプション)* IPアドレスから解決されたDNS名| |^|**port**|*string*|*(オプション)* ホストのポート| |^|**host\_metadata**|*string*|*(オプション)* エージェントによって送信されたホストメタデータ（HostMetadataまたはHostMetadataItemエージェント構成パラメーターに基づく）| |**tasks**|<|*array*|*(オプション)* タスクの配列| | |**type**|*number*|タスクのタイプ:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - リモートコマンドの結果| |^|**status**|*number*|リモートコマンドの実行ステータス:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - リモートコマンドは正常に完了<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - リモートコマンド失敗| |^|**error**|*string*|*(オプション)* エラーメッセージ| |^|**parent\_taskid**|*number*|親タスクID| |**more**|<|*number*|*(オプション)* 1 - 追加の送信ヒストリデータ| |**clock**|<|*number*|*(オプション)* データ転送のタイムスタンプ (秒)| |**ns**|<|*number*|*(オプション)* データ転送のタイムスタンプ (ナノ秒)| |**version**|<|*string*|プロキシバージョン (<major>.<minor>.<build>)| |サーバーからプロキシ:|<|<|<| |**response**|<|*string*|リクエストの成否 ('success'または'failed')| |**upload**|<|*string*|ヒストリデータ（ヒストリ、自動登録、ホストの可用性、ネットワークディスカバリ）のアップロード制御。 使用可能な値 -'enabled'または'disabled'| |**tasks**|<|*array*|*(オプション)* タスクの配列| | |**type**|*number*|タスクのタイプ:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - リモートコマンド| |^|**clock**|*number*|タスクの作成時間| |^|**ttl**|*number*|タスクが期限切れになるまでの秒単位の時間| |^|**commandtype**|*number*|リモートコマンドのタイプ:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - カスタムスクリプト使用<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - IPMI使用<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - SSH使用<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - Telnet使用<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - グローバルスクリプト使用 (現在、機能的にはカスタムスクリプトと同等)| |^|**command**|*string*|実行するリモートコマンド| |^|**execute\_on**|*number*|カスタムスクリプトの実行ターゲット:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - エージェントでスクリプト実行<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - サーバーでスクリプト実行<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - プロキシでスクリプト実行| |^|**port**|*number*|*(オプション)* telnetおよびsshコマンドのポート| |^|**authtype**|*number*|*(オプション)* sshコマンドの認証タイプ| |^|**username**|*string*|*(オプション)* telnetおよびsshコマンドのユーザー名| |^|**password**|*string*|*(オプション)* telnetおよびsshコマンドのパスワード| |^|**publickey**|*string*|*(オプション)* sshコマンドの公開鍵| |^|**privatekey**|*string*|*(オプション)* sshコマンドの秘密鍵| |^|**parent\_taskid**|*number*|親タスクID| |^|**hostid**|*number*|ターゲットホストID|  例:  プロキシからサーバー:  ``` {.javascript} {     "request": "proxy data",     "host": "Proxy #12",      "session": "12345678901234567890123456789012",     "interface availability": [         {             "interfaceid": 1,             "available": 1,             "error": ""     },         {             "interfaceid": 2,             "available": 2,             "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused"     },         {             "interfaceid": 3,             "available": 1,             "error": ""     },         {             "interfaceid": 4,             "available": 1,             "error": ""     }     ],     "history data":[         {             "itemid":"12345",             "clock":1478609647,             "ns":332510044,             "value":"52956612",             "id": 1         },         {             "itemid":"12346",             "clock":1478609647,             "ns":330690279,             "state":1,             "value":"Cannot find information for this network interface in /proc/net/dev.",             "id": 2         }     ],     "discovery data":[         {             "clock":1478608764,             "drule":2,             "dcheck":3,             "type":12,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         },         {             "clock":1478608764,             "drule":2,             "dcheck":null,             "type":-1,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         }     ],     "auto registration":[         {             "clock":1478608371,             "host":"Logger1",             "ip":"10.3.0.1",             "dns":"localhost",             "port":"10050"         },         {             "clock":1478608381,             "host":"Logger2",             "ip":"10.3.0.2",             "dns":"localhost",             "port":"10050"         }     ],     "tasks":[         {             "type": 2,             "clock":1478608371,             "ttl": 600,             "commandtype": 2,             "command": "restart_service1.sh",             "execute_on": 2,             "port": 80,             "authtype": 0,             "username": "userA",             "password": "password1",             "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",             "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",             "parent_taskid": 10,             "hostid": 10070         },         {             "type": 2,             "clock":1478608381,             "ttl": 600,             "commandtype": 1,             "command": "restart_service2.sh",             "execute_on": 0,             "authtype": 0,             "username": "",             "password": "",             "publickey": "",             "privatekey": "",             "parent_taskid": 20,             "hostid": 10084         }     ],     "tasks":[         {             "type": 0,             "status": 0,             "parent_taskid": 10         },         {             "type": 0,             "status": 1,             "error": "No permissions to execute task.",             "parent_taskid": 20         }     ],      "version":"5.4.0" } ```  サーバーからプロキシ:  ``` {.javascript} {   "response": "success",   "upload": "enabled",   "tasks":[       {          "type": 1,          "clock": 1478608371,          "ttl": 600,          "commandtype": 2,          "command": "restart_service1.sh",          "execute_on": 2,          "port": 80,          "authtype": 0,          "username": "userA",          "password": "password1",          "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",          "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",          "parent_taskid": 10,          "hostid": 10070       },       {          "type": 1,          "clock": 1478608381,          "ttl": 600,          "commandtype": 1,          "command": "restart_service2.sh",          "execute_on": 0,          "authtype": 0,          "username": "",          "password": "",          "publickey": "",          "privatekey": "",          "parent_taskid": 20,          "hostid": 10084       }   ] } ```

en-us	# proxy.delete
ja	# proxy.delete

en-us	# proxy.get
ja	# proxy.get

en-us	##### Proxy heartbeat request  The `proxy heartbeat` request is sent by proxy to report that proxy is running. This request is sent every `HeartbeatFrequency` (proxy configuration parameter) seconds.  |name|value type|description| |----------|----------|----------------------------------------| |proxy→server:|<|<| |**request**|*string*|'proxy heartbeat'| |**host**|*string*|Proxy name.| |**version**|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<| |**response**|*string*|Request success information ('success' or 'failed').|  proxy→server:  ``` {.javascript} {    "request": "proxy heartbeat",    "host": "Proxy #12",    "version": "5.4.0" } ```  server→proxy:  ``` {.javascript} {   "response": "success" } ```
ja	##### プロキシハートビートリクエスト  `proxy heartbeat`リクエストはプロキシが実行中であることを報告するためにプロキシによって送信されます。 このリクエストは`HeartbeatFrequency`（プロキシ設定パラメータ）秒ごとに送信されます。  |名前|値のタイプ|説明| |----------|----------|----------------------------------------| |プロキシからサーバー:|<|<| |**request**|*string*|'proxy heartbeat'| |**host**|*string*|プロキシ名| |**version**|*string*|プロキシバージョン (<major>.<minor>.<build>)| |サーバーからプロキシ:|<|<| |**response**|*string*|リクエストの成否 ('success'または'failed')|  プロキシからサーバー:  ``` {.javascript} {    "request": "proxy heartbeat",    "host": "Proxy #12",    "version": "5.4.0" } ```  サーバーからプロキシ:  ``` {.javascript} {   "response": "success" } ```

en-us	### Proxy history housekeeping  The limitation on the amount of outdated information deleted from the proxy database per proxy history housekeeping cycle has been removed.  Previously the [housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper) deleted only no more than 4 times the [`HousekeepingFrequency`](/manual/appendix/config/zabbix_proxy) hours of outdated information. For example, if `HousekeepingFrequency` was set to "1", no more than 4 hours of outdated information (starting from the oldest entry) was deleted. In cases when a proxy would constantly receive data older than set in [`ProxyOfflineBuffer`](/manual/appendix/config/zabbix_proxy), this could result in excessive data accumulation.  Now this limitation has been removed, providing a more effective proxy history housekeeping solution.
ja	### プロキシヒストリのハウスキーピング  プロキシヒストリのハウスキーピングの際に、プロキシのデータベースから削除されるサイクルあたりのデータ量の制限が削除されました。  変更前の[housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper)は、[`HousekeepingFrequency`](/manual/appendix/config/zabbix_proxy)の4倍時間分までしか古い情報の削除をしませんでした。 例えば`HousekeepingFrequency`が "1" に設定されている場合、最大4時間分の情報が (古いエントリーから順番に) 削除されました。 プロキシが[`ProxyOfflineBuffer`](/manual/appendix/config/zabbix_proxy)で設定されたデータよりも古いデータを絶えず受信する場合、過剰なデータ蓄積が発生する可能性があります。  この制限が取り除かれたことで、より効果的なプロキシヒストリハウスキーピングが行えるようになりました。

en-us	### Proxy history housekeeping  The limitation on the amount of outdated information deleted from the proxy database per proxy history housekeeping cycle has been removed.  Previously the [housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper) deleted only no more than 4 times the [`HousekeepingFrequency`](/manual/appendix/config/zabbix_proxy) hours of outdated information. For example, if `HousekeepingFrequency` was set to "1", no more than 4 hours of outdated information (starting from the oldest entry) was deleted. In cases when a proxy would constantly receive data older than set in [`ProxyOfflineBuffer`](/manual/appendix/config/zabbix_proxy), this could result in excessive data accumulation.  Now this limitation has been removed, providing a more effective proxy history housekeeping solution.
ja	### プロキシ履歴のハウスキーピング  プロキシ履歴のハウスキーピングの際に、プロキシのデータベースから削除されるサイクルあたりのデータ量の制限がなくなりました。  変更前は、[housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper) は [`HousekeepingFrequency`](/manual/appendix/config/zabbix_proxy) 4 倍時間分までしか、古い情報の削除をしませんでした。 例えば、`HousekeepingFrequency` が "1" に設定されている場合、最大4時間分の古い情報が (古いエントリーから順番に) 削除されました。 プロキシが [`ProxyOfflineBuffer`](/manual/appendix/config/zabbix_proxy) で設定されたよりも古いデータを絶えず受信する場合、過剰なデータ蓄積が発生する可能性があります。  この制限が取り除かれたことで、より効果的なプロキシ履歴ハウスキーピングが行えるようになりました。

en-us	### Proxy installation  Once the required repository is added, you can install Zabbix proxy by running:      # dnf install zabbix-proxy-mysql zabbix-sql-scripts  Substitute 'mysql' in the commands with 'pgsql' to use PostgreSQL, or with 'sqlite3' to use SQLite3 (proxy only).  The package 'zabbix-sql-scripts' contains database schemas for all supported database management systems for both Zabbix server and Zabbix proxy and will be used for data import.
ja	### プロキシのインストール  必要なリポジトリが追加されたら、次を実行することでZabbix プロキシをインストールできます。      # dnf install zabbix-proxy-mysql zabbix-sql-scripts  コマンドの'mysql'を'pgsql'に置き換えて PostgreSQL を使用するか、'sqlite3'に置き換えて SQLite3 (プロキシのみ) を使用します。  パッケージ'zabbix-sql-scripts'には、Zabbix サーバーと Zabbix プロキシの両方でサポートされているすべてのデータベース管理システムのデータベース スキーマが含まれており、データのインポートに使用されます。

en-us	### Proxy interface  The proxy interface object defines the interface used to connect to a passive proxy. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**dns**<br>(required)|string|DNS name to connect to.<br><br>Can be empty if connections are made via IP address.| |**ip**<br>(required)|string|IP address to connect to.<br><br>Can be empty if connections are made via DNS names.| |**port**<br>(required)|string|Port number to connect to.| |**useip**<br>(required)|integer|Whether the connection should be made via IP address.<br><br>Possible values are:<br>0 - connect using DNS name;<br>1 - connect using IP address.|
ja	### Proxy interface  proxy interfaceオブジェクトは、パッシブプロキシへの接続に使用されるインターフェイスを定義します。 以下のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**dns**<br>(required)|string|接続するDNS名<br><br>IPアドレスで接続する場合は、空にすることができます。| |**ip**<br>(required)|string|接続するIPアドレス<br><br>DNS名で接続する場合は、空にすることができます。| |**port**<br>(required)|string|接続ポート番号| |**useip**<br>(required)|integer|IPアドレスを介して接続するかどうか<br><br>利用可能な値:<br>0 - DNS名で接続<br>1 - IPアドレスで接続|

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

en-us	#### Proxy process types  -   `availability manager` - process for host availability updates -   `configuration syncer` - process for managing in-memory cache of     configuration data -   `data sender` - proxy data sender -   `discoverer` - process for discovery of devices -   `heartbeat sender` - proxy heartbeat sender -   `history poller` - process for handling calculated, aggregated and     internal checks requiring a database connection -   `history syncer` - history DB writer -   `housekeeper` - process for removal of old historical data -   `http poller` - web monitoring poller -   `icmp pinger` - poller for icmpping checks -   `ipmi manager` - IPMI poller manager -   `ipmi poller` - poller for IPMI checks -   `java poller` - poller for Java checks -   `odbc poller` - poller for ODBC checks -   `poller` - normal poller for passive checks -   `preprocessing manager` - manager of preprocessing tasks -   `preprocessing worker` - process for data preprocessing -   `self-monitoring` - process for collecting internal server     statistics -   `snmp trapper` - trapper for SNMP traps -   `task manager` - process for remote execution of tasks requested by     other components (e.g. close problem, acknowledge problem, check     item value now, remote command functionality) -   `trapper` - trapper for active checks, traps, proxy communication -   `unreachable poller` - poller for unreachable devices -   `vmware collector` - VMware data collector responsible for data     gathering from VMware services  The proxy log file can be used to observe these process types.  Various types of Zabbix proxy processes can be monitored using the **zabbix\[process,<type>,<mode>,<state>\]** internal [item](/manual/config/items/itemtypes/internal).
ja	#### プロキシプロセスタイプ  -   `availability manager` - ホスト可用性更新プロセス -   `configuration syncer` - 設定データメモリ内キャッシュ管理プロセス -   `data sender` - プロキシデータsender -   `discoverer` - デバイス発見プロセス -   `heartbeat sender` - プロキシハートビートsender -   `history poller` - データベース接続を必要とする計算、集約、内部チェックを処理するプロセス -   `history syncer` - ヒストリDB書き込み -   `housekeeper` - 古いヒストリデータを削除するプロセス -   `http poller` - ウェブモニタリングpoller -   `icmp pinger` - icmp pingチェックpoller -   `ipmi manager` - IPMI poller マネージャー -   `ipmi poller` - IPMI チェックpoller -   `java poller` - Java チェックpoller -   `odbc poller` - ODBC チェックpoller -   `poller` - パッシブチェック用通常ポーラー -   `preprocessing manager` - 前処理タスクマネージャー -   `preprocessing worker` - データ前処理プロセス -   `self-monitoring` - 内部サーバー統計収集プロセス -   `snmp trapper` - SNMP trapsのトラッパー -   `task manager` - 他のコンポーネントによって要求されたタスクのリモート実行プロセス（例：問題のクローズ、問題の確認、現在のアイテム値の確認、リモートコマンド機能） -   `trapper` - アクティブチェック、traps、プロキシ通信用のトラッパー -   `unreachable poller` - 使用不能デバイスのpoller -   `vmware collector` - VMwareサービスからのデータ収集を担当するVMwareデータコレクタ  プロキシログファイルを使用して、これらのプロセスタイプを監視できます。  **zabbix\[process,<type>,<mode>,<state>\]**内部[アイテム](/manual/config/items/itemtypes/internal)を使用して、さまざまなタイプのZabbixプロキシプロセスを監視できます。

en-us	##### Proxy request  The `proxy data` request is used to obtain host interface availability, historical, discovery and autoregistration data from proxy. This request is sent every `ProxyDataFrequency` (server configuration parameter) seconds.  |name|<|value type|description| |-|----------|----------|----------------------------------------| |server→proxy:|<|<|<| |**request**|<|*string*|'proxy data'| |proxy→server:|<|<|<| |**session**|<|*string*|Data session token.| |**interface availability**|<|*array*|*(optional)* Array of interface availability data objects.| | |**interfaceid**|*number*|Interface identifier.| |^|**available**|*number*|Interface availability:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - unknown<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - available<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - unavailable| |^|**error**|*string*|Interface error message or empty string.| |**history data**|<|*array*|*(optional)* Array of history data objects.| | |**itemid**|*number*|Item identifier.| |^|**clock**|*number*|Item value timestamp (seconds).| |^|**ns**|*number*|Item value timestamp (nanoseconds).| |^|**value**|*string*|*(optional)* Item value.| |^|**id**|*number*|Value identifier (ascending counter, unique within one data session).| |^|**timestamp**|*number*|*(optional)* Timestamp of log type items.| |^|**source**|*string*|*(optional)* Eventlog item source value.| |^|**severity**|*number*|*(optional)* Eventlog item severity value.| |^|**eventid**|*number*|*(optional)* Eventlog item eventid value.| |^|**state**|*string*|*(optional)* Item state:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Last log size of log type items.| |^|**mtime**|*number*|*(optional)* Modification time of log type items.| |**discovery data**|<|*array*|*(optional)* Array of discovery data objects.| | |**clock**|*number*|Discovery data timestamp.| |^|**druleid**|*number*|Discovery rule identifier.| |^|**dcheckid**|*number*|Discovery check identifier or null for discovery rule data.| |^|**type**|*number*|Discovery check type:<br><br>**-1** discovery rule data<br>**0**, *SVC\_SSH* - SSH service check<br>**1**, *SVC\_LDAP* - LDAP service check<br>**2**, *SVC\_SMTP* - SMTP service check<br>**3**, *SVC\_FTP* - FTP service check<br>**4**, *SVC\_HTTP* - HTTP service check<br>**5**, *SVC\_POP* - POP service check<br>**6**, *SVC\_NNTP* - NNTP service check<br>**7**, *SVC\_IMAP* - IMAP service check<br>**8**, *SVC\_TCP* - TCP port availability check<br>**9**, *SVC\_AGENT* - Zabbix agent<br>**10**, *SVC\_SNMPv1* - SNMPv1 agent<br>**11**, *SVC\_SNMPv2* - SNMPv2 agent<br>**12**, *SVC\_ICMPPING* - ICMP ping<br>**13**, *SVC\_SNMPv3* - SNMPv3 agent<br>**14**, *SVC\_HTTPS* - HTTPS service check<br>**15**, *SVC\_TELNET* - Telnet availability check| |^|**ip**|*string*|Host IP address.| |^|**dns**|*string*|Host DNS name.| |^|**port**|*number*|*(optional)* Service port number.| |^|**key\_**|*string*|*(optional)* Item key for discovery check of type **9** *SVC\_AGENT*| |^|**value**|*string*|*(optional)* Value received from the service, can be empty for most services.| |^|**status**|*number*|*(optional)* Service status:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Service UP<br>**1**, *DOBJECT\_STATUS\_DOWN* - Service DOWN| |**auto registration**|<|*array*|*(optional)* Array of autoregistration data objects.| | |**clock**|*number*|Autoregistration data timestamp.| |^|**host**|*string*|Host name.| |^|**ip**|*string*|*(optional)* Host IP address.| |^|**dns**|*string*|*(optional)* Resolved DNS name from IP address.| |^|**port**|*string*|*(optional)* Host port.| |^|**host\_metadata**|*string*|*(optional)* Host metadata sent by the agent (based on HostMetadata or HostMetadataItem agent configuration parameter).| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - remote command result| |^|**status**|*number*|Remote-command execution status:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - remote command completed successfully<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - remote command failed| |^|**error**|*string*|*(optional)* Error message.| |^|**parent\_taskid**|*number*|Parent task ID.| |**more**|<|*number*|*(optional)* 1 - there are more history data to send.| |**clock**|<|*number*|*(optional)* Data transfer timestamp (seconds).| |**ns**|<|*number*|*(optional)* Data transfer timestamp (nanoseconds).| |**version**|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Request success information ('success' or 'failed').| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - remote command| |^|**clock**|*number*|Task creation time.| |^|**ttl**|*number*|Time in seconds after which the task expires.| |^|**commandtype**|*number*|Remote-command type:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - use custom script<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - use IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - use SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - use Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - use global script (currently functionally equivalent to custom script)| |^|**command**|*string*|Remote command to execute.| |^|**execute\_on**|*number*|Execution target for custom scripts:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - execute script on agent<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - execute script on server<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - execute script on proxy| |^|**port**|*number*|*(optional)* Port for Telnet and SSH commands.| |^|**authtype**|*number*|*(optional)* Authentication type for SSH commands.| |^|**username**|*string*|*(optional)* User name for Telnet and SSH commands.| |^|**password**|*string*|*(optional)* Password for Telnet and SSH commands.| |^|**publickey**|*string*|*(optional)* Public key for SSH commands.| |^|**privatekey**|*string*|*(optional)* Private key for SSH commands.| |^|**parent\_taskid**|*number*|Parent task ID.| |^|**hostid**|*number*|Target host ID.|  Example:  server→proxy:  ``` {.javascript} {   "request": "proxy data" } ```  proxy→server:  ``` {.javascript} {     "session": "12345678901234567890123456789012"     "interface availability": [         {             "interfaceid": 1,             "available": 1,             "error": ""     },         {             "interfaceid": 2,             "available": 2,             "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused"     },         {             "interfaceid": 3,             "available": 1,             "error": ""     },         {             "interfaceid": 4,             "available": 1,             "error": ""     }     ],     "history data":[         {             "itemid":"12345",             "clock":1478609647,             "ns":332510044,             "value":"52956612",             "id": 1         },         {             "itemid":"12346",             "clock":1478609647,             "ns":330690279,             "state":1,             "value":"Cannot find information for this network interface in /proc/net/dev.",             "id": 2         }     ],     "discovery data":[         {             "clock":1478608764,             "drule":2,             "dcheck":3,             "type":12,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         },         {             "clock":1478608764,             "drule":2,             "dcheck":null,             "type":-1,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         }     ],     "auto registration":[         {             "clock":1478608371,             "host":"Logger1",             "ip":"10.3.0.1",             "dns":"localhost",             "port":"10050"         },         {             "clock":1478608381,             "host":"Logger2",             "ip":"10.3.0.2",             "dns":"localhost",             "port":"10050"         }     ],     "tasks":[         {             "type": 0,             "status": 0,             "parent_taskid": 10         },         {             "type": 0,             "status": 1,             "error": "No permissions to execute task.",             "parent_taskid": 20         }     ],         "version":"5.4.0" } ```  server→proxy:  ``` {.javascript} {   "response": "success",   "tasks":[       {          "type": 1,          "clock": 1478608371,          "ttl": 600,          "commandtype": 2,          "command": "restart_service1.sh",          "execute_on": 2,          "port": 80,          "authtype": 0,          "username": "userA",          "password": "password1",          "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",          "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",          "parent_taskid": 10,          "hostid": 10070       },       {          "type": 1,          "clock": 1478608381,          "ttl": 600,          "commandtype": 1,          "command": "restart_service2.sh",          "execute_on": 0,          "authtype": 0,          "username": "",          "password": "",          "publickey": "",          "privatekey": "",          "parent_taskid": 20,          "hostid": 10084       }   ] } ```
ja	##### プロキシリクエスト  `proxy data`リクエストはプロキシからホストインターフェースの可用性、ヒストリ、検出、および自動登録のデータを取得するために使用されます。 このリクエストは`ProxyDataFrequency`（サーバー設定パラメーター）秒ごとに送信されます。  |名前|<|値の型|説明| |-|----------|----------|----------------------------------------| |サーバーからプロキシ:|<|<|<| |**request**|<|*string*|'proxy data'| |プロキシからサーバー:|<|<|<| |**session**|<|*string*|データセッショントークン| |**interface availability**|<|*array*|*(オプション)*インターフェイス可用性データオブジェクトの配列| | |**interfaceid**|*number*|インターフェイスID| |^|**available**|*number*|インターフェイスの可用性<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - 不明<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - 利用可能<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - 利用不可| |^|**error**|*string*|インターフェースエラーメッセージまたは空の文字列| |**history data**|<|*array*|*(オプション)* ヒストリデータオブジェクトの配列| | |**itemid**|*number*|アイテムID| |^|**clock**|*number*|アイテム値のタイムスタンプ(秒)| |^|**ns**|*number*|アイテム値のタイムスタンプ(ナノ秒)| |^|**value**|*string*|*(オプション)* アイテム値| |^|**id**|*number*|ID (1つのデータセッション内で一意の昇順カウンター)| |^|**timestamp**|*number*|*(オプション)* ログタイプアイテムのタイムスタンプ| |^|**source**|*string*|*(オプション)* イベントログアイテムのソース値| |^|**severity**|*number*|*(オプション)* イベントログアイテムの深刻度の値| |^|**eventid**|*number*|*(オプション)* イベントログアイテムのイベントID値| |^|**state**|*string*|*(オプション)* アイテムの状態<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(オプション)* ログタイプアイテムの最後のログサイズ| |^|**mtime**|*number*|*(オプション)* ログタイプの項目の時刻を変更| |**discovery data**|<|*array*|*(オプション)* ディスカバリデータオブジェクトの配列| | |**clock**|*number*|ディスカバリデータのタイムスタンプ| |^|**druleid**|*number*|ディスカバリルールID| |^|**dcheckid**|*number*|ディスカバリーチェックIDまたはヌルのディスカバリー・ルール・データ| |^|**type**|*number*|ディスカバリチェックタイプ:<br><br>**-1** ディスカバリルールデータ<br>**0**, *SVC\_SSH* - SSHサービスチェック<br>**1**, *SVC\_LDAP* - LDAPサービスチェック<br>**2**, *SVC\_SMTP* - SMTPサービスチェック<br>**3**, *SVC\_FTP* - FTPサービスチェック<br>**4**, *SVC\_HTTP* - HTTPサービスチェック<br>**5**, *SVC\_POP* - POPサービスチェック<br>**6**, *SVC\_NNTP* - NNTPサービスチェック<br>**7**, *SVC\_IMAP* - IMAPサービスチェック<br>**8**, *SVC\_TCP* - TCPポートの可用性チェック<br>**9**, *SVC\_AGENT* - Zabbixエージェント<br>**10**, *SVC\_SNMPv1* - SNMPv1エージェント<br>**11**, *SVC\_SNMPv2* - SNMPv2エージェント<br>**12**, *SVC\_ICMPPING* - ICMPピング<br>**13**, *SVC\_SNMPv3* - SNMPv3エージェント<br>**14**, *SVC\_HTTPS* - HTTPSサービスチェック<br>**15**, *SVC\_TELNET* - Telnetの可用性チェック| |^|**ip**|*string*|ホストのIPアドレス| |^|**dns**|*string*|ホストのDNS名| |^|**port**|*number*|*(オプション)* サービスポート番号| |^|**key\_**|*string*|*(オプション)* タイプのディスカバリーチェック用アイテムキー **9** *SVC\_AGENT*| |^|**value**|*string*|*(オプション)* サービスから受け取った値は、ほとんどのサービスで空になります| |^|**status**|*number*|*(オプション)* サービスステータス:<br><br>**0**, *DOBJECT\_STATUS\_UP* - サービスアップ<br>**1**, *DOBJECT\_STATUS\_DOWN* - サービスダウン| |**auto registration**|<|*array*|*(オプションl)* オートレジストレーションデータオブジェクトの配列| | |**clock**|*number*|オートレジストレーションデータのタイムスタンプ| |^|**host**|*string*|ホスト名| |^|**ip**|*string*|*(オプション)* IPアドレス| |^|**dns**|*string*|*(オプション)* IPアドレスから解決されたDNS名| |^|**port**|*string*|*(オプション)* ホストのポート| |^|**host\_metadata**|*string*|*(オプション)* エージェントによって送信されたホストメタデータ（HostMetadataまたはHostMetadataItemエージェント構成パラメーターに基づく）| |**tasks**|<|*array*|*(オプション)* タスクの配列| | |**type**|*number*|タスクのタイプ:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - リモートコマンドの結果| |^|**status**|*number*|リモートコマンドの実行ステータス:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - リモートコマンドは正常に完了<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - リモートコマンド失敗| |^|**error**|*string*|*(オプション)* エラーメッセージ| |^|**parent\_taskid**|*number*|親タスクID| |**more**|<|*number*|*(オプション)* 1 - 追加の送信ヒストリデータ| |**clock**|<|*number*|*(オプション)* データ転送のタイムスタンプ (秒)| |**ns**|<|*number*|*(オプション)* データ転送のタイムスタンプ (ナノ秒)| |**version**|<|*string*|プロキシバージョン (<メジャー>.<マイナー>.<ビルド>)| |サーバーからプロキシ:|<|<|<| |**response**|<|*string*|リクエストの成否 ('success'または'failed')| |**tasks**|<|*array*|*(オプション)* タスクの配列| | |**type**|*number*|タスクのタイプ:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - リモートコマンド| |^|**clock**|*number*|タスクの作成時間| |^|**ttl**|*number*|タスクが期限切れになるまでの秒単位の時間| |^|**commandtype**|*number*|リモートコマンドのタイプ:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - カスタムスクリプト使用<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - IPMI使用<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - SSH使用<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - Telnet使用<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - グローバルスクリプト使用 (現在、機能的にはカスタムスクリプトと同等)| |^|**command**|*string*|実行するリモートコマンド| |^|**execute\_on**|*number*|カスタムスクリプトの実行ターゲット:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - エージェントでスクリプト実行<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - サーバーでスクリプト実行<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - プロキシでスクリプト実行| |^|**port**|*number*|*(オプション)* telnetおよびsshコマンドのポート| |^|**authtype**|*number*|*(オプション)* sshコマンドの認証タイプ| |^|**username**|*string*|*(オプション)* telnetおよびsshコマンドのユーザー名| |^|**password**|*string*|*(オプション)* telnetおよびsshコマンドのパスワード| |^|**publickey**|*string*|*(オプション)* sshコマンドの公開鍵| |^|**privatekey**|*string*|*(オプション)* sshコマンドの秘密鍵| |^|**parent\_taskid**|*number*|親タスクID| |^|**hostid**|*number*|ターゲットホストID|  例:  サーバーからプロキシ:  ``` {.javascript} {   "request": "proxy data" } ```  プロキシからサーバー:  ``` {.javascript} {     "session": "12345678901234567890123456789012"     "interface availability": [         {             "interfaceid": 1,             "available": 1,             "error": ""     },         {             "interfaceid": 2,             "available": 2,             "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused"     },         {             "interfaceid": 3,             "available": 1,             "error": ""     },         {             "interfaceid": 4,             "available": 1,             "error": ""     }     ],     "history data":[         {             "itemid":"12345",             "clock":1478609647,             "ns":332510044,             "value":"52956612",             "id": 1         },         {             "itemid":"12346",             "clock":1478609647,             "ns":330690279,             "state":1,             "value":"Cannot find information for this network interface in /proc/net/dev.",             "id": 2         }     ],     "discovery data":[         {             "clock":1478608764,             "drule":2,             "dcheck":3,             "type":12,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         },         {             "clock":1478608764,             "drule":2,             "dcheck":null,             "type":-1,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         }     ],     "auto registration":[         {             "clock":1478608371,             "host":"Logger1",             "ip":"10.3.0.1",             "dns":"localhost",             "port":"10050"         },         {             "clock":1478608381,             "host":"Logger2",             "ip":"10.3.0.2",             "dns":"localhost",             "port":"10050"         }     ],     "tasks":[         {             "type": 0,             "status": 0,             "parent_taskid": 10         },         {             "type": 0,             "status": 1,             "error": "No permissions to execute task.",             "parent_taskid": 20         }     ],         "version":"5.4.0" } ```  サーバーからプロキシ:  ``` {.javascript} {   "response": "success",   "tasks":[       {          "type": 1,          "clock": 1478608371,          "ttl": 600,          "commandtype": 2,          "command": "restart_service1.sh",          "execute_on": 2,          "port": 80,          "authtype": 0,          "username": "userA",          "password": "password1",          "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",          "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",          "parent_taskid": 10,          "hostid": 10070       },       {          "type": 1,          "clock": 1478608381,          "ttl": 600,          "commandtype": 1,          "command": "restart_service2.sh",          "execute_on": 0,          "authtype": 0,          "username": "",          "password": "",          "publickey": "",          "privatekey": "",          "parent_taskid": 20,          "hostid": 10084       }   ] } ```

en-us	#### Proxy startup with MySQL 8.0.0-8.0.17  zabbix\_proxy on MySQL versions 8.0.0-8.0.17 fails with the following "access denied" error:      [Z3001] connection to database 'zabbix' failed: [1227] Access denied; you need (at least one of) the SUPER, SYSTEM_VARIABLES_ADMIN or SESSION_VARIABLES_ADMIN privilege(s) for this operation  That is due to MySQL 8.0.0 starting to enforce special permissions for setting session variables. However, in 8.0.18 this behavior was removed: [As of MySQL 8.0.18, setting the session value of this system variable is no longer a restricted operation.](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html)  The workaround is based on granting additional privileges to the `zabbix` user:  For MySQL versions 8.0.14 - 8.0.17:      grant SESSION_VARIABLES_ADMIN on *.* to 'zabbix'@'localhost';  For MySQL versions 8.0.0 - 8.0.13:      grant SYSTEM_VARIABLES_ADMIN on *.* to 'zabbix'@'localhost';
ja	#### MySQL 8.0.0-8.0.17でのプロキシの起動  MySQLのバージョン8.0.0-8.0.17上でzabbix\_proxyを実行する際、以下のような"access denied"エラーが発生します：      [Z3001] connection to database 'zabbix' failed: [1227] Access denied; you need (at least one of) the SUPER, SYSTEM_VARIABLES_ADMIN or SESSION_VARIABLES_ADMIN privilege(s) for this operation  これは、MySQL 8.0.0がセッション変数を設定するための特別な権限を強制するようになったためです。ただし、8.0.18では、この動作は削除されました： [As of MySQL 8.0.18, setting the session value of this system variable is no longer a restricted operation.](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html)  回避策としては、`zabbix`ユーザーに権限を与えます：  MySQLバージョン8.0.14 - 8.0.17の場合：      grant SESSION_VARIABLES_ADMIN on *.* to 'zabbix'@'localhost';  MySQLバージョン8.0.0 - 8.0.13の場合：      grant SYSTEM_VARIABLES_ADMIN on *.* to 'zabbix'@'localhost';

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

en-us	# proxy.update
ja	# proxy.update

en-us	#### Proxy upgrade process
ja	#### プロキシのアップグレードプロセス

en-us	##### Proxy  [Zabbix proxy](/manual/concepts/proxy) can collect performance and availability data on behalf of Zabbix server. A proxy is an optional part of Zabbix deployment; however, it may be very beneficial to distribute the load of a single Zabbix server.
ja	##### プロキシ  [Zabbixプロキシ](/manual/concepts/proxy)は、Zabbixサーバーの代わりにパフォーマンスと可用性データを収集します。プロキシはZabbixのオプション部分ですが、1台のZabbixサーバーの負荷を分散するのにとても有益です。

en-us	#### PSK contains an odd number of hex-digits  Proxy or agent does not start, message in the proxy or agent log:      invalid PSK in file "/home/zabbix/zabbix_proxy.psk"
ja	#### PSK に奇数個の 16 進数が含まれている  プロキシまたはエージェントが起動しない、プロキシまたはエージェント ログのメッセージ:      invalid PSK in file "/home/zabbix/zabbix_proxy.psk"

en-us	#### PSK identity string longer than 128 bytes is passed to GnuTLS  In TLS client side log:      gnutls_handshake() failed: -110 The TLS connection was non-properly terminated.  In TLS server side log.      gnutls_handshake() failed: -90 The SRP username supplied is illegal.
ja	#### 128 バイトを超える PSK ID 文字列が GnuTLS に渡された  TLS クライアント側のログ:      gnutls_handshake() failed: -110 The TLS connection was non-properly terminated.  TLS サーバー側のログ:      gnutls_handshake() failed: -90 The SRP username supplied is illegal.

en-us	##### Purpose of persistent files  When Zabbix agent is started it receives a list of active checks from Zabbix server or proxy.  For log\*\[\] metrics it receives the processed log size and the modification time for finding where to start log file monitoring from. Depending on the actual log file size and modification time reported by file system the agent decides either to continue log file monitoring from the processed log size or re\-analyze the log file from the beginning.  A running agent maintains a larger set of attributes for tracking all monitored log files between checks.  This in\-memory state is lost when the agent is stopped.  The new optional parameter **persistent\_dir** specifies a directory for storing this state of log\[\], log.count\[\], logrt\[\] or logrt.count\[\] item in a file. The state of log item is restored from the persistent file after the Zabbix agent is restarted.  The primary use\-case is monitoring of log file located on a mirrored file system. Until some moment in time the log file is written to both mirrors. Then mirrors are split.  On the active copy the log file is still growing, getting new records. Zabbix agent analyzes it and sends processed logs size and modification time to server. On the passive copy the log file stays the same, well behind the active copy. Later the operating system and Zabbix agent are rebooted from the passive copy. The processed log size and modification time the Zabbix agent receives from server may not be valid for situation on the passive copy.  To continue log file monitoring from the place the agent left off at the moment of file system mirror split the agent restores its state from the persistent file.
ja	##### 永続化ファイルの目的  Zabbix agent の起動時に、Zabbix server または proxy からアクティブチェックのリストを受け取ります。 <br> log\*\[\] メトリクスでは、ログファイルの監視を開始する場所を見つけるために、処理されたログのサイズと変更時間を受け取ります。<br> ファイルシステムから報告された実際のログファイルサイズと変更時間に応じて、agent は処理されたログサイズから<br> ログファイル監視を継続するか、ログファイルを最初から再分析するかを決定します。<br>  実行中の agent は、チェックの間に監視されたすべてのログファイルを追跡するために、<br> より大きな属性のセットを維持します。 このインメモリの状態は、エージェントが停止されると失われます。<br>  新しいオプションパラメータ **persistent_dir** は、この log\[\]、log.count\[\]、logrt\[\]または logrt.count\[\] item の状態を<br> ファイルに格納するディレクトリを指定するものです。Zabbix agent を再起動すると、ログアイテムの状態は永続化ファイルから復元されます。  主な用途は、ミラーリングされたファイルシステム上にあるログファイルの監視です。ある時点まで、ログファイルは<br> 両方のミラーに書き込まれます。その後、ミラーは分割されます。 アクティブなコピーでは、ログファイルは新しいレコードを<br> 取得し、まだ成長しています。Zabbix agent はこれを解析し、処理されたログのサイズと更新時刻を server に送信します。<br> パッシブコピーでは、ログファイルは同じまま、アクティブコピーよりかなり遅れています。その後、OSとZabbixエージェントが<br> パッシブコピーからリブートされます。Zabbix agent が server から受け取った処理済みのログサイズと更新時刻は、<br> パッシブコピー上の状況に対して有効でない場合があります。 ファイルシステムのミラースプリット時に agent が停止した場所から<br> ログファイルの監視を継続するために、agent は永続ファイルから状態をリストアします。<br>

en-us	#### Query language comparison  The following table lists differences and similarities between PromQL and Zabbix Prometheus preprocessing query language.  |[PromQL instant vector selector](https://prometheus.io/docs/prometheus/latest/querying/basics/#instant-vector-selectors)|<|Zabbix Prometheus preprocessing| |-|------------------------------------------------------------------------------------------------------------------------|-------------------------------| |**Differences**|<|<| |Query target|Prometheus server|Plain text in Prometheus exposition format| |Returns|Instant vector|Metric or label value (Prometheus pattern)<br>Array of metrics for single value in JSON (Prometheus to JSON)| |Label matching operators|**=**, **!=**, **=\~**, **!\~**|**=**, **!=**, **=\~**, **!\~**| |Regular expression used in label or metric name matching|RE2|PCRE| |Comparison operators|See [list](https://prometheus.io/docs/prometheus/latest/querying/operators/#comparison-binary-operators)|Only **==** (equal) is supported for value filtering| |**Similarities**|<|<| |Selecting by metric name that equals string|<metric name> or {\_\_name\_\_="<metric name>"}|<metric name> or {\_\_name\_\_="<metric name>"}| |Selecting by metric name that matches regular expression|{\_\_name\_\_=\~"<regex>"}|{\_\_name\_\_=\~"<regex>"}| |Selecting by <label name> value that equals string|{<label name>="<label value>",...}|{<label name>="<label value>",...}| |Selecting by <label name> value that matches regular expression|{<label name>=\~"<regex>",...}|{<label name>=\~"<regex>",...}| |Selecting by value that equals string|{\_\_name\_\_=\~".\*"} == <value>|{\_\_name\_\_=\~".\*"} == <value>|
ja	#### クエリ言語の比較  以下の表は、PromQLとZabbix Prometheusプリプロセッシングクエリ言語の相違点と類似点をリストアップしたものです。  |<|[PromQL instant vector selector](https://prometheus.io/docs/prometheus/latest/querying/basics/#instant-vector-selectors)|Zabbix Prometheus preprocessing| |-|------------------------------------------------------------------------------------------------------------------------|-------------------------------| |**差異**|<|<| |Query target|Prometheus server|Plain text in Prometheus exposition format| |Returns|Instant vector|Metric or label value (Prometheus pattern)<br>Array of metrics for single value in JSON (Prometheus to JSON)| |Label matching operators|**=**, **!=**, **=\~**, **!\~**|**=**, **!=**, **=\~**, **!\~**| |Regular expression used in label or metric name matching|RE2|PCRE| |Comparison operators|See [list](https://prometheus.io/docs/prometheus/latest/querying/operators/#comparison-binary-operators)|Only **==** (equal) is supported for value filtering| |**Similarities**|<|<| |Selecting by metric name that equals string|<metric name> or {\_\_name\_\_="<metric name>"}|<metric name> or {\_\_name\_\_="<metric name>"}| |Selecting by metric name that matches regular expression|{\_\_name\_\_=\~"<regex>"}|{\_\_name\_\_=\~"<regex>"}| |Selecting by <label name> value that equals string|{<label name>="<label value>",...}|{<label name>="<label value>",...}| |Selecting by <label name> value that matches regular expression|{<label name>=\~"<regex>",...}|{<label name>=\~"<regex>",...}| |Selecting by value that equals string|{\_\_name\_\_=\~".\*"} == <value>|{\_\_name\_\_=\~".\*"} == <value>|

en-us	### Query separate tablespaces in Oracle databases with Zabbix agent 2  The following [Zabbix agent 2 items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2), supported for the Oracle plugin, now have additional optional parameters:  -   oracle.diskgroups.stats\[<existingParameters>,**<diskgroup>**\] -   oracle.archive.info\[<existingParameters>,**<destination>**\] -   oracle.cdb.info\[<existingParameters>,**<database>**\] -   oracle.pdb.info\[<existingParameters>,**<database>**\] -   oracle.ts.stats\[<existingParameters>,**<tablespace>**,**<type>**\]  These parameters allow to query separate instances of data instead of all data, thus improving performance.
ja	### Zabbixエージェント2を使用してOracleデータベース内の個別のテーブルスペースでクエリを実行する  Oracleプラグインでサポートされている次の[Zabbixエージェント2アイテム](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2)に、次のオプションパラメーターが追加されました。  -   oracle.diskgroups.stats\[<existingParameters>,**<diskgroup>**\] -   oracle.archive.info\[<existingParameters>,**<destination>**\] -   oracle.cdb.info\[<existingParameters>,**<database>**\] -   oracle.pdb.info\[<existingParameters>,**<database>**\] -   oracle.ts.stats\[<existingParameters>,**<tablespace>**,**<type>**\]  これらのパラメーターを使用すると、すべてのデータではなく個別のインスタンスでクエリを実行できるため、パフォーマンスが向上します。

en-us	### Query separate tablespaces in Oracle databases with Zabbix agent 2  The following [Zabbix agent 2 items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2), supported for the Oracle plugin, now have additional optional parameters:  -   oracle.diskgroups.stats\[<existingParameters>,**<diskgroup>**\] -   oracle.archive.info\[<existingParameters>,**<destination>**\] -   oracle.cdb.info\[<existingParameters>,**<database>**\] -   oracle.pdb.info\[<existingParameters>,**<database>**\] -   oracle.ts.stats\[<existingParameters>,**<tablespace>**,**<type>**\]  These parameters allow to query separate instances of data instead of all data, thus improving performance.
ja	### Zabbixエージェント2を使用したOracleデータベース内の個別のテーブルスペースのクエリ  Oracleプラグインでサポートされている以下の [Zabbixエージェント2のアイテム](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2)に、オプションパラメーターが追加されました。  -   oracle.diskgroups.stats\[<existingParameters>,**<diskgroup>**\] -   oracle.archive.info\[<existingParameters>,**<destination>**\] -   oracle.cdb.info\[<existingParameters>,**<database>**\] -   oracle.pdb.info\[<existingParameters>,**<database>**\] -   oracle.ts.stats\[<existingParameters>,**<tablespace>**,**<type>**\]  これらのパラメータを使用すると、すべてのデータではなくデータの個別のインスタンスをクエリできるため、パフォーマンスが向上します。

en-us	#### Queue item  A special internal item **zabbix\[queue,<from>,<to>\]** can be used to monitor the health of the queue in Zabbix. It will return the number of items delayed by the set amount of time. For more information see [Internal items](/manual/config/items/itemtypes/internal).
ja	#### キュー item   特別な内部 item **zabbix\[queue,<from>,<to>\]** を使用すると、Zabbixのキューの状態を監視することができます。<br> 設定された時間だけ遅延したアイテムの数が返されます。詳細については、[Internal items](/manual/config/items/itemtypes/internal)を参照してください。

en-us	##### Readable summary in maps  A hidden "aria-label" property is available allowing map information to be read with a screen reader. Both general map description and individual element description is available, in the following format:  -   for map description:     `<Map name>, <* of * items in problem state>, <* problems in total>.` -   for describing one element with one problem:     `<Element type>, Status <Element status>, <Element name>, <Problem description>.` -   for describing one element with multiple problems:     `<Element type>, Status <Element status>, <Element name>, <* problems>.` -   for describing one element without problems:     `<Element type>, Status <Element status>, <Element name>.`  For example, this description is available:      'Local network, 1 of 6 elements in problem state, 1 problem in total. Host, Status problem, My host, Free disk space is less than 20% on volume \/. Host group, Status ok, Virtual servers. Host, Status ok, Server 1. Host, Status ok, Server 2. Host, Status ok, Server 3. Host, Status ok, Server 4. '  for the following map:  ![](../../../../../assets/en/manual/web_interface/map_aria_label.png){width="600"}
ja	##### 読みやすい要約地図  非表示の「aria-label」プロパティを使用すると、スクリーンリーダーで地図情報を読み取ることができます。 一般的なマップの説明と個々の要素の説明の両方が、次の形式で利用できます。  -   マップの説明：`<Map name>, <* of * items in problem state>, <* problems in total>.` -   1つの障害でで1つの要素を記述する：`<Element type>, Status <Element status>, <Element name>, <Problem description>.` -   複数の障害がある1つの要素を記述する：`<Element type>, Status <Element status>, <Element name>, <* problems>.` -   障害のない1つの要素を記述する：`<Element type>, Status <Element status>, <Element name>.`  たとえば、次のマップの場合以下のような説明が利用可能です。      'Local network, 1 of 6 elements in problem state, 1 problem in total. Host, Status problem, My host, Free disk space is less than 20% on volume \/. Host group, Status ok, Virtual servers. Host, Status ok, Server 1. Host, Status ok, Server 2. Host, Status ok, Server 3. Host, Status ok, Server 4. '  ![](../../../../../assets/en/manual/web_interface/map_aria_label.png){width="600"}

en-us	#### Reading host availability  Host availability icons reflect the current host interface status on Zabbix server. Therefore, in the frontend:  -   If you disable a host, availability icons will not immediately turn     gray (unknown status), because the server has to synchronize the     configuration changes first; -   If you enable a host, availability icons will not immediately turn     green (available), because the server has to synchronize the     configuration changes and start polling the host first.
ja	#### ホストの状態確認  ホストの状態アイコンは、Zabbixサーバーの現在のホストインターフェースのステータスを反映しています。 したがって、フロントエンドでは：  -   ホストを無効にした場合、サーバーは最初に設定変更を同期する必要があるため、状態アイコンはすぐに灰色（不明なステータス）になりません。 -   ホストを有効にした場合、サーバーは設定変更を同期し、最初にホストのポーリングを開始する必要があるため、状態アイコンがすぐに緑色（使用可能）に変わりません。

en-us	#### Ready-to-use templates  The default dataset in Zabbix offers several ready-to-use templates for monitoring VMware vCenter or directly ESX hypervisor. These templates contain pre-configured LLD rules as well as a number of built-in checks for monitoring virtual installations.  Templates for VMware vCenter and ESX hypervisor monitoring:  -   *VMware* - uses UUID data for corresponding macros; -   *VMware FQDN* - uses FQDN data for corresponding macros.  ::: noteclassic  In order for the *VMware FQDN* template to work correctly each monitored VM should have a unique OS name compliant with FQDN rules and VMware Tools must be installed on every machine. If these conditions are met, it is recommended to use *VMware FQDN* template. The creation of *VMware FQDN* template became possible after introducing the ability to create hosts with custom interfaces in Zabbix 5.2.\ \ A classic *VMware* template is still available and can be used if FQDN requirements cannot be met. Please keep in mind, that the *VMware* template has a known issue. Hosts for discovered virtual machines will be created with the names saved in the vCenter (for example, VM1, VM2, etc.). If Zabbix agent active is installed on these hosts later with autoregistration enabled, the autoregistration process will read host names as they have been registered upon launch (for example, vm1.example.com, vm2.example.com, etc.) and create new hosts since no name matches have been found. As a result there will be two duplicate hosts for each machine with different names.  :::  Templates used by discovery (normally, these templates should not be manually linked to a host):  -   *VMware Hypervisor*; -   *VMware Guest*.  ![](../../assets/en/manual/vm_monitoring/templates_vm.png)
ja	#### すぐに使えるテンプレート  Zabbixのデフォルトデータセットには、VMware venterや直接ESXハイパーバイザーを監視するために <br> すぐに使えるテンプレートがいくつか用意されています。 <br> これらのテンプレートには事前に設定されたLLDルールと、仮想インストレーション監視のための <br> 多くのビルトインチェックが含まれています。 <br>  VMware vCenterおよびESXハイパーバイザーの監視用テンプレートでは、  - *VMware* - 対応するマクロに UUID データを使用します。 - *VMware FQDN* - 対応するマクロに FQDN データを使用します。  ::: noteclassic VMware FQDN*テンプレートが正しく機能するためには、以下のことが必要です。 <br> 監視する各VMは、FQDNルールに準拠した一意のOS名を持つ必要があります。 <br> VMware Toolsが各マシンにインストールされている必要があります。これらの条件を満たす場合 <br> *VMware FQDN* テンプレートを使用することをお勧めします。 <br> Zabbix 5.2.でカスタムインターフェイスを持つホストを作成する機能が追加されたことにより、 <br> *VMware FQDN*テンプレートの作成が可能になりました。 <br>  <br> FQDNの要件を満たせない場合には、 従来の*VMware*テンプレートも利用可能です。 <br> ただし、*VMware*テンプレートには既知の問題があることに留意してください。 <br> 検出された仮想マシンのホストは、vCenter に保存された名前で作成されます（たとえば、VM1、VM2など)。 <br> これらのホストにZabbixエージェントアクティブをインストールし、自動登録を有効にした場合 <br> 自動再登録プロセスで起動時に登録されたホスト名(例,vm1.example.com、vm2.example.comなど)に一致するホストがないため、 <br> 新しいホストを作成します。 <br> その結果、各マシンに異なる名前の2つの重複したホストが存在することになります。 <br> :::  ディスカバリーで使用されるテンプレート（通常、これらのテンプレートはホストに手動でリンクされるべきではありません。  - *VMware Hypervisor*; - *VMware Guest*  ![](../../assets/en/manual/vm_monitoring/templates_vm.png)

en-us	##### Recent change markers  Inward pointing red triangles around an element indicate a recent trigger status change - one that's happened within the last 30 minutes. These triangles are shown if the *Mark elements on trigger status change* check-box is marked in map [configuration](/manual/config/visualization/maps/map#creating_a_map).
ja	##### 最近の変更マーカー  要素の周りを内側に向けた赤い三角形は、最近のトリガーステータスの変更を示します。これは過去30分以内に発生したものです。 これらの三角形は、マップ[設定](/manual/config/visualization/maps/map#creating_a_map)で*トリガーステータス変更時に要素をマークする*チェックボックスがマークされている場合に表示されます。

en-us	#### Recent data vs longer periods  For very recent data a **single** line is drawn connecting each received value. The single line is drawn as long as there is at least one horizontal pixel available for one value.  For data that show a longer period **three lines** are drawn - a dark green one shows the average, while a light pink and a light green line shows the maximum and minimum values at that point in time. The space between the highs and the lows is filled with yellow background.  Working time (working days) is displayed in graphs as a white background, while non-working time is displayed in gray (with the *Original blue* default frontend theme).  ![](../../../../../assets/en/manual/config/graph_working_time.png){width="550"}  Working time is always displayed in simple graphs, whereas displaying it in [custom graphs](custom#configuring_custom_graphs) is a user preference.  Working time is not displayed if the graph shows more than 3 months.
ja	#### 最近のデータと長い期間のデータ  ごく最近のデータでは、受信した各値を結ぶ**1本の**線が描かれます。1本の線は、1つの値に対して少なくとも1つの<br> 水平ピクセルが利用可能である限り、描かれます。<br>  濃い緑色の線は平均値を、薄いピンク色と薄い緑色の線はその時点の最大値と最小値を示しています。最大値と最小値の間は、<br> 黄色の背景で埋められます。<br>  稼働時間（稼働日）はグラフでは白い背景で表示され、非稼働時間はグレーで表示されます。<br> （*Original blue* デフォルトのフロントエンドのテーマで表示されます）<br>  ![](../../../../../assets/en/manual/config/graph_working_time.png){width="550"}  シンプルなグラフでは常に稼働時間が表示されますが、[custom graphs](custom#configuring_custom_graphs) では、ユーザーの<br>好みで表示することができます。  3ヶ月以上のグラフの場合、稼働時間は表示されません。

en-us	**Record filter**  A functionality for filtering records by the frontend operation that caused these entries has been added. If several log records have been created as a result of a single operation, for example, linking/unlinking a template, such records will have the same *Recordset ID*.
ja	**レコードフィルター**  レコードを、そのエントリーの原因となったWebインターフェースの操作でフィルタリングする機能が追加されました。 例えばテンプレートのリンク/アンリンクなど、1つの操作の結果として複数のログレコードが作成された場合、そのレコードは同じ*記録ID*を持つことになります。

en-us	**Records**  The audit log now contains records about all configuration changes for all Zabbix objects, including changes that occurred as a result of executing an LLD rule, a network discovery action, an autoregistration action, or a script execution. Previously, configuration changes initiated from Zabbix server, for example, as a result of executing a discovery rule, were not recorded. Now such object modifications will be stored as audit records attributed to the user System.
ja	**監査レコード**  監査ログに、LLDルール、ネットワークディスカバリーアクション、自動登録アクション、スクリプト実行の結果として発生した変更を含む、すべてのZabbixオブジェクトの設定変更に関するレコードが監査ログに含まれるようになりました。これまで、Zabbixサーバーからの設定変更(例：ディスカバリールールの実行)は記録されませんでした。今回、このようなオブジェクトの変更は、Systemユーザーに起因する監査レコードとして保存されます。

en-us	#### Recovery operation details  ![](../../../../../assets/en/manual/config/recovery_operation_details.png)  Three operation types are available for recovery events: - **Send message** - send recovery message to specified user - **Notify all involved** - send recovery message to all users who were notified on the problem event - **<remote command name>** - execute a remote command. Commands are available for execution if previously defined in [global scripts](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script) with *Action operation* selected as its scope.  Parameters for each operation type are described below. All mandatory input fields are marked with a red asterisk. When done, click on *Add* to add operation to the list of *Recovery operations*.  :::note classic Note that if the same recipient is defined in several operation types without specified *Custom message*, duplicate notifications are not sent. :::
ja	#### 復旧時実行の詳細  ![](../../../../../assets/en/manual/config/recovery_operation_details.png)  復旧イベントには 3 つのタイプがあります: - **メッセージの送信** - 指定したユーザーに復旧メッセージを送信する - **障害通知送信済みのユーザー全てにメッセージを送信** - 障害イベントで通知されたすべてのユーザーに復旧メッセージを送信する - **<リモートコマンド名>** - リモートコマンドを実行します。 [グローバル スクリプト](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script) で事前に定義されていて、*アクション処理* がスコープとして選択されている場合、コマンドを実行できます。  各タイプのパラメータを次に示します。 すべての必須入力フィールドには赤いアスタリスクが付いています。 入力が完了したら*追加*をクリックして、 *復旧時の実行内容* リストに追加します。  :::note classic *メッセージのカスタマイズ* を指定せずに同じ受信者が複数の操作タイプで定義されている場合、重複した通知は送信されません。 :::