### ### # 10 Cookies used by Zabbix # 10 Zabbix用Cookie # 10 Discovery using WMI queries # 10 WMIクエリを使用した検出 # 10 Graph prototype # 10 グラフのプロトタイプ # 10 Graph prototype # 10 Graph prototype # 10 Inclusion # 10 インクルード # 10 Notes on selecting processes in proc.mem and proc.num items # 10 proc.memおよびproc.numアイテムでのプロセスの選択に関する注意 # 10 Notifications upon events # 10 イベント時の通知 # 10 Oracle plugin # 10 Oracleプラグイン # 10 Queue # 10 キュー # 10 Upgrade notes for 6.0.0 ::: noteimportant Zabbix 6.0.0 is not released yet. ::: These notes are for upgrading from Zabbix 5.4.x to Zabbix 6.0.0. All notes are grouped into: - `Critical` - the most critical information related to the upgrade process and the changes in Zabbix functionality - `Informational` - all remaining information describing the changes in Zabbix functionality It is possible to upgrade to Zabbix 6.0.0 from versions before Zabbix 5.4.0. See the [upgrade procedure](/manual/installation/upgrade) section for all relevant information about upgrading from previous Zabbix versions. # 10 Upgrade notes for 6.0.0 ​ ::: noteimportant Zabbix 6.0.0 is not released yet. ::: These notes are for upgrading from Zabbix 5.4.x to Zabbix 6.0.0. All notes are grouped into: - `Critical` - the most critical information related to the upgrade process and the changes in Zabbix functionality - `Informational` - all remaining information describing the changes in Zabbix functionality It is possible to upgrade to Zabbix 6.0.0 from versions before Zabbix 5.4.0. See the [upgrade procedure](/manual/installation/upgrade) section for all relevant information about upgrading from previous Zabbix versions. # 10 Upgrade notes for 6.0.0 These notes are for upgrading from Zabbix 5.4.x to Zabbix 6.0.0. All notes are grouped into: - `Critical` - the most critical information related to the upgrade process and the changes in Zabbix functionality - `Informational` - all remaining information describing the changes in Zabbix functionality It is possible to upgrade to Zabbix 6.0.0 from versions before Zabbix 5.4.0. See the [upgrade procedure](/manual/installation/upgrade) section for all relevant information about upgrading from previous Zabbix versions. # 10 6.0.0へアップグレード時の注意点 Zabbix 5.4.xからZabbix 6.0.0へのアップグレードに関する注意点です。 すべての注意点は以下のように分類されています。 - `重要 (Critical)` - アップグレードプロセスとZabbixの機能の変更に関連する最も重要な情報 - `情報提供 (Informational)` - Zabbixの機能の変更に関する残りのすべての情報 Zabbix 6.0.0は、Zabbix 5.4.0以前のバージョンからアップグレードすることができます。 以前のZabbixバージョンからのアップグレードに関するすべての情報については、[アップグレード手順](/manual/installation/upgrade)セクションをご覧ください。 # 10 Version compatibility # 10 バージョン間の互換性 # 10. Virtual machine monitoring # 10. 仮想マシン監視 # 10 What's new in Zabbix 6.0.5 # 10 Zabbix 6.0.5の新機能 # 10 Zabbix agent on Microsoft Windows # 10 Microsoft Windows上のZabbixエージェント # 11 Database error handling If Zabbix detects that the backend database is not accessible, it will send a notification message and continue the attempts to connect to the database. For some database engines, specific error codes are recognized. # 11 データベースエラー処理 Zabbixはバックエンドデータベースにアクセスできないことを検出すると、通知メッセージを送信し、データベース接続の試行を続けます。一部のデータベースエンジンでは、特定のエラーコードが検出されます。 # 11 Discovery using ODBC SQL queries # 11 ODBC SQLクエリを使用した検出 # 11 Host availability # 11 ホスト稼働状況 # 11 Implementation details of net.tcp.service and net.udp.service checks Implementation of net.tcp.service and net.udp.service checks is detailed on this page for various services specified in the service parameter. # 11 net.tcp.serviceおよびnet.udp.serviceチェックの実装の詳細 このページではnet.tcp.serviceおよびnet.udp.serviceチェック実装における、serviceパラメーターで指定されたさまざまなサービスについて詳しく説明しています。 # 11 Macros # 11 マクロ # 11. Maintenance # 11. メンテナンス # 11 PostgreSQL plugin # 11 PostgreSQLプラグイン # 11 SAML setup with Microsoft Entra ID # 11 Microsoft Entra IDを使用したSAMLの設定 # 11 Time zones # 11 タイムゾーン # 11 Upgrade notes for 6.0.1 # 11 6.0.1へアップグレード時の注意点 # 11 Value cache # 11 Value キャッシュ # 11 What's new in Zabbix 6.0.6 # 11 Zabbix 6.0.6の新機能 # 12 Discovery using Prometheus data # 12 Prometheusデータを使用した検出 # 12 Execute now # 12 監視データ取得 # 12 Item value # 12 アイテムの値 # 12 Item value # 12 Item value # 12 Redis plugin # 12 Redisプラグイン # 12. Regular expressions # 12. 正規表現 # 12 Resetting password # 12 パスワードのリセット # 12 Unreachable/unavailable host interface settings # 12 到達不能/使用不可のホストインターフェース設定 # 12 Upgrade notes for 6.0.2 This minor version doesn't have any upgrade notes. # 12 6.0.2へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 12 Users and user groups # 12 ユーザーとユーザーグループ # 12 What's new in Zabbix 6.0.7 # 12 Zabbix 6.0.7の新機能 # 12 Zabbix sender dynamic link library for Windows #### Overview In a Windows environment applications can send data to Zabbix server/proxy by using the Zabbix sender dynamic link library (zabbix\_sender.dll) instead of having to launch an external process (zabbix\_sender.exe). zabbix_sender.h and zabbix_sender.lib are required for compiling user applications with zabbix_sender.dll. #### Getting it There are two ways of getting zabbix_sender.dll. **1.** [Download](https://www.zabbix.com/download_agents) zabbix_sender.h, zabbix_sender.lib and zabbix_sender.dll files as a ZIP archive. When choosing download options make sure to select "No encryption" under *Encryption* and "Archive" under *Packaging*. Then download Zabbix agent (not Zabbix agent 2). The zabbix_sender.h, zabbix_sender.lib and zabbix_sender.dll files will be inside the downloaded ZIP archive in the `bin\dev` directory. Unzip the files where you need it. See also [known issues](/manual/installation/known_issues#missing-files-in-windows-agent-archive). **2.** Build zabbix_sender.dll from source (see [instructions](/manual/installation/install/win_agent#overview)). The dynamic link library with the development files will be located in the `bin\winXX\dev` directory. To use it, include the zabbix_sender.h header file and link with the zabbix_sender.lib library. #### See also - [example](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/build/win32/examples/zabbix_sender/sender.c) of a simple Zabbix sender utility implemented with Zabbix sender dynamic link library to illustrate the library usage; - [zabbix_sender.h](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/zabbix_sender/win32/zabbix_sender.h) file for the interface functions of the Zabbix sender dynamic link library. This file contains documentation explaining the purpose of each interface function, its arguments, and return value. # 12 Windows用のZabbix senderダイナミックリンクライブラリ #### 概要 Windows環境では、アプリケーションは外部プロセス(zabbix\_sender.exe)を起動する代わりに、Zabbix senderダイナミックリンクライブラリ(zabbix\_sender.dll)を使用して、Zabbixサーバー/プロキシにデータを直接送信できます。 zabbix_sender.hおよびzabbix_sender.libは、zabbix_sender.dllでユーザーアプリケーションをコンパイルするために必要です。 #### 取得方法 zabbix_sender.dllを取得するには2つの方法があります。 **1.** zabbix_sender.h、zabbix_sender.libおよびzabbix_sender.dllファイルをZIPアーカイブとして[ダウンロード](https://www.zabbix.com/download_agents)します。 ダウンロードオプションを選択するときは、*Encryption*で"No encryption"を選択し、*Packaging*で"Archive"を選択してください。次に、Zabbixエージェント(Zabbixエージェント2ではない)をダウンロードします。 zabbix_sender.h、zabbix_sender.libおよびzabbix_sender.dllファイルは、ダウンロードしたZIPアーカイブ内の`bin\dev`ディレクトリ内にあります。必要な場所でファイルを解凍します。 [既知の問題](/manual/installation/known_issues#missing-files-in-windows-agent-archive)も参照してください。 **2.** ソースからzabbix_sender.dllをビルドします ([説明書](/manual/installation/install/win_agent#overview)を参照してください)。 開発ファイルを備えた動的リンクライブラリは、`bin\winXX\dev`ディレクトリに配置されます。それを使用するには、ヘッダーファイルzabbix_sender.hを含め、ライブラリzabbix_sender.libにリンクします。 #### 参照 - ライブラリの使用法を示す、Zabbix senderダイナミックリンクライブラリを使用して実装された単純なZabbix senderユーティリティの[例](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/build/win32/examples/zabbix_sender/sender.c)。 - Zabbix senderダイナミックリンクライブラリのインターフェース関数のファイル[zabbix_sender.h](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/zabbix_sender/win32/zabbix_sender.h)。このファイルには、各インターフェース関数の目的、その引数、戻り値を説明するドキュメントが含まれています。 # 13 Discovery of block devices In a similar way as [file systems](/manual/discovery/low_level_discovery#configuring_low-level_discovery) are discovered, it is possible to also discover block devices and their type. # 13 ブロックデバイスの検出 [ファイルシステム](/manual/discovery/low_level_discovery#configuring_low-level_discovery)が検出されるのと同様の方法で、ブロックデバイスとそのタイプも検出できます。 # 13 Map # 13 Map # 13 Map # 13 マップ # 13. Problem acknowledgment # 13. 障害イベントの確認 # 13 Python library for Zabbix API # 13 Zabbix APIのPythonライブラリ # 13 Remote monitoring of Zabbix stats # 13 Zabbix統計のリモート監視 # 13 Restricting agent checks # 13 エージェントチェックの制限 # 13 SMART plugin # 13 SMARTプラグイン # 13 Storage of secrets # 13 secrets の保存 # 13 Upgrade notes for 6.0.3 This minor version doesn't have any upgrade notes. # 13 6.0.3へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 13 What's new in Zabbix 6.0.8 # 13 Zabbix 6.0.8の新機能 # 14 Configuration export/import # 14. 設定のエクスポート/インポート # 14 Configuring Kerberos with Zabbix # 14 Zabbixを使用したKerberosの設定 # 14 Discovery of host interfaces in Zabbix # 14 Zabbixでのホストインターフェース検出 # 14 Map navigation tree # 14 マップナビゲーション # 14 Map navigation tree # 14 Map navigation tree # 14 Plugins # 14 プラグイン # 14 Scheduled reports # 14 定期レポート # 14 Service monitoring upgrade # 14 サービス監視のアップグレード # 14 Upgrade notes for 6.0.4 This minor version doesn't have any upgrade notes. # 14 6.0.4へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 14 What's new in Zabbix 6.0.9 # 14 Zabbix 6.0.9の新機能 # 15 Discovery Please use the sidebar to access content in the Discovery section. # 15. ディスカバリ サイドバーから、参照したい項目を選択してください。 # 15 modbus.get parameters # 15 modbus.getパラメーター # 15 Other issues # 15 その他の問題 # 15 Plain text # 15 プレーンテキスト # 15 Plain text # 15 Plain text # 15 What's new in Zabbix 6.0.10 # 15 Zabbix 6.0.10の新機能 # 16 Creating custom performance counter names for VMware # 16 VMwareのカスタムパフォーマンスカウンター名作成 # 16 Distributed monitoring # 16. 分散監視 # 16 Issues with SELinux Socket-based inter-process communication has been added since Zabbix 3.4. On systems where SELinux is enabled it may be required to add SELinux rules to allow Zabbix create/use UNIX domain sockets in the `SocketDir` directory. Currently socket files are used by server (alerter, preprocessing, IPMI) and proxy (IPMI). Socket files are persistent, meaning are present while the process is running. # 16 SELinuxに関する問題 Zabbix 3.4以降、ソケットベースのプロセス間通信が追加されました。 SELinuxが有効になっているシステムでは、ZabbixがSocketDirディレクトリにUNIXドメインソケットを作成/使用できるようにするためにSELinuxルールを追加する必要がある場合があります。現在、ソケットファイルはサーバー（alerter, preprocessing, IPMI）およびプロキシ（IPMI）によって使用されています。socketファイルは永続的であり、プロセスの実行中は常に存在します。 # 16 Problem hosts # 16 障害中のホスト # 16 Problem hosts # 16 Problem hosts # 16 Upgrade notes for 6.0.6 # 16 6.0.6へアップグレード時の注意点 # 16 What's new in Zabbix 6.0.11 # 16 Zabbix 6.0.11の新機能 # 17. Encryption # 17. 暗号化 # 17 Escaping examples # 17 エスケープの例 # 17 Notes on system.cpu.util items on Windows # 17 Windowsのsystem.cpu.utilアイテムに関する注意事項 # 17 Problems # 17 障害 # 17 Problems # 17 Problems # 17 Prometheus checks # 17 Prometheus チェック # 17 Upgrade notes for 6.0.7 # 17 6.0.7へアップグレード時の注意点 # 17 What's new in Zabbix 6.0.12 # 17 Zabbix 6.0.12の新機能 # 18 Problems by severity # 18 Problems by severity # 18 Problems by severity # 18 深刻度ごとの障害数 # 18 Upgrade notes for 6.0.8 This minor version doesn't have any upgrade notes. # 18 6.0.8へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 18 Web interface # 18. Webインターフェース # 18 What's new in Zabbix 6.0.13 # 18 Zabbix 6.0.13の新機能 # 19. API # 19. API # 19 SLA report # 19 SLAレポート # 19 SLA report # 19 SLA report # 19 Upgrade notes for 6.0.9 This minor version doesn't have any upgrade notes. # 19 6.0.9へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 19 What's new in Zabbix 6.0.14 # 19 Zabbix 6.0.14の新機能 # 1 Action log # 1 アクションログ # 1 Additional JavaScript objects # 1 追加のJavaScriptオブジェクト # 1 Aggregate calculations # 1 集計計算 # 1 Best practices for secure Zabbix setup # 1 安全なZabbixセットアップのベストプラクティス # 1 Building loadable plugins # 1 ローダブルプラグインのビルド # 1 Building Zabbix agent on Windows # 1 WindowsでのZabbixエージェントのビルド # 1 Ceph plugin # 1 Cephプラグイン # 1 Compilation issues These are the known issues regarding Zabbix compilation from sources. For all other cases, see the [Known issues](/manual/installation/known_issues) page. # 1 コンパイルの問題 これらは、ソースからのZabbixコンパイルに関する既知の問題です。他のすべてのケースについては、[既知の問題](/manual/installation/known_issues)を参照してください。 # 1 Conditions # 1 アクション # 1 Configuring a host # 1 ホストの設定 # 1 Configuring a network discovery rule # 1 ネットワークディスカバリルールの設定 # 1 Configuring a network map # 1 ネットワークマップの設定 # 1 Configuring a template # 1 テンプレートの設定 # 1 Configuring a trigger # 1 トリガーの設定 # 1 Configuring a user # 1 ユーザの設定 # 1 Connection type or permission problems # 1 接続タイプまたは権限の問題 # 1 Creating an item # 1 アイテムの作成 # 1 Dashboard # 1 ダッシュボード # 1 Dashboard widgets # 1 ダッシュボードウィジェット # 1 Database creation # 1 データベースの作成 # 1 Debian/Ubuntu frontend installation # 1 Debian/UbuntuのWebインターフェースのインストール # 1 Discovery of mounted filesystems # 1 ファイルシステムマウントの検出 # 1 Dynamic indexes # 1 ダイナミックインデックス # 1 E-mail # 1 E-mail # 1 Escaping special characters from LLD macro values in JSONPath When low-level discovery macros are used in JSONPath preprocessing and their values are resolved, the following rules of escaping special characters are applied: - only backslash (\\) and double quote (") characters are considered for escaping; - if the resolved macro value contains these characters, each of them is escaped with a backslash; - if they are already escaped with a backslash, it is not considered as escaping and both the backslash and the following special characters are escaped once again. For example: |JSONPath|LLD macro value|After substitution| |--------|---------------|------------------| |$.\[?(@.value == "{\#MACRO}")\]|special "value"|$.\[?(@.value == "special \\"value\\"")\]| |^|c:\\temp|$.\[?(@.value == "c:\\\\temp")\]| |^|a\\\\b|$.\[?(@.value == "a\\\\\\\\b")\]| When used in the expression the macro that may have special characters should be enclosed in double quotes: |JSONPath|LLD macro value|After substitution|Result| |--------|--------|--------|--------| |$.\[?(@.value == "{\#MACRO}")\]|special "value"|$.\[?(@.value == "special \\"value\\"")\]|OK| |$.\[?(@.value == {\#MACRO})\]|^|$.\[?(@.value == special \\"value\\")\]|**Bad JSONPath expression**| When used in the path the macro that may have special characters should be enclosed in square brackets **and** double quotes: |JSONPath|LLD macro value|After substitution|Result| |--------|--------|--------|--------| |$.\["{\#MACRO}"\].value|c:\\temp|$.\["c:\\\\temp"\].value|OK| |$.{\#MACRO}.value|^|$.c:\\\\temp.value|**Bad JSONPath expression**| # 1 JSONPathのLLDマクロ値からの特殊文字のエスケープ ローレベルディスカバリマクロがJSONPathの保存前処理で使用され、その値が解決される場合、次の特殊文字のエスケープ規則が適用されます。 - バックスラッシュ(\\)と二重引用符(")文字のみがエスケープ対象として考慮されます。 - 解決されたマクロ値にこれらの文字が含まれている場合、それぞれの文字はバックスラッシュでエスケープされます。 - すでにバックスラッシュでエスケープされている場合は、エスケープとみなされず、バックスラッシュとそれに続く特殊文字の両方がさらにエスケープされます。 例: |JSONPath|LLDマクロの値|置換後| |--------|---------------|------------------| |$.\[?(@.value == "{\#MACRO}")\]|special "value"|$.\[?(@.value == "special \\"value\\"")\]| |^|c:\\temp|$.\[?(@.value == "c:\\\\temp")\]| |^|a\\\\b|$.\[?(@.value == "a\\\\\\\\b")\]| 式で使用する場合、特殊文字を含む可能性のあるマクロを二重引用符で囲む必要があります。 |JSONPath|LLDマクロの値|置換後|結果| |--------|--------|--------|--------| |$.\[?(@.value == "{\#MACRO}")\]|special "value"|$.\[?(@.value == "special \\"value\\"")\]|OK| |$.\[?(@.value == {\#MACRO})\]|^|$.\[?(@.value == special \\"value\\")\]|**不正なJSONPathの式**| 特殊文字を含むマクロをパスで使用する場合は、角括弧**と**二重引用符で囲む必要があります。 |JSONPath|LLDマクロの値|置換後|結果| |--------|--------|--------|--------| |$.\["{\#MACRO}"\].value|c:\\temp|$.\["c:\\\\temp"\].value|OK| |$.{\#MACRO}.value|^|$.c:\\\\temp.value|**不正なJSONPathの式**| # 1 Extending Zabbix agents This tutorial provides step-by-step instructions on how to extend the functionality of Zabbix agent with the use of a [user parameter](/manual/config/items/userparameters). # 1 Zabbixエージェントの機能拡張 このチュートリアルでは、[ユーザーパラメータ](/manual/config/items/userparameters)を使用してZabbixエージェントの機能を拡張する方法を段階的に説明します。 # 1 Foreach functions # 1 Foreach 関数 # 1 General # 1 一般設定 # 1 Getting Zabbix # 1 Zabbixの入手 # 1 Global notifications # 1 グローバル通知 # 1 Graphs # 1 グラフ # 1 Graphs # 1 グラフ # 1 High availability # 1 高可用性(HA) # 1 Host groups # 1 ホストグループ # 1 Host groups In the frontend host groups can be [exported](/manual/xml_export_import) only with host or template export. When a host or template is exported all groups it belongs to are exported with it automatically. API allows to export host groups independently from hosts or templates. # 1 ホストグループ Webインターフェースでは、ホストグループはホストまたはテンプレートのエクスポートでのみ[エクスポート](/manual/xml_export_import)できます。 ホストまたはテンプレートがエクスポートされると、それが属するすべてのグループも自動的にエクスポートされます。 APIを使用すると、ホストまたはテンプレートから独立してホストグループをエクスポートできます。 # 1 Hosts and host groups # 1 ホストとホストグループ # 1 Installation and setup Please use the sidebar to access content in this section. # 1 インストールとセットアップ サイドバーから、参照したい項目を選択してください。 # 1 Introduction Please use the sidebar to access content in the Introduction section. # 1. はじめに サイドバーから、参照したい項目を選択してください。 # 1 Item key format Item key format, including key parameters, must follow syntax rules. The following illustrations depict the supported syntax. Allowed elements and characters at each point can be determined by following the arrows - if some block can be reached through the line, it is allowed, if not - it is not allowed. {width="600"} To construct a valid item key, one starts with specifying the key name, then there's a choice to either have parameters or not - as depicted by the two lines that could be followed. # 1 アイテムキーのフォーマット キーパラメーターを含むアイテムキーのフォーマットは、構文規則に従う必要があります。次の図は、サポートされている構文を示しています。各ポイントで許可される要素と文字は、矢印に従って決定できます。矢印の先にあるブロックに到達できる場合は許可され、到達できない場合は許可されません。 {width="600"} 有効なアイテムキーを作成するには、キー名を指定し、次にパラメーターの有無を選択します。 # 1 Item keys specific to agent 2 # 1 Zabbixエージェント2固有のアイテムキー # 1 Item prototypes # 1 アイテムのプロトタイプ # 1 Item prototypes # 1 アイテムのプロトタイプ # 1 Item prototypes Once a rule is created, go to the items for that rule and press "Create item prototype" to create an item prototype. Note how macro {\#FSNAME} is used where a file system name is required. When the discovery rule is processed, this macro will be substituted with the discovered file system.  Low-level discovery [macros](/manual/config/macros/lld_macros) and user [macros](/manual/appendix/macros/supported_by_location_user) may be used in item prototype configuration and item value preprocessing [parameters](/manual/config/items/item#item_value_preprocessing). Note that when used in update intervals, a single macro has to fill the whole field. Multiple macros in one field or macros mixed with text are not supported. ::: noteclassic Context-specific escaping of low-level discovery macros is performed for safe use in regular expression and XPath preprocessing parameters. ::: Attributes that are specific for item prototypes: |Parameter|Description| |---------|-----------| |*Create enabled*|If checked the item will be added in an enabled state.<br>If unchecked, the item will be added to a discovered entity, but in a disabled state.| |*Discover*|If checked (default) the item will be added to a discovered entity.<br>If unchecked, the item will not be added to a discovered entity, unless this setting is [overridden](/manual/discovery/low_level_discovery#override) in the discovery rule.| We can create several item prototypes for each file system metric we are interested in:  *[Mass update](/manual/config/items/itemupdate#using_mass_update)* option is available if you want to update properties of several item prototypes at once. # 1 Item prototypes Once a rule is created, go to the items for that rule and press "Create item prototype" to create an item prototype. Note how macro {\#FSNAME} is used where a file system name is required. When the discovery rule is processed, this macro will be substituted with the discovered file system.  Low-level discovery [macros](/manual/config/macros/lld_macros) and user [macros](/manual/appendix/macros/supported_by_location_user) may be used in item prototype configuration and item value preprocessing [parameters](/manual/config/items/item#item_value_preprocessing). Note that when used in update intervals, a single macro has to fill the whole field. Multiple macros in one field or macros mixed with text are not supported. ::: noteclassic Context-specific escaping of low-level discovery macros is performed for safe use in regular expression and XPath preprocessing parameters. ::: Attributes that are specific for item prototypes: |Parameter|Description| |---------|-----------| |*Create enabled*|If checked the item will be added in an enabled state.<br>If unchecked, the item will be added to a discovered entity, but in a disabled state.| |*Discover*|If checked (default) the item will be added to a discovered entity.<br>If unchecked, the item will not be added to a discovered entity, unless this setting is [overridden](/manual/discovery/low_level_discovery#override) in the discovery rule.| We can create several item prototypes for each file system metric we are interested in:  *[Mass update](/manual/config/items/itemupdate#using_mass_update)* option is available if you want to update properties of several item prototypes at once. # 1 Items # 1 アイテム # 1 Items # 1 アイテム # 1 Items supported by platform The table displays support for Zabbix [agent items](/manual/config/items/itemtypes/zabbix_agent) on various platforms: - Items marked with "**X**" are supported, the ones marked with "**-**" are not supported. - If an item is marked with "**?**", it is not known whether it is supported or not. - If an item is marked with "**r**", it means that it requires root privileges. - Parameters that are included in angle brackets **<**like\_this**>** are optional. ::: noteclassic [Windows-only](/manual/config/items/itemtypes/zabbix_agent/win_keys) Zabbix agent items are not included in this table. ::: | | | | | | | | | | | | | | |---|---|---|---|---|---|---|---|---|---|---|---|---| |NetBSD|<|<|<|<|<|<|<|<|<|<|<|<| |OpenBSD|<|<|<|<|<|<|<|<|<|<|<|▼▼| |Mac OS X|<|<|<|<|<|<|<|<|<|<|▼▼|^| |Tru64|<|<|<|<|<|<|<|<|<|▼▼|^|^| |AIX|<|<|<|<|<|<|<|<|▼▼|^|^|^| |HP-UX|<|<|<|<|<|<|<|▼▼|^|^|^|^| |Solaris|<|<|<|<|<|<|▼▼|^|^|^|^|^| |FreeBSD|<|<|<|<|<|▼▼|^|^|^|^|^|^| |Linux 2.6 (and later)|<|<|<|<|▼▼|^|^|^|^|^|^|^| |Linux 2.4|<|<|<|▼▼|^|^|^|^|^|^|^|^| |Windows|<|<|▼▼|^|^|^|^|^|^|^|^|^| |Parameter / system|<|▼▼|^|^|^|^|^|^|^|^|^|^| |▼▼|<|1|2|3|4|5|6|7|8|9|10|11| |**agent.hostmetadata**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.hostname**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.ping**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.variant**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.version**|<|X|X|X|X|X|X|X|X|X|X|X| |**kernel.maxfiles**|<|\-|X|X|X|\-|\-|\-|?|X|X|X| |**kernel.maxproc**|<|\-|\-|X|X|X|\-|\-|?|X|X|X| |**kernel.openfiles**|<|\-|X|X|?|?|?|?|?|?|?|?| |**log\[file,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**log.count\[file,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**logrt\[file\_regexp,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**logrt.count\[file\_regexp,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**modbus.get\[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>\]**|<|X|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.dns\[<ip>,zone,<type>,<timeout>,<count>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.dns.record\[<ip>,zone,<type>,<timeout>,<count>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.if.collisions\[if\]**|<|\-|X|X|X|X|\-|X|\-|X|X|r| |**net.if.discovery**|<|X|X|X|X|X|X|X|\-|\-|X|X| |**net.if.in\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(default)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|X|\-|X|\-|\-|X|X|r| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|frame|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|multicast|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.if.out\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(default)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|\-|\-|X|\-|\-|\-|\-|\-| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|collision|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|carrier|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.if.total\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(default)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|\-|\-|X|\-|\-|\-|\-|\-| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.tcp.listen\[port\]**|<|X|X|X|X|X|\-|\-|\-|X|\-|\-| |**net.tcp.port\[<ip>,port\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.service\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.service.perf\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]**|<|X^**[7](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.udp.listen\[port\]**|<|\-|X|X|X|X|\-|\-|\-|X|\-|\-| |**net.udp.service\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.udp.service.perf\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.udp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]**|<|X^**[7](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**proc.cpu.util\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]**|<|\-|X|X|\-|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|\-|\-|\-|\-|\-|\-| |*type* ▲|total *(default)*|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|user|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|system|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |*mode* ▲|avg1 *(default)*|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |*zone* ▲|current *(default)*|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |^|all|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |**proc.mem\[<name>,<user>,<mode>,<cmdline><memtype>\]**|<|\-|X|X|X|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|\-|X|X|\-|X|X| |*mode* ▲|sum *(default)*|\-|X|X|X|X|\-|X|X|\-|X|X| |^|avg|\-|X|X|X|X|\-|X|X|\-|X|X| |^|max|\-|X|X|X|X|\-|X|X|\-|X|X| |^|min|\-|X|X|X|X|\-|X|X|\-|X|X| |*memtype* ▲|<|\-|X|X|X|X|\-|X|\-|\-|\-|\-| |**proc.num\[<name>,<user>,<state>,<cmdline>,<zone>\]**|<|X|X|X|X|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|\-|X|X| |*state* ▲|all *(default)*|\-|X|X|X|X|X|X|X|\-|X|X| |^|disk|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |^|sleep|\-|X|X|X|X|X|X|X|\-|X|X| |^|zomb|\-|X|X|X|X|X|X|X|\-|X|X| |^|run|\-|X|X|X|X|X|X|X|\-|X|X| |^|trace|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |*cmdline* ▲|<|\-|X|X|X|X|X|X|X|\-|X|X| |*zone* ▲|current *(default)*|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |^|all|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |**sensor\[device,sensor,<mode>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|X|\-| |**system.boottime**|<|\-|X|X|X|X|\-|\-|\-|X|X|X| |**system.cpu.discovery**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.cpu.intr**|<|\-|X|X|X|X|\-|X|\-|\-|X|X| |**system.cpu.load\[<cpu>,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*cpu* ▲|all *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|percpu|X|X|X|X|X|X|X|\-|X|X|X| |*mode* ▲|avg1 *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|avg5|X|X|X|X|X|X|X|X|X|X|X| |^|avg15|X|X|X|X|X|X|X|X|X|X|X| |**system.cpu.num\[<type>\]**|<|X|X|X|X|X|X|X|\-|X|X|X| |*type* ▲|online *(default)*|X|X|X|X|X|X|X|\-|X|X|X| |^|max|\-|X|X|X|X|\-|\-|\-|X|\-|\-| |**system.cpu.switches**|<|\-|X|X|X|X|\-|X|\-|\-|X|X| |**system.cpu.util\[<cpu>,<type>,<mode>,<logical\_or\_physical>\]**|<|X|X|X|X|X|X|X|X|\-|X|X| |*type* ▲|user *(default)*|\-|X|X|X|X|X|X|X|\-|X|X| |^|nice|\-|X|X|X|\-|X|\-|X|\-|X|X| |^|idle|\-|X|X|X|X|X|X|X|\-|X|X| |^|system *(default for Windows)*|X|X|X|X|X|X|X|X|\-|X|X| |^|iowait|\-|\-|X|\-|X|\-|X|\-|\-|\-|\-| |^|interrupt|\-|\-|X|X|\-|\-|\-|\-|\-|X|\-| |^|softirq|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|steal|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|guest|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|guest\_nice|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲|avg1 *(default)*|X|X|X|X|X|X|X|X|\-|X|X| |^|avg5|X|X|X|X|X|X|X|\-|\-|X|X| |^|avg15|X|X|X|X|X|X|X|\-|\-|X|X| |*logical\_or\_physical* ▲|logical *(default)*|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |^|physical|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**system.hostname\[<type>,<transform>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.hw.chassis\[<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.cpu\[<cpu>,<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.devices\[<type>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.macaddr\[<interface>,<format>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.localtime\[<type>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*type* ▲|utc *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|local|X|X|X|X|X|X|X|X|X|X|X| |**system.run\[command,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|wait *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|nowait|X|X|X|X|X|X|X|X|X|X|X| |**system.stat\[resource,<type>\]**|<|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |**system.sw.arch**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.sw.os\[<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.sw.packages\[<package>,<manager>,<format>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.swap.in\[<device>,<type>\]**<br>*(specifying a device is only supported under Linux)*|<|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |*type* ▲<br>*(pages will only work if<br>device was not specified)*|count *(default under all except Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |^|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|pages *(default under Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |**system.swap.out\[<device>,<type>\]**<br>*(specifying a device is only supported under Linux)*|<|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |*type* ▲<br>*(pages will only work if<br>device was not specified)*|count *(default under all except Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |^|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|pages *(default under Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |**system.swap.size\[<device>,<type>\]**<br>*(specifying a device is only supported under FreeBSD, for other platforms must be empty or "all")*|<|X|X|X|X|X|\-|X|X|\-|X|\-| |*type* ▲|free *(default)*|X|X|X|X|X|\-|X|X|\-|X|\-| |^|total|X|X|X|X|X|\-|X|X|\-|X|\-| |^|used|X|X|X|X|X|\-|X|X|\-|X|\-| |^|pfree|X|X|X|X|X|\-|X|X|\-|X|\-| |^|pused|X ^**[6](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|\-|X|X|\-|X|\-| |**system.uname**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.uptime**|<|X|X|X|X|X|\-|X|?|X|X|X| |**system.users.num**|<|\-|X|X|X|X|X|X|X|X|X|X| |**systemd.unit.discovery**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**systemd.unit.get**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**systemd.unit.info**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**vfs.dev.discovery**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**vfs.dev.read\[<device>,<type>,<mode>\]**|<|\-|X|X|X|X|\-|X|\-|\-|X|\-| |*type* ▲|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|operations *(default for OpenBSD, AIX)*|\-|X|X|X|X|\-|X|\-|\-|X|\-| |^|bytes *(default for Solaris)*|\-|\-|\-|X|X|\-|X|\-|\-|X|\-| |^|sps *(default for Linux)*|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|ops|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|bps *(default for FreeBSD)*|\-|\-|\-|X|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲<br>*(compatible only with<br>type in: sps, ops, bps)*|avg1 *(default)*|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |**vfs.dev.write\[<device>,<type>,<mode>\]**|<|\-|X|X|X|X|\-|X|\-|\-|X|\-| |*type* ▲|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|operations *(default for OpenBSD, AIX)*|\-|X|X|X|X|\-|X|\-|\-|X|\-| |^|bytes *(default for Solaris)*|\-|\-|\-|X|X|\-|X|\-|\-|X|\-| |^|sps *(default for Linux)*|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|ops|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|bps *(default for FreeBSD)*|\-|\-|\-|X|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲<br>*(compatible only with<br>type in: sps, ops, bps)*|avg1 *(default)*|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |**vfs.dir.count\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.dir.get\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.dir.size\[dir,<regex\_incl>,<regex\_excl>,<mode>,<max\_depth>,<regex\_excl\_dir>\]**|<|X|X|X|?|?|?|?|?|?|?|?| |**vfs.file.cksum\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.contents\[file,<encoding>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.exists\[file,<types\_incl>,<types\_excl>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.get\[file\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.md5sum\[file\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.owner\[file,<ownertype>,<resulttype>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.permissions\[file\]**|<|\-|X|X|?|?|?|?|?|?|?|?| |**vfs.file.regexp\[file,regexp,<encoding>,<output>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.regmatch\[file,regexp,<encoding>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.size\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**vfs.file.time\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|modify *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|access|X|X|X|X|X|X|X|X|X|X|X| |^|change|X^**[5](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |**vfs.fs.discovery**|<|X|X|X|X|X|X|X|\-|X|X|X| |**vfs.fs.get**|<|X|X|X|X|X|X|X|\-|X|X|X| |**vfs.fs.inode\[fs,<mode>\]**|<|\-|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(default)*|\-|X|X|X|X|X|X|X|X|X|X| |^|free|\-|X|X|X|X|X|X|X|X|X|X| |^|used|\-|X|X|X|X|X|X|X|X|X|X| |^|pfree|\-|X|X|X|X|X|X|X|X|X|X| |^|pused|\-|X|X|X|X|X|X|X|X|X|X| |**vfs.fs.size\[fs,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|free|X|X|X|X|X|X|X|X|X|X|X| |^|used|X|X|X|X|X|X|X|X|X|X|X| |^|pfree|X|X|X|X|X|X|X|X|X|X|X| |^|pused|X|X|X|X|X|X|X|X|X|X|X| |**vm.memory.size\[<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|active|\-|\-|\-|X|\-|X|\-|\-|X|X|X| |^|anon|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|buffers|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |^|cached|X|X|X|X|\-|\-|X|\-|\-|X|X| |^|exec|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|file|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|free|X|X|X|X|X|X|X|X|X|X|X| |^|inactive|\-|\-|\-|X|\-|\-|\-|\-|X|X|X| |^|pinned|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |^|shared|\-|X|\-|X|\-|\-|\-|\-|\-|X|X| |^|wired|\-|\-|\-|X|\-|\-|\-|\-|X|X|X| |^|used|X|X|X|X|X|X|X|X|X|X|X| |^|pused|X|X|X|X|X|X|X|X|X|X|X| |^|available|X|X|X|X|X|X|X|X|X|X|X| |^|pavailable|X|X|X|X|X|X|X|X|X|X|X| |**web.page.get\[host,<path>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**web.page.perf\[host,<path>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**web.page.regexp\[host,<path>,<port>,regexp,<length>,<output>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |<|<|1|2|3|4|5|6|7|8|9|10|11| ::: notetip See also a description of [vm.memory.size parameters](vm.memory.size_params). ::: # 1 Items supported by platform The table displays support for Zabbix [agent items](/manual/config/items/itemtypes/zabbix_agent) on various platforms: - Items marked with "**X**" are supported, the ones marked with "**-**" are not supported. - If an item is marked with "**?**", it is not known whether it is supported or not. - If an item is marked with "**r**", it means that it requires root privileges. - Parameters that are included in angle brackets **<**like\_this**>** are optional. ::: noteclassic [Windows-only](/manual/config/items/itemtypes/zabbix_agent/win_keys) Zabbix agent items are not included in this table. ::: | | | | | | | | | | | | | | |---|---|---|---|---|---|---|---|---|---|---|---|---| |NetBSD|<|<|<|<|<|<|<|<|<|<|<|<| |OpenBSD|<|<|<|<|<|<|<|<|<|<|<|▼▼| |Mac OS X|<|<|<|<|<|<|<|<|<|<|▼▼|^| |Tru64|<|<|<|<|<|<|<|<|<|▼▼|^|^| |AIX|<|<|<|<|<|<|<|<|▼▼|^|^|^| |HP-UX|<|<|<|<|<|<|<|▼▼|^|^|^|^| |Solaris|<|<|<|<|<|<|▼▼|^|^|^|^|^| |FreeBSD|<|<|<|<|<|▼▼|^|^|^|^|^|^| |Linux 2.6 (and later)|<|<|<|<|▼▼|^|^|^|^|^|^|^| |Linux 2.4|<|<|<|▼▼|^|^|^|^|^|^|^|^| |Windows|<|<|▼▼|^|^|^|^|^|^|^|^|^| |Parameter / system|<|▼▼|^|^|^|^|^|^|^|^|^|^| |▼▼|<|1|2|3|4|5|6|7|8|9|10|11| |**agent.hostmetadata**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.hostname**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.ping**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.variant**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.version**|<|X|X|X|X|X|X|X|X|X|X|X| |**kernel.maxfiles**|<|\-|X|X|X|\-|\-|\-|?|X|X|X| |**kernel.maxproc**|<|\-|\-|X|X|X|\-|\-|?|X|X|X| |**kernel.openfiles**|<|\-|X|X|?|?|?|?|?|?|?|?| |**log\[file,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |**log.count\[file,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |**logrt\[file\_regexp,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |**logrt.count\[file\_regexp,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |**modbus.get\[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>\]**|<|X|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.dns\[<ip>,zone,<type>,<timeout>,<count>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.dns.record\[<ip>,zone,<type>,<timeout>,<count>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.if.collisions\[if\]**|<|\-|X|X|X|X|\-|X|\-|X|X|r| |**net.if.discovery**|<|X|X|X|X|X|X|X|\-|\-|X|X| |**net.if.in\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(default)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|X|\-|X|\-|\-|X|X|r| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|frame|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|multicast|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.if.out\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(default)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|\-|\-|X|\-|\-|\-|\-|\-| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|collision|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|carrier|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.if.total\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(default)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|\-|\-|X|\-|\-|\-|\-|\-| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.tcp.listen\[port\]**|<|X|X|X|X|X|\-|\-|\-|X|\-|\-| |**net.tcp.port\[<ip>,port\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.service\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.service.perf\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]**|<|X^**[7](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.udp.listen\[port\]**|<|\-|X|X|X|X|\-|\-|\-|X|\-|\-| |**net.udp.service\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.udp.service.perf\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.udp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]**|<|X^**[7](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**proc.cpu.util\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]**|<|\-|X|X|\-|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|\-|\-|\-|\-|\-|\-| |*type* ▲|total *(default)*|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|user|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|system|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |*mode* ▲|avg1 *(default)*|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |*zone* ▲|current *(default)*|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |^|all|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |**proc.mem\[<name>,<user>,<mode>,<cmdline><memtype>\]**|<|\-|X|X|X|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|\-|X|X|\-|X|X| |*mode* ▲|sum *(default)*|\-|X|X|X|X|\-|X|X|\-|X|X| |^|avg|\-|X|X|X|X|\-|X|X|\-|X|X| |^|max|\-|X|X|X|X|\-|X|X|\-|X|X| |^|min|\-|X|X|X|X|\-|X|X|\-|X|X| |*memtype* ▲|<|\-|X|X|X|X|\-|X|\-|\-|\-|\-| |**proc.num\[<name>,<user>,<state>,<cmdline>,<zone>\]**|<|X|X|X|X|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|\-|X|X| |*state* ▲|all *(default)*|\-|X|X|X|X|X|X|X|\-|X|X| |^|disk|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |^|sleep|\-|X|X|X|X|X|X|X|\-|X|X| |^|zomb|\-|X|X|X|X|X|X|X|\-|X|X| |^|run|\-|X|X|X|X|X|X|X|\-|X|X| |^|trace|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |*cmdline* ▲|<|\-|X|X|X|X|X|X|X|\-|X|X| |*zone* ▲|current *(default)*|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |^|all|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |**sensor\[device,sensor,<mode>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|X|\-| |**system.boottime**|<|\-|X|X|X|X|\-|\-|\-|X|X|X| |**system.cpu.discovery**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.cpu.intr**|<|\-|X|X|X|X|\-|X|\-|\-|X|X| |**system.cpu.load\[<cpu>,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*cpu* ▲|all *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|percpu|X|X|X|X|X|X|X|\-|X|X|X| |*mode* ▲|avg1 *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|avg5|X|X|X|X|X|X|X|X|X|X|X| |^|avg15|X|X|X|X|X|X|X|X|X|X|X| |**system.cpu.num\[<type>\]**|<|X|X|X|X|X|X|X|\-|X|X|X| |*type* ▲|online *(default)*|X|X|X|X|X|X|X|\-|X|X|X| |^|max|\-|X|X|X|X|\-|\-|\-|X|\-|\-| |**system.cpu.switches**|<|\-|X|X|X|X|\-|X|\-|\-|X|X| |**system.cpu.util\[<cpu>,<type>,<mode>,<logical\_or\_physical>\]**|<|X|X|X|X|X|X|X|X|\-|X|X| |*type* ▲|user *(default)*|\-|X|X|X|X|X|X|X|\-|X|X| |^|nice|\-|X|X|X|\-|X|\-|X|\-|X|X| |^|idle|\-|X|X|X|X|X|X|X|\-|X|X| |^|system *(default for Windows)*|X|X|X|X|X|X|X|X|\-|X|X| |^|iowait|\-|\-|X|\-|X|\-|X|\-|\-|\-|\-| |^|interrupt|\-|\-|X|X|\-|\-|\-|\-|\-|X|\-| |^|softirq|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|steal|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|guest|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|guest\_nice|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲|avg1 *(default)*|X|X|X|X|X|X|X|X|\-|X|X| |^|avg5|X|X|X|X|X|X|X|\-|\-|X|X| |^|avg15|X|X|X|X|X|X|X|\-|\-|X|X| |*logical\_or\_physical* ▲|logical *(default)*|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |^|physical|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**system.hostname\[<type>,<transform>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.hw.chassis\[<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.cpu\[<cpu>,<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.devices\[<type>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.macaddr\[<interface>,<format>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.localtime\[<type>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*type* ▲|utc *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|local|X|X|X|X|X|X|X|X|X|X|X| |**system.run\[command,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|wait *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|nowait|X|X|X|X|X|X|X|X|X|X|X| |**system.stat\[resource,<type>\]**|<|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |**system.sw.arch**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.sw.os\[<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.sw.packages\[<package>,<manager>,<format>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.swap.in\[<device>,<type>\]**<br>*(specifying a device is only supported under Linux)*|<|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |*type* ▲<br>*(pages will only work if<br>device was not specified)*|count *(default under all except Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |^|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|pages *(default under Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |**system.swap.out\[<device>,<type>\]**<br>*(specifying a device is only supported under Linux)*|<|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |*type* ▲<br>*(pages will only work if<br>device was not specified)*|count *(default under all except Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |^|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|pages *(default under Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |**system.swap.size\[<device>,<type>\]**<br>*(specifying a device is only supported under FreeBSD, for other platforms must be empty or "all")*|<|X|X|X|X|X|\-|X|X|\-|X|\-| |*type* ▲|free *(default)*|X|X|X|X|X|\-|X|X|\-|X|\-| |^|total|X|X|X|X|X|\-|X|X|\-|X|\-| |^|used|X|X|X|X|X|\-|X|X|\-|X|\-| |^|pfree|X|X|X|X|X|\-|X|X|\-|X|\-| |^|pused|X ^**[6](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|\-|X|X|\-|X|\-| |**system.uname**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.uptime**|<|X|X|X|X|X|\-|X|?|X|X|X| |**system.users.num**|<|\-|X|X|X|X|X|X|X|X|X|X| |**systemd.unit.discovery**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**systemd.unit.get**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**systemd.unit.info**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**vfs.dev.discovery**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**vfs.dev.read\[<device>,<type>,<mode>\]**|<|\-|X|X|X|X|\-|X|\-|\-|X|\-| |*type* ▲|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|operations *(default for OpenBSD, AIX)*|\-|X|X|X|X|\-|X|\-|\-|X|\-| |^|bytes *(default for Solaris)*|\-|\-|\-|X|X|\-|X|\-|\-|X|\-| |^|sps *(default for Linux)*|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|ops|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|bps *(default for FreeBSD)*|\-|\-|\-|X|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲<br>*(compatible only with<br>type in: sps, ops, bps)*|avg1 *(default)*|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |**vfs.dev.write\[<device>,<type>,<mode>\]**|<|\-|X|X|X|X|\-|X|\-|\-|X|\-| |*type* ▲|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|operations *(default for OpenBSD, AIX)*|\-|X|X|X|X|\-|X|\-|\-|X|\-| |^|bytes *(default for Solaris)*|\-|\-|\-|X|X|\-|X|\-|\-|X|\-| |^|sps *(default for Linux)*|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|ops|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|bps *(default for FreeBSD)*|\-|\-|\-|X|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲<br>*(compatible only with<br>type in: sps, ops, bps)*|avg1 *(default)*|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |**vfs.dir.count\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.dir.get\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.dir.size\[dir,<regex\_incl>,<regex\_excl>,<mode>,<max\_depth>,<regex\_excl\_dir>\]**|<|X|X|X|?|?|?|?|?|?|?|?| |**vfs.file.cksum\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.contents\[file,<encoding>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.exists\[file,<types\_incl>,<types\_excl>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.get\[file\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.md5sum\[file\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.owner\[file,<ownertype>,<resulttype>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.permissions\[file\]**|<|\-|X|X|?|?|?|?|?|?|?|?| |**vfs.file.regexp\[file,regexp,<encoding>,<output>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.regmatch\[file,regexp,<encoding>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.size\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**vfs.file.time\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|modify *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|access|X|X|X|X|X|X|X|X|X|X|X| |^|change|X^**[5](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |**vfs.fs.discovery**|<|X|X|X|X|X|X|X|\-|X|X|X| |**vfs.fs.get**|<|X|X|X|X|X|X|X|\-|X|X|X| |**vfs.fs.inode\[fs,<mode>\]**|<|\-|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(default)*|\-|X|X|X|X|X|X|X|X|X|X| |^|free|\-|X|X|X|X|X|X|X|X|X|X| |^|used|\-|X|X|X|X|X|X|X|X|X|X| |^|pfree|\-|X|X|X|X|X|X|X|X|X|X| |^|pused|\-|X|X|X|X|X|X|X|X|X|X| |**vfs.fs.size\[fs,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|free|X|X|X|X|X|X|X|X|X|X|X| |^|used|X|X|X|X|X|X|X|X|X|X|X| |^|pfree|X|X|X|X|X|X|X|X|X|X|X| |^|pused|X|X|X|X|X|X|X|X|X|X|X| |**vm.memory.size\[<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|active|\-|\-|\-|X|\-|X|\-|\-|X|X|X| |^|anon|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|buffers|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |^|cached|X|X|X|X|\-|\-|X|\-|\-|X|X| |^|exec|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|file|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|free|X|X|X|X|X|X|X|X|X|X|X| |^|inactive|\-|\-|\-|X|\-|\-|\-|\-|X|X|X| |^|pinned|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |^|shared|\-|X|\-|X|\-|\-|\-|\-|\-|X|X| |^|wired|\-|\-|\-|X|\-|\-|\-|\-|X|X|X| |^|used|X|X|X|X|X|X|X|X|X|X|X| |^|pused|X|X|X|X|X|X|X|X|X|X|X| |^|available|X|X|X|X|X|X|X|X|X|X|X| |^|pavailable|X|X|X|X|X|X|X|X|X|X|X| |**web.page.get\[host,<path>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**web.page.perf\[host,<path>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**web.page.regexp\[host,<path>,<port>,regexp,<length>,<output>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |<|<|1|2|3|4|5|6|7|8|9|10|11| ::: notetip See also a description of [vm.memory.size parameters](vm.memory.size_params). ::: # 1 Login and configuring user # 1 ログインとユーザー設定 # 1 Macro functions # 1 マクロ関数 # 1 Manual structure # 1 マニュアルの構成 # 1 Media types # 1 メディアタイプ # 1 Menu # 1 メニュー # 1 Monitoring # 1 監視データ # 1 MySQL encryption configuration [comment]: # (tags: ssl) # 1 MySQLの暗号化設定 [comment]: # (tags: ssl) # 1 Network discovery # 1 ネットワークディスカバリ # 1 Overview # 1 概要 # 1 Proxies # 1 プロキシ # 1 Recommended UnixODBC settings for MySQL # 1 MySQLの推奨UnixODBC設定 # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux/CentOS # 1 Red Hat Enterprise Linux/CentOS # 1 Sending message # 1 メッセージの送信 # 1 Server # 1 Zabbixサーバー # 1 Server-proxy data exchange protocol # 1 サーバープロキシデータ交換プロトコル # 1 Services # 1 サービス # 1 Services # 1 サービス # 1 Service tree Service tree is configured in the *Services->Services* menu section. In the upper right corner, switch from [View](/manual/web_interface/frontend_sections/services/service) to the Edit mode. {width=600} To [configure](#service_configuration) a new service, click on the *Create service* button in the top right-hand corner. To quickly add a child service, you can alternatively press a plus icon next to the parent service. This will open the same service configuration form, but the Parent services parameter will be pre-filled. # 1 サービスツリー サービスツリーは、*Services->Services*メニューセクションで設定できます。右上隅で、[view](/manual/web_interface/frontend_sections/services/service)モードからEditモードに切り替えます。 {width=600} 新しいサービスを[設定](#service_configuration)するには、右上隅にある*Create service*ボタンをクリックします。 子サービスをすばやく追加するには、親サービスの横にあるプラスアイコンを押すこともできます。これにより親サービスパラメーターが事前に入力されたサービス構成フォームを開くことができます。 # 1 Simple graphs # 1 シンプルグラフ ##### 1 Stop agent Stop Zabbix agent. ##### 1 エージェントの停止 Zabbixエージェントを停止します。 ##### 1 Stop proxy Stop Zabbix proxy. ##### 1 プロキシのを停止 Zabbixプロキシを停止します。 ##### 1 Stop server Stop Zabbix server to make sure that no new data is inserted into database. ##### 1 Zabbixプロセスの停止 Zabbixサーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。 ##### 1 Stop Zabbix processes Stop Zabbix server to make sure that no new data is inserted into database. # systemctl stop zabbix-server If upgrading the proxy, stop proxy too. # systemctl stop zabbix-proxy ::: noteimportant It is no longer possible to start the upgraded server and have older, yet unupgraded proxies report data to a newer server. This approach, which was never recommended nor supported by Zabbix, now is officially disabled, as the server will ignore data from unupgraded proxies. ::: ##### 1 Zabbixプロセスの停止 Zabbixサーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。 # systemctl stop zabbix-server プロキシもアップグレードする場合は、プロキシも停止します。 # systemctl stop zabbix-proxy ::: noteimportant アップグレードされたサーバーにアップグレードされていないプロキシがデータを報告することはできなくなりました。このアプローチはZabbixによって推奨もサポートもされていませんでしたが、現在は正式に無効になっています。 ::: ##### 1 Stop Zabbix processes Stop Zabbix server to make sure that no new data is inserted into database. systemctl stop zabbix-server If upgrading Zabbix proxy, agent, or agent 2, stop these components too: systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ##### 1 Zabbixプロセスの停止 Zabbixサーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。 systemctl stop zabbix-server Zabbixプロキシやエージェント、エージェント2もアップグレードする場合は、同様に停止します。 systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ##### 1 Stop Zabbix processes Stop Zabbix server to make sure that no new data is inserted into database. systemctl stop zabbix-server If upgrading Zabbix proxy, agent, or agent 2, stop these components too: systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ::: noteimportant It is no longer possible to start the upgraded server and have older and unupgraded proxies report data to a newer server. This approach, which was never recommended nor supported by Zabbix, now is officially disabled, as the server will ignore data from unupgraded proxies. ::: ##### 1 Zabbixプロセスの停止 Zabbixサーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。 systemctl stop zabbix-server Zabbixプロキシやエージェント、エージェント2もアップグレードする場合は、同様に停止します。 systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ::: noteimportant アップグレードされたサーバーにアップグレードされていないプロキシがデータを報告することはできなくなりました。このアプローチはZabbixによって推奨もサポートもされていませんでしたが、サーバーが古いプロキシからのデータを無視するようになったため、現在は正式に無効になっています。 ::: # 1 Supported macros # 1 サポートしているマクロ # 1 System information # 1 システム情報 # 1 Trigger-based event correlation # 1 トリガーによるイベント相関 # 1 Trigger event generation # 1 トリガーイベントの生成 # 1 Upgrade from sources # 1 ソースからのアップグレード # 1 Usage examples # 1 使用例 # 1 Using certificates # 1 証明書の利用 # 1 Virtual machine discovery key fields The following table lists fields returned by virtual machine related discovery keys. |**Item key**|<|<| |--|--|----| |**Description**|**Field**|**Retrieved content**| |vmware.cluster.discovery|<|<| |Performs cluster discovery.|{\#CLUSTER.ID}|Cluster identifier.| |^|{\#CLUSTER.NAME}|Cluster name.| |vmware.datastore.discovery|<|<| |Performs datastore discovery.|{\#DATASTORE}|Datastore name.| |^|{\#DATASTORE.EXTENT}|JSON object with an array of {instanceName:partitionId}.| |vmware.dc.discovery|<|<| |Performs datacenter discovery.|{\#DATACENTER}|Datacenter name.| |^|{\#DATACENTERID}|Datacenter ID.| |vmware.hv.discovery|<|<| |Performs hypervisor discovery.|{\#HV.UUID}|Unique hypervisor identifier.| |^|{\#HV.ID}|Hypervisor identifier (HostSystem managed object name).| |^|{\#HV.NAME}|Hypervisor name.| |^|{\#HV.NETNAME}|Hypervisor network host name.| |^|{\#HV.IP}|Hypervisor IP address, might be empty.<br>In case of an HA configuration with multiple net interfaces, the following selection priority for interface is observed:<br>- prefer the IP which shares the IP-subnet with the vCenter IP<br>- prefer the IP from IP-subnet with default gateway<br>- prefer the IP from interface with the lowest ID<br>This field is supported since Zabbix 5.2.2.| |^|{\#CLUSTER.NAME}|Cluster name, might be empty.| |^|{\#DATACENTER.NAME}|Datacenter name.| |^|{\#PARENT.NAME}|Name of container that stores the hypervisor.<br>Supported since Zabbix 4.0.3.| |^|{\#PARENT.TYPE}|Type of container in which the hypervisor is stored. The values could be `Datacenter`, `Folder`, `ClusterComputeResource`, `VMware`, where 'VMware' stands for unknown container type.<br>Supported since Zabbix 4.0.3.| |vmware.hv.datastore.discovery|<|<| |Performs hypervisor datastore discovery. Note that multiple hypervisors can use the same datastore.|{\#DATASTORE}|Datastore name.| |^|{\#MULTIPATH.COUNT}|Registered number of datastore paths.| |^|{\#MULTIPATH.PARTITION.COUNT}|Number of available disk partitions.| |vmware.vm.discovery|<|<| |Performs virtual machine discovery.|{\#VM.UUID}|Unique virtual machine identifier.| |^|{\#VM.ID}|Virtual machine identifier (VirtualMachine managed object name).| |^|{\#VM.NAME}|Virtual machine name.| |^|{\#HV.NAME}|Hypervisor name.| |^|{\#DATACENTER.NAME}|Datacenter name.| |^|{\#CLUSTER.NAME}|Cluster name, might be empty.| |^|{\#VM.IP}|Virtual machine IP address, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.DNS}|Virtual machine DNS name, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.GUESTFAMILY}|Guest virtual machine OS family, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.GUESTFULLNAME}|Full guest virtual machine OS name, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.FOLDER}|The chain of virtual machine parent folders, can be used as value for nested groups; folder names are combined with "/". Might be empty.<br>Supported since Zabbix 5.4.2.| |vmware.vm.net.if.discovery|<|<| |Performs virtual machine network interface discovery.|{\#IFNAME}|Network interface name.| |vmware.vm.vfs.dev.discovery|<|<| |Performs virtual machine disk device discovery.|{\#DISKNAME}|Disk device name.| |vmware.vm.vfs.fs.discovery|<|<| |Performs virtual machine file system discovery.|{\#FSNAME}|File system name.| # 1 仮想マシンディスカバリキーフィールド 次の表は、仮想マシン関連のディスカバリキーが返すフィールドの一覧です。 |**アイテムキー**|<|<| |--|--|----| |**説明**|**フィールド**|**取得したコンテンツ**| |vmware.cluster.discovery|<|<| |クラスターの検出を実行します。|{\#CLUSTER.ID}|クラスターID。| |^|{\#CLUSTER.NAME}|クラスター名。| |vmware.datastore.discovery|<|<| |データストアの検出を実行します。|{\#DATASTORE}|データストア名。| |^|{\#DATASTORE.EXTENT}|{instanceName:partitionId}の配列を含むJSONオブジェクト。| |vmware.dc.discovery|<|<| |データセンターの検出を実行します。|{\#DATACENTER}|データセンター名。| |^|{\#DATACENTERID}|データセンターID。| |vmware.hv.discovery|<|<| |ハイパーバイザーの検出を実行します。|{\#HV.UUID}|一意のハイパーバイザーID。| |^|{\#HV.ID}|ハイパーバイザーID (HostSystem管理オブジェクト名)。| |^|{\#HV.NAME}|ハイパーバイザー名。| |^|{\#HV.NETNAME}|ハイパーバイザーネットワークのホスト名。| |^|{\#HV.IP}|Hypervisor IP address, might be empty.<br>In case of an HA configuration with multiple net interfaces, the following selection priority for interface is observed:<br>- prefer the IP which shares the IP-subnet with the vCenter IP<br>- prefer the IP from IP-subnet with default gateway<br>- prefer the IP from interface with the lowest ID<br>このフィールドは、Zabbix 5.2.2以降でサポートされています。| |^|{\#CLUSTER.NAME}|クラスター名。空の場合もあります。| |^|{\#DATACENTER.NAME}|データセンター名。| |^|{\#PARENT.NAME}|Name of container that stores the hypervisor.<br>Supported since Zabbix 4.0.3.| |^|{\#PARENT.TYPE}|Type of container in which the hypervisor is stored. The values could be `Datacenter`, `Folder`, `ClusterComputeResource`, `VMware`, where 'VMware' stands for unknown container type.<br>Supported since Zabbix 4.0.3.| |vmware.hv.datastore.discovery|<|<| |Performs hypervisor datastore discovery. Note that multiple hypervisors can use the same datastore.|{\#DATASTORE}|Datastore name.| |^|{\#MULTIPATH.COUNT}|Registered number of datastore paths.| |^|{\#MULTIPATH.PARTITION.COUNT}|Number of available disk partitions.| |vmware.vm.discovery|<|<| |Performs virtual machine discovery.|{\#VM.UUID}|Unique virtual machine identifier.| |^|{\#VM.ID}|Virtual machine identifier (VirtualMachine managed object name).| |^|{\#VM.NAME}|Virtual machine name.| |^|{\#HV.NAME}|Hypervisor name.| |^|{\#DATACENTER.NAME}|Datacenter name.| |^|{\#CLUSTER.NAME}|Cluster name, might be empty.| |^|{\#VM.IP}|Virtual machine IP address, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.DNS}|Virtual machine DNS name, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.GUESTFAMILY}|Guest virtual machine OS family, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.GUESTFULLNAME}|Full guest virtual machine OS name, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.FOLDER}|The chain of virtual machine parent folders, can be used as value for nested groups; folder names are combined with "/". Might be empty.<br>Supported since Zabbix 5.4.2.| |vmware.vm.net.if.discovery|<|<| |Performs virtual machine network interface discovery.|{\#IFNAME}|Network interface name.| |vmware.vm.vfs.dev.discovery|<|<| |Performs virtual machine disk device discovery.|{\#DISKNAME}|Disk device name.| |vmware.vm.vfs.fs.discovery|<|<| |Performs virtual machine file system discovery.|{\#FSNAME}|File system name.| # 1 Virtual machine discovery key fields The following table lists fields returned by virtual machine related discovery keys. |**Item key**|<|<| |------------|-|-| |**Description**|**Field**|**Retrieved content**| |vmware.cluster.discovery|<|<| |Performs cluster discovery.|{\#CLUSTER.ID}|Cluster identifier.| |^|{\#CLUSTER.NAME}|Cluster name.| |vmware.datastore.discovery|<|<| |Performs datastore discovery.|{\#DATASTORE}|Datastore name.| |vmware.dc.discovery|<|<| |Performs datacenter discovery.|{\#DATACENTER}|Datacenter name.| |^|{\#DATACENTERID}|Datacenter ID.| |vmware.hv.discovery|<|<| |Performs hypervisor discovery.|{\#HV.UUID}|Unique hypervisor identifier.| |^|{\#HV.ID}|Hypervisor identifier (HostSystem managed object name).| |^|{\#HV.NAME}|Hypervisor name.| |^|{\#HV.NETNAME}|Hypervisor network host name.| |^|{\#HV.IP}|Hypervisor IP address, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#CLUSTER.NAME}|Cluster name, might be empty.| |^|{\#DATACENTER.NAME}|Datacenter name.| |^|{\#PARENT.NAME}|Name of container that stores the hypervisor.<br>Supported since Zabbix 4.0.3.| |^|{\#PARENT.TYPE}|Type of container in which the hypervisor is stored. The values could be `Datacenter`, `Folder`, `ClusterComputeResource`, `VMware`, where 'VMware' stands for unknown container type.<br>Supported since Zabbix 4.0.3.| |vmware.hv.datastore.discovery|<|<| |Performs hypervisor datastore discovery. Note that multiple hypervisors can use the same datastore.|{\#DATASTORE}|Datastore name.| |vmware.vm.discovery|<|<| |Performs virtual machine discovery.|{\#VM.UUID}|Unique virtual machine identifier.| |^|{\#VM.ID}|Virtual machine identifier (VirtualMachine managed object name).| |^|{\#VM.NAME}|Virtual machine name.| |^|{\#HV.NAME}|Hypervisor name.| |^|{\#DATACENTER.NAME}|Datacenter name.| |^|{\#CLUSTER.NAME}|Cluster name, might be empty.| |^|{\#VM.IP}|Virtual machine IP address, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.DNS}|Virtual machine DNS name, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.GUESTFAMILY}|Guest virtual machine OS family, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.GUESTFULLNAME}|Full guest virtual machine OS name, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.FOLDER}|The chain of virtual machine parent folders, can be used as value for nested groups; folder names are combined with "/". Might be empty.<br>Supported since Zabbix 5.4.2.| |vmware.vm.net.if.discovery|<|<| |Performs virtual machine network interface discovery.|{\#IFNAME}|Network interface name.| |vmware.vm.vfs.dev.discovery|<|<| |Performs virtual machine disk device discovery.|{\#DISKNAME}|Disk device name.| |vmware.vm.vfs.fs.discovery|<|<| |Performs virtual machine file system discovery.|{\#FSNAME}|File system name.| # 1 Virtual machine discovery key fields The following table lists fields returned by virtual machine related discovery keys. |**Item key**|<|<| |------------|-|-| |**Description**|**Field**|**Retrieved content**| |vmware.cluster.discovery|<|<| |Performs cluster discovery.|{\#CLUSTER.ID}|Cluster identifier.| |^|{\#CLUSTER.NAME}|Cluster name.| |vmware.datastore.discovery|<|<| |Performs datastore discovery.|{\#DATASTORE}|Datastore name.| |vmware.dc.discovery|<|<| |Performs datacenter discovery.|{\#DATACENTER}|Datacenter name.| |^|{\#DATACENTERID}|Datacenter ID.| |vmware.hv.discovery|<|<| |Performs hypervisor discovery.|{\#HV.UUID}|Unique hypervisor identifier.| |^|{\#HV.ID}|Hypervisor identifier (HostSystem managed object name).| |^|{\#HV.NAME}|Hypervisor name.| |^|{\#HV.IP}|Hypervisor IP address, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#CLUSTER.NAME}|Cluster name, might be empty.| |^|{\#DATACENTER.NAME}|Datacenter name.| |^|{\#PARENT.NAME}|Name of container that stores the hypervisor.<br>Supported since Zabbix 4.0.3.| |^|{\#PARENT.TYPE}|Type of container in which the hypervisor is stored. The values could be `Datacenter`, `Folder`, `ClusterComputeResource`, `VMware`, where 'VMware' stands for unknown container type.<br>Supported since Zabbix 4.0.3.| |vmware.hv.datastore.discovery|<|<| |Performs hypervisor datastore discovery. Note that multiple hypervisors can use the same datastore.|{\#DATASTORE}|Datastore name.| |vmware.vm.discovery|<|<| |Performs virtual machine discovery.|{\#VM.UUID}|Unique virtual machine identifier.| |^|{\#VM.ID}|Virtual machine identifier (VirtualMachine managed object name).| |^|{\#VM.NAME}|Virtual machine name.| |^|{\#HV.NAME}|Hypervisor name.| |^|{\#DATACENTER.NAME}|Datacenter name.| |^|{\#CLUSTER.NAME}|Cluster name, might be empty.| |^|{\#VM.IP}|Virtual machine IP address, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.DNS}|Virtual machine DNS name, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.GUESTFAMILY}|Guest virtual machine OS family, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.GUESTFULLNAME}|Full guest virtual machine OS name, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.FOLDER}|The chain of virtual machine parent folders, can be used as value for nested groups; folder names are combined with "/". Might be empty.<br>Supported since Zabbix 5.4.2.| |vmware.vm.net.if.discovery|<|<| |Performs virtual machine network interface discovery.|{\#IFNAME}|Network interface name.| |vmware.vm.vfs.dev.discovery|<|<| |Performs virtual machine disk device discovery.|{\#DISKNAME}|Disk device name.| |vmware.vm.vfs.fs.discovery|<|<| |Performs virtual machine file system discovery.|{\#FSNAME}|File system name.| # 1 VMware monitoring item keys # 1 VMware監視アイテムキー # 1 Webhook script examples # 1 Webhookスクリプトの例 # 1 Web monitoring items # 1 Web監視アイテム # 1 Zabbix agent # 1 Zabbix エージェント # 1 Zabbix server # 1 Zabbix サーバー # 20. Modules # 20. モジュール # 20 System information # 20 システム情報 # 20 Trigger overview # 20 Trigger overview # 20 Upgrade notes for 6.0.10 # 20 6.0.10へアップグレード時の注意点 # 20 What's new in Zabbix 6.0.15 # 20 Zabbix 6.0.15の新機能 # 21 Appendixes Please use the sidebar to access content in the Appendixes section. # 21. 付録 サイドバーから、参照したい項目を選択してください。 # 21 Top hosts # 21 Top hosts # 21 Top hosts # 21 上位ホスト # 21 Upgrade notes for 6.0.11 # 21 6.0.11へアップグレード時の注意点 # 21 URL # 21 URL # 21 What's new in Zabbix 6.0.16 # 21 Zabbix 6.0.16の新機能 # 22 Trigger overview # 22 トリガーの概要 # 22 Trigger overview # 22 Trigger overview # 22 Upgrade notes for 6.0.12 # 22 6.0.12へアップグレード時の注意点 # 22 Web monitoring # 22 Web monitoring # 22 What's new in Zabbix 6.0.17 # 22 Zabbix 6.0.17の新機能 # 23 Upgrade notes for 6.0.13 # 23 6.0.13へアップグレード時の注意点 # 23 URL # 23 URL # 23 URL # 23 URL # 23 What's new in Zabbix 6.0.18 # 23 Zabbix 6.0.18の新機能 # 24 Upgrade notes for 6.0.14 # 24 6.0.14へアップグレード時の注意点 # 24 Web monitoring # 24 Web監視 # 24 Web monitoring # 24 Web monitoring # 24 What's new in Zabbix 6.0.19 # 24 Zabbix 6.0.19の新機能 # 25 Upgrade notes for 6.0.15 This minor version doesn't have any upgrade notes. # 25 6.0.15へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 25 What's new in Zabbix 6.0.20 # 25 Zabbix 6.0.20の新機能 # 26 Upgrade notes for 6.0.16 This minor version doesn't have any upgrade notes. # 26 6.0.16へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 26 What's new in Zabbix 6.0.21 # 26 Zabbix 6.0.21の新機能 # 27 Upgrade notes for 6.0.17 # 27 6.0.17へアップグレード時の注意点 # 27 What's new in Zabbix 6.0.22 # 27 Zabbix 6.0.22の新機能 # 28 Upgrade notes for 6.0.18 # 28 6.0.18へアップグレード時の注意点 # 28 What's new in Zabbix 6.0.23 See [breaking changes](/manual/installation/upgrade_notes_6023#breaking_changes) for this version. # 28 Zabbix 6.0.23の新機能 このバージョンには[重大な変更](/manual/installation/upgrade_notes_6023#重大な変更)があります。 # 29 Upgrade notes for 6.0.19 # 29 6.0.19へアップグレード時の注意点 # 29 What's new in Zabbix 6.0.24 # 29 Zabbix 6.0.24の新機能 # 2 Actions [comment]: # (tags: action) # 2 アクション [comment]: # (tags: action) # 2 Active agent autoregistration # 2 アクティブエージェントの自動登録 # 2 Agent # 2 Zabbixエージェント ##### 2 Back up configuration files and Zabbix agent binaries Make a backup copy of the Zabbix agent binary and configuration file. ##### 2 設定ファイルとZabbixエージェントバイナリのバックアップ Zabbixエージェントバイナリと設定ファイルのバックアップコピーを作成します。 ##### 2 Back up configuration files and Zabbix proxy binaries Make a backup copy of the Zabbix proxy binary and configuration file. ##### 2 設定ファイルとZabbixプロキシバイナリのバックアップ Zabbixプロキシバイナリと設定ファイルのバックアップコピーを作成します。 ##### 2 Back up the existing Zabbix database This is a very important step. Make sure that you have a backup of your database. It will help if the upgrade procedure fails (lack of disk space, power off, any unexpected problem). ##### 2 既存Zabbixデータベースのバックアップ これは非常に重要なステップです。データベースのバックアップがあることを確認してください。アップグレード手順が失敗（ディスク容量の不足、電源オフ、予期しない問題）した場合に役立ちます。 ##### 2 Back up the existing Zabbix database This is a very important step. Make sure that you have a backup of your database. It will help if the upgrade procedure fails (lack of disk space, power off, any unexpected problem). ##### 2 既存Zabbixデータベースのバックアップ これは非常に重要なステップです。データベースのバックアップがあることを確認してください。アップグレード手順が失敗（ディスク容量の不足、電源オフ、予期しない問題）した場合に役立ちます。 ##### 2 Back up the existing Zabbix database This is a very important step. Make sure that you have a backup of your database. It will help if the upgrade procedure fails (lack of disk space, power off, any unexpected problem). ##### 2 既存Zabbixデータベースのバックアップ これは非常に重要なステップです。データベースのバックアップがあることを確認してください。アップグレード手順が失敗（ディスク容量の不足、電源オフ、予期しない問題）した場合に役立ちます。 ##### 2 Back up the existing Zabbix database This is a very important step. Make sure that you have a backup of your database. It will help if the upgrade procedure fails (lack of disk space, power off, any unexpected problem). ##### 2 既存Zabbixデータベースのバックアップ これは非常に重要なステップです。データベースのバックアップがあることを確認してください。アップグレード手順が失敗（ディスク容量の不足、電源オフ、予期しない問題）した場合に役立ちます。 # 2 Bitwise functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) Some general notes on function parameters: - Function parameters are separated by a comma - Expressions are accepted as parameters - Optional function parameters (or parameter parts) are indicated by `<` `>` |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**bitand** (value,mask)|<|<| |Value of "bitwise AND" of an item value and mask.|**value** - value to check<br>**mask** (mandatory) - 64-bit unsigned integer (0 - 18446744073709551615)|Supported value types: int<br><br>Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.<br><br>Examples:<br>=> **bitand**(last(/host/key),**12**)=8 or **bitand**(last(/host/key),**12**)=4 → 3rd or 4th bit set, but not both at the same time<br>=> **bitand**(last(/host/key),**20**)=16 → 3rd bit not set and 5th bit set.| |**bitlshift** (value,bits to shift)|<|<| |Bitwise shift left of an item value.|**value** - value to check<br>**bits to shift** (mandatory) - number of bits to shift|Supported value types: int<br><br>Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.| |**bitnot** (value)|<|<| |Value of "bitwise NOT" of an item value.|**value** - value to check<br>|Supported value types: int<br><br>Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.| |**bitor** (value,mask)|<|<| |Value of "bitwise OR" of an item value and mask.|**value** - value to check<br>**mask** (mandatory) - 64-bit unsigned integer (0 - 18446744073709551615)|Supported value types: int<br><br>Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.| |**bitrshift** (value,bits to shift)|<|<| |Bitwise shift right of an item value.|**value** - value to check<br>**bits to shift** (mandatory) - number of bits to shift|Supported value types: int<br><br>Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.| |**bitxor** (value,mask)|<|<| |Value of "bitwise exclusive OR" of an item value and mask.|**value** - value to check<br>**mask** (mandatory) - 64-bit unsigned integer (0 - 18446744073709551615)|Supported value types: int<br><br>Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.| # 2 Bitwise関数 ここにリストされているすべての関数は、次でサポートされています。 - [トリガー式](/manual/config/triggers/expression) - [計算アイテム](/manual/config/items/itemtypes/calculated) 関数パラメーターに関する一般的な注意事項: - 関数パラメーターはコンマで区切られます - 式はパラメーターとして受け入れられます - オプションの関数パラメーター(またはパラメーター部分)は`<` `>`で示されます |関数|<|<| |--|--|--| |**説明**|**関数固有のパラメーター**|**コメント**| |**bitand** (value,mask)|<|<| |アイテム値とマスクの"ビット論理積"の値。|**value** - チェックする値<br>**mask** (必須) - 64bitの符号なし整数 (0 - 18446744073709551615)|サポートされている値の型: int<br><br>比較はビットごとにすべての値を指定する必要があり、10進数で返されます。たとえば3番目のビットのチェックは、100ではなく4と比較して行われます。<br><br>例:<br>=> **bitand**(last(/host/key),**12** )=8 または **bitand**(last(/host/key),**12**)=4 → 3 番目または4番目のビットが設定されますが、両方が同時に設定されることはありません<br>=> **bitand** (last(/host/key),**20**)=16 → 3番目のビットが設定されておらず、5番目のビットが設定されています。| |**bitlshift** (value,bits to shift)|<|<| |アイテム値のビット単位左シフト。|**value** - チェックする値<br>**bits to shift** (必須) - シフトするビット数|サポートされている値の型: int<br><br>比較はビットごとに行われますが、すべての値を指定する必要があり、10進数で返されます。 たとえば、3番目のビットのチェックは、100ではなく4と比較して行われます。| |**bitnot** (value)|<|<| |アイテム値の"ビット否定"の値。|**value** - チェックする値<br>|サポートされている値の型: int<br><br>比較はビットごとに行われますが、すべての値を指定する必要があり、10進数で返されます。 たとえば、3番目のビットのチェックは、100ではなく4と比較して行われます。| |**bitor** (value,mask)|<|<| |アイテム値とマスクの"ビット論理和"の値。|**value** - チェックする値<br>**mask** (必須) - 64bitの符号なし整数 (0 - 18446744073709551615)|サポートされている値の型: int<br><br>比較はビットごとに行われますが、すべての値を指定する必要があり、10進数で返されます。 たとえば、3番目のビットのチェックは、100ではなく4と比較して行われます。| |**bitrshift** (value,bits to shift)|<|<| |アイテム値のビット単位右シフト。|**value** - チェックする値<br>**bits to shift** (必須) - シフトするビット数|サポートされている値の型: int<br><br>比較はビットごとに行われますが、すべての値を指定する必要があり、10進数で返されます。 たとえば、3番目のビットのチェックは、100ではなく4と比較して行われます。| |**bitxor** (value,mask)|<|<| |アイテム値とマスクの"ビット排他的論理和"の値。|**value** - チェックする値<br>**mask** (必須) - 64bitの符号なし整数 (0 - 18446744073709551615)|サポートされている値の型: int<br><br>比較はビットごとに行われますが、すべての値を指定する必要があり、10進数で返されます。 たとえば、3番目のビットのチェックは、100ではなく4と比較して行われます。| # 2 Building Zabbix agent 2 on Windows # 2 WindowsでのZabbixエージェント2のビルド # 2 Certificate problems # 2 証明書の問題 # 2 Clock # 2 Clock # 2 Clock # 2 時刻 # 2 Configuring a host group # 2 ホストグループの設定 # 2 Custom graphs # 2 カスタムグラフ # 2 Custom intervals # 2 監視間隔のカスタマイズ # 2 Debian/Ubuntu # 2 Debian/Ubuntu # 2 Debian/Ubuntu/Raspbian # 2 Debian/Ubuntu/Raspbian # 2. Definitions # 2. 定義 # 2 Discovery of network interfaces In a similar way as [file systems](/manual/discovery/low_level_discovery#configuring_low-level_discovery) are discovered, it is possible to also discover network interfaces. # 2 ネットワークインターフェースの検出 [ファイルシステム](/manual/discovery/low_level_discovery#configuring_low-level_discovery)が検出されるのと同様の方法で、ネットワークインターフェイスも検出できます。 # 2 Docker plugin # 2 Dockerプラグイン 2. Do not use "ps -ef" to browse processes - it shows only non-kernel processes. Use "ps -Af" to see all processes which will be seen by Zabbix agent. 3. Let's go through example of 'topasrec' how Zabbix agent proc.mem[] selects processes. ``` $ ps -Af | grep topasrec root 10747984 1 0 Mar 16 - 0:00 /usr/bin/topasrec -L -s 300 -R 1 -r 6 -o /var/perf daily/ -ypersistent=1 -O type=bin -ystart_time=04:08:54,Mar16,2023 ``` proc.mem[] has arguments: ``` proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>] ``` 2. プロセスを参照するために "ps -ef" を使用しないでください。これはカーネルプロセス以外のプロセスのみを表示します。Zabbixエージェントが認識するすべてのプロセスを表示するには、"ps -Af"を使用してください。 3. Zabbixエージェント proc.mem[] がプロセスを選択する方法を"topasrec"の例で確認してみましょう。 ``` $ ps -Af | grep topasrec root 10747984 1 0 Mar 16 - 0:00 /usr/bin/topasrec -L -s 300 -R 1 -r 6 -o /var/perf daily/ -ypersistent=1 -O type=bin -ystart_time=04:08:54,Mar16,2023 ``` proc.mem[] には引数があります: ``` proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>] ``` # 2 Frontend sections Please use the sidebar to access content in the Frontend sections section. # 2 Webインターフェースセクション サイドバーから、参照したい項目を選択してください。 # 2 Global event correlation # 2 グローバルイベント相関 # 2 Host group elements # 2 ホストグループの構成要素 # 2 Hosts # 2 ホスト # 2 Items # 2 アイテム # 2 Item value preprocessing # 2 アイテムの値の保存前処理 # 2 Linking/unlinking # 2 リンク作成/リンク削除 # 2 Network maps [comment]: # (tags: map) # 2 ネットワークマップ [comment]: # (tags: map) # 2 New host # 2 新規ホスト # 2 Operations # 2 実行内容 # 2 Other event sources # 2 その他のイベントソース # 2 Permissions # 2 ユーザー権限 # 2 PostgreSQL encryption configuration [comment]: # (tags: ssl) # 2 PostgreSQLの暗号化設定 [comment]: # (tags: ssl) # 2 Preprocessing details # 2 保存前処理の詳細 # 2 Problems # 2 障害 # 2 Process configuration Please use the sidebar to access content in this section. # 2 プロセスの設定 サイドバーから、参照したい項目を選択してください。 # 2 Proxies # 2 プロキシ # 2 Real life scenario # 2 シナリオの実例 # 2 Recommended UnixODBC settings for PostgreSQL # 2 PostgreSQLの推奨UnixODBC設定 # 2 Remote commands # 2 リモートコマンド # 2 Repairing Zabbix database character set and collation # 2 Zabbixデータベースのキャラクターセットと照合の修正 # 2 Requirements # 2 要件 # 2 Scheduled reports # 2 定期レポート # 2 Service actions # 2 サービスアクション # 2 Service actions # 2 サービスアクション # 2 Services # 2 サービス # 2 Setup from RHEL packages # 2 RHELパッケージでのセットアップ # 2 Setup from RHEL packages # 2 RHELパッケージでのセットアップ # 2 SMS # 2 SMS # 2 Sound in browsers # 2 ブラウザのサウンド # 2 Special OIDs Some of the most used SNMP OIDs are translated automatically to a numeric representation by Zabbix. For example, **ifIndex** is translated to **1.3.6.1.2.1.2.2.1.1**, **ifIndex.0** is translated to **1.3.6.1.2.1.2.2.1.1.0**. The table contains list of the special OIDs. |Special OID|Identifier|Description| |--|--|------| |ifIndex|1.3.6.1.2.1.2.2.1.1|A unique value for each interface.| |ifDescr|1.3.6.1.2.1.2.2.1.2|A textual string containing information about the interface.This string should include the name of the manufacturer, the product name and the version of the hardware interface.| |ifType|1.3.6.1.2.1.2.2.1.3|The type of interface, distinguished according to the physical/link protocol(s) immediately 'below' the network layer in the protocol stack.| |ifMtu|1.3.6.1.2.1.2.2.1.4|The size of the largest datagram which can be sent / received on the interface, specified in octets.| |ifSpeed|1.3.6.1.2.1.2.2.1.5|An estimate of the interface's current bandwidth in bits per second.| |ifPhysAddress|1.3.6.1.2.1.2.2.1.6|The interface's address at the protocol layer immediately \`below' the network layer in the protocol stack.| |ifAdminStatus|1.3.6.1.2.1.2.2.1.7|The current administrative state of the interface.| |ifOperStatus|1.3.6.1.2.1.2.2.1.8|The current operational state of the interface.| |ifInOctets|1.3.6.1.2.1.2.2.1.10|The total number of octets received on the interface, including framing characters.| |ifInUcastPkts|1.3.6.1.2.1.2.2.1.11|The number of subnetwork-unicast packets delivered to a higher-layer protocol.| |ifInNUcastPkts|1.3.6.1.2.1.2.2.1.12|The number of non-unicast (i.e., subnetwork- broadcast or subnetwork-multicast) packets delivered to a higher-layer protocol.| |ifInDiscards|1.3.6.1.2.1.2.2.1.13|The number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol. One possible reason for discarding such a packet could be to free up buffer space.| |ifInErrors|1.3.6.1.2.1.2.2.1.14|The number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol.| |ifInUnknownProtos|1.3.6.1.2.1.2.2.1.15|The number of packets received via the interface which were discarded because of an unknown or unsupported protocol.| |ifOutOctets|1.3.6.1.2.1.2.2.1.16|The total number of octets transmitted out of the interface, including framing characters.| |ifOutUcastPkts|1.3.6.1.2.1.2.2.1.17|The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sub-layer, including those that were discarded or not sent.| |ifOutNUcastPkts|1.3.6.1.2.1.2.2.1.18|The total number of packets that higher-level protocols requested be transmitted, and which were addressed to a multicast or broadcast address at this sub-layer, including those that were discarded or not sent.| |ifOutDiscards|1.3.6.1.2.1.2.2.1.19|The number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space.| |ifOutErrors|1.3.6.1.2.1.2.2.1.20|The number of outbound packets that could not be transmitted because of errors.| |ifOutQLen|1.3.6.1.2.1.2.2.1.21|The length of the output packet queue (in packets).| # 2 特殊なOID 最もよく使われるSNMP OIDのいくつかは、Zabbixによって自動的に数値表現に変換されます。 例えば、**ifIndex**は**1.3.6.1.2.1.2.2.1.1**に、 **ifIndex.0**は**1.3.6.1.2.1.2.2.1.1.0**に変換されます。 この表は、特殊なOIDのリストです。 |特殊OID|識別子|説明| |--|--|------| |ifIndex|1.3.6.1.2.1.2.2.1.1|各インターフェースの一意な値。| |ifDescr|1.3.6.1.2.1.2.2.1.2|インターフェースに関する情報を含むテキスト文字列。この文字列には、製造元の名前、製品名、ハードウェアインターフェースのバージョンが含まれます。| |ifType|1.3.6.1.2.1.2.2.1.3|インターフェースのタイプ。プロトコルスタックのネットワーク層「直下」の物理/リンクプロトコルによって区別されます。| |ifMtu|1.3.6.1.2.1.2.2.1.4|インターフェースで送受信できる最大データグラムのサイズ。(オクテット単位で指定します)| |ifSpeed|1.3.6.1.2.1.2.2.1.5|インターフェースの現在の帯域幅の推定値。(ビット/秒単位)| |ifPhysAddress|1.3.6.1.2.1.2.2.1.6|プロトコルスタックのネットワーク層の「直下」にあるプロトコル層におけるインターフェースのアドレス。| |ifAdminStatus|1.3.6.1.2.1.2.2.1.7|インターフェースの現在の管理状態。| |ifOperStatus|1.3.6.1.2.1.2.2.1.8|インターフェースの現在の動作状態。| |ifInOctets|1.3.6.1.2.1.2.2.1.10|インターフェースで受信された合計オクテット数。（フレーミング文字を含む）| |ifInUcastPkts|1.3.6.1.2.1.2.2.1.11|上位層プロトコルに配信されたサブネットワークユニキャストパケット数。| |ifInNUcastPkts|1.3.6.1.2.1.2.2.1.12|上位層プロトコルに配信された非ユニキャスト（つまり、サブネットワーク・ブロードキャストまたはサブネットワーク・マルチキャスト）パケット数。| |ifInDiscards|1.3.6.1.2.1.2.2.1.13|上位層プロトコルへの配信を防止する際にエラーが検出されなかったにもかかわらず、破棄するように指定された受信パケット数。このようなパケットを破棄する理由の1つは、バッファ領域を解放するためである可能性があります。| |ifInErrors|1.3.6.1.2.1.2.2.1.14|上位層プロトコルへの配信を防止する際にエラーが検出された受信パケット数。| |ifInUnknownProtos|1.3.6.1.2.1.2.2.1.15|インターフェース経由で受信され、不明またはサポートされていないプロトコルのために破棄されたパケット数。| |ifOutOctets|1.3.6.1.2.1.2.2.1.16|インターフェースから送信された合計オクテット数。（フレーミング文字を含む）| |ifOutUcastPkts|1.3.6.1.2.1.2.2.1.17|上位レベルのプロトコルがサブレイヤーに送信を要求し、宛先がマルチキャストアドレスまたはブロードキャストアドレスではなかったパケットの合計数。（破棄されたパケットまたは送信されなかったパケットを含む）| |ifOutNUcastPkts|1.3.6.1.2.1.2.2.1.18|上位レベルのプロトコルがサブレイヤーに送信を要求し、宛先がマルチキャストアドレスまたはブロードキャストアドレスだったパケットの合計数。（破棄されたパケットまたは送信されなかったパケットを含む）| |ifOutDiscards|1.3.6.1.2.1.2.2.1.19|送信を妨げるエラーが検出されなかったにもかかわらず、破棄するように選択された送信パケットの数。このようなパケットを破棄する理由の1つは、バッファ領域を解放するためである可能性があります。| |ifOutErrors|1.3.6.1.2.1.2.2.1.20|エラーのために送信できなかった送信パケット数。| |ifOutQLen|1.3.6.1.2.1.2.2.1.21|出力パケットキューの長さ。(パケット数)| # 2 Templates # 2 テンプレート # 2 Templates # 2 テンプレート # 2 Trigger expression # 2 トリガー条件式 # 2 Trigger prototypes # 2 トリガーのプロトタイプ # 2 Trigger prototypes # 2 トリガーのプロトタイプ # 2 Triggers # 2 トリガー # 2 Triggers # 2 トリガー # 2 Upgrade from packages # 2 パッケージからのアップグレード # 2 User macros # 2 ユーザーマクロ # 2 User macros supported by location # 2 ロケーションでサポートされているユーザーマクロ # 2 Using pre-shared keys # 2 事前共有鍵の使用 # 2 vm.memory.size parameters # 2 vm.memory.size パラメーター # 2 Web scenarios # 2 Webシナリオ # 2 What is Zabbix # 2 Zabbixとは # 2 Windows-specific item keys # 2 Windows固有のアイテムキー # 2 Zabbix agent protocol Please refer to [Passive and active agent checks](/manual/appendix/items/activepassive) page for more information. # 2 Zabbix エージェントのプロトコル 詳細については[パッシブおよびアクティブエージェントチェック](/manual/appendix/items/activepassive)ページを参照してください。 # 2 Zabbix proxy # 2 Zabbix プロキシ # 30 Upgrade notes for 6.0.20 This minor version doesn't have any upgrade notes. # 30 6.0.20へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 30 What's new in Zabbix 6.0.25 # 30 Zabbix 6.0.25の新機能 # 31 Upgrade notes for 6.0.21 # 31 6.0.21へアップグレード時の注意点 # 31 What's new in Zabbix 6.0.26 # 31 Zabbix 6.0.26の新機能 ##### 32 bit Open MinGW environment (Windows command prompt) and navigate to *build/mingw* directory in the Zabbix source tree. Run: mingw32-make clean mingw32-make ARCH=x86 PCRE=c:\dev\pcre32 OPENSSL=c:\dev\openssl32 ##### 32bit MinGW環境(Windowsコマンドプロンプト)を起動し、Zabbixソースツリーの*build/mingw*ディレクトリに移動します。 次のコマンドを実行します。 mingw32-make clean mingw32-make ARCH=x86 PCRE=c:\dev\pcre32 OPENSSL=c:\dev\openssl32 # 32 Upgrade notes for 6.0.22 # 32 6.0.22へアップグレード時の注意点 # 32 What's new in Zabbix 6.0.27 # 32 Zabbix 6.0.27の新機能 # 33 Upgrade notes for 6.0.23 # 33 6.0.23へアップグレード時の注意点 # 33 What's new in Zabbix 6.0.28 # 33 Zabbix 6.0.28の新機能 # 34 Upgrade notes for 6.0.24 # 34 6.0.24へアップグレード時の注意点 # 34 What's new in Zabbix 6.0.29 # 34 Zabbix 6.0.29の新機能 # 35 Upgrade notes for 6.0.25 # 35 6.0.25へアップグレード時の注意点 # 35 What's new in Zabbix 6.0.30 # 35 Zabbix 6.0.30の新機能 # 36 Upgrade notes for 6.0.26 This minor version doesn't have any upgrade notes. # 36 6.0.26へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 36 What's new in Zabbix 6.0.31 # 36 Zabbix 6.0.31の新機能 # 37 Upgrade notes for 6.0.27 # 37 6.0.27へアップグレード時の注意点 # 37 What's new in Zabbix 6.0.32 # 37 Zabbix 6.0.32の新機能 # 38 Upgrade notes for 6.0.28 # 38 6.0.28へアップグレード時の注意点 # 38 What's new in Zabbix 6.0.33 # 38 Zabbix 6.0.33の新機能 # 39 Upgrade notes for 6.0.29 This minor version doesn't have any upgrade notes. # 39 6.0.29へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 39 What's new in Zabbix 6.0.34 # 39 Zabbix 6.0.34の新機能 # 3 Additional operations # 3 追加操作 # 3 Ad-hoc graphs # 3 アドホックグラフ # 3 Agent 2 # 3 Zabbixエージェント2 # 3 Authentication [comment]: # (tags: ldap, saml) # 3 認証 [comment]: # (tags: ldap, saml) # 3 Availability report # 3 稼働レポート ##### 3 Back up configuration files, PHP files and Zabbix binaries Make a backup copy of Zabbix binaries, configuration files and the PHP file directory. ##### 3 設定ファイル、PHPファイル、Zabbixバイナリのバックアップ Zabbixバイナリ、設定ファイル、PHPファイルディレクトリのバックアップコピーを作成します。 ##### 3 Back up configuration files, PHP files and Zabbix binaries Make a backup copy of Zabbix binaries, configuration files and the PHP file directory. Configuration files: mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/ PHP files and Zabbix binaries: cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ##### 3 設定ファイル、PHPファイル、Zabbixバイナリのバックアップ Zabbixバイナリ、設定ファイル、PHPファイルディレクトリのバックアップコピーを作成します。 設定ファイル: mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/ PHPファイルとZabbixバイナリ: cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ##### 3 Back up configuration files, PHP files and Zabbix binaries Make a backup copy of Zabbix binaries, configuration files and the PHP file directory. Configuration files: # mkdir /opt/zabbix-backup/ # cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ # cp /etc/httpd/conf.d/zabbix.conf /opt/zabbix-backup/ PHP files and Zabbix binaries: # cp -R /usr/share/zabbix/ /opt/zabbix-backup/ # cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ##### 3 設定ファイル、PHPファイル、Zabbixバイナリのバックアップ Zabbixバイナリ、設定ファイル、PHPファイルディレクトリのバックアップコピーを作成します。 設定ファイル: # mkdir /opt/zabbix-backup/ # cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ # cp /etc/httpd/conf.d/zabbix.conf /opt/zabbix-backup/ PHPファイルとZabbixバイナリ: # cp -R /usr/share/zabbix/ /opt/zabbix-backup/ # cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ##### 3 Back up configuration files, PHP files and Zabbix binaries Make a backup copy of Zabbix binaries, configuration files and the PHP file directory. Configuration files: mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/httpd/conf.d/zabbix.conf /opt/zabbix-backup/ PHP files and Zabbix binaries: cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ##### 3 設定ファイル、PHPファイル、Zabbixバイナリのバックアップ Zabbixバイナリ、設定ファイル、PHPファイルディレクトリのバックアップコピーを作成します。 設定ファイル: mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/httpd/conf.d/zabbix.conf /opt/zabbix-backup/ PHPファイルとZabbixバイナリ: cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ # 3 Building Zabbix agent on macOS # 3 macOSでのZabbixエージェントのビルド ##### 3 Create Zabbix database For Zabbix [server](/manual/concepts/server) and [proxy](/manual/concepts/proxy) daemons, as well as Zabbix frontend, a database is required. It is not needed to run Zabbix [agent](/manual/concepts/agent). SQL [scripts are provided](/manual/appendix/install/db_scripts) for creating database schema and inserting the dataset. Zabbix proxy database needs only the schema while Zabbix server database requires also the dataset on top of the schema. Having created a Zabbix database, proceed to the following steps of compiling Zabbix. ##### 3 Zabbixデータベースの作成 Zabbix[サーバー](/manual/concepts/server)や[プロキシ](/manual/concepts/proxy)デーモン、Zabbixフロントエンドには、データベースが必要です。 Zabbix[エージェント](/manual/concepts/agent)の実行には必要ありません。 データベーススキーマを作成し、データセットを挿入するためのSQL[スクリプトが提供されています](/manual/appendix/install/db_scripts)。 Zabbixプロキシデータベースにはスキーマのみが必要ですが、Zabbixサーバーデータベースにはスキーマ上のデータセットも必要です。 Zabbixデータベースを作成したら、次のZabbixのコンパイル手順に進みます。 # 3 Custom alert scripts # 3 カスタムアラートスクリプト # 3 Dashboards [Dashboards](/manual/web_interface/frontend_sections/monitoring/dashboard) and their widgets provide a strong visualization platform with such tools as modern graphs, maps, slideshows, and many more. {width="600"} # 3 ダッシュボード [ダッシュボード](/manual/web_interface/frontend_sections/monitoring/dashboard)とそのウィジェットは、最新のグラフ、マップ、スライドショーなどのツールを備えた強力な視覚化プラットフォームを提供します。 {width="600"} # 3 Database upgrade to primary keys # 3 データベースの主キーのアップグレード # 3 Data overview # 3 Data overview # 3 Data overview # 3 データの概要 # 3 Discovery of CPUs and CPU cores In a similar way as [file systems](/manual/discovery/low_level_discovery#configuring_low-level_discovery) are discovered, it is possible to also discover CPUs and CPU cores. # 3 CPUとCPUコアの検出 [ファイルシステム](/manual/discovery/low_level_discovery#configuring_low-level_discovery)が検出されるのと同様の方法で、CPUとCPUコアも検出できます。 # 3 Ember+ plugin # 3 Ember+プラグイン # 3 Graph prototypes # 3 グラフのプロトタイプ # 3 Graph prototypes # 3 グラフのプロトタイプ # 3 Graph prototypes We can create graph prototypes, too:  Attributes that are specific for graph prototypes: |Parameter|Description| |--|--------| |*Discover*|If checked (default) the graph will be added to a discovered entity.<br>If unchecked, the graph will not be added to a discovered entity, unless this setting is [overridden](/manual/discovery/low_level_discovery#override) in the discovery rule.|  Finally, we have created a discovery rule that looks as shown below. It has five item prototypes, two trigger prototypes, and one graph prototype.  *Note*: For configuring host prototypes, see the section about [host prototype](/manual/vm_monitoring#host_prototypes) configuration in virtual machine monitoring. # 3 グラフのプロトタイプ グラフのプロトタイプを作成することもできます。  グラフのプロトタイプ固有の属性: |パラメーター|説明| |--|--------| |*ディスカバリ*|(デフォルト)チェックすると、グラフは検出されたエンティティに追加されます。<br>チェックを外すと、この設定がディスカバリルールで[上書き](/manual/discovery/low_level_discovery#override)されない限りグラフは検出されたエンティティに追加されません。|  これまでの例で最終的に、次のようなディスカバリルールが作成されます。5つのアイテムのプロトタイプ、2つのトリガーのプロトタイプ、および1つのグラフのプロトタイプを持ちます。  *注*: ホストのプロトタイプの構成については、仮想マシンの監視における[ホストプロトタイプ](/manual/vm_monitoring#host_prototypes)の設定に関するセクションを参照してください。 # 3 Graphs # 3 グラフ # 3 Graphs # 3 グラフ # 3 Hosts # 3 ホスト # 3 Hosts # 3 ホスト # 3 Hosts # 3 ホスト # 3 Installation from sources You can get the very latest version of Zabbix by compiling it from the sources. A step-by-step tutorial for installing Zabbix from the sources is provided here. # 3 ソースコードからのインストール Zabbixの最新バージョンはソースからコンパイルすることで入手できます。 Zabbixをソースからインストールするためのステップバイステップのチュートリアルはこちらです。 ##### 3 Install new agent binaries Use these [instructions](/manual/installation/install#installing_zabbix_daemons) to compile Zabbix agent from sources. Alternatively, you may download pre-compiled Zabbix agents from the [Zabbix download page](http://www.zabbix.com/download.php). ##### 3 新しいエージェントバイナリのインストール [手順](/manual/installation/install#installing_zabbix_daemons)を参照して、ソースからZabbixエージェントをコンパイルします。 または[Zabbixダウンロードページ](http://www.zabbix.com/download.php)からコンパイル済みのZabbixエージェントをダウンロードすることもできます。 ##### 3 Install new proxy binaries Use these [instructions](/manual/installation/install#installing_zabbix_daemons) to compile Zabbix proxy from sources. ##### 3 新しいプロキシバイナリのインストール [手順](/manual/installation/install#installing_zabbix_daemons)を参照して、ソースからZabbixプロキシをコンパイルします。 # 3 Inventory # 3 インベントリ # 3 Inventory # 3 インベントリ # 3 Item types # 3 アイテムのタイプ # 3 JSONPath functionality # 3 JSONPath機能 # 3 Link indicators # 3 リンクインジケーター # 3 Low-level discovery # 3 ローレベルディスカバリ # 3 Manual closing of problems # 3 障害の手動クローズ # 3 MIB files # 3 MIB ファイル # 3 Nesting # 3 ネスト # 3 New item # 3 新規アイテム # 3 Passive and active agent checks # 3 パッシブエージェントチェックとアクティブエージェントチェック # 3 Passive and active agent checks # 3 パッシブおよびアクティブエージェントチェック # 3 Protocols Please use the sidebar to access content in this section. # 3 プロトコル サイドバーから、参照したい項目を選択してください。 # 3 PSK problems [comment]: # (tags: ssl) # 3 PSKの問題 [comment]: # (tags: ssl) # 3 Receiving notification on unsupported items #3 サポート対象外通知の受信 # 3 Recommended UnixODBC settings for Oracle # 3 Oracleの推奨UnixODBC設定 # 3 Recovery operations # 3 復旧時実行 # 3 Setup from Debian/Ubuntu packages # 3 Debian/Ubuntuパッケージでのセットアップ # 3 SLA # 3 SLA # 3 SLA # 3 SLA # 3 SUSE Linux Enterprise Server # 3 SUSE Linux Enterprise Server # 3 Trigger dependencies # 3 トリガーの依存関係 # 3 Triggers # 3 トリガー # 3 Troubleshooting # 3 トラブルシューティング # 3 User groups # 3 ユーザグループ # 3 User macros with context # 3 コンテキストユーザーマクロ # 3 User settings # 3 ユーザー設定 # 3 Zabbix agent 2 protocol # 3 Zabbix エージェント 2 プロトコル # 3 Zabbix agent (UNIX) # 3 Zabbix エージェント (UNIX) # 3 Zabbix features # 3 Zabbixの機能 # 3 Zabbix processes Please use the sidebar to access content in the Zabbix process section. # 3. Zabbixのプロセス サイドバーから、参照したい項目を選択してください。 # 40 Upgrade notes for 6.0.30 This minor version doesn't have any upgrade notes. # 40 6.0.30へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 40 What's new in Zabbix 6.0.35 # 40 Zabbix 6.0.35の新機能 # 41 Upgrade notes for 6.0.31 This minor version doesn't have any upgrade notes. # 41 6.0.31へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 41 What's new in Zabbix 6.0.36 # 41 Zabbix 6.0.36の新機能 # 42 Upgrade notes for 6.0.32 # 42 6.0.32へアップグレード時の注意点 # 42 What's new in Zabbix 6.0.37 This minor version does not have any functional changes. # 42 Zabbix 6.0.37の新機能 このマイナー バージョンには、機能上の変更点はありません。 # 43 Upgrade notes for 6.0.33 This minor version does not have any upgrade notes. # 43 6.0.33へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 43 What's new in Zabbix 6.0.38 See [breaking changes](/manual/installation/upgrade_notes_6038#breaking-changes) for this version. # 43 Zabbix 6.0.38の新機能 このバージョンには[重大な変更](/manual/installation/upgrade_notes_6038#重大な変更)があります。 # 44 Upgrade notes for 6.0.34 # 44 6.0.34へアップグレード時の注意点 # 44 What's new in Zabbix 6.0.39 See [breaking changes](/manual/installation/upgrade_notes_6039#breaking-changes) for this version. # 44 Zabbix 6.0.39の新機能 このバージョンには[重大な変更](/manual/installation/upgrade_notes_6039#重大な変更)があります。 # 45 Upgrade notes for 6.0.35 # 45 6.0.35へアップグレード時の注意点 # 45 What's new in Zabbix 6.0.40 # 45 Zabbix 6.0.40の新機能 # 46 Upgrade notes for 6.0.36 This minor version does not have any upgrade notes. # 46 6.0.36へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 46 What's new in Zabbix 6.0.41 # 46 Zabbix 6.0.41の新機能 # 47 Upgrade notes for 6.0.37 This minor version does not have any upgrade notes. # 47 6.0.37へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 47 What's new in Zabbix 6.0.42 # 47 Zabbix 6.0.42 の新機能 # 48 Upgrade notes for 6.0.38 # 48 6.0.38へアップグレード時の注意点 # 49 Upgrade notes for 6.0.39 # 49 6.0.39へアップグレード時の注意点 # 49 What's new in Zabbix 6.0.44 # 49 Zabbix 6.0.44の新機能 # 4 Aggregation in graphs # 4 グラフの集計 # 4 Discovery of SNMP OIDs # 4 SNMP OIDsの検出 # 4 Discovery rules # 4 ディスカバリルール # 4 Discovery rules # 4 ディスカバリルール # 4 Discovery status # 4 ディスカバリのステータス # 4 Events # 4 イベント # 4 Global search It is possible to search Zabbix frontend for hosts, host groups and templates. The search input box is located below the Zabbix logo in the menu. The search can be started by pressing *Enter* or clicking on the  search icon.  If there is a host that contains the entered string in any part of the name, a dropdown will appear, listing all such hosts (with the matching part highlighted in orange). The dropdown will also list a host if that host's visible name is a match to the technical name entered as a search string; the matching host will be listed, but without any highlighting. # 4 グローバルサーチ Zabbixフロントエンドでホスト、ホストグループ、テンプレートを検索することができます。 検索入力ボックスはメニューのZabbixロゴの下にあります。*Enter*を押すか、検索アイコンをクリックすると、検索を開始できます。  名前のいずれかの部分に入力された文字列を含むホストがある場合、ドロップダウンが表示され、部分一致したホストが一覧表示されます（一致する部分がオレンジ色で強調表示されます）。ドロップダウンには、ホストの表示名が検索文字列として入力されたテクニカルネームと一致する場合にもホストが一覧表示されます。一致するホストに一覧表示されますが、強調表示はありません。 # 4 History and trends # 4 ヒストリとトレンド # 4 History functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) Some general notes on function parameters: - Function parameters are separated by a comma - Optional function parameters (or parameter parts) are indicated by `<` `>` - Function-specific parameters are described with each function - `/host/key` and `(sec|#num)<:time shift>` parameters must never be quoted # 4 ヒストリ関数 ここにリストされているすべての機能は、次でサポートされています。 - [トリガー式](/manual/config/triggers/expression) - [計算項目](/manual/config/items/itemtypes/calculated) 関数パラメーターに関する一般的な注意事項: - 関数パラメータはコンマで区切られます。 - オプションの関数パラメーター (またはパラメーター部分) は `<` `>` で示されます - 機能固有のパラメーターは、各機能で説明されています - `/host/key` と `(sec|#num)<:time shift>` はパラメータを引用符で囲んではいけません # 4 Host dashboards # 4 ホストダッシュボード # 4 Host prototypes # 4 ホストのプロトタイプ # 4 Host prototypes # 4 ホストのプロトタイプ # 4 Installation from packages # 4 パッケージインストール #### 4 Installing Zabbix web service Installing Zabbix web service is only required if you want to use [scheduled reports](/manual/web_interface/frontend_sections/reports/scheduled). To install from sources, first [download](/manual/installation/install#download_the_source_archive) and extract the source archive. To compile Zabbix web service, run the `./configure` script with `--enable-webservice` option. ::: noteclassic A configured [Go](https://golang.org/doc/install) version 1.13+ environment is required for building Zabbix web service. ::: #### 4 Installing Zabbix web service Installing Zabbix web service is only required if you want to use [scheduled reports](/manual/web_interface/frontend_sections/reports/scheduled). To install from sources, first [download](/manual/installation/install#download_the_source_archive) and extract the source archive. To compile Zabbix web service, run the `./configure` script with `--enable-webservice` option. ::: noteclassic A configured [Go](https://golang.org/doc/install) version 1.13+ environment is required for building Zabbix web service. ::: ##### 4 Install new server binaries Use these [instructions](/manual/installation/install#installing_zabbix_daemons) to compile Zabbix server from sources. ##### 4 新しいサーバーバイナリのインストール [手順](/manual/installation/install#installing_zabbix_daemons)を使用して、ソースからZabbixサーバーをコンパイルします。 # 4 Items Please use the sidebar to access content in this section. # 4 アイテム サイドバーから、参照したい項目を選択してください。 # 4 JavaScript preprocessing # 4 JavaScriptの保存前処理 # 4 Latest data # 4 最新データ # 4 Low-level discovery macros # 4 ローレベルディスカバリマクロ # 4 Maintenance # 4 メンテナンス # 4 Mass update # 4 一括更新 # 4 Mass update # 4 一括アップデート # 4 Memcached plugin # 4 Memcachedプラグイン # 4 Network maps # 4 ネットワークマップ # 4 New trigger [comment]: # (tags: trigger) # 4 新規トリガー [comment]: # (tags: trigger) # 4 Notes on low-level discovery # 4 ローレベルディスカバリにおける注意点 # 4 Recommended UnixODBC settings for MSSQL # 4 MSSQLの推奨UnixODBC設定 # 4 Reports # 4 レポート # 4 Secure connection to the database # 4 データベースへの安全な接続 # 4 Setup example # 4 セットアップ例 # 4 SLA report # 4 SLAレポート # 4 Trapper items # 4 トラッパーアイテム # 4 Trigger severity Trigger severity represents the level of importance of a trigger.  Zabbix supports the following default trigger severities. |Severity|Color|Description| |-|-|--------| |Not classified|Gray|Can be used where the severity level of an event is unknown, has not been determined, is not part of the regular monitoring scope, etc., for example, during initial configuration, as a placeholder for future assessment, or as part of an integration process.| |Information|Light blue|Can be used for informational events that do not require immediate attention, but can still provide valuable insights.| |Warning|Yellow|Can be used to indicate a potential issue that might require investigation or action, but that is not critical.| |Average|Orange|Can be used to indicate a significant issue that should be addressed relatively soon to prevent further problems.| |High|Light red|Can be used to indicate critical issues that need immediate attention to avoid significant disruptions.| |Disaster|Red|Can be used to indicate a severe incident that requires immediate action to prevent, for example, system outages or data loss.| ::: noteclassic Trigger severity names and colors can be [customized](/manual/config/triggers/customseverities). ::: Trigger severities are used for: - visual representation of triggers - different colors for different severities; - audio in global alarms - different audio for different severities; - user media - different media (notification channel) for different severities (for example, SMS for triggers of *High* and *Disaster* severity, and Email for triggers of other severities); - limiting actions by conditions against trigger severities. # 4 トリガーの深刻度 トリガーの深刻度は、トリガーの重要度レベルを表します。  Zabbixは、次のデフォルトのトリガー深刻度をサポートしています。 |深刻度|色|説明| |-|-|--------| |未分類 (Not classified)|灰色|イベントの深刻度レベルが不明、決定されていない、通常の監視範囲に含まれていない場合などに使用できます。たとえば、初期構成中、将来の評価のためのプレースホルダーとして、または統合プロセスの一部として使用できます。| |情報 (Information)|水色|すぐに対処する必要はないが、貴重な洞察を提供できる情報イベントに使用できます。| |警告 (Warning)|黄色|調査や対応が必要になる可能性があるが、重大ではない潜在的な問題を示すために使用できます。| |軽度の障害 (Average)|オレンジ|さらなる問題を防ぐために比較的早く対処する必要がある重大な問題を示すために使用できます。| |重度の障害 (High)|淡い赤|重大な中断を避けるためにすぐに対処する必要がある重大な問題を示すために使用できます。| |致命的な障害 (Disaster)|赤|システム停止やデータ損失などを防ぐためにすぐに対処する必要がある重大なインシデントを示すために使用できます。| ::: noteclassic トリガーの深刻度名と色は[カスタマイズ](/manual/config/triggers/customseverities)できます。 ::: 深刻度は、以下の用途で使用されます: - トリガーの視覚的表現 - 深刻度に応じて異なる色 - グローバルアラームの音声 - 深刻度に応じて異なる音声 - ユーザー メディア - 深刻度に応じて異なるメディア (通知チャネル) (たとえば、深刻度が*重度の障害*および*致命的な障害*のトリガーの場合はSMS、その他の深刻度のトリガーの場合は電子メール) - トリガーの深刻度に対する条件によるアクションの制限 # 4 Triggers top 100 # 4 障害発生数上位100トリガー # 4 Update operations # 4 更新時実行 ##### 4 Update repository configuration package Before proceeding with the upgrade, uninstall your current repository package: rm -Rf /etc/apt/sources.list.d/zabbix.list Then, install the latest repository configuration package to ensure compatibility with the newest packages and to include any recent security patches or bug fixes. On **Debian 12**, run: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb dpkg -i zabbix-release_latest+debian12_all.deb On **Debian 11**, run: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian11_all.deb dpkg -i zabbix-release_latest+debian11_all.deb On **Debian 10**, run: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian10_all.deb dpkg -i zabbix-release_latest+debian10_all.deb For older Debian versions, replace the link above with the correct one from [Zabbix repository](https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/). Note, however, that packages for those versions may not include all Zabbix components. For a list of components included, see [Zabbix packages](https://www.zabbix.com/download?zabbix=6.0&os_distribution=debian&os_version=9&components=agent&db=&ws=). On **Ubuntu 24.04**, run: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb dpkg -i zabbix-release_latest+ubuntu24.04_all.deb On **Ubuntu 22.04**, run: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb dpkg -i zabbix-release_latest+ubuntu22.04_all.deb On **Ubuntu 20.04**, run: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu20.04_all.deb dpkg -i zabbix-release_latest+ubuntu20.04_all.deb On **Ubuntu 18.04**, run: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu18.04_all.deb dpkg -i zabbix-release_latest+ubuntu18.04_all.deb For older Ubuntu versions, replace the link above with the correct one from [Zabbix repository](https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/). Note, however, that packages for those versions may not include all Zabbix components. For a list of components included, see [Zabbix packages](https://www.zabbix.com/download?zabbix=6.0&os_distribution=ubuntu&os_version=16.04&components=agent&db=&ws=). You may see a prompt about the Zabbix repository configuration: Configuration file '/etc/apt/sources.list.d/zabbix.list' ==> Deleted (by you or by a script) since installation. ==> Package distributor has shipped an updated version. What would you like to do about it ? Your options are: Y or I : install the package maintainer's version N or O : keep your currently-installed version D : show the differences between the versions Z : start a shell to examine the situation The default action is to keep your current version. *** zabbix.list (Y/I/N/O/D/Z) [default=N] ? Enter `Y` (or `I`) to install the package maintainer's version of the Zabbix repository configuration. Then, update the repository information: apt update ##### 4 リポジトリ構成パッケージ更新 アップグレードを続行するには、現在のリポジトリパッケージをアンインストールする必要があります。 rm -Rf /etc/apt/sources.list.d/zabbix.list 次に、最新のリポジトリ構成パッケージをインストールして、最新のパッケージとの互換性を確保し、最新のセキュリティパッチやバグ修正を含めます。 **Debian 12**では次を実行します。 wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb dpkg -i zabbix-release_latest+debian12_all.deb **Debian 11**では次を実行します。 wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian11_all.deb dpkg -i zabbix-release_latest+debian11_all.deb **Debian 10**では次を実行します。 wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian10_all.deb dpkg -i zabbix-release_latest+debian10_all.deb 古いDebianバージョンの場合は、上記のリンクを[Zabbixリポジトリ](https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/)の正しいリンクに置き換えてください。 ただし、これらのバージョンのパッケージには、Zabbixコンポーネントが何か含まれていない可能性があることに注意してください。 含まれるコンポーネントのリストについては、[Zabbixパッケージ](https://www.zabbix.com/download?zabbix=6.0&os_distribution=debian&os_version=9&components=agent&db=&ws=)を参照してください。 **Ubuntu 24.04**では次を実行します。 wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb dpkg -i zabbix-release_latest+ubuntu24.04_all.deb **Ubuntu 22.04**では次を実行します。 wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb dpkg -i zabbix-release_latest+ubuntu22.04_all.deb **Ubuntu 20.04**では次を実行します。 wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu20.04_all.deb dpkg -i zabbix-release_latest+ubuntu20.04_all.deb **Ubuntu 18.04**では次を実行します。 wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu18.04_all.deb dpkg -i zabbix-release_latest+ubuntu18.04_all.deb 古いUbuntuバージョンの場合は、上記のリンクを[Zabbixリポジトリ](https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/)の正しいリンクに置き換えてください。 ただし、これらのバージョンのパッケージには、Zabbixコンポーネントが何か含まれていない可能性があることに注意してください。 含まれるコンポーネントのリストについては、[Zabbixパッケージ](https://www.zabbix.com/download?zabbix=6.0&os_distribution=ubuntu&os_version=16.04&components=agent&db=&ws=)を参照してください。 Zabbixリポジトリ設定に関するプロンプトが表示される場合があります。 Configuration file '/etc/apt/sources.list.d/zabbix.list' ==> Deleted (by you or by a script) since installation. ==> Package distributor has shipped an updated version. What would you like to do about it ? Your options are: Y or I : install the package maintainer's version N or O : keep your currently-installed version D : show the differences between the versions Z : start a shell to examine the situation The default action is to keep your current version. *** zabbix.list (Y/I/N/O/D/Z) [default=N] ? `Y` (または`I`)を入力して、パッケージ管理者のバージョンのZabbixリポジトリ設定をインストールします。 次に、リポジトリ情報を更新します。 apt update ##### 4 Update repository configuration package Before proceeding with the upgrade, update your current repository package to the latest version to ensure compatibility with the newest packages and to include any recent security patches or bug fixes. On **RHEL 9**, run: rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm On **RHEL 8**, run: rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-latest.el8.noarch.rpm For older RHEL versions, replace the link above with the correct one from [Zabbix repository](https://repo.zabbix.com/zabbix/6.0/rhel/). Note, however, that packages for those versions may not include all Zabbix components. For a list of components included, see [Zabbix packages](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=7&components=agent&db=&ws=). Then, clean up the `dnf` package manager's cache (including headers, metadata, and package files downloaded during previous installations or updates): dnf clean all On the next `dnf` operation, `dnf` will download fresh metadata from the repositories since the old metadata is cleared. See also: [Known issues](/manual/installation/known_issues#expired-signing-key-for-rhel-packages) for updating the repository configuration package on RHEL. ##### 4 リポジトリ構成パッケージ更新 アップグレードを続行する前に、現在のリポジトリパッケージを最新バージョンに更新して、最新のパッケージとの互換性を確保し、最新のセキュリティパッチやバグ修正を含めてください。 **RHEL 9**では次を実行します。 rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm **RHEL 8**では次を実行します。 rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-latest.el8.noarch.rpm 古いRHELバージョンの場合は、上記のリンクを[Zabbixリポジトリ](https://repo.zabbix.com/zabbix/6.0/rhel/)の正しいリンクに置き換えてください。) ただし、これらのバージョンのパッケージには、すべてのZabbixコンポーネントが含まれていない場合があることに注意してください。含まれるコンポーネントのリストについては、[Zabbixパッケージ](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=7&components=agent&db=&ws=)。 次に、`dnf`パッケージマネージャーのキャッシュ (以前のインストールまたは更新中にダウンロードされたヘッダー、メタデータ、およびパッケージファイルを含む) をクリーンアップします。 dnf clean all 次の`dnf`操作で古いメタデータがクリアされるため、`dnf`はリポジトリから新しいメタデータをダウンロードします。 参照: RHELでのリポジトリ構成パッケージの更新に関する[既知の問題](/manual/installation/known_issues#expired-signing-key-for-rhel-packages)。 ##### 4 Update repository configuration package To proceed with the upgrade your current repository package has to be updated. # rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-6.0-1.el8.noarch.rpm ##### 4 リポジトリ構成パッケージ更新 アップグレードを続行するには、現在のリポジトリパッケージを更新する必要があります。 # rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-6.0-1.el8.noarch.rpm # 4 User groups # 4 ユーザーグループ # 4 Using macros in messages # 4 メッセージでのマクロ使用 # 4 Webhook # 4 Webhook # 4 Windows agent installation from MSI # 4 MSIでWindowsエージェントのインストール # 4 Zabbix agent 2 plugin protocol Please refer to the [connection protocol](https://www.zabbix.com/documentation/guidelines/en/plugins#connection-protocol) section on *Building plugins* page for more information. # 4 Zabbixエージェント2プラグインのプロトコル 詳細については、*プラグインの構築*ページの [接続プロトコル](https://www.zabbix.com/documentation/guidelines/en/plugins#connection-protocol)セクションを参照してください。 # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 Zabbixエージェント2プラグインプロトコル Zabbixエージェント2プロトコルはコード、サイズ、データ モデルに基づいています。 # 4 Zabbix agent 2 (UNIX) # 4 Zabbix エージェント 2 (UNIX) # 4 Zabbix overview # 4 Zabbixの概要 # 50 Upgrade notes for 6.0.40 This minor version does not have any upgrade notes. # 50 6.0.40へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 51 Upgrade notes for 6.0.41 # 51 6.0.41へアップグレード時の注意点 # 52 Upgrade notes for 6.0.42 This minor version does not have any upgrade notes. # 52 6.0.42へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 54 Upgrade notes for 6.0.44 This minor version does not have any upgrade notes. # 54 6.0.44へアップグレード時の注意点 このマイナーバージョンには、留意すべき点はありません。 # 5 Actions # 5 アクション # 5 Audit # 5 監査 # 5 Configuration # 5 設定 # 5 CSV to JSON preprocessing # 5 CSVからJSONへの保存前処理 # 5 Customizing trigger severities Trigger severity names and colors for severity related GUI elements can be configured in *Administration → General → Trigger displaying options*. Colors are shared among all GUI themes. # 5 トリガーの深刻度のカスタマイズ GUIに関連づけられているトリガーの深刻度の名称および色については、*管理 → 一般 → トリガー表示オプション* で設定することができます。 色はすべてのGUIテーマで共有されます。 # 5 Discovery of JMX objects # 5 JMXオブジェクトの検出 # 5 Discovery rules Please use the sidebar to see discovery rule configuration examples for various cases. # 5 ディスカバリルール サイドバーから、さまざまなケースのディスカバリルール設定例を確認してください。 # 5 Escalations # 5 エスカレーション # 5 Event correlation # 5 イベント相関 # 5 Expression macros # 5 式マクロ # 5 Favorite graphs # 5 お気に入りのグラフ # 5 Frontend maintenance mode # 5 フロントエンドメンテナンスモード # 5 Installation from containers # 5 コンテナでのインストール # 5 Java gateway # 5 Zabbix Javaゲートウェイ # 5 Mac OS agent installation from PKG # 5 PKGでMacOSエージェントのインストール # 5 Maps [comment]: # (tags: map) # 5 マップ [comment]: # (tags: map) # 5 Media types # 5 メディアタイプ # 5 Minimum permission level for Windows agent items # 5 Windowsエージェントアイテムの最小アクセス許可レベル # 5 Modbus plugin # 5 Modbusプラグイン # 5 Quickstart Please use the sidebar to access content in the Quickstart section. # 5. クイックスタート サイドバーから、参照したい項目を選択してください。 # 5 Receiving problem notification # 5 障害発生の通知 ##### 5 Start new Zabbix agent Start the new Zabbix agent. Check log files to see if the agent has started successfully. ##### 5 新しいZabbixエージェントの起動 新しいZabbixエージェントを起動し、ログファイルをチェックして、エージェントが正常に起動したかどうかを確認します。 ##### 5 Start new Zabbix proxy Start the new Zabbix proxy. Check log files to see if the proxy has started successfully. Zabbix proxy will automatically upgrade the database. Database upgrade takes place similarly as when starting [Zabbix server](/manual/installation/upgrade/sources#start-new-zabbix-binaries). ##### 5 新しいZabbixプロキシの起動 新しいZabbixプロキシを起動し、ログファイルをチェックしてプロキシが正常に開始されたかどうかを確認してください。 Zabbixプロキシはデータベースを自動的にアップグレードします。データベースのアップグレードは、[Zabbixサーバー](/manual/installation/upgrade/sources#start-new-zabbix-binaries)を起動するときと同様に行われます。 # 5 TimescaleDB setup # 5 TimescaleDBのセットアップ ##### 5 Upgrade Zabbix components To upgrade Zabbix components you may run something like: apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent - If using PostgreSQL, substitute `mysql` with `pgsql` in the command. - If upgrading the proxy, substitute `server` with `proxy` in the command. - If upgrading the Zabbix agent 2, substitute `zabbix-agent` with `zabbix-agent2 zabbix-agent2-plugin-*` in the command. ::: noteimportant Upgrading Zabbix agent 2 with the `apt install zabbix-agent2` command could lead to an error. For more information, see [*Known issues*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older). ::: You may see a prompt about the Zabbix server (or proxy) configuration: Configuration file '/etc/zabbix/zabbix_server.conf' ==> Modified (by you or by a script) since installation. ==> Package distributor has shipped an updated version. What would you like to do about it ? Your options are: Y or I : install the package maintainer's version N or O : keep your currently-installed version D : show the differences between the versions Z : start a shell to examine the situation The default action is to keep your current version. *** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ? Enter the option that best fits your situation. For example, enter `D` to compare the current and new configuration, then decide if you want to install the package maintainer's version (`Y` or `I`). Then, to upgrade the web frontend with Apache and restart Apache, run: apt install zabbix-apache-conf systemctl restart apache2 Distributions **prior to Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster)** do not provide PHP 7.2 or newer, which is required for Zabbix frontend 6.0. See [information](/manual/installation/frontend/frontend_on_debian) about installing Zabbix frontend on older distributions. ##### 5 Zabbixコンポーネントのアップグレード Zabbixコンポーネントをアップグレードするには、次を実行します。 apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent - PostgreSQLを使用している場合は、コマンドの`mysql`を`pgsql`に置き換えます。 - プロキシをアップグレードする場合は、コマンドの`server`を`proxy`に置き換えてください。 - エージェント2をアップグレードする場合は、コマンドの`zabbix-agent`を`zabbix-agent2 zabbix-agent2-plugin-*`に置き換えてください。 ::: noteimportant `apt install zabbix-agent2`コマンドを使用してZabbixエージェント2をアップグレードすると、エラーが発生する可能性があります。 詳細については[*既知の問題*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older)を参照してください。 ::: Zabbixサーバー (またはプロキシ)の設定に関するプロンプトが表示される場合があります。 Configuration file '/etc/zabbix/zabbix_server.conf' ==> Modified (by you or by a script) since installation. ==> Package distributor has shipped an updated version. What would you like to do about it ? Your options are: Y or I : install the package maintainer's version N or O : keep your currently-installed version D : show the differences between the versions Z : start a shell to examine the situation The default action is to keep your current version. *** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ? 状況に最も適したオプションを入力してください。 たとえば、`D`と入力して現在の設定と新しい設定を比較し、パッケージ管理者のバージョン (`Y`または`I`) をインストールするかどうかを決定します。 次に、Apacheを使用したWebフロントエンドをアップグレードし、再起動するには、次を実行します apt install zabbix-apache-conf systemctl restart apache2 ディストリビューション**Debian10 (buster)/Ubuntu 18.04 (bionic)/Raspbian 10(buster)**より前のバージョンは、Zabbixフロントエンド6.0に必要なPHP7.2以降を提供していません。古いディストリビューションへのZabbixフロントエンドのインストールについては、[情報](/manual/installation/frontend/frontend_on_debian)を参照してください。 ##### 5 Upgrade Zabbix components To upgrade Zabbix components you may run something like: dnf install zabbix-server-mysql zabbix-web-mysql zabbix-agent - If using PostgreSQL, substitute `mysql` with `pgsql` in the command. - If upgrading the proxy, substitute `server` with `proxy` in the command. - If upgrading the agent 2, substitute `zabbix-agent` with `zabbix-agent2 zabbix-agent2-plugin-*` in the command. ::: noteimportant Upgrading Zabbix agent 2 with the `dnf install zabbix-agent2` command could lead to an error. For more information, see [*Known issues*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older). ::: Then, to upgrade the web frontend with Apache and restart Apache, run: dnf install zabbix-apache-conf systemctl restart httpd ##### 5 Zabbixコンポーネントのアップグレード Zabbixコンポーネントをアップグレードするには、次のようなコマンドを実行します。 dnf install zabbix-server-mysql zabbix-web-mysql zabbix-agent - PostgreSQLを使用している場合は、コマンドの`mysql`を`pgsql`に置き換えます。 - プロキシをアップグレードする場合は、コマンドの`server`を`proxy`に置き換えます。 - エージェント2をアップグレードする場合は、コマンドの`zabbix-agent`を`zabbix-agent2 zabbix-agent2-plugin-*`に置き換えます。 ::: noteimportant 'dnf install zabbix-agent2'コマンドを使用して Zabbixエージェント2をアップグレードすると、エラーが発生する可能性があります。 詳細については[*既知の問題点*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older)を参照してください。 ::: 次に、Apacheを使用したWebフロントエンドをアップグレードし、再起動するには、次のコマンドを実行します。 dnf install zabbix-apache-conf systemctl restart httpd ##### 5 Upgrade Zabbix components To upgrade Zabbix components you may run something like: # yum upgrade zabbix-server-mysql zabbix-web-mysql zabbix-agent If using PostgreSQL, substitute `mysql` with `pgsql` in the command. If upgrading the proxy, substitute `server` with `proxy` in the command. If upgrading the agent 2, substitute `zabbix-agent` with `zabbix-agent2` in the command. To upgrade the web frontend with Apache **on RHEL 8** correctly, also run: # yum install zabbix-apache-conf and make the necessary [changes](/manual/installation/install_from_packages/rhel#zabbix_frontend_configuration) to this file. To upgrade the web frontend **on RHEL 7** follow [distribution-specific instructions](/manual/installation/frontend/frontend_on_rhel7) (extra steps are required to install PHP 7.2 or newer). ##### 5 Zabbixコンポーネントのアップグレード Zabbixコンポーネントをアップグレードするには、次を実行します。 # yum upgrade zabbix-server-mysql zabbix-web-mysql zabbix-agent PostgreSQLを使用している場合は、コマンドの`mysql`を`pgsql`に置き換えます。プロキシをアップグレードする場合は、コマンドの`server`を`proxy`に置き換えてください。エージェント2をアップグレードする場合は、コマンドの`zabbix-agent`を`zabbix-agent2`に置き換えてください。 Apacheを使用しているWebインターフェースを**RHEL8 **で正しくアップグレードするには、次を実行し、 # yum install zabbix-apache-conf このファイルに必要な[変更](/manual/installation/install_from_packages/rhel_centos#zabbix_frontend_configuration)を加えます。 **RHEL 7**でWebインターフェースをアップグレードするには[ディストリビューション固有の手順](/manual/installation/frontend/frontend_on_rhel7)に従ってください。（PHP 7.2以降をインストールするには追加の手順が必要です） # 5 User parameters # 5 ユーザーパラメータ # 5 User roles # 5 ユーザーの役割 # 5 Web scenarios # 5 Web シナリオ # 5 Web scenarios # 5 Webシナリオ # 5 What's new in Zabbix 6.0.0 See [breaking changes](#breaking_changes) for this version. # 5 Zabbix 6.0.0の新機能 このバージョンには[重大な変更](#重大な変更)があります。 # 5 Zabbix agent (Windows) # 5 Zabbix エージェント (Windows) # 5 Zabbix sender protocol Please refer to the [trapper item](/manual/appendix/items/trapper) page for more information. # 5 Zabbix sender プロトコル 詳細については[トラッパーアイテム](/manual/appendix/items/trapper)ページを参照してください。 ### 6.0.13 ### 6.0.13 ### 6.0.14 ### 6.0.14 ### 6.0.15 ### 6.0.15 ### 6.0.19 ### 6.0.19 ### 6.0.22 ### 6.0.22 ### 6.0.3 ### 6.0.3 ### 6.0.34 ### 6.0.34 ### 6.0.38 ### 6.0.38 ### 6.0.39 ### 6.0.39 ### 6.0.7 ### 6.0.7 ### 6.0.9 ### 6.0.9 ##### 64 bit Open MinGW environment (Windows command prompt) and navigate to *build/mingw* directory in the Zabbix source tree. Run: mingw32-make clean mingw32-make PCRE=c:\dev\pcre OPENSSL=c:\dev\openssl ::: noteclassic Both 32- and 64- bit versions can be built on a 64-bit platform, but only a 32-bit version can be built on a 32-bit platform. When working on the 32-bit platform, follow the same steps as for 64-bit version on 64-bit platform. ::: ##### 64 bit MinGW環境(Windowsコマンドプロンプト)を起動し、Zabbixソースツリーの*build/mingw*ディレクトリに移動します。 次のコマンドを実行します。 mingw32-make clean mingw32-make PCRE=c:\dev\pcre OPENSSL=c:\dev\openssl ::: noteclassic 32ビット版、64ビット版ともに64ビットプラットフォームでビルドすることができますが、32ビットプラットフォーム上でビルドできるのは32ビット版のみです。 32ビットプラットフォームで作業する場合は、64ビットプラットフォームの64ビット版と同じ手順を踏んでください。 ::: # 6 Action log # 6 アクションログ # 6 Administration # 6 管理 # 6 Custom LLD rules # 6 カスタムLLDルール # 6 Discovery # 6 ディスカバリ # 6 Discovery of IPMI sensors # 6 IPMIセンサーの検出 # 6 Elasticsearch setup ::: noteimportant Elasticsearch support is experimental! ::: Zabbix supports the storage of historical data by means of Elasticsearch instead of a database. Users can choose the storage place for historical data between a compatible database and Elasticsearch. The setup procedure described in this section is applicable to Elasticsearch version 7.X. In case an earlier or later version of Elasticsearch is used, some functionality may not work as intended. ::: notewarning If all history data is stored in Elasticsearch, trends are **not** calculated nor stored in the database. With no trends calculated and stored, the history storage period may need to be extended. ::: # 6 Elasticsearchのセットアップ ::: noteimportant Elasticsearchのサポートは試験的です！ ::: Zabbixはデータベースの代わりにElasticsearchを使用したヒストリデータの保存をサポートしています。ユーザーは、互換性のあるデータベースとElasticsearchの間でヒストリデータの保存場所を選択できます。このセクションで説明するセットアップ手順は、Elasticsearchバージョン7.Xに適用できます。以前のバージョンまたは新しいバージョンのElasticsearchを使用すると、一部の機能が意図したとおりに機能しない可能性があります。 ::: notewarning すべてのヒストリデータがElasticsearchに保存されている場合、トレンドは計算もデータベースにも**保存されません**。トレンドが計算および保存されていないため、ヒストリ保存期間を延長する必要がある場合があります。 ::: # 6 Encoding of returned values Zabbix server expects every returned text value in the UTF8 encoding. This is related to any type of checks: zabbix agent, ssh, telnet, etc. Different monitored systems/devices and checks can return non-ASCII characters in the value. For such cases, almost all possible zabbix keys contain an additional item key parameter - **<encoding>**. This key parameter is optional but it should be specified if the returned value is not in the UTF8 encoding and it contains non-ASCII characters. Otherwise the result can be unexpected and unpredictable. A description of behavior with different database backends in such cases follows. # 6 戻り値のエンコード Zabbixサーバーは、UTF8エンコーディングで返されるすべてのテキスト値を想定しています。これはZabbixエージェント、SSH、Telnetなどのあらゆるタイプのチェックに関連しています。 監視対象のさまざまなシステム/デバイスおよびチェックで、値に非ASCII文字が返される場合があります。このような場合、ほとんどすべてのzabbixキーには、追加のアイテムキーパラメーター - **<encoding>**が含まれています。このキーパラメーターはオプションですが、戻り値がUTF8エンコーディングではなく、非ASCII文字が含まれている場合は指定する必要があります。指定していないと結果が予期せぬ値になる可能性があります。 このような場合のさまざまなデータベースバックエンドでの動作の説明は次のとおりです。 # 6 Event correlation # 6 イベント相関関係 # 6 Favorite maps # 6 お気に入りのマップ # 6 Header # 6 ヘッダー # 6 Loadable modules # 6 ローダブルモジュール # 6 Log file monitoring [comment]: # (tags: logrt, logfile, log) # 6 ログファイル監視 [comment]: # (tags: logrt, logfile, log) # 6 Macros It is possible to use out-of-the-box [Supported macros](/manual/appendix/macros/supported_by_location) and [User macros supported by location](/manual/appendix/macros/supported_by_location_user). # 6 マクロ [サポートされているマクロ](/manual/appendix/macros/supported_by_location)と[ロケーションでサポートされているユーザーマクロ](/manual/appendix/macros/supported_by_location_user)をすぐに使用することができます。 # 6 Mass update # 6 一括アップデート # 6 MongoDB plugin # 6 MongoDBプラグイン # 6 New template # 6 新規テンプレート # 6 Page parameters # 6 ページパラメーター ##### 6 Review and edit configuration files - edit the Zabbix agent configuration file **/usr/local/etc/zabbix\_agentd.conf** You need to configure this file for every host with zabbix\_agentd installed. You must specify the Zabbix server **IP address** in the file. Connections from other hosts will be denied. - edit the Zabbix server configuration file **/usr/local/etc/zabbix\_server.conf** You must specify the database name, user and password (if using any). The rest of the parameters will suit you with their defaults if you have a small installation (up to ten monitored hosts). You should change the default parameters if you want to maximize the performance of Zabbix server (or proxy) though. - if you have installed a Zabbix proxy, edit the proxy configuration file **/usr/local/etc/zabbix\_proxy.conf** You must specify the server IP address and proxy hostname (must be known to the server), as well as the database name, user and password (if using any). ::: noteclassic With SQLite the full path to database file must be specified; DB user and password are not required. ::: ##### 6 設定ファイルの確認と編集 - Zabbixエージェント設定ファイル**/usr/local/etc/zabbix\_agentd.conf**を編集します zabbix\_agentdがインストールされているすべてのホストに対してこのファイルを設定する必要があります。 ファイル内でZabbixサーバーの**IPアドレス**を指定する必要があります。 他のホストからの接続は拒否されます。 - Zabbixサーバー設定ファイル**/usr/local/etc/zabbix\_server.conf**を編集します データベース名、ユーザー、およびパスワード (使用している場合) を指定する必要があります。 小規模なインストール (監視対象ホストが最大10台) の場合、残りのパラメーターはデフォルトのままで問題ありません。 ただし、Zabbixサーバー (またはプロキシ) のパフォーマンスを最大化したい場合は、デフォルトのパラメーターを変更する必要があります。 - Zabbixプロキシをインストールしている場合は、プロキシ設定ファイル**/usr/local/etc/zabbix\_proxy.conf**を編集します サーバーのIPアドレスとプロキシのホスト名 (サーバーに認識されている必要がある)、およびデータベース名、ユーザー、およびパスワード (使用している場合) を指定する必要があります。 ::: noteclassic SQLiteでは、データベースファイルへのフルパスを指定する必要があります。 DBユーザーとパスワードは必要ありません。 ::: ##### 6 Review component configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_600) to check if any changes in the configuration parameters are required. ##### 6 コンポーネント設定パラメーターの確認 必ず[アップグレード時の注意点](/manual/installation/upgrade_notes_600)を参照して、設定パラメーターの変更が必要かどうかを確認してください。 ##### 6 Review component configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_600) to check if any changes in the configuration parameters are required. ##### 6 コンポーネント設定パラメーターの確認 必ず[アップグレード時の注意点](/manual/installation/upgrade_notes_600)を参照して、設定パラメーターの変更が必要かどうかを確認してください。 ##### 6 Review component configuration parameters See the upgrade notes for details on [mandatory changes](/manual/installation/upgrade_notes_600#configuration_parameters). ##### 6 コンポーネント構成パラメーター確認 [必須の変更](/manual/installation/upgrade_notes_600#configuration_parameters)の詳細については、アップグレードノートを参照してください。 # 6 Sender # 6 zabbix_senderコマンド ##### 6 Start new Zabbix binaries Start new binaries. Check log files to see if the binaries have started successfully. Zabbix server will automatically upgrade the database. When starting up, Zabbix server reports the current (mandatory and optional) and required database versions. If the current mandatory version is older than the required version, Zabbix server automatically executes the required database upgrade patches. The start and progress level (percentage) of the database upgrade is written to the Zabbix server log file. When the upgrade is completed, a "database upgrade fully completed" message is written to the log file. If any of the upgrade patches fail, Zabbix server will not start. Zabbix server will also not start if the current mandatory database version is newer than the required one. Zabbix server will only start if the current mandatory database version corresponds to the required mandatory version. 8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000 8673:20161117:104750.259 required mandatory version: 03040000 Before you start the server: - Make sure the database user has enough permissions (create table, drop table, create index, drop index) - Make sure you have enough free disk space. ##### 6 新しいZabbixバイナリの開始 新しいバイナリを開始します。ログファイルをチェックして、バイナリが正常に開始されたかどうかを確認します。 Zabbixサーバーはデータベースを自動的にアップグレードします。起動時に、Zabbixサーバーは現在の（必須およびオプションの）データベースバージョンと必要なデータベースバージョンを確認します。現在の必須バージョンが必要なバージョンよりも古い場合、Zabbixサーバーは必要なデータベースアップグレードパッチを自動的に実行します。データベースアップグレードの開始レベルと進行レベル（パーセンテージ）は、Zabbixサーバーのログファイルに書き込まれます。アップグレードが完了すると、「データベースのアップグレードが完全に完了しました」というメッセージがログファイルに書き込まれます。アップグレードパッチのいずれかが失敗した場合、Zabbixサーバーは起動しません。現在のデータベースバージョンが必要なバージョンよりも新しい場合も、Zabbixサーバーは起動しません。 Zabbixサーバーは、現在のデータベースバージョンがバージョンに対応している場合にのみ起動します。 8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000 8673:20161117:104750.259 required mandatory version: 03040000 サーバーを起動する前に： - データベースユーザーに十分な権限があることを確認してください（テーブルの作成、テーブルの削除、インデックスの作成、インデックスの削除） - 十分な空きディスク容量があることを確認してください。 # 6 Supported functions Click on the respective function group to see more details. |Function group|Functions| |--|--------| |[Aggregate functions](/manual/appendix/functions/aggregate)|avg, bucket\_percentile, count, histogram\_quantile, item\_count, kurtosis, mad, max, min, skewness, stddevpop, stddevsamp, sum, sumofsquares, varpop, varsamp| |[Bitwise functions](/manual/appendix/functions/bitwise)|bitand, bitlshift, bitnot, bitor, bitrshift, bitxor| |[Date and time functions](/manual/appendix/functions/time)|date, dayofmonth, dayofweek, now, time| |[History functions](/manual/appendix/functions/history)|change, changecount, count, countunique, find, first, fuzzytime, last, logeventid, logseverity, logsource, monodec, monoinc, nodata, percentile, rate| |[Trend functions](/manual/appendix/functions/trends)|baselinedev, baselinewma, trendavg, trendcount, trendmax, trendmin, trendstl, trendsum| |[Mathematical functions](/manual/appendix/functions/math)|abs, acos, asin, atan, atan2, avg, cbrt, ceil, cos, cosh, cot, degrees, e, exp, expm1, floor, log, log10, max, min, mod, pi, power, radians, rand, round, signum, sin, sinh, sqrt, sum, tan, truncate| |[Operator functions](/manual/appendix/functions/operator)|between, in| |[Prediction functions](/manual/appendix/functions/prediction)|forecast, timeleft| |[String functions](/manual/appendix/functions/string)|ascii, bitlength, bytelength, char, concat, insert, left, length, ltrim, mid, repeat, replace, right, rtrim, trim| These functions are supported in [trigger expressions](/manual/config/triggers/expression) and [calculated items](/manual/config/items/itemtypes/calculated). # 6 サポートされている関数 それぞれの関数グループをクリックして詳細を表示します。 |関数グループ|関数| |--|--------| |[集計関数](/manual/appendix/functions/aggregate)|avg, bucket\_percentile, count, histogram\_quantile, item\_count, kurtosis, mad, max, min, skewness, stddevpop, stddevsamp, sum, sumofsquares, varpop, varsamp| |[ビット関数](/manual/appendix/functions/bitwise)|bitand, bitlshift, bitnot, bitor, bitrshift, bitxor| |[日時関数](/manual/appendix/functions/time)|date, dayofmonth, dayofweek, now, time| |[履歴関数](/manual/appendix/functions/history)|change, changecount, count, countunique, find, first, fuzzytime, last, logeventid, logseverity, logsource, monodec, monoinc, nodata, percentile, rate| |[トレンド関数](/manual/appendix/functions/trends)|baselinedev, baselinewma, trendavg, trendcount, trendmax, trendmin, trendstl, trendsum| |[数学関数](/manual/appendix/functions/math)|abs, acos, asin, atan, atan2, avg, cbrt, ceil, cos, cosh, cot, degrees, e, exp, expm1, floor, log, log10, max, min, mod, pi, power, radians, rand, round, signum, sin, sinh, sqrt, sum, tan, truncate| |[オペレーター関数](/manual/appendix/functions/operator)|between, in| |[予測関数](/manual/appendix/functions/prediction)|forecast, timeleft| |[文字列関数](/manual/appendix/functions/string)|ascii, bitlength, bytelength, char, concat, insert, left, length, ltrim, mid, repeat, replace, right, rtrim, trim| これらの関数は[トリガー式](/manual/config/triggers/expression) および [計算項目](/manual/config/items/itemtypes/calculated) でサポートされています。 # 6 Supported functions Click on the respective function group to see more details. |Function group|Functions| |--------------|---------| |[Aggregate functions](/manual/appendix/functions/aggregate)|avg, bucket\_percentile, count, histogram\_quantile, item\_count, kurtosis, mad, max, min, skewness, stddevpop, stddevsamp, sum, sumofsquares, varpop, varsamp| |[Bitwise functions](/manual/appendix/functions/bitwise)|bitand, bitlshift, bitnot, bitor, bitrshift, bitxor| |[Date and time functions](/manual/appendix/functions/time)|date, dayofmonth, dayofweek, now, time| |[History functions](/manual/appendix/functions/history)|change, changecount, count, countunique, first, fuzzytime, last, logeventid, logseverity, logsource, monodec, monoinc, nodata, percentile, rate, trendavg, trendcount, trendmax, trendmin, trendstl, trendsum| |[Mathematical functions](/manual/appendix/functions/math)|abs, acos, asin, atan, atan2, avg, cbrt, ceil, cos, cosh, cot, degrees, e, exp, expm1, floor, log, log10, max, min, mod, pi, power, radians, rand, round, signum, sin, sinh, sqrt, sum, tan, truncate| |[Operator functions](/manual/appendix/functions/operator)|between, in| |[Prediction functions](/manual/appendix/functions/prediction)|forecast, timeleft| |[String functions](/manual/appendix/functions/string)|ascii, bitlength, bytelength, char, concat, find, insert, left, length, ltrim, mid, repeat, replace, right, rtrim, trim| These functions are supported in [trigger expressions](/manual/config/triggers/expression) and [calculated items](/manual/config/items/itemtypes/calculated). # 6 Supported functions Click on the respective function group to see more details. |Function group|Functions| |--------------|---------| |[Aggregate functions](/manual/appendix/functions/aggregate)|avg, bucket\_percentile, count, histogram\_quantile, item\_count, kurtosis, mad, max, min, skewness, stddevpop, stddevsamp, sum, sumofsquares, varpop, varsamp| |[Bitwise functions](/manual/appendix/functions/bitwise)|bitand, bitlshift, bitnot, bitor, bitrshift, bitxor| |[Date and time functions](/manual/appendix/functions/time)|date, dayofmonth, dayofweek, now, time| |[History functions](/manual/appendix/functions/history)|change, changecount, count, countunique, first, fuzzytime, last, logeventid, logseverity, logsource, monodec, monoinc, nodata, percentile, rate, trendavg, trendcount, trendmax, trendmin, trendsum| |[Mathematical functions](/manual/appendix/functions/math)|abs, acos, asin, atan, atan2, avg, cbrt, ceil, cos, cosh, cot, degrees, e, exp, expm1, floor, log, log10, max, min, mod, pi, power, radians, rand, round, signum, sin, sinh, sqrt, sum, tan, truncate| |[Operator functions](/manual/appendix/functions/operator)|between, in| |[Prediction functions](/manual/appendix/functions/prediction)|forecast, timeleft| |[String functions](/manual/appendix/functions/string)|ascii, bitlength, bytelength, char, concat, find, insert, left, length, ltrim, mid, repeat, replace, right, rtrim, trim| These functions are supported in [trigger expressions](/manual/config/triggers/expression) and [calculated items](/manual/config/items/itemtypes/calculated). # 6 Tagging # 6 タグ付け # 6 Unstable releases # 6 不安定版リリース # 6 Users # 6 ユーザー # 6 Web interface installation This section provides step-by-step instructions for installing Zabbix web interface. Zabbix frontend is written in PHP, so to run it a PHP supported webserver is needed. # 6 Webインターフェースのインストール このセクションでは、Zabbix Webインターフェースをインストールする手順を説明します。ZabbixフロントエンドはPHPで書かれているため、PHPをサポートするWebサーバーが必要です。 # 6 What's new in Zabbix 6.0.1 # 6 Zabbix 6.0.1の新機能 # 6 Zabbix agent 2 (Windows) # 6 Zabbix エージェント 2 (Windows) # 6. Zabbix appliance # 6. Zabbixアプライアンス # 7 Configuration Please use the sidebar to access content in the Configuration section. # 7. 設定 サイドバーから、参照したい項目を選択してください。 # 7 Definitions # 7 定義 # 7 Discovery # 7 ディスカバリ # 7 Discovery of systemd services # 7 systemdサービスの検出 # 7 Geomap # 7 地理マップ # 7 Geomap # 7 Geomap # 7 Get # 7 zabbix_getコマンド ##### 7 Install new Zabbix web interface The minimum required PHP version is 7.2.5. Update if needed and follow [installation instructions](/manual/installation/frontend). ##### 7 新しいウェブインターフェースのインストール 要求PHPバージョンは7.2.5です。必要に応じて更新し[インストール手順](/manual/installation/frontend)に従ってください。 # 7 Media types # 7 メディアタイプ # 7 MQTT plugin # 7 MQTTプラグイン # 7 Notifications # 7 通知レポート # 7 Operator functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) Some general notes on function parameters: - Function parameters are separated by a comma - Expressions are accepted as parameters |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**between** (value,min,max)|<|<| |Check if a value belongs to the given range.|**value** - value to check<br>**min** - minimum value<br>**max** - maximum value|Supported value types: integer, float<br><br>Returns:<br>1 - in range<br>0 - otherwise<br><br>Example:<br>=> **between**(last(/host/key),**1**,**10**)=1 - trigger if the value is between 1 and 10.| |**in** (value,value1,value2,...valueN)|<|<| |Check if a value is equal to at least one of the listed values.|**value** - value to check<br>**value1,value2,...valueN** - listed values (string values must be double-quoted)|Supported value types: all<br><br>Returns:<br>1 - if equal<br>0 - otherwise<br><br>The value is compared to the listed values as numbers, if all of these values can be converted to numeric; otherwise compared as strings.<br><br>Example:<br>=> **in**(last(/host/key),**5**,**10**)=1 - trigger if the last value is equal to 5 or 10<br>=> **in**(**"text"**, last(/host/key),last(/host/key,\#2))=1 - trigger if "text" is equal to either of the last 2 values.| # 7 オペレーター関数 ここにリストされているすべての機能は、次でサポートされています。 - [トリガー式](/manual/config/triggers/expression) - [計算項目](/manual/config/items/itemtypes/calculated) 関数パラメーターに関する一般的な注意事項: - 関数パラメータはコンマで区切られます - 式はパラメーターとして受け入れられます |関数|<|<| |--|--|--| |**説明**|**関数固有のパラメーター**|**コメント**| |**between** (value,min,max)|<|<| |値が指定された範囲内かどうかを確認します。|**value** - チェックする値<br>**min** - 最小値<br>**max** - 最大値|サポートされている型: integer, float<br><br>戻り値:<br>1 - 範囲内<br>0 - 範囲外<br><br>例:<br>=> **between**(last(/host/key),**1**,**10**)=1 - 値が 1 ～ 10 の場合にトリガーします| |**in** (value,value1,value2,...valueN)|<|<| |値がリストされた値の少なくとも 1 つと等しいかどうかを確認します。|**value** - チェックする値<br>**value1,value2,...valueN** - リストされた値 (文字列値は二重引用符で囲む必要があります)|サポートされている型: すべて<br><br>戻り値:<br>1 - 等しい値がある<br>0 - 等しい値が無い<br><br>これらの値がすべて数値に変換できる場合、値は数値としてリストされた値と比較されます。 それ以外の場合は文字列として比較されます。<br><br>例:<br>=> **in**(last(/host/key),**5**,**10**)=1 - 最後の値が 5 または 10 の場合にトリガーする<br>=> **in**(**"text"**, last(/host/key),last(/host/key,\#2))=1 - "text"が最後の 2 つの値のいずれかと等しい場合にトリガーします| # 7 Predictive trigger functions # 7 予測トリガー関数 # 7 Real-time export of events, item values, trends # 7 イベント、アイテム値、トレンドのリアルタイムエクスポート # 7 Real-time export protocol This section presents details of the [real-time export](/manual/appendix/install/real_time_export) protocol in a newline-delimited JSON format for: - [trigger events](#trigger_events) - [item values](#item_values) - [trends](#trends) All files have a .ndjson extension. Each line of the export file is a JSON object. # 7 リアルタイムエクスポートプロトコル このセクションでは[リアルタイムエクスポート](/manual/appendix/install/real_time_export)プロトコルの詳細を改行区切りのJSON形式で示します。 - [トリガーイベント](#trigger_events) - [アイテム値](#item_values) - [トレンド](#trends) すべてのファイルの拡張子は.ndjsonです。 エクスポートファイルの各行はJSONオブジェクトです。 # 7 Services # 7 サービス # 7 Standardized templates for network devices # 7 ネットワークデバイス用の標準テンプレート ##### 7 Start Zabbix processes Start the updated Zabbix components. # systemctl start zabbix-server # systemctl start zabbix-proxy # systemctl start zabbix-agent # systemctl start zabbix-agent2 ##### 7 Zabbixプロセスの開始 更新されたZabbixコンポーネントを起動します。 # systemctl start zabbix-server # systemctl start zabbix-proxy # systemctl start zabbix-agent # systemctl start zabbix-agent2 ##### 7 Start Zabbix processes Start the updated Zabbix components. systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ##### 7 Zabbixプロセスの開始 更新されたZabbixコンポーネントを起動します。 systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ##### 7 Start Zabbix processes Start the updated Zabbix components. systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ##### 7 Zabbixプロセスの開始 更新されたZabbixコンポーネントを起動します。 # systemctl start zabbix-server # systemctl start zabbix-proxy # systemctl start zabbix-agent # systemctl start zabbix-agent2 # 7 Unit symbols # 7 単位記号 # 7 Upgrade procedure [comment]: # (tags: upgrade) # 7 アップグレード手順 # 7 Visualization # 7 視覚化 # 7 What's new in Zabbix 6.0.2 # 7 Zabbix 6.0.2の新機能 # 7 Windows performance counters # 7 Windows パフォーマンスカウンタ # 7 Zabbix agent 2 plugins # 7 Zabbix エージェント 2 プラグイン ##### 8 Clear web browser cookies and cache After the upgrade you may need to clear web browser cookies and web browser cache for the Zabbix web interface to work properly. ##### 8 Webブラウザのクッキーとキャッシュのクリア アップグレード後、Zabbix Webインターフェースが正しく機能するために、Webブラウザのクッキーとキャッシュのクリアが必要になる場合があります。 ##### 8 Clear web browser cookies and cache After the upgrade you may need to clear web browser cookies and web browser cache for the Zabbix web interface to work properly. ##### 8 ウェブブラウザのクッキーとキャッシュのクリア アップグレード後、Zabbix ウェブインターフェイスが正しく機能するために、ウェブブラウザのクッキーとキャッシュのクリアが必要になる場合があります。 ##### 8 Clear web browser cookies and cache After the upgrade you may need to clear web browser cookies and web browser cache for the Zabbix web interface to work properly. ##### 8 Webブラウザのクッキーとキャッシュのクリア アップグレード後、Zabbix Webインターフェースが正しく機能するために、Webブラウザのクッキーとキャッシュのクリアが必要になる場合があります。 ##### 8 Clear web browser cookies and cache After the upgrade you may need to clear web browser cookies and web browser cache for the Zabbix web interface to work properly. ##### 8 Webブラウザのクッキーとキャッシュのクリア アップグレード後、Zabbix Webインターフェースが正しく機能するために、Webブラウザのクッキーとキャッシュのクリアが必要になる場合があります。 # 8 Creating your own theme # 8 独自テーマ作成 # 8 Discovery of Windows services # 8 Windowsサービスの検出 # 8 Distribution-specific notes on setting up Nginx for Zabbix # 8 Zabbix用Nginxのセットアップに関するディストリビューション固有の注意事項 # 8 Graph # 8 グラフ # 8 Graph # 8 Graph # 8 JS # 8 zabbix_jsコマンド # 8 Known issues See also: [Compilation issues](/manual/installation/known_issues/compilation_issues). # 8 既知の問題 参照: [コンパイルの問題](/manual/installation/known_issues/compilation_issues) # 8 Mass update # 8 一括アップデート # 8 MSSQL plugin # 8 MSSQLプラグイン # 8 Prediction functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) Some general notes on function parameters: - Function parameters are separated by a comma - Optional function parameters (or parameter parts) are indicated by `<` `>` - Function-specific parameters are described with each function - `/host/key` and `(sec|#num)<:time shift>` parameters must never be quoted # 8 予測関数 ここにリストされているすべての機能は、次でサポートされています。 - [トリガー式](/manual/config/triggers/expression) - [計算項目](/manual/config/items/itemtypes/calculated) 関数パラメーターに関する一般的な注意事項: - 関数パラメータはコンマで区切られます。 - オプションの関数パラメーター (またはパラメーター部分) は `<` `>` で示されます - 機能固有のパラメーターは、各機能で説明されています - `/host/key` と `(sec|#num)<:time shift>` はパラメータを引用符で囲んではいけません # 8 Scripts # 8 スクリプト # 8 Sensor Each sensor chip gets its own directory in the sysfs /sys/devices tree. To find all sensor chips, it is easier to follow the device symlinks from /sys/class/hwmon/hwmon\*, where \* is a real number (0,1,2,...). The sensor readings are located either in /sys/class/hwmon/hwmon\*/ directory for virtual devices, or in /sys/class/hwmon/hwmon\*/device directory for non-virtual devices. A file, called name, located inside hwmon\* or hwmon\*/device directories contains the name of the chip, which corresponds to the name of the kernel driver used by the sensor chip. There is only one sensor reading value per file. The common scheme for naming the files that contain sensor readings inside any of the directories mentioned above is: <type><number>\_<item>, where - **type** - for sensor chips is "in" (voltage), "temp" (temperature), "fan" (fan), etc., - **item** - "input" (measured value), "max" (high threshold), "min" (low threshold), etc., - **number** - always used for elements that can be present more than once (usually starts from 1, except for voltages which start from 0). If files do not refer to a specific element they have a simple name with no number. The information regarding sensors available on the host can be acquired using **sensor-detect** and **sensors** tools (lm-sensors package: <http://lm-sensors.org/>). **Sensors-detect** helps to determine which modules are necessary for available sensors. When modules are loaded the **sensors** program can be used to show the readings of all sensor chips. The labeling of sensor readings, used by this program, can be different from the common naming scheme (<type><number>\_<item> ): - if there is a file called <type><number>\_label, then the label inside this file will be used instead of <type><number><item> name; - if there is no <type><number>\_label file, then the program searches inside the /etc/sensors.conf (could be also /etc/sensors3.conf, or different) for the name substitution. This labeling allows user to determine what kind of hardware is used. If there is neither <type><number>\_label file nor label inside the configuration file the type of hardware can be determined by the name attribute (hwmon\*/device/name). The actual names of sensors, which zabbix\_agent accepts, can be obtained by running **sensors** program with -u parameter (**sensors -u**). In **sensor** program the available sensors are separated by the bus type (ISA adapter, PCI adapter, SPI adapter, Virtual device, ACPI interface, HID adapter). # 8 センサー 各センサーチップは、sysfs / sys/devicesツリーで独自のディレクトリを作成します。 すべてのセンサーチップを見つけるには/sys/class/hwmon/hwmon\*からデバイスのシンボリックリンクをたどる方が簡単です。ここでの\*は実数（0,1,2...）です。 センサーの読み取り値は、仮想デバイスの場合は/sys/class/hwmon/hwmon\*/ディレクトリに、非仮想デバイスの場合は/sys/class/hwmon/hwmon\*/deviceディレクトリにあります。 hwmon\*またはhwmon\*/deviceディレクトリ内にあるnameという名前のファイルには、センサーチップが使用するカーネルドライバーの名前に対応するチップの名前が含まれています。 センサー読み取り値はファイルごとに1つだけです。 上記のディレクトリ内のセンサー読み取り値を含むファイルに名前を付けるための一般的なスキームは次のとおりです。 <type><number>\_<item>, where -**タイプ**-センサーチップの場合、「in」（電圧）、「temp」（温度）、「fan」（ファン）などです。 -**項目**-「入力」（測定値）、「最大」（高しきい値）、「最小」（低しきい値）など、 -**数値**-複数回存在する可能性のある要素に常に使用されます（0から始まる電圧を除いて、通常は1から始まります）。 ファイルが特定の要素を参照していない場合、ファイルには番号のない単純な名前が付けられます。 - **type** - センサーチップの場合"in"（電圧）,"temp"（温度）,"fan"（ファン）など - **item** - "input" (測定値), "max" (高いしきい値), "min" (低いしきい値),など - **number** - 複数存在する可能性のある要素に常に使用されます。（0から始まる電圧を除いて、通常は1から始まります） ファイルが特定の要素を参照していない場合、ファイルには番号のない単純な名前が付けられます。 ホストで利用可能なセンサーに関する情報は、**Sensor-detect**および**sensors**ツール（lm-sensorsパッケージ：<http://lm-sensors.org/>）を使用して取得できます。** Sensors-detect **は、使用可能なセンサーに必要なモジュールを判別するのに役立ちます。 モジュールがロードされると、**センサー**プログラムを使用してすべてのセンサーチップの読み取り値を表示できます。 このプログラムで使用されるセンサー読み取り値のラベル付けは、一般的な命名スキーム(<type><number>\_<item> )とは異なる場合があります。 - <type><number>\_labelというファイルがある場合、このファイル内のラベルが<type><number><item>nameの代わりに使用されます。 - <type><number>\_labelファイルがない場合、プログラムは/etc/sensors.conf内（/etc/sensors3.conf等、別の名前へ置換も可能）を検索します。 このラベル付けにより、ユーザーは使用されているハードウェアの種類を判別できます。 構成ファイル内に<type><number>\_labelファイルもlabelもない場合、ハードウェアのタイプはname属性(hwmon\*/device/name)によって判別します。 zabbix\_agentが受け入れるセンサーの実際の名前は、-uパラメーターを指定して**sensors**プログラムを実行(**sensors -u**)することで取得できます。 **sensors**プログラムでは、使用可能なセンサーはバスタイプ（ISAアダプター、PCIアダプター、SPIアダプター、仮想デバイス、ACPIインターフェース、HIDアダプター）によって分けられています。 # 8. Service monitoring # 8. サービス監視 # 8 String functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) Some general notes on function parameters: - Function parameters are separated by a comma - Expressions are accepted as parameters - String parameters must be double-quoted; otherwise they might get misinterpreted - Optional function parameters (or parameter parts) are indicated by `<` `>` |FUNCTION|<|<|<| |--------|-|-|-| |<|**Description**|**Function-specific parameters**|**Comments**| |**ascii** (value)|<|<|<| |<|The ASCII code of the leftmost character of the value.|**value** - value to check|Supported value types: string, text, log<br><br>For example, a value like 'Abc' will return '65' (ASCII code for 'A').<br><br>Example:<br>=> **ascii**(last(/host/key))| |**bitlength** (value)|<|<|<| |<|The length of value in bits.|**value** - value to check|Supported value types: string, text, log, integer<br><br>Example:<br>=> **bitlength**(last(/host/key))| |**bytelength** (value)|<|<|<| |<|The length of value in bytes.|**value** - value to check|Supported value types: string, text, log, integer<br><br>Example:<br>=> **bytelength**(last(/host/key))| |**char** (value)|<|<|<| |<|Return the character by interpreting the value as ASCII code.|**value** - value to check|Supported value types: integer<br><br>The value must be in the 0-255 range. For example, a value like '65' (interpreted as ASCII code) will return 'A'.<br><br>Example:<br>=> **char**(last(/host/key))| |**concat** (value,string)|<|<|<| |<|The string resulting from concatenating the value to the specified string.|**value** - value to check<br>**string** - the string to concatenate to|Supported value types: string, text, log<br><br>For example, a value like 'Zab' concatenated to 'bix' (the specified string) will return 'Zabbix'.<br><br>Example:<br>=> **concat**(last(/host/key),**"bix"**)| |**insert** (value,start,length,replacement)|<|<|<| |<|Insert specified characters or spaces into the character string beginning at the specified position in the string.|**value** - value to check<br>**start** - start position<br>**length** - positions to replace<br>**replacement** - replacement string|Supported value types: string, text, log<br><br>For example, a value like 'Zabbbix' will be replaced by 'Zabbix' if 'bb' (starting position 3, positions to replace 2) is replaced by 'b'.<br><br>Example:<br>=> **insert**(last(/host/key),**3**,**2**,**"b"**)| |**left** (value,count)|<|<|<| |<|The leftmost characters of the value.|**value** - value to check<br>**count** - number of characters to return|Supported value types: string, text, log<br><br>For example, you may return 'Zab' from 'Zabbix' by specifying 3 leftmost characters to return.<br><br>Example:<br>=> **left**(last(/host/key),**3**) - return three leftmost characters<br><br>See also right().| |**length** (value)|<|<|<| |<|The length of value in characters.|**value** - value to check|Supported value types: str, text, log<br><br>Example:<br>=> **length**(last(/host/key)) → length of the latest value<br>=> **length**(last(/host/key,\#3)) → length of the third most recent value<br>=> **length**(last(/host/key,\#1:now-1d)) → length of the most recent value one day ago| |**ltrim** (value,<chars>)|<|<|<| |<|Remove specified characters from the beginning of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is left-trimmed by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **ltrim**(last(/host/key)) - remove whitespace from the beginning of string<br>=> **ltrim**(last(/host/key),**"Z"**) - remove any 'Z' from the beginning of string<br>=> **ltrim**(last(/host/key),**" Z"**) - remove any space and 'Z' from the beginning of string<br><br>See also: rtrim(), trim()| |**mid** (value,start,length)|<|<|<| |<|Return a substring of N characters beginning at the character position specified by 'start'.|**value** - value to check<br>**start** - start position of substring<br>**length** - positions to return in substring|Supported value types: string, text, log<br><br>For example, it is possible return 'abbi' from a value like 'Zabbix' if starting position is 2, and positions to return is 4).<br><br>Example:<br>=> **mid**(last(/host/key),**2**,**4**)="abbi"| |**repeat** (value,count)|<|<|<| |<|Repeat a string.|**value** - value to check<br>**count** - number of times to repeat|Supported value types: string, text, log<br><br>Example:<br>=> **repeat**(last(/host/key),**2**) - repeat the value two times| |**replace** (value,pattern,replacement)|<|<|<| |<|Find pattern in the value and replace with replacement. All occurrences of the pattern will be replaced.|**value** - value to check<br>**pattern** - pattern to find<br>**replacement** - string to replace the pattern with|Supported value types: string, text, log<br><br>Example:<br>=> **replace**(last(/host/key),**"ibb"**,**"abb"**) - replace all 'ibb' with 'abb'| |**right** (value,count)|<|<|<| |<|The rightmost characters of the value.|**value** - value to check<br>**count** - number of characters to return|Supported value types: string, text, log<br><br>For example, you may return 'bix' from 'Zabbix' by specifying 3 rightmost characters to return.<br><br>Example:<br>=> **right**(last(/host/key),**3**) - return three rightmost characters<br><br>See also left().| |**rtrim** (value,<chars>)|<|<|<| |<|Remove specified characters from the end of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is right-trimmed by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **rtrim**(last(/host/key)) - remove whitespace from the end of string<br>=> **rtrim**(last(/host/key),**"x"**) - remove any 'x' from the end of string<br>=> **rtrim**(last(/host/key),**"x "**) - remove any 'x' or space from the end of string<br><br>See also: ltrim(), trim()| |**trim** (value,<chars>)|<|<|<| |<|Remove specified characters from the beginning and end of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is trimmed from both sides by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **trim**(last(/host/key)) - remove whitespace from the beginning and end of string<br>=> **trim**(last(/host/key),**"\_"**) - remove '\_' from the beginning and end of string<br><br>See also: ltrim(), rtrim()| # 8 String functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) Some general notes on function parameters: - Function parameters are separated by a comma - Expressions are accepted as parameters - String parameters must be double-quoted; otherwise they might get misinterpreted - Optional function parameters (or parameter parts) are indicated by `<` `>` |FUNCTION|<|<|<| |--------|-|-|-| |<|**Description**|**Function-specific parameters**|**Comments**| |**ascii** (value)|<|<|<| |<|The ASCII code of the leftmost character of the value.|**value** - value to check|Supported value types: string, text, log<br><br>For example, a value like 'Abc' will return '65' (ASCII code for 'A').<br><br>Example:<br>=> **ascii**(last(/host/key))| |**bitlength** (value)|<|<|<| |<|The length of value in bits.|**value** - value to check|Supported value types: string, text, log, integer<br><br>Example:<br>=> **bitlength**(last(/host/key))| |**bytelength** (value)|<|<|<| |<|The length of value in bytes.|**value** - value to check|Supported value types: string, text, log, integer<br><br>Example:<br>=> **bytelength**(last(/host/key))| |**char** (value)|<|<|<| |<|Return the character by interpreting the value as ASCII code.|**value** - value to check|Supported value types: integer<br><br>The value must be in the 0-255 range. For example, a value like '65' (interpreted as ASCII code) will return 'A'.<br><br>Example:<br>=> **char**(last(/host/key))| |**concat** (value,string)|<|<|<| |<|The string resulting from concatenating the value to the specified string.|**value** - value to check<br>**string** - the string to concatenate to|Supported value types: string, text, log<br><br>For example, a value like 'Zab' concatenated to 'bix' (the specified string) will return 'Zabbix'.<br><br>Example:<br>=> **concat**(last(/host/key),**"bix"**)| |**insert** (value,start,length,replacement)|<|<|<| |<|Insert specified characters or spaces into the character string beginning at the specified position in the string.|**value** - value to check<br>**start** - start position<br>**length** - positions to replace<br>**replacement** - replacement string|Supported value types: string, text, log<br><br>For example, a value like 'Zabbbix' will be replaced by 'Zabbix' if 'bb' (starting position 3, positions to replace 2) is replaced by 'b'.<br><br>Example:<br>=> **insert**(last(/host/key),**3**,**2**,**"b"**)| |**left** (value,count)|<|<|<| |<|The leftmost characters of the value.|**value** - value to check<br>**count** - number of characters to return|Supported value types: string, text, log<br><br>For example, you may return 'Zab' from 'Zabbix' by specifying 3 leftmost characters to return.<br><br>Example:<br>=> **left**(last(/host/key),**3**) - return three leftmost characters<br><br>See also right().| |**length** (value)|<|<|<| |<|The length of value in characters.|**value** - value to check|Supported value types: str, text, log<br><br>Example:<br>=> **length**(last(/host/key)) → length of the latest value<br>=> **length**(last(/host/key,\#3)) → length of the third most recent value<br>=> **length**(last(/host/key,\#1:now-1d)) → length of the most recent value one day ago| |**ltrim** (value,<chars>)|<|<|<| |<|Remove specified characters from the beginning of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is left-trimmed by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **ltrim**(last(/host/key)) - remove whitespace from the beginning of string<br>=> **ltrim**(last(/host/key),**"Z"**) - remove any 'Z' from the beginning of string<br>=> **ltrim**(last(/host/key),**" Z"**) - remove any space and 'Z' from the beginning of string<br><br>See also: rtrim(), trim()| |**mid** (value,start,length)|<|<|<| |<|Return a substring of N characters beginning at the character position specified by 'start'.|**value** - value to check<br>**start** - start position of substring<br>**length** - positions to return in substring|Supported value types: string, text, log<br><br>For example, it is possible return 'abbi' from a value like 'Zabbix' if starting position is 2, and positions to return is 4).<br><br>Example:<br>=> **mid**(last(/host/key),**2**,**4**)="abbi"| |**repeat** (value,count)|<|<|<| |<|Repeat a string.|**value** - value to check<br>**count** - number of times to repeat|Supported value types: string, text, log<br><br>Example:<br>=> **repeat**(last(/host/key),**2**) - repeat the value two times| |**replace** (value,pattern,replacement)|<|<|<| |<|Find pattern in the value and replace with replacement. All occurrences of the pattern will be replaced.|**value** - value to check<br>**pattern** - pattern to find<br>**replacement** - string to replace the pattern with|Supported value types: string, text, log<br><br>Example:<br>=> **replace**(last(/host/key),**"ibb"**,**"abb"**) - replace all 'ibb' with 'abb'| |**right** (value,count)|<|<|<| |<|The rightmost characters of the value.|**value** - value to check<br>**count** - number of characters to return|Supported value types: string, text, log<br><br>For example, you may return 'bix' from 'Zabbix' by specifying 3 rightmost characters to return.<br><br>Example:<br>=> **right**(last(/host/key),**3**) - return three rightmost characters<br><br>See also left().| |**rtrim** (value,<chars>)|<|<|<| |<|Remove specified characters from the end of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is right-trimmed by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **rtrim**(last(/host/key)) - remove whitespace from the end of string<br>=> **rtrim**(last(/host/key),**"x"**) - remove any 'x' from the end of string<br>=> **rtrim**(last(/host/key),**"x "**) - remove any 'x' or space from the end of string<br><br>See also: ltrim(), trim()| |**trim** (value,<chars>)|<|<|<| |<|Remove specified characters from the beginning and end of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is trimmed from both sides by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **trim**(last(/host/key)) - remove whitespace from the beginning and end of string<br>=> **trim**(last(/host/key),**"\_"**) - remove '\_' from the beginning and end of string<br><br>See also: ltrim(), rtrim()| # 8 Templates # 8 テンプレート # 8 Time period syntax # 8 日時フォーマット # 8 What's new in Zabbix 6.0.3 # 8 Zabbix 6.0.3の新機能 # 8 Zabbix Java gateway If you use `startup.sh` and `shutdown.sh` scripts for starting [Zabbix Java gateway](/manual/concepts/java), then you can specify the necessary configuration parameters in the `settings.sh` file. The startup and shutdown scripts source the settings file and take care of converting shell variables (listed in the first column) to Java properties (listed in the second column). If you start Zabbix Java gateway manually by running `java` directly, then you specify the corresponding Java properties on the command line. |Variable|Property|Mandatory|Range|Default|Description| |--------|--------|---------|-----|-------|-----------| |LISTEN\_IP|zabbix.listenIP|no| |0.0.0.0|IP address to listen on.| |LISTEN\_PORT|zabbix.listenPort|no|1024-32767|10052|Port to listen on.| |PID\_FILE|zabbix.pidFile|no| |/tmp/zabbix\_java.pid|Name of PID file. If omitted, Zabbix Java Gateway is started as a console application.| |PROPERTIES\_FILE|zabbix.propertiesFile|no| | |Name of properties file. Can be used to set additional properties using a key-value format in such a way that they are not visible on a command line or to overwrite existing ones.<br>For example: "javax.net.ssl.trustStorePassword=<password>"| |START\_POLLERS|zabbix.startPollers|no|1-1000|5|Number of worker threads to start.| |TIMEOUT|zabbix.timeout|no|1-30|3|How long to wait for network operations.| ::: notewarning Port 10052 is not [IANA registered](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). ::: # 8 Zabbix Java ゲートウェイ [Zabbix Javaゲートウェイ](/manual/concepts/java)の起動に`startup.sh`および`shutdown.sh`スクリプトを使用する場合は、`settings.sh`ファイルで必要な設定パラメータを指定できます。 起動スクリプトとシャットダウンスクリプトは設定ファイルを取得し、シェル変数（最初の列にリストされている）をJavaプロパティ（2番目の列にリストされている）に変換します。 `java`を直接実行してZabbixJavaゲートウェイを手動で起動する場合は、コマンドラインで対応するJavaプロパティを指定します。 |変数|プロパティ|必須|範囲|デフォルト|説明| |--------|--------|---------|-----|-------|-----------| |LISTEN\_IP|zabbix.listenIP|no|<|0.0.0.0|待ち受けIPアドレス| |LISTEN\_PORT|zabbix.listenPort|no|1024-32767|10052|待ち受けポート番号| |PID\_FILE|zabbix.pidFile|no| |/tmp/zabbix_java.pid|PIDファイル名。 省略した場合、ZabbixJavaゲートウェイはコンソールアプリケーションとして起動されます。| |PROPERTIES\_FILE|zabbix.propertiesFile|no| | |プロパティファイルの名前。 コマンドラインに表示されないようにキー値形式を使用して追加のプロパティを設定したり、既存のプロパティを上書きしたりするために使用できます。<br>例:"javax.net.ssl.trustStorePassword=<password>"| |START_POLLERS|zabbix.startPollers|no|1-1000|5|開始するワーカースレッドの数| |TIMEOUT|zabbix.timeout|no|1-30|3|ネットワーク操作を待機する時間| ::: notewarning ポート10052は[IANA登録済み](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt)ではありません。 ::: # 9 Command execution Zabbix uses common functionality for external checks, user parameters, system.run items, custom alert scripts, remote commands and global scripts. # 9 コマンドの実行 Zabbixは、外部チェック、ユーザーパラメーター、system.runアイテム、カスタムアラートスクリプト、リモート コマンド、およびグローバルスクリプトに共通の機能を使用します。 # 9 Debug mode # 9 デバッグモード # 9 Discovery of Windows performance counter instances # 9 Windowsパフォーマンスカウンターインスタンスの検出 # 9 Graph (classic) # 9 グラフ（クラシック） # 9 Graph (classic) # 9 Graph (classic) # 9 MySQL plugin [comment]: # (tags: mysql) # 9 MySQLプラグイン [comment]: # (tags: mysql) # 9 Notes on memtype parameter in proc.mem items # 9 proc.memアイテムのmemtypeパラメーターに関する注意 # 9 Queue # 9 キュー # 9 Running agent as root Since Zabbix **5.0.0**, the systemd service file for Zabbix agent in [official packages](https://www.zabbix.com/download) explicitly includes directives for `User` and `Group`. Both are set to `zabbix`. It is no longer possible to configure which user Zabbix agent runs as via `zabbix_agentd.conf` file, because the agent will bypass this configuration and run as the user specified in the systemd service file. To run Zabbix agent as root you need to make the modifications described below. # 9 rootユーザーでのエージェントの実行 バージョン**5.0.0**以降、[公式パッケージ](https://www.zabbix.com/download)のZabbixエージェントのsystemdサービスファイルは、`ユーザー`と`グループ`のディレクティブが明示的に含まれるようになりました。どちらも`zabbix`に設定されています。 Zabbixエージェントがこの設定をバイパスし、systemdサービスファイルで指定されたユーザーとして実行されるため、`zabbix_agentd.conf`ファイルを介してZabbixエージェントを実行するユーザーを設定することはできなくなりました。 Zabbixエージェントをrootとして実行するには、以下で説明する変更を行う必要があります。 # 9 String functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) Some general notes on function parameters: - Function parameters are separated by a comma - Expressions are accepted as parameters - String parameters must be double-quoted; otherwise they might get misinterpreted - Optional function parameters (or parameter parts) are indicated by `<` `>` |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**ascii** (value)|<|<| |The ASCII code of the leftmost character of the value.|**value** - value to check|Supported value types: string, text, log<br><br>For example, a value like 'Abc' will return '65' (ASCII code for 'A').<br><br>Example:<br>=> **ascii**(last(/host/key))| |**bitlength** (value)|<|<| |The length of value in bits.|**value** - value to check|Supported value types: string, text, log, integer<br><br>Example:<br>=> **bitlength**(last(/host/key))| |**bytelength** (value)|<|<| |The length of value in bytes.|**value** - value to check|Supported value types: string, text, log, integer<br><br>Example:<br>=> **bytelength**(last(/host/key))| |**char** (value)|<|<| |Return the character by interpreting the value as ASCII code.|**value** - value to check|Supported value types: integer<br><br>The value must be in the 0-255 range. For example, a value like '65' (interpreted as ASCII code) will return 'A'.<br><br>Example:<br>=> **char**(last(/host/key))| |**concat** (<value1>,<value2>,...)|<|<| |The string resulting from concatenating referenced item values or constant values. |**value** - a value returned by one of the history functions or a constant value (string, integer, or float number)|Supported value types: string, text, log, float, integer <br><br>For example, a value like 'Zab' concatenated to 'bix' (the constant string) will return 'Zabbix'. <br><br> Must contain at least two parameters. <br><br>Examples:<br>=> **concat**(last(/host/key),**"bix"**)<br>=> **concat**("1 min: ",last(/host/system.cpu.load[all,avg1]),", 15 min: ",last(/host/system.cpu.load[all,avg15])) | |**insert** (value,start,length,replacement)|<|<| |Insert specified characters or spaces into the character string beginning at the specified position in the string.|**value** - value to check<br>**start** - start position<br>**length** - positions to replace<br>**replacement** - replacement string|Supported value types: string, text, log<br><br>For example, a value like 'Zabbbix' will be replaced by 'Zabbix' if 'bb' (starting position 3, positions to replace 2) is replaced by 'b'.<br><br>Example:<br>=> **insert**(last(/host/key),**3**,**2**,**"b"**)| |**left** (value,count)|<|<| |The leftmost characters of the value.|**value** - value to check<br>**count** - number of characters to return|Supported value types: string, text, log<br><br>For example, you may return 'Zab' from 'Zabbix' by specifying 3 leftmost characters to return.<br><br>Example:<br>=> **left**(last(/host/key),**3**) - return three leftmost characters<br><br>See also right().| |**length** (value)|<|<| |The length of value in characters.|**value** - value to check|Supported value types: str, text, log<br><br>Example:<br>=> **length**(last(/host/key)) → length of the latest value<br>=> **length**(last(/host/key,\#3)) → length of the third most recent value<br>=> **length**(last(/host/key,\#1:now-1d)) → length of the most recent value one day ago| |**ltrim** (value,<chars>)|<|<| |Remove specified characters from the beginning of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is left-trimmed by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **ltrim**(last(/host/key)) - remove whitespace from the beginning of string<br>=> **ltrim**(last(/host/key),**"Z"**) - remove any 'Z' from the beginning of string<br>=> **ltrim**(last(/host/key),**" Z"**) - remove any space and 'Z' from the beginning of string<br><br>See also: rtrim(), trim()| |**mid** (value,start,length)|<|<| |Return a substring of N characters beginning at the character position specified by 'start'.|**value** - value to check<br>**start** - start position of substring<br>**length** - positions to return in substring|Supported value types: string, text, log<br><br>For example, it is possible return 'abbi' from a value like 'Zabbix' if starting position is 2, and positions to return is 4).<br><br>Example:<br>=> **mid**(last(/host/key),**2**,**4**)="abbi"| |**repeat** (value,count)|<|<| |Repeat a string.|**value** - value to check<br>**count** - number of times to repeat|Supported value types: string, text, log<br><br>Example:<br>=> **repeat**(last(/host/key),**2**) - repeat the value two times| |**replace** (value,pattern,replacement)|<|<| |Find pattern in the value and replace with replacement. All occurrences of the pattern will be replaced.|**value** - value to check<br>**pattern** - pattern to find<br>**replacement** - string to replace the pattern with|Supported value types: string, text, log<br><br>Example:<br>=> **replace**(last(/host/key),**"ibb"**,**"abb"**) - replace all 'ibb' with 'abb'| |**right** (value,count)|<|<| |The rightmost characters of the value.|**value** - value to check<br>**count** - number of characters to return|Supported value types: string, text, log<br><br>For example, you may return 'bix' from 'Zabbix' by specifying 3 rightmost characters to return.<br><br>Example:<br>=> **right**(last(/host/key),**3**) - return three rightmost characters<br><br>See also left().| |**rtrim** (value,<chars>)|<|<| |Remove specified characters from the end of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is right-trimmed by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **rtrim**(last(/host/key)) - remove whitespace from the end of string<br>=> **rtrim**(last(/host/key),**"x"**) - remove any 'x' from the end of string<br>=> **rtrim**(last(/host/key),**"x "**) - remove any 'x' or space from the end of string<br><br>See also: ltrim(), trim()| |**trim** (value,<chars>)|<|<| |Remove specified characters from the beginning and end of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is trimmed from both sides by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **trim**(last(/host/key)) - remove whitespace from the beginning and end of string<br>=> **trim**(last(/host/key),**"\_"**) - remove '\_' from the beginning and end of string<br><br>See also: ltrim(), rtrim()| # 9 文字列関数 ここにリストされているすべての機能は、次でサポートされています。 - [トリガー式](/manual/config/triggers/expression) - [計算項目](/manual/config/items/itemtypes/calculated) 関数パラメーターに関する一般的な注意事項: - 関数のパラメータはコンマで区切られます - 式はパラメータとして受け入れられます - 文字列のパラメータは二重引用符で囲む必要があります。 そうしないと、他の型と認識される可能性があります - オプションの関数パラメータ (またはパラメータ部分) は `<` `>` で示されます |関数|<|<| |--|--|--| |**説明**|**関数固有のパラメータ**|**コメント**| |**ascii** (value)|<|<| |値の左端文字の ASCII コード|**value** - チェックする値|サポートされている値のタイプ: 文字列、テキスト、ログ<br><br>たとえば「Abc」のような値の場合、'A' の ASCII コードである'65'を返します。<br><br>例:<br>=> **ascii**(last(/host/key))| |**bitlength** (value)|<|<| |値の長さ (ビット単位)|**value** - チェックする値|サポートされている型: string, text, log, integer<br><br>例:<br>=> **bitlength**(last(/host/key))| |**bytelength** (value)|<|<| |値の長さ (バイト単位)|**value** - チェックする値|サポートされている型: string, text, log, integer<br><br>例:<br>=> **bytelength**(last(/host/key))| |**char** (value)|<|<| |値を ASCII コードと解釈して文字を返します|**value** - チェックする値|サポートされている型: integer<br><br>値は 0 ～ 255 の範囲内である必要があります。たとえば'65' のような値は(ASCII コードとして解釈された結果) 、'A' を返します。<br><br>例:<br>=> **char**(last(/host/key))| |**concat** (<value1>,<value2>,...)|<|<| |参照された項目値または定数値を連結した結果の文字列 |**value** - いずれかの履歴関数によって返される値、または定数値 (文字列、整数、または浮動小数点数)|サポートされている型: string, text, log, float, integer <br><br>たとえば、'Zab'に'bix'(定数文字列) を連結した場合は'Zabbix'を返します。 <br><br> 少なくとも 2 つのパラメータを含める必要があります。 <br><br>例:<br>=> **concat**(last(/host/key),**"bix"**)<br>=> **concat**("1 min: ",last(/host/system.cpu.load[all,avg1]),", 15 min: ",last(/host/system.cpu.load[all,avg15])) | |**insert** (value,start,length,replacement)|<|<| |文字列内の指定された位置から始まる文字列に、指定された文字またはスペースを挿入します。|**value** - チェックする値<br>**start** - 開始位置<br>**length** - 置換位置<br>**replacement** - 変換後文字|サポートされている型: string, text, log<br><br>たとえば'Zabbbix'の'bb'(開始位置 3、置換位置 2) が'b'に置き換えられた場合、'Zabbix'となります。<br><br>例:<br>=> **insert**(last(/host/key),**3**,**2**,**"b"**)| |**left** (value,count)|<|<| |値の左端の文字|**value** - チェックする値<br>**count** - 返す文字数|サポートされている型: string, text, log<br><br>たとえば、'Zabbix'の左端 3 文字を返すように指定すると'Zab'を返します。<br><br>例:<br>=> **left**(last(/host/key),**3**) - 左端の 3 文字を返す<br><br>参照:right()| |**length** (value)|<|<| |value の長さ(文字数)|**value** - チェックする値|サポートされている型: str, text, log<br><br>例:<br>=> **length**(last(/host/key)) → 最新値の長さ<br>=> **length**(last(/host/key,\#3)) → 3 番目に新しい値の長さ<br>=> **length**(last(/host/key,\#1:now-1d)) → 1 日前の最新値の長さ| |**ltrim** (value,<chars>)|<|<| |文字列の先頭から指定された文字を削除します。|**value** - チェックする値<br>**chars** - (オプション) 削除する文字を指定<br><br>デフォルトでは(オプションの文字が指定されていない場合)、空白が左詰めされます。|サポートされている型: string, text, log<br><br>例:<br>=> **ltrim**(last(/host/key)) - 文字列の先頭から空白を削除します<br>=> **ltrim**(last(/host/key),**"Z"**) - 文字列の先頭から'Z'を削除します<br>=> **ltrim**(last(/host/key),**" Z"**) - 文字列の先頭からスペースと'Z'を削除します<br><br>参照: rtrim(), trim()| |**mid** (value,start,length)|<|<| |'start' で指定された文字位置から始まるlength文字の部分文字列を返します。|**value** - チェックする値<br>**start** - 部分文字列の開始位置<br>**length** - 部分文字列からの文字数|サポートされている型: string, text, log<br><br>たとえば値が'Zabbix'、startが2、lengthが 4 の場合、'abbi'が返されます。<br><br>例:<br>=> **mid**(last(/host/key),**2**,**4**)="abbi"| |**repeat** (value,count)|<|<| |文字列を繰り返す|**value** - チェックする値<br>**count** - 繰り返す回数|サポートされている型: string, text, log<br><br>例:<br>=> **repeat**(last(/host/key),**2**) - 値を 2 回繰り返す| |**replace** (value,pattern,replacement)|<|<| |値から特定のパターンを見つけて置換します。マッチしたパターンすべてが置き換えられます。|**value** - チェックする値<br>**pattern** - 探すパターン<br>**replacement** - パターンを置き換える文字列|サポートされている型: string, text, log<br><br>例:<br>=> **replace**(last(/host/key),**"ibb"**,**"abb"**) - 全ての'ibb'を'abb'に置換します| |**right** (value,count)|<|<| |値の右端の文字|**value** - チェックする値<br>**count** - 返す文字数|サポートされている型: string, text, log<br><br>たとえば'Zabbix'から右端の 3 文字を返すように指定すると、'bix'を返すことができます。<br><br>例:<br>=> **right**(last(/host/key),**3**) - 右端の 3 文字を返す<br><br>参照 left().| |**rtrim** (value,<chars>)|<|<| |文字列の末尾から指定された文字を削除します。|**value** - チェックする値<br>**chars** - (オプション) 削除する文字を指定します<br><br>デフォルトでは(オプションの文字が指定されていない場合)、空白が右詰めされます。|サポートされている型: string, text, log<br><br>例:<br>=> **rtrim**(last(/host/key)) - 文字列の末尾から空白を削除します<br>=> **rtrim**(last(/host/key),**"x"**) - 文字列の末尾から'x'を削除します<br>=> **rtrim**(last(/host/key),**"x "**) - 文字列の末尾から'x'またはスペースを削除します<br><br>参照: ltrim(), trim()| |**trim** (value,<chars>)|<|<| |文字列の先頭と末尾から指定された文字を削除します。|**value** - チェックする値<br>**chars** - (オプション) 削除する文字を指定<br><br>デフォルトでは(オプションの文字が指定されていない場合)、空白が両側から削除されます。|サポートされている型: string, text, log<br><br>例:<br>=> **trim**(last(/host/key)) - 文字列の先頭と末尾から空白を削除します<br>=> **trim**(last(/host/key),**"\_"**) - r文字列の先頭と末尾から"\_"を削除します<br><br>参照: ltrim(), rtrim()| # 9 Template changes This page lists all changes to the stock templates that are shipped with Zabbix. Note that upgrading to the latest Zabbix version will not automatically upgrade the templates used. It is suggested to modify the templates in existing installations by: - Downloading the latest templates from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates); - Then, while in *Configuration* → *Templates* you can import them manually into Zabbix. If templates with the same names already exist, the *Delete missing* options should be checked when importing to achieve a clean import. This way the old items that are no longer in the updated template will be removed (note that it will mean losing history of these old items). # 9 テンプレートの変更点 このページでは、Zabbixに同梱されているストックテンプレートの変更点が一覧できます。 Zabbixを最新バージョンにアップグレードしても、使用されているテンプレートは自動的にはアップグレードされないことに注意してください。次の方法で既存のインストールのテンプレートを変更することをお勧めします。 - [Zabbix Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates)から最新のテンプレートをダウンロードする - その後*設定* → *テンプレート*で、テンプレートをZabbixに手動でインポートできます。同じ名前のテンプレートがすでに存在する場合、クリーンなインポートを実現するには、インポート時に*存在しない場合に削除*オプションをオンにする必要があります。この方法では、更新されたテンプレートに含まれていない古いアイテムが削除されます(これらの古いアイテムのヒストリが失われることに注意してください)。 # 9 Templates out of the box # 9 すぐに使えるテンプレート # 9 Value mapping # 9 値のマッピング # 9. Web monitoring # 9. Web監視 # 9 Web service # 9 Zabbix Webサービス # 9 What's new in Zabbix 6.0.4 # 9 Zabbix 6.0.4の新機能 # 9 Zabbix web service # 9 Zabbix Webサービス #### Absence of data For items with a regular update interval, nothing is displayed in the graph if item data are not collected. However, for trapper items and items with a scheduled update interval (and regular update interval set to 0), a straight line is drawn leading up to the first collected value and from the last collected value to the end of graph; the line is on the level of the first/last value respectively. #### データ不在の場合 定期更新の item は、データが収集されないとグラフに何も表示されません。 ただし、Trapper item と定期更新 item （定期更新間隔を0に設定）については、最初の収集値までと最後の収集値から<br> グラフの終わりまで、それぞれ最初の値／最後の値の高さに直線が引かれます。 ### Access control ### アクセス制御 #### Accessing host dashboards Access to host dashboards is provided: - From the [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu) that is available in many frontend locations: - click on the host name and then select *Dashboards* from the drop-down menu  - When searching for a host name in [global search](/manual/web_interface/global_search): - click on the *Dashboards* link provided in search results ```{=html} <!-- --> ``` - When clicking on a host name in *Inventory* → *[Hosts](/manual/web_interface/frontend_sections/inventory/hosts)*: - click on the *Dashboards* link provided ホストダッシュボードへのアクセス ホストダッシュボードへのアクセスを提供します: - フロントエンドの多くの場所にある[host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu)から - ホスト名をクリックし、ドロップダウンメニューから *Dashboards* を選択します。  - [global search](/manual/web_interface/global_search)でホスト名を検索する場合 - 検索結果に表示される *Dashboards* のリンクをクリックします。 ```{=html} <!-- --> ``` - *Inventory* → *[Inventory](/manual/web_interface/frontend_sections/inventory/hosts)* でホスト名をクリックする場合 - 提供されている*Dashboards*のリンクをクリックします。 #### Accidental installation of EPEL Zabbix packages With EPEL repository installed and enabled, installing Zabbix from packages will lead to EPEL Zabbix packages being installed rather than official Zabbix packages. In this case uninstall Zabbix packages from EPEL, i.e.: dnf remove zabbix-server-mysql Block Zabbix packages from EPEL. Add the following line in the `/etc/yum.conf` file: exclude=zabbix6.0* Install Zabbix server again: dnf install zabbix-server-mysql Notice that official Zabbix packages have the word `release` in their version string: 6.0.25-release1.el8 #### EPEL Zabbixパッケージの誤ったインストール EPELリポジトリがインストールおよび有効になっている場合、パッケージからZabbixをインストールすると、公式のZabbixパッケージではなくEPEL Zabbixパッケージがインストールされます。 この場合、EPELからZabbixパッケージをアンインストールする、つまり、 dnf remove zabbix-server-mysql EPELからZabbixパッケージをブロックします。 `/etc/yum.conf`ファイルに次の行を追加します。 exclude=zabbix6.0* Zabbixサーバーをもう一度インストールします。 dnf install zabbix-server-mysql 公式Zabbixパッケージには、バージョン文字列に`release` という単語があることに注意してください。 6.0.25-release1.el8 #### Acknowledging an event Acknowledge a single event and leave a message. Request: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": "20427", "action": 6, "message": "Problem resolved." }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427" ] }, "id": 1 } ``` #### イベントの確認 1つのイベントを確認し、メッセージを残します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": "20427", "action": 6, "message": "Problem resolved." }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427" ] }, "id": 1 } ``` # action.create # action.create # action.delete # action.delete #### 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.| #### 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|サービス名| ### 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.| ### 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>カスタム式フィルタでは必須です。| # action.get # action.get #### 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.| #### 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 - されている| #### 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.| #### 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|オペレーションメッセージ件名。| ### 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.| ### 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>"ホストインベントリモードの設定"操作に必要です。| ### 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.| ### 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`が設定されていない場合、メッセージ操作に必須です。| #### 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) #### アクションとアラート 特定のイベントをユーザーに通知したり、リモートコマンドを自動的に実行するためのアクションと操作を定義します。生成されたアラートとその受信者に関する情報にアクセスできます。 [Action API](/manual/api/reference/action) | [Alert API](/manual/api/reference/alert) #### 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. #### オブジェクト削除によるアクション無効化 アクション条件/操作で使用されている特定のオブジェクト (ホスト、テンプレート、トリガーなど) が削除されると、その条件/操作が削除され、アクションが無効になり、アクションが正しく実行されなくなります。 ユーザーはアクションを再度有効にすることができます。 この動作は、以下を削除するときに発生します。 - ホストグループ ("ホスト グループ"条件、特定のホスト グループでの"リモート コマンド"操作) - ホスト ("ホスト" 条件、 特定のホストでの"リモートコマンド"操作) - テンプレート ("テンプレート" 条件, "テンプレートへのリンク"および"テンプレートからのリンク解除"操作) - トリガー ("トリガー" 条件) - ディスカバリルール ("ディスカバリ ルール"および"ディスカバリ チェック"条件) *注*: リモート コマンドに多くのターゲット ホストがあり、そのうちの 1 つを削除すると、このホストのみがターゲット リストから削除され、操作自体は残ります。 ただし、それが唯一のホストである場合、操作も削除されます。 "テンプレートへのリンク"および"テンプレートからのリンク解除"操作についても同様です。 "メッセージの送信"操作で使用されるユーザーまたはユーザー グループを削除する場合、アクションは無効になりません。 #### 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. ::: #### アクション ディスカバリイベントは、次のような関連する[アクション](/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 検出されたホストのテンプレートへのリンクは、リンク可能なテンプレートのいずれかに、ホストまたは別のリンク可能なテンプレートにすでに存在する一意のエンティティ（アイテムキーなど）と同じ一意のエンティティ（アイテムキーなど）がある場合、まとめて失敗します。 ::: #### 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. #### 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 は、通信障害が発生しても、ログファイルの増加についていこうとします。 #### 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| #### アクション [アクション](/manual/config/notifications/action)では、ユーザーマクロを次のフィールドで使用できます。 |ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |トリガーベースの通知とコマンド|<|yes| |トリガーベースの内部通知|<|yes| |障害の更新通知|<|yes| |サービスベースの通知とコマンド|<|yes| |サービス更新通知|<|yes| |期間|<|no| |*オペレーション*|<|<| | |デフォルトの操作ステップ期間|no| |^|ステップ期間|no| ### 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. ### 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>このパラメータはトリガーアクションに対してのみ有効なことに注意してください。| 一部のメソッド(更新、削除)では、必須/オプションのパラメーターの組み合わせが異なることに注意してください。 ### 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.| ### 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 - *(デフォルト)*有効| # action.update # action.update ### 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.| ### 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`操作では無視されます。| #### 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. #### アクティブエージェント自動検出イベント アクティブ エージェントの自動登録は Zabbixにイベントを作成します。 設定されている場合、以前は知られていなかったアクティブエージェントがチェックを要求した場合、またはホストのメタデータが変更された場合、アクティブ agent の自動登録イベントが作成されます。server は、受信した agent のIPアドレスとポートを使用して、新しい自動登録されたホストを追加します。<br> 詳細については、[active agent autoregistration](/manual/discovery/auto_registration)] ページを参照してください。 #### 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. ::: #### アクティブチェック アクティブチェックには、より複雑な処理が必要です。 エージェントは、最初にサーバーから独立した処理でアイテムのリストを取得します。 アクティブチェックを取得するサーバーは、エージェント[構成ファイル](/manual/appendix/config/zabbix_agentd)の"ServerActive"パラメーターにリストされています。 これらのチェックを要求する頻度は、同じ構成ファイルの"RefreshActiveChecks"パラメーターによって設定されます。 ただしアクティブチェックの更新に失敗した場合は、ハードコードされた60秒後に再試行されます。 その後、エージェントは定期的に新しい値をサーバーに送信します。 ::: notetip エージェントがファイアウォールの背後にいる場合は、アクティブチェックのみを使用することを検討してください。そうすることで最初の着信接続を許可するためにファイアウォールを変更する必要がなくなります。 ::: #### Active proxy #### アクティブプロキシ #### 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 } ``` #### トリガーの依存関係を追加する トリガー"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 } ``` #### 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 } ``` #### 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 } ``` #### 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 } ``` #### スケジュールされたダウンタイムの追加 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 } ``` ##### 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. ::: ##### ホストの追加 ホストが検出されるとディスカバリプロセスの最後まで待たず、ディスカバリプロセス中すぐに追加されます。 ::: notetip 多くの利用できないホスト/サービスが原因で、ネットワークの検出に時間がかかることがあるので、忍耐力と妥当なIP範囲を使用することをお勧めします。 ::: ホストを追加するとき、その名前は標準の**gethostbyname**関数によって決定されます。 ホストが解決できる場合は、解決された名前が使用されます。 そうでない場合は、IPアドレスが使用されます。 また、ホスト名にIPv6アドレスが使用されている場合は、ホスト名にコロンが使用できないため、すべての":" (コロン)は"\_"(アンダースコア)に置き換えられます。 ::: noteimportant プロキシによるディスカバリを実行する場合でも、ホスト名の検索はZabbixサーバー上で行われます。 ::: ::: noteimportant 新しく検出されたホストと同じ名前のホストがすでにZabbix設定に存在する場合、1.8より前のバージョンのZabbixでは同じ名前の別のホストが追加されます。 Zabbix 1.8.1以降では、ホスト名に**\_N**が追加されます。**N**は2から始まる数字で、増えていきます。 ::: #### 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 } ``` #### 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 } ``` #### 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  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). #### テンプレートにアイテムを追加 テンプレートにアイテムを追加するには、'New host'のアイテムリストに移動します。*設定 → ホスト*で'New host'の横にある*アイテム*をクリックします。 それから: - リストの'CPU Load'アイテムのチェックボックスにチェックを入れます。 - リストの下にある*コピー*をクリックします。 - アイテムをコピーするテンプレートを選びます。  記入が必須の項目には、赤いアスタリスクが表記されます。 - *コピー*をクリックします。 この段階で*設定 → テンプレート*に行くと、'New template'に新しいアイテムが追加されているはずです。 この段階では1つのアイテムだけにしておきますが、同様にほかのアイテムやトリガー等を、希望の目的(OSの監視、単一のアプリケーションの監視等)に対する動作の完全なセットを完成させるまでテンプレートに追加する事が出来ます。 #### 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. {width="600"} #### 線の追加 図形だけでなく、線を追加することも可能です。線は、地図上の要素や図形をつなぐために使用します。 線を追加するには、図形の隣にある *Add* をクリックします。新しい図形がマップの左上隅に表示されます。それを選択し、<br> 編集フォームの *Line* をクリックして、図形を線に変更します。次に、線の種類、幅、色など、線のプロパティを調整します。 {width="600"} #### 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 } ``` #### 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 } ``` #### 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 } ``` #### マクロの追加 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 } ``` #### 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  - 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.  A new page will be added, indicated by a new tab (*Page 2*).  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. #### ページの追加 ダッシュボードにページを追加するには - ダッシュボードが[編集モード](#viewing_and_editing_a_dashboard)になっていることを確認します - *追加*ボタンの横にある矢印をクリックして*ページを追加*オプションを選択します  - 一般的なページパラメータを入力し、[適用]をクリックします。 名前を空のままにすると、ページに「ページN」という名前が追加されます。「N」はページの増分番号です。 ページ表示期間でスライドショーでページを表示する期間をカスタマイズできます。  新しいタブ（*ページ2 *）で表示される新しいページが追加されます。  ページタブをドラッグアンドドロップすることで、ページを並べ替えることができます。 並べ替えても元のページの名前が維持されます。 タブをクリックすると、いつでも各ページに移動できます。 新しいページは空で追加されます。上記のようにウィジェットを追加できます。 ##### 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. {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.  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. ##### 権限の追加 デフォルトでは、新しいユーザーにはホストにアクセスするための権限がありません。 権限を付与するには*グループ*列のグループをクリックします (この場合 - 'Zabbix administrators')。 グループプロパティフォームで*権限*タブに移動します。 {width="600"} このユーザーは*Linux servers*グループへの読み取り専用アクセス権を持っているため、ユーザーグループ選択フィールドの横にある*選択*をクリックします。  このポップアップで、'Linux servers'の横にあるチェックボックスをオンにして*選択*をクリックすると*Linux servers*が選択フィールドに表示されます。 '読み取り'ボタンをクリックしてアクセス許可レベルを設定し、*追加*をクリックしてグループをアクセス許可のリストに追加します。 ユーザーグループのプロパティフォームで、*更新*をクリックします。 ::: noteimportant Zabbixでは、ホストへのアクセス権は個々のユーザーではなく、[ユーザーグループ](/manual/config/users_and_usergroups/usergroup)に割り当てられます。 ::: 以上で新しいユーザーの資格情報を使用してログインを試みることができます。 ##### Adding proxies To configure a proxy in Zabbix frontend: - Go to: *Administration → Proxies* - Click on *Create proxy* {width="600"} |Parameter|<|Description| |-|----------|----------------------------------------| |*Proxy name*|<|Enter the proxy name. It must be the same name as in the *Hostname* parameter in the proxy configuration file.| |*Proxy mode*|<|Select the proxy mode.<br>**Active** - the proxy will connect to the Zabbix server and request configuration data<br>**Passive** - Zabbix server connects to the proxy<br>*Note* that without encrypted communications (sensitive) proxy configuration data may become available to parties having access to the Zabbix server trapper port when using an active proxy. This is possible because anyone may pretend to be an active proxy and request configuration data if authentication does not take place or proxy addresses are not limited in the *Proxy address* field.| |*Proxy address*|<|If specified then active proxy requests are only accepted from this list of comma-delimited IP addresses, optionally in CIDR notation, or DNS names of active Zabbix proxy.<br>This field is only available if an active proxy is selected in the *Proxy mode* field. Macros are not supported.<br>This option is supported since Zabbix 4.0.0.| |*Interface*|<|Enter interface details for the passive proxy.<br>This field is only available if a passive proxy is selected in the *Proxy mode* field.| | |*IP address*|IP address of the passive proxy (optional).| |^|*DNS name*|DNS name of the passive proxy (optional).| |^|*Connect to*|Clicking the respective button will tell Zabbix server what to use to retrieve data from proxy:<br>**IP** - Connect to the proxy IP address (recommended)<br>**DNS** - Connect to the proxy DNS name| |^|*Port*|TCP port number of the passive proxy (10051 by default).| |*Description*|<|Enter the proxy description.| The **Encryption** tab allows you to require encrypted connections with the proxy. |Parameter|Description| |--|--------| |*Connections to proxy*|How the server connects to the passive proxy: no encryption (default), using PSK (pre-shared key) or certificate.| |*Connections from proxy*|Select what type of connections are allowed from the active proxy. Several connection types can be selected at the same time (useful for testing and switching to other connection type). Default is "No encryption".| |*Issuer*|Allowed issuer of certificate. Certificate is first validated with CA (certificate authority). If it is valid, signed by the CA, then the *Issuer* field can be used to further restrict allowed CA. This field is optional, intended to use if your Zabbix installation uses certificates from multiple CAs.| |*Subject*|Allowed subject of certificate. Certificate is first validated with CA. If it is valid, signed by the CA, then the *Subject* field can be used to allow only one value of *Subject* string. If this field is empty then any valid certificate signed by the configured CA is accepted.| |*PSK identity*|Pre-shared key 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.| |*PSK*|Pre-shared key (hex-string). 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. Example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952| ##### プロキシの追加 Zabbixフロントエンドでプロキシを設定するには: - *管理 → プロキシ*に移動してください。 - *プロキシの作成*をクリックしてください。 {width="600"} |パラメーター|<|説明| |-|----------|----------------------------------------| |*プロキシ名*|<|プロキシ名を入力します。 プロキシ設定ファイルの*Hostname*パラメーターと同じ名前である必要があります。| |*プロキシモード*|<|プロキシモードを選択します。<br>**アクティブ** - プロキシがZabbixサーバーに接続し、設定データを要求します。<br>**パッシブ** - Zabbixサーバーがプロキシに接続します。<br>*注意*: 暗号化されていない(機密性の高い)プロキシ設定データは、アクティブなプロキシを使用しているときにZabbixサーバーのトラッパーポートにアクセスできる関係者が利用できるようになる可能性があります。これが可能なのは、認証が行われない場合、またはプロキシアドレスが*プロキシのアドレス*フィールドで制限されていない場合、誰でもアクティブなプロキシのふりをして設定データを要求する可能性があるためです。| |*プロキシのアドレス*|<|指定した場合、アクティブなプロキシリクエストは、このコンマ区切りのIPアドレスのリスト(オプションでCIDR表記またはアクティブなZabbixプロキシのDNS名)からのみ受け入れられます。<br>このフィールドは*プロキシモード*フィールドで*アクティブ*が選択されている場合にのみ使用できます。 マクロはサポートされていません。<br>このオプションはZabbix4.0.0以降でサポートされています。| |*インターフェース*|<|パッシブプロキシのインターフェース詳細を入力します。<br>このフィールドは*プロキシモード*フィールドでパッシブが選択されている場合にのみ使用できます。| ||*IPアドレス*|パッシブプロキシのIPアドレス(オプション)。| |^|*DNS名*|パッシブプロキシのDNS名(オプション)。| |^|*接続方法*|それぞれのボタンをクリックすると、Zabbixサーバーにプロキシからデータを取得するために使用するものが通知されます。<br>**IP** - プロキシにIPアドレスで接続します(推奨)。<br>**DNS** - プロキシにDNS名で接続します。| |^|*ポート*|パッシブプロキシのTCPポート番号(デフォルト: 10051)。| |*説明*|<|プロキシの説明を入力します。| **暗号化**タブではプロキシとの暗号化された接続を設定できます。 |パラメーター|説明| |--|--------| |*プロキシへの接続*|サーバーがパッシブプロキシに接続する方法: 暗号化なし(デフォルト)、PSK(事前共有キー)、証明書。| |*プロキシからの接続*|アクティブなプロキシから許可される接続のタイプを選択します。複数の接続タイプを同時に選択できます(テストおよび他の接続タイプへの切り替えに役立ちます)。 デフォルトは"暗号なし"です。| |*発行者*|証明書発行者。証明書は最初にCA(認証局)で検証されます。CAによって署名された有効な証明書は、*発行者*フィールドを使用して許可されるCAをさらに制限できます。このフィールドはオプションでありZabbixインストールで複数のCAからの証明書を使用する場合に使用することを目的としています。| |*サブジェクト*|許可された証明書名。証明書は最初にCAで検証されます。CAによって署名された有効な証明書は*サブジェクト*フィールドを使用して、*サブジェクト*文字列の値を1つだけ許可できます。 このフィールドが空の場合、構成されたCAによって署名された有効な証明書が受け入れられます。| |*PSKアイデンティティ*|事前共有キーID文字列<br>機密情報をPSKIDに入れないでください。機密情報は暗号化されずにネットワーク経由で送信され、使用するPSKを受信者に通知します。| |*PSK*|事前共有キー(16進文字列)。最大長: ZabbixがGnuTLSまたはOpenSSLライブラリを使用する場合は512 hex-digits (256バイトPSK)、Zabbixがmbed TLS (PolarSSL)ライブラリを使用する場合は64 hex-digits (32バイトPSK)。例: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952| #### 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. {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:  {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). #### 図形の追加 地図要素に加えて、いくつかの図形を追加することができます。<br> 図形は地図の要素ではなく、視覚的な表現に過ぎません。例えば、長方形の図形は、いくつかのホストをグループ化するための<br> 背景として使用することができます。矩形と楕円の形状を追加することができます。 図形を追加するには、図形の隣にある *Add* をクリックします。新しい図形がマップの左上隅に表示されます。<br> 好きな場所にドラッグ＆ドロップしてください。 新しいシェイプは、デフォルトの色で追加されます。シェイプをクリックすると、フォームが表示され、シェイプの見え方を<br> カスタマイズしたり、テキストを追加したりすることができます。 {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> マクロをクリックすると、テキスト付きの長方形のシェイプが表示されます。:  {MAP.NAME} は、マップを表示するときに設定されたマップ名に解決されます。 テキストでハイパーリンクが使用されている場合、マップを表示するときにクリックできるようになります。 図形内では、テキストの行の折り返しは常に "on" になっています。ただし、楕円の中では、楕円が矩形であるかのように<br> 線が折り返されます。単語の折り返しは実装されていないので、長い単語（シェイプに合わない単語）は折り返されず、<br> マスク（コンストラクタ・ページ）またはクリップ（マップを含む他のページ）されます。 #### Adding user To view information about users, go to *Administration → Users*. {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'.  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*.  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: {width="600"} Click *Add* in the user properties form to save the user. The new user appears in the userlist. {width="600"} #### ユーザーの追加 ユーザーに関する情報を表示するには、*管理 → ユーザー*に移動します。 {width="600"} 新しいユーザーを追加するには、*ユーザーの作成*をクリックします。 新しいユーザーフォームで、必ず既存の[ユーザーグループ](/manual/config/users_and_usergroups/usergroup)の1つ、例えば'Zabbix administrators'にユーザーを追加してください。  すべての必須入力フィールドは、赤いアスタリスクでマークされています。 デフォルトでは、新規ユーザーにはメディア(通知配信方法)がありません。 作成するには、'メディア'タブに移動し、*追加*をクリックします。  このポップアップで、ユーザーの電子メールアドレスを入力します。 メディアがアクティブになる期間を指定できます (入力形式については[期間の指定](/manual/appendix/time_period)ページを参照してください)。 デフォルトでは、メディアは常にアクティブです。 メディアがアクティブになる[トリガーの深刻度](/manual/config/triggers/severity)をカスタマイズすることもできますが、現時点ではすべてを有効のままにしておきます。 *追加*をクリックしてメディアを保存し、権限タブに移動します。 権限タブには、必須フィールド*ユーザーの役割*があります。 このユーザーの役割は、ユーザーが表示できるフロントエンド要素と、ユーザーが実行できるアクションを決定します。 選択を押してリストからユーザーの役割の1つを選択します。 たとえば*Admin role*を選択して、すべてのZabbixフロントエンドセクションへのアクセスを許可します。 後で権限を変更したり、より多くのユーザーの役割を設定することも可能です。 ユーザーの役割を選択すると、権限が同じタブ内に表示されます。 {width="600"} ユーザープロパティフォームの*追加*をクリックして、ユーザーを保存します。 新しいユーザーがユーザーリストに表示されます。 {width="600"} #### 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) #### Webシナリオの追加 Webシナリオをテンプレートに追加するには、*[設定] → [テンプレート]*で次の手順を実行します。 - テンプレートの行で *Web* をクリック - [configuring web scenarios](/manual/web_monitoring#configuring_a_web_scenario)に従って、Web シナリオを設定します。 #### Adding widgets To add a widget to a dashboard: - Click on the  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.)   In the widget configuration form: - Select the *Type* of widget - Enter widget parameters - Click on *Add*  #### 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: -  - edit a widget; -  - access the [widget menu](#widget_menu) Click on *Save changes* for the dashboard to make any changes to the widgets permanent. #### Adding widgets To add a widget to a dashboard: - Click on the  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.)   In the widget configuration form: - Select the *Type* of widget - Enter widget parameters - Click on *Add*  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: -  - edit a widget; -  - access the [widget menu](#widget_menu) Click on *Save changes* for the dashboard to make any changes to the widgets permanent. ### Adding Zabbix repository Install the repository configuration package. This package contains yum (software package manager) configuration files. SLES 15: rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/zabbix-release-latest.sles15.noarch.rpm zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository' SLES 12: rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/6.0/sles/12/x86_64/zabbix-release-latest.sles12.noarch.rpm zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository' Please note that Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually. ### Zabbixリポジトリの追加 リポジトリパッケージをインストールします。 このパッケージには、yum (ソフトウェアパッケージマネージャー)設定ファイルが含まれています。 SLES 15: rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/zabbix-release-latest.sles15.noarch.rpm zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository' SLES 12: rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/6.0/sles/12/x86_64/zabbix-release-latest.sles12.noarch.rpm zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository' [定期レポートの生成](/manual/web_interface/frontend_sections/reports/scheduled)に使用されるZabbix Webサービスプロセスには、Google Chromeブラウザが必要です。ブラウザはパッケージに含まれていないため、手動でインストールする必要があります。 #### Additional information #### 追加情報 ##### 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'. See [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate) for more details and examples on using foreach functions. ##### 追加のパラメータ 3番目のオプションパラメータは*bucket\_rate\_foreach*関数でサポートされています: 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. ここで、<parameter number> は、アイテム キー内の"バケット"値の位置です。たとえば、myItem\[aaa,0.2\] 内の"バケット"値が '0.2' の場合、その位置は2です。 <parameter number> のデフォルト値は 1'です。 foreach 関数の使用に関する詳細と例については、[集計計算](/manual/config/items/itemtypes/calculated/aggregate)を参照してください。 #### 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. #### 追加のssh.runオプション **ssh.run[]**アイテムが更新され、アイテムキーの一部として追加のSSHオプションを渡すことができるようになりました。 これらのオプションは、バージョン0.9.0以降のlibsshまたはlibssh2を使用する場合にのみサポートされます。 サポートされるオプションのキーと値は、SSHライブラリによって異なります。 詳細については[SSHチェック](/manual/config/items/itemtypes/ssh_checks)を参照してください。 ### Administration With the Zabbix API you can change administration settings of your monitoring system. ### 管理画面 Zabbix APIを使用すると、監視システムの管理設定を変更することができます。 #### Advanced configuration {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. ::: #### 詳細設定 {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*では致命的な障害である場合、サービスのステータスは致命的な障害になります。 ::: #### Advanced configuration The following parameters are supported if *Advanced configuration* is set to "Enabled". |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Background color*|<|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| #### 詳細設定 *詳細設定*が"有効"に設定されている場合、以下のパラメータがサポートされます。 |パラメータ|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|--------------------------------------------| |*背景色*|<|1|bg_color|16進数の色コード（例：`FF0000`）<br><br>デフォルト：`""`（空）| 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. ::: アクティブなチェックのリストを受け取った後、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** の場所に再構成すると、古い永続ファイルからエージェント状態をリストアすることになり、 メッセージの見逃しや誤った警告が発生します。 ::: #### Agent 2 package support for RHEL 6 dropped Since Zabbix 6.0.35, Zabbix agent 2 packages are no longer available for [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/) due to Go 1.22 (and newer) being incompatible with GCC 4.4.7 provided by RHEL 6, which results in compilation errors. Note, however, that [Zabbix agent packages](/manual/installation/install_from_packages/rhel) are still supported. #### RHEL 6のエージェント2パッケージのサポートが終了 Zabbix 6.0.35以降、Go 1.22(およびそれ以降)がRHEL 6で提供されるGCC 4.4.7と互換性がなく、コンパイルエラーが発生するため、Zabbixエージェント2パッケージは[RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/)では利用できなくなりました。 ただし、[Zabbixエージェントパッケージ](/manual/installation/install_from_packages/rhel)は引き続きサポートされています。 #### 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. #### Zabbixエージェント2のプラグイン ##### MySQL `mysql.replication.get_slave_status[]`[アイテム](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mysql)の"masterHost"パラメータで指定されている場合、正しいマスターホストが返されるようになりました。以前は、"masterHost"パラメータは無視され、常に最初のマスターホストが返されていました。 このパラメータが指定されていない場合は、すべてのホストが返されます。 ##### Agent 2 |Requirement|Mandatory status|Description| |--|-|-------| |*Go*|Yes|Required to build Zabbix agent 2 and its plugins from source.<br>Go 1.23 or later is supported. See [go.dev](https://go.dev/doc/install) for installation instructions.<br>Go libraries used by Zabbix agent 2 and its plugins are listed in the Zabbix Git repository (libraries marked as `indirect` in the repository are dependencies of other required libraries):<br>- [Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [Plugin support](https://git.zabbix.com/projects/AP/repos/plugin-support/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)| |*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.| ##### エージェント2 |要件|必須ステータス|説明| |--|-|-------| |*Go*|Yes|Zabbixエージェント2とそのプラグインをソースから構築するために必要です。<br>Go 1.23以降をサポート。インストール手順については[go.dev](https://go.dev/doc/install)を参照してください。<br>Zabbixエージェント2が使用するGoライブラリとそのプラグインは、Zabbix Gitリポジトリにリストされています(リポジトリに`indirect`としてマークされたライブラリは、他の必要なライブラリの依存関係です):<br>- [Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [Plugin support](https://git.zabbix.com/projects/AP/repos/plugin-support/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)| |*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以降が必要です。| ##### Agent configuration HA cluster nodes (servers) must be listed in the configuration of Zabbix agent or Zabbix agent 2.  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 ``` ##### Zabbixエージェントの設定 HAクラスターのノード(サーバー)は、ZabbixエージェントまたはZabbixエージェント2の設定ファイルに並べて記述することが必要です。  パッシブチェックを行うのならば、ノード名を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 ``` ### 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" } ``` ### エージェントデータリクエスト エージェントデータリクエストには、収集されたアイテムの値が含まれます。 | フィールド |<| タイプ | 必須 | 値 | |-|------|--|-|-----------------------| | 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" } ``` ### 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" } ``` ### エージェントデータレスポンス エージェントデータレスポンス、エージェントデータリクエストを処理した後、サーバーによってエージェントに送り返されます。 | フィールド | タイプ | 必須 | 値 | |-|-|-|--------| | response | _string_ | はい | `success` または `failed` | | info | _string_ | はい | アイテム処理結果 | 例: ```json { "response": "success", "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534" } ``` #### 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). #### 新しいエージェントのアイテム 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*または*lines*)をサポート - **vfs.fs.discovery** と **vfs.fs.get** がWindows上で{\#FSLABEL}を(ボリューム名と一緒に)返す 詳細については、[Zabbixエージェントのアイテム](/manual/config/items/itemtypes/zabbix_agent)を参照してください。 #### Agent on UNIX-like systems Zabbix agent on UNIX-like systems is run on the host being monitored. #### UNIX系OS上のZabbixエージェント UNIX系OS上のZabbixエージェントは、監視対象のホストで実行されます。 #### Agent on Windows systems Zabbix agent on Windows runs as a Windows service. #### Windows上でのZabbixエージェント Windows上のZabbixエージェントは、Windowsサービスとして実行されます。 ##### 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. ##### 永続ファイルを使用した agent 操作 起動時、Zabbix agent は永続化ファイルについて何も知りません。Zabbixサーバからアクティブチェックのリストを受け取った後、<br> agent はいくつかのログアイテムが指定されたディレクトリの永続ファイルでバックアップされることを認識します。 agent 操作の間、永続ファイルは書き込みのために開かれ (fopen(filename, "w")) 、最新のデータで上書きされます。 <br> 上書きとファイルシステムのミラーリングが同時に起こった場合、永続ファイルのデータが失われる可能性は非常に低いので、<br> 特別な処理は行いません。 永続ファイルへの書き込みの後にメディアへの強制同期を行わない\(fsync\(\) is not called\)は呼び出されない)ため、<br> 永続ファイルへの書き込みの後にメディアへの強制同期を行うことはできません。<br> 最新データの上書きは、一致するログファイルのレコードまたはメタデータ(処理されたログのサイズと更新時間)が Zabbix server に正常に報告された後に行われます。ログファイルが変化し続ける場合、item チェックのたびに行われる可能性があります。 agent シャットダウン中の特別な動作はありません。 ##### 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. ::: ##### エージェント |要件|必須ステータス|説明| |--|-|-------| |*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*または*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*|^|`Zabbixエージェント[アイテム](/manual/config/items/itemtypes/zabbix_agent)`web.page.*に必要です。Windowsではサポートされていません。<br>バージョン7.28.0以降を推奨します。| |*libmodbus*|^|Modbusモニタリングを使用する場合にのみ必要です。<br>バージョン3.0以降。| ::: noteclassic バージョン5.0.3以降のZabbixエージェントは、バージョン6.1 TL07 / AIX 7.1 TL01より前のAIXプラットフォームでは動作しません。 ::: #### 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. #### エージェントのアップグレードプロセス ::: noteimportant エージェントのアップグレードは必須ではありません。新しい機能にアクセスする必要がある場合にのみ、エージェントをアップグレードする必要があります。 ::: このセクションで説明するアップグレード手順は、ZabbixエージェントとZabbixエージェント2の両方をアップグレードするために使用できます。 ##### 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). ##### エージェント Zabbixエージェントは、監視対象上にインストールされ、ローカルリソースやアプリケーションを能動的に監視し、収集したデータをZabbixサーバーに送信します。Zabbix 4.4からは2種類のエージェントがあります: [Zabbixエージェント](/manual/concepts/agent)(C言語で実装され、低負荷で多くのプラットフォームをサポート)、[Zabbixエージェント2](/manual/concepts/agent2)(Go言語で実装され、柔軟でプラグインで拡張しやすい)。 #### 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)| #### 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)| ### 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). ### 集計関数 **count_foreach**関数は、アイテムのデータが存在しない場合、またはデータがフィルターに一致しない場合、配列内の一致するアイテムに対して'0'を返すようになりました。 以前はそのようなアイテムは無視されていました (集計にデータは追加されませんでした)。 ### 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). ### 集計関数 **count_foreach**関数は、アイテムのデータが存在しない場合、またはデータがフィルターに一致しない場合、配列内の一致するアイテムに対して'0'を返すようになりました。 以前はそのようなアイテムは無視されていました (集計にデータは追加されませんでした)。 #### 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. #### 集計関数 **last_foreach**関数は、次の[集計関数](/manual/appendix/functions/aggregate)でもサポートされるようになりました: kurtosis, mad, skewness, stddevpop, stddevsamp, sumofsquares, varpop, varsamp ##### AIX, HP-UX If `watch` command is not available, one can try while [ 1 ]; do ps -fu zabbix; sleep 1; clear; done ##### AIX, HP-UX `watch`コマンドが使用できない場合に試してください。 while [ 1 ]; do ps -fu zabbix; sleep 1; clear; done #### 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| | #### 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| | #### 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. #### RHEL 7でのalerterプロセスのクラッシュ RHEL 7上でZabbixサーバーのalerterプロセスがクラッシュすることが確認されています。 詳細は[ZBX-10461](https://support.zabbix.com/browse/ZBX-10461)を参照してください。 # alert.get # alert.get ##### 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. #### 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. **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. **サービスステータス変更時のアラート** トリガーの状態変化に関するアラートと同様に、サービスの状態変化に関する自動的なアラートを受け取ることができるようになりました。 Zabbixの他のアクションと同じように、新しく[サービスアクション](/manual/it_services/service_actions)機能が追加されました。 サービスアクションには、サービスに関連する問題解決、復旧、更新操作の手順が含まれます。 サービスアクションは指定された受信者にメッセージを送信するアクションと指定された受信者にリモートでアクションを実行するアクションの2種類を設定することが可能です。 トリガーアクションと同様に、サービスアクションは問題の[エスカレーション](/manual/config/notifications/action/escalations)シナリオをサポートします。 新しいメッセージテンプレート *サービス*、*サービスの復旧*、*サービスの更新* が [メディアタイプ](/manual/config/notifications/media#common_parameters)に追加されたため、サービスアクションの通知を正しく送信できるように定義する必要があります。 ### 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.| ### 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。| ##### 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. Custom intervals for active checks are supported by Zabbix agent 2 only. Ensure you are using Zabbix agent 2 if you intend to configure custom intervals for active checks. 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" ##### プロキシとエージェント2のタイムゾーンの調整 Zabbixプロキシとエージェント2は、スケジュール間隔を処理するときにローカルタイムゾーンを使用することに注意してください。 このため、Zabbixプロキシまたはエージェント2のアクティブアイテムによって監視されるアイテムにスケジュール間隔を適用する場合は、それぞれのプロキシまたはエージェント2のタイムゾーンを Zabbixサーバーと同じに設定することをお勧めします。 アクティブチェック用のカスタム間隔は、Zabbixエージェント2のみでサポートされています。アクティブチェック用のカスタム間隔を構成する場合は、Zabbixエージェント2を使用していることを確認してください。 Zabbixプロキシまたはエージェント2のタイムゾーンは、`systemd`ユニットファイルの環境変数`TZ`を使用して設定できます。 [Service] ... Environment="TZ=Europe/Amsterdam" 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`. ::: これらのパラメータはすべて、インストール後に *管理* → *一般* →*ハウスキーピング* で変更できます。 ::: notetip TimescaleDB が提供する timescaledb-tune ツールを実行して、`postgresql.conf` の PostgreSQL 構成パラメーターを最適化することができます。 ::: ##### 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=* ##### 特定のチェックを許可し、他のチェックを拒否する - AllowKey パラメータで特定のチェックをホワイトリスト化し、`DenyKey=*`で他のチェックを拒否する。 例: # Allow reading logs: AllowKey=vfs.file.*[/var/log/*] # Allow localtime checks AllowKey=system.localtime[*] # Deny all other keys DenyKey=* ### 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. ### LLDフィルター内のAND/ORの評価 このバージョンでは、ローレベルディスカバリーフィルター/オーバーライドでのAND/ORの評価が失敗する可能性があります。 Zabbix 6.0.12で修正されました。 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. 新しい[テンプレート](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とも連携できるようになりました。 #### 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  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. #### アノマリー検知 Zabbix 5.2では、ベースライン監視に役立つ新しいトレンド関数が導入されました。しかし、この機能でも相対的な閾値を定義する必要があります。(例：2021年9月のWebトラフィックが2020年9月に比べて2倍以下であることをチェックする)。実際のところ、このような閾値の定義が困難なケースもあります。例えば、新しいが非常に人気のあるウェブサイトのトラフィックは、1年間で何倍にも有機的に成長するが、その成長率は未知数です。しかし、DDOS攻撃による急激なトラフィックの増加は、有機的なトラフィックの増加とは無関係にアラートを発生させなければいけません。 異常値検出アルゴリズムは、まさにこれを行うもので、他の値のコンテキストの中で正常に見えないデータ（異常値）を見つけるものです。 新しい [履歴関数](/manual/appendix/functions/history) **trendstl()** が追加され、異常率を計算するために 'decomposition' メソッドを使用するようになりました。この関数は、1つの時系列を3つの時系列に分割します。 - トレンドシーケンス：元データの大きな変化のみを含む（例：ウェブサイトのトラフィックが増加している） - シーズンシーケンス：季節的な変化のみを含む（例：夏にはウェブサイトのトラフィックが少なく、秋には多くなる） - トレンドの一部とも季節の一部とも解釈できない残差のみを含むシーケンス  異常検出は余りの列で動作し、余りの値の大多数から離れすぎている(far from)値があるかどうかをチェックします。"離れすぎている(Far)"とは、余りの配列からの絶対値が、標準偏差または平均偏差のN倍であることを意味します。 ##### 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  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). ::: ##### インライン正規表現修飾子を含む別の例 複数のインライン修飾子を含む次の正規表現を使用すると、特定の行以降の文字にマッチします。 (?<=match (?i)everything(?-i) after this line\n)(?sx).*# we add s modifier to allow .match newline characters  選択されたExpression type : "結果はTRUE "です。 <br> 特定の行以降の文字にマッチします。 ::: noteimportant **g**修飾子は、行内で指定することはできません。利用可能な修飾子の一覧は、[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> ::: ##### API changes See the list of [API changes](/manual/api/changes_5.4_-_6.0) in Zabbix 6.0.0. ##### API変更点 Zabbix 6.0.0 の [API changes](/manual/api/changes_5.4_-_6.0)の一覧を参照してください。 ### 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) ### API情報 Zabbix APIのバージョンを取得し、アプリケーションでバージョン固有の機能を使用できるようにします。 [API info API](/manual/api/reference/apiinfo) # apiinfo.version # apiinfo.version #### 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`. #### APIログイン カスタムスクリプトで`user.login`[メソッド](/manual/api/reference/user/login)を使用し、その後に`user.logout`を実行しないと、多数のオープンユーザーセッションが作成されることがあります。 #### API Tokens Manage authorization tokens. [Token API](/manual/api/reference/token) #### APIトークン 認可トークンを管理します。 [Token API](/manual/api/reference/token) #### - API tokens This section allows to create and manage API tokens. {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:  |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. #### - APIトークン このセクションでは、APIトークンを作成および管理できます。 {width="600"} APIトークンは、名前、トークンが割り当てられているユーザー、有効期限、トークンを作成したユーザー、またはステータス（有効/無効）でフィルタリングできます。リスト内のトークンステータスをクリックして、トークンを有効/無効に設定できます。リストでトークンを選択し、リストの下にある*有効化/無効化*ボタンをクリックして、トークンを一括有効化/無効化することもできます。 新しいトークンを作成するには、右上隅にある*APIトークンの作成*ボタンを押してから、トークン設定画面の必須フィールドに入力します。  |パラメータ|詳細| |---------|-----------| |名前|トークンの表示名| |ユーザー|トークンを割り当てる必要があるユーザー。ユーザーを選択するには、ユーザー名、名または姓の入力を開始し、オートコンプリートリストから必要なユーザーを選択します。または選択ボタンを押して、ユーザーリストからユーザーを選択することもできます。トークンは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) 権限で許可されます。 ### 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). ::: ### 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 に加えられたすべての変更を追うことができます。 ::: # Appendix 1. Reference commentary # 付録1. 参考文献の解説 # Appendix 2. Changes from 5.4 to 6.0 # 付録2. 5.4から6.0での変更点 #### Architecture Zabbix consists of several major software components. Their responsibilities are outlined below. #### アーキテクチャー Zabbixは、いくつかの主なソフトウェアコンポーネントから構成されています。各コンポーネントの役割を以下に示します。 #### 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 #### 実際に使用するシナリオ この例では、ローカルネットワークの192.168.1.1～192.168.1.254の範囲のIPアドレスをチェックするネットワークディスカバリを設定します。 このシナリオでは、以下のことをおこなう設定をします： - Zabbixエージェントが動作しているホストを検出 - 検出は10分間隔で実行 - アップタイムが1時間以上のホストは監視対象に追加 - ダウンタイムが24時間以上のホストは監視対象から削除 - Linuxホストはグループ「Linux servers」に追加 - Windowsホストはグループ「Windows servers」に追加 - Linuxホストではテンプレート*Linux*を使用 - Windowsホストではテンプレート*Windows*を使用 ##### 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>. ##### AS/400 IBM AS/400 プラットフォームは、SNMP を使用して監視できます。 詳細については、次の Web サイトを参照してください。 <http://publib-b.boulder.ibm.com/Redbooks.nsf/RedbookAbstracts/sg244504.html?Open>. #### 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 } ``` #### 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 } ``` #### 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 } ``` #### 異なるホストの割り当て 現在メンテナンスに割り当てられているホストを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 } ``` #### Attempting to use Zabbix sender compiled with TLS support to send data to Zabbix server/proxy compiled without TLS #### TLS サポートでコンパイルされた Zabbix センダーを使用して、TLS なしでコンパイルされた Zabbix サーバー/プロキシにデータを送信した場合 ##### 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] ##### 複合データを返す属性 例えば、属性名が "apple" で、"weight" 、"color" などのパラメータを表すハッシュを返す場合、属性はより複雑になります。 キーは次のようになります。 jmx[com.example:Type=Hello,apple.weight] このように、属性名とハッシュ・キーは、ドット記号で区切られます。 同じように、属性がネストした複合データを返す場合は、ドットで区切ります。 jmx[com.example:Type=Hello,fruits.apple.weight] ##### 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" } ] ``` ##### 表形式データを返す属性 表形式データ属性は、1つまたは複数の複合属性から構成されます。属性名パラメータにそのような<br> 属性が指定された場合、この item 値はその属性の完全な構造をJSON形式で返します。<br> 表形式データ属性の中の個々の要素値は、プリプロセスによって取得することができます。 表形式データ属性の例: Item 値: ``` {.javascript} [ { "a": "apple", "b": "banana", "c": "cherry" }, { "a": "potato", "b": "lettuce", "c": "onion" } ] ``` #### Audit log #### 監査ログ ### 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.** ##### 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. #### 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).\ #### 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).\ ### Audit log filter Multiple actions now can be selected in the audit log filter in *Reports* -> *[Audit](/manual/web_interface/frontend_sections/reports/audit)*: {width="600"} This is useful to see all related actions (for example, successful and failed logins into the frontend) in the audit list. ### 監査ログフィルター *レポート* -> *[監査](/manual/web_interface/frontend_sections/reports/audit)* にある監査ログフィルターで複数のアクションを選択できるようになりました。 {width="600"} これは、関連するすべてのアクション (たとえば、Webインターフェースへのログインの成功や失敗) を監査リストで確認するのに便利です。 # auditlog.get # auditlog.get #### 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.** #### 監査ログ [監査ログ機能](#監査ログ)の変更を実装するために、既存のデータベース構造を再構築する必要がありました。 アップグレードによって、`auditlog`と`auditlog_details`DB テーブルは、異なるフォーマットの新しいテーブル`auditlog`に置き換えられます。**既存の監査ログのレコードは削除されます。** ##### 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. ##### 監査ログ 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> ### Audit log The audit log object contains information about user actions. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |auditid|string|*(readonly)* ID of audit log entry. Generated using CUID algorithm.| |userid|string|Audit log entry author userid.| |username|string|Audit log entry author username.| |clock|timestamp|Audit log entry creation timestamp.| |ip|string|Audit log entry author IP address.| |action|integer|Audit log entry action.<br><br>Possible values are:<br>0 - Add;<br>1 - Update;<br>2 - Delete;<br>4 - Logout;<br>7 - Execute;<br>8 - Login;<br>9 - Failed login;<br>10 - History clear.| |resourcetype|integer|Audit log entry resource type.<br><br>Possible values are:<br>0 - User;<br>3 - Media type;<br>4 - Host;<br>5 - Action;<br>6 - Graph;<br>11 - User group;<br>13 - Trigger;<br>14 - Host group;<br>15 - Item;<br>16 - Image;<br>17 - Value map;<br>18 - Service;<br>19 - Map;<br>22 - Web scenario;<br>23 - Discovery rule;<br>25 - Script;<br>26 - Proxy;<br>27 - Maintenance;<br>28 - Regular expression;<br>29 - Macro;<br>30 - Template;<br>31 - Trigger prototype;<br>32 - Icon mapping;<br>33 - Dashboard;<br>34 - Event correlation;<br>35 - Graph prototype;<br>36 - Item prototype;<br>37 - Host prototype;<br>38 - Autoregistration;<br>39 - Module;<br>40 - Settings;<br>41 - Housekeeping;<br>42 - Authentication;<br>43 - Template dashboard;<br>44 - User role;<br>45 - API token;<br>46 - Scheduled report;<br>47 - High availability node;<br>48 - SLA.| |resourceid|string|Audit log entry resource identifier.| |resourcename|string|Audit log entry resource human readable name.| |recordsetid|string|Audit log entry recordset ID. The audit log records created during the same operation will have the same recordset ID. Generated using CUID algorithm.| |details|text|Audit log entry details. The details are stored as JSON object where each property name is a path to property or nested object in which change occurred, and each value contain the data about the change of this property in array format.<br><br>Possible value formats are:<br>\["add"\] - Nested object has been added;<br>\["add", "<value>"\] - The property of added object contain <value>;<br>\["update"\] - Nested object has been updated;<br>\["update", "<new value>", "<old value>"\] - The value of property of updated object was changed from <old value> to <new value>;<br>\["delete"\] - Nested object has been deleted.| ### Audit log Audit log オブジェクトは、ユーザーのアクションに関する情報を含んでいます。以下のプロパティを持ちます。 ### Audit log Audit log オブジェクトは、ユーザーのアクションに関する情報を含んでいます。以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |auditid|string|*(読取専用)* 監査ログのエントリID。CUID アルゴリズムを使用して生成されます。| |userid|string|監査ログがエントリされる操作を行ったユーザID。| |username|string|監査ログがエントリされる操作を行ったユーザI名| |clock|timestamp|監査ログがエントリされた時間| |ip|string|監査ログがエントリされる操作を行ったIPアドレス| |action|integer|監査ログのエントリ・アクション<br><br>可能な値:<br>0 - 追加;<br>1 - 更新;<br>2 - 削除;<br>4 - ログアウト;<br>7 - 実行;<br>8 - ログイン;<br>9 - ログイン失敗;<br>10 - ヒストリクリア.| |resourcetype|integer|Audit log entry resource type.<br><br>Possible values are:<br>0 - ユーザー;<br>3 -メディアタイプ;<br>4 - ホスト;<br>5 - アクション;<br>6 - グラフ<br>11 - ユーザグループ;<br>13 - トリガー;<br>14 - ホストグループ;<br>15 - アイテム;<br>16 - イメージ;<br>17 - 値のマッピング;<br>18 - サービス;<br>19 - マップ;<br>22 - Webシナリオ;<br>23 - ディスカバリルール;<br>25 - スクリプト;<br>26 - プロキシ;<br>27 - メンテナンス;<br>28 - 正規表現;<br>29 - マクロ;<br>30 - テンプレート;<br>31 - トリガーのプロトタイプ;<br>32 - アイコンのマッピング;<br>33 - ダッシュボード;<br>34 - イベント相関関係;<br>35 - グラフのプロトタイプ;<br>36 - アイテムのプロトタイプ;<br>37 - ホストプロトタイプ;<br>38 - 自動登録;<br>39 - モジュール;<br>40 - 設定;<br>41 - データの保存期間;<br>;42 - 認証;<br>43 - テンプレートのダッシュボード;<br>44 - ユーザーの役割;<br>45 - APIトークン;<br>;46 - 定期レポート;<br>47 - HAノード;<br>48 - SLA.| |resourceid|string|監査ログのエントリ・リソース識別子。| |resourcename|string|監査ログの判別可能なエントリ・リソース名称。| |recordsetid|string|監査ログのエントリ・レコードセット ID。同じ操作中に作成された監査ログのレコードには同じレコードセットIDが設定されます。CUID アルゴリズムを使用して生成されます。| |details|text|監査ログの エントリ詳細。詳細はJSON オブジェクトとして保存されます。各プロパティ名は変更が発生したプロパティまたはネストされたオブジェクトへのパスで、各値にはこのプロパティの変更に関するデータが配列形式で含まれています。<br><br>可能な値の形式は次のとおりです:<br>\["add"\] - ネストされたオブジェクトが追加されました。<br>\["add", "<value>\] - 追加されたオブジェクトのプロパティに<value>が含まれています。<br>\["update"\] - ネストされたオブジェクトが更新されました。<br>\["update", "<new value>", "<old value>"\] - 更新されたオブジェクトのプロパティの値が<old value>から<new value>に変更されました。<br>\["delete"\] - ネストされたオブジェクトが削除されました。| **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. **監査設定** 新しい[セクション](/manual/web_interface/frontend_sections/administration/general#audit_log) *管理→一般設定* メニューに *監査ログ* が追加され、監査ログの有効化と無効化ができるようになりました。 これまで*データの保存期間*セクションにあった監査用の保存期間設定も、新しい*監査ログ*セクションに移動されました。 #### 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 } ``` #### ユーザー認証 ユーザー認証 Request: ```json { "jsonrpc": "2.0", "method": "user.login", "params": { "username": "Admin", "password": "zabbix" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` #### Authentication Change authentication configuration options. [Authentication API](/manual/api/reference/authentication) #### 認証 認証の設定オプションを変更します。 [Authentication API](/manual/api/reference/authentication) # authentication.get # authentication.get #### Authentication request signing It is possible to configure Entra ID to [validate the signature](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/howto-enforce-signed-saml-authentication) of signed authentication requests. To make this work, create public/private keys: ```bash openssl req -x509 -newkey rsa:4096 -keyout /usr/share/zabbix/conf/certs/request-sign.key -out /usr/share/zabbix/conf/certs/request-sign.pem -sha256 -days 1825 -nodes ``` Assign permissions: ```bash chown apache /usr/share/zabbix/conf/certs/request-sign.key chmod 400 /usr/share/zabbix/conf/certs/request-sign.key ``` Update Zabbix frontend configuration by adding: ```php $SSO['SP_KEY'] = 'conf/certs/request-sign.key'; $SSO['SP_CERT'] = 'conf/certs/request-sign.crt'; ``` #### 認証リクエストの署名 Entra ID を構成して、署名された認証リクエストの [署名を検証](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/howto-enforce-signed-saml-authentication) することができます。 これを実行するには、公開鍵と秘密鍵を作成します。 ```bash openssl req -x509 -newkey rsa:4096 -keyout /usr/share/zabbix/conf/certs/request-sign.key -out /usr/share/zabbix/conf/certs/request-sign.pem -sha256 -days 1825 -nodes ``` 権限を割り当てます。 ```bash chown apache /usr/share/zabbix/conf/certs/request-sign.key chmod 400 /usr/share/zabbix/conf/certs/request-sign.key ``` Zabbix フロントエンドの設定に以下のコードを追加します。 ```php $SSO['SP_KEY'] = 'conf/certs/request-sign.key'; $SSO['SP_CERT'] = 'conf/certs/request-sign.crt'; ``` # authentication.update # authentication.update ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## 著者 Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## 著者 Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## 著者 Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## 著者 Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## 著者 Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ##### 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.| ##### 認可 |パラメータ|詳細| |--|--------| |*ログインの試行*|ログインがブロックされるログイン失敗の数| |*ログインブロックの間隔*|*ログインの試行*回数を超えた場合にログインが禁止される期間| ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## 著者 Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## 著者 Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} #### 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. #### 自動タイプ選択機能 アイテム設定画面で、選択されたアイテムキーが特定のタイプのデータのみを返す場合、一致する情報のタイプを自動的に提案するようになりました。(例えば、**log\[\]**アイテムは、*データ型: ログ*であることが必要) *データ型*パラメーターが*アイテム*タブの*Key*パラメータの下に配置され、少なくとも1つの保存前処理が定義されている場合は、*保存前処理* タブに複製されます。選択したタイプの情報とキーが一致しない可能性がある場合、警告アイコンが *データ型* フィールドの横に表示されます。 ##### 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\] ##### 自動モード ホストのインベントリも自動的に入力できます。これを機能させるには、*インベントリ*タブでホストのインベントリモードを設定するときに*自動*に設定する必要があります。 次に、[ホストアイテムを設定](/manual/config/items/item)して、ホストインベントリフィールドに値を付けるようにアイテム設定のそれぞれの属性を持つ宛先フィールドを示すことができます(呼び出された*アイテムはホストインベントリフィールドに入力されます*)。 インベントリデータの自動収集に特に有効なアイテムを収集することができます。 - 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\] #### 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.| #### 自動登録アクション 次の条件は、アクティブなエージェントの自動登録に基づくアクションで使用できます。 |タイプ|オペレータ|説明| |--|--|------| |*ホストメタデータ*|含む<br>含まない<br>一致する<br>一致しない|ホストのメタデータまたは除外するホストのメタデータを指定します。<br>**含む** - ホスト メタデータには指定文字列が含まれる。<br>**含まない** - ホスト メタデータに指定文字列が含まれない。<br>ホストのメタデータは[エージェント設定ファイル](/manual/appendix/config/zabbix_agentd)で指定できます。<br>**一致する** - ホスト メタデータは正規表現と一致する。<br>**一致しない** - ホスト メタデータは正規表現と一致しない。| |*ホスト名*|含む<br>含まない<br>一致する<br>一致しない|ホスト名または除外するホスト名を指定します。<br>**含む** - ホスト名に文字列が含まれる。<br>**含まない** - ホスト名に文字列が含まれない。<br>** 一致する** - ホスト名が正規表現に一致する。<br>**一致しない** - ホスト名が正規表現に一致しない。| |*プロキシ*|等しい<br>等しくない|プロキシまたは除外するプロキシを指定します。<br>**等しい** - このプロキシを使用します。<br>**等しくない** - このプロキシ以外の他のプロキシを使用します。| # autoregistration.get # autoregistration.get #### 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. #### 自動登録テーブルの孤立したレコードが消去されるように 以前は、`autoreg_host`テーブルがクリアされることはありませんでした。 自動登録イベントも既存のホストも参照しない孤立したレコードは、ハウスキーパーによって削除されるようになりました。 ### 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 unencrypted connections;<br>2 - allow TLS with PSK.<br>3 - allow both unencrypted and TLS with PSK connections.| |tls\_psk\_identity|string|*(write-only)* PSK identity; must be paired with only one PSK (across [autoregistration](/manual/api/reference/autoregistration/object), [hosts](/manual/api/reference/host/object), and [proxies](/manual/api/reference/proxy/object)).<br>Do not include sensitive information in the PSK identity, as it is sent unencrypted over the network to inform the receiver which PSK to use.| |tls\_psk|string|*(write-only)* Pre-shared key (PSK); must be at least 32 hex digits.| ### 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).| # autoregistration.update # autoregistration.update ##### 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 ##### Nginx サーバーへの平均リクエスト数 Nginx サーバーへの 1 日あたりの平均リクエスト数 (秒) を表示します。 - データセットに秒間リクエスト数の item を追加します。 - 集約関数 `avg` を選択し、インターバル `1d` を指定します。 - 棒グラフが表示され、各棒は一日あたりの平均秒間リクエスト数を表します。 #### Axes The following parameters are supported for configuring *Axes*. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Left Y*|0|lefty|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>Parameter available if *Y-axis* (in *Data set* configuration) is set to "Left".| |*Right Y*|0|righty|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>Parameter available if *Y-axis* (in *Data set* configuration) is set to "Right".| |*Min*|1|lefty_min|Any numeric value.<br><br>Default: `""` (empty).| |^|^|righty_min|^| |*Max*|1|lefty_max|Any numeric value.<br><br>Default: `""` (empty).| |^|^|righty_max|^| |*Units* (type)|0|lefty_units|0 - *(default)* Auto;<br>1 - Static.| |^|^|righty_units|^| |*Units* (value)|1|lefty_static_units|Any string value.<br><br>Default: `""` (empty).| |^|^|righty_static_units|^| |*X-Axis*|0|xaxis|0 - Disabled;<br>1 - *(default)* Enabled.| #### 軸 *軸*の設定には、以下のパラメータがサポートされています。 |パラメータ|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|名前|値| |-----|-|-----|-------------------| |*左Y軸*|0|lefty|0 - 無効;<br>1 - *(デフォルト)* 有効<br><br>*データセット*設定の*Y軸*が「左」に設定されている場合に使用できるパラメータです。| |*右Y軸*|0|righty|0 - *(デフォルト)* 無効;<br>1 - 有効<br><br>*データセット*設定の*Y軸*が「右」に設定されている場合に使用できるパラメータです。| |*最小値*|1|lefty_min|任意の数値<br><br>デフォルト: `""` (空)| |^|^|righty_min|^| |*最大*|1|lefty_max|任意の数値<br><br>デフォルト: `""` (空)| |^|^|righty_max|^| |*単位* (タイプ)|0|lefty_units|0 - *(デフォルト)* 自動<br>1 - 静的| |^|^|righty_units|^| |*単位* (値)|1|lefty_static_units|任意の文字列値<br><br>デフォルト: `""` (空) | |^|^|righty_static_units|^| |*X軸*|0|xaxis|0 - 無効<br>1 - *(デフォルト)* 有効| ### Backward incompatible changes ### 後方互換性のない変更点 #### 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. #### ベースライン監視 ベースライン監視のオプションが拡張され、**baselinedev**と**baselinewma**の2つの関数が追加されました。 - **baselinedev** - 直近のデータ期間と、それ以前のシーズンの同じデータ期間を比較し、偏差の値を返します。 - **baselinewma** - 加重移動平均アルゴリズムを使用して、複数の等しい期間('シーズン')の同じタイムフレームのデータを平均化することによりベースラインを計算します。 これらの機能において、'シーズン'という用語は、時間、日、週、月、年単位で設定可能な時間枠を指します。シーズンの長さと分析するシーズン数は、関数のパラメーターで設定します。 詳しくは、[ヒストリ関数](/manual/appendix/functions/history)を参照してください。 #### 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. #### ヒストリテーブルの一括移行 * 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) に従って、古いテーブルを削除します。 #### Behavior depending on availability The following table illustrates how each function behaves in cases of limited availability of host/item and history data. |Function|Disabled host|Unavailable host with data|Unavailable host without data|Disabled item|Unsupported item|Data retrieval error (SQL)| |--|--|--|--|--|--|--| |*avg_foreach*|ignore|return avg|ignore|ignore|ignore|ignore| |*bucket_rate_foreach*|ignore|return bucket rate|ignore|ignore|ignore|ignore| |*count_foreach*|ignore|return count|0|ignore|ignore|ignore| |*exists_foreach*|ignore|1|1|ignore|1|n/a| |*last_foreach*|ignore|return last|ignore|ignore|ignore|ignore| |*max_foreach*|ignore|return max|ignore|ignore|ignore|ignore| |*min_foreach*|ignore|return min|ignore|ignore|ignore|ignore| |*sum_foreach*|ignore|return sum|ignore|ignore|ignore|ignore| If the item is *ignored*, nothing is added to the aggregation. #### 空き状況に応じた動作 次の表は、ホスト/アイテムおよびヒストリデータの可用性が制限されている場合に各関数がどのように動作するかを示しています。 |関数|無効なホスト|データのある利用不可能なホスト|データのない利用不可能なホスト|無効な項目|取得不可のアイテム|データ取得エラー(SQL)| |--|--|--|--|--|--|--| |*avg_foreach*|無視|平均値|無視|無視|無視|無視| |*bucket_rate_foreach*|無視|バケット率|無視|無視|無視|無視| |*count_foreach*|無視|カウント数|0|無視|無視|無視| |*exists_foreach*|無視|1|1|無視|1|n/a| |*last_foreach*|無視|最新値|無視|無視|無視|無視| |*max_foreach*|無視|最大値|無視|無視|無視|無視| |*min_foreach*|無視|最小値|無視|無視|無視|無視| |*sum_foreach*|無視|合計値|無視|無視|無視|無視| アイテムが*無視*された場合、集計には何も追加されません。 # Best practices for secure Zabbix setup [comment]: # (tags: ssl) # Zabbixの安全なセットアップのためのベストプラクティス #### 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:  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:  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). #### アイテム設定と最新データ間のナビゲーションの改善 *[最新データ](/manual/web_interface/frontend_sections/monitoring/latest_data)*に、アイテムのための新しいコンテキストメニューが導入され、アイテムの構成と利用可能なグラフにアクセスすることができるようになりました。  逆に、[ホストのアイテム一覧](/manual/web_interface/frontend_sections/configuration/hosts/items) の設定メニューに新しいコンテキストメニューが導入され、最新のデータにアクセスすることができるようになりました。他にも便利なオプションがあります。  このメニューは、以前のバージョンのウィザードオプションを置き換えたものです。 同様のメニューは、[テンプレートのアイテム](/manual/web_interface/frontend_sections/configuration/_templates/items) にも導入されています。 [アイテムのプロトタイプ](/Manual/discovery/low_level_discovery/item_prototypes)にも同様のメニューが導入されました。 ## Breaking changes ## 重大な変更 ## Breaking changes ## 重大な変更 ## Breaking changes ## 重大な変更 ## Breaking changes ## 重大な変更 ## Breaking changes ## 重大な変更 ## Breaking changes ## 重大な変更 ## Breaking changes ## 重大な変更 ### 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). ### 重大な変更 #### ロード可能なプラグインのバージョン管理 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*ブランチのみ)。 ### 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). ### 重大な変更 #### ロード可能なプラグインのバージョン管理 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*ブランチのみ)。 ##### 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 ##### BSD systems `watch`コマンドがインストールされていない場合は、同様の効果が得られます while [ 1 ]; do ps x; sleep 0.2; clear; done ##### 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 ##### 32bit版PCREのビルド 1\. 次のコマンドを実行します。 mingw32-make clean 2\. *CMakeCache.txt*を削除します。 del CMakeCache.txt rmdir /q /s CMakeFiles 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 ##### 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 ##### 64bit版PCREのビルド 1\. 古い設定/キャッシュが存在する場合は削除します。 del CMakeCache.txt rmdir /q /s CMakeFiles 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 mingw32-make install #### Building agent binaries with shared libraries Install PCRE2 (replace *pcre2* with *pcre* in the commands below, if needed): brew install pcre2 When building with TLS, install OpenSSL and/or GnuTLS: brew install openssl brew install gnutls Download Zabbix source: git clone https://git.zabbix.com/scm/zbx/zabbix.git Build agent without TLS: cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 make make install Build agent with OpenSSL: cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-openssl=/usr/local/opt/openssl make make install Build agent with GnuTLS: cd zabbix-source/ ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-gnutls=/usr/local/opt/gnutls make make install #### 共有ライブラリを使用したエージェントバイナリのビルド PCRE2をインストール (必要に応じて、以下のコマンドの*pcre2*を*pcre*に置き換えてください)。 brew install pcre2 TLSでビルドする場合はOpenSSLとGnuTLSの両方、あるいはどちらかをインストール。 brew install openssl brew install gnutls Zabbixソースをダウンロード。 git clone https://git.zabbix.com/scm/zbx/zabbix.git TLSなしでエージェントをビルド。 cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 make make install OpenSSLを使用してエージェントをビルド。 cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-openssl=/usr/local/opt/openssl make make install GnuTLSを使用してエージェントをビルド。 cd zabbix-source/ ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-gnutls=/usr/local/opt/gnutls make make install #### Building agent binaries with static libraries with GnuTLS GnuTLS depends on the Nettle crypto backend and GMP arithmetic library. Instead of using full GMP library, this guide will use mini-gmp which is included in Nettle. When building GnuTLS and Nettle, it's recommended to run `make check` after successful building. Even if building was successful, tests sometimes fail. If this is the case, problems should be researched and resolved before continuing. Let's assume that PCRE, Nettle and GnuTLS static libraries will be installed in `$HOME/static-libs`. We will use PCRE2 10.39, Nettle 3.4.1 and GnuTLS 3.6.5. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" NETTLE_PREFIX="$HOME/static-libs/nettle-3.4.1" GNUTLS_PREFIX="$HOME/static-libs/gnutls-3.6.5" Let's build static libraries in `static-libs-source`: mkdir static-libs-source cd static-libs-source Download and build Nettle: curl --remote-name https://ftp.gnu.org/gnu/nettle/nettle-3.4.1.tar.gz tar xf nettle-3.4.1.tar.gz cd nettle-3.4.1 ./configure --prefix="$NETTLE_PREFIX" --enable-static --disable-shared --disable-documentation --disable-assembler --enable-x86-aesni --enable-mini-gmp make make check make install cd .. Download and build GnuTLS: curl --remote-name https://www.gnupg.org/ftp/gcrypt/gnutls/v3.6/gnutls-3.6.5.tar.xz tar xf gnutls-3.6.5.tar.xz cd gnutls-3.6.5 PKG_CONFIG_PATH="$NETTLE_PREFIX/lib/pkgconfig" ./configure --prefix="$GNUTLS_PREFIX" --enable-static --disable-shared --disable-guile --disable-doc --disable-tools --disable-libdane --without-idn --without-p11-kit --without-tpm --with-included-libtasn1 --with-included-unistring --with-nettle-mini make make check make install cd .. Download Zabbix source and build agent: git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh CFLAGS="-Wno-unused-command-line-argument -framework Foundation -framework Security" \ > LIBS="-lgnutls -lhogweed -lnettle" \ > LDFLAGS="-L$GNUTLS_PREFIX/lib -L$NETTLE_PREFIX/lib" \ > ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" --with-gnutls="$GNUTLS_PREFIX" make make install #### GnuTLSと静的ライブラリを使用してエージェントバイナリをビルドする GnuTLSは、Nettle暗号バックエンドとGMP演算ライブラリに依存しています。 完全なGMPライブラリを使用する代わりに、このガイドでは、Nettleに含まれているmini-gmpを使用します。 GnuTLSとNettleをビルドするときは、ビルドが成功した後に`make check`を実行することをお勧めします。 ビルドが成功した場合でも、テストが失敗することがあります。 この場合は、続行する前に問題を調査して解決する必要があります。 PCRE、Nettle、およびGnuTLS静的ライブラリが`$HOME/static-libs`にインストールされると仮定します。 PCRE2 10.39、Nettle 3.4.1、およびGnuTLS 3.6.5を使用します。 PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" NETTLE_PREFIX="$HOME/static-libs/nettle-3.4.1" GNUTLS_PREFIX="$HOME/static-libs/gnutls-3.6.5" `static-libs-source`で静的ライブラリをビルドします。 mkdir static-libs-source cd static-libs-source Nettleをダウンロードしてビルドします。 curl --remote-name https://ftp.gnu.org/gnu/nettle/nettle-3.4.1.tar.gz tar xf nettle-3.4.1.tar.gz cd nettle-3.4.1 ./configure --prefix="$NETTLE_PREFIX" --enable-static --disable-shared --disable-documentation --disable-assembler --enable-x86-aesni --enable-mini-gmp make make check make install cd .. GnuTLSをダウンロードしてビルドします。 curl --remote-name https://www.gnupg.org/ftp/gcrypt/gnutls/v3.6/gnutls-3.6.5.tar.xz tar xf gnutls-3.6.5.tar.xz cd gnutls-3.6.5 PKG_CONFIG_PATH="$NETTLE_PREFIX/lib/pkgconfig" ./configure --prefix="$GNUTLS_PREFIX" --enable-static --disable-shared --disable-guile --disable-doc --disable-tools --disable-libdane --without-idn --without-p11-kit --without-tpm --with-included-libtasn1 --with-included-unistring --with-nettle-mini make make check make install cd .. Zabbixソースとビルドエージェントをダウンロードをします。 git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh CFLAGS="-Wno-unused-command-line-argument -framework Foundation -framework Security" \ > LIBS="-lgnutls -lhogweed -lnettle" \ > LDFLAGS="-L$GNUTLS_PREFIX/lib -L$NETTLE_PREFIX/lib" \ > ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" --with-gnutls="$GNUTLS_PREFIX" make make install #### Building agent binaries with static libraries with OpenSSL When building OpenSSL, it's recommended to run `make test` after successful building. Even if building was successful, tests sometimes fail. If this is the case, problems should be researched and resolved before continuing. Let's assume that PCRE and OpenSSL static libraries will be installed in `$HOME/static-libs`. We will use PCRE2 10.39 and OpenSSL 1.1.1a. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" OPENSSL_PREFIX="$HOME/static-libs/openssl-1.1.1a" Let's build static libraries in `static-libs-source`: mkdir static-libs-source cd static-libs-source Download and build PCRE with Unicode properties support: curl --remote-name https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz tar xf pcre2-10.39.tar.gz cd pcre2-10.39 ./configure --prefix="$PCRE_PREFIX" --disable-shared --enable-static --enable-unicode-properties make make check make install cd .. Download and build OpenSSL: curl --remote-name https://www.openssl.org/source/openssl-1.1.1a.tar.gz tar xf openssl-1.1.1a.tar.gz cd openssl-1.1.1a ./Configure --prefix="$OPENSSL_PREFIX" --openssldir="$OPENSSL_PREFIX" --api=1.1.0 no-shared no-capieng no-srp no-gost no-dgram no-dtls1-method no-dtls1_2-method darwin64-x86_64-cc make make test make install_sw cd .. Download Zabbix source and build agent: git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" --with-openssl="$OPENSSL_PREFIX" make make install #### OpenSSLと静的ライブラリを使用してエージェントバイナリをビルドする OpenSSLをビルドするとき、ビルドが成功した後に`make test`を実行することをお勧めします。 ビルドが成功した場合でも、テストが失敗することがあります。 この場合は、続行する前に問題を調査して解決する必要があります。 PCREとOpenSSLの静的ライブラリが`$HOME/static-libs`にインストールされると仮定します。PCRE2 10.39とOpenSSL 1.1.1aを使用します。 PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" OPENSSL_PREFIX="$HOME/static-libs/openssl-1.1.1a" `static-libs-source`で静的ライブラリをビルドします。 mkdir static-libs-source cd static-libs-source UnicodeプロパティをサポートするPCREをダウンロードしてビルドする。 curl --remote-name https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz tar xf pcre2-10.39.tar.gz cd pcre2-10.39 ./configure --prefix="$PCRE_PREFIX" --disable-shared --enable-static --enable-unicode-properties make make check make install cd .. OpenSSLをダウンロードしてビルドする。 curl --remote-name https://www.openssl.org/source/openssl-1.1.1a.tar.gz tar xf openssl-1.1.1a.tar.gz cd openssl-1.1.1a ./Configure --prefix="$OPENSSL_PREFIX" --openssldir="$OPENSSL_PREFIX" --api=1.1.0 no-shared no-capieng no-srp no-gost no-dgram no-dtls1-method no-dtls1_2-method darwin64-x86_64-cc make make test make install_sw cd .. Zabbixソースとビルドエージェントをダウンロードする。 git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" --with-openssl="$OPENSSL_PREFIX" make make install #### Building agent binaries with static libraries without TLS Let's assume that PCRE static libraries will be installed in `$HOME/static-libs`. We will use PCRE2 10.39. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" Download and build PCRE with Unicode properties support: mkdir static-libs-source cd static-libs-source curl --remote-name https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz tar xf pcre2-10.39.tar.gz cd pcre2-10.39 ./configure --prefix="$PCRE_PREFIX" --disable-shared --enable-static --enable-unicode-properties make make check make install Download Zabbix source and build agent: git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" make make install #### TLSを使用しない静的ライブラリを使用したエージェントバイナリのビルド `$HOME/static-libs`にPCRE静的ライブラリがインストールされると仮定します。PCRE2 10.39を使用します。 PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" UnicodeプロパティをサポートするPCREをダウンロードしてビルドします。 mkdir static-libs-source cd static-libs-source curl --remote-name https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz tar xf pcre2-10.39.tar.gz cd pcre2-10.39 ./configure --prefix="$PCRE_PREFIX" --disable-shared --enable-static --enable-unicode-properties make make check make install Zabbixソースとビルドエージェントをダウンロードします。 git clone https://git.zabbix.com/scm/zbx/zabbix.git cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-libpcre2="$PCRE_PREFIX" make make install #### Building inventory #### インベントリの構築 ### Built-in objects ### 組込オブジェクト #### Built-in The following plugins for Zabbix agent 2 are available out-of-the-box. Click on the plugin name to go to the plugin repository with additional information. |Plugin name|Description|[Supported item keys](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2)|Comments| |--|--|--|----| |Agent|Metrics of the Zabbix agent being used.|agent.hostname, agent.ping, agent.version|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Ceph](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/ceph/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Ceph monitoring.|ceph.df.details, ceph.osd.stats, ceph.osd.discovery, ceph.osd.dump,<br>ceph.ping, ceph.pool.discovery, ceph.status| | |[CPU](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/cpu?at=refs%2Fheads%2Frelease%2F6.0)|System CPU monitoring (number of CPUs/CPU cores, discovered CPUs, utilization percentage).|system.cpu.discovery, system.cpu.num, system.cpu.util|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Docker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/docker/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of Docker containers.|docker.container\_info, docker.container\_stats, docker.containers, docker.containers.discovery,<br>docker.data\_usage, docker.images, docker.images.discovery, docker.info, docker.ping|See also:<br>[Configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/d_plugin)| |File|File metrics collection.|vfs.file.cksum, vfs.file.contents, vfs.file.exists, vfs.file.md5sum,<br>vfs.file.regexp, vfs.file.regmatch, vfs.file.size, vfs.file.time|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Kernel](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/kernel?at=refs%2Fheads%2Frelease%2F6.0)|Kernel monitoring.|kernel.maxfiles, kernel.maxproc|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Log](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/log?at=refs%2Fheads%2Frelease%2F6.0)|Log file monitoring.|log, log.count, logrt, logrt.count|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).<br><br>See also:<br>Plugin configuration parameters ([Unix](/manual/appendix/config/zabbix_agent2)/[Windows](/manual/appendix/config/zabbix_agent2_win))| |[Memcached](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/memcached/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Memcached server monitoring.|memcached.ping, memcached.stats| | |[Modbus](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/modbus/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Reads Modbus data.|modbus.get|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[MQTT](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mqtt/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Receives published values of MQTT topics.|mqtt.get|To configure encrypted connection to the MQTT broker, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) or [default](#default-values) parameters. Currently, TLS parameters cannot be passed as item key parameters. | |[MySQL](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mysql/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of MySQL and its forks.|mysql.custom.query, mysql.db.discovery, mysql.db.size, mysql.get\_status\_variables,<br>mysql.ping, mysql.replication.discovery, mysql.replication.get\_slave\_status, mysql.version|To configure encrypted connection to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) or [default](#default-values) parameters. Currently, TLS parameters cannot be passed as item key parameters.<br><br>`mysql.custom.query` item key is supported since Zabbix 6.0.21.| |[NetIf](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/netif?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of network interfaces.|net.if.collisions, net.if.discovery, net.if.in, net.if.out, net.if.total|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Oracle](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Oracle Database monitoring.|oracle.diskgroups.stats, oracle.diskgroups.discovery, oracle.archive.info, oracle.archive.discovery,<br>oracle.cdb.info, oracle.custom.query, oracle.datafiles.stats, oracle.db.discovery,<br>oracle.fra.stats, oracle.instance.info, oracle.pdb.info, oracle.pdb.discovery,<br>oracle.pga.stats, oracle.ping, oracle.proc.stats, oracle.redolog.info,<br>oracle.sga.stats, oracle.sessions.stats, oracle.sys.metrics, oracle.sys.params,<br>oracle.ts.stats, oracle.ts.discovery, oracle.user.info, oracle.version|Install the [Oracle Instant Client](https://www.oracle.com/database/technologies/instant-client/downloads.html) before using the plugin.| |[Proc](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/proc?at=refs%2Fheads%2Frelease%2F6.0)|Process CPU utilization percentage.|proc.cpu.util|Supported key has the same parameters as Zabbix agent [key](/manual/config/items/itemtypes/zabbix_agent).| |[Redis](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/redis/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Redis server monitoring.|redis.config, redis.info, redis.ping, redis.slowlog.count| | |[Smart](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/smart?at=refs%2Fheads%2Frelease%2F6.0)|S.M.A.R.T. monitoring.|smart.attribute.discovery, smart.disk.discovery, smart.disk.get|The minimum required smartctl version is 7.1. <br> Sudo/root access rights to smartctl are required for the user executing Zabbix agent 2. The plugin uses only the following commands: <br> ``/usr/sbin/smartctl -a *``<br> ``/usr/sbin/smartctl --scan *`` <br> ``/usr/sbin/smartctl -j -V``<br><br>Supported [keys](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) can be used with Zabbix agent 2 only on Linux/Windows, both as a passive and active check.<br>See also:<br>[Configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/smart_plugin)| |[Swap](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/swap?at=refs%2Fheads%2Frelease%2F6.0)|Swap space size in bytes/percentage.|system.swap.size|Supported key has the same parameters as Zabbix agent [key](/manual/config/items/itemtypes/zabbix_agent).| |SystemRun|Runs specified command.|system.run|Supported key has the same parameters as Zabbix agent [key](/manual/config/items/itemtypes/zabbix_agent).<br><br>See also:<br>Plugin configuration parameters ([Unix](/manual/appendix/config/zabbix_agent2)/[Windows](/manual/appendix/config/zabbix_agent2_win))| |Systemd|Monitoring of systemd services.|systemd.unit.discovery, systemd.unit.get, systemd.unit.info| | |[TCP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/tcp?at=refs%2Fheads%2Frelease%2F6.0)|TCP connection availability check.|net.tcp.port|Supported key has the same parameters as Zabbix agent [key](/manual/config/items/itemtypes/zabbix_agent).| |[UDP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/udp?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of the UDP services availability and performance.|net.udp.service, net.udp.service.perf|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Uname](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/uname?at=refs%2Fheads%2Frelease%2F6.0)|Retrieval of information about the system.|system.hostname, system.sw.arch, system.uname|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[Uptime](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/uptime?at=refs%2Fheads%2Frelease%2F6.0)|System uptime metrics collection.|system.uptime|Supported key has the same parameters as Zabbix agent [key](/manual/config/items/itemtypes/zabbix_agent).| |[VFSDev](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/vfs/dev?at=refs%2Fheads%2Frelease%2F6.0)|VFS metrics collection.|vfs.dev.discovery, vfs.dev.read, vfs.dev.write|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[WebCertificate](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/web/certificate?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of TLS/SSL website certificates.|web.certificate.get| | |[WebPage](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/web/page?at=refs%2Fheads%2Frelease%2F6.0)|Web page monitoring.|web.page.get, web.page.perf, web.page.regexp|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[ZabbixAsync](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/async?at=refs%2Fheads%2Frelease%2F6.0)|Asynchronous metrics collection.|net.tcp.listen, net.udp.listen, sensor, system.boottime, system.cpu.intr, system.cpu.load,<br>system.cpu.switches, system.hw.cpu, system.hw.macaddr, system.localtime, system.sw.os,<br>system.swap.in, system.swap.out, vfs.fs.discovery|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[ZabbixStats](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/stats?at=refs%2Fheads%2Frelease%2F6.0)|Zabbix server/proxy internal metrics or number of delayed items in a queue.|zabbix.stats|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| |[ZabbixSync](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/sync?at=refs%2Fheads%2Frelease%2F6.0)|Synchronous metrics collection.|net.dns, net.dns.record, net.tcp.service, net.tcp.service.perf, proc.mem,<br>proc.num, system.hw.chassis, system.hw.devices, system.sw.packages,<br>system.users.num, vfs.dir.count, vfs.dir.size, vfs.fs.get, vfs.fs.inode,<br>vfs.fs.size, vm.memory.size.|Supported keys have the same parameters as Zabbix agent [keys](/manual/config/items/itemtypes/zabbix_agent).| #### 組み込み Zabbixエージェント2用の以下のプラグインは、すぐにご利用いただけます。プラグイン名をクリックすると、プラグインリポジトリに移動し、詳細情報をご確認いただけます。 |プラグイン名|説明|[サポートされているアイテムキー](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2)|コメント| |--|--|--|----| |Agent|使用されている Zabbix エージェントのメトリック|agent.hostname, agent.ping, agent.version|サポートされているキーのパラメーターは、Zabbix エージェントの [キー](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[Ceph](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/ceph/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Ceph モニタリング|ceph.df.details、ceph.osd.stats、ceph.osd.discovery、ceph.osd.dump、<br>ceph.ping、ceph.pool.discovery、ceph.status| | |[CPU](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/cpu?at=refs%2Fheads%2Frelease%2F6.0)|システム CPU モニタリング (CPU 数/CPU コア、検出された CPU、使用率)|system.cpu.discovery、system.cpu.num、system.cpu.util|サポートされているキーのパラメーターは、Zabbix エージェントの [キー](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[Docker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/docker/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Docker コンテナの監視|docker.container\_info、docker.container\_stats、docker.containers、docker.containers.discovery、<br>docker.data\_usage、docker.images、docker.images.discovery、docker.info、docker.ping|参照:<br>[構成パラメータ](/manual/appendix/config/zabbix_agent2_plugins/d_plugin)| |File|ファイル メトリックのコレクション|vfs.file.cksum、vfs.file.contents、vfs.file.exists、vfs.file.md5sum、<br>vfs.file.regexp、vfs.file.regmatch、vfs.file.size、vfs.file.time|サポートされているキーのパラメーターは、Zabbix エージェントの [キー](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[Kernel](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/kernel?at=refs%2Fheads%2Frelease%2F6.0)|カーネル監視|kernel.maxfiles、kernel.maxproc|サポートされているキーのパラメーターは、Zabbix エージェントの [キー](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[Log](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/log?at=refs%2Fheads%2Frelease%2F6.0)|ログファイルの監視。|log、log.count、logrt、logrt.count|サポートされているキーのパラメーターは、Zabbix エージェントの [キー](/manual/config/items/itemtypes/zabbix_agent) と同じです。<br><br>参照:<br>プラグイン構成パラメーター ([Unix](/manual/appendix/config/zabbix_agent2)/[Windows](/manual/appendix/config/zabbix_agent2_win))| |[Memcached](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/memcached/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Memcached サーバーの監視|memcached.ping、memcached.stats| | |[Modbus](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/modbus/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Modbus データの読み取り|modbus.get|サポートされているキーのパラメーターは、Zabbix エージェントの [keys](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[MQTT](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mqtt/README.md?at=refs%2Fheads%2Frelease%2F6.0)|MQTTトピックの公開値|mqtt.get|MQTTブローカーへの暗号化接続を設定するには、エージェント設定ファイルでTLSパラメータを[named session](#named_sessions)または[default](#default-values)パラメータとして指定します。現在、TLSパラメータをアイテムキーパラメータとして渡すことはできません。| |[MySQL](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mysql/README.md?at=refs%2Fheads%2Frelease%2F6.0)|MySQL とそのフォークを監視|mysql.custom.query、mysql.db.discovery、mysql.db.size、mysql.get\_status\_variables、<br>mysql.ping、mysql.replication.discovery、mysql.replication.get\_slave\_status、mysql.version|データベースへの暗号化された接続を構成するには、エージェント構成ファイルで TLS パラメータを [named session](#named_sessions) または [default](#default-values) パラメータとして指定します。現在、TLS パラメータをアイテム キー パラメータとして渡すことはできません。<br><br>`mysql.custom.query` アイテム キーは、Zabbix 6.0.21 以降でサポートされています。| |[NetIf](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/netif?at=refs%2Fheads%2Frelease%2F6.0)|ネットワーク インターフェースの監視|net.if.collisions、net.if.discovery、net.if.in、net.if.out、net.if.total|サポートされているキーのパラメーターは、Zabbix エージェントの [keys](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[Oracle](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Oracle データベースの監視|oracle.diskgroups.stats、oracle.diskgroups.discovery、oracle.archive.info、oracle.archive.discovery、<br>oracle.cdb.info、oracle.custom.query、oracle.datafiles.stats、oracle.db.discovery、<br>oracle.fra.stats、oracle.instance.info、oracle.pdb.info、oracle.pdb.discovery、<br>oracle.pga.stats、oracle.ping、oracle.proc.stats、 oracle.redolog.info、<br>oracle.sga.stats、oracle.sessions.stats、oracle.sys.metrics、oracle.sys.params、<br>oracle.ts.stats、oracle.ts.discovery、oracle.user.info、oracle.version|プラグインを使用する前に、[Oracle Instant Client](https://www.oracle.com/database/technologies/instant-client/downloads.html) をインストールしてください。| |[Proc](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/proc?at=refs%2Fheads%2Frelease%2F6.0)|プロセスの CPU 使用率|proc.cpu.util|サポートされているキーには、Zabbix エージェントの [key](/manual/config/items/itemtypes/zabbix_agent) と同じパラメーターがあります。| |[Redis](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/redis/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Redis サーバーの監視|redis.config、redis.info、redis.ping、redis.slowlog.count| | |[Smart](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/smart?at=refs%2Fheads%2Frelease%2F6.0)|S.M.A.R.T. モニタリング|smart.attribute.discovery、smart.disk.discovery、smart.disk.get|必要な最小 smartctl バージョンは 7.1 です。 <br> Zabbix エージェント 2 を実行するユーザーには、smartctl への sudo/root アクセス権が必要です。プラグインは次のコマンドのみを使用します: <br> ``/usr/sbin/smartctl -a *``<br> ``/usr/sbin/smartctl --scan *`` <br> ``/usr/sbin/smartctl -j -V``<br><br>サポートされている [キー](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) は、パッシブ チェックとアクティブ チェックの両方として、Linux/Windows 上の Zabbix エージェント 2 でのみ使用できます。<br>参照:<br>[構成パラメータ](/manual/appendix/config/zabbix_agent2_plugins/smart_plugin)| |[Swap](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/swap?at=refs%2Fheads%2Frelease%2F6.0)|スワップ領域のサイズ（バイト/パーセンテージ）|system.swap.size|サポートされているキーには、Zabbix エージェントの [キー](/manual/config/items/itemtypes/zabbix_agent) と同じパラメーターがあります。| |SystemRun|指定されたコマンドを実行します|system.run|サポートされているキーには、Zabbix エージェントの [key](/manual/config/items/itemtypes/zabbix_agent) と同じパラメーターがあります。<br><br>参照:<br>プラグイン構成パラメーター ([Unix](/manual/appendix/config/zabbix_agent2)/[Windows](/manual/appendix/config/zabbix_agent2_win))| |Systemd|systemd サービスの監視|systemd.unit.discovery、systemd.unit.get、systemd.unit.info| | |[TCP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/tcp?at=refs%2Fheads%2Frelease%2F6.0)|TCP 接続の可用性チェック|net.tcp.port|サポートされているキーは、Zabbix エージェントの [キー](/manual/config/items/itemtypes/zabbix_agent) と同じパラメーターを持ちます。| |[UDP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/udp?at=refs%2Fheads%2Frelease%2F6.0)|UDP サービスの可用性とパフォーマンスの監視|net.udp.service、net.udp.service.perf|サポートされているキーのパラメーターは、Zabbix エージェントの [キー](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[Uname](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/uname?at=refs%2Fheads%2Frelease%2F6.0)|システムに関する情報の取得|system.hostname、system.sw.arch、system.uname|サポートされているキーのパラメーターは、Zabbix エージェントの [keys](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[Uptime](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/uptime?at=refs%2Fheads%2Frelease%2F6.0)|システム稼働時間メトリックの収集。system.uptime|サポートされているキーのパラメーターは、Zabbix エージェントの [キー](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[VFSDev](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/vfs/dev?at=refs%2Fheads%2Frelease%2F6.0)|VFS メトリック コレクション|vfs.dev.discovery、vfs.dev.read、vfs.dev.write|サポートされているキーのパラメーターは、Zabbix エージェントの [キー](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[WebCertificate](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/web/certificate?at=refs%2Fheads%2Frelease%2F6.0)|TLS/SSL ウェブサイト証明書の監視|web.certificate.get| | |[WebPage](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/web/page?at=refs%2Fheads%2Frelease%2F6.0)|Webページの監視|web.page.get、web.page.perf、web.page.regexp|サポートされているキーのパラメーターは、Zabbixエージェントの[キー](/manual/config/items/itemtypes/zabbix_agent)と同じです。| |[ZabbixAsync](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/async?at=refs%2Fheads%2Frelease%2F6.0)|非同期メトリック収集|net.tcp.listen、net.udp.listen、sensor、system.boottime、system.cpu.intr、system.cpu.load、<br>system.cpu.switches、system.hw.cpu、system.hw.macaddr、system.localtime、system.sw.os、<br>system.swap.in、system.swap.out、vfs.fs.discovery|サポートされているキーのパラメーターは、Zabbix エージェントの [キー](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[ZabbixStats](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/stats?at=refs%2Fheads%2Frelease%2F6.0)|Zabbix サーバー/プロキシの内部メトリックまたはキュー内の遅延アイテムの数|zabbix.stats|サポートされているキーのパラメーターは、Zabbix エージェントの [keys](/manual/config/items/itemtypes/zabbix_agent) と同じです。| |[ZabbixSync](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/sync?at=refs%2Fheads%2Frelease%2F6.0)|同期メトリック収集|net.dns、net.dns.record、net.tcp.service、net.tcp.service.perf、proc.mem、<br>proc.num、system.hw.chassis、system.hw.devices、system.sw.packages、<br>system.users.num、vfs.dir.count、vfs.dir.size、vfs.fs.get、vfs.fs.inode、<br>vfs.fs.size、vm.memory.size。||サポートされているキーのパラメーターは、Zabbix エージェントの [keys](/manual/config/items/itemtypes/zabbix_agent) と同じです。| ##### 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. ##### バルクプロセッシング 依存 item はバルクプロセッシングに対応しています。<br> キャッシュとインデックスを有効にするには、*Prometheus pattern* のプリプロセスを **最初の** プリプロセスステップにする必要があります。<br> *Prometheus pattern* が最初のプリプロセスステップである場合、パースされた Prometheus データは、<br> *Prometheus pattern* プリプロセスステップの最初の `<label>==<value>` 条件によってキャッシュされ、インデックスが作成されます。 <br> このキャッシュは、このバッチ内の他の依存 item を処理する際に再利用されます。<br> 最適なパフォーマンスを得るために、最初のラベルは最も異なる値を持つものにすべきです。<br> 最初のステップの前に他のプリプロセスがある場合は、マスター item か、従属 item のマスター item として使用される<br> 新しい従属 item のどちらかに移動させる必要があります。 ##### 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. ##### Prometheus メトリクスの一括処理 Prometheusメトリクスの前処理キューに、依存項目の一括処理が導入されたため、依存項目が並列処理されなくなり <br> 処理速度に影響が出る可能性があります。 ##### Buttons | | | |---|---| ||Clone the service.<br>When a service is cloned, its parent links are preserved, while the child links are not.| ##### ボタン | | | |---|---| ||サービスを複製します。<br>サービスを複製すると、その親リンクは保持されますが、子リンクは保持されません。| ##### Buttons Buttons to the right offer the following options: | | | |---|---| ||Go to map constructor to edit the map content.| ||Add map to the favorites widget in the [Dashboard](dashboard).| ||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. ##### ボタン 右側のボタンには、次のオプションがあります。 | | | |---|---| ||マップコンストラクターに移動して、マップコンテンツを編集します| ||[ダッシュボード](dashboard)のお気に入りウィジェットにマップを追加します| ||マップは[ダッシュボード](dashboard)のお気に入りウィジェットに登録済みです。 クリックでお気に入りウィジェットからマップを削除します。| すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。 ##### 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. ##### ボタン *ホストの作成*では、[新しいホスト](/manual/config/hosts/host)を作成できます。 このボタンは、管理者およびスーパー管理者ユーザーのみが使用できます。 すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。 ##### Buttons The button to the right offers the following option: | | | |---|---| ||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. ##### ボタン 右側のボタンには、次のオプションがあります。 | | | |---|---| ||すべてのページコンテンツをCSVファイルにエクスポートします。| すべてのセクション共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。 ##### Buttons View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page. ##### ボタン すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。 ##### Buttons View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page. ##### ボタン すべてのセクションで共通のビュー モード ボタンは、[モニタリング](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) ページに記載されています。 ##### Buttons View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page. ##### ボタン すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#ビューモードボタン)ページで説明されています。 ##### Buttons View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page. ##### ボタン すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。 ##### Buttons View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page. ##### ボタン すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。 ##### Buttons View mode buttons, being common for all sections, are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page. ##### ボタン すべてのセクションに共通の表示モードボタンについては[監視データ](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons)ページで説明されています。 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) デフォルトでは、ウィジェットはホスト設定で定義された有効な地理座標を持つすべての有効なホストを表示します。 ウィジェットパラメータでホストフィルタリングを設定することができます。 有効なホスト座標は次のとおりです。 - 緯度：-90〜90（整数または浮動小数点数） - 経度：-180から180まで（整数または浮動小数点数） #### 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. #### 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のような接続プーリングサーバーを実行している場合など、環境で準備されたステートメントが許可されていない場合に便利です。 #### Calculated items Calculated items now support not only numeric, but also **text**, **log**, and **character** types of information. #### 計算アイテムのデータ型 計算アイテムは、数値だけでなく、**テキスト**、**ログ**、**文字型**の情報にも対応しました。 #### 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). #### 計算時間 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)も参照してください。 #### 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. #### 変更回数 新しい[ヒストリ関数](/manual/appendix/functions/history)として隣接する値間の変更回数を数えることができる**changecount()**が追加されました。 この関数は、すべての変更をカウントする、減少のみ、増加のみをカウントする3つの異なるモードをサポートしています。 例えば、ユーザー数の変化や、システム稼働時間の減少を追跡するために使用することができます。 #### Change dashboard owner Available only for admins and super admins. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "userid": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 2 } ``` #### ダッシュボードの所有者の変更 Adminとsuper adminのみが使用できます。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "userid": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 2 } ``` #### 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 } ``` #### プロキシが監視するホストの変更 指定された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 } ``` ##### Change indicator The following parameters are supported if *Advanced configuration* is set to "Enabled", and *Show* is set to "Change indicator". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Change indicator ↑ color*|1|up_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Change indicator ↓ color*|1|down_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Change indicator ↕ color*|1|updown_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| ##### Change indicator *詳細設定*が"有効"に設定され、*表示*が"変更インジケーター"に設定されている場合に、以下のパラメーターがサポートされます。 |パラメーター|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*変更インジケーター↑の色*|1|up_color|16進数カラーコード（例：`FF0000`）<br><br>デフォルト：`""`（空）| |*変更インジケーター↓の色*|1|down_color|16進数カラーコード（例：`FF0000`）<br><br>デフォルト：`""`（空）| |*インジケーターの色変更*|1|updown_color|16進数カラーコード（例：`FF0000`）<br><br>デフォルト：`""`（空）| #### 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 } ``` #### マップの所有者変更 管理者とスーパー管理者のみが利用できます。 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 } ``` #### 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 } ``` #### プロキシステータスの変更 プロキシをアクティブプロキシに変更し、名前を"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 } ``` #### 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 } ``` #### スクリプトコマンドの変更 スクリプトのコマンドを"/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 } ``` #### CHANGES IN 6.0.0 #### 6.0.0での変更点 #### CHANGES IN 6.0.13 New templates are available: - AWS EC2 by HTTP - AWS by HTTP - AWS RDS instance by HTTP - AWS S3 bucket by HTTP - Azure by HTTP - Control-M server by HTTP - Control-M enterprise manager by HTTP - Veeam Backup Enterprise Manager by HTTP - Veeam Backup and Replication by HTTP See setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http). #### 6.0.13での変更点 新しいテンプレートが利用可能になりました。 - AWS EC2 by HTTP - AWS by HTTP - AWS RDS instance by HTTP - AWS S3 bucket by HTTP - Azure by HTTP - Control-M server by HTTP - Control-M enterprise manager by HTTP - Veeam Backup Enterprise Manager by HTTP - Veeam Backup and Replication by HTTP [HTTPテンプレート](/manual/config/templates_out_of_the_box/http)のセットアップ手順を参照してください。 #### CHANGES IN 6.0.18 #### 6.0.18での変更点 #### CHANGES IN 6.0.20 New templates are available: - [AWS ECS Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_ecs_http?at=refs%2Fheads%2Frelease%2F6.0) (along with its [Serverless Cluster version](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_ecs_serverless_http?at=refs%2Fheads%2Frelease%2F6.0)) - [Cisco SD-WAN by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/cisco/cisco_sdwan_http?at=refs%2Fheads%2Frelease%2F6.0) - [OpenStack by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/openstack?at=refs%2Fheads%2Frelease%2F6.0), which includes *OpenStack Nova by HTTP* template for monitoring OpenStack Nova service - [PostgreSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc?at=refs%2Fheads%2Frelease%2F6.0) #### 6.0.20での変更点 新しいテンプレートが利用可能になりました。 - [AWS ECS Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_ecs_http?at=refs%2Fheads%2Frelease%2F6.0) ([Serverless Cluster version](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_ecs_serverless_http?at=refs%2Fheads%2Frelease%2F6.0)とともに) - [Cisco SD-WAN by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/cisco/cisco_sdwan_http?at=refs%2Fheads%2Frelease%2F6.0) - [OpenStack by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/openstack?at=refs%2Fheads%2Frelease%2F6.0), OpenStack Novaサービスを監視するための*OpenStack Nova by HTTP*テンプレートが含まれています。 - [PostgreSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc?at=refs%2Fheads%2Frelease%2F6.0) #### CHANGES IN 6.0.21 New template is available: - [AWS Cost Explorer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_cost_http?at=release%2F6.0) #### 6.0.21での変更点 新しいテンプレートが利用可能になりました。 - [AWS Cost Explorer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_cost_http?at=release%2F6.0) #### CHANGES IN 6.0.22 New templates are available: - [Acronis Cyber Protect Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/acronis?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Nomad by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nomad?at=refs%2Fheads%2Frelease%2F6.0) - [MantisBT by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/mantisbt?at=refs%2Fheads%2Frelease%2F6.0) #### 6.0.22での変更点 新しいテンプレートが利用可能になりました。 - [Acronis Cyber Protect Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/acronis?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Nomad by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nomad?at=refs%2Fheads%2Frelease%2F6.0) - [MantisBT by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/mantisbt?at=refs%2Fheads%2Frelease%2F6.0) #### CHANGES IN 6.0.23 **New templates** New templates are available: - [FortiGate by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http?at=refs%2Fheads%2Frelease%2F6.0) - [FortiGate by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [Nextcloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud?at=refs%2Fheads%2Frelease%2F6.0) #### 6.0.23での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました。 - [FortiGate by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http?at=refs%2Fheads%2Frelease%2F6.0) - [FortiGate by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [Nextcloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud?at=refs%2Fheads%2Frelease%2F6.0) #### CHANGES IN 6.0.24 **New templates** New template is available: - [HPE iLO by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http?at=refs%2Fheads%2Frelease%2F6.0) **Updated templates** Integration with OpenShift has been added to [Kubernetes cluster state by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_state_http?at=refs%2Fheads%2Frelease%2F6.0) template. #### 6.0.24での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました。 - [HPE iLO by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http?at=refs%2Fheads%2Frelease%2F6.0) **テンプレートの更新** [Kubernetes cluster state by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_state_http?at=refs%2Fheads%2Frelease%2F6.0)テンプレートにOpenShift との統合が追加されました。 #### CHANGES IN 6.0.26 **New templates** The set of [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) templates has been supplemented with the Azure Cost Management by HTTP template. **Updated templates** [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0) template has been updated for working with AlwaysOn features such as Failover Cluster Instances (FCI) and Availability Groups (AG). It is now possible to use the template for monitoring a host in cluster, standalone host and host by cluster name. A macro for instance name is no longer used; when the master is switched, it is not required to change any macros: - new LLD rules and metrics for quorum and quorum members have been added; - the type of the LLD rules has been changed from “Database monitor” to “Dependent item”; - items with `db.odbc.discovery` key have been turned into items dependent on the `db.odbc.get` item - new item has been added - MSSQL DB '{#DBNAME}': Recovery model, which returns the database recovery model under the database discovery; - new macros, namely, {$MSSQL.BACKUP_FULL.USED}, {$MSSQL.BACKUP_DIFF.USED}, {$MSSQL.BACKUP_LOG.USED}, have been added - those can be used for disabling backup age triggers for a certain database. #### 6.0.26での変更点 **新しいテンプレート** [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0)テンプレートのセットは、Azure Cost Management by HTTPテンプレートが補完されています。 **更新されたテンプレート** [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0)テンプレートは、フェイルオーバークラスターインスタンス(FCI)や可用性グループ(AG)などのAlwaysOn機能を使用するために更新されています。クラスター名でクラスターのホストやスタンドアロンホスト、ホストを監視することができます。インスタンス名のマクロは使用されなくなりました。マスターが切り替えられた場合、マクロを変更する必要はありません。 - 定足数と定足数のメンバーの新しいLLDルールとメトリクスが追加されました。 - LLDルールのタイプは、"データベースモニタ"から"依存アイテム"に変更されました。 - `db.odbc.discovery`キーを備えたアイテムは、`db.odbc.get`アイテムに依存するアイテムに変わりました - 新しいアイテムが追加されました - MSSQL DB '{#DBNAME}': Recovery model。このアイテムはデータベースディスカバリの下でデータベース回復モデルを返します。 - 新しいマクロが追加されました - {$MSSQL.BACKUP_FULL.USED}, {$MSSQL.BACKUP_DIFF.USED}, {$MSSQL.BACKUP_LOG.USED}。これらは、特定のデータベースのバックアップ年数トリガーを無効にするために使用できます。 #### CHANGES IN 6.0.27 **New templates** A new template is available: - [YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http?at=refs%2Fheads%2Frelease%2F6.0), which includes the *YugabyteDB Cluster by HTTP* template for monitoring each YugabyteDB cluster. #### 6.0.27での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました: - [YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http?at=refs%2Fheads%2Frelease%2F6.0), 各YugabyteDBクラスターを監視する*YugabyteDB Cluster by HTTP*テンプレートを含みます。 #### CHANGES IN 6.0.28 **New templates** New templates are available: - [AWS ELB Application Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0) - [Check Point Next Generation Firewall by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/checkpoint/quantum_ngfw_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) #### 6.0.28での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました: - [AWS ELB Application Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0) - [Check Point Next Generation Firewall by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/checkpoint/quantum_ngfw_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) #### CHANGES IN 6.0.29 **New templates** A new template is available: - [Oracle Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud?at=refs%2Fheads%2Frelease%2F6.0), a master template that discovers various Oracle Cloud Infrastructure (OCI) services and resources. **Updated templates** - [FortiGate by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) template has been supplemented with metrics regarding VPN, high availability (HA), wireless termination points (WTPs), SD-WAN health checks, and HW sensors. - [MySQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) template has been supplemented with the items "MySQL: Get database" and "MySQL: Get replication". The LLD rules "Database discovery" and "Replication discovery" have been changed to the "Dependent item" type. - [Oracle by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) template has been supplemented with the items "Oracle: Get archive log", "Oracle: Get ASM disk groups", "Oracle: Get database", "Oracle: Get PDB", and "Oracle: Get tablespace". The LLD rules "Archive log discovery", "ASM disk groups discovery", "Database discovery", "PDB discovery", and "Tablespace discovery" have been changed to the "Dependent item" type. - The VMware Hypervisor template within the [VMware](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware?at=refs%2Fheads%2Frelease%2F6.0) and [VMware FQDN](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware_fqdn?at=release%2F6.0) template sets has been supplemented with a new LLD rule, "Sensor discovery". #### 6.0.29での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました: - [Oracle Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud?at=refs%2Fheads%2Frelease%2F6.0), さまざまなOracle Cloud Infrastructure (OCI)サービスとリソースを発見するマスターテンプレート。 **更新されたテンプレート** - [FortiGate by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) テンプレートには、VPN、高可用性(HA)、ワイヤレス終端ポイント(WTP)、SD-WANヘルスチェック、およびHWセンサーに関するメトリックが補完されています。 - [MySQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) テンプレートには、"MySQL: Get database"と"MySQL: Get replication"というアイテムが補完されています。LLDルール"Database discovery"と"Replication discovery"は、"Dependent item"タイプに変更されました。 - [Oracle by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) テンプレートにはアイテム"Oracle: Get archive log", "Oracle: Get ASM disk groups", "Oracle: Get database", "Oracle: Get PDB", and "Oracle: Get tablespace"が補完されています。LLDルール"Archive log discovery", "ASM disk groups discovery", "Database discovery", "PDB discovery", "Tablespace discovery"は"Dependent item"タイプに変更されました。 - [VMware](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware?at=refs%2Fheads%2Frelease%2F6.0)内部のVMwareハイパーバイザーテンプレートと[VMware FQDN](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware_fqdn?at=release%2F6.0) テンプレートセットには、新しいLLDルール"Sensor discovery"が追加されています。 #### CHANGES IN 6.0.2 The template *Generic Java JMX* now contains two discovery rules: - Garbage collector discovery - Memory pool discovery #### 6.0.2での変更点 テンプレート*Generic Java JMX*に2つのディスカバリルールが追加されました。 - Garbage collector discovery - Memory pool discovery #### CHANGES IN 6.0.30 **New templates** The AWS ELB template set has been supplemented with the template [AWS ELB Network Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0). **Updated templates** The [OS templates](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/os?at=refs%2Fheads%2Frelease%2F6.0) (agent, SNMP, and Prometheus-based) have been given a mounted filesystem update. In mounted filesystem discovery, the "Space is low" and "Space is critically low" triggers no longer have the absolute threshold and burst condition. #### 6.0.30での変更点 **新しいテンプレート** AWS ELBテンプレートセットにはテンプレート[AWS ELB Network Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0)が補完されています。 **更新されたテンプレート** [OSテンプレート](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/os?at=refs%2Fheads%2Frelease%2F6.0)(エージェント、SNMP、プロメテウスベース)には、マウントされたファイルシステムの更新が与えられています。マウントされたファイルシステムのディスカバリでは、"Space is low"、"Space is critically low"トリガーは絶対的なしきい値とバースト状態を持たなくなりました。 #### CHANGES IN 6.0.31 **New templates** A new template is available: - [Jira Data Center by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring Jira Data Center health. #### 6.0.31での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました: - [Jira Data Center by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx?at=refs%2Fheads%2Frelease%2F6.0), JIRAデータセンターの健全性を監視するためのテンプレート。 #### CHANGES IN 6.0.32 **New templates** A new template is available: The set of [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) templates has been supplemented with the Azure VM Scale Set by HTTP template. **Updated templates** The templates [Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0), [Remote Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server_remote?at=refs%2Fheads%2Frelease%2F6.0), [Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0), and [Remote Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy_remote?at=refs%2Fheads%2Frelease%2F6.0) have been updated for improved data visualization in item graphs by regrouping the displayed metrics. #### 6.0.32での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました: [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0)テンプレートセットは、Azure VM Scale Set by HTTPテンプレートが補完されています。 **更新されたテンプレート** テンプレート[Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0)、[Remote Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server_remote?at=refs%2Fheads%2Frelease%2F6.0)、[Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0)、および[Remote Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy_remote?at=refs%2Fheads%2Frelease%2F6.0)が更新されました。表示されるメトリックを再編成することでアイテムグラフのデータ視覚化が改善されました。 #### CHANGES IN 6.0.33 **New templates** A new template is available: - [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_function_lambda_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring AWS Lambda metrics. #### 6.0.33での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました: - [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_function_lambda_http?at=refs%2Fheads%2Frelease%2F6.0), AWS Lambdaメトリクスを監視するためのテンプレート。 #### CHANGES IN 6.0.34 **New templates** New templates are available: - [GitHub repository by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring GitHub repositories. - [Microsoft 365 reports by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring Microsoft 365 services. #### 6.0.34での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました: - [GitHub repository by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http?at=refs%2Fheads%2Frelease%2F6.0), GitHubリポジトリを監視するためのテンプレート。 - [Microsoft 365 reports by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http?at=refs%2Fheads%2Frelease%2F6.0), Microsoft 365サービスを監視するためのテンプレート。 #### CHANGES IN 6.0.35 **New templates** A new template is available: - [Huawei OceanStor V6 by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/huawei_oceanstor_v6_snmp/README.md?at=release%2F6.0), a template for monitoring SAN Huawei OceanStor V6. **Updated templates** - In all [APC templates](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/power/apc?at=refs%2Fheads%2Frelease%2F6.0), the discovery rule for external defective battery packs has been supplemented with a filter to avoid creating unsupported items. - In the templates [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) and [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0), a timeout has been added and certain item keys have been adjusted to increase monitoring stability. #### 6.0.35での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました: - [Huawei OceanStor V6 by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/huawei_oceanstor_v6_snmp/README.md?at=release%2F6.0), San Huawei OceanStor V6を監視するためのテンプレート。 **更新されたテンプレート** - すべての[APCテンプレート](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/power/apc?at=refs%2Fheads%2Frelease%2F6.0)で、外部の欠陥のあるバッテリーパックのディスカバリルールには、サポートされていないアイテムの作成を避けるために、フィルターが補完されました。 - [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0)と[MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0)テンプレートで、タイムアウトが追加され、特定のアイテムキーが監視の安定性を高めるように調整されました。 #### CHANGES IN 6.0.36 **New templates** A new template is available: - [Nutanix Prism Element by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http/README.md?at=release%2F6.0), a template set that also includes the templates *Nutanix Cluster Prism Element by HTTP* and *Nutanix Host Prism Element by HTTP*. **Updated templates** - The template *VMware Hypervisor* within the [VMware](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware/README.md?at=release%2F6.0) and [VMware FQDN](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware_fqdn/README.md?at=release%2F6.0) template sets has been updated with the option to be used as a standalone template. - [Proxmox VE by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/proxmox/README.md?at=refs%2Fheads%2Frelease%2F6.0) has been updated with new items and trigger prototypes for disk space usage in LXC containers. - In the template [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0), the performance counter query has been updated to improve data retrieval. Both *MSSQL by ODBC* and [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) template documentation has been reviewed and updated. #### 6.0.36での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました: - [Nutanix Prism Element by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http/README.md?at=release%2F6.0), テンプレート*Nutanix Cluster Prism Element by HTTP*を*Nutanix Host Prism Element by HTTP*を含むテンプレートセットです。 **更新されたテンプレート** - [VMware](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware/README.md?at=release%2F6.0)と[VMware FQDN](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware_fqdn/README.md?at=release%2F6.0)テンプレートセット内の*VMware Hypervisor*テンプレートはスタンドアロンテンプレートとして使用されるオプションで更新されました。 - [Proxmox VE by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/proxmox/README.md?at=refs%2Fheads%2Frelease%2F6.0)はLXCコンテナのディスクスペース使用のための新しいアイテムとトリガープロトタイプで更新されました。 - [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0)テンプレートで、データの取得を改善するために、パフォーマンスカウンタークエリが更新されました。*MSSQL by ODBC*と[MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0)について、テンプレートのドキュメントがレビューおよび更新されました。 #### CHANGES IN 6.0.39 **New templates** A new template is available: - The [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) template set has been supplemented with the template *Azure SQL Managed Instance by HTTP*. **Updated templates** - All [Dell HTTP and SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell?at=refs%2Fheads%2Frelease%2F6.0) templates have been updated with improvements, including fixes for items, macros, and scripts. - The templates [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0) and [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) have been updated with filters to include or exclude discovered quorum members by name as well as a service filter that allows filtering by cluster name to exclude empty clusters. Please see [Breaking changes](/manual/installation/upgrade_notes_6039#mssql-zabbix-agent-2-plugin-update) for additional information on *MSSQL by Zabbix agent 2*. #### 6.0.39での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました: - [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0)テンプレートセットは、*Azure SQL Managed Instance by HTTP*テンプレートが補完されています。 **更新されたテンプレート** - すべての[Dell HTTP、SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell?at=refs%2Fheads%2Frelease%2F6.0)テンプレートは、アイテム、マクロ、スクリプトの修正などの更新がされ改善しました。 - テンプレート[MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0)と[MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0)は更新され、検出されたクォーラムメンバーを名前で含めたり除外したりするフィルターと、クラスター名でフィルターして空のクラスターを除外できるサービスフィルターが追加されました。*MSSQL by Zabbix agent 2*の更なる情報については[重大な変更](/manual/installation/upgrade_notes_6039#mssql-zabbix-agent-2-plugin-update)を参照してください。 #### CHANGES IN 6.0.3 A new template *OpenWeatherMap by HTTP* is available. The following changes have been made in the existing templates: - In the templates *Windows services by Zabbix agent*, *Windows services by Zabbix agent active*, *Windows by Zabbix agent*, *Windows by Zabbix agent active* {$SERVICE.NAME.NOT_MATCHES} macro value has been updated to filter out an extended list of services. - The template *PostgreSQL by Zabbix agent 2* now will check the number of slow queries and generate a problem if the amount exceeds a threshold. #### 6.0.3での変更点 新しいテンプレート*OpenWeatherMap by HTTP*が利用可能になりました。 既存のテンプレートには次の変更が行われました。 - テンプレート*Windows services by Zabbix agent*、*Windows services by Zabbix agent active*、*Windows by Zabbix agent*、および*Windows by Zabbix agent active*の{$SERVICE.NAME.NOT_MATCHES}マクロ値が更新され、サービスの拡張リストを除外するようになりました。 - テンプレート*PostgreSQL by Zabbix agent 2*は、スロークエリの数をチェックし、その量が閾値を超えた場合に障害を生成するようになりました。 #### CHANGES IN 6.0.40 **New templates** A new template is available: - The template set [Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0) has been supplemented with the templates *Zabbix server health by Zabbix agent*, *Zabbix server health by Zabbix agent active*, and [Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0) - with *Zabbix proxy health by Zabbix agent* and *Zabbix proxy health by Zabbix agent active*, enabling the monitoring of internal Zabbix metrics via Zabbix agent. #### 6.0.40 での変更点 **新しいテンプレート** 新しいテンプレートが利用可能になりました: - テンプレートセット[Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0)に、*Zabbix server health by Zabbix agent*、*Zabbix server health by Zabbix agent active*、および[Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0)のテンプレートが追加されました - *Zabbix proxy health by Zabbix agent*および*Zabbix proxy health by Zabbix agent active*により、Zabbixエージェント経由の内部Zabbixメトリックの監視が有効になります。 #### CHANGES IN 6.0.4 New templates are available: - *TrueNAS SNMP* - monitoring of TrueNAS storage OS by SNMP - *Proxmox VE by HTTP* - see setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http) The templates *SMART by Zabbix agent 2* and *SMART by Zabbix agent 2 (active)* have been updated: - the *Attribute discovery* LLD rule has been deleted, whereas the *Disk discovery* LLD rule will now discover disks based on the pre-defined vendor-specific set of attributes; - **smart.disk.get** item can now return information about a specific disk only, instead of all disks. New macros allowing to define warning and critical thresholds of the filesystem utilization for virtual file system monitoring have been added to the templates *HOST-RESOURCES-MIB storage SNMP*, *Linux by Prom*, *Linux filesystems SNMP*, *Linux filesystems by Zabbix agent active*, *Linux filesystems by Zabbix agent*, *Mellanox SNMP*, *PFSense SNMP*, *Windows filesystems by Zabbix agent active*, *Windows filesystems by Zabbix agent*. Filesystem utilization triggers have been updated to use these macros. #### 6.0.4での変更点 新しいテンプレートが利用可能になりました。 - *TrueNAS SNMP* - SNMPによるTrueNASストレージOSの監視 - *Proxmox VE by HTTP* - [HTTPテンプレート](/manual/config/templates_out_of_the_box/http)のセットアップ手順を参照してください。 テンプレート*SMART by Zabbix agent 2*、*SMART by Zabbix agent 2 (active)*が更新されました。 - *属性検出*LLDルールは削除されましたが、*ディスク検出*LLD ルールは、事前定義されたベンダー固有の属性セットに基づいてディスクを検出するようになりました。 - **smart.disk.get**アイテムは、すべてのディスクではなく、特定のディスクのみに関する情報を返すことができるようになりました。 仮想ファイルシステム監視のためのファイルシステム使用率の警告およびクリティカルの閾値を定義できる新しいマクロが次のテンプレートに追加されました。 *HOST-RESOURCES-MIB storage SNMP*, *Linux by Prom*, *Linux filesystems SNMP*, *Linux filesystems by Zabbix agent active*, *Linux filesystems by Zabbix agent*, *Mellanox SNMP*, *PFSense SNMP*, *Windows filesystems by Zabbix agent active*, *Windows filesystems by Zabbix agent*。 ファイルシステム使用率トリガーは、これらのマクロを使用するように更新されました。 #### CHANGES IN 6.0.5 New templates are available: - CockroachDB by HTTP - Envoy Proxy by HTTP - HashiCorp Consul Cluster by HTTP - HashiCorp Consul Node by HTTP See setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http). #### 6.0.5での変更点 新しいテンプレートが利用可能になりました。 - CockroachDB by HTTP - Envoy Proxy by HTTP - HashiCorp Consul Cluster by HTTP - HashiCorp Consul Node by HTTP [HTTPテンプレート](/manual/config/templates_out_of_the_box/http)のセットアップ手順を参照してください。 #### CHANGES IN 6.0.6 New templates are available: - HPE MSA 2040 Storage by HTTP - HPE MSA 2060 Storage by HTTP - HPE Primera by HTTP See setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http). #### 6.0.6での変更点 新しいテンプレートが利用可能になりました。 - HPE MSA 2040 Storage by HTTP - HPE MSA 2060 Storage by HTTP - HPE Primera by HTTP [HTTPテンプレート](/manual/config/templates_out_of_the_box/http)のセットアップ手順を参照してください。 #### CHANGES IN 6.0.7 A new [template](/manual/config/templates_out_of_the_box/http) *HPE Synergy by HTTP* is available. The templates *HashiCorp Consul Node by HTTP* and *HashiCorp Consul Cluster by HTTP* now support Consul namespaces. #### 6.0.7での変更点 新しい[テンプレート](/manual/config/templates_out_of_the_box/http)*HPE Synergy by HTTP*が利用可能になりました。 テンプレート*HashiCorp Consul Node by HTTP*、*HashiCorp Consul Cluster by HTTP*は、Consul名前空間をサポートするようになりました。 #### CHANGES IN 6.0.8 A new [template](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/opnsense_snmp?at=refs%2Fheads%2Frelease%2F6.0) *OPNsense by SNMP* is available. #### 6.0.8での変更点 新しい[テンプレート](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/opnsense_snmp?at=refs%2Fheads%2Frelease%2F6.0)*OPNsense by SNMP*が利用可能になりました。 ##### Changes in templates - The {\#FSLABEL} macro has been added to the corresponding item names and descriptions in *Windows by Zabbix agent* and *Windows by Zabbix agent active* templates - The vfs.file.cksum\[/etc/passwd\] agent item has been changed to vfs.file.cksum\[/etc/passwd,sha256\] - A new check zabbix\[process,odbc poller,avg,busy\] has been added to *Zabbix server*, *Zabbix proxy*, *Remote Zabbix server* and *Remote Zabbix proxy* templates. The metric is used for monitoring the average time for which ODBC processes have been busy during the last minute (in percentage). ##### テンプレートの更新 - *Windows by Zabbix agent*と*Windows by Zabbix agent active*の対応するアイテム名および説明に{\#FSLABEL}マクロが追加されました。 - vfs.file.cksum\[/etc/passwd\]エージェントアイテムはvfs.file.cksum\[/etc/passwd,sha256\]に変更されました。 - *Zabbix server*、*Zabbix proxy*、*Remote Zabbix server*、*Remote Zabbix proxy*テンプレートに新しいチェックzabbix\[process,odbc poller,avg,busy\]が追加されました。この指標は、直近1分間でODBCプロセスがビジー状態であった平均時間(パーセント単位)を監視するために使用されます。 #### Change the IP range of a discovery rule Change the IP range of a discovery rule to "192.168.2.1-255". Request: ```json { "jsonrpc": "2.0", "method": "drule.update", "params": { "druleid": "6", "iprange": "192.168.2.1-255" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### ディスカバリルールのIPアドレス範囲の変更 ディスカバリルールのIPアドレス範囲を"192.168.2.1-255"に変更します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "drule.update", "params": { "druleid": "6", "iprange": "192.168.2.1-255" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Changing a host interface port Change the port of a host interface. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.update", "params": { "interfaceid": "30048", "port": "30050" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30048" ] }, "id": 1 } ``` #### ホストインターフェースポートの変更 ホストインターフェースのポートを変更します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "hostinterface.update", "params": { "interfaceid": "30048", "port": "30050" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30048" ] }, "id": 1 } ``` ##### Changing dependency for inherited triggers disabled The possibility to change dependencies for triggers inherited from a template is now disabled. The reason is that upon updating the dependencies of a template trigger, the dependencies of inherited triggers are overwritten. Thus it is more reliable always to set trigger dependencies only on the root template level. ##### 継承されたトリガーの依存関係を変更することはできません テンプレートから継承されたトリガーの依存関係を変更することはできなくなりました。 <br> これは、テンプレートトリガーの依存関係を更新すると、継承されたトリガーの依存関係も上書きされるためです。 <br> したがって、トリガーの依存関係は常にルートテンプレートレベルでのみ設定する方がより確実です。 <br> #### Changing event's severity Change severity for multiple events and leave a message. Request: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": ["20427", "20428"], "action": 12, "message": "Maintenance required to fix it.", "severity": 4 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427", "20428" ] }, "id": 1 } ``` #### イベントの深刻度の変更 複数のイベントの深刻度を変更し、メッセージを残します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": ["20427", "20428"], "action": 12, "message": "Maintenance required to fix it.", "severity": 4 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427", "20428" ] }, "id": 1 } ``` #### Changing mappings for one value map. Request: ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "mappings": [ { "type": "0", "value": "0", "newvalue": "Online" }, { "type": "0", "value": "1", "newvalue": "Offline" } ] }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### 1つのバリューマップのマッピングを変更します。 Request: ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "mappings": [ { "type": "0", "value": "0", "newvalue": "Online" }, { "type": "0", "value": "1", "newvalue": "Offline" } ] }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### Changing proxy setting The hosts discovered by different proxies are always treated as different hosts. While this allows to perform discovery on matching IP ranges used by different subnets, changing proxy for an already monitored subnet is complicated because the proxy changes must be also applied to all discovered hosts. For example the steps to replace proxy in a discovery rule: 1. disable discovery rule 2. sync proxy configuration 3. replace the proxy in the discovery rule 4. replace the proxy for all hosts discovered by this rule 5. enable discovery rule #### プロキシ設定の変更 異なるプロキシによって検出されたホストは、常に異なるホストとして扱われます。これにより、異なるサブネットで使用される同一IP範囲を検出できますが、プロキシの変更は検出されたすべてのホストにも適用する必要があるため、すでに監視されているサブネットのプロキシの変更は複雑です。 たとえば、検出ルールでプロキシを置き換える手順は次のとおりです。 1. 検出ルールを無効にする 2. プロキシ設定を同期する 3. 検出ルールのプロキシを置き換える 4. このルールによって検出されたすべてのホストのプロキシを置き換える 5. 検出ルールを有効にする #### Changing the excluded downtimes for an SLA Add a planned 4 hour long RAM upgrade downtime on the 6th of April, 2022, while keeping (needs to be defined anew) a previously existing software upgrade planned on the 4th of July for the SLA with ID "5". Request: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "slaid": "5", "excluded_downtimes": [ { "name": "Software version upgrade rollout", "period_from": "1648760400", "period_to": "1648764900" }, { "name": "RAM upgrade", "period_from": "1649192400", "period_to": "1649206800" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` #### SLAの除外されたダウンタイムの変更 ID"5"のSLAに対して7月4日に計画された既存のソフトウェアアップグレードを維持しながら、2022年4月6日に計画された4時間のRAMアップグレードダウンタイムを追加します（新たに定義する必要があります）。 Request: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "slaid": "5", "excluded_downtimes": [ { "name": "Software version upgrade rollout", "period_from": "1648760400", "period_to": "1648764900" }, { "name": "RAM upgrade", "period_from": "1649192400", "period_to": "1649206800" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` #### Changing the interface of an item prototype Change the host interface that will be used by discovered items. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "27428", "interfaceid": "132" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27428" ] }, "id": 1 } ``` #### アイテム プロトタイプのインターフェイス変更 検出されたアイテムが使用するホスト インターフェイスを変更します。 Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "27428", "interfaceid": "132" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27428" ] }, "id": 1 } ``` #### Changing the schedule of an SLA Switch the SLA with ID "5" to a 24x7 schedule. Request: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "slaid": "5", "schedule": [] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` #### SLAのスケジュールの変更 ID"5"のSLAを24時間年中無休のスケジュールに切り替えます。 Request: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "slaid": "5", "schedule": [] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` #### Changing the size of a graph prototype Change the size of a graph prototype to 1100 to 400 pixels. Request: ``` {.java} { "jsonrpc": "2.0", "method": "graphprototype.update", "params": { "graphid": "439", "width": 1100, "height": 400 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### graph prototype のサイズを変更する graph prototype のサイズを 1100 から 400 ピクセルに変更します。 Request: ``` {.java} { "jsonrpc": "2.0", "method": "graphprototype.update", "params": { "graphid": "439", "width": 1100, "height": 400 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### Changing the standard template properties Change the technical name of the template to "Linux by Zabbix agent Custom", the visible name to "My template", and update the template description. Request: ```json { "jsonrpc": "2.0", "method": "template.update", "params": { "templateid": "10086", "host": "Linux by Zabbix agent Custom", "name": "My template", "description": "This is a custom Linux template." }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10086" ] }, "id": 1 } ``` #### 標準テンプレートのプロパティの変更 テンプレートのテクニカル名を"Linux by Zabbix agent Custom"に、表示名を"My template"に変更し、テンプレートの説明を更新します。 Request: ```json { "jsonrpc": "2.0", "method": "template.update", "params": { "templateid": "10086", "host": "Linux by Zabbix agent Custom", "name": "My template", "description": "This is a custom Linux template." }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10086" ] }, "id": 1 } ``` #### Changing the value of a global macro Change the value of a global macro to "public". Request: ```json { "jsonrpc": "2.0", "method": "usermacro.updateglobal", "params": { "globalmacroid": "1", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "1" ] }, "id": 1 } ``` #### グローバルマクロの値の変更 グローバルマクロの値を"public"に変更します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "usermacro.updateglobal", "params": { "globalmacroid": "1", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "1" ] }, "id": 1 } ``` #### Changing the value of a host macro Change the value of a host macro to "public". Request: ```json { "jsonrpc": "2.0", "method": "usermacro.update", "params": { "hostmacroid": "1", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "1" ] }, "id": 1 } ``` #### ホストマクロの値変更 ホストマクロの値を"public"に変更します。 Request: ```json { "jsonrpc": "2.0", "method": "usermacro.update", "params": { "hostmacroid": "1", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "1" ] }, "id": 1 } ``` #### Changing user role Change a role of a user. Request: ```json { "jsonrpc": "2.0", "method": "user.update", "params": { "userid": "12", "roleid": "6" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` #### ユーザーの役割を変更 ユーザーの役割を変更 Request: ```json { "jsonrpc": "2.0", "method": "user.update", "params": { "userid": "12", "roleid": "6" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` #### Changing value map name Change value map name to "Device status". Request: ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "name": "Device status" }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### バリューマップ名の変更 バリューマップの名前を"Device status"に変更する Request: ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "name": "Device status" }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### Checking for not supported value This example uses the [Check for not supported value](/manual/config/items/preprocessing#configuration) preprocessing step to check if the item value could not be retrieved. When a Zabbix server/proxy poller process attempts to collect an item value, it may: - Return a valid result. - Return a result that initially seems valid but may become unsupported later (e.g., due to a value type mismatch after preprocessing). - Return an error of collecting the value, causing the item to become unsupported. Common causes include: - Unknown item key (for Zabbix agent, Simple check, or Zabbix internal items) - Unknown OID (SNMP agent), unknown sensor (IPMI agent), or no JMX metric (JMX agent) - Cannot read trap file (SNMP trap) - Script not found (External check) - No such URL (HTTP agent) - Login failed (SSH agent, TELNET agent) - Invalid formula syntax (Calculated), JavaScript syntax error (Script), or invalid SQL (Database monitor) To detect and handle errors of collecting item values, you can use the "Check for not supported value" preprocessing step. Note that this step is always executed first and only detects errors that occur before preprocessing begins. In the *Preprocessing* tab of an item, select the "Check for not supported value" preprocessing step. Then, use the *Custom on fail* option to discard the value (in this case, the error), set a custom value, or return a custom error message. Please note that [discarded](/manual/config/items/preprocessing#discardunchanged) values are not stored in the database; as a result, triggers are not evaluated and trend data is not generated. #### サポートされていない値のチェック この例では、[サポートされていない値のチェック](/manual/config/items/preprocessing#configuration)前処理ステップを使用して、アイテム値が取得できなかったかどうかを確認します。 Zabbixサーバー/プロキシポーラープロセスがアイテム値の収集を試みる際に、次のような結果が返される可能性があります。 - 有効な結果を返す。 - 最初は有効に見えても、後でサポート対象外になる可能性がある結果を返す（例：前処理後の値の型の不一致により） - 値の収集エラーを返し、アイテムがサポート対象外になる。一般的な原因は次のとおりです。 - 不明なアイテムキー（Zabbixエージェント、シンプルチェック、またはZabbix内部アイテム） - 不明なOID（SNMPエージェント）、不明なセンサー（IPMIエージェント）、またはJMXメトリックなし（JMXエージェント） - トラップファイルを読み取れない（SNMPトラップ） - スクリプトが見つからない（外部チェック） - そのようなURLがない（HTTPエージェント） - ログインに失敗した（SSHエージェント、TELNETエージェント） - 無効な数式構文（計算式）、JavaScript構文エラー（スクリプト）、または無効なSQL（データベースモニター） アイテム値の収集エラーを検出して処理するには、"サポートされていない値をチェック"前処理ステップを使用できます。 このステップは常に最初に実行され、前処理開始前に発生したエラーのみを検出することに注意してください。 アイテムの*前処理*タブで、"サポートされていない値をチェック"前処理ステップを選択します。 次に、"失敗時にカスタム"オプションを使用して、値（この場合はエラー）を破棄するか、カスタム値を設定するか、カスタムエラーメッセージを返します。 [破棄された](/manual/config/items/preprocessing#discardunchanged)値はデータベースに保存されないため、トリガーは評価されず、傾向データも生成されないことに注意してください。 ### 'Check now' request object The 'Check now' task request object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|string|ID of item and low-level discovery rules.| ### 'Check now' request object 'Check now' task request オブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |itemid|string|アイテムの IDとローレベルディスカバリルール| #### Check of pre-requisites Make sure that all software prerequisites are met. {width="550"} |Pre-requisite|Minimum value|Description| |--|--|------| |*PHP version*|7.2.5| | |*PHP memory\_limit option*|128MB|In php.ini:<br>memory\_limit = 128M| |*PHP post\_max\_size option*|16MB|In php.ini:<br>post\_max\_size = 16M| |*PHP upload\_max\_filesize option*|2MB|In php.ini:<br>upload\_max\_filesize = 2M| |*PHP max\_execution\_time option*|300 seconds (values 0 and -1 are allowed)|In php.ini:<br>max\_execution\_time = 300| |*PHP max\_input\_time option*|300 seconds (values 0 and -1 are allowed)|In php.ini:<br>max\_input\_time = 300| |*PHP session.auto\_start option*|must be disabled|In php.ini:<br>session.auto\_start = 0| |*Database support*|One of: MySQL, Oracle, PostgreSQL.|One of the following modules must be installed:<br>mysql, oci8, pgsql| |*bcmath*| |php-bcmath| |*mbstring*| |php-mbstring| |*PHP mbstring.func\_overload option*|must be disabled|In php.ini:<br>mbstring.func\_overload = 0| |*sockets*| |php-net-socket. Required for user script support.| |*gd*|2.0.28|php-gd. PHP GD extension must support PNG images (*--with-png-dir*), JPEG (*--with-jpeg-dir*) images and FreeType 2 (*--with-freetype-dir*).| |*libxml*|2.6.15|php-xml| |*xmlwriter*| |php-xmlwriter| |*xmlreader*| |php-xmlreader| |*ctype*| |php-ctype| |*session*| |php-session| |*gettext*| |php-gettext<br>Since Zabbix 2.2.1, the PHP gettext extension is not a mandatory requirement for installing Zabbix. If gettext is not installed, the frontend will work as usual, however, the translations will not be available.| Optional pre-requisites may also be present in the list. A failed optional prerequisite is displayed in orange and has a *Warning* status. With a failed optional pre-requisite, the setup may continue. ::: noteimportant If there is a need to change the Apache user or user group, permissions to the session folder must be verified. Otherwise Zabbix setup may be unable to continue. ::: #### 前提条件の確認 すべてのソフトウェアの前提条件が満たされていることを確認してください。 {width="550"} |前提条件|最小値|説明| |--|--|------| |*PHP version*|7.2.5| | |*PHP memory\_limit option*|128MB|php.ini:<br>memory\_limit = 128M| |*PHP post\_max\_size option*|16MB|php.ini:<br>post\_max\_size = 16M| |*PHP upload\_max\_filesize option*|2MB|php.ini:<br>upload\_max\_filesize = 2M| |*PHP max\_execution\_time option*|300秒 (0、-1も許可)|php.ini:<br>max\_execution\_time = 300| |*PHP max\_input\_time option*|300秒 (0、-1も許可)|php.ini:<br>max\_input\_time = 300| |*PHP session.auto\_start option*|必ず無効|php.ini:<br>session.auto\_start = 0| |*Database support*|どれかひとつ: MySQL、Oracle、PostgreSQL|次のモジュールのいずれかをインストールする必要があります。<br>mysql、oci8、pgsql| |*bcmath*| |php-bcmath| |*mbstring*| |php-mbstring| |*PHP mbstring.func\_overload option*|必ず無効|php.ini:<br>mbstring.func\_overload = 0| |*sockets*| |php-net-socket。ユーザースクリプトのサポートに必要です。| |*gd*|2.0.28|php-gd。PHP GD拡張機能は、PNG画像 (*--with-png-dir*)、JPEG画像 (*--with-jpeg-dir*)、および FreeType 2 (*--with-freetype-dir*) をサポートする必要があります。| |*libxml*|2.6.15|php-xml| |*xmlwriter*| |php-xmlwriter| |*xmlreader*| |php-xmlreader| |*ctype*| |php-ctype| |*session*| |php-session| |*gettext*| |php-gettext<br>Zabbix 2.2.1以降、PHP gettext拡張機能は、Zabbixをインストールするための必須要件ではありません。gettextがインストールされていない場合、フロントエンドは通常どおり動作しますが、翻訳は利用できません。| オプションの前提条件もリストに含まれる場合があります。 失敗したオプションの前提条件はオレンジ色で表示され、*Warning*ステータスになります。 オプションの前提条件が失敗した場合でも、セットアップは続行される可能性があります。 ::: noteimportant Apacheユーザーまたはユーザーグループを変更する必要がある場合は、セッションフォルダーへのアクセス許可を確認してください。そうしないと、Zabbixセットアップを続行できなくなる可能性があります。 ::: #### Check status of nodes at specific IP addresses Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["name", "status"], "filter": { "address": ["192.168.1.7", "192.168.1.13"] } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "name": "node3", "status": "0" }, { "name": "node-active", "status": "3" } ], "id": 1 } ``` #### 特定のIPアドレスのノードの状態を確認 リクエスト： ``` {.java} { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["name", "status"], "filter": { "address": ["192.168.1.7", "192.168.1.13"] } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス： ``` {.java} { "jsonrpc": "2.0", "result": [ { "name": "node3", "status": "0" }, { "name": "node-active", "status": "3" } ], "id": 1 } ``` #### Chromium for Zabbix web service on Ubuntu 20 Though in most cases, Zabbix web service can run with Chromium, on Ubuntu 20.04 using Chromium causes the following error: Cannot fetch data: chrome failed to start:cmd_run.go:994: WARNING: cannot create user data directory: cannot create "/var/lib/zabbix/snap/chromium/1564": mkdir /var/lib/zabbix: permission denied Sorry, home directories outside of /home are not currently supported. See https://forum.snapcraft.io/t/11209 for details. This error occurs because `/var/lib/zabbix` is used as a home directory of user 'zabbix'. #### Ubuntu 20のZabbix WebサービスのChromium ほとんどの場合、Zabbix WebサービスはChromiumで動作しますが、Ubuntu 20.04でChromiumを使用すると、以下のエラーが発生します: Cannot fetch data: chrome failed to start:cmd_run.go:994: WARNING: cannot create user data directory: cannot create "/var/lib/zabbix/snap/chromium/1564": mkdir /var/lib/zabbix: permission denied Sorry, home directories outside of /home are not currently supported. See https://forum.snapcraft.io/t/11209 for details. このエラーは、`/var/lib/zabbix`がユーザー'zabbix'のホームディレクトリとして使用されるために発生します。 #### Ciphersuites Ciphersuites by default are configured internally during Zabbix startup and, before Zabbix 4.0.19, 4.4.7, are not user-configurable. Since Zabbix 4.0.19, 4.4.7 also user-configured ciphersuites are supported for GnuTLS and OpenSSL. Users may [configure](#user-configured_ciphersuites) ciphersuites according to their security policies. Using this feature is optional (built-in default ciphersuites still work). For crypto libraries compiled with default settings Zabbix built-in rules typically result in the following ciphersuites (in order from higher to lower priority): |Library|Certificate ciphersuites|PSK ciphersuites| |-------|-------------------|-------------------| |*GnuTLS 3.1.18*|TLS\_ECDHE\_RSA\_AES\_128\_GCM\_SHA256<br>TLS\_ECDHE\_RSA\_AES\_128\_CBC\_SHA256<br>TLS\_ECDHE\_RSA\_AES\_128\_CBC\_SHA1<br>TLS\_RSA\_AES\_128\_GCM\_SHA256<br>TLS\_RSA\_AES\_128\_CBC\_SHA256<br>TLS\_RSA\_AES\_128\_CBC\_SHA1|TLS\_ECDHE\_PSK\_AES\_128\_CBC\_SHA256<br>TLS\_ECDHE\_PSK\_AES\_128\_CBC\_SHA1<br>TLS\_PSK\_AES\_128\_GCM\_SHA256<br>TLS\_PSK\_AES\_128\_CBC\_SHA256<br>TLS\_PSK\_AES\_128\_CBC\_SHA1| |*OpenSSL 1.0.2c*|ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-SHA256<br>AES128-SHA|PSK-AES128-CBC-SHA| |*OpenSSL 1.1.0*|ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-CCM8<br>AES128-CCM<br>AES128-SHA256<br>AES128-SHA<br>|ECDHE-PSK-AES128-CBC-SHA256<br>ECDHE-PSK-AES128-CBC-SHA<br>PSK-AES128-GCM-SHA256<br>PSK-AES128-CCM8<br>PSK-AES128-CCM<br>PSK-AES128-CBC-SHA256<br>PSK-AES128-CBC-SHA| |*OpenSSL 1.1.1d*|TLS\_AES\_256\_GCM\_SHA384<br>TLS\_CHACHA20\_POLY1305\_SHA256<br>TLS\_AES\_128\_GCM\_SHA256<br>ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-CCM8<br>AES128-CCM<br>AES128-SHA256<br>AES128-SHA|TLS\_CHACHA20\_POLY1305\_SHA256<br>TLS\_AES\_128\_GCM\_SHA256<br>ECDHE-PSK-AES128-CBC-SHA256<br>ECDHE-PSK-AES128-CBC-SHA<br>PSK-AES128-GCM-SHA256<br>PSK-AES128-CCM8<br>PSK-AES128-CCM<br>PSK-AES128-CBC-SHA256<br>PSK-AES128-CBC-SHA| #### 暗号スイート 暗号スイートはデフォルトでは Zabbix 起動時に内部で設定され、Zabbix 4.0.19以前、4.4.7以前ではユーザが設定することは<br> できません。 Zabbix 4.0.19、4.4.7 から GnuTLS と OpenSSL のユーザ設定可能な暗号スイートがサポートされるようになりました。<br> ユーザはセキュリティポリシーに従って暗号スイートを [configure](#user-configured_ciphersuites) することができます。<br> この機能の使用は任意です。(組み込みのデフォルトの暗号スイートはそのまま機能します)<br> デフォルト設定でコンパイルされた暗号ライブラリの場合、Zabbixのビルトインルールでは通常以下の暗号スイートを<br> 使用します。(優先度の高いものから低いものの順): |ライブラリ|Certificate ciphersuites|PSK ciphersuites| |-------|-------------------|-------------------| |*GnuTLS 3.1.18*|TLS\_ECDHE\_RSA\_AES\_128\_GCM\_SHA256<br>TLS\_ECDHE\_RSA\_AES\_128\_CBC\_SHA256<br>TLS\_ECDHE\_RSA\_AES\_128\_CBC\_SHA1<br>TLS\_RSA\_AES\_128\_GCM\_SHA256<br>TLS\_RSA\_AES\_128\_CBC\_SHA256<br>TLS\_RSA\_AES\_128\_CBC\_SHA1|TLS\_ECDHE\_PSK\_AES\_128\_CBC\_SHA256<br>TLS\_ECDHE\_PSK\_AES\_128\_CBC\_SHA1<br>TLS\_PSK\_AES\_128\_GCM\_SHA256<br>TLS\_PSK\_AES\_128\_CBC\_SHA256<br>TLS\_PSK\_AES\_128\_CBC\_SHA1| |*OpenSSL 1.0.2c*|ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-SHA256<br>AES128-SHA|PSK-AES128-CBC-SHA| |*OpenSSL 1.1.0*|ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-CCM8<br>AES128-CCM<br>AES128-SHA256<br>AES128-SHA<br>|ECDHE-PSK-AES128-CBC-SHA256<br>ECDHE-PSK-AES128-CBC-SHA<br>PSK-AES128-GCM-SHA256<br>PSK-AES128-CCM8<br>PSK-AES128-CCM<br>PSK-AES128-CBC-SHA256<br>PSK-AES128-CBC-SHA| |*OpenSSL 1.1.1d*|TLS\_AES\_256\_GCM\_SHA384<br>TLS\_CHACHA20\_POLY1305\_SHA256<br>TLS\_AES\_128\_GCM\_SHA256<br>ECDHE-RSA-AES128-GCM-SHA256<br>ECDHE-RSA-AES128-SHA256<br>ECDHE-RSA-AES128-SHA<br>AES128-GCM-SHA256<br>AES128-CCM8<br>AES128-CCM<br>AES128-SHA256<br>AES128-SHA|TLS\_CHACHA20\_POLY1305\_SHA256<br>TLS\_AES\_128\_GCM\_SHA256<br>ECDHE-PSK-AES128-CBC-SHA256<br>ECDHE-PSK-AES128-CBC-SHA<br>PSK-AES128-GCM-SHA256<br>PSK-AES128-CCM8<br>PSK-AES128-CCM<br>PSK-AES128-CBC-SHA256<br>PSK-AES128-CBC-SHA| ### Cleaner configuration export  YAML files generated during Zabbix entity configuration export no longer contain empty lines between entities in an array, which makes such files shorter and more convenient to work with. See [Configuration export/import](/manual/xml_export_import) section for updated export examples. ### 設定のエクスポートの改善 Zabbixエンティティ設定のエクスポート中に生成されたYAMLファイルには、配列内のエンティティ間に空の行が含まれなくなりました。これにより、ファイルが短くなり、操作がより便利になりました。アップデート後からのエクスポートの例は、[設定のエクスポート/インポート](/manual/xml_export_import)をご覧ください。 #### Clear history Request: ```json { "jsonrpc": "2.0", "method": "history.clear", "params": [ "10325", "13205" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10325", "13205" ] }, "id": 1 } ``` #### ヒストリの消去 リクエスト: ```json { "jsonrpc": "2.0", "method": "history.clear", "params": [ "10325", "13205" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10325", "13205" ] }, "id": 1 } ``` #### Clearing template linked templates Unlink and clear the given template from a specific linked template. Request: ```json { "jsonrpc": "2.0", "method": "template.update", "params": { "templateid": "10086", "templates_clear": [ { "templateid": "10087" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10086" ] }, "id": 1 } ``` #### テンプレートにリンクされたテンプレートのクリア 指定されたテンプレートを、特定のリンクされたテンプレートからリンク解除してクリアします。 Request: ```json { "jsonrpc": "2.0", "method": "template.update", "params": { "templateid": "10086", "templates_clear": [ { "templateid": "10087" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10086" ] }, "id": 1 } ``` ### Code |Type|Size|Comments| |-----|-----|----------| |Byte| 4 |Payload type, currently only JSON is supported.| ### Code |タイプ|サイズ|コメント| |-----|-----|----------| |バイト| 4 |ペイロードタイプ、現在はJSONのみがサポートされています。| ##### Collapsed menu When the menu is collapsed to icons only, a full menu reappears as soon as the mouse cursor is placed upon it. Note that it reappears over page content; to move page content to the right you have to click on the expand button. If the mouse cursor again is placed outside the full menu, the menu will collapse again after two seconds. You can also make a collapsed menu reappear fully by hitting the Tab key. Hitting the Tab key repeatedly will allow to focus on the next menu element. ##### 折りたたみメニュー メニューを折りたたんでアイコンにした後、マウスカーソルをアイコンの上に置くとすぐに完全なメニューを再表示できます。メニューはページコンテンツの上に再表示されることに注意してください。ページコンテンツを右に移動するには、展開ボタンをクリックする必要があります。マウスカーソルを再びフルメニューの外に置くと、2秒後にメニューが再び折りたたまれます。 Tabキーを押して、折りたたまれたメニューを完全に再表示することもできます。 Tabキーを繰り返し押すと、次のメニュー要素にフォーカスできます。 ##### Column configuration {width="600"} ##### 列の設定 {width="600"} #### Columns Columns have common parameters and additional parameters depending on the configuration of the parameter *Data*. ::: noteclassic For all parameters related to columns the number in the property name (e.g. columns.name.0) references a column for which the parameter is configured. ::: #### 列 列には、*データ*パラメーターの設定に応じて、共通パラメーターと追加パラメーターがあります。 ::: noteclassic 列に関連するすべてのパラメーターにおいて、プロパティ名に含まれる番号(例: columns.name.0)は、パラメーターが設定されている列を参照します。 ::: #### Command-line based installation #### コマンドラインベースのインストール [comment]: # attributes: noaside # 11 Recipes for monitoring [comment]: # attributes: noaside # 11 モニタリング用レシピ [comment]: # attributes: noaside # 12 Performance tuning ::: noteimportant This is a work in progress. ::: [comment]: # attributes: noaside # 12 パフォーマンスチューニング ::: noteimportant これは現在調整中です。 ::: [comment]: # (tags: proxy) # 4 Proxy [comment]: # (tags: proxy) # 4 Zabbixプロキシ #### Common agent items supported on Windows |Item key|User group|<| |--------|----------|-| | |Recommended|Minimum technically acceptable (functionality is limited)| |agent.hostname|Guests|Guests| |agent.ping|Guests|Guests| |agent.variant|Guests|Guests| |agent.version|Guests|Guests| |log|Administrators|Guests| |log.count|Administrators|Guests| |logrt|Administrators|Guests| |logrt.count|Administrators|Guests| |net.dns|Guests|Guests| |net.dns.record|Guests|Guests| |net.if.discovery|Guests|Guests| |net.if.in|Guests|Guests| |net.if.out|Guests|Guests| |net.if.total|Guests|Guests| |net.tcp.listen|Guests|Guests| |net.tcp.port|Guests|Guests| |net.tcp.service|Guests|Guests| |net.tcp.service.perf|Guests|Guests| |net.udp.service|Guests|Guests| |net.udp.service.perf|Guests|Guests| |proc.num|Administrators|Guests| |system.cpu.discovery|Performance Monitor Users|Performance Monitor Users| |system.cpu.load|Performance Monitor Users|Performance Monitor Users| |system.cpu.num|Guests|Guests| |system.cpu.util|Performance Monitor Users|Performance Monitor Users| |system.hostname|Guests|Guests| |system.localtime|Guests|Guests| |system.run|Administrators|Guests| |system.sw.arch|Guests|Guests| |system.swap.size|Guests|Guests| |system.uname|Guests|Guests| |system.uptime|Performance Monitor Users|Performance Monitor Users| |vfs.dir.count|Administrators|Guests| |vfs.dir.get|Administrators|Guests| |vfs.dir.size|Administrators|Guests| |vfs.file.cksum|Administrators|Guests| |vfs.file.contents|Administrators|Guests| |vfs.file.exists|Administrators|Guests| |vfs.file.md5sum|Administrators|Guests| |vfs.file.regexp|Administrators|Guests| |vfs.file.regmatch|Administrators|Guests| |vfs.file.size|Administrators|Guests| |vfs.file.time|Administrators|Guests| |vfs.fs.discovery|Administrators|Guests| |vfs.fs.get|Administrators|Guests| |vfs.fs.size|Administrators|Guests| |vm.memory.size|Guests|Guests| |web.page.get|Guests|Guests| |web.page.perf|Guests|Guests| |web.page.regexp|Guests|Guests| |zabbix.stats|Guests|Guests| #### Windowsでサポートされている一般的なエージェントアイテム |アイテムキー|ユーザーグループ|<| |--------|----------|-| | |推奨|技術的に許容できる最小値 (機能は制限されています)| |agent.hostname|Guests|Guests| |agent.ping|Guests|Guests| |agent.variant|Guests|Guests| |agent.version|Guests|Guests| |log|Administrators|Guests| |log.count|Administrators|Guests| |logrt|Administrators|Guests| |logrt.count|Administrators|Guests| |net.dns|Guests|Guests| |net.dns.record|Guests|Guests| |net.if.discovery|Guests|Guests| |net.if.in|Guests|Guests| |net.if.out|Guests|Guests| |net.if.total|Guests|Guests| |net.tcp.listen|Guests|Guests| |net.tcp.port|Guests|Guests| |net.tcp.service|Guests|Guests| |net.tcp.service.perf|Guests|Guests| |net.udp.service|Guests|Guests| |net.udp.service.perf|Guests|Guests| |proc.num|Administrators|Guests| |system.cpu.discovery|Performance Monitor Users|Performance Monitor Users| |system.cpu.load|Performance Monitor Users|Performance Monitor Users| |system.cpu.num|Guests|Guests| |system.cpu.util|Performance Monitor Users|Performance Monitor Users| |system.hostname|Guests|Guests| |system.localtime|Guests|Guests| |system.run|Administrators|Guests| |system.sw.arch|Guests|Guests| |system.swap.size|Guests|Guests| |system.uname|Guests|Guests| |system.uptime|Performance Monitor Users|Performance Monitor Users| |vfs.dir.count|Administrators|Guests| |vfs.dir.get|Administrators|Guests| |vfs.dir.size|Administrators|Guests| |vfs.file.cksum|Administrators|Guests| |vfs.file.contents|Administrators|Guests| |vfs.file.exists|Administrators|Guests| |vfs.file.md5sum|Administrators|Guests| |vfs.file.regexp|Administrators|Guests| |vfs.file.regmatch|Administrators|Guests| |vfs.file.size|Administrators|Guests| |vfs.file.time|Administrators|Guests| |vfs.fs.discovery|Administrators|Guests| |vfs.fs.get|Administrators|Guests| |vfs.fs.size|Administrators|Guests| |vm.memory.size|Guests|Guests| |web.page.get|Guests|Guests| |web.page.perf|Guests|Guests| |web.page.regexp|Guests|Guests| |zabbix.stats|Guests|Guests| Common column parameters: | | | |--|--------| |*Name*|Name of the column.| |*Data*|Data type to display in the column:<br>**Item value** - value of the specified item<br>**Host name** - host name of the item specified in the *Item value* column<br>**Text** - static text string| |*Base color*|Background color of the column; fill color if *Item value* data is displayed as bar/indicators.<br>For *Item value* data the default color can be overridden by custom color, if the item value is over one of the specified "Thresholds".| 共通の列パラメーター： | | | |--|--------| |*名前*|列の名前| |*取得データ*|列に表示するデータ：<br>**アイテムの値** - 指定されたアイテムの値<br>**ホスト名** - *アイテム値*で指定されたアイテムのホスト名<br> **テキスト** - 静的テキスト文字列| |*基本色*|カラムの背景色。 *アイテム値*データがバー/インジケーターとして表示される場合は色を塗りつぶします。<br>*アイテム値*データの場合、アイテム値が指定された「しきい値」の1つを超えると、デフォルトの色をカスタム色で上書きできます。| ##### Common parameters - `/host/key` is a common mandatory first parameter for the functions referencing the host item history - `(sec|#num)<:time shift>` is a common second parameter for the functions referencing the host item history, where: - **sec** - maximum [evaluation period](/manual/config/triggers#evaluation_period) in seconds (time [suffixes](/manual/appendix/suffixes) can be used), or - **\#num** - maximum [evaluation range](/manual/config/triggers#evaluation_period) in latest collected values (if preceded by a hash mark) - **time shift** (optional) allows to move the evaluation point back in time. See [more details](/manual/config/triggers/expression#time_shift) on specifying time shift. ##### 共通パラメータ - `/host/key` はホストアイテムの履歴を参照する関数の一般的なパラメーターの一つ目です。必須です。 - `(sec|#num)<:time shift>` は、ホストのアイテム履歴を参照する関数の一般的なパラメーターの二つ目です。 - **sec** - 秒単位の最大[評価期間](/manual/config/triggers#evaluation_period) (タイム[サフィックス](/manual/appendix/suffixes) を使用できます) または - **\#num** - 最新の収集値の最大[評価範囲](/manual/config/triggers#evaluation_period) (先頭にハッシュ マークがある場合) - **time shift** (オプション) 評価ポイントを時間内に戻すことができます。 時間シフトの指定については[詳細](/manual/config/triggers/expression#time_shift)を参照してください。 ##### Common parameters - `/host/key` is a common mandatory first parameter for the functions referencing the host item history - `(sec|#num)<:time shift>` is a common second parameter for the functions referencing the host item history, where: - **sec** - maximum [evaluation period](/manual/config/triggers#evaluation_period) in seconds (time [suffixes](/manual/appendix/suffixes) can be used), or - **\#num** - maximum [evaluation range](/manual/config/triggers#evaluation_period) in latest collected values (if preceded by a hash mark) - **time shift** (optional) allows to move the evaluation point back in time. See [more details](/manual/config/triggers/expression#time_shift) on specifying time shift. ##### 共通パラメータ - `/host/key` はホストアイテムの履歴を参照する関数の一般的なパラメーターの一つ目です。必須です。 - `(sec|#num)<:time shift>` は、ホストのアイテム履歴を参照する関数の一般的なパラメーターの二つ目です。 - **sec** - 秒単位の最大[評価期間](/manual/config/triggers#evaluation_period) (タイム[サフィックス](/manual/appendix/suffixes) を使用できます) または - **\#num** - 最新の収集値の最大[評価範囲](/manual/config/triggers#evaluation_period) (先頭にハッシュ マークがある場合) - **time shift** (オプション) 評価ポイントを時間内に戻すことができます。 時間シフトの指定については[詳細](/manual/config/triggers/expression#time_shift)を参照してください。 ##### Common parameters - `/host/key` is a common mandatory first parameter for the functions referencing the host item history - `(sec|#num)<:time shift>` is a common second parameter for the functions referencing the host item history, where: - **sec** - maximum [evaluation period](/manual/config/triggers#evaluation_period) in seconds (time [suffixes](/manual/appendix/suffixes) can be used), or - **\#num** - maximum [evaluation range](/manual/config/triggers#evaluation_period) in latest collected values (if preceded by a hash mark) - **time shift** (optional) allows to move the evaluation point back in time. See [more details](/manual/config/triggers/expression#time_shift) on specifying time shift. ##### 共通パラメータ - `/host/key` はホストアイテムの履歴を参照する関数の一般的なパラメーターの一つ目です。必須です。 - `(sec|#num)<:time shift>` は、ホストのアイテム履歴を参照する関数の一般的なパラメーターの二つ目です。 - **sec** - 秒単位の最大[評価期間](/manual/config/triggers#evaluation_period) (タイム[サフィックス](/manual/appendix/suffixes) を使用できます) または - **\#num** - 最新の収集値の最大[評価範囲](/manual/config/triggers#evaluation_period) (先頭にハッシュ マークがある場合) - **time shift** (オプション) 評価ポイントを時間内に戻すことができます。 時間シフトの指定については[詳細](/manual/config/triggers/expression#time_shift)を参照してください。 ##### Common parameters - `/host/key` is a common mandatory first parameter - `time period:time shift` is a common second parameter, where: - **time period** - the time period (minimum '1h'), defined as \<N>\<time unit> where `N` - the number of time units, `time unit` - h (hour), d (day), w (week), M (month) or y (year). - **time shift** - the time period offset (see function examples) ##### 共通パラメータ - `/host/key` は一般的な必須の最初のパラメータです - `time period:time shift` は一般的な 2 番目のパラメーターです。 - **time period** - 期間 (最小 '1h')、\<N>\<時間単位> として定義、'N' - 時間単位の数、'時間単位' - h (時間) d (日)、w (週)、M (月)、または y (年)。 - **time shift** - 期間のオフセット (関数の例を参照) ##### Common use cases of global and host macros - use a global macro in several locations; then change the macro value and apply configuration changes to all locations with one click - take advantage of templates with host-specific attributes: passwords, port numbers, file names, regular expressions, etc. ##### グローバルマクロとホストマクロの一般的な使用例 - グローバルマクロを複数の場所で使用し、マクロの値を変更すると、ワンクリックですべての場所に設定変更が適用されます。 - ホスト固有の属性（パスワード、ポート番号、ファイル名、正規表現など）を持つテンプレートを活用します。 ##### Communication with Zabbix server |Parameter|Description| |---------|-----------| |*Network timeout*|How many seconds to wait before closing an idle socket (if a connection to Zabbix server has been established earlier, but frontend can not finish read/send data operation during this time, the connection will be dropped). Allowed range: 1 - 300s (default: 3s).| |*Connection timeout*|How many seconds to wait before stopping an attempt to connect to Zabbix server. Allowed range: 1 - 30s (default: 3s).| |*Network timeout for media type test*|How many seconds to wait for a response when testing a media type. Allowed range: 1 - 300s (default: 65s).| |*Network timeout for script execution*|How many seconds to wait for a response when executing a script. Allowed range: 1 - 300s (default: 60s).| |*Network timeout for item test*|How many seconds to wait for returned data when testing an item. Allowed range: 1 - 300s (default: 60s).| |*Network timeout for scheduled report test*|How many seconds to wait for returned data when testing a scheduled report. Allowed range: 1 - 300s (default: 60s).| ##### Zabbixサーバーとの通信 |パラメータ|詳細| |---------|-----------| |*ネットワークタイムアウト*|アイドル状態のソケットを閉じるまでの待機秒数（Zabbixサーバーへの接続が以前に確立されているが、この間にフロントエンドがデータの読み取り/送信操作を完了できない場合、接続は切断されます）。許容範囲：1〜300秒（デフォルト：3秒）。| |*接続タイムアウト*|Zabbixサーバーへの接続試行を停止するまでに待機する秒数。許容範囲：1〜30秒（デフォルト：3秒）。| |*メディアテストのためのネットワークタイムアウト*|メディアタイプをテストするときに応答を待機する秒数。許容範囲：1〜300秒（デフォルト：65秒）。| |*スクリプト実行のためのネットワークタイムアウト*|スクリプトの実行時に応答を待機する秒数。許容範囲：1〜300秒（デフォルト：60秒）。| |*アイテムテストのためのネットワークタイムアウト*|アイテムをテストするときに返されるデータを待機する秒数。許容範囲：1〜300秒（デフォルト：60秒）。| |*定期レポートテストのためのネットワークタイムアウト*|定期レポートをテストするときに返されたデータを待機する秒数。許容範囲：1〜300秒（デフォルト：60秒）。| #### Comparing the import of a template Compare the template contained in the XML string to the current system elements, and show what will be changed if this template will be imported. Request: ```json { "jsonrpc": "2.0", "method": "configuration.importcompare", "params": { "format": "xml", "rules": { "discoveryRules": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "graphs": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "groups": { "createMissing": true, "updateExisting": true }, "httptests": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "templateLinkage": { "createMissing": true, "deleteMissing": true }, "templates": { "createMissing": true, "updateExisting": true }, "templateDashboards": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": true, "deleteMissing": true } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.0</version><date>2023-01-01T12:30:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key><delay>3m</delay></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;/dt&gt;</parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>648006da5971424ead0c47ddbbf1ea2e</uuid><name>CPU utilization</name><key>system.cpu.util</key><value_type>FLOAT</value_type><units>%</units><triggers><trigger><uuid>736225012c534ec480c2a66a91322ce0</uuid><expression>avg(/New template/system.cpu.util,3m)&gt;70</expression><name>CPU utilization too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templates": { "updated": [ { "before": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template" }, "after": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template" }, "items": { "added": [ { "after": { "uuid": "648006da5971424ead0c47ddbbf1ea2e", "name": "CPU utilization", "key": "system.cpu.util", "value_type": "FLOAT", "units": "%" }, "triggers": { "added": [ { "after": { "uuid": "736225012c534ec480c2a66a91322ce0", "expression": "avg(/New template/system.cpu.util,3m)>70", "name": "CPU utilization too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "removed": [ { "before": { "uuid": "6805d4c39a624a8bab2cc8ab63df1ab3", "name": "CPU load", "key": "system.cpu.load", "value_type": "FLOAT" }, "triggers": { "removed": [ { "before": { "uuid": "ab4c2526c2bc42e48a633082255ebcb3", "expression": "avg(/New template/system.cpu.load,3m)>2", "name": "CPU load too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "updated": [ { "before": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping" }, "after": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping", "delay": "3m" } } ] } } ] } }, "id": 1 } ``` #### テンプレートのインポートの比較 XML文字列に含まれるテンプレートを現在のシステム要素と比較し、このテンプレートがインポートされた場合に何が変更されるかを示します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "configuration.importcompare", "params": { "format": "xml", "rules": { "discoveryRules": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "graphs": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "groups": { "createMissing": true, "updateExisting": true }, "httptests": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "templateLinkage": { "createMissing": true, "deleteMissing": true }, "templates": { "createMissing": true, "updateExisting": true }, "templateDashboards": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": true, "deleteMissing": true } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.0</version><date>2023-01-01T12:30:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key><delay>3m</delay></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter><dt>Server uptime: (.*)</dt></parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>648006da5971424ead0c47ddbbf1ea2e</uuid><name>CPU utilization</name><key>system.cpu.util</key><value_type>FLOAT</value_type><units>%</units><triggers><trigger><uuid>736225012c534ec480c2a66a91322ce0</uuid><expression>avg(/New template/system.cpu.util,3m)>70</expression><name>CPU utilization too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "templates": { "updated": [ { "before": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template" }, "after": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template" }, "items": { "added": [ { "after": { "uuid": "648006da5971424ead0c47ddbbf1ea2e", "name": "CPU utilization", "key": "system.cpu.util", "value_type": "FLOAT", "units": "%" }, "triggers": { "added": [ { "after": { "uuid": "736225012c534ec480c2a66a91322ce0", "expression": "avg(/New template/system.cpu.util,3m)>70", "name": "CPU utilization too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "removed": [ { "before": { "uuid": "6805d4c39a624a8bab2cc8ab63df1ab3", "name": "CPU load", "key": "system.cpu.load", "value_type": "FLOAT" }, "triggers": { "removed": [ { "before": { "uuid": "ab4c2526c2bc42e48a633082255ebcb3", "expression": "avg(/New template/system.cpu.load,3m)>2", "name": "CPU load too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "updated": [ { "before": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping" }, "after": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping", "delay": "3m" } } ] } } ] } }, "id": 1 } ``` #### Compiling OpenSSL The following steps will help you to compile OpenSSL from sources on MS Windows 10 (64-bit). 1. For compiling OpenSSL you will need on Windows machine: 1. C compiler (e.g. VS 2017 RC), 2. NASM (<https://www.nasm.us/>), 3. Perl (e.g. Strawberry Perl from <http://strawberryperl.com/>), 4. Perl module Text::Template (cpan Text::Template). 2. Get OpenSSL sources from <https://www.openssl.org/>. OpenSSL 1.1.1 is used here. 3. Unpack OpenSSL sources, for example, in E:\\openssl-1.1.1. 4. Open a commandline window e.g. the x64 Native Tools Command Prompt for VS 2017 RC. 5. Go to the OpenSSL source directory, e.g. E:\\openssl-1.1.1. 1. Verify that NASM can be found:`e:\openssl-1.1.1> nasm --version NASM version 2.13.01 compiled on May 1 2017 ` 6. Configure OpenSSL, for example:`e:\openssl-1.1.1> perl E:\openssl-1.1.1\Configure VC-WIN64A no-shared no-capieng no-srp no-gost no-dgram no-dtls1-method no-dtls1_2-method --api=1.1.0 --prefix=C:\OpenSSL-Win64-111-static --openssldir=C:\OpenSSL-Win64-111-static ` ::: noteimportant Make sure to revoke write access from non-administrator users to the OpenSSL install directory (`C:\OpenSSL-Win64-111-static`). Otherwise, Zabbix agent will load SSL settings from a path that can be modified by unprivileged users, resulting in a potential security vulnerability. ::: - Note the option 'no-shared': if 'no-shared' is used then the OpenSSL static libraries libcrypto.lib and libssl.lib will be 'self-sufficient' and resulting Zabbix binaries will include OpenSSL in themselves, no need for external OpenSSL DLLs. Advantage: Zabbix binaries can be copied to other Windows machines without OpenSSL libraries. Disadvantage: when a new OpenSSL bugfix version is released, Zabbix agent needs to recompiled and reinstalled. - If 'no-shared' is not used, then the static libraries libcrypto.lib and libssl.lib will be using OpenSSL DLLs at runtime. Advantage: when a new OpenSSL bugfix version is released, probably you can upgrade only OpenSSL DLLs, without recompiling Zabbix agent. Disadvantage: copying Zabbix agent to another machine requires copying OpenSSL DLLs, too. 7. Compile OpenSSL, run tests, install:`e:\openssl-1.1.1> nmake e:\openssl-1.1.1> nmake test ... All tests successful. Files=152, Tests=1152, 501 wallclock secs ( 0.67 usr + 0.61 sys = 1.28 CPU) Result: PASS e:\openssl-1.1.1> nmake install_sw `'install\_sw' installs only software components (i.e. libraries, header files, but no documentation). If you want everything, use "nmake install". #### OpenSSLのコンパイル 次の手順は、MS Windows 10 (64bit)上のソースからOpenSSLをコンパイルするのに役立ちます。 1. OpenSSLをコンパイルするには、Windowsマシンで次のものが必要です。 1. Cコンパイラ (例: VS 2017 RC) 2. NASM (<https://www.nasm.us/>) 3. Perl (例: Strawberry Perl from <http://strawberryperl.com/>) 4. Perl module Text::Template (cpan Text::Template) 2. <https://www.openssl.org/>からOpenSSLソースを入手します。ここではOpenSSL 1.1.1が使用されます。 3. OpenSSLソースをE:\\openssl-1.1.1などに解凍します。 4. コマンドラインウィンドウを開きます(the x64 Native Tools Command Prompt for VS 2017 RCなど)。 5. OpenSSLソースディレクトリに移動します。例: E:\\openssl-1.1.1 1. NASMが見つかることを確認します。`e:\openssl-1.1.1> nasm --version NASM version 2.13.01 compiled on May 1 2017 ` 6. OpenSSLを構成します。 例: `e:\openssl-1.1.1> perl E:\openssl-1.1.1\Configure VC-WIN64A no-shared no-capieng no-srp no-gost no-dgram no-dtls1-method no-dtls1_2-method --api=1.1.0 --prefix=C:\OpenSSL-Win64-111-static --openssldir=C:\OpenSSL-Win64-111-static ` ::: noteimportant 管理者以外のユーザーによるOpenSSLインストールディレクトリ(`C:\OpenSSL-Win64-111-static`)への書き込み権限を必ず無効にしてください。無効にしないと、Zabbixエージェント2は権限のないユーザーが変更できるパスからSSL設定を読み込み、潜在的なセキュリティ脆弱性が発生します。 ::: - 'no-shared'オプションに注意してください。'no-shared'を使用する場合、OpenSSL静的ライブラリlibcrypto.libおよびlibssl.libは'自己完結的'になり、 生成されるZabbixバイナリにOpenSSLが含まれるため、外部のOpenSSL DLLは不要になります。 長所: Zabbixバイナリは、OpenSSLライブラリがなくても他のWindowsマシンにコピーできます。 短所: 新しいOpenSSLバグ修正バージョンがリリースされると、Zabbixエージェントを再コンパイルして再インストールする必要があります。 - 'no-shared'を使用しない場合、静的ライブラリlibcrypto.libおよびlibssl.libは実行時にOpenSSL DLLを使用します。 長所: 新しいOpenSSLバグ修正バージョンがリリースされた場合、Zabbixエージェントを再コンパイルせずに、OpenSSL DLLのみをアップグレードできる可能性があります。 短所: Zabbixエージェントを別のマシンにコピーするには、OpenSSL DLLもコピーする必要があります。 7. OpenSSLのコンパイル、テストの実行、インストールをする:`e:\openssl-1.1.1> nmake e:\openssl-1.1.1> nmake test ... All tests successful. Files=152, Tests=1152, 501 wallclock secs ( 0.67 usr + 0.61 sys = 1.28 CPU) Result: PASS e:\openssl-1.1.1> nmake install_sw `install\_sw`はソフトウェアコンポーネントのみをインストールします(つまり、ライブラリ、ヘッダーファイル、しかしドキュメントはありません)。すべてが必要な場合は、"nmake install"を使用してください。 #### Compiling PCRE 1. Download the PCRE or PCRE2 (supported since Zabbix 6.0) library (<https://pcre.org/>). 2. Extract to directory *E:\\pcre2-10.39*. 3. Install CMake from <https://cmake.org/download/>, during install select: and ensure that cmake\\bin is on your path (tested version 3.9.4). 4. Create a new, empty build directory, preferably a subdirectory of the source dir. For example, *E:\\pcre2-10.39\\build*. 5. Open a commandline window e.g. the x64 Native Tools Command Prompt for VS 2017 and from that shell environment run cmake-gui. Do not try to start Cmake from the Windows Start menu, as this can lead to errors. 6. Enter *E:\\pcre2-10.39* and *E:\\pcre2-10.39\\build* for the source and build directories, respectively. 7. Hit the "Configure" button. 8. When specifying the generator for this project select "NMake Makefiles". 9. Create a new, empty install directory. For example, *E:\\pcre2-10.39-install*. 10. The GUI will then list several configuration options. Make sure the following options are selected: - **PCRE\_SUPPORT\_UNICODE\_PROPERTIES** ON - **PCRE\_SUPPORT\_UTF** ON - **CMAKE\_INSTALL\_PREFIX** *E:\\pcre2-10.39-install* 11. Hit "Configure" again. The adjacent "Generate" button should now be active. 12. Hit "Generate". 13. In the event that errors occur, it is recommended that you delete the CMake cache before attempting to repeat the CMake build process. In the CMake GUI, the cache can be deleted by selecting "File > Delete Cache". 14. The build directory should now contain a usable build system - *Makefile*. 15. Open a commandline window e.g. the x64 Native Tools Command Prompt for VS 2017 and navigate to the *Makefile* mentioned above. 16. Run NMake command: `E:\pcre2-10.39\build> nmake install ` #### PCREのコンパイル 1. PCREまたはPCRE2 (Zabbix 6.0以降サポート) ライブラリをダウンロードします (<https://pcre.org/>)。 2. ディレクトリ*E:\\pcre2-10.39*に解凍します。 3. CMakeを<https://cmake.org/download/>からインストールします。インストール中に次を選択し、cmake\\bin がパス上にあることを確認してください (テスト済みバージョン3.9.4)。 4. 新しい空のビルドディレクトリ、できればソースディレクトリのサブディレクトリを作成します。例: *E:\\pcre2-10.39\\build*。 5. コマンドラインウィンドウを開きます。例えばx64 Native Tools Command Prompt for VS 2017を使用し、そのシェル環境からcmake-guiを実行します。エラーが発生する可能性があるため、WindowsのスタートメニューからCmakeを起動しないでください。 6. ソースディレクトリとビルドディレクトリにそれぞれ*E:\\pcre2-10.39*と*E:\\pcre2-10.39\\build*を入力します。 7. "Configure"ボタンをクリックします。 8. このプロジェクトのジェネレーターを指定する場合は、"NMake Makefiles"を選択します。 9. 新しい空のインストールディレクトリを作成します。例: *E:\\pcre2-10.39-install*。 10. GUIにはいくつかの設定オプションがリストされます。次のオプションが選択されていることを確認してください。 - **PCRE\_SUPPORT\_UNICODE\_PROPERTIES** ON - **PCRE\_SUPPORT\_UTF** ON - **CMAKE\_INSTALL\_PREFIX** *E:\\pcre2-10.39-install* 11. もう一度"Configure"をクリックします。隣接する"Generate"ボタンがアクティブになるはずです。 12. "Generate"をクリックします。 13. エラーが発生した場合は、CMakeビルドプロセスを繰り返す前にCMakeキャッシュを削除することをお勧めします。CMake GUI では、"File > Delete Cache"を選択してキャッシュを削除できます。 14. ビルドディレクトリには、使用可能なビルドシステム*Makefile*が含まれているはずです。 15. コマンドラインウィンドウを開きます。例えばx64 Native Tools Command Prompt for VS 2017を使用し、上記の*Makefile*に移動します。 16. NMakeコマンドを実行する。`E:\pcre2-10.39\build> nmake install ` #### Compiling PCRE development libraries The following instructions will compile and install 64-bit PCRE libraries in *c:\\dev\\pcre* and 32-bit libraries in *c:\\dev\\pcre32*: 1\. Download the PCRE or PCRE2 (supported since Zabbix 6.0) library (<https://pcre.org/>) and extract\ 2\. Open *cmd* and navigate to the extracted sources #### PCRE開発者用ライブラリのコンパイル 次の手順で、64ビットPCREライブラリを*c:\\dev\\pcre*に、32ビットライブラリを*c:\\dev\\pcre32*にコンパイルしてインストールします。 1\. PCREまたはPCRE2(Zabbix 6.0以降サポート) ライブラリ(<https://pcre.org/>)をダウンロードして解凍します。\ 2\. *cmd* を開き、解凍されたソースに移動します。 #### Compiling Zabbix agent 2 #### Zabbixエージェント2のコンパイル #### Compiling Zabbix agent on HP-UX If you install the PCRE library from a popular HP-UX package site <http://hpux.connect.org.uk>, for example from file `pcre-8.42-ia64_64-11.31.depot`, you get only the 64-bit version of the library installed in the /usr/local/lib/hpux64 directory. In this case, for successful agent compilation customized options need to be used for the "configure" script, e.g.: CFLAGS="+DD64" ./configure --enable-agent --with-libpcre-include=/usr/local/include --with-libpcre-lib=/usr/local/lib/hpux64 #### HP-UX上でのZabbixエージェントのコンパイル HP-UXパッケージサイト<http://hpux.connect.org.uk> からPCREライブラリをインストールする場合、 <br> 例えば、ファイル pcre-8.42-ia64_64-11.31.depot`からインストールすると、64ビット版のライブラリのみが <br> /usr/local/lib/hpux64にインストールされます。 <br> この場合、エージェントのコンパイルを成功させるためには、以下のように "configure"のオプションをカスタマイズする必要があります。 <br> CFLAGS="+DD64" ./configure --enable-agent --with-libpcre-include=/usr/local/include--with-libpcre-lib=/usr/local/lib/hpux64 <br> #### Compiling Zabbix agent on HP-UX If you install the PCRE library from the popular HP-UX package site <http://hpux.connect.org.uk> (for example, from file `pcre-8.42-ia64_64-11.31.depot`), only the 64-bit version of the library will be installed in the `/usr/local/lib/hpux64` directory. In this case, for successful agent compilation, a customized option is needed for the `configure` script, for example: CFLAGS="+DD64" ./configure --enable-agent --with-libpcre-include=/usr/local/include --with-libpcre-lib=/usr/local/lib/hpux64 #### HP-UXでのZabbixエージェントのコンパイル HP-UXパッケージサイト<http://hpux.connect.org.uk>からPCREライブラリをインストールする場合(例えば`pcre-8.42-ia64_64-11.31.depot`から)、64bit版のライブラリのみが`/usr/local/lib/hpux64`ディレクトリにインストールされます。 この場合、エージェントのコンパイルを成功させるためには、以下のように`configure`スクリプトのオプションをカスタマイズする必要があります。 CFLAGS="+DD64" ./configure --enable-agent --with-libpcre-include=/usr/local/include --with-libpcre-lib=/usr/local/lib/hpux64 #### Compiling Zabbix The following steps will help you to compile Zabbix from sources on MS Windows 10 (64-bit). When compiling Zabbix with/without TLS support the only significant difference is in step 4. 1. On a Linux machine check out the source from git:`` $ git clone https://git.zabbix.com/scm/zbx/zabbix.git $ cd zabbix $ ./bootstrap.sh $ ./configure --enable-agent --enable-ipv6 --prefix=`pwd` $ make dbschema $ make dist `` 2. Copy and unpack the archive, e.g. zabbix-4.4.0.tar.gz, on a Windows machine. 3. Let's assume that sources are in e:\\zabbix-4.4.0. Open a commandline window e.g. the x64 Native Tools Command Prompt for VS 2017 RC. Go to E:\\zabbix-4.4.0\\build\\win32\\project. 4. Compile zabbix\_get, zabbix\_sender and zabbix\_agent. - without TLS: `E:\zabbix-4.4.0\build\win32\project> nmake /K PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib ` - with TLS: `E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_get TLS=openssl TLSINCDIR=C:\OpenSSL-Win64-111-static\include TLSLIBDIR=C:\OpenSSL-Win64-111-static\lib PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_sender TLS=openssl TLSINCDIR="C:\OpenSSL-Win64-111-static\include TLSLIBDIR="C:\OpenSSL-Win64-111-static\lib" PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_agent TLS=openssl TLSINCDIR=C:\OpenSSL-Win64-111-static\include TLSLIBDIR=C:\OpenSSL-Win64-111-static\lib PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib ` 5. New binaries are located in e:\\zabbix-4.4.0\\bin\\win64. Since OpenSSL was compiled with 'no-shared' option, Zabbix binaries contain OpenSSL within themselves and can be copied to other machines that do not have OpenSSL. #### Zabbixのコンパイル 次の手順は、MS Windows 10 (64bit)上のソースからZabbixをコンパイルするのに役立ちます。 TLSサポートの有無にかかわらずZabbixをコンパイルする場合、唯一の大きな違いはステップ4です。 1. Linuxマシンでgitからソースをチェックアウトします。`` $ git clone https://git.zabbix.com/scm/zbx/zabbix.git $ cd zabbix $ ./bootstrap.sh $ ./configure --enable-agent --enable-ipv6 --prefix=`pwd` $ make dbschema $ make dist `` 2. Windowsマシン上で、アーカイブをコピーして解凍します。例: zabbix-4.4.0.tar.gz。 3. ソースがe:\\zabbix-4.4.0にあると仮定します。コマンドラインウィンドウ、例えばx64 Native Tools Command Prompt for VS 2017を開き、E:\\zabbix-4.4.0\\build\\win32\\projectへ移動します。 4. zabbix\_get、zabbix\_sender、zabbix\_agentをコンパイルします。 - TLSなしの場合: `E:\zabbix-4.4.0\build\win32\project> nmake /K PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib ` - TLSありの場合: `E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_get TLS=openssl TLSINCDIR=C:\OpenSSL-Win64-111-static\include TLSLIBDIR=C:\OpenSSL-Win64-111-static\lib PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_sender TLS=openssl TLSINCDIR="C:\OpenSSL-Win64-111-static\include TLSLIBDIR="C:\OpenSSL-Win64-111-static\lib" PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_agent TLS=openssl TLSINCDIR=C:\OpenSSL-Win64-111-static\include TLSLIBDIR=C:\OpenSSL-Win64-111-static\lib PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib ` 5. 新しいバイナリはe:\\zabbix-4.4.0\\bin\\win64にあります。OpenSSLは'no-shared'オプションを使用してコンパイルされているため、ZabbixバイナリにはOpenSSLが含まれており、OpenSSLを持たない他のマシンにコピーできます。 #### Compiling Zabbix with LibreSSL The process is similar to compiling with OpenSSL, but you need to make small changes in files located in the `build\win32\project` directory: - In Makefile_tls delete `/DHAVE_OPENSSL_WITH_PSK`, i.e. find: ``` CFLAGS = $(CFLAGS) /DHAVE_OPENSSL /DHAVE_OPENSSL_WITH_PSK ``` and replace it with ``` CFLAGS = $(CFLAGS) /DHAVE_OPENSSL ``` - In Makefile_common.inc add `/NODEFAULTLIB:LIBCMT` i.e. find: ``` /MANIFESTUAC:"level='asInvoker' uiAccess='false'" /DYNAMICBASE:NO /PDB:$(TARGETDIR)\$(TARGETNAME).pdb ``` and replace it with ``` /MANIFESTUAC:"level='asInvoker' uiAccess='false'" /DYNAMICBASE:NO /PDB:$(TARGETDIR)\$(TARGETNAME).pdb /NODEFAULTLIB:LIBCMT ``` #### LibreSSLを使用したZabbixのコンパイル このプロセスはOpenSSLでのコンパイルに似ていますが、`build\win32\project`ディレクトリにあるファイルに小さな変更を加える必要があります。 - Makefile_tlsで`/DHAVE_OPENSSL_WITH_PSK`を削除します。つまり、 ``` CFLAGS = $(CFLAGS) /DHAVE_OPENSSL /DHAVE_OPENSSL_WITH_PSK ``` これを次のように置き換えます ``` CFLAGS = $(CFLAGS) /DHAVE_OPENSSL ``` - Makefile_common.incに`/NODEFAULTLIB:LIBCMT`を追加します。つまり、 ``` /MANIFESTUAC:"level='asInvoker' uiAccess='false'" /DYNAMICBASE:NO /PDB:$(TARGETDIR)\$(TARGETNAME).pdb ``` これを次のように置き換えます ``` /MANIFESTUAC:"level='asInvoker' uiAccess='false'" /DYNAMICBASE:NO /PDB:$(TARGETDIR)\$(TARGETNAME).pdb /NODEFAULTLIB:LIBCMT ``` #### Compressed content in web monitoring The ability to handle compressed content has been added to Zabbix web monitoring. All encoding formats supported by **libcurl** are supported. #### Web監視における圧縮コンテンツ ZabbixのWeb監視に圧縮コンテンツの処理機能が追加されました。**libcurl** でサポートされているすべてのエンコーディング形式がサポートされます。 #### Configurable fields The **key** is a unique item identifier (per host). You can create any key name using supported symbols. Calculation definition should be entered in the **Formula** field. There is virtually no connection between the formula and the key. The key parameters are not used in the formula in any way. The syntax of a simple formula is: function(/host/key,<parameter1>,<parameter2>,...) where: | | | |--|--------| |*function*|One of the [supported functions](/manual/appendix/functions): last, min, max, avg, count, etc| |*host*|Host of the item that is used for calculation.<br>The current host can be omitted (i.e. as in `function(//key,parameter,...)`).| |*key*|Key of the item that is used for calculation.| |*parameter(s)*|Parameters of the function, if required.| ::: noteimportant [User macros](/manual/config/macros/user_macros) in the formula will be expanded if used to reference a function parameter, item filter parameter, or a constant. User macros will NOT be expanded if referencing a function, host name, item key, item key parameter or operator. ::: A more complex formula may use a combination of functions, operators and brackets. You can use all functions and [operators](/manual/config/triggers/expression#operators) supported in trigger expressions. The logic and operator precedence are exactly the same. Unlike trigger expressions, Zabbix processes calculated items according to the item update interval, not upon receiving a new value. All items that are referenced by history functions in the calculated item formula must exist and be collecting data. Also, if you change the item key of a referenced item, you have to manually update any formulas using that key. A calculated item may become unsupported in several cases: - referenced item(s) - is not found - is disabled - belongs to a disabled host - is not supported (except with nodata() function and [operators](/manual/config/triggers/expression#operators) with unknown values) - no data to calculate a function - division by zero - incorrect syntax used #### 設定可能なフィールド **キー**は、(ホストごとに)一意なアイテム識別子です。サポートされているシンボルを使用して、任意のキー名を作成することができます。 計算の定義は、**式**の欄に入力してください。数式とキーの間には事実上何の関係もありません。<br> キーのパラメータは、数式では一切使用されません。 式の構文は以下の通りです。 function(/host/key,<parameter1>,<parameter2>,...) 上記構文の詳細 | | | |--|--------| |*function*|サポートされている関数の 1 つ: last、min、max、avg、count など| |*host*|計算に使用されるアイテムのホスト。<br>現在のホストは省略できます (つまり、`function(//key,parameter,...)` のように)。| |*key*|計算に使用されるアイテムのキー。| |*parameter(s)*|必要な場合、関数のパラメーター。| ::: noteimportant 数式内の[ユーザー マクロ](/manual/config/macros/user_macros)は、関数パラメータ、アイテムフィルタパラメータ、または定数を参照するために使用される場合、展開されます。関数、ホスト名、アイテム キー、アイテム キー パラメータ、または演算子を参照する場合、ユーザー マクロは展開されません。 ::: より複雑な式では、関数、演算子、および括弧を組み合わせて使用することができます。トリガー式でサポートされている<br> すべての関数と演算子 [operators](/manual/config/triggers/expression#operators)を使用することができます。<br> ロジックと演算子の優先順位は全く同じです。 Zabbixはトリガー条件式とは異なり、新しい値を受け取った時ではなく、アイテムの更新間隔に従って計算されたアイテムを処理します。 計算アイテムの式の中でヒストリ関数によって参照されるアイテムは、すべて存在しデータを収集している必要があります。<br> また、参照されるアイテムのアイテムキーを変更した場合、そのキーを使用しているすべての数式を手動で更新する必要があります。 計算されたアイテムは、いくつかのケースで取得不可になることがあります: - 参照されたアイテムが以下の場合 - 見つからない - 無効 - 無効なホストのアイテム - 取得不可(except with nodata() function and [operators](/manual/config/triggers/expression#operators) with unknown values) - 関数を計算するためのデータない - ゼロ除算 - 不正な構文の使用 ### Configurable TLS and connection parameters in MQTT plugin The [MQTT plugin](/manual/appendix/config/zabbix_agent2_plugins/mqtt_plugin) for Zabbix agent 2 now provides additional configuration options, which can be defined in the plugin configuration file as [named session](/manual/config/items/plugins#named-sessions) or [default](/manual/config/items/plugins#default-values) parameters: - Connection-related parameters: broker URL, topic, username, and password; - TLS encryption parameters: location of the top-level CA(s) certificate, MQTT certificate or certificate chain, private key. All of the new parameters are optional. ### MQTTプラグインで設定可能なTLSおよび接続パラメーター Zabbixエージェント2の[MQTTプラグイン](/manual/appendix/config/zabbix_agent2_plugins/mqtt_plugin)に設定オプションが追加されました。追加されたオプションは、プラグイン設定ファイルで[名前付きセッション](/manual/config/items/plugins#named-sessions)または[デフォルト](/manual/config/items/plugins#default-values)パラメーターとして定義することが可能です。 - 接続関連のパラメーター: ブローカーURL、トピック、ユーザー名、パスワード - TLS暗号化パラメーター: 最上位のCA証明書、MQTT証明書または証明書チェーンの場所、プライベートキー 新しいパラメーターはすべて省略可能です。 #### Configuration #### 設定 #### Configuration #### 設定 #### Configuration #### 設定 #### Configuration #### 設定 #### Configuration #### 設定 #### Configuration #### 設定 #### Configuration #### 設定 #### Configuration #### 設定 ### Configuration 1. Create disabled Script item on the main VMware host (where the **eventlog[]** item is present) with the following parameters:  - *Name*: VMware metrics - *Type*: Script - *Key*: vmware.metrics - *Type of information*: Text - *Script*: copy and paste the [script](#script) provided below - *Timeout*: 10 - *History storage period*: Do not keep history - *Enabled*: unmarked #### Script try { Zabbix.log(4, 'vmware metrics script'); var result, resp, req = new HttpRequest(); req.addHeader('Content-Type: application/xml'); req.addHeader('SOAPAction: "urn:vim25/6.0"'); login = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:Login>\ <urn:_this type="SessionManager">SessionManager</urn:_this>\ <urn:userName>{$VMWARE.USERNAME}</urn:userName>\ <urn:password>{$VMWARE.PASSWORD}</urn:password>\ </urn:Login>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}", login); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } query = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:RetrieveProperties>\ <urn:_this type="PropertyCollector">propertyCollector</urn:_this>\ <urn:specSet>\ <urn:propSet>\ <urn:type>PerformanceManager</urn:type>\ <urn:pathSet>perfCounter</urn:pathSet>\ </urn:propSet>\ <urn:objectSet>\ <urn:obj type="PerformanceManager">PerfMgr</urn:obj>\ </urn:objectSet>\ </urn:specSet>\ </urn:RetrieveProperties>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}", query); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } Zabbix.log(4, 'vmware metrics=' + resp); result = resp; logout = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:Logout>\ <urn:_this type="SessionManager">SessionManager</urn:_this>\ </urn:Logout>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}",logout); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } } catch (error) { Zabbix.log(4, 'vmware call failed : '+error); result = {}; } return result; Once the item is configured, press *Test* button, then press *Get value*. {width=600} Copy received XML to any XML formatter and find the desired metric. An example of XML for one metric: <PerfCounterInfo xsi:type="PerfCounterInfo"> <key>6</key> <nameInfo> <label>Usage in MHz</label> <summary>CPU usage in megahertz during the interval</summary> <key>usagemhz</key> </nameInfo> <groupInfo> <label>CPU</label> <summary>CPU</summary> <key>cpu</key> </groupInfo> <unitInfo> <label>MHz</label> <summary>Megahertz</summary> <key>megaHertz</key> </unitInfo> <rollupType>average</rollupType> <statsType>rate</statsType> <level>1</level> <perDeviceLevel>3</perDeviceLevel> </PerfCounterInfo> Use XPath to extract the counter path from received XML. For the example above, the XPath will be: |field |xPath | value | |--|--|--| |group | //groupInfo[../key=6]/key | cpu | |counter |//nameInfo[../key=6]/key |usagemhz | |rollup |//rollupType[../key=6] |average | Resulting performance counter path in this case is: `cpu/usagemhz[average]` ### 設定 1. 次のパラメーターを使用して、メインの VMware ホスト (**eventlog[]** アイテムが存在する場所) で無効化されたスクリプト アイテムを作成します。  - *名前*: VMware metrics - *タイプ*: スクリプト - *キー*: vmware.metrics - *データ型*: テキスト - *スクリプト*: 以下の [スクリプト](#スクリプト) をコピーして貼り付けます - *タイムアウト*: 10 - *ヒストリの保存期間*: ヒストリを保持しない - *有効*: チェックしない #### スクリプト try { Zabbix.log(4, 'vmware metrics script'); var result, resp, req = new HttpRequest(); req.addHeader('Content-Type: application/xml'); req.addHeader('SOAPAction: "urn:vim25/6.0"'); login = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:Login>\ <urn:_this type="SessionManager">SessionManager</urn:_this>\ <urn:userName>{$VMWARE.USERNAME}</urn:userName>\ <urn:password>{$VMWARE.PASSWORD}</urn:password>\ </urn:Login>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}", login); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } query = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:RetrieveProperties>\ <urn:_this type="PropertyCollector">propertyCollector</urn:_this>\ <urn:specSet>\ <urn:propSet>\ <urn:type>PerformanceManager</urn:type>\ <urn:pathSet>perfCounter</urn:pathSet>\ </urn:propSet>\ <urn:objectSet>\ <urn:obj type="PerformanceManager">PerfMgr</urn:obj>\ </urn:objectSet>\ </urn:specSet>\ </urn:RetrieveProperties>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}", query); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } Zabbix.log(4, 'vmware metrics=' + resp); result = resp; logout = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\ <soapenv:Header/>\ <soapenv:Body>\ <urn:Logout>\ <urn:_this type="SessionManager">SessionManager</urn:_this>\ </urn:Logout>\ </soapenv:Body>\ </soapenv:Envelope>' resp = req.post("{$VMWARE.URL}",logout); if (req.getStatus() != 200) { throw 'Response code: '+req.getStatus(); } } catch (error) { Zabbix.log(4, 'vmware call failed : '+error); result = {}; } return result; 項目を設定後、*テスト* ボタンを押して、*値の取得* を押します。 {width=600} 受信した XML を任意の XML フォーマッターにコピーし、目的のメトリックを見つけます。 1 つのメトリックの XML の例: <PerfCounterInfo xsi:type="PerfCounterInfo"> <key>6</key> <nameInfo> <label>Usage in MHz</label> <summary>CPU usage in megahertz during the interval</summary> <key>usagemhz</key> </nameInfo> <groupInfo> <label>CPU</label> <summary>CPU</summary> <key>cpu</key> </groupInfo> <unitInfo> <label>MHz</label> <summary>Megahertz</summary> <key>megaHertz</key> </unitInfo> <rollupType>average</rollupType> <statsType>rate</statsType> <level>1</level> <perDeviceLevel>3</perDeviceLevel> </PerfCounterInfo> XPath を使用して、受信した XML からカウンター パスを抽出します。 上記の例では、XPath は次のようになります: |フィールド|xPath | 値 | |--|--|--| |group | //groupInfo[../key=6]/key | cpu | |counter |//nameInfo[../key=6]/key |usagemhz | |rollup |//rollupType[../key=6] |average | この結果の場合のパフォーマンス カウンター パスは次のとおりです: `cpu/usagemhz[average]` #### Configuration  ::: noteclassic In cases when a user does not have permission to access certain widget elements, that element's name will appear as *Inaccessible* during the widget's configuration. This results in *Inaccessible Item, Inaccessible Host, Inaccessible Group, Inaccessible Map, and Inaccessible Graph* appearing instead of the "real" name of the element. ::: In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Enter host groups to display in the widget. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Host data from these host groups will be displayed in the widget. If no host groups are entered, all host groups will be displayed.| |*Exclude host groups*|Enter host groups to hide from the widget. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Host data from these host groups will not be displayed in the widget. For example, hosts 001, 002, 003 may be in Group A and hosts 002, 003 in Group B as well. If we select to *show* Group A and *exclude* Group B at the same time, only data from host 001 will be displayed in the Dashboard.| |*Hosts*|Enter hosts to display in the widget. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts.<br>If no hosts are entered, all hosts will be displayed.| |*Tags*|Specify tags to limit the number of web scenarios displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met| |*Show hosts in maintenance*|Include hosts that are in maintenance in the statistics.| #### 設定  ::: noteclassic ユーザーが特定のウィジェット要素にアクセスする権限を持っていない場合、その要素の名前はウィジェットの構成中に*アクセス不能*として表示されます。 これにより要素の*実際の*名前の代わりに、*アクセスできないアイテム、アクセスできないホスト、アクセスできないグループ、アクセスできないマップ、およびアクセスできないグラフ*が表示されます。 ::: すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。 |パラメーター|詳細| |--|--------| |*ホストグループ*|ウィジェットに表示するホストグループを入力します。 このフィールドはオートコンプリートであるため、グループ名を入力し始めると、一致するグループ名がドロップダウンで表示されます。<br>親ホストグループを指定すると、ネストされたすべてのホストグループが暗黙的に選択され、ホストデータがウィジェットに表示されます。 ホストグループが入力されていない場合、すべてのホストグループが表示されます。| |*除外するホストグループ*|ウィジェットから非表示にするホストグループを入力します。このフィールドはオートコンプリートであるため、グループ名を入力し始めると、一致するグループ名がドロップダウンで表示されます。<br>親ホストグループを指定すると、ネストされたすべてのホストグループが暗黙的に選択されます。<br>これらのホストグループからのホストデータはウィジェットに表示されますが、たとえばホスト001、002、003はグループAにあり、ホスト002、003もグループBにあるとします。その上でグループAを*表示*し、グループBを*除外*した場合、ホスト001からのデータのみがダッシュボードに表示されます。| |*ホスト*|ウィジェットに表示するホストを入力します。このフィールドはオートコンプリートであるため、ホストの名前を入力し始めると、一致するホスト名がドロップダウンで表示されます。<br>ホスト名が入力されていない場合は、すべてのホストが表示されます。| |*タグ*|タグを指定して、ウィジェットに表示されるWebシナリオの数を制限します。 特定のタグとタグ値を含めたり除外したりすることができます。 いくつかの条件を設定できます。 タグ名の照合では常に大文字と小文字が区別されます。<br>各条件で使用できる演算子はいくつかあります。<br>**Exists** - 指定されたタグ名を含める<br>**Equals** - 指定されたタグ名と値を含める（大文字と小文字を区別）<br> **Contains** - タグ値に入力された文字列が含まれる場合に指定されたタグ名を含める（文字列の部分一致、大文字と小文字を区別しない）<br>**Does not exist** - 指定されたタグ名を除外する<br>**Does not equal**-指定されたタグ名と値を除外する（大文字と小文字を区別）<br>**Does not contain** - タグ値に入力された文字列が含まれる指定されたタグ名を除外する（文字列の部分一致、大文字と小文字を区別しない）<br>条件には2つの計算タイプがあります：<br>**And/Or** - すべての条件が満たされる必要があり、同じタグ名を持つ条件はOr条件によってグループ化されます<br >**Or** - 1つの条件が満たされる| |*メンテナンス中のホストを表示*|メンテナンス中のホストを統計に含めます。| #### Configuration Debug mode can be activated for individual users who belong to a user group: - when configuring a [user group](/manual/config/users_and_usergroups/usergroup#configuration); - when viewing configured [user groups](//manual/web_interface/frontend_sections/administration/user_groups). When *Debug mode* is enabled for a user group, its users will see a *Debug* button in the lower right corner of the browser window:  Clicking on the *Debug* button opens a new window below the page contents which contains the SQL statistics of the page, along with a list of API calls and individual SQL statements: {width="600"} In case of performance problems with the page, this window may be used to search for the root cause of the problem. ::: notewarning Enabled *Debug mode* negatively affects frontend performance. ::: #### 設定 デバッグモードは、ユーザーグループに属する個々のユーザーに対してアクティブ化できます。 - [ユーザーグループ](/manual/config/users_and_usergroups/usergroup#configuration)で設定する。 - 設定された[ユーザーグループ](/manual/web_interface/frontend_sections/administration/user_groups)を表示する。 ユーザーグループに対して*デバッグモード*が有効になっている場合、そのユーザーにはブラウザウィンドウの右下隅に*デバッグ*ボタンが表示されます。  *デバッグ*ボタンをクリックすると、ページコンテンツの下に新しいウィンドウが開きます。このウィンドウには、API呼び出しと個々のSQLステートメントのリストとともにページのSQL統計が含まれています。 {width="600"} ページに問題がある場合は、このウィンドウを使用して問題の原因を調査できます。 ::: notewarning *デバッグモード*を有効にするとフロントエンドのパフォーマンスに悪影響を及ぼします。 ::: #### Configuration examples After setting up the necessary certificates, configure Zabbix components to use certificate-based encryption. Below are detailed steps for configuring: - [Zabbix server](#zabbix-server) - [Zabbix proxy](#zabbix-proxy) - [Zabbix agent](#zabbix-agent) #### 設定例 必要な証明書を設定したら、証明書ベースの暗号化を使用するようにZabbixコンポーネントを設定します。 設定手順の詳細は以下のとおりです。 - [Zabbixサーバー](#zabbix-server) - [Zabbixプロキシ](#zabbix-proxy) - [Zabbixエージェント](#zabbix-agent) # configuration.export # configuration.export #### Configuration file For details on configuring Zabbix agent see the configuration file options for [zabbix\_agentd](/manual/appendix/config/zabbix_agentd) or [Windows agent](/manual/appendix/config/zabbix_agentd_win). #### 設定ファイル Zabbixエージェントの設定の詳細については、[Zabbixエージェント (UNIX)](/manual/appendix/config/zabbix_agentd)または [Zabbixエージェント (Windows)](/manual/appendix/config/zabbix_agentd_win)の設定ファイルのオプションを参照してください。 ##### Configuration file See the [configuration file](/manual/appendix/config/zabbix_proxy) options for details on configuring zabbix\_proxy. ##### 設定ファイル zabbix\_proxyの詳細設定については[設定ファイル](/manual/appendix/config/zabbix_proxy)オプションを参照してください。 ##### Configuration file See the [configuration file](/manual/appendix/config/zabbix_server) options for details on configuring zabbix\_server. ##### 設定ファイル zabbix\_serverの設定の詳細は、[設定ファイル](/manual/appendix/config/zabbix_server)を参照してください。 #### Configuration file The configuration parameters of agent 2 are mostly compatible with Zabbix agent with some exceptions. |New parameters|Description| |--|--------| |*ControlSocket*|The runtime control socket path. Agent 2 uses a control socket for [runtime commands](#runtime_control).| |*EnablePersistentBuffer*,<br>*PersistentBufferFile*,<br>*PersistentBufferPeriod*|These parameters are used to configure persistent storage on agent 2 for active items.| |*ForceActiveChecksOnStart*|Determines whether the agent should perform active checks immediately after restart or spread evenly over time. Supported since Zabbix 6.0.2.| |*Plugins*|Plugins may have their own parameters, in the format `Plugins.<Plugin name>.<Parameter>=<value>`. A common plugin parameter is *System.Capacity*, setting the limit of checks that can be executed at the same time.| |*StatusPort*|The port agent 2 will be listening on for HTTP status request and display of a list of configured plugins and some internal parameters| |**Dropped parameters**|**Description**| |*AllowRoot*, *User*|Not supported because daemonization is not supported.| |*LoadModule*, *LoadModulePath*|Loadable modules are not supported.| |*StartAgents*|This parameter was used in Zabbix agent to increase passive check concurrency or disable them. In Agent 2, the concurrency is configured at a plugin level and can be limited by a capacity setting. Whereas disabling passive checks is not currently supported.| |*HostInterface*, *HostInterfaceItem*|Not yet supported.| For more details see the configuration file options for [zabbix\_agent2](/manual/appendix/config/zabbix_agent2). #### 設定ファイル Zabbixエージェント2の設定パラメーターは、いくつかの例外を除いて、Zabbixエージェントと互換性があります。 |新しいパラメーター|説明| |--|--------| |*ControlSocket*|ランタイム制御ソケットパス。エージェント2は[ランタイムコマンド](#ランタイム制御)に制御ソケットを使用します。| |*EnablePersistentBuffer*,<br>*PersistentBufferFile*,<br>*PersistentBufferPeriod*|これらのパラメーターは、アクティブなアイテムのエージェント2の永続ストレージを設定するために使用されます。| |*ForceActiveChecksOnStart*|エージェントがアクティブチェックを再起動直後に実行するか、時間経過で均等に分散実行するかを決定します。 Zabbix6.0.2以降でサポートされています。| |*Plugins*|プラグインは`Plugins.<プラグイン名>.<Parameter>=<value>`の形式で独自のパラメーターを設定できます。一般的なプラグインパラメーターは*System.Capacity*で、同時に実行できるチェックの制限を設定します。| |*StatusPort*|ポートエージェント2は、HTTPステータスリクエストをリッスンし、設定されたプラグインといくつかの内部パラメーターのリストを表示します。| |**削除されたパラメーター**|**説明**| |*AllowRoot*, *User*|デーモン化がサポートされていないため、サポートされていません。| |*LoadModule*, *LoadModulePath*|ロードモジュールはサポートされていません。| |*StartAgents*|このパラメーターは、Zabbixエージェントではパッシブチェックの同時実行性を高めたり無効にしたりするために使用されていました。エージェント2では、同時実行はプラグインレベルで設定され、容量設定によって制限できます。一方、パッシブチェックの無効化は現在サポートされていません。| |*HostInterface*, *HostInterfaceItem*|まだサポートされていません。| 詳細については[zabbix\_agent2](/manual/appendix/config/zabbix_agent2)の設定ファイルオプションを参照してください。 #### Configuration Global notifications can be enabled per user in the *Messaging* tab of [profile configuration](/manual/web_interface/user_profile).  |Parameter|Description| |---------|-----------| |*Frontend messaging*|Mark the checkbox to enable global notifications.| |*Message timeout*|You can set for how long the message will be displayed. By default, messages will stay on screen for 60 seconds.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 5m, 2h, 1d.| |*Play sound*|You can set how long the sound will be played.<br>**Once** - sound is played once and fully.<br>**10 seconds** - sound is repeated for 10 seconds.<br>**Message timeout** - sound is repeated while the message is visible.| |*Trigger severity*|You can set the trigger severities that global notifications and sounds will be activated for. You can also select the sounds appropriate for various severities.<br>If no severity is marked then no messages will be displayed at all.<br>Also, recovery messages will only be displayed for those severities that are marked. So if you mark *Recovery* and *Disaster*, global notifications will be displayed for the problems and the recoveries of disaster severity triggers.| |*Show suppressed problems*|Mark the checkbox to display notifications for problems which would otherwise be suppressed (not shown) because of host maintenance.| #### 設定 [プロファイル設定](/manual/web_interface/user_profile)の*メッセージ*タブで、ユーザーごとにグローバル通知を有効にできます  |パラメーター|説明| |---------|-----------| |*Frontend messaging*|チェックボックスをオンにすると、グローバル通知が有効になります。| |*Message timeout*|メッセージ表示時間を設定できます。デフォルトでは60秒間画面に表示されたままになります。<br>[タイムサフィックス](/manual/appendix/suffixes)を使用可能です。例：30s, 5m, 2h, 1d.| |*Play sound*|サウンドの再生時間を設定できます。<br>**Once** - サウンドは一度だけ全て再生されます。<br>**10 seconds** - サウンドが10秒間繰り返されます。<br>**Message timeout** - メッセージが表示されている間、サウンドが繰り返されます。| |*Trigger severity*|グローバル通知とサウンドがアクティブ化されるトリガーの重大度を設定できます。さまざまな重大度に対応したサウンドを選択することもできます。<br>重大度がマークされていない場合、メッセージは表示されません。<br>また、回復メッセージは、マークされている重大度に対してのみ表示されます。したがって、*回復*と*災害*をマークすると、問題と災害重大度トリガーの回復に関するグローバル通知が表示されます。| |*Show suppressed problems*|チェックボックスをオンにすると、ホストのメンテナンスのために抑制される（表示されない）問題の通知が表示されます。| # configuration.import # configuration.import # configuration.importcompare # configuration.importcompare ### Configuration import Previously, the import process would fail on a UUID mismatch of an importable entity (host group, item, graph, etc). For example, it was not possible to import a host group if a host group with the same name already existed on the host. In the new version the import will not fail because of a UUID mismatch; instead the entity will be matched by the uniqueness criteria such as entity ID (name). The entity will be imported, and the UUID will be updated to the UUID of the imported entity. In another improvement, when removing template linkage (the *Delete missing* option for template linkage) through the imported template or host, the inherited entities of the unlinked template are no longer removed (template gets unlinked, not unlinked and cleared), unless these entities are missing in the import file **and** the *Delete missing* option for the specific entity is marked. Due to this change, the warning message when marking the *Delete missing* option for template linkage will no longer be displayed. ### 設定のインポート 以前は、インポート可能な設定情報(ホストグループ、アイテム、グラフなど)のUUIDの不一致により、インポートの処理が失敗することがありました。例えば、同じ名前のホストグループがホストに既に存在している場合、ホストグループをインポートすることができませんでした。 新しいバージョンでは、UUIDの不一致が原因でインポートが失敗することはありません。代わりに、エンティティはエンティティID(名前)などの一意性条件によって照合されます。エンティティがインポートされると、UUIDはインポートされたエンティティのUUIDに更新されます。 別の改善点として、インポートされたテンプレートまたはホストを介してテンプレートのリンクを削除(テンプレートのリンクの*存在しない場合に削除*オプション)すると、これらのエンティティがインポートファイルから欠落し、**かつ**特定のエンティティの*存在しない場合に削除*オプションがマークされていない限り、リンクされていないテンプレートの継承されたエンティティは削除されなくなります(テンプレートはリンク解除され、リンク解除およびクリアされません)。 この変更により、テンプレートのリンクの*存在しない場合に削除*オプションを選択した場合の警告メッセージは表示されなくなります。 ### Configuration import See changes in the [configuration import](/manual/introduction/whatsnew6013#configuration-import) process. ### 設定のインポート [設定のインポート](/manual/introduction/whatsnew6013#設定のインポート)プロセスの変更を参照してください。 #### Configuration In order to enable maintenance mode, the `maintenance.inc.php` file (located in `/conf` of Zabbix HTML document directory on the web server) must be modified to uncomment the following lines: // Maintenance mode. define('ZBX_DENY_GUI_ACCESS', 1); // Array of IP addresses, which are allowed to connect to frontend (optional). $ZBX_GUI_ACCESS_IP_RANGE = array('127.0.0.1'); // Message shown on warning screen (optional). $ZBX_GUI_ACCESS_MESSAGE = 'We are upgrading MySQL database till 15:00. Stay tuned...'; #### 設定 メンテナンスモードを有効にするには`maintenance.inc.php`ファイル（WebサーバーのZabbix HTMLドキュメントディレクトリの/confにあります）を変更して、次の行のコメントを解除する必要があります： // Maintenance mode. define('ZBX_DENY_GUI_ACCESS', 1); // Array of IP addresses, which are allowed to connect to frontend (optional). $ZBX_GUI_ACCESS_IP_RANGE = array('127.0.0.1'); // Message shown on warning screen (optional). $ZBX_GUI_ACCESS_MESSAGE = 'We are upgrading MySQL database till 15:00. Stay tuned...'; #### Configuration In the *Type* field of [item configuration form](/manual/config/items/item) select Script then fill out required fields.  All mandatory input fields are marked with a red asterisk. The fields that require specific information for Script items are: |Field|Description| |-----|-----------| |Key|Enter a unique key that will be used to identify the item.| |Parameters|Specify the variables to be passed to the script as the attribute and value pairs.<br>[Built-in macros](/manual/config/macros) {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.IP}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG} and [user macros](/manual/config/macros/user_macros) are supported.| |Script|Enter JavaScript code in the block that appears when clicking in the parameter field (or on the view/edit button next to it). This code must provide the logic for returning the metric value.<br>The code has access to all parameters, it may perform HTTP GET, POST, PUT and DELETE requests and has control over HTTP headers and request body.<br>See also: [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects), [JavaScript Guide](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide).| |Timeout|JavaScript execution timeout (1-60s, default 3s).<br>Time suffixes are supported, e.g. 30s, 1m.| #### Configuration In the *Type* field of [item configuration form](/manual/config/items/item) select Script then fill out required fields.  All mandatory input fields are marked with a red asterisk. The fields that require specific information for Script items are: |Field|Description| |-----|-----------| |Key|Enter a unique key that will be used to identify the item.| |Parameters|Specify the variables to be passed to the script as the attribute and value pairs.<br>[Built-in macros](/manual/config/macros) {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.IP}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG} and [user macros](/manual/config/macros/user_macros) are supported.| |Script|Enter JavaScript code in the block that appears when clicking in the parameter field (or on the view/edit button next to it). This code must provide the logic for returning the metric value.<br>The code has access to all parameters, it may perform HTTP GET, POST, PUT and DELETE requests and has control over HTTP headers and request body.<br>See also: [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects), [JavaScript Guide](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide).| |Timeout|JavaScript execution timeout (1-60s, default 3s).<br>Time suffixes are supported, e.g. 30s, 1m.| #### Configuration In the *Type* field of [item configuration form](/manual/config/items/item) select Script then fill out required fields.  All mandatory input fields are marked with a red asterisk. The fields that require specific information for Script items are: |Field|Description| |-----|-----------| |Key|Enter a unique key that will be used to identify the item.| |Parameters|Specify the variables to be passed to the script as the attribute and value pairs.<br>[Built-in macros](/manual/config/macros) {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.IP}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG} and [user macros](/manual/config/macros/user_macros) are supported.| |Script|Enter JavaScript code in the block that appears when clicking in the parameter field (or on the view/edit button next to it). This code must provide the logic for returning the metric value.<br>The code has access to all parameters, it may perform HTTP GET, POST, PUT and DELETE requests and has control over HTTP headers and request body.<br>See also: [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects), [JavaScript Guide](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide).| |Timeout|JavaScript execution timeout (1-60s, default 3s); exceeding it will return error.<br>Time suffixes are supported, e.g. 30s, 1m.<br>Depending on the script it might take longer for the timeout to trigger. | #### 設定 [item configuration form](/manual/config/items/item)の*Type*フィールドでScriptを選択し、必要事項を入力します。  すべての必須入力項目には、赤いアスタリスクが付けられています。 スクリプトアイテムで特定の情報を必要とするフィールドは次のとおりです。 |フィールド|説明| |-----|-----------| |Key|Enter a unique key that will be used to identify the item.| |Parameters|Specify the variables to be passed to the script as the attribute and value pairs.<br>[Built-in macros](/manual/config/macros) {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.IP}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG} and [user macros](/manual/config/macros/user_macros) are supported.| |Script|Enter JavaScript code in the block that appears when clicking in the parameter field (or on the view/edit button next to it). This code must provide the logic for returning the metric value.<br>The code has access to all parameters, it may perform HTTP GET, POST, PUT and DELETE requests and has control over HTTP headers and request body.<br>See also: [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects), [JavaScript Guide](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide).| |Timeout|JavaScript execution timeout (1-60s, default 3s); exceeding it will return error.<br>Time suffixes are supported, e.g. 30s, 1m.<br>Depending on the script it might take longer for the timeout to trigger. | #### Configuration ::: noteimportant Only Super admin users can create host groups. ::: There are two options of creating a host group in Zabbix frontend. **Option one**: - Go to: *Configuration* → *Host groups* - Click on *Create Group* in the upper right corner of the screen - Enter the group name in the form  **Option two**: when [configuring a host](/manual/config/hosts/host#configuration), enter a non-existing group name in the *Groups* input field. Once the host group is created, you can click on the group name in the list under *Configuration* → *Host groups* to edit the group name, clone the group, or delete the group. Deleting a host group only deletes the logical group, not the hosts in the group. It is not possible to delete a host group that is the only group for any existing host. #### 設定 ::: noteimportant Super adminユーザーのみがホストグループを作成できます。 ::: Zabbixフロントエンドでホストグループを作成するには、2つの選択肢があります。 **選択肢1**: - 次の場所に移動します: *設定* → *ホストグループ* - 画面の右上隅にある*ホストグループの作成*をクリックします - フォームにグループ名を入力します  **選択肢2**: [ホストの設定](/manual/config/hosts/host#configuration)時に、*グループ*入力フィールドに存在しないグループ名を入力します。 ホストグループが作成されると、*設定* → *ホストグループ*の下のリストでグループ名をクリックして、グループ名を編集したり、グループを複製したり、グループを削除したりできます。 ホストグループを削除すると、論理グループのみが削除され、グループ内のホストは削除されません。既存のホストの唯一のグループであるホストグループは削除することはできません。 #### Configuration ODBC configuration is done by editing **odbcinst.ini** and **odbc.ini** files. These configuration files can be found in */etc* folder. The file **odbcinst.ini** may be missing and in this case it is necessary to create it manually. **odbcinst.ini** [mysql] Description = General ODBC for MySQL Driver = /usr/lib64/libmyodbc5.so Setup = /usr/lib64/libodbcmyS.so FileUsage = 1 Please consider the following examples of **odbc.ini** configuration parameters. - An example with a connection through an IP: ```{=html} <!-- --> ``` [TEST_MYSQL] Description = MySQL database 1 Driver = mysql Port = 3306 Server = 127.0.0.1 - An example with a connection through an IP and with the use of credentials. A Zabbix database is used by default: ```{=html} <!-- --> ``` [TEST_MYSQL_FILLED_CRED] Description = MySQL database 2 Driver = mysql User = root Port = 3306 Password = zabbix Database = zabbix Server = 127.0.0.1 - An example with a connection through a socket and with the use of credentials. A Zabbix database is used by default: ```{=html} <!-- --> ``` [TEST_MYSQL_FILLED_CRED_SOCK] Description = MySQL database 3 Driver = mysql User = root Password = zabbix Socket = /var/run/mysqld/mysqld.sock Database = zabbix All other possible configuration parameter options can be found in [MySQL official documentation](https://dev.mysql.com/doc/connector-odbc/en/connector-odbc-configuration-connection-parameters.html) web page. #### 設定 ODBCの設定は、**odbcinst.ini** と **odbc.ini** ファイルを編集することによって行われます。<br> これらの設定ファイルは、*/etc* フォルダーにあります。**odbcinst.ini** ファイルが存在しない場合があり、<br> この場合は手動で作成する必要があります。 **odbcinst.ini** [mysql] Description = General ODBC for MySQL Driver = /usr/lib64/libmyodbc5.so Setup = /usr/lib64/libodbcmyS.so FileUsage = 1 以下の**odbc.ini**の設定パラメータの例をご検討ください。 - IP接続の例: ```{=html} <!-- --> ``` [TEST_MYSQL] Description = MySQL database 1 Driver = mysql Port = 3306 Server = 127.0.0.1 - IP接続とクレデンシャルを使用した場合の例です。デフォルトでZabbixデータベースを使用します。 ```{=html} <!-- --> ``` [TEST_MYSQL_FILLED_CRED] Description = MySQL database 2 Driver = mysql User = root Port = 3306 Password = zabbix Database = zabbix Server = 127.0.0.1 ソケットを使用した接続とクレデンシャルを使用した例です。デフォルトでは、Zabbixデータベースを使用します。 ```{=html} <!-- --> ``` [TEST_MYSQL_FILLED_CRED_SOCK] Description = MySQL database 3 Driver = mysql User = root Password = zabbix Socket = /var/run/mysqld/mysqld.sock Database = zabbix その他の設定パラメータオプションは、[MySQL official documentation](https://dev.mysql.com/doc/connector-odbc/en/connector-odbc-configuration-connection-parameters.html)のウェブページを参照してください。 ### Configuration Once you have [installed](/manual/installation/install) and [configured](/manual/appendix/config/zabbix_proxy) a proxy, it is time to configure it in the Zabbix frontend. ### 設定 Zabbix プロキシサーバーを[インストール](/manual/installation/install)して[設定](/manual/appendix/config/zabbix_proxy)したのち、Zabbixフロントエンドでプロキシの設定をします。 #### Configuration Overall, the process of setting up the notification should feel familiar to those who have set up alerts in Zabbix before. #### 設定 おおまかには通知を設定するプロセスは以前に Zabbix でアラートを設定したことがある人には馴染みのあるものです。 #### Configuration parameters For Zabbix server/proxy new configuration parameters have been added for Vault authentication and retrieving database credentials: - VaultToken - Vault authentication token (see Zabbix [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) configuration file for details) - VaultURL - Vault server HTTP\[S\] URL - VaultDBPath - Vault path from where credentials for database will be retrieved by keys 'password' and 'username' (for example: secret/zabbix/database) Zabbix server and Zabbix proxy read the Vault-related configuration parameters from zabbix\_server.conf and zabbix\_proxy.conf upon startup. Zabbix server and Zabbix proxy will additionally read "VAULT\_TOKEN" environment variable once during startup and unset it so that it would not be available through forked scripts; it is an error if both VaultToken and VAULT\_TOKEN contain value. ::: noteclassic Forward slash and colon are reserved symbols. Forward slash can only be used to separate mount point from path (e.g. secret/zabbix where mount point is "secret" and "zabbix" is path) and, in case of Vault macros, colon can only be used to separate path from key. It is possible to URL-encode "/" and ":" if there is need to create mount point with name that is separated by forward slash (e.g. foo/bar/zabbix where mount point is "foo/bar" and path is "zabbix" as "foo%2Fbar/zabbix") and if mount point name or path needs to contain colon. ::: #### 設定パラメータ Zabbix server / proxy に、Vault認証とデータベース認証情報の取得のための新しい設定パラメータが追加されました。: - VaultToken - Vault認証トークン(詳細はZabbix [server](/manual/appendix/config/zabbix_server) / [proxy](/manual/appendix/config/zabbix_proxy) 設定ファイルを参照してください) - VaultURL - Vault サーバの HTTP\[S\] URL - VaultDBPath - データベースの認証情報を取得するための Vault のパス(例: secret/zabbix/database) Zabbix server とZabbix proxy は、起動時に zabbix\_server.conf と zabbix\_proxy.conf から Vaul t関連の設定パラメータを<br> 読み取ります。 Zabbix server と Zabbix proxy は、起動時に VAULT_TOKEN 環境変数を読み込み、フォークされたスクリプトで<br> 使用できないように設定を解除します。 ::: noteclassic フォワードスラッシュとコロンは予約済みシンボルです。フォワードスラッシュは、マウントポイントとパスの区切りにのみ<br> 使用できます(例: secret/zabbix はマウントポイントが secret、zabbix がパス)<br> Vault マクロの場合、パスとキーの区切りにはコロンのみを使用できます。マウントポイントをフォワードスラッシュで<br> 区切った名前で作成する必要がある場合(例:マウントポイントが "foo/bar"、パスが "zabbix" の場合は "foo%2Fbar/zabbix" )、 マウントポイント名またはパスにコロンが必要な場合は "/" ":" をURLエンコードすることが可能です。 ::: #### Configuration Providing you have the HTTP master item configured, you need to create a [dependent item](/manual/config/items/itemtypes/dependent_items) that uses a Prometheus preprocessing step: - Enter general dependent item parameters in the configuration form - Go to the Preprocessing tab - Select a Prometheus preprocessing option (*Prometheus pattern* or *Prometheus to JSON*)  The following parameters are specific to the *Prometheus pattern* preprocessing option: |Parameter|Description|Examples| |---------|-----------|--------| |*Pattern*|To define the required data pattern you may use a query language that is similar to Prometheus query language (see [comparison table](#query-language-comparison)), e.g.:<br><metric name> - select by metric name<br>{\_\_name\_\_="<metric name>"} - select by metric name<br>{\_\_name\_\_=\~"<regex>"} - select by metric name matching a regular expression<br>{<label name>="<label value>",...} - select by label name<br>{<label name>=\~"<regex>",...} - select by label name matching a regular expression<br>{\_\_name\_\_=\~".\*"}==<value> - select by metric value<br>Or a combination of the above:<br><metric name>{<label1 name>="<label1 value>",<label2 name>=\~"<regex>",...}==<value><br><br>Label value can be any sequence of UTF-8 characters, but the backslash, double-quote and line feed characters have to be escaped as `\\`, `\"` and `\n` respectively; other characters shall not be escaped.|*wmi\_os\_physical\_memory\_free\_bytes*<br>*cpu\_usage\_system{cpu="cpu-total"}*<br>*cpu\_usage\_system{cpu=\~".\*"}*<br>*cpu\_usage\_system{cpu="cpu-total",host=\~".\*"}*<br>*wmi\_service\_state{name="dhcp"}==1*<br>*wmi\_os\_timezone{timezone=\~".\*"}==1*| |*Result processing*|Specify whether to return the value, the label or apply the appropriate function (if the pattern matches several lines and the result needs to be aggregated):<br>**value** - return metric value (error if multiple lines matched)<br>**label** - return value of the label specified in the *Label* field (error if multiple metrics are matched)<br>**sum** - return the sum of values<br>**min** - return the minimum value<br>**max** - return the maximum value<br>**avg** - return the average value<br>**count** - return the count of values<br>This field is only available for the *Prometheus pattern* option. |See also examples of using parameters below.| |*Output*|Define label name (optional). In this case the value corresponding to the label name is returned.<br>This field is only available for the *Prometheus pattern* option, if 'Label' is selected in the *Result processing* field.|<| **Examples of using parameters** 1. The most common use case is to return the **value**. To return the value of `/var/db` from: > `node_disk_usage_bytes{path="/var/cache"} 2.1766144e+09`<br> > `node_disk_usage_bytes{path="/var/db"} 20480`<br> > `node_disk_usage_bytes{path="/var/dpkg"} 8192`<br> > `node_disk_usage_bytes{path="/var/empty"} 4096` use the following parameters: * *Pattern* - `node_disk_usage_bytes{path="/var/db"}` * *Result processing* - select 'value' 2. You may also be interested in the **average** value of all `node_disk_usage_bytes` parameters: * *Pattern* - `node_disk_usage_bytes` * *Result processing* - select 'avg' 3. While Prometheus supports only numerical data, it is popular to use a workaround that allows to return the relevant textual description as well. This can be accomplished with a filter and specifying the label. So, to return the value of the 'color' label from > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="green"} 1`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="red"} 0`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="yellow"} 0` use the following parameters: * *Pattern* - `elasticsearch_cluster_health_status {cluster="elasticsearch"} == 1` * *Result processing* - select 'label' * *Label* - specify 'color' The filter (based on the numeric value '1') will match the appropriate row, while the label will return the health status description (currently 'green'; but potentially also 'red' or 'yellow'). #### 設定 HTTPマスター item が設定されていることを前提に、Prometheusのプリプロセスステップを使用する<br> [dependent item](/manual/config/items/itemtypes/dependent_items)を作成する必要があります。<br> - 設定フォームに一般的な従属項目パラメータを入力する - Preprocessing タブに移動します - Prometheus の Preprocessing オプション(*Prometheus pattern* or *Prometheus to JSON*)を選択します。  以下のパラメータは、*Prometheus pattern* Preprocessing オプションに固有のものです: |パラメータ|説明|例| |---------|-----------|--------| |*Pattern*|To define the required data pattern you may use a query language that is similar to Prometheus query language (see [comparison table](#query-language-comparison)), e.g.:<br><metric name> - select by metric name<br>{\_\_name\_\_="<metric name>"} - select by metric name<br>{\_\_name\_\_=\~"<regex>"} - select by metric name matching a regular expression<br>{<label name>="<label value>",...} - select by label name<br>{<label name>=\~"<regex>",...} - select by label name matching a regular expression<br>{\_\_name\_\_=\~".\*"}==<value> - select by metric value<br>Or a combination of the above:<br><metric name>{<label1 name>="<label1 value>",<label2 name>=\~"<regex>",...}==<value><br><br>Label value can be any sequence of UTF-8 characters, but the backslash, double-quote and line feed characters have to be escaped as `\\`, `\"` and `\n` respectively; other characters shall not be escaped.|*wmi\_os\_physical\_memory\_free\_bytes*<br>*cpu\_usage\_system{cpu="cpu-total"}*<br>*cpu\_usage\_system{cpu=\~".\*"}*<br>*cpu\_usage\_system{cpu="cpu-total",host=\~".\*"}*<br>*wmi\_service\_state{name="dhcp"}==1*<br>*wmi\_os\_timezone{timezone=\~".\*"}==1*| |*Result processing*|Specify whether to return the value, the label or apply the appropriate function (if the pattern matches several lines and the result needs to be aggregated):<br>**value** - return metric value (error if multiple lines matched)<br>**label** - return value of the label specified in the *Label* field (error if multiple metrics are matched)<br>**sum** - return the sum of values<br>**min** - return the minimum value<br>**max** - return the maximum value<br>**avg** - return the average value<br>**count** - return the count of values<br>This field is only available for the *Prometheus pattern* option. |See also examples of using parameters below.| |*Output*|Define label name (optional). In this case the value corresponding to the label name is returned.<br>This field is only available for the *Prometheus pattern* option, if 'Label' is selected in the *Result processing* field.|<| **パラメータ使用の例** 1. 最も一般的な使用例は、**値** を返すことです。`/var/db`からの値を返すには、次のようにします。 > `node_disk_usage_bytes{path="/var/cache"} 2.1766144e+09`<br> > `node_disk_usage_bytes{path="/var/db"} 20480`<br> > `node_disk_usage_bytes{path="/var/dpkg"} 8192`<br> > `node_disk_usage_bytes{path="/var/empty"} 4096` 以下のパラメータを使用します: * *Pattern* - `node_disk_usage_bytes{path="/var/db"}` * *Result processing* - select 'value' 2. また、すべての `node_disk_usage_bytes` パラメータの **平均** 値に興味があるかもしれません: * *Pattern* - `node_disk_usage_bytes` * *Result processing* - select 'avg' 3. Prometheusは数値データのみをサポートしていますが、関連するテキストの説明も返すことができるワークアラウンドを<br> 使用することが一般的です。これは、フィルタとラベルを指定することで実現できます。つまり、'color' ラベルの値を返すには、<br> 以下のようにします。<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="green"} 1`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="red"} 0`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="yellow"} 0` 以下のパラメータを使用します: * *Pattern* - `elasticsearch_cluster_health_status {cluster="elasticsearch"} == 1` * *Result processing* - select 'label' * *Label* - specify 'color' フィルター(数値'1'に基づく)は適切な行にマッチし、ラベルはヘルスステータスの説明を返す(現在は'緑'だが、'赤'や'黄'の可能性もある)。 #### Configuration Real-time export of trigger events, item values and trends is configured by specifying a directory for the export files - see the `ExportDir` parameter in server [configuration](/manual/appendix/config/zabbix_server). Two other parameters are available: - `ExportFileSize` may be used to set the maximum allowed size of an individual export file. When a process needs to write to a file it checks the size of the file first. If it exceeds the configured size limit, the file is renamed by appending .old to its name and a new file with the original name is created. ::: noteimportant A file will be created per each process that will write data (i.e. approximately 4-30 files). As the default size per export file is 1G, keeping large export files may drain the disk space fast. ::: - `ExportType` allows to specify which entity types (events, history, trends) will be exported. #### 設定 トリガーイベント、アイテム値、トレンドのリアルタイムエクスポートは、エクスポートファイルのディレクトリを指定することで構成されます。サーバー[設定](/manual/appendix/config/zabbix_server)の`ExportDir`パラメーターを参照してください。 他、2つのパラメータを使用できます。 - `ExportFileSize` 個々のエクスポートファイルの最大サイズを設定するために使用します。プロセスがファイルに書き込む必要がある場合、最初にファイルのサイズをチェックし、設定されたサイズ制限を超える場合は、名前に.oldを追加してファイルの名前を変更し、元の名前の新しいファイルを作成します。 ::: noteimportant データを書き込むプロセスごとにファイルが作成されます。（約4〜30ファイル）エクスポートファイルあたりのデフォルトサイズは1Gであるため、ディスク容量が急速に消費される可能性があります。 ::: - `ExportType` エクスポートするエンティティタイプ（イベント、ヒストリ、トレンド）を指定できます。 #### Configuration Some of the operands (installation options) require additional resources to be created before. The following section describes these prerequisites. All possible configuration options are available during operand deployment. For example, **Zabbix proxy (MySQL)**: {width="600"} The YAML section provides all available options with default values: {width="600"} #### 設定 一部のオペランド(インストールオプション)では、事前に追加のリソースを作成する必要があります。次のセクションではこれらの前提条件について説明します。オペランドの展開中は、すべての可能な設定オプションが利用できます。たとえば、**Zabbix プロキシ (MySQL)**は次のようになります。 {width="600"} YAMLセクションには、デフォルト値を持つすべての使用可能なオプションが提供されています。 {width="600"} ##### Configuration syncer Performance of the configuration syncer has been improved. It is recommended to increase the CacheSize on server/proxy if there is a large amount of templates. It is also recommended to remove unused templates. Note that the default CacheSize on server/proxy has been increased to 32M. ##### Configuration Syncer Configuration Syncerのパフォーマンスが向上しました。 テンプレートが大量にある場合は、サーバー/プロキシのキャッシュサイズを大きくすることを推奨します。 また、未使用のテンプレートは削除することをお勧めします。 サーバー/プロキシのデフォルトのキャッシュサイズが32Mに増加したことにご注意ください。 #### Configuration sync optimization for Oracle For Zabbix installations with Oracle, it is now possible to manually change item and item preprocessing database field types from *nclob* to *nvarchar2* by applying a database patch. Patch application may increase the speed of configuration sync in environments with large number of items and item preprocessing steps, but will reduce the maximum field size limit from 65535 bytes to 4000 bytes for some item parameters. See [Known issues](/manual/installation/known_issues#slow-configuration-sync-with-oracle) for details. #### Oracle構成の同期最適化 Oracleを使用したZabbixのインストールで、データベースパッチを適用することで、アイテムおよびアイテムの前処理データベースフィールドタイプを*nclob*から*nvarchar2*に手動で変更できるようになりました。 パッチを適用すると、アイテム数とアイテムの保存前処理ステップが多い環境での構成の同期速度が向上する可能性があります。 ただし、一部のアイテムパラメーターでは、最大フィールドサイズの制限が65535バイトから4000バイトに減少します。 詳細については、[既知の問題](/manual/installation/known_issues#slow-configuration-sync-with-oracle) を参照してください。 #### Configuration Tags can be entered in a dedicated tab, for example, in trigger configuration:  #### 設定 タグは、トリガー設定などの専用タブで入力することができます:  #### Configuration The global time zone: - can be set manually when [installing](/manual/installation/frontend) the frontend - can be modified in *Administration* → *General* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)* User-level time zone: - can be set when [configuring/updating](/manual/config/users_and_usergroups/user#general_attributes) a user - can be set by each user in their [user profile](/manual/web_interface/user_profile#user-profile) **See also:** Aligning time zones when using [scheduling intervals](/manual/config/items/item/custom_intervals#aligning-time-zones-for-proxies-and-agent-2). #### 設定 グローバルタイムゾーン: - Webインタフェースを[インストール](/manual/installation/frontend)するときに手動で設定できます。 - *管理*→*一般設定*→*[表示設定](/manual/web_interface/frontend_sections/administration/general#表示設定)*で変更できます ユーザー毎のタイムゾーン: - ユーザー[設定/更新](/manual/config/users_and_usergroups/user#一般的な属性)で設定できます - 各ユーザーが[ユーザープロファイル](/manual/web_interface/user_profile#ユーザープロファイル)で設定できます。 **参照:** [プロキシとエージェント2-のタイムゾーンの調整](/manual/config/items/item/custom_intervals#プロキシとエージェント2-のタイムゾーンの調整)を使用する際のタイムゾーンの調整 #### Configuration The **Host** tab contains general host attributes:  All mandatory input fields are marked with a red asterisk. |Parameter|<|Description| |-|----------|----------------------------------------| |*Host name*|<|Enter a unique host name. Alphanumerics, spaces, dots, dashes and underscores are allowed. However, leading and trailing spaces are disallowed.<br>*Note:* With Zabbix agent running on the host you are configuring, the agent [configuration file](/manual/appendix/config/zabbix_agentd) parameter *Hostname* must have the same value as the host name entered here. The name in the parameter is needed in the processing of [active checks](/manual/appendix/items/activepassive).| |*Visible name*|<|Enter a unique visible name for the host. If you set this name, it will be the one visible in lists, maps, etc instead of the technical host name. This attribute has UTF-8 support.| |*Templates*|<|Link [templates](/manual/config/templates) to the host. All entities (items, triggers, graphs, etc) will be inherited from the template.<br>To link a new template, start typing the template name in the *Templates* field. A list of matching templates will appear; scroll down to select. Alternatively, you may click on *Select* next to the *Templates* field; then, first select the host group by clicking on *Select* next to the *Host groups* field; mark the checkbox in front of one or multiple templates from the list displayed below; click on *Select*. The template(s) that are selected in the *Templates* field will be linked to the host when the host configuration form is saved or updated.<br>To unlink a template, use one of the two options in the *Templates* block:<br>*Unlink* - unlink the template, but preserve its items, triggers and graphs<br>*Unlink and clear* - unlink the template and remove all its items, triggers and graphs<br>Listed template names are clickable links leading to the template configuration form.| |*Groups*|<|Select [host groups](/manual/config/hosts/host_groups) the host belongs to. A host must belong to at least one host group. A new group can be created and linked to a host by typing in a non-existing group name; the new name will be displayed in a dropdown list as "new" in the brackets; clicking on it, will add it to the selection field.| |*Interfaces*|<|Several host interface types are supported for a host: *Agent*, *SNMP*, *JMX* and *IPMI*.<br>No interfaces are defined by default. To add a new interface, click on *Add* in the *Interfaces* block, select the interface type and enter *IP/DNS*, *Connect to* and *Port* info.<br>*Note:* Interfaces that are used in any items cannot be removed and link *Remove* is grayed out for them.<br>The "IP" or "DNS" from an SNMP interface is also used for [SNMP traps](/manual/config/items/itemtypes/snmptrap).<br>During matching, only the selected "IP" or "DNS" in the host interface is used.<br>See [Configuring SNMP monitoring](/manual/config/items/itemtypes/snmp#configuring_snmp_monitoring) for additional details on configuring an SNMP interface (v1, v2 and v3).| | |*IP address*|Host IP address (optional).| |^|*DNS name*|Host DNS name (optional).| |^|*Connect to*|Clicking the respective button will tell Zabbix server what to use to retrieve data from agents:<br>**IP** - Connect to the host IP address (recommended)<br>**DNS** - Connect to the host DNS name| |^|*Port*|TCP/UDP port number. Default values are: 10050 for Zabbix agent, 161 for SNMP agent, 12345 for JMX and 623 for IPMI.| |^|*Default*|Check the radio button to set the default interface.| |*Description*|<|Enter the host description.| |*Monitored by proxy*|<|The host can be monitored either by Zabbix server or one of Zabbix proxies:<br>**(no proxy)** - host is monitored by Zabbix server<br>**Proxy name** - host is monitored by Zabbix proxy "Proxy name"| |*Enabled*|<|When the checkbox is checked, the host is enabled - ready for monitoring.<br><br>When the checkbox is unchecked, the host is disabled - not monitored:<br>For passive data requests initiated by Zabbix server/proxy (for example, [Zabbix agent](/manual/appendix/items/activepassive#passive-checks), [SNMP agent](/manual/config/items/itemtypes/snmp), [simple checks](/manual/config/items/itemtypes/simple_checks)), monitoring is disabled after configuration synchronization. Triggers and actions linked to the host are also disabled only after the configuration is reloaded.<br>For Zabbix agent [active checks](/manual/appendix/items/activepassive#active-checks), monitoring stops within the time frame (under 2 minutes) that Zabbix agent receives information about the host having been disabled. During this brief interval, the host will continue to locally collect data for the active checks and try sending it to the server/proxy; however, since the host is marked as *Disabled*, the server/proxy will reject the data.| The **IPMI** tab contains IPMI management attributes. |Parameter|Description| |--|--------| |*Authentication algorithm*|Select the authentication algorithm.| |*Privilege level*|Select the privilege level.| |*Username*|User name for authentication. User macros may be used.| |*Password*|Password for authentication. User macros may be used.| The **Tags** tab allows you to define host-level [tags](/manual/config/tagging). All problems of this host will be tagged with the values entered here.  User macros, {INVENTORY.\*} macros, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros are supported in tags. The **Macros** tab allows you to define host-level [user macros](/manual/config/macros/user_macros) as a name-value pairs. Note that macro values can be kept as plain text, secret text or Vault secret. Adding a description is also supported.  You may also view here template-level and global user macros if you select the *Inherited and host macros* option. That is where all defined user macros for the host are displayed with the value they resolve to as well as their origin. {width="600"} For convenience, links to respective templates and global macro configuration are provided. It is also possible to edit a template/global macro on the host level, effectively creating a copy of the macro on the host. The **Host inventory** tab allows you to manually enter [inventory](inventory) information for the host. You can also select to enable *Automatic* inventory population, or disable inventory population for this host.  If inventory is enabled (manual or automatic), a green dot is displayed with the tab name. #### 設定 **ホスト**タブには、一般的なホストの属性が表示されます。  すべての必須入力フィールドには赤いアスタリスクが表示されます。 |パラメーター|<|説明| |-|----------|----------------------------------------| |*ホスト名*|<|一意のホスト名を入力します。英数字、スペース、ドット、ダッシュ、アンダースコアを使用できます。ただし、先頭と末尾のスペースは使用できません。<br>*注:* 設定しているホストでZabbixエージェントが実行されている場合、エージェント[設定ファイル](/manual/appendix/config/zabbix_agentd)のパラメーター*Hostname*は、ここで入力したホスト名と同じ値である必要があります。パラメーター内の名前は、[アクティブチェック](/manual/appendix/items/activepassive)の処理に必要です。| |*表示名*|<|ホストの一意の表示名を入力します。この名前を設定すると、リストやマップなどに技術的なホスト名の代わりに表示されます。この属性はUTF-8をサポートしています。| |*テンプレート*|<|[テンプレート](/manual/config/templates)をホストにリンクします。すべてのエンティティ(アイテム、トリガー、グラフなど)は、テンプレートから継承されます。<br>新しいテンプレートをリンクするには、テンプレートの*検索文字列を入力*フィールドにテンプレート名を入力します。一致するテンプレートのリストが表示されるので、スクロールして選択します。または、フィールドの横にある*選択*をクリックし、ポップアップウィンドウのリストからテンプレートを選択することもできます。まず*ホストグループ*フィールドの横にある*選択*をクリックしてホストグループを選択し、下に表示されるリストから1つまたは複数のテンプレートの前にあるチェックボックスをオンにして *選択*をクリックします。*テンプレート*フィールドで選択したテンプレートは、ホスト設定フォームが保存または更新されるときにホストにリンクされます。<br>テンプレートのリンクを解除するには、*リンクされたテンプレート*の2つのオプションのいずれかを使用します。<br>*リンクを削除* - テンプレートのリンクを解除しますが、そのアイテム、トリガー、グラフは保持します。<br>*リンクと保存データを削除* - テンプレートのリンクを解除し、そのすべてのアイテム、トリガー、グラフを削除します。<br>リストされているテンプレート名は、テンプレート設定フォームにつながるクリック可能なリンクです。| |*グループ*|<|ホストが属する[ホストグループ](/manual/config/hosts/host_groups)を選択します。ホストは少なくとも1つのホストグループに属している必要があります。存在しないグループ名を入力すると、新しいグループを作成してホストにリンクできます。新しい名前はドロップダウンリストに括弧内に"新規"として表示されます。それをクリックすると、選択フィールドに追加されます。| |*インターフェース*|<|ホストではいくつかのホストインターフェースタイプがサポートされています: *エージェント*、*SNMP*、*JMX*、*IPMI*。<br>デフォルトではインターフェースは定義されていません。新しいインターフェースを追加するには、*インターフェース*ブロックの*追加*をクリックし、インターフェースタイプを選択して、*IP/DNS*、*接続先*、*ポート*情報を入力します。<br>*注:* いずれかのアイテムで使用されているインターフェースは削除できず、それらのインターフェースの*削除*リンクはグレー表示されます。<br>SNMPインターフェイスの"IP"または"DNS"は、[SNMPトラップ](/manual/config/items/itemtypes/snmptrap)にも使用されます。<br>マッチング中、ホストインターフェースで選択された"IP"または"DNS"のみが使用されます。<br>SNMPインターフェース(v1、v2、v3)の設定の詳細については、[SNMP監視の設定](/manual/config/items/itemtypes/snmp#snmpモニタリングの設定) を参照してください。| ||*IPアドレス*|ホストIPアドレス (オプション)。| |^|*DNS名*|ホストDNS名 (オプション)。| |^|*接続方法*|それぞれのボタンをクリックすると、エージェントからデータを取得するために何を使用するかを Zabbixサーバーに指示します:<br>**IP** - ホストのIPアドレスで接続します (推奨)<br>**DNS** - ホストのDNS名で接続します| |^|*ポート*|TCP/UDPポート番号。デフォルト値は、Zabbixエージェントの場合は10050、SNMPエージェントの場合は161、JMXの場合は12345、IPMIの場合は623です。| |^|*標準*|デフォルトのインターフェースを設定するには、ラジオボタンをオンにします。| |*説明*|<|ホストの説明を入力します。| |*プロキシによる監視*|<|ホストは、ZabbixサーバーまたはいずれかのZabbixプロキシによって監視できます。<br>**(プロキシなし)** - ホストはZabbixサーバーによって監視されます<br>**プロキシ名** - ホストはZabbixプロキシ"プロキシ名"によって監視されます。| |*有効*|<|チェックボックスがオンの場合、ホストは有効になり、監視の準備が整います。<br><br>チェックボックスがオフの場合、ホストは無効になり、監視されません。<br>Zabbixサーバー/プロキシによって開始されたパッシブデータ要求(例えば、[Zabbixエージェント](/manual/appendix/items/activepassive#パッシブチェック)、[SNMPエージェント](/manual/config/items/itemtypes/snmp)、[シンプルチェック](/manual/config/items/itemtypes/simple_checks)など)の場合、設定の同期後、監視は無効になります。ホストにリンクされたトリガーとアクションも、設定が再読み込みされた後にのみ無効になります。<br>Zabbixエージェントの[アクティブチェック](/manual/appendix/items/activepassive#アクティブチェック)の場合、Zabbixエージェントがホストが無効になったことに関する情報を受信するまでの時間枠内(2分未満)に監視が停止します。この短い間隔の間、ホストはアクティブチェックのデータをローカルで収集し続け、サーバー/プロキシに送信しようとします。ただし、ホストが*無効*としてマークされているため、Zabbixサーバー/プロキシは監視データを拒否します。| **IPMI**タブには、IPMIの管理属性が表示されます。 |パラメーター|説明| |--|--------| |*認証アルゴリズム*|認証アルゴリズムを選択します。| |*特権レベル*|権限レベルを選択します。| |*ユーザー名*|認証用のユーザー名。ユーザーマクロを使用できます。| |*パスワード*|認証用のパスワード。ユーザーマクロを使用できます。| **タグ**タブでは、ホストレベルの[タグ](/manual/config/tagging)を定義します。このホストのすべての障害は、ここで入力された値でタグ付けされます。  タグでは、ユーザー マクロ、{INVENTORY.\*}マクロ、{HOST.HOST}、{HOST.NAME}、{HOST.CONN}、{HOST.DNS}、{HOST.IP}、{HOST.PORT}および{HOST.ID}マクロがサポートされています。 **マクロ**タブでは、ホストレベルの[ユーザーマクロ](/manual/config/macros/user_macros)を名前と値のペアで定義することができます。 マクロの値は、プレーン・テキスト、シークレット・テキスト、またはVaultシークレットとして保持することに注意してください。説明の追加もサポートされています。  *継承したマクロとホストマクロ* オプションを選択すると、テンプレートレベルおよびグローバルなユーザマクロを表示することができます。 ここには、ホスト用に定義されたすべてのユーザー マクロが、それらが解決する値と元の値とともに表示されます。 {width="600"} 便宜上、各テンプレートとグローバルマクロの設定へのリンクを設けています。 また、ホストレベルでテンプレート/グローバルマクロを編集し、ホスト上にマクロのコピーを効果的に作成することも可能です。 **ホストインベントリ**タブでは、ホストの[インベントリ](inventory)情報を手動で入力することができます。また、このホストの*自動*でのインベントリ作成を有効にするか、インベントリ作成を無効にするかを選択できます。  インベントリが有効な場合(手動または自動)、タブ名とともに緑色の点が表示されます。 #### Configuration The **Item** tab contains general item attributes.  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |---------|-----------| |*Name*|Item name.| |*Type*|Item type. See individual [item type](itemtypes) sections.| |*Key*|Item key (up to 2048 characters).<br>The supported [item keys](itemtypes) can be found in individual item type sections.<br>The key must be unique within a single host.<br>If key type is 'Zabbix agent', 'Zabbix agent (active)' or 'Simple check', the key value must be supported by Zabbix agent or Zabbix server.<br>See also: the correct [key format](/manual/config/items/item/key).| |*Type of information*|Type of data as stored in the database after performing conversions, if any.<br>**Numeric (unsigned)** - 64bit unsigned integer<br>**Numeric (float)** - 64bit floating point number<br>This type will allow precision of approximately 15 digits and range from approximately -1.79E+308 to 1.79E+308 (with exception of [PostgreSQL 11 and earlier versions](/manual/installation/known_issues#floating_point_values)).<br>Receiving values in scientific notation is also supported. E.g. 1.23E+7, 1e308, 1.1E-4.<br>**Character** - short text data<br>**Log** - long text data with optional log related properties (timestamp, source, severity, logeventid)<br>**Text** - long text data. See also [text data limits](#text-data-limits).<br>For item keys that return data only in one specific format, matching type of information is selected automatically.| |*Host interface*|Select the host interface. This field is available when editing an item on the host level.| |*Units*|If a unit symbol is set, Zabbix will add post processing to the received value and display it with the set unit postfix.<br>By default, if the raw value exceeds 1000, it is divided by 1000 and displayed accordingly. For example, if you set *bps* and receive a value of 881764, it will be displayed as 881.76 Kbps.<br>The [JEDEC](https://en.wikipedia.org/wiki/JEDEC_memory_standards) memory standard is used for processing **B** (byte), **Bps** (bytes per second) units, which are divided by 1024. Thus, if units are set to **B** or **Bps** Zabbix will display:<br>1 as 1B/1Bps<br>1024 as 1KB/1KBps<br>1536 as 1.5KB/1.5KBps<br>Special processing is used if the following time-related units are used:<br>**unixtime** - translated to "yyyy.mm.dd hh:mm:ss". To translate correctly, the received value must be a *Numeric (unsigned)* type of information.<br>**uptime** - translated to "hh:mm:ss" or "N days, hh:mm:ss"<br>For example, if you receive the value as 881764 (seconds), it will be displayed as "10 days, 04:56:04"<br>**s** - translated to "yyy mmm ddd hhh mmm sss ms"; parameter is treated as number of seconds.<br>For example, if you receive the value as 881764 (seconds), it will be displayed as "10d 4h 56m"<br>Only 3 upper major units are shown, like "1m 15d 5h" or "2h 4m 46s". If there are no days to display, only two levels are displayed - "1m 5h" (no minutes, seconds or milliseconds are shown). Will be translated to "< 1 ms" if the value is less than 0.001.<br>*Note* that if a unit is prefixed with `!`, then no unit prefixes/processing is applied to item values. See [unit conversion](#unit_conversion).| |*Update interval*|Retrieve a new value for this item every N seconds. Maximum allowed update interval is 86400 seconds (1 day).<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported.<br>A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>*Note*: The update interval can only be set to '0' if custom intervals exist with a non-zero value. If set to '0', and a custom interval (flexible or scheduled) exists with a non-zero value, the item will be polled during the custom interval duration.<br>*Note* that the first item poll after the item became active or after update interval change might occur earlier than the configured value.<br>An existing passive item can be polled for value immediately by pushing the *Execute now* [button](#form_buttons).| |*Custom intervals*|You can create custom rules for checking the item:<br>**Flexible** - create an exception to the *Update interval* (interval with different frequency)<br>**Scheduling** - create a custom polling schedule.<br>For detailed information see [Custom intervals](/manual/config/items/item/custom_intervals).<br>[Time suffixes](/manual/appendix/suffixes) are supported in the *Interval* field, e.g. 30s, 1m, 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported.<br>A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Scheduling is supported since Zabbix 3.0.0.<br>*Note*: Not available for Zabbix agent active items.| |*History storage period*|Select either:<br>**Do not keep history** - item history is not stored. Useful for master items if only dependent items need to keep history.<br>This setting cannot be overridden by global housekeeper [settings](/manual/web_interface/frontend_sections/administration/general#housekeeper).<br>**Storage period** - specify the duration of keeping detailed history in the database (1 hour to 25 years). Older data will be removed by the housekeeper. Stored in seconds.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 2h, 1d. [User macros](/manual/config/macros/user_macros) are supported.<br>The *Storage period* value can be overridden globally in *Administration → General → [Housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper)*.<br>If a global overriding setting exists, a green  info icon is displayed. If you position your mouse on it, a warning message is displayed, e.g. *Overridden by global housekeeper settings (1d)*.<br>It is recommended to keep the recorded values for the smallest possible time to reduce the size of value history in the database. Instead of keeping a long history of values, you can keep longer data of trends.<br>See also [History and trends](/manual/config/items/history_and_trends).| |*Trend storage period*|Select either:<br>**Do not keep trends** - trends are not stored.<br>This setting cannot be overridden by global housekeeper [settings](/manual/web_interface/frontend_sections/administration/general#housekeeper).<br>**Storage period** - specify the duration of keeping aggregated (hourly min, max, avg, count) history in the database (1 day to 25 years). Older data will be removed by the housekeeper. Stored in seconds.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 24h, 1d. [User macros](/manual/config/macros/user_macros) are supported.<br>The *Storage period* value can be overridden globally in *Administration → General → [Housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper)*.<br>If a global overriding setting exists, a green  info icon is displayed. If you position your mouse on it, a warning message is displayed, e.g. *Overridden by global housekeeper settings (7d)*.<br>*Note:* Keeping trends is not available for non-numeric data - character, log and text.<br>See also [History and trends](/manual/config/items/history_and_trends).| |*Value mapping*|Apply value mapping to this item. [Value mapping](/manual/config/items/mapping) does not change received values, it is for displaying data only.<br>It works with *Numeric(unsigned)*, *Numeric(float)* and *Character* items.<br>For example, "Windows service states".| |*Log time format*|Available for items of type **Log** only. Supported placeholders:<br>\* **y**: *Year (1970-2038)*<br>\* **M**: *Month (01-12)*<br>\* **d**: *Day (01-31)*<br>\* **h**: *Hour (00-23)*<br>\* **m**: *Minute (00-59)*<br>\* **s**: *Second (00-59)*<br>If left blank the timestamp will not be parsed.<br>For example, consider the following line from the Zabbix agent log file:<br>" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."<br>It begins with six character positions for PID, followed by date, time, and the rest of the line.<br>Log time format for this line would be "pppppp:yyyyMMdd:hhmmss".<br>Note that "p" and ":" chars are just placeholders and can be anything but "yMdhms".| |*Populates host inventory field*|You can select a host inventory field that the value of item will populate. This will work if automatic [inventory](/manual/config/hosts/inventory) population is enabled for the host.<br>This field is not available if *Type of information* is set to 'Log'.| |*Description*|Enter an item description.| |*Enabled*|Mark the checkbox to enable the item so it will be processed.| ::: noteclassic Item type specific fields are described on [corresponding pages](itemtypes). ::: ::: noteclassic When editing an existing [template](/manual/config/templates) level item on a host level, a number of fields are read-only. You can use the link in the form header and go to the template level and edit them there, keeping in mind that the changes on a template level will change the item for all hosts that the template is linked to. ::: The **Tags** tab allows to define item-level [tags](/manual/config/tagging).  #### Configuration The **Item** tab contains general item attributes.  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |---------|-----------| |*Name*|Item name.| |*Type*|Item type. See individual [item type](itemtypes) sections.| |*Key*|Item key (up to 2048 characters).<br>The supported [item keys](itemtypes) can be found in individual item type sections.<br>The key must be unique within a single host.<br>If key type is 'Zabbix agent', 'Zabbix agent (active)' or 'Simple check', the key value must be supported by Zabbix agent or Zabbix server.<br>See also: the correct [key format](/manual/config/items/item/key).| |*Type of information*|Type of data as stored in the database after performing conversions, if any.<br>**Numeric (unsigned)** - 64bit unsigned integer<br>**Numeric (float)** - 64bit floating point number<br>This type will allow precision of approximately 15 digits and range from approximately -1.79E+308 to 1.79E+308 (with exception of [PostgreSQL 11 and earlier versions](/manual/installation/known_issues#floating_point_values)).<br>Receiving values in scientific notation is also supported. E.g. 1.23E+7, 1e308, 1.1E-4.<br>**Character** - short text data<br>**Log** - long text data with optional log related properties (timestamp, source, severity, logeventid)<br>**Text** - long text data. See also [text data limits](#Text_data_limits).<br>For item keys that return data only in one specific format, matching type of information is selected automatically.| |*Host interface*|Select the host interface. This field is available when editing an item on the host level.| |*Units*|If a unit symbol is set, Zabbix will add post processing to the received value and display it with the set unit postfix.<br>By default, if the raw value exceeds 1000, it is divided by 1000 and displayed accordingly. For example, if you set *bps* and receive a value of 881764, it will be displayed as 881.76 Kbps.<br>The [JEDEC](https://en.wikipedia.org/wiki/JEDEC_memory_standards) memory standard is used for processing **B** (byte), **Bps** (bytes per second) units, which are divided by 1024. Thus, if units are set to **B** or **Bps** Zabbix will display:<br>1 as 1B/1Bps<br>1024 as 1KB/1KBps<br>1536 as 1.5KB/1.5KBps<br>Special processing is used if the following time-related units are used:<br>**unixtime** - translated to "yyyy.mm.dd hh:mm:ss". To translate correctly, the received value must be a *Numeric (unsigned)* type of information.<br>**uptime** - translated to "hh:mm:ss" or "N days, hh:mm:ss"<br>For example, if you receive the value as 881764 (seconds), it will be displayed as "10 days, 04:56:04"<br>**s** - translated to "yyy mmm ddd hhh mmm sss ms"; parameter is treated as number of seconds.<br>For example, if you receive the value as 881764 (seconds), it will be displayed as "10d 4h 56m"<br>Only 3 upper major units are shown, like "1m 15d 5h" or "2h 4m 46s". If there are no days to display, only two levels are displayed - "1m 5h" (no minutes, seconds or milliseconds are shown). Will be translated to "< 1 ms" if the value is less than 0.001.<br>*Note* that if a unit is prefixed with `!`, then no unit prefixes/processing is applied to item values. See [unit conversion](#unit_conversion).| |*Update interval*|Retrieve a new value for this item every N seconds. Maximum allowed update interval is 86400 seconds (1 day).<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported.<br>A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>*Note*: The update interval can only be set to '0' if custom intervals exist with a non-zero value. If set to '0', and a custom interval (flexible or scheduled) exists with a non-zero value, the item will be polled during the custom interval duration.<br>*Note* that the first item poll after the item became active or after update interval change might occur earlier than the configured value.<br>An existing passive item can be polled for value immediately by pushing the *Execute now* [button](#form_buttons).| |*Custom intervals*|You can create custom rules for checking the item:<br>**Flexible** - create an exception to the *Update interval* (interval with different frequency)<br>**Scheduling** - create a custom polling schedule.<br>For detailed information see [Custom intervals](/manual/config/items/item/custom_intervals).<br>[Time suffixes](/manual/appendix/suffixes) are supported in the *Interval* field, e.g. 30s, 1m, 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported.<br>A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Scheduling is supported since Zabbix 3.0.0.<br>*Note*: Not available for Zabbix agent active items.| |*History storage period*|Select either:<br>**Do not keep history** - item history is not stored. Useful for master items if only dependent items need to keep history.<br>This setting cannot be overridden by global housekeeper [settings](/manual/web_interface/frontend_sections/administration/general#housekeeper).<br>**Storage period** - specify the duration of keeping detailed history in the database (1 hour to 25 years). Older data will be removed by the housekeeper. Stored in seconds.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 2h, 1d. [User macros](/manual/config/macros/user_macros) are supported.<br>The *Storage period* value can be overridden globally in *Administration → General → [Housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper)*.<br>If a global overriding setting exists, a green  info icon is displayed. If you position your mouse on it, a warning message is displayed, e.g. *Overridden by global housekeeper settings (1d)*.<br>It is recommended to keep the recorded values for the smallest possible time to reduce the size of value history in the database. Instead of keeping a long history of values, you can keep longer data of trends.<br>See also [History and trends](/manual/config/items/history_and_trends).| |*Trend storage period*|Select either:<br>**Do not keep trends** - trends are not stored.<br>This setting cannot be overridden by global housekeeper [settings](/manual/web_interface/frontend_sections/administration/general#housekeeper).<br>**Storage period** - specify the duration of keeping aggregated (hourly min, max, avg, count) history in the database (1 day to 25 years). Older data will be removed by the housekeeper. Stored in seconds.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 24h, 1d. [User macros](/manual/config/macros/user_macros) are supported.<br>The *Storage period* value can be overridden globally in *Administration → General → [Housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper)*.<br>If a global overriding setting exists, a green  info icon is displayed. If you position your mouse on it, a warning message is displayed, e.g. *Overridden by global housekeeper settings (7d)*.<br>*Note:* Keeping trends is not available for non-numeric data - character, log and text.<br>See also [History and trends](/manual/config/items/history_and_trends).| |*Value mapping*|Apply value mapping to this item. [Value mapping](/manual/config/items/mapping) does not change received values, it is for displaying data only.<br>It works with *Numeric(unsigned)*, *Numeric(float)* and *Character* items.<br>For example, "Windows service states".| |*Log time format*|Available for items of type **Log** only. Supported placeholders:<br>\* **y**: *Year (1970-2038)*<br>\* **M**: *Month (01-12)*<br>\* **d**: *Day (01-31)*<br>\* **h**: *Hour (00-23)*<br>\* **m**: *Minute (00-59)*<br>\* **s**: *Second (00-59)*<br>If left blank the timestamp will not be parsed.<br>For example, consider the following line from the Zabbix agent log file:<br>" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."<br>It begins with six character positions for PID, followed by date, time, and the rest of the line.<br>Log time format for this line would be "pppppp:yyyyMMdd:hhmmss".<br>Note that "p" and ":" chars are just placeholders and can be anything but "yMdhms".| |*Populates host inventory field*|You can select a host inventory field that the value of item will populate. This will work if automatic [inventory](/manual/config/hosts/inventory) population is enabled for the host.<br>This field is not available if *Type of information* is set to 'Log'.| |*Description*|Enter an item description.| |*Enabled*|Mark the checkbox to enable the item so it will be processed.| ::: noteclassic Item type specific fields are described on [corresponding pages](itemtypes). ::: ::: noteclassic When editing an existing [template](/manual/config/templates) level item on a host level, a number of fields are read-only. You can use the link in the form header and go to the template level and edit them there, keeping in mind that the changes on a template level will change the item for all hosts that the template is linked to. ::: The **Tags** tab allows to define item-level [tags](/manual/config/tagging).  #### Configuration The low-level discovery rule should be created as a [dependent item](/manual/config/items/itemtypes/dependent_items) to the HTTP master item that collects Prometheus data. #### 設定 ローレベルディスカバリルールは、Prometheusデータを収集するHTTPマスターアイテムへの[依存アイテム](/manual/config/items/itemtypes/dependent_items)として作成する必要があります。 #### Configuration The options for aggregation are available in data set settings when configuring a [graph widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#graph).  You may pick the aggregation function and the time interval. As the data set may comprise several items, there is also another option allowing to show aggregated data for each item separately or for all data set items as one aggregated value. #### 設定 [graph widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#graph)を構成する際に、<br> データセット設定で集計のオプションを利用することが可能です。  集計関数と時間間隔を選択することができます。データセットが複数の item から構成されている場合、各 item の集計データを<br> 個別に表示するか、すべてのデータセット item を1つの集計値として表示するか、別のオプションを使用することも可能です。 ### Configuration The Zabbix API allows you to manage the configuration of your monitoring system. ### 設定 Zabbix APIでは、監視システムの設定を管理することができます。 #### Configuration Those remote commands that are executed on Zabbix agent (custom scripts) must be first enabled in the agent [configuration](/manual/appendix/config/zabbix_agentd). Make sure that the AllowKey=system.run[<command>,\*] parameter is added for each allowed command in agent configuration to allow specific command with nowait mode. Restart agent daemon if changing this parameter. ::: noteimportant Remote commands do not work with active Zabbix agents. ::: Then, when configuring a new action in *Configuration → Actions*: - Define the appropriate conditions. In this example, set that the action is activated upon any disaster problems with one of Apache applications:  - In the *[Operations](/manual/config/notifications/action/operation#configuring_an_operation)* tab, click on Add in the Operations/Recovery operations/Update operations block - From the Operation dropdown field select one of the predefined scripts  - Select the target list for the script #### 設定 Zabbix エージェント (カスタム スクリプト) で実行されるリモート コマンドは、最初にエージェントの [設定](/manual/appendix/config/zabbix_agentd) で有効にする必要があります。 エージェント設定で許可されている各コマンドに AllowKey=system.run[<command>,\*] パラメータが追加されていることを確認して、nowait モードで特定のコマンドを許可します。 このパラメータを変更する場合は、エージェント デーモンを再起動します。 ::: noteimportant リモート コマンドは、アクティブな Zabbix エージェントでは機能しません。 ::: 次に*設定 → アクション* で新しいアクションを設定: - 適切な条件を定義します。 この例ではいずれかの Apache アプリケーションで障害が発生した場合にアクションがアクティブになるように設定します。:  - *[実行内容](/manual/config/notifications/action/operation#configuring_an_operation)* タブで、実行内容/復旧時の実行内容/更新時の実行内容 ブロックの [追加] をクリックします。 - [処理内容] ドロップダウン フィールドから、定義済みスクリプトの 1 つを選択します。  - スクリプトのターゲット リストを選択します #### Configuration To add the widget, select *Geomap* as type.  #### 設定 ウィジェットを追加するにはタイプとして*地理マップ*を選択します。  #### Configuration To add the widget, select *Geomap* as type.  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |---|---| |*Host groups*|Select host groups to be displayed on the map. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups. Scroll down to select. Click on 'x' to remove the selected.| |*Hosts*|Select hosts to be displayed all the map. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts. Scroll down to select. Click on 'x' to remove the selected.| |*Tags*|Specify tags to limit the number of hosts displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met| |*Initial view*|Comma separated center coordinates and an optional zoom level to display when the widget is initially loaded in the format `<latitude>,<longitude>,<zoom>`<br>If initial zoom is specified, the Geomap widget is loaded at the given zoom level. Otherwise, initial zoom is calculated as half of the [max zoom](/manual/web_interface/frontend_sections/administration/general#geographical_maps) for the particular tile provider.<br>The initial view is ignored if the default view is set (see below).<br>Examples:<br>=> 40.6892494,-74.0466891,14<br>=> 40.6892494,-122.0466891| Host markers displayed on the map have the color of the host's most serious problem and green color if a host has no problems. Clicking on the host marker allows viewing the host's visible name and the number of unresolved problems grouped by severity. Clicking on the visible name will open [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu). Hosts displayed on the map can be filtered by problem severity. Press on the filter icon in the widget's upper right corner and mark the required severities.  It is possible to zoom in and out the map by using the plus and minus buttons in the widget's upper left corner or by using the mouse scroll wheel or touchpad. To set the current view as default, right-click anywhere on the map and select *Set this view as default*. This setting will override *Initial view* widget parameter for the current user. To undo this action, right-click anywhere on the map again and select *Reset the initial view*. When *Initial view* or *Default view* is set, you can return to this view at any time by pressing on the home icon on the left.  #### Configuration To add the widget, select *Geomap* as type.  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |---|---| |*Host groups*|Select host groups to be displayed on the map. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups. Scroll down to select. Click on 'x' to remove the selected.| |*Hosts*|Select hosts to be displayed all the map. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts. Scroll down to select. Click on 'x' to remove the selected.| |*Tags*|Specify tags to limit the number of hosts displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met| |*Initial view*|Comma separated center coordinates and an optional zoom level to display when the widget is initially loaded in the format `<latitude>,<longitude>,<zoom>`<br>If initial zoom is specified, the Geomap widget is loaded at the given zoom level. Otherwise, initial zoom is calculated as half of the [max zoom](/manual/web_interface/frontend_sections/administration/general#geographical_maps) for the particular tile provider.<br>The initial view is ignored if the default view is set (see below).<br>Examples:<br>=> 40.6892494,-74.0466891,14<br>=> 40.6892494,-122.0466891| Host markers displayed on the map have the color of the host's most serious problem and green color if a host has no problems. Clicking on the host marker allows viewing the host's visible name and the number of unresolved problems grouped by severity. Clicking on the visible name will open [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu). Hosts displayed on the map can be filtered by problem severity. Press on the filter icon in the widget's upper right corner and mark the required severities.  It is possible to zoom in and out the map by using the plus and minus buttons in the widget's upper left corner or by using the mouse scroll wheel or touchpad. To set the current view as default, right-click anywhere on the map and select *Set this view as default*. This setting will override *Initial view* widget parameter for the current user. To undo this action, right-click anywhere on the map again and select *Reset the initial view*. When *Initial view* or *Default view* is set, you can return to this view at any time by pressing on the home icon on the left.  #### Configuration To assign triggers as link indicators, do the following: - select a map element - click on *Edit* in the *Links* section for the appropriate link - click on *Add* in the *Link indicators* block and select one or more triggers {width="600"} All mandatory input fields are marked with a red asterisk. Added triggers can be seen in the *Link indicators* list. You can set the link type and color for each trigger directly from the list. When done, click on *Apply*, close the form and click on *Update* to save the map changes. #### 設定 trigger をリンクインジケーターとして割り当てるには、次のようにします。 - マップ要素を選択します。 - 適切なリンクの *Links* セクションで *Edit* をクリックします。 - *Link indicators* ブロックの *Add* をクリックし、1つまたは複数の trigger を選択します。 {width="600"} すべての必須入力項目には赤いアスタリスクが表示されます。 追加された trigger は、*Link indicators* のリストで確認することができます。 各 trigger のリンクタイプと色は、一覧から直接設定できます。完了したら、*Apply* をクリックし、フォームを閉じて、<br> *Update* をクリックしてマップの変更を保存します。 #### Configuration To be able to send and receive notifications from Zabbix you have to: - [define the media](/manual/config/notifications/media) to send a message to If the operation takes place outside of the [When active](/manual/config/notifications/media#user-media) time period defined for the selected media in the user configuration, the message will not be sent. The default trigger severity ('Not classified') **must be** checked in user media [configuration](/manual/config/notifications/media/email#user_media) if you want to receive notifications for non-trigger events such as discovery, active agent autoregistration or internal events. - [configure an action operation](/manual/config/notifications/action/operation) that sends a message to one of the defined media ::: noteimportant Zabbix sends notifications only to those users that have at least 'read' permissions to the host that generated the event. At least one host of a trigger expression must be accessible. ::: You can configure custom scenarios for sending messages using [escalations](/manual/config/notifications/action/escalations). To successfully receive and read e-mails from Zabbix, e-mail servers/clients must support standard 'SMTP/MIME e-mail' format since Zabbix sends UTF-8 data (If the subject contains ASCII characters only, it is not UTF-8 encoded.). The subject and the body of the message are base64-encoded to follow 'SMTP/MIME e-mail' format standard. Message limit after all macros expansion is the same as message limit for [Remote commands](/manual/config/notifications/action/operation/remote_command). #### 設定 Zabbix から通知を送受信できるようにするには、次のことを行う必要があります。 - メッセージを送信する[メディアを定義](/manual/config/notifications/media)する ユーザー設定で選択したメディアに対して定義された [有効な時間帯](/manual/config/notifications/media#ユーザーメディア) の期間外で操作が行われた場合、メッセージは送信されません。 ディスカバリ、アクティブ エージェントの自動登録、内部イベントなどのトリガーイベント以外に関する通知を受信する場合は、ユーザー メディア[設定](/manual/config/notifications/media/email#ユーザーメディア) でデフォルトのトリガー重大度("未分類")を **チェックする必要があります**。 - 定義されたメディアを使用してメッセージを送信する[アクションの実行内容を設定](/manual/config/notifications/action/operation)する ::: noteimportant Zabbix はイベントを生成したホストに対して少なくとも'読み取り'権限を持つユーザーにのみ通知を送信します。トリガー式の少なくとも 1 つのホストがアクセス可能である必要があります。 ::: [エスカレーション](/manual/config/notifications/action/escalations) を使用して、メッセージを送信するためのカスタム シナリオを設定できます。 Zabbix は UTF-8 データを送信するため、Zabbix から電子メールを正常に受信して読み取るには、電子メール サーバー/クライアントが標準の'SMTP/MIME e-mail'フォーマットをサポートしている必要があります。(件名がASCII文字のみの場合はUTF-8 エンコードされません)メッセージの件名と本文は'SMTP/MIME e-mail'フォーマットの標準に従って base64 でエンコードされています。 全マクロ展開後のメッセージ制限は、[リモートコマンド](/manual/config/notifications/action/operation/remote_command)のメッセージ制限と同じです。 #### Configuration To configure a CSV to JSON preprocessing step: - Go to the Preprocessing tab in [item](/manual/config/items/preprocessing)/[discovery rule](/manual/discovery/low_level_discovery#preprocessing) configuration - Click on *Add* - Select the *CSV to JSON* option {width="600"} The first parameter allows to set a custom delimiter. Note that if the first line of CSV input starts with "Sep=" and is followed by a single UTF-8 character then that character will be used as the delimiter in case the first parameter is not set. If the first parameter is not set and a delimiter is not retrieved from the "Sep=" line, then a comma is used as a separator. The second optional parameter allows to set a quotation symbol. If the *With header row* checkbox is marked, the header line values will be interpreted as column names (see [Header processing](#csv_header_processing) for more information). If the *Custom on fail* checkbox is marked, the item will not become unsupported in case of a failed preprocessing step. Additionally custom error handling options may be set: discard the value, set a specified value or set a specified error message. #### 設定 CSVからJSONへの保存前処理のステップを設定する場合: - [アイテム](/manual/config/items/preprocessing)/[ディスカバリルール](/manual/discovery/low_level_discovery#preprocessing)の保存前処理タブにアクセスします。 - *追加*をクリックします。 - *CSVからJSON*オプションを選択します。 {width="600"} 1番目のパラメーターカスタムデリミタを設定することができます。CSV入力の最初の行が"Sep="で始まり、UTF-8文字が1つ続く場合、最初のパラメーターが設定されていない場合、その文字がデリミタとして使用されることに注意ください。1番目のパラメーターが設定されておらず、かつ"Sep="行からデリミタが取得できない場合は、カンマがセパレーターとして使用されます。 オプションの2番目のパラメーターには引用記号を設定することができます。 *ヘッダ行を含む*のチェックボックスがチェックされている場合、ヘッダー行の値は列名として解釈されます(詳しくは[ヘッダー処理](#csv_header_processing)を参照してください)。 *失敗時のカスタマイズ*のチェックボックスがチェックされている場合、保存前処理のステップが失敗してもそのアイテムがサポートされなくなることはありません。 さらに、カスタムエラー処理オプションを設定することができます: 値を破棄、値を設定、エラーを設定。 #### Configuration To configure a maintenance period: - Go to: *Configuration → Maintenance* - Click on *Create maintenance period* (or on the name of an existing maintenance period) - Enter maintenance parameters in the form  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Name*|Name of the maintenance period.| |*Maintenance type*|Two types of maintenance can be set:<br>**With data collection** - data will be collected by the server during maintenance, triggers will be processed<br>**No data collection** - data will not be collected by the server during maintenance| |*Active since*|The date and time when executing maintenance periods becomes active.<br>*Note*: Setting this time alone does not activate a maintenance period; maintenance periods must be configured in *Periods* (see below).| |*Active till*|The date and time when executing maintenance periods stops being active.| |*Periods*|This block allows you to define the exact days and hours when the maintenance takes place. Clicking on  opens a popup window with a flexible *Maintenance period* form where you can define maintenance schedule. See [Maintenance periods](#maintenance_periods) for a detailed description.| |*Host groups*|Select host groups that the maintenance will be activated for. The maintenance will be activated for all hosts from the specified host group(s). This field is auto-complete, so starting to type in it will display a dropdown of all available host groups.<br>Specifying a parent host group implicitly selects all nested host groups. Thus the maintenance will also be activated on hosts from nested groups.| |*Hosts*|Select hosts that the maintenance will be activated for. This field is auto-complete, so starting to type in it will display a dropdown of all available hosts.<br>| |*Tags*|If maintenance tags are specified, maintenance for the selected hosts will be activated, but only problems with matching tags will be suppressed (i.e. no actions will be taken).<br>In case of multiple tags, they are calculated as follows:<br>**And/Or** - all tags must correspond; however tags with the same tag name are calculated by the Or condition<br>**Or** - enough if one tag corresponds<br>There are two ways of matching the tag value:<br>**Contains** - case-sensitive substring match (tag value contains the entered string)<br>**Equals** - case-sensitive string match (tag value equals the entered string) <br> Tags can be specified only if *With data collection* mode is selected.| |*Description*|Description of maintenance period.| #### 設定 メンテナンス期間を設定するには: - *設定 → メンテナンス*に移動します - *メンテナンス期間の作成* (または既存のメンテナンス期間の名前) をクリックします。 - フォームにメンテナンス パラメータを入力します  すべての必須入力フィールドには赤いアスタリスクが付いています。 |パラメータ|説明| |--|--------| |*名前*|メンテナンス期間名| |*メンテナンスタイプ*|2 種類のメンテナンスを設定できます。<br>**データ収集あり** - メンテナンス中でもサーバーによってデータが収集され、トリガーが処理されます<br>**データ収集なし** - メンテナンス中、サーバーはデータ収集しません| |*設定有効期間の開始日時*|メンテナンス期間の設定を有効にします。<br>*注*: この時間を設定するだけでは、メンテナンス期間はアクティブになりません。メンテナンス期間をアクティブにするには*監視対象のメンテナンス期間* タブに移動します。| |*設定有効期間の終了日時*|メンテナンス期間が非アクティブになる日時。| |*監視対象のメンテナンス期間*|このブロックにより、メンテナンスが行われる正確な日時を定義できます。  をクリックすると、柔軟な *メンテナンス期間* フォームを含むポップアップ ウィンドウが開き、メンテナンス スケジュールを定義できます。 詳細な説明については、[メンテナンス期間](#maintenance_periods)を参照してください。| |*ホストグループ*|メンテナンスを有効にするホスト グループを選択します。 指定したホスト グループのすべてのホストに対してメンテナンスが有効になります。 このフィールドはオートコンプリートなので、入力を開始すると、使用可能なすべてのホスト グループがドロップダウン表示されます。<br>親ホスト グループを指定すると、ネストされたすべてのホスト グループが暗黙的に選択されます。 したがって、ネストされたグループのホストでもメンテナンスが有効になります。| |*ホスト*|メンテナンスを有効にするホストを選択します。 このフィールドはオートコンプリートなので、入力を開始すると、利用可能なすべてのホストがドロップダウン表示されます。| |*タグ*|メンテナンス タグが指定されている場合、選択したホストのメンテナンスが有効になった際に、タグが一致する問題は抑制されます (つまりアクションは実行されません)。<br>タグが複数ある場合は、次のように計算されます:<br>**And/Or** - すべてのタグが対応している必要があります。 ただし、同じタグ名を持つタグは Or 条件で計算されます<br>**Or** - 少なくとも 1 つのタグが対応している必要があります<br>タグ値を一致させる方法は 2 つあります:<br>**含む** - case - 部分文字列を区別して一致 (タグ値に入力された文字列が含まれる)<br>**等しい** - 大文字と小文字を区別して文字列一致 (タグ値が入力された文字列と等しい) <br> *データ収集あり* モードが選択された場合にのみ、タグを指定できます。| |*説明*|メンテナンス期間の説明| #### Configuration To configure a user group: - Go to *Administration → User groups* - Click on *Create user group* (or on the group name to edit an existing group) - Edit group attributes in the form The **User group** tab contains general group attributes:  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Group name*|Unique group name.| |*Users*|To add users to the group start typing the name of an existing user. When the dropdown with matching user names appears, scroll down to select.<br>Alternatively you may click the *Select* button to select users in a popup.| |*Frontend access*|How the users of the group are authenticated.<br>**System default** - use default authentication method (set [globally](/manual/web_interface/frontend_sections/administration/authentication))<br>**Internal** - use Zabbix internal authentication (even if LDAP authentication is used globally).<br>Ignored if HTTP authentication is the global default.<br>**LDAP** - use LDAP authentication (even if internal authentication is used globally).<br>Ignored if HTTP authentication is the global default.<br>**Disabled** - access to Zabbix frontend is forbidden for this group| |*Enabled*|Status of user group and group members.<br>*Checked* - user group and users are enabled<br>*Unchecked* - user group and users are disabled| |*Debug mode*|Mark this checkbox to activate [debug mode](/manual/web_interface/debug_mode) for the users.| The **Permissions** tab allows you to specify user group access to host group (and thereby host) data: {width="600"} Current permissions to host groups are displayed in the *Permissions* block. If current permissions of the host group are inherited by all nested host groups, this is indicated after the host group name ("*including subgroups*"). Note that a *Super admin* user can enforce nested host groups to have the same level of permissions as the parent host group; this can be done in the host group [configuration](/manual/config/hosts/host#creating_a_host_group) form. You may change the level of access to a host group: - **Read-write** - read-write access to a host group; - **Read** - read-only access to a host group; - **Deny** - access to a host group denied; - **None** - no permissions are set. Use the selection field below to select host groups and the level of access to them. This field is auto-complete so starting to type the name of a host group will offer a dropdown of matching host groups. If you wish to see all host groups, click on *Select*. If you wish to include nested host groups, mark the *Include subgroups* checkbox. Click on  to add the selected host groups to the list of host group permissions. :::noteimportant Adding a parent host group with the *Include subgroups* checkbox marked will override (and remove from the list) previously configured permissions of all related nested host groups. Adding a host group with *None* as the level of access selected will remove the host group from the list if the host group is already in the list. ::: The **Tag filter** tab allows you to set tag-based permissions for user groups to see problems filtered by tag name and its value:  To select a host group to apply a tag filter for, click *Select* to get the complete list of existing host groups or start to type the name of a host group to get a dropdown of matching groups. If you want to apply tag filters to nested host groups, mark the *Include subgroups* checkbox. Tag filter allows to separate the access to host group from the possibility to see problems. For example, if a database administrator needs to see only "MySQL" database problems, it is required to create a user group for database administrators first, then specify "Service" tag name and "MySQL" value.  If "Service" tag name is specified and value field is left blank, corresponding user group will see all problems for selected host group with tag name "Service". If both tag name and value fields are left blank but host group selected, corresponding user group will see all problems for selected host group. Make sure a tag name and tag value are correctly specified otherwise a corresponding user group will not see any problems. Let's review an example when a user is a member of several user groups selected. Filtering in this case will use OR condition for tags. | | | | | | | | |---|---|---|---|---|---|---| |**User group A**|<|<|**User group B**|<|<|**Visible result for a user (member) of both groups**| |*Tag filter*|<|<|<|<|<|^| |*Host group*|*Tag name*|*Tag value*|*Host group*|*Tag name*|*Tag value*|^| |Templates/Databases|Service|MySQL|Templates/Databases|Service|Oracle|Service: MySQL or Oracle problems visible| |Templates/Databases|*blank*|*blank*|Templates/Databases|Service|Oracle|All problems visible| |*not selected*|*blank*|*blank*|Templates/Databases|Service|Oracle|<Service:Oracle> problems visible| ::: noteimportant Adding a filter (for example, all tags in a certain host group "Templates/Databases") results in not being able to see the problems of other host groups. ::: #### 設定 ユーザーグループを設定するには: - 管理 → ユーザーグループ*に移動します。 - *ユーザーグループの作成*をクリックします。（既存のグループを編集する場合はグループ名をクリックします） - フォームでグループ属性を編集します。 **ユーザーグループ** タブには、グループの一般的な属性が含まれています:  必須入力項目には、赤いアスタリスクが表示されています。 |パラメータ|説明| |--|--------| |*グループ名*|一意のグループ名| |*ユーザー*|グループにユーザーを追加するには、既存のユーザーの名前を入力します。一致するユーザー名のドロップダウンが表示されたら、下にスクロールして選択します。<br>または、*選択*ボタンをクリックして、ポップアップでユーザーを選択することもできます。| |*Webインタフェースへのアクセス*|グループのユーザーの認証方法<br>**システム デフォルト** - ([グローバル](/manual/web_interface/frontend_sections/administration/authentication)に)設定されたデフォルトの認証方法を使用します。<br>**Zabbixデータベース内のユーザー情報** - Zabbix 内部認証を使用します(LDAP認証がグローバルに使用されている場合でも)<br>HTTP認証がグローバルデフォルトの場合は無視されます。<br>**LDAP** - LDAP 認証を使用します (内部認証がグローバルに使用されている場合でも)。<br>HTTP認証がグローバル デフォルトの場合は無視されます。<br>**無効** - このグループでは Zabbix フロントエンドへのアクセスが禁止されています| |*有効*|ユーザーグループとグループメンバーのステータス<br>*チェックあり* - ユーザーグループとユーザーは有効<br>*チェックなし* - ユーザーグループとユーザーは無効| |*デバックモード*|ユーザーに対して[デバッグモード](/manual/web_interface/debug_mode)を有効にするには、このチェックボックスをオンにします。| **権限**タブでは、ホストグループ(およびホスト)データへのユーザーグループのアクセスを指定できます: {width="600"} ホストグループに対する現在のパーミッションは、*権限*に表示されます。 ホストグループの現在の権限がすべてのネストされたホストグループに継承される場合、これはホストグループ名の後に(*サブグループを含む*)をと表示されます。スーパー管理者ユーザーは、ネストされたホストグループに親ホストグループと同じレベルの権限を持たせることができることに注意してください。これは、ホストグループ設定フォームで実行できます。 ホストグループへのアクセスレベルは変更することができます。 - **表示/設定** - ホストグループへの読み書き可能なアクセス。 - **表示のみ** - ホストグループへの読み取り専用アクセス。 - **拒否** - ホストグループへのアクセスは拒否されます。 - **なし** - 権限は設定されません。 以下の選択フィールドを使用して、ホストグループとそれらへのアクセスレベルを選択します。このフィールドは自動補完なので、ホストグループの名前を入力し始めると、一致するホストグループのドロップダウンが表示されます。 すべてのホスト グループを表示する場合は、*選択*をクリックします。 ネストされたホスト グループを含める場合は、*サブグループを含める*チェックボックスをオンにします。 選択したホスト グループをホスト グループの権限のリストに追加するには、*追加*をクリックします。 :::noteimportant *サブグループを含める*チェックボックスをオンにして親ホストグループを追加すると、関連するネストされたすべてのホストグループでそれより前に設定された権限が上書きされ(リストから削除され)ます。 アクセスレベルとして*なし*を選択してホストグループを追加すると、ホストグループがすでにリストにある場合は、リストからホストグループが削除されます。 ::: **タグフィルター**タブでは、タグ名とその値でフィルタリングされた障害を見るために、ユーザーグループにタグベースの権限を設定することができます:  タグフィルターを適用するホストグループを選択するには、*選択*をクリックして既存のホストグループの完全なリストを取得するか、ホストグループの名前を入力して一致するグループのドロップダウンを選択します。ネストされたホストグループにタグフィルターを適用する場合は、*サブグループを含める*チェックボックスをオンにします。 タグフィルターによって、ホストグループへのアクセスと障害を見る可能性を分離することができます。 例えば、データベース管理者がデータベース"MySQL"の障害のみ確認する必要がある場合は、まずデータベース管理者のユーザーグループを作成し、次に"Service"タグ名と"MySQL"値を指定する必要があります。  "サービス"タグ名が指定され、値フィールドが空のままである場合、対応するユーザーグループには、タグ名が "Service" である選択されたホストグループに関するすべての障害が表示されます。タグ名と値の両方のフィールドが空のままで、ホストグループが選択されている場合、対応するユーザーグループには、選択されたホストグループのすべての障害が表示されます。タグ名とタグ値が正しく指定されていることを確認してください。そうでなければ、対応するユーザーグループには障害が表示されません。 あるユーザーが複数のユーザーグループのメンバーとして選択されている場合の例を見てみましょう。 この場合のフィルタリングは、タグにOR条件を使用します。 | | | | | | | | |---|---|---|---|---|---|---| |**ユーザーグループA**|<|<|**ユーザーグループB**|<|<|**両グループのユーザー(メンバー)に表示される結果**| |*タグフィルター*|<|<|<|<|<|<| |*ホストグループ*|*タグ名*|*タグ値*|*ホストグループ*|*タグ名*|*タグ値*|<| |Templates/Databases|Service|MySQL|Templates/Databases|Service|Oracle|Service: MySQL及びOracleの障害を表示| |Templates/Databases|*空*|*空*|Templates/Databases|Service|Oracle|全ての障害を表示| |*not selected*|*空*|*空*|Templates/Databases|Service|Oracle|<Service:Oracle>の障害を表示| ::: noteimportant フィルター（例えば、特定のホストグループ "テンプレート/データベース" のすべてのタグ）を追加すると、他のホストグループの障害が表示されなくなります。 ::: #### Configuration To configure a value mapping, follow these steps: 1\. Open the host or template configuration form. 2\. In the *Value mapping* tab, click *Add* to add a new value mapping, or click on the name of an existing mapping to edit it.  Parameters of a value mapping: |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Unique name for the set of value mappings.| |*Mappings*|<|Individual rules for mapping numeric/string values to string representations.<br><br>Mapping is applied in the order of the rules that can be reordered by dragging.| | |*Type*|Mapping type:<br>**equals** - equal values will be mapped;<br>**is greater than or equals** - equal or greater values will be mapped;<br>**is less than or equals** - equal or smaller values will be mapped;<br>**in range** - values in range will be mapped; the range is expressed as <number1>-<number2> or <number>; multiple ranges are supported (for example, 1-10,101-110,201);<br>**regexp** - values corresponding to the [regular expression](/manual/regular_expressions) will be mapped (global regular expressions are not supported);<br>**default** - all outstanding values will be mapped, other than those with specific mappings.<br><br>For mapping ranges, only numeric value types (*is greater than or equals*, *is less than or equals*, *in range*) are supported.| |^|*Value*|Incoming value (may contain a range or regular expression, depending on the mapping type).| |^|*Mapped to*|String representation (up to 64 characters) for the incoming value.| All mandatory input fields are marked with a red asterisk. When viewing the value mapping in the list, only the first three mappings are visible, with three dots indicating that more mappings exist.  #### 設定 値のマッピングは次の手順で設定します。 1\. ホストまたはテンプレートの設定フォームを開きます。 2\. *値のマッピング*タブで、*追加*をクリックして新しい値のマッピングを追加するか、既存の値のマッピングの名前をクリックして編集します。  値マッピングのパラメータ: |パラメータ|<|説明| |-|----------|----------------------------------------| |*名前*|<|値のマッピングのセットの一意の名前。| |*マッピング*|<|数値/文字列値を文字列表現にマッピングするための個別のルール。<br><br>マッピングはドラッグして順序を変更でき、ルールの順序で適用されます。| | |*タイプ*|マッピング タイプ:<br>**等しい** - 等しい値がマッピングされます。<br>**以上** - 等しいかそれより大きい値がマッピングされます。<br>**以下** - 等しいかそれより小さい値がマッピングされます。<br>**範囲内** - 範囲内の値がマッピングされます。範囲は <number1>-<number2> または <number>として表されます。複数の範囲がサポートされています (例: 1-10,101-110,201)。<br>**正規表現** - [正規表現](/manual/regular_expressions) に対応する値がマッピングされます (グローバル正規表現はサポートされていません)。<br>**デフォルト** - 特定のマッピングを持つ値を除く、すべての未処理の値がマッピングされます。<br><br>マッピング範囲では、数値タイプ (* 以上*、*以下*、*範囲内*) のみがサポートされます。| |^|*値*|受信値 (マッピングのタイプに応じて、範囲または正規表現が含まれる場合があります)。| |^|*マッピング文字列*|受信値の文字列表現 (最大 64 文字)。| 必須入力フィールドには赤いアスタリスクが付いています。 リスト内の値のマッピングを表示すると、最初の3つのマッピングのみが表示され、4つ目のドットは、その他にマッピングが存在することを示します。  #### Configuration To configure custom alertscripts as the media type: - Go to *Administration → Media types* - Click on *Create media type* The **Media type** tab contains general media type attributes:  All mandatory input fields are marked with a red asterisk. The following parameters are specific for the script media type: |Parameter|Description| |---------|-----------| |*Script name*|Enter the name of the script.| |*Script parameters*|Add command-line parameters to the script.<br>{ALERT.SENDTO}, {ALERT.SUBJECT} and {ALERT.MESSAGE} [macros](/manual/appendix/macros/supported_by_location) are supported in script parameters.<br>Customizing script parameters is supported since Zabbix 3.0.| See [common media type parameters](/manual/config/notifications/media#common_parameters) for details on how to configure default messages and alert processing options. ::: notewarning Even if an alertscript doesn't use default messages, message templates for operation types used by this media type must still be defined, otherwise a notification will not be sent. ::: ::: noteimportant As parallel processing of media types is implemented since Zabbix 3.4.0, it is important to note that with more than one script media type configured, these scripts may be processed in parallel by alerter processes. The total number of alerter processes is limited by the StartAlerters [parameter](/manual/appendix/config/zabbix_server). ::: #### 設定 カスタムアラートスクリプトをメディアタイプとして設定するには: - *Administration → Media types* に進みます。 - *Create media type* をクリックします。 **Media type** タブには、メディアタイプに関する一般的な属性が含まれています:  すべての必須入力フィールドには、赤いアスタリスクが表示されます。 以下のパラメータは、スクリプトメディアタイプに固有のものです: |パラメータ|説明| |---------|-----------| |*Script name*|Enter the name of the script.| |*Script parameters*|Add command-line parameters to the script.<br>{ALERT.SENDTO}, {ALERT.SUBJECT} and {ALERT.MESSAGE} [macros](/manual/appendix/macros/supported_by_location) are supported in script parameters.<br>Customizing script parameters is supported since Zabbix 3.0.| [common media type parameters](/manual/config/notifications/media#common_parameters) でデフォルトのメッセージとアラート処理オプションを設定する方法の詳細について説明します。 ::: notewarning アラートスクリプトがデフォルトのメッセージを使用しない場合でも、このメディアタイプで使用される操作タイプ用の<br> メッセージテンプレートが定義されていなければなりません。そうでなければ、通知は送られません。 ::: ::: noteimportant メディアタイプの並列処理は Zabbix 3.4.0 から実装されているため、複数のスクリプトメディアタイプが設定されている場合、これらの<br> スクリプトはアラータプロセスによって並行して処理される可能性があることに注意することが重要です。アラータプロセスの総数は、<br> StartAlerters [parameter](/manual/appendix/config/zabbix_server) によって制限されます。 ::: #### Configuration To configure event correlation rules globally: - Go to *Configuration* → *Event correlation* - Click on *Create correlation* to the right (or on the correlation name to edit an existing rule) - Enter parameters of the correlation rule in the form {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |---------|-----------| |*Name*|Unique correlation rule name.| |*Type of calculation*|The following options of calculating conditions are available:<br>**And** - all conditions must be met<br>**Or** - enough if one condition is met<br>**And/Or** - AND with different condition types and OR with the same condition type<br>**Custom expression** - a user-defined calculation formula for evaluating action conditions. It must include all conditions (represented as uppercase letters A, B, C, ...) and may include spaces, tabs, brackets ( ), **and** (case sensitive), **or** (case sensitive), **not** (case sensitive).| |*Conditions*|List of conditions. See below for details on configuring a condition.| |*Description*|Correlation rule description.| |*Operations*|Mark the checkbox of the operation to perform when event is correlated. The following operations are available:<br>**Close old events** - close old events when a new event happens. Always add a condition based on the old event when using the *Close old events* operation or all existing problems could be closed.<br>**Close new event** - close the new event when it happens| |*Enabled*|If you mark this checkbox, the correlation rule will be enabled.| To configure details of a new condition, click on  in the Conditions block. A popup window will open where you can edit the condition details.  |Parameter|Description| |---------|-----------| |*New condition*|Select a condition for correlating events.<br>*Note* that if no old event condition is specified, all old events may be matched and closed. Similarly if no new event condition is specified, all new events may be matched and closed.<br>The following conditions are available:<br>**Old event tag** - specify the old event tag for matching.<br>**New event tag** - specify the new event tag for matching.<br>**New event host group** - specify the new event host group for matching.<br>**Event tag pair** - specify new event tag and old event tag for matching. In this case there will be a match if the **values** of the tags in both events match. Tag *names* need not match.<br>This option is useful for matching runtime values, which may not be known at the time of configuration (see also [Example 1](/manual/config/event_correlation/global#examples)).<br>**Old event tag value** - specify the old event tag name and value for matching, using the following operators:<br>*equals* - has the old event tag value<br>*does not equal* - does not have the old event tag value<br>*contains* - has the string in the old event tag value<br>*does not contain* - does not have the string in the old event tag value<br>**New event tag value** - specify the new event tag name and value for matching, using the following operators:<br>*equals* - has the new event tag value<br>*does not equal* - does not have the new event tag value<br>*contains* - has the string in the new event tag value<br>*does not contain* - does not have the string in the new event tag value| ::: notewarning Because misconfiguration is possible, when similar event tags may be created for **unrelated** problems, please review the cases outlined below! ::: - Actual tags and tag values only become visible when a trigger fires. If the regular expression used is invalid, it is silently replaced with an \*UNKNOWN\* string. If the initial problem event with an \*UNKNOWN\* tag value is missed, there may appear subsequent OK events with the same \*UNKNOWN\* tag value that may close problem events which they shouldn't have closed. ```{=html} <!-- --> ``` - If a user uses the {ITEM.VALUE} macro without macro functions as the tag value, the 255-character limitation applies. When log messages are long and the first 255 characters are non-specific, this may also result in similar event tags for unrelated problems. #### 設定 イベント相関ルールをグローバルに設定するには - *Configuration* → *Event correlation* に進みます。 - 右側の *Create correlation* をクリックします (または、既存のルールを編集するために相関名をクリックします) - 相関ルールのパラメータをフォームに入力します。 {width="600"} 必須入力項目には、赤いアスタリスクが表示されています。 |パラメータ|説明| |---------|-----------| |*Name*|Unique correlation rule name.| |*Type of calculation*|The following options of calculating conditions are available:<br>**And** - all conditions must be met<br>**Or** - enough if one condition is met<br>**And/Or** - AND with different condition types and OR with the same condition type<br>**Custom expression** - a user-defined calculation formula for evaluating action conditions. It must include all conditions (represented as uppercase letters A, B, C, ...) and may include spaces, tabs, brackets ( ), **and** (case sensitive), **or** (case sensitive), **not** (case sensitive).| |*Conditions*|List of conditions. See below for details on configuring a condition.| |*Description*|Correlation rule description.| |*Operations*|Mark the checkbox of the operation to perform when event is correlated. The following operations are available:<br>**Close old events** - close old events when a new event happens. Always add a condition based on the old event when using the *Close old events* operation or all existing problems could be closed.<br>**Close new event** - close the new event when it happens| |*Enabled*|If you mark this checkbox, the correlation rule will be enabled.| 新しい条件の詳細を設定するには、条件ブロックの  をクリックします。<br> ポップアップウィンドウが開き、条件の詳細を編集することができます。  |パラメータ|説明| |---------|-----------| |*New condition*|Select a condition for correlating events.<br>*Note* that if no old event condition is specified, all old events may be matched and closed. Similarly if no new event condition is specified, all new events may be matched and closed.<br>The following conditions are available:<br>**Old event tag** - specify the old event tag for matching.<br>**New event tag** - specify the new event tag for matching.<br>**New event host group** - specify the new event host group for matching.<br>**Event tag pair** - specify new event tag and old event tag for matching. In this case there will be a match if the **values** of the tags in both events match. Tag *names* need not match.<br>This option is useful for matching runtime values, which may not be known at the time of configuration (see also [Example 1](/manual/config/event_correlation/global#examples)).<br>**Old event tag value** - specify the old event tag name and value for matching, using the following operators:<br>*equals* - has the old event tag value<br>*does not equal* - does not have the old event tag value<br>*contains* - has the string in the old event tag value<br>*does not contain* - does not have the string in the old event tag value<br>**New event tag value** - specify the new event tag name and value for matching, using the following operators:<br>*equals* - has the new event tag value<br>*does not equal* - does not have the new event tag value<br>*contains* - has the string in the new event tag value<br>*does not contain* - does not have the string in the new event tag value| ::: notewarning 設定ミスの可能性があるため、**関係ない**問題で似たようなイベントタグが作成される場合<br> 以下のケースを確認してください。 ::: - 実際のタグとタグの値は、トリガーが起動したときにのみ表示されます。使用された正規表現が無効な場合、それは黙って \*UNKNOWN** 文字列に置き換えられます。タグの値を持つ最初の問題イベントを見逃すと、同じタグの値を持つ後続の OKイベントが現れ、本来閉じられるべきでない問題イベントを閉じることがあります。 ```{=html} <!-- --> ``` - タグの値として、マクロ関数を使用しない{ITEM.VALUE}をタグの値として使用する場合、255文字の制限が適用されます。 ログメッセージが長く、最初の255文字が非特異的である場合、これはまた、無関係な問題のための類似のイベントタグに なる可能性があります。 #### Configuration To configure, select *Action log* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Sort entries by*|Sort entries by:<br>**Time** (descending or ascending)<br>**Type** (descending or ascending)<br>**Status** (descending or ascending)<br>**Recipient** (descending or ascending).| |*Show lines*|Set how many action log lines will be displayed in the widget.| #### 設定 設定するには、タイプで*アクションログ*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次の特定オプションを設定できます。 | | | |--|--------| |*次による項目のソート*|エントリを次の順序で並べ替えます:<br> **時間** (降順または昇順)<br> **タイプ** (降順または昇順)<br> **ステータス** (降順または昇順)<br>**送信先** (降順または昇順)| |*表示する行数*|ウィジェットに表示されるアクションログの行数を設定します。| #### Configuration To configure, select *Clock* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Time type*|Select local, server, or specified host time.<br>Server time will be identical to the time zone set globally or for the Zabbix user.| |*Item*|Select the item for displaying time. To display host time, use the `system.localtime[local]` [item](/manual/config/items/itemtypes/zabbix_agent). This item must exist on the host.<br>This field is available only when *Host time* is selected.| #### 設定 設定するには、タイプとして*時刻*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次の特定オプションを設定できます。 | | | |--|--------| |*時間の形式*|ローカル、サーバー、または指定されたホストの時間を選択します。<br>サーバー時間は、グローバルまたはZabbixユーザーに設定されたタイムゾーンと同じになります。| |*アイテム*|時間を表示するアイテムを選択します。ホスト時間を表示するには[アイテム](/manual/config/items/itemtypes/zabbix_agent)`system.localtime[local]`を使用します。 このアイテムはホストに存在する必要があります。<br>このフィールドは*ホスト時間*が選択されている場合にのみ使用できます。| #### Configuration To configure, select *Data overview* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups. Scroll down to select. Click on 'x' to remove the selected.| |*Hosts*|Select hosts. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts. Scroll down to select. Click on 'x' to remove the selected.| |*Tags*|Specify tags to limit the number of item data displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*Hosts location*|Select host location - left or top.| #### 設定 設定するにはタイプとして*データの概要*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)であるパラメーターに加えて、次のオプションを設定できます。 | | | |--|--------| |*ホストグループ*|ホストグループを選択します。 このフィールドはオートコンプリートであるため、グループの名前を入力し始めると、一致するグループ名のドロップダウンが表示されます。 スクロールして選択します。 'x'をクリックすると選択したものを削除できます。| |*ホスト*|ホストを選択します。 このフィールドはオートコンプリートであるため、ホストの名前を入力し始めると、一致するホスト名のドロップダウンが表示されます。 スクロールして選択します。 'x'をクリックすると選択したものを削除できます。| |*タグ*|タグを指定して、ウィジェットに表示されるアイテムデータの数を制限します。 特定のタグとタグ値を含めたり除外したりすることができます。 いくつかの条件を設定できます。 タグ名の照合では常に大文字と小文字が区別されます。<br>各条件で使用できる演算子はいくつかあります。<br>**存在する** - 指定されたタグ名を含める<br>**等しい** - 指定されたタグ名と値を含める（大文字と小文字を区別）<br> **含む** - タグ値に入力された文字列が含まれる場合に指定されたタグ名を含める（文字列の部分一致、大文字と小文字を区別しない）<br>**存在しない** - 指定されたタグ名を除外する<br>**等しくない**-指定されたタグ名と値を除外する（大文字と小文字を区別）<br>**含まない** - タグ値に入力された文字列が含まれる指定されたタグ名を除外する（文字列の部分一致、大文字と小文字を区別しない）<br>条件には2つの計算タイプがあります：<br>**And/Or** - すべての条件が満たされる必要があり、同じタグ名を持つ条件はOr条件によってグループ化されます<br>**Or** - 1つの条件が満たされる| |*メンテナンス中の障害を表示*|チェックボックスをオンにすると、ホストのメンテナンス中に抑制される（表示されない）障害が表示されます。| |*ホストの位置*|ホストの場所を左または上で選択します。| #### Configuration To configure, select *Graph* as type: {width="600"} The **Data set** tab allows to add data sets and define their visual representation: | | | | |-|----------|----------------------------------------| |*Data set*|<|Select hosts and items to display on the graph. Alternatively, you may enter host and item patterns. Wildcard patterns may be used (for example, `*` will return results that match zero or more characters). To specify a wildcard pattern, just enter the string manually and press *Enter*. While you are typing, note how all matching hosts are displayed in the dropdown.<br>Up to 50 items may be displayed in the graph.<br>Host pattern and item pattern fields are mandatory.<br>The wildcard symbol is always interpreted, therefore it is not possible to add, for example, an item named "item\*" individually, if there are other matching items (e.g. item2, item3).| | |*Base color*|Adjust base color, either from the color picker or manually. The base color is used to calculate different colors for each item of the data set. Base color input field is mandatory.| |^|*Draw*|Choose the draw type of the metric. Possible draw types are *Line* (set by default), *Points*, *Staircase* and *Bar*.<br>Note that if there's only one data point in the line/staircase graph it is drawn as a point regardless of the draw type. The point size is calculated from the line width, but it cannot be smaller than 3 pixels, even if the line width is less.| |^|*Width*|Set the line width. This option is available when *Line* or *Staircase* draw type is selected.| |^|*Point size*|Set the point size. This option is available when *Points* draw type is selected.| |^|*Transparency*|Set the transparency level.| |^|*Fill*|Set the fill level. This option is available when *Line* or *Staircase* draw type is selected.| |^|*Missing data*|Select the option for displaying missing data:<br>**None** - the gap is left empty<br>**Connected** - two border values are connected<br>**Treat as 0** - the missing data is displayed as 0 values<br>Not applicable for the *Points* and *Bar* draw type.| |^|*Y-axis*|Select the side of the graph where the Y-axis will be displayed.| |^|*Time shift*|Specify time shift if required. You may use [time suffixes](/manual/appendix/suffixes#time_suffixes) in this field. Negative values are allowed.| |^|*Aggregation function*|Specify which aggregation function to use:<br>**min** - display the smallest value<br>**max** - display the largest value<br>**avg** - display the average value<br>**sum** - display the sum of values<br>**count** - display the count of values<br>**first** - display the first value<br>**last** - display the last value<br>**none** - display all values (no aggregation)<br>Aggregation allows to display an aggregated value for the chosen interval (5 minutes, an hour, a day), instead of all values. See also: [Aggregation in graphs](/manual/config/visualization/graphs/aggregate).<br>This option is supported since Zabbix 4.4.| |^|*Aggregation interval*|Specify the interval for aggregating values. You may use [time suffixes](/manual/appendix/suffixes#time_suffixes) in this field. A numeric value without a suffix will be regarded as seconds.<br>This option is supported since Zabbix 4.4.| |^|*Aggregate*|Specify whether to aggregate:<br>**Each item** - each item in the dataset will be aggregated and displayed separately.<br>**Data set** - all dataset items will be aggregated and displayed as one value.<br>This option is supported since Zabbix 4.4.| Existing data sets are displayed in a list. You may: -  - click on this button to add a new data set -  - click on the color icon to expand/collapse data set details -  - click on the move icon and drag a data set to a new place in the list #### 設定 設定するにはタイプとして*グラフ*を選択します。 {width="600"} **データセット**タブではデータセットを追加し、それらの視覚的表現を定義できます。 | | | | |-|----------|----------------------------------------| |*データセット*|<|グラフに表示するホストとアイテムを選択またはホストとアイテムのパターンを入力することもできます。 ワイルドカードパターンを使用できます。（たとえば`*`は0個以上の文字に一致する結果を返します） ワイルドカードパターンを指定するには、文字列を手動で入力して*Enter*を押します。 入力中は、一致するすべてのホストがドロップダウンに表示されます。<br>グラフには最大50個のアイテムが表示される場合があります。<br>ホストパターンとアイテムパターンのフィールドは必須です。<br>ワイルドカード記号は常に 解釈されるため、他に一致するアイテム（item2、item3など）がある場合、たとえば「item\*」という名前のアイテムを個別に追加することはできません。| | |*基本色*|カラーピッカーからまたは手動でベースカラーを調整します。 基本色は、データセットの各項目の異なる色を計算するために使用されます。 基本色の入力は必須です。| |^|*グラフの形式*|グラフ表示形式を選択します。 選択可能な形式は、*線*（デフォルト）、* ポイント*、*階段*、および*棒*です。<br>線/階段グラフにデータポイントが1つしかない場合は、グラフ形式に関係なく、ポイントとして描画されます。 ポイントサイズは線幅から計算されますが3ピクセル以上にすることはできません。| |^|*幅*|線幅を設定します。 このオプションは*線*または*階段*のグラフ形式が選択されている場合に使用できます。| |^|*ポイントサイズ*|ポイントサイズを設定します。 このオプションは*ポイント*グラフ形式が選択されている場合に使用できます。| |^|*透明度*|透明度を設定します。| |^|*塗りつぶし*|塗りつぶしのレベルを設定します。 このオプションは*線*または*階段*のグラフ形式が選択されている場合に使用できます。| |^|*欠損データ*|欠損データを表示するためのオプションを選択します。<br>**なし** - 欠損データは空白とします<br>**接続する** - 欠損値の境界値が接続されます<br>**0とみなす** - 欠損データは 0として表示されます<br>*ポイント*および*バー*グラフ形式には適用されません。| |^|*Y軸*|Y軸が表示されるグラフの側を選択します。| |^|*タイムシフト*|必要に応じてタイムシフトを指定します。 このフィールドでは、[タイムサフィックス](/manual/appendix/suffixes#time_suffixes)を使用できます。 負の値が許可されます。| |^|*アグリゲーション関数*|使用する集計関数を指定します。<br>**最小** - 最小値を表示します<br>**最大** - 最大値を表示します<br>**平均** - 平均値を表示します<br>**合計** - 値の合計を表示します<br>**個数** - 値の数を表示します<br>**第１** - 最初の値を表示します<br>**最新値** - 最後の値を表示します <br> **なし** - すべての値を表示します（集計なし）<br>集計を使用すると、すべての値ではなく、選択した間隔（5分、1時間、1日）の集計値を表示できます。 参照：[グラフの集計](/manual/config/visualization/graphs/aggregate)<br>このオプションは、Zabbix4.4以降でサポートされています。| |^|*アグリゲーション間隔*|値を集計する間隔を指定します。 このフィールドでは[タイムサフィックス](/manual/appendix/suffixes#time_suffixes)を使用できます。 サフィックスのない数値は秒と見なされます。<br>このオプションはZabbix4.4以降でサポートされています。| |^|*アグリゲート*|集計対象を指定します。<br>**アイテムごと** - データセット内の各アイテムが集計され、個別に表示されます。<br>**データセット** - すべてのデータセットアイテムが集計され、1つの値として表示されます。< br>このオプションはZabbix4.4以降でサポートされています。| 既存のデータセットがリストに表示されます。次のこともできます。 -  - このボタンをクリックして、新しいデータセットを追加します -  - カラーアイコンをクリックして、データセットの詳細を展開または折りたたみます -  - 移動アイコンをクリックして、データセットをリスト内の新しい場所にドラッグします #### Configuration To configure, select *Graph (classic)* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |---|---| |*Source*|Select graph type:<br>**Graph** - custom graph<br>**Simple graph** - simple graph| |*Graph*|Select the custom graph to display.<br>This option is available if 'Graph' is selected as *Source*.| |*Item*|Select the item to display in a simple graph.<br>This option is available if 'Simple graph' is selected as *Source*.| |*Show legend*|Unmark this checkbox to hide the legend on the graph (marked by default).| |*[Dynamic item](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Set graph to display different data depending on the selected host.| Information displayed by the classic graph widget can be downloaded as .png image using the [widget menu](/manual/web_interface/frontend_sections/monitoring/dashboard#widget_menu):  A screenshot of the widget will be saved to the Downloads folder. #### 設定 設定するにはタイプとして*グラフ（クラシック）*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて次のオプションを設定できます。 | | | |---|---| |*ソース*|グラフの種類を選択<br>**グラフ** - カスタムグラフ<br>**シンプルグラフ** - シンプルグラフ| |*グラフ*|表示するカスタムグラフを選択します。<br>このオプションは*ソース*が*グラフ*として選択されている場合に使用できます。| |*アイテム*|シンプルグラフで表示する項目を選択します。<br>このオプションは*ソース*が*シンプルグラフ*として選択されている場合に使用できます。| |*凡例を表示*|グラフの凡例を非表示にするには、このチェックボックスをオフにします（デフォルトはオン）| |*[ダイナミックアイテム](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|選択したホストに応じて異なるデータを表示するようにグラフを設定します。| クラシックグラフウィジェットによって表示される情報は[ウィジェットメニュー](/manual/web_interface/frontend_sections/monitoring/dashboard#widget_menu)を使用して.png画像としてダウンロードできます。  ウィジェットのスクリーンショットがダウンロードフォルダーに保存されます。 #### Configuration To configure, select *Graph prototype* as widget type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |---|---| |*Source*|Select source: either a **Graph prototype** or a **Simple graph prototype**.| |*Graph prototype*|Select a graph prototype to display discovered graphs of the graph prototype.<br>This option is available if 'Graph prototype' is selected as Source.| |*Item prototype*|Select an item prototype to display simple graphs based on discovered items of an item prototype.<br>This option is available if 'Simple graph prototype' is selected as Source.| |*Show legend*|Mark this checkbox to show the legend on the graphs (marked by default).| |*[Dynamic item](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Set graphs to display different data depending on the selected host.| |*Columns*|Enter the number of columns of graphs to display within a graph prototype widget.| |*Rows*|Enter the number of rows of graphs to display within a graph prototype widget.| While the *Columns* and *Rows* settings allow fitting more than one graph in the widget, there still may be more discovered graphs than there are columns/rows in the widget. In this case paging becomes available in the widget and a slide-up header allows to switch between pages using the left and right arrows.  #### 設定 設定するにはウィジェットタイプとして*グラフのプロトタイプ*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて次のオプションを設定できます。 | | | |---|---| |*ソース*|ソースを**グラフのプロトタイプ**か**シンプルグラフのプロトタイプ**から選択します.| |*グラフのプロトタイプ*|グラフのプロトタイプを選択すると、グラフのプロトタイプでディスカバリされたグラフが表示されます。<br>このオプションは、[ソース]として[グラフのプロトタイプ]が選択されている場合に使用できます。| |*アイテムのプロトタイプ*|アイテムのプロトタイプを選択すると、アイテムのプロトタイプでディスカバリされたアイテムに基づいてシンプルグラフが表示されます。<br>このオプションは[ソース]として[シンプルグラフのプロトタイプ]が選択されている場合に使用できます。| |*凡例を表示*|このチェックボックスをオンにすると、グラフに凡例が表示されます（デフォルトはオン）| |*[ダイナミックアイテム](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|選択したホストに応じて異なるデータを表示するようにグラフを設定します。| |*列*|グラフプロトタイプウィジェット内に表示するグラフの列数を入力します。| |*行*|グラフプロトタイプウィジェット内に表示するグラフの行数を入力します。| *列*および*行*設定では、ウィジェットに複数のグラフを適合させることができますが、ウィジェットに列/行があるよりも多くのグラフが検出される場合があります。 この場合はウィジェットでページングが使用可能になり、スライドアップヘッダーで左矢印と右矢印を使用してページを切り替えることができます。  #### Configuration To configure, select *Host availability* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host group(s). This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups. Scroll down to select. Click on 'x' to remove the selected.| |*Interface type*|Select which host interfaces you want to see availability data for.<br>Availability of all interfaces is displayed by default if nothing is selected.| |*Layout*|Select horizontal display (columns) or vertical display (lines).| |*Show hosts in maintenance*|Include hosts that are in maintenance in the statistics.| #### 設定 設定するには、タイプとして*ホスト稼働状況*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。 | | | |--|--------| |*ホストグループ*|ホストグループを選択します。 このフィールドはオートコンプリートであるため、グループ名を入力し始めると、一致するグループ名がドロップダウンで表示されます。 スクロールして選択します。 'x'をクリックすると選択したものを削除できます。| |*インターフェースタイプ*|稼働状況データを表示するホストインターフェースを選択します。<br>何も選択されていない場合、デフォルトですべてのインターフェースの稼働状況が表示されます。| |*レイアウト*|水平表示（列）または垂直表示（行）を選択します。| |*メンテナンス中のホストを表示*|メンテナンス中のホストを統計に含めます。| #### Configuration To configure, select *Item value* as the widget type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |_**Item**_ |Select the item. | |_**Show**_ |Mark the checkbox to display the respective element (description, value, time, change indicator). Unmark to hide.<br>At least one element must be selected. | |_**Advanced configuration**_ |Mark the checkbox to display [advanced configuration](#advanced-configuration) options. | |_**[Dynamic item](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic-widgets)**_ |Mark the checkbox to display a different value depending on the selected host. | #### 設定 設定するにはタイプとして*アイテムの値*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。 | | | |--|--------| |*アイテム*|アイテムを選択します| |*表示*|チェックボックスをオンにすると、それぞれの要素（説明、値、時間、変化表示）が表示されます。 非表示にするには、マークを外します。<br>少なくとも1つの要素を選択する必要があります。| |*高度な設定*|チェックボックスをオンにすると、詳細設定オプションが表示されます。| |*ダイナミックアイテム*|チェックボックスをオンにすると、選択したホストに応じて異なる値が表示されます。| #### Configuration To configure, select *Map navigation tree* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Show unavailable maps*|Mark this checkbox to display maps that the user does not have read permission to.<br>Unavailable maps in the navigation tree will be displayed with a grayed-out icon.<br>Note that if this checkbox is marked, available [submaps](/manual/config/visualization/maps/map#adding-elements) are displayed even if the parent level map is unavailable. If unmarked, available submaps to an unavailable parent map will not be displayed at all.<br>Problem count is calculated based on available maps and available map elements.| #### 設定 マップナビゲーションウィジェットを設定するには、タイプとして*マップナビゲーション*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。 | | | |--|--------| |*使用不可なマップの表示*|このチェックボックスをオンにすると、ユーザーが読み取り権限を持たないマップも表示されます。<br>ナビゲーションツリーで使用できないマップは、灰色のアイコンで表示されます。<br>注：このチェックボックスをオンにすると、使用可能なサブマップが表示されます。 親レベルマップが使用できない場合でも表示されます。 オフの場合、使用できない親マップへの使用可能なサブマップはまったく表示されません。<br>障害数は、使用可能なマップと使用可能なマップ要素に基づいて計算されます。| #### Configuration To configure, select *Plain text* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |---|---| |*Items*|Select the items.| |*Items location*|Choose the location of selected items to be displayed in the widget.| |*Show lines*|Set how many latest data lines will be displayed in the widget.| |*Show text as HTML*|Set to display text as HTML.| |*[Dynamic item](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Set to display different data depending on the selected host.| #### 設定 設定するにはタイプで*プレーンテキスト*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。 | | | |---|---| |*アイテム*|アイテムを選択します| |*アイテム名の位置*|ウィジェットに表示するアイテムの場所を選択します。| |*表示する行数*|ウィジェットに表示される最新データ行の数を設定します。| |*HTMLとしてテキストを表示*|テキストをHTMLとして表示するように設定します。| |*[ダイナミックアイテム](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|選択したホストに応じて異なるデータを表示するように設定します。| #### Configuration To configure, select *Problem hosts* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: |Parameter|Description| |---------|-----------| |*Host groups*|Enter host groups to display in the widget. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Host data from these host groups will be displayed in the widget. If no host groups are entered, all host groups will be displayed.| |*Exclude host groups*|Enter host groups to hide from the widget. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups.<br>Specifying a parent host group implicitly selects all nested host groups.<br>Host data from these host groups will not be displayed in the widget. For example, hosts 001, 002, 003 may be in Group A and hosts 002, 003 in Group B as well. If we select to *show* Group A and *exclude* Group B at the same time, only data from host 001 will be displayed in the Dashboard.| |*Hosts*|Enter hosts to display in the widget. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts.<br>If no hosts are entered, all hosts will be displayed.| |*Problem*|You can limit the number of problem hosts displayed by the problem name. If you enter a string here, only those hosts with problems whose name contains the entered string will be displayed. Macros are not expanded.| |*Severity*|Mark the problem severities to be displayed in the widget.| |*Tags*|Specify problem tags to limit the number of problems displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*Hide groups without problems*|Mark the *Hide groups without problems* option to hide data from host groups without problems in the widget.| |*Problem display*|Display problem count as:<br>**All** - full problem count will be displayed<br>**Separated** - unacknowledged problem count will be displayed separated as a number of the total problem count<br>**Unacknowledged only** - only the unacknowledged problem count will be displayed.| #### 設定 設定するにはタイプとして*障害中のホスト*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。 |パラメータ|詳細| |---------|-----------| |*ホストグループ*|ウィジェットに表示するホストグループを入力します。 このフィールドはオートコンプリートであるため、グループ名を入力し始めると、一致するグループ名がドロップダウンで表示されます。<br>親ホストグループを指定すると、ネストされたすべてのホストグループが暗黙的に選択され、ホストデータがウィジェットに表示されます。 ホストグループが入力されていない場合、すべてのホストグループが表示されます。| |*除外するホストグループ*|ウィジェットから非表示にするホストグループを入力します。このフィールドはオートコンプリートであるため、グループ名を入力し始めると、一致するグループ名がドロップダウンで表示されます。<br>親ホストグループを指定すると、ネストされたすべてのホストグループが暗黙的に選択されます。<br>これらのホストグループからのホストデータはウィジェットに表示されますが、たとえばホスト001、002、003はグループAにあり、ホスト002、003もグループBにあるとします。その上でグループAを*表示*し、グループBを*除外*した場合、ホスト001からのデータのみがダッシュボードに表示されます。| |*ホスト*|ウィジェットに表示するホストを入力します。このフィールドはオートコンプリートであるため、ホストの名前を入力し始めると、一致するホスト名がドロップダウンで表示されます。<br>ホスト名が入力されていない場合は、すべてのホストが表示されます。| |*障害*|障害名で表示される障害中のホスト数を制限できます。 ここに文字列を入力すると、名前に入力した文字列が含まれている障害中のホストのみが表示されます。 マクロは展開されません。| |*深刻度*|ウィジェットに表示する障害の深刻度をマークします。| |*タグ*|障害タグを指定して、ウィジェットに表示される障害の数を制限します。 特定のタグとタグ値を含めたり除外したりすることができます。 いくつかの条件を設定できます。 タグ名の照合では常に大文字と小文字が区別されます。<br>各条件で使用できる演算子はいくつかあります。<br>**Exists** - 指定されたタグ名を含める<br>**Equals** - 指定されたタグ名と値を含める（大文字と小文字を区別）<br> **Contains** - タグ値に入力された文字列が含まれる場合に指定されたタグ名を含める（文字列の部分一致、大文字と小文字を区別しない）<br>**Does not exist** - 指定されたタグ名を除外する<br>**Does not equal**-指定されたタグ名と値を除外する（大文字と小文字を区別）<br>**Does not contain** - タグ値に入力された文字列が含まれる指定されたタグ名を除外する（文字列の部分一致、大文字と小文字を区別しない）<br>条件には2つの計算タイプがあります：<br>**And/Or** - すべての条件が満たされる必要があり、同じタグ名を持つ条件はOr条件によってグループ化されます<br >**Or** - 1つの条件が満たされる| |*メンテナンス中の障害を表示*|チェックボックスをオンにすると、ホストのメンテナンスで抑制される（表示されない）障害が表示されます| |*障害のないグループを隠す*|ウィジェットで障害のないホストグループデータを非表示にするには、オプションをオンにします。| |*障害の表示*|障害数を表示方法を指定します：<br>**すべて** - 完全な障害数が表示されます<br>**障害と未確認数を表示** - 未確認の障害数は合計障害数と分離して表示されます<br>**未確認のみ**-未確認の障害数のみ表示されます。| #### Configuration To configure, select *System information* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Show*|Select what to display:<br>**System stats** - display a summary of key Zabbix server and system data;<br>**High availability nodes** - display the status of high availability nodes (if [high availability cluster](/manual/concepts/server/ha) is enabled).| #### 設定 設定するにはタイプとして*システム情報*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters)パラメーターに加えて、次の特定のオプションを設定できます。 | | | |--|--------| |*表示*|表示する内容を選択します:<br>**システムステータス** - 主要なZabbixサーバーとシステムデータの概要を表示します。<br>**HAノード** - 高可用性ノードのステータスを表示します ([高可用性クラスター](/manual/concepts/server/ha)が有効な場合)。| #### Configuration To configure, select *Top hosts* as type: {width="600"} #### 設定 設定するにはタイプとして*上位ホスト*を選択します。 {width="600"} #### Configuration To configure, select *Trigger overview* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Show*|Filter triggers by trigger state:<br>**Recent problems** - *(default)* show triggers that recently have been or still are in a PROBLEM state (resolved and unresolved);<br>**Problems** - show triggers that are in a PROBLEM state (unresolved);<br>**Any** - show all triggers.| |*Host groups*|Select the host group(s). This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups.| |*Hosts*|Select hosts. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts. Scroll down to select. Click on 'x' to remove the selected.| |*Tags*|Specify tags to filter the triggers displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values.<br>Several conditions can be set. Tag name matching is always case-sensitive.<br><br>**Note:** If the parameter *Show* is set to 'Any', all triggers will be displayed even if tags are specified. However, while recent trigger state changes (displayed as blinking blocks) will update for all triggers, the trigger state details (problem severity color and whether the problem is acknowledged) will only update for triggers that match the specified tags.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the *Or* condition;<br>**Or** - enough if one condition is met.| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*Hosts location*|Select host location - left or top.| #### 設定 設定するにはタイプとして*トリガーの概要*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。 | | | |--|--------| |*表示*|障害のステータスでフィルタリング：<br> **最近の障害** - 未解決の障害と最近解決された障害問題が表示されます（デフォルト）<br>**障害** - 未解決の障害が表示されます<br>**すべて** - すべての履歴イベントが表示されます| |*ホストグループ*|ホストグループを選択します。 このフィールドはオートコンプリートであるため、グループ名を入力し始めると、一致するグループがドロップダウンで表示されます。| |*ホスト*|ホストを選択します。 このフィールドはオートコンプリートであるため、ホスト名を入力し始めると、一致するホスト名がドロップダウンで表示されます。 スクロールして選択します。 'x'をクリックして選択したものを削除できます。| |*タグ*|タグを指定して、ウィジェットに表示されるアイテムとトリガーデータの数を制限します。 特定のタグとタグ値を含めたり除外したりすることができます。 いくつかの条件を設定できます。 タグ名の照合では常に大文字と小文字が区別されます。<br>各条件で使用できる演算子はいくつかあります。<br>**Exists** - 指定されたタグ名を含める<br>**Equals** - 指定されたタグ名と値を含める（大文字と小文字を区別）<br> **Contains** - タグ値に入力された文字列が含まれる場合に指定されたタグ名を含める（文字列の部分一致、大文字と小文字を区別しない）<br>**Does not exist** - 指定されたタグ名を除外する<br>**Does not equal**-指定されたタグ名と値を除外する（大文字と小文字を区別）<br>**Does not contain** - タグ値に入力された文字列が含まれる指定されたタグ名を除外する（文字列の部分一致、大文字と小文字を区別しない）<br>条件には2つの計算タイプがあります：<br>**And/Or** - すべての条件が満たされる必要があり、同じタグ名を持つ条件はOr条件によってグループ化されます<br >**Or** - 1つの条件が満たされる| |*メンテナンス中の障害を表示*|チェックボックスをオンにすると、ホストのメンテナンスで抑制される（表示されない）障害が表示されます。| |*ホストの位置*|ホストの場所を左または上で選択します。| #### Configuration To configure, select *URL* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*URL*|Enter the URL to display.<br>External URLs must start with `http://` or `https://`.<br>Since Zabbix 4.4.8, internal URLs support relative paths (for example, `zabbix.php?action=report.status`).<br>{HOST.\*} macros are supported.| |*[Dynamic item](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Set to display different URL content depending on the selected host.<br>This can work if {HOST.\*} macros are used in the URL.| ::: noteimportant Browsers might not load an HTTP page included in the widget if Zabbix frontend is accessed over HTTPS. ::: #### 設定 設定するにはタイプとして*URL*を選択します。  すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。 | | | |--|--------| |*URL*|表示するURLを入力します。<br>Zabbix4.4.8以降、相対パスが許可されています。<br>{HOST.\*}マクロがサポートされています。| |*[ダイナミックアイテム](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|選択したホストに応じて異なるURLコンテンツを表示するように設定します。<br>これはURLで{HOST.\*}マクロが使用されている場合に機能します。| ::: noteimportant ZabbixフロントエンドがHTTPS経由でアクセスされる場合、ブラウザはウィジェットに含まれるHTTPページをロードしない可能性があります。 ::: #### Configuration To configure SMS as the media type: - Go to *Administration → Media types* - Click on *Create media type* (or click on *SMS* in the list of pre-defined media types). The following parameters are specific for the SMS media type: |Parameter|Description| |---------|-----------| |*GSM modem*|Set the serial device name of the GSM modem.| See [common media type parameters](/manual/config/notifications/media#common_parameters) for details on how to configure default messages and alert processing options. Note that parallel processing of sending SMS notifications is not possible. #### 設定 メディアタイプとしてSMSを設定するには: - *Administration → Media types* に進みます。 - *Create media type* をクリックします （または、定義済みメディアタイプのリストから *SMS* をクリックします） 以下のパラメータは、SMSメディアタイプに固有のものです: |Parameter|Description| |---------|-----------| |*GSM modem*|Set the serial device name of the GSM modem.| [common media type parameters](/manual/config/notifications/media#common_parameters)を参照してください。SMS通知の送信は並列処理できないことに注意してください。 #### Configuration To create an ad-hoc graph, do the following: - Go to *Monitoring* → *Latest data* - Use filter to display items that you want - Mark checkboxes of the items you want to graph - Click on *Display stacked graph* or *Display graph* buttons {width="600"} Your graph is created instantly: {width="600"} Note that to avoid displaying too many lines in the graph, only the average value for each item is displayed (min/max value lines are not displayed). Triggers and trigger information is not displayed in the graph. In the created graph window you have the [time period selector](/manual/config/visualization/graphs/simple#time_period_selector) available and the possibility to switch from the "normal" line graph to a stacked one (and back). {width="600"} #### 設定 アドホックグラフを作成するには、次のようにします: - *Monitoring* → *Latest data* に移動します。 - フィルタを使用して、必要な項目を表示します。 - グラフにしたい項目のチェックボックスをマークします。 - *Display stacked graph* または *Display graph* ボタンをクリックする {width="600"} グラフは瞬時に作成されます: {width="600"} なお、グラフの線が多くなりすぎないように、各項目の平均値のみを表示します。（最小値/最大値の線は表示されません）<br> trigger と trigger 情報はグラフに表示されません。 作成されたグラフウィンドウでは、[time period selector](/manual/config/visualization/graphs/simple#time_period_selector) が利用でき、"通常の"折れ線グラフから<br> 積み上げグラフに切り替えることができます。（戻ることも可能です） {width="600"} ### Configuration To create a new service action, go to the *Service actions* subsection of the *Services* menu, then click on *Create action* in the upper right corner. Service actions are configured in the same way as other types of actions in Zabbix. For more details, see configuring [actions](/manual/config/notifications/action#configuring-an-action). The key differences are: - User access to service actions depends on access rights to services granted by user's [role](/manual/web_interface/frontend_sections/administration/user_roles). - Service actions support different set of [conditions](#conditions). ### 設定 新しいサービスアクションを作成するには、*Services*メニューの*Service actions*サブセクションに移動し、右上隅にある*Create action*をクリックします。 サービスアクションは、Zabbixの他のタイプのアクションと同じ方法で設定されます。詳細については[actions](/manual/config/notifications/action#configuring-an-action)を参照してください。 主な違いは次のとおりです。 - サービスアクションへのユーザーアクセスは、ユーザー[role](/manual/web_interface/frontend_sections/Administration/user_roles)によって付与されたサービスへのアクセス権に依存します。 - サービスアクションは、さまざまな[条件](#conditions)のセットをサポートします。 ### Configuration To create a new SLA, click on the *Create SLA* button. The **SLA** tab allows to specify general SLA parameters. {width=600} |Parameter|Description| |---------|-----------| |*Name*|Enter the SLA name. | |*SLO*|Enter the service level objective (SLO) as percentage. | |*Reporting period*|Selecting the period will affect what periods are used in the [SLA report](/manual/web_interface/frontend_sections/services/sla_report) - *daily*, *weekly*, *monthly*, *quarterly*, or *annually*. | |*Time zone*|Select the SLA time zone. | |*Schedule*|Select the SLA schedule - 24x7 or custom. | |*Effective date*|Select the date of starting SLA calculation. | |*Service tags*|Add service tags to identify the services towards which this SLA should be applied. <br> **Name** - service tag name, must be exact match, case-sensitive. <br> **Operation** - select *Equals* if the tag value must match exactly (case-sensitive) or *Contains* if part of the tag value must match (case-insensitive). <br> **Value** - service tag value to search for according to selected operation.<br> The SLA is applied to a service, if at least one service tag matches. | |*Description*|Add a description for the SLA. | |*Enabled*|Mark the checkbox to enable the SLA calculation. | The **Excluded downtimes** tab allows to specify downtimes that are excluded from the SLA calculation. {width=600} Click on *Add* to configure excluded downtimes, then enter the period name, start date and duration. ### 設定 新しいSLAを作成するには*Create SLA*ボタンをクリックします。 **SLA**タブでは、一般的なSLAパラメータを設定できます。 {width=600} |パラメータ|説明| | --------- | ----------- | |*Name*|SLA名を入力します。 | | *SLO* |サービスレベル目標（SLO）をパーセンテージで入力します。 | |*Reporting period*|[SLAレポート](/manual/web_interface/frontend_sections/services/sla_report)で使用される期間を設定します - *daily*,*weekly*,*monthly*,*quarterly*,*annually*| |*Time zone*|SLAタイムゾーンを選択します。| |*Schedule*|SLAスケジュールを選択します-24時間365日またはカスタム。| |*Effective date*|SLA計算を開始する日付を選択します。 | |*Service tags*|サービスタグを追加して、このSLAを適用する必要のあるサービスを識別します。 <br> **Name** - サービスタグ名。完全一致。大文字と小文字が区別されます。 <br> **Operation** - タグ値が完全に一致する必要がある場合は*Equals*（大文字と小文字を区別）、タグ値の一部が一致する必要がある場合は*Contains*（大文字と小文字を区別しない）を選択します。 <br>**Value** - 選択した操作に従って検索するサービスタグの値。<br>少なくとも1つのサービスタグが一致する場合、SLAがサービスに適用されます。 | |*Description*|SLAの説明を追加します。 | |*Enabled*|チェックボックスをオンにして、SLA計算を有効にします。 | **Excluded downtimes**タブでは、SLA計算から除外されるダウンタイムを指定できます。 {width=600} [Add]をクリックして除外されたダウンタイムを構成し、期間名、開始日、および期間を入力します。 #### Configuration To ensure proper communication between all elements involved make sure server configuration file and frontend configuration file parameters are properly configured. #### 設定 関連するすべての要素間の適切な通信を確保するには、サーバー構成ファイルとフロントエンド構成ファイルのパラメーターが適切に構成されていることを確認してください。 #### Configuration To execute a passive check immediately: - click on *Execute now* in an existing item (or discovery rule) configuration form:  - click on *Execute now* for selected items/rules in the list of items/discovery rules:  In the latter case several items/rules can be selected and "executed now" at once. #### 設定 パッシブ監視をすぐに実行するには: - 既存のアイテム(またはディスカバリールール)設定フォームで、*監視データ取得*をクリックします。  - アイテム/ディスカバリールールのリストで選択されたアイテム/ルール に対して、*監視データ取得*をクリックします。:  後者の場合、複数のアイテム/ルールを選択し、一度に*監視データ取得*することができます。 #### Configuration To start using a webhook integration: 1. Locate required .xml file in the `templates/media` directory of the downloaded Zabbix version or download it from Zabbix [git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse) 2. [Import](/manual/xml_export_import/media#importing) the file into your Zabbix installation. The webhook will appear in the list of media types. 3. Configure the webhook according to instructions in the *Readme.md* file (you may click on a webhook's name above to quickly access *Readme.md*). To create a custom webhook from scratch: - Go to *Administration → Media types* - Click on *Create media type* The **Media type** tab contains various attributes specific for this media type:  All mandatory input fields are marked with a red asterisk. The following parameters are specific for the webhook media type: |Parameter|Description| |---------|-----------| |*Parameters*|Specify the webhook variables as the attribute and value pairs.<br>For preconfigured webhooks, a list of parameters varies, depending on the service. Check the webhook's *Readme.md* file for parameter description.<br>For new webhooks, several common variables are included by default (URL:<empty>, HTTPProxy:<empty>, To:{ALERT.SENDTO}, Subject:{ALERT.SUBJECT}, <Message:%7BALERT.MESSAGE>}), feel free to keep or remove them.<br>All [macros](/manual/appendix/macros/supported_by_location) that are supported in problem notifications are supported in the parameters.<br>If you specify an HTTP proxy, the field supports the same functionality as in the item configuration [HTTP proxy](/manual/config/items/itemtypes/http#configuration) field. The proxy string may be prefixed with `[scheme]://` to specify which kind of proxy is used (e.g. https, socks4, socks5; see [documentation](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html)).| |*Script*|Enter JavaScript code in the block that appears when clicking in the parameter field (or on the view/edit button next to it). This code will perform the webhook operation.<br>The script is a function code that accepts parameter - value pairs. The values should be converted into JSON objects using JSON.parse() method, for example: `var params = JSON.parse(value);`.<br><br>The code has access to all parameters, it may perform HTTP GET, POST, PUT and DELETE requests and has control over HTTP headers and request body.<br>The script must contain a return operator, otherwise it will not be valid. It may return OK status along with an optional list of tags and tag values (see *Process tags* option) or an error string.<br><br>Note, that the script is executed only after an alert is created. If the script is configured to return and process tags, these tags will not get resolved in {EVENT.TAGS} and {EVENT.RECOVERY.TAGS} macros in the initial problem message and recovery messages because the script has not had the time to run yet.<br><br>See also: [Webhook development guidelines](https://www.zabbix.com/documentation/guidelines/en/webhooks), [Webhook script examples](/manual/config/notifications/media/webhook/webhook_examples), [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects).<br>| |*Timeout*|JavaScript execution timeout (1-60s, default 30s).<br>Time suffixes are supported, e.g. 30s, 1m.| |*Process tags*|Mark the checkbox to process returned JSON property values as tags. These tags are added to the already existing (if any) problem event tags in Zabbix.<br>If a webhook uses tags (the Process tags checkbox is marked), the webhook should always return a JSON object containing at least an empty object for tags:`var result = {tags: {}};`.<br>Examples of tags that can be returned: *Jira ID: PROD-1234*, *Responsible: John Smith*, *Processed:<no value>*, etc.| |*Include event menu entry*|Mark the checkbox to include an entry in the [event menu](/manual/web_interface/frontend_sections/monitoring/problems#event_menu) linking to the created external ticket.<br>If marked, the webhook should not be used to send notifications to different users (consider creating a [dedicated user](/manual/config/notifications/media/webhook#user_media) instead) or in several alert actions [related to a single problem event](/manual/config/notifications/media/webhook#configuring_alert_actions).| |*Menu entry name*|Specify the menu entry name.<br>{EVENT.TAGS.<tag name>} macro is supported.<br>This field is only mandatory if *Include event menu entry* is selected.| |*Menu entry URL*|Specify the underlying URL of the menu entry.<br>{EVENT.TAGS.<tag name>} macro is supported.<br>This field is only mandatory if *Include event menu entry* is selected.| See [common media type parameters](/manual/config/notifications/media#common_parameters) for details on how to configure default messages and alert processing options. ::: notewarning Even if a webhook doesn't use default messages, message templates for operation types used by this webhook must still be defined. ::: #### 構成 Webhook 連携の利用を開始するには: 1. ダウンロードしたZabbixのtemplates/media`ディレクトリにある必要な.xmlファイルを見つけるか、Zabbix [git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse)からダウンロードしてください。 2. ファイルを Zabbix のインストールに[Import](/manual/xml_export_import/media#importing) します。メディアタイプのリストに Webhookが表示されます。 3. *Readme.md*ファイルの指示に従ってWebhookを設定します(上記のWebhookの名前をクリックすると、 *Readme.md*にすぐにアクセスできます) カスタムWebhookをゼロから作成する場合: - *Administration → Media types* に進みます。 - *Create media type* をクリックします。 **Media type** タブには、そのメディアタイプに固有のさまざまな属性が含まれています:  すべての必須入力フィールドには、赤いアスタリスクが表示されます。 以下のパラメータは、webhook メディアタイプに固有のものです: |パラメータ|説明| |---------|-----------| |*Parameters*|Specify the webhook variables as the attribute and value pairs.<br>For preconfigured webhooks, a list of parameters varies, depending on the service. Check the webhook's *Readme.md* file for parameter description.<br>For new webhooks, several common variables are included by default (URL:<empty>, HTTPProxy:<empty>, To:{ALERT.SENDTO}, Subject:{ALERT.SUBJECT}, <Message:%7BALERT.MESSAGE>}), feel free to keep or remove them.<br>All [macros](/manual/appendix/macros/supported_by_location) that are supported in problem notifications are supported in the parameters.<br>If you specify an HTTP proxy, the field supports the same functionality as in the item configuration [HTTP proxy](/manual/config/items/itemtypes/http#configuration) field. The proxy string may be prefixed with `[scheme]://` to specify which kind of proxy is used (e.g. https, socks4, socks5; see [documentation](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html)).| |*Script*|Enter JavaScript code in the block that appears when clicking in the parameter field (or on the view/edit button next to it). This code will perform the webhook operation.<br>The script is a function code that accepts parameter - value pairs. The values should be converted into JSON objects using JSON.parse() method, for example: `var params = JSON.parse(value);`.<br><br>The code has access to all parameters, it may perform HTTP GET, POST, PUT and DELETE requests and has control over HTTP headers and request body.<br>The script must contain a return operator, otherwise it will not be valid. It may return OK status along with an optional list of tags and tag values (see *Process tags* option) or an error string.<br><br>Note, that the script is executed only after an alert is created. If the script is configured to return and process tags, these tags will not get resolved in {EVENT.TAGS} and {EVENT.RECOVERY.TAGS} macros in the initial problem message and recovery messages because the script has not had the time to run yet.<br><br>See also: [Webhook development guidelines](https://www.zabbix.com/documentation/guidelines/en/webhooks), [Webhook script examples](/manual/config/notifications/media/webhook/webhook_examples), [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects).<br>| |*Timeout*|JavaScript execution timeout (1-60s, default 30s).<br>Time suffixes are supported, e.g. 30s, 1m.| |*Process tags*|Mark the checkbox to process returned JSON property values as tags. These tags are added to the already existing (if any) problem event tags in Zabbix.<br>If a webhook uses tags (the Process tags checkbox is marked), the webhook should always return a JSON object containing at least an empty object for tags:`var result = {tags: {}};`.<br>Examples of tags that can be returned: *Jira ID: PROD-1234*, *Responsible: John Smith*, *Processed:<no value>*, etc.| |*Include event menu entry*|Mark the checkbox to include an entry in the [event menu](/manual/web_interface/frontend_sections/monitoring/problems#event_menu) linking to the created external ticket.<br>If marked, the webhook should not be used to send notifications to different users (consider creating a [dedicated user](/manual/config/notifications/media/webhook#user_media) instead) or in several alert actions [related to a single problem event](/manual/config/notifications/media/webhook#configuring_alert_actions).| |*Menu entry name*|Specify the menu entry name.<br>{EVENT.TAGS.<tag name>} macro is supported.<br>This field is only mandatory if *Include event menu entry* is selected.| |*Menu entry URL*|Specify the underlying URL of the menu entry.<br>{EVENT.TAGS.<tag name>} macro is supported.<br>This field is only mandatory if *Include event menu entry* is selected.| デフォルトのメッセージとアラート処理オプションを設定する方法の詳細については [common media type parameters](/manual/config/notifications/media#common_parameters) を参照してください。 ::: notewarning Webhook がデフォルトメッセージを使用しない場合でも、この Webhook が使用する操作タイプ用のメッセージテンプレートは<br> 定義されている必要があります。 ::: #### Configuration Two steps are required to close a problem manually. #### 設定 手動で障害を閉じるには、2つのステップが必要です。 #### Configuration We assume that TimescaleDB extension has been already installed on the database server (see [installation instructions](https://docs.timescale.com/latest/getting-started/installation)). TimescaleDB extension must also be enabled for the specific DB by executing: echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix Running this command requires database administrator privileges. ::: noteclassic If you use a database schema other than 'public' you need to add a SCHEMA clause to the command above. E.g.:\ `echo "CREATE EXTENSION IF NOT EXISTS timescaledb SCHEMA yourschema CASCADE;" | sudo -u postgres psql zabbix` ::: Then run the `timescaledb.sql` script located in database/postgresql. For new installations the script must be run after the regular PostgreSQL database has been created with initial schema/data (see [database creation](/manual/appendix/install/db_scripts)): cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix The migration of existing history and trend data may take a lot of time. Zabbix server and frontend must be down for the period of migration. The `timescaledb.sql` script sets the following housekeeping parameters: - Override item history period - Override item trend period In order to use partitioned housekeeping for history and trends, both these options must be enabled. It is also possible to enable override individually either for history only or trends only. For PostgreSQL version 10.2 or higher and TimescaleDB version 1.5 or higher, the `timescaledb.sql` script sets two additional parameters: - Enable compression - Compress records older than 7 days #### 設定 TimescaleDB 拡張機能がデータベース サーバーに既にインストールされていることを前提としています ([インストール手順](https://docs.timescale.com/latest/getting-started/installation)を参照) 次のコマンドを実行して、特定の DB に対して TimescaleDB 拡張機能を有効にする必要があります。 echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix このコマンドを実行するには、データベース管理者権限が必要です。 ::: noteclassic 'public' 以外のデータベース スキーマを使用する場合は、上記のコマンドに SCHEMA 句を追加する必要があります。 例：\`echo "CREATE EXTENSION IF NOT EXISTS timescaledb SCHEMA yourschema CASCADE;" | sudo -u postgres psql zabbix` ::: 次に、database/postgresql にある `timescaledb.sql` スクリプトを実行します。 新規インストールの場合、通常のPostgreSQL データベースが初期スキーマ/データで作成された後にスクリプトを実行する必要があります ([データベースの作成](/manual/appendix/install/db_scripts) を参照) cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix 既存のヒストリおよびトレンドデータの移行には、時間がかかる場合があります。 移行中は、Zabbix サーバーとフロントエンドを停止する必要があります。 `timescaledb.sql` スクリプトは、次のハウスキーピング パラメータを設定します。 - Override item history period - Override item trend period ヒストリとトレンドに分割されたハウスキーピングを使用するには、これらのオプションを両方とも有効にする必要があります。 ヒストリのみまたはトレンドのみのオーバーライドを個別に有効にすることもできます。 PostgreSQL バージョン 10.2 以降および TimescaleDB バージョン 1.5 以降の場合、`timescaledb.sql` スクリプトは 2 つの追加パラメーターを設定します。 - Enable compression - Compress records older than 7 days ##### Configure database for Zabbix proxy Edit Zabbix proxy configuration file (``/etc/zabbix/zabbix_proxy.conf``): DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> In DBName for Zabbix proxy use a separate database from Zabbix server. In DBPassword use Zabbix database password for MySQL; PostgreSQL user password for PostgreSQL. Use `DBHost=` with PostgreSQL. You might want to keep the default setting `DBHost=localhost` (or an IP address), but this would make PostgreSQL use a network socket for connecting to Zabbix. Refer to the [respective section](/manual/installation/install_from_packages/rhel#selinux_configuration) for RHEL for instructions. ##### Zabbixプロキシのデータベース設定 Zabbixプロキシ設定ファイル(``/etc/zabbix/zabbix_proxy.conf``)を編集します。 DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> Zabbixプロキシ用のDBNameは、Zabbixサーバーとは別のデータベースを使用します。 MySQLの場合は、DBPasswordにZabbixデータベースパスワードを使用します。 PostgreSQLの場合は、PostgreSQLユーザーのパスワードを使用します。 PostgreSQLでは、`DBHost=`を使用します。デフォルト設定の`DBHost=localhost` (またはIPアドレス)を使用したい場合、PostgreSQLがZabbixへの接続にネットワーク ソケットを使用することになります。 手順については、RHELの[それぞれのセクション](/manual/installation/install_from_packages/rhel#SELinuxの設定)を参照してください。 ##### Configure database for Zabbix proxy Edit Zabbix proxy configuration file (``/etc/zabbix/zabbix_proxy.conf``): DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> In DBName for Zabbix proxy use a separate database from Zabbix server. In DBPassword use Zabbix database password for MySQL; PostgreSQL user password for PostgreSQL. Use `DBHost=` with PostgreSQL. You might want to keep the default setting `DBHost=localhost` (or an IP address), but this would make PostgreSQL use a network socket for connecting to Zabbix. See [SELinux configuration](/manual/installation/install_from_packages/rhel#selinux_configuration) for instructions. ##### Zabbixプロキシのデータベース設定 Zabbixプロキシ設定ファイル(``/etc/zabbix/zabbix_proxy.conf``)を編集します。 DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> Zabbixプロキシ用のDBNameは、Zabbixサーバーとは別のデータベースを使用します。 MySQLの場合は、DBPasswordにZabbixデータベースパスワードを使用します。 PostgreSQLの場合は、PostgreSQLユーザーのパスワードを使用します。 PostgreSQLでは、`DBHost=`を使用します。デフォルト設定の`DBHost=localhost` (またはIPアドレス)を使用したい場合、PostgreSQLがZabbixへの接続にネットワーク ソケットを使用することになります。 手順については[SELinuxの設定](/manual/installation/install_from_packages/rhel#SELinuxの設定)を参照してください。 ##### Configure database for Zabbix proxy Edit zabbix\_proxy.conf: # vi /etc/zabbix/zabbix_proxy.conf DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> In DBName for Zabbix proxy use a separate database from Zabbix server. In DBPassword use Zabbix database password for MySQL; PostgreSQL user password for PostgreSQL. Use `DBHost=` with PostgreSQL. You might want to keep the default setting `DBHost=localhost` (or an IP address), but this would make PostgreSQL use a network socket for connecting to Zabbix. See [SELinux configuration](/manual/installation/install_from_packages/rhel_centos#selinux_configuration) for instructions. ##### Zabbix プロキシのデータベースを構成する zabbix\_proxy.conf を編集します: # vi /etc/zabbix/zabbix_proxy.conf DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> Zabbix プロキシの DBName は、Zabbix サーバーとは別のデータベースを使用します。 MySQLの場合はDBPassword に Zabbix データベース パスワードを使用します。 PostgreSQLの場合はPostgreSQLユーザーのパスワードを使用します。 PostgreSQL では `DBHost=` を使用します。 デフォルト設定の `DBHost=localhost` (または IP アドレス) を使用したい場合もありますが、その場合、 PostgreSQL が Zabbix への接続にネットワーク ソケットを使用することになります。 手順については[SELinux 設定](/manual/installation/install_from_packages/rhel_centos#selinux_configuration) を参照してください。 #### Configure database for Zabbix server/proxy Edit Zabbix server configuration file (``/etc/zabbix/zabbix_server.conf``) and, if required, Zabbix proxy configuration file (``/etc/zabbix/zabbix_proxy.conf``) for their respective databases. For example: DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> In DBPassword use Zabbix database password for MySQL; PostgreSQL user password for PostgreSQL. Use `DBHost=` with PostgreSQL. You might want to keep the default setting `DBHost=localhost` (or an IP address), but this would make PostgreSQL use a network socket for connecting to Zabbix. #### Zabbixサーバー/プロキシのデータベースの設定 Zabbixサーバー設定ファイル(``/etc/zabbix/zabbix_server.conf``)を編集し、必要に応じて、それぞれのデータベースのZabbixプロキシ設定ファイル(``/etc/zabbix/zabbix_proxy.conf``)を編集します。 例: DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> MySQLの場合は、DBPasswordにZabbixデータベースパスワードを使用します。PostgreSQLの場合は、PostgreSQLユーザーのパスワードを使用します。 PostgreSQLでは、`DBHost=`を使用します。デフォルト設定の`DBHost=localhost` (またはIPアドレス)を使用したい場合、PostgreSQLがZabbixへの接続にネットワーク ソケットを使用することになります。 #### Configure DB connection Enter details for connecting to the database. Zabbix database must already be created. {width="550"} If the *Database TLS encryption* option is checked, then additional fields for [configuring the TLS connection](/manual/appendix/install/db_encrypt) to the database appear in the form (MySQL or PostgreSQL only). If HashiCorp Vault option is selected for storing credentials, additional fields are available for specifying the Vault API endpoint, secret path and authentication token: {width="550"} #### DB接続設定 データベースに接続するための詳細を入力します。 Zabbix データベースがすでに作成されている必要があります。 {width="550"} *Database TLS encryption*オプションがオンになっている場合、データベースへの[TLS接続を構成](/manual/appendix/install/db_encrypt)するための追加フィールドがフォームに表示されます (MySQL または PostgreSQL のみ)。 認証情報の保存にHashiCorp Vaultオプションが選択されている場合、Vault APIエンドポイント、シークレットパス、および認証トークンを指定するための追加フィールドが使用できます。 {width="550"} ###### Configure request A request to execute the *Configure* function of the *Configurator* interface. | | | |---|---| |direction|agent → plugin| |response|n/a| Parameters specific to *Configure* requests: |Name|Type|Comments| |---------|--------|----------| |global_options|JSON object|JSON object containing global agent configuration options.| |private_options|JSON object (optional)|JSON object containing private plugin configuration options, if provided.| *Example:* {"id":6,"type":8,"global_options":{...},"private_options":{...}} ###### 構成リクエスト *Configurator* インターフェースの *Configure* 機能を実行するためのリクエスト | | | |---|---| |direction|agent → plugin| |response|n/a| *Configure* リクエスト固有のパラメーター: |名前|タイプ|コメント| |---------|--------|----------| |global_options|JSON オブジェクト|グローバルエージェント構成オプションを含む JSON オブジェクト| |private_options|JSON オブジェクト (オプション)|プライベートプラグイン構成オプション (指定されている場合) を含む JSON オブジェクト| *例:* {"id":6,"type":8,"global_options":{...},"private_options":{...}} #### Configuring a *Clock* widget Configure a *Clock* widget that displays Zabbix server time. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "clock", "name": "Clock", "x": 0, "y": 0, "width": 4, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "time_type", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *時計*ウィジェットの設定 Zabbixサーバー時間を表示する*時計*ウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "clock", "name": "Clock", "x": 0, "y": 0, "width": 4, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "time_type", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Data overview* widget Configure a *Data overview* widget that displays data for host "10084" and only for items for which the tag with the name "component" contains value "cpu". In addition, display the data with hosts located on top. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "dataover", "name": "Data overview", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 3, "name": "hostids", "value": 10084 }, { "type": 1, "name": "tags.tag.0", "value": "component" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "cpu" }, { "type": 0, "name": "style", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *データの概要*ウィジェットの設定 ホスト"10084"のデータと、名前が"component"のタグに値として"cpu"が含まれるアイテムのみを表示する*データの概要*ウィジェットを設定します。 さらに、ホストを最上位に表示します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "dataover", "name": "Data overview", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 3, "name": "hostids", "value": 10084 }, { "type": 1, "name": "tags.tag.0", "value": "component" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "cpu" }, { "type": 0, "name": "style", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring agent Both generations of Zabbix agents run as a Windows service. For Zabbix agent 2, replace *agentd* with *agent2* in the instructions below. You can run a single instance of Zabbix agent or multiple instances of the agent on a Microsoft Windows host. A single instance can use the default configuration file `C:\zabbix_agentd.conf` or a configuration file specified in the command line. In case of multiple instances each agent instance must have its own configuration file (one of the instances can use the default configuration file). An example configuration file is available in Zabbix source archive as `conf/zabbix_agentd.win.conf`. See the [configuration file](/manual/appendix/config/zabbix_agentd_win) options for details on configuring Zabbix Windows agent. #### エージェントの設定 Zabbixエージェントは両世代ともWindowsサービスとして実行されます。 Zabbixエージェント2の場合、以下の手順で*agentd*を*agent2*に置き換えます。 MicrosoftWindowsホスト上でZabbixエージェントの単一インスタンスまたは複数インスタンスを実行できます。単一インスタンスの場合は、デフォルトの設定ファイル`C:\zabbix_agentd.conf`またはコマンドラインで指定された設定ファイルを使用できます。複数インスタンスの場合は、各エージェントインスタンスに独自の構成ファイルが必要です。（1つのインスタンスだけデフォルト構成ファイルを使用できます） 設定ファイルの例はZabbixソースアーカイブで`conf/zabbix_agentd.win.conf`として入手できます。 Zabbix Windowsエージェントの設定詳細については[設定ファイル](/manual/appendix/config/zabbix_agentd_win)オプションを参照してください。 #### Configuring a *Geomap* widget Configure a *Geomap* widget that displays hosts from host groups "2" and "22" based on the following tag configuration: tag with the name "component" contains value "node", or tag with the name "location" equals value "New York". In addition, set the map initial view to coordinates "40.6892494" (latitude), "-74.0466891" (longitude) with the zoom level "10". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "geomap", "name": "Geomap", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 22 }, { "type": 2, "name": "groupids", "value": 2 }, { "type": 1, "name": "default_view", "value": "40.6892494,-74.0466891,10" }, { "type": 0, "name": "evaltype", "value": 2 }, { "type": 1, "name": "tags.tag.0", "value": "component" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "node" }, { "type": 1, "name": "tags.tag.1", "value": "location" }, { "type": 0, "name": "tags.operator.1", "value": 1 }, { "type": 1, "name": "tags.value.1", "value": "New York" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *地理マップ*ウィジェットの設定 以下のタグ設定に基づいて、ホストグループ"2"と"22"のホストを表示する*地理マップ*ウィジェットを設定します。 "component"という名前のタグに"node"という値が含まれる、または"location"という名前のタグに"New York"という値と等しいもの。 さらに、マップの初期表示を座標"40.6892494"(緯度)、"-74.0466891"(経度)、ズームレベル"10"に設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "geomap", "name": "Geomap", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 22 }, { "type": 2, "name": "groupids", "value": 2 }, { "type": 1, "name": "default_view", "value": "40.6892494,-74.0466891,10" }, { "type": 0, "name": "evaltype", "value": 2 }, { "type": 1, "name": "tags.tag.0", "value": "component" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "node" }, { "type": 1, "name": "tags.tag.1", "value": "location" }, { "type": 0, "name": "tags.operator.1", "value": 1 }, { "type": 1, "name": "tags.value.1", "value": "New York" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Graph (classic)* widget Configure a *Graph (classic)* widget that displays a simple graph for the item "42269". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "graph", "name": "Graph (classic)", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 1 }, { "type": 4, "name": "itemid", "value": 42269 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *グラフ（クラシック）*ウィジェットの設定 アイテム"42269"のシンプルなグラフを表示する*グラフ（クラシック）*ウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "graph", "name": "Graph (classic)", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 1 }, { "type": 4, "name": "itemid", "value": 42269 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Graph prototype* widget Configure a *Graph prototype* widget that displays a grid of 3 graphs (3 columns, 1 row) created from an item prototype (ID: "42316") by low-level discovery. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "graphprototype", "name": "Graph prototype", "x": 0, "y": 0, "width": 16, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 3 }, { "type": 5, "name": "itemid", "value": 42316 }, { "type": 0, "name": "columns", "value": 3 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *グラフのプロトタイプ*ウィジェットの設定 ローレベルディスカバリによってアイテムのプロトタイプ(ID: "42316")から作成された3つのグラフ(3列、1行)のグリッドを表示する*グラフのプロトタイプ*ウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "graphprototype", "name": "Graph prototype", "x": 0, "y": 0, "width": 16, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 3 }, { "type": 5, "name": "itemid", "value": 42316 }, { "type": 0, "name": "columns", "value": 3 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Graph* widget Configure a *Graph* widget in the following way: - 4 data sets for a total of 9 items on 1 host. - Each data set consists of a line that has a custom color, width, transparency, and fill. - Data set 4 has a configured aggregation. - Data in the graph are displayed for a time period of the last 3 hours. - Problems in the graph are displayed only for the configured items. - Graph has two Y axes of which the right Y axis displays values only for Data set 4. - Graph legend displays configured items in 2 rows. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "svggraph", "name": "Graph", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "ds.hosts.0.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.0.0", "value": "Zabbix server: Utilization of poller data collector processes, in %" }, { "type": 1, "name": "ds.color.0", "value": "FF0000" }, { "type": 0, "name": "ds.width.0", "value": 3 }, { "type": 0, "name": "ds.transparency.0", "value": 3 }, { "type": 0, "name": "ds.fill.0", "value": 1 }, { "type": 1, "name": "ds.hosts.1.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.1.0", "value": "Zabbix server: Utilization of trapper data collector processes, in %" }, { "type": 1, "name": "ds.color.1", "value": "BF00FF" }, { "type": 0, "name": "ds.width.1", "value": 3 }, { "type": 0, "name": "ds.transparency.1", "value": 3 }, { "type": 0, "name": "ds.fill.1", "value": 1 }, { "type": 1, "name": "ds.hosts.2.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.2.0", "value": "Zabbix server: Utilization of history syncer internal processes, in %" }, { "type": 1, "name": "ds.color.2", "value": "0040FF" }, { "type": 0, "name": "ds.width.2", "value": 3 }, { "type": 0, "name": "ds.transparency.2", "value": 3 }, { "type": 0, "name": "ds.fill.2", "value": 1 }, { "type": 1, "name": "ds.hosts.3.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.3.0", "value": "*: Number of processed *values per second" }, { "type": 1, "name": "ds.color.3", "value": "000000" }, { "type": 0, "name": "ds.transparency.3", "value": 0 }, { "type": 0, "name": "ds.fill.3", "value": 0 }, { "type": 0, "name": "ds.axisy.3", "value": 1 }, { "type": 0, "name": "ds.aggregate_function.3", "value": 3 }, { "type": 1, "name": "ds.aggregate_interval.3", "value": "1m" }, { "type": 0, "name": "ds.aggregate_grouping.3", "value": 1 }, { "type": 0, "name": "graph_time", "value": 1 }, { "type": 1, "name": "time_from", "value": "now-3h" }, { "type": 0, "name": "legend_lines", "value": 2 }, { "type": 0, "name": "show_problems", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *グラフ*ウィジェットの設定 *グラフ*ウィジェットを次のように設定します。 - 1つのホストに合計9つのアイテムの4つのデータセットがあります。 - 各データセットは、カスタムの色、幅、透明度、塗りつぶしを持つ線で構成されています。 - データセット4には集計が設定されています。 - グラフのデータは、過去3時間のデータが表示されます。 - グラフ内の障害は、設定されたアイテムについてのみ表示されます。 - グラフには2つのY軸があり、右側のY軸にはデータセット4の値のみが表示されます。 - グラフの凡例には、設定されたアイテムが2行で表示されます。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "svggraph", "name": "Graph", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "ds.hosts.0.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.0.0", "value": "Zabbix server: Utilization of poller data collector processes, in %" }, { "type": 1, "name": "ds.color.0", "value": "FF0000" }, { "type": 0, "name": "ds.width.0", "value": 3 }, { "type": 0, "name": "ds.transparency.0", "value": 3 }, { "type": 0, "name": "ds.fill.0", "value": 1 }, { "type": 1, "name": "ds.hosts.1.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.1.0", "value": "Zabbix server: Utilization of trapper data collector processes, in %" }, { "type": 1, "name": "ds.color.1", "value": "BF00FF" }, { "type": 0, "name": "ds.width.1", "value": 3 }, { "type": 0, "name": "ds.transparency.1", "value": 3 }, { "type": 0, "name": "ds.fill.1", "value": 1 }, { "type": 1, "name": "ds.hosts.2.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.2.0", "value": "Zabbix server: Utilization of history syncer internal processes, in %" }, { "type": 1, "name": "ds.color.2", "value": "0040FF" }, { "type": 0, "name": "ds.width.2", "value": 3 }, { "type": 0, "name": "ds.transparency.2", "value": 3 }, { "type": 0, "name": "ds.fill.2", "value": 1 }, { "type": 1, "name": "ds.hosts.3.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.3.0", "value": "*: Number of processed *values per second" }, { "type": 1, "name": "ds.color.3", "value": "000000" }, { "type": 0, "name": "ds.transparency.3", "value": 0 }, { "type": 0, "name": "ds.fill.3", "value": 0 }, { "type": 0, "name": "ds.axisy.3", "value": 1 }, { "type": 0, "name": "ds.aggregate_function.3", "value": 3 }, { "type": 1, "name": "ds.aggregate_interval.3", "value": "1m" }, { "type": 0, "name": "ds.aggregate_grouping.3", "value": 1 }, { "type": 0, "name": "graph_time", "value": 1 }, { "type": 1, "name": "time_from", "value": "now-3h" }, { "type": 0, "name": "legend_lines", "value": 2 }, { "type": 0, "name": "show_problems", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a linked *Map* widget Configure a *Map* widget that is linked to a [*Map navigation tree*](/manual/api/reference/dashboard/widget_fields/map_tree#configuring-a-map-navigation-tree-widget) widget. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "map", "name": "Map", "x": 0, "y": 5, "width": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 2 }, { "type": 1, "name": "filter_widget_reference", "value": "ABCDE" } ] }, { "type": "navtree", "name": "Map navigation tree", "x": 0, "y": 0, "width": 6, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.name.1", "value": "Element A" }, { "type": 1, "name": "navtree.name.2", "value": "Element B" }, { "type": 1, "name": "navtree.name.3", "value": "Element C" }, { "type": 1, "name": "navtree.name.4", "value": "Element A1" }, { "type": 1, "name": "navtree.name.5", "value": "Element A2" }, { "type": 1, "name": "navtree.name.6", "value": "Element B1" }, { "type": 1, "name": "navtree.name.7", "value": "Element B2" }, { "type": 0, "name": "navtree.parent.4", "value": 1 }, { "type": 0, "name": "navtree.parent.5", "value": 1 }, { "type": 0, "name": "navtree.parent.6", "value": 2 }, { "type": 0, "name": "navtree.parent.7", "value": 2 }, { "type": 0, "name": "navtree.order.1", "value": 1 }, { "type": 0, "name": "navtree.order.2", "value": 2 }, { "type": 0, "name": "navtree.order.3", "value": 3 }, { "type": 0, "name": "navtree.order.4", "value": 1 }, { "type": 0, "name": "navtree.order.5", "value": 2 }, { "type": 0, "name": "navtree.order.6", "value": 1 }, { "type": 0, "name": "navtree.order.7", "value": 2 }, { "type": 8, "name": "navtree.sysmapid.6", "value": 1 }, { "type": 1, "name": "reference", "value": "ABCDE" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### リンクされた*マップ*ウィジェットの設定 [*マップナビゲーション*](/manual/api/reference/dashboard/widget_fields/map_tree#configuring-a-map-navigation-tree-widget)ウィジェットにリンクされた*マップ*ウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "map", "name": "Map", "x": 0, "y": 5, "width": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 2 }, { "type": 1, "name": "filter_widget_reference", "value": "ABCDE" } ] }, { "type": "navtree", "name": "Map navigation tree", "x": 0, "y": 0, "width": 6, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.name.1", "value": "Element A" }, { "type": 1, "name": "navtree.name.2", "value": "Element B" }, { "type": 1, "name": "navtree.name.3", "value": "Element C" }, { "type": 1, "name": "navtree.name.4", "value": "Element A1" }, { "type": 1, "name": "navtree.name.5", "value": "Element A2" }, { "type": 1, "name": "navtree.name.6", "value": "Element B1" }, { "type": 1, "name": "navtree.name.7", "value": "Element B2" }, { "type": 0, "name": "navtree.parent.4", "value": 1 }, { "type": 0, "name": "navtree.parent.5", "value": 1 }, { "type": 0, "name": "navtree.parent.6", "value": 2 }, { "type": 0, "name": "navtree.parent.7", "value": 2 }, { "type": 0, "name": "navtree.order.1", "value": 1 }, { "type": 0, "name": "navtree.order.2", "value": 2 }, { "type": 0, "name": "navtree.order.3", "value": 3 }, { "type": 0, "name": "navtree.order.4", "value": 1 }, { "type": 0, "name": "navtree.order.5", "value": 2 }, { "type": 0, "name": "navtree.order.6", "value": 1 }, { "type": 0, "name": "navtree.order.7", "value": 2 }, { "type": 8, "name": "navtree.sysmapid.6", "value": 1 }, { "type": 1, "name": "reference", "value": "ABCDE" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Map navigation tree* widget Configure a *Map navigation tree* widget that displays the following map navigation tree: - Element A - Element A1 - Element A2 - Element B - Element B1 (contains linked map "1" that can be displayed in a [linked *Map widget*](/manual/api/reference/dashboard/widget_fields/map#configuring-a-linked-map-widget)) - Element B2 - Element C Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "navtree", "name": "Map navigation tree", "x": 0, "y": 0, "width": 6, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.name.1", "value": "Element A" }, { "type": 1, "name": "navtree.name.2", "value": "Element B" }, { "type": 1, "name": "navtree.name.3", "value": "Element C" }, { "type": 1, "name": "navtree.name.4", "value": "Element A1" }, { "type": 1, "name": "navtree.name.5", "value": "Element A2" }, { "type": 1, "name": "navtree.name.6", "value": "Element B1" }, { "type": 1, "name": "navtree.name.7", "value": "Element B2" }, { "type": 0, "name": "navtree.parent.4", "value": 1 }, { "type": 0, "name": "navtree.parent.5", "value": 1 }, { "type": 0, "name": "navtree.parent.6", "value": 2 }, { "type": 0, "name": "navtree.parent.7", "value": 2 }, { "type": 0, "name": "navtree.order.1", "value": 1 }, { "type": 0, "name": "navtree.order.2", "value": 2 }, { "type": 0, "name": "navtree.order.3", "value": 3 }, { "type": 0, "name": "navtree.order.4", "value": 1 }, { "type": 0, "name": "navtree.order.5", "value": 2 }, { "type": 0, "name": "navtree.order.6", "value": 1 }, { "type": 0, "name": "navtree.order.7", "value": 2 }, { "type": 8, "name": "navtree.sysmapid.6", "value": 1 }, { "type": 1, "name": "reference", "value": "ABCDE" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *マップナビゲーション*ウィジェットの設定 以下のマップナビゲーションツリーを表示する*マップナビゲーション*ウィジェットを設定します: - 要素A - 要素A1 - 要素A2 - 要素B - 要素B1 ([リンクされた*マップウィジェット*](/manual/api/reference/dashboard/widget_fields/map#configuring-a-linked-map-widget)に表示できるリンクされたマップ"1"を含む) - 要素B2 - 要素C リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "navtree", "name": "Map navigation tree", "x": 0, "y": 0, "width": 6, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.name.1", "value": "Element A" }, { "type": 1, "name": "navtree.name.2", "value": "Element B" }, { "type": 1, "name": "navtree.name.3", "value": "Element C" }, { "type": 1, "name": "navtree.name.4", "value": "Element A1" }, { "type": 1, "name": "navtree.name.5", "value": "Element A2" }, { "type": 1, "name": "navtree.name.6", "value": "Element B1" }, { "type": 1, "name": "navtree.name.7", "value": "Element B2" }, { "type": 0, "name": "navtree.parent.4", "value": 1 }, { "type": 0, "name": "navtree.parent.5", "value": 1 }, { "type": 0, "name": "navtree.parent.6", "value": 2 }, { "type": 0, "name": "navtree.parent.7", "value": 2 }, { "type": 0, "name": "navtree.order.1", "value": 1 }, { "type": 0, "name": "navtree.order.2", "value": 2 }, { "type": 0, "name": "navtree.order.3", "value": 3 }, { "type": 0, "name": "navtree.order.4", "value": 1 }, { "type": 0, "name": "navtree.order.5", "value": 2 }, { "type": 0, "name": "navtree.order.6", "value": 1 }, { "type": 0, "name": "navtree.order.7", "value": 2 }, { "type": 8, "name": "navtree.sysmapid.6", "value": 1 }, { "type": 1, "name": "reference", "value": "ABCDE" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Map* widget Configure a *Map* widget that displays the map "1". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "map", "name": "Map", "x": 0, "y": 0, "width": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 8, "name": "sysmapid", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *マップ*ウィジェットの設定 マップ"1"を表示する*マップ*ウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "map", "name": "Map", "x": 0, "y": 0, "width": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 8, "name": "sysmapid", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring and running Java gateway By default, Java gateway listens on port 10052. If you plan on running Java gateway on a different port, you can specify that in settings.sh script. See the description of [Java gateway configuration file](/manual/appendix/config/zabbix_java) for how to specify this and other options. ::: notewarning Port 10052 is not [IANA registered](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). ::: Once you are comfortable with the settings, you can start Java gateway by running the startup script: ./startup.sh Likewise, once you no longer need Java gateway, run the shutdown script to stop it: ./shutdown.sh Note that unlike server or proxy, Java gateway is lightweight and does not need a database. #### Javaゲートウェイの設定と実行 デフォルトでは、Javaゲートウェイはポート10052でリッスンします。別のポートでJavaゲートウェイを実行したい場合は、settings.shスクリプトで指定できます。このオプションやその他のオプションの指定方法については、[Javaゲートウェイ設定ファイル](/manual/appendix/config/zabbix_java)の説明を参照してください。 ::: notewarning ポート10052は[IANA登録済み](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt)ではありません。 ::: 設定完了後、起動スクリプトを実行してJavaゲートウェイを起動できます。 ./startup.sh 同様にJavaゲートウェイが不要になったら、シャットダウンスクリプトを実行して停止できます。 ./shutdown.sh サーバーやプロキシとは異なり、Javaゲートウェイは軽量でありデータベースを必要としません。 #### Configuring and running Java gateway Configuration parameters of Zabbix Java gateway may be tuned in the file: /etc/zabbix/zabbix_java_gateway.conf For more details, see Zabbix Java gateway configuration [parameters](/manual/appendix/config/zabbix_java). To start Zabbix Java gateway: # service zabbix-java-gateway restart To automatically start Zabbix Java gateway on boot: RHEL 7 and later: # systemctl enable zabbix-java-gateway RHEL prior to 7: # chkconfig --level 12345 zabbix-java-gateway on #### Java ゲートウェイの設定と実行 Zabbix Java ゲートウェイの設定パラメータは、次のファイルで調整できます。 /etc/zabbix/zabbix_java_gateway.conf 詳細については、Zabbix Java ゲートウェイ設定[パラメーター](/manual/appendix/config/zabbix_java)を参照してください。 Zabbix Java ゲートウェイを起動するには: # service zabbix-java-gateway restart 起動時に Zabbix Java ゲートウェイを自動的に起動するには: RHEL 7 以降: # systemctl enable zabbix-java-gateway RHEL 7 以前: # chkconfig --level 12345 zabbix-java-gateway on #### Configuring and running Java gateway Configuration parameters of Zabbix Java gateway may be tuned in the file: /etc/zabbix/zabbix_java_gateway.conf For more details, see Zabbix Java gateway configuration [parameters](/manual/appendix/config/zabbix_java). To start Zabbix Java gateway: systemctl restart zabbix-java-gateway To automatically start Zabbix Java gateway on boot: RHEL 7 and later: systemctl enable zabbix-java-gateway RHEL prior to 7: chkconfig --level 12345 zabbix-java-gateway on #### Javaゲートウェイの設定と実行 Zabbix Javaゲートウェイの設定パラメーターは、次のファイルで調整できます。 /etc/zabbix/zabbix_java_gateway.conf 詳細については、Zabbix Javaゲートウェイ設定[パラメーター](/manual/appendix/config/zabbix_java)を参照してください。 Zabbix Javaゲートウェイを起動するには: systemctl restart zabbix-java-gateway サーバー起動時にZabbix Javaゲートウェイを自動的に起動するには: RHEL 7以降: systemctl enable zabbix-java-gateway RHEL 7より前: chkconfig --level 12345 zabbix-java-gateway on #### Configuring and running Java gateway Java gateway configuration may be tuned in the file: /etc/zabbix/zabbix_java_gateway.conf For more details, see Zabbix Java gateway configuration [parameters](/manual/appendix/config/zabbix_java). To start Zabbix Java gateway: systemctl restart zabbix-java-gateway To automatically start Zabbix Java gateway on boot: systemctl enable zabbix-java-gateway #### Javaゲートウェイの設定と実行 Javaゲートウェイの設定は次のファイルで行えます。 /etc/zabbix/zabbix_java_gateway.conf 詳細については、Zabbix Javaゲートウェイ設定[パラメーター](/manual/appendix/config/zabbix_java)を参照してください。 Zabbix Javaゲートウェイを起動するには: systemctl restart zabbix-java-gateway サーバー起動時にZabbix Javaゲートウェイを自動的に起動するには: systemctl enable zabbix-java-gateway #### Configuring an *Item value* widget Configure an *Item value* widget that displays the item value for the item "42266" (Zabbix agent availability). In addition, visually fine-tune the widget with multiple advanced options. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "item", "name": "Item value", "x": 0, "y": 0, "width": 4, "height": 3, "view_mode": 0, "fields": [ { "type": 4, "name": "itemid", "value": 42266 }, { "type": 0, "name": "show", "value": 1 }, { "type": 0, "name": "show", "value": 2 }, { "type": 0, "name": "show", "value": 3 }, { "type": 0, "name": "adv_conf", "value": 1 }, { "type": 1, "name": "bg_color", "value": "D1C4E9" }, { "type": 1, "name": "description", "value": "Agent status" }, { "type": 0, "name": "desc_h_pos", "value": 0 }, { "type": 0, "name": "desc_v_pos", "value": 0 }, { "type": 0, "name": "desc_bold", "value": 1 }, { "type": 1, "name": "desc_color", "value": "F06291" }, { "type": 0, "name": "value_h_pos", "value": 0 }, { "type": 0, "name": "value_size", "value": 25 }, { "type": 1, "name": "value_color", "value": "FFFF00" }, { "type": 0, "name": "units_show", "value": 0 }, { "type": 0, "name": "time_h_pos", "value": 2 }, { "type": 0, "name": "time_v_pos", "value": 2 }, { "type": 0, "name": "time_size", "value": 10 }, { "type": 0, "name": "time_bold", "value": 1 }, { "type": 1, "name": "time_color", "value": "9FA8DA" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *アイテムの値*ウィジェットの設定 アイテム"42266"(Zabbixエージェントの可用性)のアイテム値を表示する*アイテムの値*ウィジェットを設定します。さらに、複数の詳細オプションを使用してウィジェットを視覚的に微調整します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "item", "name": "Item value", "x": 0, "y": 0, "width": 4, "height": 3, "view_mode": 0, "fields": [ { "type": 4, "name": "itemid", "value": 42266 }, { "type": 0, "name": "show", "value": 1 }, { "type": 0, "name": "show", "value": 2 }, { "type": 0, "name": "show", "value": 3 }, { "type": 0, "name": "adv_conf", "value": 1 }, { "type": 1, "name": "bg_color", "value": "D1C4E9" }, { "type": 1, "name": "description", "value": "Agent status" }, { "type": 0, "name": "desc_h_pos", "value": 0 }, { "type": 0, "name": "desc_v_pos", "value": 0 }, { "type": 0, "name": "desc_bold", "value": 1 }, { "type": 1, "name": "desc_color", "value": "F06291" }, { "type": 0, "name": "value_h_pos", "value": 0 }, { "type": 0, "name": "value_size", "value": 25 }, { "type": 1, "name": "value_color", "value": "FFFF00" }, { "type": 0, "name": "units_show", "value": 0 }, { "type": 0, "name": "time_h_pos", "value": 2 }, { "type": 0, "name": "time_v_pos", "value": 2 }, { "type": 0, "name": "time_size", "value": 10 }, { "type": 0, "name": "time_bold", "value": 1 }, { "type": 1, "name": "time_color", "value": "9FA8DA" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring an operation To configure an operation, go to the *Operations* tab in [action](/manual/config/notifications/action) configuration. {width="600"} General operation attributes: |Parameter|Description| |--|-----------| |*Default operation step duration*|Duration of one operation step by default (60 seconds to 1 week).<br>For example, an hour-long step duration means that if an operation is carried out, an hour will pass before the next step.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 60s, 1m, 2h, 1d, since Zabbix 3.4.0.<br>[User macros](/manual/config/macros/user_macros) are supported, since Zabbix 3.4.0.| |*Operations*|Action operations (if any) are displayed, with these details:<br>**Steps** - escalation step(s) to which the operation is assigned<br>**Details** - type of operation and its recipient/target.<br>The operation list also displays the media type (e-mail, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient.<br>**Start in** - how long after an event the operation is performed<br>**Duration (sec)** - step duration is displayed. *Default* is displayed if the step uses default duration, and a time is displayed if custom duration is used.<br>**Action** - links for editing and removing an operation are displayed.| |*Recovery operations*|Action operations (if any) are displayed, with these details:<br>**Details** - type of operation and its recipient/target.<br>The operation list also displays the media type (e-mail, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient.<br>**Action** - links for editing and removing an operation are displayed.| |*Update operations*|Action operations (if any) are displayed, with these details:<br>**Details** - type of operation and its recipient/target.<br>The operation list also displays the media type (e-mail, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient.<br>**Action** - links for editing and removing an operation are displayed.| |*Pause operations for suppressed problems*|Mark this checkbox to delay the start of operations for the duration of a maintenance period. When operations are started, after the maintenance, all operations are performed including those for the events during the maintenance.<br>Note that this setting affects only problem escalations; recovery and update operations will not be affected.<br>If you unmark this checkbox, operations will be executed without delay even during a maintenance period.<br>This option is not available for *Service actions*.| |*Notify about canceled escalations*|Unmark this checkbox to disable notifications about canceled escalations (when host, item, trigger or action is disabled).| All mandatory input fields are marked with a red asterisk. To configure details of a new operation, click on  in the Operations block. To edit an existing operation, click on  next to the operation. A popup window will open where you can edit the operation step details. #### 実行内容の設定 実行内容を設定するには、[アクション](/manual/config/notifications/action) 設定の *実行内容*タブに移動します。 {width="600"} 一般的な実行属性: |パラメータ|説明| |--|-----------| |*デフォルトのアクション実行ステップの間隔*|デフォルトでの 1 つのアクションステップの間隔 (60 秒から 1 週間)。<br>たとえば1時間のステップ継続時間アクションを実行すると、次のステップまでに 1時間経過します。<br>Zabbix 3.4.0 以降で[タイムサフィックス](/manual/appendix/suffixes) がサポートされています。例:60s, 1m, 2h, 1d<br>Zabbix 3.4.0 以降で[ユーザー マクロ](/manual/config/macros/user_macros) がサポートされています。| |*実行内容*|アクション オペレーション (存在する場合) が次の詳細とともに表示されます。<br>**ステップ** - オペレーションが割り当てられているエスカレーション ステップ<br>**詳細** - オペレーションのタイプとその受信者/ターゲット <br>アクションリストには、使用されているメディア タイプ (電子メール、SMS、またはスクリプト) と、通知受信者の名前と姓 (ユーザー名の後の括弧内) も表示されます。<br>**開始時刻** - イベント後に操作が実行される時間<br>**継続期間** - ステップ期間が表示されます。 ステップでデフォルトの期間が使用されている場合は *Default* が表示され、カスタムの期間が使用されている場合は時間が表示されます。<br>**アクション** - 実行内容を編集および削除するためのリンクが表示されます。| |*復旧時の実行内容*|アクション操作 (存在する場合) が次の詳細と共に表示されます:<br>**詳細** - 操作のタイプとその受信者/ターゲット。<br>操作リストには、メディアの種類 (電子メール、SMS、またはスクリプト) も表示されます。 )、および通知受信者の名前と姓 (ユーザー名の後の括弧内) が使用されます。<br>**アクション** - 実行内容を編集および削除するためのリンクが表示されます。| |*更新時の実行内容*|アクション操作 (存在する場合) が次の詳細と共に表示されます:<br>**詳細** - 操作のタイプとその受信者/ターゲット。<br>操作リストには、メディアの種類 (電子メール、SMS、またはスクリプト) も表示されます。 )、および通知受信者の名前と姓 (ユーザー名の後の括弧内) が使用されます。<br>**アクション** - 実行内容を編集および削除するためのリンクが表示されます。| |*メンテナンス中の場合に実行を保留*|メンテナンス期間中、運用開始を遅らせるには、このチェックボックスをオンにします。 運用開始時、メンテナンス後は、メンテナンス中のイベントも含め全ての運用を実施します。 復旧および更新操作には影響しません。<br>このチェックボックスをオフにすると、メンテナンス期間中も遅延なく操作が実行されます。<br>このオプションは*サービス アクション*には使用できません。| |*キャンセルされたエスカレーションの通知*|キャンセルされたエスカレーションに関する通知を無効にするには、このチェックボックスをオフにします (ホスト、アイテム、トリガー、またはアクションが無効になっている場合)。| すべての必須入力フィールドには赤いアスタリスクが付いています。 新しい実行内容の詳細を設定するには、操作ブロックの  をクリック、 既存の実行内容を編集するには、操作の横にある  をクリックすると、 アクションステップの詳細を編集できるポップアップ ウィンドウが開きます。 #### Configuring an *SLA report* widget Configure an *SLA report* widget that displays the SLA report for SLA "4" service "2" for the period of last 30 days. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "slareport", "name": "SLA report", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 10, "name": "slaid", "value": 4 }, { "type": 9, "name": "serviceid", "value": 2 }, { "type": 1, "name": "date_from", "value": "now-30d" }, { "type": 1, "name": "date_to", "value": "now" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *SLAレポート*ウィジェットの設定 SLA "4"、サービス"2"の過去30日間のSLAレポートを表示する*SLAレポート*ウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "slareport", "name": "SLA report", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 10, "name": "slaid", "value": 4 }, { "type": 9, "name": "serviceid", "value": 2 }, { "type": 1, "name": "date_from", "value": "now-30d" }, { "type": 1, "name": "date_to", "value": "now" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring an update operation To configure an update operation go to the *Operations* tab in action [configuration](/manual/config/notifications/action).  To configure details of a new update operation, click on  in the Update operations block. To edit an existing operation, click on  next to the operation. A popup window will open where you can edit the operation step details. #### 更新時の実行内容設定 更新時実行内容を設定するには、アクション[設定](/manual/config/notifications/action) の *実行内容* タブに移動します。  新しい更新時の実行内容の詳細を設定するには、更新操作ブロックの*追加*を、既存の操作を編集するには、操作の横にある*変更*をクリックします。 ステップの実行内容の詳細を編集できるポップアップ ウィンドウが開きます。 #### Configuring a *Plain text* widget Configure a *Plain text* widget that displays latest data for items "42269" and "42253". In addition, configure the item names to be located at the top of the data columns, and only 15 lines of data to be displayed. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "plaintext", "name": "Plain text", "x": 0, "y": 0, "width": 6, "height": 3, "view_mode": 0, "fields": [ { "type": 4, "name": "itemids", "value": 42269 }, { "type": 4, "name": "itemids", "value": 42253 }, { "type": 0, "name": "style", "value": 1 }, { "type": 0, "name": "show_lines", "value": 15 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *プレーンテキスト*ウィジェットの設定 アイテム"42269"と"42253"の最新データを表示する*プレーンテキスト*ウィジェットを設定します。 さらに、アイテム名をデータ列の先頭に配置し、15行のデータのみを表示するように設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "plaintext", "name": "Plain text", "x": 0, "y": 0, "width": 6, "height": 3, "view_mode": 0, "fields": [ { "type": 4, "name": "itemids", "value": 42269 }, { "type": 4, "name": "itemids", "value": 42253 }, { "type": 0, "name": "style", "value": 1 }, { "type": 0, "name": "show_lines", "value": 15 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Problem hosts* widget Configure a *Problem hosts* widget that displays hosts from host groups "2" and "4" that have problems with a name that includes the string "CPU" and that have the following severities: "Warning", "Average", "High", "Disaster". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problemhosts", "name": "Problem hosts", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 2 }, { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "problem", "value": "cpu" }, { "type": 0, "name": "severities", "value": 2 }, { "type": 0, "name": "severities", "value": 3 }, { "type": 0, "name": "severities", "value": 4 }, { "type": 0, "name": "severities", "value": 5 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *障害中のホスト*ウィジェットの設定 ホストグループ"2"と"4"に属する、名前に"CPU"という文字列が含まれ、深刻度が"警告"、"軽度の障害"、"重度の障害"、"致命的な障害"の障害が発生しているホストを表示する*障害中のホスト*ウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problemhosts", "name": "Problem hosts", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 2 }, { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "problem", "value": "cpu" }, { "type": 0, "name": "severities", "value": 2 }, { "type": 0, "name": "severities", "value": 3 }, { "type": 0, "name": "severities", "value": 4 }, { "type": 0, "name": "severities", "value": 5 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Problems by severity* widget Configure a *Problems by severity* widget that displays problem totals for all host groups. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problemsbysv", "name": "Problems by severity", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "show_type", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *深刻度ごとの障害数*ウィジェットの設定 すべてのホストグループの障害の合計数を表示する*深刻度ごとの障害数*ウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problemsbysv", "name": "Problems by severity", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "show_type", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Problems* widget Configure a *Problems* widget that displays problems for host group "4" that satisfy the following conditions: - Problems that have a tag with the name "scope" that contains values "performance" or "availability", or "capacity". - Problems that have the following severities: "Warning", "Average", "High", "Disaster". In addition, configure the widget to show tags and operational data. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problems", "name": "Problems", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "tags.tag.0", "value": "scope" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "performance" }, { "type": 1, "name": "tags.tag.1", "value": "scope" }, { "type": 0, "name": "tags.operator.1", "value": 0 }, { "type": 1, "name": "tags.value.1", "value": "availability" }, { "type": 1, "name": "tags.tag.2", "value": "scope" }, { "type": 0, "name": "tags.operator.2", "value": 0 }, { "type": 1, "name": "tags.value.2", "value": "capacity" }, { "type": 0, "name": "severities", "value": 2 }, { "type": 0, "name": "severities", "value": 3 }, { "type": 0, "name": "severities", "value": 4 }, { "type": 0, "name": "severities", "value": 5 }, { "type": 0, "name": "show_tags", "value": 1 }, { "type": 0, "name": "show_opdata", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *障害*ウィジェットの設定 ホストグループ"4"で、以下の条件を満たす障害を表示する*障害*ウィジェットを設定します: - "scope"という名前のタグが付いており、そのタグの値が"performance"、"availability"または"capacity"である障害。 - 深刻度が"警告"、"軽度の障害"、"重度の障害"、"致命的な障害"である障害。 さらに、タグと運用データを表示するようにウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problems", "name": "Problems", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "tags.tag.0", "value": "scope" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "performance" }, { "type": 1, "name": "tags.tag.1", "value": "scope" }, { "type": 0, "name": "tags.operator.1", "value": 0 }, { "type": 1, "name": "tags.value.1", "value": "availability" }, { "type": 1, "name": "tags.tag.2", "value": "scope" }, { "type": 0, "name": "tags.operator.2", "value": 0 }, { "type": 1, "name": "tags.value.2", "value": "capacity" }, { "type": 0, "name": "severities", "value": 2 }, { "type": 0, "name": "severities", "value": 3 }, { "type": 0, "name": "severities", "value": 4 }, { "type": 0, "name": "severities", "value": 5 }, { "type": 0, "name": "show_tags", "value": 1 }, { "type": 0, "name": "show_opdata", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Top hosts* widget Configure a *Top hosts* widget that displays top hosts by CPU utilization in host group "4". In addition, configure the following custom columns: "Host name", "Utilization", "1m avg", "5m avg", "15m avg", "Processes". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "tophosts", "name": "Top hosts", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "columns.name.0", "value": "" }, { "type": 0, "name": "columns.data.0", "value": 2 }, { "type": 1, "name": "columns.base_color.0", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.0", "value": "" }, { "type": 1, "name": "columns.name.1", "value": "Utilization" }, { "type": 0, "name": "columns.data.1", "value": 1 }, { "type": 1, "name": "columns.base_color.1", "value": "4CAF50" }, { "type": 1, "name": "columns.timeshift.1", "value": "" }, { "type": 1, "name": "columns.item.1", "value": "CPU utilization" }, { "type": 0, "name": "columns.display.1", "value": 3 }, { "type": 1, "name": "columns.min.1", "value": "0" }, { "type": 1, "name": "columns.max.1", "value": "100" }, { "type": 1, "name": "columnsthresholds.color.1.0", "value": "FFFF00" }, { "type": 1, "name": "columnsthresholds.threshold.1.0", "value": "50" }, { "type": 1, "name": "columnsthresholds.color.1.1", "value": "FF8000" }, { "type": 1, "name": "columnsthresholds.threshold.1.1", "value": "80" }, { "type": 1, "name": "columnsthresholds.color.1.2", "value": "FF4000" }, { "type": 1, "name": "columnsthresholds.threshold.1.2", "value": "90" }, { "type": 1, "name": "columns.name.2", "value": "1m avg" }, { "type": 0, "name": "columns.data.2", "value": 1 }, { "type": 1, "name": "columns.base_color.2", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.2", "value": "" }, { "type": 1, "name": "columns.item.2", "value": "Load average (1m avg)" }, { "type": 1, "name": "columns.name.3", "value": "5m avg" }, { "type": 0, "name": "columns.data.3", "value": 1 }, { "type": 1, "name": "columns.base_color.3", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.3", "value": "" }, { "type": 1, "name": "columns.item.3", "value": "Load average (5m avg)" }, { "type": 1, "name": "columns.name.4", "value": "15m avg" }, { "type": 0, "name": "columns.data.4", "value": 1 }, { "type": 1, "name": "columns.base_color.4", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.4", "value": "" }, { "type": 1, "name": "columns.item.4", "value": "Load average (15m avg)" }, { "type": 1, "name": "columns.name.5", "value": "Processes" }, { "type": 0, "name": "columns.data.5", "value": 1 }, { "type": 1, "name": "columns.base_color.5", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.5", "value": "" }, { "type": 1, "name": "columns.item.5", "value": "Number of processes" }, { "type": 0, "name": "column", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *上位ホスト*ウィジェットの設定 ホストグループ"4"でCPU使用率上位のホストを表示する*上位ホスト*ウィジェットを構成します。 さらに、次のカスタム列を構成します: "Host name", "Utilization", "1m avg", "5m avg", "15m avg", "Processes"。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "tophosts", "name": "Top hosts", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "columns.name.0", "value": "" }, { "type": 0, "name": "columns.data.0", "value": 2 }, { "type": 1, "name": "columns.base_color.0", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.0", "value": "" }, { "type": 1, "name": "columns.name.1", "value": "Utilization" }, { "type": 0, "name": "columns.data.1", "value": 1 }, { "type": 1, "name": "columns.base_color.1", "value": "4CAF50" }, { "type": 1, "name": "columns.timeshift.1", "value": "" }, { "type": 1, "name": "columns.item.1", "value": "CPU utilization" }, { "type": 0, "name": "columns.display.1", "value": 3 }, { "type": 1, "name": "columns.min.1", "value": "0" }, { "type": 1, "name": "columns.max.1", "value": "100" }, { "type": 1, "name": "columnsthresholds.color.1.0", "value": "FFFF00" }, { "type": 1, "name": "columnsthresholds.threshold.1.0", "value": "50" }, { "type": 1, "name": "columnsthresholds.color.1.1", "value": "FF8000" }, { "type": 1, "name": "columnsthresholds.threshold.1.1", "value": "80" }, { "type": 1, "name": "columnsthresholds.color.1.2", "value": "FF4000" }, { "type": 1, "name": "columnsthresholds.threshold.1.2", "value": "90" }, { "type": 1, "name": "columns.name.2", "value": "1m avg" }, { "type": 0, "name": "columns.data.2", "value": 1 }, { "type": 1, "name": "columns.base_color.2", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.2", "value": "" }, { "type": 1, "name": "columns.item.2", "value": "Load average (1m avg)" }, { "type": 1, "name": "columns.name.3", "value": "5m avg" }, { "type": 0, "name": "columns.data.3", "value": 1 }, { "type": 1, "name": "columns.base_color.3", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.3", "value": "" }, { "type": 1, "name": "columns.item.3", "value": "Load average (5m avg)" }, { "type": 1, "name": "columns.name.4", "value": "15m avg" }, { "type": 0, "name": "columns.data.4", "value": 1 }, { "type": 1, "name": "columns.base_color.4", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.4", "value": "" }, { "type": 1, "name": "columns.item.4", "value": "Load average (15m avg)" }, { "type": 1, "name": "columns.name.5", "value": "Processes" }, { "type": 0, "name": "columns.data.5", "value": 1 }, { "type": 1, "name": "columns.base_color.5", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.5", "value": "" }, { "type": 1, "name": "columns.item.5", "value": "Number of processes" }, { "type": 0, "name": "column", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Trigger overview* widget Configure a *Trigger overview* widget that displays trigger states for all host groups that have triggers with a tag that has the name "scope" and contains value "availability". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "trigover", "name": "Trigger overview", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.tag.0", "value": "scope" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "availability" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *トリガーの概要*ウィジェットの設定 "scope"という名前で値に"availability"を含むタグでトリガーされ、すべてのホストグループのトリガー状態を表示する*トリガー概要*ウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "trigover", "name": "Trigger overview", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.tag.0", "value": "scope" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "availability" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *URL* widget Configure a *URL* widget that displays the home page of Zabbix manual. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "url", "name": "URL", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "url", "value": "https://www.zabbix.com/documentation/6.0/en" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *URL*ウィジェットの設定 Zabbixマニュアルのホームページを表示する*URL*ウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "url", "name": "URL", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "url", "value": "https://www.zabbix.com/documentation/6.0/en" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring authentication The **Authentication** tab allows you to configure scenario authentication options. A green dot next to the tab name indicates that some type of HTTP authentication is enabled.  Authentication parameters: |Parameter|Description| |--|--------| |*Authentication*|Authentication options.<br>**None** - no authentication used.<br>**Basic** - basic authentication is used.<br>**NTLM** - NTLM ([Windows NT LAN Manager)](http://en.wikipedia.org/wiki/NTLM) authentication is used.<br>**Kerberos** - Kerberos authentication is used. See also: [Configuring Kerberos with Zabbix](/manual/appendix/items/kerberos).<br>**Digest** - Digest authentication is used.<br>Selecting an authentication method will provide two additional fields for entering a user name and password.<br>User macros can be used in user and password fields.| |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server.<br>The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter [SSLCALocation](/manual/appendix/config/zabbix_server).<br>This sets the [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) cURL option.| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>This sets the [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURL option.| |*SSL certificate file*|Name of the SSL certificate file used for client authentication. The certificate file must be in PEM^1^ format. If the certificate file contains also the private key, leave the *SSL key file* field empty. If the key is encrypted, specify the password in *SSL key password* field. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) cURL option.| |*SSL key file*|Name of the SSL private key file used for client authentication. The private key file must be in PEM^1^ format. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) cURL option.| |*SSL key password*|SSL private key file password.<br>User macros can be used in this field.<br>This sets the [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) cURL option.| ::: noteimportant \[1\] Zabbix supports certificate and private key files in PEM format only. In case you have your certificate and private key data in PKCS \#12 format file (usually with extension \*.p12 or \*.pfx) you may generate the PEM file from it using the following commands: openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key ::: ::: noteclassic Zabbix server picks up changes in certificates without a restart. ::: ::: noteclassic If you have client certificate and private key in a single file just specify it in a "SSL certificate file" field and leave "SSL key file" field empty. The certificate and key must still be in PEM format. Combining certificate and key is easy: cat client.crt client.key > client.pem ::: #### 認証設定 **認証**タブでは、シナリオの認証オプションを設定できます。タブ名の横にある緑色の点は、あるタイプのHTTP認証が有効になっていることを示します。  認証パラメータ： |パラメーター|説明| | --------- | ----------- | |*HTTP認証*|認証オプション<br>**なし** - 認証は使用されません。<br>**Basic** - basic認証が使用されます。<br>**NTLM** - NTLM（[Windows NT LAN Manager](http://en.wikipedia.org/wiki/NTLM)）認証が使用されます。<br> **Kerberos** - Kerberos認証が使用されます。参照：[Zabbixを使用したKerberosの設定](/manual/appendix/items/kerberos)<br>**Digest**-ダイジェスト認証が使用されます。<br>認証方法を選択すると、ユーザー名とパスワードを入力するための2つのフィールドが追加されます。<br>ユーザーマクロは、ユーザー名フィールドとパスワードフィールドで使用できます。| |*SSLピア検証*|チェックボックスをオンにするとWebサーバーのSSL証明書を検証します。<br>サーバー証明書は、システム全体の認証局（CA）の場所から自動的に取得されます。 <br>Zabbixサーバーまたはプロキシ設定パラメータ[SSLCALocation](/manual/appendix/config/zabbix_server)を使用してCAファイルの場所を上書きできます。<br>[CURLOPT_SSL_VERIFYPEER](http://curl.haxx .se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) cURLオプションが設定されます。| |*SSLホスト検証*|チェックボックスをオンにするとWebサーバー証明書の*Common Name*フィールドまたは*Subject Alternate Name*フィールドが一致することを確認します。<br>[CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURLオプションが設定されます。| |*SSL証明書ファイル*|クライアント認証に使用されるSSL証明書ファイル名。証明書ファイルはPEM^1^形式である必要があります。証明書ファイルに秘密鍵も含まれている場合は*SSL key file*フィールドを空のままにします。キーが暗号化されている場合は*SSL key password*フィールドにパスワードを指定します。このファイルを含むディレクトリは、Zabbixサーバーまたはプロキシ設定パラメータ[SSLCertLocation](/manual/appendix/config/zabbix_server)によって指定されます。<br>`HOST.\*`マクロとユーザーマクロをこのフィールドで使用できます。<br>[CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) cURLオプションが設定されます。| |*SSL秘密鍵ファイル*|クライアント認証に使用されるSSL秘密鍵ファイルの名前<br>秘密鍵ファイルはPEM^1^形式である必要があります。このファイルを含むディレクトリは、Zabbixサーバーまたはプロキシ設定パラメータ[SSLKeyLocation](/manual/appendix/config/zabbix_server)によって指定されます。<br>`HOST.\*`マクロとユーザーマクロをこのフィールドで使用できます。<br>[CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) cURLオプションが設定されます。| |*SSL秘密鍵パスワード*|SSL秘密鍵ファイルパスワード<br>このフィールドではユーザーマクロを使用できます。<br>[CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c /CURLOPT_KEYPASSWD.html) cURLオプションが設定されます。| ::: 注意 \ [1\]ZabbixはPEM形式の証明書と秘密鍵ファイルのみをサポートします。 証明書と秘密鍵データがPKCS＃12形式のファイル（通常は拡張子*.p12または*.pfx）である場合は、 次のコマンドを使用してそこからPEMファイルを生成できます。 openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key ::: ::: noteclassic Zabbixサーバーは再起動せずに証明書の変更を取得します。 ::: ::: noteclassic 1つのファイルにクライアント証明書と秘密鍵が含まれている場合は"SSL certificate file"フィールドで指定し、"SSL key file"フィールドは空のままにします。証明書とキーは引き続きPEM形式である必要があります。証明書とキーの組み合わせは簡単です cat client.crt client.key > client.pem ::: #### Configuring a *Web monitoring* widget Configure a *Web monitoring* widget that displays a status summary of the active web monitoring scenarios for host group "4". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "web", "name": "Web monitoring", "x": 0, "y": 0, "width": 6, "height": 3, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### *Web監視*ウィジェットの設定 ホストグループ"4"のアクティブなWeb監視シナリオのステータス概要を表示する*Web監視*ウィジェットを設定します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "web", "name": "Web monitoring", "x": 0, "y": 0, "width": 6, "height": 3, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a web scenario To configure a web scenario: - Go to: *Configuration → Hosts* (or *Templates*) - Click on *Web* in the row of the host/template - Click on *Create scenario* to the right (or on the scenario name to edit an existing scenario) - Enter parameters of the scenario in the form The **Scenario** tab allows you to configure the general parameters of a web scenario.  All mandatory input fields are marked with a red asterisk. Scenario parameters: |Parameter|Description| |--|--------| |*Host*|Name of the host/template that the scenario belongs to.| |*Name*|Unique scenario name.| |*Update interval*|How often the scenario will be executed.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported. *Note* that if a user macro is used and its value is changed (e.g. 5m → 30s), the next check will be executed according to the previous value (farther in the future with the example values).| |*Attempts*|The number of attempts for executing web scenario steps. In case of network problems (timeout, no connectivity, etc) Zabbix can repeat executing a step several times. The figure set will equally affect each step of the scenario. Up to 10 attempts can be specified, default value is 1.<br>*Note*: Zabbix will not repeat a step because of a wrong response code or the mismatch of a required string.| |*Agent*|Select a client agent.<br>Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.<br>User macros can be used in this field.| |*HTTP proxy*|You can specify an HTTP proxy to use, using the format `[protocol://][username[:password]@]proxy.example.com[:port]`.<br>This sets the [CURLOPT\_PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html) cURL option.<br>The optional `protocol://` prefix may be used to specify alternative proxy protocols (the protocol prefix support was added in cURL 7.21.7). With no protocol specified, the proxy will be treated as an HTTP proxy.<br>By default, 1080 port will be used.<br>If specified, the proxy will overwrite proxy related environment variables like http\_proxy, HTTPS\_PROXY. If not specified, the proxy will not overwrite proxy-related environment variables. The entered value is passed on "as is", no sanity checking takes place.<br>You may also enter a SOCKS proxy address. If you specify the wrong protocol, the connection will fail and the item will become unsupported.<br>*Note* that only simple authentication is supported with HTTP proxy.<br>User macros can be used in this field.| |*Variables*|Variables that may be used in scenario steps (URL, post variables).<br>They have the following format:<br>**{macro1}**=value1<br>**{macro2}**=value2<br>**{macro3}**=regex:<regular expression><br>For example:<br>{username}=Alexei<br>{password}=kj3h5kJ34bd<br>{hostid}=regex:hostid is (\[0-9\]+)<br>The macros can then be referenced in the steps as {username}, {password} and {hostid}. Zabbix will automatically replace them with actual values. Note that variables with `regex:` need one step to get the value of the regular expression so the extracted value can only be applied to the step after.<br>If the value part starts with `regex:` then the part after it is treated as a regular expression that searches the web page and, if found, stores the match in the variable. At least one subgroup must be present so that the matched value can be extracted.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.<br>Variables are automatically URL-encoded when used in query fields or form data for post variables, but must be URL-encoded manually when used in raw post or directly in URL.| |*Headers*|HTTP Headers are used when performing a request. Default and custom headers can be used.<br>Headers will be assigned using default settings depending on the Agent type selected from a drop-down list on a scenario level, and will be applied to all the steps, unless they are custom defined on a step level.<br>**It should be noted that defining the header on a step level automatically discards all the previously defined headers, except for a default header that is assigned by selecting the 'User-Agent' from a drop-down list on a scenario level.**<br>However, even the 'User-Agent' default header can be overridden by specifying it on a step level.<br>To unset the header on a scenario level, the header should be named and attributed with no value on a step level.<br>Headers should be listed using the same syntax as they would appear in the HTTP protocol, optionally using some additional features supported by the [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURL option.<br>For example:<br>Accept-Charset=utf-8<br>Accept-Language=en-US<br>Content-Type=application/xml; charset=utf-8<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Enabled*|The scenario is active if this box is checked, otherwise - disabled.| Note that when editing an existing scenario, two extra buttons are available in the form: | | | |--|--------| ||Create another scenario based on the properties of the existing one.| ||Delete history and trend data for the scenario. This will make the server perform the scenario immediately after deleting the data.| ::: notetip If *HTTP proxy* field is left empty, another way for using an HTTP proxy is to set proxy related environment variables. For HTTP checks - set the **http\_proxy** environment variable for the Zabbix server user. For example, `http_proxy=http://proxy_ip:proxy_port`. For HTTPS checks - set the **HTTPS\_PROXY** environment variable. For example, `HTTPS_PROXY=http://proxy_ip:proxy_port`. More details are available by running a shell command: *\# man curl*. ::: The **Steps** tab allows you to configure the web scenario steps. To add a web scenario step, click on *Add* in the *Steps* block. {width="600"} ::: noteclassic Secret [user macros](/manual/config/macros/user_macros#configuration) must not be used in URLs as they will resolve to "\*\*\*\*\*\*". ::: #### Webシナリオの設定 Webシナリオを設定するには： - *設定 → ホスト*（または*テンプレート*）に移動します - ホスト/テンプレートの行で*Web*をクリックします - 右側の*Webシナリオの作成*をクリックします（またはシナリオ名をクリックして既存のシナリオを編集します） - フォームにシナリオのパラメータを入力します **シナリオ**タブではWebシナリオの一般的なパラメータを設定できます。  すべての必須入力フィールドは、赤いアスタリスクでマークされています。 シナリオパラメータ： |パラメーター|説明| |--|--------| |*ホスト*|シナリオが属するホスト/テン​​プレートの名前| |*名前*|一意のシナリオ名| |*監視間隔*|シナリオが実行される頻度。<br>[タイムサフィックス](/manual/appendix/suffixes)が使用可能。 例：30s, 1m, 2h, 1d.<br>[ユーザーマクロ](/manual/config/macros/user_macros)が使用可能。ユーザーマクロで値が変更された場合（例：5m→30s）次のチェックは前の値に従って実行されることに注意してください（将来的にはサンプル値を使用）。| |*試行回数*|Webシナリオステップ実行の試行回数。ネットワークに問題がある場合（タイムアウト、接続がないなど）、Zabbixはステップの実行を数回繰り返すことができます。フィギュアセットは、シナリオの各ステップに等しく影響します。最大10回試行でき、デフォルト値1回です。<br>*注*：応答コードが間違っているか、必要な文字列が一致していない場合、Zabbixはステップを繰り返しません。| |*エージェント*|クライアントエージェントを選択します。<br>Zabbixは選択されたブラウザのふりをします。これは、Webサイトがブラウザごとに異なるコンテンツを返す場合に役立ちます。<br>このフィールドでは、ユーザーマクロを使用できます。| |*HTTPプロキシ*|`[protocol://] [username[:password]@]proxy.example.com[:port]`の形式を使用して、使用するHTTPプロキシを指定できます。<br>これにより[CURLOPT\ _PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html) cURL オプションが設定されます。<br>オプションの`protocol://`プレフィックスを使用して、代替プロキシプロトコルを指定できます。（プロトコルプレフィックスのサポートはcURL 7.21.7で追加されました）プロトコルが指定されていない場合、プロキシはHTTPプロキシとして扱われます。<br>デフォルトでは、1080ポートが使用されます。<br>指定されている場合、プロキシはhttp\ _proxy、HTTPS\_PROXYなどのプロキシ関連の環境変数を上書きします。指定しない場合、プロキシはプロキシ関連の環境変数を上書きしません。入力した値は「そのまま」渡され、健全性チェックは行われません。<br>SOCKSプロキシアドレスを入力することもできます。間違ったプロトコルを指定すると、接続が失敗し、アイテムがサポートされなくなります。<br>*注*HTTPプロキシでは単純な認証のみがサポートされます。<br>このフィールドではユーザーマクロを使用できます。| |*変数*|シナリオステップで使用できる変数。（URL、投稿変数）<br>次の形式になります：<br> **{macro1}**=value1<br>**{macro2}**=value2<br>**{macro3}**=regex:<正規表現> <br>例：<br> {username}=Alexei<br>{password}=kj3h5kJ34bd<br>{hostid}=regex :hostid is (\[0-9\]+)<br>マクロは、ステップで{username}、{password}、および{hostid}として参照できます。 Zabbixはそれらを実際の値に自動的に置き換えます。`regex:`を持つ変数は、正規表現の値を取得するために1つのステップが必要であるため、抽出された値は後のステップにのみ適用できることに注意してください。<br>値の部分が` regex:`で始まる場合は、その後の部分は、Webページを検索し、見つかった場合は変数に一致を格納する正規表現として扱われます。一致する値を抽出できるように、少なくとも1つのサブグループが存在する必要があります。<br>ユーザーマクロと{HOST.\*}[macros](/manual/appendix/macros/supported_by_location)がサポートされています。<br>変数は、クエリフィールドまたは投稿変数のフォームデータで使用される場合は自動的にURLエンコードされますが、生の投稿または直接URLで使用される場合は手動でURLエンコードする必要があります。| |*ヘッダー*|リクエストの実行時に送信されるカスタムHTTPヘッダー<br>ヘッダーは、HTTPプロトコルに表示されるのと同じ構文を使用してリストする必要があります。オプションで[CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html)のcURLオプションでサポートされているいくつかの追加機能を使用します。<br>例：<br>Accept-Charset=utf-8<br>Accept-Language=en-US<br>Content-Type=application/xml; charset=utf-8<br>ユーザーマクロと{HOST.*}[マクロ](/manual/appendix/macros/supported_by_location)がサポートされています。| |*有効*|このボックスがチェックされている場合、シナリオはアクティブです。チェックされていない場合、シナリオは無効になります。| 既存のシナリオを編集する場合、次の2つの追加ボタンを使用できることに注意してください。 | | | | --- | --- | ||既存のシナリオのプロパティに基づいて別のシナリオを作成します。| ||シナリオのヒストリとトレンドデータを削除します。サーバーはデータを削除した直後にシナリオを実行します。| ::: notetip *HTTPプロキシ*フィールドを未設定でHTTPプロキシを使用する方法は、プロキシ関連の環境変数を設定することです。 HTTPチェックの場合-Zabbixサーバーユーザーの**http\_proxy**環境変数を設定します。 例：`http_proxy=http://proxy_ip:proxy_port` HTTPSチェックの場合-**HTTPS\_PROXY**環境変数を設定します。 例：`HTTPS_PROXY=http://proxy_ip:proxy_port` 詳細についてはシェルコマンドで*\#man curl*を実行してください。 ::: **ステップ**タブではWebシナリオのステップを構成できます。 Webシナリオのステップを追加するには、*ステップ*ブロックの*追加*をクリックします。 {width="600"} ::: noteclassic シークレット[ユーザーマクロ](/manual/config/macros/user_macros#configuration)は「\*\*\*\*\*\*」に解決されるため、URLで使用しないでください。 ::: #### Configuring certificate on Zabbix server 1\. In order to verify peer certificates, Zabbix server must have access to file with their top-level self-signed root CA certificates. For example, if we expect certificates from two independent root CAs, we can put their certificates into file `/home/zabbix/zabbix_ca_file` like this: Certificate: Data: Version: 3 (0x2) Serial Number: 1 (0x1) Signature Algorithm: sha1WithRSAEncryption Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA ... Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA Subject Public Key Info: Public Key Algorithm: rsaEncryption Public-Key: (2048 bit) ... X509v3 extensions: X509v3 Key Usage: critical Certificate Sign, CRL Sign X509v3 Basic Constraints: critical CA:TRUE ... -----BEGIN CERTIFICATE----- MIID2jCCAsKgAwIBAgIBATANBgkqhkiG9w0BAQUFADB+MRMwEQYKCZImiZPyLGQB .... 9wEzdN8uTrqoyU78gi12npLj08LegRKjb5hFTVmO -----END CERTIFICATE----- Certificate: Data: Version: 3 (0x2) Serial Number: 1 (0x1) Signature Algorithm: sha1WithRSAEncryption Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root2 CA ... Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root2 CA Subject Public Key Info: Public Key Algorithm: rsaEncryption Public-Key: (2048 bit) .... X509v3 extensions: X509v3 Key Usage: critical Certificate Sign, CRL Sign X509v3 Basic Constraints: critical CA:TRUE .... -----BEGIN CERTIFICATE----- MIID3DCCAsSgAwIBAgIBATANBgkqhkiG9w0BAQUFADB/MRMwEQYKCZImiZPyLGQB ... vdGNYoSfvu41GQAR5Vj5FnRJRzv5XQOZ3B6894GY1zY= -----END CERTIFICATE----- 2\. Put Zabbix server certificate chain into file, for example, `/home/zabbix/zabbix_server.crt`: Certificate: Data: Version: 3 (0x2) Serial Number: 1 (0x1) Signature Algorithm: sha1WithRSAEncryption Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Signing CA ... Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Zabbix server Subject Public Key Info: Public Key Algorithm: rsaEncryption Public-Key: (2048 bit) ... X509v3 extensions: X509v3 Key Usage: critical Digital Signature, Key Encipherment X509v3 Basic Constraints: CA:FALSE ... -----BEGIN CERTIFICATE----- MIIECDCCAvCgAwIBAgIBATANBgkqhkiG9w0BAQUFADCBgTETMBEGCgmSJomT8ixk ... h02u1GHiy46GI+xfR3LsPwFKlkTaaLaL/6aaoQ== -----END CERTIFICATE----- Certificate: Data: Version: 3 (0x2) Serial Number: 2 (0x2) Signature Algorithm: sha1WithRSAEncryption Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA ... Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Signing CA Subject Public Key Info: Public Key Algorithm: rsaEncryption Public-Key: (2048 bit) ... X509v3 extensions: X509v3 Key Usage: critical Certificate Sign, CRL Sign X509v3 Basic Constraints: critical CA:TRUE, pathlen:0 ... -----BEGIN CERTIFICATE----- MIID4TCCAsmgAwIBAgIBAjANBgkqhkiG9w0BAQUFADB+MRMwEQYKCZImiZPyLGQB ... dyCeWnvL7u5sd6ffo8iRny0QzbHKmQt/wUtcVIvWXdMIFJM0Hw== -----END CERTIFICATE----- Here the first is Zabbix server certificate, followed by intermediate CA certificate. 3\. Put Zabbix server private key into file, for example, `/home/zabbix/zabbix_server.key`: -----BEGIN PRIVATE KEY----- MIIEwAIBADANBgkqhkiG9w0BAQEFAASCBKowggSmAgEAAoIBAQC9tIXIJoVnNXDl ... IJLkhbybBYEf47MLhffWa7XvZTY= -----END PRIVATE KEY----- 4\. Edit TLS parameters in Zabbix server configuration file like this: TLSCAFile=/home/zabbix/zabbix_ca_file TLSCertFile=/home/zabbix/zabbix_server.crt TLSKeyFile=/home/zabbix/zabbix_server.key #### Zabbixサーバでの証明書設定 1\. 相手の証明書を検証するために、Zabbixサーバは相手のトップレベルの自己署名付きルートCA証明書のファイルに<br> アクセスする必要があります。例えば、2つの独立したルートCAからの証明書が必要な場合、これらの証明書を<br> 以下のようにファイル `/home/zabbix/zabbix_ca_file` に格納します: Certificate: Data: Version: 3 (0x2) Serial Number: 1 (0x1) Signature Algorithm: sha1WithRSAEncryption Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA ... Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA Subject Public Key Info: Public Key Algorithm: rsaEncryption Public-Key: (2048 bit) ... X509v3 extensions: X509v3 Key Usage: critical Certificate Sign, CRL Sign X509v3 Basic Constraints: critical CA:TRUE ... -----BEGIN CERTIFICATE----- MIID2jCCAsKgAwIBAgIBATANBgkqhkiG9w0BAQUFADB+MRMwEQYKCZImiZPyLGQB .... 9wEzdN8uTrqoyU78gi12npLj08LegRKjb5hFTVmO -----END CERTIFICATE----- Certificate: Data: Version: 3 (0x2) Serial Number: 1 (0x1) Signature Algorithm: sha1WithRSAEncryption Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root2 CA ... Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root2 CA Subject Public Key Info: Public Key Algorithm: rsaEncryption Public-Key: (2048 bit) .... X509v3 extensions: X509v3 Key Usage: critical Certificate Sign, CRL Sign X509v3 Basic Constraints: critical CA:TRUE .... -----BEGIN CERTIFICATE----- MIID3DCCAsSgAwIBAgIBATANBgkqhkiG9w0BAQUFADB/MRMwEQYKCZImiZPyLGQB ... vdGNYoSfvu41GQAR5Vj5FnRJRzv5XQOZ3B6894GY1zY= -----END CERTIFICATE----- 2\. Zabbixサーバ証明書チェーンをファイル(例：`/home/zabbix/zabbix_server.crt`)に格納します: Certificate: Data: Version: 3 (0x2) Serial Number: 1 (0x1) Signature Algorithm: sha1WithRSAEncryption Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Signing CA ... Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Zabbix server Subject Public Key Info: Public Key Algorithm: rsaEncryption Public-Key: (2048 bit) ... X509v3 extensions: X509v3 Key Usage: critical Digital Signature, Key Encipherment X509v3 Basic Constraints: CA:FALSE ... -----BEGIN CERTIFICATE----- MIIECDCCAvCgAwIBAgIBATANBgkqhkiG9w0BAQUFADCBgTETMBEGCgmSJomT8ixk ... h02u1GHiy46GI+xfR3LsPwFKlkTaaLaL/6aaoQ== -----END CERTIFICATE----- Certificate: Data: Version: 3 (0x2) Serial Number: 2 (0x2) Signature Algorithm: sha1WithRSAEncryption Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA ... Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Signing CA Subject Public Key Info: Public Key Algorithm: rsaEncryption Public-Key: (2048 bit) ... X509v3 extensions: X509v3 Key Usage: critical Certificate Sign, CRL Sign X509v3 Basic Constraints: critical CA:TRUE, pathlen:0 ... -----BEGIN CERTIFICATE----- MIID4TCCAsmgAwIBAgIBAjANBgkqhkiG9w0BAQUFADB+MRMwEQYKCZImiZPyLGQB ... dyCeWnvL7u5sd6ffo8iRny0QzbHKmQt/wUtcVIvWXdMIFJM0Hw== -----END CERTIFICATE----- ここでは、最初にZabbix server 証明書、その後に中間CA証明書を掲載しています。 3\. Zabbix server の秘密鍵をファイル(例: `/home/zabbix/zabbix_server.key`) に格納します: -----BEGIN PRIVATE KEY----- MIIEwAIBADANBgkqhkiG9w0BAQEFAASCBKowggSmAgEAAoIBAQC9tIXIJoVnNXDl ... IJLkhbybBYEf47MLhffWa7XvZTY= -----END PRIVATE KEY----- 4\. Zabbixサーバ設定ファイルのTLSパラメータを以下のように編集してください: TLSCAFile=/home/zabbix/zabbix_ca_file TLSCertFile=/home/zabbix/zabbix_server.crt TLSKeyFile=/home/zabbix/zabbix_server.key #### Configuring custom graphs To create a custom graph, do the following: - Go to *Configuration → Hosts (or Templates)* - Click on *Graphs* in the row next to the desired host or template - In the Graphs screen click on *Create graph* - Edit graph attributes {width="600"} All mandatory input fields are marked with a red asterisk. Graph attributes: |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Unique graph name.<br>Expression [macros](/manual/appendix/macros/supported_by_location) are supported in this field, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).<br>{HOST.HOST<1-9>} macros are supported for the use within this macro, referencing the first, second, third, etc. host in the graph, for example `{?avg(/{HOST.HOST2}/key,1h)}`. Note that referencing the first host with this macro is redundant, as the first host can be referenced implicitly, for example `{?avg(//key,1h)}`.| |*Width*|<|Graph width in pixels (for preview and pie/exploded graphs only).| |*Height*|<|Graph height in pixels.| |*Graph type*|<|Graph type:<br>**Normal** - normal graph, values displayed as lines<br>**Stacked** - stacked graph, filled areas displayed<br>**Pie** - pie graph<br>**Exploded** - "exploded" pie graph, portions displayed as "cut out" of the pie| |*Show legend*|<|Checking this box will set to display the graph legend.| |*Show working time*|<|If selected, non-working hours will be shown with a gray background. This parameter is not available for pie and exploded pie graphs.| |*Show triggers*|<|If selected, simple triggers will be displayed as lines with black dashes over trigger severity color. This parameter is not available for pie and exploded pie graphs.| |*Percentile line (left)*|<|Display percentile for left Y-axis. If, for example, 95% percentile is set, then the percentile line will be at the level where 95 percent of the values fall under. Displayed as a bright green line. Only available for normal graphs.| |*Percentile line (right)*|<|Display percentile for right Y-axis. If, for example, 95% percentile is set, then the percentile line will be at the level where 95 percent of the values fall under. Displayed as a bright red line. Only available for normal graphs.| |*Y axis MIN value*|<|Minimum value of Y-axis:<br>**Calculated** - Y axis minimum value will be automatically calculated.<br>**Fixed** - fixed minimum value for Y-axis. <br>**Item** - last value of the selected item will be the minimum value.<br><br> This parameter is not available for pie and exploded pie graphs.| |*Y axis MAX value*|<|Maximum value of Y-axis:<br>**Calculated** - Y axis maximum value will be automatically calculated.<br>**Fixed** - fixed maximum value for Y-axis. <br>**Item** - last value of the selected item will be the maximum value<br><br> This parameter is not available for pie and exploded pie graphs.| |*3D view*|<|Enable 3D style. For pie and exploded pie graphs only.| |*Items*|<|Items, data of which are to be displayed in this graph. Click on *Add* to select items. You can also select various displaying options (function, draw style, left/right axis display, color).| |<|*Sort order (0→100)*|Draw order. 0 will be processed first. Can be used to draw lines or regions behind (or in front of) another.<br>You can drag and drop items using the icon at the beginning of a line to set the sort order or which item is displayed in front of the other.| |^|*Name*|Name of the selected item is displayed as a link. Clicking on the link opens the list of other available items.| |^|*Type*|Type (only available for pie and exploded pie graphs):<br>**Simple** - the value of the item is represented proportionally on the pie<br>**Graph sum** - the value of the item represents the whole pie<br>Note that coloring of the "graph sum" item will only be visible to the extent that it is not taken up by "proportional" items.| |^|*Function*|Select what values will be displayed when more than one value exists per vertical graph pixel for an item:<br>**all** - display all possible values (minimum, maximum, average) in the graph. Note that for shorter periods this setting has no effect; only for longer periods, when data congestion in a vertical graph pixel increases, 'all' starts displaying minimum, maximum, and average values. This function is only available for *Normal* graph type. See also: Generating graphs [from history/trends](/manual/config/visualization/graphs/simple#generating_from_historytrends).<br>**avg** - display the average values<br>**last** - display the latest values. This function is only available if either *Pie/Exploded pie* is selected as graph type.<br>**max** - display the maximum values<br>**min** - display the minimum values| |^|*Draw style*|Select the draw style (only available for normal graphs; for stacked graphs filled region is always used) to apply to the item data - *Line*, *Bold line*, *Filled region*, *Dot*, *Dashed line*, *Gradient line*.| |^|*Y axis side*|Select the Y axis side to show the item data - *Left*, *Right*.| |^|*Color*|Select the color to apply to the item data.| #### カスタムグラフの設定 カスタムグラフを作成するには、以下のようにします。 - *設定→ ホスト (もしくはテンプレート)*へ移動します。 - 目的のホストまたはテンプレートの行の*グラフ*をクリックします。 - グラフ画面で*グラフの作成*をクリックします。 - グラフの属性を編集します。 {width="600"} 必須入力項目には、赤いアスタリスクが表示されています。 グラフの属性: |パラメーター|<|説明| |-|----------|----------------------------------------| |*名前*|<|Unique graph name.<br>Expression [macros](/manual/appendix/macros/supported_by_location) are supported in this field, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).<br>{HOST.HOST<1-9>} macros are supported for the use within this macro, referencing the first, second, third, etc. host in the graph, for example `{?avg(/{HOST.HOST2}/key,1h)}`. Note that referencing the first host with this macro is redundant, as the first host can be referenced implicitly, for example `{?avg(//key,1h)}`.| |*幅*|<|Graph width in pixels (for preview and pie/exploded graphs only).| |*高さ*|<|Graph height in pixels.| |*グラフのタイプ*|<|Graph type:<br>**Normal** - normal graph, values displayed as lines<br>**Stacked** - stacked graph, filled areas displayed<br>**Pie** - pie graph<br>**Exploded** - "exploded" pie graph, portions displayed as "cut out" of the pie| |*凡例を表示*|<|Checking this box will set to display the graph legend.| |*ワーキングタイムの表示*|<|If selected, non-working hours will be shown with a gray background. This parameter is not available for pie and exploded pie graphs.| |*トリガーを表示*|<|If selected, simple triggers will be displayed as lines with black dashes over trigger severity color. This parameter is not available for pie and exploded pie graphs.| |*パーセンタイルライン (左)*|<|Display percentile for left Y-axis. If, for example, 95% percentile is set, then the percentile line will be at the level where 95 percent of the values fall under. Displayed as a bright green line. Only available for normal graphs.| |*パーセンタイルライン (右)*|<|Display percentile for right Y-axis. If, for example, 95% percentile is set, then the percentile line will be at the level where 95 percent of the values fall under. Displayed as a bright red line. Only available for normal graphs.| |*Y軸の最小値*|<|Minimum value of Y-axis:<br>**Calculated** - Y axis minimum value will be automatically calculated.<br>**Fixed** - fixed minimum value for Y-axis. <br>**Item** - last value of the selected item will be the minimum value.<br><br> This parameter is not available for pie and exploded pie graphs.| |*Y軸の最大値*|<|Maximum value of Y-axis:<br>**Calculated** - Y axis maximum value will be automatically calculated.<br>**Fixed** - fixed maximum value for Y-axis. <br>**Item** - last value of the selected item will be the maximum value<br><br> This parameter is not available for pie and exploded pie graphs.| |*3D表示*|<|Enable 3D style. For pie and exploded pie graphs only.| |*アイテム*|<|Items, data of which are to be displayed in this graph. Click on *Add* to select items. You can also select various displaying options (function, draw style, left/right axis display, color).| |<|*Sort order (0→100)*|Draw order. 0 will be processed first. Can be used to draw lines or regions behind (or in front of) another.<br>You can drag and drop items using the icon at the beginning of a line to set the sort order or which item is displayed in front of the other.| |^|*Name*|Name of the selected item is displayed as a link. Clicking on the link opens the list of other available items.| |^|*Type*|Type (only available for pie and exploded pie graphs):<br>**Simple** - the value of the item is represented proportionally on the pie<br>**Graph sum** - the value of the item represents the whole pie<br>Note that coloring of the "graph sum" item will only be visible to the extent that it is not taken up by "proportional" items.| |^|*Function*|Select what values will be displayed when more than one value exists per vertical graph pixel for an item:<br>**all** - display all possible values (minimum, maximum, average) in the graph. Note that for shorter periods this setting has no effect; only for longer periods, when data congestion in a vertical graph pixel increases, 'all' starts displaying minimum, maximum, and average values. This function is only available for *Normal* graph type. See also: Generating graphs [from history/trends](/manual/config/visualization/graphs/simple#generating_from_historytrends).<br>**avg** - display the average values<br>**last** - display the latest values. This function is only available if either *Pie/Exploded pie* is selected as graph type.<br>**max** - display the maximum values<br>**min** - display the minimum values| |^|*Draw style*|Select the draw style (only available for normal graphs; for stacked graphs filled region is always used) to apply to the item data - *Line*, *Bold line*, *Filled region*, *Dot*, *Dashed line*, *Gradient line*.| |^|*Y axis side*|Select the Y axis side to show the item data - *Left*, *Right*.| |^|*Color*|Select the color to apply to the item data.| #### Configuring JMX interfaces and items in Zabbix frontend With Java gateway running, server knowing where to find it and a Java application started with support for remote JMX monitoring, it is time to configure the interfaces and items in Zabbix GUI. #### ZabbixフロントエンドでのJMXインターフェースと item の設定 Java gateway が動作し、serveer が Java gateway の場所を認識し、リモートJMX監視をサポートするJavaアプリケーションが<br> 起動したら、Zabbix GUIでインタフェースと item を設定する必要があります。 #### Configuring low-level discovery rules See the [low-level discovery](/manual/discovery/low_level_discovery) section of the manual. #### ローレベルディスカバリの設定 マニュアルの[ローレベルディスカバリ](/manual/discovery/low_level_discovery)セクションを参照 #### Configuring nested templates To link templates, you need to take an existing template or a new one, and then: - Open the [template configuration form](/manual/config/templates/template#creating-a-template) - Find the *Templates* field - Click *Select* to open the *Templates* popup window - In the popup window, choose required templates, then click *Select* to add the templates to the list - Click *Add* or *Update* in the template configuration form Thus, all entities of the parent template, as well as all entities of linked templates (such as items, triggers, graphs, etc.) will now appear in the template configuration, except for linked template dashboards, which will, nevertheless, be inherited by hosts. To unlink any of the linked templates, in the same form use the *Unlink* or *Unlink and clear* buttons and click *Update*. Choosing the *Unlink* option will simply remove the association with the linked template, while not removing all its entities (items, triggers, graphs, etc.). Choosing the *Unlink and clear* option will remove both the association with the linked template and all its entities (items, triggers, graphs, etc.). #### ネストされたテンプレートの設定 テンプレートをリンクするには、既存のテンプレートまたは新しいテンプレートを取得する必要があります。次に: - [テンプレート設定フォーム](/manual/config/templates/template#creating-a-template)を開く - *テンプレート*フィールドを見つける - *選択*をクリックして、*テンプレート*ポップアップウィンドウを開く - ポップアップウィンドウで必要なテンプレートを選択し、*選択*をクリックしてテンプレートをリストに追加する - テンプレート設定フォームで*追加*または*更新*をクリックする テンプレート自体のすべてのエンティティおよびすべてのリンクされたテンプレートのエンティティ (アイテム、トリガー、グラフなど) は、ホストによって継承されるリンクされたテンプレートダッシュボードを除いて、テンプレート設定に表示されます。 リンクされたテンプレートのリンクを解除するには、同じフォームで*リンクを削除*または*リンクと保存データを削除*ボタンを選択し、*更新*をクリックします。 *リンクを削除*オプションを選択すると、リンクされたテンプレートとの関連付けが削除されますが、すべてのエンティティ (アイテム、トリガー、グラフなど) は削除されません。 *リンクと保存データを削除*オプションを選択すると、リンクされたテンプレートとそのすべてのエンティティ (アイテム、トリガー、グラフなど) との関連付けが削除されます。 ##### Configuring Perl trap receiver Requirements: Perl, Net-SNMP compiled with --enable-embedded-perl (done by default since Net-SNMP 5.4) A Perl trap receiver (look for misc/snmptrap/zabbix\_trap\_receiver.pl) can be used to pass traps to Zabbix server directly from snmptrapd. To configure it: - add the Perl script to the snmptrapd configuration file (snmptrapd.conf), e.g.: perl do "[FULL PATH TO PERL RECEIVER SCRIPT]"; - configure the receiver, e.g: $SNMPTrapperFile = '[TRAP FILE]'; $DateTimeFormat = '[DATE TIME FORMAT]'; ::: notetip If the script name is not quoted, snmptrapd will refuse to start up with messages, similar to these: Regexp modifiers "/l" and "/a" are mutually exclusive at (eval 2) line 1, at end of line Regexp modifier "/l" may not appear twice at (eval 2) line 1, at end of line ::: ##### Perl トラップ レシーバーの設定 要件: Perl および --enable-embedded-perl でコンパイルされた Net-SNMP (Net-SNMP 5.4 以降はデフォルトで実行) Perl トラップ レシーバー (misc/snmptrap/zabbix\_trap\_receiver.pl を参照) を使用して、snmptrapd から直接 Zabbix サーバーにトラップを渡すことができます。 設定するには: - Perl スクリプトを snmptrapd設定ファイル(snmptrapd.conf)に追加します。例: perl do "[PERL RECEIVER SCRIPT へのフルパス]"; - レシーバーを設定します。例: $SNMPTrapperFile = '[トラップ ファイル]'; $DateTimeFormat = '[日時フォーマット]'; ::: notetip スクリプト名が引用符で囲まれていない場合、snmptrapd は次のようなメッセージで起動を拒否します。 Regexp modifiers "/l" and "/a" are mutually exclusive at (eval 2) line 1, at end of line Regexp modifier "/l" may not appear twice at (eval 2) line 1, at end of line ::: #### Configuring plugins This section provides common plugin configuration principles and best practices. All plugins are configured using *Plugins.\** parameter, which can either be part of the Zabbix agent 2 [configuration file](/manual/appendix/config/zabbix_agent2) or a plugin's own [configuration file](/manual/appendix/config/zabbix_agent2_plugins). If a plugin uses a separate configuration file, path to this file should be specified in the Include parameter of Zabbix agent 2 configuration file. Each plugin parameter should have the following structure: *Plugins.<PluginName>.<Parameter>=<Value>* Parameter names should adhere to the following requirements: - it is recommended to capitalize the names of your plugins; - the parameter should be capitalized; - special characters are not allowed; - nesting isn’t limited by a maximum level; - the number of parameters is not limited. #### プラグインの設定 このセクションでは、一般的なプラグイン設定の原則とベストプラクティスについて説明します。 すべてのプラグインは *Plugins.\** パラメータを使用して設定します。このパラメータは、Zabbix agent 2の[configuration file]（/manual/appendix/config/zabbix_agent2）の一部、<br> またはプラグイン自身の[configuration file]（/manual/appendix/config/zabbix_agent2_plugins）のいずれかに設定することが<br> できます。プラグインが別の設定ファイルを使用する場合、Zabbix agent 2設定ファイルのIncludeパラメータにこのファイルへの<br> パスを指定する必要があります。 各プラグインのパラメータは、以下のような構造になっている必要があります: *Plugins.<PluginName>.<Parameter>=<Value>* パラメータ名は、以下の要件を満たす必要があります: - プラグイン名は大文字にすることを推奨します。 - パラメータは大文字にする必要があります。 - 特殊文字は使用できません。 - ネストは最大レベルによって制限されません。 - パラメータの数は制限されません。 #### Configuring PSK for server - active proxy communication (example) On the proxy, write the PSK value into a file, for example, `/home/zabbix/zabbix_proxy.psk`. The file must contain PSK in the first text string, for example: e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9 Set access rights to PSK file - it must be readable only by Zabbix user. Edit TLS parameters in proxy configuration file `zabbix_proxy.conf`, for example, set: TLSConnect=psk TLSPSKFile=/home/zabbix/zabbix_proxy.psk TLSPSKIdentity=PSK 002 The proxy will connect to server using PSK. PSK identity will be "PSK 002". (To minimize downtime see how to change connection type in [Connection encryption management](/manual/encryption#connection_encryption_management)). Configure PSK for this proxy in Zabbix frontend. Go to *Administration→Proxies*, select the proxy, go to "Encryption" tab. In "Connections from proxy" mark `PSK`. Paste into "PSK identity" field "PSK 002" and "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9" into "PSK" field. Click "Update". Restart proxy. It will start using PSK-based encrypted connections to server. Check server and proxy logfiles for error messages. For a passive proxy the procedure is very similar. The only difference - set `TLSAccept=psk` in proxy configuration file and set "Connections to proxy" in Zabbix frontend to `PSK`. #### サーバーの PSK の構成 - アクティブなプロキシ通信 (例) プロキシでPSK 値をファイルに書き込みます (例: `/home/zabbix/zabbix_proxy.psk`)。 ファイルの最初のテキスト文字列に PSK が含まれている必要があります。次に例を示します。 e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9 PSK ファイルへのアクセス権を設定します。Zabbix ユーザーだけが読み取れるようにする必要があります。 プロキシ構成ファイル `zabbix_proxy.conf` で TLS パラメータを編集します。たとえば、次のように設定します。 TLSConnect=psk TLSPSKFile=/home/zabbix/zabbix_proxy.psk TLSPSKIdentity=PSK 002 プロキシは PSK を使用してサーバーに接続します。 PSK ID は"PSK 002"になります。 (ダウンタイムを最小限に抑えるには、[接続暗号化の管理](/manual/encryption#connection_encryption_management) で接続タイプを変更する方法を参照してください)。 Zabbix フロントエンドでこのプロキシの PSK を構成します。 *[管理]→[プロキシ]* に移動し、プロキシを選択して、[暗号化] タブに移動します。 "プロキシからの接続"で`PSK`にチェックします。 "PSKアイデンティティ"フィールドに"PSK 002"を貼り付け、 "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9"を"PSK"フィールドに入力して、"更新"をクリックします。 プロキシを再起動して、 サーバーへの PSK ベースの暗号化された接続の使用を開始します。 サーバーとプロキシのログファイルでエラー メッセージを確認してください。 パッシブ プロキシの場合、手順は非常に似ています。 唯一の違いは、プロキシ構成ファイルで`TLSAccept=psk`を設定し、Zabbix フロントエンドで"プロキシへの接続"を`PSK`に設定することです。 #### Configuring PSK for server-agent communication (example) On the agent host, write the PSK value into a file, for example, `/home/zabbix/zabbix_agentd.psk`. The file must contain PSK in the first text string, for example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 Set access rights to PSK file - it must be readable only by Zabbix user. Edit TLS parameters in agent configuration file `zabbix_agentd.conf`, for example, set: TLSConnect=psk TLSAccept=psk TLSPSKFile=/home/zabbix/zabbix_agentd.psk TLSPSKIdentity=PSK 001 The agent will connect to server (active checks) and accept from server and `zabbix_get` only connections using PSK. PSK identity will be "PSK 001". Restart the agent. Now you can test the connection using `zabbix_get`, for example: zabbix_get -s 127.0.0.1 -k "system.cpu.load[all,avg1]" --tls-connect=psk --tls-psk-identity="PSK 001" --tls-psk-file=/home/zabbix/zabbix_agentd.psk (To minimize downtime see how to change connection type in [Connection encryption management](/manual/encryption?&#connection_encryption_management)). Configure PSK encryption for this agent in Zabbix frontend: - Go to: *Configuration → Hosts* - Select host and click on **Encryption** tab Example:  All mandatory input fields are marked with a red asterisk. When configuration cache is synchronized with database the new connections will use PSK. Check server and agent logfiles for error messages. #### サーバーエージェント通信用のPSK設定 (例) エージェントホストでPSK値をファイルに書き込みます (例: `/home/zabbix/zabbix_agentd.psk`)。ファイルには、最初のテキスト文字列にPSKが含まれている必要があります。例えば、 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 PSKファイルへのアクセス権を設定します。Zabbix ユーザーだけが読み取れるようにする必要があります。 エージェント設定ファイル`zabbix_agentd.conf`でTLSパラメーターを編集します。たとえば次のように設定します。 TLSConnect=psk TLSAccept=psk TLSPSKFile=/home/zabbix/zabbix_agentd.psk TLSPSKIdentity=PSK 001 エージェントはサーバーに接続し、PSKを使用したサーバー(アクティブチェック)と`zabbix_get`からの接続のみを受けつけます。PSK IDは"PSK 001"です。 エージェント再起動後、`zabbix_get`を使用して接続をテストできます。 例えば、 zabbix_get -s 127.0.0.1 -k "system.cpu.load[all,avg1]" --tls-connect=psk --tls-psk-identity="PSK 001" --tls-psk-file=/home/zabbix/zabbix_agentd.psk (ダウンタイムを最小限に抑えるには、[接続暗号化の管理](/manual/encryption?&#connection_encryption_management)の接続タイプを変更する方法を参照してください。) ZabbixフロントエンドでこのエージェントのPSK暗号化を設定します。 - *設定 → ホスト*に移動 - ホストを選択して**暗号化**タブをクリック 例:  すべての必須入力フィールドには赤いアスタリスクが付いています。 設定キャッシュがデータベースと同期されると、新しい接続はPSKを使用します。 サーバーとエージェントのログファイルでエラーメッセージを確認してください。 #### Configuring server for use with Java gateway With Java gateway up and running, you have to tell Zabbix server where to find Zabbix Java gateway. This is done by specifying JavaGateway and JavaGatewayPort parameters in the [server configuration file](/manual/appendix/config/zabbix_server). If the host on which JMX application is running is monitored by Zabbix proxy, then you specify the connection parameters in the [proxy configuration file](/manual/appendix/config/zabbix_proxy) instead. JavaGateway=192.168.3.14 JavaGatewayPort=10052 By default, server does not start any processes related to JMX monitoring. If you wish to use it, however, you have to specify the number of pre-forked instances of Java pollers. You do this in the same way you specify regular pollers and trappers. StartJavaPollers=5 Do not forget to restart server or proxy, once you are done with configuring them. #### Javaゲートウェイを使用するためのサーバー設定 Javaゲートウェイが稼働している状態で、ZabbixサーバーにZabbix Javaゲートウェイの場所を伝える必要があります。これは[サーバー設定ファイル](/manual/appendix/config/zabbix_server)でJavaGatewayおよびJavaGatewayPortパラメーターを指定することによって行われます。JMXアプリケーションが実行されているホストがZabbixプロキシによって監視されている場合は、代わりに[プロキシ設定ファイル](/manual/appendix/config/zabbix_proxy)で接続パラメーターを指定します。 JavaGateway=192.168.3.14 JavaGatewayPort=10052 デフォルトでは、サーバーはJMX監視に関連するプロセスを開始しません。使用する場合は、事前にフォークされたJavaポーラーのインスタンスの数を指定する必要があります。これは通常のポーラーとトラッパーを指定するのと同じ方法で行います。 StartJavaPollers=5 設定が完了したら、サーバーまたはプロキシを再起動してください。 #### Configuring server for use with Java gateway With Java gateway up and running, you have to tell Zabbix server where to find Zabbix Java gateway. This is done by specifying JavaGateway and JavaGatewayPort parameters in the [server configuration file](/manual/appendix/config/zabbix_server). If the host on which JMX application is running is monitored by Zabbix proxy, then you specify the connection parameters in the [proxy configuration file](/manual/appendix/config/zabbix_proxy) instead. JavaGateway=192.168.3.14 JavaGatewayPort=10052 By default, server does not start any processes related to JMX monitoring. If you wish to use it, however, you have to specify the number of pre-forked instances of Java pollers. You do this in the same way you specify regular pollers and trappers. StartJavaPollers=5 Do not forget to restart server or proxy, once you are done with configuring them. #### Javaゲートウェイを使用するためのサーバー設定 Javaゲートウェイが稼働している状態で、ZabbixサーバーにZabbix Javaゲートウェイの場所を伝える必要があります。これは[サーバー設定ファイル](/manual/appendix/config/zabbix_server)でJavaGatewayおよびJavaGatewayPortパラメーターを指定することによって行われます。JMXアプリケーションが実行されているホストがZabbixプロキシによって監視されている場合は、代わりに[プロキシ設定ファイル](/manual/appendix/config/zabbix_proxy)で接続パラメーターを指定します。 JavaGateway=192.168.3.14 JavaGatewayPort=10052 デフォルトでは、サーバーはJMX監視に関連するプロセスを開始しません。使用する場合は、事前にフォークされたJavaポーラーのインスタンスの数を指定する必要があります。これは通常のポーラーとトラッパーを指定するのと同じ方法で行います。 StartJavaPollers=5 設定が完了したら、サーバーまたはプロキシを再起動してください。 #### Configuring server for use with Java gateway With Java gateway up and running, you have to tell Zabbix server where to find Zabbix Java gateway. This is done by specifying JavaGateway and JavaGatewayPort parameters in the [server configuration file](/manual/appendix/config/zabbix_server). If the host on which JMX application is running is monitored by Zabbix proxy, then you specify the connection parameters in the [proxy configuration file](/manual/appendix/config/zabbix_proxy) instead. JavaGateway=192.168.3.14 JavaGatewayPort=10052 By default, server does not start any processes related to JMX monitoring. If you wish to use it, however, you have to specify the number of pre-forked instances of Java pollers. You do this in the same way you specify regular pollers and trappers. StartJavaPollers=5 Do not forget to restart server or proxy, once you are done with configuring them. #### Java ゲートウェイで使用するためのサーバー設定 Java ゲートウェイが稼働している状態で、Zabbix サーバーに Zabbix Java ゲートウェイの場所を伝える必要があります。 これは[サーバー設定ファイル](/manual/appendix/config/zabbix_server)でJavaGatewayおよびJavaGatewayPortパラメーターを指定することによって行われます。 JMX アプリケーションが実行されているホストが Zabbix プロキシによって監視されている場合は、代わりに [プロキシ設定ファイル](/manual/appendix/config/zabbix_proxy) で接続パラメータを指定します。 JavaGateway=192.168.3.14 JavaGatewayPort=10052 デフォルトでは、サーバーは JMX モニタリングに関連するプロセスを開始しません。 使用する場合は、事前にフォークされた Java ポーラーのインスタンスの数を指定する必要があります。 これは通常のポーラーとトラッパーを指定するのと同じ方法で行います。 StartJavaPollers=5 設定が完了したら、サーバーまたはプロキシを再起動してください。 #### Configuring server for use with Java gateway With Java gateway up and running, you have to tell Zabbix server where to find Zabbix Java gateway. This is done by specifying JavaGateway and JavaGatewayPort parameters in the [server configuration file](/manual/appendix/config/zabbix_server). If the host on which JMX application is running is monitored by Zabbix proxy, then you specify the connection parameters in the [proxy configuration file](/manual/appendix/config/zabbix_proxy) instead. JavaGateway=192.168.3.14 JavaGatewayPort=10052 By default, server does not start any processes related to JMX monitoring. If you wish to use it, however, you have to specify the number of pre-forked instances of Java pollers. You do this in the same way you specify regular pollers and trappers. StartJavaPollers=5 Do not forget to restart server or proxy, once you are done with configuring them. #### Javaゲートウェイを使用するためのサーバー設定 Javaゲートウェイが稼働している状態で、ZabbixサーバーにZabbix Javaゲートウェイの場所を伝える必要があります。これは[サーバー設定ファイル](/manual/appendix/config/zabbix_server)でJavaGatewayおよびJavaGatewayPortパラメーターを指定することによって行われます。JMXアプリケーションが実行されているホストがZabbixプロキシによって監視されている場合は、代わりに[プロキシ設定ファイル](/manual/appendix/config/zabbix_proxy)で接続パラメーターを指定します。 JavaGateway=192.168.3.14 JavaGatewayPort=10052 デフォルトでは、サーバーはJMX監視に関連するプロセスを開始しません。使用する場合は、事前にフォークされたJavaポーラーのインスタンスの数を指定する必要があります。これは通常のポーラーとトラッパーを指定するのと同じ方法で行います。 StartJavaPollers=5 設定が完了したら、サーバーまたはプロキシを再起動してください。 #### Configuring SNMP monitoring To start monitoring a device through SNMP, the following steps have to be performed: #### SNMPモニタリングの設定 SNMPによるデバイスの監視を開始するには、次の手順を実行する必要があります。 #### Configuring SNMP traps This item type requires the following frontend configuration. 1\. Create an SNMP interface for your host - In *Configuration > Hosts*, create/edit the host, and in the *Interfaces* field, add the interface type "SNMP", specifying the IP or DNS address.<br><br>The address from each received trap will be compared to the IP and DNS addresses of all SNMP interfaces to find the corresponding hosts. 2\. Configure the item - In *Configuration > Hosts*, create/edit the necessary item. - In the *Key* field, use one of the SNMP trap keys: |Key|<|<| |--|--|------| |Description|Return value|Comments| |**snmptrap**\[regexp\]|<|<| |Catches all SNMP traps that match the [regular expression](/manual/regular_expressions) specified in **regexp**. If regexp is unspecified, catches any trap.|SNMP trap|This item can be set only for SNMP interfaces.<br>User macros and global regular expressions are supported in the parameter of this item key.| |**snmptrap.fallback**|<|<| |Catches all SNMP traps that were not caught by any of the snmptrap\[\] items for that interface.|SNMP trap|This item can be set only for SNMP interfaces.| ::: noteclassic Multiline regular expression matching is not supported at this time. ::: - Set the *Type of information* to "Log" for the timestamps to be parsed. Other formats such as "Numeric" are also acceptable but might require a custom trap handler. #### SNMPトラップの設定 このアイテムタイプには、次のフロントエンド設定が必要です。 1\. ホスト用のSNMPインターフェースを作成 - *設定 > ホスト*で、ホストを作成/編集し、*インターフェース*フィールドに、インターフェースタイプ"SNMP"を追加、IPまたはDNSアドレスを指定します。<br><br>受信した各トラップのアドレスは、すべてのSNMPインターフェイスのIPおよびDNSアドレスと比較され、対応するホストを見つけます。 2\. アイテムの設定 - *設定 > ホスト*で、必要なアイテムを作成/編集します。 - *キー*フィールドで、SNMPトラップキーの1つを使用します。 |キー|<|<| |--|--|------| |説明|戻り値|コメント| |**snmptrap**\[regexp\]|<|<| |**regexp**で指定された[正規表現](/manual/regular_expressions)に一致するすべてのSNMPトラップをキャッチします。 regexpが指定されていない場合、すべてのトラップをキャッチします。|SNMPトラップ|このアイテムは、SNMPインターフェースに対してのみ設定できます。<br>このアイテムキーのパラメーターでは、ユーザーマクロとグローバル正規表現がサポートされています。| |**snmptrap.fallback**|<|<| |そのインターフェースのsnmptrap\[\]アイテムのいずれによってもキャッチされなかったすべてのSNMPトラップをキャッチします。|SNMPトラップ|このアイテムは、SNMPインターフェースに対してのみ設定できます。| ::: noteclassic 現時点では、複数行の正規表現一致はサポートされていません。 ::: - *データ型*をタイムスタンプが解析されるように"ログ"に設定します。"数値"などの他の形式も受け入れられますが、カスタムトラップハンドラーが必要になる場合があります。 ##### Configuring SNMPTT At first, snmptrapd should be configured to use SNMPTT. ::: notetip For the best performance, SNMPTT should be configured as a daemon using **snmptthandler-embedded** to pass the traps to it. See instructions for [configuring SNMPTT](http://snmptt.sourceforge.net/docs/snmptt.shtml). ::: When SNMPTT is configured to receive the traps, configure `snmptt.ini`: 1. enable the use of the Perl module from the NET-SNMP package: net\_snmp\_perl\_enable = 1 2. log traps to the trap file which will be read by Zabbix: log_enable = 1 log_file = [TRAP FILE] 3. set the date-time format: date_time_format = %H:%M:%S %Y/%m/%d = [DATE TIME FORMAT] ::: notewarning The "net-snmp-perl" package has been removed in RHEL 8.0-8.2; re-added in RHEL 8.3. For more information, see the [known issues](/manual/installation/known_issues#snmp_traps). ::: Now format the traps for Zabbix to recognize them (edit snmptt.conf): 1. Each FORMAT statement should start with "ZBXTRAP \[address\]", where \[address\] will be compared to IP and DNS addresses of SNMP interfaces on Zabbix. E.g.: EVENT coldStart .1.3.6.1.6.3.1.1.5.1 "Status Events" Normal FORMAT ZBXTRAP $aA Device reinitialized (coldStart) 2. See more about SNMP trap format below. ::: noteimportant Do not use unknown traps - Zabbix will not be able to recognize them. Unknown traps can be handled by defining a general event in snmptt.conf:\ EVENT general .\* "General event" Normal ::: ##### SNMPTT の設定 最初にSNMPTT を使用するよう、 snmptrapd を設定する必要があります。 ::: notetip 最高のパフォーマンスを得るためには**snmptthandler-embedded** を使用してトラップを渡すデーモンとして SNMPTT を構成する必要があります。 [SNMPTTの設定](http://snmptt.sourceforge.net/docs/snmptt.shtml)手順を参照してください。 ::: SNMPTT がトラップを受信するように構成されている場合は'snmptt.ini'を設定します。 1. NET-SNMP パッケージの Perl モジュールの使用を有効にします。 net\_snmp\_perl\_enable = 1 2. Zabbix によって読み取られるトラップ ファイルにトラップを記録します。 log_enable = 1 log_file = [トラップファイル] 3. 日付フォーマットを設定します。 date_time_format = %H:%M:%S %Y/%m/%d = [日付フォーマット] ::: notewarning "net-snmp-perl"パッケージは RHEL 8.0-8.2 で削除されましたが、RHEL 8.3で再度追加されました。詳細については[既知の問題](/manual/installation/known_issues#snmp_traps)を参照してください。 ::: Zabbix が認識できるようにトラップをフォーマットします (snmptt.conf を編集します)。 1. 各 FORMAT ステートメントは"ZBXTRAP \[address\]"で開始する必要があります。\[address\] は、Zabbix の SNMP インターフェースの IP および DNS アドレスと比較されます。例: EVENT coldStart .1.3.6.1.6.3.1.1.5.1 "Status Events" Normal FORMAT ZBXTRAP $aA Device reinitialized (coldStart) 2. 以下の SNMP トラップ形式の詳細を参照してください。 ::: noteimportant 未知のトラップは使用しないでください。Zabbix はそれらを認識できません。 snmptt.conf:\ EVENT general .\* "General event" Normal で一般イベントを定義することにより、不明なトラップを処理できます。 ::: #### Configuring steps {width="600"} Step parameters: |Parameter|Description| |--|--------| |*Name*|Unique step name.| |*URL*|URL to connect to and retrieve data. For example:<br>https://www.example.com<br>http://www.example.com/download<br>Domain names can be specified in Unicode characters. They are automatically punycode-converted to ASCII when executing the web scenario step.<br>The *Parse* button can be used to separate optional query fields (like ?name=Admin&password=mypassword) from the URL, moving the attributes and values into *Query fields* for automatic URL-encoding.<br>Variables can be used in the URL, using the {macro} syntax. Variables can be URL-encoded manually using a {{macro}.urlencode()} syntax.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.<br>Limited to 2048 characters.| |*Query fields*|HTTP GET variables for the URL.<br>Specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from scenario variables, user macros or {HOST.\*} macros are resolved and then URL-encoded automatically. Using a {{macro}.urlencode()} syntax will double URL-encode them.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Post*|HTTP POST variables.<br>In **Form data** mode, specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from scenario variables, user macros or {HOST.\*} macros are resolved and then URL-encoded automatically.<br>In **Raw data** mode, attributes/values are displayed on a single line and concatenated with a **&** symbol.<br>Raw values can be URL-encoded/decoded manually using a {{macro}.urlencode()} or {{macro}.urldecode()} syntax.<br>For example: id=2345&userid={user}<br>If {user} is defined as a variable of the web scenario, it will be replaced by its value when the step is executed. If you wish to URL-encode the variable, substitute {user} with {{user}.urlencode()}.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Variables*|Step-level variables that may be used for GET and POST functions.<br>Specified as attribute and value pairs.<br>Step-level variables override scenario-level variables or variables from the previous step. However, the value of a step-level variable only affects the step after (and not the current step).<br>They have the following format:<br>**{macro}**=value<br>**{macro}**=regex:<regular expression><br>For more information see variable description on the [scenario](web_monitoring#configuring_a_web_scenario) level.<br>Variables are automatically URL-encoded when used in query fields or form data for post variables, but must be URL-encoded manually when used in raw post or directly in URL.| |*Headers*|Custom HTTP headers that will be sent when performing a request.<br>Specified as attribute and value pairs.<br>A header defined on a step level will be used for that particular step.<br>**It should be noted that defining the header on a step level automatically discards all the previously defined headers, except for a default header that is assigned by selecting the 'User-Agent' from a drop-down list on a scenario level.**<br>However, even the 'User-Agent' default header can be overridden by specifying it on a step level.<br>For example, assigning the name to a header, but setting no value will unset the default header on a scenario level.<br>User macros and {HOST.\*} macros are supported.<br>This sets the [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURL option.<br>Specifying custom headers is supported *starting with Zabbix 2.4*.| |*Follow redirects*|Mark the checkbox to follow HTTP redirects.<br>This sets the [CURLOPT\_FOLLOWLOCATION](http://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html) cURL option.| |*Retrieve mode*|Select the retrieve mode:<br>**Body** - retrieve only body from the HTTP response<br>**Headers** - retrieve only headers from the HTTP response<br>**Body and headers** - retrieve body and headers from the HTTP response| |*Timeout*|Zabbix will not spend more than the set amount of time on processing the URL (from one second to maximum of 1 hour). Actually this parameter defines the maximum time for making connection to the URL and maximum time for performing an HTTP request. Therefore, Zabbix will not spend more than **2 x Timeout** seconds on the step.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 1h. [User macros](/manual/config/macros/user_macros) are supported.| |*Required string*|Required regular expression pattern.<br>Unless retrieved content (HTML) matches the required pattern the step will fail. If empty, no check on required string is performed.<br>For example:<br>Homepage of Zabbix<br>Welcome.\*admin<br>*Note*: Referencing [regular expressions](regular_expressions) created in the Zabbix frontend is not supported in this field.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Required status codes*|List of expected HTTP status codes. If Zabbix gets a code which is not in the list, the step will fail.<br>If empty, no check on status codes is performed.<br>For example: 200,201,210-299<br>User macros are supported.| ::: noteclassic Any changes in web scenario steps will only be saved when the whole scenario is saved. ::: See also a [real-life example](/manual/web_monitoring/example) of how web monitoring steps can be configured. #### ステップの設定 {width="600"} ステップパラメータ： |パラメーター|説明| | --------- | ----------- | |*名前*|一意のステップ名| |*URL*|接続してデータ取得するためのURL。<br>例：<br> https://www.example.com <br>http://www.example.com/download<br>ドメイン名はUnicode文字で指定できます。これらは、Webシナリオステップの実行時に自動的にPunycode変換されてASCIIに変換されます。<br>[*URL解析*]ボタンを使用して、オプションのクエリフィールド（?name=Admin&password=mypassword など）をURLから分離し、属性と値をURLエンコード用の*クエリフィールド*に移動できます。<br>{macro}構文を使用してURLで変数を使用できます。変数は{{macro}.urlencode()}構文を使用してURLエンコードできます。<br>ユーザーマクロと{HOST.\*}[macros](/manual/appendix/macros/supported_by_location)がサポートされています。<br>2048文字までの制限があります。| |*クエリフィールド*|URLのHTTP GET変数<br>属性と値をペアで指定します。<br>値は自動的にURLエンコードされます。シナリオ変数、ユーザーマクロ、または{HOST.\*}マクロの値は解決され、URLエンコードされます。 {{macro}.urlencode()}構文を使用すると、URLエンコードが2倍になります。<br>ユーザーマクロと{HOST.\*}[マクロ](/manual/appendix/macros/supported_by_location)がサポートされています。| |*POSTデータの形式*| HTTP POST変数<br>**フォームデータ**モードでは、属性と値をペアで指定します。<br>値は自動的にURLエンコードされます。シナリオ変数、ユーザーマクロ、または{HOST.\ *}マクロの値は解決され、URLエンコードされます。<br> **Rawデータ**モードでは、属性/値が1行に表示され*＆*記号で連結されます*。<br>未加工の値は{{macro}.urlencode()}または{{macro}.urldecode()}構文を使用してURLエンコード/デコードできます。<br>例：id=2345&userid={user}<br>{user}がWebシナリオの変数として定義されている場合、ステップの実行時に値が置き換えられます。変数をURLエンコードする場合は、{user}を{{user}.urlencode()}に置き換えます。<br>ユーザーマクロと{HOST.\*}[マクロ](/manual/appendix/macros/supported_by_location)がサポートされています。| |*変数*|GETおよびPOST関数に使用できるステップレベルの変数。<br>属性と値をペアで指定します。<br>ステップレベルの変数は、シナリオレベルの変数または前のステップの変数をオーバーライドします。ただし、ステップレベル変数の値は、後のステップにのみ影響します（現在のステップには影響しません）。<br>形式は次の通りです：<br>**{macro}**=value<br>**{macro}**=regex：<通常の式><br>詳細については[シナリオ](web_monitoring#configuring_a_web_scenario)レベルの変数の説明を参照してください。<br>変数は、クエリフィールドまたはPost変数のフォームデータで使用される場合は自動的にURLエンコードされますが、raw Postまたは直接URLで使用される場合は手動でURLエンコードする必要があります。変数はクエリフィールドまたはフォームデータで使用されると自動的にURLエンコードされます。投稿変数。ただし、生の投稿で使用する場合、またはURLで直接使用する場合は、手動でURLエンコードする必要があります。| |*ヘッダー*|リクエストの実行時に送信されるカスタムHTTPヘッダー<br>属性と値をペアで指定します。<br>ステップレベルのヘッダーは、シナリオに指定されたヘッダーを上書きします。<br>たとえば、値を指定せずに「User-Agent」属性を設定すると、シナリオレベルで設定されたUser-Agent値が削除されます。<br>ユーザーマクロと{HOST.\*}マクロがサポートされます。<br>[CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURLオプションが設定されます。| |*リダイレクトをたどる*|チェックボックスをマークするとHTTPリダイレクトを追跡します。<br>[CURLOPT\_FOLLOWLOCATION](http://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html) cURLオプションが設定されます。| |*取得モード*|取得モードを選択します<br>**Body** - HTTPの応答から本文のみを取得します<br>**Headers** - HTTPの応答からヘッダーのみを取得します<br>**Body and headers** - HTTPの応答から本文とヘッダーを取得します| |*タイムアウト*|ZabbixはURLの処理に設定された時間（1秒から最大1時間）を超えてURLを処理することはありません。このパラメーターはURLに接続するための最大時間とHTTP要求を実行するための最大時間を定義します。したがってZabbixはステップに**Timeoutの2倍の秒数**以上の時間をかけません。<br>[Timesuffixes](/manual/appendix/Supplements)がサポートされています。 例. 30s, 1m, 1h<br>[ユーザーマクロ](/manual/config/macros/user_macros)がサポートされています。| |*要求文字列*|要求される正規表現パターン<br>取得したコンテンツ（HTML）が必要なパターンと一致しない場合、ステップは失敗します。空の場合、チェックは実行されません。<br>例：<br>Homepage of Zabbix<br>Welcome.\*admin<br> *注*：Zabbixフロントエンドで作成された[正規表現](regular_expressions)は、このフィールドで参照されません。<br>ユーザーマクロと{HOST.\*}[マクロ](/manual/appendix/macros/supported_by_location)がサポートされています。| |*要求ステータスコード*|予想されるHTTPステータスコードのリスト。 Zabbixがリストにないコードを取得した場合、ステップは失敗します。<br>空の場合、ステータスコードのチェックは実行されません。<br>例：200,201,210-299<br>ユーザーマクロがサポートされています。| ::: noteclassic Webシナリオのステップの変更は、シナリオ全体が保存されたときにのみ保存されます。 ::: Web監視ステップを構成する方法の[実例](/manual/web_monitoring/example)も参照してください。 #### Configuring tags The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging).  Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). #### タグの設定 **タグ**タブでは、シナリオレベルの[タグ](/manual/config/tagging)を定義できます。  タグ付けにより、WebシナリオとWeb監視[アイテム](/manual/web_monitoring/items)をフィルタリングできます。 ##### Configuring Zabbix server/proxy To read the traps, Zabbix server or proxy must be configured to start the SNMP trapper process and point to the trap file that is being written by SNMPTT or a Bash/Perl trap receiver. To do that, edit the configuration file ([zabbix\_server.conf](/manual/appendix/config/zabbix_server) or [zabbix\_proxy.conf](/manual/appendix/config/zabbix_proxy)): ```ini StartSNMPTrapper=1 SNMPTrapperFile=[TRAP FILE] ``` ::: notewarning If systemd parameter **[PrivateTmp](http://www.freedesktop.org/software/systemd/man/systemd.exec.html#PrivateTmp=)** is used, this file is unlikely to work in */tmp*. ::: ##### Configuring Bash trap receiver Requirements: only snmptrapd. A Bash trap receiver [script](https://raw.githubusercontent.com/zabbix/zabbix-docker/6.0/Dockerfiles/snmptraps/alpine/conf/usr/sbin/zabbix_trap_handler.sh) can be used to pass traps to Zabbix server directly from snmptrapd. To configure it, add the `traphandle` option to snmptrapd configuration file (`snmptrapd.conf`), see [example](https://raw.githubusercontent.com/zabbix/zabbix-docker/6.0/Dockerfiles/snmptraps/alpine/conf/etc/snmp/snmptrapd.conf). ##### Zabbixサーバー/プロキシの設定 トラップを読み取るには、ZabbixサーバーまたはプロキシがSNMPトラッパープロセスを開始し、SNMPTTまたはBash/Perlトラップレシーバーによって書き込まれているトラップファイルを指すように構成されている必要があります。これを行うには設定ファイル([zabbix\_server.conf](/manual/appendix/config/zabbix_server)または [zabbix\_proxy.conf](/manual/appendix/config/zabbix_proxy))を編集します。 ```ini StartSNMPTrapper=1 SNMPTrapperFile=[TRAP FILE] ``` ::: notewarning systemdパラメーター**[PrivateTmp](http://www.freedesktop.org/software/systemd/man/systemd.exec.html#PrivateTmp=)**が使用されている場合、このファイルは*/tmp*では機能しません。 ::: ##### Bashトラップレシーバーの設定 要件: snmptrapdのみ。 Bashトラップレシーバー[スクリプト](https://raw.githubusercontent.com/zabbix/zabbix-docker/6.2/Dockerfiles/snmptraps/alpine/conf/usr/sbin/zabbix_trap_handler.sh)を使用して、snmptrapdから直接Zabbixサーバーにトラップを渡すことができます。設定するには、snmptrapd設定ファイル(`snmptrapd.conf`)に`traphandle`オプションを追加します。 [例](https://raw.githubusercontent.com/zabbix/zabbix-docker/6.2/Dockerfiles/snmptraps/alpine /conf/etc/snmp/snmptrapd.conf)を参照してください。 ### Connection options for Oracle plugin The Oracle plugin, supported for Zabbix agent 2, now allows to specify `as sysdba`, `as sysoper`, or `as sysasm` login option. The option can be appended either to the user item key parameter or to the plugin configuration parameter Plugins.Oracle.Sessions.<SessionName>.User in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). ### Oracleプラグインの接続オプション Zabbixエージェント2でサポートされているOracleプラグインで、ログインオプションとして`as sysdba`, `as sysoper`, `as sysasm`を指定できるようになりました。 このオプションは、ユーザーアイテムキーのパラメーター、または`user as sysdba`フォーマットのプラグイン設定パラメーターPlugins.Oracle.Sessions.<SessionName>.Userに追加することができます(ログインオプションは大文字と小文字を区別せず、末尾にスペースを含めることはできません)。 ### Connection set up Zabbix supports two types of connect identifiers (connection methods): - Easy Connect - Net Service Name Connection configuration parameters for Zabbix server and Zabbix proxy can be set in the configuration files. Important parameters for the server and proxy are *DBHost*, *DBUser*, *DBName* and *DBPassword*. The same parameters are important for the frontend: *$DB\["SERVER"\]*, *$DB\["PORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*, *$DB\["PASSWORD"\]*. Zabbix uses the following connection string syntax: {DBUser/DBPassword[@<connect_identifier>]} <connect\_identifier> can be specified either in the form of "Net Service Name" or "Easy Connect". @[[//]Host[:Port]/<service_name> | <net_service_name>] ### 接続設定 Zabbixは2種類の接続識別子（接続方法）をサポートしています。 - Easy Connect - Net Service Name ZabbixサーバーとZabbixプロキシの接続設定パラメータは設定ファイルで設定できます。サーバーとプロキシーの重要なパラメーターは*DBHost*、*DBUser*、*DBName*、および*DBPassword*です。同じようにフロントエンドでも次のパラメータが重要です：*$DB\["SERVER"\]*,*$DB\["PORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*,*$DB\["PASSWORD"\]* Zabbixは次の接続文字列構文を使用します。 {DBUser/DBPassword[@<connect_identifier>]} <connect\_identifier>は"Net Service Name"または"Easy Connect"のいずれかの形式で指定できます。 @[[//]Host[:Port]/<service_name> | <net_service_name>] #### Consistency introduced in sha256 checksums of vfs.file.cksum item In earlier Zabbix versions, the Zabbix agent item [`vfs.file.cksum`](/manual/config/items/itemtypes/zabbix_agent#virtual-file-system-data) produced different sha256 sums for the same file depending on the platform (processor architecture) – sha256 sums on AIX, HP-UX (Itanium) and Solaris (SPARC) differed from those produced on Intel x86-64 platforms. The issue has now been fixed; however, after upgrading, monitoring sha256 sums of files on AIX, HP-UX, or Solaris SPARC may result in false positives of files having been modified. #### vfs.file.cksumアイテムのsha256チェックサムに一貫性が導入されました 以前のZabbixバージョンでは、Zabbixエージェントアイテム[`vfs.file.cksum`](/manual/config/items/itemtypes/zabbix_agent#virtual-file-system-data)は、プラットフォーム (プロセッサアーキテクチャ) に応じて、同じファイルに対して異なるsha256sumを生成しました。AIX、HP-UX (Itanium)、および Solaris (SPARC) 上のsha256sumは、 Intel x86-64プラットフォームで作成されたものとは異なります。 この問題は現在修正されています。ただし、アップグレード後、AIX、HP-UX、またはSolaris SPARC上のファイルのsha256sumを監視すると、ファイルが変更されているという誤検知が発生する可能性があります。 #### Content conversion to UTF-8 HTTP agent items, web scenarios, web checks and JavaScript items have been improved to convert to UTF-8 from the character set specified in the HTTP header or HTTP meta tag. #### コンテンツのUTF-8への変換 HTTPエージェントアイテム、webシナリオ、webチェック、およびJavaScriptアイテムが、HTTP ヘッダーまたは HTTPメタタグで指定された文字セットからUTF-8に変換されるように改善されました。 #### Copy an LLD rule to multiple hosts Copy an LLD rule to two hosts. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.copy", "params": { "discoveryids": [ "27426" ], "hostids": [ "10196", "10197" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### LLDルールを複数のホストにコピーします LLDルールを2つのホストにコピー Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.copy", "params": { "discoveryids": [ "27426" ], "hostids": [ "10196", "10197" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### Copying/pasting pages Dashboard pages can be copied and pasted, allowing to create a new page with the properties of an existing one. They can be pasted from the same dashboard or a different dashboard. To paste an existing page to the dashboard, first copy it, using the [page menu](#page_menu):  To paste the copied page: - 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 *Paste page* option #### ページのコピーと貼り付け ダッシュボードページをコピーして貼り付けることで、既存のページのプロパティを使用して新しいページを作成できます。 同じダッシュボードまたは別のダッシュボードから貼り付けることができます。 既存のページをダッシュボードに貼り付けるには、まず[ページメニュー](#page_menu)を使用してページをコピーします。  コピーしたページを貼り付けるには： - ダッシュボードが[編集モード](#viewing_and_editing_a_dashboard)になっていることを確認します - *追加*ボタンの横にある矢印をクリックして*ページの貼り付け*オプションを選択します #### Copying/pasting widgets Dashboard widgets can be copied and pasted, allowing to create a new widget with the properties of an existing one. They can be copy-pasted within the same dashboard, or between dashboards opened in different tabs. A widget can be copied using the [widget menu](#widget_menu). To paste the widget: - click on the arrow next to the *Add* button and selecting the *Paste widget* option, when editing the dashboard - use the *Paste widget* option when adding a new widget by selecting some area in the dashboard (a widget must be copied first for the paste option to become available) A copied widget can be used to paste over an existing widget using the *Paste* option in the [widget menu](#widget_menu). #### ウィジェットのコピー/貼り付け ダッシュボードウィジェットはコピーして貼り付けることで、既存のウィジェットのプロパティを使用して新しいウィジェットを作成できます。 同じダッシュボード内、または異なるタブで開いたダッシュボード間でコピーして貼り付けることができます。 [ウィジェットメニュー](#widget_menu)を使用してウィジェットをコピーできます。 ウィジェットを貼り付けるには - ダッシュボードを編集するときに、*追加*ボタンの横にある矢印をクリックして*ウィジェットの貼り付け*オプションを選択します - ダッシュボードの一部の領域を選択して新しいウィジェットを追加する場合は、*ウィジェットの貼り付け*オプションを使用します（貼り付けオプションを使用できるようにするには、ウィジェットを最初にコピーする必要があります） コピーしたウィジェットを[ウィジェットメニュー](#widget_menu)の*貼り付け*オプションで既存のウィジェットに貼り付けることもできます。 ##### Copying PHP files Zabbix frontend is written in PHP, so to run it a PHP supported webserver is needed. Installation is done by simply copying the PHP files from the ui directory to the webserver HTML documents directory. Common locations of HTML documents directories for Apache web servers include: - /usr/local/apache2/htdocs (default directory when installing Apache from source) - /srv/www/htdocs (OpenSUSE, SLES) - /var/www/html (Debian, Ubuntu, Fedora, RHEL) It is suggested to use a subdirectory instead of the HTML root. To create a subdirectory and copy Zabbix frontend files into it, execute the following commands, replacing the actual directory: mkdir <htdocs>/zabbix cd ui cp -a . <htdocs>/zabbix If planning to use any other language than English, see [Installation of additional frontend languages](/manual/appendix/install/locales) for instructions. ##### PHPファイルのコピー ZabbixフロントエンドはPHPで書かれているため、それを実行するにはPHPをサポートするWebサーバーが必要です。 インストールは、PHPファイルをuiディレクトリからWebサーバーのHTMLドキュメントディレクトリにコピーするだけで行われます。 Apache WebサーバーのHTMLドキュメントディレクトリの一般的な場所は次のとおりです。 - /usr/local/apache2/htdocs (Apacheをソースからインストールする場合のデフォルトディレクトリ) - /srv/www/htdocs (OpenSUSE, SLES) - /var/www/html (Debian, Ubuntu, Fedora, RHEL) HTMLルートの代わりにサブディレクトリを使用することをお勧めします。 サブディレクトリを作成し、そこにZabbixフロントエンドファイルをコピーするには、次のコマンドを実行して、実際のディレクトリを置き換えます。 mkdir <htdocs>/zabbix cd ui cp -a . <htdocs>/zabbix 英語以外の言語を使用する場合は、[追加のフロントエンド言語のインストール](/manual/appendix/install/locales)で手順を参照してください。 ### Copyright notice Zabbix documentation is NOT distributed under a GPL license. Use of Zabbix documentation is subject to the following terms: You may create a printed copy of this documentation solely for your own personal use. Conversion to other formats is allowed as long as the actual content is not altered or edited in any way. You shall not publish or distribute this documentation in any form or on any media, except if you distribute the documentation in a manner similar to how Zabbix disseminates it (that is, electronically for download on a Zabbix web site) or on a USB or similar medium, provided however that the documentation is disseminated together with the software on the same medium. Any other use, such as any dissemination of printed copies or use of this documentation, in whole or in part, in another publication, requires the prior written consent from an authorized representative of Zabbix. Zabbix reserves any and all rights to this documentation not expressly granted above. ### 著作権表示 Zabbixのドキュメントは、GPLライセンスの下で配布されていません。Zabbixドキュメントの使用には、次の条件が適用されます。 個人的な利用の場合、このドキュメントの印刷物を作成することができます。 実際の内容が変更または編集されない限り、他の形式への変換は許可されます。 Zabbixが配布する方法と同様の方法（つまり、Zabbix Webサイトから電子的にダウンロードする）またはUSBなどの媒体でドキュメントを配布する場合を除き、いかなる形式、メディアでも、このドキュメントを公開、配布してはなりません。 ただし、ドキュメントがソフトウェアと一緒に同じ媒体で配布されることを条件とします。 印刷物の配布や、このドキュメントの全体または一部を別の出版物で使用するなどのその他の利用には、Zabbixの正式な代表者からの事前の書面による同意が必要です。Zabbixは、上記で明示的に付与されていない、このドキュメントに対するすべての権利を留保します。 # correlation.create # correlation.create # correlation.delete # correlation.delete #### Correlation filter condition The correlation filter condition object defines a specific condition that must be checked before running the correlation operations. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|Type of condition.<br><br>Possible values:<br>0 - old event tag;<br>1 - new event tag;<br>2 - new event host group;<br>3 - event tag pair;<br>4 - old event tag value;<br>5 - new event tag value.| |tag|string|Event tag (old or new). Required when type of condition is: 0, 1, 4, 5.| |groupid|string|Host group ID. Required when type of condition is: 2.| |oldtag|string|Old event tag. Required when type of condition is: 3.| |newtag|string|Old event tag. Required when type of condition is: 3.| |value|string|Event tag (old or new) value. Required when type of condition is: 4, 5.| |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>Required when type of condition is: 2, 4, 5.| ::: notetip To better understand how to use filters with various types of expressions, see examples on the [correlation.get](get#retrieve_correlations) and [correlation.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| |---------|--------------|-------------------|--------------| |2|Host group|=, <>|Host group ID.| |4|Old event tag value|=, <>, like, not like|string| |5|New event tag value|=, <>, like, not like|string| #### 相関フィルター条件 相関フィルタ条件オブジェクトは、相関処理を実行する前に確認する必要のある特定の条件を定義します。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**type**<br>(required)|integer|Type of condition.<br><br>Possible values:<br>0 - old event tag;<br>1 - new event tag;<br>2 - new event host group;<br>3 - event tag pair;<br>4 - old event tag value;<br>5 - new event tag value.| |tag|string|Event tag (old or new). Required when type of condition is: 0, 1, 4, 5.| |groupid|string|Host group ID. Required when type of condition is: 2.| |oldtag|string|Old event tag. Required when type of condition is: 3.| |newtag|string|Old event tag. Required when type of condition is: 3.| |value|string|Event tag (old or new) value. Required when type of condition is: 4, 5.| |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>Required when type of condition is: 2, 4, 5.| ::: notetip 様々なタイプの式でフィルタを使用する方法を理解するために<br> [correlation.get](get#retrieve_correlations) と [correlation.create](create#using_a_custom_expression_filter) メソッドの例を参照してください。 ::: 各条件タイプでサポートされる演算子および値は以下の通りです。 |条件|条件名|サポートされる演算子|想定する値| |---------|--------------|-------------------|--------------| |2|Host group|=, <>|Host group ID.| |4|Old event tag value|=, <>, like, not like|string| |5|New event tag value|=, <>, like, not like|string| ### Correlation filter The correlation filter object defines a set of conditions that must be met to perform the configured correlation operations. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**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.| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |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.| ### 相関フィルタ 相関フィルタオブジェクトは、設定された相関処理を実行するために満たす必要のある一連の条件を定義します。<br> このオブジェクトには、次のプロパティがあります。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**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.| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |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.| # correlation.get # correlation.get ### Correlation operation The correlation operation object defines an operation that will be performed when a correlation is executed. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|Type of operation.<br><br>Possible values:<br>0 - close old events;<br>1 - close new event.| ### 相関オペレーション 相関操作オブジェクトは、相関が実行されたときに実行される操作を定義します。以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**type**<br>(required)|integer|Type of operation.<br><br>Possible values:<br>0 - close old events;<br>1 - close new event.| ### Correlation The correlation object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |correlationid|string|*(readonly)* ID of the correlation.| |**name**<br>(required)|string|Name of the correlation.| |description|string|Description of the correlation.| |status|integer|Whether the correlation is enabled or disabled.<br><br>Possible values are:<br>0 - *(default)* enabled;<br>1 - disabled.| ### Correlation Correlation オブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |correlationid|string|*(readonly)* ID of the correlation.| |**name**<br>(required)|string|Name of the correlation.| |description|string|Description of the correlation.| |status|integer|Whether the correlation is enabled or disabled.<br><br>Possible values are:<br>0 - *(default)* enabled;<br>1 - disabled.| # correlation.update # correlation.update ### Cosmos DB monitoring The template *Azure by HTTP* now also works with Azure Cosmos DB for MongoDB. You can get this template: - In *Configuration → Templates* in new installations. - If you are upgrading from previous versions, you can download this template from Zabbix [Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) or find it in the *zabbix/templates* directory of the downloaded latest Zabbix version. Then, while in *Configuration → Templates* you can import it manually into Zabbix. ### Cosmos DB監視 テンプレート*Azure by HTTP*が、Azure Cosmos DB for MongoDBでも動作するようになりました。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、新しいテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードするか、またはダウンロードした最新バージョンの`templates`ディレクトリから入手します。その後、*設定* → *テンプレート*で手動でZabbixにインポートします。 ##### Counting of threads in `proc.mem[]` and `proc.num[]` items Linux kernel threads are counted by `proc.num[]` item but do not report memory in `proc.mem[]` item. For example: $ ps -ef | grep kthreadd root 2 0 0 09:51 ? 00:00:00 [kthreadd] $ zabbix_get -s localhost -k 'proc.num[kthreadd]' 1 $ zabbix_get -s localhost -k 'proc.mem[kthreadd]' ZBX_NOTSUPPORTED: Cannot get amount of "VmSize" memory. But what happens if there is a user process with the same name as a kernel thread ? Then it could look like this: $ ps -ef | grep kthreadd root 2 0 0 09:51 ? 00:00:00 [kthreadd] zabbix 9611 6133 0 17:58 pts/1 00:00:00 ./kthreadd $ zabbix_get -s localhost -k 'proc.num[kthreadd]' 2 $ zabbix_get -s localhost -k 'proc.mem[kthreadd]' 4157440 `proc.num[]` counted both the kernel thread and the user process. `proc.mem[]` reports memory for the user process only and counts the kernel thread memory as if it was 0. This is different from the case above when ZBX\_NOTSUPPORTED was reported. Be careful when using `proc.mem[]` and `proc.num[]` items if the program name happens to match one of the thread. Before putting parameters into `proc.mem[]` and `proc.num[]` items, you may want to test the parameters using `proc.num[]` item and `ps` command. ##### `proc.mem[]`および`proc.num[]`アイテムのスレッドカウント Linuxカーネルスレッドは`proc.num[]`アイテムによってカウントされますが、`proc.mem[]`アイテムのメモリは報告されません。 例： $ ps -ef | grep kthreadd root 2 0 0 09:51 ? 00:00:00 [kthreadd] $ zabbix_get -s localhost -k 'proc.num[kthreadd]' 1 $ zabbix_get -s localhost -k 'proc.mem[kthreadd]' ZBX_NOTSUPPORTED: Cannot get amount of "VmSize" memory. しかし、カーネルスレッドと同じ名前のユーザープロセスがある場合は次のようになります。 $ ps -ef | grep kthreadd root 2 0 0 09:51 ? 00:00:00 [kthreadd] zabbix 9611 6133 0 17:58 pts/1 00:00:00 ./kthreadd $ zabbix_get -s localhost -k 'proc.num[kthreadd]' 2 $ zabbix_get -s localhost -k 'proc.mem[kthreadd]' 4157440 `proc.num []`はカーネルスレッドとユーザープロセスの両方をカウントしました。 `proc.mem []`はユーザープロセスのメモリのみを報告し、カーネルスレッドメモリを0であるかのようにカウントします。これはZBX\_NOTSUPPORTEDが報告された上記の場合とは異なります。 プログラム名がスレッドの1つと一致する場合は、`proc.mem[]`および`proc.num[]`アイテムを使用するときに注意してください。 パラメータを`proc.mem[]`および`proc.num[]`アイテムに入れる前に、`proc.num[]`アイテムと`ps`コマンドを使用してパラメータをテストすることをお勧めします。 **CPU** Zabbix and especially Zabbix database may require significant CPU resources depending on number of monitored parameters and chosen database engine. **CPU** Zabbix、特にZabbixデータベースは、監視するパラメーターの数や選択したデータベースエンジンに応じて、かなりのCPUリソースを必要とする場合があります。 #### Create a custom script Create a custom script that will reboot a server. The script will require write access to the host and will display a configuration message before running in the frontend. Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Reboot server", "command": "reboot server 1", "confirmation": "Are you sure you would like to reboot the server?", "scope": 2, "type": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "4" ] }, "id": 1 } ``` #### カスタムスクリプトを作成する サーバーを再起動するカスタムスクリプトを作成します。 スクリプトはホストへの書き込みアクセスを必要とし、フロントエンドで実行する前に設定メッセージを表示します。 Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Reboot server", "command": "reboot server 1", "confirmation": "Are you sure you would like to reboot the server?", "scope": 2, "type": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "4" ] }, "id": 1 } ``` #### Create a discovery action Create a discovery action that will link discovered hosts to template "10001". Request: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Discovery action", "eventsource": 1, "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 21, "operator": 0, "value": "1" }, { "conditiontype": 10, "operator": 0, "value": "2" } ] }, "operations": [ { "operationtype": 6, "optemplate": [ { "templateid": "10001" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### ディスカバリアクションの作成 検出されたホストをテンプレート"10001"にリンクするディスカバリアクションを作成します。 リクエスト : ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Discovery action", "eventsource": 1, "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 21, "operator": 0, "value": "1" }, { "conditiontype": 10, "operator": 0, "value": "2" } ] }, "operations": [ { "operationtype": 6, "optemplate": [ { "templateid": "10001" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス : ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Create a discovery rule Create a discovery rule to find machines running the Zabbix agent in the local network. The rule must use a single Zabbix agent check on port 10050. Request: ```json { "jsonrpc": "2.0", "method": "drule.create", "params": { "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "dchecks": [ { "type": "9", "key_": "system.uname", "ports": "10050", "uniq": "0" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### ディスカバリルールの作成 ローカルネットワークでZabbixエージェントを実行しているマシンを見つけるためのディスカバリルールを作成します。ルールはポート10050で単一のZabbixエージェントチェックを使用する必要があります。 リクエスト: ```json { "jsonrpc": "2.0", "method": "drule.create", "params": { "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "dchecks": [ { "type": "9", "key_": "system.uname", "ports": "10050", "uniq": "0" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Create agent autoregistration rule Create an autoregistration action that adds a host to host group "2" when the host name contains "SRV" or metadata contains "AlmaLinux". Request: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers", "eventsource": "2", "filter": { "evaltype": "2", "conditions": [ { "conditiontype": "22", "operator": "2", "value": "SRV" }, { "conditiontype": "24", "operator": "2", "value": "AlmaLinux" } ] }, "operations": [ { "operationtype": "4", "opgroup": [ { "groupid": "2" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### エージェントの自動登録ルール作成 ホスト名に"SRV "が含まれているか、メタデータに"AlmaLinux"が含まれている場合、ホストをホストグループ "2"に追加します。 リクエスト : ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers", "eventsource": "2", "filter": { "evaltype": "2", "conditions": [ { "conditiontype": "22", "operator": "2", "value": "SRV" }, { "conditiontype": "24", "operator": "2", "value": "AlmaLinux" } ] }, "operations": [ { "operationtype": "4", "opgroup": [ { "groupid": "2" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス : ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### Create a host map Create a map with two host elements and a link between them. Note the use of temporary "selementid1" and "selementid2" values in the map link object to refer to map elements. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "selements": [ { "selementid": "1", "elements": [ {"hostid": "1033"} ], "elementtype": 0, "iconid_off": "2" }, { "selementid": "2", "elements": [ {"hostid": "1037"} ], "elementtype": 0, "iconid_off": "2" } ], "links": [ { "selementid1": "1", "selementid2": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### ホストマップを作成する 2つのホスト要素とそれらの間のリンクを使用してマップを作成します。 マップ要素を参照するために、マップリンクオブジェクトで一時的な「selementid1」および「selementid2」値を使用していることに注意してください。 Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "selements": [ { "selementid": "1", "elements": [ {"hostid": "1033"} ], "elementtype": 0, "iconid_off": "2" }, { "selementid": "2", "elements": [ {"hostid": "1037"} ], "elementtype": 0, "iconid_off": "2" } ], "links": [ { "selementid1": "1", "selementid2": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### Create an active proxy Create an action proxy "Active proxy" and assign a host to be monitored by it. Request: ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "host": "Active proxy", "status": "5", "hosts": [ { "hostid": "10279" } ] }, "auth": "ab9638041ec6922cb14b07982b268f47", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10280" ] }, "id": 1 } ``` #### アクティブプロキシの作成 アクションプロキシ"Active proxy"を作成し、それによって監視されるホストを割り当てます。 リクエスト : ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "host": "Active proxy", "status": "5", "hosts": [ { "hostid": "10279" } ] }, "auth": "ab9638041ec6922cb14b07982b268f47", "id": 1 } ``` レスポンス : ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10280" ] }, "id": 1 } ``` #### Create an empty map Create a map with no elements. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map", "width": 600, "height": 600 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "8" ] }, "id": 1 } ``` #### 空のマップを作成する 要素のないマップを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map", "width": 600, "height": 600 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "8" ] }, "id": 1 } ``` #### Create a new event tag correlation Create a correlation using evaluation method `AND/OR` with one condition and one operation. By default the correlation will be enabled. Request: ```json { "jsonrpc": "2.0", "method": "correlation.create", "params": { "name": "new event tag correlation", "filter": { "evaltype": 0, "conditions": [ { "type": 1, "tag": "ok" } ] }, "operations": [ { "type": 0 } ] }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### 新しいイベントタグ相関の作成 1つの条件と1つの演算による評価方法`AND/OR`を使用して相関関係を作成します。デフォルトでは相関関係は有効になります。 リクエスト: ```json { "jsonrpc": "2.0", "method": "correlation.create", "params": { "name": "new event tag correlation", "filter": { "evaltype": 0, "conditions": [ { "type": 1, "tag": "ok" } ] }, "operations": [ { "type": 0 } ] }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Create a new interface Create a secondary IP agent interface on host "30052." Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "30052", "main": "0", "type": "1", "useip": "1" "ip": "127.0.0.1", "dns": "", "port": "10050", }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### 新しいインターフェースの作成 ホスト"30052"にセカンダリIPエージェントインターフェースを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "30052", "main": "0", "type": "1", "useip": "1" "ip": "127.0.0.1", "dns": "", "port": "10050", }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Create an icon map Create an icon map to display hosts of different types. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.create", "params": { "name": "Type icons", "default_iconid": "2", "mappings": [ { "inventory_link": 1, "expression": "server", "iconid": "3" }, { "inventory_link": 1, "expression": "switch", "iconid": "4" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "id": 1 } ``` #### アイコンマップを作成する さまざまなタイプのホストを表示するアイコンマップを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "iconmap.create", "params": { "name": "Type icons", "default_iconid": "2", "mappings": [ { "inventory_link": 1, "expression": "server", "iconid": "3" }, { "inventory_link": 1, "expression": "switch", "iconid": "4" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "id": 1 } ``` #### Create an image Create a cloud icon. Request: ```json { "jsonrpc": "2.0", "method": "image.create", "params": { "imagetype": 1, "name": "Cloud_(24)", "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5/WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t/ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII=" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188" ] }, "id": 1 } ``` #### 画像の作成 クラウドアイコンを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "image.create", "params": { "imagetype": 1, "name": "Cloud_(24)", "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5/WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t/ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII=" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188" ] }, "id": 1 } ``` #### Create an interface with SNMP details Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "10456", "main": "0", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "1601", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30063" ] }, "id": 1 } ``` #### SNMPの詳細を指定してインターフェースを作成する Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "10456", "main": "0", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "1601", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30063" ] }, "id": 1 } ``` Create another child service of Zabbix cluster with name "Zabbix server node 2". Set the Problem tags as: - Name: component - Operation: Equals - Value: HA node 2 Switch to the *Tags* tab and add a service tag: `Zabbix server:node 2`. Save the new service. "Zabbix server node 2"という名前でZabbix clusterの別の子サービスを作成します。 問題タグを次のように設定します。 - Name: component - Operation: Equals - Value: HA node 2 *Tags*タブに切り替えて、サービスタグ `Zabbix server:node 2`を追加します。 新しいサービスを保存します。 #### Create a passive proxy Create a passive proxy "Passive proxy" and assign two hosts to be monitored by it. Request: ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "host": "Passive proxy", "status": "6", "interface": { "ip": "127.0.0.1", "dns": "", "useip": "1", "port": "10051" }, "hosts": [ { "hostid": "10192" }, { "hostid": "10139" } ] }, "auth": "ab9638041ec6922cb14b07982b268f47", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10284" ] }, "id": 1 } ``` #### パッシブプロキシの作成 パッシブプロキシ"Passive proxy"を作成し、それによって監視される2つのホストを割り当てます。 リクエスト : ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "host": "Passive proxy", "status": "6", "interface": { "ip": "127.0.0.1", "dns": "", "useip": "1", "port": "10051" }, "hosts": [ { "hostid": "10192" }, { "hostid": "10139" } ] }, "auth": "ab9638041ec6922cb14b07982b268f47", "id": 1 } ``` レスポンス : ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10284" ] }, "id": 1 } ``` #### Create a SSH script Create a SSH script with public key authentication that can be executed on a host and has a context menu. Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "SSH script", "command": "my script command", "type": 2, "username": "John", "publickey": "pub.key", "privatekey": "priv.key", "password": "secret", "port": "12345", "scope": 2, "menu_path": "All scripts/SSH", "usrgrpid": "7", "groupid": "4" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "5" ] }, "id": 1 } ``` #### SSHスクリプトを作成する コンテキストメニューを備えた公開鍵認証を使用してホスト上で実行できるSSHスクリプトを作成します Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "SSH script", "command": "my script command", "type": 2, "username": "John", "publickey": "pub.key", "privatekey": "priv.key", "password": "secret", "port": "12345", "scope": 2, "menu_path": "All scripts/SSH", "usrgrpid": "7", "groupid": "4" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "5" ] }, "id": 1 } ``` #### Create a token Create an enabled token that never expires and authenticates user of ID 2. Request: ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "userid": "2" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188" ] }, "id": 1 } ``` Create a disabled token that expires at January 21st, 2021. This token will authenticate current user. Request: ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "status": "1", "expires_at": "1611238072" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "189" ] }, "id": 1 } ``` #### トークンの作成 有効期限が切れることのない有効なトークンを作成し、ID2のユーザーを認証します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "userid": "2" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188" ] }, "id": 1 } ``` 2021年1月21日に有効期限が切れるトークンを作成します。このトークンは現在のユーザーを認証します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "status": "1", "expires_at": "1611238072" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "189" ] }, "id": 1 } ``` #### Create a trigger action Create a trigger action that will begin once a trigger (with the word "memory" in its name) from host "10084" goes into a PROBLEM state. The action will have 4 configured operations. The first and immediate operation will send a message to all users in user group "7" via media type "1". If the event is not resolved in 30 minutes, the second operation will run [script](/manual/web_interface/frontend_sections/administration/scripts#configuring-a-global-script) "5" (script with scope "Action operation") on all hosts in group "2". If the event is resolved, a recovery operation will notify all users who received any messages regarding the problem. If the event is updated, an acknowledge/update operation will notify (with a custom subject and message) all users who received any messages regarding the problem. Request: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "30m", "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 1, "operator": 0, "value": "10084" }, { "conditiontype": 3, "operator": 2, "value": "memory" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } }, { "operationtype": 1, "esc_step_from": 2, "esc_step_to": 2, "opconditions": [ { "conditiontype": 14, "operator": 0, "value": "0" } ], "opcommand_grp": [ { "groupid": "2" } ], "opcommand": { "scriptid": "5" } } ], "recovery_operations": [ { "operationtype": "11", "opmessage": { "default_msg": 1 } } ], "update_operations": [ { "operationtype": "12", "opmessage": { "default_msg": 0, "message": "Custom update operation message body", "subject": "Custom update operation message subject" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### トリガーアクションの作成 ホスト"10084"からのトリガー(名前に"memory"が含まれる)が障害状態になると実行されるトリガーアクションを作成する。 アクションには4つの操作が構成されます。 最初の即時操作では、メディアタイプ"1"を介してユーザーグループ"7"内のすべてのユーザーにメッセージが送信されます。 イベントが30分以内に解決されない場合、2番目の操作ではグループ"2"のすべてのホストで[スクリプト](/manual/web_interface/frontend_sections/administration/scripts#configuring-a-global-script)"5"(スコープ"アクション操作"のスクリプト) が実行されます。 イベントが解決された場合は、回復操作により、問題に関するメッセージを受け取ったすべてのユーザーに通知されます。 イベントが更新されると、確認/更新操作により、問題に関するメッセージを受信したすべてのユーザーに (カスタムの件名とメッセージを使用して) 通知します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "30m", "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 1, "operator": 0, "value": "10084" }, { "conditiontype": 3, "operator": 2, "value": "memory" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } }, { "operationtype": 1, "esc_step_from": 2, "esc_step_to": 2, "opconditions": [ { "conditiontype": 14, "operator": 0, "value": "0" } ], "opcommand_grp": [ { "groupid": "2" } ], "opcommand": { "scriptid": "5" } } ], "recovery_operations": [ { "operationtype": "11", "opmessage": { "default_msg": 1 } } ], "update_operations": [ { "operationtype": "12", "opmessage": { "default_msg": 0, "message": "Custom update operation message body", "subject": "Custom update operation message subject" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### Create a trigger map Create a map with trigger element, which contains two triggers. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Trigger map", "width": 600, "height": 600, "selements": [ { "elements": [ {"triggerid": "12345"}, {"triggerid": "67890"} ], "elementtype": 2, "iconid_off": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` #### トリガーマップを作成する 2つのトリガーを含むトリガー要素を使用してマップを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Trigger map", "width": 600, "height": 600, "selements": [ { "elements": [ {"triggerid": "12345"}, {"triggerid": "67890"} ], "elementtype": 2, "iconid_off": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` #### Create a webhook script Create a webhook script that sends HTTP request to external service. Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Webhook script", "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.Log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.Log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}", "type": 5, "timeout": "40s", "parameters": [ { "name": "token", "value": "{$WEBHOOK.TOKEN}" }, { "name": "host", "value": "{HOST.HOST}" }, { "name": "v", "value": "2.2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3" ] }, "id": 1 } ``` #### Webhookスクリプトを作成する HTTPリクエストを外部サービスに送信するWebhookスクリプトを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Webhook script", "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.Log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.Log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}", "type": 5, "timeout": "40s", "parameters": [ { "name": "token", "value": "{$WEBHOOK.TOKEN}" }, { "name": "host", "value": "{HOST.HOST}" }, { "name": "v", "value": "2.2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3" ] }, "id": 1 } ``` #### Create HTTP agent item Create POST request method item with JSON response preprocessing. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "url": "http://127.0.0.1/http.php", "query_fields": [ { "mode": "json" }, { "min": "10" }, { "max": "100" } ], "interfaceid": "1", "type": 19, "hostid": "10254", "delay": "5s", "key_": "json", "name": "HTTP agent example JSON", "value_type": 0, "output_format": 1, "preprocessing": [ { "type": 12, "params": "$.random", "error_handler": 0, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### HTTP エージェントアイテムの作成 JSONレスポンスの事前処理で POST リクエスト メソッド アイテムを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "url": "http://127.0.0.1/http.php", "query_fields": [ { "mode": "json" }, { "min": "10" }, { "max": "100" } ], "interfaceid": "1", "type": 19, "hostid": "10254", "delay": "5s", "key_": "json", "name": "HTTP agent example JSON", "value_type": 0, "output_format": 1, "preprocessing": [ { "type": 12, "params": "$.random", "error_handler": 0, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Create HTTP agent item prototype Create item prototype with URL using user macro, query fields and custom headers. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "type": "19", "hostid": "10254", "ruleid": "28256", "interfaceid": "2", "name": "api item prototype example", "key_": "api_http_item", "value_type": 3, "url": "{$URL_PROTOTYPE}", "query_fields": [ { "min": "10" }, { "max": "100" } ], "headers": { "X-Source": "api" }, "delay": "35" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28305" ] }, "id": 1 } ``` #### HTTP エージェント アイテムのプロトタイプを作成する ユーザーマクロ、クエリフィールド、およびカスタムヘッダーを使用してURLでアイテムプロトタイプを作成します Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "type": "19", "hostid": "10254", "ruleid": "28256", "interfaceid": "2", "name": "api item prototype example", "key_": "api_http_item", "value_type": 3, "url": "{$URL_PROTOTYPE}", "query_fields": [ { "min": "10" }, { "max": "100" } ], "headers": { "X-Source": "api" }, "delay": "35" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28305" ] }, "id": 1 } ``` #### Create script item Create a simple data collection using a script item. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Script example", "key_": "custom.script.item", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### スクリプトアイテムの作成 スクリプトアイテムを使用して簡単なデータコレクションを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Script example", "key_": "custom.script.item", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Create script item prototype Create a simple data collection using a script item prototype. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Script example", "key_": "custom.script.itemprototype", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### スクリプト アイテムのプロトタイプを作成する スクリプト アイテムのプロトタイプを使用して、単純なデータ コレクションを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Script example", "key_": "custom.script.itemprototype", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Creating a dashboard Create a dashboard named "My dashboard" with one Problems widget with tags and using two types of sharing (user group and user) on a single dashboard page. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problems", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.tag.0", "value": "service" }, { "type": 0, "name": "tags.operator.0", "value": 1 }, { "type": 1, "name": "tags.value.0", "value": "zabbix_server" } ] } ] } ], "userGroups": [ { "usrgrpid": "7", "permission": 2 } ], "users": [ { "userid": "4", "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### ダッシュボードの作成 単一のダッシュボードページで、タグ付きの障害ウィジェットと2種類の共有(ユーザーグループとユーザー)を持つ、"My dashboard"という名前のダッシュボードを作成します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problems", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.tag.0", "value": "service" }, { "type": 0, "name": "tags.operator.0", "value": 1 }, { "type": 1, "name": "tags.value.0", "value": "zabbix_server" } ] } ] } ], "userGroups": [ { "usrgrpid": "7", "permission": 2 } ], "users": [ { "userid": "4", "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### Creating a dashboard It is possible to create a new dashboard in two ways: - Click on *Create dashboard*, when viewing all dashboards - Select *Create new* from the action menu, when viewing a single dashboard You will be first asked to enter general dashboard parameters:  |Parameter|Description| |--|--------| |*Owner*|Select system user that will be the dashboard owner.| |*Name*|Enter dashboard name.| |*Default page display period*|Select period for how long a dashboard page is displayed before rotating to the next page in a [slideshow](#creating_a_slideshow).| |*Start slideshow automatically*|Mark this checkbox to run a slideshow automatically one more than one dashboard page exists.| When you click on *Apply*, an empty dashboard is opened: {width="600"} To populate the dashboard, you can add widgets and pages. Click on the *Save changes* button to save the dashboard. If you click on *Cancel*, the dashboard will not be created. #### ダッシュボードの作成 新しいダッシュボードは、次の2つの方法で作成できます。 - すべてのダッシュボードを表示して*ダッシュボードの作成*をクリックします - 単一のダッシュボードを表示しているときに、アクションメニューから*新規作成*を選択します 最初に、一般的なダッシュボードパラメータを入力するように求められます。  |パラメーター|詳細| |---------|-----------| |*所有者*|ダッシュボードの所有者となるシステムユーザーを選択します。| |*名前*|ダッシュボード名を入力します。| |*デフォルトのページ表示間隔*|[スライドショー](#creating_a_slideshow)でダッシュボードページが表示される期間を選択します| |*スライドショーの自動開始*|スライドショーを自動的に実行するにはこのチェックボックスをオンにします。複数のダッシュボードページが存在します。| *適用*をクリックすると、空のダッシュボードが開きます。 {width="600"} ダッシュボードでデータを表示するために、ウィジェットとページを追加できます。 [変更を保存]ボタンをクリックしてダッシュボードを保存します。 [キャンセル]をクリックするとダッシュボードは作成されません。 #### Creating a global macro Create a global macro "{$SNMP\_COMMUNITY}" with value "public". Request: ```json { "jsonrpc": "2.0", "method": "usermacro.createglobal", "params": { "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "6" ] }, "id": 1 } ``` #### グローバルマクロの作成 値が"public"のグローバルマクロ"{$SNMP\_COMMUNITY}"を作成します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "usermacro.createglobal", "params": { "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "6" ] }, "id": 1 } ``` #### Creating a graph Create a graph with two items. Request: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### グラフの作成 2つのアイテムからなるグラフを作成します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Creating a graph prototype Create a graph prototype with two items. Request: ``` {.java} { "jsonrpc": "2.0", "method": "graphprototype.create", "params": { "name": "Disk space usage {#FSNAME}", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### graph prototype の作成 2つの項目からなる graph prototype を作成する。 Request: ``` {.java} { "jsonrpc": "2.0", "method": "graphprototype.create", "params": { "name": "Disk space usage {#FSNAME}", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Creating a host Create a host called "Linux server" with an IP interface and tags, add it to a group, link a template to it and set the MAC addresses in the host inventory. Request: ``` {.java} { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Linux server", "interfaces": [ { "type": 1, "main": 1, "useip": 1, "ip": "192.168.3.1", "dns": "", "port": "10050" } ], "groups": [ { "groupid": "50" } ], "tags": [ { "tag": "Host name", "value": "Linux server" } ], "templates": [ { "templateid": "20045" } ], "macros": [ { "macro": "{$USER_ID}", "value": "123321" }, { "macro": "{$USER_LOCATION}", "value": "0:0:0", "description": "latitude, longitude and altitude coordinates" } ], "inventory_mode": 0, "inventory": { "macaddress_a": "01234", "macaddress_b": "56768" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "hostids": [ "107819" ] }, "id": 1 } ``` #### ホストの作成 IPインターフェースとタグを持つ "Linux server" というホストを作成し、グループに追加し、テンプレートをリンクし、<br> ホストインベントリにMACアドレスを設定します. Request: ``` {.java} { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Linux server", "interfaces": [ { "type": 1, "main": 1, "useip": 1, "ip": "192.168.3.1", "dns": "", "port": "10050" } ], "groups": [ { "groupid": "50" } ], "tags": [ { "tag": "Host name", "value": "Linux server" } ], "templates": [ { "templateid": "20045" } ], "macros": [ { "macro": "{$USER_ID}", "value": "123321" }, { "macro": "{$USER_LOCATION}", "value": "0:0:0", "description": "latitude, longitude and altitude coordinates" } ], "inventory_mode": 0, "inventory": { "macaddress_a": "01234", "macaddress_b": "56768" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "hostids": [ "107819" ] }, "id": 1 } ``` #### Creating a host group Create a host group called "Linux servers". Request: ``` {.java} { "jsonrpc": "2.0", "method": "hostgroup.create", "params": { "name": "Linux servers" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "groupids": [ "107819" ] }, "id": 1 } ``` #### host group の作成 "Linux servers" という host group を作成します。 Request: ``` {.java} { "jsonrpc": "2.0", "method": "hostgroup.create", "params": { "name": "Linux servers" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "groupids": [ "107819" ] }, "id": 1 } ``` #### Creating a host group ::: noteimportant Only Super Admin users can create host groups. ::: To create a host group in Zabbix frontend, do the following: - Go to: *Configuration → Host groups* - Click on *Create Group* in the upper right corner of the screen - Enter parameters of the group in the form  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |---------|-----------| |*Group name*|Enter a unique host group name.<br>To create a nested host group, use the '/' forward slash separator, for example `Europe/Latvia/Riga/Zabbix servers`. You can create this group even if none of the three parent host groups (`Europe/Latvia/Riga`) exist. In this case creating these parent host groups is up to the user; they will not be created automatically.<br>Leading and trailing slashes, several slashes in a row are not allowed. Escaping of '/' is not supported.<br>Nested representation of host groups is supported since Zabbix 3.2.0.| |*Apply permissions and tag filters to all subgroups*|Checkbox is available to Super Admin users only and only when editing an existing host group.<br>Mark this checkbox and click on *Update* to apply the same level of permissions/tag filters to all nested host groups. For user groups that may have had differing [permissions](/manual/config/users_and_usergroups/usergroup#configuration) assigned to nested host groups, the permission level of the parent host group will be enforced on the nested groups.<br>This is a one-time option that is not saved in the database.<br>This option is supported since Zabbix 3.4.0.| **Permissions to nested host groups** - When creating a child host group to an existing parent host group, [user group](/manual/config/users_and_usergroups/usergroup) permissions to the child are inherited from the parent (for example, when creating `Riga/Zabbix servers` if `Riga` already exists) - When creating a parent host group to an existing child host group, no permissions to the parent are set (for example, when creating `Riga` if `Riga/Zabbix servers` already exists) #### ホストグループの作成 ::: noteimportant 特権管理者だけが、ホストグループを作成可能です。 ::: ZabbixのWebインターフェースでホストグループを作成する場合は、以下の手順で行います： - *設定 → ホストグループ* へ遷移します - 画面右上隅の *ホストグループの作成* をクリックします。 - ホストグループのパラメータをフォームに入力する  必須入力項目には、赤いアスタリスクが表示されています。 |パラメーター|説明| |---------|-----------| |*グループ名*|固有のホストグループ名を入力します。<br>階層的なホストグループを作成するには、`Europe/Latvia/Riga/Zabbix servers`のようにスラッシュ区切り記号「/」を使用します。<br>3つの親ホストグループ(Europe/Latvia/Riga)が存在しない場合でも、このグループを作成することができます。<br>この場合、これらの親ホストグループの作成はユーザが行うことができ、自動的に作成されることはありません。<br>スラッシュの先頭と末尾、および複数のスラッシュの連続は許可されません。また、'/' のエスケープにも対応していません。<br>ホストグループの階層表現現は、Zabbix 3.2.0 以降でサポートされています。| |*すべてのサブグループに権限とタグフィルターを適用*|このチェックボックスは、特権管理者のみが利用でき、既存のホストグループを編集するときのみ利用できます。<br>このチェックボックスをマークして*更新*をクリックすると、同じレベルの権限/タグフィルターがすべての階層化されたホストグループに適用されます。階層化されたホストグループに異なる[権限](/manual/config/users_and_usergroups/usergroup#設定)が割り当てられたユーザーグループについては、親ホストグループのアクセス権レベルが階層化されたグループに対して適用されます。<br>これは1回限りのオプションで、データベースには保存されません。<br>このオプションはZabbix 3.4.0からサポートされています。| **階層化されたホストグループへの権限** - 既存の親ホストグループに対して子ホストグループを作成する場合 <br> [ユーザーグループ](/manual/config/users_and_usergroups/usergroup)のパーミッションは親から継承されます <br> (例 : `Riga` が既に存在する場合、`Riga/Zabbix servers` を作成する場合) <br> - 既存の子ホストグループに対して親ホストグループを作成する場合 <br> 親に対するパーミッションは設定されません <br> (例 : `Riga/Zabbix servers` が既に存在する場合に `Riga` を作成する場合など) <br> #### Creating a host inventory item Create a Zabbix agent item to populate the host's "OS" inventory field. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "uname", "key_": "system.uname", "hostid": "30021", "type": 0, "interfaceid": "30007", "value_type": 1, "delay": "10s", "inventory_link": 5 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 1 } ``` #### ホスト インベントリ アイテムの作成 ホストの"OS"インベントリフィールドに入力する Zabbix エージェント アイテムを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "uname", "key_": "system.uname", "hostid": "30021", "type": 0, "interfaceid": "30007", "value_type": 1, "delay": "10s", "inventory_link": 5 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 1 } ``` #### Creating a host macro Create a host macro "{$SNMP\_COMMUNITY}" with the value "public" on host "10198". Request: ```json { "jsonrpc": "2.0", "method": "usermacro.create", "params": { "hostid": "10198", "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "11" ] }, "id": 1 } ``` #### ホストマクロの作成 ホスト"10198"で値"public"を持つホストマクロ"{$SNMP\_COMMUNITY}"を作成します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "usermacro.create", "params": { "hostid": "10198", "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "11" ] }, "id": 1 } ``` #### Creating a host prototype Create a host prototype "{\#VM.NAME}" on LLD rule "23542" with a group prototype "{\#HV.NAME}", tag pair "Datacenter": "{\#DATACENTER.NAME}" and custom SNMPv2 interface 127.0.0.1:161 with community {$SNMP\_COMMUNITY}. Link it to host group "2". Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.create", "params": { "host": "{#VM.NAME}", "ruleid": "23542", "custom_interfaces": "1", "groupLinks": [ { "groupid": "2" } ], "groupPrototypes": [ { "name": "{#HV.NAME}" } ], "tags": [ { "tag": "Datacenter", "value": "{#DATACENTER.NAME}" } ], "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103" ] }, "id": 1 } ``` #### ホストプロトタイプの作成 グループプロトタイプ"{\#HV.NAME}"、タグペア"Datacenter": "{\#DATACENTER.NAME}"およびコミュニティ{$SNMP\_COMMUNITY}を使用したカスタムSNMPv2インターフェイス127.0.0.1:161を使用して、LLDルール"23542"にホストプロトタイプ"{\#VM.NAME}"を作成し、ホストグループ「2」にリンクします。 Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.create", "params": { "host": "{#VM.NAME}", "ruleid": "23542", "custom_interfaces": "1", "groupLinks": [ { "groupid": "2" } ], "groupPrototypes": [ { "name": "{#HV.NAME}" } ], "tags": [ { "tag": "Datacenter", "value": "{#DATACENTER.NAME}" } ], "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103" ] }, "id": 1 } ``` #### Creating a host with PSK encryption Create a host called "PSK host" with PSK encryption configured. Note that the host has to be [pre-configured to use PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example). Request: ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "PSK host", "interfaces": [ { "type": 1, "ip": "192.168.3.1", "dns": "", "port": "10050", "useip": 1, "main": 1 } ], "groups": [ { "groupid": "2" } ], "tls_accept": 2, "tls_connect": 2, "tls_psk_identity": "PSK 001", "tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10590" ] }, "id": 1 } ``` #### PSK 暗号化を使用したホストの作成 PSK 暗号化が設定された "PSK ホスト"というホストを作成します。 ホストは [PSK を使用するように事前設定](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example) されている必要があります。 Request: ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "PSK host", "interfaces": [ { "type": 1, "ip": "192.168.3.1", "dns": "", "port": "10050", "useip": 1, "main": 1 } ], "groups": [ { "groupid": "2" } ], "tls_accept": 2, "tls_connect": 2, "tls_psk_identity": "PSK 001", "tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10590" ] }, "id": 1 } ``` #### Creating a host with SNMP interface Create a host called "SNMP host" with an SNMPv3 interface with details. Request: ``` {.java} { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "SNMP host", "interfaces": [ { "type": 2, "main": 1, "useip": 1, "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": 3, "bulk": 0, "securityname": "mysecurityname", "contextname": "", "securitylevel": 1 } } ], "groups": [ { "groupid": "4" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "hostids": [ "10658" ] }, "id": 1 } ``` #### SNMPインターフェイスを持つホストの作成 SNMPv3 インタフェースを持つホスト "SNMP host" を詳細とともに作成します。 Request: ``` {.java} { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "SNMP host", "interfaces": [ { "type": 2, "main": 1, "useip": 1, "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": 3, "bulk": 0, "securityname": "mysecurityname", "contextname": "", "securitylevel": 1 } } ], "groups": [ { "groupid": "4" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "hostids": [ "10658" ] }, "id": 1 } ``` #### Creating a maintenance Create a maintenance with data collection for host group "2" with problem tags **<service:mysqld>** and **error**. It must be active from 22.01.2013 till 22.01.2014, come in effect each Sunday at 18:00 and last for one hour. Request: ``` {.java} { "jsonrpc": "2.0", "method": "maintenance.create", "params": { "name": "Sunday maintenance", "active_since": 1358844540, "active_till": 1390466940, "tags_evaltype": 0, "groupids": [ "2" ], "timeperiods": [ { "timeperiod_type": 3, "every": 1, "dayofweek": 64, "start_time": 64800, "period": 3600 } ], "tags": [ { "tag": "service", "operator": "0", "value": "mysqld" }, { "tag": "error", "operator": "2", "value": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### Creating a maintenance Create a maintenance with data collection for host group "2" with problem tags **<service:mysqld>** and **error**. It must be active from 22.01.2013 till 22.01.2014, come in effect each Sunday at 18:00 and last for one hour. Request: ``` {.java} { "jsonrpc": "2.0", "method": "maintenance.create", "params": { "name": "Sunday maintenance", "active_since": 1358844540, "active_till": 1390466940, "tags_evaltype": 0, "groupids": [ "2" ], "timeperiods": [ { "timeperiod_type": 3, "every": 1, "dayofweek": 64, "start_time": 64800, "period": 3600 } ], "tags": [ { "tag": "service", "operator": "0", "value": "mysqld" }, { "tag": "error", "operator": "2", "value": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### Creating a maintenance Create a maintenance with data collection for host group with ID "2" and with problem tags **service:mysqld** and **error**. It must be active from 22.01.2013 till 22.01.2014, come in effect each Sunday at 18:00 and last for one hour. Request: ```json { "jsonrpc": "2.0", "method": "maintenance.create", "params": { "name": "Sunday maintenance", "active_since": 1358844540, "active_till": 1390466940, "tags_evaltype": 0, "groups": [ {"groupid": "2"} ], "timeperiods": [ { "period": 3600, "timeperiod_type": 3, "start_time": 64800, "every": 1, "dayofweek": 64 } ], "tags": [ { "tag": "service", "operator": "0", "value": "mysqld" }, { "tag": "error", "operator": "2", "value": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### メンテナンスの作成 ID"2"のホストグループのデータ収集と、障害タグ**service:mysqld**および**error**を使用してメンテナンスを作成します。 2013年1月22日から2014年1月22日までアクティブで、毎週日曜日の18:00に有効になり1時間持続します。 Request: ```json { "jsonrpc": "2.0", "method": "maintenance.create", "params": { "name": "Sunday maintenance", "active_since": 1358844540, "active_till": 1390466940, "tags_evaltype": 0, "groups": [ {"groupid": "2"} ], "timeperiods": [ { "period": 3600, "timeperiod_type": 3, "start_time": 64800, "every": 1, "dayofweek": 64 } ], "tags": [ { "tag": "service", "operator": "0", "value": "mysqld" }, { "tag": "error", "operator": "2", "value": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### Creating an e-mail media type Create a new e-mail media type with a custom SMTP port and message templates. Request: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "0", "name": "E-mail", "smtp_server": "mail.example.com", "smtp_helo": "example.com", "smtp_email": "zabbix@example.com", "smtp_port": "587", "content_type": "1", "message_templates": [ { "eventsource": "0", "recovery": "0", "subject": "Problem: {EVENT.NAME}", "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" started at {EVENT.TIME}." }, { "eventsource": "0", "recovery": "1", "subject": "Resolved in {EVENT.DURATION}: {EVENT.NAME}", "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE}." }, { "eventsource": "0", "recovery": "2", "subject": "Updated problem in {EVENT.AGE}: {EVENT.NAME}", "message": "{USER.FULLNAME} {EVENT.UPDATE.ACTION} problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}." } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "7" ] }, "id": 1 } ``` #### 電子メールメディアタイプの作成 カスタムSMTPポートとメッセージテンプレートを使用して、新しい電子メールメディアタイプを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "0", "name": "E-mail", "smtp_server": "mail.example.com", "smtp_helo": "example.com", "smtp_email": "zabbix@example.com", "smtp_port": "587", "content_type": "1", "message_templates": [ { "eventsource": "0", "recovery": "0", "subject": "Problem: {EVENT.NAME}", "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" started at {EVENT.TIME}." }, { "eventsource": "0", "recovery": "1", "subject": "Resolved in {EVENT.DURATION}: {EVENT.NAME}", "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE}." }, { "eventsource": "0", "recovery": "2", "subject": "Updated problem in {EVENT.AGE}: {EVENT.NAME}", "message": "{USER.FULLNAME} {EVENT.UPDATE.ACTION} problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}." } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "7" ] }, "id": 1 } ``` #### Creating a new global regular expression. Request: ```json { "jsonrpc": "2.0", "method": "regexp.create", "params": { "name": "Storage devices for SNMP discovery", "test_string": "/boot", "expressions": [ { "expression": "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$", "expression_type": "4", "case_sensitive": "1" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16" ] }, "id": 1 } ``` #### 新しいグローバル正規表現の作成 Request: ```json { "jsonrpc": "2.0", "method": "regexp.create", "params": { "name": "Storage devices for SNMP discovery", "test_string": "/boot", "expressions": [ { "expression": "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$", "expression_type": "4", "case_sensitive": "1" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16" ] }, "id": 1 } ``` #### Creating a new item Let's create a new [item](/manual/api/reference/item/object) on "Zabbix server" using the data we've obtained from the previous `host.get` request. This can be done by using the [item.create](/manual/api/reference/item/create) method: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Free disk space on /home/joe/", "key_": "vfs.fs.size[/home/joe/,free]", "hostid": "10084", "type": 0, "value_type": 3, "interfaceid": "1", "delay": 30 }, "auth": "0424bd59b807674191e7d77572075f33", "id": 3 } ``` A successful response will contain the ID of the newly created item, which can be used to reference the item in the following requests: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 3 } ``` ::: notetip The `item.create` method as well as other create methods can also accept arrays of objects and create multiple items with one API call. ::: #### 新しいアイテムの作成 先ほどの`host.get`リクエストで取得したデータを使って、"Zabbixサーバー" に新しい[アイテム](/manual/api/reference/item/object)を作成してみましょう。 これは[item.create](/manual/api/reference/item/create)メソッドを使用して実行できます。 ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Free disk space on /home/joe/", "key_": "vfs.fs.size[/home/joe/,free]", "hostid": "10084", "type": 0, "value_type": 3, "interfaceid": "1", "delay": 30 }, "auth": "0424bd59b807674191e7d77572075f33", "id": 3 } ``` 作成が成功した場合のレスポンスには、新しく作成されたアイテムのIDが含まれます。これは、以降のリクエストでアイテムを参照するために使用できます。 ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 3 } ``` ::: notetip なお`item.create`メソッドや他のcreateメソッドも、オブジェクトの配列を受け入れて、1 回のAPI呼び出しで複数のアイテムを作成することもできます。 ::: #### Creating an item Create a numeric Zabbix agent item with 2 item tags to monitor free disk space on host with ID "30074". Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Free disk space on /home/joe/", "key_": "vfs.fs.size[/home/joe/,free]", "hostid": "30074", "type": 0, "value_type": 3, "interfaceid": "30084", "tags": [ { "tag": "Disk usage" }, { "tag": "Equipment", "value": "Workstation" } ], "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24758" ] }, "id": 1 } ``` #### アイテムの作成 ID "30074" のホストの空きディスク容量を監視するために、2 つのアイテム タグを持つ数値の Zabbix エージェント アイテムを作成します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Free disk space on /home/joe/", "key_": "vfs.fs.size[/home/joe/,free]", "hostid": "30074", "type": 0, "value_type": 3, "interfaceid": "30084", "tags": [ { "tag": "Disk usage" }, { "tag": "Equipment", "value": "Workstation" } ], "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24758" ] }, "id": 1 } ``` #### Creating an item prototype with preprocessing Create an item using change per second and a custom multiplier as a second step. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Incoming network traffic on {#IFNAME}", "key_": "net.if.in[{#IFNAME}]", "hostid": "10001", "ruleid": "27665", "type": 0, "value_type": 3, "delay": "60s", "units": "bps", "interfaceid": "1155", "preprocessing": [ { "type": 10, "params": "", "error_handler": 0, "error_handler_params": "" }, { "type": 1, "params": "8", "error_handler": 2, "error_handler_params": "10" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### 事前処理でアイテムプロトタイプを作成する 2 番目のステップとして、1 秒あたりの変化とカスタム倍率を使用してアイテムを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Incoming network traffic on {#IFNAME}", "key_": "net.if.in[{#IFNAME}]", "hostid": "10001", "ruleid": "27665", "type": 0, "value_type": 3, "delay": "60s", "units": "bps", "interfaceid": "1155", "preprocessing": [ { "type": 10, "params": "", "error_handler": 0, "error_handler_params": "" }, { "type": 1, "params": "8", "error_handler": 2, "error_handler_params": "10" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Creating an item with preprocessing Create an item using custom multiplier. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Device uptime", "key_": "sysUpTime", "hostid": "11312", "type": 4, "snmp_oid": "SNMPv2-MIB::sysUpTime.0", "value_type": 1, "delay": "60s", "units": "uptime", "interfaceid": "1156", "preprocessing": [ { "type": 1, "params": "0.01", "error_handler": 1, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44210" ] }, "id": 1 } ``` #### 事前処理を伴うアイテムの作成 乗数を使用してアイテムを作成します Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Device uptime", "key_": "sysUpTime", "hostid": "11312", "type": 4, "snmp_oid": "SNMPv2-MIB::sysUpTime.0", "value_type": 1, "delay": "60s", "units": "uptime", "interfaceid": "1156", "preprocessing": [ { "type": 1, "params": "0.01", "error_handler": 1, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44210" ] }, "id": 1 } ``` #### Creating an LLD rule Create a Zabbix agent LLD rule to discover mounted file systems. Discovered items will be updated every 30 seconds. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "hostid": "10197", "type": 0, "interfaceid": "112", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### LLDルールの作成 ZabbixエージェントLLDルールを作成して、マウントされたファイルシステムを検出します。 発見されたアイテムは30秒ごとに更新されます。 Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "hostid": "10197", "type": 0, "interfaceid": "112", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Creating an SLA Instruct to create an SLA entry for: * tracking uptime for SQL-engine related services; * custom schedule of all weekdays excluding last hour on Saturday; * an effective date of the last day of the year 2022; * with 1 hour and 15 minutes long planned downtime starting at midnight on the 4th of July; * SLA weekly report calculation will be on; * the minimum acceptable SLO will be 99.9995%. #### SLAの作成 次のSLAエントリを作成するように指示します。 * SQLエンジン関連サービスの稼働時間を追跡 * 土曜日の最後の時間を除くすべての平日のカスタムスケジュール * 2022年の最終発効日 * 7月4日の深夜から始まる1時間15分の計画されたダウンタイム * SLAウィークリーレポートの計算をオンに * 最小許容SLOを99.9995％に ##### Creating application 1\. Log into Microsoft Entra admin center at [Microsoft Entra ID](https://entra.microsoft.com). For testing purposes, you may create a free trial account in Microsoft Entra ID. 2\. In Microsoft Entra admin center select *Applications* -> *Enterprise applications* -> *New application* -> *Create your own application*. 3\. Add the name of your app and select the *Integrate any other application...* option. After that, click on *Create*. {width="550"} ##### アプリケーションの作成 1\. [Microsoft Entra ID](https://entra.microsoft.com) で Microsoft Entra 管理センターにログインします。テスト目的で、Microsoft Entra ID で無料トライアルアカウントを作成できます。 2\. Microsoft Entra 管理センターで、*アプリケーション* -> *エンタープライズ アプリケーション* -> *新しいアプリケーション* -> *独自のアプリケーションの作成* を選択します。 3\. アプリの名前を入力し、*他のアプリケーションを統合* オプションを選択します。その後、*作成* をクリックします。 {width="550"} #### Creating a role Create a role with type "User" and denied access to two UI elements. Request: ```json { "jsonrpc": "2.0", "method": "role.create", "params": { "name": "Operator", "type": "1", "rules": { "ui": [ { "name": "monitoring.hosts", "status": "0" }, { "name": "monitoring.maps", "status": "0" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### ロールの作成 タイプが"ユーザー"で、2つのUI要素へのアクセスを拒否するロールを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "role.create", "params": { "name": "Operator", "type": "1", "rules": { "ui": [ { "name": "monitoring.hosts", "status": "0" }, { "name": "monitoring.maps", "status": "0" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### Creating a scheduled report Create a weekly report that will be prepared for the previous week every Monday-Friday at 12:00 from 2021-04-01 to 2021-08-31. Request: ```json { "jsonrpc": "2.0", "method": "report.create", "params": { "userid": "1", "name": "Weekly report", "dashboardid": "1", "period": "1", "cycle": "1", "start_time": "43200", "weekdays": "31", "active_since": "2021-04-01", "active_till": "2021-08-31", "subject": "Weekly report", "message": "Report accompanying text", "status": "1", "description": "Report description", "users": [ { "userid": "1", "access_userid": "1", "exclude": "0" }, { "userid": "2", "access_userid": "0", "exclude": "1" } ], "user_groups": [ { "usrgrpid": "7", "access_userid": "0" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### スケジュールされたレポートの作成 2021-04-01から2021-08-31までの毎週月曜日から金曜日の12:00に前週に準備した週次レポートを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "report.create", "params": { "userid": "1", "name": "Weekly report", "dashboardid": "1", "period": "1", "cycle": "1", "start_time": "43200", "weekdays": "31", "active_since": "2021-04-01", "active_till": "2021-08-31", "subject": "Weekly report", "message": "Report accompanying text", "status": "1", "description": "Report description", "users": [ { "userid": "1", "access_userid": "1", "exclude": "0" }, { "userid": "2", "access_userid": "0", "exclude": "1" } ], "user_groups": [ { "usrgrpid": "7", "access_userid": "0" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### Creating a script media type Create a new script media type with a custom value for the number of attempts and the interval between them. Request: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "1", "name": "Push notifications", "exec_path": "push-notification.sh", "exec_params": "{ALERT.SENDTO}\n{ALERT.SUBJECT}\n{ALERT.MESSAGE}\n", "maxattempts": "5", "attempt_interval": "11s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "8" ] }, "id": 1 } ``` #### スクリプトメディアタイプの作成 試行回数と試行間隔のカスタム値を使用して、新しいスクリプトメディアタイプを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "1", "name": "Push notifications", "exec_path": "push-notification.sh", "exec_params": "{ALERT.SENDTO}\n{ALERT.SUBJECT}\n{ALERT.MESSAGE}\n", "maxattempts": "5", "attempt_interval": "11s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "8" ] }, "id": 1 } ``` #### Creating a service Create a service that will be switched to problem state, if at least one child has a problem. Request: ```json { "jsonrpc": "2.0", "method": "service.create", "params": { "name": "Server 1", "algorithm": 1, "sortorder": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "5" ] }, "id": 1 } ``` #### サービスの作成 少なくとも1つの子で障害があった場合に、障害状態に切り替わるサービスを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "service.create", "params": { "name": "Server 1", "algorithm": 1, "sortorder": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "5" ] }, "id": 1 } ``` #### Creating a slideshow A slideshow will run automatically if the dashboard contains two or more pages (see [Adding pages](#adding_pages)) and if one of the following is true: - The *Start slideshow automatically* option is marked in dashboard properties - The dashboard URL contains a `slideshow=1` parameter The pages rotate according to the intervals given in the properties of the dashboard and individual pages. Click on: - *Stop slideshow* - to stop the slideshow - *Start slideshow* - to start the slideshow  Slideshow-related controls are also available in [kiosk mode](#viewing_and_editing_a_dashboard) (where only the page content is shown): -  - stop slideshow -  - start slideshow -  - go back one page -  - go to the next page #### スライドショーの作成 ダッシュボードに2つ以上のページが含まれている場合、（[ページの追加](#adding_pages)参照）次のいずれかに該当するとスライドショーが自動的に実行されます。 - *スライドショーの自動開始*オプションがダッシュボードのプロパティでチェックされている - ダッシュボードのURLに`slideshow=1`パラメータが含まれている 各ページはダッシュボードと個々のページのプロパティで指定された間隔に従って切り替わります。 以下をクリックで動作を切り替えれます。 - *スライドショーの停止* - スライドショーを停止します - *スライドショーの開始* - スライドショーを開始します  スライドショー関連のコントロールは[kioskモード](#viewing_and_editing_a_dashboard)（ページのコンテンツのみが表示される）でも使用できます。 -  - スライドショーの停止 -  - スライドショーの開始 -  - ひとつ前のページに -  - 次のページに #### Creating a task Create a task `check now` for two items. One is an item, the other is a low-level discovery rule. Request: ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 6, "request": { "itemid": "10092" } }, { "type": "6", "request": { "itemid": "10093" } } ], "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "1", "2" ] }, "id": 1 } ``` Create a task `diagnostic information` task. Request: ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 1, "request": { "alerting": { "stats": [ "alerts" ], "top": { "media.alerts": 10 } }, "lld": { "stats": "extend", "top": { "values": 5 } } }, "proxy_hostid": 0 } ], "auth": "700ca65537074ec963db7efabda78259", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "3" ] }, "id": 2 } ``` #### タスクの作成 2つのアイテムのタスク'即時確認'を作成します。 1つはアイテムで、もう1つはローレベルディスカバリルールです。 Request: ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 6, "request": { "itemid": "10092" } }, { "type": "6", "request": { "itemid": "10093" } } ], "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "1", "2" ] }, "id": 1 } ``` タスク'診断情報'を作成します。 Request: ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 1, "request": { "alerting": { "stats": [ "alerts" ], "top": { "media.alerts": 10 } }, "lld": { "stats": "extend", "top": { "values": 5 } } }, "proxy_hostid": 0 } ], "auth": "700ca65537074ec963db7efabda78259", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "3" ] }, "id": 2 } ``` #### Creating a template Create a template with tags and link two templates to this template. Request: ```json { "jsonrpc": "2.0", "method": "template.create", "params": { "host": "Linux template", "groups": { "groupid": 1 }, "templates": [ { "templateid": "11115" }, { "templateid": "11116" } ], "tags": [ { "tag": "Host name", "value": "{HOST.NAME}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "11117" ] }, "id": 1 } ``` #### テンプレートの作成 タグ付きのテンプレートを作成し、2 つのテンプレートをこのテンプレートにリンクします。 Request: ```json { "jsonrpc": "2.0", "method": "template.create", "params": { "host": "Linux template", "groups": { "groupid": 1 }, "templates": [ { "templateid": "11115" }, { "templateid": "11116" } ], "tags": [ { "tag": "Host name", "value": "{HOST.NAME}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "11117" ] }, "id": 1 } ``` #### Creating a template dashboard Create a template dashboard named “Graphs” with one Graph widget on a single dashboard page. Request: ```json { "jsonrpc": "2.0", "method": "templatedashboard.create", "params": { "templateid": "10318", "name": "Graphs", "pages": [ { "widgets": [ { "type": "graph", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 6, "name": "graphid", "value": "1123" } ] } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "32" ] }, "id": 1 } ``` #### テンプレート ダッシュボードの作成 1 つのダッシュボード ページに 1 つのグラフ ウィジェットを含む“Graphs”という名前のテンプレート ダッシュボードを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "templatedashboard.create", "params": { "templateid": "10318", "name": "Graphs", "pages": [ { "widgets": [ { "type": "graph", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 6, "name": "graphid", "value": "1123" } ] } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "32" ] }, "id": 1 } ``` #### Creating a template To create a template, do the following: - Go to *Configuration → Templates* - Click on *Create template* - Edit template attributes The **Templates** tab contains general template attributes.  All mandatory input fields are marked with a red asterisk. Template attributes: |Parameter|Description| |--|--------| |*Template name*|Unique template name. Alphanumerics, spaces, dots, dashes, and underscores are allowed. However, leading and trailing spaces are disallowed.| |*Visible name*|If you set this name, it will be the one visible in lists, maps, etc.| |*Templates*|Link one or more "nested" templates to this template. All entities (items, triggers, graphs, etc.) will be inherited from the linked templates.<br>To link a new template, start typing the template name in the *Link new templates* field. A list of matching templates will appear; scroll down to select. Alternatively, you may click on *Select* next to the field and select templates from the list in a popup window. The templates that are selected in the *Link new templates* field will be linked to the template when the template configuration form is saved or updated.<br>To unlink a template, use one of the two options in the *Linked templates* block:<br>*Unlink* - unlink the template, but preserve its items, triggers, and graphs<br>*Unlink and clear* - unlink the template and remove all its items, triggers, and graphs| |*Groups*|Host/template groups the template belongs to.| |*Description*|Enter the template description.| The **Tags** tab allows you to define template-level [tags](/manual/config/tagging). All problems of hosts linked to this template will be tagged with the values entered here.  User macros, {INVENTORY.\*} macros, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros are supported in tags. The **Macros** tab allows you to define template-level [user macros](/manual/config/macros/user_macros) as a name-value pairs. Note that macro values can be kept as plain text, secret text, or Vault secret. Adding a description is also supported.  You may also view here macros from linked templates and global macros if you select the *Inherited and template macros* option. That is where all defined user macros for the template are displayed with the value they resolve to as well as their origin.  For convenience, links to respective templates and global macro configuration are provided. It is also possible to edit a nested template/global macro on the template level, effectively creating a copy of the macro on the template. The **Value mapping** tab allows to configure human-friendly representation of item data in [value mappings](/manual/config/items/mapping). Buttons: | | | |--|--------| ||Add the template. The added template should appear in the list.| ||Update the properties of an existing template.| ||Create another template based on the properties of the current template, including the entities (items, triggers, etc) inherited from linked templates.| ||Create another template based on the properties of the current template, including the entities (items, triggers, etc) both inherited from linked templates and directly attached to the current template.| ||Delete the template; entities of the template (items, triggers, etc) remain with the linked hosts.| ||Delete the template and all its entities from linked hosts.| ||Cancel the editing of template properties.| With a template created, it is time to add some entities to it. ::: noteimportant Items have to be added to a template first. Triggers and graphs cannot be added without the corresponding item. ::: #### テンプレートの作成 次の手順でテンプレートを作成します。 - *設定 → テンプレート*に移動 - *テンプレートの作成*をクリック - テンプレートの属性を編集 **テンプレート** タブには、一般的なテンプレートの属性が含まれています。  必須入力フィールドには赤いアスタリスクが付いています。 テンプレート属性: |パラメータ|説明| |--|--------| |*テンプレート名*|一意なテンプレート名。 英数字、スペース、ドット、ダッシュ、アンダースコアを使用可能。 先頭と末尾のスペースは使用不可。| |*表示名*|リストやマップなどでの表示名| |*テンプレート*|1つ以上の"ネストされた"テンプレートをこのテンプレートにリンクします。すべてのエンティティ(アイテム、トリガー、グラフ等)は、リンクされたテンプレートから継承されます。<br>新しいテンプレートをリンクするには*テンプレート*フィールドにテンプレート名を入力し始めると、一致するテンプレートのリストが表示されるのでリストから選択します。 またはフィールドの横にある [選択] をクリックして、ポップアップ ウィンドウのリストからテンプレートを選択することもできます。 [テンプレート]フィールドで選択されたテンプレートは、テンプレート設定フォームが保存または更新されたときにテンプレートにリンクされます。<br>テンプレートのリンクを解除するには、*リンクされたテンプレート* ブロックの 2 つのオプションのいずれかを使用します。<br>*リンクを削除* - テンプレートのリンクを解除しますが、そのアイテム、トリガー、グラフは保持します<br>*リンクと保存データを削除* - リンクを解除します テンプレートを作成し、そのアイテム、トリガー、およびグラフをすべて削除します| |*グループ*|テンプレートが属するホスト/テンプレートグループ| |*説明*|テンプレートの説明| **タグ** タブでは、テンプレートレベルの [タグ](/manual/config/tagging) を定義できます。このテンプレートにリンクされたホストのすべての障害は、ここに入力された値でタグ付けされます。  ユーザー マクロ、{INVENTORY.\*} マクロ、{HOST.HOST}、{HOST.NAME}、{HOST.CONN}、{HOST.DNS}、{HOST.IP}、{HOST.PORT} および {HOST. ID} マクロはタグでサポートされています。 **Macros** タブでは、テンプレート レベルの [ユーザー マクロ](/manual/config/macros/user_macros) を名前と値のペアとして定義できます。 マクロ値は、プレーン テキスト、シークレット テキスト、または Vault シークレットとして保持できます。 説明の追加もサポートされています。  *継承されたマクロとテンプレート マクロ*オプションを選択すると、リンクされたテンプレートのマクロとグローバルマクロが表示されます。 ここには、テンプレートに対して定義されたすべてのユーザー マクロが、それらが解決する値と元の値とともに表示されます。  便宜上、それぞれのテンプレートとグローバルマクロ設定へのリンクが提供されていますが、テンプレートレベルでネストされたテンプレート/グローバル マクロを編集して、テンプレート上にマクロのコピーを作成することもできます。 **値のマッピング** タブでは、[値のマッピング]/manual/config/items/mapping)でアイテム データのわかりやすい表現を設定できます。 ボタン: | | | |--|--------| ||テンプレートを追加します。追加されたテンプレートがリストに表示されます。| ||既存のテンプレートのプロパティを更新します| ||リンクされたテンプレートから継承されたエンティティ (アイテム、トリガーな祖) を含む、現在のテンプレートのプロパティに基づいて別のテンプレートを作成します。| ||リンクされたテンプレートから継承され、現在のテンプレートに直接添付されたエンティティ (アイテム、トリガー等) を含む、現在のテンプレートのプロパティに基づいて別のテンプレートを作成します。| ||テンプレートを削除します。 テンプレートのエンティティ (アイテム、トリガー等) は、リンクされたホストに残ります。| ||リンクされたホストからテンプレートとそのすべてのエンティティを削除します。| ||テンプレート プロパティの編集をキャンセルします。| テンプレートを作成したら、それにいくつかのエンティティを追加します。 ::: noteimportant 最初にアイテムをテンプレートに追加する必要があります。 トリガーとグラフは、対応するアイテムがないと追加できません。 ::: #### Creating a trigger Create a trigger with a single trigger dependency. Request: ```json { "jsonrpc": "2.0", "method": "trigger.create", "params": [ { "description": "Processor load is too high on {HOST.NAME}", "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5", "dependencies": [ { "triggerid": "17367" } ] }, { "description": "Service status", "expression": "length(last(/Linux server/log[/var/log/system,Service .* has stopped]))<>0", "dependencies": [ { "triggerid": "17368" } ], "tags": [ { "tag": "service", "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}" }, { "tag": "error", "value": "" } ] } ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 1 } ``` #### トリガーの作成 単一のトリガー依存関係を持つトリガーを作成します Request: ```json { "jsonrpc": "2.0", "method": "trigger.create", "params": [ { "description": "Processor load is too high on {HOST.NAME}", "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5", "dependencies": [ { "triggerid": "17367" } ] }, { "description": "Service status", "expression": "length(last(/Linux server/log[/var/log/system,Service .* has stopped]))<>0", "dependencies": [ { "triggerid": "17368" } ], "tags": [ { "tag": "service", "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}" }, { "tag": "error", "value": "" } ] } ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 1 } ``` #### Creating a trigger prototype Create a trigger prototype to detect when a file system has less than 20% free disk space. Request: ```json { "jsonrpc": "2.0", "method": "triggerprototype.create", "params": { "description": "Free disk space is less than 20% on volume {#FSNAME}", "expression": "last(/Zabbix server/vfs.fs.size[{#FSNAME},pfree])<20", "tags": [ { "tag": "volume", "value": "{#FSNAME}" }, { "tag": "type", "value": "{#FSTYPE}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17372" ] }, "id": 1 } ``` #### トリガー プロトタイプの作成 ファイル システムの空きディスク容量が 20% 未満になったことを検出するトリガー プロトタイプを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "triggerprototype.create", "params": { "description": "Free disk space is less than 20% on volume {#FSNAME}", "expression": "last(/Zabbix server/vfs.fs.size[{#FSNAME},pfree])<20", "tags": [ { "tag": "volume", "value": "{#FSNAME}" }, { "tag": "type", "value": "{#FSTYPE}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17372" ] }, "id": 1 } ``` #### Creating a user Create a new user, add him to a user group and create a new media for him. Request: ```json { "jsonrpc": "2.0", "method": "user.create", "params": { "username": "John", "passwd": "Doe123", "roleid": "5", "usrgrps": [ { "usrgrpid": "7" } ], "medias": [ { "mediatypeid": "1", "sendto": [ "support@company.com" ], "active": 0, "severity": 63, "period": "1-7,00:00-24:00" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` #### ユーザー作成 新しいユーザーを作成し、ユーザーグループに追加して、新しいメディアを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "user.create", "params": { "username": "John", "passwd": "Doe123", "roleid": "5", "usrgrps": [ { "usrgrpid": "7" } ], "medias": [ { "mediatypeid": "1", "sendto": [ "support@company.com" ], "active": 0, "severity": 63, "period": "1-7,00:00-24:00" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` #### Creating a user group Create a user group, which denies access to host group "2", and add a user to it. Request: ```json { "jsonrpc": "2.0", "method": "usergroup.create", "params": { "name": "Operation managers", "rights": { "permission": 0, "id": "2" }, "users": [ {"userid": "12"} ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20" ] }, "id": 1 } ``` #### ユーザーグループの作成 ホストグループ"2"へアクセスできないユーザーグループを作成し、それにユーザーを追加します。 Request: ```json { "jsonrpc": "2.0", "method": "usergroup.create", "params": { "name": "Operation managers", "rights": { "permission": 0, "id": "2" }, "users": [ {"userid": "12"} ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20" ] }, "id": 1 } ``` #### Creating a value map Create one value map with two mappings. Request: ```json { "jsonrpc": "2.0", "method": "valuemap.create", "params": { "hostid": "50009", "name": "Service state", "mappings": [ { "type": "1", "value": "1", "newvalue": "Up" }, { "type": "5", "newvalue": "Down" } ] }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1" ] }, "id": 1 } ``` #### バリューマップの作成 2つのマッピングを使用して1つのバリューマップを作成します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "valuemap.create", "params": { "hostid": "50009", "name": "Service state", "mappings": [ { "type": "1", "value": "1", "newvalue": "Up" }, { "type": "5", "newvalue": "Down" } ] }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1" ] }, "id": 1 } ``` #### Creating a webhook media type Create a new webhook media type. Request: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "4", "name": "Webhook", "script": "var Webhook = {\r\n token: null,\r\n to: null,\r\n subject: null,\r\n message: null,\r\n\r\n sendMessage: function() {\r\n // some logic\r\n }\r\n}", "parameters": [ { "name": "Message", "value": "{ALERT.MESSAGE}" }, { "name": "Subject", "value": "{ALERT.SUBJECT}" }, { "name": "To", "value": "{ALERT.SENDTO}" }, { "name": "Token", "value": "<Token>" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "9" ] }, "id": 1 } ``` #### webhookメディアタイプの作成 新しいwebhookメディアタイプを作成します Request: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "4", "name": "Webhook", "script": "var Webhook = {\r\n token: null,\r\n to: null,\r\n subject: null,\r\n message: null,\r\n\r\n sendMessage: function() {\r\n // some logic\r\n }\r\n}", "parameters": [ { "name": "Message", "value": "{ALERT.MESSAGE}" }, { "name": "Subject", "value": "{ALERT.SUBJECT}" }, { "name": "To", "value": "{ALERT.SENDTO}" }, { "name": "Token", "value": "<Token>" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "9" ] }, "id": 1 } ``` #### Creating a web scenario Create a web scenario to monitor the company home page. The scenario will have two steps, to check the home page and the "About" page and make sure they return the HTTP status code 200. Request: ```json { "jsonrpc": "2.0", "method": "httptest.create", "params": { "name": "Homepage check", "hostid": "10085", "steps": [ { "name": "Homepage", "url": "http://example.com", "status_codes": "200", "no": 1 }, { "name": "Homepage / About", "url": "http://example.com/about", "status_codes": "200", "no": 2 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Webシナリオの作成 ホームページを監視するためのWebシナリオを作成します。 シナリオには、ホームページと「バージョン情報」ページをチェックしてHTTPステータスコード200が返されることを確認する2つのステップがあります。 Request: ```json { "jsonrpc": "2.0", "method": "httptest.create", "params": { "name": "Homepage check", "hostid": "10085", "steps": [ { "name": "Homepage", "url": "http://example.com", "status_codes": "200", "no": 1 }, { "name": "Homepage / About", "url": "http://example.com/about", "status_codes": "200", "no": 2 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` ### Creating custom LLD rules It is also possible to create a completely custom LLD rule, discovering any type of entities - for example, databases on a database server. To do so, a custom item should be created that returns JSON, specifying found objects and optionally - some properties of them. The amount of macros per entity is not limited - while the built-in discovery rules return either one or two macros (for example, two for filesystem discovery), it is possible to return more. The required JSON format is best illustrated with an example. Suppose we are running an old Zabbix 1.8 agent (one that does not support "vfs.fs.discovery"), but we still need to discover file systems. Here is a simple Perl script for Linux that discovers mounted file systems and outputs JSON, which includes both file system name and type. One way to use it would be as a UserParameter with key "vfs.fs.discovery\_perl": ``` {.perl} #!/usr/bin/perl $first = 1; print "[\n"; for (`cat /proc/mounts`) { ($fsname, $fstype) = m/\S+ (\S+) (\S+)/; print "\t,\n" if not $first; $first = 0; print "\t{\n"; print "\t\t\"{#FSNAME}\":\"$fsname\",\n"; print "\t\t\"{#FSTYPE}\":\"$fstype\"\n"; print "\t}\n"; } print "]\n"; ``` ::: noteimportant Allowed symbols for LLD macro names are **0-9** , **A-Z** , **\_** , **.**\ \ Lowercase letters are not supported in the names. ::: An example of its output (reformatted for clarity) is shown below. JSON for custom discovery checks has to follow the same format. ``` {.javascript} [ { "{#FSNAME}":"/", "{#FSTYPE}":"rootfs" }, { "{#FSNAME}":"/sys", "{#FSTYPE}":"sysfs" }, { "{#FSNAME}":"/proc", "{#FSTYPE}":"proc" }, { "{#FSNAME}":"/dev", "{#FSTYPE}":"devtmpfs" }, { "{#FSNAME}":"/dev/pts", "{#FSTYPE}":"devpts" }, { "{#FSNAME}":"/lib/init/rw", "{#FSTYPE}":"tmpfs" }, { "{#FSNAME}":"/dev/shm", "{#FSTYPE}":"tmpfs" }, { "{#FSNAME}":"/home", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/tmp", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/usr", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/var", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/sys/fs/fuse/connections", "{#FSTYPE}":"fusectl" } ] ``` In previous example it is required that the keys match the LLD macro names used in prototypes, the alternative is to extract LLD macro values using JSONPath `{#FSNAME}` → `$.fsname` and `{#FSTYPE}` → `$.fstype`, thus making such script possible: ``` {.perl} #!/usr/bin/perl $first = 1; print "[\n"; for (`cat /proc/mounts`) { ($fsname, $fstype) = m/\S+ (\S+) (\S+)/; print "\t,\n" if not $first; $first = 0; print "\t{\n"; print "\t\t\"fsname\":\"$fsname\",\n"; print "\t\t\"fstype\":\"$fstype\"\n"; print "\t}\n"; } print "]\n"; ``` An example of its output (reformatted for clarity) is shown below. JSON for custom discovery checks has to follow the same format. ``` {.javascript} [ { "fsname":"/", "fstype":"rootfs" }, { "fsname":"/sys", "fstype":"sysfs" }, { "fsname":"/proc", "fstype":"proc" }, { "fsname":"/dev", "fstype":"devtmpfs" }, { "fsname":"/dev/pts", "fstype":"devpts" }, { "fsname":"/lib/init/rw", "fstype":"tmpfs" }, { "fsname":"/dev/shm", "fstype":"tmpfs" }, { "fsname":"/home", "fstype":"ext3" }, { "fsname":"/tmp", "fstype":"ext3" }, { "fsname":"/usr", "fstype":"ext3" }, { "fsname":"/var", "fstype":"ext3" }, { "fsname":"/sys/fs/fuse/connections", "fstype":"fusectl" } ] ``` Then, in the discovery rule's "Filter" field, we could specify "{\#FSTYPE}" as a macro and "rootfs|ext3" as a regular expression. ::: noteclassic You don't have to use macro names FSNAME/FSTYPE with custom LLD rules, you are free to use whatever names you like. In case JSONPath is used then LLD row will be an array element that can be an object, but it can be also another array or a value. ::: Note that, if using a user parameter, the return value is limited to 512 KB. For more details, see [data limits for LLD return values](/manual/discovery/low_level_discovery/notes#data_limits_for_return_values). ### カスタムLLDルールの作成 データベース サーバー上のデータベースなど、あらゆる種類のエンティティを検出ための、完全カスタムの LLD ルールを作成することもできます。 そのためには、JSON を返すカスタム アイテムを作成し、見つかったオブジェクトとオプションでそれらのプロパティを指定する必要があります。 エンティティごとのマクロ数に制限はありません。組み込みのディスカバリルールは 1 つまたは 2 つのマクロ (たとえば、ファイル システム検出の場合は 2 つ) を返しますが、さらに多くのマクロを返すこともできます。 必要なJSON形式を例題で説明します。 古いZabbix1.8エージェント（"vfs.fs.discovery"をサポートしていないエージェント）を実行しているが、ファイルシステムを検出する必要があるとします。以下はマウントされたファイルシステムを検出し、ファイルシステム名とタイプの両方を含むJSONを出力するLinux用の単純なPerlスクリプトです。 これを使用する方法の1つは、キー"vfs.fs.discovery\_perl"を持つUserParameterとして実行することです。 ``` {.perl} #!/usr/bin/perl $first = 1; print "[\n"; for (`cat /proc/mounts`) { ($fsname, $fstype) = m/\S+ (\S+) (\S+)/; print "\t,\n" if not $first; $first = 0; print "\t{\n"; print "\t\t\"{#FSNAME}\":\"$fsname\",\n"; print "\t\t\"{#FSTYPE}\":\"$fstype\"\n"; print "\t}\n"; } print "]\n"; ``` ::: noteimportant LLD マクロ名に使用できる記号は**0-9** 、 **A-Z** 、 **\_** 、 **.**です。 名前に小文字は使用できません。 ::: 出力例(わかりやすくするために再フォーマットされています)を以下に示します。 カスタム検出チェックの JSON は、同じ形式に従う必要があります。 ``` {.javascript} [ { "{#FSNAME}":"/", "{#FSTYPE}":"rootfs" }, { "{#FSNAME}":"/sys", "{#FSTYPE}":"sysfs" }, { "{#FSNAME}":"/proc", "{#FSTYPE}":"proc" }, { "{#FSNAME}":"/dev", "{#FSTYPE}":"devtmpfs" }, { "{#FSNAME}":"/dev/pts", "{#FSTYPE}":"devpts" }, { "{#FSNAME}":"/lib/init/rw", "{#FSTYPE}":"tmpfs" }, { "{#FSNAME}":"/dev/shm", "{#FSTYPE}":"tmpfs" }, { "{#FSNAME}":"/home", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/tmp", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/usr", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/var", "{#FSTYPE}":"ext3" }, { "{#FSNAME}":"/sys/fs/fuse/connections", "{#FSTYPE}":"fusectl" } ] ``` 前の例では、キーがプロトタイプで使用される LLD マクロ名と一致する必要があります。 別の方法としては、JSONPath`{#FSNAME}` → `$.fsname` および `{#FSTYPE}` → `$.fstype` を使用して LLD マクロ値を抽出することです。次のようなスクリプトでそれを可能にします: ``` {.perl} #!/usr/bin/perl $first = 1; print "[\n"; for (`cat /proc/mounts`) { ($fsname, $fstype) = m/\S+ (\S+) (\S+)/; print "\t,\n" if not $first; $first = 0; print "\t{\n"; print "\t\t\"fsname\":\"$fsname\",\n"; print "\t\t\"fstype\":\"$fstype\"\n"; print "\t}\n"; } print "]\n"; ``` 出力例(わかりやすくするために再フォーマットされています)を以下に示します。 カスタム検出チェックの JSON は、同じ形式に従う必要があります。 ``` {.javascript} [ { "fsname":"/", "fstype":"rootfs" }, { "fsname":"/sys", "fstype":"sysfs" }, { "fsname":"/proc", "fstype":"proc" }, { "fsname":"/dev", "fstype":"devtmpfs" }, { "fsname":"/dev/pts", "fstype":"devpts" }, { "fsname":"/lib/init/rw", "fstype":"tmpfs" }, { "fsname":"/dev/shm", "fstype":"tmpfs" }, { "fsname":"/home", "fstype":"ext3" }, { "fsname":"/tmp", "fstype":"ext3" }, { "fsname":"/usr", "fstype":"ext3" }, { "fsname":"/var", "fstype":"ext3" }, { "fsname":"/sys/fs/fuse/connections", "fstype":"fusectl" } ] ``` 次にディスカバリルールの[フィルタ]フィールドで、"{\#FSTYPE}"をマクロとして指定し、正規表現として"rootfs|ext3"を指定します。 ::: noteclassic カスタムLLDルールでマクロ名FSNAME/FSTYPEを使用する必要はありません。好きな名前を自由に使用できます。 JSONPathが使用されている場合、LLD行はオブジェクトになることができる配列要素になりますが、別の配列または値にすることもできます。 ::: ユーザーパラメータを使用する場合、戻り値は512KBに制限されることに注意してください。 詳細については[LLD戻り値のデータ制限](/manual/discovery/low_level_discovery#data_limits_for_return_values)を参照してください。 ##### Creating database [Create](/manual/appendix/install/db_scripts) a separate database for Zabbix proxy. Zabbix server and Zabbix proxy cannot use the same database. If they are installed on the same host, the proxy database must have a different name. ##### データベースの作成 Zabbixプロキシ用のデータベースは分けて[作成](/manual/appendix/install/db_scripts)します。 ZabbixサーバーとZabbixプロキシは、同じデータベースを使用することができません。両者を同じホスト上にインストールする場合は、プロキシ用のデータベースは別の名前である必要があります。 ##### Creating database [Create](/manual/appendix/install/db_scripts) a separate database for Zabbix proxy. Zabbix server and Zabbix proxy cannot use the same database. If they are installed on the same host, the proxy database must have a different name. ##### データベースの作成 Zabbixプロキシ用に別のデータベースを[作成](/manual/appendix/install/db_scripts)します。 ZabbixサーバーとZabbixプロキシは同じデータベースを使用できません。 サーバーとプロキシが同じホストにインストールされている場合、プロキシ データベースは別の名前にする必要があります。 ##### Creating database [Create](/manual/appendix/install/db_scripts) a separate database for Zabbix proxy. Zabbix server and Zabbix proxy cannot use the same database. If they are installed on the same host, the proxy database must have a different name. ##### データベースの作成 [Create](/manual/appendix/install/db_scripts) Zabbix proxy用に別のデータベースを作成します。 Zabbix serverとZabbix proxyは、同じデータベースを使用することはできません。<br> 両者が同じホストにインストールされている場合、proxy用データベースはserver用データベースと<br> 別の名前で作成する必要があります。 #### Creating database For Zabbix [server](/manual/concepts/server) and [proxy](/manual/concepts/proxy) daemons a database is required. It is not needed to run Zabbix [agent](/manual/concepts/agent). ::: notewarning Separate databases are needed for Zabbix server and Zabbix proxy; they cannot use the same database. Therefore, if they are installed on the same host, their databases must be created with different names! ::: Create the database using the provided instructions for [MySQL](/manual/appendix/install/db_scripts#mysql) or [PostgreSQL](/manual/appendix/install/db_scripts#postgresql). #### データベースの作成 Zabbix[サーバー](/manual/concepts/server)および[プロキシ](/manual/concepts/proxy)デーモンには、データベースが必要です。 Zabbix[エージェント](/manual/concepts/agent)を実行する必要はありません。 ::: notewarning ZabbixサーバーとZabbixプロキシには個別のデータベースが必要です。 同じデータベースを使用することはできません。 したがってサーバーとプロキシが同じホストにインストールされている場合、それらが参照するデータベースは異なる名前で作成する必要があります! ::: [MySQL](/manual/appendix/install/db_scripts#mysql)または[PostgreSQL](/manual/appendix/install/db_scripts#postgresql)の指示に従ってデータベースを作成します。 #### Creating dependent item Create a dependent item for the master item with ID 24759. Only dependencies on the same host are allowed, therefore master and the dependent item should have the same hostid. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "hostid": "30074", "name": "Dependent test item", "key_": "dependent.item", "type": 18, "master_itemid": "24759", "value_type": 2 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### 依存アイテムの作成 ID 24759 のマスター アイテムの依存アイテムを作成します。同じホストへの依存のみが許可されるため、マスターと依存アイテムは同じホスト ID を持つ必要があります。 Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "hostid": "30074", "name": "Dependent test item", "key_": "dependent.item", "type": 18, "master_itemid": "24759", "value_type": 2 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Creating dependent item prototype Create Dependent item prototype for Master item prototype with ID 44211. Only dependencies on same host (template/discovery rule) are allowed, therefore Master and Dependent item should have same hostid and ruleid. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "hostid": "10001", "ruleid": "27665", "name": "Dependent test item prototype", "key_": "dependent.prototype", "type": 18, "master_itemid": "44211", "value_type": 3 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44212" ] }, "id": 1 } ``` #### 依存アイテムのプロトタイプ作成 ID 44211 のマスター アイテム プロトタイプの依存アイテム プロトタイプを作成します。同じホスト (テンプレート/ディスカバリルール) への依存のみが許可されるため、マスター アイテムと依存アイテムは同じホスト ID とルール ID を持つ必要があります。 Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "hostid": "10001", "ruleid": "27665", "name": "Dependent test item prototype", "key_": "dependent.prototype", "type": 18, "master_itemid": "44211", "value_type": 3 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44212" ] }, "id": 1 } ``` #### Creating hosts from Monitoring It is now also possible to create new hosts from *Monitoring* → *[Hosts](/manual/web_interface/frontend_sections/monitoring/hosts)*.  The *Create host* button is available for Admin and Super Admin users. #### 監視データからのホスト定義作成 *監視データ* → *[ホスト](/manual/web_interface/frontend_sections/monitoring/hosts)* から新しいホスト定義を作成することもできるようになりました。  *ホスト作成* ボタンは、管理者と特権管理者のユーザーが使用できます。 #### Creating host subgroups A host subgroup (or nested host group) is a child of the parent host group that contains it. Nested representation of host groups is supported since Zabbix 3.2.0. A subgroup is created by using the forward slash '/' in the group name input field to denote its relation to the parent group(s). For example: - inputting `Europe/Latvia` creates the `Europe/Latvia` subgroup of the parent group `Europe`. - inputting `Europe/Latvia/Riga/Zabbix servers` creates the respective subgroup within the nested parent groups `Europe`, `Europe/Latvia`, `Europe/Latvia/Riga`. When creating a subgroup, using leading or trailing slashes, or several slashes in a row is not allowed. Escaping of '/' is not supported. It is not required to create any parent host group(s) before creating a subgroup. You can choose whether to start by creating a subgroup (for example, `Europe/Latvia`) or any parent host group(s) (in our example, `Europe`). If you start by creating a subgroup, parent host group(s) will **not** be created automatically. #### ホストサブグループの作成 ホストサブグループ(またはネストされたホストグループ)は、それを含む親ホスト グループの子です。ホストグループのネストという表現は、Zabbix 3.2.0以降でサポートされています。 サブグループは、グループ名入力フィールドでスラッシュ'/'を使用して、親グループとの関係を示すことによって作成されます。例: - `Europe/Latvia`と入力すると、親グループ`Europe`の`Europe/Latvia`サブグループが作成されます。 - `Europe/Latvia/Riga/Zabbix servers`と入力すると、ネストされた親グループ`Europe`、`Europe/Latvia`、`Europe/Latvia/Riga`内にそれぞれのサブグループが作成されます。 サブグループを作成する場合、先頭または末尾にスラッシュを使用したり、複数のスラッシュを連続して使用したりすることはできません。 '/' のエスケープはサポートされていません。 サブグループを作成する前に親ホストグループを作成する必要はありません。サブグループ(例: `Europe/Latvia`)か親ホストグループ(この例では`Europe`)か、どちらからでも作成できます。サブグループを先に作成しても、自動的に親ホストグループが作成されることは**ありません**。 #### Creating interfaces Create an interface on two hosts. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.massadd", "params": { "hosts": [ { "hostid": "30050" }, { "hostid": "30052" } ], "interfaces": { "dns": "", "ip": "127.0.0.1", "main": 0, "port": "10050", "type": 1, "useip": 1 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` #### インターフェースの作成 2つのホストにインターフェースを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.massadd", "params": { "hosts": [ { "hostid": "30050" }, { "hostid": "30052" } ], "interfaces": { "dns": "", "ip": "127.0.0.1", "main": 0, "port": "10050", "type": 1, "useip": 1 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` #### Creating multiple triggers So if create methods accept arrays, we can add multiple [triggers](/manual/api/reference/trigger/object) like so: ```json { "jsonrpc": "2.0", "method": "trigger.create", "params": [ { "description": "Processor load is too high on {HOST.NAME}", "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5", }, { "description": "Too many processes on {HOST.NAME}", "expression": "avg(/Linux server/proc.num[],5m)>300", } ], "auth": "0424bd59b807674191e7d77572075f33", "id": 4 } ``` A successful response will contain the IDs of the newly created triggers: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 4 } ``` #### 複数のトリガーの作成 したがって、createメソッドが配列を受け入れる場合、次のように複数の[トリガー](/manual/api/reference/trigger/object)を追加することも可能です。 ```json { "jsonrpc": "2.0", "method": "trigger.create", "params": [ { "description": "Processor load is too high on {HOST.NAME}", "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5", }, { "description": "Too many processes on {HOST.NAME}", "expression": "avg(/Linux server/proc.num[],5m)>300", } ], "auth": "0424bd59b807674191e7d77572075f33", "id": 4 } ``` 作成が成功した場合のレスポンスには、新しく作成したトリガーのIDが含まれます。 ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 4 } ``` ##### Creating new secret The following procedure describes how to create a new secret using Openshift Console. **1.** Open the Workloads → Secrets section and switch project to the Zabbix Operator project (by default, "zabbix"). {width="600"} **2.** Create a new secret using the *From YAML* option. {width="600"} ##### 新しいシークレットの作成 次の手順では、Openshiftコンソールを使用して新しいシークレットを作成する方法について説明します。 **1.** Workloads → Secretsセクションを開き、プロジェクトをZabbix Operatorプロジェクト(デフォルトでは"zabbix")に切り替えます。 {width="600"} **2.** *From YAML*オプションを使用して新しいシークレットを作成します。 {width="600"} ### Critical To complete successful Zabbix server upgrade on MySQL and MariaDB, you may require to set `GLOBAL log_bin_trust_function_creators = 1` in MySQL if binary logging is enabled, there are no superuser privileges and `log_bin_trust_function_creators = 1` is not set in MySQL configuration file. To set the variable using the MySQL console, run: mysql> SET GLOBAL log_bin_trust_function_creators = 1; Once the upgrade has been successfully completed, `log_bin_trust_function_creators` can be disabled: mysql> SET GLOBAL log_bin_trust_function_creators = 0; ### 重要(Critical) MySQL/MariaDBでZabbixサーバーのアップグレードを正常に完了するには、バイナリロギングが有効で、スーパーユーザー権限がなく、MySQL構成ファイルに`log_bin_trust_function_creators = 1`が設定されていない場合、MySQLで`GLOBAL log_bin_trust_function_creators = 1`を設定する必要がある場合があります。 MySQLコンソールを使用して変数を設定するには、次を実行します。 mysql> SET GLOBAL log_bin_trust_function_creators = 1; アップグレードが正常に完了したら、このオプションを無効にすることができます。 mysql> SET GLOBAL log_bin_trust_function_creators = 0; #### CRL expired or expires during server operation [*OpenSSL*]{.underline}, in server log: - before expiration: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\ SSL routines:ssl3_get_server_certificate:certificate verify failed:\ TLS write fatal alert "certificate revoked" - after expiration: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\ SSL routines:ssl3_get_server_certificate:certificate verify failed:\ TLS write fatal alert "certificate expired" The point here is that with valid CRL a revoked certificate is reported as "certificate revoked". When CRL expires the error message changes to "certificate expired" which is quite misleading. [*GnuTLS*]{.underline}, in server log: - before and after expiration the same: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ invalid peer certificate: The certificate is NOT trusted. The certificate chain is revoked. #### CRL が期限切れになった、またはサーバー操作中に期限切れになった [*OpenSSL*]{.underline}サーバー ログ: - 期限切れ前: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\ SSL routines:ssl3_get_server_certificate:certificate verify failed:\ TLS write fatal alert "certificate revoked" - 期限切れ後: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\ SSL routines:ssl3_get_server_certificate:certificate verify failed:\ TLS write fatal alert "certificate expired" ここでのポイントは、有効な CRL を使用すると、取り消された証明書が「証明書が取り消された」として報告されることです。 CRL の有効期限が切れると、エラー メッセージが「証明書の有効期限が切れました」に変わります。これは誤解を招く可能性があります。 [*GnuTLS*]{.underline}サーバーログ: - 有効期限の前後で同じ: ```{=html} <!-- --> ``` cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\ invalid peer certificate: The certificate is NOT trusted. The certificate chain is revoked. ### Cryptography ### 暗号化 ### Custom interface details The details object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>1 - *(default)* - use bulk requests.| |community|string|SNMP community. Used only by SNMPv1 and SNMPv2 interfaces.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.| |privpassphrase|string|SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.| |authprotocol|integer|SNMPv3 authentication protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 context name. Used only by SNMPv3 interfaces.| ### Custom interface details Custom interface detailsオブジェクトには、次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**version**<br>(必須)|integer|SNMPインターフェースのバージョン。<br><br>値は次のとおりです。<br>1 - SNMPv1<br>2 - SNMPv2c<br>3 - SNMPv3| |bulk|integer|バルクSNMPリクエストを使用するかどうか。<br><br>値は次のとおりです。<br>0 - バルクリクエストを使用しない<br>1 -（デフォルト）- バルクリクエストを使用する| |community|string|SNMPコミュニティ。 SNMPv1およびSNMPv2インターフェースでのみ使用されます。| |securityname|string|SNMPv3セキュリティ名。 SNMPv3インターフェースでのみ使用されます。| |securitylevel|integer|SNMPv3セキュリティレベル。 SNMPv3インターフェースでのみ使用されます。<br><br>値は次のとおりです。<br>0 -（デフォルト）- noAuthNoPriv<br>1 - authNoPriv<br>2 - authPriv| |authpassphrase|string|SNMPv3認証パスフレーズ。 SNMPv3インターフェースでのみ使用されます。| |privpassphrase|string|SNMPv3プライバシーパスフレーズ。 SNMPv3インターフェースでのみ使用されます。| |authprotocol|integer|SNMPv3認証プロトコル。 SNMPv3インターフェースでのみ使用されます。<br><br>値は次のとおりです。<br>0 - （デフォルト）- MD5<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512| |privprotocol|integer|SNMPv3プライバシープロトコル。 SNMPv3インターフェースでのみ使用されます。<br><br>値は次のとおりです。<br>0 -（デフォルト）- DES<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C| |contextname|string|SNMPv3コンテキスト名。 SNMPv3インターフェースでのみ使用されます。| #### Custom script limit Available custom script length depends on the database used: |Database|Limit in characters|Limit in bytes| |---|---|---| |**MySQL**|65535|65535| |**Oracle Database**|2048|4000| |**PostgreSQL**|65535|not limited| |**SQLite (only Zabbix proxy)**|65535|not limited| #### カスタムスクリプトの制限 使用可能なカスタムスクリプトの長さは、使用するデータベースによって異なります。 |Database|文字数の上限|バイト数の上限| |---|---|---| |**MySQL**|65535|65535| |**Oracle Database**|2048|4000| |**PostgreSQL**|65535|制限なし| |**SQLite (Zabbixプロキシのみ)**|65535|制限なし| # dashboard.create # dashboard.create # dashboard.delete # dashboard.delete # dashboard.get # dashboard.get ### Dashboard page The dashboard page object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboard\_pageid|string|*(readonly)* ID of the dashboard page.| |name|string|Dashboard page name.<br><br>Default: empty string.| |display\_period|integer|Dashboard page display period (in seconds).<br><br>Possible values: 0, 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 0 (will use the default page display period).| |widgets|array|Array of the [dashboard widget](object#dashboard_widget) objects.| ### Dashboard page Dashboard page オブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |dashboard\_pageid|string|*(readonly)* ID of the dashboard page.| |name|string|Dashboard page name.<br><br>Default: empty string.| |display\_period|integer|Dashboard page display period (in seconds).<br><br>Possible values: 0, 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 0 (will use the default page display period).| |widgets|array|Array of the [dashboard widget](object#dashboard_widget) objects.| ##### Dashboard size The minimum width of a dashboard is 1200 pixels. The dashboard will not shrink below this width; instead a horizontal scrollbar is displayed if the browser window is smaller than that. The maximum width of a dashboard is the browser window width. Dashboard widgets stretch horizontally to fit the window. At the same time, a dashboard widget cannot be stretched horizontally beyond the window limits. Technically the dashboard consists of 12 horizontal columns of always equal width that stretch/shrink dynamically (but not to less than 1200 pixels total). Vertically the dashboard may contain a maximum of 64 rows. Each row has a fixed height of 70 pixels. A widget may be up to 32 rows high. ##### ダッシュボードサイズ ダッシュボードの最小幅は 1200 ピクセルです。 ダッシュボードはこの幅より小さくなりません。 ブラウザ ウィンドウがそれよりも小さい場合は、水平スクロールバーが表示されます。 ダッシュボードの最大幅はブラウザ ウィンドウの幅です。 ダッシュボード ウィジェットはウィンドウに合わせて水平方向に伸縮します。 ダッシュボード ウィジェットをウィンドウの制限を超えて水平方向に配置することはできません。 技術的には、ダッシュボードは常に同じ幅の 12 個の水平列で構成され、動的に伸縮します (ただし、合計 1200 ピクセル未満にはなりません)。 ダッシュボードには、垂直方向に最大 64 行を含めることができます。 各行の高さは 70 ピクセルに固定されています。 ウィジェットの高さは最大 32 行です。 #### Dashboards Manage dashboards and make scheduled reports based on them. [Dashboard API](/manual/api/reference/dashboard) | [Template dashboard API](/manual/api/reference/templatedashboard) | [Report API](/manual/api/reference/report) #### ダッシュボード ダッシュボードを管理し、それに基づいてスケジュールされたレポートを作成します。 [Dashboard API](/manual/api/reference/dashboard) | [Template dashboard API](/manual/api/reference/templatedashboard) | [Report API](/manual/api/reference/report) ### Dashboard The dashboard object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboardid|string|*(readonly)* ID of the dashboard.| |**name**<br>(required)|string|Name of the dashboard.| |userid|string|Dashboard owner user ID.| |private|integer|Type of dashboard sharing.<br><br>Possible values:<br>0 - public dashboard;<br>1 - *(default)* private dashboard.| |display\_period|integer|Default page display period (in seconds).<br><br>Possible values: 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 30.| |auto\_start|integer|Auto start slideshow.<br><br>Possible values:<br>0 - do not auto start slideshow;<br>1 - *(default)* auto start slideshow.| ### Dashboard dashboard オブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |dashboardid|string|*(readonly)* ID of the dashboard.| |**name**<br>(required)|string|Name of the dashboard.| |userid|string|Dashboard owner user ID.| |private|integer|Type of dashboard sharing.<br><br>Possible values:<br>0 - public dashboard;<br>1 - *(default)* private dashboard.| |display\_period|integer|Default page display period (in seconds).<br><br>Possible values: 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 30.| |auto\_start|integer|Auto start slideshow.<br><br>Possible values:<br>0 - do not auto start slideshow;<br>1 - *(default)* auto start slideshow.| # dashboard.update # dashboard.update ### Dashboard user group List of dashboard permissions based on user groups. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**usrgrpid**<br>(required)|string|User group ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### Dashboard user group ユーザーグループに基づくダッシュボードの権限一覧です。以下のプロパティを持ちます。 |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**usrgrpid**<br>(required)|string|User group ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### Dashboard user List of dashboard permissions based on users. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**userid**<br>(required)|string|User ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### Dashboard user ユーザーに基づくダッシュボードの権限一覧です。以下のプロパティを持ちます。 |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**userid**<br>(required)|string|User ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| # Dashboard widget fields # Dashboard widget fields ### Dashboard widget field The dashboard widget field object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|Type of the widget field.<br><br>Possible values:<br>0 - Integer;<br>1 - String;<br>2 - Host group;<br>3 - Host;<br>4 - Item;<br>5 - Item prototype;<br>6 - Graph;<br>7 - Graph prototype;<br>8 - Map;<br>9 - Service;<br>10 - SLA.| |name|string|Widget field name.| |**value**<br>(required)|mixed|Widget field value depending of type.| ### Dashboard widget field Dashboard widget field オブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**type**<br>(required)|integer|Type of the widget field.<br><br>Possible values:<br>0 - Integer;<br>1 - String;<br>2 - Host group;<br>3 - Host;<br>4 - Item;<br>5 - Item prototype;<br>6 - Graph;<br>7 - Graph prototype;<br>8 - Map;<br>9 - Service;<br>10 - SLA.| |name|string|Widget field name.| |**value**<br>(required)|mixed|Widget field value depending of type.| ### Dashboard widget The dashboard widget object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |widgetid|string|*(readonly)* ID of the dashboard widget.| |**type**<br>(required)|string|Type of the dashboard widget.<br><br>Possible values:<br>actionlog - Action log;<br>clock - Clock;<br>dataover - Data overview;<br>discovery - Discovery status;<br>favgraphs - Favorite graphs;<br>favmaps - Favorite maps;<br>graph - Graph (classic);<br>graphprototype - Graph prototype;<br>hostavail - Host availability;<br>item - Item value;<br>map - Map;<br>navtree - Map Navigation Tree;<br>plaintext - Plain text;<br>problemhosts - Problem hosts;<br>problems - Problems;<br>problemsbysv - Problems by severity;<br>slareport - SLA report;<br>svggraph - Graph;<br>systeminfo - System information;<br>tophosts - Top hosts;<br>trigover - Trigger overview;<br>url - URL;<br>web - Web monitoring.| |name|string|Custom widget name.| |x|integer|A horizontal position from the left side of the dashboard.<br><br>Valid values range from 0 to 23.| |y|integer|A vertical position from the top of the dashboard.<br><br>Valid values range from 0 to 62.| |width|integer|The widget width.<br><br>Valid values range from 1 to 24.| |height|integer|The widget height.<br><br>Valid values range from 2 to 32.| |view\_mode|integer|The widget view mode.<br><br>Possible values:<br>0 - (default) default widget view;<br>1 - with hidden header;| |fields|array|Array of the [dashboard widget field](object#dashboard_widget_field) objects.| ### Dashboard widget Dashboard widget オブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |widgetid|string|*(readonly)* ID of the dashboard widget.| |**type**<br>(required)|string|Type of the dashboard widget.<br><br>Possible values:<br>actionlog - Action log;<br>clock - Clock;<br>dataover - Data overview;<br>discovery - Discovery status;<br>favgraphs - Favorite graphs;<br>favmaps - Favorite maps;<br>graph - Graph (classic);<br>graphprototype - Graph prototype;<br>hostavail - Host availability;<br>item - Item value;<br>map - Map;<br>navtree - Map Navigation Tree;<br>plaintext - Plain text;<br>problemhosts - Problem hosts;<br>problems - Problems;<br>problemsbysv - Problems by severity;<br>slareport - SLA report;<br>svggraph - Graph;<br>systeminfo - System information;<br>tophosts - Top hosts;<br>trigover - Trigger overview;<br>url - URL;<br>web - Web monitoring.| |name|string|Custom widget name.| |x|integer|A horizontal position from the left side of the dashboard.<br><br>Valid values range from 0 to 23.| |y|integer|A vertical position from the top of the dashboard.<br><br>Valid values range from 0 to 62.| |width|integer|The widget width.<br><br>Valid values range from 1 to 24.| |height|integer|The widget height.<br><br>Valid values range from 2 to 32.| |view\_mode|integer|The widget view mode.<br><br>Possible values:<br>0 - (default) default widget view;<br>1 - with hidden header;| |fields|array|Array of the [dashboard widget field](object#dashboard_widget_field) objects.| ### Dashboard widget The dashboard widget object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |widgetid|string|*(readonly)* ID of the dashboard widget.| |**type**<br>(required)|string|Type of the dashboard widget.<br><br>Possible values:<br>actionlog - Action log;<br>clock - Clock;<br>dataover - Data overview;<br>discovery - Discovery status;<br>favgraphs - Favorite graphs;<br>favmaps - Favorite maps;<br>graph - Graph (classic);<br>graphprototype - Graph prototype;<br>hostavail - Host availability;<br>item - Item value;<br>map - Map;<br>navtree - Map Navigation Tree;<br>plaintext - Plain text;<br>problemhosts - Problem hosts;<br>problems - Problems;<br>problemsbysv - Problems by severity;<br>svggraph - Graph;<br>systeminfo - System information;<br>trigover - Trigger overview;<br>url - URL;<br>web - Web monitoring.| |name|string|Custom widget name.| |x|integer|A horizontal position from the left side of the dashboard.<br><br>Valid values range from 0 to 23.| |y|integer|A vertical position from the top of the dashboard.<br><br>Valid values range from 0 to 62.| |width|integer|The widget width.<br><br>Valid values range from 1 to 24.| |height|integer|The widget height.<br><br>Valid values range from 2 to 32.| |view\_mode|integer|The widget view mode.<br><br>Possible values:<br>0 - (default) default widget view;<br>1 - with hidden header;| |fields|array|Array of the [dashboard widget field](object#dashboard_widget_field) objects.| ### Dashboard widget The dashboard widget object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |widgetid|string|*(readonly)* ID of the dashboard widget.| |**type**<br>(required)|string|Type of the dashboard widget.<br><br>Possible values:<br>actionlog - Action log;<br>clock - Clock;<br>dataover - Data overview;<br>discovery - Discovery status;<br>favgraphs - Favorite graphs;<br>favmaps - Favorite maps;<br>graph - Graph (classic);<br>graphprototype - Graph prototype;<br>hostavail - Host availability;<br>map - Map;<br>navtree - Map Navigation Tree;<br>plaintext - Plain text;<br>problemhosts - Problem hosts;<br>problems - Problems;<br>problemsbysv - Problems by severity;<br>svggraph - Graph;<br>systeminfo - System information;<br>trigover - Trigger overview;<br>url - URL;<br>web - Web monitoring;| |name|string|Custom widget name.| |x|integer|A horizontal position from the left side of the dashboard.<br><br>Valid values range from 0 to 23.| |y|integer|A vertical position from the top of the dashboard.<br><br>Valid values range from 0 to 62.| |width|integer|The widget width.<br><br>Valid values range from 1 to 24.| |height|integer|The widget height.<br><br>Valid values range from 2 to 32.| |view\_mode|integer|The widget view mode.<br><br>Possible values:<br>0 - (default) default widget view;<br>1 - with hidden header;| |fields|array|Array of the [dashboard widget field](object#dashboard_widget_field) objects.| #### Database changes A slow template cloning issue has been resolved by adding indexes for the uuid field. This change may cause long upgrade times on large datasets. #### データベースの変更 テンプレートの複製が遅い問題は、uuidフィールドにインデックスを追加することで解決されました。この変更により、大規模なデータセットではアップグレードに長い時間がかかる可能性があります。 #### Database engine This is probably the most important part of Zabbix tuning. Zabbix heavily depends on the availability and performance of database engine. - use fastest database engine, i.e. MySQL or PostgreSQL - use stable release of a database engine - rebuild MySQL or PostgreSQL from sources to get maximum performance - follow performance tuning instructions taken from MySQL or PostgreSQL documentation - for MySQL, use InnoDB table structure - ZABBIX works at least 1.5 times faster (comparing to MyISAM) if InnoDB is used. This is because of increased parallelism. However, InnoDB requires more CPU power. - tuning the database server for the best performance is highly recommended. - keep database tables on different hard disks - 'history', 'history\_str, 'items' 'functions', triggers', and 'trends' are most heavily used tables. - for large installations keeping MySQL temporary files in tmpfs is: - MySQL >= 5.5: not recommended ([MySQL bug \#58421](https://bugs.mysql.com/bug.php?id=58421)) - MySQL < 5.5: recommended #### データベース エンジン これはおそらく、Zabbix のチューニングで最も重要な部分です。 Zabbix は、データベース エンジンの可用性とパフォーマンスに大きく依存しています。 - 最速のデータベース エンジン、つまり MySQL または PostgreSQL を使用する - データベース エンジンの安定版リリースを使用する - 最大のパフォーマンスを得るためにMySQL または PostgreSQL をソースから再構築する - MySQL または PostgreSQL のドキュメントから取得したパフォーマンス チューニングの手順に従う - MySQL の場合、InnoDB テーブル構造を使用する - InnoDB を使用した場合、ZABBIX は (MyISAM と比較して) 少なくとも 1.5 倍高速に動作します。 これは、並列処理が増加したためです。 ただし、InnoDB はより多くの CPU パワーを必要とします。 - 最高のパフォーマンスが得られるようにデータベース サーバーをチューニングする - データベース テーブルを別のハード ディスクに保持する - 'history'、'history\_str、'items'、'functions'、triggers'、'trends' は、最も頻繁に使用されるテーブルです。 - 大規模なインストールの場合、MySQL 一時ファイルを tmpfs に保持する方法は次のとおりです。 - MySQL >= 5.5: 非推奨 ([MySQL バグ \#58421](https://bugs.mysql.com/bug.php?id=58421)) - MySQL < 5.5: 推奨 ##### Database management system |Software|Supported versions|Comments| |--------|------------------|--------| |*MySQL/Percona*|8.0.X|Required if MySQL (or Percona) is used as Zabbix backend database. InnoDB engine is required. We recommend using the [MariaDB Connector/C](https://downloads.mariadb.org/connector-c/) library for building server/proxy.| |*MariaDB*|10.5.00-10.6.X|InnoDB engine is required. We recommend using the [MariaDB Connector/C](https://downloads.mariadb.org/connector-c/) library for building server/proxy.| |*Oracle*|19c - 21c|Required if Oracle is used as Zabbix backend database.| |*PostgreSQL*|13.0 - 14.X|Required if PostgreSQL is used as Zabbix backend database.| |*TimescaleDB* for PostgreSQL|2.0.1-2.3|Required if TimescaleDB is used as Zabbix backend database. Make sure to install the distribution of TimescaleDB with the compression supported.| |*SQLite*|3.3.5-3.34.X|SQLite is only supported with Zabbix proxies. Required if SQLite is used as Zabbix proxy database.| ::: noteclassic Although Zabbix can work with databases available in the operating systems, for the best experience, we recommend using databases installed from the official database developer repositories. ::: ##### DBMS(データベースマネジメントシステム) |ソフトウェア|サポートするバージョン|備考| |--------|------------------|--------| |*MySQL/Percona*|8.0.X|Required if MySQL (or Percona) is used as Zabbix backend database. InnoDB engine is required. We recommend using the [MariaDB Connector/C](https://downloads.mariadb.org/connector-c/) library for building server/proxy.| |*MariaDB*|10.5.00-10.6.X|InnoDB engine is required. We recommend using the [MariaDB Connector/C](https://downloads.mariadb.org/connector-c/) library for building server/proxy.| |*Oracle*|19c - 21c|Required if Oracle is used as Zabbix backend database.| |*PostgreSQL*|13.0 - 14.X|Required if PostgreSQL is used as Zabbix backend database.| |*TimescaleDB* for PostgreSQL|2.0.1-2.3|Required if TimescaleDB is used as Zabbix backend database. Make sure to install the distribution of TimescaleDB with the compression supported.| |*SQLite*|3.3.5-3.34.X|SQLite is only supported with Zabbix proxies. Required if SQLite is used as Zabbix proxy database.| ::: noteclassic ZabbixはOSで利用可能なあらゆるバージョンのデータベースを使用することができますが、 <br> 最高の操作性を得るためには、各データベースの公式リポジトリから入手した最新のデータベースを使用することをお勧めします。 ::: ## Databases ## データベース ## Databases ## データベース ## Databases ## データベース ## Databases ## データベース ## Databases ## データベース ## Databases ## データベース ## Databases ## データベース ## Databases ## データベース ## Databases ## データベース ## Databases #### Supported versions PostgreSQL **16** and MariaDB **11.1** are now supported. See also: [Requirements](/manual/installation/requirements#third-party-external-surrounding-software). ## データベース #### サポートするバージョン PostgreSQL **16**とMariaDB **11.1**をサポートしました。参照: [要件](/manual/installation/requirements#third-party-external-surrounding-software)。 ## Databases To create the optimal user experience and ensure the best Zabbix performance in various production environments, the support of some older database releases has been dropped. This primarily applies to the database versions that are nearing their end of service life point and versions with unfixed issues that may interfere with normal performance. Starting from Zabbix 6.0, the following [database](/manual/installation/requirements#required-software) versions are officially supported: - *MySQL/Percona* 8.0.X - *MariaDB* 10.5.X - 10.6.X - *PostgreSQL* 13.X - 14.X - *Oracle* 19c - 21c - *TimescaleDB* 2.0.1-2.3 - *SQLite* 3.3.5-3.34.X By default, Zabbix server and proxy will not start if an unsupported database version is detected. It is now possible, though not recommended, to turn off DB version check by modifying AllowUnsupportedDBVersions configuration parameter for the [server](/manual/appendix/config/zabbix_server) or [proxy](/manual/appendix/config/zabbix_proxy). ## データベース 最適なユーザエクスペリエンスを実現し、様々な実環境で最高のZabbixのパフォーマンスを確保するために 一部の古いデータベースリリースのサポートは終了しました。 これは主に、サポート期間の終了に近いデータベースバージョンと、通常のパフォーマンスに支障をきたす可能性のある未修整の問題があるバージョンに適用されます。 Zabbix 6.0から、公式にサポートしているバージョンの [データベース](/manual/installation/requirements#required-software)は以下の通りです。 - *MySQL/Percona* 8.0.X - *MariaDB* 10.5.X - 10.6.X - *PostgreSQL* 13.X - 14.X - *Oracle* 19c - 21c - *TimescaleDB* 2.0.1-2.3 - *SQLite* 3.3.5-3.34.X デフォルトでは、サポートされていないデータベースバージョンが検出された場合、Zabbixサーバーとプロキシは起動しません。 ただし推奨はしませんが、[サーバー](/manual/appendix/config/zabbix_server)や[プロキシ](/manual/appendix/config/zabbix_proxy)のAllowUnsupportedDBVersions設定パラメータを変更することで、DB バージョンをチェックしないようにできます。 ##### Databases To create the optimal user experience and ensure the best Zabbix performance in various production environments, the support of some older database releases has been dropped. This primarily applies to the database versions that are nearing their end of service life point and versions with unfixed issues that may interfere with normal performance. Starting from Zabbix 6.0, the following [database](/manual/installation/requirements#required-software) versions are officially supported: - *MySQL/Percona* 8.0.X - *MariaDB* 10.5.X - 10.6.X - *PostgreSQL* 13.X - *Oracle* 19c - 21c - *TimescaleDB* 2.0.1-2.3 - *SQLite* 3.3.5-3.34.X By default, Zabbix server and proxy will not start if an unsupported database version is detected. It is now possible, though not recommended, to turn off DB version check by modifying AllowUnsupportedDBVersions configuration parameter for the [server](/manual/appendix/config/zabbix_server) or [proxy](/manual/appendix/config/zabbix_proxy). ##### データベース 最適なユーザーエクスペリエンスを実現し、さまざまな運用環境で最高のZabbixパフォーマンスを確保するために、一部の古いデータベースリリースのサポートが終了しました。 これは主に、サービス終了点が近づいているデータベース バージョンと、通常のパフォーマンスを妨げる可能性がある未修正の問題があるバージョンに適用されます。 Zabbix 6.0以降、次の[データベース](/manual/installation/requirements#required-software)バージョンが正式にサポートされるようになりました。 - *MySQL/Percona* 8.0.X - *MariaDB* 10.5.X - 10.6.X - *PostgreSQL* 13.X - *Oracle* 19c - 21c - *TimescaleDB* 2.0.1-2.3 - *SQLite* 3.3.5-3.34.X デフォルトでは、サポートされていないデータベースバージョンが検出された場合、Zabbixサーバーとプロキシは起動しません。 推奨はされませんが、[サーバー](/manual/appendix/config/zabbix_server)または[プロキシ](/manual/appendix/config/zabbix_proxy)のAllowUnsupportedDBVersions設定値を変更することで、DBバージョンチェックをオフにできるようになりました。 ### Databases To create the optimal user experience and ensure the best Zabbix performance in various production environments, the support of some older database releases has been dropped. This primarily applies to the database versions that are nearing their end of service life point and versions with unfixed issues that may interfere with normal performance. Starting from Zabbix 6.0, the following [database](/manual/installation/requirements#Software) versions are officially supported: - *MySQL/Percona* 8.0.X - *MariaDB* 10.5.X - 10.6.X - *PostgreSQL* 13.X - *Oracle* 19c - 21c - *TimescaleDB* 2.0.1-2.3 - *SQLite* 3.3.5-3.34.X By default, Zabbix server and proxy will not start if an unsupported database version is detected. It is now possible, though not recommended, to turn off DB version check by modifying AllowUnsupportedDBVersions configuration parameter for the [server](/manual/appendix/config/zabbix_server) or [proxy](/manual/appendix/config/zabbix_proxy). ### JavaScript methods HTTP methods PATCH, HEAD, OPTIONS, TRACE, CONNECT have been added to the JavaScript engine. Also, the engine now allows sending custom HTTP method requests with the new JS method HttpRequest.customRequest. See also: [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects). ##### Database storage All configuration information as well as the data gathered by Zabbix is stored in a database. ##### データベースストレージ Zabbixによって収集されたデータと同様に、すべての設定情報もデータベースに保存されます。 #### Database TLS connection for MySQL on SLES 12 The packages for server/proxy installation on SUSE Linux Enterprise Server version 12 are now built using MariaDB Connector/C library, thus enabling the encryption of connection to MySQL using the DBTLSConnect [parameter](/manual/appendix/config/zabbix_server). The supported encryption values are "required" and "verify\_full". #### SLES 12のMySQLのデータベースTLS接続 SUSE Linux Enterprise Serverバージョン12にサーバー/プロキシをインストールするためのパッケージは、MariaDB Connector/Cライブラリを使用して構築されるようになり、DBTLSConnect[パラメーター](/manual/appendix/config/zabbix_server)を使用したMySQLへの接続の暗号化が可能になります。サポートされている暗号化値は"required"と"verify_ful"です。 #### Database TLS connection with MariaDB Database TLS connection is not supported with the *verify\_ca* option for the DBTLSConnect [parameter](/manual/appendix/config/zabbix_server) if MariaDB is used. #### MariaDBでのデータベースTLS接続 MariaDBが使用されている場合、DBTLSConnect[パラメーター](/manual/appendix/config/zabbix_server)の*verify\_ca*オプションではデータベースTLS接続はサポートされません。 ##### Data collection with parameters Use the {HOST.CONN} macro as parameter value and get a response with expanded macro: - Create an item with type "Script".\ - Create a parameter:\ *Name:* host\ *Value:* {HOST.CONN}\ - In the *Script* field, enter the following code: ``` {.java} var request = new HttpRequest(); return request.post("https://postman-echo.com/post", JSON.parse(value)); ``` ##### パラメータによるデータ収集 パラメータ値として{HOST.CONN}マクロを使用し、マクロを展開してレスポンスを取得します。 - タイプ "Script" の item を作成します。 - 以下のパラメータを作成します: *Name:* host\ *Value:* {HOST.CONN}\ - *script*の欄に、以下のコードを入力します: ``` {.java} var request = new HttpRequest(); return request.post("https://postman-echo.com/post", JSON.parse(value)); ``` #### Data flow In addition it is important to take a step back and have a look at the overall data flow within Zabbix. In order to create an item that gathers data you must first create a host. Moving to the other end of the Zabbix spectrum you must first have an item to create a trigger. You must have a trigger to create an action. Thus if you want to receive an alert that your CPU load is too high on *Server X* you must first create a host entry for *Server X* followed by an item for monitoring its CPU, then a trigger which activates if the CPU is too high, followed by an action which sends you an email. While that may seem like a lot of steps, with the use of templating it really isn't. However, due to this design it is possible to create a very flexible setup. #### データフロー 加えて、Zabbix全体のデータフローを俯瞰的に見ることが非常に重要です。データを収集するアイテムを作成するためには、まず最初にホストを作成する必要があります。Zabbixで処理させるためには、最初にトリガーを作成するためのアイテムが必要です。アクションを作成するためには、トリガーが必要です。このように、例えば *サーバーX* でCPU負荷が高すぎる時に通知を受け取りたい場合は、まず *サーバーX* のホストを作成し、続いてCPUを監視するためのアイテムを作成し、それから、CPU負荷が高い場合に作動するトリガーを作成し、あなたにメールを送信するアクションを作成します。沢山のステップがあるように感じるかもしれませんが、テンプレートを使用すれば実はそんなことはありません。この設計であるため、非常に柔軟な構成が可能になっています。 #### Data set The following parameters are supported for configuring a *Data set*. ::: noteclassic The first number in the property name (e.g. ds.hosts.0.0, ds.items.0.0) represents the particular data set, while the second number, if present, represents the configured host or item. ::: |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |***Host pattern***<br>(required)|1|ds.hosts.0.0|[Host](/manual/api/reference/host/get) name or pattern (e.g. `Zabbix*`).| |***Item pattern***<br>(required)|1|ds.items.0.0|[Item](/manual/api/reference/item/get) name or pattern (e.g. `*: Number of processed *values per second`).| |*Color*|1|ds.color.0|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `FF465C`.| |*Draw*|0|ds.type.0|0 - *(default)* Line;<br>1 - Points;<br>2 - Staircase;<br>3 - Bar.| |*Width*|0|ds.width.0|Valid values range from 1-10.<br><br>Default: 1.<br><br>Parameter *Width* not available if *Draw* is set to "Points" or "Bar".| |*Point size*|0|ds.pointsize.0|Valid values range from 1-10.<br><br>Default: 3.<br><br>Parameter *Point size* not available if *Draw* is set to "Line", "Staircase" or "Bar".| |*Transparency*|0|ds.transparency.0|Valid values range from 1-10.<br><br>Default: 5.| |*Fill*|0|ds.fill.0|Valid values range from 1-10.<br><br>Default: 3.<br><br>Parameter *Fill* not available if *Draw* is set to "Points" or "Bar".| |*Missing data*|0|ds.missingdatafunc.0|0 - *(default)* None;<br>1 - Connected;<br>2 - Treat as 0.<br><br>Parameter *Missing data* not available if *Draw* is set to "Points" or "Bar".| |*Y-axis*|0|ds.axisy.0|0 - *(default)* Left;<br>1 - Right.| |*Time shift*|1|ds.timeshift.0|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes). Negative values are also allowed.<br><br>Default: `""` (empty).| |*Aggregation function*|0|ds.aggregate_function.0|0 - *(default)* none;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Aggregation interval*|1|ds.aggregate_interval.0|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes).<br><br>Default: `1h`.| |*Aggregate*|0|ds.aggregate_grouping.0|0 - *(default)* Each item;<br>1 - Data set.<br><br>Parameter *Aggregate* not available if *Aggregation function* is set to "none".| #### データセット *データセット*の設定には、以下のパラメータがサポートされています。 ::: noteclassic プロパティ名の最初の数字（例：ds.hosts.0.0、ds.items.0.0）は特定のデータセットを表し、2番目の数字（存在する場合）は設定されたホストまたはアイテムを表します。 ::: |パラメータ|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |***ホストパターン***<br>(必須)|1|ds.hosts.0.0|[ホスト](/manual/api/reference/host/get) の名前またはパターン（例：`Zabbix*`）| |***アイテムパターン***<br>(必須)|1|ds.items.0.0|[アイテム](/manual/api/reference/item/get) の名前またはパターン (例: `*: 1 秒あたりの処理済み値の数`)| |*色*|1|ds.color.0|16 進数カラーコード (例: `FF0000`)<br><br>デフォルト: `FF465C`| |*描画*|0|ds.type.0|0 - *(デフォルト)* 線<br>1 - ポイント<br>2 - 階段<br>3 - バー| |*幅*|0|ds.width.0|有効な値の範囲は 1～10 です。<br><br>デフォルト: 1<br><br>*描画* が"ポイント"または"バー"に設定されている場合、パラメーター *幅* は使用できません。| |*ポイント サイズ*|0|ds.pointsize.0|有効な値の範囲は 1～10 です。<br><br>デフォルト: 3<br><br>パラメータ *ポイント サイズ* は、*描画* が"線"、"階段"、または"バー"に設定されている場合は使用できません。| |*透明度*|0|ds.transparency.0|有効な値の範囲は 1～10 です。<br><br>デフォルト: 5| |*塗りつぶし*|0|ds.fill.0|有効な値の範囲は 1～10 です。<br><br>デフォルト: 3<br><br>パラメータ *塗りつぶし* は、*描画* が"ポイント"または"バー"に設定されている場合は使用できません。| |*欠損データ*|0|ds.missingdatafunc.0|0 - *(デフォルト)* なし;<br>1 - 連結;<br>2 - 0として扱います。<br><br>パラメータ *欠損データ* は、*Draw* が"ポイント"または"バー"に設定されている場合は使用できません。| |*Y軸*|0|ds.axisy.0|0 - *(デフォルト)* 左;<br>1 - 右| |*時間シフト*|1|ds.timeshift.0|有効な時間文字列（例：`3600`、`1h` など）<br>[時間サフィックス](/manual/appendix/suffixes#time-suffixes) を使用できます。負の値も使用できます。<br><br>デフォルト: `""` (空)| |*集計関数*|0|ds.aggregate_function.0|0 - *(デフォルト)* なし;<br>1 - 最小;<br>2 - 最大;<br>3 - 平均;<br>4 - カウント;<br>5 - 合計;<br>6 - 最初;<br>7 - 最後| |*集計間隔*|1|ds.aggregate_interval.0|有効な時間文字列 (例: `3600`、`1h` など)<br>[時間サフィックス](/manual/appendix/suffixes#time-suffixes) を使用できます。<br><br>デフォルト: `1h`| |*Aggregate*|0|ds.aggregate_grouping.0|0 - *(デフォルト)* 各項目<br>1 - データ セット<br><br>*Aggregation function* が "none" に設定されている場合、パラメーター *Aggregate* は使用できません。| #### Data types The Zabbix API supports the following data types as input: |Type|Description| |--|--------| |boolean|A boolean value, accepts either `true` or `false`.| |flag|The value is considered to be `true` if it is passed and not equal to `null`; otherwise, it is considered to be `false`.| |integer|A whole number.| |float|A floating point number.| |string|A text string.| |text|A longer text string.| |timestamp|A Unix timestamp.| |array|An ordered sequence of values, that is, a plain array.| |object|An associative array.| |query|A value which defines, what data should be returned.<br><br>Can be defined as an array of property names to return only specific properties, or as one of the predefined values:<br>`extend` - returns all object properties;<br>`count` - returns the number of retrieved records, supported only by certain subselects.| ::: noteimportant Zabbix API always returns values as strings or arrays only. ::: #### データ型 Zabbix APIは、以下のデータ型を入力としてサポートしています。 |型|説明| |--|--------| |boolean|ブール値。`true`または`false`のいずれかを受け入れます。| |flag|渡された値は、`null`と等しくない場合に`true`とみなされ、そうでない場合は`false`とみなされます。| |integer|整数。| |float|浮動小数点数。| |string|テキスト文字列。| |text|より長いテキスト文字列。| |timestamp|Unixタイムスタンプ。| |array|順序付けられた値のシーケンス、つまり単純な配列。| |object|連想配列。| |query|返されるデータを定義する値。<br><br>特定のプロパティのみを返すプロパティ名の配列として定義するか、定義済みの値のいずれかとして定義できます。<br>`extend` - すべてのオブジェクトプロパティを返します。<br>`count` - 取得したレコードの数を返します。特定のサブセレクトでのみサポートされます。| ::: noteimportant Zabbix APIは常に文字列または配列としてのみ値を返します。 ::: ### DB schema update A new column *name_upper* has been added to the database table **items**. The column contains a capitalized version of the item name or the LLD rule name. This change has been implemented to allow the use of the index with case-insensitive search for API query [optimization](#optimized-api-queries). ### DBスキーマの更新 新しいカラム*name_upper*がデータベースのテーブル**items**に追加されました。カラムには、アイテム名またはLLDルール名の大文字バージョンが設定されます。この変更は、APIクエリ[最適化](#optimized-api-queries)の大文字と小文字を区別しない検索でインデックスを使用できるようにするために実装されました。 # dcheck.get # dcheck.get ### Debian/Ubuntu Open the `/etc/apt/sources.list.d/zabbix.list` and uncomment "Zabbix unstable repository". # Zabbix unstable repository deb https://repo.zabbix.com/zabbix/5.5/debian bullseye main deb-src https://repo.zabbix.com/zabbix/5.5/debian bullseye main ### Debian/Ubuntu `/etc/apt/sources.list.d/zabbix.list`を開き、"Zabbix unstable repository"下のコメントを外します。 # Zabbix unstable repository deb https://repo.zabbix.com/zabbix/5.5/debian bullseye main deb-src https://repo.zabbix.com/zabbix/5.5/debian bullseye main ### Debug Debug information of executed webhook script. The debug object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |logs|array|Array of [log entries](/manual/api/reference/script/object#Log entry).| |ms|string|Script execution duration in milliseconds.| ### デバッグ 実行されたwebhookスクリプトのデバッグ情報。 デバッグオブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |logs|array|[ログエントリ](/manual/api/reference/script/object#Log entry)の配列| |ms|string|スクリプトの実行時間(ミリ秒単位)| #### Debugging Java gateway In case there are any problems with Java gateway or an error message that you see about an item in the frontend is not descriptive enough, you might wish to take a look at Java gateway log file. By default, Java gateway logs its activities into /tmp/zabbix\_java.log file with log level "info". Sometimes that information is not enough and there is a need for information at log level "debug". In order to increase logging level, modify file lib/logback.xml and change the level attribute of <root> tag to "debug": <root level="debug"> <appender-ref ref="FILE" /> </root> Note that unlike Zabbix server or Zabbix proxy, there is no need to restart Zabbix Java gateway after changing logback.xml file - changes in logback.xml will be picked up automatically. When you are done with debugging, you can return the logging level to "info". If you wish to log to a different file or a completely different medium like database, adjust logback.xml file to meet your needs. See [Logback Manual](http://logback.qos.ch/manual/) for more details. Sometimes for debugging purposes it is useful to start Java gateway as a console application rather than a daemon. To do that, comment out PID\_FILE variable in settings.sh. If PID\_FILE is omitted, startup.sh script starts Java gateway as a console application and makes Logback use lib/logback-console.xml file instead, which not only logs to console, but has logging level "debug" enabled as well. Finally, note that since Java gateway uses SLF4J for logging, you can replace Logback with the framework of your choice by placing an appropriate JAR file in lib directory. See [SLF4J Manual](http://www.slf4j.org/manual.html) for more details. #### Javaゲートウェイのデバッグ Javaゲートウェイに問題がある場合、またはフロントエンドのアイテムについて表示されるエラーメッセージが十分でない場合は、Javaゲートウェイのログファイルを確認することをお勧めします。 デフォルトでは、Javaゲートウェイはそのアクティビティを/tmp/zabbix\_java.logファイルにログレベル"info"で記録します。その情報だけでは不十分な場合、ログレベル"debug"の情報を取得する必要があります。ログレベルを上げるには、lib/logback.xmlファイルを変更し、<root>タグのlevel属性を"debug"に変更します。 <root level="debug"> <appender-ref ref="FILE" /> </root> ZabbixサーバーやZabbixプロキシとは異なり、logback.xmlファイルを変更した後にZabbix Javaゲートウェイを再起動する必要はありません。logback.xmlの変更は自動的に取得されます。デバッグが完了したら、ログレベルを"info"に戻すことができます。 別のファイルまたはデータベースのようなまったく別のメディアにログを記録する場合は、必要に応じてlogback.xmlファイルを調整します。 詳細については、[Logback Manual](http://logback.qos.ch/manual/)を参照してください。 デバッグ目的の場合、デーモンではなくコンソールアプリケーションとしてJavaゲートウェイを起動すると便利な場合があります。これを行うには、settings.shでPID\_FILE変数をコメントアウトします。PID\_FILEを省略した場合、startup.shスクリプトはJavaゲートウェイをコンソールアプリケーションとして起動し、代わりにLogbackにlib/logback-console.xmlファイルを使用させます。これにより、コンソールにログが記録されるだけでなく、ログ レベル"debug"も有効になります。 最後に、JavaゲートウェイはロギングにSLF4Jを使用するため、適切なJARファイルをlibディレクトリに配置することで、Logbackを選択したフレームワークに置き換えることができます。詳細については、[SLF4J Manual](http://www.slf4j.org/manual.html)を参照してください。 #### Debugging Java gateway Zabbix Java gateway log file is: /var/log/zabbix/zabbix_java_gateway.log If you like to increase the logging, edit the file: /etc/zabbix/zabbix_java_gateway_logback.xml and change `level="info"` to "debug" or even "trace" (for deep troubleshooting): <configuration scan="true" scanPeriod="15 seconds"> [...] <root level="info"> <appender-ref ref="FILE" /> </root> </configuration> #### Javaゲートウェイのデバッグ Zabbix Javaゲートウェイのログファイルは次のとおりです。 /var/log/zabbix/zabbix_java_gateway.log ログの内容を増やしたい場合は、下記ファイルを編集します。 /etc/zabbix/zabbix_java_gateway_logback.xml `level="info"`を"debug"または"trace"に変更します (詳細なトラブルシューティング用): <configuration scan="true" scanPeriod="15 seconds"> [...] <root level="info"> <appender-ref ref="FILE" /> </root> </configuration> #### Debugging Java gateway Zabbix Java gateway log file is: /var/log/zabbix/zabbix_java_gateway.log If you like to increase the logging, edit the file: /etc/zabbix/zabbix_java_gateway_logback.xml and change `level="info"` to "debug" or even "trace" (for deep troubleshooting): <configuration scan="true" scanPeriod="15 seconds"> [...] <root level="info"> <appender-ref ref="FILE" /> </root> </configuration> #### Java ゲートウェイのデバッグ Zabbix Java ゲートウェイのログ ファイルは次のとおりです。 /var/log/zabbix/zabbix_java_gateway.log ログの内容を増やしたい場合は次のファイルを編集します。 /etc/zabbix/zabbix_java_gateway_logback.xml `level="info"` を "debug" または "trace" に変更します (詳細なトラブルシューティング用)。 <configuration scan="true" scanPeriod="15 seconds"> [...] <root level="info"> <appender-ref ref="FILE" /> </root> </configuration> #### Debugging Java gateway Zabbix Java gateway log file is: /var/log/zabbix/zabbix_java_gateway.log If you like to increase the logging, edit the file: /etc/zabbix/zabbix_java_gateway_logback.xml and change `level="info"` to "debug" or even "trace" (for deep troubleshooting): <configuration scan="true" scanPeriod="15 seconds"> [...] <root level="info"> <appender-ref ref="FILE" /> </root> </configuration> #### Javaゲートウェイのデバッグ Zabbix Javaゲートウェイのログファイルは次のとおりです。 /var/log/zabbix/zabbix_java_gateway.log ログの内容を増やしたい場合は、下記ファイルを編集します。 /etc/zabbix/zabbix_java_gateway_logback.xml `level="info"`を"debug"または"trace"に変更します (詳細なトラブルシューティング用): <configuration scan="true" scanPeriod="15 seconds"> [...] <root level="info"> <appender-ref ref="FILE" /> </root> </configuration> ### Default authentication By default, Zabbix uses internal Zabbix authentication for all users. It is possible to change the default method to [LDAP](#ldap_authentication) system-wide or enable LDAP authentication only for specific user groups. To set LDAP as default authentication method for all users, navigate to the *LDAP* tab and configure authentication parameters, then return to the *Authentication* tab and switch *Default authentication* selector to LDAP. Note that the authentication method can be fine-tuned on the [user group](/manual/config/users_and_usergroups/usergroup) level. Even if LDAP authentication is set globally, some user groups can still be authenticated by Zabbix. These groups must have [frontend access](/manual/config/users_and_usergroups/usergroup#configuration) set to Internal. Vice versa, if internal authentication is used globally, LDAP authentication details can be specified and used for specific user groups whose [frontend access](/manual/config/users_and_usergroups/usergroup#configuration) is set to LDAP. If a user is included into at least one user group with LDAP authentication, this user will not be able to use internal authentication method. [HTTP](#http_authentication) and [SAML 2.0](#saml_authentication) authentication methods can be used in addition to the default authentication method. ### デフォルト認証 デフォルトでは、Zabbixはすべてのユーザーに内部Zabbix認証を使用します。デフォルトの方法をシステム全体で[LDAP](#ldap_authentication)に変更したり、特定のユーザーグループに対してのみLDAP認証を有効にしたりすることもできます。 LDAPをすべてのユーザーのデフォルトの認証方法として設定するには、*LDAP*タブに移動して認証パラメーターを構成してから、*認証*タブに戻り、*デフォルト認証*セレクターをLDAPに切り替えます。 認証方法は[ユーザーグループ](/manual/config/users_and_usergroups/usergroup)レベルで微調整できることに注意してください。 LDAP認証がグローバルに設定されている場合でも、一部のユーザーグループをZabbixで認証することもできます。これらのグループでは[フロントエンドアクセス](/manual/config/users_and_usergroups/usergroup#configuration)を内部に設定する必要があります。逆に、内部認証をグローバルに使用する場合は、LDAP認証の詳細を指定して、[フロントエンドアクセス](/manual/config/users_and_usergroups/usergroup#configuration)がLDAPに設定されている特定のユーザーグループに使用できます。ユーザーが少なくともLDAP認証を使用している1つのユーザーグループに含まれている場合、このユーザーは内部認証方式を使用できません。 デフォルトの認証方法に加えて[HTTP](#http_authentication)および[SAML 2.0](#saml_authentication)認証方法を使用できます。 #### Default port numbers The following list of open ports per component is applicable for default configuration: |Zabbix component|Port number|Protocol|Type of connection| |-------|-------|-------|-------| |Zabbix agent|10050|TCP|on demand| |Zabbix agent 2|10050|TCP|on demand| |Zabbix server|10051|TCP|on demand| |Zabbix proxy|10051|TCP|on demand| |Zabbix Java gateway|10052|TCP|on demand| |Zabbix web service|10053|TCP|on demand| |Zabbix frontend|80|HTTP|on demand| |^|443|HTTPS|on demand| |Zabbix trapper|10051 |TCP| on demand| ::: noteclassic The port numbers should be open in firewall to enable Zabbix communications. Outgoing TCP connections usually do not require explicit firewall settings. ::: #### デフォルトのポート番号 次のリストは各コンポーネントのデフォルトポート番号です。 |Zabbixコンポーネント|ポート番号|プロトコル|接続の種類| |-------|-------|-------|-------| |Zabbixエージェント|10050|TCP|オンデマンド| |Zabbixエージェント2|10050|TCP|オンデマンド| |Zabbixサーバー|10051|TCP|オンデマンド| |Zabbixプロキシ|10051|TCP|オンデマンド| |Zabbix Javaゲートウェイ|10052|TCP|オンデマンド| |Zabbix Webサービス|10053|TCP|オンデマンド| |Zabbix Webインターフェース|80|HTTP|オンデマンド| |^|443|HTTPS|オンデマンド| |Zabbixトラッパー|10051|TCP|オンデマンド| ::: noteclassic Zabbix通信を有効にするには、ファイアウォールでポートを開く必要があります。通常、発信のTCP接続には明示的なファイアウォール設定は必要ありません。 ::: #### Default port numbers The following table lists default port numbers that Zabbix components listen on: |Zabbix component|Port number|Protocol|Type of connection| |-------|-------|-------|-------| |Zabbix agent|10050|TCP|on demand| |Zabbix agent 2|10050|TCP|on demand| |Zabbix server|10051|TCP|on demand| |Zabbix proxy|10051|TCP|on demand| |Zabbix Java gateway|10052|TCP|on demand| |Zabbix web service|10053|TCP|on demand| #### デフォルトのポート番号 以下の表は、Zabbixコンポーネントがlistenするデフォルトのポート番号の一覧です。 |Zabbix コンポーネント|ポート番号|プロトコル|接続方式| |-------|-------|-------|-------| |Zabbix agent|10050|TCP|on demand| |Zabbix agent 2|10050|TCP|on demand| |Zabbix server|10051|TCP|on demand| |Zabbix proxy|10051|TCP|on demand| |Zabbix Java gateway|10052|TCP|on demand| |Zabbix web service|10053|TCP|on demand| #### Default user roles By default, Zabbix is configured with four user roles, which have a pre-defined set of permissions: - Admin role - Guest role - Super admin role - User role {width="600"} ::: noteclassic Default *Super admin role* cannot be modified or deleted, because at least one Super admin user with unlimited privileges must exist in Zabbix. ::: Zabbix users with type Super admins and proper permissions can modify or delete existing roles or create new custom roles. To create a new role, click on the *Create user role* button at the top right corner. To update an existing role, press on the role name to open the configuration form.  Available permission options along with default permission sets for pre-existing user roles in Zabbix are described below. |Parameter|Description|Default user roles|<|<|<| |---------|-----------|------------------|-|-|-| | | |Super admin role|Admin role|User role|Guest role| |Name|Role visible name.|Super admin role|Admin role|User role|Guest role| |User type|Selected user type determines the list of available permissions.<br>Upon selecting a user type, all available permissions for this user type are granted by default.<br>Uncheck the checkbox(es) to revoke certain permissions for the user role.<br>Checkboxes for permissions not available for this user type are grayed out.|Super admin|Admin|User|User| |Access to UI elements|<|<|<|<|<| |*Monitoring*|<|<|<|<|<| |Dashboard|Enable/disable access to a specific Monitoring menu section and underlying pages.|Yes|Yes|Yes|Yes| |Problems|^|^|^|^|^| |Hosts|^|^|^|^|^| |Latest data|^|^|^|^|^| |Maps|^|^|^|^|^| |Discovery|^|^|^|No|No| |Services|^|^|^|Yes|Yes| |*Inventory*|<|<|<|<|<| |Overview|Enable/disable access to a specific Inventory menu section and underlying pages.|Yes|Yes|Yes|Yes| |Hosts|^|^|^|^|^| |*Reports*|<|<|<|<|<| |System information|Enable/disable access to a specific Reports menu section and underlying pages.|Yes|No|No|No| |Availability report|^|^|Yes|Yes|Yes| |Triggers top 100|^|^|^|^|^| |Audit|^|^|No|No|No| |Action log|^|^|^|^|^| |Notifications|^|^|Yes|^|^| |Scheduled reports|^|^|^|^|^| |*Configuration*|<|<|<|<|<| |Host groups|Enable/disable access to a specific *Configuration* menu section and underlying pages.|Yes|Yes|No|No| |Templates|^|^|^|^|^| |Hosts|^|^|^|^|^| |Maintenance|^|^|^|^|^| |Actions|^|^|^|^|^| |Event correlation|^|^|No|^|^| |Discovery|^|^|Yes|^|^| |*Administration*|<|<|<|<|<| |General|Enable/disable access to a specific *Administration* menu section and underlying pages.|Yes|No|No|No| |Proxies|^|^|^|^|^| |Authentication|^|^|^|^|^| |User groups|^|^|^|^|^| |User roles|^|^|^|^|^| |Users|^|^|^|^|^| |Media types|^|^|^|^|^| |Scripts|^|^|^|^|^| |Queue|^|^|^|^|^| |*Default access to new UI elements*|Enable/disable access to the custom UI elements. Modules, if present, will be listed below.|Yes|Yes|Yes|Yes| |Access to services|<|<|<|<|<| |Read-write access to services|Select read-write access to services:<br>**None** - no access at all<br>**All** - access to all services is read-write<br>**Service list** - select services for read-write access<br><br>The read-write access takes precedence over the read-only access and is dynamically inherited by the child services.|Yes|Yes|No|No| |Read-write access to services with tag|Specify tag name and, optionally, value to additionally grant read-write access to services matching the tag.<br>This option is available if 'Service list' is selected in the *Read-write access to services* parameter.<br>The read-write access takes precedence over the read-only access and is dynamically inherited by the child services.|^|^|^|^| |Read-only access to services|Select read-only access to services:<br>**None** - no access at all<br>**All** - access to all services is read-only<br>**Service list** - select services for read-only access<br><br>The read-only access does not take precedence over the read-write access and is dynamically inherited by the child services.|^|^|^|^| |Read-only access to services with tag|Specify tag name and, optionally, value to additionally grant read-only access to services matching the tag.<br>This option is available if 'Service list' is selected in the *Read-only access to services* parameter.<br>The read-only access does not take precedence over the read-write access and is dynamically inherited by the child services.|^|^|^|^| |Access to modules|<|<|<|<|<| |<Module name>|Allow/deny access to a specific module. Only enabled modules are shown in this section. It is not possible to grant or restrict access to a module that is currently disabled.|Yes|Yes|Yes|Yes| |*Default access to new modules*|Enable/disable access to modules that may be added in the future.|^|^|^|^| |Access to API|<|<|<|<|<| |*Enabled*|Enable/disable access to API.|Yes|Yes|Yes|No| |*API methods*|Select *Allow list* to allow only specified API methods or *Deny list* to restrict only specified API methods.<br><br>In the search field, start typing the method name, then select the method from the auto-complete list.<br>You can also press the Select button and select methods from the full list available for this user type. Note, that if certain action from the Access to actions block is unchecked, users will not be able to use API methods related to this action.<br><br>Wildcards are supported. Examples: `dashboard.*` (all methods of 'dashboard.' API service) `*` (any method), `*.export` (methods with '.export' name from all API services).<br><br>If no methods have been specified the Allow/Deny list rule will be ignored.|^|^|^|^| |Access to actions|<|<|<|<|<| |Create and edit dashboards|Clearing this checkbox will also revoke the rights to use `.create`, `.update` and `.delete` API methods for the corresponding elements.|Yes|Yes|Yes|No| |Create and edit maps|^|^|^|^|^| |Create and edit maintenance|^|^|^|No|^| |Add problem comments|Clearing this checkbox will also revoke the rights to perform corresponding action via `event.acknowledge` API method.|^|^|Yes|^| |Change severity|^|^|^|^|^| |Acknowledge problems|^|^|^|^|^| |Close problems|^|^|^|^|^| |Execute scripts|Clearing this checkbox will also revoke the rights to use the `script.execute` API method.|^|^|^|^| |Manage API tokens|Clearing this checkbox will also revoke the rights to use all `token.` API methods.|^|^|^|^| |Manage scheduled reports|Clearing this checkbox will also revoke the rights to use all `report.` API methods.|^|^|No|^| |Default access to new actions|Enable/disable access to new actions.|^|^|Yes|^| Notes: - Each user may have only one role assigned. - If an element is restricted, users will not be able to access it even by entering a direct URL to this element into the browser. - Users of type *User* or *Admin* cannot change their own role settings. - Users of type *Super admin* can modify settings of their own role (not available for the default *Super admin role*), but not the user type. - Users of all levels cannot change their own user type. See also: - [Configuring a user](/manual/config/users_and_usergroups/user) #### Default user roles By default, Zabbix is configured with four user roles, which have a pre-defined set of permissions: - Admin role - Guest role - Super admin role - User role {width="600"} ::: noteclassic Default *Super admin role* cannot be modified or deleted, because at least one Super admin user with unlimited privileges must exist in Zabbix. ::: Zabbix users with type Super admins and proper permissions can modify or delete existing roles or create new custom roles. To create a new role, click on the *Create user role* button at the top right corner. To update an existing role, press on the role name to open the configuration form.  Available permission options along with default permission sets for pre-existing user roles in Zabbix are described below. |Parameter|Description|Default user roles|<|<|<| |---------|-----------|------------------|-|-|-| |^|^|Super admin role|Admin role|User role|Guest role| |Name|Role visible name.|Super admin role|Admin role|User role|Guest role| |User type|Selected user type determines the list of available permissions.<br>Upon selecting a user type, all available permissions for this user type are granted by default.<br>Uncheck the checkbox(es) to revoke certain permissions for the user role.<br>Checkboxes for permissions not available for this user type are grayed out.|Super admin|Admin|User|User| |Access to UI elements|<|<|<|<|<| |*Monitoring*|<|<|<|<|<| |Dashboard|Enable/disable access to a specific Monitoring menu section and underlying pages.|Yes|Yes|Yes|Yes| |Problems|^|^|^|^|^| |Hosts|^|^|^|^|^| |Latest data|^|^|^|^|^| |Maps|^|^|^|^|^| |Discovery|^|^|^|No|No| |Services|^|^|^|Yes|Yes| |*Inventory*|<|<|<|<|<| |Overview|Enable/disable access to a specific Inventory menu section and underlying pages.|Yes|Yes|Yes|Yes| |Hosts|^|^|^|^|^| |*Reports*|<|<|<|<|<| |System information|Enable/disable access to a specific Reports menu section and underlying pages.|Yes|No|No|No| |Availability report|^|^|Yes|Yes|Yes| |Triggers top 100|^|^|^|^|^| |Audit|^|^|No|No|No| |Action log|^|^|^|^|^| |Notifications|^|^|Yes|^|^| |Scheduled reports|^|^|^|^|^| |*Configuration*|<|<|<|<|<| |Host groups|Enable/disable access to a specific *Configuration* menu section and underlying pages.|Yes|Yes|No|No| |Templates|^|^|^|^|^| |Hosts|^|^|^|^|^| |Maintenance|^|^|^|^|^| |Actions|^|^|^|^|^| |Event correlation|^|^|No|^|^| |Discovery|^|^|Yes|^|^| |*Administration*|<|<|<|<|<| |General|Enable/disable access to a specific *Administration* menu section and underlying pages.|Yes|No|No|No| |Proxies|^|^|^|^|^| |Authentication|^|^|^|^|^| |User groups|^|^|^|^|^| |User roles|^|^|^|^|^| |Users|^|^|^|^|^| |Media types|^|^|^|^|^| |Scripts|^|^|^|^|^| |Queue|^|^|^|^|^| |*Default access to new UI elements*|Enable/disable access to the custom UI elements. Modules, if present, will be listed below.|Yes|Yes|Yes|Yes| |Access to services|<|<|<|<|<| |Read-write access to services|Select read-write access to services:<br>**None** - no access at all<br>**All** - access to all services is read-write<br>**Service list** - select services for read-write access<br><br>The read-write access takes precedence over the read-only access and is dynamically inherited by the child services.|Yes|Yes|No|No| |Read-write access to services with tag|Specify tag name and, optionally, value to additionally grant read-write access to services matching the tag.<br>This option is available if 'Service list' is selected in the *Read-write access to services* parameter.<br>The read-write access takes precedence over the read-only access and is dynamically inherited by the child services.|^|^|^|^| |Read-only access to services|Select read-only access to services:<br>**None** - no access at all<br>**All** - access to all services is read-only<br>**Service list** - select services for read-only access<br><br>The read-only access does not take precedence over the read-write access and is dynamically inherited by the child services.|^|^|^|^| |Read-only access to services with tag|Specify tag name and, optionally, value to additionally grant read-only access to services matching the tag.<br>This option is available if 'Service list' is selected in the *Read-only access to services* parameter.<br>The read-only access does not take precedence over the read-write access and is dynamically inherited by the child services.|^|^|^|^| |Access to modules|<|<|<|<|<| |<Module name>|Allow/deny access to a specific module. Only enabled modules are shown in this section. It is not possible to grant or restrict access to a module that is currently disabled.|Yes|Yes|Yes|Yes| |*Default access to new modules*|Enable/disable access to modules that may be added in the future.|^|^|^|^| |Access to API|<|<|<|<|<| |*Enabled*|Enable/disable access to API.|Yes|Yes|Yes|No| |*API methods*|Select *Allow list* to allow only specified API methods or *Deny list* to restrict only specified API methods.<br><br>In the search field, start typing the method name, then select the method from the auto-complete list.<br>You can also press the Select button and select methods from the full list available for this user type. Note, that if certain action from the Access to actions block is unchecked, users will not be able to use API methods related to this action.<br><br>Wildcards are supported. Examples: `dashboard.*` (all methods of 'dashboard.' API service) `*` (any method), `*.export` (methods with '.export' name from all API services).<br><br>If no methods have been specified the Allow/Deny list rule will be ignored.|^|^|^|^| |Access to actions|<|<|<|<|<| |Create and edit dashboards|Clearing this checkbox will also revoke the rights to use `.create`, `.update` and `.delete` API methods for the corresponding elements.|Yes|Yes|Yes|No| |Create and edit maps|^|^|^|^|^| |Create and edit maintenance|^|^|^|No|^| |Add problem comments|Clearing this checkbox will also revoke the rights to perform corresponding action via `event.acknowledge` API method.|^|^|Yes|^| |Change severity|^|^|^|^|^| |Acknowledge problems|^|^|^|^|^| |Close problems|^|^|^|^|^| |Execute scripts|Clearing this checkbox will also revoke the rights to use the `script.execute` API method.|^|^|^|^| |Manage API tokens|Clearing this checkbox will also revoke the rights to use all `token.` API methods.|^|^|^|^| |Manage scheduled reports|Clearing this checkbox will also revoke the rights to use all `report.` API methods.|^|^|No|^| |Default access to new actions|Enable/disable access to new actions.|^|^|Yes|^| Notes: - Each user may have only one role assigned. - If an element is restricted, users will not be able to access it even by entering a direct URL to this element into the browser. - Users of type *User* or *Admin* cannot change their own role settings. - Users of type *Super admin* can modify settings of their own role (not available for the default *Super admin role*), but not the user type. - Users of all levels cannot change their own user type. See also: - [Configuring a user](/manual/config/users_and_usergroups/user) #### Default user roles By default, Zabbix is configured with four user roles, which have a pre-defined set of permissions: - Admin role - Guest role - Super admin role - User role {width="600"} The list of all users assigned the respective role is displayed. The users included in disabled groups are stated in red. ::: noteclassic Default *Super admin role* cannot be modified or deleted, because at least one Super admin user with unlimited privileges must exist in Zabbix. ::: Zabbix users with type Super admins and proper permissions can modify or delete existing roles or create new custom roles. To create a new role, click on the *Create user role* button at the top right corner. To update an existing role, press on the role name to open the configuration form.  Available permission options along with default permission sets for pre-configured user roles in Zabbix are described below. | | | | | | | | |-|----------|--------------------------------------|----|----|----|----| |**Parameter**|<|**Description**|**Default user roles**|<|<|<| | |<|<|*Super admin role*|*Admin role*|*User role*|*Guest role*| |User type|<|Selected user type determines the list of available permissions.<br>Upon selecting a user type, all available permissions for this user type are granted by default.<br>Uncheck the checkbox(es) to revoke certain permissions for the user role.<br>Checkboxes for permissions not available for this user type are grayed out.|Super admin|Admin|User|User| |**Access to UI elements**|<|<|<|<|<|<| |*Monitoring*|<|<|<|<|<|<| | |Dashboard|Enable/disable access to a specific Monitoring menu section and underlying pages.|Yes|Yes|Yes|Yes| |^|Problems|^|^|^|^|^| |^|Hosts|^|^|^|^|^| |^|Latest data|^|^|^|^|^| |^|Maps|^|^|^|^|^| |^|Discovery|^|^|^|No|No| |*Services*|<|<|<|<|<|<| | |Services|Enable/disable access to a specific Services menu section and underlying pages.|Yes|Yes|Yes|Yes| |^|Service actions|^|^|^|No|No| |^|SLA|^|^|^|^|^| |^|SLA report|^|^|^|Yes|Yes| |*Inventory*|<|<|<|<|<|<| | |Overview|Enable/disable access to a specific Inventory menu section and underlying pages.|Yes|Yes|Yes|Yes| |^|Hosts|^|^|^|^|^| |*Reports*|<|<|<|<|<|<| | |System information|Enable/disable access to a specific Reports menu section and underlying pages.|Yes|No|No|No| |^|Availability report|^|^|Yes|Yes|Yes| |^|Triggers top 100|^|^|^|^|^| |^|Audit|^|^|No|No|No| |^|Action log|^|^|^|^|^| |^|Notifications|^|^|Yes|^|^| |^|Scheduled reports|^|^|^|^|^| |*Configuration*|<|<|<|<|<|<| | |Host groups|Enable/disable access to a specific *Configuration* menu section and underlying pages.|Yes|Yes|No|No| |^|Templates|^|^|^|^|^| |^|Hosts|^|^|^|^|^| |^|Maintenance|^|^|^|^|^| |^|Actions|^|^|^|^|^| |^|Event correlation|^|^|No|^|^| |^|Discovery|^|^|Yes|^|^| |*Administration*|<|<|<|<|<|<| | |General|Enable/disable access to a specific *Administration* menu section and underlying pages.|Yes|No|No|No| |^|Proxies|^|^|^|^|^| |^|Authentication|^|^|^|^|^| |^|User groups|^|^|^|^|^| |^|User roles|^|^|^|^|^| |^|Users|^|^|^|^|^| |^|Media types|^|^|^|^|^| |^|Scripts|^|^|^|^|^| |^|Queue|^|^|^|^|^| |*Default access to new UI elements*|<|This option specifies how new menu sections will be accessible after a Zabbix upgrade. Existing menu sections of modules remain unaffected.|Yes|Yes|Yes|Yes| |**Access to services**|<|<|<|<|<|<| | |Read-write access to services|Select read-write access to services:<br>**None** - no access at all<br>**All** - access to all services is read-write<br>**Service list** - select services for read-write access<br><br>The read-write access, if granted, takes precedence over the read-only access settings and is dynamically inherited by the child services.|All|All|None|None| |^|Read-write access to services with tag|Specify tag name and, optionally, value to additionally grant read-write access to services matching the tag.<br>This option is available if 'Service list' is selected in the *Read-write access to services* parameter.<br>The read-write access, if granted, takes precedence over the read-only access settings and is dynamically inherited by the child services.|^|^|^|^| |^|Read-only access to services|Select read-only access to services:<br>**None** - no access at all<br>**All** - access to all services is read-only<br>**Service list** - select services for read-only access<br><br>The read-only access does not take precedence over the read-write access and is dynamically inherited by the child services.|^|^|All|All| |^|Read-only access to services with tag|Specify tag name and, optionally, value to additionally grant read-only access to services matching the tag.<br>This option is available if 'Service list' is selected in the *Read-only access to services* parameter.<br>The read-only access does not take precedence over the read-write access and is dynamically inherited by the child services.|^|^|^|^| |**Access to modules**|<|<|<|<|<|<| | |<Module name>|Allow/deny access to a specific module. Only enabled modules are shown in this section. It is not possible to grant or restrict access to a module that is currently disabled.|Yes|Yes|Yes|Yes| |^|*Default access to new modules*|This option specifies how new modules and widgets will be accessible after a Zabbix upgrade. It also applies to modules and widgets added in the *Administration > General > Modules section*.|^|^|^|^| |**Access to API**|<|<|<|<|<|<| | |*Enabled*|Enable/disable access to API.|Yes|Yes|Yes|No| |^|*API methods*|Select *Allow list* to allow only specified API methods or *Deny list* to restrict only specified API methods.<br><br>In the search field, start typing the method name, then select the method from the auto-complete list.<br>You can also press the Select button and select methods from the full list available for this user type. Note that if certain action from the Access to actions block is unchecked, users will not be able to use API methods related to this action.<br><br>Wildcards are supported. Examples: `dashboard.*` (all methods of 'dashboard.' API service) `*` (any method), `*.export` (methods with '.export' name from all API services).<br><br>If no methods have been specified the Allow/Deny list rule will be ignored.|^|^|^|^| |**Access to actions**|<|<|<|<|<|<| | |Create and edit dashboards|Clearing this checkbox will also revoke the rights to use `.create`, `.update` and `.delete` API methods for the corresponding elements.|Yes|Yes|Yes|No| |^|Create and edit maps|^|^|^|^|^| |^|Create and edit maintenance|^|^|^|No|^| |^|Add problem comments|Clearing this checkbox will also revoke the rights to perform corresponding action via `event.acknowledge` API method.|^|^|Yes|^| |^|Change severity|^|^|^|^|^| |^|Acknowledge problems|^|^|^|^|^| |^|Close problems|^|^|^|^|^| |^|Execute scripts|Clearing this checkbox will also revoke the rights to use the `script.execute` API method.|^|^|^|^| |^|Manage API tokens|Clearing this checkbox will also revoke the rights to use all `token.` API methods.|^|^|^|^| |^|Manage scheduled reports|Clearing this checkbox will also revoke the rights to use all `report.` API methods.|^|^|No|^| |^|Manage SLA|Enable/disable the rights to manage [SLA](/manual/web_interface/frontend_sections/services/sla).|^|^|^|^| |^|Default access to new actions|This option specifies how new actions will be accessible after a Zabbix upgrade.|^|^|Yes|^| Notes: - Each user may have only one role assigned. - If an element is restricted, users will not be able to access it even by entering a direct URL to this element into the browser. - Users of type *User* or *Admin* cannot change their own role settings. - Users of type *Super admin* can modify settings of their own role (not available for the default *Super admin role*), but not the user type. - Users of all levels cannot change their own user type. See also: - [Configuring a user](/manual/config/users_and_usergroups/user) #### デフォルトユーザーロール デフォルトではZabbixは事前定義された権限のセットを持つ4つのユーザーロールで設定されています。 - Admin role - Guest role - Super admin role - User role {width="600"} ::: noteclassic Zabbixには無制限の権限を持つ特権管理者ユーザーが少なくとも1人存在する必要があるため、デフォルトの*Super admin role*を変更または削除することはできません。 ::: 特権管理者権限を持つZabbixユーザーは、既存のロールを変更または削除したり、新しいカスタムロールを作成したりできます。 新しい役割を作成するには、右上隅にある*ユーザーの役割の作成*ボタンをクリックします。既存の役割を更新するには、役割名を押して構成フォームを開きます。  Zabbixで事前設定されたユーザーロールのデフォルト権限セットとともに使用可能な権限オプションを以下に説明します。 |パラメータ|説明|デフォルトユーザーロール|<|<|<| |---------|-----------|------------------|-|-|-| | | |Super admin role|Admin role|User role|Guest role| |名前|ロールの表示名|Super admin role|Admin role|User role|Guest role| |ユーザーの種類|選択したユーザータイプによって、使用可能な権限のリストが決まります。<br>ユーザータイプを選択すると、このユーザータイプで使用可能なすべての権限がデフォルトで付与されます。<br>チェックボックスをオフにすると、ユーザーロールの特定の権限が取り消されます。< br>このユーザータイプで使用できない権限のチェックボックスはグレー表示されます。|Super admin|Admin|User|User| |UI要素へのアクセス|<|<|<|<|<| |*監視データ*|<|<|<|<|<| |ダッシュボード|特定の監視メニューセクションと基になるページへのアクセスを有効/無効にします。|Yes|Yes|Yes|Yes| |障害|^|^|^|^|^| |ホスト|^|^|^|^|^| |最新データ|^|^|^|^|^| |マップ|^|^|^|^|^| |ディスカバリ|^|^|^|No|No| |*サービス*|<|<|<|<|<| |サービス|特定のサービスメニューセクションと基になるページへのアクセスを有効/無効にします。|Yes|Yes|Yes|Yes| |サービスアクション|^|^|^|No|No| |SLA|^|^|^|^|^| |SLAレポート|^|^|^|Yes|Yes| |*インベントリ*|<|<|<|<|<| |概要|特定のインベントリメニューセクションと基になるページへのアクセスを有効/無効にします。|Yes|Yes|Yes|Yes| |ホスト|^|^|^|^|^| |*レポート*|<|<|<|<|<| |システム情報|特定のレポートメニューセクションと基になるページへのアクセスを有効/無効にします。|Yes|No|No|No| |稼働レポート|^|^|Yes|Yes|Yes| |障害発生数上位100項目|^|^|^|^|^| |監査|^|^|No|No|No| |アクションログ|^|^|^|^|^| |通知レポート|^|^|Yes|^|^| |定期レポート|^|^|^|^|^| |*設定*|<|<|<|<|<| |ホストグループ|特定の*設定*メニューセクションと基になるページへのアクセスを有効/無効にします。|Yes|Yes|No|No| |テンプレート|^|^|^|^|^| |ホスト|^|^|^|^|^| |メンテナンス|^|^|^|^|^| |アクション|^|^|^|^|^| |イベント相関関係|^|^|No|^|^| |ディスカバリ|^|^|Yes|^|^| |*管理*|<|<|<|<|<| |一般設定|特定の*管理*メニューセクションと基になるページへのアクセスを有効/無効にします。|Yes|No|No|No| |プロキシ|^|^|^|^|^| |認証|^|^|^|^|^| |ユーザーグループ|^|^|^|^|^| |ユーザーの役割|^|^|^|^|^| |ユーザー|^|^|^|^|^| |メディアタイプ|^|^|^|^|^| |スクリプト|^|^|^|^|^| |キュー|^|^|^|^|^| |*デフォルトで新しいUI要素にアクセス*|カスタムUI要素へのアクセスを有効/無効にします。モジュールが存在する場合は、以下にリストされます。|Yes|Yes|Yes|Yes| |サービスへのアクセス|<|<|<|<|<| |サービスの表示/設定|読み取り/書き込み可能なサービスを選択します：<br>**なし** - アクセスなし<br>**すべて** - すべてのサービスへ読み取り/書き込み可能<br>**サービスのリスト** - 読み取り/書き込みアクセス用のサービスを選択します<br><br>読み取り/書き込みアクセスが許可されている場合、読み取り専用アクセス設定よりも優先され、子サービスによって動的に継承されます。|All|All|None|None| |タグとサービスの表示/設定|タグ名とオプションで値を指定して、タグに一致するサービスへの読み取り/書き込みアクセスを追加で許可します。<br>このオプションは、*サービスへの読み取り/書き込みアクセス*パラメーターで*サービスリスト*が選択されている場合に使用できます。<br>読み取り/書き込みアクセスが許可されている場合、読み取り専用アクセス設定よりも優先され、子サービスによって動的に継承されます。|^|^|^|^| |サービスの表示のみ|表示のみのサービスを選択します。<br>**なし** - アクセスなし<br>**すべて** - 全てのサービスは表示のみ<br>**サービスのリスト** - 表示のみのサービスを選択する。<br><br>表示のみは読み取り/書き込みアクセスよりも優先されず、子サービスによって動的に継承されます。|^|^|All|All| |タグとサービスの表示のみ|タグ名とオプションで値を指定して、タグに一致する表示のみのサービスを追加します。<br>このオプションは、*サービスの表示のみ*パラメーターで*サービスリスト*が選択されている場合に使用できます。<br>表示のみは読み取り/書き込みアクセスよりも優先されず、子サービスによって動的に継承されます。|^|^|^|^| |モジュールへのアクセス|<|<|<|<|<| |<モジュール名>|特定のモジュールへのアクセスを許可/拒否します。このセクションには、有効なモジュールのみが表示されます。現在無効になっているモジュールへのアクセスを許可または制限することはできません。|Yes|Yes|Yes|Yes| |*デフォルトで新しいモジュールに対してアクセス*|追加されたモジュールへのアクセスをデフォルトで有効/無効にします。|^|^|^|^| |APIへのアクセス|<|<|<|<|<| |*有効*|APIへのアクセスを有効/無効にします。|Yes|Yes|Yes|No| |*APIメソッド*|*リストを許可*を選択して指定したAPIメソッドのみを許可するか、*リストを拒否*を選択して指定したAPIメソッドのみを制限します。<br><br>検索フィールドでメソッド名の入力を開始し、オートコンプリートリストからメソッドを選択します。 。<br>または*選択*ボタンを押して、このユーザータイプで使用可能なリストからメソッドを選択することもできます。 *アクションへのアクセス*ブロックの特定のアクションがオフになっている場合、ユーザーはこのアクションに関連するAPIメソッドを使用できないことに注意してください。<br><br>ワイルドカードがサポートされています。例:`dashboard.*`（'dashboard.'APIサービスのすべてのメソッド） `*`（任意のメソッド）、`*.export`（すべてのAPIサービスの' .export'名のメソッド）<br><br >メソッドが指定されていない場合、許可/拒否リストルールは無視されます。|^|^|^|^| |アクションへのアクセス|<|<|<|<|<| |ダッシュボードの作成と変更|このチェックボックスをオフにすると、対応する要素に対して `.create`,` .update`および`.delete`APIメソッドを使用する権限も取り消されます。|Yes|Yes|Yes|No| |マップの作成と変更|^|^|^|^|^| |メンテナンス機関の作成と変更|^|^|^|No|^| |障害対応メッセージの追加|このチェックボックスをオフにすると、`event.acknowledge`APIメソッドを介して対応するアクションを実行する権限も取り消されます。|^|^|Yes|^| |深刻度の変更|^|^|^|^|^| |障害の確認|^|^|^|^|^| |障害のクローズ|^|^|^|^|^| |スクリプトの実行|このチェックボックスをオフにすると、`script.execute`APIメソッドを使用する権限も取り消されます。|^|^|^|^| |APIトークンの管理|このチェックボックスをオフにすると、すべての`token.`APIメソッドを使用する権限も取り消されます。|^|^|^|^| |定期レポートの管理|このチェックボックスをオフにすると、すべての`report.`APIメソッドを使用する権限も取り消されます。|^|^|No|^| |SLAの管理|[SLA](/manual/web_interface/frontend_sections/services/sla)を管理する権限を有効/無効にします。|^|^|^|^| |デフォルトで新しいアクションに対してアクセス|新しいアクションへのアクセスをデフォルトで有効/無効にします。|^|^|Yes|^| 情報: - 各ユーザーには、1つの役割のみを割り当てることができます。 - 要素が制限されている場合、ユーザーはこの要素への直接URLをブラウザに入力してもその要素にアクセスできません。 - タイプ*User*または*Admin*のユーザーは、自分の役割設定を変更できません。 - タイプ*特権管理者*のユーザーは、自分のロールの設定を変更できますがユーザータイプは変更できません。（ただしデフォルトの*特権管理者ロール*では変更できません） - すべてのレベルのユーザーは、自分のユーザータイプを変更することはできません。 - [ユーザーの設定](/manual/config/users_and_usergroups/user)も参照 ### Default values for Zabbix agent 2 Zabbix agent 2 plugins now allow to define default values for connecting to monitoring targets in the configuration file. If no value is specified in an item key or a named session, the plugin will use the value defined in the corresponding default parameter. New parameters have the structure `Plugins.<PluginName>.Default.<Parameter>` - for example, `Plugins.MongoDB.Default.Uri=tcp://localhost:27017`. See for more info: - [Configuring plugins](/manual/config/items/plugins#configuring-plugins) - [Plugin configuration file parameters](/manual/appendix/config/zabbix_agent2_plugins) ### Zabbixエージェント2のデフォルト値 Zabbixエージェント2プラグインで、監視対象へ接続するためのデフォルト値を設定ファイルで定義できるようになりました。 アイテムキーや名前付きセッションで、値が何も指定されていない場合、プラグインは対応するデフォルトパラメーターで定義された値を使用します。 新しいパラメーターは`Plugins.<PluginName>.Default.<Parameter>` という構造になります。例えば、`Plugins.MongoDB.Default.Uri=tcp://localhost:27017`のようになります。 詳細についてはこちらのセクションをご覧ください: - [プラグインの設定](/manual/config/items/plugins#configuring-plugins) - [プラグイン設定ファイルパラメーター](/manual/appendix/config/zabbix_agent2_plugins) #### Definitions ***[host](/manual/config/hosts)*** \- *any physical or virtual device, application, service, or any other logically-related collection of monitored parameters.* ***[host group](/manual/config/hosts)*** \- *a logical grouping of hosts; it may contain hosts and templates. Hosts and templates within a host group are not in any way linked to each other. Host groups are used when assigning access rights to hosts for different user groups.* ***[item](/manual/config/items)*** \- *a particular piece of data that you want to receive from a host, a metric of data.* ***[value preprocessing](/manual/config/items/item#item_value_preprocessing)*** \- *a transformation of received metric value* before saving it to the database. ***[trigger](/manual/config/triggers)*** \- *a logical expression that defines a problem threshold and is used to "evaluate" data received in items.* When received data are above the threshold, triggers go from 'Ok' into a 'Problem' state. When received data are below the threshold, triggers stay in/return to an 'Ok' state. ***[event](/manual/config/events)*** \- *a single occurrence of something that deserves attention such as a trigger changing state or a discovery/agent autoregistration taking place.* ***[event tag](/manual/config/tagging)*** \- *a pre-defined marker for the event.* It may be used in event correlation, permission granulation, etc. ***[event correlation](/manual/config/event_correlation)*** \- *a method of correlating problems to their resolution flexibly and precisely.* For example, you may define that a problem reported by one trigger may be resolved by another trigger, which may even use a different data collection method. ***[problem](/manual/web_interface/frontend_sections/monitoring/problems)*** \- *a trigger that is in "Problem" state.* ***[problem update](/manual/acknowledges#updating_problems)*** \- *problem management options provided by Zabbix, such as adding comment, acknowledging, changing severity or closing manually.* ***[action](/manual/config/notifications/action)*** \- *a predefined means of reacting to an event.* An action consists of operations (e.g. sending a notification) and conditions (*when* the operation is carried out) ***[escalation](/manual/config/notifications/action/escalations)*** \- *a custom scenario for executing operations within an action; a sequence of sending notifications/executing remote commands.* ***[media](/manual/config/notifications/media)*** \- *a means of delivering notifications; delivery channel.* ***[notification](/manual/config/notifications/action/operation/message)*** \- *a message about some event sent to a user via the chosen media channel.* ***[remote command](/manual/config/notifications/action/operation/remote_command)*** \- *a pre-defined command that is automatically executed on a monitored host upon some condition.* ***[template](/manual/config/templates)*** \- *a set of entities (items, triggers, graphs, low-level discovery rules, web scenarios) ready to be applied to one or several hosts.* The job of templates is to speed up the deployment of monitoring tasks on a host; also to make it easier to apply mass changes to monitoring tasks. Templates are linked directly to individual hosts. ***[web scenario](/manual/web_monitoring)*** \- *one or several HTTP requests to check the availability of a web site.* ***[frontend](/manual/introduction/overview#architecture)*** \- *the web interface provided with Zabbix.* ***[dashboard](/manual/web_interface/frontend_sections/monitoring/dashboard)*** \- *customizable section of the web interface displaying summaries and visualizations* of important information in visual units called widgets. ***[widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)*** \- *visual unit displaying information of a certain kind and source* (a summary, a map, a graph, the clock, etc.), used in the dashboard. ***[Zabbix API](/manual/api)*** \- *Zabbix API allows you to use the JSON RPC protocol to create, update and fetch Zabbix objects (like hosts, items, graphs and others) or perform any other custom tasks.* ***[Zabbix server](/manual/concepts/server)*** \- *a central process of Zabbix software that performs monitoring, interacts with Zabbix proxies and agents, calculates triggers, sends notifications; a central repository of data.* ***[Zabbix proxy](/manual/concepts/proxy)*** \- *a process that may collect data on behalf of Zabbix server, taking some processing load from the server.* ***[Zabbix agent](/manual/concepts/agent)*** \- *a process deployed on monitoring targets to actively monitor local resources and applications.* ***[Zabbix agent 2](/manual/concepts/agent2)*** \- *a new generation of Zabbix agent to actively monitor local resources and applications, allowing to use custom plugins for monitoring.* ::: noteimportant Because Zabbix agent 2 shares much functionality with Zabbix agent, the term "Zabbix agent" in documentation stands for both - Zabbix agent and Zabbix agent 2, if the functional behavior is the same. Zabbix agent 2 is only specifically named where its functionality differs. ::: ***[encryption](/manual/encryption)*** \- *support of encrypted communications between Zabbix components (server, proxy, agent, zabbix\_sender and zabbix\_get utilities)* using Transport Layer Security (TLS) protocol. ***[network discovery](/manual/discovery/network_discovery)*** \- *automated discovery of network devices*. ***[low-level discovery](/manual/discovery/low_level_discovery)*** \- *automated discovery of low-level entities on a particular device* (e.g. file systems, network interfaces, etc). ***[low-level discovery rule](/manual/discovery/low_level_discovery#discovery_rule)*** \- *set of definitions for automated discovery of low-level entities* on a device. ***[item prototype](/manual/discovery/low_level_discovery#item_prototypes)*** \- *a metric with certain parameters as variables, ready for low-level discovery*. After low-level discovery the variables are automatically substituted with the real discovered parameters and the metric automatically starts gathering data. ***[trigger prototype](/manual/discovery/low_level_discovery#trigger_prototypes)*** \- *a trigger with certain parameters as variables, ready for low-level discovery*. After low-level discovery the variables are automatically substituted with the real discovered parameters and the trigger automatically starts evaluating data. *Prototypes* of some other Zabbix entities are also in use in low-level discovery - graph prototypes, host prototypes, host group prototypes. ***[agent autoregistration](/manual/discovery/auto_registration)*** \- *automated process whereby a Zabbix agent itself is registered* as a host and started to monitor. #### 定義 ***[ホスト](/manual/config/hosts)*** \- *物理または仮想デバイスやアプリケーション、サービス、またはその他の監視対象パラメーターの論理的に関連するコレクション。* ***[ホストグループ](/manual/config/hosts)*** \- *論理的なホストの集まりです; ホストグループには、ホストとテンプレートが含まれます。ホストグループ内のホストとテンプレートは、互いにリンクされていません。ホストグループは、様々なユーザーグループにホストへのアクセス権を与える際に使用されます。* ***[アイテム](/manual/config/items)*** \- *ホストから受信したい特定のデータ、データのメトリクスです。* ***[値の保存前処理](/manual/config/items/item#item_value_preprocessing)*** \- データベースに保存する前に、*受信したメトリクス値を変換*します。 ***[トリガー](/manual/config/triggers)*** \- *障害の閾値を定義し、アイテムとして取得したデータを評価するために使用される論理式です。* 取得したデータが閾値を超えた場合、トリガーの状態は「OK」から「障害」に変わります。取得したデータが閾値を超えていない場合は、トリガーの状態は「OK」のまま、あるいは「OK」に戻ります。 ***[イベント](/manual/config/events)*** \- *トリガーの状態が変化したり、ディスカバリやエージェントの自動登録が実行されるなど、注意すべき何かが発生したことを示します。* ***[イベントタグ](/manual/config/tagging)*** \- *イベントに対して事前に定義された印。* イベントの相関関係や権限の細分化などに使用できます。 ***[イベントの相関関係](/manual/config/event_correlation)*** \- *発生した障害をそれらの解決策に柔軟にかつ正確に関連付ける方法です。* 例えば、あるトリガーが別のデータ収集方法を使用した別のトリガーによって解決するようなトリガーを定義するかもしれません。 ***[障害](/manual/web_interface/frontend_sections/monitoring/problems)*** \- *トリガーによって「障害」の状態を示します。* ***[障害の更新](/manual/acknowledges#updating_problems)*** \- *Zabbixでは、発生した障害の管理オプションとして、コメントを追加したり、確認済にしたり、深刻度を変更したり、手動でクローズしたりすることができます。* ***[アクション](/manual/config/notifications/action)*** \- *発生したイベントに反応して行う処理を事前に定義したものです。* アクションは、操作（通知の処理など）と条件（処理が実行される*時*）で構成されます。 ***[エスカレーション](/manual/config/notifications/action/escalations)*** \- *アクション内で操作を実行するためのカスタムシナリオで、通知の送信やリモートコマンド実行などの一連の処理の流れです。* ***[メディア](/manual/config/notifications/media)*** \- *通知を配信する手段、つまり配信チャネルです。* ***[通知](/manual/config/notifications/action/operation/message)*** \- *選択したメディアチャネルを使用してユーザーに送信されるイベントに関するメッセージです。* ***[リモートコマンド](/manual/config/notifications/action/operation/remote_command)*** \- *ある状態になった時に監視しているホスト上で自動的に実行するための事前に定義したコマンドです。* ***[テンプレート](/manual/config/templates)*** \- *1つまたは複数のホストに対して適用できるよう用意されたエンティティ（アイテム、トリガー、グラフ、ダッシュボード、ローレベルディスカバリのルール、Web監視設定）のセットです。* テンプレートの役割は、ホストへの監視設定の展開を高速化するためにあります。また、監視設定の大量の変更を簡単に適用できるようにします。そして、テンプレートは、個別のホストに直接リンクされています。 ***[Webシナリオ](/manual/web_monitoring)*** \- *Webサイトの可用性を確認するための1つまたは複数のHTTPリクエストです。* ***[Webインターフェース](/manual/introduction/overview#architecture)*** \- *Zabbixによって提供されるWebインターフェースです。* ***[ダッシュボード](/manual/web_interface/frontend_sections/monitoring/dashboard)*** \- ウィジェットと呼ばれる表示用部品を使用して*Webインターフェース上に要約や視覚化できるようカスタマイズ*します。 ***[ウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)*** \- *ダッシュボード内で使用できる*特定のものと情報ソースの情報*（要約、マップ、グラフ、時計など）を表示する表示用の部品です。 ***[Zabbix API](/manual/api)*** \- *Zabbix APIを使うことで、JSON RPCプロトコルでZabbix上の情報（ホスト、アイテム、グラフなど）を作成、更新、情報取得したり、その他のタスク処理を行うことができます。* ***[Zabbixサーバー](/manual/concepts/server)*** \- *監視を行うために、ZabbixプロキシやZabbixエージェントと通信し、トリガーの条件式を判断し、通知の処理を行ったりするZabbixのソフトウェアの中でも中心となるプロセスです。データを集約する中心の機能となります。* ***[Zabbixプロキシ](/manual/concepts/proxy)*** \- *Zabbixサーバーに代わってデータを収集し、Zabbixサーバーの処理の負荷を軽減するプロセスです。* ***[Zabbixエージェント](/manual/concepts/agent)*** \- *ローカルのリソースやアプリケーションを能動的に監視するために、監視対象上で起動されるプロセスです。* ***[Zabbixエージェント2](/manual/concepts/agent2)*** \- *ローカルのリソースとアプリケーションを能動的に監視する新世代のZabbixエージェントです。監視のためにカスタムプラグインを使用することができます。* ::: noteimportant Zabbixエージェント2は、Zabbixエージェントと多くの機能を共有しています。ドキュメントに記載されている「Zabbixエージェント」という用語は、同じ機能が用意されている場合は、ZabbixエージェントとZabbixエージェント2の両方を指します。Zabbixエージェント2は、異なる機能である場合にのみ、具体的に名前を記載するようにしています。 ::: ***[暗号化](/manual/encryption)*** \- TLSプロトコルを使用して、*Zabbixの各コンポーネント（server、proxy、agent、zabbix\_sender、zabbix\_get などのユーティリティ）間は暗号化することができます。* ***[ネットワークディスカバリ](/manual/discovery/network_discovery)*** \- *ネットワークデバイスの自動的なディスカバリ機能です。* ***[ローレベルディスカバリ](/manual/discovery/low_level_discovery)*** \- *特定のデバイス上の詳細なエンティティ（ファイルシステム、ネットワークインターフェースなど）の自動的なディスカバリ機能です。* ***[ローレベルディスカバリルール](/manual/discovery/low_level_discovery#ディスカバリルール)*** \- デバイス上の*自動的なローレベルディスカバリ処置の定義です。* ***[アイテムのプロトタイプ](/manual/discovery/low_level_discovery#item_prototypes)*** \- *変数として特定のパラメーターを持ちローレベルディスカバリで使用されるメトリクスです。* ローレベルディスカバリ後に、変数は実際にディスカバリされたパラメーターに自動的に置き換えられます。そして、自動的にそのメトリクスデータの収集を開始します。 ***[トリガーのプロトタイプ](/manual/discovery/low_level_discovery#trigger_prototypes)*** \- *変数として特定のパラメーターを持ちローレベルディスカバリで使用されるトリガーです。*ローレベルディスカバリ後に、変数は実際にディスカバリされたパラメーターに置き換えられます。そして、自動的にそのトリガーによってデータの評価を開始します。 他のローレベルディスカバリで使用される*プロトタイプ*としては、グラフのプロトタイプ、ホストのプロトタイプ、ホストグループのプロトタイプがあります。 ***[エージェントによる自動登録](/manual/discovery/auto_registration)*** \- *Zabbixエージェント自身で登録する自動化されたプロセス*によってホストとして登録されて監視が開始されます。 #### Delete a host interface Delete the host interface with ID 30062. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.delete", "params": [ "30062" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### ホストインターフェースの削除 ID 30062のホストインターフェースを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "hostinterface.delete", "params": [ "30062" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Delete multiple actions Delete two actions. Request: ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### 複数のアクションの削除 2つのアクションを削除します。 リクエスト : ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス : ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### Delete multiple correlations Delete two correlations. Request: ```json { "jsonrpc": "2.0", "method": "correlation.delete", "params": [ "1", "2" ], "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1", "2" ] }, "id": 1 } ``` #### 複数の相関関係の削除 2つの相関関係を削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "correlation.delete", "params": [ "1", "2" ], "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1", "2" ] }, "id": 1 } ``` #### Delete multiple discovery rules Delete two discovery rules. Request: ```json { "jsonrpc": "2.0", "method": "drule.delete", "params": [ "4", "6" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "4", "6" ] }, "id": 1 } ``` #### 複数のディスカバリルールの削除 2つのディスカバリルールを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "drule.delete", "params": [ "4", "6" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "4", "6" ] }, "id": 1 } ``` #### Delete multiple icon maps Delete two icon maps. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.delete", "params": [ "2", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2", "5" ] }, "id": 1 } ``` #### 複数のアイコンマップの削除 2つのアイコンマップを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "iconmap.delete", "params": [ "2", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2", "5" ] }, "id": 1 } ``` #### Delete multiple images Delete two images. Request: ```json { "jsonrpc": "2.0", "method": "image.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188", "192" ] }, "id": 1 } ``` #### 複数の画像の削除 2つの画像を削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "image.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188", "192" ] }, "id": 1 } ``` #### Delete multiple maps Delete two maps. Request: ```json { "jsonrpc": "2.0", "method": "map.delete", "params": [ "12", "34" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "12", "34" ] }, "id": 1 } ``` #### 複数のマップの削除 2つのマップを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "map.delete", "params": [ "12", "34" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "12", "34" ] }, "id": 1 } ``` #### Delete multiple proxies Delete two proxies. Request: ```json { "jsonrpc": "2.0", "method": "proxy.delete", "params": [ "10286", "10285" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10286", "10285" ] }, "id": 1 } ``` #### 複数のプロキシの削除 2つのプロキシを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "proxy.delete", "params": [ "10286", "10285" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10286", "10285" ] }, "id": 1 } ``` #### Delete multiple scripts Delete two scripts. Request: ```json { "jsonrpc": "2.0", "method": "script.delete", "params": [ "3", "4" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3", "4" ] }, "id": 1 } ``` #### 複数のスクリプトの削除 2つのスクリプトを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "script.delete", "params": [ "3", "4" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3", "4" ] }, "id": 1 } ``` #### Delete multiple tokens Delete two tokens. Request: ```json { "jsonrpc": "2.0", "method": "token.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188", "192" ] }, "id": 1 } ``` #### 複数のトークンの削除 2つのトークンを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "token.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188", "192" ] }, "id": 1 } ``` #### Delete multiple triggers Delete two triggers. Request: ```json { "jsonrpc": "2.0", "method": "trigger.delete", "params": [ "12002", "12003" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### 複数のトリガーの削除 2つのトリガーを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "trigger.delete", "params": [ "12002", "12003" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### Deleting dependencies from multiple triggers Delete all dependencies from two triggers. Request: ```json { "jsonrpc": "2.0", "method": "trigger.deleteDependencies", "params": [ { "triggerid": "14544" }, { "triggerid": "14545" } ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "14544", "14545" ] }, "id": 1 } ``` #### 複数のトリガーからの依存関係の削除 2 つのトリガーからすべての依存関係を削除します Request: ```json { "jsonrpc": "2.0", "method": "trigger.deleteDependencies", "params": [ { "triggerid": "14544" }, { "triggerid": "14545" } ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "14544", "14545" ] }, "id": 1 } ``` #### Deleting multiple dashboards Delete two dashboards. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2", "3" ] }, "id": 1 } ``` #### 複数のダッシュボードの削除 2つのダッシュボードを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "dashboard.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2", "3" ] }, "id": 1 } ``` #### Deleting multiple global macros Delete two global macros. Request: ```json { "jsonrpc": "2.0", "method": "usermacro.deleteglobal", "params": [ "32", "11" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "32", "11" ] }, "id": 1 } ``` #### 複数のグローバルマクロの削除 2つのグローバルマクロを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "usermacro.deleteglobal", "params": [ "32", "11" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "32", "11" ] }, "id": 1 } ``` #### Deleting multiple global regular expressions. Request: ```json { "jsonrpc": "2.0", "method": "regexp.delete", "params": [ "16", "17" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16", "17" ] }, "id": 1 } ``` #### 複数のグローバル正規表現の削除 リクエスト: ```json { "jsonrpc": "2.0", "method": "regexp.delete", "params": [ "16", "17" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16", "17" ] }, "id": 1 } ``` #### Deleting multiple graph prototypes Delete two graph prototypes. Request: ```json { "jsonrpc": "2.0", "method": "graphprototype.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### 複数のグラフプロトタイプの削除 2つのグラフプロトタイプを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "graphprototype.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Deleting multiple graphs Delete two graphs. Request: ```json { "jsonrpc": "2.0", "method": "graph.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### 複数のグラフの削除 2つのグラフを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "graph.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Deleting multiple host groups Delete two host groups. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.delete", "params": [ "107824", "107825" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107824", "107825" ] }, "id": 1 } ``` #### 複数のホストグループの削除 2つのホストグループを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "hostgroup.delete", "params": [ "107824", "107825" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107824", "107825" ] }, "id": 1 } ``` #### Deleting multiple host macros Delete two host macros. Request: ```json { "jsonrpc": "2.0", "method": "usermacro.delete", "params": [ "32", "11" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "32", "11" ] }, "id": 1 } ``` #### 複数のホストマクロの削除 2つのホストマクロを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "usermacro.delete", "params": [ "32", "11" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "32", "11" ] }, "id": 1 } ``` #### Deleting multiple host prototypes Delete two host prototypes. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.delete", "params": [ "10103", "10105" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103", "10105" ] }, "id": 1 } ``` #### 複数のホストのプロトタイプの削除 2つのホストのプロトタイプを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "hostprototype.delete", "params": [ "10103", "10105" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103", "10105" ] }, "id": 1 } ``` #### Deleting multiple hosts Delete two hosts. Request: ```json { "jsonrpc": "2.0", "method": "host.delete", "params": [ "13", "32" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "13", "32" ] }, "id": 1 } ``` #### 複数のホストの削除 2つのホストを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "host.delete", "params": [ "13", "32" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "13", "32" ] }, "id": 1 } ``` #### Deleting multiple LLD rules Delete two LLD rules. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.delete", "params": [ "27665", "27668" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "ruleids": [ "27665", "27668" ] }, "id": 1 } ``` #### 複数のLLDルールの削除 2つのLLDルールを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "discoveryrule.delete", "params": [ "27665", "27668" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "ruleids": [ "27665", "27668" ] }, "id": 1 } ``` #### Deleting multiple maintenance periods Delete two maintenance periods. Request: ```json { "jsonrpc": "2.0", "method": "maintenance.delete", "params": [ "3", "1" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3", "1" ] }, "id": 1 } ``` #### 複数のメンテナンス期間の削除 2つのメンテナンス期間を削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "maintenance.delete", "params": [ "3", "1" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3", "1" ] }, "id": 1 } ``` #### Deleting multiple media types Delete two media types. Request: ```json { "jsonrpc": "2.0", "method": "mediatype.delete", "params": [ "3", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "3", "5" ] }, "id": 1 } ``` #### 複数のメディアタイプの削除 2つのメディアタイプを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "mediatype.delete", "params": [ "3", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "3", "5" ] }, "id": 1 } ``` #### Deleting multiple scheduled reports Delete two scheduled reports. Request: ```json { "jsonrpc": "2.0", "method": "report.delete", "params": [ "1", "2" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1", "2" ] }, "id": 1 } ``` #### 複数の定期レポートの削除 2つの定期レポートの削除 リクエスト: ```json { "jsonrpc": "2.0", "method": "report.delete", "params": [ "1", "2" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1", "2" ] }, "id": 1 } ``` #### Deleting multiple services Delete two services. Request: ```json { "jsonrpc": "2.0", "method": "service.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "4", "5" ] }, "id": 1 } ``` #### 複数のサービスの削除 2つのサービスを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "service.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "4", "5" ] }, "id": 1 } ``` #### Deleting multiple SLAs Delete two SLA entries. Request: ```json { "jsonrpc": "2.0", "method": "sla.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "4", "5" ] }, "id": 1 } ``` #### 複数のSLAの削除 2つのSLAエントリを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "sla.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "4", "5" ] }, "id": 1 } ``` #### Deleting multiple template dashboards Delete two template dashboards. Request: ```json { "jsonrpc": "2.0", "method": "templatedashboard.delete", "params": [ "45", "46" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "45", "46" ] }, "id": 1 } ``` #### 複数のテンプレートダッシュボードの削除 2つのテンプレートダッシュボードを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "templatedashboard.delete", "params": [ "45", "46" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "45", "46" ] }, "id": 1 } ``` #### Deleting multiple templates Delete two templates. Request: ```json { "jsonrpc": "2.0", "method": "template.delete", "params": [ "13", "32" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "13", "32" ] }, "id": 1 } ``` #### 複数のテンプレートの削除 2つのテンプレートを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "template.delete", "params": [ "13", "32" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "13", "32" ] }, "id": 1 } ``` #### Deleting multiple trigger prototypes Delete two trigger prototypes. Request: ```json { "jsonrpc": "2.0", "method": "triggerprototype.delete", "params": [ "12002", "12003" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### 複数のトリガープロトタイプの削除 2つのトリガープロトタイプを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "triggerprototype.delete", "params": [ "12002", "12003" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### Deleting multiple user groups Delete two user groups. Request: ```json { "jsonrpc": "2.0", "method": "usergroup.delete", "params": [ "20", "21" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20", "21" ] }, "id": 1 } ``` #### 複数のユーザーグループの削除 2つのユーザーグループを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "usergroup.delete", "params": [ "20", "21" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20", "21" ] }, "id": 1 } ``` #### Deleting multiple user roles Delete two user roles. Request: ```json { "jsonrpc": "2.0", "method": "role.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "4", "5" ] }, "id": 1 } ``` #### 複数のユーザーの役割の削除 2つのユーザーの役割を削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "role.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "4", "5" ] }, "id": 1 } ``` #### Deleting multiple users Delete two users. Request: ```json { "jsonrpc": "2.0", "method": "user.delete", "params": [ "1", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userids": [ "1", "5" ] }, "id": 1 } ``` #### 複数のユーザーの削除 2つのユーザーを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "user.delete", "params": [ "1", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "userids": [ "1", "5" ] }, "id": 1 } ``` #### Deleting multiple value maps Delete two value maps. Request: ```json { "jsonrpc": "2.0", "method": "valuemap.delete", "params": [ "1", "2" ], "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1", "2" ] }, "id": 1 } ``` #### 複数のバリューマップの削除 2つのバリューマップを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "valuemap.delete", "params": [ "1", "2" ], "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1", "2" ] }, "id": 1 } ``` #### Deleting multiple web scenarios Delete two web scenarios. Request: ```json { "jsonrpc": "2.0", "method": "httptest.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "2", "3" ] }, "id": 1 } ``` #### 複数のWebシナリオの削除 2つのWebシナリオを削除します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "httptest.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "2", "3" ] }, "id": 1 } ``` ##### Deny specific check - Blacklist a specific check with DenyKey parameter. Matching keys will be disallowed. All non-matching keys will be allowed, except system.run\[\] items. For example: # Deny secure data access DenyKey=vfs.file.contents[/etc/passwd,*] ::: noteimportant A blacklist may not be a good choice, because a new Zabbix version may have new keys that are not explicitly restricted by the existing configuration. This could cause a security flaw. ::: ##### 特定のチェックを拒否する - DenyKeyパラメータで特定のチェックをブラックリスト化します。一致するキーは許可されません。一致しないキーは すべて許可されます。ただし、system.run\[\] 項目を除きます。 例えば: # セキュアデータアクセスを拒否する DenyKey=vfs.file.contents[/etc/passwd,*] ::: noteimportant Zabbixの新しいバージョンでは、既存の設定で明示的に制限されていない新しいキーが使用される可能性があるため、<br> ブラックリストは良い選択とは言えないかもしれません。これはセキュリティ上の欠陥を引き起こす可能性があります。 ::: ##### Deny specific command, allow others - Blacklist a specific command with DenyKey parameter. Whitelist all other commands, with the AllowKey parameter. ```{=html} <!-- --> ``` # Disallow specific command DenyKey=system.run[ls -l /] # Allow other scripts AllowKey=system.run[*] ##### 特定のコマンドを拒否し、他のコマンドを許可する - 特定のコマンドをブラックリスト化するには、DenyKeyパラメータを使用します。AllowKey パラメータを使用して、 他のすべてのコマンドをホワイトリストに登録します。 ```{=html} <!-- --> ``` # 特定のコマンドを許可しない DenyKey=system.run[ls -l /] # 他のスクリプトを許可する AllowKey=system.run[*] ##### Dependent item prototype Create an item prototype with "Dependent item" type in this LLD rule. As master item for this prototype select the `ipmi.get` item we created.  Note the use of the {\#SENSOR\_ID} macro in the item prototype name and key: - *Name*: IPMI value for sensor {\#SENSOR\_ID} - *Key*: ipmi\_sensor\[{\#SENSOR\_ID}\] As type of information, *Numeric (unsigned)*. In the item prototype "Preprocessing" tab select JSONPath and use the following JSONPath expression as parameter: $.[?(@.id=='{#SENSOR_ID}')].value.first()  When discovery starts, one item per each IPMI sensor will be created. This item will return the integer value of the given sensor. ##### 依存アイテムのプロトタイプ このLLDルールで"依存アイテム"タイプのアイテムのプロトタイプを作成します。 このプロトタイプのマスターアイテムとして、作成した`ipmi.get`アイテムを選択します。  アイテムのプロトタイプ名とキーで{\#SENSOR\_ID}マクロが使用されていることに注意してください。 - *名前*: IPMI value for sensor {\#SENSOR\_ID} - *キー*: ipmi\_sensor\[{\#SENSOR\_ID}\] データ型として*数値（整数）* アイテムのプロトタイプの"保存前処理"タブでJSONPathを選択し、次のJSONPath式をパラメーターとして使用します。 $.[?(@.id=='{#SENSOR_ID}')].value.first()  ディスカバリが開始されると、IPMIセンサーごとに1つのアイテムが作成されます。 このアイテムは、指定されたセンサーの整数値を返します。 ##### Dependent item prototype Create an item prototype with "Dependent item" type in this LLD rule. As master item for this prototype select the `vfs.fs.get` item we created.  Note the use of custom macros in the item prototype name and key: - *Name*: Free disk space on {\#FSNAME}, type: {\#FSTYPE} - *Key*: Free\[{\#FSNAME}\] As type of information, use: - *Numeric (unsigned)* for metrics like 'free', 'total', 'used' - *Numeric (float)* for metrics like 'pfree', 'pused' (percentage) In the item prototype "Preprocessing" tab select JSONPath and use the following JSONPath expression as parameter: $.[?(@.fsname=='{#FSNAME}')].bytes.free.first()  When discovery starts, one item per each mountpoint will be created. This item will return the number of free bytes for the given mountpoint. ##### 依存アイテムのプロトタイプ このLLDルールで"依存アイテム"タイプのアイテムプロトタイプを作成します。 このプロトタイプのマスターアイテムとして、作成した`vfs.fs.get`アイテムを選択します。  アイテムのプロトタイプ名とキーでカスタムマクロが使用されていることに注意してください。 - *Name*: Free disk space on {\#FSNAME}, type: {\#FSTYPE} - *Key*: Free\[{\#FSNAME}\] 情報の種類として、次を使用します。 - *数値 (整数)* 次のメトリックの場合 'free', 'total', 'used' - *数値 (浮動小数)* 次のメトリックの場合 'pfree', 'pused' (percentage) アイテムのプロトタイプの"保存前処理"タブで、JSONPathを選択し、次のJSONPath式をパラメーターとして使用します。 $.[?(@.fsname=='{#FSNAME}')].bytes.free.first()  検出されるとマウントポイントごとに1つのアイテムが作成されます。 この項目は、指定されたマウントポイントの空きバイト数を返します。 ##### Dependent LLD rule Create a low-level discovery rule as "Dependent item" type:  As master item select the `vfs.fs.get` item we created. In the "LLD macros" tab define custom macros with the corresponding JSONPath:  ##### 依存LLDルール "依存アイテム"タイプとしてローレベルディスカバリルールを作成します。  マスターアイテムとして、作成した`vfs.fs.get`アイテムを選択します。 "LLDマクロ"タブで、対応するJSONPathを使用してカスタムマクロを定義します。  ##### Dependent LLD rule Create a low-level discovery rule as "Dependent item" type:  As master item select the `ipmi.get` item we created. In the "LLD macros" tab define a custom macro with the corresponding JSONPath:  ##### 依存LLDルール "依存アイテム"タイプとしてローレベルディスカバリルールを作成します。  マスターアイテムとして作成した`ipmi.get`アイテムを選択します。 "LLDマクロ"タブで対応するJSONPathを使用してカスタムマクロを定義します。  ##### Deprecated internal items for history/trends The following internal items are now deprecated and will be removed in a future major release: - `zabbix[history]` - `zabbix[history_log]` - `zabbix[history_str]` - `zabbix[history_text]` - `zabbix[history_uint]` - `zabbix[trends]` - `zabbix[trends_uint]` ##### 履歴/トレンドの非推奨内部item 以下の内部itemは非推奨となり、将来のメジャーリリースで削除される予定です。 - `zabbix[history]` - `zabbix[history_log]` - `zabbix[history_str]` - `zabbix[history_text]` - `zabbix[history_uint]` - `zabbix[trends]` - `zabbix[trends_uint]` Deprecated widgets: - [Data overview](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/data_overview) 非推奨のウィジェット： - [データの概要](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/data_overview) ### Description `array configuration.importcompare(object parameters)` This method allows to compare import file with current system elements and shows what will be changed if this import file will be imported. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `array configuration.importcompare(object parameters)` このメソッドは、インポートファイルを現在のシステム要素と比較し、このインポートファイルがインポートされる場合に何が変更されるかを表示することができます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `boolean configuration.import(object parameters)` This method allows to import configuration data from a serialized string. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `boolean configuration.import(object parameters)` このメソッドは、シリアル化された文字列から設定データをインポートすることができます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array action.get(object parameters)` The method allows to retrieve actions according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array action.get(object parameters)` このメソッドは、指定したパラメーターに応じたアクションを取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array alert.get(object parameters)` The method allows to retrieve alerts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array alert.get(object parameters)` このメソッドは、指定されたパラメーターに従ってアラートを取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array auditlog.get(object parameters)` The method allows to retrieve audit log records according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array auditlog.get(object parameters)` このメソッドは、与えられたパラメーターに従って監査ログレコードを取得することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array correlation.get(object parameters)` The method allows to retrieve correlations according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array correlation.get(object parameters)` このメソッドは、指定したパラメーターに応じた相関関係を取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array dashboard.get(object parameters)` The method allows to retrieve dashboards according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array dashboard.get(object parameters)` このメソッドは、指定したパラメーターに応じたダッシュボードを取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array dcheck.get(object parameters)` The method allows to retrieve discovery checks according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array dcheck.get(object parameters)` このメソッドは、指定したパラメーターに応じたディスカバリチェックを取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array dhost.get(object parameters)` The method allows to retrieve discovered hosts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array dhost.get(object parameters)` このメソッドは、指定したパラメーターに応じた検出されたホストを取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array discoveryrule.get(object parameters)` The method allows to retrieve LLD rules according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array discoveryrule.get(object parameters)` このメソッドでは、指定されたパラメーターに従ってLLDルールを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array drule.get(object parameters)` The method allows to retrieve discovery rules according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array drule.get(object parameters)` このメソッドは、指定したパラメーターに応じたディスカバリールールを取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array dservice.get(object parameters)` The method allows to retrieve discovered services according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array dservice.get(object parameters)` このメソッドは、指定したパラメーターに応じた検出されたサービスを取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array event.get(object parameters)` The method allows to retrieve events according to the given parameters. ::: noteimportant This method may return events of a deleted entity if these events have not been removed by the housekeeper yet. ::: ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array event.get(object parameters)` このメソッドは、指定したパラメーターに応じたイベントを取得できます。 ::: noteimportant このメソッドは、削除されたイベントがまだハウスキーパーによって削除されていない場合、削除されたエンティティのイベントを返す場合があります。 ::: ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array graph.get(object parameters)` The method allows to retrieve graphs according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array graph.get(object parameters)` このメソッドは、指定したパラメーターに応じたグラフを取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array graphitem.get(object parameters)` The method allows to retrieve graph items according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array graphitem.get(object parameters)` このメソッドは、指定したパラメーターに応じたグラフアイテムを取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array graphprototype.get(object parameters)` The method allows to retrieve graph prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array graphprototype.get(object parameters)` このメソッドは、与えられたパラメータに従って、グラフの graph prototypes を取得することができます ::: noteclassic このメソッドは、どのタイプのユーザーでも利用可能です。このメソッドを呼び出す許可は、ユーザーロール設定で取り消すことができます。<br> 詳しくは、[User roles](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array hanode.get(object parameters)` The method allows to retrieve a list of High availability cluster nodes according to the given parameters. ::: noteclassic This method is only available to *Super admin* user types. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array hanode.get(object parameters)` このメソッドは、指定されたパラメーターに従って High availability cluster node のリストを取得することができます。 ::: noteclassic このメソッドは、*Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、ユーザーロール設定で取り消すことができます。<br> 詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array host.get(object parameters)` The method allows to retrieve hosts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array host.get(object parameters)` このメソッドは、与えられたパラメータにしたがってホストを取得することができます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array hostgroup.get(object parameters)` The method allows to retrieve host groups according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array hostgroup.get(object parameters)` このメソッドは、与えられたパラメータに従って、host group を取得することができます。 ::: noteclassic このメソッドは、どのタイプのユーザーでも利用可能です。このメソッドを呼び出す許可は、ユーザーのロール設定で<br> 取り消すことができます。詳しくは[User roles](/manual/web_interface/frontend_sections/administration/user_roles)をご覧ください。 ::: ### Description `integer/array hostinterface.get(object parameters)` The method allows to retrieve host interfaces according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array hostinterface.get(object parameters)` このメソッドを使用では、指定されたパラメーターに従ってホストインターフェイスを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で 取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array hostprototype.get(object parameters)` The method allows to retrieve host prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array hostprototype.get(object parameters)` このメソッドでは、指定されたパラメーターを基にホストプロトタイプを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で 取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array httptest.get(object parameters)` The method allows to retrieve web scenarios according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array httptest.get(object parameters)` このメソッドを使用すると、指定されたパラメーターに従ってWebシナリオを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array iconmap.get(object parameters)` The method allows to retrieve icon maps according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array iconmap.get(object parameters)` このメソッドでは、指定されたパラメーターに従ってアイコンマップを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で 取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array image.get(object parameters)` The method allows to retrieve images according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array image.get(object parameters)` このメソッドでは、指定されたパラメーターに従って画像を取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で 取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array item.get(object parameters)` The method allows to retrieve items according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array item.get(object parameters)` このメソッドを使用すると、指定されたパラメーターに従ってアイテムを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array itemprototype.get(object parameters)` The method allows to retrieve item prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array itemprototype.get(object parameters)` このメソッドを使用すると、指定されたパラメーターに従ってアイテムのプロトタイプを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array maintenance.get(object parameters)` The method allows to retrieve maintenances according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array maintenance.get(object parameters)` このメソッドで、指定されたパラメーターに従ってメンテナンスを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array map.get(object parameters)` The method allows to retrieve maps according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array map.get(object parameters)` このメソッドで、指定されたパラメーターに従ってマップを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array problem.get(object parameters)` The method allows to retrieve problems according to the given parameters. This method is for retrieving unresolved problems. It is also possible, if specified, to additionally retrieve recently resolved problems. The period that determines how old is "recently" is defined in *Administration* → *[General](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)*. Problems that were resolved prior to that period are not kept in the problem table. To retrieve problems that were resolved further back in the past, use the [event.get](/manual/api/reference/event/get) method. ::: noteimportant This method may return problems of a deleted entity if these problems have not been removed by the housekeeper yet. ::: ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array problem.get(object parameters)` このメソッドで、指定されたパラメーターに従って障害を取得できます。 このメソッドは、未解決の障害を取得するためのものです。指定されている場合は、最近解決された障害を追加で取得することもできます。 "最近"の古さを決定する期間は、*管理*→* [一般設定](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)*で定義されています。 その期間より前に解決された障害は、障害テーブルに保持されません。 過去にさらに解決された障害を取得するには、[event.get](/manual/api/reference/event/get)メソッドを使用します。 ::: noteimportant これらの障害がハウスキーパーによってまだ削除されていない場合、このメソッドは削除済みの障害を返す可能性があります。 ::: ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array proxy.get(object parameters)` The method allows to retrieve proxies according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array proxy.get(object parameters)` このメソッドで、指定されたパラメーターに従ってプロキシを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array regexp.get(object parameters)` The method allows to retrieve global regular expressions according to the given parameters. ::: noteclassic This method is available only to *Super Admin*. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array regexp.get(object parameters)` このメソッドで、指定されたパラメーターに従ってグローバル正規表現を取得できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array report.get(object parameters)` The method allows to retrieve scheduled reports according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array report.get(object parameters)` このメソッドで、指定されたパラメーターに従ってスケジュールされたレポートを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array role.get(object parameters)` The method allows to retrieve roles according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array role.get(object parameters)` このメソッドで、指定されたパラメーターに従ってロールを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array script.get(object parameters)` The method allows to retrieve scripts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array script.get(object parameters)` このメソッドで、指定されたパラメーターに従ってスクリプトを取得できます。 ::: noteclassic すべての`get`メソッドに共通するこれらのパラメーターについては[リファレンス解説](/manual/api/reference_commentary#common_get_method_parameters)ページで詳しく説明されています。 ::: ### Description `integer/array service.get(object parameters)` The method allows to retrieve services according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array service.get(object parameters)` このメソッドで、指定されたパラメーターに従ってサービスを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array sla.get(object parameters)` The method allows to retrieve SLA objects according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array sla.get(object parameters)` このメソッドを使用すると、指定されたパラメーターに従ってSLAオブジェクトを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array task.get(object parameters)` The method allows to retrieve tasks according to the given parameters. Method returns details only about 'diagnostic information' tasks. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array task.get(object parameters)` このメソッドを使用すると、指定されたパラメーターに従ってタスクを取得できます。 メソッドは'診断情報'タスクに関する詳細のみを返します。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array templatedashboard.get(object parameters)` The method allows to retrieve template dashboards according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array templatedashboard.get(object parameters)` このメソッドで、指定されたパラメーターに従ってテンプレート ダッシュボードを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array template.get(object parameters)` The method allows to retrieve templates according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array template.get(object parameters)` このメソッドで、指定されたパラメーターに従ってテンプレートを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array token.get(object parameters)` The method allows to retrieve tokens according to the given parameters. ::: noteclassic Only *Super admin* user type is allowed to view tokens for other users. ::: ### 説明 `integer/array token.get(object parameters)` このメソッドでは、指定されたパラメーターに従ってトークンを取得できます。 ::: noteclassic *Super admin*ユーザータイプのみが他のユーザーのトークンを表示できます。 ::: ### Description `integer/array trend.get(object parameters)` The method allows to retrieve trend data according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array trend.get(object parameters)` このメソッドでは、指定されたパラメーターを基にトレンドデータを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で 取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array trigger.get(object parameters)` The method allows to retrieve triggers according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array trigger.get(object parameters)` このメソッドは、指定したパラメーターに応じたトリガーを取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array triggerprototype.get(object parameters)` The method allows to retrieve trigger prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array triggerprototype.get(object parameters)` このメソッドは、指定したパラメーターに応じたトリガーのプロトタイプを取得できます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array user.get(object parameters)` The method allows to retrieve users according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array user.get(object parameters)` このメソッドを使用すると、指定されたパラメーターに従ってユーザー情報を取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array usergroup.get(object parameters)` The method allows to retrieve user groups according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array usergroup.get(object parameters)` このメソッドでは、指定されたパラメーターに従ってユーザーグループを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で 取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array usermacro.get(object parameters)` The method allows to retrieve host and global macros according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array usermacro.get(object parameters)` このメソッドを使用すると、指定されたパラメーターに従ってホストマクロとグローバルマクロを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `integer/array valuemap.get(object parameters)` The method allows to retrieve value maps according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `integer/array valuemap.get(object parameters)` このメソッドでは、指定されたパラメーターに従ってバリューマップを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で 取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object action.create(object/array actions)` This method allows to create new actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object action.create(object/array actions)` このメソッドは、新しいアクションを作成することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object action.delete(array actionIds)` This method allows to delete actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object action.delete(array actionIds)` このメソッドは、アクションを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object action.update(object/array actions)` This method allows to update existing actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object action.update(object/array actions)` このメソッドは、既存のアクションを更新することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object authentication.get(object parameters)` The method allows to retrieve authentication object according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object authentication.get(object parameters)` このメソッドは、指定されたパラメーターに従って認証オブジェクトを取得することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object authentication.update(object authentication)` This method allows to update existing authentication settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object authentication.update(object authentication)` このメソッドは、既存の認証設定を更新することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object autoregistration.get(object parameters)` The method allows to retrieve autoregistration object according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object autoregistration.get(object parameters)` このメソッドは、指定されたパラメーターに従って自動登録オブジェクトを取得することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object autoregistration.update(object autoregistration)` This method allows to update existing autoregistration. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object autoregistration.update(object autoregistration)` このメソッドは、既存の自動登録を更新することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object correlation.create(object/array correlations)` This method allows to create new correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object correlation.create(object/array correlations)` このメソッドは、新しい相関関係を作成することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object correlation.delete(array correlationids)` This method allows to delete correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object correlation.delete(array correlationids)` このメソッドは、相関関係を削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object correlation.update(object/array correlations)` This method allows to update existing correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object correlation.update(object/array correlations)` このメソッドは、既存の相関関係を更新することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object dashboard.create(object/array dashboards)` This method allows to create new dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object dashboard.create(object/array dashboards)` このメソッドは、新しいダッシュボードを作成することができます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object dashboard.delete(array dashboardids)` This method allows to delete dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object dashboard.delete(array dashboardids)` このメソッドは、ダッシュボードを削除することができます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object dashboard.update(object/array dashboards)` This method allows to update existing dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object dashboard.update(object/array dashboards)` このメソッドは、既存のダッシュボードを更新することができます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object discoveryrule.copy(object parameters)` This method allows to copy LLD rules with all of the prototypes to the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object discoveryrule.copy(object parameters)` このメソッドで、すべてのプロトタイプを含むLLDルールを指定されたホストにコピーできます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object discoveryrule.create(object/array lldRules)` This method allows to create new LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object discoveryrule.create(object/array lldRules)` このメソッドは、新しいLLDルールを作成することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。 詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object discoveryrule.delete(array lldRuleIds)` This method allows to delete LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object discoveryrule.delete(array lldRuleIds)` このメソッドは、LLDルールを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object discoveryrule.update(object/array lldRules)` This method allows to update existing LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object discoveryrule.update(object/array lldRules)` このメソッドで、既存のローレベルディスカバリルールを更新できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object drule.create(object/array discoveryRules)` This method allows to create new discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object drule.create(object/array discoveryRules)` このメソッドは、新しいディスカバリルールを作成することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object drule.delete(array discoveryRuleIds)` This method allows to delete discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object drule.delete(array discoveryRuleIds)` このメソッドは、ディスカバリルールを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object drule.update(object/array discoveryRules)` This method allows to update existing discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object drule.update(object/array discoveryRules)` このメソッドは、既存のディスカバリールールを更新することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object graph.create(object/array graphs)` This method allows to create new graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object graph.create(object/array graphs)` このメソッドは、新しいグラフを作成することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object graph.delete(array graphIds)` This method allows to delete graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object graph.delete(array graphIds)` このメソッドは、グラフを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object graphprototype.create(object/array graphPrototypes)` This method allows to create new graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object graphprototype.create(object/array graphPrototypes)` このメソッドに graph prototypes を作成することができます。 ::: noteclassic このメソッドは、*Admin* および *Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、<br> ユーザーロール設定で取り消すことができます。詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object graphprototype.delete(array graphPrototypeIds)` This method allows to delete graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object graphprototype.delete(array graphPrototypeIds)` このメソッドは、グラフプロトタイプを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object graphprototype.update(object/array graphPrototypes)` This method allows to update existing graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object graphprototype.update(object/array graphPrototypes)` この方法により、既存の graph prototypes を更新することができる。 ::: noteclassic このメソッドは、*Admin* および *Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、ユーザーロール設定で<br>取り消すことができます。<br> 詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object graph.update(object/array graphs)` This method allows to update existing graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object graph.update(object/array graphs)` この方法によって、既存のグラフを更新することができます。 ::: noteclassic このメソッドは、*Admin* および *Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、<br> ユーザーロール設定で取り消すことができます。詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object history.clear(array itemids)` This method allows to clear item history. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object history.clear(array itemids)` このメソッドは、アイテムのヒストリを消去することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object host.create(object/array hosts)` This method allows to create new hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object host.create(object/array hosts)` このメソッドでは、新しいホストを作成することができます。 ::: noteclassic このメソッドは、*Admin* および *Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、ユーザーロール設定で取り消すことができます。<br> 詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object host.delete(array hosts)` This method allows to delete hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object host.delete(array hosts)` このメソッドは、ホストを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object hostgroup.create(object/array hostGroups)` This method allows to create new host groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostgroup.create(object/array hostGroups)` このメソッドでは、新しいホストグループを作成することができます。 ::: noteclassic このメソッドは、*Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、<br> ユーザーロール設定で取り消すことができます。詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles) を参照してください。 ::: ### Description `object hostgroup.delete(array hostGroupIds)` This method allows to delete host groups. A host group can not be deleted if: - it contains hosts that belong to this group only; - it is marked as internal; - it is used by a host prototype; - it is used in a global script; - it is used in a correlation condition. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostgroup.delete(array hostGroupIds)` このメソッドは、ホストグループを削除することができます。 以下の場合、ホストグループを削除することはできません。 - このグループのみに属するホストが含まれている。 - 内部としてマークされている。 - ホストプロトタイプで使用されている。 - グローバルスクリプトで使用されている。 - 相関関係で使用されている。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object hostgroup.massadd(object parameters)` This method allows to simultaneously add multiple related objects to all the given host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostgroup.massadd(object parameters)` この方法では、与えられたすべての host group に、複数の関連オブジェクトを同時に追加することができます。 ::: noteclassic このメソッドは、*Admin* および *Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、<br> ユーザーロール設定で取り消すことができます。詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles) を参照してください。 ::: ### Description `object hostgroup.massremove(object parameters)` This method allows to remove related objects from multiple host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostgroup.massremove(object parameters)` このメソッドは、複数の host group から関連するオブジェクトを削除することができます。 ::: noteclassic このメソッドは、*Admin* および *Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、<br> ユーザーロール設定で取り消すことができます。詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles) を参照してください。 ::: ### Description `object hostgroup.massupdate(object parameters)` This method allows to replace hosts and templates with the specified ones in multiple host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostgroup.massupdate(object parameters)` この方法は、複数の host group において、ホストとテンプレートを指定したものに置き換えることができます。 ::: noteclassic このメソッドは、*Admin* および *Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、<br> ユーザーロール設定で取り消すことができます。詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles) を参照してください。 ::: ### Description `object hostgroup.update(object/array hostGroups)` This method allows to update existing hosts groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostgroup.update(object/array hostGroups)` このメソッドは、既存のホストグループを更新することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostinterface.create(object/array hostInterfaces)` このメソッドでは、新しいホストインターフェイスを作成できます。 ::: noteclassic このメソッドは*Admin*および*Superadmin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object hostinterface.delete(array hostInterfaceIds)` This method allows to delete host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostinterface.delete(array hostInterfaceIds)` このメソッドは、ホストインターフェースを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object hostinterface.massadd(object parameters)` This method allows to simultaneously add host interfaces to multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostinterface.massadd(object parameters)` このメソッドでは、ホストインターフェイスを複数のホストに同時に追加できます。 ::: noteclassic このメソッドは*Admin*および*Superadmin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object hostinterface.massremove(object parameters)` This method allows to remove host interfaces from the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostinterface.massremove(object parameters)` このメソッドでは、指定されたホストからホストインターフェイスを削除できます。 ::: noteclassic このメソッドは*Admin*および*Superadmin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object hostinterface.replacehostinterfaces(object parameters)` This method allows to replace all host interfaces on a given host. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostinterface.replacehostinterfaces(object parameters)` このメソッドを使用では、特定のホスト上のすべてのホストインターフェースを置き換えることができます。 ::: noteclassic このメソッドは、*Admin*および*Superadmin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object hostinterface.update(object/array hostInterfaces)` This method allows to update existing host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostinterface.update(object/array hostInterfaces)` このメソッドは、既存のホストインターフェースを更新することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object host.massadd(object parameters)` This method allows to simultaneously add multiple related objects to all the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object host.massadd(object parameters)` このメソッドでは、与えられたすべてのホストに、複数の関連オブジェクトを同時に追加することができます。 ::: noteclassic このメソッドは、*Admin* および *Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、<br> ユーザーロール設定で取り消すことができます。詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles) を参照してください。 ::: ### Description `object host.massremove(object parameters)` This method allows to remove related objects from multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object host.massremove(object parameters)` このメソッドは、複数のホストから関連するオブジェクトを削除することができます。 ::: noteclassic このメソッドは、*Admin* および *Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、<br> ユーザーロール設定で取り消すことができます。詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles) を参照してください。 ::: ### Description `object host.massupdate(object parameters)` This method allows to simultaneously replace or remove related objects and update properties on multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object host.massupdate(object parameters)` このメソッドでは、複数のホストで同時に関連するオブジェクトの交換や削除、プロパティの更新を行うことができます。 ::: noteclassic このメソッドは、*Admin* および *Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、<br> ユーザーロール設定で取り消すことができます。詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles) を参照してください。 ::: ### Description `object hostprototype.create(object/array hostPrototypes)` This method allows to create new host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostprototype.create(object/array hostPrototypes)` このメソッドでは、新しいホストプロトタイプを作成できます。 ::: noteclassic このメソッドは*Admin*および*Superadmin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object hostprototype.delete(array hostPrototypeIds)` This method allows to delete host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostprototype.delete(array hostPrototypeIds)` このメソッドは、ホストのプロトタイプを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object hostprototype.update(object/array hostPrototypes)` This method allows to update existing host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object hostprototype.update(object/array hostPrototypes)` このメソッドでは、既存のホストプロトタイプを更新できます。 ::: noteclassic このメソッドは*Admin*および*Superadmin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object host.update(object/array hosts)` This method allows to update existing hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object host.update(object/array hosts)` このメソッドは、既存のホストを更新することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object housekeeping.get(object parameters)` The method allows to retrieve housekeeping object according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object housekeeping.get(object parameters)` このメソッドは、与えられたパラメータに従って、housekeeping オブジェクトを取得することができます。 ::: noteclassic このメソッドは、どのタイプのユーザーでも利用可能です。このメソッドを呼び出す許可は、ユーザーのロール設定で<br> 取り消すことができます。詳しくは[User roles](/manual/web_interface/frontend_sections/administration/user_roles)をご覧ください。 ::: ### Description `object housekeeping.update(object housekeeping)` This method allows to update existing housekeeping settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object housekeeping.update(object housekeeping)` このメソッドでは、既存の housekeeping 設定を更新することができます。 ::: noteclassic このメソッドは、*Super admin* ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、<br> ユーザーロール設定で取り消すことができます。詳細については、[User roles](/manual/web_interface/frontend_sections/administration/user_roles) を参照してください。 ::: ### Description `object httptest.create(object/array webScenarios)` This method allows to create new web scenarios. ::: noteclassic Creating a web scenario will automatically create a set of [web monitoring items](/manual/web_monitoring/items). ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object httptest.create(object/array webScenarios)` このメソッドでは、新しいWebシナリオを作成できます。 ::: noteclassic Webシナリオを作成すると、[Webモニタリングアイテム](/manual/web_monitoring/items)のセットが自動的に作成されます。 ::: ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object httptest.delete(array webScenarioIds)` This method allows to delete web scenarios. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object httptest.delete(array webScenarioIds)` このメソッドは、Webシナリオを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object httptest.update(object/array webScenarios)` This method allows to update existing web scenarios. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object httptest.update(object/array webScenarios)` このメソッドでは、既存のWebシナリオを更新できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object iconmap.create(object/array iconMaps)` This method allows to create new icon maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object iconmap.create(object/array iconMaps)` このメソッドでは新しいアイコンマップを作成できます。 ::: noteclassic このメソッドは*Superadmin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object iconmap.delete(array iconMapIds)` This method allows to delete icon maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object iconmap.delete(array iconMapIds)` このメソッドは、アイコンマップを削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object iconmap.update(object/array iconMaps)` This method allows to update existing icon maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object iconmap.update(object/array iconMaps)` このメソッドは、既存のアイコンマップを更新することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object image.create(object/array images)` This method allows to create new images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object image.create(object/array images)` このメソッドでは、新しい画像を作成できます。 ::: noteclassic このメソッドは*Superadmin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object image.delete(array imageIds)` This method allows to delete images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object image.delete(array imageIds)` このメソッドは、画像を削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object image.update(object/array images)` This method allows to update existing images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object image.update(object/array images)` このメソッドでは、既存の画像を更新できます。 ::: noteclassic このメソッドは*Superadmin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object item.create(object/array items)` This method allows to create new items. ::: noteclassic Web items cannot be created via the Zabbix API. ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object item.create(object/array items)` このメソッドを使用すると、新しいアイテムを作成できます。 ::: noteclassic Zabbix API を介して Web アイテムを作成することはできません。 ::: ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object item.delete(array itemIds)` This method allows to delete items. ::: noteclassic Web items cannot be deleted via the Zabbix API. ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object item.delete(array itemIds)` このメソッドは、アイテムを削除することができます。 ::: noteclassic Webアイテムは、Zabbix APIを使用しての削除はできません。 ::: ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object itemprototype.create(object/array itemPrototypes)` This method allows to create new item prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object itemprototype.create(object/array itemPrototypes)` このメソッドを使用すると、新しいアイテムのプロトタイプを作成できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object itemprototype.delete(array itemPrototypeIds)` This method allows to delete item prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object itemprototype.delete(array itemPrototypeIds)` このメソッドは、アイテムのプロトタイプを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object itemprototype.update(object/array itemPrototypes)` This method allows to update existing item prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object itemprototype.update(object/array itemPrototypes)` このメソッドを使用すると、既存のアイテム プロトタイプを更新できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object item.update(object/array items)` This method allows to update existing items. ::: noteclassic Web items cannot be updated via the Zabbix API. ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object item.update(object/array items)` このメソッドを使用すると、既存のアイテムを更新できます。 ::: noteclassic Zabbix API を介して Web アイテムを更新することはできません。 ::: ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object maintenance.create(object/array maintenances)` This method allows to create new maintenances. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object maintenance.create(object/array maintenances)` このメソッドで、新しいメンテナンスを作成できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object maintenance.delete(array maintenanceIds)` This method allows to delete maintenance periods. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object maintenance.delete(array maintenanceIds)` このメソッドは、メンテナンス期間を削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object maintenance.update(object/array maintenances)` This method allows to update existing maintenances. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object maintenance.update(object/array maintenances)` このメソッドで、既存のメンテナンスを更新できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object map.create(object/array maps)` This method allows to create new maps. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object map.create(object/array maps)` このメソッドで、新しいマップを作成できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object map.delete(array mapIds)` This method allows to delete maps. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object map.delete(array mapIds)` このメソッドは、マップを削除することができます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object map.update(object/array maps)` This method allows to update existing maps. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object map.update(object/array maps)` このメソッドで、既存のマップを更新できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object mediatype.create(object/array mediaTypes)` This method allows to create new media types. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object mediatype.create(object/array mediaTypes)` このメソッドで新しいメディアタイプを作成できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object mediatype.delete(array mediaTypeIds)` This method allows to delete media types. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object mediatype.delete(array mediaTypeIds)` このメソッドは、メディアタイプを削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object mediatype.update(object/array mediaTypes)` This method allows to update existing media types. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object mediatype.update(object/array mediaTypes)` このメソッドで、既存のメディアタイプを更新できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object proxy.create(object/array proxies)` This method allows to create new proxies. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object proxy.create(object/array proxies)` このメソッドは、新しいプロキシを作成することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)の設定で取り消すことができます。詳細はユーザーの役割を参照してください。 ::: ### Description `object proxy.delete(array proxies)` This method allows to delete proxies. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object proxy.delete(array proxies)` このメソッドは、プロキシを削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object proxy.update(object/array proxies)` This method allows to update existing proxies. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object proxy.update(object/array proxies)` このメソッドは、既存のプロキシを更新することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object regexp.create(object/array regularExpressions)` This method allows to create new global regular expressions. ::: noteclassic This method is only available to *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object regexp.create(object/array regularExpressions)` このメソッドで、新しいグローバル正規表現を作成できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object regexp.delete(array regexpids)` This method allows to delete global regular expressions. ::: noteclassic This method is only available to *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object regexp.delete(array regexpids)` このメソッドは、グローバル正規表現を削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object regexp.update(object/array regularExpressions)` This method allows to update existing global regular expressions. ::: noteclassic This method is only available to *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object regexp.update(object/array regularExpressions)` このメソッドで、既存のグローバル正規表現を更新できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object report.create(object/array reports)` This method allows to create new scheduled reports. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object report.create(object/array reports)` このメソッドで、新しいスケジュールされたレポートを作成できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object report.delete(array reportids)` This method allows to delete scheduled reports. ::: noteclassic This method is only available to *Admin* and *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object report.delete(array reportids)` このメソッドは、定期レポートを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object report.update(object/array reports)` This method allows to update existing scheduled reports. ::: noteclassic This method is only available to *Admin* and *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object report.update(object/array reports)` このメソッドで、既存のスケジュールされたレポートを更新できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object role.create(object/array roles)` This method allows to create new roles. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object role.create(object/array roles)` このメソッドで、新しいロールを作成できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object role.delete(array roleids)` This method allows to delete roles. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object role.delete(array roleids)` このメソッドは、ユーザーの役割を削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object role.update(object/array roles)` This method allows to update existing roles. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object role.update(object/array roles)` このメソッドで、既存の役割を更新できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object script.create(object/array scripts)` This method allows to create new scripts. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object script.create(object/array scripts)` このメソッドで新しいスクリプトを作成できます ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object script.delete(array scriptIds)` This method allows to delete scripts. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object script.delete(array scriptIds)` このメソッドは、スクリプトを削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object script.execute(object parameters)` This method allows to run a script on a host or event. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object script.execute(object parameters)` このメソッドで、ホストまたはイベントでスクリプトを実行できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object script.getscriptsbyhosts(array hostIds)` This method allows to retrieve scripts available on the given hosts. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object script.getscriptsbyhosts(array hostIds)` このメソッドで、特定のホストで使用可能なスクリプトを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object script.update(object/array scripts)` This method allows to update existing scripts. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object script.update(object/array scripts)` このメソッドでは、既存のスクリプトを更新できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object service.create(object/array services)` This method allows to create new services. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object service.create(object/array services)` このメソッドで、新しいサービスを作成できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object service.delete(array serviceIds)` This method allows to delete services. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object service.delete(array serviceIds)` このメソッドは、サービスを削除することができます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object service.update(object/array services)` This method allows to update existing services. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object service.update(object/array services)` このメソッドで、既存のサービスを更新できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object settings.get(object parameters)` The method allows to retrieve settings object according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object settings.get(object parameters)` このメソッドで、指定されたパラメーターに従って設定オブジェクトを取得できます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object settings.update(object settings)` This method allows to update existing common settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object settings.update(object settings)` このメソッドで、既存の共通設定を更新できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object sla.create(object/array SLAs)` This method allows to create new SLA objects. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object sla.create(object/array SLAs)` このメソッドで、新しいSLAオブジェクトを作成できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object sla.delete(array slaids)` This method allows to delete SLA entries. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object sla.delete(array slaids)` このメソッドは、SLAエントリを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object sla.update(object/array slaids)` This method allows to update existing SLA entries. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object sla.update(object/array slaids)` このメソッドで、既存のSLAエントリを更新できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object task.create(object/array tasks)` This method allows to create a new task (such as collect diagnostic data or check items or low-level discovery rules without config reload). ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object task.create(object/array tasks)` このメソッドでは新しいタスクを作成できます（診断データの収集、アイテムのチェック、設定の再読み込みをしないローレベルディスカバリルールなど） ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object template.create(object/array templates)` This method allows to create new templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object template.create(object/array templates)` このメソッドで、新しいテンプレートを作成できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object templatedashboard.create(object/array templateDashboards)` This method allows to create new template dashboards. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object templatedashboard.create(object/array templateDashboards)` このメソッドで、新しいテンプレート ダッシュボードを作成できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object templatedashboard.delete(array templateDashboardIds)` This method allows to delete template dashboards. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object templatedashboard.delete(array templateDashboardIds)` このメソッドは、テンプレートダッシュボードを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object templatedashboard.update(object/array templateDashboards)` This method allows to update existing template dashboards. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object templatedashboard.update(object/array templateDashboards)` このメソッドで、既存のテンプレート ダッシュボードを更新できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object template.delete(array templateIds)` This method allows to delete templates. Deleting a template will cause deletion of all template entities (items, triggers, graphs, etc.). To leave template entities with the hosts, but delete the template itself, first unlink the template from required hosts using one of these methods: [template.update](/manual/api/reference/template/update), [template.massupdate](/manual/api/reference/template/massupdate), [host.update](/manual/api/reference/host/update), [host.massupdate](/manual/api/reference/host/massupdate). ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object template.delete(array templateIds)` このメソッドは、テンプレートを削除することができます。 テンプレートを削除すると、すべてのテンプレートエンティティ(アイテム、トリガー、グラフなど)が削除されます。 テンプレートエンティティをホストに残しつつ、テンプレート自体を削除するには[template.update](/manual/api/reference/template/update)、[template.massupdate](/manual/api/reference/template/massupdate)、[host.update](/manual/api/reference/host/update)、[host.massupdate](/manual/api/reference/host/massupdate)のいずれかを使用して、ホストからテンプレートのリンクを解除します。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object template.massadd(object parameters)` This method allows to simultaneously add multiple related objects to the given templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object template.massadd(object parameters)` このメソッドで、指定されたテンプレートに複数の関連オブジェクトを同時に追加できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object template.massremove(object parameters)` This method allows to remove related objects from multiple templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object template.massremove(object parameters)` このメソッドで、関連するオブジェクトを複数のテンプレートから削除できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object template.massupdate(object parameters)` This method allows to simultaneously replace or remove related objects and update properties on multiple templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object template.massupdate(object parameters)` このメソッドで、関連するオブジェクトを同時に置換または削除して複数のテンプレートのプロパティを更新できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object template.update(object/array templates)` This method allows to update existing templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object template.update(object/array templates)` このメソッドで、既存のテンプレートを更新できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object token.create(object/array tokens)` This method allows to create new tokens. ::: noteclassic The *Manage API tokens* [permission](/manual/web_interface/frontend_sections/users/user_roles#configuration) is required for the user role to manage tokens for other users. ::: ::: noteimportant A token created by this method also has to be [generated](generate) before it is usable. ::: ### 説明 `object token.create(object/array tokens)` このメソッドは、新しいトークンを作成することができます。 ::: noteclassic 他のユーザーのトークンを管理するには、ユーザーの役割に*APIトークンの管理*の[権限](/manual/web_interface/frontend_sections/users/user_roles#configuration)が必要です。 ::: ::: noteimportant このメソッドで作成されたトークンも、使用可能になる前に[生成](generate)する必要があります。 ::: ### Description `object token.delete(array tokenids)` This method allows to delete tokens. ::: noteclassic The *Manage API tokens* [permission](/manual/web_interface/frontend_sections/users/user_roles#configuration) is required for the user role to manage tokens for other users. ::: ### 説明 `object token.delete(array tokenids)` このメソッドは、トークンを削除することができます。 ::: noteclassic 他のユーザーのトークンを管理するには、ユーザーの役割に*APIトークンの管理*の[権限](/manual/web_interface/frontend_sections/users/user_roles#configuration)が必要です。 ::: ### Description `object token.update(object/array tokens)` This method allows to update existing tokens. ::: noteclassic The *Manage API tokens* [permission](/manual/web_interface/frontend_sections/users/user_roles#configuration) is required for the user role to manage tokens for other users. ::: ### 説明 `object token.update(object/array tokens)` このメソッドは、既存のトークンを更新することができます。 ::: noteclassic 他のユーザーのトークンを管理するには、ユーザーの役割に*APIトークンの管理*の[権限](/manual/web_interface/frontend_sections/users/user_roles#configuration)が必要です。 ::: ### Description `object trigger.adddependencies(object/array triggerDependencies)` This method allows to create new trigger dependencies. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object trigger.adddependencies(object/array triggerDependencies)` このメソッドで、新しいトリガー依存関係を作成できます ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object trigger.create(object/array triggers)` This method allows to create new triggers. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object trigger.create(object/array triggers)` このメソッドで、新しいトリガーを作成できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object trigger.delete(array triggerIds)` This method allows to delete triggers. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object trigger.delete(array triggerIds)` このメソッドは、トリガーを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object trigger.deletedependencies(string/array triggers)` This method allows to delete all trigger dependencies from the given triggers. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object trigger.deletedependencies(string/array triggers)` このメソッドで、指定されたトリガーからすべてのトリガー依存関係を削除できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object triggerprototype.create(object/array triggerPrototypes)` This method allows to create new trigger prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object triggerprototype.create(object/array triggerPrototypes)` このメソッドを使用すると、新しいトリガー プロトタイプを作成できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object triggerprototype.delete(array triggerPrototypeIds)` This method allows to delete trigger prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object triggerprototype.delete(array triggerPrototypeIds)` このメソッドは、トリガーのプロトタイプを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object triggerprototype.update(object/array triggerPrototypes)` This method allows to update existing trigger prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object triggerprototype.update(object/array triggerPrototypes)` このメソッドで、トリガープロトタイプを更新できます ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object trigger.update(object/array triggers)` This method allows to update existing triggers. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object trigger.update(object/array triggers)` このメソッドを使用すると、既存のトリガーを更新できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object user.checkAuthentication` This method checks and prolongs user session. ::: noteimportant Calling the **user.checkAuthentication** method with the parameter `sessionid` set prolongs user session by default. ::: ### 説明 `object user.checkAuthentication` このメソッドは、ユーザー セッションをチェックして延長します。 ::: noteimportant パラメータ `sessionid` を設定して **user.checkAuthentication** メソッドを呼び出すと、デフォルトでユーザー セッションが延長されます。 ::: ### Description `object user.create(object/array users)` This method allows to create new users. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ::: noteclassic The strength of user password is validated according the password policy rules defined by Authentication API. See [Authentication API](/manual/api/reference/authentication) for more information. ::: ### 説明 `object user.create(object/array users)` このメソッドで新しいユーザーを作成できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ::: noteclassic ユーザーパスワードの強度はAuthenticationAPIによって定義されたパスワードポリシールールに従って検証されます。 詳細については[Authentication API](/manual/api/reference/authentication)を参照してください。 ::: ### Description `object user.delete(array users)` This method allows to delete users. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object user.delete(array users)` このメソッドは、ユーザーを削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object usergroup.create(object/array userGroups)` This method allows to create new user groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object usergroup.create(object/array userGroups)` このメソッドでは、新しいユーザーグループを作成できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object usergroup.delete(array userGroupIds)` This method allows to delete user groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object usergroup.delete(array userGroupIds)` このメソッドは、ユーザーグループを削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object usergroup.update(object/array userGroups)` This method allows to update existing user groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object usergroup.update(object/array userGroups)` このメソッドでは既存のユーザーグループを更新できます。 ::: noteclassic このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object usermacro.createglobal(object/array globalMacros)` This method allows to create new global macros. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object usermacro.createglobal(object/array globalMacros)` このメソッドは、新しいグローバルマクロを作成することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object usermacro.create(object/array hostMacros)` This method allows to create new host macros. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object usermacro.create(object/array hostMacros)` このメソッドは、新しいホストマクロを作成することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object usermacro.delete(array hostMacroIds)` This method allows to delete host macros. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object usermacro.delete(array hostMacroIds)` このメソッドは、ホストマクロを削除することができます。 ::: noteclassic このメソッドは、*Admin*および*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object usermacro.deleteglobal(array globalMacroIds)` This method allows to delete global macros. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object usermacro.deleteglobal(array globalMacroIds)` このメソッドは、グローバルマクロを削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object usermacro.updateglobal(object/array globalMacros)` This method allows to update existing global macros. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object usermacro.updateglobal(object/array globalMacros)` このメソッドは、既存のグローバルマクロを更新することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object usermacro.update(object/array hostMacros)` This method allows to update existing host macros. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object usermacro.update(object/array hostMacros)` このメソッドを使用すると、既存のホスト マクロを更新できます。 ::: noteclassic このメソッドは*Admin*および*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object user.unblock(array userids)` This method allows to unblock users. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object user.unblock(array userids)` このメソッドは、ユーザーのブロックを解除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object user.update(object/array users)` This method allows to update existing users. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ::: noteclassic The strength of user password is validated according the password policy rules defined by Authentication API. See [Authentication API](/manual/api/reference/authentication) for more information. ::: ### 説明 `object user.update(object/array users)` このメソッドでは既存のユーザーを更新できます ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ::: noteclassic ユーザーパスワードの強度はAuthentication APIによって定義されたパスワードポリシールールに従って検証されます。 詳細については[Authentication API](/manual/api/reference/authentication)を参照してください。 ::: ### Description `object valuemap.create(object/array valuemaps)` This method allows to create new value maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object valuemap.create(object/array valuemaps)` このメソッドは、新しいバリューマップを作成することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object valuemap.delete(array valuemapids)` This method allows to delete value maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object valuemap.delete(array valuemapids)` このメソッドは、バリューマップを削除することができます。 ::: noteclassic このメソッドは、*Super admin*タイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `object valuemap.update(object/array valuemaps)` This method allows to update existing value maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `object valuemap.update(object/array valuemaps)` このメソッドでは既存のバリューマップを更新できます。 ::: noteclassic このメソッドは*Superadmin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `string apiinfo.version(array)` This method allows to retrieve the version of the Zabbix API. ::: noteimportant This method is only available to unauthenticated users and must be called without the `auth` parameter in the JSON-RPC request. ::: ### 説明 `string apiinfo.version(array)` このメソッドは、Zabbix APIのバージョンを取得することができます。 ::: noteimportant このメソッドは認証されていないユーザーのみが使用でき、JSON-RPCリクエストで`auth`パラメーターを指定せずに呼び出す必要があります。 ::: ### Description `string configuration.export(object parameters)` This method allows to export configuration data as a serialized string. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `string configuration.export(object parameters)` このメソッドは、構成データをシリアル化された文字列としてエクスポートできます。 ::: noteclassic このメソッドは、すべてのタイプのユーザーが利用できます。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細は[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ### Description `string/object user.login(object parameters)` This method allows to log in to the API and generate an authentication token. ::: notewarning When using this method, you also need to do [user.logout](/manual/api/reference/user/logout) to prevent the generation of a large number of open session records. ::: ::: noteimportant This method is only available to unauthenticated users and must be called without the `auth` parameter in the JSON-RPC request. ::: ### 説明 `string/object user.login(object parameters)` このメソッドを使用すると、APIにログインして認証トークンを生成できます ::: notewarning このメソッドを使用する場合は[user.logout](/manual/api/reference/user/logout)を実行して、開いているセッションレコードが大量に生成されないようにする必要もあります。 ::: ::: noteimportant このメソッドは、認証されていないユーザーのみが使用でき、JSON-RPCリクエストで`auth`パラメーターを指定せずに呼び出す必要があります。 ::: ### Description `string/object user.logout(array)` This method allows to log out of the API and invalidates the current authentication token. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### 説明 `string/object user.logout(array)` このメソッドを使用すると、APIからログアウトして、現在の認証トークンを無効にすることができます。 ::: noteclassic このメソッドはどのタイプのユーザーでも利用可能です。このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳しくは[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。 ::: ##### Description The following parameters are supported if *Advanced configuration* is set to "Enabled", and *Show* is set to "Description". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Description*|1|description|Any string value, including macros.<br>Supported macros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, User macros.<br><br>Default: {ITEM.NAME}.| |*Horizontal position*|0|desc_h_pos|0 - Left;<br>1 - *(default)* Center;<br>2 - Right.<br><br>Two or more elements (Description, Value, Time) cannot share the same *Horizontal position* and *Vertical position*.| |*Vertical position*|0|desc_v_pos|0 - Top;<br>1 - Middle;<br>2 - *(default)* Bottom.<br><br>Two or more elements (Description, Value, Time) cannot share the same *Horizontal position* and *Vertical position*.| |*Size*|0|desc_size|Valid values range from 1-100.<br><br>Default: 15.| |*Bold*|0|desc_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|desc_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| ##### 説明 *詳細設定*が"有効"に設定され、*表示*が"説明"に設定されている場合は、以下のパラメータがサポートされます。 |パラメータ|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|名前|値| |-----|-|-----|-------------------| |*説明*|1|説明|マクロを含む任意の文字列値<br>サポートされているマクロ: {HOST.\*}、{ITEM.\*}、{INVENTORY.\*}、ユーザーマクロ<br><br>デフォルト: {ITEM.NAME}| |*水平位置*|0|desc_h_pos|0 - 左;<br>1 - *(デフォルト)* 中央;<br>2 - 右<br><br>2 つ以上の要素 (説明、値、時間) が同じ *水平位置* と *垂直位置* を共有することはできません。| |*垂直位置*|0|desc_v_pos|0 - 上;<br>1 - 中央;<br>2 - *(デフォルト)* 下<br><br>2 つ以上の要素 (説明、値、時間) が同じ *水平位置* と *垂直位置* を共有することはできません。| |*サイズ*|0|desc_size|有効な値の範囲は 1～100 です。<br><br>デフォルト: 15| |*太字*|0|desc_bold|0 - *(デフォルト)* 無効;<br>1 - 有効| |*Color*|1|desc_color|16進数カラーコード（例：`FF0000`）<br><br>デフォルト：`""`（空）| ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Clock*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/clock) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Clock* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*時計*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/clock)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *時計*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Data overview*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/data_overview) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Data overview* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*データの概要*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/data_overview)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *データの概要*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Geomap*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Geomap* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*地理マップ*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *地理マップ*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Graph (classic)*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph_classic) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Graph (classic)* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*グラフ（クラシック）*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph_classic)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *グラフ（クラシック）*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Graph*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Graph* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*グラフ*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *グラフ*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Graph prototype*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph_prototype) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Graph prototype* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*グラフのプロトタイプ*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph_prototype)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *グラフのプロトタイプ*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Item value*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Item value* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*アイテムの値*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *アイテムの値*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Map*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Map* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*マップ*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *マップ*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Map navigation tree*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map_tree) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Map navigation tree* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*マップナビゲーション*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map_tree)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *マップナビゲーション*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Plain text*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/plain_text) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Plain text* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*プレーンテキスト*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/plain_text)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *プレーンテキスト*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Problem hosts*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problem_hosts) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Problem hosts* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*障害中のホスト*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problem_hosts)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *障害中のホスト*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Problems by severity*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems_severity) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Problems by severity* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*深刻度ごとの障害数*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems_severity)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *深刻度ごとの障害数*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Problems*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Problems* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*障害*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *障害*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*SLA report*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/sla_report) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *SLA report* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*SLAレポート*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/sla_report)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *SLAレポート*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Top hosts*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Top hosts* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*上位ホスト*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *上位ホスト*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Trigger overview*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/trigger_overview) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Trigger overview* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*トリガーの概要*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/trigger_overview)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *トリガーの概要*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*URL*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/url) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *URL* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*URL*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/url)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *URL*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Web monitoring*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/web_monitoring) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Web monitoring* widget, please refer to the parameter requirements outlined in the tables below. ::: ### 説明 これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*Web監視*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/web_monitoring)ウィジェットを設定できます。 ::: noteimportant ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。 これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 *Web監視*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。 ::: ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## 説明 **zabbix\_agent2**は、様々なサービスのパラメーターを監視するためのアプリケーションです。\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## 説明 **zabbix\_agentd**は、様々なサーバーのパラメーターを監視するためのデーモンです。 [ ]{#lbAE} ## DESCRIPTION **zabbix\_get** is a command line utility for getting data from Zabbix agent. [ ]{#lbAE} ## 説明 **zabbix\_get**は、Zabbixエージェントからデータを取得するためのコマンドラインユーティリティです。[ ]{#lbAE} ## DESCRIPTION **zabbix\_js** is a command line utility that can be used for embedded script testing. [ ]{#lbAE} ## 説明 **zabbix\_js**は、組み込みスクリプトのテストに使用できるコマンドラインユーティリティです。[ ]{#lbAE} ## DESCRIPTION **zabbix\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE} ## 説明 **zabbix\_proxy**は、デバイスから監視データを収集し、Zabbixサーバーに送信するデーモンです。[ ]{#lbAE} ## DESCRIPTION **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE} ## 説明 **zabbix\_sender**は、監視データをZabbixサーバーまたはプロキシに送信するためのコマンドラインユーティリティです。Zabbixサーバーでは、**Zabbix trapper**タイプのアイテムに対応するキーで作成する必要があります。受信データは、このアイテムの**許可されたホスト**フィールドで指定されたホストからのみ受け入れられることに注意してください。 [ ]{#lbAE} ## DESCRIPTION **zabbix\_server** is the core daemon of Zabbix software. [ ]{#lbAE} ## 説明 **zabbix\_server**は、Zabbixソフトウェアのコアデーモンです。 [ ]{#lbAE} ## DESCRIPTION **zabbix\_web\_service** is an application for providing web services to Zabbix components. [ ]{#lbAE} ## 説明 **zabbix\_web\_service**は、ZabbixコンポーネントにWebサービスを提供するためのアプリケーションです。[ ]{#lbAE} #### Details about export - All supported elements are exported in one file. - Host and template entities (items, triggers, graphs, discovery rules) that are inherited from linked templates are not exported. Any changes made to those entities on a host level (such as changed item interval, modified regular expression or added prototypes to the low-level discovery rule) will be lost when exporting; when importing, all entities from linked templates are re-created as on the original linked template. - Entities created by low-level discovery and any entities depending on them are not exported. For example, a trigger created for an LLD-rule generated item will not be exported. #### エクスポートに関する詳細 - サポートされているすべての要素が1つのファイルにエクスポートされます。 <br> - ホストおよびテンプレートの要素（アイテム、トリガー、グラフ、ディスカバリールール）は、 <br> リンクされたテンプレートから継承されるため、エクスポートされません。 <br> ホストレベルでこれらのエンティティに加えられたすべての変更（アイテムの監視間隔の変更、正規表現の変更、 <br> ローレベルディスカバリルールへのプロトタイプの追加など）は、エクスポート時に失われます。 <br> インポートする場合、リンクされたテンプレートのすべての要素は、元のリンクされたテンプレートと同じように再作成されます。 <br> - ローレベルディスカバリによって作成された要素およびそれに依存する要素は、エクスポートされません。 <br> 例えば、LLD ルールが生成された項目に対して作成されたトリガはエクスポートされません。 <br> #### Details about import - Import stops at the first error. - When updating existing images during image import, "imagetype" field is ignored, i.e. it is impossible to change image type via import. - When importing hosts/templates using the "Delete missing" option, host/template macros not present in the import file will be deleted from the host/template after the import. - Empty tags for items, triggers, graphs, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes are meaningless i.e. it's the same as if it was missing. - Import supports YAML, XML and JSON, the import file must have a correct file extension: .yaml and .yml for YAML, .xml for XML and .json for JSON. See [compatibility information](/manual/appendix/compatibility) about supported XML versions. - Import supports configuration files only in UTF-8 encoding (with or without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark)); other encodings (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) will result in an import conversion error. #### インポートに関する詳細 - インポートは、最初のエラーで停止します。 - 画像のインポート時に、既存の画像を更新する場合、"imagetype "フィールドは無視されます。つまり、インポートを介してイメージタイプを変更することはできません。 - ホスト/テンプレートを "存在しない場合に削除"オプションでインポートする場合、インポートファイルに存在しないホスト／テンプレートマクロはインポート後にホスト／テンプレートから削除されます。 - アイテム、トリガー、グラフ、ホスト/テンプレート、アプリケーション、ディスカバリルール、アイテムプロトタイプ、トリガープロトタイプ、グラフプロトタイプでは、空のタグには意味がありません。つまり、存在しないのと同じです。 - インポートは、YAML、XML、JSONをサポートしています。YAMLは.yamlと.yml、XMLは.xml、JSONは.jsonと、正しいファイル拡張子が必要です。サポートされているXMLのバージョンに関しては、[バージョン間の互換性](/manual/appendix/compatibility)を参照してください。 - インポートは、UTF-8 エンコーディング ([BOM](https://en.wikipedia.org/wiki/Byte_order_mark) 付き/なし いずれも対応) の設定ファイルのみをサポートしています。他のエンコーディング (UTF16LE, UTF16BE, UTF32LE, UTF32BE 等) を使用した場合、変換エラーが生じます。 ### Details tag The details object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>1 - (default) - use bulk requests.| |community|string|SNMP community (required). Used only by SNMPv1 and SNMPv2 interfaces.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.| |privpassphrase|string|SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.| |authprotocol|integer|SNMPv3 authentication protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 context name. Used only by SNMPv3 interfaces.| ### Details tag Details tagオブジェクトには、次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**version**<br>(必須)|integer|SNMPインターフェースのバージョン。<br><br>値は次のとおりです。<br>1 - SNMPv1<br>2 - SNMPv2c<br>3 - SNMPv3| |bulk|integer|バルクSNMPリクエストを使用するかどうか。<br><br>値は次のとおりです。<br>0 - バルクリクエストを使用しない<br>1 -（デフォルト）- バルクリクエストを使用する| |community|string|SNMPコミュニティ (必須) SNMPv1およびSNMPv2インターフェースでのみ使用されます。| |securityname|string|SNMPv3セキュリティ名。 SNMPv3インターフェースでのみ使用されます。| |securitylevel|integer|SNMPv3セキュリティレベル。 SNMPv3インターフェースでのみ使用されます。<br><br>値は次のとおりです。<br>0 -（デフォルト）- noAuthNoPriv<br>1 - authNoPriv<br>2 - authPriv| |authpassphrase|string|SNMPv3認証パスフレーズ。 SNMPv3インターフェースでのみ使用されます。| |privpassphrase|string|SNMPv3プライバシーパスフレーズ。 SNMPv3インターフェースでのみ使用されます。| |authprotocol|integer|SNMPv3認証プロトコル。 SNMPv3インターフェースでのみ使用されます。<br><br>値は次のとおりです。<br>0 - （デフォルト）- MD5<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512| |privprotocol|integer|SNMPv3プライバシープロトコル。 SNMPv3インターフェースでのみ使用されます。<br><br>値は次のとおりです。<br>0 -（デフォルト）- DES<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C| |contextname|string|SNMPv3コンテキスト名。 SNMPv3インターフェースでのみ使用されます。| #### Details The virtual machine monitoring is done in two steps. First, virtual machine data is gathered by *vmware collector* Zabbix processes. Those processes obtain necessary information from VMware web services over the SOAP protocol, pre-process it and store into Zabbix server shared memory. Then, this data is retrieved by pollers using Zabbix simple check [VMware keys](/manual/config/items/itemtypes/simple_checks/vmware_keys). Starting with Zabbix version 2.4.4 the collected data is divided into 2 types: VMware configuration data and VMware performance counter data. Both types are collected independently by *vmware collectors*. Because of this it is recommended to enable more collectors than the monitored VMware services. Otherwise retrieval of VMware performance counter statistics might be delayed by the retrieval of VMware configuration data (which takes a while for large installations). Currently only datastore, network interface and disk device statistics and custom performance counter items are based on the VMware performance counter information. #### 詳細 仮想マシンの監視は、2つのステップで行われます。 <br> まず、*vmware collector* Zabbixプロセスによって、仮想マシンのデータが収集されます。 <br> これらのプロセスは、VMware社のWebサービスから必要な情報をSOAPプロトコルで取得し、プリプロセスを行い、 <br> Zabbix server の共有メモリに格納します。 <br> そして、このデータはポーラーによってZabbixのシンプルチェック[VMware keys](/manual/config/items/itemtypes/simple_checks/vmware_keys) を使用して取得されます。 <br> Zabbixバージョン2.4.4から、収集されたデータは2つのタイプに分けられます。 <br> VMwareの設定データとVMwareのパフォーマンスカウンタデータです。 <br> 両データはそれぞれ独立した *vmware collectors* によって収集されます。 <br> このため、監視するVMwareサービス数より多くのコレクタを有効にすることをお勧めします。 <br> そうしないと、VMwareパフォーマンス・カウンターの統計の取得が、 <br> VMware 構成データの取得（大規模なインストールでは時間がかかる）によって遅延する可能性があります。 <br> 現在、データストア、ネットワーク・インターフェイス、ディスク・デバイスの統計情報 <br> およびカスタム・パフォーマンス・カウンターの項目のみが、VMwareのパフォーマンス・カウンターの情報に基づいています。 <br> #### Developing modules Modules are written in PHP language. Model-view-controller (MVC) software pattern design is preferred, as it is also used in Zabbix frontend and will ease the development. PHP strict typing is also welcome but not mandatory. Please note that with modules you can easily add new menu items and respective views and actions to Zabbix frontend. Currently it is not possible to register new API or create new database tables through modules. #### モジュール開発 モジュールはPHP言語で記述されます。モデル・ビュー・コントローラ(MVC)ソフトウェアパターンデザインは、 <br> Zabbixのフロントエンドでも使用されており、開発が容易になるため、推奨されています。 <br> PHPの strict typing も歓迎されますが、必須ではありません。 <br> モジュールを使用することで、Zabbixフロントエンドに新しいメニューアイテムやそれぞれの <br> ビュー、アクションを簡単に追加することができます。 <br> 現在のところ、モジュールを使って新しいAPIを登録したり、新しいデータベーステーブルを作成することはできません。 <br> #### Devices List of device families for which templates are available: |Template name|Vendor|Device family|Known models|OS|MIBs used|**[Tags](/manual/config/templates_out_of_the_box/network_devices#tags)**| |-------------|------|-------------|------------|--|---------|------------------------------------------------------------------------| |*Alcatel Timetra TiMOS SNMP*|Alcatel|Alcatel Timetra|ALCATEL SR 7750|TiMOS|TIMETRA-SYSTEM-MIB,TIMETRA-CHASSIS-MIB|Certified| |*Brocade FC SNMP*|Brocade|Brocade FC switches|Brocade 300 SAN Switch-|\-|SW-MIB,ENTITY-MIB|Performance, Fault| |*Brocade\_Foundry Stackable SNMP*|Brocade|Brocade ICX|Brocade ICX6610, Brocade ICX7250-48, Brocade ICX7450-48F|<|FOUNDRY-SN-AGENT-MIB, FOUNDRY-SN-STACKING-MIB|Certified| |*Brocade\_Foundry Nonstackable SNMP*|Brocade, Foundry|Brocade MLX, Foundry|Brocade MLXe, Foundry FLS648, Foundry FWSX424|<|FOUNDRY-SN-AGENT-MIB|Performance, Fault| |*Cisco Catalyst 3750<device model> SNMP*|Cisco|Cisco Catalyst 3750|Cisco Catalyst 3750V2-24FS, Cisco Catalyst 3750V2-24PS, Cisco Catalyst 3750V2-24TS, Cisco Catalyst SNMP, Cisco Catalyst SNMP|<|CISCO-MEMORY-POOL-MIB, IF-MIB, EtherLike-MIB, SNMPv2-MIB, CISCO-PROCESS-MIB, CISCO-ENVMON-MIB, ENTITY-MIB|Certified| |*Cisco IOS SNMP*|Cisco|Cisco IOS ver > 12.2 3.5|Cisco C2950|IOS|CISCO-PROCESS-MIB,CISCO-MEMORY-POOL-MIB,CISCO-ENVMON-MIB|Certified| |*Cisco IOS versions 12.0\_3\_T-12.2\_3.5 SNMP*|Cisco|Cisco IOS > 12.0 3 T and < 12.2 3.5|\-|IOS|CISCO-PROCESS-MIB,CISCO-MEMORY-POOL-MIB,CISCO-ENVMON-MIB|Certified| |*Cisco IOS prior to 12.0\_3\_T SNMP*|Cisco|Cisco IOS < 12.0 3 T|\-|IOS|OLD-CISCO-CPU-MIB,CISCO-MEMORY-POOL-MIB|Certified| |*D-Link DES\_DGS Switch SNMP*|D-Link|DES/DGX switches|D-Link DES-xxxx/DGS-xxxx,DLINK DGS-3420-26SC|\-|DLINK-AGENT-MIB,EQUIPMENT-MIB,ENTITY-MIB|Certified| |*D-Link DES 7200 SNMP*|D-Link|DES-7xxx|D-Link DES 7206|\-|ENTITY-MIB,MY-SYSTEM-MIB,MY-PROCESS-MIB,MY-MEMORY-MIB|Performance Fault Interfaces| |*Dell Force S-Series SNMP*|Dell|Dell Force S-Series|S4810|<|F10-S-SERIES-CHASSIS-MIB|Certified| |*Extreme Exos SNMP*|Extreme|Extreme EXOS|X670V-48x|EXOS|EXTREME-SYSTEM-MIB,EXTREME-SOFTWARE-MONITOR-MIB|Certified| |*Huawei VRP SNMP*|Huawei|Huawei VRP|S2352P-EI|\-|ENTITY-MIB,HUAWEI-ENTITY-EXTENT-MIB|Certified| |*Intel\_Qlogic Infiniband SNMP*|Intel/QLogic|Intel/QLogic Infiniband devices|Infiniband 12300|<|ICS-CHASSIS-MIB|Fault Inventory| |*Juniper SNMP*|Juniper|MX,SRX,EX models|Juniper MX240, Juniper EX4200-24F|JunOS|JUNIPER-MIB|Certified| |*Mellanox SNMP*|Mellanox|Mellanox Infiniband devices|SX1036|MLNX-OS|HOST-RESOURCES-MIB,ENTITY-MIB,ENTITY-SENSOR-MIB,MELLANOX-MIB|Certified| |*MikroTik CCR<device model> SNMP*|MikroTik|MikroTik Cloud Core Routers (CCR series)|Separate dedicated templates are available for MikroTik CCR1009-7G-1C-1S+, MikroTik CCR1009-7G-1C-1S+PC, MikroTik CCR1009-7G-1C-PC, MikroTik CCR1016-12G, MikroTik CCR1016-12S-1S+, MikroTik CCR1036-12G-4S-EM, MikroTik CCR1036-12G-4S, MikroTik CCR1036-8G-2S+, MikroTik CCR1036-8G-2S+EM, MikroTik CCR1072-1G-8S+, MikroTik CCR2004-16G-2S+, MikroTik CCR2004-1G-12S+2XS|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik CRS<device model> SNMP*|MikroTik|MikroTik Cloud Router Switches (CRS series)|Separate dedicated templates are available for MikroTik CRS106-1C-5S, MikroTik CRS109-8G-1S-2HnD-IN, MikroTik CRS112-8G-4S-IN, MikroTik CRS112-8P-4S-IN, MikroTik CRS125-24G-1S-2HnD-IN, MikroTik CRS212-1G-10S-1S+IN, MikroTik CRS305-1G-4S+IN, MikroTik CRS309-1G-8S+IN, MikroTik CRS312-4C+8XG-RM, MikroTik CRS317-1G-16S+RM, MikroTik CRS326-24G-2S+IN, MikroTik CRS326-24G-2S+RM, MikroTik CRS326-24S+2Q+RM, MikroTik CRS328-24P-4S+RM, MikroTik CRS328-4C-20S-4S+RM, MikroTik CRS354-48G-4S+2Q+RM, MikroTik CRS354-48P-4S+2Q+RM|RouterOS/SwitchOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik CSS<device model> SNMP*|MikroTik|MikroTik Cloud Smart Switches (CSS series)|Separate dedicated templates are available for MikroTik CSS326-24G-2S+RM, MikroTik CSS610-8G-2S+IN|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik FiberBox SNMP*|MikroTik|MikroTik FiberBox|MikroTik FiberBox|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik hEX <device model> SNMP*|MikroTik|MikroTik hEX|Separate dedicated templates are available for MikroTik hEX, MikroTik hEX lite, MikroTik hEX PoE, MikroTik hEX PoE lite, MikroTik hEX S|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik netPower <device model> SNMP*|MikroTik|MikroTik netPower|Separate dedicated templates are available for MikroTik netPower 15FR, MikroTik netPower 16P SNMP, MikroTik netPower Lite 7R|RouterOS/SwitchOS, SwitchOS Lite|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik PowerBox <device model> SNMP*|MikroTik|MikroTik PowerBox|Separate dedicated templates are available for MikroTik PowerBox, MikroTik PowerBox Pro|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik RB<device model> SNMP*|MikroTik|MikroTik RB series routers|Separate dedicated templates are available for MikroTik RB1100AHx4, MikroTik RB1100AHx4 Dude Edition, MikroTik RB2011iL-IN, MikroTik RB2011iL-RM, MikroTik RB2011iLS-IN, MikroTik RB2011UiAS-IN, MikroTik RB2011UiAS-RM, MikroTik RB260GS, MikroTik RB3011UiAS-RM, MikroTik RB4011iGS+RM, MikroTik RB5009UG+S+IN|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik SNMP*|MikroTik|MikroTik RouterOS devices|MikroTik CCR1016-12G, MikroTik RB2011UAS-2HnD, MikroTik 912UAG-5HPnD, MikroTik 941-2nD, MikroTik 951G-2HnD, MikroTik 1100AHx2|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*QTech QSW SNMP*|QTech|Qtech devices|Qtech QSW-2800-28T|\-|QTECH-MIB,ENTITY-MIB|Performance Inventory| |*Ubiquiti AirOS SNMP*|Ubiquiti|Ubiquiti AirOS wireless devices|NanoBridge,NanoStation,Unifi|AirOS|FROGFOOT-RESOURCES-MIB,IEEE802dot11-MIB|Performance| |*HP Comware HH3C SNMP*|HP|HP (H3C) Comware|HP A5500-24G-4SFP HI Switch|<|HH3C-ENTITY-EXT-MIB,ENTITY-MIB|Certified| |*HP Enterprise Switch SNMP*|HP|HP Enterprise Switch|HP ProCurve J4900B Switch 2626, HP J9728A 2920-48G Switch|<|STATISTICS-MIB,NETSWITCH-MIB,HP-ICF-CHASSIS,ENTITY-MIB,SEMI-MIB|Certified| |*TP-LINK SNMP*|TP-LINK|TP-LINK|T2600G-28TS v2.0|<|TPLINK-SYSMONITOR-MIB,TPLINK-SYSINFO-MIB|Performance Inventory| |*Netgear Fastpath SNMP*|Netgear|Netgear Fastpath|M5300-28G|<|FASTPATH-SWITCHING-MIB,FASTPATH-BOXSERVICES-PRIVATE-MIB|Fault Inventory| #### デバイス テンプレートが利用可能なデバイスファミリーの一覧です: |テンプレート名|ベンダ|デバイスファミリー|モデル|OS|MIBs used|**[Tags](/manual/config/templates_out_of_the_box/network_devices#tags)**| |-------------|------|-------------|------------|--|---------|------------------------------------------------------------------------| |*Alcatel Timetra TiMOS SNMP*|Alcatel|Alcatel Timetra|ALCATEL SR 7750|TiMOS|TIMETRA-SYSTEM-MIB,TIMETRA-CHASSIS-MIB|Certified| |*Brocade FC SNMP*|Brocade|Brocade FC switches|Brocade 300 SAN Switch-|\-|SW-MIB,ENTITY-MIB|Performance, Fault| |*Brocade\_Foundry Stackable SNMP*|Brocade|Brocade ICX|Brocade ICX6610, Brocade ICX7250-48, Brocade ICX7450-48F|<|FOUNDRY-SN-AGENT-MIB, FOUNDRY-SN-STACKING-MIB|Certified| |*Brocade\_Foundry Nonstackable SNMP*|Brocade, Foundry|Brocade MLX, Foundry|Brocade MLXe, Foundry FLS648, Foundry FWSX424|<|FOUNDRY-SN-AGENT-MIB|Performance, Fault| |*Cisco Catalyst 3750<device model> SNMP*|Cisco|Cisco Catalyst 3750|Cisco Catalyst 3750V2-24FS, Cisco Catalyst 3750V2-24PS, Cisco Catalyst 3750V2-24TS, Cisco Catalyst SNMP, Cisco Catalyst SNMP|<|CISCO-MEMORY-POOL-MIB, IF-MIB, EtherLike-MIB, SNMPv2-MIB, CISCO-PROCESS-MIB, CISCO-ENVMON-MIB, ENTITY-MIB|Certified| |*Cisco IOS SNMP*|Cisco|Cisco IOS ver > 12.2 3.5|Cisco C2950|IOS|CISCO-PROCESS-MIB,CISCO-MEMORY-POOL-MIB,CISCO-ENVMON-MIB|Certified| |*Cisco IOS versions 12.0\_3\_T-12.2\_3.5 SNMP*|Cisco|Cisco IOS > 12.0 3 T and < 12.2 3.5|\-|IOS|CISCO-PROCESS-MIB,CISCO-MEMORY-POOL-MIB,CISCO-ENVMON-MIB|Certified| |*Cisco IOS prior to 12.0\_3\_T SNMP*|Cisco|Cisco IOS < 12.0 3 T|\-|IOS|OLD-CISCO-CPU-MIB,CISCO-MEMORY-POOL-MIB|Certified| |*D-Link DES\_DGS Switch SNMP*|D-Link|DES/DGX switches|D-Link DES-xxxx/DGS-xxxx,DLINK DGS-3420-26SC|\-|DLINK-AGENT-MIB,EQUIPMENT-MIB,ENTITY-MIB|Certified| |*D-Link DES 7200 SNMP*|D-Link|DES-7xxx|D-Link DES 7206|\-|ENTITY-MIB,MY-SYSTEM-MIB,MY-PROCESS-MIB,MY-MEMORY-MIB|Performance Fault Interfaces| |*Dell Force S-Series SNMP*|Dell|Dell Force S-Series|S4810|<|F10-S-SERIES-CHASSIS-MIB|Certified| |*Extreme Exos SNMP*|Extreme|Extreme EXOS|X670V-48x|EXOS|EXTREME-SYSTEM-MIB,EXTREME-SOFTWARE-MONITOR-MIB|Certified| |*Huawei VRP SNMP*|Huawei|Huawei VRP|S2352P-EI|\-|ENTITY-MIB,HUAWEI-ENTITY-EXTENT-MIB|Certified| |*Intel\_Qlogic Infiniband SNMP*|Intel/QLogic|Intel/QLogic Infiniband devices|Infiniband 12300|<|ICS-CHASSIS-MIB|Fault Inventory| |*Juniper SNMP*|Juniper|MX,SRX,EX models|Juniper MX240, Juniper EX4200-24F|JunOS|JUNIPER-MIB|Certified| |*Mellanox SNMP*|Mellanox|Mellanox Infiniband devices|SX1036|MLNX-OS|HOST-RESOURCES-MIB,ENTITY-MIB,ENTITY-SENSOR-MIB,MELLANOX-MIB|Certified| |*MikroTik CCR<device model> SNMP*|MikroTik|MikroTik Cloud Core Routers (CCR series)|Separate dedicated templates are available for MikroTik CCR1009-7G-1C-1S+, MikroTik CCR1009-7G-1C-1S+PC, MikroTik CCR1009-7G-1C-PC, MikroTik CCR1016-12G, MikroTik CCR1016-12S-1S+, MikroTik CCR1036-12G-4S-EM, MikroTik CCR1036-12G-4S, MikroTik CCR1036-8G-2S+, MikroTik CCR1036-8G-2S+EM, MikroTik CCR1072-1G-8S+, MikroTik CCR2004-16G-2S+, MikroTik CCR2004-1G-12S+2XS|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik CRS<device model> SNMP*|MikroTik|MikroTik Cloud Router Switches (CRS series)|Separate dedicated templates are available for MikroTik CRS106-1C-5S, MikroTik CRS109-8G-1S-2HnD-IN, MikroTik CRS112-8G-4S-IN, MikroTik CRS112-8P-4S-IN, MikroTik CRS125-24G-1S-2HnD-IN, MikroTik CRS212-1G-10S-1S+IN, MikroTik CRS305-1G-4S+IN, MikroTik CRS309-1G-8S+IN, MikroTik CRS312-4C+8XG-RM, MikroTik CRS317-1G-16S+RM, MikroTik CRS326-24G-2S+IN, MikroTik CRS326-24G-2S+RM, MikroTik CRS326-24S+2Q+RM, MikroTik CRS328-24P-4S+RM, MikroTik CRS328-4C-20S-4S+RM, MikroTik CRS354-48G-4S+2Q+RM, MikroTik CRS354-48P-4S+2Q+RM|RouterOS/SwitchOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik CSS<device model> SNMP*|MikroTik|MikroTik Cloud Smart Switches (CSS series)|Separate dedicated templates are available for MikroTik CSS326-24G-2S+RM, MikroTik CSS610-8G-2S+IN|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik FiberBox SNMP*|MikroTik|MikroTik FiberBox|MikroTik FiberBox|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik hEX <device model> SNMP*|MikroTik|MikroTik hEX|Separate dedicated templates are available for MikroTik hEX, MikroTik hEX lite, MikroTik hEX PoE, MikroTik hEX PoE lite, MikroTik hEX S|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik netPower <device model> SNMP*|MikroTik|MikroTik netPower|Separate dedicated templates are available for MikroTik netPower 15FR, MikroTik netPower 16P SNMP, MikroTik netPower Lite 7R|RouterOS/SwitchOS, SwitchOS Lite|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik PowerBox <device model> SNMP*|MikroTik|MikroTik PowerBox|Separate dedicated templates are available for MikroTik PowerBox, MikroTik PowerBox Pro|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik RB<device model> SNMP*|MikroTik|MikroTik RB series routers|Separate dedicated templates are available for MikroTik RB1100AHx4, MikroTik RB1100AHx4 Dude Edition, MikroTik RB2011iL-IN, MikroTik RB2011iL-RM, MikroTik RB2011iLS-IN, MikroTik RB2011UiAS-IN, MikroTik RB2011UiAS-RM, MikroTik RB260GS, MikroTik RB3011UiAS-RM, MikroTik RB4011iGS+RM, MikroTik RB5009UG+S+IN|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik SNMP*|MikroTik|MikroTik RouterOS devices|MikroTik CCR1016-12G, MikroTik RB2011UAS-2HnD, MikroTik 912UAG-5HPnD, MikroTik 941-2nD, MikroTik 951G-2HnD, MikroTik 1100AHx2|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*QTech QSW SNMP*|QTech|Qtech devices|Qtech QSW-2800-28T|\-|QTECH-MIB,ENTITY-MIB|Performance Inventory| |*Ubiquiti AirOS SNMP*|Ubiquiti|Ubiquiti AirOS wireless devices|NanoBridge,NanoStation,Unifi|AirOS|FROGFOOT-RESOURCES-MIB,IEEE802dot11-MIB|Performance| |*HP Comware HH3C SNMP*|HP|HP (H3C) Comware|HP A5500-24G-4SFP HI Switch|<|HH3C-ENTITY-EXT-MIB,ENTITY-MIB|Certified| |*HP Enterprise Switch SNMP*|HP|HP Enterprise Switch|HP ProCurve J4900B Switch 2626, HP J9728A 2920-48G Switch|<|STATISTICS-MIB,NETSWITCH-MIB,HP-ICF-CHASSIS,ENTITY-MIB,SEMI-MIB|Certified| |*TP-LINK SNMP*|TP-LINK|TP-LINK|T2600G-28TS v2.0|<|TPLINK-SYSMONITOR-MIB,TPLINK-SYSINFO-MIB|Performance Inventory| |*Netgear Fastpath SNMP*|Netgear|Netgear Fastpath|M5300-28G|<|FASTPATH-SWITCHING-MIB,FASTPATH-BOXSERVICES-PRIVATE-MIB|Fault Inventory| # dhost.get # dhost.get ### 'Diagnostic information' request object The diagnostic information task request object has the following properties. Statistic request object for all types of properties is [described in detail below](/manual/api/reference/task/object#statistic_request_object). |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |historycache|object|History cache statistic request. Available on server and proxy.| |valuecache|object|Items cache statistic request. Available on server.| |preprocessing|object|Preprocessing manager statistic request. Available on server and proxy.| |alerting|object|Alert manager statistic request. Available on server.| |lld|object|LLD manager statistic request. Available on server.| ### 'Diagnostic information' request object diagnostic information task request オブジェクトには次のプロパティがあります。 すべてのタイプのプロパティの統計リクエスト オブジェクトについては[以下で詳しく説明します](/manual/api/reference/task/object#statistic_request_object)。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |historycache|object|履歴キャッシュ統計リクエスト。 サーバーとプロキシで利用可能。| |valuecache|object|アイテム キャッシュ統計リクエスト。 サーバーで利用可能。| |preprocessing|object|マネージャ統計リクエストの事前処理。 サーバーとプロキシで利用可能。| |alerting|object|アラート マネージャの統計要求。 サーバーで利用可能。| |lld|object|LLD マネージャー統計要求。 サーバーで利用可能。| #### Disable action Disable an action, that is, set its status to "1". Request: ```json { "jsonrpc": "2.0", "method": "action.update", "params": { "actionid": "2", "status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "2" ] }, "id": 1 } ``` #### アクションの無効化 ステータスを「1」に設定してアクションを無効にします。 リクエスト: ```json { "jsonrpc": "2.0", "method": "action.update", "params": { "actionid": "2", "status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "2" ] }, "id": 1 } ``` #### Disable correlation Request: ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "status": "1" }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### 相関関係の無効化 リクエスト: ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "status": "1" }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Disable trapping Disable LLD trapping for discovery rule. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "28336", "allow_traps": 0 }, "id": 36, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28336" ] }, "id": 36 } ``` #### トラッピングを無効にする ディスカバリルールのLLDトラッピングを無効にします Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "28336", "allow_traps": 0 }, "id": 36, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28336" ] }, "id": 36 } ``` #### Disabling ability to execute scripts Update role with ID "5", disable ability to execute scripts. Request: ```json { "jsonrpc": "2.0", "method": "role.update", "params": [ { "roleid": "5", "rules": { "actions": [ { "name": "execute_scripts", "status": "0" } ] } } ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### スクリプトを実行する機能を無効にする ID"5"でロールを更新し、スクリプトを実行する機能を無効にします。 Request: ```json { "jsonrpc": "2.0", "method": "role.update", "params": [ { "roleid": "5", "rules": { "actions": [ { "name": "execute_scripts", "status": "0" } ] } } ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### Disabling a host prototype Disable a host prototype, that is, set its status to 1. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### ホストプロトタイプの無効化 ホストプロトタイプを無効にするため、ステータスを1に設定します。 Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Disabling a user group Disable a user group. Request: ```json { "jsonrpc": "2.0", "method": "usergroup.update", "params": { "usrgrpid": "17", "users_status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "17" ] }, "id": 1 } ``` #### ユーザーグループの無効化 ユーザーグループを無効にします Request: ```json { "jsonrpc": "2.0", "method": "usergroup.update", "params": { "usrgrpid": "17", "users_status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "17" ] }, "id": 1 } ``` #### Disabling default web server error pages It is recommended to disable default error pages to avoid information exposure. Web server is using built-in error pages by default:  Default error pages should be replaced/removed as part of the web server hardening process. The "ErrorDocument" directive can be used to define a custom error page/text for Apache web server (used as an example). Please refer to documentation of your web server to find help on how to replace/remove default error pages. #### Webサーバーのデフォルトエラーページを無効にする 情報漏洩を避けるため、デフォルトのエラーページを無効にすることをお勧めします。 Webサーバーはデフォルトで組み込みエラーページを使用します。  デフォルトのエラーページは、Webサーバーの強化プロセスの一環として置き換えまたは削除する必要があります。 例えばApache Webサーバーならば、"ErrorDocument"ディレクティブを使用してカスタムエラーページ/テキストを定義できます。 デフォルトのエラーページを置き換えたり削除したりする方法については、Webサーバーのドキュメントを参照してください。 ### Disabling high availability To disable a high availability cluster: - make backup copies of configuration files - stop standby nodes - remove the HANodeName parameter from the active primary server - restart the primary server (it will start in standalone mode) ### 高可用性の無効化 高可用性クラスターを無効にするには: - 設定ファイルのバックアップコピーを作成する - スタンバイノードを停止する - アクティブなプライマリ サーバーから HANodeName パラメータを削除 - プライマリサーバーを再起動 (スタンドアロン モードで起動します) #### Disabling scheduled report Request: ```json { "jsonrpc": "2.0", "method": "report.update", "params": { "reportid": "1", "status": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### スケジュールされたレポートの無効化 Request: ```json { "jsonrpc": "2.0", "method": "report.update", "params": { "reportid": "1", "status": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### Disabling web server information exposure It is recommended to disable all web server signatures as part of the web server hardening process. The web server is exposing software signature by default:  The signature can be disabled by adding two lines to the Apache (used as an example) configuration file: ```ini ServerSignature Off ServerTokens Prod ``` PHP signature (X-Powered-By HTTP header) can be disabled by changing the php.ini configuration file (signature is disabled by default): ```ini expose_php = Off ``` Web server restart is required for configuration file changes to be applied. Additional security level can be achieved by using the mod\_security (package libapache2-mod-security2) with Apache. mod\_security allows to remove server signature instead of only removing version from server signature. Signature can be altered to any value by changing "SecServerSignature" to any desired value after installing mod\_security. Please refer to documentation of your web server to find help on how to remove/change software signatures. #### Webサーバー情報の公開を無効にする Webサーバーの強化プロセスの一環として、すべてのWebサーバーの署名を無効にすることをお勧めします。 Webサーバーはデフォルトでソフトウェア署名を公開します。  署名を無効にするには、例えばApacheならば構成ファイルに2行を追加します。 ```ini ServerSignature Off ServerTokens Prod ``` PHP署名 (X-Powered-By HTTPヘッダー) は、php.ini構成ファイルを変更することで無効にできます (署名はデフォルトで無効になっています)。 ```ini expose_php = Off ``` 構成ファイルの変更を適用するには、Web サーバーの再起動が必要です。 Apacheでmod\_security (libapache2-mod-security2パッケージ)を使用すると、追加のセキュリティレベルを達成できます。 mod\_securityを使用すると、サーバー署名からバージョンを削除するだけでなく、サーバー署名を削除できます。mod\_securityをインストールした後、"SecServerSignature"を任意の値に変更することで、署名を任意の値に変更できます。 ソフトウェア署名を削除/変更する方法については、Web サーバーのドキュメントを参照してください。 #### Discovered entities When server runs, it will create real items, triggers and graphs based on the values the SNMP discovery rule returns. In the host configuration they are prefixed with an orange link to a discovery rule they come from.    #### 発見されたエンティティ サーバーが実行されると、SNMPディスカバリルールが返す値に基づいて、実際のアイテム、トリガー、およびグラフが作成されます。 ホスト設定では、プレフィックスとして、元のディスカバリルールへのオレンジ色のリンクが付けられます。    ### Discovered host ::: noteclassic Discovered host are created by the Zabbix server and cannot be modified via the API. ::: The discovered host object contains information about a host discovered by a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dhostid|string|ID of the discovered host.| |druleid|string|ID of the discovery rule that detected the host.| |lastdown|timestamp|Time when the discovered host last went down.| |lastup|timestamp|Time when the discovered host last went up.| |status|integer|Whether the discovered host is up or down. A host is up if it has at least one active discovered service.<br><br>Possible values:<br>0 - host up;<br>1 - host down.| ### Discovered host ::: noteclassic 検出されたホストはZabbix server によって作成され、APIから変更することはできません。 ::: 検出されたホストオブジェクトは、ネットワークディスカバリールールによって検出されたホストに関する情報を含んでいます。<br> このオブジェクトは以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |dhostid|string|ID of the discovered host.| |druleid|string|ID of the discovery rule that detected the host.| |lastdown|timestamp|Time when the discovered host last went down.| |lastup|timestamp|Time when the discovered host last went up.| |status|integer|Whether the discovered host is up or down. A host is up if it has at least one active discovered service.<br><br>Possible values:<br>0 - host up;<br>1 - host down.| ### Discovered service ::: noteclassic Discovered services are created by the Zabbix server and cannot be modified via the API. ::: The discovered service object contains information about a service discovered by a network discovery rule on a host. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dserviceid|string|ID of the discovered service.| |dcheckid|string|ID of the discovery check used to detect the service.| |dhostid|string|ID of the discovered host running the service.| |dns|string|DNS of the host running the service.| |ip|string|IP address of the host running the service.| |lastdown|timestamp|Time when the discovered service last went down.| |lastup|timestamp|Time when the discovered service last went up.| |port|integer|Service port number.| |status|integer|Status of the service.<br><br>Possible values:<br>0 - service up;<br>1 - service down.| |value|string|Value returned by the service when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.| ### Discovered service ::: noteclassic 発見されたサービスはZabbix server によって作成され、APIから変更することはできません。 ::: 発見されたサービスオブジェクトは、ホスト上のネットワーク発見ルールによって発見されたサービスに関する情報を<br> 含んでいます。このオブジェクトは以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |dserviceid|string|ID of the discovered service.| |dcheckid|string|ID of the discovery check used to detect the service.| |dhostid|string|ID of the discovered host running the service.| |dns|string|DNS of the host running the service.| |ip|string|IP address of the host running the service.| |lastdown|timestamp|Time when the discovered service last went down.| |lastup|timestamp|Time when the discovered service last went up.| |port|integer|Service port number.| |status|integer|Status of the service.<br><br>Possible values:<br>0 - service up;<br>1 - service down.| |value|string|Value returned by the service when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.| ##### Discovering MBean attributes Discovery item: `jmx.get[attributes,"com.example:type=*,*"]` Response: ``` {.json} [ { "object": "com.example:type=*", "domain": "com.example", "properties": { "type": "Simple" } }, { "object": "com.zabbix:type=yes,domain=zabbix.com,data-source=/dev/rand,ключ=значение,obj=true", "domain": "com.zabbix", "properties": { "type": "Hello", "domain": "com.example", "data-source": "/dev/rand", "ключ": "значение", "obj": true } } ] ``` ##### MBean 属性の検出 検出アイテム: `jmx.get[attributes,"com.example:type=*,*"]` レスポンス: ``` {.json} [ { "object": "com.example:type=*", "domain": "com.example", "properties": { "type": "Simple" } }, { "object": "com.zabbix:type=yes,domain=zabbix.com,data-source=/dev/rand,ключ=значение,obj=true", "domain": "com.zabbix", "properties": { "type": "Hello", "domain": "com.example", "data-source": "/dev/rand", "ключ": "значение", "obj": true } } ] ``` ##### Discovering MBeans Discovery item: `jmx.get[beans,"com.example:type=*,*"]` Response: ``` {.json} [ { "object": "com.example:type=Hello,data-src=data-base,ключ=значение", "domain": "com.example", "properties": { "data-src": "data-base", "ключ": "значение", "type": "Hello" } }, { "object": "com.example:type=Atomic", "domain": "com.example", "properties": { "type": "Atomic" } } ] ``` ##### MBeansの検出 検出アイテム: `jmx.get[beans,"com.example:type=*,*"]` レスポンス: ``` {.json} [ { "object": "com.example:type=Hello,data-src=data-base,ключ=значение", "domain": "com.example", "properties": { "data-src": "data-base", "ключ": "значение", "type": "Hello" } }, { "object": "com.example:type=Atomic", "domain": "com.example", "properties": { "type": "Atomic" } } ] ``` #### Discovery actions The following conditions can be used in discovery-based events: |Condition type|Supported operators|Description| |--|--|------| |*Host IP*|equals<br>does not equal|Specify an IP address range or a range to exclude for a discovered host.<br>**equals** - host IP is in the range.<br>**does not equal** - host IP is not in the range.<br>It may have the following formats:<br>Single IP: 192.168.1.33<br>Range of IP addresses: 192.168.1-10.1-254<br>IP mask: 192.168.4.0/24<br>List: 192.168.1.1-254, 192.168.2.1-100, 192.168.2.200, 192.168.4.0/24<br>Support for spaces in the list format is provided since Zabbix 3.0.0.| |*Service type*|equals<br>does not equal|Specify a service type of a discovered service or a service type to exclude.<br>**equals** - matches the discovered service.<br>**does not equal** - does not match the discovered service.<br>Available service types: SSH, LDAP, SMTP, FTP, HTTP, HTTPS *(available since Zabbix 2.2 version)*, POP, NNTP, IMAP, TCP, Zabbix agent, SNMPv1 agent, SNMPv2 agent, SNMPv3 agent, ICMP ping, telnet *(available since Zabbix 2.2 version)*.| |*Service port*|equals<br>does not equal|Specify a TCP port range of a discovered service or a range to exclude.<br>**equals** - service port is in the range.<br>**does not equal** - service port is not in the range.| |*Discovery rule*|equals<br>does not equal|Specify a discovery rule or a discovery rule to exclude.<br>**equals** - using this discovery rule.<br>**does not equal** - using any other discovery rule, except this one.| |*Discovery check*|equals<br>does not equal|Specify a discovery check or a discovery check to exclude.<br>**equals** - using this discovery check.<br>**does not equal** - using any other discovery check, except this one.| |*Discovery object*|equals|Specify the discovered object.<br>**equals** - equal to discovered object (a device or a service).| |*Discovery status*|equals|**Up** - matches 'Host Up' and 'Service Up' events<br>**Down** - matches 'Host Down' and 'Service Down' events<br>**Discovered** - matches 'Host Discovered' and 'Service Discovered' events<br>**Lost** - matches 'Host Lost' and 'Service Lost' events| |*Uptime/Downtime*|is greater than or equals<br>is less than or equals|Uptime for 'Host Up' and 'Service Up' events. Downtime for 'Host Down' and 'Service Down' events.<br>**is greater than or equals** - is more or equal to. Parameter is given in seconds.<br>**is less than or equals** - is less or equal to. Parameter is given in seconds.| |*Received value*|equals<br>does not equal<br>is greater than or equals<br>is less than or equals<br>contains<br>does not contain|Specify the value received from an agent (Zabbix, SNMP) check in a discovery rule. String comparison. If several Zabbix agent or SNMP checks are configured for a rule, received values for each of them are checked (each check generates a new event which is matched against all conditions).<br>**equals** - equal to the value.<br>**does not equal** - not equal to the value.<br>**is greater than or equals** - more or equal to the value.<br>**is less than or equals** - less or equal to the value.<br>**contains** - contains the substring. Parameter is given as a string.<br>**does not contain** - does not contain the substring. Parameter is given as a string.| |*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.| ::: noteclassic Service checks in a discovery rule, which result in discovery events, do not take place simultaneously. Therefore, if **multiple** values are configured for `Service type`, `Service port` or `Received value` conditions in the action, they will be compared to one discovery event at a time, but **not** to several events simultaneously. As a result, actions with multiple values for the same check types may not be executed correctly. ::: #### ディスカバリアクション 次の条件は、ディスカバリベースのイベントで使用できます。 |タイプ|オペレータ|説明| |--|--|------| |*ホストのIPアドレス*|等しい<br>等しくない|検出されたホストから除外するまたは除外しない IP アドレス範囲を指定します。<br>**等しい** - ホストIPは範囲内<br>**等しくない** - ホストIPは範囲外<br>次のフォーマットを受け付けます:<br>単体IPアドレス: 192.168.1.33<br>IPアドレス範囲: 192.168.1-10.1-254<br>IPマスク: 192.168.4.0/24<br>List: 192.168.1.1-254, 192.168.2.1-100, 192.168.2.200, 192.168.4.0/24<br>リスト形式でのスペースはZabbix 3.0.0 以降でサポートされています。| |*サービスのタイプ*|等しい<br>等しくない|検出されたサービスの除外するまたは除外しないサービスタイプを指定します。<br>**等しい** - 検出されたサービスと一致する<br>**等しくない** - 検出されたサービスと一致しない。<br>使用可能なサービスの種類: SSH, LDAP, SMTP, FTP, HTTP, HTTPS *(Zabbix 2.2 バージョン以降で使用可能)*, POP, NNTP, IMAP, TCP, Zabbix agent, SNMPv1 agent, SNMPv2 agent, SNMPv3 agent, ICMP ping, telnet *(Zabbix 2.2 バージョン以降で使用可能)*.| |*サービスのポート*|等しい<br>等しくない|検出されたサービスの 除外するまたは除外しないTCPポート範囲を指定します。<br>**等しい** - サービスのポートは範囲内<br>**等しくない** - サービスのポートは範囲外| |*ディスカバリルール*|等しい<br>等しくない|除外するまたは除外しないディスカバリルールを指定します。<br>**等しい** - ディスカバリルールを使用する<br>**等しくない** - 他のディスカバリルールを使用する| |*ディスカバリチェック*|等しい<br>等しくない|除外するまたは除外しないディスカバリチェックを指定します。<br>**等しい** - ディスカバリチェックを使用する<br>**does not equal** -他のディスカバリチェックを使用する| |*ディスカバリオブジェクト*|等しい|検出されたオブジェクトを指定<br>**等しい** - 発見されたオブジェクト (デバイスまたはサービス) に等しい| |*ディスカバリのステータス*|等しい|**Up** - 'Host Up' および 'Service Up' イベントに一致<br>**Down** - 'Host Down' および 'Service Down' イベントに一致<br>**Discovered** - 'Host Discovered' および 'Service Discovered' イベントに一致<br>**Lost** - 'Host Lost'および'Service Lost'イベントに一致| |*アップタイム/ダウンタイム*|以上<br>以下|'ホストアップ'および'サービスアップ'イベントのアップタイム。 'ホスト ダウン'および'サービス ダウン'イベントのダウンタイム。<br>**以上** - 以上です。 パラメータは秒単位で指定されます。<br>**以下** - 以下です。 パラメータは秒単位で指定されます。| |*受信した値*|等しい<br>等しくない<br>以上<br>以下<br>含む<br>含まない|ディスカバリルールでエージェント (Zabbix, SNMP)チェックから受け取った値を指定します。文字列比較。1 つのルールに対して複数の Zabbix エージェントまたは SNMP チェックが設定されている場合、それぞれの受信値がチェックされます (各チェックは、すべての条件に一致する新しいイベントを生成します)。<br>**等しい** - 値が等しい<br>**等しくない** - 値は等しくない<br>**以上** - 値は指定値以上<br>**以下** - 値は指定値以下<br>**含む** - 部分文字列が含まれます。 パラメータは文字列として与えられます。<br>**含まれない** - 部分文字列が含まれていません。 パラメータは文字列として与えられます。| |*プロキシ*|等しい<br>等しくない|除外するまたは除外しないプロキシを指定します。<br>**等しい** - このプロキシを使用<br>**等しくない** - 他のプロキシを使用| ::: noteclassic ディスカバリイベントを発生させるディスカバリルールのサービス チェックは、同時には実行されません。 したがって、アクションの`サービスのタイプ`,`サービスのポート`または`受信した値`に複数の値が設定されている場合、それらは一度に 1 つのディスカバリイベントと比較されますが、同時に複数のイベントと比較されることはありません。 その結果、同じチェック タイプに対して複数の値を持つアクションが正しく実行されない場合があります。 ::: ### Discovery check The discovery check object defines a specific check performed by a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dcheckid|string|*(readonly)* ID of the discovery check.| |druleid|string|*(readonly)* ID of the discovery rule that the check belongs to.| |key\_|string|The value of this property differs depending on the type of the check:<br>- key to query for Zabbix agent checks, required;<br>- SNMP OID for SNMPv1, SNMPv2 and SNMPv3 checks, required.| |ports|string|One or several port ranges to check separated by commas. Used for all checks except for ICMP.<br><br>Default: 0.| |snmp\_community|string|SNMP community.<br><br>Required for SNMPv1 and SNMPv2 agent checks.| |snmpv3\_authpassphrase|string|Authentication passphrase used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.| |snmpv3\_authprotocol|integer|Authentication protocol used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.<br><br>Possible values:<br>0 - *(default)* MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |snmpv3\_contextname|string|SNMPv3 context name. Used only by SNMPv3 checks.| |snmpv3\_privpassphrase|string|Privacy passphrase used for SNMPv3 agent checks with security level set to *authPriv*.| |snmpv3\_privprotocol|integer|Privacy protocol used for SNMPv3 agent checks with security level set to *authPriv*.<br><br>Possible values:<br>0 - *(default)* DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |snmpv3\_securitylevel|string|Security level used for SNMPv3 agent checks.<br><br>Possible values:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |snmpv3\_securityname|string|Security name used for SNMPv3 agent checks.| |**type**<br>(required)|integer|Type of check.<br><br>Possible values:<br>0 - SSH;<br>1 - LDAP;<br>2 - SMTP;<br>3 - FTP;<br>4 - HTTP;<br>5 - POP;<br>6 - NNTP;<br>7 - IMAP;<br>8 - TCP;<br>9 - Zabbix agent;<br>10 - SNMPv1 agent;<br>11 - SNMPv2 agent;<br>12 - ICMP ping;<br>13 - SNMPv3 agent;<br>14 - HTTPS;<br>15 - Telnet.| |uniq|integer|Whether to use this check as a device uniqueness criteria. Only a single unique check can be configured for a discovery rule. Used for Zabbix agent, SNMPv1, SNMPv2 and SNMPv3 agent checks.<br><br>Possible values:<br>0 - *(default)* do not use this check as a uniqueness criteria;<br>1 - use this check as a uniqueness criteria.| |host\_source|integer|Source for host name.<br><br>Possible values:<br>1 - *(default)* DNS;<br>2 - IP;<br>3 - discovery value of this check.| |name\_source|integer|Source for visible name.<br><br>Possible values:<br>0 - *(default)* not specified;<br>1 - DNS;<br>2 - IP;<br>3 - discovery value of this check.| ### Discovery check ディスカバリーチェックオブジェクトは、ネットワークディスカバリールールによって実行される特定のチェックを定義します。<br> このオブジェクトは以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |dcheckid|string|*(readonly)* ID of the discovery check.| |druleid|string|*(readonly)* ID of the discovery rule that the check belongs to.| |key\_|string|The value of this property differs depending on the type of the check:<br>- key to query for Zabbix agent checks, required;<br>- SNMP OID for SNMPv1, SNMPv2 and SNMPv3 checks, required.| |ports|string|One or several port ranges to check separated by commas. Used for all checks except for ICMP.<br><br>Default: 0.| |snmp\_community|string|SNMP community.<br><br>Required for SNMPv1 and SNMPv2 agent checks.| |snmpv3\_authpassphrase|string|Authentication passphrase used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.| |snmpv3\_authprotocol|integer|Authentication protocol used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.<br><br>Possible values:<br>0 - *(default)* MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |snmpv3\_contextname|string|SNMPv3 context name. Used only by SNMPv3 checks.| |snmpv3\_privpassphrase|string|Privacy passphrase used for SNMPv3 agent checks with security level set to *authPriv*.| |snmpv3\_privprotocol|integer|Privacy protocol used for SNMPv3 agent checks with security level set to *authPriv*.<br><br>Possible values:<br>0 - *(default)* DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |snmpv3\_securitylevel|string|Security level used for SNMPv3 agent checks.<br><br>Possible values:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |snmpv3\_securityname|string|Security name used for SNMPv3 agent checks.| |**type**<br>(required)|integer|Type of check.<br><br>Possible values:<br>0 - SSH;<br>1 - LDAP;<br>2 - SMTP;<br>3 - FTP;<br>4 - HTTP;<br>5 - POP;<br>6 - NNTP;<br>7 - IMAP;<br>8 - TCP;<br>9 - Zabbix agent;<br>10 - SNMPv1 agent;<br>11 - SNMPv2 agent;<br>12 - ICMP ping;<br>13 - SNMPv3 agent;<br>14 - HTTPS;<br>15 - Telnet.| |uniq|integer|Whether to use this check as a device uniqueness criteria. Only a single unique check can be configured for a discovery rule. Used for Zabbix agent, SNMPv1, SNMPv2 and SNMPv3 agent checks.<br><br>Possible values:<br>0 - *(default)* do not use this check as a uniqueness criteria;<br>1 - use this check as a uniqueness criteria.| |host\_source|integer|Source for host name.<br><br>Possible values:<br>1 - *(default)* DNS;<br>2 - IP;<br>3 - discovery value of this check.| |name\_source|integer|Source for visible name.<br><br>Possible values:<br>0 - *(default)* not specified;<br>1 - DNS;<br>2 - IP;<br>3 - discovery value of this check.| #### Discovery events Zabbix periodically scans the IP ranges defined in network discovery rules. Frequency of the check is configurable for each rule individually. Once a host or a service is discovered, a discovery event (or several events) are generated. Zabbix generates the following events: |Event|When generated| |--|--------| |Service Up|Every time Zabbix detects active service.| |Service Down|Every time Zabbix cannot detect service.| |Host Up|If at least one of the services is UP for the IP.| |Host Down|If all services are not responding.| |Service Discovered|If the service is back after downtime or discovered for the first time.| |Service Lost|If the service is lost after being up.| |Host Discovered|If host is back after downtime or discovered for the first time.| |Host Lost|If host is lost after being up.| #### ディスカバリイベント Zabbix は、ネットワークディスカバリルールで定義された IP 範囲を定期的にスキャンします。 チェックの頻度は、ルールごとに個別に設定できます。 ホストまたはサービスが検出されると、ディスカバリイベント (または複数のイベント) が生成されます。 Zabbix は次のイベントを生成します。 |イベント|発生条件| |--|--------| |Service Up|Zabbix がアクティブなサービスを検出するたびに| |Service Down|Zabbix がサービスを検出できないたびに| |Host Up|少なくとも 1 つのサービスが IP に対して稼働している場合| |Host Down|すべてのサービスが応答していない場合| |Service Discovered|サービスがダウンタイム後に戻った場合、または初めて検出された場合| |Service Lost|起動後にサービスが失われた場合| |Host Discovered|ホストがダウンタイム後に復帰した場合、または初めて検出された場合| |Host Lost|起動後にホストが失われた場合| ### Discovery of disabled systemd units It is now also possible to discover **disabled** systemd units using the *systemd.unit.discovery* item key, supported by Zabbix agent 2. Note that to have items and triggers created from prototypes for disabled systemd units, it may be necessary to adjust (or remove) prohibiting LLD filters for the {#UNIT.ACTIVESTATE} and {#UNIT.UNITFILESTATE} macros. For more details, see [Discovery of systemd services](/manual/discovery/low_level_discovery/examples/systemd). ### 無効化されたsystemdユニットの検知 *systemd.unit.discovery*アイテムキーを使用して、**無効化された**systemdユニットを検出することができるようになりました。Zabbixエージェント2が対応しています。無効化されたsystemdユニットのプロトタイプから作成されたアイテムやトリガーを使用する場合は、{#UNIT.ACTIVESTATE}と{#UNIT.UNITFILESTATE}マクロの禁止するLLDフィルタを調整(または削除)する必要があることに注意してください。 詳しくは[systemdサービスのディスカバリ](/manual/discovery/low_level_discovery/examples/systemd)を参照してください。 ##### Discovery of disabled systemd units Since Zabbix 6.0.1 it is also possible to discover **disabled** systemd units. In this case three macros are returned in the resulting JSON: - {#UNIT.PATH} - {#UNIT.ACTIVESTATE} - {#UNIT.UNITFILESTATE}. ::: noteimportant To have items and triggers created from prototypes for disabled systemd units, make sure to adjust (or remove) prohibiting LLD filters for {#UNIT.ACTIVESTATE} and {#UNIT.UNITFILESTATE}. ::: ##### 無効になっているsystemdユニットの検出 Zabbix 6.0.1以降、**無効**になっているsystemdユニットを検出することもできます。 この場合、結果のJSONで3つのマクロが返されます。 - {#UNIT.PATH} - {#UNIT.ACTIVESTATE} - {#UNIT.UNITFILESTATE}. ::: noteimportant 無効になっているsystemdユニットのプロトタイプからアイテムとトリガーを作成するには、{#UNIT.ACTIVESTATE}と{#UNIT.UNITFILESTATE}のLLDフィルターの禁止を調整（または削除）してください。 ::: ### Discovery of Windows services [Low-level discovery](/manual/discovery/low_level_discovery) provides a way to automatically create items, triggers, and graphs for different entities on a computer. Zabbix can automatically start monitoring Windows services on your machine, without the need to know the exact name of a service or create items for each service manually. A filter can be used to generate real items, triggers, and graphs only for services of interest. #### Windowsサービスの検出 [ローレベルディスカバリ](/manual/discovery/low_level_discovery)は、コンピュータ上のさまざまなエンティティに対して、アイテム、トリガー、およびグラフを自動的に作成する方法を提供します。Zabbixはサービスの正確な把握したり、各サービスのアイテムを手動で作成したりすることなく、監視対象のWindowsサービスの監視を自動的に開始できます。フィルターを使用することで監視を行いたいサービスに対してのみアイテム、トリガー、グラフを生成できます。 # discoveryrule.copy # discoveryrule.copy # discoveryrule.create # discoveryrule.create # discoveryrule.delete # discoveryrule.delete # discoveryrule.get # discoveryrule.get # discoveryrule.update # discoveryrule.update #### Discovery Zabbix can use a low-level discovery rule to automatically discover VMware hypervisors and virtual machines.  All mandatory input fields are marked with a red asterisk. The discovery rule key in the above screenshot is *vmware.hv.discovery\[{$VMWARE.URL}\]*. #### ディスカバリー Zabbixはローレベルディスカバリールールを使用して、VMwareハイパーバイザーと <br> 仮想マシンを自動的に検出することができます。 <br>  すべての必須入力フィールドには、赤いアスタリスクが表示されます。 上記のスクリーンショットのディスカバリールールのキーは次のとおりです。 *vmware.hv.discovery\[{$VMWARE.URL}\]*. #### Discovery Zabbix periodically scans the IP ranges defined in [network discovery rules](/manual/discovery/network_discovery/rule). The frequency of the check is configurable for each rule individually. Note that one discovery rule will always be processed by a single discoverer process. The IP range will not be split between multiple discoverer processes. Each rule has a set of service checks defined to be performed for the IP range. ::: noteclassic Discovery checks are processed independently from the other checks. If any checks do not find a service (or fail), other checks will still be processed. ::: Every check of a service and a host (IP) performed by the network discovery module generates a discovery event. |Event|Check of service result| |--|--------| |*Service Discovered*|The service is 'up' after it was 'down' or when discovered for the first time.| |*Service Up*|The service is 'up', after it was already 'up'.| |*Service Lost*|The service is 'down' after it was 'up'.| |*Service Down*|The service is 'down', after it was already 'down'.| |*Host Discovered*|At least one service of a host is 'up' after all services of that host were 'down' or a service is discovered which belongs to a not registered host.| |*Host Up*|At least one service of a host is 'up', after at least one service was already 'up'.| |*Host Lost*|All services of a host are 'down' after at least one was 'up'.| |*Host Down*|All services of a host are 'down', after they were already 'down'.| #### ディスカバリ Zabbixは[ネットワークディスカバリルール](/manual/discovery/network_discovery/rule) で定義された IP 範囲を定期的にスキャンします。 チェックの頻度はルールごと個別に設定できます。 1 つのディスカバリルールは、常に 1 つのディスカバリプロセスによって処理されることに注意してください。 IP 範囲は、複数のディスカバリプロセス間で分割されません。 各ルールには、IP 範囲に対して実行するように定義された一連のサービス チェックがあります。 ::: noteclassic ディスカバリチェックは、他のチェックとは別に処理されます。 チェックでサービスが見つからない (または失敗した) 場合でも、他のチェックは引き続き処理されます。 ::: ネットワークディスカバリモジュールによって実行されるサービスとホスト (IP) のチェックごとに、ディスカバリイベントが生成されます。 |イベント|サービス結果の確認| |--|--------| |*Service Discovered*|サービスは'ダウン'した後または初めて検出されたときに'アップ'しています。| |*Service Up*|サービスは'アップ'した後、引き続き'アップ'のままです。| |*Service Lost*|サービスは'アップ'した後に'ダウン'しています。| |*Service Down*|サービスは'ダウン'した後、引き続き'ダウン'のままです。| |*Host Discovered*|ホストのすべてのサービスが'ダウン'した後、または登録されていないホストに属するサービスが検出された後、少なくとも 1 つのサービスが'アップ'しています。| |*Host Up*|少なくとも 1 つのサービスが既に’アップ’していた後、ホストの少なくとも 1 つのサービスが引き続き'アップ'のままです。| |*Host Lost*|ホストのすべてのサービスは、少なくとも 1 つが'アップ'した後、'ダウン'しています。| |*Host Down*|ホストのすべてのサービスは、'ダウン'した後、引き続き'ダウン'のままです。| #### Display #### 表示 #### Display Based on acknowledgment information it is possible to configure how the problem count is displayed in the dashboard or maps. To do that, you have to make selections in the *Problem display* option, available in both [map configuration](/manual/config/visualization/maps/map#creating_a_map) and the *Problems by severity* [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard##adding_widgets). It is possible to display all problem count, unacknowledged problem count as separated from the total or unacknowledged problem count only. Based on problem update information (acknowledgment, etc.), it is possible to configure update operations - send a message or execute remote commands. #### 表示 障害の確認状況に基づいて、ダッシュボードやマップでの障害数の表示方法を設定できます。この設定を行うには、 [マップ設定](/manual/config/visualization/maps/map#creating_a_map)、または*障害・深刻度* [ダッシュボードウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard#adding_widgets)から、*障害表示*オプションで選択する必要があります。 すべての障害数、未確認の障害数を分離して表示することが可能です。 障害の更新情報（確認状況など）をもとに、メッセージの送信やリモートコマンドの実行といった更新操作を設定することができます。 ##### Displaying hosts in maintenance An orange wrench icon  next to the host name indicates that this host is in maintenance in: - *Monitoring → Dashboard* - *Monitoring → Problems* - *Inventory → Hosts → Host inventory details* - *Configuration → Hosts* (See 'Status' column)  Maintenance details are displayed when the mouse pointer is positioned over the icon. Additionally, hosts in maintenance get an orange background in *Monitoring → Maps*. ##### メンテナンス中のホストの表示 オレンジ色のレンチアイコン (../../assets/en/manual/web_interface/frontend_sections/configuration/maintenance_wrench_icon.png) は、このホストがメンテナンス中であることを示します。 - *Monitoring → Dashboard* に表示されます。 - *Monitoring → Problems* - *Inventory → Hosts → Host inventory details* - *Host inventory details* ( 'Status' 列を参照)  マウスポインターをアイコンの上に合わせると、メンテナンスの詳細が表示されます。 また、メンテナンス中のホストは *Monitoring → Maps* にオレンジ色の背景が表示されます。 ##### Displaying suppressed problems Normally problems for hosts in maintenance are suppressed, i.e. not displayed in the frontend. However, it is also possible to configure that suppressed problems are shown, by selecting the *Show suppressed problems* option in these locations: - *Monitoring* → *Dashboard* (in *Problem hosts*, *Problems*, *Problems by severity*, *Trigger overview* widget configuration) - *Monitoring* → *Problems* (in the filter) - *Monitoring* → *Maps* (in map configuration) - Global [notifications](/manual/web_interface/user_profile/global_notifications) (in user profile configuration) When suppressed problems are displayed, the following icon is displayed: . Rolling a mouse over the icon displays more details:  ##### ”通知なし”とされた問題の表示 通常、メンテナンス中のホストの問題は”通知なし”とされ、フロントエンドに表示されません。<br> しかし、*Show suppressed problems* オプションを選択することで、”通知なし”とされた問題を表示するよう設定することもできます。<br> - *Monitoring* → *Dashboard* (*Problem hosts* , *Problems* , *Problems by severity* , *Trigger overview* ウィジェット設定) - *Monitoring* → *Problems* (フィルター内) - *Monitoring* → *Maps* (マップ設定内) - Global [notifications](/manual/web_interface/user_profile/global_notifications) (ユーザープロファイル設定内) ”通知なし”とされた問題が表示されている場合、以下のアイコンが表示されます。<br>  アイコンにマウスを乗せると、詳細が表示されます。  #### Displaying trigger status With a trigger defined, you might be interested to see its status. If the CPU load has exceeded the threshold level you defined in the trigger, the problem will be displayed in *Monitoring → Problems*. {width="600"} The flashing in the status column indicates a recent change of trigger status, one that has taken place in the last 30 minutes. #### トリガーステータスの表示 トリガーを定義すると、ステータスを確認したい場合があります。 CPU負荷がトリガーで定義したしきい値を超えた場合、*監視データ → 障害*に表示されます。 {width="600"} ステータス列の点滅は、過去30分間に発生したトリガーステータスの最近の変更を示します。 ##### Display In the item list dependent items are displayed with their master item name as prefix. {width="600"} If a master item is deleted, so are all its dependent items. ##### 表示 アイテムリストでは、依存アイテムはマスターアイテム名をプレフィックスとして表示されます。 {width="600"} マスターアイテムが削除された場合、そのアイテムに依存する依存アイテムもすべて削除されます。 #### Display options The following parameters are supported for configuring *Display options*. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*History data selection*|0|source|0 - *(default)* Auto;<br>1 - History;<br>2 - Trends.| #### 表示オプション *表示オプション*の設定には、以下のパラメータがサポートされています。 |パラメータ|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*履歴データの選択*|0|ソース|0 - *(デフォルト)* 自動;<br>1 - 履歴;<br>2 - トレンド| #### Display The following screen will be displayed when trying to access the Zabbix frontend while in maintenance mode. The screen is refreshed every 30 seconds in order to return to a normal state without user intervention when the maintenance is over.  IP addresses defined in ZBX\_GUI\_ACCESS\_IP\_RANGE will be able to access the frontend as always. #### 表示 メンテナンスモードでZabbixフロントエンドにアクセスしようとすると、次の画面が表示されます。メンテナンス終了後に、ユーザーの介入なしに通常の状態に戻るため、画面は30秒ごとに更新されます。  ZBX\_GUI\_ACCESS\_IP\_RANGEで定義されたIPアドレスは、メンテナンス中でも通常どおりフロントエンドにアクセスできます。 ##### Display This is the result in *Monitoring → Latest data*: {width="600"} Note that if a single numeric value is sent in, the data graph will show a horizontal line to the left and to the right of the time point of the value. #### 表示 *Monitoring → Latest data* での結果です。 {width="600"} なお、単一の数値が送られた場合、データグラフにはその数値の時点の左と右に横線が表示されます。 #### Display To view web scenarios configured for a host, go to *Monitoring → Hosts*, locate the host in the list and click on the *Web* hyperlink in the last column. Click on the scenario name to get detailed information. {width="600"} An overview of web scenarios can also be displayed in *Monitoring → Dashboard* by a Web monitoring widget. Recent results of the web scenario execution are available in the *Monitoring → Latest data* section. #### 画面 ホストに設定されたWebシナリオを表示するには*監視→ホスト*に移動し、リストからホストを見つけて、最後の列の*Web*ハイパーリンクをクリックします。シナリオ名をクリックすると詳細情報が表示されます。 {width="600"} Webシナリオの概要は、Web監視ウィジェットによって*監視→ダッシュボード*に表示することもできます。 Webシナリオ実行の最近の結果は、*監視 → 最新データ*セクションで確認できます。 #### Docker base images Zabbix components are provided on Ubuntu, Alpine Linux and CentOS base images: |Image|Version| |---|---| |[alpine](https://hub.docker.com/_/alpine/)|3.16| |[ubuntu](https://hub.docker.com/_/ubuntu/)|22.04 (jammy)| |[centos](https://hub.docker.com/_/centos/)|8| All images are configured to rebuild latest images if base images are updated. #### Dockerベースイメージ Zabbixコンポーネントは、Ubuntu、Alpine Linux、およびCentOSのベースイメージで提供されます。 |イメージ|バージョン| |---|---| |[alpine](https://hub.docker.com/_/alpine/)|3.16| |[ubuntu](https://hub.docker.com/_/ubuntu/)|22.04 (jammy)| |[centos](https://hub.docker.com/_/centos/)|8| すべてのイメージは、ベースイメージが更新された場合に最新のイメージにリビルドするように設定されています。 #### Docker file sources Everyone can follow Docker file changes using the Zabbix [official repository](https://github.com/zabbix/zabbix-docker) on [github.com](https://github.com/). You can fork the project or make your own images based on official Docker files. #### Dockerファイルのソース [github.com](https://github.com/)のZabbix[公式リポジトリ](https://github.com/zabbix/zabbix-docker)を使用すると、誰でもDockerファイルの変更を追跡できます。 プロジェクトをフォークしたり、公式のDockerファイルに基づいて独自のイメージを作成したりできます。 ### Docker |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |docker.container\_info \[<ID>\]|<|<|<| |Low-level information about a container.|An output of the [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) API call serialized as JSON|**ID** - ID or name of the container|The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.container\_stats \[<ID>\]|<|<|<| |Container resource usage statistics.|An output of the [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) API call and CPU usage percentage serialized as JSON|**ID** - ID or name of the container| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.containers|<|<|<| |A list of containers.|An output of the [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) API call serialized as JSON|\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.containers.discovery\[<options>\]|<|<|<| |A list of containers. Used for [low-level discovery](/manual/discovery/low_level_discovery/).|JSON object |**options** - specifies whether all or only running containers should be discovered. Supported values:<br>*true* - return all containers;<br>*false* - return only running containers (default).| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.data\_usage|<|<|<| |Information about current data usage.|An output of the [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) API call serialized as JSON|\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.images|<|<|<| |A list of images.|An output of the [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) API call serialized as JSON|\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.images.discovery|<|<|<| |A list of images. Used for [low-level discovery](/manual/discovery/low_level_discovery/).|JSON object |\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.info|<|<|<| |System information.|An output of the [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) API call serialized as JSON|\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.ping|<|<|<| |Test if a Docker daemon is alive or not.|1 - connection is alive<br><br>0 - connection is broken|\-| The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| ### Docker |キー|<|<|<| |--|--|------|------| |**説明**|**戻り値**|**パラメータ**|**コメント**| |docker.container\_info \[<ID>\]|<|<|<| |コンテナに関するローレベルインフォメーション|JSON としてシリアル化された [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) API 呼び出しの出力|**ID** - コンテナの IDまたは名前|Agent2 ユーザー ('zabbix') は、十分な権限を得るために'docker'[グループ](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user)に追加する必要があります。 そうしない場合、チェックは失敗します。| |docker.container\_stats \[<ID>\]|<|<|<| |コンテナリソースの使用統計|JSON としてシリアル化された[ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) API 呼び出しの出力とCPU使用率|**ID** - コンテナのIDまたは名前| Agent2 ユーザー ('zabbix') は、十分な権限を得るために'docker'[グループ](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user)に追加する必要があります。 そうしない場合、チェックは失敗します。| |docker.containers|<|<|<| |コンテナリスト|JSON としてシリアル化された [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) API 呼び出しの出力|\-|Agent2 ユーザー ('zabbix') は、十分な権限を得るために'docker'[グループ](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user)に追加する必要があります。 そうしない場合、チェックは失敗します。| |docker.containers.discovery\[<options>\]|<|<|<| |コンテナリスト。 [ローレベルディスカバリ](/manual/discovery/low_level_discovery/)に使用|JSONオブジェクト |**options** - 実行中のコンテナをすべて検出するか、実行中のコンテナのみを検出するかを指定します。 サポートされている値:<br>*true* - すべてのコンテナーを返します。<br>*false* - 実行中のコンテナのみを返します。(default)|Agent2 ユーザー ('zabbix') は、十分な権限を得るために'docker'[グループ](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user)に追加する必要があります。 そうしない場合、チェックは失敗します。| |docker.data\_usage|<|<|<| |現在のデータ使用量に関する情報|JSON としてシリアル化された [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) API 呼び出しの出力|\-|Agent2 ユーザー ('zabbix') は、十分な権限を得るために'docker'[グループ](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user)に追加する必要があります。 そうしない場合、チェックは失敗します。| |docker.images|<|<|<| |イメージリスト|JSON としてシリアル化された [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) API 呼び出しの出力|\-|Agent2 ユーザー ('zabbix') は、十分な権限を得るために'docker'[グループ](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user)に追加する必要があります。 そうしない場合、チェックは失敗します。| |docker.images.discovery|<|<|<| |画像一覧。 [ローレベルディスカバリ](/manual/discovery/low_level_discovery/)に使用|JSONオブジェクト|\-|Agent2 ユーザー ('zabbix') は、十分な権限を得るために'docker'[グループ](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user)に追加する必要があります。 そうしない場合、チェックは失敗します。| |docker.info|<|<|<| |システム情報|JSON としてシリアル化された [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) API 呼び出しの出力|\-|Agent2 ユーザー ('zabbix') は、十分な権限を得るために'docker'[グループ](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user)に追加する必要があります。 そうしない場合、チェックは失敗します。| |docker.ping|<|<|<| |Docker デーモンが動作しているかどうかをテストします|1 - 動作しています<br><br>0 - 切断されています|\-|Agent2 ユーザー ('zabbix') は、十分な権限を得るために'docker'[グループ](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user)に追加する必要があります。 そうしない場合、チェックは失敗します。| # drule.create # drule.create # drule.delete # drule.delete # drule.get # drule.get # drule.update # drule.update # dservice.get # dservice.get #### Dynamic widgets When [configuring](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) some of the widgets: - Classic graph - Graph prototype - Item value - Plain text - URL there is an extra option called *Dynamic item*. You can check this box to make the widget dynamic - i.e. capable of displaying different content based on the selected host. Now, when saving the dashboard, you will notice that a new host selection field has appeared atop the dashboard for selecting the host (while the *Select* button allows selecting the host group in a popup):  Thus you have a widget, which can display content that is based on the data from the host that is selected. The benefit of this is that you do not need to create extra widgets just because, for example, you want to see the same graphs containing data from various hosts. #### ダイナミックウィジェット [設定](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)が以下のウィジェットの場合 - クラシックグラフ - グラフプロトタイプ - アイテムの値 - プレーンテキスト - URL *ダイナミックアイテム* と呼ばれる追加のオプションがあります。 このボックスをオンにすると、ウィジェットを動的にすることができます。つまり、選択したホストに基づいてさまざまなコンテンツを表示できます。 これで、ダッシュボードを保存すると、ホストを選択するための新しいホスト選択フィールドがダッシュボードの上に表示されます（*選択*ボタンを使用すると、ポップアップでホストグループを選択できます）。  このようにして、選択されたホストからのデータに基づくコンテンツを表示できるウィジェットが作成できます。 これの利点は、たとえば、さまざまなホストからのデータを含む同じグラフを表示したいという理由だけで、追加のウィジェットを作成する必要がないことです。 #### Easy Connect Easy Connect uses the following parameters to connect to the database: - *Host* - the host name or IP address of the database server computer (DBHost parameter in the configuration file). - *Port* - the listening port on the database server (DBPort parameter in the configuration file; if not set the default 1521 port will be used). - <service\_name> - the service name of the database you want to access (DBName parameter in the configuration file). **Example:** Database parameters set in the server or proxy configuration file (zabbix\_server.conf and zabbix\_proxy.conf): DBHost=localhost DBPort=1521 DBUser=myusername DBName=ORCL DBPassword=mypassword Connection string used by Zabbix to establish connection: DBUser/DBPassword@DBHost:DBPort/DBName During Zabbix frontend installation, set the corresponding parameters in the *Configure DB connection* step of the setup wizard: - Database host: localhost - Database port: 1521 - Database name: ORCL - User: myusername - Password: mypassword {width="600"} Alternatively, these parameters can be set in the frontend configuration file (zabbix.conf.php): $DB["TYPE"] = 'ORACLE'; $DB["SERVER"] = 'localhost'; $DB["PORT"] = '1521'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; #### Easy Connect Easy Connectは、次のパラメーターを使用してデータベースに接続します。 - *Host* - データベースサーバーのホスト名またはIPアドレス（構成ファイルのDBHostパラメーター） - *Port* - データベースサーバーのリスニングポート（構成ファイルのDBPortパラメーター。設定されていない場合はデフォルトの1521ポートが使用されます） - <service\_name> - アクセスするデータベースのサービス名（構成ファイルのDBNameパラメーター） **例** サーバーまたはプロキシ設定ファイル（zabbix\_server.confおよびzabbix\_proxy.conf）で設定されたデータベースパラメータ： DBHost=localhost DBPort=1521 DBUser=myusername DBName=ORCL DBPassword=mypassword Zabbixが接続を確立するために使用する接続文字列： DBUser/DBPassword@DBHost:DBPort/DBName Zabbixフロントエンドのインストール中に、セットアップウィザードの*データベース接続設定*ステップで対応するパラメータを設定します。 - Database host: localhost - Database port: 1521 - Database name: ORCL - User: myusername - Password: mypassword {width="600"} またはこれらのパラメーターをフロントエンド構成ファイル（zabbix.conf.php）で設定することもできます。 $DB["TYPE"] = 'ORACLE'; $DB["SERVER"] = 'localhost'; $DB["PORT"] = '1521'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; ##### Editing linked entities If you try to edit an item or trigger that was linked from the template, you may realize that many key options are disabled for editing. This makes sense as the idea of templates is that things are edited in one-touch manner on the template level. However, you still can, for example, enable/disable an item on the individual host and set the update interval, history length and some other parameters. ::: noteimportant Any customizations to the entities implemented on a template-level will override the previous customizations of the entities on a host-level. ::: If you want to edit the entity fully, you have to edit it on the template level (template level shortcut is displayed in the form name), keeping in mind that these changes will affect all hosts that have this template linked to them. ##### リンクされたエンティティの編集 テンプレートからリンクされたアイテムまたはトリガーを編集しようとすると、多くの主要なオプションが編集できなくなっています。テンプレートの考え方としては、テンプレートレベルでワンタッチで編集するというものであるため、これは理にかなっています。 ただし、個々のホストでアイテムを有効/無効にしたり、更新間隔、履歴の長さ、その他のパラメーターを設定したりすることはできます。 ::: noteimportant テンプレート レベルで実装されたエンティティに対するカスタマイズは、ホスト レベルでのエンティティの以前のカスタマイズを上書きします。 ::: エンティティを完全に編集する場合は、テンプレート レベルで編集する必要があります (テンプレート レベルのショートカットがフォーム名に表示されます)。これらの変更は、このテンプレートがリンクされているすべてのホストに影響することに注意してください。 ### Editing services Click on the *Edit* button to access the edit mode. When in edit mode, the listing is complemented with checkboxes before the entries and also these additional options: -  - add a child service to this service -  - edit this service -  - delete this service {width="600"} To [configure](/manual/it_services/service) a new service, click on the *Create service* button in the top right-hand corner. ### サービスの編集 *編集*ボタンをクリックして編集モードにアクセスします。 編集モードの場合、リストはエントリの前のチェックボックスと次の追加オプションで補完されます。 -  - このサービスに子サービスを追加します -  - サービスを編集します -  - サービスを削除します {width="600"} 新しいサービスを[設定](/manual/it_services/service)するには、右上隅にある*サービスの作成*ボタンをクリックします。 ### Editing services Click on the *Edit* button to access the edit mode. When in edit mode, the listing is complemented with checkboxes before the entries and also these additional options: -  - add a child service to this service -  - edit this service -  - delete this service {width="600"} To [configure](#service_configuration) a new service, click on the *Create service* button in the top right-hand corner. Two buttons below the list offer some mass-editing options: - *Mass update* - mass update service properties - *Delete* - delete the services To use these options, mark the checkboxes before the respective services, then click on the required button. ### サービスの編集 *編集* ボタンをクリックして編集モードにアクセスします。 編集モードではエントリの前にチェックボックスと次の追加オプションが表示されます。 -  - このサービスに子サービスを追加します -  - サービスを編集します -  - サービスを削除します {width="600"} 新しいサービスを[設定](#service_configuration)するには、右上隅にある*サービスの作成*ボタンをクリックします。 リストの下にある 2 つのボタンには、いくつかの一括編集オプションがあります。 - *一括更新* - 複数のサービスを一括で更新します - *削除* - サービスを削除します これらのオプションを使用するには、それぞれのサービスの前にあるチェックボックスをマークしてから、必要なボタンをクリックします。 ##### Element configuration ##### エレメント構成 #### Element tags Element tag values are explained in the table below. #### Element タグ Element タグの値については、以下の表で説明する。 #### Element tags Element tag values are explained in the table below. #### Element タグ Element タグの値については、下表のとおりです。 #### Element tags Element tag values are explained in the table below. |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |media\_types| |\-| | |Root element for media\_types.| | |name|x|`string`| |Media type name.| | |type|x|`string`|0 - EMAIL<br>1 - SMS<br>2 - SCRIPT<br>4 - WEBHOOK|Transport used by the media type.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Whether the media type is enabled.| | |max\_sessions|\-|`integer`|Possible values for SMS: 1 - (default)<br><br>Possible values for other media types: 0-100, 0 - unlimited|The maximum number of alerts that can be processed in parallel.| | |attempts|\-|`integer`|1-10 (default: 3)|The maximum number of attempts to send an alert.| | |attempt\_interval|\-|`string`|0-60s (default: 10s)|The interval between retry attempts.<br><br>Accepts seconds and time unit with suffix.| | |description|\-|`string`| |Media type description.| |message\_templates| |\-| | |Root element for media type message templates.| | |event\_source|x|`string`|0 - TRIGGERS<br>1 - DISCOVERY<br>2 - AUTOREGISTRATION<br>3 - INTERNAL|Event source.| | |operation\_mode|x|`string`|0 - PROBLEM<br>1 - RECOVERY<br>2 - UPDATE|Operation mode.| | |subject|\-|`string`| |Message subject.| | |message|\-|`string`| |Message body.| |*Used only by e-mail media type*|<|<|<|<|<| | |smtp\_server|x|`string`| |SMTP server.| | |smtp\_port|\-|`integer`|Default: 25|SMTP server port to connect to.| | |smtp\_helo|x|`string`| |SMTP helo.| | |smtp\_email|x|`string`| |Email address from which notifications will be sent.| | |smtp\_security|\-|`string`|0 - NONE (default)<br>1 - STARTTLS<br>2 - SSL\_OR\_TLS|SMTP connection security level to use.| | |smtp\_verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|SSL verify host for SMTP. Optional if smtp\_security is STARTTLS or SSL\_OR\_TLS.| | |smtp\_verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|SSL verify peer for SMTP. Optional if smtp\_security is STARTTLS or SSL\_OR\_TLS.| | |smtp\_authentication|\-|`string`|0 - NONE (default)<br>1 - PASSWORD|SMTP authentication method to use.| | |username|\-|`string`| |Username.| | |password|\-|`string`| |Authentication password.| | |content\_type|\-|`string`|0 - TEXT<br>1 - HTML (default)|Message format.| |*Used only by SMS media type*|<|<|<|<|<| | |gsm\_modem|x|`string`| |Serial device name of the GSM modem.| |*Used only by script media type*|<|<|<|<|<| | |script name|x|`string`| |Script name.| |parameters| |\-| | |Root element for script parameters.| |*Used only by webhook media type*|<|<|<|<|<| | |script|x|`string`| |Script.| | |timeout|\-|`string`|1-60s (default: 30s)|Javascript script HTTP request timeout interval.| | |process\_tags|\-|`string`|0 - NO (default)<br>1 - YES|Whether to process returned tags.| | |show\_event\_menu|\-|`string`|0 - NO (default)<br>1 - YES|If {EVENT.TAGS.\*} were successfully resolved in event\_menu\_url and event\_menu\_name fields, this field indicates presence of entry in the event menu.| | |event\_menu\_url|\-|`string`| |URL of the event menu entry. Supports {EVENT.TAGS.\*} macro.| | |event\_menu\_name|\-|`string`| |Name of the event menu entry. Supports {EVENT.TAGS.\*} macro.| |parameters| |\-| | |Root element for webhook media type parameters.| | |name|x|`string`| |Webhook parameter name.| | |value|\-|`string`| |Webhook parameter value.| #### 要素のタグ 要素のタグの値は下表のとおりです。 |Element|Element プロパティ|必須|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |media\_types|<|\-|<|<|Root element for media\_types.| |<|name|x|`string`|<|Media type name.| |<|type|x|`string`|0 - EMAIL<br>1 - SMS<br>2 - SCRIPT<br>4 - WEBHOOK|Transport used by the media type.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Whether the media type is enabled.| |<|max\_sessions|\-|`integer`|Possible values for SMS: 1 - (default)<br><br>Possible values for other media types: 0-100, 0 - unlimited|The maximum number of alerts that can be processed in parallel.| |<|attempts|\-|`integer`|1-10 (default: 3)|The maximum number of attempts to send an alert.| |<|attempt\_interval|\-|`string`|0-60s (default: 10s)|The interval between retry attempts.<br><br>Accepts seconds and time unit with suffix.| |<|description|\-|`string`|<|Media type description.| |message\_templates|<|\-|<|<|Root element for media type message templates.| |<|event\_source|x|`string`|0 - TRIGGERS<br>1 - DISCOVERY<br>2 - AUTOREGISTRATION<br>3 - INTERNAL|Event source.| |<|operation\_mode|x|`string`|0 - PROBLEM<br>1 - RECOVERY<br>2 - UPDATE|Operation mode.| |<|subject|\-|`string`|<|Message subject.| |<|message|\-|`string`|<|Message body.| |Used only by e-mail media type|<|<|<|<|<| |<|smtp\_server|x|`string`|<|SMTP server.| |<|smtp\_port|\-|`integer`|Default: 25|SMTP server port to connect to.| |<|smtp\_helo|x|`string`|<|SMTP helo.| |<|smtp\_email|x|`string`|<|Email address from which notifications will be sent.| |<|smtp\_security|\-|`string`|0 - NONE (default)<br>1 - STARTTLS<br>2 - SSL\_OR\_TLS|SMTP connection security level to use.| |<|smtp\_verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|SSL verify host for SMTP. Optional if smtp\_security is STARTTLS or SSL\_OR\_TLS.| |<|smtp\_verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|SSL verify peer for SMTP. Optional if smtp\_security is STARTTLS or SSL\_OR\_TLS.| |<|smtp\_authentication|\-|`string`|0 - NONE (default)<br>1 - PASSWORD|SMTP authentication method to use.| |<|username|\-|`string`|<|Username.| |<|password|\-|`string`|<|Authentication password.| |<|content\_type|\-|`string`|0 - TEXT<br>1 - HTML (default)|Message format.| |Used only by SMS media type|<|<|<|<|<| |<|gsm\_modem|x|`string`|<|Serial device name of the GSM modem.| |Used only by script media type|<|<|<|<|<| |<|script name|x|`string`|<|Script name.| |parameters|<|\-|<|<|Root element for script parameters.| |Used only by webhook media type|<|<|<|<|<| |<|script|x|`string`|<|Script.| |<|timeout|\-|`string`|1-60s (default: 30s)|Javascript script HTTP request timeout interval.| |<|process\_tags|\-|`string`|0 - NO (default)<br>1 - YES|Whether to process returned tags.| |<|show\_event\_menu|\-|`string`|0 - NO (default)<br>1 - YES|If {EVENT.TAGS.\*} were successfully resolved in event\_menu\_url and event\_menu\_name fields, this field indicates presence of entry in the event menu.| |<|event\_menu\_url|\-|`string`|<|URL of the event menu entry. Supports {EVENT.TAGS.\*} macro.| |<|event\_menu\_name|\-|`string`|<|Name of the event menu entry. Supports {EVENT.TAGS.\*} macro.| |parameters|<|\-|<|<|Root element for webhook media type parameters.| |<|name|x|`string`|<|Webhook parameter name.| |<|value|\-|`string`|<|Webhook parameter value.| #### Ember+ A new plugin for direct monitoring of Ember+ by Zabbix agent 2 has been added. For more information, see: - [Ember+ plugin readme](https://git.zabbix.com/projects/AP/repos/ember-plus/browse?at=refs%2Fheads%2Frelease%2F6.0) - [Agent 2 items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#ember) - [Ember+ plugin parameters](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin) - [Agent 2 installation](/manual/concepts/agent2#installation) #### Ember+ Zabbixエージェント2によるEmber+の直接監視用の新しいプラグインが追加されました。 詳細は以下をご覧ください : - [Ember+プラグイン readme](https://git.zabbix.com/projects/AP/repos/ember-plus/browse?at=refs%2Fheads%2Frelease%2F6.0) - [Zabbixエージェント2のアイテム](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#ember) - [Ember+プラグインのパラメーター](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin) - [Zabbixエージェント2のインストール](/manual/concepts/agent2#installation) ### Ember+ |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |ember.get\[<uri>,<path>\]|<|<|<| |Returns the result of the required device.|JSON object|**uri** - Ember+ device URI. Default: 127.0.0.1:9998<br>**path** - OID path to device. Empty by default, returns root collection data.| | ### Ember+ |キー|<|<|<| |--|--|------|------| |**説明**|**戻り値**|**パラメータ**|**コメント**| |ember.get\[<uri>,<path>\]|<|<|<| |要求されたデバイスの結果を返します。|JSONオブジェクト|**uri** - Ember+ デバイスのURI。デフォルト: 127.0.0.1:9998<br>**path** - デバイスへのOIDパス。デフォルトでは空で、ルートコレクションデータを返します。| | #### Enabling a host Enable host monitoring, i.e. set its status to 0. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### ホストの有効化 ホストの監視を有効にする、つまりステータスを0にします。 リクエスト: ``` {.java} { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ``` {.java} { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### Enabling a media type Enable a media type, that is, set its status to "0". Request: ```json { "jsonrpc": "2.0", "method": "mediatype.update", "params": { "mediatypeid": "6", "status": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "6" ] }, "id": 1 } ``` #### メディアタイプの有効化 ステータスを"0"に設定して、メディアタイプを有効にします。 Request: ```json { "jsonrpc": "2.0", "method": "mediatype.update", "params": { "mediatypeid": "6", "status": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "6" ] }, "id": 1 } ``` #### Enabling an item Enable an item, that is, set its status to "0". Request: ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "10092", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 1 } ``` #### アイテムの有効化 ステータスを"0"に設定してアイテムを有効化します。 Request: ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "10092", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 1 } ``` #### Enabling a trigger Enable a trigger, that is, set its status to 0. Request: ```json { "jsonrpc": "2.0", "method": "trigger.update", "params": { "triggerid": "13938", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### トリガーの有効化 ステータスを 0 に設定して、トリガーを有効にします。 Request: ```json { "jsonrpc": "2.0", "method": "trigger.update", "params": { "triggerid": "13938", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### Enabling a trigger prototype Enable a trigger prototype, that is, set its status to 0. Request: ```json { "jsonrpc": "2.0", "method": "triggerprototype.update", "params": { "triggerid": "13938", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### トリガープロトタイプの有効化 ステータスを0に設定してトリガープロトタイプを有効にします Request: ```json { "jsonrpc": "2.0", "method": "triggerprototype.update", "params": { "triggerid": "13938", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### Enabling a web scenario Enable a web scenario, that is, set its status to "0". Request: ```json { "jsonrpc": "2.0", "method": "httptest.update", "params": { "httptestid": "5", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Webシナリオの有効化 ステータスを"0"に設定してWebシナリオを有効にします。 Request: ```json { "jsonrpc": "2.0", "method": "httptest.update", "params": { "httptestid": "5", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Enabling Content Security Policy (CSP) on the web server To protect Zabbix frontend against Cross Site Scripting (XSS), data injection, and similar attacks, we recommend enabling Content Security Policy on the web server. To do so, configure the web server to return the [HTTP header](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy). ::: noteimportant The following CSP header configuration is only for the default Zabbix frontend installation and for cases when all content originates from the site's domain (excluding subdomains). A different CSP header configuration may be required if you are, for example, configuring the [*URL*](/manual/web_interface/frontend_sections/dashboards/widgets/url) widget to display content from the site's subdomains or external domains, switching from *OpenStreetMap* to another map engine, or adding external CSS or widgets. ::: To enable CSP for your Zabbix frontend in Apache configuration, follow these steps: 1\. Locate your virtual host's configuration file: - `/etc/httpd/conf/httpd.conf` on RHEL-based systems - `/etc/apache2/sites-available/000-default.conf` on Debian/Ubuntu 2\. Add the following directive to your virtual host's configuration file: ```ini <VirtualHost *:*> Header set Content-Security-Policy: "default-src 'self' *.openstreetmap.org; script-src 'self' 'unsafe-inline' 'unsafe-eval'; connect-src 'self'; img-src 'self' data: *.openstreetmap.org; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self';" </VirtualHost> ``` 3\. Restart the Apache service to apply the changes: ```bash # On RHEL-based systems: systemctl restart httpd.service # On Debian/Ubuntu systemctl restart apache2.service ``` #### Webサーバーでコンテンツセキュリティポリシー (CSP)を有効にする Zabbix Webインターフェースをクロスサイトスクリプティング (XSS)、データ インジェクション、および同様の攻撃から保護するには、Webサーバーでコンテンツセキュリティポリシーを有効にすることをお勧めします。 これを行うには、[HTTPヘッダー](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy)を返すようにWeb サーバーを設定します。 ::: noteimportant 次のCSPヘッダー設定は、デフォルトのZabbix Webインターフェースインストールおよびすべてのコンテンツがサイトのドメイン (サブドメインを除く) から発信されている場合にのみ適用されます。 たとえば、サイトのサブドメインまたは外部ドメインのコンテンツを表示するように [*URL*](/manual/web_interface/frontend_sections/dashboards/widgets/url) ウィジェットを構成している場合、別のCSPヘッダー構成が必要になる場合があります。 *OpenStreetMap*を別のマップエンジンに追加するか、外部CSSまたはウィジェットを追加します。 ::: Apache構成でZabbix WebインターフェースのCSPを有効にするには、次の手順に従います。 1\. 仮想ホストの設定ファイルを見つけます。 - RHELベースのシステムの場合、`/etc/httpd/conf/httpd.conf` - Debian/Ubuntuの場合、`/etc/apache2/sites-available/000-default.conf` 2\. 次のディレクティブを仮想ホストの設定ファイルに追加します。 ```ini <VirtualHost *:*> Header set Content-Security-Policy: "default-src 'self' *.openstreetmap.org; script-src 'self' 'unsafe-inline' 'unsafe-eval'; connect-src 'self'; img-src 'self' data: *.openstreetmap.org; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self';" </VirtualHost> ``` 3\. 変更を適用させるため、Apacheサービスを再起動します。 ```bash # On RHEL-based systems: systemctl restart httpd.service # On Debian/Ubuntu systemctl restart apache2.service ``` ### Enabling high availability ### 高可用性の有効化 #### Enabling HTTP Strict Transport Security (HSTS) on the web server To protect Zabbix frontend against protocol downgrade attacks, we recommend enabling [HSTS](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security) policy on the web server. To enable HSTS policy for your Zabbix frontend in Apache configuration, follow these steps: 1\. Locate your virtual host's configuration file: - `/etc/httpd/conf/httpd.conf` on RHEL-based systems - `/etc/apache2/sites-available/000-default.conf` on Debian/Ubuntu 2\. Add the following directive to your virtual host's configuration file: ```ini <VirtualHost *:*> Header set Strict-Transport-Security "max-age=31536000" </VirtualHost> ``` 3\. Restart the Apache service to apply the changes: ```bash # On RHEL-based systems: systemctl restart httpd.service # On Debian/Ubuntu systemctl restart apache2.service ``` #### WebサーバーでHTTP Strict Transport Security (HSTS)を有効にする Zabbix Webコンソールをプロトコルダウングレード攻撃から保護するには、Webサーバーで[HSTS](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security)ポリシーを有効にすることをお勧めします。 Apache構成でZabbixフロントエンドのHSTSポリシーを有効にするには、次の手順に従います。 1\. 仮想ホストの構成ファイルを見つけます。 - RHELベースのシステムの場合、`/etc/httpd/conf/httpd.conf` - Debian/Ubuntuの場合、`/etc/apache2/sites-available/000-default.conf` 2\. 次のディレクティブを仮想ホストの設定ファイルに追加します。 ```ini <VirtualHost *:*> Header set Strict-Transport-Security "max-age=31536000" </VirtualHost> ``` 3\. 変更を適用させるため、Apacheサービスを再起動します。 ```bash # On RHEL-based systems: systemctl restart httpd.service # On Debian/Ubuntu systemctl restart apache2.service ``` #### Enabling MIB files On RedHat-based systems the mib files should be enabled by default. On Debian-based systems you have to edit file `/etc/snmp/snmp.conf` and comment out the line that says `mibs :` # As the snmp packages come without MIB files due to license reasons, loading # of MIBs is disabled by default. If you added the MIBs you can re-enable # loading them by commenting out the following line. #mibs : #### MIBファイルの有効化 RedHat ベースのシステムでは、mib ファイルはデフォルトで有効になっているはずです。<br> Debian ベースのシステムでは、ファイル `/etc/snmp/snmp.conf` を編集し、`mibs :`snmp.conf` という行と<br> `mibs :` という行をコメントアウトしてください。<br> # snmp のパッケージにはライセンスの関係で MIB ファイルが含まれていないため、 # MIBの読み込みはデフォルトで無効になっています。 # MIBを追加した場合は、以下の行をコメントアウトすることで、MIBの読み込みを再度有効にすることができます。 #mibs : #### Enabling multiple hosts Enable monitoring of two hosts, i.e., set their status to 0. Request: ``` {.java} { "jsonrpc": "2.0", "method": "host.massupdate", "params": { "hosts": [ { "hostid": "69665" }, { "hostid": "69666" } ], "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### 複数ホストの監視を有効にする 2台のホストの監視を有効にする。（ステータスを0にする） Request: ``` {.java} { "jsonrpc": "2.0", "method": "host.massupdate", "params": { "hosts": [ { "hostid": "69665" }, { "hostid": "69666" } ], "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### Enabling remote JMX monitoring for Java application A Java application does not need any additional software installed, but it needs to be started with the command-line options specified below to have support for remote JMX monitoring. As a bare minimum, if you just wish to get started by monitoring a simple Java application on a local host with no security enforced, start it with these options: java \ -Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port=12345 \ -Dcom.sun.management.jmxremote.authenticate=false \ -Dcom.sun.management.jmxremote.ssl=false \ -Dcom.sun.management.jmxremote.registry.ssl=false \ -jar /usr/share/doc/openjdk-6-jre-headless/demo/jfc/Notepad/Notepad.jar This makes Java listen for incoming JMX connections on port 12345, from local host only, and tells it not to require authentication or SSL. If you want to allow connections on another interface, set the -Djava.rmi.server.hostname parameter to the IP of that interface. If you wish to be more stringent about security, there are many other Java options available to you. For instance, the next example starts the application with a more versatile set of options and opens it to a wider network, not just local host. java \ -Djava.rmi.server.hostname=192.168.3.14 \ -Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port=12345 \ -Dcom.sun.management.jmxremote.authenticate=true \ -Dcom.sun.management.jmxremote.password.file=/etc/java-6-openjdk/management/jmxremote.password \ -Dcom.sun.management.jmxremote.access.file=/etc/java-6-openjdk/management/jmxremote.access \ -Dcom.sun.management.jmxremote.ssl=true \ -Dcom.sun.management.jmxremote.registry.ssl=true \ -Djavax.net.ssl.keyStore=$YOUR_KEY_STORE \ -Djavax.net.ssl.keyStorePassword=$YOUR_KEY_STORE_PASSWORD \ -Djavax.net.ssl.trustStore=$YOUR_TRUST_STORE \ -Djavax.net.ssl.trustStorePassword=$YOUR_TRUST_STORE_PASSWORD \ -Dcom.sun.management.jmxremote.ssl.need.client.auth=true \ -jar /usr/share/doc/openjdk-6-jre-headless/demo/jfc/Notepad/Notepad.jar Most (if not all) of these settings can be specified in `/etc/java-6-openjdk/management/management.properties` (or wherever that file is on your system). Note that if you wish to use SSL, you have to modify startup.sh script by adding `-Djavax.net.ssl.*` options to Java gateway, so that it knows where to find key and trust stores. See [Monitoring and Management Using JMX](http://download.oracle.com/javase/1.5.0/docs/guide/management/agent.html) for a detailed description. #### Java アプリケーションの JMX リモート監視の有効化 Javaアプリケーションは、追加のソフトウェアをインストールする必要はありませんが、リモートJMX監視をサポートするためには、<br> 以下に指定するコマンドラインオプションを使用して起動することが必要です。 最低限、ローカルホスト上の単純なJavaアプリケーションをセキュリティなしで監視することから始めたい場合は、以下のオプションで起動してください。 java \ -Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port=12345 \ -Dcom.sun.management.jmxremote.authenticate=false \ -Dcom.sun.management.jmxremote.ssl=false \ -Dcom.sun.management.jmxremote.registry.ssl=false \ -jar /usr/share/doc/openjdk-6-jre-headless/demo/jfc/Notepad/Notepad.jar これは、Javaがローカルホストからの12345番ポート上の着信JMX接続をリッスンするようにし、<br> 認証やSSLを要求しないように指示します。 別のインタフェースでの接続を許可する場合は、-Djava.rmi.server.hostnameパラメータを<br> そのインタフェースのIPに設定します。 もし、セキュリティにもっと厳しくしたいのであれば、他にも多くのJavaのオプションがあります。<br> 例えば、次の例では、より多用途なオプションのセットでアプリケーションを開始し、ローカルホストだけでなく、<br> より広いネットワークに開放しています。 java \ -Djava.rmi.server.hostname=192.168.3.14 \ -Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port=12345 \ -Dcom.sun.management.jmxremote.authenticate=true \ -Dcom.sun.management.jmxremote.password.file=/etc/java-6-openjdk/management/jmxremote.password \ -Dcom.sun.management.jmxremote.access.file=/etc/java-6-openjdk/management/jmxremote.access \ -Dcom.sun.management.jmxremote.ssl=true \ -Dcom.sun.management.jmxremote.registry.ssl=true \ -Djavax.net.ssl.keyStore=$YOUR_KEY_STORE \ -Djavax.net.ssl.keyStorePassword=$YOUR_KEY_STORE_PASSWORD \ -Djavax.net.ssl.trustStore=$YOUR_TRUST_STORE \ -Djavax.net.ssl.trustStorePassword=$YOUR_TRUST_STORE_PASSWORD \ -Dcom.sun.management.jmxremote.ssl.need.client.auth=true \ -jar /usr/share/doc/openjdk-6-jre-headless/demo/jfc/Notepad/Notepad.jar これらの設定のほとんど（すべてではないにしても）は、/etc/java-6-openjdk/management/management.properties <br> （または別の場所にあるそのファイル）に指定することができます。 SSLを使用したい場合は、startup.shスクリプトを変更して、Java gateway に `-Djavax.net.ssl.*` オプションを追加し、<br> 鍵とトラストストアの場所を認識させる必要があることに注意してください。 [Monitoring and Management Using JMX](http://download.oracle.com/javase/1.5.0/docs/guide/management/agent.html)を参照してください。 #### Enabling Zabbix on root directory of URL On RHEL-based systems, add a virtual host to Apache configuration (`/etc/httpd/conf/httpd.conf`) and set permanent redirect for document root to Zabbix SSL URL. Note that *example.com* should be replaced with the actual name of the server. ```ini # Add lines: <VirtualHost *:*> ServerName example.com Redirect permanent / https://example.com </VirtualHost> ``` Restart the Apache service to apply the changes: ```bash systemctl restart httpd.service ``` #### URLのルートディレクトリでZabbixを有効にする RHEL ベースのシステムでは、仮想ホストをApache構成 (`/etc/httpd/conf/httpd.conf`)に追加し、ドキュメントルートの永続的なリダイレクトをZabbix SSL URLに設定します。 *example.com* は実際のサーバー名に置き換えてください。 ```ini # Add lines: <VirtualHost *:*> ServerName example.com Redirect permanent / https://example.com </VirtualHost> ``` 変更を適用するため、Apacheサービスを再起動します。 ```bash systemctl restart httpd.service ``` #### Encoding settings To make sure that the acquired data are not corrupted you may specify the correct encoding for processing the check (e.g. 'vfs.file.contents') in the `encoding` parameter. The list of supported encodings (code page identifiers) may be found in documentation for [libiconv](http://www.gnu.org/software/libiconv/) (GNU Project) or in Microsoft Windows SDK documentation for "Code Page Identifiers". If no encoding is specified in the `encoding` parameter the following resolution strategies are applied: - If encoding is not specified (or is an empty string) it is assumed to be UTF-8, the data is processed "as-is"; - BOM analysis - applicable for items 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'. An attempt is made to determine the correct encoding by using the byte order mark (BOM) at the beginning of the file. If BOM is not present - standard resolution (see above) is applied instead. #### エンコーディング設定 取得したデータが破損していないことを確認するために、チェック処理に正しいエンコードを指定することができます。<br> チェック処理に適したエンコーディング(例: 'vfs.file.contents')を `encoding` パラメータで指定します。<br> サポートされているエンコーディングのリスト(コードページ識別子) の一覧は、 [libiconv](http://www.gnu.org/software/libiconv/) (GNUプロジェクト)のドキュメントや、<br> Microsoft Windows SDK documentation for "Code Page Identifiers "を参照してください。<br> もし、`encoding` パラメータでエンコーディングを指定しない場合は、以下の解決方法が適用されます。<br> - エンコーディングが指定されていない場合（または空文字列の場合）、UTF-8であるとみなされ、データは「そのまま」処理されます。<br> - BOM解析 - 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch' の item に適用されます。<br> ファイルの先頭にあるバイトオーダーマーク(BOM)を使って、正しいエンコーディングを決定しようとします。<br> BOMが存在しない場合，代わりに標準的なエンコーディングが適用されます。<br> ##### Encryption The **Encryption** tab allows you to require [encrypted](/manual/encryption) connections with the host. |Parameter|Description| |--|--------| |*Connections to host*|How Zabbix server or proxy connects to Zabbix agent on a host: no encryption (default), using PSK (pre-shared key) or certificate.| |*Connections from host*|Select what type of connections are allowed from the host (i.e. from Zabbix agent and Zabbix sender). Several connection types can be selected at the same time (useful for testing and switching to other connection type). Default is "No encryption".| |*Issuer*|Allowed issuer of certificate. Certificate is first validated with CA (certificate authority). If it is valid, signed by the CA, then the *Issuer* field can be used to further restrict allowed CA. This field is intended to be used if your Zabbix installation uses certificates from multiple CAs. If this field is empty then any CA is accepted.| |*Subject*|Allowed subject of certificate. Certificate is first validated with CA. If it is valid, signed by the CA, then the *Subject* field can be used to allow only one value of *Subject* string. If this field is empty then any valid certificate signed by the configured CA is accepted.| |*PSK identity*|Pre-shared key 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.| |*PSK*|Pre-shared key (hex-string). 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. Example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952| ##### 暗号化 **暗号化**タブでは、ホストと[暗号化](/manual/encryption)された接続をするように要求できます。 |パラメーター|説明| |--|--------| |*ホストへの接続*|Zabbixサーバーまたはプロキシがホスト上のZabbixエージェントに接続する方法: 暗号化なし(デフォルト)、PSK(事前共有キー)または証明書を使用。| |*ホストからの接続*|ホスト(Zabbixエージェントおよび Zabbix sender)から許可される接続の種類を選択します。複数の接続タイプを同時に選択できます(テストや他の接続タイプへの切り替えに便利です)。デフォルトは"暗号化なし"です。| |*発行者*|許可された証明書の発行者。証明書は最初にCA (証明機関)で検証されます。証明書が有効で、CAによって署名されている場合は、*発行者*フィールドを使用して、許可されるCAをさらに制限できます。このフィールドは、Zabbixインストールで複数のCAからの証明書を使用する場合に使用することを目的としています。このフィールドが空の場合、どのCAでも受け入れられます。| |*サブジェクト*|許可された証明書の件名。証明書は最初にCAで検証されます。証明書が有効で、CAによって署名されている場合、*サブジェクト*フィールドを使用して*サブジェクト*文字列の値を1つだけ許可できます。このフィールドが空の場合、構成されたCAによって署名された有効な証明書はすべて受け入れられます。| |*PSKアイデンティティ*|事前共有キーID文字列。<br>PSK IDには機密情報を入れないでください。これは、受信者にどのPSKを使用するかを通知するために、ネットワーク経由で暗号化されずに送信されます。| |*PSK*|事前共有キー(16 進文字列)。最大長:ZabbixがGnuTLSまたはOpenSSLライブラリを使用する場合は512桁の16進数(256バイトのPSK)、Zabbixがmbed TLS(PolarSSL)ライブラリを使用する場合は64桁の16進数(32バイトのPSK)。例: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952| ### Encryption with certificate authority verification ### 認証局検証による暗号化 ### Encryption with full verification ### 完全な検証を伴う暗号化 #### Enforcing Secure and SameSite session cookies in Zabbix When configuring Zabbix, it is essential to enforce secure and SameSite attributes for session cookies to enhance security and prevent cross-site request forgery (CSRF) attacks. However, enforcing ``SameSite=Strict`` may cause issues in certain scenarios, such as: - Dashboard URL widgets displaying "user not logged in" when embedding same-domain iframes. - Users accessing the dashboard via HTTP instead of HTTPS may face login issues. - Inability to share URLs to specific Zabbix menu sections or hosts. To mitigate these issues, users should have a way to adjust the SameSite policy. 1\. Secure cookies Setting the ``secure`` flag ensures that cookies are only transmitted over HTTPS, preventing exposure over unencrypted connections. To enable secure cookies in Zabbix, add or modify the following setting in the web server configuration: For Apache: Header always edit Set-Cookie ^(.*)$ $1;Secure For Nginx: proxy_cookie_path / "/; Secure"; Ensure that your Zabbix frontend is accessed via HTTPS; otherwise, cookies with the ``Secure`` flag will not be sent. 2\. Configuring the SameSite attribute Web server settings can also enforce the SameSite attribute: For Apache: <IfModule mod_headers.c> Header onsuccess edit Set-Cookie (.*) "$1; SameSite=Strict" </IfModule> For Nginx (version 1.19.3+): proxy_cookie_flags ~ samesite=Strict; # Replace ~ with 'zbx_session' for specificity #### ZabbixでセキュアなセッションクッキーとSameSiteセッションクッキーを強制する Zabbixを構成する場合、セキュリティを強化し、クロスサイトリクエストフォージェリ(CSRF)攻撃を防ぐために、セッションクッキーにセキュアな属性とSameSite属性を強制することが不可欠です。ただし、``SameSite=Strict``を強制すると、次のような特定のシナリオで問題が発生する可能性があります。 - 同じドメインのiframeを埋め込むと、ダッシュボードURLウィジェットに"ユーザーはログインしていません"と表示される。 - HTTPSではなくHTTP経由でダッシュボードにアクセスするユーザーは、ログインの問題に直面する可能性がある。 - 特定のZabbixメニューセクションまたはホストへのURLを共有できない。 これらの問題を軽減するには、ユーザーがSameSiteポリシーを調整する方法が必要です。 1\. セキュアなクッキー ``secure``フラグを設定すると、クッキーがHTTPS経由でのみ送信されるようになり、暗号化されていない接続での露出が防止されます。 Zabbixでセキュアクッキーを有効にするには、Webサーバー構成で次の設定を追加または変更します: Apacheの場合: Header always edit Set-Cookie ^(.*)$ $1;Secure Nginxの場合: proxy_cookie_path / "/; Secure"; ZabbixフロントエンドがHTTPS経由でアクセスされていることを確認します。そうでない場合、``Secure``フラグ付きのクッキーは送信されません。 2\. SameSite属性の構成 Webサーバー設定でSameSite属性を適用することもできます: Apacheの場合: <IfModule mod_headers.c> Header onsuccess edit Set-Cookie (.*) "$1; SameSite=Strict" </IfModule> Nginx(バージョン1.19.3+)の場合: proxy_cookie_flags ~ samesite=Strict; # 特異性のために~を'zbx_session'に置き換えます #### Entity count New [functions](/manual/appendix/functions) have been added to simplify the counting of specific hosts, items, or values, returned by [foreach functions](/manual/appendix/functions/aggregate/foreach). Aggregate functions: - **count** - total number of values in an array returned by a foreach function (returns an integer); - **item\_count** - total number of currently enabled items that match filter criteria (returns an integer). Foreach function: - **exists\_foreach** - number of currently enabled items that match filter criteria (returns an array). #### エンティティ数 [foreach関数](/manual/appendix/functions/aggregate/foreach)によって返される特定のホスト、アイテム、または値のカウントを簡素化するための新しい[関数](/manual/appendix/functions)が追加されました。 集計関数: - **count** - foreach関数が返す配列内の値の合計 (整数を返す) - **item\_count** - 現在有効なアイテムのうち、フィルター条件に一致するものの総数 (整数を返す) Foreach関数: - **exists\_foreach** - 現在有効なアイテムのうち、フィルター条件に一致するものの数 (配列を返す) ##### Entity count New [functions](/manual/appendix/functions) have been added to simplify the counting of specific hosts, items, or values, returned by [foreach functions](/manual/appendix/functions/aggregate/foreach). Aggregate functions: - **count** - total number of values in an array returned by a foreach function (returns an integer); - **item\_count** - total number of currently enabled items that match filter criteria (returns an integer). Foreach function: - **exists\_foreach** - number of currently enabled items that match filter criteria (returns an array). ### 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 don't look normal (outliers) in a context of other values. New [history function](/manual/appendix/functions/history) 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  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. ### Zabbix agent 2 plugins Each Zabbix agent 2 plugin now has a separate [configuration file](/manual/appendix/config/zabbix_agent2_plugins). By default, these files are located in the `./zabbix_agent2.d/plugins.d/` directory. The path is specified in the `Include` parameter of the agent 2 configuration file and can be relative to the [zabbix\_agent2.conf](/manual/appendix/config/zabbix_agent2) or [zabbix\_agent2.win.conf](/manual/appendix/config/zabbix_agent2_win) file location. ##### Entity uniqueness criteria When adding entities (items, triggers, graphs etc.) from a template it is important to know what of those entities already exist on the host and need to be updated and what entities differ. The uniqueness criteria for deciding upon the sameness/difference are: - for items - the item key - for triggers - trigger name and expression - for custom graphs - graph name and its items ##### エンティティの一意性の基準 テンプレートからエンティティ (アイテム、トリガー、グラフなど) を追加する場合、それらのエンティティのどれがホストに既に存在し、更新する必要があるか、およびどのエンティティが異なるかを知ることが重要です。 同一性/相違点を決定するための一意性の基準は次のとおりです。 - アイテムの場合 - アイテム キー - トリガーの場合 - トリガー名と式 - カスタム グラフの場合 - グラフ名とその項目 #### Environment files In the same directory with compose files on github.com you can find files with default environment variables for each component in compose file. These environment files are named like `.env_<type of component>`. #### 環境ファイル github.comのComposeファイルと同じディレクトリに、Composeファイル内の各コンポーネントのデフォルトの環境変数を含むファイルがあります。これらの環境ファイルには、`.env_<コンポーネントの種類>`のような名前が付けられています。 #### Error handling Up to that point everything we've tried has worked fine. But what happens if we try to make an incorrect call to the API? Let's try to create another host by calling [host.create](/manual/api/reference/host/create) but omitting the mandatory `groups` parameter. ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Linux server", "interfaces": [ { "type": 1, "main": 1, "useip": 1, "ip": "192.168.3.1", "dns": "", "port": "10050" } ] }, "id": 7, "auth": "0424bd59b807674191e7d77572075f33" } ``` The response will then contain an error message: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` If an error occurred, instead of the `result` property, the response object will contain an `error` property with the following data: - `code` - an error code; - `message` - a short error summary; - `data` - a more detailed error message. Errors can occur in different cases, such as, using incorrect input values, a session timeout or trying to access unexisting objects. Your application should be able to gracefully handle these kinds of errors. #### エラーハンドリング 今まで試したメソッドはすべて成功しました。しかし、API に対して間違った呼び出しを行おうとするとどうなるでしょうか？[host.create](/manual/api/reference/host/create) を呼び出して別のホストを作成する際に、必須の `groups` パラメータを省略してみましょう。 ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Linux server", "interfaces": [ { "type": 1, "main": 1, "useip": 1, "ip": "192.168.3.1", "dns": "", "port": "10050" } ] }, "id": 7, "auth": "0424bd59b807674191e7d77572075f33" } ``` レスポンスにはエラー メッセージが含まれます。 ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` エラーが発生した場合、レスポンスオブジェクトには`result` プロパティの代わりに、次のデータを持つ `error` プロパティが含まれます。 - `code` - エラーコード - `message` - 簡単なエラーの要約 - `data` - より詳細なエラー メッセージ エラーは、誤った入力値の使用、セッション タイムアウト、または存在しないオブジェクトへのアクセス試行など、さまざまなケースで発生する可能性があります。 アプリケーションは、この種のエラーを適切に処理する必要があります。 #### Errors with fping execution in rootless containers When containers are running in rootless mode or in a specific-restrictions environment, you may face errors related to fping execution when performing ICMP checks, such as `fping: Operation not permitted` or all packets to all resources lost. To fix this problem add `--cap-add=net_raw` to "docker run" or "podman run" commands. Additionally fping execution in non-root environments may require sysctl modification, i.e.: sudo sysctl -w "net.ipv4.ping_group_range=0 1995" where "1995" is the zabbix GID. For more details, see [ZBX-22833](https://support.zabbix.com/browse/ZBX-22833). #### rootlessコンテナでのfping実行に関するエラー コンテナがrootlessモードまたは特定の制限のある環境で実行されている状態でICMPチェックを実行する際に、`fping: Operation not permitted` やすべてのリソースへのすべてのパケットが失われるなど、fping実行に関連するエラーが発生する可能性があります。 この問題を解決するには、"docker run"または"podman run"コマンドに`--cap-add=net_raw`を追加します。 さらに、非ルート環境でfpingを実行するには、sysctlの変更が必要になる場合があります。例: sudo sysctl -w "net.ipv4.ping_group_range=0 1995" この"1995"はzabbix GIDです。詳細については、[ZBX-22833](https://support.zabbix.com/browse/ZBX-22833)を参照してください。 #### Escalation examples #### エスカレーション例 # event.acknowledge # event.acknowledge #### Event correlation Create custom event correlation rules. [Correlation API](/manual/api/reference/correlation) #### イベント相関 カスタムイベントの相関ルールを作成します。 [Correlation API](/manual/api/reference/correlation) ##### Event correlation Event correlation (also called global event correlation) is a way to set up custom event closing (resulting in OK event generation) rules. The rules define how the new problem events are paired with existing problem events and allow to close the new event or the matched events by generating corresponding OK events. However, event correlation must be configured very carefully, as it can negatively affect event processing performance or, if misconfigured, close more events than intended (in the worst case even all problem events could be closed). A few configuration tips: 1. always reduce the correlation scope by setting a unique tag for the control event (the event that is paired with old events) and use the 'new event tag' correlation condition 2. don't forget to add a condition based on the old event when using 'close old event' operation, or all existing problems could be closed 3. avoid using common tag names used by different correlation configurations ##### イベント相関 イベント相関（グローバルイベント相関とも呼ばれる）は、カスタムイベント終了（結果的に正常イベントを生成する）ルールを設定する方法です。 このルールでは、新しい障害イベントと既存の障害イベントの組み合わせ方法を定義し、対応する正常イベントを生成して、新しいイベントまたは一致したイベントを閉じることができます。 しかし、イベント相関は、イベント処理のパフォーマンスに悪影響を及ぼしたり、設定を誤ると意図したよりも多くのイベントをクローズしてしまう（最悪の場合、すべての問題イベントをクローズしてしまう）ため、非常に慎重に設定する必要があります。<br> 設定のヒントをいくつか紹介します。 1. コントロールイベント（古いイベントと対になるイベント）に一意のタグを設定し、'新しいイベントタグ' 相関条件を 使用することで、常に相関範囲を縮小します。 2. '古いイベントのクローズ' オペレーションを使用する際に、古いイベントに基づいた条件を追加することを忘れないでください。 3. 異なる相関設定によって使用される共通のタグ名を使用しないようにします。 # event.get # event.get #### Event menu Clicking on the problem name brings up the event menu:  The event menu allows to: - filter the problems of the trigger - access the trigger configuration - access a simple graph/item history of the underlying item(s) - access an external ticket of the problem (if configured, see the *Include event menu entry* option when configuring [webhooks](/manual/config/notifications/media/webhook)) - execute global [scripts](/manual/web_interface/frontend_sections/administration/scripts) (these scripts need to have their scope defined as 'Manual event action'). This feature may be handy for running scripts used for managing problem tickets in external systems. #### イベントメニュー 障害名をクリックするとイベントメニューが表示されます。  イベントメニューでは次のことができます。 - トリガーの障害をフィルタリングします - トリガー設定にアクセスします - 基となるアイテムの簡単なグラフ/アイテム履歴にアクセスします - 問題の外部チケットにアクセスします（[webhooks](/manual/config/notifications/media/webhook)を設定するときに*イベントメニューエントリを含める*オプションを参照してください） - グローバル[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)を実行します（これらのスクリプトのスコープは*手動イベントアクション*として定義されている必要があります）。 この機能は外部システムで障害のあるチケットを管理するために使用されるスクリプトを実行する場合に便利です。 #### Events Retrieve events generated by triggers, network discovery and other Zabbix systems for more flexible situation management or third-party tool integration. [Event API](/manual/api/reference/event) #### イベント トリガー、ネットワークディスカバリ、その他のZabbixシステムから生成されたイベントを取得し、より柔軟な状況管理やサードパーティツールの統合を行うことができます。 [Event API](/manual/api/reference/event) ### Event tag The event tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| ### Event tag Event tag オブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| ### Example ### 例 ##### Example 10 CPU activity at any time with exception. Use of function time() and **not** operator: min(/zabbix/system.cpu.load[all,avg1],5m)>2 and not (dayofweek()=7 and time()>230000) and not (dayofweek()=1 and time()<010000) The trigger may change its state to problem at any time, except for 2 hours on a week change (Sunday, 23:00 - Monday, 01:00). ##### 例 10 例外を除く任意の時点での CPU アクティビティ 関数 time() と **not** 演算子を使用: min(/zabbix/system.cpu.load[all,avg1],5m)>2 and not (dayofweek()=7 and time()>230000) and not (dayofweek()=1 and time()<010000) トリガーは、週の2時間(日曜日の23:00から月曜日の01:00)を除いて、状態が障害に変わる可能性があります。 ##### Example 11 Check if client local time is in sync with Zabbix server time. Use of function fuzzytime(): fuzzytime(/MySQL_DB/system.localtime,10s)=0 The trigger will change to the problem state in case when local time on server MySQL\_DB and Zabbix server differs by more than 10 seconds. Note that 'system.localtime' must be configured as a [passive check](/manual/appendix/items/activepassive#passive_checks). ##### 例11 クライアントのローカルタイムがZabbixサーバのタイムと同期しているかどうかを確認します。 関数fuzzytime()を使用して: fuzzytime(/MySQL_DB/system.localtime,10s)=0 MySQL_DB と Zabbix server のローカルタイムが10秒以上異なる場合、trigger は障害状態に変更されます。 'system.localtime' は [パッシブチェック](/manual/appendix/items/activepassive#passive_checks) として設定する必要があることに注意してください。 ##### Example 12 Comparing average load today with average load of the same time yesterday (using time shift as `now-1d`). avg(/server/system.cpu.load,1h)/avg(/server/system.cpu.load,1h:now-1d)>2 This trigger will fire if the average load of the last hour tops the average load of the same hour yesterday more than two times. ##### 例 12 今日の平均負荷と昨日の同時刻の平均負荷を比較します (タイム シフトを`now-1d`として使用)。 avg(/server/system.cpu.load,1h)/avg(/server/system.cpu.load,1h:now-1d)>2 この式は、過去 1 時間の平均負荷が昨日の同じ時間の平均負荷を 2 回以上超えた場合に起動します。 ##### Example 13 Using the value of another item to get a trigger threshold: last(/Template PfSense/hrStorageFree[{#SNMPVALUE}])<last(/Template PfSense/hrStorageSize[{#SNMPVALUE}])*0.1 The trigger will fire if the free storage drops below 10 percent. ##### 例 13 別のアイテムの値を使用して、トリガーのしきい値を取得します。 last(/Template PfSense/hrStorageFree[{#SNMPVALUE}])<last(/Template PfSense/hrStorageSize[{#SNMPVALUE}])*0.1 空き容量が 10% を下回ると、トリガーが起動します。 ##### Example 14 Using [evaluation result](#operators) to get the number of triggers over a threshold: (last(/server1/system.cpu.load[all,avg1])>5) + (last(/server2/system.cpu.load[all,avg1])>5) + (last(/server3/system.cpu.load[all,avg1])>5)>=2 The trigger will fire if at least two of the triggers in the expression are in a problem state. ##### 例 14 [評価結果](#演算子)を使用して、しきい値を超えるトリガーの数を取得します。 (last(/server1/system.cpu.load[all,avg1])>5) + (last(/server2/system.cpu.load[all,avg1])>5) + (last(/server3/system.cpu.load[all,avg1])>5)>=2 式内のトリガーのうち少なくとも2つが真である場合、トリガーが起動します。 ##### Example 15 Comparing string values of two items - operands here are functions that return strings. Problem: create an alert if Ubuntu version is different on different hosts last(/NY Zabbix server/vfs.file.contents[/etc/os-release])<>last(/LA Zabbix server/vfs.file.contents[/etc/os-release]) ##### 例 15 2 つのアイテムの文字列値の比較 - ここでのオペランドは、文字列を返す関数です。 問題: ホストによって Ubuntu のバージョンが異なる場合にアラートを作成する last(/NY Zabbix server/vfs.file.contents[/etc/os-release])<>last(/LA Zabbix server/vfs.file.contents[/etc/os-release]) ##### Example 16 Comparing two string values - operands are: - a function that returns a string - a combination of macros and strings Problem: detect changes in the DNS query The item key is: net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1] with macros defined as {$WEBSITE_NAME} = example.com {$DNS_RESOURCE_RECORD_TYPE} = MX and normally returns: example.com MX 0 mail.example.com So our trigger expression to detect if the DNS query result deviated from the expected result is: last(/Zabbix server/net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1])<>"{$WEBSITE_NAME} {$DNS_RESOURCE_RECORD_TYPE} 0 mail.{$WEBSITE_NAME}" Notice the quotes around the second operand. ##### 例 16 2つの文字列値の比較 - オペランドは次の通りです: - 文字列を返す関数 - マクロと文字列の組み合わせ 問題：DNSクエリの変更を検出する アイテムキーは次の通りです: net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1] 次のように定義されたマクロを使用します。 {$WEBSITE_NAME} = example.com {$DNS_RESOURCE_RECORD_TYPE} = MX 通常は以下を返します。 example.com MX 0 mail.example.com したがって、DNS クエリの結果が期待される結果から逸脱しているかどうかを検出するためのトリガー式は次のとおりです: last(/Zabbix server/net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1])<>"{$WEBSITE_NAME} {$DNS_RESOURCE_RECORD_TYPE} 0 mail.{$WEBSITE_NAME}" 2 番目のオペランドが引用符で囲まれていることに注意してください。 ##### Example 17 Comparing two string values - operands are: - a function that returns a string - a string constant with special characters \\ and " Problem: detect if the `/tmp/hello` file content is equal to: \" //hello ?\" Option 1) write the string directly last(/Zabbix server/vfs.file.contents[/tmp/hello])="\\\" //hello ?\\\"" Notice how \\ and " characters are escaped when the string gets compared directly. Option 2) use a macro {$HELLO_MACRO} = \" //hello ?\" in the expression: last(/Zabbix server/vfs.file.contents[/tmp/hello])={$HELLO_MACRO} ##### 例 17 2 つの文字列値の比較 - オペランドは次のとおりです: - 文字列を返す関数 - 特殊文字 \\ および " を含む文字列定数 問題: `/tmp/hello` ファイルの内容が以下と等しいかどうかを検出します。 \" //hello ?\" オプション 1) 文字列を直接書き込む last(/Zabbix server/vfs.file.contents[/tmp/hello])="\\\" //hello ?\\\"" 文字列が直接比較されるときに、\\ と " の文字がどのようにエスケープされるか注意してください。 オプション 2) マクロを使用する {$HELLO_MACRO} = \" //hello ?\" 式: last(/Zabbix server/vfs.file.contents[/tmp/hello])={$HELLO_MACRO} ##### Example 18 Comparing long-term periods. Problem: Load of Exchange server increased by more than 10% last month trendavg(/Exchange/system.cpu.load,1M:now/M)>1.1*trendavg(/Exchange/system.cpu.load,1M:now/M-1M) You may also use the [Event name](/manual/config/triggers/trigger#configuration) field in trigger configuration to build a meaningful alert message, for example to receive something like `"Load of Exchange server increased by 24% in July (0.69) comparing to June (0.56)"` the event name must be defined as: Load of {HOST.HOST} server increased by {{?100*trendavg(//system.cpu.load,1M:now/M)/trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(0)}% in {{TIME}.fmttime(%B,-1M)} ({{?trendavg(//system.cpu.load,1M:now/M)}.fmtnum(2)}) comparing to {{TIME}.fmttime(%B,-2M)} ({{?trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(2)}) It is also useful to allow manual closing in trigger configuration for this kind of problem. ##### 例 18 長期間の比較 問題：先月、Exchange server の負荷が10%以上増加した。 trendavg(/Exchange/system.cpu.load,1M:now/M)>1.1*trendavg(/Exchange/system.cpu.load,1M:now/M-1M) trigger 設定の[Event name](/manual/config/triggers/trigger#configuration)フィールドを使って、例えば次のようなものを受け取るために、意味のある警告メッセージを構築することも可能です。 `"Load of Exchange server increased by 24% in July (0.69) comparing to June (0.56)"` 以下のようにイベント名を定義する必要があります: Load of {HOST.HOST} server increased by {{?100*trendavg(//system.cpu.load,1M:now/M)/trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(0)}% in {{TIME}.fmttime(%B,-1M)} ({{?trendavg(//system.cpu.load,1M:now/M)}.fmtnum(2)}) comparing to {{TIME}.fmttime(%B,-2M)} ({{?trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(2)}) また、このような問題のために、trigger 設定において手動で閉じることができるようにすることも有効です。 ##### Example 1 Calculating percentage of free disk space on '/'. Use of function **last**: 100*last(//vfs.fs.size[/,free])/last(//vfs.fs.size[/,total]) Zabbix will take the latest values for free and total disk spaces and calculate percentage according to the given formula. ##### 例1 '/' のディスク空き容量のパーセンテージを計算します。 **last**関数の使用例: 100*last(//vfs.fs.size[/,free])/last(//vfs.fs.size[/,total]) Zabbixはフリーディスクスペースとトータルディスクスペースの最新値を取得し、指定された計算式に従ってパーセンテージを計算します。 ##### Example 1 General example: |Parameter|Description| |--|--------| |**OID**|1.2.3.45.6.7.8.0 (or .1.2.3.45.6.7.8.0)| |**Key**|<Unique string to be used as reference to triggers><br>For example, "my\_param".| Note that OID can be given in either numeric or string form. However, in some cases, string OID must be converted to numeric representation. Utility snmpget may be used for this purpose: snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0 ##### 例1 一般的な例 : |パラメータ|説明| |--|--------| |**OID**|1.2.3.45.6.7.8.0 (or .1.2.3.45.6.7.8.0)| |**Key**|<トリガーへの参照として使用される一意の文字列><br>例: "my\_param"| OIDは数値または文字列形式で指定できることに注意してください。 ただし、文字列OIDを数値表現に変換する必要があることがあり、そのような場合はsnmpgetユーティリティが使用できます。 snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0 ##### Example 1 Message subject: Problem: {TRIGGER.NAME} When you receive the message, the message subject will be replaced by something like: Problem: Processor load is too high on Zabbix server ##### 例 1 メッセージの件名: Problem: {TRIGGER.NAME} メッセージを受信すると、メッセージの件名は次のように置き換えられます。 Problem: Processor load is too high on Zabbix server ##### Example 1 Monitoring of two instances “MySQL1” and “MySQL2”. Configuration parameters: ```bash Plugins.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306 Plugins.Mysql.Sessions.MySQL1.User=mysql1_user Plugins.Mysql.Sessions.MySQL1.Password=unique_password Plugins.Mysql.Sessions.MySQL2.Uri=tcp://192.0.2.0:3306 Plugins.Mysql.Sessions.MySQL2.User=mysql2_user Plugins.Mysql.Sessions.MySQL2.Password=different_password ``` As a result of this configuration, each session name may be used as a connString in an [item key](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2), e.g., `mysql.ping[MySQL1]` or `mysql.ping[MySQL2]`. ##### 例 1 2つのインスタンス"MySQL1"と"MySQL2"の監視 設定パラメータ: ```bash Plugins.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306 Plugins.Mysql.Sessions.MySQL1.User=mysql1_user Plugins.Mysql.Sessions.MySQL1.Password=unique_password Plugins.Mysql.Sessions.MySQL2.Uri=tcp://192.0.2.0:3306 Plugins.Mysql.Sessions.MySQL2.User=mysql2_user Plugins.Mysql.Sessions.MySQL2.Password=different_password ``` この設定により、各セッション名は[アイテムキー](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2)のconnStringとして使用できるようになります。例: `mysql.ping[MySQL1]` または `mysql.ping[MySQL2]` ##### Example 1 Sending a repeated notification once every 30 minutes (5 times in total) to a 'MySQL Administrators' group. To configure: - in Operations tab, set the *Default operation step duration* to '30m' (30 minutes) - Set the escalation steps to be *From* '1' *To* '5' - Select the 'MySQL Administrators' group as recipients of the message {width="600"} Notifications will be sent at 0:00, 0:30, 1:00, 1:30, 2:00 hours after the problem starts (unless, of course, the problem is resolved sooner). If the problem is resolved and a recovery message is configured, it will be sent to those who received at least one problem message within this escalation scenario. ::: noteclassic If the trigger that generated an active escalation is disabled, Zabbix sends an informative message about it to all those that have already received notifications. ::: ##### 例 1 "MySQL 管理者"グループへ30 分ごとに 1 回 (合計 5 回) 繰り返し通知を送信します。 設定するには： - [実行内容]タブで、*デフォルトのアクション実行ステップの間隔* を '30m' (30 分) に設定します。 - エスカレーション ステップを *From* '1' *To* '5' に設定します。 - メッセージ受信者として"MySQL 管理者"グループを選択します。 {width="600"} 通知は、障害が発生してから 0:00,0:30,1:00,1:30,2:00 時に送信されます (もちろん問題がより早く解決されない限り)。 障害が解決され、回復メッセージが設定されている場合、このエスカレーション シナリオ内で少なくとも 1 つの障害メッセージを受信したユーザーに送信されます。 ::: noteclassic アクティブなエスカレーションを生成したトリガーが無効になっている場合、Zabbix はそれに関するメッセージを、既に通知を受け取っているすべての人に送信します。 ::: ##### Example 1 Send simple GET requests to retrieve data from services such as Elasticsearch: - Create a GET item with URL: `localhost:9200/?pretty` - Notice the response: ```{=html} <!-- --> ``` { "name" : "YQ2VAY-", "cluster_name" : "elasticsearch", "cluster_uuid" : "kH4CYqh5QfqgeTsjh2F9zg", "version" : { "number" : "6.1.3", "build_hash" : "af51318", "build_date" : "2018-01-26T18:22:55.523Z", "build_snapshot" : false, "lucene_version" : "7.1.0", "minimum_wire_compatibility_version" : "5.6.0", "minimum_index_compatibility_version" : "5.0.0" }, "tagline" : "You know, for search" } - Now extract the version number using a JSONPath preprocessing step: `$.version.number` ##### 例1 Elasticsearchなどのサービスからデータを取得するために、シンプルなGETリクエストを送信します。 - URLを指定してGET item を作成します。`localhost:9200/?pretty`でGET item を作成します。 - レスポンスに注目してください。 ```{=html} <!-- --> ``` { "name" : "YQ2VAY-", "cluster_name" : "elasticsearch", "cluster_uuid" : "kH4CYqh5QfqgeTsjh2F9zg", "version" : { "number" : "6.1.3", "build_hash" : "af51318", "build_date" : "2018-01-26T18:22:55.523Z", "build_snapshot" : false, "lucene_version" : "7.1.0", "minimum_wire_compatibility_version" : "5.6.0", "minimum_index_compatibility_version" : "5.0.0" }, "tagline" : "You know, for search" } - ここで、JSONPathのプリプロセスを利用してバージョン番号を抽出します。 `$.version.number` ##### Example 1 Something very simple: UserParameter=ping[*],echo $1 We may define unlimited number of items for monitoring all having format ping\[something\]. - ping\[0\] - will always return '0' - ping\[aaa\] - will always return 'aaa' ##### 例1 とてもシンプルなもの: UserParameter=ping[*],echo $1 ping\[something\]というフォーマットを持つ監視項目は無制限に定義することができる。 - ping\[0\] - 常に '0' を戻す - ping\[aaa\] - 常に 'aaa' を戻す ##### Example 1 Stop repetitive problem events from the same network port.  This global correlation rule will correlate problems if *Host* and *Port* tag values exist on the trigger and they are the same in the original event and the new one. The operation will close new problem events on the same network port, keeping only the original problem open. ##### 例1 同じネットワークポートから繰り返し発生する問題事象を停止します。  このグローバルな相関ルールは、*Host* と *Port* タグ値がトリガに存在し、それらが元のイベントと新しいイベントで<br> 同じであれば、問題を相関させます。 この操作は、同じネットワークポート上の新しい問題イベントを閉じ、元の問題のみを開いたままにします。 ##### Example 1 Temperature in server room is too high. Problem expression: last(/server/temp)>20 Recovery expression: last(/server/temp)<=15 ##### 例1 サーバールームの温度が高すぎる 問題式: last(/server/temp)>20 回復式: last(/server/temp)<=15 ##### Example 1 The processor load is too high on Zabbix server. last(/Zabbix server/system.cpu.load[all,avg1])>5 By using the function 'last()', we are referencing the most recent value. `/Zabbix server/system.cpu.load[all,avg1]` gives a short name of the monitored parameter. It specifies that the host is 'Zabbix server' and the key being monitored is 'system.cpu.load\[all,avg1\]'. Finally, `>5` means that the trigger is in the PROBLEM state whenever the most recent processor load measurement from Zabbix server is greater than 5. ##### 例1 Zabbix server のプロセッサの負荷が高すぎます。 last(/Zabbix server/system.cpu.load[all,avg1])>5 関数 'last()' を使用することで、最新の値を参照することができます。<br> `/Zabbix server/system.cpu.load[all,avg1]` には監視するパラメータのショートネームが入ります。<br> ホストが Zabbix server で、監視するキーが system.cpu.load[all,avg1] であることを指定します。最後に、`>5` は、Zabbix server からの<br> 最新のプロセッサ負荷測定値が 5 より大きい場合、トリガーが PROBLEM 状態になることを意味します。<br> ##### Example 1 To create a "Web scenario failed" trigger, you can define a trigger expression: last(/host/web.test.fail[Scenario])<>0 Make sure to replace 'Scenario' with the real name of your scenario. ##### 例1 「Webシナリオに失敗しました」トリガーを作成するには、次のようにトリガー式を定義します。 last(/host/web.test.fail[Scenario])<>0 必ず'Scenario'を本来のシナリオ名に置き換えてください。 ##### Example 1 Total disk space of host group 'MySQL Servers'. sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"])) ##### 例1 ホストグループ 'MySQL Servers' の総ディスク容量 sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"])) ##### Example 1 Use of host-level macro in the "Status of SSH daemon" item key: `net.tcp.service[ssh,,{$SSH_PORT}]` This item can be assigned to multiple hosts, providing that the value of **{$SSH\_PORT}** is defined on those hosts. ##### 例 1 "Status of SSH daemon" item キーにホストレベルマクロを使用する。 `net.tcp.service[ssh,,{$SSH_PORT}]` この項目は、複数のホストで **{$SSH_PORT}** の値が定義されている場合に、複数のホストに割り当てることができます。 ##### Example 1 Use of the following expression in low-level discovery to discover databases except a database with a specific name: ^TESTDATABASE$  Chosen *Expression type*: "Result is FALSE". Doesn't match name, containing string "*TESTDATABASE*". ##### 例 1 低レベルの検出で次の式を使用すると、特定の名前のデータベース以外を検出できます。 ^TESTDATABASE$  選択された*Expression type* : "結果はFALSE "です。"*TESTDATABASE*" を含んだ名前と一致しません。 ##### Example 1 Using host metadata to distinguish between Linux and Windows hosts. Say you would like the hosts to be autoregistered by the Zabbix server. You have active Zabbix agents (see "Configuration" section above) on your network. There are Windows hosts and Linux hosts on your network and you have "Linux by Zabbix agent" and "Windows by Zabbix agent" templates available in your Zabbix frontend. So at host registration, you would like the appropriate Linux/Windows template to be applied to the host being registered. By default, only the hostname is sent to the server at autoregistration, which might not be enough. In order to make sure the proper template is applied to the host you should use host metadata. ##### 例 1 ホストメタデータを使用してLinuxホストとWindowsホストを区別します。 ホストをZabbixサーバーによって自動登録したいとします。 ネットワーク上にアクティブなZabbixエージェント（上記の"設定"セクションを参照）があります。 ネットワーク上にWindowsホストとLinuxホストがあり、Zabbixフロントエンドで"Linux by Zabbix agent"と"Windows by Zabbix agent"のテンプレートを使用したいとします。 その場合、ホストの登録時に適切なLinux/Windowsテンプレートを適用する必要があります。 デフォルトでは、自動登録時にホスト名のみがサーバーに送信されますが、これでは不十分な場合があります。 適切なテンプレートがホストに適用されていることを確認するには、ホストメタデータを使用する必要があります。 ##### Example 2 Calculating a 10-minute average of the number of values processed by Zabbix. Use of function **avg**: avg(/Zabbix Server/zabbix[wcache,values],10m) Note that extensive use of calculated items with long time periods may affect performance of Zabbix server. ##### 例2 Zabbixで処理された値の10分間の平均値を計算します。 **avg**関数の使用例: avg(/Zabbix Server/zabbix[wcache,values],10m) 長い時間の計算 item を多用すると、Zabbix server のパフォーマンスに影響を与える可能性があることに注意してください。 ##### Example 2 Free disk space is too low. Problem expression: it is less than 10GB for last 5 minutes max(/server/vfs.fs.size[/,free],5m)<10G Recovery expression: it is more than 40GB for last 10 minutes min(/server/vfs.fs.size[/,free],10m)>40G ##### 例2 空きディスク容量が少なすぎる 問題式: 直近5分間の空きディスク容量が10GB以下 max(/server/vfs.fs.size[/,free],5m)<10G 回復式: 問題式: 直近10分間の空きディスク容量が40GB以上 min(/server/vfs.fs.size[/,free],10m)>40G ##### Example 2 Let's add more sense! UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 ping | grep -c alive This parameter can be used for monitoring availability of MySQL database. We can pass user name and password: mysql.ping[zabbix,our_password] ##### 例2 もっとセンスを磨こう! UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 ping | grep -c alive このパラメータは、MySQLデータベースの可用性を監視するために使用することができます。<br> ユーザー名とパスワードを渡すことができます: mysql.ping[zabbix,our_password] ##### Example 2 Message: Processor load is: {?last(/zabbix.zabbix.com/system.cpu.load[,avg1])} When you receive the message, the message will be replaced by something like: Processor load is: 1.45 ##### 例 2 メッセージ本文: Processor load is: {?last(/zabbix.zabbix.com/system.cpu.load[,avg1])} メッセージは受信時に次のように置き換えられます。 Processor load is: 1.45 ##### Example 2 Monitoring of uptime: |Parameter|Description| |--|--------| |**OID**|MIB::sysUpTime.0| |**Key**|router.uptime| |**Value type**|Float| |**Units**|uptime| |**Preprocessing step: Custom multiplier**|0.01| ##### 例2 稼働時間の監視 : |パラメータ|説明| |--|--------| |**OID**|MIB::sysUpTime.0| |**Key**|router.uptime| |**Value type**|Float| |**Units**|uptime| |**Preprocessing step: Custom multiplier**|0.01| ##### Example 2 Providing some of the parameters in the item key (supported since Zabbix 6.0.17). Configuration parameters: ```bash Plugins.PostgreSQL.Sessions.Session1.Uri=tcp://192.0.2.234:5432 Plugins.PostgreSQL.Sessions.Session1.User=old_username Plugins.PostgreSQL.Sessions.Session1.Password=session_password ``` [Item key](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2): `pgsql.ping[session1,new_username,,postgres]` As a result of this configuration, the agent will connect to PostgreSQL using the following parameters: - URI from session parameter: *192.0.2.234:5432* - Username from the item key: *new_username* - Password from session parameter (since it is omitted in the item key): *session_password* - Database name from the item key: *postgres* ##### 例 2 アイテムキーにいくつかのパラメータを指定します。 (Zabbix 6.0.17 以降でサポートされています) 設定パラメータ: ```bash Plugins.PostgreSQL.Sessions.Session1.Uri=tcp://192.0.2.234:5432 Plugins.PostgreSQL.Sessions.Session1.User=old_username Plugins.PostgreSQL.Sessions.Session1.Password=session_password ``` [アイテムキー](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2): `pgsql.ping[session1,new_username,,postgres]` この設定の結果、エージェントは以下のパラメータを使用してPostgreSQLに接続します。 - セッションパラメータのURI: *192.0.2.234:5432* - アイテムキーのユーザー名: *new_username* - セッションパラメータのパスワード(アイテムキーでは省略されているため): *session_password* - アイテムキーのデータベース名: *postgres* ##### Example 2 Sending a delayed notification about a long-standing problem. To configure: - In Operations tab, set the *Default operation step duration* to '10h' (10 hours) - Set the escalation steps to be *From* '2' *To* '2' {width="600"} A notification will only be sent at Step 2 of the escalation scenario, or 10 hours after the problem starts. You can customize the message text to something like 'The problem is more than 10 hours old'. ##### 例 2 長期障害について遅延通知を送信する。 設定するには: - [実行内容] タブで、*デフォルトのアクション実行ステップの間隔* を '10h' (10 時間) に設定します。 - エスカレーション手順を *From* '2' *To* '2' に設定します {width="600"} 通知は、エスカレーション シナリオのステップ 2、または障害が発生してから 10 時間後にのみ送信されます。 メッセージ テキストは'障害が 発生して10 時間以上経過しています'などにカスタマイズできます。 ##### Example 2 Send simple POST requests to retrieve data from services such as Elasticsearch: - Create a POST item with URL: `http://localhost:9200/str/values/_search?scroll=10s` - Configure the following POST body to obtain the processor load (1 min average per core) ```{=html} <!-- --> ``` { "query": { "bool": { "must": [{ "match": { "itemid": 28275 } }], "filter": [{ "range": { "clock": { "gt": 1517565836, "lte": 1517566137 } } }] } } } - Received: ```{=html} <!-- --> ``` { "_scroll_id": "DnF1ZXJ5VGhlbkZldGNoBQAAAAAAAAAkFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAJRZZUTJWQVktVFNacU5nRHhlcEI0QUxRAAAAAAAAACYWWVEyVkFZLVRTWnFOZ0R4ZXBCNEFMUQAAAAAAAAAnFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAKBZZUTJWQVktVFNacU5nRHhlcEI0QUxR", "took": 18, "timed_out": false, "_shards": { "total": 5, "successful": 5, "skipped": 0, "failed": 0 }, "hits": { "total": 1, "max_score": 1.0, "hits": [{ "_index": "dbl", "_type": "values", "_id": "dqX9VWEBV6sEKSMyk6sw", "_score": 1.0, "_source": { "itemid": 28275, "value": "0.138750", "clock": 1517566136, "ns": 25388713, "ttl": 604800 } }] } } - Now use a JSONPath preprocessing step to get the item value: `$.hits.hits[0]._source.value` ##### 例2 Elasticsearchなどのサービスからデータを取得するために、シンプルなPOSTリクエストを送信します。 - URLを指定してPOSTアイテムを作成する。 `http://localhost:9200/str/values/_search?scroll=10s` - プロセッサの負荷（各コア1分平均）を取得するために、以下のPOSTボディを設定します。 ```{=html} <!-- --> ``` { "query": { "bool": { "must": [{ "match": { "itemid": 28275 } }], "filter": [{ "range": { "clock": { "gt": 1517565836, "lte": 1517566137 } } }] } } } - Received: ```{=html} <!-- --> ``` { "_scroll_id": "DnF1ZXJ5VGhlbkZldGNoBQAAAAAAAAAkFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAJRZZUTJWQVktVFNacU5nRHhlcEI0QUxRAAAAAAAAACYWWVEyVkFZLVRTWnFOZ0R4ZXBCNEFMUQAAAAAAAAAnFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAKBZZUTJWQVktVFNacU5nRHhlcEI0QUxR", "took": 18, "timed_out": false, "_shards": { "total": 5, "successful": 5, "skipped": 0, "failed": 0 }, "hits": { "total": 1, "max_score": 1.0, "hits": [{ "_index": "dbl", "_type": "values", "_id": "dqX9VWEBV6sEKSMyk6sw", "_score": 1.0, "_source": { "itemid": 28275, "value": "0.138750", "clock": 1517566136, "ns": 25388713, "ttl": 604800 } }] } } - ここで、JSONPathのプリプロセスを利用して item 値を抽出します。 `$.hits.hits[0]._source.value` ##### Example 2 Sum of latest values of all items matching net.if.in\[\*\] on the host. sum(last_foreach(/host/net.if.in[*])) ##### 例2 そのホストでnet.if.in\[\*\]に一致するすべての item の最新値の合計 sum(last_foreach(/host/net.if.in[*])) ##### Example 2 To create a "Web scenario failed" trigger with a useful problem description in the trigger name, you can define a trigger with name: Web scenario "Scenario" failed: {ITEM.VALUE} and trigger expression: length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0 Make sure to replace 'Scenario' with the real name of your scenario. ##### 例2 トリガー名に問題の説明を含む"Web scenario failed"トリガーを作成するには、次の名前でトリガーを定義します。 Web scenario "Scenario" failed: {ITEM.VALUE} さらに次のようにトリガー式を定義します length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0 必ず'Scenario'を本来のシナリオ名に置き換えてください。 ##### Example 2 Use of host-level macro in the "CPU load is too high" trigger: `last(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}` Such a trigger would be created on the template, not edited in individual hosts. ::: notetip If you want to use the amount of values as the function parameter (for example, **max(/host/key,\#3)**), include hash mark in the macro definition like this: SOME\_PERIOD => \#3 ::: ##### 例 2 "CPU load is too high" トリガー でのホストレベルマクロの使用: `last(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}` このようなトリガーは、個々のホストで編集するのではなく、テンプレート上で作成されることになります。 ::: notetip 値の量を関数のパラメーターとして使用する場合（例えば, **max(/host/key,\#3)**), <br> SOME\_PERIOD => \#3<br> というようにマクロ定義にハッシュ記号を入れてください。 ::: ##### Example 2 www.example.com is overloaded. last(/www.example.com/system.cpu.load[all,avg1])>5 or min(/www.example.com/system.cpu.load[all,avg1],10m)>2 The expression is true when either the current processor load is more than 5 or the processor load was more than 2 during last 10 minutes. ##### 例2 www.example.com は、過負荷になっています。 last(/www.example.com/system.cpu.load[all,avg1])>5 or min(/www.example.com/system.cpu.load[all,avg1],10m)>2 この式は、現在のプロセッサ負荷が5以上であるか、過去10分間のプロセッサ負荷が2以上であった場合に "TRUE" となります。 ##### Example 3 Average processor load of host group 'MySQL Servers'. avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"])) ##### 例3 ホストグループ ’MySQL Servers' の平均プロセッサ負荷 avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"])) ##### Example 3 Calculating total bandwidth on eth0. Sum of two functions: last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes]) ##### 例3 eth0の総帯域幅を計算する。 2つの関数の合計: last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes]) ##### Example 3 Checking if Zabbix API is alive, using [apiinfo.version](/manual/api/reference/apiinfo/version). - Item configuration:  Note the use of the POST method with JSON data, setting request headers and asking to return headers only: - Item value preprocessing with regular expression to get HTTP code:  - Checking the result in *Latest data*: {width="600"} ##### 例3 [apiinfo.version](/manual/api/reference/apiinfo/version) を使用して、Zabbix APIが生きているかどうかをチェックします。 - Item 設定  JSONデータでPOSTメソッドを使用し、リクエストヘッダを設定し、ヘッダのみを返すように要求することに注意してください。 - 項目値を正規表現で前処理し、HTTPコードを取得します:  - *Latest data* の結果をチェックします:　 {width="600"} ##### Example 3 Collecting a metric using default configuration parameters. Configuration parameters: ```bash Plugins.PostgreSQL.Default.Uri=tcp://192.0.2.234:5432 Plugins.PostgreSQL.Default.User=zabbix Plugins.PostgreSQL.Default.Password=password ``` [Item key](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2): `pgsql.ping[,,,postgres]` As a result of this configuration, the agent will connect to PostgreSQL using the parameters: - Default URI: *192.0.2.234:5432* - Default username: *zabbix* - Default password: *password* - Database name from the item key: *postgres* ##### 例 3 デフォルトの設定パラメータを使用してメトリックを収集します。 設定パラメータ: ```bash Plugins.PostgreSQL.Default.Uri=tcp://192.0.2.234:5432 Plugins.PostgreSQL.Default.User=zabbix Plugins.PostgreSQL.Default.Password=password ``` [アイテムキー](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2): `pgsql.ping[,,,postgres]` この設定の結果、エージェントは以下のパラメータを使用して PostgreSQL に接続します。 - デフォルトの URI: *192.0.2.234:5432* - デフォルトのユーザー名: *zabbix* - デフォルトのパスワード: *password* - アイテムキーのデータベース名: *postgres* ##### Example 3 Escalating the problem to the Boss. In the first example above we configured periodical sending of messages to MySQL administrators. In this case, the administrators will get four messages before the problem will be escalated to the Database manager. Note that the manager will get a message only in case the problem is not acknowledged yet, supposedly no one is working on it. {width="600"} Details of Operation 2:  Note the use of {ESC.HISTORY} macro in the customized message. The macro will contain information about all previously executed steps on this escalation, such as notifications sent and commands executed. ##### 例 3 上司に障害をエスカレーションします。 上記の最初の例では、MySQL 管理者に定期的にメッセージを送信するように設定しました。上記設定では管理者は障害がデータベース マネージャーにエスカレーションされる前に 4 回メッセージを受け取ります。マネージャーは障害が管理者に確認されていない場合にのみメッセージを受け取ることに注意してください。この時点ではおそらく誰も障害に対応していません。 {width="600"} 操作の詳細2:  カスタマイズされたメッセージで {ESC.HISTORY} マクロが使用されていることに注意してください。 マクロには、送信された通知や実行されたコマンドなど、このエスカレーションで以前に実行されたすべてのステップに関する情報が含まれます。 ##### Example 3 /etc/passwd has been changed. last(/www.example.com/vfs.file.cksum[/etc/passwd],#1)<>last(/www.example.com/vfs.file.cksum[/etc/passwd],#2) The expression is true when the previous value of /etc/passwd checksum differs from the most recent one. Similar expressions could be useful to monitor changes in important files, such as /etc/passwd, /etc/inetd.conf, /kernel, etc. ##### 例3 /etc/passwd が変更された。 (last(/www.example.com/vfs.file.cksum[/etc/passwd],#1)<>last(/www.example.com/vfs.file.cksum[/etc/passwd],#2))=1 この式は、/etc/passwdのチェックサムの以前の値が最新の値と異なる場合に真となります。 同様の式は、/etc/passwd, /etc/inetd.conf, /kernel などの重要なファイルの変更を監視するのに便利でしょう。 ##### Example 3 How many lines matching a regular expression in a file? UserParameter=wc[*],grep -c "$2" $1 This parameter can be used to calculate number of lines in a file. wc[/etc/passwd,root] wc[/etc/services,zabbix] ##### 例3 正規表現にマッチする行はファイル中に何行あるか？ UserParameter=wc[*],grep -c "$2" $1 このパラメータは、ファイル内の行数を計算するために使用することができます。 wc[/etc/passwd,root] wc[/etc/services,zabbix] ##### Example 3 Message: Latest value: {?last(/{HOST.HOST}/{ITEM.KEY})} MAX for 15 minutes: {?max(/{HOST.HOST}/{ITEM.KEY},15m)} MIN for 15 minutes: {?min(/{HOST.HOST}/{ITEM.KEY},15m)} When you receive the message, the message will be replaced by something like: Latest value: 1.45 MAX for 15 minutes: 2.33 MIN for 15 minutes: 1.01 ##### 例 3 メッセージ本文: Latest value: {?last(/{HOST.HOST}/{ITEM.KEY})} MAX for 15 minutes: {?max(/{HOST.HOST}/{ITEM.KEY},15m)} MIN for 15 minutes: {?min(/{HOST.HOST}/{ITEM.KEY},15m)} メッセージは受信時に次のように置き換えられます。 Latest value: 1.45 MAX for 15 minutes: 2.33 MIN for 15 minutes: 1.01 ##### Example 3 To create a "Web application is slow" trigger, you can define a trigger expression: last(/host/web.test.in[Scenario,,bps])<10000 Make sure to replace 'Scenario' with the real name of your scenario. ##### 例3 「Webアプリケーションが遅い」トリガーを作成するには、次のようにトリガー式を定義します。 last(/host/web.test.in[Scenario,,bps])<10000 必ず'Scenario'を本来のシナリオ名に置き換えてください。 ##### Example 3 Use of two macros in the "CPU load is too high" trigger: `min(/ca_001/system.cpu.load[,avg1],{$CPULOAD_PERIOD})>{$MAX_CPULOAD}` Note that a macro can be used as a parameter of trigger function, in this example function **min()**. ##### 例 3 "CPU load is too high" トリガーで2つのマクロを使用する: `min(/ca_001/system.cpu.load[,avg1],{$CPULOAD_PERIOD})>{$MAX_CPULOAD}` マクロはトリガー関数（この例では関数**min()**）のパラメータとして使用することができることに注意。 ##### Example 4 5-minute average of the number of queries per second for host group 'MySQL Servers'. avg(avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)) ##### 例4 ホストグループ ’MySQL Servers’ の1秒あたりのクエリ数の5分平均値 avg(avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)) ##### Example 4 A more complex scenario. After multiple messages to MySQL administrators and escalation to the manager, Zabbix will try to restart the MySQL database. It will happen if the problem exists for 2:30 hours and it hasn't been acknowledged. If the problem still exists, after another 30 minutes Zabbix will send a message to all guest users. If this does not help, after another hour Zabbix will reboot server with the MySQL database (second remote command) using IPMI commands. {width="600"} ##### 例 4 より複雑なシナリオ。 MySQL 管理者への複数のメッセージとマネージャーへのエスカレーションの後、Zabbix は MySQL データベースの再起動を試みます。 障害が 2:30 時間存在し、確認されていない場合に発生します。 それでも障害が解決しない場合は、さらに 30 分後に Zabbix がすべてのゲスト ユーザーにメッセージを送信します。 これで障害が解決しない場合は、さらに 1 時間後に、Zabbix は IPMI コマンドを使用して MySQL データベース (2 番目のリモート コマンド) でサーバーを再起動します。 {width="600"} ##### Example 4 Calculating percentage of incoming traffic. More complex expression: 100*last(//net.if.in[eth0,bytes])/(last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes])) See also: [Examples of aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate#usage_examples) ##### 例4 受信トラフィックのパーセンテージを計算する。 より複雑な表現: 100*last(//net.if.in[eth0,bytes])/(last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes])) [Examples of aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate#usage_examples)を参照してください。 ##### Example 4 Message: http://<server_ip_or_name>/zabbix/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID} When you receive the message, it will contain a link to the *Event details* page, which provides information about the event, its trigger, and a list of latest events generated by the same trigger. ##### 例 4 メッセージ本文: http://<server_ip_or_name>/zabbix/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID} メッセージを受信すると、本文に*イベントの詳細* ページへのリンクが含まれます。このページには、イベント、そのトリガー、および同じトリガーによって生成された最新のイベントのリストに関する情報が表示されます。 ##### Example 4 Retrieving weather information by connecting to the Openweathermap public service. - Configure a master item for bulk data collection in a single JSON:  Note the usage of macros in query fields. Refer to the [Openweathermap API](https://openweathermap.org/current) for how to fill them. Sample JSON returned in response to HTTP agent: ``` {.json} { "body": { "coord": { "lon": 40.01, "lat": 56.11 }, "weather": [{ "id": 801, "main": "Clouds", "description": "few clouds", "icon": "02n" }], "base": "stations", "main": { "temp": 15.14, "pressure": 1012.6, "humidity": 66, "temp_min": 15.14, "temp_max": 15.14, "sea_level": 1030.91, "grnd_level": 1012.6 }, "wind": { "speed": 1.86, "deg": 246.001 }, "clouds": { "all": 20 }, "dt": 1526509427, "sys": { "message": 0.0035, "country": "RU", "sunrise": 1526432608, "sunset": 1526491828 }, "id": 487837, "name": "Stavrovo", "cod": 200 } } ``` The next task is to configure dependent items that extract data from the JSON. - Configure a sample dependent item for humidity:  Other weather metrics such as 'Temperature' are added in the same manner. - Sample dependent item value preprocessing with JSONPath:  - Check the result of weather data in *Latest data*: {width="600"} ##### 例4 Openweathermapの公開サービスに接続して天気情報を取得する。 - 1つのJSONでデータを一括収集するためのマスター item を設定する。  クエリフィールドのマクロの使い方に注意してください。<br> 記入方法は、[Openweathermap API](https://openweathermap.org/current)を参照してください。 HTTP agentのレスポンスで返されるJSONのサンプル: ``` {.json} { "body": { "coord": { "lon": 40.01, "lat": 56.11 }, "weather": [{ "id": 801, "main": "Clouds", "description": "few clouds", "icon": "02n" }], "base": "stations", "main": { "temp": 15.14, "pressure": 1012.6, "humidity": 66, "temp_min": 15.14, "temp_max": 15.14, "sea_level": 1030.91, "grnd_level": 1012.6 }, "wind": { "speed": 1.86, "deg": 246.001 }, "clouds": { "all": 20 }, "dt": 1526509427, "sys": { "message": 0.0035, "country": "RU", "sunrise": 1526432608, "sunset": 1526491828 }, "id": 487837, "name": "Stavrovo", "cod": 200 } } ``` 次のタスクは、JSONからデータを抽出する従属 itemを設定することです。 - 湿度に関するサンプルの従属 item を設定します。  その他、「気温」などの気象指標も同様に追加されます。 - JSONPathを使った従属 item 値のプリプロセスの例:  - *Latest data*で気象データの結果を確認します: {width="600"} ##### Example 4 Someone is downloading a large file from the Internet. Use of function min: min(/www.example.com/net.if.in[eth0,bytes],5m)>100K The expression is true when number of received bytes on eth0 is more than 100 KB within last 5 minutes. ##### 例4 誰かがインターネットから大きなファイルをダウンロードしている。 min 関数を使って: min(/www.example.com/net.if.in[eth0,bytes],5m)>100K eth0の受信バイト数が過去5分以内に100KB以上であれば，この式は "TRUE" となります。 ##### Example 4 Synchronize the agent unavailability condition with the item update interval: - define {$INTERVAL} macro and use it in the item update interval; - use {$INTERVAL} as parameter of the agent unavailability trigger: `nodata(/ca_001/agent.ping,{$INTERVAL})=1` ##### 例 4 agent の利用不可条件と item の更新間隔を同期させる。: - {INTERVAL} マクロを定義し、item の更新間隔に使用する。 - {INTERVAL} を agent 使用不可トリガーのパラメータとして使用する。 `nodata(/ca_001/agent.ping,{$INTERVAL})=1` ##### Example 5 An escalation with several operations assigned to one step and custom intervals used. The default operation step duration is 30 minutes. {width="600"} Notifications will be sent as follows: - to MySQL administrators at 0:00, 0:30, 1:00, 1:30 after the problem starts - to Database manager at 2:00 and 2:10 (and not at 3:00; seeing that steps 5 and 6 overlap with the next operation, the shorter custom step duration of 10 minutes in the next operation overrides the longer step duration of 1 hour tried to set here) - to Zabbix administrators at 2:00, 2:10, 2:20 after the problem starts (the custom step duration of 10 minutes working) - to guest users at 4:00 hours after the problem start (the default step duration of 30 minutes returning between steps 8 and 11) ##### 例 5 複数の操作が 1 つのステップに割り当てられ、カスタム間隔が使用されるエスカレーション。 デフォルトの操作ステップの所要時間は 30 分です。 {width="600"} 通知は次のように送信されます: - 問題が発生してから 0:00、0:30、1:00、1:30 に MySQL 管理者に - 2:00 と 2:10 にデータベース マネージャーに (3:00 ではありません。ステップ 5 と 6 が次の操作と重複しているため、次の操作の 10 分の短いカスタム ステップ期間は、ここで設定しようとした 1 時間の長いステップ期間をオーバーライドします) - 問題が発生した後の 2:00、2:10、2:20 に Zabbix 管理者に (10 分間のカスタム ステップ継続時間) - 問題が発生してから 4:00 時間後にゲスト ユーザーに (ステップ 8 と 11 の間に戻る 30 分のデフォルトのステップ継続時間) ##### Example 5 Average CPU load on all hosts in multiple host groups that have the specific tags. avg(last_foreach(/*/system.cpu.load?[(group="Servers A" or group="Servers B" or group="Servers C") and (tag="Service:" or tag="Importance:High")])) ##### 例5 特定のタグを持つ複数のホストグループに属する全ホストのCPU負荷の平均値 avg(last_foreach(/*/system.cpu.load?[(group="Servers A" or group="Servers B" or group="Servers C") and (tag="Service:" or tag="Importance:High")])) ##### Example 5 Both nodes of clustered SMTP server are down. Note use of two different hosts in one expression: last(/smtp1.example.com/net.tcp.service[smtp])=0 and last(/smtp2.example.com/net.tcp.service[smtp])=0 The expression is true when both SMTP servers are down on both smtp1.example.com and smtp2.example.com. ##### 例5 クラスタ化されたSMTPサーバの両ノードがダウン 1つの式に2つの異なるホストが使用されていることに注意してください。 last(/smtp1.example.com/net.tcp.service[smtp])=0 and last(/smtp2.example.com/net.tcp.service[smtp])=0 smtp1.example.comとsmtp2.example.comの両方でSMTPサーバがダウンしている場合、この式は成立します。 ##### Example 5 Connecting to Nginx status page and getting its metrics in bulk. - Configure Nginx following the [official guide](https://nginx.ru/en/docs/http/ngx_http_stub_status_module.html). ```{=html} <!-- --> ``` - Configure a master item for bulk data collection:  Sample Nginx stub status output: Active connections: 1 Active connections: server accepts handled requests 52 52 52 Reading: 0 Writing: 1 Waiting: 0 The next task is to configure dependent items that extract data. - Configure a sample dependent item for requests per second:  - Sample dependent item value preprocessing with regular expression `server accepts handled requests\s+([0-9]+) ([0-9]+) ([0-9]+)`: {width="600"} - Check the complete result from stub module in *Latest data*: {width="600"} ##### 例5 Nginx のステータスページに接続し、そのメトリクスを一括で取得する。 - [official guide](https://nginx.ru/en/docs/http/ngx_http_stub_status_module.html)に従ってNginxを設定します。 ```{=html} <!-- --> ``` - 一括データ収集のためのマスター item を設定する。  Nginx stubのステータス出力のサンプル: Active connections: 1 Active connections: server accepts handled requests 52 52 52 Reading: 0 Writing: 1 Waiting: 0 次のタスクは、データを抽出する従属 item を設定することです。 - サンプルとして、1秒あたりのリクエストの従属 item を設定します。  - 正規表現による従属 item 値のプリプロセッシング例 `server accepts handled requests\s+([0-9]+) ([0-9]+) ([0-9]+)`: {width="600"} - スタブモジュールの全結果は*Latest data*でご確認ください。 {width="600"} ##### Example 5 Informing about values from several hosts in a trigger expression. Message: Problem name: {TRIGGER.NAME} Trigger expression: {TRIGGER.EXPRESSION} 1. Item value on {HOST.NAME1}: {ITEM.VALUE1} ({ITEM.NAME1}) 2. Item value on {HOST.NAME2}: {ITEM.VALUE2} ({ITEM.NAME2}) When you receive the message, the message will be replaced by something like: Problem name: Processor load is too high on a local host Trigger expression: last(/Myhost/system.cpu.load[percpu,avg1])>5 or last(/Myotherhost/system.cpu.load[percpu,avg1])>5 1. Item value on Myhost: 0.83 (Processor load (1 min average per core)) 2. Item value on Myotherhost: 5.125 (Processor load (1 min average per core)) ##### 例 5 トリガー式で複数のホストからの値を通知します。 メッセージ本文: Problem name: {TRIGGER.NAME} Trigger expression: {TRIGGER.EXPRESSION} 1. Item value on {HOST.NAME1}: {ITEM.VALUE1} ({ITEM.NAME1}) 2. Item value on {HOST.NAME2}: {ITEM.VALUE2} ({ITEM.NAME2}) メッセージを受信すると、メッセージは次のように置き換えられます: Problem name: Processor load is too high on a local host Trigger expression: last(/Myhost/system.cpu.load[percpu,avg1])>5 or last(/Myotherhost/system.cpu.load[percpu,avg1])>5 1. Item value on Myhost: 0.83 (Processor load (1 min average per core)) 2. Item value on Myotherhost: 5.125 (Processor load (1 min average per core)) ##### Example 6 Calculation used on the latest item value sums of a whole host group. sum(last_foreach(/*/net.if.out[eth0,bytes]?[group="video"])) / sum(last_foreach(/*/nginx_stat.sh[active]?[group="video"])) ##### 例6 ホストグループ全体の最新の item 値合計で計算します sum(last_foreach(/*/net.if.out[eth0,bytes]?[group="video"])) / sum(last_foreach(/*/nginx_stat.sh[active]?[group="video"])) ##### Example 6 Receiving details of both the problem event and recovery event in a [recovery](/manual/config/notifications/action/recovery_operations) message: Message: Problem: Event ID: {EVENT.ID} Event value: {EVENT.VALUE} Event status: {EVENT.STATUS} Event time: {EVENT.TIME} Event date: {EVENT.DATE} Event age: {EVENT.AGE} Event acknowledgment: {EVENT.ACK.STATUS} Event update history: {EVENT.UPDATE.HISTORY} Recovery: Event ID: {EVENT.RECOVERY.ID} Event value: {EVENT.RECOVERY.VALUE} Event status: {EVENT.RECOVERY.STATUS} Event time: {EVENT.RECOVERY.TIME} Event date: {EVENT.RECOVERY.DATE} Operational data: {EVENT.OPDATA} When you receive the message, the macros will be replaced by something like: Problem: Event ID: 21874 Event value: 1 Event status: PROBLEM Event time: 13:04:30 Event date: 2018.01.02 Event age: 5m Event acknowledgment: Yes Event update history: 2018.01.02 13:05:51 "John Smith (Admin)" Actions: acknowledged. Recovery: Event ID: 21896 Event value: 0 Event status: OK Event time: 13:10:07 Event date: 2018.01.02 Operational data: Current value is 0.83 ::: noteimportant Separate notification macros for the original problem event and recovery event are supported since Zabbix 2.2.0. ::: ##### 例 6 [recovery](/manual/config/notifications/action/recovery_operations) メッセージで障害イベントと復旧イベントの両方の詳細を受信する: メッセージ本文: Problem: Event ID: {EVENT.ID} Event value: {EVENT.VALUE} Event status: {EVENT.STATUS} Event time: {EVENT.TIME} Event date: {EVENT.DATE} Event age: {EVENT.AGE} Event acknowledgment: {EVENT.ACK.STATUS} Event update history: {EVENT.UPDATE.HISTORY} Recovery: Event ID: {EVENT.RECOVERY.ID} Event value: {EVENT.RECOVERY.VALUE} Event status: {EVENT.RECOVERY.STATUS} Event time: {EVENT.RECOVERY.TIME} Event date: {EVENT.RECOVERY.DATE} Operational data: {EVENT.OPDATA} メッセージを受信すると、次のように置き換えられます: Problem: Event ID: 21874 Event value: 1 Event status: PROBLEM Event time: 13:04:30 Event date: 2018.01.02 Event age: 5m Event acknowledgment: Yes Event update history: 2018.01.02 13:05:51 "John Smith (Admin)" Actions: acknowledged. Recovery: Event ID: 21896 Event value: 0 Event status: OK Event time: 13:10:07 Event date: 2018.01.02 Operational data: Current value is 0.83 ::: noteimportant Zabbix 2.2.0以降、元の障害イベントと復旧イベントの個別通知マクロがサポートされています。 ::: ##### Example 6 Use host prototype macro to configure items for discovered hosts: - on a host prototype define user macro {$SNMPVALUE} with {\#SNMPVALUE} [low-level discovery](/manual/config/macros/lld_macros) macro as a value:  - assign *Generic SNMPv2* template to the host prototype; - use {$SNMPVALUE} in the *SNMP OID* field of *Generic SNMPv2* template items. ##### 例 6 ホストプロトタイプマクロを使用して、検出されたホストの item を設定します: ホストプロトタイプで、{$SNMPVALUE} を {\#SNMPVALUE}[low-level discovery](/manual/config/macros/lld_macros) マクロ値として定義します:  - ホストプロトタイプに *Generic SNMPv2* テンプレートを割り当てます。 - {SNMPVALUE} を使用します。汎用SNMPv2*テンプレート項目の *SNMP OID* フィールドに {$SNMPVALUE} を使用します。 ##### Example 6 Zabbix agent needs to be upgraded. Use of function find(): find(/example.example.com/agent.version,,"like","beta8")=1 The expression is true if Zabbix agent has version beta8. ##### 例6 Zabbix agent のアップグレードが必要 関数find()を使用して: find(/example.example.com/agent.version,,"like","beta8")=1 この式は、Zabbix agent のバージョンがbeta8である場合に "TRUE" となります。 ##### Example 7 Server is unreachable. count(/example.example.com/icmpping,30m,,"0")>5 The expression is true if host "example.example.com" is unreachable more than 5 times in the last 30 minutes. ##### 例7 サーバにアクセスできない count(/example.example.com/icmpping,30m,,"0")>5 この式は、ホスト "example.example.com "が過去30分間に5回以上到達不能になった場合に "TRUE" となる。 ##### Example 7 The total number of unsupported items in host group 'Zabbix servers'. sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="Zabbix servers"])) ##### 例7 ホストグループ'Zabbix servers'でサポートされていないアイテムの総数。 sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="Zabbix servers"])) ##### Example 8 No heartbeats within last 3 minutes. Use of function nodata(): nodata(/example.example.com/tick,3m)=1 To make use of this trigger, 'tick' must be defined as a Zabbix [trapper](/manual/config/items/itemtypes/trapper) item. The host should periodically send data for this item using zabbix\_sender. If no data is received within 180 seconds, the trigger value becomes PROBLEM. *Note* that 'nodata' can be used for any item type. ##### 例8 過去3分以内に heartbeats がない。 関数nodata()を使用して: nodata(/example.example.com/tick,3m)=1 この trigger を使用するには、Zabbix [trapper](/manual/config/items/itemtypes/trapper) item として'tick'を定義する必要があります。<br> ホストはこの item のデータを zabbix\_sender を使用して定期的に送信する必要があります。180 秒以内にデータが受信されないと、<br> trigger の値が PROBLEM になります。 *注意* 'nodata' は任意の item タイプに使用できることに注意してください。 ##### Example 9 CPU activity at night time. Use of function time(): min(/Zabbix server/system.cpu.load[all,avg1],5m)>2 and time()<060000 The trigger may change its state to problem only at night time (00:00 - 06:00). ##### 例 9 夜間の CPU アクティビティ 関数time()を使用 min(/Zabbix server/system.cpu.load[all,avg1],5m)>2 and time()>000000 and time()<060000 トリガーの状態が障害に変わるのは夜間（00:00 - 06:00）のみです。 ##### Example configuration for Apache # .. ProxyPass "/" http://host/zabbix/ ProxyPassReverse "/" http://host/zabbix/ ProxyPassReverseCookiePath /zabbix / ProxyPassReverseCookieDomain host zabbix.example.com # .. ##### Apacheの設定ファイル例 # .. ProxyPass "/" http://host/zabbix/ ProxyPassReverse "/" http://host/zabbix/ ProxyPassReverseCookiePath /zabbix / ProxyPassReverseCookieDomain host zabbix.example.com # .. ##### Example configuration for nginx # .. location / { # .. proxy_cookie_path /zabbix /; proxy_pass http://192.168.0.94/zabbix/; # .. ##### nginxの設定ファイル例 # .. location / { # .. proxy_cookie_path /zabbix /; proxy_pass http://192.168.0.94/zabbix/; # .. #### Example Getting memory usage of *apache* process. If using this OID syntax: HOST-RESOURCES-MIB::hrSWRunPerfMem["index","HOST-RESOURCES-MIB::hrSWRunPath", "/usr/sbin/apache2"] the index number will be looked up here: ... HOST-RESOURCES-MIB::hrSWRunPath.5376 = STRING: "/sbin/getty" HOST-RESOURCES-MIB::hrSWRunPath.5377 = STRING: "/sbin/getty" HOST-RESOURCES-MIB::hrSWRunPath.5388 = STRING: "/usr/sbin/apache2" HOST-RESOURCES-MIB::hrSWRunPath.5389 = STRING: "/sbin/sshd" ... Now we have the index, 5388. The index will be appended to the data OID in order to receive the value we are interested in: HOST-RESOURCES-MIB::hrSWRunPerfMem.5388 = INTEGER: 31468 KBytes #### 例 *apache* プロセスのメモリ使用量を取得します。 この OID 構文を使用する場合、以下のようになります。 HOST-RESOURCES-MIB::hrSWRunPerfMem["index", "HOST-RESOURCES-MIB::hrSWRunPath","/usr/sbin/apache2"] インデックス番号はここで検索されます。 ... HOST-RESOURCES-MIB::hrSWRunPath.5376 = STRING: "/sbin/getty" HOST-RESOURCES-MIB::hrSWRunPath.5377 = STRING: "/sbin/getty" HOST-RESOURCES-MIB::hrSWRunPath.5388 = STRING: "/usr/sbin/apache2" HOST-RESOURCES-MIB::hrSWRunPath.5389 = STRING: "/sbin/sshd" ... これで、5388というインデックスができました。<br> このインデックスは、データOIDに追加され、目的の値を受け取ります。<br> HOST-RESOURCES-MIB::hrSWRunPerfMem.5388 = INTEGER: 31468 KBytes Example of using runtime control to reload the server configuration cache: zabbix_server -c /usr/local/etc/zabbix_server.conf -R config_cache_reload Examples of using runtime control to gather diagnostic information: # Gather all available diagnostic information in the server log file: zabbix_server -R diaginfo # Gather history cache statistics in the server log file: zabbix_server -R diaginfo=historycache Example of using runtime control to reload the SNMP cache: zabbix_server -R snmp_cache_reload Example of using runtime control to trigger execution of housekeeper: zabbix_server -c /usr/local/etc/zabbix_server.conf -R housekeeper_execute Examples of using runtime control to change log level: # Increase log level of all processes: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase # Increase log level of second poller process: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=poller,2 # Increase log level of process with PID 1234: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=1234 # Decrease log level of all http poller processes: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_decrease="http poller" Example of setting the HA failover delay to the minimum of 10 seconds: zabbix_server -R ha_set_failover_delay=10s ランタイム制御を使用してサーバー設定キャッシュをリロードする例: zabbix_server -c /usr/local/etc/zabbix_server.conf -R config_cache_reload ランタイム制御を使用して診断情報を収集する例: # サーバーログファイルで利用可能なすべての診断情報を収集する: zabbix_server -R diaginfo # サーバーログファイルでヒストリキャッシュ統計を収集する: zabbix_server -R diaginfo=historycache ランタイム制御を使用してSNMPキャッシュをリロードする例: zabbix_server -R snmp_cache_reload ランタイム制御を使用してハウスキーパーの実行をトリガーする例: zabbix_server -c /usr/local/etc/zabbix_server.conf -R housekeeper_execute ランタイム制御を使用してログレベルを変更する例: # すべてのプロセスのログレベルを上げる: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase # 2番目のポーラープロセスのログレベルを上げる: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=poller,2 # PID 1234のプロセスのログレベルを上げる: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=1234 # すべてのhttpポーラープロセスのログレベルを下げる: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_decrease="http poller" HAフェイルオーバー遅延を最小10秒に設定する例: zabbix_server -R ha_set_failover_delay=10s *Example:* Problem *Web camera 3 is down* has tags `type:video surveillance`, `floor:1st` and `name:webcam 3` and status *Warning* The service **Web camera 3** has the only problem tag specified: `name:webcam 3` {width=600} Service status will change from *OK* to *Warning* when this problem is detected. If the service **Web camera 3** had problem tags `name:webcam 3` and `floor:2nd`, its status would not be changed, when the problem is detected, because the conditions are only partially met. *例：* 問題 *Webカメラ3がダウンしています* タグ `type:video surveillance`,`floor:1st`,`name:webcam 3` status *Warning* サービス**Web camera 3**には、問題タグが一つだけ指定されています： `name:webcam 3` {width=600} この問題が検出されると、サービスステータスが*OK*から*Warning*に変わります。 サービス**Webカメラ3**に問題タグ`name:webcam 3`と`floor:2nd`が含まれている場合、条件が部分的にしか満たされていないため、問題が検出されてもステータスは変更されません。 ### 既存サービスの変更 ::: noteclassic 以下で説明するボタンは、*Services*セクションがEditモードの場合にのみ表示されます。 ::: 既存のサービスを編集するには、サービスの横にある鉛筆アイコンを押します。 既存のサービスのクローンを作成するには、鉛筆アイコンを押してその構成を開き、[Clone]ボタンを押します。サービスが複製されると、その親リンクは保持されますが、子リンクは保持されません。 サービスを削除するには、サービスの横にあるxアイコンを押します。親サービスを削除すると、その子サービスは削除されず、サービスツリーの1つ上のレベルに移動します（第1レベルの子は、削除された親サービスと同じレベルになります）。 サービスのリストの下にある2つのボタンは、いくつかの一括編集オプションを提供します。 Mass update - サービスのプロパティを一括更新 Delete - サービスを削除 これらのオプションを使用するには、サービスのチェックボックスをオンにしてから、必要なボタンをクリックします。 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples #### LLD ルールから graph prototypes を取得する LLD ルールからすべての graph prototypes を取得します。 Request: ``` {.java} { "jsonrpc": "2.0", "method": "graphprototype.get", "params": { "output": "extend", "discoveryids": "27426" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": [ { "graphid": "1017", "parent_itemid": "27426", "name": "Disk space usage {#FSNAME}", "width": "600", "height": "340", "yaxismin": "0.0000", "yaxismax": "0.0000", "templateid": "442", "show_work_period": "0", "show_triggers": "0", "graphtype": "2", "show_legend": "1", "show_3d": "1", "percent_left": "0.0000", "percent_right": "0.0000", "ymin_type": "0", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "discover": "0" } ], "id": 1 } ``` ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 ### Examples ### 例 #### Examples #### 例 #### Examples #### 例 #### Examples #### 例 #### Examples #### 例 #### Examples #### 例 #### Examples Examples here illustrate how you can use macros in messages. #### 例 以下の例は、メッセージでマクロを使用する方法を示しています。 #### Examples Examples of [global scripts](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script) that may be used as remote commands in action operations. #### 例 アクションの実行内容でリモート コマンドとして使用できる[グローバル スクリプト](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script)の例。 #### Examples Here are some code snippets showing how to add Zabbix protocol header to the data you want to send in order to obtain the packet you should send to Zabbix so that it is interpreted correctly. These code snippets assume that the data is not larger than 1GB, thus the large packet format is not used. ##### Python ```python packet = b"ZBXD\1" + struct.pack("<II", len(data), 0) + data ``` or ```python def zbx_create_header(plain_data_size, compressed_data_size=None): protocol = b"ZBXD" flags = 0x01 if compressed_data_size is None: datalen = plain_data_size reserved = 0 else: flags |= 0x02 datalen = compressed_data_size reserved = plain_data_size return protocol + struct.pack("<BII", flags, datalen, reserved) packet = zbx_create_header(len(data)) + data ``` ##### Perl ```perl my $packet = "ZBXD\1" . pack("(II)<", length($data), 0) . $data; ``` or ```perl sub zbx_create_header($;$) { my $plain_data_size = shift; my $compressed_data_size = shift; my $protocol = "ZBXD"; my $flags = 0x01; my $datalen; my $reserved; if (!defined($compressed_data_size)) { $datalen = $plain_data_size; $reserved = 0; } else { $flags |= 0x02; $datalen = $compressed_data_size; $reserved = $plain_data_size; } return $protocol . chr($flags) . pack("(II)<", $datalen, $reserved); } my $packet = zbx_create_header(length($data)) . $data; ``` ##### PHP ```php $packet = "ZBXD\1" . pack("VV", strlen($data), 0) . $data; ``` or ```php function zbx_create_header($plain_data_size, $compressed_data_size = null) { $protocol = "ZBXD"; $flags = 0x01; if (is_null($compressed_data_size)) { $datalen = $plain_data_size; $reserved = 0; } else { $flags |= 0x02; $datalen = $compressed_data_size; $reserved = $plain_data_size; } return $protocol . chr($flags) . pack("VV", $datalen, $reserved); } $packet = zbx_create_header(strlen($data)) . $data; ``` ##### Bash ```bash datalen=$(printf "%08x" ${#data}) datalen="\\x${datalen:6:2}\\x${datalen:4:2}\\x${datalen:2:2}\\x${datalen:0:2}" printf "ZBXD\1${datalen}\0\0\0\0%s" "$data" ``` #### 例 以下は、Zabbix に送信する必要があるパケットを取得して正しく解釈されるようにするために、送信するデータに Zabbix プロトコル ヘッダーを追加する方法を示すコード スニペットです。 これらのコード スニペットは、データが 1GB を超えないことを前提としているため、ラージ パケット フォーマットは使用されません。 ##### Python ```python packet = b"ZBXD\1" + struct.pack("<II", len(data), 0) + data ``` または ```python def zbx_create_header(plain_data_size, compressed_data_size=None): protocol = b"ZBXD" flags = 0x01 if compressed_data_size is None: datalen = plain_data_size reserved = 0 else: flags |= 0x02 datalen = compressed_data_size reserved = plain_data_size return protocol + struct.pack("<BII", flags, datalen, reserved) packet = zbx_create_header(len(data)) + data ``` ##### Perl ```perl my $packet = "ZBXD\1" . pack("(II)<", length($data), 0) . $data; ``` または ```perl sub zbx_create_header($;$) { my $plain_data_size = shift; my $compressed_data_size = shift; my $protocol = "ZBXD"; my $flags = 0x01; my $datalen; my $reserved; if (!defined($compressed_data_size)) { $datalen = $plain_data_size; $reserved = 0; } else { $flags |= 0x02; $datalen = $compressed_data_size; $reserved = $plain_data_size; } return $protocol . chr($flags) . pack("(II)<", $datalen, $reserved); } my $packet = zbx_create_header(length($data)) . $data; ``` ##### PHP ```php $packet = "ZBXD\1" . pack("VV", strlen($data), 0) . $data; ``` または ```php function zbx_create_header($plain_data_size, $compressed_data_size = null) { $protocol = "ZBXD"; $flags = 0x01; if (is_null($compressed_data_size)) { $datalen = $plain_data_size; $reserved = 0; } else { $flags |= 0x02; $datalen = $compressed_data_size; $reserved = $plain_data_size; } return $protocol . chr($flags) . pack("VV", $datalen, $reserved); } $packet = zbx_create_header(strlen($data)) . $data; ``` ##### Bash ```bash datalen=$(printf "%08x" ${#data}) datalen="\\x${datalen:6:2}\\x${datalen:4:2}\\x${datalen:2:2}\\x${datalen:0:2}" printf "ZBXD\1${datalen}\0\0\0\0%s" "$data" ``` #### Examples :::noteclassic The commands listed below are for Docker Compose V2. If you are using Docker Compose V1, replace `docker compose -f` with `docker-compose -f` ::: **Example 1** # git checkout 6.0 # docker compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d The command will download latest Zabbix 6.0 images for each Zabbix component and run them in detach mode. ::: noteimportant Do not forget to download `.env_<type of component>` files from github.com official Zabbix repository with compose files. ::: **Example 2** # git checkout 6.0 # docker compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d The command will download base image Ubuntu 20.04 (focal), then build Zabbix 6.0 components locally and run them in detach mode. #### 例 :::noteclassic 以下に記述されているコマンドは、Docker Compose V2用です。 Docker Compose V1を使用している場合は、`docker compose -f`を`docker-compose -f`に書き換えます。 ::: **例 1** # git checkout 6.0 # docker compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d このコマンドは、各Zabbixコンポーネントの最新のZabbix 6.0イメージをダウンロードし、デタッチモードで実行します。 ::: noteimportant github.comの公式Zabbixリポジトリから`.env_<コンポーネントの種類>`ファイルをComposeファイルとともにダウンロードすることを忘れないでください。 ::: **例 2** # git checkout 6.0 # docker compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d このコマンドは、ベースイメージUbuntu 20.04 (focal)をダウンロードし、Zabbix 6.0コンポーネントをローカルでビルドして、デタッチモードで実行します。 ##### Examples Numeric (unsigned) value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519304285,"ns":123456789,"value":1,"type":3} Numeric (float) value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":0.1,"type":0} Character, text value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":2,"name":"Agent version","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4} Log value: {"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2} ##### 例 数字 (符号なし) 値: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519304285,"ns":123456789,"value":1,"type":3} 数字 (浮動小数) 値: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":0.1,"type":0} 文字,テキスト 値: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":2,"name":"Agent version","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4} ログ値: {"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2} ##### Examples Numeric (unsigned) value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3} Numeric (float) value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0} ##### 例 数字 (符号なし)値: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3} 数字 (浮動小数点) 値: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0} ##### Examples of correct/incorrect syntax Expressions (including function calls) cannot be used as history, trend, or foreach [function](/manual/appendix/functions) parameters. However, those functions themselves can be used in other (non-historical) function parameters. |Expression|Example| |-|---------| |Valid|`avg(last(/host/key1),last(/host/key2)*10,last(/host/key1)*100)`<br>`max(avg(avg_foreach(/*/system.cpu.load?[group="Servers A"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers B"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers C"],5m)))`| |Invalid|`sum(/host/key,10+2)`<br>`sum(/host/key, avg(10,2))`<br>`sum(/host/key,last(/host/key2))`| Note that in an expression like: sum(sum_foreach(//resptime[*],5m))/sum(count_foreach(//resptime[*],5m)) it cannot be guaranteed that both parts of the equation will always have the same set of values. While one part of the expression is evaluated, a new value for the requested period may arrive and then the other part of the expression will have a different set of values. ##### 正しい/間違った構文の例 式 (関数呼び出しを含む) は、ヒストリー、トレンド、または foreach [関数](/manual/appendix/functions) パラメーターとして使用できません。 ただし、これらの関数自体は、他の (非ヒストリ) 関数パラメーターで使用できます。 |式|例| |-|---------| |有効|`avg(last(/host/key1),last(/host/key2)*10,last(/host/key1)*100)`<br>`max(avg(avg_foreach(/*/system.cpu.load?[group="Servers A"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers B"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers C"],5m)))`| |I無効|`sum(/host/key,10+2)`<br>`sum(/host/key, avg(10,2))`<br>`sum(/host/key,last(/host/key2))`| 次のような表現に注意してください。 sum(sum_foreach(//resptime[*],5m))/sum(count_foreach(//resptime[*],5m)) 式の両方の部分が常に同じ値のセットになるとは限りません。 式の一部が評価されている間に、要求された期間の新しい値が到着し、式の他の部分が異なる値のセットを持つことがあります。 #### Examples of hardware configuration The table provides examples of hardware configuration, assuming a **Linux/BSD/Unix** platform. These are size and hardware configuration examples to start with. Each Zabbix installation is unique. Make sure to benchmark the performance of your Zabbix system in a staging or development environment, so that you can fully understand your requirements before deploying the Zabbix installation to its production environment. |Installation size|Monitored metrics^**1**^|CPU/vCPU cores|Memory<br>(GiB)|Database|Amazon EC2^**2**^| |-|-|-|-|-|-| |Small|1 000|2|8|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.large/m6g.large| |Medium|10 000|4|16|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.xlarge/m6g.xlarge| |Large|100 000|16|64|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.4xlarge/m6g.4xlarge| |Very large|1 000 000|32|96|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.8xlarge/m6g.8xlarge| ^**1**^ 1 metric = 1 item + 1 trigger + 1 graph<br> ^**2**^ Example with Amazon general purpose EC2 instances, using ARM64 or x86_64 architecture, a proper instance type like Compute/Memory/Storage optimised should be selected during Zabbix installation evaluation and testing before installing in its production environment. ::: noteclassic Actual configuration depends on the number of active items and refresh rates very much (see [database size](#database-size) section of this page for details). It is highly recommended to run the database on a separate server for large installations. ::: #### ハードウェア構成例 この表は**Linux/BSD/Unix**プラットフォームを想定したハードウェア構成の例を示しています。 これらは、開始時のサイズとハードウェア構成の例です。Zabbixのインストールはそれぞれ異なります。Zabbix を本番環境に導入する前に、ステージング環境または開発環境でZabbixシステムのパフォーマンスをベンチマークし、要件を十分に理解してください。 |インストールサイズ|監視メトリクス^**1**^|CPU/vCPU コア|メモリ<br>(GiB)|データベース|Amazon EC2^**2**^| |-|-|-|-|-|-| |小|1 000|2|8|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.large/m6g.large| |中|10 000|4|16|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.xlarge/m6g.xlarge| |大|100 000|16|64|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.4xlarge/m6g.4xlarge| |特大|1 000 000|32|96|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.8xlarge/m6g.8xlarge| ^**1**^ 1 メトリクス = 1 アイテム + 1 トリガー + 1 グラフ<br> ^**2**^ ARM64またはx86_64アーキテクチャを使用するAmazon汎用EC2インスタンスの例では、本番環境にインストールする前に、Zabbixのインストール評価およびテスト中にコンピュート/メモリ/ストレージの最適化などの適切なインスタンスタイプを選択する必要があります。 ::: noteclassic 実際の構成は、アクティブなアイテムの数とリフレッシュレートに大きく依存します (詳細については、このページの[データベースのサイジング](#データベースのサイジング)セクションを参照してください)。大規模なインストールの場合は、データベースを別のサーバーで実行することを強くお勧めします。 ::: ##### Examples of hardware configuration The table provides several examples of hardware configurations: |Name|Platform|CPU/Memory|Database|Monitored hosts| |----|--------|----------|--------|---------------| |*Small*|CentOS|Virtual Appliance|MySQL InnoDB|100| |*Medium*|CentOS|2 CPU cores/2GB|MySQL InnoDB|500| |*Large*|RedHat Enterprise Linux|4 CPU cores/8GB|RAID10 MySQL InnoDB or PostgreSQL|>1000| |*Very large*|RedHat Enterprise Linux|8 CPU cores/16GB|Fast RAID10 MySQL InnoDB or PostgreSQL|>10000| ::: noteclassic Actual configuration depends on the number of active items and refresh rates very much (see [database size](/manual/installation/requirements#Database_size) section of this page for details). It is highly recommended to run the database on a separate box for large installations. ::: ##### ハードウェアの構成例 表でハードウェアの構成例をいくつか示しています。 |名称|プラットフォーム|CPU/メモリ|データベース|監視ホスト数| |----|--------|----------|--------|---------------| |*Small*|CentOS|Virtual Appliance|MySQL InnoDB|100| |*Medium*|CentOS|2 CPU cores/2GB|MySQL InnoDB|500| |*Large*|RedHat Enterprise Linux|4 CPU cores/8GB|RAID10 MySQL InnoDB or PostgreSQL|>1000| |*Very large*|RedHat Enterprise Linux|8 CPU cores/16GB|Fast RAID10 MySQL InnoDB or PostgreSQL|>10000| ::: noteclassic 実際の設定は、アクティブなアイテムと更新頻度に大きく依存します。 <br> (このページの[database size](/manual/installation/requirements#Database_size) を参考にしてください) <br> 大規模構成で構築する場合は、データベースサーバを一体にせずに別に作成することを強く推奨します。 ::: ##### Examples of simple user parameters A simple command: UserParameter=ping,echo 1 The agent will always return '1' for an item with 'ping' key. A more complex example: UserParameter=mysql.ping,mysqladmin -uroot ping | grep -c alive The agent will return '1', if MySQL server is alive, '0' - otherwise. ##### 単純なユーザーパラメータの例 単純なコマンド: UserParameter=ping,echo 1 agent は、'ping' キーを持つ item に対して常に '1' を返します。 より複雑な例: UserParameter=mysql.ping,mysqladmin -uroot ping | grep -c alive agent は、MySQL サーバが生きている場合は '1' を、そうでない場合は '0' を返します。 #### Examples of triggers #### trigger の例 ##### Examples Problem: {"clock":1519304285,"ns":123456789,"value":1,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"eventid":42, "hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} Recovery: {"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42} Problem (multiple problem event generation): {"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} {"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} Recovery: {"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43} {"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42} ##### 例 障害: {"clock":1519304285,"ns":123456789,"value":1,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"eventid":42, "hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} リカバリ: {"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42} 障害 (多重障害イベントの生成): {"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} {"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]} リカバリ: {"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43} {"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42} ### Examples Request: ``` {.java} { "jsonrpc": "2.0", "method": "autoregistration.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tls_accept": "3" }, "id": 1 } ``` ### 例 リクエスト: ``` {.java} { "jsonrpc": "2.0", "method": "autoregistration.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "tls_accept": "3" }, "id": 1 } ``` ### Examples Request: ``` {.java} { "jsonrpc": "2.0", "method": "housekeeping.update", "params": { "hk_events_mode": "1", "hk_events_trigger": "200d", "hk_events_internal": "2d", "hk_events_discovery": "2d" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": [ "hk_events_mode", "hk_events_trigger", "hk_events_internal", "hk_events_discovery" ], "id": 1 } ``` ### 例 Request: ``` {.java} { "jsonrpc": "2.0", "method": "housekeeping.update", "params": { "hk_events_mode": "1", "hk_events_trigger": "200d", "hk_events_internal": "2d", "hk_events_discovery": "2d" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": [ "hk_events_mode", "hk_events_trigger", "hk_events_internal", "hk_events_discovery" ], "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "authentication.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "authentication_type": "0", "http_auth_enabled": "0", "http_login_form": "0", "http_strip_domains": "", "http_case_sensitive": "1", "ldap_configured": "0", "ldap_host": "", "ldap_port": "389", "ldap_base_dn": "", "ldap_search_attribute": "", "ldap_bind_dn": "", "ldap_case_sensitive": "1", "ldap_bind_password": "", "saml_auth_enabled": "0", "saml_idp_entityid": "", "saml_sso_url": "", "saml_slo_url": "", "saml_username_attribute": "", "saml_sp_entityid": "", "saml_nameid_format": "", "saml_sign_messages": "0", "saml_sign_assertions": "0", "saml_sign_authn_requests": "0", "saml_sign_logout_requests": "0", "saml_sign_logout_responses": "0", "saml_encrypt_nameid": "0", "saml_encrypt_assertions": "0", "saml_case_sensitive": "0", "passwd_min_length": "8", "passwd_check_rules": "8" }, "id": 1 } ``` ### 例 リクエスト: ```json { "jsonrpc": "2.0", "method": "authentication.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "authentication_type": "0", "http_auth_enabled": "0", "http_login_form": "0", "http_strip_domains": "", "http_case_sensitive": "1", "ldap_configured": "0", "ldap_host": "", "ldap_port": "389", "ldap_base_dn": "", "ldap_search_attribute": "", "ldap_bind_dn": "", "ldap_case_sensitive": "1", "ldap_bind_password": "", "saml_auth_enabled": "0", "saml_idp_entityid": "", "saml_sso_url": "", "saml_slo_url": "", "saml_username_attribute": "", "saml_sp_entityid": "", "saml_nameid_format": "", "saml_sign_messages": "0", "saml_sign_assertions": "0", "saml_sign_authn_requests": "0", "saml_sign_logout_requests": "0", "saml_sign_logout_responses": "0", "saml_encrypt_nameid": "0", "saml_encrypt_assertions": "0", "saml_case_sensitive": "0", "passwd_min_length": "8", "passwd_check_rules": "8" }, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "authentication.update", "params": { "http_auth_enabled": 1, "http_case_sensitive": 0, "http_login_form": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "http_auth_enabled", "http_case_sensitive", "http_login_form" ], "id": 1 } ``` ### 例 リクエスト: ```json { "jsonrpc": "2.0", "method": "authentication.update", "params": { "http_auth_enabled": 1, "http_case_sensitive": 0, "http_login_form": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": [ "http_auth_enabled", "http_case_sensitive", "http_login_form" ], "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "autoregistration.update", "params": { "tls_accept": "3", "tls_psk_identity": "PSK 001", "tls_psk": "11111595725ac58dd977beef14b97461a7c1045b9a1c923453302c5473193478" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ### 例 リクエスト: ```json { "jsonrpc": "2.0", "method": "autoregistration.update", "params": { "tls_accept": "3", "tls_psk_identity": "PSK 001", "tls_psk": "11111595725ac58dd977beef14b97461a7c1045b9a1c923453302c5473193478" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "settings.update", "params": { "login_attempts": "1", "login_block": "1m" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "login_attempts", "login_block" ], "id": 1 } ``` ### 例 Request: ```json { "jsonrpc": "2.0", "method": "settings.update", "params": { "login_attempts": "1", "login_block": "1m" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "login_attempts", "login_block" ], "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "user.checkAuthentication", "params": { "sessionid": "673b8ba11562a35da902c66cf5c23fa2" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userid": "1", "username": "Admin", "name": "Zabbix", "surname": "Administrator", "url": "", "autologin": "1", "autologout": "0", "lang": "ru_RU", "refresh": "0", "theme": "default", "attempt_failed": "0", "attempt_ip": "127.0.0.1", "attempt_clock": "1355919038", "rows_per_page": "50", "timezone": "Europe/Riga", "roleid": "3", "type": 3, "sessionid": "673b8ba11562a35da902c66cf5c23fa2" "debug_mode": 0, "userip": "127.0.0.1", "gui_access": 0 }, "id": 1 } ``` ::: noteclassic Response is similar to [User.login](/manual/api/reference/user/login) call response with "userData" parameter set to true (the difference is that user data is retrieved by session id and not by username / password). ::: ### 例 Request: ```json { "jsonrpc": "2.0", "method": "user.checkAuthentication", "params": { "sessionid": "673b8ba11562a35da902c66cf5c23fa2" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userid": "1", "username": "Admin", "name": "Zabbix", "surname": "Administrator", "url": "", "autologin": "1", "autologout": "0", "lang": "ru_RU", "refresh": "0", "theme": "default", "attempt_failed": "0", "attempt_ip": "127.0.0.1", "attempt_clock": "1355919038", "rows_per_page": "50", "timezone": "Europe/Riga", "roleid": "3", "type": 3, "sessionid": "673b8ba11562a35da902c66cf5c23fa2" "debug_mode": 0, "userip": "127.0.0.1", "gui_access": 0 }, "id": 1 } ``` ::: noteclassic レスポンスは"userData"パラメーターがtrueに設定された[User.login](/manual/api/reference/user/login)メソッドの結果に似ています。（違いはユーザーデータがユーザー名/パスワードではなくセッションIDによって取得されることです） ::: ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Clock* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*時計*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Data overview* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*データの概要*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Geomap* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*地理マップ*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Graph (classic)* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*グラフ（クラシック）*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Graph prototype* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*グラフのプロトタイプ*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Graph* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*グラフ*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Item value* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*アイテムの値*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Map navigation tree* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*マップナビゲーション*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Map* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*マップ*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Plain text* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*プレーンテキスト*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Problem hosts* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*障害中のホスト*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Problems by severity* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*深刻度ごとの障害数*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Problems* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*障害*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *SLA report* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*SLAレポート*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Top hosts* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*上位ホスト*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Trigger overview* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*トリガーの概要*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *URL* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*URL*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Web monitoring* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### 例 次の例は、*Web監視*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。 #### Examples The ways in which macro functions can be used to customize macro values is illustrated in the following examples on received values: |Received value|Macro|Output| |----|----|----| |`24.3413523`|`{{ITEM.VALUE}.fmtnum(2)}`|`24.34`| |`24.3413523`|`{{ITEM.VALUE}.fmtnum(0)}`|`24`| |`12:36:01`|`{{TIME}.fmttime(%B)}`|`October`| |`12:36:01`|`{{TIME}.fmttime(%d %B,-1M/M)}`|`1 September`| |`123Log line`|`{{ITEM.VALUE}.regsub(^[0-9]+, Problem)}`|`Problem`| |`123 Log line`|`{{ITEM.VALUE}.regsub("^([0-9]+)", "Problem")}`|`Problem`| |`123 Log line`|`{{ITEM.VALUE}.regsub("^([0-9]+)", Problem ID: \1)}`|`Problem ID: 123`| |`Log line`|`{{ITEM.VALUE}.regsub(".*", "Problem ID: \1")}`|''Problem ID: ''| |`MySQL crashed errno 123`|`{{ITEM.VALUE}.regsub("^(\w+).*?([0-9]+)", " Problem ID: \1_\2 ")}`|'' Problem ID: MySQL\_123 ''| |`123 Log line`|`{{ITEM.VALUE}.regsub("([1-9]+", "Problem ID: \1")}`|`*UNKNOWN*` (invalid regular expression)| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \1)}`|`customername`| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \2)}`|`1`| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+", \1)}`|`{{#IFALIAS}.regsub("(.*)_([0-9]+", \1)}` (invalid regular expression)| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \1)}"}`|`{$MACRO:"customername"}`| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \2)}"}`|`{$MACRO:"1"}`| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+\", \1)}"}`|`{$MACRO:"{{#M}.regsub(\"(.*)_([0-9]+\", \1)}"}` (invalid regular expression)| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+)\\", \1)}\"}"`|`"{$MACRO:\"customername\"}"`| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+)\\", \2)}\"}"`|`"{$MACRO:\"1\"}")`| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+\\", \1)}\"}"`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+\\", \1)}\"}")` (invalid regular expression)| ##### Seeing full item values Long values of resolved {ITEM.VALUE} and {ITEM.LASTVALUE} macros are truncated to 20 characters. To see the full values of these macros you may use macro functions, e.g.: `{{ITEM.VALUE}.regsub("(.*)", \1)}`<br> `{{ITEM.LASTVALUE}.regsub("(.*)", \1)}` #### 例 マクロ関数を使用してマクロ値をカスタマイズする方法を、受信値に関する以下の例で説明します: |受信値|マクロ|出力| |----|----|----| |`24.3413523`|`{{ITEM.VALUE}.fmtnum(2)}`|`24.34`| |`24.3413523`|`{{ITEM.VALUE}.fmtnum(0)}`|`24`| |`12:36:01`|`{{TIME}.fmttime(%B)}`|`October`| |`12:36:01`|`{{TIME}.fmttime(%d %B,-1M/M)}`|`1 September`| |`123Log line`|`{{ITEM.VALUE}.regsub(^[0-9]+, Problem)}`|`Problem`| |`123 Log line`|`{{ITEM.VALUE}.regsub("^([0-9]+)", "Problem")}`|`Problem`| |`123 Log line`|`{{ITEM.VALUE}.regsub("^([0-9]+)", Problem ID: \1)}`|`Problem ID: 123`| |`Log line`|`{{ITEM.VALUE}.regsub(".*", "Problem ID: \1")}`|''Problem ID: ''| |`MySQL crashed errno 123`|`{{ITEM.VALUE}.regsub("^(\w+).*?([0-9]+)", " Problem ID: \1_\2 ")}`|'' Problem ID: MySQL\_123 ''| |`123 Log line`|`{{ITEM.VALUE}.regsub("([1-9]+", "Problem ID: \1")}`|`*UNKNOWN*` (invalid regular expression)| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \1)}`|`customername`| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \2)}`|`1`| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+", \1)}`|`{{#IFALIAS}.regsub("(.*)_([0-9]+", \1)}` (invalid regular expression)| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \1)}"}`|`{$MACRO:"customername"}`| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \2)}"}`|`{$MACRO:"1"}`| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+\", \1)}"}`|`{$MACRO:"{{#M}.regsub(\"(.*)_([0-9]+\", \1)}"}` (invalid regular expression)| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+)\\", \1)}\"}"`|`"{$MACRO:\"customername\"}"`| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+)\\", \2)}\"}"`|`"{$MACRO:\"1\"}")`| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+\\", \1)}\"}"`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+\\", \1)}\"}")` (invalid regular expression)| ##### 全アイテム値の表示 {ITEM.VALUE} および {ITEM.LASTVALUE} マクロが解決された時に長い値になる場合は20 文字に切り捨てられます。 これらのマクロの完全な値を表示するには、次のようなマクロ関数を使用します。 `{{ITEM.VALUE}.regsub("(.*)", \1)}`<br> `{{ITEM.LASTVALUE}.regsub("(.*)", \1)}` #### Examples **User macro with context** Regular expression: `\.+\"[a-z]+`<br> User macro with context: `{$MACRO:regex:"\.+\\"[a-z]+"}` Notice: - backslashes are [not escaped](/manual/config/macros/user_macros_context#important-notes); - quotation marks are escaped. **Macro function inside item key parameter** Regular expression: `.+:(\d+)$`<br> Item key: `net.tcp.service[tcp,,"{{ITEM.VALUE}.regsub(\".+:(\d+)$\",\1)}"]` Notice: - regular expression inside the `regsub` macro function is double-quoted (because of contains closing parenthesis); - quotation marks around the regular expression are escaped (because the whole third item parameter is double-quoted); - third item key parameter is double-quoted because it contains a comma. **LLD macro function** Regular expression: `\.+\"([a-z]+)`<br> LLD macro: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}` Notice: - backslashes are not escaped; - quotation marks are escaped. **LLD macro function inside user macro context** Regular expression: `\.+\"([a-z]+)`<br> LLD macro: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> User macro with context: `{$MACRO:"{{#MACRO}.iregsub(\"\.+\\\"([a-z]+)\", \1)}"}` Notice: - backslash escaping for LLD does not change; - upon inserting the LLD macro into user macro context, we need to put it into string: 1. Quotation marks are added around the macro expression; 2. Quotation marks get escaped; in total, 3 new backslashes are introduced. **String parameter of non-history function** String content: `\.+\"[a-z]+`<br> Expression: `concat("abc", "\\.\\\"[a-z]+")` Notice: - String parameters require escaping both for backslashes and quotation marks. **String parameter of history function** String content: `\.+\"[a-z]+`<br> Expression: `find(__ITEM_KEY__,,"regexp","\.+\\"[a-z]+")` Notice: - backslashes are not escaped; - quotation marks are escaped. **LLD macro function inside string parameter of non-history function** Regular expression: `\.+\"([a-z]+)`<br> LLD macro: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> Expression: `concat("abc, "{{#MACRO}.iregsub(\"\\.+\\\\\"([a-z]+)\", \\1)}")` Notice: - String parameters require escaping both for backslashes and quotation marks; - Another layer of escaping is added, because the macro will be resolved only after string is unquoted; **LLD macro function inside string parameter of history function** Regular expression: `\.+\"([a-z]+)`<br> LLD macro: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> Expression: `find(__ITEM_KEY__,,"eq","{{#MACRO}.iregsub(\"\.+\\\"([a-z]+)\", \1)}")` Notice: - backslashes are not escaped; - quotation marks are escaped. **User macro with context inside string parameter of non-history function** Regular expression: `\.+\"[a-z]+`<br> User macro with context: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> Expression: `concat("abc, "{$MACRO:regex:\"\\.+\\\\\"[a-z]+\"}")` Notice: - Same as in the previous example an additional layer of escaping is needed; - Backslashes and quotation marks are escaped only for the top-level escaping (by virtue of it being a string parameter). **User macro with context inside string parameter of history function** Regular expression: `\.+\"[a-z]+`<br> User macro with context: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> Expression: `find(__ITEM_KEY__,,"eq","{$MACRO:regex:\"\.+\\\"[a-z]+\"}")` Notice: - backslashes are not escaped; - quotation marks are escaped. **LLD macro function inside user macro context inside non-history function** Regular expression: `\.+\"([a-z]+)`<br> LLD macro: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> User macro with context: `{$MACRO:"{{#MACRO}.iregsub(\"\.+\\\"([a-z]+)\", \1)}"}`<br> Expression: `concat("abc, "{$MACRO:\"{{#MACRO}.iregsub(\\\"\.+\\\\\\\"([a-z])+\\\", \\1)}\"}")` Notice the three layers of escaping: 1. For LLD macro function, without escaping of backslashes; 2. For User macro with context, without escaping of backslashes; 3. For the string parameter of a function, with escaping of backslashes. **LLD macro function inside user macro context inside history function** Regular expression: `\.+\"([a-z])+`<br> LLD macro: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> User macro with context: `{$MACRO:"{{#MACRO}.iregsub(\"\.+\\\"([a-z]+)\", \1)}"}`<br> Expression: `find(__ITEM_KEY__,,"eq","{$MACRO:\"{{#MACRO}.iregsub(\\"\.+\\\\"([a-z])+\\", \1)}\"}")` Notice: - backslashes are not escaped; - quotation marks are escaped. **User macro with context just inside string** Regular expression: `\.+\"[a-z]+`<br> User macro with context: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> Inside string of some expression, for example: `func(arg1, arg2, arg3)="{$MACRO:regex:\"\\.+\\\\\"[a-z]+\"}"` Notice: - Strings also require backslash escaping; - Strings also require quotation mark escaping; - Again a case with 2 levels of escaping: 1. Escaping for user macro context without backslash escaping; 2. Escaping for it being a string with backslash escaping. #### 例 **コンテキスト付きユーザーマクロ** 正規表現: `\.+\"[a-z]+`<br> コンテキスト付きユーザーマクロ: `{$MACRO:regex:"\.+\\"[a-z]+"}` 注意: - バックスラッシュは[エスケープされません](/manual/config/macros/user_macros_context#important-notes); - 引用符はエスケープされます。 **アイテムキーパラメータ内のマクロ関数** 正規表現: `.+:(\d+)$`<br> アイテムキー: `net.tcp.service[tcp,,"{{ITEM.VALUE}.regsub(\".+:(\d+)$\",\1)}"]` 注意: - `regsub` マクロ関数内の正規表現は二重引用符で囲まれています(閉じ括弧が含まれているため) - 正規表現を囲む引用符はエスケープされます（3番目の項目パラメータ全体が二重引用符で囲まれているため） - 3番目の項目キーパラメータはカンマを含むため二重引用符で囲まれています。 **LLDマクロ関数** 正規表現: `\.+\"([a-z]+)`<br> LLDマクロ: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}` 注意: - バックスラッシュはエスケープされません。 - 引用符はエスケープされます。 **ユーザーマクロコンテキスト内のLLDマクロ関数** 正規表現: `\.+\"([a-z]+)`<br> LLDマクロ: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> コンテキスト付きユーザーマクロ: `{$MACRO:"{{#MACRO}.iregsub(\"\.+\\\"([a-z]+)\", \1)}"}` 注意: - LLDマクロのバックスラッシュエスケープは変更されません。 - LLDマクロをユーザーマクロコンテキストに挿入する際は、以下の文字列にする必要があります。 1. マクロ式の前後に引用符が追加されます。 2. 引用符がエスケープされます。合計で3つの新しいバックスラッシュが導入されます。 **履歴非保持関数の文字列パラメータ** 文字列の内容: `\.+\"[a-z]+`<br> 式: `concat("abc", "\\.\\\"[a-z]+")` 注意: - 文字列パラメータでは、バックスラッシュと引用符の両方をエスケープする必要があります。 **履歴関数の文字列パラメータ** 文字列の内容: `\.+\"[a-z]+`<br> 式: `find(__ITEM_KEY__,,"regexp","\.+\\"[a-z]+")` 注意: - バックスラッシュはエスケープされません。 - 引用符はエスケープされます。 **履歴関数以外の文字列パラメータ内のLLDマクロ関数** 正規表現: `\.+\"([a-z]+)`<br> LLDマクロ: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> 式: `concat("abc, "{{#MACRO}.iregsub(\"\\.+\\\\\"([a-z]+)\", \\1)}")` 注意: - 文字列パラメータでは、バックスラッシュと引用符の両方をエスケープする必要があります。 - マクロは文字列の引用符が解除された後にのみ解決されるため、エスケープ処理がさらに追加されます。 **ヒストリー関数の文字列パラメータ内のLLDマクロ関数** 正規表現: `\.+\"([a-z]+)`<br> LLDマクロ: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> 式: `find(__ITEM_KEY__,,"eq","{{#MACRO}.iregsub(\"\.+\\\"([a-z]+)\", \1)}")` 注意: - バックスラッシュはエスケープされません。 - 引用符はエスケープされます。 **非履歴関数の文字列パラメータ内にコンテキストを持つユーザーマクロ** 正規表現: `\.+\"[a-z]+`<br> コンテキストを持つユーザーマクロ: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> 式: `concat("abc, "{$MACRO:regex:\"\\.+\\\\\"[a-z]+\"}")` 注意: - 前の例と同様に、追加のエスケープ処理が必要です。 - バックスラッシュと引用符は、トップレベルのエスケープ処理でのみエスケープされます。（文字列パラメータであるため） **履歴関数の文字列パラメータ内にコンテキストを持つユーザーマクロ** 正規表現: `\.+\"[a-z]+`<br> コンテキストを持つユーザーマクロ: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> 式: `find(__ITEM_KEY__,,"eq","{$MACRO:regex:\"\.+\\\"[a-z]+\"}")` 注意: - バックスラッシュはエスケープされません。 - 引用符はエスケープされます。 **履歴関数以外の関数内のユーザーマクロコンテキスト内の LLD マクロ関数** 正規表現: `\.+\"([a-z]+)`<br> LLD マクロ: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> コンテキストを持つユーザーマクロ: `{$MACRO:"{{#MACRO}.iregsub(\"\.+\\\"([a-z]+)\", \1)}"}`<br> 式: `concat("abc, "{$MACRO:\"{{#MACRO}.iregsub(\\\"\.+\\\\\\\"([a-z])+\\\", \\1)}\"}")` エスケープの3つのレイヤーに注意してください。 1. LLDマクロ関数の場合バックスラッシュをエスケープしません。 2. コンテキスト付きユーザーマクロの場合バックスラッシュをエスケープしません。 3. 関数の文字列パラメータの場合バックスラッシュをエスケープします。 **履歴関数内のユーザーマクロコンテキスト内のLLDマクロ関数** 正規表現: `\.+\"([a-z])+`<br> LLDマクロ: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> コンテキスト付きユーザーマクロ: `{$MACRO:"{{#MACRO}.iregsub(\"\.+\\\"([a-z]+)\", \1)}"}`<br> 式: `find(__ITEM_KEY__,,"eq","{$MACRO:\"{{#MACRO}.iregsub(\\"\.+\\\\"([a-z])+\\", \1)}\"}")` 注意: - バックスラッシュはエスケープされません。 - 引用符はエスケープされます。 **文字列のすぐ内側にコンテキストがあるユーザーマクロ** 正規表現: `\.+\"[a-z]+`<br> コンテキストがあるユーザーマクロ: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> 何らかの表現の文字列内。例: `func(arg1, arg2, arg3)="{$MACRO:regex:\"\\.+\\\\\"[a-z]+\"}"` 注意: - 文字列ではバックスラッシュによるエスケープも必要です。 - 文字列では引用符によるエスケープも必要です。 - ここでも2段階のエスケープが必要です。 1. ユーザーマクロのコンテキストをエスケープするため、バックスラッシュエスケープは不要です。 2. 文字列であるため、バックスラッシュエスケープは必要です。 #### Examples Working hours. Monday - Friday from 9:00 till 18:00: 1-5,09:00-18:00 Working hours plus weekend. Monday - Friday from 9:00 till 18:00 and Saturday, Sunday from 10:00 till 16:00: 1-5,09:00-18:00;6-7,10:00-16:00 #### 例 営業時間 月～金 9:00～18:00 1-5,09:00-18:00 平日営業時間と週末営業時間 月～金 9:00～18:00 土～日 10:00～16:00 1-5,09:00-18:00; 6-7,10:00-16:00 ## EXAMPLES **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## 例 **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## EXAMPLES **zabbix\_js -s script-file.js -p example** [ ]{#lbAG} ## 例 **zabbix\_js -s script-file.js -p example** [ ]{#lbAG} ## EXAMPLES **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of monitored host. Use monitored host and Zabbix server defined in agent configuration file. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of **Monitored Host** host using Zabbix server defined in agent configuration file. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ Send values from file **data\_values.txt** to Zabbix server with IP **192.168.1.113**. Host names and keys are defined in the file. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ Send a timestamped value from the commandline to Zabbix server, specified in the agent configuration file. Dash in the input data indicates that hostname also should be used from the same configuration file. \ **echo '"Zabbix server" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ Send empty value of an item to the Zabbix server with IP address **192.168.1.113** on port **10000** from the commandline. Empty values must be indicated by empty double quotes. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with certificate. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with pre-shared key (PSK). [ ]{#lbAI} ## 例 **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ 監視対象ホストの**mysql.queries**アイテムの値として**342.45**を送信します。エージェントの設定ファイルで定義された監視対象ホストとZabbixサーバーを使用します。 **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45**\ エージェントの設定ファイルで定義されたZabbixサーバーを使用して**Monitored Host**ホストの**mysql.queries**アイテムの値として**342.45**を送信します。 \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ ファイル**data\_values.txt**から IP **192.168.1.113**の Zabbixサーバーに値を送信します。 ホスト名とキーはファイルで定義されます。 \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ エージェントの設定ファイルで指定されたコマンドラインからZabbixサーバーにタイムスタンプ付きの値を送信します。入力データのダッシュは、ホスト名も同じ設定ファイルから使用する必要があることを示します。 \ **echo '"Zabbix server" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ コマンドラインからIPアドレス**192.168.1.113**のポート**10000**でリッスンしているZabbixサーバーに空のアイテムの値を送信します。空の値は、空の二重引用符で示します。 **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ *Monitored Host**ホスト*の**mysql.queries**アイテムの値として**342.45**を、証明書付きのTLSを使用してIP **192.168.1.113**のサーバーに送信します。 **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ **Monitored Host**ホストの**mysql.queries**アイテムの値として**342.45**をIP **192.168.1.113**のサーバーに、TLSと事前共有キー(PSK)を使用して送信します。 [ ]{#lbAI} ##### Example with an inline regex modifier Use of the following regular expression including an inline modifier (?i) to match the characters "error": (?i)error  Chosen *Expression type*: "Result is TRUE". Characters "error" are matched. ##### インライン型正規表現修飾子を含む例 インラインモディファイアを含む次の正規表現を使用します。 <br> (?i) を使用して、"error" という文字にマッチさせます。 <br> (?i)error  選択された*Expression type* : "結果はTRUE "です。文字 "error "にマッチする。 ### Example workflow The following section will walk you through some usage examples in more detail. ### ワークフローの例 次のセクションでは、いくつかの使用例をより詳細に説明します。 #### Execution steps :::noteclassic By default, all scripts in Zabbix are executed using the *sh* shell, and it is not possible to modify the default shell. To utilize a different shell, you can employ a workaround: create a script file and invoke that script during command execution. ::: The command/script is executed similarly on both Unix and Windows platforms: 1. Zabbix (the parent process) creates a pipe for communication 2. Zabbix sets the pipe as the output for the to-be-created child process 3. Zabbix creates the child process (runs the command/script) 4. A new process group (in Unix) or a job (in Windows) is created for the child process 5. Zabbix reads from the pipe until timeout occurs or no one is writing to the other end (ALL handles/file descriptors have been closed). Note that the child process can create more processes and exit before they exit or close the handle/file descriptor. 6. If the timeout has not been reached, Zabbix waits until the initial child process exits or timeout occurs 7. If the initial child process exited and the timeout has not been reached, Zabbix checks exit code of the initial child process and compares it to 0 (non-zero value is considered as execution failure, only for custom alert scripts, remote commands and user scripts executed on Zabbix server and Zabbix proxy) 8. At this point it is assumed that everything is done and the whole process tree (i.e. the process group or the job) is terminated ::: noteimportant Zabbix assumes that a command/script has done processing when the initial child process has exited AND no other process is still keeping the output handle/file descriptor open. When processing is done, ALL created processes are terminated. ::: All double quotes and backslashes in the command are escaped with backslashes and the command is enclosed in double quotes. #### 実行手順 コマンド/スクリプトは、UnixプラットフォームとWindowsプラットフォームの両方で同様に実行されます。 1. Zabbix（親プロセス）は通信用のパイプを作成します。 2. Zabbixは作成される子プロセスの出力としてパイプを設定します。 3. Zabbixは子プロセスを作成します（コマンド/スクリプトを実行します）。 4. 子プロセス用に新しいプロセスグループ（Unixの場合）またはジョブ（Windowsの場合）が作成されます。 5. Zabbixはタイムアウトが発生するか、誰も書き込みを行わなくなる（すべてのハンドル/ファイル記述子が閉じられる）までパイプから読み取ります。子プロセスは、ハンドル/ファイル記述子を終了または閉じる前に、さらに多くのプロセスを作成して終了できることに注意してください。 6. タイムアウトしていない場合、Zabbixは最初の子プロセスが終了するかタイムアウトが発生するまで待機します。 7. 最初の子プロセスが終了し、タイムアウトに達していない場合、Zabbixは最初の子プロセスの終了コードをチェックして0と比較します。（ゼロ以外の値は、ZabbixサーバーおよびZabbixプロキシで実行されるカスタムアラートスクリプト、リモートコマンド、およびユーザースクリプトの場合のみ、実行の失敗と見なされます） 8. この時点で、すべてが完了し、プロセスツリー全体（つまり、プロセスグループまたはジョブ）が終了したと見なされます。 ::: noteimportant Zabbixは、最初の子プロセスが終了したときにコマンド/スクリプトが処理を完了し、他のプロセスが出力ハンドル/ファイル記述子を開いたままにしていないことを前提としています。処理が完了すると、作成されたすべてのプロセスが終了します。 ::: コマンド内のすべての二重引用符とバックスラッシュはバックスラッシュでエスケープされ、コマンドは二重引用符で囲まれます。 #### Exit code Before version 2.2 Zabbix agent returned 0 in case of successful exit and 255 in case of failure. Starting from version 2.2 and higher Zabbix agent returns 0 in case of successful exit and 1 in case of failure. #### 終了コード バージョン2.2より前のZabbixエージェントは、正常に終了した場合に0を、失敗した場合は255を返します。バージョン2.2以降のZabbixエージェントは、正常に終了した場合は0を、失敗した場合は1を返します。 #### Exit code checking Exit code are checked with the following conditions: - Only for custom alert scripts, remote commands and user scripts executed on Zabbix server and Zabbix proxy. - Any exit code that is different from 0 is considered as execution failure. - Contents of standard error and standard output for failed executions are collected and available in frontend (where execution result is displayed). - Additional log entry may be created for remote commands executed on Zabbix agent/proxy by enabling the LogRemoteCommands parameter on [agent](/manual/appendix/config/zabbix_agentd)/[proxy](/manual/appendix/config/zabbix_proxy). Possible frontend messages and log entries for failed commands/scripts: - Contents of standard error and standard output for failed executions (if any). - "Process exited with code: N." (for empty output, and exit code not equal to 0). - "Process killed by signal: N." (for process terminated by a signal, on Linux only). - "Process terminated unexpectedly." (for process terminated for unknown reasons). #### 終了コードのチェック 終了コードは以下の条件のときにチェック可能: - ZabbixサーバーとZabbixプロキシで実行されるカスタムアラートスクリプト、リモートコマンド、ユーザースクリプトの場合 - 0以外の終了コードは、実行失敗と見なされます - 失敗した実行の標準エラーと標準出力の内容が収集され、フロントエンド (実行結果が表示される場所) で使用できます。 - エージェント/プロキシで LogRemoteCommands[パラメータ](/manual/appendix/config/zabbix_agentd)を有効にすると、Zabbix エージェント/プロキシで実行されるリモートコマンドメッセージをログに出力できます。 失敗したコマンド/スクリプトのフロントエンド メッセージとログ出力の例: - 失敗した実行の標準エラーと標準出力の内容が存在する場合 - "Process exited with code: N." （空の出力、および0に等しくない終了コードの場合） - "Process killed by signal: N."（シグナルによって終了するプロセスの場合。Linuxのみ。） - "Process terminated unexpectedly." （不明な理由でプロセスが終了したため） #### Exit codes Starting from version 4.4.8 Zabbix agent 2 can also be compiled with older OpenSSL versions (1.0.1, 1.0.2). In this case Zabbix provides mutexes for locking in OpenSSL. If a mutex lock or unlock fails then an error message is printed to the standard error stream (STDERR) and Agent 2 exits with return code 2 or 3, respectively. #### 終了コード バージョン4.4.8以降、Zabbixエージェント2は古いOpenSSLバージョン(1.0.1、1.0.2)でコンパイルすることもできます。 この場合、ZabbixはOpenSSLでロックするためのミューテックスを提供します。ミューテックスのロックまたはロック解除が失敗した場合、エラーメッセージが標準エラーストリーム(STDERR)に出力され、エージェント2はそれぞれリターンコード2または3で終了します。 ## EXIT STATUS The exit status is 0 if the values were sent and all of them were successfully processed by server. If data was sent, but processing of at least one of the values failed, the exit status is 2. If data sending failed, the exit status is 1. [ ]{#lbAH} ## 終了ステータス 値が送信され、それらすべてがサーバーによって正常に処理された時の終了ステータスは0です。データが送信されたが、少なくとも1つの値の処理が失敗した時の終了ステータスは2です。データ送信が失敗した時の終了ステータスは1です。 [ ]{#lbAH} ### Expandable lists in latest data subfilter Expandable lists have been introduced in the [latest data](/manual/web_interface/frontend_sections/monitoring/latest_data) subfilter: - For each entity group (e.g. tags, hosts) up to 10 rows of entities are now displayed. If there are more entities, this list can be expanded to a maximum of 1000 entries (the value of SUBFILTER_VALUES_PER_GROUP in [frontend definitions](/manual/web_interface/definitions)) by clicking on a three-dot icon displayed at the end. Previously a non-expandable maximum of 100 entries was the limit. - In the list of *Tag values* up to 10 rows of tag names are now displayed. If there are more tag names with values, this list can be expanded to a maximum of 200 tag names by clicking on a three-dot icon displayed at the bottom. Previously, a non-expandable maximum of 20 rows with tag names was the limit. For each tag name up to 10 rows of values are displayed (expandable to 1000 entries (the value of SUBFILTER_VALUES_PER_GROUP in [frontend definitions](/manual/web_interface/definitions))). ### 最新データサブフィルターの拡張可能なリスト [最新データ](/manual/web_interface/frontend_sections/monitoring/latest_data)のサブフィルターで、拡張可能なリストが導入されました。 - 各エンティティグループ (例: タグ、ホスト) について、最大 10 行のエンティティが表示されるようになりました。 <br> それ以上のエンティティがある場合、このリストは最大1000エントリまで拡張できます。 <br> ([Webインターフェースの定義](/manual/web_interface/definitions) にある SUBFILTER_VALUES_PER_GROUP の値)を、 <br> 末尾に表示される3つの点のアイコンをクリックすることで設定できます。以前は、拡張不可能な最大100項目が制限されていました。 - *タグの値*のリストで、タグ名が最大10行まで表示されるようになりました。 <br> より多くのタグ名と値がある場合、このリストは、下部に表示される3つの点のアイコンをクリックすることで <br> 最大200件まで拡張することができます。従来は、拡張できない最大20行のタグ名が限界でした。 各タグ名に対して、最大10行の値が表示されます（[Webインターフェースの定義](/manual/web_interface/definitions)のSUBFILTER_VALUES_PER_GROUPの値で最大1000件まで拡張可能） #### Expired signing key for RHEL packages When upgrading Zabbix on [Red Hat Enterprise Linux](/manual/installation/upgrade/packages/rhel#update-repository-configuration-package), you may encounter an expired signing key issue for packages on [Zabbix repository](https://repo.zabbix.com/zabbix/6.0/). When a signing key expires, attempts to verify package signatures will result in an error indicating that the certificate or key is no longer valid. For example: ```bash error: Verifying a signature using certificate D9AA84C2B617479C6E4FCF4D19F2475308EFA7DD (Zabbix LLC (Jul 2022) <packager@zabbix.com>): 1. Certificate 19F2475308EFA7DD invalid: certificate is not alive because: The primary key is not live because: Expired on 2024-07-04T11:41:23Z 2. Key 19F2475308EFA7DD invalid: key is not alive because: The primary key is not live because: Expired on 2024-07-04T11:41:23Z ``` To resolve such issues, manually reinstall the latest `zabbix-release` package for your specific variant of RHEL (replace the link below with the correct one from [Zabbix repository](https://repo.zabbix.com/zabbix/6.0/)). For example, on **RHEL 9**, run: ```bash rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm ``` Then, update the repository information: ```bash dnf update ``` For more information, see [ZBX-24761](https://support.zabbix.com/browse/ZBX-24761). #### RHELパッケージの署名キーの期限切れ [Red Hat Enterprise Linux](/manual/installation/upgrade/packages/rhel#リポジトリ構成パッケージ更新)でZabbixをアップグレードする場合、[Zabbixリポジトリ](https://repo.zabbix.com/zabbix/6.0/)のパッケージの署名キーの期限切れの問題が発生することがあります。署名キーの期限が切れると、パッケージ署名の検証を試みると、証明書またはキーが無効になったことを示すエラーが発生します。例: ```bash error: Verifying a signature using certificate D9AA84C2B617479C6E4FCF4D19F2475308EFA7DD (Zabbix LLC (Jul 2022) <packager@zabbix.com>): 1. Certificate 19F2475308EFA7DD invalid: certificate is not alive because: The primary key is not live because: Expired on 2024-07-04T11:41:23Z 2. Key 19F2475308EFA7DD invalid: key is not alive because: The primary key is not live because: Expired on 2024-07-04T11:41:23Z ``` このような問題を解決するには、RHELの特定のバリアントの最新の`zabbix-release`パッケージを手動で再インストールします (以下のリンクを[Zabbixリポジトリ](https://repo.zabbix.com/zabbix/6.0/)の正しいリンクに置き換えます)。 たとえば、**RHEL 9**では次を実行します: ```bash rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm ``` 次に、リポジトリ情報を更新します: ```bash dnf update ``` 詳細については、[ZBX-24761](https://support.zabbix.com/browse/ZBX-24761)を参照してください。 #### Export and import Export and import Zabbix configuration data for configuration backups, migration or large-scale configuration updates. [Configuration API](/manual/api/reference/configuration) #### エクスポートとインポート 設定のバックアップ、マイグレーション、大規模な設定更新のためにZabbixの設定データをエクスポート、インポートすることができます。 [Configuration API](/manual/api/reference/configuration) ##### Export format Data can be exported using the Zabbix web frontend or [Zabbix API](/manual/api/reference/configuration). Supported export formats are YAML, XML and JSON. ##### エクスポート形式 ZabbixのWebインターフェースまたは[Zabbix API](/manual/api/reference/configuration)を使用してデータをエクスポートすることができます。 <br> サポートされているエクスポート形式は YAML、XML、JSONです。 #### Export format Export format in YAML: ``` {.yaml} zabbix_export: version: '6.0' date: '2021-08-31T12:40:55Z' groups: - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6 name: Templates/Applications templates: - uuid: 56079badd056419383cc26e6a4fcc7e0 template: VMware name: VMware description: | You can discuss this template or leave feedback on our forum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/ Template tooling version used: 0.38 templates: - name: 'VMware macros' groups: - name: Templates/Applications items: - uuid: 5ce209f4d94f460488a74a92a52d92b1 name: 'VMware: Event log' type: SIMPLE key: 'vmware.eventlog[{$VMWARE.URL},skip]' history: 7d trends: '0' value_type: LOG username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Collect VMware event log. See also: https://www.zabbix.com/documentation/6.0/manual/config/items/preprocessing/examples#filtering_vmware_event_log_records' tags: - tag: Application value: VMware - uuid: ee2edadb8ce943ef81d25dbbba8667a4 name: 'VMware: Full name' type: SIMPLE key: 'vmware.fullname[{$VMWARE.URL}]' delay: 1h history: 7d trends: '0' value_type: CHAR username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware service full name.' preprocessing: - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 1d tags: - tag: Application value: VMware - uuid: a0ec9145f2234fbea79a28c57ebdb44d name: 'VMware: Version' type: SIMPLE key: 'vmware.version[{$VMWARE.URL}]' delay: 1h history: 7d trends: '0' value_type: CHAR username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware service version.' preprocessing: - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 1d tags: - tag: Application value: VMware discovery_rules: - uuid: 16ffc933cce74cf28a6edf306aa99782 name: 'Discover VMware clusters' type: SIMPLE key: 'vmware.cluster.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Discovery of clusters' item_prototypes: - uuid: 46111f91dd564a459dbc1d396e2e6c76 name: 'VMware: Status of "{#CLUSTER.NAME}" cluster' type: SIMPLE key: 'vmware.cluster.status[{$VMWARE.URL},{#CLUSTER.NAME}]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware cluster status.' valuemap: name: 'VMware status' tags: - tag: Application value: VMware - uuid: 8fb6a45cbe074b0cb6df53758e2c6623 name: 'Discover VMware datastores' type: SIMPLE key: 'vmware.datastore.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' item_prototypes: - uuid: 4b61838ba4c34e709b25081ae5b059b5 name: 'VMware: Average read latency of the datastore {#DATASTORE}' type: SIMPLE key: 'vmware.datastore.read[{$VMWARE.URL},{#DATASTORE},latency]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Amount of time for a read operation from the datastore (milliseconds).' tags: - tag: Application value: VMware - uuid: 5355c401dc244bc588ccd18767577c93 name: 'VMware: Free space on datastore {#DATASTORE} (percentage)' type: SIMPLE key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE},pfree]' delay: 5m history: 7d value_type: FLOAT units: '%' username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware datastore space in percentage from total.' tags: - tag: Application value: VMware - uuid: 84f13c4fde2d4a17baaf0c8c1eb4f2c0 name: 'VMware: Total size of datastore {#DATASTORE}' type: SIMPLE key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE}]' delay: 5m history: 7d units: B username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware datastore space in bytes.' tags: - tag: Application value: VMware - uuid: 540cd0fbc56c4b8ea19f2ff5839ce00d name: 'VMware: Average write latency of the datastore {#DATASTORE}' type: SIMPLE key: 'vmware.datastore.write[{$VMWARE.URL},{#DATASTORE},latency]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Amount of time for a write operation to the datastore (milliseconds).' tags: - tag: Application value: VMware - uuid: a5bc075e89f248e7b411d8f960897a08 name: 'Discover VMware hypervisors' type: SIMPLE key: 'vmware.hv.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Discovery of hypervisors.' host_prototypes: - uuid: 051a1469d4d045cbbf818fcc843a352e host: '{#HV.UUID}' name: '{#HV.NAME}' group_links: - group: name: Templates/Applications group_prototypes: - name: '{#CLUSTER.NAME}' - name: '{#DATACENTER.NAME}' templates: - name: 'VMware Hypervisor' macros: - macro: '{$VMWARE.HV.UUID}' value: '{#HV.UUID}' description: 'UUID of hypervisor.' custom_interfaces: 'YES' interfaces: - ip: '{#HV.IP}' - uuid: 9fd559f4e88c4677a1b874634dd686f5 name: 'Discover VMware VMs' type: SIMPLE key: 'vmware.vm.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Discovery of guest virtual machines.' host_prototypes: - uuid: 23b9ae9d6f33414880db1cb107115810 host: '{#VM.UUID}' name: '{#VM.NAME}' group_links: - group: name: Templates/Applications group_prototypes: - name: '{#CLUSTER.NAME} (vm)' - name: '{#DATACENTER.NAME}/{#VM.FOLDER} (vm)' - name: '{#HV.NAME}' templates: - name: 'VMware Guest' macros: - macro: '{$VMWARE.VM.UUID}' value: '{#VM.UUID}' description: 'UUID of guest virtual machine.' custom_interfaces: 'YES' interfaces: - ip: '{#VM.IP}' valuemaps: - uuid: 3c59c22905054d42ac4ee8b72fe5f270 name: 'VMware status' mappings: - value: '0' newvalue: gray - value: '1' newvalue: green - value: '2' newvalue: yellow - value: '3' newvalue: red ``` #### エクスポートフォーマット YAMLでのエクスポートフォーマット: ``` {.yaml} zabbix_export: version: '6.0' date: '2021-08-31T12:40:55Z' groups: - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6 name: Templates/Applications templates: - uuid: 56079badd056419383cc26e6a4fcc7e0 template: VMware name: VMware description: | You can discuss this template or leave feedback on our forum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/ Template tooling version used: 0.38 templates: - name: 'VMware macros' groups: - name: Templates/Applications items: - uuid: 5ce209f4d94f460488a74a92a52d92b1 name: 'VMware: Event log' type: SIMPLE key: 'vmware.eventlog[{$VMWARE.URL},skip]' history: 7d trends: '0' value_type: LOG username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Collect VMware event log. See also: https://www.zabbix.com/documentation/6.0/manual/config/items/preprocessing/examples#filtering_vmware_event_log_records' tags: - tag: Application value: VMware - uuid: ee2edadb8ce943ef81d25dbbba8667a4 name: 'VMware: Full name' type: SIMPLE key: 'vmware.fullname[{$VMWARE.URL}]' delay: 1h history: 7d trends: '0' value_type: CHAR username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware service full name.' preprocessing: - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 1d tags: - tag: Application value: VMware - uuid: a0ec9145f2234fbea79a28c57ebdb44d name: 'VMware: Version' type: SIMPLE key: 'vmware.version[{$VMWARE.URL}]' delay: 1h history: 7d trends: '0' value_type: CHAR username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware service version.' preprocessing: - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 1d tags: - tag: Application value: VMware discovery_rules: - uuid: 16ffc933cce74cf28a6edf306aa99782 name: 'Discover VMware clusters' type: SIMPLE key: 'vmware.cluster.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Discovery of clusters' item_prototypes: - uuid: 46111f91dd564a459dbc1d396e2e6c76 name: 'VMware: Status of "{#CLUSTER.NAME}" cluster' type: SIMPLE key: 'vmware.cluster.status[{$VMWARE.URL},{#CLUSTER.NAME}]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware cluster status.' valuemap: name: 'VMware status' tags: - tag: Application value: VMware - uuid: 8fb6a45cbe074b0cb6df53758e2c6623 name: 'Discover VMware datastores' type: SIMPLE key: 'vmware.datastore.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' item_prototypes: - uuid: 4b61838ba4c34e709b25081ae5b059b5 name: 'VMware: Average read latency of the datastore {#DATASTORE}' type: SIMPLE key: 'vmware.datastore.read[{$VMWARE.URL},{#DATASTORE},latency]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Amount of time for a read operation from the datastore (milliseconds).' tags: - tag: Application value: VMware - uuid: 5355c401dc244bc588ccd18767577c93 name: 'VMware: Free space on datastore {#DATASTORE} (percentage)' type: SIMPLE key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE},pfree]' delay: 5m history: 7d value_type: FLOAT units: '%' username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware datastore space in percentage from total.' tags: - tag: Application value: VMware - uuid: 84f13c4fde2d4a17baaf0c8c1eb4f2c0 name: 'VMware: Total size of datastore {#DATASTORE}' type: SIMPLE key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE}]' delay: 5m history: 7d units: B username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'VMware datastore space in bytes.' tags: - tag: Application value: VMware - uuid: 540cd0fbc56c4b8ea19f2ff5839ce00d name: 'VMware: Average write latency of the datastore {#DATASTORE}' type: SIMPLE key: 'vmware.datastore.write[{$VMWARE.URL},{#DATASTORE},latency]' history: 7d username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Amount of time for a write operation to the datastore (milliseconds).' tags: - tag: Application value: VMware - uuid: a5bc075e89f248e7b411d8f960897a08 name: 'Discover VMware hypervisors' type: SIMPLE key: 'vmware.hv.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Discovery of hypervisors.' host_prototypes: - uuid: 051a1469d4d045cbbf818fcc843a352e host: '{#HV.UUID}' name: '{#HV.NAME}' group_links: - group: name: Templates/Applications group_prototypes: - name: '{#CLUSTER.NAME}' - name: '{#DATACENTER.NAME}' templates: - name: 'VMware Hypervisor' macros: - macro: '{$VMWARE.HV.UUID}' value: '{#HV.UUID}' description: 'UUID of hypervisor.' custom_interfaces: 'YES' interfaces: - ip: '{#HV.IP}' - uuid: 9fd559f4e88c4677a1b874634dd686f5 name: 'Discover VMware VMs' type: SIMPLE key: 'vmware.vm.discovery[{$VMWARE.URL}]' delay: 1h username: '{$VMWARE.USERNAME}' password: '{$VMWARE.PASSWORD}' description: 'Discovery of guest virtual machines.' host_prototypes: - uuid: 23b9ae9d6f33414880db1cb107115810 host: '{#VM.UUID}' name: '{#VM.NAME}' group_links: - group: name: Templates/Applications group_prototypes: - name: '{#CLUSTER.NAME} (vm)' - name: '{#DATACENTER.NAME}/{#VM.FOLDER} (vm)' - name: '{#HV.NAME}' templates: - name: 'VMware Guest' macros: - macro: '{$VMWARE.VM.UUID}' value: '{#VM.UUID}' description: 'UUID of guest virtual machine.' custom_interfaces: 'YES' interfaces: - ip: '{#VM.IP}' valuemaps: - uuid: 3c59c22905054d42ac4ee8b72fe5f270 name: 'VMware status' mappings: - value: '0' newvalue: gray - value: '1' newvalue: green - value: '2' newvalue: yellow - value: '3' newvalue: red ``` ##### Export format ``` {.yaml} groups: - name: 'Zabbix servers' ``` ##### エクスポート形式 ``` {.yaml} groups: - name: 'Zabbix servers' ``` #### Exporting a template Export the configuration of template "10571" as an XML string. Request: ```json { "jsonrpc": "2.0", "method": "configuration.export", "params": { "options": { "templates": [ "10571" ] }, "format": "xml" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.0</version><date>2023-01-01T12:00:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;/dt&gt;</parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>CPU load</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)&gt;2</expression><name>CPU load too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n", "id": 1 } ``` #### テンプレートのエクスポート テンプレート"10571"の構成をXML文字列としてエクスポートします。 リクエスト: ```json { "jsonrpc": "2.0", "method": "configuration.export", "params": { "options": { "templates": [ "10571" ] }, "format": "xml" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.0</version><date>2023-01-01T12:00:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter><dt>Server uptime: (.*)</dt></parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>CPU load</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)>2</expression><name>CPU load too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n", "id": 1 } ``` #### Exporting To export hosts, do the following: - Go to: *Configuration* → *Hosts* - Mark the checkboxes of the hosts to export - Click on *Export* below the list  Depending on the selected format, hosts are exported to a local file with a default name: - *zabbix\_export\_hosts.yaml* - in YAML export (default option for export) - *zabbix\_export\_hosts.xml* - in XML export - *zabbix\_export\_hosts.json* - in JSON export #### export ホストの export を行うには、以下のようにします。 - *Configuration* → *Hosts* に移動します。 - export するホストのチェックボックスにマークを付けます。 - リストの下にある *Export* をクリックします。 選択した形式に応じて、ホストはローカルにデフォルト名のファイルとして export されます。 - *zabbix\_export\_hosts.yaml* - YAML export の場合(export のデフォルトオプション) - *zabbix_export_hosts.xml* - XML export の場合 - *zabbix_export_hosts.json* - JSON 形式で export する場合 #### Exporting To export media types, do the following: - Go to: *Administration* → *Media types* - Mark the checkboxes of the media types to export - Click on *Export* below the list  Depending on the selected format, media types are exported to a local file with a default name: - *zabbix\_export\_mediatypes.yaml* - in YAML export (default option for export) - *zabbix\_export\_mediatypes.xml* - in XML export - *zabbix\_export\_mediatypes.json* - in JSON export #### エクスポート メディアタイプをエクスポートするには、次のようにします。 - *管理* → *メディアタイプ* に移動します。 - エクスポートするメディアタイプのチェックボックスにマークを付けます。 - リストの下にある*エクスポート*をクリックします。  選択された形式に応じて、メディアタイプはローカルファイルにデフォルトの名前でエクスポートされます。 - *zabbix\_export\_mediatypes.yaml* - YAML形式の場合 (export の default option) - *zabbix\_export\_mediatypes.xml* - XML形式の場合 - *zabbix\_export\_mediatypes.json* - JSON形式の場合 #### Exporting To export network maps, do the following: - Go to: *Monitoring* → *Maps* - Mark the checkboxes of the network maps to export - Click on *Export* below the list  Depending on the selected format, maps are exported to a local file with a default name: - *zabbix\_export\_maps.yaml* - in YAML export (default option for export) - *zabbix\_export\_maps.xml* - in XML export - *zabbix\_export\_maps.json* - in JSON export #### export ネットワークマップを export するには、次の操作を行います。 - *Monitoring* → *Maps* に移動します。 - export するネットワークマップのチェックボックスにマークを付けます。 - リストの下にある*Export*をクリックします。  選択した形式に応じて、マップは次のようなローカルファイルにデフォルト名でエクスポートされます。 - *zabbix\_export\_maps.yaml* - YAML export の場合 (export の default option) - *zabbix\_export\_maps.xml* - XML export の場合 - *zabbix\_export\_maps.json* - JSON export の場合 #### Exporting To export templates, do the following: - Go to: *Configuration* → *Templates* - Mark the checkboxes of the templates to export - Click on *Export* below the list  Depending on the selected format, templates are exported to a local file with a default name: - *zabbix\_export\_templates.yaml* - in YAML export (default option for export) - *zabbix\_export\_templates.xml* - in XML export - *zabbix\_export\_templates.json* - in JSON export #### エクスポート テンプレートをエクスポートするには、次の操作を行います。 - *設定* → *テンプレート* - エクスポートするテンプレートのチェックボックスにマークを付けます。 - リストの下にある*エクスポート*をクリックします。  選択した形式に応じて、テンプレートはローカルにデフォルトファイル名でエクスポートされます。 - *zabbix\_export\_templates.yaml* - YAML エクスポートの場合(エクスポートのデフォルトオプション) - *zabbix\_export\_templates.xml* - XML エクスポートの場合 - *zabbix\_export\_templates.json* - JSON エクスポートの場合 ###### Export request A request to execute the Export function of the Exporter interface. | | | |---|---| |direction|agent → plugin| |response|no| Parameters specific to export requests: |Name|Type|Comments| |---------|--------|----------| |key|string|The plugin key.| |parameters|array of strings (optional)|The parameters for Export function.| *Example:* {"id":4,"type":6,"key":"test.key","parameters":["foo","bar"]} ###### エクスポートリクエスト エクスポーターインターフェースのエクスポート機能を実行するためのリクエスト | | | |---|---| |direction|agent → plugin| |response|no| エクスポートリクエスト固有のパラメーター: |Name|Type|Comments| |---------|---------|----------| |key|string|プラグインキー| |parameters|文字列の配列（オプション）|エクスポート機能のパラメーター| *例:* {"id":4,"type":6,"key":"test.key","parameters":["foo","bar"]} ###### Export response Response from the Export function of the Exporter interface. | | | |---|---| |direction|plugin → agent| |response|n/a| Parameters specific to export responses: |Name|Type|Comments| |---------|--------|----------| |value|string (optional) |Response value from the Export function. Absent, if error is returned.| |error|string (optional) |Error message if the Export function has not been executed successfully. Absent, if value is returned.| *Examples:* {"id":5,"type":7,"value":"response"} or {"id":5,"type":7,"error":"error message"} ###### エクスポートレスポンス エクスポーターインターフェースのエクスポート機能からのレスポンス | | | |---|---| |direction|plugin → agent| |response|n/a| エクスポートレスポンス固有のパラメーター: |Name|Type|Comments| |---------|--------|----------| |value|文字列 (オプション) |エクスポート機能からのレスポンス値。エラーが返された場合は省略されます。| |error|文字列 (オプション) |エクスポート機能が正常に実行されなかった場合のエラーメッセージ。値が返された場合は省略されます。| *例:* {"id":5,"type":7,"value":"response"} または {"id":5,"type":7,"error":"error message"} #### Exposed metrics The stats items gather the statistics in bulk and return a JSON, which is the basis for dependent items to get their data from. The following [internal metrics](/manual/config/items/itemtypes/internal) are returned by either of the two items: - `zabbix[boottime]` - `zabbix[hosts]` - `zabbix[items]` - `zabbix[items_unsupported]` - `zabbix[preprocessing_queue]` (server only) - `zabbix[process,<type>,<mode>,<state>]` (only process type based statistics) - `zabbix[rcache,<cache>,<mode>]` - `zabbix[requiredperformance]` - `zabbix[triggers]` (server only) - `zabbix[uptime]` - `zabbix[vcache,buffer,<mode>]` (server only) - `zabbix[vcache,cache,<parameter>]` - `zabbix[version]` - `zabbix[vmware,buffer,<mode>]` - `zabbix[wcache,<cache>,<mode>]` ('trends' cache type server only) #### 公開メトリック 統計アイテムは統計をまとめて収集し、JSONを返します。これは依存アイテムがデータを取得するための基礎となります。 次の[内部メトリック](/manual/config/items/itemtypes/internal)は、2つのアイテムのいずれかによって返されます。 - `zabbix[boottime]` - `zabbix[hosts]` - `zabbix[items]` - `zabbix[items_unsupported]` - `zabbix[preprocessing_queue]` (server only) - `zabbix[process,<type>,<mode>,<state>]` (only process type based statistics) - `zabbix[rcache,<cache>,<mode>]` - `zabbix[requiredperformance]` - `zabbix[triggers]` (server only) - `zabbix[uptime]` - `zabbix[vcache,buffer,<mode>]` (server only) - `zabbix[vcache,cache,<parameter>]` - `zabbix[version]` - `zabbix[vmware,buffer,<mode>]` - `zabbix[wcache,<cache>,<mode>]` ('trends' cache type server only) ### Expression macros {ITEM.KEY<1-9>} macros are now supported inside [expression macros](/manual/config/macros/expression_macros). ### 式マクロ {ITEM.KEY<1-9>}マクロが[式マクロ](/manual/config/macros/expression_macros)でサポートされるようになりました。 ### ExpressMS messenger webhook API changed API version changed to v4 in ExpressMS messenger webhook. ### ExpressMS messenger webhookのAPIの変更 ExpressMS messenger webhookのAPI バージョンがv4に変更されました。 #### Extended monitoring Sometimes it is necessary to log received HTML page content. This is especially useful if some web scenario step fails. Debug level 5 (trace) serves that purpose. This level can be set in [server](/manual/appendix/config/zabbix_server) and [proxy](/manual/appendix/config/zabbix_proxy) configuration files or using a runtime control option (`-R log_level_increase="http poller,N"`, where N is the process number). The following examples demonstrate how extended monitoring can be started provided debug level 4 is already set: # Increase log level of all http pollers: zabbix_server -R log_level_increase="http poller" # Increase log level of second http poller: zabbix_server -R log_level_increase="http poller,2" If extended web monitoring is not required it can be stopped using the `-R log_level_decrease` option. #### 拡張モニタリング 受信したHTMLページのコンテンツをログに記録する必要がある場合があります。 これは一部のWebシナリオステップが失敗した場合に特に役立ちます。 デバッグレベル5（trace）で確認することができます。 [サーバー](/manual/appendix/config/zabbix_server)および[プロキシ](/manual/appendix/config/zabbix_proxy)の設定ファイルで設定するか、ランタイム制御オプション（`-R log_level_increase="http poller,N"` Nはプロセス番号）を使用して設定できます。次の例は、デバッグレベル4がすでに設定されている場合に、拡張モニタリングを開始する方法です。 すべてのhttp pollersのログレベルを上げます。 shell> zabbix_server -R log_level_increase="http poller" 2番目のhttp pollersのログレベルを上げます。 shell> zabbix_server -R log_level_increase="http poller,2" 拡張Webモニタリングが必要ない場合は`-R log_level_decrease`オプションを使用して停止できます。 #### Extended SNMP gateway functionality SNMP gateway can now provide information about triggers in a problem state and reveal host information in trigger details. Additionally, it is now possible to limit the rate of SNMP traps sent by SNMP gateway. The list of supported OIDs has been extended with a new OID **.10** for a comma-delimited list of trigger hostnames. New parameters have been added to the SNMP gateway configuration file: - *ProblemBaseOID* - OID of the problem trigger table; - *ProblemMinSeverity* - minimum severity, triggers having lower severity will not be included; - *ProblemHideAck* - if specified, only triggers with unacknowledged problems will be included; - *ProblemTagFilter* - if specified, only triggers with the specified tag name will be included; - *TrapTimer* - if set, Zabbix will send no more than one trap of the highest severity in the given time frame. For details, see [Zabbix SNMP Gateway](https://git.zabbix.com/projects/ZT/repos/snmp-gateway/browse/README.md). #### SNMPゲートウェイの機能拡張 SNMPゲートウェイが障害状態にあるトリガーに関する情報を提供し、トリガーの詳細でホスト情報を明らかにすることができるようになりました。 さらに、SNMPゲートウェイから送信されるSNMPトラップのレートを制限できるようになりました。 サポートされるOIDのリストは、トリガーホスト名のカンマ区切りのリスト用の新しいOID **.10**で拡張されました。 SNMPゲートウェイ設定ファイルに新しいパラメーターが追加されました: - *ProblemBaseOID* - 障害トリガーテーブルのOID; - *ProblemMinSeverity* - 最小の深刻度、それより低い深刻度のトリガーは含まれません; - *ProblemHideAck* - 指定した場合、未確認の障害があるトリガーのみが含まれます; - *ProblemTagFilter* - 指定した場合、指定したタグ名を持つトリガーのみが含まれます; - *TrapTimer* - 設定されている場合、Zabbix は指定された時間内に深刻度が最も高いトラップを1つしか送信しません。 詳細は[Zabbix SNMP Gateway](https://git.zabbix.com/projects/ZT/repos/snmp-gateway/browse/README.md) を参照してください。 #### External check result The return value of an external check is a standard output together with a standard error produced by the check. ::: noteimportant An item that returns text (character, log, or text type of information) will not become unsupported in case of a standard error output. ::: The return value is limited to 16MB (including trailing whitespace that is truncated); [database limits](/manual/config/items/item#text_data_limits) also apply. If the requested script is not found or Zabbix server/proxy has no permissions to execute it, the item will become unsupported and a corresponding error message will be displayed. In case of a timeout, the item will become unsupported, a corresponding error message will be displayed, and the process forked for the script will be terminated. #### 外部チェック結果 外部チェックの戻り値は、チェックによって生成される標準出力と標準エラーです。 ::: noteimportant 標準エラー出力の場合、テキスト(文字、ログ、またはテキストタイプの情報)を返すアイテムはサポート外にはなりません。 ::: 戻り値は16MBに制限されます(切り捨てられた末尾の空白も含みます)。[データベースの制限](/manual/config/items/item#text_data_limits)も適用されます。 要求されたスクリプトが見つからないか、Zabbixサーバーにスクリプトを実行する権限がない場合、アイテムはサポートされなくなり、対応するエラーメッセージが表示されます。 タイムアウトが発生した場合はアイテムはサポートされなくなり、対応するエラーメッセージが表示され、スクリプト用にフォークされたプロセスが終了します。 **External plugin loader** Previously, plugins could only be compiled into Zabbix agent 2, which required recompiling the agent every time you need to change the set of available plugins. Now, with the addition of the external plugin loader, plugins don't have to be integrated into the agent 2 directly and can be added as separate external add-ons (loadable plugins), thus making the creation process of additional plugins for gathering new monitoring metrics easier. **外部プラグインローダー** これまでは、プラグインはZabbixエージェント2にのみコンパイルして組み込むことができ、利用可能なプラグインのセットを変更する必要があるたびに、エージェントを再コンパイルする必要がありました。外部プラグインローダーが追加されたことで、プラグインをエージェント2に直接統合する必要がなくなり、個別の外部アドオン(ロード可能なプラグイン)として追加できるようになったため、新しい監視メトリクスを収集するための追加プラグインの作成プロセスが容易になりました。 #### Extracting matching part of regular expression Sometimes we may want to extract only the interesting value from a target file instead of returning the whole line when a regular expression match is found. Since Zabbix 2.2.0, log items have the ability to extract desired values from matched lines. This is accomplished by the additional **output** parameter in `log` and `logrt` items. Using the 'output' parameter allows to indicate the "capturing group" of the match that we may be interested in. So, for example log[/path/to/the/file,"large result buffer allocation.*Entries: ([0-9]+)",,,,\1] should allow returning the entry count as found in the content of: Fr Feb 07 2014 11:07:36.6690 */ Thread Id 1400 (GLEWF) large result buffer allocation - /Length: 437136/Entries: 5948/Client Ver: >=10/RPC ID: 41726453/User: AUser/Form: CFG:ServiceLevelAgreement Only the number will be returned because **\\1** refers to the first and only capturing group: **(\[0-9\]+)**. And, with the ability to extract and return a number, the value can be used to define triggers. #### 正規表現のマッチング部分を抽出する 正規表現にマッチしたときに、行全体を返すのではなく、ターゲットファイルから目的の値だけを取り出したい場合があります。<br> Zabbix 2.2.0以降、ログアイテムはマッチした行から目的の値を抽出することができます。<br> これは、`log`と`logrt`item に追加された**output**パラメータによって実現されています。 'output' パラメータを使用すると、マッチした行のうち、興味のある "capturing group" を指定することができます。 そのため、例えば log[/path/to/the/file,"large result buffer allocation.*Entries: ([0-9]+)",,,,\1]　で 以下のログ内容から、エントリ数(Entries: の数値)を返すことができるはずです。 Fr Feb 07 2014 11:07:36.6690 */ Thread Id 1400 (GLEWF) large result buffer allocation - /Length: 437136/Entries: 5948/Client Ver: >=10/RPC ID: 41726453/User: AUser/Form: CFG:ServiceLevelAgreement **\\1** は最初のキャプチャグループのため、番号のみが返されます。**(\[0-9\]+)** また、数値を抽出して返す機能により、その値を使ってトリガーを定義することも可能です。 ### Failover to standby node Zabbix will fail over to another node automatically if the active node stops. There must be at least one node in standby status for the failover to happen. How fast will the failover be? All nodes update their last access time (and status, if it is changed) every 5 seconds. So: - If the active node shuts down and manages to report its status as "stopped", another node will take over within **5 seconds**. - If the active node shuts down/becomes unavailable without being able to update its status, standby nodes will wait for the **failover delay** + 5 seconds to take over The failover delay is configurable, with the supported range between 10 seconds and 15 minutes (one minute by default). To change the failover delay, you may run: ``` zabbix_server -R ha_set_failover_delay=5m ``` ### スタンバイノードへのフェイルオーバー アクティブなノードが停止すると、Zabbix は自動的に別のノードにフェイルオーバーします。フェイルオーバーが発生するには、少なくとも1つのノードがスタンバイ状態である必要があります。 フェイルオーバーはどのくらいの速さで実行されるか。すべてのノードは5秒ごとに最終アクセス時刻 (および変更されている場合はステータス) を更新します。したがって: - アクティブノードがシャットダウンし、そのステータスが"停止"と報告された場合、別のノードが**5秒**以内に引き継ぎます。 - アクティブノードがシャットダウンするか、ステータスを更新できずに使用できなくなった場合、スタンバイノードは**フェイルオーバー遅延**+5秒待機して引き継ぎます。 フェイルオーバー遅延は設定可能で、サポートされる範囲は10秒から15分(デフォルト1分)です。フェイルオーバー遅延の変更は次のコマンドを実行します: ``` zabbix_server -R ha_set_failover_delay=5m ``` ##### Favorite custom graphs no longer supported It is no longer possible to add custom graphs to favorites in *Monitoring* -> *Hosts* -> *Graphs*. After the upgrade any existing custom graphs will be removed from favorites. ##### お気に入りカスタムグラフに対応しなくなりました *Monitoring* -> *Hosts* -> *Graphs* でカスタムグラフをお気に入りに追加することができなくなります。 アップグレード後、既存のカスタムグラフはすべてお気に入りから削除されます。 ##### Field size limit Maximum field size has been increased for the following fields: - [Item preprocessing](/manual/config/items/preprocessing#configuration) parameters - [Media type](/manual/config/notifications/media#common-parameters) message ##### フィールドサイズの上限 以下のフィールドについて、最大フィールドサイズを拡大しました： - [アイテムの保存前処理](/manual/config/items/preprocessing#configuration) のパラメータ - [メディアタイプ](/manual/config/notifications/media#common-parameters) のメッセージ ## FILES */usr/local/etc/zabbix\_agent2.conf* Default location of Zabbix agent 2 configuration file (if not modified during compile time). [ ]{#lbAH} ## ファイル */usr/local/etc/zabbix\_agent2.conf* Zabbixエージェント2の設定ファイルのデフォルト格納先 (コンパイル時に変更されていない場合)。 [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_agentd.conf* Default location of Zabbix agent configuration file (if not modified during compile time). [ ]{#lbAI} ## ファイル */usr/local/etc/zabbix\_agentd.conf* Zabbixエージェントの設定ファイルのデフォルト格納先 (コンパイル時に変更されていない場合)。 [ ]{#lbAI} ## FILES */usr/local/etc/zabbix\_proxy.conf* Default location of Zabbix proxy configuration file (if not modified during compile time). [ ]{#lbAI} ## ファイル */usr/local/etc/zabbix\_proxy.conf* Zabbixプロキシの設定ファイルのデフォルト格納先 (コンパイル時に変更されていない場合)。 [ ]{#lbAI} ## FILES */usr/local/etc/zabbix\_server.conf* Default location of Zabbix server configuration file (if not modified during compile time). [ ]{#lbAI} ## ファイル */usr/local/etc/zabbix\_server.conf* Zabbixサーバーの設定ファイルのデフォルト格納先 (コンパイル時に変更されていない場合)。 [ ]{#lbAI} ## FILES */usr/local/etc/zabbix\_web\_service.conf* Default location of Zabbix web service configuration file (if not modified during compile time). [ ]{#lbAG} ## ファイル */usr/local/etc/zabbix\_web\_service.conf* Zabbix Webサービスの設定ファイルのデフォルト格納先 (コンパイル時に変更されていない場合)。 [ ]{#lbAG} ##### File system Because of the trap file implementation, Zabbix needs the file system to support inodes to differentiate files (the information is acquired by a stat() call). ##### ファイルシステム Trap ファイルの実装のため、Zabbixはファイルを区別するために inodeをサポートする<br> ファイルシステムを必要とします(この情報は stat() 呼出で取得します)。 ##### Filter buttons | | | |---|---| ||Apply specified filtering criteria (without saving).| ||Reset current filter and return to saved parameters of the current tab. On the Home tab, this will clear the filter.| ||Save current filter parameters in a new tab. Only available on the *Home* tab.| ||Replace tab parameters with currently specified parameters. Not available on the *Home* tab.| ##### Filter buttons | | | |---|---| ||Apply specified filtering criteria (without saving).| ||Reset current filter and return to saved parameters of the current tab. On the Home tab, this will clear the filter.| ||Save current filter parameters in a new tab. Only available on the *Home* tab.| ||Replace tab parameters with currently specified parameters. Not available on the *Home* tab.| ##### Filter buttons | | | |--|--------| ||Apply specified filtering criteria (without saving).| ||Reset current filter and return to saved parameters of the current tab. On the main tab, this will clear the filter.| ||Save current filter parameters in a new tab. Only available on the main tab.| ||Replace tab parameters with currently specified parameters. Not available on the main tab.| ##### フィルターのボタン | | | |--|--------| ||指定されたフィルタリングを（保存せずに）適用します| ||現在のフィルターをリセットし、現在のタブに保存されたパラメーターに戻ります。 メインタブの場合はフィルターがクリアされます。| ||現在のフィルタリングパラメーターを新しいタブに保存します。 メインタブでのみ使用できます。| ||タブに保存されているパラメータを現在指定されているパラメータに置き換えます。 メインタブでは使用できません。| #### Filter expression Filter expression is a arithmetical expression in infix notation. Supported operands: |Operand|Description|Example| |--|------|------| |`"<text>"`<br>`'<text>'`|Text constant.|'value: \\'1\\''<br>"value: '1'"| |`<number>`|Numeric constant supporting scientific notation.|123| |`<jsonpath starting with $>`|Value referred to by the JSONPath from the input document root node; only definite paths are supported.|$.object.name| |`<jsonpath starting with @>`|Value referred to by the JSONPath from the current object/element; only definite paths are supported.|@.name| Supported operators: |Operator|Type|Description|Result| |--|--------|----|----| |`-`|binary|Subtraction.|Number.| |`+`|binary|Addition.|Number.| |`/`|binary|Division.|Number.| |`*`|binary|Multiplication.|Number.| |`==`|binary|Is equal to.|Boolean (1 or 0).| |`!=`|binary|Is not equal to.|Boolean (1 or 0).| |`<`|binary|Is less than.|Boolean (1 or 0).| |`<=`|binary|Is less than or equal to.|Boolean (1 or 0).| |`>`|binary|Is greater than.|Boolean (1 or 0).| |`>=`|binary|Is greater than or equal to.|Boolean (1 or 0).| |`=~`|binary|Matches regular expression.|Boolean (1 or 0).| |`!`|unary|Boolean not.|Boolean (1 or 0).| |`||`|binary|Boolean or.|Boolean (1 or 0).| |`&&`|binary|Boolean and.|Boolean (1 or 0).| #### フィルター式 フィルター式は、中置表記の算術式です。 サポートされているオペランド: |オペランド|説明|例| |--|------|------| |`"<text>"`<br>`'<text>'`|テキスト定数|'value: \\'1\\''<br>"value: '1'"| |`<number>`|科学表記法をサポートする数値定数|123| |`<jsonpath starting with $>`|入力ドキュメントのルート ノードから JSONPath によって参照される値。 明確なパスのみがサポートされています。|$.object.name| |`<jsonpath starting with @>`|現在のオブジェクト/要素から JSONPath によって参照される値。 明確なパスのみがサポートされています。|@.name| サポートされている演算子: |演算子|タイプ|説明|結果| |--|--------|----|----| |`-`|binary|減算|Number.| |`+`|binary|加算|Number.| |`/`|binary|除算|Number.| |`*`|binary|乗算|Number.| |`==`|binary|等しい|Boolean (1 or 0).| |`!=`|binary|等しくない|Boolean (1 or 0).| |`<`|binary|未満|Boolean (1 or 0).| |`<=`|binary|以下|Boolean (1 or 0).| |`>`|binary|超過|Boolean (1 or 0).| |`>=`|binary|以下|Boolean (1 or 0).| |`=~`|binary|正規表現に一致|Boolean (1 or 0).| |`!`|binary|ブール値のnot|Boolean (1 or 0).| |`||`|binary|ブール値のor|Boolean (1 or 0).| |`&&`|binary|ブール値のand|Boolean (1 or 0).| ##### Filtering by host In the *by host* mode results can be filtered by a host or by the host group. Specifying a parent host group implicitly selects all nested host groups. ##### ホストによるフィルタリング *ホスト*モードでは、結果をホストまたはホストグループでフィルタリングできます。親ホストグループを指定すると、ネストされたすべてのホストグループが暗黙的に選択されます。 #### Filter settings remembered In several Monitoring pages (*Problems*, *Hosts*, *Latest data*) the current filter settings are now remembered in the user profile. When the user opens the page again, the filter settings will have stayed the same. Additionally, the marking of a changed (but not saved) favorite filter is now a green dot next to the filter name, instead of the filter name in italics. #### フィルター設定の記憶 いくつかの監視データページ(*障害*、*ホスト*、*最新データ*)で、現在のフィルター設定がユーザープロファイルに記憶されるようになりました。ユーザーがページを再び開いたとき、フィルター設定は維持されます。 また、変更した(保存していない)お気に入りフィルターのマークは、斜体のフィルター名ではなく、緑色のドットが表示されるようになりました。 #### Find HTTP agent item Find HTTP agent item with post body type XML for specific host ID. Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "hostids": "10255", "filter": { "type": 19, "post_type": 3 } }, "id": 3, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28252", "type": "19", "snmp_oid": "", "hostid": "10255", "name": "template item", "key_": "ti", "delay": "30s", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "localhost", "query_fields": [ { "mode": "xml" } ], "posts": "<body>\r\n<![CDATA[{$MACRO}<foo></bar>]]>\r\n</body>", "status_codes": "200", "follow_redirects": "0", "post_type": "3", "http_proxy": "", "headers": [], "retrieve_mode": "1", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "", "prevvalue": "" } ], "id": 3 } ``` #### HTTP エージェント アイテムを探す 特定のホストIDの投稿本文タイプが XML の HTTP エージェント アイテムを検索します。 Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "hostids": "10255", "filter": { "type": 19, "post_type": 3 } }, "id": 3, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28252", "type": "19", "snmp_oid": "", "hostid": "10255", "name": "template item", "key_": "ti", "delay": "30s", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "localhost", "query_fields": [ { "mode": "xml" } ], "posts": "<body>\r\n<![CDATA[{$MACRO}<foo></bar>]]>\r\n</body>", "status_codes": "200", "follow_redirects": "0", "post_type": "3", "http_proxy": "", "headers": [], "retrieve_mode": "1", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "", "prevvalue": "" } ], "id": 3 } ``` #### Find HTTP agent item prototype Find HTTP agent item prototype with request method HEAD for specific host ID. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.get", "params": { "hostids": "10254", "filter": { "type": "19", "request_method": "3" } }, "id": 17, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28257", "type": "19", "snmp_oid": "", "hostid": "10254", "name": "discovered", "key_": "item[{#INAME}]", "delay": "{#IUPDATE}", "history": "90d", "trends": "30d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "28255", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "2", "description": "", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "{#IURL}", "query_fields": [], "posts": "", "status_codes": "", "follow_redirects": "0", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 17 } ``` #### HTTP エージェント アイテムのプロトタイプを見つける 特定のホスト ID のリクエスト メソッド HEAD を持つ HTTP エージェント アイテム プロトタイプを検索します。 Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.get", "params": { "hostids": "10254", "filter": { "type": "19", "request_method": "3" } }, "id": 17, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28257", "type": "19", "snmp_oid": "", "hostid": "10254", "name": "discovered", "key_": "item[{#INAME}]", "delay": "{#IUPDATE}", "history": "90d", "trends": "30d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "28255", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "2", "description": "", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "{#IURL}", "query_fields": [], "posts": "", "status_codes": "", "follow_redirects": "0", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 17 } ``` #### Finding dependent item Find one Dependent item for item with ID "25545". Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "filter": { "type": "18", "master_itemid": "25545" }, "limit": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "25547", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Seconds", "key_": "apache.status.uptime.seconds", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "0", "description": "", "evaltype": "0", "master_itemid": "25545", "jmx_endpoint": "", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 1 } ``` #### 依存アイテムの検索 アイテムID"25545"の依存アイテムを 1 つ検索します。 Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "filter": { "type": "18", "master_itemid": "25545" }, "limit": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "25547", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Seconds", "key_": "apache.status.uptime.seconds", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "0", "description": "", "evaltype": "0", "master_itemid": "25545", "jmx_endpoint": "", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 1 } ``` #### Finding dependent items by key Retrieve all dependent items from host with ID "10116" that have the word "apache" in the key. Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10116", "search": { "key_": "apache" }, "filter": { "type": 18 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "25550", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Days", "key_": "apache.status.uptime.days", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "25545", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "25555", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Hours", "key_": "apache.status.uptime.hours", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "25545", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" } ], "id": 1 } ``` #### キーによる依存アイテムの検索 ID が"10116"で、キーに"apache"という単語が含まれるすべての依存アイテムをホストから取得します。 Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10116", "search": { "key_": "apache" }, "filter": { "type": 18 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "25550", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Days", "key_": "apache.status.uptime.days", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "25545", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "25555", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Hours", "key_": "apache.status.uptime.hours", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "25545", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" } ], "id": 1 } ``` #### Finding items by key Retrieve all items used in triggers specific host ID that have word "system.cpu" in the item key and sort results by name. Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10084", "with_triggers": true, "search": { "key_": "system.cpu" }, "sortfield": "name" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "42269", "type": "18", "snmp_oid": "", "hostid": "10084", "name": "CPU utilization", "key_": "system.cpu.util", "delay": "0", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "%", "logtimefmt": "", "templateid": "42267", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "CPU utilization in %.", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "42264", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42259", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (15m avg)", "key_": "system.cpu.load[all,avg15]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42219", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42249", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (1m avg)", "key_": "system.cpu.load[all,avg1]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42209", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42257", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (5m avg)", "key_": "system.cpu.load[all,avg5]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42217", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42260", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Number of CPUs", "key_": "system.cpu.num", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42220", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" } ], "id": 1 } ``` #### キーによる項目の検索 トリガー固有のホスト ID で使用され、アイテム キーに"system.cpu"という単語が含まれるすべてのアイテムを取得し、結果を名前で並べ替えます。 Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10084", "with_triggers": true, "search": { "key_": "system.cpu" }, "sortfield": "name" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "42269", "type": "18", "snmp_oid": "", "hostid": "10084", "name": "CPU utilization", "key_": "system.cpu.util", "delay": "0", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "%", "logtimefmt": "", "templateid": "42267", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "CPU utilization in %.", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "42264", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42259", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (15m avg)", "key_": "system.cpu.load[all,avg15]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42219", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42249", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (1m avg)", "key_": "system.cpu.load[all,avg1]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42209", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42257", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (5m avg)", "key_": "system.cpu.load[all,avg5]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42217", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42260", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Number of CPUs", "key_": "system.cpu.num", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42220", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" } ], "id": 1 } ``` #### Flexible intervals Flexible intervals allow to redefine the default update interval for specific time periods. A flexible interval is defined with *Interval* and *Period* where: - *Interval* – the update interval for the specified time period - *Period* – the time period when the flexible interval is active (see the [time periods](/manual/appendix/time_period) for detailed description of the *Period* format) If multiple flexible intervals overlap, the smallest *Interval* value is used for the overlapping period. Note that if the smallest value of overlapping flexible intervals is '0', no polling will take place. Outside the flexible intervals the default update interval is used. Note that if the flexible interval equals the length of the period, the item will be checked exactly once. If the flexible interval is greater than the period, the item might be checked once or it might not be checked at all (thus such configuration is not advisable). If the flexible interval is less than the period, the item will be checked at least once. If the flexible interval is set to '0', the item is not polled during the flexible interval period and resumes polling according to the default *Update interval* once the period is over. Examples: |Interval|Period|Description| |--|--|------| |10|1-5,09:00-18:00|Item will be checked every 10 seconds during working hours.| |0|1-7,00:00-7:00|Item will not be checked during the night.| |0|7-7,00:00-24:00|Item will not be checked on Sundays.| |60|1-7,12:00-12:01|Item will be checked at 12:00 every day. Note that this was used as a workaround for scheduled checks and starting with Zabbix 3.0 it is recommended to use scheduling intervals for such checks.| #### 例外設定 例外設定は、特定の時間帯のデフォルトの更新間隔を再定義することができます。例外設定は、*監視間隔*と*期間*で定義されます。 - *監視間隔* - 指定された期間の更新間隔です。 - *期間* - 例外設定が有効な期間(詳細については、[日時フォーマット](/manual/appendix/time_period)を参照してください)。 複数の例外設定の監視間隔が重なった場合、最も小さい*監視間隔*の値が重なる期間に使用されます。 重なる設定の監視間隔の最小値が'0'である場合、ポーリングは行われません。 例外設定の期間外では、デフォルトの監視間隔が使用されます。 例外設定の監視間隔が期間の長さと等しい場合、アイテムは一度だけチェックされることに注意してください。 例外設定の監視間隔が期間より大きい場合、アイテムは一度だけチェックされるか、全くチェックされないかもしれません(したがって、このような構成は望ましくありません)。 もし監視間隔が期間より短い場合、そのアイテムは少なくとも1回チェックされます。 例外設定の監視間隔が'0'に設定されている場合、そのアイテムは例外設定の期間中はポーリングされません。 期間が終了するとデフォルトの*監視間隔*に従ってポーリングが再開されます。たとえば: |監視間隔|期間|説明| |--|--|------| |10|1-5,09:00-18:00|アイテムは勤務時間中に10秒ごとにチェックする。| |0|1-7,00:00-7:00|アイテムは夜にチェックを行わない。| |0|7-7,00:00-24:00|アイテムは日曜日にはチェックを行わない。| |60|1-7,12:00-12:01|アイテムは毎日12:00にチェックする。これは、スケジュールされたチェック用に回避策として用意されたものであることに注意してください。Zabbix 3.0以降では、このようなチェックには定期設定を使用してください。| #### Flexible user parameters Flexible user parameters accept parameters with the key. This way a flexible user parameter can be the basis for creating several items. Flexible user parameters have the following syntax: UserParameter=key[*],command |Parameter|Description| |--|--------| |**Key**|Unique item key. The \[\*\] defines that this key accepts parameters within the brackets.<br>Parameters are given when configuring the item.| |**Command**|Command to be executed to evaluate value of the key.<br>*For flexible user parameters only*:<br>You may use positional references $1…$9 in the command to refer to the respective parameter in the item key.<br>Zabbix parses the parameters enclosed in \[ \] of the item key and substitutes $1,...,$9 in the command accordingly.<br>$0 will be substituted by the original command (prior to expansion of $0,...,$9) to be run.<br>Positional references are interpreted regardless of whether they are enclosed between double (") or single (') quotes.<br>To use positional references unaltered, specify a double dollar sign - for example, awk '{print $$2}'. In this case `$$2` will actually turn into `$2` when executing the command.| ::: noteimportant Positional references with the $ sign are searched for and replaced by Zabbix agent only for flexible user parameters. For simple user parameters, such reference processing is skipped and, therefore, any $ sign quoting is not necessary. ::: ::: noteimportant Certain symbols are not allowed in user parameters by default. See [UnsafeUserParameters](/manual/appendix/config/zabbix_agentd) documentation for a full list. ::: #### フレキシブルユーザーパラメータ フレキシブルユーザーパラメータは、キーでパラメータを受け取ります。<br> このように、フレキシブルユーザーパラメータは、複数の item を作成するためのベースとなることができます。 フレキシブルユーザーパラメーターの構文は以下の通りです。 UserParameter=key[*],command |パラメータ|説明| |--|--------| |**Key**|一意のアイテム キー。\[\*\]は、このキーが括弧内のパラメーターを受け入れることを定義します。<br>パラメーターは、アイテムを設定するときに指定します。| |**Command**|キーの値を評価するために実行されるコマンド。<br>*ユーザーパラメータをフレキシブルに使う為*:<br>コマンド内で位置参照 $1…$9 を使用して、アイテム キー内のそれぞれのパラメータを参照できます。<br>Zabbix はアイテム キーの\[ \]で囲まれたパラメータを解析し、それに応じてコマンド内で $1、...、$9 を置き換えます。<br>$0は、実行される元のコマンド($0、...、$9の展開前)に置き換えられます。<br>位置参照は、二重引用符 (") または一重引用符 (') で囲まれているかどうかに関係なく解釈されます。<br>位置参照を変更せずに使用するには、二重ドル記号を指定します (例: awk '{print $$2}')。この場合、コマンドの実行時に`$$2`は実際には`$2`になります。| ::: noteimportant Zabbix agent では、柔軟なユーザパラメータの場合のみ、$記号を含む位置参照が検索され、置換されます。<br> シンプルなユーザパラメータでは、このような参照処理はスキップされるため、$記号の引用は必要ありません。 ::: ::: noteimportant デフォルトでは、ユーザパラメータに特定のシンボルを使用することはできません。 全リストは [UnsafeUserParameters](/manual/appendix/config/zabbix_agentd) ドキュメントを参照してください。 ::: #### Flipping frontend locales It has been observed that frontend locales may flip without apparent logic, i. e. some pages (or parts of pages) are displayed in one language while other pages (or parts of pages) in a different language. Typically the problem may appear when there are several users, some of whom use one locale, while others use another. A known workaround to this is to disable multithreading in PHP and Apache. The problem is related to how setting the locale works [in PHP](https://www.php.net/manual/en/function.setlocale): locale information is maintained per process, not per thread. So in a multi-thread environment, when there are several projects run by same Apache process, it is possible that the locale gets changed in another thread and that changes how data can be processed in the Zabbix thread. For more information, please see related problem reports: - [ZBX-10911](https://support.zabbix.com/browse/ZBX-10911) (Problem with flipping frontend locales) - [ZBX-16297](https://support.zabbix.com/browse/ZBX-16297) (Problem with number processing in graphs using the `bcdiv` function of BC Math functions) #### Webインターフェースの言語設定の切り替え Webインターフェースの言語設定が、明確なロジックなしに切り替わる場合があることが確認されています。例えば、一部のページ(またはページの一部)がある言語で表示され、他のページ(またはページの一部)が別の言語で表示されることがあります。 この問題は、複数のユーザーがいて、一部のユーザーがあるロケールを使用し、他のユーザーが別のロケールを使用している場合に発生する可能性があります。 この問題の既知の回避策として、PHPとApacheのマルチスレッドを無効にすることが挙げられます。 この問題は、[PHPにおける](https://www.php.net/manual/en/function.setlocale)ロケール設定の仕組みに関係しています。ロケール情報はスレッドごとではなくプロセスごとに保持されます。そのため、マルチスレッド環境で、同じApacheプロセスで複数のプロジェクトが実行されている場合、別のスレッドでロケールが変更され、Zabbixスレッドでのデータ処理方法が変更される可能性があります。 詳細については、関連する問題レポートをご覧ください: - [ZBX-10911](https://support.zabbix.com/browse/ZBX-10911) (Webインターフェースのロケール切り替えに関する問題) - [ZBX-16297](https://support.zabbix.com/browse/ZBX-16297) (BC Math関数の`bcdiv`関数を使用したグラフ内の数値処理に関する問題) ### Float history The float history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|float|Received value.| ### Float history float historyオブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|float|Received value.| ### Float trend The float trend object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Timestamp of an hour for which the value was calculated. E. g. timestamp of 04:00:00 means values calculated for period 04:00:00-04:59:59.| |itemid|integer|ID of the related item.| |num|integer|Number of values that were available for the hour.| |value\_min|float|Hourly minimum value.| |value\_avg|float|Hourly average value.| |value\_max|float|Hourly maximum value.| ### Float trend float trendオブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |clock|timestamp|値が計算された時間のタイムスタンプ。 例: 04:00:00の場合、04:00:00-04:59:59の間で計算された値であることを意味します。| |itemid|integer|関連アイテムのID| |num|integer|その時間に使用可能だった値の数| |value\_min|float|1時間ごとの最小値| |value\_avg|float|1時間ごとの平均値| |value\_max|float|1時間ごとの最大値| ##### Footnotes ^**1**^A Linux-specific note. Zabbix agent must have read-only access to filesystem */proc*. Kernel patches from www.grsecurity.org limit access rights of non-privileged users. ^**2**^ `vfs.dev.read[]`, `vfs.dev.write[]`: Zabbix agent will terminate "stale" device connections if the item values are not accessed for more than 3 hours. This may happen if a system has devices with dynamically changing paths or if a device gets manually removed. Note also that these items, if using an update interval of 3 hours or more, will always return '0'. ^**3**^ `vfs.dev.read[]`, `vfs.dev.write[]`: If default *all* is used for the first parameter then the key will return summary statistics, including all block devices like sda, sdb and their partitions (sda1, sda2, sdb3...) and multiple devices (MD raid) based on those block devices/partitions and logical volumes (LVM) based on those block devices/partitions. In such cases returned values should be considered only as relative value (dynamic in time) but not as absolute values. ^**4**^ SSL (HTTPS) is supported only if agent is compiled with cURL support. Otherwise the item will turn unsupported. ##### 脚注 ^**1**^Linux特有の注意事項です。Zabbix agent は、ファイルシステム*/proc*に読み取り専用でアクセスできる必要があります。<br> www.grsecurity.org のカーネルパッチにより、非特権ユーザのアクセス権が制限されます。<br> ^**2**^ `vfs.dev.read[]`、`vfs.dev.write[]`: 3時間以上アクセスされない場合、Zabbixエージェントは「古くなった」デバイス接続を終了します。<br> この現象は、動的にパスが変更されるデバイスがシステムに存在する場合、またはデバイスのパスが手動で<br> 削除された場合などに発生します。また、これらの item は、3時間以上の更新間隔を使用する場合、常に'0'を返します。<br> ^**3**^ `vfs.dev.read[]`, `vfs.dev.write[]`: 最初のパラメータにデフォルトの *all* が使われた場合、キーは統計の概要を返します。<br> sda, sbdのようなすべてのブロックデバイスとそのパーティション(sda1,sda2、sdb3...）のようなすべてのブロックデバイスと、<br> それらのブロックデバイス/パーティションに基づく複数のデバイス（MD raid）、および論理ボリュームを含む統計情報の概要を返します。<br> このような場合、返される値は絶対値としてではなく、相対値(時間的に動的)としてのみ考慮する必要があります。<br> SSL (HTTPS) は、agent が cURL をサポートしてコンパイルされている場合のみサポートされます。<br> それ以外の場合、この項目はサポートされないことになります。<br> ##### Footnotes ^**1**^ Default value. ##### 脚注 ^**1**^ デフォルト値 ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "EMAIL") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### 脚注 ^**1**^ 文字列値については、文字列のみがエクスポートされ(例:"EMAIL "など) 、この表で使用される番号付けは行われません。 <br> このテーブルの範囲値(API値に対応)の番号は、順序付けのためにのみ使用されます。 ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "ZABBIX\_ACTIVE") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### 脚注 文字列値の場合は、番号付けは行われず、文字列のみがエクスポートされます(例: 「ZABBIX_ACTIVE」)。 <br> このテーブルの範囲値(API 値に対応)の番号は、順序付けにのみ使用されます。 ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "ZABBIX\_ACTIVE") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### 脚注 ^**1**^ 文字列値の場合は、このテーブルで使用されている番号付けは行われず、 <br> 文字列のみがエクスポートされます(例: 「ZABBIX_ACTIVE」)。 <br> このテーブルの範囲値(API 値に対応)の番号は、順序付けにのみ使用されます。 ##### Footnotes ^**1**^ If multiple macros in a field or macros mixed with text are not supported for the location, a single macro has to fill the whole field. ^**2**^ Macros used in tag names and values are resolved only during event generation process. ^**3**^ URLs that contain a [secret macro](/manual/config/macros/user_macros#configuration) will not work, as the macro in them will be resolved as "\*\*\*\*\*\*". ##### 脚注 ^**1**^ フィールド内の複数のマクロまたはテキストと混合されたマクロがそのロケーションでサポートされていない場合は、1 つのマクロでフィールド全体を埋める必要があります。 ^**2**^ タグ名と値で使用されるマクロは、イベント生成プロセス中にのみ解決されます。 ^**3**^ [シークレットマクロ](/manual/config/macros/user_macros#configuration)を含む URL は機能しません。それらのマクロは"\*\*\*\*\*\*"のように解決されます。 ##### Footnotes ^**1**^ In the fields marked with ^[1](lld_macros#footnotes)^ a single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported. ##### 脚注 ^**1**^ ^[1](lld_macros#footnotes)^ でマークされたフィールドでは、1つのマクロでフィールド 全体を埋める必要があります。<br> フィールド内の複数のマクロや、テキストと混在するマクロはサポートされていません。 ### Footnotes ^**1**^ - Since Zabbix 6.0.13, loadable plugins started using the same versioning system as Zabbix itself. As a result, MongoDB plugin version has changed from 1.2.0 to 6.0.13. ### 脚注 ^**1**^ - Zabbix 6.0.13以降、ロード可能なプラグインはZabbixと同じバージョンで管理されるようになりました。 これに伴い、MongoDBプラグインのバージョンが1.2.0から6.0.13に変更されました。 ##### Footnotes ^**1**^ - Since Zabbix 6.0.13, loadable plugins started using the same versioning system as Zabbix itself. As a result, MongoDB plugin version has changed from 1.2.0 to 6.0.13 and PostgreSQL plugin version has changed from 1.2.1 to 6.0.13. ##### 脚注 ^**1**^ - Zabbix 6.0.13 以降、ロード可能なプラグインは Zabbix 本体と同じバージョン管理システムを使用するようになりました。 その結果、MongoDB プラグインのバージョンは 1.2.0 から 6.0.13 に変更され、PostgreSQL プラグインのバージョンは 1.2.1 から 6.0.13 に変更されました。 ##### Footnotes ^**1**^ The `{HOST.*}` macros supported in item key parameters will resolve to the interface that is selected for the item. When used in items without interfaces they will resolve to either the Zabbix agent, SNMP, JMX or IPMI interface of the host in this order of priority or to 'UNKNOWN' if the host does not have any interface. ^**2**^ In global scripts, interface IP/DNS fields and web scenarios the macro will resolve to the main agent interface, however, if it is not present, the main SNMP interface will be used. If SNMP is also not present, the main JMX interface will be used. If JMX is not present either, the main IPMI interface will be used. If the host does not have any interface, the macro resolves to 'UNKNOWN'. ^**3**^ Only the **avg**, **last**, **max** and **min** functions, with seconds as parameter are supported in this macro in map labels. ^**4**^ `{HOST.*}` macros are supported in web scenario *Variables*, *Headers*, *SSL certificate file* and *SSL key file* fields and in scenario step *URL*, *Post*, *Headers* and *Required string* fields. Since Zabbix 5.4.0, `{HOST.*}` macros are no longer supported in web scenario *Name* and web scenario step *Name* fields. ^**5**^ Only the **avg**, **last**, **max** and **min** functions, with seconds as parameter are supported within this macro in graph names. The {HOST.HOST<1-9>} macro can be used as host within the macro. For example: * last(/Cisco switch/ifAlias[{#SNMPINDEX}]) * last(/{HOST.HOST}/ifAlias[{#SNMPINDEX}]) ^**6**^ Supported since 5.2.5. ##### 脚注 ^**1**^ アイテムキーパラメータでサポートされている`{HOST.*}`マクロは、アイテム用に選択されたインターフェースに解決されます。 インターフェースのないアイテムで使用すると、ホストのZabbixエージェント、SNMP、JMX、またはIPMIインターフェイスのいずれかに、この優先順位で解決されます。ホストにインターフェースがない場合は「不明」と解決されます。 ^**2**^ グローバルスクリプト、インターフェースIP/DNSフィールド、およびWebシナリオでは、マクロはメインエージェントインターフェースに解決されますが、存在しない場合は、メインSNMPインターフェースが使用されます。 SNMPも存在しない場合は、メインのJMXインターフェースが使用されます。 JMXも存在しない場合は、メインのIPMIインターフェースが使用されます。 ホストにインターフェースがない場合、マクロは「不明」と解決されます。 ^**3**^ マップラベルのこのマクロでは、パラメータとして秒を使用する** avg **、** last **、** max **、および**min**関数のみがサポートされています。 ^**4**^ `{HOST.*}`マクロはWebシナリオ*変数*、*ヘッダー*、* SSL証明書ファイル*、* SSLキーファイル*フィールド、およびシナリオステップ*URL*、*Post*、*ヘッダー*、*必須の文字列*フィールドでサポートされています。 Zabbix 5.4.0以降`{HOST.*}`マクロはWebシナリオ*名前*およびWebシナリオステップ*名前*フィールドでサポートされなくなりました。 ^**5**^ グラフ名のこのマクロでは、パラメーターとして秒を使用する** avg **、** last **、** max **、および**min**関数のみがサポートされます。 {HOST.HOST<1-9>}マクロは、マクロ内のホストとして使用できます。 例： * last(/Cisco switch/ifAlias[{#SNMPINDEX}]) * last(/{HOST.HOST}/ifAlias[{#SNMPINDEX}]) ^**6**^ 5.2.5以降でサポートされています。 ##### Footnotes ^**1**^ The VMware performance counter path has the `group/counter[rollup]` format where: - `group` - the performance counter group, for example *cpu* - `counter` - the performance counter name, for example *usagemhz* - `rollup` - the performance counter rollup type, for example *average* So the above example would give the following counter path: `cpu/usagemhz[average]` The performance counter group descriptions, counter names and rollup types can be found in [VMware documentation](https://www.vmware.com/support/developer/converter-sdk/conv60_apireference/vim.PerformanceManager.html). ^**2**^ The value of these items is obtained from VMware performance counters and the VMwarePerfFrequency [parameter](/manual/appendix/config/zabbix_server) is used to refresh their data in Zabbix VMware cache: - vmware.hv.datastore.read - vmware.hv.datastore.write - vmware.hv.network.in - vmware.hv.network.out - vmware.hv.perfcounter - vmware.vm.cpu.ready - vmware.vm.net.if.in - vmware.vm.net.if.out - vmware.vm.perfcounter - vmware.vm.vfs.dev.read - vmware.vm.vfs.dev.write ##### Footnotes ^**1**^ The VMware performance counter path has the `group/counter[rollup]` format where: - `group` - the performance counter group, for example *cpu* - `counter` - the performance counter name, for example *usagemhz* - `rollup` - the performance counter rollup type, for example *average* So the above example would give the following counter path: `cpu/usagemhz[average]` The performance counter group descriptions, counter names and rollup types can be found in [VMware documentation](https://www.vmware.com/support/developer/converter-sdk/conv60_apireference/vim.PerformanceManager.html). ^**2**^ The value of these items is obtained from VMware performance counters and the VMwarePerfFrequency [parameter](/manual/appendix/config/zabbix_server) is used to refresh their data in Zabbix VMware cache: - vmware.hv.datastore.read - vmware.hv.datastore.write - vmware.hv.network.in - vmware.hv.network.out - vmware.hv.perfcounter - vmware.vm.cpu.ready - vmware.vm.net.if.in - vmware.vm.net.if.out - vmware.vm.perfcounter - vmware.vm.vfs.dev.read - vmware.vm.vfs.dev.write #### Form buttons Buttons at the bottom of the form allow to perform several operations. | | | |--|--------| ||Add an item. This button is only available for new items.| ||Update the properties of an item.| ||Create another item based on the properties of the current item.| ||Execute a check for a new item value immediately. Supported for **passive** checks only (see [more details](/manual/config/items/check_now)).<br>*Note* that when checking for a value immediately, configuration cache is not updated, thus the value will not reflect very recent changes to item configuration.| ||Test if item configuration is correct by getting a value.| ||Delete the item history and trends.| ||Delete the item.| ||Cancel the editing of item properties.| #### フォームのボタン フォームの下部にあるボタンで、いくつかの操作を行うことができます。 | | | |--|--------| ||アイテムの追加。このボタンは新規のアイテムの時のみ使用できます。| ||アイテムのプロパティの更新。| ||現在のアイテムプロパティをベースにして別のアイテムを作成。| ||アイテムの値を取得。アイテムのタイプが**パッシブ**なものだけ対応しています。([詳細](/manual/config/items/check_now)参照)<br>*注意* 値の取得時には設定キャッシュは更新されません。つまり直近のアイテムの設定変更が反映されません。| ||値を取得できるかのテスト実行。| ||アイテムのヒストリとトレンドを削除。| ||アイテムの削除。| ||アイテムのプロパティ変更をキャンセル。| ##### Form buttons Buttons at the bottom of the form allow to perform several operations. | | | |---|---| ||Add a report. This button is only available for new reports.| ||Update the properties of a report.| ||Create another report based on the properties of the current report.| ||Test if report configuration is correct by sending a report to the current user.| ||Delete the report.| ||Cancel the editing of report properties.| ##### フォームのボタン フォームの下部にあるボタンで、いくつかの操作を行うことができます。 | | | |---|---| ||Add a report. This button is only available for new reports.| ||Update the properties of a report.| ||Create another report based on the properties of the current report.| ||Test if report configuration is correct by sending a report to the current user.| ||Delete the report.| ||Cancel the editing of report properties.| #### FreeBSD See values supported for 'memtype' parameter on FreeBSD in the table. |Supported value|Description|Source in kinfo\_proc structure|Tries to be compatible with| |--|------|--|--| |vsize|Virtual memory size|kp\_eproc.e\_vm.vm\_map.size or ki\_size|ps -o vsz| |pmem|Percentage of real memory|calculated from rss|ps -o pmem| |rss|Resident set size|kp\_eproc.e\_vm.vm\_rssize or ki\_rssize|ps -o rss| |size ^[1](proc_mem_notes#footnotes)^|Size of process (code + data + stack)|tsize + dsize + ssize| | |tsize|Text (code) size|kp\_eproc.e\_vm.vm\_tsize or ki\_tsize|ps -o tsiz| |dsize|Data size|kp\_eproc.e\_vm.vm\_dsize or ki\_dsize|ps -o dsiz| |ssize|Stack size|kp\_eproc.e\_vm.vm\_ssize or ki\_ssize|ps -o ssiz| #### FreeBSD 以下の表がFreeBSDの'memtype'パラメーターでサポートされている値です。 |サポート値|説明|kinfo\_proc構造体のソース|互換| |--|------|--|--| |vsize|仮想メモリサイズ|kp\_eproc.e\_vm.vm\_map.size or ki\_size|ps -o vsz| |pmem|実メモリのパーセンテージ|calculated from rss|ps -o pmem| |rss|物理メモリ消費量|kp\_eproc.e\_vm.vm\_rssize or ki\_rssize|ps -o rss| |size ^[1](proc_mem_notes#footnotes)^|プロセスのサイズ(コード + データ + スタック)|tsize + dsize + ssize| | |tsize|テキスト (コード)サイズ|kp\_eproc.e\_vm.vm\_tsize or ki\_tsize|ps -o tsiz| |dsize|データサイズ|kp\_eproc.e\_vm.vm\_dsize or ki\_dsize|ps -o dsiz| |ssize|スタックサイズ|kp\_eproc.e\_vm.vm\_ssize or ki\_ssize|ps -o ssiz| ## Frontend ## Webインターフェース ## Frontend ## Webインターフェース ## Frontend ## Webインターフェース ## Frontend ## Webインターフェース ## Frontend ## Webインターフェース ## Frontend ## Webインターフェイス ##### Frontend configuration A Zabbix proxy does not have a frontend; it communicates with Zabbix server only. ##### フロントエンドの設定 Zabbix proxyはフロントエンドを持たず、Zabbix serverとのみ通信を行います。 ##### Frontend configuration A Zabbix proxy does not have a frontend; it communicates with Zabbix server only. ##### Webインターフェースの設定 Zabbixプロキシは、Webインターフェースを持ちません。Zabbixサーバーとのみ通信を行います。 ##### Frontend configuration A Zabbix proxy does not have a frontend; it communicates with Zabbix server only. ##### Webインターフェースの設定 Zabbixプロキシは、Webインターフェースを持ちません。Zabbixサーバーとのみ通信を行います。 ##### Frontend configuration with Kerberos/ADFS The Zabbix frontend configuration file (*zabbix.conf.php*) can be used to configure SSO with Kerberos authentication and ADFS: ```php $SSO['SETTINGS'] = [ 'security' => [ 'requestedAuthnContext' => [ 'urn:oasis:names:tc:SAML:2.0:ac:classes:Kerberos', ], 'requestedAuthnContextComparison' => 'exact' ] ]; ``` In this case, in the SAML configuration *SP name ID* field set: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified ##### Kerberos/ADFS を使用したWebインターフェース設定 Zabbix Webインターフェースの設定ファイル(*zabbix.conf.php*) を使用して、Kerberos認証とADFSによるSSOを設定できます: ```php $SSO['SETTINGS'] = [ 'security' => [ 'requestedAuthnContext' => [ 'urn:oasis:names:tc:SAML:2.0:ac:classes:Kerberos', ], 'requestedAuthnContextComparison' => 'exact' ] ]; ``` この場合、SAML 構成の *SP 名 ID* フィールドで次のように設定します: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified ### Frontend languages Catalan and Romanian languages are now enabled in the frontend. ### Webインターフェースの言語 Webインターフェースでカタロニア語とルーマニア語が使用できるようになりました。 #### Frontend languages Dutch, Georgian, and Spanish languages are now enabled in the frontend. #### Webインターフェースの言語 Webインターフェースでオランダ語、グルジア語、スペイン語が使用できるようになりました。 ### Frontend languages German and Vietnamese languages are now enabled in the frontend. ### Webインターフェースの言語 Webインターフェースでドイツ語とベトナム語が使用できるようになりました。 ### Frontend ##### Miscellaneous - Warnings about incorrect housekeeping configuration for TimescaleDB are now displayed if history or trend tables contain compressed chunks, but *Override item history period* or *Override item trend period* options are disabled. For more information, see [TimescaleDB setup](/manual/appendix/install/timescaledb#configuration). ### Webインターフェース ##### その他 - ヒストリやトレンドのテーブルに圧縮されたチャンクが含まれている場合、TimescaleDBの不適切なhousekeepingの設定に関する警告が表示されるようになりましたが、*アイテムのヒストリの保存期間の上書き*または*アイテムのトレンドの保存期間の上書き*のオプションが無効になっています。詳しくは、[TimescaleDBのセットアップ](/manual/appendix/install/timescaledb#configuration)を参照してください。 #### Frontend To enable encryption with certificate and database host identity verification for connections between Zabbix frontend and the database: - Check *Database TLS encryption* and *Verify database certificate* - Specify path to *Database TLS key file* - Specify path to *Database TLS CA file* - Specify path to *Database TLS certificate file* - Check *Database host verification* {width="600"} Alternatively, this can be set in */etc/zabbix/web/zabbix.conf.php:* $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/pgsql/root.crt'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = ''; ... #### フロントエンド Zabbixフロントエンドとデータベース間接続の証明書とデータベースホストID検証による暗号化を有効にするには： - *データベースTLS暗号化*と*データベース証明書の確認*をチェック - *データベースTLSキーファイル*へのパスを指定 - *データベースTLSCAファイル*へのパスを指定 - *データベースTLS証明書ファイル*へのパスを指定 - *データベースホストの検証*をチェック {width="600"} または*/etc/zabbix/web/zabbix.conf.php*で設定： $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/pgsql/root.crt'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = ''; ... #### Frontend To enable encryption with certificate authority verification for connections between Zabbix frontend and the database: - Check *Database TLS encryption* and *Verify database certificate* - Specify path to *Database TLS CA file* {width="600"} Alternatively, this can be set in */etc/zabbix/web/zabbix.conf.php:* ... $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/pgsql/root.crt'; $DB['VERIFY_HOST'] = false; $DB['CIPHER_LIST'] = ''; ... #### フロントエンド Zabbixフロントエンドとデータベース間の接続の認証局検証による暗号化を有効にするには: - *データベースTLS暗号化*と*データベース証明書の確認*をチェック - *データベースTLS CAファイル*へのパスを指定 {width="600"} または、これは*/etc/zabbix/web/zabbix.conf.php:*で設定できます。 ... $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/pgsql/root.crt'; $DB['VERIFY_HOST'] = false; $DB['CIPHER_LIST'] = ''; ... #### Frontend To enable transport-only encryption for connections between Zabbix frontend and the database: - Check *Database TLS encryption* - Leave *Verify database certificate* unchecked {width="600"} #### フロントエンド Zabbixフロントエンドとデータベース間の接続でトランスポートのみの暗号化を有効にするには: - *データベースのTLS暗号化*をチェックします - *データベース証明書の確認*はチェックしません {width="600"} #### Frontend To enable transport-only encryption for connections between Zabbix frontend and the database: - Check *Database TLS encryption* - Leave *Verify database certificate* unchecked {width="600"} #### フロントエンド Zabbixフロントエンドとデータベース間の接続でトランスポートのみの暗号化を有効にするには： - *データベースのTLS暗号化*をチェック - *データベース証明書の確認*をチェックしない {width="600"} #### Function parameters Function parameters allow to specify: - host and item key (functions referencing the host item history only) - function-specific parameters - other expressions (not available for functions referencing the host item history, see [other expressions](#other_expressions) for examples) The host and item key can be specified as `/host/key`. The referenced item must be in a supported state (except for **nodata()** function, which is calculated for unsupported items as well). While other trigger expressions as function parameters are limited to non-history functions in triggers, this limitation does not apply in [calculated items](/manual/config/items/itemtypes/calculated). #### 関数パラメータ 関数パラメータでは、以下の項目を指定できます。 - ホストと item キー(ホストの item history を参照する機能のみ) - 関数固有のパラメータ - その他の式 (ホスト item の history を参照する関数では使用できません。例については [other expressions](#other_expressions) を参照してください) ホストと item のキーは `/host/key` として指定することができます。参照する item はサポートされている状態でなければなりません。<br> （ただし、**nodata()**関数はサポートされていないアイテムについても計算されます） 関数パラメータとしての他の trigger 式は、trigger における非 history 関数に制限されますが、<br> [calculated items](/manual/config/items/itemtypes/calculated)では、この制限は適用されません。<br> ## Functions ## 関数 #### Functions Functions allow to calculate the collected values (average, minimum, maximum, sum), find strings, reference current time and other factors. A complete list of [supported functions](/manual/appendix/functions) is available. Typically functions return numeric values for comparison. When returning strings, comparison is possible with the **=** and **<>** operators (see [example](#example_14)). #### 関数 収集した値の計算（平均、最小、最大、合計）、文字列の検索、現在時刻の参照などを行うことができる関数です。 [supported functions](/manual/appendix/functions)の完全なリストが利用可能です。 通常、関数は比較のために数値を返します。文字列を返す場合、**=** および **<>** 演算子で比較が可能です 。<br> ([example](#example_14) を参照してください) #### Functions Functions can be used at the end of JSONPath. Multiple functions can be chained if the preceding function returns value that is accepted by the following function. Supported functions: |Function|Description|Input|Output| |--|--------|----|----| |`avg`|Average value of numbers in input array.|Array of numbers.|Number.| |`min`|Minimum value of numbers in input array.|Array of numbers.|Number.| |`max`|Maximum value of numbers in input array.|Array of numbers.|Number.| |`sum`|Sum of numbers in input array.|Array of numbers.|Number.| |`length`|Number of elements in input array.|Array.|Number.| |`first`|The first array element.|Array.|A JSON construct (object, array, value) depending on input array contents.| Quoted numeric values are accepted by the JSONPath aggregate functions. It means that the values are converted from string type to numeric if aggregation is required. Incompatible input will cause the function to generate error. #### 関数 関数は JSONPath の最後で使用できます。 前の関数が次の関数によって受け入れられる値を返す場合、複数の関数をチェーンできます。 サポートされている関数: |関数|説明|入力|出力| |--|--------|----|----| |`avg`|入力配列の数値の平均値|数値の配列|数値| |`min`|入力配列の数値の最小値|数値の配列|数値| |`max`|入力配列の数値の最大値|数値の配列|数値| |`sum`|入力配列の数値の合計|数値の配列|数値| |`length`|入力配列の要素数|配列|数値| |`first`|最初の配列要素|配列|入力配列の内容に応じた JSON コンストラクト (オブジェクト、配列、値)| 引用符で囲まれた数値は、JSONPath 集計関数によって受け入れられます。 これは、集計が必要な場合、値が文字列型から数値に変換されることを意味します。 入力に互換性がない場合、関数はエラーを生成します。 #### Function syntax Foreach functions support two common parameters: `item filter` (see details below) and `time period`: foreach_function(item filter,time period) For example: `avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)` will return the five-minute average of each 'mysql.qps' item in the MySQL server group. Note that some functions support additional [parameters](#additional_parameters). #### 関数構文 Foreach functions support two common parameters: `item filter` (see details below) and `time period`: Foreach関数は、`item filter` (詳細は下記を参照) と `time period` という 2 つの共通パラメータをサポートしています。 foreach_function(item filter,time period) 例: `avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)` MySQL サーバー グループ内の各 'mysql.qps' 項目の 5 分間の平均を返します。 一部の関数では追加の [パラメータ](#追加のパラメータ) がサポートされていることに注意してください。 ### Further reading You now know enough to start working with the Zabbix API, but don't stop here. For further reading we suggest you have a look at the [list of available APIs](/manual/api/reference). ### 参考文献 ここまでで Zabbix API を使い始めるのに十分な知識が得られましたが、これが全てではありません。更に詳しく知りたい場合は、[利用可能な API のリスト](/manual/api/reference) を参照することをお勧めします。 #### General #### 全般 #### General advice - monitor required parameters only - tune 'Update interval' for all items. Keeping a small update interval may be good for nice graphs, however, this may overload Zabbix - tune parameters for default templates - tune housekeeping parameters - do not monitor parameters which return the same information. - avoid the use of triggers with long period given as function argument. For example, max(/host/key,1h) will be calculated significantly slower than max(/host/key,1m). #### 一般的なアドバイス - 必要なパラメーターのみを監視する - すべてのアイテムの'更新間隔'を調整する。 短い更新間隔は適切なグラフを作成するのに適している場合もありますが、Zabbixが過負荷になる可能性があります。 - デフォルト テンプレートのパラメーターを調整する - ハウスキーピング パラメータを調整する - 同じ情報を返すパラメータを監視しない - 関数の引数として長い期間が指定されたトリガーの使用は避ける。 たとえばmax(/host/key,1h) は max(/host/key,1m) よりも大幅に遅く計算されます。 #### General attributes The *User* tab contains general user attributes:  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Username*|Unique username, used as the login name.| |*Name*|User first name (optional).<br>If not empty, visible in acknowledgment information and notification recipient information.| |*Last name*|User last name (optional).<br>If not empty, visible in acknowledgment information and notification recipient information.| |*Groups*|Select [user groups](usergroup) the user belongs to. Starting with Zabbix 3.4.3 this field is auto-complete so starting to type the name of a user group will offer a dropdown of matching groups. Scroll down to select. Alternatively, click on *Select* to add groups. Click on 'x' to remove the selected.<br>Adherence to user groups determines what host groups and hosts the user will have [access to](permissions).| |*Password*|Two fields for entering the user password.<br>With an existing password, contains a *Password* button, clicking on which opens the password fields.<br>Note that passwords longer than 72 characters will be truncated.| |*Language*|Language of the Zabbix frontend.<br>The php gettext extension is required for the translations to work.| |*Time zone*|Select the time zone to override global [time zone](/manual/web_interface/time_zone#overview) on user level or select **System default** to use global time zone settings.| |*Theme*|Defines how the frontend looks like:<br>**System default** - use default system settings<br>**Blue** - standard blue theme<br>**Dark** - alternative dark theme<br>**High-contrast light** - light theme with high contrast<br>**High-contrast dark** - dark theme with high contrast| |*Auto-login*|Mark this checkbox to make Zabbix remember the user and log the user in automatically for 30 days. Browser cookies are used for this.| |*Auto-logout*|With this checkbox marked the user will be logged out automatically, after the set amount of seconds (minimum 90 seconds, maximum 1 day).<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 90s, 5m, 2h, 1d.<br>Note that this option will not work:<br>\* If the "Show warning if Zabbix server is down" global configuration option is enabled and Zabbix frontend is kept open;<br>\* When Monitoring menu pages perform background information refreshes;<br>\* If logging in with the *Remember me for 30 days* option checked.| |*Refresh*|Set the refresh rate used for graphs, plain text data, etc. Can be set to 0 to disable.| |*Rows per page*|You can determine how many rows per page will be displayed in lists.| |*URL (after login)*|You can make Zabbix transfer the user to a specific URL after successful login, for example, to Problems page.| #### 一般的な属性 *ユーザー* タブには、一般的なユーザー属性が表示されます:  必須入力項目には、赤いアスタリスクが表示されています。 |パラメータ|説明| |--|--------| |*ユーザー名*|ログイン名として使用される一意のユーザー名| |*名*|ユーザーの名 (オプション)<br>空でない場合、確認情報と通知受信者情報に表示されます。| |*姓*|ユーザーの姓 (オプション)<br>空でない場合、確認情報と通知受信者情報に表示されます。| |*グループ*|ユーザーが属する[ユーザー グループ](usergroup)を選択します。Zabbix 3.4.3 以降では、このフィールドは自動補完されるので、ユーザーグループの名前を入力し始めると、一致するグループのドロップダウンが表示されます。下にスクロールして選択します。または、*選択*をクリックしてグループを追加します。選択を削除するには、「x」をクリックします。<br>ユーザーグループへの準拠によって、ユーザーが[アクセス](permissions)できるホストグループとホストが決まります。| |*パスワード*|ユーザー パスワードを入力するための 2 つのフィールド<br>既存のパスワードがある場合は、*パスワード* ボタンが表示され、これをクリックするとパスワード フィールドが開きます。<br>72 文字を超えるパスワードは切り捨てられることに注意してください。| |*言語*|Zabbix フロントエンドの言語<br>翻訳を機能させるには、php gettext 拡張機能が必要です。| |*タイムゾーン*|ユーザーレベルでグローバル・[タイムゾーン](/manual/web_interface/time_zone#overview)を上書きするタイムゾーンを選択するか、**システムデフォルト**を選択してグローバル・タイムゾーン設定を使用します。| |*テーマ*|フロントエンドの外観を定義します:<br>**システムデフォルト** - デフォルトのシステム設定を使用します<br>**Blue** - standard blue theme<br>**Dark** - alternative dark theme<br>**High-contrast light** - light theme with high contrast<br>**High-contrast dark** - dark theme with high contrast| |*自動ログイン(1ヶ月)*|このチェックボックスをオンにすると、Zabbixはユーザーを記憶し、30日間自動的にログインします。このためにはブラウザの Cookieが使用されます。| |*自動ログアウト*|このチェックボックスをオンにすると、設定された秒数(最小90秒、最大1日)が経過すると、ユーザーは自動的にログアウトされます。<br>[時間のサフィックス](/manual/appendix/suffixes)がサポートされています(例: 90s、5m、2h、1d)。<br>以下の場合このオプションは機能しないことに注意してください:<br>\* *管理→一般設定*の*表示*の「Zabbixサーバー停止時にワーニングを表示」オプションが有効になっていて、Zabbixフロントエンドが開いたままになっている場合<br>\* メニュー*監視データ*配下のページでバックグラウンド情報の更新が実行されている場合<br>\* *30日間記憶する*オプションを有効にしてログインしている場合| |*リフレッシュ*|グラフ、プレーンテキストデータなどに使用する更新レートを設定します。無効にするには0に設定します。| |*ページあたりの表示行数*|ページ毎に表示されるリストの行数を決定できます。| |*ログイン後のURL*|ログイン成功後に、Zabbixでユーザーを特定のURL(問題ページなど)に転送するように設定できます。| #### General Change certain global configuration options. [Autoregistration API](/manual/api/reference/autoregistration) | [Icon map API](/manual/api/reference/iconmap) | [Image API](/manual/api/reference/image) | [User macro API](/manual/api/reference/usermacro) | [Settings API](/manual/api/reference/settings) | [Housekeeping API](/manual/api/reference/housekeeping) #### 一般 特定のグローバル設定オプションを変更します。 [Autoregistration API](/manual/api/reference/autoregistration) | [Icon map API](/manual/api/reference/iconmap) | [Image API](/manual/api/reference/image) | [User macro API](/manual/api/reference/usermacro) | [Settings API](/manual/api/reference/settings) | [Housekeeping API](/manual/api/reference/housekeeping) #### Generate multiple tokens Generate two tokens. Request: ```json { "jsonrpc": "2.0", "method": "token.generate", "params": [ "1", "2" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "tokenid": "1", "token": "bbcfce79a2d95037502f7e9a534906d3466c9a1484beb6ea0f4e7be28e8b8ce2" }, { "tokenid": "2", "token": "fa1258a83d518eabd87698a96bd7f07e5a6ae8aeb8463cae33d50b91dd21bd6d" } ], "id": 0 } ``` #### 複数のトークンを生成 ２個のトークンを生成します Request: ```json { "jsonrpc": "2.0", "method": "token.generate", "params": [ "1", "2" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "tokenid": "1", "token": "bbcfce79a2d95037502f7e9a534906d3466c9a1484beb6ea0f4e7be28e8b8ce2" }, { "tokenid": "2", "token": "fa1258a83d518eabd87698a96bd7f07e5a6ae8aeb8463cae33d50b91dd21bd6d" } ], "id": 0 } ``` ##### Generating from history/trends Graphs can be drawn based on either item [history or trends](/manual/config/items/history_and_trends). For the users who have frontend [debug mode](/manual/web_interface/debug_mode) activated, a gray, vertical caption is displayed at the bottom right of a graph indicating where the data come from. Several factors influence whether history of trends is used: - longevity of item history. For example, item history can be kept for 14 days. In that case, any data older than the fourteen days will be coming from trends. ```{=html} <!-- --> ``` - data congestion in the graph. If the amount of seconds to display in a horizontal graph pixel exceeds 3600/16, trend data are displayed (even if item history is still available for the same period). ```{=html} <!-- --> ``` - if trends are disabled, item history is used for graph building - if available for that period. This is supported starting with Zabbix 2.2.1 (before, disabled trends would mean an empty graph for the period even if item history was available). ##### ヒストリ/トレンドからの生成 グラフは、アイテムの[ヒストリやトレンド](/manual/config/items/history_and_trends)のいずれかに基づいて描画することができます。 フロントエンドの[debug mode](/manual/web_interface/debug_mode)が有効な場合、グラフの右下にグレーの縦長のキャプションが表示され、データの出所を示します。 トレンドのヒストリが使用されるかどうかは、いくつかの要因に影響されます。 - アイテムのヒストリの寿命。例えば、アイテムのヒストリは14日間保持することができます。この場合、14日間より古いデータはトレンドから来ることになります。 ```{=html} <!-- --> ``` - グラフのデータが輻輳しています。横軸のグラフピクセルに表示する秒数が3600/16を超えると、トレンドデータが表示されます(同じ期間のアイテムのヒストリがまだ利用可能であってもです)。 ```{=html} <!-- --> ``` - トレンドが無効の場合、その期間のアイテムのヒストリが利用可能であれば、グラフ作成に使用されます。これは Zabbix2.2.1 からサポートされています(以前はトレンドが無効の場合、アイテムのヒストリが利用可能でもその期間のグラフは空白でした)。 #### Generating PSK For example, a 256-bit (32 bytes) PSK can be generated using the following commands: - with *OpenSSL*: ```{=html} <!-- --> ``` $ openssl rand -hex 32 af8ced32dfe8714e548694e2d29e1a14ba6fa13f216cb35c19d0feb1084b0429 - with *GnuTLS*: ```{=html} <!-- --> ``` $ psktool -u psk_identity -p database.psk -s 32 Generating a random key for user 'psk_identity' Key stored to database.psk $ cat database.psk psk_identity:9b8eafedfaae00cece62e85d5f4792c7d9c9bcc851b23216a1d300311cc4f7cb Note that "psktool" above generates a database file with a PSK identity and its associated PSK. Zabbix expects just a PSK in the PSK file, so the identity string and colon (':') should be removed from the file. #### PSK の生成 たとえば、256 ビット (32 バイト) の PSK は、次のコマンドを使用して生成できます。 - with *OpenSSL*: ```{=html} <!-- --> ``` $ openssl rand -hex 32 af8ced32dfe8714e548694e2d29e1a14ba6fa13f216cb35c19d0feb1084b0429 - with *GnuTLS*: ```{=html} <!-- --> ``` $ psktool -u psk_identity -p database.psk -s 32 Generating a random key for user 'psk_identity' Key stored to database.psk $ cat database.psk psk_identity:9b8eafedfaae00cece62e85d5f4792c7d9c9bcc851b23216a1d300311cc4f7cb 上記の「psktool」は、PSK ID とそれに関連付けられた PSK を含むデータベース ファイルを生成することに注意してください。 Zabbix は PSK ファイルに PSK のみを想定しているため、識別文字列とコロン (':') をファイルから削除する必要があります。 #### - Geographical maps This section allows selecting geographical map tile service provider and configuring service provider settings for the Geomap [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#geomap). To provide visualization using the geographical maps, Zabbix uses open-source JavaScript interactive maps library Leaflet. Please note that Zabbix has no control over the quality of images provided by third-party tile providers, including the predefined tile providers.  |Parameter|Description| |---------|-----------| |Tile provider|Select one of the available tile service providers or select *Other* to add another tile provider or self-hosted tiles (see [Using a custom tile service provider](#using_a_custom_tile_service_provider)).| |Tile URL|The URL template for loading and displaying the tile layer on geographical maps. This field is editable only if *Tile provider* is set to *Other*.<br><br>The following placeholders are supported:<br>*{s}* represents one of the available subdomains;<br>*{z}* represents zoom level parameter in the URL;<br>*{x}* and *{y}* represent tile coordinates;<br>*{r}* can be used to add "\@2x" to the URL to load retina tiles.<br><br>Example: `https://{s}.example.com/{z}/{x}/{y}{r}.png`| |Attribution|Tile provider attribution data to be displayed in a small text box on the map. This field is editable only if *Tile provider* is set to *Other*.| |Max zoom level|Maximum zoom level of the map. This field is editable only if *Tile provider* is set to *Other*.| #### - 地理マップ このセクションでは、地理マップタイルサービスプロバイダーを選択し、Geomap[ダッシュボードウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#geomap)のサービスプロバイダー設定を構成できます。地理マップを使用した視覚化を提供するために、ZabbixはオープンソースのJavaScriptインタラクティブマップライブラリリーフレットを使用します。 Zabbixは、事前定義されたタイルプロバイダーを含むサードパーティのタイルプロバイダーによって提供される画像の品質を制御できないことに注意してください。  |パラメータ|詳細| |---------|-----------| |タイルプロバイダー|使用可能なタイルサービスプロバイダーの1つを選択するか、[その他]を選択して別のタイルプロバイダーまたはセルフホストタイルを追加します（[カスタムタイルサービスプロバイダーの使用](#using_a_custom_tile_service_provider)を参照）| |タイルURL|タイルレイヤーをロードして地理マップに表示するためのURLテンプレート。このフィールドは、*タイルプロバイダー*が*その他*に設定されている場合にのみ編集可能です。<br><br>次のプレースホルダーがサポートされています:<br>*{s}*は使用可能なサブドメインの1つを表します<br>*{z}*はURLのズームレベルパラメータを表します<br>*{x}*と*{y}*はタイル座標を表します<br>*{r}*はURLに"\@2x"を追加し、retinaタイルをロードできます。<br><br>例: `https://{s}.example.com/{z}/{x}/{y}{r}.png`| |帰属表示|マップ上の小さなテキストボックスに表示されるタイルプロバイダーの帰属情報。このフィールドは*タイルプロバイダー*が*その他*に設定されている場合にのみ編集可能です。| |最大ズームレベル|マップの最大ズームレベル。このフィールドは*タイルプロバイダー*が*その他*に設定されている場合にのみ編集可能です。| #### Geomap A new geomap widget for the dashboards has been introduced providing a way to display hosts on geographical maps. For more information see the *Geomap* [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) and [geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical_maps).  #### 地理マップウィジェット ダッシュボードに新しい地理マップウィジェットが導入され、ホストを地理的な地図上に表示できるようになりました。詳しくは*地理マップ*[ダッシュボードウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap)と[地理マップ](/manual/web_interface/frontend_sections/administration/general#geographical_maps)を参照してください。  ##### Geomap widget A new geomap widget for the dashboards has been introduced providing a way to display hosts on geographical maps. For more information see the *Geomap* [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) and [geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical_maps).  #### Host editing as popup The form for host creation and editing is now opened in a modal (popup) window, in *Configuration* → *Hosts*, *Monitoring* → *Hosts* and in any page, where there is a host menu or other direct link to the host configuration. Direct links to the host edit page still work and are opening the host edit page in full page. #### Geomap widget error The maps in the Geomap widget may not load correctly, if you have upgraded from an older Zabbix version with NGINX and didn't switch to the new NGINX configuration file during the upgrade. To fix the issue, you can discard the old configuration file, use the configuration file from 6.0 package and reconfigure it as described in the [download instructions](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql&ws=nginx) in section *e. Configure PHP for Zabbix frontend*. Alternatively, you can manually edit an existing NGINX configuration file (typically, */etc/zabbix/nginx.conf*). To do so, open the file and locate the following block: location ~ /(api\/|conf[^\.]|include|locale|vendor) { deny all; return 404; } Then, replace this block with: location ~ /(api\/|conf[^\.]|include|locale) { deny all; return 404; } location /vendor { deny all; return 404; } #### Geomapウィジェットエラー NGINXを使用して古いバージョンのZabbixからアップグレードし、アップグレード中に新しいNGINX設定ファイルに切り替えなかった場合、Geomapウィジェットの地図が正しく読み込まれないことがあります。 この問題を解決するには、古い設定ファイルを破棄し、6.0パッケージの設定ファイルを使用し、*e. ZabbixフロントエンドのPHPの設定*セクションの[download instructions](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql&ws=nginx)に記載されている方法で再設定することができます。 または、既存のNGINX設定ファイル(通常、*/etc/zabbix/nginx.conf*)を手動で編集することができます。これを行うには、ファイルを開き以下のブロックを探します: location ~ /(api\/|conf[^\.]|include|locale|vendor) { deny all; return 404; } そして、このブロックを次のように置き換えます: location ~ /(api\/|conf[^\.]|include|locale) { deny all; return 404; } location /vendor { deny all; return 404; } #### Get a count of standby nodes Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "countOutput": true, "filter": { "status": 0 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "3", "id": 1 } ``` #### 待機ノード数の取得 リクエスト： ``` {.java} { "jsonrpc": "2.0", "method": "hanode.get", "params": { "countOutput": true, "filter": { "status": 0 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス： ``` {.java} { "jsonrpc": "2.0", "result": "3", "id": 1 } ``` #### Get a list of nodes ordered by status Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "preservekeys": true, "sortfield": "status", "sortorder": "DESC" }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "ckuo7i1nw000h0sajj3l3hh8u": { "ha_nodeid": "ckuo7i1nw000h0sajj3l3hh8u", "name": "node-active", "address": "192.168.1.13", "port": "10051", "lastaccess": "1635335704", "status": "3" }, "ckuo7i1nw000e0sajwfttc1mp": { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" }, "ckuo7i1nv000c0sajz85xcrtt": { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, "ckuo7i1nv000a0saj1fcdkeu4": { "ha_nodeid": "ckuo7i1nv000a0saj1fcdkeu4", "name": "node2", "address": "192.168.1.6", "port": "10051", "lastaccess": "1635335705", "status": "0" } }, "id": 1 } ``` #### ノードのリストを状態順に取得 リクエスト： ``` {.java} { "jsonrpc": "2.0", "method": "hanode.get", "params": { "preservekeys": true, "sortfield": "status", "sortorder": "DESC" }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス： ``` {.java} { "jsonrpc": "2.0", "result": { "ckuo7i1nw000h0sajj3l3hh8u": { "ha_nodeid": "ckuo7i1nw000h0sajj3l3hh8u", "name": "node-active", "address": "192.168.1.13", "port": "10051", "lastaccess": "1635335704", "status": "3" }, "ckuo7i1nw000e0sajwfttc1mp": { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" }, "ckuo7i1nv000c0sajz85xcrtt": { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, "ckuo7i1nv000a0saj1fcdkeu4": { "ha_nodeid": "ckuo7i1nv000a0saj1fcdkeu4", "name": "node2", "address": "192.168.1.6", "port": "10051", "lastaccess": "1635335705", "status": "0" } }, "id": 1 } ``` #### Get a list of specific nodes by their IDs Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "ha_nodeids": ["ckuo7i1nw000e0sajwfttc1mp", "ckuo7i1nv000c0sajz85xcrtt"] }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" } ], "id": 1 } ``` #### 特定のノードのIDによるリストの取得 リクエスト： ``` {.java} { "jsonrpc": "2.0", "method": "hanode.get", "params": { "ha_nodeids": ["ckuo7i1nw000e0sajwfttc1mp", "ckuo7i1nv000c0sajz85xcrtt"] }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス： ``` {.java} { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" } ], "id": 1 } ``` #### Get a list of stopped nodes Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["ha_nodeid", "address", "port"], "filter": { "status": 1 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nw000g0sajjsjre7e3", "address": "192.168.1.12", "port": "10051" }, { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "address": "192.168.1.8", "port": "10052" }, { "ha_nodeid": "ckuo7i1nv000d0sajd95y1b6x", "address": "192.168.1.9", "port": "10053" } ], "id": 1 } ``` #### 停止しているノードのリストを取得 リクエスト： ``` {.java} { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["ha_nodeid", "address", "port"], "filter": { "status": 1 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` レスポンス： ``` {.java} { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nw000g0sajjsjre7e3", "address": "192.168.1.12", "port": "10051" }, { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "address": "192.168.1.8", "port": "10052" }, { "ha_nodeid": "ckuo7i1nv000d0sajd95y1b6x", "address": "192.168.1.9", "port": "10053" } ], "id": 1 } ``` #### Getting Java gateway You can install Java gateway either from the sources or packages downloaded from [Zabbix website](http://www.zabbix.com/download.php). Using the links below you can access information how to get and run Zabbix Java gateway, how to configure Zabbix server (or Zabbix proxy) to use Zabbix Java gateway for JMX monitoring, and how to configure Zabbix items in Zabbix frontend that correspond to particular JMX counters. |Installation from|Instructions|Instructions| |-----------------|------------|------------| |*Sources*|[Installation](/manual/installation/install#installing_java_gateway)|[Setup](/manual/concepts/java/from_sources)| |*RHEL packages*|[Installation](/manual/installation/install_from_packages/rhel#java_gateway_installation)|[Setup](/manual/concepts/java/from_rhel)| |*Debian/Ubuntu packages*|[Installation](/manual/installation/install_from_packages/debian_ubuntu#java_gateway_installation)|[Setup](/manual/concepts/java/from_debian_ubuntu)| #### Javaゲートウェイの取得 [Zabbix Webサイト](http://www.zabbix.com/download.php)からダウンロードしたソースまたはパッケージから Javaゲートウェイをインストールできます。 以下のリンクを使用すると、Zabbix Javaゲートウェイを取得して実行する方法、JMX監視にZabbix Javaゲートウェイを使用するように Zabbixサーバー(またはZabbixプロキシ)を設定する方法、および特定のJMXカウンターに対応するZabbix WebインターフェースでZabbixアイテムを設定する方法に関する情報にアクセスできます。 |インストール元|手順|手順| |-----------------|------------|------------| |*ソース*|[インストール](/manual/installation/install#Javaゲートウェイのインストール)|[セットアップ](/manual/concepts/java/from_sources)| |*RHELパッケージ*|[インストール](/manual/installation/install_from_packages/rhel#Javaゲートウェイのインストール)|[セットアップ](/manual/concepts/java/from_rhel)| |*Debian/Ubuntuパッケージ*|[インストール](/manual/installation/install_from_packages/debian_ubuntu#Javaゲートウェイのインストール)|[セットアップ](/manual/concepts/java/from_debian_ubuntu)| #### Global event correlation Events may not get correlated correctly if the time interval between the first and second event is very small, i.e. half a second and less. #### グローバルイベント相関 最初のイベントと2番目のイベントの時間間隔が非常に小さい場合(0.5秒以下)、イベントは正しく相関しないことがあります。 ##### Global messages displayed As the messages arrive, they are displayed in a floating section on the right hand side. This section can be repositioned freely by dragging the section header.  For this section, several controls are available: -  **Snooze** button silences the currently active alarm sound; -  **Mute/Unmute** button switches between playing and not playing the alarm sounds at all. ##### 表示されるグローバルメッセージ メッセージが到着すると、右側のフローティングセクションに表示されます。このセクションは、セクションヘッダーをドラッグすることで自由に再配置できます。  このセクションでは、いくつかのコントロールを使用できます。 - **スヌーズ**ボタンは、現在アクティブなアラーム音を消音します。 - **ミュート/ミュート解除**ボタンは、アラーム音の再生と非再生を切り替えます。 ### Go library for Windows updated Go library used by Zabbix agent 2 in conjunction with MongoDB or PostgreSQL plugins to monitor Windows now is `github.com/Microsoft/go-winio`, version 0.6.0 (previously `github.com/natefinch/npipe`). See also [Agent 2 requirements](/manual/installation/requirements#agent-2). ### Windows用Go言語ライブラリの更新 Zabbixエージェント2でWindowsを監視するために、MongoDBやPostgreSQLプラグインとともに使用されているGo言語ライブラリは、`github.com/Microsoft/go-winio`、バージョン0.6.0です (以前は`github.com/natefinch/npipe`)。 [エージェント2の要件](/manual/installation/requirements#agent-2)も参照してください。 ### Google Cloud Platform Monitoring 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). You can get this template: - In *Configuration → Templates* in new installations. - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). ### Googleクラウドプラットホーム監視 新しい[テンプレート](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)を参照してください。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 # graph.create # graph.create # graph.delete # graph.delete # graph.get # graph.get # graphitem.get # graphitem.get ### Graph item ::: noteclassic Graph items can only be modified via the `graph` API. ::: The graph item object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitemid|string|*(readonly)* ID of the graph item.| |**color**<br>(required)|string|Graph item's draw color as a hexadecimal color code.| |**itemid**<br>(required)|string|ID of the item.| |calc\_fnc|integer|Value of the item that will be displayed.<br><br>Possible values:<br>1 - minimum value;<br>2 - *(default)* average value;<br>4 - maximum value;<br>7 - all values;<br>9 - last value, used only by pie and exploded graphs.| |drawtype|integer|Draw style of the graph item.<br><br>Possible values:<br>0 - *(default)* line;<br>1 - filled region;<br>2 - bold line;<br>3 - dot;<br>4 - dashed line;<br>5 - gradient line.| |graphid|string|ID of the graph that the graph item belongs to.| |sortorder|integer|Position of the item in the graph.<br><br>Default: starts with 0 and increases by one with each entry.| |type|integer|Type of graph item.<br><br>Possible values:<br>0 - *(default)* simple;<br>2 - graph sum, used only by pie and exploded graphs.| |yaxisside|integer|Side of the graph where the graph item's Y scale will be drawn.<br><br>Possible values:<br>0 - *(default)* left side;<br>1 - right side.| ### Graph item ::: noteclassic グラフアイテムは `graph` API を介してのみ変更することができる。 ::: グラフアイテムオブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |gitemid|string|*(readonly)* ID of the graph item.| |**color**<br>(required)|string|Graph item's draw color as a hexadecimal color code.| |**itemid**<br>(required)|string|ID of the item.| |calc\_fnc|integer|Value of the item that will be displayed.<br><br>Possible values:<br>1 - minimum value;<br>2 - *(default)* average value;<br>4 - maximum value;<br>7 - all values;<br>9 - last value, used only by pie and exploded graphs.| |drawtype|integer|Draw style of the graph item.<br><br>Possible values:<br>0 - *(default)* line;<br>1 - filled region;<br>2 - bold line;<br>3 - dot;<br>4 - dashed line;<br>5 - gradient line.| |graphid|string|ID of the graph that the graph item belongs to.| |sortorder|integer|Position of the item in the graph.<br><br>Default: starts with 0 and increases by one with each entry.| |type|integer|Type of graph item.<br><br>Possible values:<br>0 - *(default)* simple;<br>2 - graph sum, used only by pie and exploded graphs.| |yaxisside|integer|Side of the graph where the graph item's Y scale will be drawn.<br><br>Possible values:<br>0 - *(default)* left side;<br>1 - right side.| # graphprototype.create # graphprototype.create # graphprototype.delete # graphprototype.delete # graphprototype.get # graphprototype.get #### Graph prototypes The following screenshot illustrates how we can use these macros in graph prototypes:   A summary of our discovery rule:  #### グラフのプロトタイプ 次のスクリーンショットは、グラフのプロトタイプでこれらのマクロを使用する方法を示しています。   ディスカバリルールの概要：  ### Graph prototype The graph prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|string|*(readonly)* ID of the graph prototype.| |**height**<br>(required)|integer|Height of the graph prototype in pixels.| |**name**<br>(required)|string|Name of the graph prototype.| |**width**<br>(required)|integer|Width of the graph prototype in pixels.| |graphtype|integer|Graph prototypes's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show discovered pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|string|*(readonly)* ID of the parent template graph prototype.| |yaxismax|float|The fixed maximum value for the Y axis.| |yaxismin|float|The fixed minimum value for the Y axis.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymin\_type would be set to '0' (calculated).| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |discover|integer|Graph prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new graphs will be discovered;<br>1 - new graphs will not be discovered and existing graphs will be marked as lost.| |uuid|string|Universal unique identifier, used for linking imported graph prototypes to already existing ones. Used only for graph prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| ### Graph prototype graph prototype オブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |graphid|string|*(読取専用)* グラフプロトタイプID| |**height**<br>(必須)|integer|グラフ プロトタイプの高さ (ピクセル単位)| |**name**<br>(必須)|string|グラフプロトタイプ名| |**width**<br>(必須)|integer|グラフ プロトタイプの幅 (ピクセル単位)| |graphtype|integer|グラフ プロトタイプのレイアウトタイプ<br><br>使用可能な値:<br>0 - *(デフォルト)* ノーマル<br>1 - 積算グラフ<br>2 - 円グラフ<br>3 - 分解円グラフ| |percent\_left|float|左パーセンタイルライン<br><br>デフォルト: 0| |percent\_right|float|右パーセンタイルライン<br><br>デフォルト: 0.| |show\_3d|integer|ディスカバリされた円グラフと分解円グラフを 3D で表示するか<br><br>使用可能な値:<br>0 - *(デフォルト)* 2D表示<br>1 - 3D表示| |show\_legend|integer|ディスカバリされたグラフに凡例を表示するか<br><br>使用可能な値:<br>0 - 非表示<br>1 - *(デフォルト)* 表示| |show\_work\_period|integer|ディスカバリされたグラフにワーキングタイムを表示するか<br><br>使用可能な値:<br>0 - 非表示<br>1 - *(デフォルト)* 表示| |templateid|string|*(読取専用)* 親テンプレートグラフプロトタイプの ID| |yaxismax|float|Y 軸の固定最大値| |yaxismin|float|Y 軸の固定最小値| |ymax\_itemid|string|Y 軸の最大値として使用されるアイテムのID<br><br>Zabbix 6.0.7以降、ユーザーが特定のアイテムにアクセスできない場合、グラフはymax\_type が '0' (計算済み) に設定されるようにレンダリングされます。| |ymax\_type|integer|Y 軸の最大値計算方法<br><br>使用可能な値:<br>0 - *(デフォルト)* 計算<br>1 - 固定<br>2 - アイテム| |ymin\_itemid|string|Y 軸の最小値として使用されるアイテムのID<br><br>Zabbix 6.0.7以降、ユーザーが特定のアイテムにアクセスできない場合、グラフはymin\_type が '0' (計算済み) に設定されるようにレンダリングされます。| |ymin\_type|integer|Y 軸の最小値計算方法<br><br>使用可能な値:<br>0 - *(デフォルト)* 計算<br>1 - 固定<br>2 - アイテム| |discover|integer|グラフプロトタイプのディスカバリステータス。<br><br>使用可能な値:<br>0 - *(デフォルト)* 新しいグラフが検出されます。<br>1 - 新しいグラフは検出されず、既存のグラフは失われたものとしてマークされます。| |uuid|string|インポートされたグラフ プロトタイプを既存のものにリンクするために使用されるユニバーサル一意識別子。 テンプレートのグラフ プロトタイプにのみ使用されます。 指定されていない場合は自動生成されます。<br><br>更新操作の場合、このフィールドは *読み取り専用* です。| # graphprototype.update # graphprototype.update #### Graphs ##### Daylight Saving Time Changes to Daylight Saving Time (DST) result in irregularities when displaying X axis labels (date duplication, date missing, etc.). ##### Sum aggregation When using [sum aggregation](/manual/config/visualization/graphs/aggregate#configuration) in a graph for period that is less than one hour, graphs display incorrect (multiplied) values when data come from trends. ##### Text overlapping For some frontend languages (e.g., Japanese), local fonts can cause text overlapping in graph legend. To avoid this, use version 2.3.0 (or later) of PHP GD extension. #### グラフ ##### 夏時間 夏時間(DST)への変更により、X軸ラベルの表示が不規則になります (日付の重複、日付の欠落など)。 ##### 合計集計 1時間未満の期間のグラフで[合計集計](/manual/config/visualization/graphs/aggregate#configuration)を使用すると、データがトレンドから取得されたときに、グラフに誤った(乗算された)値が表示されます。 ##### テキストの重なり 一部のフロントエンド言語(日本語など)の場合、ローカルフォントはグラフ凡例でテキストが重なる可能性があります。これを避けるために、PHP GD拡張のバージョン2.3.0(以降)を使用します。 #### Graphs Edit graphs or separate graph items for better presentation of the gathered data. [Graph API](/manual/api/reference/graph) | [Graph item API](/manual/api/reference/graphitem) #### グラフ 収集したデータを見やすくするために、グラフを編集したり、グラフの item を分けたりすることができます。 [Graph API](/manual/api/reference/graph) | [Graph item API](/manual/api/reference/graphitem) ##### Graphs With the item working for a while, it might be time to see something visual. [Simple graphs](/manual/config/visualization/graphs/simple) are available for any monitored numeric item without any additional configuration. These graphs are generated on runtime. To view the graph, go to *Monitoring → Latest data* and click on the 'Graph' link next to the item. {width="600"} ##### グラフ アイテムがしばらくの間実行されてるのなら、その様子を視覚的に確認することが出来るかもしれません。[シンプルグラフ](/manual/config/visualization/graphs/simple)は監視してる全ての数値アイテムに対し、追加の設定なしに利用できます。これらのグラフは実行時に生成されます。 グラフを見るには、*監視データ → 最新データ*に移動し、アイテムの横にある'グラフ'のリンクをクリックします。 {width="600"} ### Graph The graph object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|string|*(readonly)* ID of the graph.| |**height**<br>(required)|integer|Height of the graph in pixels.| |**name**<br>(required)|string|Name of the graph| |**width**<br>(required)|integer|Width of the graph in pixels.| |flags|integer|*(readonly)* Origin of the graph.<br><br>Possible values are:<br>0 - *(default)* a plain graph;<br>4 - a discovered graph.| |graphtype|integer|Graph's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_triggers|integer|Whether to show the trigger line on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|string|*(readonly)* ID of the parent template graph.| |yaxismax|float|The fixed maximum value for the Y axis.<br><br>Default: 100.| |yaxismin|float|The fixed minimum value for the Y axis.<br><br>Default: 0.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |uuid|string|Universal unique identifier, used for linking imported graphs to already existing ones. Used only for graphs on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| ### Graph Graph グラフオブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |graphid|string|*(読取専用)* グラフID| |**height**<br>(必須)|integer|グラフの高さ (ピクセル単位)| |**name**<br>(必須)|string|グラフ名| |**width**<br>(必須)|integer|グラフの幅 (ピクセル単位)| |flags|integer|*(読取専用)* グラフの元<br><br>使用可能な値:<br>0 - *(デフォルト)*プレーン グラフ<br>4 - ディスカバリされたグラフ| |graphtype|integer|グラフのレイアウト タイプ<br><br>使用可能な値:<br>0 - *(デフォルト)* 通常<br>1 - 積み上げ<br>2 - 円<br>3 - 分解円| |percent\_left|float|左パーセンタイル<br><br>デフォルト: 0| |percent\_right|float|右パーセンタイル<br><br>デフォルト: 0| |show\_3d|integer|円グラフと分解円グラフを 3Dで表示するか<br><br>可能な値:<br>0 - *(デフォルト)* 2D で表示<br>1 - 3D で表示| |show\_legend|integer|グラフに凡例を表示するか<br><br>使用可能な値:<br>0 - 非表示<br>1 - *(デフォルト)* 表示| |show\_work\_period|integer|グラフに作業時間を表示するか<br><br>使用可能な値:<br>0 - 非表示<br>1 - *(デフォルト)* 表示| |show\_triggers|integer|グラフにトリガーラインを表示するか<br><br>使用可能な値:<br>0 - 非表示<br>1 - *(デフォルト)* 表示| |templateid|string|*(読取専用)* 親テンプレート グラフのID| |yaxismax|float|Y 軸の固定最大値<br><br>デフォルト: 100| |yaxismin|float|Y 軸の固定最小値<br><br>デフォルト: 0| |ymax\_itemid|string|Y 軸の最大値として使用されるアイテムの ID| |ymax\_type|integer|Y 軸の最大値計算方法<br><br>使用可能な値:<br>0 - *(デフォルト)* 計算<br>1 - 固定<br>2 - アイテム| |ymin\_itemid|string|Y 軸の最小値として使用されるアイテムの ID| |ymin\_type|integer|Y 軸の最小値計算方法<br><br>使用可能な値:<br>0 - *(デフォルト)* 計算<br>1 - 固定<br>2 - アイテム| |uuid|string|インポートされたグラフを既存のグラフにリンクするために使用されるユニバーサル一意識別子。 テンプレートのグラフにのみ使用されます。 指定されていない場合は自動生成されます。<br><br>更新操作の場合、このフィールドは *読み取り専用* です。| # graph.update # graph.update ### Group link The group link object links a host prototype with a host group and has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupid**<br>(required)|string|ID of the host group.| ### Group link group linkオブジェクトは、ホストプロトタイプをホストグループにリンクし、次のプロパティを持ちます。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**groupid**<br>(必須)|string|ホストグループのID。| ### Group prototype The group prototype object defines a group that will be created for a discovered host and has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |group\_prototypeid|string|*(readonly)* ID of the group prototype.| |**name**<br>(required)|string|Name of the group prototype.| |hostid|string|*(readonly)* ID of the host prototype| |templateid|string|*(readonly)* ID of the parent template group prototype.| ### Group prototype グループプロトタイプオブジェクトは、検出されたホスト用に作成されるグループを設定し、次のプロパティを持ちます。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |group\_prototypeid|string|*（読み取り専用）*グループプロトタイプのID| |**name**<br>(必須)|string|グループプロトタイプの名前| |hostid|string|*（読み取り専用）*ホストプロトタイプのID| |templateid|string|*（読み取り専用）*親テンプレートグループのプロトタイプのID。| #### groups/group |Parameter|Type|Description|Details| |---------|----|-----------|-------| |name|*string*|Group name.| | #### groups/group |パラメーター|タイプ|説明|詳細| |---------|----|-----------|-------| |name|*文字列*|グループ名| | #### GSM modem validation for SMS media type In SMS media type configuration, the GSM modem path is now validated to be a modem device or symlink to such. #### SMSメディアタイプのGSMモデム検証 SMSメディアタイプ構成で、GSMモデムパスがモデムデバイスまたはそのようなデバイスへのシンボリックリンクとして検証されるようになりました。 #### Guest user authorization Automatic login for the guest user has been removed. After this change, the guest user will need to log in like any other user. Previously, a guest could immediately get to almost any monitoring or reporting page without going through authorization. #### ゲストユーザーの認証 ゲストユーザーの自動ログインは削除されました。 この変更後、ゲストユーザーは他のユーザーと同様にログインする必要があります。 以前のゲストは承認が必要なくすぐに、ほぼすべての監視やレポートのページにアクセスできました。 #### GUI debugging Problems related to the frontend performance may be diagnosed using the frontend [debug mode](/manual/web_interface/debug_mode). #### GUI デバッグ フロントエンドのパフォーマンスに関連する問題は、フロントエンド [デバッグ モード](/manual/web_interface/debug_mode) を使用して診断できます。 ### Handling of NaN values in Prometheus preprocessing There is a new behavior for handling (skipping) NaN values. So, if a dataset consists of valid numeric values and NaNs, then NaN values are skipped and: - 'avg', 'max', 'min', 'sum' return a result that is calculated from the valid values - 'count' returns the number of valid values If all values in a dataset are NaNs then 'avg', 'max', 'min', and 'sum' return a "no data (at least one value is required)" error, while 'count' returns 0. Previously, if NaN was the first value in a dataset then: - 'avg', 'max', 'min', 'sum' returned a "Value "NAN" of type "string" is not suitable for \ value type "Numeric (float)"" error - 'count' returned the number of values (including NaN values) Also previously, if NaN was not the first value in a dataset then: - 'avg', 'sum' returned a "Value "NAN" of type "string" is not suitable for \ value type "Numeric (float)"" error - 'max' returned the maximum of values until the first NaN was encountered - 'min' returned the minimum of values until the first NaN was encountered - 'count' returned the number of values (including NaN values) ### Prometheusの保存前処理におけるNaN値の取り扱いについて NaN値を扱う（スキップする）ための新しい動作があります。 つまり、データセットが有効な数値とNaNで構成されている場合、NaN値はスキップされ、以下のようになります。 - 'avg', 'max', 'min', 'sum' は有効な値から計算された結果を戻します。 - 'count' は有効な値の数を戻します。 データセット内の全ての値がNaNの場合、'avg', 'max', 'min', 'sum' は ”「データなし」(少なくとも1つの値が必要) "のエラーを返し、'count'は0を戻します。 以前は、NaNがデータセットの最初の値であった場合、次のように振舞いました。 <br> - avg', 'max', 'min', 'sum' は "Value "NAN" of type "string" is not suitable for value type ”Numeric (float)" error" というエラーを戻していました。 - countは値の数(NaNを含む)を戻していました。 - また、以前はNaNがデータセットの最初の値でない場合、 - 'avg', 'sum' は "Value "NAN" of type "string" is not suitable for value type "Numeric (float) " というエラーを戻していました。 - 'max' は最初のNaNが発生するまでの値の最大値を戻していました。 - 'min' は最初のNaNが発生するまでの値の最小値を戻していました。 - 'count' は NaN を含む値の個数を戻していました。 #### Handling of regular expression compilation and runtime errors If a regular expression used in `log[]`, `logrt[]`, `log.count[]` or `logrt.count[]` item cannot be compiled by PCRE or PCRE2 library then the item goes into NOTSUPPORTED state with an error message. To continue monitoring the log item, the regular expression should be fixed. If the regular expression compiles successfully, but fails at runtime (on some or on all log records), then the log item remains supported and monitoring continues. The runtime error is logged in the Zabbix agent log file (without the log file record). Note that the logging of regular expression runtime errors is supported since Zabbix 6.0.21. The logging rate is limited to one runtime error per check to allow Zabbix agent to monitor its own log file. For example, if 10 records are analyzed and 3 records fail with a regexp runtime error, one record is produced in the agent log. Exception: if MaxLinesPerSecond=1 and update interval=1 (only 1 record is allowed to analyze per check) then regexp runtime errors are not logged. zabbix_agentd logs the item key in case of a runtime error, zabbix_agent2 logs the item ID to help identify which log item has runtime errors. It is recommended to redesign the regular expression in case of runtime errors. #### 正規表現のコンパイルおよび実行時エラーの処理 `log[]`、`logrt[]`、`log.count[]`、または `logrt.count[]` アイテムで使用されている正規表現が PCRE または PCRE2 ライブラリでコンパイルできない場合、アイテムは NOTSUPPORTED 状態になり、エラーメッセージが表示されます。ログアイテムの監視を継続するには、正規表現を修正する必要があります。 正規表現のコンパイルは成功したものの、実行時に（一部またはすべてのログレコードで）失敗した場合、ログアイテムは引き続きサポートされ、監視は継続されます。実行時エラーは Zabbix エージェントのログファイルに記録されます（ログファイルレコードは記録されません）。 正規表現の実行時エラーのログ記録は、Zabbix 6.0.21 以降でサポートされています。 Zabbix エージェントが独自のログファイルを監視できるように、ログ記録レートはチェックごとに 1 つの実行時エラーに制限されています。例えば、10 件のレコードを分析し、そのうち 3 件のレコードが正規表現の実行時エラーで失敗した場合、エージェントログには 1 つのレコードが生成されます。 例外: MaxLinesPerSecond=1 かつ update interval=1（1回のチェックで1レコードのみ分析可能）の場合、正規表現によるランタイムエラーはログに記録されません。 zabbix_agentd はランタイムエラー発生時にアイテムキーをログに記録し、zabbix_agent2 はどのログアイテムにランタイムエラーが発生したかを特定するためにアイテムIDをログに記録します。ランタイムエラー発生時の正規表現を再設計することをお勧めします。 # hanode.get # hanode.get ##### Hardcoded defaults If a parameter required for authentication is not provided in an item key or in the named session parameters, the plugin will use a hardcoded default value. ##### ハードコードされたデフォルト値 認証に必要なパラメータが item キーや名前付きセッションパラメータで提供されない場合、プラグインはハードコードされた<br> デフォルト値を使用します。 #### Hardware #### ハードウェア要件 #### Hardware General advice on hardware: - Use fastest processor available - SCSI or SAS is better than IDE (performance of IDE disks may be significantly improved by using utility hdparm) and SATA - 15K RPM is better than 10K RPM which is better than 7200 RPM - Use fast RAID storage - Use fast Ethernet adapter - Having more memory is always better #### ハードウェア ハードウェアに関する一般的なアドバイス: - 利用可能な最速のプロセッサーを使用する - SCSI または SAS は、IDE (hdparmユーティリティを使用すると、IDE ディスクのパフォーマンスが大幅に向上する可能性があります) および SATA よりも優れています。 - 15K RPM は 10K RPM よりも優れており、7200 RPM よりも優れています。 - 高速 RAID ストレージを使用する - 高速なイーサネット アダプタを使用する - より多くのメモリを持つことは良いことです **ha\_remove\_node**\[=*target*\] Remove the high availability (HA) node specified by its name or ID. Note that active/standby nodes cannot be removed. **ha\_set\_failover\_delay**\[=*delay*\] Set high availability (HA) failover delay. Time suffixes are supported, e.g. 10s, 1m. **secrets\_reload** Reload secrets from Vault. **service\_cache\_reload** Reload the service manager cache. **prof\_enable**\[=*target*\] Enable profiling. Affects all processes if target is not specified. Enabled profiling provides details of all rwlocks/mutexes by function name. Supported since Zabbix 6.0.13. **prof\_disable**\[=*target*\] Disable profiling. Affects all processes if target is not specified. Supported since Zabbix 6.0.13. **log\_level\_increase**\[=*target*\] Increase log level, affects all processes if target is not specified **log\_level\_decrease**\[=*target*\] Decrease log level, affects all processes if target is not specified [ ]{#lbAG} **ha\_remove\_node**\[=*target*\] 名前またはIDで指定された高可用性(HA)ノードを削除します。 アクティブ/スタンバイ状態のノードは削除できません。 **ha\_set\_failover\_delay**\[=*delay*\] 高可用性(HA)フェールオーバーの遅延時間を設定します。 時刻サフィックスがサポートされています。 例: 10s、1m。 **secrets\_reload** Vaultからシークレットをリロードします。 **service\_cache\_reload** サービスマネージャーのキャッシュをリロードします。 **prof\_enable**\[=*target*\] プロファイリングを有効にします。 ターゲットが指定されていない場合、すべてのプロセスに影響します。 プロファイリングを有効にすると、関数名からすべてのrwlocks/mutexesの詳細を見ることができます。 Zabbix 6.0.13以降でサポートされています。 **prof\_disable**\[=*target*\] プロファイリングを無効にします。 ターゲットが指定されていない場合、すべてのプロセスに影響します。 Zabbix 6.0.13以降でサポートされています。 **log\_level\_increase**\[=*target*\] ログレベルを上げます。ターゲットが指定されていない場合、すべてのプロセスに影響します。 **log\_level\_decrease**\[=*target*\] ログレベルを下げます。ターゲットが指定されていない場合、すべてのプロセスに影響します。 [ ]{#lbAG} #### Header processing The CSV file header line can be processed in two different ways: - If the *With header row* checkbox is marked - header line values are interpreted as column names. In this case the column names must be unique and the data row should not contain more columns than the header row; - If the *With header row* checkbox is not marked - the header line is interpreted as data. Column names are generated automatically (1,2,3,4...) CSV file example: Nr,Item name,Key,Qty 1,active agent item,agent.hostname,33 "2","passive agent item","agent.version","44" 3,"active,passive agent items",agent.ping,55 ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. ::: **Processing header line** JSON output when a header line is expected: ``` {.json} [ { "Nr":"1", "Item name":"active agent item", "Key":"agent.hostname", "Qty":"33" }, { "Nr":"2", "Item name":"passive agent item", "Key":"agent.version", "Qty":"44" }, { "Nr":"3", "Item name":"active,passive agent items", "Key":"agent.ping", "Qty":"55" } ] ``` **No header line processing** JSON output when a header line is not expected: ``` {.json} [ { "1":"Nr", "2":"Item name", "3":"Key", "4":"Qty" }, { "1":"1", "2":"active agent item", "3":"agent.hostname", "4":"33" }, { "1":"2", "2":"passive agent item", "3":"agent.version", "4":"44" }, { "1":"3", "2":"active,passive agent items", "3":"agent.ping", "4":"55" } ] ``` #### ヘッダー処理 CSVファイルのヘッダー行は、2種類の方法で処理することができます。 - *ヘッダ行を含む*チェックボックスがチェックされている場合 - ヘッダー行の値はカラム名として解釈されます。この場合、カラム名は一意でなければならず、データ行はヘッダー行より多くのカラムを含んではなりません。 - *ヘッダ行を含む*チェックボックスがチェックされていない場合 - ヘッダー行はデータとして解釈されます。カラム名は自動的に生成されます(1,2,3,4...)。 CSVファイルの例: Nr,Item name,Key,Qty 1,active agent item,agent.hostname,33 "2","passive agent item","agent.version","44" 3,"active,passive agent items",agent.ping,55 ::: noteclassic 入力の引用フィールド内の引用文字は、その前に別の引用文字を置くことでエスケープしなければいけません。 ::: **ヘッダー行の処理** ヘッダー行が検出される場合のJSON出力: ``` {.json} [ { "Nr":"1", "Item name":"active agent item", "Key":"agent.hostname", "Qty":"33" }, { "Nr":"2", "Item name":"passive agent item", "Key":"agent.version", "Qty":"44" }, { "Nr":"3", "Item name":"active,passive agent items", "Key":"agent.ping", "Qty":"55" } ] ``` **ヘッダー行の処理なし** ヘッダー行が検出できない場合のJSON出力: ``` {.json} [ { "1":"Nr", "2":"Item name", "3":"Key" "4":"Qty" }, { "1":"1", "2":"active agent item", "3":"agent.hostname" "4":"33" }, { "1":"2", "2":"passive agent item", "3":"agent.version" "4":"44" }, { "1":"3", "2":"active,passive agent items", "3":"agent.ping" "4":"55" } ] ``` ##### Hidden menu Even when the menu is hidden completely, a full menu is just one mouse click away, by clicking on the burger icon. Note that it reappears over page content; to move page content to the right you have to unhide the menu by clicking on the show sidebar button. ##### メニュー非表示 メニューが完全に非表示になっている場合でも、ハンバーガーアイコンを一回クリックするだけで完全なメニューを表示できます。ページコンテンツの上に再表示されることに注意してください。ページコンテンツを右に移動するには、サイドバーの表示ボタンをクリックしてメニューを再表示する必要があります。 #### Hiding the file with list of common passwords To increase the complexity of password brute force attacks, it is suggested to limit access to the file `ui/data/top_passwords.txt` by modifying web server configuration. This file contains a list of the most common and context-specific passwords, and is used to prevent users from setting such passwords if *Avoid easy-to-guess passwords* parameter is enabled in the [password policy](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication). For example, on NGINX file access can be limited by using the `location` directive: ```ini location = /data/top_passwords.txt { deny all; return 404; } ``` On Apache - by using `.htaccess` file: ```ini <Files "top_passwords.txt"> Order Allow,Deny Deny from all </Files> ``` #### 一般的なパスワードリストのファイルを非表示にする パスワードのブルートフォース攻撃の複雑さを増すために、Webサーバーの設定を変更してファイル`ui/data/top_passwords.txt`へのアクセスを制限することをお勧めします。 このファイルには、最も一般的なパスワードとコンテキスト固有のパスワードのリストが含まれており、[パスワードポリシー](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication)で *推測されやすいパスワードを避ける*パラメーターが有効になっている場合に、ユーザーがそのようなパスワードを設定できないようにするために使用されます。 たとえばNGINXでは、`location`ディレクティブを使用してファイルアクセスを制限できます。 ```ini location = /data/top_passwords.txt { deny all; return 404; } ``` Apacheの場合は`.htaccess`ファイルを使用します。 ```ini <Files "top_passwords.txt"> Order Allow,Deny Deny from all </Files> ``` #### Hiding the file with list of common passwords To increase the complexity of password brute force attacks, it is suggested to limit access to the file `ui/data/top_passwords.txt` by modifying web server configuration. This file contains a list of the most common and context-specific passwords, and is used to prevent users from setting such passwords if *Avoid easy-to-guess passwords* parameter is enabled in the [password policy](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication). For example, on NGINX file access can be limited by using the `location` directive: location = /data/top_passwords.txt {​​​​​​​ deny all; return 404; }​​​​​​​ On Apache - by using `.htacess` file: <Files "top_passwords.txt"> Order Allow,Deny Deny from all </Files> ​ #### Hiding the file with list of common passwords To increase the complexity of password brute force attacks, it is suggested to limit access to the file `ui/data/top_passwords.txt` by modifying web server configuration. This file contains a list of the most common and context-specific passwords, and is used to prevent users from setting such passwords if *Avoid easy-to-guess passwords* parameter is enabled in the [password policy](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication). For example, on NGINX file access can be limited by using the `location` directive: location = /data/top_passwords.txt {​​​​​​​ deny all; return 404; }​​​​​​​ On Apache - by using `.htacess` file: <Files "top_passwords.txt"> Order Allow,Deny Deny from all </Files> ​ #### High availability cluster for Zabbix server The new version comes with a native high availability solution for Zabbix server. The solution consists of multiple zabbix\_server instances or nodes, where only one node can be active (working) at a time, while other nodes are on standby, ready to take over in case the current node is stopped or fails. See also: [High availability cluster](/manual/concepts/server/ha). #### Zabbixサーバの高可用性(HA)クラスタリング 新バージョンでは、Zabbixサーバの高可用性ソリューションをネイティブで提供します。 このソリューションは、複数のzabbix\_serverインスタンスまたはノードで構成されます。一度にアクティブ(現用ノード)にできるのは1ノードのみで他のノードはスタンバイ状態にあり、現用ノードの停止や障害発生時にスタンバイノードに引き継ぐことができます。 参照: [高可用性(HA)クラスタリング](/manual/concepts/server/ha) #### High availability cluster Retrieve a list of server nodes and their status. [High availability cluster API](/manual/api/reference/hanode) #### 高可用性(HA)クラスタ サーバノードとそのステータスの一覧を取得します。 [High availability cluster API](/manual/api/reference/hanode) ### High availability node ::: noteclassic Nodes are created by the Zabbix server and cannot be modified via the API. ::: The High availability node object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |ha\_nodeid|string|ID of the node.| |name|string|Name assigned to the node, using the HANodeName configuration entry of zabbix\_server.conf. Empty for a server running in standalone mode.| |address|string|IP or DNS name where the node connects from.| |port|integer|Port on which the node is running.| |lastaccess|integer|Heartbeat time, t.i. time of last update from the node. UTC timestamp.| |status|integer|State of the node.<br><br>Possible values:<br>0 - standby;<br>1 - stopped manually;<br>2 - unavailable;<br>3 - active.| ### High availability node ::: noteclassic ノードは Zabbix server によって作成され、API から変更することはできません。 ::: High availability node object は、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |ha\_nodeid|string|ID of the node.| |name|string|Name assigned to the node, using the HANodeName configuration entry of zabbix\_server.conf. Empty for a server running in standalone mode.| |address|string|IP or DNS name where the node connects from.| |port|integer|Port on which the node is running.| |lastaccess|integer|Heartbeat time, t.i. time of last update from the node. UTC timestamp.| |status|integer|State of the node.<br><br>Possible values:<br>0 - standby;<br>1 - stopped manually;<br>2 - unavailable;<br>3 - active.| # history.clear # history.clear #### History functions |FUNCTION|<|<|<| |--------|-|-|-| |<|**Description**|**Function-specific parameters**|**Comments**| |**change** (/host/key)|<|<|<| |<|The amount of difference between the previous and latest value.|<|Supported value types: float, int, str, text, log<br><br>For strings returns:<br>0 - values are equal<br>1 - values differ<br><br>Example:<br>=> **change**(/host/key)>10<br><br>Numeric difference will be calculated, as seen with these incoming example values ('previous' and 'latest' value = difference):<br>'1' and '5' = `+4`<br>'3' and '1' = `-2`<br>'0' and '-2.5' = `-2.5`<br><br>See also: [abs](/manual/appendix/functions/math) for comparison| |**changecount** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Number of changes between adjacent values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**mode** (optional; must be double-quoted)<br><br>Supported `modes`:<br>*all* - count all changes (default)<br>*dec* - count decreases<br>*inc* - count increases|Supported value types: float, int, str, text, log<br><br>For non-numeric value types, *mode* parameter is ignored.<br><br>Examples:<br>=> **changecount**(/host/key, 1w) → number of value changes for the last week until [now](/manual/config/triggers#evaluation_period)<br>=> **changecount**(/host/key,\#10,"inc") → number of value increases (relative to the adjacent value) among the last 10 values<br>=> **changecount**(/host/key,24h,"dec") → number of value decreases (relative to the adjacent value) for the last 24 hours until [now](/manual/config/triggers#evaluation_period)| |**count** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<|<| |<|Number of values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number\_to\_compare\_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number\_to\_compare\_with*. If the result of "bitwise AND" is equal to *number\_to\_compare\_with*, the value is counted.<br>If *number\_to\_compare\_with* and *mask* are equal, only the *mask* need be specified (without '/').<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.<br><br>Examples:<br>=> **count**(/host/key,**10m**) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **count**(/host/key,**10m**,"like","error") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **count**(/host/key,**10m**,,12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that equal '12'<br>=> **count**(/host/key,**10m**,"gt",12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**\#10**,"gt",12) → number of values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**10m:now-1d**,"gt",12) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **count**(/host/key,**10m**,"bitand","6/7") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **count**(/host/key,**10m:now-1d**) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**countunique** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<|<| |<|Number of unique values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number\_to\_compare\_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number\_to\_compare\_with*. If the result of "bitwise AND" is equal to *number\_to\_compare\_with*, the value is counted.<br>If *number\_to\_compare\_with* and *mask* are equal, only the *mask* need be specified (without '/').<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.<br><br>Examples:<br>=> **countunique**(/host/key,**10m**) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **countunique**(/host/key,**10m**,"like","error") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **countunique**(/host/key,**10m**,"gt",12) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**\#10**,"gt",12) → number of unique values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**10m:now-1d**,"gt",12) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **countunique**(/host/key,**10m**,"bitand","6/7") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **countunique**(/host/key,**10m:now-1d**) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**find** (/host/key,<(sec\|\#num)<:time shift>>,<operator>,<pattern>)|<|<|<| |<|Find a value match.|See [common parameters](#common-parameters).<br><br>**sec** or **\#num** (optional) - defaults to the latest value if not specified<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - value contains the string given in `pattern` (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>**pattern** - required pattern (string arguments must be double-quoted); [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) regular expression if `operator` is *regexp*, *iregexp*.|Supported value types: float, int, str, text, log<br><br>Returns:<br>1 - found<br>0 - otherwise<br><br>If more than one value is processed, '1' is returned if there is at least one matching value.<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings.<br><br>Example:<br>=> **find**(/host/key,**10m**,"like","error") → find a value that contains 'error' within the last 10 minutes until [now](/manual/config/triggers#evaluation_period)| |**first** (/host/key,sec<:time shift>)|<|<|<| |<|The first (the oldest) value within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int, str, text, log<br><br>Example:<br>=> **first**(/host/key,**1h**) → retrieve the oldest value within the last hour until [now](/manual/config/triggers#evaluation_period)<br><br>See also last().| |**fuzzytime** (/host/key,sec)|<|<|<| |<|Checking how much the passive agent time differs from the Zabbix server/proxy time.|See [common-parameters](#common parameters).|Supported value types: float, int<br><br>Returns:<br>1 - difference between the passive item value (as timestamp) and Zabbix server/proxy timestamp is less than or equal to T seconds<br>0 - otherwise<br><br>Usually used with the 'system.localtime' item to check that local time is in sync with the local time of Zabbix server. *Note* that 'system.localtime' must be configured as a [passive check](/manual/appendix/items/activepassive#passive_checks).<br>Can be used also with vfs.file.time\[/path/file,modify\] key to check that file didn't get updates for long time.<br><br>Example:<br>=> **fuzzytime**(/host/key,**60s**)=0 → detect a problem if the time difference is over 60 seconds<br><br>This function is not recommended for use in complex trigger expressions (with multiple items involved), because it may cause unexpected results (time difference will be measured with the most recent metric), e.g. in `fuzzytime(/Host/system.localtime,60s)=0 or last(/Host/trap)<>0`| |**last** (/host/key,<\#num<:time shift>>)|<|<|<| |<|The most recent value.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: float, int, str, text, log<br><br>Take note that a hash-tagged time period (\#N) works differently here than with many other functions.<br>For example:<br>last() is always equal to last(\#1)<br>last(\#3) - third most recent value (*not* three latest values)<br><br>Zabbix does not guarantee the exact order of values if more than two values exist within one second in history.<br><br>Example:<br>=> **last**(/host/key) → retrieve the last value<br>=> **last**(/host/key,**\#2**) → retrieve the previous value<br>=> **last**(/host/key,**\#1**) <> **last**(/host/key,**\#2**) → the last and previous values differ<br><br>See also first().| |**logeventid** (/host/key,<\#num<:time shift>>,<pattern>)|<|<|<| |<|Checking if event ID of the last log entry matches a regular expression.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches| |**logseverity** (/host/key,<\#num<:time shift>>)|<|<|<| |<|Log severity of the last log entry.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: log<br><br>Returns:<br>0 - default severity<br>N - severity (integer, useful for Windows event logs: 1 - Information, 2 - Warning, 4 - Error, 7 - Failure Audit, 8 - Success Audit, 9 - Critical, 10 - Verbose).<br>Zabbix takes log severity from **Information** field of Windows event log.| |**logsource** (/host/key,<\#num<:time shift>>,<pattern>)|<|<|<| |<|Checking if log source of the last log entry matches a regular expression.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches<br><br>Normally used for Windows event logs. For example, logsource("VMware Server").| |**monodec** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Check if there has been a monotonous decrease in values.|See [common parameters](#common-parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is smaller or the same as the previous one; default) or *strict* (every value has decreased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously decrease, 0 otherwise.<br><br>Example:<br>=> **monodec**(/Host1/system.swap.size\[all,free\],**60s**) + **monodec**(/Host2/system.swap.size\[all,free\],**60s**) + **monodec**(/Host3/system.swap.size\[all,free\],**60s**) - calculate in how many hosts there has been a decrease in free swap size| |**monoinc** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Check if there has been a monotonous increase in values.|See [common parameters](#common-parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is bigger or the same as the previous one; default) or *strict* (every value has increased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously increase, 0 otherwise.<br><br>Example:<br>=> **monoinc**(/Host1/system.localtime,**\#3**,"strict")=0 - check if system local time has been increasing consistently| |**nodata** (/host/key,sec,<mode>)|<|<|<| |<|Checking for no data received.|See [common parameters](#common-parameters).<br><br>**sec** period should not be less than 30 seconds because the history syncer process calculates this function only every 30 seconds.<br><br>nodata(/host/key,0) is disallowed.<br><br>**mode** - if set to *strict* (double-quoted), this function will be insensitive to proxy availability (see comments for details).|All value types are supported.<br><br>Returns:<br>1 - if no data received during the defined period of time<br>0 - otherwise<br><br>Since Zabbix 5.0, the 'nodata' triggers monitored by proxy are, by default, sensitive to proxy availability - if proxy becomes unavailable, the 'nodata' triggers will not fire immediately after a restored connection, but will skip the data for the delayed period. Note that for passive proxies suppression is activated if connection is restored more than 15 seconds and no less than 2 & ProxyUpdateFrequency seconds later. For active proxies suppression is activated if connection is restored more than 15 seconds later.<br><br>To turn off sensitiveness to proxy availability, use the third parameter, e.g.: **nodata**(/host/key,**5m**,**"strict"**); in this case the function will work the same as before 5.0.0 and fire as soon as the evaluation period (five minutes) without data has past.<br><br>Note that this function will display an error if, within the period of the 1st parameter:<br>- there's no data and Zabbix server was restarted<br>- there's no data and maintenance was completed<br>- there's no data and the item was added or re-enabled<br>Errors are displayed in the *Info* column in trigger [configuration](/manual/web_interface/frontend_sections/configuration/hosts/triggers).<br><br>This function may not work properly if there are time differences between Zabbix server, proxy and agent. See also: [Time synchronization requirement](/manual/installation/requirements#time_synchronization).| |**percentile** (/host/key,(sec\|\#num)<:time shift>,percentage)|<|<|<| |<|P-th percentile of a period, where P (percentage) is specified by the third parameter.|See [common parameters](#common-parameters).<br><br>**percentage** - a floating-point number between 0 and 100 (inclusive) with up to 4 digits after the decimal point|Supported value types: float, int| |**rate** (/host/key,sec<:time shift>)|<|<|<| |<|Per-second average rate of the increase in a monotonically increasing counter within the defined time period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Functionally corresponds to '[rate](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)' of PromQL.<br><br>Example:<br>=> **rate**(/host/key,**30s**) → If the monotonic increase over 30 seconds is 20, this function will return 0.67.| |**trendavg** (/host/key,time period:time shift)|<|<|<| |<|Average of trend values within the defined time period.|**time period** - the time period (minimum '1h'), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - the time period offset (see examples)|Examples:<br>=> **trendavg**(/host/key,**1h:now/h**) → average for the previous hour (e.g. 12:00-13:00)<br>=> **trendavg**(/host/key,**1h:now/h-1h**) → average for two hours ago (11:00-12:00)<br>=> **trendavg**(/host/key,**1h:now/h-2h**) → average for three hours ago (10:00-11:00)<br>=> **trendavg**(/host/key,**1M:now/M-1y**) → average for the previous month a year ago| |**trendcount** (/host/key,time period:time shift)|<|<|<| |<|Number of successfully retrieved trend values within the defined time period.|**time period** - the time period (minimum '1h'), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - the time period offset (see examples)|Examples:<br>=> **trendcount**(/host/key,**1h:now/h**) → count for the previous hour (e.g. 12:00-13:00)<br>=> **trendcount**(/host/key,**1h:now/h-1h**) → count for two hours ago (11:00-12:00)<br>=> **trendcount**(/host/key,**1h:now/h-2h**) → count for three hours ago (10:00-11:00)<br>=> **trendcount**(/host/key,**1M:now/M-1y**) → count for the previous month a year ago| |**trendmax** (/host/key,time period:time shift)|<|<|<| |<|The maximum in trend values within the defined time period.|**time period** - the time period (minimum '1h'), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - the time period offset (see examples)|Examples:<br>=> **trendmax**(/host/key,**1h:now/h**) → maximum for the previous hour (e.g. 12:00-13:00)<br>=> **trendmax**(/host/key,**1h:now/h**) - **trendmin**(/host/key,**1h:now/h**) → calculate the difference between the maximum and minimum values (trend delta) for the previous hour (12:00-13:00)<br>=> **trendmax**(/host/key,**1h:now/h-1h**) → maximum for two hours ago (11:00-12:00)<br>=> **trendmax**(/host/key,**1h:now/h-2h**) → maximum for three hours ago (10:00-11:00)<br>=> **trendmax**(/host/key,**1M:now/M-1y**) → maximum for the previous month a year ago| |**trendmin** (/host/key,time period:time shift)|<|<|<| |<|The minimum in trend values within the defined time period.|**time period** - the time period (minimum '1h'), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - the time period offset (see examples)|Examples:<br>=> **trendmin**(/host/key,**1h:now/h**) → minimum for the previous hour (e.g. 12:00-13:00)<br>=> **trendmin**(/host/key,**1h:now/h**) - **trendmin**(/host/key,**1h:now/h**) → calculate the difference between the maximum and minimum values (trend delta) for the previous hour (12:00-13:00)<br>=> **trendmin**(/host/key,**1h:now/h-1h**) → minimum for two hours ago (11:00-12:00)<br>=> **trendmin**(/host/key,**1h:now/h-2h**) → minimum for three hours ago (10:00-11:00)<br>=> **trendmin**(/host/key,**1M:now/M-1y**) → minimum for the previous month a year ago| |**trendstl** (/host/key,eval period:time shift,detection period,season,<deviations>,<devalg>,<s_window>)|<|<|<| |<|Returns an anomaly rate - a decimal value between 0 and 1 that is ((the number of anomaly values in detect period) / (total number of values in detect period).|**eval period** - the time period that must be decomposed (minimum '1h'), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - the time period offset (see examples)<br><br>**detection period** - the time period starting from the end of eval period for which anomalies are calculated (minimum '1h', cannot be longer than eval period), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week).<br><br>**season** - the shortest time period where seasonality (repeating patterns) is expected (minimum '2h', cannot be longer than eval period, number of entries in the eval period must be greater than the two times of the resulting frequency (season/h)), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week).<br><br>**deviations** - the number of deviations (calculated with devalg) to count as anomaly (can be decimal), (must be greater than or equal to 1, default is 3)<br><br>**devalg** - deviation algorithm, can be 'stddevpop', 'stddevsamp' or 'mad' (default)<br><br>**s_window** - the span (in lags) of the loess window for seasonal extraction (default is 10 * number of entries in eval period + 1)|Examples:<br>=> **trendstl**(/host/key,**100h:now/h**,10h,2h) → analysing the last 100 hours of trend data,<br>find the anomalies rate for the previous 10 hours of that period,<br>expecting the periodicity to be 2h,<br>the remainder series values of the evaluation period are considered anomalies if they reach the value of 3 deviations of the MAD of that remainder series<br>=> **trendstl**(/host/key,**100h:now/h-10h**,100h,2h,2.1,'mad') → analysing the period of previous 100 hours of trend data, starting counting 10 hours ago<br>find the anomalies rate for that entire period<br>expecting the periodicity to be 2h,<br>the remainder series values of the evaluation period are considered anomalies if they reach the value of 2,1 deviations of the MAD of that remainder series<br>=> **trendstl**(/host/key,**100d:now/d-1d**,10d,1d,4,,10) → analysing previous 100 days of trend data starting from a day ago,<br>find the anomalies rate for the period of last 10d of that period,<br>expecting the periodicity to be 1d,<br>the remainder series values of the evaluation period are considered anomalies if they reach the value of 4 deviations of the MAD of that remainder series,<br>overriding the default span of the loess window for seasonal extraction of "10 * number of entries in eval period + 1" with the span of 10 lags<br>=> **trendstl**(/host/key,**1M:now/M-1y**,1d,2h,,'stddevsamp') → minimum for the previous month a year ago<br>analysing previous month of trend data starting from a year ago,<br>find the anomalies rate of the last day of that period<br>expecting the periodicity to be 2h,<br>the remainder series values of the evaluation period are considered anomalies if they reach the value of 3 deviation of the sample standard deviation of that remainder series| |**trendsum** (/host/key,time period:time shift)|<|<|<| |<|Sum of trend values within the defined time period.|**time period** - the time period (minimum '1h'), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - the time period offset (see examples)|Examples:<br>=> **trendsum**(/host/key,**1h:now/h**) → sum for the previous hour (e.g. 12:00-13:00)<br>=> **trendsum**(/host/key,**1h:now/h-1h**) → sum for two hours ago (11:00-12:00)<br>=> **trendsum**(/host/key,**1h:now/h-2h**) → sum for three hours ago (10:00-11:00)<br>=> **trendsum**(/host/key,**1M:now/M-1y**) → sum for the previous month a year ago| #### History functions |FUNCTION|<|<|<| |--------|-|-|-| |<|**Description**|**Function-specific parameters**|**Comments**| |**change** (/host/key)|<|<|<| |<|The amount of difference between the previous and latest value.|<|Supported value types: float, int, str, text, log<br><br>For strings returns:<br>0 - values are equal<br>1 - values differ<br><br>Example:<br>=> **change**(/host/key)>10<br><br>Numeric difference will be calculated, as seen with these incoming example values ('previous' and 'latest' value = difference):<br>'1' and '5' = `+4`<br>'3' and '1' = `-2`<br>'0' and '-2.5' = `-2.5`<br><br>See also: [abs](/manual/appendix/functions/math) for comparison| |**changecount** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Number of changes between adjacent values within the defined evaluation period.|See [common parameters](#common parameters).<br><br>**mode** (optional; must be double-quoted)<br><br>Supported `modes`:<br>*all* - count all changes (default)<br>*dec* - count decreases<br>*inc* - count increases|Supported value types: float, int, str, text, log<br><br>For non-numeric value types, *mode* parameter is ignored.<br><br>Examples:<br>=> **changecount**(/host/key, 1w) → number of value changes for the last week until [now](/manual/config/triggers#evaluation_period)<br>=> **changecount**(/host/key,\#10,"inc") → number of value increases (relative to the adjacent value) among the last 10 values<br>=> **changecount**(/host/key,24h,"dec") → number of value decreases (relative to the adjacent value) for the last 24 hours until [now](/manual/config/triggers#evaluation_period)| |**count** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<|<| |<|Number of values within the defined evaluation period.|See [common parameters](#common parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number\_to\_compare\_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number\_to\_compare\_with*. If the result of "bitwise AND" is equal to *number\_to\_compare\_with*, the value is counted.<br>If *number\_to\_compare\_with* and *mask* are equal, only the *mask* need be specified (without '/').<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.<br><br>Examples:<br>=> **count**(/host/key,**10m**) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **count**(/host/key,**10m**,"like","error") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **count**(/host/key,**10m**,,12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that equal '12'<br>=> **count**(/host/key,**10m**,"gt",12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**\#10**,"gt",12) → number of values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**10m:now-1d**,"gt",12) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **count**(/host/key,**10m**,"bitand","6/7") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **count**(/host/key,**10m:now-1d**) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**countunique** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<|<| |<|Number of unique values within the defined evaluation period.|See [common parameters](#common parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number\_to\_compare\_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number\_to\_compare\_with*. If the result of "bitwise AND" is equal to *number\_to\_compare\_with*, the value is counted.<br>If *number\_to\_compare\_with* and *mask* are equal, only the *mask* need be specified (without '/').<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.<br><br>Examples:<br>=> **countunique**(/host/key,**10m**) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **countunique**(/host/key,**10m**,"like","error") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **countunique**(/host/key,**10m**,"gt",12) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**\#10**,"gt",12) → number of unique values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**10m:now-1d**,"gt",12) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **countunique**(/host/key,**10m**,"bitand","6/7") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **countunique**(/host/key,**10m:now-1d**) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**find** (/host/key,<(sec\|\#num)<:time shift>>,<operator>,<pattern>)|<|<|<| |<|Find a value match.|See [common parameters](#common parameters).<br><br>**sec** or **\#num** (optional) - defaults to the latest value if not specified<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - value contains the string given in `pattern` (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>**pattern** - required pattern (string arguments must be double-quoted); [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) regular expression if `operator` is *regexp*, *iregexp*.|Supported value types: float, int, str, text, log<br><br>Returns:<br>1 - found<br>0 - otherwise<br><br>If more than one value is processed, '1' is returned if there is at least one matching value.<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings.<br><br>Example:<br>=> **find**(/host/key,**10m**,"like","error") → find a value that contains 'error' within the last 10 minutes until [now](/manual/config/triggers#evaluation_period)| |**first** (/host/key,sec<:time shift>)|<|<|<| |<|The first (the oldest) value within the defined evaluation period.|See [common parameters](#common parameters).|Supported value types: float, int, str, text, log<br><br>Example:<br>=> **first**(/host/key,**1h**) → retrieve the oldest value within the last hour until [now](/manual/config/triggers#evaluation_period)<br><br>See also last().| |**fuzzytime** (/host/key,sec)|<|<|<| |<|Checking how much the passive agent time differs from the Zabbix server/proxy time.|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Returns:<br>1 - difference between the passive item value (as timestamp) and Zabbix server/proxy timestamp is less than or equal to T seconds<br>0 - otherwise<br><br>Usually used with the 'system.localtime' item to check that local time is in sync with the local time of Zabbix server. *Note* that 'system.localtime' must be configured as a [passive check](/manual/appendix/items/activepassive#passive_checks).<br>Can be used also with vfs.file.time\[/path/file,modify\] key to check that file didn't get updates for long time.<br><br>Example:<br>=> **fuzzytime**(/host/key,**60s**)=0 → detect a problem if the time difference is over 60 seconds<br><br>This function is not recommended for use in complex trigger expressions (with multiple items involved), because it may cause unexpected results (time difference will be measured with the most recent metric), e.g. in `fuzzytime(/Host/system.localtime,60s)=0 or last(/Host/trap)<>0`| |**last** (/host/key,<\#num<:time shift>>)|<|<|<| |<|The most recent value.|See [common parameters](#common parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: float, int, str, text, log<br><br>Take note that a hash-tagged time period (\#N) works differently here than with many other functions.<br>For example:<br>last() is always equal to last(\#1)<br>last(\#3) - third most recent value (*not* three latest values)<br><br>Zabbix does not guarantee the exact order of values if more than two values exist within one second in history.<br><br>Example:<br>=> **last**(/host/key) → retrieve the last value<br>=> **last**(/host/key,**\#2**) → retrieve the previous value<br>=> **last**(/host/key,**\#1**) <> **last**(/host/key,**\#2**) → the last and previous values differ<br><br>See also first().| |**logeventid** (/host/key,<\#num<:time shift>>,<pattern>)|<|<|<| |<|Checking if event ID of the last log entry matches a regular expression.|See [common parameters](#common parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches| |**logseverity** (/host/key,<\#num<:time shift>>)|<|<|<| |<|Log severity of the last log entry.|See [common parameters](#common parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: log<br><br>Returns:<br>0 - default severity<br>N - severity (integer, useful for Windows event logs: 1 - Information, 2 - Warning, 4 - Error, 7 - Failure Audit, 8 - Success Audit, 9 - Critical, 10 - Verbose).<br>Zabbix takes log severity from **Information** field of Windows event log.| |**logsource** (/host/key,<\#num<:time shift>>,<pattern>)|<|<|<| |<|Checking if log source of the last log entry matches a regular expression.|See [common parameters](#common parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches<br><br>Normally used for Windows event logs. For example, logsource("VMware Server").| |**monodec** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Check if there has been a monotonous decrease in values.|See [common parameters](#common parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is smaller or the same as the previous one; default) or *strict* (every value has decreased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously decrease, 0 otherwise.<br><br>Example:<br>=> **monodec**(/Host1/system.swap.size\[all,free\],**60s**) + **monodec**(/Host2/system.swap.size\[all,free\],**60s**) + **monodec**(/Host3/system.swap.size\[all,free\],**60s**) - calculate in how many hosts there has been a decrease in free swap size| |**monoinc** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<|<| |<|Check if there has been a monotonous increase in values.|See [common parameters](#common parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is bigger or the same as the previous one; default) or *strict* (every value has increased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously increase, 0 otherwise.<br><br>Example:<br>=> **monoinc**(/Host1/system.localtime,**\#3**,"strict")=0 - check if system local time has been increasing consistently| |**nodata** (/host/key,sec,<mode>)|<|<|<| |<|Checking for no data received.|See [common parameters](#common parameters).<br><br>**sec** period should not be less than 30 seconds because the history syncer process calculates this function only every 30 seconds.<br><br>nodata(/host/key,0) is disallowed.<br><br>**mode** - if set to *strict* (double-quoted), this function will be insensitive to proxy availability (see comments for details).|All value types are supported.<br><br>Returns:<br>1 - if no data received during the defined period of time<br>0 - otherwise<br><br>Since Zabbix 5.0, the 'nodata' triggers monitored by proxy are, by default, sensitive to proxy availability - if proxy becomes unavailable, the 'nodata' triggers will not fire immediately after a restored connection, but will skip the data for the delayed period. Note that for passive proxies suppression is activated if connection is restored more than 15 seconds and no less than 2 & ProxyUpdateFrequency seconds later. For active proxies suppression is activated if connection is restored more than 15 seconds later.<br><br>To turn off sensitiveness to proxy availability, use the third parameter, e.g.: **nodata**(/host/key,**5m**,**"strict"**); in this case the function will work the same as before 5.0.0 and fire as soon as the evaluation period (five minutes) without data has past.<br><br>Note that this function will display an error if, within the period of the 1st parameter:<br>- there's no data and Zabbix server was restarted<br>- there's no data and maintenance was completed<br>- there's no data and the item was added or re-enabled<br>Errors are displayed in the *Info* column in trigger [configuration](/manual/web_interface/frontend_sections/configuration/hosts/triggers).<br><br>This function may not work properly if there are time differences between Zabbix server, proxy and agent. See also: [Time synchronization requirement](/manual/installation/requirements#time_synchronization).| |**percentile** (/host/key,(sec\|\#num)<:time shift>,percentage)|<|<|<| |<|P-th percentile of a period, where P (percentage) is specified by the third parameter.|See [common parameters](#common parameters).<br><br>**percentage** - a floating-point number between 0 and 100 (inclusive) with up to 4 digits after the decimal point|Supported value types: float, int| |**rate** (/host/key,sec<:time shift>)|<|<|<| |<|Per-second average rate of the increase in a monotonically increasing counter within the defined time period.|See [common parameters](#common parameters).|Supported value types: float, int<br><br>Functionally corresponds to '[rate](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)' of PromQL.<br><br>Example:<br>=> **rate**(/host/key,**30s**) → If the monotonic increase over 30 seconds is 20, this function will return 0.67.| |**trendavg** (/host/key,time period:time shift)|<|<|<| |<|Average of trend values within the defined time period.|**time period** - the time period (minimum '1h'), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - the time period offset (see examples)|Examples:<br>=> **trendavg**(/host/key,**1h:now/h**) → average for the previous hour (e.g. 12:00-13:00)<br>=> **trendavg**(/host/key,**1h:now/h-1h**) → average for two hours ago (11:00-12:00)<br>=> **trendavg**(/host/key,**1h:now/h-2h**) → average for three hours ago (10:00-11:00)<br>=> **trendavg**(/host/key,**1M:now/M-1y**) → average for the previous month a year ago| |**trendcount** (/host/key,time period:time shift)|<|<|<| |<|Number of successfully retrieved trend values within the defined time period.|**time period** - the time period (minimum '1h'), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - the time period offset (see examples)|Examples:<br>=> **trendcount**(/host/key,**1h:now/h**) → count for the previous hour (e.g. 12:00-13:00)<br>=> **trendcount**(/host/key,**1h:now/h-1h**) → count for two hours ago (11:00-12:00)<br>=> **trendcount**(/host/key,**1h:now/h-2h**) → count for three hours ago (10:00-11:00)<br>=> **trendcount**(/host/key,**1M:now/M-1y**) → count for the previous month a year ago| |**trendmax** (/host/key,time period:time shift)|<|<|<| |<|The maximum in trend values within the defined time period.|**time period** - the time period (minimum '1h'), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - the time period offset (see examples)|Examples:<br>=> **trendmax**(/host/key,**1h:now/h**) → maximum for the previous hour (e.g. 12:00-13:00)<br>=> **trendmax**(/host/key,**1h:now/h**) - **trendmin**(/host/key,**1h:now/h**) → calculate the difference between the maximum and minimum values (trend delta) for the previous hour (12:00-13:00)<br>=> **trendmax**(/host/key,**1h:now/h-1h**) → maximum for two hours ago (11:00-12:00)<br>=> **trendmax**(/host/key,**1h:now/h-2h**) → maximum for three hours ago (10:00-11:00)<br>=> **trendmax**(/host/key,**1M:now/M-1y**) → maximum for the previous month a year ago| |**trendmin** (/host/key,time period:time shift)|<|<|<| |<|The minimum in trend values within the defined time period.|**time period** - the time period (minimum '1h'), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - the time period offset (see examples)|Examples:<br>=> **trendmin**(/host/key,**1h:now/h**) → minimum for the previous hour (e.g. 12:00-13:00)<br>=> **trendmax**(/host/key,**1h:now/h**) - **trendmin**(/host/key,**1h:now/h**) → calculate the difference between the maximum and minimum values (trend delta) for the previous hour (12:00-13:00)<br>=> **trendmin**(/host/key,**1h:now/h-1h**) → minimum for two hours ago (11:00-12:00)<br>=> **trendmin**(/host/key,**1h:now/h-2h**) → minimum for three hours ago (10:00-11:00)<br>=> **trendmin**(/host/key,**1M:now/M-1y**) → minimum for the previous month a year ago| |**trendsum** (/host/key,time period:time shift)|<|<|<| |<|Sum of trend values within the defined time period.|**time period** - the time period (minimum '1h'), defined as <N><time unit> where<br>`N` - number of time units<br>`time unit` - h (hour), d (day), w (week), M (month) or y (year).<br><br>[Time shift](/manual/config/triggers/expression#function-specific_parameters) - the time period offset (see examples)|Examples:<br>=> **trendsum**(/host/key,**1h:now/h**) → sum for the previous hour (e.g. 12:00-13:00)<br>=> **trendsum**(/host/key,**1h:now/h-1h**) → sum for two hours ago (11:00-12:00)<br>=> **trendsum**(/host/key,**1h:now/h-2h**) → sum for three hours ago (10:00-11:00)<br>=> **trendsum**(/host/key,**1M:now/M-1y**) → sum for the previous month a year ago| # history.get # history.get #### History Retrieve historical values gathered by Zabbix monitoring processes for presentation or further processing. [History API](/manual/api/reference/history) #### ヒストリ Zabbix監視プロセスによって収集された過去の値を取得し、表示やさらなる処理を行うことができます。 [History API](/manual/api/reference/history) ### HMAC function for JavaScript A new function has been added to the JavaScript engine allowing to return HMAC hash: - `hmac('<hash type>',key,string)` This is useful for cases when hash-based message authentication code (HMAC) is required for signing requests. MD5 and SHA256 hash types are supported, e. g.: - `hmac('md5',key,string)` - `hmac('sha256',key,string)` ### JavaScript用のHMAC関数 JavaScriptエンジンに新しい関数が追加され、HMACハッシュを返すことができるようになりました： - `hmac('<hash type>',key,string)` これは、リクエストの署名にハッシュベースのメッセージ認証コード(HMAC)が必要な場合に役立ちます。 MD5およびSHA256ハッシュタイプがサポートされています。例： - `hmac('md5',key,string)` - `hmac('sha256',key,string)` #### Host access from several user groups A user may belong to any number of user groups. These groups may have different access permissions to hosts. Therefore, it is important to know what hosts an unprivileged user will be able to access as a result. For example, let us consider how access to host **X** (in Hostgroup 1) will be affected in various situations for a user who is in user groups A and B. - If Group A has only *Read* access to Hostgroup 1, but Group B *Read-write* access to Hostgroup 1, the user will get **Read-write** access to 'X'. ::: noteimportant “Read-write” permissions have precedence over “Read” permissions starting with Zabbix 2.2. ::: - In the same scenario as above, if 'X' is simultaneously also in Hostgroup 2 that is **denied** to Group A or B, access to 'X' will be **unavailable**, despite a *Read-write* access to Hostgroup 1. - If Group A has no permissions defined and Group B has a *Read-write* access to Hostgroup 1, the user will get **Read-write** access to 'X'. - If Group A has *Deny* access to Hostgroup 1 and Group B has a *Read-write* access to Hostgroup 1, the user will get access to 'X' **denied**. #### 複数のユーザーグループからのホストアクセス ユーザーは、任意の数のユーザーグループに所属することができます。これらのグループは、ホストに対する異なるアクセス権限を持つことができます。 したがって、非特権ユーザーが結果的にどのホストにアクセスできるようになるかを知ることは重要です。例えば、ユーザーグループAとBに属するユーザーにとって、(ホストグループ1に属する)ホスト**X** へのアクセスが様々な状況でどのように影響されるかを考えてみましょう。 - グループAがホストグループ1への*表示のみ*のアクセス権しか持っておらず、グループBがホストグループ1への*表示/設定*アクセス権を持っている場合、ユーザーは'X'への **表示/設定**アクセス権を取得することになります。 ::: noteimportant Zabbix2.2以降から権限"表示/設定"は権限"表示のみ"より優先されます。 ::: - 上記と同じシナリオで、'X'が同時にグループAまたはBに**拒否**されているホストグループ2にも属している場合、ホストグループ1への*表示/設定*のアクセス権があるにもかかわらず、'X'へのアクセスは**不可能**となります。 - グループAに何の権限も定義されておらず、グループBにホストグループ1への*表示/設定*のアクセス権がある場合、そのユーザーは'X'への*表示/設定*のアクセス権を得ることができます。 - グループAがホストグループ1への*拒否*のアクセス権を持っており、グループBがホストグループ1への*表示/設定*のアクセス権を持っている場合、そのユーザーは'Xへの*拒否*のアクセス権を得ます。 ##### Host configuration A host must be configured to process IPMI checks. An IPMI interface must be added, with the respective IP and port numbers, and IPMI authentication parameters must be defined. See the [configuration of hosts](/manual/config/hosts/host) for more details. ##### ホストの設定 IPMI チェックを処理するために、ホストを設定する必要があります。<br> IPMI インターフェイスをを追加し、それぞれの IPアドレス およびポート番号を指定し、IPMI 認証パラメーターを定義する必要があります。 詳細は、[configuration of hosts](/manual/config/hosts/host) を参照してください。 #### Host configuration To use VMware simple checks the host must have the following user macros defined: - **{$VMWARE.URL}** - VMware service (vCenter or ESX hypervisor) SDK URL (<https://servername/sdk>) - **{$VMWARE.USERNAME}** - VMware service user name - **{$VMWARE.PASSWORD}** - VMware service {$VMWARE.USERNAME} user password #### ホストの構成 VMwareシンプルチェックを使用するには、ホストに以下のユーザーマクロが定義されている必要があります。 <br> - **{$VMWARE.URL}** - VMwareサービス(vCenterまたはESXハイパーバイザー) SDK URL (<https://servername/sdk>) - **{$VMWARE.USERNAME}** - VMwareサービスのユーザー名 - **{$VMWARE.PASSWORD}** - VMware サービス {$VMWARE.USERNAME} ユーザー名 パスワード ##### Host configuration You can specify that an individual host should be monitored by a proxy in the [host configuration](/manual/config/hosts/host) form, using the *Monitored by proxy* field.  Host [mass update](/manual/config/hosts/hostupdate) is another way of specifying that hosts should be monitored by a proxy. ##### ホストの設定 *Monitored by proxy*フィールドを使用して、[host configuration](/manual/config/hosts/host)フォームでプロキシによって個々のホストを監視するように指定できます。  ホストの[一括更新](/manual/config/hosts/hostupdate)は、ホストをプロキシで監視指定するもう1つの方法です。 # host.create # host.create # host.delete # host.delete #### Host editing as popup The form for host creation and editing is now opened in a modal (popup) window, in *Configuration* → *Hosts*, *Monitoring* → *Hosts* and in any page, where there is a host menu or other direct link to the host configuration. Direct links to the host edit page still work and are opening the host edit page in full page. #### ホスト定義編集をポップアップで表示 ホストメニューやホスト設定への直接リンクがある、*設定*→*ホスト*、*監視データ*→*ホスト*、および任意のページで、ホスト定義の作成と編集のためのフォームがモーダル（ポップアップ）ウィンドウで開かれます。 ホスト編集ページへの直接リンクはまだ機能しており、全画面でホスト編集ページを開きます。 # host.get # host.get ##### Host graph tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |graphs|<|\-|<|<|Root element for graphs.| |<|name|x|`string`|<|Graph name.| |<|width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| |<|height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| |<|yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| |<|yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| |<|show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| |<|show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| |<|type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| |<|show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| |<|show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| |<|percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| |<|percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| |<|ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| |<|ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1|<|\-|<|<|Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| |ymax\_item\_1|<|\-|<|<|Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| |graph\_items|<|x|<|<|Root element for graph items.| |<|sortorder|\-|`integer`|<|Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| |<|drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| |<|color|\-|`string`|<|Element color (6 symbols, hex).| |<|yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| |<|calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| |<|type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item|<|x|<|<|Individual item.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| ##### Host graph タグ |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |graphs|<|\-|<|<|Root element for graphs.| |<|name|x|`string`|<|Graph name.| |<|width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| |<|height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| |<|yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| |<|yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| |<|show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| |<|show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| |<|type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| |<|show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| |<|show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| |<|percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| |<|percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| |<|ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| |<|ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1|<|\-|<|<|Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| |ymax\_item\_1|<|\-|<|<|Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| |graph\_items|<|x|<|<|Root element for graph items.| |<|sortorder|\-|`integer`|<|Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| |<|drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| |<|color|\-|`string`|<|Element color (6 symbols, hex).| |<|yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| |<|calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| |<|type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item|<|x|<|<|Individual item.| |<|host|x|`string`|<|Item host.| |<|key|x|`string`|<|Item key.| # hostgroup.create # hostgroup.create # hostgroup.delete # hostgroup.delete # hostgroup.get # hostgroup.get # hostgroup.massadd # hostgroup.massadd # hostgroup.massremove # hostgroup.massremove # hostgroup.massupdate # hostgroup.massupdate ### Host group The host group object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|*(readonly)* ID of the host group.| |**name**<br>(required)|string|Name of the host group.| |flags|integer|*(readonly)* Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.| |internal|integer|*(readonly)* Whether the group is used internally by the system. An internal group cannot be deleted.<br><br>Possible values:<br>0 - *(default)* not internal;<br>1 - internal.| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| ### Host group host group object オブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |groupid|string|*(readonly)* ID of the host group.| |**name**<br>(required)|string|Name of the host group.| |flags|integer|*(readonly)* Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.| |internal|integer|*(readonly)* Whether the group is used internally by the system. An internal group cannot be deleted.<br><br>Possible values:<br>0 - *(default)* not internal;<br>1 - internal.| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| # hostgroup.update # hostgroup.update # hostinterface.create # hostinterface.create # hostinterface.delete # hostinterface.delete # hostinterface.get # hostinterface.get # hostinterface.massadd # hostinterface.massadd # hostinterface.massremove # hostinterface.massremove # hostinterface.replacehostinterfaces # hostinterface.replacehostinterfaces # hostinterface.update # hostinterface.update ### Host inventory The host inventory object has the following properties. ::: notetip Each property has it's own unique ID number, which is used to associate host inventory fields with items. ::: |ID|Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|--|------| |4|alias|string|Alias.| |11|asset\_tag|string|Asset tag.| |28|chassis|string|Chassis.| |23|contact|string|Contact person.| |32|contract\_number|string|Contract number.| |47|date\_hw\_decomm|string|HW decommissioning date.| |46|date\_hw\_expiry|string|HW maintenance expiry date.| |45|date\_hw\_install|string|HW installation date.| |44|date\_hw\_purchase|string|HW purchase date.| |34|deployment\_status|string|Deployment status.| |14|hardware|string|Hardware.| |15|hardware\_full|string|Detailed hardware.| |39|host\_netmask|string|Host subnet mask.| |38|host\_networks|string|Host networks.| |40|host\_router|string|Host router.| |30|hw\_arch|string|HW architecture.| |33|installer\_name|string|Installer name.| |24|location|string|Location.| |25|location\_lat|string|Location latitude.| |26|location\_lon|string|Location longitude.| |12|macaddress\_a|string|MAC address A.| |13|macaddress\_b|string|MAC address B.| |29|model|string|Model.| |3|name|string|Name.| |27|notes|string|Notes.| |41|oob\_ip|string|OOB IP address.| |42|oob\_netmask|string|OOB host subnet mask.| |43|oob\_router|string|OOB router.| |5|os|string|OS name.| |6|os\_full|string|Detailed OS name.| |7|os\_short|string|Short OS name.| |61|poc\_1\_cell|string|Primary POC mobile number.| |58|poc\_1\_email|string|Primary email.| |57|poc\_1\_name|string|Primary POC name.| |63|poc\_1\_notes|string|Primary POC notes.| |59|poc\_1\_phone\_a|string|Primary POC phone A.| |60|poc\_1\_phone\_b|string|Primary POC phone B.| |62|poc\_1\_screen|string|Primary POC screen name.| |68|poc\_2\_cell|string|Secondary POC mobile number.| |65|poc\_2\_email|string|Secondary POC email.| |64|poc\_2\_name|string|Secondary POC name.| |70|poc\_2\_notes|string|Secondary POC notes.| |66|poc\_2\_phone\_a|string|Secondary POC phone A.| |67|poc\_2\_phone\_b|string|Secondary POC phone B.| |69|poc\_2\_screen|string|Secondary POC screen name.| |8|serialno\_a|string|Serial number A.| |9|serialno\_b|string|Serial number B.| |48|site\_address\_a|string|Site address A.| |49|site\_address\_b|string|Site address B.| |50|site\_address\_c|string|Site address C.| |51|site\_city|string|Site city.| |53|site\_country|string|Site country.| |56|site\_notes|string|Site notes.| |55|site\_rack|string|Site rack location.| |52|site\_state|string|Site state.| |54|site\_zip|string|Site ZIP/postal code.| |16|software|string|Software.| |18|software\_app\_a|string|Software application A.| |19|software\_app\_b|string|Software application B.| |20|software\_app\_c|string|Software application C.| |21|software\_app\_d|string|Software application D.| |22|software\_app\_e|string|Software application E.| |17|software\_full|string|Software details.| |10|tag|string|Tag.| |1|type|string|Type.| |2|type\_full|string|Type details.| |35|url\_a|string|URL A.| |36|url\_b|string|URL B.| |37|url\_c|string|URL C.| |31|vendor|string|Vendor.| ### Host インベントリ Host インベントリオブジェクトは、以下のプロパティを持ちます。 ::: notetip 各プロパティには固有のID番号があり、ホストインベントリフィールドと item の関連付けに使用されます。 ::: |ID|プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|--|------| |4|alias|string|Alias.| |11|asset\_tag|string|Asset tag.| |28|chassis|string|Chassis.| |23|contact|string|Contact person.| |32|contract\_number|string|Contract number.| |47|date\_hw\_decomm|string|HW decommissioning date.| |46|date\_hw\_expiry|string|HW maintenance expiry date.| |45|date\_hw\_install|string|HW installation date.| |44|date\_hw\_purchase|string|HW purchase date.| |34|deployment\_status|string|Deployment status.| |14|hardware|string|Hardware.| |15|hardware\_full|string|Detailed hardware.| |39|host\_netmask|string|Host subnet mask.| |38|host\_networks|string|Host networks.| |40|host\_router|string|Host router.| |30|hw\_arch|string|HW architecture.| |33|installer\_name|string|Installer name.| |24|location|string|Location.| |25|location\_lat|string|Location latitude.| |26|location\_lon|string|Location longitude.| |12|macaddress\_a|string|MAC address A.| |13|macaddress\_b|string|MAC address B.| |29|model|string|Model.| |3|name|string|Name.| |27|notes|string|Notes.| |41|oob\_ip|string|OOB IP address.| |42|oob\_netmask|string|OOB host subnet mask.| |43|oob\_router|string|OOB router.| |5|os|string|OS name.| |6|os\_full|string|Detailed OS name.| |7|os\_short|string|Short OS name.| |61|poc\_1\_cell|string|Primary POC mobile number.| |58|poc\_1\_email|string|Primary email.| |57|poc\_1\_name|string|Primary POC name.| |63|poc\_1\_notes|string|Primary POC notes.| |59|poc\_1\_phone\_a|string|Primary POC phone A.| |60|poc\_1\_phone\_b|string|Primary POC phone B.| |62|poc\_1\_screen|string|Primary POC screen name.| |68|poc\_2\_cell|string|Secondary POC mobile number.| |65|poc\_2\_email|string|Secondary POC email.| |64|poc\_2\_name|string|Secondary POC name.| |70|poc\_2\_notes|string|Secondary POC notes.| |66|poc\_2\_phone\_a|string|Secondary POC phone A.| |67|poc\_2\_phone\_b|string|Secondary POC phone B.| |69|poc\_2\_screen|string|Secondary POC screen name.| |8|serialno\_a|string|Serial number A.| |9|serialno\_b|string|Serial number B.| |48|site\_address\_a|string|Site address A.| |49|site\_address\_b|string|Site address B.| |50|site\_address\_c|string|Site address C.| |51|site\_city|string|Site city.| |53|site\_country|string|Site country.| |56|site\_notes|string|Site notes.| |55|site\_rack|string|Site rack location.| |52|site\_state|string|Site state.| |54|site\_zip|string|Site ZIP/postal code.| |16|software|string|Software.| |18|software\_app\_a|string|Software application A.| |19|software\_app\_b|string|Software application B.| |20|software\_app\_c|string|Software application C.| |21|software\_app\_d|string|Software application D.| |22|software\_app\_e|string|Software application E.| |17|software\_full|string|Software details.| |10|tag|string|Tag.| |1|type|string|Type.| |2|type\_full|string|Type details.| |35|url\_a|string|URL A.| |36|url\_b|string|URL B.| |37|url\_c|string|URL C.| |31|vendor|string|Vendor.| ##### Host item tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |items|<|\-|<|<|Root element for items.| |<|name|x|`string`|<|Item name.| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULATED<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Item type.| |<|snmp\_oid|\-|`string`|<|SNMP object ID.<br><br>Required by SNMP items.| |<|key|x|`string`|<|Item key.| |<|delay|\-|`string`|Default: 1m|Update interval of the item.<br><br>Note that `delay` will be always '0' for trapper items.<br><br>Accepts seconds or a time unit with suffix (30s, 1m, 2h, 1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| |<|history|\-|`string`|Default: 90d|A time unit of how long the history data should be stored. Time unit with suffix, user macro or LLD macro.| |<|trends|\-|`string`|Default: 365d|A time unit of how long the trends data should be stored. Time unit with suffix, user macro or LLD macro.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Item status.| |<|value\_type|\-|`string`|0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (default)<br>4 - TEXT|Received value type.| |<|allowed\_hosts|\-|`string`|<|List of IP addresses (comma delimited) of hosts allowed sending data for the item.<br><br>Used by trapper and HTTP agent items.| |<|units|\-|`string`|<|Units of returned values (bps, B, etc).| |<|params|\-|`text`|<|Additional parameters depending on the type of the item:<br>- executed script for Script, SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items.| |<|ipmi\_sensor|\-|`string`|<|IPMI sensor.<br><br>Used only by IPMI items.| |<|authtype|\-|`string`|Authentication type for SSH agent items:<br>0 - PASSWORD (default)<br>1 - PUBLIC\_KEY<br><br>Authentication type for HTTP agent items:<br>0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication type.<br><br>Used only by SSH and HTTP agent items.| |<|username|\-|`string`|<|Username for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX agent, password should also be specified together with the username or both properties should be left blank.| |<|password|\-|`string`|<|Password for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>When used by JMX agent, username should also be specified together with the password or both properties should be left blank.| |<|publickey|\-|`string`|<|Name of the public key file.<br><br>Required for SSH agent items.| |<|privatekey|\-|`string`|<|Name of the private key file.<br><br>Required for SSH agent items.| |<|description|\-|`text`|<|Item description.| |<|inventory\_link|\-|`string`|0 - NONE<br><br>Capitalized host inventory field name. For example:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.| |<|logtimefmt|\-|`string`|<|Format of the time in log entries.<br>Used only by log items.| |<|interface\_ref|\-|`string`|Format: `if<N>`|Reference to the host interface.| |<|jmx\_endpoint|\-|`string`|<|JMX endpoint.<br><br>Used only by JMX agent items.| |<|url|\-|`string`|<|URL string.<br><br>Required only for HTTP agent items.| |<|allow\_traps|\-|`string`|0 - NO (default)<br>1 - YES|Allow to populate value as in a trapper item.<br><br>Used only by HTTP agent items.| |<|follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP response redirects while pooling data.<br><br>Used only by HTTP agent items.| |headers|<|\-|<|<|Root element for HTTP(S) request headers, where header name is used as key and header value as value.<br>Used only by HTTP agent items.| |<|name|x|`string`|<|Header name.| |<|value|x|`string`|<|Header value.| |<|http\_proxy|\-|`string`|<|HTTP(S) proxy connection string.<br><br>Used only by HTTP agent items.| |<|output\_format|\-|`string`|0 - RAW (default)<br>1 - JSON|How to process response.<br><br>Used only by HTTP agent items.| |<|post\_type|\-|`string`|0 - RAW (default)<br>2 - JSON<br>3 - XML|Type of post data body.<br><br>Used only by HTTP agent items.| |<|posts|\-|`string`|<|HTTP(S) request body data.<br><br>Used only by HTTP agent items.| |query\_fields|<|\-|<|<|Root element for query parameters.<br><br>Used only by HTTP agent items.| |<|name|x|`string`|<|Parameter name.| |<|value|\-|`string`|<|Parameter value.| |<|request\_method|\-|`string`|0 - GET (default)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Request method.<br><br>Used only by HTTP agent items.| |<|retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|What part of response should be stored.<br><br>Used only by HTTP agent items.| |<|ssl\_cert\_file|\-|`string`|<|Public SSL Key file path.<br><br>Used only by HTTP agent items.| |<|ssl\_key\_file|\-|`string`|<|Private SSL Key file path.<br><br>Used only by HTTP agent items.| |<|ssl\_key\_password|\-|`string`|<|Password for SSL Key file.<br><br>Used only by HTTP agent items.| |<|status\_codes|\-|`string`|<|Ranges of required HTTP status codes separated by commas. Supports user macros.<br>Example: 200,200-{$M},{$M},200-400<br><br>Used only by HTTP agent items.| |<|timeout|\-|`string`|<|Item data polling request timeout. Supports user macros.<br><br>Used by HTTP agent and Script items.| |<|verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host name in URL is in Common Name field or a Subject Alternate Name field of host certificate.<br><br>Used only by HTTP agent items.| |<|verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host certificate is authentic.<br><br>Used only by HTTP agent items.| |parameters|<|\-|<|<|Root element for user-defined parameters.<br><br>Used only by Script items.| |<|name|x|`string`|<|Parameter name.<br><br>Used only by Script items.| |<|value|\-|`string`|<|Parameter value.<br><br>Used only by Script items.| |value map|<|\-|<|<|Value map.| |<|name|x|`string`|<|Name of the value map to use for the item.| |preprocessing|<|\-|<|<|Root element for item value preprocessing.| |step|<|\-|<|<|Individual item value preprocessing step.| |<|type|x|`string`|1 - MULTIPLIER<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculated as (received value-previous value))<br>10 - CHANGE\_PER\_SECOND (calculated as (received value-previous value)/(time now-time of last check))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |<|parameters|\-|<|<|Root element for parameters of the item value preprocessing step.| |<|parameter|x|`string`|<|Individual parameter of the item value preprocessing step.| |<|error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (default)<br>1 - DISCARD\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Action type used in case of preprocessing step failure.| |<|error\_handler\_params|\-|`string`|<|Error handler parameters used with 'error\_handler'.| |master\_item|<|\-|<|<|Individual item master item.<br><br>Required by dependent items.| |<|key|x|`string`|<|Dependent item master item key value.<br><br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.| |triggers|<|\-|<|<|Root element for simple triggers.| |<|*For trigger element tag values, see host [trigger tags](/manual/xml_export_import/hosts#host_trigger_tags).*|<|<|<|<| |tags|<|\-|<|<|Root element for item tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.| ##### Host item タグ |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |items|<|\-|<|<|Root element for items.| |<|name|x|`string`|<|Item name.| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULATED<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Item type.| |<|snmp\_oid|\-|`string`|<|SNMP object ID.<br><br>Required by SNMP items.| |<|key|x|`string`|<|Item key.| |<|delay|\-|`string`|Default: 1m|Update interval of the item.<br><br>Note that `delay` will be always '0' for trapper items.<br><br>Accepts seconds or a time unit with suffix (30s, 1m, 2h, 1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| |<|history|\-|`string`|Default: 90d|A time unit of how long the history data should be stored. Time unit with suffix, user macro or LLD macro.| |<|trends|\-|`string`|Default: 365d|A time unit of how long the trends data should be stored. Time unit with suffix, user macro or LLD macro.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Item status.| |<|value\_type|\-|`string`|0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (default)<br>4 - TEXT|Received value type.| |<|allowed\_hosts|\-|`string`|<|List of IP addresses (comma delimited) of hosts allowed sending data for the item.<br><br>Used by trapper and HTTP agent items.| |<|units|\-|`string`|<|Units of returned values (bps, B, etc).| |<|params|\-|`text`|<|Additional parameters depending on the type of the item:<br>- executed script for Script, SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items.| |<|ipmi\_sensor|\-|`string`|<|IPMI sensor.<br><br>Used only by IPMI items.| |<|authtype|\-|`string`|Authentication type for SSH agent items:<br>0 - PASSWORD (default)<br>1 - PUBLIC\_KEY<br><br>Authentication type for HTTP agent items:<br>0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication type.<br><br>Used only by SSH and HTTP agent items.| |<|username|\-|`string`|<|Username for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX agent, password should also be specified together with the username or both properties should be left blank.| |<|password|\-|`string`|<|Password for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>When used by JMX agent, username should also be specified together with the password or both properties should be left blank.| |<|publickey|\-|`string`|<|Name of the public key file.<br><br>Required for SSH agent items.| |<|privatekey|\-|`string`|<|Name of the private key file.<br><br>Required for SSH agent items.| |<|description|\-|`text`|<|Item description.| |<|inventory\_link|\-|`string`|0 - NONE<br><br>Capitalized host inventory field name. For example:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.| |<|logtimefmt|\-|`string`|<|Format of the time in log entries.<br>Used only by log items.| |<|interface\_ref|\-|`string`|Format: `if<N>`|Reference to the host interface.| |<|jmx\_endpoint|\-|`string`|<|JMX endpoint.<br><br>Used only by JMX agent items.| |<|url|\-|`string`|<|URL string.<br><br>Required only for HTTP agent items.| |<|allow\_traps|\-|`string`|0 - NO (default)<br>1 - YES|Allow to populate value as in a trapper item.<br><br>Used only by HTTP agent items.| |<|follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP response redirects while pooling data.<br><br>Used only by HTTP agent items.| |headers|<|\-|<|<|Root element for HTTP(S) request headers, where header name is used as key and header value as value.<br>Used only by HTTP agent items.| |<|name|x|`string`|<|Header name.| |<|value|x|`string`|<|Header value.| |<|http\_proxy|\-|`string`|<|HTTP(S) proxy connection string.<br><br>Used only by HTTP agent items.| |<|output\_format|\-|`string`|0 - RAW (default)<br>1 - JSON|How to process response.<br><br>Used only by HTTP agent items.| |<|post\_type|\-|`string`|0 - RAW (default)<br>2 - JSON<br>3 - XML|Type of post data body.<br><br>Used only by HTTP agent items.| |<|posts|\-|`string`|<|HTTP(S) request body data.<br><br>Used only by HTTP agent items.| |query\_fields|<|\-|<|<|Root element for query parameters.<br><br>Used only by HTTP agent items.| |<|name|x|`string`|<|Parameter name.| |<|value|\-|`string`|<|Parameter value.| |<|request\_method|\-|`string`|0 - GET (default)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Request method.<br><br>Used only by HTTP agent items.| |<|retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|What part of response should be stored.<br><br>Used only by HTTP agent items.| |<|ssl\_cert\_file|\-|`string`|<|Public SSL Key file path.<br><br>Used only by HTTP agent items.| |<|ssl\_key\_file|\-|`string`|<|Private SSL Key file path.<br><br>Used only by HTTP agent items.| |<|ssl\_key\_password|\-|`string`|<|Password for SSL Key file.<br><br>Used only by HTTP agent items.| |<|status\_codes|\-|`string`|<|Ranges of required HTTP status codes separated by commas. Supports user macros.<br>Example: 200,200-{$M},{$M},200-400<br><br>Used only by HTTP agent items.| |<|timeout|\-|`string`|<|Item data polling request timeout. Supports user macros.<br><br>Used by HTTP agent and Script items.| |<|verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host name in URL is in Common Name field or a Subject Alternate Name field of host certificate.<br><br>Used only by HTTP agent items.| |<|verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host certificate is authentic.<br><br>Used only by HTTP agent items.| |parameters|<|\-|<|<|Root element for user-defined parameters.<br><br>Used only by Script items.| |<|name|x|`string`|<|Parameter name.<br><br>Used only by Script items.| |<|value|\-|`string`|<|Parameter value.<br><br>Used only by Script items.| |value map|<|\-|<|<|Value map.| |<|name|x|`string`|<|Name of the value map to use for the item.| |preprocessing|<|\-|<|<|Root element for item value preprocessing.| |step|<|\-|<|<|Individual item value preprocessing step.| |<|type|x|`string`|1 - MULTIPLIER<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculated as (received value-previous value))<br>10 - CHANGE\_PER\_SECOND (calculated as (received value-previous value)/(time now-time of last check))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |<|parameters|\-|<|<|Root element for parameters of the item value preprocessing step.| |<|parameter|x|`string`|<|Individual parameter of the item value preprocessing step.| |<|error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (default)<br>1 - DISCARD\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Action type used in case of preprocessing step failure.| |<|error\_handler\_params|\-|`string`|<|Error handler parameters used with 'error\_handler'.| |master\_item|<|\-|<|<|Individual item master item.<br><br>Required by dependent items.| |<|key|x|`string`|<|Dependent item master item key value.<br><br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.| |triggers|<|\-|<|<|Root element for simple triggers.| |<|*For trigger element tag values, see host [trigger tags](/manual/xml_export_import/hosts#host_trigger_tags).*|<|<|<|<| |tags|<|\-|<|<|Root element for item tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.| ##### Host low-level discovery rule tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |discovery\_rules|<|\-|<|<|Root element for low-level discovery rules.| |<|*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*|<|<|<|<| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| |<|lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter|<|<|<|<|Individual filter.| |<|evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| |<|formula|\-|`string`|<|Custom calculation formula for filter conditions.| |conditions|<|\-|<|<|Root element for filter conditions.| |<|macro|x|`string`|<|Low-level discovery macro name.| |<|value|\-|`string`|<|Filter value: regular expression or global regular expression.| |<|operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| |<|formulaid|x|`character`|<|Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |lld\_macro\_paths|<|\-|<|<|Root element for LLD macro paths.| |<|lld\_macro|x|`string`|<|Low-level discovery macro name.| |<|path|x|`string`|<|Selector for value which will be assigned to the corresponding macro.| |preprocessing|<|\-|<|<|LLD rule value preprocessing.| |step|<|\-|<|<|Individual LLD rule value preprocessing step.| |<|*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*|<|<|<|<| |<|type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes|<|\-|<|<|Root element for trigger prototypes.| |<|*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*|<|<|<|<| |graph\_prototypes|<|\-|<|<|Root element for graph prototypes.| |<|*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*|<|<|<|<| |host\_prototypes|<|\-|<|<|Root element for host prototypes.| |<|*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*|<|<|<|<| |item\_prototypes|<|\-|<|<|Root element for item prototypes.| |<|*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*|<|<|<|<| |master\_item|<|\-|<|<|Individual item prototype master item/item prototype data.| |<|key|x|`string`|<|Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.| ##### Host low-level discovery rule タグ |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |discovery\_rules|<|\-|<|<|Root element for low-level discovery rules.| |<|*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*|<|<|<|<| |<|type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| |<|lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter|<|<|<|<|Individual filter.| |<|evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| |<|formula|\-|`string`|<|Custom calculation formula for filter conditions.| |conditions|<|\-|<|<|Root element for filter conditions.| |<|macro|x|`string`|<|Low-level discovery macro name.| |<|value|\-|`string`|<|Filter value: regular expression or global regular expression.| |<|operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| |<|formulaid|x|`character`|<|Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |lld\_macro\_paths|<|\-|<|<|Root element for LLD macro paths.| |<|lld\_macro|x|`string`|<|Low-level discovery macro name.| |<|path|x|`string`|<|Selector for value which will be assigned to the corresponding macro.| |preprocessing|<|\-|<|<|LLD rule value preprocessing.| |step|<|\-|<|<|Individual LLD rule value preprocessing step.| |<|*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*|<|<|<|<| |<|type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes|<|\-|<|<|Root element for trigger prototypes.| |<|*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*|<|<|<|<| |graph\_prototypes|<|\-|<|<|Root element for graph prototypes.| |<|*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*|<|<|<|<| |host\_prototypes|<|\-|<|<|Root element for host prototypes.| |<|*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*|<|<|<|<| |item\_prototypes|<|\-|<|<|Root element for item prototypes.| |<|*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*|<|<|<|<| |master\_item|<|\-|<|<|Individual item prototype master item/item prototype data.| |<|key|x|`string`|<|Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.| Host markers displayed on the map have the color of the host's most serious problem and green color if a host has no problems. Clicking on a host marker allows viewing the host's visible name and the number of unresolved problems grouped by severity. Clicking on the visible name will open [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu). Hosts displayed on the map can be filtered by problem severity. Press on the filter icon in the widget's upper right corner and mark the required severities.  マップに表示されるホストマーカーはホストの最も深刻な障害の色です。ホストに障害がない場合は緑色になります。 ホストマーカーをクリックすると、ホストの表示名と深刻度別にグループ化された未解決の障害の数を表示できます。 表示されている名前をクリックすると、[ホストメニュー](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu)が開きます。 マップに表示されるホストは障害の深刻度でフィルタリングできます。 ウィジェットの右上隅にあるフィルターアイコンを押して、表示したい深刻度をチェックします。  # host.massadd # host.massadd # host.massremove # host.massremove # host.massupdate # host.massupdate #### Host menu Clicking on a host in the *Problems* widget brings up the host menu. It includes links to host inventory, latest data, problems, graphs, dashboards, web scenarios and configuration. Note that host configuration is available for Admin and Superadmin users only.  [Global scripts](/manual/web_interface/frontend_sections/administration/scripts) can also be run from the host menu. These scripts need to have their scope defined as 'Manual host action' to be available in the host menu. The host menu is accessible by clicking on a host in several other frontend sections: - Monitoring → [Problems](problems) - Monitoring → [Problems](problems) → Event details - Monitoring → [Hosts](hosts) - Monitoring → Hosts → [Web Monitoring](/manual/web_interface/frontend_sections/monitoring/hosts/web) - Monitoring → [Latest data](latest_data) - Monitoring → [Maps](maps) - Reports → [Triggers top 100](/manual/web_interface/frontend_sections/reports/triggers_top) #### ホストメニュー *障害*ウィジェットでホストをクリックすると、ホストメニューが表示されます。 ホストインベントリ、最新データ、障害、グラフ、ダッシュボード、Webシナリオ、および設定へのリンクが含まれています。 ホストの設定は管理者およびスーパー管理者ユーザーのみが使用できます。  [グローバルスクリプト](/manual/web_interface/frontend_sections/administration/scripts)はホストメニューから実行することもできます。 これらのスクリプトをホストメニューで使用するには、スコープを'手動ホストアクション'として定義する必要があります。 ホストメニューには、他のいくつかのフロントエンドセクションでホストをクリックしてアクセスできます。 - 監視データ → [障害](problems) - 監視データ → [障害](problems) → イベント詳細 - 監視データ → [ホスト](hosts) - 監視データ → ホスト → [Web監視](/manual/web_interface/frontend_sections/monitoring/hosts/web) - 監視データ → [最新データ](latest_data) - 監視データ → [マップ](maps) - レポート → [障害発生数上位100項目](/manual/web_interface/frontend_sections/reports/triggers_top) ##### Hostname parameter To perform [active checks](/manual/appendix/items/activepassive#active_checks) on a host Zabbix agent needs to have the hostname defined. Moreover, the hostname value set on the agent side should exactly match the "[Host name](/manual/config/hosts/host)" configured for the host in the frontend. The hostname value on the agent side can be defined by either the **Hostname** or **HostnameItem** parameter in the agent [configuration file](/manual/appendix/config/zabbix_agentd_win) - or the default values are used if any of these parameters are not specified. The default value for **HostnameItem** parameter is the value returned by the "system.hostname" agent key and for Windows platform it returns the NetBIOS host name. The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it. The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it. The "system.hostname" key supports two optional parameters - *type* and *transform*. *Type* parameter determines the type of the name the item should return. Supported values: - *netbios* (default) - returns the NetBIOS host name which is limited to 15 symbols and is in the UPPERCASE only; - *host* - case-sensitive, returns the full, real Windows host name (without a domain); - *shorthost* (supported since Zabbix 5.4.7) - returns part of the hostname before the first dot. It will return a full string if the name does not contain a dot. *Transform* parameter is supported since Zabbix 5.4.7 and allows to specify additional transformation rule for the hostname. Supported values: - *none* (default) - use the original letter case; - *lower* - convert the text into lowercase. So, to simplify the configuration of zabbix\_agentd.conf file and make it unified, two different approaches could be used. 1. leave **Hostname** or **HostnameItem** parameters undefined and Zabbix agent will use NetBIOS host name as the hostname; 2. leave **Hostname** parameter undefined and define **HostnameItem** like this:\ **HostnameItem=system.hostname\[host\]** - for Zabbix agent to use the full, real (case sensitive) Windows host name as the hostname\ **HostnameItem=system.hostname\[shorthost,lower\]** - for Zabbix agent to use only part of the hostname before the first dot, converted into lowercase. Host name is also used as part of Windows service name which is used for installing, starting, stopping and uninstalling the Windows service. For example, if Zabbix agent configuration file specifies `Hostname=Windows_db_server`, then the agent will be installed as a Windows service "`Zabbix Agent [Windows_db_server]`". Therefore, to have a different Windows service name for each Zabbix agent instance, each instance must use a different host name. ##### Hostname parameter To perform [active checks](/manual/appendix/items/activepassive#active_checks) on a host Zabbix agent needs to have the hostname defined. Moreover, the hostname value set on the agent side should exactly match the "[Host name](/manual/config/hosts/host)" configured for the host in the frontend. The hostname value on the agent side can be defined by either the **Hostname** or **HostnameItem** parameter in the agent [configuration file](/manual/appendix/config/zabbix_agentd_win) - or the default values are used if any of these parameters are not specified. The default value for **HostnameItem** parameter is the value returned by the "system.hostname" agent key and for Windows platform it returns the NetBIOS host name. The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it. The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it. The "system.hostname" key supports two optional parameters - *type* and *transform*. *Type* parameter determines the type of the name the item should return. Supported values: - *netbios* (default) - returns the NetBIOS host name which is limited to 15 symbols and is in the UPPERCASE only; - *host* - returns the full, real (case-sensitive) Windows host name; - *shorthost* (supported since Zabbix 5.4.7) - returns part of the hostname before the first dot. It will return a full string if the name does not contain a dot. *Transform* parameter is supported since Zabbix 5.4.7 and allows to specify additional transformation rule for the hostname. Supported values: - *none* (default) - use the original letter case; - *lower* - convert the text into lowercase. So, to simplify the configuration of zabbix\_agentd.conf file and make it unified, two different approaches could be used. 1. leave **Hostname** or **HostnameItem** parameters undefined and Zabbix agent will use NetBIOS host name as the hostname; 2. leave **Hostname** parameter undefined and define **HostnameItem** like this:\ **HostnameItem=system.hostname\[host\]** - for Zabbix agent to use the full, real (case sensitive) Windows host name as the hostname\ **HostnameItem=system.hostname\[shorthost,lower\]** - for Zabbix agent to use only part of the hostname before the first dot, converted into lowercase. Host name is also used as part of Windows service name which is used for installing, starting, stopping and uninstalling the Windows service. For example, if Zabbix agent configuration file specifies `Hostname=Windows_db_server`, then the agent will be installed as a Windows service "`Zabbix Agent [Windows_db_server]`". Therefore, to have a different Windows service name for each Zabbix agent instance, each instance must use a different host name. ##### Host naming When adding hosts, a host name is the result of reverse DNS lookup or IP address if reverse lookup fails. Lookup is performed from the Zabbix server or Zabbix proxy, depending on which is doing the discovery. If lookup fails on the proxy, it is not retried on the server. If the host with such a name already exists, the next host would get **\_2** appended to the name, then **\_3** and so on. It is also possible to override DNS/IP lookup and instead use an item value for host name, for example: - You may discover multiple servers with Zabbix agent running using a Zabbix agent item for discovery and assign proper names to them automatically, based on the string value returned by this item - You may discover multiple SNMP network devices using an SNMP agent item for discovery and assign proper names to them automatically, based on the string value returned by this item If the host name has been set using an item value, it is not updated during the following discovery checks. If it is not possible to set host name using an item value, default value (DNS name) is used. If a host already exists with the discovered IP address, a new host is not created. However, if the discovery action contains operations (link template, add to host group, etc), they are performed on the existing host. ##### ホストの命名 ホストを追加する場合、ホスト名は逆引きDNSルックアップの結果または逆引きルックアップが失敗した場合のIPアドレスです。ルックアップは、検出を行っているZabbixサーバーまたはZabbixプロキシから実行されます。プロキシでルックアップが失敗した場合でもサーバーで再試行されません。同じ名前のホストがすでに存在する場合、次のホストには名前に**\_2 **を追加し、また次のホストには**\_3**というように追加されます。 DNS/IPルックアップをオーバーライドして、ホスト名にアイテム値を使用することもできます。次に例を示します。 - 検出用のZabbixエージェントアイテムを使用して実行されているZabbixエージェントで、複数のサーバーを検出し、このアイテムによって返される文字列値に基づいて、適切な名前をサーバーに自動的に割り当てる - SNMPエージェントアイテムを使用して、複数のSNMPネットワークデバイスを検出し、このアイテムによって返される文字列値に基づいて、適切な名前を自動的に割り当てる ホスト名がアイテム値を使用して設定されている場合、次の検出チェックでもホスト名は更新されません。項目値でホスト名を設定できない場合は、デフォルト値（DNS名）を使用します。 検出されたIPアドレスを持つホストがすでに存在する場合、新しいホストは作成されません。ただし、検出アクションに操作（リンクテンプレート、ホストグループへの追加など）が含まれている場合、それらは既存のホストで実行されます。 # hostprototype.create # hostprototype.create # hostprototype.delete # hostprototype.delete # hostprototype.get # hostprototype.get #### Host prototypes Host prototypes can be created with the low-level discovery rule. When virtual machines are discovered, these prototypes become real hosts. Prototypes, before becoming discovered, cannot have their own items and triggers, other than those from the linked templates. Discovered hosts will belong to an existing host.  In order for hosts created from a prototype to have unique host names, the *Host name* field must contain at least one [low-level discovery macro](/manual/config/macros/lld_macros). Since Zabbix 5.2, discovered hosts may be configured with custom interfaces or inherit the IP of a host the discovery rule belongs to (default). To add one or more custom interface, switch the *Interface* selector from *Inherit* to *Custom* mode, then press  and select the required interface type from the drop-down menu that appears. All supported types of interfaces can be defined for a host prototype: Zabbix agent, SNMP, JMX, IPMI. Interface fields support low-level discovery macros and [user macros](/manual/config/macros/user_macros). If several custom interfaces are specified - use the *Default* column to specify the primary interface. Notes: - If *Custom* is selected, but no interfaces have been specified the hosts will be created without interfaces. - If *Inherit* is selected for a host prototype that belongs to a template, discovered hosts will inherit the interface of a host to which the template is linked to. ::: notewarning A host will not be created, if the host interface contains incorrect data :::  LLD macros can also be used for the visible name, host group prototype fields, tag values, or values of host prototype user macros. Other options that can be specified for a host prototype are: - Linkage to existing host groups - Template linkage - Encryption If *Create enabled* is checked, the host will be added in an enabled state. If unchecked, the host will be added, but in a disabled state. If *Discover* is checked (default), the host will be created. If unchecked, the host will not be created, unless this setting is overridden in the [discovery rule](/manual/discovery/low_level_discovery#override). This functionality provides additional flexibility when creating discovery rules. Discovered hosts are prefixed with the name of the discovery rule that created them, in the host list. Discovered hosts can be manually deleted. Discovered hosts will also be automatically deleted, based on the *Keep lost resources period (in days)* value of the discovery rule. Most of the configuration options are read-only, except for enabling/disabling the host and host inventory. Discovered hosts cannot have host prototypes of their own. #### ホストプロトタイプ ホストプロトタイプは、ローレベルディスカバリルールで作成することができます。 <br> 仮想マシンが検出されると、このプロトタイプは実際のホストになります。 <br> プロトタイプは、検出される前に、リンクされたテンプレートの item および trigger 以外の <br> 独自の item および trigger を持つことができません。 <br> 発見されたホストは、既存のホストに属します。 <br>  プロトタイプから作成されたホストが一意なホスト名を持つためには、*Host name* フィールドに 少なくとも1つの[low-level discovery macro](/manual/config/macros/lld_macros)を含む必要があります。 Zabbix5.2以降、検出されたホストはカスタムインターフェイスで設定することができます。 <br> またはディスカバリルールが属するホストのIPを継承することができます(デフォルト) <br> カスタムインターフェイスを1つ以上追加するには、*インターフェイス*セレクタを <br> *Inherit* から *Custom* モードに切り替えて、次に  を押して、 <br> 表示されるドロップダウンメニューから必要なインターフェイスの種類を選択します。 <br> すべてのホストプロトタイプには、サポートされている全ての種類のインタフェースを定義することができます。 <br> Zabbix agent, SNMP, JMX, IPMI. Interface fields support low-level discovery macros and [user macros](/manual/config/macros/user_macros) <br> インタフェースフィールドは、ローレベルディスカバリーマクロとユーザマクロ(/manual/config/macros/user_macros)をサポートします。 <br> 複数のカスタム・インターフェースが指定されている場合、*Default* 列を使用してプライマリ・インターフェースを指定します。 <br> 注意事項 - *Custom* を選択し、インターフェイスを指定しなかった場合、ホストはインターフェイスなしで作成されます。 <br> - テンプレートに属するホストのプロトタイプで *Inherit* が選択されている場合、検出されたホストは、 <br> テンプレートに属するホストのインターフェースを継承します。 <br> ::: notewarning ホストインターフェイスに不正なデータが含まれている場合、ホストは作成されません。 :::  LLDマクロは、可視名、ホスト・グループ・プロトタイプ・フィールド、タグ値、ホスト・ <br> プロトタイプ・ユーザー・マクロの値にも使用できます。<br> その他、ホストプロトタイプに指定可能なオプションは以下の通り: - 既存ホストへのリンク - テンプレートへのリンク - 暗号化 *Create enabled* がチェックされている場合、ホストは有効な状態で追加されます。 <br> チェックされていない場合、ホストは追加されますが、無効な状態になります。 <br> *Discover* がチェックされている場合 (デフォルト)、ホストが作成されます。 <br> もしチェックされていない場合、[discovery rule](/manual/discovery/low_level_discovery#override)でこの設定が上書きされない限り、 <br> ホストは作成されません。この機能により、検出ルール作成時の柔軟性がさらに高まります。 <br> 検出されたホストは、ホスト一覧の中で、それらを作成したディスカバリルールの名前の前に表示されます。 <br> 検出されたホストは、手動で削除することができます。 <br> 検出されたホストは、ディスカバリルールの *Keep lost resources period (in days)* の値に基づいて <br> 自動的に削除されることもあります。 <br> ホストおよびホストインベントリの有効化/無効化を除いて、ほとんどの設定オプションは読み取り専用です。 <br> 検出されたホストは、それ自身のホストプロトタイプを持つことはできません。 <br> ### Host prototype tag The host prototype tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host prototype tag name.| |value|string|Host prototype tag value.| ### Host prototype tag Host prototype tagオブジェクトには、次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**tag**<br>(必須)|string|ホストプロトタイプタグ名| |value|string|ホストプロトタイプタグ値| ### Host prototype The host prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host prototype.| |**host**<br>(required)|string|Technical name of the host prototype.| |name|string|Visible name of the host prototype.<br><br>Default: `host` property value.| |status|integer|Status of the host prototype.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |templateid|string|*(readonly)* ID of the parent template host prototype.| |discover|integer|Host prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new hosts will be discovered;<br>1 - new hosts will not be discovered and existing hosts will be marked as lost.| |custom\_interfaces|integer|Source of interfaces for hosts created by the host prototype.<br><br>Possible values:<br>0 - *(default)* inherit interfaces from parent host;<br>1 - use host prototypes custom interfaces.| |uuid|string|Universal unique identifier, used for linking imported host prototypes to already existing ones. Used only for host prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| ### Host prototype host prototype オブジェクトには、次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |hostid|string|*（読み取り専用）*ホストプロトタイプのID。| |**host**<br>(必須)|string|ホストプロトタイプの名前| |name|string|ホストプロトタイプの表示名<br><br>デフォルト:`host`プロパティ値| |status|integer|ホストプロトタイプのステータス<br><br>値は次のとおり<br>0 - *（デフォルト）*監視対象ホスト<br>1 - 監視対象外ホスト| |inventory\_mode|integer|ホストインベントリ作成モード<br><br>値は次のとおり<br>-1 - *（デフォルト）*無効<br>0 - 手動<br>1 - 自動| |templateid|string|*（読み取り専用）*親テンプレートホストプロトタイプのID| |discover|integer|ホストプロトタイプの検出ステータス<br><br>値:<br>0 - *（デフォルト）*新しいホストが検出されます<br>1 - 新しいホストは検出されず、既存のホストは失われたものとしてマークされます| |custom\_interfaces|integer|ホストプロトタイプによって作成されたホストのインターフェースのソース<br><br>値:<br>0 - *（デフォルト）*親ホストからインターフェースを継承<br>1 - ホストプロトタイプのカスタムインターフェースを使用| |uuid|string|インポートされたホストプロトタイプを既存のプロトタイプにリンクするために使用されるユニバーサル一意識別子。 テンプレートのホストプロトタイプにのみ使用されます。指定されていない場合は自動生成されます。<br><br>updateの場合、このフィールドは*読み取り専用*です。| # hostprototype.update # hostprototype.update ##### Host removal Hosts discovered by a network discovery rule are removed automatically from *Monitoring* → *Discovery* if a discovered entity is not in the rule's IP range any more. Hosts are removed immediately. ##### ホストの削除 ネットワーク検出ルールによって検出されたホストは、検出されたエンティティがルールのIP範囲内にない場合、*監視*→*検出*からすぐ自動的に削除されます。 #### Hosts and host groups Manage host groups, hosts and everything related to them, including host interfaces, host macros and maintenance periods. [Host API](/manual/api/reference/host) | [Host group API](/manual/api/reference/hostgroup) | [Host interface API](/manual/api/reference/hostinterface) | [User macro API](/manual/api/reference/usermacro) | [Value map API](/manual/api/reference/valuemap) | [Maintenance API](/manual/api/reference/maintenance) #### ホストとホストグループ ホストグループとホスト、およびホストインタフェース、ホストマクロ、メンテナンス期間など、ホストに関連するすべてのものを管理します。 [Host API](/manual/api/reference/host) | [Host group API](/manual/api/reference/hostgroup) | [Host interface API](/manual/api/reference/hostinterface) | [User macro API](/manual/api/reference/usermacro) | [Value map API](/manual/api/reference/valuemap) | [Maintenance API](/manual/api/reference/maintenance) #### Hosts/host prototypes In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring#host_prototypes) configuration, user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interface IP/DNS|<|DNS only| |Interface port|<|no| |*SNMP v1, v2*|<|<| | |SNMP community|yes| |*SNMP v3*|<|<| | |Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |*IPMI*|<|<| | |Username|yes| |^|Password|yes| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes| #### Hosts/host prototypes [ホスト](/manual/config/hosts/host)および[ホストプロトタイプ](/manual/vm_monitoring#host_prototypes)設定では、ユーザーマクロを次のフィールドで使用できます。 |ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |インターフェースIP/DNS|<|DNS only| |インターフェースポート|<|no| |*SNMP v1, v2*|<|<| | |SNMP コミュニティ|yes| |*SNMP v3*|<|<| | |コンテキスト名|yes| |^|セキュリティ名|yes| |^|認証パスフレーズ|yes| |^|プライバシーパスフレーズ|yes| |*IPMI*|<|<| | |ユーザー名|yes| |^|パスワード|yes| |*タグ*^[2](supported_by_location_user#footnotes)^|<|<| | |タグ名|yes| |^|タグ値|yes| #### Hosts/host prototypes In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring#host_prototypes) configuration, user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |--------|-|------------------------------------------------------------------------| |Interface IP/DNS|<|DNS only| |Interface port|<|no| |*SNMP v1, v2*|<|<| |<|SNMP community|yes| |*SNMP v3*|<|<| |<|Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |*IPMI*|<|<| |<|Username|yes| |^|Password|yes| |//Tags //|<|<| |<|Tag names|yes| |^|Tag values|yes| #### Hosts/host prototypes In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring#host_prototypes) configuration, user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |--------|-|------------------------------------------------------------------------| |Interface IP/DNS|<|DNS only| |Interface port|<|no| |*SNMP v1, v2*|<|<| |<|SNMP community|yes| |*SNMP v3*|<|<| |<|Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |*IPMI*|<|<| |<|Username|yes| |^|Password|yes| |//Tags //|<|<| |<|Tag names|yes| |^|Tag values|yes| ##### Host tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |groups|<|x|<|<|Root element for host groups.| |<|name|x|`string`|<|Host group name.| |hosts|<|\-|<|<|Root element for hosts.| |<|host|x|`string`|<|Unique host name.| |<|name|\-|`string`|<|Visible host name.| |<|description|\-|`text`|<|Host description.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Host status.| |<|ipmi\_authtype|\-|`string`|-1 - DEFAULT (default)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS|IPMI session authentication type.| |<|ipmi\_privilege|\-|`string`|1 - CALLBACK<br>2 - USER (default)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM|IPMI session privilege level.| |<|ipmi\_username|\-|`string`|<|Username for IPMI checks.| |<|ipmi\_password|\-|`string`|<|Password for IPMI checks.| |proxy|<|\-|<|<|Proxy.| |<|name|x|`string`|<|Name of the proxy (if any) that monitors the host.| |templates|<|\-|<|<|Root element for linked templates.| |<|name|x|`string`|<|Template name.| |interfaces|<|\-|<|<|Root element for host interfaces.| |<|default|\-|`string`|0 - NO<br>1 - YES (default)|Whether this is the primary host interface.<br>There can be only one primary interface of one type on a host.| |<|type|\-|`string`|1 - ZABBIX (default)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Interface type.| |<|useip|\-|`string`|0 - NO<br>1 - YES (default)|Whether to use IP as the interface for connecting to the host (if not, DNS will be used).| |<|ip|\-|`string`|<|IP address, can be either IPv4 or IPv6.<br><br>Required if the connection is made via IP.| |<|dns|\-|`string`|<|DNS name.<br><br>Required if the connection is made via DNS.| |<|port|\-|`string`|<|Port number. Supports user macros.| |<|interface\_ref|x|`string`|Format: `if<N>`|Interface reference name to be used in items.| |details|<|\-|<|<|Root element for interface details.| |<|version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (default)<br>3 - SNMP\_V3|Use this SNMP version.| |<|community|\-|`string`|<|SNMP community.<br><br>Required by SNMPv1 and SNMPv2 items.| |<|contextname|\-|`string`|<|SNMPv3 context name.<br><br>Used only by SNMPv3 items.| |<|securityname|\-|`string`|<|SNMPv3 security name.<br><br>Used only by SNMPv3 items.| |<|securitylevel|\-|`string`|0 - NOAUTHNOPRIV (default)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|SNMPv3 security level.<br><br>Used only by SNMPv3 items.| |<|authprotocol|\-|`string`|0 - MD5 (default)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|SNMPv3 authentication protocol.<br><br>Used only by SNMPv3 items.| |<|authpassphrase|\-|`string`|<|SNMPv3 authentication passphrase.<br><br>Used only by SNMPv3 items.| |<|privprotocol|\-|`string`|0 - DES (default)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 privacy protocol.<br><br>Used only by SNMPv3 items.| |<|privpassphrase|\-|`string`|<|SNMPv3 privacy passphrase.<br><br>Used only by SNMPv3 items.| |<|bulk|\-|`string`|0 - NO<br>1 - YES (default)|Use bulk requests for SNMP.| |items|<|\-|<|<|Root element for items.| |<|*For item element tag values, see host [item](/manual/xml_export_import/hosts#host_item_tags) tags.*|<|<|<|<| |tags|<|\-|<|<|Root element for host tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.| |macros|<|\-|<|<|Root element for macros.| |<|macro|x|<|<|User macro name.| |<|type|\-|`string`|0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT|Type of the macro.| |<|value|\-|`string`|<|User macro value.| |<|description|\-|`string`|<|User macro description.| |inventory|<|\-|<|<|Root element for host inventory.| |<|<inventory\_property>|\-|<|<|Individual inventory property.<br><br>All available inventory properties are listed under the respective tags, e.g. <type>, <name>, <os> (see example above).| |inventory\_mode|<|\-|`string`|-1 - DISABLED<br>0 - MANUAL (default)<br>1 - AUTOMATIC|Inventory mode.| |valuemaps|<|\-|<|<|Root element for host value maps.| |<|name|x|`string`|<|Value map name.| |<|mapping|\-|<|<|Root element for mappings.| |<|value|x|`string`|<|Value of a mapping.| |<|newvalue|x|`string`|<|New value of a mapping.| ##### Host タグ |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |groups|<|x|<|<|Root element for host groups.| |<|name|x|`string`|<|Host group name.| |hosts|<|\-|<|<|Root element for hosts.| |<|host|x|`string`|<|Unique host name.| |<|name|\-|`string`|<|Visible host name.| |<|description|\-|`text`|<|Host description.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Host status.| |<|ipmi\_authtype|\-|`string`|-1 - DEFAULT (default)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS|IPMI session authentication type.| |<|ipmi\_privilege|\-|`string`|1 - CALLBACK<br>2 - USER (default)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM|IPMI session privilege level.| |<|ipmi\_username|\-|`string`|<|Username for IPMI checks.| |<|ipmi\_password|\-|`string`|<|Password for IPMI checks.| |proxy|<|\-|<|<|Proxy.| |<|name|x|`string`|<|Name of the proxy (if any) that monitors the host.| |templates|<|\-|<|<|Root element for linked templates.| |<|name|x|`string`|<|Template name.| |interfaces|<|\-|<|<|Root element for host interfaces.| |<|default|\-|`string`|0 - NO<br>1 - YES (default)|Whether this is the primary host interface.<br>There can be only one primary interface of one type on a host.| |<|type|\-|`string`|1 - ZABBIX (default)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Interface type.| |<|useip|\-|`string`|0 - NO<br>1 - YES (default)|Whether to use IP as the interface for connecting to the host (if not, DNS will be used).| |<|ip|\-|`string`|<|IP address, can be either IPv4 or IPv6.<br><br>Required if the connection is made via IP.| |<|dns|\-|`string`|<|DNS name.<br><br>Required if the connection is made via DNS.| |<|port|\-|`string`|<|Port number. Supports user macros.| |<|interface\_ref|x|`string`|Format: `if<N>`|Interface reference name to be used in items.| |details|<|\-|<|<|Root element for interface details.| |<|version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (default)<br>3 - SNMP\_V3|Use this SNMP version.| |<|community|\-|`string`|<|SNMP community.<br><br>Required by SNMPv1 and SNMPv2 items.| |<|contextname|\-|`string`|<|SNMPv3 context name.<br><br>Used only by SNMPv3 items.| |<|securityname|\-|`string`|<|SNMPv3 security name.<br><br>Used only by SNMPv3 items.| |<|securitylevel|\-|`string`|0 - NOAUTHNOPRIV (default)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|SNMPv3 security level.<br><br>Used only by SNMPv3 items.| |<|authprotocol|\-|`string`|0 - MD5 (default)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|SNMPv3 authentication protocol.<br><br>Used only by SNMPv3 items.| |<|authpassphrase|\-|`string`|<|SNMPv3 authentication passphrase.<br><br>Used only by SNMPv3 items.| |<|privprotocol|\-|`string`|0 - DES (default)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 privacy protocol.<br><br>Used only by SNMPv3 items.| |<|privpassphrase|\-|`string`|<|SNMPv3 privacy passphrase.<br><br>Used only by SNMPv3 items.| |<|bulk|\-|`string`|0 - NO<br>1 - YES (default)|Use bulk requests for SNMP.| |items|<|\-|<|<|Root element for items.| |<|*For item element tag values, see host [item](/manual/xml_export_import/hosts#host_item_tags) tags.*|<|<|<|<| |tags|<|\-|<|<|Root element for host tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.| |macros|<|\-|<|<|Root element for macros.| |<|macro|x|<|<|User macro name.| |<|type|\-|`string`|0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT|Type of the macro.| |<|value|\-|`string`|<|User macro value.| |<|description|\-|`string`|<|User macro description.| |inventory|<|\-|<|<|Root element for host inventory.| |<|<inventory\_property>|\-|<|<|Individual inventory property.<br><br>All available inventory properties are listed under the respective tags, e.g. <type>, <name>, <os> (see example above).| |inventory\_mode|<|\-|`string`|-1 - DISABLED<br>0 - MANUAL (default)<br>1 - AUTOMATIC|Inventory mode.| |valuemaps|<|\-|<|<|Root element for host value maps.| |<|name|x|`string`|<|Value map name.| |<|mapping|\-|<|<|Root element for mappings.| |<|value|x|`string`|<|Value of a mapping.| |<|newvalue|x|`string`|<|New value of a mapping.| ### Host tag The host tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host tag name.| |value|string|Host tag value.| ### Host tag Host tag オブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**tag**<br>(required)|string|Host tag name.| |value|string|Host tag value.| ### Host The host object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host.| |**host**<br>(required)|string|Technical name of the host.| |description|text|Description of the host.| |flags|integer|*(readonly)* Origin of the host.<br><br>Possible values:<br>0 - a plain host;<br>4 - a discovered host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |ipmi\_authtype|integer|IPMI authentication algorithm.<br><br>Possible values are:<br>-1 - *(default)* default;<br>0 - none;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|IPMI password.| |ipmi\_privilege|integer|IPMI privilege level.<br><br>Possible values are:<br>1 - callback;<br>2 - *(default)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI username.| |maintenance\_from|timestamp|*(readonly)* Starting time of the effective maintenance.| |maintenance\_status|integer|*(readonly)* Effective maintenance status.<br><br>Possible values are:<br>0 - *(default)* no maintenance;<br>1 - maintenance in effect.| |maintenance\_type|integer|*(readonly)* Effective maintenance type.<br><br>Possible values are:<br>0 - *(default)* maintenance with data collection;<br>1 - maintenance without data collection.| |maintenanceid|string|*(readonly)* ID of the maintenance that is currently in effect on the host.| |name|string|Visible name of the host.<br><br>Default: `host` property value.| |proxy\_hostid|string|ID of the proxy that is used to monitor the host.| |status|integer|Status and function of the host.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |tls\_connect|integer|Connections to host.<br><br>Possible values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_accept|integer|Connections from host.<br><br>Possible bitmap values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_issuer|string|Certificate issuer.| |tls\_subject|string|Certificate subject.| |tls\_psk\_identity|string|*(write-only)* PSK identity. Required if either `tls_connect` or `tls_accept` has PSK enabled.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |tls\_psk|string|*(write-only)* The preshared key, at least 32 hex digits. Required if either `tls_connect` or `tls_accept` has PSK enabled.| ### Host host オブジェクトは以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |hostid|string|*(readonly)* ID of the host.| |**host**<br>(required)|string|Technical name of the host.| |description|text|Description of the host.| |flags|integer|*(readonly)* Origin of the host.<br><br>Possible values:<br>0 - a plain host;<br>4 - a discovered host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |ipmi\_authtype|integer|IPMI authentication algorithm.<br><br>Possible values are:<br>-1 - *(default)* default;<br>0 - none;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|IPMI password.| |ipmi\_privilege|integer|IPMI privilege level.<br><br>Possible values are:<br>1 - callback;<br>2 - *(default)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI username.| |maintenance\_from|timestamp|*(readonly)* Starting time of the effective maintenance.| |maintenance\_status|integer|*(readonly)* Effective maintenance status.<br><br>Possible values are:<br>0 - *(default)* no maintenance;<br>1 - maintenance in effect.| |maintenance\_type|integer|*(readonly)* Effective maintenance type.<br><br>Possible values are:<br>0 - *(default)* maintenance with data collection;<br>1 - maintenance without data collection.| |maintenanceid|string|*(readonly)* ID of the maintenance that is currently in effect on the host.| |name|string|Visible name of the host.<br><br>Default: `host` property value.| |proxy\_hostid|string|ID of the proxy that is used to monitor the host.| |status|integer|Status and function of the host.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |tls\_connect|integer|Connections to host.<br><br>Possible values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_accept|integer|Connections from host.<br><br>Possible bitmap values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_issuer|string|Certificate issuer.| |tls\_subject|string|Certificate subject.| |tls\_psk\_identity|string|*(write-only)* PSK identity. Required if either `tls_connect` or `tls_accept` has PSK enabled.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |tls\_psk|string|*(write-only)* The preshared key, at least 32 hex digits. Required if either `tls_connect` or `tls_accept` has PSK enabled.| ##### Host trigger tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |triggers|<|\-|<|<|Root element for triggers.| |<|expression|x|`string`|<|Trigger expression.| |<|recovery\_mode|\-|`string`|0 - EXPRESSION (default)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Basis for generating OK events.| |<|recovery\_expression|\-|`string`|<|Trigger recovery expression.| |<|name|x|`string`|<|Trigger name.| |<|correlation\_mode|\-|`string`|0 - DISABLED (default)<br>1 - TAG\_VALUE|Correlation mode (no event correlation or event correlation by tag).| |<|correlation\_tag|\-|`string`|<|The tag name to be used for event correlation.| |<|url|\-|`string`|<|URL associated with the trigger.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Trigger status.| |<|priority|\-|`string`|0 - NOT\_CLASSIFIED (default)<br>1 - INFO<br>2 - WARNING<br>3 - AVERAGE<br>4 - HIGH<br>5 - DISASTER|Trigger severity.| |<|description|\-|`text`|<|Trigger description.| |<|type|\-|`string`|0 - SINGLE (default)<br>1 - MULTIPLE|Event generation type (single problem event or multiple problem events).| |<|manual\_close|\-|`string`|0 - NO (default)<br>1 - YES|Manual closing of problem events.| |dependencies|<|\-|<|<|Root element for dependencies.| |<|name|x|`string`|<|Dependency trigger name.| |<|expression|x|`string`|<|Dependency trigger expression.| |<|recovery\_expression|\-|`string`|<|Dependency trigger recovery expression.| |tags|<|\-|<|<|Root element for event tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.| ##### Host trigger タグ |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |triggers|<|\-|<|<|Root element for triggers.| |<|expression|x|`string`|<|Trigger expression.| |<|recovery\_mode|\-|`string`|0 - EXPRESSION (default)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Basis for generating OK events.| |<|recovery\_expression|\-|`string`|<|Trigger recovery expression.| |<|name|x|`string`|<|Trigger name.| |<|correlation\_mode|\-|`string`|0 - DISABLED (default)<br>1 - TAG\_VALUE|Correlation mode (no event correlation or event correlation by tag).| |<|correlation\_tag|\-|`string`|<|The tag name to be used for event correlation.| |<|url|\-|`string`|<|URL associated with the trigger.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Trigger status.| |<|priority|\-|`string`|0 - NOT\_CLASSIFIED (default)<br>1 - INFO<br>2 - WARNING<br>3 - AVERAGE<br>4 - HIGH<br>5 - DISASTER|Trigger severity.| |<|description|\-|`text`|<|Trigger description.| |<|type|\-|`string`|0 - SINGLE (default)<br>1 - MULTIPLE|Event generation type (single problem event or multiple problem events).| |<|manual\_close|\-|`string`|0 - NO (default)<br>1 - YES|Manual closing of problem events.| |dependencies|<|\-|<|<|Root element for dependencies.| |<|name|x|`string`|<|Dependency trigger name.| |<|expression|x|`string`|<|Dependency trigger expression.| |<|recovery\_expression|\-|`string`|<|Dependency trigger recovery expression.| |tags|<|\-|<|<|Root element for event tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.| # host.update # host.update ##### Host web scenario tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |httptests|<|\-|<|<|Root element for web scenarios.| |<|name|x|`string`|<|Web scenario name.| |<|delay|\-|`string`|Default: 1m|Frequency of executing the web scenario. Seconds, time unit with suffix or user macro.| |<|attempts|\-|`integer`|1-10 (default: 1)|The number of attempts for executing web scenario steps.| |<|agent|\-|`string`|Default: Zabbix|Client agent. Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.| |<|http\_proxy|\-|`string`|<|Specify an HTTP proxy to use, using the format: `http://[username[:password]@]proxy.example.com[:port]`| |variables|<|\-|<|<|Root element for scenario-level variables (macros) that may be used in scenario steps.| |<|name|x|`text`|<|Variable name.| |<|value|x|`text`|<|Variable value.| |headers|<|\-|<|<|Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|x|`text`|<|Header name.| |<|value|x|`text`|<|Header value.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Web scenario status.| |<|authentication|\-|`string`|0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication method.| |<|http\_user|\-|`string`|<|User name used for basic, HTTP or NTLM authentication.| |<|http\_password|\-|`string`|<|Password used for basic, HTTP or NTLM authentication.| |<|verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Verify the SSL certificate of the web server.| |<|verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Verify that the Common Name field or the Subject Alternate Name field of the web server certificate matches.| |<|ssl\_cert\_file|\-|`string`|<|Name of the SSL certificate file used for client authentication (must be in PEM format).| |<|ssl\_key\_file|\-|`string`|<|Name of the SSL private key file used for client authentication (must be in PEM format).| |<|ssl\_key\_password|\-|`string`|<|SSL private key file password.| |steps|<|x|<|<|Root element for web scenario steps.| |<|name|x|`string`|<|Web scenario step name.| |<|url|x|`string`|<|URL for monitoring.| |query\_fields|<|\-|<|<|Root element for query fields - an array of HTTP fields that will be added to the URL when performing a request.| |<|name|x|`string`|<|Query field name.| |<|value|\-|`string`|<|Query field value.| |posts|<|\-|<|<|HTTP POST variables as a string (raw post data) or as an array of HTTP fields (form field data).| |<|name|x|`string`|<|Post field name.| |<|value|x|`string`|<|Post field value.| |variables|<|\-|<|<|Root element of step-level variables (macros) that should be applied after this step.<br><br>If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix| |<|name|x|`string`|<|Variable name.| |<|value|x|`string`|<|Variable value.| |headers|<|\-|<|<|Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|x|`string`|<|Header name.| |<|value|x|`string`|<|Header value.| |<|follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP redirects.| |<|retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|HTTP response retrieve mode.| |<|timeout|\-|`string`|Default: 15s|Timeout of step execution. Seconds, time unit with suffix or user macro.| |<|required|\-|`string`|<|Text that must be present in the response. Ignored if empty.| |<|status\_codes|\-|`string`|<|A comma delimited list of accepted HTTP status codes. Ignored if empty. For example: 200-201,210-299| |tags|<|\-|<|<|Root element for web scenario tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.| ##### Host web scenario タグ |Element|Element プロパティ|必須？|型|レンジ^**[1](#footnotes)**^|説明| |-------|----------------|--------|----|--------------------------|-----------| |httptests|<|\-|<|<|Root element for web scenarios.| |<|name|x|`string`|<|Web scenario name.| |<|delay|\-|`string`|Default: 1m|Frequency of executing the web scenario. Seconds, time unit with suffix or user macro.| |<|attempts|\-|`integer`|1-10 (default: 1)|The number of attempts for executing web scenario steps.| |<|agent|\-|`string`|Default: Zabbix|Client agent. Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.| |<|http\_proxy|\-|`string`|<|Specify an HTTP proxy to use, using the format: `http://[username[:password]@]proxy.example.com[:port]`| |variables|<|\-|<|<|Root element for scenario-level variables (macros) that may be used in scenario steps.| |<|name|x|`text`|<|Variable name.| |<|value|x|`text`|<|Variable value.| |headers|<|\-|<|<|Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|x|`text`|<|Header name.| |<|value|x|`text`|<|Header value.| |<|status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Web scenario status.| |<|authentication|\-|`string`|0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication method.| |<|http\_user|\-|`string`|<|User name used for basic, HTTP or NTLM authentication.| |<|http\_password|\-|`string`|<|Password used for basic, HTTP or NTLM authentication.| |<|verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Verify the SSL certificate of the web server.| |<|verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Verify that the Common Name field or the Subject Alternate Name field of the web server certificate matches.| |<|ssl\_cert\_file|\-|`string`|<|Name of the SSL certificate file used for client authentication (must be in PEM format).| |<|ssl\_key\_file|\-|`string`|<|Name of the SSL private key file used for client authentication (must be in PEM format).| |<|ssl\_key\_password|\-|`string`|<|SSL private key file password.| |steps|<|x|<|<|Root element for web scenario steps.| |<|name|x|`string`|<|Web scenario step name.| |<|url|x|`string`|<|URL for monitoring.| |query\_fields|<|\-|<|<|Root element for query fields - an array of HTTP fields that will be added to the URL when performing a request.| |<|name|x|`string`|<|Query field name.| |<|value|\-|`string`|<|Query field value.| |posts|<|\-|<|<|HTTP POST variables as a string (raw post data) or as an array of HTTP fields (form field data).| |<|name|x|`string`|<|Post field name.| |<|value|x|`string`|<|Post field value.| |variables|<|\-|<|<|Root element of step-level variables (macros) that should be applied after this step.<br><br>If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix| |<|name|x|`string`|<|Variable name.| |<|value|x|`string`|<|Variable value.| |headers|<|\-|<|<|Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|x|`string`|<|Header name.| |<|value|x|`string`|<|Header value.| |<|follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP redirects.| |<|retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|HTTP response retrieve mode.| |<|timeout|\-|`string`|Default: 15s|Timeout of step execution. Seconds, time unit with suffix or user macro.| |<|required|\-|`string`|<|Text that must be present in the response. Ignored if empty.| |<|status\_codes|\-|`string`|<|A comma delimited list of accepted HTTP status codes. Ignored if empty. For example: 200-201,210-299| |tags|<|\-|<|<|Root element for web scenario tags.| |<|tag|x|`string`|<|Tag name.| |<|value|\-|`string`|<|Tag value.| #### - Housekeeper The housekeeper is a periodical process, executed by Zabbix server. The process removes outdated information and information deleted by user.  In this section housekeeping tasks can be enabled or disabled on a per-task basis separately for: events and alerts/IT services/user sessions/history/trends. Audit housekeeping settings are available in a separate [menu section](/manual/web_interface/frontend_sections/administration/general#audit_log). If housekeeping is enabled, it is possible to set for how many days data records will be kept before being removed by the housekeeper. Deleting an item/trigger will also delete problems generated by that item/trigger. Also, an event will only be deleted by the housekeeper if it is not associated with a problem in any way. This means that if an event is either a problem or recovery event, it will not be deleted until the related problem record is removed. The housekeeper will delete problems first and events after, to avoid potential problems with stale events or problem records. For history and trends an additional option is available: *Override item history period* and *Override item trend period*. This option allows to globally set for how many days item history/trends will be kept (1 hour to 25 years; or "​0"​), in this case overriding the values set for individual items in *History storage period/Trend storage period* fields in [item configuration](/manual/config/items/item). Note, that the storage period will not be overridden for items that have configuration option *Do not keep history* and/or *Do not keep trends* enabled. It is possible to override the history/trend storage period even if internal housekeeping is disabled. Thus, when using an external housekeeper, the history storage period could be set using the history *Data storage period* field. ::: noteimportant If using TimescaleDB, in order to take full advantage of TimescaleDB automatic partitioning of history and trends tables, *Override item history period* and *Override item trend period* options must be enabled as well as *Enable internal housekeeping* option for history and trends. Otherwise, the data kept in these tables will still be stored in partitions, however, the housekeeper will be cleaning the history and trends by deleting individual records rather than by dropping outdated partitions. When dropping of outdated partitions is enabled, Zabbix server and frontend will no longer keep track of deleted items and history for deleted items will be cleared when an outdated partition is deleted. ::: [Time suffixes](/manual/appendix/suffixes) are supported in the period fields, e.g. 1d (one day), 1w (one week). The minimum is 1 day (1 hour for history), the maximum - 25 years. *Reset defaults* button allows to revert any changes made. #### - Housekeeper The housekeeper is a periodical process, executed by Zabbix server. The process removes outdated information and information deleted by user.  In this section housekeeping tasks can be enabled or disabled on a per-task basis separately for: events and alerts/IT services/user sessions/history/trends. Audit housekeeping settings are available in a separate [menu section](/manual/web_interface/frontend_sections/administration/general#audit_log). If housekeeping is enabled, it is possible to set for how many days data records will be kept before being removed by the housekeeper. Deleting an item/trigger will also delete problems generated by that item/trigger. Also, an event will only be deleted by the housekeeper if it is not associated with a problem in any way. This means that if an event is either a problem or recovery event, it will not be deleted until the related problem record is removed. The housekeeper will delete problems first and events after, to avoid potential problems with stale events or problem records. For history and trends an additional option is available: *Override item history period* and *Override item trend period*. This option allows to globally set for how many days item history/trends will be kept (1 hour to 25 years; or "​0"​), in this case overriding the values set for individual items in *History storage period/Trend storage period* fields in [item configuration](/manual/config/items/item). Note, that the storage period will not be overridden for items that have configuration option *Do not keep history* and/or *Do not keep trends* enabled. It is possible to override the history/trend storage period even if internal housekeeping is disabled. Thus, when using an external housekeeper, the history storage period could be set using the history *Data storage period* field. ::: noteimportant If using TimescaleDB, in order to take full advantage of TimescaleDB automatic partitioning of history and trends tables, *Override item history period* and *Override item trend period* options must be enabled as well as *Enable internal housekeeping* option for history and trends. Otherwise, the data kept in these tables will still be stored in partitions, however, the housekeeper will be cleaning the history and trends by deleting individual records rather than by dropping outdated partitions. When dropping of outdated partitions is enabled, Zabbix server and frontend will no longer keep track of deleted items and history for deleted items will be cleared when an outdated partition is deleted. ::: [Time suffixes](/manual/appendix/suffixes) are supported in the period fields, e.g. 1d (one day), 1w (one week). The minimum is 1 day (1 hour for history), the maximum - 25 years. *Reset defaults* button allows to revert any changes made. # housekeeping.get # housekeeping.get ### Housekeeping The settings object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hk\_events\_mode|integer|Enable internal housekeeping for events and alerts.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_events\_trigger|string|Trigger data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_events\_service|string|Service data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_internal|string|Internal data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_discovery|string|Network discovery data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_autoreg|string|Autoregistration data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_services\_mode|integer|Enable internal housekeeping for services.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_services|string|Services data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_audit\_mode|integer|Enable internal housekeeping for audit.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_audit|string|Audit data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_sessions\_mode|integer|Enable internal housekeeping for sessions.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_sessions|string|Sessions data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_history\_mode|integer|Enable internal housekeeping for history.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_history\_global|integer|Override item history period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_history|string|History data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 90d.| |hk\_trends\_mode|integer|Enable internal housekeeping for trends.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_trends\_global|integer|Override item trend period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_trends|string|Trends data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |db\_extension|string|*(readonly)* Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.| |compression\_status|integer|Enable TimescaleDB compression for history and trends.<br><br>Possible values:<br>0 - *(default)* Off;<br>1 - On.| |compress\_older|string|Compress history and trends records older than specified period. Accepts seconds and time unit with suffix.<br><br>Default: 7d.| |compression\_availability|integer|*(readonly)* Compression availability.<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.| ### Housekeeping settings オブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |hk\_events\_mode|integer|Enable internal housekeeping for events and alerts.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_events\_trigger|string|Trigger data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_events\_service|string|Service data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_internal|string|Internal data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_discovery|string|Network discovery data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_autoreg|string|Autoregistration data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_services\_mode|integer|Enable internal housekeeping for services.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_services|string|Services data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_audit\_mode|integer|Enable internal housekeeping for audit.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_audit|string|Audit data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_sessions\_mode|integer|Enable internal housekeeping for sessions.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_sessions|string|Sessions data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_history\_mode|integer|Enable internal housekeeping for history.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_history\_global|integer|Override item history period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_history|string|History data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 90d.| |hk\_trends\_mode|integer|Enable internal housekeeping for trends.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_trends\_global|integer|Override item trend period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_trends|string|Trends data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |db\_extension|string|*(readonly)* Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.| |compression\_status|integer|Enable TimescaleDB compression for history and trends.<br><br>Possible values:<br>0 - *(default)* Off;<br>1 - On.| |compress\_older|string|Compress history and trends records older than specified period. Accepts seconds and time unit with suffix.<br><br>Default: 7d.| |compression\_availability|integer|*(readonly)* Compression availability.<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.| # housekeeping.update # housekeeping.update #### How it works In log monitoring you may encounter lines similar to these: Line1: Application 1 stopped Line2: Application 2 stopped Line3: Application 1 was restarted Line4: Application 2 was restarted The idea of event correlation is to be able to match the problem event from Line1 to the resolution from Line3 and the problem event from Line2 to the resolution from Line4, and close these problems one by one: Line1: Application 1 stopped Line3: Application 1 was restarted #problem from Line 1 closed Line2: Application 2 stopped Line4: Application 2 was restarted #problem from Line 2 closed To do this you need to tag these related events as, for example, "Application 1" and "Application 2". That can be done by applying a regular expression to the log line to extract the tag value. Then, when events are created, they are tagged "Application 1" and "Application 2" respectively and problem can be matched to the resolution. #### 仕組み ログモニタリングでは、以下のような行が表示されることがあります: Line1: Application 1 stopped Line2: Application 2 stopped Line3: Application 1 was restarted Line4: Application 2 was restarted イベント相関の考え方は、Line1からの問題イベントとLine3からの解決、Line2からの問題イベントとLine4からの解決を<br> 一致させ、これらの問題を1つずつ解決することができることです: Line1: Application 1 stopped Line3: Application 1 was restarted #problem from Line 1 closed Line2: Application 2 stopped Line4: Application 2 was restarted #problem from Line 2 closed そのためには、これらの関連するイベントに、例えば "アプリケーション1" や "アプリケーション2" のようなタグを付ける<br> 必要があります。これは、ログラインに正規表現を適用して、タグの値を抽出することで実現できます。その後、イベントが<br> 作成されると、それぞれ "アプリケーション1" と "アプリケーション2" というタグが付けられ、問題を解決するために<br> 照合することができます。 #### HP OpenView Zabbix can be configured to send messages to OpenView server. The following steps must be performed: #### HP OpenView Zabbixは、メッセージを OpenView サーバーに送信するように設定できます。 次の手順を実行する必要があります。 ### HTML support in Geomap attribution dropped The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped. If this field already contains HTML, it will be rendered as plain text after the upgrade. In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*. ### 地理マップアトリビューションのHTMLサポートの終了 [地理マップダッシュボードウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap)のアトリビューションテキストはプレーンテキストのみ対応になりました。HTMLのサポートは終了しました。 [地理マップ](/manual/web_interface/frontend_sections/administration/general#geographical-maps)の設定では、管理 → 一般セクションで、*アトリビューション*欄は、*タイルプロバイダー*が*その他*に設定されている場合のみ表示されるようになりました。このフィールドに既にHTMLが含まれている場合、アップグレード後にプレーンテキストとして表示されます。 ### HTML support in Geomap attribution dropped The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped. In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*. ### 地理マップアトリビューションのHTMLサポートの終了 [地理マップダッシュボードウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap)のアトリビューションテキストはプレーンテキストのみ対応になりました。HTMLのサポートは終了しました。 [地理マップ](/manual/web_interface/frontend_sections/administration/general#geographical-maps)の設定では、管理 → 一般セクションで、*アトリビューション*欄は、*タイルプロバイダー*が*その他*に設定されている場合のみ表示されるようになりました。 ### HTTP authentication HTTP or web server-based authentication (for example: Basic Authentication, NTLM/Kerberos) can be used to check user names and passwords. Note that a user must exist in Zabbix as well, however its Zabbix password will not be used. ::: noteimportant Be careful! Make sure that web server authentication is configured and works properly before switching it on. ::: {width="600"} Configuration parameters: |Parameter|Description| |--|--------| |*Enable HTTP authentication*|Mark the checkbox to enable HTTP authentication. Hovering the mouse over  will bring up a hint box warning that in the case of web server authentication, all users (even with [frontend access](/manual/config/users_and_usergroups/usergroup#configuration) set to LDAP/Internal) will be authenticated by the web server, not by Zabbix.| |*Default login form*|Specify whether to direct non-authenticated users to:<br>**Zabbix login form** - standard Zabbix login page.<br>**HTTP login form** - HTTP login page.<br>It is recommended to enable web-server based authentication for the `index_http.php` page only. If *Default login form* is set to 'HTTP login page' the user will be logged in automatically if web server authentication module will set valid user login in the `$_SERVER` variable.<br>Supported `$_SERVER` keys are `PHP_AUTH_USER`, `REMOTE_USER`, `AUTH_USER`.| |*Remove domain name*|A comma-delimited list of domain names that should be removed from the username.<br>E.g. `comp,any` - if username is 'Admin\@any', 'comp\\Admin', user will be logged in as 'Admin'; if username is 'notacompany\\Admin', login will be denied.| |*Case sensitive login*|Unmark the checkbox to disable case-sensitive login for usernames (enabled by default).<br>Disabling case-sensitive login allows, for example, to log in as "admin" even if the Zabbix user is "Admin" or "ADMIN".<br>Please note that if case-sensitive login is disabled and there are multiple Zabbix users with similar usernames (e.g., Admin and admin), the login for those users will always be denied with the following error message: "Authentication failed: supplied credentials are not unique."| ::: notetip For internal users who are unable to log in using HTTP credentials (with HTTP login form set as default) leading to the 401 error, you may want to add a `ErrorDocument 401 /index.php?form=default` line to basic authentication directives, which will redirect to the regular Zabbix login form. ::: ### HTTP認証の設定 HTTPまたはWebサーバーベースの認証（例：Basic認証、NTLM / Kerberos）を使用して、ユーザー名とパスワードを確認できます。ユーザーはZabbixにも存在する必要がありますが、そのZabbixパスワードは使用されないことに注意してください。 ::: noteimportant オンにする前に、Webサーバー認証が構成され、正しく機能していることを確認してください。 :::  設定値: |パラメーター|説明| |--|--------| |*HTTP認証の有効化*|チェックボックスをオンにすると、HTTP認証が有効になります。| |*デフォルトのログイン画面*|認証されていないユーザーをどの画面に誘導するかを指定します：<br>**Zabbixのログイン画面** - 標準のZabbixログインページ<br>**HTTPのログイン画面** - HTTPログインページ<br>`index_http.php`ページに対してのみWebサーバーベースの認証を有効にすることをお勧めします。 *デフォルトのログイン画面*が'HTTPログインページ'に設定されている場合、Webサーバー認証モジュールが`$_SERVER`変数に有効なユーザーログインを設定すると、ユーザーは自動的にログインします。<br>サポートされている`$_SERVER`キーは`PHP_AUTH_USER`, `REMOTE_USER`,`AUTH_USER`です。| |*ドメイン名の削除*|ユーザー名から削除する必要があるドメイン名のカンマ区切りのリスト。<br>例： `comp,any` - ユーザー名が'Admin\@any','comp\\Admin'の場合、ユーザーは'Admin'としてログインします。ユーザー名が'notacompany\\Admin'の場合、ログインは拒否されます。| |*ログイン時に大文字小文字を区別*|チェックボックスをオフにすると、ユーザー名の大文字と小文字を区別したログインが無効になります。(デフォルトでは有効)<br>大文字と小文字を区別するログインを無効にすると、Zabbixに登録されたユーザーが'Admin'または'ADMIN'であっても、'admin'としてログインできます。<br>大文字と小文字を区別するログインが無効で、類似したユーザー名(例: Adminとadmin)が複数Zabbixのユーザーとして登録されている場合、これらのユーザーのログインは常に拒否され、次のエラー メッセージが表示されます: "認証に失敗しました：指定された資格情報はユニークではありません。"| ::: notetip (HTTPログインフォームがデフォルトとして設定している)HTTP認証情報を使用してログインできず、401エラーが発生する内部ユーザーは、Basic認証ディレクティブに `ErrorDocument 401/index.php?form=default`行を追加すると、通常のZabbixログイン画面にリダイレクトされます。 ::: ### HTTP field The HTTP field object defines a name and value that is used to specify variable, HTTP header, POST form field data of query field data. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of header / variable / POST or GET field.| |**value**<br>(required)|string|Value of header / variable / POST or GET field.| ### HTTP field HTTP fieldオブジェクトは、クエリフィールドデータの変数、HTTPヘッダー、POSTフォームフィールドデータを指定するために使用される名前と値を定義します。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**name**<br>(必須)|string|ヘッダー/変数/POSTまたはGETフィールドの名前| |**value**<br>(必須)|string|ヘッダー/変数/POSTまたはGETフィールドの値| #### HTTPS checks Web scenarios and HTTP agent items using the https protocol, Zabbix agent checks `net.tcp.service[https...]` and `net.tcp.service.perf[https...]` may fail if the target server is configured to disallow TLS v1.0 protocol or below. Please see [ZBX-9879](https://support.zabbix.com/browse/ZBX-9879) for more information and available workarounds. #### HTTPSチェック httpsプロトコルを使用するWebシナリオとHTTPエージェントのアイテムは、 <br> Zabbix agent が `net.tcp.service[https...]` と `net.tcp.service.perf[https...]` をチェックします。 <br> net.tcp.service.perf[https...]`は、ターゲットサーバがTLS v.1.0を許可しないように設定されている場合、失敗する可能性があります。 <br> [ZBX-9879](https://support.zabbix.com/browse/ZBX-9879)を参照してください。 <br> # HTTP template operation Steps to ensure correct operation of templates that collect metrics with [HTTP agent](/manual/config/items/itemtypes/http): 1\. Create a host in Zabbix and specify an IP address or DNS name of the monitoring target as the main interface. This is needed for the {HOST.CONN} macro to resolve properly in the template items.\ 2. [Link](/manual/config/templates/linking#linking_a_template) the template to the host created in step 1 (if the template is not available in your Zabbix installation, you may need to import the template's .xml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions).\ 3. Adjust the values of mandatory macros as needed.\ 4. Configure the instance being monitored to allow sharing data with Zabbix - see instructions in the *Additional steps/comments* column. ::: notetip This page contains only a minimum set of macros and setup steps that are required for proper template operation. A detailed description of a template, including the full list of macros, items and triggers, is available in the template's Readme.md file (accessible by clicking on a template name). ::: |Template|Mandatory macros|Additional steps/comments| |--------|----------------|-------------------------| |[Apache by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_http)|**{$APACHE.STATUS.HOST}** - the hostname or IP address of Apache status page (default: 127.0.0.1).<br>**{$APACHE.STATUS.PATH}** - the URL path (default: server-status?auto).<br>**{$APACHE.STATUS.PORT}** - the port of Apache status page (default: 80).<br>**{$APACHE.STATUS.SCHEME}** - the request scheme. Supported: http (default), https.|Apache module mod\_status should be set (see Apache [documentation](https://httpd.apache.org/docs/current/mod/mod_status.html) for details).<br>To check availability, run:<br>`httpd -M 2>/dev/null \| grep status_module`<br><br>Apache configuration example:<br>`<Location "/server-status">`<br>`SetHandler server-status`<br>`Require host example.com`<br>`</Location>`| |[Asterisk by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/tel/asterisk_http)|**{$AMI.PORT}** - AMI port number for checking service availability (default: 8088).<br>**{$AMI.SECRET}** - the Asterisk Manager secret (default: zabbix).<br>**{$AMI.URL}** - the Asterisk Manager API URL in the format<br>`<scheme>://<host>:<port>/<prefix>/rawman`<br>(default: http://asterisk:8088/asterisk/rawman).<br>**{$AMI.USERNAME}** - the Asterisk Manager name.|1\. Enable the [mini-HTTP Server](https://wiki.asterisk.org/wiki/display/AST/Asterisk+Builtin+mini-HTTP+Server).<br><br>2. Add the option `webenabled=yes` to the general section of *manager.conf* file.<br><br>3. Create *Asterisk Manager* user in the Asterisk instance.| |[ClickHouse by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/clickhouse_http/README.md)|**{$CLICKHOUSE.PORT}** - the port of ClickHouse HTTP endpoint (default: 8123).<br>**{$CLICKHOUSE.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$CLICKHOUSE.USER}**, **{$CLICKHOUSE.PASSWORD}** - ClickHouse login credentials (default username: zabbix, password: zabbix\_pass).<br>If you don't need authentication, remove headers from HTTP agent type items.|Create a ClickHouse user with a 'web' profile and permission to view databases (see ClickHouse [documentation](https://clickhouse.tech/docs/en/operations/settings/settings-users/) for details).<br><br>See template's *Readme.md* file for a ready-to-use zabbix.xml file configuration.| |[Cloudflare by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/cloudflare_http/README.md)|**{$CLOUDFLARE.API.TOKEN}** - Cloudflare API token value (default: \`<change>\`).<br>**{$CLOUDFLARE.ZONE\_ID}** - Cloudflare Site Zone ID (default: \`<change>\`).|Cloudflare API Tokens are available in the Cloudflare account under *My Profile→ API Tokens*.<br>Zone ID is available in the Cloudflare account under *Account Home → Site*.| |[DELL PowerEdge R720 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r720_http/README.md),<br>[DELL PowerEdge R740 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r740_http/README.md),<br>[DELL PowerEdge R820 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r820_http/README.md),<br>[DELL PowerEdge R840 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r840_http/README.md)|**{$API.URL}** - Dell iDRAC Redfish API URL in the format `<scheme>://<host>:<port>` (default: <Put your URL here>)<br>**{$API.USER}**, **{$API.PASSWORD}** - Dell iDRAC login credentials (default: not set).|In the Dell iDRAC interface of your server:<br>1. Enable Redfish API .<br>2. Create a user for monitoring with read-only permissions.| |[Elasticsearch Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/elasticsearch_http/README.md)|**{$ELASTICSEARCH.PORT}** - the port of the Elasticsearch host (default: 9200).<br>**{$ELASTICSEARCH.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$ELASTICSEARCH.USERNAME}**, **{$ELASTICSEARCH.PASSWORD}** - login credentials, required only if used for Elasticsearch authentication.|<| |[Etcd by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/etcd_http/README.md)|**{$ETCD.PORT}**- the port used by Etcd API endpoint (default: 2379).<br>**{$ETCD.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$ETCD.USER}**, **{$ETCD.PASSWORD}** - login credentials, required only if used for Etcd authentication.|Metrics are collected from /metrics endpoint; to specify the endpoint's location use `--listen-metrics-urls` flag (see Etcd [documentation](https://github.com/etcd-io/website/blob/master/content/docs/v3.4.0/op-guide/configuration.md#--listen-metrics-urls) for details).<br><br>To verify, whether Etcd is configured to allow metric collection, run:<br>`curl -L http://localhost:2379/metrics`<br><br>To check, if Etcd is accessible from Zabbix proxy or Zabbix server run:<br>`curl -L http:%%//<etcd_node_adress>:2379/metrics%%`<br><br>The template should be added to each node with Etcd.| |[GitLab by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/gitlab_http)|**{$GITLAB.PORT}** - the port of GitLab web endpoint (default: 80)<br>**{$GITLAB.URL}** - GitLab instance URL (default: localhost)|This template works with self-hosted GitLab instances; metrics are collected from the `/metrics` endpoint.<br><br>To access the metrics, the client IP address must be explicitly allowed (see [GitLab documentation](https://docs.gitlab.com/ee/administration/monitoring/ip_whitelist.html) for details).<br><br>Note, that certain metrics may not be available for a particular GitLab instance version and configuration.| |[Hadoop by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/hadoop_http/README.md)|**{$HADOOP.NAMENODE.HOST}** - the Hadoop NameNode host IP address or FQDN (default: NameNode).<br>**{$HADOOP.NAMENODE.PORT}** - the Hadoop NameNode web-UI port (default: 9870).<br>**{$HADOOP.RESOURCEMANAGER.HOST}** - the Hadoop ResourceManager host IP address or FQDN (default: ResourceManager).<br>**{$HADOOP.RESOURCEMANAGER.PORT}** - the Hadoop ResourceManager web-UI port (default: 8088).|Metrics are collected by polling the Hadoop API remotely using an HTTP agent and JSONPath preprocessing. Zabbix server (or proxy) executes direct requests to ResourceManager, NodeManagers, NameNode, DataNodes APIs.| |[HAProxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_http/README.md)|**{$HAPROXY.STATS.PATH}** - the path of HAProxy Stats page (default: stats).<br>**{$HAPROXY.STATS.PORT}** - the port of the HAProxy Stats host or container (default: 8404).<br>**{$HAPROXY.STATS.SCHEME}** - the request scheme. Supported: http (default), https.|HAProxy Stats page should be set up (see HAProxy [blog post](https://www.haproxy.com/blog/exploring-the-haproxy-stats-page/) for details or template's Readme.md for configuration example).| |[HashiCorp Vault by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vault_http/README.md)|**{$VAULT.API.PORT}** - the port on which the Vault listens for API requests (default: 8200).<br>**{$VAULT.API.SCHEME}** - the API request scheme. Supported: http (default), https.<br>**{$VAULT.HOST}** - Vault host name (default: <PUT YOUR VAULT HOST>).<br>**{$VAULT.TOKEN}** - Vault authorization token (default: <PUT YOUR AUTH TOKEN>).|1\. Configure the Vault API (see [official documentation](https://www.vaultproject.io/docs/configuration) for details).<br>2. Create a Vault service token, then copy and paste it into {$VAULT.TOKEN} macro value in Zabbix.| |[Hikvision camera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cctv/hikvision/README.md)|**{$HIKVISION\_ISAPI\_PORT}** - ISAPI port on a device (default: 80).<br>**{$USER}**, **{$PASSWORD}** - camera login credentials (default username: admin, password: 1234).|<| |[InfluxDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/influxdb_http/README.md)|**{$INFLUXDB.API.TOKEN}** - InfluxDB API authorization token (default: \`\`).<br>**{$INFLUXDB.URL}** - InfluxDB instance URL in the format `<scheme>://<host>:<port>` (default: http://localhost:8086).|This template collects internal service metrics from the InfluxDB /metrics endpoint of self-hosted InfluxDB instances.<br><br>See InfluxDB [documentation](https://docs.influxdata.com/influxdb/v2.0/security/tokens/) for details.| |[Jenkins by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jenkins/README.md)|**{$JENKINS.API.KEY}** - API key to access Metrics Servlet; required for common metrics (default: \`\`).<br>**{$JENKINS.API.TOKEN}** - API token for HTTP BASIC authentication; required for monitoring computers and builds (default: \`\`).<br>**{$JENKINS.URL}** - Jenkins URL in the format `<scheme>://<host>:<port>`; required for monitoring computers and builds (default: \`\`).<br>**{$JENKINS.USER}** - username for HTTP BASIC authentication; required for monitoring computers and builds (default: zabbix).|Metrics are collected by requests to Metrics API.<br><br>For common metrics: install and configure Metrics plugin parameters according to the [official documentation](https://plugins.jenkins.io/metrics/). Issue an API key for access to the Metrics Servlet, then use it as {$JENKINS.API.KEY} macro value.<br><br>For monitoring computers and builds: create an API token for the Jenkins user that will be used for monitoring, then use it as {$JENKINS.API.TOKEN} macro value. See Jenkins [documentation](https://www.jenkins.io/doc/book/system-administration/authenticating-scripted-clients/) for details.| |[Microsoft SharePoint by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md)|**{$SHAREPOINT.URL}** - portal page URL, for example *http://sharepoint.companyname.local/* (default: \`\`).<br>**{$SHAREPOINT.ROOT}** - a root directory; only the specified directory and all its subfolders will be monitored (default: /Shared Documents)<br>**{$SHAREPOINT.USER}**, **{$SHAREPOINT.PASSWORD}** - SharePoint login credentials (default: not set).|The template contains additional macros, which can be used to filter out certain dictionaries and types during LLD process (see template's [Readme.md](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md) for the description of available filter macros).| |[NetApp AFF A700 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/netapp_aff_a700_http/README.md)|**{$URL}** - AFF700 cluster URL address (default: ' ' )<br>**{$USERNAME}**, **{PASSWORD}** - AFF700 login credentials (default: not set).|Create a host for AFF A700 with cluster management IP as the Zabbix agent interface.| |[NGINX by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_http/README.md)|**{$NGINX.STUB\_STATUS.HOST}** - the hostname or IP address of NGINX stub\_status host or container (default: localhost).<br>**{$NGINX.STUB\_STATUS.PATH}** - the path of NGINX stub\_status page (default: basic\_status).<br>**{$NGINX.STUB\_STATUS.PORT}** - the port of NGINX stub\_status host or container (default: 80).<br>**{$NGINX.STUB\_STATUS.SCHEME}** - the request scheme. Supported: http (default), https.|`'ngx_http_stub_status_module` should be set up (see NGINX [documentation](https://nginx.org/en/docs/http/ngx_http_stub_status_module.html) for details or template's Readme.md for configuration example).<br>To check availability, run:<br>`nginx -V 2>&1 \| grep -o with-http_stub_status_module`| |[NGINX Plus by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_plus_http/README.md)|**{$NGINX.API.ENDPOINT}** - NGINX Plus API URL in the format `<scheme>://<host>:<port>/<location>/` (default: ' ').|1\. Enable NGINX Plus API (see NGINX [documentation](https://www.nginx.com/products/nginx/live-activity-monitoring/) for details).<br>2. Set the macro {$NGINX.API.ENDPOINT}<br>3. If required, use other template macros to filter out discovery operations and discover only required zones and upstreams.| |[PHP-FPM by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md)|**{$PHP\_FPM.HOST}** - a hostname or an IP of PHP-FPM status host or container (default: localhost).<br>**{$PHP\_FPM.PING.PAGE}** - PHP-FPM ping page path (default:ping).<br>**{$PHP\_FPM.PORT}** - the port of PHP-FPM status host or container (default: 80).<br>**{$PHP\_FPM.PROCESS\_NAME}** - PHP-FPM process name (default: php-fpm).<br>**{$PHP\_FPM.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$PHP\_FPM.STATUS.PAGE}** - PHP-FPM status page path (default:`status`).|1\. Open the php-fpm configuration file and enable the status page:<br>`pm.status_path = /status`<br>`ping.path = /ping`<br><br>2. Validate the syntax: `$ php-fpm7 -t`<br><br>3. Reload the php-fpm service.<br><br>4. In the Nginx Server Block (virtual host) configuration file, add (see template's *Readme.md* for an expanded example with comments):<br>`location ~ ^/(status\|ping)$ {`<br>`access_log off;`<br>`fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;`<br>`fastcgi_index index.php;`<br>`include fastcgi_params;`<br>`fastcgi_pass 127.0.0.1:9000;`<br>`}`<br><br>5. Check the syntax: `$ nginx -t`<br><br>6. Reload Nginx<br><br>7. Verify: `curl -L 127.0.0.1/status`| |[RabbitMQ cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_http/README.md)|**{$RABBITMQ.API.CLUSTER\_HOST}** - the hostname or IP address of RabbitMQ cluster API endpoint (default: 127.0.0.1).<br>**{$RABBITMQ.API.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$RABBITMQ.API.USER}**, **{$RABBITMQ.API.PASSWORD}** - RabbitMQ login credentials (default username: zbx\_monitor, password: zabbix).|Enable RabbitMQ management plugin (see [RabbitMQ documentation](https://www.rabbitmq.com/management.html)).<br><br>To create a RabbitMQ user with necessary permissions for monitoring, run:<br>'' rabbitmqctl add\_user zbx\_monitor <PASSWORD> ''<br>`rabbitmqctl set_permissions -p / zbx_monitor %% "" "" ".*"%%`<br>`rabbitmqctl set_user_tags zbx_monitor monitoring`<br><br>If the cluster consists of several nodes, it is recommended to assign the cluster template to a separate balancing host. In case of a single-node installation, the cluster template can be assigned to the host with a node template.| |[TiDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tidb_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 10080)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with TiDB server of PingCAP TiDB cluster.<br>Internal service metrics are collected from TiDB /metrics endpoint and TiDB monitoring API.| |[TiDB PD by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_pd_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 2379)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with PD server of PingCAP TiDB cluster.<br>Internal service metrics are collected from PD /metrics endpoint and TiDB monitoring API.| |[TiDB TiKV by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tikv_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 20180)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with TiKV server of PingCAP TiDB cluster.<br>Internal service metrics are collected from TiKV /metrics endpoint.| |[Travis CI by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/travis_http/README.md)|**{$TRAVIS.API.TOKEN}** - Travis API Token (default: not set)<br>**{$TRAVIS.API.URL}** - Travis API URL (default: api.travis-ci.com).|Travis API authentication token can be found in the *User → Settings → API authentication* section.<br>{$TRAVIS.API.URL} format for a private project is *api.travis-ci.com*.<br>{$TRAVIS.API.URL} format for an enterprise project is *api.example.com* (replace example.com with the domain Travis CI is running on).| |[VMWare SD-WAN VeloCloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md)|**{$VELOCLOUD.TOKEN}** - VMware SD-WAN Orchestrator API Token (default: \`\`).<br>**{$VELOCLOUD.URL}** - VMware SD-WAN Orchestrator URL, for example, *velocloud.net* (default: \`\`).|API token should be created in the VMware SD-WAN Orchestrator (see [VMware documentation](https://docs.vmware.com/en/VMware-SD-WAN/4.0/vmware-sd-wan-operator-guide/GUID-C150D536-A75F-47C1-8AFF-17C417F40C1D.html) for details).| |[ZooKeeper by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zookeeper_http/README.md)|**{$ZOOKEEPER.COMMAND\_URL}** - admin.commandURL; the URL for listing and issuing commands relative to the root URL (default: commands).<br>**{ZOOKEEPER.PORT}** - admin.serverPort; the port the embedded Jetty server listens on (default: 8080).<br>**{$ZOOKEEPER.SCHEME}** - the request scheme. Supported: http (default), https.|Metrics are collected from each ZooKeeper node by requests to AdminServer (enabled by default). See [ZooKeeper documentation](https://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_adminserver_config) to enable or configure AdminServer.| # HTTP template operation Steps to ensure correct operation of templates that collect metrics with [HTTP agent](/manual/config/items/itemtypes/http): 1\. Create a host in Zabbix and specify an IP address or DNS name of the monitoring target as the main interface. This is needed for the {HOST.CONN} macro to resolve properly in the template items.\ 2. [Link](/manual/config/templates/linking#linking_a_template) the template to the host created in step 1 (if the template is not available in your Zabbix installation, you may need to import the template's .xml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions).\ 3. Adjust the values of mandatory macros as needed.\ 4. Configure the instance being monitored to allow sharing data with Zabbix - see instructions in the *Additional steps/comments* column. ::: notetip This page contains only a minimum set of macros and setup steps that are required for proper template operation. A detailed description of a template, including the full list of macros, items and triggers, is available in the template's Readme.md file (accessible by clicking on a template name). ::: |Template|Mandatory macros|Additional steps/comments| |--------|----------------|-------------------------| |[Apache by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_http)|**{$APACHE.STATUS.HOST}** - the hostname or IP address of Apache status page (default: 127.0.0.1).<br>**{$APACHE.STATUS.PATH}** - the URL path (default: server-status?auto).<br>**{$APACHE.STATUS.PORT}** - the port of Apache status page (default: 80).<br>**{$APACHE.STATUS.SCHEME}** - the request scheme. Supported: http (default), https.|Apache module mod\_status should be set (see Apache [documentation](https://httpd.apache.org/docs/current/mod/mod_status.html) for details).<br>To check availability, run:<br>`httpd -M 2>/dev/null \| grep status_module`<br><br>Apache configuration example:<br>`<Location "/server-status">`<br>`SetHandler server-status`<br>`Require host example.com`<br>`</Location>`| |[Asterisk by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/tel/asterisk_http)|**{$AMI.PORT}** - AMI port number for checking service availability (default: 8088).<br>**{$AMI.SECRET}** - the Asterisk Manager secret (default: zabbix).<br>**{$AMI.URL}** - the Asterisk Manager API URL in the format<br>`<scheme>://<host>:<port>/<prefix>/rawman`<br>(default: http://asterisk:8088/asterisk/rawman).<br>**{$AMI.USERNAME}** - the Asterisk Manager name.|1\. Enable the [mini-HTTP Server](https://wiki.asterisk.org/wiki/display/AST/Asterisk+Builtin+mini-HTTP+Server).<br><br>2. Add the option `webenabled=yes` to the general section of *manager.conf* file.<br><br>3. Create *Asterisk Manager* user in the Asterisk instance.| |[ClickHouse by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/clickhouse_http/README.md)|**{$CLICKHOUSE.PORT}** - the port of ClickHouse HTTP endpoint (default: 8123).<br>**{$CLICKHOUSE.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$CLICKHOUSE.USER}**, **{$CLICKHOUSE.PASSWORD}** - ClickHouse login credentials (default username: zabbix, password: zabbix\_pass).<br>If you don't need authentication, remove headers from HTTP agent type items.|Create a ClickHouse user with a 'web' profile and permission to view databases (see ClickHouse [documentation](https://clickhouse.tech/docs/en/operations/settings/settings-users/) for details).<br><br>See template's *Readme.md* file for a ready-to-use zabbix.xml file configuration.| |[Cloudflare by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/cloudflare_http/README.md)|**{$CLOUDFLARE.API.TOKEN}** - Cloudflare API token value (default: \`<change>\`).<br>**{$CLOUDFLARE.ZONE\_ID}** - Cloudflare Site Zone ID (default: \`<change>\`).|Cloudflare API Tokens are available in the Cloudflare account under *My Profile→ API Tokens*.<br>Zone ID is available in the Cloudflare account under *Account Home → Site*.| |[DELL PowerEdge R720 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r720_http/README.md),<br>[DELL PowerEdge R740 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r740_http/README.md),<br>[DELL PowerEdge R820 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r820_http/README.md),<br>[DELL PowerEdge R840 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r840_http/README.md)|**{$API.URL}** - Dell iDRAC Redfish API URL in the format `<scheme>://<host>:<port>` (default: <Put your URL here>)<br>**{$API.USER}**, **{$API.PASSWORD}** - Dell iDRAC login credentials (default: not set).|In the Dell iDRAC interface of your server:<br>1. Enable Redfish API .<br>2. Create a user for monitoring with read-only permissions.| |[Elasticsearch Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/elasticsearch_http/README.md)|**{$ELASTICSEARCH.PORT}** - the port of the Elasticsearch host (default: 9200).<br>**{$ELASTICSEARCH.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$ELASTICSEARCH.USERNAME}**, **{$ELASTICSEARCH.PASSWORD}** - login credentials, required only if used for Elasticsearch authentication.|<| |[Etcd by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/etcd_http/README.md)|**{$ETCD.PORT}**- the port used by Etcd API endpoint (default: 2379).<br>**{$ETCD.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$ETCD.USER}**, **{$ETCD.PASSWORD}** - login credentials, required only if used for Etcd authentication.|Metrics are collected from /metrics endpoint; to specify the endpoint's location use `--listen-metrics-urls` flag (see Etcd [documentation](https://github.com/etcd-io/website/blob/master/content/docs/v3.4.0/op-guide/configuration.md#--listen-metrics-urls) for details).<br><br>To verify, whether Etcd is configured to allow metric collection, run:<br>`curl -L http://localhost:2379/metrics`<br><br>To check, if Etcd is accessible from Zabbix proxy or Zabbix server run:<br>`curl -L http:%%//<etcd_node_adress>:2379/metrics%%`<br><br>The template should be added to each node with Etcd.| |[GitLab by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/gitlab_http)|**{$GITLAB.PORT}** - the port of GitLab web endpoint (default: 80)<br>**{$GITLAB.URL}** - GitLab instance URL (default: localhost)|This template works with self-hosted GitLab instances; metrics are collected from the `/metrics` endpoint.<br><br>To access the metrics, the client IP address must be explicitly allowed (see [GitLab documentation](https://docs.gitlab.com/ee/administration/monitoring/ip_whitelist.html) for details).<br><br>Note, that certain metrics may not be available for a particular GitLab instance version and configuration.| |[Hadoop by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/hadoop_http/README.md)|**{$HADOOP.NAMENODE.HOST}** - the Hadoop NameNode host IP address or FQDN (default: NameNode).<br>**{$HADOOP.NAMENODE.PORT}** - the Hadoop NameNode web-UI port (default: 9870).<br>**{$HADOOP.RESOURCEMANAGER.HOST}** - the Hadoop ResourceManager host IP address or FQDN (default: ResourceManager).<br>**{$HADOOP.RESOURCEMANAGER.PORT}** - the Hadoop ResourceManager web-UI port (default: 8088).|Metrics are collected by polling the Hadoop API remotely using an HTTP agent and JSONPath preprocessing. Zabbix server (or proxy) executes direct requests to ResourceManager, NodeManagers, NameNode, DataNodes APIs.| |[HAProxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_http/README.md)|**{$HAPROXY.STATS.PATH}** - the path of HAProxy Stats page (default: stats).<br>**{$HAPROXY.STATS.PORT}** - the port of the HAProxy Stats host or container (default: 8404).<br>**{$HAPROXY.STATS.SCHEME}** - the request scheme. Supported: http (default), https.|HAProxy Stats page should be set up (see HAProxy [blog post](https://www.haproxy.com/blog/exploring-the-haproxy-stats-page/) for details or template's Readme.md for configuration example).| |[HashiCorp Vault by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vault_http/README.md)|**{$VAULT.API.PORT}** - the port on which the Vault listens for API requests (default: 8200).<br>**{$VAULT.API.SCHEME}** - the API request scheme. Supported: http (default), https.<br>**{$VAULT.HOST}** - Vault host name (default: <PUT YOUR VAULT HOST>).<br>**{$VAULT.TOKEN}** - Vault authorization token (default: <PUT YOUR AUTH TOKEN>).|1\. Configure the Vault API (see [official documentation](https://www.vaultproject.io/docs/configuration) for details).<br>2. Create a Vault service token, then copy and paste it into {$VAULT.TOKEN} macro value in Zabbix.| |[Hikvision camera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cctv/hikvision/README.md)|**{$HIKVISION\_ISAPI\_PORT}** - ISAPI port on a device (default: 80).<br>**{$USER}**, **{$PASSWORD}** - camera login credentials (default username: admin, password: 1234).|<| |[InfluxDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/influxdb_http/README.md)|**{$INFLUXDB.API.TOKEN}** - InfluxDB API authorization token (default: \`\`).<br>**{$INFLUXDB.URL}** - InfluxDB instance URL in the format `<scheme>://<host>:<port>` (default: http://localhost:8086).|This template collects internal service metrics from the InfluxDB /metrics endpoint of self-hosted InfluxDB instances.<br><br>See InfluxDB [documentation](https://docs.influxdata.com/influxdb/v2.0/security/tokens/) for details.| |[Jenkins by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jenkins/README.md)|**{$JENKINS.API.KEY}** - API key to access Metrics Servlet; required for common metrics (default: \`\`).<br>**{$JENKINS.API.TOKEN}** - API token for HTTP BASIC authentication; required for monitoring computers and builds (default: \`\`).<br>**{$JENKINS.URL}** - Jenkins URL in the format `<scheme>://<host>:<port>`; required for monitoring computers and builds (default: \`\`).<br>**{$JENKINS.USER}** - username for HTTP BASIC authentication; required for monitoring computers and builds (default: zabbix).|Metrics are collected by requests to Metrics API.<br><br>For common metrics: install and configure Metrics plugin parameters according to the [official documentation](https://plugins.jenkins.io/metrics/). Issue an API key for access to the Metrics Servlet, then use it as {$JENKINS.API.KEY} macro value.<br><br>For monitoring computers and builds: create an API token for the Jenkins user that will be used for monitoring, then use it as {$JENKINS.API.TOKEN} macro value. See Jenkins [documentation](https://www.jenkins.io/doc/book/system-administration/authenticating-scripted-clients/) for details.| |[Microsoft SharePoint by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md)|**{$SHAREPOINT.URL}** - portal page URL, for example *http://sharepoint.companyname.local/* (default: \`\`).<br>**{$SHAREPOINT.ROOT}** - a root directory; only the specified directory and all its subfolders will be monitored (default: /Shared Documents)<br>**{$SHAREPOINT.USER}**, **{$SHAREPOINT.PASSWORD}** - SharePoint login credentials (default: not set).|The template contains additional macros, which can be used to filter out certain dictionaries and types during LLD process (see template's [Readme.md](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md) for the description of available filter macros).| |[NetApp AFF A700 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/netapp_aff_a700_http/README.md)|**{$URL}** - AFF700 cluster URL address (default: ' ' )<br>**{$USERNAME}**, **{PASSWORD}** - AFF700 login credentials (default: not set).|Create a host for AFF A700 with cluster management IP as the Zabbix agent interface.| |[NGINX by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_http/README.md)|**{$NGINX.STUB\_STATUS.HOST}** - the hostname or IP address of NGINX stub\_status host or container (default: localhost).<br>**{$NGINX.STUB\_STATUS.PATH}** - the path of NGINX stub\_status page (default: basic\_status).<br>**{$NGINX.STUB\_STATUS.PORT}** - the port of NGINX stub\_status host or container (default: 80).<br>**{$NGINX.STUB\_STATUS.SCHEME}** - the request scheme. Supported: http (default), https.|`'ngx_http_stub_status_module` should be set up (see NGINX [documentation](https://nginx.org/en/docs/http/ngx_http_stub_status_module.html) for details or template's Readme.md for configuration example).<br>To check availability, run:<br>`nginx -V 2>&1 \| grep -o with-http_stub_status_module`| |[NGINX Plus by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_plus_http/README.md)|**{$NGINX.API.ENDPOINT}** - NGINX Plus API URL in the format `<scheme>://<host>:<port>/<location>/` (default: ' ').|1\. Enable NGINX Plus API (see NGINX [documentation](https://www.nginx.com/products/nginx/live-activity-monitoring/) for details).<br>2. Set the macro {$NGINX.API.ENDPOINT}<br>3. If required, use other template macros to filter out discovery operations and discover only required zones and upstreams.| |[PHP-FPM by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md)|**{$PHP\_FPM.HOST}** - a hostname or an IP of PHP-FPM status host or container (default: localhost).<br>**{$PHP\_FPM.PING.PAGE}** - PHP-FPM ping page path (default:ping).<br>**{$PHP\_FPM.PORT}** - the port of PHP-FPM status host or container (default: 80).<br>**{$PHP\_FPM.PROCESS\_NAME}** - PHP-FPM process name (default: php-fpm).<br>**{$PHP\_FPM.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$PHP\_FPM.STATUS.PAGE}** - PHP-FPM status page path (default:`status`).|1\. Open the php-fpm configuration file and enable the status page:<br>`pm.status_path = /status`<br>`ping.path = /ping`<br><br>2. Validate the syntax: `$ php-fpm7 -t`<br><br>3. Reload the php-fpm service.<br><br>4. In the Nginx Server Block (virtual host) configuration file, add (see template's *Readme.md* for an expanded example with comments):<br>`location ~ ^/(status\|ping)$ {`<br>`access_log off;`<br>`fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;`<br>`fastcgi_index index.php;`<br>`include fastcgi_params;`<br>`fastcgi_pass 127.0.0.1:9000;`<br>`}`<br><br>5. Check the syntax: `$ nginx -t`<br><br>6. Reload Nginx<br><br>7. Verify: `curl -L 127.0.0.1/status`| |[RabbitMQ cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_http/README.md)|**{$RABBITMQ.API.CLUSTER\_HOST}** - the hostname or IP address of RabbitMQ cluster API endpoint (default: 127.0.0.1).<br>**{$RABBITMQ.API.SCHEME}** - the request scheme. Supported: http (default), https.<br>**{$RABBITMQ.API.USER}**, **{$RABBITMQ.API.PASSWORD}** - RabbitMQ login credentials (default username: zbx\_monitor, password: zabbix).|Enable RabbitMQ management plugin (see [RabbitMQ documentation](https://www.rabbitmq.com/management.html)).<br><br>To create a RabbitMQ user with necessary permissions for monitoring, run:<br>'' rabbitmqctl add\_user zbx\_monitor <PASSWORD> ''<br>`rabbitmqctl set_permissions -p / zbx_monitor %% "" "" ".*"%%`<br>`rabbitmqctl set_user_tags zbx_monitor monitoring`<br><br>If the cluster consists of several nodes, it is recommended to assign the cluster template to a separate balancing host. In case of a single-node installation, the cluster template can be assigned to the host with a node template.| |[TiDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tidb_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 10080)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with TiDB server of PingCAP TiDB cluster.<br>Internal service metrics are collected from TiDB /metrics endpoint and TiDB monitoring API.| |[TiDB PD by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_pd_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 2379)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with PD server of PingCAP TiDB cluster.<br>Internal service metrics are collected from PD /metrics endpoint and TiDB monitoring API.| |[TiDB TiKV by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tikv_http/README.md)|**{$TIDB.PORT}** - The port of TiDB server metrics web endpoint (default: 20180)<br>**{$TIDB.URL}** - TiDB server URL (default: localhost).|This template works with TiKV server of PingCAP TiDB cluster.<br>Internal service metrics are collected from TiKV /metrics endpoint.| |[Travis CI by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/travis_http/README.md)|**{$TRAVIS.API.TOKEN}** - Travis API Token (default: not set)<br>**{$TRAVIS.API.URL}** - Travis API URL (default: api.travis-ci.com).|Travis API authentication token can be found in the *User → Settings → API authentication* section.<br>{$TRAVIS.API.URL} format for a private project is *api.travis-ci.com*.<br>{$TRAVIS.API.URL} format for an enterprise project is *api.example.com* (replace example.com with the domain Travis CI is running on).| |[VMWare SD-WAN VeloCloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md)|**{$VELOCLOUD.TOKEN}** - VMware SD-WAN Orchestrator API Token (default: \`\`).<br>**{$VELOCLOUD.URL}** - VMware SD-WAN Orchestrator URL, for example, *velocloud.net* (default: \`\`).|API token should be created in the VMware SD-WAN Orchestrator (see [VMware documentation](https://docs.vmware.com/en/VMware-SD-WAN/4.0/vmware-sd-wan-operator-guide/GUID-C150D536-A75F-47C1-8AFF-17C417F40C1D.html) for details).| |[ZooKeeper by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zookeeper_http/README.md)|**{$ZOOKEEPER.COMMAND\_URL}** - admin.commandURL; the URL for listing and issuing commands relative to the root URL (default: commands).<br>**{ZOOKEEPER.PORT}** - admin.serverPort; the port the embedded Jetty server listens on (default: 8080).<br>**{$ZOOKEEPER.SCHEME}** - the request scheme. Supported: http (default), https.|Metrics are collected from each ZooKeeper node by requests to AdminServer (enabled by default). See [ZooKeeper documentation](https://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_adminserver_config) to enable or configure AdminServer.| # httptest.create # httptest.create # httptest.delete # httptest.delete # httptest.get # httptest.get # httptest.update # httptest.update #### Hysteresis Sometimes an interval is needed between problem and recovery states, rather than a simple threshold. For example, if we want to define a trigger that reports a problem when server room temperature goes above 20°C and we want it to stay in the problem state until the temperature drops below 15°C, a simple trigger threshold at 20°C will not be enough. Instead, we need to define a trigger expression for the problem event first (temperature above 20°C). Then we need to define an additional recovery condition (temperature below 15°C). This is done by defining an additional *Recovery expression* parameter when [defining](/manual/config/triggers/trigger) a trigger. In this case, problem recovery will take place in two steps: - First, the problem expression (temperature above 20°C) will have to evaluate to FALSE - Second, the recovery expression (temperature below 15°C) will have to evaluate to TRUE The recovery expression will be evaluated only when the problem event is resolved first. ::: notewarning The recovery expression being TRUE alone does not resolve a problem if the problem expression is still TRUE! ::: #### ヒステリシス(Hysteresis) 問題状態と回復状態の間に単純な閾値ではなく、インターバルが必要な場合があります。<br> 例えば、サーバルームの温度が20℃以上になったときに問題を報告する trigger を定義し、温度が15℃以下に下がるまで<br> 問題状態を維持したい場合、20℃の単純な trigger 閾値では十分ではありません。<br> その代わりに、最初に問題が発生した問題事象（温度が20℃以上）に対する trigger 式を定義する必要があります。<br> 次に、回復条件（温度15℃以下）を追加で定義する必要があります。<br> これは、次のように定義することで行われます。*Recovery expression* パラメータを定義し、[defining](/manual/config/triggers/trigger) trigger<br>を定義します。 この場合、問題の回復は2つのステップで行われます。 - まず、問題式(20℃以上の温度)は、"FALSE" に評価されなければなりません。 - 次に、リカバリー式(温度15℃以下)を "TRUE" に評価します。 回復式は、問題事象が先に解決された場合にのみ評価されます。 ::: notewarning リカバリー式が "TRUE" であることだけでは、問題式がまだ "TRUE" である場合に問題を解決することができません！ ::: ##### Icon highlighting If a map element is in problem status, it is highlighted with a round circle. The fill color of the circle corresponds to the severity color of the problem. Only problems on or above the selected severity level will be displayed with the element. If all problems are acknowledged, a thick green border around the circle is displayed. Additionally: - a host in [maintenance](/manual/maintenance) is highlighted with an orange, filled square. Note that maintenance highlighting has priority over the problem severity highlighting (since Zabbix 6.0.5, only if the map element is host). - a disabled (not-monitored) host is highlighted with a gray, filled square. Highlighting is displayed if the *Icon highlighting* check-box is marked in map [configuration](/manual/config/visualization/maps/map#creating_a_map). ##### アイコンの強調表示 マップ要素に障害がある場合、丸い円で強調表示されます。 円の塗りつぶしの色は、問題の深刻度の色に対応しています。 選択した深刻度レベル以上の問題のみが要素とともに表示されます。 すべての障害が確認されると、円の周りに太い緑色の境界線が表示されます。 さらに： - [メンテナンス](/manual/maintenance)のホストは、オレンジ色の塗りつぶされた四角で強調表示されます。 メンテナンスの強調表示は、問題の深刻度の強調表示よりも優先されることに注意してください（Zabbix 6.0.5以降、マップ要素がホストの場合のみ） - 無効になっている（監視されていない）ホストは、灰色の塗りつぶされた四角で強調表示されます。 マップ[設定](/manual/config/visualization/maps/map#creating_a_map)で*アイコンの強調表示*チェックボックスがマークされている場合、強調表示されます。 # iconmap.create # iconmap.create # iconmap.delete # iconmap.delete # iconmap.get # iconmap.get ### Icon mapping The icon mapping object defines a specific icon to be used for hosts with a certain inventory field value. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmappingid|string|*(readonly)* ID of the icon map.| |**iconid**<br>(required)|string|ID of the icon used by the icon mapping.| |**expression**<br>(required)|string|Expression to match the inventory field against.| |**inventory\_link**<br>(required)|integer|ID of the host inventory field.<br><br>Refer to the [host inventory object](/manual/api/reference/host/object#host_inventory) for a list of supported inventory fields.| |iconmapid|string|*(readonly)* ID of the icon map that the icon mapping belongs to.| |sortorder|integer|*(readonly)* Position of the icon mapping in the icon map.| ### Icon mapping アイコンマッピングオブジェクトは、特定のインベントリフィールド値を持つホストに使用される特定のアイコンを定義します。 以下のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |iconmappingid|string|*（読み取り専用）*アイコンマップのID| |**iconid**<br>(必須)|string|アイコンマッピングで使用されるアイコンのID| |**expression**<br>(必須)|string|インベントリフィールド照合式| |**inventory\_link**<br>(必須)|integer|ホストインベントリフィールドのID<br><br>サポートされているインベントリフィールドのリストについては、[ホストインベントリオブジェクト](/manual/api/reference/host/object#host_inventory)を参照してください。 |iconmapid|string|*(必須)* アイコンマッピングが属するアイコンマップのID| |sortorder|integer|*(必須)* アイコンマップ内のアイコンマッピングの位置| #### - Icon mapping This section allows creating the mapping of certain hosts with certain icons. Host inventory field information is used to create the mapping. The mappings can then be used in [network map configuration](/manual/config/ visualization/maps/map) to assign appropriate icons to matching hosts automatically. To create a new icon map, click on *Create icon map* in the top right corner. {width="600"} Configuration parameters: |Parameter|Description| |---------|-----------| |*Name*|Unique name of icon map.| |*Mappings*|A list of mappings. The order of mappings determines which one will have priority. You can move mappings up and down the list with drag-and-drop.| |*Inventory field*|Host inventory field that will be looked into to seek a match.| |*Expression*|Regular expression describing the match.| |*Icon*|Icon to use if a match for the expression is found.| |*Default*|Default icon to use.| #### - アイコンのマッピング このセクションでは、特定のアイコンを使用してホストのマッピングを作成できます。ホストインベントリフィールド情報は、マッピングの作成に使用されます。 マッピングを[ネットワークマップ設定](/manual/config/ visualization/maps/map)に使用して、一致するホストに適切なアイコンを自動的に割り当てることもできます。 新しいアイコンマップを作成するには、右上隅にある*アイコンのマッピング作成*をクリックします。 {width="600"} 設定値 |パラメータ|詳細| |---------|-----------| |*名前*|一意なアイコンマップ名| |*マッピング*|マッピングのリスト。順序によってどちらが優先されるかが決まります。ドラッグアンドドロップでマッピングをリストの上下に移動できます。| |*インベントリフィールド*|一致するものを探すために検索されるホストインベントリフィールド| |*条件式*|一致する正規表現| |*アイコン*|式に一致するものが見つかった場合に使用するアイコン| |*標準*|デフォルトで使われるアイコン| # iconmap.update # iconmap.update If access rights to persistent storage files are removed during agent operation or other errors occur (e.g. disk full) then errors are logged into the agent log file but the log item does not become NOTSUPPORTED. agent 操作中に永続的ストレージファイルへのアクセス権が削除されたり、他のエラー(例：ディスクフル)が発生した場合、 エラーは agent ログファイルに記録されますが、ログ item がNOTSUPPORTEDになることはありません。 ##### If installed as package Zabbix agent runs as a daemon process. The agent can be started by executing: systemctl start zabbix-agent This will work on most of GNU/Linux systems. On other systems you may need to run: /etc/init.d/zabbix-agent start Similarly, for stopping/restarting/viewing status of Zabbix agent, use the following commands: systemctl stop zabbix-agent systemctl restart zabbix-agent systemctl status zabbix-agent ##### パッケージでインストールした場合 Zabbixエージェントはデーモンプロセスとして実行されます。エージェントを起動するには以下を実行します。 systemctl start zabbix-agent これはほとんどのGNU/Linuxシステムで動きます。他のシステムでは、以下のように実行する必要がある場合があります。 /etc/init.d/zabbix-agent start 同様に、Zabbixエージェントを停止/再起動/ステータス表示するには以下を実行します。 systemctl stop zabbix-agent systemctl restart zabbix-agent systemctl status zabbix-agent ##### If installed as package Zabbix proxy runs as a daemon process. The proxy can be started by executing: systemctl start zabbix-proxy This will work on most of GNU/Linux systems. On other systems you may need to run: /etc/init.d/zabbix-proxy start Similarly, for stopping/restarting/viewing status of Zabbix proxy, use the following commands: systemctl stop zabbix-proxy systemctl restart zabbix-proxy systemctl status zabbix-proxy ##### パッケージを使用してインストールした場合 Zabbixプロキシはデーモンプロセスとして実行されます。プロキシを起動するには以下を実行します。 systemctl start zabbix-proxy これはほとんどのGNU/Linuxシステムで動きます。他のシステムでは、以下のように実行する必要がある場合があります。 /etc/init.d/zabbix-proxy start 同様に、Zabbixプロキシの停止/再起動/ステータス表示するには以下を実行します。 systemctl stop zabbix-proxy systemctl restart zabbix-proxy systemctl status zabbix-proxy ##### If installed as package Zabbix server runs as a daemon process. The server can be started by executing: systemctl start zabbix-server This will work on most of GNU/Linux systems. On other systems you may need to run: /etc/init.d/zabbix-server start Similarly, for stopping/restarting/viewing status, use the following commands: systemctl stop zabbix-server systemctl restart zabbix-server systemctl status zabbix-server ##### パッケージを使用してインストールした場合 Zabbixサーバーはデーモンプロセスとして実行されます。サーバーを起動するには以下を実行します。 systemctl start zabbix-server これはほとんどのGNU/Linuxシステムで動きます。他のシステムでは、以下のように実行する必要がある場合があります。 /etc/init.d/zabbix-server start 同様に、停止/再起動/ステータス表示するには以下を実行します。 systemctl stop zabbix-server systemctl restart zabbix-server systemctl status zabbix-server ##### If the webhook test fails - *"Media type test failed."* message is displayed, followed by additional failure details. ##### Webhook テストが失敗した場合 - *"Media type test failed. "* というメッセージが表示され、その後に失敗の詳細が表示されます。 ##### If the webhook test is successful - *"Media type test successful."* message is displayed - Server response appears in the gray *Response* field - Response type (JSON or String) is specified below the *Response* field ##### Webhookテストが成功した場合 - *"Media type test successful. "* のメッセージが表示されます。 - 灰色の *Response* フィールドにサーバーの応答が表示されます。 - レスポンスの種類（JSONまたはString）は、*Response* フィールドの下に表示されます。 # image.create # image.create # image.delete # image.delete # image.get # image.get #### - Images The Images section displays all the images available in Zabbix. Images are stored in the database. {width="600"} The *Type* dropdown allows you to switch between icon and background images: - Icons are used to display [network map](/manual/config/visualization/maps/map) elements - Backgrounds are used as background images of network maps **Adding image** You can add your own image by clicking on the *Create icon* or *Create background* button in the top right corner.  Image attributes: |Parameter|Description| |---------|-----------| |*Name*|Unique name of an image.| |*Upload*|Select the file (PNG, JPEG, GIF) from a local system to be uploaded to Zabbix.<br>*Note* that it may be possible to upload other formats that will be converted to PNG during upload. GD library is used for image processing, therefore formats that are supported depend on the library version used (2.0.28 or higher is required by Zabbix).| ::: noteclassic Maximum size of the upload file is limited by the value of ZBX\_MAX\_IMAGE\_SIZE that is 1024x1024 bytes or 1 MB.\ \ The upload of an image may fail if the image size is close to 1 MB and the `max_allowed_packet` MySQL configuration parameter is at a default of 1MB. In this case, increase the [max\_allowed\_packet](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet) parameter. ::: #### - イメージ イメージセクションには、Zabbixで利用可能なすべての画像が表示されます。画像はデータベースに保存されます。 {width="600"} *タイプ*ドロップダウンを使用すると、アイコンと背景画像を切り替えることができます。 - アイコンは[ネットワークマップ](/manual/config/visualization/maps/map)要素を表示するために使用されます - 背景はネットワークマップの背景画像として使用されます **イメージの追加** 右上隅にある[アイコンの作成]または[背景の作成]ボタンをクリックして、独自の画像を追加できます。  画像属性： |パラメータ|詳細| |---------|-----------| |*名前*|画像の一意の名前| |*アップロード*|Zabbixにアップロードするファイル（PNG、JPEG、GIF）をローカルシステムから選択します。<br>*注意*アップロード中にPNGに変換される他の形式をアップロードできる場合があります。 GDライブラリが画像処理に使用されるため、サポートされるフォーマットは使用するライブラリのバージョンによって異なります（Zabbix 2.0.28以降が必要です）| ::: noteclassic アップロードファイルの最大サイズは、1024x1024バイトまたは1MBのZBX\_MAX\_IMAGE\_SIZEの値によって制限されます。画像サイズが1MBに近く、 `max_allowed_pa​​cket`の場合、画像のアップロードが失敗することがあります。 MySQL設定パラメーターのデフォルトは1MBです。この場合[max\_allowed\_packet](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet)パラメーターを増やします。 ::: # image.update # image.update ### Implementation details The high availability (HA) cluster is an opt-in solution and it is supported for Zabbix server. The native HA solution is designed to be simple in use, it will work across sites and does not have specific requirements for the databases that Zabbix recognizes. Users are free to use the native Zabbix HA solution, or a third-party HA solution, depending on what best suits the high availability requirements in their environment. The solution consists of multiple zabbix\_server instances or nodes. Every node: - is configured separately - uses the same database - may have several modes: active, standby, unavailable, stopped Only one node can be active (working) at a time. A standby node runs only one process - the HA manager. A standby node does no data collection, processing or other regular server activities; they do not listen on ports; they have minimum database connections. Both active and standby nodes update their last access time every 5 seconds. Each standby node monitors the last access time of the active node. If the last access time of the active node is over 'failover delay' seconds, the standby node switches itself to be the active node and assigns 'unavailable' status to the previously active node. The active node monitors its own database connectivity - if it is lost for more than `failover delay-5` seconds, it must stop all processing and switch to standby mode. The active node also monitors the status of the standby nodes - if the last access time of a standby node is over 'failover delay' seconds, the standby node is assigned the 'unavailable' status. The nodes are designed to be compatible across minor Zabbix versions. ### 実装の詳細 高可用性 (HA) クラスターはオプトインソリューションであり、Zabbixサーバーでサポートされています。 ネイティブHAソリューションは、簡単に使用できるように設計されており、複数のサイトで機能し、Zabbixが認識するデータベースに関する特定の要件はありません。 ユーザーは、環境の高可用性要件に最適なものに応じて、ネイティブのZabbix HAソリューションまたはサードパーティのHAソリューションを自由に使用できます。 このソリューションは複数のzabbix\_serverインスタンスまたはノードで構成されています。 すべてのノードについて : - 個別に構成 - 同じデータベースを使用 - いくつかのモードがあるかもしれません : アクティブ、スタンバイ、使用不可、停止 一度にアクティブ (稼働) できるノードは 1 つだけです。 スタンバイノードは、HAマネージャーという1つのプロセスのみを実行します。スタンバイノードは、データの収集、処理、その他の通常のサーバーの仕事を行いません。 ポートをリッスンしません。 データベース接続は最小限です。 アクティブノードとスタンバイノードは両方とも、最終アクセス時刻を5秒ごとに更新します。各スタンバイノードは、アクティブノードの最終アクセス時刻を監視します。アクティブノードの最終アクセス時刻が'failover delay'秒を超えている場合、スタンバイノードは自身をアクティブノードに切り替え、以前のアクティブノードに'使用不可'ステータスを割り当てます。 アクティブノードは自身のデータベース接続を監視します。接続が`failover delay-5`秒を超えて失われた場合は、すべての処理を停止してスタンバイモードに切り替ります。 アクティブノードは、スタンバイノードのステータスも監視します。スタンバイノードの最終アクセス時刻が'failover delay'秒を超えている場合、スタンバイノードには'使用不可'ステータスが割り当てられます。 ノードは、Zabbixのマイナーバージョン間で互換性があるように設計されています。 #### Important notes - Database monitoring items will become unsupported if no *odbc poller* processes are started in the server or proxy configuration. To activate ODBC pollers, set *StartODBCPollers* parameter in Zabbix [server](/manual/appendix/config/zabbix_server) configuration file or, for checks performed by proxy, in Zabbix [proxy](/manual/appendix/config/zabbix_proxy) configuration file. - Zabbix does not limit the query execution time. It is up to the user to choose queries that can be executed in a reasonable amount of time. - The [Timeout](/manual/appendix/config/zabbix_server) parameter value from Zabbix server is used as the ODBC login timeout (note that depending on ODBC drivers the login timeout setting might be ignored). - The SQL command must return a result set like any query with `select ...`. The query syntax will depend on the RDBMS which will process them. The syntax of request to a storage procedure must be started with `call` keyword. #### 重要な注意事項 - server または proxy 設定で*odbc poller*プロセスが起動されていない場合、データベース監視項目はサポートされなくなります。 ODBCポーラーを起動するには、Zabbix [server](/manual/appendix/config/zabbix_server) 設定ファイルで *StartODBCPollers*パラメータを設定するか、proxy で実行するチェックの場合はZabbix [proxy] (/manual/appendix/config/zabbix_proxy) 設定ファイルで *StartODBCPollers* パラメータを設定します。 - Zabbixはクエリの実行時間を制限していません。妥当な時間で実行できるクエリを選択することはユーザにゆだねられています。 - Zabbix server の[Timeout](/manual/appendix/config/zabbix_server)パラメータの値はODBCログインタイムアウトとして 使用されます(ODBCドライバによっては、ログインタイムアウト設定が無視される場合があることに注意してください)。 - SQL コマンドは、`select ...` を使用した他のクエリと同様に結果セットを返す必要があります。 問い合わせの構文は、それを処理するRDBMSに依存します。ストレージプロシージャへのリクエストの構文は `call` キーワードで 開始する必要があります。 #### Important notes - If more than one user macro with context exists, Zabbix will try to match the simple context macros first and then context macros with regular expressions in an undefined order. ::: notewarning Do not create different context macros matching the same string to avoid undefined behavior. ::: - If a macro with its context is not found on host, linked templates or globally, then the macro without context is searched for. - Only low-level discovery macros are supported in the context. Any other macros are ignored and treated as plain text. Technically, macro context is specified using rules similar to [item key](/manual/config/items/item/key) parameters, except macro context is not parsed as several parameters if there is a `,` character: - Macro context must be quoted with `"` if the context contains a `}` character or starts with a `"` character. Quotes inside quoted context must be escaped with the `\` character. - The `\` character itself is not escaped, which means it's impossible to have a quoted context ending with the `\` character - the macro {$MACRO:"a:\\b\\c\\"} is invalid. - The leading spaces in context are ignored, the trailing spaces are not: - For example {$MACRO:A} is the same as {$MACRO: A}, but not {$MACRO:A }. - All spaces before leading quotes and after trailing quotes are ignored, but all spaces inside quotes are not: - Macros {$MACRO:"A"}, {$MACRO: "A"}, {$MACRO:"A" } and {$MACRO: "A" } are the same, but macros {$MACRO:"A"} and {$MACRO:" A "} are not. The following macros are all equivalent, because they have the same context: {$MACRO:A}, {$MACRO: A} and {$MACRO:"A"}. This is in contrast with item keys, where 'key\[a\]', 'key\[ a\]' and 'key\["a"\]' are the same semantically, but different for uniqueness purposes. #### 重要事項 - コンテキストを持つ複数のユーザー マクロが存在する場合、Zabbix は最初に単純なコンテキスト マクロを照合し、次にコンテキスト マクロを未定義の順序で正規表現と照合しようとします。 ::: notewarning 未定義の動作を避けるために、同じ文字列に一致する別のコンテキスト マクロを作成しないでください。 ::: - コンテキストを持つマクロがホスト、リンクされたテンプレート、またはグローバルで見つからない場合、コンテキストのないマクロが検索されます。 - コンテキストでは、ローレベルディスカバリマクロのみがサポートされています。 その他のマクロはすべて無視され、プレーン テキストとして扱われます。 技術的には、マクロ コンテキストは [item key](/manual/config/items/item/key) パラメータと同様のルールを使用して指定されますが、`,` 文字がある場合、マクロ コンテキストは複数のパラメータとして解析されません。 - コンテキストに `}` 文字が含まれている場合、または `"` 文字で始まる場合、マクロ コンテキストは `"` で引用する必要があります。 引用されたコンテキスト内の引用符は、`\` 文字でエスケープする必要があります。 - `\` 文字自体はエスケープされません。つまり、`\` 文字で終わる引用符付きコンテキストを持つことは不可能です - マクロ {$MACRO:"a:\\b\\c\\"} は無効です。 - コンテキスト内の先頭のスペースは無視されますが、末尾のスペースは無視されます: - たとえば、{$MACRO:A} は {$MACRO: A} と同じですが、{$MACRO:A } とは異なります。 - 先頭の引用符の前と末尾の引用符の後のすべてのスペースは無視されますが、引用符内のすべてのスペースは無視されません。 - マクロ {$MACRO:"A"}、{$MACRO: "A"}、{$MACRO:"A" }、および {$MACRO: "A" } は同じですが、マクロ {$MACRO:"A"} および {$MACRO:" A "} ではありません。 {$MACRO:A}、{$MACRO: A}、および {$MACRO:"A"} のマクロは、同じコンテキストを持っているため、すべて同等です。 これは、'key\[a\]'、'key\[ a\]'、および 'key\["a"\]' が意味的に同じである項目キーとは対照的ですが、一意性のために異なります。 #### Importing a template Import the template configuration contained in the XML string. If any items or triggers in the XML string are missing, they will be deleted from the database, and everything else will be left unchanged. Request: ```json { "jsonrpc": "2.0", "method": "configuration.import", "params": { "format": "xml", "rules": { "templates": { "createMissing": true, "updateExisting": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": false } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.0</version><date>2023-01-01T12:00:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;/dt&gt;</parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>CPU load</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)&gt;2</expression><name>CPU load too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### テンプレートのインポート XML文字列に含まれるテンプレート設定をインポートします。 XML文字列内のアイテムまたはトリガーが欠落している場合、それらはデータベースから削除され、その他は一切変更されません。 リクエスト: ```json { "jsonrpc": "2.0", "method": "configuration.import", "params": { "format": "xml", "rules": { "templates": { "createMissing": true, "updateExisting": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": false } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.0</version><date>2023-01-01T12:00:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter><dt>Server uptime: (.*)</dt></parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>CPU load</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)>2</expression><name>CPU load too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ##### Importing data Import initial schema: # cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix For proxy with PostgreSQL (or SQLite): # cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix # cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db ##### データのインポート 初期スキーマのインポートには、以下のコマンドラインを実行します: # cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix PostgreSQL (または SQLite)を使用するproxy用には、以下のコマンドラインを実行します: # cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix<br> # cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db ##### Importing data Import initial schema: cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix For proxy with PostgreSQL (or SQLite): cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db ##### データのインポート 初期スキーマをインポートします。 cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix PostgreSQL (またはSQLite) を使用したプロキシの場合: cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db ##### Importing data Import initial schema: cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix For proxy with PostgreSQL (or SQLite): cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db ##### データのインポート 初期スキーマをインポートします。 cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix PostgreSQL (またはSQLite) を使用したプロキシの場合: cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db #### Importing data Now import initial schema and data for the **server** with MySQL: zcat /usr/share/packages/zabbix-sql-scripts/mysql/create.sql.gz | mysql -uzabbix -p zabbix You will be prompted to enter your newly created database password. With PostgreSQL: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/create.sql.gz | sudo -u zabbix psql zabbix With TimescaleDB, in addition to the previous command, also run: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/timescaledb.sql.gz | sudo -u <username> psql zabbix ::: notewarning TimescaleDB is supported with Zabbix server only. ::: For proxy, import initial schema: zcat /usr/share/packages/zabbix-sql-scripts/mysql/schema.sql.gz | mysql -uzabbix -p zabbix For proxy with PostgreSQL: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/schema.sql.gz | sudo -u zabbix psql zabbix #### データのインポート ここで、MySQLを使用して**サーバー**の初期スキーマとデータをインポートします。 zcat /usr/share/packages/zabbix-sql-scripts/mysql/create.sql.gz | mysql -uzabbix -p zabbix 新しく作成したデータベースのパスワードを入力するよう求められます。 PostgreSQLの場合: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/create.sql.gz | sudo -u zabbix psql zabbix TimescaleDBの場合、前のコマンドに加えて次も実行します: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/timescaledb.sql.gz | sudo -u <username> psql zabbix ::: notewarning TimescaleDBは、Zabbixサーバーでのみサポートされます。 ::: プロキシの場合、初期スキーマをインポートします: zcat /usr/share/packages/zabbix-sql-scripts/mysql/schema.sql.gz | mysql -uzabbix -p zabbix PostgreSQLを使用したプロキシの場合: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/schema.sql.gz | sudo -u zabbix psql zabbix #### Importing data with Timescale DB With TimescaleDB, in addition to the import command for PostgreSQL, also run: # cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: notewarning TimescaleDB is supported with Zabbix server only. ::: #### TimescaleDBによるデータのインポート TimescaleDBでは、PostgreSQLのインポートコマンドに加えて、さらに以下のコマンドを実行します: # cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: notewarning TimescaleDBはZabbix server でのみサポートされています。 ::: #### Importing data with Timescale DB With TimescaleDB, in addition to the import command for PostgreSQL, also run: cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: notewarning TimescaleDB is supported with Zabbix server only. ::: #### Timescale DBでのデータのインポート TimescaleDBでは、PostgreSQLでのインポートコマンドに加えて次のコマンドも実行します。 cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: notewarning TimescaleDBはZabbixサーバーでのみサポートされています。 ::: #### Importing data with Timescale DB With TimescaleDB, in addition to the import command for PostgreSQL, also run: cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: notewarning TimescaleDB is supported with Zabbix server only. ::: #### Timescale DBでのデータのインポート TimescaleDBでは、PostgreSQLでのインポートコマンドに加えて次のコマンドも実行します。 cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: notewarning TimescaleDBはZabbixサーバーでのみサポートされています。 ::: #### Importing To import hosts, do the following: - Go to: *Configuration* → *Hosts* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import*  A success or failure message of the import will be displayed in the frontend. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise it will not remove them.<br>If *Delete missing* is marked for template linkage, existing template linkage not present in the import file will be removed from the host along with all entities inherited from the potentially unlinked templates (items, triggers, etc).| #### Import ホストを Import するには、次のようにします。 - *Configuration*→*Hosts*をクリックします。 - 右側の*Import*をクリックします。 - import ファイルを選択します。 - import ルールの必要なオプションにマークを付けます - *Import*をクリックします。  import の成功または失敗のメッセージは、フロントエンドに表示されます。 Import ルール: |Rule|Description| |----|-----------| |*Update existing*|既存の要素は、import ファイルから取得したデータで更新されます。そうでない場合は、更新されません。| |*Create new*|import は、import ファイルのデータを使用して新しい要素を追加します。そうでない場合は、追加されません。| |*Delete missing*|import は、import ファイルに存在しない既存の要素を削除します。そうでない場合は、削除されません。<br> テンプレート・リンクに *Delete missing* が指定されている場合、import ファイルに存在しない既存のテンプレート・リンクは、 リンクされていない可能性のあるテンプレートから継承されたすべてのエンティティ（アイテム、トリガーなど）と共にホストから削除されます。| #### Importing To import media types, do the following: - Go to: *Administration* → *Media types* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import*  A success or failure message of the import will be displayed in the frontend. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise it will not remove them.| #### インポート メディアタイプをインポートするには、次のようにします。 - *管理* → *メディアタイプ* に移動します。 - 右側の*インポート*をクリックします。 - インポートするファイルを選択します。 - インポートルールの必要なオプションにマークを付けます。 - *インポート*をクリックします。  インポートの成功または失敗のメッセージがWebインターフェースに表示されます。 インポートルール: |ルール|説明| |----|-----------| |*既存の設定を上書Update existing*|既存の要素は、import ファイルから取得したデータで更新されます。そうでない場合は、更新されません。| |*新規作成*|import ファイルのデータを使用して新しい要素を追加します。そうでない場合は、追加されません。| |*存在しない場合に削除*|インポートファイルに存在しない既存の要素を削除します。そうでない場合は、削除されません。| #### Importing To import network maps, do the following: - Go to: *Monitoring* → *Maps* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import*  All mandatory input fields are marked with a red asterisk. A success or failure message of the import will be displayed in the frontend. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing maps will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new maps using data from the import file. Otherwise it will not add them.| If you uncheck both map options and check the respective options for images, images only will be imported. Image importing is only available to Super Admin users. ::: notewarning If replacing an existing image, it will affect all maps that are using this image. ::: #### import ネットワークマップを import するには、次のようにします。 - *Monitoring* → *Maps* に移動します。 - 右側の*Import*をクリックします。 - import ファイルを選択します。 - import ルールの必要なオプションにマークを付けます。 - *import* をクリックします。  すべての必須入力項目には赤いアスタリスクが表示されます。 import の成功または失敗のメッセージは、フロントエンドに表示されます。 Import ルール: |Rule|Description| |----|-----------| |*Update existing*|Existing maps will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new maps using data from the import file. Otherwise it will not add them.| マップのオプションを両方ともオフにし、イメージのオプションをそれぞれオンにすると、イメージのみが import されます。 <br> 画像の import は、Super Adminユーザのみ可能です。 ::: notewarning 既存の画像を置き換える場合、この画像を使用しているすべてのマップに影響します。 ::: #### Importing To import templates, do the following: - Go to: *Configuration* → *Templates* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import*  All mandatory input fields are marked with a red asterisk. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise, they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise, it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise, it will not remove them.<br>If *Delete missing* is marked for template linkage, existing template linkage not present in the import file will be unlinked. Since Zabbix 6.0.13, entities (items, triggers, graphs, etc.) inherited from the unlinked templates will not be removed (unless the *Delete missing* option is selected for each entity as well).| On the next screen, you will be able to view the content of a template being imported. If this is a new template all elements will be listed in green. If updating an existing template, new template elements are highlighted in green; removed template elements are highlighted in red; elements that have not changed are listed on a gray background. {width="600"} The menu on the left can be used to navigate through the list of changes. Section *Updated* highlights all changes made to existing template elements. Section *Added* lists new template elements. The elements in each section are grouped by element type; press on the gray arrow down to expand or collapse the group of elements.  Review template changes, then press *Import* to perform template import. A success or failure message of the import will be displayed in the frontend. #### インポート テンプレートをインポートするには、次の操作を行います。 - *設定* → *テンプレート* に移動します。 - 右側の*インポート*をクリックします。 - インポートファイルを選択します。 - インポートルールで必要なオプションをマークします。 - *インポート*をクリックします。  すべての必須入力項目には赤いアスタリスクが表示されます。 インポートルール: |ルール|説明| |----|-----------| |*Update existing*|既存の要素は、インポートファイルから取得したデータで更新されます。そうでない場合は、更新されません。| |*Create new*|インポートファイルのデータを使用して新しい要素を追加します。そうでない場合は、追加されません。| |*Delete missing*|インポートファイルに存在しない既存の要素は削除されます。そうでない場合は、削除されません。テンプレート・リンクに *Delete missing* が指定されている場合、インポート・ファイルに存在しない既存のテンプレート・リンケージは、リンクされていない可能性のあるテンプレートから継承されたすべてのエンティティ（アイテム、トリガーなど）と共にテンプレートから削除されます。| 次の画面では、インポートされたテンプレートの内容を確認することができます。 新しいテンプレートであれば、すべての要素が緑色で表示されます。 既存のテンプレートを更新する場合、新しいテンプレート要素は緑色でハイライトされ、削除されたテンプレート要素は赤色で、変更のない要素は灰色の背景で表示されます。 {width="600"} 左のメニューから、変更点の一覧を表示することができます。 セクション*Updated*は、既存のテンプレート要素に加えられたすべての変更点をハイライト表示します。 セクション *Added* は、新しいテンプレート要素をリストアップします。 各セクションの要素は、要素の種類によってグループ化されています。 グレーの矢印を押して、要素のグループを展開または折りたたみます。  テンプレートの変更を確認し、*インポート*を押してテンプレートのインポートを実行します。 フロントエンドにインポートの成功または失敗のメッセージが表示されます。 ### Improved performance of history syncers The performance of history syncers has been improved by introducing a new read-write lock. This reduces locking between history syncers, trappers and proxy pollers by using a shared read lock while accessing the configuration cache. The new lock can be write locked only by the configuration syncer performing a configuration cache reload. ### history syncersのパフォーマンス改善 history syncerのパフォーマンスは、新しいread-writeロックを導入することで改善されました。 これにより、構成キャッシュにアクセスしながら共有読み取りロックを使用して、history syncer、trapper、proxy poller間のロックが削減されます。 新しいロックは、構成キャッシュリロードを実行するconfiguration syncerによってのみロックされた書き込みができます。 ### Improved performance of history syncers The performance of history syncers has been improved by introducing a new read-write lock. This reduces locking between history syncers, trappers and proxy pollers by using a shared read lock while accessing the configuration cache. The new lock can be write locked only by the configuration syncer performing a configuration cache reload. ### history syncersのパフォーマンス改善 history syncerのパフォーマンスは、新しいread-writeロックを導入することで改善されました。 これにより、構成キャッシュにアクセスしながら共有読み取りロックを使用して、history syncer、trapper、proxy poller間のロックが削減されます。 新しいロックは、構成キャッシュリロードを実行するconfiguration syncerによってのみロックされた書き込みができます。 ##### In accepting-side log: ...failed to accept an incoming connection: from 127.0.0.1: support for TLS was not compiled in ##### 受付側ログ: ...failed to accept an incoming connection: from 127.0.0.1: support for TLS was not compiled in In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Host groups to display data for.| |*Hosts*|Hosts to display data for.| |*Host tags*|Specify tags to limit the number of hosts displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met| |*Columns*|Add data [columns](#column-configuration) to display.<br>The column order determines their display from left to right.<br>Columns can be reordered by dragging up and down by the handle before the column name.| |*Order*|Specify the ordering of rows:<br>**Top N** - in descending order by the *Order column* aggregated value<br>**Bottom N** - in ascending order by the *Order column* aggregated value | |*Order column*|Specify the column from the defined *Columns* list to use for *Top N* or *Bottom N* ordering.| |*Host count*|Count of host rows to be shown (1-100).| すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。 | | | |--|--------| |*ホストグループ*|データを表示するホストグループ| |*ホスト*|データを表示するホスト| |*ホストのタグ*|タグを指定して、ウィジェットに表示されるホストの数を制限します。 特定のタグとタグ値を含めたり除外したりすることができます。 いくつかの条件を設定できます。 タグ名の照合では常に大文字と小文字が区別されます。<br><br>各条件で使用できる演算子はいくつかあります。<br>**Exists** - 指定されたタグ名を含める<br>**Equals** - 指定されたタグ名と値を含める（大文字と小文字を区別）<br> **Contains** - タグ値に入力された文字列が含まれる場合に指定されたタグ名を含める（文字列の部分一致、大文字と小文字を区別しない）<br>**Does not exist** - 指定されたタグ名を除外する<br>**Does not equal**-指定されたタグ名と値を除外する（大文字と小文字を区別）<br>**Does not contain** - タグ値に入力された文字列が含まれる指定されたタグ名を除外する（文字列の部分一致、大文字と小文字を区別しない）<br>条件には2つの計算タイプがあります：<br>**And/Or** - すべての条件が満たされる必要があり、同じタグ名を持つ条件はOr条件によってグループ化されます<br >**Or** - 1つの条件が満たされる| |*列*|表示するデータ[列](#columns)を追加します。<br>列の順序によって、左から右への表示が決まります。<br>列名の前のハンドルを上下にドラッグすると、列の順序を変更できます。| |*表示順序*|行の順序を指定します。<br>**上位N** - *順序用列*集計値の降順<br>**下位N** - *順序用列*集計値の昇順| |*順序用列*|定義された*列*リストから列を指定して、*上位N*または*下位N*の順序付けに使用します。| |*ホスト数*|表示するホストの行数 (1 - 100)| In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |---|---| |*Host groups*|Select host groups to be displayed on the map. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups. Scroll down to select. Click on 'x' to remove selected groups. <br>If nothing is selected in both *Host groups* and *Hosts* fields, all hosts with valid coordinates will be displayed.| |*Hosts*|Select hosts to be displayed all the map. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts. Scroll down to select. Click on 'x' to remove selected hosts. <br>If nothing is selected in both *Host groups* and *Hosts* fields, all hosts with valid coordinates will be displayed.| |*Tags*|Specify tags to limit the number of hosts displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met| |*Initial view*|Comma-separated center coordinates and an optional zoom level to display when the widget is initially loaded in the format `<latitude>,<longitude>,<zoom>`<br>If initial zoom is specified, the Geomap widget is loaded at the given zoom level. Otherwise, initial zoom is calculated as half of the [max zoom](/manual/web_interface/frontend_sections/administration/general#geographical_maps) for the particular tile provider.<br>The initial view is ignored if the default view is set (see below).<br>Examples:<br>=> 40.6892494,-74.0466891,14<br>=> 40.6892494,-122.0466891| すべてのウィジェットの[共通](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters)パラメーターに加えて、次のオプションを設定できます。 | | | |---|---| |*ホストグループ*|マップに表示するホストグループを選択します。 このフィールドはオートコンプリートであるため、グループの名前を入力し始めると、一致するグループ名がドロップダウンで表示されます。 スクロールして選択します。 'x'をクリックして選択したグループを削除できます。 <br> * ホストグループ*フィールドと*ホスト*フィールドの両方で何も選択されていない場合、有効な座標を持つすべてのホストが表示されます。| |*ホスト*|すべてのマップを表示するホストを選択します。 このフィールドはオートコンプリートであるため、ホストの名前を入力し始めると、一致するホスト名がドロップダウンで表示されます。スクロールして選択します。 'x'をクリックして選択したホストを削除できます。 <br> *ホストグループ*フィールドと*ホスト*フィールドの両方で何も選択されていない場合、有効な座標を持つすべてのホストが表示されます。| |*タグ*|タグを指定して、ウィジェットに表示されるホストの数を制限します。 特定のタグとタグ値を含めたり除外したりすることができます。 いくつかの条件を設定できます。 タグ名の照合では常に大文字と小文字が区別されます。<br>条件ごとに使用できる演算子がいくつかあります。<br>**Exists** - 指定されたタグ名を含める<br>**Equals** - 指定されたタグ名と値を含める（大文字と小文字を区別）<br> **Contains** - タグ値に入力された文字列が含まれる場合に指定されたタグ名を含める（文字列の部分一致、大文字と小文字を区別しない）<br>**Does not exist** - 指定されたタグ名を除外する<br>**Does not equal**-指定されたタグ名と値を除外する（大文字と小文字を区別）<br>**Does not contain** - タグ値に入力された文字列が含まれる指定されたタグ名を除外する（文字列の部分一致、大文字と小文字を区別しない）<br>条件には2つの計算タイプがあります：<br>**And/Or** - すべての条件が満たされる必要があり、同じタグ名を持つ条件はOr条件によってグループ化されます<br >**Or** - 1つの条件が満たされる| |*初期表示位置*|ウィジェットが最初に`<latitude>、<longitude>、<zoom>`の形式でロードされたときに表示する、カンマ区切りの中心座標とオプションのズームレベル<br>初期ズームが指定されている場合、ジオマップウィジェットは 与えられたズームレベルで表示します。 それ以外の場合、初期ズームは特定のタイルプロバイダーの[最大ズーム](/manual/web_interface/frontend_sections/administration/general#geographical_maps)の半分として計算されます。<br>デフォルトビューが設定されている場合、初期ビューは無視されます（以下を参照）<br>例：<br>=>40.6892494,-74.0466891,14<br>=>40.6892494,-122.0466891| In addition, Zabbix provides the zabbix-selinux-policy package as part of source RPM packages for [RHEL 8](http://repo.zabbix.com/zabbix/6.0/rhel/8/SRPMS/) and [RHEL 7](http://repo.zabbix.com/zabbix/6.0/rhel/7/SRPMS/). This package provides a basic default policy for SELinux and makes zabbix components work out-of-the-box by allowing Zabbix to create and use sockets and enabling httpd connection to PostgreSQL (used by frontend). The source *zabbix_policy.te* file contains the following rules: module zabbix_policy 1.2; require { type zabbix_t; type zabbix_port_t; type zabbix_var_run_t; type postgresql_port_t; type httpd_t; class tcp_socket name_connect; class sock_file { create unlink }; class unix_stream_socket connectto; } #============= zabbix_t ============== allow zabbix_t self:unix_stream_socket connectto; allow zabbix_t zabbix_port_t:tcp_socket name_connect; allow zabbix_t zabbix_var_run_t:sock_file create; allow zabbix_t zabbix_var_run_t:sock_file unlink; allow httpd_t zabbix_port_t:tcp_socket name_connect; #============= httpd_t ============== allow httpd_t postgresql_port_t:tcp_socket name_connect; This package has been created to prevent users from turning off SELinux because of the configuration complexity. It contains the default policy that is sufficient to speed up Zabbix deployment and configuration. For maximum security level, it is recommended to set custom SELinux settings. さらにZabbixでは、[RHEL 8](http://repo.zabbix.com/zabbix/6.0/rhel/8/SRPMS/)および[RHEL 7](http://repo.zabbix.com/zabbix/6.0/rhel/7/SRPMS/)用のソースRPMパッケージの一部としてzabbix-selinux-policyパッケージを提供しています。このパッケージは、SELinuxの基本的なデフォルトポリシーを提供し、Zabbixの各コンポーネントがソケットを作成して使用できるようにし、httpdからPostgreSQLにアクセス（Webインターフェースで使用）できるようにするものです。 ソース*zabbix_policy.te*ファイルには次のルールが含まれています。 module zabbix_policy 1.2; require { type zabbix_t; type zabbix_port_t; type zabbix_var_run_t; type postgresql_port_t; type httpd_t; class tcp_socket name_connect; class sock_file { create unlink }; class unix_stream_socket connectto; } #============= zabbix_t ============== allow zabbix_t self:unix_stream_socket connectto; allow zabbix_t zabbix_port_t:tcp_socket name_connect; allow zabbix_t zabbix_var_run_t:sock_file create; allow zabbix_t zabbix_var_run_t:sock_file unlink; allow httpd_t zabbix_port_t:tcp_socket name_connect; #============= httpd_t ============== allow httpd_t postgresql_port_t:tcp_socket name_connect; このパッケージは、構成の複雑さを理由にユーザーがSELinuxをオフにしてしまうことがないようにするために作成されました。 これには、Zabbixの導入と設定を高速化するのに十分なデフォルトのポリシーが含まれています。 セキュリティレベルを最大限に高めるには、SELinuxの設定をカスタマイズすることをお勧めします。 In addition, Zabbix provides the zabbix-selinux-policy package as part of source RPM packages for [RHEL 8](http://repo.zabbix.com/zabbix/6.0/rhel/8/SRPMS/) and [RHEL 7](http://repo.zabbix.com/zabbix/6.0/rhel/8/SRPMS/). This package provides a basic default policy for SELinux and makes zabbix components work out-of-the-box by allowing Zabbix to create and use sockets and enabling httpd connection to PostgreSQL (used by frontend). The source *zabbix_policy.te* file contains the following rules: module zabbix_policy 1.2; require { type zabbix_t; type zabbix_port_t; type zabbix_var_run_t; type postgresql_port_t; type httpd_t; class tcp_socket name_connect; class sock_file { create unlink }; class unix_stream_socket connectto; } #============= zabbix_t ============== allow zabbix_t self:unix_stream_socket connectto; allow zabbix_t zabbix_port_t:tcp_socket name_connect; allow zabbix_t zabbix_var_run_t:sock_file create; allow zabbix_t zabbix_var_run_t:sock_file unlink; allow httpd_t zabbix_port_t:tcp_socket name_connect; #============= httpd_t ============== allow httpd_t postgresql_port_t:tcp_socket name_connect; This package has been created to prevent users from turning off SELinux because of the configuration complexity. It contains the default policy that is sufficient to speed up Zabbix deployment and configuration. For maximum security level, it is recommended to set custom SELinux settings. さらに、Zabbix は<br> [RHEL 8](http://repo.zabbix.com/zabbix/6.0/rhel/8/SRPMS/) と<br> [RHEL 7](http://repo.zabbix.com/zabbix/6.0/rhel/8/SRPMS/) のソース RPM パッケージの一部として<br> zabbix-selinux-policy パッケージも提供しています。<br> 本パッケージは SELinux の基本的なデフォルトポリシーを提供し、Zabbix が socket を作成、使用できるようにし、<br> httpd から PostgreSQL(フロントエンドで使用)に接続できるようにするなど、Zabbix コンポーネントをすぐに使用できるようにするものです。 ソース *zabbix_policy.te* ファイルには、以下のルールが含まれています: module zabbix_policy 1.2; require { type zabbix_t; type zabbix_port_t; type zabbix_var_run_t; type postgresql_port_t; type httpd_t; class tcp_socket name_connect; class sock_file { create unlink }; class unix_stream_socket connectto; } #============= zabbix_t ============== allow zabbix_t self:unix_stream_socket connectto; allow zabbix_t zabbix_port_t:tcp_socket name_connect; allow zabbix_t zabbix_var_run_t:sock_file create; allow zabbix_t zabbix_var_run_t:sock_file unlink; allow httpd_t zabbix_port_t:tcp_socket name_connect; #============= httpd_t ============== allow httpd_t postgresql_port_t:tcp_socket name_connect; 本パッケージは、設定の複雑さを理由にユーザが SELinux をオフにすることを防ぐために作成されました。<br> このパッケージには、Zabbix の導入と設定を高速化するのに十分なデフォルトポリシーが含まれています。<br> セキュリティレベルを最大限に高めるには、カスタム SELinux の設定を行うことをお勧めします。<br> ##### Incoming connections It is a bit more complicated with incoming connections because rules are specific for components and configuration. For Zabbix **agent**: |Agent connection setup|Cipher configuration| |----------------------|--------------------| |TLSConnect=cert|TLSCipherCert, TLSCipherCert13| |TLSConnect=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert|TLSCipherCert, TLSCipherCert13| |TLSAccept=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert,psk|TLSCipherAll, TLSCipherAll13| For Zabbix **server** and \*\* proxy\*\*: |Connection setup|Cipher configuration| |----------------|--------------------| |Outgoing connections using PSK|TLSCipherPSK, TLSCipherPSK13| |Incoming connections using certificates|TLSCipherAll, TLSCipherAll13| |Incoming connections using PSK if server has no certificate|TLSCipherPSK, TLSCipherPSK13| |Incoming connections using PSK if server has certificate|TLSCipherAll, TLSCipherAll13| Some pattern can be seen in the two tables above: - TLSCipherAll and TLSCipherAll13 can be specified only if a combined list of certificate- **and** PSK-based ciphersuites is used. There are two cases when it takes place: server (proxy) with a configured certificate (PSK ciphersuites are always configured on server, proxy if crypto library supports PSK), agent configured to accept both certificate- and PSK-based incoming connections - in other cases TLSCipherCert\* and/or TLSCipherPSK\* are sufficient The following tables show the `TLSCipher*` built-in default values. They could be a good starting point for your own custom values. |Parameter|GnuTLS 3.6.12| |---------|----------------------------------------| |TLSCipherCert|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509| |TLSCipherPSK|NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL| |TLSCipherAll|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509| |Parameter|OpenSSL 1.1.1d ^**1**^| |---------|----------------------------------------| |TLSCipherCert13|<| |TLSCipherCert|EECDH+aRSA+AES128:RSA+aRSA+AES128| |TLSCipherPSK13|TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256| |TLSCipherPSK|kECDHEPSK+AES128:kPSK+AES128| |TLSCipherAll13|<| |TLSCipherAll|EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128| ^**1**^ Default values are different for older OpenSSL versions (1.0.1, 1.0.2, 1.1.0), for LibreSSL and if OpenSSL is compiled without PSK support. \*\* Examples of user-configured ciphersuites \*\* See below the following examples of user-configured ciphersuites: - [Testing cipher strings and allowing only PFS ciphersuites](#testing_cipher_strings_and_allowing_only_pfs_ciphersuites) - [Switching from AES128 to AES256](#switching_from_aes128_to_aes256) ##### 着信コネクション 着信コネクションの場合、ルールがコンポーネントや構成によって異なるため、少し複雑になります。 Zabbix **agent** の場合 : |Agent connection setup|Cipher configuration| |----------------------|--------------------| |TLSConnect=cert|TLSCipherCert, TLSCipherCert13| |TLSConnect=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert|TLSCipherCert, TLSCipherCert13| |TLSAccept=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert,psk|TLSCipherAll, TLSCipherAll13| Zabbix **server** と \*\* proxy\*\* の場合: |Connection setup|Cipher configuration| |----------------|--------------------| |Outgoing connections using PSK|TLSCipherPSK, TLSCipherPSK13| |Incoming connections using certificates|TLSCipherAll, TLSCipherAll13| |Incoming connections using PSK if server has no certificate|TLSCipherPSK, TLSCipherPSK13| |Incoming connections using PSK if server has certificate|TLSCipherAll, TLSCipherAll13| 上の2つの表でいくつかのパターンを見ることができます: - TLSCipherAll および TLSCipherAll13は、証明書とPSKベースの暗号化方式を組み合わせたリストを使用する場合にのみ 指定できます。証明書が設定されている server(proxy)(PSK暗号スイートは、 cryptoライブラリがPSKをサポートしている場合、 server、proxy で常に設定されます)、証明書とPSKベースの両方の受信コネクションを受け入れるように設定された agent の場合 - その他の場合は、*TLSCipherCert* と *TLSCipherPSK* の両方またはどちらかで十分です。 以下の表は、`TLSCipher*` 組み込みのデフォルト値を示しています。これらは、独自のカスタム値のための良い出発点になる<br> 可能性があります。 |Parameter|GnuTLS 3.6.12| |---------|----------------------------------------| |TLSCipherCert|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509| |TLSCipherPSK|NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL| |TLSCipherAll|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509| |Parameter|OpenSSL 1.1.1d ^**1**^| |---------|----------------------------------------| |TLSCipherCert13|<| |TLSCipherCert|EECDH+aRSA+AES128:RSA+aRSA+AES128| |TLSCipherPSK13|TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256| |TLSCipherPSK|kECDHEPSK+AES128:kPSK+AES128| |TLSCipherAll13|<| |TLSCipherAll|EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128| ^**1**^ デフォルト値は、古いバージョンのOpenSSL（1.0.1、1.0.2、1.1.0）、LibreSSL、および OpenSSL が PSK を<br> サポートせずにコンパイルされた場合、それぞれ異なっています。 \*\* ユーザー設定暗号スイートの例 \*\* ユーザーが設定した暗号スイートは、以下の例を参照してください: - [Testing cipher strings and allowing only PFS ciphersuites](#testing_cipher_strings_and_allowing_only_pfs_ciphersuites) - [Switching from AES128 to AES256](#switching_from_aes128_to_aes256) ##### In connecting-side log: Linux: ...In zbx_tls_init_child() ...OpenSSL library (version OpenSSL 1.1.1 11 Sep 2018) initialized ... ...In zbx_tls_connect(): psk_identity:"PSK test sender" ...End of zbx_tls_connect():FAIL error:'connection closed by peer' ...send value error: TCP successful, cannot establish TLS to [[localhost]:10051]: connection closed by peer Windows: ...OpenSSL library (version OpenSSL 1.1.1a 20 Nov 2018) initialized ... ...In zbx_tls_connect(): psk_identity:"PSK test sender" ...zbx_psk_client_cb() requested PSK identity "PSK test sender" ...End of zbx_tls_connect():FAIL error:'SSL_connect() I/O error: [0x00000000] The operation completed successfully.' ...send value error: TCP successful, cannot establish TLS to [[192.168.1.2]:10051]: SSL_connect() I/O error: [0x00000000] The operation completed successfully. ##### 接続元ログ: Linux: ...In zbx_tls_init_child() ...OpenSSL library (version OpenSSL 1.1.1 11 Sep 2018) initialized ... ...In zbx_tls_connect(): psk_identity:"PSK test sender" ...End of zbx_tls_connect():FAIL error:'connection closed by peer' ...send value error: TCP successful, cannot establish TLS to [[localhost]:10051]: connection closed by peer Windows: ...OpenSSL library (version OpenSSL 1.1.1a 20 Nov 2018) initialized ... ...In zbx_tls_connect(): psk_identity:"PSK test sender" ...zbx_psk_client_cb() requested PSK identity "PSK test sender" ...End of zbx_tls_connect():FAIL error:'SSL_connect() I/O error: [0x00000000] The operation completed successfully.' ...send value error: TCP successful, cannot establish TLS to [[192.168.1.2]:10051]: SSL_connect() I/O error: [0x00000000] The operation completed successfully. #### Incorrect information from nested host groups in maps Information from nested host groups is incorrectly displayed in maps, for example: - Host group label displays the problem summary not including all hosts in nested host groups; - "Host group elements" view does not display a separate map element for each host in the nested host groups; - Map label displays summary of all problems not including those in nested host groups. #### マップ内のネストされたホストグループからの情報が不正確 ネストされたホストグループからの情報がマップに不正確に表示されます。例: - ホストグループラベルには、ネストされたホストグループ内のすべてのホストが含まれない障害の概要が表示されます。 - "ホストグループ要素"ビューには、ネストされたホストグループ内の各ホストの個別のマップ要素が表示されません。 - マップラベルには、ネストされたホストグループ内の問題が含まれないすべての障害の概要が表示されます。 #### Incorrect request method parameter in items The request method parameter, used only in HTTP checks, may be incorrectly set to '1', a non-default value for all items as a result of upgrade from a pre-4.0 Zabbix version. For details on how to fix this situation, see [ZBX-19308](https://support.zabbix.com/browse/ZBX-19308). #### アイテム内のリクエストメソッドパラメーターが正しくない HTTPチェックでのみ使用されるリクエストメソッドパラメーターが、4.0以前のZabbixからアップグレードした結果、 すべてのアイテムにデフォルト値ではない'1'が設定されることがあります。 この問題の解決方法の詳細については、[ZBX-19308](https://support.zabbix.com/browse/ZBX-19308)を参照してください。 #### Indexed macros The indexed macro syntax of {MACRO**<1-9>**} works only in the context of **trigger expressions**. It can be used to reference hosts or functions in the order in which they appear in the expression. Macros like {HOST.IP1}, {HOST.IP2}, {HOST.IP3} will resolve to the IP of the first, second, and third host in the trigger expression (providing the trigger expression contains those hosts). Macros like {FUNCTION.VALUE1}, {FUNCTION.VALUE2}, {FUNCTION.VALUE3} will resolve to the value of the first, second, and third item-based function in the trigger expression at the time of the event (providing the trigger expression contains those functions). Additionally the {HOST.HOST<1-9>} macro is also supported within the `{?func(/host/key,param)}` expression macro in **graph names**. For example, `{?func(/{HOST.HOST2}/key,param)}` in the graph name will refer to the host of the second item in the graph. ::: notewarning Indexed macros will not resolve in any other context, except the two cases mentioned here. For other contexts, use macros **without** index (i. e.{HOST.HOST}, {HOST.IP}, etc) instead. ::: #### インデックス付きマクロ {MACRO **<1-9>**}のインデックス付きマクロ構文は**トリガー式**のコンテキストでのみ機能します。 式に表示される順序でホストまたは関数を参照するために使用できます。{HOST.IP1},{HOST.IP2},{HOST.IP3}などのマクロは、トリガー式の1番目、2番目、および3番目のホストのIPに解決されます（トリガー式にこれらのホストが含まれている場合） {FUNCTION.VALUE1},{FUNCTION.VALUE2},{FUNCTION.VALUE3}などのマクロは、イベント時のトリガー式の1番目、2番目、および3番目のアイテムベースの関数の値に解決されます（トリガーを提供します） 式にはこれらの関数が含まれています） さらに{HOST.HOST<1-9>}マクロは**グラフ名**の`{?func(/host/key,param)}`式マクロ内でもサポートされています。 たとえばグラフ名の`{?func(/{HOST.HOST2}/key,param)}`は、グラフの2番目の項目のホストを参照します。 ::: notewarning インデックス付きマクロは、ここで説明した2つのケースを除いて、他のコンテキストでは解決されません。 他のコンテキストでは、代わりにインデックスなしのマクロ（つまり{HOST.HOST}、{HOST.IP}など）を使用します。 ::: #### Index lookup caching When a dynamic index item is requested, Zabbix retrieves and caches whole SNMP table under base OID for index, even if a match would be found sooner. This is done in case another item would refer to the same base OID later - Zabbix would look up index in the cache, instead of querying the monitored host again. Note that each poller process uses separate cache. In all subsequent value retrieval operations only the found index is verified. If it has not changed, value is requested. If it has changed, cache is rebuilt - each poller that encounters a changed index walks the index SNMP table again. #### index lookupのキャッシュ 動的インデックスアイテムが要求された場合、ZabbixはインデックスのベースOIDの下にある<br> SNMPテーブル全体を取得し、キャッシュします。<br> これは、別のアイテムが同じベースOIDを後で参照する場合に備えて行われます。<br> Zabbixは監視ホストに再度問い合わせる代わりに、キャッシュからインデックスを検索します。<br> 各ポーラープロセスは別々のキャッシュを使用していることに注意してください。<br> その後のすべての値取得操作では、見つかったインデックスのみが検証されます。<br> インデックスが変更されていない場合、値が要求されます。<br> 変更されたインデックスに遭遇した各ポーラは、インデックスSNMPテーブルを再度検索し、キャッシュを再構築します。<br> ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [EXAMPLES](#lbAF) [SEE ALSO](#lbAG) ------------------------------------------------------------------------ This document was created on: 21:23:35 GMT, March 18, 2020 ## 目次 [名前](#lbAB) [概要](#lbAC) [説明](#lbAD) [オプション](#lbAE) [例](#lbAF) [参照](#lbAG) ------------------------------------------------------------------------ ドキュメント作成日: 2020年3月18日 21:23:35 GMT ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [FILES](#lbAF) [SEE ALSO](#lbAG) [AUTHOR](#lbAH) ------------------------------------------------------------------------ This document was created on: 12:58:30 GMT, June 11, 2021 ## 目次 [名前](#lbAB) [概要](#lbAC) [説明](#lbAD) [オプション](#lbAE) [ファイル](#lbAF) [参照](#lbAG) [著者](#lbAH) ------------------------------------------------------------------------ ドキュメント作成日: 2021年6月11日 12:58:30 GMT ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [EXAMPLES](#lbAG) [SEE ALSO](#lbAH) [AUTHOR](#lbAI) ------------------------------------------------------------------------ This document was created on: 08:42:29 GMT, June 11, 2021 ## 目次 [名前](#lbAB) [概要](#lbAC) [説明](#lbAD) [オプション](#lbAE) [](#lbAF) [例](#lbAG) [参照](#lbAH) [著者](#lbAI) ------------------------------------------------------------------------ ドキュメント作成日: 2021年6月11日 08:42:29 GMT ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [EXIT STATUS](#lbAG) [EXAMPLES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 08:42:39 GMT, June 11, 2021 ## 目次 [名前](#lbAB) [概要](#lbAC) [説明](#lbAD) [オプション](#lbAE) [](#lbAF) [終了ステータス](#lbAG) [例](#lbAH) [参照](#lbAI) [著者](#lbAJ) ------------------------------------------------------------------------ ドキュメント作成日: 2021年6月11日 08:42:39 GMT ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [FILES](#lbAG) [SEE ALSO](#lbAH) [AUTHOR](#lbAI) ------------------------------------------------------------------------ This document was created on: 14:07:57 GMT, November 22, 2021 ## 目次 [名前](#lbAB) [概要](#lbAC) [説明](#lbAD) [オプション](#lbAE) [](#lbAF) [ファイル](#lbAG) [参照](#lbAH) [著者](#lbAI) ------------------------------------------------------------------------ ドキュメント作成日: 2021年11月22日 14:07:57 GMT ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [](#lbAG) [FILES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 16:12:14 GMT, September 04, 2020 ## 目次 [名前](#lbAB) [概要](#lbAC) [説明](#lbAD) [オプション](#lbAE) [](#lbAF) [](#lbAG) [ファイル](#lbAH) [参照](#lbAI) [著者](#lbAJ) ------------------------------------------------------------------------ ドキュメント作成日: 2020年9月4日 16:12:14 GMT ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [](#lbAG) [FILES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 16:12:22 GMT, September 04, 2020 ## 目次 [名前](#lbAB) [概要](#lbAC) [説明](#lbAD) [オプション](#lbAE) [](#lbAF) [](#lbAG) [ファイル](#lbAH) [参照](#lbAI) [著者](#lbAJ) ------------------------------------------------------------------------ ドキュメント作成日: 2020年9月4日 16:12:22 GMT ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [](#lbAG) [FILES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 20:50:13 GMT, November 22, 2021 ## 目次 [名前](#lbAB) [概要](#lbAC) [説明](#lbAD) [オプション](#lbAE) [](#lbAF) [](#lbAG) [ファイル](#lbAH) [参照](#lbAI) [著者](#lbAJ) ------------------------------------------------------------------------ ドキュメント作成日: 2021年11月22日 20:50:13 GMT #### Individual migration of history tables * Prepare directories for Data Pump for each history table. Data Pump must have read and write permissions to these directories. Example: ``` {.bash} mkdir -pv /export/history /export/history_uint /export/history_str /export/history_log /export/history_text 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; create directory history_uint as '/export/history_uint'; grant read,write on directory history_uint to zabbix; create directory history_str as '/export/history_str'; grant read,write on directory history_str to zabbix; create directory history_log as '/export/history_log'; grant read,write on directory history_log to zabbix; create directory history_text as '/export/history_text'; grant read,write on directory history_text to zabbix; ``` * Export and import each table. Replace N with the desired thread count. ``` {.bash} expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old REMAP_TABLE=history_old:history data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old REMAP_TABLE=history_uint_old:history_uint data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old REMAP_TABLE=history_str_old:history_str data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old REMAP_TABLE=history_log_old:history_log data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old REMAP_TABLE=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. #### ヒストリテーブルの個別移行 * ヒストリテーブルごとにData Pump用のディレクトリを用意してください。 Data Pump には、これらのディレクトリに対する読み取り権限と書き込み権限が必要です。 例: ``` {.bash} mkdir -pv /export/history /export/history_uint /export/history_str /export/history_log /export/history_text chown -R oracle:oracle /export ``` * ディレクトリ オブジェクトを作成し、Zabbix 認証に使用するユーザー (以下の例では'zabbix') に、このオブジェクトへの読み取りおよび書き込み権限を付与します。 *sysdba* ロールの下で、次を実行します。 ``` {.sql} create directory history as '/export/history'; grant read,write on directory history to zabbix; create directory history_uint as '/export/history_uint'; grant read,write on directory history_uint to zabbix; create directory history_str as '/export/history_str'; grant read,write on directory history_str to zabbix; create directory history_log as '/export/history_log'; grant read,write on directory history_log to zabbix; create directory history_text as '/export/history_text'; grant read,write on directory history_text to zabbix; ``` * 各テーブルをエクスポートおよびインポートします。 N を目的のスレッド数に置き換えます。 ``` {.bash} expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old REMAP_TABLE=history_old:history data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old REMAP_TABLE=history_uint_old:history_uint data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old REMAP_TABLE=history_str_old:history_str data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old REMAP_TABLE=history_log_old:history_log data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old REMAP_TABLE=history_text_old:history_text data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only ``` * [移行後の手順](#after-migration) に従って、古いテーブルを削除します。 ### Informational ### 情報提供 (Informational) ##### Informix Standard Informix utility **onstat** can be used for monitoring of virtually every aspect of Informix database. Also, Zabbix can retrieve information provided by Informix SNMP agent. ##### Informix 標準の Informix ユーティリティ **onstat** を使用して、Informix データベースのほぼすべてを監視できます。 また、Zabbix は、Informix SNMP エージェントによって提供される情報を取得できます。 ##### Input data ``` {.java} { "books": [ { "category": "reference", "author": "Nigel Rees", "title": "Sayings of the Century", "price": 8.95, "id": 1 }, { "category": "fiction", "author": "Evelyn Waugh", "title": "Sword of Honour", "price": 12.99, "id": 2 }, { "category": "fiction", "author": "Herman Melville", "title": "Moby Dick", "isbn": "0-553-21311-3", "price": 8.99, "id": 3 }, { "category": "fiction", "author": "J. R. R. Tolkien", "title": "The Lord of the Rings", "isbn": "0-395-19395-8", "price": 22.99, "id": 4 } ], "services": { "delivery": { "servicegroup": 1000, "description": "Next day delivery in local town", "active": true, "price": 5 }, "bookbinding": { "servicegroup": 1001, "description": "Printing and assembling book in A5 format", "active": true, "price": 154.99 }, "restoration": { "servicegroup": 1002, "description": "Various restoration methods", "active": false, "methods": [ { "description": "Chemical cleaning", "price": 46 }, { "description": "Pressing pages damaged by moisture", "price": 24.5 }, { "description": "Rebinding torn book", "price": 99.49 } ] } }, "filters": { "price": 10, "category": "fiction", "no filters": "no \"filters\"" }, "closed message": "Store is closed", "tags": [ "a", "b", "c", "d", "e" ] } ``` |JSONPath|Type|Result|Comments| |--|--|------|------| |`$.filters.price`|definite|10| | |`$.filters.category`|definite|fiction| | |`$.filters['no filters']`|definite|no "filters"| | |`$.filters`|definite|{<br>"price": 10,<br>"category": "fiction",<br>"no filters": "no \\"filters\\""<br>}| | |`$.books[1].title`|definite|Sword of Honour| | |`$.books[-1].author`|definite|J. R. R. Tolkien| | |`$.books.length()`|definite|4| | |`$.tags[:]`|indefinite|\["a", "b", "c", "d", "e" \]| | |`$.tags[2:]`|indefinite|\["c", "d", "e" \]| | |`$.tags[:3]`|indefinite|\["a", "b", "c"\]| | |`$.tags[1:4]`|indefinite|\["b", "c", "d"\]| | |`$.tags[-2:]`|indefinite|\["d", "e"\]| | |`$.tags[:-3]`|indefinite|\["a", "b"\]| | |`$.tags[:-3].length()`|definite|2| | |`$.books[0, 2].title`|indefinite|\["Moby Dick", "Sayings of the Century"\]| | |`$.books[1]['author', "title"]`|indefinite|\["Sword of Honour", "Evelyn Waugh"\]| | |`$..id`|indefinite|\[1, 2, 3, 4\]| | |`$.services..price`|indefinite|\[154.99, 5, 46, 24.5, 99.49\]| | |`$.books[?(@.id == 4 - 0.4 * 5)].title`|indefinite|\["Sword of Honour"\]|This query shows that arithmetical operations can be used in queries. Of course this query can be simplified to `$.books[?(@.id == 2)].title`| |`$.books[?(@.id == 2 \|\| @.id == 4)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(!(@.id == 2))].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.id != 2)].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.title =~ " of ")].title`|indefinite|\["Sayings of the Century", "Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.price > 12.99)].title`|indefinite|\["The Lord of the Rings"\]| | |`$.books[?(@.author > "Herman Melville")].title`|indefinite|\["Sayings of the Century", "The Lord of the Rings"\]| | |`$.books[?(@.price > $.filters.price)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.category == $.filters.category)].title`|indefinite|\["Sword of Honour","Moby Dick","The Lord of the Rings"\]| | |`$.books[?(@.category == "fiction" && @.price < 10)].title`|indefinite|\["Moby Dick"\]| | |`$..[?(@.id)]`|indefinite|\[<br>{<br>"price": 8.95,<br>"id": 1,<br>"category": "reference",<br>"author": "Nigel Rees",<br>"title": "Sayings of the Century"<br>},<br>{<br>"price": 12.99,<br>"id": 2,<br>"category": "fiction",<br>"author": "Evelyn Waugh",<br>"title": "Sword of Honour"<br>},<br>{<br>"price": 8.99,<br>"id": 3,<br>"category": "fiction",<br>"author": "Herman Melville",<br>"title": "Moby Dick",<br>"isbn": "0-553-21311-3"<br>},<br>{<br>"price": 22.99,<br>"id": 4,<br>"category": "fiction",<br>"author": "J. R. R. Tolkien",<br>"title": "The Lord of the Rings",<br>"isbn": "0-395-19395-8"<br>}<br>\]| | |`$.services..[?(@.price > 50)].description`|indefinite|'\["Printing and assembling book in A5 format", "Rebinding torn book"\]| | |`$..id.length()`|definite|4| | |`$.books[?(@.id == 2)].title.first()`|definite|Sword of Honour| | |`$..tags.first().length()`|definite|5|$..tags is indefinite path, so it returns an array of matched elements - \[\["a", "b", "c", "d", "e" \]\], first() returns the first element - \["a", "b", "c", "d", "e" \] and finally length() calculates its length - 5.| |`$.books[*].price.min()`|definite|8.95| | |`$..price.max()`|definite|154.99| | |`$.books[?(@.category == "fiction")].price.avg()`|definite|14.99| | |`$.books[?(@.category == $.filters.xyz)].title`|indefinite| |A query without match returns NULL for definite and indefinite paths.| |`$.services[?(@.active=="true")].servicegroup`|indefinite|\[1001,1000\]|Text constants must be used in boolean value comparisons.| |`$.services[?(@.active=="false")].servicegroup`|indefinite|\[1002\]|Text constants must be used in boolean value comparisons.| |`$.services[?(@.servicegroup=="1002")]~.first()`|definite|restoration| | ##### 入力データ ``` {.java} { "books": [ { "category": "reference", "author": "Nigel Rees", "title": "Sayings of the Century", "price": 8.95, "id": 1 }, { "category": "fiction", "author": "Evelyn Waugh", "title": "Sword of Honour", "price": 12.99, "id": 2 }, { "category": "fiction", "author": "Herman Melville", "title": "Moby Dick", "isbn": "0-553-21311-3", "price": 8.99, "id": 3 }, { "category": "fiction", "author": "J. R. R. Tolkien", "title": "The Lord of the Rings", "isbn": "0-395-19395-8", "price": 22.99, "id": 4 } ], "services": { "delivery": { "servicegroup": 1000, "description": "Next day delivery in local town", "active": true, "price": 5 }, "bookbinding": { "servicegroup": 1001, "description": "Printing and assembling book in A5 format", "active": true, "price": 154.99 }, "restoration": { "servicegroup": 1002, "description": "Various restoration methods", "active": false, "methods": [ { "description": "Chemical cleaning", "price": 46 }, { "description": "Pressing pages damaged by moisture", "price": 24.5 }, { "description": "Rebinding torn book", "price": 99.49 } ] } }, "filters": { "price": 10, "category": "fiction", "no filters": "no \"filters\"" }, "closed message": "Store is closed", "tags": [ "a", "b", "c", "d", "e" ] } ``` |JSONPath|Type|Result|Comments| |--|--|------|------| |`$.filters.price`|definite|10| | |`$.filters.category`|definite|fiction| | |`$.filters['no filters']`|definite|no "filters"| | |`$.filters`|definite|{<br>"price": 10,<br>"category": "fiction",<br>"no filters": "no \\"filters\\""<br>}| | |`$.books[1].title`|definite|Sword of Honour| | |`$.books[-1].author`|definite|J. R. R. Tolkien| | |`$.books.length()`|definite|4| | |`$.tags[:]`|indefinite|\["a", "b", "c", "d", "e" \]| | |`$.tags[2:]`|indefinite|\["c", "d", "e" \]| | |`$.tags[:3]`|indefinite|\["a", "b", "c"\]| | |`$.tags[1:4]`|indefinite|\["b", "c", "d"\]| | |`$.tags[-2:]`|indefinite|\["d", "e"\]| | |`$.tags[:-3]`|indefinite|\["a", "b"\]| | |`$.tags[:-3].length()`|definite|2| | |`$.books[0, 2].title`|indefinite|\["Moby Dick", "Sayings of the Century"\]| | |`$.books[1]['author', "title"]`|indefinite|\["Sword of Honour", "Evelyn Waugh"\]| | |`$..id`|indefinite|\[1, 2, 3, 4\]| | |`$.services..price`|indefinite|\[154.99, 5, 46, 24.5, 99.49\]| | |`$.books[?(@.id == 4 - 0.4 * 5)].title`|indefinite|\["Sword of Honour"\]|このクエリは、算術演算をクエリで使用できることを示しています。もちろん、このクエリは `$.books[?(@.id == 2)].title` に簡略化できます。| |`$.books[?(@.id == 2 \|\| @.id == 4)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(!(@.id == 2))].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.id != 2)].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.title =~ " of ")].title`|indefinite|\["Sayings of the Century", "Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.price > 12.99)].title`|indefinite|\["The Lord of the Rings"\]| | |`$.books[?(@.author > "Herman Melville")].title`|indefinite|\["Sayings of the Century", "The Lord of the Rings"\]| | |`$.books[?(@.price > $.filters.price)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.category == $.filters.category)].title`|indefinite|\["Sword of Honour","Moby Dick","The Lord of the Rings"\]| | |`$.books[?(@.category == "fiction" && @.price < 10)].title`|indefinite|\["Moby Dick"\]| | |`$..[?(@.id)]`|indefinite|\[<br>{<br>"price": 8.95,<br>"id": 1,<br>"category": "reference",<br>"author": "Nigel Rees",<br>"title": "Sayings of the Century"<br>},<br>{<br>"price": 12.99,<br>"id": 2,<br>"category": "fiction",<br>"author": "Evelyn Waugh",<br>"title": "Sword of Honour"<br>},<br>{<br>"price": 8.99,<br>"id": 3,<br>"category": "fiction",<br>"author": "Herman Melville",<br>"title": "Moby Dick",<br>"isbn": "0-553-21311-3"<br>},<br>{<br>"price": 22.99,<br>"id": 4,<br>"category": "fiction",<br>"author": "J. R. R. Tolkien",<br>"title": "The Lord of the Rings",<br>"isbn": "0-395-19395-8"<br>}<br>\]| | |`$.services..[?(@.price > 50)].description`|indefinite|'\["Printing and assembling book in A5 format", "Rebinding torn book"\]| | |`$..id.length()`|definite|4| | |`$.books[?(@.id == 2)].title.first()`|definite|Sword of Honour| | |`$..tags.first().length()`|definite|5|$..tags は不定パスなので、一致した要素の配列 - \[\["a", "b", "c", "d", "e" \]\] を返します。first() は最初の要素 - \["a", "b", "c", "d", "e" \] を返し、最後に length() はその長さ - 5 を計算します。| |`$.books[*].price.min()`|definite|8.95| | |`$..price.max()`|definite|154.99| | |`$.books[?(@.category == "fiction")].price.avg()`|definite|14.99| | |`$.books[?(@.category == $.filters.xyz)].title`|indefinite| |一致のないクエリは、明確なパスと不明確なパスに対して NULL を返します。| |`$.services[?(@.active=="true")].servicegroup`|indefinite|\[1001,1000\]|ブール値の比較ではテキスト定数を使用する必要があります。| |`$.services[?(@.active=="false")].servicegroup`|indefinite|\[1002\]|ブール値の比較ではテキスト定数を使用する必要があります。| |`$.services[?(@.servicegroup=="1002")]~.first()`|definite|restoration| | ## Installation ## インストール ##### Installation After this is done use the following command to install Zabbix agent as Windows service: C:\> c:\zabbix\zabbix_agentd.exe -c c:\zabbix\zabbix_agentd.conf -i Now you should be able to configure "Zabbix agent" service normally as any other Windows service. See [more details](/manual/appendix/install/windows_agent#installing_agent_as_windows_service) on installing and running Zabbix agent on Windows. ##### インストール 完了後、次のコマンドを使用してZabbixエージェントをWindowsサービスとしてインストールします: C:\> c:\zabbix\zabbix_agentd.exe -c c:\zabbix\zabbix_agentd.conf -i これで、"Zabbix agent"サービスをその他のWindowsサービスと同様、通常どおりに構成できるはずです。 WindowsでのZabbixエージェントのインストールと実行については、[詳細](/manual/appendix/install/windows_agent#Windowsサービスとしてのエージェントのインストール)を参照してください。 ##### Installation from packages An official zabbix-web-service package is available for RHEL/CentOS 8, SLES 15, Debian 10, Ubuntu 18.04, Ubuntu 20.04 in the [Zabbix repository](http://repo.zabbix.com/). Google Chrome browser is not included into these packages and has to be installed separately. ##### Installation from packages An official zabbix-web-service package is available for RHEL/CentOS 8, SLES 15, Debian 10, Ubuntu 18.04, Ubuntu 20.04 in the [Zabbix repository](http://repo.zabbix.com/). Google Chrome browser is not included into these packages and has to be installed separately. #### Installation from packages It has been observed that it is impossible to install a specific frontend version by running, e.g.: yum install -v zabbix-web-mysql-scl-5.0.0 As a workaround to this issue, if you wish to install a specific frontend version, specify version for all components, e.g.: yum install zabbix-web-mysql-scl-5.0.0 zabbix-apache-conf-scl-5.0.0 zabbix-web-5.0.0 zabbix-web-deps-scl-5.0.0 #### パッケージからのインストール 以下を実行して特定のWebインターフェースのバージョンをインストールすることは不可能であることが確認されています。 yum install -v zabbix-web-mysql-scl-5.0.0 この問題を回避して、特定のWebインターフェースのバージョンをインストールする場合は、すべてのコンポーネントのバージョンを指定します。 例: yum install zabbix-web-mysql-scl-5.0.0 zabbix-apache-conf-scl-5.0.0 zabbix-web-5.0.0 zabbix-web-deps-scl-5.0.0 ##### Installation from sources A configured Go version 1.13+ environment is required for building Zabbix agent 2. To compile Zabbix web service from sources, run the `./configure` script with `--enable-webservice` option (see [Installing Zabbix web service](/manual/installation/install#installing_zabbix_web_service) for additional details). A sample ./configure command for installing or upgrading Zabbix with addition of Zabbix web service may look like this: ./configure --enable-server --enable-proxy --enable-agent --enable-webservice --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-unixodbc --with-libxml2 --with-openssl ##### Installation from sources A configured Go version 1.13+ environment is required for building Zabbix agent 2. To compile Zabbix web service from sources, run the `./configure` script with `--enable-webservice` option (see [Installing Zabbix web service](/manual/installation/install#installing_zabbix_web_service) for additional details). A sample ./configure command for installing or upgrading Zabbix with addition of Zabbix web service may look like this: ./configure --enable-server --enable-proxy --enable-agent --enable-webservice --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-unixodbc --with-libxml2 --with-openssl #### Installation Please always read the installation manual for a particular module. It is recommended to install new modules one by one to catch failures easily. Just before you install a module: - Make sure you have downloaded the module from a trusted source. Installation of harmful code may lead to consequences, such as data loss - Different versions of the same module (same ID) can be installed in parallel, but only a single version can be enabled at once Steps to install a module: - Unpack your module within its own folder in the `modules` folder of the Zabbix frontend - Ensure that your module folder contains at least the manifest.json file - Navigate to [Module administration](/manual/web_interface/frontend_sections/administration/general#modules) and click the *Scan directory* button - New module will appear in the list along with its version, author, description and status - Enable module by clicking on its status Troubleshooting: |Problem|Solution| |---------|----------------------------------------| |*Module did not appear in the list*|Make sure that the manifest.json file exists in `modules/your-module/` folder of the Zabbix frontend. If it does that means the module does not suit the current Zabbix version. If manifest.json file does not exist, you have probably unpacked in the wrong directory.| |*Frontend crashed*|The module code is not compatible with the current Zabbix version or server configuration. Please delete module files and reload the frontend. You'll see a notice that some modules are absent. Go to [Module administration](/manual/web_interface/frontend_sections/administration/general#modules) and click *Scan directory* again to remove non-existent modules from the database.| |*Error message about identical namespace, ID or actions appears*|New module tried to register a namespace, ID or actions which are already registered by other enabled modules. Disable the conflicting module (mentioned in error message) prior to enabling the new one.| |*Technical error messages appear*|Report errors to the developer of the module.| #### インストール方法 各モジュールのインストールマニュアルを必ずお読みください。 <br> また新しいモジュールは、故障を未然に防ぐため、1つずつインストールすることをお勧めします。 <br> モジュールをインストールする前に : - 信頼できるソースからモジュールをダウンロードしたことを確認してください。 <br> 有害なコードをインストールすると、データ損失のような結果につながる可能性があります。 <br> - 同じモジュールの異なるバージョン（同じID）を並行してインストールすることができます。 <br> ただし、一度に有効化できるのは1つのバージョンだけです。 <br> モジュールをインストールする手順 : - Zabbixフロントエンドの`modules`フォルダにあるモジュール専用のフォルダに解凍します。 - モジュールフォルダに少なくともmanifest.jsonが含まれていることを確認してください。 - [Module administration](/manual/web_interface/frontend_sections/administration/general#modules)に移動し、 <br> *Scan directory* ボタンをクリックします。 - 新しいモジュールは、バージョン、作者、説明、ステータスとともにリストに表示されます。 - そのステータスをクリックして、モジュールを有効にします。 トラブルシューティング |問題点|解決策 |-------|--------| |*モジュールが一覧に表示されない*|Zabbixフロントエンドのmodules/your-module/`フォルダにmanifest.jsonファイルが存在することを確認してください。 <br>存在する場合、そのモジュールは現在のZabbixのバージョンに対応していないことを意味します。 <br>manifest.jsonファイルが存在しない場合、間違ったディレクトリで解凍された可能性があります。| |*フロントエンドがクラッシュしました|現在のZabbixのバージョンまたはサーバ構成とモジュールコードが互換性がありません。 <br>モジュールファイルを削除し、フロントエンドを再読み込みしてください。 <br>いくつかのモジュールが存在しないという通知が表示されます。[Module administration](/manual/web_interface/frontend_sections/administration/general#modules)に移動し、 <br>*Scan directory*をもう一度クリックして、存在しないモジュールをデータベースから削除してください。| |*同一の名前空間、ID、アクションに関するエラーメッセージが表示されます。|新しいモジュールを有効にする前に、競合するモジュール（エラーメッセージに記載）を無効にしてください。| |*技術的なエラーメッセージが表示される*|モジュールの開発者にエラーを報告してください。| #### Installation Please refer to [Oracle documentation](https://www.oracle.com/database/technologies/releasenote-odbc-ic.html) for all the necessary instructions. For some additional information please refer to: [Installing unixODBC](/manual/config/items/itemtypes/odbc_checks/). #### インストール 必要な手順については、[Oracleドキュメント](https://www.oracle.com/database/technologies/releasenote-odbc-ic.html)を参照してください。 追加情報については、[unixODBCのインストール](/manual/config/items/itemtypes/odbc_checks/)を参照してください。 #### Installation - **Red Hat Enterprise Linux**: ```bash dnf install mariadb-connector-odbc ``` - **Debian/Ubuntu**: Please refer to [MySQL documentation](https://dev.mysql.com/downloads/connector/odbc/) (for `mysql-connector-odbc`), or [MariaDB documentation](https://mariadb.com/kb/en/mariadb-connector-odbc/) (for `mariadb-connector-odbc`) to download necessary database driver for the corresponding platform. For some additional information please refer to: [installing unixODBC](/manual/config/items/itemtypes/odbc_checks/). #### インストール - **Red Hat Enterprise Linux**: ```bash dnf install mariadb-connector-odbc ``` - **Debian/Ubuntu**: 対応するプラットフォームに必要なデータベースドライバーをダウンロードするには、[MySQLドキュメント](https://dev.mysql.com/downloads/connector/odbc/)(`mysql-connector-odbc`の場合)または[MariaDBドキュメント](https://mariadb.com/kb/en/mariadb-connector-odbc/)(`mariadb-connector-odbc`の場合)を参照してください。 追加情報については、[unixODBCのインストール](/manual/config/items/itemtypes/odbc_checks/)を参照してください。 #### Installation - **Red Hat Enterprise Linux** ([EPEL](https://docs.fedoraproject.org/en-US/epel/) packages): ```bash dnf install epel-release dnf install freetds ``` - **Debian/Ubuntu**: Please refer to [FreeTDS user guide](http://www.freetds.org/userguide/) to download necessary database driver for the corresponding platform. For some additional information please refer to: [installing unixODBC](/manual/config/items/itemtypes/odbc_checks/). #### インストール - **Red Hat Enterprise Linux** ([EPEL](https://docs.fedoraproject.org/en-US/epel/) packages): ```bash dnf install epel-release dnf install freetds ``` - **Debian/Ubuntu**: [FreeTDSユーザーガイド](http://www.freetds.org/userguide/)を参照して、対応するプラットフォームに必要なデータベースドライバーをダウンロードしてください。 追加情報については[unixODBCのインストール](/manual/config/items/itemtypes/odbc_checks/)を参照してください。 #### Installation - **Red Hat Enterprise Linux**: ```{=html} <!-- --> ``` # yum install postgresql-odbc - **Debian/Ubuntu**: Please refer to [PostgreSQL documentation](https://www.postgresql.org/download/linux/ubuntu/) to download necessary database driver for the corresponding platform. For some additional information please refer to: [installing unixODBC](/manual/config/items/itemtypes/odbc_checks/). #### インストール - **Red Hat Enterprise Linux**: ```{=html} <!-- --> ``` # yum install postgresql-odbc - **Debian/Ubuntu**: 対応するプラットフォームのデータベースドライバは、[PostgreSQL documentation](https://www.postgresql.org/download/linux/ubuntu/)を参照し、<br> 対応するプラットフォーム用のデータベースドライバをダウンロードしてください。 追加情報については、[unixODBCのインストール](/manual/config/items/itemtypes/odbc_checks/)を参照してください。 ##### Installation See the [package installation](/manual/installation/install_from_packages) section for instructions on how to install Zabbix agent as package. Alternatively see instructions for [manual installation](/manual/installation/install#installing_zabbix_daemons) if you do not want to use packages. ::: noteimportant In general, 32bit Zabbix agents will work on 64bit systems, but may fail in some cases. ::: ##### インストール パッケージを使用してZabbixエージェントをインストールする方法については、[パッケージインストール](/manual/installation/install_from_packages)のセクションを参照してください。 また、パッケージを使用しない場合は[ソースコードからのインストール](/manual/installation/install#installing_zabbix_daemons)の手順を参照してください。 ::: noteimportant 一般的に、32bit版Zabbixエージェントは64bitのシステム上で動作しますが、場合によっては失敗する可能性があります。 ::: #### Installation steps To install, double-click the downloaded MSI file.   Accept the license to proceed to the next step.  Specify the following parameters. |Parameter|Description| |--|--------| |*Host name*|Specify host name.| |*Zabbix server IP/DNS*|Specify IP/DNS of Zabbix server.| |*Agent listen port*|Specify agent listen port (10050 by default).| |*Server or Proxy for active checks*|Specify IP/DNS of Zabbix server/proxy for active agent checks.| |*Enable PSK*|Mark the checkbox to enable TLS support via pre-shared keys.| |*Add agent location to the PATH*|Add agent location to the PATH variable.|  Enter pre-shared key identity and value. This step is only available if you checked *Enable PSK* in the previous step.  Select Zabbix components to install - [Zabbix agent daemon](/manual/concepts/agent), [Zabbix sender](/manual/concepts/sender), [Zabbix get](/manual/concepts/get).  Zabbix components along with the configuration file will be installed in a *Zabbix Agent* folder in Program Files. zabbix\_agentd.exe will be set up as Windows service with automatic startup.  #### インストール手順 インストールするには、ダウンロードしたMSIファイルをダブルクリックします。   ライセンスに同意して次のステップに進みます。  以下のパラメーターを指定します。 |パラメーター|説明| |--|--------| |*Host name*|ホスト名を指定します。| |*Zabbix server IP/DNS*|ZabbixサーバーのIP/DNSを指定します。| |*Agent listen port*|エージェントのリッスン ポートを指定します (デフォルトは10050)。| |*Server or Proxy for active checks*|アクティブエージェントチェック用のZabbixサーバー/プロキシのIP/DNSを指定します。| |*Enable PSK*|チェックボックスをマークして、事前共有キーによるTLSサポートを有効にします。| |*Add agent location to the PATH*|エージェントの場所をPATH変数に追加します。|  事前共有鍵のIDと値を入力します。 このステップは、前のステップで*Enable PSK*をチェックした場合のみ利用できます。  インストールするZabbixコンポーネントを選択します - [Zabbix agent daemon](/manual/concepts/agent)、[Zabbix sender](/manual/concepts/sender)、[Zabbix get](/manual/concepts/get)。  Zabbixコンポーネントと設定ファイルはProgram Filesの*Zabbix Agent*フォルダにインストールされます。 zabbix_agentd.exeは自動起動のWindowsサービスとして設定されます。  #### Installation The official zabbix-web-service package is available in the [Zabbix repository](https://repo.zabbix.com/zabbix/). To compile Zabbix web service [from sources](/manual/installation/install#installing_zabbix_web_service), specify the `--enable-webservice` configure option. To configure Zabbix web service, update the [`zabbix_web_service.conf`](/manual/appendix/config/zabbix_web_service) configuration file parameters. ::: noteimportant It is strongly recommended to set up encryption between Zabbix server and Zabbix web service [using certificates](/manual/encryption/using_certificates). By default, data transmitted between Zabbix server and Zabbix web service is not encrypted, which can lead to unauthorized access. ::: #### インストール 公式のzabbix-web-serviceパッケージは[Zabbixリポジトリ](https://repo.zabbix.com/zabbix/)から入手できます。 Zabbix Webサービスを[ソースから](/manual/installation/install#Zabbix_Webサービスのインストール)コンパイルするには、`--enable-webservice`設定オプションを指定します。 Zabbix Webサービスを設定するには、[`zabbix_web_service.conf`](/manual/appendix/config/zabbix_web_service)設定ファイルのパラメーターを更新します。 ::: noteimportant ZabbixサーバーとZabbix Webサービスの間の暗号化を[証明書を使用して](/manual/encryption/using_certificates)設定することを強くお勧めします。デフォルトでは、ZabbixサーバーとZabbix Webサービスの間で送信されるデータは暗号化されないため、不正アクセスにつながる可能性があります。 ::: #### Installation To install Zabbix agent 2, the following options are available: Windows: - from a pre-compiled binary - download the binary and follow the instructions on the [Windows agent installation from MSI](/manual/installation/install_from_packages/win_msi) page - from sources - see [Building Zabbix agent 2 on Windows](/manual/installation/install/building_zabbix_agent_2_on_windows) Linux: - from distribution packages - follow the instructions on the [Zabbix packages](https://www.zabbix.com/download?zabbix=6.0&os_distribution=alma_linux&os_version=9&components=agent_2&db=&ws=) page, available by choosing your distribution and the Agent 2 component - from sources - see [Installation from sources](/manual/installation/install#configure-the-sources); note that you must configure the sources by specifying the `--enable-agent2` configuration option ::: noteclassic Zabbix agent 2 monitoring capabilities can be extended with plugins. While built-in plugins are available out-of-the-box, loadable plugins must be installed separately. For more information, see [Plugins](/manual/config/items/plugins#loadable). ::: #### インストール Zabbixエージェント2をインストールする方法はいくつかあります: Windows: - コンパイル済みのバイナリから - バイナリをダウンロードし、[MSIからのWindowsエージェントのインストール](/manual/installation/install_from_packages/win_msi)ページの指示に従います。 - ソースから - [WindowsでのZabbixエージェント2の構築](/manual/installation/install/building_zabbix_agent_2_on_windows)を参照します。 Linux: - 配付パッケージから - [Zabbixパッケージ](https://www.zabbix.com/download?zabbix=6.0&os_distribution=alma_linux&os_version=9&components=agent_2&db=&ws=)ページの指示に従います。このページは、ディストリビューションとエージェント2コンポーネントを選択することで利用できます。 - ソースから - [ソースコードからのインストール](/manual/installation/install#ソースの構成)を参照してください。`--enable-agent2`構成オプションを指定してソースを構成する必要があることに注意してください。 ::: noteclassic Zabbixエージェント2の監視機能は、プラグインを使用して拡張できます。組み込みプラグインはすぐに使用できますが、ロード可能なプラグインは個別にインストールする必要があります。詳細については、[プラグイン](/manual/config/items/plugins#ロード可能)を参照してください。 ::: # Installation with OpenShift # OpenShiftでのインストール #### Install If installing Zabbix from sources, download the configuration file and place it under conf/ in the webserver HTML documents subdirectory where you copied Zabbix PHP files to. {width="550"} {width="350"} ::: notetip Providing the webserver user has write access to conf/ directory the configuration file would be saved automatically and it would be possible to proceed to the next step right away. ::: Finish the installation. {width="550"} #### インストール Zabbixをソースからインストールする場合、設定ファイルをダウンロードし、ZabbixのPHPファイルをコピーしたWebサーバーのHTMLドキュメントサブディレクトリのconf/以下に配置します。 {width="550"} {width="350"} ::: notetip Webサーバーユーザーにconf/ディレクトリへの書き込み権限がある場合、設定ファイルは自動的に保存され、次の作業に進むことができます。 ::: インストールを終了します。 {width="550"}. #### Installing agent as Windows service To install a single instance of Zabbix agent with the default configuration file `c:\zabbix_agentd.conf`: zabbix_agentd.exe --install ::: noteimportant On a 64-bit system, a 64-bit Zabbix agent version is required for all checks related to running 64-bit processes to work correctly. ::: If you wish to use a configuration file other than `c:\zabbix_agentd.conf`, you should use the following command for service installation: zabbix_agentd.exe --config <your_configuration_file> --install A full path to the configuration file should be specified. Multiple instances of Zabbix agent can be installed as services like this: zabbix_agentd.exe --config <configuration_file_for_instance_1> --install --multiple-agents zabbix_agentd.exe --config <configuration_file_for_instance_2> --install --multiple-agents ... zabbix_agentd.exe --config <configuration_file_for_instance_N> --install --multiple-agents The installed service should now be visible in Control Panel. #### Windowsサービスとしてのエージェントのインストール デフォルトの設定ファイル`c:\zabbix_agentd.conf`を使用してZabbixエージェントの単一インスタンスをインストールするには： zabbix_agentd.exe --install ::: noteimportant 64ビットシステムでは、64ビットプロセスの実行に関連するすべてのチェックが正しく機能するために、64ビット版のZabbixエージェントが必要です。 ::: `c:\zabbix_agentd.conf`以外の設定ファイルを使用するには、サービスのインストールに次のコマンドを使用する必要があります。 zabbix_agentd.exe --config <your_configuration_file> --install 構成ファイルへのフルパスを指定する必要があります。 Zabbixエージェントの複数のインスタンスは、次のようなサービスとしてインストールできます。 zabbix_agentd.exe --config <configuration_file_for_instance_1> --install --multiple-agents zabbix_agentd.exe --config <configuration_file_for_instance_2> --install --multiple-agents ... zabbix_agentd.exe --config <configuration_file_for_instance_N> --install --multiple-agents インストールされたサービスがコントロールパネルに表示されます。 #### Installing agent The agent can be installed using the graphical user interface or from the command line, for example: sudo installer -pkg zabbix_agent-6.0.12-macos-amd64-openssl.pkg -target / Make sure to use the correct Zabbix package version in the command. It must match the name of the downloaded package. #### エージェントのインストール エージェントはグラフィカルユーザーインターフェース、またはコマンドラインからインストールできます。 次に例を示します。 sudo installer -pkg zabbix_agent-6.0.12-macos-amd64-openssl.pkg -target / コマンドでは正しいZabbixパッケージバージョンを指定していることを確認してください。 ダウンロードしたパッケージの名前と一致する必要があります。 ### Installing debuginfo packages ::: noteclassic Debuginfo packages are currently available for RHEL/CentOS versions 7, 6 and 5. ::: To enable debuginfo repository edit */etc/yum.repos.d/zabbix.repo* file. Change `enabled=0` to `enabled=1` for zabbix-debuginfo repository. [zabbix-debuginfo] name=Zabbix Official Repository debuginfo - $basearch baseurl=http://repo.zabbix.com/zabbix/5.4/rhel/8/$basearch/debuginfo/ enabled=0 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 gpgcheck=1 This will allow you to install the zabbix-debuginfo package. # yum install zabbix-debuginfo This single package contains debug information for all binary Zabbix components. ### Installing debuginfo packages ::: noteclassic Debuginfo packages are currently available for RHEL/CentOS versions 7, 6 and 5. ::: To enable debuginfo repository edit */etc/yum.repos.d/zabbix.repo* file. Change `enabled=0` to `enabled=1` for zabbix-debuginfo repository. [zabbix-debuginfo] name=Zabbix Official Repository debuginfo - $basearch baseurl=http://repo.zabbix.com/zabbix/5.4/rhel/8/$basearch/debuginfo/ enabled=0 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 gpgcheck=1 This will allow you to install the zabbix-debuginfo package. # yum install zabbix-debuginfo This single package contains debug information for all binary Zabbix components. ### Installing debuginfo packages :::noteclassic Debuginfo packages are currently available for RHEL/CentOS versions 7, 6 and 5. ::: To enable debuginfo repository, edit */etc/yum.repos.d/zabbix.repo* file. Change `enabled=0` to `enabled=1` for zabbix-debuginfo repository. [zabbix-debuginfo] name=Zabbix Official Repository debuginfo - $basearch baseurl=http://repo.zabbix.com/zabbix/5.5/rhel/7/$basearch/debuginfo/ enabled=0 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 gpgcheck=1 This will allow you to install the zabbix-debuginfo package. # yum install zabbix-debuginfo This single package contains debug information for all binary Zabbix components. ### debuginfo パッケージのインストール :::noteclassic Debuginfo パッケージは現在、RHEL/CentOS バージョン 7、6、5 で利用可能です。 ::: debuginfo リポジトリを有効にするには、*/etc/yum.repos.d/zabbix.repo* ファイルを編集します。<br> zabbix-debuginfo リポジトリの `enabled=0` を `enabled=1` に変更します。 [zabbix-debuginfo] name=Zabbix Official Repository debuginfo - $basearch baseurl=http://repo.zabbix.com/zabbix/5.5/rhel/7/$basearch/debuginfo/ enabled=0 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 gpgcheck=1 これにより、zabbix-debuginfo パッケージをインストールすることができます。 # yum install zabbix-debuginfo このパッケージには、すべてのZabbixコンポーネントのデバッグ情報が含まれています。 ### Installing debuginfo packages :::noteclassic Debuginfo packages are currently available for RHE versions 7, 6 and 5. ::: To enable debuginfo repository, edit */etc/yum.repos.d/zabbix.repo* file. Change `enabled=0` to `enabled=1` for zabbix-debuginfo repository. [zabbix-debuginfo] name=Zabbix Official Repository debuginfo - $basearch baseurl=http://repo.zabbix.com/zabbix/5.5/rhel/7/$basearch/debuginfo/ enabled=0 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 gpgcheck=1 This will allow you to install the zabbix-debuginfo package. dnf install zabbix-debuginfo This single package contains debug information for all binary Zabbix components. ### debuginfoパッケージのインストール :::noteclassic Debuginfoパッケージは、現在、RHELのバージョン 7、6、5で利用可能です。 ::: debuginfoリポジトリを有効にするには、*/etc/yum.repos.d/zabbix.repo*ファイルを編集します。zabbix-debuginfoリポジトリの`enabled=0`を`enabled=1`に変更します。 [zabbix-debuginfo] name=Zabbix Official Repository debuginfo - $basearch baseurl=http://repo.zabbix.com/zabbix/5.5/rhel/7/$basearch/debuginfo/ enabled=0 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 gpgcheck=1 これによってzabbix-debuginfoパッケージをインストールすることができます。 dnf install zabbix-debuginfo このパッケージには、すべてのZabbixコンポーネントのデバッグ情報が含まれています。 ### Installing debuginfo packages To enable debuginfo repository edit */etc/zypp/repos.d/zabbix.repo* file. Change `enabled=0` to `enabled=1` for zabbix-debuginfo repository. [zabbix-debuginfo] name=Zabbix Official Repository debuginfo type=rpm-md baseurl=http://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/debuginfo/ gpgcheck=1 gpgkey=http://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/debuginfo/repodata/repomd.xml.key enabled=0 update=1 This will allow you to install zabbix-***<component>***-debuginfo packages. ### debuginfoパッケージのインストール debuginfoリポジトリを有効にするには、*/etc/zypp/repos.d/zabbix.repo*ファイルを編集します。 zabbix-debuginfoリポジトリの`enabled=0`を`enabled=1`に変更します。 [zabbix-debuginfo] name=Zabbix Official Repository debuginfo type=rpm-md baseurl=http://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/debuginfo/ gpgcheck=1 gpgkey=http://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/debuginfo/repodata/repomd.xml.key enabled=0 update=1 これによりzabbix-***<component>***-debuginfo パッケージをインストールできます。 ##### Installing frontend Please see [Web interface installation](/manual/installation/frontend) page for information about Zabbix frontend installation wizard. ##### Webインターフェースのインストール Zabbix Webインターフェースのインストールウィザードの詳細については、[Webインターフェースのインストール](/manual/installation/frontend) ページを参照してください。 #### Installing locales To list all installed languages, run: locale -a If some languages that are needed are not listed, open the */etc/locale.gen* file and uncomment the required locales. Since Zabbix uses UTF-8 encoding, you need to select locales with UTF-8 charset. Now, run: locale-gen Restart the web server. The locales should now be installed. It may be required to reload Zabbix frontend page in browser using Ctrl + F5 for new languages to appear. #### ロケールのインストール インストールされているすべての言語のリストを表示するには、次のコマンドを実行します。 locale -a 必要な言語がリストにない場合は*/etc/locale.gen*ファイルを開き、必要なロケールのコメントを解除します。 ZabbixはUTF-8エンコーディングを使用するため、UTF-8文字セットを使用してロケールを選択する必要があります。 次に以下を実行します。 locale-gen Webサーバーを再起動してください。 これでロケールがインストールされました。新しい言語を表示するには、Ctrl+F5でブラウザ上のZabbix Webインターフェースページを再読み込みする必要がある場合があります。 #### Installing MIB files On Debian-based systems: # apt install snmp-mibs-downloader # download-mibs On RedHat-based systems: # yum install net-snmp-libs #### MIBファイルのインストール Debianベースのシステムの場合: # apt install snmp-mibs-downloader # download-mibs RedHat ベースのシステムの場合: # yum install net-snmp-libs #### Installing MinGW Compiler 1\. Download MinGW-w64 with SJLJ (set jump/long jump) Exception Handling and Windows threads (for example *x86\_64-8.1.0-release-win32-sjlj-rt\_v6-rev0.7z*)\ 2. Extract and move to *c:\\mingw*\ 3. Setup environmental variable @echo off set PATH=%PATH%;c:\mingw\bin cmd When compiling use Windows prompt instead of MSYS terminal provided by MinGW #### MinGWコンパイラのインストール 1\. SJLJ (set jump/long jump)例外処理と Windowsスレッドを備えたMinGW-w64をダウンロードします (例: *x86\_64-8.1.0-release-win32-sjlj-rt\_v6-rev0.7z*)\ 2. 解凍して、*c:\\mingw*へ移動します。\ 3. 環境変数の設定をします。 @echo off set PATH=%PATH%;c:\mingw\bin cmd コンパイル時に、MinGWが提供するMSYSターミナルの代わりにWindowsプロンプトを使用します。 #### Installing unixODBC drivers A unixODBC database driver should be installed for the database, which will be monitored. unixODBC has a list of supported databases and drivers: <http://www.unixodbc.org/drivers.html>. In some Linux distributions database drivers are included in package repositories. Installing MySQL database driver on RedHat/Fedora based systems using the *yum* package manager: shell> yum install mysql-connector-odbc Installing MySQL database driver on SUSE based systems using the *zypper* package manager: zypper in MyODBC-unixODBC #### unixODBC ドライバのインストール 監視するデータベースには、unixODBCデータベースドライバをインストールする必要があります。<br> unixODBCには、サポートされているデータベースとドライバのリストがあります。<br> <http://www.unixodbc.org/drivers.html><br> Linuxディストリビューションによっては、データベースドライバがパッケージリポジトリに含まれている場合があります。<br> RedHat/Fedora ベースのシステムで、*yum* パッケージマネージャを使用して MySQL データベースドライバをインストールする場合: shell> yum install mysql-connector-odbc SUSE ベースのシステムで、*zypper* パッケージマネージャを使用して MySQL データベースドライバをインストールする場合: zypper で MyODBC-unixODBC #### Installing unixODBC The suggested way of installing unixODBC is to use the Linux operating system default package repositories. In the most popular Linux distributions unixODBC is included in the package repository by default. If it's not available, it can be obtained at the unixODBC homepage: <http://www.unixodbc.org/download.html>. Installing unixODBC on RedHat/Fedora based systems using the *yum* package manager: shell> yum -y install unixODBC unixODBC-devel Installing unixODBC on SUSE based systems using the *zypper* package manager: # zypper in unixODBC-devel ::: noteclassic The unixODBC-devel package is needed to compile Zabbix with unixODBC support. ::: #### unixODBC のインストール unixODBC をインストールする推奨される方法は、Linux オペレーティングシステムのデフォルトパッケージリポジトリを<br> 使用することです。最も人気のあるLinuxディストリビューションでは、unixODBCはデフォルトで<br> パッケージリポジトリに含まれています。<br> もし利用できない場合は、unixODBCのホームページで入手することができます。<br> <http://www.unixodbc.org/download.html>. RedHat/Fedora ベースのシステムで *yum* パッケージマネージャを使用して unixODBC をインストールします。 shell> yum -y install unixODBC unixODBC-devel SUSE ベースのシステムで *zypper* パッケージマネージャを使用して unixODBC をインストールします。 # zypper in unixODBC-devel ::: noteclassic unixODBC-develパッケージは、unixODBCをサポートするZabbixをコンパイルするために必要です。 ::: #### Installing Zabbix If installing Zabbix directly from [Zabbix git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), translation files should be generated manually. To generate translation files, run: make gettext locale/make_mo.sh This step is not needed when installing Zabbix from packages or source tar.gz files. #### Zabbixのインストール [Zabbix gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse)から直接Zabbixをインストールする場合は、翻訳ファイルを手動で生成する必要があります。翻訳ファイルを生成するには、次のコマンドを実行します。 make gettext locale/make_mo.sh パッケージまたはソースtar.gzファイルからZabbixをインストールする場合、この手順は必要ありません。 #### Installing Zabbix Operator #### Zabbix Operatorのインストール ### Integer history The integer history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|integer|Received value.| ### Integer history Integer history オブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|integer|Received value.| ### Integer trend The integer trend object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Timestamp of an hour for which the value was calculated. E. g. timestamp of 04:00:00 means values calculated for period 04:00:00-04:59:59.| |itemid|integer|ID of the related item.| |num|integer|Number of values that were available for the hour.| |value\_min|integer|Hourly minimum value.| |value\_avg|integer|Hourly average value.| |value\_max|integer|Hourly maximum value.| ### Integer trend integer trend オブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |clock|timestamp|値が計算された時間のタイムスタンプ。 例: 04:00:00の場合、04:00:00-04:59:59の間で計算された値であることを意味します。| |itemid|integer|関連アイテムのID| |num|integer|その時間に使用可能だった値の数| |value\_min|integer|1時間ごとの最小値| |value\_avg|integer|1時間ごとの平均値| |value\_max|integer|1時間ごとの最大値| #### Integrations The following integrations are available allowing to use predefined webhook media types for pushing Zabbix notifications to: - [brevis.one](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/brevis.one/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Discord](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/discord/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Express.ms messenger](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/express.ms/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Github issues](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/github/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GLPi](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/glpi/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [iLert](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/ilert/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [iTop](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/itop/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Jira](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Jira Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira_servicedesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [ManageEngine ServiceDesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/manageengine_servicedesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Mattermost](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/mattermost/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft Teams](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/msteams/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Opsgenie](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/opsgenie/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [OTRS](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/otrs/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Pagerduty](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pagerduty/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Pushover](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Redmine](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/redmine/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Rocket.Chat](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/rocketchat/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [ServiceNow](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/servicenow/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SIGNL4](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/signl4/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Slack](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/slack/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SolarWinds](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/solarwinds/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SysAid](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/sysaid/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Telegram](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/telegram/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [TOPdesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/topdesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [VictorOps](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/victorops/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Zammad](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/zammad/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Zendesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/zendesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) ::: notetip In addition to the services listed here, Zabbix can be integrated with **Spiceworks** (no webhook is required). To convert Zabbix notifications into Spiceworks tickets, create an [email media type](/manual/config/notifications/media/email) and enter Spiceworks helpdesk email address (e.g. help\@zabbix.on.spiceworks.com) in the profile settings of a designated Zabbix user. ::: #### インテグレーション 以下のインテグレーションを利用することで、定義済みの Webhook メディアタイプを使用して Zabbix 通知をプッシュすることができます: - [brevis.one](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/brevis.one/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Discord](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/discord/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Express.ms messenger](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/express.ms/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Github issues](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/github/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GLPi](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/glpi/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [iLert](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/ilert/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [iTop](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/itop/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Jira](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Jira Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira_servicedesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [ManageEngine ServiceDesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/manageengine_servicedesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Mattermost](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/mattermost/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft Teams](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/msteams/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Opsgenie](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/opsgenie/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [OTRS](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/otrs/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Pagerduty](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pagerduty/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Pushover](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Redmine](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/redmine/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Rocket.Chat](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/rocketchat/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [ServiceNow](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/servicenow/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SIGNL4](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/signl4/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Slack](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/slack/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SolarWinds](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/solarwinds/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SysAid](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/sysaid/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Telegram](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/telegram/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [TOPdesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/topdesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [VictorOps](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/victorops/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Zammad](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/zammad/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Zendesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/zendesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) ::: notetip ここに挙げたサービスに加え、Zabbix は **Spiceworks** と連携することができます。(Webhookは不要です) Zabbixの通知をSpiceworksのチケットに変換するには、[email media type](/manual/config/notifications/media/email)を作成し、Spiceworksヘルプデスクのメールアドレス<br> (例: help@zabbix.on.spiceworks.com) を指定したZabbixのプロファイル設定に入力する必要があります。 ::: ##### Interface creation when adding hosts When hosts are added as a result of network discovery, they get interfaces created according to these rules: - the services detected - for example, if an SNMP check succeeded, an SNMP interface will be created - if a host responded both to Zabbix agent and SNMP requests, both types of interfaces will be created - if uniqueness criteria are Zabbix agent or SNMP-returned data, the first interface found for a host will be created as the default one. Other IP addresses will be added as additional interfaces. Action's conditions (such as Host IP) do not impact adding interfaces. *Note* that this will work if all interfaces are discovered by the same discovery rule. If a different discovery rule discovers a different interface of the same host, an additional host will be added. - if a host responded to agent checks only, it will be created with an agent interface only. If it would start responding to SNMP later, additional SNMP interfaces would be added. - if 3 separate hosts were initially created, having been discovered by the "IP" uniqueness criteria, and then the discovery rule is modified so that hosts A, B and C have identical uniqueness criteria result, B and C are created as additional interfaces for A, the first host. The individual hosts B and C remain. In *Monitoring → Discovery* the added interfaces will be displayed in the "Discovered device" column, in black font and indented, but the "Monitored host" column will only display A, the first created host. "Uptime/Downtime" is not measured for IPs that are considered to be additional interfaces. ##### ホスト追加時のインターフェース作成 ホストがネットワークディスカバリの結果として追加されると、次のルールに従って作成されたインターフェイスを取得します。 - 検出されたサービス - たとえば、SNMP チェックが成功した場合、SNMP インターフェースが作成されます - ホストが Zabbix エージェントと SNMP リクエストの両方に応答した場合、両方のタイプのインターフェースが作成されます - 一意性の基準が Zabbix エージェントまたは SNMP から返されたデータである場合、ホストに対して最初に見つかったインターフェイスがデフォルトとして作成されます。 その他の IP アドレスは、追加のインターフェイスとして追加されます。 アクションの条件 (ホスト IP など) は、インターフェイスの追加には影響しません。 *注意* これは、すべてのインターフェースが同じディスカバリルールによって検出された場合に機能することに注意してください。 別のディスカバリルールが同じホストの別のインターフェイスを検出した場合、追加のホストが追加されます。 - ホストがエージェント チェックのみに応答した場合、ホストはエージェント インターフェイスのみで作成されます。 後で SNMP への応答を開始した場合は、追加の SNMP インターフェイスが追加されます。 - 'IP'による一意性基準によって検出された 3 つの個別のホストが最初に作成され、ホスト A、B、および C が同一の一意性基準結果を持つようにディスカバリルールが変更された場合、B および C は A の追加インターフェイスとして作成されます。 最初のホストである個々のホスト B と C は残ります。 *監視データ → ディスカバリ* では、追加されたインターフェースは"検出されたデバイス"列に黒いフォントでインデントされて表示されますが"監視対象ホスト"列には最初に作成されたホストである A のみが表示されます。 追加のインターフェースと見なされる IP については"アップタイム/ダウンタイム"は測定されません。 ### Internal authentication The *Authentication* tab allows defining custom password complexity requirements for internal Zabbix users.  The following password policy options can be configured: |Parameter|Description| |--|--------| |*Minimum password length*|By default, the minimum password length is set to 8. Supported range: 1-70. Note that passwords longer than 72 characters will be truncated.| |*Password must contain*|Mark one or several checkboxes to require usage of specified characters in a password:<br>-an uppercase and a lowercase Latin letter<br>-a digit<br>-a special character<br><br>Hover over the question mark to see a hint with the list of characters for each option.| |*Avoid easy-to-guess passwords*|If marked, a password will be checked against the following requirements:<br>- must not contain user's name, surname, or username<br>- must not be one of the common or context-specific passwords.<br><br>The list of common and context-specific passwords is generated automatically from the list of NCSC "Top 100k passwords", the list of SecLists "Top 1M passwords" and the list of Zabbix context-specific passwords. Internal users will not be allowed to set passwords included in this list as such passwords are considered weak due to their common use.| Changes in password complexity requirements will not affect existing user passwords, but if an existing user chooses to change a password, the new password will have to meet current requirements. A hint with the list of requirements will be displayed next to the *Password* field in the [user profile](/manual/web_interface/user_profile) and in the [user configuration form](/manual/config/users_and_usergroups/user) accessible from the *Administration→Users* menu. ### 認証 *認証*タブでは、Zabbix内部ユーザーのカスタムパスワード要件を定義できます。  次のパスワードポリシーオプションを設定できます。 |パラメータ|説明| |--|--------| |*最小パスワード長*|デフォルトではパスワードの最小長は8に設定されています。設定可能範囲:1〜70。 72文字を超えるパスワードは切り捨てられます。| |*パスワード必須項目*|1つまたは複数のチェックボックスをオンにして、パスワードで指定した文字を使用するよう強制します。<br>-英字の大文字と小文字<br>-数字<br>-特殊記号<br><br>疑問符にカーソルを合わせると各オプションの文字リストを含むヒントを表示します。| |*推測されやすいパスワードの回避*|チェックボックスがオンの場合、パスワードは次の要件に基づいてチェックされます。<br>-ユーザーの苗字、名前、またはユーザー名を含まないこと<br>-共通またはコンテキスト固有のパスワードの1つではないこと。<br> <br>共通およびコンテキスト固有のパスワードのリストは、NCSCの"トップ100kパスワード"のリスト、SecListの"トップ1Mパスワード"のリスト、およびZabbixコンテキスト固有のパスワードのリストから自動的に生成されます。内部ユーザーは、このリストに含まれるパスワードを設定することはできません。このようなパスワードは、一般的に使用されているため、脆弱であると見なされるためです。| パスワードの複雑さの要件を変更しても、既存のユーザーパスワードには影響しませんが、既存のユーザーが*管理 → ユーザー*メニューからパスワードを変更する場合、新しいパスワードは現在の要件を満たす必要があります。要件のリストを含むヒントが、[ユーザープロファイル](/manual/web_interface/user_profile)および[ユーザー構成フォーム](/manual/config/users_and_usergroups/user)の*Password*フィールドの横に表示されます。 #### Internal event actions The following conditions can be set for actions based on internal events: |Condition type|Supported operators|Description| |--|--|------| |*Event type*|equals|**Item in "not supported" state** - matches events where an item goes from a 'normal' to 'not supported' state<br>**Low-level discovery rule in "not supported" state** - matches events where a low-level discovery rule goes from a 'normal' to 'not supported' state<br>**Trigger in "unknown" state** - matches events where a trigger goes from a 'normal' to 'unknown' state| |*Host group*|equals<br>does not equal|Specify host groups or host groups to exclude.<br>**equals** - event belongs to this host group.<br>**does not equal** - event does not belong to this host group.| |*Tag name*|equals<br>does not equal<br>contains<br>does not contain|Specify event tag or event tag to exclude.<br>**equals** - event has this tag<br>**does not equal** - event does not have this tag<br>**contains** - event has a tag containing this string<br>**does not contain** - event does not have a tag containing this string| |*Tag value*|equals<br>does not equal<br>contains<br>does not contain|Specify event tag and value combination or tag and value combination to exclude.<br>**equals** - event has this tag and value<br>**does not equal** - event does not have this tag and value<br>**contains** - event has a tag and value containing these strings<br>**does not contain** - event does not have a tag and value containing these strings| |*Template*|equals<br>does not equal|Specify templates or templates to exclude.<br>**equals** - event belongs to an item/trigger/low-level discovery rule inherited from this template.<br>**does not equal** - event does not belong to an item/trigger/low-level discovery rule inherited from this template.| |*Host*|equals<br>does not equal|Specify hosts or hosts to exclude.<br>**equals** - event belongs to this host.<br>**does not equal** - event does not belong to this host.| #### 内部イベントアクション 内部イベントに基づくアクションには、次の条件を設定できます。 |タイプ|オペレータ|説明| |--|--|------| |*イベントタイプ*|等しい|**アイテムが"取得不可"の状態** - アイテムが'通常'から'サポートされていない'に移行するイベントに一致します<br>**ローレベルディスカバリが"取得不可"の状態** - ローレベルディスカバリルールが'通常'から'サポートされていない'に移行するイベントに一致します<br>**トリガーが"不明"の状態** - トリガーが'通常'から'不明'に移行するイベントに一致します| |*ホストグループ*|等しい<br>等しくない|ホスト グループまたは除外するホスト グループを指定。<br>**等しい** - イベントはこのホスト グループに属します。<br>**等しくない** - イベントはこのホスト グループに属しません。| |*タグ名*|等しい<br>等しくない<br>含む<br>含まない|イベント タグまたは除外するイベント タグを指定。<br>**等しい** - イベントにこのタグがある<br>**等しくない** - イベントにこのタグが無い<br>**含む** - イベントにこの文字列を含むタグがある<br>* *含まない** - イベントにこの文字列を含むタグがない| |*タグの値*|等しい<br>等しくない<br>含む<br>含まない|タグと値の組み合わせ、または除外するイベント タグと値の組み合わせを指定します。<br>**等しい** - イベントにこのタグと値がある<br>**等しくない** - イベントにこのタグと値がない<br >**含む** - イベントにこれらの文字列を含むタグと値がある<br>**含まない** - イベントにこれらの文字列を含むタグと値がない| |*テンプレート*|等しい<br>等しくない|テンプレートまたは除外するテンプレートを指定します。<br>**等しい** - イベントはこのテンプレートから継承されたアイテム/トリガー/ローレベルディスカバリルールに属する<br>**等しくない** - イベントはこのテンプレートから継承されたアイテム/トリガー/ローレベルディスカバリルールに属さない| |*ホスト*|等しい<br>等しくない|ホストまたは除外するホストを指定します。<br>**等しい** - イベントはこのホストに属する<br>**等しくない** - イベントはこのホストに属さない| #### Internal item for monitoring high-availability manager The `ha manager` (high-availability manager) process now can be monitored by the zabbix[process*] [internal item](/manual/config/items/itemtypes/internal#supported-checks). #### 高可用性マネージャーを監視するための内部アイテム `ha manager` (高可用性マネージャー)プロセスを、[内部アイテム](/manual/config/items/itemtypes/internal#supported-checks)zabbix[process*]で監視できるようになりました。 #### Internal queue items There are also another two items specifically allowing to remote query internal queue stats on another Zabbix instance: - `zabbix[stats,<ip>,<port>,queue,<from>,<to>]` internal item - for direct internal queue queries to remote Zabbix server/proxy - `zabbix.stats[<ip>,<port>,queue,<from>,<to>]` agent item - for agent-based internal queue queries to remote Zabbix server/proxy See also: [Internal items](/manual/config/items/itemtypes/internal), [Zabbix agent items](/manual/config/items/itemtypes/zabbix_agent) #### 内部キューアイテム 別のZabbixインスタンスで内部キュー統計をリモートクエリできるようにする別の2つの項目もあります。 - `zabbix[stats,<ip>,<port>,queue,<from>,<to>]` internal item - リモートZabbixサーバー/プロキシへの直接内部キュークエリ用 - `zabbix.stats[<ip>,<port>,queue,<from>,<to>]` agent item - リモートZabbixサーバー/プロキシへのエージェントベースの内部キュークエリ用 参考情報: [内部項目](/manual/config/items/itemtypes/internal), [Zabbixエージェントアイテム](/manual/config/items/itemtypes/zabbix_agent) In [trigger action](/manual/config/notifications/action/conditions#trigger-actions) configuration, the condition type *Trigger name* has been renamed *Event name* to better describe its function. Note that by default, the event name matches the trigger name unless a custom event name is specified in [trigger configuration](/manual/config/triggers/trigger). [トリガーアクション](/manual/config/notifications/action/conditions#trigger-actions)設定画面の*トリガー名*という条件タイプをその機能をよりよく表現するために*イベント名*に改名しました。 [トリガーの設定](/manual/config/triggers/trigger)でカスタムイベント名が設定されていない限り、デフォルトではイベント名とトリガー名は一致することに注意してください。 #### Introduction MIB stands for a Management Information Base. MIB files allow you to use textual representation of the OID (Object Identifier). For example, ifHCOutOctets is textual representation of OID 1.3.6.1.2.1.31.1.1.1.10 You can use either, when monitoring SNMP devices with Zabbix, but if you feel more comfortable when using textual representation you have to install MIB files. #### はじめに MIBとは、Management Information Base（管理情報ベース）の略です。<br> MIBファイルにより、OID（オブジェクト識別子）をテキストで表現したものです。<br> 例えば ifHCOutOctets が OID のテキスト表現である場合 1.3.6.1.2.1.31.1.1.1.10 ZabbixでSNMPデバイスを監視する場合、どちらを使っても構いません。 テキスト表現の方が使いやすいと感じる場合は、MIBファイルをインストールする必要があります。 Introduction of loadable plugins caused the following configuration parameter changes: - *Plugins.\<PluginName>.Path* parameter has been moved to *Plugins.\<PluginName>.System.Path*. - *Plugins.\<PluginName>.Capacity* parameter, while still supported, has been deprecated, please use *Plugins.\<PluginName>.System.Capacity* instead. ロード可能な外部プラグインの導入に伴い、以下の設定パラメータを変更しました： - *Plugins.\<PluginName>.Path* パラメーターは *Plugins.\<PluginName>.System.Path* へ移動しました。 - *Plugins.\<PluginName>.Capacity* パラメーターは、まだサポートされていますが、非推奨となりました。代わりに*Plugins.\<PluginName>.System.Capacity* をご使用ください。 #### Invalid regular expression in proc.* items **proc.\*** agent items will now become 'not supported' if an invalid regular expression is supplied. #### proc.*アイテムの無効な正規表現 無効な正規表現が指定された場合、**proc.\***エージェントアイテムは'サポートされません'になります。 #### Invalid regular expressions after switching to PCRE2 In Zabbix 6.0 support for PCRE2 has been added. Even though PCRE is still supported, Zabbix installation packages for RHEL 7 and newer, SLES (all versions), Debian 9 and newer, Ubuntu 16.04 and newer have been updated to use PCRE2. While providing many benefits, switching to PCRE2 may cause certain existing PCRE regexp patterns becoming invalid or behaving differently. In particular, this affects the pattern *\^[\\w-\\.]*. In order to make this regexp valid again without affecting semantics, change the expression to *\^[-\\w\\.]* . This happens due to the fact that PCRE2 treats the dash sign as a delimiter, creating a range inside a character class. The following Zabbix installation packages have been updated and now use PCRE2: RHEL 7 and newer, SLES (all versions), Debian 9 and newer, Ubuntu 16.04 and newer. #### PCRE2への移行後の無効な正規表現 Zabbix 6.0では、PCRE2のサポートが追加されました。 PCREは現在もサポートされていますが、RHEL 7以降、SLES (全バージョン)、Debian 9以降、Ubuntu 16.04以降のZabbixインストールパッケージは、PCRE2を使用するように更新されました。 PCRE2への切り替えは多くの利点を提供する一方で、特定の既存のPCRE Regexpパターンが無効になったり、異なる動作をしたりする可能性があります。 特に、パターン*\^[\\w-\\.]*に影響します。 このregexpをセマンティクスに影響することなく再度有効にするために、式を*\^[-\\w\\.]*に変更します。 これは、PCRE2がダッシュ記号を区切り文字として扱い、文字クラス内に範囲を作成するために発生します。 次のZabbixインストールパッケージが更新されており、PCRE2を使用しています: RHEL 7以降、SLES (全バージョン)、Debian 9以降、Ubuntu 16.04以降。 #### Invalid regular expressions after switching to PCRE2 In Zabbix 6.0 support for PCRE2 has been added. Even though PCRE is still supported, Zabbix installation packages for RHEL/CentOS 7 and newer, SLES (all versions), Debian 9 and newer, Ubuntu 16.04 and newer have been updated to use PCRE2. While providing many benefits, switching to PCRE2 may cause certain existing PCRE regexp patterns becoming invalid or behaving differently. In particular, this affects the pattern *^[\w-\.]*. In order to make this regexp valid again without affecting semantics, change the expression to *^[-\w\.]* . This happens due to the fact that PCRE2 treats the dash sign as a delimiter, creating a range inside a character class. The following Zabbix installation packages have been updated and now use PCRE2: #### Invalid regular expressions after switching to PCRE2 In Zabbix 6.0 support for PCRE2 has been added. Even though PCRE is still supported, all Zabbix installation packages have been updated to use PCRE2. While providing many benefits, switching to PCRE2 may cause certain existing PCRE regexp patterns becoming invalid or behaving differently. In particular, this affects the pattern *^[\w-\.]*. In order to make this regexp valid again without affecting semantics, change the expression to *^[-\w\.]* . This happens due to the fact that PCRE2 treats the dash sign as a delimiter, creating a range inside a character class. #### Inventory macros There are host inventory macros {INVENTORY.\*} available for use in notifications, for example: "Server in {INVENTORY.LOCATION1} has a problem, responsible person is {INVENTORY.CONTACT1}, phone number {INVENTORY.POC.PRIMARY.PHONE.A1}." For more details, see the [Supported macros](/manual/appendix/macros/supported_by_location) page. #### インベントリマクロ 通知用にホストインベントリマクロ{INVENTORY.\}が用意されています。例えば、 "{INVENTORY.LOCATION1}のサーバーに障害が発生しました。 責任者は{INVENTORY.CONTACT1}、電話番号は{INVENTORY.POC.PRIMARY.PHONE.A1}。" 詳細は、[サポートしているマクロ](/manual/appendix/macros/supported_by_location)ページをご覧ください。 ##### Inventory mode selection Inventory mode can be selected in the host configuration form. Inventory mode by default for new hosts is selected based on the *Default host inventory mode* setting in *Administration* → *General* → *[Other](/manual/web_interface/frontend_sections/administration/general#other_parameters)*. For hosts added by network discovery or autoregistration actions, it is possible to define a *Set host inventory mode* operation selecting manual or automatic mode. This operation overrides the *Default host inventory mode* setting. ##### インベントリモードの選択 インベントリモードは、ホスト設定フォームで選択することができます。 新しいホストのデフォルトのインベントリモードは、*管理* → *一般設定* → *[その他](/manual/web_interface/frontend_sections/administration/general#その他の設定パラメータ)*の*デフォルトのホストインベントリモード*設定に基づいて選択されます。 ネットワークディスカバリまたは自動登録アクションによって追加されたホストの場合、*ホストインベントリモードの設定*操作で手動モードまたは自動モードを選択できます。この操作は*デフォルトのホストインベントリモード*設定を上書きします。 #### Inventory overview The details of all existing inventory data are available in the *Inventory* menu. In *Inventory → Overview* you can get a host count by various fields of the inventory. In *Inventory → Hosts* you can see all hosts that have inventory information. Clicking on the host name will reveal the inventory details in a form. {width="600"} The **Overview** tab shows: |Parameter|Description| |--|--------| |*Host name*|Name of the host.<br>Clicking on the name opens a menu with the scripts defined for the host.<br>Host name is displayed with an orange icon, if the host is in maintenance.| |*Visible name*|Visible name of the host (if defined).| |*Host (Agent, SNMP, JMX, IPMI)<br>interfaces*|This block provides details of the interfaces configured for the host.| |*OS*|Operating system inventory field of the host (if defined).| |*Hardware*|Host hardware inventory field (if defined).| |*Software*|Host software inventory field (if defined).| |*Description*|Host description.| |*Monitoring*|Links to monitoring sections with data for this host: *Web*, *Latest data*, *Problems*, *Graphs*, *Dashboards*.| |*Configuration*|Links to configuration sections for this host: *Host*, *Items*, *Triggers*, *Graphs*, *Discovery*, *Web*.<br>The number of configured entities is listed after each link.| The **Details** tab shows all inventory fields that are populated (are not empty). #### インベントリ概要 既存のすべてのインベントリデータの詳細は、*インベントリ*メニューに表示されます。 *インベントリ → 概要*で、インベントリの様々なフィールドによるホスト数を取得できます。 *インベントリ → ホスト*で、インベントリ情報を持つすべてのホストを見ることができます。ホスト名をクリックすると、インベントリの詳細が表示されます。 {width="600"} **概要**タブは以下を表示します。 |パラメーター|説明| |--|--------| |*ホスト名*|ホストの名前。<br>名前をクリックすると、ホストに定義されているスクリプトを含むメニューが開きます。<br>ホストがメンテナンス中の場合、ホスト名はオレンジ色のアイコンとともに表示されます。| |*表示名*|ホストの表示名(定義されている場合)。| |*ホスト(エージェント、SNMP、JMX、IPMI)<br>インターフェース*|ホストに設定されたインターフェースの詳細を提供します。| |*OS*|ホストのオペレーティングシステムのインベントリフィールド(定義されている場合)。| |*ハードウェア*|ホストのハードウェアのインベントリフィールド(定義されている場合)。| |*ソフトウェア*|ホストのソフトウェアのインベントリフィールド(定義されている場合)。| |*説明*|ホストの説明。| |*監視データ*|このホストのデータを含む監視セクションへのリンク: *Web*、*最新データ*、*障害*、*グラフ*、*ダッシュボード*。| |*設定*|このホストの設定セクションへのリンク: *ホスト*、*アイテム*、*トリガー*、*グラフ*、*ディスカバリ*、*Web*<br>設定されたエンティティの数は、各リンクの後に表示されます。| **詳細**タブには、入力されている(空ではない)すべてのインベントリフィールドが表示されます。 #### IPMI checks IPMI checks will not work with the standard OpenIPMI library package on Debian prior to 9 (stretch) and Ubuntu prior to 16.04 (xenial). To fix that, recompile OpenIPMI library with OpenSSL enabled as discussed in [ZBX-6139](https://support.zabbix.com/browse/ZBX-6139). #### IPMIチェック Debian 9 (stretch)以前、およびUbuntu 16.04 (xenial)以前のバージョンでは、標準のOpenIPMIライブラリパッケージではIPMI チェックが動作しません。 この問題を修正するには、[ZBX-6139](https://support.zabbix.com/browse/ZBX-6139)の説明に従ってOpenSSLを有効にし、OpenIPMIライブラリを再コンパイルしてください。 #### IPMI remote commands For IPMI remote commands the following syntax should be used: <command> [<value>] where - <command> - one of IPMI commands without spaces - <value> - 'on', 'off' or any unsigned integer. <value> is an optional parameter. #### IPMI リモートコマンド IPMI リモート コマンドの場合、次の構文を使用する必要があります。 <command> [<value>] 内容 - <command> - スペースなしの 1 つのIPMI コマンド - <value> - 'on', 'off'または任意の符号なし整数。 <value> はオプションパラメーターです。 #### IPv6 address issue in SNMPv3 traps Due to a net-snmp bug, IPv6 address may not be correctly displayed when using SNMPv3 in SNMP traps. For more details and a possible workaround, see [ZBX-14541](https://support.zabbix.com/browse/ZBX-14541). #### SNMPv3トラップにおけるIPv6アドレスの問題 net-snmpのバグにより、SNMPトラップでSNMPv3を使用すると、IPv6アドレスが正しく表示されない場合があります。詳細と回避策については、[ZBX-14541](https://support.zabbix.com/browse/ZBX-14541)を参照してください。 #### Issues in Zabbix 6.0.11 ##### JSONPath parsing errors JSONPath parsing errors occur in case of leading whitespace and empty array/object. Fixed in Zabbix 6.0.12. ##### 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. #### Zabbix 6.0.11の問題 ##### JSONPath解析エラー 先頭に空白がある場合や配列/オブジェクトが空の場合、JSONPath解析エラーが発生します。Zabbix 6.0.12で修正されました。 ##### LLDフィルターでのAND/OR評価 このバージョンでは、低レベル検出フィルター/オーバーライドでのAND/OR式の評価が失敗する場合があります。Zabbix 6.0.12で修正されました。 #### Item changes Native support for the [items](/manual/config/items/itemtypes/zabbix_agent) **net.dns** and **net.dns.record** has been added to Zabbix agent 2. On Zabbix agent 2 for Windows, these items now allow custom DNS IP addresses in the `ip` parameter and no longer ignore `timeout` and `count` parameters. #### アイテムの変更 Zabbixエージェント2に[アイテム](/manual/config/items/itemtypes/zabbix_agent)**net.dns**と**net.dns.record**のネイティブサポートが追加されました。Windows版Zabbixエージェント2では、これらのアイテムは`ip`パラメーターでカスタムDNS IPアドレスを使用できるようになり、`timeout`と`count`パラメータを無視しないようになりました。 ##### Item configuration Actual command(s) to be executed must be placed in the **Executed script** field in the item configuration. Multiple commands can be executed one after another by placing them on a new line. In this case returned values also will be formatted as multilined.  All mandatory input fields are marked with a red asterisk. The fields that require specific information for SSH items are: |Parameter|Description|Comments| |--|------|------| |*Type*|Select **SSH agent** here.| | |*Key*|Unique (per host) item key in format **ssh.run\[<unique short description>,<ip>,<port>,<encoding>\]**|<unique short description> is required and should be unique for all SSH items per host<br>Default port is 22, not the port specified in the interface to which this item is assigned| |*Authentication method*|One of the "Password" or "Public key"| | |*User name*|User name to authenticate on remote host.<br>Required| | |*Public key file*|File name of public key if *Authentication method* is "Public key". Required|Example: *id\_rsa.pub* - default public key file name generated by a command [ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen)| |*Private key file*|File name of private key if *Authentication method* is "Public key". Required|Example: *id\_rsa* - default private key file name| |*Password* or<br>*Key passphrase*|Password to authenticate or<br>Passphrase **if** it was used for the private key|Leave the *Key passphrase* field empty if passphrase was not used<br>See also [known issues](/manual/installation/known_issues#ssh_checks) regarding passphrase usage| |*Executed script*|Executed shell command(s) using SSH remote session|Examples:<br>*date +%s*<br>*service mysql-server status*<br>*ps auxww \| grep httpd \| wc -l*| ::: noteimportant libssh2 library may truncate executable scripts to \~32kB. ::: ##### アイテム設定 実行する実際のコマンドは、アイテム設定の **実行するスクリプト** フィールドに記載する必要があります。 複数のコマンドを実行するには、複数行にコマンドを記載することで実行できます。 この場合、返される値も複数行としてフォーマットされます。  すべての必須入力フィールドには赤いアスタリスクが付いています。 SSH アイテムの特定の情報を必要とするフィールドは次のとおりです。 |パラメータ|説明|コメント| |--|------|------| |*タイプ*|**SSHエージェント**を選択| | |*キー*| (ホストごとに) 一意なアイテム キーフォーマット **ssh.run\[<unique short description>,<ip>,<port>,<encoding>\]**|<unique short description> は必須であり、ホストごとにすべての SSH アイテムに対して一意である必要があります<br>デフォルト ポートは 22 であり、このアイテムが割り当てられているインターフェイスで指定されたポートではありません| |*認証方法*|"パスワード"または"公開鍵"のいずれか| | |*ユーザー名*|リモート ホストで認証するユーザー名<br>必須| | |*公開鍵ファイル*|*認証方式*が"公開鍵"の場合の公開鍵ファイル名。必須|例: *id\_rsa.pub* - [ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen)コマンドによって生成されるデフォルトの公開鍵ファイル名| |*秘密鍵ファイル*|*認証方式*が"公開鍵"の場合の秘密鍵ファイル名。 必須|例: *id\_rsa* - デフォルトの秘密鍵ファイル名| |*パスワード* |認証するためのパスワードまたはパスフレーズ **秘密鍵に使用された場合**|パスフレーズが使用されていない場合は、*パスワード*フィールドを空にします<br>パスフレーズの使用については[既知の問題](/manual/installation/known_issues#ssh_checks)も参照してください| |*実行するスクリプト*|SSH リモート セッションを使用してシェル コマンドを実行します|例:<br>*date +%s*<br>*service mysql-server status*<br>*ps auxww \| grep httpd \| wc -l*| ::: noteimportant libssh2 ライブラリは、実行可能スクリプトを ~32kB に切り詰める場合があります。 ::: #### Item configuration A dependent item depends on its master item for data. That is why the **master item** must be configured (or exist) first: - Go to: *Configuration* → *Hosts* - Click on *Items* in the row of the host - Click on *Create item* - Enter parameters of the item in the form  All mandatory input fields are marked with a red asterisk. Click on *Add* to save the master item. Then you can configure a **dependent item**.  All mandatory input fields are marked with a red asterisk. The fields that require specific information for dependent items are: | | | |--|--------| |*Type*|Select **Dependent item** here.| |*Key*|Enter a key that will be used to recognize the item.| |*Master item*|Select the master item. Master item value will be used to populate dependent item value.| |*Type of information*|Select the type of information that will correspond the format of data that will be stored.| You may use item value [preprocessing](/manual/config/items/item#item_value_preprocessing) to extract the required part of the master item value. {width="600"} Without preprocessing, the dependent item value will be exactly the same as the master item value. Click on *Add* to save the dependent item. A shortcut to creating a dependent item quicker can be accessed by clicking on the  button in the item list and selecting *Create dependent item*.  #### アイテムの設定 依存アイテムは、データのためにマスターアイテムに依存します。そのため、**マスターアイテム**を最初に設定する（存在させる）必要があります。 - *設定* → *ホスト* にアクセスします。 - ホストの行にある、*アイテム* をクリックします。 - *アイテムの作成* をクリックします。 - アイテムのパラメータをフォームに入力します。  必須入力項目には、赤いアスタリスクが表示されています。 *追加*をクリックして、マスターアイテムを保存します。 次に、**依存アイテム**を設定することができます。  必須入力項目には、赤いアスタリスクが表示されています。 依存アイテムに対して特定の情報を必要とするフィールドは、以下のとおりです。 | | | |---|---| |*タイプ*|ここでは**依存アイテム**を選択します。| |*キー*|アイテムを認識するために使用するキーを入力します。| |*マスターアイテム*|マスターアイテムを選択します。マスターアイテムの値は、依存アイテムの値を設定するために使用されます。| |*データ型*|保存するデータの型に合わせてデータ型を選択します。| アイテムの値の[保存前処理](/manual/config/items/item#item_value_preprocessing)の機能を使用してマスターアイテムの値の必要な部分のみ抽出できます。 {width="600"} 保存前処理を行わない場合、依存アイテムの値はマスターアイテムの値とまったく同じになります。 *追加*をクリックして、依存アイテムを保存します。 依存アイテムのクイック作成への手早く行う為には、アイテムのリストのボタンをクリックし**依存アイテムの作成**を選択します。  ##### Item configuration To configure a trapper item: - Go to: *Configuration* → *Hosts* - Click on *Items* in the row of the host - Click on *Create item* - Enter parameters of the item in the form  All mandatory input fields are marked with a red asterisk. The fields that require specific information for trapper items are: | | | |--|--------| |*Type*|Select **Zabbix trapper** here.| |*Key*|Enter a key that will be used to recognize the item when sending in data.| |*Type of information*|Select the type of information that will correspond the format of data that will be sent in.| |*Allowed hosts*|List of comma delimited IP addresses, optionally in CIDR notation, or DNS names.<br>If specified, incoming connections will be accepted only from the hosts listed here.<br>If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' are treated equally and '::/0' will allow any IPv4 or IPv6 address.<br>'0.0.0.0/0' can be used to allow any IPv4 address.<br>Note that "IPv4-compatible IPv6 addresses" (0000::/96 prefix) are supported but deprecated by [RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5).<br>Example: 127.0.0.1, 192.168.1.0/24, 192.168.3.1-255, 192.168.1-10.1-255, ::1,2001:db8::/32, mysqlserver1, zabbix.example.com, {HOST.HOST}<br>Spaces and [user macros](/manual/config/macros/user_macros) are allowed in this field since Zabbix 2.2.0.<br>Host macros {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN} are allowed in this field since Zabbix 4.0.2.| ::: noteclassic You may have to wait up to 60 seconds after saving the item until the server picks up the changes from a configuration cache update, before you can send in values. ::: ##### アイテム設定 トラッパーアイテム を設定するには: - *設定* → *ホスト* にアクセスします。 - ホストの行の *アイテム* をクリックします。 - *アイテムの作成* をクリックします。 - アイテムのパラメータをフォームに入力します。  すべての必須入力項目には赤いアスタリスクが付けられています。 トラッパーアイテム で特定の情報を必要とするフィールドは、次のとおりです。 | | | |--|--------| |*タイプ*|**Zabbix トラッパー** を選択します| |*キー*|データ送信時にアイテムを認識するためのキーを入力します| |*データ型*|送信されるデータの形式に対応するデータ型を選択します| |*許可されたホスト*|コンマ区切りの IP アドレスのリスト。オプションで CIDR 表記またはホスト名を使用します。<br>指定すると、ここにリストされているホストからの着信接続のみが受け入れられます。<br>IPv6 サポートが有効になっている場合は、'127.0.0.1', ': :127.0.0.1'、'::ffff:127.0.0.1' は同等に扱われ、'::/0' は任意の IPv4 または IPv6 アドレスを許可します。<br>'0.0.0.0/0'を使用して任意の IPv4 アドレスを許可できます。<br>"IPv4 互換の IPv6 アドレス"(0000::/96 プレフィックス) はサポートされていますが、[RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5) によって非推奨になっていることに注意してください。 .<br>例: Server=127.0.0.1, 192.168.1.0/24, 192.168.3.1-255, 192.168.1-10.1-255, ::1,2001:db8::/32, zabbix.domain<br> Zabbix 2.2.0 以降、このフィールドではスペースと [ユーザー マクロ](/manual/config/macros/user_macros) を使用できます。<br>ホスト マクロ: {HOST.HOST}、{HOST.NAME}、{HOST.IP} 、{HOST.DNS}、{HOST.CONN} は、Zabbix 4.0.2 以降、このフィールドで許可されています。| ::: noteclassic アイテムを保存した後、値を送信する前に サーバー がコンフィギュレーションキャッシュの更新から変更を拾うまで、最大60秒待つ必要がある場合があります。 ::: ##### Item configuration When [configuring an item](/manual/config/items/item) on a host level: - Select 'IPMI agent' as the *Type* - Enter an item [key](/manual/config/items/item/key) that is unique within the host (say, ipmi.fan.rpm) - For *Host interface* select the relevant IPMI interface (IP and port). Note that an IPMI interface must exist on the host. - Specify the *IPMI sensor* (for example 'FAN MOD 1A RPM' on Dell Poweredge) to retrieve the metric from. By default, the sensor ID should be specified. It is also possible to use prefixes before the value: - `id:` - to specify sensor ID; - `name:` - to specify sensor full name. This can be useful in situations when sensors can only be distinguished by specifying the full name. - Select the respective type of information ('Numeric (float)' in this case; for discrete sensors - 'Numeric (unsigned)'), units (most likely 'rpm') and any other required item attributes ##### item の設定 ホストレベルで[configuring an item](/manual/config/items/item)を行う場合: - *Type*として 'IPMIエージェント' を選択します。 - ホスト内で一意である item [key](/manual/config/items/item/key) (例えば、ipmi.fan.rpm)を入力します。 - *Host interface* には、関連するIPMIインターフェース(IPアドレスおよびポート番号)を選択します。 IPMIインターフェースはホスト上に存在する必要があることに注意してください。 - IPMI センサー* (Dell Poweredge の 'FAN MOD 1A RPM' など) からメトリックを取得するように指定します。 デフォルトでは、センサー IDを指定する必要があります。接頭辞を使用することも可能です。 - `id:` - センサーの ID を指定します。 - `name:` - センサーのフルネームを指定します。 これは、フルネームを指定することによってのみセンサを区別できる場合に役立ちます。 - それぞれの情報の種類を選択します(この場合は、'Numeric (float)' ディスクリートセンサーの場合は'Numeric (unsigned)'）、単位（多くの場合'rpm'）、およびその他の必要な項目属性を選択します。 # item.create # item.create # item.delete # item.delete ##### Item filter syntax The item filter: /host/key[parameters]?[conditions] consists of four parts, where: * host - host name * key - item key (without parameters) * parameters - item key parameters * conditions - host group and/or item tag based conditions (as expression) Spaces are allowed only inside the conditions expression. **Wildcard usage** * Wildcard can be used to replace the host name, item key or an individual item key parameter. * Either the host or item key must be specified without wildcard. So `/host/*` and `/*/key` are valid filters, but `/*/*` is invalid. * Wildcard cannot be used for a *part* of host name, item key, item key parameter. * Wildcard does not match more than a single item key parameter. So a wildcard must be specified for each parameter in separation (i.e. `key[abc,*,*]`). **Conditions expression** The conditions expression supports: * operands: * group - host group * tag - item tag * `"<text>"` - string constant, with the `\` escape character to escape `"` and `\` * case-sensitive string comparison operators: `=`, `<>` * logical operators: `and`, `or`, `not` * grouping with parentheses: `(` `)` Quotation of string constants is mandatory. Only case-sensitive full string comparison is supported. :::notewarning When specifying tags in the filter (i.e. `tag="tagname:value"`), the colon ":" is used as a delimiter. Everything after it is considered the tag value. Thus it is currently not supported to specify a tag name containing ":" in it. ::: **Examples** A complex filter may be used, referencing the item key, host group and tags, as illustrated by the examples: |Syntax example|Description| |--|--| |`/host/key[abc,*]`|Matches similar items on this host.| |`/*/key`|Matches the same item of any host.| |`/*/key?[group="ABC" and tag="tagname:value"]`|Matches the same item of any host from the ABC group having 'tagname:value' tags.| |`/*/key[a,*,c]?[(group="ABC" and tag="Tag1") or (group="DEF" and (tag="Tag2" or tag="Tag3:value"))]`|Matches similar items of any host from the ABC or DEF group with the respective tags.| All referenced items must exist and collect data. Only enabled items on enabled hosts are included in the calculations. ::: noteimportant If the item key of a referenced item is changed, the filter must be updated manually. ::: Specifying a parent host group includes the parent group and all nested host groups with their items. ##### アイテムフィルター構文 アイテムフィルター: /host/key[parameters]?[conditions] 4 つの部分から構成されます: * host - ホスト名 * key - アイテムキー(パラメータなし) * parameters - アイテムキーのパラメータ * conditions - ホストグループおよび/またはアイテムタグに基づく条件(式として) スペースは条件式内でのみ許可されます。 **ワイルドカードの使用** * ワイルドカードは、ホスト名、アイテムキー、または個々のアイテムキーパラメータを置き換えるために使用できます。 * ホストまたはアイテムキーのいずれかをワイルドカードなしで指定する必要があります。したがって、`/host/*` および `/*/key` は有効なフィルタですが、`/*/*` は無効です。 * ワイルドカードは、ホスト名、アイテムキー、アイテムキーパラメータの *一部* には使用できません。 * ワイルドカードは、1 つ以上のアイテムキーパラメータと一致しません。したがって、ワイルドカードはパラメータごとに分離して指定する必要があります (つまり、`key[abc,*,*]`)。 **条件式** 条件式は以下をサポートします: * 引数: * group - ホストグループ * tag - iアイテムタグ * `"<text>"` - string constant, with the `\` escape character to escape `"` and `\` * 大文字と小文字を区別する文字列比較演算子: `=`、`<>` * 論理演算子: `and`、`or`、`not` * 括弧によるグループ化: `(` `)` 文字列定数の引用符は必須です。大文字と小文字を区別した完全な文字列比較のみがサポートされています。 :::notewarning フィルターでタグを指定する場合 (つまり、`tag="tagname:value"`)、コロン ":" が区切り文字として使用されます。 それ以降のすべてがタグ値とみなされます。したがって、現在、":" を含むタグ名の指定はサポートされていません。 ::: **例** 次の例に示すように、アイテム キー、ホスト グループ、タグを参照する複雑なフィルターを使用することもできます: |構文例|説明| |--|--| |`/host/key[abc,*]`|指定されたホストの指定されたアイテムキー、アイテムキーのパラメータと一致します。| |`/*/key`|任意のホストの同じアイテムキーと一致します。| |`/*/key?[group="ABC" and tag="tagname:value"]`|'tagname:value'タグを持つABCグループの任意のホストの指定されたアイテムキーと一致します。| |`/*/key[a,*,c]?[(group="ABC" and tag="Tag1") or (group="DEF" and (tag="Tag2" or tag="Tag3:value"))]`|ABCまたはDEFグループのそれぞれ指定されたタグを持つ任意のホストの指定されたアイテムキーと一致させます。| 参照されるすべてのアイテムが存在しデータが収集されている必要があります。有効なホスト上の有効なアイテムのみが計算に含まれます。 ::: noteimportant 参照されるアイテムのアイテムキーが変更された場合、フィルターを修正する必要があります。 ::: 親ホストグループを指定すると、親グループと、そのアイテムを含むすべてのネストされたホスト グループが含まれます。 # item.get # item.get #### Item key In [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) configuration, select **JMX agent** in the *Type* field. Two item keys are supported for JMX object discovery - jmx.discovery\[\] and jmx.get\[\]: |**Item key**|<|<|<| |-|--------|--------|----------| |<|Return value|Parameters|Comment| |**jmx.discovery**\[<discovery mode>,<object name>,<unique short description>\]|<|<|<| |<|This item returns a JSON array with LLD macros describing MBean objects or their attributes.|**discovery mode** - one of the following: *attributes* (retrieve JMX MBean attributes, default) or *beans* (retrieve JMX MBeans)<br>**object name** - object name pattern (see [documentation](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)) identifying the MBean names to be retrieved (empty by default, retrieving all registered beans)<br>**unique short description** - a unique description that allows multiple JMX items with the same discovery mode and object name on the host (optional)|Examples:<br>→ jmx.discovery - retrieve all JMX MBean attributes<br>→ jmx.discovery\[beans\] - retrieve all JMX MBeans<br>→ jmx.discovery\[attributes,"\*:type=GarbageCollector,name=\*"\] - retrieve all garbage collector attributes<br>→ jmx.discovery\[beans,"\*:type=GarbageCollector,name=\*"\] - retrieve all garbage collectors<br><br>There are some [limitations](#limitations) to what MBean properties this item can return based on limited characters that are supported in macro name generation (supported characters can be described by the following regular expression: `A-Z0-9_\.`). So, for example, to discover MBean properties with a hyphenated word or non-ASCII characters, you need to use `jmx.get[]`.<br><br>Supported since Zabbix Java gateway 3.4.| |**jmx.get**\[<discovery mode>,<object name>,<unique short description>\]|<|<|<| |<|This item returns a JSON array with MBean objects or their attributes.<br><br>Compared to `jmx.discovery[]` it does not define LLD macros.|**discovery mode** - one of the following: *attributes* (retrieve JMX MBean attributes, default) or *beans* (retrieve JMX MBeans)<br>**object name** - object name pattern (see [documentation](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)) identifying the MBean names to be retrieved (empty by default, retrieving all registered beans)<br>**unique short description** - a unique description that allows multiple JMX items with the same discovery mode and object name on the host (optional)|When using this item, it is needed to define custom low-level discovery macros, pointing to values extracted from the returned JSON using JSONPath.<br><br>Supported since Zabbix Java gateway 4.4.| ::: noteimportant If no parameters are passed, all MBean attributes from JMX are requested. Not specifying parameters for JMX discovery or trying to receive all attributes for a wide range like `*:type=*,name=*` may lead to potential performance problems. ::: #### アイテムキー [ディスカバリルール](/manual/discovery/low_level_discovery#discovery_rule) 設定の*タイプ* フィールドで **JMX エージェント** を選択します。 JMX オブジェクトの検出では、jmx.discovery\[\] と jmx.get\[\] の 2 つのアイテム キーがサポートされています。 |**アイテムキー**|<|<|<| |-|--------|--------|----------| |<|戻り値|パラメータ|コメント| |**jmx.discovery**\[<discovery mode>,<object name>,<unique short description>\]|<|<|<| |<|この項目は、MBean オブジェクトまたはその属性を記述する LLD マクロを含む JSON 配列を返します。|**discovery mode** - 次のいずれか: *attributes* (JMX MBean 属性の取得、デフォルト) or *beans* (JMX MBean を取得)<br>**object name** - 取得する MBean 名を識別するオブジェクト名パターン ([ドキュメント](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html) を参照) (デフォルトでは空で、登録されているすべての Bean を取得します)<br>**unique short description** - ホスト上で同じ検出モードとオブジェクト名を持つ複数の JMX アイテムを許可する一意の説明 (オプション)|例:<br>→ jmx.discovery - すべての JMX MBean 属性を取得する<br>→ jmx.discovery\[beans\] - すべての JMX MBean を取得する<br>→ jmx.discovery\[attributes,"\*:type=GarbageCollector,name=\*"\] - すべてのガベージ コレクター属性を取得する<br>→ jmx.discovery\[beans,"\*:type=GarbageCollector,name=\*"\] - すべてのガベージ コレクターを取得する<br><br>マクロ名の生成でサポートされている制限された文字に基づいて、このアイテムが返すことができる MBean プロパティにはいくつかの[制限](#制限)があります (サポートされている文字は、次の正規表現で記述できます: `A-Z0-9_\.` ）。 したがって、たとえば、ハイフンでつながれた単語や非 ASCII 文字を含む MBean プロパティを検出するには、`jmx.get[]` を使用する必要があります。<br><br>Zabbix Java ゲートウェイ 3.4 以降でサポートされています。| |**jmx.get**\[<discovery mode>,<object name>,<unique short description>\]|<|<|<| |<|この項目は、MBean オブジェクトまたはその属性を含む JSON 配列を返します。<br><br>`jmx.discovery[]` との違いはLLD マクロを定義しないことです。|**discovery mode** - 次のいずれか: *attributes* (JMX MBean 属性を取得、デフォルト) または *beans* (JMX MBean を取得)<br>**object name** - 取得する MBean 名を識別するオブジェクト名パターン ([ドキュメント](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html) を参照) (デフォルトでは空で、登録されているすべての Bean を取得します)<br>**unique short description** - ホスト上で同じ検出モードとオブジェクト名を持つ複数の JMX アイテムを許可する一意の説明 (オプション) |このアイテムを使用する場合、JSONPath を使用して返された JSON から抽出された値を指す、カスタムの低レベル検出マクロを定義する必要があります。 .<br><br>Zabbix Java ゲートウェイ 4.4 以降でサポートされています。| ::: noteimportant パラメータが渡されない場合、JMX からのすべての MBean 属性が要求されます。 JMX ディスカバリー用のパラメーターを指定しない、または `*:type=*,name=*` のように広範囲のすべての属性を取得しようとすると、パフォーマンスの問題が発生する可能性があります。 ::: #### Item key SQL queries are performed using a "Database monitor" item type. Therefore, most of the instructions on [ODBC monitoring](/manual/config/items/itemtypes/odbc_checks) page apply in order to get a working "Database monitor" discovery rule. Two item keys may be used in "Database monitor" discovery rules: - **db.odbc.discovery**\[<unique short description>,<dsn>,<connection string>\] - this item transforms the SQL query result into a JSON array, turning the column names from the query result into low-level discovery macro names paired with the discovered field values. These macros can be used in creating item, trigger, etc prototypes. See also: [Using db.odbc.discovery](#using_dbodbcdiscovery). ```{=html} <!-- --> ``` - **db.odbc.get**\[<unique short description>,<dsn>,<connection string>\] - this item transforms the SQL query result into a JSON array, keeping the original column names from the query result as a field name in JSON paired with the discovered values. Compared to `db.odbc.discovery[]`, this item does not create low-level discovery macros in the returned JSON, therefore there is no need to check if the column names can be valid macro names. The low-level discovery macros can be defined as an additional step as required, using the [custom LLD macro](/manual/discovery/low_level_discovery#custom_macros) functionality with JSONPath pointing to the discovered values in the returned JSON. See also: [Using db.odbc.get](#using_dbodbcget). #### アイテムキー SQLクエリは"データベースモニター"アイテムタイプを使用して実行されます。 したがって[ODBC監視](/manual/config/items/itemtypes/odbc_checks)ページのほとんどの手順は、機能する"データベースモニター"ディスカバリルールを取得するために適用されます。 "データベースモニター"ディスカバリルールでは、次の2つのアイテムキーを使用できます。 - **db.odbc.discovery**\[<unique short description>,<dsn>,<connection string>\] - このアイテムは、SQLクエリ結果をJSON配列に変換し、クエリ結果の列名を検出されたフィールド値とペアになったローレベルディスカバリマクロ名に変換します。 これらのマクロは、アイテム、トリガーなどのプロトタイプの作成に使用できます。 参照: [db.odbc.discoveryの使用](#using_dbodbcdiscovery)。 ```{=html} <!-- --> ``` - **db.odbc.get**\[<unique short description>,<dsn>,<connection string>\] - このアイテムは、SQLクエリ結果をJSON配列に変換し、クエリ結果の元の列名を、検出された値とペアになったJSONのフィールド名として保持します。`db.odbc.discovery[]`と比較すると、このアイテムは返されたJSONにローレベルディスカバリマクロを作成しないため、列名が有効なマクロ名であるかどうかを確認する必要はありません。 ローレベルディスカバリマクロは、必要に応じて追加のステップとして定義できます。[カスタムLLDマクロ](/manual/discovery/low_level_discovery#custom_macros)機能を使用して、返されるJSONで検出された値を指すJSONPathを使用します。参照: [using db.odbc.getの使用](#using_dbodbcget)。 #### Item keys The table provides details on the item keys that you can use with Zabbix agent 2 only. See also: [Plugins supplied out-of-the-box](/manual/config/items/plugins#plugins_supplied_out-of-the-box) ::: noteclassic Parameters without angle brackets are mandatory. Parameters marked with angle brackets **<** **>** are optional. ::: |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.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |ceph.osd.stats \[connString, <user>, <apikey>\]|<|<|<|<| |<|Aggregated and per OSD statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |ceph.osd.discovery \[connString, <user>, <apikey>\]|<|<|<|<| |<|List of discovered OSDs. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |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.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |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>1 - connection is successful.|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |ceph.pool.discovery \[connString, <user>, <apikey>\]|<|<|<|<| |<|List of discovered pools. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |ceph.status \[connString, <user>, <apikey>\]|<|<|<|<| |<|Overall cluster's status.|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |docker.container\_info \[<ID>\]|<|<|<|<| |<|Low-level information about a container.|An output of the [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) API call serialized as JSON|**ID** - ID or name of the container|This item is supported since Zabbix 5.0.0 for the Docker plugin.<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.container\_stats \[<ID>\]|<|<|<|<| |<|Container resource usage statistics.|An output of the [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) API call and CPU usage percentage serialized as JSON|**ID** - ID or name of the container|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.containers|<|<|<|<| |<|A list of containers.|An output of the [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) API call serialized as JSON|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.containers.discovery\[<options>\]|<|<|<|<| |<|A list of containers. Used for [low-level discovery](/manual/discovery/low_level_discovery/).|JSON object.|**options** - specifies whether all or only running containers should be discovered. Supported values:<br>*true* - return all containers;<br>*false* - return only running containers (default).|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.data\_usage|<|<|<|<| |<|Information about current data usage.|An output of the [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) API call serialized as JSON|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.images|<|<|<|<| |<|A list of images.|An output of the [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) API call serialized as JSON|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.images.discovery|<|<|<|<| |<|A list of images. Used for [low-level discovery](/manual/discovery/low_level_discovery/).|JSON object.|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.info|<|<|<|<| |<|System information.|An output of the [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) API call serialized as JSON|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.ping|<|<|<|<| |<|Test if a Docker daemon is alive or not.|1 - connection is alive<br><br>0 - connection is broken|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |memcached.ping\[connString,<user>,<password>\]|<|<|<|<| |<|Test if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues)|**connString** - URI or session name.|This item is supported for the [Memchached plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |memcached.stats\[connString,<user>,<password>,<type>\]|<|<|<|<| |<|Gets the output of the STATS command.|JSON - output is serialized as JSON|**connString** - URI or session name.<br>**user, password** - Memchached login credentials.<br>**type** - stat type to be returned: *items*, *sizes*, *slabs* or *settings* (empty by default, returns general statistics).|This item is supported for the [Memchached plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.collection.stats\[connString,<user>,<password>,<database>,collection\]|<|<|<|<| |<|Returns a variety of storage statistics for a given collection.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.<br>**database** - database name (default: admin).<br>**collection** — collection name.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.collections.discovery\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a list of discovered collections. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.collections.usage\[connString,<user>,<password>\]|<|<|<|<| |<|Returns usage statistics for collections.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.connpool.stats\[connString,<user>,<password>\]|<|<|<|<| |<|Returns information regarding the open outgoing connections from the current database instance to other members of the sharded cluster or replica set.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.db.stats\[connString,<user>,<password>,<database>\]|<|<|<|<| |<|Returns statistics reflecting a given database system state.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.<br>**database** - database name (default: admin).|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.db.discovery\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a list of discovered databases. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.jumbo\_chunks.count\[connString,<user>,<password>\]|<|<|<|<| |<|Returns count of jumbo chunks.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.oplog.stats\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a status of the replica set, using data polled from the oplog.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.ping\[connString,<user>,<password>\]|<|<|<|<| |<|Tests if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues).|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.rs.config\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a current configuration of the replica set.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.rs.status\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a replica set status from the point of view of the member where the method is run.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.server.status\[connString,<user>,<password>\]|<|<|<|<| |<|Returns database state.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.sh.discovery\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a list of discovered shards present in the cluster.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mqtt.get\[<broker\_url>,topic,<username>,<password>\]|<|<|<|<| |<|Subscribes to a specific topic or topics (with wildcards) of the provided broker and waits for publications.|Depending on topic content.<br><br>If wildcards are used, returns topic content as JSON.|**broker\_url** - MQTT broker URL (if empty, *localhost* with port 1883 is used).<br>**topic** - MQTT topic (mandatory). Wildcards (+,\#) are supported.<br>**username,password** - authentication credentials (if required)|This item is supported for the [MQTT plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks) ('Zabbix agent (active)' item type).<br><br>TLS encryption certificates can be used by saving them into a default location (e.g. `/etc/ssl/certs/` directory for Ubuntu). For TLS, use the `tls://` scheme.| |mysql.db.discovery\[connString, <username>, <password>\]|<|<|<|<| |<|List of MySQL databases. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|Result of the "show databases" SQL query in LLD JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.db.size\[connString, <username>, <password>,dbName\]|<|<|<|<| |<|Database size in bytes.|Result of the "select coalesce(sum(data\_length + index\_length),0) as size from information\_schema.tables where table\_schema=?" SQL query for specific database in bytes.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.<br>**dbName** - Database name.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.get\_status\_variables\[connString, <username>, <password>\]|<|<|<|<| |<|Values of global status variables.|Result of the "show global status" SQL query in JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.ping\[connString, <username>, <password>\]|<|<|<|<| |<|Test if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues).|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.replication.discovery\[connString, <username>, <password>\]|<|<|<|<| |<|List of MySQL replications. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|Result of the "show slave status" SQL query in LLD JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.replication.get\_slave\_status\[connString, <username>, <password>, <masterHost>\]|<|<|<|<| |<|Replication status.|Result of the "show slave status" SQL query in JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.<br>**masterHost** - Replication master host name.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.version\[connString, <username>, <password>\]|<|<|<|<| |<|MySQL version.|String with MySQL instance version.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.diskgroups.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|ASM disk groups statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.diskgroups.discovery\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|List of ASM disk groups. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.archive.info\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Archive logs statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.cdb.info\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|CDBs info.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.custom.query\[connString,<user>,<password>,<service>, queryName, <args...>\]|<|<|<|<| |<|Result of a custom query.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**queryName** — name of a custom query (must be equal to a name of an sql file without an extension).<br>**args...** — one or several comma-separated arguments to pass to a query.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.datafiles.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Data files statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.db.discovery\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|List of databases. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.fra.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|FRA statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.instance.info\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Instance statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.pdb.info\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|PDBs info.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.pdb.discovery\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|List of PDBs. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.pga.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|PGA statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.ping\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Tests whether a connection to Oracle can be established.|0 - connection is broken (if there is any error presented including AUTH and configuration issues)<br>1 - connection is successful.|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.proc.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Processes statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.redolog.info\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Log file information from the control file.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.sga.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|SGA statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.sessions.stats\[connString,<user>,<password>,<service>,<lockMaxTime>\]|<|<|<|<| |<|Sessions statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**lockMaxTime** - maximum session lock duration in seconds to count the session as a prolongedly locked. Default: 600 seconds.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.sys.metrics\[connString,<user>,<password>,<service>,<duration>\]|<|<|<|<| |<|A set of system metric values.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**duration** - capturing interval (in seconds) of system metric values. Possible values: *60* — long duration (default), *15* — short duration.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.sys.params\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|A set of system parameter values.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.ts.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Tablespaces statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.ts.discovery\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|List of tablespaces. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.user.info\[connString,<user>,<password>,<username>\]|<|<|<|<| |<|List of tablespaces. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**username** - a username, for which the information is needed. Lowercase usernames are not supported. Default: current user.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.autovacuum.count\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|The number of autovacuum workers.|SQL query.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.archive\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Information about archived files.|SQL query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.archive.count\_archived\_files** - the number of WAL files that have been successfully archived.<br>**pgsql.archive.failed\_trying\_to\_archive** - the number of failed attempts for archiving WAL files.<br>**pgsql.archive.count\_files\_to\_archive** - the number of files to archive.<br>**pgsql.archive.size\_files\_to\_archive** -the size of files to archive.<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.bgwriter\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Combined number of checkpoints for the database cluster, broken down by checkpoint type.|SQL query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.bgwriter.buffers\_alloc** - the number of buffers allocated.<br>**pgsql.bgwriter.buffers\_backend** -the number of buffers written directly by a backend.<br>**pgsql.bgwriter.maxwritten\_clean** - the number of times the background writer stopped a cleaning scan, because it had written too many buffers.<br>**pgsql.bgwriter.buffers\_backend\_fsync** -the number of times a backend had to execute its own fsync call instead of the background writer.<br>**pgsql.bgwriter.buffers\_clean** - the number of buffers written by the background writer.<br>**pgsql.bgwriter.buffers\_checkpoint** - the number of buffers written during checkpoints.<br>**pgsql.bgwriter.checkpoints\_timed** - the number of scheduled checkpoints that have been performed.<br>**pgsql.bgwriter.checkpoints\_req** - the number of requested checkpoints that have been performed.<br>**pgsql.bgwriter.checkpoint\_write\_time** - the total amount of time spent in the portion of checkpoint processing where files are written to disk, in milliseconds.<br>**pgsql.bgwriter.sync\_time** - the total amount of time spent in the portion of checkpoint processing where files are synchronized with disk.<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.cache.hit\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|PostgreSQL buffer cache hit rate.|SQL query in percentage.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.connections\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Connections by type.|JSON object.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.connections.active** - the backend is executing a query.<br>**pgsql.connections.fastpath\_function\_call** -the backend is executing a fast-path function.<br>**pgsql.connections.idle** - the backend is waiting for a new client command.<br>**pgsql.connections.idle\_in\_transaction** - the backend is in a transaction, but is not currently executing a query.<br>**pgsql.connections.prepared** - the number of prepared connections.<br>**pgsql.connections.total** - the total number of connections.<br>**pgsql.connections.total\_pct** - percantange of total connections in respect to ‘max\_connections’ setting of the PostgreSQL server.<br>**pgsql.connections.waiting** - number of connections in a query.<br>**pgsql.connections.idle\_in\_transaction\_aborted** - the backend is in a transaction, but is not currently executing a query and one of the statements in the transaction caused an error.<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.dbstat\[uri,<username>,<password>, dbName\]|<|<|<|<| |<|Collects statistics per database. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQL query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.dbstat.numbackends\["{\#DBNAME}"\]** - time spent reading data file blocks by backends in this database, in milliseconds.<br>**pgsql.dbstat.sum.blk\_read\_time\["{\#DBNAME}"\]** - time spent reading data file blocks by backends in this database, in milliseconds.<br>**pgsql.dbstat.sum.blk\_write\_time\["{\#DBNAME}"\]** - time spent writing data file blocks by backends in this database, in milliseconds.<br>**pgsql.dbstat.sum.checksum\_failures\["{\#DBNAME}"\]** - the number of data page checksum failures detected (or on a shared object), or NULL if data checksums are not enabled.(PostgreSQL version 12 only)<br>**pgsql.dbstat.blks\_read.rate\["{\#DBNAME}"\]** - the number of disk blocks read in this database.<br>**pgsql.dbstat.deadlocks.rate\["{\#DBNAME}"\]** - the number of deadlocks detected in this database.<br>**pgsql.dbstat.blks\_hit.rate\["{\#DBNAME}"\]** - the number of times disk blocks were found already in the buffer cache, so that a read was not necessary (this only includes hits in the PostgreSQL Pro buffer cache, not the operating system's file system cache).<br>**pgsql.dbstat.xact\_rollback.rate\["{\#DBNAME}"\]** - the number of transactions in this database that have been rolled back.<br>**pgsql.dbstat.xact\_commit.rate\["{\#DBNAME}"\]** - the number of transactions in this database that have been committed.<br>**pgsql.dbstat.tup\_updated.rate\["{\#DBNAME}"\]** - the number of rows updated by queries in this database.<br>**pgsql.dbstat.tup\_returned.rate\["{\#DBNAME}"\]** - the number of rows returned by queries in this database.<br>**pgsql.dbstat.tup\_inserted.rate\["{\#DBNAME}"\]** - the number of rows inserted by queries in this database.<br>**pgsql.dbstat.tup\_fetched.rate\["{\#DBNAME}"\]** - the number of rows fetched by queries in this database.<br>**pgsql.dbstat.tup\_deleted.rate\["{\#DBNAME}"\]** - the number of rows deleted by queries in this database.<br>**pgsql.dbstat.conflicts.rate\["{\#DBNAME}"\]** - the number of queries canceled due to conflicts with recovery in this database (the conflicts occur only on standby servers).<br>**pgsql.dbstat.temp\_files.rate\["{\#DBNAME}"\]** - the number of temporary files created by queries in this database. All temporary files are counted, regardless of the log\_temp\_files settings and reasons for which the temporary file was created (e.g., sorting or hashing).<br>**pgsql.dbstat.temp\_bytes.rate\["{\#DBNAME}"\]** - the total amount of data written to temporary files by queries in this database. Includes data from all temporary files, regardless of the log\_temp\_files settings and reasons for which the temporary file was created (e.g., sorting or hashing).<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.dbstat.sum\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Summarized data for all databases in a cluster.|SQL query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by the dependent items:<br>**pgsql.dbstat.numbackends** - the number of backends currently connected to this database.<br>**pgsql.dbstat.sum.blk\_read\_time** - time spent reading data file blocks by backends in this database, in milliseconds.<br>**pgsql.dbstat.sum.blk\_write\_time** - time spent writing data file blocks by backends in this database, in milliseconds.<br>**pgsql.dbstat.sum.checksum\_failures** - the number of data page checksum failures detected (or on a shared object), or NULL if data checksums are not enabled (PostgreSQL version 12 only).<br>**pgsql.dbstat.sum.xact\_commit** - the number of transactions in this database that have been committed.<br>**pgsql.dbstat.sum.conflicts** - database statistics about query cancels due to conflict with recovery on standby servers.<br>**pgsql.dbstat.sum.deadlocks** - the number of deadlocks detected in this database.<br>**pgsql.dbstat.sum.blks\_read** - the number of disk blocks read in this database.<br>**pgsql.dbstat.sum.blks\_hit** - the number of times disk blocks were found already in the buffer cache, so a read was not necessary (only hits in the PostgreSQL Pro buffer cache are included).<br>**pgsql.dbstat.sum.temp\_bytes** - the total amount of data written to temporary files by queries in this database. Includes data from all temporary files, regardless of the log\_temp\_files settings and reasons for which the temporary file was created (e.g., sorting or hashing).<br>**pgsql.dbstat.sum.temp\_files** - the number of temporary files created by queries in this database. All temporary files are counted, regardless of the log\_temp\_files settings and reasons for which the temporary file was created (e.g., sorting or hashing).<br>**pgsql.dbstat.sum.xact\_rollback** - the number of rolled-back transactions in this database.<br>**pgsql.dbstat.sum.tup\_deleted** - the number of rows deleted by queries in this database.<br>**pgsql.dbstat.sum.tup\_fetched** - the number of rows fetched by queries in this database.<br>**pgsql.dbstat.sum.tup\_inserted** - the number of rows inserted by queries in this database.<br>**pgsql.dbstat.sum.tup\_returned** - the number of rows returned by queries in this database.<br>**pgsql.dbstat.sum.tup\_updated** - the number of rows updated by queries in this database.<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.db.age\[uri,<username>,<password>, dbName\]|<|<|<|<| |<|Age of the oldest FrozenXID of the database. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQL query for specific database in transactions.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.db.bloating\_tables\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|The number of bloating tables per database. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQL query.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.db.discovery\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|List of the PostgreSQL databases. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQL query in the LLD JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.db.size\[uri,<username>,<password>, dbName\]|<|<|<|<| |<|Database size in bytes. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQL query for specific database in bytes.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.locks\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Information about granted locks per database. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQl query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.locks.shareupdateexclusive\["{\#DBNAME}"\]** - the number of share update exclusive locks.<br>**pgsql.locks.accessexclusive\["{\#DBNAME}"\]** - the number of access exclusive locks.<br>**pgsql.locks.accessshare\["{\#DBNAME}"\]** - the number of access share locks.<br>**pgsql.locks.exclusive\["{\#DBNAME}"\]** - the number of exclusive locks.<br>**pgsql.locks.rowexclusive\["{\#DBNAME}"\]** - the number of row exclusive locks.<br>**pgsql.locks.rowshare\["{\#DBNAME}"\]** - the number of row share locks.<br>**pgsql.locks.share\["{\#DBNAME}"\]** - the number of shared locks.<br>**pgsql.locks.sharerowexclusive\["{\#DBNAME}"\]** - the number of share row exclusive locks.<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.oldest.xid\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Age of the oldest XID.|SQl query.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.ping\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Tests whether a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues).|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.replication.count\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|The number of standby servers.|SQL query.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.replication.recovery\_role\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Recovery status.|0 - master mode<br>1 - recovery is still in progress (standby mode)|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.replication.status\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|The status of replication.|0 - streaming is down<br>1 - streaming is up<br>2 - master mode|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.replication\_lag.b\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Replication lag in bytes.|SQL query in bytes.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.replication\_lag.sec\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Replication lag in seconds.|SQL query in seconds.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.uptime\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|PostgreSQL uptime in milliseconds.|SQL query in milliseconds.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.wal.stat\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|WAL statistics.|SQL query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.wal.count** — the number of WAL files.<br>**pgsql.wal.write** - the WAL lsn used (in bytes).<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |redis.config\[connString,<password>,<pattern>\]|<|<|<|<| |<|Gets the configuration parameters of a Redis instance that match the pattern.|JSON - if a glob-style pattern was used<br><br>single value - if a pattern did not contain any wildcard character|**connString** - URI or session name.<br>**password** - Redis password.<br>**pattern** - glob-style pattern (*\** by default).|This item is supported since Zabbix 4.4.5 for the [Redis plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |redis.info\[connString,<password>,<section>\]|<|<|<|<| |<|Gets the output of the INFO command.|JSON - output is serialized as JSON|**connString** - URI or session name.<br>**password** - Redis password.<br>**section** - [section](https://redis.io/commands/info) of information (*default* by default).|This item is supported since Zabbix 4.4.5 for the [Redis plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |redis.ping\[connString,<password>\]|<|<|<|<| |<|Test if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues)|**connString** - URI or session name.<br>**password** - Redis password.|This item is supported since Zabbix 4.4.5 for the [Redis plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |redis.slowlog.count\[connString,<password>\]|<|<|<|<| |<|The number of slow log entries since Redis was started.|Integer|**connString** - URI or session name.<br>**password** - Redis password.|This item is supported since Zabbix 4.4.5 for the [Redis plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |smart.attribute.discovery|<|<|<|<| |<|Returns a list of S.M.A.R.T. device attributes.|JSON object|<|The following macros and their values are returned: {\#NAME}, {\#DISKTYPE}, {\#ID}, {\#ATTRNAME}, {\#THRESH}.<br>HDD, SSD and NVME drive types are supported. Drives can be alone or combined in a RAID. {\#NAME} will have an add-on in case of RAID, e.g: {"{\#NAME}": "/dev/sda cciss,2"}<br><br>This item is supported for the [Smart plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |smart.disk.discovery|<|<|<|<| |<|Returns a list of S.M.A.R.T. devices.|JSON object|<|The following macros and their values are returned: {\#NAME}, {\#DISKTYPE}, {\#MODEL}, {\#SN}.<br>HDD, SSD and NVME drive types are supported. Drives can be alone or combined in a RAID. {\#NAME} will have an add-on in case of RAID, e.g: {"{\#NAME}": "/dev/sda cciss,2"}<br><br>This item is supported for the [Smart plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |smart.disk.get|<|<|<|<| |<|Returns all available properties of S.M.A.R.T. devices.|JSON object|<|HDD, SSD and NVME drive types are supported. Drives can be alone or combined in a RAID.<br>The data includes smartctl version and call arguments, and additional fields:<br>*disk\_name* - holds the name with the required add-ons for RAID discovery, e.g: {"disk\_name": "/dev/sda cciss,2"}<br>*disk\_type* - holds the disk type HDD, SSD, or NVME, e.g: {"disk\_type": "ssd"})<br><br>This item is supported for the [Smart plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |systemd.unit.get\[unit name,<interface>\]|<|<|<|<| |<|Returns all properties of a systemd unit.|JSON object|**unit name** - unit name (you may want to use the {\#UNIT.NAME} macro in item prototype to discover the name)<br>**interface** - unit interface type, possible values: *Unit* (default), *Service*, *Socket*, *Device*, *Mount*, *Automount*, *Swap*, *Target*, *Path*|This item is supported for the [Systemd plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box) on Linux platform only.<br><br>LoadState, ActiveState and UnitFileState for Unit interface are returned as text and integer:<br>`"ActiveState":{"state":1,"text":"active"}`| |systemd.unit.info\[unit name,<property>,<interface>\]|<|<|<|<| |<|Systemd unit information.|String|**unit name** - unit name (you may want to use the {\#UNIT.NAME} macro in item prototype to discover the name)<br>**property** - unit property (e.g. ActiveState (default), LoadState, Description)<br>**interface** - unit interface type (e.g. Unit (default), Socket, Service)|This item allows to retrieve a specific property from specific type of interface as described in [dbus API](https://www.freedesktop.org/wiki/Software/systemd/dbus/).<br><br>This item is supported for the [Systemd plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box) on Linux platform only.<br><br>Examples:<br>=> systemd.unit.info\["{\#UNIT.NAME}"\] - collect active state (active, reloading, inactive, failed, activating, deactivating) info on discovered systemd units<br>=> systemd.unit.info\["{\#UNIT.NAME}",LoadState\] - collect load state info on discovered systemd units<br>=> systemd.unit.info\[mysqld.service,Id\] - retrieve service technical name (mysqld.service)<br>=> systemd.unit.info\[mysqld.service,Description\] - retrieve service description (MySQL Server)<br>=> systemd.unit.info\[mysqld.service,ActiveEnterTimestamp\] - retrieve the last time the service entered the active state (1562565036283903)<br>=> systemd.unit.info\[dbus.socket,NConnections,Socket\] - collect the number of connections from this socket unit| |systemd.unit.discovery\[<type>\]|<|<|<|<| |<|List of systemd units and their details. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**type** - possible values: *all*, *automount*, *device*, *mount*, *path*, *service* (default), *socket*, *swap*, *target*|This item is supported for the [Systemd plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box) on Linux platform only.| |web.certificate.get\[hostname,<port>,<address>\]|<|<|<|<| |<|Validates certificates and returns certificate details.|JSON object|**hostname** - can be either IP or DNS.<br>May contain the URL scheme (*https* only), path (it will be ignored), and port.<br>If a port is provided in both the first and the second parameters, their values must match.<br>If address (the 3rd parameter) is specified, the hostname is only used for SNI and hostname verification.<br>**port** - port number (default is 443 for HTTPS).<br>**address** - can be either IP or DNS. If specified, it will be used for connection, and hostname (the 1st parameter) will be used for SNI, and host verification.<br>In case, the 1st parameter is an IP and the 3rd parameter is DNS, the 1st parameter will be used for connection, and the 3rd parameter will be used for SNI and host verification.|This item turns unsupported if the resource specified in `host` does not exist or is unavailable or if TLS handshake fails with any error except an invalid certificate.<br><br>Currently, AIA (Authority Information Access) X.509 extension, CRLs and OCSP (including OCSP stapling), Certificate Transparency, and custom CA trust store are not supported.| #### Item keys The table provides details on the item keys that you can use with Zabbix agent 2 only. See also: [Plugins supplied out-of-the-box](/manual/config/items/plugins#plugins_supplied_out-of-the-box) ::: noteclassic Parameters without angle brackets are mandatory. Parameters marked with angle brackets **<** **>** are optional. ::: |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.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |ceph.osd.stats \[connString, <user>, <apikey>\]|<|<|<|<| |<|Aggregated and per OSD statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |ceph.osd.discovery \[connString, <user>, <apikey>\]|<|<|<|<| |<|List of discovered OSDs. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |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.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |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>1 - connection is successful.|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |ceph.pool.discovery \[connString, <user>, <apikey>\]|<|<|<|<| |<|List of discovered pools. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |ceph.status \[connString, <user>, <apikey>\]|<|<|<|<| |<|Overall cluster's status.|JSON object|**connString** - URI or session name.<br>**user, password** - Ceph login credentials.|This item is supported for the [Ceph plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |docker.container\_info \[<ID>\]|<|<|<|<| |<|Low-level information about a container.|An output of the [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) API call serialized as JSON|**ID** - ID or name of the container|This item is supported since Zabbix 5.0.0 for the Docker plugin.<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.container\_stats \[<ID>\]|<|<|<|<| |<|Container resource usage statistics.|An output of the [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) API call and CPU usage percentage serialized as JSON|**ID** - ID or name of the container|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.containers|<|<|<|<| |<|A list of containers.|An output of the [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) API call serialized as JSON|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.containers.discovery\[<options>\]|<|<|<|<| |<|A list of containers. Used for [low-level discovery](/manual/discovery/low_level_discovery/).|JSON object.|**options** - specifies whether all or only running containers should be discovered. Supported values:<br>*true* - return all containers;<br>*false* - return only running containers (default).|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.data\_usage|<|<|<|<| |<|Information about current data usage.|An output of the [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) API call serialized as JSON|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.images|<|<|<|<| |<|A list of images.|An output of the [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) API call serialized as JSON|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.images.discovery|<|<|<|<| |<|A list of images. Used for [low-level discovery](/manual/discovery/low_level_discovery/).|JSON object.|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.info|<|<|<|<| |<|System information.|An output of the [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) API call serialized as JSON|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |docker.ping|<|<|<|<| |<|Test if a Docker daemon is alive or not.|1 - connection is alive<br><br>0 - connection is broken|\-|This item is supported for the [Docker plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The Agent2 user ('zabbix') must be added to the 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) for sufficient privileges. Otherwise the check will fail.| |memcached.ping\[connString,<user>,<password>\]|<|<|<|<| |<|Test if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues)|**connString** - URI or session name.|This item is supported for the [Memchached plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |memcached.stats\[connString,<user>,<password>,<type>\]|<|<|<|<| |<|Gets the output of the STATS command.|JSON - output is serialized as JSON|**connString** - URI or session name.<br>**user, password** - Memchached login credentials.<br>**type** - stat type to be returned: *items*, *sizes*, *slabs* or *settings* (empty by default, returns general statistics).|This item is supported for the [Memchached plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.collection.stats\[connString,<user>,<password>,<database>,collection\]|<|<|<|<| |<|Returns a variety of storage statistics for a given collection.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.<br>**database** - database name (default: admin).<br>**collection** — collection name.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.collections.discovery\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a list of discovered collections. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.collections.usage\[connString,<user>,<password>\]|<|<|<|<| |<|Returns usage statistics for collections.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.connpool.stats\[connString,<user>,<password>\]|<|<|<|<| |<|Returns information regarding the open outgoing connections from the current database instance to other members of the sharded cluster or replica set.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.db.stats\[connString,<user>,<password>,<database>\]|<|<|<|<| |<|Returns statistics reflecting a given database system state.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.<br>**database** - database name (default: admin).|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.db.discovery\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a list of discovered databases. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.jumbo\_chunks.count\[connString,<user>,<password>\]|<|<|<|<| |<|Returns count of jumbo chunks.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.oplog.stats\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a status of the replica set, using data polled from the oplog.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.ping\[connString,<user>,<password>\]|<|<|<|<| |<|Tests if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues).|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.rs.config\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a current configuration of the replica set.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.rs.status\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a replica set status from the point of view of the member where the method is run.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.server.status\[connString,<user>,<password>\]|<|<|<|<| |<|Returns database state.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mongodb.sh.discovery\[connString,<user>,<password>\]|<|<|<|<| |<|Returns a list of discovered shards present in the cluster.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.|This item is supported for the [MongoDB plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mqtt.get\[<broker\_url>,topic,<username>,<password>\]|<|<|<|<| |<|Subscribes to a specific topic or topics (with wildcards) of the provided broker and waits for publications.|Depending on topic content.<br><br>If wildcards are used, returns topic content as JSON.|**broker\_url** - MQTT broker URL (if empty, *localhost* with port 1883 is used).<br>**topic** - MQTT topic (mandatory). Wildcards (+,\#) are supported.<br>**username,password** - authentication credentials (if required)|This item is supported for the [MQTT plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).<br><br>The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks) ('Zabbix agent (active)' item type).<br><br>TLS encryption certificates can be used by saving them into a default location (e.g. `/etc/ssl/certs/` directory for Ubuntu). For TLS, use the `tls://` scheme.| |mysql.db.discovery\[connString, <username>, <password>\]|<|<|<|<| |<|List of MySQL databases. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|Result of the "show databases" SQL query in LLD JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.db.size\[connString, <username>, <password>,dbName\]|<|<|<|<| |<|Database size in bytes.|Result of the "select coalesce(sum(data\_length + index\_length),0) as size from information\_schema.tables where table\_schema=?" SQL query for specific database in bytes.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.<br>**dbName** - Database name.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.get\_status\_variables\[connString, <username>, <password>\]|<|<|<|<| |<|Values of global status variables.|Result of the "show global status" SQL query in JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.ping\[connString, <username>, <password>\]|<|<|<|<| |<|Test if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues).|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.replication.discovery\[connString, <username>, <password>\]|<|<|<|<| |<|List of MySQL replications. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|Result of the "show slave status" SQL query in LLD JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.replication.get\_slave\_status\[connString, <username>, <password>, <masterHost>\]|<|<|<|<| |<|Replication status.|Result of the "show slave status" SQL query in JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.<br>**masterHost** - Replication master host name.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |mysql.version\[connString, <username>, <password>\]|<|<|<|<| |<|MySQL version.|String with MySQL instance version.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.|This item is supported for the [MySQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.diskgroups.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|ASM disk groups statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.diskgroups.discovery\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|List of ASM disk groups. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.archive.info\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Archive logs statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.cdb.info\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|CDBs info.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.custom.query\[connString,<user>,<password>,<service>, queryName, <args...>\]|<|<|<|<| |<|Result of a custom query.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**queryName** — name of a custom query (must be equal to a name of an sql file without an extension).<br>**args...** — one or several comma-separated arguments to pass to a query.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.datafiles.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Data files statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.db.discovery\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|List of databases. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.fra.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|FRA statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.instance.info\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Instance statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.pdb.info\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|PDBs info.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.pdb.discovery\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|List of PDBs. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.pga.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|PGA statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.ping\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Tests whether a connection to Oracle can be established.|0 - connection is broken (if there is any error presented including AUTH and configuration issues)<br>1 - connection is successful.|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.proc.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Processes statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.redolog.info\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Log file information from the control file.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.sga.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|SGA statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.sessions.stats\[connString,<user>,<password>,<service>,<lockMaxTime>\]|<|<|<|<| |<|Sessions statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**lockMaxTime** - maximum session lock duration in seconds to count the session as a prolongedly locked. Default: 600 seconds.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.sys.metrics\[connString,<user>,<password>,<service>,<duration>\]|<|<|<|<| |<|A set of system metric values.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**duration** - capturing interval (in seconds) of system metric values. Possible values: *60* — long duration (default), *15* — short duration.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.sys.params\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|A set of system parameter values.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.ts.stats\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|Tablespaces statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.ts.discovery\[connString,<user>,<password>,<service>\]|<|<|<|<| |<|List of tablespaces. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |oracle.user.info\[connString,<user>,<password>,<username>\]|<|<|<|<| |<|List of tablespaces. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**username** - a username, for which the information is needed. Lowercase usernames are not supported. Default: current user.|This item is supported for the [Oracle plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.autovacuum.count\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|The number of autovacuum workers.|SQL query.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.archive\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Information about archived files.|SQL query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.archive.count\_archived\_files** - the number of WAL files that have been successfully archived.<br>**pgsql.archive.failed\_trying\_to\_archive** - the number of failed attempts for archiving WAL files.<br>**pgsql.archive.count\_files\_to\_archive** - the number of files to archive.<br>**pgsql.archive.size\_files\_to\_archive** -the size of files to archive.<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.bgwriter\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Combined number of checkpoints for the database cluster, broken down by checkpoint type.|SQL query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.bgwriter.buffers\_alloc** - the number of buffers allocated.<br>**pgsql.bgwriter.buffers\_backend** -the number of buffers written directly by a backend.<br>**pgsql.bgwriter.maxwritten\_clean** - the number of times the background writer stopped a cleaning scan, because it had written too many buffers.<br>**pgsql.bgwriter.buffers\_backend\_fsync** -the number of times a backend had to execute its own fsync call instead of the background writer.<br>**pgsql.bgwriter.buffers\_clean** - the number of buffers written by the background writer.<br>**pgsql.bgwriter.buffers\_checkpoint** - the number of buffers written during checkpoints.<br>**pgsql.bgwriter.checkpoints\_timed** - the number of scheduled checkpoints that have been performed.<br>**pgsql.bgwriter.checkpoints\_req** - the number of requested checkpoints that have been performed.<br>**pgsql.bgwriter.checkpoint\_write\_time** - the total amount of time spent in the portion of checkpoint processing where files are written to disk, in milliseconds.<br>**pgsql.bgwriter.sync\_time** - the total amount of time spent in the portion of checkpoint processing where files are synchronized with disk.<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.cache.hit\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|PostgreSQL buffer cache hit rate.|SQL query in percentage.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.connections\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Connections by type.|JSON object.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.connections.active** - the backend is executing a query.<br>**pgsql.connections.fastpath\_function\_call** -the backend is executing a fast-path function.<br>**pgsql.connections.idle** - the backend is waiting for a new client command.<br>**pgsql.connections.idle\_in\_transaction** - the backend is in a transaction, but is not currently executing a query.<br>**pgsql.connections.prepared** - the number of prepared connections.<br>**pgsql.connections.total** - the total number of connections.<br>**pgsql.connections.total\_pct** - percantange of total connections in respect to ‘max\_connections’ setting of the PostgreSQL server.<br>**pgsql.connections.waiting** - number of connections in a query.<br>**pgsql.connections.idle\_in\_transaction\_aborted** - the backend is in a transaction, but is not currently executing a query and one of the statements in the transaction caused an error.<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.dbstat\[uri,<username>,<password>, dbName\]|<|<|<|<| |<|Collects statistics per database. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQL query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.dbstat.numbackends\["{\#DBNAME}"\]** - time spent reading data file blocks by backends in this database, in milliseconds.<br>**pgsql.dbstat.sum.blk\_read\_time\["{\#DBNAME}"\]** - time spent reading data file blocks by backends in this database, in milliseconds.<br>**pgsql.dbstat.sum.blk\_write\_time\["{\#DBNAME}"\]** - time spent writing data file blocks by backends in this database, in milliseconds.<br>**pgsql.dbstat.sum.checksum\_failures\["{\#DBNAME}"\]** - the number of data page checksum failures detected (or on a shared object), or NULL if data checksums are not enabled.(PostgreSQL version 12 only)<br>**pgsql.dbstat.blks\_read.rate\["{\#DBNAME}"\]** - the number of disk blocks read in this database.<br>**pgsql.dbstat.deadlocks.rate\["{\#DBNAME}"\]** - the number of deadlocks detected in this database.<br>**pgsql.dbstat.blks\_hit.rate\["{\#DBNAME}"\]** - the number of times disk blocks were found already in the buffer cache, so that a read was not necessary (this only includes hits in the PostgreSQL Pro buffer cache, not the operating system's file system cache).<br>**pgsql.dbstat.xact\_rollback.rate\["{\#DBNAME}"\]** - the number of transactions in this database that have been rolled back.<br>**pgsql.dbstat.xact\_commit.rate\["{\#DBNAME}"\]** - the number of transactions in this database that have been committed.<br>**pgsql.dbstat.tup\_updated.rate\["{\#DBNAME}"\]** - the number of rows updated by queries in this database.<br>**pgsql.dbstat.tup\_returned.rate\["{\#DBNAME}"\]** - the number of rows returned by queries in this database.<br>**pgsql.dbstat.tup\_inserted.rate\["{\#DBNAME}"\]** - the number of rows inserted by queries in this database.<br>**pgsql.dbstat.tup\_fetched.rate\["{\#DBNAME}"\]** - the number of rows fetched by queries in this database.<br>**pgsql.dbstat.tup\_deleted.rate\["{\#DBNAME}"\]** - the number of rows deleted by queries in this database.<br>**pgsql.dbstat.conflicts.rate\["{\#DBNAME}"\]** - the number of queries canceled due to conflicts with recovery in this database (the conflicts occur only on standby servers).<br>**pgsql.dbstat.temp\_files.rate\["{\#DBNAME}"\]** - the number of temporary files created by queries in this database. All temporary files are counted, regardless of the log\_temp\_files settings and reasons for which the temporary file was created (e.g., sorting or hashing).<br>**pgsql.dbstat.temp\_bytes.rate\["{\#DBNAME}"\]** - the total amount of data written to temporary files by queries in this database. Includes data from all temporary files, regardless of the log\_temp\_files settings and reasons for which the temporary file was created (e.g., sorting or hashing).<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.dbstat.sum\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Summarized data for all databases in a cluster.|SQL query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by the dependent items:<br>**pgsql.dbstat.numbackends** - the number of backends currently connected to this database.<br>**pgsql.dbstat.sum.blk\_read\_time** - time spent reading data file blocks by backends in this database, in milliseconds.<br>**pgsql.dbstat.sum.blk\_write\_time** - time spent writing data file blocks by backends in this database, in milliseconds.<br>**pgsql.dbstat.sum.checksum\_failures** - the number of data page checksum failures detected (or on a shared object), or NULL if data checksums are not enabled (PostgreSQL version 12 only).<br>**pgsql.dbstat.sum.xact\_commit** - the number of transactions in this database that have been committed.<br>**pgsql.dbstat.sum.conflicts** - database statistics about query cancels due to conflict with recovery on standby servers.<br>**pgsql.dbstat.sum.deadlocks** - the number of deadlocks detected in this database.<br>**pgsql.dbstat.sum.blks\_read** - the number of disk blocks read in this database.<br>**pgsql.dbstat.sum.blks\_hit** - the number of times disk blocks were found already in the buffer cache, so a read was not necessary (only hits in the PostgreSQL Pro buffer cache are included).<br>**pgsql.dbstat.sum.temp\_bytes** - the total amount of data written to temporary files by queries in this database. Includes data from all temporary files, regardless of the log\_temp\_files settings and reasons for which the temporary file was created (e.g., sorting or hashing).<br>**pgsql.dbstat.sum.temp\_files** - the number of temporary files created by queries in this database. All temporary files are counted, regardless of the log\_temp\_files settings and reasons for which the temporary file was created (e.g., sorting or hashing).<br>**pgsql.dbstat.sum.xact\_rollback** - the number of rolled-back transactions in this database.<br>**pgsql.dbstat.sum.tup\_deleted** - the number of rows deleted by queries in this database.<br>**pgsql.dbstat.sum.tup\_fetched** - the number of rows fetched by queries in this database.<br>**pgsql.dbstat.sum.tup\_inserted** - the number of rows inserted by queries in this database.<br>**pgsql.dbstat.sum.tup\_returned** - the number of rows returned by queries in this database.<br>**pgsql.dbstat.sum.tup\_updated** - the number of rows updated by queries in this database.<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.db.age\[uri,<username>,<password>, dbName\]|<|<|<|<| |<|Age of the oldest FrozenXID of the database. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQL query for specific database in transactions.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.db.bloating\_tables\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|The number of bloating tables per database. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQL query.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.db.discovery\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|List of the PostgreSQL databases. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQL query in the LLD JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.db.size\[uri,<username>,<password>, dbName\]|<|<|<|<| |<|Database size in bytes. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQL query for specific database in bytes.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.locks\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Information about granted locks per database. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|SQl query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.locks.shareupdateexclusive\["{\#DBNAME}"\]** - the number of share update exclusive locks.<br>**pgsql.locks.accessexclusive\["{\#DBNAME}"\]** - the number of access exclusive locks.<br>**pgsql.locks.accessshare\["{\#DBNAME}"\]** - the number of access share locks.<br>**pgsql.locks.exclusive\["{\#DBNAME}"\]** - the number of exclusive locks.<br>**pgsql.locks.rowexclusive\["{\#DBNAME}"\]** - the number of row exclusive locks.<br>**pgsql.locks.rowshare\["{\#DBNAME}"\]** - the number of row share locks.<br>**pgsql.locks.share\["{\#DBNAME}"\]** - the number of shared locks.<br>**pgsql.locks.sharerowexclusive\["{\#DBNAME}"\]** - the number of share row exclusive locks.<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.oldest.xid\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Age of the oldest XID.|SQl query.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.ping\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Tests whether a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues).|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.replication.count\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|The number of standby servers.|SQL query.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.replication.recovery\_role\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Recovery status.|0 - master mode<br>1 - recovery is still in progress (standby mode)|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.replication.status\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|The status of replication.|0 - streaming is down<br>1 - streaming is up<br>2 - master mode|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.replication\_lag.b\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Replication lag in bytes.|SQL query in bytes.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.replication\_lag.sec\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|Replication lag in seconds.|SQL query in seconds.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.uptime\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|PostgreSQL uptime in milliseconds.|SQL query in milliseconds.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |pgsql.wal.stat\[uri,<username>,<password>, <dbName>\]|<|<|<|<| |<|WAL statistics.|SQL query in JSON format.|**uri** - URI or session name.<br>**username, password** - PostgreSQL credentials.<br>**dbName** - Database name.|Returned data are processed by dependent items:<br>**pgsql.wal.count** — the number of WAL files.<br>**pgsql.wal.write** - the WAL lsn used (in bytes).<br><br>This item is supported since Zabbix 5.0.1 for the [PostgreSQL plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |redis.config\[connString,<password>,<pattern>\]|<|<|<|<| |<|Gets the configuration parameters of a Redis instance that match the pattern.|JSON - if a glob-style pattern was used<br><br>single value - if a pattern did not contain any wildcard character|**connString** - URI or session name.<br>**password** - Redis password.<br>**pattern** - glob-style pattern (*\** by default).|This item is supported since Zabbix 4.4.5 for the [Redis plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |redis.info\[connString,<password>,<section>\]|<|<|<|<| |<|Gets the output of the INFO command.|JSON - output is serialized as JSON|**connString** - URI or session name.<br>**password** - Redis password.<br>**section** - [section](https://redis.io/commands/info) of information (*default* by default).|This item is supported since Zabbix 4.4.5 for the [Redis plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |redis.ping\[connString,<password>\]|<|<|<|<| |<|Test if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues)|**connString** - URI or session name.<br>**password** - Redis password.|This item is supported since Zabbix 4.4.5 for the [Redis plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |redis.slowlog.count\[connString,<password>\]|<|<|<|<| |<|The number of slow log entries since Redis was started.|Integer|**connString** - URI or session name.<br>**password** - Redis password.|This item is supported since Zabbix 4.4.5 for the [Redis plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |smart.attribute.discovery|<|<|<|<| |<|Returns a list of S.M.A.R.T. device attributes.|JSON object|<|The following macros and their values are returned: {\#NAME}, {\#DISKTYPE}, {\#ID}, {\#ATTRNAME}, {\#THRESH}.<br>HDD, SSD and NVME drive types are supported. Drives can be alone or combined in a RAID. {\#NAME} will have an add-on in case of RAID, e.g: {"{\#NAME}": "/dev/sda cciss,2"}<br><br>This item is supported for the [Smart plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |smart.disk.discovery|<|<|<|<| |<|Returns a list of S.M.A.R.T. devices.|JSON object|<|The following macros and their values are returned: {\#NAME}, {\#DISKTYPE}, {\#MODEL}, {\#SN}.<br>HDD, SSD and NVME drive types are supported. Drives can be alone or combined in a RAID. {\#NAME} will have an add-on in case of RAID, e.g: {"{\#NAME}": "/dev/sda cciss,2"}<br><br>This item is supported for the [Smart plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |smart.disk.get|<|<|<|<| |<|Returns all available properties of S.M.A.R.T. devices.|JSON object|<|HDD, SSD and NVME drive types are supported. Drives can be alone or combined in a RAID.<br>The data includes smartctl version and call arguments, and additional fields:<br>*disk\_name* - holds the name with the required add-ons for RAID discovery, e.g: {"disk\_name": "/dev/sda cciss,2"}<br>*disk\_type* - holds the disk type HDD, SSD, or NVME, e.g: {"disk\_type": "ssd"})<br><br>This item is supported for the [Smart plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box).| |systemd.unit.get\[unit name,<interface>\]|<|<|<|<| |<|Returns all properties of a systemd unit.|JSON object|**unit name** - unit name (you may want to use the {\#UNIT.NAME} macro in item prototype to discover the name)<br>**interface** - unit interface type, possible values: *Unit* (default), *Service*, *Socket*, *Device*, *Mount*, *Automount*, *Swap*, *Target*, *Path*|This item is supported for the [Systemd plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box) on Linux platform only.<br><br>LoadState, ActiveState and UnitFileState for Unit interface are returned as text and integer:<br>`"ActiveState":{"state":1,"text":"active"}`| |systemd.unit.info\[unit name,<property>,<interface>\]|<|<|<|<| |<|Systemd unit information.|String|**unit name** - unit name (you may want to use the {\#UNIT.NAME} macro in item prototype to discover the name)<br>**property** - unit property (e.g. ActiveState (default), LoadState, Description)<br>**interface** - unit interface type (e.g. Unit (default), Socket, Service)|This item allows to retrieve a specific property from specific type of interface as described in [dbus API](https://www.freedesktop.org/wiki/Software/systemd/dbus/).<br><br>This item is supported for the [Systemd plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box) on Linux platform only.<br><br>Examples:<br>=> systemd.unit.info\["{\#UNIT.NAME}"\] - collect active state (active, reloading, inactive, failed, activating, deactivating) info on discovered systemd units<br>=> systemd.unit.info\["{\#UNIT.NAME}",LoadState\] - collect load state info on discovered systemd units<br>=> systemd.unit.info\[mysqld.service,Id\] - retrieve service technical name (mysqld.service)<br>=> systemd.unit.info\[mysqld.service,Description\] - retrieve service description (MySQL Server)<br>=> systemd.unit.info\[mysqld.service,ActiveEnterTimestamp\] - retrieve the last time the service entered the active state (1562565036283903)<br>=> systemd.unit.info\[dbus.socket,NConnections,Socket\] - collect the number of connections from this socket unit| |systemd.unit.discovery\[<type>\]|<|<|<|<| |<|List of systemd units and their details. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|JSON object|**type** - possible values: *all*, *automount*, *device*, *mount*, *path*, *service* (default), *socket*, *swap*, *target*|This item is supported for the [Systemd plugin](/manual/config/items/plugins#plugins_supplied_out-of-the-box) on Linux platform only.| |web.certificate.get\[hostname,<port>,<address>\]|<|<|<|<| |<|Validates certificates and returns certificate details.|JSON object|**hostname** - can be either IP or DNS.<br>May contain the URL scheme (*https* only), path (it will be ignored), and port.<br>If a port is provided in both the first and the second parameters, their values must match.<br>If address (the 3rd parameter) is specified, the hostname is only used for SNI and hostname verification.<br>**port** - port number (default is 443 for HTTPS).<br>**address** - can be either IP or DNS. If specified, it will be used for connection, and hostname (the 1st parameter) will be used for SNI, and host verification.<br>In case, the 1st parameter is an IP and the 3rd parameter is DNS, the 1st parameter will be used for connection, and the 3rd parameter will be used for SNI and host verification.|This item turns unsupported if the resource specified in `host` does not exist or is unavailable or if TLS handshake fails with any error except an invalid certificate.<br><br>Currently, AIA (Authority Information Access) X.509 extension, CRLs and OCSP (including OCSP stapling), Certificate Transparency, and custom CA trust store are not supported.| #### Item keys The table provides details on the simple checks that can be used to monitor [VMware environments](/manual/vm_monitoring). |Key|<|<|<|<| |-|------|--|------|------| |<|Description|Return value|Parameters|Comments| |vmware.cl.perfcounter\[<url>,<id>,<path>,<instance>\]|<|<|<|<| |<|VMware cluster performance counter metrics.|Integer|**url** - VMware service URL<br>**id** - VMware cluster ID<br>**path** - performance counter path<br>**instance** - performance counter instance|`id` can be received from vmware.cluster.discovery\[\] as {\#CLUSTER.ID}| |vmware.cluster.discovery\[<url>\]|<|<|<|<| |<|Discovery of VMware clusters.|JSON object|**url** - VMware service URL|<| |vmware.cluster.status\[<url>, <name>\]|<|<|<|<| |<|VMware cluster status.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**name** - VMware cluster name|<| |vmware.datastore.discovery\[<url>\]|<|<|<|<| |<|Discovery of VMware datastores.|JSON object|**url** - VMware service URL|<| |vmware.datastore.hv.list\[<url>,<datastore>\]|<|<|<|<| |<|List of datastore hypervisors.|JSON object|**url** - VMware service URL<br>**datastore** - datastore name|<| |vmware.datastore.read\[<url>,<datastore>,<mode>\]|<|<|<|<| |<|Amount of time for a read operation from the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - latency (average value, default), maxlatency (maximum value)|<| |vmware.datastore.size\[<url>,<datastore>,<mode>\]|<|<|<|<| |<|VMware datastore space in bytes or in percentage from total.|Integer - for bytes<br>Float - for percentage|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - possible values:<br>total (default), free, pfree (free, percentage), uncommitted|<| |vmware.datastore.write\[<url>,<datastore>,<mode>\]|<|<|<|<| |<|Amount of time for a write operation to the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - latency (average value, default), maxlatency (maximum value)|<| |vmware.dc.discovery\[<url>\]|<|<|<|<| |<|Discovery of VMware datacenters.|JSON object|**url** - VMware service URL|<| |vmware.eventlog\[<url>,<mode>\]|<|<|<|<| |<|VMware event log.|Log|**url** - VMware service URL<br>**mode** - *all* (default), *skip* - skip processing of older data|There must be only one vmware.eventlog\[\] item key per URL.<br><br>See also: [example of filtering](/manual/config/items/preprocessing/examples#filtering_vmware_event_log_records) VMware event log records.| |vmware.fullname\[<url>\]|<|<|<|<| |<|VMware service full name.|String|**url** - VMware service URL|<| |vmware.hv.cluster.name\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor cluster name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.cpu.usage\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor processor usage (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.cpu.usage.perf\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor processor usage as a percentage during the interval.|Float|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.cpu.utilization\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor processor usage as a percentage during the interval, depends on power management or HT.|Float|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.datacenter.name\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor datacenter name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.datastore.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Discovery of VMware hypervisor datastores.|JSON object|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.datastore.list\[<url>,<uuid>\]|<|<|<|<| |<|List of VMware hypervisor datastores.|JSON object|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.datastore.multipath\[<url>,<uuid>,<datastore>,<partitionid>\]|<|<|<|<| |<|Number of available datastore paths.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**datastore** - datastore name<br>**partitionid** - internal ID of physical device from vmware.hv.datastore.discovery|<| |vmware.hv.datastore.read\[<url>,<uuid>,<datastore>,<mode>\]|<|<|<|<| |<|Average amount of time for a read operation from the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**datastore** - datastore name<br>**mode** - latency (default)|<| |vmware.hv.datastore.size\[<url>,<uuid>,<datastore>,<mode>\]|<|<|<|<| |<|VMware datastore space in bytes or in percentage from total.|Integer - for bytes<br>Float - for percentage|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**datastore** - datastore name<br>**mode** - possible values:<br>total (default), free, pfree (free, percentage), uncommitted|<| |vmware.hv.datastore.write\[<url>,<uuid>,<datastore>,<mode>\]|<|<|<|<| |<|Average amount of time for a write operation to the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**datastore** - datastore name<br>**mode** - latency (default)|<| |vmware.hv.discovery\[<url>\]|<|<|<|<| |<|Discovery of VMware hypervisors.|JSON object|**url** - VMware service URL|<| |vmware.hv.fullname\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.cpu.freq\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor processor frequency (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.cpu.model\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor processor model.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.cpu.num\[<url>,<uuid>\]|<|<|<|<| |<|Number of processor cores on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.cpu.threads\[<url>,<uuid>\]|<|<|<|<| |<|Number of processor threads on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.memory\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor total memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.model\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor model.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.uuid\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor BIOS UUID.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.vendor\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor vendor name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.maintenance\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor maintenance status.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|Returns '0' - not in maintenance or '1' - in maintenance| |vmware.hv.memory.size.ballooned\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor ballooned memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.memory.used\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor used memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.network.in\[<url>,<uuid>,<mode>\]|<|<|<|<| |<|VMware hypervisor network input statistics (bytes per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**mode** - bps (default)|<| |vmware.hv.network.out\[<url>,<uuid>,<mode>\]|<|<|<|<| |<|VMware hypervisor network output statistics (bytes per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**mode** - bps (default)|<| |vmware.hv.perfcounter\[<url>,<uuid>,<path>,<instance>\]|<|<|<|<| |<|VMware hypervisor performance counter value.|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**path** - performance counter path ^**[1](vmware_keys#footnotes)**^<br>**instance** - performance counter instance. Use empty instance for aggregate values (default)|<| |vmware.hv.power\[<url>,<uuid>,<max>\]|<|<|<|<| |<|VMware hypervisor power usage (W).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**max** - maximum allowed power usage|<| |vmware.hv.sensor.health.state\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor health state rollup sensor.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.sensors.get\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor HW vendor state sensors.|JSON|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.status\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor status.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|Uses the host system overall status property.| |vmware.hv.uptime\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor uptime (seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.version\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor version.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.vm.num\[<url>,<uuid>\]|<|<|<|<| |<|Number of virtual machines on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.version\[<url>\]|<|<|<|<| |<|VMware service version.|String|**url** - VMware service URL|<| |vmware.vm.cluster.name\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.cpu.latency\[<url>,<uuid>\]|<|<|<|<| |<|Percentage of time the virtual machine is unable to run because it is contending for access to the physical CPU(s).|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.cpu.num\[<url>,<uuid>\]|<|<|<|<| |<|Number of processors on VMware virtual machine.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.cpu.readiness\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|Percentage of time that the virtual machine was ready, but could not get scheduled to run on the physical CPU.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - CPU instance|<| |vmware.vm.cpu.ready\[<url>,<uuid>\]|<|<|<|<| |<|Time (in milliseconds) that the virtual machine was ready, but could not get scheduled to run on the physical CPU. CPU ready time is dependent on the number of virtual machines on the host and their CPU loads (%).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.cpu.swapwait\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|Percentage of CPU time spent waiting for swap-in.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - CPU instance|<| |vmware.vm.cpu.usage\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine processor usage (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.cpu.usage.perf\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine processor usage as a percentage during the interval.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.datacenter.name\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine datacenter name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.discovery\[<url>\]|<|<|<|<| |<|Discovery of VMware virtual machines.|JSON object|**url** - VMware service URL|<| |vmware.vm.guest.memory.size.swapped\[<url>,<uuid>\]|<|<|<|<| |<|Amount of guest physical memory that is swapped out to the swap space (KB).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.guest.osuptime\[<url>,<uuid>\]|<|<|<|<| |<|Total time elapsed since the last operating system boot-up (in seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.hv.name\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine hypervisor name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine total memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.ballooned\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine ballooned memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.compressed\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine compressed memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.consumed\[<url>,<uuid>\]|<|<|<|<| |<|Amount of host physical memory consumed for backing up guest physical memory pages (KB).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.private\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine private memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.shared\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine shared memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.swapped\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine swapped memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.usage.guest\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine guest memory usage (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.usage.host\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine host memory usage (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.usage\[<url>,<uuid>\]|<|<|<|<| |<|Percentage of host physical memory that has been consumed.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.net.if.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Discovery of VMware virtual machine network interfaces.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.net.if.in\[<url>,<uuid>,<instance>,<mode>\]|<|<|<|<| |<|VMware virtual machine network interface input statistics (bytes/packets per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - network interface instance<br>**mode** - bps (default)/pps - bytes/packets per second|<| |vmware.vm.net.if.out\[<url>,<uuid>,<instance>,<mode>\]|<|<|<|<| |<|VMware virtual machine network interface output statistics (bytes/packets per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - network interface instance<br>**mode** - bps (default)/pps - bytes/packets per second|<| |vmware.vm.net.if.usage\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|VMware virtual machine network utilization (combined transmit-rates and receive-rates) during the interval (KBps).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - network interface instance|<| |vmware.vm.perfcounter\[<url>,<uuid>,<path>,<instance>\]|<|<|<|<| |<|VMware virtual machine performance counter value.|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**path** - performance counter path ^**[1](vmware_keys#footnotes)**^<br>**instance** - performance counter instance. Use empty instance for aggregate values (default)|<| |vmware.vm.powerstate\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine power state.|Integer:<br>0 - poweredOff;<br>1 - poweredOn;<br>2 - suspended|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.storage.committed\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine committed storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.storage.readoio\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|Average number of outstanding read requests to the virtual disk during the collection interval.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.totalreadlatency\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|The average time a read from the virtual disk takes (milliseconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.totalwritelatency\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|The average time a write to the virtual disk takes (milliseconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.uncommitted\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine uncommitted storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.storage.unshared\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine unshared storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.storage.writeoio\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|Average number of outstanding write requests to the virtual disk during the collection interval.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.uptime\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine uptime (seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.vfs.dev.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Discovery of VMware virtual machine disk devices.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.vfs.dev.read\[<url>,<uuid>,<instance>,<mode>\]|<|<|<|<| |<|VMware virtual machine disk device read statistics (bytes/operations per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance<br>**mode** - bps (default)/ops - bytes/operations per second|<| |vmware.vm.vfs.dev.write\[<url>,<uuid>,<instance>,<mode>\]|<|<|<|<| |<|VMware virtual machine disk device write statistics (bytes/operations per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance<br>**mode** - bps (default)/ops - bytes/operations per second|<| |vmware.vm.vfs.fs.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Discovery of VMware virtual machine file systems.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|VMware Tools must be installed on the guest virtual machine.| |vmware.vm.vfs.fs.size\[<url>,<uuid>,<fsname>,<mode>\]|<|<|<|<| |<|VMware virtual machine file system statistics (bytes/percentages).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**fsname** - file system name<br>**mode** - total/free/used/pfree/pused|VMware Tools must be installed on the guest virtual machine.| #### アイテムキー この表は [VMware環境](/manual/vm_monitoring) を監視するためのシンプルチェックの詳細を示します。 |Key|<|<|<|<| |-|------|--|------|------| |<|説明|戻り値|パラメータ|コメント| |vmware.cl.perfcounter\[<url>,<id>,<path>,<instance>\]|<|<|<|<| |<|VMware cluster performance counter metrics.|Integer|**url** - VMware service URL<br>**id** - VMware cluster ID<br>**path** - performance counter path<br>**instance** - performance counter instance|`id` can be received from vmware.cluster.discovery\[\] as {\#CLUSTER.ID}| |vmware.cluster.discovery\[<url>\]|<|<|<|<| |<|Discovery of VMware clusters.|JSON object|**url** - VMware service URL|<| |vmware.cluster.status\[<url>, <name>\]|<|<|<|<| |<|VMware cluster status.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**name** - VMware cluster name|<| |vmware.datastore.discovery\[<url>\]|<|<|<|<| |<|Discovery of VMware datastores.|JSON object|**url** - VMware service URL|<| |vmware.datastore.hv.list\[<url>,<datastore>\]|<|<|<|<| |<|List of datastore hypervisors.|JSON object|**url** - VMware service URL<br>**datastore** - datastore name|<| |vmware.datastore.read\[<url>,<datastore>,<mode>\]|<|<|<|<| |<|Amount of time for a read operation from the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - latency (average value, default), maxlatency (maximum value)|<| |vmware.datastore.size\[<url>,<datastore>,<mode>\]|<|<|<|<| |<|VMware datastore space in bytes or in percentage from total.|Integer - for bytes<br>Float - for percentage|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - possible values:<br>total (default), free, pfree (free, percentage), uncommitted|<| |vmware.datastore.write\[<url>,<datastore>,<mode>\]|<|<|<|<| |<|Amount of time for a write operation to the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - latency (average value, default), maxlatency (maximum value)|<| |vmware.dc.discovery\[<url>\]|<|<|<|<| |<|Discovery of VMware datacenters.|JSON object|**url** - VMware service URL|<| |vmware.eventlog\[<url>,<mode>\]|<|<|<|<| |<|VMware event log.|Log|**url** - VMware service URL<br>**mode** - *all* (default), *skip* - skip processing of older data|There must be only one vmware.eventlog\[\] item key per URL.<br><br>See also: [example of filtering](/manual/config/items/preprocessing/examples#filtering_vmware_event_log_records) VMware event log records.| |vmware.fullname\[<url>\]|<|<|<|<| |<|VMware service full name.|String|**url** - VMware service URL|<| |vmware.hv.cluster.name\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor cluster name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.cpu.usage\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor processor usage (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.cpu.usage.perf\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor processor usage as a percentage during the interval.|Float|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.cpu.utilization\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor processor usage as a percentage during the interval, depends on power management or HT.|Float|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.datacenter.name\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor datacenter name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.datastore.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Discovery of VMware hypervisor datastores.|JSON object|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.datastore.list\[<url>,<uuid>\]|<|<|<|<| |<|List of VMware hypervisor datastores.|JSON object|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.datastore.multipath\[<url>,<uuid>,<datastore>,<partitionid>\]|<|<|<|<| |<|Number of available datastore paths.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**datastore** - datastore name<br>**partitionid** - internal ID of physical device from vmware.hv.datastore.discovery|<| |vmware.hv.datastore.read\[<url>,<uuid>,<datastore>,<mode>\]|<|<|<|<| |<|Average amount of time for a read operation from the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**datastore** - datastore name<br>**mode** - latency (default)|<| |vmware.hv.datastore.size\[<url>,<uuid>,<datastore>,<mode>\]|<|<|<|<| |<|VMware datastore space in bytes or in percentage from total.|Integer - for bytes<br>Float - for percentage|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**datastore** - datastore name<br>**mode** - possible values:<br>total (default), free, pfree (free, percentage), uncommitted|<| |vmware.hv.datastore.write\[<url>,<uuid>,<datastore>,<mode>\]|<|<|<|<| |<|Average amount of time for a write operation to the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**datastore** - datastore name<br>**mode** - latency (default)|<| |vmware.hv.discovery\[<url>\]|<|<|<|<| |<|Discovery of VMware hypervisors.|JSON object|**url** - VMware service URL|<| |vmware.hv.fullname\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.cpu.freq\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor processor frequency (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.cpu.model\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor processor model.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.cpu.num\[<url>,<uuid>\]|<|<|<|<| |<|Number of processor cores on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.cpu.threads\[<url>,<uuid>\]|<|<|<|<| |<|Number of processor threads on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.memory\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor total memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.model\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor model.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.uuid\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor BIOS UUID.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.hw.vendor\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor vendor name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.maintenance\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor maintenance status.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|Returns '0' - not in maintenance or '1' - in maintenance| |vmware.hv.memory.size.ballooned\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor ballooned memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.memory.used\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor used memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.network.in\[<url>,<uuid>,<mode>\]|<|<|<|<| |<|VMware hypervisor network input statistics (bytes per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**mode** - bps (default)|<| |vmware.hv.network.out\[<url>,<uuid>,<mode>\]|<|<|<|<| |<|VMware hypervisor network output statistics (bytes per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**mode** - bps (default)|<| |vmware.hv.perfcounter\[<url>,<uuid>,<path>,<instance>\]|<|<|<|<| |<|VMware hypervisor performance counter value.|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**path** - performance counter path ^**[1](vmware_keys#footnotes)**^<br>**instance** - performance counter instance. Use empty instance for aggregate values (default)|<| |vmware.hv.power\[<url>,<uuid>,<max>\]|<|<|<|<| |<|VMware hypervisor power usage (W).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name<br>**max** - maximum allowed power usage|<| |vmware.hv.sensor.health.state\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor health state rollup sensor.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.sensors.get\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor HW vendor state sensors.|JSON|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.status\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor status.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|Uses the host system overall status property.| |vmware.hv.uptime\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor uptime (seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.version\[<url>,<uuid>\]|<|<|<|<| |<|VMware hypervisor version.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.hv.vm.num\[<url>,<uuid>\]|<|<|<|<| |<|Number of virtual machines on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor host name|<| |vmware.version\[<url>\]|<|<|<|<| |<|VMware service version.|String|**url** - VMware service URL|<| |vmware.vm.cluster.name\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.cpu.latency\[<url>,<uuid>\]|<|<|<|<| |<|Percentage of time the virtual machine is unable to run because it is contending for access to the physical CPU(s).|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.cpu.num\[<url>,<uuid>\]|<|<|<|<| |<|Number of processors on VMware virtual machine.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.cpu.readiness\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|Percentage of time that the virtual machine was ready, but could not get scheduled to run on the physical CPU.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - CPU instance|<| |vmware.vm.cpu.ready\[<url>,<uuid>\]|<|<|<|<| |<|Time (in milliseconds) that the virtual machine was ready, but could not get scheduled to run on the physical CPU. CPU ready time is dependent on the number of virtual machines on the host and their CPU loads (%).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.cpu.swapwait\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|Percentage of CPU time spent waiting for swap-in.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - CPU instance|<| |vmware.vm.cpu.usage\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine processor usage (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.cpu.usage.perf\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine processor usage as a percentage during the interval.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.datacenter.name\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine datacenter name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.discovery\[<url>\]|<|<|<|<| |<|Discovery of VMware virtual machines.|JSON object|**url** - VMware service URL|<| |vmware.vm.guest.memory.size.swapped\[<url>,<uuid>\]|<|<|<|<| |<|Amount of guest physical memory that is swapped out to the swap space (KB).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.guest.osuptime\[<url>,<uuid>\]|<|<|<|<| |<|Total time elapsed since the last operating system boot-up (in seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.hv.name\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine hypervisor name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine total memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.ballooned\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine ballooned memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.compressed\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine compressed memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.consumed\[<url>,<uuid>\]|<|<|<|<| |<|Amount of host physical memory consumed for backing up guest physical memory pages (KB).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.private\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine private memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.shared\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine shared memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.swapped\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine swapped memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.usage.guest\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine guest memory usage (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.size.usage.host\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine host memory usage (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.memory.usage\[<url>,<uuid>\]|<|<|<|<| |<|Percentage of host physical memory that has been consumed.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.net.if.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Discovery of VMware virtual machine network interfaces.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.net.if.in\[<url>,<uuid>,<instance>,<mode>\]|<|<|<|<| |<|VMware virtual machine network interface input statistics (bytes/packets per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - network interface instance<br>**mode** - bps (default)/pps - bytes/packets per second|<| |vmware.vm.net.if.out\[<url>,<uuid>,<instance>,<mode>\]|<|<|<|<| |<|VMware virtual machine network interface output statistics (bytes/packets per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - network interface instance<br>**mode** - bps (default)/pps - bytes/packets per second|<| |vmware.vm.net.if.usage\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|VMware virtual machine network utilization (combined transmit-rates and receive-rates) during the interval (KBps).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - network interface instance|<| |vmware.vm.perfcounter\[<url>,<uuid>,<path>,<instance>\]|<|<|<|<| |<|VMware virtual machine performance counter value.|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**path** - performance counter path ^**[1](vmware_keys#footnotes)**^<br>**instance** - performance counter instance. Use empty instance for aggregate values (default)|<| |vmware.vm.powerstate\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine power state.|Integer:<br>0 - poweredOff;<br>1 - poweredOn;<br>2 - suspended|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.storage.committed\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine committed storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.storage.readoio\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|Average number of outstanding read requests to the virtual disk during the collection interval.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.totalreadlatency\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|The average time a read from the virtual disk takes (milliseconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.totalwritelatency\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|The average time a write to the virtual disk takes (milliseconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.uncommitted\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine uncommitted storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.storage.unshared\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine unshared storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.storage.writeoio\[<url>,<uuid>,<instance>\]|<|<|<|<| |<|Average number of outstanding write requests to the virtual disk during the collection interval.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.uptime\[<url>,<uuid>\]|<|<|<|<| |<|VMware virtual machine uptime (seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.vfs.dev.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Discovery of VMware virtual machine disk devices.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|<| |vmware.vm.vfs.dev.read\[<url>,<uuid>,<instance>,<mode>\]|<|<|<|<| |<|VMware virtual machine disk device read statistics (bytes/operations per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance<br>**mode** - bps (default)/ops - bytes/operations per second|<| |vmware.vm.vfs.dev.write\[<url>,<uuid>,<instance>,<mode>\]|<|<|<|<| |<|VMware virtual machine disk device write statistics (bytes/operations per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**instance** - disk device instance<br>**mode** - bps (default)/ops - bytes/operations per second|<| |vmware.vm.vfs.fs.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Discovery of VMware virtual machine file systems.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name|VMware Tools must be installed on the guest virtual machine.| |vmware.vm.vfs.fs.size\[<url>,<uuid>,<fsname>,<mode>\]|<|<|<|<| |<|VMware virtual machine file system statistics (bytes/percentages).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine host name<br>**fsname** - file system name<br>**mode** - total/free/used/pfree/pused|VMware Tools must be installed on the guest virtual machine.| #### Item key The item key to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is net.if.discovery This item is supported since Zabbix agent 2.0. #### アイテムキー [ディスカバリルール](/manual/discovery/low_level_discovery#discovery_rule)で使用するアイテムキーは次のとおりです。 net.if.discovery このアイテムはZabbixエージェント2.0以降でサポートされています。 #### Item key The item key to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is system.cpu.discovery This item is supported since Zabbix agent 2.4. #### アイテムキー [検出ルール](/manual/discovery/low_level_discovery#discovery_rule)で使用するアイテムキーは次のとおりです。 system.cpu.discovery このアイテムは、Zabbixエージェント2.4以降でサポートされています。 #### Item key The item key to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is vfs.dev.discovery This item is supported on Linux platforms only, since Zabbix agent 4.4. You may create discovery rules using this discovery item and: - filter: **{\#DEVNAME} matches `sd[\D]$`** - to discover devices named "sd0", "sd1", "sd2", ... - filter: **{\#DEVTYPE} matches `disk` AND {\#DEVNAME} does not match `^loop.*`** - to discover disk type devices whose name does not start with "loop" #### アイテムキー [ディスカバリルール](/manual/discovery/low_level_discovery#discovery_rule)で使用するアイテムキーは次のとおりです vfs.dev.discovery Zabbixエージェント4.4以降、このアイテムはLinuxプラットフォームでのみサポートされます。 このディスカバリアイテムを使用してディスカバリルールを作成し、次のようなことを行うことができます。 - filter: **{\#DEVNAME} matches `sd[\D]$`** - 名前の付いたデバイスを検出する "sd0", "sd1", "sd2", ... - filter: **{\#DEVTYPE} matches `disk` AND {\#DEVNAME} does not match `^loop.*`** - 名前が*loop*で始まらないディスクタイプのデバイスを検出する #### Item key The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is service.discovery This item is supported since Zabbix Windows agent 3.0. #### アイテムキー [ディスカバリルール](/manual/discovery/low_level_discovery#discovery_rule)で使用するアイテムは service.discovery このアイテムは、ZabbixWindowsエージェント3.0以降でサポートされています。 ### Item key The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is the systemd.unit.discovery ::: noteimportant This [item](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) key is only supported in Zabbix agent 2. ::: This item returns a JSON with information about systemd units, for example: [{ "{#UNIT.NAME}": "mysqld.service", "{#UNIT.DESCRIPTION}": "MySQL Server", "{#UNIT.LOADSTATE}": "loaded", "{#UNIT.ACTIVESTATE}": "active", "{#UNIT.SUBSTATE}": "running", "{#UNIT.FOLLOWED}": "", "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/mysqld_2eservice", "{#UNIT.JOBID}": 0, "{#UNIT.JOBTYPE}": "" "{#UNIT.JOBPATH}": "/", "{#UNIT.UNITFILESTATE}": "enabled" }, { "{#UNIT.NAME}": "systemd-journald.socket", "{#UNIT.DESCRIPTION}": "Journal Socket", "{#UNIT.LOADSTATE}": "loaded", "{#UNIT.ACTIVESTATE}": "active", "{#UNIT.SUBSTATE}": "running", "{#UNIT.FOLLOWED}": "", "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/systemd_2djournald_2esocket", "{#UNIT.JOBID}": 0, "{#UNIT.JOBTYPE}": "", "{#UNIT.JOBPATH}": "/" "{#UNIT.UNITFILESTATE}": "enabled" }] ### アイテムキー [ディスカバリルール](/manual/discovery/low_level_discovery#discovery_rule)で使用するアイテムは systemd.unit.discovery ::: noteimportant この[アイテム](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2)キーは、Zabbixエージェント2でのみサポートされています。 ::: このアイテムはsystemdユニットに関する情報を含むJSONを返します。次に例を示します。 [{ "{#UNIT.NAME}": "mysqld.service", "{#UNIT.DESCRIPTION}": "MySQL Server", "{#UNIT.LOADSTATE}": "loaded", "{#UNIT.ACTIVESTATE}": "active", "{#UNIT.SUBSTATE}": "running", "{#UNIT.FOLLOWED}": "", "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/mysqld_2eservice", "{#UNIT.JOBID}": 0, "{#UNIT.JOBTYPE}": "" "{#UNIT.JOBPATH}": "/", "{#UNIT.UNITFILESTATE}": "enabled" }, { "{#UNIT.NAME}": "systemd-journald.socket", "{#UNIT.DESCRIPTION}": "Journal Socket", "{#UNIT.LOADSTATE}": "loaded", "{#UNIT.ACTIVESTATE}": "active", "{#UNIT.SUBSTATE}": "running", "{#UNIT.FOLLOWED}": "", "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/systemd_2djournald_2esocket", "{#UNIT.JOBID}": 0, "{#UNIT.JOBTYPE}": "", "{#UNIT.JOBPATH}": "/" "{#UNIT.UNITFILESTATE}": "enabled" }] #### Item key The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is the zabbix[host,discovery,interfaces] internal item. This item is supported since Zabbix server 3.4. This item returns a JSON with the description of interfaces, including: - IP address/DNS hostname (depending on the “Connect to” host setting) - Port number - Interface type (Zabbix agent, SNMP, JMX, IPMI) - If it is the default interface or not - If the bulk request feature is enabled - for SNMP interfaces only. For example: [{"{#IF.CONN}":"192.168.3.1","{#IF.IP}":"192.168.3.1","{#IF.DNS}":"","{#IF.PORT}":"10050","{#IF.TYPE}":"AGENT","{#IF.DEFAULT}":1}] With multiple interfaces their records in JSON are ordered by: - Interface type, - Default - the default interface is put before non-default interfaces, - Interface ID (in ascending order). #### アイテムキー [ディスカバリルール](/manual/discovery/low_level_discovery#discovery_rule)で使用するアイテムは以下です。 zabbix[host,discovery,interfaces] 内部アイテムです。 このアイテムはZabbixサーバー3.4以降でサポートされています。 このアイテムは、次のようなインターフェースの説明を含むJSONを返します。 - IPアドレス/DNSホスト名（"接続先"ホスト設定によって異なります） - ポート番号 - インターフェースタイプ (Zabbixエージェント, SNMP, JMX, IPMI) - デフォルトのインターフェースかどうか - バルクリクエスト機能が有効か - SNMPインターフェイスの場合のみ 例: [{"{#IF.CONN}":"192.168.3.1","{#IF.IP}":"192.168.3.1","{#IF.DNS}":"","{#IF.PORT}":"10050","{#IF.TYPE}":"AGENT","{#IF.DEFAULT}":1}] 複数のインターフェースを使用する場合、JSONのレコードは次の順序で並べられます。 - インターフェースタイプ - デフォルト - デフォルトのインターフェイスは、それ以外のインターフェイスの前に配置されます。 - インターフェースID (昇順) #### Item key Unlike with file system and network interface discovery, the item does not necessarily has to have an "snmp.discovery" key - item type of SNMP agent is sufficient. Discovery of SNMP OIDs is supported since Zabbix server/proxy 2.0. To configure the discovery rule, do the following: - Go to: *Configuration* → *Templates* - Click on *Discovery* in the row of an appropriate template  - Click on *Create discovery rule* in the upper right corner of the screen - Fill in the discovery rule form with the required details as in the screenshot below {width="600"} All mandatory input fields are marked with a red asterisk. The OIDs to discover are defined in SNMP OID field in the following format: `discovery[{#MACRO1}, oid1, {#MACRO2}, oid2, …,]` where *{\#MACRO1}*, *{\#MACRO2}* … are valid lld macro names and *oid1*, *oid2*... are OIDs capable of generating meaningful values for these macros. A built-in macro *{\#SNMPINDEX}* containing index of the discovered OID is applied to discovered entities. The discovered entities are grouped by *{\#SNMPINDEX}* macro value. To understand what we mean, let us perform few snmpwalks on our switch: $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifDescr IF-MIB::ifDescr.1 = STRING: WAN IF-MIB::ifDescr.2 = STRING: LAN1 IF-MIB::ifDescr.3 = STRING: LAN2 $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifPhysAddress IF-MIB::ifPhysAddress.1 = STRING: 8:0:27:90:7a:75 IF-MIB::ifPhysAddress.2 = STRING: 8:0:27:90:7a:76 IF-MIB::ifPhysAddress.3 = STRING: 8:0:27:2b:af:9e And set SNMP OID to: `discovery[{#IFDESCR}, ifDescr, {#IFPHYSADDRESS}, ifPhysAddress]` Now this rule will discover entities with {\#IFDESCR} macros set to **WAN**, **LAN1** and **LAN2**, {\#IFPHYSADDRESS} macros set to **8:0:27:90:7a:75**, **8:0:27:90:7a:76**, and **8:0:27:2b:af:9e**, {\#SNMPINDEX} macros set to the discovered OIDs indexes **1**, **2** and **3**: ``` {.java} [ { "{#SNMPINDEX}": "1", "{#IFDESCR}": "WAN", "{#IFPHYSADDRESS}": "8:0:27:90:7a:75" }, { "{#SNMPINDEX}": "2", "{#IFDESCR}": "LAN1", "{#IFPHYSADDRESS}": "8:0:27:90:7a:76" }, { "{#SNMPINDEX}": "3", "{#IFDESCR}": "LAN2", "{#IFPHYSADDRESS}": "8:0:27:2b:af:9e" } ] ``` If an entity does not have the specified OID, then the corresponding macro will be omitted for this entity. For example if we have the following data: ifDescr.1 "Interface #1" ifDescr.2 "Interface #2" ifDescr.4 "Interface #4" ifAlias.1 "eth0" ifAlias.2 "eth1" ifAlias.3 "eth2" ifAlias.5 "eth4" Then in this case SNMP discovery `discovery[{#IFDESCR}, ifDescr, {#IFALIAS}, ifAlias]` will return the following structure: ``` {.java} [ { "{#SNMPINDEX}": 1, "{#IFDESCR}": "Interface #1", "{#IFALIAS}": "eth0" }, { "{#SNMPINDEX}": 2, "{#IFDESCR}": "Interface #2", "{#IFALIAS}": "eth1" }, { "{#SNMPINDEX}": 3, "{#IFALIAS}": "eth2" }, { "{#SNMPINDEX}": 4, "{#IFDESCR}": "Interface #4" }, { "{#SNMPINDEX}": 5, "{#IFALIAS}": "eth4" } ] ``` #### アイテムキー ファイルシステムやネットワークインターフェイスの検出とは異なり、アイテムは必ずしも"snmp.discovery"キーを持っている必要はありません。SNMPエージェントのアイテムタイプで十分です。 SNMP OIDの検出は、Zabbixサーバー/プロキシ2.0以降でサポートされています。 ディスカバリルールを設定するには、次のようにします。 - *設定* → *テンプレート*を開きます - 適当なテンプレート行の*ディスカバリ*をクリックします  - 画面の右上隅にある[ディスカバリルールの作成]をクリックします - 以下のスクリーンショットのように、必要な詳細をディスカバリルールフォームに入力します {width="600"} 必須入力フィールドは、赤いアスタリスクでマークされています。 検出するOIDはSNMP OIDフィールドで次の形式で定義されます：`discovery[{#MACRO1}, oid1, {#MACRO2}, oid2, …,]` ここでの*{\#MACRO1}*, *{\#MACRO2}*…は有効なlldマクロ名であり、 *oid1*, *oid2*...はこれらのマクロに意味のある値を生成できるOIDです。 検出されたOIDのインデックスを含む組み込みマクロ*{\#SNMPINDEX} *が、検出されたエンティティに適用されます。 検出されたエンティティは*{\#SNMPINDEX}*マクロ値によってグループ化されます。 何を意味するのかを理解するために、スイッチでいくつかのsnmpwalkを実行してみましょう。 $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifDescr IF-MIB::ifDescr.1 = STRING: WAN IF-MIB::ifDescr.2 = STRING: LAN1 IF-MIB::ifDescr.3 = STRING: LAN2 $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifPhysAddress IF-MIB::ifPhysAddress.1 = STRING: 8:0:27:90:7a:75 IF-MIB::ifPhysAddress.2 = STRING: 8:0:27:90:7a:76 IF-MIB::ifPhysAddress.3 = STRING: 8:0:27:2b:af:9e そしてSNMP OIDを次のように設定します：`discovery[{#IFDESCR}, ifDescr, {#IFPHYSADDRESS}, ifPhysAddress]` このルールは次のエンティティを検出します。 {\＃IFDESCR}マクロ：**WAN**,**LAN1**,**LAN2** {\＃IFPHYSADDRESS}マクロ：**8:0:27:90:7a:75**, **8:0:27:90:7a:76**, **8:0:27:2b:af:9e** {\＃SNMPINDEX}マクロ：**1**,**2**,**3** ``` {.java} [ { "{#SNMPINDEX}": "1", "{#IFDESCR}": "WAN", "{#IFPHYSADDRESS}": "8:0:27:90:7a:75" }, { "{#SNMPINDEX}": "2", "{#IFDESCR}": "LAN1", "{#IFPHYSADDRESS}": "8:0:27:90:7a:76" }, { "{#SNMPINDEX}": "3", "{#IFDESCR}": "LAN2", "{#IFPHYSADDRESS}": "8:0:27:2b:af:9e" } ] ``` エンティティに指定されたOIDがない場合は、対応するマクロはこのエンティティで省略されます。 たとえば、次のデータがある場合： ifDescr.1 "Interface #1" ifDescr.2 "Interface #2" ifDescr.4 "Interface #4" ifAlias.1 "eth0" ifAlias.2 "eth1" ifAlias.3 "eth2" ifAlias.5 "eth4" この場合、SNMPディスカバリ`discovery[{#IFDESCR}, ifDescr, {#IFALIAS}, ifAlias]`は次の構造を返します。 ``` {.java} [ { "{#SNMPINDEX}": 1, "{#IFDESCR}": "Interface #1", "{#IFALIAS}": "eth0" }, { "{#SNMPINDEX}": 2, "{#IFDESCR}": "Interface #2", "{#IFALIAS}": "eth1" }, { "{#SNMPINDEX}": 3, "{#IFALIAS}": "eth2" }, { "{#SNMPINDEX}": 4, "{#IFDESCR}": "Interface #4" }, { "{#SNMPINDEX}": 5, "{#IFALIAS}": "eth4" } ] ``` #### Item net.tcp.service parameters **ftp** Creates a TCP connection and expects the first 4 characters of the response to be "220 ", then sends "QUIT\\r\\n". Default port 21 is used if not specified. **http** Creates a TCP connection without expecting and sending anything. Default port 80 is used if not specified. **https** Uses (and only works with) libcurl, does not verify the authenticity of the certificate, does not verify the host name in the SSL certificate, only fetches the response header (HEAD request). Default port 443 is used if not specified. **imap** Creates a TCP connection and expects the first 4 characters of the response to be "\* OK", then sends "a1 LOGOUT\\r\\n". Default port 143 is used if not specified. **ldap** Opens a connection to an LDAP server and performs an LDAP search operation with filter set to (objectClass=\*). Expects successful retrieval of the first attribute of the first entry. Default port 389 is used if not specified. **nntp** Creates a TCP connection and expects the first 3 characters of the response to be "200" or "201", then sends "QUIT\\r\\n". Default port 119 is used if not specified. **pop** Creates a TCP connection and expects the first 3 characters of the response to be "+OK", then sends "QUIT\\r\\n". Default port 110 is used if not specified. **smtp** Creates a TCP connection and expects the first 3 characters of the response to be "220", followed by a space, the line ending or a dash. The lines containing a dash belong to a multiline response and the response will be re-read until a line without the dash is received. Then sends "QUIT\\r\\n". Default port 25 is used if not specified. **ssh** Creates a TCP connection. If the connection has been established, both sides exchange an identification string (SSH-major.minor-XXXX), where major and minor are protocol versions and XXXX is a string. Zabbix checks if the string matching the specification is found and then sends back the string "SSH-major.minor-zabbix\_agent\\r\\n" or "0\\n" on mismatch. Default port 22 is used if not specified. **tcp** Creates a TCP connection without expecting and sending anything. Unlike the other checks requires the port parameter to be specified. **telnet** Creates a TCP connection and expects a login prompt (':' at the end). Default port 23 is used if not specified. #### net.tcp.serviceアイテムのパラメータ **ftp** TCP接続を作成し、応答の最初の4文字が"220 "であることを検証して"QUIT\\r\\n"を送信します。 ポートが指定されていない場合はデフォルトのポート21が使用されます。 **http** 特に何もせずTCP接続を作成します。ポートが指定されていない場合はデフォルトのポート80が使用されます。 **https** libcurlを使用し（libcurl のみで動作します）、証明書の信頼性を検証せず、SSL証明書のホスト名を検証せず、応答ヘッダー（HEAD要求）のみを読み出します。 ポートが指定されていない場合はデフォルトポートの443が使用されます。 **imap** TCP接続を作成し、応答の最初の4文字が"\* OK"であることを検証して"a1 LOGOUT\\r\\n"を送信します。ポートが指定されていない場合はデフォルトのポート143が使用されます。 **ldap** LDAPサーバーへの接続を開き、フィルターを(objectClass=\*)に設定してLDAP検索操作を実行して、最初のエントリの最初の属性が正常に取得できることを検証します。ポートが指定されていない場合はデフォルトのポート389が使用されます。 **nntp** TCP接続を作成し、応答の最初の3文字が"200"または"201"であることを検証して"QUIT\\r\\n"を送信します。 ポートが指定されていない場合はデフォルトのポート119が使用されます。 **pop** TCP接続を作成し、応答の最初の3文字が"+OK"であることを検証して"QUIT\\r\\n"を送信します。 ポートが指定されていない場合はデフォルトのポート110が使用されます。 **smtp** TCP接続を作成し、応答の最初の3文字が"220"であり、その後にスペース、行末、またはダッシュが続くことを検証します。 ダッシュを含む行は複数行の応答で、ダッシュのない行が受信されるまで応答が再読み取りされます。 次に"QUIT\\r\\n"を送信します。ポートが指定されていない場合はデフォルトのポート25が使用されます。 **ssh** TCP接続を作成します。 接続が確立されている場合、両側で識別文字列（SSH-major.minor-XXXX）が交換されます。ここでのメジャーとマイナーはプロトコルバージョンであり、XXXXは文字列です。 Zabbixは仕様に一致する文字列が見つかったかどうかを確認し、不一致の場合は文字列"SSH-major.minor-zabbix\_agent\\r\\n"または"0\\n"を送り返します。ポートが指定されていない場合は、デフォルトのポート22が使用されます。 **tcp** 特に何もせずTCP接続を作成します。他のチェックとは異なり、ポート指定必須です。 **telnet** TCP接続を作成し、ログインプロンプト(の最後に':')が返ってくることを検証します。 ポートが指定されていない場合はデフォルトのポート23が使用されます。 #### Item net.udp.service parameters **ntp** Sends an SNTP packet over UDP and validates the response according to [RFC 4330, section 5](http://tools.ietf.org/html/rfc4330#section-5). Default port 123 is used if not specified. #### net.udp.serviceアイテムのパラメータ **ntp** UDPを介してSNTPパケットを送信し、[RFC 4330、セクション5](http://tools.ietf.org/html/rfc4330#section-5)に従って応答を検証します。ポートが指定されていない場合は、デフォルトのポート123が使用されます。 ### Item ::: noteclassic Web items cannot be directly created, updated or deleted via the Zabbix API. ::: The item object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|string|*(readonly)* ID of the item.| |**delay**<br>(required)|string|Update interval of the item. Accepts seconds or a time unit with suffix (30s,1m,2h,1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Optional for Zabbix trapper, dependent items and for Zabbix agent (active) with `mqtt.get` key.| |**hostid**<br>(required)|string|ID of the host or template that the item belongs to.<br><br>For update operations this field is *readonly*.| |**interfaceid**<br>(required)|string|ID of the item's host interface.<br><br>Used only for host items. Not required for Zabbix agent (active), Zabbix internal, Zabbix trapper, calculated, dependent, database monitor and script items. Optional for HTTP agent items.| |**key\_**<br>(required)|string|Item key.| |**name**<br>(required)|string|Name of the item.| |**type**<br>(required)|integer|Type of the item.<br><br>Possible values:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - Simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>9 - Web item;<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - Telnet agent;<br>15 - Calculated;<br>16 - JMX agent;<br>17 - SNMP trap;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script| |**url**<br>(required)|string|URL string, required only for HTTP agent item type. Supports user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**value\_type**<br>(required)|integer|Type of information of the item.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.| |allow\_traps|integer|HTTP agent item field. Allow to populate value as in trapper item type also.<br><br>0 - *(default)* Do not allow to accept incoming data.<br>1 - Allow to accept incoming data.| |authtype|integer|Used only by SSH agent items or HTTP agent items.<br><br>SSH agent authentication method possible values:<br>0 - *(default)* password;<br>1 - public key.<br><br>HTTP agent authentication method possible values:<br>0 - *(default)* none<br>1 - basic<br>2 - NTLM<br>3 - Kerberos| |description|string|Description of the item.| |error|string|*(readonly)* Error text if there are problems updating the item.| |flags|integer|*(readonly)* Origin of the item.<br><br>Possible values:<br>0 - a plain item;<br>4 - a discovered item.| |follow\_redirects|integer|HTTP agent item field. Follow response redirects while pooling data.<br><br>0 - Do not follow redirects.<br>1 - *(default)* Follow redirects.| |headers|object|HTTP agent item field. Object with HTTP(S) request headers, where header name is used as key and header value as value.<br><br>Example:<br>{ "User-Agent": "Zabbix" }| |history|string|A time unit of how long the history data should be stored. Also accepts user macro.<br><br>Default: 90d.| |http\_proxy|string|HTTP agent item field. HTTP(S) proxy connection string.| |inventory\_link|integer|ID of the host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.<br><br>Default: 0.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI items.| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default value:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |lastclock|timestamp|*(readonly)* Time when the item was last updated.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |lastns|integer|*(readonly)* Nanoseconds when the item was last updated.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |lastvalue|string|*(readonly)* Last value of the item.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |logtimefmt|string|Format of the time in log entries. Used only by log items.| |master\_itemid|integer|Master item ID.<br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.<br><br>Required by dependent items.| |output\_format|integer|HTTP agent item field. Should response be converted to JSON.<br><br>0 - *(default)* Store raw.<br>1 - Convert to JSON.| |params|string|Additional parameters depending on the type of the item:<br>- executed script for SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items;<br>- the script for script item.| |parameters|array|Additional parameters for script items. Array of objects with 'name' and 'value' properties, where name must be unique.| |password|string|Password for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br>When used by JMX, username should also be specified together with password or both properties should be left blank.| |post\_type|integer|HTTP agent item field. Type of post data body stored in posts property.<br><br>0 - *(default)* Raw data.<br>2 - JSON data.<br>3 - XML data.| |posts|string|HTTP agent item field. HTTP(S) request body data. Used with post\_type.| |prevvalue|string|*(readonly)* Previous value of the item.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |privatekey|string|Name of the private key file.| |publickey|string|Name of the public key file.| |query\_fields|array|HTTP agent item field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string.| |request\_method|integer|HTTP agent item field. Type of request method.<br><br>0 - *(default)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP agent item field. What part of response should be stored.<br><br>0 - *(default)* Body.<br>1 - Headers.<br>2 - Both body and headers will be stored.<br><br>For request\_method HEAD only 1 is allowed value.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTP agent item field. Public SSL Key file path.| |ssl\_key\_file|string|HTTP agent item field. Private SSL Key file path.| |ssl\_key\_password|string|HTTP agent item field. Password for SSL Key file.| |state|integer|*(readonly)* State of the item.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - not supported.| |status|integer|Status of the item.<br><br>Possible values:<br>0 - *(default)* enabled item;<br>1 - disabled item.| |status\_codes|string|HTTP agent item field. Ranges of required HTTP status codes separated by commas. Also supports user macros as part of comma separated list.<br><br>Example: 200,200-{$M},{$M},200-400| |templateid|string|(readonly) ID of the parent template item.<br><br>*Hint*: Use the `hostid` property to specify the template that the item belongs to.| |timeout|string|Item data polling request timeout. Used for HTTP agent and script items. Supports user macros.<br><br>default: 3s<br>maximum value: 60s| |trapper\_hosts|string|Allowed hosts. Used by trapper items or HTTP agent items.| |trends|string|A time unit of how long the trends data should be stored. Also accepts user macro.<br><br>Default: 365d.| |units|string|Value units.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX, password should also be specified together with username or both properties should be left blank.| |uuid|string|Universal unique identifier, used for linking imported item to already existing ones. Used only for items on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| |valuemapid|string|ID of the associated value map.| |verify\_host|integer|HTTP agent item field. Validate host name in URL is in Common Name field or a Subject Alternate Name field of host certificate.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| |verify\_peer|integer|HTTP agent item field. Validate is host certificate authentic.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| ### item ::: noteclassic Zabbix API を使用して Web アイテムを直接作成、更新、または削除することはできません。 ::: item オブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |itemid|string|*(読取専用)* アイテムID| |**delay**<br>(必須)|string|アイテムの更新間隔。 秒またはサフィックス付きの時間単位 (30s、1m、2h、1d) を受け入れます。<br>オプションで、1 つまたは複数の [カスタム間隔](/manual/config/items/item/custom_intervals) を柔軟な間隔またはスケジューリングとして指定できます。<br>複数の間隔はセミコロンで区切ります。<br>ユーザーマクロを使用できます。 1 つのマクロでフィールド全体を埋める必要があります。 フィールド内の複数のマクロまたはテキストと混合されたマクロはサポートされていません。<br>柔軟な間隔は、スラッシュで区切られた 2 つのマクロとして記述できます (例: `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`)。<br><br>Zabbix トラッパー、依存アイテム、および `mqtt.get` キーを使用した Zabbix エージェント (アクティブ) のオプション。| |**hostid**<br>(required)|string|アイテムが属するホストまたはテンプレートの ID<br><br>更新操作の場合、このフィールドは *読取専用* です。| |**interfaceid**<br>(必須)|string|アイテムのホストインターフェースの ID<br><br>ホスト アイテムにのみ使用されます。 Zabbix エージェント (アクティブ)、Zabbix インターナル、Zabbix トラッパー、計算、依存、データベース モニター、およびスクリプト アイテムには必要ありません。 HTTP エージェント アイテムのオプションです。| |**key\_**<br>(required)|string|アイテムキー| |**name**<br>(required)|string|アイテム名| |**type**<br>(required)|integer|アイテムのタイプ<br><br>使用可能な値:<br>0 - Zabbix エージェント<br>2 - Zabbix トラッパー<br>3 - シンプル チェック<br>5 - Zabbix インターナル<br>7 - Zabbix エージェント (アクティブ)<br>9 - Web アイテム<br>10 - 外部チェック<br>11 - データベース監視<br>12 - IPMI エージェント<br>13 - SSH エージェント<br> 14 - Telnet エージェント<br>15 - 計算済み<br>16 - JMX エージェント<br>17 - SNMP トラップ<br>18 - 依存アイテム<br>19 - HTTP エージェント<br>20 - SNMP エージェント<br>21 - スクリプト| |**url**<br>(required)|string|URL 文字列。HTTP エージェント アイテム タイプにのみ必要です。 ユーザー マクロ{HOST.IP}、{HOST.CONN}、{HOST.DNS}、{HOST.HOST}、{HOST.NAME}、{ITEM.ID}、{ITEM.KEY} をサポートします。| |**value\_type**<br>(必須)|integer|アイテムの情報タイプ<br><br>使用可能な値:<br>0 - 浮動小数点数<br>1 - キャラクター<br>2 - ログ<br>3 - 符号なしの数値<br>4 - テキスト| |allow\_traps|integer|HTTP エージェントアイテムフィールド。 トラッパー アイテム タイプと同様に、値の入力を許可します。<br><br>0 - *(デフォルト)* 着信データの受け入れを許可しません。<br>1 - 着信データの受け入れを許可します。| |authtype|integer|SSH エージェント アイテムまたは HTTP エージェント アイテムでのみ使用されます。<br><br>SSH エージェント認証方法の使用可能な値:<br>0 - *(デフォルト)* パスワード<br>1 - 公開鍵<br><br> HTTP エージェント認証方式の使用可能な値:<br>0 - *(デフォルト)* なし<br>1 - Basic<br>2 - NTLM<br>3 - Kerberos| |description|string|アイテムの説明| |error|string|*(読取専用)* アイテムの更新に問題がある場合のエラー テキスト| |flags|integer|*(読取専用)* アイテムの起源<br><br>使用可能な値:<br>0 - プレーンなアイテム<br>4 - 発見されたアイテム| |follow\_redirects|integer|HTTP エージェントアイテムフィールド。 データのプール中に応答リダイレクトに従うか<br><br>0 - リダイレクトに従いません<br>1 - *(デフォルト)* リダイレクトに従います| |headers|object|HTTP エージェントアイテムフィールド。 ヘッダー名がキーとして使用され、ヘッダー値が値として使用される HTTP(S) リクエスト ヘッダーを持つオブジェクト。<br><br>例:<br>{ "User-Agent": "Zabbix" }| |history|string|履歴データを保存する時間の単位。 ユーザー マクロも受け入れます。<br><br>デフォルト: 90d| |http\_proxy|string|HTTP エージェントアイテムフィールド。 HTTP(S) プロキシ接続文字列。| |inventory\_link|integer|アイテムによって入力されるホストインベントリフィールドID<br><br>サポートされているホストインベントリフィールドのリストについては、[ホスト インベントリ ページ](/manual/api/reference/host/object#host_inventory) を参照してください。 <br><br>デフォルト: 0。| |ipmi\_sensor|string|IPMI センサー。 IPMI アイテムでのみ使用されます| |jmx\_endpoint|string|JMX エージェントのカスタム接続文字列。<br><br>デフォルト値:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |lastclock|timestamp|*(読取専用)* アイテムが最後に更新された時刻。<br><br>デフォルトでは、過去 24 時間以内の値のみが表示されます。 *[管理 → 一般設定](/manual/web_interface/frontend_sections/administration/general#gui)* メニュー セクションの *データの保存期間*パラメータ値を変更することで、この期間を延長できます。| |lastns|integer|*(読取専用)* アイテムが最後に更新されたときのナノ秒<br><br>デフォルトでは過去 24 時間以内の値のみが表示されます。 *[管理 → 一般設定](/manual/web_interface/frontend_sections/administration/general#gui)* メニュー セクションの *データの保存期間*パラメータ値を変更することで、この期間を延長できます。| |lastvalue|string|*(読取専用)*アイテムの最後の値<br><br>デフォルトでは過去 24 時間以内の値のみが表示されます。 *[管理 → 一般設定](/manual/web_interface/frontend_sections/administration/general#gui)* メニュー セクションの *データの保存期間*パラメータ値を変更することで、この期間を延長できます。| |logtimefmt|string|ログ エントリの時刻形式。 ログアイテムでのみ使用されます。| |master\_itemid|integer|マスター アイテム ID<br>最大 3 つの従属アイテムの再帰と 最大29999 の従属アイテムが許可されます<br><br>従属アイテムに必要です| |output\_format|integer|HTTP エージェントアイテムフィールド。 レスポンスを JSON に変換する必要があります。<br><br>0 - *(デフォルト)* そのまま保存します<br>1 - JSON に変換します| |params|string|アイテムのタイプに応じた追加パラメータ:<br>- SSH および Telnet アイテムの実行スクリプト<br>- データベース監視アイテムの SQL クエリ<br>- 計算アイテムの式<br>- スクリプトのスクリプト アイテム| |parameters|array|スクリプトアイテムの追加パラメーター。 'name' および 'value' プロパティを持つオブジェクトの配列。name は一意である必要があります| |password|string|認証用のパスワード。 簡易チェック、SSH、Telnet、データベース監視、JMX、HTTPエージェントのアイテムで使用| |post\_type|integer|HTTP エージェントアイテムフィールド。 posts プロパティに格納される投稿データ本体のタイプ。<br><br>0 - *(デフォルト)* 生データ。<br>2 - JSON データ。<br>3 - XML データ。| |posts|string|HTTP エージェントアイテムフィールド。 HTTP(S) リクエストの本文データ。 post\_type で使用します。| |prevvalue|string|*(読取専用)* アイテムの以前の値<br><br>デフォルトでは過去 24 時間以内の値のみが表示されます。 *[管理 → 一般設定](/manual/web_interface/frontend_sections/administration/general#gui)* メニュー セクションの *データの保存期間*パラメータ値を変更することで、この期間を延長できます。| |privatekey|string|秘密鍵ファイル名| |publickey|string|公開鍵ファイル名| |query\_fields|array|HTTP エージェントアイテムフィールド。 クエリ パラメータ。 'キー':'値'のペアを持つオブジェクトの配列。値は空の文字列にすることができます。| |request\_method|integer|HTTP エージェントアイテムフィールド。 リクエスト メソッドのタイプ。<br><br>0 - *(デフォルト)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP エージェントアイテムフィールド。 レスポンスのどの部分を保存するか。<br><br>0 - *(デフォルト)* 本文<br>1 - ヘッダー<br>2 - 本文とヘッダーの両方<br><br>request\_method HEAD の場合、許可される値は 1 のみ| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTP エージェントアイテムフィールド。 公開 SSL キーファイル パス| |ssl\_key\_file|string|HTTP エージェントアイテムフィールド。 プライベート SSL キーファイル パス| |ssl\_key\_password|string|HTTP エージェントアイテムフィールド。 SSL キー ファイルのパスワード| |state|integer|*(読取専用)* アイテムの状態<br><br>使用可能な値:<br>0 - *(デフォルト)* 通常<br>1 - サポートされていません| |status|integer|アイテムのステータス<br><br>使用可能な値:<br>0 - *(デフォルト)* 有効なアイテム<br>1 - 無効なアイテム| |status\_codes|string|HTTP エージェントアイテムフィールド。 コンマで区切られた必須の HTTP ステータス コードの範囲。 コンマ区切りリストの一部としてユーザー マクロもサポートします。<br><br>例: 200,200-{$M},{$M},200-400| |templateid|string|(読取専用) 親テンプレート アイテムの ID。<br><br>*ヒント*: `hostid` プロパティを使用して、アイテムが属するテンプレートを指定します。| |timeout|string|アイテム データ ポーリング リクエストのタイムアウト。 HTTP エージェントおよびスクリプト アイテムに使用されます。 ユーザー マクロをサポートします。<br><br>デフォルト: 3 秒<br>最大値: 60 秒| |trapper\_hosts|string|許可されたホスト。 トラッパー アイテムまたは HTTP エージェント アイテムで使用されます。| |trends|string|トレンド データを保存する時間の単位。 ユーザー マクロも受け入れます。<br><br>デフォルト: 365d| |units|string|値の単位| |username|string|認証用のユーザー名。 簡易チェック、SSH、Telnet、データベース監視、JMX、HTTPエージェントのアイテムで使用<br><br>SSH、Telnetのアイテムで必須<br>JMX で使用する場合、パスワードもユーザー名と一緒に指定するか、両方のプロパティを空白のままにする必要があります。| |uuid|string|インポートされたアイテムを既存のアイテムにリンクするために使用されるユニバーサル一意識別子。 テンプレートのアイテムにのみ使用されます。 指定されていない場合は自動生成されます。<br><br>更新操作の場合、このフィールドは *読取専用* です。| |valuemapid|string|関連付けられた値マップID| |verify\_host|integer|HTTP エージェントアイテムフィールド。 URL のホスト名がホスト証明書の Common Name フィールドまたは Subject Alternate Name フィールドにあることを検証します。<br><br>0 - *(デフォルト)* 検証しません。<br>1 - 検証します。| |verify\_peer|integer|HTTP エージェントアイテムフィールド。 検証はホスト証明書の認証です。<br><br>0 - *(デフォルト)* 検証しません。<br>1 - 検証します。| ### Item preprocessing The item preprocessing object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |**type**<br>(required)|integer|The preprocessing option type.<br><br>Possible values:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<br>27 - XML to JSON.| |**params**<br>(required)|string|Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n) character.| |**error\_handler**<br>(required)|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.| |**error\_handler\_params**<br>(required)|string|Error handler parameters. Used with `error_handler`.<br><br>Must be empty, if `error_handler` is 0 or 1.<br>Can be empty if, `error_handler` is 2.<br>Cannot be empty, if `error_handler` is 3.| The following parameters and error handlers are supported for each preprocessing type. |Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers| |------------------|----|-----------|-----------|-----------|------------------------| |1|Custom multiplier|number^1,\ 6^|<|<|0, 1, 2, 3| |2|Right trim|list of characters^2^|<|<|<| |3|Left trim|list of characters^2^|<|<|<| |4|Trim|list of characters^2^|<|<|<| |5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |6|Boolean to decimal|<|<|<|0, 1, 2, 3| |7|Octal to decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3| |9|Simple change|<|<|<|0, 1, 2, 3| |10|Change per second|<|<|<|0, 1, 2, 3| |11|XML XPath|path^4^|<|<|0, 1, 2, 3| |12|JSONPath|path^4^|<|<|0, 1, 2, 3| |13|In range|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^4^|<|<|0, 1, 2, 3| |18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Discard unchanged|<|<|<|<| |20|Discard unchanged with heartbeat|seconds^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Prometheus pattern|pattern^6,\ 7^|output^6,\ 8^|<|0, 1, 2, 3| |23|Prometheus to JSON|pattern^6,\ 7^|<|<|0, 1, 2, 3| |24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3| |25|Replace|search string^2^|replacement^2^|<|<| |26|Check unsupported|<|<|<|1, 2, 3| |27|XML to JOSN|<|<|<|0, 1, 2, 3| ^1^ integer or floating-point number\ ^2^ string\ ^3^ regular expression\ ^4^ JSONPath or XML XPath\ ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)\ ^6^ user macro\ ^7^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro.\ ^8^ Prometheus output following the syntax: `<label name>`. ### Item preprocessing The item preprocessing object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |**type**<br>(required)|integer|The preprocessing option type.<br><br>Possible values:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<br>27 - XML to JSON.| |**params**<br>(required)|string|Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n) character.| |**error\_handler**<br>(required)|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.| |**error\_handler\_params**<br>(required)|string|Error handler parameters. Used with `error_handler`.<br><br>Must be empty, if `error_handler` is 0 or 1.<br>Can be empty if, `error_handler` is 2.<br>Cannot be empty, if `error_handler` is 3.| The following parameters and error handlers are supported for each preprocessing type. |Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers| |------------------|----|-----------|-----------|-----------|------------------------| |1|Custom multiplier|number^1,\ 6^|<|<|0, 1, 2, 3| |2|Right trim|list of characters^2^|<|<|<| |3|Left trim|list of characters^2^|<|<|<| |4|Trim|list of characters^2^|<|<|<| |5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |6|Boolean to decimal|<|<|<|0, 1, 2, 3| |7|Octal to decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3| |9|Simple change|<|<|<|0, 1, 2, 3| |10|Change per second|<|<|<|0, 1, 2, 3| |11|XML XPath|path^4^|<|<|0, 1, 2, 3| |12|JSONPath|path^4^|<|<|0, 1, 2, 3| |13|In range|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^4^|<|<|0, 1, 2, 3| |18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Discard unchanged|<|<|<|<| |20|Discard unchanged with heartbeat|seconds^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Prometheus pattern|pattern^6,\ 7^|output^6,\ 8^|<|0, 1, 2, 3| |23|Prometheus to JSON|pattern^6,\ 7^|<|<|0, 1, 2, 3| |24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3| |25|Replace|search string^2^|replacement^2^|<|<| |26|Check unsupported|<|<|<|1, 2, 3| |27|XML to JOSN|<|<|<|0, 1, 2, 3| ^1^ integer or floating-point number\ ^2^ string\ ^3^ regular expression\ ^4^ JSONPath or XML XPath\ ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)\ ^6^ user macro\ ^7^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro.\ ^8^ Prometheus output following the syntax: `<label name>`. # itemprototype.create # itemprototype.create # itemprototype.delete # itemprototype.delete # itemprototype.get # itemprototype.get ### Item prototype preprocessing The item prototype preprocessing object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |**type**<br>(required)|integer|The preprocessing option type.<br><br>Possible values:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<br>27 - XML to JSON.| |**params**<br>(required)|string|Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n) character.| |**error\_handler**<br>(required)|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.| |**error\_handler\_params**<br>(required)|string|Error handler parameters. Used with `error_handler`.<br><br>Must be empty, if `error_handler` is 0 or 1.<br>Can be empty if, `error_handler` is 2.<br>Cannot be empty, if `error_handler` is 3.| The following parameters and error handlers are supported for each preprocessing type. |Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers| |------------------|----|-----------|-----------|-----------|------------------------| |1|Custom multiplier|number^1,\ 6^|<|<|0, 1, 2, 3| |2|Right trim|list of characters^2^|<|<|<| |3|Left trim|list of characters^2^|<|<|<| |4|Trim|list of characters^2^|<|<|<| |5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |6|Boolean to decimal|<|<|<|0, 1, 2, 3| |7|Octal to decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3| |9|Simple change|<|<|<|0, 1, 2, 3| |10|Change per second|<|<|<|0, 1, 2, 3| |11|XML XPath|path^4^|<|<|0, 1, 2, 3| |12|JSONPath|path^4^|<|<|0, 1, 2, 3| |13|In range|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^4^|<|<|0, 1, 2, 3| |18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Discard unchanged|<|<|<|<| |20|Discard unchanged with heartbeat|seconds^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Prometheus pattern|pattern^6,\ 7^|output^6,\ 8^|<|0, 1, 2, 3| |23|Prometheus to JSON|pattern^6,\ 7^|<|<|0, 1, 2, 3| |24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3| |25|Replace|search string^2^|replacement^2^|<|<| |26|Check unsupported|<|<|<|1, 2, 3| |27|XML to JSON|<|<|<|0, 1, 2, 3| ^1^ integer or floating-point number\ ^2^ string\ ^3^ regular expression\ ^4^ JSONPath or XML XPath\ ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)\ ^6^ user macro, LLD macro\ ^7^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro or LLD macro.\ ^8^ Prometheus output following the syntax: `<label name>`. ### Item prototype preprocessing The item prototype preprocessing object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |**type**<br>(required)|integer|The preprocessing option type.<br><br>Possible values:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<br>27 - XML to JSON.| |**params**<br>(required)|string|Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n) character.| |**error\_handler**<br>(required)|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.| |**error\_handler\_params**<br>(required)|string|Error handler parameters. Used with `error_handler`.<br><br>Must be empty, if `error_handler` is 0 or 1.<br>Can be empty if, `error_handler` is 2.<br>Cannot be empty, if `error_handler` is 3.| The following parameters and error handlers are supported for each preprocessing type. |Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers| |------------------|----|-----------|-----------|-----------|------------------------| |1|Custom multiplier|number^1,\ 6^|<|<|0, 1, 2, 3| |2|Right trim|list of characters^2^|<|<|<| |3|Left trim|list of characters^2^|<|<|<| |4|Trim|list of characters^2^|<|<|<| |5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |6|Boolean to decimal|<|<|<|0, 1, 2, 3| |7|Octal to decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3| |9|Simple change|<|<|<|0, 1, 2, 3| |10|Change per second|<|<|<|0, 1, 2, 3| |11|XML XPath|path^4^|<|<|0, 1, 2, 3| |12|JSONPath|path^4^|<|<|0, 1, 2, 3| |13|In range|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^4^|<|<|0, 1, 2, 3| |18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Discard unchanged|<|<|<|<| |20|Discard unchanged with heartbeat|seconds^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Prometheus pattern|pattern^6,\ 7^|output^6,\ 8^|<|0, 1, 2, 3| |23|Prometheus to JSON|pattern^6,\ 7^|<|<|0, 1, 2, 3| |24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3| |25|Replace|search string^2^|replacement^2^|<|<| |26|Check unsupported|<|<|<|1, 2, 3| |27|XML to JSON|<|<|<|0, 1, 2, 3| ^1^ integer or floating-point number\ ^2^ string\ ^3^ regular expression\ ^4^ JSONPath or XML XPath\ ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)\ ^6^ user macro, LLD macro\ ^7^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro or LLD macro.\ ^8^ Prometheus output following the syntax: `<label name>`. #### Item prototypes The following screenshot illustrates how we can use these macros in item prototypes:  Again, creating as many item prototypes as needed:  #### アイテムプロトタイプ 次のスクリーンショットは、アイテムのプロトタイプでこれらのマクロを使用する方法を示しています。  繰り返して必要な数のアイテムのプロトタイプを作成します。  ### Item prototype tag The item prototype tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Item prototype tag name.| |value|string|Item prototype tag value.| ### Item prototype tag item prototype tagオブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**tag**<br>(必須)|string|アイテムプロトタイプタグ名| |value|string|アイテムプロトタイプタグ値| ### Item prototype The item prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|string|*(readonly)* ID of the item prototype.| |**delay**<br>(required)|string|Update interval of the item prototype. Accepts seconds or a time unit with suffix (30s,1m,2h,1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros and LLD macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Optional for Zabbix trapper, dependent items and for Zabbix agent (active) with `mqtt.get` key.| |**hostid**<br>(required)|string|ID of the host that the item prototype belongs to.<br><br>For update operations this field is *readonly*.| |**ruleid**<br>(required)|string|ID of the LLD rule that the item belongs to.<br><br>For update operations this field is *readonly*.| |**interfaceid**<br>(required)|string|ID of the item prototype's host interface. Used only for host item prototypes.<br><br>Not required for Zabbix agent (active), Zabbix internal, Zabbix trapper, calculated, dependent, database monitor and script item prototypes. Optional for HTTP agent item prototypes.| |**key\_**<br>(required)|string|Item prototype key.| |**name**<br>(required)|string|Name of the item prototype.| |**type**<br>(required)|integer|Type of the item prototype.<br><br>Possible values:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>10 - external check;<br>11 - database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>15 - calculated;<br>16 - JMX agent;<br>17 - SNMP trap;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script.| |**url**<br>(required)|string|URL string required only for HTTP agent item prototypes. Supports LLD macros, user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**value\_type**<br>(required)|integer|Type of information of the item prototype.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.| |allow\_traps|integer|HTTP agent item prototype field. Allow to populate value as in trapper item type also.<br><br>0 - *(default)* Do not allow to accept incoming data.<br>1 - Allow to accept incoming data.| |authtype|integer|Used only by SSH agent item prototypes or HTTP agent item prototypes.<br><br>SSH agent authentication method possible values:<br>0 - *(default)* password;<br>1 - public key.<br><br>HTTP agent authentication method possible values:<br>0 - *(default)* none<br>1 - basic<br>2 - NTLM<br>3 - Kerberos| |description|string|Description of the item prototype.| |follow\_redirects|integer|HTTP agent item prototype field. Follow response redirects while pooling data.<br><br>0 - Do not follow redirects.<br>1 - *(default)* Follow redirects.| |headers|object|HTTP agent item prototype field. Object with HTTP(S) request headers, where header name is used as key and header value as value.<br><br>Example:<br>{ "User-Agent": "Zabbix" }| |history|string|A time unit of how long the history data should be stored. Also accepts user macro and LLD macro.<br><br>Default: 90d.| |http\_proxy|string|HTTP agent item prototype field. HTTP(S) proxy connection string.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI item prototypes.| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default value:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |logtimefmt|string|Format of the time in log entries. Used only by log item prototypes.| |master\_itemid|integer|Master item ID.<br>Recursion up to 3 dependent items and item prototypes and maximum count of dependent items and item prototypes equal to 29999 are allowed.<br><br>Required by Dependent items.| |output\_format|integer|HTTP agent item prototype field. Should response be converted to JSON.<br><br>0 - *(default)* Store raw.<br>1 - Convert to JSON.| |params|string|Additional parameters depending on the type of the item prototype:<br>- executed script for SSH and Telnet item prototypes;<br>- SQL query for database monitor item prototypes;<br>- formula for calculated item prototypes.| |parameters|array|Additional parameters for script item prototypes. Array of objects with 'name' and 'value' properties, where name must be unique.| |password|string|Password for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent item prototypes.| |post\_type|integer|HTTP agent item prototype field. Type of post data body stored in posts property.<br><br>0 - *(default)* Raw data.<br>2 - JSON data.<br>3 - XML data.| |posts|string|HTTP agent item prototype field. HTTP(S) request body data. Used with post\_type.| |privatekey|string|Name of the private key file.| |publickey|string|Name of the public key file.| |query\_fields|array|HTTP agent item prototype field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string.| |request\_method|integer|HTTP agent item prototype field. Type of request method.<br><br>0 - *(default)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP agent item prototype field. What part of response should be stored.<br><br>0 - *(default)* Body.<br>1 - Headers.<br>2 - Both body and headers will be stored.<br><br>For request\_method HEAD only 1 is allowed value.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTP agent item prototype field. Public SSL Key file path.| |ssl\_key\_file|string|HTTP agent item prototype field. Private SSL Key file path.| |ssl\_key\_password|string|HTTP agent item prototype field. Password for SSL Key file.| |status|integer|Status of the item prototype.<br><br>Possible values:<br>0 - *(default)* enabled item prototype;<br>1 - disabled item prototype;<br>3 - unsupported item prototype.| |status\_codes|string|HTTP agent item prototype field. Ranges of required HTTP status codes separated by commas. Also supports user macros or LLD macros as part of comma separated list.<br><br>Example: 200,200-{$M},{$M},200-400| |templateid|string|(readonly) ID of the parent template item prototype.| |timeout|string|Item data polling request timeout. Used for HTTP agent and script item prototypes. Supports user macros and LLD macros.<br><br>default: 3s<br>maximum value: 60s| |trapper\_hosts|string|Allowed hosts. Used by trapper item prototypes or HTTP item prototypes.| |trends|string|A time unit of how long the trends data should be stored. Also accepts user macro and LLD macro.<br><br>Default: 365d.| |units|string|Value units.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent item prototypes.<br><br>Required by SSH and Telnet item prototypes.| |uuid|string|Universal unique identifier, used for linking imported item prototypes to already existing ones. Used only for item prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| |valuemapid|string|ID of the associated value map.| |verify\_host|integer|HTTP agent item prototype field. Validate host name in URL is in Common Name field or a Subject Alternate Name field of host certificate.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.<br>| |verify\_peer|integer|HTTP agent item prototype field. Validate is host certificate authentic.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| |discover|integer|Item prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new items will be discovered;<br>1 - new items will not be discovered and existing items will be marked as lost.| ### Item prototype item prototype オブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |itemid|string|*(読取専用)* アイテムプロトタイプID| |**delay**<br>(必須)|string|アイテムプロトタイプの更新間隔。 秒またはサフィックス付きの時間単位 (30s、1m、2h、1d) を受け入れます。<br>オプションで、1 つまたは複数の [カスタム間隔](/manual/config/items/item/custom_intervals) を柔軟な間隔またはスケジューリングとして指定できます。<br>複数の間隔はセミコロンで区切ります。<br>ユーザーマクロを使用できます。 1 つのマクロでフィールド全体を埋める必要があります。 フィールド内の複数のマクロまたはテキストと混合されたマクロはサポートされていません。<br>柔軟な間隔は、スラッシュで区切られた 2 つのマクロとして記述できます (例: `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`)。<br><br>Zabbix トラッパー、依存アイテム、および `mqtt.get` キーを使用した Zabbix エージェント (アクティブ) のオプション。| |**hostid**<br>(required)|string|アイテムプロトタイプが属するホストまたはテンプレートの ID<br><br>更新操作の場合、このフィールドは *読取専用* です。| |**ruleid**<br>(required)|string|アイテムが属する LLD ルールの ID。<br><br>更新操作の場合、このフィールドは *読取専用* です。| |**interfaceid**<br>(必須)|string|アイテムプロトタイプのホストインターフェースの ID<br><br>ホスト アイテムプロトタイプにのみ使用されます。 Zabbix エージェント (アクティブ)、Zabbix インターナル、Zabbix トラッパー、計算、依存、データベース モニター、およびスクリプト アイテムには必要ありません。 HTTP エージェント アイテムのオプションです。| |**key\_**<br>(required)|string|アイテムプロトタイプキー| |**name**<br>(required)|string|アイテムプロトタイプ名| ||**type**<br>(required)|integer|アイテムプロトタイプのタイプ<br><br>使用可能な値:<br>0 - Zabbix エージェント<br>2 - Zabbix トラッパー<br>3 - シンプル チェック<br>5 - Zabbix インターナル<br>7 - Zabbix エージェント (アクティブ)<br>9 - Web アイテム<br>10 - 外部チェック<br>11 - データベース監視<br>12 - IPMI エージェント<br>13 - SSH エージェント<br> 14 - Telnet エージェント<br>15 - 計算済み<br>16 - JMX エージェント<br>17 - SNMP トラップ<br>18 - 依存アイテム<br>19 - HTTP エージェント<br>20 - SNMP エージェント<br>21 - スクリプト| |**url**<br>(required)|string|URL 文字列。HTTP エージェント アイテムプロトタイプ タイプにのみ必要です。 LLDマクロとユーザー マクロ{HOST.IP}、{HOST.CONN}、{HOST.DNS}、{HOST.HOST}、{HOST.NAME}、{ITEM.ID}、{ITEM.KEY} をサポートします。| |**value\_type**<br>(必須)|integer|アイテムプロトタイプの情報タイプ<br><br>使用可能な値:<br>0 - 浮動小数点数<br>1 - キャラクター<br>2 - ログ<br>3 - 符号なしの数値<br>4 - テキスト| |allow\_traps|integer|HTTP エージェント項目フィールド。 トラッパー アイテム タイプと同様に、値の入力を許可します。<br><br>0 - *(デフォルト)* 着信データの受け入れを許可しません。<br>1 - 着信データの受け入れを許可します。| |authtype|integer|SSH エージェント アイテムまたは HTTP エージェント アイテムでのみ使用されます。<br><br>SSH エージェント認証方法の使用可能な値:<br>0 - *(デフォルト)* パスワード<br>1 - 公開鍵<br><br> HTTP エージェント認証方式の使用可能な値:<br>0 - *(デフォルト)* なし<br>1 - Basic<br>2 - NTLM<br>3 - Kerberos| |description|string|アイテムプロトタイプの説明| |follow\_redirects|integer|HTTP エージェント アイテム プロトタイプ フィールド。 データのプール中に応答リダイレクトに従うか<br><br>0 - リダイレクトに従いません<br>1 - *(デフォルト)* リダイレクトに従います| |headers|object|HTTP エージェント アイテム プロトタイプ フィールド。 ヘッダー名がキーとして使用され、ヘッダー値が値として使用される、HTTP(S) 要求ヘッダーを持つオブジェクト。<br><br>例:<br>{ "User-Agent": "Zabbix" }| |history|string|履歴データを保存する時間の単位。 ユーザー マクロとLLDマクロを受け入れます。<br><br>デフォルト: 90d| |http\_proxy|string|HTTP エージェント アイテム プロトタイプ フィールド。 HTTP(S) プロキシ接続文字列。| |ipmi\_sensor|string|IPMI センサー。 IPMI アイテムプロトタイプでのみ使用されます| |jmx\_endpoint|string|JMX エージェントのカスタム接続文字列。<br><br>デフォルト値:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |logtimefmt|string|ログ エントリの時刻形式。 ログアイテムプロトタイプでのみ使用されます。| |master\_itemid|integer|マスター アイテム ID<br>最大 3 つの従属アイテムプロトタイプの再帰と 最大29999 の従属アイテムプロトタイプが許可されます<br><br>従属アイテムに必要です| |output\_format|integer|HTTP エージェントアイテムプロトタイプフィールド。 レスポンスを JSON に変換する必要があります。<br><br>0 - *(デフォルト)* そのまま保存します<br>1 - JSON に変換します| |params|string|アイテムプロトタイプのタイプに応じた追加パラメータ:<br>- SSH および Telnet アイテムプロトタイプの実行スクリプト<br>- データベース監視アイテムプロトタイプの SQL クエリ<br>- 計算アイテムプロトタイプの式<br>- スクリプトのスクリプト アイテムプロトタイプ| |parameters|array|スクリプトアイテムプロトタイプの追加パラメーター。 'name' および 'value' プロパティを持つオブジェクトの配列。name は一意である必要があります| |password|string|認証用のパスワード。 簡易チェック、SSH、Telnet、データベース監視、JMX、HTTPエージェントのアイテムプロトタイプで使用| |post\_type|integer|HTTP エージェントアイテムプロトタイプフィールド。 posts プロパティに格納される投稿データ本体のタイプ。<br><br>0 - *(デフォルト)* 生データ。<br>2 - JSON データ。<br>3 - XML データ。| |posts|string|HTTP エージェントアイテムプロトタイプフィールド。 HTTP(S) リクエストの本文データ。 post\_type で使用します。| |privatekey|string|秘密鍵ファイル名| |publickey|string|公開鍵ファイル名| |query\_fields|array|HTTP エージェントアイテムプロトタイプフィールド。 クエリ パラメータ。 'キー':'値'のペアを持つオブジェクトの配列。値は空の文字列にすることができます。| |request\_method|integer|HTTP エージェントアイテムプロトタイプフィールド。 リクエスト メソッドのタイプ。<br><br>0 - *(デフォルト)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP エージェントアイテムプロトタイプフィールド。 レスポンスのどの部分を保存するか。<br><br>0 - *(デフォルト)* 本文<br>1 - ヘッダー<br>2 - 本文とヘッダーの両方<br><br>request\_method HEAD の場合、許可される値は 1 のみ| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTP エージェントアイテムプロトタイプフィールド。 公開 SSL キーファイル パス| |ssl\_key\_file|string|HTTP エージェントアイテムプロトタイプフィールド。 プライベート SSL キーファイル パス| |ssl\_key\_password|string|HTTP エージェントアイテムプロトタイプフィールド。 SSL キー ファイルのパスワード| |status|integer|アイテムプロトタイプのステータス<br><br>使用可能な値:<br>0 - *(デフォルト)* 有効なアイテムプロトタイプ<br>1 - 無効なアイテムプロトタイプ<br>3 - サポートされていないアイテムプロトタイプ| |status\_codes|string|HTTP エージェントアイテムプロトタイプフィールド。 コンマで区切られた必須の HTTP ステータス コードの範囲。 コンマ区切りリストの一部としてユーザー マクロとLLDマクロもサポートします。<br><br>例: 200,200-{$M},{$M},200-400| |templateid|string|(読取専用) 親テンプレート アイテムプロトタイプの ID| |timeout|string|アイテム データ ポーリング リクエストのタイムアウト。 HTTP エージェントおよびスクリプト アイテムプロトタイプに使用されます。 ユーザー マクロとLLDマクロをサポートします。<br><br>デフォルト: 3 秒<br>最大値: 60 秒| |trapper\_hosts|string|許可されたホスト。 トラッパー アイテムプロトタイプまたは HTTP エージェント アイテムプロトタイプで使用されます。| |trends|string|トレンド データを保存する時間の単位。 ユーザー マクロとLLDマクロも受け入れます。<br><br>デフォルト: 365d| |units|string|値の単位| |username|string|認証用のユーザー名。 簡易チェック、SSH、Telnet、データベース監視、JMX、HTTPエージェントのアイテムプロトタイプで使用<br><br>SSH、Telnetのアイテムプロトタイプで必須<br>JMX で使用する場合、パスワードもユーザー名と一緒に指定するか、両方のプロパティを空白のままにする必要があります。| |uuid|string|インポートされたアイテムプロトタイプを既存のアイテムプロトタイプにリンクするために使用されるユニバーサル一意識別子。 テンプレートのアイテムプロトタイプにのみ使用されます。 指定されていない場合は自動生成されます。<br><br>更新操作の場合、このフィールドは *読取専用* です。| |valuemapid|string|関連付けられた値マップID| |verify\_host|integer|HTTP エージェントアイテムプロトタイプフィールド。 URL のホスト名がホスト証明書の Common Name フィールドまたは Subject Alternate Name フィールドにあることを検証します。<br><br>0 - *(デフォルト)* 検証しません。<br>1 - 検証します。| |verify\_peer|integer|HTTP エージェントアイテムプロトタイプフィールド。 検証はホスト証明書の認証です。<br><br>0 - *(デフォルト)* 検証しません。<br>1 - 検証します。| |discover|integer|アイテムプロトタイプのディスカバリステータス。<br><br>使用可能な値:<br>0 - *(デフォルト)* 新しいアイテムが発見されます。<br>1 - 新しいアイテムは発見されず、既存のアイテムは紛失としてマークされます。| # itemprototype.update # itemprototype.update ##### Item prototype You may want to create an item prototype like this:  with preprocessing options:  ##### アイテムのプロトタイプ 次のようなアイテムのプロトタイプを作成することをお勧めします。  保存前処理オプション:  ## Items ## アイテム ## Items ## アイテム ## Items ## アイテム ## Items ## アイテム ## Items ## アイテム ## Items ## アイテム ## Items ## アイテム #### Items Define items to monitor. [Item API](/manual/api/reference/item) #### アイテム 監視するアイテムを定義します [Item API](/manual/api/reference/item) ### Items ##### docker.container_stats The [docker.container_stats](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#docker) item on Zabbix agent 2 now also returns a `pids_stats` property with the current number of processes/threads on the container. ### アイテム ##### docker.container_stats Zabbixエージェント2の[docker.container_stats](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#docker)アイテムも、 コンテナ上の現在のプロセス/スレッド数とともに`pids_stats`プロパティを返すようになりました。 #### Items To configure querying of internal stats on another Zabbix instance, you may use two items: - `zabbix[stats,<ip>,<port>]` internal item - for direct remote queries of Zabbix server/proxy. <ip> and <port> are used to identify the target instance. - `zabbix.stats[<ip>,<port>]` agent item - for agent-based remote queries of Zabbix server/proxy. <ip> and <port> are used to identify the target instance. See also: [Internal items](/manual/config/items/itemtypes/internal), [Zabbix agent items](/manual/config/items/itemtypes/zabbix_agent) The following diagram illustrates the use of either item depending on the context.  -  - Server → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -  - Server → proxy → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -  - Server → agent → external Zabbix instance (`zabbix.stats[<ip>,<port>]`) -  - Server → proxy → agent → external Zabbix instance (`zabbix.stats[<ip>,<port>]`) To make sure that the target instance allows querying it by the external instance, list the address of the external instance in the 'StatsAllowedIP' parameter on the target instance. #### アイテム 別のZabbixインスタンスで内部統計のクエリを設定するには、次の2つの項目を使用します。 - `zabbix[stats,<ip>,<port>]` internal item - Zabbixサーバー/プロキシの直接リモートクエリ用。 <ip>と<port>は、ターゲットインスタンスを識別するために使用します - `zabbix.stats[<ip>,<port>]` agent item - Zabbixサーバー/プロキシのエージェントベースのリモートクエリ用。 <ip>と<port>は、ターゲットインスタンスを識別するために使用されます。 参考情報: [内部項目](/manual/config/items/itemtypes/internal), [Zabbixエージェントアイテム](/manual/config/items/itemtypes/zabbix_agent) 次の図はコンテキストに応じた、いずれかのアイテムの使用法を示しています。  -  - Server → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -  - Server → proxy → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -  - Server → agent → external Zabbix instance (`zabbix.stats[<ip>,<port>]`) -  - Server → proxy → agent → external Zabbix instance (`zabbix.stats[<ip>,<port>]`) ターゲットインスタンスが外部インスタンスによるクエリを許可するには、ターゲットインスタンスの'StatsAllowedIP'パラメータに外部インスタンスのアドレスをリストします。 ### Item tag The item tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Item tag name.| |value|string|Item tag value.| ### Item tag item tagオブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**tag**<br>(必須)|string|アイテムタグ名| |value|string|アイテムタグ値| ##### Item To begin with, you may want to set up an item that monitors a log file, for example: log[/var/log/syslog]  With the item set up, wait a minute for the configuration changes to be picked up and then go to [Latest data](/manual/web_interface/frontend_sections/monitoring/latest_data) to make sure that the item has started collecting data. ##### アイテム 始めに、例えばログファイルを監視するような項目を設定するのがよいでしょう: log[/var/log/syslog]  アイテムが設定された状態で、設定変更が反映されるまで1分ほど待ってから、[Latest data](/manual/web_interface/frontend_sections/monitoring/latest_data)にアクセスして、<br> アイテムがデータ収集を開始したことを確認します。 # item.update # item.update #### Item value An *Item value* widget has been added to dashboard widgets. This type of widget is useful for displaying values of single items prominently. Different visual styles of display are possible:  For more information, see [Item value widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value). #### アイテムの値ウィジェット ダッシュボードウィジェットに、*アイテムの値*ウィジェットが追加されました。 このタイプのウィジェットは、単一の項目の値を目立つように表示するのに便利です。さまざまな表示スタイル が可能です:  詳細は、[アイテムの値ウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value)をご覧ください。 ##### Item value preprocessing The **Preprocessing** tab allows to define [transformation rules](/manual/config/items/preprocessing) for the received values. ##### アイテムの値の保存前処理 **保存前処理**タブでは、受け取った値に対して[変換するルール](/manual/config/items/preprocessing)を定義することができます。 #### Item value preprocessing To visualize the data preprocessing process, we can use the following simplified diagram:  The diagram above shows only processes, objects and main actions related to item value preprocessing in a **simplified** form. The diagram does not show conditional direction changes, error handling or loops. Only one preprocessing worker is shown on this diagram (multiple preprocessing workers can be used in real-life scenarios), only one item value is being processed and we assume that this item requires to execute at least one preprocessing step. The aim of this diagram is to show the idea behind item value preprocessing pipeline. - Item data and item value is passed to preprocessing manager using socket-based IPC mechanism. - Item is placed in the preprocessing queue. ::: noteclassic Item can be placed at the end or at the beginning of the preprocessing queue. Zabbix internal items are always placed at the beginning of preprocessing queue, while other item types are enqueued at the end. ::: - At this point data flow stops until there is at least one unoccupied (that is not executing any tasks) preprocessing worker. - When preprocessing worker is available, preprocessing task is being sent to it. - After preprocessing is done (both failed and successful execution of preprocessing steps), preprocessed value is being passed back to preprocessing manager. - Preprocessing manager converts result to desired format (defined by item value type) and places result in preprocessing queue. If there are dependent items for current item, then dependent items are added to preprocessing queue as well. Dependent items are enqueued in preprocessing queue right after the master item, but only for master items with value set and not in NOT SUPPORTED state. #### item 値のプリプロセッシング データのプリプロセッシングを可視化するために、以下のような簡略化した図を示します。  上の図は、item 値のプリプロセッシングに関連するプロセス、オブジェクト、および主なアクションのみを **簡略化** した形で示しています。<br> この図では条件分岐、エラー処理、ループは示していない。ただ1つのプリプロセスワーカーだけが示されています。<br> （実際は複数のプリプロセスワーカーを使用することも可能です）<br> この項目は少なくとも1つのプリプロセス工程を実行する必要があると想定している。<br> この図の目的は、item 値のプリプロセスパイプラインの考え方を示すことである。<br> - item データとitem 値は、ソケットベースのIPCメカニズムを使用してプリプロセスマネージャに渡される。 - item はプリプロセスキューに入れられる。 ::: noteclassic item はプリプロセスキューの最後または先頭に配置されます。<br> Zabbix内部アイテムは常にプリプロセスキューの先頭に配置され、その他のアイテムタイプは最後にキューイングされます。<br> ::: - この時点で、少なくとも1つの未使用の(タスクを実行していない)プリプロセスワーカーが存在するまでデータフローは停止します。<br> - プリプロセスワーカーが利用可能になると、プリプロセスタスクはそのワーカーに送られます。<br> - プリプロセスが完了すると（プリプロセスステップの実行に失敗した場合も成功した場合も）処理された値が<br> プリプロセッシングマネージャに戻されます。<br> - プリプロセスマネージャは、結果を（item 値の型によって定義される）希望する形式に変換し、結果をプリプロセスキューに入れる。<br> もし現在の item に依存する item がある場合、依存する item もプリプロセスキューに追加されます。<br> ただし、値が設定され、NOT SUPPORTED 状態でないマスター item に限ります。 #### Item value processing To visualize the data flow from data source to the Zabbix database, we can use the following simplified diagram:  The diagram above shows only processes, objects and actions related to item value processing in a **simplified** form. The diagram does not show conditional direction changes, error handling or loops. Local data cache of preprocessing manager is not shown either because it doesn't affect data flow directly. The aim of this diagram is to show processes involved in item value processing and the way they interact. - Data gathering starts with raw data from a data source. At this point, data contains only ID, timestamp and value (can be multiple values as well) - No matter what type of data gatherer is used, the idea is the same for active or passive checks, for trapper items and etc, as it only changes the data format and the communication starter (either data gatherer is waiting for a connection and data, or data gatherer initiates the communication and requests the data). Raw data is validated, item configuration is retrieved from configuration cache (data is enriched with the configuration data). - Socket-based IPC mechanism is used to pass data from data gatherers to preprocessing manager. At this point data gatherer continue to gather data without waiting for the response from preprocessing manager. - Data preprocessing is performed. This includes execution of preprocessing steps and dependent item processing. ::: noteclassic Item can change its state to NOT SUPPORTED while preprocessing is performed if any of preprocessing steps fail. ::: - History data from local data cache of preprocessing manager is being flushed into history cache. - At this point data flow stops until the next synchronization of history cache (when history syncer process performs data synchronization). - Synchronization process starts with data normalization storing data in Zabbix database. Data normalization performs conversions to desired item type (type defined in item configuration), including truncation of textual data based on predefined sizes allowed for those types (HISTORY\_STR\_VALUE\_LEN for string, HISTORY\_TEXT\_VALUE\_LEN for text and HISTORY\_LOG\_VALUE\_LEN for log values). Data is being sent to Zabbix database after normalization is done. ::: noteclassic Item can change its state to NOT SUPPORTED if data normalization fails (for example, when textual value cannot be converted to number). ::: - Gathered data is being processed - triggers are checked, item configuration is updated if item becomes NOT SUPPORTED, etc. - This is considered the end of data flow from the point of view of item value processing. #### item 値の処理 データソースからZabbixデータベースへのデータフローを可視化するために、以下の簡略化された図を使用します。  上の図は、item 値処理に関連するプロセス、オブジェクト、アクションのみを**簡略化**して示しています。<br> この図には条件分岐、エラー処理、ループなどは示していません。プリプロセスマネージャの<br> ローカルデータキャッシュも表示されていません。データフローに直接影響しないためです。<br> この図の目的は、item 値処理に関わるプロセスと、それらが相互作用する方法を示すことです。< - データ収集は、データソースからの生データから始まる。このデータにはID、タイムスタンプ、値（複数の値も可能）のみが含まれます。 - アクティブチェック、パッシブチェック、トラッパー item など、どのような種類のデータ収集装置を使っても、<br> 考え方は同じで、データ形式と通信の開始方法を変えるだけです。<br> (データ収集者が接続とデータを待っているか、データ収集者が通信を開始し、データを要求しているか）<br> 生データは検証され、item 設定は設定キャッシュから取得されます。(データは設定データでリッチ化されます)。<br> - データ収集者からプリプロセスマネージャへのデータの受け渡しには、ソケットベースのIPCメカニズムが使用されます。<br> この時点でデータ収集装置はプリプロセスマネージャからの応答を待たずにデータ収集を続ける。<br> - データのプリプロセッシングが行われる。これには、プリプロセスステップの実行と依存項目処理が含まれます。 ::: noteclassic item はプリプロセッシングが行われている間にいずれかの処理が失敗した場合、状態が NOT SUPPORTED に変更されることがあります。 ::: - プリプロセスマネージャのローカルデータキャッシュからヒストリデータがヒストリーキャッシュに流される。<br> - この時点でデータの流れは止まり、次のヒストリーキャッシュの同期（ヒストリーシンサープロセスがデータの同期を行う）まで<br> データの流れは停止します。 - 同期処理はデータの正規化から始まり、データをZabbixデータベースに格納することから始まります。<br> データの正規化では、以下の変換を行います。<br> 目的の item タイプ(item 設定で定義されたタイプ)への変換を行います。<br> テキストデータについては、あらかじめ定義されたサイズに基づき、切り捨てを行います。<br> テキストデータは、それらのタイプに許容される事前定義されたサイズ(文字列はHISTORY_STR_VALUE_LEN、<br> テキストはHISTORY_TEXT_LEN、ログ値にはHISTORY_LOG_VALUE_LEN)に基づいて切り捨てられます。<br> データは正規化された後、Zabbixデータベースに送信されます。 ::: noteclassic データの正規化に失敗した場合(例：テキスト値を数値に変換できない場合)、item はNOT SUPPORTEDに状態を変更されることがあります。 ::: - 収集されたデータは処理される - トリガーがチェックされ、item が NOT SUPPORTED になった場合は設定が更新される - item 値処理の観点からは、これでデータフローは終了したとみなされる。 #### Item values The following information is exported for a collected item value: |Field|<|Type|Description| |-|---------|---------|---------------------------| |*host*|<|object|Host name of the item host.| | |host|string|Host name.| |^|name|string|Visible host name.| |*groups*|<|array|List of host groups of the item host; there should be at least one element in array.| | |\-|string|Host group name.| |*itemid*|<|number|Item ID.| |*name*|<|string|Visible item name.| |*clock*|<|number|Number of seconds since Epoch to the moment when value was collected (integer part).| |*ns*|<|number|Number of nanoseconds to be added to `clock` to get a precise value collection time.| |*timestamp*<br>(*Log* only)|<|number|0 if not available.| |*source*<br>(*Log* only)|<|string|Empty string if not available.| |*severity*<br>(*Log* only)|<|number|0 if not available.| |*eventid*<br>(*Log* only)|<|number|0 if not available.| |*value*|<|number (for numeric items) or<br>string (for text items)|Collected item value.| |*type*|<|number|Collected value type:<br>0 - numeric float, 1 - character, 2 - log, 3 - numeric unsigned, 4 - text| #### アイテム値 収集されたアイテム値について次の情報がエクスポートされます。 |フィールド|<|タイプ|説明| |-|---------|---------|---------------------------| |*host*|<|object|アイテムホストのホスト名| | |host|string|ホスト名| |^|name|string|表示ホスト名| |*groups*|<|array|アイテムホストのホストグループのリスト。 配列には少なくとも1つの要素が必要です。| | |\-|string|ホストグループ名| |*itemid*|<|number|アイテムID| |*name*|<|string|表示アイテム名| |*clock*|<|number|エポックから値が収集されるまでの秒数（整数部）| |*ns*|<|number|正確な値の収集時間を取得するために`clock`に追加されるナノ秒数| |*timestamp*<br>(*Log* only)|<|number|利用できない場合は0| |*source*<br>(*Log* only)|<|string|使用できない場合は空の文字列| |*severity*<br>(*Log* only)|<|number|利用できない場合は0| |*eventid*<br>(*Log* only)|<|number|利用できない場合は0| |*value*|<|number (for numeric items) or<br>string (for text items)|収集したアイテム値| |*type*|<|number|収集された値のタイプ：<br>0 - 浮動小数点,1 - 文字,2 - ログ, 3 - 符号なしの数値, 4 - テキスト| ##### Item value The following parameters are supported if *Data* is set to "Item value". ::: noteclassic The first number in the *Thresholds* property name (e.g. columnsthresholds.color.0.0) references the column for which thresholds are configured, while the second number references threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold.1": "5"`). ::: |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Item*|<|1 |columns.item.0|Valid item name.| |***Time shift***<br>(required)|<|1|columns.timeshift.0|Valid numeric or time string value (e.g. `3600` or `1h`).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes). Negative values are allowed.| |*Aggregation function*|<|0|columns.aggregate_function.0|0 - *(default)* none;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Aggregation interval*|<|1|columns.aggregate_interval.0|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes).<br><br>Parameter *Aggregation interval* not available if *Aggregation function* is set to *none*.<br><br>Default: `1h`.| |*Display*|<|0|columns.display.0|1 - *(default)* As is;<br>2 - Bar;<br>3 - Indicators.| |*Min*|<|1|columns.min.0|Any numeric value.<br><br>Parameter *Min* not available if *Display* is set to "As is".| |*Max*|<|1|columns.max.0|Any numeric value.<br><br>Parameter *Max* not available if *Display* is set to "As is".| |*History data*|<|0|columns.history.0|1 - *(default)* Auto;<br>2 - History;<br>3 - Trends.| |*Thresholds*|<|<|<|<| |<|*Color*|1|columnsthresholds.color.0.0|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |^|*Threshold*|1|columnsthresholds.threshold.0.0|Any string value.| ##### 項目値 *Data* が"項目値"に設定されている場合、以下のパラメータがサポートされます。 ::: noteclassic *Thresholds* プロパティ名の最初の数字（例：columnsthresholds.color.0.0）は、しきい値が設定されている列を参照し、2番目の数字はリスト内のしきい値の順序（昇順）を参照します。 ただし、しきい値が異なる順序で設定されている場合は、Zabbix フロントエンドでウィジェット設定を更新すると、値は昇順で並べ替えられます。 （例：`"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold.1": "5"`）。 ::: |パラメータ|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*アイテム*|<|1 |columns.item.0|有効なアイテム名| |***タイムシフト***<br>(必須)|<|1|columns.timeshift.0|有効な数値または時刻文字列値（例：`3600` または `1h`）<br>[時刻サフィックス](/manual/appendix/suffixes#time-suffixes) を使用できます。負の値も使用できます。| |*集計関数*|<|0|columns.aggregate_function.0|0 - *(デフォルト)* なし;<br>1 - 最小;<br>2 - 最大;<br>3 - 平均;<br>4 - 個数;<br>5 - 合計;<br>6 - 最初;<br>7 - 最後| |*集計間隔*|<|1|columns.aggregate_interval.0|有効な時刻文字列（例：`3600`、`1h` など）<br>[時刻サフィックス](/manual/appendix/suffixes#time-suffixes)を使用できます。<br><br>*集計関数*が*なし*に設定されている場合、パラメーター *集計間隔* は使用できません。<br><br>デフォルト: `1h`| |*表示*|<|0|columns.display.0|1 - *(デフォルト)* そのまま;<br>2 - バー;<br>3 - インジケーター| |*最小値*|<|1|columns.min.0|任意の数値<br><br>パラメータ *Min* は、*表示* が"そのまま"に設定されている場合は使用できません。| |*最大値*|<|1|columns.max.0|任意の数値<br><br>パラメータ *Max* は、*表示* が"そのまま"に設定されている場合は使用できません。| |*履歴データ*|<|0|columns.history.0|1 - *(デフォルト)* 自動;<br>2 - 履歴;<br>3 - トレンド| |*しきい値*|<|<|<|<| |<|*Color*|1|columnsthresholds.color.0.0|16進数カラーコード（例：`FF0000`）<br><br>デフォルト：`""`（空）| |^|*Threshold*|1|columnsthresholds.threshold.0.0|任意の文字列値| ### Item value widget An *Item value* widget has been added to dashboard widgets. This type of widget is useful for displaying values of single items prominently. Different visual styles of display are possible:  For more information, see [Item value widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value). Macros for internal actions contain the reason why an item, an LLD-rule, or a trigger became unsupported: - {ITEM.STATE.ERROR} - for item-based internal notifications; - {LLDRULE.STATE.ERROR} - for LLD-rule based internal notifications; - {TRIGGER.STATE.ERROR} - for trigger-based internal notifications. For more details, see [Supported macros](/manual/appendix/macros/supported_by_location). It is possible to zoom in and out the map by using the plus and minus buttons in the widget's upper left corner or by using the mouse scroll wheel or touchpad. To set the current view as default, right-click anywhere on the map and select *Set this view as default*. This setting will override *Initial view* widget parameter for the current user. To undo this action, right-click anywhere on the map again and select *Reset the initial view*. When *Initial view* or *Default view* is set, you can return to this view at any time by pressing on the home icon on the left.  ウィジェットの左上隅にあるプラスボタンとマイナスボタンを使用するか、マウスのスクロールホイールまたはタッチパッドを使用して、マップをズームインおよびズームアウトできます。 現在のビューをデフォルトとして設定するには、マップ上の任意の場所を右クリックして、[この表示をデフォルトにセット]を選択します。 この設定は、現在のユーザーの*初期ビュー*ウィジェットパラメーターを上書きします。 この操作を元に戻すには、マップ上の任意の場所をもう一度右クリックして、[初期表示にリセット]を選択します。 *初期ビュー*または*デフォルトビュー*が設定されている場合、左側のホームアイコンを押すと、いつでもこのビューに戻ることができます。  #### Java 11 required for Java gateway Zabbix Java gateway now requires Java 11 for runtime (building from source is still possible with Java 8), due to updated minimum logback library versions: |Library|New minimum version|Old minimum version| |------|--|--| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|**1.5.16**|1.2.9| |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|**1.5.16**|1.2.9| |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|**2.0.16**|1.7.32| #### JavaゲートウェイにJava 11が必須に Zabbix Java Gatewayでは、最小ログバックライブラリバージョンが更新されたため、ランタイムにJava 11が必須になりました(ソースからのビルドであればJava 8でまだ可能です)。 |ライブラリ|新しい最小バージョン|古い最小バージョン| |------|--|--| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|**1.5.16**|1.2.9| |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|**1.5.16**|1.2.9| |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|**2.0.16**|1.7.32| ##### Java gateway If you obtained Zabbix from the source repository or an archive, then the necessary dependencies are already included in the source tree. If you obtained Zabbix from your distribution's package, then the necessary dependencies are already provided by the packaging system. In both cases above, the software is ready to be used and no additional downloads are necessary. If, however, you wish to provide your versions of these dependencies (for instance, if you are preparing a package for some Linux distribution), below is the list of library versions that Java gateway is known to work with. Zabbix may work with other versions of these libraries, too. The following table lists JAR files that are currently bundled with Java gateway in the original code: |Library|Mandatory status|Comments| |--|-|-------| |[android-json](https://mvnrepository.com/artifact/com.vaadin.external.google/android-json)|Yes|Version 4.3r1 or higher.<br>JSON (JavaScript Object Notation) is a lightweight data-interchange format. This is the org.json compatible Android implementation extracted from the Android SDK.| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|^|Version 1.5.16 or higher.| |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|^|Version 1.5.16 or higher.| |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|^|Version 2.0.16 or higher.| Java gateway can be built using either Oracle Java or open source OpenJDK (version 1.6 or newer). Packages provided by Zabbix are compiled using OpenJDK. The following table lists OpenJDK packages used for building Zabbix packages by distribution: |Distribution|OpenJDK package| |---|--------| |Debian 12|`default-jdk-headless` (amd64, arm64: 2:1.17-74)| |Debian 11|`default-jdk-headless` (amd64: 2:1.11-72)| |Debian 10|`default-jdk-headless` (amd64, i386: 2:1.11-71)| |OpenSUSE Leap 15|`java-17-openjdk-devel` (amd64: 17.0.5.0-150400.3.9.3; arm64: 17.0.8.0-150400.3.27.1)| |Oracle Linux 9|`java-11-openjdk-devel` (amd64: 11.0.19.0.7-4.0.1; arm64: 11.0.20.0.8-2.0.1)| |Oracle Linux 8|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.372.b07-4.0.1); `java-11-openjdk-devel` (arm64: 11.0.20.0.8-3.0.1)| |Oracle Linux 7|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.282.b08-1)| |Raspberry Pi OS 12|`default-jdk-headless` (arm64, armhf: 2:1.17-74)| |Raspberry Pi OS 11|`default-jdk-headless` (arm64: 2:1.11-72; armhf: 2:1.11-72+b4)| |Raspberry Pi OS 10|`default-jdk` (armhf: 2:1.11-71+b2)| |RHEL 9|`java-11-openjdk-devel` (amd64: 11.0.19.0.7-4; arm64: 11.0.20.0.8-3)| |RHEL 8|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.372.b07-4; arm64: 1.8.0.382.b05-2)| |RHEL 7|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.282.b08-1)| |SLES 15|`java-17-openjdk-devel` (amd64: 17.0.5.0-150400.3.9.3; arm64: 17.0.8.0-150400.3.27.1)| |SLES 12|`java-1_8_0-openjdk-devel` (amd64: 1.8.0.252-27.45.6)| |Ubuntu 24.04|`default-jdk-headless` (amd64, arm64: 2:1.21-75+exp1)| |Ubuntu 22.04|`default-jdk-headless` (amd64, arm64: 2:1.11-72build2)| |Ubuntu 20.04|`default-jdk-headless` (amd64, arm64: 2:1.11-72)| |Ubuntu 18.04|`default-jdk` (amd64: 2:1.11-68ubuntu1~18.04.1; i386: 2:1.10-63ubuntu1~02)| ##### Javaゲートウェイ ソースリポジトリまたはアーカイブからZabbixを取得した場合、必要な依存関係は既にソースツリーに含まれています。 ディストリビューションのパッケージからZabbixを取得した場合、必要な依存関係はパッケージングシステムによって既に提供されています。 上記のどちらの場合でも、ソフトウェアを使用する準備ができており、追加のダウンロードは必要ありません。 ただし、これらの依存関係のバージョンを提供したい場合(たとえば、一部のLinuxディストリビューション用のパッケージを準備している場合)、Javaゲートウェイが動作することがわかっているライブラリバージョンのリストを以下に示します。Zabbixはこれらのライブラリの他のバージョンでも動作する場合があります。 次の表に、元のコードで現在JavaゲートウェイにバンドルされているJARファイルを示します: |ライブラリ|必須ステータス|コメント| |--|-|-------| |[android-json](https://mvnrepository.com/artifact/com.vaadin.external.google/android-json)|Yes|バージョン4.3r1以降。<br>JSON (JavaScript Object Notation)の軽量データ交換フォーマットです。 これはAndroid SDKから抽出されたorg.json互換のAndroid実装です。| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|^|バージョン1.5.16以降。| |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|^|バージョン1.5.16以降。| |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|^|バージョン2.0.16以降。| Javaゲートウェイは、Oracle JavaまたはオープンソースのOpenJDK (バージョン1.6以降)を使用して構築できます。Zabbixが提供するパッケージは、OpenJDKを使用してコンパイルされます。 以下の表は、Zabbixパッケージのビルドに使用されるOpenJDKのバージョンに関する情報をディストリビューションごとに示しています。 |ディストリビューション|OpenJDKパッケージ| |---|--------| |Debian 12|`default-jdk-headless` (amd64, arm64: 2:1.17-74)| |Debian 11|`default-jdk-headless` (amd64: 2:1.11-72)| |Debian 10|`default-jdk-headless` (amd64, i386: 2:1.11-71)| |OpenSUSE Leap 15|`java-17-openjdk-devel` (amd64: 17.0.5.0-150400.3.9.3; arm64: 17.0.8.0-150400.3.27.1)| |Oracle Linux 9|`java-11-openjdk-devel` (amd64: 11.0.19.0.7-4.0.1; arm64: 11.0.20.0.8-2.0.1)| |Oracle Linux 8|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.372.b07-4.0.1); `java-11-openjdk-devel` (arm64: 11.0.20.0.8-3.0.1)| |Oracle Linux 7|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.282.b08-1)| |Raspberry Pi OS 12|`default-jdk-headless` (arm64, armhf: 2:1.17-74)| |Raspberry Pi OS 11|`default-jdk-headless` (arm64: 2:1.11-72; armhf: 2:1.11-72+b4)| |Raspberry Pi OS 10|`default-jdk` (armhf: 2:1.11-71+b2)| |RHEL 9|`java-11-openjdk-devel` (amd64: 11.0.19.0.7-4; arm64: 11.0.20.0.8-3)| |RHEL 8|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.372.b07-4; arm64: 1.8.0.382.b05-2)| |RHEL 7|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.282.b08-1)| |SLES 15|`java-17-openjdk-devel` (amd64: 17.0.5.0-150400.3.9.3; arm64: 17.0.8.0-150400.3.27.1)| |SLES 12|`java-1_8_0-openjdk-devel` (amd64: 1.8.0.252-27.45.6)| |Ubuntu 24.04|`default-jdk-headless` (amd64, arm64: 2:1.21-75+exp1)| |Ubuntu 22.04|`default-jdk-headless` (amd64, arm64: 2:1.11-72build2)| |Ubuntu 20.04|`default-jdk-headless` (amd64, arm64: 2:1.11-72)| |Ubuntu 18.04|`default-jdk` (amd64: 2:1.11-68ubuntu1~18.04.1; i386: 2:1.10-63ubuntu1~02)| ### Java gateway installation It is required to install [Java gateway](/manual/concepts/java) only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database. Once the required repository is added, you can install Zabbix Java gateway by running: apt install zabbix-java-gateway Proceed to [setup](/manual/concepts/java/from_debian_ubuntu) for more details on configuring and running Java gateway. ### Javaゲートウェイのインストール JMXアプリケーションを監視したい場合のみ[Javaゲートウェイ](/manual/concepts/java)のインストールが必要です。 Javaゲートウェイは軽量で、データベースを必要としません。 必要なリポジトリの追加後、次を実行するとZabbix Javaゲートウェイをインストールできます。 apt install zabbix-java-gateway Javaゲートウェイの設定と実行の詳細については、[セットアップ](/manual/concepts/java/from_debian_ubuntu)に進んでください。 ### Java gateway installation It is required to install [Java gateway](/manual/concepts/java) only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database. Once the required repository is added, you can install Zabbix Java gateway by running: # dnf install zabbix-java-gateway Proceed to [setup](/manual/concepts/java/from_rhel_centos) for more details on configuring and running Java gateway. ### Java gateway のインストール JMXアプリケーションを監視する場合のみ、[Java gateway](/manual/concepts/java)をインストールする必要があります。<br> Javaゲートウェイは軽量で、データベースを必要としません。 必要なリポジトリが追加されたら、以下のコマンドラインを実行することでZabbix Javaをインストールできます: # dnf install zabbix-java-gateway Java gatewayの設定と実行の詳細については、[setup](/manual/java) を参照してください。 ### Java gateway installation It is required to install [Java gateway](/manual/concepts/java) only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database. Once the required repository is added, you can install Zabbix Java gateway by running: dnf install zabbix-java-gateway Proceed to [setup](/manual/concepts/java/from_rhel) for more details on configuring and running Java gateway. ### Javaゲートウェイのインストール JMXアプリケーションを監視したいときには、[Javaゲートウェイ](/manual/concepts/java)をインストールすることが必要です。 Javaゲートウェイは軽量で、データベースを必要としません。 必要なリポジトリが追加されていたら、以下のように実行することでZabbix Javaゲートウェイをインストールすることができます： dnf install zabbix-java-gateway Javaゲートウェイの設定の実行の詳細については[設定](/manual/concepts/java/from_rhel)を参照してください。 #### JavaScript methods HTTP methods PATCH, HEAD, OPTIONS, TRACE, CONNECT have been added to the JavaScript engine. Also, the engine now allows sending custom HTTP method requests with the new JS method HttpRequest.customRequest. See also: [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects). #### JavaScriptのメソッド HTTPメソッドPATCH, HEAD, OPTIONS, TRACE, CONNECTをJavaScriptエンジンに追加しました。また、新しいJSメソッドHttpRequest.customRequestを使って、カスタムHTTPメソッドのリクエストを送信できるようになりました。 [追加のJavaScriptオブジェクト](/manual/config/items/preprocessing/javascript/javascript_objects)もあわせて参照してください。 #### JavaScript preprocessing JavaScript preprocessing is done by invoking JavaScript function with a single parameter 'value' and user provided function body. The preprocessing step result is the value returned from this function, for example, to perform Fahrenheit to Celsius conversion user must enter: return (value - 32) * 5 / 9 in JavaScript preprocessing parameters, which will be wrapped into a JavaScript function by server: ``` {.java} function (value) { return (value - 32) * 5 / 9 } ``` The input parameter 'value' is always passed as a string. The return value is automatically coerced to string via ToString() method (if it fails then the error is returned as string value), with a few exceptions: - returning undefined value will result in an error - returning null value will cause the input value to be discarded, much like 'Discard value' preprocessing on 'Custom on fail' action. Errors can be returned by throwing values/objects (normally either strings or Error objects). For example: ``` {.java} if (value == 0) throw "Zero input value" return 1/value ``` Each script has a 10 second execution timeout (depending on the script it might take longer for the timeout to trigger); exceeding it will return error. A 512-megabyte heap limit is enforced (64 megabytes before Zabbix 6.0.19). The JavaScript preprocessing step bytecode is cached and reused when the step is applied next time. Any changes to the item's preprocessing steps will cause the cached script to be reset and recompiled later. Consecutive runtime failures (3 in a row) will cause the engine to be reinitialized to mitigate the possibility of one script breaking the execution environment for the next scripts (this action is logged with DebugLevel 4 and higher). JavaScript preprocessing is implemented with Duktape (<https://duktape.org/>) JavaScript engine. See also: [Additional JavaScript objects and global functions](/manual/config/items/preprocessing/javascript/javascript_objects) #### JavaScriptの保存前処理 JavaScriptの保存前処理は、JavaScriptの関数を'value'という1つのパラメーターとユーザー提供の関数本体で呼び出すことで行われます。保存前処理のステップの結果は、この関数から返される値です。例えば、華氏から摂氏への変換を行う場合、ユーザーは次のように入力する必要があります。 return (value - 32) * 5 / 9 JavaScriptの保存前処理パラメーターは、サーバーによってJavaScript関数にラップされます。 ``` {.java} function (value) { return (value - 32) * 5 / 9 } ``` 入力パラメーター'value'は常に文字列として渡されます。戻り値はいくつかの例外とともに自動的にToString()メソッドで文字列に変換されます(失敗した場合は、エラーが文字列として返されます)。 - 未定義の値を返すとエラーになります。 - null値を返すと、入力値が破棄されます。これは'失敗時のカスタマイズ'の'値を破棄'と似た動作になります。 エラーは、値/オブジェクト(通常は文字列かエラーオブジェクト)をスローすることによって返されます。 例: ``` {.java} if (value == 0) throw "Zero input value" return 1/value ``` 各スクリプトには10秒の実行タイムアウトがあり、超えるとエラーが返されます(スクリプトによって、タイムアウトがトリガーするのに時間がかかる場合があります)。512メガバイトのヒープ制限が施行されています(Zabbix 6.0.19より前は64メガバイト)。 JavaScriptの保存前処理のステップのバイトコードはキャッシュされ、次回ステップが適用されたときに再利用されます。アイテムの保存前処理ステップに変更を加えると、キャッシュされたスクリプトがリセットされ、後で再コンパイルされます。 連続したランタイムエラー(3回連続)が発生すると、1つのスクリプトによって次のスクリプトの実行環境が破壊される可能性を軽減するために、エンジンが再初期化されます(このアクションは、デバッグレベル4以上でログに記録されます)。 JavaScriptの保存前処理は、Duktape(<https://duktape.org/>) JavaScriptエンジンを使用して実装されています。 参照: [追加のJavaScriptオブジェクトとグローバル関数](/manual/config/items/preprocessing/javascript/javascript_objects) ### JavaScript preprocessing The heap limit for scripts has been upped from 64 to 512 megabytes. ### JavaScript保存前処理 スクリプトのヒープ制限が64メガバイトから512メガバイトに引き上げられました。 #### Jira webhook (custom)  This script will create a JIRA issue and return some info on the created issue. ``` {.java} try { Zabbix.log(4, '[ Jira webhook ] Started with params: ' + value); var result = { 'tags': { 'endpoint': 'jira' } }, params = JSON.parse(value), req = new HttpRequest(), fields = {}, resp; if (params.HTTPProxy) { req.setProxy(params.HTTPProxy); } req.addHeader('Content-Type: application/json'); req.addHeader('Authorization: Basic ' + params.authentication); fields.summary = params.summary; fields.description = params.description; fields.project = {key: params.project_key}; fields.issuetype = {id: params.issue_id}; resp = req.post('https://jira.example.com/rest/api/2/issue/', JSON.stringify({"fields": fields}) ); if (req.getStatus() != 201) { throw 'Response code: ' + req.getStatus(); } resp = JSON.parse(resp); result.tags.issue_id = resp.id; result.tags.issue_key = resp.key; return JSON.stringify(result); } catch (error) { Zabbix.log(4, '[ Jira webhook ] Issue creation failed json : ' + JSON.stringify({"fields": fields})); Zabbix.log(3, '[ Jira webhook ] issue creation failed : ' + error); throw 'Failed with error: ' + error; } ``` #### Jira webhook (カスタム)  このスクリプトはJIRA課題を作成し、作成された課題に関する情報を返します。 ``` {.java} try { Zabbix.log(4, '[ Jira webhook ] Started with params: ' + value); var result = { 'tags': { 'endpoint': 'jira' } }, params = JSON.parse(value), req = new HttpRequest(), fields = {}, resp; if (params.HTTPProxy) { req.setProxy(params.HTTPProxy); } req.addHeader('Content-Type: application/json'); req.addHeader('Authorization: Basic ' + params.authentication); fields.summary = params.summary; fields.description = params.description; fields.project = {key: params.project_key}; fields.issuetype = {id: params.issue_id}; resp = req.post('https://jira.example.com/rest/api/2/issue/', JSON.stringify({"fields": fields}) ); if (req.getStatus() != 201) { throw 'Response code: ' + req.getStatus(); } resp = JSON.parse(resp); result.tags.issue_id = resp.id; result.tags.issue_key = resp.key; return JSON.stringify(result); } catch (error) { Zabbix.log(4, '[ Jira webhook ] Issue creation failed json : ' + JSON.stringify({"fields": fields})); Zabbix.log(3, '[ Jira webhook ] issue creation failed : ' + error); throw 'Failed with error: ' + error; } ``` #### JMX item keys in more detail #### JMX item キーの詳細 #### JMX monitoring See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details. #### JMX監視 詳しくは[JMX監視](/manual/config/items/itemtypes/jmx_monitoring)ページをご覧ください。 #### JMX monitoring See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details. #### JMX監視 詳しくは[JMX監視](/manual/config/items/itemtypes/jmx_monitoring)ページをご覧ください。 #### JMX monitoring See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details. #### JMX監視 詳しくは[JMX監視](/manual/config/items/itemtypes/jmx_monitoring)ページをご覧ください。 #### JMX monitoring See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details. #### JMX モニタリング 詳しくは[JMX モニタリング](/manual/config/items/itemtypes/jmx_monitoring)ページをご覧ください。 ### JMX monitoring The template *Generic Java JMX* now contains discovery rules for low-level discovery of memory pools and garbage collectors. ### JMX モニタリング テンプレート *Generic Java JMX* は、メモリプールとガベージコレクタのローレベルディスカバリのための検知ルールを含むようになりました。 #### JSON format The JSON export format contains the following objects: - Root object for Zabbix JSON export - Export version - Date when export was created in ISO 8601 long format ```json { "zabbix_export": { "version": "6.0", "date": "2020-04-22T06:20:11Z" } } ``` Other objects are dependent on exported objects. #### JSONフォーマット JSON エクスポート形式には次のオブジェクトが含まれます。 - Zabbix JSONエクスポートのルートオブジェクト - エクスポート・バージョン - エクスポートが作成された日付(ISO 8601 の長い形式） ```json { "zabbix_export": { "version": "6.0", "date": "2020-04-22T06:20:11Z" } } ``` 他のオブジェクトはエクスポートされたオブジェクトに依存します。 ### JSONPath parsing errors JSONPath parsing errors occur in this version in case of leading whitespace and empty array/object. Fixed in Zabbix 6.0.12. ### JSONPath解析エラー JSONPathの解析エラーは、空白で始まる場合と空の配列/オブジェクトの場合にこのバージョンで発生します。 Zabbix 6.0.12で修正されました。 #### Keeping history You can set for how many days history will be kept: - in the item properties [form](/manual/config/items/item) - when mass-updating items - when [setting up](/manual/web_interface/frontend_sections/administration/general#housekeeper) housekeeper tasks Any older data will be removed by the housekeeper. The general strong advice is to keep history for the smallest possible number of days and that way not to overload the database with lots of historical values. Instead of keeping a long history, you can keep longer data of trends. For example, you could keep history for 14 days and trends for 5 years. You can get a good idea of how much space is required by history versus trends data by referring to the [database sizing page](/manual/installation/requirements#database_size). While keeping shorter history, you will still be able to review older data in graphs, as graphs will use trend values for displaying older data. ::: noteimportant If history is set to '0', the item will update only dependent items and inventory. No trigger functions will be evaluated because trigger evaluation is based on history data only. ::: ::: notetip As an alternative way to preserve history consider to use [history export](/manual/config/items/loadablemodules#providing_history_export_callbacks) functionality of loadable modules. ::: #### ヒストリの保持 ヒストリを何日間残すかを設定することができます。 - アイテムの[設定画面](/manual/config/items/item) - アイテムの一括更新時 - ハウスキーパータスクの[設定](/manual/web_interface/frontend_sections/administration/general#housekeeper)を行う時 古いデータは、ハウスキーパープロセスによって削除されます。 一般的なアドバイスとして、ヒストリはできるだけ少ない日数で保存し、多くのヒストリの値でデータベースに負荷をかけないようにすることが重要です。 例えば、ヒストリを14日間、トレンドを5年間保存することができます。 ヒストリとトレンドのデータでどれくらいの容量が必要かは、[データベースのサイジング](/manual/installation/requirements#database_size)を参照してください。 グラフは古いデータを表示するためにトレンドの値を使用するので、短いヒストリの保存期間であっても、グラフで古いデータを確認することができます。 ::: noteimportant ヒストリの保存期間を'0'に設定すると、アイテムが更新されるのは 依存アイテムとインベントリのみを更新します。 トリガー条件式の評価はヒストリの値にのみ基づいて行われるため、トリガー関数は評価されません。 ::: ::: notetip ヒストリを保存する別の方法として、ローダブルモジュールの[ヒストリエクスポート](/manual/config/items/loadablemodules#providing_history_export_callbacks)機能を使うことを検討してください。 ::: #### Keeping trends Trends is a built-in historical data reduction mechanism which stores minimum, maximum, average and the total number of values per every hour for numeric data types. You can set for how many days trends will be kept: - in the item properties [form](/manual/config/items/item) - when mass-updating items - when setting up Housekeeper tasks Trends usually can be kept for much longer than history. Any older data will be removed by the housekeeper. Zabbix server accumulates trend data in runtime in the trend cache, as the data flows in. Server flushes **previous hour** trends of every item into the database (where frontend can find them) in these situations: - server receives the first current hour value of the item - 5 or less minutes of the current hour left and still no current hour values of the item - server stops To see trends on a graph you need to wait at least to the beginning of the next hour (if item is updated frequently) and at most to the end of the next hour (if item is updated rarely), which is 2 hours maximum. When server flushes trend cache and there are already trends in the database for this hour (for example, server has been restarted mid-hour), server needs to use update statements instead of simple inserts. Therefore on a bigger installation if restart is needed it is desirable to stop server in the end of one hour and start in the beginning of the next hour to avoid trend data overlap. History tables do not participate in trend generation in any way. ::: noteimportant If trends are set to '0', Zabbix server does not calculate or store trends at all. ::: ::: noteclassic The trends are calculated and stored with the same data type as the original values. As a result the average value calculations of unsigned data type values are rounded and the less the value interval is the less precise the result will be. For example if item has values 0 and 1, the average value will be 0, not 0.5. Also restarting server might result in the precision loss of unsigned data type average value calculations for the current hour. ::: #### トレンドの保持 トレンドは、数値データタイプの1時間あたりの最小値、最大値、平均値、および合計値を保存するために組み込まれたヒストリデータ削減メカニズムです。 トレンドは何日間保存されるかを設定することができます。 - アイテムの[設定画面](/manual/config/items/item)で設定できます。 - アイテムの一括更新時 - データの保存期間を設定するとき トレンドは通常、ヒストリよりもはるかに長い期間保持することができます。古いデータはhousekeeperプロセスによって削除されます。 Zabbixサーバーは、データが流入するにつれて、実行時にトレンドデータをトレンドキャッシュに蓄積します。サーバーは、以下のような場合、すべてのアイテムの**前の1時間**のトレンド をデータベース(Webインターフェースが検索可能な場所)にフラッシュします： - サーバーがそのアイテムの最初の現在時刻の値を受信したとき - 現在の時間が残り5分以下で、まだそのアイテムの現在の時間の値がないとき - サーバーが停止するとき グラフでトレンドを見るには、少なくとも次の時間の始まりまで（アイテムが頻繁に更新される場合）、最大でも次の時間の終わりまで（アイテムがほとんど更新されない場合）、つまり最大2時間待つ必要があります。<br> サーバーがトレンドキャッシュをフラッシュし、データベースにその時間のトレンドが既にある場合<br> （例えば、サーバーが時間の途中で再起動した場合）、サーバーは単純な挿入の代わりに更新ステートメントを使用する必要があります。<br> したがって、大規模なインストールで再起動が必要な場合は、トレンドデータの重複を避けるために、ある時間の終わりにサーバーを停止し、次の時間の初めに開始することが望ましいです。<br> ヒストリテーブルはトレンドの生成には一切関与しません。 ::: noteimportant トレンドの保存期間が '0' に設定されている場合、Zabbixサーバーはトレンドの計算や保存を全く行いません。 ::: ::: noteclassic トレンドは元の値と同じデータ型で計算され、保存されます。その結果、符号なしデータ型の値の平均値の計算は丸められ、値の間隔が狭いほど結果の精度は低くなります。例えば、項目が0と1の値を持つ場合、平均値は0.5ではなく、0になります。 また、サーバーを再起動すると、符号なしデータ型の平均値の計算の精度が落ちることがあります。<br> ::: ##### Kernel data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**kernel.maxfiles**|<|<|<| |Maximum number of opened files supported by OS.|Integer| | | |**kernel.maxproc**|<|<|<| |Maximum number of processes supported by OS.|Integer| | | |**kernel.openfiles**|<|<|<| |Return the number of currently open file descriptors.|Integer| |This item is supported since Zabbix 6.0.| ##### カーネルデータ |アイテムキー|<|<|<| |--|--|------|------| |説明|戻り値|パラメータ|コメント| |**kernel.maxfiles**|<|<|<| |OS がサポートするオープン ファイルの最大数|Integer| | | |**kernel.maxproc**|<|<|<| |OS がサポートするプロセスの最大数|Integer| | | |**kernel.openfiles**|<|<|<| |現在開いているファイル記述子の数|Integer| |このアイテムは Zabbix 6.0 以降でサポートされています| ### Keyboard navigation Keyboard control has been implemented for info icons in the frontend. Thus it is now possible to focus on info icons, and open the hints, using the keyboard. ### キーボードによるナビゲーション フロントエンドのインフォメーションアイコンにキーボードコントロールが実装されました。 これによりキーボードで情報アイコンにフォーカスし、ヒントを開くことができるようになりました。 |Key|<|<|<|<| |---|-|-|-|-| |<|**Description**|**Return value**|**Parameters**|**Comments**| |agent.hostmetadata|<|<|<|<| |<|Agent host metadata.|String||Returns the value of HostMetadata or HostMetadataItem parameters, or empty string if none are defined.<br><br>Supported since Zabbix 6.0.| |agent.hostname|<|<|<|<| |<|Agent host name.|String| |Returns:<br>As passive check - the name of the first host listed in the Hostname parameter of the agent configuration file;<br>As active check - the name of the current hostname.| |agent.ping|<|<|<|<| |<|Agent availability check.|Nothing - unavailable<br><br>1 - available| |Use the **nodata()** trigger function to check for host unavailability.| |agent.variant|<|<|<|<| |<|Variant of Zabbix agent (Zabbix agent or Zabbix agent 2).|Integer| |Example of returned value:<br>1 - Zabbix agent<br>2 - Zabbix agent 2| |agent.version|<|<|<|<| |<|Version of Zabbix agent.|String| |Example of returned value:<br>6.0.3| |kernel.maxfiles|<|<|<|<| |<|Maximum number of opened files supported by OS.|Integer| | | |kernel.maxproc|<|<|<|<| |<|Maximum number of processes supported by OS.|Integer| | | |kernel.openfiles|<|<|<|<| |<|Return the number of currently open file descriptors.|Integer||This item is supported on Linux only since Zabbix 6.0.| |log\[file,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<|<| |<|Monitoring of a log file.|Log|**file** - full path and name of log file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxlines** - maximum number of new lines per second the agent will send to Zabbix server or proxy. This parameter overrides the value of 'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**mode** (since version 2.0)- possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**output** (since version 2.2) - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).<br>**maxdelay** (since version 3.2) - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.4.7) - additional options:<br>*mtime-noreread* - non-unique records, reread only if the file size changes (ignore modification time change). (This parameter is deprecated since 5.0.2, because now mtime is ignored.)<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br>If file is missing or permissions do not allow access, item turns unsupported.<br><br>If `output` is left empty - the whole line containing the matched text is returned. Note that all global regular expression types except 'Result is TRUE' always return the whole matched line and the `output` parameter is ignored.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>Examples:<br>=> log\[/var/log/syslog\]<br>=> log\[/var/log/syslog,error\]<br>=> log\[/home/zabbix/logs/logfile,,,100\]<br><br>*Using `output` parameter for extracting a number from log record:*<br>=> log\[/app1/app.log,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.<br><br>*Using `output` parameter for rewriting log record before sending to server:*<br>=> log\[/app1/app.log,"(\[0-9 :-\]+) task run (\[0-9.\]+) sec, processed (\[0-9\]+) records, (\[0-9\]+) errors",,,,"\\1 RECORDS: \\3, ERRORS: \\4, DURATION: \\2"\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to server.<br><br>See also additional information on [log monitoring](log_items).| |log.count\[file,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<|<| |<|Count of matched lines in a monitored log file.|Integer|**file** - full path and name of log file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxproclines** - maximum number of new lines per second the agent will analyze (cannot exceed 10000). Default value is 10\*'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**maxdelay** - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.4.7) - additional options:<br>*mtime-noreread* - non-unique records, reread only if the file size changes (ignore modification time change). (This parameter is deprecated since 5.0.2, because now mtime is ignored.)<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br>If file is missing or permissions do not allow access, item turns unsupported.<br><br>See also additional information on [log monitoring](log_items).<br><br>This item is not supported for Windows Event Log.<br><br>Supported since Zabbix 3.2.0.| |logrt\[file\_regexp,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<|<| |<|Monitoring of a log file that is rotated.|Log|**file\_regexp** - absolute path to file and the file name described by a regular [expression](/manual/regular_expressions#overview). *Note* that only the file name is a regular expression<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required content pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxlines** - maximum number of new lines per second the agent will send to Zabbix server or proxy. This parameter overrides the value of 'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**mode** (since version 2.0) - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**output** (since version 2.2) - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).<br>**maxdelay** (since version 3.2) - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.0; *mtime-reread*, *mtime-noreread* options since 4.4.7) - type of log file rotation and other options. Possible values:<br>*rotate* (default),<br>*copytruncate* - note that *copytruncate* cannot be used together with *maxdelay*. In this case *maxdelay* must be 0 or not specified; see [copytruncate](log_items#notes_on_handling_copytruncate_log_file_rotation) notes,<br>*mtime-reread* - non-unique records, reread if modification time or size changes (default),<br>*mtime-noreread* - non-unique records, reread only if the size changes (ignore modification time change).<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br>Log rotation is based on the last modification time of files.<br><br>Note that logrt is designed to work with one currently active log file, with several other matching inactive files rotated. If, for example, a directory has many active log files, a separate logrt item should be created for each one. Otherwise if one logrt item picks up too many files it may lead to exhausted memory and a crash of monitoring.<br><br>If `output` is left empty - the whole line containing the matched text is returned. Note that all global regular expression types except 'Result is TRUE' always return the whole matched line and the `output` parameter is ignored.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>Examples:<br>=> logrt\["/home/zabbix/logs/\^logfile\[0-9\]{1,3}$",,,100\] → will match a file like "logfile1" (will not match ".logfile1")<br>=> logrt\["/home/user/\^logfile\_.\*\_\[0-9\]{1,3}$","pattern\_to\_match","UTF-8",100\] → will collect data from files such "logfile\_abc\_1" or "logfile\_\_001".<br><br>*Using `output` parameter for extracting a number from log record:*<br>=> logrt\[/app1/\^test.\*log$,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.<br><br>*Using `output` parameter for rewriting log record before sending to server:*<br>=> logrt\[/app1/\^test.\*log$,"(\[0-9 :-\]+) task run (\[0-9.\]+) sec, processed (\[0-9\]+) records, (\[0-9\]+) errors",,,,"\\1 RECORDS: \\3, ERRORS: \\4, DURATION: \\2"\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to server.<br><br>See also additional information on [log monitoring](log_items).| |logrt.count\[file\_regexp,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<|<| |<|Count of matched lines in a monitored log file that is rotated.|Integer|**file\_regexp** - absolute path to file and regular [expression](/manual/regular_expressions#overview) describing the file name pattern<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required content pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxproclines** - maximum number of new lines per second the agent will analyze (cannot exceed 10000). Default value is 10\*'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**maxdelay** - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.0; *mtime-reread*, *mtime-noreread* options since 4.4.7) - type of log file rotation and other options. Possible values:<br>*rotate* (default),<br>*copytruncate* - note that *copytruncate* cannot be used together with *maxdelay*. In this case *maxdelay* must be 0 or not specified; see [copytruncate](log_items#notes_on_handling_copytruncate_log_file_rotation) notes,<br>*mtime-reread* - non-unique records, reread if modification time or size changes (default),<br>*mtime-noreread* - non-unique records, reread only if the size changes (ignore modification time change).<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br>Log rotation is based on the last modification time of files.<br><br>See also additional information on [log monitoring](log_items).<br><br>This item is not supported for Windows Event Log.<br><br>Supported since Zabbix 3.2.0.| |modbus.get\[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>\]|<|<|<|<| |<|Reads Modbus data.|JSON object|**endpoint** - endpoint defined as `protocol://connection_string`<br>**slave id** - slave ID<br>**function** - Modbus function<br>**address** - address of first registry, coil or input<br>**count** - number of records to read<br>**type** - type of data<br>**endianness** - endianness configuration<br>**offset** - number of registers, starting from 'address', the results of which will be discarded.<br><br>See a [detailed description](/manual/appendix/items/modbus) of parameters.|Supported since Zabbix 5.2.0.| |net.dns\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<|<| |<|Checks if DNS service is up.|0 - DNS is down (server did not respond or DNS resolution failed)<br><br>1 - DNS is up|**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows) - number of tries for the request (default is 2)<br>**protocol** (since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (except for Windows), *HINFO*, *MINFO*, *TXT*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns*| |net.dns.record\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<|<| |<|Performs a DNS query.|Character string with the required type of information|**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows) - number of tries for the request (default is 2)<br>**protocol**(since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns.record\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (except for Windows), *HINFO*, *MINFO*, *TXT*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns.query*| |net.if.collisions\[if\]|<|<|<|<| |<|Number of out-of-window collisions.|Integer|**if** - network interface name| | |net.if.discovery|<|<|<|<| |<|List of network interfaces. Used for low-level discovery.|JSON object| |Supported since Zabbix 2.0.<br><br>On FreeBSD, OpenBSD and NetBSD supported since Zabbix 2.2.<br><br>Some Windows versions (for example, Server 2008) might require the latest updates installed to support non-ASCII characters in interface names.| |net.if.in\[if,<mode>\]|<|<|<|<| |<|Incoming traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*frame* - the number of packet framing errors<br>*compressed* - the number of compressed packets transmitted or received by the device driver<br>*multicast* - the number of multicast frames received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix 1.8.6.<br><br>Examples:<br>=> net.if.in\[eth0,errors\]<br>=> net.if.in\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |net.if.out\[if,<mode>\]|<|<|<|<| |<|Outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*collisions (colls)* - the number of collisions detected on the interface<br>*carrier* - the number of carrier losses detected by the device driver<br>*compressed* - the number of compressed packets transmitted by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix agent 1.8.6 version.<br><br>Examples:<br>=> net.if.out\[eth0,errors\]<br>=> net.if.out\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |net.if.total\[if,<mode>\]|<|<|<|<| |<|Sum of incoming and outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*compressed* - the number of compressed packets transmitted or received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Examples:<br>=> net.if.total\[eth0,errors\]<br>=> net.if.total\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.<br><br>Note that dropped packets are supported only if both net.if.in and net.if.out work for dropped packets on your platform.| |net.tcp.listen\[port\]|<|<|<|<| |<|Checks if this TCP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - TCP port number|Example:<br>=> net.tcp.listen\[80\]<br><br>On Linux supported since Zabbix 1.8.4<br><br>Since Zabbix 3.0.0, on Linux kernels 2.6.14 and above, information about listening TCP sockets is obtained from the kernel's NETLINK interface, if possible. Otherwise, the information is retrieved from /proc/net/tcp and /proc/net/tcp6 files.| |net.tcp.port\[<ip>,port\]|<|<|<|<| |<|Checks if it is possible to make TCP connection to specified port.|0 - cannot connect<br><br>1 - can connect|**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number|Example:<br>=> net.tcp.port\[,80\] → can be used to test availability of web server running on port 80.<br><br>For simple TCP performance testing use net.tcp.service.perf\[tcp,<ip>,<port>\]<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).| |net.tcp.service\[service,<ip>,<port>\]|<|<|<|<| |<|Checks if service is running and accepting TCP connections.|0 - service is down<br><br>1 - service is running|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP address (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service\[ftp,,45\] → can be used to test the availability of FTP server on TCP port 45.<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.port for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>See also [known issues](/manual/installation/known_issues#https_checks) of checking HTTPS service.<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |net.tcp.service.perf\[service,<ip>,<port>\]|<|<|<|<| |<|Checks performance of TCP service.|0 - service is down<br><br>seconds - the number of seconds spent while connecting to the service|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP address (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service.perf\[ssh\] → can be used to test the speed of initial response from SSH server.<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.service.perf\[tcp,<ip>,<port>\] for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>See also [known issues](/manual/installation/known_issues#https_checks) of checking HTTPS service.<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |net.tcp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<|<| |<|Return the number of TCP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *syn\_sent*, *syn\_recv*, *fin\_wait1*, *fin\_wait2*, *time\_wait*, *close*, *close\_wait*, *last\_ack*, *listen*, *closing*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.tcp.socket.count\[,80,,,established\] → check if local TCP port 80 is in "established" state<br><br>This item is supported since Zabbix 6.0.| |net.udp.listen\[port\]|<|<|<|<| |<|Checks if this UDP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - UDP port number|Example:<br>=> net.udp.listen\[68\]<br><br>On Linux supported since Zabbix 1.8.4| |net.udp.service\[service,<ip>,<port>\]|<|<|<|<| |<|Checks if service is running and responding to UDP requests.|0 - service is down<br><br>1 - service is running|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP address (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service\[ntp,,45\] → can be used to test the availability of NTP service on UDP port 45.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |net.udp.service.perf\[service,<ip>,<port>\]|<|<|<|<| |<|Checks performance of UDP service.|0 - service is down<br><br>seconds - the number of seconds spent waiting for response from the service|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP address (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service.perf\[ntp\] → can be used to test response time from NTP service.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |net.udp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<|<| |<|Return the number of TCP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *unconn*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.udp.socket.count\[,,,,listening\] → check if any UDP socket is in "listening" state<br><br>This item is supported since Zabbix 6.0.| |proc.cpu.util\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]|<|<|<|<| |<|Process CPU utilization percentage.|Float|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**type** - CPU utilization type:<br>*total* (default), *user*, *system*<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**mode** - data gathering mode: *avg1* (default), *avg5*, *avg15*<br>**zone** - target zone: *current* (default), *all*. This parameter is supported on Solaris only.|Examples:<br>=> proc.cpu.util\[,root\] → CPU utilization of all processes running under the "root" user<br>=> proc.cpu.util\[zabbix\_server,zabbix\] → CPU utilization of all zabbix\_server processes running under the zabbix user<br><br>The returned value is based on single CPU core utilization percentage. For example CPU utilization of a process fully using two cores is 200%.<br><br>The process CPU utilization data is gathered by a collector which supports the maximum of 1024 unique (by name, user and command line) queries. Queries not accessed during the last 24 hours are removed from the collector.<br><br>*Note* that when setting the `zone` parameter to *current* (or default) in case the agent has been compiled on a Solaris without zone support, but running on a newer Solaris where zones are supported, then the agent will return NOTSUPPORTED (the agent cannot limit results to only the current zone). However, *all* is supported in this case.<br><br>This key is supported since Zabbix 3.0.0 and is available on several platforms (see [Items supported by platform](/manual/appendix/items/supported_by_platform)).| |proc.mem\[<name>,<user>,<mode>,<cmdline>,<memtype>\]|<|<|<|<| |<|Memory used by process in bytes.|Integer - with `mode` as *max*, *min*, *sum*<br><br>Float - with `mode` as *avg*|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**mode** - possible values:<br>*avg*, *max*, *min*, *sum* (default)<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**memtype** - [type of memory](/manual/appendix/items/proc_mem_notes) used by process|Examples:<br>=> proc.mem\[,root\] → memory used by all processes running under the "root" user<br>=> proc.mem\[zabbix\_server,zabbix\] → memory used by all zabbix\_server processes running under the zabbix user<br>=> proc.mem\[,oracle,max,oracleZABBIX\] → memory used by the most memory-hungry process running under oracle having oracleZABBIX in its command line<br><br>*Note*: When several processes use shared memory, the sum of memory used by processes may result in large, unrealistic values.<br><br>See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).<br><br>When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.mem[,,,apache2]`), one extra process will be counted, as the agent will count itself.<br><br>The `memtype` parameter is supported on several [platforms](/manual/appendix/items/supported_by_platform) since Zabbix 3.0.0.| |proc.num\[<name>,<user>,<state>,<cmdline>,<zone>\]|<|<|<|<| |<|The number of processes.|Integer|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**state** (*disk* and *trace* options since version 3.4.0) - possible values:<br>*all* (default),<br>*disk* - uninterruptible sleep,<br>*run* - running,<br>*sleep* - interruptible sleep,<br>*trace* - stopped,<br>*zomb* - zombie<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**zone** - target zone: *current* (default), *all*. This parameter is supported on Solaris only.|Examples:<br>=> proc.num\[,mysql\] → number of processes running under the mysql user<br>=> proc.num\[apache2,www-data\] → number of apache2 processes running under the www-data user<br>=> proc.num\[,oracle,sleep,oracleZABBIX\] → number of processes in sleep state running under oracle having oracleZABBIX in its command line<br><br>See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).<br><br>On Windows, only the `name` and `user` parameters are supported.<br><br>When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.num[,,,apache2]`), one extra process will be counted, as the agent will count itself.<br><br>*Note* that when setting the `zone` parameter to *current* (or default) in case the agent has been compiled on a Solaris without zone support, but running on a newer Solaris where zones are supported, then the agent will return NOTSUPPORTED (the agent cannot limit results to only the current zone). However, *all* is supported in this case.| |sensor\[device,sensor,<mode>\]|<|<|<|<| |<|Hardware sensor reading.|Float|**device** - device name<br>**sensor** - sensor name<br>**mode** - possible values:<br>*avg*, *max*, *min* (if this parameter is omitted, device and sensor are treated verbatim).|Reads /proc/sys/dev/sensors on Linux 2.4.<br><br>Example:<br>=> sensor\[w83781d-i2c-0-2d,temp1\]<br><br>Prior to Zabbix 1.8.4, the *sensor\[temp1\]* format was used.| |^|^|^|^|Reads /sys/class/hwmon on Linux 2.6+.<br><br>See a more detailed description of [sensor](/manual/appendix/items/sensor) item on Linux.| |^|^|^|^|Reads the *hw.sensors* MIB on OpenBSD.<br><br>Examples:<br>=> sensor\[cpu0,temp0\] → temperature of one CPU<br>=> sensor\["cpu\[0-2\]$",temp,avg\] → average temperature of the first three CPU's<br><br>Supported on OpenBSD since Zabbix 1.8.4.| |system.boottime|<|<|<|<| |<|System boot time.|Integer (Unix timestamp)| | | |system.cpu.discovery|<|<|<|<| |<|List of detected CPUs/CPU cores. Used for low-level discovery.|JSON object| |Supported on all platforms since 2.4.0.| |system.cpu.intr|<|<|<|<| |<|Device interrupts.|Integer| | | |system.cpu.load\[<cpu>,<mode>\]|<|<|<|<| |<|[CPU load](http://en.wikipedia.org/wiki/Load_(computing)).|Float|**cpu** - possible values:<br>*all* (default), *percpu* (since version 2.0; total load divided by online CPU count)<br>**mode** - possible values:<br>*avg1* (one-minute average, default), *avg5*, *avg15*|Example:<br>=> system.cpu.load\[,avg5\].| |system.cpu.num\[<type>\]|<|<|<|<| |<|Number of CPUs.|Integer|**type** - possible values:<br>*online* (default), *max*|Example:<br>=> system.cpu.num| |system.cpu.switches|<|<|<|<| |<|Count of context switches.|Integer| | | |system.cpu.util\[<cpu>,<type>,<mode>,<logical\_or\_physical>\]|<|<|<|<| |<|CPU utilization percentage.|Float|**cpu** - *<CPU number>* or *all* (default)<br>**type** - possible values:<br>*user* (default), *idle*, *nice*, *system* (default for Windows), *iowait*, *interrupt*, *softirq*, *steal*, *guest* (on Linux kernels 2.6.24 and above), *guest\_nice* (on Linux kernels 2.6.33 and above).<br>See also [platform-specific](/manual/appendix/items/supported_by_platform) details for this parameter.<br>**mode** - possible values:<br>*avg1* (one-minute average, default), *avg5*, *avg15*<br>**logical\_or\_physical** (since version 5.0.3; on AIX only) - possible values: *logical* (default), *physical*. This parameter is supported on AIX only.|Example:<br>=> system.cpu.util\[0,user,avg5\]<br><br>Old naming: *system.cpu.idleX, system.cpu.niceX, system.cpu.systemX, system.cpu.userX*| |system.hostname\[<type>, <transform>\]|<|<|<|<| |<|System host name.|String|**type** (before version 5.4.7 supported on Windows only) - possible values: *netbios* (default on Windows), *host* (default on Linux), *shorthost* (since version 5.4.7; returns part of the hostname before the first dot, a full string for names without dots).<br>**transform** (since version 5.4.7) - possible values:<br>*none* (default), *lower* (convert to lowercase)|The value is acquired by either GetComputerName() (for **netbios**) or gethostname() (for **host**) functions on Windows and by "hostname" command on other systems.<br><br>Examples of returned values:<br>*on Linux*:<br>=> system.hostname → linux-w7x1<br>=> system.hostname → example.com<br>=> system.hostname\[shorthost\] → example<br>*on Windows*:<br>=> system.hostname → WIN-SERV2008-I6<br>=> system.hostname\[host\] → Win-Serv2008-I6LonG<br>=> system.hostname\[host,lower\] → win-serv2008-i6long<br><br>See also a [more detailed description](/manual/appendix/install/windows_agent#configuration).| |system.hw.chassis\[<info>\]|<|<|<|<| |<|Chassis information.|String|**info** - one of full (default), model, serial, type or vendor|Example: system.hw.chassis\[full\]<br>Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop\]<br><br>This key depends on the availability of the [SMBIOS](http://en.wikipedia.org/wiki/System_Management_BIOS) table.<br>Will try to read the DMI table from sysfs, if sysfs access fails then try reading directly from memory.<br><br>**Root permissions** are required because the value is acquired by reading from sysfs or memory.<br><br>Supported since Zabbix 2.0.| |system.hw.cpu\[<cpu>,<info>\]|<|<|<|<| |<|CPU information.|String or integer|**cpu** - *<CPU number>* or *all* (default)<br>**info** - possible values:<br>*full* (default), *curfreq*, *maxfreq*, *model* or *vendor*|Example:<br>=> system.hw.cpu\[0,vendor\] → AuthenticAMD<br><br>Gathers info from /proc/cpuinfo and /sys/devices/system/cpu/\[cpunum\]/cpufreq/cpuinfo\_max\_freq.<br><br>If a CPU number and *curfreq* or *maxfreq* is specified, a numeric value is returned (Hz).<br><br>Supported since Zabbix 2.0.| |system.hw.devices\[<type>\]|<|<|<|<| |<|Listing of PCI or USB devices.|Text|**type** (since version 2.0) - *pci* (default) or *usb*|Example:<br>=> system.hw.devices\[pci\] → 00:00.0 Host bridge: Advanced Micro Devices \[AMD\] RS780 Host Bridge<br>\[..\]<br><br>Returns the output of either lspci or lsusb utility (executed without any parameters).| |system.hw.macaddr\[<interface>,<format>\]|<|<|<|<| |<|Listing of MAC addresses.|String|**interface** - *all* (default) or a regular [expression](/manual/regular_expressions#overview)<br>**format** - *full* (default) or *short*|Lists MAC addresses of the interfaces whose name matches the given `interface` regular [expression](/manual/regular_expressions#overview) (*all* lists for all interfaces).<br><br>Example:<br>=> system.hw.macaddr\["eth0$",full\] → \[eth0\] 00:11:22:33:44:55<br><br>If `format` is specified as *short*, interface names and identical MAC addresses are not listed.<br><br>Supported since Zabbix 2.0.| |system.localtime\[<type>\]|<|<|<|<| |<|System time.|Integer - with `type` as *utc*<br><br>String - with `type` as *local*|**type** (since version 2.0) - possible values:<br>*utc* - (default) the time since the Epoch (00:00:00 UTC, January 1, 1970), measured in seconds.<br>*local* - the time in the 'yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm' format<br>|Must be used as a [passive check](/manual/appendix/items/activepassive#passive_checks) only.<br><br>Example:<br>=> system.localtime\[local\] → create an item using this key and then use it to display host time in the *Clock* [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#clock).| |system.run\[command,<mode>\]|<|<|<|<| |<|Run specified command on the host.|Text result of the command<br><br>1 - with `mode` as *nowait* (regardless of command result)|**command** - command for execution<br>**mode** - possible values:<br>*wait* - wait end of execution (default),<br>*nowait* - do not wait|Up to 512KB of data can be returned, including trailing whitespace that is truncated.<br>To be processed correctly, the output of the command must be text.<br><br>Example:<br>=> system.run\[ls -l /\] → detailed file list of root directory.<br><br>*Note*: system.run items are disabled by default. Learn how to [enable them](/manual/config/items/restrict_checks).<br><br>The return value of the item is standard output together with standard error produced by command. The exit code is not checked.<br><br>Empty result is allowed starting with Zabbix 2.4.0.<br>See also: [Command execution](/manual/appendix/command_execution).| |system.stat\[resource,<type>\]|<|<|<|<| |<|System statistics.|Integer or float|**ent** - number of processor units this partition is entitled to receive (float)<br>**kthr,<type>** - information about kernel thread states:<br>*r* - average number of runnable kernel threads (float)<br>*b* - average number of kernel threads placed in the Virtual Memory Manager wait queue (float)<br>**memory,<type>** - information about the usage of virtual and real memory:<br>*avm* - active virtual pages (integer)<br>*fre* - size of the free list (integer)<br>**page,<type>** - information about page faults and paging activity:<br>*fi* - file page-ins per second (float)<br>*fo* - file page-outs per second (float)<br>*pi* - pages paged in from paging space (float)<br>*po* - pages paged out to paging space (float)<br>*fr* - pages freed (page replacement) (float)<br>*sr* - pages scanned by page-replacement algorithm (float)<br>**faults,<type>** - trap and interrupt rate:<br>*in* - device interrupts (float)<br>*sy* - system calls (float)<br>*cs* - kernel thread context switches (float)<br>**cpu,<type>** - breakdown of percentage usage of processor time:<br>*us* - user time (float)<br>*sy* - system time (float)<br>*id* - idle time (float)<br>*wa* - idle time during which the system had outstanding disk/NFS I/O request(s) (float)<br>*pc* - number of physical processors consumed (float)<br>*ec* - the percentage of entitled capacity consumed (float)<br>*lbusy* - indicates the percentage of logical processor(s) utilization that occurred while executing at the user and system level (float)<br>*app* - indicates the available physical processors in the shared pool (float)<br>**disk,<type>** - disk statistics:<br>*bps* - indicates the amount of data transferred (read or written) to the drive in bytes per second (integer)<br>*tps* - indicates the number of transfers per second that were issued to the physical disk/tape (float)|<| |<|^|^|Comments|<| |<|^|^|This item is [supported](/manual/appendix/items/supported_by_platform) on AIX only, since Zabbix 1.8.1.<br>Take note of the following limitations in these items:<br>=> system.stat\[cpu,app\] - supported only on AIX LPAR of type "Shared"<br>=> system.stat\[cpu,ec\] - supported on AIX LPAR of type "Shared" and "Dedicated" ("Dedicated" always returns 100 (percent))<br>=> system.stat\[cpu,lbusy\] - supported only on AIX LPAR of type "Shared"<br>=> system.stat\[cpu,pc\] - supported on AIX LPAR of type "Shared" and "Dedicated"<br>=> system.stat\[ent\] - supported on AIX LPAR of type "Shared" and "Dedicated"|<| |system.sw.arch|<|<|<|<| |<|Software architecture information.|String| |Example:<br>=> system.sw.arch → i686<br><br>Info is acquired from uname() function.<br><br>Supported since Zabbix 2.0.| |system.sw.os\[<info>\]|<|<|<|<| |<|Operating system information.|String|**info** - possible values:<br>*full* (default), *short* or *name*|Example:<br>=> system.sw.os\[short\]→ Ubuntu 2.6.35-28.50-generic 2.6.35.11<br><br>Info is acquired from (note that not all files and options are present in all distributions):<br>/proc/version (*full*)<br>/proc/version\_signature (*short*)<br>PRETTY\_NAME parameter from /etc/os-release on systems supporting it, or /etc/issue.net (*name*)<br><br>Supported since Zabbix 2.0.| |system.sw.packages\[<package>,<manager>,<format>\]|<|<|<|<| |<|Listing of installed packages.|Text|**package** - *all* (default) or a regular [expression](/manual/regular_expressions#overview)<br>**manager** - *all* (default) or a package manager<br>**format** - *full* (default) or *short*|Lists (alphabetically) installed packages whose name matches the given `package` regular [expression](/manual/regular_expressions#overview) (*all* lists them all).<br><br>Example:<br>=> system.sw.packages\[mini,dpkg,short\] → python-minimal, python2.6-minimal, ubuntu-minimal<br><br>Supported package managers (executed command):<br>dpkg (dpkg --get-selections)<br>pkgtool (ls /var/log/packages)<br>rpm (rpm -qa)<br>pacman (pacman -Q)<br><br>If `format` is specified as *full*, packages are grouped by package managers (each manager on a separate line beginning with its name in square brackets).<br>If `format` is specified as *short*, packages are not grouped and are listed on a single line.<br><br>Supported since Zabbix 2.0.| |system.swap.in\[<device>,<type>\]|<|<|<|<| |<|Swap in (from device into memory) statistics.|Integer|**device** - device used for swapping (default is *all*)<br>**type** - possible values:<br>*count* (number of swapins), *sectors* (sectors swapped in), *pages* (pages swapped in).<br>See also [platform-specific](/manual/appendix/items/supported_by_platform) details for this parameter.|Example:<br>=> system.swap.in\[,pages\]<br><br>The source of this information is:<br>/proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)<br>/proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)| |system.swap.out\[<device>,<type>\]|<|<|<|<| |<|Swap out (from memory onto device) statistics.|Integer|**device** - device used for swapping (default is *all*)<br>**type** - possible values:<br>*count* (number of swapouts), *sectors* (sectors swapped out), *pages* (pages swapped out).<br>See also [platform-specific](/manual/appendix/items/supported_by_platform) details for this parameter.|Example:<br>=> system.swap.out\[,pages\]<br><br>The source of this information is:<br>/proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)<br>/proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)| |system.swap.size\[<device>,<type>\]|<|<|<|<| |<|Swap space size in bytes or in percentage from total.|Integer - for bytes<br><br>Float - for percentage|**device** - device used for swapping (default is *all*)<br>**type** - possible values:<br>*free* (free swap space, default), *pfree* (free swap space, in percent), *pused* (used swap space, in percent), *total* (total swap space), *used* (used swap space)<br>Note that *pfree*, *pused* are not supported on Windows if swap size is 0.<br>See also [platform-specific](/manual/appendix/items/supported_by_platform) details for this parameter.|Example:<br>=> system.swap.size\[,pfree\] → free swap space percentage<br><br>If *device* is not specified Zabbix agent will only take into account swap devices (files), physical memory will be ignored. For example, on Solaris systems *swap -s* command includes a portion of physical memory and swap devices (unlike *swap -l*).<br><br>Note that this key might report incorrect swap space size/percentage on virtualized (VMware ESXi, VirtualBox) Windows platforms. In this case you may use the `perf_counter[\700(_Total)\702]` key to obtain correct swap space percentage.| |system.uname|<|<|<|<| |<|Identification of the system.|String| |Example of returned value (Unix):<br>FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE \#0: Mon Nov i386<br><br>Example of returned value (Windows):<br>Windows ZABBIX-WIN 6.0.6001 Microsoft® Windows Server® 2008 Standard Service Pack 1 x86<br><br>On Unix since Zabbix 2.2.0 the value for this item is obtained with uname() system call. Previously it was obtained by invoking "uname -a". The value of this item might differ from the output of "uname -a" and does not include additional information that "uname -a" prints based on other sources.<br><br>On Windows since Zabbix 3.0 the value for this item is obtained from Win32\_OperatingSystem and Win32\_Processor WMI classes. Previously it was obtained from volatile Windows APIs and undocumented registry keys. The OS name (including edition) might be translated to the user's display language. On some versions of Windows it contains trademark symbols and extra spaces.<br><br>Note that on Windows the item returns OS architecture, whereas on Unix it returns CPU architecture.| |system.uptime|<|<|<|<| |<|System uptime in seconds.|Integer| |In [item configuration](/manual/config/items/item#configuration), use **s** or **uptime** units to get readable values.| |system.users.num|<|<|<|<| |<|Number of users logged in.|Integer| |**who** command is used on the agent side to obtain the value.| |vfs.dev.discovery|<|<|<|<| |<|List of block devices and their type. Used for low-level discovery.|JSON object| |This item is supported on Linux platform only.<br><br>Supported since Zabbix 4.4.0.| |vfs.dev.read\[<device>,<type>,<mode>\]|<|<|<|<| |<|Disk read statistics.|Integer - with `type` in *sectors*, *operations*, *bytes*<br><br>Float - with `type` in *sps*, *ops*, *bps*<br><br>*Note*: if using an update interval of three hours or more^**[2](#footnotes)**^, will always return '0'|**device** - disk device (default is *all* ^**[3](#footnotes)**^)<br>**type** - possible values: *sectors*, *operations*, *bytes*, *sps*, *ops*, *bps*<br>Note that 'type' parameter support and defaults depend on the platform. See [platform-specific](/manual/appendix/items/supported_by_platform) details.<br>*sps*, *ops*, *bps* stand for: sectors, operations, bytes per second, respectively.<br>**mode** - possible values: *avg1* (one-minute average, default), *avg5*, *avg15*.<br>This parameter is supported only with `type` in: sps, ops, bps.|You may use relative device names (for example, `sda`) as well as an optional /dev/ prefix (for example, `/dev/sda`).<br><br>LVM logical volumes are supported.<br><br>Default values of 'type' parameter for different OSes:<br>AIX - operations<br>FreeBSD - bps<br>Linux - sps<br>OpenBSD - operations<br>Solaris - bytes<br><br>Example:<br>=> vfs.dev.read\[,operations\]<br><br>*sps*, *ops* and *bps* on supported platforms used to be limited to 8 devices (7 individual and one *all*). Since Zabbix 2.0.1 this limit is 1024 devices (1023 individual and one for *all*).| |vfs.dev.write\[<device>,<type>,<mode>\]|<|<|<|<| |<|Disk write statistics.|Integer - with `type` in *sectors*, *operations*, *bytes*<br><br>Float - with `type` in *sps*, *ops*, *bps*<br><br>*Note*: if using an update interval of three hours or more^**[2](#footnotes)**^, will always return '0'|**device** - disk device (default is *all* ^**[3](#footnotes)**^)<br>**type** - possible values: *sectors*, *operations*, *bytes*, *sps*, *ops*, *bps*<br>Note that 'type' parameter support and defaults depend on the platform. See [platform-specific](/manual/appendix/items/supported_by_platform) details.<br>*sps*, *ops*, *bps* stand for: sectors, operations, bytes per second, respectively.<br>**mode** - possible values: *avg1* (one-minute average, default), *avg5*, *avg15*.<br>This parameter is supported only with `type` in: sps, ops, bps.|You may use relative device names (for example, `sda`) as well as an optional /dev/ prefix (for example, `/dev/sda`).<br><br>LVM logical volumes are supported.<br><br>Default values of 'type' parameter for different OSes:<br>AIX - operations<br>FreeBSD - bps<br>Linux - sps<br>OpenBSD - operations<br>Solaris - bytes<br><br>Example:<br>=> vfs.dev.write\[,operations\]<br><br>*sps*, *ops* and *bps* on supported platforms used to be limited to 8 devices (7 individual and one *all*). Since Zabbix 2.0.1 this limit is 1024 (1023 individual and one for *all*).| |vfs.dir.count\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]|<|<|<|<| |<|Directory entry count.|Integer|**dir** - absolute path to directory<br>**regex\_incl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to include; include all if empty (default value)<br>**regex\_excl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to exclude; don't exclude any if empty (default value)<br>**types\_incl** - directory entry types to count, possible values:<br>*file* - regular file, *dir* - subdirectory, *sym* - symbolic link, *sock* - socket, *bdev* - block device, *cdev* - character device, *fifo* - FIFO, *dev* - synonymous with "bdev,cdev", *all* - all types (default), i.e. "file,dir,sym,sock,bdev,cdev,fifo". Multiple types must be separated with comma and quoted.<br>**types\_excl** - directory entry types (see <types\_incl>) to NOT count. If some entry type is in both <types\_incl> and <types\_excl>, directory entries of this type are NOT counted.<br>**max\_depth** - maximum depth of subdirectories to traverse. **-1** (default) - unlimited, **0** - no descending into subdirectories.<br>**min\_size** - minimum size (in bytes) for file to be counted. Smaller files will not be counted. [Memory suffixes](/manual/appendix/suffixes#memory_suffixes) can be used.<br>**max\_size** - maximum size (in bytes) for file to be counted. Larger files will not be counted. [Memory suffixes](/manual/appendix/suffixes#memory_suffixes) can be used.<br>**min\_age** - minimum age (in seconds) of directory entry to be counted. More recent entries will not be counted. [Time suffixes](/manual/appendix/suffixes#time_suffixes) can be used.<br>**max\_age** - maximum age (in seconds) of directory entry to be counted. Entries so old and older will not be counted (modification time). [Time suffixes](/manual/appendix/suffixes#time_suffixes) can be used.<br>**regex\_excl\_dir** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the directory to exclude. All content of the directory will be excluded (in contrast to regex\_excl)|Environment variables, e.g. %APP\_HOME%, $HOME and %TEMP% are not supported.<br><br>Pseudo-directories "." and ".." are never counted.<br><br>Symbolic links are never followed for directory traversal.<br><br>On Windows, directory symlinks are skipped and hard links are counted only once.<br><br>Both `regex_incl` and `regex_excl` are being applied to files and directories when calculating entry size, but are ignored when picking subdirectories to traverse (if regex\_incl is “(?i)\^.+\\.zip$” and max\_depth is not set, then all subdirectories will be traversed, but only files of type zip will be counted).<br><br>Execution time is limited by the default timeout value in agent [configuration](/manual/appendix/config/zabbix_agentd) (3 sec). Since large directory traversal may take longer than that, no data will be returned and the item will turn unsupported. Partial count will not be returned.<br><br>When filtering by size, only regular files have meaningful sizes. Under Linux and BSD, directories also have non-zero sizes (a few Kb typically). Devices have zero sizes, e.g. the size of **/dev/sda1** does not reflect the respective partition size. Therefore, when using `<min_size>` and `<max_size>`, it is advisable to specify `<types_incl>` as "*file*", to avoid surprises.<br><br>Examples:<br>⇒ vfs.dir.count\[/dev\] - monitors number of devices in /dev (Linux)<br>⇒ vfs.dir.count\["C:\\Users\\ADMINI\~1\\AppData\\Local\\Temp"\] - monitors number of files in temporary directory (Windows)<br><br>Supported since Zabbix 4.0.0.| |vfs.dir.get\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]|<|<|<|<| |<|Directory entry list.|JSON|**dir** - absolute path to directory<br>**regex\_incl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to include; include all if empty (default value)<br>**regex\_excl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to exclude; don't exclude any if empty (default value)<br>**types\_incl** - directory entry types to list, possible values:<br>*file* - regular file, *dir* - subdirectory, *sym* - symbolic link, *sock* - socket, *bdev* - block device, *cdev* - character device, *fifo* - FIFO, *dev* - synonymous with "bdev,cdev", *all* - all types (default), i.e. "file,dir,sym,sock,bdev,cdev,fifo". Multiple types must be separated with comma and quoted.<br>**types\_excl** - directory entry types (see <types\_incl>) to NOT list. If some entry type is in both <types\_incl> and <types\_excl>, directory entries of this type are NOT listed.<br>**max\_depth** - maximum depth of subdirectories to traverse. **-1** (default) - unlimited, **0** - no descending into subdirectories.<br>**min\_size** - minimum size (in bytes) for file to be listed. Smaller files will not be listed. [Memory suffixes](/manual/appendix/suffixes#memory_suffixes) can be used.<br>**max\_size** - maximum size (in bytes) for file to be listed. Larger files will not be counted. [Memory suffixes](/manual/appendix/suffixes#memory_suffixes) can be used.<br>**min\_age** - minimum age (in seconds) of directory entry to be listed. More recent entries will not be listed. [Time suffixes](/manual/appendix/suffixes#time_suffixes) can be used.<br>**max\_age** - maximum age (in seconds) of directory entry to be listed. Entries so old and older will not be listed (modification time). [Time suffixes](/manual/appendix/suffixes#time_suffixes) can be used.<br>**regex\_excl\_dir** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the directory to exclude. All content of the directory will be excluded (in contrast to regex\_excl)|Environment variables, e.g. %APP\_HOME%, $HOME and %TEMP% are not supported.<br><br>Pseudo-directories "." and ".." are never listed.<br><br>Symbolic links are never followed for directory traversal.<br><br>On Windows, directory symlinks are skipped and hard links are listed only once.<br><br>Both `regex_incl` and `regex_excl` are being applied to files and directories when calculating entry size, but are ignored when picking subdirectories to traverse (if regex\_incl is “(?i)\^.+\\.zip$” and max\_depth is not set, then all subdirectories will be traversed, but only files of type zip will be listed).<br><br>Execution time is limited by the default timeout value in agent [configuration](/manual/appendix/config/zabbix_agentd) (3 sec). Since large directory traversal may take longer than that, no data will be returned and the item will turn unsupported. Partial list will not be returned.<br><br>When filtering by size, only regular files have meaningful sizes. Under Linux and BSD, directories also have non-zero sizes (a few Kb typically). Devices have zero sizes, e.g. the size of **/dev/sda1** does not reflect the respective partition size. Therefore, when using `<min_size>` and `<max_size>`, it is advisable to specify `<types_incl>` as "*file*", to avoid surprises.<br><br>Examples:<br>⇒ vfs.dir.get\[/dev\] - retrieves device list in /dev (Linux)<br>⇒ vfs.dir.get\["C:\\Users\\ADMINI\~1\\AppData\\Local\\Temp"\] - retrieves file list in temporary directory (Windows)<br><br>Supported since Zabbix 6.0.0.| |vfs.dir.size\[dir,<regex\_incl>,<regex\_excl>,<mode>,<max\_depth>,<regex\_excl\_dir>\]|<|<|<|<| |<|Directory size (in bytes).|Integer|**dir** - absolute path to directory<br>**regex\_incl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to include; include all if empty (default value)<br>**regex\_excl** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the entity (file, directory, symbolic link) to exclude; don't exclude any if empty (default value)<br>**mode** - possible values:<br>*apparent* (default) - gets apparent file sizes rather than disk usage (acts as `du -sb dir`), *disk* - gets disk usage (acts as `du -s -B1 dir`). Unlike du command, vfs.dir.size item takes hidden files in account when calculating directory size (acts as `du -sb .[^.]* *` within dir).<br>**max\_depth** - maximum depth of subdirectories to traverse. **-1** (default) - unlimited, **0** - no descending into subdirectories.<br>**regex\_excl\_dir** - regular [expression](/manual/regular_expressions#overview) describing the name pattern of the directory to exclude. All content of the directory will be excluded (in contrast to regex\_excl)|Only directories with at least read permission for *zabbix* user are calculated.<br><br>On Windows any symlink is skipped and hard links are taken into account only once.<br><br>With large directories or slow drives this item may time out due to the Timeout setting in [agent](/manual/appendix/config/zabbix_agentd) and [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) configuration files. Increase the timeout values as necessary.<br><br>Examples:<br>⇒ vfs.dir.size\[/tmp,log\] - calculates size of all files in /tmp which contain 'log'<br>⇒ vfs.dir.size\[/tmp,log,\^.+\\.old$\] - calculates size of all files in /tmp which contain 'log', excluding files containing '.old'<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).<br><br>Supported since Zabbix 3.4.0.| |vfs.file.cksum\[file,<mode>\]|<|<|<|<| |<|File checksum, calculated by the UNIX cksum algorithm.|Integer - with `mode` as *crc32*<br><br>String - with `mode` as *md5*, *sha256*|**file** - full path to file<br>**mode** - *crc32* (default), *md5*, *sha256*|Example:<br>=> vfs.file.cksum\[/etc/passwd\]<br><br>Example of returned values (crc32/md5/sha256 respectively):<br>675436101<br>9845acf68b73991eb7fd7ee0ded23c44<br>ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).<br><br>The `mode` parameter is supported since Zabbix 6.0.| |vfs.file.contents\[file,<encoding>\]|<|<|<|<| |<|Retrieving contents of a file.|Text|**file** - full path to file<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)|Returns an empty string if the file is empty or contains LF/CR characters only.<br><br>Byte order mark (BOM) is excluded from the output.<br><br>Example:<br>=> vfs.file.contents\[/etc/passwd\]<br><br>This item is limited to files no larger than 64 Kbytes.<br><br>Supported since Zabbix 2.0.| |vfs.file.exists\[file,<types\_incl>,<types\_excl>\]|<|<|<|<| |<|Checks if file exists.|0 - not found<br><br>1 - file of the specified type exists|**file** - full path to file<br>**types\_incl** - list of file types to include, possible values: *file* (regular file, default (if types\_excl is not set)), *dir* (directory), *sym* (symbolic link), *sock* (socket), *bdev* (block device), *cdev* (character device), *fifo* (FIFO), *dev* (synonymous with "bdev,cdev"), *all* (all mentioned types, default if types\_excl is set).<br>**types\_excl** - list of file types to exclude, see types\_incl for possible values (by default no types are excluded)|Multiple types must be separated with a comma and the entire set enclosed in quotes "".<br>On Windows the double quotes have to be backslash '\\' escaped and the whole item key enclosed in double quotes when using the command line utility for calling zabbix\_get.exe or agent2.<br><br>If the same type is in both <types\_incl> and <types\_excl>, files of this type are excluded.<br><br>Examples:<br>=> vfs.file.exists\[/tmp/application.pid\]<br>=> vfs.file.exists\[/tmp/application.pid,"file,dir,sym"\]<br>=> vfs.file.exists\[/tmp/application\_dir,dir\]<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).<br><br>Note that the item may turn unsupported on Windows if a directory is searched within a non-existing directory, e.g. vfs.file.exists\[C:\\no\\dir,dir\] (where 'no' does not exist).| |vfs.file.get\[file\]|<|<|<|<| |<|Return information about a file.|JSON object|**file** - full path to file|Supported file types on UNIX-like systems: regular file, directory, symbolic link, socket, block device, character device, FIFO<br><br>Supported file types on Windows: regular file, directory, symbolic link<br><br>Example:<br>=> vfs.file.get\[/etc/passwd\] → return a JSON with information about the /etc/passwd file (type, user, permissions, SID, uid etc)<br><br>Supported since Zabbix 6.0.| |vfs.file.md5sum\[file\]|<|<|<|<| |<|MD5 checksum of file.|Character string (MD5 hash of the file)|**file** - full path to file|Example:<br>=> vfs.file.md5sum\[/usr/local/etc/zabbix\_agentd.conf\]<br><br>Example of returned value:<br>b5052decb577e0fffd622d6ddc017e82<br><br>The file size limit (64 MB) for this item was removed in version 1.8.6.<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).| |vfs.file.owner\[file,<ownertype>,<resulttype>\]|<|<|<|<| |<|Retrieve owner of a file.|Character string|**file** - full path to file<br>**ownertype** - *user* (default) or *group* (Unix only)<br>**resulttype** - *name* (default) or *id*; for id - return uid/gid on Unix, SID on Windows|Example:<br>=> vfs.file.owner\[/tmp/zabbix\_server.log\] → return file owner of /tmp/zabbix\_server.log<br>=> vfs.file.owner\[/tmp/zabbix\_server.log,,id\] → return file owner ID of /tmp/zabbix\_server.log<br><br>Supported since Zabbix 6.0.| |vfs.file.permissions\[file\]|<|<|<|<| |<|Return a 4-digit string containing the octal number with Unix permissions.|String|**file** - full path to the file|Not supported on Windows.<br><br>Example:<br>=> vfs.file.permissions\[/etc/passwd\] → return permissions of /etc/passwd, for example, '0644'<br><br>Supported since Zabbix 6.0.| |vfs.file.regexp\[file,regexp,<encoding>,<start line>,<end line>,<output>\]|<|<|<|<| |<|Find string in a file.|The line containing the matched string, or as specified by the optional `output` parameter|**file** - full path to file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**start line** - the number of first line to search (first line of file by default).<br>**end line** - the number of last line to search (last line of file by default).<br>**output** - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).|Only the first matching line is returned.<br>An empty string is returned if no line matched the expression.<br><br>Byte order mark (BOM) is excluded from the output.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>The `start line`, `end line` and `output` parameters are supported from version 2.2.<br><br>Examples:<br>=> vfs.file.regexp\[/etc/passwd,zabbix\]<br>=> vfs.file.regexp\[/path/to/some/file,"(\[0-9\]+)$",,3,5,\\1\]<br>=> vfs.file.regexp\[/etc/passwd,"\^zabbix:.:(\[0-9\]+)",,,,\\1\] → getting the ID of user *zabbix*| |vfs.file.regmatch\[file,regexp,<encoding>,<start line>,<end line>\]|<|<|<|<| |<|Find string in a file.|0 - match not found<br><br>1 - found|**file** - full path to file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**start line** - the number of first line to search (first line of file by default).<br>**end line** - the number of last line to search (last line of file by default).|Byte order mark (BOM) is ignored.<br><br>The `start line` and `end line` parameters are supported from version 2.2.<br><br>Example:<br>=> vfs.file.regmatch\[/var/log/app.log,error\]| |vfs.file.size\[file,<mode>\]|<|<|<|<| |<|File size (in bytes).|Integer|**file** - full path to file<br>**mode** - possible values:<br>*bytes* (default) or *lines* (empty lines are counted, too)|The file must have read permissions for user *zabbix*.<br><br>Example:<br>=> vfs.file.size\[/var/log/syslog\]<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).<br><br>The `mode` parameter is supported since Zabbix 6.0.| |vfs.file.time\[file,<mode>\]|<|<|<|<| |<|File time information.|Integer (Unix timestamp)|**file** - full path to the file<br>**mode** - possible values:<br>*modify* (default) - last time of modifying file content,<br>*access* - last time of reading file,<br>*change* - last time of changing file properties|Example:<br>=> vfs.file.time\[/etc/passwd,modify\]<br><br>The file size limit depends on [large file support](/manual/appendix/items/large_file_support).| |vfs.fs.discovery|<|<|<|<| |<|List of mounted filesystems and their types. Used for low-level discovery.|JSON object| |Supported since Zabbix 2.0.<br><br>The {\#FSDRIVETYPE} macro is supported on Windows since Zabbix 3.0.<br><br>The {\#FSLABEL} macro is supported on Windows since Zabbix 6.0.| |vfs.fs.get|<|<|<|<| |<|List of mounted filesystems, their types, disk space and inode statistics. Can be used for low-level discovery.|JSON object| |Supported since Zabbix 4.4.5.<br><br>The {\#FSLABEL} macro is supported on Windows since Zabbix 6.0.| |vfs.fs.inode\[fs,<mode>\]|<|<|<|<| |<|Number or percentage of inodes.|Integer - for number<br><br>Float - for percentage|**fs** - filesystem<br>**mode** - possible values:<br>*total* (default), *free*, *used*, //pfree // (free, percentage), *pused* (used, percentage)|Example:<br>=> vfs.fs.inode\[/,pfree\]| |vfs.fs.size\[fs,<mode>\]|<|<|<|<| |<|Disk space in bytes or in percentage from total.|Integer - for bytes<br><br>Float - for percentage|**fs** - filesystem<br>**mode** - possible values:<br>*total* (default), *free*, *used*, *pfree* (free, percentage), *pused* (used, percentage)|In case of a mounted volume, disk space for local file system is returned.<br><br>Example:<br>=> vfs.fs.size\[/tmp,free\]<br><br>Reserved space of a file system is taken into account and not included when using the *free* mode.| |vm.memory.size\[<mode>\]|<|<|<|<| |<|Memory size in bytes or in percentage from total.|Integer - for bytes<br><br>Float - for percentage|**mode** - possible values:<br>*total* (default), *active*, *anon*, *buffers*, *cached*, *exec*, *file*, *free*, *inactive*, *pinned*, *shared*, *slab*, *wired*, *used*, *pused* (used, percentage), *available*, *pavailable* (available, percentage)<br>See also [platform-specific](/manual/appendix/items/supported_by_platform) support and [additional details](/manual/appendix/items/vm.memory.size_params) for this parameter.|This item accepts three categories of parameters:<br><br>1) *total* - total amount of memory;<br>2) platform-specific memory types: *active*, *anon*, *buffers*, *cached*, *exec*, *file*, *free*, *inactive*, *pinned*, *shared*, *slab*, *wired*;<br>3) user-level estimates on how much memory is used and available: *used*, *pused*, *available*, *pavailable*.| |web.page.get\[host,<path>,<port>\]|<|<|<|<| |<|Get content of web page.|Web page source as text (including headers)|**host** - hostname or URL (as `scheme://host:port/path`, where only *host* is mandatory).<br>Allowed URL schemes: *http*, *https*^**[4](#footnotes)**^. Missing scheme will be treated as *http*. If URL is specified `path` and `port` must be empty. Specifying user name/password when connecting to servers that require authentication, for example: `http://user:password@www.example.com` is only possible with cURL support ^**[4](#footnotes)**^.<br>Punycode is supported in hostnames.<br>**path** - path to HTML document (default is /)<br>**port** - port number (default is 80 for HTTP)|This item turns unsupported if the resource specified in `host` does not exist or is unavailable.<br><br>`host` can be hostname, domain name, IPv4 or IPv6 address. But for IPv6 address Zabbix agent must be compiled with IPv6 support enabled.<br><br>Example:<br>=> web.page.get\[www.example.com,index.php,80\]<br>=> web.page.get\[https://www.example.com\]<br>=> web.page.get\[https://blog.example.com/?s=zabbix\]<br>=> web.page.get\[localhost:80\]<br>=> web.page.get\["\[::1\]/server-status"\]| |web.page.perf\[host,<path>,<port>\]|<|<|<|<| |<|Loading time of full web page (in seconds).|Float|**host** - hostname or URL (as `scheme://host:port/path`, where only *host* is mandatory).<br>Allowed URL schemes: *http*, *https*^**[4](#footnotes)**^. Missing scheme will be treated as *http*. If URL is specified `path` and `port` must be empty. Specifying user name/password when connecting to servers that require authentication, for example: `http://user:password@www.example.com` is only possible with cURL support ^**[4](#footnotes)**^.<br>Punycode is supported in hostnames.<br>**path** - path to HTML document (default is /)<br>**port** - port number (default is 80 for HTTP)|This item turns unsupported if the resource specified in `host` does not exist or is unavailable.<br><br>`host` can be hostname, domain name, IPv4 or IPv6 address. But for IPv6 address Zabbix agent must be compiled with IPv6 support enabled.<br><br>Example:<br>=> web.page.perf\[www.example.com,index.php,80\]<br>=> web.page.perf\[https://www.example.com\]| |web.page.regexp\[host,<path>,<port>,regexp,<length>,<output>\]|<|<|<|<| |<|Find string on a web page.|The matched string, or as specified by the optional `output` parameter|**host** - hostname or URL (as `scheme://host:port/path`, where only *host* is mandatory).<br>Allowed URL schemes: *http*, *https*^**[4](#footnotes)**^. Missing scheme will be treated as *http*. If URL is specified `path` and `port` must be empty. Specifying user name/password when connecting to servers that require authentication, for example: `http://user:password@www.example.com` is only possible with cURL support ^**[4](#footnotes)**^.<br>Punycode is supported in hostnames.<br>**path** - path to HTML document (default is /)<br>**port** - port number (default is 80 for HTTP)<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**length** - maximum number of characters to return<br>**output** - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).|This item turns unsupported if the resource specified in `host` does not exist or is unavailable.<br><br>`host` can be hostname, domain name, IPv4 or IPv6 address. But for IPv6 address Zabbix agent must be compiled with IPv6 support enabled.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>The `output` parameter is supported from version 2.2.<br><br>Example:<br>=> web.page.regexp\[www.example.com,index.php,80,OK,2\]<br>=> web.page.regexp\[https://www.example.com,,,OK,2\]| |zabbix.stats\[<ip>,<port>\]|<|<|<|<| |<|Return a set of Zabbix server or proxy internal metrics remotely.|JSON object|**ip** - IP/DNS/network mask list of servers/proxies to be remotely queried (default is 127.0.0.1)<br>**port** - port of server/proxy to be remotely queried (default is 10051)|Note that the stats request will only be accepted from the addresses listed in the 'StatsAllowedIP' [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) parameter on the target instance.<br><br>A selected set of internal metrics is returned by this item. For details, see [Remote monitoring of Zabbix stats](/manual/appendix/items/remote_stats#exposed_metrics).| |zabbix.stats\[<ip>,<port>,queue,<from>,<to>\]|<|<|<|<| |<|Return number of monitored items in the queue which are delayed on Zabbix server or proxy remotely.|JSON object|**ip** - IP/DNS/network mask list of servers/proxies to be remotely queried (default is 127.0.0.1)<br>**port** - port of server/proxy to be remotely queried (default is 10051)<br>**queue** - constant (to be used as is)<br>**from** - delayed by at least (default is 6 seconds)<br>**to** - delayed by at most (default is infinity)|Note that the stats request will only be accepted from the addresses listed in the 'StatsAllowedIP' [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) parameter on the target instance.| ##### Footnotes ^**1**^A Linux-specific note. Zabbix agent must have read-only access to filesystem */proc*. Kernel patches from www.grsecurity.org limit access rights of non-privileged users. ^**2**^ `vfs.dev.read[]`, `vfs.dev.write[]`: Zabbix agent will terminate "stale" device connections if the item values are not accessed for more than 3 hours. This may happen if a system has devices with dynamically changing paths or if a device gets manually removed. Note also that these items, if using an update interval of 3 hours or more, will always return '0'. ^**3**^ `vfs.dev.read[]`, `vfs.dev.write[]`: If default *all* is used for the first parameter then the key will return summary statistics, including all block devices like sda, sbd and their partitions (sda1, sda2, sdb3...) and multiple devices (MD raid) based on those block devices/partitions and logical volumes (LVM) based on those block devices/partitions. In such cases returned values should be considered only as relative value (dynamic in time) but not as absolute values. ^**4**^ SSL (HTTPS) is supported only if agent is compiled with cURL support. Otherwise the item will turn unsupported. ##### Key file authentication To use key based authentication for SSH items, certain changes to the server configuration are required. Open the Zabbix server configuration file ([zabbix\_server.conf](/manual/appendix/config/zabbix_server)) as `root` and look for the following line: # SSHKeyLocation= Uncomment it and set full path to a folder where public and private keys will be located: SSHKeyLocation=/home/zabbix/.ssh Save the file and restart zabbix\_server afterwards. */home/zabbix* here is the home directory for the *zabbix* user account and *.ssh* is a directory where by default public and private keys will be generated by a [ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen) command inside the home directory. Usually installation packages of zabbix-server from different OS distributions create *zabbix* user account with a home directory in not very well-known places (as for system accounts), e. g. */var/lib/zabbix*. Before starting to generate the keys, an approach to reallocate the home directory to a better known place (intuitively expected) could be considered. This will correspond with the *SSHKeyLocation* Zabbix server configuration parameter mentioned above. These steps can be skipped if *zabbix* account has been added manually according to the [installation section](/manual/installation/install#create_user_account) because in this case most likely the home directory is already located at */home/zabbix*. To change the setting for the *zabbix* user account all working processes which are using it have to be stopped: # service zabbix-agent stop # service zabbix-server stop To change the home directory location with an attempt to move it (if it exists) a command should be executed: # usermod -m -d /home/zabbix zabbix It's absolutely possible that a home directory did not exist in the old place, so it should be created at the new place. A safe attempt to do that is: # test -d /home/zabbix || mkdir /home/zabbix To be sure that all is secure, additional commands could be executed to set permissions to the home directory: # chown zabbix:zabbix /home/zabbix # chmod 700 /home/zabbix Previously stopped processes now can be started again: # service zabbix-agent start # service zabbix-server start Now steps to generate public and private keys can be performed by a command: # sudo -u zabbix ssh-keygen -t rsa Generating public/private rsa key pair. Enter file in which to save the key (/home/zabbix/.ssh/id_rsa): Created directory '/home/zabbix/.ssh'. Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /home/zabbix/.ssh/id_rsa. Your public key has been saved in /home/zabbix/.ssh/id_rsa.pub. The key fingerprint is: 90:af:e4:c7:e3:f0:2e:5a:8d:ab:48:a2:0c:92:30:b9 zabbix@it0 The key's randomart image is: +--[ RSA 2048]----+ | | | . | | o | | . o | |+ . S | |.+ o = | |E . * = | |=o . ..* . | |... oo.o+ | +-----------------+ Note: public and private keys (*id\_rsa.pub* and *id\_rsa* respectively) have been generated by default in the */home/zabbix/.ssh* directory which corresponds to the Zabbix server *SSHKeyLocation* configuration parameter. ::: noteimportant Key types other than "rsa" may be supported by the ssh-keygen tool and SSH servers but they may not be supported by libssh2, used by Zabbix. ::: ##### キーファイル認証 SSHアイテムに鍵ベースの認証を使用するためには、サーバーに特定の設定を行うことが必要です。 Zabbixサーバーの設定ファイル([zabbix_server.conf](/manual/appendix/config/zabbix_server))をroot権限で開き、以下の行を確認します。 # SSHKeyLocation= コメントを外して、公開鍵と秘密鍵が格納されるフォルダのフルパスを設定します。 SSHKeyLocation=/home/zabbix/.ssh ファイルを保存し、その後 zabbix\_serverを再起動します。 */home/zabbix* ここに *zabbix* ユーザアカウントのホームディレクトリがあります。*/.ssh は、ホームディレクトリ内で[ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen) コマンドを使用して公開鍵と秘密鍵を生成するディレクトリです。 通常、様々なOSディストリビューションからのzabbix-serverインストールパッケージでは、あまり知られていない場所（システムアカウントのように）にホームディレクトリを持つ*zabbix*ユーザーアカウントを作成します。例えば */var/lib/zabbix*) 。 鍵の生成を開始する前に、ホームディレクトリをより良く知られた場所(直感的に予想できる場所)に再配置するアプローチを検討することができます。これは、前述の *SSHKeyLocation* というZabbix server の設定パラメータに対応します。 [ソースコードからのインストール](/manual/installation/install#create_user_account)に従って手動で *zabbix* アカウントを追加した場合、ホームディレクトリが既に */home/zabbix* にある可能性が高いため、これらの手順は省略することができます。 *zabbix* ユーザーアカウントの設定を変更するには、そのアカウントを使用しているすべての作業プロセスを停止する必要があります。 # service zabbix-agent stop # service zabbix-server stop ホームディレクトリの場所を変更するには（存在する場合）、コマンドを実行する必要があります。 # usermod -m -d /home/zabbix zabbix 古い場所にホームディレクトリが存在しない可能性が十分にあるので、新しい場所に作成する必要があります。そのためには以下のように実行します： # test -d /home/zabbix || mkdir /home/zabbix すべてが安全であることを確認するために、追加のコマンドを実行して、ホームディレクトリのパーミッションを設定することができます。 # chown zabbix:zabbix /home/zabbix # chmod 700 /home/zabbix 停止していたプロセスを再び起動できるようになります： # service zabbix-agent start # service zabbix-server start これで、公開鍵と秘密鍵を生成する手順を、コマンドで実行できるようになりました: # sudo -u zabbix ssh-keygen -t rsa Generating public/private rsa key pair. Enter file in which to save the key (/home/zabbix/.ssh/id_rsa): Created directory '/home/zabbix/.ssh'. Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /home/zabbix/.ssh/id_rsa. Your public key has been saved in /home/zabbix/.ssh/id_rsa.pub. The key fingerprint is: 90:af:e4:c7:e3:f0:2e:5a:8d:ab:48:a2:0c:92:30:b9 zabbix@it0 The key's randomart image is: +--[ RSA 2048]----+ | | | . | | o | | . o | |+ . S | |.+ o = | |E . * = | |=o . ..* . | |... oo.o+ | +-----------------+ 注: 公開鍵と秘密鍵(それぞれ *id\_rsa.pub* と *id\_rsa*) は、デフォルトで Zabbixサーバーの *SSHKeyLocation* 設定パラメータに対応する */home/zabbix/.ssh* ディレクトリに生成されています。 ::: noteimportant "rsa" 以外の鍵の種類は、ssh-keygenツールやSSHサーバーではサポートされていますが、Zabbixで使用されているlibssh2ではサポートされていない場合があります。 ::: #### Key name The key name itself has a limited range of allowed characters, which just follow each other. Allowed characters are: 0-9a-zA-Z_-. Which means: - all numbers; - all lowercase letters; - all uppercase letters; - underscore; - dash; - dot.  #### キー名 キー名自体には、使用できる文字の範囲が限られており、その文字が相互に続くだけです。 許容される文字は、 0-9a-zA-Z_-. つまり、以下の文字種を指します。 - すべての数字 - すべての小文字 - すべての大文字 - アンダースコア - ダッシュ - ドット  #### Key parameters An item key can have multiple parameters that are comma separated.  Each key parameter can be either a quoted string, an unquoted string or an array.  The parameter can also be left empty, thus using the default value. In that case, the appropriate number of commas must be added if any further parameters are specified. For example, item key **icmpping\[,,200,,500\]** would specify that the interval between individual pings is 200 milliseconds, timeout - 500 milliseconds, and all other parameters are left at their defaults. It is possible to include macros in the parameters. Those can be [user macros](/manual/appendix/macros/supported_by_location_user#items-item-prototypes) or some of the built-in macros. To see what particular built-in macros are supported in item key parameters, search the page [Supported macros](/manual/appendix/macros/supported_by_location) for "item key parameters". #### キーパラメーター アイテムキーは、カンマ区切りで複数のパラメーターを持つことができます。  各キーパラメーターは、引用符で囲まれた文字列、引用符で囲まれていない文字列、または配列のいずれかになります。  また、パラメーターを空にして、デフォルト値を使用することも可能です。その場合、さらにパラメーターを指定する場合は、適切な数のカンマを追加する必要があります。例えば、アイテムキー**icmpping\[,,200,,500\]**は、個々のpingの間隔が200ミリ秒、pingのタイムアウトが500ミリ秒、その他のパラメーターはデフォルトのままです。 パラメーターにマクロを含めることができます。マクロは[ユーザーマクロ](/manual/appendix/macros/supported_by_location_user#items-item-prototypes)または組み込みマクロの一部です。アイテムキーパラメーターでサポートされている特定の組み込みマクロを確認するには、[サポートされているマクロ](/manual/appendix/macros/supported_by_location)ページで"アイテムキーパラメーター"を検索してください。 #### Kiosk mode The kiosk mode in supported frontend pages can be activated using URL parameters. For example, in dashboards: - `/zabbix.php?action=dashboard.view&kiosk=1` - activate kiosk mode - `/zabbix.php?action=dashboard.view&kiosk=0` - activate normal mode #### キオスクモード フロントエンドページのキオスクモードは、そのページでサポートされていればURLパラメータを使用してアクティブ化できます。たとえば、ダッシュボードでは次のようになります。 - `/zabbix.php?action=dashboard.view&kiosk=1` - キオスクモードをアクティブに - `/zabbix.php?action=dashboard.view&kiosk=0` - ノーマルモードをアクティブに #### Known issues 1. Zabbix agent does not have the possibility to determine proper node name. It always has dynamic hostname. #### 既知の問題 1. Zabbixエージェントは適切なノード名を判別できません。常に動的なホスト名を持ちます。 #### Known issues See [known issues](/manual/installation/known_issues#graphs) for graphs. #### 既知の問題 グラフについては、[known issues](/manual/installation/known_issues#graphs)を参照してください。 #### Known issues To improve performance, you can convert the field types from *nclob* to *nvarchar2*, see [known issues](/manual/installation/known_issues#slow-configuration-sync-with-oracle). #### 既知の問題点 パフォーマンスを向上させるには、 *nclob* から *nvarchar2* にフィールドタイプを変換してください。詳細は [既知の問題点](/manual/installation/known_issues#slow-configuration-sync-with-oracle) を参照してください。 #### Kubernetes - *Kubernetes nodes by HTTP* - *Kubernetes cluster state by HTTP* - *Kubernetes API server by HTTP* - *Kubernetes Controller manager by HTTP* - *Kubernetes Scheduler by HTTP* - *Kubernetes kubelet by HTTP* To enable Kubernetes monitoring, you need to use the new tool [Zabbix Helm Chart](https://git.zabbix.com/projects/ZT/repos/kubernetes-helm/browse?at=refs%2Fheads%2Frelease%2F6.0), which installs Zabbix proxy and Zabbix agents in the Kubernetes cluster. To learn more about configuring templates, see [HTTP template operation](/manual/config/templates_out_of_the_box/http). #### Kubernetes - *Kubernetes nodes by HTTP* - *Kubernetes cluster state by HTTP* - *Kubernetes API server by HTTP* - *Kubernetes Controller manager by HTTP* - *Kubernetes Scheduler by HTTP* - *Kubernetes kubelet by HTTP* Kubernetesの監視を有効にするには、新しいツール[Zabbix Helm Chart](https://git.zabbix.com/projects/ZT/repos/kubernetes-helm/browse?at=refs%2Fheads%2Frelease%2F6.0)を使用し、KubernetesクラスタにZabbixプロキシとZabbixエージェントをインストールする必要があります。 テンプレートの設定の詳細については、[HTTPテンプレートの操作](/manual/config/templates_out_of_the_box/http)を参照してください。 ##### Large file support Zabbix has large file support for SNMP trapper files. The maximum file size that Zabbix can read is 2\^63 (8 EiB). Note that the filesystem may impose a lower limit on the file size. ##### ラージファイルサポート Zabbixは、SNMPトラッパーのラージファイルをサポートしています。Zabbix が読み取れる最大ファイル サイズは 2\^63 (8 EiB) です。 ファイルシステムによってはファイルサイズに下限があることに注意してください。 ### Latest data link for hosts shows numbers The latest data link for hosts in [*Monitoring* -> *Hosts*](/manual/web_interface/frontend_sections/monitoring/hosts) now shows the number of items with latest data. ### ホストの最新データリンクに数値が表示される [*監視データ* -> *ホスト*](/manual/web_interface/frontend_sections/monitoring/hosts) にあるホストの最新データリンクは、最新データのアイテム数を表示するようになりました。 #### Legend The following parameters are supported for configuring *Legend*. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Show legend*|0|legend|0 - Disabled;<br>1 - *(default)* Enabled.| |*Number of rows*|0|legend_lines|Valid values range from 1-5.<br><br>Default: 1.| #### 凡例 *凡例*の設定には、以下のパラメータがサポートされています。 |パラメータ|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|名前|値| |-----|-|-----|-------------------| |*凡例の表示*|0|legend|0 - 無効;<br>1 - *(デフォルト)* 有効| |*行数*|0|legend_lines|有効な値の範囲は1～5です。<br><br>デフォルト: 1| #### Library in a non-standard location Zabbix allows you to specify a library located in a non-standard location. In the example below, Zabbix will run `curl-config` from the specified non-standard location and use its output to determine the correct libcurl to use. $ ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config This will work if it is the only libcurl installed in the system, but might not if there is another libcurl installed in a standard location (by the package manager, for example). Such is the case when you need a newer version of the library for Zabbix and the older one for other applications. Therefore, specifying a component in a non-standard location will not always work when the same component also exists in a standard location. For example, if you use a newer libcurl installed in `/usr/local` with the libcurl package still installed, Zabbix might pick up the wrong one and compilation will fail: usr/bin/ld: ../../src/libs/zbxhttp/libzbxhttp.a(http.o): in function 'zbx_http_convert_to_utf8': /tmp/zabbix-master/src/libs/zbxhttp/http.c:957: undefined reference to 'curl_easy_header' collect2: error: ld returned 1 exit status Here, the function `curl_easy_header()` is not available in the older `/usr/lib/x86_64-linux-gnu/libcurl.so`, but is available in the newer `/usr/local/lib/libcurl.so`. The problem lies with the order of linker flags, and one solution is to specify the full path to the library in an LDFLAGS variable: $ LDFLAGS="-Wl,--no-as-needed /usr/local/lib/libcurl.so" ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config Note the `-Wl,--no-as-needed` option which might be needed on some systems (see also: default linking options on [Debian-based](https://wiki.debian.org/ToolChain/DSOLinking) systems). #### 非標準の場所にあるライブラリ Zabbixは標準以外の場所にあるライブラリを指定できます。以下の例では、Zabbixは指定された非標準の場所から`curl-config`を実行し、その出力を使用して、使用する正しいlibcurlを決定します。 $ ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config これは、システムにインストールされている唯一のlibcurlである場合に機能しますが、たとえば、パッケージマネージャーによって標準の場所に別のlibcurlがインストールされている場合は機能しません。これは、Zabbixに新しいバージョンのライブラリと他のアプリケーションに古いバージョンが必要な場合で起きます。 したがって、非標準の場所でコンポーネントを指定すると、同じコンポーネントが標準の場所に存在する場合、常に機能するとは限りません。 たとえば、libcurlパッケージがまだインストールされている状態で`/usr/local`に新しくインストールされたlibcurlを使用する場合、zabbixは間違ったものをピックアップしてコンパイルが失敗する可能性があります。 usr/bin/ld: ../../src/libs/zbxhttp/libzbxhttp.a(http.o): in function 'zbx_http_convert_to_utf8': /tmp/zabbix-master/src/libs/zbxhttp/http.c:957: undefined reference to 'curl_easy_header' collect2: error: ld returned 1 exit status ここで、関数`curl_easy_header()`は古い`/usr/lib/x86_64-linux-gnu/libcurl.so`では利用できませんが、新しい`/usr/local/lib/libcurl.so`では利用可能です。 問題はリンカーフラグの順序にあり、1つの解決策は、LDFLAGS変数のライブラリへのフルパスを指定することです。 $ LDFLAGS="-Wl,--no-as-needed /usr/local/lib/libcurl.so" ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config 一部のシステムでは`-Wl,--no-as-needed`オプションが必要かもしれないことに注意してください（参照: [debianベース](https://wiki.debian.org/toolchain/dsolinking)システムのデフォルトリンクオプション)。 ##### Limitations - Only same host (template) dependencies are allowed - An item prototype can depend on another item prototype or regular item from the same host - Maximum count of dependent items for one master item is limited to 29999 (regardless of the number of dependency levels) - Maximum 3 dependency levels allowed - Dependent item on a host with master item from template will not be exported to XML ##### 制限事項 - 同一ホスト（テンプレート）への依存関係のみが許可される。 - アイテムのプロトタイプは、同じホストの別のアイテムのプロトタイプまたは通常のアイテムに依存することができます。 - 1 つのマスターアイテムに対する依存アイテムの最大数は 29999 に制限されます。（依存レベルの数には関係ありません） - 依存レベルは最大3つまで。 - テンプレートにあるマスターアイテムを持つホストの依存アイテムは、XMLにエクスポートされません。 #### Limitations - Private keys are stored in plain text in files readable by Zabbix components during startup - Pre-shared keys are entered in Zabbix frontend and stored in Zabbix database in plain text - Built-in encryption does not protect communications: - Between the web server running Zabbix frontend and user web browser - Between Zabbix frontend and Zabbix server - Currently each encrypted connection opens with a full TLS handshake, no session caching and tickets are implemented - Adding encryption increases the time for item checks and actions, depending on network latency: - For example, if packet delay is 100ms then opening a TCP connection and sending unencrypted request takes around 200ms. With encryption about 1000 ms are added for establishing the TLS connection; - Timeouts may need to be increased, otherwise some items and actions running remote scripts on agents may work with unencrypted connections, but fail with timeout with encrypted. - Encryption is not supported by [network discovery](/manual/discovery/network_discovery). Zabbix agent checks performed by network discovery will be unencrypted and if Zabbix agent is configured to reject unencrypted connections such checks will not succeed. #### 制限事項 - 秘密鍵は起動時に Zabbix コンポーネントが読み込み可能なファイルにプレーンテキストで保存されます。 - 事前共有鍵は Zabbix フロントエンドで入力され、Zabbix データベースにプレーンテキストで保存されます。 - 内蔵の暗号化では、通信は保護されません。 - Zabbix フロントエンドが動作するウェブサーバとユーザのウェブブラウザ間 - Zabbix フロントエンドと Zabbix サーバ間 - 現在、暗号化された接続は完全な TLS ハンドシェイクで開かれ、セッションキャッシュとチケットは実装されていません。 - 暗号化を追加すると、ネットワーク遅延に応じてアイテムのチェックとアクションにかかる時間が増加します。 - 例えば、パケット遅延が100msの場合、TCP 接続を開き、暗号化されていないリクエストを送信するのに約200msかかります。 暗号化では、TLS 接続の確立に約1000msが追加されます。 - タイムアウトを増やす必要があるかもしれません。そうしないと、agent 上でリモートスクリプトを実行するいくつかのアイテムや アクションが、暗号化されていない接続では動作するのに、暗号化されているとタイムアウトで失敗する可能性があります。 - 暗号化は、[network discovery](/manual/discovery/network_discovery)ではサポートされていません。Zabbix agent が 暗号化されていない接続を拒否するように設定されている場合、ネットワークディスカバリーが実行するZabbix agent の チェックは成功しません。 #### Limitations Zabbix agent for Windows does not support non-standard Windows configurations where CPUs are distributed non-uniformly across NUMA nodes. If logical CPUs are distributed non-uniformly, then CPU performance metrics may not be available for some CPUs. For example, if there are 72 logical CPUs with 2 NUMA nodes, both nodes must have 36 CPUs each. #### 制限 Windows用Zabbixエージェントは、CPUがNUMAノード全体に不均一に分散されている非標準のWindows構成をサポートしていません。論理CPUが不均一に分散されている場合、一部のCPUではCPUパフォーマンスメトリックが使用できない場合があります。たとえば、2つのNUMAノードを持つ72個の論理CPUがある場合、両方のノードにそれぞれ36個のCPUが必要です。 #### Limiting access to API Update role with ID "5", deny to call any "create", "update" or "delete" methods. Request: ```json { "jsonrpc": "2.0", "method": "role.update", "params": [ { "roleid": "5", "rules": { "api.access": "1", "api.mode": "0", "api": ["*.create", "*.update", "*.delete"] } } ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### APIへのアクセスを制限する IDが"5"のロールを更新し、"create","update","delete"メソッドの呼び出しを拒否します。 Request: ```json { "jsonrpc": "2.0", "method": "role.update", "params": [ { "roleid": "5", "rules": { "api.access": "1", "api.mode": "0", "api": ["*.create", "*.update", "*.delete"] } } ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` ### Limits for JavaScript objects in preprocessing The following limits for [JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects#additional-javascript-objects) in preprocessing have been introduced: - The total size of all messages that can be logged with the `log()` method has been limited to 8 MB per script execution. - The initialization of multiple `HttpRequest` objects has been limited to 10 per script execution. - The total length of header fields that can be added to a single `HttpRequest` object with the `addHeader()` method has been limited to 128 Kbytes (special characters and header names included). ### 保存前処理におけるJavaScriptオブジェクトの制限 保存前処理では、[JavaScriptオブジェクト](/manual/config/items/preprocessing/javascript/javascript_objects#additional-javascript-objects)に以下の制限があります。 - `log()`メソッドでログ化できるメッセージの総サイズは、スクリプト実行一回あたり8MB までです。 - 複数の`HttpRequest`オブジェクト の初期化は、スクリプト実行一回あたり10個までです。 - `addHeader()`メソッドでひとつの`HttpRequest`オブジェクトに追加できるヘッダーの長さは、128 Kbytes(特殊文字とヘッダー名を含む)までです。 ### Limits for JavaScript objects in preprocessing The following limits for [JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects#additional-javascript-objects) in preprocessing have been introduced: - The total size of all messages that can be logged with the `log()` method has been limited to 8 MB per script execution. - The initialization of multiple `HttpRequest` objects has been limited to 10 per script execution. - The total length of header fields that can be added to a single `HttpRequest` object with the `addHeader()` method has been limited to 128 Kbytes (special characters and header names included). ### 保存前処理におけるJavaScriptオブジェクトの制限 保存前処理では、[JavaScriptオブジェクト](/manual/config/items/preprocessing/javascript/javascript_objects#additional-javascript-objects)に以下の制限があります。 - `log()`メソッドでログ化できるメッセージの総サイズは、スクリプト実行一回あたり8MB までです。 - 複数の`HttpRequest`オブジェクト の初期化は、スクリプト実行一回あたり10個までです。 - `addHeader()`メソッドでひとつの`HttpRequest`オブジェクトに追加できるヘッダーの長さは、128 Kbytes(特殊文字とヘッダー名を含む)までです。 #### Limits of filtering with utf8mb4 collations Filters (e.g., in *Configuration* → [*Maintenance*](/manual/web_interface/frontend_sections/configuration/maintenance#using-filter)) may not function correctly when applied to entities containing certain Unicode characters (e.g., ȼ, ɇ). This issue arises due to how the default utf8mb4\_bin collation for MySQL or MariaDB databases handles sorting and comparison of Unicode characters. To address this limitation, users can change the collation of database columns to alternatives such as utf8mb4\_0900\_bin, utf8mb4\_0900\_ai\_ci, or utf8mb4\_unicode\_520\_ci. Note, however, that changing the collation may cause unexpected behavior in the handling of empty spaces, as well as sorting and filtering for other characters. For more information on changing collations, see [MySQL documentation](https://dev.mysql.com/doc/refman/8.4/en/alter-table.html#alter-table-character-set) or [MariaDB documentation](https://mariadb.com/kb/en/alter-database/). For details on collation differences, see [Unicode Character Sets](https://dev.mysql.com/doc/refman/8.4/en/charset-unicode-sets.html) in MySQL documentation. #### utf8mb4照合順序によるフィルタリングの制限 フィルタ (例: *設定* → [*メンテナンス*](/manual/web_interface/frontend_sections/configuration/maintenance#using-filter)) は、特定のUnicode文字 (例: ȼ、ɇ) を含むエンティティに適用すると正しく機能しない場合があります。この問題は、MySQLまたはMariaDBデータベースのデフォルトのutf8mb4\_bin照合順序がUnicode文字の並べ替えと比較を処理する方法が原因で発生します。 この制限に対処するには、ユーザーはデータベース列の照合順序をutf8mb4\_0900\_bin、utf8mb4\_0900\_ai\_ci、または utf8mb4\_unicode\_520\_ciなどの代替に変更できます。ただし、照合順序を変更すると、空白の処理や他の文字の並べ替えとフィルタリングで予期しない動作が発生する可能性があることに注意してください。 照合順序の変更の詳細については、以下を参照してください。 [MySQLドキュメント](https://dev.mysql.com/doc/refman/8.4/en/alter-table.html#alter-table-character-set)または[MariaDBドキュメント](https://mariadb.com/kb/en/alter-database/)。照合順序の違いの詳細については、MySQLドキュメントの[Unicode文字セット](https://dev.mysql.com/doc/refman/8.4/en/charset-unicode-sets.html)を参照してください。 #### Link a group to templates Add host group "2" to two templates. Request: ```json { "jsonrpc": "2.0", "method": "template.massadd", "params": { "templates": [ { "templateid": "10085" }, { "templateid": "10086" } ], "groups": [ { "groupid": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10085", "10086" ] }, "id": 1 } ``` #### グループをテンプレートにリンクする 2 つのテンプレートにホスト グループ"2"を追加します。 リクエスト: ```json { "jsonrpc": "2.0", "method": "template.massadd", "params": { "templates": [ { "templateid": "10085" }, { "templateid": "10086" } ], "groups": [ { "groupid": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10085", "10086" ] }, "id": 1 } ``` #### Linking elements Once you have put some elements on the map, it is time to start linking them. To link two elements you must first select them. With the elements selected, click on *Add* next to Link. With a link created, the single element form now contains an additional *Links* section. Click on *Edit* to edit link attributes. {width="600"} Link attributes: |Parameter|Description| |--|--------| |*Label*|Label that will be rendered on top of the link.<br>Expression [macros](/manual/appendix/macros/supported_by_location) are supported in this field, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).| |*Connect to*|The element that the link connects to.| |*Type (OK)*|Default link style:<br>**Line** - single line<br>**Bold line** - bold line<br>**Dot** - dots<br>**Dashed line** - dashed line| |*Color (OK)*|Default link color.| |*[Link indicators](links)*|List of triggers linked to the link. In case a trigger has status PROBLEM, its style is applied to the link.| #### 要素のリンク 要素をマップに配置したら、それらをリンクすることもできます。 2 つの要素をリンクするには、最初に２つの要素を選択した状態で、[リンク] の横にある [追加] をクリックします。 リンクが作成されると、単一要素フォームに追加の *リンク* セクションが含まれるようになります。 *編集* をクリックして、リンク属性を編集します。 {width="600"} リンク属性: |パラメータ|説明| |--|--------| |*ラベル*|リンクの上に表示されるラベル。<br>このフィールドでは式 [マクロ](/manual/appendix/macros/supported_by_location)がサポートされていますが、パラメータとして時間を指定した `avg`、`last`、`min`、`max` 関数のみがサポートされています (例: `{?avg(/host/key) ,1h)}`)| |*接続方法*|リンクが接続する要素| |*タイプ (正常OK)*|デフォルトのリンク スタイル:<br>**Line** - シングルライン<br>**Bold line** - 太線<br>**Dot** - ドット<br>**Dashed line** - 破線| |*色 (正常)*|デフォルトのリンク色| |*[障害発生時の条件設定](links)*|リンクにリンクされたトリガーのリスト。 トリガーのステータスが 障害 の場合、そのスタイルがリンクに適用されます。| ##### Linking pre-defined templates to hosts As you may have noticed, Zabbix comes with a set of predefined templates for various OS, devices and applications. To get started with monitoring very quickly, you may link the appropriate one of them to a host, but beware that these templates need to be fine-tuned for your environment. Some checks may not be needed, and polling intervals may be way too frequent. More information about [templates](/manual/config/templates) is available. ##### 事前に定義されたテンプレートをホストにリンク お気づきかもしれませんが、Zabbixには様々なOS、デバイス、アプリケーション用の事前定義されたテンプレートが用意されています。適切なテンプレートをホストにリンクする事ですぐに監視を開始することが出来ますが、これらのテンプレートは環境に合わせて微調整する必要があることに注意してください。一部のチェックは不要かもしれまんせんし、ポーリング間隔が短すぎるかもしれません。 [テンプレート](/manual/config/templates)の詳細については、こちらをご覧ください。 #### Linking template to host With a template ready, it only remains to add it to a host. For that, go to *Configuration → Hosts*, click on 'New host' to open its property form and find the **Templates** field. Start typing *New template* in the *Templates* field. The name of template we have created should appear in the dropdown list. Scroll down to select. See that it appears in the *Templates* field.  Click *Update* in the form to save the changes. The template is now added to the host, with all entities that it holds. As you may have guessed, this way it can be applied to any other host as well. Any changes to the items, triggers and other entities at the template level will propagate to the hosts the template is linked to. #### テンプレートをホストにリンク 準備が出来たテンプレートがあれば、後はホストに追加するだけです。*設定 → ホスト*に移動し、'New host'をクリックしてプロパティフォームを開き、**テンプレート**のフィールドがある事を確認します。 *テンプレート*のフィールドに*New template*を入力します。作成したテンプレートの名前がドロップダウンリストに表示されているはずなので、スクロールして選択します。*テンプレート*フィールドに表示されている事を確認します。  フォーム内にある*更新*をクリックし、変更を保存します。これで全てのエンティティを保有するテンプレートがホストに追加されます。 想像の通り、この手順で他のどのホストにも適用する事が出来ます。アイテムやトリガー等の動作の変更は、テンプレートがリンクされているホストに伝搬されます。 #### Links available For each entry the following links are available: - Hosts - Monitoring - Latest data - Problems - Graphs - Host dashboards - Web scenarios - Configuration - Items - Triggers - Graphs - Discovery rules - Web scenarios ```{=html} <!-- --> ``` - Host groups - Monitoring - Latest data - Problems - Web scenarios - Configuration - Hosts - Templates ```{=html} <!-- --> ``` - Templates - Configuration - Items - Triggers - Graphs - Template dashboards - Discovery rules - Web scenarios #### 利用可能なリンク 各エントリについて、次のリンクを利用できます。 - Hosts - Monitoring - Latest data - Problems - Graphs - Host dashboards - Web scenarios - Configuration - Items - Triggers - Graphs - Discovery rules - Web scenarios ```{=html} <!-- --> ``` - Host groups - Monitoring - Latest data - Problems - Web scenarios - Configuration - Hosts - Templates ```{=html} <!-- --> ``` - Templates - Configuration - Items - Triggers - Graphs - Template dashboards - Discovery rules - Web scenarios ##### Links Clicking on a map element opens a menu with some available links. ##### リンク マップ要素をクリックすると、いくつかの利用可能なリンクが表示されたメニューが開きます。 #### Link two templates to a template Link templates "10106" and "10104" to template. Request: ```json { "jsonrpc": "2.0", "method": "template.massadd", "params": { "templates": [ { "templateid": "10073" } ], "templates_link": [ { "templateid": "10106" }, { "templateid": "10104" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10073" ] }, "id": 1 } ``` #### 2 つのテンプレートを 1 つのテンプレートにリンクする テンプレート"10106"と"10104"をテンプレートにリンクします。 リクエスト: ```json { "jsonrpc": "2.0", "method": "template.massadd", "params": { "templates": [ { "templateid": "10073" } ], "templates_link": [ { "templateid": "10106" }, { "templateid": "10104" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10073" ] }, "id": 1 } ``` #### Linux kernel threads #### Linuxカーネルスレッド ##### Linux On Linux systems `ps` command can be used together with `watch` command for observing how Zabbix is doing. For example, to run `ps` command 5 times per second to see process activities: watch -n 0.2 ps -fu zabbix To show only Zabbix proxy and agent processes: watch -tn 0.2 'ps -f -C zabbix_proxy -C zabbix_agentd' To show only history syncer processes: watch -tn 0.2 'ps -fC zabbix_server | grep history' The `ps` command produces a wide output (approximately 190 columns) as some activity messages are long. If your terminal has less than 190 columns of text you can try watch -tn 0.2 'ps -o cmd -C zabbix_server -C zabbix_proxy -C zabbix_agentd' to display only commandlines without UID, PID, start time etc. `top` command also can be used for observing Zabbix performance. Pressing 'c' key in `top` shows processes with their commandlines. In our tests on Linux `top` and `atop` correctly displayed changing activities of Zabbix processes, but `htop` was not displaying changing activities. ##### Linux Linux システムでは`ps`コマンドを`watch`コマンドと一緒に使用して、Zabbix の動作を監視できます。 たとえば`ps`コマンドを 1 秒あたり 5 回実行してプロセス アクティビティを表示するには、次のようにします。 watch -n 0.2 ps -fu zabbix Zabbix プロキシおよびエージェント プロセスのみを表示するには: watch -tn 0.2 'ps -f -C zabbix_proxy -C zabbix_agentd' 履歴同期プロセスのみを表示するには: watch -tn 0.2 'ps -fC zabbix_server | grep history' 一部のアクティビティ メッセージは長いため、`ps`コマンドは幅の広い出力 (約 190 列) を生成します。 端末のテキストが 190 列未満の場合は、次を試すことができます watch -tn 0.2 'ps -o cmd -C zabbix_server -C zabbix_proxy -C zabbix_agentd' UID、PID、開始時刻などを含まないコマンドラインのみを表示します。 `top`コマンドは、Zabbix のパフォーマンスを観察するためにも使用できます。 `top`で'c'キーを押すと、プロセスとそのコマンドラインが表示されます。 Linux でテストしたところ、`top`と`atop`は Zabbix プロセスの変化するアクティビティを正しく表示しましたが、`htop`は変化するアクティビティを表示しませんでした。 #### Linux See values supported for 'memtype' parameter on Linux in the table. |Supported value|Description|Source in /proc/<pid>/status file| |--|------|--| |vsize ^[1](proc_mem_notes#footnotes)^|Virtual memory size|VmSize| |pmem|Percentage of real memory|(VmRSS/total\_memory) \* 100| |rss|Resident set size|VmRSS| |data|Size of data segment|VmData| |exe|Size of code segment|VmExe| |hwm|Peak resident set size|VmHWM| |lck|Size of locked memory|VmLck| |lib|Size of shared libraries|VmLib| |peak|Peak virtual memory size|VmPeak| |pin|Size of pinned pages|VmPin| |pte|Size of page table entries|VmPTE| |size|Size of process code + data + stack segments|VmExe + VmData + VmStk| |stk|Size of stack segment|VmStk| |swap|Size of swap space used|VmSwap| Notes for Linux: 1. Not all 'memtype' values are supported by older Linux kernels. For example, Linux 2.4 kernels do not support `hwm`, `pin`, `peak`, `pte` and `swap` values. 2. We have noticed that self-monitoring of the Zabbix agent active check process with `proc.mem[...,...,...,...,data]` shows a value that is 4 kB larger than reported by `VmData` line in the agent's /proc/<pid>/status file. At the time of self-measurement the agent's data segment increases by 4 kB and then returns to the previous size. #### Linux 以下の表がLinuxの'memtype'パラメーターでサポートされている値です。 |サポート値|説明|/proc/<pid>/statusファイルのソース| |--|------|--| |vsize ^[1](proc_mem_notes#footnotes)^|仮想メモリサイズ|VmSize| |pmem|実メモリのパーセンテージ|(VmRSS/total\_memory) \* 100| |rss|物理メモリ消費量|VmRSS| |data|データセグメントサイズ|VmData| |exe|コードセグメントサイズ|VmExe| |hwm|物理メモリ消費のピーク|VmHWM| |lck|ロックメモリのサイズ|VmLck| |lib|シェアードライブラリのサイズ|VmLib| |peak|仮想メモリサイズのピーク|VmPeak| |pin|固定されたページのサイズ|VmPin| |pte|ページテーブルエントリのサイズ|VmPTE| |size|プロセスコードとデータとスタックセグメントの合計値|VmExe + VmData + VmStk| |stk|スタックセグメントのサイズ|VmStk| |swap|スワップスペース使用量|VmSwap| Linuxに関する注意： 1. 古いLinuxカーネルではサポートされていない`memtype`値があります。たとえばLinux 2.4カーネルは、 `hwm`、` pin`、 `peak`、` pte`、および`swap`の値をサポートしていません。 2. `proc.mem[...,...,...,...,data]`を使用したZabbixエージェントのアクティブチェックプロセス自己監視は、エージェントの/proc/<pid>/statusファイルの`VmData`行で報告される値よりも4kB大きい値が示されていることがわかりました。自己測定時にエージェントのデータセグメントは4 kB増加し、その後前のサイズに戻ります。 ##### List of sorting fields available for each type of diagnostic information request Following statistic fields can be used to sort and limit requested information. |Diagnostic type|Available fields|[Type](/manual/api/reference_commentary#data_types)| |---------------|----------------|---------------------------------------------------| |historycache|values|integer| |valuecache|values|integer| |^|request.values|integer| |preprocessing|values|integer| |alerting|media.alerts|integer| |^|source.alerts|integer| |lld|values|integer| ##### 診断情報要求の各タイプで使用できる並べ替えフィールドのリスト 次の統計フィールドを使用して、要求された情報をソートおよび制限できます。 |診断タイプ|使用可能なフィールド|[タイプ](/manual/api/reference_commentary#data_types)| |---------------|----------------|---------------------------------------------------| |historycache|values|integer| |valuecache|values|integer| |^|request.values|integer| |preprocessing|values|integer| |alerting|media.alerts|integer| |^|source.alerts|integer| |lld|values|integer| ##### List of statistic fields available for each type of diagnostic information request Following statistic fields can be requested for each type of diagnostic information request property. |Diagnostic type|Available fields|Description| |---------------|----------------|-----------| |historycache|items|Number of cached items.| |^|values|Number of cached values.| |^|memory|Shared memory statistics (free space, number of used chunks, number of free chunks, max size of free chunk).| |^|memory.data|History data cache shared memory statistics.| |^|memory.index|History index cache shared memory statistics.| |valuecache|items|Number of cached items.| |^|values|Number of cached values.| |^|memory|Shared memory statistics (free space, number of used chunks, number of free chunks, max size of free chunk).| |^|mode|Value cache mode.| |preprocessing|values|Number of queued values.| |^|preproc.values|Number of queued values with preprocessing steps.| |alerting|alerts|Number of queued alerts.| |lld|rules|Number of queued rules.| |^|values|Number of queued values.| ##### 診断情報要求の各タイプで使用可能な統計フィールドのリスト 次の統計フィールドは、診断情報リクエスト プロパティのタイプごとにリクエストできます。 |診断タイプ|使用可能なフィールド|説明| |---------------|----------------|-----------| |historycache|items|キャッシュされたアイテムの数| |^|values|キャッシュされた値の数| |^|memory|共有メモリ統計 (空き容量、使用済みチャンク数、空きチャンク数、空きチャンクの最大サイズ)| |^|memory.data|ヒストリー・データ・キャッシュの共有メモリー統計| |^|memory.index|ヒストリー索引キャッシュ共有メモリー統計| |valuecache|items|キャッシュされたアイテムの数| |^|values|キャッシュされた値の数| |^|memory|共有メモリ統計 (空き容量、使用済みチャンク数、空きチャンク数、空きチャンクの最大サイズ)| |^|mode|値キャッシュ モード| |preprocessing|values|キューに入れられた値の数| |^|preproc.values|事前処理ステップでキューに入れられた値の数| |alerting|alerts|キューに入れられたアラート数| |lld|rules|キューに入れられたルールの数| |^|values|キューに入れられた値の数| ##### List of waiting items In this screen, each waiting item is listed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Scheduled check*|The time when the check was due is displayed.| |*Delayed by*|The length of the delay is displayed.| |*Host*|Host of the item is displayed.| |*Name*|Name of the waiting item is displayed.| |*Proxy*|The proxy name is displayed, if the host is monitored by proxy.| ##### キュー詳細 この画面では、待機中の各アイテムが一覧表示されます。 {width="600"} 表示データ |列|説明| |------|-----------| |*Scheduled check*|チェック日が表示されます| |*Delayed by*|遅延期間が表示されます| |*Host*|アイテムのホストが表示されます| |*Name*|待機中のアイテム名が表示されます| |*Proxy*|ホストがプロキシによって監視されている場合は、プロキシ名が表示されます。| ### LLD macro path The LLD macro path has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**lld\_macro**<br>(required)|string|LLD macro.| |**path**<br>(required)|string|Selector for value which will be assigned to corresponding macro.| ### LLDマクロパス LLDマクロパスには、次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**lld\_macro**<br>(必須)|string|LLDマクロ| |**path**<br>(必須)|string|対応するマクロに割り当てられる値のセレクター| #### LLD rule filter condition The LLD rule filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |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>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.| ::: notetip To better understand how to use filters with various types of expressions, see examples on the [discoveryrule.get](get#retrieving_filter_conditions) and [discoveryrule.create](create#using_a_custom_expression_filter) method pages. ::: #### LLDルールフィルター条件 LLDルールフィルター条件オブジェクトは、LLDマクロの値に対して実行する個別のチェックを定義します。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**macro**<br>(必須)|string|チェックを実行するLLDマクロ| |**value**<br>(必須)|string|比較する値| |formulaid|string|カスタム式から条件を参照するために使用される任意のID。 大文字のみを含めることができます。 IDは、フィルター条件を変更するときにユーザーが定義する必要がありますが、後で要求すると新たに生成されます。| |operator|integer|条件演算子。<br><br>可能な値:<br>8 - *(デフォルト)*正規表現に一致<br>9 - 正規表現に不一致<br>12 - 存在する<br>13 - 存在しない| ::: notetip さまざまなタイプの式でフィルターを使用する方法をよりよく理解するには[discoveryrule.get](get#retrieving_filter_conditions) と [discoveryrule.create](create#using_a_custom_expression_filter)メソッドページの例を参照してください。 ::: ### LLD rule filter The LLD rule filter object defines a set of conditions that can be used to filter discovered objects. 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.| ### LLDルールフィルター LLDルールフィルターオブジェクトは、検出されたオブジェクトをフィルター処理するために使用できる一連の条件を定義します。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**conditions**<br>(必須)|array|結果のフィルタリングに使用する一連のフィルター条件| |**evaltype**<br>(必須)|integer|フィルタ条件の評価方法<br><br>可能な値:<br>0 - and/or<br>1 - and<br>2 - or<br>3 - カスタム式| |eval\_formula|string|*(読取専用)* フィルタ条件の評価に使用される生成された式。 式には`formulaid`によって特定のフィルター条件を参照するIDが含まれています。`eval_formula`の値は、カスタム式を持つフィルターの`formula`の値と同じです。| |formula|string|カスタム式を使用してフィルターの条件を評価するために使用されるユーザー定義の式。 式には、その`formulaid`によって特定のフィルター条件を参照するIDが含まれている必要があります。 式で使用されるIDは、フィルター条件で定義されたIDと完全に一致する必要があります。条件を未使用のままにしたり省略したりすることはできません。<br><br>カスタム式フィルターで使用します。| #### LLD rule override filter condition The LLD rule override filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |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>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.| #### LLDルールオーバーライドフィルター条件 LLDルールオーバーライドフィルター条件オブジェクトは、LLDマクロの値に対して実行する個別のチェックを定義します。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**macro**<br>(必須)|string|チェックを実行するLLDマクロ| |**value**<br>(必須)|string|比較する値| |formulaid|string|カスタム式から条件を参照するために使用される任意の一意のID。 大文字のみを含めることができます。 IDは、フィルター条件を変更するときにユーザーが定義する必要がありますが、後で要求すると新たに生成されます。| |operator|integer|条件演算子<br><br>可能な値:<br>8 - *(デフォルト)*正規表現に一致<br>9 - 正規表現と不一致<br>12 - 存在する<br>13 -存在しない| #### LLD rule override filter The LLD rule override filter object defines a set of conditions that if they match the discovered object the override is applied. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**evaltype**<br>(required)|integer|Override filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |**conditions**<br>(required)|array|Set of override filter conditions to use for matching the discovered objects.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating override filter conditions. The expression contains IDs that reference specific override 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 override filters with a custom expression. The expression must contain IDs that reference specific override filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the override filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression override filters.| #### LLD ルールオーバーライドフィルター LLDルールオーバーライドフィルターオブジェクトは、検出されたオブジェクトと一致する場合にオーバーライドが適用される一連の条件を定義します。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**evaltype**<br>(必須)|integer|フィルタ条件の評価方法を上書きします。<br><br>利用可能な値:<br>0 - and/or<br>1 - and<br>2 - or<br>3 - カスタム式| |**conditions**<br>(必須)|array|検出されたオブジェクトの照合に使用するオーバーライドフィルター条件のセット。| |eval\_formula|string|*(読取専用)* オーバーライドフィルター条件の評価に使用される生成された式。 式には、その`formulaid`によって特定のオーバーライドフィルター条件を参照するIDが含まれています。 `eval_formula`の値は、カスタム式を持つフィルターの`formula`の値と同じです。| |formula|string|カスタム式を使用してオーバーライドフィルターの条件を評価するために使用されるユーザー定義式。 式には、その`formulaid`によって特定のオーバーライドフィルター条件を参照するIDが含まれている必要があります。 式で使用されるIDは、オーバーライドフィルター条件で定義されたIDと完全に一致する必要があります。条件を未使用のままにしたり省略したりすることはできません。<br><br>カスタム式オーバーライドフィルターに必要です。| ##### LLD rule override operation discover LLD rule override operation discover status that is set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**discover**<br>(required)|integer|Override the discover status for selected object.<br><br>Possible values:<br>0 - Yes, continue discovering the objects;<br>1 - No, new objects will not be discovered and existing ones will be marked as lost.| ##### LLDルールオーバーライド操作ディスカバリ LLDルールは、検出されたオブジェクトに設定されている操作のディスカバリステータスを上書きします。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**discover**<br>(必須)|integer|選択したオブジェクトのディスカバリステータスを上書きします。<br><br>利用可能な値:<br>0 - オブジェクトの検出を続行します<br>1 - 新しいオブジェクトは検出されず、既存のオブジェクトは失われたものとしてマークされます 。| ##### LLD rule override operation history LLD rule override operation history value that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**history**<br>(required)|string|Override the history of item prototype which is a time unit of how long the history data should be stored. Also accepts user macro and LLD macro.| ##### LLDルール操作履歴上書き LLDルールは、検出されたアイテムに設定されている操作履歴値を上書きします。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**history**<br>(必須)|string|履歴データを保存する期間の時間単位であるアイテムプロトタイプの履歴を上書きします。 ユーザーマクロとLLDマクロも受け入れます。| ##### LLD rule override operation inventory LLD rule override operation inventory mode value that is set to discovered host. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**inventory\_mode**<br>(required)|integer|Override the host prototype inventory mode.<br><br>Possible values are:<br>-1 - disabled;<br>0 - *(default)* manual;<br>1 - automatic.| ##### LLDルールによるオペレーションインベントリ上書き LLDルールは検出されたホストに設定されている操作インベントリモード値を上書きします。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**inventory\_mode**<br>(必須)|integer|ホストプロトタイプインベントリモードをオーバーライドします。<br><br>利用可能な値:<br>-1 - 無効<br>0 - *(デフォルト)* 手動<br>1 - 自動| ##### LLD rule override operation period LLD rule override operation period is an update interval value (supports custom intervals) that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**delay**<br>(required)|string|Override the update interval of the item prototype. Accepts seconds or a time unit with suffix (30s,1m,2h,1d) as well as flexible and scheduling intervals and user macros or LLD macros. Multiple intervals are separated by a semicolon.| ##### LLDルールオーバーライド動作期間 LLDルールオーバーライド操作期間は、検出されたアイテムに設定される更新間隔値（カスタム間隔をサポート）です。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**delay**<br>(必須)|string|アイテムのプロトタイプの更新間隔を上書きします。 接尾辞（30s,1m,2h,1d）が付いた秒または時間単位およびフレキシブルなスケジューリング間隔とユーザーマクロまたはLLDマクロを受け入れます。 複数の間隔はセミコロンで区切られます。| ##### LLD rule override operation severity LLD rule override operation severity value that is set to discovered trigger. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**severity**<br>(required)|integer|Override the severity of trigger prototype.<br><br>Possible values are: 0 - *(default)* not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.| ##### LLDルールはオペレーションの深刻度をオーバーライドします LLDルールは、検出されたトリガーに設定されているオペレーションの深刻度の値をオーバーライドします。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**severity**<br>(必須)|integer|トリガープロトタイプの重大度を上書きします。<br><br>可能な値は次のとおりです:0 - *(デフォルト)*未分類<br>1 - 情報<br>2 - 警告<br>3 - 軽度の障害<br >4 - 重度の障害<br>5 - 致命的な障害| ##### LLD rule override operation status LLD rule override operation status that is set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**status**<br>(required)|integer|Override the status for selected object.<br><br>Possible values:<br>0 - Create enabled;<br>1 - Create disabled.| ##### LLD ルールオーバーライド操作ステータス LLDルールは、検出されたオブジェクトに設定されている操作ステータスを上書きします。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**status**<br>(必須)|integer|選択したオブジェクトのステータスを上書きします。<br><br>利用可能な値:<br>0 - 作成を有効に<br>1 - 作成を無効に| ##### LLD rule override operation template LLD rule override operation template object that is linked to discovered host. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templateid**<br>(required)|string|Override the template of host prototype linked templates.| ##### LLDルールオーバーライドオペレーションテンプレート LLDルールは、検出されたホストにリンクされている操作テンプレートオブジェクトをオーバーライドします。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**templateid**<br>(必須)|string|ホストプロトタイプのリンクされたテンプレートのテンプレートをオーバーライドします。| #### LLD rule override operation The LLD rule override operation is combination of conditions and actions to perform on the prototype object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**operationobject**<br>(required)|integer|Type of discovered object to perform the action.<br><br>Possible values:<br>0 - Item prototype;<br>1 - Trigger prototype;<br>2 - Graph prototype;<br>3 - Host prototype.| |operator|integer|Override condition operator.<br><br>Possible values:<br>0 - *(default)* equals;<br>1 - does not equal;<br>2 - contains;<br>3 - does not contain;<br>8 - matches;<br>9 - does not match.| |value|string|Pattern to match item, trigger, graph or host prototype name depending on selected object.| |opstatus|object|Override operation status object for item, trigger and host prototype objects.| |opdiscover|object|Override operation discover status object (all object types).| |opperiod|object|Override operation period (update interval) object for item prototype object.| |ophistory|object|Override operation history object for item prototype object.| |optrends|object|Override operation trends object for item prototype object.| |opseverity|object|Override operation severity object for trigger prototype object.| |optag|array|Override operation tag object for trigger and host prototype objects.| |optemplate|array|Override operation template object for host prototype object.| |opinventory|object|Override operation inventory object for host prototype object.| #### LLDルールオーバーライド操作 LLDルールのオーバーライド操作は、プロトタイプオブジェクトに対して実行する条件とアクションの組み合わせです。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**operationobject**<br>(必須)|integer|アクションを実行するために検出されたオブジェクトのタイプ。<br><br>可能な値:<br>0 - アイテムのプロトタイプ<br>1 - トリガーのプロトタイプ<br>2 - グラフのプロトタイプ<br>3 - ホストのプロトタイプ| |operator|integer|条件演算子をオーバーライドします。<br><br>可能な値:<br>0 - *(デフォルト)*等しい<br>1 - 等しくない<br>2 - 含む<br>3 - 含まない <br>8 - 一致する<br>9 - 一致しない| |value|string|選択したオブジェクトに応じて、アイテム、トリガー、グラフ、またはホストのプロトタイプ名に一致するパターン。| |opstatus|object|アイテム、トリガー、およびホストのプロトタイプオブジェクトの操作ステータスオブジェクトをオーバーライドします。| |opdiscover|object|オーバーライド操作の検出ステータスオブジェクト（すべてのオブジェクトタイプ）| |opperiod|object|アイテムプロトタイプオブジェクトの操作期間（更新間隔）オブジェクトを上書きします。| |ophistory|object|アイテムプロトタイプオブジェクトの操作履歴オブジェクトを上書きします。| |optrends|object|アイテムプロトタイプオブジェクトの操作トレンドオブジェクトをオーバーライドします。| |opseverity|object|トリガープロトタイプオブジェクトの操作深刻度オブジェクトをオーバーライドします。| |optag|array|トリガーおよびホストのプロトタイプオブジェクトの操作タグオブジェクトをオーバーライドします。| |optemplate|array|ホストプロトタイプオブジェクトの操作テンプレートオブジェクトをオーバーライドします。| |opinventory|object|ホストプロトタイプオブジェクトの操作インベントリオブジェクトを上書きします。| ##### LLD rule override operation trends LLD rule override operation trends value that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**trends**<br>(required)|string|Override the trends of item prototype which is a time unit of how long the trends data should be stored. Also accepts user macro and LLD macro.| ##### LLDルールによるオペレーショントレンドの上書き LLDルールは、検出されたアイテムに設定されているオペレーショントレンド値をオーバーライドします。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**trends**<br>(必須)|string|トレンドデータを保存する期間の時間単位であるアイテムプロトタイプのトレンドをオーバーライドします。 ユーザーマクロとLLDマクロも受け入れます。| ### LLD rule overrides The LLD rule overrides object defines a set of rules (filters, conditions and operations) that are used to override properties of different prototype objects. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Unique override name.| |**step**<br>(required)|integer|Unique order number of the override.| |stop|integer|Stop processing next overrides if matches.<br><br>Possible values:<br>0 - *(default)* don't stop processing overrides;<br>1 - stop processing overrides if filter matches.| |filter|object|Override filter.| |operations|array|Override operations.| ### LLDルールのオーバーライド LLDルールオーバーライドオブジェクトは、さまざまなプロトタイプオブジェクトのプロパティをオーバーライドするために使用される一連のルール（フィルター、条件、および操作）を定義します。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**name**<br>(必須)|string|一意なオーバーライド名| |**step**<br>(必須)|integer|オーバーライドの一意なオーダーナンバー| |stop|integer|一致する場合は次のオーバーライドの処理を停止します。<br><br>可能な値:<br>0 - *(デフォルト)*オーバーライドの処理を停止しません<br>1 - フィルターが一致する場合はオーバーライドの処理を停止します| |filter|object|オーバーライドフィルター| |operations|array|オーバーライドの操作| ### LLD rule The low-level discovery rule object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|string|*(readonly)* ID of the LLD rule.| |**delay**<br>(required)|string|Update interval of the LLD rule. Accepts seconds or time unit with suffix and with or without one or more [custom intervals](/manual/config/items/item/custom_intervals) that consist of either flexible intervals and scheduling intervals as serialized strings. Also accepts user macros. Flexible intervals could be written as two macros separated by a forward slash. Intervals are separated by a semicolon.<br><br>Optional for Zabbix trapper, dependent items and for Zabbix agent (active) with `mqtt.get` key.| |**hostid**<br>(required)|string|ID of the host that the LLD rule belongs to.| |**interfaceid**<br>(required)|string|ID of the LLD rule's host interface. Used only for host LLD rules.<br><br>Not required for Zabbix agent (active), Zabbix internal, Zabbix trapper, dependent, database monitor and script LLD rules. Optional for HTTP agent LLD rules.| |**key\_**<br>(required)|string|LLD rule key.| |**name**<br>(required)|string|Name of the LLD rule.| |**type**<br>(required)|integer|Type of the LLD rule.<br><br>Possible values:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>10 - external check;<br>11 - database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>16 - JMX agent;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script.| |**url**<br>(required)|string|URL string, required for HTTP agent LLD rule. Supports user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |allow\_traps|integer|HTTP agent LLD rule field. Allow to populate value as in trapper item type also.<br><br>0 - *(default)* Do not allow to accept incoming data.<br>1 - Allow to accept incoming data.| |authtype|integer|Used only by SSH agent or HTTP agent LLD rules.<br><br>SSH agent authentication method possible values:<br>0 - *(default)* password;<br>1 - public key.<br><br>HTTP agent authentication method possible values:<br>0 - *(default)* none<br>1 - basic<br>2 - NTLM| |description|string|Description of the LLD rule.| |error|string|*(readonly)* Error text if there are problems updating the LLD rule.| |follow\_redirects|integer|HTTP agent LLD rule field. Follow response redirects while pooling data.<br><br>0 - Do not follow redirects.<br>1 - *(default)* Follow redirects.| |headers|object|HTTP agent LLD rule field. Object with HTTP(S) request headers, where header name is used as key and header value as value.<br><br>Example:<br>{ "User-Agent": "Zabbix" }| |http\_proxy|string|HTTP agent LLD rule field. HTTP(S) proxy connection string.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI LLD rules.| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default value:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |lifetime|string|Time period after which items that are no longer discovered will be deleted. Accepts seconds, time unit with suffix and user macro.<br><br>Default: `30d`.| |master\_itemid|integer|Master item ID.<br>Recursion up to 3 dependent items and maximum count of dependent items equal to 999 are allowed.<br>Discovery rule cannot be master item for another discovery rule.<br><br>Required for Dependent item.| |output\_format|integer|HTTP agent LLD rule field. Should response be converted to JSON.<br><br>0 - *(default)* Store raw.<br>1 - Convert to JSON.| |params|string|Additional parameters depending on the type of the LLD rule:<br>- executed script for SSH and Telnet LLD rules;<br>- SQL query for database monitor LLD rules;<br>- formula for calculated LLD rules.| |parameters|array|Additional parameters for script type LLD rule. Array of objects with 'name' and 'value' properties, where name must be unique.| |password|string|Password for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent LLD rules.| |post\_type|integer|HTTP agent LLD rule field. Type of post data body stored in posts property.<br><br>0 - *(default)* Raw data.<br>2 - JSON data.<br>3 - XML data.| |posts|string|HTTP agent LLD rule field. HTTP(S) request body data. Used with post\_type.| |privatekey|string|Name of the private key file.| |publickey|string|Name of the public key file.| |query\_fields|array|HTTP agent LLD rule field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string.| |request\_method|integer|HTTP agent LLD rule field. Type of request method.<br><br>0 - *(default)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP agent LLD rule field. What part of response should be stored.<br><br>0 - *(default)* Body.<br>1 - Headers.<br>2 - Both body and headers will be stored.<br><br>For request\_method HEAD only 1 is allowed value.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTP agent LLD rule field. Public SSL Key file path.| |ssl\_key\_file|string|HTTP agent LLD rule field. Private SSL Key file path.| |ssl\_key\_password|string|HTTP agent LLD rule field. Password for SSL Key file.| |state|integer|*(readonly)* State of the LLD rule.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - not supported.| |status|integer|Status of the LLD rule.<br><br>Possible values:<br>0 - *(default)* enabled LLD rule;<br>1 - disabled LLD rule.| |status\_codes|string|HTTP agent LLD rule field. Ranges of required HTTP status codes separated by commas. Also supports user macros as part of comma separated list.<br><br>Example: 200,200-{$M},{$M},200-400| |templateid|string|(readonly) ID of the parent template LLD rule.| |timeout|string|Item data polling request timeout. Used for HTTP agent and script LLD rules. Supports user macros.<br><br>default: 3s<br>maximum value: 60s| |trapper\_hosts|string|Allowed hosts. Used by trapper LLD rules or HTTP agent LLD rules.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent LLD rules.<br><br>Required by SSH and Telnet LLD rules.| |uuid|string|Universal unique identifier, used for linking imported LLD rules to already existing ones. Used only for LLD rules on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| |verify\_host|integer|HTTP agent LLD rule field. Validate host name in URL is in Common Name field or a Subject Alternate Name field of host certificate.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| |verify\_peer|integer|HTTP agent LLD rule field. Validate is host certificate authentic.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| ### LLD rule LLDルールオブジェクトには、次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |itemid|string|*(読取専用)* LLDルールのID| |**delay**<br>(必須)|string|LLDルールの更新間隔。 接尾辞があり、フレキシブルインターバルかスケジューリング間隔のいずれかで構成される1つ以上のカスタム間隔がある場合とない場合の秒または時間単位をシリアル化された文字列として受け入れます。ユーザーマクロも受け入れます。 フレキシブルインターバルはスラッシュで区切られた2つのマクロとして記述できます。間隔はセミコロンで区切られます。<br><br>Zabbixトラッパー、依存アイテム、および `mqtt.get`キーを使用するZabbixエージェント（アクティブ）の場合は必須ではありません| |**hostid**<br>(必須)|string|LLDルールが属するホストのID| |**interfaceid**<br>(必須)|string|LLDルールのホストインターフェースID。 ホストLLDルールにのみ使用されます。<br><br>Zabbixエージェント（アクティブ）、Zabbix内部、Zabbixトラッパー、依存、データベースモニター、およびスクリプトLLDルールには不要です。 HTTPエージェントLLDルールの場合はオプションになります。| |**key\_**<br>(必須)|string|LLDルールキー| |**name**<br>(必須)|string|LLDルール名| |**type**<br>(必須)|integer|LLDルールのタイプ。<br><br>利用可能な値:<br>0 - Zabbixエージェント<br>2 - Zabbixトラッパー<br>3 - シンプルチェック<br>5 - Zabbixインターナル<br>7 - Zabbixエージェント(アクティブ)<br>10 - 外部チェック<br>11 - データベースモニター<br>12 - IPMIエージェント<br>13 - SSHエージェント<br>14 - TELNETエージェント<br>16 - JMXエージェント<br>18 - 依存アイテム<br>19 - HTTPエージェント<br>20 - SNMPエージェント<br>21 - スクリプト| |**url**<br>(必須)|string|HTTPエージェントLLDルールに必要なURL文字列。 ユーザーマクロ{HOST.IP}、{HOST.CONN}、{HOST.DNS}、{HOST.HOST}、{HOST.NAME}、{ITEM.ID}、{ITEM.KEY}をサポートします。| |allow\_traps|integer|HTTPエージェントLLDルールフィールド。 トラッパーアイテムタイプと同様に値の入力を許可します。<br><br>0 - *(デフォルト)*受信データの受け入れを許可しません。<br>1 - 受信データの受け入れを許可します。| |authtype|integer|SSHエージェントまたはHTTPエージェントのLLDルールで使用されます。<br><br>SSHエージェント認証方法の可能な値:<br>0 - *(デフォルト)*パスワード<br>1 - 公開鍵<br><br>HTTPエージェント認証方式の可能な値:<br>0 - *(デフォルト)*なし<br>1 - basic<br>2 - NTLM| |error|string|*(読取専用)*LLDルールの更新に問題がある場合のエラーテキスト| |follow\_redirects|integer|HTTPエージェントLLDルールフィールド。 データのプール中に応答リダイレクトを追跡します。<br><br>0 - リダイレクトを追跡しません<br>1 - *(デフォルト)*リダイレクトを追跡します。| |headers|object|HTTPエージェントLLDルールフィールド。 HTTP(S)リクエストヘッダーを持つオブジェクト。ヘッダー名はキーとして使用され、ヘッダー値は値として使用されます。<br> <br>例:<br>{"User-Agent": "Zabbix"}| |http\_proxy|string|HTTPエージェントLLDルールフィールド。 HTTP(s)プロキシ接続文字列。| |ipmi\_sensor|string|IPMIセンサー。 IPMILLDルールでのみ使用されます。| |jmx\_endpoint|string|JMXエージェントのカスタム接続文字列<br><br>デフォルト値:<br> service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |lifetime|string|検出されなくなったアイテムが削除されるまでの期間。 秒、接尾辞付きの時間単位、およびユーザーマクロを受け入れます。<br> <br>デフォルト:`30d`| |master\_itemid|integer|マスターアイテムID<br>最大3つの従属アイテムの再帰と999の従属アイテム最大数が許可されます。<br>ディスカバリルールを別のディスカバリルールのマスターアイテムにすることはできません。<br><br>従属アイテムに必須です。| |output\_format|integer|HTTPエージェントLLDルールフィールド。 応答をJSONに変換する必要があります。<br><br>0 - *(デフォルト)*そのまま保存します。<br>1 - JSONに変換します。| |params|string|LLDルールのタイプに応じた追加パラメーター:<br>- SSHおよびTelnetLLDルール用に実行されたスクリプト<br>- データベースモニターLLDルール用のSQLクエリ<br>- 計算されたLLDルール用の式| |parameters|array|スクリプトタイプLLDルールの追加パラメーター。 'name'および'value'プロパティを持つオブジェクトの配列。nameは一意である必要があります。| |password|string|認証用のパスワード。シンプルチェック、SSH、Telnet、データベースモニター、JMXおよびHTTPエージェントLLDルールで使用されます。| |post\_type|integer|HTTPエージェントLLDルールフィールド。 postsプロパティに保存されている投稿データ本文のタイプ。<br><br>0 - *(デフォルト)*そのままのデータ<br>2 - JSONデータ<br>3 - XMLデータ| |posts|string|HTTPエージェントLLDルールフィールド。 HTTP(s)リクエストの本文データ。post\_typeとともに使用されます。| |privatekey|string|秘密鍵ファイルの名前| |publickey|string|公開鍵ファイルの名前。| |query\_fields|array|HTTPエージェントLLDルールフィールド。 クエリパラメータ。 'key'：'value'のペアを持つオブジェクトの配列。valueは空の文字列にすることができます。| |request\_method|integer|HTTPエージェントLLDルールフィールド。 リクエストメソッドのタイプ。<br><br>0 - *(デフォルト)*GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTPエージェントLLDルールフィールド。応答のどの部分を保存するか。<br><br>0 - *(デフォルト)*本文<br>1 - ヘッダー<br>2 - 本文とヘッダーの両方が保存されます<br><br>request\_method HEADの場合、許可される値は1つだけです。| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTPエージェントLLDルールフィールド。 SSL公開鍵ファイルパス| |ssl\_key\_file|string|HTTPエージェントLLDルールフィールド。 SSL秘密鍵ファイルパス| |ssl\_key\_password|string|HTTPエージェントLLDルールフィールド。 SSLキーファイルのパスワード。| |state|integer|*(読取専用)*LLDルールの状態<br><br>利用可能な値:<br>0 - *(デフォルト)*通常<br>1 - サポートされていません| |status|integer|LLDルールのステータス<br><br>可能な値:<br>0 - *(デフォルト)*有効なLLDルール<br>1 - 無効なLLDルール| |status\_codes|string|HTTPエージェントLLDルールフィールド。 必要なHTTPステータスコードの範囲をコンマで区切ります。 カンマ区切りリストの一部としてユーザーマクロもサポートします。<br><br>例:200,200-{$M},{$M},200-400| |templateid|string|（読取専用）親テンプレートLLDルールのID| |timeout|string|アイテムデータのポーリング要求のタイムアウト。 HTTPエージェントおよびスクリプトLLDルールに使用されます。 ユーザーマクロをサポートします。<br><br>デフォルト:3s<br>最大値:60s| |trapper\_hosts|string|許可されたホスト。 トラッパーLLDルールまたはHTTPエージェントLLDルールによって使用されます。| |username|string|認証用のユーザー名。 シンプルチェック、SSH、Telnet、データベースモニター、JMXおよびHTTPエージェントLLDルールで使用されます。<br><br>SSHおよびTelnetLLDルールで必要です。| |uuid|string|インポートされたLLDルールを既存のルールにリンクするために使用されるユニバーサル一意識別子。 テンプレートのLLDルールにのみ使用されます。 指定されていない場合は自動生成されます。<br><br>更新操作の場合、このフィールドは*読取専用*です。| |verify\_host|integer|HTTPエージェントLLDルールフィールド。 URLの検証ホスト名は、ホスト証明書の共通名フィールドまたはサブジェクト代替名フィールドにあります。<br><br>0 - *(デフォルト)*検証しない<br>1 - 検証する| |verify\_peer|integer|HTTPエージェントLLDルールフィールド。 検証は本物のホスト証明書です。<br><br>0 - *(デフォルト)*検証しない<br>1 - 検証する| ### Loadable MongoDB plugin MongoDB [plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) is no longer part of Zabbix agent 2 and is now available as a loadable plugin instead. List of supported MongoDB versions has been extended to *2.6-5.3*. Plugin functionality and set of supported [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) haven't change. ### ロード可能なMongoDBプラグイン MongoDB[プラグイン](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md)は、Zabbixエージェント2の一部ではなくなり、代わりにロード可能なプラグインとして提供されるようになりました。 サポートされるMongoDBバージョンが*2.6-5.3*に拡張されました。 プラグインの機能とサポートされる[アイテム](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb)のセットは変更されていません。 ### Loadable MongoDB plugin MongoDB [plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) is no longer part of Zabbix agent 2 and is now available as a loadable plugin instead. List of supported MongoDB versions has been extended to *2.6-5.3*. Plugin functionality and set of supported [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) haven't change. The MongoDB plugin, along with other loadable plugins which may potentially be added in the future, is stored in the new repository [zabbix-agent2-plugins](http://repo.zabbix.com/zabbix-agent2-plugins/). The package *zabbix-release* now adds this repository to the user's system. To continue monitoring MongoDB on the installations from official Zabbix packages, update *zabbix-release* package and install *zabbix-agent2-plugin-mongodb* package. Sources are available on [CDN](https://cdn.zabbix.com/zabbix-agent2-plugins/sources/mongodb/). ### ロード可能なMongoDBプラグイン MongoDB[プラグイン](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md)は、Zabbix エージェント2の一部ではなくなり、ロード可能なプラグインとして利用できるようになりました。 サポートするMongoDBバージョンのリストが*2.6-5.3*に拡張されました。 MongoDBプラグインは、将来追加される可能性のある他のロード可能なプラグインとともに、新しいリポジトリ[zabbix-agent2-plugins](http://repo.zabbix.com/zabbix-agent2-plugins/)に保存されます。パッケージ*zabbix-release*は、このリポジトリをユーザーのシステムに追加します。 公式のZabbixパッケージからのインストールでMongoDBの監視を継続するには、*zabbix-release*パッケージを更新し、*zabbix-agent2-plugin-mongodb*パッケージをインストールします。 ソースは[CDN](https://cdn.zabbix.com/zabbix-agent2-plugins/sources/mongodb/)で入手できます。 ##### Loadable ::: notetip Loadable plugins, when launched with:<br> - *-V --version* - print plugin version and license information;<br> - *-h --help* - print help information. ::: Click on the plugin name to go to the plugin repository with additional information. |Plugin name|Description|Supported item keys|Comments| |--|--|--|----| |[MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md)|Monitoring of MongoDB servers and clusters (document-based, distributed database).|mongodb.collection.stats, mongodb.collections.discovery, mongodb.collections.usage, mongodb.connpool.stats,<br>mongodb.db.stats, mongodb.db.discovery, mongodb.jumbo\_chunks.count, mongodb.oplog.stats,<br>mongodb.ping, mongodb.rs.config, mongodb.rs.status, mongodb.server.status,<br>mongodb.sh.discovery| | |[PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/README.md)|Monitoring of PostgreSQL and its forks.|pgsql.autovacuum.count, pgsql.archive, pgsql.bgwriter, pgsql.cache.hit, pgsql.connections,<br> pgsql.custom.query, pgsql.dbstat, pgsql.dbstat.sum, pgsql.db.age, pgsql.db.bloating\_tables, <br> pgsql.db.discovery, pgsql.db.size, pgsql.locks, pgsql.oldest.xid, pgsql.ping, pgsql.queries, <br> pgsql.replication.count, pgsql.replication.process, pgsql.replication.process.discovery, pgsql.replication.recovery\_role, pgsql.replication.status, <br> pgsql.replication\_lag.b, pgsql.replication\_lag.sec, pgsql.uptime, pgsql.wal.stat |This plugin is loadable since Zabbix 6.0.10 (built-in previously).<br><br>To configure encrypted connections to the database, use [named sessions](#named_sessions) and specify the TLS parameters for the named session in the agent configuration file. Currently, TLS parameters cannot be passed as item key parameters.| See also: [Building loadable plugins](/manual/config/items/plugins/build). ##### 読み込み可 ::: notetip ロード可能なプラグインを以下のオプションで起動した場合: - *-V --version* - プラグインのバージョンとライセンス情報を出力します。 - *-h --help* - ヘルプ情報を出力します。 ::: プラグイン名をクリックして、追加情報を含むプラグイン リポジトリに移動します。 |プラグイン名|説明|対応アイテムキー|コメント| |--|--|--|----| |[MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md)|MongoDB サーバーとクラスターの監視 (ドキュメント ベース、分散データベース)|mongodb.collection.stats、mongodb.collections.discovery、mongodb.collections.usage、mongodb.connpool.stats、mongodb.db.stats、mongodb.db.discovery、mongodb.jumbo\_chunks.count、mongodb.oplog.stats、mongodb.ping、mongodb.rs.config、mongodb.rs.status、mongodb.server.status、mongodb.sh.discovery| | | |[PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/README.md)|PostgreSQL とそのフォークの監視|pgsql.autovacuum.count、pgsql.archive、pgsql.bgwriter、pgsql.cache.hit、pgsql.connections、<br> pgsql.custom.query、pgsql.dbstat、pgsql.dbstat.sum 、pgsql.db.age、pgsql.db.bloating\_tables、pgsql.db.discovery、pgsql.db.size、pgsql.locks、pgsql.oldest.xid、pgsql.ping、pgsql.queries、pgsql.replication.count, pgsql.replication.process, pgsql.replication.process.discovery, pgsql.replication.recovery\_role, pgsql.replication.status, pgsql.replication\_lag.b, pgsql.replication\ _lag.sec, pgsql.uptime, pgsql.wal.stat |このプラグインは Zabbix 6.0.10 以降でロード可能です (以前はビルトインでした)。<br><br>データベースへの暗号化された接続を構成するには、[named_sessions](#named_sessions) を作成し、エージェント構成ファイルで名前付きセッションの TLS パラメーターを指定します。 現在、TLS パラメーターをアイテム キー パラメーターとして渡すことはできません。| 参照: [ロード可能なプラグインの構築](/manual/config/items/plugins/build). ### Loadable plugins ##### Encrypted MongoDB plugin connection MongoDB plugin now supports TLS encryption when connecting to MongoDB using named sessions. Updated plugin (MongoDB plugin 1.2.1) is included into Zabbix official packages starting from Zabbix 6.0.14. Note that MongoDB is a loadable plugin and can be installed separately either from packages or from sources. The plugin will work with any minor version of Zabbix 6.0. For more details see [MongoDB plugin](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin). ### ロード可能なプラグイン ##### 暗号化されたMongoDBプラグインの接続 MongoDBプラグインは、名前付きセッションを使用してMongoDBに接続するときにTLS暗号化をサポートするようになりました。 Zabbix 6.0.14以降、更新されたプラグイン(MongoDB plugin 1.2.1)がZabbix公式パッケージに含まれています。このMongoDB用のプラグインはロード可能なプラグインであり、パッケージまたはソースから個別にインストールできることに注意してください。このプラグインは、Zabbix 6.0のすべてのマイナーバージョンで動作します。詳細については、[MongoDBプラグイン](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin)を参照してください。 ##### Load on I/O Item's persistent file is updated after successful sending of every batch of data \(containing item's data\) to server. For example, default 'BufferSize' is 100. If a log item has found 70 matching records then the first 50 records will be sent in one batch, persistent file will be updated, then remaining 20 records will be sent \(maybe with some delay when more data is accumulated\) in the 2nd batch, and the persistent file will be updated again. ##### I/Oの負荷 Item の永続化ファイル は、item のデータを含むデータを server に送信するたびに更新されます。 例えば、デフォルトの'BufferSize'は100です。<br> ログアイテムが70件のマッチングレコードを発見した場合、最初の50件のレコードを一括して送信し、永続化ファイルを更新した後、<br> 残りの20レコードが2回目のバッチで送信され、永続化ファイルが再び更新されます。<br> #### Locale Note that the agent requires a UTF-8 locale so that some textual agent items can return the expected content. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically. #### ロケール 一部の文字型のエージェントアイテムで期待される値を返すには、UTF-8ロケールがエージェントに必要であることに注意してください。最新のUnixライクシステムのほとんどはデフォルトでUTF-8ロケールを持っていますが、一部のシステムでは具体的に設定する必要がある可能性があります。 #### Locale Note that the proxy requires a UTF-8 locale so that some textual items can be interpreted correctly. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically. #### ロケール いくつかのテキスト形式のアイテムを正しく処理できるようにするため、プロキシにはUTF-8のロケールが必要であることに注意してください。最近のほとんどのUNIXライクなシステムにはデフォルトでUTF-8ロケールがありますが、システムによっては具体的に設定しなければ使用することができません。 #### Locale Note that the server requires a UTF-8 locale so that some textual items can be interpreted correctly. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically. #### ロケール いくつかのテキスト形式のアイテムを正しく処理できるようにするため、サーバーにはUTF-8のロケールが必要であることに注意してください。最近のほとんどのUNIXライクなシステムにはデフォルトでUTF-8ロケールがありますが、システムによっては具体的に設定しなければ使用することができません。 ### Log entry The log entry object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |level|integer|Log level.| |ms|string|The time elapsed in milliseconds since the script was run before log entry was added.| |message|string|Log message.| ### Log entry log entryオブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |level|integer|ログレベル| |ms|string|スクリプトが実行されてからログエントリが追加されるまでの経過時間(ミリ秒単位)| |message|string|ログメッセージ| #### Log file monitoring `log[]` and `logrt[]` items repeatedly reread log file from the beginning if file system is 100% full and the log file is being appended (see [ZBX-10884](https://support.zabbix.com/browse/ZBX-10884) for more information). #### ログファイルの監視 アイテム`log[]`および`logrt[]` は、ファイルシステムが100%使用されていてログファイルに追加される場合、ログファイルを先頭から繰り返し再読み込みします (詳細については、[ZBX-10884](https://support.zabbix.com/browse/ZBX-10884)を参照してください) 。 ##### Logging Add the "Log test" entry to the Zabbix server log and receive the item value "1" in return: - Create an item with type "Script". - In the *Script* field, enter: ```javascript Zabbix.log(3, 'Log test'); return 1; ``` ##### ロギング Zabbix server ログに "Log test" エントリを追加し、アイテム値 "1" を返信します。 - タイプ "Script" の item を作成します。 - *Script* フィールドに、以下のコードを入力します。 ``` {.java} Zabbix.log(3, 'Log test'); return 1; ``` #### Logging out Log out from the API. Request: ```json { "jsonrpc": "2.0", "method": "user.logout", "params": [], "id": 1, "auth": "16a46baf181ef9602e1687f3110abf8a" } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### ログアウト APIからログアウト Request: ```json { "jsonrpc": "2.0", "method": "user.logout", "params": [], "id": 1, "auth": "16a46baf181ef9602e1687f3110abf8a" } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ### Log history The log history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |logeventid|integer|Windows event log entry ID.| |ns|integer|Nanoseconds when the value was received.| |severity|integer|Windows event log entry level.| |source|string|Windows event log entry source.| |timestamp|timestamp|Windows event log entry time.| |value|text|Received value.| ### Log history Log history オブジェクトは、以下のプロパティを持ちます。 |プロパティ|[Type](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |logeventid|integer|Windows event log entry ID.| |ns|integer|Nanoseconds when the value was received.| |severity|integer|Windows event log entry level.| |source|string|Windows event log entry source.| |timestamp|timestamp|Windows event log entry time.| |value|text|Received value.| #### Login and systemd We recommend [creating](/manual/installation/install#create_user_account) a *zabbix* user as system user, that is, without ability to log in. Some users ignore this recommendation and use the same account to log in (e. g. using SSH) to host running Zabbix. This might crash Zabbix daemon on log out. In this case you will get something like the following in Zabbix server log: zabbix_server [27730]: [file:'selfmon.c',line:375] lock failed: [22] Invalid argument zabbix_server [27716]: [file:'dbconfig.c',line:5266] lock failed: [22] Invalid argument zabbix_server [27706]: [file:'log.c',line:238] lock failed: [22] Invalid argument and in Zabbix agent log: zabbix_agentd [27796]: [file:'log.c',line:238] lock failed: [22] Invalid argument This happens because of default systemd setting `RemoveIPC=yes` configured in `/etc/systemd/logind.conf`. When you log out of the system the semaphores created by Zabbix previously are removed which causes the crash. A quote from systemd documentation: RemoveIPC= Controls whether System V and POSIX IPC objects belonging to the user shall be removed when the user fully logs out. Takes a boolean argument. If enabled, the user may not consume IPC resources after the last of the user's sessions terminated. This covers System V semaphores, shared memory and message queues, as well as POSIX shared memory and message queues. Note that IPC objects of the root user and other system users are excluded from the effect of this setting. Defaults to "yes". There are 2 solutions to this problem: 1. (recommended) Stop using *zabbix* account for anything else than Zabbix processes, create a dedicated account for other things. 2. (not recommended) Set `RemoveIPC=no` in `/etc/systemd/logind.conf` and reboot the system. Note that `RemoveIPC` is a system-wide parameter, changing it will affect the whole system. #### ログインとsystemd ログインできないシステムユーザーとして*zabbix*ユーザーを[作成](/manual/installation/install#create_user_account)することをお勧めします。一部のユーザーはこの推奨事項を無視し、同じアカウントを使用してZabbixを実行しているホストにログイン（SSHを使用するなど）しますが、ログアウト時にZabbixデーモンがクラッシュする可能性があります。 この場合、Zabbixサーバーログに次のようなものが表示されます。 zabbix_server [27730]: [file:'selfmon.c',line:375] lock failed: [22] Invalid argument zabbix_server [27716]: [file:'dbconfig.c',line:5266] lock failed: [22] Invalid argument zabbix_server [27706]: [file:'log.c',line:238] lock failed: [22] Invalid argument Zabbixエージェントログ： zabbix_agentd [27796]: [file:'log.c',line:238] lock failed: [22] Invalid argument これは、`/etc/systemd/logind.conf`で構成されたデフォルトのsystemd設定`RemoveIPC=yes`が原因で発生します。 システムからログアウトすると、Zabbixによって以前に作成されたセマフォが削除され、クラッシュが発生します。 systemdドキュメントからの引用： RemoveIPC= ユーザーが完全にログアウトしたときに、ユーザーに属するSystemVおよびPOSIXIPCオブジェクトを削除するかどうかを制御します。 ブール引数を取ります。 有効にすると、ユーザーの最後のセッションが終了した後、ユーザーはIPCリソースを消費できなくなります。 これには、System Vセマフォ、共有メモリとメッセージキュー、およびPOSIX共有メモリとメッセージキューが含まれます。 rootユーザーおよび他のシステムユーザーのIPCオブジェクトは、この設定の影響から除外されることに注意してください。 デフォルトは「yes」です。 この問題には2つの解決策があります。 1. （推奨）Zabbixプロセス以外の目的で* zabbix *アカウントの使用を停止し、専用アカウントを作成します。 2. （非推奨）`/etc/systemd/logind.conf`で`RemoveIPC= no`を設定し、システムを再起動します。`RemoveIPC`はシステム全体のパラメータであり、変更するとシステム全体に影響することに注意してください。 #### Login {width="350"} This is the Zabbix welcome screen. Enter the user name **Admin** with password **zabbix** to log in as a [Zabbix superuser](/manual/config/users_and_usergroups/permissions). Access to *Configuration* and *Administration* menus will be granted. For security reasons, it is strongly recommended to change the default password for the Admin account immediately after the first login. #### ログイン {width="350"} これはZabbixのウェルカム画面です。ユーザー名に**Admin**パスワードに**zabbix**と入力して[Zabbixのスーパーユーザー](/manual/config/users_and_usergroups/permissions)としてログインします。 *設定*および*管理*メニューへのアクセスが可能となります。 セキュリティ上の理由から、最初のログイン直後に管理者アカウントのデフォルトのパスワードを変更することを強くお勧めします。 #### Log in Zabbix frontend is ready! The default user name is **Admin**, password **zabbix**. {width="350"} Proceed to [getting started with Zabbix](/manual/quickstart/login). #### ログイン Zabbixフロントエンドの準備が完了しました！ デフォルトのユーザ名は**Admin**、パスワードは**zabbix** です。 {width="350"} [Zabbixの使い方](/manual/quickstart/login)に進みます。 ### Log level control targets *process-type* All processes of specified type (active checks, collector, listener) *process-type,N* Process type and number (e.g., listener,3) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Print known items and exit. For each item either generic defaults are used, or specific defaults for testing are supplied. These defaults are listed in square brackets as item key parameters. Returned values are enclosed in square brackets and prefixed with the type of the returned value, separated by a pipe character. For user parameters type is always **t**, as the agent can not determine all possible return values. Items, displayed as working, are not guaranteed to work from the Zabbix server or zabbix\_get when querying a running agent daemon as permissions or environment may be different. Returned value types are: d Number with a decimal part. m Not supported. This could be caused by querying an item that only works in the active mode like a log monitoring item or an item that requires multiple collected values. Permission issues or incorrect user parameters could also result in the not supported state. s Text. Maximum length not limited. t Text. Same as **s**. u Unsigned integer. **-t**, **--test** *item-key* Test single item and exit. See **--print** for output description. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### ログレベル制御対象 *process-type* 指定されたタイプのすべてのプロセス(アクティブチェック、コレクター、リスナー)。 *process-type,N* プロセスの種類と数 (例: listener,3)。 *pid* プロセスID。最大65535。値がさらに大きい場合はターゲットを"process-type,N"と指定します。 ```{=html} <!-- --> ``` **-p**, **--print** 既知のアイテムを表示して終了します。各アイテムに対して、一般的なデフォルトが使用されるか、テスト用の特定のデフォルトが提供されます。これらのデフォルトは、アイテムキーのパラメーターとして角括弧内にリストされています。戻り値は角括弧で囲まれ、パイプ文字で区切られた戻り値の型が前に付けられます。ユーザーパラメーターの型は常に**t**となります。これは、エージェントが可能なすべての戻り値を決定できるわけではないためです。権限または環境が異なる可能性があるため、実行中のエージェントデーモンをクエリする場合、動作していると表示されるアイテムは、Zabbixサーバーまたはzabbix\_getから動作することが保証されません。戻り値の型は以下の通りです。 d 小数部分を含む数値。 m サポートされていません。これは、ログ監視アイテムや複数の収集値を必要とするアイテムなど、アクティブモードでのみ機能するアイテムをクエリしたことが原因である可能性があります。権限の問題や、ユーザーパラメーターが正しくない場合も、サポートされていない状態になる可能性があります。 s テキスト。長さに制限はありません。 t テキスト。**s**と同じです。 u 符号なし整数。 **-t**, **--test** *item-key* 単一のアイテムをテストして終了します。 出力の説明については、**--print**を参照してください。 **-h**, **--help** このヘルプを出力して終了します。 **-V**, **--version** バージョン情報を出力して終了します。 [ ]{#lbAH} ### Log level control targets *process-type* All processes of specified type (alerter, alert manager, configuration syncer, discoverer, escalator, ha manager, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector, history poller, availability manager, service manager, odbc poller) *process-type,N* Process type and number (e.g., poller,3) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" Profiling control targets *process-type* All processes of specified type (alerter, alert manager, configuration syncer, discoverer, escalator, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector, history poller, availability manager, service manager, odbc poller) *process-type,N* Process type and number (e.g., history syncer,1) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" *scope* Profiling scope (rwlock, mutex, processing) can be used with process type (e.g., history syncer,1,processing) [ ]{#lbAH} ### ログレベル制御対象 *process-type* 指定されたタイプのすべてのプロセス (alerter, alert manager, configuration syncer, discoverer, escalator, ha manager, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector, history poller, availability manager, service manager, odbc poller)。 *process-type,N* プロセスの種類と数 (例: poller,3)。 *pid* プロセスID。最大65535。値が大きい場合はターゲットを"process-type,N"と指定します。 プロファイリング制御対象 *process-type* 指定されたタイプのすべてのプロセス (alerter, alert manager, configuration syncer, discoverer, escalator, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector, history poller, availability manager, service manager, odbc poller)。 *process-type,N* プロセスの種類と数 (例: history syncer,1)。 *pid* プロセスID。最大65535。値が大きい場合はターゲットを"process-type,N"と指定します。 *scope* プロファイリング範囲(rwlock, mutex, processing)はプロセスタイプで使用できます (例: history syncer,1,processing)。 [ ]{#lbAH} ### Log level control targets *process-type* All processes of specified type (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector, history poller, availability manager, odbc poller) *process-type,N* Process type and number (e.g., poller,3) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" Profiling control targets *process-type* All processes of specified type (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector, history poller, availability manager, odbc poller) *process-type,N* Process type and number (e.g., history syncer,1) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" *scope* Profiling scope (rwlock, mutex, processing) can be used with process type (e.g., history syncer,1,processing) **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### ログレベル制御対象 *process-type* 指定されたタイプのすべてのプロセス (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector, history poller, availability manager, odbc poller)。 *process-type,N* プロセスの種類と数 (例: poller,3)。 *pid* プロセスID。最大65535。値が大きい場合はターゲットを"process-type,N"と指定します。 制御対象のプロファイリング *process-type* 指定されたタイプのすべてのプロセス (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector, history poller, availability manager, odbc poller)。 *process-type,N* プロセスの種類と数 (例: history syncer,1)。 *pid* プロセスID。最大65535。値が大きい場合はターゲットを"process-type,N"と指定します。 *scope* プロファイリング対象(rwlock、mutex、processing)はプロセスタイプで使用可能 (例: history syncer,1,processing)。 **-h**, **--help** ヘルプを出力して終了します。 **-V**, **--version** バージョン情報を出力して終了します。 [ ]{#lbAH} ###### Log request A request sent by a plugin to write a log message into the agent log file. | | | |---|---| |direction|plugin → agent| |response|no| Parameters specific to log requests: |Name|Type|Comments| |---------|--------|----------| |severity|uint32|The message severity (log level).| |message|string|The message to log.| *Example:* {"id":0,"type":1,"severity":3,"message":"message"} ###### ログリクエスト プラグインからエージェントのログファイルにログメッセージを書き込むために送信されるリクエスト。 | | | |---|---| |direction|plugin → agent| |response|no| ログリクエスト固有のパラメータ: |Name|Type|Comments| |---------|--------|----------| |severity|uint32|メッセージの重要度（ログレベル）| |message|string|ログに記録するメッセージ| *例:* {"id":0,"type":1,"severity":3,"message":"message"} #### Logrotate for Zabbix server and proxy The logrotate utility is only included into packages for zabbix-agent, zabbix-agent2 and zabbix-web-service, but needs to be installed separately for Zabbix server and proxy. The logrotate dependency has been added to the server and proxy packages for RHEL and SUSE starting from Zabbix 6.4.4rc1. #### Zabbixサーバーおよびプロキシのlogrotate logrotateユーティリティは、zabbix-agent、zabbix-agent2、およびzabbix-web-serviceのパッケージにのみ含まれていますが、Zabbixサーバーおよびプロキシの場合は個別にインストールする必要があります。logrotate依存関係は、Zabbix 6.4.4rc1以降、RHELおよびSUSEのサーバーおよびプロキシパッケージに追加されました。 #### Low-level discovery Configure low-level discovery rules as well as item, trigger and graph prototypes to monitor dynamic entities. [LLD rule API](/manual/api/reference/discoveryrule) | [Item prototype API](/manual/api/reference/itemprototype) | [Trigger prototype API](/manual/api/reference/triggerprototype) | [Graph prototype API](/manual/api/reference/graphprototype) | [Host prototype API](/manual/api/reference/hostprototype) #### ローレベルディスカバリ 動的なエンティティを監視するために、ローレベルディスカバリルール、item、trigger、グラフのプロトタイプを設定します。 [LLD rule API](/manual/api/reference/discoveryrule) | [Item prototype API](/manual/api/reference/itemprototype) | [Trigger prototype API](/manual/api/reference/triggerprototype) | [Graph prototype API](/manual/api/reference/graphprototype) | [Host prototype API](/manual/api/reference/hostprototype) #### Low-level discovery In a [low-level discovery rule](/manual/discovery/low_level_discovery#configuring_low-level_discovery), user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Key parameters|<|yes| |Update interval|<|no| |Custom interval|<|no| |Keep lost resources period|<|no| |Description|<|yes| |*SNMP agent*|<|<| | |SNMP OID|yes| |*SSH agent*|<|<| | |Username|yes| |^|Public key file|yes| |^|Private key file|yes| |^|Password|yes| |^|Script|yes| |*TELNET agent*|<|<| | |Username|yes| |^|Password|yes| |^|Script|yes| |*Zabbix trapper*|<|<| | |Allowed hosts|yes| |*Database monitor*|<|<| | |Username|yes| |^|Password|yes| |^|SQL query|yes| |*JMX agent*|<|<| | |JMX endpoint|yes| |*HTTP agent*|<|<| | |URL^[3](supported_by_location_user#footnotes)^|yes| |^|Query fields|yes| |^|Timeout|no| |^|Request body|yes| |^|Headers (names and values)|yes| |^|Required status codes|yes| |^|HTTP authentication username|yes| |^|HTTP authentication password|yes| |*Filters*|<|<| | |Regular expression|yes| |*Overrides*|<|<| | |Filters: regular expression|yes| |^|Operations: update interval (for item prototypes)|no| |^|Operations: history storage period (for item prototypes)|no| |^|Operations: trend storage period (for item prototypes)|no| #### ローレベルディスカバリ [ローレベルディスカバリルール](/manual/discovery/low_level_discovery#configuring_low-level_discovery)では、次のフィールドでユーザー マクロを使用できます。 |ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |キー|<|yes| |監視間隔|<|no| |監視間隔のカスタマイズ|<|no| |存在しなくなったリソースの保持期間|<|no| |説明|<|yes| |*SNMPエージェント*|<|<| | |SNMP OID|yes| |*SSHエージェント*|<|<| | |ユーザー名|yes| |^|公開鍵ファイル|yes| |^|秘密鍵ファイル|yes| |^|パスワード|yes| |^|実行するスクリプト|yes| |*TELNETエージェント*|<|<| | |ユーザー名|yes| |^|パスワード|yes| |^|実行するスクリプト|yes| |*Zabbixトラッパー*|<|<| | |許可されたホスト|yes| |*データベースモニタ*|<|<| | |ユーザー名|yes| |^|パスワード|yes| |^|SQL クエリ|yes| |*JMX エージェント*|<|<| | |JMX エンドポイント|yes| |*HTTP エージェント*|<|<| | |URL^[3](supported_by_location_user#footnotes)^|yes| |^|クエリフィールド|yes| |^|タイムアウト|no| |^|リクエストボディ|yes| |^|ヘッダー (名前と値)|yes| |^|要求ステータスコード|yes| |^|HTTP認証ユーザー名|yes| |^|HTTP認証パスワード|yes| |*フィルター*|<|<| | |正規表現|yes| |*オーバーライド*|<|<| | |フィルター: 正規表現|yes| |^|実行内容の作成: 監視間隔 (アイテムのプロトタイプ)|no| |^|実行内容の作成: ヒストリの保存期間 (アイテムのプロトタイプ)|no| |^|実行内容の作成: トレンドの保存期間 (アイテムのプロトタイプ)|no| #### Low-level discovery macros Even though no low-level discovery macros are created in the returned JSON, these macros can be defined by the user as an additional step, using the [custom LLD macro](/manual/discovery/low_level_discovery#custom_macros) functionality with JSONPath pointing to the discovered values in the returned JSON. The macros then can be used to create item, trigger, etc prototypes. #### ローレベルディスカバリマクロ 返されたJSONにローレベルディスカバリマクロは作成されませんが、これらのマクロは、返されたJSONで検出された値を指すJSONPathで[カスタムLLDマクロ](/manual/discovery/low_level_discovery#custom_macros)機能を使用して、追加の手順としてユーザーが定義できます。 その後、マクロを使用して、アイテム、トリガーなどのプロトタイプを作成できます。 #### Macro functions The range of the `fmtnum` [macro function](/manual/config/macros/macro_functions#supported-macro-functions) is now limited to 0-20. #### マクロ関数 [マクロ関数](/manual/config/macros/macro_functions#supported-macro-functions)`fmtnum`の範囲が 0 ~ 20 に制限されました。 ## Macros ## マクロ #### Macros #### マクロ ## Macros ## マクロ Macros for internal actions contain the reason why an item, an LLD-rule, or a trigger became unsupported: - {ITEM.STATE.ERROR} - for item-based internal notifications; - {LLDRULE.STATE.ERROR} - for LLD-rule based internal notifications; - {TRIGGER.STATE.ERROR} - for trigger-based internal notifications. For more details, see [Supported macros](/manual/appendix/macros/supported_by_location). 内部アクションのマクロは、アイテム、LLDルール、トリガーがサポートされなくなった理由を含んでいます。 - {ITEM.STATE.ERROR} - アイテムベースの内部通知用 - {LLDRULE.STATE.ERROR} - LLDルールベースの内部通知用 - {TRIGGER.STATE.ERROR} - トリガーベースの内部通知用 詳しくは、[サポートされるマクロ](/manual/appendix/macros/supported_by_location)を参照してください。 #### Macro support for email media types When configuring an [email media type](/manual/config/notifications/media/email), it is now possible to use macros in the [username and password fields](/manual/appendix/macros/supported_by_location_user#other-locations). #### 電子メールメディアタイプのマクロをサポート [電子メールのメディアタイプ](/manual/config/notifications/media/email)を設定するときに、[ユーザー名とパスワードのフィールド](/manual/appendix/macros/supported_by_location_user#other-locations)でマクロを使用できるようになりました。 #### Macro support The following macros may be used in trigger tags: - {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros can be used to populate the tag name or tag value - {INVENTORY.\*} [macros](/manual/appendix/macros/supported_by_location) can be used to reference host inventory values from one or several hosts in a trigger expression - [User macros](/manual/config/macros/user_macros) and user macro context is supported for the tag name/value. User macro context may include low-level discovery macros - Low-level discovery macros can be used for the tag name/value in trigger prototypes The following macros may be used in trigger-based notifications: - {EVENT.TAGS} and {EVENT.RECOVERY.TAGS} macros will resolve to a comma separated list of event tags or recovery event tags - {EVENT.TAGSJSON} and {EVENT.RECOVERY.TAGSJSON} macros will resolve to a JSON array containing event tag [objects](/manual/api/reference/event/object#event_tag) or recovery event tag objects The following macros may be used in template, host, item and web scenario tags: - {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros - {INVENTORY.\*} [macros](/manual/appendix/macros/supported_by_location) - [User macros](/manual/config/macros/user_macros) - Low-level discovery macros can be used in item prototype tags The following macros may be used in host prototype tags: - {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros - {INVENTORY.\*} [macros](/manual/appendix/macros/supported_by_location) - [User macros](/manual/config/macros/user_macros) - [Low-level discovery macros](/manual/config/macros/lld_macros) will be resolved during discovery process and then added to the discovered host #### マクロのサポート トリガータグでは、以下のマクロを使用することができます: - {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}、{HOST.DNS}、{HOST.IP}、{HOST.PORT} および {HOST.ID} マクロは、タグ名またはタグ値を入力するために 使用することができま す。 - トリガ式で1つまたは複数のホストからホスト・インベントリ値を参照するには、 {INVENTORY.\*}[macros] (/manual/appendix/macros/supported_by_location) を使用することができます。 - [User macros](/manual/config/macros/user_macros)とタグ名/値に対してユーザーマクロコンテキストがサポート されています。ユーザーマクロコンテキストは、ローレベルディスカバリーマクロを含む場合があります。 - トリガープロトタイプのタグ名/値にローレベルディスカバリーマクロを使用することができます。 トリガーベースの通知では、以下のマクロを使用することができます: - {EVENT.TAGS}と{EVENT.RECOVERY.TAGS}マクロは、イベントタグまたは回復イベントタグのカンマ区切りリストに解決されます。 - {EVENT.TAGSJSON} と {EVENT.RECOVERY.TAGSJSON} マクロは、イベントタグ [object](/manual/api/reference/event/object#event_tag) または回復イベントタグ オブジェクトを含む JSON 配列に解決されるでしょう。 テンプレート、ホスト、item、Webシナリオで使用できるマクロは次のとおりです: - {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros - {INVENTORY.\*} [macros](/manual/appendix/macros/supported_by_location) - [User macros](/manual/config/macros/user_macros) - アイテムプロトタイプタグにローレベルディスカバリーマクロを使用することができます ホストプロトタイプタグには、以下のマクロを使用することができます: - {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros - {INVENTORY.\*} [macros](/manual/appendix/macros/supported_by_location) - [User macros](/manual/config/macros/user_macros) - [Low-level discovery macros](/manual/config/macros/lld_macros) は、ディスカバリープロセス中に解決され、 発見されたホストに追加されるでしょう。 # maintenance.create # maintenance.create # maintenance.delete # maintenance.delete # maintenance.get # maintenance.get ### Maintenance The maintenance object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |maintenanceid|string|*(readonly)* ID of the maintenance.| |**name**<br>(required)|string|Name of the maintenance.| |**active\_since**<br>(required)|timestamp|Time when the maintenance becomes active.| |**active\_till**<br>(required)|timestamp|Time when the maintenance stops being active.| |description|string|Description of the maintenance.| |maintenance\_type|integer|Type of maintenance.<br><br>Possible values:<br>0 - *(default)* with data collection;<br>1 - without data collection.| |tags\_evaltype|integer|Problem tag evaluation method.<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.| ### Maintenance The maintenance object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |maintenanceid|string|*(readonly)* ID of the maintenance.| |**name**<br>(required)|string|Name of the maintenance.| |**active\_since**<br>(required)|timestamp|Time when the maintenance becomes active.| |**active\_till**<br>(required)|timestamp|Time when the maintenance stops being active.| |description|string|Description of the maintenance.| |maintenance\_type|integer|Type of maintenance.<br><br>Possible values:<br>0 - *(default)* with data collection;<br>1 - without data collection.| |tags\_evaltype|integer|Problem tag evaluation method.<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.| # maintenance.update # maintenance.update ### Makefile targets Loadable plugins provided by Zabbix have simple makefiles with the following targets: |Target|Description| |--|--------| |make|Build plugin.| |make clean|Delete all files that are normally created by building the plugin.| |make check|Perform self-tests. A real PostgreSQL database is required.| |make style|Check Go code style with 'golangci-lint'.| |make format|Format Go code with 'go fmt'.| |make dist|Create an archive containing the plugin sources and sources of all packages needed to build the plugin and and its self-tests.| ### Makefileのターゲット Zabbixが用意しているローダブルモジュールの基本的なMakefileには以下のようなターゲットを用意しています： |ターゲット|説明| |--|--------| |make|プラグインをビルドします。| |make clean|プラグインのビルド時に通常作成されたすべてのファイルを削除します。| |make check|セルフテストを実行します。実際のPostgreSQLデータベースが必要です。| |make style|'golangci-lint'を用いてGo言語の文法チェックを行います。| |make format|'go fmt'を用いてGo言語のコードのフォーマッティングを行います。| |make dist|プラグインのソースと、プラグインとそのセルフテストのビルドに必要なすべてのパッケージのソースを含むアーカイブを作成します。| ### Managing HA cluster The current status of the HA cluster can be managed using the dedicated [runtime control](/manual/concepts/server#runtime_control) options: - `ha_status` - log HA cluster status in the Zabbix server log (and to stdout) - `ha_remove_node=target` - remove an HA node identified by its \<target\> - name or ID of the node (name/ID can be obtained from the output of running ha\_status), e.g.: ``` zabbix_server -R ha_remove_node=zabbix-node-02 ``` Note that active/standby nodes cannot be removed. - `ha_set_failover_delay=delay` - set HA failover delay (between 10 seconds and 15 minutes; time suffixes are supported, e.g. 10s, 1m) Node status can be monitored: - in *Reports* → *[System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix#high-availability-nodes)* - in the *System information* dashboard widget - using the `ha_status` runtime control option of the server (see above). The `zabbix[cluster,discovery,nodes]` internal item can be used for node discovery, as it returns a JSON with the high-availability node information. ### HAクラスターの管理 HAクラスターの現在のステータスは、専用の[ランタイムコントロール](/manual/concepts/server#runtime_control)オプションを使用して管理できます。 - `ha_status` - Zabbixサーバーログ(および標準出力)にHAクラスターのステータスを記録します。 - `ha_remove_node=target` - \<target\>で識別されるHAノードを削除します。\<target\>はノードの名前またはIDであり、実行中のha\_statusの出力から取得できます。例: ``` zabbix_server -R ha_remove_node=zabbix-node-02 ``` アクティブ/スタンバイノードは削除できないことに注意してください。 - `ha_set_failover_delay=delay` - HAフェイルオーバー遅延の設定(10秒から15分まで。タイムサフィックスがサポートされています。例: 10s, 1m) ノードのステータスは次のように監視できます : - *レポート* → *[システム情報](/manual/web_interface/frontend_sections/reports/status_of_zabbix#high-availability-nodes)* - *システム情報*のダッシュボードウィジェット - サーバーの`ha_status`ランタイム制御オプション(上記を参照) `zabbix[cluster,discovery,nodes]`の内部アイテムは、高可用性ノード情報を含むJSONを返すため、ノード検出に使用できます。 **Mandatory and optional parameters** Parameters without angle brackets are mandatory. Parameters marked with angle brackets **<** **>** are optional. **Usage with command-line utilities** Note that when testing or using item keys with zabbix_agentd or zabbix_get from the command line you should consider shell syntax too. For example, if a certain parameter of the key has to be enclosed in double quotes you have to explicitly escape double quotes, otherwise they will be trimmed by the shell as special characters and will not be passed to the Zabbix utility. Examples: zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]' zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0] **必須パラメータとオプションパラメータ** 角括弧のないパラメータは必須です。**<** **>** でマークされたパラメータはオプションです。 **コマンドラインユーティリティでの使用方法** コマンドラインから zabbix_agentd または zabbix_get を使用してアイテムキーをテストまたは使用する場合、シェルの構文も考慮する必要があります。 例えば、キーの特定のパラメータを二重引用符(")で囲む必要がある場合、二重引用符を明示的にエスケープする必要があります。<br> 明示的にエスケープしないと、シェルによって二重引用符が特殊文字としてトリミングされ、Zabbixユーティリティに渡されません。 例: $ zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]' $ zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0] ##### Manifest preparation Each module is expected to have a manifest.json file with the following fields in JSON format: |Parameter|Required|Type|Default|Description| |---------|---|----|--|-------------------| |manifest\_version|Yes|Double|\-|Manifest version of the module. Currently supported version is **1**.| |id|Yes|String|\-|Module ID. Only one module with given ID can be enabled at the same time.| |name|Yes|String|\-|Module name as displayed in the Administration section.| |version|Yes|String|\-|Module version as displayed in the Administration section.| |namespace|Yes|String|\-|PHP namespace for Module.php and action classes.| |author|No|String|""|Module author as displayed in the Administration section.| |url|No|String|""|Module URL as displayed in the Administration section.| |description|No|String|""|Module description as displayed in the Administration section.| |actions|No|Object|{}|Actions to register with this module. See Actions.| |config|No|Object|{}|Module configuration.| For reference, please see an example of manifest.json in the [Reference](#reference) section. ##### マニフェストの準備 各モジュールは、次のようなフィールドを持つ JSON 形式の manifest.json ファイルを用意する必要があります。 |Parameter|必須？|型|デフォルト値|説明| |---------|--------|----|-------|-----------| |manifest\_version|Yes|Double|\-|モジュールのマニフェスト・バージョン。現在サポートされているバージョンは **1** です| |id|Yes|String|\-|モジュールID。同時に有効にできるのは、指定されたIDを持つ1つのモジュールのみです| |name|Yes|String|\-|管理セクションに表示されるモジュール名| |version|Yes|String|\-|管理セクションに表示されるモジュールのバージョン| |namespace|Yes|String|\-|Module.php およびアクションクラス用の PHP 名前空間| |author|No|String|""|管理セクションに表示されるモジュール作成者| |url|No|String|""|管理セクションに表示されるモジュールURL| |description|No|String|""|管理セクションに表示されるモジュールの説明| |actions|No|Object|{}|このモジュールに登録するアクション。アクションを参照| |config|No|Object|{}|モジュール設定| 参考までに、[Reference](#reference)セクションの manifest.json の例をご覧ください。 ##### Manual mode When [configuring a host](/manual/config/hosts/host), in the *Inventory* tab you can enter such details as the type of device, serial number, location, responsible person, etc., - the data that will populate inventory information. If a URL is included in the host inventory information and it starts with 'http' or 'https', it will result in a clickable link in the *Inventory* section. ##### 手動モード [ホストを設定](/manual/config/hosts/host)するときに、*インベントリ*タブで、デバイスのタイプ、シリアル番号、場所、担当者などの詳細(インベントリ情報に入力されるデータ)を入力できます。 ホストインベントリ情報にURLが含まれており、そのURLが'http'または'https'で始まる場合、*インベントリ*セクションにクリック可能なリンクが表示されます。 # map.create # map.create # map.delete # map.delete #### Map element Host group The map element Host group object defines one host group element. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|Host group ID| #### Map element Host group map element Host group オブジェクトは、1つのホストグループ要素を定義します。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |groupid|string|ホストグループID| #### Map element Host The map element Host object defines one host element. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|Host ID| #### Map element Host map element Host オブジェクトは 1 つのホスト要素を定義します |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |hostid|string|ホストID| #### Map element Map The map element Map object defines one map element. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapid|string|Map ID| #### Map element Map map element Map オブジェクトは、1つのマップ要素を定義します。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |sysmapid|string|マップID| ### Map element The map element object defines an object displayed on a map. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |selementid|string|*(readonly)* ID of the map element.| |**elements**<br>(required)|array|Element data object. Required for host, host group, trigger and map type elements.| |**elementtype**<br>(required)|integer|Type of map element.<br><br>Possible values:<br>0 - host;<br>1 - map;<br>2 - trigger;<br>3 - host group;<br>4 - image.| |**iconid\_off**<br>(required)|string|ID of the image used to display the element in default state.| |areatype|integer|How separate host group hosts should be displayed.<br><br>Possible values:<br>0 - *(default)* the host group element will take up the whole map;<br>1 - the host group element will have a fixed size.| |elementsubtype|integer|How a host group element should be displayed on a map.<br><br>Possible values:<br>0 - *(default)* display the host group as a single element;<br>1 - display each host in the group separately.| |evaltype|integer|Map element tag filtering condition evaluation method.<br><br>Possible values:<br>0 - *(default)* AND / OR;<br>2 - OR.| |height|integer|Height of the fixed size host group element in pixels.<br><br>Default: 200.| |iconid\_disabled|string|ID of the image used to display disabled map elements. Unused for image elements.| |iconid\_maintenance|string|ID of the image used to display map elements in maintenance. Unused for image elements.| |iconid\_on|string|ID of the image used to display map elements with problems. Unused for image elements.| |label|string|Label of the element.| |label\_location|integer|Location of the map element label.<br><br>Possible values:<br>-1 - *(default)* default location;<br>0 - bottom;<br>1 - left;<br>2 - right;<br>3 - top.| |permission|integer|Type of permission level.<br><br>Possible values:<br>-1 - none;<br>2 - read only;<br>3 - read-write.| |sysmapid|string|*(readonly)* ID of the map that the element belongs to.| |urls|array|Map element URLs.<br><br>The map element URL object is [described in detail below](object#map_element_url).| |use\_iconmap|integer|Whether icon mapping must be used for host elements.<br><br>Possible values:<br>0 - do not use icon mapping;<br>1 - *(default)* use icon mapping.| |viewtype|integer|Host group element placing algorithm.<br><br>Possible values:<br>0 - *(default)* grid.| |width|integer|Width of the fixed size host group element in pixels.<br><br>Default: 200.| |x|integer|X-coordinates of the element in pixels.<br><br>Default: 0.| |y|integer|Y-coordinates of the element in pixels.<br><br>Default: 0.| ### Map element map element オブジェクトは、マップ上に表示されるオブジェクトを定義します。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |selementid|string|*(読取専用)* マップ要素の ID| |**elements**<br>(必須)|array|要素データ オブジェクト。 ホスト、ホスト グループ、トリガー、およびマップタイプ要素に必要です。| |**elementtype**<br>(必須)|integer|マップ要素のタイプ<br><br>有効な値:<br>0 - ホスト<br>1 - マップ<br>2 - トリガー<br>3 - ホスト グループ<br>4 - 画像| |**iconid\_off**<br>(必須)|string|デフォルト状態で要素を表示するために使用される画像の ID| |areatype|integer|個別のホスト グループ ホストを表示する方法。<br><br>有効な値:<br>0 - *(デフォルト)* ホスト グループ要素がマップ全体を占有<br>1 - ホスト グループ要素はサイズ固定| |elementsubtype|integer|ホストグループ要素をマップ上に表示する方法<br><br>有効な値:<br>0 - *(デフォルト)* ホスト グループを 1 つの要素として表示<br>1 - 各ホストを表示 グループで別々に| |evaltype|integer|マップ要素タグのフィルタリング条件評価方法<br><br>有効な値:<br>0 - *(デフォルト)* AND/OR<br>2 - OR| |height|integer|固定サイズのホストグループ要素の高さ (ピクセル単位)<br><br>デフォルト: 200| |iconid\_disabled|string|無効な地図要素を表示するために使用される画像の ID。 画像要素には使用されません。| |iconid\_maintenance|string|メンテナンスでマップ要素を表示するために使用される画像の ID。 画像要素には使用されません。| |iconid\_on|string|障害のあるマップ要素を表示するために使用される画像の ID。 画像要素には使用されません。| |label|string|要素のラベル。| |label\_location|integer|マップ要素ラベル位置<br><br>有効な値:<br>-1 - *(デフォルト)* デフォルト位置<br>0 - 下;<br>1 - 左;<br>2 - 右 ;<br>3 - 上| |permission|integer|権限レベル<br><br>有効な値:<br>-1 - 無し<br>2 - 読取専用<br>3 - 読取/書込| |sysmapid|string|*(読取専用)* 要素が属するマップの ID| |urls|array|マップ要素の URL<br><br>マップ要素のURLオブジェクトについては、[以下で詳しく説明](object#map_element_url)します。| |use\_iconmap|integer|ホスト要素にアイコンマッピングを使用するか<br><br>有効な値:<br>0 - 使用しない<br>1 - *(デフォルト)* 使用する| |viewtype|integer|ホストグループ要素配置アルゴリズム<br><br>可能な値:<br>0 - *(デフォルト)* グリッド| |width|integer|固定サイズのホストグループ要素の幅 (ピクセル単位)<br><br>デフォルト: 200| |x|integer|要素の X 座標 (ピクセル単位)<br><br>デフォルト: 0| |y|integer|要素の Y 座標 (ピクセル単位)<br><br>デフォルト: 0| #### Map element Trigger The map element Trigger object defines one or more trigger elements. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |triggerid|string|Trigger ID| #### Map element Trigger map element Trigger オブジェクトは、1 つまたは複数のトリガー要素を定義します。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |triggerid|string|トリガーID| #### Map element URL The map element URL object defines a clickable link that will be available for a specific map element. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapelementurlid|string|*(readonly)* ID of the map element URL.| |**name**<br>(required)|string|Link caption.| |**url**<br>(required)|string|Link URL.| |selementid|string|ID of the map element that the URL belongs to.| #### Map element URL map element URL オブジェクトは、特定のマップ要素で使用できるクリック可能なリンクを定義します。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |sysmapelementurlid|string|*(読取専用)* マップ要素URLのID| |**name**<br>(必須)|string|リンクのキャプション| |**url**<br>(必須)|string|リンク URL| |selementid|string|URLが属するマップ要素のID| # map.get # map.get #### Map lines Create a map line. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map API lines", "width": 500, "height": 500, "lines": [ { "x1": 30, "y1": 10, "x2": 100, "y2": 50, "line_type": 1, "line_width": 10, "line_color": "009900" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "11" ] }, "id": 1 } ``` #### マップライン マップラインを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map API lines", "width": 500, "height": 500, "lines": [ { "x1": 30, "y1": 10, "x2": 100, "y2": 50, "line_type": 1, "line_width": 10, "line_color": "009900" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "11" ] }, "id": 1 } ``` ### Map lines The map line object defines an line displayed on a map. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmap\_shapeid|string|*(readonly)* ID of the map shape element.| |x1|integer|X-coordinates of the line point 1 in pixels.<br><br>Default: 0.| |y1|integer|Y-coordinates of the line point 1 in pixels.<br><br>Default: 0.| |x2|integer|X-coordinates of the line point 2 in pixels.<br><br>Default: 200.| |y2|integer|Y-coordinates of the line point 2 in pixels.<br><br>Default: 200.| |line\_type|integer|Type of the lines.<br><br>Possible values:<br>0 - none;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Default: 0.| |line\_width|integer|Width of the lines in pixels.<br><br>Default: 0.| |line\_color|string|Line color.<br><br>Default: '000000'.| |zindex|integer|Value used to order all shapes and lines (z-index).<br><br>Default: 0.| ### Map lines map line オブジェクトは、マップに表示されるラインを定義します。 次のプロパティがあります： |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |sysmap\_shapeid|string|*(読取専用)* 地図形状要素のID| |x1|integer|ライン ポイント 1 の X 座標 (ピクセル単位)<br><br>デフォルト: 0| |y1|integer|ライン ポイント 1 の Y 座標 (ピクセル単位)<br><br>デフォルト: 0| |x2|integer|ライン ポイント 2 の X 座標 (ピクセル単位)<br><br>デフォルト: 200| |y2|integer|ライン ポイント 2 の Y 座標 (ピクセル単位)<br><br>デフォルト: 200| |line\_type|integer|線のタイプ<br><br>使用可能な値:<br>0 - 無し<br>1 - `—————`<br>2 - `·····`<br>3 - `- - -`<br><br>デフォルト: 0| |line\_width|integer|ラインの幅 (ピクセル単位)<br><br>デフォルト: 0| |line\_color|string|ラインの色<br><br>デフォルト: '000000'| |zindex|integer|すべての形と線の順序付けに使用される値 (z-index)<br><br>デフォルト: 0| ### Map link The map link object defines a link between two map elements. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |linkid|string|*(readonly)* ID of the map link.| |**selementid1**<br>(required)|string|ID of the first map element linked on one end.| |**selementid2**<br>(required)|string|ID of the first map element linked on the other end.| |color|string|Line color as a hexadecimal color code.<br><br>Default: `000000`.| |drawtype|integer|Link line draw style.<br><br>Possible values:<br>0 - *(default)* line;<br>2 - bold line;<br>3 - dotted line;<br>4 - dashed line.| |label|string|Link label.| |linktriggers|array|Map link triggers to use as link status indicators.<br><br>The map link trigger object is [described in detail below](object#map_link_trigger).| |permission|integer|Type of permission level.<br><br>Possible values:<br>-1 - none;<br>2 - read only;<br>3 - read-write.| |sysmapid|string|ID of the map the link belongs to.| ### Map link Map link オブジェクトは2つのマップ要素間のリンクを定義します。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |linkid|string|*(読取専用)* マップ リンクの ID| |**selementid1**<br>(必須)|string|一方の端にリンクされている最初のマップ要素の ID| |**selementid2**<br>(必須)|string|もう一方の端にリンクされている最初のマップ要素の ID| |color|string|ラインの色を 16 進数のカラーコードで表します<br><br>デフォルト: `000000`| |drawtype|integer|リンク線の描画スタイル<br><br>有効な値:<br>0 - *(デフォルト)* 線<br>2 - 太線<br>3 - 点線<br>4 - 破線| |label|string|リンクラベル| |linktriggers|array|リンク ステータス インジケーターとして使用するマップ リンク トリガー<br><br>マップ リンク トリガー オブジェクトについては、[以下で詳しく説明](object#map_link_trigger)します。| |permission|integer|権限レベル<br><br>有効な値:<br>-1 - 無し<br>2 - 読取専用<br>3 - 読取/書込| |sysmapid|string|リンクが属する地図の ID。| #### Map listing {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the map. Click on the name to [view](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps) the map.| |*Width*|Map width is displayed.| |*Height*|Map height is displayed.| |*Actions*|Two actions are available:<br>**Properties** - edit general map [properties](/manual/config/visualization/maps/map#creating_a_map)<br>**Constructor** - access the grid for adding [map elements](/manual/config/visualization/maps/map#adding_elements)| To [configure](/manual/config/visualization/maps/map#creating_a_map) a new map, click on the *Create map* button in the top right-hand corner. To import a map from a YAML, XML, or JSON file, click on the *Import* button in the top right-hand corner. The user who imports the map will be set as its owner. Two buttons below the list offer some mass-editing options: - *Export* - export the maps to a YAML, XML, or JSON file - *Delete* - delete the maps To use these options, mark the checkboxes before the respective maps, then click on the required button. #### マップリスト {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|マップの名前。 名前をクリックして、マップを[表示](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps)します。| |*幅*|マップの表示幅| |*高さ*|マップの表示高| |*アクション*|次の2つのアクションを使用できます。<br>**プロパティ** - 一般的なマップの[プロパティ](/manual/config/visualization/maps/map#creating_a_map)編集<br>**変更** - [マップ 要素](/manual/config/visualization/maps/map#adding_elements)グリッドにアクセス| 新しいマップを[設定](/manual/config/visualization/maps/map#creating_a_map)するには、右上隅にある*マップの作成*ボタンをクリックします。 YAML、XML、またはJSONファイルからマップをインポートするには、右上隅にある*インポート*ボタンをクリックします。 マップをインポートしたユーザーがその所有者として設定されます。 リストの下にある2つのボタンは、いくつかの一括編集オプションを提供します。 - *エクスポート* - マップをYAML,XML,JSONいずれかのファイルにエクスポートします - *削除* - マップを削除します これらのオプションを使用するには、マップの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mapping LLD macros Next you have to go to the LLD macros tab and make the following mappings: {#VOLUME}=$.labels['volume'] {#METRIC}=$['name'] {#HELP}=$['help'] ##### LLDマクロマッピング 次にLLDマクロ タブに移動して次のマッピングを行います。 {#VOLUME}=$.labels['volume'] {#METRIC}=$['name'] {#HELP}=$['help'] #### Maps Configure maps to create detailed dynamic representations of your IT infrastructure. [Map API](/manual/api/reference/map) #### マップ マップを設定して、IT インフラストラクチャの詳細な動的表示を作成します。 [Map API](/manual/api/reference/map) #### Map shapes Create a map with map name title. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "shapes": [ { "type": 0, "x": 0, "y": 0, "width": 600, "height": 11, "text": "{MAP.NAME}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` #### マップの形状 マップ名titleでマップを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "shapes": [ { "type": 0, "x": 0, "y": 0, "width": 600, "height": 11, "text": "{MAP.NAME}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` ### Map shapes The map shape object defines an geometric shape (with or without text) displayed on a map. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmap\_shapeid|string|*(readonly)* ID of the map shape element.| |**type** (required)|integer|Type of map shape element.<br><br>Possible values:<br>0 - rectangle;<br>1 - ellipse.<br><br>Property is required when new shapes are created.| |x|integer|X-coordinates of the shape in pixels.<br><br>Default: 0.| |y|integer|Y-coordinates of the shape in pixels.<br><br>Default: 0.| |width|integer|Width of the shape in pixels.<br><br>Default: 200.| |height|integer|Height of the shape in pixels.<br><br>Default: 200.| |text|string|Text of the shape.| |font|integer|Font of the text within shape.<br><br>Possible values:<br>0 - Georgia, serif<br>1 - “Palatino Linotype”, “Book Antiqua”, Palatino, serif<br>2 - “Times New Roman”, Times, serif<br>3 - Arial, Helvetica, sans-serif<br>4 - “Arial Black”, Gadget, sans-serif<br>5 - “Comic Sans MS”, cursive, sans-serif<br>6 - Impact, Charcoal, sans-serif<br>7 - “Lucida Sans Unicode”, “Lucida Grande”, sans-serif<br>8 - Tahoma, Geneva, sans-serif<br>9 - “Trebuchet MS”, Helvetica, sans-serif<br>10 - Verdana, Geneva, sans-serif<br>11 - “Courier New”, Courier, monospace<br>12 - “Lucida Console”, Monaco, monospace<br><br>Default: 9.| |font\_size|integer|Font size in pixels.<br><br>Default: 11.| |font\_color|string|Font color.<br><br>Default: '000000'.| |text\_halign|integer|Horizontal alignment of text.<br><br>Possible values:<br>0 - center;<br>1 - left;<br>2 - right.<br><br>Default: 0.| |text\_valign|integer|Vertical alignment of text.<br><br>Possible values:<br>0 - middle;<br>1 - top;<br>2 - bottom.<br><br>Default: 0.| |border\_type|integer|Type of the border.<br><br>Possible values:<br>0 - none;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Default: 0.| |border\_width|integer|Width of the border in pixels.<br><br>Default: 0.| |border\_color|string|Border color.<br><br>Default: '000000'.| |background\_color|string|Background color (fill color).<br><br>Default: `(empty)`.| |zindex|integer|Value used to order all shapes and lines (z-index).<br><br>Default: 0.| ### Map shapes Map shapes オブジェクトは、マップ上に表示される幾何学的形状 (テキストの有無にかかわらず) を定義します。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |sysmap\_shapeid|string|*(読取専用)* マップ シェイプ エレメントのID| |**type** (必須)|integer|マップ シェイプ エレメントのタイプ<br><br>有効な値:<br>0 - 長方形<br>1 - 楕円形<br><br>新しいシェイプを作成する場合はプロパティが必要です。| |x|integer|シェイプの X 座標 (ピクセル単位)<br><br>デフォルト: 0| |y|integer|シェイプの Y 座標 (ピクセル単位)<br><br>デフォルト: 0| |width|integer|シェイプの幅 (ピクセル単位)<br><br>デフォルト: 200| |height|integer|シェイプの高さ (ピクセル単位)<br><br>デフォルト: 200| |text|string|シェイプのテキスト| |font|integer|シェイプ内のテキストのフォント<br><br>有効な値:<br>0 - Georgia, serif<br>1 - “Palatino Linotype”, “Book Antiqua”, Palatino, serif<br>2 - “Times New Roman”, Times, serif<br>3 - Arial, Helvetica, sans-serif<br>4 - “Arial Black”, Gadget, sans-serif<br>5 - “Comic Sans MS”, cursive, sans-serif<br>6 - Impact, Charcoal, sans-serif<br>7 - “Lucida Sans Unicode”, “Lucida Grande”, sans-serif<br>8 - Tahoma, Geneva, sans-serif<br>9 - “Trebuchet MS”, Helvetica, sans-serif<br>10 - Verdana, Geneva, sans-serif<br>11 - “Courier New”, Courier, monospace<br>12 - “Lucida Console”, Monaco, monospace<br><br>デフォルト: 9| |font\_size|integer|ピクセル単位のフォント サイズ<br><br>デフォルト: 11| |font\_color|string|フォントカラー<br><br>デフォルト: '000000'| |text\_halign|integer|テキストの水平方向配置<br><br>有効な値:<br>0 - 中央<br>1 - 左<br>2 - 右<br><br>デフォルト: 0| |text\_valign|integer|テキストの垂直方向配置<br><br>有効な値:<br>0 - 中央<br>1 - 上<br>2 - 下<br><br>デフォルト: 0| |border\_type|integer|ボーダータイプ<br><br>可能な値:<br>0 - 無し<br>1 - `—————`<br>2 - `·····`<br>3 - `- - -`<br><br>デフォルト: 0| |border\_width|integer|ボーダーの幅 (ピクセル単位)<br><br>デフォルト: 0| |border\_color|string|ボーダーカラー<br><br>デフォルト: '000000'| |background\_color|string|背景色 (塗りつぶし)<br><br>デフォルト: `(空)`| |zindex|integer|すべての形状と線の順序付けに使用される値 (z-index)<br><br>デフォルト: 0| #### Map sharing Create a map with two types of sharing (user and user group). Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map sharing", "width": 600, "height": 600, "users": [ { "userid": "4", "permission": "3" } ], "userGroups": [ { "usrgrpid": "7", "permission": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### 地図の共有 2種類の共有（ユーザーとユーザーグループ）マップを作成します。 Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map sharing", "width": 600, "height": 600, "users": [ { "userid": "4", "permission": "3" } ], "userGroups": [ { "usrgrpid": "7", "permission": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` ### Map The map object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapid|string|*(readonly)* ID of the map.| |**height**<br>(required)|integer|Height of the map in pixels.| |**name**<br>(required)|string|Name of the map.| |**width**<br>(required)|integer|Width of the map in pixels.| |backgroundid|string|ID of the image used as the background for the map.| |expand\_macros|integer|Whether to expand macros in labels when configuring the map.<br><br>Possible values:<br>0 - *(default)* do not expand macros;<br>1 - expand macros.| |expandproblem|integer|Whether the problem trigger will be displayed for elements with a single problem.<br><br>Possible values:<br>0 - always display the number of problems;<br>1 - *(default)* display the problem trigger if there's only one problem.| |grid\_align|integer|Whether to enable grid aligning.<br><br>Possible values:<br>0 - disable grid aligning;<br>1 - *(default)* enable grid aligning.| |grid\_show|integer|Whether to show the grid on the map.<br><br>Possible values:<br>0 - do not show the grid;<br>1 - *(default)* show the grid.| |grid\_size|integer|Size of the map grid in pixels.<br><br>Supported values: 20, 40, 50, 75 and 100.<br><br>Default: 50.| |highlight|integer|Whether icon highlighting is enabled.<br><br>Possible values:<br>0 - highlighting disabled;<br>1 - *(default)* highlighting enabled.| |iconmapid|string|ID of the icon map used on the map.| |label\_format|integer|Whether to enable advanced labels.<br><br>Possible values:<br>0 - *(default)* disable advanced labels;<br>1 - enable advanced labels.| |label\_location|integer|Location of the map element label.<br><br>Possible values:<br>0 - *(default)* bottom;<br>1 - left;<br>2 - right;<br>3 - top.| |label\_string\_host|string|Custom label for host elements.<br><br>Required for maps with custom host label type.| |label\_string\_hostgroup|string|Custom label for host group elements.<br><br>Required for maps with custom host group label type.| |label\_string\_image|string|Custom label for image elements.<br><br>Required for maps with custom image label type.| |label\_string\_map|string|Custom label for map elements.<br><br>Required for maps with custom map label type.| |label\_string\_trigger|string|Custom label for trigger elements.<br><br>Required for maps with custom trigger label type.| |label\_type|integer|Map element label type.<br><br>Possible values:<br>0 - label;<br>1 - IP address;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing.| |label\_type\_host|integer|Label type for host elements.<br><br>Possible values:<br>0 - label;<br>1 - IP address;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_hostgroup|integer|Label type for host group elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_image|integer|Label type for host group elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>4 - nothing;<br>5 - custom.| |label\_type\_map|integer|Label type for map elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_trigger|integer|Label type for trigger elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |markelements|integer|Whether to highlight map elements that have recently changed their status.<br><br>Possible values:<br>0 - *(default)* do not highlight elements;<br>1 - highlight elements.| |severity\_min|integer|Minimum severity of the triggers that will be displayed on the map.<br><br>Refer to the [trigger "severity" property](/manual/api/reference/trigger/object#trigger) for a list of supported trigger severities.| |show\_unack|integer|How problems should be displayed.<br><br>Possible values:<br>0 - *(default)* display the count of all problems;<br>1 - display only the count of unacknowledged problems;<br>2 - display the count of acknowledged and unacknowledged problems separately.| |userid|string|Map owner user ID.| |private|integer|Type of map sharing.<br><br>Possible values:<br>0 - public map;<br>1 - *(default)* private map.| |show\_suppressed|integer|Whether suppressed problems are shown.<br><br>Possible values:<br>0 - *(default)* hide suppressed problems;<br>1 - show suppressed problems.| ### Map Map オブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |sysmapid|string|*(読取専用)* マップのID| |**height**<br>(必須)|integer|マップの高さ(ピクセル)| |**name**<br>(必須)|string|マップの名前| |**width**<br>(必須)|integer|マップの横幅(ピクセル)| |backgroundid|string|マップの背景として使用される画像の ID| |expand\_macros|integer|マップの構成時にラベルのマクロを展開するかどうか<br><br>有効な値:<br>0 - *(デフォルト)* 展開しない<br>1 - 展開する| |expandproblem|integer|1 つの障害がある要素に対して障害のトリガーを表示するかどうか<br><br>有効な値:<br>0 - 常に問題の数を表示する<br><br>1 - *(デフォルト)* 障害が1つしかない場合は障害のトリガーを表示します| |grid\_align|integer|グリッド配置<br><br>有効な値:<br>0 - 無効<br>1 - *(デフォルト)* 有効| |grid\_show|integer|地図上のグリッド表示<br><br>有効な値:<br>0 - 表示しない<br>1 - *(デフォルト)* 表示する| |grid\_size|integer|地図上のグリッドピクセルサイズ<br><br>有効な値:20,40,50,75,100<br><br>デフォルト: 50| |highlight|integer|アイコンの強調表示<br><br>有効な値:<br>0 - しない<br>1 - *(デフォルト)* する| |iconmapid|string|マップで使用されるアイコン マップの ID| |label\_format|integer|高度なラベルの有効化<br><br>有効な値:<br>0 - *(デフォルト)* 無効<br>1 - 有効| |label\_location|integer|マップエレメントラベルの位置<br><br>有効な値:<br>0 - *(デフォルト)* 下<br>1 - 左<br>2 - 右<br>3 - 上| |label\_string\_host|string|ホスト要素のカスタムラベル<br><br>カスタムホストラベルタイプのマップでは必須| |label\_string\_hostgroup|string|ホストグループ要素のカスタムラベル<br><br>カスタムホストグループラベルタイプのマップでは必須| |label\_string\_image|string|画像要素のカスタム ラベル<br><br>カスタム画像ラベルタイプの地図では必須| |label\_string\_map|string|マップ要素のカスタムラベル<br><br>カスタムマップラベルタイプのマップでは必須| |label\_string\_trigger|string|トリガー要素のカスタム ラベル<br><br>カスタムトリガーラベルタイプのマップでは必須| |label\_type|integer|マップ要素のラベルタイプ<br><br>有効な値:<br>0 - ラベル<br>1 - IP アドレス<br>2 - *(デフォルト)* 要素名<br>3 - ステータスのみ<br>4 - 無し| |label\_type\_host|integer|ホスト要素のラベルタイプ<br><br>有効な値:<br>0 - ラベル<br>1 - IP アドレス<br>2 - *(デフォルト)* 要素名<br>3 - ステータスのみ <br>4 - 無し<br>5 - カスタム| |label\_type\_hostgroup|integer|ホストグループ要素のラベルタイプ<br><br>有効な値:<br>0 - ラベル<br>2 - *(デフォルト)* 要素名<br>3 - ステータスのみ<br>4 - 無し<br>5 - カスタム| |label\_type\_image|integer|ホストグループ要素のラベルタイプ<br><br>有効な値:<br>0 - ラベル<br>2 - *(デフォルト)* 要素名<br>4 - 無し<br>5 - カスタム| |label\_type\_map|integer|マップ要素のラベル タイプ<br><br>有効な値:<br>0 - ラベル<br>2 - *(デフォルト)* 要素名<br>3 - ステータスのみ<br>4 - なし<br>4 - 無し<br>5 - カスタム| |label\_type\_trigger|integer|トリガー要素のラベル タイプ<br><br>有効な値:<br>0 - ラベル<br>2 - *(デフォルト)* 要素名<br>3 - ステータスのみ<br>4 - 無し<br>5 - カスタム| |markelements|integer|最近ステータスが変更されたマップ要素の強調表示<br><br>有効な値:<br>0 - *(デフォルト)* 強調表示しない<br>1 - 要素を強調表示する| |severity\_min|integer|マップに表示されるトリガーの最小深刻度<br><br>サポートされているトリガー深刻度のリストについては、[トリガーの"深刻度"プロパティ](/manual/api/reference/trigger/object#trigger)を参照してください| |show\_unack|integer|障害の表示方法<br><br>有効な値:<br>0 - *(デフォルト)* すべての障害数を表示<br>1 - 未確認の障害数のみ表示<br>2 - 確認済みの障害数と未確認の障害数を別々に表示| |userid|string|マップ所有者のユーザー ID| |private|integer|マップの共有<br><br>有効な値:<br>0 - 公開<br>1 - *(デフォルト)* 非公開| |show\_suppressed|integer|抑制された障害の表示<br><br>有効な値:<br>0 - *(デフォルト)* 非表示<br>1 - 表示| # map.update # map.update ### Map URL The map URL object defines a clickable link that will be available for all elements of a specific type on the map. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapurlid|string|*(readonly)* ID of the map URL.| |**name**<br>(required)|string|Link caption.| |**url**<br>(required)|string|Link URL.| |elementtype|integer|Type of map element for which the URL will be available.<br><br>Refer to the [map element "type" property](object#map_element) for a list of supported types.<br><br>Default: 0.| |sysmapid|string|ID of the map that the URL belongs to.| ### Map URL The map URL オブジェクトはマップ上の特定タイプすべての要素で使用できるクリック可能なリンクを定義します。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |sysmapurlid|string|*(読取専用)* MapURLのID| |**name**<br>(必須)|string|リンクキャプション| |**url**<br>(必須)|string|リンクURL| |elementtype|integer|URL を使用できる地図要素のタイプ<br><br>サポートされているタイプのリストについては、[地図要素の"type"プロパティ](object#map_element) を参照してください。<br><br>デフォルト: 0 | |sysmapid|string|URL が属するマップの ID| ### Map user group List of map permissions based on user groups. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapusrgrpid|string|*(readonly)* ID of the map user group.| |**usrgrpid**<br>(required)|string|User group ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### Map user group ユーザー グループに基づくマップ権限のリスト。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |sysmapusrgrpid|string|*(読取専用)* マップユーザーグループのID| |**usrgrpid**<br>(必須)|string|ユーザーグループID| |**permission**<br>(必須)|integer|権限レベル<br><br>有効な値:<br>2 - 読取専用<br>3 - 読書可能| ### Map user List of map permissions based on users. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapuserid|string|*(readonly)* ID of the map user.| |**userid**<br>(required)|string|User ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### Map user ユーザーに基づくマップ権限のリスト。 次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |sysmapuserid|string|*(読取専用)* マップユーザーのID| |**userid**<br>(必須)|string|ユーザーID| |**permission**<br>(必須)|integer|権限レベル<br><br>有効な値:<br>2 - 読取専用<br>3 - 読書可能| ### MariaDB 10.10 support The maximum supported version for MariaDB is now 10.10.X. ### MariaDB 10.10をサポート MariaDBの最大サポートバージョンは10.10.Xになりました。 ### MariaDB 10.11 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 10.11.X. ### MariaDB 10.11をサポート MariaDBの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は10.11.Xになりました。 ### MariaDB 10.7 support The maximum supported version for MariaDB is now 10.7.X. ### MariaDB 10.7をサポート MariaDBの最大サポートバージョンは10.7.Xになりました。 ### MariaDB 10.8 support The maximum supported version for MariaDB is now 10.8.X. ### MariaDB 10.8をサポート MariaDBの最大サポートバージョンは10.8.Xになりました。 #### MariaDB 11.0 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.0.X. #### MariaDB 11.0をサポート MariaDBの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は11.0.Xになりました。 #### MariaDB 11.2 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.2.X. #### MariaDB 11.2をサポート MariaDBの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は11.2.Xになりました。 #### MariaDB 11.3 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.3.X. #### MariaDB 11.3をサポート MariaDBの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は11.3.Xになりました。 #### MariaDB 11.4 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.4.X. #### MariaDB 11.4をサポート MariaDBの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は11.4.Xになりました。 #### MariaDB 11.5 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.5.X. #### MariaDB 11.5をサポート MariaDBの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は11.5.Xになりました。 #### MariaDB 12.0 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 12.0.X. #### MariaDB 12.0をサポート MariaDBの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は12.0.Xになりました。 ##### Mass editing options A button below the list offers one mass-editing option: - *Delete* - delete the maintenance periods To use this option, mark the checkboxes before the respective maintenance periods and click on *Delete*. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *削除* - メンテナンス期間を削除します これらのオプションを使用するには、それぞれのメンテナンス期間の先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options A button below the list offers one mass-editing option: - *Delete* - delete the scripts To use this option, mark the checkboxes before the respective scripts and click on *Delete*. ##### 一括編集オプション リストの下にあるボタンは、1つの一括編集オプションを提供します。 - *削除* - スクリプトを削除します このオプションを使用するには、それぞれのスクリプトの前にあるチェックボックスをオンにして、*削除*をクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Copy* - copy the graphs to other hosts or templates - *Delete* - delete the graphs To use these options, mark the checkboxes before the respective graphs, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *コピー* - グラフを他のホストまたはテンプレートにコピーします - *削除* - グラフの削除 これらのオプションを使用するには、それぞれのグラフ先頭のチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Copy* - copy the graphs to other hosts or templates - *Delete* - delete the graphs To use these options, mark the checkboxes before the respective graphs, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *コピー* - グラフを他のホストまたはテンプレートにコピーします - *削除* - グラフの削除 これらのオプションを使用するには、それぞれのグラフ先頭のチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these hosts as *Enabled* - *Create disabled* - create these hosts as *Disabled* - *Delete* - delete these host prototypes To use these options, mark the checkboxes before the respective host prototypes, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *自動生成時のステータス有効* - ホストを*有効*として作成します - *自動生成無効* - ホストを*無効*として作成します - *削除* - プロトタイプホストを削除する これらのオプションを使用するには、プロトタイプホストの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these hosts as *Enabled* - *Create disabled* - create these hosts as *Disabled* - *Delete* - delete these host prototypes To use these options, mark the checkboxes before the respective host prototypes, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *自動生成時のステータス有効* - ホストを*有効*として作成します - *自動生成無効* - ホストを*無効*として作成します - *削除* - プロトタイプホストを削除する これらのオプションを使用するには、プロトタイプホストの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these items as *Enabled* - *Create disabled* - create these items as *Disabled* - *Mass update* - mass update these item prototypes - *Delete* - delete these item prototypes To use these options, mark the checkboxes before the respective item prototypes, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *自動生成時のステータス有効* - アイテムを*有効*として作成します - *自動生成無効* - アイテムを*無効*として作成します - *一括更新* - プロトタイプアイテムを一括更新します - *削除* - プロトタイプアイテムを削除する これらのオプションを使用するには、プロトタイプアイテムの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these items as *Enabled* - *Create disabled* - create these items as *Disabled* - *Mass update* - mass update these item prototypes - *Delete* - delete these item prototypes To use these options, mark the checkboxes before the respective item prototypes, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *自動生成時のステータス有効* - アイテムを*有効*として作成します - *自動生成無効* - アイテムを*無効*として作成します - *一括更新* - プロトタイプアイテムを一括更新します - *削除* - プロトタイプアイテムを削除する これらのオプションを使用するには、プロトタイプアイテムの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these triggers as *Enabled* - *Create disabled* - create these triggers as *Disabled* - *Mass update* - mass update these trigger prototypes - *Delete* - delete these trigger prototypes To use these options, mark the checkboxes before the respective trigger prototypes, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *自動生成時のステータス有効* - トリガーを*有効*として作成します - *自動生成無効* - トリガーを*無効*として作成します - *一括更新* - プロトタイプトリガーを一括更新します - *削除* - プロトタイプトリガーを削除する これらのオプションを使用するには、プロトタイプトリガーの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these triggers as *Enabled* - *Create disabled* - create these triggers as *Disabled* - *Mass update* - mass update these trigger prototypes - *Delete* - delete these trigger prototypes To use these options, mark the checkboxes before the respective trigger prototypes, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *自動生成時のステータス有効* - トリガーを*有効*として作成します - *自動生成無効* - トリガーを*無効*として作成します - *一括更新* - プロトタイプトリガーを一括更新します - *削除* - プロトタイプトリガーを削除する これらのオプションを使用するには、プロトタイプトリガーの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Delete* - delete these graph prototypes To use these options, mark the checkboxes before the respective graph prototypes, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *削除* - プロトタイプグラフを削除する これらのオプションを使用するには、プロトタイプグラフの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Delete* - delete these graph prototypes To use these options, mark the checkboxes before the respective graph prototypes, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *削除* - プロトタイプグラフを削除する これらのオプションを使用するには、プロトタイプグラフの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change host status to *Monitored* - *Disable* - change host status to *Not monitored* - *Export* - export the hosts to a YAML, XML or JSON file - *Mass update* - [update several properties](/manual/config/hosts/hostupdate) for a number of hosts at once - *Delete* - delete the hosts To use these options, mark the checkboxes before the respective hosts, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *有効* - ホストのステータスを*有効*に変更します - *無効* - ホストのステータスを*無効*に変更します - *エクスポート* - ホストをYAML、XML、またはJSONファイルにエクスポートします - *一括更新* - 複数ホストの[複数のプロパティ一括更新](/manual/config/hosts/hostupdate) - *削除* - ホストを削除します これらのオプションを使用するには、ホスト名先頭のチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change item status to *Enabled*. - *Disable* - change item status to *Disabled*. - *Copy* - copy the items to other hosts or templates. - *Mass update* - [update several properties](/manual/config/items/itemupdate) for a number of items at once. - *Delete* - delete the items. To use these options, mark the checkboxes before the respective items, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *有効* - アイテムのステータスを*有効*にします - *無効* - アイテムのステータスを*無効*にします - *コピー* - アイテムを他のホストまたはテンプレートにコピーします - *一括更新* - 一度に複数のアイテムの[複数のプロパティを更新](/manual/config/items/itemupdate) - *削除* - アイテムを削除します これらのオプションを使用するには、それぞれの項目の先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the action status to *Enabled* - *Disable* - change the action status to *Disabled* - *Delete* - delete the actions To use these options, mark the checkboxes before the respective actions, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *有効* - アクションステータスを*有効*に変更します - *無効* - アクションステータスを*無効*に変更します - *削除* - アクションを削除します これらのオプションを使用するには、それぞれのアクションの前あるにチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the correlation rule status to *Enabled* - *Disable* - change the correlation rule status to *Disabled* - *Delete* - delete the correlation rules To use these options, mark the checkboxes before the respective correlation rules, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *有効* - 相関関係のステータスを*有効*に変更します - *無効* - 相関関係のステータスを*無効*に変更します - *削除* - 相関関係を削除します これらのオプションを使用するには、それぞれの相関ルールの前にチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the discovery rule status to *Enabled* - *Disable* - change the discovery rule status to *Disabled* - *Delete* - delete the discovery rules To use these options, mark the checkboxes before the respective discovery rules, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *有効* - ディスカバリルールのステータスを*有効*にします - *無効* - ディスカバリルールのステータスを*無効*にします - *削除* - ディスカバリルールを削除します これらのオプションを使用するには、それぞれのディスカバリルールの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the low-level discovery rule status to *Enabled* - *Disable* - change the low-level discovery rule status to *Disabled* - *Delete* - delete the low-level discovery rules To use these options, mark the checkboxes before the respective discovery rules, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *有効* - 低レベルのディスカバリルールのステータスを*有効*に変更します - *無効* - 低レベルのディスカバリルールのステータスを*無効*に変更します - *削除* - 低レベルのディスカバリルールを削除します これらのオプションを使用するには、ディスカバリルール先頭のチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the media type status to *Enabled* - *Disable* - change the media type status to *Disabled* - *Export* - export the media types to a YAML, XML or JSON file - *Delete* - delete the media types To use these options, mark the checkboxes before the respective media types, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *有効* - メディアタイプのステータスを*Enabled*に変更します - *無効* - メディアタイプのステータスを*Disabled*に変更します - *エクスポート* - メディアタイプをYAML, XML または JSON ファイルとしてエクスポートします - *削除* - メディアタイプを削除します これらのオプションを使用するには、それぞれのメディアタイプの前のチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the scenario status to *Enabled* - *Disable* - change the scenario status to *Disabled* - *Delete* - delete the web scenarios To use these options, mark the checkboxes before the respective web scenarios, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *有効* - シナリオのステータスを*有効*にします - *無効* - シナリオのステータスを*無効*にします - *削除* - Webシナリオを削除します これらのオプションを使用するには、Webシナリオ先頭のチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the user group status to *Enabled* - *Disable* - change the user group status to *Disabled* - *Enable debug mode* - enable debug mode for the user groups - *Disable debug mode* - disable debug mode for the user groups - *Delete* - delete the user groups To use these options, mark the checkboxes before the respective user groups, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *有効* - ユーザーグループのステータスを有効に - *無効* - ユーザーグループのステータスを無効に - *デバッグモードを有効* - ユーザーグループのデバッグモードを有効に - *デバッグモードを無効* - ユーザーグループのデバッグモードを無効に - *削除* - ユーザーグループを削除 これらのオプションを使用するには、それぞれのユーザーグループの前にチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change trigger status to *Enabled* - *Disable* - change trigger status to *Disabled* - *Copy* - copy the triggers to other hosts or templates - *Mass update* - update several properties for a number of triggers at once - *Delete* - delete the triggers To use these options, mark the checkboxes before the respective triggers, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *有効* - トリガーのステータスを*有効*に - *無効* - トリガーのステータスを*無効*に - *コピー* - トリガーを他のホストまたはテンプレートにコピーします - *一括更新* - 一度に複数のトリガーのいくつかのプロパティを更新します - *削除* - トリガーの削除 これらのオプションを使用するには、トリガーの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change trigger status to *Enabled*. - *Disable* - change trigger status to *Disabled*. - *Copy* - copy the triggers to other hosts or templates. - *Mass update* - update several properties for a number of triggers at once. - *Delete* - delete the triggers. To use these options, mark the checkboxes before the respective triggers, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *有効* - トリガーのステータスを*有効*に - *無効* - トリガーのステータスを*無効*に - *コピー* - トリガーを他のホストまたはテンプレートにコピーします - *一括更新* - 一度に複数のトリガーのいくつかのプロパティを更新します - *削除* - トリガーの削除 これらのオプションを使用するには、トリガーの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable hosts* - change the status of all hosts in the group to "Monitored" - *Disable hosts* - change the status of all hosts in the group to "Not monitored" - *Delete* - delete the host groups To use these options, mark the checkboxes before the respective host groups, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *ホストを有効* - グループに所属するホストのステータスを*監視対象*にします - *ホストを無効* - グループに所属するホストのステータスを*監視対象外*にします - *削除* - ホストグループをを削除します これらのオプションを使用するには、それぞれのホストグループの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable hosts* - change the status of hosts monitored by the proxy to *Monitored* - *Disable hosts* - change the status of hosts monitored by the proxy to *Not monitored* - *Delete* - delete the proxies To use these options, mark the checkboxes before the respective proxies, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *ホストを有効* - プロキシによって監視されているホストのステータスを*監視対象*に変更します - *ホストを無効* - プロキシによって監視されているホストのステータスを*監視対象外*に変更します - *削除* - プロキシを削除します これらのオプションを使用するには、それぞれのプロキシの先頭にあるチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Export* - export the template to a YAML, XML or JSON file - *Mass update* - [update several properties](/manual/config/templates/mass) for a number of templates at once - *Delete* - delete the template while leaving its linked entities (items, triggers etc.) with the hosts - *Delete and clear* - delete the template and its linked entities from the hosts To use these options, mark the checkboxes before the respective templates, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *エクスポート* - テンプレートをYAML、XML、またはJSONファイルにエクスポートします - *一括更新* - 一度に複数のテンプレートの[いくつかのプロパティ](/manual/config/templates/mass)を更新します - *削除* - リンクされたエンティティ（アイテム、トリガーなど）をホストに残したまま、テンプレートを削除します - *削除とクリア* - テンプレートとそのリンクされたエンティティをホストから削除します これらのオプションを使用するには、それぞれのテンプレートの前にあるチェックボックスをチェックしてから、必要なボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Mass update* - update the selected problems by navigating to the [problem update](/manual/acknowledges#updating_problems) screen To use this option, mark the checkboxes before the respective problems, then click on the *Mass update* button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *一括更新* - [障害の更新](/manual/acknowledges#updating_problems)画面に移動して、選択した障害を更新します このオプションを使用するには、それぞれの障害の前あるにチェックボックスをオンにしてから*一括更新*ボタンをクリックします。 ##### Mass editing options Buttons below the list offer some mass-editing options: - *Unblock* - re-enable system access to blocked users - *Delete* - delete the users To use these options, mark the check-boxes before the respective users, then click on the required button. ##### 一括編集オプション リストの下のボタンは、いくつかの一括編集オプションを提供します。 - *ブロックを解除* - ブロックされたユーザーのシステムアクセスを再度有効にします - *削除* - ユーザーを削除します これらのオプションを使用するには、それぞれのユーザーの前にチェックボックスをオンにしてから、必要なボタンをクリックします。 ##### Master item Create an IPMI item using the following key: ipmi.get  Set the type of information to "Text" for possibly big JSON data. ##### マスターアイテム 次のキーを使用してIPMIアイテムを作成します。 ipmi.get  JSONデータが大きくなる可能性がある場合は、データ型を"テキスト"に設定します。 ##### Master item Create a Zabbix agent item using the following key: vfs.fs.get  Set the type of information to "Text" for possibly big JSON data. The data returned by this item will contain something like the following for a mounted filesystem: ``` {.java} { "fsname": "/", "fstype": "rootfs", "bytes": { "total": 1000, "free": 500, "used": 500, "pfree": 50.00, "pused": 50.00 }, "inodes": { "total": 1000, "free": 500, "used": 500, "pfree": 50.00, "pused": 50.00 } } ``` ##### マスターアイテム 次のキーを使用してZabbixエージェントアイテムを作成します。 vfs.fs.get  JSONデータが大きくなる可能性がある場合は、データ型を"テキスト"に設定します。 このアイテムによって返されるデータ、マウントされたファイルシステムには、次のようなものが含まれます。 ``` {.java} { "fsname": "/", "fstype": "rootfs", "bytes": { "total": 1000, "free": 500, "used": 500, "pfree": 50.00, "pused": 50.00 }, "inodes": { "total": 1000, "free": 500, "used": 500, "pfree": 50.00, "pused": 50.00 } } ``` #### Maximum JSON depth The maximum allowed JSON depth has been set to 64 to improve security and performance during JSON parsing. #### JSONの最大深度 JSON解析時のセキュリティとパフォーマンスを向上させるため、JSONの最大許容深度は64に設定されています。 # mediatype.create # mediatype.create # mediatype.delete # mediatype.delete # mediatype.get # mediatype.get ### Media type The media type object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mediatypeid|string|*(readonly)* ID of the media type.| |**name**<br>(required)|string|Name of the media type.| |**type**<br>(required)|integer|Transport used by the media type.<br><br>Possible values:<br>0 - email;<br>1 - script;<br>2 - SMS;<br>4 - Webhook.| |exec\_path|string|For script media types `exec_path` contains the name of the executed script.<br><br>Required for script media types.| |gsm\_modem|string|Serial device name of the GSM modem.<br><br>Required for SMS media types.| |passwd|string|Authentication password.<br><br>Used for email media types.| |smtp\_email|string|Email address from which notifications will be sent.<br><br>Required for email media types.| |smtp\_helo|string|SMTP HELO.<br><br>Required for email media types.| |smtp\_server|string|SMTP server.<br><br>Required for email media types.| |smtp\_port|integer|SMTP server port to connect to.| |smtp\_security|integer|SMTP connection security level to use.<br><br>Possible values:<br>0 - None;<br>1 - STARTTLS;<br>2 - SSL/TLS.| |smtp\_verify\_host|integer|SSL verify host for SMTP.<br><br>Possible values:<br>0 - No;<br>1 - Yes.| |smtp\_verify\_peer|integer|SSL verify peer for SMTP.<br><br>Possible values:<br>0 - No;<br>1 - Yes.| |smtp\_authentication|integer|SMTP authentication method to use.<br><br>Possible values:<br>0 - None;<br>1 - Normal password.| |status|integer|Whether the media type is enabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |username|string|User name.<br><br>Used for email media types.| |exec\_params|string|Script parameters.<br><br>Each parameter ends with a new line feed.| |maxsessions|integer|The maximum number of alerts that can be processed in parallel.<br><br>Possible values for SMS:<br>1 - *(default)*<br><br>Possible values for other media types:<br>0-100| |maxattempts|integer|The maximum number of attempts to send an alert.<br><br>Possible values:<br>1-100<br><br>Default value:<br>3| |attempt\_interval|string|The interval between retry attempts. Accepts seconds and time unit with suffix.<br><br>Possible values:<br>0-1h<br><br>Default value:<br>10s| |content\_type|integer|Message format.<br><br>Possible values:<br>0 - plain text;<br>1 - *(default)* html.| |script|string|Media type webhook script javascript body.| |timeout|string|Media type webhook script timeout. Accepts seconds and time unit with suffix.<br><br>Possible values:<br>1-60s<br><br>Default value:<br>30s| |process\_tags|integer|Defines should the webhook script response to be interpreted as tags and these tags should be added to associated event.<br><br>Possible values:<br>0 - *(default)* Ignore webhook script response.<br>1 - Process webhook script response as tags.| |show\_event\_menu|integer|Show media type entry in `problem.get` and `event.get` property `urls`.<br><br>Possible values:<br>0 - *(default)* Do not add `urls` entry.<br>1 - Add media type to `urls` property.| |event\_menu\_url|string|Define `url` property of media type entry in `urls` property of `problem.get` and `event.get`.| |event\_menu\_name|string|Define `name` property of media type entry in `urls` property of `problem.get` and `event.get`.| |parameters|array|Array of [webhook input parameters](/manual/api/reference/mediatype/object#Webhook parameters).| |description|string|Media type description.| ### Media type media typeオブジェクトには次のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |mediatypeid|string|*(読取専用)*メディアタイプのID| |**name**<br>(必須)|string|メディアタイプ名| |**type**<br>(必須)|integer|メディアタイプで使用される送信方法。<br><br>可能な値:<br>0 - 電子メール<br>1 - スクリプト<br>2 - SMS<br>4 - Webhook| |exec\_path|string|スクリプトメディアタイプの場合`exec_path`には実行されたスクリプトの名前が含まれます。<br><br>スクリプトメディアタイプで使用されます| |gsm\_modem|string|GSMモデムのシリアルデバイス名。<br><br>SMSメディアタイプで使用されます| |passwd|string|認証パスワード<br><br>電子メールメディアタイプで使用されます| |smtp\_email|string|通知の送信元の電子メールアドレス。<br><br>電子メールメディアタイプで使用されます| |smtp\_helo|string|SMTP HELO.<br><br>電子メールメディアタイプで使用されます| |smtp\_server|string|SMTP サーバ<br><br>電子メールメディアタイプで使用されます| |smtp\_port|integer|SMTP サーバ接続ポート| |smtp\_security|integer|SMTP接続のセキュリティレベル。<br><br>利用可能な値:<br>0 - なし<br>1 - STARTTLS<br>2 - SSL/TLS| |smtp\_verify\_host|integer|SMTPのSSLホスト検証<br><br>利用可能な値:<br>0 - いいえ<br>1 - はい| |smtp\_verify\_peer|integer|SMTPのSSLピア検証<br><br>利用可能な値:<br>0 - いいえ<br>1 - はい| |smtp\_authentication|integer|SMTP認証方法<br><br>利用可能な値:<br>0 - なし<br>1 - 通常のパスワード| |status|integer|メディアタイプの有効無効<br><br>利用可能な値:<br>0 - *(デフォルト)*有効<br>1 - 無効| |username|string|ユーザー名<br><br>電子メールメディアタイプで使用されます。| |exec\_params|string|スクリプトパラメータ<br><br>各パラメータは改行で終わります| |maxsessions|integer|並行して処理できるアラートの最大数<br><br>SMSで利用可能な値:<br>1 - *(デフォルト)* <br><br>他のメディアタイプで利用可能な値:<br>0-100| |maxattempts|integer|アラート送信の最大試行回数<br><br>可能な値:<br>1-100<br><br>デフォルト値:<br>3| |attempt\_interval|string|再試行の間隔。 接尾辞付きの秒と時間の単位を受け入れます。<br><br>可能な値:<br>0-1h<br><br>デフォルト値:<br>10s| |content\_type|integer|メッセージフォーマット<br><br>可能な値:<br>0 - プレーンテキスト<br>1 - *(デフォルト)*html| |script|string|メディアタイプwebhookスクリプトjavascript本体| |timeout|string|メディアタイプのwebhookスクリプトのタイムアウト。 接尾辞付きの秒と時間の単位を受け入れます。<br><br>利用可能な値:<br>1-60s<br><br>デフォルト値:<br>30s| |process\_tags|integer|Webhookスクリプトの応答をタグとして解釈し、これらのタグを関連するイベントに追加する必要があるかどうかを定義します。<br><br>可能な値:<br>0 - *(デフォルト)*Webhookスクリプトの応答を無視します<br>1 - Webhookスクリプトの応答をタグとして処理します| |show\_event\_menu|integer|`problem.get`および`event.get`プロパティ`urls`にメディアタイプエントリを表示します。<br><br>利用可能な値:<br>0 - *(デフォルト)*`urls`エントリを追加しない<br >1 - メディアタイプを`urls`プロパティに追加する| |event\_menu\_url|string|メディアタイプエントリの`url`プロパティを`problem.get`と`event.get`の`urls`プロパティに定義します。| |event\_menu\_name|string|メディアタイプエントリの`name`プロパティを`problem.get`と`event.get`の`urls`プロパティに定義します。| |parameters|array|[webhook入力パラメーター](/manual/api/reference/mediatype/object#Webhook parameters)の配列| |description|string|メディアタイプの説明| # mediatype.update # mediatype.update #### Memory suffixes Memory size suffixes are supported in: - trigger [expression](/manual/config/triggers/expression) constants and function parameters - constants of [calculated item](/manual/config/items/itemtypes/calculated) formulas For memory size you can use: - **K** - kilobyte - **M** - megabyte - **G** - gigabyte - **T** - terabyte #### メモリのサフィックス メモリサイズのサフィックスは次で使用可能です。 - トリガー[式](/manual/config/triggers/expression)の定数と関数パラメーター - [計算項目](/manual/config/items/itemtypes/calculated)式の定数 メモリサイズのサフィックスは以下を使用できます。 - **K** - キロバイト - **M** - メガバイト - **G** - ギガバイト - **T** - テラバイト **Memory** Zabbix requires both physical and disk memory. The amount of required disk memory obviously depends on the number of hosts and parameters that are being monitored. If you're planning to keep a long history of monitored parameters, you should be thinking of at least a couple of gigabytes to have enough space to store the history in the database. Each Zabbix daemon process requires several connections to a database server. The amount of memory allocated for the connection depends on the configuration of the database engine. ::: noteclassic The more physical memory you have, the faster the database (and therefore Zabbix) works. ::: **メモリ** Zabbixには物理メモリとディスク容量の両方が必要です。必要なディスク容量は、監視対象のホストとパラメーターの数によって大きく異なります。監視対象パラメーターのヒストリを長期間保存することを計画している場合は、データベースにヒストリを保存するのに十分なスペースを確保するため、少なくとも数ギガバイトを検討する必要があります。各Zabbixデーモンプロセスには、データベースサーバーへの複数の接続が必要です。接続に割り当てられるメモリの量はデータベースエンジンの構成によって異なります。 ::: noteclassic 物理メモリが多ければ多いほど、データベース(したがってZabbix)の動作が速くなります。 ::: ### Message template The message template object defines a template that will be used as a default message for action operations to send a notification. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**eventsource**<br>(required)|integer|Event source.<br><br>Possible values:<br>0 - triggers;<br>1 - discovery;<br>2 - autoregistration;<br>3 - internal;<br>4 - services.| |**recovery**<br>(required)|integer|Operation mode.<br><br>Possible values:<br>0 - operations;<br>1 - recovery operations;<br>2 - update operations.| |subject|string|Message subject.| |message|string|Message text.| ### Message template message template オブジェクトは、通知を送信するためのアクション操作のデフォルトメッセージとして使用されるテンプレートを定義します。 以下のプロパティがあります。 |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**eventsource**<br>(必須)|integer|イベントソース<br><br>利用可能な値:<br>0 - トリガー<br>1 - ディスカバリ<br>2 - 自動登録<br>3 - インターナル<br>4 - サービス| |**recovery**<br>(必須)|integer|オペレーションモード<br><br>可能な値:<br>0 - 操作<br>1 - 回復操作<br>2 - 更新操作| |subject|string|メッセージの件名| |message|string|メッセージテキスト| # Method reference This section provides an overview of the functions provided by the Zabbix API and will help you find your way around the available classes and methods. # メソッドリファレンス このセクションでは、Zabbix APIが提供する機能の概要を説明し、利用可能なクラスとメソッドの使い方を説明します。 #### Microsoft Entra ID configuration #### Microsoft Entra IDの設定 #### Migration with running server * Export current history, import it to the temp table, then insert the data into new tables while ignoring duplicates: ``` {.sql} \copy history_old TO '/tmp/history.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value DOUBLE PRECISION DEFAULT '0.0000' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history FROM '/tmp/history.csv' DELIMITER ',' CSV INSERT INTO history SELECT * FROM temp_history ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_uint_old TO '/tmp/history_uint.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_uint ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value numeric(20) DEFAULT '0' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_uint FROM '/tmp/history_uint.csv' DELIMITER ',' CSV INSERT INTO history_uint SELECT * FROM temp_history_uint ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_str_old TO '/tmp/history_str.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_str ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value varchar(255) DEFAULT '' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_str FROM '/tmp/history_str.csv' DELIMITER ',' CSV INSERT INTO history_str (itemid,clock,value,ns) SELECT * FROM temp_history_str ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_log_old TO '/tmp/history_log.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_log ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, timestamp integer DEFAULT '0' NOT NULL, source varchar(64) DEFAULT '' NOT NULL, severity integer DEFAULT '0' NOT NULL, value text DEFAULT '' NOT NULL, logeventid integer DEFAULT '0' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_log FROM '/tmp/history_log.csv' DELIMITER ',' CSV INSERT INTO history_log SELECT * FROM temp_history_log ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_text_old TO '/tmp/history_text.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_text ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value text DEFAULT '' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_text FROM '/tmp/history_text.csv' DELIMITER ',' CSV INSERT INTO history_text SELECT * FROM temp_history_text ON CONFLICT (itemid,clock,ns) DO NOTHING; ``` * Follow [post-migration instructions](#after-migration) to drop the old tables. #### 実行中のサーバーでの移行 * 現在の履歴をエクスポートして一時テーブルにインポートし、重複を無視してデータを新しいテーブルに挿入します。 ``` {.sql} \copy history_old TO '/tmp/history.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value DOUBLE PRECISION DEFAULT '0.0000' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history FROM '/tmp/history.csv' DELIMITER ',' CSV INSERT INTO history SELECT * FROM temp_history ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_uint_old TO '/tmp/history_uint.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_uint ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value numeric(20) DEFAULT '0' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_uint FROM '/tmp/history_uint.csv' DELIMITER ',' CSV INSERT INTO history_uint SELECT * FROM temp_history_uint ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_str_old TO '/tmp/history_str.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_str ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value varchar(255) DEFAULT '' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_str FROM '/tmp/history_str.csv' DELIMITER ',' CSV INSERT INTO history_str (itemid,clock,value,ns) SELECT * FROM temp_history_str ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_log_old TO '/tmp/history_log.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_log ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, timestamp integer DEFAULT '0' NOT NULL, source varchar(64) DEFAULT '' NOT NULL, severity integer DEFAULT '0' NOT NULL, value text DEFAULT '' NOT NULL, logeventid integer DEFAULT '0' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_log FROM '/tmp/history_log.csv' DELIMITER ',' CSV INSERT INTO history_log SELECT * FROM temp_history_log ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_text_old TO '/tmp/history_text.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_text ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value text DEFAULT '' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_text FROM '/tmp/history_text.csv' DELIMITER ',' CSV INSERT INTO history_text SELECT * FROM temp_history_text ON CONFLICT (itemid,clock,ns) DO NOTHING; ``` * [移行後の手順](#after-migration) に従って、古いテーブルを削除します。 ##### MikroTik - *MikroTik CCR1009-7G-1C-1S+ SNMP* - monitoring of MikroTik CCR1009-7G-1C-1S+ ethernet routers via SNMP; - *MikroTik CCR1009-7G-1C-1S+PC SNMP* - monitoring of MikroTik CCR1009-7G-1C-1S+PC ethernet routers via SNMP; - *MikroTik CCR1009-7G-1C-PC SNMP* - monitoring of MikroTik CCR1009-7G-1C-PC ethernet routers via SNMP; - *MikroTik CCR1016-12G SNMP* - monitoring of MikroTik CCR1016-12G ethernet routers via SNMP; - *MikroTik CCR1016-12S-1S+ SNMP* - monitoring of MikroTik CCR1016-12S-1S+ ethernet routers via SNMP; - *MikroTik CCR1036-12G-4S-EM SNMP* - monitoring of MikroTik CCR1036-12G-4S-EM ethernet routers via SNMP; - *MikroTik CCR1036-12G-4S SNMP* - monitoring of MikroTik CCR1036-12G-4S ethernet routers via SNMP; - *MikroTik CCR1036-8G-2S+ SNMP* - monitoring of MikroTik CCR1036-8G-2S+ ethernet routers via SNMP; - *MikroTik CCR1036-8G-2S+EM SNMP* - monitoring of MikroTik CCR1036-8G-2S+EM ethernet routers via SNMP; - *MikroTik CCR1072-1G-8S+ SNMP* - monitoring of MikroTik CCR1072-1G-8S+ ethernet routers via SNMP; - *MikroTik CCR2004-16G-2S+ SNMP* - monitoring of MikroTik CCR2004-16G-2S+ ethernet routers via SNMP; - *MikroTik CCR2004-1G-12S+2XS SNMP* - monitoring of MikroTik CCR2004-1G-12S+2XS ethernet routers via SNMP; - *MikroTik CRS106-1C-5S SNMP* - monitoring of MikroTik CRS106-1C-5S switches via SNMP; - *MikroTik CRS109-8G-1S-2HnD-IN SNMP* - monitoring of MikroTik CRS109-8G-1S-2HnD-IN switches via SNMP; - *MikroTik CRS112-8G-4S-IN SNMP* - monitoring of MikroTik CRS112-8G-4S-IN switches via SNMP; - *MikroTik CRS112-8P-4S-IN SNMP* - monitoring of MikroTik CRS112-8P-4S-IN switches via SNMP; - *MikroTik CRS125-24G-1S-2HnD-IN SNMP* - monitoring of MikroTik CRS125-24G-1S-2HnD-IN switches via SNMP; - *MikroTik CRS212-1G-10S-1S+IN SNMP* - monitoring of MikroTik CRS212-1G-10S-1S+IN switches via SNMP; - *MikroTik CRS305-1G-4S+IN SNMP* - monitoring of MikroTik CRS305-1G-4S+IN switches via SNMP; - *MikroTik CRS309-1G-8S+IN SNMP* - monitoring of MikroTik CRS309-1G-8S+IN switches via SNMP; - *MikroTik CRS312-4C+8XG-RM SNMP* - monitoring of MikroTik CRS312-4C+8XG-RM switches via SNMP; - *MikroTik CRS317-1G-16S+RM SNMP* - monitoring of MikroTik CRS317-1G-16S+RM switches via SNMP; - *MikroTik CRS326-24G-2S+IN SNMP* - monitoring of MikroTik CRS326-24G-2S+IN switches via SNMP; - *MikroTik CRS326-24G-2S+RM SNMP* - monitoring of MikroTik CRS326-24G-2S+RM switches via SNMP; - *MikroTik CRS326-24S+2Q+RM SNMP* - monitoring of MikroTik CRS326-24S+2Q+RM switches via SNMP; - *MikroTik CRS328-24P-4S+RM SNMP* - monitoring of MikroTik CRS328-24P-4S+RM switches via SNMP; - *MikroTik CRS328-4C-20S-4S+RM SNMP* - monitoring of MikroTik CRS328-4C-20S-4S+RM switches via SNMP; - *MikroTik CRS354-48G-4S+2Q+RM SNMP* - monitoring of MikroTik CRS354-48G-4S+2Q+RM switches via SNMP; - *MikroTik CRS354-48P-4S+2Q+RM SNMP* - monitoring of MikroTik CRS354-48P-4S+2Q+RM switches via SNMP; - *MikroTik CSS326-24G-2S+RM SNMP* - monitoring of MikroTik CSS326-24G-2S+RM switches via SNMP; - *MikroTik CSS610-8G-2S+IN SNMP* - monitoring of MikroTik CSS610-8G-2S+IN switches via SNMP; - *MikroTik FiberBox SNMP* - monitoring of MikroTik FiberBox switches via SNMP; - *MikroTik hEX lite SNMP* - monitoring of MikroTik hEX lite ethernet routers via SNMP; - *MikroTik hEX PoE lite SNMP* - monitoring of MikroTik hEX PoE lite ethernet routers via SNMP; - *MikroTik hEX PoE SNMP* - monitoring of MikroTik hEX PoE ethernet routers via SNMP; - *MikroTik hEX S SNMP* - monitoring of MikroTik hEX S ethernet routers via SNMP; - *MikroTik hEX SNMP* - monitoring of MikroTik hEX ethernet routers via SNMP; - *MikroTik netPower 15FR SNMP* - monitoring of MikroTik netPower 15FR switches via SNMP; - *MikroTik netPower 16P SNMP* - monitoring of MikroTik netPower 16P switches via SNMP; - *MikroTik netPower Lite 7R SNMP* - monitoring of MikroTik netPower Lite 7R switches via SNMP; - *MikroTik PowerBox Pro SNMP* - monitoring of MikroTik PowerBox Pro ethernet routers via SNMP; - *MikroTik PowerBox SNMP* - monitoring of MikroTik PowerBox ethernet routers via SNMP; - *MikroTik RB1100AHx4 Dude Edition SNMP* - monitoring of MikroTik RB1100AHx4 Dude Edition ethernet routers via SNMP; - *MikroTik RB1100AHx4 SNMP* - monitoring of MikroTik RB1100AHx4 ethernet routers via SNMP; - *MikroTik RB2011iL-IN SNMP* - monitoring of MikroTik RB2011iL-IN ethernet routers via SNMP; - *MikroTik RB2011iL-RM SNMP* - monitoring of MikroTik RB2011iL-RM ethernet routers via SNMP; - *MikroTik RB2011iLS-IN SNMP* - monitoring of MikroTik RB2011iLS-IN ethernet routers via SNMP; - *MikroTik RB2011UiAS-IN SNMP* - monitoring of MikroTik RB2011UiAS-IN ethernet routers via SNMP; - *MikroTik RB2011UiAS-RM SNMP* - monitoring of MikroTik RB2011UiAS-RM ethernet routers via SNMP; - *MikroTik RB260GS SNMP* - monitoring of MikroTik RB260GS switches via SNMP; - *MikroTik RB3011UiAS-RM SNMP* - monitoring of MikroTik RB3011UiAS-RM ethernet routers via SNMP; - *MikroTik RB4011iGS+RM SNMP* - monitoring of MikroTik RB4011iGS+RM ethernet routers via SNMP; - *MikroTik RB5009UG+S+IN SNMP* - monitoring of MikroTik RB5009UG+S+IN ethernet routers via SNMP; - *Mikrotik SNMP* - a generic template for monitoring MikroTik devices. You can get these templates: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note, that history of the deleted items will be lost). ### Frontend #### Mikrotik - *MikroTik \<device model> SNMP* - 53 new model-specific templates for monitoring various models of MikroTik ethernet routers and switches, see [full list](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/mikrotik); - *Mikrotik SNMP* - a generic template for monitoring MikroTik devices. #### Mikrotik - *MikroTik \<device model> SNMP* - MikroTik のイーサネットルーターとスイッチの様々なモデルを監視するための53の新しいモデル固有のテンプレートです。 [完全なリスト](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/mikrotik) を参照してください。 - *Mikrotik SNMP* - MikroTik デバイスを監視するための汎用テンプレートです。 ##### Mikrotik routers Use SNMP agent provided by Mikrotik. See <http://www.mikrotik.com> for more information. ##### Mikrotik ルーター Mikrotik が提供する SNMP エージェントを使用します。 詳細については、<http://www.mikrotik.com> を参照してください。 #### Minimum supported Go version The minimum supported Go version has been raised from 1.21 to 1.23. If you previously built Zabbix [agent 2](/manual/concepts/agent2), agent 2 [loadable plugins](/manual/extensions/plugins#loadable), or [web service](/manual/concepts/web_service) from source using a Go version older than 1.23, it is recommended to rebuild these components using a [supported Go version](/manual/installation/requirements#agent-2) to receive the latest security updates and bug fixes. Components built with an older Go version will continue to work, but [upgrading](/manual/installation/upgrade/sources#agent-upgrade-process) them will require a newer Go environment. #### Goの最小サポートバージョン Goの最小サポートバージョンが1.21から1.23 に引き上げられました。 Zabbix[エージェント2](/manual/concepts/agent2)、エージェント2[ロード可能プラグイン](/manual/extensions/plugins#loadable)、または[Webサービス](/manual/concepts/web_service)を、1.23より前のGoバージョンを使用してソースからビルドしていた場合は、最新のセキュリティ更新とバグ修正を受け取るために、これらのコンポーネントを[サポートされるGoバージョン](/manual/installation/requirements#agent-2)を使用して再ビルドすることをお勧めします。 古いGoバージョンでビルドされたコンポーネントは引き続き動作しますが、[アップグレード](/manual/installation/upgrade/sources#agent-upgrade-process)には新しいGo環境が必要になります。 ##### Minimum weekly disk space among clusters View the lowest disk space among clusters over a week. - add to the data set: hosts `cluster*`, key "Free disk space on /data" - select the aggregate function `min` and specify interval `1w` - a bar graph is displayed, where each bar represents the minimum disk space per week for each /data volume of the cluster ##### クラスタ間の最小週次ディスク容量 1 週間におけるクラスタ間の最小ディスク容量を表示します。 - データセットに追加します: ホスト `cluster*`, キー "Free disk space on /data" - 集約関数 `min` を選択し、間隔 `1w` を指定します。 - 棒グラフが表示され、各棒はクラスタの各 /data ボリュームの 1 週間あたりの最小ディスク容量を表します。 ## Miscellaneous ## その他 ##### Miscellaneous aspects of escalation behavior Let's consider what happens in different circumstances if an action contains several escalation steps. |Situation|Behavior| |---------|--------| |*The host in question goes into maintenance after the initial problem notification is sent*|Depending on the *Pause operations for suppressed problems* setting in action [configuration](/manual/config/notifications/action/operation#configuring_an_operation), all remaining escalation steps are executed either with a delay caused by the maintenance period or without delay. A maintenance period does not cancel operations.| |*The time period defined in the **Time period** action condition ends after the initial notification is sent*|All remaining escalation steps are executed. The *Time period* condition cannot stop operations; it has effect with regard to when actions are started/not started, not operations.| |*A problem starts during maintenance and continues (is not resolved) after maintenance ends*|Depending on the *Pause operations for suppressed problems* setting in action [configuration](/manual/config/notifications/action/operation#configuring_an_operation), all escalation steps are executed either from the moment maintenance ends or immediately.| |*A problem starts during a no-data maintenance and continues (is not resolved) after maintenance ends*|It must wait for the trigger to fire, before all escalation steps are executed.| |*Different escalations follow in close succession and overlap*|The execution of each new escalation supersedes the previous escalation, but for at least one escalation step that is always executed on the previous escalation. This behavior is relevant in actions upon events that are created with EVERY problem evaluation of the trigger.| |*During an escalation in progress (like a message being sent), based on any type of event:<br>- the action is disabled<br>Based on trigger event:<br>- the trigger is disabled<br>- the host or item is disabled<br>Based on internal event about triggers:<br>- the trigger is disabled<br>Based on internal event about items/low-level discovery rules:<br>- the item is disabled<br>- the host is disabled*|The message in progress is sent and then one more message on the escalation is sent. The follow-up message will have the cancellation text at the beginning of the message body (*NOTE: Escalation canceled*) naming the reason (for example, *NOTE: Escalation canceled: action '<Action name>' disabled*). This way the recipient is informed that the escalation is canceled and no more steps will be executed. This message is sent to all who received the notifications before. The reason of cancellation is also logged to the server log file (starting from [Debug Level](/manual/appendix/config/zabbix_server) 3=Warning).<br><br>Note that the *Escalation canceled* message is also sent if operations are finished, but recovery operations are configured and are not executed yet.| |*During an escalation in progress (like a message being sent) the action is deleted*|No more messages are sent. The information is logged to the server log file (starting from [Debug Level](/manual/appendix/config/zabbix_server) 3=Warning), for example: `escalation canceled: action id:334 deleted`| ##### エスカレーション動作その他の例 アクションに複数のエスカレーション手順が含まれている場合、さまざまな状況で何が起こるかを考えてみましょう。 |状況|動作| |---------|--------| |*障害が発生したホストは、最初の障害通知が送信された後にメンテナンスに入る場合*|アクション[設定](/manual/config/notifications/action/operation#configuring_an_operation) の *メンテナンス中の場合に実行を保留* の設定に応じて、残りのエスカレーション手順はすべて、メンテナンス期間中遅延するか、遅延なしで即時実行されます。 メンテナンス期間によって操作がキャンセルされることはありません。| |* **期間**アクション条件で定義された期間は、最初の通知が送信された後、即時終了する場合*|残りのすべてのエスカレーション手順が実行されます。 *期間*条件では操作を停止できません。 操作ではなく、アクションが開始されるかされないかに関して効果があります。| |*メンテナンス中に不具合が発生し、メンテナンス終了後も継続する（解消されない）場合*|アクション [設定](/manual/config/notifications/action/operation#configuring_an_operation) の *メンテナンス中の場合に実行を保留* の設定に応じて、すべてのエスカレーション手順は、メンテナンスが終了した瞬間、または即時実行されます。| |*データなしのメンテナンス中に障害が発生し、メンテナンス終了後も継続する (解決されない)場合*|すべてのエスカレーション手順が実行される前に、トリガーが起動するのを待つ必要があります。| |*さまざまなエスカレーションが連続して続き、重なる場合*|新しい各エスカレーションの実行は前のエスカレーションに取って代わりますが、前のエスカレーションで常に実行されるエスカレーション手順が少なくとも 1 つ必要です。 この動作は、トリガーのすべての障害評価で作成されたイベントに対するアクションに関連しています。| |*進行中のエスカレーション中 (メッセージの送信など)、あらゆるタイプのイベントに基づいて:<br>- アクションは無効<br>トリガー イベントに基づいて:<br>- トリガーは無効<br>- ホストまたはアイテムは無効<br>トリガーに関する内部イベントに基づいて:<br>- トリガーは無効<br>アイテム/ローレベルディスカバリルールに関する内部イベントに基づいて:<br>- アイテムは無効<br>- ホストは無効*|進行中のメッセージが送信され、エスカレーションに関するメッセージがもう 1 つ送信されます。 フォローアップ メッセージには、メッセージ本文の先頭にキャンセル テキスト (*注: エスカレーションがキャンセルされました*) があり、理由が示されます (例: *注: エスカレーションがキャンセルされました: アクション '<アクション名>' が無効化されました*)。 このように、エスカレーションがキャンセルされ、それ以上の手順が実行されないことが受信者に通知されます。 このメッセージは、以前に通知を受け取ったすべての人に送信されます。 キャンセルの理由は、サーバーのログ ファイルにも記録されます ([デバッグ レベル](/manual/appendix/config/zabbix_server) 3=Warning以上)。<br><br>*エスカレーションがキャンセルされました* メッセージも オペレーションが終了したが、リカバリ オペレーションが設定されていて、まだ実行されていない場合に送信されます。| |*エスカレーションの進行中 (メッセージの送信など) にアクションが削除される*|これ以上メッセージは送信されません。 情報はサーバー ログ ファイルに記録されます ([デバッグ レベル](/manual/appendix/config/zabbix_server) 3=警告 以上)| #### Miscellaneous - Maximum field size has been increased for the following fields: - [Item preprocessing](/manual/config/items/preprocessing#configuration) parameters - [Media type](/manual/config/notifications/media#common-parameters) message - The default language of Zabbix web interface has been changed from British to American English. Support of British English has been dropped. - The Share link in the main menu has been replaced by an Integrations link, leading to the [Integrations](https://www.zabbix.com/integrations) page on the Zabbix website. - If Zabbix web interface is opened in one of the languages available on the Zabbix website, clicking the Integrations link will open the Integrations page in the appropriate language. For all other languages, including English, the Integrations page will be opened in English. - A custom expression, used in [action configuration](/manual/config/notifications/action/#configuring-an-action) for calculating conditions, now can be up to 1024 characters long (previously 255). - *Monitoring->Hosts* section now shows link to host problems screen even if no problems are currently open. #### その他 - 次のフィールドの最大フィールド サイズが増加しました : - [アイテムの前処理](/manual/config/items/preprocessing#configuration)のパラメーター - [メディアタイプ](/manual/config/notifications/media#common-parameters) message - Zabbixウェブインターフェースのデフォルト言語が、イギリス英語からアメリカ英語に変更されました。イギリス英語のサポートは終了しました。 - メインメニューの共有リンクはインテグレーションリンクに変更され、Zabbixウェブサイトの[インテグレーション](https://www.zabbix.com/integrations)ページが表示されます。 - Zabbix WebインタフェースをZabbixウェブサイトで利用可能な言語で開いている場合、インテグレーションリンクをクリックすると該当する言語でインテグレーションページが表示されます。それ以外の言語では英語で表示されます。 - [アクションの設定](/manual/config/notifications/action/#configuring-an-action)で条件計算のために使用するカスタム式は、最大1024文字まで使用できるようになりました(従来は255文字)。 - *監視データ->ホスト*セクションは、現在発生中の障害がない場合でも、ホストの障害画面へのリンクを表示するようになりました。 #### Miscellaneous The *Clear history* button located in *Configuration* → *Hosts* → [*Items*](/manual/web_interface/frontend_sections/configuration/hosts/items#mass-editing-options) has been renamed *Clear history and trends* to more accurately describe its function, which is the same as the *Clear history and trends* button in the item [configuration form](/manual/config/items/item). #### その他 *設定* → *ホスト* → [*アイテム*](/manual/web_interface/frontend_sections/configuration/hosts/items#mass-editing-options)にある*ヒストリを削除*ボタンはその機能をより正確に表すために、アイテムの[構成画面](/manual/config/items/item)にあるものと同じ*ヒストリとトレンドを削除*という名前に変更されました。 #### Mismatch counting Count the number of hosts whose names do not contain the substring "ubuntu" Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "countOutput": true, "search": { "host": "ubuntu" }, "excludeSearch": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "44", "id": 1 } ``` #### 不一致を数える 名前に部分文字列"ubuntu"が含まれていないホストの数を数えます。 リクエスト: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "countOutput": true, "search": { "host": "ubuntu" }, "excludeSearch": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` レスポンス: ```json { "jsonrpc": "2.0", "result": "44", "id": 1 } ``` #### Missing files in Windows agent archive The Windows Zabbix agent download ZIP file is missing zabbix_sender.h and zabbix_sender.lib files in versions 6.0.0-6.0.27, required for zabbix_sender.dll. #### Windowsエージェントアーカイブにファイルが存在しない Windows ZabbixエージェントのダウンロードZIPファイルには、zabbix_sender.dllに必要なバージョン6.0.0-6.0.27のzabbix_sender.hファイルとzabbix_sender.libファイルが含まれておりません。 ### Mixing item key and session parameters in Zabbix agent 2 plugins Zabbix agent 2 now allows to override [named session](/manual/config/items/plugins) parameters by specifying new values in the item key parameters. Previously, users had to select if they prefer to provide connection string values in a named session or in an item key. If a named session has been used, related item key parameters had to be empty. Now, if using named sessions, only the first parameter (usually, a URI) has to be specified in the named session, whereas other parameters can be defined either in the named session or in the item key. ### Zabbixエージェント2プラグインでのアイテムキーとセッションパラメーターの混在 Zabbixエージェント2で、アイテムキーのパラメーターに新しい値を指定することで、[名前付きセッション](/manual/config/items/plugins)パラメーターを上書きできるようになりました。 変更前は、名前付きセッションとアイテムキーのどちらで接続文字列値を指定するかをユーザーが選択する必要がありました。 名前付きセッションが使用される場合、関連するアイテムキーのパラメーターは空である必要がありました。 新しいバージョンでは、名前付きセッションを使用する場合、最初のパラメーター(通常はURI)のみ名前付きセッションで指定する必要がありますが、他のパラメーターは名前付きセッション、アイテムキーのどちらでも指定することができます。 ### Modifying existing services :::noteclassic The buttons described below are visible only when *Services* section is in the Edit mode. ::: To edit an existing service, press the pencil icon next to the service. To clone an existing service, press the pencil icon to open its configuration and then press Clone button. When a service is cloned, its parent links are preserved, while the child links are not. To delete a service, press on the `x` icon next to it. When you delete a parent service, its child services will not be deleted and will move one level higher in the service tree (1st level children will get the same level as the deleted parent service). Two buttons below the list of services offer some mass-editing options: - *Mass update* - mass update service properties - *Delete* - delete the services To use these options, mark the checkboxes before the respective services, then click on the required button. ### 既存のサービスの変更 :::noteclassic 以下で説明するボタンは、*Services* セクションが編集モードの場合にのみ表示されます。 ::: 既存のサービスを編集するには、サービスの横にある鉛筆アイコンを押します。 既存のサービスを複製するには、鉛筆アイコンを押して設定を開き、[複製] ボタンを押します。 サービスが複製されると、親リンクは保持されますが子リンクは保持されません。 サービスを削除するには、サービスの横にある`x`アイコンを押します。 親サービスを削除しても、その子サービスは削除されず、サービス ツリーで 1 レベル上に移動します (第 1 レベルの子は、削除された親サービスと同じレベルになります)。 サービスのリストの下にある 2 つのボタンには、一括編集オプションがあります。 - *一括更新* - サービスのプロパティを一括更新 - *削除* - サービスの削除 これらのオプションを使用するには、それぞれのサービスの前にあるチェックボックスをマークしてから、必要なボタンをクリックします。 ##### Module structure Each module is a directory (placed within the `modules` directory) with sub-directories containing controllers, views and any other code: example_module_directory/ (required) manifest.json (required) Metadata and action definition. Module.php Module initialization and event handling. actions/ Action controller files. SomethingView.php SomethingCreate.php SomethingDelete.php data_export/ ExportAsXml.php ExportAsExcel.php views/ View files. example.something.view.php example.something.delete.php js/ JavaScript files used in views. example.something.view.js.php partials/ View partial files. example.something.reusable.php js/ JavaScript files used in partials. example.something.reusable.js.php As you can see, the only mandatory file within the custom module directory is `manifest.json`. The module will not register without this file. `Module.php` is responsible for registering menu items and processing events such as 'onBeforeAction' and 'onTerminate'. The *actions*, *views* and *partials* directories contain PHP and JavaScript code needed for module actions. ##### モジュールの構造 各モジュールは、(`modules` ディレクトリの中にある) ディレクトリで、 <br> サブディレクトリに、コントローラ、ビュー、その他のコードが格納されています。 <br> example_module_directory/ (required) manifest.json (required) Metadata and action definition. Module.php Module initialization and event handling. actions/ Action controller files. SomethingView.php SomethingCreate.php SomethingDelete.php data_export/ ExportAsXml.php ExportAsExcel.php views/ View files. example.something.view.php example.something.delete.php js/ JavaScript files used in views. example.something.view.js.php partials/ View partial files. example.something.reusable.php js/ JavaScript files used in partials. example.something.reusable.js.php 見てわかるように、カスタムモジュールディレクトリ内の唯一の必須ファイルは `manifest.json` です。 <br> このファイルがないと、モジュールは登録されません。 <br> `Module.php` は、メニューアイテムの登録と、'onBeforeAction' や 'onTerminate' などのイベントの処理を担当します。 <br> *actions*、*views*、*partials* ディレクトリには、モジュールのアクションに必要なPHPとJavaScriptのコードが含まれています。 <br> ### Module The module object has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**moduleid**<br>(required)|string|ID of the module.| |status|integer|Whether access to the module is enabled.<br><br>Possible values:<br>0 - Disabled;<br>1 - *(default)* Enabled.| ### Module module オブジェクトには次のプロパティがあります |プロパティ|[タイプ](/manual/api/reference_commentary#data_types)|説明| |--|--|------| |**moduleid**<br>(必須)|string|モジュールID| |status|integer|モジュールへのアクセスが有効か<br><br>使用可能な値：<br>0 - 無効<br>1 - *(デフォルト)*有効| #### MongoDB plugin parameters The following MongoDB plugin parameters are no longer mandatory if Plugins.MongoDB.Sessions.<SessionName>.TLSConnect is set to `verify_ca` or `verify_full`: - Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile - Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile See also: [MongoDB plugin parameters](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#parameters) #### MongoDBプラグインのパラメーター Plugins.MongoDB.Sessions.<SessionName>.TLSConnectが`verify_ca`または`verify_full`に設定されている場合、次のMongoDBプラグインパラメーターは必須ではなくなりました。 - Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile - Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile 参照: [MongoDBプラグインパラメーター](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#parameters) #### Monitoring → Latest data updated Several improvements have been made to the Latest data section: - Time since last check (for example, 1m 20s) is now displayed instead of the last item execution time. - Hovering over an item's last value will show the raw value without units or value mapping applied. - If a host is in maintenance, an orange wrench icon will be visible next to the host name. #### 監視データ → 最新データ 更新 最新データ セクションにいくつかの改良が加えられました: - アイテムの最終実行時間の代わりに、最終チェックからの時間（例：1m20s）が表示されるようになりました。 - アイテムの最後の値にカーソルを合わせると、単位や値のマッピングが適用されていない生の値が表示されます。 - ホストがメンテナンス中の場合、ホスト名の横にオレンジ色のレンチのアイコンが表示されます。 #### Monitoring → Latest data updated The Latest data section now shows the time since last check (for example, 1m 20s) instead of the last item execution time. Additionally, it is now possible to view a raw value of an item without units or value mapping applied by hovering over the last value. ## Breaking changes #### Monitoring → Overview removed The Overview section in the Monitoring menu has been removed completely. The same functionality can be still accessed by using the *Data overview* and *Trigger overview* dashboard [widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets). #### 監視データ → 概要 を削除 監視データ メニューの概要 セクションが完全に削除されました。 *データの概要*と*トリガーの概要*のダッシュボード[ウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を使用して、同じ機能にアクセスすることができます。 ##### Monitoring → Overview removed The Overview section in the Monitoring menu has been removed completely. The same functionality can be still accessed by using the *Data overview* and *Trigger overview* dashboard [widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets). ##### Monitoring → Overview を削除 Monitoring メニューの Overview セクションが完全に削除されました。 <br> 同じ機能は、*Data overview* と *Trigger overview* のダッシュボードを使用してアクセスすることができます。 <br> [widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) を参照してください。 <br> #### Monitoring → Problems The following parameters are supported: - `show` - filter option "Show": 1 - recent problems, 2 - all, 3 - in problem state - `name` - filter option "Problem": freeform string - `severities` - filter option "Severity": array of selected severities in a format 'severities\[\*\]=\*' (replace \* with severity level): 0 - not classified, 1 - information, 2 - warning, 3 - average, 4 - high, 5 - disaster - `inventory` - filter option "Host inventory": array of inventory fields: \[field\], \[value\] - `evaltype` - filter option "Tags", tag filtering strategy: 0 - And/Or, 2 - Or - `tags` - filter option "Tags": array of defined tags: \[tag\], \[operator\], \[value\] - `show_tags` - filter option "Show tags": 0 - none, 1 - one, 2 - two, 3 - three - `tag_name_format` - filter option "Tag name": 0 - full name, 1 - shortened, 2 - none - `tag_priority` - filter option "Tag display priority": comma-separated string of tag display priority - `show_suppressed` - filter option "Show suppressed problems": should be 'show\_suppressed=1' to show - `unacknowledged` - filter option "Show unacknowledged only": should be 'unacknowledged=1' to show - `compact_view` - filter option "Compact view": should be 'compact\_view=1' to show - `highlight_row` - filter option "Highlight whole row" (use problem color as background color for every problem row): should be '1' to highlight; can be set only when 'compact\_view' is set - `filter_name` - filter properties option "Name": freeform string - `filter_show_counter` - filter properties option "Show number of records": 1 - show, 0 - do not show - `filter_custom_time` - filter properties option "Set custom time period": 1 - set, 0 - do not set - `sort` - sort column: clock, host, severity, name - `sortorder` - sort order or results: DESC - descending, ASC - ascending - `age_state` - filter option "Age less than": should be 'age\_state=1' to enable 'age'. Is used only when 'show' equals 3. - `age` - filter option "Age less than": days - `groupids` - filter option "Host groups": array of host groups IDs - `hostids` - filter option "Hosts": array of host IDs - `triggerids` - filter option "Triggers": array of trigger IDs - `show_timeline` - filter option "Show timeline": should be 'show\_timeline=1' to show - `details` - filter option "Show details": should be 'details=1' to show - `from` - date range start, can be 'relative' (e.g.: now-1m). Is used only when 'filter\_custom\_time' equals 1. - `to` - date range end, can be 'relative' (e.g.: now-1m). Is used only when 'filter\_custom\_time' equals 1. #### 監視データ → 障害 次のパラメーターがサポートされています。 - `show` - フィルターオプション"表示": 1 - 最近の障害、2 - 障害、3 - ヒストリ - `name` - フィルターオプション"障害": 自由形式の文字列 - `severities` - フィルターオプション"深刻度": 'severities\[\*\]=\*'という形式の選択した深刻度の配列(\*を深刻度レベルに置き換える): 0 - 未分類、1 - 情報、2 - 警告、3 - 軽度の障害、4 - 重度の障害、5 - 致命的な障害 - `inventory` - フィルターオプション"ホストインベントリ": インベントリフィールドの配列: \[field\],\[value\] - `evaltype` - フィルターオプション"タグ": タグフィルタリング方法: 0 - And/Or、2 - Or - `tags` - フィルターオプション"タグ": 定義されたタグの配列: \[tag\],\[operator\],\[value\] - `show_tags` - フィルターオプション"タグを表示": 0 - なし、1 - 1、2 - 2、3 - 3 - `tag_name_format` - フィルターオプション"タグ名": 0 - すべて、1 - 短縮、2 - なし - `tag_priority` - フィルターオプション"タグ表示優先度": タグ表示優先度のカンマ区切り文字列 - `show_suppressed` - フィルターオプション"メンテナンス中の障害を表示": 表示には'show\_suppressed=1'を使用 - `unacknowledged` - フィルターオプション"未確認のみ表示": 表示には'unacknowledged=1'を使用 - `compact_view` - フィルターオプション"コンパクト表示": 表示には'compact\_view=1'を使用 - `highlight_row` - フィルターオプション"行を強調表示"(すべての障害行の背景色として障害の色を使用): 強調表示するには'1'にする必要があります。'compact\_view'が設定されている場合にのみ使用できます。 - `filter_name` - フィルタープロパティオプション"障害": 自由形式の文字列 - `filter_show_counter` - フィルタープロパティオプション"レコード数を表示": 1 - 表示、0 - 表示しない - `filter_custom_time` - フィルタープロパティオプション"カスタム期間の設定": 1 - 設定、0 - 設定しない - `sort` - 並べ替え列: 継続時間、ホスト、深刻度、障害 - `sortorder` - 並べ替え順序または結果: DESC - 降順、ASC - 昇順 - `age_state` - フィルターオプション"表示期間": 'age'を有効にするには、'age\_state=1'にする必要があります。 'show'が3の場合にのみ使用されます。 - `age` - フィルターオプション"表示期間": 日数 - `groupids` - フィルターオプション"ホストグループ": ホストグループIDの配列 - `hostids` - フィルターオプション"ホスト": ホストIDの配列 - `triggerids` - フィルターオプション"トリガー": トリガーIDの配列 - `show_timeline` - フィルターオプション"タイムラインを表示": 表示するには'show\_timeline=1'である必要があります - `details` - フィルターオプション"詳細を表示": 表示するには'details=1'にする必要があります - `from` - 日付範囲の開始。'相対'にすることができます(例: now-1m)。'filter\_custom\_time'が1の場合にのみ使用されます。 - `to` - 日付範囲の終了。'相対'にすることができます(例: now-1m)。'filter\_custom\_time'が1の場合にのみ使用されます。 ##### Monitoring server availability At least three methods (or combination of all methods) may be used in order to monitor availability of a server. - ICMP ping ("icmpping" key) - "zabbix\[host,agent,available\]" item - trigger function nodata() for monitoring the availability of hosts that use active checks only ##### サーバーの可用性監視 サーバーの可用性を監視するために、少なくとも 3 つの方法 (またはすべての方法の組み合わせ) を使用できます。 - ICMP ping ("icmpping" キー) - "zabbix\[host,agent,available\]" アイテム - アクティブチェックのみ使用する、ホストの可用性を監視するためのトリガー関数 nodata() #### Monitoring specific applications #### 特定のアプリケーションの監視 ### Monitoring The Zabbix API allows you to access history and other data gathered during monitoring. ### 監視 Zabbix APIでは、監視中に収集した履歴やその他のデータにアクセスすることができます。 ### Monitoring Windows services This tutorial provides step-by-step instructions for setting up the monitoring of Windows services. It is assumed that Zabbix server and agent are configured and operational. ### Windows サービスの監視 このチュートリアルでは、Windowsサービスの監視を設定するための手順を段階的に説明します。Zabbixサーバーとエージェントが構成され、動作していることを前提としています。 #### Monotonic change It is now possible to check for monotonic increase or decrease in item values using the new **monoinc()** or **monodec()** [history functions](/manual/appendix/functions/history). #### 単調変化 新しい[ヒストリ関数](/manual/appendix/functions/history)**monoinc()**または**monodec()**を使用して、アイテム値の単調増加、単調減少をチェックできるようになりました。 ### Month abbreviated with capital letter A "month" is now abbreviated with the capital "M" in the frontend. Previously it was abbreviated with the small "m", overlapping with the abbreviation of a minute. ### 月の省略文字が大文字に "月"がフロントエンドでは大文字の"M"で省略されるようになりました。 以前は小文字の"m"で省略されていたので、"分"の省略と重複していました。 #### More info See [Virtual machine monitoring](/manual/vm_monitoring) for detailed information how to configure Zabbix to monitor VMware environments. #### 詳細 ZabbixでVMware環境を監視するための詳細な設定方法は、[仮想マシン監視](/manual/vm_monitoring) を参照してください。 #### More secure JavaScript preprocessing The JavaScript function [atob](/manual/config/items/preprocessing/javascript/javascript_objects#global-javscript-functions) now returns an array of 8-bit unsigned integers instead of a decoded string. #### よりセキュアなJavaScript保存前処理 JavaScript関数[atob](/manual/config/items/preprocessing/javascript/javascript_objects#global-javscript-functions)は、デコードされた文字列ではなく、8ビットの符号なし整数の配列を返すようになりました。 Most trigger functions are evaluated based on item value [history](/manual/config/items/history_and_trends) data, while some trigger functions for long-term analytics, e.g. **trendavg()**, **trendcount()**, etc, use trend data. ほとんどのトリガー関数はアイテムの値の[ヒストリ](/manual/config/items/history_and_trends)データに基づいて評価されますが、一部のトリガー関数は長期的な分析に使用されます。 **trendavg()**、**trendcount()** などはトレンド データを使用します。 #### Moving and copy-pasting elements Several selected elements can be **moved** to another place in the map by clicking on one of the selected elements, holding down the mouse button, and moving the cursor to the desired location. One or more elements can be **copied** by selecting the elements, then clicking on a selected element with the right mouse button and selecting *Copy* from the menu. {width="600"} To paste the elements, click on a map area with the right mouse button and select *Paste* from the menu. The *Paste without external links* option will paste the elements retaining only the links that are between the selected elements. Copy-pasting works within the same browser window. Keyboard shortcuts are not supported. #### 要素の移動とコピーペースト 選択した要素の1つをクリックし、マウスボタンを押したままカーソルを目的の場所に移動すると、選択した複数の要素を<br> マップ内の別の場所に **移動** することができます。 要素を選択し、マウスの右ボタンで選択した要素をクリックし、メニューから **Copy** を選択することで、1つまたは<br> 複数の要素を **コピー** することができます。 {width="600"} 要素を貼り付けるには、マウスの右ボタンで地図上の領域をクリックし、メニューから *Paste* を選択します。 *Paste without external links* を選択すると、選択した要素間のリンクのみを残して貼り付けられます。 コピー＆ペーストは、同じブラウザウィンドウ内で動作します。キーボードショートカットはサポートされていません。 ### MQTT |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |mqtt.get\[<broker\_url>,topic,<username>,<password>\]|<|<|<| |Subscribes to a specific topic or topics (with wildcards) of the provided broker and waits for publications.|Depending on topic content.<br><br>If wildcards are used, returns topic content as JSON.|**broker\_url** - MQTT broker URL (if empty, *localhost* with port 1883 is used).<br>**topic** - MQTT topic (mandatory). Wildcards (+,\#) are supported.<br>**username,password** - authentication credentials (if required)|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks) ('Zabbix agent (active)' item type).<br><br>TLS encryption certificates can be used by saving them into a default location (e.g. `/etc/ssl/certs/` directory for Ubuntu). For TLS, use the `tls://` scheme.| ### MQTT |キー|<|<|<| |--|--|------|------| |**説明**|**戻り値**|**パラメータ**|**コメント**| |mqtt.get\[<broker\_url>,topic,<username>,<password>\]|<|<|<| |指定されたブローカーの特定のトピック (ワイルドカードを使用) をサブスクライブし、パブリケーションを待ちます。|トピックの内容によって異なります。<br><br>ワイルドカードを使用すると、トピックの内容が JSON として返されます。|**broker\_url** - MQTT ブローカー URL (空の場合、ポート 1883 の *localhost* が使用されます)<br>**topic** - MQTT トピック (必須)。 ワイルドカード (+、\#) がサポートされています。<br>**username,password** - 認証資格情報 (必要な場合) |アイテムは [アクティブ チェック](/manual/appendix/items/activepassive#active_checks) ('Zabbix エージェント (アクティブ)'アイテム タイプ) として構成する必要があります。<br><br>TLS 暗号化証明書は、デフォルトの場所 (Ubuntu の場合は `/etc/ssl/certs/` ディレクトリなど) に保存することで使用できます。 TLS の場合は、`tls://` スキームを使用します。| #### MSSQL A new plugin for direct monitoring of MSSQL by Zabbix agent 2 has been added. For more information, see: - [MSSQL plugin readme](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Agent 2 items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) - [MSSQL plugin parameters](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin) - [Agent 2 installation](/manual/concepts/agent2#installation) #### MSSQL Zabbixエージェント2によるMSSQLの直接監視用の新しいプラグインが追加されました。 詳細は以下をご覧ください: - [MSSQLプラグインreadme](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Zabbixエージェント2のアイテム](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) - [MSSQLプラグインのパラメーター](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin) - [Zabbixエージェント2のインストール](/manual/concepts/agent2#installation) #### MSSQL instance names supported in agent 2 plugin It is now possible to specify MSSQL instance names as part of the connection string in MSSQL agent 2 plugin items, for example: mssql.custom.query[sqlserver://localhost/InstanceName,...] Note that in this case **no port** must be specified. If port is specified, then the instance name will be ignored and the specified port will be used for connection. #### エージェント2プラグインでサポートされるMSSQLインスタンス名 MSSQLエージェント2プラグインアイテムの接続文字列の一部としてMSSQLインスタンス名を指定できるようになりました。例: mssql.custom.query[sqlserver://localhost/InstanceName,...] この場合、**ポートなし**を指定する必要があります。ポートが指定されている場合、インスタンス名は無視され、指定されたポートが接続に使用されます。 #### MSSQL Zabbix agent 2 plugin update The template [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) has been updated with filters to include or exclude discovered quorum members by name as well as a service filter that allows filtering by cluster name to exclude empty clusters. To have the template work without errors, the [MSSQL Zabbix agent 2 plugin](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin) must be updated to a version equal to or above 6.0.39. #### MSSQL Zabbixエージェント2プラグインの更新 テンプレート[MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0)が更新され、検出されたクォーラムメンバーを名前で含めたり除外したりするフィルターと、クラスター名でフィルターして空のクラスターを除外できるサービスフィルターが追加されました。テンプレートをエラーなく動作させるには、[MSSQL Zabbixエージェント2プラグイン](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin)を6.0.39以上のバージョンに更新する必要があります。 ##### Multiple HTTP requests Collect the content of both *https://www.example.com* and *https://www.example.com/release\_notes*: - Create an item with type "Script".\ - In the *Script* field, enter the following code: ``` {.java} var request = new HttpRequest(); return request.get("https://www.example.com") + request.get("https://www.example.com/release_notes"); ``` ##### 複数のHTTPリクエスト *https://www.example.com* と *https://www.example.com/release_notes* の両方の内容を収集します。 - タイプ "Script" の item を作成します。 - *Script*の欄に、以下のコードを入力します: ``` {.java} var request = new HttpRequest(); return request.get("https://www.example.com") + request.get("https://www.example.com/release_notes"); ``` #### Multiple LLD rules for the same item Since Zabbix agent version 3.2 it is possible to define several low-level discovery rules with the same discovery item. To do that you need to define the Alias agent [parameter](/manual/appendix/config/zabbix_agentd), allowing to use altered discovery item keys in different discovery rules, for example `vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]`, etc. #### 同じアイテムに対する複数のLLDルール Zabbixエージェントバージョン3.2以降、同じディスカバリ項目で複数のローレベルディスカバリルールを定義することが可能です。 これにはエイリアスエージェント[パラメータ](/manual/appendix/config/zabbix_agentd)を定義する必要があります。これによりさまざまな検出ルールで変更された検出アイテムキーを使用できるようになります。たとえば`vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]`などです。 #### MySQL 8.0 Group Replication in multi‐primary mode When using MySQL 8.0 Group Replication in multi‐primary mode, you may encounter an error during transaction commits similar to the following: 1531697:20250128:064734.697 query [txnlev:1] [update alerts set status=1,retries=0,error='' where alertid=154618; 1531697:20250128:064734.713 query [txnlev:1] [commit;] 1531697:20250128:064734.753 [Z3005] query failed: [3101] Plugin instructed the server to rollback the current transaction. [commit;] This error appears to be triggered by issues with rollback operations involving foreign key constraints. See also: - [ZBX-26060](https://support.zabbix.com/browse/ZBX-26060) for the related problem report. - [MySQL Bug #96758 "Rollbacks with Foreign Keys on single node"](https://bugs.mysql.com/bug.php?id=96758) for the upstream issue. #### マルチプライマリモードでのMySQL 8.0グループレプリケーション MySQL 8.0グループレプリケーションをマルチプライマリモードで使用している場合、トランザクションのコミット時に次のようなエラーが発生することがあります。 1531697:20250128:064734.697 query [txnlev:1] [update alerts set status=1,retries=0,error='' where alertid=154618; 1531697:20250128:064734.713 query [txnlev:1] [commit;] 1531697:20250128:064734.753 [Z3005] query failed: [3101] Plugin instructed the server to rollback the current transaction. [commit;] このエラーは、外部キー制約を含むロールバック操作の問題によって発生しているようです。 参照: - 関連する問題報告について、[ZBX-26060](https://support.zabbix.com/browse/ZBX-26060) - アップストリームの問題について、[MySQL Bug #96758 "単一ノードでの外部キーによるロールバック"](https://bugs.mysql.com/bug.php?id=96758) #### MySQL 8.1 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 8.1.X. #### MySQL 8.1をサポート MySQLの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は8.1.Xになりました。 #### MySQL 8.2 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 8.2.X. #### MySQL 8.2をサポート MySQLの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は8.2.Xになりました。 #### MySQL 8.3 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 8.3.X. #### MySQL 8.3をサポート MySQLの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は8.3.Xになりました。 #### MySQL 8.4 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 8.4.X. #### MySQL 8.4をサポート MySQLの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は8.4.Xになりました。 #### MySQL 9.0 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 9.0.X. #### MySQL 9.0をサポート MySQLの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は9.0.Xになりました。 #### MySQL 9.5 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 9.5.X. #### MySQL 9.5をサポート MySQLの最大[サポートバージョン](/manual/installation/requirements#サードパーティの外部周辺ソフトウェア)は9.5.Xになりました。 #### MySQL Character sets utf8 (aka utf8mb3) and utf8mb4 are supported (with utf8_bin and utf8mb4_bin collation respectively) for Zabbix server/proxy to work properly with MySQL database. It is recommended to use utf8mb4 for new installations. For Zabbix 6.0.11 and newer, deterministic triggers need to be created during the import of schema. On MySQL and MariaDB, this requires `GLOBAL log_bin_trust_function_creators = 1` to be set if binary logging is enabled and there is no superuser privileges and log_bin_trust_function_creators = 1 is not set in MySQL configuration file. If you are installing from Zabbix **packages**, proceed to the [instructions](https://www.zabbix.com/download) for your platform. If you are installing Zabbix from sources: * Create and configure a database and a user. ``` shell> mysql -uroot -p<password> mysql> create database zabbix character set utf8mb4 collate utf8mb4_bin; mysql> create user 'zabbix'@'localhost' identified by '<password>'; mysql> grant all privileges on zabbix.* to 'zabbix'@'localhost'; mysql> SET GLOBAL log_bin_trust_function_creators = 1; mysql> quit; ``` * Import the data into the database. For a Zabbix proxy database, only `schema.sql` should be imported (no images.sql nor data.sql). ``` shell> cd database/mysql shell> mysql -uzabbix -p<password> zabbix < schema.sql # stop here if you are creating database for Zabbix proxy shell> mysql -uzabbix -p<password> zabbix < images.sql shell> mysql -uzabbix -p<password> zabbix < data.sql ``` log_bin_trust_function_creators can be disabled after the schema has been successfully imported: ``` shell> mysql -uroot -p<password> mysql> SET GLOBAL log_bin_trust_function_creators = 0; mysql> quit; ``` #### MySQL Zabbixサーバー/プロキシがMySQLデータベースで正しく動作するために、文字セットutf8（別名utf8mb3）およびutf8mb4がサポートされています。（それぞれutf8_binおよびutf8mb4_binを使用）新規インストールにはutf8mb4を使用することをお勧めします。 Zabbix 6.0.11以降では、スキーマのインポート中に決定論的トリガーを作成する必要があります。MySQLとMariaDBでは、バイナリロギングが有効であり、スーパーユーザー権限がなく、MySQL構成ファイルに`log_bin_trust_function_creators = 1`が設定されていない場合、`GLOBAL log_bin_trust_function_creators = 1`を設定する必要があります。 Zabbix**パッケージ**からインストールする場合は、お使いのプラットフォームの[手順](https://www.zabbix.com/download)を確認してください。 ソースから Zabbix をインストールする場合： * データベースとユーザーの作成と設定 ``` shell> mysql -uroot -p<password> mysql> create database zabbix character set utf8mb4 collate utf8mb4_bin; mysql> create user 'zabbix'@'localhost' identified by '<password>'; mysql> grant all privileges on zabbix.* to 'zabbix'@'localhost'; mysql> SET GLOBAL log_bin_trust_function_creators = 1; mysql> quit; ``` * データをデータベースにインポートします。 Zabbixプロキシデータベースの場合、`schema.sql`のみをインポートする必要があります。(images.sqlもdata.sqlもインポートしないでください) ``` shell> cd database/mysql shell> mysql -uzabbix -p<password> zabbix < schema.sql ＃Zabbixプロキシ用のデータベースを作成している場合は、ここで停止します shell> mysql -uzabbix -p<password> zabbix < images.sql shell> mysql -uzabbix -p<password> zabbix < data.sql ``` スキーマを正常にインポートした後、log_bin_trust_function_creatorsを無効にすることができます： ``` shell> mysql -uroot -p<password> mysql> SET GLOBAL log_bin_trust_function_creators = 0; mysql> quit; ``` #### MySQL - CR\_CONN\_HOST\_ERROR - CR\_SERVER\_GONE\_ERROR - CR\_CONNECTION\_ERROR - CR\_SERVER\_LOST - CR\_UNKNOWN\_HOST - ER\_SERVER\_SHUTDOWN - ER\_ACCESS\_DENIED\_ERROR - ER\_ILLEGAL\_GRANT\_FOR\_TABLE - ER\_TABLEACCESS\_DENIED\_ERROR - ER\_UNKNOWN\_ERROR #### MySQL - CR\_CONN\_HOST\_ERROR - CR\_SERVER\_GONE\_ERROR - CR\_CONNECTION\_ERROR - CR\_SERVER\_LOST - CR\_UNKNOWN\_HOST - ER\_SERVER\_SHUTDOWN - ER\_ACCESS\_DENIED\_ERROR - ER\_ILLEGAL\_GRANT\_FOR\_TABLE - ER\_TABLEACCESS\_DENIED\_ERROR - ER\_UNKNOWN\_ERROR #### MySQL custom error codes If Zabbix is used with MySQL installation on Azure, an unclear error message *\[9002\] Some errors occurred* may appear in Zabbix logs. This generic error text is sent to Zabbix server or proxy by the database. To get more information about the cause of the error, check Azure logs. #### MySQLカスタムエラーコード Azure上のMySQLインストールでZabbixを使用している場合、不明瞭なエラーメッセージ*\[9002\] Some errors occurred*がZabbixログに表示されることがあります。この一般的なエラーテキストは、データベースからZabbixサーバーまたはプロキシに送信されます。エラーの原因について詳しくは、Azureログを確認してください。 ##### MySQL database certificate base encryption MySQL database side: apiVersion: v1 data: root-ca.pem: >- < root-ca.pem data> server-cert.pem: >- < server-cert.pem data> server-key.pem: >- < server-key.pem data> kind: Secret metadata: name: zabbix-db-server-tls-secret type: Opaque Zabbix components side: apiVersion: v1 data: client-cert.pem: >- < client-cert.pem data> client-key.pem: >- < client-key.pem data> root-ca.pem: >- < root-ca.pem data> kind: Secret metadata: name: zabbix-db-client-tls-secret type: Opaque Certificates must include `"-----BEGIN RSA PRIVATE KEY-----"` and `"-----END RSA PRIVATE KEY-----"`. For example: {width="600"} Then, during deployment, in the Zabbix component section and MySQL server (if using built-in server) choose the proper "TLS connection to database" option value and the "MySQL database certificates (client)" secret value. ##### MySQLデータベース証明書ベースの暗号化 MySQLデータベース側: apiVersion: v1 data: root-ca.pem: >- < root-ca.pem data> server-cert.pem: >- < server-cert.pem data> server-key.pem: >- < server-key.pem data> kind: Secret metadata: name: zabbix-db-server-tls-secret type: Opaque Zabbixコンポーネント側: apiVersion: v1 data: client-cert.pem: >- < client-cert.pem data> client-key.pem: >- < client-key.pem data> root-ca.pem: >- < root-ca.pem data> kind: Secret metadata: name: zabbix-db-client-tls-secret type: Opaque 証明書には`"-----BEGIN RSA PRIVATE KEY-----"` および `"-----END RSA PRIVATE KEY-----"`が含まれている必要があります。例: {width="600"} 次に、展開中に、ZabbixコンポーネントセクションとMySQLサーバー(組み込みサーバーを使用している場合)で、適切な"TLS connection to database"オプション値と"MySQL database certificates (client)"シークレット値を選択します。 #### MySQL Export and import must be performed in tmux/screen, so that the session isn't dropped. ##### MySQL 5.7+/8.0+ * Rename old tables, create new tables by running `history_pk_prepare.sql`. ``` mysql -uzabbix -p<password> zabbix < /usr/share/doc/zabbix-sql-scripts/mysql/history_pk_prepare.sql ``` * Export and import data mysqlsh should be [installed](https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-install-linux-quick.html). mysqlsh should be able to connect to the DB. If connection is done through socket, it could be needed to explicitly state a path to it. Connect via mysqlsh: sudo mysqlsh -uroot -S /run/mysqld/mysqld.sock --no-password -Dzabbix Run (CSVPATH should/could be tweaked according to needs): ``` CSVPATH="/var/lib/mysql-files"; util.exportTable("history_old", CSVPATH + "/history.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history.csv", {"dialect": "csv", "table": "history" }); util.exportTable("history_uint_old", CSVPATH + "/history_uint.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_uint.csv", {"dialect": "csv", "table": "history_uint" }); util.exportTable("history_str_old", CSVPATH + "/history_str.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_str.csv", {"dialect": "csv", "table": "history_str" }); util.exportTable("history_log_old", CSVPATH + "/history_log.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_log.csv", {"dialect": "csv", "table": "history_log" }); util.exportTable("history_text_old", CSVPATH + "/history_text.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_text.csv", {"dialect": "csv", "table": "history_text" }); ``` * Verify that everything works as supposed * Drop old tables ``` DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ##### MySQL <5.7, MariaDB (or if mysqlsh cannot be used for some reason) This option is slower and more time consuming, use only if there is a reason not to use mysqlsh. * Rename old tables, create new tables by running `history_pk_prepare.sql`. ``` mysql -uzabbix -p<password> zabbix < /usr/share/doc/zabbix-sql-scripts/mysql/history_pk_prepare.sql ``` * Export and import data Check if import/export is enabled only for files in the specific path: ``` mysql> SELECT @@secure_file_priv; +-----------------------+ | @@secure_file_priv | +-----------------------+ | /var/lib/mysql-files/ | +-----------------------+ ``` If the value is a path to directory, export/import could be performed for files in that directory. In this case paths to files in queries should be edited accordingly. Alternatively, secure_file_priv could be disabled (set to empty string) during upgrade. If the value is empty, export/import could be performed to/from files that could be located anywhere. *max_execution_time* should be disabled before exporting data to avoid timeout during export. ``` SET @@max_execution_time=0; SELECT * INTO OUTFILE '/var/lib/mysql-files/history.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_old; LOAD DATA INFILE '/var/lib/mysql-files/history.csv' IGNORE INTO TABLE history FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_uint.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_uint_old; LOAD DATA INFILE '/var/lib/mysql-files/history_uint.csv' IGNORE INTO TABLE history_uint FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_str.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_str_old; LOAD DATA INFILE '/var/lib/mysql-files/history_str.csv' IGNORE INTO TABLE history_str FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_log.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_log_old; LOAD DATA INFILE '/var/lib/mysql-files/history_log.csv' IGNORE INTO TABLE history_log FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_text.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_text_old; LOAD DATA INFILE '/var/lib/mysql-files/history_text.csv' IGNORE INTO TABLE history_text FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; ``` * Verify that everything works as supposed * Drop old tables ``` DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ##### Improving performance Additional hints for improving performance in both cases: * Increase bulk_insert_buffer_size buffer in the configuration file inside [mysqld] section or set it before import with SET: ``` [mysqld] bulk_insert_buffer_size=256M mysql cli > SET SESSION bulk_insert_buffer_size= 1024 * 1024 * 256; mysql cli > ... import queries ... ``` * See "Optimizing InnoDB bulk data loading": ([MySQL 5.7]([https://dev.mysql.com/doc/refman/5.7/en/optimizing-innodb-bulk-data-loading.html]), [MySQL 8.0]([https://dev.mysql.com/doc/refman/8.0/en/optimizing-innodb-bulk-data-loading.html])) * Disable binary logging (should not be used in case of a slave servers, since will not replicate data): ``` mysql cli > SET SESSION SQL_LOG_BIN=0; mysql cli > ... import queries ... ``` #### MySQL Export and import must be performed in tmux/screen, so that the session isn't dropped. ##### MySQL 5.7+/8.0+ * Rename old tables, create new tables by running [history_pk_prepare.sql](https://git.zabbix.com/projects/ZBX/repos/zabbix/commits/b3e90f1b9574a655e43c6045cf7a5568b1cc1a3b) * Export and import data mysqlsh should be [installed](https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-install-linux-quick.html). mysqlsh should be able to connect to the DB. If connection is done through socket, it could be needed to explicitly state a path to it. Connect via mysqlsh: sudo mysqlsh -uroot -S /run/mysqld/mysqld.sock --no-password -Dzabbix Run (CSVPATH should/could be tweaked according to needs): ``` CSVPATH="/var/lib/mysql-files"; util.exportTable("history_old", CSVPATH + "/history.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history.csv", {"dialect": "csv", "table": "history" }); util.exportTable("history_uint_old", CSVPATH + "/history_uint.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_uint.csv", {"dialect": "csv", "table": "history_uint" }); util.exportTable("history_str_old", CSVPATH + "/history_str.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_str.csv", {"dialect": "csv", "table": "history_str" }); util.exportTable("history_log_old", CSVPATH + "/history_log.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_log.csv", {"dialect": "csv", "table": "history_log" }); util.exportTable("history_text_old", CSVPATH + "/history_text.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_text.csv", {"dialect": "csv", "table": "history_text" }); ``` * Verify that everything works as supposed * Drop old tables ``` DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ##### MySQL <5.7, MariaDB (or if mysqlsh cannot be used for some reason) This option is slower and more time consuming, use only if there is a reason not to use mysqlsh. * Rename old tables, create new tables by running [history_pk_prepare.sql](https://git.zabbix.com/projects/ZBX/repos/zabbix/commits/b3e90f1b9574a655e43c6045cf7a5568b1cc1a3b) * Export and import data Check if import/export is enabled only for files in the specific path: ``` mysql> SELECT @@secure_file_priv; +-----------------------+ | @@secure_file_priv | +-----------------------+ | /var/lib/mysql-files/ | +-----------------------+ ``` If the value is a path to directory, export/import could be performed for files in that directory. In this case paths to files in queries should be edited accordingly. Alternatively, secure_file_priv could be disabled (set to empty string) during upgrade. If the value is empty, export/import could be performed to/from files that could be located anywhere. *max_execution_time* should be disabled before exporting data to avoid timeout during export. ``` SET @@max_execution_time=0; SELECT * INTO OUTFILE '/var/lib/mysql-files/history.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_old; LOAD DATA INFILE '/var/lib/mysql-files/history.csv' IGNORE INTO TABLE history FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_uint.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_uint_old; LOAD DATA INFILE '/var/lib/mysql-files/history_uint.csv' IGNORE INTO TABLE history_uint FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_str.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_str_old; LOAD DATA INFILE '/var/lib/mysql-files/history_str.csv' IGNORE INTO TABLE history_str FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_log.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_log_old; LOAD DATA INFILE '/var/lib/mysql-files/history_log.csv' IGNORE INTO TABLE history_log FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_text.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_text_old; LOAD DATA INFILE '/var/lib/mysql-files/history_text.csv' IGNORE INTO TABLE history_text FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; ``` * Verify that everything works as supposed * Drop old tables ``` DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ##### Improving performance Additional hints for improving performance in both cases: * Increase bulk_insert_buffer_size buffer in the configuration file inside [mysqld] section or set it before import with SET: ``` [mysqld] bulk_insert_buffer_size=256M mysql cli > SET SESSION bulk_insert_buffer_size= 1024 * 1024 * 256; mysql cli > ... import queries ... ``` * See "Optimizing InnoDB bulk data loading": ([MySQL 5.7]([https://dev.mysql.com/doc/refman/5.7/en/optimizing-innodb-bulk-data-loading.html]), [MySQL 8.0]([https://dev.mysql.com/doc/refman/8.0/en/optimizing-innodb-bulk-data-loading.html])) * Disable binary logging (should not be used in case of a slave servers, since will not replicate data): ``` mysql cli > SET SESSION SQL_LOG_BIN=0; mysql cli > ... import queries ... ``` ### MySQL Export and import must be performed in tmux/screen to ensure that the session isn't dropped. See also: [Important notes](#important-notes) ### MySQL セッションがドロップされないように、エクスポートとインポートは tmux/screen で実行する必要があります。 参照: [重要事項](#important-notes) ### MySQL |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |mysql.db.discovery\[connString, <username>, <password>\]|<|<|<| |List of MySQL databases. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|Result of the "show databases" SQL query in LLD JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.| | |mysql.db.size\[connString, <username>, <password>,dbName\]|<|<|<| |Database size in bytes.|Result of the "select coalesce(sum(data\_length + index\_length),0) as size from information\_schema.tables where table\_schema=?" SQL query for specific database in bytes.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.<br>**dbName** - Database name.| | |mysql.get\_status\_variables\[connString, <username>, <password>\]|<|<|<| |Values of global status variables.|Result of the "show global status" SQL query in JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.| | |mysql.ping\[connString, <username>, <password>\]|<|<|<| |Test if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues).|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.| | |mysql.replication.discovery\[connString, <username>, <password>\]|<|<|<| |List of MySQL replications. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/systemd).|Result of the "show slave status" SQL query in LLD JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.| | |mysql.replication.get\_slave\_status\[connString, <username>, <password>, <masterHost>\]|<|<|<| |Replication status.|Result of the "show slave status" SQL query in JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.<br>**masterHost** - Replication master host name.| | |mysql.version\[connString, <username>, <password>\]|<|<|<| |MySQL version.|String with MySQL instance version.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.| | ### MySQL |キー|<|<|<| |--|--|------|------| |**説明**|**戻り値**|**パラメータ**|**コメント**| |mysql.db.discovery\[connString, <username>, <password>\]|<|<|<| |MySQL データベースのリスト。 [ローレベルディスカバリ] に使用(/manual/discovery/low_level_discovery/examples/systemd).|LLD JSON 形式の"show databases"SQL クエリ結果|**connString** - URIまたはセッション名<br>**username, password** - MySQL 認証情報| | |mysql.db.size\[connString, <username>, <password>,dbName\]|<|<|<| |バイト単位のデータベース サイズ|特定のデータベースに対する"select coalesce(sum(data\_length + index\_length),0) as size from information\_schema.tables where table\_schema=?"SQL クエリの結果 (バイト単位)|**connString** - URIまたはセッション名<br>**username, password** - MySQL認証情報<br>**dbName** - データベース名| | |mysql.get\_status\_variables\[connString, <username>, <password>\]|<|<|<| |グローバル ステータス変数の値|JSON 形式の"show global status"SQLクエリの結果|**connString** - URIまたはセッション名<br>**username, password** - MySQL認証情報| | |mysql.ping\[connString, <username>, <password>\]|<|<|<| |接続が有効かどうか|1 - 有効<br><br>0 - 無効(AUTH や構成の問題など、何らかのエラーが表示される場合)|**connString** - URIまたはセッション名<br>**username, password** - MySQL認証情報| | |mysql.replication.discovery\[connString, <username>, <password>\]|<|<|<| |MySQL レプリケーションのリスト。 [ローレベルディスカバリ] に使用(/manual/discovery/low_level_discovery/examples/systemd).|LLD JSON 形式の"show slave status"SQL クエリの結果|**connString** - URIまたはセッション名<br>**username, password** - MySQL認証情報| | |mysql.replication.get\_slave\_status\[connString, <username>, <password>, <masterHost>\]|<|<|<| |レプリケーションステータス|JSON 形式の"show slave status"SQL クエリの結果|**connString** - URIまたはセッション名<br>**username, password** - MySQL認証情報<br>**masterHost** - レプリケーション マスターのホスト名。| | |mysql.version\[connString, <username>, <password>\]|<|<|<| |MySQLバージョン|MySQL インスタンスのバージョンを含む文字列|**connString** - URIまたはセッション名<br>**username, password** - MySQL認証情報| | #### MySQL/MariaDB **1.** Check the database character set and collation. For example: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | latin2 | latin2 _general_ci | +--------------------------+----------------------+ As we see, the character set here is not 'utf8' and collation is not 'utf8\_bin', so we need to fix them. **2.** Stop Zabbix. **3.** Create a backup copy of the database! **4.** Fix the character set and collation on database level: alter database <your DB name> character set utf8 collate utf8_bin; Fixed values: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | utf8 | utf8_bin | +--------------------------+----------------------+ **5.** Load the [script](https://support.zabbix.com/secure/attachment/113858/113858_utf8_convert.sql) to fix character set and collation on table and column level: mysql <your DB name> < utf8_convert.sql **6.** Execute the script: SET @ZABBIX_DATABASE = '<your DB name>'; If MariaDB → set innodb_strict_mode = OFF; CALL zbx_convert_utf8(); If MariaDB → set innodb_strict_mode = ON; drop procedure zbx_convert_utf8; Note that data encoding will be changed on disk. For example, when converting characters like Æ, Ñ, Ö from 'latin1' to 'utf8' they will go from 1 byte to 2 bytes. Thus the repaired database may require more space than before. **7.** If no errors - you may want to create a database backup copy with the fixed database. **8.** Start Zabbix. #### MySQL/MariaDB **1.** Check the database character set and collation. For example: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | latin2 | latin2 _general_ci | +--------------------------+----------------------+ As we see, the character set here is not 'utf8' and collation is not 'utf8\_bin', so we need to fix them. **2.** Stop Zabbix. **3.** Create a backup copy of the database! **4.** Fix the character set and collation on database level: alter database <your DB name> character set utf8 collate utf8_bin; Fixed values: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | utf8 | utf8_bin | +--------------------------+----------------------+ **5.** Load the [script](https://support.zabbix.com/secure/attachment/113858/113858_utf8_convert.sql) to fix character set and collation on table and column level: mysql <your DB name> < utf8_convert.sql **6.** Execute the script: SET @ZABBIX_DATABASE = '<your DB name>'; If MariaDB → set innodb_strict_mode = OFF; CALL zbx_convert_utf8(); If MariaDB → set innodb_strict_mode = ON; drop procedure zbx_convert_utf8; Note that data encoding will be changed on disk. For example, when converting characters like Æ, Ñ, Ö from 'latin1' to 'utf8' they will go from 1 byte to 2 bytes. Thus the repaired database may require more space than before. **7.** If no errors - you may want to create a database backup copy with the fixed database. **8.** Start Zabbix. #### MySQL/MariaDB Historically, MySQL and derivatives used 'utf8' as an alias for utf8mb3 - MySQL's own 3-byte implementation of the standard UTF8, which is 4-byte. Starting from MySQL 8.0.28 and MariaDB 10.6.1, 'utf8mb3' character set is deprecated and at some point its support will be dropped while 'utf8' will become a reference to 'utf8mb4'. Since Zabbix 6.0, 'utf8mb4' is supported. To avoid future problems, it is highly recommended to use 'utf8mb4'. Another advantage of switching to 'utf8mb4' is support of supplementary Unicode characters. ::: notewarning As versions before Zabbix 6.0 are not aware of utf8mb4, make sure to first upgrade Zabbix server and DB schema to 6.0.x before executing utf8mb4 conversion. ::: **1.** Check the database character set and collation. For example: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | latin2 | latin2 _general_ci | +--------------------------+----------------------+ Or: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | utf8 | utf8_bin | +--------------------------+----------------------+ As we see, the character set here is not 'utf8mb4' and collation is not 'utf8mb4\_bin', so we need to fix them. **2.** Stop Zabbix. **3.** Create a backup copy of the database! **4.** Fix the character set and collation on database level: alter database <your DB name> character set utf8mb4 collate utf8mb4_bin; Fixed values: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | utf8mb4 | utf8mb4_bin | +--------------------------+----------------------+ **5.** Load the [script](../../../../assets/en/manual/appendix/install/utf8mb4_convert.sql) to fix character set and collation on table and column level: mysql <your DB name> < utf8mb4_convert.sql **6.** Execute the script: SET @ZABBIX_DATABASE = '<your DB name>'; If MariaDB → set innodb_strict_mode = OFF; CALL zbx_convert_utf8(); If MariaDB → set innodb_strict_mode = ON; drop procedure zbx_convert_utf8; Please note that 'utf8mb4' is expected to consume slightly more disk space. **7.** If no errors - you may want to create a database backup copy with the fixed database. **8.** Start Zabbix. #### MySQL/MariaDB 歴史的に、MySQLとその派生物はutf8mb3のエイリアスとして「utf8」を使用していました。これはMySQL独自の標準UTF8の3バイト実装であり、4バイトです。 MySQL8.0.28およびMariaDB10.6.1以降、「utf8mb3」キャラクターセットは非推奨になりました。ある時点でサポートが終了し、「utf8」は「utf8mb4」への参照になります。 Zabbix 6.0以降、「utf8mb4」がサポートされています。将来の問題を回避するために、「utf8mb4」を使用することを強くお勧めします。 'utf8mb4'に切り替えるもう1つの利点は、補足Unicode文字をサポートすることです。 ::: notewarning Zabbix 6.0より前のバージョンはutf8mb4を認識しないため、utf8mb4変換を実行する前に、まずZabbixサーバーとDBスキーマを6.0.xにアップグレードしてください。 ::: **1.**データベースのキャラクターセットと照合を確認してください。 実行例： mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | latin2 | latin2 _general_ci | +--------------------------+----------------------+ または： mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | utf8 | utf8_bin | +--------------------------+----------------------+ ご覧のとおり、キャラクターセットは「utf8mb4」ではなく、照合も「utf8mb4\_bin」ではないため、修正する必要があります。 **2.**Zabbixを停止します。 **3.**データベースのバックアップコピーを作成します。 **4.**データベースレベルでキャラクターセットと照合を修正します。 alter database <データベース名> character set utf8mb4 collate utf8mb4_bin; 修正値の確認： mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | utf8mb4 | utf8mb4_bin | +--------------------------+----------------------+ **5.**[スクリプト](../../../../assets/en/manual/appendix/install/utf8mb4_convert.sql)をロードして、テーブルおよび列レベルでの文字セットと照合を修正します。 mysql <データベース名> < utf8mb4_convert.sql **6.**スクリプトを実行します。 SET @ZABBIX_DATABASE='<データベース名>'; MariaDBの場合→set innodb_strict_mode = OFF; CALL zbx_convert_utf8(); MariaDBの場合→set innodb_strict_mode = ON; drop procedure zbx_convert_utf8; 'utf8mb4'はわずかに多くのディスクスペースを消費すると予想されることに注意してください。 **7.**エラーがない場合 - 修正したデータベースのバックアップコピーを作成することをお勧めします。 **8.**Zabbixを起動します。 **MySQL plugin parameters** The following MySQL plugin parameters are no longer mandatory if Plugins.Mysql.Sessions.<SessionName>.TLSConnect is set to *verify_ca* or *verify_full*: - Plugins.Mysql.Sessions.<SessionName>.TLSCertFile - Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile **MySQLプラグインのパラメータ** Plugins.MySQL.Sessions.<SessionName>.TLSConnectが*verify_ca*または*verify_full*に設定されている場合、次のMySQLプラグインパラメーターは必須ではなくなりました。 - Plugins.Mysql.Sessions.<SessionName>.TLSCertFile - Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile ##### MySQL Several user parameters can be used for the monitoring of MySQL in the agent configuration file: /usr/local/etc/zabbix\_agentd.conf ### Set of parameters for monitoring MySQL server (v3.23.42 and later) ### Change -u and add -p if required #UserParameter=mysql.ping,mysqladmin -uroot ping|grep alive|wc -l #UserParameter=mysql.uptime,mysqladmin -uroot status|cut -f2 -d":"|cut -f2 -d" " #UserParameter=mysql.threads,mysqladmin -uroot status|cut -f3 -d":"|cut -f2 -d" " #UserParameter=mysql.questions,mysqladmin -uroot status|cut -f4 -d":"|cut -f2 -d" " #UserParameter=mysql.slowqueries,mysqladmin -uroot status|cut -f5 -d":"|cut -f2 -d" " #UserParameter=mysql.qps,mysqladmin -uroot status|cut -f9 -d":"|cut -f2 -d" " #UserParameter=mysql.version,mysql -V - *mysql.ping* Check whether MySQL is alive. Result: 0 - not started 1 - alive - *mysql.uptime* Number of seconds MySQL is running. - *mysql.threads* Number of MySQL threads. - *mysql.questions* Number of processed queries. - *mysql.slowqueries* Number of slow queries. - *mysql.qps* Queries per second. - *mysql.version* Version of MySQL. For example: mysql Ver 14.14 Distrib 5.1.53, for pc-linux-gnu (i686) For additional information see also the userparameter\_mysql.conf file in conf/zabbix\_agentd directory. ##### MySQL /usr/local/etc/zabbix\_agentd.conf のエージェント設定ファイルで、MySQL の監視にいくつかのユーザー パラメータを使用できます。 ### Set of parameters for monitoring MySQL server (v3.23.42 and later) ### Change -u and add -p if required #UserParameter=mysql.ping,mysqladmin -uroot ping|grep alive|wc -l #UserParameter=mysql.uptime,mysqladmin -uroot status|cut -f2 -d":"|cut -f2 -d" " #UserParameter=mysql.threads,mysqladmin -uroot status|cut -f3 -d":"|cut -f2 -d" " #UserParameter=mysql.questions,mysqladmin -uroot status|cut -f4 -d":"|cut -f2 -d" " #UserParameter=mysql.slowqueries,mysqladmin -uroot status|cut -f5 -d":"|cut -f2 -d" " #UserParameter=mysql.qps,mysqladmin -uroot status|cut -f9 -d":"|cut -f2 -d" " #UserParameter=mysql.version,mysql -V - *mysql.ping* MySQL が稼働しているかどうかを確認します。 結果: 0 - 停止 1 - 稼働 - *mysql.uptime* MySQLの稼働時間(秒) - *mysql.threads* MySQL スレッド数 - *mysql.questions* 処理されたクエリ数 - *mysql.slowqueries* 遅いクエリ数 - *mysql.qps* 1 秒あたりのクエリ数 - *mysql.version* MySQL のバージョン。 例: mysql Ver 14.14 Distrib 5.1.53、pc-linux-gnu (i686) 追加情報については、conf/zabbix\_agentd ディレクトリにある userparameter\_mysql.conf ファイルも参照してください。 ##### Named sessions Named sessions represent an additional level of plugin parameters and can be used to define separate sets of authentication parameters for each of the instances being monitored. Each named session parameter should have the following structure: Plugins.<PluginName>.<SessionName>.<Parameter>=<Value> A session name can be used as a connString item key parameter instead of specifying a URI, username, and password separately. In item keys, the first parameter can be either a connString or a Uri. If the first key parameter matches a session name specified in the configuration file, the check will be executed using named session parameters. If the first key parameter doesn't match any session name, it will be treated as a Uri. Note, that: - when providing a connString (session name) in key parameters, key parameters for username and password must be empty; - passing embedded URI credentials is not supported, consider using named sessions instead; - in case an authentication parameter is not specified for the named session, a hardcoded default value will be used. The list of available named session parameters depends on the plugin, see individual plugin [configuration files](/manual/appendix/config/zabbix_agent2_plugins) for details. **Example:** Monitoring of two instances “MySQL1” and “MySQL2” can be configured in the following way: Plugins.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306 Plugins.Mysql.Sessions.MySQL1.User=<UsernameForMySQL1> Plugins.Mysql.Sessions.MySQL1.Password=<PasswordForMySQL1> Plugins.Mysql.Sessions.MySQL2.Uri=tcp://127.0.0.1:3307 Plugins.Mysql.Sessions.MySQL2.User=<UsernameForMySQL2> Plugins.Mysql.Sessions.MySQL2.Password=<PasswordForMySQL2> Now, these names may be used as connStrings in keys instead of URIs: mysql.ping[MySQL1] mysql.ping[MySQL2] ##### 名前付きセッション 名前付きセッションは、プラグインパラメータの追加レベルを表し、監視対象の各インスタンスに対して個別の認証パラメータ<br> セットを定義するために使用することができます。各名前付きセッションのパラメータは、以下のような構造になっている<br> 必要があります: Plugins.<PluginName>.<SessionName>.<Parameter>=<Value> URI、ユーザー名、パスワードを別々に指定する代わりに、セッション名を connString の item キーパラメーターとして<br> 使用することができます。item キーでは、最初のパラメータは connString または Uri のいずれかにすることができます。<br> 最初のキーパラメータが設定ファイルで指定されたセッション名と一致する場合、名前付きセッションパラメータを使用して<br> チェックが実行されます。最初のキーパラメータがどのセッション名にも一致しない場合、それはUri として扱われます。<br> ただし、: - キーパラメーターに connString (セッション名) を指定する場合、ユーザー名とパスワードのキーパラメーターは空である 必要があります。 - 埋め込み URI の認証情報を渡すことはサポートされていませんので、代わりに名前付きセッションの使用を検討してください。 - 名前付きセッションで認証パラメータが指定されない場合、ハードコードされたデフォルト値が使用されます。 使用可能な名前付きセッションパラメータのリストはプラグインによって異なります。詳細は<br> 各プラグインの [configuration files](/manual/appendix/config/zabbix_agent2_plugins) を参照してください。 **例:** 2つのインスタンス "MySQL1" と "MySQL2" の監視は、以下のように設定することができます。: Plugins.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306 Plugins.Mysql.Sessions.MySQL1.User=<UsernameForMySQL1> Plugins.Mysql.Sessions.MySQL1.Password=<PasswordForMySQL1> Plugins.Mysql.Sessions.MySQL2.Uri=tcp://127.0.0.1:3307 Plugins.Mysql.Sessions.MySQL2.User=<UsernameForMySQL2> Plugins.Mysql.Sessions.MySQL2.Password=<PasswordForMySQL2> これらの名前は、URIの代わりにキーの connString として使用することができます: mysql.ping[MySQL1] mysql.ping[MySQL2] ## NAME zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## 名前 zabbix\_agent2 - Zabbixエージェント2\ \ [ ]{#lbAC} ## NAME zabbix\_agentd - Zabbix agent daemon [ ]{#lbAC} ## 名前 zabbix\_agentd - Zabbixエージェントデーモン [ ]{#lbAC} ## NAME zabbix\_get - Zabbix get utility [ ]{#lbAC} ## 名前 zabbix\_get - Zabbix getユーティリティ [ ]{#lbAC} ## NAME zabbix\_js - Zabbix JS utility [ ]{#lbAC} ## 名前 zabbix\_js - Zabbix JSユーティリティ [ ]{#lbAC} ## NAME zabbix\_proxy - Zabbix proxy daemon [ ]{#lbAC} ## 名前 zabbix\_proxy - Zabbixプロキシデーモン [ ]{#lbAC} ## NAME zabbix\_sender - Zabbix sender utility [ ]{#lbAC} ## 名前 zabbix\_sender - Zabbix senderユーティリティ [ ]{#lbAC} ## NAME zabbix\_server - Zabbix server daemon [ ]{#lbAC} ## 名前 zabbix\_server - Zabbixサーバーデーモン [ ]{#lbAC} ## NAME zabbix\_web\_service - Zabbix web service [ ]{#lbAC} ## 名前 zabbix\_web\_service - Zabbix webサービス [ ]{#lbAC} ##### Naming and location of persistent files Zabbix agent distinguishes active checks by their keys. For example, logrt\[/home/zabbix/test.log\] and logrt\[/home/zabbix/test.log,\] are different items. Modifying the item logrt\[/home/zabbix/test.log,,,10\] in frontend to logrt\[/home/zabbix/test.log,,,20\] will result in deleting the item logrt[/home/zabbix/test.log,,,10] from the agent's list of active checks and creating logrt\[/home/zabbix/test.log,,,20\] item \(some attributes are carried across modification in frontend/server, not in agent\). The file name is composed of MD5 sum of item key with item key length appended to reduce possibility of collisions. For example, the state of logrt\[/home/zabbix50/test.log,,,,,,,,/home/zabbix50/agent_private\] item will be kept in persistent file c963ade4008054813bbc0a650bb8e09266. Multiple log items can use the same value of **persistent\_dir**. **persistent\_dir** is specified by taking into account specific file system layouts, mount points and mount options and storage mirroring configuration - the persistent file should be on the same mirrored filesystem as the monitored log file. If **persistent\_dir** directory cannot be created or does not exist, or access rights for Zabbix agent does not allow to create/write/read/delete files the log item becomes NOTSUPPORTED. ##### 永続ファイルの命名と場所 Zabbix agent は、アクティブなチェックをキーで区別します。例えば、 logrt\[/home/zabbix/test.log\] と <br> logrt\[/home/zabbix/test.log,\] は異なるアイテムです。 フロントエンドの item logrt\[/home/zabbix/test.log,,,10\] を<br> logrt\[/home/zabbix/test.log,,,20\] に変更すると、item logrt\[/home/zabbix/test.log,,,10\] が削除されます。 <br> logrt\[/home/zabbix/test.log,,10\] を agent のアクティブチェックリストから削除し、logrt\[/home/zabbix/test.log,,20\] item を作成します。<br> （いくつかの属性は、agent ではなくフロントエンド/サーバで変更されます） ファイル名は、item キーの MD5 チェックサムと、衝突の可能性を低減するために item キーの長さを付加したものです。 <br> 例えば、 logrt\[/home/zabbix50/test.log,,,,,,/home/zabbix50/agent_private\] item の状態は、<br> 永続ファイル c963ade4008054813bbc0a650bb8e09266 に保存されます。<br> **persistent_dir** は、複数のログ item で同じ値を使用できます。 **persistent_dir** は、特定のファイルシステムのレイアウト、マウントポイント、マウントオプション、ストレージのミラーリング設定を<br> 考慮して指定されます。 **persistent_dir** ディレクトリが作成できないか存在しないか、Zabbix agent のアクセス権でファイルの作成/書き込み/読み取り/削除が<br> できない場合、ログ item はNOTSUPPORTEDになります。 ##### Naming convention Before you create a module, it is important to agree on the naming convention for different module items such as directories and files so that we could keep things well organized. You can also find examples above, in the [Module structure](#module_structure) section. |Item|Naming rules|Example| |----|------------|-------| |*Module directory*|Lowercase \[a-z\], underscore and decimal digits|example\_v2| |*Action subdirectories*|Lowercase \[a-z\] and underscore character|data\_export| |*Action files*|CamelCase, ending with action type|SomethingView.php| |*View and partial files*|Lowercase \[a-z\]<br>Words separated with dot<br>Prefixed by `module.` followed by module name<br>Ending with action type and .php file extension|module.example.something.view.php| |*Javascript files*|The same rules apply as for view and partial files, except the .js.php file extension.|module.example.something.view.js.php| Note that the 'module' prefix and name inclusion is mandatory for view and partial file names, unless you need to override Zabbix core views or partials. This rule, however, does not apply to action file names. ##### 命名規則 モジュールを作成する前に、ディレクトリやファイルなど、モジュールの各項目の命名規則について合意しておくことが重要です。 <br> また、上記の例 [Module structure](#module_structure) の項を参照してください。 <br> |Item|命名ルール|例| |----|------------|-------| |*Module directory*|Lowercase \[a-z\], underscore and decimal digits|example\_v2| |*Action subdirectories*|Lowercase \[a-z\] and underscore character|data\_export| |*Action files*|CamelCase, ending with action type|SomethingView.php| |*View and partial files*|Lowercase \[a-z\]<br>Words separated with dot<br>Prefixed by `module.` followed by module name<br>Ending with action type and .php file extension|module.example.something.view.php| |*Javascript files*|The same rules apply as for view and partial files, except the .js.php file extension.|module.example.something.view.js.php| Zabbixコアのビューまたはパーシャルを上書きする必要がある場合を除き、ビューとパーシャルのファイル名には'module'の <br> プレフィックスと名前のインクルージョンが必須であることに注意してください。 <br> ただし、このルールはアクションファイル名には適用されません。 <br> Navigation tree elements are displayed in a list. You can: - drag an element (including its child elements) to a new place in the list; - expand or collapse an element to display or hide its child elements; - add a child element (with or without a linked map) to an element; - add multiple child elements (with linked maps) to an element; - edit an element; - remove an element (including its child elements).  ナビゲーション ツリー要素はリストに表示されます。次の操作を実行できます: - (子要素を含む)要素をリスト内の新しい場所にドラッグする。 - 要素を展開または折りたたんで子要素を表示または非表示にする。 - リンクマップ付き(またはリンクマップなし)の子要素を要素に追加する。 - (リンクマップを持つ)複数の子要素を要素に追加する。 - 要素を編集する。 - (子要素を含む)要素を削除する。  #### Negative problem duration It is actually possible in some common situations to have negative problem duration i.e. when the problem resolution time is earlier than problem creation time, e. g.: - If some host is monitored by proxy and a network error happens, leading to no data received from the proxy for a while, the nodata(/host/key) trigger will be fired by the server. When the connection is restored, the server will receive item data from the proxy having a time from the past. Then, the nodata(/host/key) problem will be resolved and it will have a negative problem duration; - When item data that resolve the problem event are sent by Zabbix sender and contain a timestamp earlier than the problem creation time, a negative problem duration will also be displayed. ::: noteclassic Negative problem duration is not affecting [SLA calculation](/manual/it_services) or [Availability report](/manual/web_interface/frontend_sections/reports/availability) of a particular trigger in any way; it neither reduces nor expands problem time. ::: #### マイナスの障害期間 いくつかの状況では障害の解決時間が障害の作成時間よりも早いなど、障害の期間がマイナスになる可能性があります。例： - 一部のホストがプロキシによって監視されていて、ネットワークエラーが発生し、しばらくの間プロキシからデータが受信されない場合、サーバーによってnodata(/host/key)トリガーが起動されます。 接続が回復すると、サーバーは過去の時間を持つプロキシからアイテムデータを受信します。 次にnodata(/host/key)障害が解決され、障害の期間がマイナスになります。 - 障害イベントを解決するアイテムデータがZabbix送信者によって送信され、障害作成時刻より前のタイムスタンプが含まれている場合、マイナスの障害期間が表示されます。 ::: noteclassic マイナスの障害期間は、特定のトリガーの[SLA計算](/manual/it_services)または[稼働レポート](/manual/web_interface/frontend_sections/reports/availability)に影響を与えません。 障害期間を短縮も拡大もしません。 ::: #### NetBSD 8.0 and newer Various Zabbix processes may randomly crash on startup on the NetBSD versions 8.X and 9.X. That is due to the too small default stack size (4MB), which must be increased by running: ulimit -s 10240 For more information, please see the related problem report: [ZBX-18275](https://support.zabbix.com/browse/ZBX-18275). #### NetBSD 8.0以降 NetBSDバージョン8.Xおよび9.Xでは、起動時にZabbixのプロセスがランダムにクラッシュする場合があります。これは、デフォルトのスタックサイズ(4MB)が小さすぎることが原因です。以下のコマンドを実行してスタックサイズを増やす必要があります。 ulimit -s 10240 詳細については、関連する問題レポート[ZBX-18275](https://support.zabbix.com/browse/ZBX-18275)を参照してください。 ##### Network data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**net.dns**\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<| |Checks if DNS service is up.|0 - DNS is down (server did not respond or DNS resolution failed)<br><br>1 - DNS is up|**ip** - IP address of DNS server (leave empty for the default DNS server, on Windows supported for Zabbix agent 2, ignored for Zabbix agent)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - number of tries for the request (default is 2)<br>**protocol** (since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (not supported for Zabbix agent on Windows, Zabbix agent 2 on all OS), *HINFO*, *MINFO*, *TXT*, *AAAA*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns*| |**net.dns.record**\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<| |Performs a DNS query.|Character string with the required type of information|**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - number of tries for the request (default is 2)<br>**protocol**(since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns.record\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (not supported for Zabbix agent on Windows, Zabbix agent 2 on all OS), *HINFO*, *MINFO*, *TXT*, *AAAA*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns.query*| |**net.if.collisions**\[if\]|<|<|<| |Number of out-of-window collisions.|Integer|**if** - network interface name| | |**net.if.discovery**|<|<|<| |List of network interfaces. Used for low-level discovery.|JSON object| |Supported since Zabbix 2.0.<br><br>On FreeBSD, OpenBSD and NetBSD supported since Zabbix 2.2.<br><br>Some Windows versions (for example, Server 2008) might require the latest updates installed to support non-ASCII characters in interface names.| |**net.if.in**\[if,<mode>\]|<|<|<| |Incoming traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*frame* - the number of packet framing errors<br>*compressed* - the number of compressed packets received by the device driver<br>*multicast* - the number of multicast frames received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix 1.8.6.<br><br>Examples:<br>=> net.if.in\[eth0,errors\]<br>=> net.if.in\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |**net.if.out**\[if,<mode>\]|<|<|<| |Outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*collisions (colls)* - the number of collisions detected on the interface<br>*carrier* - the number of carrier losses detected by the device driver<br>*compressed* - the number of compressed packets transmitted by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix agent 1.8.6 version.<br><br>Examples:<br>=> net.if.out\[eth0,errors\]<br>=> net.if.out\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |**net.if.total**\[if,<mode>\]|<|<|<| |Sum of incoming and outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*compressed* - the number of compressed packets transmitted or received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Examples:<br>=> net.if.total\[eth0,errors\]<br>=> net.if.total\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.<br><br>Note that dropped packets are supported only if both net.if.in and net.if.out work for dropped packets on your platform.| |**net.tcp.listen**\[port\]|<|<|<| |Checks if this TCP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - TCP port number|Example:<br>=> net.tcp.listen\[80\]<br><br>On Linux supported since Zabbix 1.8.4<br><br>Since Zabbix 3.0.0, on Linux kernels 2.6.14 and above, information about listening TCP sockets is obtained from the kernel's NETLINK interface, if possible. Otherwise, the information is retrieved from /proc/net/tcp and /proc/net/tcp6 files.| |**net.tcp.port**\[<ip>,port\]|<|<|<| |Checks if it is possible to make TCP connection to specified port.|0 - cannot connect<br><br>1 - can connect|**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number|Example:<br>=> net.tcp.port\[,80\] → can be used to test availability of web server running on port 80.<br><br>For simple TCP performance testing use net.tcp.service.perf\[tcp,<ip>,<port>\]<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).| |**net.tcp.service**\[service,<ip>,<port>\]|<|<|<| |Checks if service is running and accepting TCP connections.|0 - service is down<br><br>1 - service is running|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service\[ftp,,45\] → can be used to test the availability of FTP server on TCP port 45.<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.port for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |**net.tcp.service.perf**\[service,<ip>,<port>\]|<|<|<| |Checks performance of TCP service.|Float<br><br>0 - service is down<br><br>seconds - the number of seconds spent while connecting to the service|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service.perf\[ssh\] → can be used to test the speed of initial response from SSH server.<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.service.perf\[tcp,<ip>,<port>\] for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |**net.tcp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<| |Return the number of TCP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *syn\_sent*, *syn\_recv*, *fin\_wait1*, *fin\_wait2*, *time\_wait*, *close*, *close\_wait*, *last\_ack*, *listen*, *closing*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.tcp.socket.count\[,80,,,established\] → returns the number of connections to local TCP port 80 in the *established* state<br><br>This item is supported since Zabbix 6.0.| |**net.udp.listen**\[port\]|<|<|<| |Checks if this UDP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - UDP port number|Example:<br>=> net.udp.listen\[68\]<br><br>On Linux supported since Zabbix 1.8.4| |**net.udp.service**\[service,<ip>,<port>\]|<|<|<| |Checks if service is running and responding to UDP requests.|0 - service is down<br><br>1 - service is running|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service\[ntp,,45\] → can be used to test the availability of NTP service on UDP port 45.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |**net.udp.service.perf**\[service,<ip>,<port>\]|<|<|<| |Checks performance of UDP service.|Float<br><br>0 - service is down<br><br>seconds - the number of seconds spent waiting for response from the service|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service.perf\[ntp\] → can be used to test response time from NTP service.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |**net.udp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<| |Return the number of UDP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *unconn*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.udp.socket.count\[,,,,established\] → returns the number of UDP sockets in the connected state<br><br>This item is supported since Zabbix 6.0.| ##### ネットワークデータ |アイテムキー|<|<|<| |--|--|------|------| |説明|戻り値|パラメータ|コメント| |**net.dns**\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<| |DNS サービスが稼働しているかどうかを確認します|0 - DNS がダウンしています (サーバーが応答しなかったか、DNSの解決に失敗しました)<br><br>1 - DNS がアップしています|**ip** - DNS サーバーの IP アドレス (デフォルトの DNS サーバーの場合は空のままにします。Windows では Zabbix エージェント 2 でサポートされています。Zabbix エージェントでは無視されます)<br>**name** - クエリする DNS 名<br>* *type** - クエリされるレコード タイプ (デフォルトは *SOA*)<br>**timeout** (Zabbix エージェント 2 バージョン 6.0.1 以降を使用しない限り、Windows では無視されます) - 秒単位のリクエストのタイムアウト ( デフォルトは 1 秒)<br>**count** (Zabbix エージェント 2 バージョン 6.0.1 以降を使用しない限り、Windows では無視されます) - リクエストの試行回数 (デフォルトは 2)<br>**プロトコル** (バージョン 3.0 以降) - DNS クエリの実行に使用されるプロトコル: *udp* (デフォルト) または *tcp*|例:<br>=> net.dns\[8.8.8.8,example.com,MX,2,1\]<br><br>`type` の可能な値は次のとおりです。<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA* 、*NULL*、*WKS* (Windows の Zabbix エージェント、すべての OS の Zabbix エージェント 2 ではサポートされていません)、*HINFO*、*MINFO*、*TXT*、*AAAA*、*SRV*<br><br>国際化されたドメイン名はサポートされていません。代わりに IDNA でエンコードされた名前を使用してください。<br><br>SRV レコード タイプは、Zabbix 1.8.6 (Unix) および 2.0.0 (Windows) 以降でサポートされています。<br><br>Zabbix 2.0以前の命名 (引き続きサポートされています): *net.tcp.dns*| |**net.dns.record**\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<| |DNS クエリを実行します|必要な種類の情報を含む文字列|**ip** - DNS サーバーの IP アドレス (デフォルトの DNS サーバーの場合は空のままにします。Zabbix エージェント 2 バージョン 6.0.1 以降を使用しない限り、Windows では無視されます)<br>**name** - クエリする DNS 名< br>**type** - クエリするレコード タイプ (デフォルトは *SOA*)<br>**timeout** (Zabbix エージェント 2 バージョン 6.0.1 以降を使用しない限り、Windows では無視されます) - リクエストのタイムアウト 秒単位 (デフォルトは 1 秒)<br>**count** (Zabbix エージェント 2 バージョン 6.0.1 以降を使用しない限り、Windows では無視されます) - リクエストの試行回数 (デフォルトは 2)<br>** protocol** (バージョン 3.0 以降) - DNS クエリの実行に使用されるプロトコル: *udp* (デフォルト) または *tcp*|例:<br>=> net.dns.record\[8.8.8.8,example.com,MX,2,1\]<br><br>`type` の可能な値は次のとおりです:<br>*ANY* , *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, * WKS* (Windows の Zabbix エージェント、すべての OS の Zabbix エージェント 2 ではサポートされていません)、*HINFO*、*MINFO*、*TXT*、*AAAA*、*SRV*<br><br>国際化されたドメイン名はサポートされていません 代わりに IDNA でエンコードされた名前を使用してください。<br><br>SRV レコード タイプは、Zabbix 1.8.6 (Unix) および 2.0.0 (Windows) 以降でサポートされています。<br><br>Zabbix 2.0 より前の命名 (引き続きサポートされています): *net.tcp.dns.クエリ*| |**net.if.collisions**\[if\]|<|<|<| |ウィンドウ外コリジョン数|Integer|**if** - ネットワーク インターフェース名| | |**net.if.discovery**|<|<|<| |ネットワーク インターフェイスのリスト。 ローレベルディスカバリに使用されます。|JSON オブジェクト| |Zabbix 2.0 以降でサポートされています。<br><br>FreeBSD、OpenBSD、NetBSDはZabbix 2.2以降で対応。<br><br>一部の Windows バージョン (Server 2008 など) では、インターフェース名で非 ASCII 文字をサポートするために、最新の更新プログラムをインストールする必要がある場合があります。| |**net.if.in**\[if,<mode>\]|<|<|<| |ネットワーク インターフェースの受信トラフィック統計|Integer|**if** - ネットワーク インターフェイス名 (Unix); ネットワーク インターフェイスの完全な説明または IPv4 アドレス。 または、中かっこで囲まれている場合は、ネットワーク インターフェース GUID (Windows)<br>**mode** - 使用可能な値:<br>*bytes* - バイト数 (デフォルト)<br>*packets* - パケット数<br> *errors* - エラーの数<br>*dropped* - ドロップされたパケットの数<br>*overruns (fifo)* - FIFO バッファ エラーの数<br>*frame* - パケット フレーミング エラーの数<br> *compressed* - デバイス ドライバーによって送信または受信された圧縮パケットの数<br>*multicast* - デバイス ドライバーによって受信されたマルチキャスト フレームの数|Windows では、アイテムは 64 ビット カウンターから値を取得します (利用可能な場合)。 64 ビット インターフェイス統計カウンターは、Windows Vista および Windows Server 2008 で導入されました。64 ビット カウンターが使用できない場合、エージェントは 32 ビット カウンターを使用します。<br><br>Zabbix 1.8.6 以降、Windows でのマルチバイト インターフェース名がサポートされています。<br><br>例:<br>=> net.if.in\[eth0,errors\]<br>=> net.if.in\[eth0\]<br><br>net.if.discovery または net.if.list アイテムを使用して、Windows でネットワーク インターフェースの説明を取得できます。<br><br>このキーを *Change per second* 前処理ステップで使用して、1 秒あたりのバイト数の統計を取得できます。| |**net.if.out**\[if,<mode>\]|<|<|<| |ネットワーク インターフェースの発信トラフィック統計|Integer|**if** - ネットワーク インターフェイス名 (Unix); ネットワーク インターフェイスの完全な説明または IPv4 アドレス。 または、中かっこで囲まれている場合は、ネットワーク インターフェース GUID (Windows)<br>**mode** - 使用可能な値:<br>*bytes* - バイト数 (デフォルト)<br>*packets* - パケット数<br> *errors* - エラーの数<br>*dropped* - ドロップされたパケットの数<br>*overruns (fifo)* - FIFO バッファ エラーの数<br>*collisions (colls)* - 検出された衝突の数 インターフェイス<br>*carrier* - デバイス ドライバによって検出されたキャリア損失の数<br>*compressed* - デバイス ドライバによって送信された圧縮パケットの数|Windows では、アイテムは 64 ビット カウンターから値を取得します (利用可能な場合)。 64 ビット インターフェイス統計カウンターは、Windows Vista および Windows Server 2008 で導入されました。64 ビット カウンターが使用できない場合、エージェントは 32 ビット カウンターを使用します。<br><br>Zabbix エージェント 1.8.6 バージョン以降、Windows でのマルチバイト インターフェイス名がサポートされています。<br><br>例:<br>=> net.if.out\[eth0,errors\]<br>=> net.if.out\[eth0\]<br><br>net.if.discovery または net.if.list アイテムを使用して、Windows でネットワーク インターフェイスの説明を取得できます。<br><br>このキーを *Change per second* 前処理ステップで使用して、1 秒あたりのバイト数の統計を取得できます。| |**net.if.total**\[if,<mode>\]|<|<|<| |ネットワーク インターフェイスの着信および発信トラフィック統計の合計|Integer|**if** - ネットワーク インターフェイス名 (Unix); ネットワーク インターフェイスの完全な説明または IPv4 アドレス。 または、中かっこで囲まれている場合は、ネットワーク インターフェース GUID (Windows)<br>**mode** - 使用可能な値:<br>*bytes* - バイト数 (デフォルト)<br>*packets* - パケット数<br> *errors* - エラーの数<br>*dropped* - ドロップされたパケットの数<br>*overruns (fifo)* - FIFO バッファ エラーの数<br>*compressed* - デバイス ドライバーによって送受信された圧縮パケットの数|Windows では、アイテムは 64 ビット カウンターから値を取得します (利用可能な場合)。 64 ビット インターフェイス統計カウンターは、Windows Vista および Windows Server 2008 で導入されました。64 ビット カウンターが使用できない場合、エージェントは 32 ビット カウンターを使用します。<br><br>例:<br>=> net.if.total\[eth0,errors\]<br>=> net.if.total\[eth0\]<br><br>net.if.discovery または net.if.list アイテムを使用して、Windows でネットワーク インターフェイスの説明を取得できます。<br><br>このキーを *Change per second* 前処理ステップで使用して、1 秒あたりのバイト数の統計を取得できます。<br><br>ドロップされたパケットは、net.if.in と net.if.out の両方がプラットフォーム上でドロップされたパケットに対して機能する場合にのみサポートされることに注意してください。| |**net.tcp.listen**\[port\]|<|<|<| |この TCP ポートが LISTEN 状態かどうかを確認します|0 - LISTEN 状態ではありません<br><br>1 - LISTEN 状態です|**port** - TCP ポート番号|例:<br>=> net.tcp.listen\[80\]<br><br>Zabbix 1.8.4 以降でサポートされている Linux の場合<br><br>Zabbix 3.0.0 以降、Linux カーネル 2.6.14 以降では、TCP ソケットのリスニングに関する情報は、可能であればカーネルの NETLINK インターフェイスから取得されます。 それ以外の場合、情報は /proc/net/tcp および /proc/net/tcp6 ファイルから取得されます。| |**net.tcp.port**\[<ip>,port\]|<|<|<| |指定したポートに TCP 接続できるかどうかをチェックします|0 - 接続できません<br><br>1 - 接続できます|**ip** - IP または DNS 名 (デフォルトは 127.0.0.1)<br>* *ポート** - ポート番号|例:<br>=> net.tcp.port\[,80\] → ポート 80 で実行されている Web サーバーの可用性をテストするために使用できます。<br><br>単純な TCP パフォーマンス テストには、net.tcp.service.perf\[tcp,<ip>,<port>\] を使用します。<br><br>これらのチェックにより、システム デーモンのログファイルに追加のメッセージが記録される場合があることに注意してください (通常、SMTP および SSH セッションがログに記録されます)| |**net.tcp.service**\[service,<ip>,<port>\]|<|<|<| |サービスが実行中であり、TCP 接続を受け入れているかどうかを確認します。|0 - サービスがダウンしています<br><br>1 - サービスが実行されています|**service** - 次のいずれか:<br>*ssh*、*ldap*、*smtp*、*ftp*、*http*、*pop*、*nntp*、*imap*、*tcp*、*https *, *telnet* ([詳細](/manual/appendix/items/service_check_details) を参照)<br>**ip** - IP アドレス (デフォルトは 127.0.0.1)<br>**port** - ポート番号 (デフォルトでは、標準のサービス ポート番号が使用されます)|例:<br>=> net.tcp.service\[ftp,,45\] → TCP ポート 45 で FTP サーバーの可用性をテストするために使用できます。<br><br>これらのチェックにより、システム デーモンのログファイルに追加のメッセージが記録される場合があることに注意してください (通常、SMTP および SSH セッションがログに記録されます)。<br><br>暗号化されたプロトコル (ポート 993 の IMAP やポート 995 の POP など) のチェックは現在サポートされていません。 回避策として、このようなチェックには net.tcp.port を使用してください。<br><br>Windows での LDAP と HTTPS のチェックは、Zabbix エージェント 2 でのみサポートされています。<br><br>telnet チェックでは、ログイン プロンプト (末尾の「:」) が検索されることに注意してください。<br><br>HTTPS サービスの確認については、[既知の問題](/manual/installation/known_issues#https_checks)も参照してください。<br><br>*https* および *telnet* サービスは、Zabbix 2.0 以降でサポートされています。| |**net.tcp.service.perf**\[service,<ip>,<port>\]|<|<|<| |TCP サービスのパフォーマンスをチェックします。|0 - サービスがダウンしています<br><br>seconds - サービスへの接続にかかった秒数|**サービス** - 次のいずれか:<br>*ssh*、*ldap*、*smtp*、*ftp*、*http*、*pop*、*nntp*、*imap*、*tcp*、*https*, *telnet* ([詳細](/manual/appendix/items/service_check_details) を参照)<br>**ip** - IP アドレス (デフォルトは 127.0.0.1)<br>**port** - ポート番号 (デフォルトでは、標準のサービス ポート番号が使用されます)|例:<br>=> net.tcp.service.perf\[ssh\] → SSH サーバーからの初期応答速度をテストするために使用できます。<br><br>暗号化されたプロトコル (ポート 993 の IMAP やポート 995 の POP など) のチェックは現在サポートされていません。 回避策として、このようなチェックには net.tcp.service.perf\[tcp,<ip>,<port>\] を使用してください。<br><br>Windows での LDAP と HTTPS のチェックは、Zabbix エージェント 2 でのみサポートされています。<br><br>telnet チェックでは、ログイン プロンプト (末尾の「:」) が検索されることに注意してください。<br><br>HTTPS サービスの確認については、[既知の問題](/manual/installation/known_issues#https_checks)も参照してください。<br><br>*https* および *telnet* サービスは、Zabbix 2.0 以降でサポートされています。| |**net.tcp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<| |パラメータに一致する TCP ソケットの数を返します。|Integer|**laddr** - ローカル IPv4/6 アドレスまたは CIDR サブネット<br>**lport** - ローカル ポート番号またはサービス名<br>**raddr** - リモート IPv4/6 アドレスまたは CIDR サブネット<br>**rport** - リモート ポート番号またはサービス名<br>**state** - 接続状態(*established*, *syn\_sent*, *syn\_recv*, *fin\_wait1*, *fin\_wait2*, *time\_wait*, *close*, *close\_wait*, *last\_ack*, *listen*, *closing*)|この項目は、Zabbix エージェント/エージェント 2 の両方の Linux でのみサポートされています。Zabbix エージェント 2 では、64 ビット Windows でもサポートされています。<br><br>例:<br>=> net.tcp.socket.count\[,80,,,established\] → ローカル TCP ポート 80 が「確立」状態かどうかを確認する<br><br>この項目は Zabbix 6.0 以降でサポートされています。| |**net.udp.listen**\[port\]|<|<|<| |この UDP ポートが LISTEN 状態かどうかを確認します。|0 - LISTEN 状態ではありません<br><br>1 - LISTEN 状態です|**port** - UDP ポート番号|例:<br>=> net.udp.listen\[68\]<br><br>Zabbix 1.8.4 以降でサポートされている Linux の場合| |**net.udp.service**\[service,<ip>,<port>\]|<|<|<| |サービスが実行中で、UDP 要求に応答しているかどうかを確認します。|0 - サービスがダウンしています<br><br>1 - サービスは実行中です|**サービス** - *ntp* ([詳細](/manual/appendix/items/service_check_details) を参照)<br>**ip** - IP アドレス (デフォルトは 127.0.0.1)<br>**port** - ポート番号 (デフォルトでは標準サービスのポート番号が使用されます)|例：<br>=> net.udp.service\[ntp,,45\] → UDP ポート 45 で NTP サービスの可用性をテストするために使用できます。<br><br>このアイテムは Zabbix 3.0.0 以降でサポートされていますが、以前のバージョンでは net.tcp.service\[\] アイテムに対して *ntp* サービスが利用可能でした。| |**net.udp.service.perf**\[service,<ip>,<port>\]|<|<|<| |UDP サービスのパフォーマンスをチェックします。|0 - サービスがダウンしています<br><br>seconds - サービスからの応答を待機するのに費やされた秒数|**service** - *ntp* ([詳細](/manual/appendix/items/service_check_details) を参照)<br>**ip** - IP アドレス (デフォルトは 127.0.0.1)<br>**port** - ポート番号 (デフォルトでは標準サービスのポート番号が使用されます)|例:<br>=> net.udp.service.perf\[ntp\] → NTP サービスからの応答時間をテストするために使用できます。<br><br>このアイテムは Zabbix 3.0.0 以降でサポートされていますが、*ntp * サービスは以前のバージョンの net.tcp.service\[\] アイテムで利用できました。| |**net.udp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<| |パラメータに一致する TCP ソケットの数を返します|Integer|**laddr** - ローカル IPv4/6 アドレスまたは CIDR サブネット<br>**lport** - ローカル ポート番号またはサービス名<br>**raddr** - リモート IPv4/6 アドレスまたは CIDR サブネット<br>* *rport** - リモート ポート番号またはサービス名<br>**state** - 接続状態(*established*, *unconn*)|この項目は、Zabbix エージェント/エージェント 2 の両方の Linux でのみサポートされています。Zabbix エージェント 2 では、64 ビット Windows でもサポートされています。<br><br>例:<br>=> net.udp.socket.count\ [,,,,listening\] → UDP ソケットが"listening"状態にあるかどうかを確認します<br><br>この項目は Zabbix 6.0 以降でサポートされています。| #### Network discovery In a [network discovery rule](/manual/discovery/network_discovery/rule), user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Update interval|<|no| |*SNMP v1, v2*|<|<| | |SNMP community|yes| |^|SNMP OID|yes| |*SNMP v3*|<|<| | |Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |^|SNMP OID|yes| #### ネットワークディスカバリ [ネットワークディスカバリルール](/manual/discovery/network_discovery/rule) では、次のフィールドでユーザー マクロを使用できます。 |ロケーション|<|複数のマクロ/テキストとの混合^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |監視間隔|<|no| |*SNMP v1, v2*|<|<| | |SNMP コミュニティ|yes| |^|SNMP OID|yes| |*SNMP v3*|<|<| | |コンテキスト名|yes| |^|セキュリティ名|yes| |^|認証パスフレーズ|yes| |^|プライバシーパスフレーズ|yes| |^|SNMP OID|yes| #### Network discovery Manage network-level discovery rules to automatically find and monitor new hosts. Gain full access to information about discovered services and hosts. [Discovery rule API](/manual/api/reference/drule) | [Discovery check API](/manual/api/reference/dcheck) | [Discovered host API](/manual/api/reference/dhost) | [Discovered service API](/manual/api/reference/dservice) #### ネットワークディスカバリ ネットワークレベルの検出ルールを管理し、新しいホストを自動的に検出して監視します。検出されたサービスとホストに関する情報に完全にアクセスできます。 [Discovery rule API](/manual/api/reference/drule) | [Discovery check API](/manual/api/reference/dcheck) | [Discovered host API](/manual/api/reference/dhost) | [Discovered service API](/manual/api/reference/dservice) ### New functions ### Items #### New index on auditlog table A new index has been added to the `auditlog` table to improve database and frontend response times when filtering records by *Recordset ID* in the [Audit log](/manual/web_interface/frontend_sections/reports/audit). Note that users with large audit logs may experience extended upgrade times due to the database size. #### 監査ログテーブルの新しいインデックス 新しいインデックスが`auditlog`テーブルに追加され、[監査ログ](/manual/web_interface/frontend_sections/reports/audit)内の*Recordset ID*でレコードをフィルタリングする際のデータベースとフロントエンドの応答時間が改善されました。 大規模な監査ログを持つユーザーは、データベースサイズが原因でアップグレード時間が長くなる可能性があることに注意してください。 #### New item for PostgreSQL Zabbix agent 2 plugin New [item](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#postgresql), **pgsql.version**, has been added to PostgreSQL Zabbix agent 2 plugin. This item is used for returning the PostgreSQL version. #### Zabbixエージェント2のPostgreSQLプラグインに新しいアイテム Zabbixエージェント2のPostgreSQLプラグインに**pgsql.version**という[アイテム](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#postgresql)が追加されました。このアイテムはPostgreSQLのバージョンを返すのに使います。 #### New item for Zabbix agent 2 A new item has been added to MySQL plugin for Zabbix agent 2. This new item, [mysql.custom.query](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mysql), can be used for executing custom MySQL queries. #### Zabbixエージェント2の新しいアイテム Zabbixエージェント2のMySQLプラグインに新しいアイテムが追加されました。この新しいアイテム[mysql.custom.query](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mysql)は、カスタムMySQLクエリを実行するためのものです。 #### New items in Zabbix agent 2 plugins The items for returning the database server version are now available in [MongoDB plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) ([`mongodb.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb)) and [Oracle Database plugin](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle/README.md?at=refs%2Fheads%2Frelease%2F6.0) ([`oracle.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#oracle)). #### Zabbixエージェント2プラグインの新しいアイテム データベースサーバーのバージョンを返すアイテムが[MongoDBプラグイン](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) ([`mongodb.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb))と[Oracle Databaseプラグイン](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle/README.md?at=refs%2Fheads%2Frelease%2F6.0) ([`oracle.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#oracle))で利用可能になりました。 #### New macros New macros are now supported for trigger expression debugging and internal actions. Expression debugging macros simplify the process of debugging trigger expressions: - {TRIGGER.EXPRESSION.EXPLAIN}, {TRIGGER.EXPRESSION.RECOVERY.EXPLAIN} - resolve to a partially evaluated trigger or recovery expression, where only item-based functions are applied; - {FUNCTION.VALUE<1-9>}, {FUNCTION.RECOVERY.VALUE<1-9>} - resolve to the results of the Nth item-based function at the time of the event. #### 新しいマクロ トリガー式のデバッグと内部動作のための新しいマクロがサポートされました。 デバッグ用マクロは、トリガー条件式のデバッグを簡素化します: - {TRIGGER.EXPRESSION.EXPLAIN}, {TRIGGER.EXPRESSION.RECOVERY.EXPLAIN} - これらは、アイテムベースの関数のみに適用され、部分的に評価されたトリガー式またはリカバリートリガー式に展開されます。 - {FUNCTION.VALUE<1-9>}, {FUNCTION.RECOVERY.VALUE<1-9>} - これらは、その時のN番目のアイテムベースの関数の結果に展開されます。 #### New macros New macros are now supported for trigger expression debugging and internal actions. Expression debugging macros simplify the process of debugging trigger expressions: - {TRIGGER.EXPRESSION.EXPLAIN}, {TRIGGER.EXPRESSION.RECOVERY.EXPLAIN} - resolve to a partially evaluated trigger or recovery expression, where only item-based functions are applied; - {FUNCTION.VALUE<1-9>}, {FUNCTION.RECOVERY.VALUE<1-9>} - resolve to the results of the Nth item-based function at the time of the event. ### Positional macros no longer supported The support for positional macros in item name ($1, $2...$9), deprecated since Zabbix 4.0, has been fully removed. #### New templates A new template is available: - [Jira Data Center by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring Jira Data Center health. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート 新しいテンプレートが利用可能になりました: - [Jira Data Center by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx?at=refs%2Fheads%2Frelease%2F6.0), Jira Data Centerの健全性を監視するためのテンプレート。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates A new template is available: - [Oracle Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud?at=refs%2Fheads%2Frelease%2F6.0), a master template that discovers various Oracle Cloud Infrastructure (OCI) services and resources. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート 新しいテンプレートが利用可能になりました: - [Oracle Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud?at=refs%2Fheads%2Frelease%2F6.0), さまざまなOracle Cloud Infrastructure (OCI)サービスおよびリソースを検出するマスターテンプレート。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates A new template is available: - [YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http?at=refs%2Fheads%2Frelease%2F6.0), which includes the *YugabyteDB Cluster by HTTP* template for monitoring each YugabyteDB cluster. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート 新しいテンプレートが利用可能になりました: - [YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http?at=refs%2Fheads%2Frelease%2F6.0), 各YugabyteDBクラスターを監視するための*YugabyteDB Cluster by HTTP*テンプレートが含まれます。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates - [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_function_lambda_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring AWS Lambda metrics. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_function_lambda_http?at=refs%2Fheads%2Frelease%2F6.0) AWS Lambdaメトリクスを監視するためのテンプレート。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates - [GitHub repository by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring GitHub repositories. - [Microsoft 365 reports by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring Microsoft 365 services. You can get these templates: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート - [GitHub repository by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http?at=refs%2Fheads%2Frelease%2F6.0) - GitHubリポジトリを監視するためのテンプレート。 - [Microsoft 365 reports by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http?at=refs%2Fheads%2Frelease%2F6.0) - Microsoft 365 サービスを監視するためのテンプレート。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates - [Huawei OceanStor V6 by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/huawei_oceanstor_v6_snmp?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring SAN Huawei OceanStor V6. #### 新しいテンプレート - [Huawei OceanStor V6 by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/huawei_oceanstor_v6_snmp?at=refs%2Fheads%2Frelease%2F6.0)、SAN Huawei OceanStor V6を監視するためのテンプレート。 #### New templates New template is available: - [HPE iLO by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http?at=refs%2Fheads%2Frelease%2F6.0) You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート 新しいテンプレートが利用可能になりました: - [HPE iLO by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http?at=refs%2Fheads%2Frelease%2F6.0) テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates New templates are available: - [AWS ELB Application Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0) - [Check Point Next Generation Firewall by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/checkpoint/quantum_ngfw_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) You can get these templates: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート 新しいテンプレートが利用可能になりました: - [AWS ELB Application Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0) - [Check Point Next Generation Firewall by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/checkpoint/quantum_ngfw_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates New templates are available: - [FortiGate by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http?at=refs%2Fheads%2Frelease%2F6.0) - [FortiGate by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [Nextcloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud?at=refs%2Fheads%2Frelease%2F6.0) You can get these templates: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート 新しいテンプレートが利用可能になりました: - [FortiGate by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http?at=refs%2Fheads%2Frelease%2F6.0) - [FortiGate by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [Nextcloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud?at=refs%2Fheads%2Frelease%2F6.0) テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates - [Nutanix Prism Element by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http?at=refs%2Fheads%2Frelease%2F6.0), a template set that also includes the templates *Nutanix Cluster Prism Element by HTTP* and *Nutanix Host Prism Element by HTTP*. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート - [Nutanix Prism Element by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http?at=refs%2Fheads%2Frelease%2F6.0), *Nutanix Cluster Prism Element by HTTP*および*Nutanix Host Prism Element by HTTP*のテンプレートも含まれるテンプレートセット。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 ##### New templates See the list of [new templates](/manual/introduction/whatsnew600#templates) in Zabbix 6.0.0. ##### 新しいテンプレート Zabbix 6.0.0の[新しいテンプレート](/manual/introduction/whatsnew600#テンプレート)リストを参照してください。 #### New templates The AWS ELB template set has been supplemented with the template [AWS ELB Network Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0). You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート AWS ELBテンプレートセットに、テンプレート[AWS ELB Network Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0)が追加されました。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates - The [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) template set has been supplemented with the template *Azure SQL Managed Instance by HTTP*. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート - [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0)テンプレートセットには、テンプレート*Azure SQL Managed Instance by HTTP*によってインスタンスが追加されています。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates The set of [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) templates has been supplemented with the Azure Cost Management by HTTP template. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0)テンプレートのセットは、Azure Cost Management by HTTPテンプレートで補足されました。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates The set of [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) templates has been supplemented with the Azure VM Scale Set by HTTP template. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0)テンプレートのセットは、Azure VM Scale Set by HTTP テンプレートで補足されました。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 #### New templates - The template set [Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0) has been supplemented with the templates *Zabbix server health by Zabbix agent*, *Zabbix server health by Zabbix agent active*, and [Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0) - with *Zabbix proxy health by Zabbix agent* and *Zabbix proxy health by Zabbix agent active*, enabling the monitoring of internal Zabbix metrics via Zabbix agent. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### 新しいテンプレート - テンプレートセット[Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0)はテンプレート*Zabbix server health by Zabbix agent*、*Zabbix server health by Zabbix agent active*および[Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0)によって補完されています。 - *Zabbix proxy health by Zabbix agent*および*Zabbix proxy health by Zabbix agent active*を使用して、Zabbixエージェントを介した内部Zabbixメトリックの監視を可能にします。 テンプレートの入手方法: - Zabbixを新規にインストールした場合、*設定* → *テンプレート*にすでにあります。 - 以前のバージョンからアップグレードした場合、最新のテンプレートをZabbix [Gitリポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0)からダウンロードし、*設定* → *テンプレート*セクションで手動でZabbixにインポートします。同じ名前のテンプレートがすでに存在する場合は、インポートする前に*存在しない場合に削除*オプションをチェックすることでクリーンなインポートができます。この方法で、更新されたテンプレートから除外されたアイテムおよびそのヒストリは削除されます。 ##### Non-primitive data types Since Zabbix 4.0.0 it is possible to work with custom MBeans returning non-primitive data types, which override the **toString()** method. ##### 非プリミティブなデータ型 Zabbix 4.0.0以降、**toString()**メソッドをオーバーライドした非プリミティブなデータ型を返すカスタムMBeansを使用することができます。 ### Notation ### 表記法 ::: noteclassic If installing from [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), you need to run: `$ make dbschema` prior to proceeding to the next steps. ::: ::: noteclassic Zabbix Git[リポジトリ](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse)からインストールする場合は、次のステップに進む前に以下を実行する必要があります。 `$ make dbschema` ::: ::: noteclassic Please be aware that after upgrading some third-party software integrations in Zabbix might be affected, if the external software is not compatible with the upgraded Zabbix version. ::: ::: noteclassic 外部ソフトウェアがアップグレードしたZabbixのバージョンと互換性がない場合、アップグレード後にZabbixの一部のサードパーティソフトウェア統合が影響を受ける可能性があることに注意してください。 ::: ::: noteimportant Deprecated widgets will be removed in the upcoming major release. ::: ::: noteimportant 非推奨のウィジェットは、今後のメジャーリリースで削除される予定です。 ::: ::: noteimportant Deprecated widgets will be removed in the upcoming major release. ::: ::: noteimportant 非推奨のウィジェットは、今後のメジャーリリースで削除される予定です。 ::: ::: noteimportant For SourceIP support in LDAP simple checks (e.g. `net.tcp.service[ldap]`), OpenLDAP version 2.6.1 or above is required. SourceIP is supported in LDAP simple checks since Zabbix 6.0.1. ::: ::: noteimportant LDAPシンプルチェック(例: `net.tcp.service[ldap]`) でSourceIPをサポートするには、OpenLDAPバージョン2.6.1<br> またはそれ以上が必要です。SourceIPはZabbix 6.0.1以降、LDAPシンプルチェックでサポートされています。 ::: ::: noteimportant The instructions provided on this page are designed for advanced users and may need to be adjusted for your specific configuration. Upgrading to primary keys can be time-consuming and resource-intensive. Ensure that enough free disk space is available; depending on your database size and stored data, the process may require up to 2.5 times the space currently used by history tables. ::: ::: 重要 このページに記載されている手順は上級ユーザー向けであり、お客様の構成に合わせて調整する必要がある場合があります。 主キーへのアップグレードは時間がかかり、多くのリソースを消費する可能性があります。 十分な空きディスク容量があることを確認してください。データベースのサイズと保存データによっては、このプロセスに現在履歴テーブルで使用されている容量の最大2.5倍が必要になる場合があります。 ::: ::: noteimportant This widget is deprecated and will be removed in the upcoming major release. Consider using the [*Top hosts*](/manual/api/reference/dashboard/widget_fields/top_hosts) widget instead. ::: ::: noteimportant このウィジェットは非推奨であり、今後のメジャーリリースで削除される予定です。代わりに[*上位ホスト*](/manual/api/reference/dashboard/widget_fields/top_hosts)ウィジェットの使用を検討してください。 ::: ::: noteimportant This widget is deprecated and will be removed in the upcoming major release. Consider using the [*Top hosts*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts) widget instead. ::: ::: noteimportant このウィジェットは非推奨であり、今後のメジャーリリースで削除される予定です。代わりに[*上位ホスト*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts)ウィジェットの使用を検討してください。 ::: ::: noteimportant When creating a maintenance period, the [time zone](/manual/web_interface/time_zone) of the user who creates it is used. However, when recurring maintenance periods (*Daily*, *Weekly*, *Monthly*) are scheduled, the time zone of the Zabbix server is used. To ensure predictable behavior of recurring maintenance periods, it is required to use a common time zone for all parts of Zabbix. ::: ::: noteimportant メンテナンス期間の作成時には、作成したユーザーの[タイムゾーン](/manual/web_interface/time_zone)が使用されます。 ただし、定期的なメンテナンス期間 (*毎日*、*毎週*、*毎月*) がスケジュールされた場合は、Zabbix サーバーのタイムゾーンが使用されます。 定期的なメンテナンス期間の動作を保証するには、Zabbixのすべての部分で共通のタイム ゾーンを使用する必要があります。 ::: Notes for AIX: 1. When choosing parameters for proc.mem[] item key on AIX, try to specify narrow process selection criteria. Otherwise there is a risk of getting unwanted processes counted into proc.mem[] result. Example: ``` $ zabbix_agentd -t proc.mem[,,,NonExistingProcess,rss] proc.mem[,,,NonExistingProcess,rss] [u|2879488] ``` This example shows how specifying only command line (regular expression to match) parameter results in Zabbix agent self-accounting - probably not what you want. AIX に関する注意事項: 1. AIX で proc.mem[] 項目キーのパラメータを選択する際は、プロセス選択基準を絞り込むようにしてください。そうしないと、 proc.mem[] の結果に不要なプロセスがカウントされてしまうおそれがあります。 例: ``` $ zabbix_agentd -t proc.mem[,,,NonExistingProcess,rss] proc.mem[,,,NonExistingProcess,rss] [u|2879488] ``` この例では、コマンドラインで（正規表現で一致させた）パラメータのみを指定すると、Zabbix エージェントが自分のプロセスを検知してしまう結果を表示しています。これはおそらく望ましい結果ではありません。 ##### Notes on connection termination If IPMI checks are not performed (by any reason: all host IPMI items disabled/notsupported, host disabled/deleted, host in maintenance etc.) the IPMI connection will be terminated from Zabbix server or proxy in 3 to 4 hours depending on the time when Zabbix server/proxy was started. ##### 接続終了時の注意事項 IPMIチェックが行われなかった場合(何らかの理由: ホストのIPMI項目が全て無効/サポートされていない、<br> ホストが無効/削除された、ホストがメンテナンス中であるなど)<br> Zabbix server / proxy を起動した時間に応じて3～4時間後にZabbix server / proxy からIPMI接続が切断されます。 #### Notes on discovered performance counter items on NUMA systems Some [Windows performance counters](/manual/config/items/perfcounters) might be not available for some of the logical processors at NUMA systems. For example, items discovered with an item prototype with the key below might work only for the first NUMA node. Items for the other NUMA nodes might be in unsupported state. ``` perf_counter[\Processor({#CPU.NUMBER})\% Processor Time,60] ``` Also, a discovery rule with key "system.cpu.discovery" does not provide any low-level discovery macro values to substitute into such performance counters as: ``` perf_counter["\Processor Information(<NUMA node index>,<CPU index in NUMA node>)\% Processor Time",60] ``` While [system.cpu.util](/manual/appendix/items/system_cpu_util) items rely on different performance counters to monitor CPU utilization percentage depending on the processor group count and processor count. Also, there is a rare bug related to [processor groups on Windows](/manual/installation/known_issues#win-proc-groups). #### NUMA システムで検出されたパフォーマンスカウンター項目に関する注意事項 一部の [Windows パフォーマンスカウンター](/manual/config/items/perfcounters) は、NUMA システムの論理プロセッサの一部では使用できない場合があります。 例えば、以下のキーを持つアイテムプロトタイプで検出されたアイテムは、最初の NUMA ノードでのみ機能する可能性があります。他の NUMA ノードの項目はサポートされていない可能性があります。 ``` perf_counter[\Processor({#CPU.NUMBER})\% Processor Time,60] ``` また、キー"system.cpu.discovery"を持つ検出ルールでは、以下のパフォーマンスカウンターに代入するための低レベルの検出マクロ値は提供されません。 ``` perf_counter["\Processor Information(<NUMA node index>,<CPU index in NUMA node>)\% Processor Time",60] ``` [system.cpu.util](/manual/appendix/items/system_cpu_util) 項目は、プロセッサグループ数とプロセッサ数に応じて異なるパフォーマンスカウンターを使用してCPU使用率を監視します。 また、[Windowsのプロセッサグループ](/manual/installation/known_issues#win-proc-groups)に関連するレアなバグが報告されています。 ##### Notes on discrete sensor names in OpenIPMI-2.0.16, 2.0.17, 2.0.18 and 2.0.19 Names of discrete sensors in OpenIPMI-2.0.16, 2.0.17 and 2.0.18 often have an additional "`0`" (or some other digit or letter) appended at the end. For example, while `ipmitool` and OpenIPMI-2.0.19 display sensor names as "`PhysicalSecurity`" or "`CATERR`", in OpenIPMI-2.0.16, 2.0.17 and 2.0.18 the names are "`PhysicalSecurity0`" or "`CATERR0`", respectively. When configuring an IPMI item with Zabbix server using OpenIPMI-2.0.16, 2.0.17 and 2.0.18, use these names ending with "0" in the *IPMI sensor* field of IPMI agent items. When your Zabbix server is upgraded to a new Linux distribution, which uses OpenIPMI-2.0.19 (or later), items with these IPMI discrete sensors will become "NOT SUPPORTED". You have to change their *IPMI sensor* names (remove the '0' in the end) and wait for some time before they turn "Enabled" again. ##### OpenIPMI-2.0.16, 2.0.17, 2.0.18, 2.0.19 のディスクリートセンサーの名前に関する注意事項 OpenIPMI-2.0.16, 2.0.17, 2.0.18 のディスクリートセンサーの名前には"`0`" (または他の数字や文字) を<br> 末尾に付加していることがよくあります。<br> 例えば、`ipmitool` と OpenIPMI-2.0.19 では、センサーの名前は "`PhysicalSecurity`" や "`CATERR`" のように表示されます。<br> OpenIPMI-2.0.16, 2.0.17, 2.0.18 では "`PhysicalSecurity0`" または "`CATERR0`" と表示されます。<br> OpenIPMI-2.0.16、2.0.17、2.0.18を使用してZabbixサーバでIPMI item を設定する場合、<br> IPMIエージェントアイテムの*IPMI sensor*フィールドにこれらの名前を0として使用してください。<br> ZabbixサーバをOpenIPMI-2.0.19(またはそれ以降)を使用する新しいLinuxディストリビューションにアップグレードした場合、<br> これらのIPMIセンサーのアイテムは「NOT SUPPORTED」になります。そのため<br> IPMIセンサー名を変更し（末尾の'0'を削除）、再び "Enabled "になる前に、しばらく待つ必要があります。 #### Notes on handling 'copytruncate' log file rotation `logrt` with the `copytruncate` option assumes that different log files have different records (at least their timestamps are different), therefore MD5 sums of initial blocks (up to the first 512 bytes) will be different. Two files with the same MD5 sums of initial blocks means that one of them is the original, another - a copy. `logrt` with the `copytruncate` option makes effort to correctly process log file copies without reporting duplicates. However, things like producing multiple log file copies with the same timestamp, log file rotation more often than logrt\[\] item update interval, frequent restarting of agent are not recommended. The agent tries to handle all these situations reasonably well, but good results cannot be guaranteed in all circumstances. #### 'copytruncate' ログファイルローテーションの取り扱いに関する注意点 `logrt` の `copytruncate` オプションは、異なるログファイルには異なる記録がある (少なくともタイムスタンプは異なる) と<br> 仮定しています。したがって、初期ブロック (最初の512バイトまで) のMD5チェックサムは異なることになります。<br> 初期ブロックの MD5 チェックサムが同じである 2 つのファイルは、一方がオリジナルで、もう一方がコピーであることを意味します。<br> `logrt` の `copytruncate` オプションは、ログファイルのコピーを重複して報告することなく、正しく処理するように努力します。<br> しかし、同じタイムスタンプのログファイルを複数作成したり、ログファイルのローテーションがlogrt\[\] item のupdate interval より<br> 頻繁になったり、agent を頻繁に再起動することは推奨されません。agent は、これらの状況を合理的に処理しようとしますが、<br> すべての状況でよい結果を保証することはできません。 ### Notes on installation See [installation instructions](https://www.zabbix.com/download?zabbix=5.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql) per platform in the download page for: - installing the repository - installing server/agent/frontend - creating initial database, importing initial data - configuring database for Zabbix server - configuring PHP for Zabbix frontend - starting server/agent processes - configuring Zabbix frontend If you want to run Zabbix agent as root, see [Running agent as root](https://www.zabbix.com/documentation/5.0/manual/appendix/install/run_agent_as_root). Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually. ### Notes on installation See [installation instructions](https://www.zabbix.com/download?zabbix=5.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql) per platform in the download page for: - installing the repository - installing server/agent/frontend - creating initial database, importing initial data - configuring database for Zabbix server - configuring PHP for Zabbix frontend - starting server/agent processes - configuring Zabbix frontend If you want to run Zabbix agent as root, see [Running agent as root](https://www.zabbix.com/documentation/5.0/manual/appendix/install/run_agent_as_root). Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually. ### Notes on installation See [installation instructions](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql) per platform in the download page for: - installing the repository - installing server/agent/frontend - creating initial database, importing initial data - configuring database for Zabbix server - configuring PHP for Zabbix frontend - starting server/agent processes - configuring Zabbix frontend If you want to run Zabbix agent as root, see [Running agent as root](/manual/appendix/install/run_agent_as_root). Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually. ### インストール時の注意事項 [インストール方法](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql) については、ダウンロードページのプラットフォームごとの情報を参照してください。 - リポジトリのインストール - server / agent / フロントエンドのインストール - 初期データベースの作成、初期データのインポート - Zabbix server 用のデータベースの設定 - Zabbix フロントエンドのPHP設定 Zabbix agent をrootで実行したい場合は、[Running agent as root](/manual/appendix/install/run_agent_as_root)を参照してください。 定期的なレポート生成[scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled)に使用される<br> Zabbix Web サービスプロセスには、Google Chromeブラウザが必要です。<br> Google Chromeブラウザはパッケージに含まれていないため、手動でインストールする必要があります。 ### Notes on installation See [installation instructions](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql) per platform in the download page for: - installing the repository - installing server/agent/frontend - creating initial database, importing initial data - configuring database for Zabbix server - configuring PHP for Zabbix frontend - starting server/agent processes - configuring Zabbix frontend If you want to run Zabbix agent as root, see [Running agent as root](/manual/appendix/install/run_agent_as_root). Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually. ### インストール時の注意点 [インストール方法](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql)については、ダウンロードページのプラットフォームごとの情報を参照してください。 - リポジトリ情報のインストール - サーバー/エージェント/Webインターフェースのインストール - 初期データベースの作成、初期データのインポート - Zabbixサーバー用のデータベースの設定 - Zabbix Webインターフェース用のPHPの設定 - サーバー/エージェントのプロセスの起動 - Zabbix Webインターフェースの設定 Zabbixエージェントをrootユーザーで実行したい場合は、[rootユーザーでのエージェントの実行](/manual/appendix/install/run_agent_as_root)を参照してください。 [定期レポートの生成](/manual/web_interface/frontend_sections/reports/scheduled)に使用されるZabbix Webサービスプロセスには、Google Chromeブラウザが必要です。Google Chromeブラウザはパッケージに含まれていないので、手動でインストールする必要があります。 ### Notes on installation See the [installation instructions](https://www.zabbix.com/download?zabbix=5.0&os_distribution=debian&os_version=10_buster&db=mysql) per platform in the download page for: - installing the repository - installing server/agent/frontend - creating initial database, importing initial data - configuring database for Zabbix server - configuring PHP for Zabbix frontend - starting server/agent processes - configuring Zabbix frontend If you want to run Zabbix agent as root, see [running agent as root](/manual/appendix/install/run_agent_as_root). Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually. ### Notes on installation See the [installation instructions](https://www.zabbix.com/download?zabbix=5.0&os_distribution=debian&os_version=10_buster&db=mysql) per platform in the download page for: - installing the repository - installing server/agent/frontend - creating initial database, importing initial data - configuring database for Zabbix server - configuring PHP for Zabbix frontend - starting server/agent processes - configuring Zabbix frontend If you want to run Zabbix agent as root, see [running agent as root](/manual/appendix/install/run_agent_as_root). Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually. ### Notes on installation See the [installation instructions](https://www.zabbix.com/download?zabbix=6.0&os_distribution=ubuntu&os_version=22.04) per platform in the download page for: - installing the repository - installing server/agent/frontend - creating initial database, importing initial data - configuring database for Zabbix server - configuring PHP for Zabbix frontend - starting server/agent processes - configuring Zabbix frontend If you want to run Zabbix agent as root, see [running agent as root](/manual/appendix/install/run_agent_as_root). Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually. ### インストール時の注意点 [インストール方法](https://www.zabbix.com/download?zabbix=6.0&os_distribution=ubuntu&os_version=22.04)については、ダウンロードページのプラットフォームごとの情報を参照してください。 - リポジトリ情報のインストール - サーバー/エージェント/Webインターフェースのインストール - 初期データベースの作成、初期データのインポート - Zabbixサーバー用のデータベースの設定 - Zabbix Webインターフェース用のPHPの設定 - サーバー/エージェントのプロセスの起動 - Zabbix Webインターフェースの設定 Zabbixエージェントをrootユーザーで実行したい場合は、[rootユーザーでのエージェントの実行](/manual/appendix/install/run_agent_as_root)を参照してください。 [定期レポートの生成](/manual/web_interface/frontend_sections/reports/scheduled)に使用されるZabbix Webサービスプロセスには、Google Chromeブラウザが必要です。Google Chromeブラウザはパッケージに含まれていないので、手動でインストールする必要があります。 #### Notes on IPMI discrete sensors To find sensors on a host start Zabbix server with **DebugLevel=4** enabled. Wait a few minutes and find sensor discovery records in Zabbix server logfile: $ grep 'Added sensor' zabbix_server.log 8358:20130318:111122.170 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:7 id:'CATERR' reading_type:0x3 ('discrete_state') type:0x7 ('processor') full_name:'(r0.32.3.0).CATERR' 8358:20130318:111122.170 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:15 id:'CPU Therm Trip' reading_type:0x3 ('discrete_state') type:0x1 ('temperature') full_name:'(7.1).CPU Therm Trip' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'System Event Log' reading_type:0x6f ('sensor specific') type:0x10 ('event_logging_disabled') full_name:'(7.1).System Event Log' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'PhysicalSecurity' reading_type:0x6f ('sensor specific') type:0x5 ('physical_security') full_name:'(23.1).PhysicalSecurity' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'IPMI Watchdog' reading_type:0x6f ('sensor specific') type:0x23 ('watchdog_2') full_name:'(7.7).IPMI Watchdog' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'Power Unit Stat' reading_type:0x6f ('sensor specific') type:0x9 ('power_unit') full_name:'(21.1).Power Unit Stat' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'P1 Therm Ctrl %' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(3.1).P1 Therm Ctrl %' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'P1 Therm Margin' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(3.2).P1 Therm Margin' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:13 id:'System Fan 2' reading_type:0x1 ('threshold') type:0x4 ('fan') full_name:'(29.1).System Fan 2' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:13 id:'System Fan 3' reading_type:0x1 ('threshold') type:0x4 ('fan') full_name:'(29.1).System Fan 3' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'P1 Mem Margin' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).P1 Mem Margin' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'Front Panel Temp' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).Front Panel Temp' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:15 id:'Baseboard Temp' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).Baseboard Temp' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:9 id:'BB +5.0V' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +5.0V' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'BB +3.3V STBY' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +3.3V STBY' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:9 id:'BB +3.3V' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +3.3V' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'BB +1.5V P1 DDR3' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.5V P1 DDR3' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'BB +1.1V P1 Vccp' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.1V P1 Vccp' 8358:20130318:111122.174 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'BB +1.05V PCH' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.05V PCH' To decode IPMI sensor types and states, a copy of [IPMI 2.0 specifications](https://www.intel.com/content/dam/www/public/us/en/documents/product-briefs/ipmi-second-gen-interface-spec-v2-rev1-1.pdf) is available (please note that [no further updates](http://www.intel.com/content/www/us/en/servers/ipmi/ipmi-specifications.html) to the IPMI specification are planned). The first parameter to start with is "reading\_type". Use "Table 42-1, Event/Reading Type Code Ranges" from the specifications to decode "reading\_type" code. Most of the sensors in our example have "reading\_type:0x1" which means "threshold" sensor. "Table 42-3, Sensor Type Codes" shows that "type:0x1" means temperature sensor, "type:0x2" - voltage sensor, "type:0x4" - Fan etc. Threshold sensors sometimes are called "analog" sensors as they measure continuous parameters like temperature, voltage, revolutions per minute. Another example - a sensor with "reading\_type:0x3". "Table 42-1, Event/Reading Type Code Ranges" says that reading type codes 02h-0Ch mean "Generic Discrete" sensor. Discrete sensors have up to 15 possible states (in other words - up to 15 meaningful bits). For example, for sensor 'CATERR' with "type:0x7" the "Table 42-3, Sensor Type Codes" shows that this type means "Processor" and the meaning of individual bits is: 00h (the least significant bit) - IERR, 01h - Thermal Trip etc. There are few sensors with "reading\_type:0x6f" in our example. For these sensors the "Table 42-1, Event/Reading Type Code Ranges" advises to use "Table 42-3, Sensor Type Codes" for decoding meanings of bits. For example, sensor 'Power Unit Stat' has type "type:0x9" which means "Power Unit". Offset 00h means "PowerOff/Power Down". In other words if the least significant bit is 1, then server is powered off. To test this bit, the **bitand** [function](/manual/appendix/functions) with mask '1' can be used. The trigger expression could be like bitand(last(/www.example.com/Power Unit Stat,#1),1)=1 to warn about a server power off. #### IPMIディスクリートセンサに関する注意事項 ホスト上のセンサーを見つけるには、**DebugLevel=4**を有効にしてZabbixサーバを起動します。 数分後、server ログファイルでセンサーの発見記録を確認します。 $ grep 'Added sensor' zabbix_server.log 8358:20130318:111122.170 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:7 id:'CATERR' reading_type:0x3 ('discrete_state') type:0x7 ('processor') full_name:'(r0.32.3.0).CATERR' 8358:20130318:111122.170 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:15 id:'CPU Therm Trip' reading_type:0x3 ('discrete_state') type:0x1 ('temperature') full_name:'(7.1).CPU Therm Trip' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'System Event Log' reading_type:0x6f ('sensor specific') type:0x10 ('event_logging_disabled') full_name:'(7.1).System Event Log' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'PhysicalSecurity' reading_type:0x6f ('sensor specific') type:0x5 ('physical_security') full_name:'(23.1).PhysicalSecurity' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'IPMI Watchdog' reading_type:0x6f ('sensor specific') type:0x23 ('watchdog_2') full_name:'(7.7).IPMI Watchdog' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'Power Unit Stat' reading_type:0x6f ('sensor specific') type:0x9 ('power_unit') full_name:'(21.1).Power Unit Stat' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'P1 Therm Ctrl %' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(3.1).P1 Therm Ctrl %' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'P1 Therm Margin' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(3.2).P1 Therm Margin' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:13 id:'System Fan 2' reading_type:0x1 ('threshold') type:0x4 ('fan') full_name:'(29.1).System Fan 2' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:13 id:'System Fan 3' reading_type:0x1 ('threshold') type:0x4 ('fan') full_name:'(29.1).System Fan 3' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'P1 Mem Margin' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).P1 Mem Margin' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'Front Panel Temp' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).Front Panel Temp' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:15 id:'Baseboard Temp' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).Baseboard Temp' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:9 id:'BB +5.0V' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +5.0V' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'BB +3.3V STBY' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +3.3V STBY' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:9 id:'BB +3.3V' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +3.3V' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'BB +1.5V P1 DDR3' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.5V P1 DDR3' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'BB +1.1V P1 Vccp' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.1V P1 Vccp' 8358:20130318:111122.174 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'BB +1.05V PCH' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.05V PCH' IPMI センサーの種類と状態をデコードするには、[IPMI 2.0 仕様](https://www.intel.com/content/dam/www/public/us/en/documents/product-briefs/ipmi-second-gen-interface-spec-v2-rev1-1.pdf)のコピーを利用できます (IPMI仕様の今後の[更新は予定されていない](http://www.intel.com/content/www/us/en/servers/ipmi/ipmi-specifications.html) to the IPMI specification are planned)ことに注意してください) 最初に始めるパラメータは "reading_type "です。 <br> 仕様書の "表42-1,Event/Reading Type Code Ranges"を使用し、"reading_type "コードをデコードします。 <br> この例では、ほとんどのセンサーが"reading_type:0x1" で、"threshold" センサーを意味します。 <br> "表 42-3, Sensor Type Codes "によると、"type:0x1" は温度センサー、"type:0x2" は電圧センサー、"type:0x3" は温度センサー、 <br> "type:0x4"はファンなどです。閾値センサは、温度、電圧、回転数などの連続的なパラメータを測定するため、 <br> "アナログ" センサーと呼ばれることもあります。 <br> 別の例として、"reading_type:0x3 "のセンサー <br> "表42-1,Event/Reading Type Code Ranges "によると、読み取りタイプコード02h-0Chは、"Generic Discrete "センサーを意味します。ディスクリート・センサは、最大15個の状態（言い換えれば、最大15個の意味のあるビット）があります。例えばセンサー'CATERR'の場合、"type:0x7 "は "表 42-3 , Sensor Type Codes"に示されています。このタイプは "プロセッサ "を意味し、ビットの意味は次のとおりです。00h（最下位ビット） - IERR、01h - サーマルトリップなど。 <br> この例では、「reading_type:0x6f」のセンサーがいくつかあります。 <br> これらのセンサーの場合、"表42-1,Event/Reading Type Code Ranges"は、ビットの意味を解読するために、"表42-3、センサータイプコード" を使用するように助言しています。 <br> 例えば、センサー "Power Unit Stat" のタイプは "type:0x9" であり、"Power Unit"を意味します。 <br> オフセット00hは "PowerOff/Power Down" を意味します。つまり、最下位ビットが1であれば サーバーの電源がオフになっていることを意味します。このビットをテストするには マスクが'1'の**bitand** [関数](/マニュアル/付録/トリガー/関数)を使用することができます。 <br> トリガ式は次のようになります。 <br> bitand(last(/www.example.com/Power Unit Stat,#1),1)=1 これはサーバの電源オフを警告します。 #### Notes on persistent files for log\*\[\] items #### log*[\] itemのpersistent filesに関する注意事項 ##### Notes on threshold and discrete sensor simultaneous availability Some IPMI agents provide both a threshold sensor and a discrete sensor under the same name. In Zabbix versions prior to 2.2.8 and 2.4.3, the first provided sensor was chosen. Since versions 2.2.8 and 2.4.3, preference is always given to the threshold sensor. ##### 閾値とディスクリートセンサーの同時使用に関する注意事項 いくつかのIPMIエージェントは、閾値センサーとディスクリートセンサーを同じ名前で提供しているものがあります。<br> 2.2.8および2.4.3より前のバージョンのZabbixでは、最初に提供されたセンサーが選択されます。<br> バージョン2.2.8と2.4.3以降では、常に閾値センサーが優先されます。 ::: notetip Mostly the `maintenance.inc.php` file is located in `/conf` of Zabbix HTML document directory on the web server. However, the location of the directory may differ depending on the operating system and a web server it uses. For example, the location for: - SUSE and RedHat is `/etc/zabbix/web/maintenance.inc.php`. - Debian-based systems is `/usr/share/zabbix/conf/`. See also [Copying PHP files](/manual/installation/install#copying-php-files). ::: |Parameter|Details| |--|--------| |**ZBX\_DENY\_GUI\_ACCESS**|Enable maintenance mode:<br>1 – maintenance mode is enabled, disabled otherwise| |**ZBX\_GUI\_ACCESS\_IP\_RANGE**|Array of IP addresses, which are allowed to connect to frontend (optional).<br>For example:<br>`array('192.168.1.1', '192.168.1.2')`| |**ZBX\_GUI\_ACCESS\_MESSAGE**|A message you can enter to inform users about the maintenance (optional).| ::: notetip `maintenance.inc.php` ファイルは、大抵はWeb サーバーの Zabbix HTML ドキュメント ディレクトリの `/conf` にあります。 ただし、使用するオペレーティング システムと Web サーバーによって異なる場合があります。 たとえば、 - SUSE または RedHat では `/etc/zabbix/web/maintenance.inc.php`. - Debian-baseのシステムでは `/usr/share/zabbix/conf/`. [PHPファイルのコピー](/manual/installation/install#copying-php-files)も参照してください。 ::: |パラメータ|詳細| |--|--------| |**ZBX\_DENY\_GUI\_ACCESS**|メンテナンス モードを有効にします。<br>1 – メンテナンス モード有効。それ以外は無効| |**ZBX\_GUI\_ACCESS\_IP\_RANGE**|フロントエンドへの接続が許可される IP アドレスの配列 (オプション)<br>例:<br>`array('192.168.1.1', '192.168.1.2')`| |**ZBX\_GUI\_ACCESS\_MESSAGE**|メンテナンスについてユーザーに通知するメッセージ (オプション)| :::notetip You can find out more about setting up SSL for Zabbix frontend by referring to these [best practices](/manual/installation/requirements/best_practices). ::: :::notetip ZabbixフロントエンドのSSL設定の詳細については、[ベストプラクティス](/manual/installation/requirements/best_practices)を参照してください。 ::: #### Notification about canceled escalations When configuring [action operations](/manual/config/notifications/action/operation#configuring-an-operation), it is now possible to cancel notifications about canceled escalations by unmarking the checkbox of the corresponding option. #### エスカレーションのキャンセル時の通知について [アクションの実行内容](/manual/config/notifications/action/operation#configuring-an-operation)の設定時に、該当するオプションのチェックボックスをオフにすると、キャンセルされたエスカレーションに関する通知をキャンセルすることができるようになりました。 ##### Notification about canceled escalations When configuring [action operations](/manual/config/notifications/action/operation#configuring-an-operation), it is now possible to cancel notifications about canceled escalations by unmarking the checkbox of the corresponding option. ##### Monitoring → Overview removed The Overview section in the Monitoring menu has been removed completely. The same functionality can be still accessed by using the *Data overview* and *Trigger overview* dashboard [widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets). #### Miscellaneous - The default language of Zabbix web interface has been changed from British to American English. Support of British English has been dropped. - The Share link in the main menu has been replaced by an Integrations link, leading to the [Integrations](https://www.zabbix.com/integrations) page on the Zabbix website. - If Zabbix web interface is opened in one of the languages available on the Zabbix website, clicking the Integrations link will open the Integrations page in the appropriate language. For all other languages, including English, the Integrations page will be opened in English. ## Notifications ## 通知 ## Notifications ## 通知 ## Notifications ## 通知 #### Numeric (float) data type range with PostgreSQL 11 and earlier PostgreSQL 11 and earlier versions only support floating point value range of approximately -1.34E-154 to 1.34E+154. #### PostgreSQL 11以前における数値データ型(float)の範囲 PostgreSQL 11以前のバージョンでは、浮動小数点値の範囲は -1.34E-154 から 1.34E+154 程度までしかサポートされていません。 #### Numeric representation Windows maintains numeric representations (indexes) for object and performance counter names. Zabbix supports these numeric representations as parameters to the `perf_counter`, `perf_counter_en` item keys and in `PerfCounter`, `PerfCounterEn` configuration parameters. However, it's not recommended to use them unless you can guarantee your numeric indexes map to correct strings on specific hosts. If you need to create portable items that work across different hosts with various localized Windows versions, you can use the `perf_counter_en` key or `PerfCounterEn` configuration parameter which allow to use English names regardless of system locale. To find out the numeric equivalents, run **regedit**, then find *HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Perflib\\009*. The registry entry contains information like this: 1 1847 2 System 4 Memory 6 % Processor Time 10 File Read Operations/sec 12 File Write Operations/sec 14 File Control Operations/sec 16 File Read Bytes/sec 18 File Write Bytes/sec .... Here you can find the corresponding numbers for each string part of the performance counter, like in '\\System\\% Processor Time': System → 2 % Processor Time → 6 Then you can use these numbers to represent the path in numbers: \2\6 #### 数値表現 Windowsはオブジェクトとパフォーマンスカウンタ名の数値表現(インデックス)を保持しています。<br> Zabbixはこれらの数値表現を `perf_counter`, `perf_counter_en` item キーのパラメータとして、<br> また `PerfCounter`, `PerfCounterEn` 設定パラメータとしてサポートしています。 しかし、数値インデックスが特定のホストで正しい文字列にマップされることを保証できない限り、これらを使用することは推奨されません。<br> ローカライズされた Windows バージョンの異なるホストで動作するポータブルな item を作成する必要がある場合は、<br> `perf_counter_en` キーまたは `PerfCounterEn` 設定パラメータを使用して、システムのロケールにかかわらず英語名を使用することが可能です。 数値に相当するものを見つけるには、**regedit** を実行し、以下を見つけます。<br> *HKEY\_LOCAL\_MACHINE\_SOFTWARE\_Microsoft⇄Windows NT\\CurrentVersion\\Perflib\\009* レジストリエントリには、このような情報が含まれています。 1 1847 2 システム 4 メモリ 6 プロセッサー時間 10 ファイル読み込み操作/秒 12 ファイル書込み動作/秒 14 ファイルコントロール動作/秒 16 ファイル読込バイト数/秒 18 ファイル書込みバイト数/秒 .... ここで、'\\System\\% Processor Time' のように、パフォーマンスカウンタの各文字列部分に対応する数値が表示されます。 システム -> 2 % プロセッサー時間 -> 6 そして、この数字を使って、パスを数字で表すことができます。 \2\6 #### OK events An OK event closes the related problem event(s) and may be created by 3 components: - triggers - based on 'OK event generation' and 'OK event closes' settings; - event correlation - task manager – when an event is [manually closed](/manual/config/events/manual_close) #### 正常イベント 正常イベントは関連する障害イベントを閉じます。次の3つのコンポーネントによって作成される場合があります。 - トリガー - '正常イベントの生成' および '正常イベントの終了' 設定に基づく - イベント相関関係 - タスクマネージャー – イベントが[手動でクローズ](/manual/config/events/manual_close)されたとき #### Older XML protocol ::: noteclassic Zabbix will take up to 16 MB of XML Base64-encoded data, but a single decoded value should be no longer than 64 KB otherwise it will be truncated to 64 KB while decoding. ::: #### 古い XML プロトコル ::: noteclassic Zabbixは、 Base64にエンコードされたXMLのデータを16MBまで取得しますが、デコードされる値は1つが64KB以下でなければなりません。そうでないと、デコード中にそれが64KBに切り捨てられます。 ::: #### One side connects with certificate but other side accepts only PSK or vice versa In any log (with *GnuTLS*): failed to accept an incoming connection: from 127.0.0.1: zbx_tls_accept(): gnutls_handshake() failed:\ -21 Could not negotiate a supported cipher suite. In any log (with *OpenSSL* 1.0.2c): failed to accept an incoming connection: from 127.0.0.1: TLS handshake returned error code 1:\ file .\ssl\s3_srvr.c line 1411: error:1408A0C1:SSL routines:ssl3_get_client_hello:no shared cipher:\ TLS write fatal alert "handshake failure" #### 片側は証明書で接続するが、反対側は PSK のみを受け入れる、またはその逆 任意のログ (*GnuTLS* を使用): failed to accept an incoming connection: from 127.0.0.1: zbx_tls_accept(): gnutls_handshake() failed:\ -21 Could not negotiate a supported cipher suite. 任意のログ (*OpenSSL* 1.0.2c を使用): failed to accept an incoming connection: from 127.0.0.1: TLS handshake returned error code 1:\ file .\ssl\s3_srvr.c line 1411: error:1408A0C1:SSL routines:ssl3_get_client_hello:no shared cipher:\ TLS write fatal alert "handshake failure" #### One side connects with PSK but other side uses LibreSSL or has been compiled without encryption support LibreSSL does not support PSK. In connecting-side log: ...TCP successful, cannot establish TLS to [[192.168.1.2]:10050]: SSL_connect() I/O error: [0] Success In accepting-side log: ...failed to accept an incoming connection: from 192.168.1.2: support for PSK was not compiled in In Zabbix frontend: Get value from agent failed: TCP successful, cannot establish TLS to [[192.168.1.2]:10050]: SSL_connect() I/O error: [0] Success #### 一方は PSK で接続するが、もう一方は LibreSSL を使用しているか、暗号化サポートなしでコンパイルされている場合 LibreSSL は PSK をサポートしていません。 接続元ログ: ...TCP successful, cannot establish TLS to [[192.168.1.2]:10050]: SSL_connect() I/O error: [0] Success 受付側ログ： ...failed to accept an incoming connection: from 192.168.1.2: support for PSK was not compiled in Zabbixフロントエンド: Get value from agent failed: TCP successful, cannot establish TLS to [[192.168.1.2]:10050]: SSL_connect() I/O error: [0] Success #### One side connects with PSK but other side uses OpenSSL with PSK support disabled In connecting-side log: ...TCP successful, cannot establish TLS to [[192.168.1.2]:10050]: SSL_connect() set result code to SSL_ERROR_SSL: file ../ssl/record/rec_layer_s3.c line 1536: error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure: SSL alert number 40: TLS read fatal alert "handshake failure" In accepting-side log: ...failed to accept an incoming connection: from 192.168.1.2: TLS handshake set result code to 1: file ssl/statem/statem_srvr.c line 1422: error:1417A0C1:SSL routines:tls_post_process_client_hello:no shared cipher: TLS write fatal alert "handshake failure" #### 一方は PSK で接続しますが、もう一方は PSK サポートを無効にして OpenSSL を使用している場合 接続元ログ: ...TCP successful, cannot establish TLS to [[192.168.1.2]:10050]: SSL_connect() set result code to SSL_ERROR_SSL: file ../ssl/record/rec_layer_s3.c line 1536: error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure: SSL alert number 40: TLS read fatal alert "handshake failure" 受付側ログ: ...failed to accept an incoming connection: from 192.168.1.2: TLS handshake set result code to 1: file ssl/statem/statem_srvr.c line 1422: error:1417A0C1:SSL routines:tls_post_process_client_hello:no shared cipher: TLS write fatal alert "handshake failure" ##### On Linux 2.4: (Sensor readings are obtained from /proc/sys/dev/sensors directory) - **device** - device name (if <mode> is used, it is a regular expression); - **sensor** - sensor name (if <mode> is used, it is a regular expression); - **mode** - possible values: avg, max, min (if this parameter is omitted, device and sensor are treated verbatim). Example key: sensor\[w83781d-i2c-0-2d,temp1\] Prior to Zabbix 1.8.4, the sensor\[temp1\] format was used. ##### Linux 2.4の場合： （センサーの読み取り値は/proc/sys/dev/sensorsディレクトリから取得されます） - **device** - デバイス名（<mode>が使用されている場合は正規表現です） - **sensor** - センサー名（<mode>が使用されている場合は正規表現です） - **mode** - 使用可能な値：avg,max,min（このパラメーターが省略されている場合、デバイスとセンサーは逐語的に扱われます） キーの例：sensor\[w83781d-i2c-0-2d,temp1\] Zabbix 1.8.4以前は sensor \[temp1\] 形式が使用されていました。 ##### On Linux 2.6+: (Sensor readings are obtained from /sys/class/hwmon directory) - **device** - device name (non regular expression). The device name could be the actual name of the device (e.g 0000:00:18.3) or the name acquired using sensors program (e.g. k8temp-pci-00c3). It is up to the user to choose which name to use; - **sensor** - sensor name (non regular expression); - **mode** - possible values: avg, max, min (if this parameter is omitted, device and sensor are treated verbatim). Example key: sensor\[k8temp-pci-00c3,temp,max\] or sensor\[0000:00:18.3,temp1\] sensor\[smsc47b397-isa-0880,in,avg\] or sensor\[smsc47b397.2176,in1\] ##### Linux 2.6以降の場合： （センサーの読み取り値は/sys/class/hwmonディレクトリから取得されます） - **device** - デバイス名（非正規表現） デバイス名はデバイスの実際の名前（0000:00:18.3など）またはセンサープログラムを使用して取得した名前（k8temp-pci-00c3など）の場合があります。 使用する名前はユーザーが選択してください。 - **sensor** - センサー名（非正規表現） - **mode** - 使用可能な値: avg, max, min (このパラメーターを省略した場合、デバイスとセンサーは逐語的に扱われます). キーの例： sensor\[k8temp-pci-00c3,temp,max\] or sensor\[0000:00:18.3,temp1\] sensor\[smsc47b397-isa-0880,in,avg\] or sensor\[smsc47b397.2176,in1\] ### Open file descriptor limit increase for Zabbix agent 2 The systemd service file shipped in Zabbix agent 2 packages now declares the open file descriptor limit of 8196. Previously, the system default limit of 1024 has been used. The new limit is sufficient for the default Zabbix agent 2 configuration. If you have a non-standard agent 2 configuration, for example, use additional plugins or extended features, this limit may need to be manually increased further. In this case, adjust the `LimitNOFILE` parameter in the systemd unit file. ### Zabbixエージェント2のオープンファイルディスクリプタの制限の緩和 Zabbixエージェント2パッケージで同梱されているsystemdサービスファイルのオープンファイルディスクリプタの制限は、8196になりました。 変更前は、システムのデフォルトの制限として、1024が使用されていました。 新しい制限は、Zabbixエージェント2のデフォルト設定に十分なものとなっています。 追加のプラグインや拡張機能を使用しているなど、Zabbixエージェント2が標準の設定でない場合は、この制限を手動で拡張する必要があります。 その場合は、systemdユニットファイルの`LimitNOFILE`パラメーターを調整してください。 ### Open file descriptor limit increase for Zabbix agent 2 The systemd service file shipped in Zabbix agent 2 packages now declares the open file descriptor limit of 8196. Previously, the system default limit of 1024 has been used. The new limit is sufficient for the default Zabbix agent 2 configuration. If you have a non-standard agent 2 configuration, for example, use additional plugins or extended features, this limit may need to be manually increased further. In this case, adjust the `LimitNOFILE` parameter in the systemd unit file. ### Zabbixエージェント2のオープンファイルディスクリプタの制限の緩和 Zabbixエージェント2パッケージで同梱されているsystemdサービスファイルのオープンファイルディスクリプタの制限は、8196になりました。 変更前は、システムのデフォルトの制限として、1024が使用されていました。 新しい制限は、Zabbixエージェント2のデフォルト設定に十分なものとなっています。 追加のプラグインや拡張機能を使用しているなど、Zabbixエージェント2が標準の設定でない場合は、この制限を手動で拡張する必要があります。 その場合は、systemdユニットファイルの`LimitNOFILE`パラメーターを調整してください。 ### OpenSSL 3.0 support OpenSSL 3.0.x is now supported. Note that this change does not affect frontend encryption (which uses its own openssl-php package) and Java gateway JMX encrypted connections to monitoring targets (which uses its own Java encrypted libraries). ### OpenSSL 3.0 対応 OpenSSL 3.0.xをサポートしました。 この変更は、フロントエンドの暗号化 (独自の openssl-php パッケージを使用) および 監視対象の Java ゲートウェイ JMX 暗号化接続 (独自の Java 暗号化ライブラリを使用) には影響しないことに注意してください。 #### OpenSSL used with CRLs and for some CA in the certificate chain its CRL is not included in `TLSCRLFile` In TLS server log in case of *OpenSSL* peer: failed to accept an incoming connection: from 127.0.0.1: TLS handshake with 127.0.0.1 returned error code 1: \ file s3_srvr.c line 3251: error:14089086: SSL routines:ssl3_get_client_certificate:certificate verify failed: \ TLS write fatal alert "unknown CA" In TLS server log in case of *GnuTLS* peer: failed to accept an incoming connection: from 127.0.0.1: TLS handshake with 127.0.0.1 returned error code 1: \ file rsa_pk1.c line 103: error:0407006A: rsa routines:RSA_padding_check_PKCS1_type_1:\ block type is not 01 file rsa_eay.c line 705: error:04067072: rsa routines:RSA_EAY_PUBLIC_DECRYPT:paddin #### CRLで使用されるOpenSSLと証明書チェーンの一部の CAでは、CRLが`TLSCRLFile`に含まれていない *OpenSSL* ピアの場合の TLS サーバー ログ: failed to accept an incoming connection: from 127.0.0.1: TLS handshake with 127.0.0.1 returned error code 1: \ file s3_srvr.c line 3251: error:14089086: SSL routines:ssl3_get_client_certificate:certificate verify failed: \ TLS write fatal alert "unknown CA" *GnuTLS* ピアの場合の TLS サーバー ログ: failed to accept an incoming connection: from 127.0.0.1: TLS handshake with 127.0.0.1 returned error code 1: \ file rsa_pk1.c line 103: error:0407006A: rsa routines:RSA_padding_check_PKCS1_type_1:\ block type is not 01 file rsa_eay.c line 705: error:04067072: rsa routines:RSA_EAY_PUBLIC_DECRYPT:paddin #### Operating system - Use latest (stable!) version of OS - Exclude unnecessary functionality from kernel - Tune kernel parameters #### オペレーティングシステム - 最新の(安定)バージョンOS を使用する - 不要な機能をカーネルから除外する - カーネル パラメータを調整する #### Operational data of problems It is possible to display operational data for current problems, i.e. the latest item values as opposed to the item values at the time of the problem. Operational data display can be configured in the filter of *Monitoring* → *Problems* or in the configuration of the respective [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems), by selecting one of the three options: - *None* - no operational data is displayed - *Separately* - operational data is displayed in a separate column {width="600"} - *With problem name* - operational data is appended to the problem name and in parentheses. Operational data are appended to the problem name only if the *Operational data* field is non-empty in the trigger configuration. {width="600"} The content of operational data can be configured with each [trigger](/manual/config/triggers/trigger), in the *Operational data* field. This field accepts an arbitrary string with macros, most importantly, the `{ITEM.LASTVALUE<1-9>}` macro. `{ITEM.LASTVALUE<1-9>}` in this field will always resolve to the latest values of items in the trigger expression. `{ITEM.VALUE<1-9>}` in this field will resolve to the item values at the moment of trigger status change (i.e. change into problem, change into OK, being closed manually by a user or being closed by correlation). Note that closing the problem manually does not produce a new value so the resolved value of `{ITEM.LASTVALUE<1-9>}` or `{ITEM.VALUE<1-9>}` will still show the value from the problem time. `{ITEM.LASTVALUE<1-9>}` or `{ITEM.VALUE<1-9>}` will resolve to \*UNKNOWN\* if the latest history value has been collected more than the *Max history display period* time ago (see *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*). #### 障害の運用データ 現在の障害の運用データ、つまり障害発生時のアイテム値ではなく最新のアイテム値を表示することができます。 運用データの表示は*監視データ* → *障害*のフィルターまたはそれぞれの[ダッシュボードウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#problems)の設定で構成できます。 オプションは3つあります。 - *なし* - 運用データは表示されません - *別々に* - 運用データは別の列に表示されます {width="600"} - *障害名と一緒に* - 運用データは障害名の括弧内に追加されます。トリガー構成で*障害データ*フィールドが空でない場合にのみ運用データが障害名に追加されます。 {width="600"} 運用データの内容は、各[トリガー](/manual/config/triggers/trigger)の*運用データ*フィールドで設定できます。このフィールドは、`{ITEM.LASTVALUE<1-9>}`マクロを含む任意の文字列を受け入れます。 このフィールドの`{ITEM.LASTVALUE<1-9>}`はトリガー式内のアイテムの最新の値に常に解決されます。このフィールドの`{ITEM.VALUE<1-9>}`は、トリガーステータスが変更された時点(障害または正常に状態が変更、手動クローズ、または相関によるクローズ)の監視データが展開されます。 障害を手動クローズした場合、監視データは生成されないので`{ITEM.LASTVALUE<1-9>}`または`{ITEM.VALUE<1-9>}`で展開される値は、問題発生時の値のままになることに注意してください。 最新の監視データがヒストリの最大表示期間よりも前に収集された場合、`{ITEM.LASTVALUE<1-9>}`または`{ITEM.VALUE<1-9>}`は\*UNKNOWN\*に解決されます。(*メニュー[管理 → 一般設定](/manual/web_interface/frontend_sections/administration/general#gui)*を参照) #### Operation details  |Parameter|<|Description| |-|----------|----------------------------------------| |*Operation*|<|Select the operation:<br>**Send message** - send message to user<br>**<remote command name>** - execute a remote command. Commands are available for execution if previously defined in [global scripts](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script) with *Action operation* selected as its scope.<br>More operations are available for discovery and autoregistration based events (see above).| |*Steps*|<|Select the step(s) to assign the operation to in an [escalation](escalations) schedule:<br>**From** - execute starting with this step<br>**To** - execute until this step (0=infinity, execution will not be limited)| |*Step duration*|<|Custom duration for these steps (0=use default step duration).<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 60s, 1m, 2h, 1d, since Zabbix 3.4.0.<br>[User macros](/manual/config/macros/user_macros) are supported, since Zabbix 3.4.0.<br>Several operations can be assigned to the same step. If these operations have different step duration defined, the shortest one is taken into account and applied to the step.| |Operation type: [send message](/manual/config/notifications/action/operation/message)|<|<| | |*Send to user groups*|Click on *Add* to select user groups to send the message to.<br>The user group must have at least "read" [permissions](/manual/config/users_and_usergroups/permissions) to the host in order to be notified.| |^|*Send to users*|Click on *Add* to select users to send the message to.<br>The user must have at least "read" [permissions](/manual/config/users_and_usergroups/permissions) to the host in order to be notified.| |^|*Send only to*|Send message to all defined media types or a selected one only.| |^|*Custom message*|If selected, the custom message can be configured.<br>For notifications about internal events via [webhooks](/manual/config/notifications/media/webhook), custom message is mandatory.| |^|*Subject*|Subject of the custom message. The subject may contain macros. It is limited to 255 characters.| |^|*Message*|The custom message. The message may contain macros. It is limited to certain amount of characters depending on the type of database (see [Sending message](/manual/config/notifications/action/operation/message) for more information).| |Operation type: [remote command](/manual/config/notifications/action/operation/remote_command)|<|<| | |*Target list*|Select targets to execute the command on:<br>**Current host** - command is executed on the host of the trigger that caused the problem event. This option will not work if there are multiple hosts in the trigger.<br>**Host** - select host(s) to execute the command on.<br>**Host group** - select host group(s) to execute the command on. Specifying a parent host group implicitly selects all nested host groups. Thus the remote command will also be executed on hosts from nested groups.<br>A command on a host is executed only once, even if the host matches more than once (e.g. from several host groups; individually and from a host group).<br>The target list is meaningless if a custom script is executed on Zabbix server. Selecting more targets in this case only results in the script being executed on the server more times.<br>Note that for global scripts, the target selection also depends on the *Host group* setting in global script [configuration](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script).<br>*Target list* option is not available for *Service actions* because in this case remote commands are always executed on Zabbix server.| |*Conditions*|<|Condition for performing the operation:<br>**Not ack** - only when the event is unacknowledged<br>**Ack** - only when the event is acknowledged.<br>*Conditions* option is not available for *Service actions*.| When done, click on *Add* to add the operation to the list of *Operations*. #### 実行内容の詳細  |パラメータ|<|説明| |-|----------|----------------------------------------| |*処理内容*|<|アクションを選択します。<br>**メッセージを送信** - ユーザーにメッセージを送信します<br>**<リモート コマンド名>** - リモート コマンドを実行します。 [グローバル スクリプト](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script) で *アクション処理* がスコープとして選択されている場合、コマンドを実行できます。(上記参照)| |*ステップ*|<|[エスカレーション](escalations) スケジュールでオペレーションを割り当てるステップを選択します:<br>**From** - このステップから開始して実行<br>**To** - このステップまで実行 (0 =無限、実行は制限されません)| |*ステップの間隔*|<|これらのステップのカスタム間隔 (0 = デフォルトのステップ間隔を使用)。<br>Zabbix 3.4.0 以降では[タイムサフィックス](/manual/appendix/suffixes) がサポートされています。例:60s,1m,2h,1d<br><br>Zabbix 3.4.0 以降では[ユーザー マクロ](/manual/config/macros/user_macros)がサポートされています。<br>同じステップに複数の操作を割り当てることができます。 これらの操作に異なるステップ期間が定義されている場合、最短のものがステップに適用されます。| |処理内容: [メッセージの送信](/manual/config/notifications/action/operation/message)|<|<| | |*ユーザーグループに送信*|[*追加*] をクリックして、メッセージを送信するユーザー グループを選択します。<br>通知を受け取るには、ユーザー グループがホストに対して少なくとも"読み取り"[権限](/manual/config/users_and_usergroups/permissions) を持っている必要があります。| |^|*ユーザーに送信*|[*追加*] をクリックして、メッセージを送信するユーザーを選択します。<br>通知を受け取るには、ユーザーがホストに対して少なくとも "読み取り" [権限](/manual/config/users_and_usergroups/permissions) を持っている必要があります。| |^|*次のメディアのみ使用*|定義されたすべてのメディア タイプまたは選択したメディア タイプのみにメッセージを送信します。| |^|*メッセージのカスタマイズ*|カスタムメッセージを設定できます。<br>[webhook](/manual/config/notifications/media/webhook) 経由の内部イベントに関する通知の場合、カスタム メッセージは必須です。| |^|*件名*|カスタムメッセージの件名。 件名にはマクロが含まれている場合があります。 255 文字までに制限されています。| |^|*メッセージ*|カスタムメッセージ本文。 メッセージにはマクロが含まれている場合があります。 データベースのタイプに応じて特定の文字数に制限されます (詳細については[メッセージの送信](/manual/config/notifications/action/operation/message) を参照してください)| |処理内容: <リモート コマンド名>(/manual/config/notifications/action/operation/remote_command)|<|<| | |*ターゲットリスト*|Select targets to execute the command on:<br>**現在のホスト** - コマンドは、問題イベントを引き起こしたトリガーのホストで実行されます。トリガーに複数のホストがある場合、このオプションは機能しません。<br>**ホスト** - コマンドを実行するホストを選択します。<br>**ホスト グループ** - コマンドを実行するホスト グループを選択します。親ホスト グループを指定すると、ネストされたすべてのホスト グループが暗黙的に選択されます。よってリモート コマンドはネストされたグループのホストでも実行されます。<br>ホストが複数回一致した場合でも、ホスト上のコマンドは 1 回だけ実行されます (たとえば、複数のホスト グループから、個別に、およびホスト グループから一致した場合など)。 <br>Zabbixサーバー上でカスタムスクリプトを実行すると、ターゲットリストは無効になります。この場合により多くのターゲットを選択すると、スクリプトがサーバー上でより多くの回数実行されるだけです。<br>グローバル スクリプトの場合、ターゲットの選択は、グローバル スクリプトの [設定](/manual/ web_interface/frontend_sections/administration/scripts#configuring_a_global_script)で可能です。<br>*ターゲット リスト*オプションは*サービス アクション*には使用できません。この場合リモート コマンドは常にZabbixサーバーで実行されるためです。| |*実行条件*|<|アクションを実行するための条件:<br>確認済みが**いいえ** - イベント未確認の場合実行<br>確認済みが**はい** - イベント確認済みの場合実行<br>*実行条件* オプションは *サービス アクション* では使用できません。| 完了したら[add] をクリックして、アクションを[実行内容]リストに追加します。 #### Operation type: notify all involved |Parameter|Description| |--|--------| |*Custom message*|If selected, a custom message can be defined.| |*Subject*|Subject of the custom message. The subject may contain macros.| |*Message*|The custom message. The message may contain macros.| #### 処理内容:障害通知送信済のユーザーすべてにメッセージを送信 |パラメータ|説明| |--|--------| |*メッセージのカスタマイズ*|選択すると、カスタム メッセージを設定できます。| |*件名*|カスタム メッセージ件名。 件名にはマクロが含まれている場合があります。| |*メッセージ*|カスタム メッセージ本文。 メッセージにはマクロが含まれている場合があります。| #### Operation type: [remote command](/manual/config/notifications/action/operation/remote_command) |Parameter|Description| |--|--------| |*Target list*|Select targets to execute the command on:<br>**Current host** - command is executed on the host of the trigger that caused the problem event. This option will not work if there are multiple hosts in the trigger.<br>**Host** - select host(s) to execute the command on.<br>**Host group** - select host group(s) to execute the command on. Specifying a parent host group implicitly selects all nested host groups. Thus the remote command will also be executed on hosts from nested groups.<br>A command on a host is executed only once, even if the host matches more than once (e.g. from several host groups; individually and from a host group).<br>The target list is meaningless if the command is executed on Zabbix server. Selecting more targets in this case only results in the command being executed on the server more times.<br>Note that for global scripts, the target selection also depends on the *Host group* setting in global script [configuration](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script).| #### 処理内容: [リモートコマンド](/manual/config/notifications/action/operation/remote_command) |パラメータ|説明| |--|--------| |*ターゲットリスト*|コマンドを実行するターゲットを選択:<br>**現在のホスト** - コマンドは障害イベントを引き起こしたトリガーのホストで実行されます。トリガーに複数のホストがある場合、このオプションは機能しません。<br>**ホスト** - コマンドを実行するホストを選択します。<br>**ホスト グループ** - コマンドを実行するホスト グループを選択します。親ホスト グループを指定すると、ネストされたすべてのホスト グループが暗黙的に選択されます。したがって、リモート コマンドは、ネストされたグループのホストでも実行されます。<br>ホストが複数回一致した場合でも、ホスト上のコマンドは 1 回だけ実行されます (たとえば複数のホストグループで一致、個別に一致およびホスト グループでも一致等)<br>Zabbixサーバーでコマンドを実行した場合、ターゲットリストは意味がありません。この場合、より多くのターゲットを選択しても、サーバー上でコマンドが実行される回数が増えるだけです。 <br>グローバル スクリプトの場合、ターゲットの選択は、グローバル スクリプトの[設定](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script)にある*ホスト グループ*にも依存することに注意してください。| #### Operation type: [send message](/manual/config/notifications/action/operation/message) |Parameter|Description| |--|--------| |*Send to user groups*|Click on *Add* to select user groups to send the recovery message to.<br>The user group must have at least "read" [permissions](/manual/config/users_and_usergroups/permissions) to the host in order to be notified.| |*Send to users*|Click on *Add* to select users to send the recovery message to.<br>The user must have at least "read" [permissions](/manual/config/users_and_usergroups/permissions) to the host in order to be notified.| |*Send only to*|Send default recovery message to all defined media types or a selected one only.| |*Custom message*|If selected, a custom message can be defined.| |*Subject*|Subject of the custom message. The subject may contain macros.| |*Message*|The custom message. The message may contain macros.| #### 処理内容: [メッセージの送信](/manual/config/notifications/action/operation/message) |パラメータ|説明| |--|--------| |*ユーザーグループに送信*|*追加* をクリックして、復旧メッセージを送信するユーザー グループを選択します。<br>通知を受け取るには、ユーザー グループがホストに対して少なくとも"読み取り"[権限](/manual/config/users_and_usergroups/permissions) を持っている必要があります。| |*ユーザーに送信*|*追加* をクリックして、復旧メッセージを送信するユーザーを選択します。<br>ユーザーは、通知を受け取るために、ホストに対して少なくとも "読み取り"[権限](/manual/config/users_and_usergroups/permissions) を持っている必要があります。| |*次のメディアのみ使用*|デフォルトの復旧メッセージを、定義されたすべてのメディア タイプまたは選択したメディア タイプのみに送信します。| |*メッセージのカスタマイズ*|選択すると、カスタム メッセージを設定できます。| |*件名*|カスタム メッセージの件名。マクロが含まれている場合があります。| |*メッセージ*|カスタム メッセージ本文。マクロが含まれている場合があります。| #### Operators The following operators are supported for triggers **(in descending priority of execution)**: |Priority|Operator|Definition|**Notes for [unknown values](/manual/config/triggers/expression#expressions_with_unknown-operands)**|Force cast operand to float ^**1**^| |-|-|----|----------------|--| |**1**|**-**|Unary minus|**-**Unknown → Unknown|Yes| |**2**|**not**|Logical NOT|**not** Unknown → Unknown|Yes| |**3**|**\***|Multiplication|0 **\*** Unknown → Unknown<br>(yes, Unknown, not 0 - to not lose<br>Unknown in arithmetic operations)<br>1.2 **\*** Unknown → Unknown|Yes| |<|**/**|Division|Unknown **/** 0 → error<br>Unknown **/** 1.2 → Unknown<br>0.0 **/** Unknown → Unknown|Yes| |**4**|**+**|Arithmetical plus|1.2 **+** Unknown → Unknown|Yes| |<|**-**|Arithmetical minus|1.2 **-** Unknown → Unknown|Yes| |**5**|**\<**|Less than. The operator is defined as:<br><br>A<B ⇔ (A<B-0.000001)|1.2 **<** Unknown → Unknown|Yes| |<|**<=**|Less than or equal to. The operator is defined as:<br><br>A<=B ⇔ (A≤B+0.000001)|Unknown **<=** Unknown → Unknown|Yes| |<|**>**|More than. The operator is defined as:<br><br>A>B ⇔ (A>B+0.000001)| |Yes| |<|**>=**|More than or equal to. The operator is defined as:<br><br>A>=B ⇔ (A≥B-0.000001)| |Yes| |**6**|**=**|Is equal. The operator is defined as:<br><br>A=B ⇔ (A≥B-0.000001) and (A≤B+0.000001)| |No ^**1**^| |<|**<>**|Not equal. The operator is defined as:<br><br>A<>B ⇔ (A<B-0.000001) or (A>B+0.000001)| |No ^**1**^| |**7**|**and**|Logical AND|0 **and** Unknown → 0<br>1 **and** Unknown → Unknown<br>Unknown **and** Unknown → Unknown|Yes| |**8**|**or**|Logical OR|1 **or** Unknown → 1<br>0 **or** Unknown → Unknown<br>Unknown **or** Unknown → Unknown|Yes| ^**1**^ String operand is still cast to numeric if: - another operand is numeric - operator other than **=** or **<>** is used on an operand (If the cast fails - numeric operand is cast to a string operand and both operands get compared as strings.) **not**, **and** and **or** operators are case-sensitive and must be in lowercase. They also must be surrounded by spaces or parentheses. All operators, except unary **-** and **not**, have left-to-right associativity. Unary **-** and **not** are non-associative (meaning **-(-1)** and **not (not 1)** should be used instead of **--1** and **not not 1**). Evaluation result: - **<**, **<=**, **>**, **>=**, **=**, **<>** operators shall yield '1' in the trigger expression if the specified relation is true and '0' if it is false. If at least one operand is Unknown the result is Unknown; - **and** for known operands shall yield '1' if both of its operands compare unequal to '0'; otherwise, it yields '0'; for unknown operands **and** yields '0' only if one operand compares equal to '0'; otherwise, it yields 'Unknown'; - **or** for known operands shall yield '1' if either of its operands compare unequal to '0'; otherwise, it yields '0'; for unknown operands **or** yields '1' only if one operand compares unequal to '0'; otherwise, it yields 'Unknown'; - The result of the logical negation operator **not** for a known operand is '0' if the value of its operand compares unequal to '0'; '1' if the value of its operand compares equal to '0'. For unknown operand **not** yields 'Unknown'. #### 演算子 trigger では、以下の演算子がサポートされています（実行優先度の高い順）: |優先度|演算子|定義|**[不明な値](/manual/config/triggers/expression#expressions_with_unsupported_items_and_unknown_values)の注意事項**|オペランドを強制的にfloatにする ^**1**^| -|-|----|----------------|--| |**1**|**-**|単項負|**-**Unknown → Unknown|Yes| |**2**|**not**|論理否定|**not** Unknown → Unknown|Yes| |**3**|**\***|乗算|0 **\*** Unknown → Unknown<br>(yes, Unknown, not 0 - 算術演算では不明)<br>1.2 **\*** Unknown → Unknown|Yes| |<|**/**|分割|Unknown **/** 0 → error<br>Unknown **/** 1.2 → Unknown<br>0.0 **/** Unknown → Unknown|Yes| |**4**|**+**|算術プラス|1.2 **+** Unknown → Unknown|Yes| |<|**-**|算術マイナス|1.2 **-** Unknown → Unknown|Yes| |**5**|**<**|未満。 演算子は次のように定義されます:<br><br>A<B ⇔ (A<B-0.000001)|1.2 **<** Unknown → Unknown|Yes| |<|**<=**|以下。 演算子は次のように定義されます:<br><br>A<=B ⇔ (A≤B+0.000001)|Unknown **<=** Unknown → Unknown|Yes| |<|**>**|超過。 演算子は次のように定義されます:<br><br>A>B ⇔ (A>B+0.000001)|<|Yes| |<|**>=**|以上。 演算子は次のように定義されます:<br><br>A>=B ⇔ (A≥B-0.000001)|<|Yes| |**6**|**=**|等しい。 演算子は次のように定義されます:<br><br>A=B ⇔ (A≥B-0.000001) and (A≤B+0.000001)|<|No ^**1**^| |<|**<>**|等しくない。 演算子は次のように定義されます:<br><br>A<>B ⇔ (A<B-0.000001) or (A>B+0.000001)|<|No ^**1**^| |**7**|**and**|論理積|0 **and** Unknown → 0<br>1 **and** Unknown → Unknown<br>Unknown **and** Unknown → Unknown|Yes| |**8**|**or**|論理和|1 **or** Unknown → 1<br>0 **or** Unknown → Unknown<br>Unknown **or** Unknown → Unknown|Yes| ^**1**^ 文字列オペランドが数値にキャストされるのは、以下の場合です: - 他のオペランドが数値である場合 - オペランドに **=** または **<>** 以外の演算子が使用されている場合。 (キャストに失敗した場合、数値オペランドは文字列オペランドにキャストされ、両方のオペランドは文字列として比較されます)。 **not**, **and**, **or** 演算子は大文字と小文字を区別する。また、空白または括弧で囲む必要があります。 単項の**-**と**not**を除くすべての演算子は、左から右への連想性を持っています。<br> 単項の**-**と**not**は非連想性である(つまり、**-(-1)**と**not (not 1)**は、**--1**と**not 1**の代わりに使用すべきです。)。 評価結果: - **<** , **<=** , **>** , **>=** , **<>** 演算子は、指定された関係が真であれば trigger に'1'を、偽であれば'0'をもたらすものとする。 少なくとも一つのオペランドが不明である場合、結果は不明です。 - 未知のオペランドに対して、**and** は、オペランドの両方が'0'と等しくない比較をした場合、'1'を生成し、それ以外の場合は、 '0'を生成します。 - 未知のオペランドに対しては、**or** は一方のオペランドが'0'と等しくない場合にのみ'1'を出力し、そうでない場合は'0'を出力します。 - 既知のオペランドに対する論理否定演算子 **not** の結果は、オペランドの値が '0' と等しくない場合は '0' となり、オペランドの値が '0' と 等しい場合は '1' となる。未知のオペランドに対しては、**not**は'Unknown'を生成します。 ### Optimized API queries API database queries, created when searching through names in *hosts* and *items* tables, have been optimized and will now be processed more efficiently. ### 最適化されたAPIクエリ *hosts*テーブルと*items*テーブルで名前を検索するときに作成されるAPIのデータベースクエリが最適化され、より効率的に処理されるようになりました。 ### Optimized API queries API database queries, used when searching through names in the *hosts* and *items* tables, have been optimized and will now be processed more efficiently. As a result of this change, deterministic triggers need to be created during an upgrade. On MySQL and MariaDB, this requires `GLOBAL log_bin_trust_function_creators = 1` to be set if binary logging is enabled and there is no superuser privileges and `log_bin_trust_function_creators = 1` is not set in MySQL configuration file. To set the variable using MySQL console, run: mysql> SET GLOBAL log_bin_trust_function_creators = 1; Once the upgrade has been successfully completed, `log_bin_trust_function_creators` can be disabled: mysql> SET GLOBAL log_bin_trust_function_creators = 0; Triggers are also created for PostgreSQL and Oracle database. ### APIクエリの最適化 *hosts*テーブルと*items*テーブルで名前を検索するときに使用されるAPIのデータベースクエリが最適化され、より効率的に処理されるようになりました。この変更の結果、アップグレード中に決定論的トリガーを作成する必要があります。 MySQLとMariaDBでは、バイナリロギングが有効で、スーパーユーザー権限がなく、MySQL 構成ファイルに`log_bin_trust_function_creators = 1`が設定されていない場合、`GLOBAL log_bin_trust_function_creators = 1`を設定する必要があります。 MySQLのコンソールを使用して変数を設定するには、以下を実行します： mysql> SET GLOBAL log_bin_trust_function_creators = 1; アップグレードが正常に完了したら、`log_bin_trust_function_creators`を無効にできます： mysql> SET GLOBAL log_bin_trust_function_creators = 0; トリガーは、PostgreSQLおよびOracleデータベース用にも作成されます。 ## OPTIONS **-c**, **--config** *config-file* Use *config-file*. **Zabbix sender** reads server details from the agentd configuration file. By default **Zabbix sender** does not read any configuration file. Only parameters **Hostname**, **ServerActive**, **SourceIP**, **TLSConnect**, **TLSCAFile**, **TLSCRLFile**, **TLSServerCertIssuer**, **TLSServerCertSubject**, **TLSCertFile**, **TLSKeyFile**, **TLSPSKIdentity** and **TLSPSKFile** are supported. Hostname defined through **HostnameItem** parameter will not be picked up, in this case the hostname should be specified via command line (see -s option). All addresses defined in the agent **ServerActive** configuration parameter are used for sending data. If sending of batch data fails to one address, the following batches are not sent to this address. **-z**, **--zabbix-server** *server* Hostname or IP address of Zabbix server. If a host is monitored by a proxy, proxy hostname or IP address should be used instead. When used together with **--config**, overrides the entries of **ServerActive** parameter specified in agentd configuration file. **-p**, **--port** *port* Specify port number of Zabbix server trapper running on the server. Default is 10051. When used together with **--config**, overrides the port entries of **ServerActive** parameter specified in agentd configuration file. **-I**, **--source-address** *IP-address* Specify source IP address. When used together with **--config**, overrides **SourceIP** parameter specified in agentd configuration file. **-t**, **--timeout** *seconds* Specify timeout. Valid range: 1-300 seconds (default: 60) **-s**, **--host** *host* Specify host name the item belongs to (as registered in Zabbix frontend). Host IP address and DNS name will not work. When used together with **--config**, overrides **Hostname** parameter specified in agentd configuration file. **-k**, **--key** *key* Specify item key to send value to. **-o**, **--value** *value* Specify item value. **-i**, **--input-file** *input-file* Load values from input file. Specify **-** as **<input-file>** to read values from standard input. Each line of file contains whitespace delimited: **<hostname> <key> <value>**. Each value must be specified on its own line. Each line must contain 3 whitespace delimited entries: **<hostname> <key> <value>**, where "hostname" is the name of monitored host as registered in Zabbix frontend, "key" is target item key and "value" - the value to send. Specify **-** as **<hostname>** to use hostname from agent configuration file or from **--host** argument. An example of a line of an input file: **"Linux DB3" db.connections 43** The value type must be correctly set in item configuration of Zabbix frontend. Zabbix sender will send up to 250 values in one connection. [Size limit](/manual/appendix/protocols/header_datalen) for sending values from an input file depends on the size described in Zabbix communication protocol. Contents of the input file must be in the UTF-8 encoding. All values from the input file are sent in a sequential order top-down. Entries must be formatted using the following rules: - Quoted and non-quoted entries are supported. - Double-quote is the quoting character. - Entries with whitespace must be quoted. - Double-quote and backslash characters inside quoted entry must be escaped with a backslash. - Escaping is not supported in non-quoted entries. - Linefeed escape sequences (\\n) are supported in quoted strings. - Linefeed escape sequences are trimmed from the end of an entry. **-T**, **--with-timestamps** This option can be only used with **--input-file** option. Each line of the input file must contain 4 whitespace delimited entries: **<hostname> <key> <timestamp> <value>**. Timestamp should be specified in Unix timestamp format. If target item has triggers referencing it, all timestamps must be in an increasing order, otherwise event calculation will not be correct. An example of a line of the input file: **"Linux DB3" db.connections 1429533600 43** For more details please see option **--input-file**. If a timestamped value is sent for a host that is in a “no data” maintenance type then this value will be dropped; however, it is possible to send a timestamped value in for an expired maintenance period and it will be accepted. **-N**, **--with-ns** This option can be only used with **--with-timestamps** option. Each line of the input file must contain 5 whitespace delimited entries: **<hostname> <key> <timestamp> <ns> <value>**. An example of a line of the input file: **"Linux DB3" db.connections 1429533600 7402561 43** For more details please see option **--input-file**. **-r**, **--real-time** Send values one by one as soon as they are received. This can be used when reading from standard input. **--tls-connect** *value* How to connect to server or proxy. Values: [ ]{#lbAF} ## オプション **-c**, **--config** *config-file* *config-file*を使用します。**Zabbix sender**は、エージェントの設定ファイルからサーバーの詳細を読み取ります。デフォルトでは**Zabbix sender**は設定ファイルを読み取りません。次のパラメーターがサポートされています: **Hostname**, **ServerActive**, **SourceIP**, **TLSConnect**, **TLSCAFile**, **TLSCRLFile**, **TLSServerCertIssuer**, **TLSServerCertSubject**, **TLSCertFile**, **TLSKeyFile**, **TLSPSKIdentity**, **TLSPSKFile**。**HostnameItem**パラメーターで定義されたホスト名は選択されません。この場合、ホスト名はコマンド ラインで指定する必要があります (-sオプションを参照)。エージェントの**ServerActive**設定パラメーターで定義されたすべてのアドレスは、データの送信に使用されます。1つのアドレスへのバッチデータの送信に失敗した場合、そのアドレスには以降のバッチは送信されません。 **-z**, **--zabbix-server** *server* Zabbixサーバーのホスト名またはIPアドレス。ホストがプロキシによって監視されている場合は、代わりにプロキシのホスト名またはIPアドレスを使用する必要があります。**--config** と一緒に使用すると、エージェントの設定ファイルで指定された**ServerActive**パラメーターのエントリが上書きされます。 **-p**, **--port** *port* サーバー上で実行されているZabbixサーバートラッパーのポート番号を指定します。デフォルトは10051です。**--config**と一緒に使用すると、エージェントの設定ファイルで指定された**ServerActive**パラメーターのポートエントリが上書きされます。 **-I**, **--source-address** *IP-address* ソースIPアドレスを指定します。**--config**と一緒に使用すると、エージェントの設定ファイルで指定された**SourceIP**パラメーターが上書きされます。 **-t**, **--timeout** *seconds* タイムアウトを指定します。有効範囲: 1~300秒 (デフォルト: 60) **-s**, **--host** *host* アイテムが属するホスト名を指定します (Zabbix Webインターフェースに登録されている通り)。ホストのIPアドレスとDNS名は機能しません。**--config**と一緒に使用すると、エージェントの設定ファイルで指定された**Hostname**パラメーターが上書きされます。 **-k**, **--key** *key* 値を送信するアイテムキーを指定します。 **-o**, **--value** *value* アイテムの値を指定します。 **-i**, **--input-file** *input-file* 入力ファイルから値を読み込みます。**<input-file>**を**-**と指定すると、標準入力から値を読み取ることができます。ファイルの各行には空白で区切られた**<hostname> <key> <value>** を含める必要があり、各値はそれぞれの行で指定する必要があります。3エントリの詳細は次の通りです: **<hostname> <key> <value>** , "hostname"はZabbix Webインターフェースに登録されている監視対象ホストの名前、"key"はターゲットのアイテムキー、"value"は送信する値です。**<hostname>**を**-**と指定するとエージェントの設定ファイルまたは **--host**引数からホスト名を使用します。 入力ファイルの行の例： **"Linux DB3" db.connections 43** Zabbix Webインターフェースのアイテム設定で値の型を正しく設定する必要があります。Zabbixセンダーは1回の接続で最大250個の値を送信します。 入力ファイルから値を送信する場合の[サイズ制限](/manual/appendix/protocols/header_datalen)は、Zabbixコミュニケーションプロトコルに記載されているサイズに依存します。 入力ファイルの内容は、UTF-8エンコーディングでなければなりません。 入力ファイルの値は、すべて上から順に送信されます。 エントリは次の規則に従ってフォーマットする必要があります: - 引用されたエントリと引用されていないエントリがサポートされています。 - 二重引用符を引用文字として使用します。 - 空白を含むエントリは引用符で囲む必要があります。 - 引用符で囲まれたエントリ内の二重引用符とバックスラッシュ文字は、バックスラッシュでエスケープする必要があります。 - 引用符で囲まれていないエントリでは、エスケープはサポートされていません。 - 改行エスケープシーケンス (\\n) は、引用符で囲まれた文字列でサポートされています。 - 改行エスケープシーケンスは、エントリの末尾から削除されます。 **-T**, **--with-timestamps** このオプションは、**--input-file**オプションでのみ使用できます。 入力ファイルの各行には、空白で区切られた4つのエントリが含まれている必要があります: **<hostname> <key> <timestamp> <value>**。 タイムスタンプはUnixタイムスタンプ形式で指定する必要があります。ターゲットのアイテムにそれを参照するトリガーがある場合、すべてのタイムスタンプは昇順でなければなりません。そうしないと、イベントの計算が正しく行われません。 入力ファイルの行の例： **"Linux DB3" db.connections 1429533600 43** 詳細については、オプション**--input-file**を参照してください。 メンテナンスタイプが"データなし"のホストにタイムスタンプ付きの値が送信された場合、この値は削除されます。 ただし、期限切れのメンテナンス期間にタイムスタンプ付きの値を送信することは可能であり、それは受け入れられます。 **-N**, **--with-ns** このオプションは、**--with-timestamps**オプションでのみ使用できます。 入力ファイルの各行には、空白で区切られた5つのエントリが含まれている必要があります: **<hostname> <key> <timestamp> <ns> <value>**。 入力ファイルの行の例： **"Linux DB3" db.connections 1429533600 7402561 43** 詳細については、オプション**--input-file**を参照してください。 **-r**, **--real-time** 値を受信したらすぐに1つずつ送信します。これは標準入力から読み取る場合にも使用できます。 **--tls-connect** *value* サーバーまたはプロキシへの接続方法。値 : [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## オプション **-c**, **--config** *config-file* デフォルトの設定ファイルの代わりに*config-file*で指定されたファイルを使用します。 **-f**, **--foreground** Zabbixエージェントをフォアグラウンドで実行します。 **-R**, **--runtime-control** *runtime-option* *runtime-option*に従って管理機能を実行します。 [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix proxy in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## オプション **-c**, **--config** *config-file* デフォルトの設定ファイルの代わりに*config-file*で指定されたファイルを使用します。 **-f**, **--foreground** Zabbixプロキシをフォアグラウンドで実行します。 **-R**, **--runtime-control** *runtime-option* *runtime-option*に従って管理機能を実行します。 [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix server in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. Examples of running Zabbix server with command line parameters: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## オプション **-c**, **--config** *config-file* デフォルトの設定ファイルの代わりに*config-file*で指定されたファイルを使用します。 **-f**, **--foreground** Zabbixサーバーをフォアグラウンドで実行します。 **-R**, **--runtime-control** *runtime-option* *runtime-option*に従って管理機能を実行します。 **-h**, **--help** このヘルプを表示して終了します。 **-V**, **--version** バージョン情報を表示して終了します。 コマンドラインパラメーターを使用したZabbixサーバーの実行例: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## オプション **-c**, **--config** *config-file* デフォルトの設定ファイルの代わりに*config-file*で指定されたファイルを使用します。 **-h**, **--help** ヘルプを表示して終了します。 **-V**, **--version** バージョン情報を出力して終了します。 [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## オプション **-c**, **--config** *config-file* デフォルトの設定ファイルの代わりに、別の*config-file*を使用します。 **-R**, **--runtime-control** *runtime-option* *runtime-option*に従って管理機能を実行します。 ### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| ### オプション |パラメータ|説明| |---------|-----------| |-V --version|プラグインのバージョンとライセンス情報を表示します| |-h --help|Prヘルプ情報を表示します (省略形)| #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### オプション |パラメータ|説明| |---------|-----------| |-V --version|プラグインのバージョンとライセンス情報を表示します| |-h --help|ヘルプ情報を表示します (省略形)| ## OPTIONS **-s**, **--host** *host-name-or-IP* Specify host name or IP address of a host. **-p**, **--port** *port-number* Specify port number of agent running on the host. Default is 10050. **-I**, **--source-address** *IP-address* Specify source IP address. **-t**, **--timeout** *seconds* Specify timeout. Valid range: 1-30 seconds (default: 30) **-k**, **--key** *item-key* Specify key of item to retrieve value for. **--tls-connect** *value* How to connect to agent. Values: [ ]{#lbAF} ## オプション **-s**, **--host** *host-name-or-IP* ホスト名またはホストのIPアドレスを指定します。 **-p**, **--port** *port-number* ホスト上で動作するエージェントのポート番号を指定します。 デフォルトは10050です。 **-I**, **--source-address** *IP-address* ソースIPアドレスを指定します。 **-t**, **--timeout** *seconds* タイムアウトを指定します。有効範囲: 1-30 秒 (デフォルト: 30) **-k**, **--key** *item-key* 値を取得するアイテムのキーを指定します。 **--tls-connect** *value* エージェントへの接続方法。値: [ ]{#lbAF} ## OPTIONS **-s**, **--script** *script-file* Specify the file name of the script to execute. If '-' is specified as file name, the script will be read from stdin. **-p**, **--param** *input-param* Specify the input parameter. **-i**, **--input** *input-file* Specify the file name of the input parameter. If '-' is specified as file name, the input will be read from stdin. **-l**, **--loglevel** *log-level* Specify the log level. **-t**, **--timeout** *timeout* Specify the timeout in seconds. Valid range: 1\-60 seconds (default: 10) **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## オプション **-s**, **--script** *script-file* 実行するスクリプトのファイル名を指定します。ファイル名に'-'を指定するとスクリプトは標準入力から読み込まれます。 **-p**, **--param** *input-param* 入力パラメーターを指定します。 **-i**, **--input** *input-file* 入力パラメーターのファイル名を指定します。ファイル名に'-'を指定すると入力は標準入力から読み込まれます。 **-l**, **--loglevel** *log-level* ログレベルを指定します。 **-t**, **--timeout** *timeout* タイムアウトを秒単位で指定します。有効範囲: 1\-60秒 (デフォルト: 10) **-h**, **--help** ヘルプを表示して終了します。 **-V**, **--version** バージョン情報を表示して終了します。 [ ]{#lbAF} #### Options The following command line parameters can be used with Zabbix agent 2: |Parameter|Description| |--|--------| |-c --config <config-file>|Path to the configuration file.<br>You may use this option to specify a configuration file that is not the default one.<br>On UNIX, default is /usr/local/etc/zabbix\_agent2.conf or as set by [compile-time](/manual/installation/install#installing_zabbix_daemons) variables *--sysconfdir* or *--prefix*| |-f --foreground|Run Zabbix agent in foreground (default: true).| |-p --print|Print known items and exit.<br>*Note*: To return [user parameter](/manual/config/items/userparameters) results as well, you must specify the configuration file (if it is not in the default location).| |-t --test <item key>|Test specified item and exit.<br>*Note*: To return [user parameter](/manual/config/items/userparameters) results as well, you must specify the configuration file (if it is not in the default location).| |-h --help|Print help information and exit.| |-v --verbose|Print debugging information. Use this option with -p and -t options.| |-V --version|Print agent version and license information.| |-R --runtime-control <option>|Perform administrative functions. See [runtime control](/manual/concepts/agent2#runtime_control).| Specific **examples** of using command line parameters: - print all built-in agent items with values - test a user parameter with "mysql.ping" key defined in the specified configuration file ```{=html} <!-- --> ``` zabbix_agent2 --print zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf #### オプション Zabbixエージェント2では次のコマンドラインパラメーターを使用できます: |パラメーター|説明| |--|--------| |-c --config <config-file>|設定ファイルへのパスを指定します。<br>このオプションを使用してデフォルトではない設定ファイルを指定できます。<br>UNIXの場合、デフォルトは/usr/local/etc/zabbix\_agent2.confであるか、[コンパイル時](/manual/installation/install#installing_zabbix_daemons)の変数*--sysconfdir*または*--prefix*で設定されます。| |-f --foreground|Zabbixエージェントをフォアグラウンドで実行します(デフォルト: true)。| |-p --print|既知のアイテムを出力して終了します。<br>*注*: [ユーザーパラメーター](/manual/config/items/userparameters)の結果も返すには、(デフォルトの場所にない場合は)設定ファイルを指定する必要があります。| | -t --test <item key>|指定されたアイテムをテストして終了します。<br>*注*: [ユーザーパラメーター](/manual/config/items/userparameters)の結果も返すには、(デフォルトの場所にない場合は)設定ファイルを指定する必要があります。| |-h --help|ヘルプを出力して終了します。| |-v --verbose|デバッグ情報を出力します。 このオプションは-pおよび-tオプションとともに使用します。| |-V --version|エージェントのバージョン番号を出力して終了します。| |-R --runtime-control <option>|管理機能を実行します。 [ランタイム制御](/manual/concepts/agent2#ランタイム制御)を参照してください。| コマンドラインパラメーターの使用の具体的な**例**: - すべての組み込みエージェントアイテムの値を出力する - 指定された設定ファイルで定義された"mysql.ping"キーを使用してユーザーパラメーターをテストする ```{=html} <!-- --> ``` zabbix_agent2 --print zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf #### Oracle Export and import must be performed in tmux/screen, so that the session isn't dropped. ##### Importing/exporting history tables in one attempt * Install Oracle Data Pump ([Instant Client Tools package](https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html) contains it). Additionally, consider [performance tips](https://docs.oracle.com/en/database/oracle/oracle-database/19/sutil/oracle-data-pump-performance-tips.html) for Oracle Data Pump. * Rename tables using `history_pk_prepare.sql`. ``` shell> cd /path/to/zabbix-sources/database/oracle shell> sqlplus zabbix/password@oracle_host/ORCL sqlplus> @history_pk_prepare.sql ``` * Prepare directories for datapump Example: ``` # mkdir -pv /export/history # chown -R oracle:oracle /export ``` * Create a directory object, grant permissions to it. Run the following under sysdba role: ``` create directory history as '/export/history'; grant read,write on directory history to zabbix; ``` * Export tables. Replace N with your desired thread count. ``` expdp zabbix/password@172.20.0.3:1521/z \ DIRECTORY=history \ TABLES=history_old,history_uint_old,history_str_old,history_log_old,history_text_old \ PARALLEL=N ``` * Import tables. Replace N with your desired thread count. ``` impdp zabbix/password@172.20.0.3:1521/z \ 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 ``` * Verify that everything works as supposed * Drop old tables ``` DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ##### Importing/exporting history tables individually * Install Oracle Data Pump ([Instant Client Tools package](https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html) contains it). Additionally, consider [performance tips](https://docs.oracle.com/en/database/oracle/oracle-database/19/sutil/oracle-data-pump-performance-tips.html) for Oracle Data Pump. * Rename tables using `history_pk_prepare.sql`. ``` shell> cd /path/to/zabbix-sources/database/oracle shell> sqlplus zabbix/password@oracle_host/ORCL sqlplus> @history_pk_prepare.sql ``` * Prepare directories for datapump Example: ``` # mkdir -pv /export/history /export/history_uint /export/history_str /export/history_log /export/history_text # chown -R oracle:oracle /export ``` * Create a directory object, grant permissions to it. Run the following under sysdba role: ``` create directory history as '/export/history'; grant read,write on directory history to zabbix; create directory history_uint as '/export/history_uint'; grant read,write on directory history_uint to zabbix; create directory history_str as '/export/history_str'; grant read,write on directory history_str to zabbix; create directory history_log as '/export/history_log'; grant read,write on directory history_log to zabbix; create directory history_text as '/export/history_text'; grant read,write on directory history_text to zabbix; ``` * Export and import each table. Replace N with your desired thread count. ``` expdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history TABLES=history_old PARALLEL=N impdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history TABLES=history_old REMAP_TABLE=history_old:history data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_uint TABLES=history_uint_old PARALLEL=N impdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_uint TABLES=history_uint_old REMAP_TABLE=history_uint_old:history_uint data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_str TABLES=history_str_old PARALLEL=N impdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_str TABLES=history_str_old REMAP_TABLE=history_str_old:history_str data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_log TABLES=history_log_old PARALLEL=N impdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_log TABLES=history_log_old REMAP_TABLE=history_log_old:history_log data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_text TABLES=history_text_old PARALLEL=N impdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_text TABLES=history_text_old REMAP_TABLE=history_text_old:history_text data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only ``` * Verify that everything works as supposed * Drop old tables ``` DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` #### Oracle Export and import must be performed in tmux/screen, so that the session isn't dropped. ##### Importing/exporting history tables in one attempt * Install Oracle Data Pump ([Instant Client Tools package](https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html) contains it). Additionally, consider [performance tips](https://docs.oracle.com/en/database/oracle/oracle-database/19/sutil/oracle-data-pump-performance-tips.html) for Oracle Data Pump. * Rename tables using [history_pk_prepare.sql](https://git.zabbix.com/projects/ZBX/repos/zabbix/commits/fa073f5697a8a6d1a2b3b34b0335c88a02dc8365) * Prepare directories for datapump Example: ``` # mkdir -pv /export/history # chown -R oracle:oracle /export ``` * Create a directory object, grant permissions to it. Run the following under sysdba role: ``` create directory history as '/export/history'; grant read,write on directory history to zabbix; ``` * Export tables. Replace N with your desired thread count. ``` expdp zabbix/password@172.20.0.3:1521/z \ DIRECTORY=history \ TABLES=history_old,history_uint_old,history_str_old,history_log_old,history_text_old \ PARALLEL=N ``` * Import tables. Replace N with your desired thread count. ``` impdp zabbix/password@172.20.0.3:1521/z \ 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 ``` * Verify that everything works as supposed * Drop old tables ``` DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ##### Importing/exporting history tables individually * Install Oracle Data Pump ([Instant Client Tools package](https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html) contains it). Additionally, consider [performance tips](https://docs.oracle.com/en/database/oracle/oracle-database/19/sutil/oracle-data-pump-performance-tips.html) for Oracle Data Pump. * Rename tables using [history_pk_prepare.sql](https://git.zabbix.com/projects/ZBX/repos/zabbix/commits/fa073f5697a8a6d1a2b3b34b0335c88a02dc8365) * Prepare directories for datapump Example: ``` # mkdir -pv /export/history /export/history_uint /export/history_str /export/history_log /export/history_text # chown -R oracle:oracle /export ``` * Create a directory object, grant permissions to it. Run the following under sysdba role: ``` create directory history as '/export/history'; grant read,write on directory history to zabbix; create directory history_uint as '/export/history_uint'; grant read,write on directory history_uint to zabbix; create directory history_str as '/export/history_str'; grant read,write on directory history_str to zabbix; create directory history_log as '/export/history_log'; grant read,write on directory history_log to zabbix; create directory history_text as '/export/history_text'; grant read,write on directory history_text to zabbix; ``` * Export and import each table. Replace N with your desired thread count. ``` expdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history TABLES=history_old PARALLEL=N impdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history TABLES=history_old REMAP_TABLE=history_old:history data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_uint TABLES=history_uint_old PARALLEL=N impdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_uint TABLES=history_uint_old REMAP_TABLE=history_uint_old:history_uint data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_str TABLES=history_str_old PARALLEL=N impdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_str TABLES=history_str_old REMAP_TABLE=history_str_old:history_str data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_log TABLES=history_log_old PARALLEL=N impdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_log TABLES=history_log_old REMAP_TABLE=history_log_old:history_log data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_text TABLES=history_text_old PARALLEL=N impdp zabbix/password@172.20.0.3:1521/xe DIRECTORY=history_text TABLES=history_text_old REMAP_TABLE=history_text_old:history_text data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only ``` * Verify that everything works as supposed * Drop old tables ``` DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` #### Oracle Instructions for creating and configuring Oracle database are provided in a separate [section](/manual/appendix/install/oracle). #### Oracle Oracleデータベースの作成と設定の手順は、別の[セクション](/manual/appendix/install/oracle)に記載されています。 #### Ordering shapes and lines To bring one shape in front of the other (or vice versa) click on the shape with the right mouse button bringing up the map shape menu.  #### 図形と線の順序付け ある図形を他の図形より前に（またはその逆に）持ってくるには、その図形をマウスの右ボタンでクリックし、地図の<br> 図形メニューを表示させます。  #### Other agent options It is possible to run multiple instances of the agent on a host. A single instance can use the default configuration file or a configuration file specified in the command line. In case of multiple instances each agent instance must have its own configuration file (one of the instances can use the default configuration file). The following command line parameters can be used with Zabbix agent: |Parameter|Description| |--|--------| |**UNIX and Windows agent**|<| |-c --config <config-file>|Path to the configuration file.<br>You may use this option to specify a configuration file that is not the default one.<br>On UNIX, default is /usr/local/etc/zabbix\_agentd.conf or as set by [compile-time](/manual/installation/install#installing_zabbix_daemons) variables *--sysconfdir* or *--prefix*<br>On Windows, default is c:\\zabbix\_agentd.conf| |-p --print|Print known items and exit.<br>*Note*: To return [user parameter](/manual/config/items/userparameters) results as well, you must specify the configuration file (if it is not in the default location).| |-t --test <item key>|Test specified item and exit.<br>*Note*: To return [user parameter](/manual/config/items/userparameters) results as well, you must specify the configuration file (if it is not in the default location).| |-h --help|Display help information| |-V --version|Display version number| |**UNIX agent only**|<| |-R --runtime-control <option>|Perform administrative functions. See [runtime control](/manual/concepts/agent#runtime_control).| |**Windows agent only**|<| |-m --multiple-agents|Use multiple agent instances (with -i,-d,-s,-x functions).<br>To distinguish service names of instances, each service name will include the Hostname value from the specified configuration file.| |**Windows agent only (functions)**|<| |-i --install|Install Zabbix Windows agent as service| |-d --uninstall|Uninstall Zabbix Windows agent service| |-s --start|Start Zabbix Windows agent service| |-x --stop|Stop Zabbix Windows agent service| Specific **examples** of using command line parameters: - printing all built-in agent items with values - testing a user parameter with "mysql.ping" key defined in the specified configuration file - installing a "Zabbix Agent" service for Windows using the default path to configuration file c:\\zabbix\_agentd.conf - installing a "Zabbix Agent \[Hostname\]" service for Windows using the configuration file zabbix\_agentd.conf located in the same folder as agent executable and make the service name unique by extending it by Hostname value from the config file ```{=html} <!-- --> ``` zabbix_agentd --print zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf zabbix_agentd.exe -i zabbix_agentd.exe -i -m -c zabbix_agentd.conf #### その他のエージェントオプション ホスト上でエージェントは複数のインスタンスを実行することができます。 単一のインスタンスは、デフォルトの設定ファイルまたはコマンドラインで指定された設定ファイルを利用できます。複数の場合には、各エージェントインスタンス毎に独自の設定ファイルが必要です (1つのインスタンスはデフォルトの設定ファイルを使用できます)。 Zabbixエージェントでは、次のコマンドラインパラメーターを使用できます: |パラメーター|説明| |--|--------| |**UNIXおよびWindowsエージェント**|<| |-c --config <config-file>|設定ファイルへのパス。<br>このオプションを使用して、デフォルト以外の設定ファイルを指定できます。<br>UNIXでは、デフォルトは/usr/local/etc/zabbix\_agentd.confまたは[コンパイル時](/manual/installation/install#installing_zabbix_daemons)変数*--sysconfdir*または*--prefix*で設定されたもの。<br>Windowsでは、デフォルトはc:\ \zabbix\_agentd.conf| |-p --print|既知の項目を出力して終了します。<br>*注*: [ユーザーパラメーター](/manual/config/items/userparameters)の結果も返すには、設定ファイルを指定する必要があります (デフォルトの場所にない場合)。| |-t --test <item key>|指定されたアイテムをテストして終了します。<br>*注*: [ユーザーパラメーター](/manual/config/items/userparameters)の結果も返すには、設定ファイルを指定する必要があります (デフォルトの場所にない場合)。| |-h --help|ヘルプ情報を表示| |-V --version|バージョン番号を表示| |**UNIXエージェントのみ**|<| |-R --runtime-control <option>|管理機能を実行します。 [ランタイム制御](/manual/concepts/agent#ランタイム制御)を参照してください。| |**Windowsエージェントのみ**|<| |-m --multiple-agents|複数のエージェントインスタンスを使用します (-i、-d、-s、-x ファンクションと共に)。<br>インスタンスのサービス名を区別するために、各サービス名には設定ファイルで指定されたHostnameの値が含まれます。| |**Windowsエージェントのみ (ファンクション)**|<| |-i --install|Zabbix Windows エージェントをサービスとしてインストール| |-d --uninstall|Zabbix Windowsエージェントサービスをアンインストール| |-s --start|Zabbix Windowsエージェントサービスを開始| |-x --stop|Zabbix Windowsエージェントサービスを停止| コマンドラインパラメーターを使用する具体的な**例**: - すべてのビルトインエージェントアイテムを値とともに出力します。 - 指定した設定ファイル内で定義された"mysql.ping"キーを使用したユーザー パラメータのテスト - Windows用の"Zabbix Agent"サービスをインストールします。デフォルトの設定ファイルへのパス c:\\zabbix\_agentd.conf - Windows用の"Zabbix Agent \[Hostname\]"サービスをインストールします。エージェントが実行可能な、同じ場所にある設定ファイルフォルダのzabbix\_agentd.confをHostnameの値で拡張してサービス名を一意にします。 ```{=html} <!-- --> ``` zabbix_agentd --print zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf zabbix_agentd.exe -i zabbix_agentd.exe -i -m -c zabbix_agentd.conf ### Other changes and bug fixes ### その他の変更点およびバグフィックス #### Other details - An Admin level user with *Read-write* access to a host will not be able to link/unlink templates, if he has no access to the *Templates* group. With *Read* access to *Templates* group he will be able to link/unlink templates to the host, however, will not see any templates in the template list and will not be able to operate with templates in other places. - An Admin level user with *Read* access to a host will not see the host in the configuration section host list; however, the host triggers will be accessible in IT service configuration. - Any non-Super Admin user (including 'guest') can see network maps as long as the map is empty or has only images. When hosts, host groups or triggers are added to the map, permissions are respected. - Zabbix server will not send notifications to users defined as action operation recipients if access to the concerned host is explicitly "denied". #### その他の詳細 - ホストへの*表示/設定*のアクセス権を持つAdminレベルのユーザーは、*Templates*グループへのアクセス権を持っていない場合、テンプレートのリンク/リンクの削除することはできません。Templatesグループへの*表示のみ*のアクセス権を持つユーザーは、 ホストへのテンプレートのリンク/アンリンクを解除できますが、テンプレートリスト内のテンプレートは表示されず、他の場所のテンプレートで操作することはできません。 - ホストへの*表示のみ*アクセス権を持つAdminレベルのユーザーは、メニュー設定のホストリストでホストを見ることはできませんが、 ITサービス設定でホストトリガーにアクセスできます。 - 特権管理者以外の('guest'を含む)ユーザーは、マップが空であるかイメージのみである限り、ネットワークマップを見ることができます。 ホスト、ホストグループ、トリガーがマップに追加されると権限が優先されます。 - Zabbixサーバは、アクションの実行内容の送信先に指定されたユーザに対して、該当ホストへのアクセスが明示的に"拒否"されている場合、 通知を送信しません。 ##### Other expressions Function parameters may contain other expressions, as in the following syntax: min(min(/host/key,1h),min(/host2/key2,1h)*10) Note that other expressions may not be used, if the function references item history. For example, the following syntax is not allowed: ~~`min(/host/key,#5*10)`~~ ##### その他の式 関数のパラメータは、次のように他の式を含むことができます。 min(min(/host/key,1h),min(/host2/key2,1h)*10) 関数が item history を参照する場合、他の式を使用することはできませんのでご注意ください。<br> 例えば、次のような構文は使用できません。 ~~`min(/host/key,#5*10)`~~ ##### Other expressions Function parameters may contain other expressions,​ as in the following syntax: min(min(/​host/​key,​1h),​min(/​host2/​key2,​1h)*10) Note that other expressions may not be used, if the function references item history. For example, the following syntax is not allowed: ~~`min(/​host/​key,#5*10)`~~ ##### Other expressions Function parameters may contain other expressions,​ as in the following syntax: min(min(/​host/​key,​1h),​min(/​host2/​key2,​1h)*10) Note that other expressions may not be used, if the function references item history. For example, the following syntax is not allowed: ~~`min(/​host/​key,#5*10)`~~ **Other hardware** A serial communication port and a serial GSM modem are required for using SMS notification support in Zabbix. USB-to-serial converter will also work. **その他のハードウェア** ZabbixでSMS通知サポートを使用するには、シリアル通信ポートとシリアルGSMモデムが必要です。USBシリアルコンバータも使用できます。 ##### Other issues A backslash character in an attribute name should be escaped: jmx[com.example:type=Hello,c:\\documents] For handling any other special characters in JMX item key, please see the item key format [section](/manual/config/items/item/key#parameter---quoted-string). This is actually all there is to it. Happy JMX monitoring! ##### その他の問題 属性名中のバックスラッシュ文字はエスケープする必要があります: JMX[com.example:type=Hello,c:\documents] JMX item キーのその他の特殊文字の扱いについては、アイテムキー形式 [section] (/manual/config/items/item/key##parameter_-_quoted_string) を参照してください。 実はこれだけなんです。それでは、JMXの監視をお楽しみください。 #### Output value JSONPaths can be divided in definite and indefinite paths. A definite path can return only null or a single match. An indefinite path can return multiple matches, basically JSONPaths with detached, multiple name/index list, array slice or expression segments. However, when a function is used the JSONPath becomes definite, as functions always output single value. A definite path returns the object/array/value it's referencing, while indefinite path returns an array of the matched objects/arrays/values. ::: noteimportant The property order in JSONPath query results may not align with the original JSON property order due to internal optimization methods. For example, the JSONPath `$.books[1]["author", "title"]` may return `["title", "author"]`. If preserving the original property order is essential, alternative post-query processing methods should be considered. ::: #### 出力値 JSONPathsは、定型パスと不定型パスに分けることができます。<br> 定型パスは、NULLまたは単一のマッチのみを返すことができます。<br> 不定型パスは、複数の名前/インデックスリスト、配列スライス、 式セグメントを含む JSONPath を返します。<br> しかし関数が使用されると、JSONPath は定型的なものになります。関数は常に単一の値を出力するからです。<br> 定型パスは、参照するオブジェクト/配列/値を返します。<br> 不定形のパスは、マッチしたオブジェクト/配列/値の配列を返します。 ::: noteimportant 内部の最適化方法により、JSONPath クエリ結果のプロパティ順序は、元の JSON プロパティ順序と一致しない場合があります。たとえば、JSONPath `$.books[1]["author", "title"]` は `["title", "author"]` を返す場合があります。元のプロパティ順序を維持することが不可欠な場合は、クエリ後の代替処理方法を検討する必要があります。 ::: #### Overrides The following parameters are supported for configuring *Overrides*. ::: noteclassic The first number in the property name (e.g. or.hosts.0.0, or.items.0.0) represents the particular data set, while the second number, if present, represents the configured host or item. ::: |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |***Host pattern***<br>(required)|1|or.hosts.0.0|[Host](/manual/api/reference/host/get) name or pattern (e.g. `Zabbix*`).| |***Item pattern***<br>(required)|1|or.items.0.0|[Item](/manual/api/reference/item/get) name or pattern (e.g. `*: Number of processed *values per second`).| |*Base color*|1|or.color.0|Hexadecimal color code (e.g. `FF0000`).| |*Width*|0|or.width.0|Valid values range from 1-10.| |*Draw*|0|or.type.0|0 - Line;<br>1 - Points;<br>2 - Staircase;<br>3 - Bar.| |*Transparency*|0|or.transparency.0|Valid values range from 1-10.| |*Fill*|0|or.fill.0|Valid values range from 1-10.| |*Point size*|0|or.pointsize.0|Valid values range from 1-10.| |*Missing data*|0|or.missingdatafunc.0|0 - None;<br>1 - Connected;<br>2 - Treat as 0.| |*Y-axis*|0|or.axisy.0|0 - Left;<br>1 - Right.| |*Time shift*|1|or.timeshift.0|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes). Negative values are allowed.| #### オーバーライド *オーバーライド*の設定には、以下のパラメーターがサポートされています。 ::: noteclassic プロパティ名の最初の数字（例：or.hosts.0.0、or.items.0.0）は特定のデータセットを表し、2番目の数字が存在する場合は設定されたホストまたはアイテムを表します。 ::: |パラメーター|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |***ホストパターン***<br>(必須)|1|or.hosts.0.0|[ホスト](/manual/api/reference/host/get) の名前またはパターン（例：`Zabbix*`）| |***アイテムパターン***<br>(必須)|1|or.items.0.0|[アイテム](/manual/api/reference/item/get) の名前またはパターン (例: `*: 1 秒あたりに処理される *値の数`)| |*基本色*|1|or.color.0|16 進数のカラーコード (例: `FF0000`)| |*幅*|0|or.width.0|有効な値の範囲は 1～10 です。| |*描画*|0|or.type.0|0 - 線、<br>1 - 点、<br>2 - 階段、<br>3 - 棒| |*透明度*|0|or.transparency.0|有効な値の範囲は 1～10 です。| |*塗りつぶし*|0|or.fill.0|有効な値の範囲は 1～10 です。| |*ポイントサイズ*|0|または.pointsize.0|有効な値の範囲は1～10です。| |*欠損データ*|0|または.missingdatafunc.0|0 - なし;<br>1 - 接続済み;<br>2 - 0として扱う。| |*Y軸*|0|または.axisy.0|0 - 左;<br>1 - 右| |*時間シフト*|1|または.timeshift.0|有効な時間文字列（例：`3600`、`1h`など）<br>[時間サフィックス](/manual/appendix/suffixes#time-suffixes)を使用できます。負の値も使用できます。| #### Overview Aggregate calculations are a [calculated item](/manual/config/items/itemtypes/calculated) type allowing to collect information from several items by Zabbix server and then calculate an aggregate, depending on the aggregate function used. Only unsigned integer and float values (type of information) are supported for aggregate calculation items. Aggregate calculations do not require any agent running on the host being monitored. #### 概要 集計計算は、Zabbixサーバーによって複数のアイテムから情報を収集し、使用する集計関数に応じて集計を計算できる[計算アイテム](/manual/config/items/itemtypes/calculated)タイプです。 集計計算アイテムでは、符号なしの整数値と浮動小数点値(情報の種類)のみがサポートされています。 集計計算では、監視対象のホストでエージェントを実行する必要はありません。 #### Overview All users in Zabbix access the Zabbix application through the web-based frontend. Each user is assigned a unique login name and a password. All user passwords are encrypted and stored in the Zabbix database. Users cannot use their user id and password to log directly into the UNIX server unless they have also been set up accordingly to UNIX. Communication between the web server and the user browser can be protected using SSL. With a flexible [user permission schema](/manual/config/users_and_usergroups/permissions) you can restrict and differentiate rights to: - access administrative Zabbix frontend functions - perform certain actions in the frontend - access monitored hosts in hostgroups - use specific API methods #### 概要 Zabbix のすべてのユーザは、Webベースのフロントエンドから Zabbix アプリケーションにアクセスします。各ユーザーには<br> 固有のログイン名とパスワードが割り当てられます。<br> 全てのユーザパスワードは暗号化され、Zabbix のデータベースに保存されます。ユーザーは、UNIXに応じた設定をしていない限り、<br> ユーザーIDとパスワードを使用してUNIXサーバに直接ログインすることはできません。Webサーバとユーザブラウザ間の通信はSSLを使用して<br> 保護することができます。 柔軟な[ユーザ権限定義](/manual/config/users_and_usergroups/permissions)により、以下の権限を制限し差別化することができます: - Zabbixフロントエンドの管理用機能へのアクセス - フロントエンドでの特定のアクションの実行 - ホストグループ内の監視対象ホストへのアクセス - 特定のAPIメソッドの使用 #### Overview An item is an individual metric. Items are used for collecting data. Once you have configured a host, you must add items to get actual data. One way of quickly adding many items is to attach one of the predefined templates to a host. However, for optimized system performance, you may need to fine-tune the templates to have as many items and as frequent monitoring as necessary. To specify what sort of data to collect from a host, use the [item key](/manual/config/items/item/key). For example, an item with the key name **system.cpu.load** will collect processor load data, while an item with the key name **net.if.in** will collect incoming traffic information. Additional parameters can be specified in square brackets after the key name. For example, system.cpu.load**\[avg5\]** will return the processor load average for the last 5 minutes, while net.if.in**\[eth0\]** will show incoming traffic in the interface "eth0". ::: noteclassic See individual sections of [item types](/manual/config/items/itemtypes) for all supported item types and item keys. ::: Proceed to [creating and configuring an item](/manual/config/items/item). #### 概要 アイテムは個別の指標です。 アイテムはデータ収集に使用されます。 ホストを設定したら、実際のデータを取得するためのアイテムを追加する必要があります。 多くのアイテムをすばやく追加する方法は、事前定義されたテンプレートの1つをホストにアタッチすることです。 ただし、システムのパフォーマンスを最適化するには、必要なだけのアイテムと頻度の監視を行うようにテンプレートを微調整する必要があります。 ホストからどのようなデータを収集するかを指定するには、[アイテムキー](/manual/config/items/item/key)を使用します。 たとえば、キー名**system.cpu.load**のアイテムはプロセッサ負荷データを収集し、キー名**net.if.in**のアイテムは受信トラフィック情報を収集します。 キー名の後の角括弧内に追加のパラメーターを指定できます。 たとえば、system.cpu.load**\[avg5\]** は過去5分間のプロセッサ負荷平均を返し、net.if.in**\[eth0\]** はインターフェース"eth0"の受信トラフィックを表示します。 ::: noteclassic サポートされているすべてのアイテムタイプとアイテムキーについては、[アイテムタイプ](/manual/config/items/itemtypes)の個々のセクションを参照してください。 ::: [アイテムの作成と設定](/manual/config/items/item)に進んでください。 #### Overview An optional context can be used in [user macros](/manual/config/macros/user_macros), allowing to override the default value with a context-specific one. The context is appended to the macro name; the syntax depends on whether the context is a static text value: {$MACRO:"static text"} or a regular expression: {$MACRO:regex:"regular expression"} Note that a macro with regular expression context can only be defined in user macro configuration. If the `regex:` prefix is used elsewhere as user macro context, like in a trigger expression, it will be treated as static context. Context quoting is optional (see also [important notes](#important_notes)). Macro context examples: |Example|Description| |-------|-----------| |`{$LOW_SPACE_LIMIT}`|User macro without context.| |`{$LOW_SPACE_LIMIT:/tmp}`|User macro with context (static string).| |`{$LOW_SPACE_LIMIT:regex:"^/tmp$"}`|User macro with context (regular expression). Same as `{$LOW_SPACE_LIMIT:/tmp}`.| |`{$LOW_SPACE_LIMIT:regex:"^/var/log/.*$"}`|User macro with context (regular expression). Matches all strings prefixed with /var/log/.| #### 概要 [ユーザー マクロ](/manual/config/macros/user_macros) でオプションのコンテキストを使用して、デフォルト値をコンテキスト固有の値で上書きすることができます。 マクロ名にコンテキストが追加されます。 構文は、コンテキストが静的テキスト値であるかどうかによって異なります。 {$MACRO:"static text"} または正規表現: {$MACRO:regex:"regular expression"} 正規表現コンテキストを持つマクロは、ユーザー マクロ構成でのみ定義できることに注意してください。 `regex:` プレフィックスがトリガー式のようにユーザー マクロ コンテキストとして他の場所で使用されている場合、静的コンテキストとして扱われます。 コンテキストの引用はオプションです ([重要な注意事項](#important_notes) も参照してください) マクロ コンテキストの例: |例|説明| |-------|-----------| |`{$LOW_SPACE_LIMIT}`|コンテキストのないユーザー マクロ| |`{$LOW_SPACE_LIMIT:/tmp}`|コンテキストを持つユーザー マクロ (静的文字列)| |`{$LOW_SPACE_LIMIT:regex:"^/tmp$"}`|コンテキストを持つユーザー マクロ (正規表現)。 `{$LOW_SPACE_LIMIT:/tmp}` と同じ。| |`{$LOW_SPACE_LIMIT:regex:"^/var/log/.*$"}`|コンテキストを持つユーザー マクロ (正規表現)。 /var/log/ で始まるすべての文字列に一致。| #### Overview As an alternative to setting up manually or reusing an existing server for Zabbix, users may [download](http://www.zabbix.com/download_appliance) a Zabbix appliance or a Zabbix appliance installation CD image. Zabbix appliance and installation CD versions are based on AlmaLinux 8 (x86\_64). Zabbix appliance installation CD can be used for instant deployment of Zabbix server (MySQL). ::: noteimportant You can use this Appliance to evaluate Zabbix. The Appliance is not intended for serious production use. ::: #### 概要 手動でセットアップしたり、Zabbixの既存のサーバーを再利用したりする代わりに、ユーザーはZabbixアプライアンスまたはZabbixアプライアンスのインストールCDイメージを[ダウンロード](http://www.zabbix.com/download_appliance)できます。 ZabbixアプライアンスとインストールCDのバージョンはAlmaLinux 8 (x86\_64)が基となっています。 ZabbixアプライアンスのインストールCDは、Zabbixサーバー(MySQL)の即時展開に使用できます。 ::: noteimportant このアプライアンスを使用してZabbixを評価できます。 アプライアンスは、本番環境での使用を目的としたものではありません。 ::: #### Overview Assuming that we have configured some items and triggers and now are getting some events happening as a result of triggers changing state, it is time to consider some actions. To begin with, we would not want to stare at the triggers or events list all the time. It would be much better to receive notification if something significant (such as a problem) has happened. Also, when problems occur, we would like to see that all the people concerned are informed. That is why sending notifications is one of the primary actions offered by Zabbix. Who and when should be notified upon a certain event can be defined. To be able to send and receive notifications from Zabbix you have to: - [define some media](/manual/config/notifications/media) - [configure an action](/manual/config/notifications/action) that sends a message to one of the defined media Actions consist of *conditions* and *operations*. Basically, when conditions are met, operations are carried out. The two principal operations are sending a message (notification) and executing a remote command. For discovery and autoregistration created events, some additional operations are available. Those include adding or removing a host, linking a template etc. #### 概要 いくつかのアイテムとトリガーを構成し、トリガーの状態変更の結果としていくつかのイベントが発生していると仮定して、いくつかのアクションを検討します。 そもそも、トリガーやイベントのリストを常に眺めたくはありません。 何か重大な、障害などが発生した場合に通知を受け取る方がはるかに良いでしょう。 また、障害が発生した場合には、関係者全員に周知したいと考えております。 そのため、通知の送信はZabbixが提供する主要なアクションの1つです。 特定のイベントが発生したときに、誰に、いつ、通知するかを定義できます。 Zabbixから通知を送受信できるようにするには、次のことを行う必要があります。 - [メディアの定義](/manual/config/notifications/media) - 定義されたメディアにメッセージを送信する[アクションの設定](/manual/config/notifications/action) アクションは*条件*と*操作*で構成されます。 基本的に条件が満たされた場合に操作が実行されます。 2つの主要な操作は、メッセージ の送信(通知)とリモートコマンドの実行です。 ディスカバリおよび自動登録によって作成されたイベントについては、いくつかの追加操作を使用できます。 追加操作はホストの追加または削除、テンプレートのリンクなどです。 #### Overview A template is a set of entities that can be conveniently applied to multiple hosts. The entities may be: - items - triggers - graphs - dashboards - low-level discovery rules - web scenarios As many hosts in real life are identical or fairly similar so it naturally follows that the set of entities (items, triggers, graphs,...) you have created for one host, may be useful for many. Of course, you could copy them to each new host, but that would be a lot of manual work. Instead, with templates you can copy them to one template and then apply the template to as many hosts as needed. When a template is linked to a host, all entities (items, triggers, graphs,...) of the template are added to the host. Templates are assigned to each individual host directly (and not to a host group). Templates are often used to group entities for particular services or applications (like Apache, MySQL, PostgreSQL, Postfix...) and then applied to hosts running those services. Another benefit of using templates is when something has to be changed for all the hosts. Changing something on the template level once will propagate the change to all the linked hosts. Thus, the use of templates is an excellent way of reducing one's workload and streamlining the Zabbix configuration. Proceed to [creating and configuring a template](/manual/config/templates/template). #### 概要 テンプレートは、複数のホストに簡単に適用できるエンティティのセットです。 エンティティは次の通りです。 - アイテム - トリガー - グラフ - ダッシュボード - ローレベルディスカバリルール - ウェブシナリオ 現実のホストの多くは同一またはかなり類似しているため、1つのホストに対して作成した一連のエンティティ (アイテム、トリガー、グラフなど) が多くのホストにとって役立つ可能性があることは当然のことです。 もちろん、新しいホストごとにエンティティをコピーすることもできますが、それでは手作業が多くなります。 代わりにテンプレートを使用すると、それらエンティティを1つのテンプレートにコピーし、そのテンプレートを必要なだけのホストに適用できます。 テンプレートがホストにリンクされると、テンプレートのすべてのエンティティ (アイテム、トリガー、グラフなど) がホストに追加されます。 テンプレートは、ホストグループではなく個々のホストに直接割り当てられます。 テンプレートは、特定のサービスやアプリケーション (Apache、MySQL、PostgreSQL、Postfixなど) のエンティティをグループ化するためによく使用され、それらのサービスを実行するホストに適用されます。 テンプレートを使用するもう1つの利点は、すべてのホストに対して何かを変更する必要がある場合です。 テンプレートレベルで何かを変更すると、その変更はリンクされているすべてのホストに反映されます。 したがってテンプレートの使用は、作業負荷を軽減し、Zabbix設定を合理化する優れた方法です。 [テンプレートの作成と設定](/manual/config/templates/template)へ進んでください。 #### Overview A vertical menu in a sidebar provides access to various Zabbix frontend sections. The menu is dark blue in the default theme. {width="600"} #### 概要 サイドバーのメニューから、さまざまなZabbixフロントエンドセクションにアクセスできます。 デフォルトのテーマでは、メニューは紺色です。 {width="600"} #### Overview By default, Zabbix provides a number of predefined themes. You may follow the step-by-step procedure provided here in order to create your own. Feel free to share the result of your work with Zabbix community if you created something nice. #### 概要 デフォルトでZabbixはいくつか事前定義されたテーマを提供します。独自のテーマを作成するには、ここに記載されている手順に従ってください。何かいいものを作成した場合は、作業の結果をZabbixコミュニティと自由に共有してください。 ##### Overview by item type In this screen it is easy to locate if the problem is related to one or several item types. {width="600"} Each line contains an item type. Each column shows the number of waiting items - waiting for 5-10 seconds/10-30 seconds/30-60 seconds/1-5 minutes/5-10 minutes or over 10 minutes respectively. ##### キュー概要 この画面では、問題が1つまたは複数のアイテムタイプに関連しているかどうかを簡単に特定できます。 {width="600"} 各行にはアイテムタイプが含まれています。各列には、待機中のアイテムの数が表示されます。待機中は、それぞれ5〜10秒/10〜30秒/30〜60秒/1〜5分/5〜10分または10分以上です。 ##### Overview by proxy In this screen it is easy to locate if the problem is related to one of the proxies or the server. {width="600"} Each line contains a proxy, with the server last in the list. Each column shows the number of waiting items - waiting for 5-10 seconds/10-30 seconds/30-60 seconds/1-5 minutes/5-10 minutes or over 10 minutes respectively. ##### プロキシごとのキュー概要 この画面では、問題がプロキシの1つに関連しているか、サーバーに関連しているかを簡単に特定できます。 {width="600"} 各行にはプロキシが含まれ、サーバーはリストの最後にあります。各列には、待機中のアイテムの数が表示されます。待機中は、それぞれ5〜10秒/10〜30秒/30〜60秒/1〜5分/5〜10分または10分以上です。 #### Overview Change of trigger status is the most frequent and most important source of events. Each time the trigger changes its state, an event is generated. The event contains details of the trigger state's change - when it happened and what the new state is. Two types of events are created by triggers - Problem and OK. #### 概要 トリガーステータスの変化は、最も頻繁かつ重要なイベントの発生源です。 トリガーステータスが変化するたびに、イベントが生成されます。 イベントには、トリガーステータスの変化の詳細 (いつ発生したか、新しいステータスは何か) が含まれます。 トリガーによって、障害と正常の2種類のイベントが作成されます。 #### Overview Checking for a new item value in Zabbix is a cyclic process that is based on configured update intervals. While for many items the update intervals are quite short, there are others (including low-level discovery rules) for which the update intervals are quite long, so in real-life situations there may be a need to check for a new value quicker - to pick up changes in discoverable resources, for example. To accommodate such a necessity, it is possible to reschedule a passive check and retrieve a new value immediately. This functionality is supported for **passive** checks only. The following item types are supported: - Zabbix agent (passive) - SNMPv1/v2/v3 agent - IPMI agent - Simple check - Zabbix internal - External check - Database monitor - JMX agent - SSH agent - Telnet - Calculated - HTTP agent - Script ::: noteimportant The check must be present in the configuration cache in order to get executed; for more information see [CacheUpdateFrequency](/manual/appendix/config/zabbix_server). Before executing the check, the configuration cache is **not** updated, thus very recent changes to item/discovery rule configuration will not be picked up. Therefore, it is also not possible to check for a new value for an item/rule that is being created or has been created just now; use the *Test* option while configuring an item for that. ::: ### 概要 Zabbixでは、アイテムに設定された監視間隔で周期的に新しい監視データを取得します。多くのアイテムでは監視間隔が短いですが、(LLDルールを含む)監視間隔が長いアイテムもあり、実際の状況では、検出可能なリソースの変更を素早く検出するために、新しい監視データをより速く収集する必要がある場合があります。このような状況に対応するために、パッシブ監視を再スケジュールして新しい監視データをすぐに取得することが可能です。 この機能は、**パッシブ**監視のみサポートされています。以下のアイテムのタイプがサポートされています。 - Zabbixエージェント(パッシブ) - SNMPv1/v2/v3エージェント - IPMIチェック - シンプルチェック - 内部チェック - 外部チェック - ODBC監視 - JMX監視 - SSHチェック - Telnetチェック - 計算アイテム - HTTPエージェント - スクリプト ::: noteimportant 監視を実行するには、設定キャッシュ内に監視設定が存在している必要があります。詳細については[CacheUpdateFrequency](/manual/appendix/config/zabbix_server)を参照してください。監視を実行する前に設定キャッシュは更新されません。そのため、アイテム/LLDルールの最新の設定変更は反映されません。したがって、作成中または作成されたばかりのアイテム/LLDルールの設定で新しい監視データを取得することもできません。アイテム設定時に変更した設定で監視データを取得する場合は*テスト*を使用してください。 ::: #### Overview Configuring a map in Zabbix requires that you first create a map by defining its general parameters and then you start filling the actual map with elements and their links. You can populate the map with elements that are a host, a host group, a trigger, an image, or another map. Icons are used to represent map elements. You can define the information that will be displayed with the icons and set that recent problems are displayed in a special way. You can link the icons and define information to be displayed on the links. You can add custom URLs to be accessible by clicking on the icons. Thus you may link a host icon to host properties or a map icon to another map. Maps are managed in *Monitoring* → *[Maps](/manual/web_interface/frontend_sections/monitoring/maps)*, where they can be configured, managed and viewed. In the monitoring view, you can click on the icons and take advantage of the links to some scripts and URLs. Network maps are based on vector graphics (SVG) since Zabbix 3.4. #### 概要 Zabbix でマップを設定するには、まず一般的なパラメータを定義してマップを作成し、その後、実際のマップに要素と<br> そのリンクを設定する必要があります。 マップには、ホスト、ホストグループ、トリガー、画像、別のマップの要素を入れることができます。 アイコンは、マップの要素を表現するために使用されます。アイコンと一緒に表示される情報を定義し、最近の問題が<br> 特別な方法で表示されるように設定できます。アイコンをリンクさせ、リンクに表示される情報を定義することができます。 アイコンをクリックするとアクセスできるカスタムURLを追加することができます。したがって、ホストアイコンをホスト<br> プロパティに、マップアイコンを別のマップにリンクさせることができます。 マップは *Monitoring* →*[Maps](/manual/web_interface/frontend_sections/monitoring/maps)* で管理され、設定、管理、閲覧が可能です。<br>モニタリングビューでは、アイコンをクリックして、いくつかのスクリプトやURLへのリンクを利用することができます。 ネットワークマップは Zabbix3.4 からベクターグラフィック(SVG)をベースにしています。 #### Overview Configuring a template requires that you first create a template by defining its general parameters and then you add entities (items, triggers, graphs, etc.) to it. #### 概要 テンプレートを設定するには、最初に一般的なパラメーターを定義してテンプレートを作成し、次にエンティティ (アイテム、トリガー、グラフなど) をテンプレートに追加する必要があります。 #### Overview Custom graphs, as the name suggests, offer customization capabilities. While simple graphs are good for viewing data of a single item, they do not offer configuration capabilities. Thus, if you want to change graph style or the way lines are displayed or compare several items, for example, incoming and outgoing traffic in a single graph, you need a custom graph. Custom graphs are configured manually. They can be created for a host or several hosts or for a single template. #### 概要 カスタムグラフは、その名の通り、カスタマイズ機能を提供するものです。 単純なグラフは、1つの項目のデータを見るには適していますが、設定機能はありません。 そのため、グラフのスタイルや線の表示方法を変更したり、複数の項目、例えばトラフィックの入出力を1つのグラフで<br> 比較したい場合は、カスタムグラフが必要になります。 カスタムグラフは、手動で設定します。 カスタムグラフは、1つのホスト、複数のホスト、または1つのテンプレートに対して作成することができます。 #### Overview Debug mode may be used to diagnose performance problems with frontend pages. #### 概要 デバッグモードは、フロントエンドページの問題を診断するために使用できます。 #### Overview Depending on user role permissions, the *User settings* section may contain the following pages: - *User profile* - for customizing certain Zabbix frontend features; - *API tokens* - for managing API tokens assigned to the current user. The list of available pages appears upon pressing on the  user icon near the bottom of the Zabbix menu (not available for a guest user). It is also possible to switch between pages by using a title dropdown in the top left corner. | | | |---|---| |{width="300"}|{width="300"}| |Third-level menu.|Title dropdown.| #### 概要 ユーザーロールの権限によっては*ユーザー設定*セクションに次のページが含まれる場合があります。 - *ユーザープロファイル* - 特定のZabbixフロントエンド機能をカスタマイズ - *API トークン* - 現在のユーザーに割り当てられたAPIトークンを管理 利用可能なページのリストは、Zabbixメニューの下部にあるユーザーアイコンを押すと表示されます。（ゲストユーザーは利用できません） 左上隅のタイトルドロップダウンを使用してページを切り替えることもできます。 | | | |---|---| |{width="300"}|{width="300"}| |第3レベルメニュー|タイトルのドロップダウン| #### Overview Each pre-shared key (PSK) in Zabbix actually is a pair of: - non-secret PSK identity string, - secret PSK string value. PSK identity string is a non-empty UTF-8 string. For example, "PSK ID 001 Zabbix agentd". It is a unique name by which this specific PSK is referred to by Zabbix components. Do not put sensitive information in PSK identity string - it is transmitted over the network unencrypted. PSK value is a hard to guess string of hexadecimal digits, for example, "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9". #### 概要 Zabbix の各事前共有キー (PSK) は、次のペアです。 - 非秘匿 PSK ID 文字列、 - 秘匿 PSK 文字列値。 PSK ID 文字列は、空ではないUTF-8の文字列です。 たとえば"PSK ID 001 Zabbix agentd"などです。この特定の PSK が Zabbix コンポーネントによって参照される一意の名前です。暗号化されずにネットワーク経由で送信されますので、機密情報を PSK ID 文字列に含めないでください。 PSK 文字列値は推測しにくい 16 進数の文字列です。たとえば、"e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9"などです。 #### Overview Event correlation allows to correlate problem events to their resolution in a manner that is very precise and flexible. Event correlation can be defined: - [on trigger level](/manual/config/event_correlation/trigger) - one trigger may be used to relate separate problems to their solution - [globally](/manual/config/event_correlation/global) - problems can be correlated to their solution from a different trigger/polling method using global correlation rules #### 概要 イベント相関により、非常に正確かつ柔軟な方法で、障害のイベントをその解決策に関連付けることができます。 イベントの相関関係は次のように定義できます。 - [トリガーレベルl](/manual/config/event_correlation/trigger) - 1つのトリガーを使用して、個別の障害をその解決策に関連付けることができます - [グローバル](/manual/config/event_correlation/global) - グローバル相関ルールを使用して、別のトリガー/ポーリングメソッドから障害をその解決策に関連付けることができます #### Overview For an easy access to Zabbix from anywhere and from any platform, the web-based interface is provided. ::: noteclassic If using more than one frontend instance make sure that the locales and libraries (LDAP, SAML etc.) are installed and configured identically for all frontends. ::: #### 概要 どこからでも、どのプラットフォームからでもZabbixに簡単にアクセスできるように、Webベースのインターフェースが提供されています。 ::: noteclassic 複数のフロントエンドインスタンスを使用する場合は、言語や地域の設定とライブラリ (LDAP、SAMLなど)がすべてのフロントエンドにインストールされ、同じように構成されていることを確認してください。 ::: #### Overview Foreach functions are used in [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate) to return one aggregate value for each item that is selected by the used **item filter**. An array of values is returned. For example, the *avg_foreach* function will return an array of values, where each value is the *average* history value of the selected item, during the time interval that is specified. The [item filter](#item-filter-syntax) is part of the syntax used by foreach functions. The use of wildcards is supported in the item filter, thus the required items can be selected quite flexibly. #### 概要 foreach関数は、[集計計算](/manual/config/items/itemtypes/calculated/aggregate) で使用され、使用されている **アイテム フィルター** によって選択された各アイテムに対して 1 つの集計値を返します。値の配列が返されます。 たとえば、*avg_foreach* 関数は値の配列を返します。各値は、指定された時間間隔における、選択された項目の *平均* 履歴値です。 [アイテム フィルター構文](#アイテムフィルター構文)は、foreach 関数で使用される構文の一部です。アイテム フィルターではワイルドカードの使用がサポートされているため、必要なアイテムを非常に柔軟に選択できます。 #### Overview Geomap widget displays hosts as markers on a geographical map using open-source JavaScript interactive maps library Leaflet. ::: noteclassic Zabbix offers multiple predefined map tile service providers and an option to add a custom tile service provider or even host tiles themselves (configurable in the *Administration → General → Geographical maps* [menu section](/manual/web_interface/frontend_sections/administration/general#geographical_maps)). ::: #### 概要 地理マップウィジェットは、オープンソースのJavaScriptインタラクティブマップライブラリLeafletを使用して、ホストを地理マップ上のマーカーとして表示します。 ::: noteclassic Zabbixは複数の事前定義されたマップタイルサービスプロバイダーとカスタムタイルサービスプロバイダーまたはホストタイル自体を追加するオプションを提供します（*管理 → 一般設定 → 地理マップ* [メニューセクション](/manual/web_interface/frontend_sections/administration/general#geographical_maps)で設定可能） ::: #### Overview Geomap widget displays hosts as markers on a geographical map using open-source JavaScript interactive maps library Leaflet. ::: noteclassic Zabbix offers multiple predefined map tile service providers and an option to add a custom tile service provider or even host tiles themselves (configurable in the *Administration → General → Geographical maps* [menu section](/manual/web_interface/frontend_sections/administration/general#geographical_maps)). ::: By default, the widget displays all enabled hosts that have Latitude and Longitude Inventory fields filled in the host configuration. It is possible to configure host filtering in the widget parameters. #### Overview Geomap widget displays hosts as markers on a geographical map using open-source JavaScript interactive maps library Leaflet. ::: noteclassic Zabbix offers multiple predefined map tile service providers and an option to add a custom tile service provider or even host tiles themselves (configurable in the *Administration → General → Geographical maps* [menu section](/manual/web_interface/frontend_sections/administration/general#geographical_maps)). ::: By default, the widget displays all enabled hosts that have Latitude and Longitude Inventory fields filled in the host configuration. It is possible to configure host filtering in the widget parameters. #### Overview Global event correlation allows to reach out over all metrics monitored by Zabbix and create correlations. It is possible to correlate events created by completely different triggers and apply the same operations to them all. By creating intelligent correlation rules it is actually possible to save yourself from thousands of repetitive notifications and focus on root causes of a problem! Global event correlation is a powerful mechanism, which allows you to untie yourself from one-trigger based problem and resolution logic. So far, a single problem event was created by one trigger and we were dependent on that same trigger for the problem resolution. We could not resolve a problem created by one trigger with another trigger. But with event correlation based on event tagging, we can. For example, a log trigger may report application problems, while a polling trigger may report the application to be up and running. Taking advantage of event tags you can tag the log trigger as *Status: Down* while tag the polling trigger as *Status: Up*. Then, in a global correlation rule you can relate these triggers and assign an appropriate operation to this correlation such as closing the old events. In another use, global correlation can identify similar triggers and apply the same operation to them. What if we could get only one problem report per network port problem? No need to report them all. That is also possible with global event correlation. Global event correlation is configured in **correlation rules**. A correlation rule defines how the new problem events are paired with existing problem events and what to do in case of a match (close the new event, close matched old events by generating corresponding OK events). If a problem is closed by global correlation, it is reported in the *Info* column of *Monitoring* → *Problems*. Configuring global correlation rules is available to Super Admin level users only. ::: noteimportant Event correlation must be configured very carefully, as it can negatively affect event processing performance or, if misconfigured, close more events than was intended (in the worst case even all problem events could be closed). ::: To configure global correlation **safely**, observe the following important tips: - Reduce the correlation scope. Always set a unique tag for the new event that is paired with old events and use the *New event tag* correlation condition; - Add a condition based on the old event when using the *Close old event* operation (or else all existing problems could be closed); - Avoid using common tag names that may end up being used by different correlation configurations; - Keep the number of correlation rules limited to the ones you really need. See also: [known issues](/manual/installation/known_issues#global_event_correlation). #### 概要 グローバルイベント相関は、Zabbixが監視するすべてのメトリクスにアクセスし、相関を作成することができます。 全く異なるトリガーで作成されたイベントを相関させ、それら全てに同じ操作を適用することが可能です。<br> インテリジェントな相関ルールを作成することで、何度も繰り返される通知から解放され、問題の根本的な原因に焦点を<br> 当てることができます。何千もの繰り返しの通知から解放され、問題の根本的な原因に集中することができます。<br> グローバルイベント相関は、1つのトリガーに基づく問題解決ロジックから自分を解き放つことができる、強力なメカニズムです。<br> これまでは、1つの問題事象が1つのトリガーで作成され、問題解決のためにその同じトリガーに依存していました。<br> あるトリガーで発生した問題を、別のトリガーで解決することはできませんでした。しかし、イベント・タグ付けに基づく<br> イベント相関を利用すれば、それが可能になります。<br> 例えば、ログトリガーはアプリケーションの問題を報告し、ポーリングトリガーはアプリケーションが稼働していることを<br> 報告するかもしれません。イベントタグを利用して、ログトリガーを *Status: Down* とタグ付けすることができます。<br> その間、ポーリングトリガーを*Status: Up* とタグ付けすることができます。次に、グローバル相関ルールで、これらのトリガーを<br> 関連付け、古いイベントを閉じるなど、この相関に適切な操作を割り当てることができます。<br> 別の使い方として、グローバル相関は類似のトリガーを識別し、同じ操作を適用することができます。<br> ネットワーク・ポートの問題ごとに1つの問題レポートしか得られないとしたらどうでしょう。全部を報告する必要はありません。<br> グローバルなイベント相関を使えば、それも可能です。<br> グローバルイベントの相関は、**correlation rules**で設定されます。correlation rules では、新しい問題イベントを既存の<br> 問題イベントとどのように組み合わせ、一致した場合にどうするかを定義します（新しいイベントを閉じ、対応するOKイベントを<br>生成して一致した古いイベントを閉じます）。 グローバル相関によって問題がクローズされると、*Monitoring* → *Problems* の *Info* カラムに報告されます。<br> グローバル相関ルールの設定は、Super Admin レベルのユーザーのみ可能です。 ::: noteimportant イベント相関は非常に慎重に設定する必要があります。イベント処理のパフォーマンスに悪影響を及ぼしたり、設定を誤ると<br> 意図した以上のイベントがクローズされる可能性があるからです。（最悪の場合、すべての問題イベントがクローズされる<br> 可能性もあります）<br> ::: グローバル相関を **安全に** 設定するために、次の重要なヒントを守ってください: - 相関範囲を小さくする。古いイベントと対になる新しいイベントには常に一意のタグを設定し、*New event tag* の 相関条件を使用します。 - 古いイベントを閉じる*操作を使用する場合は、古いイベントに基づく条件を追加します（さもなければ、既存のすべての問題が 閉じられる可能性があります）。 - 異なる相関設定によって使用される可能性のある共通のタグ名を使用しないようにします。 - 相関ルールの数は、本当に必要なものに限定してください。 参照: [known issues](/manual/installation/known_issues#global_event_correlation). #### Overview Global notifications are a way of displaying issues that are currently happening right on the screen you're at in Zabbix frontend. Without global notifications, working in some other location than *Problems* or the *Dashboard* would not show any information regarding issues that are currently happening. Global notifications will display this information regardless of where you are. Global notifications involve both showing a message and [playing a sound](sound). ::: noteimportant The auto play of sounds may be disabled in recent browser versions by default. In this case, you need to change this setting manually. ::: #### 概要 グローバル通知は、Zabbixフロントエンドで現在発生している問題を画面に通知する方法です。 グローバル通知がない場合、*問題*または*ダッシュボード*以外の場所で作業しても、現在発生している問題に関する情報は表示されません。グローバル通知は、あなたがどこにいるかに関係なく、この情報を表示します。 グローバル通知には、メッセージの表示と[サウンドの再生](sound)の両方が含まれます。 ::: noteimportant 最近のブラウザバージョンでは、サウンドの自動再生がデフォルトで無効になっている場合があります。この場合、この設定を手動で変更する必要があります。 ::: #### Overview Having to use some large numbers, for example '86400' to represent the number of seconds in one day, is both difficult and error-prone. This is why you can use some appropriate unit symbols (or suffixes) to simplify Zabbix trigger expressions and item keys. Instead of '86400' for the number of seconds you can simply enter '1d'. Suffixes function as multipliers. #### 概要 1日の秒数を表すために「86400」などの大きな数値を使用するのは、手間かつエラーが発生しやすくなります。これがZabbixトリガー式とアイテムキーを単純化するためにいくつかの適切な単位記号（または接尾辞）を使用できる理由です。 例えば秒数の「86400」の代わりに「1d」とできます。接尾辞は乗数として機能します。 ### Overview High availability (HA) is typically required in critical infrastructures that can afford virtually no downtime. So for any service that may fail there must be a failover option in place to take over should the current service fail. Zabbix offers a **native** high-availability solution that is easy to set up and does not require any previous HA expertise. Native Zabbix HA may be useful for an extra layer of protection against software/hardware failures of Zabbix server or to have less downtime due to maintenance. In the Zabbix high availability mode multiple Zabbix servers are run as nodes in a cluster. While one Zabbix server in the cluster is active, others are on standby, ready to take over if necessary.  Switching to Zabbix HA is non-committal. You may switch back to standalone operation at any point. See also: [Implementation details](#implementation-details) ### 概要 実質的にダウンタイムを発生させられない重要なインフラストラクチャーでは、高可用性(HA)が求められます。したがって、停止してしまう可能性があるサービスについては、現在のサービスが停止してしまったときに処理を引き継げるようにするためのフェイルオーバーオプションが必要です。 Zabbixは、セットアップが簡単で、以前のHAの専門知識を必要としない**組み込まれた**高可用性のソリューションを提供します。組み込まれたZabbixのHAは、Zabbixサーバーのソフトウェア/ハードウェアの障害に対する保護やメンテナンスに伴うダウンタイムを削減するのに役に立つでしょう。 Zabbixの高可用性モードでは、複数のZabbixサーバーがクラスター内のノードとして実行されます。クラスター内の1台のZabbixサーバーがアクティブである間、他のサーバーはスタンバイ状態となり、必要に応じて引き継ぐことができるよう準備されます。  ZabbixのHAへの切り替えは戻すことが可能で、いつでもスタンドアロン環境に戻すことができます。 参照: [実装の詳細](#実装の詳細) #### Overview History and trends are the two ways of storing collected data in Zabbix. Whereas history keeps each collected value, trends keep averaged information on hourly basis and therefore are less resource-hungry. #### 概要 Zabbixでは、収集したデータを保存する方法として、ヒストリとトレンドの2つがあります。 ヒストリは収集した各値を保持するのに対し、トレンドは1時間単位で平均化された情報を保持するため、リソースをあまり消費しません。 #### Overview Host dashboards look similar to [global dashboards](/manual/web_interface/frontend_sections/monitoring/dashboard), however, host dashboards display data about the host only. Host dashboards have no owner. Host dashboards are configured on the [template](/manual/config/templates/template#adding_dashboards) level and then are generated for a host, once the template is linked to the host. Widgets of host dashboards can only be copied to host dashboards of the same template. Widgets from global dashboards cannot be copied onto host dashboards. Host dashboards *cannot* be configured or directly accessed in the *Monitoring* → *[Dashboard](/manual/web_interface/frontend_sections/monitoring/dashboard)* section, which is reserved for global dashboards. The ways to access host dashboards are listed below in this section. {width="600"} When viewing host dashboards you may switch between the configured dashboards using the dropdown in the upper right corner. To switch to *Monitoring→Hosts* section, click *All hosts* navigation link below the dashboard name in the upper left corner. Widgets of the host dashboards cannot be edited. Note that host dashboards used to be host screens before Zabbix 5.2. When importing an older template containing screens, the screen import will be ignored. #### 概要 ホストダッシュボードは、[global dashboards] (/manual/web_interface/frontend_sections/monitoring/dashboard) に似ていますが、ホストダッシュボードは<br> ホストに関するデータのみを表示します。ホスト・ダッシュボードにはオーナーがいません。 ホスト・ダッシュボードは [template](/manual/config/templates/template#adding_dashboards) レベルで設定され、<br> テンプレートがホストにリンクされると、そのホスト用に生成されます。ホスト・ダッシュボードのウィジェットは、<br> 同じテンプレートのホスト・ダッシュボードにのみコピーすることができます。<br> グローバル・ダッシュボードのウィジェットは、ホスト・ダッシュボードにコピーできません。<br> ホストダッシュボードは、グローバルダッシュボード用に予約されている *Monitoring* → *[Dashboard](/manual/web_interface/frontend_sections/monitoring/dashboard)* セクションで構成することも<br> 直接アクセスすることも*できません*。ホスト・ダッシュボードにアクセスする方法は、このセクションの下に記載されています。 {width="600"} ホストダッシュボードを表示する際、右上のドロップダウンを使用して、設定されたダッシュボードを切り替えることが<br> できます。*Monitoring→Hosts* セクションに切り替えるには、左上隅のダッシュボード名の下にある<br> *All hosts* ナビゲーションリンクをクリックします。 ホストダッシュボードのウィジェットを編集することはできません。 Zabbix 5.2以前では、ホストダッシュボードはホスト画面であったことに注意してください。スクリーンを含む<br> 古いテンプレートをインポートする場合、スクリーンのインポートは無視されます。 #### Overview Host groups are used for the logical grouping of hosts and assigning user permissions to them. Each host must have at least one host group assigned. A host may belong to multiple host groups, and each host group may contain multiple hosts. Note that in Zabbix, all permissions are based on [user groups](/manual/config/users_and_usergroups) and host/[template](/manual/config/templates/template) groups. So, even if a single user needs access to a single host, it is granted by adding the user to a user group that has permission to access the host group containing that host. #### 概要 ホストグループは、ホストを論理的にグループ化し、それらにユーザー権限を割り当てるために使用されます。 各ホストには、少なくとも1つのホストグループが割り当てられている必要があります。1つのホストは複数のホストグループに属することができ、各ホストグループには複数のホストを含めることができます。 Zabbixでは、すべての権限は[ユーザーグループ](/manual/config/users_and_usergroups)およびホスト/[テンプレート](/manual/config/templates/template)グループに基づいていることに注意してください。そのため、あるユーザーがあるホストにアクセスする権限が必要な場合、そのホストを含むホストグループにアクセスする権限を持つユーザーグループにユーザーを追加します。 #### Overview Hosts are [exported](/manual/xml_export_import) with many related objects and object relations. Host export contains: - linked host groups - host data - template linkage - host group linkage - host interfaces - directly linked items - directly linked triggers - directly linked graphs - directly linked discovery rules with all prototypes - directly linked web scenarios - host macros - host inventory data - value maps #### 概要 ホストは、多くの関連するオブジェクトと[export](/manual/xml_export_import)されます。 <br> オブジェクトとオブジェクトの関係が含まれます。 <br> ホストのエクスポートには以下の内容が含まれます。 <br> - リンクされたホストグループ - ホストデータ - テンプレート・リンケージ - ホストグループリンケージ - ホストインターフェース - 直接リンクされた項目 - 直接リンクされたトリガー - 直接リンクされたグラフ - すべてのプロトタイプに直接リンクされたディスカバリールール - 直接リンクされたWebシナリオ - ホストマクロ - ホストインベントリデータ - バリューマップ #### Overview Host [web scenario](/manual/web_monitoring) information can be accessed from *Monitoring → Hosts* by clicking on Web for the respective host. {width="600"} Data of disabled hosts is also accessible. The name of a disabled host is listed in red. The maximum number of scenarios displayed per page depends on the *Rows per page* user profile [setting](/manual/web_interface/user_profile#user-profile). By default, only values that fall within the last 24 hours are displayed. This limit has been introduced with the aim of improving initial loading times for large pages of latest data. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration→General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section. The scenario name is link to more detailed statistics about it: {width="600"} #### 概要 ホストの[Webシナリオ](/manual/web_monitoring)情報には、*監視データ → ホスト*でそれぞれのホストのWebをクリックしてアクセスできます。 {width="600"} 無効になっているホストのデータにもアクセスできます。無効になっているホストの名前は赤で表示されます。 ページごとに表示されるシナリオの最大数は、ユーザープロファイル[設定](/manual/web_interface/user_profile#user-profile)の*ページあたりの表示行数*によって異なります。 デフォルトでは、過去24時間以内の値のみが表示されます。この制限は、最新データの大きなページの初期読み込み時間を改善することを目的として導入されました。 この期間は、*[管理 → 一般設定](/manual/web_interface/frontend_sections/administration/general#gui)*の*ヒストリの最大表示期間*パラメーターの値を変更することで延長できます。 シナリオ名は、それに関するより詳細な統計へのリンクです。 {width="600"} #### Overview If [installed](/manual/installation/install_from_packages/debian_ubuntu#java_gateway_installation) from Debian/Ubuntu packages, the following information will help you in setting up Zabbix [Java gateway](/manual/concepts/java). #### 概要 次の情報はDebian/Ubuntuパッケージで[インストール](/manual/installation/install_from_packages/debian_ubuntu#java_gateway_installation)する場合のZabbix [Javaゲートウェイ](/manual/concepts/java)セットアップに役立ちます。 #### Overview If [installed](/manual/installation/install_from_packages/rhel#java_gateway_installation) from RHEL packages, the following information will help you in setting up Zabbix [Java gateway](/manual/concepts/java). #### 概要 次の情報は、RHELパッケージで[インストール](/manual/installation/install_from_packages/rhel#java_gateway_installation)した場合のZabbix [Javaゲートウェイ](/manual/concepts/java)セットアップに役立ちます。 #### Overview If [installed](/manual/installation/install_from_packages/rhel#java_gateway_installation) from RHEL packages, the following information will help you in setting up Zabbix [Java gateway](/manual/concepts/java). #### 概要 次の情報は、RHELパッケージで[インストール](/manual/installation/install_from_packages/rhel#java_gateway_installation)した場合のZabbix [Java ゲートウェイ](/manual/concepts/java)セットアップに役立ちます。 #### Overview If [installed](/manual/installation/install#installing_java_gateway) from sources, the following information will help you in setting up Zabbix [Java gateway](/manual/concepts/java). #### 概要 ソースから[インストール](/manual/installation/install#installing_java_gateway)した場合、次の情報はZabbix [Javaゲートウェイ](/manual/concepts/java)のセットアップに役立ちます。 #### Overview If you are not satisfied with existing media types for sending alerts there is an alternative way to do that. You can create a script that will handle the notification your way. Alert scripts are executed on Zabbix server. These scripts are located in the directory defined in the server [configuration file](/manual/appendix/config/zabbix_server) **AlertScriptsPath** variable. Here is an example alert script: ``` {.bash} #!/bin/bash to=$1 subject=$2 body=$3 cat <<EOF | mail -s "$subject" "$to" $body EOF ``` ::: noteimportant Starting from version 3.4 Zabbix checks for the exit code of the executed commands and scripts. Any exit code which is different from **0** is considered as a [command execution](/manual/appendix/command_execution) error. In such case Zabbix will try to repeat failed execution. ::: Environment variables are not preserved or created for the script, so they should be handled explicitly. #### 概要 警告を送信するための既存のメディアタイプに満足できない場合、別の方法があります。独自の方法で通知を処理するスクリプトを<br> 作成することができます。 アラートスクリプトは Zabbix server 上で実行されます。これらのスクリプトはサーバの[configuration file](/manual/appendix/config/zabbix_server) の <br>**AlertScriptsPath** 変数で定義されたディレクトリに配置されています。 以下はアラートスクリプトの例です。: ``` {.bash} #!/bin/bash to=$1 subject=$2 body=$3 cat <<EOF | mail -s "$subject" "$to" $body EOF ``` ::: noteimportant バージョン3.4以降、Zabbix は実行されたコマンドとスクリプトの終了コードをチェックします。終了コードが ** 0 **以外の終了コードは、<br>[command execution](/manual/appendix/command_execution) エラーとみなされます。この場合、Zabbixは実行に失敗したコマンドを 再度実行しようとします。 ::: 環境変数はスクリプトのために保存も作成もされないので、明示的に処理する必要があります。 #### Overview If you have a network to look after, you may want to have an overview of your infrastructure somewhere. For that purpose, you can create maps in Zabbix - of networks and of anything you like. All users can create network maps. The maps can be public (available to all users) or private (available to selected users). Proceed to [configuring a network map](/manual/config/visualization/maps/map). #### 概要 ネットワークの管理をしている場合、インフラの概要をどこかで把握したいと思うかもしれません。<br> そのために、Zabbixではネットワークや好きなもののマップを作成することができます。<br> すべてのユーザがネットワークマップを作成することができます。<br> マップはパブリック(すべてのユーザが利用可能)またはプライベート(選択されたユーザが利用可能)にすることができます。<br> [configuring a network map](/manual/config/visualization/maps/map)に進みます。<br> #### Overview If you want some operations taking place as a result of events (for example, notifications sent), you need to configure actions. Actions can be defined in response to events of all supported types: - Trigger actions - for events when trigger status changes from *OK* to *PROBLEM* and back - Service actions - for events when service status changes from *OK* to *PROBLEM* and back - Discovery actions - for events when network discovery takes place - Autoregistration actions - for events when new active agents auto-register (or host metadata changes for registered ones) - Internal actions - for events when items become unsupported or triggers go into an unknown state #### 概要 イベント (通知の送信など) の結果として何らかの操作を実行する場合は、アクションを設定する必要があります。 アクションは、サポートされているすべてのタイプのイベントに応答して定義できます。 - トリガーアクション - トリガーのステータスが *OK* から *PROBLEM* に変化または戻ったとき - サービスアクション - サービス ステータスが *OK* から *PROBLEM* に変化または戻ったとき - ディスカバリアクション - ネットワークディスカバリが行われるとき - 自動登録アクション - 新しいアクティブなエージェントが自動登録されたとき (または登録済エージェントのホストメタデータが更新された) - 内部アクション - アイテムがサポートされなくなった、またはトリガーが不明な状態になったとき #### Overview In a similar way as [file systems](/manual/discovery/low_level_discovery#configuring_low-level_discovery) are discovered, it is possible to also discover Windows services. #### 概要 [ファイルシステム](/manual/discovery/low_level_discovery#configuring_low-level_discovery)が検出されるのと同様の方法で、Windowsサービスも検出できます。 #### Overview In message subjects and message text you can use macros for more efficient problem reporting. In addition to a number of built-in macros, [user macros](/manual/config/macros/user_macros) and [expression macros](/manual/config/macros/expression_macros) are also supported. A [full list of macros](/manual/appendix/macros/supported_by_location) supported by Zabbix is available. #### 概要 メッセージの件名とメッセージ テキストでは、マクロを使用して障害をより効率的に報告できます。 多くの組み込みマクロに加えて、[ユーザー マクロ](/manual/config/macros/user_macros) と [式マクロ](/manual/config/macros/expression_macros) もサポートされています。 Zabbix でサポートされている [マクロの完全なリスト](/manual/appendix/macros/supported_by_location) が利用可能です。 #### Overview In *Monitoring → Problems* you can see what problems you currently have. Problems are those triggers that are in the "Problem" state. {width="600"} |Column|Description| |--|-----------| |*Time*|Problem start time is displayed.| |*Severity*|Problem severity is displayed.<br>Problem severity is originally based on the severity of the underlying problem trigger, however, after the event has happened it can be updated using the *Update problem* [screen](/manual/acknowledges#updating_problems). Color of the problem severity is used as cell background during problem time.| |*Recovery time*|Problem resolution time is displayed.| |*Status*|Problem status is displayed:<br>**Problem** - unresolved problem<br>**Resolved** - recently resolved problem. You can hide recently resolved problems using the filter.<br>New and recently resolved problems blink for 2 minutes. Resolved problems are displayed for 5 minutes in total. Both of these values are configurable in *Administration* → *General* → *[Trigger displaying options](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)*.| |*Info*|A green information icon is displayed if a problem is closed by global correlation or manually when updating the problem. Rolling a mouse over the icon will display more details:<br><br>The following icon is displayed if a suppressed problem is being shown (see *Show suppressed problems* option in the filter). Rolling a mouse over the icon will display more details:<br>| |*Host*|Problem host is displayed.| |*Problem*|Problem name is displayed.<br>Problem name is based on the name of the underlying problem trigger.<br>Macros in the trigger name are resolved at the time of the problem happening and the resolved values do not update any more.<br>*Note* that it is possible to append the problem name with [operational data](#operational_data_of_problems) showing some latest item values.<br>Clicking on the problem name brings up the [event menu](#event_menu).<br>Hovering on the  icon after the problem name will bring up the trigger description (for those problems that have it).| |*Operational data*|[Operational data](#operational_data_of_problems) are displayed containing latest item values.<br>Operational data can be a combination of text and item value macros if configured on a trigger level. If no operational data is configured on a trigger level, the latest values of all items from the expression are displayed.<br>This column is only displayed if *Separately* is selected for *Show operational data* in the filter.| |*Duration*|Problem duration is displayed.<br>See also: [Negative problem duration](#negative_problem_duration)| |*Ack*|The acknowledgment status of the problem is displayed:<br>**Yes** - green text indicating that the problem is acknowledged. A problem is considered to be acknowledged if all events for it are acknowledged.<br>**No** - a red link indicating unacknowledged events.<br>If you click on the link you will be taken to the [problem update](/manual/acknowledges#updating_problems) screen where various actions can be taken on the problem, including commenting and acknowledging the problem.| |*Actions*|History of activities about the problem is displayed using symbolic icons:<br> - comments have been made. The number of comments is also displayed.<br> - problem severity has been increased (e.g. Information → Warning)<br> - problem severity has been decreased (e.g. Warning → Information)<br> - problem severity has been changed, but returned to the original level (e.g. Warning → Information → Warning)<br> - actions have been taken. The number of actions is also displayed.<br> - actions have been taken, at least one is in progress. The number of actions is also displayed.<br> - actions have been taken, at least one has failed. The number of actions is also displayed.<br>When rolling the mouse over the icons, popups with details about the activity are displayed. See [viewing details](#Viewing_details) to learn more about icons used in the popup for actions taken.| |*Tags*|[Tags](/manual/config/tagging) are displayed (if any).<br>In addition, tags from an external ticketing system may also be displayed (see the *Process tags* option when configuring [webhooks](/manual/config/notifications/media/webhook)).| #### 概要 *監視データ → 障害*で現在発生している障害を確認できます。 障害とはステータスが"障害"となったトリガーです。 {width="600"} |列|詳細| |------|-----------| |*時間*|障害の発生時刻が表示されます。| |*深刻度*|障害の深刻度が表示されます。<br>障害の深刻度は障害トリガーの深刻度に基づいていますが、イベントが発生した後、*障害の更新*[画面](/manual/acknowledges#updating_problems)を使用して更新できます。 障害の深刻度の色は障害時のセルの背景色として使用されます。| |*復旧時刻*|障害解決時間が表示されます。| |*ステータス*|障害のステータスが表示されます：<br>**障害** - 未解決の障害<br>**解決済み** - 最近解決された障害。 フィルタを使用して最近解決された障害を非表示にできます。<br>新しい障害と最近解決された障害は2分間点滅します。 解決した障害は合計5分間表示されます。 これらの表示は両方とも、*管理* → *一般設定*→*[イベントのステータス](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)で設定できます。| |*情報*|グローバル相関によって障害が解決された場合、または障害を更新するときに手動で解決された場合は、緑色の情報アイコンが表示されます。 アイコンの上にマウスを置くと詳細が表示されます：<br><br >抑制された障害が表示されている場合は、次のアイコンが表示されます（フィルターの*抑制された問題を表示*オプションを参照）。 アイコンの上にマウスを置くと詳細が表示されます：<br>| |*ホスト*|障害が発生したホストが表示されます。| |*障害*|障害名が表示されます。<br>障害名は障害トリガーの名前に基づいています。<br>トリガー名のマクロは、障害が発生したときに解決され、解決された値は更新されなくなります。<br > *注意*:障害名に[運用データ](#operational_data_of_problems)を追加して最新の項目値を表示することができます。<br>障害名をクリックすると[イベントメニュー](#event_menu)が表示されます。<br >障害名の後にあるアイコンにカーソルを合わせると、トリガーの説明が表示されます（障害がある場合） <br>（トリガーの説明の{ITEM.VALUE}および{ITEM.LASTVALUE}マクロの解決された値は20文字に切り捨てられることに注意してください。値全体を表示するには、回避策としてこれらのマクロで[マクロ関数]を使用します（例：`{{ITEM.VALUE}.regsub("(.*)", \1)}`, `{{ITEM.LASTVALUE}.regsub("(.*)", \1)}`））| |*運用データ*|[運用データ](#operational_data_of_problems)が表示され、最新のアイテム値が含まれます。<br>運用データは、トリガーレベルで構成されている場合、テキストマクロとアイテム値マクロの組み合わせにすることができます。 トリガーレベルで運用データが構成されていない場合は、式のすべての項目の最新値が表示されます。<br>この列は、フィルターの[運用データの表示]で*別々に*が選択されている場合にのみ表示されます。| |*継続期間*|障害の期間が表示されます。<br>関連項目：[障害の期間](#negative_problem_duration)| |*確認済み*|障害の確認ステータスが表示されます。<br>**はい** - 障害が確認されたことを示す緑色のテキスト。 障害のすべてのイベントが確認された場合、障害は確認されたと見なされます。<br>**いいえ** - 未確認のイベントを示す赤いリンク。<br>リンクをクリックすると障害へのコメントや確認など、問題に対してさまざまなアクションを実行できる[障害の更新](/manual/acknowledges#updating_problems)に移動します。| |*アクション*|障害に関するアクティビティの履歴は、記号アイコンを使用して表示されます：<br> - コメントが作成されました。コメントの数も表示されます。<br> - 障害の深刻度が増加しました（例：情報→警告）<br> - 障害の深刻度が低下しました（例：警告→情報）<br> - 障害の深刻度は変更されましたが、元のレベルに戻りました（例：警告→情報→警告）<br> - アクションが実行されました。アクションの数も表示されます。<br> - アクションが実行されました。少なくとも1つは進行中です。アクションの数も表示されます。<br> - アクションが実行されました。少なくとも1つは失敗しました。アクションの数も表示されます。<br>アイコンの上にマウスを置くと、アクティビティの詳細を示すポップアップが表示されます。実行されたアクションのポップアップで使用されるアイコンの詳細については[詳細の表示](#Viewing_details)を参照してください。| |*タグ*|(存在する場合)[タグ](/manual/config/tagging)が表示されます。<br>さらに、外部チケットシステムからのタグも表示される場合があります（[webhooks](/manual/config/notifications/media/webhook)を設定する際の*プロセスタグ*オプションを参照）| #### Overview In order to use any other language than English in Zabbix web interface, its locale should be installed on the web server. Additionally, the PHP gettext extension is required for the translations to work. #### 概要 Zabbix Webインターフェースで英語以外の言語を使用するには、そのロケールをWebサーバーにインストールする必要があります。さらに翻訳を機能させるには、PHPのgettext拡張機能が必要です。 #### Overview In *Reports → Availability report* you can see what proportion of time each trigger has been in problem/ok state. The percentage of time for each state is displayed. Thus it is easy to determine the availability situation of various elements on your system. {width="600"} From the drop-down in the upper right corner, you can choose the selection mode - whether to display triggers by hosts or by triggers belonging to a template. {width="600"} The name of the trigger is a link to the latest events of that trigger. #### 概要 *レポート → 稼働レポート*で、各トリガーが障害/正常状態にあった時間の割合を確認できます。各状態の時間がパーセンテージで表示されます。 システム上のさまざまな要素の可用性状況を簡単に判断できます。 {width="600"} 右上隅のドロップダウンから、選択モードを選択できます。トリガーをホストごとに表示するか、トリガーテンプレートごとに表示するかを選択できます。 {width="600"} トリガーの名前は、そのトリガーの最新イベントへのリンクです。 #### Overview In *Reports → System information* a summary of key Zabbix server and system data is displayed. Note that in a high availability setup, it is possible to redirect the system information source (server instance) by editing the ui/conf/zabbix.conf.php file - uncomment and set $ZBX\_SERVER, $ZBX\_SERVER\_PORT to a server other than the one shown active. With the high availability setup enabled, a separate block is displayed below the system stats with details of high availability nodes. This block is visible to Zabbix Super Admin users only. *System information* is also available as a dashboard [widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets). #### 概要 *レポート → システム情報*には、主要なZabbixサーバーとシステムデータの概要が表示されます。 高可用性セットアップでは、ui/conf/zabbix.conf.phpファイルを編集してシステム情報ソース（サーバーインスタンス）をリダイレクトできることに注意してください - コメントを外してset $ZBX\_SERVER, $ZBX\_SERVER\_PORTをアクティブに示されているサーバー以外のサーバーに設定します。 高可用性セットアップを有効にすると、システム統計の下に高可用性ノードの詳細を示す別のブロックが表示されます。 このブロックは、Zabbixスーパー管理者ユーザーにのみ表示されます。 *システム情報*はダッシュボード[ウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)としても利用できます。 #### Overview Internal checks allow to monitor the internal processes of Zabbix. In other words, you can monitor what goes on with Zabbix server or Zabbix proxy. Internal checks are calculated: - on Zabbix server - if the host is monitored by server - on Zabbix proxy - if the host is monitored by proxy Internal checks are processed by server or proxy regardless of host maintenance status. To use this item, choose the **Zabbix internal** item type. ::: notetip Internal checks are processed by Zabbix pollers. ::: #### 概要 内部チェックでは、Zabbixの内部処理を監視することができます。つまり、ZabbixサーバーやZabbixプロキシで何が行われているのかを監視することができます。 内部チェックは次のように計算されます: - Zabbixサーバー上 - ホストがサーバーによって監視されている場合 - Zabbixプロキシ上 - ホストがプロキシによって監視されている場合 内部チェックは、ホストのメンテナンス状態に関係なく、サーバーまたはプロキシで処理されます。 このアイテムを使用するには、アイテムの**Zabbixインターナル**タイプを選択してください。 ::: notetip 内部チェックはZabbix pollerプロセスによって処理されます ::: #### Overview In the action log widget, you can display details of action operations (notifications, remote commands). It replicates information from *Reports → Action log*. #### 概要 アクションログウィジェットでは、アクション操作 (通知、リモート コマンド) の詳細を表示できます。*レポート → アクションログ*の情報を複製します。 #### Overview In the *Administration → Media types* section users can configure and maintain media type information. Media type information contains general instructions for using a medium as delivery channel for notifications. Specific details, such as the individual e-mail addresses to send a notification to are kept with individual users. A listing of existing media types with their details is displayed. {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Name of the media type. Clicking on the name opens the media type [configuration form](/manual/config/notifications/media/email#configuration).| |*Type*|Type of the media (e-mail, SMS, etc) is displayed.| |*Status*|Media type status is displayed - *Enabled* or *Disabled*.<br>By clicking on the status you can change it.| |*Used in actions*|All actions where the media type is used directly (selected in the *Send only to* dropdown) are displayed. Clicking on the action name opens the action configuration form.| |*Details*|Detailed information of the media type is displayed.| |*Actions*|The following action is available:<br>**Test** - click to open a testing form where you can enter media type parameters (e.g. a recipient address with test subject and body) and send a test message to verify that the configured media type works. See also: [Media type testing](/manual/config/notifications/media#media_type_testing).| To configure a new media type, click on the *Create media type* button in the top right-hand corner. To import a media type, click on the *Import* button in the top right-hand corner. #### 概要 *管理 → メディアタイプ*セクションで、ユーザーはメディアタイプ情報を設定および保守できます。 メディアタイプ情報には、通知の配信チャネルとしてメディアを使用するための一般的な手順が含まれています。通知を送信する個々の電子メールアドレスなどの特定の詳細は、個々のユーザーに保持されます。 既存のメディアタイプとその詳細のリストが表示されます。 {width="600"} 表示されるデータ: |列|詳細| |--|--------| |*名前*|メディアタイプの名前。名前をクリックすると、メディアタイプ[設定フォーム](/manual/config/notifications/media/email#configuration)が開きます。| |*タイプ*|メディアタイプを表示します。 (e-mail, SMS, 他) | |*ステータス*|メディアタイプのステータスを表示します - *有効*または*無効*<br>クリックでステータスを変更できます。| |*アクションで使用*|メディア タイプが直接使用されるすべてのアクション(*次のメディアのみ使用*ドロップダウンで選択)が表示されます。アクション名をクリックするとアクション設定フォームが開きます。| |*詳細*|メディアタイプの詳細情報が表示されます。| |*アクション*|次のアクションが利用可能です:<br>**テスト** - クリックするとテストフォームが開き、メディアタイプパラメータ(たとえば、テストの件名と本文を含む受信者アドレス)を入力し、テストメッセージを送信して設定されたメディアタイプの動作確認をします。参照：[メディアタイプテスト](/manual/config/notifications/media#メディアタイプのテスト)| 新しいメディアタイプを設定するには、右上隅にある*メディアタイプの作成*ボタンをクリックします。 メディアタイプをインポートするには、右上隅にある*インポート*ボタンをクリックします。 #### Overview In the *Administration → Proxies* section proxies for [distributed monitoring](/manual/distributed_monitoring) can be configured in the Zabbix frontend. #### 概要 *管理 → プロキシ*セクションで[分散モニタリング](/manual/distribution_monitoring)のプロキシをZabbixフロントエンドで設定できます。 #### Overview In the *Administration → User groups* section user groups of the system are maintained. #### 概要 *管理 → ユーザグループ*セクションでは、システムのユーザグループをメンテナンスできます。 #### Overview In the *Administration → User roles* section roles that can be assigned to system users and specific permissions for each role are maintained. #### 概要 *管理 → ユーザー → 権限 → ユーザーの役割*セクションでは、システムユーザーに割り当てることができる役割と各役割の権限を設定できます。 #### Overview In the *Administration → Users* section users of the system are maintained. #### 概要 *管理 → ユーザー*セクションでシステムのユーザーを管理できます。 #### Overview In the classic graph widget, you can display a single custom graph or simple graph. #### 概要 従来のグラフウィジェットでは、単一のカスタムグラフまたは単純なグラフを表示できます。 #### Overview In the clock widget, you may display local, server, or specified host time. #### 概要 時計ウィジェットでは、ローカル、サーバー、または指定されたホスト時間を表示できます。 #### Overview In the *Configuration → Discovery* section users can configure and maintain discovery rules. A listing of existing discovery rules with their details is displayed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the discovery rule. Clicking on the discovery rule name opens the discovery rule [configuration form](/manual/discovery/network_discovery/rule).| |*IP range*|The range of IP addresses to use for network scanning is displayed.| |*Proxy*|The proxy name is displayed, if discovery is performed by the proxy.| |*Interval*|The frequency of performing discovery displayed.| |*Checks*|The types of checks used for discovery are displayed.| |*Status*|Action status is displayed - *Enabled* or *Disabled*.<br>By clicking on the status you can change it.| To configure a new discovery rule, click on the *Create discovery rule* button in the top right-hand corner. #### 概要 *設定 → ディスカバリ*セクションで、ユーザーはディスカバリルールを構成および維持できます。 既存のディスカバリルールとその詳細のリストが表示されます。 {width="600"} 表示情報: |列|詳細| |------|-----------| |*名前*|ディスカバリルールの名前。ルール名をクリックすると、ディスカバリルール[設定フォーム](/manual/discovery/network_discovery/rule)が開きます。| |*IPアドレスの範囲*|ネットワークスキャンに使用するIPアドレスの範囲が表示されます。| |*プロキシ*|プロキシによってディスカバリが実行される場合は、プロキシ名が表示されます。| |*監視間隔*|ディスカバリを実行する頻度が表示されます。| |*チェック*|ディスカバリに使用されたチェックのタイプが表示されます。| |*ステータス*|アクションステータスが表示されます-*有効*または*無効*。<br>ステータスをクリックするとステータスを変更できます。| 新しいディスカバリルールを設定するには、右上隅にある[ディスカバリルールの作成]ボタンをクリックします。 #### Overview In the *Configuration → Event correlation* section users can configure and maintain global correlation rules for Zabbix events. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the correlation rule. Clicking on the correlation rule name opens the rule [configuration form](/manual/config/event_correlation/global#configuration).| |*Conditions*|Correlation rule conditions are displayed.| |*Operations*|Correlation rule operations are displayed.| |*Status*|Correlation rule status is displayed - *Enabled* or *Disabled*.<br>By clicking on the status you can change it.| To configure a new correlation rule, click on the *Create correlation* button in the top right-hand corner. #### 概要 *設定 → イベント相関*セクションで、ユーザーはZabbixイベントのグローバル相関ルールを設定および維持できます。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|相関関係の名前。相関関係名をクリックすると、相関関係[設定フォーム]が開きます。(/manual/config/event_correlation/global#configuration)| |*実行条件*|相関関係の条件が表示されます。| |*実行内容*|相関関係の操作が表示されます。| |*ステータス*|相関関係のステータスが表示されます - *有効*または*無効*。<br>ステータスをクリックすると、ステータスを変更できます。| 新しい相関関係を設定するには、右上隅にある[相関関係の作成]ボタンをクリックします。 #### Overview In the *Configuration → Maintenance* section users can configure and maintain maintenance periods for hosts. A listing of existing maintenance periods with their details is displayed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the maintenance period. Clicking on the maintenance period name opens the maintenance period [configuration form](/manual/maintenance#configuration).| |*Type*|The type of maintenance is displayed: *With data collection* or *No data collection*| |*Active since*|The date and time when executing maintenance periods becomes active.<br>Note: This time does not activate a maintenance period; maintenance periods need to be set separately.| |*Active till*|The date and time when executing maintenance periods stops being active.| |*State*|The state of the maintenance period:<br>**Approaching** - will become active soon<br>**Active** - is active<br>**Expired** - is not active any more| |*Description*|Description of the maintenance period is displayed.| To configure a new maintenance period, click on the *Create maintenance period* button in the top right-hand corner. #### 概要 *設定 → メンテナンス*セクションで、ホストのメンテナンス期間を設定および維持できます。 既存のメンテナンス期間とその詳細のリストが表示されます。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|メンテナンス期間の名前。 メンテナンス期間名をクリックすると、メンテナンス期間[設定フォーム](/manual/maintenance#configuration)が開きます。| |*タイプ*|メンテナンスのタイプが表示されます：*データ収集あり*または*データ収集なし*| |*設定有効期間の開始日時*|メンテナンス期間の実行がアクティブになる日時。<br>注：この時間はメンテナンス期間の設定ではありません。 メンテナンス期間は別途設定する必要があります。| |*設定有効期間の終了日時*|メンテナンス期間の実行がアクティブでなくなる日時。| |*状態*|メンテナンス期間の状態：<br>**メンテナンス待ち** - まもなくアクティブになります<br>**有効** - アクティブです<br>**メンテナンス機関の終了** - もうアクティブではありません| |*説明*|メンテナンス期間の説明が表示されます。| 新しいメンテナンス期間を設定するには、右上隅にある*メンテナンス期間の作成*ボタンをクリックします。 #### Overview In the *Configuration → Templates* section users can configure and maintain templates. A listing of existing templates with their details is displayed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the template. Clicking on the template name opens the template [configuration form](/manual/config/templates/template#creating_a_template).| |*Hosts*|Number of editable hosts to which the template is linked; read-only hosts are not included.<br>Clicking on *Hosts* will open the host list with only those hosts filtered that are linked to the template.| |*Entities (Items, Triggers, Graphs, Dashboards, Discovery, Web)*|Number of the respective entities in the template (displayed in gray). Clicking on the entity name will, in the whole listing of that entity, filter out those that belong to the template.| |*Linked templates*|Templates that are linked to the template, in a nested setup where the template will inherit all entities of the linked templates.| |*Linked to templates*|The templates that the template is linked to ("children" templates that inherit all entities from this template).<br>Since Zabbix 5.0.3, this column no longer includes hosts.| |*Tags*|[Tags](/manual/config/tagging) of the template, with macros unresolved.| To configure a new template, click on the *Create template* button in the top right-hand corner. To import a template from a YAML, XML, or JSON file, click on the *Import* button in the top right-hand corner. #### 概要 *設定 → テンプレート*セクションで、ユーザーはテンプレートを設定および保守できます。 既存のテンプレートとその詳細のリストが表示されます。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|テンプレートの名前。 クリックするとテンプレートの[設定フォーム](/manual/config/templates/template#creating_a_template)が開きます| |*ホスト*|テンプレートがリンクされている編集可能なホストの数。 読み取り専用ホストは含まれていません。<br>*ホスト*をクリックすると、テンプレート名でフィルターされたホストリストが開きます。| |*エンティティ (アイテム, トリガー, グラフ, ダッシュボード, ディスカバリ, Web)*|テンプレート内のそれぞれのエンティティの数。（灰色で表示）エンティティ名をクリックすると、テンプレート名でフィルターされたそのエンティティのリストが表示されます。| |*テンプレートとのリンク*|テンプレートにリンクされているテンプレート。ネストしてセットアップされたテンプレートは、リンクされたテンプレートのすべてのエンティティを継承します。| |*テンプレートへのリンク*|テンプレートがリンクされているテンプレート（このテンプレートからすべてのエンティティを継承する「子」テンプレート）。<br> Zabbix 5.0.3以降、この列にはホストが含まれなくなりました。| |*タグ*|テンプレートの[Tags](/manual/config/tagging)。マクロは未解決です。| 新しいテンプレートを設定するには、右上隅にある*テンプレートの作成*ボタンをクリックします。 YAML、XML、またはJSONファイルからテンプレートをインポートするには、右上隅にある*インポート*ボタンをクリックします。 #### Overview In the data overview widget, you can display the latest data for a group of hosts. The color of problem items is based on the problem severity color, which can be adjusted in the [problem update](/manual/acknowledges#updating_problems) screen. By default, only values that fall within the last 24 hours are displayed. This limit has been introduced with the aim of improving initial loading times for large pages of latest data. This limit is configurable in *Administration* → *General* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)*, using the *Max history display period* option. Clicking on a piece of data offers links to some predefined graphs or latest values. Note that 50 records are displayed by default (configurable in *Administration* → *General* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)*, using the *Max number of columns and rows in overview tables* option). If more records exist than are configured to display, a message is displayed at the bottom of the table, asking to provide more specific filtering criteria. There is no pagination. Note that this limit is applied first, before any further filtering of data, for example, by tags. #### 概要 データの概要ウィジェットでは、ホストグループの最新データを表示できます。 障害項目の色は障害の深刻度の色に基づいており、[障害の更新](/manual/acknowledges#updating_problems)画面で調整できます。 デフォルトでは過去24時間以内の値のみが表示されます。 この制限は最新データが大きなページとなった場合の初期読み込み時間を改善することを目的として導入されました。 この制限は*管理*→*一般設定*→*[表示設定](/manual/web_interface/frontend_sections/administration/general#gui)*で*ヒストリの最大表示期間*オプションを使用して変更できます。 データをクリックすると、いくつかの事前定義されたグラフまたは最新の値へのリンクが表示されます。 デフォルトでは50レコードが表示されます。（*管理*→*一般設定*→*[表示設定](/manual/web_interface/frontend_sections/administration/general#gui)*の*概要テーブル内の列と行の最大数*オプションで変更可能です）最大数より多くのレコードが存在する場合は、テーブルの下部にメッセージが表示され、より具体的なフィルタリング基準を提供するように求められます。 改ページはありません。 #### Overview In the graph prototype widget, you can display a grid of graphs created from either a graph prototype or an item prototype by low-level discovery. #### 概要 グラフのプロトタイプウィジェットでは、低レベルディスカバリによってプロトタイプグラフまたはプロトタイプアイテムのいずれかから作成されたグラフのグリッドを表示できます。 #### Overview In the host availability widget, high-level statistics about host availability are displayed in four colored columns/lines. | | | |---|---| ||Horizontal display (columns).| ||Vertical display (lines).| Host availability in each column/line is counted as follows: - *Available* - hosts with all interfaces available - *Not available* - hosts with at least one interface unavailable - *Unknown* - hosts with at least one interface unknown (none unavailable) - *Total* - total of all hosts #### 概要 ホスト稼働状況ウィジェットでは、ホストの稼働状況に関する高レベルの統計が4つの色付きの列/行に表示されます。 | | | |---|---| ||水平表示（列）.| ||垂直表示（線）.| 各列/行のホストの稼働状況は次のようにカウントされます。 - *利用可能* - すべてのインターフェースが利用可能なホスト - *使用不可* - 少なくとも1つのインターフェースが使用できないホスト - *不明* - 少なくとも1つのインターフェースが不明なホスト（使用不可） - *合計* - すべてのホストの合計 #### Overview In the *Monitoring → Discovery* section results of [network discovery](/manual/discovery/network_discovery) are shown. Discovered devices are sorted by the discovery rule. {width="600"} If a device is already monitored, the host name will be listed in the *Monitored host* column, and the duration of the device being discovered or lost after previous discovery is shown in the *Uptime/Downtime* column. After that follow the columns showing the state of individual services for each discovered device (red cells show services that are down). Service uptime or downtime is included within the cell. ::: noteimportant Only those services that have been found on at least one device will have a column showing their state. ::: #### 概要 *監視データ → ディスカバリ*セクションには*ネットワークディスカバリ*(/manual/discovery/network_discovery)の結果が表示されます。 検出されたデバイスは、ディスカバリルールによって並べ替えられます。 {width="600"} デバイスがすでに監視されている場合は、ホスト名が*監視中のホスト*列に表示され、前回の検出後にデバイスが検出または失われた期間が*アップタイム/ダウンタイム*列に表示されます。 検出された各デバイスの個々のサービスの状態が表示されます。（赤いセルはダウンしているサービスを示します） サービスのアップタイムまたはダウンタイムはセルに含まれます。 ::: noteimportant 少なくとも1つのデバイスで検出されたサービスに、状態を示す列が表示されます。 ::: #### Overview In the *Monitoring → Maps* section you can configure, manage and view [network maps](/manual/config/visualization/maps). When you open this section, you will either see the last map you accessed or a listing of all maps you have access to. All maps can be either public or private. Public maps are available to all users, while private maps are accessible only to their owner and the users the map is shared with. #### 概要 *監視データ → マップ*セクションでは[ネットワークマップ](/manual/config/visualization/maps)を構成、管理、および表示できます。 このセクションを開くと最後にアクセスしたマップ、またはアクセスできるすべてのマップのリストが表示されます。 すべてのマップは、パブリックまたはプライベートのいずれかになります。 パブリックマップはすべてのユーザーが利用できますが、プライベートマップは、所有者とマップが共有されているユーザーのみがアクセスできます。 #### Overview In the plain text widget, you can display the latest item data in plain text. #### 概要 プレーンテキストウィジェットでは、最新のアイテムデータをプレーンテキストで表示できます。 #### Overview In the problem host widget, you can display high-level information about host availability. #### 概要 障害中のホストウィジェットでは、ホストの稼働状況に関する高レベルの情報を表示できます。 #### Overview In the *Reports → Notifications* section a report on the number of notifications sent to each user is displayed. From the dropdowns in the top right-hand corner you can choose the media type (or all), period (data for each day/week/month/year) and year for the notifications sent. {width="600"} Each column displays totals per one system user. #### 概要 *レポート → 通知レポート*セクションには、各ユーザーに送信された通知の数に関するレポートが表示されます。 右上隅のドロップダウンから、送信される通知のメディアタイプ（またはすべて）、期間（各日/週/月/年のデータ）、および年を選択できます。 {width="600"} 各列にはシステムユーザーごとの合計が表示されます。 ### Overview In the *Services → Service actions* section users can [configure](/manual/config/notifications/action) and maintain service actions. Configured actions are displayed in the list with respect to the user role permissions (see *Access to services* in [user roles](/manual/web_interface/frontend_sections/administration/user_roles)). Users will only see actions for services their user role grants access to. Displayed data, filter and available mass editing options are the same as for other types of [actions](/manual/web_interface/frontend_sections/configuration/actions). ### 概要 *サービス → サービスアクション*セクションで、サービスアクションを[設定](/manual/config/notifications/action)および維持できます。 設定されたアクションは、ユーザロール権限([ユーザー ロール](/manual/web_interface/frontend_sections/administration/user_roles)の*サービスへのアクセス*を参照)に応じてリストに表示されます。 表示されるデータ、フィルター、および使用可能な一括編集オプションは、[アクション](/manual/web_interface/frontend_sections/configuration/actions)と同じです。 #### Overview In the trigger overview widget, you can display the trigger states for a group of hosts. - The trigger states are displayed as colored blocks (the color of problem triggers depends on the problem severity color, which can be adjusted in the [problem update](/manual/acknowledges#updating_problems) screen). Note that recent trigger changes (within the last 2 minutes) will be displayed as blinking blocks. - Blue up and down arrows indicate triggers that have dependencies. On mouseover, dependency details are revealed. - A checkbox icon indicates acknowledged problems. All problems or resolved problems of the trigger must be acknowledged for this icon to be displayed. Clicking on a trigger block provides context-dependent links to problem events of the trigger, the problem acknowledgment screen, trigger configuration, trigger URL or a simple graph/latest values list. Note that 50 records are displayed by default (configurable in *Administration* → *General* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)*, using the *Max number of columns and rows in overview tables* option). If more records exist than are configured to display, a message is displayed at the bottom of the table, asking to provide more specific filtering criteria. There is no pagination. #### 概要 トリガー概要ウィジェットでは、ホストグループのトリガー状態を表示できます。 - トリガーの状態は色付きのブロックで表示されます。（障害のトリガー色は障害の申告度の色によって異なり[障害の更新](/manual/acknowledges#updating_problems)画面で調整できます） 最近のトリガーの変更（過去2分以内）は点滅するブロックとして表示されることに注意してください。 - 青い上向き矢印と下向き矢印は依存関係があるトリガーを示します。 マウスオーバーすると依存関係の詳細が表示されます。 - チェックボックスアイコンは確認済みの障害を示します。 このアイコンを表示するにはトリガーのすべての障害または解決された障害を確認する必要があります。 トリガーブロックをクリックすると、トリガーの障害イベント、障害確認画面、トリガー構成、トリガーURL、またはシンプルグラフ/最新の値のリストへのリンクが表示されます。 デフォルトでは50レコードが表示されます。（*管理*→*一般設定*→* [表示設定](/manual/web_interface/frontend_sections/administration/general#gui)*の*概要テーブル内の列と行の最大数*オプションで設定可能です） 設定値よりも多くのレコードが存在する場合は、テーブルの下部にメッセージが表示され、より具体的なフィルタリング基準を提供するように求められます。 改ページ機能はありません。 #### Overview In this preprocessing step it is possible to convert CSV file data into JSON format. It's supported in: - items (item prototypes) - low-level discovery rules #### 概要 この保存前処理で、CSVファイルデータをJSON形式に変換することが可能です。サポートしているのは、 - アイテム(アイテムのプロトタイプ) - ローレベルディスカバリルール #### Overview In this section the configured graph prototypes of a low-level discovery rule on the template are displayed. If the template is linked to the host, graph prototypes will become the basis of creating real host [graphs](/manual/web_interface/frontend_sections/configuration/hosts/graphs) during low-level discovery. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the graph prototype, displayed as a blue link.<br>Clicking on the name opens the graph prototype [configuration form](/manual/discovery/low_level_discovery/graph_prototypes).<br>If the graph prototype belongs to a linked template, the template name is displayed before the graph name, as a gray link. Clicking on the template link will open the graph prototype list on the linked template level.| |*Width*|Width of the graph prototype is displayed.| |*Height*|Height of the graph prototype is displayed.| |*Type*|Type of the graph prototype is displayed - *Normal*, *Stacked*, *Pie* or *Exploded*.| |*Discover*|Discover the graph based on this prototype:<br>**Yes** - discover<br>**No** - do not discover. You can switch between 'Yes' and 'No' by clicking on them.| To configure a new graph prototype, click on the *Create graph prototype* button at the top right corner. #### 概要 このセクションでは、テンプレートの低レベルディスカバリルールの構成済みプロトタイプグラフが表示されます。 テンプレートがホストにリンクされている場合、プロトタイプグラフは、低レベルディスカバリ中に実際のホスト[items](/manual/web_interface/frontend_sections/configuration/hosts/graphs)を作成するための基礎になります。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|リンクとして表示されるプロトタイプグラフの名前。<br>名前をクリックすると、グラフのプロトタイプ[設定フォーム](/manual/discovery/low_level_discovery/graph_prototypes)が開きます。<br>グラフのプロトタイプがリンクされたテンプレートに属している場合 、テンプレート名はグラフ名の前に灰色のリンクとして表示されます。 テンプレートリンクをクリックすると、リンクされたテンプレートレベルでグラフのプロトタイプリストが開きます。| |*幅*|プロトタイプグラフの表示幅| |*高さ*|プロトタイプグラフの表示高| |*グラフのタイプ*|プロトタイプグラフのタイプ設定 - *ノーマル*, *積算グラフ*, *円グラフ* , *分解円グラフ*| |*ディスカバリ*|プロトタイプグラフのディスカバリ設定<br>**はい** - ディスカバリする<br>**いいえ** - ディスカバリしない。 クリックで「はい」と「いいえ」を切り替えることができます。| 新しいプロトタイプグラフを構成するには、右上隅にある*グラフのプロトタイプを作成*ボタンをクリックします。 #### Overview In this section the configured host prototypes of a low-level discovery rule on the template are displayed. If the template is linked to the host, host prototypes will become the basis of creating real [hosts](/manual/web_interface/frontend_sections/configuration/hosts) during low-level discovery. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the host prototype, displayed as a blue link.<br>Clicking on the name opens the host prototype configuration form.<br>If the host prototype belongs to a linked template, the template name is displayed before the host name, as a gray link. Clicking on the template link will open the host prototype list on the linked template level.| |*Templates*|Templates of the host prototype are displayed.| |*Create enabled*|Create the host based on this prototype as:<br>**Yes** - enabled<br>**No** - disabled. You can switch between 'Yes' and 'No' by clicking on them.| |*Discover*|Discover the host based on this prototype:<br>**Yes** - discover<br>**No** - do not discover. You can switch between 'Yes' and 'No' by clicking on them.| |*Tags*|Tags of the host prototype are displayed.| To configure a new host prototype, click on the *Create host prototype* button at the top right corner. #### 概要 このセクションでは、テンプレートの低レベルディスカバリルールの構成済みプロトタイプホストが表示されます。 テンプレートがホストにリンクされている場合、プロトタイプホストは、低レベルディスカバリ中に実際のホスト[items](/manual/web_interface/frontend_sections/configuration/hosts)を作成するための基礎になります。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|リンクとして表示されるプロトタイプホストの名前。<br>名前をクリックすると、ホストのプロトタイプ設定フォームが開きます。<br>ホストのプロトタイプがリンクされたテンプレートに属している場合 、テンプレート名は、ホスト名の前に灰色のリンクとして表示されます。 テンプレートリンクをクリックすると、リンクされたテンプレートレベルでホストのプロトタイプリストが開きます。| |*テンプレート*|プロトタイプホストのテンプレート表示| |*自動生成時のステータス有効*|プロトタイプホストのステータス設定<br>**はい** - 有効<br>**いいえ** - 無効。 クリックで「はい」と「いいえ」を切り替えることができます。| |*ディスカバリ*|プロトタイプホストのディスカバリ設定<br>**はい** - ディスカバリする<br>**いいえ** - ディスカバリしない。 クリックで「はい」と「いいえ」を切り替えることができます。| |*タグ*|プロトタイプホストのタグ表示| 新しいプロトタイプホストを構成するには、右上隅にある*ホストのプロトタイプを作成*ボタンをクリックします。 #### Overview In this section the configured item prototypes of a low-level discovery rule on the template are displayed. If the template is linked to the host, item prototypes will become the basis of creating real host [items](/manual/web_interface/frontend_sections/configuration/hosts/items) during low-level discovery. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the item prototype, displayed as a blue link.<br>Clicking on the name opens the item prototype [configuration form](/manual/discovery/low_level_discovery/item_prototypes).<br>If the item prototype belongs to a linked template, the template name is displayed before the item name, as a gray link. Clicking on the template link will open the item prototype list on the linked template level.| |*Key*|Key of the item prototype is displayed.| |*Interval*|Frequency of the check is displayed.| |*History*|How many days to keep item data history is displayed.| |*Trends*|How many days to keep item trends history is displayed.| |*Type*|Type of the item prototype is displayed (Zabbix agent, SNMP agent, simple check, etc).| |*Create enabled*|Create the item based on this prototype as:<br>**Yes** - enabled<br>**No** - disabled. You can switch between 'Yes' and 'No' by clicking on them.| |*Discover*|Discover the item based on this prototype:<br>**Yes** - discover<br>**No** - do not discover. You can switch between 'Yes' and 'No' by clicking on them.| |*Tags*|Tags of the item prototype is displayed.| To configure a new item prototype, click on the *Create item prototype* button at the top right corner. #### 概要 このセクションでは、テンプレートの低レベルディスカバリルールの構成済みプロトタイプアイテムが表示されます。 テンプレートがホストにリンクされている場合、プロトタイプアイテムは、低レベルディスカバリ中に実際のホスト[items](/manual/web_interface/frontend_sections/configuration/hosts/items)を作成するための基礎になります。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|リンクとして表示されるプロトタイプアイテムの名前。<br>名前をクリックすると、アイテムのプロトタイプ[設定フォーム](/manual/discovery/low_level_discovery/item_prototypes)が開きます。<br>アイテムのプロトタイプがリンクされたテンプレートに属している場合 、テンプレート名は、アイテム名の前に灰色のリンクとして表示されます。 テンプレートリンクをクリックすると、リンクされたテンプレートレベルでアイテムのプロトタイプリストが開きます。| |*キー*|プロトタイプアイテムのキー| |*監視間隔*|監視実行頻度| |*ヒストリ*|アイテムデータ履歴を保持する日数| |*トレンド*|アイテムのトレンド履歴を保持する日数| |*タイプ*|プロトタイプアイテムのタイプ設定（Zabbixエージェント、SNMPエージェント、簡易チェックなど）| |*自動生成時のステータス有効*|プロトタイプアイテムのステータス設定<br>**はい** - 有効<br>**いいえ** - 無効。 クリックで「はい」と「いいえ」を切り替えることができます。| |*ディスカバリ*|プロトタイプアイテムのディスカバリ設定<br>**はい** - ディスカバリする<br>**いいえ** - ディスカバリしない。 クリックで「はい」と「いいえ」を切り替えることができます。| |*タグ*|プロトタイプアイテムのタグが表示されます。| 新しいプロトタイプアイテムを構成するには、右上隅にある*アイテムのプロトタイプを作成*ボタンをクリックします。 #### Overview In this section the graph prototypes of a low-level discovery rule on the host are displayed. Graph prototypes are the basis of real host [graphs](/manual/web_interface/frontend_sections/configuration/hosts/graphs) that are created during low-level discovery. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the graph prototype, displayed as a blue link.<br>Clicking on the name opens the graph prototype [configuration form](/manual/discovery/low_level_discovery/graph_prototypes).<br>If the graph prototype belongs to a linked template, the template name is displayed before the graph name, as a gray link. Clicking on the template link will open the graph prototype list on the linked template level.| |*Width*|Width of the graph prototype is displayed.| |*Height*|Height of the graph prototype is displayed.| |*Type*|Type of the graph prototype is displayed - *Normal*, *Stacked*, *Pie* or *Exploded*.| |*Discover*|Discover the graph based on this prototype:<br>**Yes** - discover<br>**No** - do not discover. You can switch between 'Yes' and 'No' by clicking on them.| To configure a new graph prototype, click on the *Create graph prototype* button at the top right corner. #### 概要 このセクションでは、テンプレートの低レベルディスカバリルールの構成済みプロトタイプグラフが表示されます。 テンプレートがホストにリンクされている場合、プロトタイプグラフは、低レベルディスカバリ中に実際のホスト[items](/manual/web_interface/frontend_sections/configuration/hosts/graphs)を作成するための基礎になります。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|リンクとして表示されるプロトタイプグラフの名前。<br>名前をクリックすると、グラフのプロトタイプ[設定フォーム](/manual/discovery/low_level_discovery/graph_prototypes)が開きます。<br>グラフのプロトタイプがリンクされたテンプレートに属している場合 、テンプレート名はグラフ名の前に灰色のリンクとして表示されます。 テンプレートリンクをクリックすると、リンクされたテンプレートレベルでグラフのプロトタイプリストが開きます。| |*幅*|プロトタイプグラフの表示幅| |*高さ*|プロトタイプグラフの表示高| |*グラフのタイプ*|プロトタイプグラフのタイプ設定 - *ノーマル*, *積算グラフ*, *円グラフ* , *分解円グラフ*| |*ディスカバリ*|プロトタイプグラフのディスカバリ設定<br>**はい** - ディスカバリする<br>**いいえ** - ディスカバリしない。 クリックで「はい」と「いいえ」を切り替えることができます。| 新しいプロトタイプグラフを構成するには、右上隅にある*グラフのプロトタイプを作成*ボタンをクリックします。 #### Overview In this section the host prototypes of a low-level discovery rule on the host are displayed. Host prototypes are the basis of real [hosts](/manual/web_interface/frontend_sections/configuration/hosts) that are created during low-level discovery. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the host prototype, displayed as a blue link.<br>Clicking on the name opens the host prototype configuration form.<br>If the host prototype belongs to a linked template, the template name is displayed before the host name, as a gray link. Clicking on the template link will open the host prototype list on the linked template level.| |*Templates*|Templates of the host prototype are displayed.| |*Create enabled*|Create the host based on this prototype as:<br>**Yes** - enabled<br>**No** - disabled. You can switch between 'Yes' and 'No' by clicking on them.| |*Discover*|Discover the host based on this prototype:<br>**Yes** - discover<br>**No** - do not discover. You can switch between 'Yes' and 'No' by clicking on them.| |*Tags*|Tags of the host prototype are displayed.| To configure a new host prototype, click on the *Create host prototype* button at the top right corner. #### 概要 このセクションでは、テンプレートの低レベルディスカバリルールの構成済みプロトタイプホストが表示されます。 テンプレートがホストにリンクされている場合、プロトタイプホストは、低レベルディスカバリ中に実際のホスト[items](/manual/web_interface/frontend_sections/configuration/hosts)を作成するための基礎になります。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|リンクとして表示されるプロトタイプホストの名前。<br>名前をクリックすると、ホストのプロトタイプ設定フォームが開きます。<br>ホストのプロトタイプがリンクされたテンプレートに属している場合 、テンプレート名は、ホスト名の前に灰色のリンクとして表示されます。 テンプレートリンクをクリックすると、リンクされたテンプレートレベルでホストのプロトタイプリストが開きます。| |*テンプレート*|プロトタイプホストのテンプレート表示| |*自動生成時のステータス有効*|プロトタイプホストのステータス設定<br>**はい** - 有効<br>**いいえ** - 無効。 クリックで「はい」と「いいえ」を切り替えることができます。| |*ディスカバリ*|プロトタイプホストのディスカバリ設定<br>**はい** - ディスカバリする<br>**いいえ** - ディスカバリしない。 クリックで「はい」と「いいえ」を切り替えることができます。| |*タグ*|プロトタイプホストのタグ表示| 新しいプロトタイプホストを構成するには、右上隅にある*ホストのプロトタイプを作成*ボタンをクリックします。 #### Overview In this section the item prototypes of a low-level discovery rule on the host are displayed. Item prototypes are the basis of real host [items](/manual/web_interface/frontend_sections/configuration/hosts/items) that are created during low-level discovery. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the item prototype, displayed as a blue link.<br>Clicking on the name opens the item prototype [configuration form](/manual/discovery/low_level_discovery/item_prototypes).<br>If the item prototype belongs to a template, the template name is displayed before the rule name, as a gray link. Clicking on the template link will open the item prototype list on the template level.| |*Key*|Key of the item prototype is displayed.| |*Interval*|Frequency of the check is displayed.| |*History*|How many days to keep item data history is displayed.| |*Trends*|How many days to keep item trends history is displayed.| |*Type*|Type of the item prototype is displayed (Zabbix agent, SNMP agent, simple check, etc).| |*Create enabled*|Create the item based on this prototype as:<br>**Yes** - enabled<br>**No** - disabled. You can switch between 'Yes' and 'No' by clicking on them.| |*Discover*|Discover the item based on this prototype:<br>**Yes** - discover<br>**No** - do not discover. You can switch between 'Yes' and 'No' by clicking on them.| |*Tags*|Tags of the item prototype are displayed.| To configure a new item prototype, click on the *Create item prototype* button at the top right corner. #### 概要 このセクションでは、テンプレートの低レベルディスカバリルールの構成済みプロトタイプアイテムが表示されます。 テンプレートがホストにリンクされている場合、プロトタイプアイテムは、低レベルディスカバリ中に実際のホスト[items](/manual/web_interface/frontend_sections/configuration/hosts/items)を作成するための基礎になります。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|リンクとして表示されるプロトタイプアイテムの名前。<br>名前をクリックすると、アイテムのプロトタイプ[設定フォーム](/manual/discovery/low_level_discovery/item_prototypes)が開きます。<br>アイテムのプロトタイプがリンクされたテンプレートに属している場合 、テンプレート名は、アイテム名の前に灰色のリンクとして表示されます。 テンプレートリンクをクリックすると、リンクされたテンプレートレベルでアイテムのプロトタイプリストが開きます。| |*キー*|プロトタイプアイテムのキー| |*監視間隔*|監視実行頻度| |*ヒストリ*|アイテムデータ履歴を保持する日数| |*トレンド*|アイテムのトレンド履歴を保持する日数| |*タイプ*|プロトタイプアイテムのタイプ設定（Zabbixエージェント、SNMPエージェント、簡易チェックなど）| |*自動生成時のステータス有効*|プロトタイプアイテムのステータス設定<br>**はい** - 有効<br>**いいえ** - 無効。 クリックで「はい」と「いいえ」を切り替えることができます。| |*ディスカバリ*|プロトタイプアイテムのディスカバリ設定<br>**はい** - ディスカバリする<br>**いいえ** - ディスカバリしない。 クリックで「はい」と「いいえ」を切り替えることができます。| |*タグ*|プロトタイプアイテムのタグが表示されます。| 新しいプロトタイプアイテムを構成するには、右上隅にある*アイテムのプロトタイプを作成*ボタンをクリックします。 #### Overview In this section the trigger prototypes of a low-level discovery rule on the host are displayed. Trigger prototypes are the basis of real host [triggers](/manual/web_interface/frontend_sections/configuration/hosts/triggers) that are created during low-level discovery. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the trigger prototype, displayed as a blue link.<br>Clicking on the name opens the trigger prototype [configuration form](/manual/discovery/low_level_discovery/trigger_prototypes).<br>If the trigger prototype belongs to a linked template, the template name is displayed before the trigger name, as a gray link. Clicking on the template link will open the trigger prototype list on the linked template level.| |*Operational data*|Format of the operational data of the trigger is displayed, containing arbitrary strings and macros that will resolve dynamically in *Monitoring* → *Problems*.| |*Create enabled*|Create the trigger based on this prototype as:<br>**Yes** - enabled<br>**No** - disabled. You can switch between 'Yes' and 'No' by clicking on them.| |*Discover*|Discover the trigger based on this prototype:<br>**Yes** - discover<br>**No** - do not discover. You can switch between 'Yes' and 'No' by clicking on them.| |*Tags*|Tags of the trigger prototype are displayed.| To configure a new trigger prototype, click on the *Create trigger prototype* button at the top right corner. #### 概要 このセクションでは、テンプレートに設定された低レベルディスカバリルールのプロトタイプトリガーが表示されます。 テンプレートがホストにリンクされている場合、プロトタイプトリガーは、低レベルのディスカバリ中に実際のホスト[トリガー](/manual/web_interface/frontend_sections/configuration/hosts/triggers)を作成するための基礎になります。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|リンクとして表示されるプロトタイプトリガーの名前。<br>名前をクリックすると、トリガーのプロトタイプ[設定フォーム](/manual/discovery/low_level_discovery/trigger_prototypes)が開きます。<br>トリガーのプロトタイプがリンクされたテンプレートに属している場合 、テンプレート名は、アイテム名の前に灰色のリンクとして表示されます。 テンプレートリンクをクリックすると、リンクされたテンプレートレベルでトリガーのプロトタイプリストが開きます。| |*運用データ*|*監視データ*→*障害*で動的に解決される任意の文字列とマクロを含む、トリガーの操作データ形式が表示されます。| |*自動生成時のステータス有効*|プロトタイプトリガーのステータス設定<br>**はい** - 有効<br>**いいえ** - 無効。 クリックで「はい」と「いいえ」を切り替えることができます。| |*ディスカバリ*|プロトタイプトリガーのディスカバリ設定<br>**はい** - ディスカバリする<br>**いいえ** - ディスカバリしない。 クリックで「はい」と「いいえ」を切り替えることができます。| |*タグ*|プロトタイプトリガーのタグが表示されます。| 新しいプロトタイプトリガーを構成するには、右上隅にある*トリガーのプロトタイプの作成*ボタンをクリックします。 #### Overview In this section we will perform an SNMP [discovery](/manual/discovery/low_level_discovery) on a switch. #### 概要 このセクションでは、スイッチでSNMPの[検出](/manual/discovery/low_level_discovery)を実行します。 #### Overview In this section you can learn the meaning of some terms commonly used in Zabbix. #### 概要 このセクションでは、Zabbixで一般的に使用される用語の意味について説明します。 ### Overview In this section you can see a high-level status of whole services that have been configured in Zabbix, based on your infrastructure. A service may be a hierarchy consisting if several levels of other services, called "child" services, which are attributes to the overall status of the service (see also an overview of the [service monitoring](/manual/it_services) functionality.) The main categories of service status are *OK* or *Problem*, where the *Problem* status is expressed by the corresponding problem severity name and color. While the view mode allows to monitor services with their status and other details, you can also configure the service hierarchy in this section (add/edit services, child services) by switching to the edit mode. To switch from the view to the edit mode (and back) click on the respective button in the upper right corner: -  - view services -  - add/edit services, and child services Note that access to editing depends on [user role](/manual/web_interface/frontend_sections/administration/user_roles) settings. ### 概要 このセクションでは、インフラストラクチャに基づいて、Zabbix で構成されたサービス全体の高レベルのステータスを確認できます。 サービスは、サービスの全体的なステータスの属性である"子"サービスと呼ばれる他のサービスのいくつかのレベルで構成される階層である場合があります ([サービス監視](/manual/it_services) 機能の概要も参照してください)。 サービス ステータスの主なカテゴリは、*OK* または *障害* です。*障害* ステータスは、対応する障害の深刻度の名前と色で表されます。 表示モードでは、ステータスやその他の詳細でサービスを監視できますが、編集モードに切り替えることで、このセクションでサービス階層を構成することもできます (サービスの追加/編集、子サービス)。 ビューから編集モードに切り替える (および戻る) には、右上隅にあるそれぞれのボタンをクリックします。 -  - view services -  - add/edit services, and child services 編集へのアクセスは [ユーザー ロール](/manual/web_interface/frontend_sections/administration/user_roles) の設定に依存します。 ### Overview In this section you can see a high-level status of whole services that have been configured in Zabbix, based on your infrastructure. A service may be a hierarchy consisting of several levels of other services, called "child" services, which are attributes to the overall status of the service (see also an overview of the [service monitoring](/manual/it_services) functionality.) The main categories of service status are *OK* or *Problem*, where the *Problem* status is expressed by the corresponding problem severity name and color. While the view mode allows to monitor services with their status and other details, you can also [configure](/manual/web_interface/frontend_sections/services/service#editing-services) the service hierarchy in this section (add/edit services, child services) by switching to the edit mode. To switch from the view to the edit mode (and back) click on the respective button in the upper right corner: -  - view services -  - add/edit services, and child services Note that access to editing depends on [user role](/manual/web_interface/frontend_sections/administration/user_roles) settings. ### 概要 このセクションでは、インフラストラクチャに基づいてZabbixで設定されたサービス全体の概要を確認できます。 サービスは"子"サービスと呼ばれる他のサービスのいくつかのレベルで構成される階層である場合があります。これは、サービスの全体的なステータスの属性です。([サービス監視](/manual/it_services)機能の概要も参照してください) サービスステータスの主なカテゴリは*正常*または*障害*です。ここで、*障害*ステータスは、対応する問題の重大度の名前と色で表されます。 ビューモードではサービスのステータスやその他の詳細を監視できますが、編集モードに切り替えることで、このセクションのサービス階層（サービスの追加/編集、子サービス）を[設定](add/edit services, child services)することもできます。 。 ビューから編集モードに切り替える（および戻る）には、右上隅にあるそれぞれのボタンをクリックします。 -  - サービスを表示 -  - サービスおよび子サービスの追加/編集 編集へのアクセスは[ユーザーロール](/manual/web_interface/frontend_sections/administration/user_roles)の設定に依存することに注意してください。 ### Overview In this section you can see a high-level status of whole services that have been configured in Zabbix, based on your infrastructure. A service may be a hierarchy consisting of several levels of other services, called "child" services, which are attributes to the overall status of the service (see also an overview of the [service monitoring](/manual/it_services) functionality.) The main categories of service status are *OK* or *Problem*, where the *Problem* status is expressed by the corresponding problem severity name and color. While the view mode allows to monitor services with their status and other details, you can also [configure](/manual/web_interface/frontend_sections/services/service#editing-services) the service hierarchy in this section (add/edit services, child services) by switching to the edit mode. To switch from the view to the edit mode (and back) click on the respective button in the upper right corner: -  - view services -  - add/edit services, and child services Note that access to editing depends on [user role](/manual/web_interface/frontend_sections/administration/user_roles) settings. ### 概要 このセクションでは、Zabbix で設定されているサービス全体のステータスを、お客様のインフラストラクチャに基づいて概観できます。 サービスは、複数の階層にわたる他のサービス（"子"サービスと呼ばれる）から構成される階層構造になっている場合があります。子サービスは、サービスの全体的なステータスの属性となります（[サービス監視](/manual/it_services)機能の概要も参照してください）。 サービスステータスの主なカテゴリは *OK* または *問題* で、*問題* ステータスは、対応する問題の深刻度名と色で表されます。 表示モードでは、サービスのステータスやその他の詳細を監視できますが、編集モードに切り替えることで、このセクションでサービス階層を[設定](/manual/web_interface/frontend_sections/services/service#editing-services)（サービスや子サービスの追加/編集）することもできます。 表示モードから編集モードに切り替えるには（またその逆に切り替えるには）、右上にあるそれぞれのボタンをクリックします。 -  - サービスの表示 -  - サービスと子サービスの追加/編集 編集権限は[ユーザーロール](/manual/web_interface/frontend_sections/administration/user_roles)の設定によって異なりますのでご注意ください。 #### Overview In this section you may find some details of [additional operations](/manual/config/notifications/action/operation) for discovery/autoregistration events. #### 概要 このセクションでは、ディスカバリ/自動登録イベントの[追加操作](/manual/config/notifications/action/operation)の詳細を確認できます。 #### Overview In this section, you will learn how to log in and set up a system user in Zabbix. #### 概要 このセクションでは、Zabbixにログインしてシステムユーザーを設定する方法を学習します。 #### Overview In this section you will learn how to set up alerting in the form of notifications in Zabbix. With items collecting data and triggers designed to "fire" upon problem situations, it would also be useful to have some alerting mechanism in place that would notify us about important events even when we are not directly looking at Zabbix frontend. This is what notifications do. Email being the most popular delivery method for problem notifications, we will learn how to set up an email notification. #### 概要 このセクションでは、Zabbixで通知形式のアラートを設定する方法について説明します。 データを収集するアイテムや、障害発生時に"障害発生"と通知するトリガーがあれば、Zabbixフロントエンドを直接触っていない時でも、重要なイベント等を警告してくれる機能として便利でしょう。 これが通知機能のする事です。Eメールは障害発生時に最もよく使われる通知手段であり、ここではEメール通知の設定方法を学びます。 #### Overview In this section you will learn how to set up a new host. A host in Zabbix is a networked entity (physical, virtual) that you wish to monitor. The definition of what can be a "host" in Zabbix is quite flexible. It can be a physical server, a network switch, a virtual machine or some application. #### 概要 このセクションでは、新しいホストを設定する方法を学習します。 Zabbixのホストとは、監視するネットワークエンティティ(物理、仮想)です。Zabbixで"ホスト"とすることができるものは非常に柔軟です。物理サーバー、ネットワークスイッチ、仮想マシン、または一部のアプリケーションもホストとすることができます。 #### Overview In this section, you will learn how to set up an item. Items are the basis of gathering data in Zabbix. Without items, there is no data - because only an item defines a single metric or what kind of data to collect from a host. #### 概要 このセクションでは、どうやってアイテムを設定するかを説明します。 アイテムとは、Zabbixでデータを収集する基礎となるものです。アイテムなくしてデータは存在しえません。アイテムこそがメトリックの指標となり、ホストから収集するデータの種類を定義します。 #### Overview In this section you will learn how to set up a template. Previously we learned how to set up an item, a trigger and how to get a problem notification for the host. While all of these steps offer a great deal of flexibility in themselves, it may appear like a lot of steps to take if needed for, say, a thousand hosts. Some automation would be handy. This is where templates come to help. Templates allow to group useful items, triggers and other entities so that those can be reused again and again by applying to hosts in a single step. When a template is linked to a host, the host inherits all entities of the template. So, basically a pre-prepared bunch of checks can be applied very quickly. #### 概要 このセクションでは、テンプレートの設定について学びます。 これまでアイテムやトリガー、ホストの障害通知の設定方法を学びました。 これらの手順は柔軟性に富んではいますが、例えば千台のホストが必要な場合には多くの手順を踏む必要があるため、自動化が出来れば便利でしょう。 そこで役に立つのがテンプレートです。これは有用なアイテムやトリガー、その他エンティティをグループ化して、一度の手順でホストに何度も再使用できるようにする為のものです。 テンプレートがホストにリンクされると、ホストはそのテンプレートの全容を継承します。したがって、基本的には前もって準備されたチェックの数々を迅速に適用することができます。 #### Overview In this section you will learn how to set up a trigger. Items only collect data. To automatically evaluate incoming data we need to define triggers. A trigger contains an expression that defines a threshold of what is an acceptable level for the data. If that level is surpassed by the incoming data, a trigger will "fire" or go into a 'Problem' state - letting us know that something has happened that may require attention. If the level is acceptable again, trigger returns to an 'Ok' state. #### 概要 このセクションでは、トリガーを設定する方法を学習します。 アイテムはデータのみを収集します。受信データを自動的に評価するにはトリガーを定義する必要があります。トリガーはデータの許容レベルの閾値を定義する式を持ちます。 受信データが閾値を超えるとトリガーが"発砲"するかステータスが'障害'になり、注意が必要なことの発生を通知します。データが再び閾値内に戻るとトリガーはステータスを'正常'に戻します。 #### Overview In this widget you can display current problems. The information in this widget is similar to *Monitoring* → *Problems*. #### 概要 このウィジェットでは現在の障害を表示できます。 このウィジェットの情報は*監視データ* → *障害*に似ています。 #### Overview In this widget, you can display problems by severity. You can limit what hosts and triggers are displayed in the widget and define how the problem count is displayed. #### 概要 このウィジェットでは深刻度別に障害を表示できます。 ウィジェットに表示されるホストとトリガーを制限し、障害数の表示方法を定義できます。 ### Overview In Zabbix 6.0, [service monitoring](/manual/it_services) functionality has been reworked significantly (see [What's new in Zabbix 6.0.0](https://www.zabbix.com/documentation/6.0/en/manual/introduction/whatsnew600#services) for the list of changes). This page describes how services and SLAs, defined in earlier Zabbix versions, are changed during an upgrade to Zabbix 6.0 or newer. ### 概要 Zabbix 6.0では[サービスモニタリング](/manual/it_services)機能が大幅に作り直されました。（変更については[Zabbix 6.0.0の新機能](https://www.zabbix.com/documentation/current/jp/manual/introduction/whatsnew600#%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9)を参照） このページでは、Zabbix 6.0以降へのアップグレード中に、以前のZabbixバージョンで定義されたサービスとSLAがどのように変更されるかについて説明します。 #### Overview It is possible to allow active Zabbix agent autoregistration, after which the server can start monitoring them. This way new hosts can be added for monitoring without configuring them manually on the server. Autoregistration can happen when a previously unknown active agent asks for checks. The feature might be very handy for automatic monitoring of new Cloud nodes. As soon as you have a new node in the Cloud Zabbix will automatically start the collection of performance and availability data of the host. Active agent autoregistration also supports the monitoring of added hosts with passive checks. When the active agent asks for checks, providing it has the 'ListenIP' or 'ListenPort' configuration parameters defined in the configuration file, these are sent along to the server. (If multiple IP addresses are specified, the first one is sent to the server.) Server, when adding the new autoregistered host, uses the received IP address and port to configure the agent. If no IP address value is received, the one used for the incoming connection is used. If no port value is received, 10050 is used. It is possible to specify that the host should be autoregistered with a [DNS name](#using_dns_as_default_interface) as the default agent interface. Autoregistration is rerun: - if host [metadata](#using_host_metadata) information changes: - due to HostMetadata changed and agent restarted - due to value returned by HostMetadataItem changed - for manually created hosts with metadata missing - if a host is manually changed to be monitored by another Zabbix proxy - if autoregistration for the same host comes from a new Zabbix proxy #### 概要 サーバが監視を開始可能になった後は、アクティブな Zabbix エージェントの自動登録が可能です。自動登録によって、サーバ上で手動で設定をしなくても新しいホストを監視対象として追加できます。 前に認知されていないアクティブエージェントがチェックを求めたときに、自動登録がおこなわれます。 この機能は、新しいクラウドのノードの自動監視にとってとても便利です。クラウド環境で新しいノードをもつと同時に、Zabbix が自動的にそのホストのパフォーマンスと可用性のデータの収集を開始します。 アクティブエージェントの自動登録は、パッシブチェックで追加されたホストの監視もサポートしています。アクティブエージェントがチェックを求めたとき、自動登録をおこなうと、設定ファイルで定義された「ListenIP」または「ListenPort」設定のパラメータをもつことになり、これらはサーバに送信されます。（複数のIPアドレスが指定されている場合は、最初のものがサーバに送信されます。） 新しい自動登録ホストを追加したとき、サーバは受信したIPアドレスとポート番号をエージェントの設定に使用します。IPアドレスの値が1つも受信されない場合は、接続に使用されたアドレスが使用されます。ポート番号が1つも受信されない場合は、10050が使用されます。 デフォルトのエージェントインターフェイスとして[DNS名](#using_dns_as_default_interface)を使用してホストを自動登録するように指定できます。 次の場合は自動登録が再実行されます。 - ホスト[メタデータ](#using_host_metadata)情報が変更された場合： - ホストメタデータが変更され、エージェントが再起動したため - ホストメタデータアイテムによって返される値が変更されたため - メタデータが欠落する手動で作成されたホストの場合 - ホストを手動で変更して別のZabbixプロキシで監視する場合 - 同じホストの自動登録が新しいZabbixプロキシからのものである場合 #### Overview It is possible to automatically discover IPMI sensors. To do that, you may use a combination of: - the `ipmi.get` IPMI item (supported since Zabbix **5.0.0**) as the master item - dependent low-level discovery rule and item prototypes #### 概要 IPMIセンサーを自動的に検出することが可能です。 これを行うには次の組み合わせを使用します。 - マスターアイテムとしての`ipmi.get`IPMIアイテム（Zabbix **5.0.0**以降でサポート） - 依存するローレベルディスカバリルールとアイテムのプロトタイプ #### Overview It is possible to create custom rules regarding the times when an item is checked. The two methods for that are *Flexible intervals*, which allow to redefine the default update interval, and *Scheduling*, whereby an item check can be executed at a specific time or sequence of times. #### 概要 アイテムがチェックされる時間帯について、カスタムルールを作成することができます。 デフォルトの更新間隔を再定義できる*例外設定*と、特定の時間または一連の時間にアイテムチェックを実行することができる*定期設定*の2つの方法があります。 #### Overview It is possible to define that an action is executed only if the event matches a defined set of conditions. Conditions are set when configuring the [action](/manual/config/notifications/action#configuring_an_action). Condition matching is case-sensitive. #### 概要 イベントが定義済みの一連の条件に一致する場合にのみアクションが実行されるように定義できます。 [アクション](/manual/config/notifications/action#configuring_an_action)の設定時に条件を設定します。 条件一致では大文字と小文字が区別されます。 #### Overview It is possible to [discover](/manual/discovery/low_level_discovery) all interfaces configured in Zabbix frontend for a host. #### 概要 ホストのZabbixフロントエンドで設定されているすべてのインターフェースを[検出](/manual/discovery/low_level_discovery)することができます。 #### Overview It is possible to [discover](/manual/discovery/low_level_discovery) all JMX MBeans or MBean attributes or to specify a pattern for the discovery of these objects. It is mandatory to understand the difference between an MBean and MBean attributes for discovery rule configuration. An MBean is an object which can represent a device, an application, or any resource that needs to be managed. For example, there is an MBean which represents a web server. Its attributes are connection count, thread count, request timeout, http file cache, memory usage, etc. Expressing this thought in human comprehensive language we can define a coffee machine as an MBean which has the following attributes to be monitored: water amount per cup, average consumption of water for a certain period of time, number of coffee beans required per cup, coffee beans and water refill time, etc. #### 概要 すべての JMX MBean または MBean 属性を [検出](/manual/discovery/low_level_discovery) したり、これらのオブジェクトの検出パターンを指定したりできます。 ディスカバリ ルールを設定するには、MBean と MBean 属性の違いを理解しておく必要があります。 MBean は、管理が必要なデバイス、アプリケーション、または任意のリソースを表すことができるオブジェクトです。 たとえば、Web サーバーを表す MBean があります。 その属性は、接続数、スレッド数、リクエスト タイムアウト、http ファイル キャッシュ、メモリ使用量などです。 この考えを人間の包括的な言語で表現すると、コーヒー マシンを豆と水の補充時間などを監視対象の属性として持つ MBean として定義できます。 ### Overview It is possible to [discover](/manual/discovery/low_level_discovery) systemd units (services, by default) with Zabbix. ### 概要 Zabbixを使用してsystemdユニット（デフォルトではサービス）を[検出](/manual/discovery/low_level_discovery)することができます。 #### Overview It is possible to store some sensitive information secretly in HashiCorp Vault KV Secrets Engine - Version 2. Secrets can be saved for: - user macro values - database access credentials Zabbix provides read-only access to the secrets in Vault, assuming that secrets are managed by someone else. #### 概要 HashiCorp Vault KV Secrets Engine - Version 2では、いくつかの機密情報を秘密裏に保存することが可能です。<br> シークレットは、以下の目的で保存することができます: - ユーザーマクロの値 - データベースアクセスクレデンシャル Zabbix は Vault 内のシークレットを他の人が管理していると仮定して、読み取り専用アクセスを提供します。 #### Overview It is very important to have Zabbix system properly tuned for maximum performance. #### 概要 最大のパフォーマンスを得るには、Zabbix システムを適切に調整することが非常に重要です。 #### Overview JMX monitoring can be used to monitor JMX counters of a Java application. JMX monitoring has native support in Zabbix in the form of a Zabbix daemon called "Zabbix Java gateway", introduced since Zabbix 2.0. To retrieve the value of a particular JMX counter on a host, Zabbix server queries the Zabbix **Java gateway**, which in turn uses the [JMX management API](http://java.sun.com/javase/technologies/core/mntr-mgmt/javamanagement/) to query the application of interest remotely. For more details and setup see the [Zabbix Java gateway](/manual/concepts/java) section. ::: notewarning Communication between Java gateway and the monitored JMX application should not be firewalled. ::: #### 概要 JMX監視は、JavaアプリケーションのJMXカウンターを監視するために使用できます。 JMX監視はZabbix 2.0から導入された "Zabbix Java gateway"と呼ばれるZabbix daemon によって<br> Zabbixでネイティブにサポートされています。 ホスト上の特定のJMXカウンタの値を取得するために、Zabbix server はZabbix **Java gateway** に問合せをし、<br> Zabbixは[JMX management API](http://java.sun.com/javase/technologies/core/mntr-mgmt/javamanagement/)を使用して<br> 対象のアプリケーションにリモートで問い合わせをします。 詳細と設定方法は[Zabbix Java gateway](/manual/concepts/java)の項を参照してください。 ::: notewarning Java gatewayと監視対象のJMXアプリケーション間の通信をファイアウォールで遮断してはいけません。 ::: #### Overview Kerberos authentication can be used in web monitoring and HTTP items in Zabbix since version 4.4.0. This section describes an example of configuring Kerberos with Zabbix server to perform web monitoring of `www.example.com` with user 'zabbix'. #### 概要 バージョン4.4.0以降、ZabbixのWebモニタリングおよびHTTPアイテムでKerberos認証を使用できます。 このセクションでは、ユーザー'zabbix'で'www.example.com'のWeb監視を実行するZabbixサーバーで、Kerberosを構成する例について説明します。 #### Overview Linking is a process whereby templates are applied to hosts, whereas unlinking removes the association with the template from a host. ::: noteimportant Templates are linked directly to individual hosts and not to host groups. Simply adding a template to a host group will not link it. Host groups are used only for logical grouping of hosts and templates. ::: #### 概要 リンクは、テンプレートをホストに適用するプロセスです。リンクを解除すると、テンプレートとの関連付けがホストから削除されます。 ::: noteimportant テンプレートは、ホスト グループではなく、個々のホストに直接リンクされます。 テンプレートをホスト グループに追加するだけではリンクされません。 ホスト グループは、ホストとテンプレートの論理的なグループ化にのみ使用されます。 ::: #### Overview Media types are [exported](/manual/xml_export_import) with all related objects and object relations. #### 概要 メディアタイプは、関連するすべてのオブジェクトやオブジェクトの関係性と一緒に[エクスポート](/manual/xml_export_import)されます。 #### Overview Most Zabbix web interface pages support various HTTP GET parameters that control what will be displayed. They may be passed by specifying parameter=value pairs after the URL, separated from the URL by a question mark (?) and from each other by ampersands (&). #### 概要 ほとんどのZabbixWebインターフェースページは、表示される内容を制御するさまざまなHTTPGETパラメータをサポートしています。これらは、URLの後にparameter=valueのペアで指定し、疑問符（？）でURLから分離し、アンパサンド（＆）でペアを分離することで渡すことができます。 #### Overview Native support for monitoring JMX applications exists in the form of a Zabbix daemon called "Zabbix Java gateway", available since Zabbix 2.0. Zabbix Java gateway is a daemon written in Java. To find out the value of a particular JMX counter on a host, Zabbix server queries Zabbix Java gateway, which uses the [JMX management API](http://java.sun.com/javase/technologies/core/mntr-mgmt/javamanagement/) to query the application of interest remotely. The application does not need any additional software installed, it just has to be started with `-Dcom.sun.management.jmxremote` option on the command line. Java gateway accepts incoming connection from Zabbix server or proxy and can only be used as a "passive proxy". As opposed to Zabbix proxy, it may also be used from Zabbix proxy (Zabbix proxies cannot be chained). Access to each Java gateway is configured directly in Zabbix server or proxy configuration file, thus only one Java gateway may be configured per Zabbix server or Zabbix proxy. If a host will have items of type **JMX agent** and items of other type, only the **JMX agent** items will be passed to Java gateway for retrieval. #### 概要 JMXアプリケーションを監視するためのネイティブサポートは、"Zabbix Javaゲートウェイ"と呼ばれるZabbixデーモン形式で存在し、Zabbix 2.0以降で利用可能になりました。Zabbix JavaゲートウェイはJavaで書かれたデーモンです。ホスト上の特定のJMXカウンター値を見つけるために、ZabbixサーバーはZabbix Javaゲートウェイでクエリを実行します。Zabbix Javaゲートウェイは、[JMX管理API](http://java.sun.com/javase/technologies/core/mntr-mgmt/javamanagement/)を使用して対象のアプリケーションへリモートでクエリを実行します。アプリケーションに追加のソフトウェアをインストールする必要はありません。コマンドラインで`-Dcom.sun.management.jmxremote`オプションを使用して起動するだけです。 Javaゲートウェイは、Zabbixサーバーまたはプロキシからの着信接続を受け入れ、"パッシブプロキシ"としてのみ使用できます。 Zabbixプロキシとは違い、Zabbixプロキシからも使用できます (ZabbixプロキシはZabbixプロキシにチェーンできません)。各Javaゲートウェイへのアクセスは、Zabbixサーバーまたはプロキシ設定ファイルで直接設定されるため、Zabbixサーバーまたは Zabbixプロキシごとに設定できるJavaゲートウェイは1つだけです。ホストに**JMXエージェント**タイプのアイテムとその他のタイプのアイテムがある場合、**JMXエージェント**アイテムのみが取得のためにJavaゲートウェイに渡されます。 #### Overview Nesting is a way of one template encompassing one or more other templates. As it makes sense to separate out entities on individual templates for various services, applications, etc., you may end up with quite a few templates all of which may need to be linked to quite a few hosts. To simplify the picture, it is possible to link some templates together in a single template. The benefit of nesting is that you have to link only one template ("nest", parent template) to the host and the host will inherit all entities of the linked templates ("nested", child templates) automatically. For example, if we link templates T1 and T2 to template T3, we supplement T3 with entities from T1 and T2, and not vice versa. If we link template A to templates B and C, we supplement B and C with entities from A. #### 概要 ネストは、1つのテンプレートが1つ以上の他のテンプレートを包含する方法です。 さまざまなサービス、アプリケーションなどの個別のテンプレートでエンティティを分離することは理にかなっていますが、最終的に大量のテンプレートが作成され、またそのすべてを大量の数のホストにリンクする必要になる可能性があります。 単純化するために、複数のテンプレートを1つのテンプレートにリンクすることができます。 ネストの利点は、1つのテンプレート ("ネスト元"、親テンプレート) をホストにリンクするだけで済み、ホストはリンクされたテンプレート ("ネストされた"、子テンプレート) のすべてのエンティティを自動的に継承することです。 たとえば、テンプレートT1とT2をテンプレートT3にリンクすると、T1とT2のエンティティがT3に追加されますが、その逆はありません。 テンプレートAをテンプレートBとCにリンクすると、AのエンティティがBとCに追加されます。 #### Overview Network map [export](/manual/xml_export_import) contains: - all related images - map structure - all map settings, all contained elements with their settings, map links and map link status indicators ::: notewarning Any host groups, hosts, triggers, other maps or other elements that may be related to the exported map are not exported. Thus, if at least one of the elements the map refers to is missing, importing it will fail. ::: Network map export/import is supported since Zabbix 1.8.2. #### 概要 ネットワークマップの[export](/manual/xml_export_import) には、以下の内容が含まれます。 - すべての関連画像 - マップ構造 - すべてのマップ設定、すべての含まれる要素とその設定、マップリンク、 およびマップリンクとマップリンクステータスインジケーター ::: notewarning ホストグループ、ホスト、トリガー、他のマップ、または他の要素が含まれます。 <br> その他の要素は、export されません。 <br> したがって、マップが参照する要素のうち少なくとも 1 つが欠落している場合 <br> import に失敗します。 <br> ::: ネットワークマップのexport /import はZabbix1.8.2以降でサポートされています。 ### Overview Official Zabbix 6.0 LTS packages for Debian, Ubuntu, and Raspberry Pi OS (Raspbian) are available on [Zabbix website](https://www.zabbix.com/download). Packages are available with either MySQL/PostgreSQL database and Apache/Nginx web server support. ### 概要 Debian、Ubuntu、およびRaspberry Pi OS (Raspbian)用の公式Zabbix 6.0 LTSパッケージは、[Zabbix Webサイト](https://www.zabbix.com/download)で入手できます。 パッケージは、MySQL/PostgreSQLデータベースとApache/Nginx Webサーバーのいずれかをサポートしています。 ### Overview Official Zabbix 6.0 LTS packages for Red Hat Enterprise Linux and Oracle Linux are available on [Zabbix website](https://www.zabbix.com/download). ::: noteimportant Zabbix packages for Red Hat Enterprise Linux systems are intended only for RHEL systems. Alternative environments, such as [Red Hat Universal Base Image](https://catalog.redhat.com/software/base-images), may lack the necessary dependencies and repository access requirements for successful installation. To address such issues, verify compatibility with the target environment and ensure access to required repositories and dependencies before proceeding with Zabbix installation from packages. For more information, see [Known issues](/manual/installation/known_issues#zabbix-packages-for-rhel-on-red-hat-ubi-environments). ::: Packages are available with either MySQL/PostgreSQL database and Apache/Nginx web server support. *Zabbix agent* packages and utilities *Zabbix get* and *Zabbix sender* are available on Zabbix Official Repository for [RHEL 9](https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/), [RHEL 8](https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/), [RHEL 7](https://repo.zabbix.com/zabbix/6.0/rhel/7/x86_64/), [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/), and [RHEL 5](https://repo.zabbix.com/zabbix/6.0/rhel/5/x86_64/). ::: noteimportant Since Zabbix 6.0.35, Zabbix agent 2 packages are no longer available for [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/) due to Go 1.22 (and newer) being incompatible with GCC 4.4.7 provided by RHEL 6, which results in compilation errors. Note, however, that [Zabbix agent packages](/manual/installation/install_from_packages/rhel) are still supported. ::: Zabbix Official Repository provides *fping*, *iksemel* and *libssh2* packages as well. These packages are located in the [non-supported](https://repo.zabbix.com/non-supported/) directory. ::: noteimportant The EPEL repository for EL9 also provides Zabbix packages. If both the official Zabbix repository and EPEL repositories are installed, then the Zabbix packages in EPEL **must be** excluded by adding the following clause to the EPEL repo configuration file under `/etc/yum.repos.d/`: [epel] ... excludepkgs=zabbix* See also: [Accidental installation of EPEL Zabbix packages](/manual/installation/known_issues#accidental-installation-of-epel-zabbix-packages) ::: ### 概要 Red Hat Enterprise LinuxおよびOracle Linux用の公式Zabbix 6.0 LTSパッケージは、[Zabbix Webサイト](https://www.zabbix.com/download)で入手できます。 ::: noteimportant Red Hat Enterprise Linuxシステム用のZabbixパッケージは、RHELシステムのみを対象としています。 [Red Hat Universal Base Image](https://catalog.redhat.com/software/base-images)などの代替環境には、正常にインストールするために必要な依存関係やリポジトリアクセス要件が不足している可能性があります。 このような問題に対処するには、パッケージからZabbixのインストールを続行する前に、ターゲット環境との互換性を検証し、必要なリポジトリと依存関係へのアクセスを確認します。 詳細については、[既知の問題](/manual/installation/known_issues#zabbix-packages-for-rhel-on-red-hat-ubi-environments)を参照してください。 ::: パッケージは、MySQL/PostgreSQLデータベースとApache/Nginx Webサーバーをサポートしています。 *Zabbix エージェント*パッケージとユーティリティである*Zabbix get*および*Zabbix sender*は、Zabbix公式リポジトリで入手できます。 [RHEL 9](https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/)、 [RHEL 8](https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/)、 [RHEL 7](https://repo.zabbix.com/zabbix/6.0/rhel/7/x86_64/)、 [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/)、 [RHEL 5](https://repo.zabbix.com/zabbix/6.0/rhel/5/x86_64/)。 ::: noteimportant Zabbix 6.0.35以降、Go 1.22(およびそれ以降)はRHEL 6が提供するGCC 4.4.7と互換性がなく、コンパイルエラーが発生するため、Zabbixエージェント2パッケージは[RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/)では使用できなくなりました。 ただし、[Zabbixエージェントパッケージ](/manual/installation/install_from_packages/rhel)は引き続きサポートされていることに注意してください。 ::: Zabbix公式リポジトリでは、*fping*、*iksemel*、*libssh2*パッケージも提供しています。 これらのパッケージは、[non-supported](https://repo.zabbix.com/non-supported/)というディレクトリにあります。 ::: noteimportant EL9用のEPELリポジトリは、Zabbixパッケージも提供しています。 公式ZabbixリポジトリとEPELリポジトリの両方がインストールされている場合は、`/etc/yum.repos.d/`の下のEPELリポジトリ設定ファイルに次の句を追加して、EPEL内のZabbixパッケージを除外**しなければなりません**。 [epel] ... excludepkgs=zabbix* 詳細: [EPEL Zabbixパッケージの誤ったインストール](/manual/installation/known_issues#accidental-installation-of-epel-zabbix-packages) ::: ### Overview Official Zabbix 6.0 LTS packages for Red Hat Enterprise Linux, CentOS, and Oracle Linux are available on [Zabbix website](https://www.zabbix.com/download). Packages are available with either MySQL/PostgreSQL database and Apache/Nginx web server support. *Zabbix agent* packages and utilities *Zabbix get* and *Zabbix sender* are available on Zabbix Official Repository for [RHEL 9](https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/), [RHEL 8](https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/), [RHEL 7](https://repo.zabbix.com/zabbix/6.0/rhel/7/x86_64/), [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/), and [RHEL 5](https://repo.zabbix.com/zabbix/6.0/rhel/5/x86_64/). Zabbix Official Repository provides *fping*, *iksemel* and *libssh2* packages as well. These packages are located in the [non-supported](https://repo.zabbix.com/non-supported/) directory. ### 概要 Red Hat Enterprise Linux、CentOS、および Oracle Linux の公式 Zabbix 6.0 LTS パッケージは、[Zabbix Web サイト](https://www.zabbix.com/download) で入手できます。 パッケージは、MySQL/PostgreSQL データベースと Apache/Nginx Web サーバーのいずれかをサポートしています。 *Zabbix エージェント* パッケージとユーティリティ *Zabbix get* および *Zabbix sender* は、Zabbix 公式リポジトリで入手できます。 [RHEL 9](https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/) [RHEL 8](https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/) [RHEL 7](https://repo.zabbix.com/zabbix/6.0/rhel/7/x86_64/) [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/) [RHEL 5](https://repo.zabbix.com/zabbix/6.0/rhel/5/x86_64/) Zabbix 公式リポジトリでは、*fping*、*iksemel*、*libssh2* パッケージも提供しています。 これらのパッケージは [サポートされていない](https://repo.zabbix.com/non-supported/) ディレクトリにあります。 ### Overview Official Zabbix 6.0 LTS packages for SUSE Linux Enterprise Server are available on [Zabbix website](https://www.zabbix.com/download). *Zabbix agent* packages and utilities *Zabbix get* and *Zabbix sender* are available on Zabbix Official Repository for [SLES 15 (SP4 and newer)](https://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/) and [SLES 12 (SP4 and newer)](https://repo.zabbix.com/zabbix/6.0/sles/12/x86_64/). ::: noteclassic Using SLES 15 with SP3 or older is not recommended and may contain limitations. Also, please note that the *Verify CA* [encryption mode](/manual/appendix/install/db_encrypt/mysql) does not work on SLES 12 (all minor OS versions) with MySQL due to older MySQL libraries. ::: ### 概要 SUSE Linux Enterprise Serverの公式Zabbix 6.0 LTSパッケージは、[Zabbix Webサイト](https://www.zabbix.com/download)で入手できます。 *Zabbixエージェント*パッケージとユーティリティ*Zabbix get*および*Zabbix sender*は、Zabbix公式リポジトリ[SLES 15 (SP4以降)](https://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/)、[SLES 12 (SP4以降)](https://repo.zabbix.com/zabbix/6.0/sles/12/x86_64/)で入手できます。 ::: noteclassic SLES 15をSP3以前で使用することは推奨されず、制限がある場合があります。 また、*Verify CA*[暗号化モード](/manual/appendix/install/db_encrypt/mysql)は、MySQLライブラリが古いため、MySQLを使用するSLES 12 (すべてのマイナーOSバージョン)では機能しないことに注意してください。 ::: ### Overview Official Zabbix packages are available for: | | | |---|---| |Debian 10 (Buster)|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=debian&os_version=10_buster&db=mysql)| |Debian 9 (Stretch)|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=debian&os_version=9_stretch&db=mysql)| |Debian 8 (Jessie)|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=debian&os_version=8_jessie&db=mysql)| |Ubuntu 20.04 (Focal Fossa) LTS|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=ubuntu&os_version=20.04_focal&db=mysql)| |Ubuntu 18.04 (Bionic Beaver) LTS|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=ubuntu&os_version=18.04_bionic&db=mysql)| |Ubuntu 16.04 (Xenial Xerus) LTS|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=ubuntu&os_version=16.04_xenial&db=mysql)| |Ubuntu 14.04 (Trusty Tahr) LTS|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=ubuntu&os_version=14.04_trusty&db=mysql)| |Raspbian (Buster)|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=raspbian&os_version=10_buster&db=mysql)| |Raspbian (Stretch)|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=raspbian&os_version=9_stretch&db=mysql)| Packages are available with either MySQL/PostgreSQL database and Apache/Nginx webserver support. ::: noteimportant Zabbix 5.4 is not released yet. The download links lead to pre-5.4 packages. ::: ### Overview Official Zabbix packages are available for: | | | |---|---| |Debian 10 (Buster)|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=debian&os_version=10_buster&db=mysql)| |Debian 9 (Stretch)|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=debian&os_version=9_stretch&db=mysql)| |Debian 8 (Jessie)|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=debian&os_version=8_jessie&db=mysql)| |Ubuntu 20.04 (Focal Fossa) LTS|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=ubuntu&os_version=20.04_focal&db=mysql)| |Ubuntu 18.04 (Bionic Beaver) LTS|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=ubuntu&os_version=18.04_bionic&db=mysql)| |Ubuntu 16.04 (Xenial Xerus) LTS|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=ubuntu&os_version=16.04_xenial&db=mysql)| |Ubuntu 14.04 (Trusty Tahr) LTS|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=ubuntu&os_version=14.04_trusty&db=mysql)| |Raspbian (Buster)|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=raspbian&os_version=10_buster&db=mysql)| |Raspbian (Stretch)|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=raspbian&os_version=9_stretch&db=mysql)| Packages are available with either MySQL/PostgreSQL database and Apache/Nginx webserver support. ::: noteimportant Zabbix 5.4 is not released yet. The download links lead to pre-5.4 packages. ::: ### Overview Official Zabbix packages are available for: | | | |---|---| |RHEL 8, CentOS 8 and Oracle Linux 8|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql)| Packages are available with either MySQL/PostgreSQL database and Apache/Nginx webserver support. ::: noteimportant Zabbix 6.0 is not released yet. The download links lead to pre-5.4 packages. ::: ::: noteclassic *Verify CA* [encryption mode](/manual/appendix/install/db_encrypt/mysql) doesn't work on RHEL 7 with MySQL due to older MySQL libraries. ::: *Zabbix ​agent* packages and utilities *Zabbix get* and *Zabbix sender* are available for [RHEL 7](https://​repo.zabbix.com/​zabbix/​5.4/​rhel/​7/​x86_64/​), [RHEL 6](https://​repo.zabbix.com/​zabbix/​5.4/​rhel/​6/​x86_64/​) and [RHEL 5](https://​repo.zabbix.com/zabbix/​5.4/​rhel/​5/​x86_64) as well. Zabbix official repository provides fping and libssh2 packages as well. These packages are located in the [non-supported](https://repo.zabbix.com/non-supported/) directory. ### Overview Official Zabbix packages are available for: | | | |---|---| |RHEL 8, CentOS 8 and Oracle Linux 8|[Download](https://www.zabbix.com/download?zabbix=5.4&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql)| Packages are available with either MySQL/PostgreSQL database and Apache/Nginx webserver support. ::: noteimportant Zabbix 6.0 is not released yet. The download links lead to pre-5.4 packages. ::: ::: noteclassic *Verify CA* [encryption mode](/manual/appendix/install/db_encrypt/mysql) doesn't work on RHEL 7 with MySQL due to older MySQL libraries. ::: *Zabbix ​agent* packages and utilities *Zabbix get* and *Zabbix sender* are available for [RHEL 7](https://​repo.zabbix.com/​zabbix/​5.4/​rhel/​7/​x86_64/​), [RHEL 6](https://​repo.zabbix.com/​zabbix/​5.4/​rhel/​6/​x86_64/​) and [RHEL 5](https://​repo.zabbix.com/zabbix/​5.4/​rhel/​5/​x86_64) as well. Zabbix official repository provides fping and libssh2 packages as well. These packages are located in the [non-supported](https://repo.zabbix.com/non-supported/) directory. #### Overview of files If you obtained Java gateway from sources, you should have ended up with a collection of shell scripts, JAR and configuration files under $PREFIX/sbin/zabbix\_java. The role of these files is summarized below. bin/zabbix-java-gateway-$VERSION.jar Java gateway JAR file itself. lib/logback-core-1.5.16.jar lib/logback-classic-1.5.16.jar lib/slf4j-api-2.0.16.jar lib/android-json-4.3_r3.1.jar Dependencies of Java gateway: [Logback](http://logback.qos.ch/), [SLF4J](http://www.slf4j.org/), and [Android JSON](https://android.googlesource.com/platform/libcore/+/master/json) library. lib/logback.xml lib/logback-console.xml Configuration files for Logback. shutdown.sh startup.sh Convenience scripts for starting and stopping Java gateway. settings.sh Configuration file that is sourced by startup and shutdown scripts above. #### ファイルの概要 ソースからJavaゲートウェイを取得した場合、シェル スクリプト、JAR、および設定ファイルのコレクションが$PREFIX/sbin/zabbix\_javaの下にあるはずです。 これらのファイルの役割を以下にまとめます。 bin/zabbix-java-gateway-$VERSION.jar JavaゲートウェイJARファイル本体 lib/logback-core-1.5.16.jar lib/logback-classic-1.5.16.jar lib/slf4j-api-2.0.16.jar lib/android-json-4.3_r3.1.jar Javaゲートウェイの依存関係: [Logback](http://logback.qos.ch/)、[SLF4J](http://www.slf4j.org/)、および [Android JSON](https://android.googlesource .com/platform/libcore/+/master/json)ライブラリ。 lib/logback.xml lib/logback-console.xml Logbackの構成ファイル。 shutdown.sh startup.sh Javaゲートウェイを開始および停止するための便利なスクリプト。 settings.sh 上記の起動スクリプトとシャットダウンスクリプトによって提供される設定ファイル。 ### Overview Once the [services](/manual/it_services/services_tree) are created, you can start monitoring whether their performance is on track with service level agreement (SLA). *Services->SLA* menu section allows to configure SLAs for various services. An SLA in Zabbix defines service level objective (SLO), expected uptime schedule and planned downtimes. SLAs and services are matched by [service tags](/manual/it_services/services_tree#tags). The same SLA may be applied to multiple services - performance will be measured for each matching service separately. A single service may have multiple SLAs assigned - data for each of the SLAs will be displayed separately. In SLA reports Zabbix provides Service level indicator (SLI) data, which measures real service availability. Whether a service meets the SLA targets is determined by comparing SLO (expected availability in %) with SLI (real-life availability in %). ### 概要 [services](/manual/it_services/services_tree)が作成されると、サービスレベルアグリーメント（SLA）でパフォーマンスに問題がないかどうか監視できます。 *Services->SLA* メニューセクションでは、さまざまなサービスのSLAを構成できます。 ZabbixのSLAは、サービスレベル目標（SLO）、予想される稼働時間スケジュール、および計画されたダウンタイムを定義します。 SLAとサービスは[サービスタグ](/manual/it_services/services_tree#tags)によって照合されます。同じSLAを複数のサービスに適用できます。パフォーマンスは、一致するサービスごとに個別に測定されます。 1つのサービスに複数のSLAが割り当てられている場合があります。各SLAのデータは個別に表示されます。 SLAレポートでは、Zabbixは実際のサービスの可用性を測定するサービスレベルインジケーター（SLI）データを提供します。サービスがSLA目標を満たしているかどうかは、SLO（期待される可用性（％））とSLI（実際の可用性（％））を比較することによって決定されます。 ### Overview Packages for minor Zabbix version (i.e. Zabbix 6.0.x) release candidates are provided starting with Zabbix 6.0.9. The instructions below are for enabling unstable Zabbix release repositories (disabled by default). First, install or update to the latest zabbix-release package. To enable rc packages on your system do the following: ### 概要 Zabbixのマイナーバージョン (つまりZabbix 6.0.x) リリース候補のパッケージは、Zabbix 6.0.9以降で提供されています。 以下の手順は、不安定版Zabbixリリースリポジトリを有効にするためのものです (デフォルトでは無効)。 まず、最新のzabbix-releaseパッケージをインストールするか、更新します。システムでrcパッケージを有効にするには、次の手順を実行します。 #### Overview [Perl Compatible Regular Expressions](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE, PCRE2) are supported in Zabbix. There are two ways of using regular expressions in Zabbix: - manually entering a regular expression - using a global regular expression created in Zabbix #### 概要 [Perl互換の正規表現](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE、PCRE2)がZabbixでサポートされています。 Zabbixで正規表現を使用するには2つの方法があります。 - 正規表現を手動で入力する - Zabbixで作成したグローバルな正規表現を使用する。 #### Overview Plugins provide an option to extend the monitoring capabilities of Zabbix. Plugins are written in Go programming language and are supported by Zabbix agent 2 only. Plugins provide an alternative to [loadable modules](/manual/config/items/loadablemodules) (written in C), and other methods for extending Zabbix functionality, such as [user parameters](userparameters) (agent metrics), [external checks](/manual/config/items/itemtypes/external) (agent-less monitoring), and `system.run[]` Zabbix [agent item](/manual/config/items/itemtypes/zabbix_agent). The following features are specific to Zabbix agent 2 and its plugins: - support of scheduled and flexible intervals for both passive and active checks; - task queue management with respect to schedule and task concurrency; - plugin-level timeouts; - compatibility check of Zabbix agent 2 and its plugin on start up. Since Zabbix 6.0.0, plugins don't have to be integrated into the agent 2 directly and can be added as loadable plugins, thus making the creation process of additional plugins for gathering new monitoring metrics easier. This page lists Zabbix native and loadable plugins, and describes plugin configuration principles from the user perspective. For instructions about writing your own plugins, please see [Plugin development guidelines](https://www.zabbix.com/documentation/guidelines/en/plugins). #### 概要 プラグインは、Zabbix の監視機能を拡張するオプションを提供します。 プラグインは Go プログラミング言語で記述されており、Zabbix エージェント 2 のみでサポートされています。 Plugins provide an alternative to [loadable modules](/manual/config/items/loadablemodules) (written in C), and other methods for extending Zabbix functionality, such as [user parameters](userparameters) (agent metrics), [external checks](/manual/config/items/itemtypes/external) (agent-less monitoring), and `system.run[]` Zabbix [agent item](/manual/config/items/itemtypes/zabbix_agent). プラグインは[ロード可能モジュール](/manual/config/items/loadablemodules) (C言語で記述)に代わるもので、Zabbixの機能を拡張するその他の方法として、[ユーザーパラメータ](userparameters)（agent メトリクス）、[外部チェック](/manual/config/items/itemtypes/external)（エージェントレスモニタリング）や `system. run[]` Zabbix [エージェントアイテム](/manual/config/items/itemtypes/zabbix_agent) があります。 以下の機能は、Zabbix agent 2とそのプラグインに固有のものです: - パッシブ チェックとアクティブ チェックの両方について柔軟なスケジュール間隔のサポート - スケジュールとタスクの同時実行に関するタスク キュー管理 - プラグイン レベルのタイムアウト - 起動時の Zabbix エージェント 2 とそのプラグインの互換性チェック。 Zabbix 6.0.0以降、プラグインをエージェント2に直接統合する必要はなく、ロード可能なプラグインとして追加できるため、新しい監視メトリックを収集するための追加プラグインの作成プロセスが簡単になります. このページでは、Zabbix のネイティブでロード可能なプラグインを一覧表示し、ユーザーの観点からプラグイン構成の原則について説明します。 独自のプラグインを作成する手順については、[プラグイン開発ガイドライン](https://www.zabbix.com/documentation/guidelines/en/plugins)を参照してください。 #### Overview Plugins provide an option to extend the monitoring capabilities of Zabbix. Plugins are written in the Go programming language and are supported by Zabbix agent 2 only. Plugins provide an alternative to [loadable modules](/manual/config/items/loadablemodules) (written in C), and other methods for extending Zabbix functionality, such as [user parameters](userparameters) (agent metrics), [external checks](/manual/config/items/itemtypes/external) (agent-less monitoring), and `system.run[]` Zabbix [agent item](/manual/config/items/itemtypes/zabbix_agent). The following features are specific to agent 2 and its plugins: - support of scheduled and flexible intervals for both passive and active checks; - task queue management with respect to schedule and task concurrency; - plugin-level timeouts. #### Overview Plugins provide an option to extend the monitoring capabilities of Zabbix. Plugins are written in the Go programming language and are supported by Zabbix agent 2 only. Plugins provide an alternative to [loadable modules](/manual/config/items/loadablemodules) (written in C), and other methods for extending Zabbix functionality, such as [user parameters](userparameters) (agent metrics), [external checks](/manual/config/items/itemtypes/external) (agent-less monitoring), and `system.run[]` Zabbix [agent item](/manual/config/items/itemtypes/zabbix_agent). The following features are specific to agent 2 and its plugins: - support of scheduled and flexible intervals for both passive and active checks; - task queue management with respect to schedule and task concurrency; - plugin-level timeouts. #### Overview Preprocessing allows to define transformation rules for the received item values. One or several transformations are possible before saving to the database. Transformations are executed in the order in which they are defined. Preprocessing is done by Zabbix server or proxy (if items are monitored by proxy). Note that all values passed to preprocessing are of the string type, conversion to desired value type (as defined in item configuration) is performed at the end of the preprocessing pipeline; conversions, however, may also take place if required by the corresponding preprocessing step. See [preprocessing details](/manual/config/items/preprocessing/preprocessing_details) for more technical information. See also: [Usage examples](/manual/config/items/preprocessing/examples) #### 概要 保存前処理を行うことで、受け取った項目の値の変換ルールを定義することができます。 <br> データベースに保存する前に、1つまたは複数の変換を行うことができます。 変換は定義された順番に実行されます。 <br> 保存前処理はZabbixサーバまたはプロキシ(プロキシでアイテムを監視している場合)で実行されます。 保存前処理に渡される値はすべて文字列型であり、(アイテムの設定で定義された)目的の値の型への変換は、 <br> 保存前処理パイプラインの最後に実行されることに注意してください。 <br> ただし、変換は対応する保存前処理工程で必要とされる場合に行われることもあります。 <br> 詳細は[保存前処理の詳細](/manual/config/items/preprocessing/preprocessing_details)をご参照ください。 [使用例](/manual/config/items/preprocessing/examples)も併せてご参照ください。 #### Overview Problem events in Zabbix can be acknowledged by users. If a user gets notified about a problem event, they can go to Zabbix frontend, open the problem update popup window of that problem using one of the ways listed below and acknowledge the problem. When acknowledging, they can enter their comment for it, saying that they are working on it or whatever else they may feel like saying about it. This way, if another system user spots the same problem, they immediately see if it has been acknowledged and the comments so far. This way the workflow of resolving problems with more than one system user can take place in a coordinated way. Acknowledgment status is also used when defining [action operations](/manual/config/notifications/action/operation). You can define, for example, that a notification is sent to a higher level manager only if an event is not acknowledged for some time. To acknowledge events and comment on them, a user must have at least read permissions to the corresponding triggers. To change problem severity or close problem, a user must have read-write permissions to the corresponding triggers. There are **several** ways to access the problem update popup window, which allows acknowledging a problem. - You may select problems in *Monitoring* → *Problems* and then click on *Mass update* below the list - You can click in the *Ack* column showing the acknowledgment status of problems in: - *Monitoring → Dashboard* (*Problems* and *Problems by severity* widgets) - *Monitoring → Problems* - *Monitoring → Problems → Event details* The *Ack* column contains either a 'Yes' or a 'No' link, indicating an acknowledged or an unacknowledged problem respectively. Clicking on the links will take you to the problem update popup window. - You can click on an unresolved problem cell in: - *Monitoring → Dashboard* (*Trigger overview* widget) The popup menu contains an *Acknowledge* option that will take you to the problem update window. #### 概要 Zabbixの障害イベントはユーザーが確認することができます。 ユーザーは障害イベントの通知を受けると、Zabbixフロントエンドに移動し、以下のいずれかの方法で障害の更新ポップアップウィンドウを開き、障害を確認することができます。確認する際に、障害に対するコメント(対応中など)を入力することができます。 これにより、他のシステムユーザーが同じ問題を発見した場合、すぐに、それが確認済かどうかや、これまでのコメントを見ることができます。 このように、複数のシステムユーザーとの問題解決のワークフローを連携して行うことができます。 確認状況は、[アクション操作](/manual/config/notifications/action/operation)を定義する際にも使用されます。例えば、あるイベントがしばらく確認されなかった場合にのみ、上位のマネージャに通知を送信するように定義できます。 イベントを確認し、それについてコメントするには、ユーザーは対応するトリガーに対して最低限の読み取り権限を持っている必要があります。障害の深刻度を変更したり、障害をクローズしたりするには、ユーザーは対応するトリガーに対して読み取り/書き込みの権限を持っている必要があります。 障害を確認するための、障害更新ポップアップウィンドウにアクセスするには、**いくつかの**方法があります。 - *監視* → *障害* で障害を選択した状態で、リストの下の*一括更新* をクリックします。 - 障害の確認状況を示す *確認済* 列をクリックし、 - *監視 → ダッシュボード* (*障害* と *障害・深刻度* ウィジェット) - *監視 → 障害* - *監視 → 障害 → イベント詳細* *確認済*列には'はい'または'いいえ'のリンクがあり、それぞれ確認済かどうかを示しています。リンクをクリックすると、障害更新ポップアップウィンドウが表示されます。 - 以下の手順で未解決の問題のセルをクリックすることもできます。 - *監視 → ダッシュボード* (*トリガー概要* ウィジェット) ポップアップメニューには、*確認*オプションがあり、障害更新ウィンドウに移動します。 #### Overview Receiving notifications on unsupported items is supported since Zabbix 2.2. It is part of the concept of internal events in Zabbix, allowing users to be notified on these occasions. [Internal events](/manual/config/events/sources#internal-events) reflect a change of state: - when items go from 'normal' to 'unsupported' (and back) - when triggers go from 'normal' to 'unknown' (and back) - when low-level discovery rules go from 'normal' to 'unsupported' (and back) This section presents a how-to for **receiving notification** when an item turns unsupported. #### 概要 Zabbix 2.2以降、サポートされていないアイテムに関する通知の受信がサポートされています。 これは、Zabbix の内部イベントの概念の一部であり、受信時にユーザーに通知できるようにします。 [内部イベント](/manual/config/events/sources#internal-events) は状態の変化を反映します: - アイテムが'通常'から'サポート対象外'になったとき (および元に戻ったとき) - トリガーが'通常'から'不明'になったとき (および元に戻ったとき) - ローレベルディスカバリルールが'通常'から'サポート対象外' (およびその逆) になるとき このセクションでは、アイテムがサポート対象外になったときに **通知を受け取る**方法を示します。 #### Overview Receiving SNMP traps is the opposite to querying SNMP-enabled devices. In this case, the information is sent from an SNMP-enabled device and is collected or "trapped" by Zabbix. Usually, traps are sent upon some condition change and the agent connects to the server on port 162 (as opposed to port 161 on the agent side that is used for queries). Using traps may detect some short problems that occur amidst the query interval and may be missed by the query data. Receiving SNMP traps in Zabbix is designed to work with **snmptrapd** and one of the mechanisms for passing the traps to Zabbix - either a Bash or Perl script or SNMPTT. ::: noteclassic The simplest way to set up trap monitoring after configuring Zabbix is to use the Bash script solution, because Perl and SNMPTT are often missing in modern distributions and require more complex configuration. However, this solution uses a script configured as `traphandle`. For better performance on production systems, use the embedded Perl solution (either script with `do perl` option or SNMPTT). ::: The workflow of receiving a trap: 1. `snmptrapd` receives a trap 2. `snmptrapd` passes the trap to the receiver script (Bash, Perl) or SNMPTT 3. The receiver parses, formats and writes the trap to a file 4. Zabbix SNMP trapper reads and parses the trap file 5. For each trap Zabbix finds all "SNMP trapper" items with host interfaces matching the received trap address. Note that only the selected "IP" or "DNS" in host interface is used during the matching. 6. For each found item, the trap is compared to regexp in `snmptrap[regexp]`. The trap is set as the value of **all** matched items. If no matching item is found and there is an `snmptrap.fallback` item, the trap is set as the value of that. 7. If the trap was not set as the value of any item, Zabbix by default logs the unmatched trap. (This is configured by "Log unmatched SNMP traps" in Administration > General > Other.) #### 概要 SNMPトラップの受信は、SNMP対応デバイスへのクエリとは逆です。 この場合、情報はSNMP対応デバイスから送信され、Zabbixによって収集または"トラップ"されます。 通常、何らかの条件が変化するとトラップが送信され、エージェントはポート162でサーバーに接続します (クエリに使用されるエージェント側のポート161とは対照的です)。トラップを使用すると、クエリ間隔中に発生し、クエリ データによって見逃される可能性のあるいくつかの短い障害を検出できます。 ZabbixでのSNMPトラップの受信は、**snmptrapd**と、トラップをZabbixに渡すためのメカニズムの1つ (BashまたはPerlスクリプト、SNMPTT)で動作するように設計されています。 ::: noteclassic Zabbixの構成後にトラップ監視をセットアップする最も簡単な方法は、Bashスクリプトソリューションを使用することです。これは、最近のディストリビューションではPerlとSNMPTTが欠落していることが多く、より複雑な構成が必要になるためです。 ただし、このソリューションでは、`traphandle`として構成されたスクリプトが使用されます。 本番システムでのパフォーマンスを向上させるには、組み込みのPerlソリューション(`do perl`オプション付きのスクリプトまたはSNMPTT)を使用してください。 ::: トラップを受信するワークフロー: 1. `snmptrapd`がトラップを受信 2. `snmptrapd`はトラップをレシーバースクリプト(Bash、Perl)またはSNMPTTに渡す 3. 受信者はトラップを解析、フォーマットし、ファイルに書き込む 4. Zabbix SNMPトラッパーは、トラップファイルを読み取り、解析 5. Zabbixはトラップごとに、受信したトラップアドレスと一致するホストインターフェースを持つすべての"SNMPトラッパー"アイテムを検索します。 マッチングでは、ホスト インターフェースで選択した"IP"または"DNS"のみが使用されることに注意してください。 6. 見つかったアイテムごとに、トラップは`snmptrap[regexp]`の正規表現と比較されます。 トラップは一致した**すべて**のアイテムの値として設定されます。 一致するアイテムが見つからず、snmptrap.fallbackアイテムが存在する場合、トラップはその値として設定されます。 7. トラップがアイテムの値として設定されていない場合、Zabbixはデフォルトで一致しないトラップをログに記録します。 (これは、管理 > 一般設定 > その他の"マッチしないSNMPトラップをログに記録"で設定されます。) ### Overview Recovery operations allow you to be notified when problems are resolved. Both messages and remote commands are supported in recovery operations. While several operations can be added, escalation is not supported - all operations are assigned to a single step and therefore will be performed simultaneously. ### 概要 復旧操作により、障害が解決されたときに通知を受けることができます。 復旧操作では、メッセージとリモート コマンドの両方がサポートされています。 複数の操作を追加できますが、エスカレーションはサポートされていません。すべての操作が 1 つのステップに割り当てられるため、同時に実行されます。 #### Overview Sending a message is one of the best ways of notifying people about a problem. That is why it is one of the primary actions offered by Zabbix. #### 概要 メッセージの送信は、障害について人々に通知する最良の方法の 1 つです。 これが、Zabbix が提供する主要なアクションの 1 つである理由です。 #### Overview Server - proxy data exchange is based on JSON format. Request and response messages must begin with [header and data length](/manual/appendix/protocols/header_datalen). #### 概要 サーバー - プロキシ間のデータ交換はJSON形式に基づいています。 要求メッセージと応答メッセージは[ヘッダーとデータの長さ](/manual/appendix/protocols/header_datalen)に則って始まる必要があります。 #### Overview Service monitoring is a business-level monitoring that can be used to get an overview of the entire IT infrastructure service tree, identify weak places of the infrastructure, calculate SLA of various IT services, and check out other information at a higher level. Service monitoring focuses on the overall availability of a service instead of low-level details, such as the lack of disk space, high processor load, etc. Since Zabbix 6.0, service monitoring also provides functionality to find the root cause of a problem if a service is not performing as expected. Service monitoring allows to create a hierarchy representation of monitored data. A very simple service structure may look like: Service | |-Workstations | | | |-Workstation1 | | | |-Workstation2 | |-Servers Each node of the structure has attribute status. The status is calculated and propagated to upper levels according to the selected algorithm. The status of individual nodes is affected by the status of the mapped problems. Problem mapping is accomplished with [tagging](/manual/it_services/service_tree#problem-tags). Zabbix can send notifications or automatically execute a script on the Zabbix server in case service status change is detected. It is possible to define flexible rules whether a parent service should go into a 'Problem state' based on the statuses of child services. Services problem data can then be used to calculate SLA and send SLA reports based on the flexible set of conditions. Service monitoring is configured in the Services menu, which consists of the following sections: - [Services](/manual/it_services/service_tree) Services section allows to build a hierarchy of your monitored infrastructure by adding parent services, and then - child services to the parent services. In addition to configuring service tree, this section provides an overview of the whole infrastructure and allows to quickly identify the problems that led to a service status change. - [Service actions](/manual/it_services/service_actions) In this section you can configure service actions. Service actions are optional and allow to: - send a notification that a service is down; - execute a remote command on a Zabbix server upon a service status change; - send a recovery notification when a service is up again. - [SLA](/manual/it_services/sla) In this section you can define service level agreements and set service level objectives for specific services. - [SLA report](/manual/it_services/sla_report) In this section you can view SLA reports. **See also:** - SLA monitoring configuration [example](/manual/it_services/example) - Notes about [upgrading services](/manual/appendix/services_upgrade) from Zabbix versions below 6.0 #### 概要 サービス監視は、ITインフラストラクチャサービスのツリー全体の概要を取得し、インフラストラクチャの弱点を特定し、さまざまなITサービスのSLAを計算し、その他の情報をより高いレベルで確認するために使用できるビジネスレベルの監視です。サービスの監視は、ディスク容量の不足、プロセッサの高負荷などの低レベルの詳細ではなく、サービスの全体的な可用性に焦点を当てています。Zabbix 6.0以降、サービス監視は、サービスが期待どおりに実行されていない場合に問題の根本原因を見つける機能も提供します。 サービス監視により、監視対象データの階層表現を作成できます。 非常に単純なサービスの構造は次のようになります。 サービス | |-ワークステーション | | | |-ワークステーション1 | | | |-ワークステーション2 | |-サーバー 構造の各ノードには属性ステータスがあります。 ステータスは、選択したアルゴリズムに従って計算され、上位レベルに伝達されます。 個々のノードのステータスは、マップされた問題のステータスの影響を受けます。 問題のマッピングは、[タグ付け](/manual/it_services/service_tree#problem-tags)によって実現されます。 Zabbix は、サービス ステータスの変化が検出された場合に、通知を送信したり、Zabbix サーバーでスクリプトを自動的に実行したりできます。 子サービスのステータスに基づいて、親サービスが「障害状態」になるかどうかの柔軟なルールを定義することができます。 その後、サービスの問題データを使用してSLAを計算し、柔軟な一連の条件に基づいてSLAレポートを送信できます。 サービス監視は、次のセクションで説明されるサービスのメニューで設定されます： - [サービス](/manual/it_services/service_tree) サービスのセクションでは、親サービスを追加し、次に子サービスを親サービスに追加して、監視対象のインフラストラクチャの階層を構築できます。 このセクションでは、サービスツリーの構成に加えて、インフラストラクチャ全体の概要を提供し、サービスステータスの変更につながった問題をすばやく特定できます。 - [サービスのアクション](/manual/it_services/service_actions) このセクションでは、サービスのアクションを設定できます。 サービスのアクションはオプションであり、以下を行うことができます： - サービスがダウンしているという通知を送信します。 - サービス ステータスの変更時に Zabbix サーバーでリモート コマンドを実行します。 - サービスが再開したときに回復通知を送信します。 - [SLA](/manual/it_services/sla) このセクションでは、サービス レベル アグリーメントを定義し、特定のサービスのサービスレベル目標を設定できます。 - [SLAレポート](/manual/it_services/sla_report) このセクションでは、SLAレポートを表示できます。 **参考：** · - SLA監視設定 [サンプル](/manual/it_services/example) · - Zabbix 6.0以前のバージョンから[サービスをアップグレード](/manual/appendix/services_upgrade)する際の注意事項 #### Overview Several configuration [parameters](/manual/appendix/config/zabbix_server) define how Zabbix server should behave when an agent check (Zabbix, SNMP, IPMI, JMX) fails and a host interface becomes unreachable. #### 概要 いくつかの設定[パラメータ](/manual/appendix/config/zabbix_server)は、エージェントチェック（Zabbix、SNMP、IPMI、JMX）が失敗し、ホストインターフェイスに到達できなくなった場合のZabbixサーバーの動作を定義します。 #### Overview Simple checks are normally used for remote agent-less checks of services. Note that Zabbix agent is not needed for simple checks. Zabbix server/proxy is responsible for the processing of simple checks (making external connections, etc). Examples of using simple checks: net.tcp.service[ftp,,155] net.tcp.service[http] net.tcp.service.perf[http,,8080] net.udp.service.perf[ntp] ::: noteclassic *User name* and *Password* fields in simple check item configuration are used for VMware monitoring items; ignored otherwise. ::: #### 概要 シンプルチェックは、通常、リモートエージェントを使用しないサービスをチェックするために使用します。 なお、シンプルチェックではZabbix agent は必要ありません。<br> Zabbix server / proxy はシンプルチェックの処理(外部接続の確立など)を担当します。 シンプルチェックの利用例 net.tcp.service[ftp,,155] net.tcp.service[http] net.tcp.service.perf[http,,8080] net.udp.service.perf[ntp] ::: noteclassic シンプルチェック項目の*ユーザー名*および* パスワード*フィールドはVMwareの監視項目に使用され、それ以外は無視されます。 ::: #### Overview Simple graphs are provided for the visualization of data gathered by items. No configuration effort is required on the user part to view simple graphs. They are freely made available by Zabbix. Just go to *Monitoring → Latest data* and click on the Graph link for the respective item and a graph will be displayed. {width="600"} ::: noteclassic Simple graphs are provided for all numeric items. For textual items, a link to History is available in *Monitoring → Latest data*. ::: #### 概要 item で収集したデータを視覚化するためのシンプルなグラフを提供します。 シンプルグラフを表示するために、ユーザ側で設定する必要はありません。Zabbixはシンプルグラフを自由に利用する<br> ことができます。 *Monitoring → Latest data* から各 item のグラフリンクをクリックするだけで、グラフが表示されます。 {width="600"} ::: noteclassic 数値項目については、シンプルなグラフが用意されています。 文字項目については、*Monitoring → Latest data* に履歴へのリンクが用意されています。 ::: #### Overview Some new items are automatically added for monitoring when web scenarios are created. All items inherit tags from the web scenario. #### 概要 Webシナリオが作成されると、モニタリング用にいくつかの新しいアイテムが自動的に追加されます。 すべてのアイテムは、Webシナリオからタグを継承します #### Overview Sometimes there are signs of the upcoming problem. These signs can be spotted so that actions may be taken in advance to prevent or at least minimize the impact of the problem. Zabbix has tools to predict the future behavior of the monitored system based on historic data. These tools are realized through predictive trigger functions. #### 概要 時には、問題が発生する予兆があることがあります。これらの兆候を発見することで、事前に対策を講じ、問題の影響を防ぐ、<br> または少なくとも最小限に抑えることができます。 Zabbix は history データに基づいて監視システムの将来の挙動を予測するツールを備えています。<br> これらのツールは予兆トリガー機能で実現されます。 #### Overview Sometimes you may want to change some attribute for a number of hosts at once. Instead of opening each individual host for editing, you may use the mass update function for that. #### 概要 一度に複数のホストの属性を変更したい場合があります。個々のホストを開いて編集する代わりに一括更新機能を使います。 #### Overview Sometimes you may want to change some attribute for a number of items at once. Instead of opening each individual item for editing, you may use the mass update function for that. #### 概要 一度に複数のアイテムの属性を変更したい場合があります。個々のアイテムを開いて編集する代わりに一括更新機能を使います。 #### Overview Sometimes you may want to change some attribute for a number of templates at once. Instead of opening each individual template for editing, you may use the mass update function for that. #### 概要 いくつかのテンプレートの属性を一度に変更したい場合があります。 個々のテンプレートを開いて編集する代わりに、一括更新機能を使用できます。 #### Overview Sound is used in [global notifications](/manual/web_interface/user_profile/global_notifications). For the sounds to be played in Zabbix frontend, *Frontend messaging* must be enabled in the user profile *Messaging* tab, with all trigger severities checked, and sounds should also be enabled in the global notification pop-up window. If for some reasons audio cannot be played on the device, the  button in the global notification pop-up window will permanently remain in the "mute" state and the message "Cannot support notification audio for this device." will be displayed upon hovering over the  button. Sounds, including the default audio clips, are supported in MP3 format only. The sounds of Zabbix frontend have been successfully tested in recent Firefox/Opera browsers on Linux and in Chrome, Firefox, Microsoft Edge, and Opera browsers on Windows. ::: noteimportant The auto play of sounds may be disabled in recent browser versions by default. In this case, you need to change this setting manually. ::: #### 概要 [グローバル通知](/manual/web_interface/user_profile/global_notifications)でサウンドが使用されます。 Zabbix Webインタフェースでサウンドを再生するには、ユーザープロファイルの*アラート表示*タブで*Webインターフェースのアラート表示*を有効にし、すべてのトリガーの深刻度をチェックし、グローバル通知ポップアップウィンドウでもサウンドを有効にする必要があります。 何らかの理由でデバイスでオーディオを再生できない場合、グローバル通知ポップアップウィンドウのボタンは永続的に"ミュート"状態のままになり、 ボタンにカーソルを合わせると、"このデバイスでは音声通知をサポートしません。"というメッセージが表示されます。 デフォルトのオーディオクリップを含むサウンドは、MP3形式でのみサポートされています。 Zabbix Webインタフェースのサウンドは、LinuxおよびChromeの最新Firefox/Opera、WindowsのFirefox、Microsoft Edge、Opera、Safariブラウザーで正常にテストされています。 ::: noteimportant 最近のブラウザバージョンでは、サウンドの自動再生がデフォルトで無効になっている場合があります。この場合、この設定を手動で変更する必要があります。 ::: #### Overview SSH checks are performed as agent-less monitoring. Zabbix agent is not needed for SSH checks. To perform SSH checks Zabbix server must be initially [configured](/manual/installation/install#from_the_sources) with SSH2 support (libssh2 or libssh). See also: [Requirements](/manual/installation/requirements#server). ::: noteimportant Only libssh is supported starting with RHEL 8. ::: #### 概要 SSHチェックはエージェントレスで実行できます。SSHチェックを行うためにはZabbixエージェントは必要ありません。 SSHチェックを実行するには、Zabbixサーバーを構築時の最初に[configure](/manual/installation/install#from_the_sources)する際にSSH2(libssh2またはlibsshで)をサポートするようにする必要があります。以下、参照： [必要な要件](/manual/installation/requirements#server). ::: noteimportant RHEL 8以降では、libsshだけがサポートされています。 ::: ### Overview Starting from version 5.0, Zabbix frontend requires PHP version 7.2 or later. Unfortunately, older versions of Debian & Ubuntu provide only PHP versions below 7.2. ### 概要 バージョン5.0以降、Zabbix WebインターフェースにはPHPバージョン7.2以降が必要です。 残念ながら、古いバージョンのDebianとUbuntuでは、7.2より前のPHPバージョンのみが提供されます。 #### Overview Support of monitoring VMware environments is available in Zabbix starting with version 2.2.0. Zabbix can use low-level discovery rules to automatically discover VMware hypervisors and virtual machines and create hosts to monitor them, based on pre-defined host prototypes. The default dataset in Zabbix offers several ready-to-use templates for monitoring VMware vCenter or ESX hypervisor. The minimum required VMware vCenter or vSphere version is 5.1. #### 概要 Zabbixでは、バージョン2.2.0からVMware環境の監視に対応しています。 Zabbixは事前に定義されたホストプロトタイプに基づき、ローレベルディスカバリルールを使用して、 <br> VMwareハイパーバイザーと仮想マシンを自動的に検出し、監視するためのホストを作成することができます。 <br> Zabbixのデフォルトデータセットには、VMware vCenterやESXハイパーバイザーの監視に適した <br> テンプレートが用意されています。 <br> VMware vCenterまたはvSphereの最低必要バージョンは5.1です。 <br> #### Overview Telnet checks are performed as agent-less monitoring. Zabbix agent is not needed for Telnet checks. #### 概要 Telnetチェックはエージェントレス監視として実行されます。Zabbixエージェントは必要ありません。 #### Overview Templates are [exported](/manual/xml_export_import) with many related objects and object relations. Template export contains: - linked host groups - template data - linkage to other templates - linkage to host groups - directly linked items - directly linked triggers - directly linked graphs - directly linked dashboards - directly linked discovery rules with all prototypes - directly linked web scenarios - value maps #### 概要 テンプレートは、多くの関連するオブジェクトと一緒に[エクスポート](/manual/xml_export_import)されます。 テンプレートのエクスポートには以下の要素が含まれます: - リンクされたホストグループ - テンプレートデータ - 他のテンプレートとのリンク - ホストグループへのリンク - 直接リンクされたアイテム - 直接リンクされたトリガー - 直接リンクされたグラフ - 直接リンクされたダッシュボード - すべてのプロトタイプと直接リンクされたディスカバリルール - 直接リンクされたWebシナリオ - バリューマップ ### Overview The *Administration → Authentication* section allows to specify the global user authentication method to Zabbix and internal password requirements. The available methods are internal, HTTP, LDAP, and SAML authentication. ### 概要 *管理 → 認証*セクションでは、Zabbixおよび内部パスワード要件に対するグローバルユーザー認証方法を指定できます。使用可能な方法は、内部,HTTP,LDAPおよびSAML認証です。 #### Overview The *Administration → General* section contains a number of subsections for setting frontend-related defaults and customizing Zabbix. The list of available subsections appears upon pressing on *General* in the *Administration* menu section. It is also possible to switch between subsections by using the title dropdown in the top left corner. #### 概要 *管理 → 一般設定*セクションには、フロントエンド関連のデフォルト設定とZabbixをカスタマイズするためのいくつかのサブセクションが含まれています。 使用可能なサブセクションのリストは、*管理*メニューセクションの*一般設定*を押すと表示されます。 左上隅のタイトルドロップダウンを使用して、サブセクションを切り替えることもできます。 #### Overview The Administration menu is for administrative functions of Zabbix. This menu is available to users of [Super Administrators](/manual/config/users_and_usergroups/permissions) type only. #### 概要 管理メニューはZabbixの管理機能用です。このメニューは[Super Administrators](/manual/config/users_and_usergroups/permissions)タイプのユーザーのみが使用できます。 #### Overview The aggregation functions, available in the graph widget of the dashboard, allow displaying an aggregated value for the chosen interval (5 minutes, an hour, a day), instead of all values. The aggregation options are as follows: - min - max - avg - count - sum - first (first value displayed) - last (last value displayed) The most exciting use of data aggregation is the possibility to create nice side-by-side comparisons of data for some period: {width="600"} When hovering over a point in time in the graph, date and time is displayed, in addition to items and their aggregated values. Items are displayed in parentheses, prefixed by the aggregation function used. Note that this is the date and time of the point in the graph, not of the actual values. #### 概要 ダッシュボードのグラフウィジェットで利用できる集計機能では、すべての値ではなく、選択した間隔（5分、1時間、1日）の<br> 集計値を表示することができます。 集計オプションは以下のとおりです: - min - max - avg - count - sum - first (first value displayed) - last (last value displayed) データ集計の最もエキサイティングな使い方は、ある期間のデータを並べてきれいに比較することができることです: {width="600"} グラフのある時点にカーソルを合わせると、item とその集計値に加え、日付と時刻が表示されます。項目は括弧内に<br> 表示され、その前に使用した集計関数が表示されます。これはグラフ内のポイントの日時であり、実際の値ではないことに<br> 注意してください。<br> #### Overview The Configuration menu contains sections for setting up major Zabbix functions, such as hosts and host groups, data gathering, data thresholds, sending problem notifications, creating data visualization and others. #### 概要 設定メニューには、ホストとホストグループ、データ収集、データしきい値、問題通知の送信、データの視覚化の作成など、Zabbixの主要な機能を設定するためのセクションが含まれています。 #### Overview The custom graph list for a host can be accessed from *Configuration → Hosts* by clicking on *Graphs* for the respective host. A list of existing graphs is displayed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the custom graph, displayed as a blue link to graph details.<br>Clicking on the graph name link opens the graph [configuration form](/manual/config/visualization/graphs/custom#configuring_custom_graphs).<br>If the host graph belongs to a template, the template name is displayed before the graph name, as a gray link. Clicking on the template link will open the graph list on the template level.<br>If the graph has been created from a graph prototype, its name is preceded by the low-level discovery rule name, in orange. Clicking on the discovery rule name will open the graph prototype list.| |*Width*|Graph width is displayed.| |*Height*|Graph height is displayed.| |*Graph type*|Graph type is displayed - *Normal*, *Stacked*, *Pie* or *Exploded*.| |*Info*|If the graph is working correctly, no icon is displayed in this column. In case of errors, a square icon with the letter "i" is displayed. Hover over the icon to see a tooltip with the error description.| To configure a new graph, click on the *Create graph* button at the top right corner. #### 概要 ホストのカスタムグラフリストには、*設定 → ホスト*からホストの*グラフ*をクリックしてアクセスできます。 既存のグラフリストが表示されます。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|カスタムグラフの名前。グラフ詳細へのリンクとして表示されます。<br>グラフ名のリンクをクリックすると、グラフ[設定フォーム](/manual/config/visualization/graphs/custom#configuring_custom_graphs)が開きます。<br>ホストグラフはテンプレートに属しており、テンプレート名はグラフ名の前に灰色のリンクとして表示されます。 テンプレートリンクをクリックすると、テンプレートレベルでグラフリストが開きます。<br>グラフがプロトタイプグラフから作成されている場合、その名前の前に、オレンジ色の低レベルのディスカバリルール名が付きます。 ディスカバリルール名をクリックすると、プロトタイプグラフのリストが開きます。| |*幅*|グラフの表示幅| |*高さ*|グラフの表示高さ| |*グラフのタイプ*|グラフの種類が表示されます - *ノーマル*,* 積算グラフ*,* 円グラフ*または*分解円グラフ*| |*情報*|グラフが正しく機能している場合、この列にはアイコンは表示されません。 エラーが発生した場合は、「i」の文字が付いた正方形のアイコンが表示されます。 アイコンにカーソルを合わせると、エラーの説明が記載されたツールチップが表示されます。| 新しいグラフを設定するには、右上隅にある*グラフの作成*ボタンをクリックします。 #### Overview The custom graph list for a template can be accessed from *Configuration → Templates* by clicking on *Graphs* for the respective template. A list of existing graphs is displayed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Template*|Template the graph belongs to.<br>This column is displayed only if multiple templates are selected in the filter.| |*Name*|Name of the custom graph, displayed as a blue link to graph details.<br>Clicking on the graph name link opens the graph [configuration form](/manual/config/visualization/graphs/custom#configuring_custom_graphs).<br>If the graph is inherited from another template, the template name is displayed before the graph name, as a gray link. Clicking on the template link will open the graph list on that template level.| |*Width*|Graph width is displayed.| |*Height*|Graph height is displayed.| |*Graph type*|Graph type is displayed - *Normal*, *Stacked*, *Pie* or *Exploded*.| To configure a new graph, click on the *Create graph* button at the top right corner. #### 概要 テンプレートのカスタムグラフリストには、*設定 → テンプレート*からテンプレートの*グラフ*をクリックしてアクセスできます。 既存のグラフのリストが表示されます。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*テンプレート*|グラフが属するテンプレート。<br>この列は、フィルターで複数のテンプレートが選択されている場合にのみ表示されます。| |*名前*|カスタムグラフの名前。グラフの詳細へのリンクとして表示されます。<br>グラフ名をクリックすると、グラフ[設定フォーム](/manual/config/visualization/graphs/custom#configuring_custom_graphs)が開きます。<br> グラフは別のテンプレートから継承され、テンプレート名はグラフ名の前に灰色のリンクとして表示されます。 テンプレートリンクをクリックすると、そのテンプレートレベルのグラフリストが開きます。| |*幅*|グラフの表示幅| |*高さ*|グラフの表示高さ| |*グラフのタイプ*|グラフの種類が表示されます - *ノーマル*,* 積算グラフ*,* 円グラフ*または*分解円グラフ*| 新しいグラフを設定するには、右上隅にある*グラフの作成*ボタンをクリックします。 #### Overview The frontend time zone can be set globally in the frontend and adjusted for individual users.  If *System* is selected, the web server time zone will be used for the frontend (including the value of 'date.timezone' of php.ini, if set), while Zabbix server will use the time zone of the machine it is running on. ::: noteclassic Zabbix server will only use the specified global/user time zone when expanding macros in notifications (e.g. {EVENT.TIME} can expand to a different time zone per user) and for the time limit when notifications are sent (see "When active" setting in user [media configuration](/manual/config/notifications/media#user_media)). ::: #### 概要 Webインタフェースのタイムゾーンは*管理 → 一般設定*の'表示設定'でグローバルに設定でき、*管理 → ユーザー*で個々のユーザーに合わせて調整できます。  *System*を選択した場合、Webインタフェースでは(php.iniの'date.timezone'の値が設定されている場合を含む)Webサーバーのタイムゾーンが使用され、Zabbix サーバーは実行されているOSのタイムゾーンを使用します。 ::: noteclassic Zabbixサーバーは、通知でマクロを展開するとき(例: {EVENT.TIME}はユーザー毎に異なるタイムゾーンに展開できます)、および通知が送信される時間制限にのみ指定されたグローバル/ユーザータイムゾーンを使用します。(ユーザーの [メディアタイプ](/manual/config/notifications/media#ユーザーメディア)の"有効な時間帯"を参照) ::: #### Overview The graph widget provides a modern and versatile way of visualizing data collected by Zabbix using a vector image drawing technique. This graph widget is supported since Zabbix 4.0. Note that the graph widget supported before Zabbix 4.0 can still be used as [Graph (classic)](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#graph_classic). #### 概要 グラフウィジェットは、ベクター画像描画技術を使用してZabbixによって収集されたデータを視覚化するための多目的な方法を提供します。 このグラフウィジェットはZabbix4.0以降でサポートされています。 Zabbix 4.0より前にサポートされていたグラフウィジェットは、引き続き[グラフ（クラシック）](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#graph_classic)として使用できます。 #### Overview The header is present in all request and response messages between Zabbix components. It is required to determine the message length, if it is compressed or not, if it is a large packet or not. Zabbix communications protocol has 1GB packet size limit per connection. The limit of 1GB is applied to both the received packet data length and the uncompressed data length. When sending configuration to Zabbix proxy, the packet size limit is increased to 4GB to allow syncing large configurations. When data length before compression exceeds 4GB, Zabbix server automatically starts using the large packet format (0x04 flag) which increases the packet size limit to 16GB. Note that while a large packet format can be used for sending any data, currently only the Zabbix proxy configuration syncer can handle packets that are larger than 1GB. #### 概要 ヘッダーは、Zabbix コンポーネント間のすべての要求および応答メッセージに存在します。 ヘッダーの情報からメッセージの長さ、圧縮されているかどうか、大きなパケットであるかどうかを判断できます。 Zabbix 通信プロトコルには、接続ごとに 1GB のパケット サイズ制限があります。 受信パケットのデータ長、圧縮前のデータ長ともに1GBの制限が適用されます。 構成を Zabbix プロキシに送信する場合、大きな構成を同期できるように、パケット サイズの制限が 4 GB に増加します。 圧縮前のデータ長が 4GB を超えると、Zabbix サーバーは自動的に大きなパケット形式 (0x04 フラグ) を使用して起動し、パケット サイズの制限を 16GB に増やします。 任意のデータの送信に大きなパケット形式を使用できますが、現在、1GB を超えるパケットを処理できるのは Zabbix プロキシ構成シンカーのみであることに注意してください。 #### Overview The initial Zabbix installation has two predefined users: - *Admin* - a Zabbix [superuser](/manual/config/users_and_usergroups/permissions#user_role) with full permissions; - *guest* - a special Zabbix [user](/manual/config/users_and_usergroups/permissions#user_role). The 'guest' user is disabled by default. If you add it to the Guests user group, you may log in with this user and access monitoring pages in Zabbix. (Note that, before Zabbix 6.0.28, automatic guest login was possible.) By default, 'guest' has no permissions on Zabbix objects. To configure a new user: - Go to *Administration → Users* - Click on *Create user* (or on the user name to edit an existing user) - Edit user attributes in the form #### 概要 Zabbixの初期インストールでは、以下の2つのユーザが事前に設定されています: - *Admin* - 完全なパーミッションを持つZabbix [特権管理者](/manual/config/users_and_usergroups/permissions#ユーザーロール)です。 - guest* - 特別なZabbix [ユーザー](/manual/config/users_and_usergroups/permissions#ユーザーロール)です。'guest'ユーザーはデフォルトでは無効になっています。<br> Guestsユーザグループに追加すると、ログインしていなくてもZabbixの監視ページにアクセスすることができます。(Zabbix 6.0.28 より前は、自動ゲスト ログインが可能でした。)<br> デフォルトでは、guestはZabbixオブジェクトに対するパーミッションを持っていないことに注意してください。 新しいユーザーを設定するには: - *管理 → ユーザー*に行きます。 - *ユーザーの作成*をクリックします。(または、既に登録されているユーザの名前をクリックします。) - フォームのユーザー属性を編集します。 #### Overview The Inventory menu features sections providing an overview of host inventory data by a chosen parameter as well as the ability to view host inventory details. #### 概要 インベントリメニューには、選択したパラメータごとのホストインベントリデータの概要と、ホストインベントリの詳細を表示するセクションがあります。 #### Overview The *Inventory → Overview* section provides ways of having an overview of [host inventory](/manual/config/hosts/inventory) data. For an overview to be displayed, choose host groups (or none) and the inventory field by which to display data. The number of hosts corresponding to each entry of the chosen field will be displayed. {width="600"} The completeness of an overview depends on how much inventory information is maintained with the hosts. Numbers in the *Host count* column are links; they lead to these hosts being filtered out in the *Host Inventories* table. {width="600"} #### 概要 *インベントリ → 概要*セクションでは[ホストインベントリ](/manual/config/hosts/inventory)データの概要を確認する方法を提供します。 表示する概要については、ホストグループ（またはなし）とデータを表示するインベントリフィールドを選択します。 選択したフィールドの各エントリに対応するホストの数が表示されます。 {width="600"} 概要の完全性は、ホストで維持されるインベントリ情報の量によって異なります。 *ホスト数*列の数字はリンクです。 これらのホストは*Host Inventory*テーブルで除外されます。 {width="600"} #### Overview The item list for a host can be accessed from *Configuration → Hosts* by clicking on *Items* for the respective host. A list of existing items is displayed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Wizard*|The wizard icon is a link to a wizard for creating a trigger based on the item.| |*Host*|Host of the item.<br>This column is displayed only if multiple hosts are selected in the filter.| |*Name*|Name of the item displayed as a blue link to item details.<br>Clicking on the item name link opens the item [configuration form](/manual/config/items/item#configuration).<br>If the host item belongs to a template, the template name is displayed before the item name as a gray link. Clicking on the template link will open the item list on the template level.<br>If the item has been created from an item prototype, its name is preceded by the low-level discovery rule name, in orange. Clicking on the discovery rule name will open the item prototype list.| |*Triggers*|Moving the mouse over Triggers will display an infobox displaying the triggers associated with the item.<br>The number of the triggers is displayed in gray.| |*Key*|Item key is displayed.| |*Interval*|Frequency of the check is displayed.<br>*Note* that passive items can also be checked immediately by pushing the *Check now* [button](#mass_editing_options).| |*History*|How many days item data history will be kept is displayed.| |*Trends*|How many days item trends history will be kept is displayed.| |*Type*|Item type is displayed (Zabbix agent, SNMP agent, simple check, etc).| |*Status*|Item status is displayed - *Enabled*, *Disabled* or *Not supported*. You can change the status by clicking on it - from Enabled to Disabled (and back); from Not supported to Disabled (and back).| |*Tags*|Item tags are displayed.<br>Up to three tags (name:value pairs) can be displayed. If there are more tags, a "..." link is displayed that allows to see all tags on mouseover.| |*Info*|If the item is working correctly, no icon is displayed in this column. In case of errors, a square icon with the letter "i" is displayed. Hover over the icon to see a tooltip with the error description.| To configure a new item, click on the *Create item* button at the top right corner. #### Overview The item list for a host can be accessed from *Configuration → Hosts* by clicking on *Items* for the respective host. A list of existing items is displayed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Wizard*|The wizard icon is a link to a wizard for creating a trigger based on the item.| |*Host*|Host of the item.<br>This column is displayed only if multiple hosts are selected in the filter.| |*Name*|Name of the item displayed as a blue link to item details.<br>Clicking on the item name link opens the item [configuration form](/manual/config/items/item#configuration).<br>If the host item belongs to a template, the template name is displayed before the item name as a gray link. Clicking on the template link will open the item list on the template level.<br>If the item has been created from an item prototype, its name is preceded by the low-level discovery rule name, in orange. Clicking on the discovery rule name will open the item prototype list.| |*Triggers*|Moving the mouse over Triggers will display an infobox displaying the triggers associated with the item.<br>The number of the triggers is displayed in gray.| |*Key*|Item key is displayed.| |*Interval*|Frequency of the check is displayed.<br>*Note* that passive items can also be checked immediately by pushing the *Check now* [button](#mass_editing_options).| |*History*|How many days item data history will be kept is displayed.| |*Trends*|How many days item trends history will be kept is displayed.| |*Type*|Item type is displayed (Zabbix agent, SNMP agent, simple check, etc).| |*Status*|Item status is displayed - *Enabled*, *Disabled* or *Not supported*. You can change the status by clicking on it - from Enabled to Disabled (and back); from Not supported to Disabled (and back).| |*Tags*|Item tags are displayed.<br>Up to three tags (name:value pairs) can be displayed. If there are more tags, a "..." link is displayed that allows to see all tags on mouseover.| |*Info*|If the item is working correctly, no icon is displayed in this column. In case of errors, a square icon with the letter "i" is displayed. Hover over the icon to see a tooltip with the error description.| To configure a new item, click on the *Create item* button at the top right corner. #### Overview The item list for a template can be accessed from *Configuration → Templates* by clicking on *Items* for the respective template. A list of existing items is displayed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Wizard*|The wizard icon is a link to a wizard for creating a trigger based on the item.| |*Template*|Template the item belongs to.<br>This column is displayed only if multiple templates are selected in the filter.| |*Name*|Name of the item displayed as a blue link to item details.<br>Clicking on the item name link opens the item [configuration form](/manual/config/items/item#configuration).<br>If the item is inherited from another template, the template name is displayed before the item name, as a gray link. Clicking on the template link will open the item list on that template level.| |*Triggers*|Moving the mouse over Triggers will display an infobox displaying the triggers associated with the item.<br>The number of the triggers is displayed in gray.| |*Key*|Item key is displayed.| |*Interval*|Frequency of the check is displayed.| |*History*|How many days item data history will be kept is displayed.| |*Trends*|How many days item trends history will be kept is displayed.| |*Type*|Item type is displayed (Zabbix agent, SNMP agent, simple check, etc).| |*Status*|Item status is displayed - *Enabled* or *Disabled*. By clicking on the status you can change it - from Enabled to Disabled (and back).| |*Tags*|Item tags are displayed.<br>Up to three tags (name:value pairs) can be displayed. If there are more tags, a "..." link is displayed that allows to see all tags on mouseover.| To configure a new item, click on the *Create item* button at the top right corner. #### Overview The item list for a template can be accessed from *Configuration → Templates* by clicking on *Items* for the respective template. A list of existing items is displayed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Wizard*|The wizard icon is a link to a wizard for creating a trigger based on the item.| |*Template*|Template the item belongs to.<br>This column is displayed only if multiple templates are selected in the filter.| |*Name*|Name of the item displayed as a blue link to item details.<br>Clicking on the item name link opens the item [configuration form](/manual/config/items/item#configuration).<br>If the item is inherited from another template, the template name is displayed before the item name, as a gray link. Clicking on the template link will open the item list on that template level.| |*Triggers*|Moving the mouse over Triggers will display an infobox displaying the triggers associated with the item.<br>The number of the triggers is displayed in gray.| |*Key*|Item key is displayed.| |*Interval*|Frequency of the check is displayed.| |*History*|How many days item data history will be kept is displayed.| |*Trends*|How many days item trends history will be kept is displayed.| |*Type*|Item type is displayed (Zabbix agent, SNMP agent, simple check, etc).| |*Status*|Item status is displayed - *Enabled* or *Disabled*. By clicking on the status you can change it - from Enabled to Disabled (and back).| |*Tags*|Item tags are displayed.<br>Up to three tags (name:value pairs) can be displayed. If there are more tags, a "..." link is displayed that allows to see all tags on mouseover.| To configure a new item, click on the *Create item* button at the top right corner. #### Overview The **memtype** parameter is supported on Linux, AIX, FreeBSD, and Solaris platforms. Three common values of 'memtype' are supported on all of these platforms: `pmem`, `rss` and `vsize`. Additionally, platform-specific 'memtype' values are supported on some platforms. #### 概要 **memtype**パラメーターは、Linux,AIX,FreeBSD,およびSolarisでサポートされています。 'memtype'の3つの一般的な値である`pmem`、`rss`、`vsize`は、これらすべてのプラットフォームでサポートされています。 さらに一部のプラットフォームでは固有の'memtype'値がサポートされています。 #### Overview The *Monitoring → Hosts* section displays a full list of monitored hosts with detailed information about host interface, availability, tags, current problems, status (enabled/disabled), and links to easily navigate to the host's latest data, problem history, graphs, dashboards and web scenarios. {width="600"} |Column|Description| |------|-----------| |*Name*|The visible host name. Clicking on the name brings up the [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu).<br>An orange wrench icon  after the name indicates that this host is in maintenance.<br>Click on the column header to sort hosts by name in ascending or descending order.| |*Interface*|The main interface of the host is displayed.| |*Availability*|Host [availability](/manual/web_interface/frontend_sections/configuration/hosts#reading_host_availability) per configured interface.<br>Icons represent only those interface types (Zabbix agent, SNMP, IPMI, JMX) that are configured. If you position the mouse on the icon, a popup list of all interfaces of this type appears with each interface details, status and errors.<br>The column is empty for hosts with no interfaces.<br>The current status of all interfaces of one type is displayed by the respective icon color:<br>**Green** - all interfaces available<br>**Yellow** - at least one interface available and at least one unavailable; others can have any value including 'unknown'<br>**Red** - no interfaces available<br>**Gray** - at least one interface unknown (none unavailable)<br>Note that active Zabbix agent items do not affect host availability.| |*Tags*|[Tags](/manual/config/tagging) of the host and all linked templates, with macros unresolved.| |*Status*|Host status - *Enabled* or *Disabled*.<br>Click on the column header to sort hosts by status in ascending or descending order.| |*Latest data*|Clicking on the link will open the *Monitoring - Latest data* page with all the latest data collected from the host.<br> The number of items with latest data is displayed in gray (displayed since Zabbix 6.0.5).| |*Problems*| The number of open host problems sorted by severity. The color of the square indicates problem severity. The number on the square means the number of problems for the given severity.<br>Clicking on the icon will open *Monitoring - Problems* page for the current host. <br>If a host has no problems, a link to the Problems section for this host is displayed as text. <br>Use the filter to select whether suppressed problems should be included (not included by default).| |*Graphs*|Clicking on the link will display graphs configured for the host. The number of graphs is displayed in gray.<br>If a host has no graphs, the link is disabled (gray text) and no number is displayed.| |*Dashboards*|Clicking on the link will display dashboards configured for the host. The number of dashboards is displayed in gray.<br>If a host has no dashboards, the link is disabled (gray text) and no number is displayed.| |*Web*|Clicking on the link will display web scenarios configured for the host. The number of web scenarios is displayed in gray.<br>If a host has no web scenarios, the link is disabled (gray text) and no number is displayed.| #### 概要 *監視データ→ホスト*セクションには、監視対象ホストの完全なリストが表示され、ホストインターフェイス、エージェントの状態、タグ、現在の問題、ステータス（有効/無効）の詳細情報およびホストの最新データ、障害、履歴、グラフ、ダッシュボードおよびWebシナリオに簡単に移動するためのリンクが表示されます 、 {width="600"} |列|詳細| |------|-----------| |*名前*|表示されるホスト名。 名前をクリックすると、[ホストメニュー](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu)が表示されます。<br>名前の後にオレンジ色のレンチアイコンが表示されている場合は、このホストがメンテナンス中であることを示します。<br>列ヘッダーをクリックして、ホストを名前の昇順または降順で並べ替えます| |*インターフェース*|ホストのメインインターフェイスが表示されます| |*エージェントの状態*|構成されたインターフェースごとのホストの[状態](/manual/web_interface/frontend_sections/configuration/hosts#reading_host_availability)<br>アイコンは、構成されたインターフェースタイプ（Zabbixエージェント、SNMP、IPMI、JMX）のみを表します。 アイコンにマウスオーバーすると、このタイプのすべてのインターフェースのポップアップリストが表示され、各インターフェースの詳細、ステータス、エラーが示されます。<br>インターフェースのないホストの場合、列は空です。<br>すべてのインターフェースの現在のステータス 1つのタイプのアイコンがそれぞれのアイコンの色で表示されます。<br>**緑** - すべてのインターフェースが使用可能<br>**黄色**-少なくとも1つのインターフェースが使用可能で、少なくとも1つが使用不可、その他に「不明」を含む任意の値を設定できます。<br>**赤** - 使用可能なインターフェースがありません<br>**灰色** - 少なくとも1つのインターフェースが不明（使用不可）<br>アクティブなZabbixエージェントアイテムは使用できないことに注意してください。ホストの可用性に影響します。| |*タグ*|ホストとすべてのリンクされたテンプレートの[タグ](/manual/config/tagging)。マクロは未解決。| |*ステータス*|ホストステータス - *有効*または*無効*。<br>列ヘッダーをクリックして、ステータスの昇順または降順でホストを並べ替えます| |*最新データ*|リンクをクリックすると、ホストから収集されたすべての最新データを含む*監視データ - 最新データ*ページが開きます。<br>最新データを含むアイテムの数が灰色で表示されます（Zabbix 6.0.5以降で表示されます）| |*障害*|深刻度でソートされたオープンホストの障害の数。 四角の色は障害の深刻度を示します。 四角の数字は、特定の深刻度の障害数を意味します。<br>アイコンをクリックすると、現在のホストの*監視データ - 障害*ページが開きます。 <br>ホストに障害がない場合は、このホストの*障害*セクションへのリンクがテキストとして表示されます。 <br>フィルターを使用して抑制された障害を含めるかどうかを選択します（デフォルトでは含まれません）| |*グラフ*|リンクをクリックすると、ホスト用に設定されたグラフが表示されます。 グラフの数は灰色で表示されます。<br>ホストにグラフがない場合、リンクは無効になり（灰色のテキスト）数字は表示されません。| |*ダッシュボード*|リンクをクリックすると、ホスト用に設定されたダッシュボードが表示されます。 ダッシュボードの数は灰色で表示されます。<br>ホストにダッシュボードがない場合、リンクは無効になり（灰色のテキスト）数字は表示されません。| |*Web*|リンクをクリックすると、ホスト用に設定されたWebシナリオが表示されます。 Webシナリオの数は灰色で表示されます。<br>ホストにWebシナリオがない場合、リンクは無効になり（灰色のテキスト）数字は表示されません。| #### Overview The Monitoring menu is all about displaying data. Whatever information Zabbix is configured to gather, visualize and act upon, it will be displayed in the various sections of the Monitoring menu. #### 概要 監視データメニューは、すべてデータの表示に関するものです。 Zabbixが収集、視覚化、操作するために設定されている情報が何であれ、それは監視データメニューのさまざまなセクションに表示されます。 #### Overview The queue displays items that are waiting for a refresh. The queue is just a **logical** representation of data. There is no IPC queue or any other queue mechanism in Zabbix. Items monitored by proxies are also included in the queue - they will be counted as queued for the proxy history data update period. Only items with scheduled refresh times are displayed in the queue. This means that the following item types are excluded from the queue: - log, logrt and event log active Zabbix agent items - SNMP trap items - trapper items - web monitoring items - dependent items Statistics shown by the queue is a good indicator of the performance of Zabbix server. The queue is retrieved directly from Zabbix server using JSON protocol. The information is available only if Zabbix server is running. :::noteimportant Items are not counted in the queue if the item interface becomes unavailable due to connection problems or agent not working properly. ::: #### 概要 キューには、更新待ちのアイテムが表示されます。キューはデータの**論理的**表現にすぎません。ZabbixにはIPCキューやその他のキューの仕組みはありません。 プロキシで監視されているアイテムもキューに含まれ、プロキシのヒストリーデータ更新期間中はキューにカウントされます。 キューに表示されるのは、更新時刻が設定されているアイテムのみです。つまり、以下のアイテムタイプはキューから除外されます。 - Zabbix エージェント(アクティブ)のlog、logrt、event_logアイテム - SNMPトラップアイテム - Zabbixトラッパーアイテム - web監視アイテム - 依存アイテム キューが示す統計情報は、Zabbixサーバのパフォーマンスを示す良い指標となります。 キューはJSONプロトコルを使用してZabbixサーバから直接取得されます。この情報はZabbixサーバが動作している場合のみ利用可能です。 #### Overview There are four ways of getting Zabbix: - Install it from the [packages](/manual/installation/install_from_packages) - Download the latest source archive and [compile it yourself](/manual/installation/install) - Install it from the [containers](/manual/installation/containers) - Download the [virtual appliance](/manual/appliance) To download the latest distribution packages, pre-compiled sources or the virtual appliance, go to the [Zabbix download page](https://www.zabbix.com/download), where direct links to latest versions are provided. #### 概要 Zabbixを入手するには4つの方法があります。 - [パッケージ](/manual/installation/install_from_packages)からのインストール - 最新のソースアーカイブをダウンロードして[自分でコンパイル](/manual/installation/install) - [コンテナ](/manual/installation/containers)でのインストール - [仮想アプライアンス](/manual/appliance)をダウンロード 最新の配布パッケージ、コンパイル済みのソース、または仮想アプライアンスについては、[Zabbixダウンロードページ](https://www.zabbix.com/download)にアクセスしてください。最新バージョンへのリンクが掲示されています。 #### Overview There are several types of events generated in Zabbix: - trigger events - whenever a trigger changes its status (*OK→PROBLEM→OK*) - service events - whenever a service changes its status (*OK→PROBLEM→OK*) - discovery events - when hosts or services are detected - autoregistration events - when active agents are auto-registered by server - internal events - when an item/low-level discovery rule becomes unsupported or a trigger goes into an unknown state ::: noteclassic Internal events are supported starting with Zabbix 2.2 version. ::: Events are time-stamped and can be the basis of actions such as sending notification e-mail etc. To view details of events in the frontend, go to *Monitoring* → *Problems*. There you can click on the event date and time to view details of an event. More information is available on: - [trigger events](/manual/config/events/trigger_events) - [other event sources](/manual/config/events/sources) #### 概要 Zabbixで生成されるイベントにはいくつかの種類があります。 - トリガーイベント - トリガーのステータスが変わるたびに (*OK→障害→OK*) - サービスイベント - サービスのステータスが変わるたびに (*OK→障害→OK*) - ディスカバリイベント - ホストまたはサービスが検出されたとき - 自動登録イベント - アクティブなエージェントがサーバーによって自動登録されたとき - 内部イベント - アイテム/ローレベルディスカバリルールがサポートされなくなったとき、またはトリガーが不明な状態になったとき ::: noteclassic 内部イベントは、Zabbix 2.2以降でサポートされます。 ::: イベントにはタイムスタンプが付けられ、通知メールの送信などのアクションの元となることができます。 フロントエンドでイベントの詳細を表示するには、*監視* → *障害*へ移動してください。 そこでイベントの日付と時刻をクリックすると、イベントの詳細が表示されます。 詳細については、以下を参照してください。 - [トリガーイベント](/manual/config/events/trigger_events) - [その他のイベントソース](/manual/config/events/sources) #### Overview There are situations when one item gathers multiple metrics at a time or it even makes more sense to collect related metrics simultaneously, for example: - CPU utilization of individual cores - Incoming/outgoing/total network traffic To allow for bulk metric collection and simultaneous use in several related items, Zabbix supports dependent items. Dependent items depend on the master item that collects their data simultaneously, in one query. A new value for the master item automatically populates the values of the dependent items. Dependent items cannot have a different update interval than the master item. Zabbix preprocessing options can be used to extract the part that is needed for the dependent item from the master item data. Preprocessing is managed by a `preprocessing manager` process, which has been added in Zabbix 3.4, along with workers that perform the preprocessing steps. All values (with or without preprocessing) from different data gatherers pass through the preprocessing manager before being added to the history cache. Socket-based IPC communication is used between data gatherers (pollers, trappers, etc) and the preprocessing process. Zabbix server or Zabbix proxy (if host is monitored by proxy) are performing preprocessing steps and processing dependent items. Item of any type, even dependent item, can be set as master item. Additional levels of dependent items can be used to extract smaller parts from the value of an existing dependent item. #### 概要 1つのアイテムで複数のメトリクスを同時に収集する場合や、関連するメトリクスを同時に収集する方が理にかなっている場合などがある。例えば： - 各コアのCPU使用率 - ネットワークトラフィックの受信/送信/総量 メトリクスの一括収集と複数の関連項目での同時利用を可能にするため、Zabbixは依存アイテムをサポートしています。依存アイテムは親アイテムに依存し、1つのクエリで同時にデータを収集します。マスターアイテムの新しい値は自動的に依存するアイテムの値に反映されます。依存アイテムは、マスターアイテムと異なる更新間隔を設定することはできません。<br> Zabbixの保存前処理オプションを使用すると、マスターアイテムから依存アイテムに必要な部分を抽出することができます。<br> 保存前処理は、Zabbix3.4で追加された`preprocessing manager`プロセスと、保存前処理のステップを実行するワーカーによって管理されます。異なるデータ収集装置からのすべての値(保存前処理のあり/なし)は、ヒストリーキャッシュに追加される前にpreprocessing managerを通過します。データ収集処理(ポーラ、トラッパーなど)と保存前処理の間にはソケットベースのIPC通信が使用されます。<br> ZabbixサーバーまたはZabbixプロキシ(プロキシ経由でホストを監視している場合)は、保存前処理の手順を実行し、依存アイテムを処理しています。<br> 依存アイテムであっても、あらゆるタイプのアイテムをマスターアイテムとして設定することができます。<br> 依存アイテムのレベルを追加することで、既存の依存アイテムの値からより小さな部分を抽出することができます。<br> #### Overview There is an option to tag various entities in Zabbix. Tags can be defined for: - templates - hosts - items - web scenarios - triggers - services - template items and triggers - host, item and trigger prototypes Tags have several uses, most notably, to mark events. If entities are tagged, the corresponding new events get marked accordingly: - with tagged templates - any host problems created by relevant entities (items, triggers, etc) from this template will be marked - with tagged hosts - any problem of the host will be marked - with tagged items, web scenarios - any data/problem of this item or web scenario will be marked - with tagged triggers - any problem of this trigger will be marked A problem event inherits all tags from the whole chain of templates, hosts, items, web scenarios, triggers. Completely identical `tag:value` combinations (after resolved macros) are merged into one rather than being duplicated, when marking the event. Having custom event tags allows for more flexibility. Importantly, events can be [correlated](/manual/config/event_correlation) based on event tags. In other uses, actions can be defined based on tagged events. Item problems can be grouped based on tags. Problem tags can also be used to map problems to [services](/manual/it_services/service_tree#problem-tags). Tagging is realized as a pair of *tag name* and *value*. You can use only the name or pair it with a value: MySQL, Service:MySQL, Services, Services:Customer, Applications, Application:Java, Priority:High An entity (template, host, item, web scenario, trigger or event) may be tagged with the same name, but different values - these tags will not be considered 'duplicates'. Similarly, a tag without value and the same tag with value can be used simultaneously. #### 概要 Zabbixには様々なエンティティにタグを付けることができるオプションがあります。タグは以下のものに定義することができます: - テンプレート - ホスト - item - web シナリオ - トリガー - サービス - テンプレート items および triggers - ホスト, item と trigger プロトタイプ タグにはいくつかの用途がありますが、特にイベントをマークするのに適しています。<br> もしエンティティにタグが付けられたら、対応する新しいイベントもそれに応じてマークされます: - タグ付けされたテンプレート - このテンプレートの関連エンティティ（item、トリガーなど）によって作成された すべてのホストの問題がマークされます。 - タグ付きホスト - ホストのあらゆる問題がマークされます。 - タグ付きアイテム、Web シナリオ - この item、Web シナリオのあらゆるデータ/問題がマークされます。 - タグ付きトリガー - このトリガーのすべての問題がマークされます。 問題のあるイベントは、テンプレート、ホスト、item、Web シナリオ、トリガーのチェーン全体から すべてのタグを引き継ぎます。<br>完全に同一の `tag:value` の組み合わせ（マクロを解決した後）は、イベントをマークする際に重複するのではなく、<br> 1つにマージされます。 カスタムイベントタグを持つことで、より柔軟な対応が可能になります。重要なのは、イベントタグに基づいてイベントを<br> [correlated](/manual/config/event_correlation) することができることです。他の用途では、タグ付けされたイベントに基づいて<br> アクションを定義することができます。item の問題は、タグに基づいてグループ化することができます。<br> 問題タグは、問題を[services](/manual/it_services/service_tree#problem-tags)にマップするために使用することもできます。 タグ付けは、*タグ名*と*値*のペアとして実現されます。名前だけを使うことも、値と対にすることもできます。 MySQL, Service:MySQL, Services, Services:Customer, Applications, Application:Java, Priority:High エンティティ（テンプレート、ホスト、item、Web シナリオ、トリガー、イベント）は、同じ名前で異なる値 のタグを<br> 付けることができますが、これらのタグは '重複したもの' とはみなされません。同様に、値のないタグと値のある同じタグを<br> 同時に使用することができます。 #### Overview The Reports menu features several sections that contain a variety of predefined and user-customizable reports focused on displaying an overview of such parameters as system information, triggers and gathered data. #### 概要 レポートメニューには、システム情報、トリガー、収集されたデータなどのパラメーターの表示に焦点を当てた、事前定義されたユーザーがカスタマイズ可能なさまざまなレポートを含むいくつかのセクションがあります。 #### Overview These checks use the communication with Zabbix agent for data gathering. There are [passive and active](/manual/appendix/items/activepassive) agent checks. When configuring an item, you can select the required type: - *Zabbix agent* - for passive checks - *Zabbix agent (active)* - for active checks #### 概要 これらのチェックは、Zabbix agent との通信を利用してデータを収集します。 agent チェックには[passive and active](/manual/appendix/items/activepassive) （パッシブとアクティブ）の2種類あります。<br> アイテムの設定時に、必要なタイプを選択することができます。<br> - *Zabbix agent* - パッシブチェック用 - *Zabbix agent(active)* -アクティブチェック用 #### Overview The section in *Monitoring → Latest data* can be used to view latest values gathered by items as well as to access various graphs for the items. {width="600"} Items are displayed with their name, time since last check, last value, change amount, tags, and a link to a simple graph/history of item values. To view last received data in raw format (without unit conversion and value mapping applied), hover over the value displayed in the *Last value* column. If an item has errors, for example, has become unsupported, an information icon will be displayed in the *Info* column  . Hover over the icon for details. An icon with a question mark  is displayed next to the item name for all items that have a description. If you position the mouse cursor on this icon, the item description is displayed as a tooltip. *Note*: The name of a disabled host is displayed in red. Data of disabled hosts, including graphs and item value lists, is also accessible in *Latest data*. By default, only values that fall within the last 24 hours are displayed. This limit has been introduced with the aim of improving initial loading times for large pages of the latest data. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration→General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section. ::: noteimportant For items with an update frequency of 1 day or more the change amount will never be displayed (with the default setting). Also in this case the last value will not be displayed at all if it was received more than 24 hours ago. ::: #### Overview The section in *Monitoring → Latest data* can be used to view latest values gathered by items as well as to access various graphs for the items. {width="600"} Items are displayed with their name, last check time, last value, change amount, tags and a link to a simple graph/history of item values. An icon with a question mark  is displayed next to the item name for all items that have a description. If you position the mouse cursor on this icon, the item description is displayed as a tooltip. *Note*: The name of a disabled host is displayed in red. Data of disabled hosts, including graphs and item value lists, is also accessible in *Latest data*. By default, only values that fall within the last 24 hours are displayed. This limit has been introduced with the aim of improving initial loading times for large pages of the latest data. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration→General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section. ::: noteimportant For items with an update frequency of 1 day or more the change amount will never be displayed (with the default setting). Also in this case the last value will not be displayed at all if it was received more than 24 hours ago. ::: #### Overview The Services menu is for the [service monitoring](/manual/it_services) functions of Zabbix. #### 概要 サービスメニューは、Zabbixの[サービスモニタリング](/manual/it_services)機能です。 #### Overview The table below presents details of the modbus.get\[\] [item](/manual/config/items/itemtypes/zabbix_agent#modbus-data) parameters. #### 概要 以下の表は、[アイテム](/manual/config/items/itemtypes/zabbix_agent#modbus-data)modbus.get\[\]のパラメーターの詳細を示しています。 #### Overview The table contains a complete list of macros supported by Zabbix out-of-the-box. ::: notetip To see all macros supported in a location (for example, in "map URL"), you may paste the location name into the search box at the bottom of your browser window (accessible by pressing CTRL+F) and do a search for *next*. ::: |Macro|Supported in|Description| |-----|------------|-----------| |{ACTION.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications|*Numeric ID of the triggered action.*| |{ACTION.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications|*Name of the triggered action.*| |{ALERT.MESSAGE}|→ Alert script parameters|*'Default message' value from action configuration.*<br>Supported since 3.0.0.| |{ALERT.SENDTO}|→ Alert script parameters|*'Send to' value from user media configuration.*<br>Supported since 3.0.0.| |{ALERT.SUBJECT}|→ Alert script parameters|*'Default subject' value from action configuration.*<br>Supported since 3.0.0.| |{DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Current date in yyyy.mm.dd. format.*| |{DISCOVERY.DEVICE.IPADDRESS}|→ Discovery notifications and commands|*IP address of the discovered device.*<br>Available always, does not depend on host being added.| |{DISCOVERY.DEVICE.DNS}|→ Discovery notifications and commands|*DNS name of the discovered device.*<br>Available always, does not depend on host being added.| |{DISCOVERY.DEVICE.STATUS}|→ Discovery notifications and commands|*Status of the discovered device*: can be either UP or DOWN.| |{DISCOVERY.DEVICE.UPTIME}|→ Discovery notifications and commands|*Time since the last change of discovery status for a particular device*, with precision down to a second.<br>For example: 1h 29m 01s.<br>For devices with status DOWN, this is the period of their downtime.| |{DISCOVERY.RULE.NAME}|→ Discovery notifications and commands|*Name of the discovery rule that discovered the presence or absence of the device or service.*| |{DISCOVERY.SERVICE.NAME}|→ Discovery notifications and commands|*Name of the service that was discovered.*<br>For example: HTTP.| |{DISCOVERY.SERVICE.PORT}|→ Discovery notifications and commands|*Port of the service that was discovered.*<br>For example: 80.| |{DISCOVERY.SERVICE.STATUS}|→ Discovery notifications and commands|*Status of the discovered <service://> can be either UP or DOWN. \| \|{DISCOVERY.SERVICE.UPTIME} \|→ Discovery notifications and commands \|*Time since the last change of discovery status for a particular service*, with precision down to a second.<br>For example: 1h 29m 01s.<br>For services with status DOWN, this is the period of their downtime. \| \|{ESC.HISTORY} \|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Internal notifications \|*Escalation history. Log of previously sent messages.*<br>Shows previously sent notifications, on which escalation step they were sent and their status (*sent//, *in progress* or *failed*).| |{EVENT.ACK.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Acknowledgment status of the event (Yes/No)*.| |{EVENT.AGE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Age of the event that triggered an action*, with precision down to a second.<br>Useful in escalated messages.| |{EVENT.DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Date of the event that triggered an action.*| |{EVENT.DURATION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Duration of the event (time difference between problem and recovery events)*, with precision down to a second.<br>Useful in problem recovery messages.<br><br>Supported since 5.0.0.| |{EVENT.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric ID of the event that triggered an action.*| |{EVENT.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the problem event that triggered an action.*<br>Supported since 4.0.0.| |{EVENT.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of the event severity.* Possible values: 0 - Not classified, 1 - Information, 2 - Warning, 3 - Average, 4 - High, 5 - Disaster.<br>Supported since 4.0.0.| |{EVENT.OBJECT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of of the event object.* Possible values: 0 - Trigger, 1 - Discovered host, 2 - Discovered service, 3 - Autoregistration, 4 - Item, 5 - Low-level discovery rule.<br>Supported since 4.4.0.| |{EVENT.OPDATA}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Operational data of the underlying trigger of a problem.*<br>Supported since 4.4.0.| |{EVENT.RECOVERY.DATE}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Date of the recovery event.*| |{EVENT.RECOVERY.ID}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Numeric ID of the recovery event.*| |{EVENT.RECOVERY.NAME}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Name of the recovery event.*<br>Supported since 4.4.1.| |{EVENT.RECOVERY.STATUS}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Verbal value of the recovery event.*| |{EVENT.RECOVERY.TAGS}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*A comma separated list of recovery event tags.* Expanded to an empty string if no tags exist.<br>Supported since 3.2.0.| |{EVENT.RECOVERY.TAGSJSON}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*A JSON array containing event tag [objects](/manual/api/reference/event/object#event_tag).* Expanded to an empty array if no tags exist.<br>Supported since 5.0.0.| |{EVENT.RECOVERY.TIME}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Time of the recovery event.*| |{EVENT.RECOVERY.VALUE}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Numeric value of the recovery event.*| |{EVENT.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the event severity.*<br>Supported since 4.0.0.| |{EVENT.SOURCE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of the event source.* Possible values: 0 - Trigger, 1 - Discovery, 2 - Autoregistration, 3 - Internal.<br>Supported since 4.4.0.| |{EVENT.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Verbal value of the event that triggered an action.*| |{EVENT.TAGS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A comma separated list of event tags.* Expanded to an empty string if no tags exist.<br>Supported since 3.2.0.| |{EVENT.TAGSJSON}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A JSON array containing event tag [objects](/manual/api/reference/event/object#event_tag).* Expanded to an empty array if no tags exist.<br>Supported since 5.0.0.| |{EVENT.TAGS.<tag name>}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Webhook media type URL names and URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Event tag value referenced by the tag name.*<br>A tag name containing non-alphanumeric characters (including non-English multibyte-UTF characters) should be double quoted. Quotes and backslashes inside a quoted tag name must be escaped with a backslash.<br>Supported since 4.4.2.| |{EVENT.TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Time of the event that triggered an action.*| |{EVENT.UPDATE.ACTION}|→ Problem update notifications and commands|*Human-readable name of the action(s)* performed during [problem update](/manual/acknowledges#updating_problems).<br>Resolves to the following values: *acknowledged*, *commented*, *changed severity from (original severity) to (updated severity)* and *closed* (depending on how many actions are performed in one update).<br>Supported since 4.0.0.| |{EVENT.UPDATE.DATE}|→ Problem update notifications and commands<br>→ Service update notifications and commands|*Date of event [update](/manual/config/notifications/action/update_operations) (acknowledgment, etc).*<br>Deprecated name: {ACK.DATE}| |{EVENT.UPDATE.HISTORY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Log of problem updates (acknowledgments, etc).*<br>Deprecated name: {EVENT.ACK.HISTORY}| |{EVENT.UPDATE.MESSAGE}|→ Problem update notifications and commands|*Problem update message.*<br>Deprecated name: {ACK.MESSAGE}| |{EVENT.UPDATE.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of of the problem update status.* Possible values: 0 - Webhook was called because of problem/recovery event, 1 - Update operation.<br>Supported since 4.4.0.| |{EVENT.UPDATE.TIME}|→ Problem update notifications and commands<br>→ Service update notifications and commands|*Time of event [update](/manual/config/notifications/action/update_operations) (acknowledgment, etc).*<br>Deprecated name: {ACK.TIME}| |{EVENT.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of the event that triggered an action (1 for problem, 0 for recovering).*| |{FUNCTION.VALUE<1-9>}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Event names|*Results of the Nth item-based function in the trigger expression at the time of the event.*<br>Only functions with */host/key* as the first parameter are counted. See [indexed macros](supported_by_location#indexed_macros).| |{FUNCTION.RECOVERY.VALUE<1-9>}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Results of the Nth item-based function in the recovery expression at the time of the event.*<br>Only functions with */host/key* as the first parameter are counted. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.CONN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Description of item value widget|*Host IP address or DNS name, depending on host settings*^[2](supported_by_location#footnotes)^.<br><br>May be used with a numeric index as {HOST.CONN[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host description.*<br><br>This macro may be used with a numeric index e.g. {HOST.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.DNS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Description of item value widget|*Host DNS name*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.DNS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.HOST}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Item key parameters<br>→ Map element labels, map URL names and values<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Description of item value widget|*Host name.*<br><br>This macro may be used with a numeric index e.g. {HOST.HOST[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{HOSTNAME<1-9>}` is deprecated.| |{HOST.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host ID.*<br><br>May be used with a numeric index as {HOST.ID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.IP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Description of item value widget|*Host IP address*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.IP[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{IPADDRESS<1-9>}` is deprecated.| |{HOST.METADATA}|→ Autoregistration notifications and commands|*Host metadata.*<br>Used only for active agent autoregistration.| |{HOST.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Description of item value widget|*Visible host name.*<br><br>This macro may be used with a numeric index e.g. {HOST.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.PORT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ JMX item endpoint field<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host (agent) port*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.PORT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.TARGET.CONN}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|IP address or DNS name of the target host, depending on host settings.<br>Supported since 5.4.0.| |{HOST.TARGET.DNS}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|DNS name of the target host.<br>Supported since 5.4.0.| |{HOST.TARGET.HOST}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|Technical name of the target host.<br>Supported since 5.4.0.| |{HOST.TARGET.IP}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|IP address of the target host.<br>Supported since 5.4.0.| |{HOST.TARGET.NAME}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|Visible name of the target host.<br>Supported since 5.4.0.| |{HOSTGROUP.ID}|→ Map element labels, map URL names and values|*Host group ID.*| |{INVENTORY.ALIAS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Alias field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.ALIAS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.ASSET.TAG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Asset tag field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.ASSET.TAG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.CHASSIS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Chassis field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CHASSIS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.CONTACT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Contact field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CONTACT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.CONTACT<1-9>}` is deprecated.| |{INVENTORY.CONTRACT.NUMBER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Contract number field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CONTRACT.NUMBER[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.DEPLOYMENT.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Deployment status field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.DEPLOYMENT.STATUS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HARDWARE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Hardware field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HARDWARE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.HARDWARE<1-9>}` is deprecated.| |{INVENTORY.HARDWARE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Hardware (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HARDWARE.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HOST.NETMASK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host subnet mask field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.NETMASK[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HOST.NETWORKS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host networks field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.NETWORKS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HOST.ROUTER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host router field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.ROUTER[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.ARCH}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Hardware architecture field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.ARCH[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.DECOMM}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Date hardware decommissioned field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.DECOMM[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.EXPIRY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Date hardware maintenance expires field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.EXPIRY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.INSTALL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Date hardware installed field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.INSTALL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.PURCHASE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Date hardware purchased field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.PURCHASE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.INSTALLER.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Installer name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.INSTALLER.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.LOCATION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Location field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.LOCATION<1-9>}` is deprecated.| |{INVENTORY.LOCATION.LAT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Location latitude field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION.LAT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.LOCATION.LON}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Location longitude field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION.LON[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.MACADDRESS.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*MAC address A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MACADDRESS.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.MACADDRESS<1-9>}` is deprecated.| |{INVENTORY.MACADDRESS.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*MAC address B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MACADDRESS.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.MODEL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Model field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MODEL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.NAME<1-9>}` is deprecated.| |{INVENTORY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.NOTES<1-9>}` is deprecated.| |{INVENTORY.OOB.IP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OOB IP address field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.IP[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OOB.NETMASK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OOB subnet mask field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.NETMASK[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OOB.ROUTER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OOB router field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.ROUTER[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OS field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.OS<1-9>}` is deprecated.| |{INVENTORY.OS.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OS (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OS.SHORT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OS (Short) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS.SHORT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.CELL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC cell field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.CELL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.EMAIL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC email field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.EMAIL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.PHONE.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC phone A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.PHONE.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.PHONE.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC phone B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.PHONE.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.SCREEN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC screen name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.SCREEN[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.CELL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC cell field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.CELL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.EMAIL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC email field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.EMAIL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.PHONE.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC phone A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.PHONE.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.PHONE.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC phone B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.PHONE.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.SCREEN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC screen name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.SCREEN[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SERIALNO.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Serial number A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SERIALNO.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.SERIALNO<1-9>}` is deprecated.| |{INVENTORY.SERIALNO.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Serial number B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SERIALNO.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ADDRESS.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site address A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ADDRESS.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site address B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ADDRESS.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site address C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.C[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.CITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site city field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.CITY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.COUNTRY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site country field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.COUNTRY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.RACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site rack location field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.RACK[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.STATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site state/province field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.STATE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ZIP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site ZIP/postal field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ZIP[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.SOFTWARE<1-9>}` is deprecated.| |{INVENTORY.SOFTWARE.APP.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software application A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software application B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software application C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.C[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.D}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software application D field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.D[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.E}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software application E field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.E[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.TAG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Tag field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TAG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.TAG<1-9>}` is deprecated.| |{INVENTORY.TYPE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Type field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TYPE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.DEVICETYPE<1-9>}` is deprecated.| |{INVENTORY.TYPE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Type (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TYPE.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.URL.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*URL A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.URL.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*URL B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.URL.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*URL C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.C[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.VENDOR}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Vendor field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.VENDOR[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Description of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.DESCRIPTION.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Description (with macros unresolved) of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>Supported since 5.2.0.| |{ITEM.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script type item, item prototype and discovery rule parameter names and values^[6](supported_by_location#footnotes)^<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Numeric ID of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.ID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.KEY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script type item, item prototype and discovery rule parameter names and values^[6](supported_by_location#footnotes)^<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Key of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.KEY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{TRIGGER.KEY}` is deprecated.| |{ITEM.KEY.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script type item, item prototype and discovery rule parameter names and values^[6](supported_by_location#footnotes)^<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.^[6](supported_by_location#footnotes)^<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Original key (with macros not expanded) of the Nth item in the trigger expression that caused a notification ^[4](supported_by_location#footnotes)^.*<br><br>This macro may be used with a numeric index e.g. {ITEM.KEY.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LASTVALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, event names, operational data and descriptions<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Trigger URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*The latest value of the Nth item in the trigger expression that caused a notification.*<br>It will resolve to \*UNKNOWN\* in the frontend if the latest history value has been collected more than the *Max history display period* time ago (set in the [Administration→General](/manual/web_interface/frontend_sections/administration/general#gui) menu section).<br>Note that since 4.0, when used in the problem name, it will not resolve to the latest item value when viewing problem events, instead it will keep the item value from the time of problem happening.<br>It is alias to `last(/{HOST.HOST}/{ITEM.KEY})`.<br>[Customizing](/manual/config/macros/macro_functions) the macro value is supported for this macro; starting with Zabbix 3.2.0.<br><br>This macro may be used with a numeric index e.g. {ITEM.LASTVALUE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. item in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.AGE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Age of the log item event*, with precision down to a second.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.AGE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Date of the log item event.*<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.DATE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.EVENTID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*ID of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.EVENTID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Numeric severity of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.NSEVERITY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Verbal severity of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.SEVERITY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.SOURCE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Source of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.SOURCE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Time of the log item event.*<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.TIME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Name of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.NAME.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|This macros is deprecated since Zabbix 6.0. It used to resolve to the *original name (i.e. without macros resolved) of the item* in pre-6.0 Zabbix versions when user macros and positional macros were supported in the item name.<br><br>This macro may be used with a numeric index e.g. {ITEM.NAME.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.STATE}|→ Item-based internal notifications<br>→ Description of item value widget|*The latest state of the Nth item in the trigger expression that caused a notification.* Possible values: **Not supported** and **Normal**.<br><br>This macro may be used with a numeric index e.g. {ITEM.STATE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.STATE.ERROR}|→ Item-based internal notifications|*Error message with details why an item became unsupported.* <br> <br> If an item goes into the unsupported state and then immediately gets supported again the error field can be empty.| |{ITEM.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, event names, operational data and descriptions<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Trigger URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|Resolved to either:<br>1) the historical (at-the-time-of-event) value of the Nth item in the trigger expression, if used in the context of trigger status change, for example, when displaying events or sending notifications.<br>2) the latest value of the Nth item in the trigger expression, if used without the context of trigger status change, for example, when displaying a list of triggers in a pop-up selection window. In this case works the same as {ITEM.LASTVALUE}<br>In the first case it will resolve to \*UNKNOWN\* if the history value has already been deleted or has never been stored.<br>In the second case, and in the frontend only, it will resolve to \*UNKNOWN\* if the latest history value has been collected more than the *Max history display period* time ago (set in the [Administration→General](/manual/web_interface/frontend_sections/administration/general#gui) menu section).<br><br>[Customizing](/manual/config/macros/macro_functions) the macro value is supported for this macro, starting with Zabbix 3.2.0.<br><br>This macro may be used with a numeric index e.g. {ITEM.VALUE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. item in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.VALUETYPE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Value type of the Nth item in the trigger expression that caused a notification.* Possible values: 0 - numeric float, 1 - character, 2 - log, 3 - numeric unsigned, 4 - text.<br><br>This macro may be used with a numeric index e.g. {ITEM.VALUETYPE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>Supported since 5.4.0.| |{LLDRULE.DESCRIPTION}|→ LLD-rule based internal notifications|*Description of the low-level discovery rule which caused a notification.*| |{LLDRULE.DESCRIPTION.ORIG}|→ LLD-rule based internal notifications|*Description (with macros unresolved) of the low-level discovery rule which caused a notification.*<br>Supported since 5.2.0.| |{LLDRULE.ID}|→ LLD-rule based internal notifications|*Numeric ID of the low-level discovery rule which caused a notification.*| |{LLDRULE.KEY}|→ LLD-rule based internal notifications|*Key of the low-level discovery rule which caused a notification.*| |{LLDRULE.KEY.ORIG}|→ LLD-rule based internal notifications|*Original key (with macros not expanded) of the low-level discovery rule which caused a notification.*| |{LLDRULE.NAME}|→ LLD-rule based internal notifications|*Name of the low-level discovery rule (with macros resolved) that caused a notification.*| |{LLDRULE.NAME.ORIG}|→ LLD-rule based internal notifications|*Original name (i.e. without macros resolved) of the low-level discovery rule that caused a notification.*| |{LLDRULE.STATE}|→ LLD-rule based internal notifications|*The latest state of the low-level discovery rule.* Possible values: **Not supported** and **Normal**.| |{LLDRULE.STATE.ERROR}|→ LLD-rule based internal notifications|*Error message with details why an LLD rule became unsupported.* <br> <br> If an LLD rule goes into the unsupported state and then immediately gets supported again the error field can be empty.| |{MAP.ID}|→ Map element labels, map URL names and values|*Network map ID.*| |{MAP.NAME}|→ Map element labels, map URL names and values<br>→ Text field in map shapes|*Network map name.*<br>Supported since 3.4.0.| |{PROXY.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Description of the proxy*. Resolves to either:<br>1) proxy of the Nth item in the trigger expression (in trigger-based notifications). You may use [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) macros here.<br>2) proxy, which executed discovery (in discovery notifications). Use {PROXY.DESCRIPTION} here, without indexing.<br>3) proxy to which an active agent registered (in autoregistration notifications). Use {PROXY.DESCRIPTION} here, without indexing.<br><br>This macro may be used with a numeric index e.g. {PROXY.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{PROXY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the proxy*. Resolves to either:<br>1) proxy of the Nth item in the trigger expression (in trigger-based notifications). You may use [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) macros here.<br>2) proxy, which executed discovery (in discovery notifications). Use {PROXY.NAME} here, without indexing.<br>3) proxy to which an active agent registered (in autoregistration notifications). Use {PROXY.NAME} here, without indexing.<br><br>This macro may be used with a numeric index e.g. {PROXY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{SERVICE.NAME}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*Name of the service* (with macros resolved).| |{SERVICE.ROOTCAUSE}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*List of trigger problem events that caused a service to fail*, sorted by severity and host name. Includes the following details: host name, event name, severity, age, service tags and values.| |{SERVICE.TAGS}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*A comma separated list of service event tags.* Service event tags can be defined in the service configuration section Tags. Expanded to an empty string if no tags exist.| |{SERVICE.TAGSJSON}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*A JSON array containing service event tag objects.* Service event tags can be defined in the service configuration section Tags. Expanded to an empty array if no tags exist.| |{SERVICE.TAGS.<tag name>}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*Service event tag value referenced by the tag name.* Service event tags can be defined in the service configuration section Tags.<br>A tag name containing non-alphanumeric characters (including non-English multibyte-UTF characters) should be double quoted. Quotes and backslashes inside a quoted tag name must be escaped with a backslash.| |{TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger event names<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Current time in hh:mm:ss.*| |{TRIGGER.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger description.*<br>All macros supported in a trigger description will be expanded if `{TRIGGER.DESCRIPTION}` is used in notification text.<br>`{TRIGGER.COMMENT}` is deprecated.| |{TRIGGER.EXPRESSION.EXPLAIN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Event names|*Partially evaluated trigger expression.*<br>Item-based functions are evaluated and replaced by the results at the time of event generation whereas all other functions are displayed as written in the expression. Can be used for debugging trigger expressions.| |{TRIGGER.EXPRESSION.RECOVERY.EXPLAIN}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Partially evaluated trigger recovery expression.*<br>Item-based functions are evaluated and replaced by the results at the time of event generation whereas all other functions are displayed as written in the expression. Can be used for debugging trigger recovery expressions.| |{TRIGGER.EVENTS.ACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of acknowledged events for a map element in maps, or for the trigger which generated current event in notifications.*| |{TRIGGER.EVENTS.PROBLEM.ACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of acknowledged PROBLEM events for all triggers disregarding their state.*| |{TRIGGER.EVENTS.PROBLEM.UNACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of unacknowledged PROBLEM events for all triggers disregarding their state.*| |{TRIGGER.EVENTS.UNACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of unacknowledged events for a map element in maps, or for the trigger which generated current event in notifications.*| |{TRIGGER.HOSTGROUP.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A sorted (by SQL query), comma-space separated list of host groups in which the trigger is defined.*| |{TRIGGER.PROBLEM.EVENTS.PROBLEM.ACK}|→ Map element labels|*Number of acknowledged PROBLEM events for triggers in PROBLEM state.*| |{TRIGGER.PROBLEM.EVENTS.PROBLEM.UNACK}|→ Map element labels|*Number of unacknowledged PROBLEM events for triggers in PROBLEM state.*| |{TRIGGER.EXPRESSION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger expression.*| |{TRIGGER.EXPRESSION.RECOVERY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger recovery expression* if *OK event generation* in [trigger configuration](/manual/config/triggers/trigger) is set to 'Recovery expression'; otherwise an empty string is returned.<br>Supported since 3.2.0.| |{TRIGGER.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Map element labels, map URL names and values<br>→ Trigger URLs<br>→ Trigger tag value<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric trigger ID which triggered this action.*<br>Supported in trigger tag values since 4.4.1.| |{TRIGGER.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the trigger* (with macros resolved).<br>Note that since 4.0.0 {EVENT.NAME} can be used in actions to display the triggered event/problem name with macros resolved.| |{TRIGGER.NAME.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Original name of the trigger* (i.e. without macros resolved).| |{TRIGGER.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numerical trigger severity.* Possible values: 0 - Not classified, 1 - Information, 2 - Warning, 3 - Average, 4 - High, 5 - Disaster.| |{TRIGGER.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger severity name.* Can be defined in *Administration → General → Trigger displaying options*.| |{TRIGGER.STATE}|→ Trigger-based internal notifications|*The latest state of the trigger.* Possible values: **Unknown** and **Normal**.| |{TRIGGER.STATE.ERROR}|→ Trigger-based internal notifications|*Error message with details why a trigger became unsupported.* <br> <br> If a trigger goes into the unsupported state and then immediately gets supported again the error field can be empty.| |{TRIGGER.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Current trigger value.* Can be either PROBLEM or OK.<br>`{STATUS}` is deprecated.| |{TRIGGER.TEMPLATE.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A sorted (by SQL query), comma-space separated list of templates in which the trigger is defined, or \*UNKNOWN\* if the trigger is defined in a host.*| |{TRIGGER.URL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger URL.*| |{TRIGGER.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger expressions<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Current trigger numeric value*: 0 - trigger is in OK state, 1 - trigger is in PROBLEM state.| |{TRIGGERS.UNACK}|→ Map element labels|*Number of unacknowledged triggers for a map element, disregarding trigger state.*<br>A trigger is considered to be unacknowledged if at least one of its PROBLEM events is unacknowledged.| |{TRIGGERS.PROBLEM.UNACK}|→ Map element labels|*Number of unacknowledged PROBLEM triggers for a map element.*<br>A trigger is considered to be unacknowledged if at least one of its PROBLEM events is unacknowledged.| |{TRIGGERS.ACK}|→ Map element labels|*Number of acknowledged triggers for a map element, disregarding trigger state.*<br>A trigger is considered to be acknowledged if all of it's PROBLEM events are acknowledged.| |{TRIGGERS.PROBLEM.ACK}|→ Map element labels|*Number of acknowledged PROBLEM triggers for a map element.*<br>A trigger is considered to be acknowledged if all of it's PROBLEM events are acknowledged.| |{USER.FULLNAME}|→ Problem update notifications and commands<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Name, surname and username of the user* who added event acknowledgment or started the script.<br>Supported for problem updates since 3.4.0, for global scripts since 5.0.2| |{USER.NAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Name of the user* who started the script.<br>Supported since 5.0.2.| |{USER.SURNAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Surname of the user* who started the script.<br>Supported since 5.0.2.| |{USER.USERNAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Username of the user* who started the script.<br>Supported since 5.0.2.<br>{USER.ALIAS}, supported before Zabbix 5.4.0, is now deprecated.| |{$MACRO}|→ See: [User macros supported by location](/manual/appendix/macros/supported_by_location_user)|*[User-definable](/manual/config/macros/user_macros) macros.*| |{\#MACRO}|→ See: [Low-level discovery macros](/manual/config/macros/lld_macros)|*Low-level discovery macros.*<br><br>[Customizing](/manual/config/macros/macro_functions) the macro value is supported for this macro, starting with Zabbix 4.0.0.| |{?EXPRESSION}|→ Trigger event names<br>→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels^[3](supported_by_location#footnotes)^<br>→ Map shape labels^[3](supported_by_location#footnotes)^<br>→ Link labels in maps^[3](supported_by_location#footnotes)^<br>→ Graph names^[5](supported_by_location#footnotes)^|*Expression macro* for formula calculations. Calculated by expanding all macros inside and evaluating the resulting expression.<br>See [example](/[[/manual/config/triggers/expression#example_17) of using an expression macro in the event name.<br>Supported since 5.2.0.| #### Overview The table contains a complete list of macros supported by Zabbix out-of-the-box. ::: notetip To see all macros supported in a location (for example, in "map URL"), you may paste the location name into the search box at the bottom of your browser window (accessible by pressing CTRL+F) and do a search for *next*. ::: |Macro|Supported in|Description| |-----|------------|-----------| |{ACTION.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications|*Numeric ID of the triggered action.*| |{ACTION.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications|*Name of the triggered action.*| |{ALERT.MESSAGE}|→ Alert script parameters|*'Default message' value from action configuration.*<br>Supported since 3.0.0.| |{ALERT.SENDTO}|→ Alert script parameters|*'Send to' value from user media configuration.*<br>Supported since 3.0.0.| |{ALERT.SUBJECT}|→ Alert script parameters|*'Default subject' value from action configuration.*<br>Supported since 3.0.0.| |{DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Current date in yyyy.mm.dd. format.*| |{DISCOVERY.DEVICE.IPADDRESS}|→ Discovery notifications and commands|*IP address of the discovered device.*<br>Available always, does not depend on host being added.| |{DISCOVERY.DEVICE.DNS}|→ Discovery notifications and commands|*DNS name of the discovered device.*<br>Available always, does not depend on host being added.| |{DISCOVERY.DEVICE.STATUS}|→ Discovery notifications and commands|*Status of the discovered device*: can be either UP or DOWN.| |{DISCOVERY.DEVICE.UPTIME}|→ Discovery notifications and commands|*Time since the last change of discovery status for a particular device*, with precision down to a second.<br>For example: 1h 29m 01s.<br>For devices with status DOWN, this is the period of their downtime.| |{DISCOVERY.RULE.NAME}|→ Discovery notifications and commands|*Name of the discovery rule that discovered the presence or absence of the device or service.*| |{DISCOVERY.SERVICE.NAME}|→ Discovery notifications and commands|*Name of the service that was discovered.*<br>For example: HTTP.| |{DISCOVERY.SERVICE.PORT}|→ Discovery notifications and commands|*Port of the service that was discovered.*<br>For example: 80.| |{DISCOVERY.SERVICE.STATUS}|→ Discovery notifications and commands|*Status of the discovered <service://> can be either UP or DOWN. \| \|{DISCOVERY.SERVICE.UPTIME} \|→ Discovery notifications and commands \|*Time since the last change of discovery status for a particular service*, with precision down to a second.<br>For example: 1h 29m 01s.<br>For services with status DOWN, this is the period of their downtime. \| \|{ESC.HISTORY} \|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Internal notifications \|*Escalation history. Log of previously sent messages.*<br>Shows previously sent notifications, on which escalation step they were sent and their status (*sent//, *in progress* or *failed*).| |{EVENT.ACK.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Acknowledgment status of the event (Yes/No)*.| |{EVENT.AGE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Age of the event that triggered an action*, with precision down to a second.<br>Useful in escalated messages.| |{EVENT.DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Date of the event that triggered an action.*| |{EVENT.DURATION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Duration of the event (time difference between problem and recovery events)*, with precision down to a second.<br>Useful in problem recovery messages.<br><br>Supported since 5.0.0.| |{EVENT.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric ID of the event that triggered an action.*| |{EVENT.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the problem event that triggered an action.*<br>Supported since 4.0.0.| |{EVENT.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of the event severity.* Possible values: 0 - Not classified, 1 - Information, 2 - Warning, 3 - Average, 4 - High, 5 - Disaster.<br>Supported since 4.0.0.| |{EVENT.OBJECT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of of the event object.* Possible values: 0 - Trigger, 1 - Discovered host, 2 - Discovered service, 3 - Autoregistration, 4 - Item, 5 - Low-level discovery rule.<br>Supported since 4.4.0.| |{EVENT.OPDATA}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Operational data of the underlying trigger of a problem.*<br>Supported since 4.4.0.| |{EVENT.RECOVERY.DATE}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Date of the recovery event.*| |{EVENT.RECOVERY.ID}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Numeric ID of the recovery event.*| |{EVENT.RECOVERY.NAME}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Name of the recovery event.*<br>Supported since 4.4.1.| |{EVENT.RECOVERY.STATUS}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Verbal value of the recovery event.*| |{EVENT.RECOVERY.TAGS}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*A comma separated list of recovery event tags.* Expanded to an empty string if no tags exist.<br>Supported since 3.2.0.| |{EVENT.RECOVERY.TAGSJSON}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*A JSON array containing event tag [objects](/manual/api/reference/event/object#event_tag).* Expanded to an empty array if no tags exist.<br>Supported since 5.0.0.| |{EVENT.RECOVERY.TIME}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Time of the recovery event.*| |{EVENT.RECOVERY.VALUE}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Numeric value of the recovery event.*| |{EVENT.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the event severity.*<br>Supported since 4.0.0.| |{EVENT.SOURCE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of the event source.* Possible values: 0 - Trigger, 1 - Discovery, 2 - Autoregistration, 3 - Internal.<br>Supported since 4.4.0.| |{EVENT.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Verbal value of the event that triggered an action.*| |{EVENT.TAGS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A comma separated list of event tags.* Expanded to an empty string if no tags exist.<br>Supported since 3.2.0.| |{EVENT.TAGSJSON}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A JSON array containing event tag [objects](/manual/api/reference/event/object#event_tag).* Expanded to an empty array if no tags exist.<br>Supported since 5.0.0.| |{EVENT.TAGS.<tag name>}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Webhook media type URL names and URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Event tag value referenced by the tag name.*<br>A tag name containing non-alphanumeric characters (including non-English multibyte-UTF characters) should be double quoted. Quotes and backslashes inside a quoted tag name must be escaped with a backslash.<br>Supported since 4.4.2.| |{EVENT.TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Time of the event that triggered an action.*| |{EVENT.UPDATE.ACTION}|→ Problem update notifications and commands|*Human-readable name of the action(s)* performed during [problem update](/manual/acknowledges#updating_problems).<br>Resolves to the following values: *acknowledged*, *commented*, *changed severity from (original severity) to (updated severity)* and *closed* (depending on how many actions are performed in one update).<br>Supported since 4.0.0.| |{EVENT.UPDATE.DATE}|→ Problem update notifications and commands<br>→ Service update notifications and commands|*Date of event [update](/manual/config/notifications/action/update_operations) (acknowledgment, etc).*<br>Deprecated name: {ACK.DATE}| |{EVENT.UPDATE.HISTORY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Log of problem updates (acknowledgments, etc).*<br>Deprecated name: {EVENT.ACK.HISTORY}| |{EVENT.UPDATE.MESSAGE}|→ Problem update notifications and commands|*Problem update message.*<br>Deprecated name: {ACK.MESSAGE}| |{EVENT.UPDATE.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of of the problem update status.* Possible values: 0 - Webhook was called because of problem/recovery event, 1 - Update operation.<br>Supported since 4.4.0.| |{EVENT.UPDATE.TIME}|→ Problem update notifications and commands<br>→ Service update notifications and commands|*Time of event [update](/manual/config/notifications/action/update_operations) (acknowledgment, etc).*<br>Deprecated name: {ACK.TIME}| |{EVENT.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of the event that triggered an action (1 for problem, 0 for recovering).*| |{FUNCTION.VALUE<1-9>}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Event names|*Results of the Nth item-based function in the trigger expression at the time of the event.*<br>Only functions with */host/key* as the first parameter are counted. See [indexed macros](supported_by_location#indexed_macros).| |{FUNCTION.RECOVERY.VALUE<1-9>}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Results of the Nth item-based function in the recovery expression at the time of the event.*<br>Only functions with */host/key* as the first parameter are counted. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.CONN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Host IP address or DNS name, depending on host settings*^[2](supported_by_location#footnotes)^.<br><br>May be used with a numeric index as {HOST.CONN[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Host description.*<br><br>This macro may be used with a numeric index e.g. {HOST.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.DNS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Host DNS name*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.DNS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.HOST}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Item key parameters<br>→ Map element labels, map URL names and values<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Host name.*<br><br>This macro may be used with a numeric index e.g. {HOST.HOST[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{HOSTNAME<1-9>}` is deprecated.| |{HOST.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Host ID.*<br><br>May be used with a numeric index as {HOST.ID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.IP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Host IP address*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.IP[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{IPADDRESS<1-9>}` is deprecated.| |{HOST.METADATA}|→ Autoregistration notifications and commands|*Host metadata.*<br>Used only for active agent autoregistration.| |{HOST.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Visible host name.*<br><br>This macro may be used with a numeric index e.g. {HOST.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.PORT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ JMX item endpoint field<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Host (agent) port*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.PORT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.TARGET.CONN}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|IP address or DNS name of the target host, depending on host settings.<br>Supported since 5.4.0.| |{HOST.TARGET.DNS}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|DNS name of the target host.<br>Supported since 5.4.0.| |{HOST.TARGET.HOST}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|Technical name of the target host.<br>Supported since 5.4.0.| |{HOST.TARGET.IP}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|IP address of the target host.<br>Supported since 5.4.0.| |{HOST.TARGET.NAME}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|Visible name of the target host.<br>Supported since 5.4.0.| |{HOSTGROUP.ID}|→ Map element labels, map URL names and values|*Host group ID.*| |{INVENTORY.ALIAS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Alias field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.ALIAS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.ASSET.TAG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Asset tag field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.ASSET.TAG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.CHASSIS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Chassis field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CHASSIS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.CONTACT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Contact field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CONTACT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.CONTACT<1-9>}` is deprecated.| |{INVENTORY.CONTRACT.NUMBER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Contract number field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CONTRACT.NUMBER[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.DEPLOYMENT.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Deployment status field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.DEPLOYMENT.STATUS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HARDWARE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Hardware field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HARDWARE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.HARDWARE<1-9>}` is deprecated.| |{INVENTORY.HARDWARE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Hardware (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HARDWARE.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HOST.NETMASK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Host subnet mask field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.NETMASK[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HOST.NETWORKS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Host networks field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.NETWORKS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HOST.ROUTER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Host router field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.ROUTER[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.ARCH}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Hardware architecture field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.ARCH[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.DECOMM}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Date hardware decommissioned field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.DECOMM[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.EXPIRY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Date hardware maintenance expires field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.EXPIRY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.INSTALL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Date hardware installed field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.INSTALL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.PURCHASE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Date hardware purchased field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.PURCHASE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.INSTALLER.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Installer name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.INSTALLER.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.LOCATION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Location field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.LOCATION<1-9>}` is deprecated.| |{INVENTORY.LOCATION.LAT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Location latitude field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION.LAT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.LOCATION.LON}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Location longitude field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION.LON[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.MACADDRESS.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*MAC address A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MACADDRESS.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.MACADDRESS<1-9>}` is deprecated.| |{INVENTORY.MACADDRESS.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*MAC address B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MACADDRESS.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.MODEL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Model field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MODEL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.NAME<1-9>}` is deprecated.| |{INVENTORY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.NOTES<1-9>}` is deprecated.| |{INVENTORY.OOB.IP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*OOB IP address field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.IP[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OOB.NETMASK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*OOB subnet mask field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.NETMASK[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OOB.ROUTER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*OOB router field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.ROUTER[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*OS field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.OS<1-9>}` is deprecated.| |{INVENTORY.OS.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*OS (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OS.SHORT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*OS (Short) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS.SHORT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.CELL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Primary POC cell field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.CELL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.EMAIL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Primary POC email field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.EMAIL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Primary POC name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Primary POC notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.PHONE.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Primary POC phone A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.PHONE.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.PHONE.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Primary POC phone B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.PHONE.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.SCREEN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Primary POC screen name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.SCREEN[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.CELL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Secondary POC cell field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.CELL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.EMAIL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Secondary POC email field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.EMAIL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Secondary POC name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Secondary POC notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.PHONE.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Secondary POC phone A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.PHONE.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.PHONE.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Secondary POC phone B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.PHONE.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.SCREEN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Secondary POC screen name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.SCREEN[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SERIALNO.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Serial number A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SERIALNO.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.SERIALNO<1-9>}` is deprecated.| |{INVENTORY.SERIALNO.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Serial number B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SERIALNO.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ADDRESS.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Site address A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ADDRESS.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Site address B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ADDRESS.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Site address C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.C[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.CITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Site city field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.CITY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.COUNTRY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Site country field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.COUNTRY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Site notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.RACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Site rack location field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.RACK[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.STATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Site state/province field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.STATE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ZIP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Site ZIP/postal field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ZIP[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Software field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.SOFTWARE<1-9>}` is deprecated.| |{INVENTORY.SOFTWARE.APP.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Software application A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Software application B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Software application C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.C[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.D}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Software application D field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.D[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.E}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Software application E field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.E[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Software (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.TAG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Tag field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TAG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.TAG<1-9>}` is deprecated.| |{INVENTORY.TYPE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Type field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TYPE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.DEVICETYPE<1-9>}` is deprecated.| |{INVENTORY.TYPE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Type (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TYPE.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.URL.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*URL A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.URL.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*URL B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.URL.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*URL C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.C[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.VENDOR}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Vendor field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.VENDOR[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Description of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.DESCRIPTION.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Description (with macros unresolved) of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>Supported since 5.2.0.| |{ITEM.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script type item, item prototype and discovery rule parameter names and values^[6](supported_by_location#footnotes)^<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric ID of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.ID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.KEY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script type item, item prototype and discovery rule parameter names and values^[6](supported_by_location#footnotes)^<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Key of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.KEY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{TRIGGER.KEY}` is deprecated.| |{ITEM.KEY.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script type item, item prototype and discovery rule parameter names and values^[6](supported_by_location#footnotes)^<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.^[6](supported_by_location#footnotes)^<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Original key (with macros not expanded) of the Nth item in the trigger expression that caused a notification ^[4](supported_by_location#footnotes)^.*<br><br>This macro may be used with a numeric index e.g. {ITEM.KEY.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LASTVALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, event names, operational data and descriptions<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Trigger URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*The latest value of the Nth item in the trigger expression that caused a notification.*<br>It will resolve to \*UNKNOWN\* in the frontend if the latest history value has been collected more than the *Max history display period* time ago (set in the [Administration→General](/manual/web_interface/frontend_sections/administration/general#gui) menu section).<br>Note that since 4.0, when used in the problem name, it will not resolve to the latest item value when viewing problem events, instead it will keep the item value from the time of problem happening.<br>It is alias to `last(/{HOST.HOST}/{ITEM.KEY})`.<br>[Customizing](/manual/config/macros/macro_functions) the macro value is supported for this macro; starting with Zabbix 3.2.0.<br><br>This macro may be used with a numeric index e.g. {ITEM.LASTVALUE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. item in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.AGE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Age of the log item event*, with precision down to a second.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.AGE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Date of the log item event.*<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.DATE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.EVENTID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*ID of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.EVENTID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric severity of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.NSEVERITY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Verbal severity of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.SEVERITY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.SOURCE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Source of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.SOURCE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Time of the log item event.*<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.TIME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the Nth item (with macros resolved) in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.NAME.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Original name (i.e. without macros resolved) of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.NAME.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.STATE}|→ Item-based internal notifications|*The latest state of the Nth item in the trigger expression that caused a notification.* Possible values: **Not supported** and **Normal**.<br><br>This macro may be used with a numeric index e.g. {ITEM.STATE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, event names, operational data and descriptions<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Trigger URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|Resolved to either:<br>1) the historical (at-the-time-of-event) value of the Nth item in the trigger expression, if used in the context of trigger status change, for example, when displaying events or sending notifications.<br>2) the latest value of the Nth item in the trigger expression, if used without the context of trigger status change, for example, when displaying a list of triggers in a pop-up selection window. In this case works the same as {ITEM.LASTVALUE}<br>In the first case it will resolve to \*UNKNOWN\* if the history value has already been deleted or has never been stored.<br>In the second case, and in the frontend only, it will resolve to \*UNKNOWN\* if the latest history value has been collected more than the *Max history display period* time ago (set in the [Administration→General](/manual/web_interface/frontend_sections/administration/general#gui) menu section).<br><br>[Customizing](/manual/config/macros/macro_functions) the macro value is supported for this macro, starting with Zabbix 3.2.0.<br><br>This macro may be used with a numeric index e.g. {ITEM.VALUE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. item in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.VALUETYPE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Value type of the Nth item in the trigger expression that caused a notification.* Possible values: 0 - numeric float, 1 - character, 2 - log, 3 - numeric unsigned, 4 - text.<br><br>This macro may be used with a numeric index e.g. {ITEM.VALUETYPE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>Supported since 5.4.0.| |{LLDRULE.DESCRIPTION}|→ LLD-rule based internal notifications|*Description of the low-level discovery rule which caused a notification.*| |{LLDRULE.DESCRIPTION.ORIG}|→ LLD-rule based internal notifications|*Description (with macros unresolved) of the low-level discovery rule which caused a notification.*<br>Supported since 5.2.0.| |{LLDRULE.ID}|→ LLD-rule based internal notifications|*Numeric ID of the low-level discovery rule which caused a notification.*| |{LLDRULE.KEY}|→ LLD-rule based internal notifications|*Key of the low-level discovery rule which caused a notification.*| |{LLDRULE.KEY.ORIG}|→ LLD-rule based internal notifications|*Original key (with macros not expanded) of the low-level discovery rule which caused a notification.*| |{LLDRULE.NAME}|→ LLD-rule based internal notifications|*Name of the low-level discovery rule (with macros resolved) that caused a notification.*| |{LLDRULE.NAME.ORIG}|→ LLD-rule based internal notifications|*Original name (i.e. without macros resolved) of the low-level discovery rule that caused a notification.*| |{LLDRULE.STATE}|→ LLD-rule based internal notifications|*The latest state of the low-level discovery rule.* Possible values: **Not supported** and **Normal**.| |{MAP.ID}|→ Map element labels, map URL names and values|*Network map ID.*| |{MAP.NAME}|→ Map element labels, map URL names and values<br>→ Text field in map shapes|*Network map name.*<br>Supported since 3.4.0.| |{PROXY.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Description of the proxy*. Resolves to either:<br>1) proxy of the Nth item in the trigger expression (in trigger-based notifications). You may use [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) macros here.<br>2) proxy, which executed discovery (in discovery notifications). Use {PROXY.DESCRIPTION} here, without indexing.<br>3) proxy to which an active agent registered (in autoregistration notifications). Use {PROXY.DESCRIPTION} here, without indexing.<br><br>This macro may be used with a numeric index e.g. {PROXY.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{PROXY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the proxy*. Resolves to either:<br>1) proxy of the Nth item in the trigger expression (in trigger-based notifications). You may use [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) macros here.<br>2) proxy, which executed discovery (in discovery notifications). Use {PROXY.NAME} here, without indexing.<br>3) proxy to which an active agent registered (in autoregistration notifications). Use {PROXY.NAME} here, without indexing.<br><br>This macro may be used with a numeric index e.g. {PROXY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{SERVICE.NAME}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*Name of the service* (with macros resolved).| |{SERVICE.ROOTCAUSE}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*List of trigger problem events that caused a service to fail*, sorted by severity and host name. Includes the following details: host name, event name, severity, age, service tags and values.| |{SERVICE.TAGS}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*A comma separated list of service event tags.* Service event tags can be defined in the service configuration section Tags. Expanded to an empty string if no tags exist.| |{SERVICE.TAGSJSON}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*A JSON array containing service event tag objects.* Service event tags can be defined in the service configuration section Tags. Expanded to an empty array if no tags exist.| |{SERVICE.TAGS.<tag name>}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*Service event tag value referenced by the tag name.* Service event tags can be defined in the service configuration section Tags.<br>A tag name containing non-alphanumeric characters (including non-English multibyte-UTF characters) should be double quoted. Quotes and backslashes inside a quoted tag name must be escaped with a backslash.| |{TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger event names<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Current time in hh:mm:ss.*| |{TRIGGER.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger description.*<br>All macros supported in a trigger description will be expanded if `{TRIGGER.DESCRIPTION}` is used in notification text.<br>`{TRIGGER.COMMENT}` is deprecated.| |{TRIGGER.EXPRESSION.EXPLAIN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Event names|*Partially evaluated trigger expression.*<br>Item-based functions are evaluated and replaced by the results at the time of event generation whereas all other functions are displayed as written in the expression. Can be used for debugging trigger expressions.| |{TRIGGER.EXPRESSION.RECOVERY.EXPLAIN}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Partially evaluated trigger recovery expression.*<br>Item-based functions are evaluated and replaced by the results at the time of event generation whereas all other functions are displayed as written in the expression. Can be used for debugging trigger recovery expressions.| |{TRIGGER.EVENTS.ACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of acknowledged events for a map element in maps, or for the trigger which generated current event in notifications.*| |{TRIGGER.EVENTS.PROBLEM.ACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of acknowledged PROBLEM events for all triggers disregarding their state.*| |{TRIGGER.EVENTS.PROBLEM.UNACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of unacknowledged PROBLEM events for all triggers disregarding their state.*| |{TRIGGER.EVENTS.UNACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of unacknowledged events for a map element in maps, or for the trigger which generated current event in notifications.*| |{TRIGGER.HOSTGROUP.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A sorted (by SQL query), comma-space separated list of host groups in which the trigger is defined.*| |{TRIGGER.PROBLEM.EVENTS.PROBLEM.ACK}|→ Map element labels|*Number of acknowledged PROBLEM events for triggers in PROBLEM state.*| |{TRIGGER.PROBLEM.EVENTS.PROBLEM.UNACK}|→ Map element labels|*Number of unacknowledged PROBLEM events for triggers in PROBLEM state.*| |{TRIGGER.EXPRESSION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger expression.*| |{TRIGGER.EXPRESSION.RECOVERY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger recovery expression* if *OK event generation* in [trigger configuration](/manual/config/triggers/trigger) is set to 'Recovery expression'; otherwise an empty string is returned.<br>Supported since 3.2.0.| |{TRIGGER.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Map element labels, map URL names and values<br>→ Trigger URLs<br>→ Trigger tag value<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric trigger ID which triggered this action.*<br>Supported in trigger tag values since 4.4.1.| |{TRIGGER.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the trigger* (with macros resolved).<br>Note that since 4.0.0 {EVENT.NAME} can be used in actions to display the triggered event/problem name with macros resolved.| |{TRIGGER.NAME.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Original name of the trigger* (i.e. without macros resolved).| |{TRIGGER.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numerical trigger severity.* Possible values: 0 - Not classified, 1 - Information, 2 - Warning, 3 - Average, 4 - High, 5 - Disaster.| |{TRIGGER.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger severity name.* Can be defined in *Administration → General → Trigger displaying options*.| |{TRIGGER.STATE}|→ Trigger-based internal notifications|*The latest state of the trigger.* Possible values: **Unknown** and **Normal**.| |{TRIGGER.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Current trigger value.* Can be either PROBLEM or OK.<br>`{STATUS}` is deprecated.| |{TRIGGER.TEMPLATE.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A sorted (by SQL query), comma-space separated list of templates in which the trigger is defined, or \*UNKNOWN\* if the trigger is defined in a host.*| |{TRIGGER.URL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger URL.*| |{TRIGGER.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger expressions<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Current trigger numeric value*: 0 - trigger is in OK state, 1 - trigger is in PROBLEM state.| |{TRIGGERS.UNACK}|→ Map element labels|*Number of unacknowledged triggers for a map element, disregarding trigger state.*<br>A trigger is considered to be unacknowledged if at least one of its PROBLEM events is unacknowledged.| |{TRIGGERS.PROBLEM.UNACK}|→ Map element labels|*Number of unacknowledged PROBLEM triggers for a map element.*<br>A trigger is considered to be unacknowledged if at least one of its PROBLEM events is unacknowledged.| |{TRIGGERS.ACK}|→ Map element labels|*Number of acknowledged triggers for a map element, disregarding trigger state.*<br>A trigger is considered to be acknowledged if all of it's PROBLEM events are acknowledged.| |{TRIGGERS.PROBLEM.ACK}|→ Map element labels|*Number of acknowledged PROBLEM triggers for a map element.*<br>A trigger is considered to be acknowledged if all of it's PROBLEM events are acknowledged.| |{USER.FULLNAME}|→ Problem update notifications and commands<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Name, surname and username of the user* who added event acknowledgment or started the script.<br>Supported for problem updates since 3.4.0, for global scripts since 5.0.2| |{USER.NAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Name of the user* who started the script.<br>Supported since 5.0.2.| |{USER.SURNAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Surname of the user* who started the script.<br>Supported since 5.0.2.| |{USER.USERNAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Username of the user* who started the script.<br>Supported since 5.0.2.<br>{USER.ALIAS}, supported before Zabbix 5.4.0, is now deprecated.| |{$MACRO}|→ See: [User macros supported by location](/manual/appendix/macros/supported_by_location_user)|*[User-definable](/manual/config/macros/user_macros) macros.*| |{\#MACRO}|→ See: [Low-level discovery macros](/manual/config/macros/lld_macros)|*Low-level discovery macros.*<br><br>[Customizing](/manual/config/macros/macro_functions) the macro value is supported for this macro, starting with Zabbix 4.0.0.| |{?EXPRESSION}|→ Trigger event names<br>→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels^[3](supported_by_location#footnotes)^<br>→ Map shape labels^[3](supported_by_location#footnotes)^<br>→ Link labels in maps^[3](supported_by_location#footnotes)^<br>→ Graph names^[5](supported_by_location#footnotes)^|*Expression macro* for formula calculations. Calculated by expanding all macros inside and evaluating the resulting expression.<br>See [example](/[[/manual/config/triggers/expression#example_17) of using an expression macro in the event name.<br>Supported since 5.2.0.| #### Overview The table contains a complete list of macros supported by Zabbix out-of-the-box. ::: notetip To see all macros supported in a location (for example, in "map URL"), you may paste the location name into the search box at the bottom of your browser window (accessible by pressing CTRL+F) and do a search for *next*. ::: |Macro|Supported in|Description| |--|------|------| |{ACTION.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications|*Numeric ID of the triggered action.*| |{ACTION.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications|*Name of the triggered action.*| |{ALERT.MESSAGE}|→ Alert script parameters|*'Default message' value from action configuration.*<br>Supported since 3.0.0.| |{ALERT.SENDTO}|→ Alert script parameters|*'Send to' value from user media configuration.*<br>Supported since 3.0.0.| |{ALERT.SUBJECT}|→ Alert script parameters|*'Default subject' value from action configuration.*<br>Supported since 3.0.0.| |{DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Current date in yyyy.mm.dd. format.*| |{DISCOVERY.DEVICE.IPADDRESS}|→ Discovery notifications and commands|*IP address of the discovered device.*<br>Available always, does not depend on host being added.| |{DISCOVERY.DEVICE.DNS}|→ Discovery notifications and commands|*DNS name of the discovered device.*<br>Available always, does not depend on host being added.| |{DISCOVERY.DEVICE.STATUS}|→ Discovery notifications and commands|*Status of the discovered device*: can be either UP or DOWN.| |{DISCOVERY.DEVICE.UPTIME}|→ Discovery notifications and commands|*Time since the last change of discovery status for a particular device*, with precision down to a second.<br>For example: 1h 29m 01s.<br>For devices with status DOWN, this is the period of their downtime.| |{DISCOVERY.RULE.NAME}|→ Discovery notifications and commands|*Name of the discovery rule that discovered the presence or absence of the device or service.*| |{DISCOVERY.SERVICE.NAME}|→ Discovery notifications and commands|*Name of the service that was discovered.*<br>For example: HTTP.| |{DISCOVERY.SERVICE.PORT}|→ Discovery notifications and commands|*Port of the service that was discovered.*<br>For example: 80.| |{DISCOVERY.SERVICE.STATUS}|→ Discovery notifications and commands|*Status of the discovered <service://> can be either UP or DOWN. \| \|{DISCOVERY.SERVICE.UPTIME} \|→ Discovery notifications and commands \|*Time since the last change of discovery status for a particular service*, with precision down to a second.<br>For example: 1h 29m 01s.<br>For services with status DOWN, this is the period of their downtime. \| \|{ESC.HISTORY} \|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Internal notifications \|*Escalation history. Log of previously sent messages.*<br>Shows previously sent notifications, on which escalation step they were sent and their status (*sent*, *in progress* or *failed*).| |{EVENT.ACK.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Acknowledgment status of the event (Yes/No)*.| |{EVENT.AGE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Age of the event that triggered an action*, with precision down to a second.<br>Useful in escalated messages.| |{EVENT.DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Date of the event that triggered an action.*| |{EVENT.DURATION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Duration of the event (time difference between problem and recovery events)*, with precision down to a second.<br>Useful in problem recovery messages.<br><br>Supported since 5.0.0.| |{EVENT.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric ID of the event that triggered an action.*| |{EVENT.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the problem event that triggered an action.*<br>Supported since 4.0.0.| |{EVENT.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of the event severity.* Possible values: 0 - Not classified, 1 - Information, 2 - Warning, 3 - Average, 4 - High, 5 - Disaster.<br>Supported since 4.0.0.| |{EVENT.OBJECT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of the event object.* Possible values: 0 - Trigger, 1 - Discovered host, 2 - Discovered service, 3 - Autoregistration, 4 - Item, 5 - Low-level discovery rule.<br>Supported since 4.4.0.| |{EVENT.OPDATA}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Operational data of the underlying trigger of a problem.*<br>Supported since 4.4.0.| |{EVENT.RECOVERY.DATE}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Date of the recovery event.*| |{EVENT.RECOVERY.ID}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Numeric ID of the recovery event.*| |{EVENT.RECOVERY.NAME}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Name of the recovery event.*<br>Supported since 4.4.1.| |{EVENT.RECOVERY.STATUS}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Verbal value of the recovery event.*| |{EVENT.RECOVERY.TAGS}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*A comma separated list of recovery event tags.* Expanded to an empty string if no tags exist.<br>Supported since 3.2.0.| |{EVENT.RECOVERY.TAGSJSON}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*A JSON array containing event tag [objects](/manual/api/reference/event/object#event_tag).* Expanded to an empty array if no tags exist.<br>Supported since 5.0.0.| |{EVENT.RECOVERY.TIME}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Time of the recovery event.*| |{EVENT.RECOVERY.VALUE}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands (if recovery took place)<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (if recovery took place)|*Numeric value of the recovery event.*| |{EVENT.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the event severity.*<br>Supported since 4.0.0.| |{EVENT.SOURCE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of the event source.* Possible values: 0 - Trigger, 1 - Discovery, 2 - Autoregistration, 3 - Internal.<br>Supported since 4.4.0.| |{EVENT.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Verbal value of the event that triggered an action.*| |{EVENT.TAGS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A comma separated list of event tags.* Expanded to an empty string if no tags exist.<br>Supported since 3.2.0.| |{EVENT.TAGSJSON}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A JSON array containing event tag [objects](/manual/api/reference/event/object#event_tag).* Expanded to an empty array if no tags exist.<br>Supported since 5.0.0.| |{EVENT.TAGS.<tag name>}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Webhook media type URL names and URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Event tag value referenced by the tag name.*<br>A tag name containing non-alphanumeric characters (including non-English multibyte-UTF characters) should be double quoted. Quotes and backslashes inside a quoted tag name must be escaped with a backslash.<br>Supported since 4.4.2.| |{EVENT.TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Time of the event that triggered an action.*| |{EVENT.UPDATE.ACTION}|→ Problem update notifications and commands|*Human-readable name of the action(s)* performed during [problem update](/manual/acknowledges#updating_problems).<br>Resolves to the following values: *acknowledged*, *commented*, *changed severity from (original severity) to (updated severity)* and *closed* (depending on how many actions are performed in one update).<br>Supported since 4.0.0.| |{EVENT.UPDATE.DATE}|→ Problem update notifications and commands<br>→ Service update notifications and commands|*Date of event [update](/manual/config/notifications/action/update_operations) (acknowledgment, etc).*<br>Deprecated name: {ACK.DATE}| |{EVENT.UPDATE.HISTORY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Log of problem updates (acknowledgments, etc).*<br>Deprecated name: {EVENT.ACK.HISTORY}| |{EVENT.UPDATE.MESSAGE}|→ Problem update notifications and commands|*Problem update message.*<br>Deprecated name: {ACK.MESSAGE}| |{EVENT.UPDATE.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of the problem update status.* Possible values: 0 - Webhook was called because of problem/recovery event, 1 - Update operation.<br>Supported since 4.4.0.| |{EVENT.UPDATE.TIME}|→ Problem update notifications and commands<br>→ Service update notifications and commands|*Time of event [update](/manual/config/notifications/action/update_operations) (acknowledgment, etc).*<br>Deprecated name: {ACK.TIME}| |{EVENT.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Service recovery notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric value of the event that triggered an action (1 for problem, 0 for recovering).*| |{FUNCTION.VALUE<1-9>}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Event names|*Results of the Nth item-based function in the trigger expression at the time of the event.*<br>Only functions with */host/key* as the first parameter are counted. See [indexed macros](supported_by_location#indexed_macros).| |{FUNCTION.RECOVERY.VALUE<1-9>}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Results of the Nth item-based function in the recovery expression at the time of the event.*<br>Only functions with */host/key* as the first parameter are counted. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.CONN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Description of item value widget|*Host IP address or DNS name, depending on host settings*^[2](supported_by_location#footnotes)^.<br><br>May be used with a numeric index as {HOST.CONN[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host description.*<br><br>This macro may be used with a numeric index e.g. {HOST.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.DNS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Description of item value widget|*Host DNS name*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.DNS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.HOST}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Item key parameters<br>→ Map element labels, map URL names and values<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Description of item value widget|*Host name.*<br><br>This macro may be used with a numeric index e.g. {HOST.HOST[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{HOSTNAME<1-9>}` is deprecated.| |{HOST.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host ID.*<br><br>May be used with a numeric index as {HOST.ID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.IP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Description of item value widget|*Host IP address*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.IP[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{IPADDRESS<1-9>}` is deprecated.| |{HOST.METADATA}|→ Autoregistration notifications and commands|*Host metadata.*<br>Used only for active agent autoregistration.| |{HOST.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Description of item value widget|*Visible host name.*<br><br>This macro may be used with a numeric index e.g. {HOST.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.PORT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ JMX item endpoint field<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host (agent) port*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.PORT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.TARGET.CONN}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|IP address or DNS name of the target host, depending on host settings.<br>Supported since 5.4.0.| |{HOST.TARGET.DNS}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|DNS name of the target host.<br>Supported since 5.4.0.| |{HOST.TARGET.HOST}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|Technical name of the target host.<br>Supported since 5.4.0.| |{HOST.TARGET.IP}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|IP address of the target host.<br>Supported since 5.4.0.| |{HOST.TARGET.NAME}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|Visible name of the target host.<br>Supported since 5.4.0.| |{HOSTGROUP.ID}|→ Map element labels, map URL names and values|*Host group ID.*| |{INVENTORY.ALIAS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Alias field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.ALIAS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.ASSET.TAG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Asset tag field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.ASSET.TAG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.CHASSIS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Chassis field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CHASSIS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.CONTACT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Contact field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CONTACT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.CONTACT<1-9>}` is deprecated.| |{INVENTORY.CONTRACT.NUMBER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Contract number field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.CONTRACT.NUMBER[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.DEPLOYMENT.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Deployment status field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.DEPLOYMENT.STATUS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HARDWARE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Hardware field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HARDWARE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.HARDWARE<1-9>}` is deprecated.| |{INVENTORY.HARDWARE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Hardware (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HARDWARE.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HOST.NETMASK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host subnet mask field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.NETMASK[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HOST.NETWORKS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host networks field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.NETWORKS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HOST.ROUTER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Host router field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HOST.ROUTER[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.ARCH}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Hardware architecture field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.ARCH[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.DECOMM}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Date hardware decommissioned field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.DECOMM[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.EXPIRY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Date hardware maintenance expires field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.EXPIRY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.INSTALL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Date hardware installed field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.INSTALL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.HW.DATE.PURCHASE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Date hardware purchased field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.HW.DATE.PURCHASE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.INSTALLER.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Installer name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.INSTALLER.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.LOCATION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Location field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.LOCATION<1-9>}` is deprecated.| |{INVENTORY.LOCATION.LAT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Location latitude field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION.LAT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.LOCATION.LON}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Location longitude field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.LOCATION.LON[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.MACADDRESS.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*MAC address A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MACADDRESS.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.MACADDRESS<1-9>}` is deprecated.| |{INVENTORY.MACADDRESS.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*MAC address B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MACADDRESS.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.MODEL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Model field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.MODEL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.NAME<1-9>}` is deprecated.| |{INVENTORY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.NOTES<1-9>}` is deprecated.| |{INVENTORY.OOB.IP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OOB IP address field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.IP[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OOB.NETMASK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OOB subnet mask field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.NETMASK[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OOB.ROUTER}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OOB router field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OOB.ROUTER[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OS field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.OS<1-9>}` is deprecated.| |{INVENTORY.OS.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OS (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.OS.SHORT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*OS (Short) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.OS.SHORT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.CELL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC cell field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.CELL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.EMAIL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC email field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.EMAIL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.PHONE.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC phone A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.PHONE.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.PHONE.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC phone B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.PHONE.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.PRIMARY.SCREEN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Primary POC screen name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.PRIMARY.SCREEN[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.CELL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC cell field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.CELL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.EMAIL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC email field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.EMAIL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.PHONE.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC phone A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.PHONE.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.PHONE.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC phone B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.PHONE.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.POC.SECONDARY.SCREEN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Secondary POC screen name field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.POC.SECONDARY.SCREEN[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SERIALNO.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Serial number A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SERIALNO.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.SERIALNO<1-9>}` is deprecated.| |{INVENTORY.SERIALNO.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Serial number B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SERIALNO.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ADDRESS.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site address A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ADDRESS.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site address B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ADDRESS.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site address C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ADDRESS.C[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.CITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site city field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.CITY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.COUNTRY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site country field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.COUNTRY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.NOTES}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site notes field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.NOTES[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.RACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site rack location field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.RACK[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.STATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site state/province field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.STATE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SITE.ZIP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Site ZIP/postal field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SITE.ZIP[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.SOFTWARE<1-9>}` is deprecated.| |{INVENTORY.SOFTWARE.APP.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software application A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software application B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software application C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.C[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.D}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software application D field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.D[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.APP.E}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software application E field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.APP.E[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.SOFTWARE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Software (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.SOFTWARE.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.TAG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Tag field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TAG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.TAG<1-9>}` is deprecated.| |{INVENTORY.TYPE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Type field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TYPE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{PROFILE.DEVICETYPE<1-9>}` is deprecated.| |{INVENTORY.TYPE.FULL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Type (Full details) field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.TYPE.FULL[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.URL.A}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*URL A field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.A[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.URL.B}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*URL B field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.B[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.URL.C}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*URL C field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.URL.C[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{INVENTORY.VENDOR}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Map element labels, map URL names and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Vendor field in host inventory.*<br><br>This macro may be used with a numeric index e.g. {INVENTORY.VENDOR[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Description of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.DESCRIPTION.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Description (with macros unresolved) of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>Supported since 5.2.0.| |{ITEM.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script type item, item prototype and discovery rule parameter names and values^[6](supported_by_location#footnotes)^<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Numeric ID of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.ID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.KEY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script type item, item prototype and discovery rule parameter names and values^[6](supported_by_location#footnotes)^<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Key of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.KEY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{TRIGGER.KEY}` is deprecated.| |{ITEM.KEY.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Script type item, item prototype and discovery rule parameter names and values^[6](supported_by_location#footnotes)^<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts.^[6](supported_by_location#footnotes)^<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Original key (with macros not expanded) of the Nth item in the trigger expression that caused a notification ^[4](supported_by_location#footnotes)^.*<br><br>This macro may be used with a numeric index e.g. {ITEM.KEY.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LASTVALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, event names, operational data and descriptions<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Trigger URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*The latest value of the Nth item in the trigger expression that caused a notification.*<br>It will resolve to \*UNKNOWN\* in the frontend if the latest history value has been collected more than the *Max history display period* time ago (set in the [Administration→General](/manual/web_interface/frontend_sections/administration/general#gui) menu section).<br>Note that since 4.0, when used in the problem name, it will not resolve to the latest item value when viewing problem events, instead it will keep the item value from the time of problem happening.<br>It is alias to `last(/{HOST.HOST}/{ITEM.KEY})`.<br><br>The resolved value is truncated to 20 characters to be usable, for example, in trigger URLs. To resolve to a full value, you may use [macro functions](/manual/config/macros/macro_functions#seeing-full-item-values).<br><br>[Customizing](/manual/config/macros/macro_functions) the macro value is supported for this macro; starting with Zabbix 3.2.0.<br><br>This macro may be used with a numeric index e.g. {ITEM.LASTVALUE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. item in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.AGE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Age of the log item event*, with precision down to a second.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.AGE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.DATE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Date of the log item event.*<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.DATE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.EVENTID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*ID of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.EVENTID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Numeric severity of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.NSEVERITY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Verbal severity of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.SEVERITY[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.SOURCE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Source of the event in the event log.*<br>For Windows event log monitoring only.<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.SOURCE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.LOG.TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, operational data and descriptions<br>→ Trigger URLs<br>→ Event tags and values<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Time of the log item event.*<br><br>This macro may be used with a numeric index e.g. {ITEM.LOG.TIME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Name of the Nth item in the trigger expression that caused a notification.*<br><br>This macro may be used with a numeric index e.g. {ITEM.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.NAME.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|This macros is deprecated since Zabbix 6.0. It used to resolve to the *original name (i.e. without macros resolved) of the item* in pre-6.0 Zabbix versions when user macros and positional macros were supported in the item name.<br><br>This macro may be used with a numeric index e.g. {ITEM.NAME.ORIG[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.STATE}|→ Item-based internal notifications<br>→ Description of item value widget|*The latest state of the Nth item in the trigger expression that caused a notification.* Possible values: **Not supported** and **Normal**.<br><br>This macro may be used with a numeric index e.g. {ITEM.STATE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.STATE.ERROR}|→ Item-based internal notifications|*Error message with details why an item became unsupported.* <br> <br> If an item goes into the unsupported state and then immediately gets supported again the error field can be empty.| |{ITEM.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger names, event names, operational data and descriptions<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Trigger URLs<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|Resolved to either:<br>1) the historical (at-the-time-of-event) value of the Nth item in the trigger expression, if used in the context of trigger status change, for example, when displaying events or sending notifications.<br>2) the latest value of the Nth item in the trigger expression, if used without the context of trigger status change, for example, when displaying a list of triggers in a pop-up selection window. In this case works the same as {ITEM.LASTVALUE}<br>In the first case it will resolve to \*UNKNOWN\* if the history value has already been deleted or has never been stored.<br>In the second case, and in the frontend only, it will resolve to \*UNKNOWN\* if the latest history value has been collected more than the *Max history display period* time ago (set in the [Administration→General](/manual/web_interface/frontend_sections/administration/general#gui) menu section).<br><br>The resolved value is truncated to 20 characters to be usable, for example, in trigger URLs. To resolve to a full value, you may use [macro functions](/manual/config/macros/macro_functions#seeing-full-item-values).<br><br>[Customizing](/manual/config/macros/macro_functions) the macro value is supported for this macro, starting with Zabbix 3.2.0.<br><br>This macro may be used with a numeric index e.g. {ITEM.VALUE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. item in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{ITEM.VALUETYPE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Description of item value widget|*Value type of the Nth item in the trigger expression that caused a notification.* Possible values: 0 - numeric float, 1 - character, 2 - log, 3 - numeric unsigned, 4 - text.<br><br>This macro may be used with a numeric index e.g. {ITEM.VALUETYPE[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>Supported since 5.4.0.| |{LLDRULE.DESCRIPTION}|→ LLD-rule based internal notifications|*Description of the low-level discovery rule which caused a notification.*| |{LLDRULE.DESCRIPTION.ORIG}|→ LLD-rule based internal notifications|*Description (with macros unresolved) of the low-level discovery rule which caused a notification.*<br>Supported since 5.2.0.| |{LLDRULE.ID}|→ LLD-rule based internal notifications|*Numeric ID of the low-level discovery rule which caused a notification.*| |{LLDRULE.KEY}|→ LLD-rule based internal notifications|*Key of the low-level discovery rule which caused a notification.*| |{LLDRULE.KEY.ORIG}|→ LLD-rule based internal notifications|*Original key (with macros not expanded) of the low-level discovery rule which caused a notification.*| |{LLDRULE.NAME}|→ LLD-rule based internal notifications|*Name of the low-level discovery rule (with macros resolved) that caused a notification.*| |{LLDRULE.NAME.ORIG}|→ LLD-rule based internal notifications|*Original name (i.e. without macros resolved) of the low-level discovery rule that caused a notification.*| |{LLDRULE.STATE}|→ LLD-rule based internal notifications|*The latest state of the low-level discovery rule.* Possible values: **Not supported** and **Normal**.| |{LLDRULE.STATE.ERROR}|→ LLD-rule based internal notifications|*Error message with details why an LLD rule became unsupported.* <br> <br> If an LLD rule goes into the unsupported state and then immediately gets supported again the error field can be empty.| |{MAP.ID}|→ Map element labels, map URL names and values|*Network map ID.*| |{MAP.NAME}|→ Map element labels, map URL names and values<br>→ Text field in map shapes|*Network map name.*<br>Supported since 3.4.0.| |{PROXY.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Description of the proxy*. Resolves to either:<br>1) proxy of the Nth item in the trigger expression (in trigger-based notifications). You may use [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) macros here.<br>2) proxy, which executed discovery (in discovery notifications). Use {PROXY.DESCRIPTION} here, without indexing.<br>3) proxy to which an active agent registered (in autoregistration notifications). Use {PROXY.DESCRIPTION} here, without indexing.<br><br>This macro may be used with a numeric index e.g. {PROXY.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{PROXY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the proxy*. Resolves to either:<br>1) proxy of the Nth item in the trigger expression (in trigger-based notifications). You may use [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) macros here.<br>2) proxy, which executed discovery (in discovery notifications). Use {PROXY.NAME} here, without indexing.<br>3) proxy to which an active agent registered (in autoregistration notifications). Use {PROXY.NAME} here, without indexing.<br><br>This macro may be used with a numeric index e.g. {PROXY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{SERVICE.DESCRIPTION}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*Description of the service* (with macros resolved).| |{SERVICE.NAME}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*Name of the service* (with macros resolved).| |{SERVICE.ROOTCAUSE}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*List of trigger problem events that caused a service to fail*, sorted by severity and host name. Includes the following details: host name, event name, severity, age, service tags and values.| |{SERVICE.TAGS}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*A comma separated list of service event tags.* Service event tags can be defined in the service configuration section Tags. Expanded to an empty string if no tags exist.| |{SERVICE.TAGSJSON}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*A JSON array containing service event tag objects.* Service event tags can be defined in the service configuration section Tags. Expanded to an empty array if no tags exist.| |{SERVICE.TAGS.<tag name>}|→ Service-based notifications and commands<br>→ Service update notifications and commands|*Service event tag value referenced by the tag name.* Service event tags can be defined in the service configuration section Tags.<br>A tag name containing non-alphanumeric characters (including non-English multibyte-UTF characters) should be double quoted. Quotes and backslashes inside a quoted tag name must be escaped with a backslash.| |{TIME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger event names<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Current time in hh:mm:ss.*| |{TRIGGER.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger description.*<br>All macros supported in a trigger description will be expanded if `{TRIGGER.DESCRIPTION}` is used in notification text.<br>`{TRIGGER.COMMENT}` is deprecated.| |{TRIGGER.EXPRESSION.EXPLAIN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)<br>→ Event names|*Partially evaluated trigger expression.*<br>Item-based functions are evaluated and replaced by the results at the time of event generation whereas all other functions are displayed as written in the expression. Can be used for debugging trigger expressions.| |{TRIGGER.EXPRESSION.RECOVERY.EXPLAIN}|→ Problem [recovery notifications](/manual/config/notifications/action/recovery_operations) and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Partially evaluated trigger recovery expression.*<br>Item-based functions are evaluated and replaced by the results at the time of event generation whereas all other functions are displayed as written in the expression. Can be used for debugging trigger recovery expressions.| |{TRIGGER.EVENTS.ACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of acknowledged events for a map element in maps, or for the trigger which generated current event in notifications.*| |{TRIGGER.EVENTS.PROBLEM.ACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of acknowledged PROBLEM events for all triggers disregarding their state.*| |{TRIGGER.EVENTS.PROBLEM.UNACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of unacknowledged PROBLEM events for all triggers disregarding their state.*| |{TRIGGER.EVENTS.UNACK}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Number of unacknowledged events for a map element in maps, or for the trigger which generated current event in notifications.*| |{TRIGGER.HOSTGROUP.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A sorted (by SQL query), comma-space separated list of host groups in which the trigger is defined.*| |{TRIGGER.PROBLEM.EVENTS.PROBLEM.ACK}|→ Map element labels|*Number of acknowledged PROBLEM events for triggers in PROBLEM state.*| |{TRIGGER.PROBLEM.EVENTS.PROBLEM.UNACK}|→ Map element labels|*Number of unacknowledged PROBLEM events for triggers in PROBLEM state.*| |{TRIGGER.EXPRESSION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger expression.*| |{TRIGGER.EXPRESSION.RECOVERY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger recovery expression* if *OK event generation* in [trigger configuration](/manual/config/triggers/trigger) is set to 'Recovery expression'; otherwise an empty string is returned.<br>Supported since 3.2.0.| |{TRIGGER.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Map element labels, map URL names and values<br>→ Trigger URLs<br>→ Trigger tag value<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numeric trigger ID which triggered this action.*<br>Supported in trigger tag values since 4.4.1.| |{TRIGGER.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Name of the trigger* (with macros resolved).<br>Note that since 4.0.0 {EVENT.NAME} can be used in actions to display the triggered event/problem name with macros resolved.| |{TRIGGER.NAME.ORIG}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Original name of the trigger* (i.e. without macros resolved).| |{TRIGGER.NSEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Numerical trigger severity.* Possible values: 0 - Not classified, 1 - Information, 2 - Warning, 3 - Average, 4 - High, 5 - Disaster.| |{TRIGGER.SEVERITY}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger severity name.* Can be defined in *Administration → General → Trigger displaying options*.| |{TRIGGER.STATE}|→ Trigger-based internal notifications|*The latest state of the trigger.* Possible values: **Unknown** and **Normal**.| |{TRIGGER.STATE.ERROR}|→ Trigger-based internal notifications|*Error message with details why a trigger became unsupported.* <br> <br> If a trigger goes into the unsupported state and then immediately gets supported again the error field can be empty.| |{TRIGGER.STATUS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger value at the time of operation step execution.* Can be either PROBLEM or OK.<br>`{STATUS}` is deprecated.| |{TRIGGER.TEMPLATE.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*A sorted (by SQL query), comma-space separated list of templates in which the trigger is defined, or \*UNKNOWN\* if the trigger is defined in a host.*| |{TRIGGER.URL}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger-based internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Trigger URL.*| |{TRIGGER.VALUE}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Trigger expressions<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Current trigger numeric value*: 0 - trigger is in OK state, 1 - trigger is in PROBLEM state.| |{TRIGGERS.UNACK}|→ Map element labels|*Number of unacknowledged triggers for a map element, disregarding trigger state.*<br>A trigger is considered to be unacknowledged if at least one of its PROBLEM events is unacknowledged.| |{TRIGGERS.PROBLEM.UNACK}|→ Map element labels|*Number of unacknowledged PROBLEM triggers for a map element.*<br>A trigger is considered to be unacknowledged if at least one of its PROBLEM events is unacknowledged.| |{TRIGGERS.ACK}|→ Map element labels|*Number of acknowledged triggers for a map element, disregarding trigger state.*<br>A trigger is considered to be acknowledged if all of it's PROBLEM events are acknowledged.| |{TRIGGERS.PROBLEM.ACK}|→ Map element labels|*Number of acknowledged PROBLEM triggers for a map element.*<br>A trigger is considered to be acknowledged if all of it's PROBLEM events are acknowledged.| |{USER.FULLNAME}|→ Problem update notifications and commands<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Name, surname and username of the user* who added event acknowledgment or started the script.<br>Supported for problem updates since 3.4.0, for global scripts since 5.0.2| |{USER.NAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Name of the user* who started the script.<br>Supported since 5.0.2.| |{USER.SURNAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Surname of the user* who started the script.<br>Supported since 5.0.2.| |{USER.USERNAME}|→ Manual host action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*Username of the user* who started the script.<br>Supported since 5.0.2.<br>{USER.ALIAS}, supported before Zabbix 5.4.0, is now deprecated.| |{$MACRO}|→ See: [User macros supported by location](/manual/appendix/macros/supported_by_location_user)|*[User-definable](/manual/config/macros/user_macros) macros.*| |{\#MACRO}|→ See: [Low-level discovery macros](/manual/config/macros/lld_macros)|*Low-level discovery macros.*<br><br>[Customizing](/manual/config/macros/macro_functions) the macro value is supported for this macro, starting with Zabbix 4.0.0.| |{?EXPRESSION}|→ Trigger event names<br>→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Map element labels^[3](supported_by_location#footnotes)^<br>→ Map shape labels^[3](supported_by_location#footnotes)^<br>→ Link labels in maps^[3](supported_by_location#footnotes)^<br>→ Graph names^[5](supported_by_location#footnotes)^|See [expression macros](/manual/config/macros/expression_macros).<br>Supported since 5.2.0.| #### 概要 この表には、すぐに使用できる Zabbix でサポートされているマクロの完全なリストが含まれています。 ::: notetip ある場所("マップ URL"など) でサポートされているすべてのマクロを表示するには、ブラウザ ウィンドウの下部にある検索ボックス(CTRL+F でアクセス可能)に場所の名前を貼り付けて、*次*を検索します。 ::: |マクロ|サポート対象|説明| |--|------|------| |{ACTION.ID}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新通知とコマンド<br>→ 検出通知とコマンド<br>→ 自動登録通知と コマンド<br>→ 内部通知|*トリガーアクションの数値ID*| |{ACTION.NAME}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ 検出通知とコマンド<br>→ 自動登録通知とコマンド <br>→ 内部通知|*トリガーアクションの名前*| |{ALERT.MESSAGE}|→ アラートスクリプトのパラメーター|*アクション設定の'デフォルトメッセージ'値*<br>3.0.0 以降でサポートされています| |{ALERT.SENDTO}|→ アラートスクリプトのパラメーター|*ユーザーのメディア設定の'送信先'の値*<br>3.0.0 以降でサポートされています| |{ALERT.SUBJECT}|→ アラートスクリプトのパラメーター|*アクション設定の'デフォルトの件名'値*<br>3.0.0 以降でサポートされています| |{DATE}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ 検出通知とコマンド<br>→ 自動登録通知とコマンド <br>→ 内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*yyyy.mm.dd 形式の現在日付*| |{DISCOVERY.DEVICE.IPADDRESS}|→ 検出通知とコマンド|*検出されたデバイスのIPアドレス*<br>追加されるホストに依存せず、常に使用可能| |{DISCOVERY.DEVICE.DNS}|→ 検出通知とコマンド|*検出されたデバイスのDNS名*<br>追加されるホストに依存せず、常に使用可能| |{DISCOVERY.DEVICE.STATUS}|→ 検出通知とコマンド|*検出されたデバイスのステータス*: UP または DOWN のいずれか| |{DISCOVERY.DEVICE.UPTIME}|→ 検出通知とコマンド|*特定のデバイスの検出ステータスが最後に変更されてからの時間*。精度は 1 秒までです。<br>例:1時間29分01秒<br>ステータスがDOWNのデバイスの場合、これはダウンタイムの期間です。| |{DISCOVERY.RULE.NAME}|→ 検出通知とコマンド|*デバイスまたはサービスの有無を検出した検出ルール名*| |{DISCOVERY.SERVICE.NAME}|→ 検出通知とコマンド|*検出されたサービス名*<br>例:HTTP| |{DISCOVERY.SERVICE.PORT}|→ 検出通知とコマンド|*検出されたサービスポート*<br>例:80| |{DISCOVERY.SERVICE.STATUS}|→ 検出通知とコマンド|*検出された<service://>のステータスはUPまたはDOWNのいずれかです。 \| \|{DISCOVERY.SERVICE.UPTIME} \|→ ディスカバリ通知とコマンド \|*特定のサービスのディスカバリ ステータスが最後に変更されてからの時間*。精度は 1 秒まで。<br>例: 1 時間 29 分 01 秒。 <br>ステータスが DOWN のサービスの場合、これはダウンタイムの期間です。 \| \|{ESC.HISTORY} \|→ トリガーベースの通知とコマンド<br>→ 問題の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ 内部通知 \|*エスカレーション履歴。 以前に送信されたメッセージのログ。*<br>以前に送信された通知、送信されたエスカレーション ステップ、およびそのステータス (*送信済み*、*進行中*、または *失敗*) を表示します。| |{EVENT.ACK.STATUS}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*イベント確認ステータス(はい/いいえ)*| |{EVENT.AGE}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス回復の通知とコマンド<br>→ 検出通知 およびコマンド<br>→ 自動登録の通知とコマンド<br>→ 内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*アクショントリガーのイベント経過時間*。精度は1秒まで。<br>エスカレーションされたメッセージで役立ちます| |{EVENT.DATE}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス回復の通知とコマンド<br>→ 検出通知およびコマンド<br>→ 自動登録の通知とコマンド<br>→ 内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*アクショントリガーのイベント日付*| |{EVENT.DURATION}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ 内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*イベントの継続時間(障害イベントと回復イベントの時間差)*。精度は1秒まで。<br>障害回復メッセージで役立ちます。<br><br>5.0.0 以降でサポートされています。| |{EVENT.ID}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ 検出通知と コマンド<br>→ 自動登録通知とコマンド<br>→ 内部通知<br>→ トリガーURL<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*アクショントリガーイベントのID(数値)*| |{EVENT.NAME}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ 内部通知< br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*アクショントリガーの障害イベント名*<br>4.0.0 以降でサポートされています| |{EVENT.NSEVERITY}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス回復の通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*イベント深刻度の数値* 使用可能な値: 0 - 未分類, 1 - 情報, 2 - 警告, 3 - 軽度の障害, 4 - 重度の障害, 5 - 致命的な障害<br>4.0.0 以降でサポートされています| |{EVENT.OBJECT}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ 検出通知とコマンド<br>→ 自動登録通知とコマンド<br>→ 内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*イベントオブジェクトの数値* 使用可能な値: 0 - トリガー, 1 - ホストの検出, 2 - サービスの検出, 3 - 自動登録, 4 - アイテム, 5 - ローレベルディスカバリルール<br>4.4.0 以降でサポートされています| |{EVENT.OPDATA}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*障害の根本的なトリガーの操作データ*<br>4.4.0 以降でサポートされています| |{EVENT.RECOVERY.DATE}|→ 障害[復旧通知](/manual/config/notifications/action/recovery_operations)とコマンド<br>→ 障害更新の通知とコマンド (復旧が行われた場合)<br>→ サービス回復通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)(復旧が行われた場合)|*リカバリイベントの日付*| |{EVENT.RECOVERY.ID}|→ 障害[復旧通知](/manual/config/notifications/action/recovery_operations)とコマンド<br>→ 障害更新の通知とコマンド (復旧が行われた場合)<br>→ サービス回復通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)(復旧が行われた場合)|*リカバリイベントの数値ID*| |{EVENT.RECOVERY.NAME}|→ 障害[復旧通知](/manual/config/notifications/action/recovery_operations)とコマンド<br>→ 障害更新の通知とコマンド (復旧が行われた場合)<br>→ サービス回復通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)(復旧が行われた場合)|*リカバリイベントの名前*<br>4.4.1 以降でサポートされています| |{EVENT.RECOVERY.STATUS}|→ 障害[復旧通知](/manual/config/notifications/action/recovery_operations)とコマンド<br>→ 障害更新の通知とコマンド (復旧が行われた場合)<br>→ サービス回復通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)(復旧が行われた場合)|*リカバリイベントのステータステキスト*| |{EVENT.RECOVERY.TAGS}|→ 障害[復旧通知](/manual/config/notifications/action/recovery_operations)とコマンド<br>→ 障害更新の通知とコマンド (復旧が行われた場合)<br>→ サービス回復通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)(復旧が行われた場合)|*リカバリイベントタグのコンマ区切りリスト。* タグが存在しない場合は空の文字列に展開されます。<br>3.2.0 以降でサポートされています。| |{EVENT.RECOVERY.TAGSJSON}|→ 障害[復旧通知](/manual/config/notifications/action/recovery_operations)とコマンド<br>→ 障害更新の通知とコマンド (復旧が行われた場合)<br>→ サービス回復通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)(復旧が行われた場合)|*イベント タグを含む JSON 配列 [objects](/manual/api/reference/event/object#event_tag).* タグが存在しない場合は空の配列に展開されます。<br>5.0.0 以降でサポートされています。| |{EVENT.RECOVERY.TIME}|→ 障害[復旧通知](/manual/config/notifications/action/recovery_operations)とコマンド<br>→ 障害更新の通知とコマンド (復旧が行われた場合)<br>→ サービス回復通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)(復旧が行われた場合)|*リカバリイベントの時間*| |{EVENT.RECOVERY.VALUE}|→ 障害[復旧通知](/manual/config/notifications/action/recovery_operations)とコマンド<br>→ 障害更新の通知とコマンド (復旧が行われた場合)<br>→ サービス回復通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)(復旧が行われた場合)|*リカバリイベントの数値*| |{EVENT.SEVERITY}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ 手動イベントアクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*イベント深刻度の名前*<br>4.0.0.以降でサポートされています| |{EVENT.SOURCE}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ 検出通知とコマンド<br>→ 自動登録通知とコマンド<br>→ 内部通知<br>→ 手動イベント アクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*イベント ソースの数値。*使用可能な値: 0 - トリガー、1 - 検出、2 - 自動登録、3 - 内部<br>4.4.0 以降でサポートされています。| |{EVENT.STATUS}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ 内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*アクションをトリガーしたイベントの言語値*| |{EVENT.TAGS}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*イベント タグのコンマ区切りリスト*タグが存在しない場合は空の文字列に展開されます。<br>3.2.0 以降でサポートされています。| |{EVENT.TAGSJSON}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ 手動イベント アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*イベントタグを含む JSON配列[オブジェクト](/manual/api/reference/event/object#event_tag)* タグが存在しない場合空の配列に展開されます<br>5.0.0 以降でサポートされています| |{EVENT.TAGS.<tag name>}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ WebhookメディアタイプのURL名とURL<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*タグ名で参照されるイベントタグ値*<br>英数字以外の文字 (英語以外のマルチバイト UTF 文字を含む) を含むタグ名は、二重引用符で囲む必要があります。 引用符で囲まれたタグ名内の引用符とバックスラッシュは、バックスラッシュでエスケープする必要があります。<br>4.4.2 以降でサポートされています。| |{EVENT.TIME}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ 検出通知とコマンド<br>→ 自動登録通知とコマンド<br>→ 内部通知<br>→ 手動イベント アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*アクションをトリガーしたイベントの時刻*| |{EVENT.UPDATE.ACTION}|→ 障害の更新通知とコマンド|[障害の更新](/manual/acknowledges#updating_problems) 中に実行される *アクションの人間が判読できる名前*<br>次の値に解決されます: *確認済み*、*コメント済み*、*(元の深刻度) から (更新された深刻度) への深刻度の変更*、および *クローズド* (1 回の更新で実行されるアクションの数による)。<br>4.0.0以降でサポートされています| |{EVENT.UPDATE.DATE}|→ 障害の更新通知とコマンド<br>→ サービス更新通知とコマンド|*イベントの日付[更新](/manual/config/notifications/action/update_operations)(確認など)*<br>非推奨の名前:{ACK.DATE}| |{EVENT.UPDATE.HISTORY}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*障害の更新のログ(確認など)* <br>非推奨の名前:{EVENT.ACK.HISTORY}| |{EVENT.UPDATE.MESSAGE}|→ 障害の更新通知とコマンド|*障害の更新メッセージ*<br>非推奨の名前:{ACK.MESSAGE}| |{EVENT.UPDATE.STATUS}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*障害の更新ステータスの数値* 使用可能な値 : 0 - 障害/回復イベントのために Webhook が呼び出されました。1 - 更新操作<br>4.4.0 以降でサポートされています。| |{EVENT.UPDATE.TIME}|→ 障害の更新の通知とコマンド<br>→ サービスの更新の通知とコマンド|*イベントの時間 [更新](/manual/config/notifications/action/update_operations)(確認など)*<br>非推奨の名前:{ACK.TIME}| |{EVENT.VALUE}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド<br>→ サービス復旧の通知とコマンド<br>→ 内部通知<br>→ 手動イベント アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*アクションをトリガーしたイベントの数値(障害の場合は1、復旧の場合は0)*| |{FUNCTION.VALUE<1-9>}|→ トリガーベースの通知とコマンド<br>→ 障害の更新通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ イベント名|*N番目の項目の結果 イベント時のトリガー式の に基づく関数*<br>最初のパラメーターとして */host/key* を持つ関数のみがカウントされます。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{FUNCTION.RECOVERY.VALUE<1-9>}|→ 障害[復旧通知](/manual/config/notifications/action/recovery_operations)とコマンド<br>→ 障害更新通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*イベント時のリカバリー式N番目の項目ベースの関数結果*<br>最初のパラメーターとして */host/key* を持つ関数のみがカウントされます。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{HOST.CONN}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 内部通知<br>→ マップエレメントラベル, URL の名前と値をマップ<br>→ アイテムの主要なパラメーター^[1](supported_by_location#footnotes)^<br>→ ホスト インターフェイスの IP/DNS<br>→ トラッパー アイテムの"許可されたホスト"フィールド<br>→ データベース監視の追加パラメーター<br>→ SSH および Telnet スクリプト< br>→ JMX アイテム エンドポイント フィールド<br>→ Web モニタリング^[4](supported_by_location#footnotes)^<br>→ ローレベルディスカバリルールフィルターの正規表現<br>→ 動的 URL ダッシュボード ウィジェットの URL フィールド<br>→トリガー名、イベント名、運用データと説明<br>→ トリガー URL<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ スクリプト型アイテム、アイテム プロトタイプ、検出ルール パラメータ名前と値<br>→ HTTP エージェント タイプ アイテム、アイテム プロトタイプ、検出ルール フィールド:<br>URL、クエリ フィールド、リクエスト ボディ、ヘッダー、プロキシ、SSL 証明書ファイル、SSL キー ファイル、許可されたホスト。<br>→ マニュアルホスト アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (確認テキストを含む)<br>→ 手動イベント アクション [スクリプト](/manual/web_interface/frontend_sections /administration/scripts) (確認テキストを含む)<br>→ 項目値ウィジェットの説明|*ホストの設定に応じて、ホストの IP アドレスまたは DNS 名*^[2](supported_by_location#footnotes)^.<br><br> {HOST.CONN[<1-9>](supported_by_location#indexed_macros)} のように数値インデックスとともに使用して、トリガー式の 1 番目、2 番目、3 番目などのホストを指すことができます。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{HOST.DESCRIPTION}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 内部通知<br>→ マップエレメントラベル<br>→ 手動イベント アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホストの説明.*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {HOST.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{HOST.DNS}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 内部通知<br>→ マップエレメントラベル, URL の名前と値をマップ<br>→ アイテムの主要なパラメーター^[1](supported_by_location#footnotes)^<br>→ ホスト インターフェイスの IP/DNS<br>→ トラッパー アイテムの"許可されたホスト"フィールド<br>→ データベース監視の追加パラメーター<br>→ SSH および Telnet スクリプト< br>→ JMX アイテム エンドポイント フィールド<br>→ Web モニタリング^[4](supported_by_location#footnotes)^<br>→ ローレベルディスカバリルールフィルターの正規表現<br>→ 動的 URL ダッシュボード ウィジェットの URL フィールド<br>→トリガー名、イベント名、運用データと説明<br>→ トリガー URL<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ スクリプト型アイテム、アイテム プロトタイプ、検出ルール パラメータ名前と値<br>→ HTTP エージェント タイプ アイテム、アイテム プロトタイプ、検出ルール フィールド:<br>URL、クエリ フィールド、リクエスト ボディ、ヘッダー、プロキシ、SSL 証明書ファイル、SSL キー ファイル、許可されたホスト。<br>→ マニュアルホスト アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (確認テキストを含む)<br>→ 手動イベント アクション [スクリプト](/manual/web_interface/frontend_sections /administration/scripts) (確認テキストを含む)<br>→ 項目値ウィジェットの説明|*ホスト DNS 名*^[2](supported_by_location#footnotes)^.<br><br>このマクロは、数値で使用できます。インデックス{HOST.DNS[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{HOST.HOST}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 自動登録の通知とコマンド<br>→ 内部通知<br>→ アイテムキーパラメータ<br>→ マップ要素ラベル、URL の名前と値をマップ<br>→ ホストインターフェース IP/DNS<br>→ トラッパーアイテム"許可されたホスト"フィールド<br>→ データベース監視追加パラメーター<br>→ SSH および Telnet スクリプト<br>→ JMX アイテム エンドポイント フィールド<br>→ Web モニタリング^[4](supported_by_location#footnotes)^<br>→ ローレベルディスカバリルールフィルターの正規表現<br>→動的 URL ダッシュボード ウィジェットの URL フィールド<br>→ トリガー名、イベント名、運用データと説明<br>→ トリガー URL<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br> → スクリプト タイプ アイテム、アイテム プロトタイプ、検出ルール パラメータの名前と値<br>→ HTTP エージェント タイプ アイテム、アイテム プロトタイプ、検出ルール フィールド:<br>URL、クエリ フィールド、リクエスト ボディ、ヘッダー、プロキシ、SSL 証明書ファイル、SSLキー ファイル、許可されたホスト。<br>→ 手動ホスト アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (確認テキストを含む)<br>→ 手動イベント アクション [スクリプト](/manual/we b_interface/frontend_sections/administration/scripts) (確認テキストを含む)<br>→ 項目値ウィジェットの説明|*ホスト名.*<br><br>このマクロは数値インデックスと共に使用できます。 {HOST.HOST[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>`{HOSTNAME<1-9>}` は非推奨です。| |{HOST.ID}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 内部通知<br>→ マップエレメントラベル, URL の名前と値をマップ<br>→ 動的 URL ダッシュボード ウィジェットの URL フィールド<br>→ トリガー URL<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ 手動イベント アクション [スクリプト](/manual/web_interface/frontend_sections /administration/scripts)<br>→ 項目値ウィジェットの説明|*ホスト ID.*<br><br>{HOST.ID[<1-9>](supported_by_location#indexed_macros) のように数値インデックスで使用できます。 トリガー式で最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{HOST.IP}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 自動登録の通知とコマンド<br>→ 内部通知<br>→ マップ エレメント ラベル、URL の名前と値をマップ<br>→ アイテム キー パラメータ^[1](supported_by_location#footnotes)^<br>→ ホスト インターフェイス IP/DNS<br>→ トラッパー アイテム"許可されたホスト」フィールド<br>→ データベース監視の追加パラメーター<br>→ SSH および Telnet スクリプト<br>→ JMX アイテム エンドポイント フィールド<br>→ Web 監視^[4](supported_by_location#footnotes)^<br>→ Low-レベル検出ルール フィルタの正規表現<br>→ 動的 URL ダッシュボード ウィジェットの URL フィールド<br>→ トリガー名、イベント名、運用データと説明<br>→ トリガー URL<br>→ [タグ名と値](/manual /config/tagging#macro_support)<br>→ スクリプト タイプのアイテム、アイテムのプロトタイプ、検出ルールのパラメータ名と値<br>→ HTTP エージェント タイプのアイテム、アイテムのプロトタイプ、検出ルールのフィールド:<br>URL、クエリ フィールド、リクエスト ボディ、ヘッダー、プロキシ、SSL 証明書ファイル、SSL キー ファイル、許可されたホスト<br>→ 手動ホストアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (確認テキストを含む)<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (確認文含む)<br>→ 項目値の説明 widget|*ホストIPアドレス*^[2](support_by_location#footnotes)^.< br><br>このマクロは、数値インデックスと一緒に使用できます。 {HOST.IP[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>`{IPADDRESS<1-9>}` は非推奨です。| |{HOST.METADATA}|→ 自動登録の通知とコマンド|*ホスト メタデータ。*<br>アクティブなエージェントの自動登録にのみ使用されます。| |{HOST.NAME}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 内部通知<br>→ マップエレメントラベル, URL の名前と値をマップ<br>→ 項目キー パラメータ<br>→ ホスト インターフェイス IP/DNS<br>→ トラッパー項目「許可されたホスト」フィールド<br>→ データベース監視追加パラメータ<br>→ SSH および Telnet スクリプト<br>→ Web 監視^[4]( supported_by_location#footnotes)^<br>→ 低レベル検出ルール フィルターの正規表現<br>→ 動的 URL ダッシュボード ウィジェットの URL フィールド<br>→ トリガー名、イベント名、運用データおよび説明<br>→ トリガー URL<br >→ [タグの名前と値](/manual/config/tagging#macro_support)<br>→ スクリプト タイプのアイテム、アイテムのプロトタイプ、および検出ルールのパラメータ名と値<br>→ HTTP エージェント タイプのアイテム、アイテムのプロトタイプ、および検出ルールのフィールド:<br>URL、クエリ フィールド、リクエスト ボディ、ヘッダー、プロキシ、SSL 証明書ファイル、SSL キー ファイル、許可されたホスト。<br>→ 手動ホスト アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (確認テキストを含む)<br>→ 手動イベント アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (確認テキストを含む)<br>→ 説明アイテム値ウィジェットの設定|*表示可能なホスト名。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {HOST.NAME[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{HOST.PORT}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 自動登録の通知とコマンド<br>→ 内部通知<br>→ トリガー名、イベント名、運用データと説明<br>→ トリガー URL<br>→ JMX アイテム エンドポイント フィールド<br>→ [タグ名と値](/manual/config/tagging#macro_support) <br>→ 手動イベント アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ 項目値ウィジェットの説明|*ホスト (エージェント) ポート*^[2](support_by_location#footnotes)^. <br><br>このマクロは、数値インデックスと一緒に使用できます。 {HOST.PORT[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{HOST.TARGET.CONN}|→ トリガーベースのコマンド<br>→ 障害の更新コマンド<br>→ ディスカバリコマンド<br>→ 自動登録コマンド|ホストの設定に応じて、ターゲット ホストの IP アドレスまたは DNS 名。<br>5.4.0 以降でサポートされています。| |{HOST.TARGET.DNS}|→ トリガーベースのコマンド<br>→ 障害の更新コマンド<br>→ ディスカバリコマンド<br>→ 自動登録コマンド|ターゲット ホストの DNS 名。<br>5.4.0 以降でサポートされています。| |{HOST.TARGET.HOST}|→ トリガーベースのコマンド<br>→ 障害の更新コマンド<br>→ ディスカバリコマンド<br>→ 自動登録コマンド|ターゲット ホストの技術名。<br>5.4.0 以降でサポートされています。| |{HOST.TARGET.IP}|→ トリガーベースのコマンド<br>→ 障害の更新コマンド<br>→ ディスカバリコマンド<br>→ 自動登録コマンド|ターゲット ホストの IP アドレス。<br>5.4.0 以降でサポートされています。| |{HOST.TARGET.NAME}|→ トリガーベースのコマンド<br>→ 障害の更新コマンド<br>→ ディスカバリコマンド<br>→ 自動登録コマンド|ターゲット ホストの表示名。<br>5.4.0 以降でサポートされています。| |{HOSTGROUP.ID}|→ マップ要素のラベル,URL の名前と値をマップ|*ホストグループID*| |{INVENTORY.ALIAS}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのエイリアス フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.ALIAS[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.ASSET.TAG}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのアセット タグ フィールド。*<br><br>このマクロは、数値インデックスなどで使用できます。 {INVENTORY.ASSET.TAG[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.CHASSIS}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのシャーシ フィールド。*<br><br>このマクロは、数値インデックスなどで使用できます。 {INVENTORY.CHASSIS[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.CONTACT}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの連絡先フィールド。*<br><br>このマクロは、数値インデックスなどで使用できます。 {INVENTORY.CONTACT[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [indexed macros](supported_by_location#indexed_macros). を参照してください。<br><br>`{PROFILE.CONTACT<1-9>}` は非推奨です。| |{INVENTORY.CONTRACT.NUMBER}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのコントラクト番号フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.CONTRACT.NUMBER[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.DEPLOYMENT.STATUS}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの展開ステータス フィールド。*<br><br>このマクロは、数値インデックスなどで使用できます {INVENTORY.DEPLOYMENT.STATUS[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.HARDWARE}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのハードウェア フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.HARDWARE[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [indexed macros](supported_by_location#indexed_macros). を参照してください。<br><br>`{PROFILE.HARDWARE<1-9>}` は非推奨です。| |{INVENTORY.HARDWARE.FULL}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのハードウェア (完全な詳細) フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.HARDWARE.FULL[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.HOST.NETMASK}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのホスト サブネット マスク フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.HOST.NETMASK[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.HOST.NETWORKS}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのホスト ネットワーク フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.HOST.NETWORKS[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.HOST.ROUTER}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのホスト ルータ フィールド。*<br><br>このマクロは、数値インデックスなどで使用できます。 {INVENTORY.HOST.ROUTER[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式の 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.HW.ARCH}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのハードウェア アーキテクチャ フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.HW.ARCH[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.HW.DATE.DECOMM}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのハードウェア廃止日フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.HW.DATE.DECOMM[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.HW.DATE.EXPIRY}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのハードウェア メンテナンスの有効期限フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.HW.DATE.EXPIRY[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.HW.DATE.INSTALL}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのハードウェア インストール フィールドの日付。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.HW.DATE.INSTALL[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.HW.DATE.PURCHASE}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのハードウェア購入日フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.HW.DATE.PURCHASE[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.INSTALLER.NAME}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのインストーラ名フィールド。*<br><br>このマクロは、数値インデックスとともに使用できます。 {INVENTORY.INSTALLER.NAME[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.LOCATION}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのロケーション フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.LOCATION[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [indexed macros](supported_by_location#indexed_macros). を参照してください。<br><br>`{PROFILE.LOCATION<1-9>}` は非推奨です。| |{INVENTORY.LOCATION.LAT}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの場所の緯度フィールド。*<br><br>このマクロは、数値インデックスなどで使用できます。 {INVENTORY.LOCATION.LAT[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.LOCATION.LON}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの場所の経度フィールド。*<br><br>このマクロは数値インデックスと一緒に使用できます。 {INVENTORY.LOCATION.LON[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.MACADDRESS.A}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*MAC アドレス ホスト インベントリのフィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.MACADDRESS.A[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>`{PROFILE.MACADDRESS<1-9>}` は非推奨です。| |{INVENTORY.MACADDRESS.B}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの MAC アドレス B フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.MACADDRESS.B[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.MODEL}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのモデル フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.MODEL[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.NAME}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの名前フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.NAME[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>`{PROFILE.NAME<1-9>}` は非推奨です。| |{INVENTORY.NOTES}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのメモ フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.NOTES[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>`{PROFILE.NOTES<1-9>}` は非推奨です。| |{INVENTORY.OOB.IP}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの OOB IP アドレス フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.OOB.IP[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.OOB.NETMASK}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの OOB サブネット マスク フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.OOB.NETMASK[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.OOB.ROUTER}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの OOB ルーター フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.OOB.ROUTER[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.OS}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの OS フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.OS[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>`{PROFILE.OS<1-9>}` は非推奨です。| |{INVENTORY.OS.FULL}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの OS (完全な詳細) フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.OS.FULL[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.OS.SHORT}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの OS (Short) フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.OS.SHORT[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.PRIMARY.CELL}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのプライマリ POC セル フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.PRIMARY.CELL[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式の 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.PRIMARY.EMAIL}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのプライマリ POC メール フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.PRIMARY.EMAIL[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式の 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.PRIMARY.NAME}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのプライマリ POC 名フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.PRIMARY.NAME[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.PRIMARY.NOTES}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのプライマリ POC メモ フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.PRIMARY.NOTES[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.PRIMARY.PHONE.A}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのプライマリ POC phone A フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.PRIMARY.PHONE.A[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式の 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.PRIMARY.PHONE.B}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのプライマリ POC phone B フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.PRIMARY.PHONE.B[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式の 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.PRIMARY.SCREEN}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのプライマリ POC スクリーン名フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.PRIMARY.SCREEN[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式の 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.SECONDARY.CELL}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのセカンダリ POC セル フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.SECONDARY.CELL[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.SECONDARY.EMAIL}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのセカンダリ POC メール フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.SECONDARY.EMAIL[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式の 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.SECONDARY.NAME}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのセカンダリ POC 名フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.SECONDARY.NAME[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式の 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.SECONDARY.NOTES}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのセカンダリ POC メモ フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.SECONDARY.NOTES[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式の 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.SECONDARY.PHONE.A}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのセカンダリ POC phone A フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.SECONDARY.PHONE.A[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.SECONDARY.PHONE.B}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのセカンダリ POC phone B フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.SECONDARY.PHONE.B[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.POC.SECONDARY.SCREEN}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのセカンダリ POC スクリーン名フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.POC.SECONDARY.SCREEN[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式の 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SERIALNO.A}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのシリアル番号 A フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SERIALNO.A[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>`{PROFILE.SERIALNO<1-9>}` は非推奨です。| |{INVENTORY.SERIALNO.B}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのシリアル番号 B フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SERIALNO.B[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SITE.ADDRESS.A}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのサイト アドレス A フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SITE.ADDRESS.A[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SITE.ADDRESS.B}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのサイト アドレス B フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SITE.ADDRESS.B[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SITE.ADDRESS.C}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのサイト アドレス C フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SITE.ADDRESS.C[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SITE.CITY}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのサイト 都市 フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SITE.CITY[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SITE.COUNTRY}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのサイト 国 フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SITE.COUNTRY[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SITE.NOTES}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのサイト ノート フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SITE.NOTES[<1-9>](supported_by_location#indexed_macros)} を使用して、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SITE.RACK}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのサイト ロケーション フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SITE.RACK[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SITE.STATE}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのサイト 都道府県 フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SITE.STATE[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SITE.ZIP}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのサイト 郵便番号 フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SITE.ZIP[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SOFTWARE}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのソフトウェア フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SOFTWARE[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [indexed macros](supported_by_location#indexed_macros). を参照してください。<br><br>`{PROFILE.SOFTWARE<1-9>}` は非推奨です。| |{INVENTORY.SOFTWARE.APP.A}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのソフトウェア アプリケーション A フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SOFTWARE.APP.A[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SOFTWARE.APP.B}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのソフトウェア アプリケーション B フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SOFTWARE.APP.B[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SOFTWARE.APP.C}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのソフトウェア アプリケーション C フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SOFTWARE.APP.C[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SOFTWARE.APP.D}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのソフトウェア アプリケーション D フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SOFTWARE.APP.D[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SOFTWARE.APP.E}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのソフトウェア アプリケーション E フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SOFTWARE.APP.E[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.SOFTWARE.FULL}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのソフトウェア (完全な詳細) フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.SOFTWARE.FULL[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.TAG}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのタグ フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.TAG[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>`{PROFILE.TAG<1-9>}` は非推奨です。| |{INVENTORY.TYPE}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのタイプ フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.TYPE[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>`{PROFILE.DEVICETYPE<1-9>}` は非推奨です。| |{INVENTORY.TYPE.FULL}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのタイプ (完全な詳細) フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.TYPE.FULL[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.URL.A}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの URL A フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.URL.A[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.URL.B}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの URL B フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.URL.B[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.URL.C}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリの URL C フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.URL.C[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{INVENTORY.VENDOR}|→ 内部通知<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ホスト インベントリのベンダー フィールド。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {INVENTORY.VENDOR[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.DESCRIPTION}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*通知を引き起こしたトリガー式の N 番目の項目の説明。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {ITEM.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.DESCRIPTION.ORIG}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*通知の原因となったトリガー式の N 番目の項目の説明 (未解決のマクロを含む)。*<br><br>このマクロは、数値インデックス (例: {ITEM.DESCRIPTION.ORIG[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>5.2.0 以降でサポートされています。| |{ITEM.ID}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→内部通知<br>→ スクリプト タイプのアイテム、アイテムのプロトタイプ、および検出ルールのパラメーター名と値^[6](supported_by_location#footnotes)^<br>→ HTTP エージェント タイプのアイテム、アイテムのプロトタイプ、および検出ルールのフィールド:<br>URL、クエリ フィールド、リクエスト ボディ 、ヘッダー、プロキシ、SSL 証明書ファイル、SSL キー ファイル<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*通知を引き起こしたトリガー式の N 番目の項目の数値 ID。*<br><br>このマクロは、数値インデックスと共に使用できます。 {ITEM.ID[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.KEY}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→内部通知<br>→ スクリプト タイプのアイテム、アイテムのプロトタイプ、および検出ルールのパラメーター名と値^[6](supported_by_location#footnotes)^<br>→ HTTP エージェント タイプのアイテム、アイテムのプロトタイプ、および検出ルールのフィールド:<br>URL、クエリ フィールド、リクエスト ボディ 、ヘッダー、プロキシ、SSL 証明書ファイル、SSL キー ファイル<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*通知を引き起こしたトリガー式の N 番目の項目のキー。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {ITEM.KEY[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>`{TRIGGER.KEY}` は非推奨です。| |{ITEM.KEY.ORIG}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→内部通知<br>→ スクリプト タイプのアイテム、アイテムのプロトタイプ、および検出ルールのパラメーター名と値^[6](supported_by_location#footnotes)^<br>→ HTTP エージェント タイプのアイテム、アイテムのプロトタイプ、および検出ルールのフィールド:<br>URL、クエリ フィールド、リクエスト ボディ 、ヘッダー、プロキシ、SSL 証明書ファイル、SSL キー ファイル, 許可されたホスト。^[6](supported_by_location#footnotes)^<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*通知の原因となったトリガー式の N 番目の項目の元のキー (展開されていないマクロを含む) ^[4](supported_by_location#footnotes)^.*<br><br>このマクロは、数値インデックスなどで使用できます。 {ITEM.KEY.ORIG[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.LASTVALUE}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガー名、イベント名、運用データと説明<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ トリガーURL<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*通知の原因となったトリガー式の N 番目の項目の最新の値。*<br>最新の履歴値が *最大履歴表示期間* を超えて収集された場合、フロントエンドで \*UNKNOWN\* に解決されます。 ([管理→全般](/manual/web_interface/frontend_sections/administration/general#gui) メニュー セクションで設定)。問題イベントを表示するときの最新のアイテム値ではなく、問題が発生した時点からのアイテム値を保持します。<br>`last(/{HOST.HOST}/{ITEM.KEY})` のエイリアスです。<br> <br>解決された値は、トリガー URL などで使用できるように 20 文字に切り捨てられます。完全な値に解決するには、[マクロ関数](/manual/config/macros/macro_functions#seeing-full-item-values)を使用できます。<br><br>[カスタマイズ](/manual/config/macros/ macro_functions) マクロ値はこのマクロでサポートされています。 Zabbix 3.2.0以降。<br><br>このマクロは、数値インデックスで使用できます。 {ITEM.LASTVALUE[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などの項目を指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.LOG.AGE}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガー名、運用データ、説明<br>→ トリガー URL<br>→ イベント タグと値<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ログ アイテム イベントの経過時間*。精度は 1 秒までです。<br><br>このマクロは、数値インデックスと一緒に使用できます。 {ITEM.LOG.AGE[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.LOG.DATE}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガー名、運用データ、説明<br>→ トリガー URL<br>→ イベント タグと値<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ログ アイテム イベントの日付。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {ITEM.LOG.DATE[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.LOG.EVENTID}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガー名、運用データ、説明<br>→ トリガー URL<br>→ イベント タグと値<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*イベント ログ内のイベントの ID。*<br>Windows イベント ログの監視のみ。<br><br>このマクロは、数値インデックスと一緒に使用できます。 {ITEM.LOG.EVENTID[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.LOG.NSEVERITY}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガー名、運用データ、説明<br>→ トリガー URL<br>→ イベント タグと値<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*イベント ログ内のイベントの深刻度の数値。*<br>Windows イベント ログの監視のみ。<br><br>このマクロは、数値インデックスと一緒に使用できます。 {ITEM.LOG.NSEVERITY[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.LOG.SEVERITY}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガー名、運用データ、説明<br>→ トリガー URL<br>→ イベント タグと値<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*イベント ログ内のイベントの口頭による重大度。*<br>Windows イベント ログ監視のみ。 {ITEM.LOG.SEVERITY[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.LOG.SOURCE}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガー名、運用データ、説明<br>→ トリガー URL<br>→ イベント タグと値<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*イベント ログ内のイベントのソース。*<br>Windows イベント ログの監視のみ。<br><br>このマクロは、数値インデックスと一緒に使用できます。 {ITEM.LOG.SOURCE[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.LOG.TIME}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガー名、運用データ、説明<br>→ トリガー URL<br>→ イベント タグと値<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*ログ アイテム イベントの時間。*<br><br>このマクロは、数値インデックスなどで使用できます。 {ITEM.LOG.TIME[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.NAME}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*通知を引き起こしたトリガー式の N 番目の項目の名前。*<br><br>このマクロは、数値インデックスと一緒に使用できます。 {ITEM.NAME[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で 1 番目、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.NAME.ORIG}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|このマクロは、Zabbix 6.0 以降では非推奨です。 ユーザーマクロと位置マクロがアイテム名でサポートされていた6.0より前のバージョンのZabbixでは、*アイテムの元の名前(つまり、マクロが解決されていない)*に解決されていました。<br><br>このマクロは、数値インデックス。 {ITEM.NAME.ORIG[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.STATE}|→ アイテムベースの内部通知<br>→ アイテム値ウィジェットの説明|*通知の原因となったトリガー式のN番目の項目の最新状態。* 使用可能な値: **Not supported** および **Normal**。<br><br>このマクロは、数値インデックスと一緒に使用できます。 {ITEM.STATE[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.STATE.ERROR}|→ アイテムベースの内部通知<br>|*アイテムがサポートされなくなった理由の詳細を含むエラー メッセージ。* <br><br> アイテムがサポートされていない状態になり、すぐに再びサポートされるようになった場合、エラー フィールドは空になることがあります。| |{ITEM.VALUE}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガー名、イベント名、運用データと説明<br>→ [タグ名と値](/manual/config/tagging#macro_support)<br>→ トリガーURL<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|次のいずれかに解決されます:<br>1) トリガー式の N 番目のアイテムの履歴 (イベント時の) 値。たとえば、イベントの表示や送信など、トリガー ステータス変更のコンテキストで使用される場合notifications.<br>2) トリガー式の N 番目の項目の最新の値。たとえば、ポップアップ選択ウィンドウにトリガーのリストを表示するときなど、トリガー ステータス変更のコンテキストなしで使用された場合。この場合、{ITEM.LASTVALUE} と同じように機能します。<br>最初のケースでは、履歴値が既に削除されているか、保存されていない場合、\*UNKNOWN\* に解決されます。<br>2 番目のケースでは、また、フロントエンドのみで、最新の履歴値が *最大履歴表示期間* よりも前に収集された場合 ([管理→一般](/manual/web_interface/frontend_sections で設定) に解決されます。 /administration/general#gui) menu section).<br><br>解決された値は、トリガー URL などで使用できるように 20 文字に切り捨てられます。完全な値に解決するには、[マクロ関数](/manual/config/macros/macro_functions#seeing-full-item-values)を使用できます。<br><br>[カスタマイズ](/manual/config/macros/ macro_functions) マクロ値は、Zabbix 3.2.0 以降、このマクロでサポートされています。<br><br>このマクロは、数値インデックスなどで使用できます。 {ITEM.VALUE[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などの項目を指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{ITEM.VALUETYPE}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ アイテム値ウィジェットの説明|*通知の原因となったトリガー式の N 番目の項目の値の型* 使用可能な値: 0 - 浮動小数点数、1 - 文字、2 - ログ、3 - 符号なし数値、4 - テキスト<br><br>このマクロは数値インデックスで使用できます。例えば {ITEM.VALUETYPE[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。<br><br>5.4.0 以降でサポートされています。| |{LLDRULE.DESCRIPTION}|→ LLD ルールに基づく内部通知|*通知の原因となったローレベルディスカバリルールの説明*| |{LLDRULE.DESCRIPTION.ORIG}|→ LLD ルールに基づく内部通知|*通知の原因となったローレベルディスカバリルールの説明 (未解決のマクロを含む)。*<br>5.2.0 以降でサポートされています。| |{LLDRULE.ID}|→ LLD ルールに基づく内部通知|*通知の原因となったローレベルディスカバリルールの数値ID*| |{LLDRULE.KEY}|→ LLD ルールに基づく内部通知|*通知の原因となったローレベルディスカバリルールのキー。*| |{LLDRULE.KEY.ORIG}|→ LLD ルールに基づく内部通知|*通知の原因となったローレベルディスカバリルールの元のキー(展開されていないマクロを含む)*| |{LLDRULE.NAME}|→ LLD ルールに基づく内部通知|*通知の原因となったローレベルディスカバリルールの名前(マクロが解決されたもの)*| |{LLDRULE.NAME.ORIG}|→ LLD ルールに基づく内部通知|*通知の原因となったローレベルディスカバリルールの元の名前(つまり、マクロが解決されていないもの)。*| |{LLDRULE.STATE}|→ LLD ルールに基づく内部通知|*ローレベルディスカバリルールの最新の状態* 使用可能な値: **Not supported** と **Normal**.| |{LLDRULE.STATE.ERROR}|→ LLD ルールに基づく内部通知|*LLD ルールがサポートされなくなった理由の詳細を含むエラー メッセージ*<br><br>LLDルールがサポートされていない状態になり、すぐに再びサポートされるようになった場合、エラー フィールドは空になる可能性があります。| |{MAP.ID}|→ マップ要素のラベル, URLの名前と値をマップ|*ネットワークマップID.*| |{MAP.NAME}|→ マップ要素のラベル, URLの名前と値をマップ<br>→ マップ形状のテキスト フィールド|*ネットワークマップ名*<br>3.4.0 以降でサポートされています| |{PROXY.DESCRIPTION}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 検出通知とコマンド<br>→ 自動登録の通知とコマンド<br>→内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*プロキシの説明* 次のいずれかに解決されます。<br>1) トリガー式の N 番目のアイテムのプロキシ (トリガーベースの通知)。ここで [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) マクロを使用できます。<br>2) 検出を実行したプロキシ (検出通知)。ここではインデックスを作成せずに {PROXY.DESCRIPTION} を使用します。<br>3) アクティブなエージェントが登録されたプロキシ (自動登録通知)。ここでは、インデックスを作成せずに {PROXY.DESCRIPTION} を使用します。<br><br>このマクロは、数値インデックスと一緒に使用できます。 {PROXY.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} は、トリガー式で最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{PROXY.NAME}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 検出通知とコマンド<br>→ 自動登録の通知とコマンド<br>→内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*プロキシの名前* 次のいずれかに解決されます。<br>1) トリガー式の N 番目のアイテムのプロキシ (トリガーベースの通知)。 ここで [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) マクロを使用できます。<br>2) 検出を実行したプロキシ (検出通知)。 ここでは、インデックスを作成せずに {PROXY.NAME} を使用します。<br>3) アクティブなエージェントが登録されたプロキシ (自動登録通知)。ここでは、インデックスを作成せずに {PROXY.NAME} を使用します。<br><br>このマクロは、数値インデックスと一緒に使用できます。 {PROXY.NAME[<1-9>](supported_by_location#indexed_macros)} は、トリガー式の最初、2 番目、3 番目などのホストを指します。 [インデックス付きマクロ](supported_by_location#indexed_macros) を参照してください。| |{SERVICE.DESCRIPTION}|→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド|*サービスの説明* (解決されたマクロを含む)| |{SERVICE.NAME}|→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド|*サービスの名前* (解決されたマクロを含む)| |{SERVICE.ROOTCAUSE}|→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド|*サービスの失敗の原因となったトリガー問題イベントのリスト* 深刻度とホスト名でソートされています。 次の詳細が含まれます: ホスト名、イベント名、深刻度、経過時間、サービス タグ、および値| |{SERVICE.TAGS}|→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド|*サービスイベントタグのコンマ区切りリスト* サービスイベントタグは、サービス構成セクションのタグで定義できます。 タグが存在しない場合は空の文字列に展開されます。| |{SERVICE.TAGSJSON}|→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド|*サービスイベントタグオブジェクトを含むJSON配列* サービス イベント タグは、サービス構成セクションのタグで定義できます。 タグが存在しない場合は、空の配列に展開されます。| |{SERVICE.TAGS.<tag name>}|→ サービスベースの通知とコマンド<br>→ サービス更新の通知とコマンド|*タグ名によって参照されるサービス イベント タグの値。* サービス イベント タグは、サービス構成セクションのタグで定義できます。<br>英数字以外の文字 (英語以外のマルチバイト UTF 文字を含む) を含むタグ名は、二重引用符で囲む必要があります。引用符で囲まれたタグ名内の引用符とバックスラッシュは、バックスラッシュでエスケープする必要があります。| |{TIME}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ サービスベースの通知とコマンド<br>→ サービス更新通知とコマンド<br>→ 検出通知とコマンド<br>→ 自動登録の通知とコマンド<br>→内部通知<br>→ トリガーイベント名<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*hh:mm:ss 形式の現在時刻*| |{TRIGGER.DESCRIPTION}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガーベースの内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*トリガーの説明。*<br>`{TRIGGER.DESCRIPTION}` が通知テキストで使用されている場合、トリガーの説明でサポートされているすべてのマクロが展開されます。<br>`{TRIGGER.COMMENT}` は非推奨です。| |{TRIGGER.EXPRESSION.EXPLAIN}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)<br>→ イベント名|*部分的に評価されたトリガー式。*<br>項目ベースの関数はイベント生成時に評価され、結果に置き換えられますが、他のすべての関数は式に記述されているとおりに表示されます。 トリガー式のデバッグに使用できます。| |{TRIGGER.EXPRESSION.RECOVERY.EXPLAIN}|→ 障害[復旧通知](/manual/config/notifications/action/recovery_operations)とコマンド<br>→ 障害更新通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*一部評価トリガー回復式*<br>項目ベースの関数はイベント生成時に評価され、結果に置き換えられますが、他のすべての関数は式に記述されているとおりに表示されます。 トリガー回復式のデバッグに使用できます。| |{TRIGGER.EVENTS.ACK}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ マップ要素のラベル<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*マップ内のマップ要素、または通知内の現在のイベントを生成したトリガーに対して確認されたイベントの数*| |{TRIGGER.EVENTS.PROBLEM.ACK}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ マップ要素のラベル<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*状態を無視したすべてのトリガーの確認済みの障害イベントの数*| |{TRIGGER.EVENTS.PROBLEM.UNACK}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ マップ要素のラベル<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*状態に関係なく、すべてのトリガーの未確認の障害イベントの数*| |{TRIGGER.EVENTS.UNACK}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ マップ要素のラベル<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*マップ内のマップ要素、または通知内の現在のイベントを生成したトリガーの未確認イベントの数*| |{TRIGGER.HOSTGROUP.NAME}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガーベースの内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*(SQLクエリで)並べ替えられた、トリガーが定義されているホストグループのカンマ区切りのリスト*| |{TRIGGER.PROBLEM.EVENTS.PROBLEM.ACK}|→ マップ要素のラベル|*障害状態のトリガーの確認済み障害イベントの数*| |{TRIGGER.PROBLEM.EVENTS.PROBLEM.UNACK}|→ マップ要素のラベル|*障害状態のトリガーの未確認の障害イベントの数*| |{TRIGGER.EXPRESSION}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガーベースの内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*トリガー式*| |{TRIGGER.EXPRESSION.RECOVERY}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガーベースの内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*[トリガー構成](/manual/config/triggers/trigger)の*OKイベント生成*が'回復式'に設定されている場合は*トリガー回復式*;それ以外の場合は、空の文字列が返されます。<br>3.2.0 以降でサポートされています。| |{TRIGGER.ID}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガーベースの内部通知<br>→ マップ要素のラベル, URL の名前と値をマップ<br>→トリガーURL<br>→ トリガータグ値<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*このアクションをトリガーしたトリガーID値*<br>4.4.1 以降、トリガータグの値でサポートされています。| |{TRIGGER.NAME}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガーベースの内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*トリガーの名前* (マクロが解決されている)<br>4.0.0 以降、{EVENT.NAME} をアクションで使用して、トリガーされたイベント/問題の名前をマクロが解決された状態で表示できることに注意してください。| |{TRIGGER.NAME.ORIG}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガーベースの内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*トリガーの元の名前* (つまり、マクロが解決されていない)| |{TRIGGER.NSEVERITY}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガーベースの内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*トリガー深刻度の数値* 使用可能な値: 0 - 未設定, 1 - 情報, 2 - 警告, 3 - 軽度の障害, 4 - 重度の障害, 5 - 致命的な障害| |{TRIGGER.SEVERITY}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガーベースの内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*トリガー深刻度名* *管理 → 一般設定 → イベントのステータス*で定義できます。| |{TRIGGER.STATE}|→ トリガーベースの内部通知|*トリガーの最新の状態* 使用可能な値: **Unknown** および **Normal**.| |{TRIGGER.STATE.ERROR}|→ トリガーベースの内部通知|*トリガーがサポートされなくなった理由の詳細を含むエラー メッセージ。* <br> <br> トリガーがサポートされていない状態になり、すぐに再びサポートされるようになった場合、エラー フィールドは空になることがあります。| |{TRIGGER.STATUS}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*操作ステップ実行時のトリガー値* PROBLEM または OK のいずれかになります。<br>`{STATUS}` は非推奨です。| |{TRIGGER.TEMPLATE.NAME}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガーベースの内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*トリガーが定義されているテンプレートの (SQLクエリによって) 並べ替えられたコンマ区切りのリスト。トリガーがホストで定義されている場合は \*UNKNOWN\*| |{TRIGGER.URL}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガーベースの内部通知<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*トリガーURL*| |{TRIGGER.VALUE}|→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ トリガー式<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts)|*現在のトリガー状態の数値*: 0 - トリガーはOK状態 1 - トリガーは障害状態| |{TRIGGERS.UNACK}|→ マップ要素のラベル|*マップ要素の未承認トリガー数。トリガーの状態は無視されます。*<br>障害イベントの少なくとも 1 つが未承認の場合、トリガーは未承認と見なされます。| |{TRIGGERS.PROBLEM.UNACK}|→ マップ要素のラベル|*マップ要素の未承認障害トリガー数*<br>障害イベントの少なくとも 1 つが未承認の場合、トリガーは未承認であると見なされます。| |{TRIGGERS.ACK}|→ マップ要素のラベル|*トリガーの状態を無視した、マップ要素の承認されたトリガー数*<br>すべての障害イベントが承認された場合、トリガーは承認されたと見なされます。| |{TRIGGERS.PROBLEM.ACK}|→ マップ要素のラベル|*マップ要素の承認された障害トリガー数*<br>すべての障害イベントが承認された場合、トリガーは承認されたと見なされます。| |{USER.FULLNAME}|→ 障害更新通知とコマンド<br>→ 手動ホスト アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*イベント確認を追加した、またはスクリプトを開始したユーザーの名前、姓、およびユーザー名*<br>3.4.0 以降の障害更新、5.0.2 以降のグローバル スクリプトでサポート| |{USER.NAME}|→ 手動ホスト アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*スクリプトを開始したユーザー名*<br>5.0.2 以降でサポートされています。| |{USER.SURNAME}|→ 手動ホスト アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*スクリプトを開始したユーザーの姓*。<br>5.0.2 以降でサポートされています| |{USER.USERNAME}|→ 手動ホスト アクション [スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)<br>→ 手動イベントアクション[スクリプト](/manual/web_interface/frontend_sections/administration/scripts) (including confirmation text)|*スクリプトを開始したユーザーの名*。<br>5.0.2 以降でサポート。<br>Zabbix 5.4.0 より前にサポートされていた {USER.ALIAS} は非推奨になりました。| |{$MACRO}|→ 参照: [場所によってサポートされているユーザー マクロ](/manual/appendix/macros/supported_by_location_user)|*[ユーザー定義可能](/manual/config/macros/user_macros) マクロ.*| |{\#MACRO}|→ 参照: [場所によってサポートされているユーザー マクロ](/manual/config/macros/lld_macros)|*ローレベルディスカバリマクロ*<br><br>[カスタマイズ](/manual/config/macros/macro_functions) Zabbix 4.0.0以降、このマクロでマクロ値がサポートされています。| |{?EXPRESSION}|→ トリガーイベント名<br>→ トリガーベースの通知とコマンド<br>→ 障害更新通知とコマンド<br>→ マップ要素のラベル^[3](supported_by_location#footnotes)^<br>→ マップ シェープ ラベル^[3](supported_by_location#footnotes)^<br>→ マップ内のリンク ラベル^[3](supported_by_location#footnotes)^<br>→ グラフ名^[5](supported_by_location#footnotes)^|参照:[式マクロ](/manual/config/macros/expression_macros).<br>5.2.0 以降でサポートされています| #### Overview The trigger list for a host can be accessed from *Configuration → Hosts* by clicking on *Triggers* for the respective host. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Severity*|Severity of the trigger is displayed by both name and cell background color.| |*Value*|Trigger value is displayed:<br>**OK** - the trigger is in the OK state<br>**PROBLEM** - the trigger is in the Problem state| |*Host*|Host of the trigger.<br>This column is displayed only if multiple hosts are selected in the filter.| |*Name*|Name of the trigger, displayed as a blue link to trigger details.<br>Clicking on the trigger name link opens the trigger [configuration form](/manual/config/triggers/trigger#configuration).<br>If the host trigger belongs to a template, the template name is displayed before the trigger name, as a gray link. Clicking on the template link will open the trigger list on the template level.<br>If the trigger has been created from a trigger prototype, its name is preceded by the low-level discovery rule name, in orange. Clicking on the discovery rule name will open the trigger prototype list.| |*Operational data*|Operational data definition of the trigger, containing arbitrary strings and macros that will resolve dynamically in *Monitoring* → *Problems*.| |*Expression*|Trigger expression is displayed. The host-item part of the expression is displayed as a link, leading to the item configuration form.| |*Status*|Trigger status is displayed - *Enabled*, *Disabled* or *Unknown*. By clicking on the status you can change it - from Enabled to Disabled (and back); from Unknown to Disabled (and back).<br>Problems of a disabled trigger are no longer displayed in the frontend, but are not deleted.| |*Info*|If everything is working correctly, no icon is displayed in this column. In case of errors, a square icon with the letter "i" is displayed. Hover over the icon to see a tooltip with the error description.| |*Tags*|If a trigger contains tags, tag name and value are displayed in this column.| To configure a new trigger, click on the *Create trigger* button at the top right corner. #### 概要 ホストのトリガーリストには、*設定 → ホスト*からホストの*トリガー*をクリックしてアクセスできます。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*深刻度*|トリガーの深刻度は名前とセルの背景色の両方で表示されます。| |*値*|トリガー値が表示されます。<br> **OK** - トリガーのステータスは OK です<br>**障害** - トリガーのステータスは 障害 です。| |*ホスト*|トリガーのホスト。<br>この列は、フィルターで複数のホストが選択されている場合にのみ表示されます。| |*名前*|トリガーの名前。トリガー詳細へのリンクとして表示されます。<br>トリガー名のリンクをクリックすると、トリガー[設定フォーム](/manual/config/triggers/trigger#configuration)が開きます。<br>ホストトリガーのテンプレートに属している場合、テンプレート名はトリガー名の前に灰色のリンクとして表示されます。テンプレートリンクをクリックすると、テンプレートレベルでトリガーリストが開きます。<br>トリガーがプロトタイプトリガーから作成されている場合、その名前の前に、オレンジ色の低レベルディスカバリルール名が表示されます。ディスカバリルール名をクリックすると、プロトタイプトリガーリストが開きます。| |*運用データ*|*監視データ* → *障害*で動的に解決される任意の文字列とマクロを含む、トリガーの操作データ定義。| |*条件式*|トリガー式が表示されます。式のホスト-アイテム部分はアイテム設定フォームにつながるリンクとして表示されます。| |*ステータス*|トリガーステータスが表示されます - *有効*,*無効*,*不明*。ステータスをクリックすると、ステータスを有効から無効（およびその逆）または不明から無効（およびその逆）に変更できます。<br>無効なトリガーの障害はフロントエンドに表示されなくなりましたが、削除されません。| |*情報*|すべてが正常に機能している場合、この列にアイコンは表示されません。エラーが発生した場合は、*i*の文字が付いた正方形のアイコンが表示されます。アイコンにカーソルを合わせると、エラーの説明が記載されたツールチップが表示されます。| |*タグ*|トリガーにタグが含まれている場合、タグの名前と値がこの列に表示されます。| 新しいトリガーを構成するには、右上隅にある*トリガーの作成*ボタンをクリックします。 #### Overview The webhook media type is useful for making HTTP calls using custom JavaScript code for straightforward integration with external software such as helpdesk systems, chats, or messengers. You may choose to import an integration provided by Zabbix or create a custom integration from scratch. #### 概要 webhook メディアタイプは、ヘルプデスクシステム、チャット、メッセンジャーなどの外部ソフトウェアと簡単に統合するために、<br> カスタム JavaScript コードを使用して HTTP コールを行うのに便利です。Zabbix が提供する統合機能をインポートするか、<br> カスタム統合機能を一から作成することができます。 #### Overview The web scenario list for a host can be accessed from *Configuration → Hosts* by clicking on *Web* for the respective host. A list of existing web scenarios is displayed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the web scenario. Clicking on the web scenario name opens the web scenario [configuration form](/manual/web_monitoring#configuring_a_scenario).<br>If the host web scenario belongs to a template, the template name is displayed before the web scenario name as a gray link. Clicking on the template link will open the web scenario list on the template level.| |*Number of steps*|The number of steps the scenario contains.| |*Update interval*|How often the scenario is performed.| |*Attempts*|How many attempts for executing web scenario steps are performed.| |*Authentication*|Authentication method is displayed - Basic, NTLM, or None.| |*HTTP proxy*|Displays HTTP proxy or 'No' if not used.| |*Status*|Web scenario status is displayed - *Enabled* or *Disabled*.<br>By clicking on the status you can change it.| |*Tags*|Web scenario tags are displayed.<br>Up to three tags (name:value pairs) can be displayed. If there are more tags, a "..." link is displayed that allows to see all tags on mouseover.| |*Info*|If everything is working correctly, no icon is displayed in this column. In case of errors, a square icon with the letter "i" is displayed. Hover over the icon to see a tooltip with the error description.| To configure a new web scenario, click on the *Create web scenario* button at the top right corner. #### 概要 テンプレートのWebシナリオリストには、*設定 → テンプレート*からそれぞれのテンプレートの*Web*をクリックしてアクセスできます。 既存のWebシナリオのリストが表示されます。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|Webシナリオの名前。 Webシナリオ名をクリックすると、Webシナリオ[設定フォーム](/manual/web_monitoring#configuring_a_scenario)が開きます。<br>Webシナリオが別のテンプレートから継承されている場合、テンプレート名はWebシナリオ名の前に灰色で表示されます。 テンプレートリンクをクリックすると、そのテンプレートレベルでWebシナリオリストが開きます。| |*ステップ数*|シナリオに含まれるステップ数| |*監視間隔*|シナリオが実行される頻度| |*試行回数*|Webシナリオステップを実行するための試行回数| |*認証*|認証方法が表示されます - Basic,NTLMはなし| |*HTTPプロキシ*|HTTPプロキシを表示します。使用しない場合は「いいえ」を表示します。| |*ステータス*|Webシナリオのステータスが表示されます - *有効*または*無効*。<br>ステータスをクリックすると、ステータスを変更できます。| |*タグ*|Webシナリオタグが表示されます。<br>最大3つのタグ（名前：値のペア）を表示できます。 タグがさらにある場合は「...」リンクが表示され、マウスオーバーですべてのタグを表示できます。| |*情報*|すべてが正常に機能している場合、この列にアイコンは表示されません。 エラーが発生した場合は、「i」の文字が付いた正方形のアイコンが表示されます。 アイコンにカーソルを合わせると、エラーの説明が記載されたツールチップが表示されます。| 新しいWebシナリオを構成するには、右上隅にある*Webシナリオの作成*ボタンをクリックします。 #### Overview The web scenario list for a template can be accessed from *Configuration → Templates* by clicking on *Web* for the respective template. A list of existing web scenarios is displayed. {width="600"} Displayed data: |Column|Description| |------|-----------| |*Name*|Name of the web scenario. Clicking on the web scenario name opens the web scenario [configuration form](/manual/web_monitoring#configuring_a_scenario).<br>If the web scenario is inherited from another template, the template name is displayed before the web scenario name, as a gray link. Clicking on the template link will open the web scenarios list on that template level.| |*Number of steps*|The number of steps the scenario contains.| |*Update interval*|How often the scenario is performed.| |*Attempts*|How many attempts for executing web scenario steps are performed.| |*Authentication*|Authentication method is displayed - Basic, NTLM on None.| |*HTTP proxy*|Displays HTTP proxy or 'No' if not used.| |*Status*|Web scenario status is displayed - *Enabled* or *Disabled*.<br>By clicking on the status you can change it.| |*Tags*|Web scenario tags are displayed.<br>Up to three tags (name:value pairs) can be displayed. If there are more tags, a "..." link is displayed that allows to see all tags on mouseover.| To configure a new web scenario, click on the *Create web scenario* button at the top right corner. #### 概要 テンプレートのWebシナリオリストには、*設定→テンプレート*からそれぞれのテンプレートの*Web*をクリックしてアクセスできます。 既存のWebシナリオのリストが表示されます。 {width="600"} 表示情報 |列|詳細| |------|-----------| |*名前*|Webシナリオの名前。 Webシナリオ名をクリックすると、Webシナリオ[設定フォーム](/manual/web_monitoring#configuring_a_scenario)が開きます。<br>Webシナリオが別のテンプレートから継承されている場合、テンプレート名はWebシナリオ名の前に灰色で表示されます。 テンプレートリンクをクリックすると、そのテンプレートレベルでWebシナリオリストが開きます。| |*ステップ数*|シナリオに含まれるステップ数| |*監視間隔*|シナリオが実行される頻度| |*試行回数*|Webシナリオステップを実行するための試行回数| |*認証*|認証方法が表示されます - Basic,NTLMはなし| |*HTTPプロキシ*|HTTPプロキシを表示します。使用しない場合は「いいえ」を表示します。| |*ステータス*|Webシナリオのステータスが表示されます - *有効*または*無効*。<br>ステータスをクリックすると、ステータスを変更できます。| |*タグ*|Webシナリオタグが表示されます。<br>最大3つのタグ（名前：値のペア）を表示できます。 タグがさらにある場合は「...」リンクが表示され、マウスオーバーですべてのタグを表示できます。| 新しいWebシナリオを構成するには、右上隅にある*Webシナリオの作成*ボタンをクリックします。 #### Overview This item type allows data polling using the HTTP/HTTPS protocol. Trapping is also possible using Zabbix sender or Zabbix sender protocol. HTTP item check is executed by Zabbix server. However, when hosts are monitored by a Zabbix proxy, HTTP item checks are executed by the proxy. HTTP item checks do not require any agent running on a host being monitored. HTTP agent supports both HTTP and HTTPS. Zabbix will optionally follow redirects (see the *Follow redirects* option below). Maximum number of redirects is hard-coded to 10 (using cURL option CURLOPT\_MAXREDIRS). ::: noteimportant Zabbix server/proxy must be initially configured with cURL (libcurl) support. ::: #### 概要 このアイテムタイプでは、HTTP/HTTPSプロトコルを使用したデータ ポーリングが可能です。Zabbix senderまたはZabbix senderプロトコルを使用したトラッピングも可能です。 HTTP監視アイテムはZabbixサーバーによって実行されます。ただし、ホストがZabbixプロキシ経由で監視されている場合、HTTPアイテムチェックはZabbixプロキシで実行されます。 HTTP監視アイテムでは、監視対象のホストでエージェントが実行されている必要はありません。 HTTPエージェントはHTTPとHTTPSの両方をサポートします。Zabbixはオプションでリダイレクトに従います (以下の[リダイレクトをたどる]オプションを参照)。リダイレクトの最大数は10にハードコードされています(cURLオプションCURLOPT_MAXREDIRSを使用)。 ::: noteimportant Zabbixサーバ/Zabbixプロキシは、cURL(libcurl)をサポートした状態で初期設定されている必要があります。 ::: #### Overview This page provides a list of cookies used by Zabbix. |Name|Description|Values|Expires/Max-Age|HttpOnly^[1](#footnotes)^|Secure^[2](#footnotes)^| |--|------|--|------|--|--| |ZBX\_SESSION\_NAME|Zabbix frontend session data, stored as JSON encoded by base64| |Session (expires when the browsing session ends)|\+|\+ (only if HTTPS is enabled on a web server)| |tab|Active tab number; this cookie is only used on pages with multiple tabs (e.g. *Host*, *Trigger* or *Action* configuration page) and is created, when a user navigates from a primary tab to another tab (such as *Tags* or *Dependencies* tab).<br><br>0 is used for the primary tab.|Example: 1|Session (expires when the browsing session ends)|\-|\-| |browserwarning\_ignore|Whether a warning about using an outdated browser should be ignored.|yes|Session (expires when the browsing session ends)|\-|\-| |system-message-ok|A message to show as soon as page is reloaded.|Plain text message|Session (expires when the browsing session ends) or as soon as page is reloaded|\+|\-| |system-message-error|An error message to show as soon as page is reloaded.|Plain text message|Session (expires when the browsing session ends) or as soon as page is reloaded|\+|\-| ::: noteclassic Forcing 'HttpOnly' flag on Zabbix cookies by a webserver directive is not supported. ::: #### Footnotes ^**1**^ When `HttpOnly` is 'true' the cookie will be made accessible only through the HTTP protocol. This means that the cookie won't be accessible by scripting languages, such as JavaScript. This setting can effectively help to reduce identity theft through XSS attacks (although it is not supported by all browsers). ^**2**^ `Secure` indicates that the cookie should only be transmitted over a secure HTTPS connection from the client. When set to 'true', the cookie will only be set if a secure connection exists. #### 概要 This page provides a list of cookies used by Zabbix. |名前|説明|値|範囲/最大-最小|HttpOnly^[1](#脚注)^|Secure^[2](#脚注)^| |--|------|--|------|--|--| |ZBX\_SESSION\_NAME|Zabbix Webインタフェース・セッションデータ(base64でエンコードされたJSONとして保存)| |セッション(ブラウジングセッションが終了すると期限切れ)|\+|\+ (WebサーバーでHTTPSが有効になっている場合のみ)| |tab|アクティブなタブ番号。この Cookieは、複数のタブがあるページ(*ホスト*、*トリガー*、または *アクション* 設定ページなど)でのみ使用され、ユーザーがプライマリタブから別のタブ (*タグ*または*依存関係*タブなど)に移動したときに作成されます。<br><br>プライマリタブには0が使用されます。|例: 1|セッション(ブラウジングセッションが終了すると期限切れ)|\-|\-| |browserwarning\_ignore|古いブラウザの使用に関する警告を無視するかどうか|yes|セッション(ブラウジングセッションが終了すると期限切れ)|\-|\-| |system-message-ok|ページがリロードされるとすぐに表示されるメッセージ|プレーンテキストメッセージ|セッション(ブラウジングセッションが終了すると期限切れ)またはページがリロードされると直ぐに|\+|\-| |system-message-error|ページがリロードされるとすぐに表示されるエラーメッセージ|プレーンテキストメッセージ|セッション(ブラウジングセッションが終了すると期限切れ)またはページがリロードされると直ぐに|\+|\-| ::: noteclassic Webサーバーディレクティブ'HttpOnly'をZabbix用Cookieにを設定することはサポートされていません。 ::: #### 脚注 ^**1**^ `HttpOnly`が 'true'の場合、CookieはHTTP プロトコル経由でのみアクセス可能になります。つまり、JavaScriptなどのスクリプト言語ではCookieにアクセスできません。この設定は、XSS 攻撃による個人情報の流出を効果的に減らすのに役立ちます (ただし、すべてのブラウザーでサポートされているわけではありません)。 ^**2**^ `Secure`は、Cookie がクライアントからの安全な HTTPS 接続を介してのみ送信されることを示します。`true`に設定すると、安全な接続が存在する場合にのみCookieが設定されます。 #### Overview This page provides examples of using correct escaping when using regular expressions in various contexts. :::notetip When using the trigger expression constructor, correct escaping in regular expressions is added automatically. ::: #### 概要 このページでは、さまざまなコンテキストで正規表現を使用する際に正しいエスケープを使用する例を示します。 :::notetip トリガー式コンストラクターを使用すると、正規表現に正しいエスケープが自動的に追加されます。 ::: ### Overview This page provides the steps required to build a loadable plugin binary from the sources. If the source tarball is downloaded, it is possible to build the plugin offline, i.e. without the internet connection. The PostgreSQL plugin is used as an example. Other loadable plugins can be built in a similar way. ### 概要 このページでは、ソースからロード可能なプラグインのバイナリを構築するために必要な手順を説明します。 ソースtarballをダウンロードしていれば、プラグインをオフラインで、つまりインターネットに接続せずに構築できます。 PostgreSQLプラグインが例として使用されます。他のロード可能なプラグインも同様の方法で構築できます。 ### Overview This section allows to view and [configure](/manual/it_services/sla) SLAs. ### 概要 このセクションではSLAを表示および[設定](/manual/it_services/sla)することができます。 ### Overview This section allows to view [SLA](/manual/it_services/sla) reports, based on the criteria selected in the filter. SLA reports can also be displayed as a [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/sla_report). ### 概要 このセクションでは、フィルターで選択した基準に基づいて、[SLA](/manual/it_services/sla) レポートを表示できます。 SLAレポートは[ダッシュボードウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/sla_report)として表示することもできます。 #### Overview This section contains a list of locations, where [user-definable](/manual/config/macros/user_macros) macros are supported. ::: noteclassic Only global-level user macros are supported for *Actions*, *Network discovery*, *Proxies* and all locations listed under *Other locations* section of this page. In the mentioned locations, host-level and template-level macros will not be resolved. ::: #### 概要 このセクションには[ユーザー定義可能](/manual/config/macros/user_macros)マクロがサポートされている場所のリストが含まれています。 ::: noteclassic *アクション*、*ネットワークディスカバリ*、*プロキシ*、およびこのページの*その他の場所*セクションにリストされているすべての場所でサポートされているのは、グローバルレベルのユーザーマクロのみです。 上記の場所では、ホストレベルおよびテンプレートレベルのマクロは解決されません。 ::: ### Overview This section contains best practices that should be observed in order to set up Zabbix in a secure way. The practices contained here are not required for the functioning of Zabbix. They are recommended for better security of the system. ### 概要 このセクションには、Zabbix を安全な方法で設定するために遵守すべきベスト プラクティスが含まれています。 ここに含まれるプラクティスは、Zabbix の機能には必要ありません。 システムのセキュリティを強化するために推奨されます。 #### Overview This section contains descriptions of configuration file parameters for Zabbix agent 2 plugins. Please use the sidebar to access information about the specific plugin. #### 概要 このセクションには、Zabbix エージェント 2プラグインの設定ファイルパラメータの説明が含まれています。 特定のプラグインに関する情報にアクセスするには、サイドバーを使用してください。 #### Overview This section contains instructions for creating Oracle database and configuring connections between the database and Zabbix server, proxy, and frontend. #### 概要 このセクションにはOracleデータベースを作成し、データベースとZabbixサーバー、プロキシ、およびフロントエンド間の接続を構成する手順が含まれています。 #### Overview This section demonstrates how to build Zabbix agent 2 (Windows) from sources. #### 概要 このセクションでは、Zabbixエージェント2 (Windows)をソースコードからビルドする方法を説明します。 #### Overview This section demonstrates how to build Zabbix macOS agent binaries from sources with or without TLS. #### 概要 このセクションでは、TLSの有無にかかわらず、ソースからZabbix macOSエージェントのバイナリをビルドする方法を説明します。 #### Overview This section demonstrates how to build Zabbix Windows agent binaries from sources with or without TLS. #### 概要 このセクションでは、TLSの有無にかかわらず、ソースからZabbix Windowsエージェントのバイナリをビルドする方法を説明します。 ### Overview This section describes a simple setup for monitoring Zabbix high availability cluster as a service. ### 概要 このセクションでは、Zabbix高可用性クラスターをサービスとして監視するためのセットアップについて説明します。 ### Overview This section describes the steps for resetting user passwords in Zabbix. ### 概要 このセクションでは、Zabbixのユーザーパスワードをリセットする手順について説明します。 ### Overview This section describes Zabbix additions to the JavaScript language implemented with Duktape and supported global JavaScript functions. ### 概要 このセクションではJavaScript言語のDuktapeで実装されたZabbixの追加機能とサポートされているグローバルJavaScript関数について説明します。 #### Overview This section explains how to add a “Host group” type element when configuring a [network map](/manual/config/ visualization/maps/map). #### 概要 このセクションでは、[ネットワークマップ](/manual/config/visualization/maps/map)を設定する際に、“ホストグループ”タイプの要素を追加する方法について説明します。 #### Overview This section lists parameters supported in a Zabbix agent configuration file (zabbix\_agentd.conf). Note that: - The default values reflect daemon defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported in the beginning of the line. #### 概要 このセクションでは、Zabbixエージェント設定ファイル(zabbix\_agentd.conf)でサポートされているパラメータの一覧を提示します。 注意点: - デフォルト値は、出荷時設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングでのみ構成ファイルをサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in a Zabbix agent (Windows) configuration file (zabbix\_agentd.conf). Note that: - The default values reflect daemon defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported in the beginning of the line. #### 概要 このセクションでは、Zabbixエージェント(Windows)の設定ファイルァイル(zabbix\_agent.conf)でサポートされているパラメーターの一覧を提示します。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、デーモンのデフォルト値です。 - Zabbixは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングでのみ構成ファイルをサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in a Zabbix proxy configuration file (zabbix\_proxy.conf). Note that: - The default values reflect daemon defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported in the beginning of the line. #### 概要 このセクションでは、Zabbixプロキシ設定ファイル(zabbix\_proxy.conf)でサポートされているパラメータの一覧を提示します。 注意点: - デフォルト値は、出荷時設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングでのみ構成ファイルをサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in a Zabbix server configuration file (zabbix\_server.conf). Note that: - The default values reflect daemon defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported in the beginning of the line. #### 概要 このセクションでは、Zabbixサーバー設定ファイル(zabbix\_server.conf)でサポートされているパラメーターを一覧表示します。 注意点: - デフォルト値は、出荷時設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングでのみ構成ファイルをサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in the Ceph Zabbix agent 2 plugin configuration file (ceph.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### 概要 このセクションでは、Ceph Zabbixエージェント2プラグイン設定ファイル（ceph.conf）でサポートされているパラメーターの一覧を提示します。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングでのみ構成ファイルをサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in the Docker Zabbix agent 2 plugin configuration file (docker.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### 概要 このセクションではDocker Zabbixエージェント2プラグイン設定ファイル(docker.conf)でサポートされているパラメーターを一覧表示します。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in the Ember+ Zabbix agent 2 plugin configuration file (ember.conf). The Ember+ plugin is a loadable plugin and is available and fully described in the [Ember+ plugin repository](https://git.zabbix.com/projects/AP/repos/ember-plus/browse?at=refs%2Fheads%2Frelease%2F6.0). This plugin is supported since Zabbix 6.0.30 and currently only available to be built from the source (for both Unix and Windows). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### 概要 このセクションでは、Ember+ Zabbixエージェント2プラグイン設定ファイル(ember.conf) でサポートされているパラメータを一覧表示します。 Ember+ プラグインはロード可能なプラグインであり、[Ember+プラグイン・リポジトリ](https://git.zabbix.com/projects/AP/repos/ember-plus/browse?at=refs%2Fheads%2Frelease%2F6.0)で利用可能であり、詳細な説明が記載されています。 このプラグインは Zabbix 6.0.30 以降でサポートされており、現在はソースからビルドすることのみ可能です (Unix と Windows の両方)。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in the Memcached Zabbix agent 2 plugin configuration file (memcached.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### 概要 このセクションでは、Memcached Zabbixエージェント2プラグイン設定ファイル(memcached.conf)でサポートされているパラメーターを一覧表示します。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in the Modbus Zabbix agent 2 plugin configuration file (modbus.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### 概要 このセクションではModbus Zabbixエージェント2プラグイン設定ファイル(modbus.conf)でサポートされているパラメーターの一覧を提示します。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in the MongoDB Zabbix agent 2 plugin configuration file (mongo.conf). Since Zabbix 6.0.6, the MongoDB plugin is a loadable plugin and is available and fully described in the [MongoDB plugin repository](https://git.zabbix.com/projects/AP/repos/mongodb/browse?at=refs%2Fheads%2Frelease%2F6.0). Pre-compiled plugin binaries for Windows are available since [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) and are compatible with previous 6.0 versions. Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### 概要 このセクションでは、MongoDB Zabbixエージェント2プラグイン設定ファイル(mongo.conf) でサポートされているパラメータを一覧表示します。 Zabbix 6.0.6 以降、MongoDB プラグインはロード可能なプラグインであり、[MongoDB プラグイン リポジトリ](https://git.zabbix.com/projects/AP/repos/mongodb/browse?at=refs%2Fheads%2Frelease%2F6.0) で利用可能であり、詳細な説明が記載されています。 Windows 用のコンパイル済みプラグイン バイナリは [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) 以降で利用可能であり、以前の 6.0 バージョンと互換性があります。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in the MQTT Zabbix agent 2 plugin configuration file (mqtt.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### 概要 このセクションでは、MQTT Zabbixエージェント2プラグイン設定ファイル(mqtt.conf) でサポートされているパラメータを一覧表示します。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in the MSSQL Zabbix agent 2 plugin configuration file (mssql.conf). The MSSQL plugin is a loadable plugin and is available and fully described in the [MSSQL plugin repository](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0). This plugin is supported since Zabbix 6.0.27. Pre-compiled plugin binaries for Windows are available since [Zabbix 6.0.28](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.28/) and are compatible with 6.0.27 version. Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### 概要 このセクションでは、MSSQL Zabbixエージェント2プラグイン設定ファイル(mssql.conf) でサポートされているパラメータを一覧表示します。 MSSQL プラグインはロード可能なプラグインであり、[MSSQL プラグイン リポジトリ](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0) で利用可能であり、詳細な説明が記載されています。 このプラグインは、Zabbix 6.0.27以降でサポートされています。 Windows用のコンパイル済みプラグインバイナリは、[Zabbix 6.0.28](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.28/) 以降で利用可能であり、6.0.27バージョンと互換性があります。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in the MySQL Zabbix agent 2 plugin configuration file (mysql.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### 概要 このセクションでは、MySQL Zabbixエージェント2プラグイン設定ファイル(mysql.conf) でサポートされているパラメータを一覧表示します。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section lists parameters supported in the Oracle Zabbix agent 2 plugin configuration file (oracle.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### 概要 このセクションでは、Oracle Zabbixエージェント2プラグイン設定ファイル(oracle.conf) でサポートされているパラメータを一覧表示します。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 ### Overview This section lists parameters supported in the PostgreSQL Zabbix agent 2 plugin configuration file (postgresql.conf). Since Zabbix 6.0.10, the PostgreSQL plugin is a loadable plugin and is available and fully described in the [PostgreSQL plugin repository](https://git.zabbix.com/projects/AP/repos/postgresql/browse?at=refs%2Fheads%2Frelease%2F6.0). Pre-compiled plugin binaries for Windows are available since [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) and are compatible with previous 6.0 versions. Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. ### 概要 このセクションでは、PostgreSQL Zabbixエージェント2プラグイン設定ファイル(postgresql.conf)でサポートされているパラメータを一覧表示します。 Zabbix 6.0.10 以降、PostgreSQLプラグインはロード可能なプラグインであり、[PostgreSQLプラグインリポジトリ](https://git.zabbix.com/projects/AP/repos/postgresql/browse?at=refs%2Fheads%2Frelease%2F6.0) で利用可能であり、詳細な説明が記載されています。 Windows用のコンパイル済みプラグインバイナリは [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) 以降で利用可能であり、以前の 6.0 バージョンと互換性があります。 参考情報: - 一般的なZabbixエージェント2の設定パラメーターの説明: [Zabbixエージェント2 (UNIX)](/manual/appendix/config/zabbix_agent2) / [Zabbixエージェント2 (Windows)](/manual/appendix/config/zabbix_agent2_win) - [プラグイン](/manual/config/items/plugins)の設定手順 #### Overview This section lists parameters supported in the Redis Zabbix agent 2 plugin configuration file (redis.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### 概要 このセクションではRedis Zabbix エージェント 2 プラグイン設定ファイル(redis.conf)でサポートされているパラメーターの一覧を提示します。 注意点: - デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。 - Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。 - 行の先頭が"\＃"で始まった場合のみコメントとして認識されます。 #### Overview This section presents a step-by-step real-life example of how web monitoring can be used. Let's use Zabbix web monitoring to monitor the web interface of Zabbix. We want to know if it is available, provides the right content and how quickly it works. To do that we also must log in with our user name and password. #### 概要 このセクションでは、Webモニタリングの実例を段階的に提示します。 Zabbix Webモニタリングを使用して、ZabbixのWebインターフェイスをモニタリングしてみましょう。それが利用可能かどうか、適切なコンテンツを提供するかどうか、そしてそれがどれだけ速く機能するかを調査します。そのためにはユーザー名とパスワードを使用してログインする必要があります。 #### Overview This section presents examples of using preprocessing steps to accomplish some practical tasks. #### 概要 このセクションでは、保存前処理のステップを使用していくつかの実用的なタスクを実行する例を紹介します。 #### Overview This section provides details of preprocessing by JavaScript. #### 概要 このセクションでは、JavaScriptによる保存前処理について詳しく説明します。 #### Overview This section provides details of supported JSONPath functionality in item value preprocessing steps. JSONPath consists of segments separated with dots. A segment can be either a simple word like a JSON value name, `*` or a more complex construct enclosed within square brackets `[` `]`. The separating dot before bracket segment is optional and can be omitted. For example: |Path|Description| |----|-----------| |`$.object.name`|Return the object.name contents.| |`$.object['name']`|Return the object.name contents.| |`$.object.['name']`|Return the object.name contents.| |`$["object"]['name']`|Return the object.name contents.| |`$.['object'].["name"]`|Return the object.name contents.| |`$.object.history.length()`|Return the number of object.history array elements.| |`$[?(@.name == 'Object')].price.first()`|Return the price field of the first object with name 'Object'.| |`$[?(@.name == 'Object')].history.first().length()`|Return the number of history array elements of the first object with name 'Object'.| |`$[?(@.price > 10)].length()`|Return the number of objects with price being greater than 10.| See also: [Escaping special characters from LLD macro values in JSONPath](/manual/config/items/preprocessing/jsonpath_functionality/escaping_lld_macros). #### 概要 このセクションでは、item 値のプリプロセスステップでサポートされる JSONPath 機能の詳細について説明します。 JSONPathは、ドットで区切られたセグメントで構成されます。<br> セグメントは、JSON 値の名前 `*` のような単純な単語と、あるいは角括弧 `[` `]` で囲まれたより複雑な構造体です。<br> セグメントを区切るドットはオプションで、省略することもできます。例えば<br> |Path|説明| |----|-----------| |`$.object.name`|Return the object.name contents.| |`$.object['name']`|Return the object.name contents.| |`$.object.['name']`|Return the object.name contents.| |`$["object"]['name']`|Return the object.name contents.| |`$.['object'].["name"]`|Return the object.name contents.| |`$.object.history.length()`|Return the number of object.history array elements.| |`$[?(@.name == 'Object')].price.first()`|Return the price field of the first object with name 'Object'.| |`$[?(@.name == 'Object')].history.first().length()`|Return the number of history array elements of the first object with name 'Object'.| |`$[?(@.price > 10)].length()`|Return the number of objects with price being greater than 10.| [Escaping special characters from LLD macro values in JSONPath](/manual/config/items/preprocessing/jsonpath_functionality/escaping_lld_macros) も参照してください。 #### Overview This section provides details on passive and active checks performed by [Zabbix agent](/manual/config/items/itemtypes/zabbix_agent). Zabbix uses a JSON based communication protocol for communicating with Zabbix agent. See also: [Zabbix agent 2](/manual/appendix/protocols/zabbix_agent2) protocol details. #### 概要 このセクションでは、[Zabbix agent](/manual/config/items/itemtypes/zabbix_agent)によって実行されるパッシブおよびアクティブ チェックの詳細について説明します。 Zabbix は、Zabbix エージェントとの通信に JSON ベースの通信プロトコルを使用します。 参照: [Zabbix agent 2](/manual/appendix/protocols/zabbix_agent2) プロトコルの詳細。 #### Overview This section provides guidelines for configuring single sign-on into Zabbix from Microsoft Entra ID (formerly Microsoft Azure Active Directory) using SAML 2.0 authentication. Note that for single sign-on to work its username must exist in Zabbix, however, its Zabbix password will not be used. If authentication is successful, then Zabbix will match a local username with the username attribute returned by SAML. #### 概要 このセクションでは、SAML 2.0 認証を使用して Microsoft Entra ID（旧 Microsoft Azure Active Directory）から Zabbix へのシングルサインオンを設定するためのガイドラインを示します。 シングルサインオンが機能するには、ユーザー名が Zabbix に存在している必要がありますが、Zabbix パスワードは使用されません。認証が成功すると、Zabbix はローカルのユーザー名と SAML によって返されるユーザー名属性を照合します。 ### Overview This section provides information on: * Agent2 -> Server : active checks request * Server -> Agent2 : active checks response * Agent2 -> Server : agent data request * Server -> Agent2 : agent data response ### 概要 このセクションでは、次の情報を提供します * Agent2 -> Server : アクティブチェックリクエスト * Server -> Agent2 : アクティブチェックレスポンス * Agent2 -> Server : エージェントデータリクエスト * Server -> Agent2 : エージェントデータレスポンス #### Overview This section provides instructions on installing Zabbix web service and configuring Zabbix to enable generation of [scheduled reports](/manual/config/reports). ::: noteimportant Currently the support of scheduled reports is experimental. ::: #### 概要 このセクションでは、Zabbix Webサービスをインストールし、スケジュールにそってレポートを生成するようにZabbixを設定する手順について説明します。 ::: noteimportant 現在、定期レポートのサポートは試験的です。 ::: #### Overview This section provides item value preprocessing details. Item value preprocessing allows to define and execute [transformation rules](/manual/config/items/preprocessing) for the received item values. Preprocessing is managed by a preprocessing manager process, which was added in Zabbix 3.4, along with preprocessing workers that perform the preprocessing steps. All values (with or without preprocessing) from different data gatherers pass through the preprocessing manager before being added to the history cache. Socket-based IPC communication is used between data gatherers (pollers, trappers, etc) and the preprocessing process. Either Zabbix server or Zabbix proxy (for items monitored by the proxy) is performing preprocessing steps. #### 概要 ここでは、item 値のプリプロセッシングについて説明します。item 値のプリプロセッシングでは、<br> 受け取ったitem 値に対して[transformation rules](/manual/config/items/preprocessing)を定義し、実行することができます。 プリプロセスは、Zabbix3.4で追加されたプリプロセスマネージャプロセスとプリプロセスワーカーによって管理され、<br> プリプロセスのステップを実行することができます。<br> プリプロセスのステップは、異なるデータ収集元からのすべての値(プリプロセスあり/なし)が、<br> ヒストリーキャッシュに追加される前に、プリプロセッシングマネージャを通過します。<br> データ収集装置（ポーラ、トラッパーなど）とプリプロセスの間で、ソケットベースのIPC通信が使用されます。<br> Zabbix server またはZabbix proxy(proxy が監視する item の場合)のどちらかがプリプロセスを実行します。 ### Overview This section provides several encryption configuration examples for CentOS 8.2 and MySQL 8.0.21 and can be used as a quickstart guide for encrypting the connection to the database.  ::: noteimportant If MySQL host is set to localhost, encryption options will not be available. In this case a connection between Zabbix frontend and the database uses a socket file (on Unix) or shared memory (on Windows) and cannot be encrypted. ::: ::: noteclassic List of encryption combinations is not limited to the ones listed on this page. There are a lot more combinations available. ::: ### 概要 このセクションはCentOS8.2およびMySQL8.0.21の暗号化設定の例をいくつか示し、データベースへの接続を暗号化するためのクイックスタートガイドとして使用できます。 ::: noteimportant MySQLホストがlocalhostに設定されている場合、暗号化オプションは使用できません。この場合、Zabbixフロントエンドとデータベース間の接続はソケットファイル（Unixの場合）または共有メモリ（Windowsの場合）を使用し、暗号化できません。 ::: ::: noteclassic 暗号化の組み合わせのリストは、このページにリストされているものに限定されません。利用できる組み合わせはもっとたくさんあります。 ::: ### Overview This section provides several encryption configuration examples for CentOS 8.2 and PostgreSQL 13. ::: noteclassic Connection between Zabbix frontend and PostgreSQL cannot be encrypted (parameters in GUI are disabled), if the value of *Database host* field begins with a slash or the field is empty. ::: ### 概要 このセクションでは、CentOS8.2およびPostgreSQL13の暗号化設定例をいくつか示します。 ::: noteclassic *Database host*フィールドの値がスラッシュで始まるか、空の場合、ZabbixフロントエンドとPostgreSQL間の接続を暗号化できません（GUIのパラメーターが無効になっています） ::: #### Overview This section provides the details of parameters that are common for [dashboard](/manual/web_interface/frontend_sections/monitoring/dashboard) widgets. #### Common parameters The following parameters are common for every single widget: | | | |---|---| |*Name*|Enter a widget name.| |*Refresh interval*|Configure default refresh interval. Default refresh intervals for widgets range from *No refresh* to *15 minutes* depending on the type of widget. For example: *No refresh* for URL widget, *1 minute* for action log widget, *15 minutes* for clock widget.| |*Show header*|Mark the checkbox to show the header permanently.<br>When unchecked the header is hidden to save space and only slides up and becomes visible again when the mouse is positioned over the widget, both in view and edit modes. It is also semi-visible when dragging a widget to a new place.| Refresh intervals for a widget can be set to a default value for all the corresponding users and also each user can set his own refresh interval value: - To set a default value for all the corresponding users switch to editing mode (click the *Edit dashboard* button, find the right widget, click the *Edit* button opening the editing form of a widget), and choose the required refresh interval from the dropdown list. - Setting a unique refresh interval for each user separately is possible in view mode by clicking the  button for a certain widget. Unique refresh interval set by a user has priority over the widget setting and once it's set it's always preserved when the widget's setting is modified. To see **specific parameters** for each widget, go to individual widget pages for: - [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) #### Overview This section provides the details of parameters that are common for [dashboard](/manual/web_interface/frontend_sections/monitoring/dashboard) widgets. #### Common parameters The following parameters are common for every single widget: | | | |---|---| |*Name*|Enter a widget name.| |*Refresh interval*|Configure default refresh interval. Default refresh intervals for widgets range from *No refresh* to *15 minutes* depending on the type of widget. For example: *No refresh* for URL widget, *1 minute* for action log widget, *15 minutes* for clock widget.| |*Show header*|Mark the checkbox to show the header permanently.<br>When unchecked the header is hidden to save space and only slides up and becomes visible again when the mouse is positioned over the widget, both in view and edit modes. It is also semi-visible when dragging a widget to a new place.| Refresh intervals for a widget can be set to a default value for all the corresponding users and also each user can set his own refresh interval value: - To set a default value for all the corresponding users switch to editing mode (click the *Edit dashboard* button, find the right widget, click the *Edit* button opening the editing form of a widget), and choose the required refresh interval from the dropdown list. - Setting a unique refresh interval for each user separately is possible in view mode by clicking the  button for a certain widget. Unique refresh interval set by a user has priority over the widget setting and once it's set it's always preserved when the widget's setting is modified. To see **specific parameters** for each widget, go to individual widget pages for: - [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) #### Overview This section provides the steps required for a successful [upgrade](/manual/installation/upgrade) from Zabbix **5.4**.x to the latest version of Zabbix **6.0**.x using official Zabbix packages for Debian/Ubuntu. While upgrading Zabbix agents is not mandatory (but recommended), Zabbix server and proxies must be of the [same major version](/manual/appendix/compatibility). Therefore, in a server-proxy setup, Zabbix server and all proxies have to be stopped and upgraded. Keeping proxies running during server upgrade no longer will bring any benefit as during proxy upgrade their old data will be discarded and no new data will be gathered until proxy configuration is synced with server. Note that with SQLite database on proxies, history data from proxies before the upgrade will be lost, because SQLite database upgrade is not supported and the SQLite database file has to be manually removed. When proxy is started for the first time and the SQLite database file is missing, proxy creates it automatically. Depending on database size the database upgrade to version 6.0 may take a long time. ::: notewarning Before the upgrade make sure to read the relevant **upgrade notes!** ::: The following upgrade notes are available: |Upgrade from|Read full upgrade notes|Most important changes between versions| |--|--|------| |5.4.x |For:<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Minimum required database versions upped;<br>Server/proxy will not start if outdated database;<br>Audit log records lost because of database structure change.| |5.2.x |For:<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Minimum required database versions upped;<br>Aggregate items removed as a separate type.| |5.0.x LTS|For:<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Minimum required PHP version upped from 7.2.0 to 7.2.5.| |4.4.x |For:<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Support of IBM DB2 dropped;<br>Minimum required PHP version upped from 5.4.0 to 7.2.0;<br>Minimum required database versions upped;<br>Changed Zabbix PHP file directory.| |4.2.x |For:<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Jabber, Ez Texting media types removed.| |4.0.x LTS|For:<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Older proxies no longer can report data to an upgraded server;<br>Newer agents no longer will be able to work with an older Zabbix server.| |3.4.x |For:<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|'libpthread' and 'zlib' libraries now mandatory;<br>Support for plain text protocol dropped and header is mandatory;<br>Pre-1.4 version Zabbix agents are no longer supported;<br>The Server parameter in passive proxy configuration now mandatory.| |3.2.x |For:<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|SQLite support as backend database dropped for Zabbix server/frontend;<br>Perl Compatible Regular Expressions (PCRE) supported instead of POSIX extended;<br>'libpcre' and 'libevent' libraries mandatory for Zabbix server;<br>Exit code checks added for user parameters, remote commands and system.run\[\] items without the 'nowait' flag as well as Zabbix server executed scripts;<br>Zabbix Java gateway has to be upgraded to support new functionality.| |3.0.x LTS|For:<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Database upgrade may be slow, depending on the history table size.| |2.4.x |For:<br>Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Minimum required PHP version upped from 5.3.0 to 5.4.0<br>LogFile agent parameter must be specified| |2.2.x LTS|For:<br>Zabbix [2.4](https://www.zabbix.com/documentation/2.4/manual/installation/upgrade_notes_240)<br>Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Node-based distributed monitoring removed| |2.0.x |For:<br>Zabbix [2.2](https://www.zabbix.com/documentation/2.2/manual/installation/upgrade_notes_220)<br>Zabbix [2.4](https://www.zabbix.com/documentation/2.4/manual/installation/upgrade_notes_240)<br>Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Minimum required PHP version upped from 5.1.6 to 5.3.0;<br>Case-sensitive MySQL database required for proper server work; character set utf8 and utf8\_bin collation is required for Zabbix server to work properly with MySQL database. See [database creation scripts](/manual/appendix/install/db_scripts#mysqlmariadb).<br>'mysqli' PHP extension required instead of 'mysql'| You may also want to check the [requirements](/manual/installation/requirements) for 6.0. ::: notetip It may be handy to run two parallel SSH sessions during the upgrade, executing the upgrade steps in one and monitoring the server/proxy logs in another. For example, run `tail -f zabbix_server.log` or `tail -f zabbix_proxy.log` in the second SSH session showing you the latest log file entries and possible errors in real time. This can be critical for production instances. ::: For instructions on upgrading between Zabbix 6.0.x minor versions (for example, from 6.0.1 to 6.0.3), see [Upgrade between minor versions](#upgrade-between-minor-versions). #### 概要 このセクションでは、Debian/Ubuntu用の公式Zabbixパッケージを使用して、Zabbix **5.4**.xからZabbix **6.0**.xの最新バージョンへの[アップグレード](/manual/installation/upgrade)を成功させるために必要な手順を説明します。 Zabbixエージェントのアップグレードは必須ではありません(推奨)が、Zabbixサーバーとプロキシは[同じメジャーバージョン](/manual/appendix/compatibility)である必要があります。したがってサーバープロキシ構成では、Zabbixサーバーとすべてのプロキシを停止してアップグレードする必要があります。サーバーのアップグレード中にプロキシを実行し続けても、プロキシのアップグレード中に古いデータが破棄され、プロキシ設定がサーバーと同期されるまで新しいデータが収集されないため、メリットがありません。 プロキシ上のSQLiteデータベースは、データベースのアップグレードがサポートされておらず、データベースファイルを手動で削除する必要があるため、アップグレード前のプロキシからのヒストリデータは失われることに注意してください。プロキシが初めて起動され、SQLiteデータベースファイルが見つからない場合、プロキシは自動的に作成します。 データベースのサイズによっては、バージョン6.0へのデータベースアップグレードに時間がかかる場合があります。 ::: notewarning アップグレードする前に**アップグレード時の注意点**を必ずお読みください！ ::: アップグレード時の注意点は以下のようにまとめられています。 |アップグレード元|全ての注意点を読む|バージョン間の重要な変更点| |--|--|------| |5.4.x |Zabbix [6.0](/manual/installation/upgrade_notes_600)|データベースの必須バージョンの上昇。<br>古いデータベースの場合、サーバー/プロキシは起動不能に。<br>データベースの構造変更のため監査ログレコードが失効。| |5.2.x |Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|データベースの必須バージョンの上昇。<br>集計アイテムが個別のタイプから削除。| |5.0.x LTS|Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|PHPの必須バージョンが7.2.0から7.2.5へ変更。| |4.4.x |Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|IBM DB2のサポート終了。<br>PHPの必須バージョンが5.4.0から7.2.0へ変更。<br>データベースの必須バージョンの上昇。<br>ZabbixのPHPファイルディレクトリの変更。| |4.2.x |Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Jabber、EZ Textingメディアタイプの削除。| |4.0.x LTS|Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|古いプロキシからアップグレードされたサーバーへのにデータ報告が不可能に。<br>新しいエージェントは古いZabbixサーバーと連携不可能に。| |3.4.x |Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|'libpthread'および'zlib'ライブラリが必須に。<br>プレーンテキストプロトコルのサポートが削除されヘッダーが必須に。<br>バージョン1.4以前のZabbixエージェントのサポート終了。<br>パッシブプロキシの設定にサーバーパラメーターが必須に。| |3.2.x |Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|ZabbixサーバーとWebインターフェースのバックエンドデータベースとしてのSQLiteサポートが削除。<br>POSIX拡張の代わりにPerl互換正規表現(PCRE)をサポート。<br>Zabbixサーバーに'libpcre'および'libevent'ライブラリが必須に。<br>'nowait'フラグが設定されていないユーザーパラメーター、リモートコマンド、およびsystem.run\[\]アイテムに対して、Zabbixサーバーが実行したスクリプト同様に終了コードのチェックが追加。<br>Zabbix Javaゲートウェイは新しい機能をサポートするためにアップグレードが必須。| |3.0.x LTS|Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|ヒストリテーブルのサイズによっては、データベースのアップグレードに時間がかかる。| |2.4.x |Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|PHPの必須バージョンが5.3.0から5.4.0へ変更。<br>LogFileエージェントパラメーターの指定が必須に。| |2.2.x LTS|Zabbix [2.4](https://www.zabbix.com/documentation/2.4/manual/installation/upgrade_notes_240)<br>Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|ノードベースの分散監視の削除。| |2.0.x |Zabbix [2.2](https://www.zabbix.com/documentation/2.2/manual/installation/upgrade_notes_220)<br>Zabbix [2.4](https://www.zabbix.com/documentation/2.4/manual/installation/upgrade_notes_240)<br>Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|PHPの必須バージョンが5.1.6から5.3.0へ変更。<br>ZabbixサーバーとMySQLデータベースが適切に動作するには、大文字と小文字を区別するデータベースおよび文字セットutf8とutf8\_binの照合順序が必須に。参照: [データベース作成スクリプト](/manual/appendix/install/db_scripts#mysqlmariadb)。<br>PHP拡張機能の'mysql'の代わりに'mysqli'が必須に。| 6.0の[要件](/manual/installation/requirements)も確認してください。 ::: notetip アップグレード中に並行してSSHのセッションを実行し、一方でアップグレード手順を実行し、もう一方でサーバーやプロキシのログを監視すると便利な場合があります。例えば、`tail -f zabbix_server.log`または`tail -f zabbix_proxy.log`を実行すると、最新のログとエラー発生をリアルタイムで把握することができます。これは本番環境のインスタンスにとって重要です。 ::: Zabbix 6.0.xのマイナーバージョン間 (たとえば、6.0.1から6.0.3)へのアップグレード手順については、[マイナーバージョン間のアップグレード](#upgrade-between-minor-versions)を参照してください。 #### Overview This section provides the steps required for a successful [upgrade](/manual/installation/upgrade) from Zabbix **5.4**.x to the latest version of Zabbix **6.0**.x using official Zabbix packages for Red Hat Enterprise Linux. While upgrading Zabbix agents is not mandatory (but recommended), Zabbix server and proxies must be of the [same major version](/manual/appendix/compatibility). Therefore, in a server-proxy setup, Zabbix server and all proxies have to be stopped and upgraded. Keeping proxies running during server upgrade no longer will bring any benefit as during proxy upgrade their old data will be discarded and no new data will be gathered until proxy configuration is synced with server. Note that with SQLite database on proxies, history data from proxies before the upgrade will be lost, because SQLite database upgrade is not supported and the SQLite database file has to be manually removed. When proxy is started for the first time and the SQLite database file is missing, proxy creates it automatically. Depending on database size the database upgrade to version 6.0 may take a long time. ::: notewarning Before the upgrade make sure to read the relevant **upgrade notes!** ::: The following upgrade notes are available: |Upgrade from|Read full upgrade notes|Most important changes between versions| |--|--|------| |5.4.x |For:<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Minimum required database versions upped;<br>Server/proxy will not start if outdated database;<br>Audit log records lost because of database structure change.| |5.2.x |For:<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Minimum required database versions upped;<br>Aggregate items removed as a separate type.| |5.0.x LTS|For:<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Minimum required PHP version upped from 7.2.0 to 7.2.5.| |4.4.x |For:<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Support of IBM DB2 dropped;<br>Minimum required PHP version upped from 5.4.0 to 7.2.0;<br>Minimum required database versions upped;<br>Changed Zabbix PHP file directory.| |4.2.x |For:<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Jabber, Ez Texting media types removed.| |4.0.x LTS|For:<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Older proxies no longer can report data to an upgraded server;<br>Newer agents no longer will be able to work with an older Zabbix server.| |3.4.x |For:<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|'libpthread' and 'zlib' libraries now mandatory;<br>Support for plain text protocol dropped and header is mandatory;<br>Pre-1.4 version Zabbix agents are no longer supported;<br>The Server parameter in passive proxy configuration now mandatory.| |3.2.x |For:<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|SQLite support as backend database dropped for Zabbix server/frontend;<br>Perl Compatible Regular Expressions (PCRE) supported instead of POSIX extended;<br>'libpcre' and 'libevent' libraries mandatory for Zabbix server;<br>Exit code checks added for user parameters, remote commands and system.run\[\] items without the 'nowait' flag as well as Zabbix server executed scripts;<br>Zabbix Java gateway has to be upgraded to support new functionality.| |3.0.x LTS|For:<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Database upgrade may be slow, depending on the history table size.| |2.4.x |For:<br>Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Minimum required PHP version upped from 5.3.0 to 5.4.0<br>LogFile agent parameter must be specified| |2.2.x LTS|For:<br>Zabbix [2.4](https://www.zabbix.com/documentation/2.4/manual/installation/upgrade_notes_240)<br>Zabbix [3.0](https://www.zabbix.com/documentat