en-us	#### Action filter condition  The action filter condition object defines a specific condition that must be checked before running the action operations.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |conditionid|string|*(readonly)* ID of the action condition.| |**conditiontype**<br>(required)|integer|Type of condition.<br><br>Possible values for trigger actions:<br>0 - host group;<br>1 - host;<br>2 - trigger;<br>3 - event name;<br>4 - trigger severity;<br>6 - time period;<br>13 - host template;<br>16 - problem is suppressed;<br>25 - event tag;<br>26 - event tag value.<br><br>Possible values for discovery actions:<br>7 - host IP;<br>8 - discovered service type;<br>9 - discovered service port;<br>10 - discovery status;<br>11 - uptime or downtime duration;<br>12 - received value;<br>18 - discovery rule;<br>19 - discovery check;<br>20 - proxy;<br>21 - discovery object.<br><br>Possible values for autoregistration actions:<br>20 - proxy;<br>22 - host name;<br>24 - host metadata.<br><br>Possible values for internal actions:<br>0 - host group;<br>1 - host;<br>13 - host template;<br>23 - event type;<br>25 - event tag;<br>26 - event tag value.<br><br>Possible values for service actions:<br>25 - event tag;<br>26 - event tag value;<br>27 - service;<br>28 - service name.| |**value**<br>(required)|string|Value to compare with.| |value2<br>|string|Secondary value to compare with. Required for trigger, internal and service actions when condition type is *26*.| |actionid|string|*(readonly)* ID of the action that the condition belongs to.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Possible values:<br>0 - *(default)* equals;<br>1 - does not equal;<br>2 - contains;<br>3 - does not contain;<br>4 - in;<br>5 - is greater than or equals;<br>6 - is less than or equals;<br>7 - not in;<br>8 - matches;<br>9 - does not match;<br>10 - Yes;<br>11 - No.|  ::: notetip To better understand how to use filters with various types of expressions, see examples on the [action.get](get#retrieve_discovery_actions) and [action.create](create#using_a_custom_expression_filter) method pages. :::  The following operators and values are supported for each condition type.  |Condition|Condition name|Supported operators|Expected value| |-|--|--|------| |0|Host group|equals,<br>does not equal|Host group ID.| |1|Host|equals,<br>does not equal|Host ID.| |2|Trigger|equals,<br>does not equal|Trigger ID.| |3|Event name|contains,<br>does not contain|Event name.| |4|Trigger severity|equals,<br>does not equal,<br>is greater than or equals,<br>is less than or equals|Trigger severity. Refer to the [trigger "severity" property](/manual/api/reference/trigger/object#trigger) for a list of supported trigger severities.| |5|Trigger value|equals|Trigger value. Refer to the [trigger "value" property](/manual/api/reference/trigger/object#trigger) for a list of supported trigger values.| |6|Time period|in, not in|Time when the event was triggered as a [time period](/manual/appendix/time_period).| |7|Host IP|equals,<br>does not equal|One or several IP ranges to check separated by commas. Refer to the [network discovery configuration](/manual/discovery/network_discovery/rule) section for more information on supported formats of IP ranges.| |8|Discovered service type|equals,<br>does not equal|Type of discovered service. The type of service matches the type of the discovery check used to detect the service. Refer to the [discovery check "type" property](/manual/api/reference/dcheck/object#discovery_check) for a list of supported types.| |9|Discovered service port|equals,<br>does not equal|One or several port ranges separated by commas.| |10|Discovery status|equals|Status of a discovered object.<br><br>Possible values:<br>0 - host or service up;<br>1 - host or service down;<br>2 - host or service discovered;<br>3 - host or service lost.| |11|Uptime or downtime duration|is greater than or equals,<br>is less than or equals|Time indicating how long has the discovered object been in the current status in seconds.| |12|Received values|equals,<br>does not equal,<br>is greater than or equals,<br>is less than or equals,<br>contains,<br>does not contain|Value returned when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.| |13|Host template|equals,<br>does not equal|Linked template ID.| |16|Problem is suppressed|Yes, No|No value required: using the "Yes" operator means that problem must be suppressed, "No" - not suppressed.| |18|Discovery rule|equals,<br>does not equal|ID of the discovery rule.| |19|Discovery check|equals,<br>does not equal|ID of the discovery check.| |20|Proxy|equals,<br>does not equal|ID of the proxy.| |21|Discovery object|equals|Type of object that triggered the discovery event.<br><br>Possible values:<br>1 - discovered host;<br>2 - discovered service.| |22|Host name|contains,<br>does not contain,<br>matches,<br>does not match|Host name.<br>Using a regular expression is supported for operators *matches* and *does not match* in autoregistration conditions.| |23|Event type|equals|Specific internal event.<br><br>Possible values:<br>0 - item in "not supported" state;<br>1 - item in "normal" state;<br>2 - LLD rule in "not supported" state;<br>3 - LLD rule in "normal" state;<br>4 - trigger in "unknown" state;<br>5 - trigger in "normal" state.| |24|Host metadata|contains,<br>does not contain,<br>matches,<br>does not match|Metadata of the auto-registered host.<br>Using a regular expression is supported for operators *matches* and *does not match*.| |25|Tag|equals,<br>does not equal,<br>contains,<br>does not contain|Event tag.| |26|Tag value|equals,<br>does not equal,<br>contains,<br>does not contain|Event tag value.| |27|Service|equals,<br>does not equal|Service ID.| |28|Service name|equals,<br>does not equal|Service name.|
ja	#### Action filter condition  action filter condition オブジェクトは、アクション操作を実行する前にチェックする必要がある特定の条件を定義します。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |conditionid|string|*(読取専用)* 動作条件ID| |**conditiontype**<br>(必須)|integer|条件のタイプ<br><br>トリガーアクションに使用可能な値:<br>0 - ホストグループ<br>1 - ホスト<br>2 - トリガー<br>3 - トリガー名<br>4 - トリガーの深刻度<br>6 - 期間<br>13 - ホストテンプレート<br>16 - 抑制された障害<br>25 - イベント タグ<br>26 - イベントタグ値<br>< br>ディスカバリアクションに使用可能な値:<br>7 - ホストIP<br>8 - 検出されたサービスタイプ<br>9 - 検出されたサービスポート<br>10 - 検出ステータス<br>11 - アップタイムまたはダウンタイム期間<br>12 - 受信した値<br>18 - ディスカバリルール<br>19 - ディスカバリチェック<br>20 - プロキシ<br>21 - ディスカバリオブジェクト<br><br>自動登録アクションに使用可能な値:<br>20 - プロキシ<br>22 - ホスト名<br>24 - ホストメタデータ<br><br>内部アクションに使用可能な値:<br>0 - ホストグループ<br>1 - ホスト<br>13 - ホストテンプレート<br>23 - イベントタイプ<br>25 - イベントタグ<br>26 - イベントタグ値<br><br >サービスアクションに使用できる値:<br>25 - イベントタグ<br>26 - イベントタグ値<br>27 - サービス<br>28 - サービス名| |**value**<br>(必須)|string|比較する値| |value2<br>|string|比較する二次的な値。 条件タイプが *26 *の場合、トリガー、内部、およびサービスアクションに必要です。| |actionid|string|*(読取専用)* 条件が属するアクションID| |formulaid|string|カスタム条件式から条件を参照するために使用される任意の一意の ID。 大文字のみを含めることができます。 ID は、フィルタ条件を変更するときにユーザーが定義する必要がありますが、後で要求するときに新たに生成されます。| |operator|integer|条件演算子<br><br>使用可能な値:<br>0 - *(デフォルト)* 等しい<br>1 - 等しくない<br>2 - 含む<br>3 - 含まない< br>4 - 入っている<br>5 - 以上<br>6 - 以下<br>7 - 入っていない<br>8 - 一致する<br>9 - 一致しない <br>10 - はい<br>11 - いいえ|  ::: notetip さまざまなタイプの式でフィルターを使用する方法をよりよく理解するには、[action.get](get#retrieve_discovery_actions) および [action.create](create#using_a_custom_expression_filter) メソッド ページの例を参照してください。:::  次の演算子と値は、条件の種類ごとにサポートされています。  |条件|条件名|対応演算子|期待値| |-|--|--|------| |0|Host group|equals,<br>does not equal|ホスト グループ ID| |1|Host|equals,<br>does not equal|ホスト ID| |2|Trigger|equals,<br>does not equal|トリガー ID| |3|Trigger name|含む、<br>含まない|トリガー名| |4|Trigger severity|等しい<br>等しくない<br>以上<br>以下|トリガーの深刻度。サポートされているトリガーの深刻度度のリストについては、[トリガーの"深刻度"プロパティ](/manual/api/reference/trigger/object#trigger) を参照してください。| |5|Trigger value|equals|トリガー値。 サポートされているトリガー値のリストについては、[トリガー "値" プロパティ](/manual/api/reference/trigger/object#trigger) を参照してください。| |6|Time period|入っている,入っていない|イベントがトリガーされた[時間帯](/manual/appendix/time_period)| |7|Host IP|equals,<br>does not equal|確認する 1 つまたは複数の IP 範囲をコンマで区切って指定します。 サポートされている IP 範囲の形式の詳細については、[ネットワーク検出構成](/manual/discovery/network_discovery/rule) セクションを参照してください。| |8|Discovered service type|equals,<br>does not equal|検出されたサービスのタイプ。 サービスのタイプは、サービスの検出に使用される検出チェックのタイプと一致します。 サポートされているタイプのリストについては、[検出チェックの"タイプ"プロパティ](/manual/api/reference/dcheck/object#discovery_check) を参照してください。| |9|Discovered service port|equals,<br>does not equal|コンマで区切られた 1 つまたは複数のポート範囲。| |10|Discovery status|equals|検出されたオブジェクトのステータス<br><br>使用可能な値:<br>0 - ホストまたはサービスが稼働中<br>1 - ホストまたはサービスが停止中<br>2 - ホストまたはサービスが検出済み<br>3 - ホストまたはサービスが失われました。| |11|Uptime or downtime duration|is greater than or equals,<br>is less than or equals|検出されたオブジェクトが現在の状態になっている時間(秒単位)| |12|Received values|equals,<br>does not equal,<br>is greater than or equals,<br>is less than or equals,<br>contains,<br>does not contain|Zabbix エージェント、SNMPv1、SNMPv2、または SNMPv3 の検出チェックを実行したときに返される値| |13|Host template|equals,<br>does not equal|リンクされたテンプレート ID| |16|Problem is suppressed|Yes,No|値は不要です: "Yes" - 障害を抑制します。"No" - 障害を抑制しません。| |18|Discovery rule|equals<br>does not equal|ディスカバリルールID| |19|Discovery check|equals<br>does not equal|ディスカバリチェックID| |20|Proxy|equals<br>does not equal|プロキシID| |21|Discovery object|equals|ディスカバリイベントをトリガーしたオブジェクトのタイプ<br><br>使用可能な値:<br>1 - 検出されたホスト<br>2 - 検出されたサービス| |22|Host name|contains<br>does not contain<br>matches<br>does not match|ホスト名<br>自動登録条件では*matches* および *does not match* で正規表現の使用がサポートされています。| |23|Event type|equals|特定の内部イベント<br><br>使用可能な値:<br>0 - "サポートされていない"状態のアイテム<br>1 - "通常"の状態のアイテム<br>2 - "サポートされていない"状態のLLDルール<br>3 - "通常"状態の LLD ルール<br>4 - "不明"状態のトリガー<br>5 - "通常"状態のトリガー| |24|Host metadata|contains<br>does not contain<br>matches<br>does not match|自動登録されたホストのメタデータ。<br>正規表現の使用は*matches* および *does not match*でサポートされています。| |25|Tag|equals<br>does not equal<br>contains<br>does not contain|イベントタグ| |26|Tag value|equals<br>does not equal<br>contains<br>does not contain|イベントタグ値| |27|Service|equals<br>does not equal|サービスID| |28|Service name|equals<br>does not equal|サービス名|

en-us	### Action filter  The action filter object defines a set of conditions that must be met to perform the configured action operations. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |**evaltype**<br>(required)|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression filters.|
ja	### Action filter  action filter オブジェクトは、構成されたアクション操作を実行するために満たす必要がある一連の条件を定義します。 次のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**conditions**<br>(必須)|array|結果のフィルタリングに使用するフィルター条件のセット| |**evaltype**<br>(必須)|integer|フィルタ条件の評価方法<br><br>使用可能な値:<br>0 - および/または;<br>1 - and<br>2 - or<br>3 - カスタム条件式| |eval\_formula|string|*(読取専用)* フィルター条件の評価に使用される式。 式にはその`formulaid`によって特定のフィルター条件を参照する ID が含まれています。 `eval_formula` の値は、カスタム式を持つフィルターの `formula` の値と同じです。| |formula|string|カスタム式でフィルターの条件を評価するために使用されるユーザー定義の式。 式には、その`formulaid`によって特定のフィルター条件を参照する ID が含まれている必要があります。 式で使用される ID は、フィルタ条件で定義された ID と正確に一致する必要があります。条件を未使用または省略したままにすることはできません。<br><br>カスタム式フィルタでは必須です。|

en-us	# action.get
ja	# action.get

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

en-us	#### Action operation condition  The action operation condition object defines a condition that must be met to perform the current operation. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |opconditionid|string|*(readonly)* ID of the action operation condition| |**conditiontype**<br>(required)|integer|Type of condition.<br><br>Possible values:<br>14 - event acknowledged.| |**value**<br>(required)|string|Value to compare with.| |operationid|string|*(readonly)* ID of the operation.| |operator|integer|Condition operator.<br><br>Possible values:<br>0 - *(default)* =.|  The following operators and values are supported for each operation condition type.  |Condition|Condition name|Supported operators|Expected value| |---------|--------------|-------------------|--------------| |14|Event acknowledged|=|Whether the event is acknowledged.<br><br>Possible values:<br>0 - not acknowledged;<br>1 - acknowledged.|
ja	#### Action operation condition  action operation condition オブジェクトは、現在の操作を実行するために満たさなければならない条件を定義します。 次のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |opconditionid|string|*(読取専用)* アクション動作条件のID| |**conditiontype**<br>(必須)|integer|条件のタイプ<br><br>可能な値:<br>14 - イベントが確認された| |**value**<br>(必須)|string|比較する値| |operationid|string|*(読取専用)* オペレーションID| |operator|integer|条件演算子<br><br>可能な値:<br>0 - *(デフォルト)* =。|  次の演算子と値は、各操作条件タイプでサポートされています。  |条件|条件名|対応演算子|期待値| |---------|--------------|-------------------|--------------| |14|イベント承認|=|イベントが承認されたか<br><br>可能な値:<br>0 - されていない<br>1 - されている|

en-us	#### Action operation message  The operation message object contains data about the message that will be sent by the operation.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |default\_msg|integer|Whether to use the default action message text and subject.<br><br>Possible values:<br>0 - use the data from the operation;<br>1 - *(default)* use the data from the media type.| |mediatypeid|string|ID of the media type that will be used to send the message.| |message|string|Operation message text.| |subject|string|Operation message subject.|
ja	#### Action operation message  operation message オブジェクトには、オペレーションによって送信されるメッセージに関するデータが含まれています。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |default\_msg|integer|デフォルトのアクションメッセージ テキストと件名を使用するか<br><br>有効な値：<br>0 - オペレーションからのデータを使用<br>1 - *(デフォルト)* メディア タイプからのデータを使用| |mediatypeid|string|メッセージの送信に使用されるメディア タイプの ID| |message|string|オペレーションメッセージ本文| |subject|string|オペレーションメッセージ件名|

en-us	### Action operation  The action operation object defines an operation that will be performed when an action is executed. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationid|string|*(readonly)* ID of the action operation.| |**operationtype**<br>(required)|integer|Type of operation.<br><br>Possible values:<br>0 - send message;<br>1 - global script;<br>2 - add host;<br>3 - remove host;<br>4 - add to host group;<br>5 - remove from host group;<br>6 - link to template;<br>7 - unlink from template;<br>8 - enable host;<br>9 - disable host;<br>10 - set host inventory mode.<br><br>Note that only types '0' and '1' are supported for trigger and service actions, only '0' is supported for internal actions. All types are supported for discovery and autoregistration actions.| |actionid|string|*(readonly)* ID of the action that the operation belongs to.| |esc\_period|string|Duration of an escalation step in seconds. Must be greater than 60 seconds. Accepts seconds, time unit with suffix and user macro. If set to 0 or 0s, the default action escalation period will be used.<br><br>Default: 0s.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |esc\_step\_from|integer|Step to start escalation from.<br><br>Default: 1.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |esc\_step\_to|integer|Step to end escalation at.<br><br>Default: 1.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |evaltype|integer|Operation condition evaluation method.<br><br>Possible values:<br>0 - *(default)* AND / OR;<br>1 - AND;<br>2 - OR.| |opcommand|object|Object containing data on global script run by the operation.<br><br>Each object has one following property: `scriptid` - *(string)* ID of the script.<br><br>Required for global script operations.| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_grpid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`groupid` - *(string)* ID of the host group.<br><br>Required for global script operations if `opcommand_hst` is not set.| |opcommand\_hst|array|Host to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_hstid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`hostid` - *(string)* ID of the host; if set to 0 the command will be run on the current host.<br><br>Required for global script operations if `opcommand_grp` is not set.| |opconditions|array|Operation conditions used for trigger actions.<br><br>The operation condition object is [described in detail below](/manual/api/reference/action/object#action_operation_condition).| |opgroup|array|Host groups to add hosts to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`groupid` - *(string)* ID of the host group.<br><br>Required for "add to host group" and "remove from host group" operations.| |opmessage|object|Object containing the data about the message sent by the operation.<br><br>The operation message object is [described in detail below](/manual/api/reference/action/object#action_operation_message).<br><br>Required for message operations.| |opmessage\_grp|array|User groups to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`usrgrpid` - *(string)* ID of the user group.<br><br>Required for message operations if `opmessage_usr` is not set.| |opmessage\_usr|array|Users to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`userid` - *(string)* ID of the user.<br><br>Required for message operations if `opmessage_grp` is not set.| |optemplate|array|Templates to link the hosts to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`templateid` - *(string)* ID of the template.<br><br>Required for "link to template" and "unlink from template" operations.| |opinventory|object|Inventory mode set host to.<br><br>Object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`inventory_mode` - *(string)* Inventory mode.<br><br>Required for "Set host inventory mode" operations.|
ja	### Action operation  action operationオブジェクトはアクション実行時の操作を設定します。 次のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |operationid|string|*(読取専用)*action operation ID。| |**operationtype**<br>(必須)|integer|操作のタイプ。<br><br>有効な値:<br>0 - メッセージを送信する<br>1 - グローバルスクリプト<br>2 - ホストを追加する<br>3 - ホストを削除する<br>4 - ホストグループに追加する<br>5 - ホストグループから削除する<br>6 - テンプレートにリンクを設定する<br>7 - テンプレートからリンクを解除する<br>8 - ホストを有効にする<br>9 - ホストを無効にする<br>10 - ホストインベントリ モードを設定する<br><br>トリガーおよびサービスアクションではタイプ'0'と'1'のみがサポートされ、内部アクションでは'0'のみがサポートされることに注意してください。 ディスカバリおよび自動登録アクションでは、すべてのタイプがサポートされています。| |actionid|string|*(読取専用)* 操作が属するアクションのID。| |esc\_period|string|エスカレーションステップの間隔(秒単位)。60秒より長くする必要があります。 秒、タイムサフィックス付きの単位、およびユーザーマクロを受け入れます。0または0sを設定すると、デフォルトのアクションエスカレーション間隔が使用されます。<br><br>デフォルト : 0s<br><br>エスカレーションは、トリガー、内部、およびサービスのアクション、または通常の操作でのみサポートされていることに注意してください。| |esc\_step\_from|integer|エスカレーションを開始するステップ。<br><br>デフォルト : 1<br><br>エスカレーションは、トリガー、内部、およびサービスのアクション、または通常の操作でのみサポートされていることに注意してください。| |esc\_step\_to|integer|エスカレーションを終了するステップ。<br><br>デフォルト : 1<br><br>エスカレーションは、トリガー、内部、およびサービスのアクション、または通常の操作でのみサポートされていることに注意してください。| |evaltype|integer|動作条件の評価方法。<br><br>有効な値:<br>0 - *(デフォルト)* AND / OR<br>1 - AND<br>2 - OR| |opcommand|object|オペレーションによって実行されるグローバルスクリプトに関するデータを含むオブジェクト。<br><br>各オブジェクトには次のプロパティが 1 つあります。`scriptid` - *(string)* スクリプトのID。<br><br>グローバルスクリプトオペレーションに必要です。| |opcommand\_grp|array|グローバルスクリプトを実行するホストグループ。<br><br>各オブジェクトには次のプロパティがあります。<br>`opcommand_grpid` - *(string, 読取専用)* オブジェクトのID<br>`operationid` - *(string , 読取専用)* action operation ID<br>`groupid` - *(string)* ホストグループのID<br><br>`opcommand_hst`が設定されていない場合、グローバルスクリプト操作に必要です。| |opcommand\_hst|array|グローバルスクリプトを実行するホスト。<br><br>各オブジェクトには次のプロパティがあります。<br>`opcommand_hstid` - *(string, 読取専用)* オブジェクトのID<br>`operationid` - *(string, 読取専用)* action operation ID<br>`hostid` - *(string)* ホストのID。0に設定すると、コマンドは現在のホストで実行されます。<br><br>`opcommand_grp`が設定されていない場合、グローバルスクリプト操作に必要です。| |opconditions|array|トリガーアクションに使用される操作条件。<br><br>操作条件オブジェクトの[詳細は後述](/manual/api/reference/action/object#action_operation_condition)。| |opgroup|array|ホストを追加するホストグループ。<br><br>各オブジェクトには次のプロパティがあります。<br>`operationid` - *(string, 読取専用)* action operation ID<br>`groupid` - *(string) * ホストグループのID<br><br>"ホストグループへ追加"および"ホスト グループから削除"操作に必要です。| |opmessage|object|操作によって送信されたメッセージに関するデータを含むオブジェクト。<br><br>操作メッセージオブジェクトの[詳細は後述](/manual/api/reference/action/object#action_operation_message)。<br><br> メッセージ操作に必須です。| |opmessage\_grp|array|メッセージを送信するユーザーグループ<br><br>各オブジェクトには次のプロパティがあります。<br>`operationid` - *(string, 読取専用)* action operation ID<br>`usrgrpid` - *(string) * ユーザーグループID<br><br>`opmessage_usr`が設定されていない場合、メッセージ操作に必要です。| |opmessage\_usr|array|メッセージを送信するユーザー。<br><br>各オブジェクトには次のプロパティがあります。<br>`operationid` - *(string, 読取専用)* action operation ID<br>`userid` - *(string)* ユーザーID<br><br>`opmessage_grp` が設定されていない場合、メッセージ操作に必要です。| |optemplate|array|ホストをリンクするテンプレート。<br><br>各オブジェクトには次のプロパティがあります:<br>`operationid` - *(string, 読取専用)* action operation ID<br>`templateid` - *(string) * テンプレートID<br><br>"テンプレートへのリンク"および"テンプレートからのリンク解除"操作に必要です。| |opinventory|object|インベントリモードにホストを設定します。<br><br>オブジェクトには次のプロパティがあります:<br>`operationid` - *(string, 読取専用)* action operation ID<br>`inventory_mode` - *(string)* インベントリモード<br><br>"ホストインベントリモードの設定"操作に必要です。|

en-us	### Action recovery operation  The action recovery operation object defines an operation that will be performed when a problem is resolved. Recovery operations are possible for trigger, internal and service actions. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationid|string|*(readonly)* ID of the action operation.| |**operationtype**<br>(required)|integer|Type of operation.<br><br>Possible values for trigger and service actions:<br>0 - send message;<br>1 - global script;<br>11 - notify all involved.<br><br>Possible values for internal actions:<br>0 - send message;<br>11 - notify all involved.| |actionid|string|*(readonly)* ID of the action that the recovery operation belongs to.| |opcommand|object|Object containing data on global action type script run by the operation.<br><br>Each object has one following property: `scriptid` - *(string)* ID of the action type script.<br><br>Required for global script operations.| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_grpid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`groupid` - *(string)* ID of the host group.<br><br>Required for global script operations if `opcommand_hst` is not set.| |opcommand\_hst|array|Host to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_hstid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`hostid` - *(string)* ID of the host; if set to 0 the command will be run on the current host.<br><br>Required for global script operations if `opcommand_grp` is not set.| |opmessage|object|Object containing the data about the message sent by the recovery operation.<br><br>The operation message object is [described in detail above](/manual/api/reference/action/object#action_operation_message).<br><br>Required for message operations.| |opmessage\_grp|array|User groups to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`usrgrpid` - *(string)* ID of the user group.<br><br>Required for message operations if `opmessage_usr` is not set.| |opmessage\_usr|array|Users to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`userid` - *(string)* ID of the user.<br><br>Required for message operations if `opmessage_grp` is not set.|
ja	### Action recovery operation  Action recovery operationオブジェクトは、障害が復旧されたときに実行される操作を定義します。 トリガー、内部、およびサービス アクションのリカバリオペレーションが可能です。 次のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |operationid|string|*(読取専用)* アクションオペレーションID| |**operationtype**<br>(必須)|integer|オペレーションタイプ<br><br>トリガーおよびサービス アクションに使用可能な値:<br>0 - メッセージを送信<br>1 - グローバル スクリプト<br>11 - 関係者全員に通知<br><br>内部アクションに使用可能な値:<br>0 - メッセージを送信<br>11 - 関係者全員に通知| |actionid|string|*(読取専用)* リカバリオペレーションが属するアクションの ID| |opcommand|object|実行されるグローバル アクション タイプ スクリプトに関するデータを含むオブジェクト。<br><br>各オブジェクトには次のプロパティが 1 つあります: `scriptid` - *(string)* アクション タイプ スクリプトの ID<br><br>グローバルスクリプトオペレーションには必須です| |opcommand\_grp|array|グローバル スクリプトを実行するホスト グループ。<br><br>各オブジェクトには次のプロパティがあります。<br>`opcommand_grpid` - *(string, 読取専用)* オブジェクトの ID<br>`operationid` - *(string , 読取専用)* オペレーションID<br>`groupid` - *(string)* ホスト グループの ID<br><br>`opcommand_hst` が設定されていない場合、グローバル スクリプト操作に必須です。| |opcommand\_hst|array|グローバル スクリプトを実行するホスト<br><br>各オブジェクトには次のプロパティがあります<br>`opcommand_hstid` - *(string, 読取専用)* オブジェクトID<br>`operationid` - *(string, 読取専用)* オペレーションID;<br>`hostid` - *(string)* ホストID。 0に設定するとコマンドは現在のホストで実行されます。<br><br>`opcommand_grp` が設定されていない場合、グローバル スクリプト操作に必須です。| |opmessage|object|リカバリオペレーションによって送信されたメッセージに関するデータを含むオブジェクト。<br><br>操作メッセージ オブジェクトは [上記で詳しく説明](/manual/api/reference/action/object#action_operation_message) しています。<br><br>メッセージ操作に必須です。| |opmessage\_grp|array|メッセージを送信するユーザー グループ。<br><br>各オブジェクトには次のプロパティがあります。<br>`operationid` - *(string, 読取専用)* オペレーションID<br>`usrgrpid` - *(string) * ユーザー グループの ID<br><br>`opmessage_usr` が設定されていない場合、メッセージ操作に必須です。| |opmessage\_usr|array|メッセージを送信するユーザー。<br><br>各オブジェクトには次のプロパティがあります。<br>`operationid` - *(string, 読取専用)* オペレーションID<br>`userid` - *(string)* ユーザーの ID<br><br>`opmessage_grp` が設定されていない場合、メッセージ操作に必須です。|

en-us	#### Actions and alerts  Define actions and operations to notify users about certain events or automatically execute remote commands. Gain access to information about generated alerts and their receivers.  [Action API](/manual/api/reference/action) | [Alert API](/manual/api/reference/alert)
ja	#### アクションとアラート  特定のイベントをユーザーに通知したり、リモートコマンドを自動的に実行するためのアクションと操作を定義します。生成されたアラートとその受信者に関する情報にアクセスできます。  [Action API](/manual/api/reference/action) | [Alert API](/manual/api/reference/alert)

en-us	#### Actions disabled due to deleted objects  If a certain object (host, template, trigger, etc.) used in an action condition/operation is deleted, the condition/operation is removed and the action is disabled to avoid incorrect execution of the action. The action can be re-enabled by the user.  This behavior takes place when deleting:  -   host groups ("host group" condition, "remote command" operation on a     specific host group); -   hosts ("host" condition, "remote command" operation on a specific     host); -   templates ("template" condition, "link to template" and "unlink from     template" operations); -   triggers ("trigger" condition); -   discovery rules (when using "discovery rule" and "discovery check"     conditions).  *Note*: If a remote command has many target hosts, and we delete one of them, only this host will be removed from the target list, the operation itself will remain. But, if it's the only host, the operation will be removed, too. The same goes for "link to template" and "unlink from template" operations.  Actions are not disabled when deleting a user or user group used in a "send message" operation.
ja	#### オブジェクト削除によるアクション無効化  アクション条件/操作で使用されている特定のオブジェクト (ホスト、テンプレート、トリガーなど) が削除されると、その条件/操作が削除され、アクションが無効になり、アクションが正しく実行されなくなります。  ユーザーはアクションを再度有効にすることができます。  この動作は、以下を削除するときに発生します。  -   ホストグループ ("ホスト グループ"条件、特定のホスト グループでの"リモート コマンド"操作) -   ホスト ("ホスト" 条件、 特定のホストでの"リモートコマンド"操作) -   テンプレート ("テンプレート" 条件, "テンプレートへのリンク"および"テンプレートからのリンク解除"操作) -   トリガー ("トリガー" 条件) -   ディスカバリルール ("ディスカバリ ルール"および"ディスカバリ チェック"条件)  *注*: リモート コマンドに多くのターゲット ホストがあり、そのうちの 1 つを削除すると、このホストのみがターゲット リストから削除され、操作自体は残ります。 ただし、それが唯一のホストである場合、操作も削除されます。 "テンプレートへのリンク"および"テンプレートからのリンク解除"操作についても同様です。  "メッセージの送信"操作で使用されるユーザーまたはユーザー グループを削除する場合、アクションは無効になりません。

en-us	#### Actions  Discovery events can be the basis of relevant [actions](/manual/config/notifications/action), such as:  -   Sending notifications -   Adding/removing hosts -   Enabling/disabling hosts -   Adding hosts to a group -   Removing hosts from a group -   Linking hosts to/unlinking from a template -   Executing remote scripts  These actions can be configured with respect to the device type, IP, status, uptime/downtime, etc. For full details on configuring actions for network-discovery based events, see action [operation](/manual/config/notifications/action/operation) and [conditions](/manual/config/notifications/action/conditions) pages.  Since network discovery actions are event-based, they will be triggered both when a discovered host is online and when it is offline. It is highly  recommended to add an action [condition](/manual/config/notifications/action/conditions) *Discovery status: up* to avoid such actions as *Add host* being triggered upon *Service Lost*/*Service Down* events.  Otherwise, if a discovered host is manually removed, it will still generate *Service Lost*/*Service Down* events and will be recreated during the next discovery cycle.  ::: noteclassic Linking a discovered host to templates will fail collectively if any of the linkable templates has a unique entity (e.g. item key) that is the same as a unique entity (e.g. item key) already existing on the host or on another of the linkable templates. :::
ja	#### アクション  ディスカバリイベントは、次のような関連する[アクション](/manual/config/notifications/action)の基盤になります：  -   通知の送信 -   ホストの追加/削除 -   ホストの有効化/無効化 -   グループへのホストの追加 -   グループからのホストの削除 -   テンプレートへのホストのリンク/テンプレートからのホストのリンクの削除 -   リモートスクリプトの実行  これらのアクションはデバイスタイプ、IP、ステータス、アップタイム/ダウンタイムなどに関して設定可能です。イベントに基づくネットワークディスカバリに対するアクションの設定に関する詳細は、アクションの[オペレーション](/manual/config/notifications/action/operation)と[コンディション](/manual/config/notifications/action/conditions)のページを参照してください。  ネットワーク検出アクションはイベントベースであるため、検出されたホストがオンラインの場合とオフラインの場合の両方でトリガーされます。 *Service Lost*/*ServiceDown*イベントで*Addhost*がトリガーされるなどのアクションを回避するために、アクション[条件](/manual/config/notifications/action/conditions)*Discovery status:up*を追加することを強くお勧めします。それ以外の場合、検出されたホストが手動で削除された場合でも、*Service Lost*/*Service Down*イベントが生成され、次の検出サイクル中に再作成されます。  ::: noteclassic 検出されたホストのテンプレートへのリンクは、リンク可能なテンプレートのいずれかに、ホストまたは別のリンク可能なテンプレートにすでに存在する一意のエンティティ（アイテムキーなど）と同じ一意のエンティティ（アイテムキーなど）がある場合、まとめて失敗します。 :::

en-us	#### Actions if communication fails between agent and server  Each matching line from `log[]` and `logrt[]` item and a result of each `log.count[]` and `logrt.count[]` item check requires a free slot in the designated 50% area in the agent send buffer. The buffer elements are regularly sent to server (or proxy) and the buffer slots are free again.  While there are free slots in the designated log area in the agent send buffer and communication fails between agent and server (or proxy) the log monitoring results are accumulated in the send buffer. This helps to mitigate short communication failures.  During longer communication failures all log slots get occupied and the following actions are taken:  -   `log[]` and `logrt[]` item checks are stopped. When communication is     restored and free slots in the buffer are available the checks are     resumed from the previous position. No matching lines are lost, they     are just reported later. -   `log.count[]` and `logrt.count[]` checks are stopped if     `maxdelay = 0` (default). Behavior is similar to `log[]` and     `logrt[]` items as described above. Note that this can affect     `log.count[]` and `logrt.count[]` results: for example, one check     counts 100 matching lines in a log file, but as there are no free     slots in the buffer the check is stopped. When communication is     restored the agent counts the same 100 matching lines and also 70     new matching lines. The agent now sends count = 170 as if they were     found in one check. -   `log.count[]` and `logrt.count[]` checks with `maxdelay > 0`: if     there was no "jump" during the check, then behavior is similar to     described above. If a "jump" over log file lines took place then the     position after "jump" is kept and the counted result is discarded.     So, the agent tries to keep up with a growing log file even in case     of communication failure.
ja	#### agent と server 間の通信に失敗した場合の対処法  log[]` と `logrt[]` item からマッチする各行と、各 `log.count[]` と `logrt.count[]` item チェックの結果は、<br> agent 送信バッファ内の指定された50%エリアに空きスロットを必要とします。バッファの要素は定期的に server （または proxy）に送信され、<br>バッファのスロットは再び空きます。  agent 送信バッファの指定ログ領域に空き枠があり、agent と server （または proxy）間の通信に失敗した場合、<br> ログ監視結果が送信バッファに蓄積されます。これにより、短時間の通信障害を緩和することができます。<br>  長時間の通信障害時には、すべてのログスロットが占有され、次のような動作が行われます。  -   log[]` と `logrt[]` の item チェックは停止しています。通信が復旧し、バッファの空きスロットができると、     チェックは前の位置から再開されます。マッチする行は失われず、後で報告されるだけです。 -   maxdelay = 0` (デフォルト) の場合、 `log.count[]` と `logrt.count[]` のチェックが停止します。動作は上記の     `log[]` と `logrt[]` の項目と同様です。これは `log.count[]` と `logrt.count[]` の結果に影響を与えることに注意してください。     例えば、あるチェックでログファイルの100行にマッチしましたが、バッファに空きスロットがないため、チェックは停止されました。     通信が回復したとき、agent は同じ100のマッチする行と、70の新しいマッチする行を数えます。     agent は、あたかも一度のチェックで見つかったかのように、count = 170 を送信します。 -   `maxdelay > 0` の `log.count[]` と `logrt.count[]` のチェック: チェック中に "jump" がなければ、上記の動作と同じになります。     もし、ログファイルの行を "jump" した場合は、 "jump" 後の位置を保持し、カウントした結果は破棄されます。     したがって、agent は、通信障害が発生しても、ログファイルの増加についていこうとします。

en-us	#### Actions  In [actions](/manual/config/notifications/action), user macros can be used in the following fields:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Trigger-based notifications and commands|<|yes| |Trigger-based internal notifications|<|yes| |Problem update notifications|<|yes| |Service-based notifications and commands|<|yes| |Service update notifications|<|yes| |Time period condition|<|no| |*Operations*|<|<| | |Default operation step duration|no| |^|Step duration|no|
ja	#### アクション  [アクション](/manual/config/notifications/action)では、ユーザーマクロを次のフィールドで使用できます。  |ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |トリガーベースの通知とコマンド|<|yes| |トリガーベースの内部通知|<|yes| |障害の更新通知|<|yes| |サービスベースの通知とコマンド|<|yes| |サービス更新通知|<|yes| |期間|<|no| |*オペレーション*|<|<| | |デフォルトの操作ステップ期間|no| |^|ステップ期間|no|

en-us	### Action  The action object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |actionid|string|*(readonly)* ID of the action.| |**esc\_period**<br>(required)|string|Default operation step duration. Must be at least 60 seconds. Accepts seconds, time unit with suffix and user macro.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |**eventsource**<br>(required)|integer|*(constant)* Type of events that the action will handle.<br><br>Refer to the [event "source" property](/manual/api/reference/event/object#event) for a list of supported event types.| |**name**<br>(required)|string|Name of the action.| |status|integer|Whether the action is enabled or disabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |pause\_suppressed|integer|Whether to pause escalation during maintenance periods or not.<br><br>Possible values:<br>0 - Don't pause escalation;<br>1 - *(default)* Pause escalation.<br><br>Note that this parameter is valid for trigger actions only.| |notify\_if\_canceled|integer|Whether to notify when escalation is canceled.<br><br>Possible values:<br>0 - Don't notify when escalation is canceled;<br>1 - *(default)* Notify when escalation is canceled.<br><br>Note that this parameter is valid for trigger actions only.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ja	### Action  actionオブジェクトには次のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |actionid|string|*(読取専用)* アクションのID。| |**esc\_period**<br>(必須)|string|デフォルトの操作ステップ期間。 60秒以上でなければなりません。秒、サフィックス付きのタイムユニット、およびユーザーマクロを受け入れます。<br><br>エスカレーションは、トリガー、内部、サービスおよび通常のアクションでのみサポートされていることに注意してください。| |**eventsource**<br>(必須)|integer|*(定数)* アクションが処理するイベントの種類。<br><br>サポートされているイベントタイプのリストについては、[eventの"source"プロパティ](/manual/api/reference/event/object#event)を参照してください。| |**name**<br>(必須)|string|アクション名| |status|integer|アクションが有効か無効か<br><br>有効な値 :<br>0 -  *(デフォルト)*有効<br>1 - 無効| |pause\_suppressed|integer|メンテナンス期間中にエスカレーションを一時停止するか<br><br>有効な値 :<br>0 - 一時停止しない<br>1 - *(デフォルト)*一時停止する<br><br>このパラメータはトリガーアクションに対してのみ有効なことに注意してください。| |notify\_if\_canceled|integer|エスカレーションがキャンセルされたときに通知するか<br><br>有効な値 :<br>0 - 通知しない<br>1 - *(デフォルト)*通知する<br><br>このパラメータはトリガーアクションに対してのみ有効なことに注意してください。|  一部のメソッド (更新、削除) では、必須/オプションのパラメーターの組み合わせが異なることに注意してください。

en-us	### Action  The action object has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of the action.<br><br>Possible values for users of any type:<br>`edit_dashboards` - Create and edit dashboards;<br>`edit_maps` - Create and edit maps;<br>`add_problem_comments` - Add problem comments;<br>`change_severity` - Change problem severity;<br>`acknowledge_problems` - Acknowledge problems;<br>`close_problems` - Close problems;<br>`execute_scripts` - Execute scripts;<br>`manage_api_tokens` - Manage API tokens.<br><br>Possible values only for users of *Admin* and *Super admin* user types:<br>`edit_maintenance` - Create and edit maintenances;<br>`manage_scheduled_reports` - Manage scheduled reports.| |status|integer|Whether access to perform the action is enabled.<br><br>Possible values:<br>0 - Disabled;<br>1 - *(default)* Enabled.|
ja	### Action  action オブジェクトには次のプロパティがあります  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**name**<br>(必須)|string|アクション名<br><br>任意のタイプのユーザーに可能な値：<br>`edit_dashboards` - ダッシュボードの作成と編集<br>`edit_maps` - マップの作成と編集<br>`add_problem_comments` - 障害のコメント追加<br>`change_severity` - 障害の深刻度を変更<br>`acknowledge_problems` - 障害を確認<br>`close_problems` - 障害をクローズします<br>`execute_scripts` - スクリプトを実行<br>`manage_api_tokens ` - APIトークンを管理<br><br>*Admin*および*Superadmin *ユーザータイプのユーザーにのみ可能な値：<br>`edit_maintenance` - メンテナンスの作成および編集<br>`manage_scheduled_reports` - レポートのスケジュール管理| |status|integer|アクションを実行するためのアクセスが有効か<br><br>使用可能な値：<br>0 - 無効<br>1 - *(デフォルト)*有効|

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

en-us	# action.update
ja	# action.update

en-us	### Action update operation  The action update operation object defines an operation that will be performed when a problem is updated (commented upon, acknowledged, severity changed, or manually closed). Update operations are possible for trigger and service actions. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationid|string|*(readonly)* ID of the action operation.| |**operationtype**<br>(required)|integer|Type of operation.<br><br>Possible values for trigger and service actions:<br>0 - send message;<br>1 - global script;<br>12 - notify all involved.| |opcommand|object|Object containing data on global action type script run by the operation.<br><br>Each object has one following property: `scriptid` - *(string)* ID of the action type script.<br><br>Required for global script operations.| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>Each object has the following properties:<br>`groupid` - *(string)* ID of the host group.<br><br>Required for global script operations if `opcommand_hst` is not set.| |opcommand\_hst|array|Host to run global scripts on.<br><br>Each object has the following properties:<br>`hostid` - *(string)* ID of the host; if set to 0 the command will be run on the current host.<br><br>Required for global script operations if `opcommand_grp` is not set.| |opmessage|object|Object containing the data about the message sent by the update operation.<br><br>The operation message object is [described in detail above](/manual/api/reference/action/object#action_operation_message).| |opmessage\_grp|array|User groups to send messages to.<br><br>Each object has the following properties:<br>`usrgrpid` - *(string)* ID of the user group.<br><br>Required only for `send message` operations if `opmessage_usr` is not set.<br>Is ignored for `send update message` operations.| |opmessage\_usr|array|Users to send messages to.<br><br>Each object has the following properties:<br>`userid` - *(string)* ID of the user.<br><br>Required only for `send message` operations if `opmessage_grp` is not set.<br>Is ignored for `send update message` operations.|
ja	### Action update operation  action update operation オブジェクトは、障害が更新されたときに実行される操作を定義します (コメント、承認、深刻度の変更、または手動でクローズ)。 トリガーとサービスのアクションは、更新操作が可能です。 次のプロパティがあります。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |operationid|string|*(読取専用)* アクションオペレーションID| |**operationtype**<br>(必須)|integer|オペレーションタイプ<br><br>トリガーとサービス アクションの有効な値:<br>0 - メッセージを送信<br>1 - グローバル スクリプト<br>12 - 関係者全員に通知| |opcommand|object|オペレーションによって実行されるグローバル アクション タイプ スクリプトに関するデータを含むオブジェクト。<br><br>各オブジェクトには次のプロパティが 1 つあります。`scriptid` - *(string)* アクション タイプ スクリプトの ID。<br><br>必須 グローバル スクリプト操作。| |opcommand\_grp|array|グローバル スクリプトを実行するホスト グループ<br><br>各オブジェクトには次のプロパティがあります<br>`groupid` - *(string)* ホスト グループの ID<br><br>`opcommand_hst` が設定されていない場合、グローバル スクリプト操作に必要です| |opcommand\_hst|array|グローバル スクリプトを実行するホスト<br><br>各オブジェクトには次のプロパティがあります<br>`hostid` - *(文字列)* ホストの ID。 0 に設定すると、コマンドは現在のホストで実行されます<br><br>`opcommand_grp` が設定されていない場合、グローバル スクリプト操作に必要です。| |opmessage|object|更新操作によって送信されたメッセージに関するデータを含むオブジェクト。<br><br>操作メッセージ オブジェクトは [こちらで詳細に説明します](/manual/api/reference/action/object#action_operation_message).| |opmessage\_grp|array|メッセージを送信するユーザー グループ<br><br>各オブジェクトには次のプロパティがあります<br>`usrgrpid` - *(文字列)* ユーザー グループの ID<br><br>`opmessage_usr` が設定されていない場合、`send message` オペレーションでのみ必要です<br>`send update message` オペレーションでは無視されます| |opmessage\_usr|array|メッセージを送信するユーザー<br><br>各オブジェクトには次のプロパティがあります<br>`userid` - *(文字列)* ユーザーの ID<br><br>`opmessage_grp`が設定されていない場合、`send message` オペレーションでのみ必要です。<br>`send update message`操作では無視されます。|

en-us	#### Active agent autoregistration events  Active agent autoregistration creates events in Zabbix.  If configured, active agent autoregistration event is created when a previously unknown active agent asks for checks or if the host metadata has changed. The server adds a new auto-registered host, using the received IP address and port of the agent.  For more information, see the [active agent autoregistration](/manual/discovery/auto_registration) page.
ja	#### アクティブエージェント自動検出イベント  アクティブ エージェントの自動登録は Zabbixにイベントを作成します。  設定されている場合、以前は知られていなかったアクティブエージェントがチェックを要求した場合、またはホストのメタデータが変更された場合、アクティブ agent の自動登録イベントが作成されます。server は、受信した agent のIPアドレスとポートを使用して、新しい自動登録されたホストを追加します。<br>  詳細については、[active agent autoregistration](/manual/discovery/auto_registration)] ページを参照してください。

en-us	#### Active checks  Active checks require more complex processing. The agent must first retrieve from the server(s) a list of items for independent processing.  The servers to get the active checks from are listed in the 'ServerActive' parameter of the agent [configuration file](/manual/appendix/config/zabbix_agentd). The frequency of asking for these checks is set by the 'RefreshActiveChecks' parameter in the same configuration file. However, if refreshing active checks fails, it is retried after hardcoded 60 seconds.  The agent then periodically sends the new values to the server(s).  ::: notetip If an agent is behind the firewall you might consider using only Active checks because in this case you wouldn't need to modify the firewall to allow initial incoming connections. :::
ja	#### アクティブチェック  アクティブチェックには、より複雑な処理が必要です。 エージェントは、最初にサーバーから独立した処理でアイテムのリストを取得します。  アクティブチェックを取得するサーバーは、エージェント[構成ファイル](/manual/appendix/config/zabbix_agentd)の"ServerActive"パラメーターにリストされています。 これらのチェックを要求する頻度は、同じ構成ファイルの"RefreshActiveChecks"パラメーターによって設定されます。 ただしアクティブチェックの更新に失敗した場合は、ハードコードされた60秒後に再試行されます。  その後、エージェントは定期的に新しい値をサーバーに送信します。  ::: notetip エージェントがファイアウォールの背後にいる場合は、アクティブチェックのみを使用することを検討してください。そうすることで最初の着信接続を許可するためにファイアウォールを変更する必要がなくなります。 :::

en-us	 ### Active checks request  The active checks request is used to obtain the active checks to be processed by agent. This request is sent by the agent upon start and then with *RefreshActiveChecks* inervals.  | Field | Type | Mandatory | Value | |-|-|-|--------| | request | _string_ | yes | `active checks` | | host | _string_ | yes | Host name. | | version | _string_ | yes | The agent version: \<major>.\<minor>. | | host_metadata | _string_ | no | The configuration parameter HostMetadata or HostMetadataItem metric value. | | interface | _string_ | no | The configuration parameter HostInterface or HostInterfaceItem metric value. | | ip | _string_ | no | The configuration parameter ListenIP first IP if set. | | port | _number_ | no | The configuration parameter ListenPort value if set and not default agent listening port. |  Example: ```json {   "request": "active checks",   "host": "Zabbix server",   "version": "6.0",   "host_metadata": "mysql,nginx",   "hostinterface": "zabbix.server.lan",   "ip": "159.168.1.1",   "port": 12050 } ```
ja	### アクティブチェックリクエスト  アクティブチェックリクエストは、エージェントによって処理されるアクティブチェックを取得するために使用されます。 このリクエストは開始時にエージェントによって送信され、その後は*RefreshActiveChecks* で設定されている間隔で送信されます。  | フィールド | タイプ | 必須 | 値 | |-|-|-|--------| | request | _string_ | はい | `active checks` | | host | _string_ | はい | ホスト名 | | version | _string_ | はい | エージェントのバージョン: \<メジャー>.\<マイナー>. | | host_metadata | _string_ | いいえ | 設定パラメータ HostMetadata または HostMetadataItem メトリック値| | interface | _string_ | いいえ | 設定パラメータ HostInterface または HostInterfaceItem メトリック値 | | ip | _string_ | いいえ | 設定パラメータ ListenIPが設定されている場合は先頭のIP| | port | _number_ | いいえ | 設定パラメータ ListenPort 値 (設定されている場合) であり、デフォルトのエージェント・リスニング・ポートではありません。|  例: ```json {   "request": "active checks",   "host": "Zabbix server",   "version": "6.0",   "host_metadata": "mysql,nginx",   "hostinterface": "zabbix.server.lan",   "ip": "159.168.1.1",   "port": 12050 } ```

en-us	#### Active proxy
ja	#### アクティブプロキシ

en-us	#### Add a trigger dependency  Make trigger "14092" dependent on trigger "13565."  Request:  ```json {     "jsonrpc": "2.0",     "method": "trigger.adddependencies",     "params": {         "triggerid": "14092",         "dependsOnTriggerid": "13565"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "14092"         ]     },     "id": 1 } ```
ja	#### トリガーの依存関係を追加する  トリガー"13565"に依存するトリガー"14092"を作成します  Request:  ```json {     "jsonrpc": "2.0",     "method": "trigger.adddependencies",     "params": {         "triggerid": "14092",         "dependsOnTriggerid": "13565"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "14092"         ]     },     "id": 1 } ```

en-us	#### Adding a filter to an LLD rule  Add a filter so that the contents of the *{\#FSTYPE}* macro would match the *\@File systems for discovery* regexp.  Request:  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "22450",         "filter": {             "evaltype": 1,             "conditions": [                 {                     "macro": "{#FSTYPE}",                     "value": "@File systems for discovery"                 }             ]         }     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "22450"         ]     },     "id": 1 } ```
ja	#### LLDルールへのフィルターの追加  *{\#FSTYPE}*マクロの内容が*\@File systems for discovery*の正規表現と一致するようにフィルターを追加します。  Request:  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "22450",         "filter": {             "evaltype": 1,             "conditions": [                 {                     "macro": "{#FSTYPE}",                     "value": "@File systems for discovery"                 }             ]         }     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "22450"         ]     },     "id": 1 } ```

en-us	#### Adding a scheduled downtime  Add a downtime for service with ID "4" scheduled weekly from Monday 22:00 till Tuesday 10:00.  Request:  ```json {     "jsonrpc": "2.0",     "method": "service.update",     "params": {         "serviceid": "4",         "times": [             {                 "type": "1",                 "ts_from": "165600",                 "ts_to": "201600"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "serviceids": [             "4"         ]     },     "id": 1 } ```
ja	#### スケジュールされたダウンタイムの追加  ID"4"のサービスに毎週月曜日22:00から火曜日10:00でスケジュールされたダウンタイムを追加します  Request:  ```json {     "jsonrpc": "2.0",     "method": "service.update",     "params": {         "serviceid": "4",         "times": [             {                 "type": "1",                 "ts_from": "165600",                 "ts_to": "201600"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "serviceids": [             "4"         ]     },     "id": 1 } ```

en-us	##### Adding host  Hosts are added during the discovery process, as soon as a host is discovered, rather than at the end of the discovery process.  ::: notetip As network discovery can take some time due to many unavailable hosts/services having patience and using reasonable IP ranges is advisable. :::  When adding a host, its name is decided by the standard **gethostbyname** function. If the host can be resolved, resolved name is used. If not, the IP address is used. Besides, if IPv6 address must be used for a host name, then all ":" (colons) are replaced by "\_" (underscores), since colons are not allowed in host names.  ::: noteimportant If performing discovery by a proxy, currently hostname lookup still takes place on Zabbix server. :::  ::: noteimportant If a host already exists in Zabbix configuration with the same name as a newly discovered one, versions of Zabbix prior to 1.8 would add another host with the same name. Zabbix 1.8.1 and later adds **\_N** to the hostname, where **N** is increasing number, starting with 2. :::
ja	##### ホストの追加  ホストが検出されると検出プロセスの最後まで待たず、検出プロセス中すぐに追加されます。  ::: notetip 多くの利用できないホスト/サービスが原因で、ネットワークの検出に時間がかかることがあるため、忍耐力と妥当な IP 範囲を使用することをお勧めします。 :::  ホストを追加するとき、その名前は標準の **gethostbyname** 関数によって決定されます。 ホストを解決できる場合は、解決された名前が使用されます。 そうでない場合は、IP アドレスが使用されます。 また、ホスト名に IPv6 アドレスを使用する必要がある場合は、ホスト名にコロンを使用できないため、すべての":"(コロン) が"\_"(アンダースコア) に置き換えられます。  ::: noteimportant プロキシによる検出を実行する場合でも、ホスト名のルックアップは引き続き Zabbix サーバーで行われます。 :::  ::: noteimportant If a host already exists in Zabbix configuration with the same name as a newly discovered one, versions of Zabbix prior to 1.8 would add another host with the same name. Zabbix 1.8.1 and later adds **\_N** to the hostname, where **N** is increasing number, starting with 2. :::

en-us	#### Adding host  Information about configured hosts in Zabbix is available in *Configuration → Hosts* and *Monitoring* → *Hosts*. There is already one pre-defined host, called "Zabbix server", but we want to learn adding another.  To add a new host, click on *Create host*. This will present us with a host configuration form.\ ![](../../../assets/en/manual/quickstart/new_host.png)  All mandatory input fields are marked with a red asterisk.  The bare minimum to enter here is:  ***Host name***  -   Enter a host name. Alphanumerics, spaces, dots, dashes and     underscores are allowed.  ***Groups***  -   Select one or several existing groups by clicking *Select* button or     enter a non-existing group name to create a new group.  ::: noteclassic All access permissions are assigned to host groups, not individual hosts. That is why a host must belong to at least one group. :::  ***Interfaces: IP address***  -   Although not a required field technically, a host interface is necessary for collecting certain metrics.     To use Zabbix agent passive checks, specify the agent's IP or DNS in this field.     Note that you should also specify Zabbix server's IP or DNS in the Zabbix agent configuration file 'Server' directive.     If Zabbix agent and Zabbix server are installed on the same machine, you need to specify the same IP/DNS in both places.      [Other options](/manual/config/hosts/host#configuration) can be left at their defaults for now.  When done, click *Add*. Your new host should be visible in the host list.  ![](../../../assets/en/manual/quickstart/host_list.png){width="600"}  The Availability column contains indicators of host availability per each interface. You have defined a Zabbix agent interface, so you can use the agent availability icon (with "ZBX" on it) to understand the host availability:  -   ![icon\_zbx\_gray.png](../../../assets/en/manual/quickstart/icon_zbx_gray.png) -     host status has not been established; no metric check has happened     yet -   ![icon\_zbx\_green.png](../../../assets/en/manual/quickstart/icon_zbx_green.png) -     host is available, a metric check has been successful -   ![icon\_zbx\_red.png](../../../assets/en/manual/quickstart/icon_zbx_red.png) -     host is unavailable, a metric check has failed (move your mouse     cursor over the icon to see the error message). There might be some     error with communication, possibly caused by incorrect interface     credentials. Check that Zabbix server is running, and try refreshing     the page later as well.
ja	#### ホストの追加  Zabbixで設定されたホストに関する情報は、*設定 → ホスト*と*監視 → ホスト*で利用できます。 "Zabbix server"という事前定義されたホストがすでに1つありますが、別のホストを追加します。  新しいホストを追加するには、*ホストの作成*をクリックします。するとホスト構成フォームが表示されます。\ ![](../../../assets/en/manual/quickstart/new_host.png)  すべての必須入力フィールドは、赤いアスタリスクでマークされています。  最低限入力が必要な項目は次のとおりです。  ***ホスト名***  -   ホスト名を入力します。英数字、スペース、ドット、ダッシュ、アンダースコアを使用できます。  ***グループ***  -   *選択*ボタンをクリックして1つまたは複数の既存のグループを選択するか、存在しないグループ名を入力して、新しいグループを作成します。  ::: 掲示 すべてのアクセス許可は、個々のホストではなく、ホストグループに割り当てられます。そのため、ホストは少なくとも1つのグループに属している必要があります。 :::  ***インターフェース：IPアドレス***  -   技術的には必須フィールドではありませんが、ホストのIPアドレスを入力することをお勧めします。これがZabbixサーバーのIPアドレスである場合は、Zabbixエージェント設定ファイルの'サーバー'ディレクティブで指定する必要があることに注意してください。ZabbixエージェントとZabbixサーバーが同じマシンにインストールされている場合は、両方の場所で同じIP/DNSを指定する必要があります。  [その他のオプション](/manual/config/hosts/host#configuration)は今のところデフォルトとします。  完了したら、*追加*をクリックします。新しいホストがホストリストに表示されます。  ![](../../../assets/en/manual/quickstart/host_list.png){width="600"}  エージェントの状態列には、各インターフェイスごとのホストの可用性のインジケーターが含まれています。 Zabbixエージェントインターフェイスを定義したので、エージェントの可用性アイコン（"ZBX"が付いている）から、ホストの可用性を確認できます。  - ![icon\_zbx\_gray.png](../../../assets/en/manual/quickstart/icon_zbx_gray.png) - ホストステータスが確立されていません。メトリックチェックはまだ行われていません - ![icon\_zbx\_green.png](../../../assets/en/manual/quickstart/icon_zbx_green.png) - ホストが利用可能で、メトリックチェックが成功しました - ![icon\_zbx\_red.png](../../../assets/en/manual/quickstart/icon_zbx_red.png) - ホストが利用できないため、メトリックチェックに失敗しました（マウスカーソルをアイコンの上に移動すると、エラーメッセージが表示されます）。インターフェースのクレデンシャルが正しくないことが原因で、通信にエラーが発生している可能性があります。 Zabbixサーバーが実行されていることを確認し、後でページを更新してみてください。

en-us	#### Adding hosts to host groups  Add two hosts to host groups with IDs 5 and 6.  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "hostgroup.massadd",     "params": {         "groups": [             {                 "groupid": "5"             },             {                 "groupid": "6"             }         ],         "hosts": [             {                 "hostid": "30050"             },             {                 "hostid": "30001"             }         ]     },     "auth": "f223adf833b2bf2ff38574a67bba6372",     "id": 1 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "groupids": [             "5",             "6"         ]     },     "id": 1 } ```
ja	#### host group への host の追加  IDが5と6の  host group に2台の host を追加します。  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "hostgroup.massadd",     "params": {         "groups": [             {                 "groupid": "5"             },             {                 "groupid": "6"             }         ],         "hosts": [             {                 "hostid": "30050"             },             {                 "hostid": "30001"             }         ]     },     "auth": "f223adf833b2bf2ff38574a67bba6372",     "id": 1 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "groupids": [             "5",             "6"         ]     },     "id": 1 } ```

en-us	#### Adding item  All items are grouped around hosts. That is why to configure a sample item we go to *Configuration → Hosts* and find the 'New host' we have created.  Click on the *Items* link in the row of 'New host', and then click on *Create item*. This will present us with an item definition form.  ![](../../../assets/en/manual/quickstart/new_item.png)  All mandatory input fields are marked with a red asterisk.  For our sample item, the essential information to enter is:  ***Name***  -   Enter *CPU load* as the value. This will be the item name displayed     in lists and elsewhere.  ***Key***  -   Manually enter *system.cpu.load* as the value. This is the technical     name of an item that identifies the type of information that will be     gathered. The particular key is just one of [pre-defined     keys](/manual/config/items/itemtypes/zabbix_agent) that come with     Zabbix agent.  ***Type of information***  -   This attribute defines the format of the expected data. For the     *system.cpu.load* key, this field will be automatically set to     *Numeric (float)*.  ::: noteclassic You may also want to reduce the number of days [item history](/manual/config/items/history_and_trends) will be kept, to 7 or 14. This is good practice to relieve the database from keeping lots of historical values. :::  [Other options](/manual/config/items/item#configuration) will suit us with their defaults for now.  When done, click *Add*. The new item should appear in the item list. Click on *Details* above the list to view what exactly was done.  ![](../../../assets/en/manual/quickstart/item_created.png)
ja	#### アイテムの追加  すべてのアイテムはホストを中心にグループ化されます。そのため、サンプルアイテムを設定するには、*設定 → ホスト*と移動し、作成した '新しいホスト' を見つけます。  '新しいホスト' の行にある*アイテム*リンクをクリックし、*アイテムの作成*をクリックします。これにより、アイテム作成フォームが表示されます。  ![](../../../assets/en/manual/quickstart/new_item.png)  すべての入力必須項目には赤いアスタリスクが付いています。  サンプルアイテムの場合、入力する必須情報は次のとおりです。  ***名前***  -   *CPU load*を入力します。リストなどに表示されるアイテムの名称となります。  ***キー***  -   *system.cpu.load*を入力します。これはアイテムの技術的な名称となり、収集されるデータの種類の識別に使われます。特定のキーは、Zabbixエージェントに付属する[事前定義されたキー](/manual/config/items/itemtypes/zabbix_agent)の1つにすぎません。  ***データ型***  -   この項目は、予期されるデータの形式を定義します。*system.cpu.load*キーの場合、このフィールドは自動的に*Numeric (float)*に設定されます。  ::: noteclassic [アイテムのヒストリ](/manual/config/items/history_and_trends)が保持される日数を7または14に減らすこともできます。これは、データベースに大量のヒストリデータが保持されないようにするための良い習慣です。 :::  [その他のオプション](/manual/config/items/item#configuration) は、今のところデフォルトのままで大丈夫です。  完了したら、*追加*をクリックします。新しいアイテムがアイテムリストに表示されます。 リストの上にある*詳細*をクリックすると、実際に何が行われたのかが表示されます。  ![](../../../assets/en/manual/quickstart/item_created.png)

en-us	#### Adding item to template  To add an item to the template, go to the item list for 'New host'. In *Configuration → Hosts* click on *Items* next to 'New host'.  Then:  -   mark the checkbox of the 'CPU Load' item in the list -   click on *Copy* below the list -   select the template to copy item to  ![](../../../assets/en/manual/quickstart/copy_to_template.png)  All mandatory input fields are marked with a red asterisk.  -   click on *Copy*  If you now go to *Configuration → Templates*, 'New template' should have one new item in it.  We will stop at one item only for now, but similarly you can add any other items, triggers or other entities to the template until it's a fairly complete set of entities for given purpose (monitoring OS, monitoring single application).
ja	#### テンプレートにアイテムを追加する アイテムをテンプレートに挿入するには、`新規ホスト`のアイテムリストに移動します。*設定→ホスト*でアイテム`新規ホスト`の横にある*アイテム*をクリックします。  そして  - `CPU Load`のチェックボックスをチェックを入れます。 - リストの下にある*コピー*をクリックします。 - アイテムをコピーするテンプレートを選びます。  ![](../../../assets/en/manual/quickstart/copy_to_template.png)  記入が必須の項目には、赤いアスタリスクが表記されます。  - コピーのクリック この段階で*設定→テンプレート*に行くと、`新規テンプレート`に新しいアイテムが追加されているはずです。  この段階では1つの項目だけにしておきますが、同様にほかのアイテムやトリガー等を、希望の目的(OSの監視、単一のアプリケーションのモニタリング等)に対する動作の完全なセットを完成させるまでテンプレートに追加する事が出来ます。

en-us	##### Adding JMX agent item  For each JMX counter you are interested in you add **JMX agent** item attached to that interface.\  The key in the screenshot below says `jmx["java.lang:type=Memory","HeapMemoryUsage.used"]`.  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_item.png)  All mandatory input fields are marked with a red asterisk.  The fields that require specific information for JMX items are:  |   |   | |--|--------| |*Type*|Set **JMX agent** here.| |*Key*|The `jmx[]` item key contains three parameters:<br>**object name** - the object name of an MBean<br>**attribute name** - an MBean attribute name with optional composite data field names separated by dots<br>**unique short description** - a unique description that allows multiple JMX items with the same object name and attribute name on the host (optional)<br>See below for more detail on JMX item keys.<br>Since Zabbix 3.4, you may discover MBeans and MBean attributes using a `jmx.discovery[]` [low-level discovery](/manual/discovery/low_level_discovery/examples/jmx) item.| |*JMX endpoint*|You may specify a custom JMX endpoint. Make sure that JMX endpoint connection parameters match the JMX interface. This can be achieved by using {HOST.\*} macros as done in the default JMX endpoint.<br>This field is supported since 3.4.0. {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) and user macros are supported.| |*User name*|Specify the user name, if you have configured authentication on your Java application.<br>User macros are supported.| |*Password*|Specify the password, if you have configured authentication on your Java application.<br>User macros are supported.|  If you wish to monitor a Boolean counter that is either "true" or "false", then you specify type of information as "Numeric (unsigned)" and select "Boolean to decimal" preprocessing step in the Preprocessing tab. Server will store Boolean values as 1 or 0, respectively.
ja	##### JMX エージェント項目の追加  関心のある JMX カウンターごとに、そのインターフェースに接続された **JMX agent** item を追加します。  下のスクリーンショットのキーには、次のように書かれています。`jmx["java.lang:type=Memory", "HeapMemoryUsage.used"]`  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_item.png)  必須入力項目には、赤いアスタリスクが表示されています。  JMX item で特定の情報を必要とするフィールドは、以下の通りです。  |   |   | |--|--------| |*型*| **JMX agent** をここにセット| |*Key*|The `jmx[]` item key contains three parameters:<br>**object name** - the object name of an MBean<br>**attribute name** - an MBean attribute name with optional composite data field names separated by dots<br>**unique short description** - a unique description that allows multiple JMX items with the same object name and attribute name on the host (optional)<br>See below for more detail on JMX item keys.<br>Since Zabbix 3.4, you may discover MBeans and MBean attributes using a `jmx.discovery[]` [low-level discovery](/manual/discovery/low_level_discovery/examples/jmx) item.| |*JMX endpoint*|You may specify a custom JMX endpoint. Make sure that JMX endpoint connection parameters match the JMX interface. This can be achieved by using {HOST.\*} macros as done in the default JMX endpoint.<br>This field is supported since 3.4.0. {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) and user macros are supported.| |*User name*|Specify the user name, if you have configured authentication on your Java application.<br>User macros are supported.| |*Password*|Specify the password, if you have configured authentication on your Java application.<br>User macros are supported.|  "true "または "false "のブール値カウンターを監視したい場合は、情報のタイプを "Numeric（unsigned）"に指定し、<br> プリプロセッシングタブで "Boolean to decimal "プリプロセスステップを選択します。<br> サーバーはブール値をそれぞれ1または0として格納します。

en-us	#### Adding lines  In addition to shapes, it is also possible to add some lines. Lines can be used to link elements or shapes in a map.  To add a line, click on *Add* next to Shape. A new shape will appear at the top left corner of the map. Select it and click on *Line* in the editing form to change the shape into a line. Then adjust line properties, such as line type, width, color, etc.  ![map\_line.png](../../../../../assets/en/manual/config/visualization/map_line.png){width="600"}
ja	#### 線の追加  図形だけでなく、線を追加することも可能です。線は、地図上の要素や図形をつなぐために使用します。  線を追加するには、図形の隣にある *Add* をクリックします。新しい図形がマップの左上隅に表示されます。それを選択し、<br> 編集フォームの *Line* をクリックして、図形を線に変更します。次に、線の種類、幅、色など、線のプロパティを調整します。  ![map\_line.png](../../../../../assets/en/manual/config/visualization/map_line.png){width="600"}

en-us	#### Adding LLD macro paths  Request:  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "22450",         "lld_macro_paths": [             {                 "lld_macro": "{#MACRO1}",                 "path": "$.json.path"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "22450"         ]     },     "id": 1 } ```
ja	#### LLDマクロパスの追加  Request:  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "22450",         "lld_macro_paths": [             {                 "lld_macro": "{#MACRO1}",                 "path": "$.json.path"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "22450"         ]     },     "id": 1 } ```

en-us	#### Adding macros  Add two new macros to two hosts.  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "host.massadd",     "params": {         "hosts": [             {                 "hostid": "10160"             },             {                 "hostid": "10167"             }         ],         "macros": [             {                 "macro": "{$TEST1}",                 "value": "MACROTEST1"             },             {                 "macro": "{$TEST2}",                 "value": "MACROTEST2",                 "description": "Test description"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10160",             "10167"         ]     },     "id": 1 } ```
ja	#### マクロの追加  2つのホストに2つの新しいマクロを追加します。  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "host.massadd",     "params": {         "hosts": [             {                 "hostid": "10160"             },             {                 "hostid": "10167"             }         ],         "macros": [             {                 "macro": "{$TEST1}",                 "value": "MACROTEST1"             },             {                 "macro": "{$TEST2}",                 "value": "MACROTEST2",                 "description": "Test description"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10160",             "10167"         ]     },     "id": 1 } ```

en-us	#### Adding pages  To add a new page to a dashboard:  -   Make sure the dashboard is in the [editing     mode](#viewing_and_editing_a_dashboard) -   Click on the arrow next to the *Add* button and select the *Add     page* option  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_page_add.png)  -   Fill the general page parameters and click on *Apply*. If you leave     the name empty, the page will be added with a `Page N` name where     'N' is the incremental number of the page. The page display period     allows to customize how long a page is displayed in a slideshow.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_page_properties.png)  A new page will be added, indicated by a new tab (*Page 2*).  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_page_new.png)  The pages can be reordered by dragging-and-dropping the page tabs. Reordering maintains the original page naming. It is always possible to go to each page by clicking on its tab.  When a new page is added, it is empty. You can add widgets to it as described above.
ja	#### ページの追加  ダッシュボードにページを追加するには  -   ダッシュボードが[編集モード](#viewing_and_editing_a_dashboard)になっていることを確認します -   *追加*ボタンの横にある矢印をクリックして*ページを追加*オプションを選択します  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_page_add.png)  -   一般的なページパラメータを入力し、[適用]をクリックします。 名前を空のままにすると、ページに「ページN」という名前が追加されます。「N」はページの増分番号です。 ページ表示期間でスライドショーでページを表示する期間をカスタマイズできます。  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_page_properties.png)  新しいタブ（*ページ2 *）で表示される新しいページが追加されます。  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_page_new.png)  ページタブをドラッグアンドドロップすることで、ページを並べ替えることができます。 並べ替えても元のページの名前が維持されます。 タブをクリックすると、いつでも各ページに移動できます。  新しいページは空で追加されます。上記のようにウィジェットを追加できます。

en-us	##### Adding permissions  By default, a new user has no permissions to access hosts. To grant the user rights, click on the group of the user in the *Groups* column (in this case - 'Zabbix administrators'). In the group properties form, go to the *Permissions* tab.  ![](../../../assets/en/manual/quickstart/group_permissions.png){width="600"}  This user is to have read-only access to *Linux servers* group, so click on *Select* next to the host group selection field.  ![](../../../assets/en/manual/quickstart/add_permissions.png)  In this popup, mark the checkbox next to 'Linux servers', then click *Select*. *Linux servers* should be displayed in the selection field. Click the 'Read' button to set the permission level and then *Add* to add the group to the list of permissions. In the user group properties form, click *Update*.  ::: noteimportant In Zabbix, access rights to hosts are assigned to [user groups](/manual/config/users_and_usergroups/usergroup), not individual users. :::  Done! You may try to log in using the credentials of the new user.
ja	##### 権限の追加  デフォルトでは、新しいユーザーにはホストにアクセスするための権限がありません。 権限を付与するには*グループ*列のグループをクリックします。（この場合-'Zabbix administrators'） グループプロパティフォームで*権限*タブに移動します。  ![](../../../assets/en/manual/quickstart/group_permissions.png){width="600"}  このユーザーは*Linux servers*グループへの読み取り専用アクセス権を持っているため、ユーザーグループ選択フィールドの横にある*選択*をクリックします。  ![](../../../assets/en/manual/quickstart/add_permissions.png)  このポップアップで、'Linux servers'の横にあるチェックボックスをオンにして*選択*をクリックすると*Linux servers*が選択フィールドに表示されます。  '読み取り'ボタンをクリックしてアクセス許可レベルを設定し、*追加*をクリックしてグループをアクセス許可のリストに追加します。 ユーザーグループのプロパティフォームで、*更新*をクリックします。  :::注意重要 Zabbixでは、ホストへのアクセス権は個々のユーザーではなく、[ユーザーグループ](/manual/config/users_and_usergroups/usergroup)に割り当てられます。 :::  以上で新しいユーザーの資格情報を使用してログインを試みることができます。

en-us	#### Adding shapes  In addition to map elements, it is also possible to add some shapes. Shapes are not map elements; they are just a visual representation. For example, a rectangle shape can be used as a background to group some hosts. Rectangle and ellipse shapes can be added.  To add a shape, click on *Add* next to Shape. The new shape will appear at the top left corner of the map. Drag and drop it wherever you like.  A new shape is added with default colors. By clicking on the shape, a form is displayed and you can customize the way a shape looks, add text, etc.  ![](../../../../../assets/en/manual/config/visualization/map_shape.png){width="600"}  To select shapes, select one and then hold down *Ctrl* to select the others. With several shapes selected, common properties can be mass updated, similarly as with elements.  Text can be added in the shapes. Expression [macros](/manual/appendix/macros/supported_by_location) are supported in the text, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).  To display text only the shape can be made invisible by removing the shape border (select 'None' in the *Border* field). For example, take note of how the {MAP.NAME} macro, visible in the screenshot above, is actually a rectangle shape with text, which can be seen when clicking on the macro:  ![](../../../../../assets/en/manual/config/visualization/map_name_macro.png)  {MAP.NAME} resolves to the configured map name when viewing the map.  If hyperlinks are used in the text, they become clickable when viewing the map.  Line wrapping for text is always "on" within shapes. However, within an ellipse, the lines are wrapped as though the ellipse were a rectangle. Word wrapping is not implemented, so long words (words that do not fit the shape) are not wrapped, but are masked (constructor page) or clipped (other pages with maps).
ja	#### 図形の追加  地図要素に加えて、いくつかの図形を追加することができます。<br> 図形は地図の要素ではなく、視覚的な表現に過ぎません。例えば、長方形の図形は、いくつかのホストをグループ化するための<br> 背景として使用することができます。矩形と楕円の形状を追加することができます。  図形を追加するには、図形の隣にある *Add* をクリックします。新しい図形がマップの左上隅に表示されます。<br> 好きな場所にドラッグ＆ドロップしてください。  新しいシェイプは、デフォルトの色で追加されます。シェイプをクリックすると、フォームが表示され、シェイプの見え方を<br> カスタマイズしたり、テキストを追加したりすることができます。  ![](../../../../../assets/en/manual/config/visualization/map_shape.png){width="600"}  図形を選択するには、1つを選択し、*Ctrl* を押しながら他の図形を選択します。複数のシェイプを選択した状態で、<br> 要素と同様に共通のプロパティを一括更新することができます。  シェイプ内にテキストを追加することができます。表現方法[マクロ](/manual/appendix/macros/supported_by_location) はテキストでサポートされていますが、<br> 時間をパラメータとした `avg`, `last`, `min`, `max` 関数のみです (例えば、 `{?avg(/host/key,1h)}`)  テキストだけを表示するには、シェイプのボーダーを削除して非表示にすることができます。 (*Border* フィールドで 'None' を選択)<br> 例えば、上のスクリーンショットで表示されている{MAP.NAME}マクロは、実際にはテキスト付きの矩形形状です。<br> マクロをクリックすると、テキスト付きの長方形のシェイプが表示されます。:  ![](../../../../../assets/en/manual/config/visualization/map_name_macro.png)  {MAP.NAME} は、マップを表示するときに設定されたマップ名に解決されます。  テキストでハイパーリンクが使用されている場合、マップを表示するときにクリックできるようになります。  図形内では、テキストの行の折り返しは常に "on" になっています。ただし、楕円の中では、楕円が矩形であるかのように<br> 線が折り返されます。単語の折り返しは実装されていないので、長い単語（シェイプに合わない単語）は折り返されず、<br> マスク（コンストラクタ・ページ）またはクリップ（マップを含む他のページ）されます。

en-us	#### Adding template  To start working with templates, we must first create one. To do that, in *Configuration → Templates* click on *Create template*. This will present us with a template configuration form.\ ![](../../../assets/en/manual/quickstart/new_template.png)  All mandatory input fields are marked with a red asterisk.  The required parameters to enter here are:  ***Template name***  -   Enter a template name. Alpha-numericals, spaces and underscores are     allowed.  ***Groups***  -   Select one or several groups by clicking *Select* button. The     template must belong to a group.  When done, click *Add*. Your new template should be visible in the list of templates.  ![](../../../assets/en/manual/quickstart/template_list.png){width="600"}  As you may see, the template is there, but it holds nothing in it - no items, triggers or other entities.
ja	#### テンプレートの追加方法 テンプレートを使用するには、まずテンプレートを作成する必要があります。*設定→テンプレート*と進み、*テンプレートの作成*をクリックしてください。すると、テンプレート設定フォームが開きます。 ![](../../../assets/en/manual/quickstart/new_template.png)  記入が必須の項目には、赤いアスタリスクが表記されます。  入力必須なパラメーターは以下の通りです。  ***テンプレート名*** - テンプレート名を入力します。アルファベット、数字、スペース、下線を使用可能です。  ***グループ*** - *セレクト*ボタンをクリックして、1つ、または複数のグループを選択します。テンプレートはグループに所属している必要があります。  選択が終わったら、「追加」をクリックします。これで新規作成したテンプレートがテンプレートリストに表示されます。  ![](../../../assets/en/manual/quickstart/template_list.png){width="600"}  御覧の通り、テンプレートはそこにありますが、まだその中にはアイテムやトリガー等の実体は入っていません。

en-us	#### Adding trigger  To configure a trigger for our item, go to *Configuration → Hosts*, find 'New host' and click on *Triggers* next to it and then on *Create trigger*. This presents us with a trigger definition form.\ ![](../../../assets/en/manual/quickstart/new_trigger.png)  For our trigger, the essential information to enter here is:  *Name*  -   Enter *CPU load too high on 'New host' for 3 minutes* as the value.     This will be the trigger name displayed in lists and elsewhere.  *Expression*  -   Enter: avg(/New host/system.cpu.load,3m)>2  This is the trigger expression. Make sure that the expression is entered right, down to the last symbol. The item key here (system.cpu.load) is used to refer to the item. This particular expression basically says that the problem threshold is exceeded when the CPU load average value for 3 minutes is over 2. You can learn more about the [syntax of trigger expressions](/manual/config/triggers/expression).  When done, click *Add*. The new trigger should appear in the trigger list.
ja	#### トリガーの追加  アイテムのトリガーを構成するには *Configuration → Hosts*に移動し、'New host'を見つけて、その横にある *Triggers*をクリックし *Create  trigger*をクリックします。これによりトリガー定義フォームが表示されます。  ![](../../../assets/en/manual/quickstart/new_trigger.png)  入力必須項目は次のとおりです。  *Name*  - 今回は*CPU load too high on 'New host' for 3 minutes*と設定しています。これは、リストなどに表示されるトリガー名になります。  *Expression*  - 今回は次のように入力します：avg(/New host/system.cpu.load,3m)>2  トリガー式が最後の記号まで正しく入力されていることを確認してください。ここでのアイテムキー（system.cpu.load）は、アイテムを参照するために使用されます。この式は、3分間のCPU負荷平均値が2を超過することをしきい値としています。[トリガー式の構文解説](/manual/config/triggers/expression)  完了したら*Add*をクリックします。新しいトリガーがトリガーリストに表示されます。

en-us	#### Adding user  To view information about users, go to *Administration → Users*.  ![](../../../assets/en/manual/quickstart/userlist.png){width="600"}  To add a new user, click on *Create user*.  In the new user form, make sure to add your user to one of the existing [user groups](/manual/config/users_and_usergroups/usergroup), for example 'Zabbix administrators'.  ![](../../../assets/en/manual/quickstart/new_user.png)  All mandatory input fields are marked with a red asterisk.  By default, new users have no media (notification delivery methods) defined for them. To create one, go to the 'Media' tab and click on *Add*.  ![](../../../assets/en/manual/quickstart/new_media.png)  In this pop-up, enter an email address for the user.  You can specify a time period when the medium will be active (see [Time period specification](/manual/appendix/time_period) page for a description of the format), by default a medium is always active. You can also customize [trigger severity](/manual/config/triggers/severity) levels for which the medium will be active, but leave all of them enabled for now.  Click on *Add* to save the medium, then go to the Permissions tab.  Permissions tab has a mandatory field *Role*. The role determines which frontend elements the user can view and which actions he is allowed to perform. Press Select and select one of the roles from the list. For example, select *Admin role* to allow access to all Zabbix frontend sections, except Administration. Later on, you can modify permissions or create more user roles. Upon selecting a role, permissions will appear in the same tab:  ![user\_permissions.png](../../../assets/en/manual/quickstart/user_permissions.png){width="600"}  Click *Add* in the user properties form to save the user. The new user appears in the userlist.  ![](../../../assets/en/manual/quickstart/userlist2.png){width="600"}
ja	#### ユーザーの追加  ユーザーに関する情報を表示するには、*[管理]→[ユーザー]*に移動します。  ![](../../../assets/en/manual/quickstart/userlist.png){width="600"}  新しいユーザーを追加するには、*ユーザーの作成*をクリックします。  新しいユーザーフォームで、必ず既存の[ユーザーグループ](/manual/config/users_and_usergroups/usergroup)の1つにユーザーを追加してください。 例: Zabbix administrators  ![](../../../assets/en/manual/quickstart/new_user.png)  すべての必須入力フィールドは、赤いアスタリスクでマークされています。  デフォルトでは、新規ユーザーにはメディア（通知配信方法）がありません。 作成するには、'メディア'タブに移動し、*追加*をクリックします。  ![](../../../assets/en/manual/quickstart/new_media.png)  このポップアップで、ユーザーの電子メールアドレスを入力します。  メディアがアクティブになる期間を指定できます (入植形式については[期間の指定](/manual/appendix/time_period)ページを参照してください)。 デフォルトでは、メディアは常にアクティブです。 メディアがアクティブになる[トリガーの重大度レベル](/manual/config/triggers/severity)をカスタマイズすることもできますが、現時点ではすべてを有効のままにしておきます。  *追加*をクリックしてメディアを保存し、権限タブに移動します。  権限タブには、必須フィールド*ユーザーの役割*があります。 このユーザーの役割は、ユーザーが表示できるフロントエンド要素と、ユーザーが実行できるアクションを決定します。 選択を押してリストからユーザーの役割の1つを選択します。 たとえば*Admin role*を選択して、すべてのZabbixフロントエンドセクションへのアクセスを許可します。 後で権限を変更したり、より多くのユーザーロールを設定することも可能です。 ユーザーの役割を選択すると、権限が同じタブ内に表示されます。  ![user\_permissions.png](../../../assets/en/manual/quickstart/user_permissions.png){width="600"}  ユーザープロパティフォームの*追加*をクリックして、ユーザーを保存します。 新しいユーザーがユーザーリストに表示されます。  ![](../../../assets/en/manual/quickstart/userlist2.png){width="600"}

en-us	#### Adding web scenarios  To add web scenarios to a template in *Configuration → Templates*, do the following:  -   Click on *Web* in the row of the template -   Configure a web scenario following the usual method of [configuring     web scenarios](/manual/web_monitoring#configuring_a_web_scenario)
ja	#### Webシナリオの追加  Webシナリオをテンプレートに追加するには、*[設定] → [テンプレート]*で次の手順を実行します。  -   テンプレートの行で *Web* をクリック -   [configuring web scenarios](/manual/web_monitoring#configuring_a_web_scenario)に従って、Web シナリオを設定します。

en-us	#### Adding widgets  To add a widget to a dashboard:  -   Click on the     ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_add_button.png)     button or the *Add widget* option in the action menu that can be     opened by clicking on the arrow. Fill the widget configuration form.     The widget will be created in its default size and placed after the     existing widgets (if any);  Or  -   Move your mouse to the desired empty spot for the new widget. Notice     how a placeholder appears, on mouseover, on any empty slot on the     dashboard. Then click to open the widget configuration form. After     filling the form the widget will be created in its default size or,     if its default size is bigger than is available, take up the     available space. Alternatively, you may click and drag the     placeholder to the desired widget size, then release, and then fill     the widget configuration form. (Note that when there is a widget     copied onto the clipboard, you will be first prompted to select     between *Add widget* and *Paste widget* options to create a widget.)  ![](../../../../../assets/en/manual/web_interface/dashboard_click.png)  ![](../../../../../assets/en/manual/web_interface/dashboard_select.png)  In the widget configuration form:  -   Select the *Type* of widget -   Enter widget parameters -   Click on *Add*  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/widget_add.png)  #### Widgets  The following widgets can be added to a dashboard:  -   [Action     log](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/action_log) -   [Clock](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/clock) -   [Data     overview](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/data_overview) -   [Discovery     status](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/discovery_status) -   [Favorite     graphs](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/favorite_graphs) -   [Favorite     maps](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/favorite_maps) -   [Geomap](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) -   [Graph](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph) -   [Graph     (classic)](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph_classic) -   [Graph     prototype](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph_prototype) -   [Host     availability](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/host_availability) -   [Item value](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value) -   [Map](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map) -   [Map navigation     tree](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map_tree) -   [Plain     text](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/plain_text) -   [Problem     hosts](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problem_hosts) -   [Problems](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems) -   [System     information](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/system) -   [Problems by     severity](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems_severity) -   [Trigger     overview](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/trigger_overview) -   [URL](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/url) -   [Web     monitoring](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/web_monitoring)  In dashboard editing mode widgets can be resized and moved around the dashboard by clicking on the widget title bar and dragging it to a new location. Also, you can click on the following buttons in the top-right corner of the widget to:  -   ![](../../../../../assets/en/manual/web_interface/widget_edit.png) -     edit a widget; -   ![](../../../../../assets/en/manual/web_interface/button_widget_menu.png) -     access the [widget menu](#widget_menu)  Click on *Save changes* for the dashboard to make any changes to the widgets permanent.  
ja	#### Adding widgets  To add a widget to a dashboard:  -   Click on the     ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_add_button.png)     button or the *Add widget* option in the action menu that can be     opened by clicking on the arrow. Fill the widget configuration form.     The widget will be created in its default size and placed after the     existing widgets (if any);  Or  -   Move your mouse to the desired empty spot for the new widget. Notice     how a placeholder appears, on mouseover, on any empty slot on the     dashboard. Then click to open the widget configuration form. After     filling the form the widget will be created in its default size or,     if its default size is bigger than is available, take up the     available space. Alternatively, you may click and drag the     placeholder to the desired widget size, then release, and then fill     the widget configuration form. (Note that when there is a widget     copied onto the clipboard, you will be first prompted to select     between *Add widget* and *Paste widget* options to create a widget.)  ![](../../../../../assets/en/manual/web_interface/dashboard_click.png)  ![](../../../../../assets/en/manual/web_interface/dashboard_select.png)  In the widget configuration form:  -   Select the *Type* of widget -   Enter widget parameters -   Click on *Add*  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/widget_add.png)  The following widgets can be added to a dashboard:  -   [Action     log](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#action_log) -   [Clock](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#clock) -   [Data     overview](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#data_overview) -   [Discovery     status](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#discovery_status) -   [Favorite     graphs](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#favorite_graphs) -   [Favorite     maps](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#favorite_maps) -   [Graph](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#graph) -   [Graph     (classic)](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#graph_classic) -   [Graph     prototype](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#graph_prototype) -   [Host     availability](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#host_availability) -   [Problem     hosts](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#problem_hosts) -   [Map](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#map) -   [Map navigation     tree](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#map_navigation_tree) -   [Plain     text](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#plain_text) -   [Problems](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#problems) -   [System     information](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#system_information) -   [Problems by     severity](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#problems_by_severity) -   [Trigger     overview](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#trigger_overview) -   [URL](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#url) -   [Web     monitoring](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#web_monitoring)  In dashboard editing mode widgets can be resized and moved around the dashboard by clicking on the widget title bar and dragging it to a new location. Also, you can click on the following buttons in the top-right corner of the widget to:  -   ![](../../../../../assets/en/manual/web_interface/widget_edit.png) -     edit a widget; -   ![](../../../../../assets/en/manual/web_interface/button_widget_menu.png) -     access the [widget menu](#widget_menu)  Click on *Save changes* for the dashboard to make any changes to the widgets permanent.  

en-us	##### Additional parameters  A third optional parameter is supported by the *bucket\_rate\_foreach* function:      bucket_rate_foreach(item filter,time period,<parameter number>)  where <parameter number> is the position of the "bucket" value in the item key. For example, if the "bucket" value in myItem\[aaa,0.2\] is '0.2', then its position is 2.  The default value of <parameter number> is '1'.
ja	##### 追加のパラメータ  3 番目のオプション パラメータは、*bucket\_rate\_foreach* 関数でサポートされています。      bucket_rate_foreach(item filter,time period,<parameter number>)  ここで<parameter number> は項目キー内の"バケット"値の位置です。 たとえばmyItem\[aaa,0.2\] の"bucket"値が'0.2'の場合、その位置は 2 です。  <parameter number> のデフォルト値は '1' です。

en-us	#### Additional ssh.run options  The **ssh.run[]** item has been updated and now allows passing additional SSH options as a part of the item key. These options are supported only using libssh of version 0.9.0 and higher or libssh2. Supported option keys and values depend on the SSH library.  See [SSH checks](/manual/config/items/itemtypes/ssh_checks) for details.
ja	#### 追加のssh.runオプション  **ssh.run[]**アイテムが更新され、アイテムキーの一部として追加のSSHオプションを渡すことができるようになりました。 これらのオプションは、バージョン0.9.0以降のlibsshまたはlibssh2を使用する場合にのみサポートされます。 サポートされるオプションのキーと値は、SSHライブラリによって異なります。 詳細については[SSHチェック](/manual/config/items/itemtypes/ssh_checks)を参照してください。

en-us	### Administration  With the Zabbix API you can change administration settings of your monitoring system.
ja	### 管理画面  Zabbix APIを使用すると、監視システムの管理設定を変更することができます。

en-us	#### Advanced configuration  Advanced configuration options become available if the *Advanced  configuration* checkbox is marked (see screenshot) and only for  those elements that are selected in the *Show* field (see above).  Additionally, advanced configuration allows to change the background  color for the whole widget.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/item_value_advanced.png)  |   |   | |--|--------| |_**Description**_ |Enter the item description. This description may override the default item name. Multiline descriptions are supported. A combination of text and supported macros is possible.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} and user macros are supported. | |*Horizontal position* |Select horizontal position of the item description - left, right or center. | |*Vertical position* |Select vertical position of the item description - top, bottom or middle. | |*Size* |Enter font size height for the item description (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display item description in bold type. | |*Color* |Select the item description color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Value**_ | | |*Decimal places* |Select how many decimal places will be displayed with the value. This value will affect only float items. | |*Size* |Enter font size height for the decimal places (in percent relative to total widget height). | |*Horizontal position* |Select horizontal position of the item value - left, right or center. | |*Vertical position* |Select vertical position of the item value - top, bottom or middle. | |*Size* |Enter font size height for the item value (in percent relative to total widget height).<br>*Note* that the size of item value is prioritised; other elements have to concede space for the value. With the change indicator though, if the value is too large, it will be truncated to show the change indicator. | |*Bold* |Mark the checkbox to display item value in bold type. | |*Color* |Select the item value color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |*Units* |Mark the checkbox to display units with the item value. If you enter a unit name, it will override the unit from item configuration. | |*Position* |Select the item unit position - above, below, before or after the value. | |*Size* |Enter font size height for the item unit (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display item unit in bold type. | |*Color* |Select the item unit color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Time**_ |Time is the clock value from item history. | |*Horizontal position* |Select horizontal position of the time - left, right or center. | |*Vertical position* |Select vertical position of the time - top, bottom or middle. | |*Size* |Enter font size height for the time (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display time in bold type. | |*Color* |Select the time color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Change indicator**_ |Select the color of change indicators from the color picker. The change indicators are as follows:<br>**↑** - item value is up (for numeric items)<br>**↓** - item value is down (for numeric items)<br>**↕** - item value has changed (for string items and items with value mapping)<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker.<br>Vertical size of the change indicator is equal to the size of the value (integer part of the value for numeric items).<br>*Note* that up and down indicators are not shown with just one value. | |_**Background color**_ |Select the background color for the whole widget from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. |  *Note* that multiple elements cannot occupy the same space; if they are placed in the same space, an error message will be displayed.
ja	#### 高度な設定  [高度な設定]チェックボックスがオンになっている場合（スクリーンショットを参照）、[表示]フィールドで選択されている要素（上記を参照）に対してのみ高度な設定オプションが使用可能になります。  さらに高度な設定によりウィジェット全体の背景色を変更できます。  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/item_value_advanced.png)  | | | |--|--------| |_**説明**_|アイテムの説明を入力します。 この説明は、デフォルトのアイテム名をオーバーライドする場合があります。 複数行の説明がサポートされています。 <br>テキストとサポートされているマクロを組み合わせることが可能です。<br>{HOST.*}、{ITEM.*}、{INVENTORY.*}、およびユーザー マクロがサポートされています。| |*水平の位置*|アイテム説明の水平位置を左、右、または中央から選択します。| |*垂直の位置*|アイテム説明の垂直位置を上、下、または中央から選択します。| |*サイズ*|アイテム説明のフォントサイズを入力します (ウィジェットの高さ全体に対するパーセントで)| |*太字*|チェックボックスをオンにすると、アイテム説明が太字で表示されます。| |*色*|カラー ピッカーからアイテム説明の色を選択します。<br>D はデフォルトの色を表します (フロントエンドのテーマによって異なります)。 デフォルト値に戻すには、カラー ピッカーの [デフォルトを使用] ボタンをクリックします。| |_**値**_|| |*小数点以下桁数*|表示する小数点以下の桁数を入力します。 この値は float アイテムにのみ影響します。| |*サイズ*|小数点以下桁数のフォントサイズを入力します (ウィジェットの高さ全体に対するパーセントで)| |*水平の位置*|アイテム値の水平位置を左、右、または中央から選択します。| |*垂直の位置*|アイテム値の垂直位置を上、下、または中央から選択します。| |*サイズ*|アイテム値のフォント サイズの高さを入力します (ウィジェットの高さ全体に対するパーセント)。<br>アイテム値のサイズが優先されることに注意してください。 他の要素は、アイテム値のためスペースを確保しなければなりません。アイテム値が大きすぎる場合、変化表示の変更インジケーターを表示するために切り捨てられます。| |*太字*|チェックボックスをオンにすると、アイテム値が太字で表示されます。| |*色*|カラー ピッカーからアイテム値の色を選択します。<br>D はデフォルトの色を表します (フロントエンドのテーマによって異なります)。 デフォルト値に戻すには、カラー ピッカーの [デフォルトを使用] ボタンをクリックします。| |*単位*|チェックボックスをオンにすると、アイテム値に単位が表示されます。 単位名を入力すると、アイテム設定の単位が上書きされます。| |*位置*|アイテム単位の位置 (値の上、下、前、または後) を選択します。| |*サイズ*|アイテム単位のフォントサイズを入力します (ウィジェットの高さ全体に対するパーセントで)| |*太字*|チェックボックスをオンにすると、アイテム単位が太字で表示されます。| |*色*|カラー ピッカーからアイテム ユニットの色を選択します。<br>D はデフォルトの色を表します (フロントエンドのテーマによって異なります)。 デフォルト値に戻すには、カラー ピッカーの [デフォルトを使用] ボタンをクリックします。| |_**時間**_|時間は、アイテム履歴からのクロック値です。| |*水平の位置*|時間の水平位置を左、右、または中央から選択します。| |*垂直の位置*|時間の垂直位置を上、下、または中央から選択します。| |*サイズ*|時間のフォントサイズを入力します (ウィジェットの高さ全体に対するパーセントで)| |*太字*|チェックボックスをマークして、時間を太字で表示します。| |*色*|カラー ピッカーから時間の色を選択します。<br>D はデフォルトの色を表します (フロントエンドのテーマによって異なります)。 デフォルト値に戻すには、カラー ピッカーの [デフォルトを使用] ボタンをクリックします。| |_**変化表示**_|カラー ピッカーから変更インジケーターの色を選択します。 変化の指標は次のとおりです。<br>↑ - アイテムの値が上昇しています (数値アイテムの場合)<br>↓ - アイテムの値が下降しています (数値アイテムの場合)<br>↕ - アイテムの値が変化しています (文字列アイテムとアイテムの場合) 値マッピングあり)<br>D はデフォルトの色を表します (フロントエンドのテーマによって異なります)。 デフォルト値に戻すには、カラー ピッカーの [デフォルトを使用] ボタンをクリックします。<br>変更インジケータの垂直方向のサイズは、値のサイズ (数値項目の値の整数部分) と同じです。<br>アップ インジケーターとダウン インジケーターは、1 つの値だけで表示されないことに注意してください。| |_**背景色**_|カラー ピッカーからウィジェット全体の背景色を選択します。<br>D はデフォルトの色を表します (フロントエンドのテーマによって異なります)。 デフォルト値に戻すには、カラー ピッカーの [デフォルトを使用] ボタンをクリックします。|  複数の要素が同じスペースを占めることはできないことに注意してください。 同じスペースに配置すると、エラーメッセージが表示されます。

en-us	 #### Advanced configuration  ![](../../../assets/en/manual/web_interface/service_a.png){width=600}  |Parameter|Description| |--|--------| |_**Additional rules**_|Click on *Add* to define additional status calculation rules.| |*Set status to*|Set service status to either *OK* (default), *Not classified*, *Information*, *Warning*, *Average*, *High* or *Disaster* in case of a condition match.| |*Condition*|Select the condition for direct child services:<br>**if at least (N) child services have (Status) status or above**<br>**if at least (N%) of child services have (Status) status or above**<br>**if less than (N) child services have (Status) status or below**<br>**if less than (N%) of child services have (Status) status or below**<br>**if weight of child services with (Status) status or above is at least (W)**<br>**if weight of child services with (Status) status or above is at least (N%)**<br>**if weight of child services with (Status) status or below is less than (W)**<br>**if weight of child services with (Status) status or below is less than (N%)** <br><br> If several conditions are specified and the situation matches more than one condition, the highest severity will be set.| |*N (W)*|Set the value of N or W (1-100000), or N% (1-100) in the condition.| |*Status*|Select the value of *Status* in the condition: *OK* (default), *Not classified*, *Information*, *Warning*, *Average*, *High* or *Disaster*.| |_**Status propagation rule**_|Rule for propagating the service status to the parent service:<br>**As is** - the status is propagated without change<br>**Increase by** - you may increase the propagated status by 1 to 5 severities<br>**Decrease by** - you may decrease the propagated status by 1 to 5 severities<br>**Ignore this service** - the status is not propagated to the parent service at all<br>**Fixed status** - the status is propagated statically, i.e. as always the same| |_**Weight**_|Weight of the service (integer in the range from 0 (default) to 1000000).|  :::noteclassic Additional status calculation rules can only be used to increase severity level over the level calculated according to the main *Status calculation rule* parameter. If according to additional rules the status should be Warning, but according to the *Status calculation rule* the status is Disaster - the service will have status Disaster.  :::
ja	#### 詳細設定  ![](../../../assets/en/manual/web_interface/service_a.png){width=600}  |パラメータ|説明| |--|--------| |_**Additional rules**_|追加のステータス計算ルールを定義するには*Add*をクリックします。| |*Set status to*|条件が一致する場合は、サービスステータスを*OK*（default）、*未分類*、*情報*、*警告*、*軽度の障害*、*重度の障害*、*致命的な障害*のいずれかに設定します。| |*Condition*|直接の子サービスの条件を選択します。<br>**少なくとも (N) 個の子サービスが (Status) ステータス以上の場合**<br>** 少なくとも (N%) の子サービスが (Status) ステータス以上の場合**<br>**(N) 個未満の子サービスが (Status) ステータス以下の場合**<br>**(ステータス) 以下の子サービスが (N%) 未満の場合**<br>**(Status) ステータス以上の子サービスの重みが (W) 以上の場合**<br>** (Status) ステータス以上の子サービスの重みが (N%) 以上の場合* *<br>**(Status) ステータス以下の子サービスの重みが (W) 未満の場合**<br>**(Status) ステータス以下の子サービスの重みが (N%) 未満の場合**<br><br> 複数の条件が指定され、状況が複数の条件に一致する場合、最も高い重大度が設定されます。| |*N (W)*|条件でNまたはW（1-100000）、またはN％（1-100）の値を設定します。| |*Status*|条件となる*ステータス*の値を選択します：*OK*（default）、*未分類*、*情報*、*警告*、*軽度の障害*、*重度の障害*、*致命的な障害*| |_**Status propagation rule**_|サービスステータスを親サービスに伝達するためのルール:<br>**現状のまま** - ステータスは変更されずに伝達されます。<br>**増加** - 伝播されたステータスの深刻度を 1 ～ 5 増加させて伝達されます<br>**減少** - 伝播されたステータスの深刻度を 1 ～ 5 現象させて伝達されます<br>**このサービスを無視** - ステータスは親サービスにまったく伝達されません<br>**固定ステータス** - ステータスは静的に伝達されます。つまり、常に同じステータスです。| |_**Weight**_|サービスの重み（0（デフォルト）から1000000の範囲の整数）|  :::noteclassic 追加のステータス計算ルールは、メインの*Status calculation rule*パラメーターに従って計算されたレベルよりも重大度レベルを上げるためにのみ使用できます。Additional rulesでは警告だが、*Status calculation rule*では致命的な障害である場合、サービスのステータスは致命的な障害になります。 :::

en-us	##### Advanced settings  Additional SAML parameters can be configured in the Zabbix frontend configuration file (*zabbix.conf.php*):  -   $SSO\['SP\_KEY'\] = '<path to the SP private key file>'; -   $SSO\['SP\_CERT'\] = '<path to the SP cert file>'; -   $SSO\['IDP\_CERT'\] = '<path to the IDP cert file>'; -   $SSO\['SETTINGS'\]  ::: noteclassic  Zabbix uses [OneLogin's SAML PHP Toolkit](https://github.com/onelogin/php-saml/tree/3.4.1) library (version 3.4.1). The structure of $SSO\['SETTINGS'\] section should be similar to the structure used by the library. For the description of configuration options, see official library [documentation](https://github.com/onelogin/php-saml/tree/3.4.1/#user-content-settings).  :::  Only the following options can be set as part of $SSO\['SETTINGS'\]:  -   *strict* -   *baseurl* -   *compress* -   *contactPerson* -   *organization* -   *sp* (only options specified in this list)     -   *attributeConsumingService*     -   *x509certNew* -   *idp* (only options specified in this list)     -   *singleLogoutService* (only one option)         -   *responseUrl*     -   *certFingerprint*     -   *certFingerprintAlgorithm*     -   *x509certMulti* -   *security* (only options specified in this list)     -   *signMetadata*     -   *wantNameId*     -   *requestedAuthnContext*     -   *requestedAuthnContextComparison*     -   *wantXMLValidation*     -   *relaxDestinationValidation*     -   *destinationStrictlyMatches*     -   *rejectUnsolicitedResponsesWithInResponseTo*     -   *signatureAlgorithm*     -   *digestAlgorithm*     -   *lowercaseUrlencoding*  All other options will be taken from the database and cannot be overridden. The *debug* option will be ignored.  In addition, if Zabbix UI is behind a proxy or a load balancer, the custom *use\_proxy\_headers* option can be used:  -   *false* (default) - ignore the option; -   *true* - use X-Forwarded-\* HTTP headers for building the base URL.    If using a load balancer to connect to Zabbix instance, where the load balancer uses TLS/SSL and Zabbix does not, you must indicate 'baseurl', 'strict' and 'use_proxy_headers' parameters as follows:      $SSO['SETTINGS']=['strict' => false, 'baseurl' => "https://zabbix.example.com/zabbix/", 'use_proxy_headers' => true]   **Configuration example:**      $SSO['SETTINGS'] = [         'security' => [             'signatureAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#rsa-sha384'             'digestAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#sha384',             // ...         ],         // ...     ];
ja	##### 高度な設定  追加のSAMLパラメーターは、Zabbixフロントエンド設定ファイル(*zabbix.conf.php*)で設定できます。 Additional SAML parameters can be configured in the Zabbix frontend configuration file (*zabbix.conf.php*):  -   $SSO\['SP\_KEY'\] = '<SP 秘密鍵ファイルへのパス>'; -   $SSO\['SP\_CERT'\] = '<SP 証明書ファイルへのパス>'; -   $SSO\['IDP\_CERT'\] = '<IDP 証明書ファイルへのパス>'; -   $SSO\['SETTINGS'\]  ::: noteclassic  Zabbixは[OneLoginのSAMLPHPToolkit](https://github.com/onelogin/php-saml/tree/3.4.1)ライブラリ(バージョン3.4.1)を使用します。$SSO\['SETTINGS'\] セクションの構造は、ライブラリで使用される構造と同様である必要があります。設定オプションの説明については、公式ライブラリ[ドキュメント](https://github.com/onelogin/php-saml/tree/3.4.1/#user-content-settings)を参照してください。 :::  $SSO\['SETTINGS'\]の一部として設定できるのは、次のオプションです。  -   *strict* -   *baseurl* -   *compress* -   *contactPerson* -   *organization* -   *sp* (only options specified in this list)     -   *attributeConsumingService*     -   *x509certNew* -   *idp* (only options specified in this list)     -   *singleLogoutService* (only one option)         -   *responseUrl*     -   *certFingerprint*     -   *certFingerprintAlgorithm*     -   *x509certMulti* -   *security* (only options specified in this list)     -   *signMetadata*     -   *wantNameId*     -   *requestedAuthnContext*     -   *requestedAuthnContextComparison*     -   *wantXMLValidation*     -   *relaxDestinationValidation*     -   *destinationStrictlyMatches*     -   *rejectUnsolicitedResponsesWithInResponseTo*     -   *signatureAlgorithm*     -   *digestAlgorithm*     -   *lowercaseUrlencoding*  他のすべてのオプションはデータベースから取得され、オーバーライドすることはできません。 *debug*オプションは無視されます。  さらに、Zabbix UIがプロキシまたはロードバランサーの背後にある場合は、カスタムの*use\_proxy\_headers*オプションを使用できます。  -   *false* (default) - オプションを無効に; -   *true* - use X-Forwarded-\* ベースURLを構築するためのHTTPヘッダー.  ロードバランサーを使用してZabbixインスタンスに接続する場合に、ロードバランサーはTLS/SSLを使用し、Zabbixは使用しない場合は、次のように「baseurl」「strict」および「use_proxy_headers」パラメーターを指定する必要があります。        $SSO['SETTINGS']=['strict' => false, 'baseurl' => "https://zabbix.example.com/zabbix/", 'use_proxy_headers' => true]   **設定例**      $SSO['SETTINGS'] = [         'security' => [             'signatureAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#rsa-sha384'             'digestAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#sha384',             // ...         ],         // ...     ];

en-us	After receiving a list of active checks the agent marks obsolete persistent files for removal. A persistent file becomes obsolete if: 1) the corresponding log item is no longer monitored, 2) a log item is reconfigured with a different **persistent\_dir** location than before.  Removing is done with delay 24 hours because log files in NOTSUPPORTED state are not included in the list of active checks but they may become SUPPORTED later and their persistent files will be useful.  If the agent is stopped before 24 hours expire, then the obsolete files will not be deleted as Zabbix agent is not getting info about their location from Zabbix server anymore.  ::: notewarning Reconfiguring a log item's **persistent\_dir** back to the old **persistent\_dir** location while the agent is stopped, without deleting the old persistent file by user - will cause restoring the agent state from the old persistent file resulting in missed messages or false alerts. :::
ja	アクティブなチェックのリストを受け取った後、agent は廃止された永続ファイルを削除するようマークします。<br> 以下の場合、永続ファイルは廃止されます。<br> 1) 対応するログ項目が監視されなくなった、<br> 2) ログ項目が以前と異なる **persistent_dir** 位置で再設定された。  NOTSUPPORTED状態のログファイルはアクティブチェックのリストに含まれませんが、後にSUPPORTEDになる可能性があり、<br> その永続ファイルが有用であるため、24時間遅れで削除されます。  24時間経過前に agent を停止した場合、Zabbix agent はZabbix server からファイルの所在情報を取得しなくなるため、<br> 古くなったファイルは削除されません。  ::: notewarning agent が停止している間に、ユーザが古い永続ファイルを削除せずに、ログアイテムの **persistent_dir** を 古い **persistent_dir** の場所に再構成すると、古い永続ファイルからエージェント状態をリストアすることになり、 メッセージの見逃しや誤った警告が発生します。 :::

en-us	 #### Agent 2 plugins  ##### MySQL  The correct master host is now returned if specified in the `mysql.replication.get_slave_status[]`  [item](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mysql) "masterHost" parameter.  Previously the "masterHost" parameter was ignored and always the first master host was returned.  If this parameter is not specified, all hosts are returned. 
ja	 #### Zabbixエージェント2のプラグイン  ##### MySQL  `mysql.replication.get_slave_status[]`[アイテム](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mysql)の"masterHost"パラメータで指定されている場合、正しいマスターホストが返されるようになりました。以前は、"masterHost"パラメータは無視され、常に最初のマスターホストが返されていました。  このパラメータが指定されていない場合は、すべてのホストが返されます。

en-us	##### Agent 2  |Requirement|Mandatory status|Description| |--|-|-------| |*libpcre/libpcre2*|One of|PCRE/PCRE2 library is required for [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) support.<br>The naming may differ depending on the GNU/Linux distribution, for example 'libpcre3' or 'libpcre1'. PCRE v8.x and PCRE2 v10.x (from Zabbix 6.0.0) are supported.<br>Required for log monitoring. Also required on Windows.| |*libopenssl*|No|Required when using encryption.<br>OpenSSL 1.0.1 or later is required on UNIX platforms.<br>The OpenSSL library must have PSK support enabled. LibreSSL is not supported.<br>On Microsoft Windows systems OpenSSL 1.1.1 or later is required.|  **Go libraries**  |Requirement|Mandatory status|Minimum version|Description| |--|-|-|-------| |[git.zabbix.com/ap/plugin-support](https://git.zabbix.com/projects/AP/repos/plugin-support/browse?at=refs%2Fheads%2Frelease%2F6.0)|Yes|1.X.X|Zabbix own support library. Mostly for plugins. | |[github.com/BurntSushi/locker](https://github.com/BurntSushi/locker)|^|0.0.0|Named read/write locks, access sync. | |[github.com/chromedp/cdproto](https://github.com/chromedp/cdproto)|^|0.0.0|Generated commands, types, and events for the Chrome DevTools Protocol domains. | |[github.com/chromedp/chromedp](https://github.com/chromedp/chromedp)|^|0.6.0|Chrome DevTools Protocol support (report generation). | |[github.com/dustin/gomemcached](https://github.com/dustin/gomemcached)|^|0.0.0|A memcached binary protocol toolkit for go. | |[github.com/eclipse/paho.mqtt.golang](https://github.com/eclipse/paho.mqtt.golang)|^|1.2.0|A library to handle MQTT connections. | |[github.com/fsnotify/fsnotify](https://github.com/fsnotify/fsnotify)|^|1.4.9|Cross-platform file system notifications for Go. | |[github.com/go-ldap/ldap](https://github.com/go-ldap/ldap)|^|3.0.3|Basic LDAP v3 functionality for the Go programming language. | |[github.com/go-ole/go-ole](https://github.com/go-ole/go-ole)|^|1.2.4|Win32 ole implementation for Go. | |[github.com/godbus/dbus](https://github.com/godbus/dbus)|^|4.1.0|Native Go bindings for D-Bus. | |[github.com/go-sql-driver/mysql](https://github.com/go-sql-driver/mysql)|^|1.5.0|MySQL driver. | |[github.com/godror/godror](https://github.com/godror/godror)|^|0.20.1|Oracle DB driver. | |[github.com/mattn/go-sqlite3](https://github.com/mattn/go-sqlite3)|^|2.0.3|Sqlite3 driver. | |[github.com/mediocregopher/radix/v3](https://github.com/mediocregopher/radix)|^|3.5.0|Redis client. | |[github.com/memcachier/mc/v3](https://github.com/memcachier/mc)|^|3.0.1|Binary Memcached client. | |[github.com/miekg/dns](https://github.com/miekg/dns)|^|1.1.43|DNS library. | |[github.com/omeid/go-yarn](https://github.com/omeid/go-yarn)|^|0.0.1|Embeddable filesystem mapped key-string store. | |[github.com/goburrow/modbus](https://github.com/goburrow/modbus)|^|0.1.0|Fault-tolerant implementation of Modbus. | |[golang.org/x/sys](https://pkg.go.dev/golang.org/x/sys)|^|0.0.0|Go packages for low-level interactions with the operating system.<br>Also used in plugin support lib. Used in MongoDB and PostgreSQL plugins. | |[github.com/Microsoft/go-winio](https://github.com/microsoft/go-winio)|On Windows.<br>Yes, indirect^**1**^|0.6.0|Windows named pipe implementation.<br>Also used in plugin support lib. Used in MongoDB and PostgreSQL plugins. | |[github.com/goburrow/serial](https://github.com/goburrow/serial)|Yes, indirect^**1**^|0.1.0|Serial library for Modbus. | |[golang.org/x/xerrors](https://pkg.go.dev/golang.org/x/xerrors)|^|0.0.0|Functions to manipulate errors. | |[gopkg.in/asn1-ber.v1](https://gopkg.in/asn1-ber.v1)|^|1.0.0|Encoding/decoding library for ASN1 BER. | |[github.com/go-stack/stack](https://github.com/go-stack/stack)|No, indirect^**1**^|1.8.0| | |[github.com/golang/snappy](https://github.com/golang/snappy)|^|0.0.1| | |[github.com/klauspost/compress](https://github.com/klauspost/compress)|^|1.13.6| | |[github.com/xdg-go/pbkdf2](https://github.com/xdg-go/pbkdf2)|^|1.0.0| | |[github.com/xdg-go/scram](https://github.com/xdg-go/scram)|^|1.0.2| | |[github.com/xdg-go/stringprep](https://github.com/xdg-go/stringprep)|^|1.0.2| | |[github.com/youmark/pkcs8](https://github.com/youmark/pkcs8)|^|0.0.0| |  ^**1**^ "Indirect" means that it is used in one of the libraries that the agent uses. It's required since Zabbix uses the library that uses the package.  See also dependencies for loadable plugins:  -   [PostgreSQL](/manual/installation/requirements/plugins/postgresql) -   [MongoDB](/manual/installation/requirements/plugins/mongodb)
ja	##### エージェント 2  |要件|必須ステータス|説明| |--|-|-------| |*libpcre/libpcre2*|どちらか一つ|[Perl 互換正規表現](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) のサポートには PCRE/PCRE2ライブラリが必要です。<br>名前は'libpcre3'または'libpcre1'など、GNU/Linux ディストリビューションによって異なる場合があります。PCRE v8.x および PCRE2 v10.x (Zabbix 6.0.0 以降) がサポートされています。<br>ログ監視に必要です。Windowsでも必要です。| |*libopenssl*|No|暗号化を使用する場合に必要です。<br>UNIX プラットフォームでは OpenSSL 1.0.1以降が必要です。<br>OpenSSLライブラリではPSK サポートが有効になっている必要があります。LibreSSLはサポートされていません。<br>Microsoft Windowsシステムでは、OpenSSL 1.1.1 以降が必要です。|  **Golang ライブラリ**  |要件|必須ステータス|最小バージョン|説明| |--|-|-|-------| |[git.zabbix.com/ap/plugin-support](https://git.zabbix.com/projects/AP/repos/plugin-support/browse?at=refs%2Fheads%2Frelease%2F6.0)|Yes|1.X.X|Zabbix独自のサポートライブラリ。 主にプラグイン用です。| |[github.com/BurntSushi/locker](https://github.com/BurntSushi/locker)|^|0.0.0|名前付き読み取り/書き込みロック、アクセス同期。| |[github.com/chromedp/cdproto](https://github.com/chromedp/cdproto)|^|0.0.0|Chrome DevToolsプロトコルドメイン用に生成されたコマンド、タイプ、およびイベント。| |[github.com/chromedp/chromedp](https://github.com/chromedp/chromedp)|^|0.6.0|Chrome DevToolsプロトコルのサポート (レポート生成)。| |[github.com/dustin/gomemcached](https://github.com/dustin/gomemcached)|^|0.0.0|go用のmemcachedバイナリプロトコルツールキット。| |[github.com/eclipse/paho.mqtt.golang](https://github.com/eclipse/paho.mqtt.golang)|^|1.2.0|MQTT接続を処理するためのライブラリ。| |[github.com/fsnotify/fsnotify](https://github.com/fsnotify/fsnotify)|^|1.4.9|Goのクロスプラットフォームファイルシステム通知。| |[github.com/go-ldap/ldap](https://github.com/go-ldap/ldap)|^|3.0.3|GOプログラミング言語の基本的なLDAP v3機能。| |[github.com/go-ole/go-ole](https://github.com/go-ole/go-ole)|^|1.2.4|Golang の Win32 ole 実装。| |[github.com/godbus/dbus](https://github.com/godbus/dbus)|^|4.1.0|D-Bus のネイティブ Go バインディング。| |[github.com/go-sql-driver/mysql](https://github.com/go-sql-driver/mysql)|^|1.5.0|MySQLドライバ。| |[github.com/godror/godror](https://github.com/godror/godror)|^|0.20.1|Oracle DB ドライバ。| |[github.com/mattn/go-sqlite3](https://github.com/mattn/go-sqlite3)|^|2.0.3|Sqlite3 ドライバ 。| |[github.com/mediocregopher/radix/v3](https://github.com/mediocregopher/radix/v3)|^|3.5.0|Redisクライアント。| |[github.com/memcachier/mc/v3](https://github.com/memcachier/mc/v3)|^|3.0.1|バイナリ Memcached クライアント。| |[github.com/miekg/dns](https://github.com/miekg/dns)|^|1.1.43|DNS ライブラリ。| |[github.com/omeid/go-yarn](https://github.com/omeid/go-yarn)|^|0.0.1|埋め込み可能なファイルシステムにマッピングされたキー文字列ストア。| |[github.com/goburrow/modbus](https://github.com/goburrow/modbus)|^|0.1.0|Modbus のフォールト トレラントな実装。| |[golang.org/x/sys](https://golang.org/x/sys)|^|0.0.0|オペレーティング システムとの低レベルの対話用の Go パッケージ。<br>プラグインサポートライブラリでも使用されます。 MongoDBとPostgreSQLプラグインで使用されます。| |[github.com/Microsoft/go-winio](https://github.com/microsoft/go-winio)|On Windows.<br>Yes, indirect^**1**^|0.6.0|Windows の名前付きパイプの実装。<br>プラグインサポートライブラリでも使用されます。MongoDBとPostgreSQLプラグインで使用されます。| |[github.com/goburrow/serial](https://github.com/goburrow/serial)|Yes, indirect^**1**^|0.1.0|Modbus 用のシリアルライブラリ。| |[golang.org/x/xerrors](https://pkg.go.dev/golang.org/x/xerrors)|^|0.0.0|エラーを操作する関数。| |[gopkg.in/asn1-ber.v1](https://gopkg.in/asn1-ber.v1)|^|1.0.0|ASN1 BER のエンコード/デコード ライブラリ。| |[github.com/go-stack/stack](https://github.com/go-stack/stack)|No, indirect^**1**^|1.8.0|| |[github.com/golang/snappy](https://github.com/golang/snappy)|^|0.0.1|| |[github.com/klauspost/compress](https://github.com/klauspost/compress)|^|1.13.6|| |[github.com/xdg-go/pbkdf2](https://github.com/xdg-go/pbkdf2)|^|1.0.0|| |[github.com/xdg-go/scram](https://github.com/xdg-go/scram)|^|1.0.2|| |[github.com/xdg-go/stringprep](https://github.com/xdg-go/stringprep)|^|1.0.2|| |[github.com/youmark/pkcs8](https://github.com/youmark/pkcs8)|^|0.0.0||  ^**1**^ "indirect"は、エージェントが使用するライブラリの 1 つで使用されることを意味します。 Zabbixはパッケージを使用するライブラリを使用するため必要です。  ロード可能なプラグインの依存関係も参照してください:  - [PostgreSQL](/manual/installation/requirements/plugins/postgresql) - [MongoDB](/manual/installation/requirements/plugins/mongodb)

en-us	##### Agent configuration  HA cluster nodes (servers) must be listed in the configuration of  Zabbix agent or Zabbix agent 2.  ![](../../../../assets/en/manual/config/zabbix_ha_agent.png)  To enable passive checks, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_agentd), separated by a **comma**.  ``` Server=zabbix-node-01,zabbix-node-02 ```  To enable active checks, the node names must be listed in the ServerActive [parameter](/manual/appendix/config/zabbix_agentd). Note that for  active checks the nodes must be separated by a comma from any other  servers, while the nodes themselves must be separated by a **semicolon**, e.g.:  ``` ServerActive=zabbix-node-01;zabbix-node-02 ```
ja	##### Zabbixエージェントの設定  HAクラスターのノード(サーバー)は、ZabbixエージェントまたはZabbixエージェント2の設定ファイルに並べて記述することが必要です。  ![](../../../../assets/en/manual/config/zabbix_ha_agent.png)  パッシブチェックを行うのならば、ノード名を[Serverパラメーター](/manual/appendix/config/zabbix_agentd)に **カンマ** 区切りで設定する必要があります。  ``` Server=zabbix-node-01,zabbix-node-02 ```  アクティブチェックを行うのならば、ノード名を[ServerActiveパラメーター](/manual/appendix/config/zabbix_agentd)に **セミコロン** 区切りで設定する必要があります。例：  ``` ServerActive=zabbix-node-01;zabbix-node-02 ```

en-us	 ### Agent data request  The agent data request contains the gathered item values.  | Field |<| Type | Mandatory | Value | |-|------|--|-|-----------------------| | request |<| _string_ | yes | `agent data` | | host |<| _string_ | yes | Host name. | | version |<| _string_ | yes | The agent version: \<major>.\<minor>. | | session |<| _string_ | yes | Unique session identifier generated each time when agent is started. | | data |<| _array of objects_ | yes | Item values. | | | id | _number_ | yes | The value identifier (incremental counter used for checking duplicated values in the case of network problems). | |^| itemid | _number_ | yes | Item identifier. | |^| value | _string_ | no | The item value. | |^| lastlogsize | _number_ | no | The item lastlogsize. | |^| mtime | _number_ | no | The item mtime. | |^| state | _number_ | no | The item state. | |^| source | _string_ | no | The value event log source. | |^| eventid | _number_ | no | The value event log eventid. | |^| severity | _number_ | no | The value event log severity. | |^| timestamp | _number_ | no | The value event log timestamp. | |^| clock | _number_ | yes | The value timestamp (seconds since Epoch). | |^| ns | _number_ | yes | The value timestamp nanoseconds. |  Example: ```json {   "request": "agent data",   "data": [     {       "id": 1,       "itemid": 5678,       "value": "2.4.0",       "clock": 1400675595,       "ns": 76808644     },     {       "id": 2,       "itemid": 1234,       "lastlogsize": 112,       "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).",       "clock": 1400675595,       "ns": 77053975     }   ],   "host": "Zabbix server",   "version": "6.0",   "session": "1234456akdsjhfoui" } ```
ja	### エージェントデータリクエスト  エージェントデータリクエストには、収集されたアイテムの値が含まれます。  | フィールド |<| タイプ | 必須 | 値 | |-|------|--|-|-----------------------| | request |<| _string_ | はい | `agent data` | | host |<| _string_ | はい | ホスト名 | | version |<| _string_ | はい | エージェントバージョン: \<メジャー>.\<マイナー>. | | session |<| _string_ | はい | エージェントが開始されるたびに生成される固有のセッション ID | | data |<| _array of objects_ | はい | アイテムデータオブジェクト | | | id | _number_ | はい | 値の識別子 (ネットワークの問題が発生した場合に、重複した値をチェックするために使用されるインクリメントカウンター) | |^| itemid | _number_ | はい | アイテムID | |^| value | _string_ | いいえ | アイテム値| |^| lastlogsize | _number_ | いいえ | アイテムの最終ログ サイズ  | |^| mtime | _number_ | いいえ | アイテム修正日時 | |^| state | _number_ | いいえ | アイテムステータス | |^| source | _string_ | いいえ | イベント ログ ソース| |^| eventid | _number_ | いいえ | イベント ログ イベント ID | |^| severity | _number_ | いいえ | イベント ログの深刻度 | |^| timestamp | _number_ | いいえ | イベント ログのタイムスタンプ | |^| clock | _number_ | はい | タイムスタンプ (エポックからの秒数) | |^| ns | _number_ | はい | タイムスタンプ  ナノ秒 |  例: ```json {   "request": "agent data",   "data": [     {       "id": 1,       "itemid": 5678,       "value": "2.4.0",       "clock": 1400675595,       "ns": 76808644     },     {       "id": 2,       "itemid": 1234,       "lastlogsize": 112,       "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).",       "clock": 1400675595,       "ns": 77053975     }   ],   "host": "Zabbix server",   "version": "6.0",   "session": "1234456akdsjhfoui" } ```

en-us	 ### Agent data response  The agent data response is sent by the server back to agent after processing the agent data request.  | Field | Type | Mandatory | Value | |-|-|-|--------| | response | _string_ | yes | `success` \| `failed` | | info | _string_ | yes | Item processing results. |  Example: ```json {   "response": "success",   "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534" } ```
ja	### エージェントデータレスポンス  エージェントデータレスポンス、エージェントデータリクエストを処理した後、サーバーによってエージェントに送り返されます。 | フィールド | タイプ | 必須 | 値 | |-|-|-|--------| | response | _string_ | はい | `success` または `failed` | | info | _string_ | はい | アイテム処理結果 |  例: ```json {   "response": "success",   "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534" } ```

en-us	#### Agent items  Several **new** items have been added to Zabbix agent/agent 2:  -   **agent.hostmetadata** - return host metadata -   **kernel.openfiles** - return the number of open file descriptors -   **net.tcp.socket.count\[\]** - return the number of TCP sockets that     match parameters -   **net.udp.socket.count\[\]** - return the number of UDP sockets that     match parameters -   **vfs.dir.get\[\]** - return list of directory files as JSON -   **vfs.file.get\[\]** - return information about a file as JSON -   **vfs.file.owner\[\]** - return the ownership of a file -   **vfs.file.permissions\[\]** - return a 4-digit string containing     octal number with Unix permissions  Additionally:  -   **vfs.file.cksum\[\]** now supports a second `mode` parameter     (*crc32*, *md5*, *sha256*) -   **vfs.file.size\[\]** now supports a second `mode` parameter     (*bytes* or *lines*) -   **vfs.fs.discovery** and **vfs.fs.get** now return an {\#FSLABEL}     macro on Windows (with volume names)  For more details see [agent items](/manual/config/items/itemtypes/zabbix_agent).
ja	#### 新しいエージェントのアイテム  Zabbixエージェント/エージェント2にいくつかの新しいアイテムが追加されました。  -   **agent.hostmetadata** - ホストのメタデータを返却 -   **kernel.openfiles** - オープンしているファイルディスクリプタの数を返す -   **net.tcp.socket.count\[\]** - パラメーターに合致したTCPソケットの数を返す -   **net.udp.socket.count\[\]** - パラメーターに合致したUDPソケットの数を返す -   **vfs.dir.get\[\]** - ディレクトリにあるファイルのリストをJSONで返す -   **vfs.file.get\[\]** - ファイルに関する情報をJSONで返す -   **vfs.file.owner\[\]** - ファイルの所有者を返す -   **vfs.file.permissions\[\]** - ファイルのUNIXパーミッションを8進4桁数字文字列で返す  さらに:  -   **vfs.file.cksum\[\]** 第2パラメータの`mode`で(*crc32*, *md5*, *sha256*)をサポート -   **vfs.file.size\[\]** 第2パラメータの`mode`で (*bytes* or *lines*)をサポート -   **vfs.fs.discovery** と **vfs.fs.get** がWindows上で{\#FSLABEL}を（ボリューム名と一緒に）返す  詳細については、[Zabbixエージェントのアイテム](/manual/config/items/itemtypes/zabbix_agent)を参照してください。

en-us	#### Agent on UNIX-like systems  Zabbix agent on UNIX-like systems is run on the host being monitored.
ja	#### UNIX系OS上のZabbixエージェント  UNIX系OS上のZabbixエージェントは、監視対象のホストで実行されます。

en-us	#### Agent on Windows systems  Zabbix agent on Windows runs as a Windows service.
ja	#### Windows上でのZabbixエージェント  Windows上のZabbixエージェントは、Windows上のサービスとして実行されます。

en-us	##### Agent operation with persistent file  On startup Zabbix agent knows nothing about persistent files. Only after receiving a list of active checks from Zabbix server \(proxy\) the agent sees that some log items should be backed by persistent files under specified directories.  During agent operation the persistent files are opened for writing (with fopen(filename, "w")) and overwritten with the latest data.  The chance of losing persistent file data if the overwriting and file system mirror split happen at the same time is very small, no special handling for it.  Writing into persistent file is NOT followed by enforced synchronization to storage media \(fsync\(\) is not called\).  Overwriting with the latest data is done after successful reporting of matching log file record or metadata \(processed log size and modification time\) to Zabbix server. That may happen as often as every item check if log file keeps changing.  No special actions during agent shutdown.
ja	##### 永続ファイルを使用した agent 操作  起動時、Zabbix agent は永続化ファイルについて何も知りません。Zabbixサーバからアクティブチェックのリストを受け取った後、<br> agent はいくつかのログアイテムが指定されたディレクトリの永続ファイルでバックアップされることを認識します。  agent 操作の間、永続ファイルは書き込みのために開かれ (fopen(filename, "w")) 、最新のデータで上書きされます。 <br> 上書きとファイルシステムのミラーリングが同時に起こった場合、永続ファイルのデータが失われる可能性は非常に低いので、<br> 特別な処理は行いません。 永続ファイルへの書き込みの後にメディアへの強制同期を行わない\(fsync\(\) is not called\)は呼び出されない)ため、<br> 永続ファイルへの書き込みの後にメディアへの強制同期を行うことはできません。<br>  最新データの上書きは、一致するログファイルのレコードまたはメタデータ(処理されたログのサイズと更新時間)が Zabbix server に正常に報告された後に行われます。ログファイルが変化し続ける場合、item チェックのたびに行われる可能性があります。  agent シャットダウン中の特別な動作はありません。

en-us	#### Agent process types  -   `active checks` - process for performing active checks -   `collector` - process for data collection -   `listener` - process for listening to passive checks  The agent log file can be used to observe these process types.
ja	#### エージェント プロセスタイプ  - `active checks` - アクティブチェックを実行するためのプロセス - `collector` - データ収集のプロセス - `listener` - パッシブチェックを受け付けるプロセス  エージェント ログファイルを利用して、これらのプロセスタイプを観察できます。

en-us	##### Agent  |Requirement|Mandatory status|Description| |--|-|-------| |*libpcre/libpcre2*|One of|PCRE/PCRE2 library is required for [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) support.<br>The naming may differ depending on the GNU/Linux distribution, for example 'libpcre3' or 'libpcre1'. PCRE v8.x and PCRE2 v10.x (from Zabbix 6.0.0) are supported.<br>Required for log monitoring. Also required on Windows.| |*libpthread*|Yes|Required for mutex and read-write lock support (could be part of libc). Not required on Windows.| |*libresolv*|^|Required for DNS resolution (could be part of libc). Not required on Windows.| |*libiconv*|^|Required for text encoding/format conversion to UTF-8 in log items, file content, file regex and regmatch items (could be part of libc). Not required on Windows.| |*libgnutls* or *libopenssl*|No|Required if using [encryption](/manual/encryption#compiling_zabbix_with_encryption_support).<br>Minimum versions: *libgnutls* - 3.1.18, *libopenssl* - 1.0.1<br>On Microsoft Windows OpenSSL 1.1.1 or later is required.| |*libldap*|^|Required if LDAP is used. Not supported on Windows.| |*libcurl*|^|Required for `web.page.*` Zabbix agent [items](/manual/config/items/itemtypes/zabbix_agent). Not supported on Windows.<br>Version 7.28.0 or higher is recommended.| |*libmodbus*|^|Only required if Modbus monitoring is used.<br>Version 3.0 or higher.|  ::: noteclassic  Starting from version 5.0.3, Zabbix agent will not work on AIX platforms below versions 6.1 TL07 / AIX 7.1 TL01.  :::
ja	##### エージェント  |要件|必須ステータス|説明| |--|-|-------| |*libpcre/libpcre2*|どれか一つ|[Perl 互換正規表現](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions)(PCRE)のサポートには、PCRE/PCRE2ライブラリが必要です。<br>'libpcre3'や'libpcre1'など、GNU/Linuxディストリビューションによって名前が異なる場合があります。PCRE v8.x および PCRE2 v10.x (Zabbix 6.0.0 以降) がサポートされています。<br>ログの監視に必要です。Windowsでも必要です。| |*libpthread*|Yes|ミューテックスおよび読み書きロックのサポートに必要です (libc の一部である可能性があります)。 Windowsでは不要です。| |*libresolv*|^|DNS 解決に必要です (libc の一部である可能性があります)。 Windowsでは不要です。| |*libiconv*|^|ログ アイテム、ファイル コンテンツ、ファイル regex および regmatch アイテム (libc の一部である可能性があります) での UTF-8 へのテキストエンコーディング/フォーマット変換に必要です。 Windows では不要です。| |*libgnutls* or *libopenssl*|No|[暗号化](/manual/encryption#compiling_zabbix_with_encryption_support) を使用する場合に必要です。<br>最小バージョン: *libgnutls* - 3.1.18、*libopenssl* - 1.0.1<br>Microsoft Windowsでは OpenSSL 1.1.1 以降が必要です。| |*libldap*|^|LDAPを使用する場合は必須です。Windowsではサポートされていません。| |*libcurl*|^|`web.page.*という`Zabbixエージェントの[アイテム](/manual/config/items/itemtypes/zabbix_agent)に必要です。Windowsではサポートされていません。<br>バージョン7.28.0以降を推奨します。| |*libmodbus*|^|Modbusモニタリングを使用する場合にのみ必要です。<br>バージョン3.0以降。|  ::: noteclassic バージョン5.0.3以降のZabbixエージェントは、バージョン 6.1 TL07 / AIX 7.1 TL01 より前のAIXプラットフォームでは動作しません。 :::

en-us	#### Agent upgrade process  ::: noteimportant Upgrading agents is not mandatory. You only need to upgrade agents if it is required to access the new functionality. :::  The upgrade procedure described in this section may be used for upgrading both the Zabbix agent and the Zabbix agent 2.
ja	#### エージェントのアップグレードプロセス  ::: noteimportant エージェントのアップグレードは必須ではありません。新しい機能にアクセスする必要がある場合にのみ、エージェントをアップグレードする必要があります。 :::  このセクションで説明するアップグレード手順は、ZabbixエージェントとZabbixエージェント2の両方をアップグレードするために使用できます。

en-us	##### Agent  Zabbix agents are deployed on monitoring targets to actively monitor local resources and applications and report the gathered data to Zabbix server. Since Zabbix 4.4, there are two types of agents available: the [Zabbix agent](/manual/concepts/agent) (lightweight, supported on many platforms, written in C) and the [Zabbix agent 2](/manual/concepts/agent2) (extra-flexible, easily extendable with plugins, written in Go).
ja	##### エージェント  Zabbixエージェントは、監視対象上にインストールされ、ローカルリソースやアプリケーションを能動的に監視し、収集したデータをZabbixサーバーに送信します。Zabbix 4.4からはエージェントとして2つの種類があります：[Zabbixエージェント](/manual/concepts/agent)（C言語で実装され、低負荷で多くのプラットフォームをサポート）と[Zabbixエージェント2](/manual/concepts/agent2)（Go言語で実装され、柔軟でプラグインで拡張しやすい）です。

en-us	#### Aggregate functions  |FUNCTION|<|<|<| |--------|-|-|-| |<|**Description**|**Function-specific parameters**|**Comments**| |**avg** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Average value of an item within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Examples:<br>=> **avg**(/host/key,**1h**) → average value for the last hour until [now](/manual/config/triggers#evaluation_period)<br>=> **avg**(/host/key,**1h:now-1d**) → average value for an hour from 25 hours ago to 24 hours ago from [now](/manual/config/triggers#evaluation_period)<br>=> **avg**(/host/key,**\#5**) → average value of the five latest values<br>=> **avg**(/host/key,**\#5:now-1d**) → average value of the five latest values excluding the values received in the last 24 hours<br><br>Time shift is useful when there is a need to compare the current average value with the average value some time ago.| |**bucket\_percentile** (item filter,time period,percentage)|<|<|<| |<|Calculates the percentile from the buckets of a histogram.|**item filter** - see [item filter](/manual/appendix/functions/aggregate/foreach#item_filter)<br>**time period** - see [time period](/manual/appendix/functions/aggregate/foreach#time_period)<br>**percentage** - percentage (0-100)|Supported only in calculated items.<br><br>This function is an alias for `histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1))`| |**count** (func\_foreach(item filter,<time period>))|<|<|<| |<|Count of values in an array returned by a foreach function.|**func\_foreach** - foreach function for which the number of returned values should be counted (with supported arguments). See [foreach functions](/manual/appendix/functions/aggregate/foreach) for details.|Supported value type: int<br><br>Example:<br>=> **count**(max\_foreach(/\*/net.if.in\[\*\],1h)) → number of net.if.in items that received data in the last hour until [now](/manual/config/triggers#evaluation_period)<br><br>Note that using **count()** with a history-related foreach function (max\_foreach, avg\_foreach, etc.) may lead to performance implications, whereas using **exists\_foreach()**, which works only with configuration data, will not have such effect.| |**histogram\_quantile** (quantile,bucket1,value1,bucket2,value2,...)|<|<|<| |<|Calculates the φ-quantile from the buckets of a histogram.|**quantile** - 0 ≤ φ ≤ 1<br>**bucketN, valueN** - manually entered pairs (>=2) of parameters or response of [bucket\_rate\_foreach](/manual/appendix/functions/aggregate/foreach)|Supported only in calculated items.<br><br>Functionally corresponds to '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile)' of PromQL.<br><br>Example:<br>=> **histogram\_quantile**(0.75,1.0,last(/host/rate\_bucket\[1.0\]),"+Inf",last(/host/rate\_bucket\[Inf\])<br>=> **histogram\_quantile**(0.5,bucket\_rate\_foreach(//item\_key,30s))| |**item\_count** (item filter)|<|<|<| |<|Count of existing items in configuration that match filter criteria.|**item filter** - criteria for item selection, allows referencing by host group, host, item key, and tags. Wildcards are supported. See [item filter](/manual/appendix/functions/aggregate/foreach#item_filter) for more details.|Supported value type: int<br><br>Works as an alias for the *count(exists\_foreach(item\_filter))* function.<br><br>Example:<br>=> **item\_count**(/\*/agent.ping?\[group="Host group 1"\]) → number of hosts with the *agent.ping* item in the "Host group 1"| |**kurtosis** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|"Tailedness" of the probability distribution in collected values within the defined evaluation period.<br><br>See also: [Kurtosis](https://en.wikipedia.org/wiki/Kurtosis)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Example:<br>=> **kurtosis**(/host/key,**1h**) → kurtosis for the last hour until [now](/manual/config/triggers#evaluation_period)| |**mad** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Median absolute deviation in collected values within the defined evaluation period.<br><br>See also: [Median absolute deviation](https://en.wikipedia.org/wiki/Median_absolute_deviation)|See [common-parameters](#common parameters).|Supported value types: float, int<br><br>Example:<br>=> **mad**(/host/key,**1h**) → median absolute deviation for the last hour until [now](/manual/config/triggers#evaluation_period)| |**max** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Highest value of an item within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Example:<br>=> **max**(/host/key,**1h**) - **min**(/host/key,**1h**) → calculate the difference between the maximum and minimum values within the last hour until [now](/manual/config/triggers#evaluation_period) (delta of values)| |**min** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Lowest value of an item within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Example:<br>=> **max**(/host/key,**1h**) - **min**(/host/key,**1h**) → calculate the difference between the maximum and minimum values within the last hour until [now](/manual/config/triggers#evaluation_period) (delta of values)| |**skewness** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Asymmetry of the probability distribution in collected values within the defined evaluation period.<br><br>See also: [Skewness](https://en.wikipedia.org/wiki/Skewness)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Example:<br>=> **skewness**(/host/key,**1h**) → skewness for the last hour until [now](/manual/config/triggers#evaluation_period)| |**stddevpop** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Population standard deviation in collected values within the defined evaluation period.<br><br>See also: [Standard deviation](https://en.wikipedia.org/wiki/Standard_deviation)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Example:<br>=> **stddevpop**(/host/key,**1h**) → population standard deviation for the last hour until [now](/manual/config/triggers#evaluation_period)| |**stddevsamp** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Sample standard deviation in collected values within the defined evaluation period.<br><br>See also: [Standard deviation](https://en.wikipedia.org/wiki/Standard_deviation)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>At least two data values are required for this function to work.<br><br>Example:<br>=> **stddevsamp**(/host/key,**1h**) → sample standard deviation for the last hour until [now](/manual/config/triggers#evaluation_period)| |**sum** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Sum of collected values within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Example:<br>=> **sum**(/host/key,**1h**) → sum of values for the last hour until [now](/manual/config/triggers#evaluation_period)| |**sumofsquares** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|The sum of squares in collected values within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Example:<br>=> **sumofsquares**(/host/key,**1h**) → sum of squares for the last hour until [now](/manual/config/triggers#evaluation_period)| |**varpop** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Population variance of collected values within the defined evaluation period.<br><br>See also: [Variance](https://en.wikipedia.org/wiki/Variance)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Example:<br>=> **varpop**(/host/key,**1h**) → population variance for the last hour until [now](/manual/config/triggers#evaluation_period)| |**varsamp** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Sample variance of collected values within the defined evaluation period.<br><br>See also: [Variance](https://en.wikipedia.org/wiki/Variance)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>At least two data values are required for this function to work.<br><br>Example:<br>=> **varsamp**(/host/key,**1h**) → sample variance for the last hour until [now](/manual/config/triggers#evaluation_period)|  
ja	#### Aggregate functions  |FUNCTION|<|<|<| |--------|-|-|-| |<|**Description**|**Function-specific parameters**|**Comments**| |**avg** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Average value of an item within the defined evaluation period.|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Examples:<br>=> **avg**(/host/key,**1h**) → average value for the last hour until [now](/manual/config/triggers#evaluation_period)<br>=> **avg**(/host/key,**1h:now-1d**) → average value for an hour from 25 hours ago to 24 hours ago from [now](/manual/config/triggers#evaluation_period)<br>=> **avg**(/host/key,**\#5**) → average value of the five latest values<br>=> **avg**(/host/key,**\#5:now-1d**) → average value of the five latest values excluding the values received in the last 24 hours<br><br>Time shift is useful when there is a need to compare the current average value with the average value some time ago.| |**bucket\_percentile** (item filter,time period,percentage)|<|<|<| |<|Calculates the percentile from the buckets of a histogram.|**item filter** - see [item filter](/manual/appendix/functions/aggregate/foreach#item_filter)<br>**time period** - see [time period](/manual/appendix/functions/aggregate/foreach#time_period)<br>**percentage** - percentage (0-100)|Supported only in calculated items.<br><br>This function is an alias for `histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1))`| |**count** (func\_foreach(item filter,<time period>))|<|<|<| |<|Count of values in an array returned by a foreach function.|**func\_foreach** - foreach function for which the number of returned values should be counted (with supported arguments). See [foreach functions](/manual/appendix/functions/aggregate/foreach) for details.|Supported value type: int<br><br>Example:<br>=> **count**(max\_foreach(/\*/net.if.in\[\*\],1h)) → number of net.if.in items that received data in the last hour until [now](/manual/config/triggers#evaluation_period)<br><br>Note that using **count()** with a history-related foreach function (max\_foreach, avg\_foreach, etc.) may lead to performance implications, whereas using **exists\_foreach()**, which works only with configuration data, will not have such effect.| |**histogram\_quantile** (quantile,bucket1,value1,bucket2,value2,...)|<|<|<| |<|Calculates the φ-quantile from the buckets of a histogram.|**quantile** - 0 ≤ φ ≤ 1<br>**bucketN, valueN** - manually entered pairs (>=2) of parameters or response of [bucket\_rate\_foreach](/manual/appendix/functions/aggregate/foreach)|Supported only in calculated items.<br><br>Functionally corresponds to '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile)' of PromQL.<br><br>Example:<br>=> **histogram\_quantile**(0.75,1.0,last(/host/rate\_bucket\[1.0\]),"+Inf",last(/host/rate\_bucket\[Inf\])<br>=> **histogram\_quantile**(0.5,bucket\_rate\_foreach(//item\_key,30s))| |**item\_count** (item filter)|<|<|<| |<|Count of existing items in configuration that match filter criteria.|**item filter** - criteria for item selection, allows referencing by host group, host, item key, and tags. Wildcards are supported. See [item filter](/manual/appendix/functions/aggregate/foreach#item_filter) for more details.|Supported value type: int<br><br>Works as an alias for the *count(exists\_foreach(item\_filter))* function.<br><br>Example:<br>=> **item\_count**(/\*/agent.ping?\[group="Host group 1"\]) → number of hosts with the *agent.ping* item in the "Host group 1"| |**kurtosis** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|"Tailedness" of the probability distribution in collected values within the defined evaluation period.<br><br>See also: [Kurtosis](https://en.wikipedia.org/wiki/Kurtosis)|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Example:<br>=> **kurtosis**(/host/key,**1h**) → kurtosis for the last hour until [now](/manual/config/triggers#evaluation_period)| |**mad** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Median absolute deviation in collected values within the defined evaluation period.<br><br>See also: [Median absolute deviation](https://en.wikipedia.org/wiki/Median_absolute_deviation)|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Example:<br>=> **mad**(/host/key,**1h**) → median absolute deviation for the last hour until [now](/manual/config/triggers#evaluation_period)| |**max** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Highest value of an item within the defined evaluation period.|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Example:<br>=> **max**(/host/key,**1h**) - **min**(/host/key,**1h**) → calculate the difference between the maximum and minimum values within the last hour until [now](/manual/config/triggers#evaluation_period) (delta of values)| |**min** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Lowest value of an item within the defined evaluation period.|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Example:<br>=> **max**(/host/key,**1h**) - **min**(/host/key,**1h**) → calculate the difference between the maximum and minimum values within the last hour until [now](/manual/config/triggers#evaluation_period) (delta of values)| |**skewness** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Asymmetry of the probability distribution in collected values within the defined evaluation period.<br><br>See also: [Skewness](https://en.wikipedia.org/wiki/Skewness)|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Example:<br>=> **skewness**(/host/key,**1h**) → skewness for the last hour until [now](/manual/config/triggers#evaluation_period)| |**stddevpop** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Population standard deviation in collected values within the defined evaluation period.<br><br>See also: [Standard deviation](https://en.wikipedia.org/wiki/Standard_deviation)|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Example:<br>=> **stddevpop**(/host/key,**1h**) → population standard deviation for the last hour until [now](/manual/config/triggers#evaluation_period)| |**stddevsamp** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Sample standard deviation in collected values within the defined evaluation period.<br><br>See also: [Standard deviation](https://en.wikipedia.org/wiki/Standard_deviation)|See [common parameters](#common parameters).|Supported value types: float, int<br><br>At least two data values are required for this function to work.<br><br>Example:<br>=> **stddevsamp**(/host/key,**1h**) → sample standard deviation for the last hour until [now](/manual/config/triggers#evaluation_period)| |**sum** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Sum of collected values within the defined evaluation period.|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Example:<br>=> **sum**(/host/key,**1h**) → sum of values for the last hour until [now](/manual/config/triggers#evaluation_period)| |**sumofsquares** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|The sum of squares in collected values within the defined evaluation period.|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Example:<br>=> **sumofsquares**(/host/key,**1h**) → sum of squares for the last hour until [now](/manual/config/triggers#evaluation_period)| |**varpop** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Population variance of collected values within the defined evaluation period.<br><br>See also: [Variance](https://en.wikipedia.org/wiki/Variance)|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Example:<br>=> **varpop**(/host/key,**1h**) → population variance for the last hour until [now](/manual/config/triggers#evaluation_period)| |**varsamp** (/host/key,(sec\|\#num)<:time shift>)|<|<|<| |<|Sample variance of collected values within the defined evaluation period.<br><br>See also: [Variance](https://en.wikipedia.org/wiki/Variance)|See [common parameters](#common parameters).|Supported value types: float, int<br><br>At least two data values are required for this function to work.<br><br>Example:<br>=> **varsamp**(/host/key,**1h**) → sample variance for the last hour until [now](/manual/config/triggers#evaluation_period)|  

en-us	### Aggregate functions  The **count_foreach** function now returns '0' for a matching item in the array, if no data are present for the item or the data do not match the filter. Previously such items would be ignored (no data added to the aggregation).
ja	### 集計関数  **count_foreach** 関数は、項目のデータが存在しない場合、またはデータがフィルターに一致しない場合、配列内の一致する項目に対して「0」を返すようになりました。 以前はそのような項目は無視されていました (集計にデータは追加されませんでした)。

en-us	### Aggregate functions  The **count_foreach** function now returns '0' for a matching item in the array, if no data are present for the item or the data do not match the filter. Previously such items would be ignored (no data added to the aggregation).
ja	### 集計関数  **count_foreach** 関数で、配列内の一致する項目に対して、項目のデータが存在しない場合、またはデータがフィルターと一致しない場合に、その項目に対して '0' を返すようになりました。 変更前は、そのような項目は無視されていました (集計にデータが追加されませんでした)。

en-us	#### Aggregate functions  The **last_foreach** function is now also supported in the following [aggregate functions](/manual/appendix/functions/aggregate): kurtosis, mad, skewness, stddevpop, stddevsamp, sumofsquares, varpop, and varsamp.
ja	#### 集計関数  **last_foreach**関数は、次の[集計関数](/manual/appendix/functions/aggregate)でもサポートされるようになりました : kurtosis, mad, skewness, stddevpop, stddevsamp, sumofsquares, varpop, and varsamp

en-us	##### AIX, HP-UX  If `watch` command is not available, one can try      while [ 1 ]; do ps -fu zabbix; sleep 1; clear; done
ja	##### AIX, HP-UX  `watch`コマンドが使用できない場合に試してください。      while [ 1 ]; do ps -fu zabbix; sleep 1; clear; done

en-us	#### AIX  See values supported for 'memtype' parameter on AIX in the table.  |Supported value|Description|Source in procentry64 structure|Tries to be compatible with| |--|------|--|--| |vsize ^[1](proc_mem_notes#footnotes)^|Virtual memory size|pi\_size| | |pmem|Percentage of real memory|pi\_prm|ps -o pmem| |rss|Resident set size|pi\_trss + pi\_drss|ps -o rssize| |size|Size of process (code + data)|pi\_dvm|"ps gvw" SIZE column| |dsize|Data size|pi\_dsize|<| |tsize|Text (code) size|pi\_tsize|"ps gvw" TSIZ column| |sdsize|Data size from shared library|pi\_sdsize|<| |drss|Data resident set size|pi\_drss| | |trss|Text resident set size|pi\_trss| |
ja	#### AIX  以下の表がAIXの'memtype'パラメーターでサポートされている値です。  |サポート値|説明|procentry64構造体のソース|互換| |--|------|--|--| |vsize ^[1](proc_mem_notes#footnotes)^|仮想メモリサイズ|pi\_size| | |pmem|実メモリのパーセンテージ|pi\_prm|ps -o pmem| |rss|物理メモリ消費量|pi\_trss + pi\_drss|ps -o rssize| |size|プロセスのサイズ (コード + データ)|pi\_dvm|"ps gvw" SIZE column| |dsize|データサイズ|pi\_dsize|<| |tsize|テキスト (コード) サイズ|pi\_tsize|"ps gvw" TSIZ column| |sdsize|シェアードライブラリのデータサイズ|pi\_sdsize|<| |drss|データの物理メモリ消費量|pi\_drss| | |trss|テキストの物理メモリ消費量|pi\_trss| |

en-us	#### Alerter process crash in RHEL 7  Instances of a Zabbix server alerter process crash have been encountered in RHEL 7. Please see [ZBX-10461](https://support.zabbix.com/browse/ZBX-10461) for details.
ja	#### RHEL 7でのalerterプロセスのクラッシュ  RHEL 7上でZabbixサーバーのalerterプロセスがクラッシュすることが確認されています。 詳細は[ZBX-10461](https://support.zabbix.com/browse/ZBX-10461)を参照してください。

en-us	# alert.get
ja	# alert.get

en-us	##### Alerting on service status change  It is now possible to receive automated alerts about service status changes, similar to the alerts about trigger status changes.  A new [service action](/manual/config/notifications/action) type has been added to the *Actions* menu. Service actions may include steps for problem, recovery, and update operations related to services. It is possible to configure two types of actions: sending a message to the specified recipients and executing a remote command on Zabbix server. Similarly to trigger actions, service actions support problem [escalation](/manual/config/notifications/action/escalations) scenarios.  New message templates *Service*, *Service recovery*, and *Service update* have been added to [media types](/manual/config/notifications/media#common_parameters) and should be defined to enable correct sending of notifications for service actions.  
ja	#### Alerting on service status change  It is now possible to receive automated alerts about service status changes, similar to the alerts about trigger status changes.  A new [service action](/manual/config/notifications/action) type has been added to the *Actions* menu. Service actions may include steps for problem, recovery, and update operations related to services. It is possible to configure two types of actions: sending a message to the specified recipients and executing a remote command on Zabbix server. Similarly to trigger actions, service actions support problem [escalation](/manual/config/notifications/action/escalations) scenarios.  New message templates *Service*, *Service recovery*, and *Service update* have been added to [media types](/manual/config/notifications/media#common_parameters) and should be defined to enable correct sending of notifications for service actions.  

en-us	**Alerting on service status change**  It is now possible to receive automated alerts about service status changes, similar to the alerts about trigger status changes.  A new [service action](/manual/it_services/service_actions) functionality has been added, similar to other actions in Zabbix. Service actions may include steps for problem, recovery, and update operations related to services. It is possible to configure two types of actions: sending a message to the specified recipients and executing a remote command on Zabbix server. Similarly to trigger actions, service actions support problem [escalation](/manual/config/notifications/action/escalations) scenarios.  New message templates *Service*, *Service recovery*, and *Service update* have been added to [media types](/manual/config/notifications/media#common_parameters) and should be defined to enable correct sending of notifications for service actions.
ja	**サービスステータス変更時のアラート**  トリガーの状態変化に関するアラートと同様に、サービスの状態変化に関する自動的なアラートを受け取ることができるようになりました。  Zabbixの他のアクションと同じように、新しく[サービスアクション](/manual/it_services/service_actions)機能が追加されました。 サービスアクションには、サービスに関連する問題解決、復旧、更新操作の手順が含まれます。 サービスアクションは指定された受信者にメッセージを送信するアクションと指定された受信者にリモートでアクションを実行するアクションの2種類を設定することが可能です。  トリガーアクションと同様に、サービスアクションは問題の[エスカレーション](/manual/config/notifications/action/escalations)シナリオをサポートします。  新しいメッセージテンプレート *サービス*、*サービスの復旧*、*サービスの更新* が [メディアタイプ](/manual/config/notifications/media#common_parameters)に追加されたため、サービスアクションの通知を正しく送信できるように定義する必要があります。

en-us	### Alert  ::: noteclassic Alerts are created by the Zabbix server and cannot be modified via the API. :::  The alert object contains information about whether certain action operations have been executed successfully. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |alertid|string|ID of the alert.| |actionid|string|ID of the action that generated the alert.| |alerttype|integer|Alert type.<br><br>Possible values:<br>0 - message;<br>1 - remote command.| |clock|timestamp|Time when the alert was generated.| |error|string|Error text if there are problems sending a message or running a command.| |esc\_step|integer|Action escalation step during which the alert was generated.| |eventid|string|ID of the event that triggered the action.| |mediatypeid|string|ID of the media type that was used to send the message.| |message|text|Message text. Used for message alerts.| |retries|integer|Number of times Zabbix tried to send the message.| |sendto|string|Address, user name or other identifier of the recipient. Used for message alerts.| |status|integer|Status indicating whether the action operation has been executed successfully.<br><br>Possible values for message alerts:<br>0 - message not sent.<br>1 - message sent.<br>2 - failed after a number of retries.<br>3 - new alert is not yet processed by alert manager.<br><br>Possible values for command alerts:<br>0 - command not run.<br>1 - command run.<br>2 - tried to run the command on the Zabbix agent but it was unavailable.| |subject|string|Message subject. Used for message alerts.| |userid|string|ID of the user that the message was sent to.| |p\_eventid|string|ID of problem event, which generated the alert.| |acknowledgeid|string|ID of acknowledgment, which generated the alert.|
ja	### Alert  ::: noteclassic AlertはZabbixサーバーによって作成され、API経由で変更することはできません。 :::  Alertオブジェクトは、特定のアクション操作が正常に実行されたかどうかに関する情報を含んでいます。以下のプロパティを持ちます。  |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |alertid|string|アラートのID。| |actionid|string|アラートを生成したアクションのID。| |alerttype|integer|アラートタイプ。<br><br>有効な値:<br>0 - メッセージ<br>1 - リモートコマンド| |clock|timestamp|アラートが生成された時刻。| |error|string|メッセージの送信またはコマンドの実行に問題がある場合のエラーテキスト。| |esc\_step|integer|アラートが生成されたアクションエスカレーションステップ。| |eventid|string|アクションをトリガーしたイベントのID。| |mediatypeid|string|メッセージの送信に使用されたメディアタイプのID。| |message|text|メッセージテキスト。メッセージアラートに使用されます。| |retries|integer|Zabbixがメッセージの送信を試行した回数。| |sendto|string|受信者のアドレス、ユーザー名、またはその他の識別子。メッセージアラートに使用されます。| |status|integer|アクション操作が正常に実行されたかどうかを示すステータス。<br><br>メッセージアラートの有効な値:<br>0 - メッセージは送信されませんでした。<br>1 - メッセージが送信されました。<br>2 - 複数回試行しましたが失敗しました。<br>3 - 新しいアラートはアラートマネージャーによってまだ処理されていません。<br><br>コマンドアラートの有効な値:<br>0 - コマンドは実行されていません。<br>1 - コマンドが実行されました。<br>2 - Zabbixエージェントでコマンドを実行しようとしましたが、利用できませんでした。| |subject|string|メッセージの件名。メッセージアラートに使用されます。| |userid|string|メッセージの送信先のユーザーID。| |p\_eventid|string|アラートを生成した障害のイベントID。| |acknowledgeid|string|アラートを生成した確認のID。|

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

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

en-us	##### Aligning time zones for proxies and agent 2  Note that Zabbix proxies and agent 2 use their local time zones when processing scheduling intervals.  For this reason, when scheduling intervals are applied to items monitored by Zabbix proxy or agent 2 active items, it is recommended to set the time zone of the respective proxies or agent 2 the same as Zabbix server, otherwise the [queue](/manual/config/items/queue) may report item delays incorrectly.  The time zone for Zabbix proxy or agent 2 can be set using the environment variable `TZ` in the `systemd` unit file:      [Service]     ...     Environment="TZ=Europe/Amsterdam"
ja	##### プロキシとエージェント2 のタイムゾーンの調整  Zabbix プロキシとエージェント 2 は、スケジュール間隔を処理するときにローカル タイムゾーンを使用することに注意してください。  このため、Zabbix プロキシまたはエージェント 2 のアクティブ アイテムによって監視されるアイテムにスケジュール間隔を適用する場合は、それぞれのプロキシまたはエージェント 2 のタイムゾーンを Zabbix サーバーと同じに設定することをお勧めします。そうしないと、[キュー](/manual/config/items/queue)がアイテムの遅延を誤って報告する可能性があります。  Zabbix プロキシまたはエージェント 2 のタイムゾーンは、systemd ユニット ファイルの環境変数 TZ を使用して設定できます。      [Service]     ...     Environment="TZ=Europe/Amsterdam"

en-us	 All of these parameters can be changed in *Administration* → *General* → *Housekeeping* after the installation.  ::: notetip You may want to run the timescaledb-tune tool provided by TimescaleDB to optimize PostgreSQL configuration parameters in your `postgresql.conf`. :::
ja	これらのパラメータはすべて、インストール後に *管理* → *一般* →*ハウスキーピング* で変更できます。  ::: notetip TimescaleDB が提供する timescaledb-tune ツールを実行して、`postgresql.conf` の PostgreSQL 構成パラメーターを最適化することができます。 :::

en-us	##### Allow specific check, deny others  -   Whitelist specific checks with AllowKey parameters, deny others with     `DenyKey=*`  For example:      # Allow reading logs:     AllowKey=vfs.file.*[/var/log/*]      # Allow localtime checks     AllowKey=system.localtime[*]      # Deny all other keys     DenyKey=*
ja	##### 特定のチェックを許可し、他のチェックを拒否する  - AllowKey パラメータで特定のチェックをホワイトリスト化し、`DenyKey=*`で他のチェックを拒否する。  例:      # Allow reading logs:     AllowKey=vfs.file.*[/var/log/*]      # Allow localtime checks     AllowKey=system.localtime[*]      # Deny all other keys     DenyKey=*

en-us	 ### AND/OR evaluation in LLD filters  The evaluation of AND/OR expressions in the low-level discovery filters/overrides may fail in this version. Fixed in Zabbix 6.0.12.
ja	 ### LLDフィルター内のAND/ORの評価  このバージョンでは、ローレベルディスカバリーフィルター/オーバーライドでのAND/ORの評価が失敗する可能性があります。 Zabbix 6.0.12で修正されました。

en-us	  A new [template](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp) *Google Cloud Platform by HTTP (GCP by HTTP)* is available.  See setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http).   The template *Azure by HTTP* now also works with Azure Cosmos DB for MongoDB.
ja	  新しい[テンプレート](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp)*Google Cloud Platform by HTTP (GCP by HTTP)*が利用可能になりました。  [HTTPテンプレート](/manual/config/templates_out_of_the_box/http)のセットアップ手順を参照してください。   テンプレート*Azure by HTTP*はMongoDBのAzure Cosmos DBとも連携できるようになりました。

en-us	 #### Anomaly detection  Zabbix 5.2 introduced new trend functions useful for baseline monitoring. However, they still require defining relative thresholds (e.g. check that web traffic in September, 2021 is less than 2x higher compared to September, 2020). There are use cases when such thresholds are hard to define. For instance, the web traffic of a new but highly popular web site can organically grow many times over a year but the growth rate is unknown. Yet, a sudden traffic spike due to DDOS attack must generate an alert regardless of organic traffic growth.  Anomaly detection algorithms do exactly this - find data that doesn't look normal (outliers) in a context of other values.  New [trend function](/manual/appendix/functions/trends) **trendstl()** has been added which uses 'decomposition' method to calculate the anomaly rate. It splits a single time series sequence into three other sequences:  -   trend sequence that only contains big changes in the original data (e.g. website traffic shows growth) -   season sequence that only contains seasonal changes (e.g. less website traffic in summer, more in autumn) -   remainder sequence that only contains residual values that can not be interpreted as parts of trend or season  ![](../../../assets/en/manual/introduction/stl_data.png)  Anomaly detection works with remainder sequence and checks if there are values that are too far from the majority of remainder values. "Far" means that the absolute value from the remainder sequence is N times greater than the standard or mean deviation.
ja	 #### アノマリー検知  Zabbix 5.2では、ベースライン監視に役立つ新しいトレンド関数が導入されました。しかし、この機能でも相対的な閾値を定義する必要があります。(例：2021年9月のWebトラフィックが2020年9月に比べて2倍以下であることをチェックする)。実際のところ、このような閾値の定義が困難なケースもあります。例えば、新しいが非常に人気のあるウェブサイトのトラフィックは、1年間で何倍にも有機的に成長するが、その成長率は未知数です。しかし、DDOS攻撃による急激なトラフィックの増加は、有機的なトラフィックの増加とは無関係にアラートを発生させなければいけません。  異常値検出アルゴリズムは、まさにこれを行うもので、他の値のコンテキストの中で正常に見えないデータ（異常値）を見つけるものです。  新しい [履歴関数](/manual/appendix/functions/history) **trendstl()** が追加され、異常率を計算するために 'decomposition' メソッドを使用するようになりました。この関数は、1つの時系列を3つの時系列に分割します。  - トレンドシーケンス：元データの大きな変化のみを含む（例：ウェブサイトのトラフィックが増加している） - シーズンシーケンス：季節的な変化のみを含む（例：夏にはウェブサイトのトラフィックが少なく、秋には多くなる） - トレンドの一部とも季節の一部とも解釈できない残差のみを含むシーケンス  ![](../../../assets/en/manual/introduction/stl_data.png)  異常検出は余りの列で動作し、余りの値の大多数から離れすぎている(far from)値があるかどうかをチェックします。"離れすぎている(Far)"とは、余りの配列からの絶対値が、標準偏差または平均偏差のN倍であることを意味します。

en-us	##### Another example with an inline regex modifier  Use of the following regular expression including multiple inline modifiers to match the characters after a specific line:      (?<=match (?i)everything(?-i) after this line\n)(?sx).*# we add s modifier to allow . match newline characters  ![regexp\_expr\_4\_new.png](../../assets/en/manual/regular_expressions/regexp_expr_4_new.png)  Chosen Expression type: "Result is TRUE". Characters after a specific line are matched.  ::: noteimportant  **g** modifier can't be specified in line. The list of available modifiers can be found in [pcresyntax man page](https://www.pcre.org/original/doc/html/pcresyntax.html#SEC16). For more information about PCRE syntax please refer to [PCRE HTML documentation](https://www.pcre.org/original/doc/html/pcrepattern.html).  :::
ja	##### インライン正規表現修飾子を含む別の例  複数のインライン修飾子を含む次の正規表現を使用すると、特定の行以降の文字にマッチします。      (?<=match (?i)everything(?-i) after this line\n)(?sx).*# we add s modifier to allow .match newline characters  ![regexp\_expr\_4\_new.png](../../assets/en/manual/regular_expressions/regexp_expr_4_new.png)  選択されたExpression type : "結果はTRUE "です。 <br> 特定の行以降の文字にマッチします。  ::: noteimportant  **g**修飾子は、行内で指定することはできません。利用可能な修飾子の一覧は <br> 利用可能な修飾子のリストは、[pcresyntax manpage](https://www.pcre.org/original/doc/html/pcresyntax.html#SEC16)にあります。 <br> PCRE の構文に関するより詳しい情報は [PCRE HTML documentation](https://www.pcre.org/original/doc/html/pcrepattern.html) を参照してください。 <br> :::

en-us	##### API changes  See the list of [API changes](/manual/api/changes_5.4_-_6.0) in Zabbix 6.0.0.
ja	##### API変更点  Zabbix 6.0.0 の [API changes](/manual/api/changes_5.4_-_6.0)の一覧を参照してください。

en-us	### API information  Retrieve the version of the Zabbix API so that your application could use version-specific features.  [API info API](/manual/api/reference/apiinfo)
ja	### API情報  Zabbix APIのバージョンを取得し、アプリケーションでバージョン固有の機能を使用できるようにします。  [API info API](/manual/api/reference/apiinfo)

en-us	# API info  This class is designed to retrieve meta information about the API.  Available methods:\  -   [apiinfo.version](/manual/api/reference/apiinfo/version) -     retrieving the version of the Zabbix API
ja	# API info  このクラスは、APIに関するメタ情報を取得するためのものです。  利用可能なメソッド :\  -   [apiinfo.version](/manual/api/reference/apiinfo/version) -     Zabbix APIのバージョンの取得

en-us	# apiinfo.version
ja	# apiinfo.version

en-us	#### API login  A large number of open user sessions can be created when using custom scripts with the `user.login` [method](/manual/api/reference/user/login) without a following `user.logout`.
ja	#### APIログイン  `user.login` [method](/manual/api/reference/user/login)を使用し、`user.logout` がない <br> カスタムスクリプトを実行した場合、多数のオープンユーザーセッションが作成される可能性があります。 <br>

en-us	#### - API tokens  API tokens section allows to view tokens assigned to the user, edit token details and [create new tokens](/manual/web_interface/frontend_sections/administration/general#api_tokens). This section is only available to a user if *Manage API tokens* action is allowed in the [user role](/manual/web_interface/frontend_sections/administration/user_roles) settings.  ![](../../../assets/en/manual/web_interface/user_tokens.png){width="600"}  You may filter API tokens by name, expiry date, or status (enabled/disabled). Click on the token status in the list to quickly enable/disable a token. You may also mass enable/disable tokens by selecting them in the list and then clicking on the Enable/Disable buttons below the list.   ::: noteimportant  Users cannot view *Auth token* value of the tokens assigned to them in Zabbix. *Auth token* value is displayed only once - immediately after creating a token. If it has been lost, the token has to be regenerated.  :::
ja	#### - APIトークン  APIトークンセクションでは、ユーザーに割り当てられたトークンを表示したり、トークンの詳細を編集したり、[新しいトークンを作成](/manual/web_interface/frontend_sections/administration/general#api_tokens)したりできます。 このセクションは[ユーザーロール](/manual/web_interface/frontend_sections/administration/user_roles)設定で*APIトークンの管理*アクションが許可されているユーザーのみ利用できます。  ![](../../../assets/en/manual/web_interface/user_tokens.png){width="600"}  APIトークンは、名前、有効期限、またはステータス（有効/無効）でフィルタリングできます。リスト内のトークンステータスをクリックして、トークンを即時、有効/無効にすることもできます。リストでトークンを選択し、リストの下にある 有効化/無効化 ボタンをクリックして、トークンを一括で 有効化/無効化 することもできます。  ::: noteimportant  ユーザーは、Zabbixで自分に割り当てられたトークンの*認証トークン*値を表示できません。 *認証トークン*値は、トークンを作成した直後1回だけ表示されます。紛失した場合はトークンを再生成する必要があります。 :::

en-us	#### API Tokens  Manage authorization tokens.  [Token API](/manual/api/reference/token)
ja	#### APIトークン  認可トークンを管理します。  [Token API](/manual/api/reference/token)

en-us	#### - API tokens  This section allows to create and manage API tokens.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_tokens.png){width="600"}  You may filter API tokens by name, users to whom the tokens are assigned, expiry date, users that created tokens, or status (enabled/disabled). Click on the token status in the list to quickly enable/disable a token. You may also mass enable/disable tokens by selecting them in the list and then clicking on the *Enable/Disable* buttons below the list.  To create a new token, press *Create API token* button at the top right corner, then fill out the required fields in the token configuration screen:  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_token_conf.png)  |Parameter|Description| |---------|-----------| |Name|Token's visible name.| |User|User the token should be assigned to. To quickly select a user, start typing the username, first or last name, then select the required user from the auto-complete list. Alternatively, you can press the Select button and select a user from the full user list. A token can be assigned only to one user.| |Description|Optional token description.| |Set expiration date and time|Unmark this checkbox if a token should not have an expiry date.| |Expiry date|Click on the calendar icon to select token expiry date or enter the date manually in a format YYYY-MM-DD hh:mm:ss| |Enabled|Unmark this checkbox if you need to create a token in a disabled state.|  Press Add to create a token. On the next screen, copy and save in a safe place *Auth token* value **before closing the page**, then press Close. The token will appear in the list.  ::: notewarning  *Auth token* value cannot be viewed again later. It is only available immediately after creating a token. If you lose a saved token you will have to regenerate it and doing so will create a new authorization string.  :::  Click on the token name to edit the name, description, expiry date settings, or token status. Note, that it is not possible to change to which user the token is assigned. Press Update button to save changes. If a token has been lost or exposed, you may press Regenerate button to generate new token value. A confirmation dialog box will appear, asking you to confirm this operation since after proceeding the previously generated token will become invalid.  Users without access to the *Administration* menu section can see and modify details of tokens assigned to them in the *User profile → API tokens* [section](/manual/web_interface/user_profile#api_tokens) only if *Manage API tokens* is allowed in their [user role](/manual/web_interface/frontend_sections/administration/user_roles) permissions.
ja	#### - APIトークン  このセクションでは、APIトークンを作成および管理できます。  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_tokens.png){width="600"}  APIトークンは、名前、トークンが割り当てられているユーザー、有効期限、トークンを作成したユーザー、またはステータス（有効/無効）でフィルタリングできます。リスト内のトークンステータスをクリックして、トークンを有効/無効に設定できます。リストでトークンを選択し、リストの下にある*有効化/無効化*ボタンをクリックして、トークンを一括有効化/無効化することもできます。  新しいトークンを作成するには、右上隅にある*APIトークンの作成*ボタンを押してから、トークン設定画面の必須フィールドに入力します。  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_token_conf.png)  |パラメータ|詳細| |---------|-----------| |名前|トークンの表示名| |ユーザー|トークンを割り当てる必要があるユーザー。ユーザーを選択するには、ユーザー名、名または姓の入力を開始し、オートコンプリートリストから必要なユーザーを選択します。または選択ボタンを押して、ユーザーリストからユーザーを選択することもできます。トークンは1人のユーザーにのみ割り当てることができます。| |説明|トークンの説明| |有効期限の設定|トークンに有効期限を設定しない場合は、このチェックボックスをオフにします。| |有効期限|カレンダーアイコンをクリックしてトークンの有効期限を選択するか、YYYY-MM-DD hh:mm:ssの形式で日付を手動で入力します| |有効|無効な状態でトークンを作成する必要がある場合は、このチェックボックスをオフにします。|  追加を押してトークンを作成します。次の画面で*ページを閉じる前に**認証トークン*の値をコピーして安全な場所に保存して*閉じる*を押します。トークンがリストに表示されます。  ::: notewarning  *認証トークン*の値は後で再度表示することはできません。トークンを作成した直後にのみ表示できます。保存したトークンを紛失した場合は、トークンを再生成する必要があります。そうすると、新しい認証文字列が作成されます。 :::  トークン名をクリックして、名前、説明、有効期限の設定、またはトークンのステータスを編集します。トークンが割り当てられているユーザーを変更することはできないことに注意してください。変更後に更新ボタンを押して変更を保存します。トークンが紛失または公開された場合は、*再生成*ボタンを押して新しいトークン値を生成できます。再生成時は確認ダイアログボックスが表示されます。続行すると以前に生成されたトークンが無効になるためです。  *管理*メニューセクションにアクセスできないユーザーは、*ユーザープロファイル→APIトークン* [セクション](/manual/web_interface/user_profile#api_tokens)で、*APIトークンの管理*が[ユーザーロール](/manual/web_interface/frontend_sections/administration/user_roles) 権限で許可されます。

en-us	### API versions  To simplify API versioning, since Zabbix 2.0.4, the version of the API matches the version of Zabbix itself. You can use the [apiinfo.version](/manual/api/reference/apiinfo/version) method to find out the version of the API you're working with. This can be useful for adjusting your application to use version-specific features.  We guarantee feature backward compatibility inside of a major version. When making backward incompatible changes between major releases, we usually leave the old features as deprecated in the next release, and only remove them in the release after that. Occasionally, we may remove features between major releases without providing any backward compatibility. It is important that you never rely on any deprecated features and migrate to newer alternatives as soon as possible.  ::: notetip You can follow all of the changes made to the API in the [API changelog](/manual/api/changes_5.4_-_6.0). :::
ja	### APIバージョン  APIのバージョン管理を簡素化するために、Zabbix 2.0.4以降、APIのバージョンはZabbix自体のバージョンと一致していますが、[apiinfo.version](/manual/api/reference/apiinfo/version) メソッドを使用して、使用している API のバージョンを確認することもできます。 これは、バージョン固有の機能を使用するようにアプリケーションを調整する場合に役立ちます。  メジャー バージョン内では、機能の下位互換性を保証します。 メジャー リリース間で下位互換性のない変更を行う場合、通常は古い機能を次のリリースで非推奨として残し、その後のリリースで削除します。 場合によっては、下位互換性を提供せずにメジャー リリース間で機能を削除することもあります。 非推奨の機能には決して依存せず、できるだけ早く新しい代替機能に移行することが重要です。  ::: notetip [API 変更ログ](/manual/api/changes_5.4_-_6.0) で、API に加えられたすべての変更を追うことができます。 :::

en-us	# Appendix 1. Reference commentary
ja	# 付録1. 参考文献の解説

en-us	# Appendix 2. Changes from 5.4 to 6.0
ja	# 付録2．5.4から6.0での変更点

en-us	#### Architecture  Zabbix consists of several major software components. Their responsibilities are outlined below.
ja	#### アーキテクチャー  Zabbixは、いくつかの主なソフトウェアコンポーネントから構成されています。各コンポーネントの役割を以下に示します。

en-us	#### A real life scenario  In this example, we would like to set up network discovery for the local network having an IP range of 192.168.1.1-192.168.1.254.  In our scenario we want to:  -   discover those hosts that have Zabbix agent running -   run discovery every 10 minutes -   add a host to monitoring if the host uptime is more than 1 hour -   remove hosts if the host downtime is more than 24 hours -   add Linux hosts to the "Linux servers" group -   add Windows hosts to the "Windows servers" group -   use the template *Linux* for Linux hosts -   use the template *Windows* for Windows hosts
ja	#### 実際に使用するシナリオ  この例では、ローカルネットワークの192.168.1.1～192.168.1.254の範囲のIPアドレスをチェックするネットワークディスカバリを設定します。  このシナリオでは、以下のことをおこなう設定をします：  -   Zabbixエージェントが動作しているホストを検出 -   検出は10分間隔で実行 -   アップタイムが1時間以上のホストは監視対象に追加 -   ダウンタイムが24時間以上のホストは監視対象から削除 -   Linuxホストはグループ「Linux servers」に追加 -   Windowsホストはグループ「Windows servers」に追加 -   Linuxホストではテンプレート*Linux*を使用 -   Windowsホストではテンプレート*Windows*を使用

en-us	##### AS/400  IBM AS/400 platform can be monitored using SNMP. More information is available at <http://publib-b.boulder.ibm.com/Redbooks.nsf/RedbookAbstracts/sg244504.html?Open>.
ja	##### AS/400  IBM AS/400 プラットフォームは、SNMP を使用して監視できます。 詳細については、次の Web サイトを参照してください。 <http://publib-b.boulder.ibm.com/Redbooks.nsf/RedbookAbstracts/sg244504.html?Open>.

en-us	#### Assigning different hosts  Replace the hosts currently assigned to maintenance "3" with two different ones.  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "maintenance.update",     "params": {         "maintenanceid": "3",         "hostids": [             "10085",             "10084"         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "maintenanceids": [             "3"         ]     },     "id": 1 } ```  
ja	#### Assigning different hosts  Replace the hosts currently assigned to maintenance "3" with two different ones.  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "maintenance.update",     "params": {         "maintenanceid": "3",         "hostids": [             "10085",             "10084"         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "maintenanceids": [             "3"         ]     },     "id": 1 } ```  

en-us	#### Assigning different hosts  Replace the hosts currently assigned to maintenance with two different ones.  Request:  ```json {     "jsonrpc": "2.0",     "method": "maintenance.update",     "params": {         "maintenanceid": "3",         "hosts": [             {"hostid": "10085"},             {"hostid": "10084"}         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "maintenanceids": [             "3"         ]     },     "id": 1 } ```
ja	#### 異なるホストの割り当て  現在メンテナンスに割り当てられているホストを2つの異なるホストに置き換えます。  Request:  ```json {     "jsonrpc": "2.0",     "method": "maintenance.update",     "params": {         "maintenanceid": "3",         "hosts": [             {"hostid": "10085"},             {"hostid": "10084"}         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "maintenanceids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Attempting to use Zabbix sender compiled with TLS support to send data to Zabbix server/proxy compiled without TLS
ja	#### TLS サポートでコンパイルされた Zabbix センダーを使用して、TLS なしでコンパイルされた Zabbix サーバー/プロキシにデータを送信した場合

en-us	##### Attributes returning composite data  It becomes more complicated when your attribute returns composite data. For example: your attribute name is "apple" and it returns a hash representing its parameters, like "weight", "color" etc. Your key may look like this:      jmx[com.example:Type=Hello,apple.weight]  This is how an attribute name and a hash key are separated, by using a dot symbol. Same way, if an attribute returns nested composite data the parts are separated by a dot:      jmx[com.example:Type=Hello,fruits.apple.weight]
ja	##### 複合データを返す属性  例えば、属性名が "apple" で、"weight" 、"color" などのパラメータを表すハッシュを返す場合、属性はより複雑になります。 キーは次のようになります。      jmx[com.example:Type=Hello,apple.weight]   このように、属性名とハッシュ・キーは、ドット記号で区切られます。 同じように、属性がネストした複合データを返す場合は、ドットで区切ります。      jmx[com.example:Type=Hello,fruits.apple.weight] 

en-us	##### Attributes returning tabular data  Tabular data attributes consist of one or multiple composite attributes. If such an attribute is specified in the attribute name parameter then this item value will return the complete structure of the attribute in JSON format. The individual element values inside the tabular data attribute can be retrieved using preprocessing.  Tabular data attribute example:       jmx[com.example:type=Hello,foodinfo]  Item value:  ``` {.javascript} [   {     "a": "apple",     "b": "banana",     "c": "cherry"   },   {     "a": "potato",     "b": "lettuce",     "c": "onion"   } ] ```
ja	##### 表形式データを返す属性  表形式データ属性は、1つまたは複数の複合属性から構成されます。属性名パラメータにそのような<br> 属性が指定された場合、この item 値はその属性の完全な構造をJSON形式で返します。<br> 表形式データ属性の中の個々の要素値は、プリプロセスによって取得することができます。  表形式データ属性の例:  Item 値:  ``` {.javascript} [   {     "a": "apple",     "b": "banana",     "c": "cherry"   },   {     "a": "potato",     "b": "lettuce",     "c": "onion"   } ] ```

en-us	#### Audit log
ja	#### 監査ログ

en-us	### Audit log  Audit log functionality has been reworked significantly. The updated Audit log contains records of all configuration changes of Zabbix objects and has an improved filter, which allows to view records grouped by frontend operation. Logging can be switched on or off in the *Administration→General* menu section. In order to implement these changes, the previously existing database structure had to be reworked. During an upgrade DB tables `auditlog` and `auditlog_details` will be replaced by the new table `auditlog` with a different format. **Existing audit log records will be deleted.**  
ja	##### User macros in item name no longer supported  The support for user macros in item names (including discovery rule names), deprecated since Zabbix 4.0, has been fully removed.  

en-us	#### audit log  Changes:\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) Audit log object: dropped support of property `note`.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) Audit log object: dropped support of `resourcetype` values `2`(Configuration of Zabbix) and `7`(Graph element).\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) Audit log object: dropped support of `action` values `5`(Enable) and `6`(Disable).\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `auditlog.get`: dropped support of parameter `selectDetails`.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) Audit log object: dropped support of `action` value `3` (Login).\  
ja	#### audit log  Changes:\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) Audit log object: dropped support of property `note`.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) Audit log object: dropped support of `resourcetype` values `2`(Configuration of Zabbix) and `7`(Graph element).\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) Audit log object: dropped support of `action` values `5`(Enable) and `6`(Disable).\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `auditlog.get`: dropped support of parameter `selectDetails`.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) Audit log object: dropped support of `action` value `3` (Login).\  

en-us	#### auditlog  Changes:\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) dropped support of property `note`.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) dropped support of `resourcetype` values *(2 - Configuration of Zabbix, 7 - Graph element)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) dropped support of `action` values *(5 - Enable, 6 - Disable)*.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) dropped support of `action` value *(3 - Login)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `auditlog.get`: dropped support of parameter `selectDetails`.\
ja	#### 監査ログ  変更点:\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) 監査ログオブジェクト: プロパティ `note` のサポートを終了しました。\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) 監査ログオブジェクト: `resourcetype` の値 `2` (Zabbix の設定) と`7` (グラフ要素)のサポートを終了しました。\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) 監査ログオブジェクト: `action` の値 `5` (有効) と `6` (無効)のサポートを終了しました。\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `auditlog.get`: パラメーター `selectDetails`のサポートを終了しました。\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) 監査ログオブジェクト: `action`の値 `3` (ログイン)のサポートを終了しました。\

en-us	#### auditlog Changes:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) added new `resourcetype` *(48 - SLA)*.\ [ZBXNEXT-6923](https://support.zabbix.com/browse/ZBXNEXT-6923) added new `resourcetype` *(47 - High availability node)*.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) added support of `action` values *(8 - Login, 9 - Failed login, 10 - History clear)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) added support of properties: `username`, `recordsetid`, `details`.\
ja	#### 監査ログ 変更点:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) 新規の `resourcetype` *(48 - SLA)* を追加しました。\ [ZBXNEXT-6923](https://support.zabbix.com/browse/ZBXNEXT-6923) 新規の `resourcetype` *(47 - High availability node)* を追加しました。\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) `action` の値 *(8 - Login, 9 - Failed login, 10 - History clear)* のサポートを開始しました。\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) プロパティ `username`, `recordsetid`, `details` のサポートを開始しました。\

en-us	 ### Audit log filter  Multiple actions now can be selected in the audit log filter in *Reports* -> *[Audit](/manual/web_interface/frontend_sections/reports/audit)*:  ![](../../../assets/en/manual/introduction/audit_log_filter_new.png){width="600"}  This is useful to see all related actions (for example, successful and failed logins into the frontend)  in the audit list.
ja	### 監査ログフィルター  *レポート* -> *[監査](/manual/web_interface/frontend_sections/reports/audit)* にある監査ログフィルターで複数のアクションを選択できるようになりました。  ![](../../../assets/en/manual/introduction/audit_log_filter_new.png){width="600"}   これは、関連するすべてのアクション (たとえば、Webインターフェースへのログインの成功や失敗) を監査リストで確認するのに便利です。

en-us	# auditlog.get
ja	# auditlog.get

en-us	#### Audit log  In order to implement the changes in [audit log functionality](#audit-log), the previously existing database structure had to be reworked. During the upgrade `auditlog` and `auditlog_details` DB tables will be replaced by the new table `auditlog` with a different format. **Existing audit log records will be deleted.**
ja	#### 監査ログ  [監査ログ機能](#監査ログ)の変更を実装するために、既存のデータベース構造を再構築する必要がありました。 アップグレードによって、`auditlog`と`auditlog_details`DB テーブルは、異なるフォーマットの新しいテーブル`auditlog`に置き換えられます。**既存の監査ログのレコードは削除されます。**

en-us	 ##### Audit log  In order to improve audit logging in Zabbix and make the Audit log complete and reliable, the previously existing database structure had to be reworked. During an upgrade DB tables `auditlog` and `auditlog_details` will be replaced by the new table `auditlog` with a different format. **Old audit records will not be preserved.**  New [section](/manual/web_interface/frontend_sections/administration/general#audit_log) *Audit log* has been added to the *Administration→General* menu allowing to enable (default) or disable audit logging. Housekeeping settings for audit, previously located under the *Housekeeper* menu section, have also been moved to the new *Audit log* section. Existing housekeeping settings will be saved.
ja	##### 監査ログ  Zabbixの監査ログを改善し、監査ログを完全で信頼性の高いものにするために、従来のデータベース構造を変更する必要がありました。 <br> アップグレードにより、DBテーブル `auditlog` と `auditlog_details` は新しいフォーマットテーブルに置き換えられ、 <br> **古い監査記録は保存されません**。 <br>  新しい [section](/manual/web_interface/frontend_sections/administration/general#audit_log) *Administration→General* メニューに *Audit log* が追加され、監査ログの有効化(デフォルト)または無効化ができるようになりました。 <br> 監査に関するハウスキーピング設定は、これまで*Housekeeper*メニューセクションにありましたが、 <br> 新しい*Audit_log*メニューに移動されました。既存のハウスキーピングの設定は保存されます。 <br>

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

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

en-us	#### - Audit log  This section allows configuring audit log settings.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/audit_log.png)  The following parameters are available:  |Parameter|Description| |--|--------| |Enable audit logging|Enable/disable audit logging. Marked by default.| |Enable internal housekeeping|Enable/disable internal housekeeping for audit. Marked by default.| |Data storage period|Amount of days audit records should be kept for before being removed by the housekeeper. Mandatory if housekeeping is enabled. Default: 365 days.|
ja	#### - 監査ログ  このセクションでは監査ログの設定ができます。  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/audit_log.png)  次のパラメータを使用できます：  |パラメータ|詳細| |--|--------| |監査ログの有効化|監査ログを有効/無効にします。 デフォルトでマークされています。| |削除処理を有効|監査ログのための内部的な削除処理を有効/無効にします。 デフォルトでマークされています。| |データ保存期間|内部的な削除処理によって削除される前に、監査記録を保持する必要がある日数。 削除処理がが有効になっている場合は必須です。 デフォルト：365日|

en-us	**Audit settings**  New [section](/manual/web_interface/frontend_sections/administration/general#audit_log) *Audit log* has been added to the *Administration→General* menu allowing to enable or disable audit logging. Housekeeping settings for audit, previously located under the *Housekeeper* section, have also been moved to the new *Audit log* section.
ja	**監査設定**  新しい[セクション](/manual/web_interface/frontend_sections/administration/general#audit_log) *管理→一般設定* メニューに *監査ログ* が追加され、監査ログの有効化と無効化ができるようになりました。 これまで*データの保存期間*セクションにあった監査用の保存期間設定も、新しい*監査ログ*セクションに移動されました。

en-us	#### Authenticating a user  Authenticate a user.  Request:  ```json {     "jsonrpc": "2.0",     "method": "user.login",     "params": {         "username": "Admin",         "password": "zabbix"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": "0424bd59b807674191e7d77572075f33",     "id": 1 } ```
ja	#### ユーザー認証  ユーザー認証  Request:  ```json {     "jsonrpc": "2.0",     "method": "user.login",     "params": {         "username": "Admin",         "password": "zabbix"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": "0424bd59b807674191e7d77572075f33",     "id": 1 } ```

en-us	#### Authentication  Change authentication configuration options.  [Authentication API](/manual/api/reference/authentication)
ja	#### 認証  認証の設定オプションを変更します。  [Authentication API](/manual/api/reference/authentication)

en-us	#### authentication  Changes:\ [ZBXNEXT-4029](https://support.zabbix.com/browse/ZBXNEXT-4029) added new password policy fields `passwd_min_length` and `passwd_check_rules`.\
ja	#### 認証  変更点:\ [ZBXNEXT-4029](https://support.zabbix.com/browse/ZBXNEXT-4029) パスワードポリシーのフィールド `passwd_min_length`,  `passwd_check_rules` を追加しました。\

en-us	# authentication.get
ja	# authentication.get

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

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

en-us	#### Authentication  To access any data in Zabbix, you need to either:  -   use an existing [API token](/manual/web_interface/frontend_sections/administration/general#api-tokens) (created in Zabbix frontend or using the [Token API](/manual/api/reference/token)); -   use an authentication token obtained with the [user.login](/manual/api/reference/user/login) method.  For example, if you wanted to obtain a new authentication token by logging in as a standard *Admin* user, then a JSON request would look like this:  ```json {     "jsonrpc": "2.0",     "method": "user.login",     "params": {         "username": "Admin",         "password": "zabbix"     },     "id": 1,     "auth": null } ```  Let's take a closer look at the request object. It has the following properties:  -   `jsonrpc` - the version of the JSON-RPC protocol used by the API;     the Zabbix API implements JSON-RPC version 2.0; -   `method` - the API method being called; -   `params` - parameters that will be passed to the API method; -   `id` - an arbitrary identifier of the request; -   `auth` - a user authentication token; since we don't have one yet,     it's set to `null`.  If you provided the credentials correctly, the response returned by the API will contain the user authentication token:  ```json {     "jsonrpc": "2.0",     "result": "0424bd59b807674191e7d77572075f33",     "id": 1 } ```  The response object in turn contains the following properties:  -   `jsonrpc` - again, the version of the JSON-RPC protocol; -   `result` - the data returned by the method; -   `id` - identifier of the corresponding request.
ja	#### 認証  Zabbixのデータにアクセスするには、次のどちらかを行う必要があります。  -   既存の[APIトークン](/manual/web_interface/frontend_sections/administration/general#api-tokens)を使用(Zabbixフロントエンドまたは[トークンAPI](/manual/api/reference/token)を使用して作成); -   [user.login](/manual/api/reference/user/login)メソッドで取得した認証トークンを使用。  たとえば、標準の*Admin*ユーザーとしてログインして新しい認証トークンを取得したい場合、JSON リクエストは次のようになります。  ```json {     "jsonrpc": "2.0",     "method": "user.login",     "params": {         "username": "Admin",         "password": "zabbix"     },     "id": 1,     "auth": null } ```  リクエストオブジェクトを詳しく見てみましょう。プロパティは次のとおりです。  -   `jsonrpc` - APIで使用される JSON-RPC プロトコルのバージョン。Zabbix APIはJSON-RPCバージョン2.0を実装します。 -   `method` - 呼び出されるAPIメソッド。 -   `params` - APIメソッドに渡されるパラメータ。 -   `id` - リクエストの任意のID。 -   `auth` - ユーザー認証トークン。 まだ持っていないので、`null`に設定されています。  資格情報を正しく指定した場合、APIによって返される応答にはユーザー認証トークンが含まれます。  ```json {     "jsonrpc": "2.0",     "result": "0424bd59b807674191e7d77572075f33",     "id": 1 } ```  レスポンスオブジェクトには次のプロパティが含まれます。  -   `jsonrpc` - 繰り返しになりますが、JSON-RPCプロトコルのバージョン。 -   `result` - メソッドによって返されたデータ。 -   `id` - 対応するリクエストのID。

en-us	# authentication.update
ja	# authentication.update

en-us	## AUTHOR  Alexei Vladishev <<alex@zabbix.com>>  ------------------------------------------------------------------------  [ ]{#index}
ja	## 著者  Alexei Vladishev <<alex@zabbix.com>>  ------------------------------------------------------------------------  [ ]{#index}

en-us	## AUTHOR  Alexei Vladishev <<alex@zabbix.com>>  ------------------------------------------------------------------------  [ ]{#index}
ja	## 著者  Alexei Vladishev <<alex@zabbix.com>>  ------------------------------------------------------------------------  [ ]{#index}

en-us	## AUTHOR  Alexei Vladishev <<alex@zabbix.com>>  ------------------------------------------------------------------------  [ ]{#index}
ja	## 著者  Alexei Vladishev <<alex@zabbix.com>>  ------------------------------------------------------------------------  [ ]{#index}

en-us	## AUTHOR  Alexei Vladishev <<alex@zabbix.com>>  ------------------------------------------------------------------------  [ ]{#index}
ja	## 著者  Alexei Vladishev <<alex@zabbix.com>>  ------------------------------------------------------------------------  [ ]{#index}

en-us	## AUTHOR  Alexei Vladishev <<alex@zabbix.com>>  ------------------------------------------------------------------------  [ ]{#index}
ja	## 著者  Alexei Vladishev <<alex@zabbix.com>>  ------------------------------------------------------------------------  [ ]{#index}

en-us	##### Authorization  |Parameter|Description| |--|--------| |*Login attempts*|Number of unsuccessful login attempts before the possibility to log in gets blocked.| |*Login blocking interval*|Period of time for which logging in will be prohibited when *Login attempts* limit is exceeded.|
ja	##### 認可  |パラメータ|詳細| |--|--------| |*ログインの試行*|ログインがブロックされるログイン失敗の数| |*ログインブロックの間隔*|*ログインの試行*回数を超えた場合にログインが禁止される期間|

en-us	## AUTHOR  Zabbix LLC  ------------------------------------------------------------------------  [ ]{#index}
ja	## 著者  Zabbix LLC  ------------------------------------------------------------------------  [ ]{#index}

en-us	## AUTHOR  Zabbix LLC  ------------------------------------------------------------------------  [ ]{#index}
ja	## 著者  Zabbix LLC  ------------------------------------------------------------------------  [ ]{#index}

en-us	#### Automated type selection  Item configuration form now automatically suggests the matching type of information, if selected item key returns data only of the specific type (for example, **log\[\]** item requires *Type of information: Log*). *Type of information* parameter is now located under the *Key* parameter on the primary *Item* tab and is duplicated on the *Preprocessing* tab if at least one preprocessing step is specified. If Zabbix detects a possible mismatch of the selected type of information and key, a warning icon will be displayed next to the *Type of information* field.
ja	#### 自動タイプ選択機能  アイテム設定画面で、選択されたアイテムキーが特定のタイプのデータのみを返す場合、一致する情報のタイプを自動的に提案するようになりました。(例えば、**log\[\]**アイテムは、*データ型: ログ*であることが必要) *データ型*パラメーターが*アイテム*タブの*Key*パラメータの下に配置され、少なくとも1つの保存前処理が定義されている場合は、*保存前処理* タブに複製されます。選択したタイプの情報とキーが一致しない可能性がある場合、警告アイコンが *データ型* フィールドの横に表示されます。

en-us	##### Automatic mode  A host's inventory can also be populated automatically. For that to work, when configuring the host's inventory mode in the *Inventory* tab, it must be set to *Automatic*.  Then you can [configure host items](/manual/config/items/item) to populate any host inventory field with their value, indicating the destination field with the respective attribute (called *Item will populate host inventory field*) in item configuration.  Items that are especially useful for automated inventory data collection:  -   system.hw.chassis\[full|type|vendor|model|serial\] - default is     \[full\], root permissions needed -   system.hw.cpu\[all|cpunum,full|maxfreq|vendor|model|curfreq\] -     default is \[all,full\] -   system.hw.devices\[pci|usb\] - default is \[pci\] -   system.hw.macaddr\[interface,short|full\] - default is \[all,full\],     interface is regexp -   system.sw.arch -   system.sw.os\[name|short|full\] - default is \[name\] -   system.sw.packages\[regexp,manager,short|full\] - default is     \[all,all,full\]
ja	##### 自動モード  ホストのインベントリも自動的に入力できます。これを機能させるには、*インベントリ*タブでホストのインベントリモードを設定するときに*自動*に設定する必要があります。  次に、アイテムの*ホストインベントリフィールドの自動設定*で任意のホストインベントリのフィールドに値を入力するホストインベントリ用の[アイテムが設定](/manual/config/items/item)できます。  インベントリデータの自動収集に特に有効なアイテムを収集することができます。<br>  -   system.hw.chassis\[full|type|vendor|model|serial\] - デフォルトは\[full\]で、ルート権限が必要です-   system.hw.cpu\[all|cpunum,full|maxfreq|vendor|model|curfreq\] - デフォルトは\[all,full\] -   system.hw.devices\[pci|usb\] - デフォルトは\[pci\] -   system.hw.macaddr\[interface,short|full\] - デフォルトは\[all,full\]、インターフェースは正規表現 -   system.sw.arch -   system.sw.os\[name|short|full\] - デフォルトは\[name\] -   system.sw.packages\[package,manager,short|full\] - デフォルトは\[all,all,full\]、パッケージは正規表現

en-us	#### Autoregistration actions  The following conditions can be used in actions based on active agent autoregistration:  |Condition type|Supported operators|Description| |--|--|------| |*Host metadata*|contains<br>does not contain<br>matches<br>does not match|Specify host metadata or host metadata to exclude.<br>**contains** - host metadata contains the string.<br>**does not contain** - host metadata does not contain the string.<br>Host metadata can be specified in an [agent configuration file](/manual/appendix/config/zabbix_agentd).<br>**matches** - host metadata matches regular expression.<br>**does not match** - host metadata does not match regular expression.| |*Host name*|contains<br>does not contain<br>matches<br>does not match|Specify a host name or a host name to exclude.<br>**contains** - host name contains the string.<br>**does not contain** - host name does not contain the string.<br>**matches** - host name matches regular expression.<br>**does not match** - host name does not match regular expression.| |*Proxy*|equals<br>does not equal|Specify a proxy or a proxy to exclude.<br>**equals** - using this proxy.<br>**does not equal** - using any other proxy except this one.|
ja	#### 自動登録アクション  次の条件は、アクティブなエージェントの自動登録に基づくアクションで使用できます。  |タイプ|オペレータ|説明| |--|--|------| |*ホストメタデータ*|含む<br>含まない<br>一致する<br>一致しない|ホストのメタデータまたは除外するホストのメタデータを指定します。<br>**含む** - ホスト メタデータには指定文字列が含まれる。<br>**含まない** - ホスト メタデータに指定文字列が含まれない。<br>ホストのメタデータは[エージェント設定ファイル](/manual/appendix/config/zabbix_agentd)で指定できます。<br>**一致する** - ホスト メタデータは正規表現と一致する。<br>**一致しない** - ホスト メタデータは正規表現と一致しない。| |*ホスト名*|含む<br>含まない<br>一致する<br>一致しない|ホスト名または除外するホスト名を指定します。<br>**含む** - ホスト名に文字列が含まれる。<br>**含まない** - ホスト名に文字列が含まれない。<br>** 一致する** - ホスト名が正規表現に一致する。<br>**一致しない** - ホスト名が正規表現に一致しない。| |*プロキシ*|等しい<br>等しくない|プロキシまたは除外するプロキシを指定します。<br>**等しい** - このプロキシを使用します。<br>**等しくない** - このプロキシ以外の他のプロキシを使用します。|

en-us	# autoregistration.get
ja	# autoregistration.get

en-us	#### - Autoregistration  In this section, you can configure the encryption level for active agent autoregistration.  ![adm\_autoreg2.png](../../../../../assets/en/manual/web_interface/frontend_sections/administration/adm_autoreg2.png)  Parameters marked with an asterisk are mandatory.  Configuration parameters:  |Parameter|Description| |---------|-----------| |*Encryption level*|Select one or both options for encryption level:<br>**No encryption** - unencrypted connections are allowed<br>**PSK** - TLS encrypted connections with a pre-shared key are allowed| |*PSK identity*|Enter the pre-shared key identity string.<br>This field is only available if 'PSK' is selected as *Encryption level*.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |*PSK*|Enter the pre-shared key (an even number of hexadecimal characters).<br>Maximum length: 512 hex-digits (256-byte PSK) if Zabbix uses GnuTLS or OpenSSL library, 64 hex-digits (32-byte PSK) if Zabbix uses mbed TLS (PolarSSL) library.<br>Example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952<br>This field is only available if 'PSK' is selected as *Encryption level*.|  See also: [Secure autoregistration](/manual/discovery/auto_registration#secure_autoregistration)
ja	#### - 自動登録  このセクションでは、アクティブエージェントの自動登録の暗号化レベルを設定できます。  ![adm\_autoreg2.png](../../../../../assets/en/manual/web_interface/frontend_sections/administration/adm_autoreg2.png)  アスタリスクでマークされたパラメーターは必須です。  設定値：  |パラメータ|詳細| |---------|-----------| |*暗号化レベルl*|暗号化レベルオプションの1つまたは両方を選択します。<br>**暗号無し** - 暗号化されていない接続が許可されます<br>**PSK** - 事前共有キーを使用したTLS暗号化接続が許可されます| |*PSK ID*|事前共有キーID文字列を入力します。<br>このフィールドは「暗号化レベル」の「PSK」が選択されている場合にのみ使用できます。<br>機密情報をPSKIDに入れないでください。機密情報は暗号化されずにネットワーク経由で送信され、どのPSKを使用するかを受信者に通知します。| |*PSK*|事前共有キー（偶数の16進文字）を入力します。<br>最大長：ZabbixがGnuTLSまたはOpenSSLライブラリを使用する場合は512。hex-digits（256バイトPSK）mbed TLS（PolarSSL）ライブラリを使用する場合は64 hex-digits（32-byte PSK）。<br>例: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952<br>このフィールドは、「暗号化レベル」の「PSK」が選択されている場合にのみ使用できます。|  [安全な自動登録](/manual/discovery/auto_registration#secure_autoregistration)も参照

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

en-us	 #### Autoregistration table cleared from orphaned records  Previously the `autoreg_host` table was never cleared. Now orphaned records that reference neither an autoregistration event nor an existing host will be removed by the Housekeeper.
ja	 #### 自動登録テーブルの孤立したレコードが消去されるように  以前は、`autoreg_host`テーブルがクリアされることはありませんでした。 自動登録イベントも既存のホストも参照しない孤立したレコードは、ハウスキーパーによって削除されるようになりました。

en-us	### Autoregistration  The autoregistration object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tls\_accept|integer|Type of allowed incoming connections for autoregistration.<br><br>Possible values:<br>1 - allow insecure connections;<br>2 - allow TLS with PSK.<br>3 - allow both insecure and TLS with PSK connections.| |tls\_psk\_identity|string|*(write-only)* PSK identity string.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |tls\_psk|string|*(write-only)* PSK value string (an even number of hexadecimal characters).|
ja	### Autoregistration  Autoregistration オブジェクトは、以下のプロパティを持つ。  |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |tls\_accept|integer|Type of allowed incoming connections for autoregistration.<br><br>Possible values:<br>1 - allow insecure connections;<br>2 - allow TLS with PSK.<br>3 - allow both insecure and TLS with PSK connections.| |tls\_psk\_identity|string|*(write-only)* PSK identity string.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |tls\_psk|string|*(write-only)* PSK value string (an even number of hexadecimal characters).|

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

en-us	# autoregistration.update
ja	# autoregistration.update

en-us	##### Average request count to Nginx server  View the average request count per second per day to the Nginx server:  -   add the request count per second item to the data set -   select the aggregate function `avg` and specify interval `1d` -   a bar graph is displayed, where each bar represents the average     number of requests per second per day
ja	##### Nginx サーバーへの平均リクエスト数  Nginx サーバーへの 1 日あたりの平均リクエスト数 (秒) を表示します。  -   データセットに秒間リクエスト数の item を追加します。 -   集約関数 `avg` を選択し、インターバル `1d` を指定します。 -   棒グラフが表示され、各棒は一日あたりの平均秒間リクエスト数を表します。

en-us	### Backward incompatible changes
ja	### 後方互換性のない変更点

en-us	#### Baseline monitoring Set of available baseline monitoring options has been extended with the two new functions **baselinedev** and **baselinewma**.  -   **baselinedev** - compares the last data period with the same data periods in preceding seasons and returns the number of deviations; -   **baselinewma** - calculates the baseline by averaging data from the same timeframe in multiple equal time periods ('seasons') using the weighted moving average algorithm.  In context of these functions, the term 'season' refers to a configurable timeframe, which could be hours, days, weeks, months or years. The length of a season and the number of seasons to analyse is set in function parameters.  See [history functions](/manual/appendix/functions/history) for more info.
ja	#### ベースライン監視 ベースライン監視のオプションが拡張され、**baselinedev**と**baselinewma**の2つの関数が追加されました。  -   **baselinedev** - 直近のデータ期間と、それ以前のシーズンの同じデータ期間を比較し、偏差の値を返します。 -   **baselinewma** - 加重移動平均アルゴリズムを使用して、複数の等しい期間('シーズン')の同じタイムフレームのデータを平均化することによりベースラインを計算します。  これらの機能において、'シーズン'という用語は、時間、日、週、月、年単位で設定可能な時間枠を指します。シーズンの長さと分析するシーズン数は、関数のパラメーターで設定します。  詳しくは、[ヒストリ関数](/manual/appendix/functions/history)を参照してください。

en-us	 #### Batch migration of history tables  * Prepare directories for Data Pump.  Data Pump must have read and write permissions to these directories.  Example:  ``` {.bash} mkdir -pv /export/history chown -R oracle:oracle /export ```  * Create a directory object and grant read and write permissions to this object to the user used for Zabbix authentication ('zabbix' in the example below). Under *sysdba* role, run:  ``` {.sql} create directory history as '/export/history'; grant read,write on directory history to zabbix; ```  * Export tables. Replace N with the desired thread count.  ``` {.bash} expdp zabbix/password@oracle_host/service \     DIRECTORY=history \     TABLES=history_old,history_uint_old,history_str_old,history_log_old,history_text_old \     PARALLEL=N ```  * Import tables. Replace N with the desired thread count.  ``` {.bash} impdp zabbix/password@oracle_host/service \     DIRECTORY=history \     TABLES=history_uint_old \  REMAP_TABLE=history_old:history,history_uint_old:history_uint,history_str_old:history_str,history_log_old:history_log,history_text_old:history_text \     data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND  PARALLEL=N CONTENT=data_only ```  * Follow [post-migration instructions](#after-migration) to drop the old tables.
ja	#### ヒストリテーブルの一括移行  * Data Pump 用のディレクトリを準備します。  Data Pump には、これらのディレクトリに対する読み取り権限と書き込み権限が必要です。  例:  ``` {.bash} mkdir -pv /export/history chown -R oracle:oracle /export ```  * ディレクトリ オブジェクトを作成し、Zabbix 認証に使用するユーザー (以下の例では'zabbix') に、このオブジェクトへの読み取りと書き込みのアクセス許可を付与します。 *sysdba* ロールの下で、次を実行します。  ``` {.sql} create directory history as '/export/history'; grant read,write on directory history to zabbix; ```  * テーブルをエクスポートします。 N を目的のスレッド数に置き換えます。  ``` {.bash} expdp zabbix/password@oracle_host/service \     DIRECTORY=history \     TABLES=history_old,history_uint_old,history_str_old,history_log_old,history_text_old \     PARALLEL=N ```  * テーブルをインポートします。 N を目的のスレッド数に置き換えます。  ``` {.bash} impdp zabbix/password@oracle_host/service \     DIRECTORY=history \     TABLES=history_uint_old \  REMAP_TABLE=history_old:history,history_uint_old:history_uint,history_str_old:history_str,history_log_old:history_log,history_text_old:history_text \     data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND  PARALLEL=N CONTENT=data_only ```  * [移行後の手順](#after-migration) に従って、古いテーブルを削除します。

en-us	# Best practices for secure Zabbix setup [comment]: # (tags: ssl)
ja	# Zabbixの安全なセットアップのためのベストプラクティス

en-us	#### Better navigation between item configuration and latest data  A new context menu for items has been introduced in *[Latest data](/manual/web_interface/frontend_sections/monitoring/latest_data)* allowing to access the item configuration and available graphs:  ![](../../../assets/en/manual/introduction/item_menu_latest.png)  Conversely, a new context menu has been introduced in the [item list](/manual/web_interface/frontend_sections/configuration/hosts/items) in configuration menu allowing to access the latest data for the item and other useful options:  ![](../../../assets/en/manual/introduction/item_menu_conf.png)  This menu replaces the wizard option in previous versions. A similar menu has  also been introduced for [template items](/manual/web_interface/frontend_sections/configuration/templates/items) and [item prototypes](/manual/discovery/low_level_discovery/item_prototypes).
ja	#### アイテム設定と最新データ間のナビゲーションの改善  *[最新データ](/manual/web_interface/frontend_sections/monitoring/latest_data)*に、アイテムのための新しいコンテキストメニューが導入され、アイテムの構成と利用可能なグラフにアクセスすることができるようになりました。  ![](../../../assets/en/manual/introduction/item_menu_latest.png)  逆に、[ホストのアイテム一覧](/manual/web_interface/frontend_sections/configuration/hosts/items) の設定メニューに新しいコンテキストメニューが導入され、最新のデータにアクセスすることができるようになりました。他にも便利なオプションがあります。  ![](../../../assets/en/manual/introduction/item_menu_conf.png)  このメニューは、以前のバージョンのウィザードオプションを置き換えたものです。 同様のメニューは、[テンプレートのアイテム](/manual/web_interface/frontend_sections/configuration/_templates/items) にも導入されています。 [アイテムのプロトタイプ](/Manual/discovery/low_level_discovery/item_prototypes)にも同様のメニューが導入されました。

en-us	## Breaking changes
ja	## 重大な変更

en-us	 ## Breaking changes
ja	 ## 重大な変更

en-us	 ## Breaking changes
ja	 ## 重大な変更

en-us	 ## Breaking changes
ja	 ## 重大な変更

en-us	 ### Breaking changes  #### Loadable plugin versioning  [Loadable plugins](/manual/config/items/plugins#loadable) for Zabbix agent 2 now use the same versioning system as Zabbix itself.  The following version changes have been made:  - MongoDB 1.2.0 -> MongoDB 6.0.13 - PostgreSQL 1.2.1 -> PostgreSQL 6.0.13  These plugins are supported for any minor version of Zabbix 6.0.  Note that source code repository for each plugin now contains a dedicated *release/6.0* branch (previously, there was only *master* branch).  
ja	 ### 重大な変更  #### 読み込み可能なプラグインのバージョン管理  Zabbix エージェント 2 で[読み込み可能なプラグイン](/manual/config/items/plugins#loadable) のバージョン管理システムは、Zabbix本体と同様のものを採用するようになりました。 これに伴うバージョン変更は次の通りです:  - MongoDB 1.2.0 -> MongoDB 6.0.13 - PostgreSQL 1.2.1 -> PostgreSQL 6.0.13  これらのプラグインは、Zabbix 6.0 のすべてのマイナーバージョンでサポートされています。 各プラグインのソースコードのレポジトリは、 専用の *release/6.0* ブランチをもつようになりました。 (変更前は、*master* ブランチのみ)

en-us	 ### Breaking changes  #### Loadable plugin versioning  [Loadable plugins](/manual/config/items/plugins#loadable) for Zabbix agent 2 now use the same versioning system as Zabbix itself. The following version changes have been made:  - MongoDB 1.2.0 -> MongoDB 6.0.13 - PostgreSQL 1.2.1 -> PostgreSQL 6.0.13  These plugins are supported for any minor version of Zabbix 6.0.  Note that source code repository for each plugin now contains a dedicated *release/6.0* branch (previously, there was only *master* branch).  
ja	### 重要な変更  #### ロード可能なプラグインのバージョン管理  Zabbixエージェント2の[ロード可能なプラグイン](/manual/config/items/plugins#loadable)は、Zabbix自体と同じバージョン管理システムを使用するようになり、次のバージョンに変更されました。  - MongoDB 1.2.0 -> MongoDB 6.0.13 - PostgreSQL 1.2.1 -> PostgreSQL 6.0.13  これらのプラグインは、Zabbix 6.0のマイナーバージョンでサポートされています。 各プラグインのソースコードリポジトリには、専用の*release/6.0*ブランチが含まれるようになりました (以前は*master*ブランチのみがありました)。

en-us	##### BSD systems  If `watch` command is not installed, a similar effect can be achieved with      while [ 1 ]; do ps x; sleep 0.2; clear; done
ja	##### BSD systems  `watch`コマンドがインストールされていない場合は、同様の効果が得られます      while [ 1 ]; do ps x; sleep 0.2; clear; done

en-us	##### Build 32bit PCRE  1\. Run:      mingw32-make clean  2\. Delete *CMakeCache.txt*:      del CMakeCache.txt     rmdir /q /s CMakeFiles  3\. Run cmake:      cmake -G "MinGW Makefiles" -DCMAKE_C_COMPILER=gcc -DCMAKE_C_FLAGS="-m32 -O2 -g" -DCMAKE_CXX_FLAGS="-m32 -O2 -g" -DCMAKE_EXE_LINKER_FLAGS="-Wl,-mi386pe" -DCMAKE_INSTALL_PREFIX=c:\dev\pcre32  4\. Next, run:      mingw32-make install
ja	##### 32bit版PCREのビルド  1. 次のコマンドを実行します:      mingw32-make clean  2. *CMakeCache.txt* を削除します:      del CMakeCache.txt <br>     rmdir /q /s CMakeFiles <br>  3. cmake を実行します:      cmake -G "MinGW Makefiles" -DCMAKE_C_COMPILER=gcc -DCMAKE_C_FLAGS="-m32 -O2 -g" -DCMAKE_CXX_FLAGS="-m32 -O2 -g" -DCMAKE_EXE_LINKER_FLAGS="-Wl,-mi386pe" -DCMAKE_INSTALL_PREFIX=c:\dev\pcre32  4. 次のコマンドを実行します:      mingw32-make install

en-us	##### Build 64bit PCRE  1\. Delete old configuration/cache if exists:      del CMakeCache.txt     rmdir /q /s CMakeFiles  2\. Run cmake (CMake can be installed from <https://cmake.org/download/>):      cmake -G "MinGW Makefiles" -DCMAKE_C_COMPILER=gcc -DCMAKE_C_FLAGS="-O2 -g" -DCMAKE_CXX_FLAGS="-O2 -g" -DCMAKE_INSTALL_PREFIX=c:\dev\pcre  3\. Next, run:      mingw32-make clean     mingw32-make install
ja	##### 64bit版PCREのビルド  1. 既存の configuration/cache がもし存在するならば削除します。      del CMakeCache.txt <br>     rmdir /q /s CMakeFiles <br>  2. cmake を実行します。(CMake は <https://cmake.org/download/> から入手できます):      cmake -G "MinGW Makefiles" -DCMAKE_C_COMPILER=gcc -DCMAKE_C_FLAGS="-O2 -g" -DCMAKE_CXX_FLAGS="-O2 -g" -DCMAKE_INSTALL_PREFIX=c:\dev\pcre  3. 次のコマンドを実行します:      mingw32-make clean <br>     mingw32-make install <br>

en-us	#### Building inventory
ja	#### インベントリの構築

en-us	##### - Building modules  Modules are currently meant to be built inside Zabbix source tree, because the module API depends on some data structures that are defined in Zabbix headers.  The most important header for loadable modules is **include/module.h**, which defines these data structures. Other necessary system headers that help **include/module.h** to work properly are **stdlib.h** and **stdint.h**.  With this information in mind, everything is ready for the module to be built. The module should include **stdlib.h**, **stdint.h** and **module.h**, and the build script should make sure that these files are in the include path. See example "dummy" module below for details.  Another useful header is **include/log.h**, which defines **zabbix\_log()** function, which can be used for logging and debugging purposes.
ja	##### モジュールのビルド  現在、モジュールはZabbixのソースツリー内でビルドされることになっています。<br> なぜなら、モジュールAPIはZabbixヘッダで定義されているいくつかのデータ構造に依存しているからです。<br>  ロード可能なモジュールにとって最も重要なヘッダーは、これらのデータ構造を定義している**include/module.h**です。<br> **include/module.h**が正しく動作するために必要な他のシステムヘッダは、**stdlib.h**と**stdint.h**です。<br>  この情報を頭に入れれば、モジュールをビルドするための準備はすべて整ったことになります。<br> モジュールは、**stdlib.h**、**stdint.h**、**module.h** が含まれている必要があり、ビルドスクリプトは、<br> これらのファイルがインクルードパスにあることを確認する必要があります。<br> 詳細については、以下の "ダミー" モジュールの例を参照してください。<br>  このヘッダには、ロギングとデバッグに使用できる **zabbix_log() ** 関数が定義されています<br>

en-us	### Built-in objects
ja	### 組込オブジェクト

en-us	 ##### Bulk processing  Bulk processing is supported for dependent items. To enable caching and indexing,  the *Prometheus pattern* preprocessing must be the **first** preprocessing step.  When *Prometheus pattern* is first preprocessing step then the parsed Prometheus  data is cached and indexed by the first `<label>==<value>` condition in the  *Prometheus pattern* preprocessing step. This cache is reused when processing  other dependent items in this batch. For optimal performance, the first label  should be the one with most different values.  If there is other preprocessing to be done before the first step, it should be  moved either to the master item or to a new dependent item which would be used as  the master item for the dependent items.
ja	 ##### バルクプロセッシング  依存 item はバルクプロセッシングに対応しています。<br> キャッシュとインデックスを有効にするには、*Prometheus pattern* のプリプロセスを **最初の** プリプロセスステップにする必要があります。<br> *Prometheus pattern* が最初のプリプロセスステップである場合、パースされた Prometheus データは、<br> *Prometheus pattern* プリプロセスステップの最初の `<label>==<value>` 条件によってキャッシュされ、インデックスが作成されます。 <br> このキャッシュは、このバッチ内の他の依存 item を処理する際に再利用されます。<br> 最適なパフォーマンスを得るために、最初のラベルは最も異なる値を持つものにすべきです。<br>  最初のステップの前に他のプリプロセスがある場合は、マスター item か、従属 item のマスター item として使用される<br> 新しい従属 item のどちらかに移動させる必要があります。

en-us	##### Bulk processing for Prometheus metrics  As bulk processing of dependent items has been introduced in the preprocessing  queue for Prometheus metrics, dependent items will no longer be processed in  parallel and that may have an affect on how fast they are processed.
ja	##### Prometheus メトリクスの一括処理  Prometheusメトリクスの前処理キューに、依存項目の一括処理が導入されたため、依存項目が並列処理されなくなり <br> 処理速度に影響が出る可能性があります。

en-us	#### Bulk processing for Prometheus metrics  Bulk processing of dependent items has been introduced in the preprocessing  queue to improve the performance of retrieving Prometheus metrics.  See [Prometheus checks](/manual/config/items/itemtypes/prometheus#bulk-processing) for more details.
ja	#### Prometheusメトリクスの一括処理  保存前処理キューに依存項目の一括処理を導入し、Prometheusメトリクスの検索性能を向上させました。  詳しくは[Prometheusのチェック](/manual/config/items/itemtypes/prometheus#bulk-processing) を参照してください。

en-us	##### Buttons  |   |   | |---|---| |![](../../../../../assets/en/manual/web_interface/button_clone.png)|Clone the service.<br>When a service is cloned, its parent links are preserved, while the child links are not.|
ja	##### ボタン  |   |   | |---|---| |![](../../../../../assets/en/manual/web_interface/button_clone.png)|サービスを複製します。<br>サービスを複製すると、その親リンクは保持されますが、子リンクは保持されません。|

en-us	##### Buttons  Buttons to the right offer the following options:  |   |   | |---|---| |![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/edit_map.png)|Go to map constructor to edit the map content.| |![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/add_to_fav1.png)|Add map to the favorites widget in the [Dashboard](dashboard).| |![](../../../../../assets/en/manual/web_interface/button_add_fav2.png)|The map is in the favorites widget in the [Dashboard](dashboard). Click to remove map from the favorites widget.|  View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page.
ja	##### ボタン  右側のボタンには、次のオプションがあります。  |   |   | |---|---| |![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/edit_map.png)|マップコンストラクターに移動して、マップコンテンツを編集します| |![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/add_to_fav1.png)|[ダッシュボード](dashboard)のお気に入りウィジェットにマップを追加します| |![](../../../../../assets/en/manual/web_interface/button_add_fav2.png)|マップは[ダッシュボード](dashboard)のお気に入りウィジェットに登録済みです。 クリックでお気に入りウィジェットからマップを削除します。|  すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。

en-us	##### Buttons  *Create host* allows to create a [new host](/manual/config/hosts/host). This button is available for Admin and Super Admin users only.  View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page.
ja	##### ボタン  *ホストの作成*では、[新しいホスト](/manual/config/hosts/host)を作成できます。 このボタンは、管理者およびスーパー管理者ユーザーのみが使用できます。  すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。

en-us	##### Buttons  The button to the right offers the following option:  |   |   | |---|---| |![](../../../../../assets/en/manual/web_interface/button_csv.png)|Export content from all pages to a CSV file.|  View mode buttons, being common for all sections, are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page.
ja	##### ボタン  右側のボタンには、次のオプションがあります。  |   |   | |---|---| |![](../../../../../assets/en/manual/web_interface/button_csv.png)|すべてのページコンテンツをCSVファイルにエクスポートします。|  すべてのセクション共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。

en-us	##### Buttons  View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page.
ja	##### ボタン  すべてのセクションで共通のビュー モード ボタンは、[モニタリング](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) ページに記載されています。

en-us	##### Buttons  View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page.
ja	##### ボタン  すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。

en-us	##### Buttons  View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page.
ja	##### ボタン  すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。

en-us	##### Buttons  View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page.
ja	##### ボタン  すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。

en-us	##### Buttons  View mode buttons, being common for all sections, are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page.
ja	##### ボタン  すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。

en-us	By default, the widget displays all enabled hosts with valid geographical coordinates defined in the host configuration. It is possible to configure host filtering in the widget parameters.  The valid host coordinates are:   - Latitude: from -90 to 90 (can be integer or float number)  - Longitude: from -180 to 180 (can be integer or float number) 
ja	デフォルトでは、ウィジェットはホスト設定で定義された有効な地理座標を持つすべての有効なホストを表示します。 ウィジェットパラメータでホストフィルタリングを設定することができます。  有効なホスト座標は次のとおりです。  - 緯度：-90〜90（整数または浮動小数点数） - 経度：-180から180まで（整数または浮動小数点数）

en-us	 #### Cache mode parameter for PostgreSQL plugin  New parameters for controlling the cache mode by default or on session name level have been added to the PostgreSQL plugin [configuration](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#parameters):  -   `Plugins.PostgreSQL.Default.CacheMode` -   `Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode`  The cache mode parameter may have one of two allowed values: *prepare* (default) or *describe*. Note that "describe" is primarily useful when the environment does not allow prepared statements such as when running a connection pooler like PgBouncer.
ja	 #### PostgreSQLプラグインのキャッシュモードパラメータ  PostgreSQLプラグイン[設定](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#parameters)にデフォルトまたはセッション名レベルでキャッシュモードを制御するための新しいパラメータが追加されました :  - `Plugins.PostgreSQL.Default.CacheMode` - `Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode`  キャッシュモードパラメータには、*prepare*(デフォルト)または*describe*という2つの許容値のいずれかを指定できます。"describe"は主に、PgBouncerのような接続プーリングサーバーを実行している場合など、環境で準備されたステートメントが許可されていない場合に便利です。

en-us	#### Calculated items  Calculated items now support not only numeric, but also **text**, **log**, and **character** types of information.
ja	#### 計算アイテムのデータ型  計算アイテムは、数値だけでなく、**テキスト**、**ログ**、**文字型**の情報にも対応しました。

en-us	#### Calculating SLI  Retrieve SLI data on services with IDs "50", "60" and "70" that are linked to the SLA with ID "5". Retrieve data for 3 periods starting from Nov 01, 2021.  Request:  ```json {     "jsonrpc": "2.0",     "method": "sla.getsli",     "params": {         "slaid": "5",         "serviceids": [             50,             60,             70         ],         "periods": 3,         "period_from": "1635724800"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "periods": [             {                 "period_from": 1635724800,                 "period_to": 1638316800             },             {                 "period_from": 1638316800,                 "period_to": 1640995200             },             {                 "period_from": 1640995200,                 "period_to": 1643673600             }         ],         "serviceids": [             50,             60,             70         ],         "sli": [             [                 {                     "uptime": 1186212,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1637836212,                             "period_to": 1638316800                         }                     ]                 },                 {                     "uptime": 1186212,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1637836212,                             "period_to": 1638316800                         }                     ]                 },                 {                     "uptime": 1186212,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1637836212,                             "period_to": 1638316800                         }                     ]                 }             ],             [                 {                     "uptime": 1147548,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1638439200,                             "period_to": 1639109652                         }                     ]                 },                 {                     "uptime": 1147548,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1638439200,                             "period_to": 1639109652                         }                     ]                 },                 {                     "uptime": 1147548,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1638439200,                             "period_to": 1639109652                         }                     ]                 }             ],             [                 {                     "uptime": 1674000,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": []                 },                 {                     "uptime": 1674000,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": []                 },                 {                     "uptime": 1674000,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": []                 }             ]         ]     },     "id": 1 } ```
ja	#### SLIの計算  ID"5"のSLAにリンクされているID"50"、"60"、"70"のサービスのSLIデータを取得します。 2021年11月1日から3期間のデータを取得します。  リクエスト :  ```json {     "jsonrpc": "2.0",     "method": "sla.getsli",     "params": {         "slaid": "5",         "serviceids": [             50,             60,             70         ],         "periods": 3,         "period_from": "1635724800"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  レスポンス :  ```json {     "jsonrpc": "2.0",     "result": {         "periods": [             {                 "period_from": 1635724800,                 "period_to": 1638316800             },             {                 "period_from": 1638316800,                 "period_to": 1640995200             },             {                 "period_from": 1640995200,                 "period_to": 1643673600             }         ],         "serviceids": [             50,             60,             70         ],         "sli": [             [                 {                     "uptime": 1186212,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1637836212,                             "period_to": 1638316800                         }                     ]                 },                 {                     "uptime": 1186212,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1637836212,                             "period_to": 1638316800                         }                     ]                 },                 {                     "uptime": 1186212,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1637836212,                             "period_to": 1638316800                         }                     ]                 }             ],             [                 {                     "uptime": 1147548,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1638439200,                             "period_to": 1639109652                         }                     ]                 },                 {                     "uptime": 1147548,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1638439200,                             "period_to": 1639109652                         }                     ]                 },                 {                     "uptime": 1147548,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": [                         {                             "name": "Excluded Downtime - 1",                             "period_from": 1638439200,                             "period_to": 1639109652                         }                     ]                 }             ],             [                 {                     "uptime": 1674000,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": []                 },                 {                     "uptime": 1674000,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": []                 },                 {                     "uptime": 1674000,                     "downtime": 0,                     "sli": 100,                     "error_budget": 0,                     "excluded_downtimes": []                 }             ]         ]     },     "id": 1 } ```

en-us	#### Calculation time  A trigger is recalculated every time Zabbix server receives a new value that is part of the expression. When a new value is received, each function that is included in the expression is recalculated (not just the one that received the new value).  Additionally, a trigger is recalculated each time when a new value is received **and** every 30 seconds if time-based functions are used in the expression.  Time-based functions are **nodata()**, **date()**, **dayofmonth()**, **dayofweek()**, **time()**, **now()**; they are recalculated every 30 seconds by the Zabbix history syncer process.  Triggers that reference trend functions **only** are evaluated once per  the smallest time period in the expression. See also [trend functions](/manual/appendix/functions/trends).
ja	#### 計算時間  Zabbixサーバーが式の一部である新しい値を受け取るたびに、トリガーが再計算されます。 新しい値を受け取ると、式に含まれる各関数が再計算されます (新しい値を受け取った関数だけではありません)。  さらに、式で時間ベースの関数が使用されている場合は、新しい値が受信されるたび、**および**30 秒ごとにトリガーが再計算されます。  時間ベースの関数は、**nodata()**、**date()**、**dayofmonth()**、**dayofweek()**、**time()**、**now() です。 **; これらは、Zabbix 履歴同期プロセスによって 30 秒ごとに再計算されます。  トレンド関数 **のみ** を参照するトリガーは、式の最小期間ごとに 1 回評価されます。 [トレンド関数](/manual/appendix/functions/trends)も参照してください。

en-us	#### Calculation time  A trigger is recalculated every time Zabbix server receives a new value that is part of the expression. When a new value is received, each function that is included in the expression is recalculated (not just the one that received the new value).  Additionally, a trigger is recalculated each time when a new value is received **and** every 30 seconds if time-based functions are used in the expression.  Time-based functions are **nodata()**, **date()**, **dayofmonth()**, **dayofweek()**, **time()**, **now()**); they are recalculated every 30 seconds by the Zabbix history syncer process.  Triggers that reference trend functions **only** are evaluated once per  the smallest time period in the expression. See also [trend functions](/manual/appendix/functions/trends).
ja	#### 計算時間  trigger は、Zabbix server が式の一部である新しい値を受信するたびに再計算されます。新しい値を受信すると、<br> 式に含まれる各関数が再計算されます(新しい値を受信した関数だけではありません)。<br>  さらに、trigger は新しい値が受信されるたびに再計算されます。**そして** 30秒ごとにも再計算されます。  時間ベースの関数は、**nodata()**、**date()**、**dayofmonth()**、**dayofweek()**、**time()**, **now()** です。<br>  これらはZabbixの history 同期処理により30秒ごとに再計算されます。  trend 関数のみを参照する trigger は、式中の最小の期間ごとに1回評価されます。 [trend functions](/manual/appendix/functions/trends)も参照してください。

en-us	### Ceph  |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |ceph.df.details\[connString,<user>,<apikey>\]|<|<|<| |Cluster’s data usage and distribution among pools.|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.| | |ceph.osd.stats\[connString,<user>,<apikey>\]|<|<|<| |Aggregated and per OSD statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.| | |ceph.osd.discovery\[connString,<user>,<apikey>\]|<|<|<| |List of discovered OSDs. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.| | |ceph.osd.dump\[connString,<user>,<apikey>\]|<|<|<| |Usage thresholds and statuses of OSDs.|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.| | |ceph.ping\[connString,<user>,<apikey>\]|<|<|<| |Tests whether a connection to Ceph can be established.|0 - connection is broken (if there is any error presented including AUTH and configuration issues)<br><br>1 - connection is successful.|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.| | |ceph.pool.discovery\[connString,<user>,<apikey>\]|<|<|<| |List of discovered pools. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.| | |ceph.status\[connString,<user>,<apikey>\]|<|<|<| |Overall cluster's status.|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.| |
ja	### Ceph  |キー|<|<|<| |--|--|------|------| |**説明**|**戻り値**|**パラメータ**|**コメント**| |ceph.df.details\[connString,<user>,<apikey>\]|<|<|<| |クラスターのデータ使用量とプール間の分散。|JSON オブジェクト|**connString** - URIまたはセッション名。<br>**user、password** - Ceph ログイン資格情報。| | |ceph.osd.stats\[connString,<user>,<apikey>\]|<|<|<| |集計された OSD ごとの統計。|JSON オブジェクト|**connString** - URIまたはセッション名。<br>**user、password** - Cephログイン資格情報。| | |ceph.osd.discovery\[connString,<user>,<apikey>\]|<|<|<| |検出されたOSDのリスト。[ローレベルディスカバリ](/manual/discovery/low_level_discovery)に使用されます。|JSONオブジェクト|**connString** - URIまたはセッション名。<br>**user、password** - Cephログイン認証情報。| | |ceph.osd.dump\[connString,<user>,<apikey>\]|<|<|<| |OSDの使用しきい値とステータス。|JSON オブジェクト|**connString** - URIまたはセッション名。<br>**user、password** - Cephログイン資格情報。| | |ceph.ping\[connString,<user>,<apikey>\]|<|<|<| |Cephへの接続を確立できるかどうかをテストします。|0 - 接続が切断されています (AUTHや構成の問題などのエラーが表示された場合)<br><br>1 - 接続が成功しています。|**connString** - URI またはセッション名。<br>**user、password** - Cephログイン資格情報。| | |ceph.pool.discovery\[connString,<user>,<apikey>\]|<|<|<| |検出されたプールのリスト。[ローレベルディスカバリ](/manual/discovery/low_level_discovery)に使用されます。|JSONオブジェクト|**connString** - URIまたはセッション名。<br>**user、password** - Cephログイン認証情報。| | |ceph.status\[connString,<user>,<apikey>\]|<|<|<| |クラスター全体のステータス。|JSONオブジェクト|**connString** - URIまたはセッション名。<br>**user、password** - Cephログイン資格情報。| |

en-us	#### Certificate Revocation Lists (CRL)  If a certificate is compromised CA can revoke it by including in CRL. CRLs can be configured in server, proxy and agent configuration file using parameter `TLSCRLFile`. For example:      TLSCRLFile=/home/zabbix/zabbix_crl_file  where `zabbix_crl_file` may contain CRLs from several CAs and look like:      -----BEGIN X509 CRL-----     MIIB/DCB5QIBATANBgkqhkiG9w0BAQUFADCBgTETMBEGCgmSJomT8ixkARkWA2Nv     ...     treZeUPjb7LSmZ3K2hpbZN7SoOZcAoHQ3GWd9npuctg=     -----END X509 CRL-----     -----BEGIN X509 CRL-----     MIIB+TCB4gIBATANBgkqhkiG9w0BAQUFADB/MRMwEQYKCZImiZPyLGQBGRYDY29t     ...     CAEebS2CND3ShBedZ8YSil59O6JvaDP61lR5lNs=     -----END X509 CRL-----  CRL file is loaded only on Zabbix start. CRL update requires restart.  ::: noteimportant  If Zabbix component is compiled with *OpenSSL* and CRLs are used then each top and intermediate level CA in certificate chains must have a corresponding CRL (it can be empty) in `TLSCRLFile`.  :::
ja	#### 証明書失効リスト(CRL)  証明書が漏洩した場合、CAはCRLに記載することで証明書を失効させることができます。CRL は server 、proxy、agent の コンフィギュレーションファイルで `TLSCRLFile` というパラメータを使って設定することができます。 例えば、以下のようになります:      TLSCRLFile=/home/zabbix/zabbix_crl_file  `zabbix_crl_file` には複数の CA の CRL が含まれ、以下のように表示されることがあります:      -----BEGIN X509 CRL-----     MIIB/DCB5QIBATANBgkqhkiG9w0BAQUFADCBgTETMBEGCgmSJomT8ixkARkWA2Nv     ...     treZeUPjb7LSmZ3K2hpbZN7SoOZcAoHQ3GWd9npuctg=     -----END X509 CRL-----     -----BEGIN X509 CRL-----     MIIB+TCB4gIBATANBgkqhkiG9w0BAQUFADB/MRMwEQYKCZImiZPyLGQBGRYDY29t     ...     CAEebS2CND3ShBedZ8YSil59O6JvaDP61lR5lNs=     -----END X509 CRL-----  CRLファイルは Zabbix 起動時のみ読み込まれます。CRLの更新には再起動が必要です  ::: noteimportant  Zabbixコンポーネントが*OpenSSL*でコンパイルされ、CRLを使用する場合、証明書チェーンのトップレベル及び<br> 中間レベルの各CAは、`TLSCRLFile`に対応するCRL(空でも可)を持つ必要があります。  :::

en-us	#### Change count  A new [history function](/manual/appendix/functions/history) **changecount()** has been added allowing to count the number of changes between adjacent values. The function supports three different modes for counting all changes, only decreases, or only increases. As an example, it can be used to track changes in the number of users or the number of system uptime decreases.
ja	#### 変更回数  新しい[ヒストリ関数](/manual/appendix/functions/history)として隣接する値間の変更回数を数えることができる**changecount()**が追加されました。 この関数は、すべての変更をカウントする、減少のみ、増加のみをカウントする3つの異なるモードをサポートしています。 例えば、ユーザー数の変化や、システム稼働時間の減少を追跡するために使用することができます。

en-us	#### Change dashboard owner  Available only for admins and super admins.  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "dashboard.update",     "params": {         "dashboardid": "2",         "userid": "1"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "2"         ]     },     "id": 2 } ```
ja	#### ダッシュボードの所有者を変更する  admins と super admins のみ利用可能です  Request:  ``` {.java} {     "jsonrpc": "2.0",     "method": "dashboard.update",     "params": {         "dashboardid": "2",         "userid": "1"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Response:  ``` {.java} {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "2"         ]     },     "id": 2 } ```

en-us	#### Change hosts monitored by a proxy  Update the proxy to monitor the two given hosts.  Request:  ```json {     "jsonrpc": "2.0",     "method": "proxy.update",     "params": {         "proxyid": "10293",         "hosts": [             {                 "hostid": "10294"             },             {                 "hostid": "10295"             },         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "10293"         ]     },     "id": 1 } ```
ja	#### プロキシが監視するホストの変更  指定された2つのホストを監視するようにプロキシを更新します。  リクエスト :  ```json {     "jsonrpc": "2.0",     "method": "proxy.update",     "params": {         "proxyid": "10293",         "hosts": [             {                 "hostid": "10294"             },             {                 "hostid": "10295"             },         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  レスポンス :  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "10293"         ]     },     "id": 1 } ```

en-us	#### Change map owner  Available only for admins and super admins.  Request:  ```json {     "jsonrpc": "2.0",     "method": "map.update",     "params": {         "sysmapid": "9",         "userid": "1"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "9"         ]     },     "id": 2 } ```
ja	#### マップの所有者変更  管理者とスーパー管理者のみが利用できます。  Request:  ```json {     "jsonrpc": "2.0",     "method": "map.update",     "params": {         "sysmapid": "9",         "userid": "1"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "9"         ]     },     "id": 2 } ```

en-us	#### Change proxy status  Change the proxy to an active proxy and rename it to "Active proxy".  Request:  ```json {     "jsonrpc": "2.0",     "method": "proxy.update",     "params": {         "proxyid": "10293",         "host": "Active proxy",         "status": "5"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "10293"         ]     },     "id": 1 } ```
ja	#### プロキシステータスの変更  プロキシをアクティブプロキシに変更し、名前を"Active proxy"に変更します。  リクエスト :  ```json {     "jsonrpc": "2.0",     "method": "proxy.update",     "params": {         "proxyid": "10293",         "host": "Active proxy",         "status": "5"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  レスポンス :  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "10293"         ]     },     "id": 1 } ```

en-us	#### Change script command  Change the command of the script to "/bin/ping -c 10 {HOST.CONN} 2>&1".  Request:  ```json {     "jsonrpc": "2.0",     "method": "script.update",     "params": {         "scriptid": "1",         "command": "/bin/ping -c 10 {HOST.CONN} 2>&1"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "1"         ]     },     "id": 1 } ```
ja	#### スクリプトコマンドの変更  スクリプトのコマンドを"/bin/ping -c 10 {HOST.CONN} 2>&1"に変更します。  Request:  ```json {     "jsonrpc": "2.0",     "method": "script.update",     "params": {         "scriptid": "1",         "command": "/bin/ping -c 10 {HOST.CONN} 2>&1"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "1"         ]     },     "id": 1 } ```

en-us	#### CHANGES IN 6.0.0
ja	#### 6.0.0での変更点