# 13. Problem acknowledgment # 13. Подтверждение проблем ### ### # 10 Cookies used by Zabbix # 10. Файлы сookie, используемые Zabbix # 10 Discovery using WMI queries # 10. Обнаружение с использованием запросов WMI # 10 Graph prototype # 10. Прототип графиков # 10 Graph prototype # 10 Прототип графиков # 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 Заметки по обновлению для 6.0.0 ::: noteimportant Zabbix 6.0.0 еще не выпущен. ::: Эти заметки относятся к обновлению с Zabbix 5.4.x до Zabbix 6.0.0. Все заметки сгруппированы в: - `Критические` - наиболее критическая информация относящаяся к процессу обновления и изменениям в функциональности Zabbix - `Информационные` - вся оставшаяся информация, описывающая изменения в функциональности Zabbix Имеется возможность обновления до Zabbix 6.0.0 с версий Zabbix до 5.4.0. Обратите внимание на раздел [процедуры обновления](/manual/installation/upgrade) для получения соответствующей информации об обновлении с предыдущих версий Zabbix. # 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. Все заметки сгруппированы в: - `Критические` — наиболее критическая информация, относящаяся к процессу обновления и изменениям в функциональности Zabbix; - `Информационные` — вся оставшаяся информация, описывающая изменения в функциональности Zabbix. Имеется возможность обновления до Zabbix 6.0.0 с версий Zabbix до 5.4.0. Обратите внимание на раздел [процедуры обновления](/manual/installation/upgrade) для получения соответствующей информации об обновлении с предыдущих версий Zabbix. # 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. Zabbix агент на Microsoft Windows # 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 для различных сервисов, которые можно указать в параметре «сервис». # 11 Macros # 11. Макросы # 11. Maintenance # 11. Обслуживание # 11 PostgreSQL plugin # 11. Плагин PostgreSQL # 11 SAML setup with Microsoft Entra ID # 11. Настройка SAML с Microsoft Entra ID # 11 Time zones # 11. Часовые пояса # 11 Upgrade notes for 6.0.1 # 11. Заметки по обновлению для 6.0.1 # 11 Value cache # 11. Кэш значений # 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. Значение элемента данных # 12 Oracle database setup # 12. Настройка базы данных Oracle # 12 Redis plugin # 12. Плагин Redis # 12. Regular expressions # 12. Регулярные выражения # 12 Resetting password # 12. Сброс пароля # 12 SAML setup with Okta This section describes how to configure Okta to enable SAML 2.0 authentication for Zabbix. # 12. Настройка SAML с Okta В этом разделе описывается, как настроить Okta для включения аутентификации SAML 2.0 для Zabbix. # 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. Динамическая библиотека Zabbix sender для Windows #### Обзор В среде Windows приложения могут отправлять данные в Zabbix сервер/прокси с помощью библиотеки динамической компоновки Zabbix sender (zabbix\_sender.dll) вместо запуска внешнего процесса (zabbix\_sender.exe). Для компиляции пользовательских приложений с zabbix_sender.dll необходимы zabbix_sender.h и zabbix_sender.lib. #### Получение Есть два способа получить zabbix_sender.dll. **1.** [Загрузите](https://www.zabbix.com/ru/download_agents) файлы zabbix_sender.h, zabbix_sender.lib и zabbix_sender.dll как ZIP-архив. При выборе параметров загрузки убедитесь, что выбраны опции «No encryption» в графе *Шифрование* и «Archive» в графе *Packaging*. Затем загрузите Zabbix агент (не Zabbix агент 2). Файлы zabbix_sender.h, zabbix_sender.lib и zabbix_sender.dll будут внутри загруженного ZIP-архива в папке `bin\dev`. Распакуйте файлы туда, где они вам нужны. Смотрите также [Известные проблемы](/manual/installation/known_issues#недостающие-файлы-в-архиве-агента-windows). **2.** Соберите zabbix_sender.dll из исходных кодов (см. [инструкцию](/manual/installation/install/win_agent#обзор)). Динамическиая библиотека с файлами разработки будет расположена в папке `bin\winXX\dev`. Для её использования включите файл заголовков zabbix_sender.h и слинкуйте с библиотекой zabbix_sender.lib. #### Смотрите также - [пример](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/build/win32/examples/zabbix_sender/sender.c) простой утилиты Zabbix sender, реализованный с помощью библиотеки динамической линковки Zabbix sender для иллюстрации использования библиотеки; - файл [zabbix_sender.h](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/zabbix_sender/win32/zabbix_sender.h) для функций интерфейса библиотеки динамической линковки Zabbix sender. Этот файл содержит документацию, разъясняющую назначение каждой функции интерфейса, её аргументы и возвращаемое значение. # 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#настройка-низкоуровневого-обнаружения), также имеется возможность обнаружения блочных устройств и их типов . # 13 Map # 13 Карта сети # 13 Map # 13. Карта сети # 13. Problem acknowledgment # 13. Подтверждение проблем # 13 Python library for Zabbix API # 13. Библиотека Python для Zabbix API # 13 Remote monitoring of Zabbix stats # 13. Удалённый мониторинг статистики Zabbix # 13 Restricting agent checks # 13. Ограничение проверок агента # 13 Setting up scheduled reports # 13. Настройка отчётов по расписанию # 13 SMART plugin # 13. Плагин SMART # 13 Storage of secrets # 13. Хранение секретов # 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 Additional frontend languages # 14. Дополнительные языки веб-интерфейса # 14. Configuration export/import # 14. Экспорт/импорт настроек # 14 Configuring Kerberos with Zabbix # 14. Настройка Kerberos с Zabbix # 14 Discovery of host interfaces in Zabbix # 14. Обнаружение интерфейсов узлов сети в Zabbix # 14 Map navigation tree # 14 Дерево навигации карт сетей # 14 Map navigation tree # 14. Дерево навигации карт сетей # 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 Простой текст # 15 Upgrade notes for 6.0.5 # 15. Заметки по обновлению для 6.0.5 # 15 What's new in Zabbix 6.0.10 # 15. Что нового в Zabbix 6.0.10 # 16 Agent vs agent 2 comparison This section describes the differences between the Zabbix agent and the Zabbix agent 2. |Parameter|Zabbix agent|Zabbix agent 2| |--|------|------| |Programming language|C|Go with some parts in C| |Daemonization|yes|by systemd only (yes on Windows)| |Supported extensions|Custom [loadable modules](/manual/config/items/loadablemodules) in C.|Custom [plugins](/manual/config/items/plugins) in Go.| |*Requirements*|<|<| |Supported platforms|Linux, IBM AIX, FreeBSD, NetBSD, OpenBSD, HP-UX, Mac OS X, Solaris: 9, 10, 11, Windows: all desktop and server versions since XP|Linux, Windows: all desktop and server versions, on which a [supported Go version](/manual/installation/requirements#agent-2) can be installed.| |Supported crypto libraries|GnuTLS 3.1.18 and newer<br>OpenSSL 1.0.1, 1.0.2, 1.1.0, 1.1.1, 3.0.x. Note that 3.0.x is supported since Zabbix 6.0.4.<br>LibreSSL - tested with versions 2.7.4, 2.8.2 (certain limitations apply, see the [Encryption](/manual/encryption#compiling_zabbix_with_encryption_support) page for details).|Linux: OpenSSL 1.0.1 and later is supported since Zabbix 4.4.8.<br>MS Windows: OpenSSL 1.1.1 or later.<br>The OpenSSL library must have PSK support enabled. LibreSSL is not supported.| |Monitoring processes|<|<| |Processes|A separate active check process for each server/proxy record.|Single process with automatically created threads.<br>The maximum number of threads is determined by the GOMAXPROCS environment variable.| |Metrics|**UNIX**: see a list of supported [items](/manual/config/items/itemtypes/zabbix_agent).<br><br>**Windows**: see a list of additional Windows-specific [items](/manual/config/items/itemtypes/zabbix_agent/win_keys).|**UNIX**: All metrics supported by Zabbix agent.<br>Additionally, the agent 2 provides Zabbix-native monitoring solution for: Docker, Memcached, MySQL, PostgreSQL, Redis, systemd, and other monitoring targets - see a full list of agent 2 specific [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2).<br><br>**Windows**: All metrics supported by Zabbix agent, and also net.tcp.service\* checks of HTTPS, LDAP.<br>Additionally, the agent 2 provides Zabbix-native monitoring solution for: PostgreSQL, Redis.| |Concurrency|Active checks for single server are executed sequentially.|Checks from different plugins or multiple checks within one plugin can be executed concurrently.| |Scheduled/flexible intervals|Supported for passive checks only.|Supported for passive and active checks.| |Third-party traps|no|yes| |*Additional features*|<|<| |Persistent storage|no|yes| |Persistent files for log\*\[\] metrics|yes (only on Unix)|no| |Log data upload|Can be performed during log gathering to free the buffer.|Log gathering is stopped when the buffer is full, therefore the [BufferSize](/manual/appendix/config/zabbix_agent2) parameter must be at least MaxLinesPerSecond x 2.| |Timeout settings|Defined on an agent level only.|Plugin timeout can override the timeout defined on an agent level.| |Changes user at runtime|yes (Unix-like systems only)|no (controlled by systemd)| |User-configurable ciphersuites|yes|no| **See also:** - *Zabbix processes description*: [Zabbix agent](/manual/concepts/agent), [Zabbix agent 2](/manual/concepts/agent2) - *Configuration parameters*: Zabbix agent [UNIX](/manual/appendix/config/zabbix_agentd) / [Windows](/manual/appendix/config/zabbix_agentd_win), Zabbix agent 2 [UNIX](/manual/appendix/config/zabbix_agent2) / [Windows](/manual/appendix/config/zabbix_agent2_win) # 16. Отличия между Zabbix агентом и Zabbix агентом 2 В данном разделе описываются различия между Zabbix агентом и Zabbix агентом 2. |Параметр|Zabbix агент|Zabbix агент 2| |--|------|------| |Язык программирования|C|Go с некоторыми частями на C| |Демонизация|да|только с помощью systemd (да на Windows)| |Поддерживаемые расширения|Пользовательские [загружаемые модули](/manual/config/items/loadablemodules) на C.|Пользовательские [плагины](/manual/config/items/plugins) на Go.| |*Требования*|<|<| |Поддерживаемые платформы|Linux, IBM AIX, FreeBSD, NetBSD, OpenBSD, HP-UX, Mac OS X, Solaris: 9, 10, 11, Windows: все настольные и серверные версии, начиная с XP|Linux, Windows: все настольные и серверные версии, на которых может быть установлена [поддерживаемая версия Go](/manual/installation/requirements#агент-2).| |Поддерживаемые криптобиблиотеки|GnuTLS 3.1.18 и выше<br>OpenSSL 1.0.1, 1.0.2, 1.1.0, 1.1.1, 3.0.x. Обратите внимание, что 3.0.x поддерживается с версии Zabbix 6.0.4.<br>LibreSSL — протестирована с версиями 2.7.4, 2.8.2 (применяются определённые ограничения, см. страницу [Шифрование](/manual/encryption#компиляция-zabbix-с-поддержкой-шифрования)).|Linux: OpenSSL 1.0.1 и выше поддерживается с версии Zabbix 4.4.8.<br>MS Windows: OpenSSL 1.1.1 или выше.<br>В библиотеке OpenSSL должны быть включена поддержка PSK. LibreSSL не поддерживается.| |Процессы мониторинга|<|<| |Процессы|Отдельный процесс активных проверок для каждой записи сервера/прокси.|Один процесс с автоматически созданными потоками.<br>Максимальное количество потоков определяется переменной окружения GOMAXPROCS.| |Метрики|**UNIX**: см. список поддерживаемых [элементов данных](/manual/config/items/itemtypes/zabbix_agent).<br><br>**Windows**: см. список дополнительных [элементов данных](/manual/config/items/itemtypes/zabbix_agent/win_keys), специфичных для Windows.|**UNIX**: все метрики, поддерживаемые Zabbix агентом.<br>Кроме того, агент 2 предоставляет нативное решение для мониторинга с помощью Zabbix: Docker, Memcached, MySQL, PostgreSQL, Redis, systemd и других объектов мониторинга — см. полный список [элементов данных](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2), специфичных для агента 2.<br><br>**Windows**: все метрики, поддерживаемые Zabbix агентом, а также net.tcp.service\* проверки для HTTPS, LDAP.<br>Кроме того, агент 2 предоставляет нативное решение для мониторинга с помощью Zabbix: PostgreSQL, Redis.| |Параллелизм|Активные проверки для одного сервера выполняются последовательно.|Проверки из разных плагинов или множественные проверки в одном плагине могут выполняться параллельно.| |Пользовательские/гибкие интервалы|Поддерживаются только для пассивных проверок.|Поддерживаются для пассивных и активных проверок.| |Сторонние трапы|нет|да| |*Дополнительный функционал*|<|<| |Постоянное хранилище|нет|да| |Постоянные файлы для элементов данных log\*\[\] |да (только на Unix)|нет| |Передача данных журнала|Может выполняться во время сбора данных журнала, чтобы освободить буфер.|Сбор данных журнала останавливается при заполнении буфера, поэтому параметр [BufferSize](/manual/appendix/config/zabbix_agent2) должен быть равен как минимум MaxLinesPerSecond x 2.| |Настройки тайм-аутов|Задаются только на уровне агента.|Тайм-аут плагина может переопределить таймаут, заданный на уровне агента.| |Смена пользователя во время выполнения|да (только Unix-подобные системы)|нет (управляется systemd)| |Настраиваемые пользователем шифры|да|нет| **См. также:** - *Описание процессов Zabbix*: [Zabbix агент](/manual/concepts/agent), [Zabbix агент 2](/manual/concepts/agent2) - *Параметры настройки*: Zabbix агент [UNIX](/manual/appendix/config/zabbix_agentd) / [Windows](/manual/appendix/config/zabbix_agentd_win), Zabbix агент 2 [UNIX](/manual/appendix/config/zabbix_agent2) / [Windows](/manual/appendix/config/zabbix_agent2_win) # 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, может потребоваться добавить правила SELinux, позволяющие Zabbix создавать/использовать сокеты домена UNIX в домене каталога `SocketDir`. В настоящее время файлы сокетов используются сервером (alerter, preprocessing, IPMI) и прокси (IPMI). Файлы сокетов постоянные, то есть присутствуют во время выполнения процесса. # 16 Problem hosts # 16 Узлы сети с проблемами # 16 Problem hosts # 16. Узлы сети с проблемами # 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. Замечания об элементах данных system.cpu.util в Windows # 17 Problems # 17 Проблемы # 17 Problems # 17. Проблемы # 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 Проблемы по важности # 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. Веб-интерфейс # 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 отчёт # 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 Aggregate functions Except where stated otherwise, all functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) Aggregate functions can work with either: - history of items, for example, `min(/host/key,1h)` - [foreach functions](/manual/appendix/functions/aggregate/foreach) as the only parameter, for example, `min(last_foreach(/*/key))` (only in calculated items; cannot be used in triggers) 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 # 1. Функции агрегации Если не оговорено иначе, то все перечисленные здесь функции поддерживаются в: - [выражениях триггера](/manual/config/triggers/expression) - [вычисляемых элементах данных](/manual/config/items/itemtypes/calculated) Функции агрегации могут работать с: - историей элементов данных, например: `min(/узел_сети/ключ,1h)` - [функциями foreach](/manual/appendix/functions/aggregate/foreach) в качестве единственного параметра, например: `min(last_foreach(/*/ключ))` (только в вычисляемых элементах данных; нельзя использовать в триггерах) Некоторые общие замечания о параметрах функций: - параметры функций разделяются запятыми - необязательные параметры функций (или части параметров) обозначаются угловыми скобками `<` `>` - параметры, специфичные для функций, описываются с каждой функцией - параметры `/узел_сети/ключ` и `(сек|#число)<:сдвиг_времени>` никогда не должны заключаться в кавычки # 1 Best practices for secure Zabbix setup # 1. Наилучшие практики для безопасной установки Zabbix # 1 Building loadable plugins # 1 Создание подгружаемых плагинов # 1 Building Zabbix agent on Windows # 1. Сборка Zabbix агента на Windows # 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 # 1 Discovery of mounted filesystems # 1. Обнаружение примонтированных файловых систем ##### 1 Download the source archive Go to the [Zabbix download page](http://www.zabbix.com/download_sources#60LTS) and download the source archive. Once downloaded, extract the sources, by running: tar -zxvf zabbix-6.0.0.tar.gz ::: notetip Enter the correct Zabbix version in the command. It must match the name of the downloaded archive. ::: ##### 1 Загрузите архив исходных кодов Перейдите на [страницу загрузки Zabbix](https://www.zabbix.com/ru/download_sources#60LTS) и скачайте архив исходных кодов. Как только он будет загружен, распакуйте исходные коды, выполнив: tar -zxvf zabbix-6.0.0.tar.gz ::: notetip Укажите в команде правильную версию Zabbix. Версия должна совпадать с именем загруженного архива. ::: # 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. Экранирование спецсимволов из значений LLD макросов в JSONPath Когда в предварительной обработке 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 агентов В этом руководстве приведены пошаговые инструкции, как расширить функциональность Zabbix агента с помощью [пользовательского параметра](/manual/config/items/userparameters). # 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. Кластер высокой доступности # 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. Группы узлов сети В веб-интерфейсе Zabbix группы узлов сети можно [экспортировать](/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. Специфичные ключи элементов данных для агента 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 the {\#FSNAME} macro is used where a file system name is required. The use of a low-level discovery macro is mandatory in the item key to make sure that the discovery is processed correctly. 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) are supported 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:  Click on the three-dot icon to open the menu for the specific item prototype with these options: - *Create trigger prototype* - create a trigger prototype based on this item prototype - *Trigger prototypes* - click to see a list with links to already-configured trigger prototypes of this item prototype - *Create dependent item* - create a dependent item for this item prototype *[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. Прототипы элементов данных После создания правила перейдём к элементам данных этого правила и для этого нажмём «Создать прототип элементов данных (Create item prototype)» для создания прототипа элемента данных. Обратите внимание, как используется макрос {\#FSNAME} там, где требуется имя файловой системы. Использование макросов низкоуровневого обнаружения обязательно в ключе элемента данных для обеспечения правильной обработки обнаружения. При обработке правила обнаружения вместо этого макроса будет подставлена обнаруженная файловая система.  [Макросы](/manual/config/macros/lld_macros) низкоуровневого обнаружения и пользовательские [макросы](/manual/appendix/macros/supported_by_location_user) поддерживаются в настройках прототипа элементов данных и [параметрах](/manual/config/items/item#предобработка-значений-элементов-данных) предобработки значений элементов данных. Обратите внимание, что при применении в интервалах обновления один макрос должен заполнять всё поле целиком. Несколько макросов в одном поле или макросы вперемешку с текстом не поддерживаются. ::: noteclassic Контекстно-зависимое экранирование LLD макросов производится для безопасного использования в регулярных выражениях и параметрах предобработки XPath. ::: Атрибуты, специфичные для прототипов элементов данных: |Параметр|Описание| |--|--------| |*Создать активированным*<br>*(Create enabled)*|Если отмечено, элемент данных будет добавлен в активированном состоянии.<br>Если не отмечено, элемент данных будет добавлен для обнаруженного объекта, но в деактивированном состоянии.| |*Обнаружение*<br>*(Discover)*|Если отмечено (по умолчанию), элемент данных будет добавлен для обнаруженного объекта.<br>Если не отмечено, элемент данных не будет добавлен для обнаруженного объекта, если только данная настройка не будет [переопределена](/manual/discovery/low_level_discovery#замещения) в правиле обнаружения.| Мы можем создать несколько прототипов элементов данных для каждой интересующей нас метрики файловой системы:  Нажмите на иконку с многоточием, чтобы открыть меню для конкретного прототипа элемента данных со следующими опциями:<br> - *Создать прототип триггера (Create trigger prototype)* — создать прототип триггера на базе этого прототипа элемента данных - *Прототипы триггера (Trigger prototypes)* — нажмите, чтобы увидеть список со ссылками на уже настроенные прототипы триггеров, использующие этот прототип элемента данных - *Создать зависимый элемент данных (Create dependent item)* — создать зависимый элемент данных для этого прототипа элемента данных Если вы хотите обновить свойства сразу нескольких прототипов элементов данных, то доступна опция *[Массовое обновление](/manual/config/items/itemupdate#использование-массового-обновления) (Mass update)*. # 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|<|▼▼|^|^|^|^|^|^|^|^|^|^| |▼ Item ▼|<|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\>,\<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| |**log.count\[file,\<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| |**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>,<protocol>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.dns.record\[<ip>,zone,<type>,<timeout>,<count>,<protocol>\]**|<|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\[<regexp>,<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>,<start line>,<end line>,<output>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.regmatch\[file,regexp,<encoding>,<start line>,<end line>\]**|<|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. Поддерживаемые элементы данных по платформам В таблице показаны поддерживаемые Zabbix [агентом элементы данных](/manual/config/items/itemtypes/zabbix_agent) на различных платформах: - Элементы данных с пометкой "**X**" поддерживаются; те, что помечены "**-**", - не поддерживаются. - Если элемент данных с пометкой "**?**", то неизвестно — поддерживается он или нет. - Если элемент данных с пометкой "**r**", это значит, что требуются права доступа уровня root. - Параметры, которые заключены в угловые скобки **<**вот\_так**>**, являются необязательными. ::: noteclassic В эту таблицу не включены элементы данных агента Zabbix, поддерживаемые/относящиеся [только к Windows](/manual/config/items/itemtypes/zabbix_agent/win_keys). ::: | | | | | | | | | | | | | | |---|---|---|---|---|---|---|---|---|---|---|---|---| |NetBSD|<|<|<|<|<|<|<|<|<|<|<|▼▼| |OpenBSD|<|<|<|<|<|<|<|<|<|<|▼▼|^| |Mac OS X|<|<|<|<|<|<|<|<|<|▼▼|^|^| |Tru64|<|<|<|<|<|<|<|<|▼▼|^|^|^| |AIX|<|<|<|<|<|<|<|▼▼|^|^|^|^| |HP-UX|<|<|<|<|<|<|▼▼|^|^|^|^|^| |Solaris|<|<|<|<|<|▼▼|^|^|^|^|^|^| |FreeBSD|<|<|<|<|▼▼|^|^|^|^|^|^|^| |Linux 2.6 (и новее)|<|<|<|▼▼|^|^|^|^|^|^|^|^| |Linux 2.4|<|<|▼▼|^|^|^|^|^|^|^|^|^| |Windows|<|▼▼|^|^|^|^|^|^|^|^|^|^| |▼ Item ▼|<|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\[файл,\<регулярное выражение\>,\<кодировка\>,\<макс. кол-во строк\>,\<режим\>,\<вывод\>,\<максзадержка\>,\<опции\>,\<постоянное\_хранилище\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#примечания)**^|X|X|X|X|X|X|X|X|X|X| |*постоянное\_хранилище* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**log.count\[файл,\<регулярное выражение\>,\<кодировка\>,\<макс. кол-во строк\>,\<режим\>,\<максзадержка\>,\<опции\>,\<постоянное\_хранилище\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#примечания)**^|X|X|X|X|X|X|X|X|X|X| |*постоянное\_хранилище* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**logrt\[регулярное\_выражение\_файла,\<регулярное выражение\>,\<кодировка\>,\<макс. кол-во строк\>,\<режим\>,\<вывод\>,\<максзадержка\>,\<опции\>,\<постоянное\_хранилище\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#примечания)**^|X|X|X|X|X|X|X|X|X|X| |*постоянное\_хранилище* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**logrt.count\[регулярное\_выражение\_файла,\<регулярное выражение\>,\<кодировка\>,\<макс. кол-во строк\>,\<режим\>,\<максзадержка\>,\<опции\>,\<постоянное\_хранилище\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#примечания)**^|X|X|X|X|X|X|X|X|X|X| |*постоянное\_хранилище* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**modbus.get\[точка входа,<id ведомого>,<функция>,<адрес>,<количество>,<тип>,<порядок следования байтов>,<сдвиг>\]**|<|X|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.dns\[<ip>,имя,<тип>,<время ожидания>,<количество>,<протокол>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.dns.record\[<ip>,имя,<тип>,<время ожидания>,<количество>,<протокол>\]**|<|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,<режим>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#примечания)**^|X|\-|X|X|r| |*режим* ▲|bytes *(по умолчанию)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#примечания)**^|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#примечания)**^|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,<режим>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#примечания)**^|X|\-|X|X|r| |*режим* ▲|bytes *(по умолчанию)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#примечания)**^|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#примечания)**^|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,<режим>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#примечания)**^|X|\-|X|X|r| |*режим* ▲|bytes *(по умолчанию)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#примечания)**^|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#примечания)**^|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>,порт\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.service\[сервис,<ip>,<порт>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.service.perf\[сервис,<ip>,<порт>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.socket.count\[<локальный\_адрес>,<локальный\_порт>,<удаленный\_адрес>,<удаленный\_порт>,<состояние>\]**|<|X^**[7](/manual/appendix/items/supported_by_platform#примечания)**^|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.udp.listen\[порт\]**|<|\-|X|X|X|X|\-|\-|\-|X|\-|\-| |**net.udp.service\[сервис,<ip>,<порт>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.udp.service.perf\[сервис,<ip>,<порт>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.udp.socket.count\[<локальный\_адрес>,<локальный\_порт>,<удаленный\_адрес>,<удаленный\_порт>,<состояние>\]**|<|X^**[7](/manual/appendix/items/supported_by_platform#примечания)**^|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**proc.cpu.util\[<имя>,<пользователь>,<тип>,<cmdline>,<режим>,<зона>\]**|<|\-|X|X|\-|X ^**[3](/manual/appendix/items/supported_by_platform#примечания)**^|\-|\-|\-|\-|\-|\-| |*тип* ▲|total *(по умолчанию)*|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|user|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|system|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |*режим* ▲|avg1 *(по умолчанию)*|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |*зона* ▲|current *(по умолчанию)*|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |^|all|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |**proc.mem\[<имя>,<пользователь>,<режим>,<cmdline><тип памяти>\]**|<|\-|X|X|X|X ^**[3](/manual/appendix/items/supported_by_platform#примечания)**^|\-|X|X|\-|X|X| |*режим* ▲|sum *(по умолчанию)*|\-|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| |*тип памяти* ▲|<|\-|X|X|X|X|\-|X|\-|\-|\-|\-| |**proc.num\[<имя>,<пользователь>,<состояние>,<cmdline>,<зона>\]**|<|X|X|X|X|X ^**[3](/manual/appendix/items/supported_by_platform#примечания)**^|X|X|X|\-|X|X| |*состояние* ▲|all *(по умолчанию)*|\-|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| |*зона* ▲|current *(по умолчанию)*|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |^|all|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |**sensor\[устройство,сенсор,<режим>\]**|<|\-|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>,<режим>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*cpu* ▲|all *(по умолчанию)*|X|X|X|X|X|X|X|X|X|X|X| |^|percpu|X|X|X|X|X|X|X|\-|X|X|X| |*режим* ▲|avg1 *(по умолчанию)*|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\[<тип>\]**|<|X|X|X|X|X|X|X|\-|X|X|X| |*тип* ▲|online *(по умолчанию)*|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>,<тип>,<режим>,<логический\_или\_физический>\]**|<|X|X|X|X|X|X|X|X|\-|X|X| |*тип* ▲|user *(по умолчанию)*|\-|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 *(по умолчанию для 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|\-|\-|\-|\-|\-|\-|\-|\-| |*режим* ▲|avg1 *(по умолчанию)*|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 *(по умолчанию)*|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |^|physical|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**system.hostname\[<тип>,<преобразование>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.hw.chassis\[<информация>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.cpu\[<cpu>,<информация>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.devices\[<тип>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.macaddr\[<интерфейс>,<формат>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.localtime\[<тип>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*тип* ▲|utc *(по умолчанию)*|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\[команда,<режим>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*режим* ▲|wait *(по умолчанию)*|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\[ресурс,<тип>\]**|<|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |**system.sw.arch**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.sw.os\[<информация>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.sw.packages\[<регулярное выражение>,<менеджер>,<формат>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.swap.in\[<устройство>,<тип>\]**<br>*(указание устройства поддерживается только на Linux)*|<|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |*тип* ▲<br>*(pages будет работать только если<br>устройство не указано)*|count *(по умолчанию для всех, кроме Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |^|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|pages *(по умолчанию для Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |**system.swap.out\[<устройство>,<тип>\]**<br>*(указание устройства поддерживается только на Linux)*|<|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |*тип* ▲<br>*(pages будет работать только если<br>устройство не указано)*|count *(по умолчанию для всех, кроме Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |^|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|pages *(по умолчанию для Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |**system.swap.size\[<устройство>,<тип>\]**<br>*(указание устройства поддерживается только на FreeBSD, для других платформ должно быть пусто либо "all")*|<|X|X|X|X|X|\-|X|X|\-|X|\-| |*тип* ▲|free *(по умолчанию)*|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#примечания)**^|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\[<устройство>,<тип>,<режим>\]**|<|\-|X|X|X|X|\-|X|\-|\-|X|\-| |*тип* ▲|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|operations *(по умолчанию для OpenBSD, AIX)*|\-|X|X|X|X|\-|X|\-|\-|X|\-| |^|bytes *(по умолчанию для Solaris)*|\-|\-|\-|X|X|\-|X|\-|\-|X|\-| |^|sps *(по умолчанию для Linux)*|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|ops|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|bps *(по умолчанию для FreeBSD)*|\-|\-|\-|X|\-|\-|\-|\-|\-|\-|\-| |*режим* ▲<br>*(совместимо только с<br>типами: sps, ops, bps)*|avg1 *(по умолчанию)*|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |**vfs.dev.write\[<устройство>,<тип>,<режим>\]**|<|\-|X|X|X|X|\-|X|\-|\-|X|\-| |*тип* ▲|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|operations *(по умолчанию для OpenBSD, AIX)*|\-|X|X|X|X|\-|X|\-|\-|X|\-| |^|bytes *(по умолчанию для Solaris)*|\-|\-|\-|X|X|\-|X|\-|\-|X|\-| |^|sps *(по умолчанию для Linux)*|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|ops|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|bps *(по умолчанию для FreeBSD)*|\-|\-|\-|X|\-|\-|\-|\-|\-|\-|\-| |*режим* ▲<br>*(совместимо только с<br>типами: sps, ops, bps)*|avg1 *(по умолчанию)*|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |**vfs.dir.count\[директория,<regex\_вкл>,<regex\_искл>,<типы\_вкл>,<типы\_искл>,<макс\_глубина>,<мин\_размер>,<макс\_размер>,<мин\_возраст>,<макс\_возраст>,<regex\_искл\_директории>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.dir.get\[директория,<regex\_вкл>,<regex\_искл>,<типы\_вкл>,<типы\_искл>,<макс\_глубина>,<мин\_размер>,<макс_размер>,<мин\_возраст>,<макс\_возраст>,<regex\_искл\_директории>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.dir.size\[директория,<regex\_вкл>,<regex\_искл>,<режим>,<макс\_глубина>,<regex\_искл\_директории>\]**|<|X|X|X|?|?|?|?|?|?|?|?| |**vfs.file.cksum\[файл,<режим>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.contents\[файл,<кодировка>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.exists\[файл,<типы\_вкл>,<типы\_искл>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.get\[файл\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.md5sum\[файл\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.owner\[файл,<тип\_владельца>,<тип\_результата>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.permissions\[файл\]**|<|\-|X|X|?|?|?|?|?|?|?|?| |**vfs.file.regexp\[файл,регулярное выражение,<кодировка>,<начальная строка>,<конечная строка>,<вывод>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.regmatch\[файл,регулярное выражение,<кодировка>,<начальная строка>,<конечная строка>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.size\[файл,<режим>\]**|<|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\[файл,<режим>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*режим* ▲|modify *(по умолчанию)*|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#примечания)**^|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,<режим>\]**|<|\-|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(по умолчанию)*|\-|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,<режим>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*режим* ▲|total *(по умолчанию)*|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\[<режим>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*режим* ▲|total *(по умолчанию)*|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\[хост,<путь>,<порт>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**web.page.perf\[хост,<путь>,<порт>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**web.page.regexp\[хост,<путь>,<порт>,регулярное выражение,<длина>,<вывод>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |<|<|1|2|3|4|5|6|7|8|9|10|11| ::: notetip Смотрите также описание [параметров vm.memory.size](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 Рекомендуемые настройки UnixODBC для MySQL # 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 Red Hat Enterprise Linux/CentOS # 1 Red Hat Enterprise Linux/CentOS # 1 Sending message # 1. Отправка сообщений # 1 Server # 1. Сервер # 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. Дерево услуг Дерево услуг настраивается в разделе меню *Услуги->Услуги*. В верхнем правом углу переключите режим с [Просмотр](/manual/web_interface/frontend_sections/services/service) на режим Изменить. {width=600} Чтобы [настроить](#настройка-услуги) новую услугу, нажмите на кнопку *Создать услугу* в правом верхнем углу. Чтобы быстро добавить дочернюю услугу, вы также можете нажать на значок плюса рядом с родительской услугой. Откроется тот же диалог настройки, но параметр Родительские услуги будет уже заполнен. # 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 сервер, чтобы быть уверенным, что в базу данных не будет происходить запись новых данных. ##### 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 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}|Идентификатор кластера.| |^|{\#CLUSTER.NAME}|Имя кластера.| |vmware.datastore.discovery|<|<| |Выполнение обнаружения хранилищ данных.|{\#DATASTORE}|Имя хранилища.| |^|{\#DATASTORE.EXTENT}|Объект JSON с массивом {instanceName:partitionId}.| |vmware.dc.discovery|<|<| |Выполнение обнаружения центров хранения данных.|{\#DATACENTER}|Имя центра хранения данных.| |^|{\#DATACENTERID}|ID центра хранения данных.| |vmware.hv.discovery|<|<| |Выполнение обнаружения гипервизоров.|{\#HV.UUID}|Уникальный идентификатор гипервизора.| |^|{\#HV.ID}|Идентификатор гипервизора (Имя управляемого объекта HostSystem).| |^|{\#HV.NAME}|Имя гипервизора.| |^|{\#HV.NETNAME}|Сетевое имя хоста гипервизора.| |^|{\#HV.IP}|IP адрес гипервизора, может быть пустым.<br>В случае конфигурации с HA с несколькими сетевыми интерфейсами соблюдается следующий приоритет выбора интерфейса:<br>- предпочтение IP, который входит в IP подсеть с vCenter IP<br>- предпочтение IP с IP подсетью с со шлюзом по умолчанию<br>- предпочтение IP с интерфейса с наименьшим ID<br>Это поле поддерживается с Zabbix 5.2.2.| |^|{\#CLUSTER.NAME}|Имя кластера, может быть пустым.| |^|{\#DATACENTER.NAME}|Имя центра хранения данных.| |^|{\#PARENT.NAME}|Имя контейнера, в котором хранится гипервизор.<br>Поддерживается с Zabbix 4.0.3.| |^|{\#PARENT.TYPE}|Тип контейнера, в котором хранится гипервизор. Значения могут быть: `Datacenter`, `Folder`, `ClusterComputeResource`, `VMware`, где 'VMware' означает неизвестный тип контейнера.<br>Поддерживается с Zabbix 4.0.3.| |vmware.hv.datastore.discovery|<|<| |Выполнение обнаружения хранилищ данных гипервизора. Обратите внимание, что несколько гипервизоров могут использовать одинаковые хранилища данных.|{\#DATASTORE}|Имя хранилища данных.| |^|{\#MULTIPATH.COUNT}|Зарегистрированное количество путей хранилища данных.| |^|{\#MULTIPATH.PARTITION.COUNT}|Количество доступных разделов диска.| |vmware.vm.discovery|<|<| |Выполнение обнаружения виртуальных машин.|{\#VM.UUID}|Уникальный идентификатор виртуальной машины.| |^|{\#VM.ID}|Идентификатор виртуальной машины (Имя управляемого объекта VirtualMachine).| |^|{\#VM.NAME}|Имя виртуальной машины.| |^|{\#HV.NAME}|Имя гипервизора.| |^|{\#DATACENTER.NAME}|Имя центра хранения данных.| |^|{\#CLUSTER.NAME}|Имя кластера, может быть пустым.| |^|{\#VM.IP}| IP адрес виртуальной машины, может быть пустым.<br>Поддерживается с Zabbix 5.2.2.| |^|{\#VM.DNS}|DNS имя виртуальной машины, может быть пустым.<br>Поддерживается с Zabbix 5.2.2.| |^|{\#VM.GUESTFAMILY}|Семейство ОС гостевой виртуальной машины, может быть пустым.<br>Поддерживается с Zabbix 5.2.2.| |^|{\#VM.GUESTFULLNAME}|Полное имя ОС гостевой виртуальной машины, может быть пустым.<br>Поддерживается с Zabbix 5.2.2.| |^|{\#VM.FOLDER}|Цепочка родительских папок виртуальной машины, можно использовать как значение для вложенных групп; имена папок комбинируются с "/". Может быть пустым.<br>Поддерживается с Zabbix 5.4.2.| |vmware.vm.net.if.discovery|<|<| |Выполнение обнаружения сетевых интерфейсов на виртуальной машине.|{\#IFNAME}|Имя сетевого интерфейса.| |vmware.vm.vfs.dev.discovery|<|<| |Выполнение обнаружения дисковых устройств на виртуальной машине.|{\#DISKNAME}|Имя дискового устройства.| |vmware.vm.vfs.fs.discovery|<|<| |Выполнение обнаружения файловых систем на виртуальной машине.|{\#FSNAME}|Имя файловой системы.| # 1 VMware monitoring item keys # 1 Ключи элементов данных для мониторинга VMware # 1 Webhook script examples # 1. Примеры скриптов вебхуков # 1 Web monitoring items # 1. Элементы данных веб-мониторинга # 1 Zabbix agent # 1. Zabbix агент # 1 Zabbix agent template operation Steps to ensure correct operation of templates that collect metrics with [Zabbix agent](/manual/concepts/agent): 1. Make sure that Zabbix agent is installed on the host. For active checks, also make sure that the Zabbix server/proxy address is added to the 'ServerActive' parameter of the agent [configuration file](/manual/appendix/config/zabbix_agentd#serveractive). 2. [Link](/manual/config/templates/linking#linking-a-template) the template to a target host (if the template is not available in your Zabbix installation, you may need to import the template's .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions). 3. If necessary, adjust the values of template macros. 4. Configure the instance being monitored to allow data sharing with Zabbix. A detailed description of a template, including the full list of macros, items, and triggers, is available in the template's README file (accessible by clicking on a template name). The following templates are available: - [Apache by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HAProxy by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [IIS by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [IIS by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent_active/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft Exchange Server 2016 by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft Exchange Server 2016 by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange_active/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MySQL by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Nginx by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [PHP-FPM by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [PostgreSQL by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [RabbitMQ cluster by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 1. Работа с Zabbix agent шаблонами Шаги для гарантии корректной работы шаблонов, которые собирают метрики через [Zabbix агент](/manual/concepts/agent): 1. Убедитесь, что Zabbix агент установлен на хосте. Для активных проверок также убедитесь, что адрес Zabbix сервера/прокси добавлен в параметр «ServerActive» [файла конфигурации](/manual/appendix/config/zabbix_agentd#serveractive) агента. 2. [Присоедините](/manual/config/templates/linking#присоединение-шаблона) шаблон к нужному узлу сети (если шаблон недоступен в вашей инсталляции Zabbix, вам может потребоваться сначала импортировать файл .yaml шаблона — смотрите инструкции в разделе [Готовые шаблоны](/manual/config/templates_out_of_the_box)). 3. При необходимости измените значения макросов шаблона. 4. Настройте экземпляр для мониторинга так, чтобы обмен данными с Zabbix был разрешён. Подробное описание шаблона, включая полный список макросов, элементов данных и триггеров, доступно в файле README (\[en\]) шаблона (доступном при нажатии на имя шаблона). Доступны следующие шаблоны: - [Apache by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HAProxy by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [IIS by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [IIS by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent_active/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft Exchange Server 2016 by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft Exchange Server 2016 by Zabbix agent active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange_active/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MySQL by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Nginx by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [PHP-FPM by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [PostgreSQL by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [RabbitMQ cluster by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 1 Zabbix server # 1. Zabbix сервер # 20 Modules # 20. Модули # 20 System information # 20. Информация о системе # 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 Топ узлов сети # 21 Top hosts # 21. Топ узлов сети # 21 Upgrade notes for 6.0.11 # 21. Заметки по обновлению для 6.0.11 # 21 What's new in Zabbix 6.0.16 # 21. Что нового в Zabbix 6.0.16 # 22 Trigger overview # 22 Обзор триггеров # 22 Trigger overview # 22. Обзор триггеров # 22 Upgrade notes for 6.0.12 # 22. Заметки по обновлению для 6.0.12 # 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 Веб-мониторинг # 24 Web monitoring # 24. Веб-мониторинг # 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#breaking_changes) для этой версии. # 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 # 2 Действия # 2 Actions [comment]: # (tags: action) # 2. Действия [comment]: # (tags: action) # 2 Active agent autoregistration # 2. Авторегистрация активных агентов # 2 Agent # 2. Агент ##### 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. Побитовые функции Все перечисленные здесь функции поддерживаются в: - [триггерных выражениях](/manual/config/triggers/expression) - [вычисляемых элементах данных](/manual/config/items/itemtypes/calculated) Некоторые общие замечания о параметрах функций: - параметры функций разделяются запятыми - в качестве параметров допустимы выражения - необязательные параметры функций (или части параметров) обозначаются угловыми скобками `<` `>` |ФУНКЦИЯ|<|<| |--|--|--| |**Описание**|**Параметры, специфичные для функции**|**Комментарии**| |**bitand** (значение,маска)|<|<| |Результат операции «побитовое И» значения элемента данных и маски.|**значение** — проверяемое значение<br>**маска** (обязательно) — 64-битное целое без знака (0 - 18446744073709551615)|Поддерживаются типы значений: int<br><br>Несмотря на то, что сравнение выполняется побитово, все значения должны быть представлены и затем возвращаются в десятичном формате. Например, проверка третьего бита выполняется путём сравнения с числом 4, а не 100.<br><br>Примеры:<br>=> **bitand**(last(/узел_сети/ключ),**12**)=8 or **bitand**(last(/узел_сети/ключ),**12**)=4 → выставлены третий или четвёртый биты, но не оба сразу<br>=> **bitand**(last(/узел_сети/ключ),**20**)=16 → третий бит не выставлен, а пятый — выставлен.| |**bitlshift** (значение,сдвиг_битов)|<|<| |Побитовый сдвиг значения элемента данных влево.|**значение** — проверяемое значение<br>**сдвиг_битов** (обязательно) — количество битов для сдвига|Поддерживаются типы значений: int<br><br>Несмотря на то, что сравнение выполняется побитово, все значения должны быть представлены и затем возвращаются в десятичном формате. Например, проверка третьего бита выполняется путём сравнения с числом 4, а не 100.| |**bitnot** (значение)|<|<| |Результат операции «побитовое НЕ» значения элемента данных.|**значение** — проверяемое значение<br>|Поддерживаются типы значений: int<br><br>Несмотря на то, что сравнение выполняется побитово, все значения должны быть представлены и затем возвращаются в десятичном формате. Например, проверка третьего бита выполняется путём сравнения с числом 4, а не 100.| |**bitor** (значение,маска)|<|<| |Результат операции «побитовое ИЛИ» значения элемента данных и маски.|**значение** — проверяемое значение<br>**маска** (mandatory) — 64-битное целое без знака (0 - 18446744073709551615)|Поддерживаются типы значений: int<br><br>Несмотря на то, что сравнение выполняется побитово, все значения должны быть представлены и затем возвращаются в десятичном формате. Например, проверка третьего бита выполняется путём сравнения с числом 4, а не 100.| |**bitrshift** (значение,сдвиг_битов)|<|<| |Побитовый сдвиг значения элемента данных вправо.|**значение** — проверяемое значение<br>**сдвиг_битов** (обязательно) — количество битов для сдвига|Поддерживаются типы значений: int<br><br>Несмотря на то, что сравнение выполняется побитово, все значения должны быть представлены и затем возвращаются в десятичном формате. Например, проверка третьего бита выполняется путём сравнения с числом 4, а не 100.| |**bitxor** (значение,маска)|<|<| |Результат операции «побитовое исключающее ИЛИ» значения элемента данных и маски.|**значение** — проверяемое значение<br>**маска** (обязательно) — 64-битное целое без знака (0 - 18446744073709551615)|Поддерживаются типы значений: int<br><br>Несмотря на то, что сравнение выполняется побитово, все значения должны быть представлены и затем возвращаются в десятичном формате. Например, проверка третьего бита выполняется путём сравнения с числом 4, а не 100.| # 2 Building Zabbix agent 2 on Windows # 2. Сборка Zabbix агента 2 на Windows # 2 Certificate problems # 2. Проблемы с сертификатами # 2 Clock # 2 Часы # 2 Clock # 2. Часы # 2 Configuring a host group # 2. Настройка группы узлов сети ##### 2 Create user account For all of the Zabbix daemon processes, an unprivileged user is required. If a Zabbix daemon is started from an unprivileged user account, it will run as that user. However, if a daemon is started from a 'root' account, it will switch to a 'zabbix' user account, which must be present. To create such a user account (in its own group, "zabbix"), on a RedHat-based system, run: groupadd --system zabbix useradd --system -g zabbix -d /usr/lib/zabbix -s /sbin/nologin -c "Zabbix Monitoring System" zabbix on a Debian-based system, run: addgroup --system --quiet zabbix adduser --quiet --system --disabled-login --ingroup zabbix --home /var/lib/zabbix --no-create-home zabbix ::: noteimportant Zabbix processes do not need a home directory, which is why we do not recommend creating it. However, if you are using some functionality that requires it (e. g. store MySQL credentials in `$HOME/.my.cnf`) you are free to create it using the following commands. On RedHat-based systems, run: mkdir -m u=rwx,g=rwx,o= -p /usr/lib/zabbix chown zabbix:zabbix /usr/lib/zabbix On Debian-based systems, run: mkdir -m u=rwx,g=rwx,o= -p /var/lib/zabbix chown zabbix:zabbix /var/lib/zabbix ::: A separate user account is not required for Zabbix frontend installation. If Zabbix [server](/manual/concepts/server) and [agent](/manual/concepts/agent) are run on the same machine it is recommended to use a different user for running the server than for running the agent. Otherwise, if both are run as the same user, the agent can access the server configuration file and any Admin level user in Zabbix can quite easily retrieve, for example, the database password. ::: noteimportant Running Zabbix as `root`, `bin`, or any other account with special rights is a security risk. ::: ##### 2 Создайте аккаунт пользователя Все процессы демонов Zabbix требуют непривилегированного пользователя. Если демон Zabbix запущен от аккаунта пользователя без привилегий, то он будет работать под этим пользователем. Однако, если демон запущен из под аккаунта «root», демон переключится на аккаунт пользователя «zabbix», который должен существовать. Для создания такого аккаунта пользователя (принадлежащего к своей группе, «zabbix»), в системах на основе RedHat, выполните: groupadd --system zabbix useradd --system -g zabbix -d /usr/lib/zabbix -s /sbin/nologin -c "Zabbix Monitoring System" zabbix в системах на основе Debian, выполните: addgroup --system --quiet zabbix adduser --quiet --system --disabled-login --ingroup zabbix --home /var/lib/zabbix --no-create-home zabbix ::: noteimportant Zabbix процессам не требуется домашная директория, поэтому мы не рекомендуем создавать её. Однако, если вы используете некоторый функционал, которому требуется наличие домашней директории (например, хранение учётных данных mysql в $HOME/.my.cnf), вы вправе создать домашнюю директорию, используя следующие команды. На системах на основе RedHat, выполните: mkdir -m u=rwx,g=rwx,o= -p /usr/lib/zabbix chown zabbix:zabbix /usr/lib/zabbix На системах на основе Debian, выполните: mkdir -m u=rwx,g=rwx,o= -p /var/lib/zabbix chown zabbix:zabbix /var/lib/zabbix ::: Для установки веб-интерфейса Zabbix отдельного аккаунта пользователя не требуется. Если Zabbix [сервер](/manual/concepts/server) и [агент](/manual/concepts/agent) работают на одной машине, то рекомендуется использовать разных пользователей для запуска сервера и для запуска агента. В противном случае, если сервер и агент запущены под одним пользователем, агент будет иметь доступ к файлу конфигурации сервера и любой пользователь с правами Администратора в Zabbix может с легкостью получить, например, пароль от базы данных. ::: noteimportant Запуск Zabbix из под `root`, `bin` или из под любых других аккаунтов со специальными правами является риском для безопасности. ::: # 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#настройка-низкоуровневого-обнаружения), можно обнаруживать и сетевые интерфейсы. # 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» для просмотра процессов — он показывает только процессы, не относящиеся к ядру. Используйте «ps -Af», чтобы увидеть все процессы, которые будет видеть агент Zabbix. 3. Давайте рассмотрим пример «topasrec», как proc.mem[] агента Zabbix выбирает процессы. ``` $ ps -Af | grep topasrec root 1074798410Mar 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[<имя>,<пользователь>,<режим>,<cmdline>,<тип памяти>] ``` # 2 Frontend sections Please use the sidebar to access content in the Frontend sections section. # 2. Разделы веб-интерфейса Пожалуйста, воспользуйтесь боковым меню для доступа к содержимому подразделов раздела «Веб-интерфейс». # 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 Рекомендуемые настройки UnixODBC для PostgreSQL # 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'ы Некоторые OID'ы, наиболее часто используемые в SNMP, автоматически преобразуются в числовые представления самим 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|Количество входящих, но отвергнутых пакетов, даже если не было обнаружено ошибок, мешающих доставке пакетов протоколу более высокого уровня. Одной из возможных причин для отвержения пакета могло быть освобождение места в буфере.| |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|Количество исходящих пакетов, которые были отвергнуты, даже если не было обнаружено ошибок, мешающих отправке. Одной из возможных причин отвержения пакета могло быть освобождение места в буфере.| |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 Trigger prototypes We create trigger prototypes in a similar way as item prototypes:  Attributes that are specific for trigger prototypes: |Parameter|Description| |--|--------| |*Create enabled*|If checked the trigger will be added in an enabled state.<br>If unchecked, the trigger will be added to a discovered entity, but in a disabled state.| |*Discover*|If checked (default) the trigger will be added to a discovered entity.<br>If unchecked, the trigger will not be added to a discovered entity, unless this setting is [overridden](/manual/discovery/low_level_discovery#override) in the discovery rule.| When real triggers are created from the prototypes, there may be a need to be flexible as to what constant ('20' in our example) is used for comparison in the expression. See how [user macros with context](/manual/config/macros/user_macros_context#use-cases) can be useful to accomplish such flexibility. You can define [dependencies](/manual/config/triggers/dependencies) between trigger prototypes as well (supported since Zabbix 3.0). To do that, go to the *Dependencies* tab. A trigger prototype may depend on another trigger prototype from the same low-level discovery (LLD) rule or on a regular trigger. A trigger prototype may not depend on a trigger prototype from a different LLD rule or on a trigger created from trigger prototype. Host trigger prototype cannot depend on a trigger from a template.  # 2. Прототипы триггеров Прототипы триггеров мы создаём аналогично тому, как создавали прототипы элементов данных:  Атрибуты, специфичные для прототипов триггеров: |Параметр|Описание| |--|--------| |*Создать активированным*<br>*(Create enabled)*|Если отмечено, триггер будет добавлен в активированном состоянии.<br>Если не отмечено, триггер будет добавлен для обнаруженного оъекта, но в деактивированном состоянии.| |*Обнаружение*<br>*(Discover)*|Если отмечено (по умолчанию), триггер будет добавлен для обнаруженного объекта.<br>Если не отмечено, триггер не будет добавлен для обнаруженного объекта, если только эта настройка не будет [переопределена](/manual/discovery/low_level_discovery#замещения) в правиле обнаружения.| При создании из прототипа реального триггера может потребоваться бОльшая гибкость касательно констант, используемых в выражении для сравнения («20» в нашем примере). Смотрите, как [пользовательские макросы с контекстом](/manual/config/macros/user_macros_context#примеры-использования) могут быть полезными для достижения такой гибкости. Вы также можете определить [зависимости](/manual/config/triggers/dependencies) между прототипами триггеров (поддерживается с версии Zabbix 3.0). Чтобы это сделать, перейдите на вкладку *Зависимости (Dependencies)*. Прототип триггера может зависеть от другого прототипа триггера из того же правила LLD или от обычного триггера. Прототип триггера не может зависеть от прототипа триггера из другого правила LLD или от триггера, созданного из прототипа триггера. Прототип триггера узла сети не может зависеть от триггера из шаблона.  # 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. Использование общих ключей (pre-shared keys) # 2 vm.memory.size parameters # 2. Параметры vm.memory.size # 2 Web scenarios # 2. Веб-сценарии # 2 What is Zabbix # 2. Что такое Zabbix # 2 Windows-specific item keys # 2. Специфичные ключи элементов данных для Windows # 2 Zabbix agent 2 template operation Steps to ensure correct operation of templates that collect metrics with [Zabbix agent 2](/manual/concepts/agent2): 1. Make sure that the agent 2 is installed on the host, and that the installed version contains the required plugin. In some cases, you may need to [upgrade](/manual/installation/upgrade) the agent 2 first. 2. [Link](/manual/config/templates/linking#linking-a-template) the template to a target host (if the template is not available in your Zabbix installation, you may need to import the template's .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions). 3. If necessary, adjust the values of template macros. Note that user macros can be used to override configuration parameters. 4. Configure the instance being monitored to allow data sharing with Zabbix. ::: noteimportant Zabbix agent 2 templates work in conjunction with the plugins. While the basic configuration can be done by simply adjusting user macros, the deeper customization can be achieved by [configuring the plugin](/manual/extensions/plugins#named_sessions) itself. For example, if a plugin supports named sessions, it is possible to monitor several entities of the same kind (e.g. MySQL1 and MySQL2) by specifying named session with own URI, username and password for each entity in the configuration file. ::: A detailed description of a template, including the full list of macros, items, and triggers, is available in the template's README file (accessible by clicking on a template name). The following templates are available: - [Ceph by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ceph_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Docker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/docker/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Memcached](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/memcached/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MongoDB cluster by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mongodb_cluster/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MongoDB node by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mongodb/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MySQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Oracle by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [PostgreSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Redis](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/redis/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SMART by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/module/smart_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SMART by Zabbix agent 2 active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/module/smart_agent2_active/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Systemd by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/systemd/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Website certificate by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/certificate_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 2. Работа с Zabbix agent 2 шаблонами Шаги для гарантии корректной работы шаблонов, которые собирают метрики через [Zabbix агент 2](/manual/concepts/agent2): 1. Убедитесь, что на хосте установлен агент 2 и что установленная версия содержит необходимый плагин. В некоторых случаях вам, возможно, потребуется сначала [обновить](/manual/installation/upgrade) агента 2. 2. [Присоедините](/manual/config/templates/linking#присоединение-шаблона) шаблон к нужному узлу сети. Если шаблон недоступен в вашей инсталляции Zabbix, вам может потребоваться сначала импортировать файл .yaml шаблона — смотрите инструкции в разделе [Готовые шаблоны](/manual/config/templates_out_of_the_box)). 3. При необходимости измените значения обязательных макросов шаблона. Обратите внимание, что можно использовать пользовательские макросы, чтобы переопределить параметры конфигурации. 4. Настройте экземпляр для мониторинга так, чтобы обмен данными с Zabbix был разрешён. ::: noteimportant Шаблоны Zabbix агента 2 работают в сочетании с плагинами. В то время как базовую настройку можно сделать простым изменением пользовательских макросов, более глубокой настройки можно достичь путём [настройки самого плагина](/manual/extensions/plugins#именованные-сессии). Например, если плагин поддерживает именованные сессии, можно отслеживать несколько объектов одного типа (к примеру, MySQL1 и MySQL2), указав для каждого из них в файле конфигурации именованную сессию с собственным URI, именем пользователя и паролем. ::: Подробное описание шаблона, включая полный список макросов, элементов данных и триггеров, доступно в файле README \[en\] шаблона (доступном при нажатии на имя шаблона). Доступны следующие шаблоны: - [Ceph by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ceph_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Docker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/docker/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Memcached](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/memcached/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MongoDB cluster by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mongodb_cluster/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MongoDB node by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mongodb/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MySQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Oracle by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [PostgreSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Redis](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/redis/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SMART by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/module/smart_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SMART by Zabbix agent 2 active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/module/smart_agent2_active/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Systemd by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/systemd/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Website certificate by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/certificate_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 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 ##### 32-битный Откройте MinGW среду (командную строку Windows) и перейдите к директории *build/mingw* в дереве исходного кода Zabbix. Выполните: 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. Агент 2 # 3 Authentication # 3 Аутентификация # 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/doc/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/doc/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. Сборка Zabbix агента на macOS ##### 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 Обзор данных # 3 Data overview # 3. Обзор данных # 3 Date and time functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) ::: noteimportant Date and time functions cannot be used in the expression by themselves; at least one function from [another group](/manual/appendix/functions), referencing the host item, must be included in the expression (except the nodata function). For detailed information on how date and time functions work within expressions, see [Calculation time](/manual/config/triggers#calculation_time). ::: |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**date**|<|<| |Current date in YYYYMMDD format.| |Example:<br>=> **date**()<20220101| |**dayofmonth**|<|<| |Day of month in range of 1 to 31.| |Example:<br>=> **dayofmonth**()=1| |**dayofweek**|<|<| |Day of week in range of 1 to 7 (Mon - 1, Sun - 7).| |Example (only weekdays):<br>=> **dayofweek**()<6<br><br>Example (only weekend):<br>=> **dayofweek**()>5| |**now**|<|<| |Number of seconds since the Epoch (00:00:00 UTC, January 1, 1970).| |Example:<br>=> **now**()<1640998800| |**time**|<|<| |Current time in HHMMSS format.| |Example (only nighttime, 00:00-06:00):<br>=> **time**()<060000| # 3. Функции даты и времени Все перечисленные здесь функции поддерживаются в: - [триггерных выражениях](/manual/config/triggers/expression) - [вычисляемых элементах данных](/manual/config/items/itemtypes/calculated) ::: noteimportant Функции даты и времени не могут быть использованы в выражении сами по себе; в выражении должна присутствовать ещё хотя бы одна функция из [другой группы](/manual/appendix/functions), ссылающаяся на элемент данных узла сети (за исключением функции nodata). Подробную информацию о том, как функция nodata() работает в выражениях, смотрите в разделе [Время вычисления](/manual/config/triggers#время-вычисления). ::: |ФУНКЦИЯ|<|<| |--|--|--| |**Описание**|**Параметры, специфичные для функции**|**Комментарии**| |**date**|<|<| |Текущая дата в формате ГГГГММДД (YYYYMMDD).| |Пример:<br>=> **date**()<20220101| |**dayofmonth**|<|<| |Число месяца в диапазоне от 1 до 31.| |Пример:<br>=> **dayofmonth**()=1| |**dayofweek**|<|<| |День недели в диапазоне от 1 до 7 (Пн — 1, Вс — 7).| |Пример (только рабочие дни):<br>=> **dayofweek**()<6<br><br>Пример (только выходные):<br>=> **dayofweek**()>5| |**now**|<|<| |Количество секунд с начала эпохи Unix (00:00:00 1 января 1970 года по Гринвичу).| |Пример:<br>=> **now**()<1640998800| |**time**|<|<| |Текущее время в формате ЧЧММСС (HHMMSS).| |Пример (только ночное время, 00:00—06:00):<br>=> **time**()<060000| # 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#настройка-низкоуровневого-обнаружения), можно также обнаруживать 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>*(Discover)*|Если отмечено (по умолчанию), график будет добавлен для обнаруженного объекта.<br>Если не отмечено, график не будет добавлен для обнаруженного объекта, если только эта настройка не будет [переопределена](/manual/discovery/low_level_discovery#замещения) в правиле обнаружения.|  Наконец, мы создали правило обнаружения, которое выглядит, как показано ниже. Оно имеет пять прототипов элементов данных, два прототипа триггеров и один прототип графика.  *Обратите внимание*: для настройки прототипов узлов сети, смотрите раздел о настройке [прототипов узлов сети](/manual/vm_monitoring#прототипы-узлов-сети) в мониторинге виртуальных машин. # 3 Graphs # 3. Графики # 3 Graphs # 3. Графики # 3 Hosts # 3. Узлы сети # 3 Hosts # 3. Узлы сети # 3 Hosts # 3. Узлы сети # 3 HTTP template operation Steps to ensure correct operation of templates that collect metrics with the [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 .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions). 3. If necessary, adjust the values of template macros. 4. Configure the instance being monitored to allow data sharing with Zabbix. A detailed description of a template, including the full list of macros, items and triggers, is available in the template's README file (accessible by clicking on a template name). The following templates are available: - [Acronis Cyber Protect Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/acronis/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Asterisk by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/tel/asterisk_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS Cost Explorer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS EC2 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS ECS Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS ECS Serverless Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS ELB Application Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS ELB Network Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS RDS instance by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS S3 bucket by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Cisco Meraki organization by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/meraki_http/README.md?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/README.md?at=release%2F6.0) - [ClickHouse by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/clickhouse_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Cloudflare by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/cloudflare_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [CockroachDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cockroachdb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Control-M enterprise manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/controlm_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Control-M server by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/controlm_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [DELL PowerEdge R720 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r720_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [DELL PowerEdge R740 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r740_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [DELL PowerEdge R820 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r820_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [DELL PowerEdge R840 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r840_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Elasticsearch Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/elasticsearch_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Envoy Proxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/envoy_proxy_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Etcd by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/etcd_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [FortiGate by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GitHub repository by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GitLab by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/gitlab_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Google Cloud Platform by HTTP (GCP by HTTP)](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Hadoop by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/hadoop_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HAProxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Consul Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/consul_http/consul_cluster/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Consul Node by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/consul_http/consul/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Nomad by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nomad/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Vault by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vault_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Hikvision camera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cctv/hikvision/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HPE iLO by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HPE MSA 2040 Storage by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_msa2040_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HPE MSA 2060 Storage by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_msa2060_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HPE Primera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_primera_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HPE Synergy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_synergy_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [InfluxDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/influxdb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Jenkins by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jenkins/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Kubernetes API server by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_api_server_http/README.md?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/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Kubernetes Controller manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_controller_manager_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Kubernetes kubelet by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_kubelet_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Kubernetes nodes by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_nodes_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Kubernetes Scheduler by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_scheduler_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MantisBT by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/mantisbt/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft 365 reports by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft SharePoint by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [NetApp AFF A700 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/netapp_aff_a700_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Nextcloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [NGINX by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [NGINX Plus by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_plus_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Nutanix Prism Element by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [OpenStack by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/openstack/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [OpenWeatherMap by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/openweathermap_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Oracle Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud/README.md?at=release%2F6.0) - [PHP-FPM by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Proxmox VE by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/proxmox/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [RabbitMQ cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [TiDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tidb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [TiDB PD by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_pd_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [TiDB TiKV by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tikv_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Travis CI by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/travis_ci_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Veeam Backup Enterprise Manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/veeam/enterprise_manager_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Veeam Backup and Replication by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/veeam/backup_replication_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [VMware SD-WAN VeloCloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [ZooKeeper by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zookeeper_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 3. Работа с HTTP шаблонами Шаги для гарантии корректной работы шаблонов, которые собирают метрики через [HTTP агент](/manual/config/items/itemtypes/http): 1. Создайте узел сети в Zabbix и укажите IP-адрес или DNS-имя наблюдаемой единицы в качестве основного интерфейса. Это необходимо для правильного раскрытия макроса {HOST.CONN} в элементах данных шаблона. 2. [Присоедините](/manual/config/templates/linking#присоединение-шаблона) шаблон к узлу сети, созданному на шаге 1 (если шаблон недоступен в вашей инсталляции Zabbix, вам может потребоваться сначала импортировать файл .yaml шаблона — смотрите инструкции в разделе [Готовые шаблоны](/manual/config/templates_out_of_the_box)). 3. При необходимости измените значения макросов шаблона. 4. Настройте экземпляр для мониторинга так, чтобы был разрешён обмен данными с Zabbix. Подробное описание шаблона, включая полный список макросов, элементов данных и триггеров, доступно в файле README \[en\] шаблона (доступном при нажатии на имя шаблона). Доступны следующие шаблоны: - [Acronis Cyber Protect Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/acronis/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Asterisk by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/tel/asterisk_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS Cost Explorer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS EC2 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS ECS Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS ECS Serverless Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS ELB Application Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS ELB Network Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS RDS instance by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS S3 bucket by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Cisco Meraki organization by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/meraki_http/README.md?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/README.md?at=release%2F6.0) - [ClickHouse by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/clickhouse_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Cloudflare by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/cloudflare_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [CockroachDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cockroachdb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Control-M enterprise manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/controlm_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Control-M server by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/controlm_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [DELL PowerEdge R720 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r720_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [DELL PowerEdge R740 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r740_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [DELL PowerEdge R820 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r820_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [DELL PowerEdge R840 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r840_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Elasticsearch Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/elasticsearch_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Envoy Proxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/envoy_proxy_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Etcd by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/etcd_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [FortiGate by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GitHub repository by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GitLab by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/gitlab_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Google Cloud Platform by HTTP (GCP by HTTP)](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HPE iLO by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Hadoop by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/hadoop_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HAProxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Consul Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/consul_http/consul_cluster/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Consul Node by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/consul_http/consul/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Nomad by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nomad/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Vault by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vault_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Hikvision camera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cctv/hikvision/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HPE MSA 2040 Storage by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_msa2040_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HPE MSA 2060 Storage by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_msa2060_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HPE Primera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_primera_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HPE Synergy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_synergy_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [InfluxDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/influxdb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Jenkins by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jenkins/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Kubernetes API server by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_api_server_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Kubernetes Controller manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_controller_manager_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Kubernetes kubelet by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_kubelet_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Kubernetes nodes by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_nodes_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Kubernetes Scheduler by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_scheduler_http/README.md?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/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MantisBT by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/mantisbt/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft 365 reports by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft SharePoint by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [NetApp AFF A700 by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/netapp_aff_a700_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Nextcloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [NGINX by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [NGINX Plus by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_plus_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Nutanix Prism Element by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [OpenStack by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/openstack/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [OpenWeatherMap by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/openweathermap_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Oracle Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud/README.md?at=release%2F6.0) - [PHP-FPM by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Proxmox VE by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/proxmox/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [RabbitMQ cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [TiDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tidb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [TiDB PD by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_pd_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [TiDB TiKV by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tikv_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Travis CI by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/travis_ci_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Veeam Backup Enterprise Manager by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/veeam/enterprise_manager_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Veeam Backup and Replication by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/veeam/backup_replication_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [VMware SD-WAN VeloCloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [ZooKeeper by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zookeeper_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 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#установка-демонов-zabbix) для компиляции Zabbix агента из исходного кода. В качестве альтернативы, вы можете загрузить уже скомпилированные Zabbix агенты со [страницы загрузки Zabbix](http://www.zabbix.com/ru/download.php). ##### 3 Install new proxy binaries Use these [instructions](/manual/installation/install#installing_zabbix_daemons) to compile Zabbix proxy from sources. ##### 3 Установите новые бинарные файлы прокси Воспользуйтесь этими [инструкциями](/manual/installation/install#установка-демонов-zabbix) для компиляции 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. Низкоуровневое обнаружение (LLD) # 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 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 Рекомендуемые настройки UnixODBC для Oracle # 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 Пожалуйста, воспользуйтесь боковым меню для доступа к содержимому раздела Процессы 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 # 48 What's new in Zabbix 6.0.43 See [breaking changes](/manual/installation/upgrade_notes_6043#breaking-changes) for this version. # 48. Что нового в Zabbix 6.0.43 Смотрите [критические изменения](/manual/installation/upgrade_notes_6043#критические-изменения) для этой версии. # 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 Configure the sources C99 with GNU extensions is required for building Zabbix server, Zabbix proxy or Zabbix agent. This version can be explicitly specified by setting CFLAGS="-std=gnu99": export CFLAGS="-std=gnu99" ::: noteclassic If installing from [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), it is required to run first: `./bootstrap.sh` ::: When configuring the sources for a Zabbix server or proxy, you must specify the database type to be used. Only one database type can be compiled with a server or proxy process at a time. To see all of the supported configuration options, inside the extracted Zabbix source directory run: ./configure --help To configure the sources for a Zabbix server and agent, you may run something like: ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openipmi To configure the sources for a Zabbix server (with PostgreSQL etc.), you may run: ./configure --enable-server --with-postgresql --with-net-snmp To configure the sources for a Zabbix proxy (with SQLite etc.), you may run: ./configure --prefix=/usr --enable-proxy --with-net-snmp --with-sqlite3 --with-ssh2 To configure the sources for a Zabbix agent, you may run: ./configure --enable-agent or, for Zabbix agent 2: ./configure --enable-agent2 ::: noteclassic A [supported Go version](/manual/installation/requirements#agent-2) must be installed to build Zabbix agent 2. ::: Notes on compilation options: - Command-line utilities zabbix\_get and zabbix\_sender are compiled if --enable-agent option is used. - --with-libcurl and --with-libxml2 configuration options are required for virtual machine monitoring; --with-libcurl is also required for SMTP authentication and `web.page.*` Zabbix agent [items](/manual/config/items/itemtypes/zabbix_agent). Note that cURL 7.20.0 or higher is [required](/manual/installation/requirements) with the --with-libcurl configuration option. - Zabbix always compiles with the PCRE library (since version 3.4.0); installing it is not optional. --with-libpcre=\[DIR\] only allows pointing to a specific base install directory, instead of searching through a number of common places for the libpcre files. - You may use the --enable-static flag to statically link libraries. If you plan to distribute compiled binaries among different servers, you must use this flag to make these binaries work without required libraries. Note that --enable-static does not work in [Solaris](https://docs.oracle.com/cd/E18659_01/html/821-1383/bkajp.html). - Using --enable-static option is not recommended when building server. In order to build the server statically, you must have a static version of every external library needed. There is no strict check for that in configure script. - Add optional path to the MySQL configuration file --with-mysql=/<path\_to\_the\_file>/mysql\_config to select the desired MySQL client library when there is a need to use one that is not located in the default location. It is useful when there are several versions of MySQL installed or MariaDB installed alongside MySQL on the same system. - Use --with-oracle flag to specify location of the OCI API. ::: noteimportant If ./configure fails due to missing libraries or some other circumstance, please see the `config.log` file for more details on the error. For example, if `libssl` is missing, the immediate error message may be misleading: checking for main in -lmysqlclient... no configure: error: Not found mysqlclient library While `config.log` has a more detailed description: /usr/bin/ld: cannot find -lssl /usr/bin/ld: cannot find -lcrypto ::: See also: - [Compiling Zabbix with encryption support](/manual/encryption#compiling_zabbix_with_encryption_support) for encryption support - [Known issues](/manual/installation/known_issues/compilation_issues#compiling_zabbix_agent_on_hp-ux) with compiling Zabbix agent on HP-UX ##### 4 Сконфигурируйте исходный код Для построения Zabbix сервера, Zabbix прокси или Zabbix агента требуется C99 с расширениями GNU. Эта версия может быть явно указана путём выставления CFLAGS="-std=gnu99": export CFLAGS="-std=gnu99" ::: noteclassic При установке из [Zabbix репозитория Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), необходимо сначала выполнить: `./bootstrap.sh` ::: При конфигурировании исходного кода Zabbix сервера или прокси, вы должны указать используемый тип базы данных. Только один тип базы данных может быть скомпилирован для процессов сервера или прокси единовременно. Для просмотра всех доступных опций конфигурирования, выполните в папке с извлечённым исходным кодом Zabbix: ./configure --help Для конфигурирования исходных кодов для Zabbix сервера и агента, вы можете выполнить нечто вроде: ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openipmi Для конфигурирования исходных кодов для Zabbix сервера (с PostgreSQL и т.д.), вы можете выполнить: ./configure --enable-server --with-postgresql --with-net-snmp Для конфигурирования исходных кодов для Zabbix прокси (с SQLite и т.д.), вы можете выполнить: ./configure --prefix=/usr --enable-proxy --with-net-snmp --with-sqlite3 --with-ssh2 Для конфигурирования исходных кодов для Zabbix агента, вы можете выполнить: ./configure --enable-agent или, для Zabbix агента 2: ./configure --enable-agent2 ::: noteclassic Для сборки Zabbix агента 2 должна быть установлена [поддерживаемая версия Go](/manual/installation/requirements#агент-2). ::: Заметки по опциям компиляции: - Утилиты командной строки zabbix\_get и zabbix\_sender компилируются, если указана опция --enable-agent. - Опции конфигурирования --with-libcurl и --with-libxml2 требуются для мониторинга виртуальных машин; --with-libcurl также требуется для SMTP аутентификации и `web.page.*` [элементов данных](/manual/config/items/itemtypes/zabbix_agent) с типом Zabbix агент. Обратите внимание, что для опции конфигурирования --with-libcurl [требуется](/manual/installation/requirements) cURL версии 7.20.0 или выше. - Zabbix всегда компилируется с библиотекой PCRE (начиная с версии 3.4.0); её установка не является опциональной. --with-libpcre=\[ДИРЕКТОРИЯ\] только позволяет указать отличную от умолчания базовую директорию с установленной библиотекой PCRE, в отличие от поиска libpcre файлов по нескольким общепризнанным директориям. - Вы можете использовать флаг --enable-static, чтобы выполнить статическую линковку библиотек. Если вы планируете установить скомпилированные бинарные файлы на разные сервера, вам необходимо использовать этот флаг, чтобы эти бинарные файлы работали без наличия требуемых библиотек. Обратите внимание, что --enable-static не работает в [Solaris](https://docs.oracle.com/cd/E18659_01/html/821-1383/bkajp.html). - Использование опции --enable-static не рекомендуется при сборке сервера. В случае статичной сборки сервера, вам необходимо будет предоставить статичную версию каждой внешней библиотеки. В скрипте конфигурирования отсутствует строгая проверка этого. - Добавьте опциональный путь к файлу конфигурации MySQL --with-mysql=/<путь\_к\_файлу>/mysql\_config, чтобы выбрать желаемую клиентскую библиотеку MySQL, если требуется использовать библиотеку, которая не располагается в директориях по умолчанию. Такой подход имеет смысл, если на одной системе у вас имеется несколько установленных версий MySQL или наряду с MySQL установлена MariaDB. - Используйте флаг --with-oracle, чтобы указать расположение OCI API. ::: noteimportant Если ./configure завершается с ошибкой по причине отсутствующих библиотек или по какой-либо другой причине, пожалуйста, просмотрите файл `config.log` для получения более подробных сведений касательно ошибки. Например, если отсутствует `libssl`, непосредственное сообщение об ошибке может ввести в заблуждение: checking for main in -lmysqlclient... no configure: error: Not found mysqlclient library Тогда как `config.log` будет иметь более подробное описание: /usr/bin/ld: cannot find -lssl /usr/bin/ld: cannot find -lcrypto ::: Смотрите также: - [Компиляция Zabbix с поддержкой шифрования](/manual/encryption#компиляция-zabbix-с-поддержкой-шифрования) для поддержки шифрования - [Известные проблемы](/manual/installation/known_issues/compilation_issues#компиляция-zabbix-агента-на-hp-ux) с компиляцией Zabbix агента на HP-UX # 4 Discovery of SNMP OIDs # 4. Обнаружение SNMP OID'ов # 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) Некоторые общие замечания о параметрах функций: - параметры функций разделяются запятыми - необязательные параметры функций (или части параметров) обозначаются угловыми скобками `<` `>` - параметры, специфичные для функций, описываются с каждой функцией - параметры `/узел_сети/ключ` и `(сек|#число)<:сдвиг_времени>` никогда не должны заключаться в кавычки # 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 Установка веб-сервиса Zabbix Установка веб-сервиса Zabbix требуется только, если вы хотите использовать [отчеты по расписанию](/manual/web_interface/frontend_sections/reports/scheduled). Чтобы установить из исходного кода, сначала [загрузите](/manual/installation/install#загрузите-архив-исходных-кодов) и извлеките исходный код из архива. Чтобы скомпилировать веб-сервис Zabbix, выполните скрипт `./configure` с `--enable-webservice` опцией. ::: noteclassic Для сборки веб-сервиса Zabbix требуется [Go](https://golang.org/doc/install) среда версии 1.13+. ::: ##### 4 Install new server binaries Use these [instructions](/manual/installation/install#installing_zabbix_daemons) to compile Zabbix server from sources. ##### 4 Установите новые бинарные файлы сервера Воспользуйтесь этими [инструкциями](/manual/installation/install#установка-демонов-zabbix) для компиляции Zabbix сервера из исходных кодов. # 4 IPMI template operation IPMI templates do not require any specific setup. To start monitoring, [link](/manual/config/templates/linking#linking-a-template) the template to a target host (if the template is not available in your Zabbix installation, you may need to import the template's .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions). A detailed description of a template, including the full list of macros, items, and triggers, is available in the template's README file (accessible by clicking on a template name). Available template: - [Chassis by IPMI](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/chassis_ipmi/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 4. Работа с IPMI шаблонами Шаблоны IPMI не требуют какой-либо особой настройки. Чтобы начать мониторинг, [присоедините](/manual/config/templates/linking#присоединение-шаблона) шаблон к нужному узлу сети (если шаблон недоступен в вашей инсталляции Zabbix, вам может потребоваться сначала импортировать файл .yaml шаблона — смотрите инструкции в разделе [Готовые шаблоны](/manual/config/templates_out_of_the_box)). Подробное описание шаблона, включая полный список макросов, элементов данных и триггеров, доступно в файле README \[en\] шаблона (доступном при нажатии на имя шаблона). Доступные шаблоны: - [Chassis by IPMI](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/chassis_ipmi/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 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 Proxy # 4 Прокси # 4 Recommended UnixODBC settings for MSSQL # 4 Рекомендуемые настройки UnixODBC для MSSQL # 4 Reports # 4. Отчёты ##### 4 Review agent configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_600) to check if any changes in the configuration parameters are required. For new optional parameters, see the [What's new](/manual/introduction/whatsnew600) page. ##### 4 Проверьте параметры конфигурации агента Обязательно ознакомьтесь с [Заметками по обновлению](/manual/installation/upgrade_notes_600), чтобы проверить, не требуются ли какие-то изменения в параметрах конфигурации. Новые необязательные параметры можно найти на странице [Что нового](/manual/introduction/whatsnew600). ##### 4 Review proxy configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_600) to check if any changes in the configuration parameters are required. For new optional parameters, see the [What's new](/manual/introduction/whatsnew600) page. ##### 4 Проверьте параметры конфигурации прокси Обязательно ознакомьтесь с [Заметками по обновлению](/manual/installation/upgrade_notes_600), чтобы проверить, не требуются ли какие-то изменения в параметрах конфигурации. Новые необязательные параметры можно найти на странице [Что нового](/manual/introduction/whatsnew600). # 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 по умолчанию поддерживает следующие важности триггеров: |Важность|Цвет|Описание| |-|-|--------| |Не классифицировано<br>(Not classified)|Серый|Может использоваться, когда уровень важности события неизвестен, не был определён, не входит в рамки обычного мониторинга и т.п.; например, во время первоначальной настройки, как заполнитель для последующей оценки, как часть процесса интеграции.| |Информация<br>(Information)|Светло-синий|Может использоваться для информационных событий, которые не требуют немедленного внимания, но могут дать ценную информацию.| |Предупреждение<br>(Warning)|Жёлтый|Может использоваться для обозначения потенциальной проблемы, которая может потребовать расследования или принятия мер, но не является критической.| |Средняя<br>(Average)|Оранжевый|Может использоваться для обозначения серьёзной проблемы, которую следует решить относительно быстро, чтобы предотвратить дальнейшие проблемы.| |Высокая<br>(High)|Светло-красный|Может использоваться для обозначения критических проблем, требующих немедленного внимания во избежание значительных сбоев.| |Чрезвычайная<br>(Disaster)|Красный|Может использоваться для обозначения серьёзного инцидента, который требует немедленных действий для предотвращения, например, сбоев в работе системы или потери данных.| ::: noteclassic Имеется возможность [настроить](/manual/config/triggers/customseverities) имена важностей триггеров и их цвета. ::: Важности триггеров используются для: - визуального представления триггеров — различные цвета для различных уровней важности; - аудио в глобальных оповещениях — различные звуковые сигналы для различных важностей; - оповещений пользователей — различные способы оповещений (каналы оповещения) для различных важностей. Например, SMS — для триггеров высокой и чрезвычайной важности, Email — для остального; - ограничения действий по условиям важностей триггеров. # 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&comComponents=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&comComponents=agent&db=&ws=). Затем очистите кэш менеджера пакетов `dnf` (включая заголовки, метаданные и файлы пакетов, загруженные во время предыдущих установок или обновлений): dnf clean all При последующей работе `dnf` загрузит свежие метаданные из репозиториев, поскольку старые метаданные будут очищены. См. также: [Известные проблемы](/manual/installation/known_issues#истекший-срок-действия-ключа-подписи-для-пакетов-rhel) для обновления пакета конфигурации репозитория в RHEL. ##### 4 Update repository configuration package To proceed with the update your current repository package has to be uninstalled. # rm -Rf /etc/apt/sources.list.d/zabbix.list Then install the new repository configuration package. On **Debian 10** run: # wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian10_all.deb # dpkg -i zabbix-release_5.4-1+debian10_all.deb On **Debian 9** run: # wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian9_all.deb # dpkg -i zabbix-release_5.4-1+debian9_all.deb On **Debian 8** run: # wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian8_all.deb # dpkg -i zabbix-release_5.4-1+debian8_all.deb On **Ubuntu 20.04** run: # wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb # dpkg -i zabbix-release_5.4-1+ubuntu20.04_all.deb On **Ubuntu 18.04** run: # wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu18.04_all.deb # dpkg -i zabbix-release_6.0-1+ubuntu18.04_all.deb On **Ubuntu 16.04** run: # wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb # dpkg -i zabbix-release_5.4-1+ubuntu16.04_all.deb On **Ubuntu 14.04** run: # wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu14.04_all.deb # dpkg -i zabbix-release_6.0-1+ubuntu14.04_all.deb Update the repository information. # apt-get update ##### 4 Обновите пакет конфигурации репозитория Чтобы продолжить обновление, необходимо удалить текущий пакет репозитория. # rm -Rf /etc/apt/sources.list.d/zabbix.list Затем установите новый пакет конфигурации репозитория. На **Debian 10** выполните: # wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian10_all.deb # dpkg -i zabbix-release_5.4-1+debian10_all.deb На **Debian 9** выполните: # wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian9_all.deb # dpkg -i zabbix-release_5.4-1+debian9_all.deb На **Debian 8** выполните: # wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian8_all.deb # dpkg -i zabbix-release_5.4-1+debian8_all.deb На **Ubuntu 20.04** выполните: # wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb # dpkg -i zabbix-release_5.4-1+ubuntu20.04_all.deb На **Ubuntu 18.04** выполните: # wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu18.04_all.deb # dpkg -i zabbix-release_6.0-1+ubuntu18.04_all.deb На **Ubuntu 16.04** выполните: # wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb # dpkg -i zabbix-release_5.4-1+ubuntu16.04_all.deb На **Ubuntu 14.04** выполните: # wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu14.04_all.deb # dpkg -i zabbix-release_6.0-1+ubuntu14.04_all.deb Обновите информацию о репозитории. # apt-get update ##### 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. Вебхук # 4 Windows agent installation from MSI # 4. Установка Windows агента из MSI # 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 Эта минорная версия не имеет каких-либо заметок по обновлению. # 50 What's new in Zabbix 6.0.45 # 50. Что нового в Zabbix 6.0.45 # 51 Upgrade notes for 6.0.41 # 51. Заметки по обновлению для 6.0.41 # 51 What's new in Zabbix 6.0.46 # 51. Что нового в Zabbix 6.0.46 # 52 Upgrade notes for 6.0.42 This minor version does not have any upgrade notes. # 52. Заметки по обновлению для 6.0.42 Эта минорная версия не имеет каких-либо заметок по обновлению. # 53 Upgrade notes for 6.0.43 # 53. Заметки по обновлению для 6.0.43 # 54 Upgrade notes for 6.0.44 This minor version does not have any upgrade notes. # 54. Заметки по обновлению для 6.0.44 Эта минорная версия не имеет каких-либо заметок по обновлению. # 55 Upgrade notes for 6.0.45 # 55. Заметки по обновлению для 6.0.45 # 56 Upgrade notes for 6.0.46 This minor version does not have any upgrade notes. # 56. Заметки по обновлению для 6.0.46 Эта минорная версия не имеет каких-либо заметок по обновлению. # 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. Пользовательские важности триггеров Названия важностей триггеров и цвета элементов веб-интерфейса, связанных с важностью, можно настроить в *Администрирование → Общие → Опции отображения триггеров*. Цвета являются общими по всем темам веб-интерфейса. # 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. Java gateway # 5 JMX template operation Steps to ensure correct operation of templates that collect metrics by [JMX](/manual/config/items/itemtypes/jmx_monitoring): 1. Make sure that Zabbix [Java gateway](/manual/concepts/java#getting-java-gateway) is installed and set up properly. 2. [Link](/manual/config/templates/linking#linking-a-template) the template to the target host. The host should have the JMX interface set up.<br> If the template is not available in your Zabbix installation, you may need to import the template's .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions. 3. If necessary, adjust the values of template macros. 4. Configure the instance being monitored to allow data sharing with Zabbix. A detailed description of a template, including the full list of macros, items, and triggers, is available in the template's README file (accessible by clicking on a template name). The following templates are available: - [Apache ActiveMQ by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/activemq_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache Cassandra by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cassandra_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache Kafka by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kafka_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache Tomcat by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/tomcat_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GridGain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/gridgain_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Ignite by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/ignite_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [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) - [WildFly Domain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_domain_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [WildFly Server by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_server_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 5. Работа с JMX шаблонами Шаги для гарантии корректной работы шаблонов, которые собирают метрики через [JMX](/manual/config/items/itemtypes/jmx_monitoring): 1. Убедитесь, что Zabbix [Java gateway](/manual/concepts/java#получение-java-gateway) установлен и работает должным образом. 2. [Присоедините](/manual/config/templates/linking#присоединение-шаблона) шаблон к нужному узлу сети. Этот узел сети должен иметь настроенный интерфейс JMX.<br> Если шаблон недоступен в вашей инсталляции Zabbix, вам может потребоваться сначала импортировать файл .yaml шаблона — смотрите инструкции в разделе [Готовые шаблоны](/manual/config/templates_out_of_the_box)). 3. При необходимости измените значения макросов шаблона. 4. Настройте экземпляр для мониторинга так, чтобы обмен данными с Zabbix был разрешён. Подробное описание шаблона, включая полный список макросов, элементов данных и триггеров, доступно в файле README \[en\] шаблона (доступном при нажатии на имя шаблона). Доступны следующие шаблоны: - [Apache ActiveMQ by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/activemq_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache Cassandra by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cassandra_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache Kafka by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kafka_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache Tomcat by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/tomcat_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GridGain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/gridgain_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Ignite by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/ignite_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [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) - [WildFly Domain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_domain_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [WildFly Server by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_server_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 5 Mac OS agent installation from PKG # 5. Установка агента на Mac OS из PKG ##### 5 Make and install everything ::: noteclassic If installing from [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), it is required to run first: `$ make dbschema` ::: make install This step should be run as a user with sufficient permissions (commonly 'root', or by using `sudo`). Running `make install` will by default install the daemon binaries (zabbix\_server, zabbix\_agentd, zabbix\_proxy) in /usr/local/sbin and the client binaries (zabbix\_get, zabbix\_sender) in /usr/local/bin. ::: noteclassic To specify a different location than /usr/local, use a --prefix key in the previous step of configuring sources, for example --prefix=/home/zabbix. In this case daemon binaries will be installed under <prefix>/sbin, while utilities under <prefix>/bin. Man pages will be installed under <prefix>/share. ::: ##### 5 Соберите и установите всё ::: noteclassic Если устанавливаете с [Zabbix репозитория Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), сначала необходимо выполнить следующую команду: `$ make dbschema` ::: make install Этот шаг должен быть выполнен пользователем с достаточными правами (как правило «root», или с помощью `sudo`). Выполнение `make install` установит исполняемые файлы демонов (zabbix\_server, zabbix\_agentd, zabbix\_proxy) в /usr/local/sbin и исполняемые файлы клиентов (zabbix\_get, zabbix\_sender) в /usr/local/bin. ::: noteclassic Для установки в другое место, отличное от /usr/local, используйте ключ --prefix в предыдущем шаге конфигурирования исходных кодов, например --prefix=/home/zabbix. В этом случае исполняемые файлы демонов будут установлены в папку <префикс>/sbin, а утилиты в папку <префикс>/bin. Страницы помощи будут установлены в папку <префикс>/share. ::: # 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 Review server configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_600) to check if any changes in the configuration parameters are required. For new optional parameters, see the [What's new](/manual/introduction/whatsnew600) page. ##### 5 Проверка параметров конфигурации сервера Обязательно ознакомьтесь с [Заметками по обновлению](/manual/installation/upgrade_notes_600), чтобы проверить, не требуются ли какие-то изменения в параметрах конфигурации. Новые необязательные параметры можно найти на странице [Что нового](/manual/introduction/whatsnew600). ##### 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#start_new_zabbix_binaries). ##### 6 Запустите новый Zabbix прокси Запустите прокси. Проверьте файлы журналов, чтобы удостовериться, что прокси запустился успешно. Zabbix прокси автоматически обновит базу данных. Обновление базы данных выполняется аналогично запуску [Zabbix сервера](/manual/installation/upgrade/sources#запустите-новые-бинарные-файлы-zabbix). # 5 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| | |[Foreach functions](/manual/appendix/functions/aggregate/foreach)|avg\_foreach, bucket\_rate\_foreach, count\_foreach, exists\_foreach, last\_foreach, max\_foreach, min\_foreach, sum\_foreach| |[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). Foreach functions are supported only for [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate). # 5. Поддерживаемые функции Выберите соответствующую группу функций для просмотра подробностей. |Группа функций|<|Функции| |-|----------|----------------------------------------| |[Функции агрегации](/manual/appendix/functions/aggregate)|<|avg, bucket\_percentile, count, histogram\_quantile, item\_count, kurtosis, mad, max, min, skewness, stddevpop, stddevsamp, sum, sumofsquares, varpop, varsamp| | |[Функции цикла (foreach)](/manual/appendix/functions/aggregate/foreach)|avg\_foreach, bucket\_rate\_foreach, count\_foreach, exists\_foreach, last\_foreach, max\_foreach, min\_foreach, sum\_foreach| |[Побитовые функции](/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). Функции цикла поддерживаются только для [агрегированных вычислений](/manual/config/items/itemtypes/calculated/aggregate). # 5 TimescaleDB setup # 5. Настройка TimescaleDB # 5 Trend functions Trend functions, in contrast to [history functions](/manual/appendix/functions/history), use [trend](/manual/config/items/history_and_trends#keeping-trends) data for calculations. Trends store hourly aggregate values. Trend functions use these hourly averages, and thus are useful for long-term analysis. Trend function results are cached so multiple calls to the same function with the same parameters fetch info from the database only once. The trend function cache is controlled by the [TrendFunctionCacheSize](/manual/appendix/config/zabbix_server) server parameter. Triggers that reference trend functions **only** are evaluated once per the smallest time period in the expression. For instance, a trigger like trendavg(/host/key,1d:now/d) > 1 or trendavg(/host/key2,1w:now/w) > 2 will be evaluated once per day. If the trigger contains both trend and history (or [date and time](/manual/appendix/functions/time) and/or nodata()) functions, it is calculated in accordance with the [usual principles](/manual/config/triggers#calculation-time). 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 `time period:time shift` parameters must never be quoted # 5. Функции динамики изменений Функции динамики изменений, в отличие от [функций истории](/manual/appendix/functions/history), используют для вычислений данные [динамики изменений](/manual/config/items/history_and_trends#хранение-динамики-изменений). Динамика изменений сохраняется в виде агрегированных за час значений. Функции динамики изменений используют эти усреднённые за час значения, и, таким образом, полезны для долгосрочного анализа. Результаты функций динамики изменений кэшируются, поэтому несколько вызовов той же функции с теми же параметрами извлекут информацию из базы данных только однократно. Кэш функций динамики изменений управляется параметром сервера [TrendFunctionCacheSize](/manual/appendix/config/zabbix_server). Триггеры, которые ссылаются **только** на функции динамики изменений, пересчитываются один раз за наименьший период времени в выражении. Например, такой триггер: trendavg(/узел_сети/ключ,1d:now/d) > 1 or trendavg(/узел_сети/ключ2,1w:now/w) > 2 будет пересчитываться раз в сутки. Если триггер содержит как функции динамики изменений, так и функции истории (либо функции [даты и времени](/manual/appendix/functions/time) и/или nodata()), то он пересчитывается в соответствии с [обычными принципами](/manual/config/triggers#время-вычисления). Все перечисленные здесь функции поддерживаются в: - [выражениях триггера](/manual/config/triggers/expression) - [вычисляемых элементах данных](/manual/config/items/itemtypes/calculated) Некоторые общие замечания о параметрах функций: - параметры функций разделяются запятыми - необязательные параметры функций (или части параметров) обозначаются угловыми скобками `<` `>` - параметры, специфичные для функций, описываются с каждой функцией - параметры `/узел_сети/ключ` и `период_времени:сдвиг_времени` никогда не должны заключаться в кавычки ##### 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 Обновление Zabbix агента 2 командой `apt install zabbix-agent2` может привести к ошибке. Для более подробной информации, смотрите [*Известные проблемы*](/manual/installation/known_issues#обновление-zabbix-агента-2-6.0.5-или-более-старого). ::: Вы можете увидеть запрос о конфигурации 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 и перезапуска Apache также выполните: apt install zabbix-apache-conf systemctl restart apache2 Дистрибутивы **до Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster)** не предоставляют PHP 7.2 или более новые версии, который требуется веб-интерфейсу Zabbix 6.0. Смотрите [информацию](/manual/installation/frontend/frontend_on_debian) касательно установки веб-интерфейса Zabbix на устаревшие дистрибутивы. ##### 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 Обновление Zabbix агента 2 командой `dnf install zabbix-agent2` может вызвать ошибку. Для дополнительной информации, смотрите [*Известные проблемы*](/manual/installation/known_issues#обновление-zabbix-агента-2-6.0.5-или-более-старого). ::: Затем для корректного обновления веб-интерфейса Apache и перезапуска Apache также выполните: 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_centos#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 **на RHEL 8** также выполните: # yum install zabbix-apache-conf и внесите необходимые [изменения](/manual/installation/install_from_packages/rhel_centos#настройка_веб_интерфейса_zabbix) в этот файл. Для обновления веб-интерфейса **на RHEL 7** следуйте [инструкции для конкретного дистрибутива](/manual/installation/frontend/frontend_on_rhel7) (понадобятся дополнительные шаги по установке PHP 7.2 или более нового). # 5 User parameters # 5. Пользовательские параметры # 5 User roles # 5. Роли пользователей # 5 Web scenarios # 5. Веб-сценарии # 5 Web scenarios # 5. Веб-сценарии # 5 What's new in Zabbix 6.0.0 ::: noteimportant Zabbix 6.0.0 is not released yet. ::: # 5 Что нового в Zabbix 6.0.0 ::: noteimportant Zabbix 6.0.0 ещё не выпущен. ::: # 5 What's new in Zabbix 6.0.0 See [breaking changes](#breaking_changes) for this version. # 5. Что нового в Zabbix 6.0.0 Смотрите [критические изменения](#breaking_changes) для этой версии. # 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-битный Откройте MinGW среду (командную строку Windows) и перейдите к директории *build/mingw* в дереве исходного кода Zabbix. Выполните: mingw32-make clean mingw32-make PCRE=c:\dev\pcre OPENSSL=c:\dev\openssl ::: noteclassic На 64-битной платформе можно собрать 32-битные и 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 и т.д. Различные системы/устройства и проверки могут возвращать в значениях non-ASCII символы. Для таких случаев, почти все доступные в Zabbix ключи имеют дополнительный параметр ключа элемента данных — **<кодировка>**. Этот параметр ключа необязателен, но он должен быть указан, если получаемое значение не в кодировке UTF8 и содержит non-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 Mathematical functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) Mathematical functions are supported with float and integer value types, unless stated otherwise. 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**| |**abs** (value)|<|<| |The absolute value (from 0) of a value.|**value** - value to check|For example, the absolute value of either '3' or '-3' will be '3'.<br><br>Example:<br>=> **abs**(last(/host/key))>10| |**acos** (value)|<|<| |The arccosine of a value as an angle, expressed in radians.|**value** - value to check|The value must be between -1 and 1.<br><br>For example, the arccosine of a value '0.5' will be '2.0943951'.<br><br>Example:<br>=> **acos**(last(/host/key))| |**asin** (value)|<|<| |The arcsine of a value as an angle, expressed in radians.|**value** - value to check|The value must be between -1 and 1.<br><br>For example, the arcsine of a value '0.5' will be '-0.523598776'.<br><br>Example:<br>=> **asin**(last(/host/key))| |**atan** (value)|<|<| |The arctangent of a value as an angle, expressed in radians.|**value** - value to check|For example, the arctangent of a value '1' will be '0.785398163'.<br><br>Example:<br>=> **atan**(last(/host/key))| |**atan2** (value,abscissa)|<|<| |The arctangent of the ordinate (value) and abscissa coordinates specified as an angle, expressed in radians.|**value** - value to check<br>**abscissa** - abscissa value|For example, the arctangent of the ordinate and abscissa coordinates of a value '1' will be '2.21429744'.<br><br>Example:<br>=> **atan2**(last(/host/key),2)| |**avg** (<value1>,<value2>,...)|<|<| |Average value of the referenced item values.|**valueX** - value returned by another function that is working with item history|Example:<br>=> **avg**(avg(/host/key),avg(/host2/key2))| |**cbrt** (value)|<|<| |Cube root of a value.|**value** - value to check|For example, the cube root of '64' will be '4', of '63' will be '3.97905721'.<br><br>Example:<br>=> **cbrt**(last(/host/key))| |**ceil (value)**|<|<| |Round the value up to the nearest greater or equal integer.|**value** - value to check|For example, '2.4' will be rounded up to '3'.<br><br>Example:<br>=> **ceil**(last(/host/key))<br><br>See also floor().| |**cos (value)**|<|<| |The cosine of a value, where the value is an angle expressed in radians.|**value** - value to check|For example, the cosine of a value '1' will be '0.54030230586'.<br><br>Example:<br>=> **cos**(last(/host/key))| |**cosh (value)**|<|<| |The hyperbolic cosine of a value.|**value** - value to check|For example, the hyperbolic cosine of a value '1' will be '1.54308063482'.<br><br>Returns value as a real number, not as scientific notation.<br><br>Example:<br>=> **cosh**(last(/host/key))| |**cot (value)**|<|<| |The cotangent of a value, where the value is an angle, expressed in radians.|**value** - value to check|For example, the cotangent of a value '1' will be '0.54030230586'.<br><br>Example:<br>=> **cot**(last(/host/key))| |**degrees (value)**|<|<| |Converts a value from radians to degrees.|**value** - value to check|For example, a value '1' converted to degrees will be '57.2957795'.<br><br>Example:<br>=> **degrees**(last(/host/key))| |**e**|<|<| |Euler's number (2.718281828459045).|<|Example:<br>=> **e**()| |**exp** (value)|<|<| |Euler's number at a power of a value.|**value** - value to check|For example, Euler's number at a power of a value '2' will be '7.38905609893065'.<br><br>Example:<br>=> **exp**(last(/host/key))| |**expm1 (value)**|<|<| |Euler's number at a power of a value minus 1.|**value** - value to check|For example, Euler's number at a power of a value '2' minus 1 will be '6.38905609893065'.<br><br>Example:<br>=> **expm1**(last(/host/key))| |**floor** (value)|<|<| |Round the value down to the nearest smaller or equal integer.|**value** - value to check|For example, '2.6' will be rounded down to '2'.<br><br>Example:<br>=> **floor**(last(/host/key))<br><br>See also ceil().| |**log** (value)|<|<| |Natural logarithm.|**value** - value to check|For example, the natural logarithm of a value '2' will be '0.69314718055994529'.<br><br>Example:<br>=> **log**(last(/host/key))| |**log10** (value)|<|<| |Decimal logarithm.|**value** - value to check|For example, the decimal logarithm of a value '5' will be '0.69897000433'.<br><br>Example:<br>=> **log10**(last(/host/key))| |**max** (<value1>,<value2>,...)|<|<| |Highest value of the referenced item values.|**valueX** - value returned by another function that is working with item history|Example:<br>=> **max**(avg(/host/key),avg(/host2/key2))| |**min** (<value1>,<value2>,...)|<|<| |Lowest value of the referenced item values.|**valueX** - value returned by another function that is working with item history|Example:<br>=> **min**(avg(/host/key),avg(/host2/key2))| |**mod** (value,denominator)|<|<| |Division remainder.|**value** - value to check<br>**denominator** - division denominator|For example, division remainder of a value '5' with division denominator '2' will be '1'.<br><br>Example:<br>=> **mod**(last(/host/key),2)| |**pi**|<|<| |Pi constant (3.14159265358979).|<|Example:<br>=> **pi**()| |**power** (value,power value)|<|<| |The power of a value.|**value** - value to check<br>**power value** - the Nth power to use|For example, the 3rd power of a value '2' will be '8'.<br><br>Example:<br>=> **power**(last(/host/key),3)| |**radians** (value)|<|<| |Convert a value from degrees to radians.|**value** - value to check|For example, a value '1' converted to radians will be '0.0174532925'.<br><br>Example:<br>=> **radians**(last(/host/key))| |**rand**|<|<| |Return a random integer value.| |A pseudo-random generated number using time as seed (enough for mathematical purposes, but not cryptography).<br><br>Example:<br>=> **rand**()| |**round** (value,decimal places)|<|<| |Round the value to decimal places.|**value** - value to check<br>**decimal places** - specify decimal places for rounding (0 is also possible)|For example, a value '2.5482' rounded to 2 decimal places will be '2.55'.<br><br>Example:<br>=> **round**(last(/host/key),2)| |**signum** (value)|<|<| |Returns '-1' if a value is negative, '0' if a value is zero, '1' if a value is positive.|**value** - value to check|Example:<br>=> **signum**(last(/host/key))| |**sin** (value)|<|<| |The sine of a value, where the value is an angle expressed in radians.|**value** - value to check|For example, the sine of a value '1' will be '0.8414709848'.<br><br>Example:<br>=> **sin**(last(/host/key))| |**sinh** (value)|<|<| |The hyperbolical sine of a value.|**value** - value to check|For example, the hyperbolical sine of a value '1' will be '1.17520119364'.<br><br>Example:<br>=> **sinh**(last(/host/key))| |**sqrt** (value)|<|<| |Square root of a value.|**value** - value to check|This function will fail with a negative value.<br><br>For example, the square root of a value '3.5' will be '1.87082869339'.<br><br>Example:<br>=> **sqrt**(last(/host/key))| |**sum** (<value1>,<value2>,...)|<|<| |Sum of the referenced item values.|**valueX** - value returned by another function that is working with item history|Example:<br>=> **sum**(avg(/host/key),avg(/host2/key2))| |**tan** (value)|<|<| |The tangent of a value.|**value** - value to check|For example, the tangent of a value '1' will be '1.55740772465'.<br><br>Example:<br>=> **tan**(last(/host/key))| |**truncate** (value,decimal places)|<|<| |Truncate the value to decimal places.|**value** - value to check<br>**decimal places** - specify decimal places for truncating (0 is also possible)|Example:<br>=> **truncate**(last(/host/key),2)| # 6. Математические функции Все перечисленные здесь функции поддерживаются в: - [выражениях триггера](/manual/config/triggers/expression) - [вычисляемых элементах данных](/manual/config/items/itemtypes/calculated) Математические функции поддерживаются с дробными и целочисленными типами значений, если не оговорено иначе. Некоторые общие замечания о параметрах функций: - параметры функций разделяются запятыми - в качестве параметров допустимы выражения - необязательные параметры функций (или части параметров) обозначаются угловыми скобками `<` `>` |ФУНКЦИЯ|<|<| |--|--|--| |**Описание**|**Параметры, специфичные для функции**|**Комментарии**| |**abs** (значение)|<|<| |Абсолютное значение (по модулю) значения.|**значение** — проверяемое значение|Например, абсолютное значение как «3», так и «-3» будет «3».<br><br>Пример:<br>=> **abs**(last(/узел_сети/ключ))>10| |**acos** (значение)|<|<| |Арккосинус значения как угол, выраженный в радианах.|**значение** — проверяемое значение|Значение должно быть в диапазоне от -1 до 1.<br><br>Например, арккосинус значения «0.5» будет «2.0943951».<br><br>Пример:<br>=> **acos**(last(/узел_сети/ключ))| |**asin** (значение)|<|<| |Арксинус значения как угол, выраженный в радианах.|**значение** — проверяемое значение|Значение должно быть в диапазоне от -1 до 1.<br><br>Например, арксинус значения «0.5» будет «-0.523598776».<br><br>Пример:<br>=> **asin**(last(/узел_сети/ключ))| |**atan** (значение)|<|<| |Арктангенс значения как угол, выраженный в радианах.|**значение** — проверяемое значение|Например, арктангенс значения «1» будет «0.785398163».<br><br>Пример:<br>=> **atan**(last(/узел_сети/ключ))| |**atan2** (значение,абсцисса)|<|<| |Арктангенс указанных координат ординаты (значение) и абсцисса как угол, выраженный в радианах.|**значение** — проверяемое значение<br>**абсцисса** — значение абсциссы|Например, арктангенс координат, где ордината и абсцисса имеют значение «1», будет «2.21429744».<br><br>Пример:<br>=> **atan2**(last(/узел_сети/ключ),2)| |**avg** (<значение1>,<значение2>,...)|<|<| |Среднее из значений, на которые ссылаются перечисленные элементы данных.|**значениеX** — значение, возвращаемое другой функцией, работающей с историей элементов данных|Пример:<br>=> **avg**(avg(/узел_сети/ключ),avg(/узел_сети2/ключ2))| |**cbrt** (значение)|<|<| |Кубический корень из значения.|**значение** — проверяемое значение|Например, кубический корень из «64» будет «4», а из «63» будет «3.97905721».<br><br>Пример:<br>=> **cbrt**(last(/узел_сети/ключ))| |**ceil (значение)**|<|<| |Округлить значение вверх до ближайшего целого.|**значение** — проверяемое значение|Например, «2.4» будет округлено до «3».<br><br>Пример:<br>=> **ceil**(last(/узел_сети/ключ))<br><br>Смотрите также floor().| |**cos (значение)**|<|<| |Косинус значения, где значение воспринимается как угол, выраженный в радианах.|**значение** — проверяемое значение|Например, косинус значения «1» будет «0.54030230586».<br><br>Пример:<br>=> **cos**(last(/узел_сети/ключ))| |**cosh (значение)**|<|<| |Гиперболический косинус значения.|**значение** — проверяемое значение|Например, гиберболический косинус значения «1» будет «1.54308063482».<br><br>Возвращает значение в виде действительного числа, а не в научном представлении.<br><br>Пример:<br>=> **cosh**(last(/узел_сети/ключ))| |**cot (значение)**|<|<| |Котангенс значения, где значение воспринимается как угол, выраженный в радианах.|**значение** — проверяемое значение|Например, котангенс значения «1» будет «0.54030230586».<br><br>Пример:<br>=> **cot**(last(/узел_сети/ключ))| |**degrees (значение)**|<|<| |Конвертация значения из радиан в градусы.|**значение** — проверяемое значение|Например, значение «1», сконвертированное в градусы, будет «57.2957795».<br><br>Пример:<br>=> **degrees**(last(/узел_сети/ключ))| |**e**|<|<| |Число Эйлера (2.718281828459045).|<|Пример:<br>=> **e**()| |**exp** (значение)|<|<| |Число Эйлера (e) в степени значения.|**значение** — проверяемое значение|Например, число Эйлера, возведённое в степень «2», будет «7.38905609893065».<br><br>Пример:<br>=> **exp**(last(/узел_сети/ключ))| |**expm1 (значение)**|<|<| |Число Эйлера (e) в степени значения, минус один.|**значение** — проверяемое значение|Например, число Эйлера, возведённое в степень «2», после вычитания единицы будет «6.38905609893065».<br><br>Пример:<br>=> **expm1**(last(/узел_сети/ключ))| |**floor** (значение)|<|<| |Округление вниз до ближайшего целого.|**значение** — проверяемое значение|Например, «2.6» будет округлено вниз до «2».<br><br>Пример:<br>=> **floor**(last(/узел_сети/ключ))<br><br>Смотрите также ceil().| |**log** (значение)|<|<| |Натуральный логарифм.|**значение** — проверяемое значение|Например, натуральный логарифм значения «2» будет «0.69314718055994529».<br><br>Пример:<br>=> **log**(last(/узел_сети/ключ))| |**log10** (значение)|<|<| |Десятичный логарифм.|**значение** — проверяемое значение|Например, десятичный логарифм значения «5» will be «0.69897000433».<br><br>Пример:<br>=> **log10**(last(/узел_сети/ключ))| |**max** (<значение1>,<значение2>,...)|<|<| |Наибольшее из значений, на которые ссылаются перечисленные элементы данных.|**значениеX** — значение, возвращаемое другой функцией, работающей с историей элементов данных|Пример:<br>=> **max**(avg(/узел_сети/ключ),avg(//узел_сети2/ключ2))| |**min** (<значение1>,<значение2>,...)|<|<| |Наименьшее из значений, на которые ссылаются перечисленные элементы данных.|**значениеX** — значение, возвращаемое другой функцией, работающей с историей элементов данных|Пример:<br>=> **min**(avg(/узел_сети/ключ),avg(/узел_сети2/ключ2))| |**mod** (значение,делитель)|<|<| |Остаток от деления.|**значение** — проверяемое значение<br>**делитель** — знаменатель деления|Например, остаток от деления значения «5» с делителем «2» будет «1».<br><br>Пример:<br>=> **mod**(last(/узел_сети/ключ),2)| |**pi**|<|<| |Константа пи (3.14159265358979).|<|Пример:<br>=> **pi**()| |**power** (значение,степень)|<|<| |Возведение в степень.|**значение** — проверяемое значение<br>**степень** — используемый показатель степени|Например, третья степень значения «2» будет «8».<br><br>Пример:<br>=> **power**(last(/узел_сети/ключ),3)| |**radians** (значение)|<|<| |Конвертация значения из градусов в радианы.|**значение** — проверяемое значение|Например, значение «1», сконвертированное в радианы, будет «0.0174532925».<br><br>Пример:<br>=> **radians**(last(/узел_сети/ключ))| |**rand**|<|<| |Вернуть случайное целое число.| |Псевдослучайное число, сгенерированное с использованием времени в качестве seed (достаточно для математичеких целей, но не для криптографии).<br><br>Пример:<br>=> **rand**()| |**round** (значение,дес_знаков)|<|<| |Округлить значение до десятичных знаков.|**значение** — проверяемое значение<br>**дес_знаков** — количество десятичных знаков для округления (0 также допустим)|Например, значение «2.5482», округлённое до 2 десятичных знаков, будет «2.55».<br><br>Пример:<br>=> **round**(last(/узел_сети/ключ),2)| |**signum** (значение)|<|<| |Возвращает «-1» для отрицательного значения, «0» для нуля, «1» для положительного значения.|**значение** — проверяемое значение|Пример:<br>=> **signum**(last(/узел_сети/ключ))| |**sin** (значение)|<|<| |Синус значения, воспринимаемого как угол, выраженный в радианах.|**значение** — проверяемое значение|Например, синус значения «1» будет «0.8414709848».<br><br>Пример:<br>=> **sin**(last(/узел_сети/ключ))| |**sinh** (значение)|<|<| |Гиперболический синус значения.|**значение** — проверяемое значение|Например, гиперболический синус значения «1» будет «1.17520119364».<br><br>Пример:<br>=> **sinh**(last(/узел_сети/ключ))| |**sqrt** (значение)|<|<| |Квадратный корень значения.|**значение** — проверяемое значение|Эта функция выдаст ошибку для отрицательного значения.<br><br>Например, квадратный корень из значения «3.5» will be «1.87082869339».<br><br>Пример:<br>=> **sqrt**(last(/узел_сети/ключ))| |**sum** (<значение1>,<значение2>,...)|<|<| |Сумма значений, на которые ссылаются перечисленные элементы данных.|**значениеX** — значение, возвращаемое другой функцией, работающей с историей элементов данных|Пример:<br>=> **sum**(avg(/узел_сети/ключ),avg(/узел_сети2/ключ2))| |**tan** (значение)|<|<| |Тангенс значения.|**значение** — проверяемое значение|Например, тангенс значения «1» будет «1.55740772465».<br><br>Пример:<br>=> **tan**(last(/узел_сети/ключ))| |**truncate** (значение,дес_знаков)|<|<| |Усечение значения до указанного числа десятичных знаков.|**значение** — проверяемое значение<br>**дес_знаков** — количество десятичных знаков, оставляемых после усечения (0 также допустим)|Пример:<br>=> **truncate**(last(/узел_сети/ключ),2)| # 6 MongoDB plugin # 6. Плагин MongoDB # 6 New template # 6. Новый шаблон # 6 ODBC template operation Steps to ensure correct operation of templates that collect metrics via [ODBC monitoring](/manual/config/items/itemtypes/odbc_checks): 1. Make sure that required ODBC driver is installed on Zabbix server or proxy. 2. [Link](/manual/config/templates/linking#linking-a-template) the template to a target host (if the template is not available in your Zabbix installation, you may need to import the template's .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions). 3. If necessary, adjust the values of template macros. 4. Configure the instance being monitored to allow data sharing with Zabbix. A detailed description of a template, including the full list of macros, items, and triggers, is available in the template's README file (accessible by clicking on a template name). The following templates are available: - [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MySQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Oracle by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [PostgreSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 6. Работа с ODBC шаблонами Шаги для гарантии корректной работы шаблонов, которые собирают метрики через [ODBC мониторинг](/manual/config/items/itemtypes/odbc_checks): 1. Убедитесь, что требуемый ODBC драйвер установлен на Zabbix сервере или прокси. 2. [Присоедините](/manual/config/templates/linking#присоединение-шаблона) шаблон к нужному узлу сети (если шаблон недоступен в вашей инсталляции Zabbix, вам может потребоваться сначала импортировать файл .yaml шаблона — смотрите инструкции в разделе [Готовые шаблоны](/manual/config/templates_out_of_the_box)). 3. При необходимости измените значения макросов шаблона. 4. Настройте экземпляр для мониторинга так, чтобы был разрешён обмен данными с Zabbix. Подробное описание шаблона, включая полный список макросов, элементов данных и триггеров, доступно в файле README \[en\] шаблона (доступном при нажатии на имя шаблона). Доступны следующие шаблоны: - [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MySQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Oracle by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [PostgreSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 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. В файле вы должны указать **IP адрес** Zabbix сервера. Подключения с остальных хостов будут отклонены. - отредактируйте файл конфигурации Zabbix сервера **/usr/local/etc/zabbix\_server.conf** Вы должны указать имя базы данных, пользователя и пароль (если используется). Остальные параметры подойдут со значениями по умолчанию, если у вас небольшая инсталляция (до десятка наблюдаемых узлов сети). Вы должны изменить параметры по умолчанию, если вы хотите увеличить производительность Zabbix сервера (или прокси). Обратитесь к разделу [Оптимизация производительности](/manual/appendix/performance_tuning) для получения подробных сведений. - если вы установили Zabbix прокси, то отредактируйте файл конфигурации Zabbix прокси **/usr/local/etc/zabbix\_proxy.conf** Вы должны указать IP адрес сервера и имя прокси (должно быть известно серверу), а также имя базы данных, пользователя и пароль (если используется). ::: noteclassic В случае в SQLite необходимо указать полный путь к файлу базы данных; пользователь и пароль к БД не требуются. ::: ##### 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#параметры_конфигурации). # 6 Sender # 6. 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 сервера. Когда обновление завершится, в файл журнала запишется сообщение: "database upgrade fully completed". В случае сбоя какого-либо из патчей обновления Zabbix сервер не запустится. Zabbix сервер также не запустится, если текущая обязательная версия более новая, чем требуемая. Zabbix сервер запустится только, если текущая обязательная версия базы данных соответствует требуемой обязательной версии. 8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000 8673:20161117:104750.259 required mandatory version: 03040000 До запуска сервера: - Убедитесь, что пользователь базы данных имеет достаточно прав (create table, drop table, create index, drop index). - Убедитесь что у вас достаточно свободного дискового пространства. # 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. Установка веб-интерфейса Данные раздел приводит пошаговую инструкцию по установке веб-интерфейса Zabbix. Веб-интерфейс Zabbix написан на PHP, в связи с чем для его запуска необходим веб-сервер с поддержкой PHP. # 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 Геокарта # 7 Geomap # 7 Geomap # 7 Get # 7. 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 Установите новый веб-интерфейс Zabbix Минимально требуемая версия 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** (значение,мин,макс)|<|<| |Проверка того, попадает ли значение в заданный диапазон.|**значение** — проверяемое значение<br>**мин** — минимальное значение<br>**макс** — максимальное значение|Поддерживаемые типы значений: integer, float<br><br>Возвращает:<br>1 — в диапазоне<br>0 — в противном случае<br><br>Пример:<br>=> **between**(last(/узел_сети/ключ),**1**,**10**)=1 — триггер сработает, если значение в пределах от 1 до 10.| |**in** (значение,значение1,значение2,...значениеN)|<|<| |Проверка того, что значение равно хотя бы какому-нибудь из перечисленных значений.|**значение** — проверяемое значение<br>**значение1,значение2,...значениеN** — перечисленные значения (строковые значения должны быть в двойных кавычках)|Поддерживаемые типы значений: все<br><br>Возвращает:<br>1 — если равно<br>0 — в противном случае<br><br>Значение сравнивается с перечисленными значениями как число, если все эти значения могут быть преобразованы в число; в противном случае сравнивается как строка.<br><br>Пример:<br>=> **in**(last(/узел_сети/ключ),**5**,**10**)=1 — триггер сработает, если последнее значение равно либо 5, либо 10<br>=> **in**(**"text"**, last(/узел_сети/ключ),last(/узел_сети/ключ,\#2))=1 — триггер сработает, если любое из двух последних значений равно «text».| # 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 с новой строкой в качестве разделителя для: - [триггерных событий](#триггерные-события) - [значений элементов данных](#значения-элементов-данных) - [динамики изменений](#динамика-изменений) Все файлы имеют расширение .ndjson. Каждая строка файла экспорта является объектом JSON. # 7 Services # 7 Услуги # 7 Standardized templates for network devices # 7. Унифицированные шаблоны для сетевых устройств ##### 7 Start up the daemons Run zabbix\_server on the server side. zabbix_server ::: noteclassic Make sure that your system allows allocation of 36MB (or a bit more) of shared memory, otherwise the server may not start and you will see "Cannot allocate shared memory for <type of cache>." in the server log file. This may happen on FreeBSD, Solaris 8. ::: Run zabbix\_agentd on all the monitored machines. zabbix_agentd ::: noteclassic Make sure that your system allows allocation of 2MB of shared memory, otherwise the agent may not start and you will see "Cannot allocate shared memory for collector." in the agent log file. This may happen on Solaris 8. ::: If you have installed Zabbix proxy, run zabbix\_proxy. zabbix_proxy ##### 7 Запустите демоны Запустите zabbix\_server на стороне сервера. zabbix_server ::: noteclassic Удостоверьтесь, что в вашей системе разрешено выделение 36МБ (или немногим больше) разделяемой памяти, в противном случае сервер может не запуститься и вы увидите "Cannot allocate shared memory for <type of cache>." в файле журнала сервера. Такое может случится в FreeBSD, Solaris 8. ::: Запустите zabbix\_agentd на всех наблюдаемых машинах. zabbix_agentd ::: noteclassic Убедитесь, что ваша система позволяет выделить 2 МБ разделяемой памяти (shared memory), в противном случае агент может не запуститься и вы увидите сообщение “Cannot allocate shared memory for collector.” в журнале агента. Такое может произойти в Solaris 8. ::: Если вы установили Zabbix прокси, запустите zabbix\_proxy. zabbix_proxy ##### 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 # 7. Процедура обновления [comment]: # (tags: upgrade) # 7 Upgrade procedure # 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. Очистите cookies и кэш в веб-браузере После обновления вам, возможно, потребуется очистить cookies веб-браузера и кэш веб-браузера, чтобы веб-интерфейс 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. Очистите cookies и кэш в веб-браузере После обновления вам, возможно, потребуется очистить cookies веб-браузера и кэш веб-браузера, чтобы веб-интерфейс 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 Очистите cookies и кэш в веб-браузере После обновления вам, возможно, потребуется очистить cookies веб-браузера и кэш веб-браузера, чтобы веб-интерфейс 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 Очистите cookies и кэш в веб-браузере После обновления вам, возможно, потребуется очистить cookies веб-браузера и кэш веб-браузера, чтобы веб-интерфейс Zabbix работал должным образом. # 8 Creating your own theme # 8. Создание своей собственной темы # 8 Discovery of Windows services # 8. Обнаружение служб Windows # 8 Distribution-specific notes on setting up Nginx for Zabbix # 8. Примечания по настройке Nginx для Zabbix на различных дистрибутивах # 8 Graph # 8. График # 8 Graph # 8 График # 8 JS # 8. 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) Некоторые общие замечания о параметрах функций: - параметры функций разделяются запятыми - необязательные параметры функций (или части параметров) обозначаются угловыми скобками `<` `>` - параметры, специфичные для функций, описываются с каждой функцией - параметры `/узел_сети/ключ` и `(сек|#число)<:сдвиг_времени>` никогда не должны заключаться в кавычки # 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 для невиртуальных устройств. Файл с именем name, расположенный в папках hwmon\* или hwmon\*/device, содержит имя чипа, которое соответствует имени используемого контроллером драйвера ядра. В каждом файле имеется только одно значение показания датчика. Общая схема именования файлов, которые содержат показания датчиков, внутри любой из вышеупомянутых папок: <тип><номер>\_<элемент>, где - **тип** — для чипов датчиков это "in" (напряжение), "temp" (температура), "fan" (скорость вентилятора) и т.д., - **элемент** — "input" (измеренное значение), "max" (верхний порог), "min" (нижний порог) и т.д., - **номер** — всегда используется для экземпляров, которые могут присутствовать более одного раза (обычно начинается с 1, за исключением датчиков напряжения, которые начинаются с 0). Если файлы не относятся к конкретным экземплярам, они имеют простое наименование без номера. Информацию о датчиках, доступных на хосте, можно получить с помощью инструментов **sensor-detect** и **sensors** (пакет lm-sensors: <http://lm-sensors.org/>). **Sensors-detect** помогает определить, какие модули необходимы для доступных датчиков. Когда модули загружены, можно использовать утилиту **sensors**, чтобы показать значения со всех контроллеров. Маркировка значений датчиков, используемая данной утилитой, может отличаться от общепринятой схемы именования (<тип><номер>\_<элемент>): - если имеется файл с именем <тип><номер>\_метка, то метка внутри этого файла будет использоваться вместо имени <тип><номер>\_<элемент>; - если файл <тип><номер>\_метка отсутствует, то утилита выполняет поиск внутри /etc/sensors.conf (также может быть /etc/sensors3.conf или другой) для подстановки имени. Эта маркировка позволяет пользователю определить тип используемого оборудования. Если нет ни файла <тип><номер>\_метка, ни метки внутри файла конфигурации, то тип оборудования может быть определён по атрибуту name (hwmon\*/device/name). Реальные имена датчиков, которые воспринимает zabbix\_agent, можно получить, запустив утилиту **sensors** с параметром «-u» (**sensors -u**). В утилите **sensor** доступные датчики разделены по типу шины (ISA adapter, PCI adapter, SPI adapter, Virtual device, ACPI interface, HID adapter). # 8. Service monitoring # 8. Мониторинг услуг # 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 gateway Если вы используете скрипты `startup.sh` и `shutdown.sh` для запуска [Zabbix Java gateway](/manual/concepts/java), вы можете указать необходимые параметры конфигурации в файле`settings.sh`. Скрипты запуска и остановки считывают содержимое файла настроек и заботятся о конвертации переменных оболочки (shell variables, приведены в первом столбце) в свойства Java (Java properties, приведены во втором столбце). Если вы запускаете Zabbix Java gateway вручную, непосредственно с помощью `java`, тогда вы указываете соответствующие свойства Java в командной строке. |Переменная|Свойство|Обязательный|Диапазон|По умолчанию|Описание| |--------|--------|---------|-----|-------|-----------| |LISTEN\_IP|zabbix.listenIP|нет| |0.0.0.0|IP адрес, который слушает Zabbix Java Gateway.| |LISTEN\_PORT|zabbix.listenPort|нет|1024-32767|10052|Порт, который слушает Zabbix Java Gateway.| |PID\_FILE|zabbix.pidFile|нет| |/tmp/zabbix\_java.pid|Имя PID файла. Если не задано, Zabbix Java Gateway запустится как консольное приложение.| |PROPERTIES\_FILE|zabbix.propertiesFile|нет| | |Имя файла свойств. Может использоваться, чтобы задать дополнительные свойства, используя формат ключ-значение, таким образом, что они не будут видимы в командной строке или перезапишут существующие свойства.<br>Например: "javax.net.ssl.trustStorePassword=<пароль>"| |START\_POLLERS|zabbix.startPollers|нет|1-1000|5|Количество запускаемых рабочих потоков.| |TIMEOUT|zabbix.timeout|нет|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 График (классический) # 9 MySQL plugin [comment]: # (tags: mysql) # 9. Плагин MySQL [comment]: # (tags: mysql) # 9 Notes on memtype parameter in proc.mem items # 9. Заметки о параметре «тип памяти» в элементах данных proc.mem # 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**, файл службы systemd для Zabbix агента в [официальных пакетах](https://www.zabbix.com/download) явно включает директивы `User` и `Group`. Обе директивы задают значение `zabbix`. Настроить через файл `zabbix_agentd.conf`, от имени какого пользователя запускается агент Zabbix, более невозможно, так как агент пропускает эту настройку и работает как пользователь, указанный в файле службы systemd. Чтобы запустить агента 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** (значение)|<|<| |Код ASCII самого левого символа значения.|**значение** — проверяемое значение|Поддерживаемые типы значений: string, text, log<br><br>Например, значение «Abc» вернёт «65» (код ASCII для буквы «A»).<br><br>Пример:<br>=> **ascii**(last(/узел_сети/ключ))| |**bitlength** (значение)|<|<| |Длина значения в битах.|**значение** —- проверяемое значение|Поддерживаемые типы значений: string, text, log, integer<br><br>Пример:<br>=> **bitlength**(last(/узел_сети/ключ))| |**bytelength** (значение)|<|<| |Длина значения в байтах.|**значение** — проверяемое значение|Поддерживаемые типы значений: string, text, log, integer<br><br>Пример:<br>=> **bytelength**(last(/узел_сети/ключ))| |**char** (значение)|<|<| |Вернуть символ, интерпретируя значение как код ASCII.|**значение** — проверяемое значение|Поддерживаемые типы значений: integer<br><br>Значение должно быть в диапазоне 0-255. Например, значение «65» (интерпретируемое как код ASCII) вернёт «A».<br><br>Пример:<br>=> **char**(last(/узел_сети/ключ))| |**concat** (<значение1>,<значение2>,...)|<|<| |Строка, получаемая в результате конкатенации упоминаемых значений элементов данных либо констант. |**значение** — значение, возвращаемое одной из функций истории, либо константа (string, integer или float number)|Поддерживаемые типы значений: string, text, log, float, integer <br><br>Например, значение вроде «Zab», объединённое с «bix» (строки-константы), вернёт «Zabbix». <br><br>Должно содержать минимум два параметра. <br><br>Пример:<br>=> **concat**(last(/узел_сети/ключ),**"bix"**)<br>=> **concat**("1 min: ",last(/узел_сети/system.cpu.load[all,avg1]),", 15 min: ",last(/узел_сети/system.cpu.load[all,avg15])) | |**insert** (значение,старт,длина,замена)|<|<| |Вставить указанные символы или пробелы в символьную строку, начиная с указанной позиции в строке.|**значение** — проверяемое значение<br>**старт** — начальная позиция<br>**длина** — заменяемых позиций<br>**замена** — подставляемая строка|Поддерживаемые типы значений: string, text, log<br><br>Например, значение вроде «Zabbbix» будет заменено на «Zabbix», если «bb» (начиная с позиции 3, заменяемых позиций 2) заменяется строкой «b».<br><br>Пример:<br>=> **insert**(last(/узел_сети/ключ),**3**,**2**,**"b"**)| |**left** (значение,кол-во)|<|<| |Самые левые символы значения.|**значение** — проверяемое значение<br>**кол-во** — количество возвращаемых символов|Поддерживаемые типы значений: string, text, log<br><br>Например, можно вернуть «Zab» из «Zabbix», указывая для возврата 3 крайних слева символа.<br><br>Пример:<br>=> **left**(last(/узел_сети/ключ),**3**) — возвращает три самых левых символа<br><br>Смотрите также right().| |**length** (значение)|<|<| |Длина значения в символах.|**значение** — проверяемое значение|Поддерживаемые типы значений: str, text, log<br><br>Пример:<br>=> **length**(last(/узел_сети/ключ)) → длина последнего значения<br>=> **length**(last(/узел_сети/ключ,\#3)) → длина третьего из последних значения<br>=> **length**(last(/узел_сети/ключ,\#1:now-1d)) → длина самого свежего сутки назад значения| |**ltrim** (значение,<символы>)|<|<| |Удалить указанные символы с начала строки.|**значение** — проверяемое значение<br>**символы** — (опционально) укажите удаляемые символы<br><br>По умолчанию удаляются пробелы (если не указано опциональных символов).|Поддерживаемые типы значений: string, text, log<br><br>Пример:<br>=> **ltrim**(last(/узел_сети/ключ)) — удалить пробелы с начала строки<br>=> **ltrim**(last(/узел_сети/ключ),**"Z"**) — удалить любые символы «Z» с начала строки<br>=> **ltrim**(last(/узел_сети/ключ),**" Z"**) — удалить пробелы и символы «Z» с начала строки<br><br>Смотрите также: rtrim(), trim()| |**mid** (значение,старт,длина)|<|<| |Вернуть подстроку из N символов, начиная с символьной позиции, указанной параметром «старт».|**значение** — проверяемое значение<br>**старт** — начальная позиция подстроки<br>**длина** — количество позиций подстроки, которые нужно вернуть|Поддерживаемые типы значений: string, text, log<br><br>Например, можно вернуть подстроку «abbi» из значения «Zabbix», если указать начальную позицию 2, а длину 4.<br><br>Пример:<br>=> **mid**(last(/узел_сети/ключ),**2**,**4**)="abbi"| |**repeat** (значение,кол-во)|<|<| |Повторить строку.|**значение** — проверяемое значение<br>**кол-во** — количество повторений|Поддерживаемые типы значений: string, text, log<br><br>Пример:<br>=> **repeat**(last(/узел_сети/ключ),**2**) — повторить значение дважды| |**replace** (значение,образец,замена)|<|<| |Найти в значении образец и заменить его заменой. Будут заменены все вхождения образца.|**значение** — проверяемое значение<br>**образец** — искомый образец<br>**замена** — строка, которой заменяется образец|Поддерживаемые типы значений: string, text, log<br><br>Пример:<br>=> **replace**(last(/узел_сети/ключ),**"ibb"**,**"abb"**) — заменить все «ibb» на «abb»| |**right** (значение,кол-во)|<|<| |Самые правые символы значения.|**значение** — проверяемое значение<br>**кол-во** — количество возвращаемых символов|Поддерживаемые типы значений: string, text, log<br><br>Например, можно вернуть «bix» из «Zabbix», если указать возвращать 3 символа справа.<br><br>Пример:<br>=> **right**(last(/узел_сети/ключ),**3**) — вернуть три символа справа<br><br>Смотрите также left().| |**rtrim** (значение,<символы>)|<|<| |Удалить указанные символы с конца строки.|**значение** — проверяемое значение<br>**символы** — (опционально) укажите удаляемые символы<br><br>По умолчанию удаляются пробелы (если не указано опциональных символов).|Поддерживаемые типы значений: string, text, log<br><br>Пример:<br>=> **rtrim**(last(/узел_сети/ключ)) — удалить пробелы с конца строки<br>=> **rtrim**(last(/узел_сети/ключ),**"x"**) — удалить любые символы «x» с конца строки<br>=> **rtrim**(last(/узел_сети/ключ),**"x "**) — удалить любые символы «x» или пробелы с конца строки<br><br>Смотрите также: ltrim(), trim()| |**trim** (значение,<символы>)|<|<| |Удалить указанные символы с начала и конца строки.|**значение** — проверяемое значение<br>**символы** — (опционально) укажите удаляемые символы<br><br>По умолчанию удаляются пробелы (если не указано опциональных символов).|Поддерживаемые типы значений: string, text, log<br><br>Пример:<br>=> **trim**(last(/узел_сети/ключ)) — удалить пробелы с начала и конца строки<br>=> **trim**(last(/узел_сети/ключ),**"\_"**) — удалить «\_» с начала и конца строки<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. Веб-мониторинг # 9 Web service # 9. Веб-сервис # 9 What's new in Zabbix 6.0.4 # 9. Что нового в Zabbix 6.0.4 # 9 Zabbix web service # 9. Zabbix веб-сервис #### 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. #### Отсутствие данных По элементам данных с регулярным интервалом обновления ничего не будет отображаться в случае, если данные элемента данных не собраны. Однако, по траппер элементам данных и элементам данных с интервалом обновления по расписанию (и обычным интервалом обновления, выставленным в значение 0), будет отрисовываться прямая линия, ведущая до первого собранного значения и от последнего собранного значения в конце графика; линия будет находиться на уровне первого/последнего значений соответственно. ### 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 #### Доступ к панелям узлов сети Доступ к панелям узлов сети можно получить: - из [меню узла сети](/manual/web_interface/frontend_sections/monitoring/dashboard#меню-узла-сети), которое доступно во многих разделах веб-интерфейса: - нажмите на имя узла сети и, затем, выберите *Панели (Dashboards)* из всплывающего меню  - При поиске по имени узла сети в [глобальном поиске](/manual/web_interface/global_search): - нажмите на ссылку *Панели (Dashboards)* в результатах поиска ```{=html} <!-- --> ``` - При нажатии на имя узла сети в *Инвентаризация* → *[Узлы сети](/manual/web_interface/frontend_sections/inventory/hosts) (Inventory* → *Hosts)*: - нажмите на доступную ссылку *Панели (Dashboards)* #### Access permissions Make sure that the 'zabbix' user has execute permissions for configured commands. One may be interested in using **sudo** to give access to privileged commands. To configure access, execute as root: visudo Example lines that could be used in *sudoers* file: # allows 'zabbix' user to run all commands without password. zabbix ALL=NOPASSWD: ALL # allows 'zabbix' user to restart apache without password. zabbix ALL=NOPASSWD: /etc/init.d/apache restart ::: notetip On some systems *sudoers* file will prevent non-local users from executing commands. To change this, comment out **requiretty** option in */etc/sudoers*. ::: #### Права доступа Убедитесь, что пользователь «zabbix» имеет права на выполнение сконфигурированных команд. Может оказаться интересным вариант с использованием **sudo** для предоставления доступа к привилегированным командам. Для настройки доступа выполните из-под root: visudo Примеры строк, которые можно использовать в файле *sudoers*: # разрешение пользователю 'zabbix' выполнения любых команд без пароля. zabbix ALL=NOPASSWD: ALL # разрешение пользователю 'zabbix' перезапуска apache без пароля. zabbix ALL=(ALL) NOPASSWD: /etc/init.d/apache restart ::: notetip В некоторых системах настройки файла *sudoers* будут препятствовать не-локальным пользователям выполнять команды. Чтобы это изменить, закомментируйте опцию **requiretty** в */etc/sudoers*. ::: #### 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 из пакетов приведёт к установке пакетов EPEL Zabbix, а не официальных пакетов Zabbix. В этом случае деинсталируйте пакеты Zabbix из EPEL, т.е.: dnf remove zabbix-server-mysql Заблокируйте пакеты Zabbix из EPEL. Добавьте следующую строку в файл `/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 } ``` #### Подтверждение события Подтверждение с сообщением одного события. Запрос: ```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 Changes:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) `action.create`, `action.update`: renamed parameter `acknowledge_operations` to `update_operations`.\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) `action.get`: renamed parameter `selectAcknowledgeOperations` to `selectUpdateOperations`.\ #### действие Изменения:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) `action.create`, `action.update`: переименован параметр `acknowledge_operations` на `update_operations`.\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) `action.get`: переименован параметр `selectAcknowledgeOperations` на `selectUpdateOperations`.\ # 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 - trigger 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 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|Trigger name|contains,<br>does not contain|Trigger 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.| ### Фильтр действия Объект фильтра действия определяет набор условий, которые должны быть соблюдены для выполнения добавленных операций действия. Этот объект имеет следующие свойства. |Свойства|Тип|Описание| |----------------|------|----------------| |**conditions**<br>(требуется)|массив|Набор условий фильтрации, которые используются для фильтрации результатов.| |**evaltype**<br>(требуется)|целое число|Метод вычисления условий фильтрации.<br><br>Возможные значения:<br>0 - и/или;<br>1 - и;<br>2 - или;<br>3 - пользовательское выражение.| |eval\_formula|строка|*(только чтение)* Сгенерированное выражение, которое будет использоваться для вычисления условий фильтрации. Выражение содержит ID, которые являются ссылкой на определенные условия фильтрации по их `formulaid` полю. Значение `eval_formula` равно значению `formula` для фильтров с пользовательским выражением.| |formula|строка|Заданное пользователем выражение, которое используется для вычисления условий фильтров с пользовательским выражением. Выражение должно содержать ID, которые являются ссылкой на определенные условия фильтрации по их `formulaid`. Эти ID используемые в выражении должны в точности совпадать с выражениями, которые заданы в условиях фильтрации: ни одно условие не должно остаться неиспользуемым или пропущенным.<br><br>Требуется для фильтров с пользовательским выражением.| #### Условие фильтрации действия Объект условия фильтрации действия задает определенное условие, которое необходимо проверить до выполнения операций действия. |Свойство|Тип|Описание| |----------------|------|----------------| |conditionid|строка|*(только чтение)* ID условия действия.| |**conditiontype**<br>(требуется)|целое число|Тип условия.<br><br>Возможные значения для действий на триггеры:<br>0 - группа узлов сети;<br>1 - узел сети;<br>2 - триггер;<br>3 - имя триггера;<br>4 - важность триггера;<br>6 - период времени;<br>13 - шаблон узла сети;<br>15 - группа элементов данных;<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>15 - группа элементов данных;<br>23 - тип события.| |**value**<br>(требуется)|строка|Значение с которым будет идти сравнение.| |value2<br>|строка|Второе значение с которым будет идти сравнение. Требуется для действий на триггеры с типом условия *26*.| |actionid|строка|*(только чтение)* ID действия, которому принадлежит условие.| |formulaid|строка|Произвольный уникальный ID, который используется в качестве ссылки на условие из пользовательского выражения. Может содержать только буквы в верхнем регистре. Этот ID должен быть задан пользователем при изменении условий фильтрации, однако ID будут сгенерированы заново при последующих их запросах.| |operator|целое число|Оператор условия.<br><br>Возможные значения:<br>0 - *(по умолчанию)* =;<br>1 - <>;<br>2 - содержит;<br>3 - не содержит;<br>4 - в;<br>5 - >=;<br>6 - <=;<br>7 - не в.| ::: notetip Чтобы лучше понимать как использовать фильтры с различными типами выражений, смотрите примеры на страницах [action.get](get#получение_действий_на_обнаружение) и [action.create](create#использование_фильтрации_при_помощи_пользовательского_выражения) методов. ::: У каждого типа условия поддерживаются следующие операторы и значения. |Условие|Имя условия|Поддерживаемые операторы|Ожидаемое значение| |--------------|---------------------|-----------------------------------------------|-----------------------------------| |0|Группа узлов сети|=, <>|ID группы узлов сети.| |1|Узел сети|=, <>|ID узла сети.| |2|Триггер|=, <>|ID триггера.| |3|Имя триггера|содержит, не содержит|Имя триггера.| |4|Важность триггера|=, <>, >=, <=|Важность триггера. Обратитесь к [свойству триггера "severity"](/ru/manual/api/reference/trigger/object#триггер) для получения списка поддерживаемых важностей в триггерах.| |5|Значение триггера|=|Значение триггера. Обратитесь к [свойству триггера "value"](/ru/manual/api/reference/trigger/object#триггер) для получения списка поддерживаемых значений триггера.| |6|Период времени|в, не в|Время, когда было вызвано событие в виде [периода времени](/ru/manual/appendix/time_period).| |7|IP узла сети|=, <>|Проверяемый один или несколько диапазонов IP адресов, разделенных запятыми. Обратитесь к разделу [настройки сетевого обнаружения](/ru/manual/discovery/network_discovery/rule) для получения более подробной информации о поддерживаемых форматах диапазонов IP адресов.| |8|Тип обнаруженного сервиса|=, <>|Тип обнаруженного сервиса. Тип сервиса соответствует проверке обнаружения, которая используется для обнаружения сервиса. Обратитесь к [свойству "type" проверки обнаружения](/manual/api/reference/dcheck/object#проверка_обнаружения) для получения списка поддерживаемых типов.| |9|Порт обнаруженного сервиса|=, <>|Один или несколько диапазонов портов, разделенных запятыми.| |10|Состояние обнаружения|=|Состояние обнаруженного объекта.<br><br>Возможные значения:<br>0 - хост или сервис доступны;<br>1 - хост или сервис недоступны;<br>2 - хост или сервис обнаружены;<br>3 - хост или сервис потеряны.| |11|Длительность времени доступности или недоступности|>=, <=|Время, которое указывает как долго обнаруженный объект находится в текущем состоянии, в секундах.| |12|Полученное значение|=, <>, >=, <=, содержит, не содержит|Полученное значение при выполнении проверки обнаружения Zabbix агента, SNMPv1, SNMPv2 или SNMPv3.| |13|Шаблон узла сети|=, <>|ID присоединенного шаблона.| |15|Группа элементов данных|=, содержит, не содержит|Имя группы элементов данных.| |16|Проблема подавлена|Нет, Да|Значение не требуется: использование оператора "Да" подразумевает что проблема должен быть подавлена, "Нет" - не подавлена.| |18|Правило обнаружения|=, <>|ID правила обнаружения.| |19|Проверка обнаружения|=, <>|ID проверки обнаружения.| |20|Прокси|=, <>|ID прокси.| |21|Объект обнаружения|=|Тип объекта, который вызвал событие обнаружения.<br><br>Возможные значения:<br>1 - обнаружен узел сети;<br>2 - обнаружен сервис.| |22|Имя узла сети|содержит, не содержит|Имя узла сети.| |23|Тип события|=|Специфично для внутренних событий.<br><br>Возможные значения:<br>0 - элемент данных в "неподдерживаемом" состоянии;<br>1 - элемент данных в "нормальном" состоянии;<br>2 - LLD правило в "неподдерживаемом" состоянии;<br>3 - LLD правило в "нормальном" состоянии;<br>4 - триггер в "неизвестном" состоянии;<br>5 - триггер в "нормальном" состоянии.| |24|Метаданные хоста|содержит, не содержит|Метаданные автоматически зарегистрированного узла сети.| |25|Тег|=, <>, содержит, не содержит|Тег события.| |26|Значение тега|=, <>, содержит, не содержит|Значение тега события.| ### 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.| ### Фильтр действия Объект фильтра действия определяет набор условий, которые должны быть соблюдены для выполнения настроенных действий. Он имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |**conditions**<br>(обязательный)|массив|Набор условий фильтрации используемых для фильтрации результатов.| |**evaltype**<br>(обязательный)|целое число|Метод вычисления условий фильтра.<br><br>Возможные значения:<br>0 - и/или;<br>1 - и;<br>2 - или;<br>3 - пользовательское выражение.| |eval\_formula|строка|*(только чтение)* Сгенерированное выражение, которое будет использоваться для вычисления условий фильтра. Выражение содержит идентификаторы, которые ссылаются на конкретные условия фильтрации по их идентификатору формулы (`formulaid`). Для фильтров с пользовательским выражением значение `eval_formula` равно значению `formula`.| |formula|строка|Определенное пользователем выражение, которое будет использоваться для вычисления условий фильтров с пользовательским выражением. Выражение должно содержать идентификаторы, которые ссылаются на определенные условия фильтрации по их `formulaid`. Идентификаторы, используемые в выражении, должны точно совпадать с идентификаторами, определенными в условиях фильтра: ни одно условие не может оставаться неиспользованным или пропущенным.<br><br>Требуется для настраиваемых выражений фильтров.| ##### Action for active agent autoregistration When server receives an autoregistration request from an agent it calls an [action](/manual/config/notifications/action). An action of event source "Autoregistration" must be configured for agent autoregistration. ::: noteclassic Setting up [network discovery](network_discovery) is not required to have active agents autoregister. ::: In the Zabbix frontend, go to *Configuration → Actions*, select *Autoregistration actions* and click on *Create action*: - In the Action tab, give your action a name - Optionally specify [conditions](/manual/config/notifications/action/conditions#autoregistration_actions). You can do a substring match or regular expression match in the conditions for host name/host metadata. If you are going to use the "Host metadata" condition, see the next section. - In the Operations tab, add relevant operations, such as - 'Add host', 'Add to host group' (for example, *Discovered hosts*), 'Link to templates', etc. ::: notetip If the hosts that will be autoregistering are likely to be supported for active monitoring only (such as hosts that are firewalled from your Zabbix server) then you might want to create a specific template like *Template\_Linux-active* to link to. ::: Created hosts are added to the *Discovered hosts* group (by default, configurable in *Administration* → *General* → *[Other](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). If you wish hosts to be added to another group, add a *Remove from host group* operation (specifying "Discovered hosts") and also add an *Add to host group* operation (specifying another host group), because a host must belong to a host group. ##### Действие по авторегистрации активного агента Когда сервер получает запрос на авторегистрацию от агента, он вызывает [действие](/manual/config/notifications/action). Для авторегистрации агента должно быть настроено действие с источником события «Авторегистрация». ::: noteclassic Настройка [сетевого обнаружения](network_discovery) для автоматической регистрации активных агентов не требуется. ::: Во веб-интерфейсе Zabbix перейдите к *Настройка → Действия (Configuration → Actions)*, выберите *Действия авторегистрации (Autoregistration actions)* и нажмите *Создать действие (Create action)*: - На вкладке «Действие (Action)» дайте название вашему действию. - По желанию укажите [условия](/manual/config/notifications/action/conditions#действия-на-авторегистрацию). В условиях вы можете выполнить сопоставление подстроки или регулярного выражения для имени узла сети/метаданных узла сети. Если вы собираетесь использовать условие «Метаданные узлов сети», см. следующий раздел. - На вкладке «Операции (Operations)» добавьте соответствующие операции, такие как «Добавить узел сети (Add host)», «Добавить в группу узлов сети (Add to host group)» (например, *Discovered hosts*), «Присоединить к шаблону (Link to templates)» и т. д. ::: notetip Если узлы сети, которые будут автоматически регистрироваться, вероятно, будут поддерживаться только для активного мониторинга (например, узлы сети, защищённые брандмауэром от вашего сервера Zabbix), то вы можете создать отдельный шаблон для присоединения наподобие *Template\_Linux-active*. ::: Созданные узлы сети добавляются в группу *Discovered hosts* (по умолчанию, настраивается в *Администрирование* → *Общие* → *[Другое](/manual/web_interface/frontend_sections/administration/general#другие-параметры) (Administration* → *General* →*Other)*). Если вы хотите, чтобы узлы сети были добавлены в другую группу, добавьте *Удалить из группы узлов сети (Remove from hostgroup)* (с указанием «Discovered hosts»), а также добавьте *Добавить в группу узлов сети (Add to host group)* (с указанием другой группы узлов сети), поскольку узел сети должен принадлежать к группе. # 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.| #### Условие операции действия Объект условия операции действия определяет условие, которое должно быть соблюдено для выполнения текущей операции. Он имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |opconditionid|строка|*(только чтение)* ID условия операции действия| |**conditiontype**<br>(обязательно)|целое число|Тип условия.<br><br>Возможные значения:<br>14 - событие подтверждено.| |**value**<br>(обязательно)|строка|Сравниваемое значение.| |operationid|строка|*(только чтение)* ID операции.| |operator|целое число|Оператор условия.<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.| #### Сообщение операции действия Объект сообщения операции содержит данные о сообщении, отправляемом этой операцией. |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |default\_msg|целое число|Использовать ли для действия текст и тему сообщения по умолчанию.<br><br>Возможные значения:<br>0 - использовать данные из операции;<br>1 - *(по умолчанию)* использовать данные из способа оповещений.| |mediatypeid|строка|Идентификатор способа оповещения, который будет использоваться для отправки сообщения.| |message|строка|Текст сообщения операции.| |subject|строка|Тема сообщения операции.| ### 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 actions, only '0' is supported for internal actions. All types are supported for discovery and autoregistration actions.| |actionid|string|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 and internal actions. In trigger actions, escalations are not supported in problem recovery and update operations.| |esc\_step\_from|integer|Step to start escalation from.<br><br>Default: 1.<br><br>Note that escalations are supported only for trigger and internal actions. In trigger actions, escalations are not supported in problem recovery and update operations.| |esc\_step\_to|integer|Step to end escalation at.<br><br>Default: 1.<br><br>Note that escalations are supported only for trigger and internal actions. In trigger actions, escalations are not supported in problem recovery and update 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)* 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)* 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)* 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)* 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)* 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 to.<br><br>Each object has the following properties:<br>`operationid` - *(string)* 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)* ID of the operation;<br>`inventory_mode` - *(string)* Inventory mode.<br><br>Required for "Set host inventory mode" operations.| ### Операция действия Объект операции действия определяет операцию, которая будет выполняться, когда выполняется действие. Он имеет следующие свойства: |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--------|---------------------------------------------------|-----------| |operationid|строка|*(только для чтения)* ID операции действия.| |**operationtype**<br>(обязательное)|целое число|Тип операции.<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|строка|ID действия, которому принадлежит операция.| |esc\_period|строка|Продолжительность шага эскалации в секундах. Должно быть больше 60 секунд. Принимает секунды, единицу времени с суффиксом и пользовательский макрос. Если значение задано как 0 или 0s, будет использован интервал для эскалации действия по умолчанию.<br><br>По умолчанию: 0s.<br><br>Обратите внимание, что эскалации поддерживаются только для триггеров и внутренних действий. В действиях триггеров не поодерживаются эскалации для операций востановления и обновления.| |esc\_step\_from|целое число|Шаг, с которого начинается эскалация.<br><br>По умолчанию: 1.<br><br>Обратите внимание, что эскалации поддерживаются только для триггеров и внутренних действий. В действиях триггеров не поодерживаются эскалации для операций востановления и обновления.| |esc\_step\_to|целое число|Шаг, на котором эскалация заканчивается.<br><br>По умолчанию: 1.<br><br>Обратите внимание, что эскалации поддерживаются только для триггеров и внутренних действий. В действиях триггеров не поодерживаются эскалации для операций востановления и обновления.| |evaltype|целое число|Метод оценки условия операции.<br><br>Возможные значения:<br>0 - *(по умолчанию)* И / ИЛИ;<br>1 - И;<br>2 - ИЛИ.| |opcommand|объект|Объект, содержащий данные о глобальном скрипте, запущенном операцией.<br><br>Каждый объект имеет одно следующее свойство: `scriptid` - *(строка)* ID скрипта.<br><br>Обязательный для операций глобального скрипта.| |opcommand\_grp|массив|Группы узлов сети, на которых будут выполняться глобальные скрипты.<br><br>Каждый объект имеет следующие свойства:<br>`opcommand_grpid` - *(строка, только для чтения)* ID объекта;<br>`operationid` - *(строка)* ID операции;<br>`groupid` - *(строка)* ID группы узлов сети.<br><br>Обязательный для операций глобального скрипта если `opcommand_hst` не задан.| |opcommand\_hst|массив|Узел сети, на котором будут выполняться глобальные скрипты.<br><br>Каждый объект имеет следующие свойства:<br>`opcommand_hstid` - *(строка, только для чтения)* ID объекта;<br>`operationid` - *(строка)* ID операции;<br>`hostid` - *(строка)* ID узла сети; если задано 0 команда будет выполняться на текущем узле сети.<br><br>Обязательный для операций глобального скрипта если `opcommand_grp` не задан.| |opconditions|массив|Условия операции используемые для действий триггера.<br><br>Объект условий операции [подробно описан ниже](/manual/api/reference/action/object#action_operation_condition).| |opgroup|массив|Группы узлов сети в которые добавляется узел сети.<br><br>Каждый объект имеет следующие свойства:<br>`operationid` - *(строка)* ID операции;<br>`groupid` - *(строка)* ID группы узлов сети.<br><br>Обязательный для операций "добавления в группу узлов сети" и "удаления из группы узлов сети".| |opmessage|объект|Объект, содержащий данные о сообщении, отправленном операцией.<br><br>Объект сообщения операции [подробно описан ниже](/manual/api/reference/action/object#action_operation_message).<br><br>Обязательный для операций с сообщениями.| |opmessage\_grp|массив|Группы пользователям, которым будут отправлены сообщения.<br><br>Каждый объект имеет следующие свойства:<br>`operationid` - *(строка)* ID операции;<br>`usrgrpid` - *(строка)* ID группы пользователей.<br><br>Обязательный для операций с сообщениями если `opmessage_usr` не задан.| |opmessage\_usr|массив|Пользователи, которым будут отправлены сообщения.<br><br>Каждый объект имеет следующие свойства:<br>`operationid` - *(строка)* ID операции;<br>`userid` - *(строка)* ID пользователя.<br><br>Обязательный для операций с сообщениями если `opmessage_grp` не задан.| |optemplate|массив|Шаблоны, которые необходимо присоединить к узлам сети.<br><br>Каждый объект имеет следующие свойства:<br>`operationid` - *(строка)* ID операции;<br>`templateid` - *(строка)* ID шаблона.<br><br>Обязательный для операций "присоединить к шаблону" и "отсоединить от шаблона".| |opinventory|объект|Режим инвентаризации устанавливаемый для узла сети.<br><br>Объект имеет следующие свойства:<br>`operationid` - *(строка)* ID операции;<br>`inventory_mode` - *(строка)* Режим инвентаризации.<br><br>Обязательный для операций "установить режим инвентаризации узла сети".| ### 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.| ### Операция действия Объект операции действия определяет операцию, производимую при выполении действия. Этот объект имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |operationid|строка|*(только чтение)* ID операции действия.| |**operationtype**<br>(требуется)|целое число|Тип операции.<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|строка|*(только чтение)* ID действия, которому принадлежит операция.| |esc\_period|строка|Длительность шага эскалации в секундах. Должна быть больше 60 секунд. Принимает секунды, единицы времени с суффиксом и пользовательские макросы. Если задано равным 0 или 0s, будет использоваться период эскалации действия по умолчанию .<br><br>По умолчанию: 0s.<br><br>Обратите внимание, что эскалации поддерживаются только для действий триггеров и сервисов, внутренних действий и только в обычных операциях.| |esc\_step\_from|целое число|Шаг начала эскалации.<br><br>По умолчанию: 1.<br><br>Обратите внимание, что эскалации поддерживаются только для действий триггеров и сервисов, внутренних действий и только в обычных операциях.| |esc\_step\_to|целое число|Шаг завершения эскалации.<br><br>По умолчанию: 1.<br><br>Обратите внимание, что эскалации поддерживаются только для действий триггеров и сервисов, внутренних действий и только в обычных операциях.| |evaltype|целое число|Метод вычисления условия операции.<br><br>Возможные значения:<br>0 - *(по умолчанию)* И / ИЛИ;<br>1 - И;<br>2 - ИЛИ.| |opcommand|объект|Объект, который содержит данные о глобальном скрипте в операции.<br><br>Каждый объект имеет единственное свойство: `scriptid` - *(строка)* ID скрипта.<br><br>Требуется для операций с глобальным скриптом.| |opcommand\_grp|массив|Группы узлов сети, на которых будут выполняться глобальные скрипты.<br><br>Каждый объект имеет следующие свойства:<br>`opcommand_grpid` - *(строка, только чтение)* ID объекта;<br>`operationid` - *(строка, только чтение)* ID операции;<br>`groupid` - *(строка)* ID группы узлов сети.<br><br>Требуется при операциях с глобальным скриптом, если не задано `opcommand_hst`.| |opcommand\_hst|массив|Узел сети, на котором будет выполнен глобальный скрипт.<br><br>Каждый объект имеет следующие свойства:<br>`opcommand_hstid` - *(строка, только чтение)* ID объекта;<br>`operationid` - *(строка, только чтение)* ID операции;<br>`hostid` - *(строка)* ID узла сети; если задано значение «0», то команда будет выполняться на текущем узле сети.<br><br>Требуется при операциях с глобальным скриптом, если не задано opcommand_grp.| |opconditions|массив|Условия операции, которые используются для действий триггеров.<br><br>Объект условия операции [подробно описан ниже](/manual/api/reference/action/object#условие-операции-действия).| |opgroup|массив|Группы узлов сети, в которые будут добавлены узлы сети.<br><br>Каждый объект имеет следующие свойства:<br>`operationid` - *(строка, только чтение)* ID операции;<br>`groupid` - *(строка)* ID группы узлов сети<br><br>Требуется для операций "добавление в группу узлов сети" и "удаление из группы узлов сети".| |opmessage|объект|Объект, который содержит данные об отправляемом в операции сообщении.<br><br>Объект сообщения операции [подробно описан ниже.](/manual/api/reference/action/object#сообщение-об-операции-действия).<br><br>Требуется для операций с сообщениями.| |opmessage\_grp|массив|Группы пользователей, которым будут отправляться сообщения.<br><br>Каждый объект имеет следующие свойства:<br>`operationid` - *(строка, только чтение)* ID операции;<br>`usrgrpid` - *(строка)* ID группы пользователей.<br><br>Требуется при операциях с сообщениями, если не задано `opmessage_usr`.| |opmessage\_usr|массив|Пользователи, которым будут отправляться сообщения.<br><br>Каждый объект имеет следующие свойства:<br>`operationid` - *(строка, только чтение)* ID операции;<br>`userid` - *(строка)* ID пользователя.<br><br>Требуется при операциях с сообщениями, если не задано `opmessage_grp`.| |optemplate|массив|Шаблоны к которым будет присоединён узлы сети.<br><br>Каждый объект имеет следующие свойства:<br>`operationid` - *(строка, только чтение)* ID операции;<br>`templateid` - *(строка)* ID шаблона.<br><br>Требуется для операций "присоединение шаблона" и "отсоединение шаблона".| |opinventory|объект|Режим инвентарных данных, который необходимо задать узлу сети.<br><br>Объект имеет следующие свойства:<br>`operationid` - *(строка, только чтение)* ID операции;<br>`inventory_mode` - *(строка)* Режим инвентарных данных.<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 actions and internal 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 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|ID of the action that the recovery operation belongs to.| |opcommand|object|Object containnig 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)* 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)* 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)* 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)* ID of the operation;<br>`userid` - *(string)* ID of the user.<br><br>Required for message operations if `opmessage_grp` is not set.| #### Условие операции действия Объект условия операции действия определяет условие, которое должно быть соблюдено для выполнения текущей операции. Этот объект имеет следующие свойства. |Свойство|Тип|Описание| |----------------|------|----------------| |opconditionid|строка|*(только чтение)* ID условия операции действия| |**conditiontype**<br>(требуется)|целое число|Тип условия.<br><br>Возможные значения:<br>14 - событие подтверждено.| |**value**<br>(требуется)|строка|Значение с которым происходит сравнение.| |operationid|строка|*(только чтение)* ID операции.| |operator|целое число|Оператор условия.<br><br>Возможные значения:<br>0 - *(по умолчанию)* =.| Каждым типом условия операции поддерживаются следующие операторы и значения. |Условие|Имя условия|Поддерживаемые операторы|Ожидаемое значение| |--------------|---------------------|-----------------------------------------------|-----------------------------------| |14|Событие подтверждено|=|Подтверждено ли событие.<br><br>Возможные значения:<br>0 - не подтверждено;<br>1 - подтверждено.| #### 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. #### Действия, отключённые из-за удалённых объектов Если какой-либо объект (узел сети, шаблон, триггер и т.п), используемый в условиях/операциях действия будет удалён, то условия/операция удаляется, а действие отключается во избежание его некорректного выполнения. Пользователь затем может повторно включить действие. Такое поведение применяется при удалении: - групп узлов сети (условие «группа узлов сети», операция «удалённая команда» над конкретной группой узлов сети); - узлов сети (условие «узел сети», операция «удаленная команда» над конкретным узлом сети); - шаблонов (условие «»шаблон», операции «присоединить к шаблону» и «отсоединить от шаблона»); - триггеров (условие «триггер»); - правил обнаружения (при использовании условий «правило обнаружения» и «проверка обнаружения»). *Обратите внимание*: Если удалённая команда нацелена на множество узлов сети и удаляется один из них, только удалённый узел сети будет удалён из списка целей, сама операция останется. Но если это единственный узел сети, операция также будет удалена. То же самое касается и операций «присоединить к шаблону» и «отсоединить от шаблона». Действия не будут отключены при удалении пользователя или группы пользователей, которые используются в операции «отправка сообщений». #### 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) действий. Поскольку действия на сетевое обнаружение основаны на событиях, они будут срабатывать и когда обнаруженный узел сети активен (online), и когда неактивен (offline). Крайне рекомендуется добавить [условие](/manual/config/notifications/action/conditions) действия *Состояние обнаружения: доступен*, чтобы избежать ситуации, когда такие действия как *Добавить узел сети* срабатывали бы при событиях *Сервис потерян* / *Сервис недоступен*. В противном случае, если обнаруженный узел сети удаляется вручную, по-прежнему будут генерироваться события *Сервис потерян* / *Сервис недоступен*, и он будет пересоздан во время следующего цикла обнаружения. ::: 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. #### Действия, если произошла ошибка связи между агентом и сервером Каждая совпадающая строка с элементов данных `log[]` и `logrt[]` и результат проверки каждого элемента данных `log.count[]` и `logrt.count[]` требует свободного слота в выделенных 50% области буфера отправки в агенте. Элементы буфера периодически отправляются серверу (или прокси), и слоты буфера становятся снова пустыми. Пока имеются свободные слоты в выделенной области для журналов в буфере отправки в агенте и связь между агентом и сервером (или прокси) нарушена, результаты мониторинга журналов накапливаются в буфере отправки. Такое поведение позволяет смягчить кратковременные нарушения связи. Во время длительных нарушений связи все слоты журналов становятся занятыми и выполняются следующие действия: - Проверки элементов данных `log[]` и `logrt[]` останавливаются. Когда связь восстановится и появятся свободные слоты, проверки возобновятся с предыдущей позиции. Совпадающие строки не будут потеряны, они просто будут отправлены позже. - Проверки `log.count[]` и `logrt.count[]` останавливаются, если `maxdelay = 0` (по умолчанию). Поведение похоже на элементы данных `log[]` и `logrt[]`, описанное выше. Обратите внимание, что потеря связи может повлиять на результаты `log.count[]` и `logrt.count[]`: например, одна проверка насчитывает 100 совпадающих строк в файле журнала, но по причине отсутствия свободных слотов в буфере проверка остановлена. Когда связь восстановится, агент насчитает те же 100 совпадающих строк, а также 70 новых совпадающих строк. После чего агент отправит количество = 170, как будто они были найдены за одну проверку. - Проверки `log.count[]` и `logrt.count[]` при `макс. задержка > 0`: если не было «прыжка» во время проверки, тогда поведение аналогично описанному выше. Если всё же был «прыжок» через строки файла журнала, тогда позиция после «прыжка» сохранится, а вычисленный результат будет отброшен. Таким образом, агент пытается не отставать от увеличивающегося файла журнала, даже в случае проблем со связью. #### 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#примечания)^| |-|------------------------------|----------| |Оповещения и команды на события триггеров|<|да| |Внутренние оповещения на события триггеров|<|да| |Оповещения об обновлении проблем|<|да| |Оповещения и команды на события услуг|<|да| |Оповещения об обновлении услуг|<|да| |Условие периода времени|<|нет| |*Операции*|<|<| | |Длительность шага операции по умолчанию|нет| |^|Длительность шага|нет| ##### Actions The module will have control over frontend actions defined within the *actions* object in the manifest.json file. This way new actions are defined. In the same way you may redefine existing actions. Each key of actions should represent the action name and the corresponding value should contain `class` and optionally `layout` and `view` keys. One action is defined by four counterparts: name, controller, view and layout. Data validation and preparation is typically done in the controller, output formatting is done in the view or partials, and the layout is responsible for decorating the page with elements such as menu, header, footer and others. Module actions must be defined in the manifest.json file as *actions* object: |Parameter|Required|Type|Default|Description| |---------|---|----|--|-------------------| |key|Yes|String|\-|Action name, in lowercase \[a-z\], separating words with dot.| |class|Yes|String|\-|Action class name, including subdirectory path (if used) within the `actions` directory.| |layout|No|String|"layout.htmlpage"|Action layout.| |view|No|String|null|Action view.| There are several predefined layouts, like `layout.json` or `layout.xml`. These are intended for actions which produce different result than an HTML. You may explore predefined layouts in the app/views/ directory or even create your own. Sometimes it is necessary to only redefine the view part of some action leaving the controller intact. In such case just place the necessary view and/or partial files inside the `views` directory of the module. For reference, please see an example action controller file in the [Reference](#reference) section. Please do not hesitate to explore current actions of Zabbix source code, located in the app/ directory. **Module.php** This optional PHP file is responsible for module initialization as well as event handling. Class 'Module' is expected to be defined in this file, extending base class `\Core\CModule`. The Module class must be defined within the namespace specified in the manifest.json file. ``` {.php} <?php namespace Modules\Example; use Core\CModule as BaseModule; class Module extends BaseModule { ... } ``` For reference, please see an example of Module.php in the [Reference](#reference) section. ##### Действия Модуль будет иметь контроль над действиями веб-интерфейса, определёнными в объекте *actions* в файле manifest.json. Таким образом определяются новые действия. Таким же образом вы можете переопределить существующие действия. Каждый ключ действий должен представлять имя действия, а соответствующее значение должно содержать ключи `class` и, по желанию, `layout` и `view`. Одно действие определяется четырьмя составляющими: name, controller, view и layout. Проверка и подготовка данных обычно выполняются в controller, форматирование вывода выполняется во view или в partials, а layout отвечает за оформление страницы такими элементами, как меню, верхний колонтитул, нижний колонтитул и другие. : Действия модуля должны быть определены в файле manifest.json как объект *actions*: |Параметр|Обязательный|Тип|По умолчанию|Описание| |---------|---|----|--|-------------------| |key|Да|String|\-|Название действия, строчные буквы \[a-z\], разделяя слова точкой.| |class|Да|String|\-|Имя класса действия, включая путь к вложенной папке (если используется) в папке `actions`.| |layout|Нет|String|"layout.htmlpage"|Макет действия.| |view|Нет|String|null|Отображение действия.| Существует несколько готовых макетов, таких как `layout.json` или `layout.xml`. Они предназначены для действий, которые дают результат, отличный от HTML. Вы можете изучить готовые макеты в директории app/views/ или создать свой собственный. В некоторых случаях необходимо изменить только представление (view) некоторого действия, не изменяя контроллер. В таком случае просто поместите необходимые элементы отображения и/или составляющие в папку `views` модуля. Для справки см. пример файла Action controller в разделе [Справочные материалы](#справочные-материалы). Пожалуйста, не стесняйтесь изучать текущие действия исходного кода Zabbix, расположенного в папке app/. **Module.php** Этот необязательный файл PHP отвечает за инициализацию модуля, а также за обработку событий. Предполагается, что в этом файле будет определен класс «Module», расширяющий базовый класс «`\Core\CModule`». Класс «Module» должен быть определён в пространстве имен, указанном в файле manifest.json. ``` {.php} <?php namespace Modules\Example; use Core\CModule as BaseModule; class Module extends BaseModule { ... } ``` Для справки см. пример файла Module.php в разделе [Справочные материалы](#справочные-материалы). ### 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 and internal actions. In trigger actions, escalations are not supported in problem recovery and update 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.| ### Действие Объект действия содержит следующие свойства: |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--------|---------------------------------------------------|-----------| |actionid|строка|*(только для чтения)* ID действия.| |**esc\_period**<br>(обязательное)|строка|Длительность шага операции по умолчанию. Должно быть как минимум 60 секунд. Принимает секунды, единицы времени и пользовательские макросы.<br><br>Обратите внимание, что эскалации поддерживаются только для триггеров и внутренних действий. В действиях триггеров эскалации не поддерживаются при восстановлении проблемы и операциях обновления.| |**eventsource**<br>(обязательное)|целое число|*(постоянное)* Тип события, которое будет обрабатывать действие.<br><br>Смотрите свойство события ["source"](/manual/api/reference/event/object#event) для списка всех поддерживаемых типов событий.| |**name**<br>(обязательное)|строка|Имя действия.| |status|целое число|Активировано ли действие или нет.<br><br>Возможные значения:<br>0 - *(по умолчанию)* активировано;<br>1 - деактивировано.| |pause\_suppressed|целое число|Приостанавливать ли эскалацию в течении периодов обслуживания или нет.<br><br>Возможные значения:<br>0 - не приостанавливать эскалацию;<br>1 - *(по умолчанию)* приостановить эскалацию.<br><br>Обратите внимание, что этот параметр применим только к действиям триггеров.| |notify\_if\_canceled|целое число|Уведомлять ли когда была отменена эскалация или нет.<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| |--|--|------| |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.| ### Действие Объект действия имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#типы_данных)|Описание| |--|--|------| |actionid|строка|*(только чтение)* ID действия.| |**esc\_period**<br>(требуется)|строка|Длительность шага операции по умолчанию. Должна быть не менее 60 секунд. Принимает секунды, единицы времени с суффиксом и пользовательские макросы.<br><br>Обратите внимание, что эскалации поддерживаются только для действий триггеров и сервисов, а так же внутренних действий и только в обычных операциях.| |**eventsource**<br>(требуется)|целое число|*(константа)* Тип событий, которые будет обрабатывать действие.<br><br>Обратитесь к [свойству событий "source"](/manual/api/reference/event/object#событие) для получения списка поддерживаемых типов событий.| |**name**<br>(требуется)|строка|Имя действия.| |status|целое число|Активировано действие или деактивировано.<br><br>Возможные значения:<br>0 - *(по умолчанию)* активировано;<br>1 - деактивировано.| |pause\_suppressed|целое число|Приостанавливать эскалацию в течение периодов обслуживания или нет.<br><br>Возможные значения:<br>0 - Не приостанавливать эскалацию;<br>1 - *(по умолчанию)* Приостановить эскалацию.<br><br>Обратите внимание, что этот параметр действителен только для действий триггера.| |notify\_if\_canceled|целое число|Оповещать ли о том, что эскалация отменена.<br><br>Possible values:<br>0 - Не оповещать, что эскалация отменена;<br>1 - *(по умолчанию)* Оповещать об отмене эскалации.<br><br>Обратите внимание, что этот параметр действителен только для действий триггера.| # 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 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 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.| ### Операция действия о восстановлении Объект операции действия о восстановлении определяет операцию, которая будет выполнена когда проблема решена. Операции восстановления можно использовать для действий по триггерам и внутренним действиям. Этот объект имеет следующие свойства. |Свойство|Тип|Описание| |----------------|------|----------------| |operationid|строка|*(только чтение)* ID операции действия.| |**operationtype**<br>(требуется)|целое число|Тип операции.<br><br>Возможные значения для действий на триггеры:<br>0 - отправка сообщения;<br>1 - удаленная команда;<br>11 - оповещать всех участников.<br><br>Возможные значения для действий на внутренние события:<br>0 - отправка сообщения;<br>11 - оповещать всех участников.| |actionid|строка|ID действия, которому принадлежит операция о восстановлении.| |opcommand|массив|Объект, который содержит данные о выполняемой команде в операции о восстановлении.<br><br>Объект команды операции [описан в деталях выше](/ru/manual/api/reference/action/object#команда_операции_действия).<br><br>Требуется для операций с удаленной командой.| |opcommand\_grp|массив|Группы узлов сети на которых будут выполняться удаленные команды.<br><br>Каждый объект имеет следующие свойства:<br>`opcommand_grpid` - *(строка, только чтение)* ID объекта;<br>`operationid` - *(строка)* ID операции;<br>`groupid` - *(строка)* ID группы узлов сети.<br><br>Требуется при операциях с удаленной командой, если не задано `opcommand_hst`.| |opcommand\_hst|массив|Узел сети на котором будут выполняться удаленные команды.<br><br>Каждый объект имеет следующие свойства:<br>`opcommand_hstid` - *(строка, только чтение)* ID объекта;<br>`operationid` - *(строка)* ID операции;<br>`hostid` - *(строка)* ID узла сети; если задано значение равное 0, команда будет выполняться на текущем узле сети.<br><br>Требуется при операциях с удаленной командой, если не задано `opcommand_grp`.| |opmessage|объект|Объект, который содержит данные об отправляемом сообщении в операции о восстановлении.<br><br>Объект сообщения операции [детально описан выше](/ru/manual/api/reference/action/object#сообщение_операции_действия).<br><br>Требуется для операций с сообщениями.| |opmessage\_grp|массив|Группы пользователей которым будут отправляться сообщения.<br><br>Каждый объект имеет следующие свойства:<br>`operationid` - *(строка)* ID операции;<br>`usrgrpid` - *(строка)* ID группы пользователей.<br><br>Требуется при операциях с сообщениями, если не задано `opmessage_usr`.| |opmessage\_usr|массив|Пользователи которым будут отправляться сообщения.<br><br>Каждый объект имеет следующие свойства:<br>`operationid` - *(строка)* ID операции;<br>`userid` - *(строка)* ID пользователя.<br><br>Требуется при операциях с сообщениями, если не задано `opmessage_grp`.| ### 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.| ### Операция обновления действия Объект операции обновления действия определяет операцию, которая будет выполняться при обновлении проблемы (прокомментировано, подтверждено, изменена важность или закрыто вручную). Операции обновления возможны для триггерных и сервисных действий. Объект обладает следующими свойствами. |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |operationid|строка|*(только чтение)* ID операции действия.| |**operationtype**<br>(обязательно)|целое число|Тип операции.<br><br>Возможные значения для триггерных и сервисных действий:<br>0 - отправить сообщение;<br>1 - глобальный сценарий;<br>12 - уведомить всех участников.| |opcommand|объект|Объект, содержащий данные о глобальном сценарии, запускаемом операцией.<br><br>Каждый объект имеет одно следующее свойство: `scriptid` - *(string)* ID сценария типа действия.<br><br>Требуется для операций глобальных сценариев.| |opcommand\_grp|массив|Группы узлов сети для запуска глобальных сценариев.<br><br>Каждый объект имеет следующие свойства:<br>`groupid` - *(string)* ID группы узлов сети.<br><br>Требуется для операций глобальных сценариев, если `opcommand_hst` не установлен.| |opcommand\_hst|массив|Узлы сети для запуска глобальных сценариев.<br><br>Каждый объект имеет следующие свойства:<br>`hostid` - *(string)* ID узла сети; если установлено значение 0, команда будет запущена на текущем хосте.<br><br>Требуется для операций глобальных сценариев, если `opcommand_grp` не задано.| |opmessage|объект|Объект, содержащий данные о сообщении, отправляемом операцией обновления.<br><br>Объект сообщения операции [подробно описан выше](/manual/api/reference/action/object#сообщение-операции-действия).| |opmessage\_grp|массив|Группы пользователей для отправки сообщений.<br><br>Каждый объект имеет следующие свойства:<br>`usrgrpid` - *(строка)* ID группы пользователей.<br><br>Требуется только для операций `send message` если `opmessage_usr` не установлен.<br>Игнорируется для операций `send update message`.| |opmessage\_usr|массив|Пользователи которым нужно отправлять сообщения.<br><br>Каждый объект имеет следующие свойства:<br>`userid` - *(строка)* ID пользователя.<br><br>Обязательный только для операций `send message`, если `opmessage_grp` не установлен.<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. Если настроено, событие на авторегистрацию активного агента создаётся, если ранее неизвестный активный агент запрашивает свои проверки или если изменились метаданные узла сети. Сервер добавляет новый автоматически зарегистрированный узел сети, используя полученные IP адрес и порт агента. Для получения более подробной информации, смотрите страницу об [автоматической регистрации активных агентов](/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. ::: #### Активные проверки Активные проверки требуют более сложной обработки. Агент сначала должен получить с сервера (или серверов) список элементов данных для независимой обработки. Серверы для получения активных проверок перечислены в параметре «ServerActive» [файла конфигурации](/manual/appendix/config/zabbix_agentd) агента. Частота запросов данных проверок настраивается параметром «RefreshActiveChecks» в этом же файле конфигурации. Однако, если обновление активных проверок завершится с ошибкой, запрос повторится через 60 секунд (жёстко задано в коде). Затем агент периодически отправляет новые значения на сервер(ы). ::: notetip Если агент находится за брандмауэром, вы можете рассмотреть возможность использования исключительно Активных проверок, т.к. в этом случае вам не понадобится менять настройки брандмауэра для разрешения начальных входящих соединений. ::: ### Active checks request The active checks request is used to obtain the active checks to be processed by agent. This request is sent by the agent upon start and then with *RefreshActiveChecks* intervals. | Field | Type | Mandatory | Value | |-|-|-|--------| | request | _string_ | yes | `active checks` | | host | _string_ | yes | Host name. | | version | _string_ | yes | The agent version: \<major>.\<minor>. | | host_metadata | _string_ | no | The configuration parameter HostMetadata or HostMetadataItem metric value. | | interface | _string_ | no | The configuration parameter HostInterface or HostInterfaceItem metric value. | | ip | _string_ | no | The configuration parameter ListenIP first IP if set. | | port | _number_ | no | The configuration parameter ListenPort value if set and not default agent listening port. | Example: ```json { "request": "active checks", "host": "Zabbix server", "version": "6.0", "host_metadata": "mysql,nginx", "hostinterface": "zabbix.server.lan", "ip": "159.168.1.1", "port": 12050 } ``` ### Запрос на активные проверки Запрос на активную проверку используется для получения активных проверок для последующей обработки агентом. Запрос посылается агентом при старте и затем с интервалом *RefreshActiveChecks*. |Поле|Тип|Обязательное|Значение| |-|-|-|--------| | request | _строка_ |да| `active checks` | | host | _строка_ |да|Имя узла сети.| | version | _строка_ |да|Версия агента: \<major>.\<minor>.| | host_metadata | _строка_ |нет|Параметр конфигурации HostMetadata или значение метрики HostMetadataItem.| | interface | _строка_ |нет|Параметр конфигурации HostInterface илизначение метрики HostInterfaceItem.| | ip | _строка_ |нет|Первый IP параметра конфигурации ListenIP, если задан.| | port | _число_ |нет|Значение параметра конфигурации ListenPort, если задано и отличается от порта агента по умолчанию.| Пример: ```json { "request": "active checks", "host": "Zabbix server", "version": "6.0", "host_metadata": "mysql,nginx", "hostinterface": "zabbix.server.lan", "ip": "159.168.1.1", "port": 12050 } ``` ### Active checks response The active checks response is sent by the server back to agent after processing active checks request. | Field |<| Type | Mandatory | Value | |-|------|--|-|-----------------------| | response |<| _string_ | yes | `success` \| `failed` | | info |<| _string_ | no | Error information in the case of failure. | | data |<| _array of objects_ | no | Active check items. | | | key | _string_ | no | Item key with expanded macros. | |^| itemid | _number_ | no | Item identifier. | |^| delay | _string_ | no | Item update interval. | |^| lastlogsize | _number_ | no | Item lastlogsize. | |^| mtime | _number_ | no | Item mtime. | | regexp |<| _array of objects_ | no | Global regular expressions. | | | name | _string_ | no | Global regular expression name. | |^| expression | _string_ | no | Global regular expression. | |^| expression_type | _number_ | no | Global regular expression type. | |^| exp_delimiter | _string_ | no | Global regular expression delimiter. | |^| case_sensitive | _number_ | no | Global regular expression case sensitivity setting. | Example: ```json { "response": "success", "data": [ { "key": "log[/home/zabbix/logs/zabbix_agentd.log]", "itemid": 1234, "delay": "30s", "lastlogsize": 0, "mtime": 0 }, { "key": "agent.version", "itemid": 5678, "delay": "10m", "lastlogsize": 0, "mtime": 0 } ] } ``` ### Ответ активных проверок Ответ активных проверок отсылается сервером обратно агенту после обработки запроса на активные проверки. |Поле|<|Тип|Обязательное|Значение| |-|------|--|-|-----------------------| | response |<| _строка_ |да| `success` \| `failed` | | info |<| _строка_ |нет| Информация об ошибке в случае сбоя. | | data |<| _массив объектов_ |нет| Активные проверки элементов данных. | | | key | _строка_ |нет| Ключ элемента данных с раскрытыми макросами. | |^| itemid | _число_ |нет| Идентификатор элемента данных. | |^| delay | _строка_ |нет| Интервал обновления элемента данных. | |^| lastlogsize | _число_ |нет| Последний размер файла журнала (lastlogsize) элемента данных. | |^| mtime | _число_ |нет| Отметка времени последней модификации (mtime) элемента данных. | | regexp |<| _массив объектов_ |нет| Глобальные регулярные выражения. | | | name | _строка_ |нет| Имя глобального регулярного выражения. | |^| expression | _строка_ |нет| Глобальное регулярное выражение. | |^| expression_type | _число_ |нет| Тип глобального регулярного выражения. | |^| exp_delimiter | _строка_ |нет| Разделитель глобального регулярного выражения. | |^| case_sensitive | _число_ |нет| Флаг чувствительности к регистру глобального регулярного выражения. | Пример: ```json { "response": "success", "data": [ { "key": "log[/home/zabbix/logs/zabbix_agentd.log]", "itemid": 1234, "delay": "30s", "lastlogsize": 0, "mtime": 0 }, { "key": "agent.version", "itemid": 5678, "delay": "10m", "lastlogsize": 0, "mtime": 0 } ] } ``` #### 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 } ``` #### Добавление зависимости триггера Сделать триггер "14092" зависимым от триггера "13565". Запрос: ```json { "jsonrpc": "2.0", "method": "trigger.adddependencies", "params": { "triggerid": "14092", "dependsOnTriggerid": "13565" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```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*. Запрос: ```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 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` #### Adding dashboards To add dashboards to a template in *Configuration → Templates*, do the following: - Click on *Dashboards* in the row of the template - Configure a dashboard following the guidelines of [configuring dashboards](/manual/web_interface/frontend_sections/monitoring/dashboard) ::: noteimportant The widgets that can be included in a template dashboard are: *Clock*, *Graph (classic)*, *Graph prototype*, *Item value*, *Plain text*, *URL*. ::: ::: notetip For details on accessing host dashboards that are created from template dashboards, see the [host dashboard](/manual/config/visualization/host_screens#accessing_host_dashboards) section. ::: #### Добавление панелей Для добавления панелей в шаблон из *Настройка → Шаблоны (Configuration → Templates)*, сделайте следующее: - Нажмите на *Панели (Dashboards)* в строке с шаблоном - Настройте панель, следуя обычному способу [настройки панелей](/manual/web_interface/frontend_sections/monitoring/dashboard) ::: noteimportant Виджеты, которые можно добавить к панелям шаблонов: *Часы*, *График (классический)*, *Прототип графиков*, *Значение элемента данных*, *Простой текст*, *URL*. ::: ::: notetip Для получения информации касательно доступа к панелям узлов сети, которые созданы с панелей шаблонов, смотрите раздел [панель узлов сети](/manual/config/visualization/host_screens#доступ-к-панелям-узлов-сети). ::: #### Adding elements To add an element, click on *Add* next to `Map element`. The new element will appear at the top left corner of the map. Drag and drop it wherever you like. Note that with the Grid option "On", elements will always align to the grid (you can pick various grid sizes from the dropdown, also hide/show the grid). If you want to put elements anywhere without alignment, turn the option to "Off". (You can align random elements to the grid later, by clicking on *Align map elements*.) Now that you have some elements in place, you may want to start differentiating them by giving names, etc. By clicking on the element, a form is displayed and you can set the element type, give a name, choose a different icon, etc. {width="600"} Map element attributes: |Parameter|Description| |--|--------| |*Type*|Type of the element:<br>**Host** - icon representing status of all triggers of the selected host<br>**Map** - icon representing status of all elements of a map<br>**Trigger** - icon representing status of one or more triggers<br>**[Host group](/manual/config/visualization/maps/host_groups)** - icon representing status of all triggers of all hosts belonging to the selected group<br>**Image** - an icon, not linked to any resource| |*Label*|Icon label, any string.<br>Macros and multiline strings can be used.<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>For a full list of supported macros, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map element labels'.| |*Label location*|Label location in relation to the icon:<br>**Default** - map's default label location<br>**Bottom** - beneath the icon<br>**Left** - to the left<br>**Right** - to the right<br>**Top** - above the icon| |*Host*|Enter the host if the element type is 'Host'. 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.| |*Map*|Select the map if the element type is 'Map'. This field is auto-complete so starting to type the name of a map will offer a dropdown of matching maps. Scroll down to select. Click on 'x' to remove the selected.| |*Triggers*|If the element type is 'Trigger', select one or more triggers in the *New triggers* field below and click on *Add*.<br>The order of selected triggers can be changed, but only within the same severity of triggers. Multiple trigger selection also affects {HOST.\*} macro resolution both in the construction and view modes.<br>In construction mode, the first displayed {HOST.\*} macros will be resolved depending on the first trigger in the list (based on trigger severity).<br>View mode depends on the [Display problems](/manual/config/visualization/maps/map#creating_a_map) parameter in General map attributes:<br>- If *Expand single problem* mode is chosen, the first displayed {HOST.\*} macros will be resolved depending on the latest detected problem trigger (not mattering the severity) or the first trigger in the list (in case no problem detected).<br>- If *Number of problems and expand most critical one* mode is chosen, the first displayed {HOST.\*} macros will be resolved depending on the trigger severity.<br>| |*Host group*|Enter the host group if the element type is 'Host group'. 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.| |*Tags*|Specify 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<br>This field is available for host and host group element types.| |*Automatic icon selection*|In this case an icon mapping will be used to determine which icon to display.| |*Icons*|You can choose to display different icons for the element in these cases: default, problem, maintenance, disabled.| |*Coordinate X*|X coordinate of the map element.| |*Coordinate Y*|Y coordinate of the map element.| |*URLs*|Element-specific URLs can be set for the element. These will be displayed as links when a user clicks on the element in the map viewing mode. If the element has its own URLs and there are map level URLs for its type defined, they will be combined in the same menu.<br>Macros can be used in map element names and values. For a full list, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map URL names and values'.| ::: noteimportant Added elements are not automatically saved. If you navigate away from the page, all changes may be lost. Therefore, it is a good idea to click on the **Update** button in the upper-right corner. Once clicked, the changes are saved regardless of what you choose in the following popup. Selected grid options are also saved with each map. ::: #### Добавление элементов Для добавления элемента, нажмите на ссылку *Добавить (Add)* после `Элемент карты сети (Map element)`. Новый элемент появится в левом верхнем углу карты. Перетащите его туда, куда бы вам хотелось. Обратите внимание, что с «Вкл» опцией Сетки элементы будут всегда выравниваться по сетке (вы можете выбрать различные размеры сетки из выпадающего списка, а также скрыть/показать сетку). Если вы хотите разместить элементы где-либо без выравнивания, переключите опцию в «Выкл». (Элементы, расположенные произвольным образом, можно в дальнейшем снова выровнять по сетке, нажав на *Выровнять элементы карты (Align map elements)*). Теперь у вас есть несколько размещённых элементов, вы можете захотеть начать различать их, дав имена и т.п. При нажатии на элемент отобразится диалог и вы сможете задать тип элемента, дать имя, выбрать другую иконку и так далее. {width="600"} Атрибуты элементов карт сетей: |Параметр|Описание| |--|--------| |*Тип*<br>*(Type)*|Тип элемента:<br>**Узел сети (Host)** — иконка, отображающая состояние всех триггеров у выбранного узла сети<br>**Карта сети (Map)** — иконка, отображающая состояние всех элементов карты<br>**Триггер (Trigger)** — иконка, отображающая состояние одного или нескольких триггеров<br>**[Группа узлов сети (Host group)](/manual/config/visualization/maps/host_groups)** — иконка, отображающая состояние всех триггеров на всех узлах сети в выбранной группе узлов сети<br>**Изображение (Image)** — иконка, не связанная с каким-либо ресурсом| |*Подпись*<br>*(Label)*|Подпись к иконке, любая строка.<br>Могут использоваться макросы и запись в несколько строк.<br>В этом поле поддерживаются [макросы](/manual/appendix/macros/supported_by_location) выражений, но только с функциями `avg`, `last`, `min` и `max`, со временем в качестве параметра (например, `{?avg(/узел сети/ключ,1h)}`).<br>Для просмотра полного списка макросов смотрите [поддерживаемые макросы](/manual/appendix/macros/supported_by_location), ищите «подписи к элементам карты».| |*Расположение подписи*<br>*(Label location)*|Расположение подписи по отношению к иконке:<br>**По умолчанию (Default)** — расположение подписи, как задано по умолчанию для этой карты сети<br>**По нижнему краю (Bottom)** — ниже иконки<br>**По левой стороне (Left)** — слева<br>**По правой стороне (Right)** — справа<br>**По верхнему краю (Top)** — выше иконки| |*Узел сети*<br>*(Host)*|Введите узел сети, если тип элемента «Узел сети». Это поле с функцией автодополнения, так что после начала ввода имени узла сети будет автоматически предложен список совпадающих узлов сети в выпадающем меню. Прокрутите список, чтобы выбрать необходимый. Нажмите на «х», чтобы удалить выбранный.| |*Карта сети*<br>*(Map)*|Выберите карту сети, если тип элемента «Карта сети». Это поле с функцией автодополнения, так что после начала ввода имени карты сети будет автоматически предложен список совпадающих карт сети в выпадающем меню. Прокрутите список, чтобы выбрать необходимую. Нажмите на «х», чтобы удалить выбранную.| |*Триггер*<br>*(Triggers)*|Если тип элемента — «Триггер», выберите один или больше триггеров в поле *Новые триггеры (New triggers)* ниже и нажмите на *Добавить (Add)*.<br>Порядок выбранных триггеров можно изменить, но только в пределах одной важности триггеров. Выбор нескольких триггеров также влияет на раскрытие макроса {HOST.\*}, как в режиме построения, так и в режиме просмотра.<br>В режиме построения первый отображаемый макрос {HOST.\*} раскрывается в зависимости от первого триггера в списке (на основании важности триггера).<br>Режим просмотра зависит от параметра [Отображение проблем](/manual/config/visualization/maps/map#создание-карты-сети) в Общих атрибутах карты:<br>- Если выбран режим *Развертывание одиночной проблемы*, первый отображаемый макрос {HOST.\*} раскрывается в зависимости от последнего обнаруженного триггера с проблемой (независимо от важности) или первого триггера в списке (при отсутствии проблем);<br>- Если выбран режим *Количество проблем и раскрывать наиболее критичную*, первый отображаемый макрос {HOST.\*} раскрывается в зависимости от важности триггера.| |*Группа узлов сети*<br>*(Host group)*|Выберите группу узлов сети, если тип элемента «Группа узлов сети». Это поле с функцией автодополнения, так что после начала ввода имени группы узлов сети, будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню. Прокрутите список, чтобы выбрать необходимую. Нажмите на «х», чтобы удалить выбранную.| |*Теги*<br>*(Tags)*|Выберите теги, чтобы ограничить количество проблем, отображаемых в виджете. Имеется возможность как включить, так и исключить конкретные теги и значения тегов. Можно указать несколько условий. Поиск соответствия имен тегов всегда чувствителен к регистру.<br>По каждому условию доступно несколько операторов:<br>**Существует (Exists)** — включить указанные имена тегов<br>**Равно (Equals)** — включить указанные имена тегов и их значения (с учётом регистра)<br>**Содержит (Contains)** — включить указанные имена тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>**Не существует (Does not exist)** — исключить указанные имена тегов<br>**Не равно (Does not equal)** — исключить указанные имена тегов и их значения (с учётом регистра)<br>**Не содержит (Does not contain)** — исключить имена указанных тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>Для условий имеется два типа вычислений:<br>**И/Или (And/Or)** — все условия должны соблюдаться, условия с одинаковыми именами тегов будут сгруппированы с условием Или<br>**Или (Or)** — достаточно соблюдения одного условия<br>Это поле доступно для типов элементов «узел сети» и «группа узлов сети».| |*Автоматический выбор иконки*<br>*(Automatic icon selection)*|В этом случае соответствие иконок будет определять, какую иконку отображать.| |*Иконки*<br>*(Icons)*|Вы можете выбрать разные иконки для отображения элемента для следующих случаев: по умолчанию, проблема, обслуживание, деактивирован.| |*Координата X*<br>*(Coordinate X)*|Координата X элемента карты сети.| |*Координата Y*<br>*(Coordinate Y)*|Координата Y элемента карты сети.| |*URL'ы*<br>*(URLs)*|URL'ы можно указать для каждого отдельного элемента. Они будут отображаться в виде ссылок, когда пользователь нажмёт на элементе в режиме просмотра карты. Если элемент имеет собственные URL'ы, а также URL'ы уровня карты сети для его типа элемента, то ссылки будут объединены в одно меню.<br>В именах и значениях для элемента карты могут использоваться макросы. Смотрите полный список [поддерживаемых макросов](/manual/appendix/macros/supported_by_location), ищите «Имена и значения URL на картах».| ::: noteimportant Добавленные элементы не сохраняются автоматически. Если вы покинете эту страницу, все изменения могут быть потеряны. Поэтому будет хорошей идеей нажать на кнопке **Обновить (Update)** в правом верхнем углу. При нажатии все изменения сохраняются независимо от того, что вы выберете в дальнейшем во всплывающем окне. Выбранные опции сетки также сохраняются для каждой карты сети. ::: ##### 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 Если обнаружение выполняется через прокси, в настоящее время преобразование имени хоста (hostname lookup) по-прежнему происходит на Zabbix сервере. ::: ::: noteimportant Если узел сети с таким же именем, как и только что обнаруженный, уже существует в конфигурации Zabbix, то версии Zabbix до 1.8 могли добавить другой узел сети с таким же именем. Zabbix 1.8.1 и более поздние добавят **\_N** к имени узла сети, где **N** — возрастающее число, начиная с 2. ::: #### Adding host Information about configured hosts in Zabbix is available in *Configuration → Hosts* as well as *Monitoring* → *Hosts*. There is already one pre-defined host, called "Zabbix server", but we want to learn adding another. To add a new host, click on *Create host*. This will present us with a host configuration form.  All mandatory input fields are marked with a red asterisk. The bare minimum to enter here is: ***Host name*** - Enter a host name. Alphanumerics, spaces, dots, dashes and underscores are allowed. ***Groups*** - Select one or several existing groups by clicking *Select* button or enter a non-existing group name to create a new group. ::: noteclassic All access permissions are assigned to host groups, not individual hosts. That is why a host must belong to at least one group. ::: ***Interfaces: IP address*** - Although not a required field technically, a host interface is necessary for collecting certain metrics. To use Zabbix agent passive checks, specify the agent's IP or DNS in this field. Note that you should also specify Zabbix server's IP or DNS in the Zabbix agent configuration file 'Server' directive. If Zabbix agent and Zabbix server are installed on the same machine, you need to specify the same IP/DNS in both places. [Other options](/manual/config/hosts/host#configuration) can be left at their defaults for now. When done, click *Add*. Your new host should be visible in the host list. {width="600"} The Availability column contains indicators of host availability per each interface. You have defined a Zabbix agent interface, so you can use the agent availability icon (with "ZBX" on it) to understand the host availability: -  - host status has not been established; no metric check has happened yet -  - host is available, a metric check has been successful -  - host is unavailable, a metric check has failed (move your mouse cursor over the icon to see the error message). There might be some error with communication, possibly caused by incorrect interface credentials. Check that Zabbix server is running, and try refreshing the page later as well. #### Добавление узла сети Информация о настроенных узлах сети в Zabbix доступна в *Настройка → Узлы сети (Configuration → Hosts)*, а также в *Мониторинг* → *Узлы сети (Monitoring* → *Hosts)*. Уже существует один предустановленный узел сети, называемый «Zabbix server», но мы хотим узнать, как добавить ещё один узел сети. Для добавления нового узла сети нажмите *Создать узел сети (Create host)*. Это действие покажет нам диалог настройки узла сети.  Все обязательные поля ввода отмечены красной звёздочкой. Введите здесь, как минимум: ***Имя узла сети (Host name)*** - Введите имя узла сети. Допускаются буквенно-цифровые символы, пробелы, точки, тире и подчёркивания. ***Группы (Groups)*** - Выберите одну или несколько существующих групп, нажав на кнопку *Выбор*, или введите имя несуществующей группы, чтобы создать новую. ::: noteclassic Все права доступа назначаются на группы узлов сети, не индивидуально узлам сети. Поэтому узел сети должен принадлежать хотя бы одной группе. ::: ***Интерфейсы: IP адрес (Interfaces: IP address)*** - Хотя технически это поле не является обязательным, интерфейс узла сети необходим для получения определённых метрик. Чтобы использовать пассивные проверки Zabbix агента, укажите в этом поле IP адрес или DNS имя агента. Обратите внимание, что необходимо также указать IP адрес или DNS имя Zabbix сервера в файле конфигурации Zabbix агента в параметре «Server». Если Zabbix агент и Zabbix сервер установлены на той же машине, нужно указать те же IP/DNS в обоих местах. [Остальные опции](/manual/config/hosts/host#настройка) пока подойдут нам по умолчанию. Когда закончите, нажмите на *Добавить (Add)*. Ваш новый узел сети должен быть виден в списке узлов сети. {width="600"} Колонка *Доступность (Availability)* содержит индикаторы доступности узла сети по каждому интерфейсу. Мы задали интерфейс Zabbix агента, поэтому для понимания доступности узла сети мы можем использовать значок доступности агента (с подписью «ZBX»): -  — состояние узла сети не определено; проверка метрик ещё не осуществлялась -  — узел сети доступен, проверка метрик успешно выполнена -  — узел сети недоступен, проверка метрик завершилась с ошибкой (наведите указатель мыши на значок, чтобы увидеть текст ошибки). Возможно, произошла какая-то ошибка соединения, например, вызванная некорректно заданными учётными данными интерфейса. Проверьте, что Zabbix сервер запущен, и также попытайтесь обновить страницу позже. #### Adding hosts to host groups Add two hosts to host groups with IDs 5 and 6. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massadd", "params": { "groups": [ { "groupid": "5" }, { "groupid": "6" } ], "hosts": [ { "hostid": "30050" }, { "hostid": "30001" } ] }, "auth": "f223adf833b2bf2ff38574a67bba6372", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Добавление узла сети в группу узлов сети Добавить два узла сети в группы узлов сети с ID 5 и 6. Запрос: ```json { "jsonrpc": "2.0", "method": "hostgroup.massadd", "params": { "groups": [ { "groupid": "5" }, { "groupid": "6" } ], "hosts": [ { "hostid": "30050" }, { "hostid": "30001" } ] }, "auth": "f223adf833b2bf2ff38574a67bba6372", "id": 1 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Adding item All items are grouped around hosts. That is why to configure a sample item we go to *Configuration → Hosts* and find the 'New host' we have created. Click on the *Items* link in the row of 'New host', and then click on *Create item*. This will present us with an item configuration form.  All mandatory input fields are marked with a red asterisk. For our sample item, the essential information to enter is: ***Name*** - Enter *CPU load* as the value. This will be the item name displayed in lists and elsewhere. ***Key*** - Manually enter *system.cpu.load* as the value. This is the technical name of an item that identifies the type of information that will be gathered. The particular key is just one of [pre-defined keys](/manual/config/items/itemtypes/zabbix_agent) that come with Zabbix agent. ***Type of information*** - This attribute defines the format of the expected data. For the *system.cpu.load* key, this field will be automatically set to *Numeric (float)*. ::: noteclassic You may also want to reduce the number of days [item history](/manual/config/items/history_and_trends) will be kept, to 7 or 14. This is good practice to relieve the database from keeping lots of historical values. ::: [Other options](/manual/config/items/item#configuration) will suit us with their defaults for now. When done, click *Add*. The new item should appear in the item list, and you should see a success message.  #### Добавление элемента данных Все элементы данных группируются вокруг узлов сети. Именно поэтому для настройки замеряемого элемента данных мы перейдем в *Настройки* → *Узлы сети (Configuration → Hosts)* и найдём «Новый узел сети», который мы ранее создали. Нажмите на ссылке *Элементы данных (Items)* в строке напротив «Новый узел сети» и затем нажмите на *Создать элемент данных (Create item)*. Отобразится диалог создания элемента данных.  Все обязательные поля ввода отмечены красной звёздочкой. Введите информацию, необходимую для нашего примера элемента данных: ***Имя (Name)*** - Введите значение *Загрузка CPU*. Это имя будет отображаться как имя элемента данных в списках и в других местах. ***Ключ (Key)*** - Вручную введите значение *system.cpu.load*. Это техническое имя элемента данных, которое идентифицирует тип информации, которая будет собираться. Этот ключ является лишь одним из [предопределённых ключей](/manual/config/items/itemtypes/zabbix_agent), которые поставляются с Zabbix агентом. ***Тип информации (Type of information)*** - Этот атрибут определяет формат ожидаемых данных. Для ключа *system.cpu.load* этот поле автоматически примет значение *Числовой (с плавающей точкой) (Numeric (float))*. ::: noteclassic Вы также можете захотеть уменьшить количество дней хранения [истории элемента данных](/manual/config/items/history_and_trends), до 7 или 14. Это хорошая практика для уменьшения размера базы данных при хранении большого количества значений истории. ::: [Остальные опции](/manual/config/items/item#настройка) в данный момент подойдут нам по умолчанию. Когда завершите, нажмите на *Добавить (Add)*. Новый элемент данных должен появиться в списке элементов данных, и вы должны увидеть сообщение об успешном завершении.  #### Adding items, triggers, graphs There are two ways to add items to the template: 1. To create new items, follow the guidelines for [Creating an item](/manual/config/items/item). 2. To add existing items to the template: - Go to *Configuration → Hosts* (or *Templates*). - Click on *Items* in the row of the required host/template. - Mark the checkboxes of items you want to add to the template. - Click on *Copy* below the item list. - Select the template (or group of templates) the items should be copied to and click on *Copy*.<br> All the selected items should be copied to the template. Adding triggers and graphs is done in a similar fashion (from the list of triggers and graphs respectively), again, keeping in mind that they can only be added if the required items are added first. #### Добавление элементов данных, триггеров, графиков Есть два способа добавить элементы данных в шаблон: 1. Чтобы создать новые элементы данных, следуйте правилам для [создания элемента данных](/manual/config/items/item). 2. Чтобы добавить к шаблону существующие элементы данных: - Перейдите в *Настройка → Узлы сети (Configuration → Hosts)* (или *Шаблоны (Templates)*) - Нажмите на *Элементы данных (Items)* в строке с требуемым узлом сети / шаблоном - Отметьте элементы данных, которые вы хотите добавить в шаблон - Нажмите на *Копировать (Copy)* ниже списка элементов данных - Выберите шаблон (или группу шаблонов), в который необходимо скопировать элементы данных, и нажмите на *Копировать (Copy)*.<br> Все выбранные элементы данных должны будут скопироваться в шаблон. Добавление триггеров и графиков осуществляется похожим образом (из списка триггеров и графиков соответственно), опять же, имейте ввиду, что их можно добавить только после того, как сначала будут добавлены требуемые элементы данных. #### 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). #### Добавление элемента данных в шаблон Для добавления элемента данных в шаблон, перейдите к списку элементов данных узла сети «Новый узел сети». В *Настройки → Узлы сети* нажмите на *Элементы данных* напротив «Новый узел сети». Затем: - отметьте флажком элемент данных «Загрузка CPU» из списка - нажмите *Копировать* ниже списка - выберите шаблон, в который скопировать элемент данных  Все обязательные поля ввода отмечены красной звёздочкой. - нажмите на *Копировать* Если вы сейчас перейдете в *Настройка → Шаблоны*, вы должны увидеть «Новый шаблон» с одним элементом данных. Сейчас мы остановимся на одном элементе данных, но вы можете аналогичным образом добавить любые другие элементы данных, триггеры и другие сущности в шаблон, пока он не станет достаточно заполнен набором объектов для конкретных целей (мониторинг ОС, мониторинг одного приложения). ##### Adding JMX agent item For each JMX counter you are interested in you add **JMX agent** item attached to that interface. The key in the screenshot below says `jmx["java.lang:type=Memory","HeapMemoryUsage.used"]`.  All mandatory input fields are marked with a red asterisk. The fields that require specific information for JMX items are: | | | |--|--------| |*Type*|Set **JMX agent** here.| |*Key*|The `jmx[]` item key contains three parameters:<br>**object name** - the object name of an MBean<br>**attribute name** - an MBean attribute name with optional composite data field names separated by dots<br>**unique short description** - a unique description that allows multiple JMX items with the same object name and attribute name on the host (optional)<br>See below for more detail on JMX item keys.<br>Since Zabbix 3.4, you may discover MBeans and MBean attributes using a `jmx.discovery[]` [low-level discovery](/manual/discovery/low_level_discovery/examples/jmx) item.| |*JMX endpoint*|You may specify a custom JMX endpoint. Make sure that JMX endpoint connection parameters match the JMX interface. This can be achieved by using {HOST.\*} macros as done in the default JMX endpoint.<br>This field is supported since 3.4.0. {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) and user macros are supported.| |*User name*|Specify the user name, if you have configured authentication on your Java application.<br>User macros are supported.| |*Password*|Specify the password, if you have configured authentication on your Java application.<br>User macros are supported.| If you wish to monitor a Boolean counter that is either "true" or "false", then you specify type of information as "Numeric (unsigned)" and select "Boolean to decimal" preprocessing step in the Preprocessing tab. Server will store Boolean values as 1 or 0, respectively. ##### Добавление элемента данных JMX агента Для каждого интересующего вас счётчика JMX необходимо добавить элемент данных с типом **JMX агент**, присоединённый к этому интерфейсу. Ключ на снимке экрана ниже имеет следующий вид: `jmx["java.lang:type=Memory","HeapMemoryUsage.used"]`.  Все обязательные поля ввода отмечены красной звёздочкой. Поля, требующие информации, специфичной для JMX элементов данных: | | | |--|--------| |*Тип (Type)*|Укажите здесь **JMX агент**.| |*Ключ (Key)*|Ключ элемента данных `jmx[]` содержит три параметра:<br>**имя объекта** — имя объекта MBean;<br>**имя атрибута** — имя атрибута MBean с опциональными составными именами полей данных, разделённых точками.<br>**уникальное короткое описание** — уникальное описание, которое позволит создать на одном узле сети несколько JMX элементов данных с одинаковыми именем объекта и именем атрибута (опционально)<br>Подробнее о ключах JMX элементов данных смотрите ниже.<br>Начиная с Zabbix 3.4, вы можете обнаруживать MBeans и MBean атрибуты, используя элемент данных [низкоуровневого обнаружения](/manual/discovery/low_level_discovery/examples/jmx) `jmx.discovery[]`.| |*JMX endpoint*|Вы можете указать пользовательский JMX endpoint. Убедитесь, что параметры подключения JMX endpoint совпадают с JMX интерфейсом. Это можно сделать при помощи макросов {HOST.\*}, как уже сделано в JMX endpoint по умолчанию.<br>Это поле поддерживается, начиная с версии 3.4.0. Поддерживаются [макросы](/manual/appendix/macros/supported_by_location) {HOST.\*} и пользовательские макросы.| |*Имя пользователя*<br>*(User name)*|Укажите имя пользователя, если вы настроили аутентификацию у вашего Java приложения.<br>Поддерживаются пользовательские макросы.| |*Пароль*<br>*(Password)*|Укажите пароль, если вы настроили аутентификацию у вашего Java приложения.<br>Поддерживаются пользовательские макросы.| Если вы хотите наблюдать за логическим счётчиком, который может иметь значение «true» или «false», укажите тип информации «Числовой (целое положительное)» и добавьте шаг предварительной обработки «Логический в десятичный» на вкладке Предобработка. Сервер будет сохранять логические значения как 1 или 0, соответственно. #### 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)* после Фигуры (Shape). Появится новая фигура в верхнем левом углу карты. Выберите ее и нажмите на *Линия (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 Запрос: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "lld_macro_paths": [ { "lld_macro": "{#MACRO1}", "path": "$.json.path" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` #### Adding macros Add two new macros to two hosts. Request: ```json { "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: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10160", "10167" ] }, "id": 1 } ``` #### Добавление макросов Добавить два новых макроса на два хоста. Запрос: ```json { "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 } ``` Ответ: ```json { "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. #### Добавление страниц Чтобы добавить к панели нову страницу: - Убедитесь, что панель находится в [режиме редактирования](#просмотр-и-редактирование-панели) - Нажмите на стрелку рядом с кнопкой *Добавить (Add)* и выберите опцию *Добавить страницу (Add page)*  - Заполните общие параметры страницы и нажмите на *Применить (Apply)*. Если вы оставите имя пустым, страница добавится с именем `Страница N` (`Page N`), где 'N' - возрастающий номер страницы. Период отображения страницы позволяет настроить длительность отображения страницы в слайд-шоу.  Добавится новая страница, обозначаемая новой вкладкой (*Страница 2*, *Page 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), a не индивидуально пользователям. ::: Готово! Теперь вы можете попробовать выполнить вход под этим новым пользователем. ##### 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: - Перейдите к: *Администрирование → Прокси (Administration → Proxies)* - Нажмите на *Создать прокси (Create proxy)* {width="600"} |Параметр|<|Описание| |-|----------|----------------------------------------| |*Имя прокси*<br>*(Proxy name)*|<|Введите имя прокси. Оно должно совпадать с именем параметра *Hostname* в файле конфигурации прокси.| |*Режим прокси*<br>*(Proxy mode)*|<|Выберите режим прокси.<br>**Активный (Active)** — прокси будет подключаться к Zabbix серверу и запрашивать данные конфигурации<br>**Пассивный (Passive)** — Zabbix сервер будет подключаться к прокси<br>*Обратите внимание*, что при использовании активного прокси без шифрованных коммуникаций (конфиденциальные) данные конфигурации прокси могут стать доступны лицам, имеющим доступ к порту траппера Zabbix сервера. Такое возможно потому, что, если аутентификация не выполняется или адреса прокси не ограничены в поле *Адрес прокси*, то кто угодно может представиться активным прокси и запросить данные конфигурации.| |*Адрес прокси*<br>*(Proxy address)*|<|Если задано значение, тогда запросы активного прокси принимаются только из этого списка разделённых запятыми IP адресов, опционально в CIDR нотации, или DNS имён активных Zabbix прокси.<br>Это поле доступно, только если в поле *Режим прокси* выбран активный прокси. Макросы не поддерживаются.<br>Эта опция поддерживается с версии Zabbix 4.0.0.| |*Интерфейс*<br>*(Interface)*|<|Укажите детали интерфейса для пассивного прокси.<br>Это поле доступно, только если в поле *Режим прокси* выбран пассивный прокси.| | |*IP адрес*<br>*(IP address)*|IP адрес пассивного прокси (опционально).| |^|*DNS имя*<br>*(DNS name)*|DNS имя пассивного прокси (опционально).| |^|*Подключение через*<br>*(Connect to)*|Нажав соответствующую кнопку, вы сообщите Zabbix серверу, что использовать для получения данных с прокси:<br>**IP** — Подключение к прокси по IP адресу (рекомендуется)<br>**DNS** — Подключение к прокси по DNS имени| |^|*Порт (Port)*|Номер TCP порта пассивного прокси (по умолчанию 10051).| |*Описание (Description)*|<|Введите описание прокси.| Вкладка **Шифрование** позволяет вам требовать шифрованных соединений с прокси. |Параметр|Описание| |--|--------| |*Подключения к прокси*<br>*(Connections to proxy)*|Каким образом сервер подключается к пассивному прокси: без шифрования (по умолчанию), используя PSK (pre-shared key) или сертификат.| |*Соединения с прокси*<br>*(Connections from proxy)*|Выберите, какой тип подключений разрешён с активного прокси. Можно выбрать несколько типов соединений одновременно (полезно при тестировании и переключении на другой тип соединения). По умолчанию — «Без шифрования».| |*Издатель*<br>*(Issuer)*|Разрешённый эмитент сертификата. Сертификат сначала подтверждается CA (центром сертификации). Если он действительный, подписан с помощью CA, тогда можно использовать поле *Издатель* для более строгого ограничения разрешённых CA. Это поле опционально, предназначено для использования, если ваша Zabbix инсталляция использует сертификаты от нескольких CA.| |*Тема*<br>*(Subject)*|Разрешённая тема сертификата. Сертификат сначала подтверждается CA. Если он действительный, подписан с помощью CA, тогда можно использовать поле *Тема*, чтобы разрешить только одно значение строки *Тема*. Если поле пустое, тогда принимается любой сертификат, подписанный настроенным CA.| |*Идентификатор PSK*<br>*(PSK identity)*|Строка идентификации pre-shared key.<br>Не помещайте чувствительную информацию в идентификатор PSK, для информирования принимающей стороны об используемом PSK он передаётся по сети в нешифрованном виде.| |*PSK*|Pre-shared key (строка в шестнадцатеричном формате). Максимальная длина: 512 шестнадцатеричных цифр (256-байт PSK), если Zabbix использует библиотеки GnuTLS или OpenSSL, 64 шестнадцатеричных цифры (32-байт PSK), если Zabbix использует библиотеку mbed TLS (PolarSSL). Пример: 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). #### Добавление фигур В дополнение к элементам карты имеется также возможность добавления некоторых фигур. Фигуры не являются элементами карты; это просто визуальное представление. Например, фигуру прямоугольника можно использовать в качестве фона для группировки нескольких узлов сети. Можно добавлять фигуры прямоугольников и эллипсов. Для добавления фигуры нажмите на *Добавить (Add)* после Фигуры (Shape). Новая фигура появится в верхнем левом углу карты. Перетащите её куда хотите. Новая фигура добавляется с цветами по умолчанию. При нажатии на фигуру отобразится диалог, и вы сможете настроить внешний вид фигуры, добавить текст и т.д. {width="600"} Чтобы выбрать несколько фигур, выберите сначала одну и затем, удерживая нажатым *Ctrl*, выберите остальные. При выборе нескольких фигур можно будет массово обновить общие свойства, аналогично элементам карты. К фигурам можно добавлять текст. В тексте поддерживаются [макросы](/manual/appendix/macros/supported_by_location) выражений, но только с функциями `avg`, `last`, `min` и `max`, со временем в качестве параметра (например, `{?avg(/узел сети/ключ,1h)}`). Чтобы отображался только текст, фигуру можно сделать невидимой, удалив рамку фигуры (выберите «нет» в поле *Рамка*). Например, обратите внимание на то, что макрос {MAP.NAME}, видимый на рисунке сверху, на самом деле представляет из себя фигуру с текстом, который можно увидеть при нажатии на макрос:  {MAP.NAME} при просмотре раскрывается в заданное имя карты. Если в тексте используются гиперссылки, они будут доступны для нажатия при просмотре карты. Перенос строк для теста всегда «включён» в пределах фигур. Однако, внутри эллипса, строки переносятся так, как если бы эллипс был прямоугольником. Перенос слов не реализован, поэтому длинные слова (слова, которые не помещаются в фигуру) не переносятся, но маскируются (на странице конструктора) или обрезаются (на других страницах с картами). #### Adding template To start working with templates, we must first create one. To do that, in *Configuration → Templates* click on *Create template*. This will present us with a template configuration form.  All mandatory input fields are marked with a red asterisk. The required parameters to enter here are: ***Template name*** - Enter a template name. Alpha-numericals, spaces and underscores are allowed. ***Groups*** - Select one or several groups by clicking *Select* button. The template must belong to a group. When done, click *Add*. Your new template should be visible in the list of templates. {width="600"} As you may see, the template is there, but it holds nothing in it - no items, triggers or other entities. #### Добавление шаблона Для начала работы с шаблонами мы первым делом должны его создать. Чтобы это сделать, перейдите в *Настройка → Шаблоны (Configuration → Templates)* и нажмите на *Создать шаблон (Create template)*. Так мы увидим диалог настройки шаблона.  Все обязательные поля ввода отмечены красной звёздочкой. Обязательными параметрами здесь являются: ***Имя шаблона (Template name)*** - Введите имя шаблона. Допускаются буквенно-цифровые символы, пробелы и подчёркивания. ***Группы (Groups)*** - Выберите одну или несколько групп, нажав на кнопку *Выбор (Select)*. Шаблон должен принадлежать какой-либо группе. Когда завершите, нажмите на *Добавить (Add)*. Ваш новый шаблон должен появиться в списке шаблонов. {width="600"} Как вы можете видеть, шаблон есть, но он ничего в себе не содержит — нет элементов данных, триггеров и других сущностей. #### Adding trigger To configure a trigger for our item, go to *Configuration → Hosts*. Click on the *Triggers* link in the row of 'New host', and then click on *Create trigger*. This will present us with a trigger configuration form.  For our trigger, the essential information to enter here is: *Name* - Enter *CPU load too high on 'New host' for 3 minutes* as the value. This will be the trigger name displayed in lists and elsewhere. *Expression* - Enter: avg(/New host/system.cpu.load,3m)>2 This is the trigger expression. Make sure that the expression is entered right, down to the last symbol. The item key here (system.cpu.load) is used to refer to the item. This particular expression basically says that the problem threshold is exceeded when the CPU load average value for 3 minutes is over 2. You can learn more about the [syntax of trigger expressions](/manual/config/triggers/expression). When done, click *Add*. The new trigger should appear in the trigger list. #### Добавление триггера Для настройки триггера для нашего элемента данных перейдите в *Настройка → Узлы сети (Configuration → Hosts)*. Нажмите на ссылку *Триггеры (Triggers)* в строке напротив «Новый узел сети» и затем нажмите на *Создать триггер (Create trigger)*. Отобразится диалог настроек триггера.  Введите здесь необходимую для нашего триггера информацию: *Имя (Name)* - Введите значение *Загрузка CPU слишком высокая у 'Новый узел сети' в течение 3 минут*. Это будет имя триггера, которое будет отображаться в списках и в других местах. *Выражение (Expression)* - Введите: avg(/New host/system.cpu.load,3m)>2 Это выражение триггера. Убедитесь, что выражение введено верно, вплоть до последнего символа. Здесь ключ элемента данных (system.cpu.load) используется для ссылки на элемент данных. По-простому данное выражение говорит, что порог проблемы превышается, когда значение средней загрузки CPU в течение 3 минут превышает 2. Вы можете узнать больше о [синтаксисе выражений триггеров](/manual/config/triggers/expression). Когда завершите, нажмите на *Добавить (Add)*. Этот новый триггер должен появиться в списке триггеров. #### 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), например: «Zabbix администраторы».  Все обязательные поля ввода отмечены красной звёздочкой. По умолчанию у новых пользователей нет добавленных способов оповещения (методов отправки уведомлений). Для их создания перейдите на вкладку «Способы оповещения» и нажмите *Добавить*.  В этом всплывающем окне введите для пользователя его e-mail адрес. Вы можете указать период времени, когда этот способ будет активен (смотрите страницу [Спецификаций периодов времени](/manual/appendix/time_period) для получения сведений о формате), по умолчанию способ активен всегда. Вы также можете настроить [важность триггера](/manual/config/triggers/severity), для которого способ оповещения будет использоваться, но сейчас оставьте всё включённым. Нажмите *Добавить*, чтобы сохранить способ оповещения и перейдите на вкладку *Разрешения*. На вкладке разрешений есть обязательное поле *Роль*. Роль определяет, какие элементы интерфейса пользователь может просматривать и какие действия ему разрешено выполнять. Нажмите *Выбрать* и выберите одну из ролей из списка. Например, выберите *Роль администратора*, чтобы разрешить доступ ко всем разделам веб-интерфейса 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) #### Добавление веб-сценариев Чтобы добавить веб-сценарии в шаблон в *Настройка → Шаблоны (Configuration → Templates)*, сделайте следующее: - Нажмите на *Веб (Web)* в строке с шаблоном - Настройте веб-сценарий следуя обычному способу [настройки веб-сценариев](/manual/web_monitoring#настройка_веб_сценария) #### 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 A wide variety of [widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) (e.g. [Clock](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/clock), [Host availability](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/host_availability) or [Trigger overview](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/trigger_overview)) can be added to a dashboard: these can be resized and moved around the dashboard in dashboard editing mode 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. #### Добавление виджетов Для добавления виджета на панель: - Нажмите на кнопку  *(Добавить)* или опцию *Добавить виджет* в меню действий, открывающееся при нажатии на стрелку вниз. Заполните диалог настроек виджета. Виджет будет создан со своим размером по умолчанию и помещён после существующих виджетов (если они есть); Или - Переместите курсор мыши на желаемый для нового виджета пустой участок. Обратите внимание, как при наведении курсора мыши на любой пустой участок панели появляется символ-заполнитель. Затем щёлкните кнопкой мыши, чтобы открыть диалог настроек виджета. После заполнения диалога виджет будет создан со своим размером по умолчанию или, если его размер по умолчанию больше чем доступно, займёт доступное место. Как альтернативный вариант, вы можете нажать кнопку мыши, не отпуская её, растянуть символ-заполнитель до желаемого размера, затем отпустить кнопку мыши, а затем заполнить диалог настроек виджета. (Обратите внимание, что если имеется виджет, скопированный в буфер обмена, то для создания виджета сначала вам будет предложено выбрать между опциями *Добавить виджет* и *Вставить виджет*.)   В диалоге настроек виджета: - Выберите *Тип* виджета - Введите параметры виджета - Нажмите на *Добавить*  #### Виджеты Для добавления на панель доступен большой выбор [виджетов](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) (например, [Часы](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/clock), [Доступность узла сети](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/host_availability) или [Обзор триггеров](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/trigger_overview)): они могут быть отмасштабированы и перемещены в пределах панели в режиме редактирования панели при помощи нажатия на полосу заголовка виджета и перетаскивания его на новое место. Также, вы можете нажать на следующие кнопки в правом верхнем углу виджета, чтобы: -  - изменить виджет; -  - получить доступ к [меню виджета](#меню-виджетов) Нажмите на *Сохранить изменения* у панели, чтобы закрепить любые изменения виджетов. ### 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' Пожалуйста, обратите внимание, процессу веб-сервиса Zabbix, который используется для [генерации отчётов по расписанию](/manual/web_interface/frontend_sections/reports/scheduled), требуется браузер 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. ##### Дополнительные параметры Третий необязательный параметр поддерживается функцией *bucket\_rate\_foreach*: bucket_rate_foreach(фильтр_элементов_данных,период_времени,<номер_параметра>) где <номер_параметра> — это положение значения «разряд» в ключе элемента данных. Например, если в myItem\[aaa,0.2\] значением «разряд» является «0.2», то его положение — это 2. Значением по умолчанию для <номера параметра> является «1». Смотрите [агрегированные вычисления](/manual/config/items/itemtypes/calculated/aggregate) для более подробной информации и примеров использования функций foreach. #### 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 как часть ключа элемента данных. Эти опции поддерживаются только при использовании libssh версии 0.9.0 и выше либо libssh2. Поддерживаемые ключи и значения опций зависят от библиотеки SSH. Для более подробной информации смотрите [Проверки SSH](/manual/config/items/itemtypes/ssh_checks). #### Advanced configuration Advanced configuration options become available if the *Advanced configuration* checkbox is marked (see screenshot) and only for those elements that are selected in the *Show* field (see above). Additionally, advanced configuration allows to change the background color for the whole widget.  | | | |--|--------| |_**Description**_ |Enter the item description. This description may override the default item name. Multiline descriptions are supported. A combination of text and supported macros is possible.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} and user macros are supported. | |*Horizontal position* |Select horizontal position of the item description - left, right or center. | |*Vertical position* |Select vertical position of the item description - top, bottom or middle. | |*Size* |Enter font size height for the item description (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display item description in bold type. | |*Color* |Select the item description color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Value**_ | | |*Decimal places* |Select how many decimal places will be displayed with the value. This value will affect only float items. For items with units set to "s", if this value is greater than 0 (the default is 2), the widget rounds the most significant time unit and displays a numeric value (e.g. "10.43m") instead of converting the value into a full time string. When set to 0, the seconds are converted to a human-readable time string (for example, "4h 56m 30s"). | |*Size* |Enter font size height for the decimal places (in percent relative to total widget height). | |*Horizontal position* |Select horizontal position of the item value - left, right or center. | |*Vertical position* |Select vertical position of the item value - top, bottom or middle. | |*Size* |Enter font size height for the item value (in percent relative to total widget height).<br>*Note* that the size of item value is prioritised; other elements have to concede space for the value. With the change indicator though, if the value is too large, it will be truncated to show the change indicator. | |*Bold* |Mark the checkbox to display item value in bold type. | |*Color* |Select the item value color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |*Units* |Mark the checkbox to display units with the item value. If you enter a unit name, it will override the unit from item configuration. | |*Position* |Select the item unit position - above, below, before or after the value. | |*Size* |Enter font size height for the item unit (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display item unit in bold type. | |*Color* |Select the item unit color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Time**_ |Time is the clock value from item history. | |*Horizontal position* |Select horizontal position of the time - left, right or center. | |*Vertical position* |Select vertical position of the time - top, bottom or middle. | |*Size* |Enter font size height for the time (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display time in bold type. | |*Color* |Select the time color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Change indicator**_ |Select the color of change indicators from the color picker. The change indicators are as follows:<br>**↑** - item value is up (for numeric items)<br>**↓** - item value is down (for numeric items)<br>**↕** - item value has changed (for string items and items with value mapping)<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker.<br>Vertical size of the change indicator is equal to the size of the value (integer part of the value for numeric items).<br>*Note* that up and down indicators are not shown with just one value. | |_**Background color**_ |Select the background color for the whole widget from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | *Note* that multiple elements cannot occupy the same space; if they are placed in the same space, an error message will be displayed. #### Расширенная настройка Опции расширенной настройки становятся доступными, если установлен флажок *Расширенная настройка* (см. скриншот), и только для тех элементов, которые выбраны в поле *Показать* (см. выше). Кроме того, расширенная настройка позволяет изменить цвет фона для всего виджета.  | | | |--|--------| |_**Описание (Description)**_ |Введите описание элемента данных. Это описание может переопределить название элемента данных по умолчанию. Поддерживаются многострочные описания. Возможна комбинация текста и поддерживаемых макросов.<br>Поддерживаются {HOST.\*}, {ITEM.\*}, {INVENTORY.\*} и пользовательские макросы. | |*Расположение по горизонтали (Horizontal position)* |Выберите горизонтальное положение описания элемента данных — по левой стороне, по правой стороне или по центру. | |*Расположение по вертикали (Vertical position)* |Выберите вертикальное положение описания элемента данных — по верхнему краю, по нижнему краю или посередине. | |*Размер (Size)* |Введите высоту размера шрифта для описания элемента данных (в процентах относительно общей высоты виджета). | |*Жирный (Bold)* |Отметьте флажок, чтобы отображать описание элемента данных жирным шрифтом. | |*Цвет (Color)* |Выберите цвет описания элемента данных из палитры цветов.<br>`D` означает цвет по умолчанию (зависит от темы веб-интерфейса). Чтобы вернуться к значению по умолчанию, нажмите кнопку *Использовать умолчание* в палитре цветов. | |_**Значение (Value)**_ | | |*Число десятичных знаков (Decimal places)* |Выберите, сколько десятичных знаков будет отображаться в значении. Это значение повлияет только на элементы данных с плавающей точкой. Для элементов данных с единицами измерения «s», если это значение больше 0 (по умолчанию 2), виджет округляет самую значимую единицу времени и отображает числовое значение (например, «10.43m») вместо преобразования значения в полную строку времени. Если установлено значение 0, секунды преобразуются в понятную человеку строку времени (например, «4h 56m 30s»). | |*Размер (Size)* |Введите высоту размера шрифта для десятичных знаков (в процентах относительно общей высоты виджета). | |*Расположение по горизонтали (Horizontal position)* |Выберите горизонтальное положение значения элемента данных — по левой стороне, по правой стороне или по центру. | |*Расположение по вертикали (Vertical position)* |Выберите вертикальное положение значения элемента данных — по верхнему краю, по нижнему краю или посередине. | |*Размер (Size)* |Введите высоту размера шрифта для значения элемента данных (в процентах относительно общей высоты виджета).<br>*Обратите внимание*, что размер значения элемента данных имеет приоритет; остальные элементы должны уступить место для значения. Однако в случае индикатора изменения, если значение слишком велико, оно будет усечено, чтобы отобразить индикатор изменения. | |*Жирный (Bold)* |Отметьте флажок, чтобы значение элемента данных отображалось жирным шрифтом. | |*Цвет (Color)* |Выберите цвет значения элемента данных из палитры цветов.<br>`D` означает цвет по умолчанию (зависит от темы веб-интерфейса). Чтобы вернуться к значению по умолчанию, нажмите кнопку *Использовать умолчание* в палитре цветов. | |*Единицы измерения (Units)* |Отметьте флажок, чтобы отображать единицы измерения со значением элемента данных. Если вы введёте название единиц измерения, оно переопределит единицы измерения из настроек элемента данных. | |*Расположение (Position)* |Выберите положение единиц измерения элемента данных — выше, ниже, до или после значения. | |*Размер (Size)* |Введите высоту размера шрифта для единиц измерения элемента данных (в процентах относительно общей высоты виджета). | |*Жирный (Bold)* |Отметьте флажок, чтобы единицы измерения отображались жирным шрифтом. | |*Цвет (Color)* |Выберите цвет единиц измерения элемента данных из палитры цветов.<br>`D` означает цвет по умолчанию (зависит от темы веб-интерфейса). Чтобы вернуться к значению по умолчанию, нажмите кнопку *Использовать умолчание* в палитре цветов. | |_**Время (Time)**_ |Время — это значение часов из истории элемента данных. | |*Расположение по горизонтали (Horizontal position)* |Выберите горизонтальное положение времени — по левой стороне, по правой стороне или по центру. | |*Расположение по вертикали (Vertical position)* |Выберите вертикальное положение времени — по верхнему краю, по нижнему краю или посередине. | |*Размер (Size)* |Введите высоту размера шрифта для времени (в процентах относительно общей высоты виджета). | |*Жирный (Bold)* |Отметьте флажок, чтобы время отображалось жирным шрифтом. | |*Цвет (Color)* |Выберите цвет времени из палитры цветов.<br>`D` означает цвет по умолчанию (зависит от темы веб-интерфейса). Чтобы вернуться к значению по умолчанию, нажмите кнопку *Использовать умолчание* в палитре цветов. | |_**Индикатор изменений (Change indicator)**_ |Выберите цвет индикаторов изменений в палитре цветов. Существуют следующие индикаторы изменений :<br>**↑** — значение элемента увеличилось (для числовых элементов данных)<br>**↓** — значение элемента уменьшилось (для числовых элементов данных)<br>**↕** — значение элемента изменилось (для строковых элементов и элементов с преобразованием значений)<br>`D` означает цвет по умолчанию (зависит от темы веб-интерфейса). Чтобы вернуться к значению по умолчанию, нажмите кнопку *Использовать по умолчанию* в палитре цветов.<br>Размер индикатора изменений по вертикали равен размеру значения (целая часть значения для числовых элементов).<br> *Обратите внимание*, что индикаторы вверх и вниз не отображаются с только одним значением. | |_**Цвет фона (Background color)**_ |Выберите цвет фона для всего виджета из палитры цветов.<br>`D` означает цвет по умолчанию (зависит от темы веб-интерфейса). Чтобы вернуться к значению по умолчанию, нажмите кнопку *Использовать умолчание* в палитре цветов. | *Обратите внимание*, что несколько элементов не могут занимать одно и то же место; если они помещены в одно и то же место, будет отображено сообщение об ошибке. #### 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} |Параметр|Описание| |--|--------| |_**Дополнительные правила**_<br>*(Additional rules)*|Нажмите на *Добавить* для добавления дополнительных правил вычисления состояния.| |*Задать состояние в*<br>*(Set status to)*|В случае совпадения условия установить состояние услуги в значение *ОК* (по умолчанию), *Не классифицировано*, *Информация*, *Предупреждение*, *Средняя*, *Высокая* или *Чрезвычайная*.| |*Условие*<br>*(Condition)*|Выберите условие для непосредственных дочерних услуг:<br>**если по крайней мере (N) дочерних услуг в (Состояние) состоянии или выше**<br>**если по крайней мере (N%) дочерних услуг в (Состояние) состоянии или выше**<br>**если меньше чем (N) дочерних услуг в (Состояние) состоянии или ниже**<br>**если меньше чем (N%) дочерних услуг в (Состояние) состоянии или ниже**<br>**если вес дочерних услуг с (Состоянием) состоянием или выше по крайней мере (W)**<br>**если вес дочерних услуг с (Состоянием) состоянием или выше по крайней мере (N%)**<br>**если вес дочерних услуг с (Состояние) состоянием или ниже меньше чем (W)**<br>**если вес дочерних услуг с (Состояние) состоянием или ниже меньше чем (N%)** <br><br> Если задано несколько условий и ситуация соответствует более чем одному условию, будет задана наивысшая важность.| |*N (W)*|Задайте значение N или W (1-100000), или N% (1-100) в условии.| |*Состояние*<br>*(Status)*|Выберите значение *Состояния* в условии: *ОК* (по умолчанию), *Не классифицировано*, *Информация*, *Предупреждение*, *Средняя*, *Высокая* или *Чрезвычайная*.| |_**Правило распространения состояния**_<br>*(Status propagation rule)*|Правило распространения состояния услуги на родительскую услугу:<br>**Как есть** — состояние распространяется без изменений<br>**Увеличение на** — вы можете увеличить распространение состояния на 1–5 уровней важности<br>**Уменьшение на** — вы можете понизить распространение состояния на 1–5 уровней важности<br>**Игнорировать эту услугу** — состояние не передается на родительскую услугу вовсе<br>**Заданное состояние** — состояние распространяется статически, то есть всегда одно и то же| |_**Вес**_ *(Weight)*|Вес услуги (целое числов в диапазоне от 0 (по умолчанию) до 1000000).| :::noteclassic Дополнительные правила вычисления состояния можно использовать только для повышения уровня важности над уровнем, вычисленным в соответствии с основным параметром *Правило вычисления состояния*. Если согласно дополнительным правилам состояние должно быть Предупреждение, но согласно *Правило вычисления состояния* состояние должно быть Чрезвычайное — услуга получит состояние Чрезвычайное. ::: #### 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).| #### Расширенная конфигурация Следующие параметры поддерживаются, если для параметра *Расширенная конфигурация* установлено значение «Включено». |Параметр|<|[тип](/manual/api/reference/dashboard/object#поле-виджета-панели)|имя|значение| |-|--------|--|--------|-------------------------------| |*Background color*|<|1|bg_color|Шестнадцатеричный код цвета (например, `FF0000`).<br><br>По умолчанию: `""` (пусто).| ##### Advanced settings Additional SAML parameters can be configured in the Zabbix frontend configuration file (*zabbix.conf.php*): - $SSO\['SP\_KEY'\] = '<path to the SP private key file>'; - $SSO\['SP\_CERT'\] = '<path to the SP cert file>'; - $SSO\['IDP\_CERT'\] = '<path to the IDP cert file>'; - $SSO\['SETTINGS'\] ::: noteclassic The `$SSO['SETTINGS']` array must follow the same structure expected by the *SAML PHP Toolkit* library ([supplied](/manual/installation/requirements#frontend) with Zabbix). For a full description of available configuration options, refer to the official [library documentation](https://github.com/SAML-Toolkits/php-saml?tab=readme-ov-file#how-it-works). ::: Only the following options can be set as part of $SSO\['SETTINGS'\]: - *strict* - *baseurl* - *compress* - *contactPerson* - *organization* - *sp* (only options specified in this list) - *attributeConsumingService* - *x509certNew* - *idp* (only options specified in this list) - *singleLogoutService* (only one option) - *responseUrl* - *certFingerprint* - *certFingerprintAlgorithm* - *x509certMulti* - *security* (only options specified in this list) - *signMetadata* - *wantNameId* - *requestedAuthnContext* - *requestedAuthnContextComparison* - *wantXMLValidation* - *relaxDestinationValidation* - *destinationStrictlyMatches* - *rejectUnsolicitedResponsesWithInResponseTo* - *signatureAlgorithm* - *digestAlgorithm* - *lowercaseUrlencoding* All other options will be taken from the database and cannot be overridden. The *debug* option will be ignored. In addition, if Zabbix UI is behind a proxy or a load balancer, the custom *use\_proxy\_headers* option can be used: - *false* (default) - ignore the option; - *true* - use X-Forwarded-\* HTTP headers for building the base URL. If using a load balancer to connect to Zabbix instance, where the load balancer uses TLS/SSL and Zabbix does not, you must indicate 'baseurl', 'strict' and 'use_proxy_headers' parameters as follows: ```php $SSO['SETTINGS'] = [ 'strict' => false, 'baseurl' => 'https://zabbix.example.com/zabbix/', 'use_proxy_headers' => true ]; ``` **Configuration example:** ```php $SSO['SETTINGS'] = [ 'security' => [ 'signatureAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#rsa-sha384' 'digestAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#sha384', // ... ], // ... ]; ``` ##### Расширенные настройки Дополнительные параметры SAML можно настроить в файле конфигурации веб-интерфейса Zabbix (*zabbix.conf.php*): - $SSO\['SP\_KEY'\] = '<путь к файлу закрытого ключа SP>'; - $SSO\['SP\_CERT'\] = '<путь к файлу сертификата SP>'; - $SSO\['IDP\_CERT'\] = '<путь к файлу сертификата IDP>'; - $SSO\['SETTINGS'\] ::: noteclassic Массив `$SSO['SETTINGS']` должен соответствовать структуре, ожидаемой библиотекой *SAML PHP Toolkit* ([поставляемой](/manual/installation/requirements#веб-интерфейс) вместе с Zabbix). Полное описание доступных параметров конфигурации смотрите в официальной [документации библиотеки \[en\]](https://github.com/SAML-Toolkits/php-saml?tab=readme-ov-file#how-it-works). ::: В рамках $SSO\['SETTINGS'\] можно задать только следующие параметры: - *strict* - *baseurl* - *compress* - *contactPerson* - *organization* - *sp* (только опции, указанные в этом списке) - *attributeConsumingService* - *x509certNew* - *idp* (только опции, указанные в этом списке) - *singleLogoutService* (только одна опция) - *responseUrl* - *certFingerprint* - *certFingerprintAlgorithm* - *x509certMulti* - *security* (только опции, указанные в этом списке) - *signMetadata* - *wantNameId* - *requestedAuthnContext* - *requestedAuthnContextComparison* - *wantXMLValidation* - *relaxDestinationValidation* - *destinationStrictlyMatches* - *rejectUnsolicitedResponsesWithInResponseTo* - *signatureAlgorithm* - *digestAlgorithm* - *lowercaseUrlencoding* Все остальные параметры будут взяты из базы данных и не могут быть переопределены. Опция *debug* будет игнорироваться. Кроме того, если пользовательский интерфейс Zabbix находится за прокси-сервером или балансировщиком нагрузки, можно использовать пользовательскую опцию *use\_proxy\_headers*: - *false* (по умолчанию) - игнорировать эту опцию; - *true* - для построения базового URL использовать HTTP-заголовки X-Forwarded-\*. Если вы используете балансировщик нагрузки для подключения к экземпляру Zabbix, где балансировщик нагрузки использует TLS/SSL, а Zabbix — нет, вы должны указать параметры «baseurl», «strict» и «use_proxy_headers» следующим образом: ```php $SSO['SETTINGS'] = [ 'strict' => false, 'baseurl' => 'https://zabbix.example.com/zabbix/', 'use_proxy_headers' => true ]; ``` **Пример конфигурации:** ```php $SSO['SETTINGS'] = [ 'security' => [ 'signatureAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#rsa-sha384' 'digestAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#sha384', // ... ], // ... ]; ``` 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. ::: После получения списка активных проверок агент помечает устаревшие постоянные файлы для удаления. Постоянный файл становится устаревшим, если: 1) соответствующий элемент данных журнала более не наблюдается, 2) элемент данных журнала перенастраивается на другое расположение **постоянного\_хранилища**, нежели ранее. Удаление выполняется с задержкой в 24 часа, так как файлы журналов в НЕПОДДЕРЖИВАЕМОМ состоянии не включаются в список активных проверок, но могут стать ПОДДЕРЖИВАЕМЫМИ позже, и тогда их постоянные файлы будут полезны. Если агент остановлен до истечения 24 часов, тогда устаревшие файлы не будут удалены, так как Zabbix агент более не получает со стороны Zabbix сервера информации об их расположении. ::: notewarning Перенастройка **постоянного\_хранилища** элементов данных назад к старому значению расположения **постоянного\_хранилища** пока агент остановлен, без удаления старого постоянного файла пользователем — приведёт к восстановлению состояния агента из старого постоянного файла, что приведёт к пропущенным сообщениям или к ложным оповещениям. ::: #### 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. #### Поддержка пакета агента 2 для RHEL 6 прекращена Начиная с Zabbix 6.0.35, пакеты агента Zabbix 2 больше не доступны для [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/) из-за несовместимости Go 1.22 (и новее) с GCC 4.4.7, предоставляемым RHEL 6, что приводит к ошибкам компиляции. Однако, обратите внимание, что [пакеты агента 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. #### Плагины для Agent 2 ##### MySQL Теперь возвращается правильный хост мастера, если он указан в параметре «хост_мастера» [элемента данных](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mysql) `mysql.replication.get_slave_status[строка_подкл, <имя_пользователя>, <пароль>, <хост_мастера>]`. Ранее параметр «хост_мастера» игнорировался, и всегда возвращался первый хост мастера. Если этот параметр не указан, возвращаются все хосты. ##### 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*|Да|Требуется для сборки Zabbix агента 2 и его плагинов из исходного кода.<br>Поддерживается Go 1.23 или более поздняя версия. Инструкции по установке смотрите на [go.dev \[en\]](https://go.dev/doc/install).<br>Библиотеки Go, используемые Zabbix агентом 2 и его плагинами, перечислены в репозитории Zabbix Git \[en\] (библиотеки, отмеченные в репозитории как `indirect`, являются зависимостями других требуемых библиотек:<br>- [Zabbix агент 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [Поддержка плагинов](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*|Одна из|Библиотека PCRE/PCRE2 требуется для поддержки [Perl-совместимых регулярных выражений](https://ru.wikipedia.org/wiki/PCRE) (PCRE).<br>Наименование может отличаться в зависимости от дистрибутива GNU/Linux, например «libpcre3» или «libpcre1». Поддерживаются библиотеки PCRE v8.x и PCRE2 v10.x (начиная с Zabbix 6.0.0).<br>Требуется для мониторинга журналов. Также требуется на Windows.| |*libopenssl*|Нет|Требуется при использовании шифрования.<br>OpenSSL 1.0.1 или новее требуется на UNIX платформах.<br>Библиотека OpenSSL должна иметь включённой поддержку PSK. LibreSSL не поддерживается.<br>На системах Microsoft Windows требуется OpenSSL 1.1.1 или новее.| **Agent configuration** Add the next line to the agent configuration file: HostMetadata=Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae where "Linux" is a platform, and the rest of the string is the hard-to-guess secret text. Do not forget to restart the agent after making any changes to the configuration file. ***Step 2*** It is possible to add additional monitoring for an already registered host. **Настройка агента** В файл конфигурации агента добавьте следующую строку: HostMetadata=Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae где «Linux» — это платформа, а остаток строки — трудноугадываемый секретный текст. Не забудьте перезапустить агента после внесения любых изменений в файл конфигурации. ***Шаг 2*** Можно добавлять дополнительные виды мониторинга к уже зарегистрированному узлу сети. ##### 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 ``` ##### Настройка агента Ноды (серверы) HA кластера необходимо перечислить в конфигурации Zabbix агента или Zabbix агента 2.  Чтобы активировать пассивные проверки, имена нод необходимо перечислить в [параметре](/manual/appendix/config/zabbix_agentd) Server, разделяя имена нод **запятой**. ``` Server=zabbix-node-01,zabbix-node-02 ``` Чтобы активировать активные проверки, имена нод необходимо перечислить в [параметре](/manual/appendix/config/zabbix_agentd) ServerActive. Обратите внимание, что для работы активных проверок ноды необходимо отделить от любых других серверов запятой, тогда как сами ноды разделяются (друг от друга) **точкой с запятой**, например: ``` ServerActive=zabbix-node-01;zabbix-node-02 ``` **Agent configuration** Now you need to configure the agents. Add the next line to the agent configuration files: HostMetadataItem=system.uname This way you make sure host metadata will contain "Linux" or "Windows" depending on the host an agent is running on. An example of host metadata in this case: Linux: Linux server3 3.2.0-4-686-pae #1 SMP Debian 3.2.41-2 i686 GNU/Linux Windows: Windows WIN-0PXGGSTYNHO 6.0.6001 Windows Server 2008 Service Pack 1 Intel IA-32 Do not forget to restart the agent after making any changes to the configuration file. **Настройка агента** Теперь вам нужно настроить агентов. В файлы конфигурации агентов добавьте следующую строку: HostMetadataItem=system.uname Таким способом вы обеспечите, что метаданные узлов сети будут содержать строку «Linux» или «Windows» в зависимости от узла сети, на котором работает агент. Пример метаданных узла сети в этом случае: Linux: Linux server3 3.2.0-4-686-pae #1 SMP Debian 3.2.41-2 i686 GNU/Linux Windows: Windows WIN-0PXGGSTYNHO 6.0.6001 Windows Server 2008 Service Pack 1 Intel IA-32 Не забудьте перезапустить агента после внесения любых изменений в его файл конфигурации. **Agent configuration** Update the next line in the agent configuration file: HostMetadata=MySQL on Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae Do not forget to restart the agent after making any changes to the configuration file. **Настройка агента** Обновите следующую строчку в конфигурационном файле агента: HostMetadata=MySQL on Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae Не забудьте перезапустить агента после внесения любых изменений в конфигурационный файл. ### 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 |<| _строка_ | да | `agent data` | | host |<| _строка_ | да | Имя узла сети. | | version |<| _строка_ | да | Версия агента: \<major>.\<minor>. | | session |<| _строка_ | да | Уникальный идентификатор сессии, генерируется каждый раз при старте агента. | | data |<| _массив объектов_ | да | Значения элементов данных. | | | id | _число_ | да | Идентификатор значения (возрастающий счётчик, используемый для контроля дублированных значений в случае сетевых проблем). | |^| itemid | _число_ | да | Идентификатор элемента данных. | |^| value | _строка_ | нет | Значение элемента данных. | |^| lastlogsize | _число_ | нет | Последний размер файла журнала (lastlogsize) элемента данных. | |^| mtime | _число_ | нет | Отметка времени последнего обновления (mtime) элемента данных. | |^| state | _число_ | нет | Состояние элемента данных. | |^| source | _строка_ | нет | Источник (source) значения журнала событий. | |^| eventid | _число_ | нет | Идентификатор (eventid) значения журнала событий. | |^| severity | _число_ | нет | Важность (severity) значения журнала событий. | |^| timestamp | _число_ | нет | Отметка времени (timestamp) значения журнала событий. | |^| clock | _число_ | да | Отметка времени значения (секунд с начала эпохи). | |^| ns | _число_ | да | Наносекунды отметки времени значения. | Пример: ```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 | _строка_ | да | `success` \| `failed` | | info | _строка_ | да | Результаты обработки элементов данных. | Пример: ```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\[\]** -- возвращает строку из 4-х цифр, которая содержит восьмеричное число с Unix правами Дополнительно: - **vfs.file.cksum\[\]** теперь поддерживает второй параметр `режим` (*crc32*, *md5*, *sha256*) - **vfs.file.size\[\]** теперь поддерживает второй параметр `режим` (*bytes* или *lines*) - **vfs.fs.discovery** и **vfs.fs.get** теперь на Windows возвращают макросы {\#FSLABEL} (с именами дисковых томов) Для получения более подробных сведений смотрите [элементы данных агента](/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 системах Zabbix агент на UNIX-подобных системах запускается на хостах, которые необходимо мониторить. #### Agent on Windows systems Zabbix agent on Windows runs as a Windows service. #### Агент на Windows системах Zabbix агент на Windows работает как служба 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. ##### Работа агента с постоянным файлом При запуске Zabbix агент ничего не знает о постоянных файлах. Только после получения списка активных проверок от Zabbix сервера \(прокси\) агент видит, что некоторые элементы данных журналов необходимо поддерживать при помощи постоянных файлов в указанных директориях. В процессе работы агента постоянные файлы открыты на запись (с использованием fopen(имя_файла, "w")) и перезаписываются последними данными. Шанс потери данных постоянного файла, если перезапись и разделение зеркала файловой системы совпадут, очень мал, специальной обработка такого случая нет. После записи в постоянный файл НЕ следует принудительной синхронизации с носителями информации \(fsync\(\) не вызывается\). Перезапись последними данными выполняется после успешного сообщения на Zabbix сервер о найденной строке файла журнала или о метаданных \(размер обработанного журнала и время модификации\). Это может происходить настолько же часто, как и проверки каждого элемента данных, если файл журнала продолжает изменяться. При остановке агента не выполняется никаких специальных действий. #### Agent process types - `active checks` - process for performing active checks - `collector` - process for data collection - `listener` - process for listening to passive checks The agent log file can be used to observe these process types. Since Zabbix 6.0.43, the agent log file is created with read-write permissions only for the file owner. Additionally the file is readable by the owner group. All other permissions are denied. #### Типы процессов агента - `active checks` — процесс для выполнения активных проверок - `collector` — процесс для сбора данных - `listener` — процесс, ожидающий и выполняющий пассивные проверки Можно воспользоваться файлом журнала агента для выявления этих типов процессов. Начиная с версии Zabbix 6.0.43, файл журнала агента создаётся с правами на чтение и запись только для владельца файла. Кроме того, файл доступен для чтения группе владельца. Все остальные права запрещены. ##### 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*|Одна из|Библиотека PCRE требуется для поддержки [Perl-совместимых регулярных выражений](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE).<br>Наименование может отличаться в зависимости от дистрибутива GNU/Linux, например «libpcre3» или «libpcre1». Поддерживаются библиотеки PCRE v8.x и PCRE2 v10.x (начиная с Zabbix 6.0.0).<br>Требуется для мониторинга журналов. Также требуется на Windows.| |*libpthread*|^|Требуется для поддержки мьютексов (mutex) и блокировок на чтение-запись (может быть частью libc). Не требуется на Windows.| |*libresolv*|^|Требуется для разрешения имён DNS (может быть частью libc). Не требуется в Windows.| |*libiconv*|^|Требуется для конвертации кодировки / форматирования текста в UTF-8 в элементах данных журналов, содержимого файлов, в регулярных выражениях файлов и в элементах данных с поиском соответствия по регулярному выражению (может быть частью libc). Не требуется на Windows.| |*libgnutls* или *libopenssl*|Нет|Требуется при использовании [шифрования](/manual/encryption#компиляция-zabbix-с-поддержкой-шифрования).<br>Минимальные версии: *libgnutls* — 3.1.18, *libopenssl* — 1.0.1<br>На системах Microsoft Windows требуется версия OpenSSL 1.1.1 или выше.| |*libldap*|^|Требуется при использовании LDAP. Не поддерживается на Windows.| |*libcurl*|^|Требуется для [элементов данных](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента `web.page.*`. Не поддерживается на Windows.<br>Рекомендуется версия 7.28.0 или выше.| |*libmodbus*|^|Требуется только, если используется мониторинг Modbus.<br>Версия 3.0 или новее.| ::: noteclassic Начиная с версии 5.0.3, Zabbix агент не будет работать на платформах AIX с версией ниже 6.1 TL07 / AIX 7.1 TL01. ::: #### 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, имеются два типа агентов: [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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<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_syntax)<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): bucket_rate_foreach<br><br>Functionally corresponds to '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile)' of PromQL.<br><br> Returns -1 if values of the last 'Infinity' bucket (*"+inf"*) are equal to 0. <br><br>Examples:<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_syntax) for more details.|Supported only in calculated items.<br><br>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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<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>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<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)| #### Функции агрегации |ФУНКЦИЯ|<|<| |--|--|--| |**Описание**|**Параметры, специфичные для функции**|**Комментарии**| |**avg** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Среднее значение элементов данных за указанный период вычислений.|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаемы [функции foreach](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<br><br>Примеры:<br>=> **avg**(/узел_сети/ключ,**1h**) → среднее значение за последний час до [текущего момента](/manual/config/triggers#период-вычисления)<br>=> **avg**(/узел_сети/ключ,**1h:now-1d**) → среднее значение за час с 25 часов назад до 24 часов назад от [текущего момента](/manual/config/triggers#период-вычисления)<br>=> **avg**(/узел_сети/ключ,**\#5**) → среднее значение из пяти последних значений<br>=> **avg**(/узел_сети/ключ,**\#5:now-1d**) → среднее значение из пяти последних значений, исключая значения, полученные за последние 24 часа<br><br>Сдвиг времени полезен, когда нужно сравнить текущее среднее значение со средним значением некоторое время назад.| |**bucket\_percentile** (фильтр,период_времени,процент)|<|<| |Вычисление процентиля из разрядов гистограммы.|**фильтр** — смотрите [фильтр элементов данных](/manual/appendix/functions/aggregate/foreach#синтаксис-фильтра-элементов-данных)<br>**период_времени** — смотрите [период времени](/manual/appendix/functions/aggregate/foreach#период-времени)<br>**процент** — процент (0-100)|Поддерживается только в вычисляемых элементах данных.<br><br>Эта функция является алиасом для `histogram_quantile(процент/100, bucket_rate_foreach(фильтр, период_времени, 1))`| |**count** (функция\_foreach(фильтр,<период_времени>))|<|<| |Количество значений в массиве, возвращаемом функцией foreach.|**функция\_foreach** — функция foreach, для которой нужно подсчитать количество возвращаемых значений (с поддерживаемыми аргументами). Смотрите [функции foreach](/manual/appendix/functions/aggregate/foreach) для более подробной информации.|Поддерживаются типы значений: int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<br><br>Пример:<br>=> **count**(max\_foreach(/\*/net.if.in\[\*\],1h)) → количество элементов данных в net.if.in, которые получали данные в течение последнего часа до [текущего момента](/manual/config/triggers#период-вычисления)<br><br>Обратите внимание, что использование **count()** с функциями foreach, относящимися к истории (max\_foreach, avg\_foreach и т.п.), может сказаться на производительности, в то время как использование функции **exists\_foreach()**, которая работает только с данными конфигурации, не окажет такого влияния.| |**histogram\_quantile** (квантиль,разряд1,значение1,разряд2,значение2,...)|<|<| |Вычисление φ-го квантиля из разрядов гистограммы.|**квантиль** — 0 ≤ φ ≤ 1<br>**разрядN, значениеN** — вручную введённые пары (>=2) параметров либо результат вызова [bucket\_rate\_foreach](/manual/appendix/functions/aggregate/foreach)|Поддерживается только в вычисляемых элементах данных.<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): bucket_rate_foreach<br><br>По функционалу соответствует '[histogram\_quantile \[en\]](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile)' из PromQL.<br><br> Возвращает -1, если значения последнего разряда 'Infinity' (*"+inf"*) равны 0. <br><br>Примеры:<br>=> **histogram\_quantile**(0.75,1.0,last(/узел_сети/rate\_bucket\[1.0\]),"+Inf",last(/узел_сети/rate\_bucket\[Inf\])<br>=> **histogram\_quantile**(0.5,bucket\_rate\_foreach(//item\_key,30s))| |**item\_count** (фильтр)|<|<| |Подсчёт существующих в конфигурации элементов данных, соответствующих критериям фильтра.|**фильтр** — критерий для выбора элементов данных, позволяет ссылаться на группы узлов сети, узлы сети, ключи элементов данных и теги. Поддерживаются подстановочные символы. Смотрите [фильтр элементов данных](/manual/appendix/functions/aggregate/foreach#синтаксис-фильтра-элементов-данных) для более подробной информации.|Поддерживается только в вычисляемых элементах данных.<br><br>Поддерживаются типы значений: int<br><br>Работает как алиас для функции *count(exists\_foreach(фильтр))*.<br><br>Пример:<br>=> **item\_count**(/\*/agent.ping?\[group="Host group 1"\]) → количество узлов сети с элементом данных *agent.ping* в группе узлов сети «Host group 1»| |**kurtosis** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Эксцесс («островершинность») распределения вероятностей собранных значений в течение определённого периода оценки.<br><br>Смотрите также: [Коэффициент эксцесса](https://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D1%8D%D1%84%D1%84%D0%B8%D1%86%D0%B8%D0%B5%D0%BD%D1%82_%D1%8D%D0%BA%D1%81%D1%86%D0%B5%D1%81%D1%81%D0%B0), [Kurtosis \[en\]](https://en.wikipedia.org/wiki/Kurtosis)|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Пример:<br>=> **kurtosis**(/узел_сети/ключ,**1h**) → эксцесс за последний час до [текущего момента](/manual/config/triggers#период-вычисления)| |**mad** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Среднее абсолютное отклонение собранных значений в течение определённого периода оценки.<br><br>Смотрите также: [Среднее абсолютное отклонение](https://ru.wikipedia.org/wiki/%D0%90%D0%B1%D1%81%D0%BE%D0%BB%D1%8E%D1%82%D0%BD%D0%BE%D0%B5_%D0%BE%D1%82%D0%BA%D0%BB%D0%BE%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5)|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Пример:<br>=> **mad**(/узел_сети/ключ,**1h**) → среднее абсолютное отклонение за последний час до [текущего момента](/manual/config/triggers#период-вычисления)| |**max** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Наибольшее значение элемента данных в течение определённого периода оценки.|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<br><br>Пример:<br>=> **max**(/узел_сети/ключ,**1h**) - **min**(/узел_сети/ключ,**1h**) → вычисление разницы между наибольшим и наименьшим значениями за последний час до [текущего момента](/manual/config/triggers#период-вычисления) (дельта значений)| |**min** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Наименьшее значение элемента данных в течение определённого периода оценки.|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<br><br>Пример:<br>=> **max**(/узел_сети/ключ,**1h**) - **min**(/узел_сети/ключ,**1h**) → вычисление разницы между наибольшим и наименьшим значениями за последний час до [текущего момента](/manual/config/triggers#период-вычисления) (дельта значений)| |**skewness** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Асимметрия распределения вероятностей собранных значений в течение определённого периода оценки.<br><br>Смотрите также: [Коэффициент асимметрии](https://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D1%8D%D1%84%D1%84%D0%B8%D1%86%D0%B8%D0%B5%D0%BD%D1%82_%D0%B0%D1%81%D0%B8%D0%BC%D0%BC%D0%B5%D1%82%D1%80%D0%B8%D0%B8)|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Пример:<br>=> **skewness**(/узел_сети/ключ,**1h**) → коэффициент асимметрии за последний час до [текущего момента](/manual/config/triggers#период-вычисления)| |**stddevpop** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Среднеквадратическое отклонение для генеральной совокупности собранных значений в течение определённого периода оценки.<br><br>Смотрите также: [Среднеквадратическое отклонение](https://ru.wikipedia.org/wiki/%D0%A1%D1%80%D0%B5%D0%B4%D0%BD%D0%B5%D0%BA%D0%B2%D0%B0%D0%B4%D1%80%D0%B0%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%B5_%D0%BE%D1%82%D0%BA%D0%BB%D0%BE%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5)|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Пример:<br>=> **stddevpop**(/узел_сети/ключ,**1h**) → стандартное отклонение для генеральной совокупности за последний час до [текущего момента](/manual/config/triggers#период-вычисления)| |**stddevsamp** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Среднеквадратическое отклонение для выборки собранных значений в течение определённого периода оценки.<br><br>Смотрите также: [Среднеквадратическое отклонение](https://ru.wikipedia.org/wiki/%D0%A1%D1%80%D0%B5%D0%B4%D0%BD%D0%B5%D0%BA%D0%B2%D0%B0%D0%B4%D1%80%D0%B0%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%B5_%D0%BE%D1%82%D0%BA%D0%BB%D0%BE%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5)|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Для работы этой функции требуется как минимум два значения данных.<br><br>Пример:<br>=> **stddevsamp**(/узел_сети/ключ,**1h**) → стандартное отклонение для выборки за последний час до [текущего момента](/manual/config/triggers#период-вычисления)| |**sum** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Сумма собранных значений в течение определённого периода оценки.|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<br><br>Пример:<br>=> **sum**(/узел_сети/ключ,**1h**) → сумма значений за последний час до [текущего момента](/manual/config/triggers#период-вычисления)| |**sumofsquares** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Сумма квадратов собранных значений в течение определённого периода оценки.|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Пример:<br>=> **sumofsquares**(/узел_сети/ключ,**1h**) → сумма квадратов за последний час до [текущего момента](/manual/config/triggers#период-вычисления)| |**varpop** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Генеральная (совокупная) дисперсия собранных значений в течение определённого периода оценки.<br><br>Смотрите также: [Дисперсия случайной величины](https://ru.wikipedia.org/wiki/%D0%94%D0%B8%D1%81%D0%BF%D0%B5%D1%80%D1%81%D0%B8%D1%8F_%D1%81%D0%BB%D1%83%D1%87%D0%B0%D0%B9%D0%BD%D0%BE%D0%B9_%D0%B2%D0%B5%D0%BB%D0%B8%D1%87%D0%B8%D0%BD%D1%8B)|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Пример:<br>=> **varpop**(/узел_сети/ключ,**1h**) → дисперсия случайной величины за последний час до [текущего момента](/manual/config/triggers#период-вычисления)| |**varsamp** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>)|<|<| |Выборочная дисперсия собранных значений в течение определённого периода оценки.<br><br>Смотрите также: [Выборочная дисперсия](https://ru.wikipedia.org/wiki/%D0%92%D1%8B%D0%B1%D0%BE%D1%80%D0%BE%D1%87%D0%BD%D0%B0%D1%8F_%D0%B4%D0%B8%D1%81%D0%BF%D0%B5%D1%80%D1%81%D0%B8%D1%8F)|Смотрите [общие параметры](#общие-параметры).|Поддерживаются типы значений: float, int<br><br>Поддерживаются [функции foreach](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Для работы этой функции требуется как минимум два значения данных.<br><br>Пример:<br>=> **varsamp**(/узел_сети/ключ,**1h**) → выборочная дисперсия за последний час до [текущего момента](/manual/config/triggers#период-вычисления)| ### 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 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, смотри в таблице. |Поддерживаемое значение|Описание|Источник в структуре procentry64|Пытается быть совместимым с| |--|------|--|--| |vsize ^[1](proc_mem_notes#примечания)^|Размер виртуальной памяти|pi\_size| | |pmem|Процент физической памяти|pi\_prm|ps -o pmem| |rss|Размер резидентного набора|pi\_trss + pi\_drss|ps -o rssize| |size|Размер процесса (код + данные)|pi\_dvm|"ps gvw" колонка SIZE| |dsize|Размер данных|pi\_dsize|<| |tsize|Размер текста (кода)|pi\_tsize|"ps gvw" колонка TSIZ| |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. #### Сбой в процессе alerter в RHEL 7 В RHEL 7 обнаружены случаи сбоя в процессах alerter сервера Zabbix. Пожалуйста, обратитесь к [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. #### Оповещение на изменение состояния услуг Теперь можно получать автоматические оповещения об изменениях состояний услуг, аналогично оповещениям касательно изменениям состояний триггеров. Добавлено новое [действие на услуги](/manual/config/notifications/action) в меню *Действия*. Действия на услуги могут включать шаги на операции проблем, восстановления и обновления, которые связаны с услугами. Имеется возможность настройки двух типов действий: отправка сообщения заданным адресатам и выполнение удаленной команды на стороне Zabbix сервера. Аналогично действиям на триггеры, действия на услуги поддерживают сценарии [эскалации](/manual/config/notifications/action/escalations) проблем. Добавлены новые шаблоны *Услуга*, *Восстановление услуги* и *Обновление услуги* в [способы оповещения](/manual/config/notifications/media#общие_параметры). Их необходимо задать, чтобы активировать корректную отправку оповещений по действиям на услуги. ##### 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. ##### Оповещение на изменение состояния услуг Теперь можно получать автоматические оповещения об изменениях состояний услуг, аналогично оповещениям касательно изменениям состояний триггеров. Добавлено новое [действие на услуги](/manual/config/notifications/action) в меню *Действия*. Действия на услуги могут включать шаги на операции проблем, восстановления и обновления, которые связаны с услугами. Имеется возможность настройки двух типов действий: отправка сообщения заданным адресатам и выполнение удаленной команды на стороне Zabbix сервера. Аналогично действиям на триггеры, действия на услуги поддерживают сценарии [эскалации](/manual/config/notifications/action/escalations) проблем. Добавлены новые шаблоны *Услуга*, *Восстановление услуги* и *Обновление услуги* в [способы оповещения](/manual/config/notifications/media#общие_параметры). Их необходимо задать, чтобы активировать корректную отправку оповещений по действиям на услуги. **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. **Оповещения на изменение состояния услуг** Теперь можно получать автоматические оповещения об изменении состояний услуг, аналогично оповещениям об изменениях состояний триггеров. Добавлено новое [действие на услуги](/manual/it_services/service_actions), аналогично другим действиям в Zabbix. Действия услуг могут включать шаги на операции возникновения проблемы, восстановления и обновления, которые относятся к услугам. Имеется возможность настройки двух типов действий: отправка сообщения заданным адресатам и выполнение удалённой команды на стороне Zabbix сервера. Аналогично триггерным действиям, действия на услуги поддерживают сценарии [эскалации](/manual/config/notifications/action/escalations) проблем. В [способы оповещения](/manual/config/notifications/media#общие-параметры) добавлены новые шаблоны: *Услуга*, *Восстановление услуги* и *Обновление услуги*. Их необходимо задать, чтобы активировать корректную отправку оповещений по действиям на услуги. ### 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 Оповещения (alerts) создаются сервером 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, когда обрабатывают интервалы по расписанию, используют свои местные часовые пояса. По этой причине когда интервалы по расписанию применяются к элементам данных, которые отслеживаются через прокси, либо к активным элементам данных агента 2, то рекомендуется настроить часовой пояс соответствующих прокси либо агента 2 таким же, как и на сервере Zabbix, в противном случае [очередь](/manual/config/items/queue) может неправильно сообщать о задержках элементов данных. Пользовательские интервалы для активных проверок поддерживаются только Zabbix агентом 2. Если вы намереваетесь настроить пользовательские интервалы для активных проверок, убедитесь, что вы используете Zabbix агент 2. Часовой пояс для Zabbix прокси или агента 2 можно настроить при помощи переменной окружения `TZ` в файле юнита `systemd`: [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-tune, предоставляемый TimescaleDB, чтобы оптимизировать параметры конфигурации PostgreSQL в вашем `postgresql.conf`. ::: #### Allow/deny rule order You can specify an unlimited number of `AllowKey` or `DenyKey` rules, though their order matters. - Rules are evaluated one by one, from top to bottom. - When an item key matches a rule, it is either allowed or denied, and rule evaluation stops. For example, when evaluating `vfs.file.contents[/etc/passwd]`, the rules are processed as follows: ```default AllowKey=vfs.file.contents[/tmp/app.log] # Item key pattern does not match, agent proceeds to the next rule. AllowKey=vfs.file.contents[/etc/passwd] # Item key pattern matches; agent allows the item check and stops rule evaluation. DenyKey=vfs.file.*[*] # Agent ignores the rule, as the evaluation has stopped. ``` The following rule order will deny the item check: ```default DenyKey=vfs.file.*[*] # Item key pattern matches; agent denies the item check and stops rule evaluation. AllowKey=vfs.file.contents[/etc/passwd] # Agent ignores the rule, as the evaluation has stopped. AllowKey=vfs.file.contents[/tmp/app.log] # Agent ignores the rule, as the evaluation has stopped. ``` #### Порядок правил Allow/Deny Можно указать неограниченное количество правил `AllowKey` или `DenyKey`, но их порядок имеет значение. - Правила проверяются по очереди, сверху вниз. - Как только ключ элемента данных соответствует правилу, элемент данных разрешается или запрещается; а проверка правил прекращается. Например, при проверке ключа `vfs.file.contents[/etc/passwd]` правила обрабатываются следующим образом: ```default AllowKey=vfs.file.contents[/tmp/app.log] # Шаблон ключа элемента данных не даёт соответствия, агент переходит к следующему правилу. AllowKey=vfs.file.contents[/etc/passwd] # Шаблон ключа элемента данных даёт соответствие; агент разрешает проверку элемента данных и прекращает проверку правил. DenyKey=vfs.file.*[*] # Агент игнорирует правило, поскольку проверка правил была прекращена. ``` Следующий порядок правил запретит проверку элемента данных: ```default DenyKey=vfs.file.*[*] # Шаблон ключа элемента данных даёт соответствие; агент запрещает проверку элемента данных и прекращает проверку правил. AllowKey=vfs.file.contents[/etc/passwd] # Агент игнорирует правило, поскольку проверка правил была прекращена. AllowKey=vfs.file.contents[/tmp/app.log] # Агент игнорирует правило, поскольку проверка правил была прекращена. ``` ##### Allowing scripts Allow Zabbix agent to execute scripts on hosts via all available methods: - [Global scripts](/manual/web_interface/frontend_sections/administration/scripts) that can be executed in the frontend or via API (this method always uses the `system.run[myscript.sh]` key) - Remote commands from [action operations](/manual/config/notifications/action/operation#operation-details) (this method always uses the `system.run[myscript.sh,nowait]` key) - [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system-data) Zabbix agent items with the script, for example: - `system.run[myscript.sh]` - `system.run[myscript.sh,wait]` - `system.run[myscript.sh,nowait]` ```default AllowKey=system.run[myscript.sh,*] ``` To control the `wait`/`nowait` parameter, you must set a different rule. For example, you can allow only `system.run[myscript.sh,wait]` items, thus excluding other methods: ```default AllowKey=system.run[myscript.sh,wait] ``` ##### Разрешение скриптов Разрешение Zabbix агенту выполнять скрипты на узле сети всеми доступными способами: - [Глобальные скрипты](/manual/web_interface/frontend_sections/administration/scripts), которые могут быть выполнены через веб-интерфейс или посредством API (этот метод всегда использует ключ `system.run[myscript.sh]`) - Удалённые команды из [операций действия](/manual/config/notifications/action/operation#детали-операций) (этот метод всегда использует ключ `system.run[myscript.sh,nowait]`) - Элементы данных Zabbix агента [`system.run`](/manual/config/items/itemtypes/zabbix_agent#данные-о-системе) со скриптом, например: - `system.run[myscript.sh]` - `system.run[myscript.sh,wait]` - `system.run[myscript.sh,nowait]` ```default AllowKey=system.run[myscript.sh,*] ``` Чтобы управлять параметром `wait`/`nowait`, вам нужно установить другое правило. Например, вы можете разрешить только элементы данных `system.run[myscript.sh,wait]`, исключая таким образом другие способы: ```default AllowKey=system.run[myscript.sh,wait] ``` ##### Allowing specific checks and commands Allow only two [`vfs.file`](/manual/config/items/itemtypes/zabbix_agent#virtual-file-system-data) item checks and two [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system-data) commands: ```default AllowKey=vfs.file.contents[/tmp/app.log] AllowKey=vfs.file.size[/tmp/app.log] AllowKey=system.run[/usr/bin/uptime] AllowKey=system.run[/usr/bin/df -h /] DenyKey=vfs.file.*[*] ``` ::: noteclassic Setting `DenyKey=system.run[*]` is unnecessary, because all other `system.run` commands are denied by default. ::: ##### Разрешение конкретных проверок и команд Разрешить проверку только двух элементов данных [`vfs.file`](/manual/config/items/itemtypes/zabbix_agent#данные-виртуальных-файловых-систем) и двух команд [`system.run`](/manual/config/items/itemtypes/zabbix_agent#данные-о-системе): ```default AllowKey=vfs.file.contents[/tmp/app.log] AllowKey=vfs.file.size[/tmp/app.log] AllowKey=system.run[/usr/bin/uptime] AllowKey=system.run[/usr/bin/df -h /] DenyKey=vfs.file.*[*] ``` ::: noteclassic Указание `DenyKey=system.run[*]` не является необходимым, поскольку все остальные команды `system.run` по умолчанию запрещены. ::: ##### 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=*` Например: # Разрешить чтение журналов (логов): AllowKey=vfs.file.*[/var/log/*] # Разрешить проверки локального времени AllowKey=system.localtime[*] # Запретить все остальные ключи 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 В этой версии вычисление выражений И/ИЛИ в фильтрах либо замещениях правил низкоуровневого обнаружения может работать неверно. Исправлено в версии 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* теперь работает также и с Azure Cosmos DB for MongoDB. #### 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 года менее чем в 2 раза выше в сравнении с сентябрем 2020 года). Однако, бывют случаи, когда такие пороги сложно определить. Например, веб трафик нового, но крайне популярного веб-сайта может сам собой в течение года вырасти во много раз, но скорость роста неизвестна. Тем не менее, внезапный всплеск из-за DDOS атаки всё же должен генерировать оповещение вне зависимости от нормального роста трафика. Алгоритмы обнаружения аномалий как раз это и делают -- ищут данные, которые не выглядят нормально (отклонение от нормы) в контексте остальных значений. Добавлена новая [функция динамики изменений](/manual/appendix/functions/trends) **trendstl()**, которая использует метод 'разбиения' для вычисления коэффициента аномалии. Этот метод разделяет одну последовательность временного ряда на три другие последовательности: - последовательность динамики изменений, которая содержит только большие изменения в оригинальных данных (например, трафик веб-сайта показывает рост) - сезонная последовательность, которая содержит только сезонные колебания (например, меньший трафик веб-сайта летом, больший осенью) - остаточная последовательность, которая содержит только те остаточные значения, которые нельзя интерпретировать как динамику изменений или сезонности  Обнаружение аномалий работает с остаточной последовательностью и проверяет, имеются ли там значения, которые слишком далеки от большинства остаточных значений. "Далеки" означает, что абсолютное значение из остаточной последовательности в 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). ::: ##### Другой пример с использованием inline модификатора регулярного выражения Использование следующего регулярного выражения, которое включает несколько inline модификаторов для поиска соответствия символов после указанной строки: (?<=match (?i)everything(?-i) after this line\n)(?sx).*# мы добавили s модификатор, чтобы разрешить . соответствие символам перевода строки  Выбран Тип выражения: «Результат ИСТИНА». Символы после указанной строки совпадают. ::: noteimportant Модификатор **g** нельзя указывать в строке. Список доступных модификаторов можно найти на [странице помощи по pcresyntax](https://www.pcre.org/original/doc/html/pcresyntax.html#SEC16) \[en\]. Для получения более подробной информации о синтаксисе PCRE, пожалуйста, обратитесь к [PCRE HTML документации](https://www.pcre.org/original/doc/html/pcrepattern.html) \[en\]. ::: #### API changes See the list of [API changes](/manual/api/changes_5.4_-_6.0) in Zabbix 6.0.0. #### API changes See the list of [API changes](/manual/api/changes_5.4_-_6.0) in Zabbix 6.0.0. ##### API changes See the list of [API changes](/manual/api/changes_5.4_-_6.0) in Zabbix 6.0.0. ##### Изменения в API Смотрите список [изменений в API](/manual/api/changes_5.4_-_6.0) в Zabbix 6.0.0. # 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 login У пользователя может быть создано большое количество открытых сессий при использовании пользовательских скриптов с [методом](/manual/api/reference/user/login) `user.login` без последующего использования `user.logout`. #### API tokens API tokens section allows to view tokens assigned to the user, edit token details and [create new tokens](/manual/web_interface/frontend_sections/administration/general#api_tokens). This section is only available to a user if *Manage API tokens* action is allowed in the [user role](/manual/web_interface/frontend_sections/administration/user_roles) settings. {width="600"} You may filter API tokens by name, expiry date, or status (enabled/disabled). Click on the token status in the list to quickly enable/disable a token. You may also mass enable/disable tokens by selecting them in the list and then clicking on the Enable/Disable buttons below the list. ::: noteimportant Users cannot view *Auth token* value of the tokens assigned to them in Zabbix. *Auth token* value is displayed only once - immediately after creating a token. If it has been lost, the token has to be regenerated. ::: #### API токены Раздел API токенов позволяет просматривать токены, назначенные конкретно этому пользователю, редактировать детали токенов и [создавать новые токены](/manual/web_interface/frontend_sections/administration/general#api-токены). Этот раздел доступен пользователю только, если действие *Управление API токенами* разрешено в настройках [роли пользователей](/manual/web_interface/frontend_sections/administration/user_roles). {width="600"} Вы можете использовать фильтрацию API токенов по имени, сроку действия и состоянию (актирован/деактивирован). Нажмите на состояние токена в списке, чтобы быстро активировать/деактивировать токен. Вы также можете массово активировать/деактивировать токены, выбрав их из списка и затем нажав на кнопки Активировать/Деактивировать ниже списка. ::: noteimportant Пользователи не имеют возможности просмотреть значение *Токен аутентификации* токенов, назначенных на этих пользователей в Zabbix. Значение *Токен аутентификации* отображается только один раз — сразу после создания токена. Если значение потеряно, токен необходимо сгенерировать заново. ::: #### 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 токены по имени, по пользователям, которым назначены токены, по сроку действия, по пользователям, создавшим токены, или по состоянию (активировано/деактивировано). Щёлкните по состоянию токена в списке, чтобы быстро активировать/деактивировать токен. Вы также можете массово активировать/деактивировать токены, выбрав их в списке и затем нажав на кнопки *Активировать/Отключить (Enable/Disable)* под списком. Чтобы создать новый токен, нажмите на кнопку *Создать API токен (Create API token)* в правом верхнем углу, затем заполните требуемые поля на экране настроек токена:  |Параметр|Описание| |--|--------| |Имя (Name)|Видимое имя токена.| |Пользователь<br>(User)|Пользователь, которому должен быть назначен токен. Чтобы быстро выбрать пользователя, начните вводить имя пользователя, его имя или фамилию, затем выберите нужного пользователя из списка авто-дополнения. Другой вариант — можно нажать кнопку «Выбрать (Select)» и выбрать пользователя из полного списка пользователей. Токен может быть назначен только одному пользователю.| |Описание<br>(Description)|Необязательное описание токена.| |Задать дату и время срока действия<br>(Set expiration date and time)|Снимите этот флажок, если у токена не должно быть даты истечения срока действия.| |Истекает в<br>(Expiry date)|Нажмите на значок календаря чтобы выбрать дату истечения срока действия токена, или введите дату вручную в формате ГГГГ-ММ-ДД чч:мм:сс| |Активировано (Enabled)|Снимите этот флажок, если вам нужно создать токен в деактивированном состоянии.| Нажмите на кнопку «Добавить (Add)», чтобы создать токен. На следующем экране скопируйте и сохраните в надёжном месте значение поля *Токен аутентификации (Auth token)* **до того, как закрывать страницу**, затем нажмите «Закрыть (Close)». Токен появится в списке. ::: notewarning Значение поля *Токен аутентификации (Auth token)* невозможно посмотреть потом. Оно доступно только сразу же после создания токена. Если вы потеряете сохранённый токен, вам придётся сгенерировать его заново, при этом будет создана новая строка авторизации. ::: Щёлкните по имени токена, чтобы изменить его имя, описание, дату истечения срока действия или состояние токена. Обратите внимание, что невозможно изменить то, какому пользователю назначен токен. Нажмите кнопку *Обновить (Update)* для сохранения изменений. Если токен был утерян или раскрыт, вы можете нажать кнопку *Сгенерировать заново (Regenerate)*, чтобы сгенерировать новое значение токена. Появится диалоговое окно подтверждения с запросом подтвердить данную операцию, поскольку после её выполнения ранее сгенерированный токен станет недействительным. Пользователи, не имеющие доступа к разделу меню *Администрирование (Administration)*, могут видеть и менять детали назначенных им токенов в [разделе](/manual/web_interface/user_profile#api-токены) *Профиль пользователя → API токены (User profile → API tokens)*, только если в правах их [роли пользователя](/manual/web_interface/frontend_sections/administration/user_roles) разрешён параметр *Управление токенами API (Manage API tokens)*. # 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 #### Сценарий из реальной жизни В этом примере мы бы хотели настроить сетевое обнаружение для локальной сети, имеющей диапазон IP адресов 192.168.1.1-192.168.1.254. В нашем сценарии мы хотим: - обнаруживать те узлы сети, на которых имеется Zabbix агент - выполнять обнаружение каждые 10 минут - добавлять узел сети для наблюдения, если время работы узла сети более 1 часа - удалять узел сети, если он недоступен на протяжении более 24 часов - добавлять узлы сети Linux в группу «Linux servers» - добавлять узлы сети Windows в группу «Windows servers» - использовать шаблон *Linux* для узлов сети Linux - использовать шаблон *Windows* для узлов сети Windows #### Attempting to use Zabbix sender compiled with TLS support to send data to Zabbix server/proxy compiled without TLS #### Попытка использовать Zabbix sender, скомпилированный с поддержкой TLS, для отсылки данных на Zabbix сервер/прокси, скомпилированный без TLS ##### 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" } ] ``` ##### Атрибуты, возвращающие табличные данные Атрибуты с табличными данными состоят из одного или нескольких составных атрибутов. Если такой атрибут указан в параметре имени атрибута, то значение этого элемента данных вернёт всю структуру атрибута в формате JSON. Значения отдельных элементов из табличных данных можно извлечь с помощью предобработки. Пример атрибута с табличными данными: jmx[com.example:type=Hello,foodinfo] Значение элемента данных: ``` {.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 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.** #### Журнал аудита Значительно переработан функционал журнала аудита. Обновлённый Журнал аудита содержит записи обо всех изменениях конфигурации объектов Zabbix и имеет обновлённый фильтр, который позволяет просматривать записи сгруппированные по операции в веб-интерфейсе. Журналирование можно включить или отключить в разделе *Администрирование* → *Общие* меню. Чтобы реализовать эти изменения, ранее существовавшую структуру базы данных пришлось модернизировать. В процессе обновления БД таблицы `auditlog` и `auditlog_details` будут заменены новой таблицей `auditlog` с отличающимся форматом. **Существующие записи журнала аудита будут удалены.** #### audit log Changes:\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) Audit log object: added support of properties `username`, `recordsetid`, `details`.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) Audit log object: added support of `action` values `8` (Login), `9` (Failed login) and `10` (History clear).\ #### audit log Changes:\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) Audit log object: added support of properties `username`, `recordsetid`, `details`.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) Audit log object: added support of `action` values `8` (Login), `9` (Failed login) and `10` (History clear).\ #### 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).\ #### журнал действий Изменения:\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) Журнал действий объект: прекращена поддержка свойства `note`.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) Журнал действий объект: прекращена поддержка таких значений `resourcetype` как `2`(Настройка Zabbix) и `7`(Элемент графика).\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) Журнал действий объект: прекращена поддержка таких значений `action` как `5`(Активировано) и `6`(Деактивировано).\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `auditlog.get`: прекращена поддержка параметра `selectDetails`.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) Журнал действий объект: прекращена поддержка таких значений `action` как `3` (Вход в систему).\ ### 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"} Это может быть полезно при просмотре всех связанных действий (например, успешные и ошибочные попытки входа в веб-интерфейс) в списке аудита. # 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` будут заменены новой таблицей `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 и сделать журнал аудита более полным и надёжным, ранее существовавшую структуру базы данных было необходимо переработать. В процессе обновления таблицы БД `auditlog` и `auditlog_details` будут заменены новой таблицей `auditlog` с отличным форматом. **Старые записи аудита не будут сохранены.** В меню *Администрирование → Общие* добавлен новый [раздел](/manual/web_interface/frontend_sections/administration/general#журнал-аудита) *Журнал аудита*, который позволяет включить (по умолчанию) или отключить ведение журнала аудита. Настройки очистки истории аудита, ранее располагавшиеся в разделе меню *Очистка истории*, также были перемещены в новый раздел *Журнал аудита*. Существующие настройки очистки истории будут сохранены. #### 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. #### 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. ### 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 Объект журнала аудита содержит информацию о действиях пользователя. Он имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |auditid|string|*(readonly)* ID записи журнала аудита. Генерируется с использованием алгоритма CUID.| |userid|string|Идентификатор автора записи журнала аудита.| |username|string|Имя пользователя автора записи в журнале аудита.| |clock|timestamp|Отметка времени создания записи в журнале аудита.| |ip|string|IP-адрес автора записи журнала аудита.| |action|integer|Действие записи журнала аудита.<br><br>Возможные значения:<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|Тип ресурса записи журнала аудита.<br><br>Возможные значения:<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 - Auth token;<br>46 - Scheduled report;<br>47 - High availability node;<br>48 - SLA.| |resourceid|string|Идентификатор ресурса записи журнала аудита.| |resourcename|string|Удобочитаемое имя ресурса записи журнала аудита.| |recordsetid|string|Идентификатор набора записей записи журнала аудита. Записи журнала аудита, созданные во время одной и той же операции, будут иметь одинаковый идентификатор набора записей. Генерируется с использованием алгоритма CUID.| |details|text|Подробности записи журнала аудита. Детали хранятся в виде объекта JSON, где каждое имя свойства представляет собой путь к свойству или вложенному объекту, в котором произошло изменение, а каждое значение содержит данные об изменении этого свойства в формате массива.<br><br>Возможные форматы значений: :<br>\["add"\] - Добавлен вложенный объект;<br>\["add", "<value>"\] - Свойство добавленного объекта содержит <value>;<br>\[ "update"\] - Вложенный объект обновлен;<br>\["update", "<новое значение>", "<старое значение>"\] - Значение свойства обновляемого объекта изменено с <старое значение > на <новое значение>;<br>\["delete"\] - Вложенный объект удален.| #### Audit log This section allows configuring audit log settings.  The following parameters are available: |Parameter|Description| |--|--------| |Enable audit logging|Enable/disable audit logging. Marked by default.| |Enable internal housekeeping|Enable/disable internal housekeeping for audit. Marked by default.| |Data storage period|Amount of days audit records should be kept for before being removed by the housekeeper. Mandatory if housekeeping is enabled. Default: 365 days.| #### Журнал аудита На этой странице можно настроить параметры журнала аудита.  Доступны следующие параметры: |Параметр|Описание| |--|--------| |Включить журналирование аудита<br>(Enable audit logging)|Включить/отключить ведение журнала аудита. По умолчанию отмечено.| |Активировать внутреннюю очистку истории<br>(Enable internal housekeeping)|Включить/отключить внутреннюю очистку истории для аудита. По умолчанию отмечено.| |Период хранения данных<br>(Data storage period)|Количество дней, в течение которых аудитные записи должны храниться, прежде чем они будут удалены процессом очистки истории. Обязательно, если функция очистки включена. По умолчанию: 365 дней.| **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#журнал-аудита) *Журнал аудита* в меню *Администрирование* → *Общие*, который позволяет включить или отключить журналирование аудита. Настройки очистки истории журнала аудита, ранее располагавшиеся в разделе *Очистка истории*, теперь также перемещены в новый раздел *Журнал аудита*. # 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/ru-ru/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.| ##### Авторизация |Параметр|Описание| |--|--------| |*Попытки входа*<br>*(Login attempts)*|Количество неуспешных попыток входа, прежде чем возможность входа будет заблокирована.| |*Интервал блокировки входа в систему*<br>*(Login blocking interval)*|Период времени, в течение которого вход в систему будет запрещён при превышении лимита *попыток входа*.| ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Zabbix LLC ------------------------------------------------------------------------ [ ]{#оглавление} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Zabbix LLC ------------------------------------------------------------------------ [ ]{#оглавление} #### 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\[\]** требует *Тип информации: Журнал*). Параметр *Тип информации* теперь располагается непосредственно под параметром *Ключ* на основной вкладке *Элемент данных* и дублируется на вкладке *Предобработка*, если указан по крайней мере один шаг предварительной обработки. Если Zabbix обнаруживает возможное несоответствие выбранного типа информации и ключа, то сразу за полем *Тип информации* отобразится иконка с предупреждением. ##### 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\], требуются права root - system.hw.cpu\[all|cpunum,full|maxfreq|vendor|model|curfreq\] — по умолчанию \[all,full\] - system.hw.devices\[pci|usb\] — по умолчанию \[pci\] - system.hw.macaddr\[интерфейс,short|full\] — по умолчанию \[all,full\], интерфейс является регулярным выражением - system.sw.arch - system.sw.os\[name|short|full\] — по умолчанию \[name\] - system.sw.packages\[пакет,менеджер,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>*(Host metadata)*|содержит<br>не содержит<br>совпадает<br>не соответствует|Укажите метаданные узла сети или метаданные узла сети для исключения.<br>**содержит** — метаданные узла сети содержат указанную строку.<br>**не содержит** — метаданные узла сети не содержат указанную строку. Метаданные узла сети можно задать в [файле конфигурации агента](/manual/appendix/config/zabbix_agentd).<br>**совпадает** — метаданные узла сети соответствуют регулярному выражению.<br>**не соответствует** — метаданные узла сети не соответствуют регулярному выражению.| |*Имя узла сети*<br>*(Host name)*|содержит<br>не содержит<br>совпадает<br>не соответствует|Укажите имя узла сети или имя узла сети для исключения.<br>**содержит** — имя узла сети содержит указанную строку.<br>**не содержит** — имя узла сети не содержит указанную строку.<br>**совпадает** — имя узла сети соответствует регулярному выражению.<br>**не соответствует** — имя узла сети не соответствует регулярному выражению.| |*Прокси*<br>*(Proxy)*|равно<br>не равно|Укажите прокси или прокси для исключения:<br>**равно** — используется указанный прокси.<br>**не равно** — используется любой другой прокси, отличный от указанного.| # autoregistration.get # autoregistration.get #### Autoregistration In this section, you can configure the encryption level for active agent autoregistration.  Parameters marked with an asterisk are mandatory. Configuration parameters: |Parameter|Description| |--|--------| |*Encryption level*|Select one or both options for encryption level:<br>**No encryption** - unencrypted connections are allowed<br>**PSK** - TLS encrypted connections with a pre-shared key are allowed| |*PSK identity*|Enter the pre-shared key identity string.<br>This field is only available if 'PSK' is selected as *Encryption level*.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |*PSK*|Enter the pre-shared key (an even number of hexadecimal characters).<br>Maximum length: 512 hex-digits (256-byte PSK) if Zabbix uses GnuTLS or OpenSSL library, 64 hex-digits (32-byte PSK) if Zabbix uses mbed TLS (PolarSSL) library.<br>Example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952<br>This field is only available if 'PSK' is selected as *Encryption level*.| See also: [Secure autoregistration](/manual/discovery/auto_registration#secure_autoregistration) #### Авторегистрация На этом экране вы можете настроить уровень шифрования для автоматической регистрации активного агента.  Параметры, отмеченные звёздочкой, являются обязательными. Параметры настроек: |Параметр|Описание| |--|--------| |*Уровень шифрования*<br>*(Encryption level)*|Выберите один или оба параметра для уровня шифрования:<br>**Без шифрования (No encryption)** — разрешены незашифрованные соединения<br>**PSK** — разрешены зашифрованные соединения TLS с общим ключом (pre-shared key)| |*Идентификатор PSK*<br>*(PSK identity)*|Введите строку идентификатора общего ключа.<br>Это поле доступно только в том случае, если для *Уровня шифрования* выбрано «PSK».<br>Не помещайте конфиденциальную информацию в идентификатор PSK, она передается незашифрованной по сети для информирования получателя, какой PSK использовать.| |*PSK*|Введите общий ключ (чётное число шестнадцатеричных символов).<br>Максимальная длина: 512 шестнадцатеричных цифр (256-байтовый PSK), если Zabbix использует библиотеку GnuTLS или OpenSSL, 64 шестнадцатеричных цифры (32-байтовый PSK), если Zabbix использует библиотеку mbed TLS (PolarSSL).<br>Пример: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952<br>Это поле доступно только в том случае, если для *Уровня шифрования* выбрано «PSK».| Смотрите также: [Безопасная авторегистрация](/manual/discovery/auto_registration#безопасная-авторегистрация). #### 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` никогда не очищалась. Теперь «осиротевшие» записи, которые не ссылаются ни на событие авторегистрации, ни на существующий узел сети, будут удаляться процессом очистки базы данных (Housekeeper). # 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 серверу: - добавьте элемент данных количества запросов в секунду к набору данных - выберите функцию агрегации `сред` и укажите период `1d` - отобразится столбчатый график, где каждый столбец будет представлять среднее количество запросов в секунду за день ### Backward incompatible changes ### Обратно несовместимые изменения ::: banner{.banner-main-top} # Welcome to Zabbix Documentation Your go-to resource for working with Zabbix monitoring, from basic setups to advanced configurations. This manual covers everything needed to install, configure, and operate Zabbix. [What's new in Zabbix 6.0](/manual/introduction/whatsnew600){.button} ::: ::: banner{.banner-main-top} # Добро пожаловать в документацию Zabbix Ваш незаменимый помощник в работе с мониторингом Zabbix, от базовых настроек до расширенных конфигураций. В этом руководстве описано всё необходимое для установки, настройки и эксплуатации Zabbix. [Что нового в Zabbix 6.0](/manual/introduction/whatsnew600){.button} ::: #### 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**. - **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](#post-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 ``` * Следуйте [инструкциям по пост-миграции](#пост-миграция) для удаления старых таблиц. #### 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*|игнорировать|вернуть bucket rate|игнорировать|игнорировать|игнорировать|игнорировать| |*count_foreach*|игнорировать|вернуть количество|0|игнорировать|игнорировать|игнорировать| |*exists_foreach*|игнорировать|1|1|игнорировать|1|n/a| |*last_foreach*|игнорировать|вернуть последнее|игнорировать|игнорировать|игнорировать|игнорировать| |*max_foreach*|игнорировать|вернуть максимум|игнорировать|игнорировать|игнорировать|игнорировать| |*min_foreach*|игнорировать|вернуть минимум|игнорировать|игнорировать|игнорировать|игнорировать| |*sum_foreach*|игнорировать|вернуть сумму|игнорировать|игнорировать|игнорировать|игнорировать| Если для элемента данных указано *игнорировать*, к агрегированию ничего не добавляется. # Best practices for secure Zabbix setup # Наилучшие практики для безопасной установки Zabbix # Best practices for secure Zabbix setup [comment]: # (tags: ssl) # Наилучшие практики для безопасной установки Zabbix [comment]: # (tags: ssl) #### 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). ### Критические изменения #### Версионирование подгружаемых модулей [Подгружаемые плагины](/manual/config/items/plugins#loadable) для Zabbix агента 2 теперь используют ту же систему версий, как и сам 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). ### Критические изменения #### Версионирование подгружаемых модулей [Подгружаемые плагины](/manual/config/items/plugins#подгружаемые) для Zabbix агента 2 теперь используют ту же систему версий, как и сам Zabbix. Были сделаны следующие изменения версий: - MongoDB 1.2.0 -> MongoDB 6.0.13 - PostgreSQL 1.2.1 -> PostgreSQL 6.0.13 Эти плагины поддерживаются для любой минорной версии Zabbix 6.0. Обратите внимание, что репозиторий исходного кода для каждого плагина теперь содержит выделенную ветвь *release/6.0* (ранее имелась только ветвь *master*). ##### 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 ##### Сборка 32-битной 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 ##### Сборка 64-битной 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 PCRE: $ brew install pcre 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 #### Сборка бинарных файлов агента с разделяемыми библиотеками Установите PCRE: $ brew install pcre При сборке с 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 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, в этом руководстве будет использоваться mini-gmp, который включен в Nettle. После успешной сборки GnuTLS и Nettle рекомендуется выполнить `make test`. Иногда, даже после успешной сборки, тесты завершаются с ошибками. Если тесты завершаются с ошибками, проблемы необходимо рассмотреть и исправить перед тем как продолжить. Предположим, что статические библиотеки 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 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 PCRE 8.42, Nettle 3.4.1 and GnuTLS 3.6.5. $ PCRE_PREFIX="$HOME/static-libs/pcre-8.42" $ 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-libpcre="$PCRE_PREFIX" --with-gnutls="$GNUTLS_PREFIX" $ make $ make install #### Сборка бинарных файлов агента со статическими библиотеками с GnuTLS GnuTLS зависит от крипто-серверной библиотеи Nettle и арифмитической библиотеки GMP. Вместо использования полной библиотеки GMP, в этом руководстве будет использована mini-gmp которая включена в Nettle. После успешной сборки GnuTLS и Nettle, рекомендуется выполнить `make check`. Даже, если сборка прошла успешно, тесты иногда завершаются с ошибкой. Если это тот самый случай, проблемы необходимо исследовать и решить перед тем как продолжить. Предположим, что статические библиотеки PCRE, Nettle и GnuTLS будут установлены в `$HOME/static-libs`. Мы будем использовать PCRE 8.42, Nettle 3.4.1 и GnuTLS 3.6.5. $ PCRE_PREFIX="$HOME/static-libs/pcre-8.42" $ 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-libpcre="$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 Загрузите и соберите 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 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 PCRE 8.42 and OpenSSL 1.1.1a. $ PCRE_PREFIX="$HOME/static-libs/pcre-8.42" $ 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://ftp.pcre.org/pub/pcre/pcre-8.42.tar.gz $ tar xf pcre-8.42.tar.gz $ cd pcre-8.42 $ ./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-libpcre="$PCRE_PREFIX" --with-openssl="$OPENSSL_PREFIX" $ make $ make install #### Сборка бинарных файлов агента со статическими библиотеками с OpenSSL После успешной сборки OpenSSL, рекомендуется выполнить `make test`. Даже, если сборка прошла успешно, тесты иногда завершаются с ошибкой. Если это тот самый случай, проблемы необходимо исследовать и решить перед тем как продолжить. Предположим, что статические библиотеки PCRE и OpenSSL будут установлены в `$HOME/static-libs`. Мы будем использовать PCRE 8.42 и OpenSSL 1.1.1a. $ PCRE_PREFIX="$HOME/static-libs/pcre-8.42" $ OPENSSL_PREFIX="$HOME/static-libs/openssl-1.1.1a" Давайте соберём статические библиотеки в `static-libs-source`: $ mkdir static-libs-source $ cd static-libs-source Загрузите и соберите PCRE с поддержкой свойств Юникод: $ curl --remote-name https://ftp.pcre.org/pub/pcre/pcre-8.42.tar.gz $ tar xf pcre-8.42.tar.gz $ cd pcre-8.42 $ ./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-libpcre="$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 Предположим, что статические библиотеки PCRE уже установлены в `$HOME/static-libs`. Мы будем использовать PCRE2 10.39. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" Загрузите и соберите 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 agent binaries with static libraries without TLS Let's assume that PCRE static libraries will be installed in `$HOME/static-libs`. We will use PCRE 8.42. $ PCRE_PREFIX="$HOME/static-libs/pcre-8.42" Download and build PCRE with Unicode properties support: $ mkdir static-libs-source $ cd static-libs-source $ curl --remote-name https://ftp.pcre.org/pub/pcre/pcre-8.42.tar.gz $ tar xf pcre-8.42.tar.gz $ cd pcre-8.42 $ ./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-libpcre="$PCRE_PREFIX" $ make $ make install #### Сборка бинарных файлов агента со статическими библиотеками без TLS Предположим, что статические библиотеки PCRE будут установлены в `$HOME/static-libs`. Мы будем использовать PCRE 8.42. $ PCRE_PREFIX="$HOME/static-libs/pcre-8.42" Загрузите и соберите PCRE с поддержкой свойств Юникод: $ mkdir static-libs-source $ cd static-libs-source $ curl --remote-name https://ftp.pcre.org/pub/pcre/pcre-8.42.tar.gz $ tar xf pcre-8.42.tar.gz $ cd pcre-8.42 $ ./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-libpcre="$PCRE_PREFIX" $ make $ make install #### Building inventory #### Построение инвентарных данных ##### Building modules Modules are currently meant to be built inside Zabbix source tree, because the module API depends on some data structures that are defined in Zabbix headers. The most important header for loadable modules is **include/module.h**, which defines these data structures. Other necessary system headers that help **include/module.h** to work properly are **stdlib.h** and **stdint.h**. With this information in mind, everything is ready for the module to be built. The module should include **stdlib.h**, **stdint.h** and **module.h**, and the build script should make sure that these files are in the include path. See example "dummy" module below for details. Another useful header is **include/log.h**, which defines **zabbix\_log()** function, which can be used for logging and debugging purposes. ##### Сборка модулей В настоящее время подразумевается, что модули должны быть собраны внутри дерева исходных кодов Zabbix, так как API модулей зависит от некоторых структур данных, которые определены в заголовках Zabbix. Наиболее важный заголовок для подгружаемых модулей — **include/module.h**, который определяет эти структуры данных. Другие необходимые системные заголовки, которые помогают **include/module.h** работать должным образом, — это **stdlib.h** и **stdint.h**. С учётом этой информации, все готово для сборки модуля. Модуль должен включать **stdlib.h**, **stdint.h** и **module.h**, а скрипт сборки должен понимать, что эти файлы указаны в путях include. Смотрите пример модуля «dummy» ниже для получения деталей. Другим полезный заголовком является **include/log.h**, который определяет функцию **zabbix\_log()**, её можно использовать для журналирования и отладки. ### 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|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[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.0https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/docker/README.md?at=refs)|Мониторинг CPU (количество CPU / ядер CPU, обнаруженные CPU, процент использования).|system.cpu.discovery, system.cpu.num, system.cpu.util|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[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|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[Kernel](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/kernel?at=refs%2Fheads%2Frelease%2F6.0)|Мониторинг ядра.|kernel.maxfiles, kernel.maxproc|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[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|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.<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, memchached.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|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[MQTT](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mqtt/README.md?at=refs%2Fheads%2Frelease%2F6.)|Получение опубликованных значений тем MQTT.|mqtt.get|Чтобы настроить шифрованное соединение к брокеру MQTT, укажите параметры TLS в конфигурационном файле агента как [именованные сессии](#именованные-сессии) или параметры [по умолчанию](#значения-по-умолчанию). В настоящее время параметры 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 для именованной сессии в файле конфигурации агента. В настоящее время параметры 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|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[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|Поддерживаемый ключ имеет такие же параметры, что и [ключ](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[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)|Мониторинг S.M.A.R.T.|smart.attribute.discovery, smart.disk.discovery, smart.disk.get|Минимально требуемая версия smartctl — 7.1.<br>Пользователю, из под которого работает Zabbix агент 2, требуются права доступа sudo/root к smartctl. Плагин использует только следующие команды: <br> ``/usr/sbin/smartctl -a *``<br> ``/usr/sbin/smartctl --scan *`` <br> ``/usr/sbin/smartctl -j -V``<br><br><br>Поддерживаемые [ключи](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) можно использовать только с Zabbix агентом 2 только на Linux/Windows, как пассивными, так и активными проверками.<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|Поддерживаемый ключ имеет такие же параметры, что и [ключ](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |SystemRun|Выполнение указанной команды.|system.run|Поддерживаемый ключ имеет такие же параметры, что и [ключ](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.<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|Поддерживаемый ключ имеет такие же параметры, что и [ключ](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[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|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[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|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[Uptime](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/uptime?at=refs%2Fheads%2Frelease%2F6.0)|Сбор метрик времени работы системы.|system.uptime|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[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|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[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.page.get, web.page.perf, web.page.regexp|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[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|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[ZabbixStats](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/stats?at=refs%2Fheads%2Frelease%2F6.0)|Внутренние метрики Zabbix сервера / прокси или количество элементов данных в очереди.|zabbix.stats|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| |[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.|Поддерживаемые ключи имеют такие же параметры, что и [ключи](/manual/config/items/itemtypes/zabbix_agent) Zabbix агента.| ##### 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. ##### Массовая обработка Для зависимых метрик поддерживается массовая обработка. Чтобы включить кэширование и индексацию, **первым** шагом предварительной обработки должен быть *Шаблон Prometheus*. Когда *Шаблон Prometheus* является первым шагом предварительной обработки, тогда проанализированные данные Prometheus кэшируются и индексируются по первому условию `<метка>==<значение>` в шаге предварительной обработки *Шаблон Prometheus*. Этот кэш используется повторно при обработке остальных зависимых элементов данных в этом пакете. Для достижения оптимальной производительности первая метка должна быть одной из тех, у которых наиболее разные значения. Если другие операции предварительной обработки необходимо выполнить до первого шага, то их необходимо переместить либо в основной элемент данных, либо в новый зависимый элемент данных, который затем можно использовать в качестве основного элемента данных для этих зависимых элементов данных. #### 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. #### User passwords Previously, spaces in user passwords have been automatically trimmed in both the User configuration form and the Login form. After the introduction of configurable [password complexity requirements](/manual/introduction/whatsnew600#password_requirements), spaces in passwords are no longer trimmed. So users, who thought that they had spaces in their passwords, will not be able to log in as usual and will have to enter their 'old' password without spaces. To continue using passwords with spaces, they will need to recreate their passwords. #### 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. ##### 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 внедрена массовая обработка зависимых элементов данных, зависимые элементы данных более не обрабатываются параллельно, что может повлиять на скорость их обработки. ##### 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. ##### Кнопки Кнопки справа предоставляют следующие опции: | | | |--|--------| |<br>*(Изменить карту сети)*|Переход в конструктор карты сети для редактирования её содержимого.| ||Добавление карты в виджет избранного на [Панели](dashboard).| ||Карта уже находится в виджете избранного на [Панели](dashboard). Нажмите, чтобы удалить карту из виджета избранного.| Кнопки режима просмотра, являющиеся общими для всех разделов, описаны на странице [Мониторинг](/manual/web_interface/frontend_sections/monitoring#кнопки-режима-просмотра). ##### 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#кнопки-режима-просмотра). ##### 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)*|Экспорт содержимого всех страниц в файл CSV.| Кнопки режима просмотра, одинаковые для всех разделов, описаны на странице [Мониторинг](/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#кнопки-режима-просмотра). ##### 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#кнопки-режима-просмотра). ##### 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#кнопки-режима-просмотра). 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 К [настройкам](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#параметры) плагина PostgreSQL были добавлены новые параметры для управления режимом кэширования по умолчанию либо на уровне именованной сессии: - `Plugins.PostgreSQL.Default.CacheMode` - `Plugins.PostgreSQL.Sessions.<ИмяСессии>.CacheMode` Параметр режима кэширования может иметь одно из двух разрешённых значений: *prepare* (по умолчанию) или *describe*. Обратите внимание, что «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 [date and time](/manual/appendix/functions/time) and/or nodata() functions are used in the expression. [Date and time](/manual/appendix/functions/time) and/or nodata() functions 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). #### Время вычисления Триггер пересчитывается каждый раз, когда Zabbix сервер получает новое значение, которое является частью выражения. Когда получено новое значение, каждая функция, которая включена в выражение, пересчитывается (не только та, что получила новое значение). Кроме того, триггер пересчитывается каждый раз, когда получено новое значение, **и** каждые 30 секунд, если в выражении триггера используются функции [даты и времени](/manual/appendix/functions/time) и/или функция nodata(). Функции [даты и времени](/manual/appendix/functions/time) и/или функция nodata() пересчитываются каждые 30 секунд процессами синхронизации истории Zabbix (history syncer). Триггеры, которые ссылаются **только** на функции динамики изменений, вычисляются один раз за наименьший период в выражении. Смотрите также [функции динамики изменений](/manual/appendix/functions/trends). ::: card #### How-to videos A video library featuring demonstrations, discussions, and tips to help you make the most of Zabbix. [](https://www.youtube.com/playlist?list=PL0mpo4XDX5eE2lpPbtQioJUULLHGPpcJX){.card-link} ::: ::: card #### Видеоинструкции Видеотека с демонстрациями, обсуждениями и советами, которые помогут вам максимально эффективно использовать Zabbix. [](https://www.youtube.com/playlist?list=PL0mpo4XDX5eE2lpPbtQioJUULLHGPpcJX){.card-link} ::: ::: card #### Installation Step-by-step instructions to install Zabbix on your preferred platform, covering various operating systems and database configurations. [](/manual/installation/getting_zabbix){.card-link} ::: ::: card #### Установка Пошаговая инструкция по установке Zabbix на выбранную вами платформу, охватывающая различные операционные системы и конфигурации баз данных. [](/manual/installation/getting_zabbix){.card-link} ::: ::: card #### Quickstart guides Concise, task-oriented how-tos that walk you through the basics—from your first configuration steps to receiving your first problem alert. [](/manual/quickstart/login){.card-link} ::: ::: card #### Руководства по быстрому старту Краткие, ориентированные на выполнение задач пошаговые инструкции, которые помогут вам освоить основы — от первых шагов по настройке до получения первого оповещения о проблеме. [](/manual/quickstart/login){.card-link} ::: ::: card #### Requirements A list of supported platforms and software prerequisites to help you prepare your environment for a successful Zabbix deployment. [](/manual/installation/requirements){.card-link} ::: ::: card #### Требования Список поддерживаемых платформ и необходимых программных компонентов, чтобы помочь вам подготовить среду для успешного развёртывания Zabbix. [](/manual/installation/requirements){.card-link} ::: ::: card #### Zabbix Blog News, tutorials, and case studies curated by the Zabbix team and community contributors. [](https://blog.zabbix.com/){.card-link} ::: ::: card #### Блог Zabbix Новости, обучающие материалы и примеры из практики, подготовленные командой Zabbix и участниками сообщества. [](https://blog.zabbix.com/){.card-link} ::: ::: card #### Zabbix Forums A space to exchange ideas, find solutions, and share experiences across all levels of Zabbix expertise. [](https://www.zabbix.com/forum/){.card-link} ::: ::: card #### Форумы Zabbix Пространство для обмена идеями, поиска решений и обмена опытом между специалистами Zabbix всех уровней. [](https://www.zabbix.com/forum/){.card-link} ::: ### Ceph |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |ceph.df.details\[connString,<user>,<apikey>\]|<|<|<| |Cluster’s data usage and distribution among pools.|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.osd.stats\[connString,<user>,<apikey>\]|<|<|<| |Aggregated and per OSD statistics.|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.osd.discovery\[connString,<user>,<apikey>\]|<|<|<| |List of discovered OSDs. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.osd.dump\[connString,<user>,<apikey>\]|<|<|<| |Usage thresholds and statuses of OSDs.|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.ping\[connString,<user>,<apikey>\]|<|<|<| |Tests whether a connection to Ceph can be established.|0 - connection is broken (if there is any error presented including AUTH and configuration issues)<br><br>1 - connection is successful.|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.pool.discovery\[connString,<user>,<apikey>\]|<|<|<| |List of discovered pools. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.status\[connString,<user>,<apikey>\]|<|<|<| |Overall cluster's status.|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | ### Ceph |Ключ|<|<|<| |--|--|------|------| |**Описание**|**Возвращаемое значение**|**Параметры**|**Комментарии**| |ceph.df.details \[строка_подкл, <пользователь>, <ключ_api>\]|<|<|<| |Использование данных кластера и распределение между пулами.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**пользователь, ключ_api** — имя пользователя и ключ API для подключения к Ceph.| | |ceph.osd.stats \[строка_подкл, <пользователь>, <ключ_api>\]|<|<|<| |Агрегированная статистика и статистика по каждому OSD.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**пользователь, ключ_api** — имя пользователя и ключ API для подключения к Ceph.| | |ceph.osd.discovery \[строка_подкл, <пользователь>, <ключ_api>\]|<|<|<| |Список обнаруженных OSD. Используется [низкоуровневым обнаружением](/manual/discovery/low_level_discovery).|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**пользователь, ключ_api** — имя пользователя и ключ API для подключения к Ceph.| | |ceph.osd.dump \[строка_подкл, <пользователь>, <ключ_api>\]|<|<|<| |Пороги использования и состояния OSD.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**пользователь, ключ_api** — имя пользователя и ключ API для подключения к Ceph.| | |ceph.ping \[строка_подкл, <пользователь>, <ключ_api>\]|<|<|<| |Проверка, можно ли установить подключение к Ceph.|0 — подключение разорвано (если имеется какая-либо ошибка, включая проблемы с аутентификацией или проблемы с настройками)<br>1 — подключение успешно.|**строка_подкл** — URI или имя сессии.<br>**пользователь, ключ_api** — имя пользователя и ключ API для подключения к Ceph.| | |ceph.pool.discovery \[строка_подкл, <пользователь>, <ключ_api>\]|<|<|<| |Список обнаруженных пулов. Используется [низкоуровневым обнаружением](/manual/discovery/low_level_discovery).|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**пользователь, ключ_api** — имя пользователя и ключ API для подключения к Ceph.| | |ceph.status \[строка_подкл, <пользователь>, <ключ_api>\]|<|<|<| |Общее состояние кластера.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**пользователь, ключ_api** — имя пользователя и ключ API для подключения к Ceph.| | #### Certificate configuration parameters The following configuration parameters are supported for setting up certificates on Zabbix components. |Parameter|Mandatory|Description| |--|-|--------| |*TLSCAFile*|yes|Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification.<br>If using a certificate chain with multiple members, order the certificates with lower level CA(s) certificates first, followed by higher level CA(s) certificates.<br>Certificates from multiple CAs can be included in a single file.| |*TLSCRLFile*|no|Full pathname of a file containing [Certificate Revocation Lists (CRL)](#certificate-revocation-lists-crl).| |*TLSCertFile*|yes|Full pathname of a file containing the certificate.<br>If using a certificate chain with multiple members, order the certificates with the server, proxy, or agent certificate first, followed by lower level CA(s) certificates, and concluded by higher level CA(s) certificates.| |*TLSKeyFile*|yes|Full pathname of a file containing the private key.<br>Ensure that this file is readable only by the [Zabbix user](/manual/installation/install#create-user-account) by setting appropriate access rights.| |*TLSServerCertIssuer*|no|Allowed server certificate issuer.| |*TLSServerCertSubject*|no|Allowed server certificate subject.| #### Параметры настройки сертификатов |Параметр|Обязателен|Описание| |--|-|--------| |*TLSCAFile*|да|Абсолютный путь к файлу, который содержит сертификаты CA верхнего уровня для верификации сертификата узла.<br>При наличии цепочки сертификатов с несколькими членами, они должны быть упорядочены: сначала сертификаты CA нижних уровней, за ними следуют сертификаты CA более высокого уровня.<br>Сертификаты из нескольких CA можно включать в один файл.| |*TLSCRLFile*|нет|Абсолютный путь к файлу, который содержит [Списки отозванных сертификатов (CRL)](#списки-отозванных-сертификатов-crl).| |*TLSCertFile*|да|Абсолютный путь к файлу, который содержит сертификат.<br>В случае цепочки сертификатов с несколькими членами они должны быть упорядочены: сначала сертификат сервера, прокси или агента, затем сертификаты CA нижних уровней и в завершение — сертификаты CA более высокого уровня.| |*TLSKeyFile*|да|Абсолютный путь к файлу, который содержит закрытый ключ (private key). Убедитесь, что этот файл доступен для чтения только [пользователю Zabbix](/manual/installation/install#создайте-аккаунт-пользователя), выставив соответствующие права доступа.| |*TLSServerCertIssuer*|нет|Разрешённый эмитент сертификата сервера.| |*TLSServerCertSubject*|нет|Разрешённый субъект сертификата сервера.| #### Certificate Revocation Lists (CRL) If a certificate is compromised, the Certificate Authority (CA) can revoke it by including the certificate in a Certificate Revocation List (CRL). CRLs are managed through configuration files and can be specified using the `TLSCRLFile` parameter in server, proxy, and agent configuration files. For example: ```ini TLSCRLFile=/home/zabbix/zabbix_crl_file.crt ``` In this case, `zabbix_crl_file.crt` may contain CRLs from multiple CAs, and could look like this: ```ini -----BEGIN X509 CRL----- MIIB/DCB5QIBATANBgkqhkiG9w0BAQUFADCBgTETMBEGCgmSJomT8ixkARkWA2Nv ... treZeUPjb7LSmZ3K2hpbZN7SoOZcAoHQ3GWd9npuctg= -----END X509 CRL----- -----BEGIN X509 CRL----- MIIB+TCB4gIBATANBgkqhkiG9w0BAQUFADB/MRMwEQYKCZImiZPyLGQBGRYDY29t ... CAEebS2CND3ShBedZ8YSil59O6JvaDP61lR5lNs= -----END X509 CRL----- ``` The CRL file is loaded only when Zabbix starts. To update the CRL, restart Zabbix. ::: noteimportant If Zabbix components are compiled with OpenSSL and CRLs are used, ensure that each top-level and intermediate CA in the certificate chains has a corresponding CRL (even if it is empty) included in the `TLSCRLFile`. ::: #### Списки отозванных сертификатов (CRL) Если сертификат скомпрометирован, CA может отозвать его, включив сертификат в список отозванных сертификатов (CRL). Списки CRL можно настраивать в файлах конфигурации сервера, прокси и агента, используя параметр `TLSCRLFile`. Например: ```ini TLSCRLFile=/home/zabbix/zabbix_crl_file.crt ``` Файл `zabbix_crl_file.crt` в данном случае может содержать списки CRL от нескольких CA и мог бы выглядеть следующим образом: ```ini -----BEGIN X509 CRL----- MIIB/DCB5QIBATANBgkqhkiG9w0BAQUFADCBgTETMBEGCgmSJomT8ixkARkWA2Nv ... treZeUPjb7LSmZ3K2hpbZN7SoOZcAoHQ3GWd9npuctg= -----END X509 CRL----- -----BEGIN X509 CRL----- MIIB+TCB4gIBATANBgkqhkiG9w0BAQUFADB/MRMwEQYKCZImiZPyLGQBGRYDY29t ... CAEebS2CND3ShBedZ8YSil59O6JvaDP61lR5lNs= -----END X509 CRL----- ``` CRL файл загружается только при запуске Zabbix. Для обновления CRL перезапустите Zabbix. ::: noteimportant Если компоненты Zabbix скомпилированы с *OpenSSL* и используются списки CRL, убедитесь, что каждый CA верхнего и промежуточного уровней в цепочках сертификатов имеет соответствующий список CRL (даже если он пустой), включённый в `TLSCRLFile`. ::: #### 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()**, позволяющая подсчитать количество изменений между смежными значениями. Эта функция поддерживает три различных режима для подсчёта всех изменений, только уменьшающихся или только увеличивающихся. Например, эту функцию можно использовать для отслеживания изменений количества пользователей или количества систем, где время работы уменьшается. #### 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()**, позволяющая подсчитать количество изменений между смежными значениями. Эта функция поддерживает три различных режима: для подсчёта всех изменений, только уменьшающихся или только увеличивающихся. Например, эту функцию можно использовать для отслеживания изменений количества пользователей или количества систем, где время работы уменьшается. #### 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 } ``` #### Изменение узлов сети, отслеживаемых прокси-сервером Обновить прокси для мониторинга двух заданных узлов сети. Запрос: ```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 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 } ``` #### 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) (вместе с его [бессерверной версией кластера](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 by HTTP* для мониторинга службы OpenStack Nova - [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) был обновлён для работы с такими функциями AlwaysOn, как Экземпляры отказоустойчивого кластера (Failover Cluster Instances, FCI) и Группы доступности (Availability Groups, AG). Теперь шаблон можно использовать для мониторинга узла в кластере, автономного хоста и хоста по имени кластера. Макрос для имени экземпляра более не используется; при переключении не требуется менять никакие макросы: - добавлены новые правила 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 Cluster by HTTP* для мониторинга каждого кластера YugabyteDB. #### 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 (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, отказоустойчивости (high availability, HA), wireless termination points (WTPs), проверкам работоспособности SD-WAN и датчикам оборудования. - Шаблон [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». У правил низкоуровневого обнаружения «Database discovery» и «Replication discovery» тип изменён на «Зависимый элемент данных». - Шаблон [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» и «Oracle: Get tablespace». У правил низкоуровневого обнаружения «Archive log discovery», «ASM disk groups discovery», «Database discovery», «PDB discovery» и «Tablespace discovery» тип был изменён на «Зависимый элемент данных». - Шаблон гипервизора VMware в наборах шаблонов [VMware](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware?at=refs%2Fheads%2Frelease%2F6.0) и [VMware FQDN](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware_fqdn?at=release%2F6.0) был дополнен новым правилом низкоуровневого обнаружения, «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* теперь содержит два правила обнаружения: - Обнаружение сборщиков мусора - Обнаружение пулов памяти #### 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). **Обновлённые шаблоны** [Шаблоны операционных систем](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/os?at=refs%2Fheads%2Frelease%2F6.0) (агент, SNMP и на основе Prometheus) получили обновление смонтированных файловых систем. В обнаружении смонтированных файловых систем, триггеры "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 Data Center. #### 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 (масштабируемый набор виртуальных машин Azure по 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 Hypervisor* в наборах шаблонов [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) был обновлен с возможностью использования в качестве отдельного шаблона. - В шаблон [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-агента-2). #### 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* — мониторинг ОС TrueNAS хранилища по SNMP - *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 правило *Attribute discovery* удалено, поскольку LLD правило *Disk discovery* теперь обнаруживает диски на основе предопределённого набора атрибутов производителей; - Элемент данных **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\] ##### Изменения в шаблонах - К соответствующим именам и описаниям элементов данных добавлен {\#FSLABEL} макрос в *Windows by Zabbix agent* и *Windows by Zabbix agent active* шаблоны - Элемент данных vfs.file.cksum\[/etc/passwd\] агента изменен на vfs.file.cksum\[/etc/passwd,sha256\] ##### 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). ##### Изменения в шаблонах - Добавлен макрос {\#FSLABEL} в соответствующие имена элементов данных и описания в шаблонах *Windows by Zabbix agent* и *Windows by Zabbix agent active*; - Элемент данных агента vfs.file.cksum\[/etc/passwd\] изменён на vfs.file.cksum\[/etc/passwd,sha256\]; - Добавлена новая проверка zabbix\[process,odbc poller,avg,busy\] в шаблоны *Zabbix server*, *Zabbix proxy*, *Remote Zabbix server* и *Remote Zabbix proxy*. Эта метрика используется для мониторинга среднего времени, в течение которого процессы ODBC были заняты за последнюю минуту (в процентах). #### Changes to AlmaLinux 8 configuration The appliance is based on AlmaLinux 8. There are some changes applied to the base AlmaLinux configuration. #### Изменения в конфигурации AlmaLinux 8 Готовое решение базируется на AlmaLinux 8. В базовую конфигурацию AlmaLinux внесены некоторые изменения. ##### Changes to Zabbix configuration - Frontend timezone is set to Europe/Riga (this can be modified in **/etc/php-fpm.d/zabbix.conf**); ##### Изменения в настройках Zabbix - Часовой пояс веб-интерфейса изменён на Europe/Riga (этот параметр можно изменить в **/etc/php-fpm.d/zabbix.conf**). #### 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. ##### Отключено изменение зависимостей по унаследованным триггерам Возможность изменения зависимостей у триггеров, которые унаследованы от шаблонов, теперь отключена. Причина в том, что при обновлении зависимостей у триггера на уровне шаблона, все зависимости унаследованных триггеров перезаписываются. Таким образом, надежнее всегда задавать зависимости триггеров только на корневом уровне шаблона. #### 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 } ``` #### Изменение маппинга для одного преобразования значений. Запрос: ```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 } ``` Ответ: ```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 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 } ``` #### Изменение интерфейса прототипа элемента данных Изменить интерфейс узла сети, который будет использоваться обнаруженными элементами данных. Запрос: ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "27428", "interfaceid": "132" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27428" ] }, "id": 1 } ``` #### Changing the size of a graph prototype Change the size of a graph prototype to 1100 to 400 pixels. Request: ```json { "jsonrpc": "2.0", "method": "graphprototype.update", "params": { "graphid": "439", "width": 1100, "height": 400 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### Изменение размера прототипа графика Изменить размер прототипа графика на 1100х400 пикселей. Запрос: ```json { "jsonrpc": "2.0", "method": "graphprototype.update", "params": { "graphid": "439", "width": 1100, "height": 400 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` ##### Changing time zone By default the appliance uses UTC for the system clock. To change the time zone, copy the appropriate file from */usr/share/zoneinfo* to */etc/localtime*, for example: cp /usr/share/zoneinfo/Europe/Riga /etc/localtime ##### Изменение часового пояса По умолчанию готовое решение использует UTC для системного времени. Чтобы изменить часовой пояс, скопируйте соответствующий файл из */usr/share/zoneinfo* в */etc/localtime*, например: cp /usr/share/zoneinfo/Europe/Riga /etc/localtime #### 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 } ``` #### Изменение роли пользователя Изменить роль пользователя. Запрос: ```json { "jsonrpc": "2.0", "method": "user.update", "params": { "userid": "12", "roleid": "6" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```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". Запрос: ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "name": "Device status" }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Ответ: ```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. #### Проверка на неподдерживаемое значение В этом примере используется шаг предварительной обработки [Проверка на неподдерживаемое значение (Check for not supported value)](/manual/config/items/preprocessing#configuration) для проверки того, что не удалось извлечь значение элемента данных. Когда процесс поллера Zabbix сервера/прокси пытается собрать значение элемента данных, он может: - Вернуть корректный результат. - Вернуть результат, который изначально кажется корректным, но может стать неподдерживаемым позже (например, из-за несоответствия типов значения после предобработки). - Вернуть ошибку получения значения, в результате чего элемент станет неподдерживаемым. Распространённые причины включают: - Неизвестный ключ элемента данных (для Zabbix агента, Простой проверки или внутренних элементов данных Zabbix) - Неизвестный OID (SNMP агент), неизвестный датчик (IPMI агент) или отсутствие метрики JMX (JMX агент) - Невозможность прочитать файл трапов (SNMP trap) - Скрипт не найден (Внешняя проверка) - Нет такого URL (HTTP агент) - Неуспешный вход (SSH агент, TELNET агент) - Недопустимый синтаксис формулы (Вычисляемый), ошибка синтаксиса JavaScript (Скрипт) или некорректный SQL (Монитор баз данных) Чтобы обнаружить и обработать ошибки сбора значений элементов данных, вы можете использовать шаг предварительной обработки «Проверка на неподдерживаемое значение (Check for not supported value)». Обратите внимание, что этот шаг всегда выполняется первым и обнаруживает только ошибки, которые возникают до начала предварительной обработки. На вкладке *Предобработка (Preprocessing)* элемента данных выберите шаг предобработки «Проверка на неподдерживаемое значение (Check for not supported value)». Затем используйте параметр *Другое при ошибке (Custom on fail)*, чтобы отбросить значение (в данном случае ошибку), задать пользовательское значение или вернуть пользовательское сообщение об ошибке. Обратите внимание, что [отброшенные](/manual/config/items/preprocessing#discardunchanged) значения в базе данных не сохраняются; в результате триггеры не вычисляются и данные о динамике изменений не генерируются. #### Checking retrieved value type This example uses the [Custom multiplier](/manual/config/items/preprocessing#configuration) preprocessing step to check if the retrieved item value type is numeric. In the *Preprocessing* tab of an item, select the "Custom multiplier" preprocessing step and set the following parameter: ```bash # Multiplies the retrieved value by 1: number: 1 ``` ::: noteimportant If preprocessing fails (e.g., input is not numeric), then the item becomes unsupported with a corresponding error message. To avoid this, mark the "Custom on fail" checkbox and select an option such as discarding the value or setting a custom one. Please note that [discarded](/manual/config/items/preprocessing#configuration) values are not stored in the database; as a result, triggers are not evaluated and trend data is not generated. ::: #### Проверка типа полученного значения В этом примере используется шаг предварительной обработки [Пользовательский множитель](/manual/config/items/preprocessing#настройка) для проверки того, является ли тип полученного значения элемента данных числовым. На вкладке *Предобработка* элемента данных выберите шаг предварительной обработки «Пользовательский множитель» и задайте следующий параметр: ```bash # Домножить полученное значение на 1: число: 1 ``` ::: noteimportant Если предварительная обработка не удалась (например, значение на входе не является числовым), то элемент данных становится неподдерживаемым с соответствующим сообщением об ошибке. Чтобы избежать этого, отметьте флажок «Другое при ошибке» и выберите параметр, например, отбрасывание значения или установка пользовательского значения. Обратите внимание, что [отброшенные](/manual/config/items/preprocessing#настройка) значения не сохраняются в базе данных; в результате триггеры не пересчитываются и данные о динамике изменений не генерируются. ::: #### 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*|7.2.5| | |*PHP memory\_limit*|128MB|В php.ini:<br>memory\_limit = 128M| |*PHP опция post\_max\_size*|16MB|В php.ini:<br>post\_max\_size = 16M| |*PHP опция upload\_max\_filesize*|2MB|В php.ini:<br>upload\_max\_filesize = 2M| |*PHP опция max\_execution\_time*|300 секунд (значения 0 и -1 разрешены)|В php.ini:<br>max\_execution\_time = 300| |*PHP опция max\_input\_time*|300 seconds (значения 0 и -1 разрешены)|В php.ini:<br>max\_input\_time = 300| |*PHP опция session.auto\_start*|должна быть отключена|В php.ini:<br>session.auto\_start = 0| |*Поддержка базы данных*|Одна из: MySQL, Oracle, PostgreSQL.|Один из следующих модулей должен быть установлен:<br>mysql, oci8, pgsql| |*bcmath*| |php-bcmath| |*mbstring*| |php-mbstring| |*PHP опция mbstring.func\_overload*|должна быть отключена|В 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-адресам Запрос: ```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 } ``` Ответ: ```json { "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'. #### Chromium для веб-сервиса Zabbix в Ubuntu 20 Хотя в большинстве случаев веб-сервис Zabbix может работать с 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. Эта ошибка возникает из-за того, что в качестве домашней директории пользователя «zabbix» используется `/var/lib/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 нет возможности их конфигурирования пользователями. Начиная с версий Zabbix 4.0.19 и 4.4.7, поддерживаются также и заданные пользователем алгоритмы шифрования для GnuTLS и OpenSSL. Пользователи могут [настраивать](#алгоритмы-шифрования-заданные-пользователем) алгоритмы в соответствии со своими политиками безопасности. Использование этой возможности опционально (встроенные алгоритмы по умолчанию всё ещё работают). Для криптобиблиотек, скомпилированных с настройками по умолчанию, встроенные в Zabbix правила обычно дают в итоге следующие алгоритмы шифрования (от более высокого уровня приоритета к более низкому): |Библиотека|Алгоритмы шифрования сертификатов|Алгоритмы шифрования PSK| |-------|-------------------|-------------------| |*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. ### Более чистый экспорт конфигурации Файлы YAML, генерируемые во время экспорта конфигурации объектов Zabbix, более не содержат пустых строк между объектами в массиве, делая файлы короче и удобнее для работы. Смотрите раздел [Экспорт/импорт конфигурации](/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 } ``` ##### Cloning a report To quickly clone an existing report, click the *Clone* button at the bottom of an existing report configuration form. When cloning a report created by another user, the current user becomes the owner of the new report. Report settings will be copied to the new report configuration form with respect to user permissions: - If the user who clones a report has no permissions to a dashboard, the *Dashboard* field will be cleared. - If the user who clones a report has no permissions to some users or user groups in the *Subscriptions* list, inaccessible recipients will not be cloned. - *Generate report by* settings will be updated to display the current user (unless *Generate report by* is set to the recipient). Change the required settings and the report name, then click *Add*. ##### Клонирование отчёта Для быстрого клонирования существующего отчёта нажмите кнопку *Клонировать (Clone)* внизу диалога настройки существующего отчёта. При клонировании отчёта, созданного другим пользователем, текущий пользователь становится владельцем нового отчёта. Настройки отчета будут скопированы в диалог настройки нового отчёта с учётом прав пользователя: - Если пользователь, который клонирует отчёт, не имеет прав доступа к панели, поле *Панель (Dashboard)* очищается. - Если пользователь, который клонирует отчёт, не имеет прав доступа к некоторым пользователям или группам пользователей из списка *Подписки (Subscriptions)*, недоступные получатели не клонируются. - Настройки *Сгенерировано (Generate report by)* будут обновлены, чтобы отображался текущий пользователь (если только *Сгенерировано* не задано значением Получатель). Измените требуемые настройки и имя отчёта, затем нажмите на *Добавить (Add)*. ### Code |Type|Size|Comments| |-----|-----|----------| |Byte| 4 |Payload type, currently only JSON is supported.| ### Код |Тип|Размер|Комментарии| |-----|-----|----------| |Byte| 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. ##### Свёрнутое меню Когда меню свёрнуто до значков, полное меню появляется снова при наведении курсора мыши. Обратите внимание, что оно появляется поверх содержимого страницы; чтобы переместить содержимое страницы вправо, нужно нажать на кнопку развернуть. Если переместить курсор мыши за пределы полного меню, меню снова свернётся через две секунды. Вы также можете развернуть свёрнутое меню, нажав клавишу 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 #### Установка через командную строку #### Command result The return value of the command is a standard output together with a standard error produced by the command. ::: 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. User parameters that return text (character, log, or text type of information) can also return a whitespace. In case of an invalid result, the item will become unsupported. #### Результат команды Результирующим значением команды является стандартный вывод вместе со стандартным выводом ошибок. ::: noteimportant ​Текстовый элемент данных (с типами информации символ,​ журнал или текст) не станет неподдерживаемым в случае вывода в стандартный вывод ошибок. ::: Возвращаемое значение ограничено 16 МБ (включая конечные пробелы, которые усекаются); также применяются [ограничения баз данных](/manual/config/items/item#ограничения-текстовых-данных). Пользовательские параметры, которые возвращают текст (для типов информации символ, журнал, текстовый ) могут возвращать пробел. В случае ошибочного результата элемент данных станет неподдерживаемым. [comment]: # (tags: proxy) # 4 Proxy [comment]: # (tags: proxy) # 4. Прокси #### 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|Гости|Гости| |agent.ping|Гости|Гости| |agent.variant|Гости|Гости| |agent.version|Гости|Гости| |log|Администраторы|Гости| |log.count|Администраторы|Гости| |logrt|Администраторы|Гости| |logrt.count|Администраторы|Гости| |net.dns|Гости|Гости| |net.dns.record|Гости|Гости| |net.if.discovery|Гости|Гости| |net.if.in|Гости|Гости| |net.if.out|Гости|Гости| |net.if.total|Гости|Гости| |net.tcp.listen|Гости|Гости| |net.tcp.port|Гости|Гости| |net.tcp.service|Гости|Гости| |net.tcp.service.perf|Гости|Гости| |net.udp.service|Гости|Гости| |net.udp.service.perf|Гости|Гости| |proc.num|Администраторы|Гости| |system.cpu.discovery|Пользователи монитора производительности|Пользователи монитора производительности| |system.cpu.load|Пользователи монитора производительности|Пользователи монитора производительности| |system.cpu.num|Гости|Гости| |system.cpu.util|Пользователи монитора производительности|Пользователи монитора производительности| |system.hostname|Гости|Гости| |system.localtime|Гости|Гости| |system.run|Администраторы|Гости| |system.sw.arch|Гости|Гости| |system.swap.size|Гости|Гости| |system.uname|Гости|Гости| |system.uptime|Пользователи монитора производительности|Пользователи монитора производительности| |vfs.dir.count|Администраторы|Гости| |vfs.dir.get|Администраторы|Гости| |vfs.dir.size|Администраторы|Гости| |vfs.file.cksum|Администраторы|Гости| |vfs.file.contents|Администраторы|Гости| |vfs.file.exists|Администраторы|Гости| |vfs.file.md5sum|Администраторы|Гости| |vfs.file.regexp|Администраторы|Гости| |vfs.file.regmatch|Администраторы|Гости| |vfs.file.size|Администраторы|Гости| |vfs.file.time|Администраторы|Гости| |vfs.fs.discovery|Администраторы|Гости| |vfs.fs.get|Администраторы|Гости| |vfs.fs.size|Администраторы|Гости| |vm.memory.size|Гости|Гости| |web.page.get|Гости|Гости| |web.page.perf|Guests|Гости| |web.page.regexp|Гости|Гости| |zabbix.stats|Гости|Гости| 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".| Общие параметры столбцов: | | | |--|--------| |*Имя (Name)*|Имя столбца.| |*Данные (Data)*|Тип данных для отображения в столбце:<br>**Значение элемента данных** — значение указанного элемента данных<br>**Имя узла сети** — имя узла сети элемента данных, указанного в столбце *Значение элемента данных*<br>**Текст** — статическая текстовая строка| |*Основной цвет*<br>*(Base color)*|Цвет фона столбца; цвет заполнения, если данные *Значения элемента данных* отображаются в виде полосы/индикаторов.<br>Для данных *Значения элемента данных* цвет по умолчанию может быть переопределён пользовательским цветом, если значение элемента данных превышает одно из «Пороговых значений». | ##### 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. ##### Общие параметры - `/узел_сети/ключ` является общим обязательным первым параметром для функций, ссылающихся на историю элемента данных узла сети - `(сек|#число)<:сдвиг_времени>` является общим вторым параметром для функций, ссылающихся на историю элемента данных узла сети, где: - **сек** — максимальный [период вычисления](/manual/config/triggers#период-вычисления) в секундах (могут использоваться [суффиксы](/manual/appendix/suffixes) времени), либо - **\#число** — максимальная [область вычисления](/manual/config/triggers#период-вычисления) среди последних собранных значений (если начинается со знака решётки) - **сдвиг_времени** (опционально) позволяет сдвигать точку вычислений по времени назад в прошлое. Смотрите [более подробную информацию](/manual/config/triggers/expression#сдвиг-времени) относительно того, как указывать сдвиг времени. ##### 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. ##### Общие параметры - `/узел_сети/ключ` является общим обязательным первым параметром для функций, ссылающихся на историю элемента данных узла сети - `(сек|#число)<:сдвиг_времени>` является общим вторым параметром для функций, ссылающихся на историю элемента данных узла сети, где: - **сек** — максимальный [период вычисления](/manual/config/triggers#период-вычисления) в секундах (могут использоваться [суффиксы](/manual/appendix/suffixes) времени), либо - **\#число** — максимальная [область вычисления](/manual/config/triggers#период-вычисления) среди последних собранных значений (если начинается со знака решётки) - **сдвиг_времени** (опционально) позволяет сдвигать точку вычислений по времени назад в прошлое. Смотрите [более подробную информацию](/manual/config/triggers/expression#сдвиг-времени) относительно того, как указывать сдвиг времени. ##### 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. ##### Общие параметры - `/узел_сети/ключ` является общим обязательным первым параметром для функций, ссылающихся на историю элемента данных узла сети - `(сек|#число)<:сдвиг_времени>` является общим вторым параметром для функций, ссылающихся на историю элемента данных узла сети, где: - **сек** — максимальный [период вычисления](/manual/config/triggers#период-вычисления) в секундах (могут использоваться [суффиксы](/manual/appendix/suffixes) времени), либо - **\#число** — максимальная [область вычисления](/manual/config/triggers#период-вычисления) среди последних собранных значений (если начинается со знака решётки) - **сдвиг_времени** (опционально) позволяет сдвигать точку вычислений по времени назад в прошлое. Смотрите [более подробную информацию ](/manual/config/triggers/expression#сдвиг-времени) относительно того, как указывать сдвиг времени. ##### 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) ##### Общие параметры - `/узел_сети/ключ` является общим обязательным первым параметром - `период_времени:сдвиг_времени` является общим вторым параметром, где: - **период_времени** — период времени (минимум «1h»), определённый как \<N>\<единица_времени>, где `N` — количество единиц времени, `единица_времени` — h (час), d (сутки), w (неделя), M (месяц) или y (год). - **сдвиг_времени** — смещение периода времени (смотрите примеры функций) #### Common parameters Some parameters are common for all media types.  In the **Media type** tab the common general attributes are: |Parameter|Description| |--|--------| |*Name*|Name of the media type.| |*Type*|Select the type of media.| |*Description*|Enter a description.| |*Enabled*|Mark the checkbox to enable the media type.| See the individual pages of media types for media-specific parameters. The **Message templates** tab allows to set default notification messages for all or some of the following event types: - Problem - Problem recovery - Problem update - Service - Service recovery - Service update - Discovery - Autoregistration - Internal problem - Internal problem recovery  To customize message templates: - In the *Message templates* tab click on : a *Message template* popup window will open. - Select required *Message type* and edit *Subject* and *Message* texts. - Click on *Add* to save the message template  Message template parameters: |Parameter|Description| |--|-----------| |*Message type*|Type of an event for which the default message should be used.<br>Only one default message can be defined for each event type.<br>| |*Subject*|Subject of the default message. The subject may contain macros. It is limited to 255 characters.<br>Subject is not available for SMS media type.| |*Message*|The default message. It is limited to certain amount of characters depending on the database type (see [Sending messages](/manual/config/notifications/action/operation/message/) for more information).<br>The message may contain supported [macros](/manual/appendix/macros/supported_by_location).<br>In problem and problem update messages, expression macros are supported (for example, `{?avg(/host/key,1h)}`).| To make changes to an existing message template: In the *Actions* column click on  to edit the template or click on  to delete the message template. It is possible to define a custom message template for a specific action (see [action operations](/manual/config/notifications/action/operation#operation_details) for details). Custom messages defined in the action configuration will override default media type message template. ::: notewarning Defining message templates is mandatory for all media types, including webhooks or custom alert scripts that do not use default messages for notifications. For example, an action "Send message to Pushover webhook" will fail to send problem notifications, if the Problem message for the Pushover webhook is not defined. ::: The **Options** tab contains alert processing settings. The same set of options is configurable for each media type. All media types are processed in parallel. While the maximum number of concurrent sessions is configurable per media type, the total number of alerter processes on the server can only be limited by the StartAlerters [parameter](/manual/appendix/config/zabbix_server). Alerts generated by one trigger are processed sequentially. So multiple notifications may be processed simultaneously only if they are generated by multiple triggers.  |Parameter|Description| |--|--------| |*Concurrent sessions*|Select the number of parallel alerter sessions for the media type:<br>**One** - one session<br>**Unlimited** - unlimited number of sessions<br>**Custom** - select a custom number of sessions<br>Unlimited/high values mean more parallel sessions and increased capacity for sending notifications. Unlimited/high values should be used in large environments where lots of notifications may need to be sent simultaneously.<br>If more notifications need to be sent than there are concurrent sessions, the remaining notifications will be queued; they will not be lost.| |*Attempts*|Number of attempts for trying to send a notification. Up to 100 attempts can be specified; the default value is '3'. If '1' is specified Zabbix will send the notification only once and will not retry if the sending fails.| |*Attempt interval*|Frequency of trying to resend a notification in case the sending failed, in seconds (0-3600). If '0' is specified, Zabbix will retry immediately.<br>Time suffixes are supported, e.g. 5s, 3m, 1h.| #### Общие параметры Некоторые параметры являются общими для всех способов оповещения.  На вкладке **Способ оповещения (Media type)** расположены общие атрибуты: |Параметр|Описание| |--|--------| |*Имя (Name)*|Имя способа оповещения.| |*Тип (Type)*|Выберите тип способа оповещения.| |*Описание (Description)*|Введите описание.| |*Активировано (Enabled)*|Отметьте флажок, чтобы активировать способ оповещения.| Уникальные параметры по каждому способу оповещения описаны на отдельных страницах. Вкладка **Шаблоны сообщений (Message templates)** позволяет задать собственный шаблон оповещений по умолчанию по каждому из типов событий: - Проблема - Восстановление проблемы - Обновление проблемы - Услуга - Восстановление услуги - Обновление услуги - Обнаружение - Авторегистрация - Внутренняя проблема - Восстановление внутренней проблемы  Для изменения шаблона сообщения: - На вкладке *Шаблоны сообщений (Message templates)* нажмите на  (Добавить): откроется всплывающее окно *Шаблон сообщения (Message template)* - Выберите *Тип сообщения (Message type)* и измение текст в полях *Тема (Subject)* и *Сообщение (Message)*. - Нажмите на *Добавить (Add)*, чтобы сохранить шаблон сообщений.  Параметры шаблонов сообщений: |Параметр|Описание| |--|-----------| |*Тип сообщения*<br>*(Message type)*|Тип события, для которого будет использоваться это сообщение по умолчанию.<br>Для каждого типа события можно задать только одно сообщение по умолчанию.| |*Тема*<br>*(Subject)*|Тема сообщения по умолчанию. Тема может содержать макросы. Тема ограничена 255 символами.<br>Поле темы недоступно для SMS-сообщений.| |*Сообщение*<br>*(Message)*|Сообщение по умолчанию. Это поле ограничено определённым количеством символов, которое зависит от типа используемой базы данных (для получения более подробной информации смотрите [Отправка сообщений](/manual/config/notifications/action/operation/message/)).<br>Сообщение может содержать поддерживаемые [макросы](/manual/appendix/macros/supported_by_location).<br>В сообщениях на проблемы и обновления проблем поддерживаются выражения макросов (например, `{?avg(/узел сети/ключ,1h)}`).| Для того, чтобы внести изменения в существующий шаблон сообщений: В колонке *Действия (Actions)* нажмите на  (Изменить), чтобы отредактировать шаблон сообщений, или на  (Удалить), чтобы удалить шаблон сообщений. Для отдельных действий имеется возможность задать пользовательский шаблон сообщений (для получения более подробных сведений смотрите [детали операций](/manual/config/notifications/action/operation#детали-операций)). Пользовательские сообщения, указанные в настройках действия, переопределяют шаблон сообщений способа оповещений по умолчанию. ::: notewarning Шаблоны сообщений необходимо задать для всех событий оповещения, включая вебхуки и пользовательские скрипты, которые не используют сообщения по умолчанию для оповещений. Например, действие «Вебхук отправки сообщения в Pushover» не сможет отправить оповещение о проблеме, если сообщение о проблеме не было задано для вебхука Pushover. ::: Вкладка **Опции (Options)** содержит настройки обработки оповещений. Этот набор параметров одинаков для всех способов оповещений. Все способы оповещений обрабатываются параллельно. В то время как максимальное количество одновременных сессий настраивается для каждого способа оповещения по отдельности, общее количество процессов оповещения на сервере может быть ограничено только [параметром](/manual/appendix/config/zabbix_server) StartAlerters. Оповещения, сгенерированные одним триггером, обрабатываются последовательно. Несколько оповещений могут обрабатываться одновременно, только если они генерируются несколькими триггерами.  |Параметр|Описание| |--|--------| |*Одновременные сессии*|Выберите количество параллельных сессий оповещения для способа оповещения:<br>**Одна (One)** — одна сессия<br>**Неограничено (Unlimited)** — неограниченное количество сессий<br>**Пользовательское (Custom)** — введите настраиваемое количество сессий<br>Неограниченные/высокие значения означают большее количество параллельных сессий и увеличенную мощность при отправке оповещений. Неограниченное или большое количество сессий следует использовать в больших инфраструктурах, где может потребоваться отправка множества оповещений одновременно.<br>Если требуется отослать больше оповещений, чем имеется одновременных сессий, оставшиеся уведомления будут поставлены в очередь; они не потеряются.| |*Попыток*|Количество попыток отправки оповещения. Можно указать до 100 попыток; значение по умолчанию «3». Если указано «1», Zabbix отправит оповещение только один раз и не будет повторять попытку в случае неудачной отправки.| |*Интервал попыток*|Частота попыток повторной отправки уведомления в случае неудачной отправки, в секундах (0-3600). Если указано «0», Zabbix выполнит новую попытку немедленно.<br>Поддерживаются суффиксы времени, например: 5s, 3m, 1h.| ##### 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 сервером |Параметр|Описание| |----|--------| |*Время ожидания сети*<br>*(Network timeout)*|Сколько секунд ждать перед закрытием простаивающего сокета (если соединение с сервером Zabbix было установлено ранее, но веб-интерфейс не может завершить операцию чтения/передачи данных за это время, соединение будет разорвано). Допустимый диапазон: 1 — 300s (по умолчанию: 3s).| |*Время ожидания соединения*<br>*(Connection timeout)*|Сколько секунд ждать, прежде чем остановить попытку соединения с сервером Zabbix. Допустимый диапазон: 1 — 30s (по умолчанию: 3s).| |*Время ожидания сети при тесте способа оповещения*<br>*(Network timeout for media type test)*|Сколько секунд ждать ответа при тестировании способа оповещения. Допустимый диапазон: 1 — 300s (по умолчанию: 65s).| |*Время ожидания сети при выполнении скриптов*<br>*(Network timeout for script execution)*|Сколько секунд ждать ответа при выполнении скрипта. Допустимый диапазон: 1 — 300s (по умолчанию: 60s).| |*Время ожидания сети при тесте элемента данных*<br>*(Network timeout for item test)*|Сколько секунд ждать возврата данных при тестировании элемента данных. Допустимый диапазон: 1 - 300s (по умолчанию: 60s).| |*Время ожидания сети при тесте регулярного отчёта*<br>*(Network timeout for scheduled report test)*|Сколько секунд ждать возврата данных при тестировании регулярного отчёта. Допустимый диапазон: 1 — 300s (по умолчанию: 60s).| ## Community & other resources ## Сообщество и другие ресурсы #### 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 Следующие шаги помогут вам скомпилировать OpenSSL из исходного кода на MS Windows 10 (64-bit). 1. Для компиляции OpenSSL на машине с Windows потребуются: 1. Компилятор C языка (например, VS 2017 RC), 2. NASM (<https://www.nasm.us/>), 3. Perl (например, Strawberry Perl с <http://strawberryperl.com/>), 4. Perl модуль Text::Template (cpan Text::Template). 2. Загрузите исходный код OpenSSL с <https://www.openssl.org/>. В данном примере используется OpenSSL 1.1.1. 3. Разархивируйте исходный код OpenSSL, например, в E:\\openssl-1.1.1. 4. Откройте окно командной строки, например, x64 Native Tools Command Prompt для 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 будет загружать настройки SSL из пути, который может быть изменён непривилегированными пользователями, что приведёт к потенциальной уязвимости безопасности. ::: - Обратите внимание на опцию «no-shared»: при использовании «no-shared» статические библиотеки OpenSSL libcrypto.lib и libssl.lib будут «самодостаточными», и в результате бинарные файлы Zabbix будут включать в себя OpenSSL, не потребуется внешних DLL от OpenSSL. Преимущество: бинарные файлы Zabbix можно будет копировать на другие Windows машины без необходимости наличия библиотек OpenSSL. Недостаток: когда будет выпущена новая версия OpenSSL с исправлением ошибок, будет необходимо скомпилировать и установить Zabbix агента заново. - Если 'no-shared' не используется, тогда во время выполнения DLL OpenSSL будут использоваться статические библиотеки libcrypto.lib и libssl.lib. Преимущество: когда будет выпущена новая версия OpenSSL с исправлением ошибок, возможно вы сможете обновить только OpenSSL DLL, без необходимости повторной компиляции Zabbix агента. Недостаток: при копировании 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 PCRE library (mandatory library since Zabbix 4.0) from pcre.org, version 8.XX; not pcre2 (<ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-8.41.zip>) 2. Extract to directory *E:\\pcre-8.41* 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:\\pcre-8.41\\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:\\pcre-8.41* and *E:\\pcre-8.41\\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:\\pcre-8.41-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:\\pcre-8.41-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:\pcre-8.41\build> nmake install ` #### Компиляция PCRE 1. Загрузите библиотеку PCRE (обязательная библиотека начиная с Zabbix 4.0) с pcre.org, version 8.XX; не pcre2 (<ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-8.41.zip>) 2. Извлеките в директорию *E:\\pcre-8.41* 3. Установите CMake с <https://cmake.org/download/>, во вермя установки выберите и убедитесь, что cmake\\bin находится в вашей директории (протестировано с версией 3.9.4). 4. Создайте новую, пустую директорию для сборки, предпочтительно поддиректорию в директории с исходным кодом. Например, *E:\\pcre-8.41\\build*. 5. Откройте окно командной строки, например x64 Native Tools Command Prompt для VS 2017 и из этой среды окружения выполните cmake-gui. Не пытайтесь запустить Cmake из меню Старт Windows, так как это может привести к ошибкам 6. Введи *E:\\pcre-8.41* и *E:\\pcre-8.41\\build* для директорий с исходным кодом и сборки, соответственно. 7. Нажмите на кнопку "Configure". 8. При выборе генератора для этого проекта, выберите "NMake Makefiles". 9. Создайте новую, пустую директорию для инсталляции. Например, *E:\\pcre-8.41-install*. 10. Затем GUI перечислит несколько опций конфигурации. Убедитесь, что выбраны следующие опции: - **PCRE\_SUPPORT\_UNICODE\_PROPERTIES** ON - **PCRE\_SUPPORT\_UTF** ON - **CMAKE\_INSTALL\_PREFIX** *E:\\pcre-8.41-install* 11. Снова нажмите "Configure". Соседняя кнопка "Generate" теперь должна быть активна. 12. Нажмите "Generate". 13. В случае возникновения ошибок рекомендуется удалить CMake кэш перед попыткой повторить процесса сборки CMake. В CMake GUI кэш можно удалить выбрав "File > Delete Cache". 14. Директория сборки теперь должна содержать пригодную для использования систему сборки - *Makefile*. 15. Откройте окно командной строки, например, x64 Native Tools Command Prompt для VS 2017 и перейдите к упомянутому выше *Makefile*. 16. Запустите команду NMake: `E:\pcre-8.41\build> 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. Не пытайтесь запустить Cmake из меню Пуск Windows, так как такой запуск может привести к ошибкам. 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 #### Компиляция Zabbix агента на HP-UX Если вы устанавливаете библиотеку PCRE с популярного сайта пакетов HP-UX <http://hpux.connect.org.uk>, например из файла `pcre-8.42-ia64_64-11.31.depot`, вы получите только 64-битную версию библиотеки, которая будет установлена в директорию /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 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 #### Компиляция Zabbix агента на HP-UX Если вы устанавливаете библиотеку PCRE с популярного сайта пакетов HP-UX <http://hpux.connect.org.uk> (например из файла `pcre-8.42-ia64_64-11.31.depot`), вы получите только 64-битную версию библиотеки, которая будет установлена в директорию `/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 Следующие шаги помогут вам скомпилировать Zabbix из исходного кода на MS Windows 10 (64-bit). Четвертый шаг — единственное существенное отличие при компиляции Zabbix с / без поддержки TLS. 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. Скопируйте и распакуйте архив, например zabbix-4.4.0.tar.gz, на Windows машине. 3. Давайте предположим, что исходный код располагается в e:\\zabbix-4.4.0. Откройте окно командной строки, например, x64 Native Tools Command Prompt for VS 2017 RC. Перейдите в 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 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:\pcre-8.41-install\include PCRELIBDIR=E:\pcre-8.41-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:\pcre-8.41-install\include PCRELIBDIR=E:\pcre-8.41-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:\pcre-8.41-install\include PCRELIBDIR=E:\pcre-8.41-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:\pcre-8.41-install\include PCRELIBDIR=E:\pcre-8.41-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 Последующие шаги помогут Вам скомпилировать Zabbix из исходного кода на MS Windows 10 (64-bit). При компиляции Zabbix с/без поддержки TLS единственное существенное отличие отражено в 4 шаге. 1. На Linux machine скачайте исходный код с 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. Скопируйте и распакуйте архив, например, zabbix-4.4.0.tar.gz, на Windows устройстве. 3. Давайте предположим, что исходный код расположен в e:\\zabbix-4.4.0. Откройте окно командной строки, например, x64 Native Tools Command Prompt для VS 2017 RC. Перейдите в E:\\zabbix-4.4.0\\build\\win32\\project. 4. Скомпилируйте zabbix\_get, zabbix\_sender and zabbix\_agent. - без TLS: `E:\zabbix-4.4.0\build\win32\project> nmake /K PCREINCDIR=E:\pcre-8.41-install\include PCRELIBDIR=E:\pcre-8.41-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:\pcre-8.41-install\include PCRELIBDIR=E:\pcre-8.41-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:\pcre-8.41-install\include PCRELIBDIR=E:\pcre-8.41-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:\pcre-8.41-install\include PCRELIBDIR=E:\pcre-8.41-install\lib ` 5. Новые бинарные файлы будут находиться в e:\\zabbix-4.4.0\\bin\\win64. Поскольку OpenSSL был скомпилирован с опцией 'no-shared', бинарные файлы Zabbix содержат OpenSSL и их можно копировать на другие устройства, на которых нет OpenSSL. #### Compiling Zabbix with encryption support To support encryption Zabbix must be compiled and linked with one of the supported crypto libraries: - GnuTLS - from version 3.1.18 - OpenSSL - versions 1.0.1, 1.0.2, 1.1.0, 1.1.1, 3.0.x. Note that 3.0.x is supported since Zabbix 6.0.4. - LibreSSL - tested with versions 2.7.4, 2.8.2: - LibreSSL 2.6.x is not supported - LibreSSL is supported as a compatible replacement of OpenSSL; the new `tls_*()` LibreSSL-specific API functions are not used. Zabbix components compiled with LibreSSL will not be able to use PSK, only certificates can be used. :::notetip You can find out more about setting up SSL for Zabbix frontend by referring to these [best practices](/manual/installation/requirements/best_practices). ::: The library is selected by specifying the respective option to "configure" script: - `--with-gnutls[=DIR]` - `--with-openssl[=DIR]` (also used for LibreSSL) For example, to configure the sources for server and agent with *OpenSSL* you may use something like: ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openssl Different Zabbix components may be compiled with different crypto libraries (e.g. a server with *OpenSSL*, an agent with *GnuTLS*). ::: noteimportant If you plan to use pre-shared keys (PSK), consider using *GnuTLS* or *OpenSSL 1.1.0* (or newer) libraries in Zabbix components using PSKs. *GnuTLS* and *OpenSSL 1.1.0* libraries support PSK ciphersuites with [Perfect Forward Secrecy](https://en.wikipedia.org/wiki/Forward_secrecy#Perfect_forward_secrecy_.28PFS.29). Older versions of the *OpenSSL* library (1.0.1, 1.0.2c) also support PSKs, but available PSK ciphersuites do not provide Perfect Forward Secrecy. ::: #### Компиляция Zabbix с поддержкой шифрования Для поддержки шифрования Zabbix должен быть скомпилирован и слинкован с одной из поддерживаемых криптобиблиотек: - GnuTLS — с версии 3.1.18 - OpenSSL — версии 1.0.1, 1.0.2, 1.1.0, 1.1.1, 3.0.x. Обратите внимание, что 3.0.x поддерживается с версии Zabbix 6.0.4. - LibreSSL — протестировано с версиями 2.7.4, 2.8.2: - LibreSSL 2.6.x не поддерживается; - LibreSSL поддерживается как совместимая замена для OpenSSL; новые функции API `tls_*()`, специфичные для LibreSSL, не используются. Компоненты Zabbix, скомпилированные с LibreSSL, не смогут использовать PSK, могут использоваться только сертификаты. :::notetip Вы можете найти более подробную информацию о настройке SSL для веб-интерфейса Zabbix по ссылке на [наилучшие практики](/manual/installation/requirements/best_practices). ::: Библиотека выбирается при помощи соответствующей опции в скрипте «configure»: - `--with-gnutls[=DIR]` - `--with-openssl[=DIR]` (также используется и для LibreSSL) Например, чтобы сконфигурировать исходные коды для сервера и агента с *OpenSSL*, вы можете использовать что-то вроде: ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openssl Разные компоненты Zabbix можно скомпилировать с различными криптобиблиотеками (например, сервер с *OpenSSL*, агент с *GnuTLS*). ::: noteimportant Если вы планируете использовать общие ключи (pre-shared keys, PSK), рассмотрите возможность использования библиотек *GnuTLS* или *OpenSSL 1.1.0* (или новее) с компонентами Zabbix, использующими PSK. Библиотеки *GnuTLS* и *OpenSSL 1.1.0* поддерживают наборы шифров PSK с [совершенной прямой секретностью (Perfect forward secrecy)](https://ru.wikipedia.org/wiki/Perfect_forward_secrecy). Более старые версии библиотеки *OpenSSL* (1.0.1, 1.0.2c) также поддерживают PSK, но доступные наборы шифров PSK не обеспечивают совершенную прямую секретность. ::: #### 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 ``` #### Компиляция Zabbix с LibreSSL Процесс схож с компиляцией с поддержкой 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 ``` #### Compiling Zabbix with ODBC support To enable ODBC support, Zabbix should be compiled with the following flag: --with-unixodbc[=ARG] # Use ODBC driver against unixODBC package. ::: noteclassic See more about Zabbix installation from the [source code](/manual/installation/install#from_the_sources). ::: #### Компиляция Zabbix с поддержкой ODBC Для включения поддержки ODBC, Zabbix должен быть скомпилирован со следующим флагом: --with-unixodbc[=ARG] #Использовать драйвер ODBC с пакетом unixODBC. ::: noteclassic Смотрите более подробную информацию об установке Zabbix из [исходных кодов](/manual/installation/install#установка-из-исходных-кодов). ::: #### 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. #### Компрессированный контент в веб-мониторинге В Zabbix веб-мониторинг добавлена возможность обработки сжатого содержимого. Поддерживаются все форматы кодировки, которые поддерживаются **libcurl**. ### Conditions The following conditions can be used in service actions: |Condition type|Supported operators|Description| |--|--|------| |*Service*|equals<br>does not equal|Specify a service or a service to exclude.<br>**equals** - event belongs to this service.<br>**does not equal** - event does not belong to this service.<br>Specifying a parent service implicitly selects all child services. To specify the parent service only, all nested services have to be additionally set with the **does not equal** operator.| |*Service name*|contains<br>does not contain|Specify a string in the service name or a string to exclude.<br>**contains** - event is generated by a service, containing this string in the name.<br>**does not contain** - this string cannot be found in the service name.| |*Service tag name*|equals<br>does not equal<br>contains<br>does not contain|Specify an event tag or an event tag to exclude. Service event tags can be defined in the service configuration section *Tags*.<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.| |*Service tag value*|equals<br>does not equal<br>contains<br>does not contain|Specify an event tag and value combination or a tag and value combination to exclude. Service event tags can be defined in the service configuration section *Tags*.<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.| :::noteimportant Make sure to define [message templates](/manual/config/notifications/media#overview) for Service actions in the *Administration->Media types* menu. Otherwise, the notifications will not be sent. ::: ### Условия В действиях на услуги можно использовать следующие условия: |Тип условия|Поддерживаемые операторы|Описание| |--|--|------| |*Услуга*<br>*(Service)*|равно<br>не равно|Укажите услугу или исключение услуги.<br>**равно** — событие относится к указанной услуге.<br>**не равно** — событие не относится к указанной услуге.<br>При указании родительской услуги косвенным образом будут выбраны все дочерние услуги. Чтобы выбрать только родительскую услугу, все вложенные услуги необходимо дополнительно перечислить с оператором **не равно**.| |*Имя услуги*<br>*(Service name)*|содержит<br>не содержит|Укажите строку из имени услуги или исключение строки.<br>**содержит** — событие произошло от услуги, которая содержит в имени указанную строку.<br>**не содержит** — указанная строка не содержится в имени услуги.| |*Имя тега услуги*<br>*(Service tag name)*|равно<br>не равно<br>содержит<br>не содержит|Укажите тег события или исключение тега события. Теги на события услуг можно добавить в настройках услуги в разделе *Теги*.<br>**равно** — событие имеет указанный тег<br>**не равно** — событие не имеет указанный тег<br>**содержит** — событие имеет тег, который содержит указанную строку<br>**не содержит** — событие не имеет тега, который содержит указанную строку.| |*Значение тега услуги*<br>*(Service tag value)*|равно<br>не равно<br>содержит<br>не содержит|Укажите комбинацию тега события и его значение или исключение комбинации тега и значения. Теги на события услуг можно добавить в настройках услуги в разделе *Теги*.<br>**равно** — событие имеет указанные тег и значение<br>**не равно** — событие не имеет указанные тег и значение<br>**содержит** — событие содержит указанные строки тега и значения<br>**не содержит** — событие не содержит указанные строки тега и значения.| :::noteimportant Обязательно задайте [шаблоны сообщений](/manual/config/notifications/media#обзор) для действий на услуги в меню *Администрирование->Способы оповещений*. В противном случае, оповещения не будут отправлены. ::: #### Configurable fields Actual command(s) to be executed must be placed in the **Executed script** field in the item configuration.<br> Multiple commands can be executed one after another by placing them on a new line. In this case returned value also will be formatted as multilined. Supported characters that the shell prompt can end with: - $ - \# - \> - % ::: noteclassic A telnet prompt line which ended with one of these characters will be removed from the returned value, but only for the first command in the commands list, i.e. only at a start of the telnet session. ::: |Key|Description| |--|------| |**telnet.run\[<unique short description>,<ip>,<port>,<encoding>\]**|Run a command on a remote device using telnet connection| | ::: noteimportant If a telnet check returns a value with non-ASCII characters and in non-UTF8 encoding then the *<encoding>* parameter of the key should be properly specified. See [encoding of returned values](/manual/appendix/items/encoding_of_values) page for more details. ::: #### Настраиваемые поля Фактические команда(ы) для выполнения необходимо поместить в поле **Выполняемый скрипт** при настройке элемента данных.<br> Можно выполнять несколько команд одну за другой, размещая каждую на новой строке. В этом случае значение результата также будет отформатировано как многострочное. Поддерживаемые символы, которыми может заканчиваться строка приглашения командной оболочки: - $ - \# - \> - % ::: noteclassic Строка telnet с запросом, которая заканчивается одним из этих символов, будет удалена из возвращаемого значения, но только для первой команды из списка команд, то есть, только в начале telnet сессии. ::: |Ключ|Описание| |--|------| |**telnet.run\[<уникальное короткое описание>,<ip>,<порт>,<кодировка>\]**|Выполнение команды на удалённом устройстве с использованием telnet соединения| ::: noteimportant Если telnet проверка возвращает значение с не-ASCII символами и не в UTF8 кодировке, то необходимо указать корректный параметр ключа *<кодировка>*. Смотрите страницу [о кодировке возвращаемых значений](/manual/appendix/items/encoding_of_values) для получения более подробных сведений. ::: #### 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 #### Настраиваемые поля **Ключ** — уникальный идентификатор элемента данных (в пределах узла сети). Вы можете создать любое имя ключа, используя поддерживаемые символы. Формулу вычисления необходимо ввести в поле **Формула**. Не существует абсолютно никакой связи между формулой и ключом. Параметры ключа не используются в формуле никоим образом. Синтаксис простой формулы: функция(/узел сети/ключ,<параметр1>,<параметр2>,...) где: | | | |--|--------| |*функция*|Одна из [поддерживаемых функций](/manual/appendix/functions): last, min, max, avg, count и т.д.| |*узел сети*|Узел сети элемента данных, который используется в вычислении.<br>Текущий узел сети может быть опущен (примерно как в `функция(//ключ,параметр,...)`).| |*ключ*|Ключ элемента данных, который используется в вычислении.| |*параметр(ы)*|Параметры функции, если требуются.| ::: noteimportant [Пользовательские макросы](/manual/config/macros/user_macros) в формуле будут раскрыты, если они используются для ссылки на параметр функции, параметр фильтра элементов данных или константу. Пользовательские макросы НЕ будут раскрыты при использовании ссылки на функцию, имя узла сети, ключ элемента данных, параметры ключа элементов данных или оператор. ::: Для получения более сложной формулы можно использовать комбинацию функций, операторов и скобок. Вы можете использовать все функции и [операторы](/manual/config/triggers/expression#операторы), которые поддерживаются в выражениях триггеров. Логика и приоритет операторов точно такой же. В отличие от выражений триггеров, Zabbix обрабатывает вычисляемые элементы данных в соответствии с интервалом обновления элемента данных, а не при получении нового значения. Все элементы данных, на которые имеются ссылки из функций истории в формуле вычисляемого элемента данных, должны существовать и собирать данные. Также, если вы измените ключ элемента данных, на который ссылается вычисляемый элемент данных, вам придётся вручную обновить все формулы, в которых этот ключ используется. Вычисляемый элемент данных может перейти в неподдерживаемое состояние в нескольких случаях: - элемент(ы) данных, на которые имеется ссылка - не найден - деактивирован - принадлежит деактивированному узлу сети - не поддерживается (за исключением функции nodata() и [операторов](/manual/config/triggers/expression#операторы) с неизвестными значениями) - отсутствуют данные для вычисления функции - деление на ноль - использован некорректный синтаксис ### 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. ### Конфигурируемые параметры TLS и соединений для плагина MQTT [Плагин MQTT](/manual/appendix/config/zabbix_agent2_plugins/mqtt_plugin) для Zabbix агента 2 теперь предоставляет дополнительные возможности настроек, которые могут быть определены в файле конфигурации плагина как [именованные сессии](/manual/config/items/plugins#именованные-сессии) или параметры [по умолчанию](/manual/config/items/plugins#значения-по-умолчанию): - Параметры, относящиеся к соединению: 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[]**) создайте деактивированный скриптовый элемент данных со следующими параметрами:  - *Имя (Name)*: VMware metrics - *Тип (Type)*: Скрипт (Script) - *Ключ (Key)*: vmware.metrics - *Тип информациии (Type of information)*: Текст (Text) - *Скрипт (Script)*: перекопируйте и вставьте [скрипт](#скрипт), предоставленный ниже - *Время ожидания (Timeout)*: 10 - *Период хранения истории (History storage period)*: Не хранить историю (Do not keep history) - *Активировано (Enabled)*: не отмечено #### Скрипт 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 и найдите нужную метрику. Пример 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 {width="600"} All mandatory input fields are marked with a red asterisk. This table consists of parameters typical for *Host group* element type: |Parameter|Description| |--|--------| |*Type*|Select Type of the element:<br>**Host group** - icon representing the status of all triggers of all hosts belonging to the selected group| |*Show*|Show options:<br>**Host group** - selecting this option will result as one single icon displaying corresponding information about the certain host group<br>**Host group elements** - selecting this option will result as multiple icons displaying corresponding information about every single element (host) of the certain host group| |*Area type*|This setting is available if *Show* is set to "Host group elements":<br>**Fit to map** - all host group elements are equally placed within the map<br>**Custom size** - a manual setting of the map area for all the host group elements to be displayed| |*Area size*|This setting is available if *Area type* is set to "Custom size":<br>**Width** - numeric value to be entered to specify map area width<br>**Height** - numeric value to be entered to specify map area height| |*Placing algorithm*|**Grid** – only available option of displaying all the host group elements| |*Label*|Icon label, any string.<br>[Macros](/manual/config/macros) and multiline strings can be used in labels.<br>If the type of the map element is “Host group” specifying certain macros has an impact on the map view displaying corresponding information about every single host. For example, if {HOST.IP} macro is used, the edit map view will only display the macro {HOST.IP} itself while map view will include and display each host's unique IP address| #### Настройка {width="600"} Все обязательные поля ввода отмечены красной звёздочкой. Эта таблица состоит из параметров, характерных для типа элемента *Группа узлов сети*: |Параметр|Описание| |--|--------| |*Тип*<br>*(Type)*|Выберите Тип элемента:<br>**Группа узлов сети (Host group)** — иконка, которая представляет состояние всех триггеров всех узлов сети, которые принадлежат выбранной группе| |*Показать*<br>*(Show)*|Опции отображения:<br>**Группа узлов сети (Host group)** — выбор этой опции приведет к тому, что одна иконка будет отображать соответствующую информацию о конкретной группе узлов сети<br>**Элементы группы узлов сети (Host group elements)** — выбор этой опции приведет к тому, что несколько иконок будут отображать соответствующую информацию по каждому отдельному элементу (узлу сети) из конкретной группы узлов сети| |*Тип области*<br>*(Area type)*|Эта опция доступна, если для параметра *Показать (Show)* выбрано значение «Элементы группы узлов сети (Host group elements)»:<br>**Вписать в карту сети (Fit to map)** — все элементы группы узлов сети располагаются равномерно по всей карте сети<br>**Пользовательский размер (Custom size)** — настройка вручную области карты сети для отображения всех элементов группы узлов сети| |*Размер области*<br>*(Area size)*|Эта опция доступна, если для параметра *Тип области (Area type)* выбрано значение «Пользовательский размер (Custom size)»:<br>**Ширина (Width)** — числовое значение, которое необходимо ввести, чтобы указать ширину области карты<br>**Высота (Height)** — числовое значение, которое необходимо ввести, чтобы указать высоту области карты| |*Алгоритм размещения*<br>*(Placing algorithm)*|**Сетка (Grid)** — единственная доступная опция отображения всех элементов группы узлов сети| |*Подпись*<br>*(Label)*|Подпись к иконке, любая строка.<br>В подписях можно использовать [макросы](/manual/config/macros) и многострочные строки.<br>Если типом элемента карты сети является «Группа узлов сети», тогда ввод определённых макросов влияет на отображение на карте сети соответствующей информации по каждому отдельному узлу сети. Например, если используется макрос {HOST.IP}, при редактировании карты сети отобразится только сам макрос {HOST.IP}, тогда как просмотр карты сети будет включать и отображать уникальный IP адрес каждого узла сети| #### 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 В случае, когда у пользователя не хватает прав для доступа к определёным элементам виджетов, тогда в процессе настройки виджета имя такого элемента будет отображаться как *Недоступно (Inaccessible)*. Это приводит к тому, что вместо «реального» имени элемента появятся имена *Недоступный элемент данных, Недоступный узел сети, Недоступная группа, Недоступная карта сети* и *Недоступный график*. ::: В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: |Параметр|Описание| |--|--------| |*Группы узлов сети*<br>*(Host groups)*|Введите группы узлов сети для отображения в виджете. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню.<br>При указании родительской группы узлов сети неявно выбираются все вложенные группы.<br>В виджете будут отображаться данные с узлов сети из этих групп. Если не указано никаких групп, то будут отображаться все группы узлов сети.| |*Исключить группы узлов сети*<br>*(Exclude host groups)*|Введите группы узлов сети, которые нужно скрыть из виджета. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню.<br>При указании родительской группы узлов сети неявно выбираются все вложенные группы.<br>Данные узлов сети из этих групп не будут отображаться в виджете. Например, узлы сети 001, 002, 003 могут быть в группе «Group A», а узлы сети 002, 003 — также и в группе «Group B». Если мы выберем *показывать* «Group A» и в то же время *исключить* «Group B», то на Панели будут отображаться только данные с узла сети 001.| |*Узлы сети*<br>*(Hosts)*|Введите узлы сети для отображения в виджете. Это поле с функцией автодополнения; таким образом, после начала ввода имени будет автоматически предложен список совпадающих узлов сети в выпадающем меню.<br>Если не введено никаких узлов сети, будут отображаться все узлы сети.| |*Теги*<br>*(Tags)*|Укажите теги проблем, чтобы ограничить количество веб-сценариев, отображаемых в виджете. Можно как включать, так и исключать определённые теги и значения тегов. Можно указать несколько условий. Поиск соответствия имён тегов всегда чувствителен к регистру.<br>По каждому условию доступно несколько операторов:<br>**Существует** — включить указанные имена тегов<br>**Равно** — включить указанные имена тегов и их значения (с учётом регистра)<br>**Содержит** — включить указанные имена тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>**Не существует** — исключить указанные имена тегов<br>**Не равно** — исключить указанные имена тегов и их значения (с учётом регистра)<br>**Не содержит** — исключить имена указанных тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>Для условий имеется два типа вычислений:<br>**И/Или** — все условия должны соблюдаться, условия с одинаковыми именами тегов будут сгруппированы с условием Или<br>**Или** — достаточно соблюдения одного условия| |*Узлы сети в обслуживании*<br>*(Show hosts in maintenance)*|Включить в статистику узлы сети, находящиеся в обслуживании.| #### 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#настройка); - при просмотре настроенных [групп пользователей](/manual/web_interface/frontend_sections/administration/user_groups). Когда *Режим отладки* включён для группы пользователей, её пользователи увидят кнопку *Отладка (Debug)* в правом нижнем углу окна браузера:  При нажатии на кнопку *Отладка* открывается новое окно под содержимым страницы, которое содержит статистику SQL страницы, а также список вызовов API и отдельных операторов SQL: {width="600"} В случае проблем с производительностью страницы, можно использовать это окно для поиска основной причины проблемы. ::: notewarning Включённый *Режим отладки* отрицательно влияет на производительность веб-интерфейса Zabbix. ::: #### 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-сервер) - [Zabbix прокси](#zabbix-прокси) - [Zabbix агент](#zabbix-агент) # 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\_agentd](/manual/appendix/config/zabbix_agentd) и [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. ##### Файл конфигурации Смотрите опции [файла конфигурации](/manual/appendix/config/zabbix_proxy) для получения подробной информации по настройке zabbix\_proxy. ##### Configuration file See the [configuration file](/manual/appendix/config/zabbix_server) options for details on configuring zabbix\_server. ##### Файл конфигурации Смотрите опции [файла конфигурации](/manual/appendix/config/zabbix_server) для получения подробной информации по настройке 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). #### Файл конфигурации Параметры конфигурации агента 2 большей частью совместимы с Zabbix агентом за несколькими исключениями. |Новые параметры|Описание| |--|--------| |*ControlSocket*|Путь к сокету управления работой. Агент 2 использует управляющий сокет для [административных команд](#управление_работой).| |*EnablePersistentBuffer*,<br>*PersistentBufferFile*,<br>*PersistentBufferPeriod*|Эти параметры используются для настройки постоянного хранилища агента 2 для активных элементов данных.| |*ForceActiveChecksOnStart*|Параметр определяет, должен ли агент выполнить активные проверки немедленно после перезапуска агента или равномерно распределить их по времени. Поддерживается, начиная с Zabbix 6.0.2.| |*Plugins*|Плагины могут иметь свои собственные параметры, в формате `Plugins.<Имя плагина>.<Параметр>=<значение>`. Общий параметр плагинов — *System.Capacity*, задаёт ограничение количества проверок, которые могут быть выполнены одновременно.| |*StatusPort*|Этот порт агент 2 будет слушать для запросов HTTP состояния и отображать список настроенных плагинов и некоторых внутренних параметров| |Исключенные параметры|Описание| |*AllowRoot*, *User*|Не поддерживается, так как режим демона не поддерживается.| |*LoadModule*, *LoadModulePath*|Загружаемые модули не поддерживаются.| |*StartAgents*|Этот параметр использовался в Zabbix агенте для увеличения параллелизма пассивных проверок или для их отключения. В Агенте 2 параллелизм настраивается на уровне плагинов и может быть ограничен настройкой производительности. Между тем полное отключение пассивных проверок в настоящее время не поддерживается.| |*HostInterface*, *HostInterfaceItem*|Ещё не поддерживается.| Для получения подробной информации смотрите параметры файла конфигурации по [zabbix\_agent2](/manual/appendix/config/zabbix_agent2). #### Configuration For virtual machine monitoring to work, Zabbix should be [compiled](/manual/installation/install#configure_the_sources) with the --with-libxml2 and --with-libcurl compilation options. The following configuration file options can be used to tune the Virtual machine monitoring: - **StartVMwareCollectors** - the number of pre-forked vmware collector instances.<br> This value depends on the number of VMware services you are going to monitor. For the most cases this should be:<br> *servicenum < StartVMwareCollectors < (servicenum \* 2)*<br> where *servicenum* is the number of VMware services. E. g. if you have 1 VMware service to monitor set StartVMwareCollectors to 2, if you have 3 VMware services, set it to 5. Note that in most cases this value should not be less than 2 and should not be 2 times greater than the number of VMware services that you monitor. Also keep in mind that this value also depends on your VMware environment size and *VMwareFrequency* and *VMwarePerfFrequency* configuration parameters (see below). - **VMwareCacheSize** - **VMwareFrequency** - **VMwarePerfFrequency** - **VMwareTimeout** For more details, see the configuration file pages for Zabbix [server](/manual/appendix/config/zabbix_server) and [proxy](/manual/appendix/config/zabbix_proxy). ::: noteimportant To support datastore capacity metrics Zabbix requires VMware configuration vpxd.stats.maxQueryMetrics parameter to be at least 64. See also the VMware knowledge base [article](https://kb.vmware.com/s/article/2107096). ::: #### Настройка Для того чтобы мониторинг виртуальных машин заработал, необходимо, чтобы Zabbix был [скомпилирован](/manual/installation/install#сконфигурируйте-исходный-код) с опциями сборки --with-libxml2 и --with-libcurl. Можно использовать следующие опции из файла конфигурации для оптимизации мониторинга виртуальных машин: - **StartVMwareCollectors** - количество префорк процессов vmware коллектора.<br> Это значение зависит от количества служб VMware, которые вы собираетесь наблюдать. Для большинства случаев значение должно быть:<br> *колвослужб < StartVMwareCollectors < (колвослужб \* 2)*,<br> где *колвослужб* является количество служб VMware. Например, если у вас под наблюдением 1 служба VMware, задайте StartVMwareCollectors равным 2, если у вас 3 службы VMware, задайте параметр равным 5. Обратите внимание, что в большинстве случаев это значение не должно быть меньше 2 и не должно превышать двукратного количества служб VMware, которые вы мониторите. Также имейте в виду, что эта величина зависит также от размера вашей среды VMware, параметров конфигурации *VMwareFrequency* и *VMwarePerfFrequency* (смотрите ниже). - **VMwareCacheSize** - **VMwareFrequency** - **VMwarePerfFrequency** - **VMwareTimeout** Для получения более подробной информации смотрите страницы файлов конфигурации Zabbix [сервера](/manual/appendix/config/zabbix_server) и [прокси](/manual/appendix/config/zabbix_proxy). ::: noteimportant Чтобы поддерживать метрики объёмов хранилищ данных, Zabbix требуется, чтобы значение параметра VMware vpxd.stats.maxQueryMetrics было по меньшей мере 64. Смотрите также [статью](https://kb.vmware.com/s/article/2107096) \[en\] в базе знаний VMware. ::: #### 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.| #### Настройка Глобальные оповещения для каждого пользователя можно включить на вкладке *Сообщения (Messaging)* [настроек профиля](/manual/web_interface/user_profile).  |Параметр|Описание| |--|--------| |*Сообщения в веб-интерфейсе*<br>*(Frontend messaging)*|Установите флажок, чтобы включить глобальные оповещения.| |*Время отображения сообщения*<br>*(Message timeout)*|Вы можете настроить, как долго будет отображаться сообщение. По умолчанию сообщения остаются на экране в течение 60 секунд.<br>Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например: 30s, 5m, 2h, 1d| |*Воспроизведение звукового сигнала*<br>*(Play sound)*|Вы можете настроить, как долго будет воспроизводиться звук.<br>**Один раз** — звук воспроизводится один раз и полностью.<br>**10 секунд** — звук повторяется в течение 10 секунд. <br>**Время отображения сообщения** — звук повторяется, пока отображается сообщение.| |*Важность триггеров*<br>*(Trigger severity)*|Вы можете установить уровни важности триггеров, для которых будут активироваться глобальные оповещения и звуки. Вы также можете выбрать звуки, соответствующие различным уровням важности.<br>Если никакая важность не отмечена, не будут отображаться вообще никакие сообщения.<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-ов; вместо этого объекты будут сопоставляться по такому критерию уникальности как идентификатор объекта (имя). Объект будет импортирован, а 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` (расположенный в папке `/conf` документов HTML Zabbix на веб-сервере). Раскомментируйте следующие строки: // 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 = 'Мы обновляем базу данных MySQL до 15:00. Оставайтесь с нами...'; ### 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. | ### Настройка В поле *Тип* [диалога настройки элемента данных](/manual/config/items/item) выберите Скрипт, затем заполните необходимые поля.  Все обязательные поля ввода отмечены красной звёздочкой. Поля, которые требуют информацию, специфичную для элементов данных Скрипт: |Поле|Описание| |--|--------| |Ключ (Key)|Введите уникальный ключ, который будет использоваться для идентификации этого элемента данных.| |Параметры<br>(Parameters)|Укажите переменные, которые будут переданы скрипту как пары атрибутов и значений.<br>Поддерживаются [встроенные макросы](/manual/config/macros) {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.IP}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG} и [пользовательские макросы](/manual/config/macros/user_macros).| |Скрипт<br>(Script)|Введите код JavaScript в блоке, который появится при нажатии на поле параметров (или на кнопку просмотра/изменения сразу за полем параметров). Этот код должен предоставлять логику для получения значения метрики.<br>Код имеет доступ ко всем параметрам, может выполнять запросы HTTP GET, POST, PUT и DELETE, а также имеет контроль над HTTP заголовками и телом запроса.<br>Смотрите также: [Дополнительные объекты JavaScript](/manual/config/items/preprocessing/javascript/javascript_objects), [Руководство пользователя JavaScript](https://developer.mozilla.org/ru/docs/Web/JavaScript/Guide).| |Время ожидания<br>(Timeout)|Время ожидания выполнения JavaScript (1-60s, по умолчанию 3s); превышение этого значения вернёт ошибку.<br>Поддерживаются суффиксы времени, например, 30s, 1m.<br>В зависимости от скрипта срабатывание времени ожидания может занять больше времени. | #### 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 Группы узлов сети могут создавать только пользователи с ролью Супер-администратор. ::: Существует два варианта создания группы узлов сети в веб-интерфейсе Zabbix. **Вариант первый**: - Перейдите в: *Настройка* → *Группы узлов сети* - Нажмите *Создать группу узлов сети* в правом верхнем углу экрана - Введите имя группы в диалоге  **Вариант второй**: при [настройке узла сети](/manual/config/hosts/host#настройка) введите несуществующее имя группы в поле ввода *Группы*. После создания группы узлов сети вы можете нажать на имя группы в списке под *Настройка* → *Группы узлов сети*, чтобы изменить имя группы, клонировать группу или удалить её. Удаление группы узлов сети удаляет только логическую группу, а не узлы сети в группе. Невозможно удалить группу узлов сети, которая является единственной группой для любого существующего узла сети. #### 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** файлов. Эти файлы конфигурации можно найти в */etc* папке. Файл **odbcinst.ini** может отсутствовать, и в этом случае его необходимо создать вручную. **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](https://dev.mysql.com/doc/connector-odbc/en/connector-odbc-configuration-connection-parameters.html) \[en\]. #### Configuration ODBC configuration is done by editing the **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. Please consider the following examples: **odbcinst.ini** [postgresql] Description = General ODBC for PostgreSQL Driver = /usr/lib64/libodbcpsql.so Setup = /usr/lib64/libodbcpsqlS.so FileUsage = 1 # Since 1.6 if the driver manager was built with thread support you may add another entry to each driver entry. # This entry alters the default thread serialization level. Threading = 2 **odbc.ini** [TEST_PSQL] Description = PostgreSQL database 1 Driver = postgresql #CommLog = /tmp/sql.log Username = zbx_test Password = zabbix # Name of Server. IP or DNS Servername = 127.0.0.1 # Database name Database = zabbix # Postmaster listening port Port = 5432 # Database is read only # Whether the datasource will allow updates. ReadOnly = No # PostgreSQL backend protocol # Note that when using SSL connections this setting is ignored. # 7.4+: Use the 7.4(V3) protocol. This is only compatible with 7.4 and higher backends. Protocol = 7.4+ # Includes the OID in SQLColumns ShowOidColumn = No # Fakes a unique index on OID FakeOidIndex = No # Row Versioning # Allows applications to detect whether data has been modified by other users # while you are attempting to update a row. # It also speeds the update process since every single column does not need to be specified in the where clause to update a row. RowVersioning = No # Show SystemTables # The driver will treat system tables as regular tables in SQLTables. This is good for Access so you can see system tables. ShowSystemTables = No # If true, the driver automatically uses declare cursor/fetch to handle SELECT statements and keeps 100 rows in a cache. Fetch = Yes # Bools as Char # Bools are mapped to SQL_CHAR, otherwise to SQL_BIT. BoolsAsChar = Yes # SSL mode SSLmode = Require # Send to backend on connection ConnSettings = #### Настройка Настройка ODBC выполняется путём редактирования файлов **odbcinst.ini** и **odbc.ini**. Эти файлы конфигурации можно найти в папке */etc*. Файл **odbcinst.ini** может отсутствовать, и в этом случае его необходимо создать вручную. Пожалуйста, рассмотрите следующие примеры: **odbcinst.ini** [postgresql] Description = General ODBC for PostgreSQL Driver = /usr/lib64/libodbcpsql.so Setup = /usr/lib64/libodbcpsqlS.so FileUsage = 1 # Since 1.6 if the driver manager was built with thread support you may add another entry to each driver entry. # This entry alters the default thread serialization level. Threading = 2 **odbc.ini** [TEST_PSQL] Description = PostgreSQL database 1 Driver = postgresql #CommLog = /tmp/sql.log Username = zbx_test Password = zabbix # Name of Server. IP or DNS Servername = 127.0.0.1 # Database name Database = zabbix # Postmaster listening port Port = 5432 # Database is read only # Whether the datasource will allow updates. ReadOnly = No # PostgreSQL backend protocol # Note that when using SSL connections this setting is ignored. # 7.4+: Use the 7.4(V3) protocol. This is only compatible with 7.4 and higher backends. Protocol = 7.4+ # Includes the OID in SQLColumns ShowOidColumn = No # Fakes a unique index on OID FakeOidIndex = No # Row Versioning # Allows applications to detect whether data has been modified by other users # while you are attempting to update a row. # It also speeds the update process since every single column does not need to be specified in the where clause to update a row. RowVersioning = No # Show SystemTables # The driver will treat system tables as regular tables in SQLTables. This is good for Access so you can see system tables. ShowSystemTables = No # If true, the driver automatically uses declare cursor/fetch to handle SELECT statements and keeps 100 rows in a cache. Fetch = Yes # Bools as Char # Bools are mapped to SQL_CHAR, otherwise to SQL_BIT. BoolsAsChar = Yes # SSL mode SSLmode = Require # Send tobackend on connection ConnSettings = #### Configuration ODBC configuration is done by editing the **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. Please consider the following examples: **odbcinst.ini** vi /etc/odbcinst.ini [FreeTDS] Driver = /usr/lib64/libtdsodbc.so.0 **odbc.ini** vi /etc/odbc.ini [sql1] Driver = FreeTDS Server = <SQL server 1 IP> PORT = 1433 TDS_Version = 8.0 #### Настройка Настройка ODBC выполняется путём редактирования файлов **odbcinst.ini** и **odbc.ini**. Эти файлы конфигурации можно найти в папке */etc*. Файл **odbcinst.ini** может отсутствовать, и в этом случае его необходимо создать вручную. Пожалуйста, рассмотрите следующие примеры: **odbcinst.ini** vi /etc/odbcinst.ini [FreeTDS] Driver = /usr/lib64/libtdsodbc.so.0 **odbc.ini** vi /etc/odbc.ini [sql1] Driver = FreeTDS Server = <SQL сервер 1 IP> PORT = 1433 TDS_Version = 8.0 ### 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. ### Настройка Если у вас есть [установленный](/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 серверу/прокси добавлены новые параметры конфигурации для аутентификации Хранилища и получения учётных данных базы данных: - VaultToken — токен аутентификации Хранилища (для получения более подробных сведений обратитесь к файлам конфигурации Zabbix [сервера](/manual/appendix/config/zabbix_server)/[прокси](/manual/appendix/config/zabbix_proxy)) - VaultURL — HTTP\[S\] URL-адрес сервера Хранилища - VaultDBPath — путь к Хранилищу, откуда будут извлекаться учётные данные для базы данных с помощью ключей «password» и «username» (например: secret/zabbix/database) Zabbix сервер и Zabbix прокси читают параметры конфигурации, связанные с Хранилищем, из zabbix\_server.conf и zabbix\_proxy.conf при запуске. Zabbix сервер и Zabbix прокси дополнительно считывают переменную среды «VAULT\_TOKEN» однократно во время запуска и удаляют её, чтобы она не была доступна через порождаемые (этими процессами) скрипты; будет ошибкой, если оба параметра VaultToken и VAULT\_TOKEN содержат значение. ::: noteclassic Прямая косая черта и двоеточие являются зарезервированными символами. Прямую косую черту можно использовать только для отделения точки монтирования от пути (например, secret/zabbix где точка монтирования — «secret», а «zabbix» — путь) и, в случае макросов Хранилища, двоеточие можно использовать только для отделения пути от ключа. Можно использовать URL-кодирование символов «/» и «:», если необходимо создать точку монтирования с именем, разделённым прямой косой чертой (например, foo/bar/zabbix где точка монтирования — «foo/bar», а путь — «zabbix», в виде «foo%2Fbar/zabbix») и если имя или путь точки монтирования должны содержать двоеточие. ::: #### Configuration parameters Zabbix agent, server and proxy support two [parameters](/manual/appendix/config/zabbix_server) to deal with modules: - LoadModulePath – full path to the location of loadable modules - LoadModule – module(s) to load at startup. The modules must be located in a directory specified by LoadModulePath or the path must precede the module name. If the preceding path is absolute (starts with '/') then LoadModulePath is ignored. It is allowed to include multiple LoadModule parameters. For example, to extend Zabbix agent we could add the following parameters: LoadModulePath=/usr/local/lib/zabbix/agent/ LoadModule=mariadb.so LoadModule=apache.so LoadModule=kernel.so LoadModule=/usr/local/lib/zabbix/dummy.so Upon agent startup it will load the mariadb.so, apache.so and kernel.so modules from the /usr/local/lib/zabbix/agent directory while dummy.so will be loaded from /usr/local/lib/zabbix. The agent will fail to start if a module is missing, in case of bad permissions or if a shared library is not a Zabbix module. #### Параметры конфигурации Zabbix агент, сервер и прокси поддерживают два [параметра](/manual/appendix/config/zabbix_server) для работы с модулями: - LoadModulePath — полный путь до расположения подгружаемых модулей - LoadModule — модуль(и) для загрузки при старте. Модули должны находиться в папке, указанной в параметре LoadModulePath, или же путь должен быть указан перед именем модуля. Если предшествующий путь абсолютный (начинается с «/»), то LoadModulePath игнорируется. Допускается добавлять несколько параметров LoadModule. Например, для расширения возможностей Zabbix агента мы можем добавить следующие параметры: LoadModulePath=/usr/local/lib/zabbix/agent/ LoadModule=mariadb.so LoadModule=apache.so LoadModule=kernel.so LoadModule=/usr/local/lib/zabbix/dummy.so При запуске агента будут загружены модули mariadb.so, apache.so и kernel.so из папки /usr/local/lib/zabbix/agent, тогда как dummy.so будет загружен из /usr/local/lib/zabbix. Агент не запустится, если модуль отсутствует, в случае некорректных прав доступа, или если разделяемая библиотека не является модулем Zabbix. #### 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, вам нужно создать [зависимый элемент данных](/manual/config/items/itemtypes/dependent_items), который использует шаг предварительной обработки Prometheus: - введите общие параметры зависимого элемента данных в диалоге настройки - перейдите на вкладку **Предобработка** - выберите шаг предобработки Prometheus (*Шаблон Prometheus* или *Prometheus в JSON*)  Следующие параметры специфичны для опции предобработки *Шаблон Prometheus*: |Параметр|Описание|Примеры| |--|------|------| |*Шаблон*|Чтобы определить необходимый шаблон данных, вы можете использовать язык запросов, который похож на язык запросов Prometheus (см. [таблицу сравнения](#сравнение-языка-запросов)), например:<br><имя метрики> - выбор по названию метрики<br>{\_\_name\_\_="<имя метрики>"} — выбор по названию метрики<br>{\_\_name\_\_=\~"<регулярное выражение>"} — выбор по названию метрики, соответствующему регулярному выражению<br>{<имя метки>="<значение метки>",...} — выбор по имени метки<br>{<имя метки>=\~"<регулярное выражение>",...} — выбор по имени метки, соответствующему регулярному выражению<br>{\_\_name\_\_=\~".\*"}==<значение> — выбор по значению метрики<br>Или сочетание вышеперечисленного:<br><имя метрики>{<имя метки1>="<значение метки1>",<имя метки2>=\~"<регулярное выражение>",...}==<значение><br><br>Значением метки может быть любая последовательность символов UTF-8, однако символы обратной косой черты, двойных кавычек и перевода строки необходимо экранированы как `\\`, `\"` и `\n` соответственно; другие символы не требуется экранировать.|*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*| |*Результат обработки*|Укажите, следует ли вернуть значение, метку или применить соответствующую функцию (если шаблон соответствует нескольким строкам и результат необходимо агрегировать):<br>**значение** — получение значения метрики (ошибка, если совпадут несколько строк)<br>**метка** — получение значения метки, указанной в поле *Метка* (ошибка, если совпадут несколько метрик)<br>**сумма** — получение суммы значений<br>**мин** — получение минимального значения<br>**макс** — получение максимального значения<br>**сред** — получение среднего значения<br>**кол-во** — получение количества значений<br>Это поле доступно только для опции *Шаблон Prometheus*. |Смотрите также примеры использования ниже.| |*Вывод*|Задайте имя метки (опционально). В этом случае вернётся значение, соответствующее имени метки.<br>Это поле доступно только для шага *Шаблон Prometheus*, если в поле *Результат обработки* выбрано «Метка».| | **Примеры использования параметров** 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` используйте следующие параметры: * *Шаблон* — `node_disk_usage_bytes{path="/var/db"}` * *Результат обработки* — выберите «значение» 2. Вас также может заинтересовать **усреднённое** значение по всем параметрам `node_disk_usage_bytes`: * *Шаблон* — `node_disk_usage_bytes` * *Результат обработки* — выберите «сред» 3. Хотя Prometheus поддерживает только числовые данные, часто используется обходное решение, которое также позволяет получить соответствующее текстовое значение. Это можно сделать при помощи фильтра и указания метки. Так, чтобы получить значение метки «color» из > `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` используйте следующие параметры: * *Шаблон* — `elasticsearch_cluster_health_status {cluster="elasticsearch"} == 1` * *Результат обработки* — выберите «метка» * *Метка* — укажите «color» Фильтр (на основе числового значения «1») совпадёт с соответствующей строкой, а метка вернет описание состояния работоспособности (в настоящий момент «green»; но возможны также «red» или «yellow»). #### 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. #### Настройка Экспорт в режиме реального времени событий по триггерам, значений элементов данных и динамики изменений настраивается путём задания директории для файлов экспорта - смотрите параметр `ExportDir` в [конфигурации сервера](/manual/appendix/config/zabbix_server). Доступны два других параметра: - `ExportFileSize` можно использовать, чтобы задать максимально разрешённый размер отдельного файла экспорта. Когда процессу требуется записать в файл, он сначала проверяет размер файла. Если он превышает настроенное ограничение размера, файл переименовывается путём добавления «.old» к его имени и создаётся новый файл с исходным именем. ::: noteimportant Файл будет создан на каждый процесс, который будет писать данные (т.е. примерно 4-30 файлов). Поскольку размер по умолчанию на один файл экспорта составляет 1ГБ, хранение больших файлов экспорта может быстро исчерпать место на диске. ::: - `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 proxy (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. ##### Синхронизация конфигурации Улучшена производительность процесса синхронизации конфигурации. Рекомендуется увеличить размер CacheSize на сервере/прокси, если используется большое количество шаблонов. Также рекомендуется удалить неиспользуемые шаблоны. Обратите внимание, что размер CacheSize по умолчанию на сервере/прокси увеличен до 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 Для инсталяций Zabbix с Oracle теперь возможно вручную изменить тип полей базы данных для элемента данных и предобработки с *nclob* на *nvarchar2* путём применения патча для базы данных. Применение патча может повысить скорость синхронизации конфигурации в средах с большим количеством элементов данных и шагов их предобработки, но сократит максимальный размер поля с 65535 байт до 4000 байт для некоторых параметров элементов данных. Смотрите [Известные проблемы](/manual/installation/known_issues#медленная-синхронизация-конфигурации-с-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). #### Настройка Глобальный часовой пояс: - можно установить вручную при [установке](/manual/installation/frontend) веб-интерфейса - можно изменить в *Администрирование* → *Общие* → *[Веб-интерфейс](/manual/web_interface/frontend_sections/administration/general#веб-интерфейс)* Часовой пояс на уровне пользователя: - можно установить, когда происходит [настройка/обновление](/manual/config/users_and_usergroups/user#общие-атрибуты) пользователя - можно установить каждому пользователю в его [профиле пользователя](/manual/web_interface/user_profile#профиль-пользователя) #### 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>*(Host name)*|<|Введите уникальное имя узла сети. Разрешены буквенно-цифровые символы, пробелы, точки, тире и подчёркивания. Однако, пробелы в начале и конце имени не разрешены.<br>*Обратите внимание:* При работающем Zabbix агенте на настраиваемом вами узле сети, параметр *Hostname* из [файла конфигурации](/manual/appendix/config/zabbix_agentd) агента должен иметь такое же значение, как и введённое здесь имя узла сети. Имя из этого параметра необходимо для обработки [активных проверок](/manual/appendix/items/activepassive).| |*Видимое имя*<br>*(Visible name)*|<|Введите уникальное видимое имя для узла сети. Если вы укажете это имя, именно оно будет видимо в списках, картах и прочем вместо технического имени узла сети. Этот атрибут имеет поддержку UTF-8.| |*Шаблоны*<br>*(Templates)*|<|Присоединение [шаблонов](/manual/config/templates) к узлу сети. Все объекты (элементы данных, триггеры, графики и т.д.) будут унаследованы от шаблона.<br>Для присоединения нового шаблона, начните вводить имя шаблона в поле *Шаблоны* до тех пор, пока не появится список совпадающих шаблонов. Прокрутите список и выберите нужный. Как вариант, вы можете нажать на *Выбрать* сразу после этого поля; затем сначала выбрать группу узлов сети, нажав *Выбрать* возле поля *Группа узлов сети*; отметить один или несколько шаблонов из списка ниже; нажать *Выбрать*. Шаблоны, выбранные в поле *Шаблоны*, будут присоединены к узлу сети, когда диалог настройки узла сети будет сохранён или обновлён.<br>Для отсоединения шаблона используйте одну из двух опций в блоке *Шаблоны*:<br>*Отсоединить* — отсоединение шаблона, с сохранением всех его элементов данных, триггеров и графиков;<br>*Отсоединить и очистить* — отсоединение шаблона и удаление всех его элементов данных, триггеров и графиков.<br>Имена перечисленных шаблонов являются ссылками, которые ведут на диалог настройки шаблона.| |*Группы*<br>*(Groups)*|<|Выберите [группы узлов сети](/manual/config/hosts/host_groups), к которым будет принадлежать узел сети. Узел сети должен принадлежать по крайней мере одной группе узлов сети. Новую группу можно создать и присоединить к узлу сети, добавив несуществующее имя группы; это новое имя будет отображаться в выпадающем списке с пометкой «новый» в скобках; нажатие на него добавит это имя в поле выбранных.| |*Интерфейсы*<br>*(Interfaces)*|<|Узлы сети поддерживают несколько типов интерфейсов: *Агент*, *SNMP*, *JMX* и *IPMI*.<br>По умолчанию интерфейсы не определены. Чтобы добавить новый интерфейс, нажмите на *Добавить* в блоке *Интерфейсы*, выберите тип интерфейса и введите информацию *IP/DNS*, *Подключаться через* и *Порт*.<br>*Обратите внимание:* Интерфейсы, которые используются какими-нибудь элементами данных, не могут быть удалены, и у них ссылка *Удалить* отображается серым.<br>Обратитесь к разделу [Настройка SNMP мониторинга](/manual/config/items/itemtypes/snmp#настройка-мониторинга-по-snmp) для получения более подробных сведений касательно настройки SNMP интерфейсов (v1, v2 и v3).| | |*IP адрес (IP address)*|IP адрес узла сети (опционально).| |^|*DNS имя (DNS name)*|DNS имя узла сети (опционально).| |^|*Подключаться через*<br>*(Connect to)*|Нажатие на соответствующую кнопку укажет Zabbix серверу, что использовать для получения данных от агентов:<br>**IP** — Подключение к узлу сети с использованием IP адреса (рекомендуется)<br>**DNS** — Подключение к узлу сети с использованием DNS имени| |^|*Порт*<br>*(Port)*|Номер TCP/UDP порта. Значения по умолчанию: 10050 для Zabbix агента, 161 для SNMP агента, 12345 для JMX и 623 для IPMI.| |^|*По умолчанию*<br>*(Default)*|Отметьте переключатель, чтобы указать интерфейс по умолчанию.| |*Описание (Description)*|<|Введите описание узла сети.| |*Наблюдение через прокси*<br>*(Monitored by proxy)*|<|Узел сети может наблюдаться через Zabbix сервер или через один из Zabbix прокси:<br>**(без прокси)** — узел сети наблюдается Zabbix сервером<br>**Имя прокси** — узел сети наблюдается через Zabbix прокси «Имя прокси»| |*Активировано*<br>*(Enabled)*|<|Когда флажок отмечен, узел сети активен — готов к мониторингу.<br><br>Когда флажок снят, узел сети будет неактивен — не наблюдается:<br>Для пассивных запросов данных, инициированных Zabbix сервером/прокси (например, [Zabbix агент](/manual/appendix/items/activepassive#пассивные-проверки), [SNMP агент](/manual/config/items/itemtypes/snmp), [простые проверки](/manual/config/items/itemtypes/simple_checks)), мониторинг прекращается после синхронизации конфигурации. Триггеры и действия, связанные с узлом сети, также отключаются только после обновления конфигурации.<br>Для [активных проверок](/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) на уровне узла сети в виде пар имени и значения. Обратите внимание, что значения макросов могут храниться как обычный текст, текст в виде секрета или секрет из Хранилища. Также поддерживается добавление описаний.  Вы также здесь можете просмотреть макросы уровня шаблона и глобальные макросы, если выберете опцию *Макросы узла сети и унаследованные*. Это то место, где отображаются все определённые пользовательские макросы для этого узла сети со своими раскрытыми значениями, а также информация о том, откуда эти макросы. {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)** - 64-bit unsigned integer<br>**Numeric (float)** - 64-bit 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#numeric-float-data-type-range-with-postgresql-11-and-earlier)).<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 postprocessing 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>Special processing is applied to the following units: **B**, **Bps**, **unixtime**, **uptime**, **s**.<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 [preventing unit conversion](/manual/appendix/suffixes#preventing-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*: custom intervals for active checks are supported by Zabbix agent 2 only.| |*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, an orange  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, an orange  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 be set to 0 in Unix time, representing January 1, 1970.<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 message.<br>The log time format for this line would be "pppppp:yyyyMMdd:hhmmss".<br>Note that "p" and ":" characters are placeholders and can be any characters except "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. [User macros](/manual/config/macros/user_macros) are supported.| |*Enabled*|Mark the checkbox to enable the item so it will be processed.| |*Latest data*|Click on the link to view the latest data for the item.<br>This link is only available when editing an already existing item.| ::: 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).  #### Настройка Вкладка **Элемент данных** содержит следующие атрибуты элементов данных.  Все обязательные поля ввода отмечены красной звёздочкой. |Параметр|Описание| |--|--------| |*Имя (Name)*|Имя элемента данных.| |*Тип (Type)*|Тип элемента данных. Смотрите отдельные разделы по [типам элементов данных](itemtypes).| |*Ключ (Key)*|Ключ элемента данных (до 2048 символов).<br>Поддерживаемые [ключи элементов данных](itemtypes) описаны в отдельных разделах по типам элементов данных.<br>Ключ должен быть уникальным в пределах одного узла сети.<br>Если тип ключа «Zabbix агент», «Zabbix агент (активный)» или «Простая проверка», то значение ключа должно поддерживаться Zabbix агентом или Zabbix сервером.<br>Смотрите также: корректный [формат ключа](/manual/config/items/item/key).| |*Тип информации*<br>*(Type of information)*|Тип хранения данных в базе данных после выполнения преобразований, если имеются.<br>**Числовой (целое положительное)** — 64-битное целое число без знака<br>**Числовой (с плавающей точкой)** — 64-битное число с плавающей точкой<br>Этот тип будет обеспечивать точность приблизительно 15 цифр и диапазон от -1,79E+308 до 1,79E+308 (за исключением [PostgreSQL 11 и более ранних версий](/manual/installation/known_issues#диапазон-типа-данных-числовой-с-дробной-точкой-в-postgresql-11-и-более-старых-версиях)).<br>Получение значений в научной нотации также поддерживается. Например: 1.23E+7, 1e308, 1.1E-4.<br>**Символ** — короткие текстовые данные.<br>**Журнал** — длинные текстовые данные с опциональными свойствами для журналов (штамп времени, источник, важность, logeventid).<br>**Текст** — длинные текстовые данные. Смотрите также [ограничения по текстовым данным](#ограничения-текстовых-данных).<br>Для ключей элементов данных, которые возвращают данные только в одном конкретном формате, соответствующий тип информации будет выбран автоматически.| |*Интерфейс узла сети*<br>*(Host interface)*|Выбор интерфейса узла сети. Это поле доступно при изменении элемента данных на уровне узла сети.| |*Единицы измерения*<br>*(Units)*|Если указан символ единиц измерения, Zabbix добавит постобработку полученного значения и отобразит его с заданным постфиксом единиц измерения.<br>По умолчанию, если исходное значение превышает 1000, оно делится на 1000 и соответственно отображается. Например, если вы задали *bps* и полученное значение равно 881764, оно будет отображено как 881.76 Kbps.<br>Специальная обработка применяется к следующим единицам измерения: **B**, **Bps**, **unixtime**, **uptime**, **s**.<br>Для единиц измерения **B** (байт), **Bps** (байты в секунду) при обработке используется [JEDEC](https://en.wikipedia.org/wiki/JEDEC_memory_standards) стандарт памяти, при котором значение делится на 1024. Таким образом, если единица измерения указана как **B** или **Bps**, Zabbix будет отображать:<br>1 как 1B/1Bps<br>1024 как 1KB/1KBps<br>1536 как 1.5KB/1.5KBps<br>Специальная обработка используется и для следующих единиц измерения, связанных со временем:<br>**unixtime** — преобразуется в «гггг.мм.дд чч:мм:сс». Для корректного преобразования возвращаемое значение должно быть с типом данных *Числовой (целое положительное)*.<br>**uptime** — переводится в «чч:мм:сс» или в «N дней, чч:мм:сс»<br>Например, если вы получили значение равное 881764 (секунд), оно отобразится как «10 дней, 04:56:04»<br>**s** — переводится в «ггг ммм ддд ччч ммм ссс мс»; параметр рассматривается как количество секунд.<br>Например, если вы получили значение равное 881764 (секунд), оно будет отображаться как «10д 4ч 56м»<br>Отображаются только 3 верхних единицы, такие как «1м 15д 5ч» или «2ч 4м 46с». В случае, если нет дней, то тогда отображаются только два уровня — «1м 5ч» (минуты, секунды или миллисекунды не будут отображаться). Будет переведено в «< 1 мс», если значение меньше чем 0.001.<br>*Обратите внимание*, если единица измерения представлена с префиксом «`!`», тогда к значениям элементов данных префиксы / обработка единиц измерения применяться не будет. Смотрите [предотвращение преобразования единиц измерения](/manual/appendix/suffixes#предотвращение-преобразования-единиц-измерения).| |*Интервал обновления*<br>*(Update interval)*|Получение нового значения по этому элементу данных каждые N секунд. Максимально допустимый интервал обновления — 86400 секунд (одни сутки).<br>Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например, 30s, 1m, 2h, 1d.<br>Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros).<br>Один макрос должен заполнять это поле целиком. Несколько макросов в поле или макросы вперемешку с текстом не поддерживаются.<br>*Обратите внимание*: интервал обновления может быть «0», только если заданы нестандартные интервалы с ненулевым значением. Если установлено значение «0» и задан пользовательский интервал (переменный или по расписанию) с ненулевым значением, элемент будет опрашиваться в соответствии с заданным пользовательским интервалом.<br>*Обратите внимание*, что первый опрос элемента данных после его активации или после изменения интервала обновления может произойти раньше, чем заданное значение.<br>У существующего пассивного элемента данных можно запросить опрос значения немедленно, нажав на [кнопку](#кнопки_диалога) *Проверить сейчас*.| |*Пользовательские интервалы*<br>*(Custom intervals)*|Вы можете создавать пользовательские правила проверки элемента данных:<br>**Переменный** — создание исключений из *Интервала обновления* (интервал с другой частотой обновления)<br>**По расписанию** — создание пользовательского расписания проверки.<br>Для получения более подробной информации смотрите [Пользовательские интервалы](/manual/config/items/item/custom_intervals).<br>[Суффиксы времени](/manual/appendix/suffixes) поддерживаются в поле *Интервал*, например, 30s, 1m, 2h, 1d.<br>Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros).<br>Один макрос должен заполнять это поле целиком. Несколько макросов в поле или макросы вперемешку с текстом не поддерживаются.<br>Проверка по расписанию поддерживается начиная с Zabix 3.0.0.<br>*Обратите внимание*: пользовательские интервалы для активных проверок поддерживаются только Zabbix агентом 2.| |*Период хранения истории*<br>*(History storage period)*|Выберите:<br>**Не хранить историю** — история элемента данных не сохраняется. Полезно для мастер элементов данных, если историю нужно хранить только по зависимым элементам данных.<br>Эту настройку нельзя переопределить глобальными [настройками](/manual/web_interface/frontend_sections/administration/general#очистка-истории) очистки истории.<br>**Период хранения** — укажите длительность хранения в базе данных детальной истории (от 1 часа до 25 лет). Более старые данные будут удалены с помощью функции автоматической очистки истории базы данных. Хранится в секундах.<br>Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например, 2h, 1d. Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros).<br>*Период хранения* можно переопределить глобально в *Администрирование → Общие → [Очистка истории](/manual/web_interface/frontend_sections/administration/general#очистка-истории)*.<br>Если глобальное переопределение активировано, будет отображаться оранжевая  иконка информации. Если вы поместите курсор мыши на эту иконку, отобразится сообщение с предупреждением, например, *Переопределено глобальной настройкой очистки истории (1d)*.<br>Рекомендуется хранить записанные значения как можно меньшее количество дней для уменьшения размера истории в базе данных. Вместо долговременного хранения истории значений, вы можете хранить в течение более долгого срока данные динамики изменений.<br>Смотрите также [История и динамика изменений](/manual/config/items/history_and_trends).| | *Период хранения динамики изменений*<br>*(Trend storage period)*|Выберите:<br>**Не хранить динамику изменений** — динамика изменений не сохраняется.<br>Эту настройку нельзя переопределить глобальными [настройками](/manual/web_interface/frontend_sections/administration/general#очистка-истории) очистки истории.<br>**Период хранения** — укажите период хранения усреднённых значений (ежечасные мин, макс, сред, количество) истории в базе данных (от 1 дня до 25 лет). Более старые данные будут удалены с помощью функции автоматической очистки истории базы данных. Хранится в секундах.<br>Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например, 24h, 1d. Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros).<br>*Период хранения* значение можно переопределить глобально в *Администрирование → Общие → [Очистка истории](/manual/web_interface/frontend_sections/administration/general#очистка-истории)*.<br>Если глобальное переопределение активировано, будет отображаться оранжевая  иконка информации. Если вы поместите курсор мыши на эту иконку, отобразится сообщение с предупреждением, например, *Переопределено глобальной настройкой очистки истории (7d)*.<br>*Обратите внимание:* Хранение динамики изменений недоступно для нечисловых данных — символ, журнал и текст.<br>Смотрите также [история и динамика изменений](/manual/config/items/history_and_trends).| |*Преобразование значений*<br>*(Value mapping)*|Применение преобразования значений к этому элементу данных. [Преобразование значений](/manual/config/items/mapping) не меняет полученные значения, оно служит только для отображения данных.<br>Работает только с элементами данных с типом *Числовой (целое положительное)*, *Числовой (с плавающей точкой)* и *Символ*.<br>Например: "Windows service states".| |*Формат времени журнала*<br>*(Log time format)*|Доступно только для элементов данных типа **Журнал**. Поддерживаемые заменители:<br>\* **y**: *Год (1970-2038)*<br>\* **M**: *Месяц (01-12)*<br>\* **d**: *День (01-31)*<br>\* **h**: *Час (00-23)*<br>\* **m**: *Минута (00-59)*<br>\* **s**: *Секунда (00-59)*<br>Если оставить это поле пустым, то штамп времени будет выставлен в 0, что в формате Unix time представляет 1 января 1070 года.<br>Например, рассмотрим следующую строку из файла журнала Zabbix агента:<br>« 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211).»<br>Она начинается с шести символьных позиций PID, далее дата, время и остальная часть сообщения.<br>Формат времени журнала для этой строки должен быть «pppppp:yyyyMMdd:hhmmss».<br>Обратите внимание, что символы «p» и «:» являются лишь заменителями и могут быть какими угодно, кроме «yMdhms».| |*Заполнение поля инвентаря узла сети*<br>*(Populates host inventory field)*|Вы можете выбрать поле инвентарных данных, которое будет заполняться значением элемента данных. Функция будет работать, если у узла сети включено автоматическое заполнение [инвентарных данных](/manual/config/hosts/inventory).<br>Это поле недоступно, если для поля *Тип информации* выбрано значение «Журнал».| |*Описание*<br>*(Description)*|Введите описание элемента данных.| |*Активировано*<br>*(Enabled)*|Отметьте для активации элемента данных; таким образом, он будет обрабатываться.| |*Последние данные*<br>*(Latest data)*|Нажмите на ссылку для просмотра последних данных по этому элементу данных.<br>Эта ссылка доступна только при изменении уже существующего элемента данных.| ::: noteclassic Особые поля, зависящие от типа элемента данных, описаны на [соответствующих страницах](itemtypes). ::: ::: noteclassic При редактировании элемента данных уровня [шаблона](/manual/config/templates) на уровне узла сети, некоторое количество полей доступно только для чтения. Вы можете воспользоваться ссылкой из заголовка диалога, перейти на уровень шаблона и отредактировать элемент данных там; однако, имейте в виду, что изменение элемента данных коснется всех узлов сети, к которым шаблон присоединён. ::: Вкладка **Теги** позволяет задавать [теги](/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. #### Настройка Правило низкоуровневого обнаружения должно быть создано как [зависимый элемент данных](/manual/config/items/itemtypes/dependent_items) от основного элемента данных HTTP, собирающего данные Prometheus. #### 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. #### Настройка Параметры агрегации доступны в настройках наборов данных при настройке [виджета графика](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#график).  Вы можете выбрать функцию агрегации и интервал времени. Поскольку набор данных может состоять из нескольких элементов данных, имеется также другая опция, позволяющая отображать агрегированные данные по каждому элементу данных отдельно или по всем наборам данных элементов данных одним агрегированным значением. #### Configuration The *Scheduled reports* tab contains general report attributes. {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Owner*|User that creates a report. *Super admin* level users are allowed to change the owner. For *Admin* level users, this field is read-only.| |*Name*|Name of the report; must be unique.| |*Dashboard*|Dashboard on which the report is based; only one dashboard can be selected at a time. To select a dashboard, start typing the name - a list of matching dashboards will appear; scroll down to select. Alternatively, you may click *Select* next to the field and select a dashboard from the displayed list.<br>If a dashboard contains multiple pages, only the first page will be sent as a report.| |*Period*|Period for which the report will be prepared. Select the previous day, week, month, or year.| |*Cycle*|Report generation frequency. The reports can be sent daily, weekly, monthly, or yearly. "Weekly" mode allows to select days of the week when the report will be sent.| |*Start time*|Time of the day in the format hh:mm when the report will be prepared. Note that Zabbix server time zone will be used.| |*Repeat on*|Days of the week when the report will be sent. This field is available only if *Cycle* is set to "Weekly".| |*Start date*|Date when regular report generation should be started.| |*End date*|Date when regular report generation should be stopped.| |*Subject*|Subject of the report email. Supports {TIME} macro.| |*Message*|Body of the report email. Supports {TIME} macro.| |*Subscriptions*|List of report recipients. By default, includes only the report owner. Any Zabbix user with configured email media may be specified as a report recipient.<br>Click *Add user* or *Add user group* to add more recipients.<br>Click the username to edit settings:<br>*Generate report by* - whether the report data should be generated based on the dashboard permissions of the current user or the recipient.<br>*Status* - select "Include" to send the report to the user or "Exclude" to prevent sending the report to this user. At least one user must have the "Include" status. The "Exclude" status can be used to exclude specific users from a user group that is included.<br><br>Note that users with insufficient permissions (that is, users with a role based on the *Admin* user type who are not members of the same user group as the recipient or report owner) will see "Inaccessible user" or "Inaccessible user group" instead of the actual names in the fields *Recipient* and *Generate report by*; the fields *Status* and *Action* will be displayed as read-only.| |*Enabled*|Report status. Clearing this checkbox will disable the report.| |*Description*|An optional description of the report. This description is for internal use and will not be sent to report recipients.| #### Настройка Вкладка *Регулярные отчёты (Scheduled reports)* содержит общие атрибуты отчёта. {width="600"} Все обязательные поля ввода отмечены красной звёздочкой. |Параметр|Описание| |--|--------| |*Владелец*<br>*(Owner)*|Пользователь, создающий отчёт. Пользователи уровня *Супер-администратор* могут изменить владельца. Пользователям уровня *Администратор* это поле доступно только на чтение.| |*Имя (Name)*|Имя отчёта; должно быть уникальным.| |*Панель*<br>*(Dashboard)*|Панель, на которой основывается отчёт; одновременно можно выбрать только одну панель. Чтобы выбрать панель, начните печатать её имя — появится список совпадающих панелей; прокрутите список и выберите. Кроме того, вы можете нажать на *Выбрать (Select)* после этого поля и выбрать панель из списка в всплывающем окне.<br>Если панель содержит несколько страниц, в качестве отчёта будет отправлена только первая страница.| |*Период*<br>*(Period)*|Период, за который будет подготовлен отчёт. Выберите одну из доступных опций: *Предыдущий день*, *Предыдущая неделя*, *Предыдущий месяц*, *Предыдущий год*.| |*Периодичность*<br>*(Cycle)*|Частота формирования отчёта. Отчёты можно отсылать каждый день, каждую неделю, каждый месяц или каждый год. Еженедельный режим позволяет выбрать дни недели, когда будет отсылаться отчёт.| |*Время начала*<br>*(Start time)*|Время суток в формате чч:мм, когда необходимо подготовить отчёт. Обратите внимание, что будет использоваться часовой пояс сервера Zabbix.| |*Повторение в*<br>*(Repeat on)*|Дни недели, когда необходимо отправлять отчёт. Это поле доступно, только если *Периодичность* установлена в значение «Еженедельно».| |*Дата начала*<br>*(Start date)*|Дата, с которой должно начаться формирование отчёта| |*Дата окончания*<br>*(End date)*|Дата, когда формирование отчёта должно прекратиться.| |*Тема (Subject)*|Тема e-mail отчёта. Поддерживает макрос {TIME}.| |*Сообщение*<br>*(Message)*|Тело e-mail отчёта. Поддерживает макрос {TIME}.| |*Подписки*<br>*(Subscriptions)*|Список получателей отчёта. По умолчанию включает только владельца отчёта. Получателем отчёта можно указать любого пользователя Zabbix с настроенным способом оповещения по электронной почте.<br>Нажмите на *Добавить пользователя (Add user)* или *Добавить группу пользователей (Add user group)* для добавления дополнительных получателей.<br>Нажмите на имя пользователя для изменения настроек:<br>*Генерировать отчёт от (Generate report by)* — должен ли отчёт формироваться от имени владельца отчёта или от имени получателя.<br>*Состояние (Status)* — выберите «Включено (Include)» для отправки отчёта пользователю или «Исключить (Exclude)» для исключения отправки отчёта этому пользователю. По крайней мере один пользователь должен иметь состояние «Включено». Состояние «Исключить» можно использовать для исключения отдельных пользователей из группы пользователей, которая включена.<br><br>Обратите внимание, что пользователи с недостаточными правами доступа (то есть, пользователи, у которых роль основана на типе пользователей «Администратор» и они не являются членами группы пользователей получателей или членами группы пользователей владельца отчёта) увидят «Недоступный пользователь» или «Недоступная группа пользователей» вместо реальных имён в полях *Получатель* и *Генерировать отчет от*; поля *Состояние* и *Действие* будут отображаться в режиме только чтения.| |*Активировано*<br>*(Enabled)*|Состояние отчёта. Снятие флажка отключает отчёт.| |*Описание*<br>*(Description)*|Необязательное описание отчёта. Это описание для внутреннего использования, оно не будет отправлено получателям отчёта.| #### Configuration The **Trigger** tab contains all the essential trigger attributes.  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Name*|Trigger name.<br>Supported [macros](/manual/appendix/macros/supported_by_location) are: {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.LASTVALUE}, {ITEM.LOG.\*} and {$MACRO} user macros.<br>**$1, $2...$9** macros can be used to refer to the first, second...ninth constant of the expression.<br>*Note*: $1-$9 macros will resolve correctly if referring to constants in relatively simple, straightforward expressions. For example, the name "Processor load above $1 on {HOST.NAME}" will automatically change to "Processor load above 5 on New host" if the expression is last(/New host/system.cpu.load\[percpu,avg1\])>5| |*Event name*|If defined, this name will be used to create the problem event name, instead of the trigger name.<br>The event name may be used to build meaningful alerts containing problem data (see [example](/manual/config/triggers/expression#example_18)).<br>The same set of macros is supported as in the trigger name, plus {TIME} and {?EXPRESSION} expression macros.<br>Supported since Zabbix 5.2.0.| |*Operational data*|Operational data allow to define arbitrary strings along with macros. The macros will resolve dynamically to real time data in *Monitoring* → *[Problems](/manual/web_interface/frontend_sections/monitoring/problems)*. While macros in the trigger name (see above) will resolve to their values at the moment of a problem happening and will become the basis of a static problem name, the macros in the operational data maintain the ability to display the very latest information dynamically. If no operational data is configured on a trigger level, the latest values of all items from the expression will be displayed.<br>The same set of macros is supported as in the trigger name.| |*Severity*|Set the required trigger [severity](severity) by clicking the buttons.| |*Expression*|Logical [expression](expression) used to define the conditions of a problem.<br>A problem is created after all the conditions included in the expression are met, i.e. the expression evaluates to TRUE. The problem will be resolved as soon as the expression evaluates to FALSE, unless additional recovery conditions are specified in *Recovery expression*.| |*OK event generation*|OK event generation options:<br>**Expression** - OK events are generated based on the same expression as problem events;<br>**Recovery expression** - OK events are generated if the problem expression evaluates to FALSE and the recovery expression evaluates to TRUE;<br>**None** - in this case the trigger will never return to an OK state on its own.| |*Recovery expression*|Logical [expression](expression) (optional) defining additional conditions that have to be met before the problem is resolved, after the original problem expression has already been evaluated as FALSE.<br>Recovery expression is useful for trigger [hysteresis](/manual/config/triggers/expression#hysteresis). It is **not** possible to resolve a problem by recovery expression alone if the problem expression is still TRUE.<br>This field is only available if 'Recovery expression' is selected for *OK event generation*.| |*PROBLEM event generation mode*|Mode for generating problem events:<br>**Single** - a single event is generated when a trigger goes into the 'Problem' state for the first time;<br>**Multiple** - an event is generated upon *every* 'Problem' evaluation of the trigger.| |*OK event closes*|Select if OK event closes:<br>**All problems** - all problems of this trigger<br>**All problems if tag values match** - only those trigger problems with matching event tag values| |*Tag for matching*|Enter event tag name to use for event correlation.<br>This field is displayed if 'All problems if tag values match' is selected for the *OK event closes* property and is mandatory in this case.| |*Allow manual close*|Check to allow [manual closing](/manual/config/events/manual_close) of problem events generated by this trigger. Manual closing is possible when acknowledging problem events.| |*URL*|If not empty, the URL entered here is available as a link in several frontend locations, e.g. when clicking on the problem name in *Monitoring → Problems* (*URL* option in the *Trigger* menu) and *Problems* dashboard widget.<br>The same set of macros is supported as in the trigger name, plus {EVENT.ID}, {HOST.ID} and {TRIGGER.ID}. Note that user macros with secret values will not be resolved in the URL.| |*Description*|Text field used to provide more information about this trigger. May contain instructions for fixing specific problem, contact detail of responsible staff, etc.<br>The same set of macros is supported as in the trigger name.| |*Enabled*|Unchecking this box will disable the trigger if required.<br>Problems of a disabled trigger are no longer displayed in the frontend, but are not deleted.| The **Tags** tab allows you to define trigger-level [tags](/manual/config/tagging). All problems of this trigger will be tagged with the values entered here.  In addition the *Inherited and trigger tags* option allows to view tags defined on template level, if the trigger comes from that template. If there are multiple templates with the same tag, these tags are displayed once and template names are separated with commas. A trigger does not "inherit" and display host-level tags. |Parameter|Description| |--|--------| |*Name/Value*|Set custom tags to mark trigger events.<br>Tags are a pair of tag name and value. You can use only the name or pair it with a value. A trigger may have several tags with the same name, but different values.<br>User macros, user macros with context, low-level discovery macros, and macro [functions](/manual/config/macros/macro_functions) with `{{ITEM.VALUE}}`, `{{ITEM.LASTVALUE}}` are supported in event tags. Low-level discovery macros can be used inside macro context.<br>{TRIGGER.ID} macro is supported in trigger tag values. It may be useful for identifying triggers created from trigger prototypes and, for example, suppressing problems from these triggers during maintenance.<br>If the total length of expanded value exceeds 255, it will be cut to 255 characters.<br>See all [macros](/manual/config/tagging#macro_support) supported for event tags.<br>[Event tags](/manual/config/tagging) can be used for event correlation, in action conditions and will also be seen in *Monitoring* → *Problems* or the *Problems* widget.| The **Dependencies** tab contains all the [dependencies](dependencies) of the trigger. Click on *Add* to add a new dependency. ::: noteclassic You can also configure a trigger by opening an existing one, pressing the *Clone* button and then saving under a different name. ::: #### Настройка Вкладка **Триггер** содержит все существенные атрибуты триггера.  Все обязательные поля ввода отмечены красной звёздочкой. |Параметр|Описание| |--|--------| |*Имя*<br>*(Name)*|Имя триггера.<br>Поддерживаемые [макросы](/manual/appendix/macros/supported_by_location): {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.LASTVALUE}, {ITEM.LOG.\*} и пользовательские макросы {$МАКРОС}.<br>Можно использовать макросы **$1, $2...$9**, чтобы сослаться на первую, вторую...девятую константы из выражения.<br>*Обратите внимание*: Макросы $1—$9 будут раскрыты корректно, если ссылаются на константы в относительно простых, понятных выражениях. Например, имя «Загрузка процессора превышает $1 на {HOST.NAME}» будет автоматически изменено на «Загрузка процессора превышает 5 на Новый узел сети», если выражение — last(/Новый узел сети/system.cpu.load\[percpu,avg1\])>5 | |*Имя события*<br>*(Event name)*|Если указано, это имя будет использования для создания имени события о проблеме, вместо имени триггера.<br>Имя события можно использовать для построения осмысленных оповещений, содержащих данные о проблеме (смотрите [пример](/manual/config/triggers/expression#пример-18)).<br>Поддерживается тот же самый набор макросов, что и в имени триггера, плюс {TIME} и макросы выражений {?EXPRESSION}.<br>Поддерживается с Zabbix 5.2.0.| |*Оперативные данные*<br>*(Operational data)*|Оперативные данные позволяют задать произвольные строки вместе с макросами. Эти макросы будут раскрываться динамически с соответствии с данными в реальном времени в *Мониторинг* → *[Проблемы](/manual/web_interface/frontend_sections/monitoring/problems)*. В то время как макросы в имени триггера (см. выше) раскроются в свои значения на момент наступления проблемы и станут основой статического имени проблемы, макросы в оперативных данных сохранят возможность отображения динамически самой последней информации. Если на уровне триггера не настроены никакие оперативные данные, будут отображены последние значения всех элементов данных из выражения.<br>Поддерживается тот же самый набор макросов, что и в имени триггера.| |*Важность* *(Severity)*|Задайте требуемую [важность](severity) триггера нажатием кнопок.| |*Выражение проблемы*<br>*(Expression)*|Логическое [выражение](expression), используемое для определения условий проблемы.<br>Проблема создается после того, как все условия, включённые в выражение, удовлетворены, то есть результатом вычисления выражения является значение ИСТИНА. Проблема будет решена, как только результатом вычисления выражения будет значение ЛОЖЬ, если только в *Выражении восстановления* не указаны дополнительные условия восстановления.| |*Генерация ОК событий*<br>*(OK event generation)*|Опции формирования ОК событий:<br>**Выражение (Expression)** — ОК события формируются на основе того же выражения, что и события о проблемах;<br>**Выражение восстановления (Recovery expression)** — OK события формируются, если выражение проблемы вычисляется как ЛОЖЬ и выражение восстановления вычисляется как ИСТИНА;<br>**Нет (None)** — в этом случае триггер никогда самостоятельно не вернётся в состояние ОК.| |*Выражение восстановления*<br>*(Recovery expression)*|Логическое [выражение](expression) (опционально), определяющее дополнительные условия, которые должны быть удовлетворены для решения проблемы, после того, как исходное выражение проблемы уже вычислено как ЛОЖЬ.<br>Выражение восстановления полезно для [гистерезиса](/manual/config/triggers/expression#гистерезис) триггера. Возможность решения проблемы при помощи только выражения восстановления **отсутствует**, если выражение проблемы по-прежнему ИСТИНА.<br>Это поле доступно, только если в поле *Генерация ОК событий* выбрано «Выражение восстановления».| |*Режим генерации событий ПРОБЛЕМА*<br>*(PROBLEM event generation mode)*|Режим формирования событий о проблемах:<br>**Одиночный (Single)** — формируется одно событие, когда триггер переходит в состояние «Проблема» в первый раз;<br>**Множественный (Multiple)** — событие формируется на *каждое* вычисление триггера «Проблема».| |*ОК событие закрывает*<br>*(OK event closes)*|Выберите, если ОК событие закрывает:<br>**Все проблемы (All problems)** — все проблемы этого триггера<br>**Все проблемы, если значение тега совпадает (All problems if tag values match)** — только те проблемы триггера, значения тегов событий которых совпадают| |*Теги для совпадения*<br>*(Tag for matching)*|Укажите имя тега события, которое будет использоваться для корреляции событий.<br>Это поле отображается, если в свойстве *ОК событие закрывает* выбрано «Все проблемы, если значения тегов совпадают», и в этом случае это поле обязательно.| |*Разрешить закрывать вручную*<br>*(Allow manual close)*|Выберите, чтобы разрешить [закрывать вручную](/manual/config/events/manual_close) события о проблемах, сформированные этим триггером. Закрытие вручную возможно при подтверждении событий о проблемах.| |*URL*|Если не пустое, то URL, указанный здесь, доступен в виде ссылки в нескольких местах веб-интерфейса, например при нажатии на имя проблемы в *Мониторинг → Проблемы* (опция *URL* в меню *Триггер*) и в виджете *Проблемы* на панели.<br>Поддерживается тот же самый набор макросов, что и в имени триггера, плюс {EVENT.ID}, {HOST.ID} и {TRIGGER.ID}. Обратите внимание, что в URL не будут раскрыты пользовательские макросы со скрытыми значениями.| |*Описание*<br>*(Description)*|Текстовое поле используется, чтобы предоставить больше информации об этом триггере. Может содержать инструкции по устранению специфичной проблемы, контактные данные ответственного сотрудника и т.п.<br>Поддерживается тот же самый набор макросов, что и в имени триггера.| |*Активировано*<br>*(Enabled)*|Уберите отметку, чтобы отключить триггер при необходимости.<br>Проблемы по отключенным триггерам более не будут отображаться в веб-интерфейсе, но также и не будут удалены.| На вкладке **Теги (Tags)** можно задать [теги](/manual/config/tagging) уровня триггера. Все проблемы этого триггера будут иметь теги со значениями, указанными здесь.  Кроме того, опция *Унаследованные и собственные теги (Inherited and trigger tags)* позволяет просмотреть теги, заданные на уровне шаблона, если триггер пришёл из этого шаблона. Если имеется несколько шаблонов с одинаковым тегом, эти теги отображаются однократно, а имена шаблонов перечисляются через запятую. Триггер не «наследует» и не отображает теги уровня узла сети. |Параметр|Описание| |--|--------| |*Имя/Значение*<br>*(Name/Value)*|Укажите пользовательские теги для маркировки событий триггера.<br>Тег является парой из имени тега и значения. Вы можете использовать только имя или имя вместе со значением. У триггера может быть несколько тегов с одинаковым именем, но разными значениями.<br>В тегах событий поддерживаются пользовательские макросы, пользовательские макросы с контекстом, макросы низкоуровневого обнаружения и [функции](/manual/config/macros/macro_functions) макросов с `{{ITEM.VALUE}}` и `{{ITEM.LASTVALUE}}`. Макросы низкоуровневого обнаружения можно использовать внутри контекста макросов.<br>Макрос {TRIGGER.ID} поддерживается в значениях тега триггеров. Он может быть полезным для идентификации триггеров, созданных из прототипов триггеров и, например, для подавления проблем от таких триггеров во время обслуживания.<br>Если суммарная длина раскрытого значения превышает 255, значение будет обрезано до 255 символов.<br>Смотрите все [макросы](/manual/config/tagging#поддержка-макросов), поддерживаемые для тегов событий.<br>[Теги событий](/manual/config/tagging) можно использовать для корреляции событий, в условиях к действиям, также они видны в *Мониторинг* → *Проблемы* и в виджете *Проблемы*.| Вкладка **Зависимости (Dependencies)** содержит все [зависимости](dependencies) триггера. Нажмите на *Добавить (Add)* для добавления новой зависимости. ::: noteclassic Вы также можете настроить триггер, открыв уже существующий триггер, нажав на кнопку *Клонировать (Clone)*, а затем сохранив уже новый триггер под другим именем. ::: ### 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[<команда>,\*] добавлен для каждой разрешённой команды в конфигурации агента, чтобы разрешить конкретную команду в режиме nowait. Перезапустите демона агента, если изменили этот параметр. ::: noteimportant Удалённые команды не работают с активными Zabbix агентами. ::: Затем, при настройке нового действия в *Настройка → Действия (Configuration → Actions)*: - Задайте соответствующие условия. В этом примере указывается, что команда активируется в случае любых чрезвычайных проблем в одном из приложений Apache:  - На вкладке *[Операции](/manual/config/notifications/action/operation#настройка-операции) (Operations)* нажмите на Добавить (Add) в блоке Операции/Операции восстановления/Операции обновления (Operations/Recovery operations/Update operations) - Из выпадающего списка Операций выберите один из заранее настроенных скриптов  - Выберите список целей для этого скрипта #### Configuration To add the widget, select *Geomap* as type.  #### Настройка Чтобы добавить виджет, выберите *Геокарта (Geomap)* в качестве типа.  #### 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. #### Настройка Для назначения триггеров как индикаторов связи, сделайте следующее: - выберите элемент карты - нажмите на *Изменить (Edit)* в разделе *Связи (Links)* у соответствующей связи - нажмите на *Добавить (Add)* в блоке *Индикаторы связи (Link indicators)* и выберите один или более триггеров {width="600"} Все обязательные поля ввода отмечены красной звёздочкой. Добавленные триггеры будут видны в списке *Индикаторы связи*. Вы можете выбрать тип и цвет связи для каждого триггера напрямую из списка. Когда завершите, нажмите на *Применить (Apply)*, закройте диалог и нажмите на *Обновить (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 отправит оповещения только тем пользователям, которые имеют по крайней мере права на «чтение» узла сети, который сформировал это событие. По крайней мере один узел сети из выражения триггера должен быть доступен. ::: Вы можете настроить пользовательские сценарии для отправки сообщений с использованием [эскалаций](/manual/config/notifications/action/escalations). Для успешного получения и чтения e-mail от Zabbix, e-mail сервера/клиенты должны поддерживать стандарт «SMTP/MIME e-mail», поскольку Zabbix отправляет данные в кодировке UTF-8 (если тема содержит только ASCII символы, она не будет перекодирована в UTF-8). Тема и тело сообщения кодируются в base64, чтобы они соответствовали стандарту формата «SMTP/MIME e-mail». Ограничение длины сообщения после раскрытия макросов такое же, как и ограничение длины сообщения для [Удалённых команд](/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#предобработка) - Нажмите на *Добавить* - Выберите опцию *CSV в JSON* {width="600"} Первый параметр позволяет задать пользовательский разделитель. Обратите внимание, если первая строка входящих данных CSV начинается с «Sep=» и затем следует один UTF-8 символ, тогда этот символ будет использоваться в качестве разделителя в случае, если первый параметр не задан. Если первый параметр не задан и разделитель не извлекается из строки «Sep=», то в качестве разделителя будет использоваться запятая. Второй опциональный параметр позволяет задать символ кавычек. Если отмечен флажок *Со строкой заголовка*, значения строки заголовка будут интерпретированы как имена столбцов (смотрите [Обработка заголовка](#обработка-заголовка) для получения более подробной информации). Если отмечен флажок *Другое при ошибке*, элемент данных не станет неподдерживаемым в случае ошибки на шаге предварительной обработки. Кроме того, можно задать пользовательскую обработку ошибок: отбросить значение, задать нужное значение или задать нужное сообщение об ошибке. #### 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.| #### Настройка Для настройки периода обслуживания: - Перейдите в: *Настройка → Обслуживание (Configuration → Maintenance)* - Нажмите на *Создать период обслуживания (Create maintenance period)* (или на имени уже существующего периода обслуживания) - Введите параметры обслуживания в диалоге  Все обязательные поля ввода отмечены красной звёздочкой. |Параметр|Описание| |--|--------| |*Имя (Name)*|Имя периода обслуживания.| |*Тип обслуживания*<br>*(Maintenance type)*|Можно указать два типа обслуживания:<br>**Со сбором данных** — данные будут собираться сервером в течение обслуживания, триггеры будут обрабатываться<br>**Без сбора данных** — данные не будут собираться сервером в течение обслуживания| |*Активно с*<br>*(Active since)*|Дата и время, когда выполняемые периоды обслуживания становятся активными.<br>*Обратите внимание*: Установка только этого времени не активирует период обслуживания; чтобы это сделать, перейдите к блоку *Периоды* (см. ниже).| |*Активно до*<br>*(Active till)*|Дата и время, когда выполняемые периоды обслуживания перестают быть активными.| |*Периоды*<br>*(Periods)*|Этот блок позволяет вам указать точные дни и часы, когда обслуживание будет действовать. При нажатии на  (Добавить) откроется всплывающее окно с гибким диалогом *Период обслуживания*, где вы можете задать расписание обслуживания. Для получения более подробных сведений смотрите [Периоды обслуживания](#периоды_обслуживания).| |*Группы узлов сети*<br>*(Host groups)*|Выберите группы узлов сети, для которых обслуживание будет активировано. Обслуживание будет активировано по всем узлам сети из указанных групп(ы) узлов сети. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы, будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню.<br>Если указать родительскую группу, косвенным образом будут выбраны все вложенные группы узлов сети. Таким образом, обслуживание будет также активировано на узлах сети из вложенных групп.| |*Узлы сети*<br>*(Hosts)*|Выберите узлы сети, для которых обслуживание будет активировано. Это поле с функцией автодополнения; таким образом, после начала ввода имени узла сети, будет автоматически предложен список совпадающих узлов сети в выпадающем меню.| |*Теги*<br>*(Tags)*|Если заданы теги обслуживания, тогда обслуживание по выбранным узлам сети будет активировано, но подавляться будут только проблемы с совпадающими тегами (то есть действия не будут применяться).<br>В случае нескольких тегов поведение вычисляется следующим образом:<br>**И/Или** — должны соответствовать все теги; однако, теги с одинаковыми именами вычисляются с условием Или<br>**Или** — достаточно соответствия одного тега<br>Имеется два способа сопоставления значения тега:<br>**Содержит** — совпадение подстроки с учётом регистра (значение тега содержит введённую строку)<br>**Равно** — соответствие строке с учётом регистра (значение тега равно введённой строке)<br>Теги можно указать, только если выбран режим *Со сбором данных*.| |*Описание (Description)*|Описание периода обслуживания.| #### Configuration To configure an HTTP 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 HTTP items are: |Parameter|Description| |--|--------| |*Type*|Select **HTTP agent** here.| |*Key*|Enter a unique item key.| |*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 HTTP check.<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>Limited to 2048 characters.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<br>This sets the [CURLOPT\_URL](https://curl.haxx.se/libcurl/c/CURLOPT_URL.html) cURL option.| |*Query fields*|Variables for the URL (see above).<br>Specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from macros are resolved and then URL-encoded automatically.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<br>This sets the [CURLOPT\_URL](https://curl.haxx.se/libcurl/c/CURLOPT_URL.html) cURL option.| |*Request type*|Select request method type: *GET*, *POST*, *PUT* or *HEAD*| |*Timeout*|Zabbix will not spend more than the set amount of time on processing the URL (1-60 seconds). Actually this parameter defines the maximum time for making a connection to the URL and maximum time for performing an HTTP request. Therefore, Zabbix will not spend more than 2 x Timeout seconds on one check.<br>Time suffixes are supported, e.g. 30s, 1m.<br>Supported macros: user macros, low-level discovery macros.<br>This sets the [CURLOPT\_TIMEOUT](https://curl.haxx.se/libcurl/c/CURLOPT_TIMEOUT.html) cURL option.| |*Request body type*|Select the request body type:<br>**Raw data** - custom HTTP request body, macros are substituted but no encoding is performed<br>**JSON data** - HTTP request body in JSON format. Macros can be used as string, number, true and false; macros used as strings must be enclosed in double quotes. Values from macros are resolved and then escaped automatically. If "Content-Type" is not specified in headers then it will default to "Content-Type: application/json"<br>**XML data** - HTTP request body in XML format. Macros can be used as a text node, attribute or CDATA section. Values from macros are resolved and then escaped automatically in a text node and attribute. If "Content-Type" is not specified in headers then it will default to "Content-Type: application/xml"<br>*Note* that selecting *XML data* requires libxml2.| |*Request body*|Enter the request body.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.| |*Headers*|Custom HTTP headers that will be sent when performing a request.<br>Specified as attribute and value pairs.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<br>This sets the [CURLOPT\_HTTPHEADER](https://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURL option.| |*Required status codes*|List of expected HTTP status codes. If Zabbix gets a code which is not in the list, the item will become unsupported. If empty, no check is performed.<br>For example: 200,201,210-299<br>Supported macros in the list: user macros, low-level discovery macros.<br>This uses the [CURLINFO\_RESPONSE\_CODE](https://curl.haxx.se/libcurl/c/CURLINFO_RESPONSE_CODE.html) cURL option.| |*Follow redirects*|Mark the checkbox to follow HTTP redirects.<br>This sets the [CURLOPT\_FOLLOWLOCATION](https://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html) cURL option.| |*Retrieve mode*|Select the part of response that must be retrieved:<br>**Body** - body only<br>**Headers** - headers only<br>**Body and headers** - body and headers| |*Convert to JSON*|Headers are saved as attribute and value pairs under the "header" key.<br>If 'Content-Type: application/json' is encountered then body is saved as an object, otherwise it is stored as string, for example:<br>| |*HTTP proxy*|You can specify an HTTP proxy to use, using the format `[protocol://][username[:password]@]proxy.example.com[:port]`.<br>The optional `protocol://` prefix may be used to specify alternative proxy protocols (e.g. https, socks4, socks5; see [documentation](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html); the protocol prefix support was added in cURL 7.21.7). With no protocol specified, the proxy will be treated as an HTTP proxy. If you specify the wrong protocol, the connection will fail and the item will become unsupported.<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>*Note* that only simple authentication is supported with HTTP proxy.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<br>This sets the [CURLOPT\_PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html) cURL option.| |*HTTP authentication*|Authentication type:<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, where user macros and low-level discovery macros are supported.<br>This sets the [CURLOPT\_HTTPAUTH](https://curl.haxx.se/libcurl/c/CURLOPT_HTTPAUTH.html) cURL option.| |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server. 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.<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.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<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.<br>Supported macros: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, user macros, low-level discovery macros.<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>Supported macros: user macros, low-level discovery macros.<br>This sets the [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) cURL option.| |*Enable trapping*|With this checkbox marked, the item will also function as [trapper item](/manual/config/items/itemtypes/trapper) and will accept data sent to this item by Zabbix sender or using Zabbix sender protocol.| |*Allowed hosts*|Visible only if *Enable trapping* checkbox is marked.<br>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.<br>Host macros: {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN} are allowed in this field.| ::: notetip If the *HTTP proxy* field is left empty, another way for using an HTTP proxy is to set proxy-related environment variables. For HTTP - set the `http_proxy` environment variable for the Zabbix server user. For example:<br> `http_proxy=http://proxy_ip:proxy_port`. For HTTPS - set the `HTTPS_PROXY` environment variable. For example:<br> `HTTPS_PROXY=http://proxy_ip:proxy_port`. More details are available by running a shell command: *\# man curl*. ::: ::: 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 ::: #### Настройка Для настройки HTTP элемента данных: - Перейдите в: *Настройка* → *Узлы сети* - Нажмите на *Элементы данных* в строке с узлом сети - Нажмите на *Создать элемент данных* - Введите параметры элемента данных в диалоге  Все обязательные поля ввода отмечены красной звёздочкой. Поля, которые требуют информацию, специфичную для HTTP элементов данных: |Параметр|Описание| |--|--------| |*Тип (Type)*|Здесь выберите **HTTP агент**.| |*Ключ (Key)*|Введите уникальный ключ элемента данных.| |*URL*|URL для подключения и получения данных. Например:<br>https://www.example.com<br>http://www.example.com/download<br>Имена доменов можно указывать Юникод символами. Они автоматически конвертируются методом punycode в ASCII при выполнении HTTP проверки.<br>Кнопку *Анализ (Parse)* можно использовать, чтобы отделить из URL опциональные поля запроса (например, ?name=Admin&password=mypassword), переместив атрибуты и значения в *Поля запроса*, чтобы URL кодировка выполнялась автоматически.<br>Ограничено 2048 символами.<br>Поддерживаемые макросы: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, пользовательские макросы, макросы низкоуровневого обнаружения.<br>Это поле задаёт опцию cURL [CURLOPT\_URL](https://curl.haxx.se/libcurl/c/CURLOPT_URL.html) \[en\].| |*Поля запроса*<br>*(Query fields)*|Переменные для URL (см. выше).<br>Задаются в виде пар атрибутов и значений.<br>Значения автоматически URL-кодируются. Значения из макросов раскрываются и затем автоматически URL-кодируются.<br>Поддерживаемые макросы: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, пользовательские макросы, макросы низкоуровневого обнаружения.<br>Это поле задаёт опцию cURL [CURLOPT\_URL](https://curl.haxx.se/libcurl/c/CURLOPT_URL.html) \[en\].| |*Тип запроса*<br>*(Request type)*|Выберите тип метода запроса: *GET*, *POST*, *PUT* или *HEAD*| |*Время ожидания*<br>*(Timeout)*|Zabbix не будет тратить более указанного времени при обработке URL (1-60 секунд). В действительности же этот параметр определяет максимальное время создания подключения к URL и максимальное время выполнения HTTP запроса. Следовательно, Zabbix не будет тратить более **2 x Время ожидания** секунд за одну проверку.<br>Поддерживаются суффиксы времени, например, 30s, 1m.<br>Поддерживаемые макросы: пользовательские макросы, макросы низкоуровневого обнаружения.<br>Это поле задаёт опцию cURL [CURLOPT\_TIMEOUT](https://curl.haxx.se/libcurl/c/CURLOPT_TIMEOUT.html) \[en\].| |*Тип тела запроса*<br>*(Request body type)*|Выберите тип тела запроса:<br>**Сырые данные (Raw data)** — пользовательское тело HTTP запроса, макросы заменяются, но кодирование не выполняется<br>**JSON данные (JSON data)** — тело HTTP запроса в формате JSON. Макросы можно использовать в виде строк, чисел, true или false; макросы, которые используются в виде строки, должны быть заключены в двойные кавычки. Значения из макросов раскрываются и затем экранируются автоматически. Если в заголовках «Content-Type» не задан, тогда будет указано значение по умолчанию «Content-Type: application/json»<br>**XML данные (XML data)** — тело HTTP запроса в формате XML. Макросы можно использовать в виде текстового узла, атрибута или секции CDATA. Значения из макросов раскрываются и затем автоматически экранируются в текстовых узлах и в атрибутах. Если в заголовках «Content-Type» не задан, тогда будет указано значение по умолчанию «Content-Type: application/xml»<br>*Обратите внимание*, что выбор *XML данные* требует наличия поддержки libxml2.| |*Тело запроса*<br>*(Request body)*|Введите тело запроса.<br>Поддерживаемые макросы: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, пользовательские макросы, макросы низкоуровневого обнаружения.| |*Заголовки*<br>*(Headers)*|Пользовательские HTTP заголовки, которые будут отправлены при выполнении запроса.<br>Задаются в виде пар атрибутов и значений.<br>Поддерживаемые макросы: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, пользовательские макросы, макросы низкоуровневого обнаружения.<br>Это поле задаёт опцию cURL [CURLOPT\_HTTPHEADER](https://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) \[en\].| |*Требуемые коды состояния*<br>*(Required status codes)*|Список ожидаемых кодов состояния HTTP. Если Zabbix получает код не из списка, то элемент данных станет неподдерживаемым. Если поле не заполнено, то проверка не производится.<br>Например: 200,201,210-299<br>Поддерживаемые макросы в этом списке: пользовательские макросы, макросы низкоуровневого обнаружения.<br>Это поле задаёт опцию cURL [CURLINFO\_RESPONSE\_CODE](https://curl.haxx.se/libcurl/c/CURLINFO_RESPONSE_CODE.html) \[en\].| |*Следовать перенаправлениям*<br>*(Follow redirects)*|Отметьте для следования HTTP перенаправлениям.<br>Это поле задаёт опцию cURL [CURLOPT\_FOLLOWLOCATION](https://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html) \[en\].| |*Режим получения*<br>*(Retrieve mode)*|Выберите часть ответа, которую необходимо получать:<br>**Тело (Body)** — только тело<br>**Заголовки (Headers)** — только заголовки<br>**Тело и заголовки (Body and headers)** — тело и заголовки| |*Конвертация в JSON*<br>*(Convert to JSON)*|Заголовки сохраняются в виде пар атрибутов и значений под ключом "header".<br>Если встречается 'Content-Type: application/json', тогда тело сохраняется в виде объекта, в противном случае оно сохраняется в виде строки, например:<br>| |*HTTP прокси*<br*(HTTP proxy)*|Вы можете указать необходимый HTTP прокси, следуя формату: `[протокол://][имя пользователя[:пароль]@]proxy.example.com[:порт]`<br>Можно использовать опциональный префикс `протокол://`, чтобы указать альтернативные протоколы прокси (например: https, socks4, socks5; смотрите [документацию \[en\]](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html); поддержка префиксов протоколов добавлена в cURL 7.21.7). Если протокол не указан, прокси будет обрабатываться как HTTP прокси. Если вы укажете ошибочный протокол, подключение завершится неудачей и элемент данных перейдёт в неподдерживаемое состояние.<br>По умолчанию будет использоваться порт 1080.<br>Если этот параметр указан, прокси заменит переменные окружения, связанные с прокси — такие как http\_proxy, HTTPS\_PROXY. Если не указан, переменные окружения не будут заменены. Введённое значение передается «как есть», проверка корректности ввода не производится.<br>*Примечание*: Для HTTP прокси поддерживается только простая аутентификация.<br>Поддерживаемые макросы: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, пользовательские макросы, макросы низкоуровневого обнаружения.<br>Это поле задаёт опцию cURL [CURLOPT\_PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html) \[en\].| |*HTTP Аутентификация*<br>*(HTTP authentication)*|Тип аутентификации:<br>**Пусто (None)** — без использования аутентификации.<br>**Простая аутентификация (Basic)** — с использованием простой аутентификации.<br>**NTLM аутентификация (NTLM)** — с использованием NTLM ([Windows NT LAN Manager)](http://ru.wikipedia.org/wiki/NTLM) аутентификации.<br>**Kerberos** — с использованием Kerberos аутентификации. Смотрите также: [Настройка Kerberos с Zabbix](/manual/appendix/items/kerberos).<br>**Digest** — с использованием Digest аутентификации.<br>После выбора какой-либо метода аутентификации, будут доступны два дополнительных поля для ввода имени пользователя и пароля, в которых поддерживаются пользовательские макросы и макросы низкоуровневого обнаружения.<br>Это поле задаёт опцию cURL [CURLOPT\_HTTPAUTH](https://curl.haxx.se/libcurl/c/CURLOPT_HTTPAUTH.html) \[en\].| |*Проверка SSL узла*<br>*(SSL verify peer)*|Отметьте флажок для верификации SSL сертификата веб-сервера. Сертификат сервера будет автоматически взят из местоположения центра сертификации (CA) всей системы. Вы можете переопределить расположение CA файлов, воспользовавшись параметром конфигурации SSLCALocation на стороне Zabbix сервера или прокси.<br>Это поле задаёт опцию cURL [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) \[en\].| |*Проверка SSL хоста*<br>*(SSL verify host)*|Отметьте флажок для удостоверения, что поле *Common Name* или поле *Subject Alternate Name* сертификата веб-сервера совпадают.<br>Это поле задаёт опцию cURL [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) \[en\].| |*Файл SSL сертификата*<br>*(SSL certificate file)*|Имя файла SSL сертификата для аутентификации клиента. Файл сертификата должен быть в формате PEM^1^. Если файл сертификата также содержит и закрытый ключ (private key), оставьте поле Файл SSL ключа пустым. Если ключ зашифрован, укажите пароль в поле Пароль к SSL ключу. Папка, содержащая этот файл, указывается в параметре конфигурации SSLCertLocation Zabbix сервера или прокси.<br>Поддерживаемые макросы: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, пользовательские макросы, макросы низкоуровневого обнаружения.<br>Это поле задаёт опцию cURL [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) \[en\].| |*Файл SSL ключа*<br>*(SSL key file)*|Имя файла закрытого ключа SSL (private key), который используется для аутентификации клиента. Файл закрытого ключа должен быть в формате PEM^1^. Папка, содержащая этот файл, указывается в параметре конфигурации SSLKeyLocation Zabbix сервера или прокси.<br>Поддерживаемые макросы: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, пользовательские макросы, макросы низкоуровневого обнаружения.<br>Это поле задаёт опцию cURL [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) \[en\].| |*Пароль к SSL ключу*<br>*(SSL key password)*|Пароль к файлу закрытого ключа.<br>Поддерживаемые макросы: пользовательские макросы, макросы низкоуровневого обнаружения.<br>Это поле задаёт опцию cURL [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) \[en\].| |*Активировать трапы*<br>*(Enable trapping)*|При включении этой опции элемент данных будет работать также и как [траппер элемент данных](/manual/config/items/itemtypes/trapper) и будет принимать данные, которые отправляются на этот элемент данных при помощи Zabbix sender или с использованием протокола Zabbix sender.| |*Разрешённые хосты*<br>*(Allowed hosts)*|Доступно, только если выбрана опция *Активировать трапы*.<br>Список разделённых запятыми IP адресов, опционально в CIDR представлении, или DNS имён.<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 \[en\]](https://tools.ietf.org/html/rfc4291#section-2.5.5).<br><br>Пример: 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>В этом поле разрешены пробелы и [пользовательские макросы](/manual/config/macros/user_macros).<br>Макросы узлов сети: {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN} поддерживаются в этом поле.| ::: notetip Если поле *HTTP прокси* оставить пустым, можно воспользоваться другим способом указать HTTP прокси, для этого необходимо задать переменные окружения. Для HTTP проверок — укажите переменную окружения `http_proxy` для пользователя Zabbix сервера. Например:<br> `http_proxy=http://proxy_ip:proxy_port`. Для HTTPS проверок — укажите переменную окружения `HTTPS_PROXY`. Например:<br> `HTTPS_PROXY=http://proxy_ip:proxy_port`. Более подробная информация доступна при выполнении shell команды *\# man curl*. ::: ::: noteimportant \[1\] Zabbix поддерживает файлы сертификатов и закрытых ключей (private keys) только в формате 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 ::: #### 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. ::: #### Настройка Для настройки группы пользователей: - Перейдите в *Администрирование → Группы пользователей (Administration → User groups)* - Нажмите на *Создать группу пользователей (Create user group)* (или на имени группы для изменения существующей группы) - Измените в диалоге атрибуты группы Вкладка **Группа пользователей (User group)** содержит общие атрибуты группы:  Все обязательные поля ввода отмечены красной звёздочкой. |Параметр|Описание| |--|--------| |*Имя группы*<br>*(Group name)*|Уникальное имя группы.| |*Пользователи*<br>*(Users)*|Для добавления пользователей начните печатать имя существующего пользователя. Когда появится выпадающий список с подходящими именами пользователей, прокрутите этот список и выберите нужного пользователя.<br>Кроме того, вы можете нажать на кнопку *Выбрать (Select)* и выбрать пользователей во всплывающем окне.| |*Доступ к веб-интерфейсу*<br>*(Frontend access)*|Каким образом пользователи этой группы проходят аутентификацию.<br>**Системное по умолчанию (System default)** — использование метода аутентификации по умолчанию (задаётся [глобально](/manual/web_interface/frontend_sections/administration/authentication))<br>**Внутренний (Internal)** — использование внутренней аутентификации Zabbix (даже если LDAP аутентификация используется глобально).<br>Игнорируется, если глобально по умолчанию используется HTTP аутентификация.<br>**LDAP** — использование LDAP аутентификации (даже если внутренняя аутентификация используется глобально).<br>Игнорируется, если глобально по умолчанию используется HTTP аутентификация.<br>**Деактивировано (Disabled)** — доступ к веб-интерфейсу Zabbix для этой группы запрещён| |*Активировано*<br>*(Enabled)*|Состояние группы пользователей и членов группы:<br>*Отмечено* — группа пользователей и пользователи активированы<br>*Не отмечено* — группа пользователей и пользователи деактивированы| |*Режим отладки*<br>*(Debug mode)*|Отметьте эту опцию для активации [режима отладки](/manual/web_interface/debug_mode) для пользователей.| Вкладка **Права доступа (Permissions)** позволяет вам управлять доступом группы пользователей к данным групп узлов сети (и таким образом к узлам сети): {width="600"} Текущие права доступа к группам узлов сети отображаются в блоке *Права доступа (Permissions)*. Если текущие права доступа на группу узлов сети наследуются всеми вложенными группами узлов сети, это будет обозначено текстом «*включая подгруппы (including subgroups)*» в круглых скобках после имени группы узлов сети. Обратите внимание, что пользователь *Супер-администратор* может принудительно заставить вложенные группы узлов сети иметь тот же уровень доступов, что и родительская группа узлов сети; это может быть сделано в диалоге [настройки](/manual/config/hosts/host#создание-группы-узлов-сети) группы узлов сети. Вы можете изменить уровень доступа к группе узлов сети: - **Чтение-запись (Read-write)** — доступ на чтение-запись к группе узлов сети; - **Чтение (Read)** — доступ только на чтение к группе узлов сети; - **Запрещён (Deny)** — доступ к группе узлов сети запрещён; - **Нет (None)** — права доступа не заданы. Используйте поле выбора снизу, чтобы выбрать группы узлов сети и уровень доступа к ним. Это поле имеет функцию авто-дополнения — начните набирать, и в поле появится выпадающий список совпадающих групп узлов сети. Если вы желаете увидеть все группы узлов сети, нажмите на *Выбрать (Select)*. Если вы желаете включить вложенные группы узлов сети, отметьте опцию *Включая подгруппы (Include subgroups)*. Нажмите на  (Добавить), чтобы добавить выбранную группу узлов сети к списку прав доступа групп узлов сети. :::noteimportant Добавление родительской группы узлов сети с отмеченной опцией *Включая подгруппы (Include subgroups)* будет переопределять (и удалять из списка) ранее назначенные права доступа, относящиеся ко всем вложенным группам узлов сети. Добавление группы узлов сети с выбором *Нет (None)* в качестве прав доступа удалит группу узлов сети из списка, если группа узлов сети уже присутствует в этом списке. ::: Вкладка **Фильтр тегов (Tag filter)** позволяет вам задать права доступа группам пользователей на основании тегов, чтобы видеть проблемы, отфильтрованные по имени тега и его значению:  Чтобы выбрать группу узлов сети для применения фильтрации по тегам, нажмите на *Выбрать (Select)*, чтобы получить полный список существующих групп узлов сети, или начните вводить имя группы узлов сети, чтобы получить выпадающее меню с соответствующими группами. Если вы хотите применить фильтры тегов ко вложенным группам узлов сети, отметьте опцию *Включая подгруппы (Include subgroups)*. Фильтр тегов позволяет разграничить доступ к группе узлов сети от возможности просмотра проблем. Например, если администратору баз данных нужно видеть проблемы только по базе данных «MySQL», сначала необходимо создать группу пользователей для администраторов баз данных, затем указать имя тега, равное «Service», и значение тега, равное «MySQL».  Если имя тега «Service» задано, а поле значения оставлено пустым, тогда соответствующая группа пользователей будет видеть все проблемы с именем тега «Service» по выбранной группе узлов сети. Если оба поля имени тега и значения тега оставлены пустыми, но группа узлов сети выбрана, соответствующая группа пользователей увидит все проблемы по выбранной группе узлов сети. Убедитесь, что имя тега и значение этого тега указаны должным образом, в противном случае соответствующая группа пользователей вовсе не увидит проблемы. Давайте рассмотрим пример, когда пользователь является членом нескольких выбранных групп пользователей. В этом случае фильтрация для тегов будет использовать условие ИЛИ. | | | | | | | | |---|---|---|---|---|---|---| |**Группа пользователей A**|<|<|**Группа пользователей B**|<|<|**Видимый результат у пользователя (члена) обеих групп**| |*Фильтр тегов*|<|<|<|<|<|^| |*Группа узлов сети*|*Имя тега*|*Значение тега*|*Группа узлов сети*|*Имя тега*|*Значение тега*|^| |Шаблоны/Базы данных|Service|MySQL|Шаблоны/Базы данных|Service|Oracle|Видны проблемы Service: MySQL или Oracle| |Шаблоны/Базы данных|*пусто*|*пусто*|Шаблоны/Базы данных|Service|Oracle|Видны все проблемы| |*не выбрано*|*пусто*|*пусто*|Шаблоны/Базы данных|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\. На вкладке *Преобразование значений (Value mapping)* нажмите на *Добавить (Add)*, чтобы добавить новое преобразование, или нажмите на имя существующего преобразования, чтобы его модифицировать.  Параметры преобразования значений: |Параметр|<|Описание| |-|----------|----------------------------------------| |*Имя (Name)*|<|Уникальное имя набора преобразований значений.| |*Преобразования*<br>*(Mappings)*|<|Отдельные правила преобразования для преобразования числовых/строковых значений в строковые представления.<br><br>Сопоставление применяется в соответствии с порядком правил преобразования, которые можно переупорядочить перетаскиванием.| | |*Тип*<br>*(Type)*|Тип преобразования:<br>**равно** — будут преобразованы совпадающие значения<br>**больше чем или равно** — будут преобразованы равные или большие значения<br>**меньше чем или равно** — будут преобразованы равные или меньшие значения<br>**в диапазоне** — будут преобразованы значения в диапазоне; диапазон указывается в виде <число1>-<число2>, или <число>; поддерживаются несколько диапазонов (например: 1-10,101-110,201);<br>**регулярное выражение** — будут преобразованы значения, соответствующие [регулярному выражению](/manual/regular_expressions) (глобальные регулярные выражения не поддерживаются)<br>**по умолчанию** — будут преобразованы все оставшиеся значения, кроме тех, у которых имеются заданные преобразования.<br><br>В преобразованиях с учётом диапазона поддерживаются только числовые типы данных (типы преобразований *больше чем или равно*, *меньше чем или равно*, *в диапазоне*).| |^|*Значение*<br>*(Value)*|Входящее значение (в зависимости от типа преобразования, может также содержать диапазон или регулярное выражение).| |^|*Преобразование в*<br>*(Mapped to)*|Строковое представление (до 64 символов) для входящего значения.| Все обязательные поля ввода отмечены красной звёздочкой. Когда преобразование значений отображается в списке, видны только первые три преобразования, а три точки указывают на то, что имеется больше преобразований.  #### Configuration To configure custom alert scripts 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 file (e.g., notification.sh) that is located in the directory specified in the server [configuration file](/manual/appendix/config/zabbix_server) `AlertScriptsPath` parameter.| |*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 alert script 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)** содержит общие атрибуты способа оповещения:  Все обязательные поля ввода отмечены красной звёздочкой. Следующие параметры специфичны для способов оповещений на основе скриптов: |Параметр|Описание| |--|--------| |*Имя скрипта*<br>*(Script name)*|Введите имя файла скрипта (например, notification.sh), который расположен в директории, указанной в параметре `AlertScriptsPath` [файла конфигурации](/manual/appendix/config/zabbix_server) сервера.| |*Параметры скрипта*<br>*(Script parameters)*|Добавьте к скрипту параметры командной строки.<br>В параметрах скриптов поддерживаются [макросы](/manual/appendix/macros/supported_by_location) {ALERT.SENDTO}, {ALERT.SUBJECT} и {ALERT.MESSAGE}.<br>Индивидуальная настройка параметров скриптов поддерживается с Zabbix 3.0.| Смотрите также [общие параметры способов оповещений](/manual/config/notifications/media#общие-параметры) для получения подробной информации о настройке сообщений по умолчанию и опциях обработки оповещений. ::: notewarning Даже если скрипт оповещения не использует сообщения по умолчанию, необходимо задать шаблоны сообщений по типам операций, которые используются в скрипте, в противном случае оповещение не будет отправлено. ::: ::: noteimportant Поскольку с Zabbix 3.4.0 реализована параллельная обработка способов оповещения, важно отметить, что при наличии более одного способа оповещения с типом скрипт, эти скрипты могут обрабатываться процессами оповещения (alerter) параллельно. Общее количество процессов оповещения ограничено [параметром](/manual/appendix/config/zabbix_server) `StartAlerters`. ::: #### Configuration To configure e-mail as the media type: - Go to *Administration → Media types* - Click on *Create media type* (or click on *E-mail* in the list of pre-defined media types). 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 e-mail media type: |Parameter|Description| |--|--------| |*SMTP server*|Set an SMTP server to handle outgoing messages.| |*SMTP server port*|Set the SMTP server port to handle outgoing messages.<br>This option is supported *starting with Zabbix 3.0*.| |*SMTP helo*|Set a correct SMTP helo value, normally a domain name.| |*SMTP email*|The address entered here will be used as the **From** address for the messages sent.<br>Adding a sender display name (like "Zabbix\_info" in *Zabbix\_info <zabbix\@company.com>* in the screenshot above) with the actual e-mail address is supported since Zabbix 2.2 version.<br>There are some restrictions on display names in Zabbix emails in comparison to what is allowed by RFC 5322, as illustrated by examples:<br>Valid examples:<br>*zabbix\@company.com* (only email address, no need to use angle brackets)<br>*Zabbix\_info <zabbix\@company.com>* (display name and email address in angle brackets)<br>*∑Ω-monitoring <zabbix\@company.com>* (UTF-8 characters in display name)<br>Invalid examples:<br>*Zabbix HQ zabbix\@company.com* (display name present but no angle brackets around email address)<br>*"Zabbix\\@\\<H(comment)Q\\>" <zabbix\@company.com>* (although valid by RFC 5322, quoted pairs and comments are not supported in Zabbix emails)| |*Connection security*|Select the level of connection security:<br>**None** - do not use the [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html) option<br>**STARTTLS** - use the CURLOPT\_USE\_SSL option with CURLUSESSL\_ALL value<br>**SSL/TLS** - use of CURLOPT\_USE\_SSL is optional<br>This option is supported *starting with Zabbix 3.0*.| |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the SMTP server.<br>The value of "SSLCALocation" server configuration directive should be put into [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html) for certificate validation.<br>This sets cURL option [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).<br>This option is supported *starting with Zabbix 3.0*.| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the SMTP server certificate matches.<br>This sets cURL option [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).<br>This option is supported *starting with Zabbix 3.0*.| |*Authentication*|Select the level of authentication:<br>**None** - no cURL options are set<br>(since 3.4.2) **Username and password** - implies "AUTH=\*" leaving the choice of authentication mechanism to cURL<br>(until 3.4.2) **Normal password** - [CURLOPT\_LOGIN\_OPTIONS](http://curl.haxx.se/libcurl/c/CURLOPT_LOGIN_OPTIONS.html) is set to "AUTH=PLAIN"<br>This option is supported *starting with Zabbix 3.0*.| |*Username*|User name to use in authentication.<br>This sets the value of [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html).<br>This option is supported *starting with Zabbix 3.0*.<br>[User macros](/manual/appendix/macros/supported_by_location_user#other-locations) supported as of Zabbix 6.0.30.| |*Password*|Password to use in authentication.<br>This sets the value of [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html).<br>This option is supported *starting with Zabbix 3.0*.<br>[User macros](/manual/appendix/macros/supported_by_location_user#other-locations) supported as of Zabbix 6.0.30.| |*Message format*|Select message format:<br>**HTML** - send as HTML<br>**Plain text** - send as plain text| ::: noteimportant To enable SMTP authentication options, Zabbix server must be both compiled with the `--with-libcurl` [compilation](/manual/installation/install#configure_the_sources) option (with cURL 7.20.0 or higher) and use the `libcurl-full` packages during runtime. ::: See also [common media type parameters](/manual/config/notifications/media#common_parameters) for details on how to configure default messages and alert processing options. #### Настройка Для настройки e-mail как способа оповещений: - Перейдите в *Администрирование → Способы оповещений (Administration → Media types)* - Нажмите на *Создать способ оповещения (Create media type)* (или нажмите на *E-mail* в списке с уже добавленными способами оповещений). Вкладка **Способ оповещения (Media type)** содержит общие атрибуты способа оповещения:  Все обязательные поля ввода отмечены красной звёздочкой. Следующие поля специфичны для e-mail способов оповещений: |Параметр|Описание| |--|--------| |*SMTP сервер (SMTP server)*|Укажите SMTP сервер для обработки исходящих сообщений.| |*Порт SMTP сервера*<br>*(SMTP server port)*|Укажите номер порта SMTP сервера для обработки исходящих сообщений.<br>Эта опция поддерживается, *начиная с Zabbix 3.0*.| |*SMTP helo*|Укажите корректное значение SMTP helo, обычно имя домена.| |*SMTP email*|Адрес, указанный здесь, будет использован в адресе **От** в отправленных сообщениях.<br>Использование отображаемого имени отправителя (например как «Zabbix\_info» в *Zabbix\_info <zabbix\@company.com>* на снимке экрана выше) с фактическим e-mail адресом поддерживается с Zabbix 2.2.<br>Есть некоторые ограничения на отображаемые имена e-mail адресов в Zabbix по сравнению с тем, что допускается по RFC 5322, как иллюстрировано в примерах:<br>Корректные примеры:<br>*zabbix\@company.com* (только email адрес, нет нужды использовать угловые скобки)<br>*Zabbix\_info <zabbix\@company.com>* (отображаемое имя и email адрес в угловых скобках)<br>*∑Ω-monitoring <zabbix\@company.com>* (UTF-8 символы в отображаемом имени)<br>Ошибочные примеры:<br>*Zabbix HQ zabbix\@company.com* (отображаемое имя присутствует, но нет угловых скобок вокруг email адреса)<br>*"Zabbix\\@\\<H(comment)Q\\>" <zabbix\@company.com>* (хотя допустимо с точки зрения RFC 5322, парные кавычки и комментарии не поддерживаются в Zabbix email)| |*Безопасность подключения*<br>*(Connection security)*|Выберите уровень безопасности подключения:<br>**Нет (None)** — не использовать опцию [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html)<br>**STARTTLS** — использовать опцию CURLOPT\_USE\_SSL со значением CURLUSESSL\_ALL<br>**SSL/TLS** — использование CURLOPT\_USE\_SSL опционально<br>Эта опция поддерживается, *начиная с Zabbix 3.0*.| |*Проверка SSL узла*<br>*(SSL verify peer)*|Отметьте для верификации SSL сертификата SMTP сервера.<br>Для верификации сертификата значение параметра «SSLCALocation» конфигурации сервера должно быть помещено в [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html).<br>Этот параметр использует cURL опцию [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).<br>Эта опция поддерживается, *начиная с Zabbix 3.0*.| |*Проверка SSL хоста*<br>*(SSL verify host)*|Отметьте для удостоверения, что поле *Common Name* или поле *Subject Alternate Name* сертификата SMTP сервера совпадают.<br>Этот параметр использует cURL опцию [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).<br>Эта опция поддерживается, *начиная с Zabbix 3.0*.| |*Аутентификация*<br>*(Authentication)*|Выберите уровень аутентификации:<br>**Нет (None)** — опции cURL не указываются<br>(начиная с 3.4.2) **Имя пользователя и пароль (Username and password)** — означает «AUTH=\*», оставляя выбор механизма аутентификации библиотеке cURL<br>(до 3.4.2) **Нормальный пароль (Normal password)** — [CURLOPT\_LOGIN\_OPTIONS](http://curl.haxx.se/libcurl/c/CURLOPT_LOGIN_OPTIONS.html) задается значением «AUTH=PLAIN»<br>Эта опция поддерживается, *начиная с Zabbix 3.0*.| |*Имя пользователя*<br>*(Username)*|Имя пользователя для использования в аутентификации.<br>Этот параметр использует cURL опцию [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html).<br>Эта опция поддерживается, *начиная с Zabbix 3.0*.<br>[Пользовательские макросы](/manual/appendix/macros/supported_by_location_user#другие-места) поддерживаются с версии Zabbix 6.0.30.| |*Пароль*<br>*(Password)*|Пароль для использования в аутентификации.<br>Этот параметр использует cURL опцию [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html).<br>Эта опция поддерживается, *начиная с Zabbix 3.0*.<br>[Пользовательские макросы](/manual/appendix/macros/supported_by_location_user#другие-места) поддерживаются с версии Zabbix 6.0.30.| |*Формат сообщения*<br>*(Message format)*|Выберите формат сообщения:<br>**HTML** — отсылать как HTML<br>**Простой текст (Plain text)** — отсылать как простой текст| ::: noteimportant Чтобы сделать опции SMTP аутентификации доступными, Zabbix сервер должен быть скомпилирован с опцией [компиляции](/manual/installation/install#сконфигурируйте-исходный-код) --with-libcurl (с cURL 7.20.0 или выше) и использовать пакеты `libcurl-full` во время выполнения. ::: Смотрите также [общие параметры способов оповещений](/manual/config/notifications/media#общие-параметры) для получения подробной информации о настройке сообщений по умолчанию и опциях обработки оповещений. #### 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. #### Настройка Для настройки глобальных правил корреляции событий: - Перейдите в *Настройка* → *Корреляция событий* - Нажмите на *Создать корреляцию* справа (или на имя корреляции, чтобы изменить уже имеющееся правило) - В диалоге введите параметры правила корреляции {width="600"} Все обязательные поля ввода отмечены красной звёздочкой. |Параметр|Описание| |--|--------| |*Имя (Name)*|Уникальное имя правила корреляции.| |*Тип вычисления*<br>*(Type of calculation)*|Для вычисления условий доступны следующие опции:<br>**И (And)** — должны быть выполнены все условия<br>**Или (Or)** — достаточно выполнения одного условия<br>**И/Или (And/Or)** — И с разными типами условий и ИЛИ с одинаковым типом условий<br>**Пользовательское выражение (Custom expression)** — введённая пользователем формула вычисления для оценки условий действия. Она должна включать в себя все условия (представленные в виде прописных букв A, B, C, …) и может включать пробелы, символы табуляции, скобки ( ), **and** (с учётом регистра), **or** (с учётом регистра), **not** (с учётом регистра).| |*Условия*<br>*(Conditions)*|Список условий. Смотрите ниже для получения более подробных сведений по настройке условий.| |*Описание*<br>*(Description)*|Описание правила корреляции.| |*Операции*<br>*(Operations)*|Отметьте операции, выполняемые при успешной корреляции события. Доступны следующие операции:<br>**Закрыть старые события (Close old events)** — закрыть старые события при появлении нового события. Всегда добавляйте условие на основе старого события при использовании операции *Закрыть старые события*, или будут закрыты все существующие проблемы.<br>**Закрыть новое событие (Close new event)** — закрыть новое событие при его появлении| |*Активировано*<br>*(Enabled)*|Если вы отметите этот параметр, правило корреляции будет активировано.| Чтобы настроить детали нового условия, нажмите на  (Добавить) в блоке Условия. Откроется всплывающее окно, где вы сможете отредактировать детали условия.  |Параметр|Описание| |--|--------| |*Новое условие*<br>*(New condition)*|Выберите условие для корреляции событий.<br>*Обратите внимание*, если условие на старое событие не указано, все старые события могут быть сопоставлены и затем закрыты. Точно так же, если условие на новое событие не указано, все новые события могут быть сопоставлены и затем закрыты.<br>Доступны следующие условия:<br>**Имя тега старого события (Old event tag)** — тег старого события для поиска совпадения<br>**Имя тега нового события (New event tag)** — тег нового события для поиска совпадения<br>**Группа узлов сети нового события (New event host group)** — группа узлов сети нового события для поиска совпадения<br>**Пара тегов событий (Event tag pair)** — новый тег событий и старый тег событий для поиска совпадений. В этом случае будет совпадение, если совпадают **значения** тегов в обоих событиях. *Имена* тегов не обязаны совпадать.<br>Эта опция может быть полезна для сопоставления значений в реальном времени, которые могут быть неизвестны в процессе настройки (смотрите также [Пример 1](/manual/config/event_correlation/global#примеры))<br>**Значение тега старого события (Old event tag value)** — имя и значение тега старого события для поиска совпадения с использованием следующих операторов:<br>*равно (equals)* — имеет значение тега старого события<br>*не равно (does not equal)* — не имеет значение тега старого события<br>*содержит (contains)* — имеет соответствующую строку в значении тега старого события<br>*не содержит (does not contain)* — не имеет соответствующую строку в значении тега старого события<br>**Значение тега нового события (New event tag value)** — имя и значение тега нового события для поиска совпадения с использованием следующих операторов:<br>*равно (equals)* — имеет значение тега нового события<br>*не равно (does not equal)* — не имеет значение тега нового события<br>*содержит (contains)* — имеет соответствующую строку в значении тега нового события<br>*не содержит (does not contain)* — не имеет соответствующую строку в значении тега нового события| ::: notewarning Посколько возможна некорректная настройка, когда аналогичные теги событий могут быть созданы по **не связанным** проблемам, пожалуйста, ознакомьтесь со случаями, которые описаны ниже! ::: - Фактические теги и значения тегов становятся видны только при срабатывании триггера. Если используемое регулярное выражение ошибочно, оно автоматически заменится на строку \*НЕИЗВЕСТНО\*. Если изначальное событие о проблеме с \*НЕИЗВЕСТНО\* пропущено, могут появиться последующие события 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.| #### Настройка Для настройки выберите *Журнал действий (Action log)* в качестве типа:  В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете установить следующие специфичные опции: | | | |--|--------| |*Сортировка записей по*<br>*(Sort entries by)*|Сортировка записей по:<br>**Время** (по убыванию или по возрастанию)<br>**Тип** (по убыванию или по возрастанию)<br>**Состояние** (по убыванию или по возрастанию)<br>**Получатель** (по убыванию или по возрастанию).| |*Количество строк*<br>*(Show lines)*|Задаёт, сколько строк из журнала действий будет отображаться в виджете.| #### 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.| #### Настройка Для настройки выберите *Часы (Clock)* в качестве типа:  В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: | | | |--|--------| |*Тип времени*<br>*(Time type)*|Выберите время местное, сервера или конкретного узла сети.<br>Время сервера будет идентично часовому поясу, выставленному глобально или для пользователя Zabbix.| |*Элемент данных*<br>*(Item)*|Выберите элемент данных для отображения времени. Для отображения времени узла сети, используйте [элемент данных](/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.| #### Настройка Для настройки выберите *Обзор данных (Data overview)* в качестве типа:  В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: | | | |--|--------| |*Группы узлов сети*<br>*(Host groups)*|Выберите группы узлов сети. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню. Прокрутите список, чтобы выбрать необходимую. Нажмите на 'х', чтобы удалить выбранную.| |*Узлы сети*<br>*(Hosts)*|Выберите узлы сети. Это поле с функцией автодополнения; таким образом, после начала ввода имени будет автоматически предложен список совпадающих узлов сети в выпадающем меню. Прокрутите список, чтобы выбрать нужный. Нажмите на 'х', чтобы удалить выбранный.| |*Теги*<br>*(Tags)*|Укажите теги, чтобы ограничить количество элементов данных, отображаемых в виджете. Можно как включать, так и исключать определённые теги и значения тегов. Можно задать несколько условий. Имена тегов всегда сравниваются с учётом регистра.<br>Для каждого условия доступно несколько операторов:<br>**Существует** - включить указанные имена тегов<br>**Равно** - включить указанные имена тегов и их значения (с учётом регистра)<br>**Содержит** - включить указанные имена тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>**Не существует** - исключить указанные имена тегов<br>**Не равно** - исключить указанные имена тегов и их значения (с учётом регистра)<br>**Не содержит** - исключить имена указанных тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>Для условий имеется два типа вычислений:<br>**И/Или** - все условия должны соблюдаться, условия с одинаковыми именами тегов будут сгруппированы с условием Или<br>**Или** - достаточно соблюдения одного условия| |*Подавленные проблемы*<br>*(Show suppressed problems)*|Отметьте, чтобы отображались проблемы, которые в противном случае были бы подавлены (не показаны) по причине обслуживания узлов сети.| |*Расположение узлов сети*<br>*(Hosts location)*|Выберите расположение узлов сети - слева или сверху.| #### 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 #### Настройка Для настройки выберите *График (Graph)* в качестве типа: {width="600"} Вкладка **Набор данных** позволяет добавлять наборы данных и определять их графическое представление: | | | | |-|----------|----------------------------------------| |*Набор данных*<br>*(Data set)*|<|Выбрать узлы сети и элементы данных для отображения на графике. В качестве альтернативного варианта, можно указать шаблоны узлов сети и элементов данных. Можно использовать шаблоны с подстановочными знаками (например, `*` вернёт результат, соответствующий нулю или более символов). Чтобы использовать шаблоны с подстановочными знаками, просто введите строку вручную и нажмите *Enter*. Во время ввода текста обратите внимание, как все совпадающие узлы сети отображаются в выпадающем списке.<br>На графике может отображаться до 50 элементов данных.<br>Поля шаблона узла сети и шаблона элемента данных являются обязательными.<br>Символ подстановочного знака интерпретируется всегда, поэтому невозможно добавить, скажем, элемент данных с именем «item\*» отдельно, если имеются другие совпадающие элементы данных (например, item2 и item3).| | |*Основной цвет*<br>*(Base color)*|Настроить основной цвет — либо с помощью палитры цветов, либо вручную. Основной цвет используется для расчёта различных цветов для каждого элемента данных одного набора данных. Поле ввода базового цвета является обязательным.| |^|*Отрисовка*<br>*(Draw)*|Выбрать тип отрисовки метрики. Возможными типами отрисовки являются *Линия* (выставляется по умолчанию), *Точки*, *Лестница* или *Столбцы*.<br>Обратите внимание, что если на графике линии/лестницы имеется только одна точка данных, то она будет изображена как точка независимо от типа отрисовки. Размер точки рассчитывается исходя из ширины линии, но он не может быть менее 3 пикселей, даже если ширина линии меньше.| |^|*Ширина*<br>*(Width)*|Задать ширину линии. Эта опция доступна, когда выбран тип отрисовки *Линия* или *Лестница*.| |^|*Размер точки*<br>*(Point size)*|Задать размер точки. Эта опция доступна, когда выбран тип отрисовки *Точки*.| |^|*Прозрачность*<br>*(Transparency)*|Задать уровень прозрачности.| |^|*Заполнение*<br>*(Fill)*|Задать уровень заливки. Эта опция доступна, когда выбран тип отрисовки *Линия* или *Лестница*.| |^|*Отсутствующие данные*<br>*(Missing data)*|Выбор варианта отображения отсутствующих данных:<br>**Нет** — зазор остаётся незаполненным<br>**Соединение** — соединяются два крайних значения<br>**В виде 0** — отсутствующие данные отображаются как имеющие нулевые значения<br>Неприменимо для типов отрисовки *Точки* и *Столбцы*.| |^|*Ось Y*<br>*(Y-axis)*|Выбрать сторону графика для отображения оси Y.| |^|*Сдвиг по времени*<br>*(Time shift)*|Указать сдвиг по времени, если требуется. В этом поле можно использовать [суффиксы времени](/manual/appendix/suffixes#суффиксы-времени). Допустимы отрицательные значения.| |^|*Функции агрегации*<br>*(Aggregation function)*|Указать, какую функцию агрегации использовать:<br>**min** — отображать наименьшее значение<br>**max** — отображать наибольшее значение<br>**avg** — отображать среднее значение<br>**sum** — отображать сумму значений<br>**count** — отображать количество значений<br>**first** — отображать первое значение<br>**last** — отображать последнее значение<br>**none** — отображать все значения (без агрегации)<br>Агрегация позволяет отображать агрегированное значение за выбранный интервал (5 минут, час, сутки) вместо всех значений. Смотрите также: [Агрегирование на графиках](/manual/config/visualization/graphs/aggregate).<br>Эта опция поддерживается с версии Zabbix 4.4.| |^|*Интервал агрегации*<br>*(Aggregation interval)*|Указать интервал для агрегированных значений. В этом поле можно использовать [суффиксы времени](/manual/appendix/suffixes#суффиксы-времени). Числовое значение без суффикса будет рассматриваться как секунды.<br>Эта опция поддерживается с версии Zabbix 4.4.| |^|*Агрегация*<br>*(Aggregate)*|Указать, нужно ли агрегировать:<br>**Каждый элемент данных** — каждый элемент данных в наборе данных будет агрегирован и отображён по отдельности.<br>**Набор данных** — все элементы набора данных будут агрегированы и отображены как одно значение.<br>Эта опция поддерживается с версии Zabbix 4.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. #### Настройка Для настройки выберите *График (классический) (Graph (classic))* в качестве типа:  В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете установить следующие специфичные опции: | | | |--|--------| |*Источник*<br>*(Source)*|Выберите тип графика:<br>**График** — пользовательский график<br>**Простой график** — простой график| |*График*<br>*(Graph)*|Выберите пользовательский график для отображения.<br>Эта опция доступна, если в поле *Источник* выбрано «График».| |*Элемент данных*<br>*(Item)*|Выберите элемент данных для отображения на простом графике.<br>Эта опция доступна, если в поле *Источник* выбрано «Простой график».| |*Легенда*<br>*(Show legend)*|Снимите флажок в этом поле, чтобы скрыть легенду на графике (по умолчанию флажок отмечен).| |*[Динамический элемент](/manual/web_interface/frontend_sections/monitoring/dashboard#динамические-виджеты)*<br>*(Dynamic item)*|Задаёт, будет ли график отображать различные данные в зависимости от выбранного узла сети.| Информация, отображаемая на виджете классического графика, может быть загружена в виде изображения в формате .png с помощью [меню виджетов](/manual/web_interface/frontend_sections/monitoring/dashboard#меню-виджетов):  Снимок экрана виджета будет сохранён в папке Загрузки (Downloads). #### 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.  #### Настройка Для настройки выберите *Прототип графиков (Graph prototype)* в качестве типа:  В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете установить следующие специфичные опции: | | | |--|--------| |*Источник*<br>*(Source)*|Выберите источник: либо **Прототип графиков**, либо **Прототип простого графика**.| |*Прототип графиков*<br>*(Graph prototype)*|Выберите прототип графика для показа графиков, обнаруженных при помощи данного прототипа.<br>Эта опция доступна, если в поле *Источник* выбрано «Прототип графиков».| |*Прототип элемента данных*<br>*(Item prototype)*|Выберите прототип элемента данных для показа простых графиков на основе элементов данных, обнаруженных при помощи данного прототипа.<br>Эта опция доступна, если в поле *Источник* выбрано «Прототип простого графика».| |*Легенда*<br>*(Show legend)*|Отметьте флажок в этом поле, чтобы показать легенду на графике (по умолчанию флажок отмечен).| |*[Динамический элемент](/manual/web_interface/frontend_sections/monitoring/dashboard#динамические-виджеты)*<br>*(Dynamic item)*|Задаёт, будет ли график отображать различные данные в зависимости от выбранного узла сети.| |*Колонки*<br>*(Columns)*|Введите количество столбцов графиков для отображения в виджете прототипа графиков.| |*Строк*<br>*(Rows)*|Введите количество строк графиков для отображения в виджете прототипа графиков.| Хотя настройки *Колонки* и *Строк* позволяют разместить более одного графика в виджете, обнаруженных графиков всё же может быть больше, чем колонок/строк в виджете. В этом случае в виджете становится доступным постраничное отображение и всплывающий заголовок позволяет переключать страницы при помощи стрелок влево и вправо.  #### 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.| #### Настройка Для настройки выберите *Доступность узла сети (Host availability)* в качестве типа:  В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете установить следующие специфичные опции: | | | |--|--------| |*Группы узлов сети*<br>*(Host groups)*|Выберите группу(-ы) узлов сети. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню. Прокрутите список, чтобы выбрать необходимую. Нажмите на 'х', чтобы удалить выбранную.| |*Типы интерфейсов*<br>*(Interface type)*|Выберите, для каких интерфейсов узлов сети вы хотите видеть данные о доступности.<br>Если ничего не выбрано, то по умолчанию отображается доступность всех интерфейсов.| |*Размещение*<br>*(Layout)*|Выберите горизонтальное отображение (столбцы) или вертикальное отображение (строки).| |*Узлы сети в обслуживании*<br>*(Show hosts in maintenance)*|Включать ли в статистику узлы сети в состоянии обслуживания.| #### 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. | #### Настройка Для настройки, выберите *Значение элемента данных (Item value)* в качестве типа виджета:  В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: | | | |--|--------| |_**Элемент данных (Item)**_ |Выберите элемент данных. | |_**Показать (Show)**_ |Отметьте флажок для показа соответствующего элемента (описание, значение, время, индикатор изменений). Снимите флажок, чтобы скрыть.<br>Должен быть выбран хотя бы один элемент. | |_**Расширенная настройка (Advanced configuration)**_ |Отметьте флажок для показа опций [расширенной настройки](#расширенная-настройка).| |_**[Динамический элемент](/manual/web_interface/frontend_sections/monitoring/dashboard#динамические-виджеты) (Dynamic item)**_ |Отметьте флажок для показа различных значений в зависимости от выбранного узла сети.| #### Configuration To configure, select *Map* 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: | | | |--|--------| |*Source type*|Select to display:<br>**Map** - network map;<br>**Map navigation tree** - one of the maps in the selected map navigation tree.| |*Map*|Select the map to display.<br>This field is auto-complete so starting to type the name of a map will offer a dropdown of matching maps.<br>This option is available if 'Map' is selected as *Source type*.| |*Filter*|Select the map navigation tree to display the maps of.<br>This option is available if 'Map navigation tree' is selected as *Source type*.| #### Настройка Для настройки выберите *Карта сети (Map)* в качестве типа: {width="600"} В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: | | | |--|--------| |*Тип источника (Source type)*|Выберите для отображения:<br>**Карта** — карта сети;<br>**Дерево навигации карт сетей** — одна из карт в выбранном дереве навигации по карте.| |*Карта сети (Map)*|Выберите карту для отображения.<br>Это поле с функцией автодополнения; таким образом, после начала ввода имени карты будет автоматически предложен список совпадающих карт сети в выпадающем меню.<br>Эта опция доступна, если в поле *Тип источника* выбрано «Карта».| |*Фильтр (Filter)*|Выберите дерево навигации карт сетей для отображения его карт.<br>Эта опция доступна, если в поле *Тип источника* выбрано «Дерево навигации карт сетей».| #### 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.| #### Настройка Для настройки выберите *Дерево навигации карт сетей (Map navigation tree)* в качестве типа: {width="600"} В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: | | | |--|--------| |*Отображать недоступные карты*<br>*(Show unavailable maps)*|Отметьте этот флажок для отображения карт, на которые у пользователя нет прав на чтение.<br>Недоступные карты в дереве навигации будут отображаться серым значком.<br>Обратите внимание что если этот флажок отмечен, доступные [карты нижнего уровня](/manual/config/visualization/maps/map#добавление-элементов) отображаются, даже если карта вышестоящего уровня недоступна. Если флажок снят, доступные карты нижних уровней при недоступности карт вышестоящих уровней вообще не будут отображаться.<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.| #### Настройка Для настройки выберите *Простой текст (Plain text)* в качестве типа:  В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: | | | |--|--------| |*Элементы данных*<br>*(Items)*|Выберите элементы данных.| |*Размещение элементов данных*<br>*(Items location)*|Выберите расположение выбранных элементов данных для отображения в виджете.| |*Количество строк*<br>*(Show lines)*|Укажите, сколько строк последних данных будет отображаться в виджете.| |*Показывать текст в виде HTML*<br>*(Show text as HTML)*|Выставьте флажок для отображения текста в формате HTML.| |*[Динамические элементы данных](/manual/web_interface/frontend_sections/monitoring/dashboard#динамические-виджеты)*<br>*(Dynamic item)*|Выставьте флажок для отображения различных данных в зависимости от выбранного узла сети.| #### Configuration To configure, select *Problem hosts* 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: | | | |--|--------| |*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 problem severities to filter problems to be displayed in the widget.<br>If no severities are marked, all problems will be displayed.| |*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.| #### Настройка Для настройки выберите *Узлы сети с проблемами (Problem hosts)* в качестве типа: {width="600"} В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: |Параметр|Описание| |--|--------| |*Группы узлов сети*<br>*(Host groups)*|Введите группы узлов сети для отображения в виджете. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню.<br>При указании родительской группы узлов сети неявно выбираются все вложенные группы.<br>В виджете будут отображаться данные с узлов сети из этих групп. Если не указано никаких групп, то будут отображаться все группы узлов сети.| |*Исключить группы узлов сети*<br>*(Exclude host groups)*|Введите группы узлов сети, которые нужно скрыть из виджета. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню.<br>При указании родительской группы узлов сети неявно выбираются все вложенные группы.<br>Данные узлов сети из этих групп не будут отображаться в виджете. Например, узлы сети 001, 002, 003 могут быть в группе «Group A», а узлы сети 002, 003 — также и в группе «Group B». Если мы выберем *показывать* «Group A» и в то же время *исключить* «Group B», то на Панели будут отображаться только данные с узла сети 001.| |*Узлы сети*<br>*(Hosts)*|Введите узлы сети для отображения в виджете. Это поле с функцией автодополнения; таким образом, после начала ввода имени будет автоматически предложен список совпадающих узлов сети в выпадающем меню.<br>Если не введено никаких узлов сети, будут отображаться все узлы сети.| |*Проблема*<br>*(Problem)*|Вы можете ограничить количество отображаемых узлов сети с проблемами по имени проблемы. Если вы введёте здесь строку, то будут отображаться только узлы сети с такими проблемами, имена которых содержат введённую строку. Макросы не раскрываются.| |*Важность*<br>*(Severity)*|Отметьте важности проблем, чтобы отфильтровать те из них, которые будут отображаться в виджете.<br>Если не отмечено никаких важностей, будут отображены все проблемы.| |*Теги*<br>*(Tags)*|Укажите теги проблем, чтобы ограничить количество проблем, отображаемых в виджете. Можно как включать, так и исключать определённые теги и значения тегов. Можно указать несколько условий. Поиск соответствия имён тегов всегда чувствителен к регистру.<br>По каждому условию доступно несколько операторов:<br>**Существует** — включить указанные имена тегов<br>**Равно** — включить указанные имена тегов и их значения (с учётом регистра)<br>**Содержит** — включить указанные имена тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>**Не существует** — исключить указанные имена тегов<br>**Не равно** — исключить указанные имена тегов и их значения (с учётом регистра)<br>**Не содержит** — исключить имена указанных тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>Для условий имеется два типа вычислений:<br>**И/Или** — все условия должны соблюдаться, условия с одинаковыми именами тегов будут сгруппированы с условием Или<br>**Или** — достаточно соблюдения одного условия| |*Подавленные проблемы*<br>*(Show suppressed problems)*|Отметьте флажок для отображения проблем, которые в противном случае могут быть подавлены (не показаны) по причине режима обслуживания узла сети.| |*Скрыть группы без проблем*<br>*(Hide groups without problems)*|Отметьте опцию *Скрыть группы без проблем*, чтобы скрыть в виджете данные от групп узлов сети, в которых проблемы отсутствуют.| |*Отображение проблем*<br>*(Problem display)*|Отображать количество проблем как:<br>**Все (All)** — будет отображаться общее количество проблем<br>**Раздельно (Separated)** — количество неподтвержденных проблем будет отображаться отдельным числом от общего количества проблем<br>**Только неподтверждённые (Unacknowledged only)** — будет отображаться только количество неподтверждённых проблем.| #### Configuration To configure, select *Problems* as type:  You can limit how many problems are displayed in the widget in various ways - by problem status, problem name, severity, host group, host, event tag, acknowledgment status, etc. | | | |--|--------| |*Show*|Filter by problem status:<br>**Recent problems** - unresolved and recently resolved problems are displayed (default)<br>**Problems** - unresolved problems are displayed<br>**History** - history of all events is displayed| |*Host groups*|Enter host groups to display problems of 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>Problems from these host groups will be displayed in the widget. If no host groups are entered, problems from all host groups will be displayed.| |*Exclude host groups*|Enter host groups to hide problems of 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>Problems 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 problems from host 001 will be displayed in the widget.| |*Hosts*|Enter hosts to display problems of 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, problems of all hosts will be displayed.| |*Problem*|You can limit the number of problems displayed by their name. If you enter a string here, only those problems whose name contains the entered string will be displayed. Macros are not expanded.| |*Severity*|Mark problem severities to filter problems to be displayed in the widget.<br>If no severities are marked, all problems will be displayed.| |*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<br>When filtered, the tags specified here will be displayed first with the problem, unless overridden by the *Tag display priority* (see below) list.| |*Show tags*|Select the number of displayed tags:<br>**None** - no *Tags* column in *Monitoring → Problems*<br>**1** - *Tags* column contains one tag<br>**2** - *Tags* column contains two tags<br>**3** - *Tags* column contains three tags<br>To see all tags for the problem roll your mouse over the three dots icon.| |*Tag name*|Select tag name display mode:<br>**Full** - tag names and values are displayed in full<br>**Shortened** - tag names are shortened to 3 symbols; tag values are displayed in full<br>**None** - only tag values are displayed; no names| |*Tag display priority*|Enter tag display priority for a problem, as a comma-separated list of tags (for example: `Services,Applications,Application`). Tag names only should be used, no values. The tags of this list will always be displayed first, overriding the natural ordering by alphabet.| |*Show operational data*|Select the mode for displaying [operational data](/manual/web_interface/frontend_sections/monitoring/problems#operational_data_of_problems):<br>**None** - no operational data is displayed<br>**Separately** - operational data is displayed in a separate column<br>**With problem name** - append operational data to the problem name, using parentheses for the operational data| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*Show unacknowledged only*|Mark the checkbox to display unacknowledged problems only.| |*Sort entries by*|Sort entries by:<br>**Time** (descending or ascending)<br>**Severity** (descending or ascending)<br>**Problem name** (descending or ascending)<br>**Host** (descending or ascending).| |*Show timeline*|Mark the checkbox to display a visual timeline.| |*Show lines*|Specify the number of problem lines to display.| #### Настройка Для настройки выберите *Проблемы (Problems)* в качестве типа:  Вы можете ограничить количество отображаемых в этом виджете проблем разнообразными способами — по состоянию проблем, имени проблем, важности, группам узлов сети, узлам сети, тегам событий, состоянию подтверждений и т.д. |Параметр|Описание| |--|--------| |*Показать*<br>*(Show)*|Фильтрация по состоянию проблем:<br>**Недавние проблемы (Recent problems)** — отображение нерешённых и недавно решённых проблем (по умолчанию)<br>**Проблемы (Problems)** — отображение нерешённых проблем<br>**История (History)** — отображение истории всех событий| |*Группы узлов сети*<br>*(Host groups)*|Введите группы узлов сети для отображения их проблем в виджете. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню.<br>При указании родительской группы узлов сети неявно выбираются все вложенные группы.<br>В виджете будут отображаться проблемы с узлов сети из этих групп. Если не указано никаких групп, то будут отображаться проблемы со всех групп узлов сети.| |*Исключить группы узлов сети*<br>*(Exclude host groups)*|Введите группы узлов сети, которые нужно скрыть из виджета. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню.<br>При указании родительской группы узлов сети неявно выбираются все вложенные группы.<br>Проблемы с узлов сети из этих групп не будут отображаться в виджете. Например, узлы сети 001, 002, 003 могут быть в группе «Group A», а узлы сети 002, 003 — также и в группе «Group B». Если мы выберем *показывать* «Group A» и в то же время *исключить* «Group B», то в виджете будут отображаться только проблемы с узла сети 001.| |*Узлы сети*<br>*(Hosts)*|Введите узлы сети для отображения их проблем в виджете. Это поле с функцией автодополнения; таким образом, после начала ввода имени будет автоматически предложен список совпадающих узлов сети в выпадающем меню.<br>Если не введено никаких узлов сети, будут отображаться проблемы со всех узлов сети.| |*Проблема*<br>*(Problem)*|Вы можете ограничить количество отображаемых проблем по их имени. Если вы введёте здесь строку, то будут отображаться только те проблемы, имена которых содержат введённую строку. Макросы не раскрываются.| |*Важность*<br>*(Severity)*|Отметьте важности проблем, чтобы отфильтровать те из них, которые будут отображаться в виджете.<br>Если никакие важности не отмечены, будут отображены все проблемы.| |*Теги*<br>*(Tags)*|Укажите теги проблем, чтобы ограничить количество проблем, отображаемых в виджете. Можно как включать, так и исключать определённые теги и значения тегов. Можно указать несколько условий. Поиск соответствия имён тегов всегда чувствителен к регистру.<br>По каждому условию доступно несколько операторов:<br>**Существует** — включить указанные имена тегов<br>**Равно** — включить указанные имена тегов и их значения (с учётом регистра)<br>**Содержит** — включить указанные имена тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>**Не существует** — исключить указанные имена тегов<br>**Не равно** — исключить указанные имена тегов и их значения (с учётом регистра)<br>**Не содержит** — исключить имена указанных тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>Для условий имеется два типа вычислений:<br>**И/Или** — все условия должны соблюдаться, условия с одинаковыми именами тегов будут сгруппированы с условием Или<br>**Или** — достаточно соблюдения одного условия<br>При фильтрации указанные здесь теги будут отображены первыми вместе с проблемой, если только не переопределены списком *Приоритет отображения тегов* (см. ниже).| |*Отображать теги*<br>*(Show tags)*|Выбор количества отображаемых тегов:<br>**Нет (None)** — колонка *Теги* отсутствует в *Мониторинг → Проблемы*<br>**1** — колонка *Теги* содержит один тег<br>**2** — колонка *Теги* содержит два тега<br>**3** — колонка *Теги* содержит три тега<br>Чтобы увидеть все теги по проблеме, наведите курсор мыши на иконку с тремя точками.| |*Имя тега*<br>*(Tag name)*|Выберите режим отображения имени тега:<br>**Полное (Full)** — имена тегов и их значения отображаются полностью<br>**Сокращённое** — имена тегов сокращены до 3 символов; значения тегов отображаются полностью<br>**Нет** — отображаются только значения тегов; без имён| |*Приоритет отображения тегов*<br>*(Tag display priority)*|Введите приоритет отображения тегов для проблем, в виде разделённого запятыми списка тегов (например: `Сервисы,Приложения,Приложение`). Необходимо использовать только имена тегов, без значений. Теги из этого списка всегда отображаются первыми, переопределяя естественную сортировку по алфавиту.| |*Оперативные данные*<br>*(Show operational data)*|Выберите режим отображения [оперативных данных](/manual/web_interface/frontend_sections/monitoring/problems#оперативные-данные-проблем):<br>**Нет (None)** — не показывать оперативные данные<br>**Раздельно (Separately)** — показывать оперативные данные в отдельной колонке<br>**С именем проблемы (With problem name)** — оперативные данные будут указаны в скобках после имени проблемы| |*Подавленные проблемы*<br>*(Show suppressed problems)*|Отметьте флажок для отображения проблем, которые в противном случае могут быть подавлены (не показаны) по причине режима обслуживания узла сети.| |*Только неподтверждённые*<br>*(Show unacknowledged only)*|Отметьте этот флажок для отображения только неподтверждённых проблем.| |*Сортировка записей по*<br>*(Sort entries by)*|Сортировка записей по:<br>**Время (Time)** (по убыванию или по возрастанию)<br>**Важность (Severity)** (по убыванию или по возрастанию)<br>**Проблема (Problem name)** (по убыванию или по возрастанию)<br>**Узел сети (Host)** (по убыванию или по возрастанию).| |*Шкала времени*<br>*(Show timeline)*|Отметьте флажок для отображения визуальной шкалы времени.| |*Количество строк*<br>*(Show lines)*|Укажите количество отображаемых строк проблем.| #### Configuration To configure, select *Problems by severity* 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: | | | |--|--------| |*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 problem severities to filter problems to be displayed in the widget.<br>If no severities are marked, all problems will be displayed.| |*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*|Select the show option:<br>**Host groups** - display problems per host group<br>**Totals** - display a problem total for all selected host groups in colored blocks corresponding to the problem severity.| |*Layout*|Select the layout option:<br>**Horizontal** - colored blocks of totals will be displayed horizontally<br>**Vertical** - colored blocks of totals will be displayed vertically<br>This field is available for editing if 'Totals' is selected as the *Show* option.| |*Show operational data*|Display operational data (see description of *[Operational data](/manual/web_interface/frontend_sections/monitoring/problems#operational-data-of-problems)* in *Monitoring* > *Problems*) as:<br>**None** - operational data will not be displayed<br>**Separately** - operational data will be displayed as a separate line<br>**With problem name** - operational data will be displayed together with the problem name.| |*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.| |*Show timeline*|Mark the checkbox to display a visual timeline.| #### Настройка Для настройки выберите *Проблемы по важности (Problems by severity)* в качестве типа: {width="600"} В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: |Параметр|Описание| |--|--------| |*Группы узлов сети*<br>*(Host groups)*|Введите группы узлов сети для отображения в виджете. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню.<br>При указании родительской группы узлов сети неявно выбираются все вложенные группы.<br>В виджете будут отображаться данные с узлов сети из этих групп. Если не указано никаких групп, то будут отображаться всх группы узлов сети.| |*Исключить группы узлов сети*<br>*(Exclude host groups)*|Введите группы узлов сети, которые нужно скрыть из виджета. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню.<br>При указании родительской группы узлов сети неявно выбираются все вложенные группы.<br>Данные с узлов сети из этих групп не будут отображаться в виджете. Например, узлы сети 001, 002, 003 могут быть в группе «Group A», а узлы сети 002, 003 — также и в группе «Group B». Если мы выберем показывать «Group A» и в то же время исключить «Group B», то в виджете будут отображаться только данные с узла сети 001.| |*Узлы сети*<br>*(Hosts)*|Введите узлы сети для отображения в виджете. Это поле с функцией автодополнения; таким образом, после начала ввода имени будет автоматически предложен список совпадающих узлов сети в выпадающем меню.<br>Если не введено никаких узлов сети, будут отображаться все узлы сети.| |*Проблема*<br>*(Problem)*|Вы можете ограничить количество отображаемых узлов сети с проблемами по имени проблемы. Если вы введёте здесь строку, то будут отображаться только узлы сети с такими проблемами, имена которых содержат введённую строку. Макросы не раскрываются| |*Важность*<br>*(Severity)*|Отметьте важности проблем, чтобы отфильтровать те из них, которые будут отображаться в виджете.<br>Если никаких важностей не отмечено, будут отображены все проблемы.| |*Теги*<br>*(Tags)*|Укажите теги проблем, чтобы ограничить количество проблем, отображаемых в виджете. Можно как включать, так и исключать определённые теги и значения тегов. Можно указать несколько условий. Поиск соответствия имён тегов всегда чувствителен к регистру.<br>По каждому условию доступно несколько операторов:<br>**Существует** — включить указанные имена тегов<br>**Равно** — включить указанные имена тегов и их значения (с учётом регистра)<br>**Содержит ** — включить указанные имена тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>**Не существует** — исключить указанные имена тегов<br>**Не равно** — исключить указанные имена тегов и их значения (с учётом регистра)<br>**Не содержит** — исключить имена указанных тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>Для условий имеется два типа вычислений:<br>**И/Или** — все условия должны соблюдаться, условия с одинаковыми именами тегов будут сгруппированы с условием Или<br>**Или** — достаточно соблюдения одного условия| |*Показать*<br>*(Show)*|Выберите вариант отображения:<br>**Группы узлов сети** — отображать проблемы по группам узлов сети<br>**Всего** — отображать общее количество проблем для всех выбранных групп узлов сети в блоках, подкрашенных в соответствии с важностью проблем.| |*Размещение*<br>*(Layout)*|Выберите вариант расположения:<br>**Горизонтальный** — подкрашенные блоки с общим количеством будут отображаться горизонтально<br>**Вертикальный** — подкрашенные блоки с общим количеством будут отображаться вертикально<br>Это поле доступно для редактирования, если в опции *Показать* выбрано «Всего».| |*Оперативные данные*<br>*(Show operational data)*|Отображение оперативных данных (смотрите описание *[Оперативных данных](/manual/web_interface/frontend_sections/monitoring/problems#оперативные-данные-проблем)* в *Мониторинг* → *Проблемы*):<br>**Нет (None)** — не показывать оперативные данные<br>**Раздельно (Separately)** — показывать оперативные данные в отдельном строке<br>**С именем проблемы (With problem name)** — оперативные данные будут указаны вместе с именем проблемы.| |*Подавленные проблемы*<br>*(Show suppressed problems)*|Отметьте флажок для отображения проблем, которые в противном случае могут быть подавлены (не показаны) по причине режима обслуживания узла сети.| |*Скрыть группы без проблем*<br>*(Hide groups without problems)*|Отметьте опцию *Скрыть группы без проблем*, чтобы скрыть в виджете данные от групп узлов сети, в которых проблемы отсутствуют.| |*Отображение проблем*<br>*(Problem display)*|Отображать количество проблем как:<br>**Все (All)** — будет отображаться общее количество проблем<br>**Раздельно (Separated)** — количество неподтвержденных проблем будет отображаться отдельным числом от общего количества проблем<br>**Только неподтверждённые (Unacknowledged only)** — будет отображаться только количество неподтверждённых проблем.| |*Шкала времени*<br>*(Show timeline)*|Отметьте флажок для отображения визуальной шкалы времени.| #### Configuration To configure, select *SLA report* 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: | | | |--|--------| |*SLA*|Select the SLA for the report.| |*Service*|Select the service for the report.| |*Show periods*|Set how many periods will be displayed in the widget (20 by default, 100 maximum).| |*From*|Select the beginning date for the report.<br>[Relative dates](/manual/config/visualization/graphs/simple#time-period-selector) are supported: `now`, `now/d`, `now/w-1w` etc; supported date modifiers: d, w, M, y.| |*To*|Select the end date for the report.<br>[Relative dates](/manual/config/visualization/graphs/simple#time-period-selector) are supported: `now`, `now/d`, `now/w-1w` etc; supported date modifiers: d, w, M, y.| #### Настройка Для настройки выберите *SLA отчёт (SLA report)* в качестве типа:  В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: | | | |--|--------| |*SLA*|Выберите SLA для отчёта.| |*Услуга (Service)*|Выберите услуги для отчёта.| |*Показать интервалы*<br>*(Show periods)*|Укажите, сколько интервалов будет отображаться в виджете (по умолчанию 20, максимум 100).| |*От*<br>*(From)*|Выберите начальную дату для отчёта.<br>Поддерживаются [относительные даты](/manual/config/visualization/graphs/simple#выбор-периода-времени): `now`, `now/d`, `now/w-1w` и т.д.; поддерживаются модификаторы дат: d, w, M, y.| |*К*<br>*(To)*|Выберите конечную дату для отчёта.<br>Поддерживаются [относительные даты](/manual/config/visualization/graphs/simple#выбор-периода-времени): `now`, `now/d`, `now/w-1w` и т.д.; поддерживаются модификаторы дат: d, w, M, y.| #### 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).| #### Настройка Для настройки выберите *Информация о системе (System information)* в качестве типа:  В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: ||| |--|--------| |*Показать*|Выбор, что отображать:<br>**Статистика системы** — отобразить общую сводку о ключевых данных сервера Zabbix и системы;<br>**Ноды отказоустойчивого кластера** — отобразить состояние нод отказоустойчивого кластера (если активирован [кластер высокой доступности](/manual/concepts/server/ha)).| #### Configuration To configure, select *Top hosts* as type: {width="600"} #### Настройка Для настройки выберите *Топ узлов сети (Top hosts)* в качестве типа: {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.| #### Настройка Для настройки выберите *Обзор триггеров (Trigger overview)* в качестве типа:  В дополнение к параметрам, которые являются [общими](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: | | | |--|--------| |*Показать*<br>*(Show)*|Фильтровать триггеры по их состоянию:<br>**Недавние проблемы (Recent problems)** — *(по умолчанию)* показывать триггеры, которые недавно были или до сих пор находятся в состоянии ПРОБЛЕМА (решённые или нерешённые);<br>**Проблемы (Problems)** — показывать триггеры, которые находятся в состоянии ПРОБЛЕМА (нерешённые);<br>**Любое (Any)** — показывать все триггеры.| |*Группы узлов сети*<br>*(Host groups)*|Выберите группу(-ы) узлов сети. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню.| |*Узлы сети*<br>*(Hosts)*|Выберите узлы сети. Это поле с функцией автодополнения; таким образом, после начала ввода имени будет автоматически предложен список совпадающих узлов сети в выпадающем меню. Прокрутите список, чтобы выбрать необходимый. Нажмите на 'х', чтобы удалить выбранный.| |*Теги*<br>*(Tags)*|Укажите теги для фильтрации триггеров, отображаемых в виджете.<br>Можно как включать, так и исключать определённые теги и значения тегов.<br>Можно указать несколько условий. Поиск соответствия имён тегов всегда чувствителен к регистру.<br><br>**Обратите внимание:** Если для параметра *Показать* задано значение «Любое», то будут показаны все триггеры, даже если указаны теги. Однако, в то время как недавние изменения состояния триггеров (отображаемые мигающими блоками) будут обновляться для всех триггеров, подробности состояния триггеров (цвет важности проблемы и наличие подтверждеия проблемы) будут обновляться только для триггеров, соответствующих указанным тегам.<br><br>По каждому условию доступно несколько операторов:<br>**Существует** — включить указанные имена тегов;<br>**Равно** — включить указанные имена тегов и их значения (с учётом регистра);<br>**Содержит** — включить указанные имена тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра);<br>**Не существует** — исключить указанные имена тегов;<br>**Не равно** — исключить указанные имена тегов и их значения (с учётом регистра);<br>**Не содержит** — исключить имена указанных тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра).<br><br>Для условий имеется два типа вычислений:<br>**И/Или** — все условия должны соблюдаться, условия с одинаковыми именами тегов будут сгруппированы с условием *Или*;<br>**Или** — достаточно соблюдения одного условия.| |*Подавленные проблемы*<br>*(Show suppressed problems)*|Отметьте флажок для отображения проблем, которые в противном случае могут быть подавлены (не показаны) по причине режима обслуживания узла сети.| |*Расположение узлов сети*<br>*(Hosts location)*|Выберите расположение узлов сети — по левой стороне или по верхнему краю.| #### 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#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: | | | |--|--------| |*URL*|Введите URL для отображения.<br>Внешние URL должны начинаться с `http://` или `https://`.<br>Начиная с версии Zabbix 4.4.8, внутренние URL поддерживают относительные пути (например, `zabbix.php?action=report.status`).<br>Поддерживаются макросы {HOST.\*}.| |*[Динамический элемент](/manual/web_interface/frontend_sections/monitoring/dashboard#динамические-виджеты)*|Задаёт, будет ли график отображать различное содержимое URL в зависимости от выбранного узла сети.<br>Это может работать, если в URL используются макросы {HOST.\*}.| ::: noteimportant Браузеры могут не загружать страницу HTTP, включённую в виджет, если доступ к веб-интерфейсу Zabbix осуществляется через HTTPS. ::: #### 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 способа оповещений: |Параметр|Описание| |--|--------| |*GSM модем (GSM modem)*|Укажите имя последовательного устройства GSM модема.| Смотрите также [общие параметры способов оповещений](/manual/config/notifications/media#общие-параметры) для получения подробной информации о настройке сообщений по умолчанию и опциях обработки оповещений. Обратите внимание, что параллельная обработка отправки 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"} Обратите внимание, что во избежание отображения слишком большого количества линий на графике, показываются только средние значения по каждому элементу данных (линии минимального и максимального значения не отображаются). Также на графике не отображаются триггеры и информация о триггерах. В созданном окне графика у вас будет виден [селектор периода времени](/manual/config/visualization/graphs/simple#селектор-периода-времени) и возможность переключения из «нормального» линейного графика на стекируемый (и обратно). {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). ### Настройка Для создания нового действия на услуги перейдите в подраздел *Действия на услуги (Service actions)* в меню *Услуги (Services)*, затем нажмите на *Создать действие (Create action)* в верхнем правом углу. Действия на услуги настраиваются так же, как и другие типы действий в Zabbix. Для получения более подробных сведений смотрите настройку [действий](/manual/config/notifications/action#настройка-действия). Ключевые отличия: - Доступ пользователя к действиям на услуги зависит от прав доступа к услугам, предоставляемых [ролью](/manual/web_interface/frontend_sections/administration/user_roles) пользователя. - Действия на услуги поддерживают другой набор [условий](#условия). ### 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*|Select the SLI reporting period used for calculating the SLI data in the [SLA report](/manual/web_interface/frontend_sections/services/sla_report):<br>**Daily** - each day, from 00:00:00 to 23:59:59.<br>**Weekly** - each week, from Sunday 00:00:00 to Saturday 23:59:59.<br>**Monthly** - each month, from the first day 00:00:00 to the last day 23:59:59.<br>**Quarterly** - each calendar quarter: Q1 (Jan–Mar), Q2 (Apr–Jun), Q3 (Jul–Sep), Q4 (Oct–Dec).<br>**Annually** - each calendar year, from January 1 00:00:00 to December 31 23:59:59.| |*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 нажмите на кнопку *Создать SLA (Create SLA)*. Вкладка **SLA** позволяет задать общие параметры SLA. {width=600} |Параметр|Описание| |--|--------| |*Имя (Name)*|Введите имя SLA. | |*SLO*|Введите цель уровня обслуживания (SLO) в процентах. | |*Отчётный период*<br>*(Reporting period)*|Выберите отчётный период SLI, используемый для расчёта данных SLI в [отчёте SLA](/manual/web_interface/frontend_sections/services/sla_report):<br>**Ежедневно (Daily)** — каждый день, с 00:00:00 до 23:59:59.<br>**Еженедельно (Weekly)** — каждую неделю, с 00:00:00 воскресенья до 23:59:59 субботы.<br>**Ежемесячно (Monthly)** — каждый месяц, с 00:00:00 первого числа до 23:59:59 последнего числа.<br>**Ежеквартально (Quarterly)** — каждый календарный квартал: Q1 (январь–март), Q2 (апрель–июнь), Q3 (июль–сентябрь), Q4 (октябрь–декабрь).<br>**Ежегодно (Annually)** — каждый календарный год, с 00:00:00 1 января до 23:59:59 31 декабря.| |*Часовой пояс*<br>*(Time zone)*|Выберите часовой пояс SLA. | |*Расписание (Schedule)*|Выберите расписание SLA — 24x7 или пользовательское. | |*Действительно с*<br>*(Effective date)*|Выберите дату начала вычисления SLA. | |*Теги услуг*<br>*(Service tags)*|Добавьте теги услуг, чтобы определить услуги, к которым необходимо применить этот SLA. <br> **Имя** — имя тега услуги, должно быть полное совпадение, с учётом регистра. <br> **Операция** — выберите *Равно*, если значение тега должно полностью совпадать (с учётом регистра), или *Содержит*, если только часть значения тега должна совпадать (без учёта регистра). <br> **Значение** — искомое значение тега услуги в соответствии с выбранной операцией.<br> SLA применяется к услуге, если по крайней мере один тег услуги совпадает. | |*Описание (Description)*|Добавьте описание к SLA. | |*Активировано (Enabled)*|Отметьте опцию, чтобы активировать вычисление SLA. | Вкладка **Исключения времени простоя (Excluded downtimes)** позволяет указать периоды простоя, которые будут исключены из вычисления SLA. {width=600} Нажмите на *Добавить (Add)* для настройки исключений времени простоя, затем укажите имя периода, время начала и длительность. #### Configuration To define a dependency, open the Dependencies tab in the trigger [configuration form](trigger#configuration). Click on *Add* in the 'Dependencies' block and select one or more triggers that the trigger will depend on.  Click *Update*. Now the trigger has the indication of its dependency in the list.  #### Настройка Для того чтобы задать зависимость, откройте вкладку Зависимости (Dependencies) в [диалоге настройки](trigger#настройка) триггера. Далее нажмите на *Добавить (Add)* в блоке «Зависимости (Dependencies)» и выберите один или несколько триггеров, от которых будет зависеть наш триггер.  Нажмите *Обновить (Update)*. Теперь триггер имеет в списке индикацию своей зависимости.  #### Configuration To define user macros, go to the corresponding location in the frontend: - for global macros, visit *Administration → General → Macros* - for host and template level macros, open host or template properties and look for the *Macros* tab ::: notetip If a user macro is used in items or triggers in a template, it is suggested to add that macro to the template even if it is defined on a global level. That way, if the macro type is *text* exporting the template to XML and importing it in another system will still allow it to work as expected. Values of secret macros are not [exported](/manual/xml_export_import). ::: A user macro has the following attributes: {width="600"} |Parameter|Description| |--|--------| |*Macro*|Macro name. The name must be wrapped in curly brackets and start with a dollar sign.<br>Example: {$FRONTEND\_URL}. The following characters are allowed in the macro names: **A-Z** (uppercase only) , **0-9** , **\_** , **.**| |*Value*|Macro value. Three value types are supported:<br>**Text** (default) - plain-text value<br>**Secret text** - the value is masked with asterisks, which could be useful to protect sensitive information such as passwords or shared keys.<br>**Vault secret** - the value contains a reference path (as 'path:key', for example “secret/zabbix:password”) to a [Vault secret](/manual/config/secrets)<br><br>*Note* that while the value of a secret macro is hidden from sight, the value can be revealed through the use in items. For example, in an external script an 'echo' statement referencing a secret macro may be used to reveal the macro value to the frontend because Zabbix server has access to the real macro value.<br><br>To select the value type click on the button at the end of the value input field:<br> icon indicates a text macro;<br> icon indicates a secret text macro. Upon hovering, the value field transforms into a  button, which allows to enter a new value of the macro (to exit without saving a new value, click the backwards arrow ().<br> icon indicates a secret Vault macro.<br><br>Maximum length of a user macro value is 2048 characters (255 characters in versions before 5.2.0).| |*Description*|Text field used to provide more information about this macro.| ::: noteclassic URLs that contain a secret macro will not work as the macro in them will be resolved as "\*\*\*\*\*\*". ::: ::: noteimportant In trigger expressions user macros will resolve if referencing a parameter or constant. They will NOT resolve if referencing a host, item key, function, operator or another trigger expression. Secret macros cannot be used in trigger expressions. ::: #### Настройка Для добавления пользовательских макросов, перейдите в соответствующий раздел в веб-интерфейсе: - для глобальных макросов, посетите *Администрирование → Общие → Макросы (Administration → General → Macros)* - для макросов на уровне узлов сети и шаблонов, откройте свойства узла сети или шаблона и найдите вкладку *Макросы (Macros)* ::: notetip Если пользовательский макрос используется в элементах данных или триггерах шаблона, то рекомендуется добавить этот макрос к шаблону, даже если он задан на глобальном уровне. Таким образом, если макрос имеет тип *Текст*, то при экспорте шаблона в XML и импорте его в другую систему это позволит ему продолжать работать, как и ожидалось. Значения секретных макросов не [экспортируются](/manual/xml_export_import). ::: Пользовательский макрос имеет следующие атрибуты: {width="600"} |Параметр|Описание| |--|--------| |*Макрос*<br>*(Macro)*|Имя макроса. Имя должно быть заключено в фигурные скобки и начинаться с символа доллара.<br>Пример: {$FRONTEND\_URL}. В именах макросов допускаются следующие символы: **A-Z** (только в верхнем регистре) , **0-9** , **\_** , **.**| |*Значение*<br>*(Value)*|Значение макроса. Поддерживаются три типа значений:<br>**Текст (Text)** (по умолчанию) — значение в виде простого текста<br>**Скрытый текст (Secret text)** — значение маскируется звёздочками, что может быть полезным для защиты конфиденциальной информации, такой как пароли или общие ключи.<br>**Секрет Хранилища (Vault secret)** — значение содержит путь ссылки (в виде «путь:ключ», например, “secret/zabbix:password”) к [секрету Хранилища](/manual/config/secrets)<br><br>*Обратите внимание*, хотя значение секретного макроса скрыто от глаз, значение может быть раскрыто через использование в элементах данных. Например, во внешнем скрипте оператор «echo», который ссылается на секретный макрос, можно использовать для раскрытия значения макроса в веб-интерфейсе, поскольку Zabbix сервер имеет доступ к реальному значению макроса.<br><br>Для выбора типа значения нажмите на кнопку в конце поля ввода значения:<br> иконка обозначает текстовый макрос;<br> иконка обозначает скрытый текстовый макрос. При наведении курсора значение поля трансформируется в кнопку  (Задать новое значение), которая позволяет ввести новое значение для макроса (чтобы выйти без сохранения нового значения, нажмите на стрелку назад ).<br> иконка обозначает секретный макрос Хранилища.<br><br>Максимальная длина значения пользовательского макроса составляет 2048 символов (255 символов в версиях до 5.2.0).| |*Описание*<br>*(Description)*|Текстовое поле, используемое для предоставления дополнительной информации о макросе.| ::: noteclassic URL-адреса, которые содержат скрытый макрос, не будут работать, так как макрос в них будет раскрыт в виде «\*\*\*\*\*\*». ::: ::: noteimportant В выражениях триггеров пользовательские макросы будут раскрыты, если ссылаются на параметр или константу. Они НЕ будут раскрыты, если ссылаются на узел сети, ключ элемента данных, функцию, оператор или другое триггерное выражение. Скрытые макросы нельзя использовать в выражениях триггеров. ::: #### Configuration To ensure proper communication between all elements involved make sure server configuration file and frontend configuration file parameters are properly configured. #### Настройка Для обеспечения надлежащей связи между всеми задействованными элементами убедитесь, что параметры файла конфигурации сервера и файла конфигурации веб-интерфейса настроены должным образом. #### Configuration To ensure proper communication between all elements involved make sure server configuration file and frontend configuration 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. #### Настройка Для немедленного выполнения пассивной проверки: - нажмите на *Выполнить сейчас (Execute now)* в диалоге настроек существующего элемента данных (или правила обнаружения):  - нажмите на *Выполнить сейчас (Execute now)* для выбранных элементов данных/правил в списке элементов даных/правил обнаружения:  В последнем случае можно выбрать несколько элементов данных/правил и «выполнить сейчас» одновременно. #### Configuration To start using a webhook integration: 1. Locate the required .yaml 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/templates/media?at=refs%2Fheads%2Frelease%2F6.0). 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:{ALERT.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>*Note*: Using local variables instead of global ones is recommended to make sure that each script operates on its own data and that there are no collisions between simultaneous calls (see [known issues](/manual/installation/known_issues#use-case-with-global-variables-shared-across-webhook-calls)).<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 any existing problem tags.<br>Note that when using [webhook tags](https://www.zabbix.com/documentation/guidelines/en/webhooks#webhook-tags), the webhook must return a JSON object containing at least an empty tags object: `var result = {tags: {}};`<br>Examples of tags that can be returned: *Jira ID: PROD-1234*, *Responsible: John Smith*, *Processed:<no value>*| |*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 a created external ticket.<br>An entry will be included for each webhook that is enabled and has this checkbox marked. Note that if the *Menu entry name* and *Menu entry URL* parameters contain any [{EVENT.TAGS.<tag name>}](/manual/appendix/macros/supported_by_location) macros, an entry will be included only if these macros can be resolved (that is, the event has these tags defined).<br>If marked, the webhook should not be used for sending notifications to different users (consider creating a [dedicated user](/manual/config/notifications/media/webhook#user_media) instead) and should not be used in multiple alert actions [for 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>}](/manual/appendix/macros/supported_by_location) macro is supported.<br>This field is only mandatory if *Include event menu entry* is marked.| |*Menu entry URL*|Specify the underlying URL of the menu entry.<br>[{EVENT.TAGS.<tag name>}](/manual/appendix/macros/supported_by_location) macro is supported.<br>This field is only mandatory if *Include event menu entry* is marked.| 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. ::: #### Настройка Чтобы начать использовать интеграцию вебхук: 1. Найдите нужный .yaml файл в директории `templates/media` загруженной версии Zabbix или загрузите его из [git репозитория](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media?at=refs%2Fheads%2Frelease%2F6.0) Zabbix. 2. [Импортируйте](/manual/xml_export_import/media#импорт) файл в вашу инсталляцию Zabbix. Вебхук появится в списке способов оповещений. 3. Настройте вебхук согласно инструкциям в файле *Readme.md* \[en\] (для быстрого доступа к *Readme.md* вы можете нажать на имя вебхука). Чтобы создать пользовательский вебхук с нуля: - Перейдите в *Администрирование → Способы оповещений (Administration → Media types)* - Нажмите *Создать способ оповещений (Create media type)* Вкладка **Способ оповещений (Media type)** содержит различные атрибуты, специфичные для этого способа оповещений:  Все обязательные поля ввода отмечены красной звёздочкой. Следующие параметры специфичны для способов оповещений на основе вебхук: |Параметр|Описание| |--|--------| |*Параметры*<br>*(Parameters)*|Укажите переменные вебхук в виде пар атрибутов и значений.<br>По уже предварительно добавленным вебхукам список параметров зависит от сервиса. Для информации о параметрах проверьте файл *Readme.md* вебхука.<br>По новым вебхукам несколько распространённых переменных включены по умолчанию (URL: <пусто>, HTTPProxy: <пусто>, To: {ALERT.SENDTO}, Subject: {ALERT.SUBJECT}, Message: { ALERT.MESSAGE}), вы можете сохранить их или удалить.<br>Все [макросы](/manual/appendix/macros/supported_by_location), которые поддерживаются в оповещениях на проблемы, поддерживаются в параметрах.<br>Если вы указываете прокси-сервер HTTP, поле поддерживает те же функции, что поле [HTTP прокси](/manual/config/items/itemtypes/http#настройка) настройки элемента данных. Строка прокси может иметь префикс `[схема]://`, чтобы можно было указать, какой тип прокси будет использоваться (например, https, socks4, socks5; смотрите [документацию \[en\]](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html)).| |*Скрипт*<br>*(Script)*|Введите код JavaScript в блоке, который появляется при нажатии на поле параметра (или на кнопку просмотра/изменения сразу после него). Этот код, собственно, и будет производить работу вебхука.<br>Скрипт — код функции, который принимает пары «параметр — значение». Значения должны быть преобразованы в объекты JSON, используя метод JSON.parse(), например: `var params = JSON.parse(value);`.<br><br>Этот код имеет доступ ко всем параметрам, он может выполнять HTTP-запросы GET, POST, PUT и DELETE и управлять заголовками HTTP и телом запроса.<br>Скрипт должен содержать оператор возврата (return), в противном случае он не будет корректным. Код может возвращать состояние OK вместе с необязательным списком тегов и их значений (смотрите опцию *Обработка тегов* ) или строку с ошибкой.<br><br>Обратите внимание, что скрипт выполняется только после создания оповещения. Если скрипт настроен на возврат и обработку тегов, эти теги не будут раскрыты в макросах {EVENT.TAGS} и {EVENT.RECOVERY.TAGS} при начальном сообщении о проблеме и в сообщениях о восстановлении, потому что скрипт еще не успел отработать.<br>*Обратите внимание*: Рекомендуется использовать локальные переменные вместо глобальных, чтобы убедиться, что каждый скрипт работает со своими собственными данными и что не возникает конфликтов между одновременными вызовами (смотрите [известные проблемы](/manual/installation/known_issues#сценарий-с-глобальными-переменными-общими-для-вызовов-вебхуков)).<br><br>Смотрите также: [Руководство по разработке вебхуков \[en\]](https://www.zabbix.com/documentation/guidelines/en/webhooks), [Примеры скриптов вебхуков](/manual/config/notifications/media/webhook/webhook_examples), [Дополнительные объекты JavaScript](/manual/config/items/preprocessing/javascript/javascript_objects).<br>| |*Время ожидания*<br>*(Timeout)*|Время ожидания выполнения JavaScript (1-60с, по умолчанию 30с).<br>Поддерживаются суффиксы времени, например, 30s, 1m.| |*Обработка тегов*<br>*(Process tags)*|Отметьте флажок для обработки возвращаемых значений свойств JSON как тегов. Эти теги добавляются к любым существующим тегам проблем.<br>Обратите внимание, что когда вебхук использует [теги вебхуков \[en\]](https://www.zabbix.com/documentation/guidelines/en/webhooks#webhook-tags), вебхук обязан возвращать JSON объект, содержащий по крайней мере пустой объект тегов: `var result = {tags: {}};`<br>Примеры тегов, которые можно вернуть: *Jira ID: PROD-1234*, *Responsible: John Smith*, *Processed:<нет значения>*| |*Добавить запись в меню события*<br>*(Include event menu entry)*|Отметьте флажок, чтобы в [меню события](/manual/web_interface/frontend_sections/monitoring/problems#меню-события) добавить запись, связывающую с созданной внешней задачей (тикетом).<br>Запись будет добавлена для каждого вебхука, который активирован и имеет этот флажок отмеченным. Обратите внимание, что если параметры *Имя записи в меню* и *URL записи в меню* содержат любые из макросов [{EVENT.TAGS.<имя_тега>}](/manual/appendix/macros/supported_by_location), то запись будет добавлена только если эти макросы могут быть раскрыты (то есть, для события эти теги определены).<br>Если отмечено, вебхук не должен использоваться для отправки оповещений разным пользователям (вместо этого рассмотрите возможность создания [выделенного пользователя](/manual/config/notifications/media/webhook#оповещение-пользователей)) и не должен использоваться в нескольких действиях оповещений [для одного события о проблеме](/manual/config/notifications/media/webhook#настройка-действий-на-оповещения).| |*Имя записи в меню*<br>*(Menu entry name)*|Укажите название пункта меню.<br>Поддерживаются макросы [{EVENT.TAGS.<имя тега>}](/manual/appendix/macros/supported_by_location).<br>Это поле является обязательным, только если отмечена опция *Добавить запись в меню события*.| |*URL записи в меню*<br>*(Menu entry URL)*|Укажите URL-адрес, на который отсылает этот пункт меню.<br>Поддерживаются макросы [{EVENT.TAGS.<имя тега>}](/manual/appendix/macros/supported_by_location).<br>Это поле является обязательным, только если отмечена опция *Добавить запись в меню события*.| Смотрите также [общие параметры способов оповещений](/manual/config/notifications/media#общие-параметры) для получения подробной информации о настройке сообщений по умолчанию и опциях обработки оповещений. ::: notewarning Даже если вебхук не использует сообщения по умолчанию, всё же необходимо задать шаблоны сообщений для типов операций, используемые этим вебхуком. ::: #### Configuration Two steps are required to close a problem manually. #### Настройка Для закрытия проблем вручную необходимо выполнить два шага. #### Configuration We assume that TimescaleDB extension has been already installed on the database server (see installation instructions in [TimescaleDB documentation](https://docs.tigerdata.com/self-hosted/latest/install/)). 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.:<br> `echo "CREATE EXTENSION IF NOT EXISTS timescaledb SCHEMA yourschema CASCADE;" | sudo -u postgres psql zabbix` ::: Then run the `postgresql/timescaledb.sql` script. 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 ::: noteimportant Please ignore warning messages informing that the best practices are not followed while running `timescaledb.sql` script on TimescaleDB version 2.9.0 and higher. Regardless of this warning, the configuration will be completed successfully. ::: 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 уже установлено на сервере базы данных (смотрите инструкции по установке в [документации TimescaleDB \[en\]](https://docs.tigerdata.com/self-hosted/latest/install/)). Расширение TimescaleDB также должно быть включено для конкретной БД, путём выполнения: echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix Для выполнения этой команды требуются привилегии администратора базы данных. ::: noteclassic Если вы используете схему базы данных, отличную от «public», вам необходимо добавить компонент SCHEMA к приведённой выше команде. Т.е.:<br> `echo "CREATE EXTENSION IF NOT EXISTS timescaledb SCHEMA yourschema CASCADE;" | sudo -u postgres psql zabbix` ::: Затем выполните скрипт `postgresql/timescaledb.sql`. Для новых установок скрипт должен запускаться после того, как обычная база данных PostgreSQL была создана с исходной схемой/данными (см. [создание базы данных](/manual/appendix/install/db_scripts)): cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: noteimportant Пожалуйста, игнорируйте предупреждающие сообщения, информирующие о том, что вы не следуете наилучшим практикам при выполнении скрипта `timescaledb.sql` на TimescaleDB версии 2.9.0 и выше. Вне зависимости от этого предупреждения, настройка будет выполнена успешно. ::: Миграция существующих данных истории и динамики изменений может занять много времени. Zabbix сервер и веб-интерфейс должны быть остановлены на время миграции. Скрипт `timescaledb.sql` задаёт следующие параметры процессу очистки истории: - Переопределить период хранения истории элементов данных - Переопределить период хранения динамики изменения элементов данных Чтобы использовать очистку истории с партиционированием для истории и динамики изменений, обе эти опции должны быть активированы. Также можно включить переопределение по отдельности либо для истории, либо только для динамики изменений. Для PostgreSQL версии 10.2 или выше и TimescaleDB версии 1.5 или выше скрипт `timescaledb.sql` устанавливает два дополнительных параметра: - Активировать сжатие - Сжимать записи старше 7 дней ##### 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=<пароль> В DBName для Zabbix прокси используйте базу данных, отличную от базы данных Zabbix сервера. В DBPassword используйте пароль к базе данных Zabbix для MySQL; пароль к PostgreSQL пользователю для PosgreSQL. Используйте `DBHost=` с PostgreSQL. Вы возможно захотите оставить настройку по умолчанию `DBHost=localhost` (или IP адрес), но в этом случае PostgreSQL будет использовать сетевой сокет для подключения к Zabbix. Обратитесь к [соответствующему разделу](/manual/installation/install_from_packages/rhel#конфигурация-selinux) для получения инструкций от RHEL. ##### 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=<пароль> В DBName для Zabbix прокси используйте базу данных, отличную от базы данных Zabbix сервера. В DBPassword используйте пароль к базе данных Zabbix для MySQL; пароль к PostgreSQL пользователю для PosgreSQL. Используйте `DBHost=` с PostgreSQL. Вы возможно захотите оставить настройку по умолчанию `DBHost=localhost` (или IP адрес), но в этом случае PostgreSQL будет использовать сетевой сокет для подключения к Zabbix. Смотрите инструкции по [настройке SELinux](/manual/installation/install_from_packages/rhel#selinux_configuration). ##### 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; PosgreSQL user password for PosgreSQL. 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=<пароль> В DBName для Zabbix прокси используйте базу данных, отличную от базы данных Zabbix сервера. В DBPassword используйте пароль к базе данных Zabbix для MySQL; пароль к PostgreSQL пользователю для PosgreSQL. Используйте `DBHost=` с PostgreSQL. Вы возможно захотите оставить настройку по умолчанию `DBHost=localhost` (или IP адрес), но в этом случае PostgreSQL будет использовать сетевой сокет для подключения к Zabbix. Смотрите инструкции по [настройке SELinux](/manual/installation/install_from_packages/rhel_centos#настройка_selinux). #### 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=<пароль> В DBPassword используйте пароль к базе данных Zabbix для MySQL; пароль к PostgreSQL пользователю для PosgreSQL. Используйте `DBHost=` с PostgreSQL. Вы возможно захотите оставить настройку по умолчанию `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"} #### Настройка соединения с базой данных Укажите информацию для подключения к базе данных. База данных Zabbix должна быть уже создана. {width="550"} Если выбрана опция *TLS шифрование базы данных*, в диалоге появятся дополнительные поля для [настройки TLS соединения](/manual/appendix/install/db_encrypt) к базе данных (только для MySQL или PostgreSQL). Если для хранения учётных данных была выбрана опция HashiCorp Vault, станут доступны дополнительные поля, в которых необходимо будет указать API endpoint Хранилища, путь к секрету и токен аутентификации: {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":{...}} ###### Запрос на конфигурацию Запрос на выполнение функции *Configure* интерфейса *Configurator*. | | | |---|---| |направление|агент → плагин| |ответ|неприменимо| Параметры, специфичные для запросов *Configure*: |Имя|Тип|Комментарии| |---------|--------|----------| |global_options|объект JSON|Объект JSON, содержащий глобальные опции конфигурации агента.| |private_options|объект JSON (опционально)|Объект JSON, содержащий персональные опции конфигурации плагина, если есть.| *Пример:* {"id":6,"type":8,"global_options":{...},"private_options":{...}} #### 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 (Windows service). Для Zabbix агента 2, замените *agentd* на *agent2* в инструкциях ниже. Вы можете запустить один экземпляр Zabbix агента или несколько экземпляров агента на хосте Microsoft Windows. Одиночный экземпляр может использовать файл конфигурации `C:\zabbix_agentd.conf` по умолчанию или файл конфигурации, указанный в командной строке. В случае нескольких экземпляров каждый экземпляр агента должен иметь свой собственный файл конфигурации (один из экземпляров может использовать файл конфигурации по умолчанию). Пример файла конфигурации доступен в архиве с исходными кодами Zabbix в виде файла `conf/zabbix_agentd.win.conf`. Смотрите опции [файла конфигурации](/manual/appendix/config/zabbix_agentd_win) для получения подробных сведений по настройке Zabbix Windows агента. #### Configuring a global script  ::: noteclassic It is recommended to use [macro functions](/manual/config/macros/macro_functions) instead of plain macros in global scripts to enhance security, as macros are not automatically escaped. ::: Script attributes: |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Unique name of the script.<br>E.g., `Clear /tmp filesystem`| |*Scope*|<|Scope of the script - action operation, manual host action or manual event action. This setting determines where the script can be used - in remote commands of action operations, from the [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu) or from the [event menu](/manual/web_interface/frontend_sections/monitoring/problems#event_menu) respectively.<br>Setting the scope to 'Action operation' makes the script available for all users with access to *Configuration* → *Actions*.<br>If a script is actually used in an action, its scope cannot be changed away from 'action operation'.<br>**Macro support**<br>The scope affects the range of available macros. For example, user-related macros ({USER.\*}) are supported in scripts to allow passing information about the user that launched the script. However, they are not supported if the script scope is an action operation, as action operations are executed automatically.<br>To find out which macros are supported, do a search for 'Trigger-based notifications and commands/Trigger-based commands', 'Manual host action scripts' and 'Manual event action scripts' in the [supported macro](/manual/appendix/macros/supported_by_location) table. Note that if a macro may resolve to a value with spaces (for example, host name), don't forget to quote as needed.| |*Menu path*|<|The desired menu path to the script. For example, `Default` or `Default/`, will display the script in the respective directory. Menus can be nested, e.g., `Main menu/Sub menu1/Sub menu2`. When accessing scripts through the host/event menu in monitoring sections, they will be organized according to the given directories.<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Type*|<|Click the respective button to select the script type:<br>**Webhook**, **Script**, **SSH**, **Telnet** or **[IPMI](/manual/config/notifications/action/operation/remote_command#ipmi_remote_commands)** command.| | |Script type: Webhook|<| |^|*Parameters*|Specify the webhook variables as attribute-value pairs.<br>See also: [Webhook](/manual/config/notifications/media/webhook) media configuration.<br>Macros and custom [user macros](/manual/config/macros/user_macros) are supported in parameter values. Macro support depends on the scope of the script (see *Scope* above).| |^|*Script*|Enter the JavaScript code in the block that appears when clicking in the parameter field (or on the view/edit button next to it).<br>Macro support depends on the scope of the script (see *Scope* above).<br>See also: [Webhook](/manual/config/notifications/media/webhook) media configuration, [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects).| |^|*Timeout*|JavaScript execution timeout (1-60s, default 30s).<br>Time suffixes are supported, e.g., 30s, 1m.| | |Script type: Script|<| |^|*Execute on*|Click the respective button to execute the shell script on:<br>**Zabbix agent** - the script will be executed by Zabbix agent (if the system.run item is [allowed](/manual/config/items/restrict_checks)) on the host<br>**Zabbix server (proxy)** - the script will be executed by Zabbix server or proxy (if enabled by [EnableRemoteCommands](/manual/appendix/config/zabbix_proxy)) - depending on whether the host is monitored by server or proxy<br>**Zabbix server** - the script will be executed by Zabbix server only| |^|*Commands*|Enter full path to the commands to be executed within the script.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| | |Script type: SSH|<| |^|*Authentication method*|Select authentication method - password or public key.| |^|*Username*|Enter the username.| |^|*Password*|Enter the password.<br>This field is available if 'Password' is selected as the authentication method.| |^|*Public key file*|Enter the path to the public key file.<br>This field is available if 'Public key' is selected as the authentication method.| |^|*Private key file*|Enter the path to the private key file.<br>This field is available if 'Public key' is selected as the authentication method.| |^|*Passphrase*|Enter the passphrase.<br>This field is available if 'Public key' is selected as the authentication method.| |^|*Port*|Enter the port.| |^|*Commands*|Enter the commands.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| | |Script type: Telnet|<| |^|*Username*|Enter the username.| |^|*Password*|Enter the password.| |^|*Port*|Enter the port.| |^|*Commands*|Enter the commands.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| | |Script type: IPMI|<| |^|*Command*|Enter the IPMI command.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| |*Description*|<|Enter a description for the script.| |*Host group*|<|Select the host group that the script will be available for (or *All* for all host groups).<br>It is **not recommended** to use discovered groups in this field. When discovered groups will be undiscovered and deleted, the script scope will be reset to *All*.| |*User group*|<|Select the user group that the script will be available to (or *All* for all user groups).<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Required host permissions*|<|Select the permission level for the host group - *Read* or *Write*. Only users with the required permission level will have access to executing the script.<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Enable confirmation*|<|Mark the checkbox to display a confirmation message before executing the script. This feature might be especially useful with potentially dangerous operations (like a reboot script) or ones that might take a long time.<br>This option is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Confirmation text*|<|Enter a custom confirmation text for the confirmation popup enabled with the checkbox above (for example, *Remote system will be rebooted. Are you sure?*). To see how the text will look like, click on *Test confirmation* next to the field.<br>{HOST.\*} and {USER.\*} macros are supported. Custom [user macros](/manual/config/macros/user_macros) are supported.<br>*Note:* the macros will not be expanded when testing the confirmation message.<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| #### Настройка глобального скрипта  ::: noteclassic Для повышения безопасности рекомендуется в глобальных скриптах использовать [функции макросов](/manual/config/macros/macro_functions) вместо обычных макросов, поскольку макросы не экранируются автоматически. ::: Атрибуты скрипта: |Параметр|<|Описание| |-|----------|----------------------------------------| |*Имя*<br>*(Name)*|<|Уникальное имя скрипта.<br>Например: `Очистить файловую систему /tmp`| |*Область*<br>*(Scope)*|<|Область действия скрипта — операция действия, действие вручную над узлом сети или действие вручную над событиями. Этот параметр определяет, где может использоваться скрипт - в удалённых командах операций действия, из [меню узлов сети](/manual/web_interface/frontend_sections/monitoring/dashboard#меню-узлов-сети) или из [меню события](/manual/web_interface/frontend_sections/monitoring/problems#меню-события) соответственно.<br>Если область действия выставить в значение «Операция действия», то скрипт станет доступным всем пользователям, имеющим права доступа к *Настройка* → *Действия*.<br>Если скрипт реально используется в каком-либо действии, значение его области действия «Операция действия» нельзя поменять на что-то другое.<br>**Поддержка макросов**<br>Область действия влияет на набор доступных макросов. Например, относящиеся к пользователю макросы ({USER.\*}) поддерживаются в скриптах, чтобы позволить передать информацию о том пользователе, который запустил скрипт. Однако, если область действия скрипта - операция действия, то эти макросы не поддерживаются, поскольку операции действия выполняются автоматически.<br>Чтобы найти, какие макросы поддерживаются, выполните поиск по фразам «Оповещения и команды на события триггеров/Команды на события триггеров», «Скрипты действий вручную над узлом сети» и «Скрипты действий вручную над событиями» в таблице [поддерживаемых макросов](/manual/appendix/macros/supported_by_location). Обратите внимание, что если макрос может раскрыться в значение, содержащее пробелы (например, имя узла сети), не забудьте заключить его в кавычки при необходимости.| |*Путь в меню*<br>*(Menu path)*|<|Желаемый путь к скрипту в меню. Например, `Default` или `Default/` будет отображать скрипт в соответствующей папке. Меню могут быть вложенными, например: `Главное меню/Вложенное меню1/Вложенное меню2`. При доступе к скриптам через меню узла сети или события в разделах мониторинга, они будут организованы в соответствии с данными папками.<br>Это поле отображается, только если для параметра *Область* выбраны значения «Действие вручную над узлом сети» или «Действие вручную над событиями».| |*Тип*<br>*(Type)*|<|Нажмите на соответствующую кнопку для выбора типа скрипта:<br>**Webhook**, **Скрипт**, **SSH**, **Telnet** или команда **[IPMI](/manual/config/notifications/action/operation/remote_command#удалённые-команды-через-ipmi)**.| | |Тип скрипта: Webhook|<| |^|*Параметры*<br>*(Parameters)*|Укажите переменные вебхука в виде пар атрибут-значение.<br>Смотрите также: настройка способа оповещения [Вебхук](/manual/config/notifications/media/webhook).<br>В значениях параметров поддерживаются макросы и настраиваемые [пользовательские макросы](/manual/config/macros/user_macros). Поддержка макросов зависит от области действия скрипта (см. *Область* выше).| |^|*Скрипт*<br>*(Script)*|Введите код JavaScript в блоке, который появляется при нажатии на поле параметра (или на кнопку просмотра/изменения рядом с ним).<br>Поддержка макросов зависит от области действия скрипта (см. *Область* выше).<br>Смотрите также: настройка способа оповещения [Вебхук](/manual/config/notifications/media/webhook), [Дополнительные объекты JavaScript](/manual/config/items/preprocessing/javascript/javascript_objects).| |^|*Время ожидания*<br>*(Timeout)*|Тайм-аут выполнения JavaScript (1-60s, по умолчанию 30s).<br>Поддерживаются суффиксы времени, например: 30s, 1m.| | |Тип скрипта: Скрипт|<| |^|*Выполнение на*<br>*(Execute on)*|Нажмите на соответствующую кнопку для выполнения скрипта оболочки на:<br>**Zabbix агент** — скрипт будет выполняться агентом Zabbix (если элемент данных system.run [разрешён](/manual/config/items/restrict_checks)) на узле сети<br>**Zabbix сервер (прокси)** — скрипт будет выполняться Zabbix сервером или прокси (если разрешено параметром [EnableRemoteCommands](/manual/appendix/config/zabbix_proxy)) — в зависимости от того, контролируется ли узел сети сервером или прокси<br>**Zabbix сервер** — скрипт будет выполняться только сервером Zabbix| |^|*Команды*<br>*(Commands)*|Введите полный путь к командам, которые будут выполняться в скрипте.<br>Поддержка макросов зависит от области действия скрипта (см. *Область* выше). Также поддерживаются настраиваемые [пользовательские макросы](/manual/config/macros/user_macros).| | |Тип скрипта: SSH|<| |^|*Метод аутентификации*<br>*(Authentication method)*|Выберите метод аутентификации — пароль или публичный ключ.| |^|*Имя пользователя*<br>*(Username)*|Введите имя пользователя.| |^|*Пароль*<br>*(Password)*|Введите пароль.<br>Это поле доступно, если в качестве метода аутентификации выбрано «Пароль».| |^|*Файл публичного ключа*<br>*(Public key file)*|Введите путь к файлу с открытым ключом (public key file).<br>Это поле доступно, если в качестве метода аутентификации выбрано «Публичный ключ».| |^|*Файл приватного ключа*<br>*(Private key file)*|Введите путь к файлу с закрытым ключом (private key file).<br>Это поле доступно, если в качестве метода аутентификации выбрано «Публичный ключ».| |^|*Фраза-пароль ключа*<br>*(Passphrase)*|Введите парольную фразу (passphrase).<br>Это поле доступно, если в качестве метода аутентификации выбрано «Публичный ключ».| |^|*Порт*<br>*(Port)*|Введите порт.| |^|*Команды*<br>*(Commands)*|Введите команды.<br>Поддержка макросов зависит от области действия скрипта (см. *Область* выше). Также поддерживаются настраиваемые [пользовательские макросы](/manual/config/macros/user_macros).| | |Тип скрипта: Telnet|<| |^|*Имя пользователя*<br>*(Username)*|Введите имя пользователя.| |^|*Пароль*<br>*(Password)*|Введите пароль.| |^|*Порт*<br>*(Port)*|Введите порт.| |^|*Команды*<br>*(Commands)*|Введите команды.<br>Поддержка макросов зависит от области действия скрипта (см. *Область* выше). Также поддерживаются настраиваемые [пользовательские макросы](/manual/config/macros/user_macros).| | |Тип скрипта: IPMI|<| |^|*Команды*<br>*(Command)*|Введите команды IPMI.<br>Поддержка макросов зависит от области действия скрипта (см. *Область* выше). Также поддерживаются настраиваемые [пользовательские макросы](/manual/config/macros/user_macros).| |*Описание*<br>*(Description)*|<|Введите описание для скрипта.| |*Группа узлов сети*<br>*(Host group)*|<|Выберите группу узлов сети, которой будет доступен этот скрипт (или *Все* для всех групп узлов сети).<br>**Не рекомендуется** использовать в этом поле группы, добавленные обнаружением. Когда обнаруженные группы более не будут обнаруживаться и будут удалены, область действия скрипта будет сброшена на *Все*.| |*Группа пользователей*<br>*(User group)*|<|Выберите группу пользователей, которой будет доступен этот скрипт (или *Все* для всех групп пользователей).<br>Это поле отображается, только если для параметра *Область* выбраны значения «Действие вручную над узлом сети» или «Действие вручную над событиями».| |*Требуемые права доступа к узлам сети*<br>*(Required host permissions)*|<|Выберите уровень прав доступа к группе узлов сети — *Чтение* или *Запись*. Только пользователи с требуемым уровнем прав доступа будут иметь доступ на выполнение скрипта.<br>Это поле отображается, только если для параметра *Область* выбраны значения «Действие вручную над узлом сети» или «Действие вручную над событиями».| |*Включить подтверждение*<br>*(Enable confirmation)*|<|Отметьте эту опцию, чтобы перед выполнением скрипта отображалось сообщение подтверждения. Эта возможность может быть особенно полезна при потенциально опасных операциях (таких как скрипт перезагрузки) или при операциях, которые могут занять продолжительное время.<br>Это поле отображается, только если для параметра *Область* выбраны значения «Действие вручную над узлом сети» или «Действие вручную над событиями».| |*Текст подтверждения*<br>*(Confirmation text)*|<|Введите текст подтверждения, если всплывающее окно подтверждения было включено выше (например: *Удалённая система будет перезагружена. Вы уверены?*). Для просмотра того, как этот текст будет выглядеть, нажмите на *Тест подтверждения* после поля ввода.<br>Поддерживаются макросы {HOST.\*} и {USER.\*}. Поддерживаются настраиваемые [пользовательские макросы].<br>*Предупреждение:* Макросы не будут раскрыты при тестировании сообщений подтверждения.<br>Это поле отображается, только если для параметра *Область* выбраны значения «Действие вручную над узлом сети» или «Действие вручную над событиями».| #### 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 alert actions Actions determine which notifications should be sent via the webhook. Steps for [configuring actions](/manual/config/notifications/action) involving webhooks are the same as for all other media types with these exceptions: - If a webhook uses [webhook tags](https://www.zabbix.com/documentation/guidelines/en/webhooks#webhook-tags) to store ticket\\message ID and handle update\\resolve operations, avoid using the same webhook in multiple alert actions for a single problem event. If {EVENT.TAGS.<tag name>} exists and gets updated in the webhook, its resulting value will be undefined. To avoid this, use a new tag name in the webhook for storing updated values. This applies to Jira, Jira Service Desk, Mattermost, Opsgenie, OTRS, Redmine, ServiceNow, Slack, Zammad, and Zendesk webhooks provided by Zabbix and to most webhooks utilizing the *Include event menu entry* option. Note, however, that a single webhook can be used in multiple operations or escalation steps of the same action, as well as in different actions that will not be triggered by the same problem event due to different [conditions](/manual/config/notifications/action/conditions). - When using a webhook in actions for [internal events](/manual/config/events/sources#internal-events), ensure to mark the *Custom message* checkbox and define a custom message in the action operation configuration. Otherwise, a notification will not be sent. #### Настройка действий на оповещения Действия определяют, какие оповещения следует отправлять через вебхук. Шаги для [настройки действий](/manual/config/notifications/action) с использованием вебхуков абсолютно такие же, как и для всех остальных способов оповещения, за некоторыми исключениями: - Если вебхук использует [теги вебхуков \[en\]](https://www.zabbix.com/documentation/guidelines/en/webhooks#webhook-tags) для хранения идентификатора задачи (тикета) \\ сообщения и управляет операциями обновления\\восстановления, этот вебхук не следует использовать в нескольких действиях на оповещения по одному и тому же событию на проблемы. Если {EVENT.TAGS.<имя>} существует и обновляется в вебхуке, то его окончательное значение будет не определено. Чтобы избежать этого, используйте в вебхуке новое имя тега для хранения обновлённых значений. Это относится к вебхукам Jira, Jira Service Desk, Mattermost, Opsgenie, OTRS, Redmine, ServiceNow, Slack, Zammad и Zendesk, которые поставляются Zabbix, и к большинству вебхуков, которые используют опцию *Добавить запись в меню события (Include event menu entry)*. Однако, обратите внимание, что один вебхук может быть использован в нескольких операциях или шагах эскалации того же действия, а также в различных действиях, которые не будут срабатывать по тому же событию проблемы из-за отличающихся [условий](/manual/config/notifications/action/conditions). - При использовании вебхука в действиях на [внутренние события](/manual/config/events/sources#внутренние-события) убедитесь, что в настройках операций действия отмечена опция *Пользовательское сообщение (Custom message)* и указано пользовательское сообщение. В противном случае оповещение отправлено не будет. #### Configuring an action To configure an action, do the following: - Go to *Configuration* -> *Actions* and select the required action type from the submenu (you can switch to another type later, using the title dropdown) - Click on *Create action* - Name the action - Choose [conditions](/manual/config/notifications/action/conditions) upon which operations are carried out - Choose the [operations](/manual/config/notifications/action/operation) to carry out *Note* that service actions can be configured in the [service action](/manual/web_interface/frontend_sections/services/service_actions) section. General action attributes:  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Name*|Unique action name.| |*Type of calculation*|Select the evaluation [option](/manual/config/notifications/action/conditions#type_of_calculation) for action conditions (with more than one condition):<br>**And** - all conditions must be met<br>**Or** - enough if one condition is met<br>**And/Or** - combination of the two: AND with different condition types and OR with the same condition type<br>**Custom expression** - a user-defined calculation formula for evaluating action conditions.| |*Conditions*|List of action conditions.<br>Click on *Add* to add a new [condition](/manual/config/notifications/action/conditions).<br>If no conditions are configured, the action will run for every event that corresponds to the [action type](#overview) being configured.| |*Enabled*|Mark the checkbox to enable the action. Otherwise, it will be disabled.| #### Настройка действия Для настройки действия, сделайте следующее: - Перейдите в *Настройка → Действия* (*Configuration* -> *Actions*) и выберите требуемый тип действия из подменю (вы можете переключиться на другой тип позже, используя выпадающее меню в заголовке) - Нажмите на *Создать действие (Create action)* - Назовите действие - Выберите [условия](/manual/config/notifications/action/conditions), при которых будут выполняться операции - Выберите осуществляемые [операции](/manual/config/notifications/action/operation) *Обратите внимание*, действия на услуги можно настроить в разделе [действия на услуги](/manual/web_interface/frontend_sections/services/service_actions). Общие атрибуты действий:  Все обязательные поля ввода отмечены красной звёздочкой. |Параметр|Описание| |--|--------| |*Имя (Name)*|Уникальное имя действия.| |*Тип вычисления*<br>*(Type of calculation)*|Выберите [опцию](/manual/config/notifications/action/conditions#тип-вычисления) вычисления условий действия (с более чем одним условием):<br>**И (And)** — должны быть выполнены все условия<br>**Или (Or)** — достаточно выполнения одного условия<br>**И/Или (And/Or)** — комбинация из двух опций: И с различными типами условий и ИЛИ с одинаковым типом условий<br>**Пользовательское выражение (Custom expression)** — формула вычисления для оценки условий действия, заданная пользователем.| |*Условия*<br>*(Conditions)*|Список условий действия.<br>Нажмите на *Добавить (Add)* для добавления нового [условия](/manual/config/notifications/action/conditions).<br>Если не настроено никаких условий, действие будет выполняться для каждого события, соответствующего настраиваемому [типу действия](#обзор).| |*Активировано (Enabled)*|Отметьте флажок для активации действия. В противном случае действие будет деактивировано.| #### 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 gateway По умолчанию, Java gateway слушает порт 10052. Если вы планируете работу Java gateway на другом порту, то вы можете указать его в скрипте settings.sh. Смотрите описание [файла конфигурации Java gateway](/manual/appendix/config/zabbix_java) для получения сведений о том, как указать эту и другие опции. ::: notewarning Порт 10052 не [зарегистрирован в IANA](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). ::: Выполнив настройки, вы можете запустить Java gateway, выполнив скрипт запуска: ./startup.sh Точно так же, если вам более не требуется Java gateway, выполните скрипт завершения работы для остановки Java gateway: ./shutdown.sh Обратите внимание, что в отличие от сервера и прокси, Java gateway лёгок и не требует наличия какой-либо базы данных. #### 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 gateway Параметры конфигурации Zabbix Java gateway можно настроить в следующем файле: /etc/zabbix/zabbix_java_gateway.conf Для получении более подробных сведений смотрите [параметры](/manual/appendix/config/zabbix_java) настройки Zabbix Java gateway. Чтобы запустить Zabbix Java gateway: # service zabbix-java-gateway restart Чтобы автоматически запускать Zabbix Java gateway при загрузке системы: 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 gateway Параметры конфигурации Zabbix Java gateway можно настроить в следующем файле: /etc/zabbix/zabbix_java_gateway.conf Для получения более подробных сведений смотрите [параметры](/manual/appendix/config/zabbix_java) настройки Zabbix Java gateway. Чтобы запустить Zabbix Java gateway: systemctl restart zabbix-java-gateway Чтобы автоматически запускать Zabbix Java gateway при загрузке системы: 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 gateway Параметры конфигурации Zabbix Java gateway можно настроить в следующем файле: /etc/zabbix/zabbix_java_gateway.conf Для получения более подробных сведений смотрите [параметры](/manual/appendix/config/zabbix_java) настройки Zabbix Java gateway. Чтобы запустить Zabbix Java gateway: systemctl restart zabbix-java-gateway Чтобы автоматически запускать Zabbix Java gateway при загрузке системы: systemctl enable zabbix-java-gateway #### 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. #### Настройка операции Для настройки операции, перейдите на вкладку *Операции (Operations)* в [настройках](/manual/config/notifications/action) действия. {width="600"} Общие атрибуты операций: |Параметр||Описание| |--|-----------| |*Длительность шага операции по умолчанию*<br>*(Default operation step duration)*|Длительность одного шага операции по умолчанию (от 60 секунд до 1 недели).<br>Например, длительность шага в один час означает, что если эта операция выполнилась, то следующая операция начнется через один час.<br>С Zabbix 3.4.0, поддерживаются [суффиксы времени](/manual/appendix/suffixes), например, 60s, 1m, 2h, 1d.<br>[Пользовательские макросы](/manual/config/macros/user_macros) поддерживаются с 3.4.0.| |*Операции*<br>*(Operations)*|Операции действия (если имеются) отображаются вместе со следуюшими деталями:<br>**Шаги (Steps)** — шаг(и) эскалации, которым назначаются операции<br>**Детали (Details)** — тип операции и её получатель/цель.<br>Список операций также отображает способ оповещения (e-mail, SMS или скрипт), используемый для отправки сообщения, а также имя и фамилию (в круглых скобках после псевдонима) получателя оповещения.<br>**Начинать в (Start in)** — через какое время после события выполнится эта операция<br>**Длительность (сек) (Duration (sec))** — отображение длительности шага. Отображается *по умолчанию*, если шаг имеет длительность по умолчанию, и отображается время, если используется заданное время.<br>**Действие (Action)** — отображаются ссылки на изменение и удаление операции.| |*Операции восстановления*<br>*(Recovery operations)*|Операции действия (если имеются) отображаются вместе со следующими деталями:<br>**Детали (Details)** — тип операции и её получатель/цель.<br>Список операций также отображает способ оповещения (e-mail, SMS или скрипт), используемый для отправки сообщения, а также имя и фамилию (в круглых скобках после псевдонима) получателя оповещения.<br>**Действие (Action)** — отображаются ссылки на изменение и удаление операции.| |*Операции обновления*<br>*(Update operations)*|Операции действия (если имеются) отображаются вместе со следующими деталями:<br>**Детали (Details)** — тип операции и её получатель/цель.<br>Список операций также отображает способ оповещения (e-mail, SMS или скрипт), используемый для отправки сообщения, а также имя и фамилию (в круглых скобках после псевдонима) получателя оповещения.<br>**Действие (Action)** — отображаются ссылки на изменение и удаление операции.| |*Приостановить операции для подавленных проблем*<br>*(Pause operations for suppressed problems)*|Отметьте эту опцию, чтобы отложить начало операций на время периода обслуживания. Когда операции запустятся (после периода обслуживания), выполнятся все операции, включая те, которые для событий во время обслуживания.<br>Обратите внимание, что этот параметр влияет только на эскалации о проблемах; операции восстановления и обновления не будут затронуты.<br>Если вы не отметите, операции будут выполняться без задержки даже в течение периода обслуживания.<br>Эта опция недоступна для *Действий на услуги*.| |*Оповещение об отменённых эскалациях*<br>*(Notify about canceled escalations)*|Отключите эту опцию, чтобы отключить оповещения об отменённых эскалациях (когда узел сети, элемент данных, триггер или действие деактивированы).| Все обязательные поля ввода отмечены красной звёздочкой. Чтобы настроить нюансы новой операции, нажмите на  (Добавить) в блоке Операции. Чтобы изменить существующую операцию, нажмите на  (Изменить) сразу после операции. Откроется всплывающее окно, где вы сможете изменить элементы шага операции. #### 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. #### Настройка операции обновления Для настройки операции обновления перейдите на вкладку *Операции (Operations)* в [настройках](/manual/config/notifications/action) действия.  Чтобы настроить нюансы новой операции обновления, нажмите на  (Добавить) в блоке *Операции обновления (Update operations)*. Чтобы изменить существующую операцию, нажмите на  (Изменить) сразу после операции. Откроется всплывающее окно, где вы сможете изменить элементы шага операции. #### 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 recovery operation To configure a recovery operation, go to the *Operations* tab in [action](/manual/config/notifications/action) configuration.  To configure details of a new recovery operation, click on  in the *Recovery 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. ### Настройка операции восстановления Для настройки операции восстановления перейдите на вкладку *Операции (Operations)* в настройках [действия](/manual/config/notifications/action).  Чтобы настроить нюансы новой операции восстановления, нажмите на  (Добавить) в блоке *Операции восстановления (Recovery operations)*. Чтобы изменить существующую операцию, нажмите на  (Изменить) сразу после операции. Откроется всплывающее окно, где вы сможете изменить элементы шага операции. #### 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 } ``` #### Настройка виджета *Обзор триггера* Настройте виджет *Обзор триггера*, который отображает состояния триггеров для всех групп хостов, имеющих триггеры, с тегом с именем «область действия» и содержащим значение «доступность». Запрос: ```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* Настройте виджет *URL*, который отображает домашнюю страницу руководства Zabbix. Запрос: ```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 ::: #### Настройка аутентификации Вкладка **Аутентификация (Authentication)** позволяет вам настроить опции аутентификации сценария. Зелёная точка в имени вкладки означает, что включён какой-то тип HTTP аутентификации.  Параметры аутентификации: |Параметр|Описание| |--|--------| |*Аутентификация*<br>*(Authentication)*|Опции аутентификации.<br>**Нет** — без использования аутентификации.<br>**Простая аутентификация** — с использованием простой (basic) аутентификации.<br>**NTLM аутентификация** — с использованием NTLM ([Windows NT LAN Manager)](https://ru.wikipedia.org/wiki/NTLM) аутентификации.<br>**Kerberos** — с использованием Kerberos аутентификации. Смотрите также: [Настройка Kerberos с Zabbix](/manual/appendix/items/kerberos).<br>**Digest** — с использованием Digest аутентификации.<br>После выбора какого-либо метода аутентификации будут доступны доступны два дополнительных поля для ввода имени пользователя и пароля.<br>В полях имя пользователя и пароль можно использовать пользовательские макросы.| |*Проверка SSL узла*<br>*(SSL verify peer)*|Отметьте для верификации SSL сертификата веб-сервера.<br>Сертификат сервера будет автоматически взят из местоположения центра сертификации (CA) всей системы. Вы можете переопределить расположение CA файлов, используя параметр конфигурации [SSLCALocation](/manual/appendix/config/zabbix_server) Zabbix сервера или прокси.<br>Этот параметр использует опцию cURL [CURLOPT\_SSL\_VERIFYPEER \[en\]](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).| |*Проверка SSL хоста*<br>*(SSL verify host)*|Отметьте для верификации, что поле *Common Name* или поле *Subject Alternate Name* сертификата веб-сервера совпадают.<br>Этот параметр использует cURL опцию [CURLOPT\_SSL\_VERIFYHOST \[en\]](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).| |*Файл SSL сертификата*<br>*(SSL certificate file)*|Имя файла SSL сертификата для аутентификации клиента. Файл сертификата должен быть в формате PEM^1^. Если файл сертификата также содержит и закрытый ключ (private key), оставьте поле *Файл SSL ключа* пустым. Если ключ зашифрован, укажите пароль в поле *Пароль к SSL ключу*. Папка, содержащая этот файл, указывается в параметре конфигурации [SSLCertLocation](/manual/appendix/config/zabbix_server) Zabbix сервера и прокси.<br>В этом поле можно использовать макросы `HOST.*` и пользовательские макросы.<br>Этот параметр использует опцию cURL [CURLOPT\_SSLCERT \[en\]](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html).| |*Файл SSL ключа*<br>*(SSL key file)*|Имя файла закрытого ключа (private key) SSL, который используется для аутентификации клиента. Файл закрытого ключа должен быть в формате PEM^1^. Папка, содержащая этот файл, указывается в параметре конфигурации [SSLKeyLocation](/manual/appendix/config/zabbix_server) Zabbix сервера и прокси.<br>В этом поле можно использовать макросы `HOST.*` и пользовательские макросы.<br>Этот параметр использует опцию cURL [CURLOPT\_SSLKEY \[en\]](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html).| |*Пароль к SSL ключу*<br>*(SSL key password)*|Пароль к файлу закрытого ключа.<br>В этом поле можно использовать пользовательские макросы.<br>Этот параметр использует cURL опцию [CURLOPT\_KEYPASSWD \[en\]](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html).| ::: noteimportant \[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 Если сертификат клиента и закрытый ключ (private key) находятся в одном файле, просто укажите его в поле «Файл SSL сертификата» и оставьте поле «Файл SSL ключа» пустым. Сертификат и ключ всё ещё должны быть в формате PEM. Очень просто объединить сертификат и ключ: cat client.crt client.key > client.pem ::: #### 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 web 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| |--|--------| |*Name*|Unique scenario name.<br>[User macros](/manual/config/macros/user_macros) are supported. *Note* that if user macros are used, these macros will be left unresolved in [web monitoring item](/manual/web_monitoring/items) names.| |*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 "\*\*\*\*\*\*". ::: #### Настройка веб-сценария Для настройки веб-сценария: - Перейдите к: *Настройка → Узлы сети (Configuration → Hosts)* (или *Шаблоны (Templates)*) - Нажмите на *Веб (Web)* в строке с узлом сети/шаблоном - Нажмите на *Создать сценарий (Create web scenario)* в верхнем правом углу (или на имени сценария для изменения существующего сценария) - Введите в диалоге параметры сценария Вкладка **Сценарий (Scenario)** позволяет вам настроить общие параметры веб-сценария.  Все обязательные поля ввода отмечены красной звёздочкой. Параметры сценария: |Параметр|Описание| |--|--------| |*Имя*<br>*(Name)*|Уникальное имя сценария.<br> Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros). *Обратите внимание*, что если используется пользовательские макросы, то эти макросы останутся нераскрытыми в именах [элементов данных веб-мониторинга](/manual/web_monitoring/items).| |*Интервал обновления*<br>*(Update interval)*|Как часто сценарий будет выполняться.<br>Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например, 30s, 1m, 2h, 1d.<br>Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros)<br>*Обратите внимание*, что если используется пользовательский макрос и его значение изменилось (к примеру, 5m → 30s), следующая проверка будет выполнена в соответствии с предыдущим значением (в данном примере — более далёком будущем).| |*Попыток*<br>*(Attempts)*|Количество попыток выполнения шагов веб-сценария. В случае сетевых проблем (превышено время ожидания, отсутствие подключения и прочее) Zabbix может повторять выполнение шагов несколько раз. Указанное количество будет одинаково действовать для каждого шага сценария. Можно указать до 10 попыток, значение по умолчанию равно 1.<br>*Примечание*: Zabbix не повторит шаг из-за ошибочного кода ответа или несовпадения необходимой строки.| |*Агент*<br>*(Agent)*|Выбор агента клиента.<br>Zabbix будет представляться выбранным браузером. Полезно для мониторинга Веб-сайтов, которые генерируют различное содержимое для разных браузеров.<br>В этом поле можно использовать пользовательские макросы.| |*HTTP прокси*<br>*(HTTP proxy)*|Вы можете указать необходимый HTTP прокси, следуя формату: `[протокол://][имя_пользователя[:пароль]@]прокси.example.com[:порт]`.<br>Это задаёт опцию cURL [CURLOPT\_PROXY \[en\]](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html).<br>Можно использовать опциональный префикс `протокол://`, чтобы задать альтернативные протоколы прокси (поддержка префикса протокола добавлена в cURL 7.21.7). Если протокол не указан, прокси будет рассматриваться как HTTP прокси.<br>По умолчанию будет использоваться порт 1080.<br>Если указано, прокси заменит переменные окружения, связанные с прокси - такие как http\_proxy, HTTPS\_PROXY. Если не указано, переменные окружения не будут заменены.<br>Введённое значение передается «как есть», проверка корректности данных не производится.<br>Вы также можете указать адрес SOCKS прокси. Если вы укажете ошибочный протокол, подключение будет неуспешным и элемент данных станет неподдерживаемым.<br>*Обратите внимание*, что для HTTP прокси поддерживается только простая аутентификация.<br>В этом поле можно использовать пользовательские макросы.| |*Переменные*<br>*(Variables)*|Переменные, которые можно использовать в шагах сценария (URL, переменные post).<br>Переменные имеют следующий формат:<br>**{макрос1}**=значение1<br>**{макрос2}**=значение2<br>**{макрос3}**=regex:<регулярное выражение><br>Например:<br>{username}=Alexei<br>{password}=kj3h5kJ34bd<br>{hostid}=regex: hostid is (\[0-9\]+)<br>На эти макросы затем можно ссылаться в шагах сценария в виде {username}, {password} и {hostid}. Zabbix автоматически заменит их на актуальные значения. Обратите внимание, что переменным с `regex:` требуется по крайней мере один шаг, чтобы получить значение из регулярного выражения, поэтому извлечённое значение можно применять только в последующих шагах.<br>Если часть значения начинается с `regex:`, тогда последующая часть обрабатывается как регулярное выражение, которое будет искать указанную часть веб-страницы, и если найдёт, запомнит найденное значение в переменную. Должна присутствовать как минимум одна подгруппа так, чтобы найденные значения можно было извлечь.<br>Поддерживаются пользовательские макросы и [макросы](/manual/appendix/macros/supported_by_location) {HOST.\*}.<br>Переменные автоматически URL кодируются, когда используются в полях запросов или в данных формы для переменных post, но их необходимо вручную URL кодировать, когда они используются в сыром post или напрямую в URL.| |*Заголовки*<br>*(Headers)*|HTTP заголовки, которые будут отправлены при выполнении запроса. Могут использоваться заголовки по умолчанию и пользовательские.<br>Заголовки, использующие настройки по умолчанию, назначаются в зависимости от типа Агента, выбранного из выпадающего списка на уровне сценария, и будут применены ко всем шагам, если только не переопределены пользовательскими на уровне шага.<br>**Следует заметить, что определение заголовка на уровне шага автоматически уничтожает все ранее определённые заголовки, за исключением заголовка «User-Agent» по умолчанию, который назначается при выборе из выпадающего списка на уровне сценария.**<br>Тем не менее, даже заголовок «User-Agent» по умолчанию может быть переопределён путём указания его на уровне шага.<br>Чтобы убрать заголовок, заданный на уровне сценария, следует на уровне шага указать имя заголовка, сопроводив его пустым значением.<br>Заголовки должны быть перечислены, используя тот же синтаксис, как они могут появиться в HTTP протоколе, опционально можно использовать некоторые дополнительные возможности, поддерживаемые опциями cURL [CURLOPT\_HTTPHEADER \[en\]](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html).<br>Например: Accept-Charset: utf-8<br>Accept-Language: en-US<br>Content-Type: application/xml; charset=utf-8<br>Поддерживаются пользовательские макросы и [макросы](/manual/appendix/macros/supported_by_location) {HOST.\*}.| |*Активирован*<br>*(Enabled)*|Сценарий активирован, если параметр отмечен, в противном случае - деактивирован.| Обратите внимание, что при редактировании существующего сценария, в диалоге будут доступны две дополнительные кнопки: | | | |--|--------| | (Клонировать)|Создание другого сценария на основе свойств существующего.| |<br>(Очистить историю и динамику изменений)|Удаление у сценария данных истории и динамики изменений. Эта опция заставит сервер выполнить сценарий сразу после удаления данных.| ::: notetip Если поле *HTTP прокси* оставить пустым, можно воспользоваться другим способом указать HTTP прокси, для этого необходимо задать переменные окружения. Для HTTP проверок — укажите переменную окружения **http\_proxy** для пользователя Zabbix сервера. Например, `http_proxy=http://ip_прокси:порт_прокси`. Для HTTPS проверок — укажите переменную окружения **HTTPS\_PROXY**. Например, `HTTPS_PROXY=http://ip_прокси:порт_прокси`. Более подробную информацию можно получить, выполнив в shell команду *\# man curl*. ::: Вкладка **Шаги (Steps)** позволит вам настроить шаги веб-сценария. Чтобы добавить шаг веб-сценария, нажмите на *Добавить (Add)* в блоке *Шаги (Steps)*. {width="600"} ::: noteclassic В URL не должны использоваться скрытые [пользовательские макросы](/manual/config/macros/user_macros#настройка), так как они будут раскрыты в «\*\*\*\*\*\*». ::: #### 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.| #### Настройка пользовательских графиков Для создания пользовательского графика, сделайте следующее: - Перейдите в *Настройка → Узлы сети (или Шаблоны)* (*Configuration → Hosts* или *Templates*) - Нажмите на *Графики (Graphs)* в строке с желаемым узлом сети или шаблоном - На странице графиков нажмите на *Создать график (Create graph)* - Измените атрибуты графика {width="600"} Все обязательные поля ввода отмечены красной звёздочкой. Атрибуты графика: |Параметр|<|Описание| |-|----------|----------------------------------------| |*Имя*<br>*(Name)*|<|Уникальное имя графика.<br>В этом поле поддерживаются [макросы](/manual/appendix/macros/supported_by_location) выражений, но только с функциями `avg`, `last`, `min` и `max` со временем в качестве параметра (например, `{?avg(/узел сети/ключ,1h)}`).<br>Макросы {HOST.HOST<1-9>} поддерживаются для использования в ранее упомянутых макросах, как ссылки на первый, второй, третий и т.д. узел сети в графике, например: `{?avg(/{HOST.HOST2}/ключ,1h)}`. Обратите внимание, что ссылка на первый узел сети избыточна, так как на первый узел сети можно ссылаться неявно, например: `{?avg(//ключ,1h)}`.| |*Ширина*<br>*(Width)*|<|Ширина графика в пикселях (только при предпросмотре и для кругового/расширенного кругового графиков).| |*Высота* *(Height)*|<|Высота графика в пикселях.| |*Тип графика*<br>*(Graph type)*|<|Тип графика:<br>**Нормальный (Normal)** — нормальный график, значения отображаются линиями<br>**Стекируемый (Stacked)** — стекируемый график, отображаются заполненные области<br>**Круговой (Pie)** — круговой график<br>**Расширенный круговой (Exploded)** — расширенный (фрагментированный) круговой график, части отображаются как «вырезанные» из круга| |*Легенда*<br>*(Show legend)*|<|При выборе этой опции будет отображена легенда графика.| |*Отображать рабочее время*<br>*(Show working time)*|<|Если выбрано, нерабочие часы на графике будут отображаться серым цветом фона. Недоступно для кругового и расширенного кругового графиков.| |*Отображать триггеры*<br>*(Show triggers)*|<|Если выбрано, на графике будут отображаться простые триггеры в виде линий с чёрным пунктиром поверх цвета важности триггера. Недоступно для кругового и расширенного кругового графиков.| |*Процентная линия (слева)*<br>*(Percentile line (left))*|<|Отображение линии процентиля для левой оси Y. Если, например, задан 95-й процентиль, то на графике будет отображена линия процентиля на уровне, под который попадают 95 процентов значений. Отображается светло-зелёной линией. Доступно только для нормальных графиков.| |*Процентная линия (справа)*<br>*(Percentile line (right))*|<|Отображение линии процентиля для правой оси Y. Если, например, задан 95-й процентиль, то на графике будет отображена линия процентиля на уровне, под который попадают 95 процентов значений. Отображается светло-красной линией. Доступно только для нормальных графиков.| |*МИН значение оси Y*<br>*(Y axis MIN value)*|<|Минимальное значение оси Y:<br>**Вычисляемое (Calculated)** — минимальное значение оси Y будет вычисляться автоматически.<br>**Фиксированное (Fixed)** — фиксированное минимальное значение оси Y.<br>**Элемент данных (Item)** — последнее значение выбранного элемента данных будет являться минимальным значением.<br><br>Недоступно для кругового и кругового расширенного графиков.| |*МАКС значение оси Y*<br>*(Y axis MAX value)*|<|Максимальное значение оси Y:<br>**Вычисляемое (Calculated)** — максимальное значение оси Y будет вычисляться автоматически.<br>**Фиксированное (Fixed)** — фиксированное максимальное значение оси Y. <br>**Элемент данных (Item)** — последнее значение выбранного элемента данных будет являться максимальным значением.<br><br>Недоступно для кругового и кругового расширенного графиков.| |*3D вид* *(3D view)*|<|Включение 3D стиля. Только для круговых и расширенных круговых графиков.| |*Элементы данных*<br>*(Items)*|<|Элементы данных, данные которых будут отображаться на этом графике. Нажмите на *Добавить (Add)*, чтобы выбрать элементы данных. Вы также можете выбрать различные опции отображения (функцию, стиль отрисовки, отображение по левой/правой осям, цвет).| |<|*Порядок сортировки (0→100)*<br>*(Sort order)*|Порядок отрисовки. 0 будет обрабатываться в первую очередь. Можно использовать для отрисовки линий или областей позади (или поверх) другой.<br>Можно перетаскивать элементы данных за пиктограмму в начале строки, тем самым изменять порядок сортировки или задать, какие элементы данных должны отображаться поверх остальных.| |^|*Имя*<br>*(Name)*|Имя выбранного элемента данных, в виде ссылки. При нажатии на ссылку откроется список других доступных элементов данных. | |^|*Тип*<br>*(Type)*|Тип (доступен только для кругового и расширенного кругового графиков):<br>**Простой (Simple)** — значение элемента данные отображается пропорционально кругу;<br>**Суммарный график (Graph sum)** — значение элемента данных представляет целый круг.<br>Обратите внимание, что цвет элемента данных с типом «суммарный график» будет виден только у пространства, не занятого «пропорциональными» элементами данных.| |^|*Функция*<br>*(Function)*|Какие значения будут отображаться, когда у элемента данных существует более одного значения на один пиксель по вертикали:<br>**все** — отображение на графике всех возможных значений (минимальное, среднее и максимальное). Обратите внимание, что для коротких периодов этот параметр не действует; только для более длинных периодов, когда увеличивается нагрузка данными на пиксел по вертикали, «все» начинает отображать минимальные, максимальные и средние значения. Эта функция доступна только для *Нормального* типа графиков. Смотрите также: Формирование графиков [из истории / динамики изменений](/manual/config/visualization/graphs/simple#формирование-из-историидинамики-изменений).<br>**сред** — только средние значения<br>**посл** — только последние значения. Эта функция доступна только для *Кругового / Расширенного кругового* типов графиков.<br>**макс** — только максимальные значения<br>**мин** — только минимальные значения| |^|*Стиль отрисовки*<br>*(Draw style)*|Стиль отрисовки, применяемый к данным элемента данных (доступен только для нормальных графиков; для стекируемых графиков всегда используется стиль заполнения области) — *Линия*, *Жирная линия*, *Заполнение*, *Точечная линия*, *Пунктирная линия*, *Градиентная линия* (*Line*, *Bold line*, *Filled region*, *Dot*, *Dashed line*, *Gradient line*). | |^|*Расположение оси Y*<br>*(Y axis side)*|С какой стороны отображать ось Y для элемента — *Слева*, *Справа*.| |^|*Цвет* *(Color)*|Цвет, применяемый к данным элемента данных.| #### 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. #### Настройка JMX интерфейсов и элементов данных в веб-интерфейсе Zabbix Когда Java Gateway запущен, сервер знает, где его искать, и Java приложение запущено с поддержкой удалённого JMX мониторинга, самое время настроить интерфейсы и элементы данных в веб-интерфейсе Zabbix. ##### Configuring JMX interface You begin by creating a JMX-type interface on the host of interest. {width="600"} All mandatory input fields are marked with a red asterisk. ##### Настройка JMX интерфейса Начнём с создания интерфейса типа JMX у интересующего узла сети. {width="600"} Все обязательные поля ввода отмечены красной звёздочкой. #### 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 low-level discovery We will illustrate low-level discovery based on an example of file system discovery. To configure the discovery, do the following: - Go to: *Configuration* → *Templates* or *Hosts* - Click on *Discovery* in the row of an appropriate template/host {width="600"} - Click on *Create discovery rule* in the upper right corner of the screen - Fill in the discovery rule form with the required details ### Настройка низкоуровневого обнаружения Мы проиллюстрируем низкоуровневое обнаружение на примере обнаружения файловых систем. Для настройки обнаружения, выполните следующее: - Перейдите в: *Настройка* → *Шаблоны* или *Узлы сети* (*Configuration* → *Templates* или *Hosts*) - Нажмите на *Обнаружение (Discovery)* в строке с соответствующим шаблоном / узлом сети {width="600"} - Нажмите на *Создать правило обнаружения (Create discovery rule)* в верхнем правом углу экрана - Заполните диалог правила обнаружения необходимыми деталями #### 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#создание-шаблона) - Найти поле *Шаблоны (Templates)* - Нажать на *Выбрать (Select)*, чтобы открыть всплывающее окно *Шаблоны* - В этом всплывающем окне выбрать требуемые шаблоны, затем нажать на *Выбрать* для добавления этих шаблонов в список - Нажать на *Добавить (Add)* или *Обновить (Update)* в диалоге настройки шаблона Таким образом, все объекты родительского шаблона, а также все объекты присоединённых шаблонов (такие как элементы данных, триггеры, графики и т.п.) теперь отобразятся в настройке шаблона, за исключением панелей с присоединённого шаблона, которые, тем не менее, будут всё же унаследованы узлами сети. Для отсоединения любого из присоединённых шаблонов воспользуйтесь в этом же диалоге кнопками *Отсоединить (Unlink)* или *Отсоединить и очистить (Unlink and clear)* и нажмите *Обновить (Update)*. Опция *Отсоединить* просто удалит связь с шаблоном, но оставит все его объекты (элементы данных, триггеры, графики и т.п.). Опция *Отсоединить и очистить* удалит как связь с присоединённым шаблоном, так и все его объекты (элементы данных, триггеры, графики и т.п.). ##### 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 perl do "[FULL PATH TO PERL RECEIVER SCRIPT]"; ``` - configure the receiver, e.g: ```ini $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:<br><br> ```yaml 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) можно использовать для передачи трапов Zabbix серверу напрямую с snmptrapd. Для его настройки: - добавьте Perl скрипт в файл конфигурации snmptrapd (snmptrapd.conf), например: ```perl perl do "[АБСОЛЮТНЫЙ ПУТЬ К PERL СКРИПТУ-ПОЛУЧАТЕЛЮ]"; ``` - настройте сам получатель, например: ```ini $SNMPTrapperFile = '[TRAP ФАЙЛ]'; $DateTimeFormat = '[ФОРМАТ ДАТЫ/ВРЕМЕНИ]'; ``` ::: notetip Если имя скрипта не заключено в кавычки, snmptrapd откажется запускаться с сообщениями наподобие этих: ```yaml 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. A typical plugin parameter has the following structure: *Plugins.<PluginName>.<Parameter>=<Value>* Additionally, there are two specific groups of parameters: - *Plugins.<PluginName>.Default.<Parameter>=<Value>* used for defining [default parameter values](#default-values). - *Plugins.<PluginName>.<SessionName>.<Parameter>=<Value>* used for defining separate sets of parameters for different monitoring targets via [named sessions](#named-sessions). All 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.\**, который может быть как частью [файла конфигурации](/manual/appendix/config/zabbix_agent2) Zabbix агента 2, так и частью [файла конфигурации](/manual/appendix/config/zabbix_agent2_plugins) самого плагина . Если плагин использует отдельный файл конфигурации, путь к этому файлу необходимо указать в параметре Include файла конфигурации Zabbix агента 2. Каждый параметр плагина должен иметь следующую структуру: *Plugins.<ИмяПлагина>.<Параметр>=<Значение>* Кроме того, есть две специфичные группы параметров: - *Plugins.<ИмяПлагина>.Default.<Параметр>=<Значение>* используется для определения [значений параметров по умолчанию](#значения-по-умолчанию). - *Plugins.<ИмяПлагина>.<ИмяСессии>.<Параметр>=<Значение>* используется для определения отдельных наборов параметров для различных целей мониторинга через [именованные сессии](#именованные-сессии). Все имена параметров должны соответствовать следующим требованиям: - рекомендуется начинать названия ваших плагинов с заглавной буквы; - параметр должен начинаться с заглавной буквы; - специальные символы не разрешены; - количество вложенных уровней не ограничено; - количество параметров не ограничено. #### 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 для соединения сервер - активный прокси (пример) На хосте прокси запишите значение общего ключа в файл, например, `/home/zabbix/zabbix_proxy.psk`. Этот файл должен содержать ключ в первой строке текста, например: e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9 Задайте права доступа к PSK файлу — он должен быть доступен для чтения только пользователю Zabbix. Измените параметры TLS в файле конфигурации `zabbix_proxy.conf`; например, задайте: TLSConnect=psk TLSPSKFile=/home/zabbix/zabbix_proxy.psk TLSPSKIdentity=PSK 002 Прокси будет подключаться к серверу, используя общий ключ. Идентификатором общего ключа будет «PSK 002». (Чтобы свести к минимуму время простоя, смотрите как изменить тип подключения в [Управлении зашифрованными соединениями](/manual/encryption#управление-зашифрованными-соединениями)). Настройте общий ключ для этого прокси в веб-интерфейсе Zabbix. Перейдите на *Администрирование → Прокси (Administration→Proxies)*, выберите прокси, перейдите на вкладку «Шифрование (Encryption)». Переключите «Соединения с прокси (Connections from proxy)» на `PSK`. Вставьте в поле «Идентификатор PSK (PSK identity)» значение «PSK 002» и «e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9» в поле «PSK». Нажмите «Обновить (Update)». Перезапустите прокси. Он начнет использовать зашифрованные соединения к серверу на основе общего ключа. Проверьте файлы журналов сервера и прокси на предмет сообщений об ошибках. В случае пассивных прокси процедура очень похожа. Разница лишь в том, что в файле конфигурации прокси необходимо задать `TLSAccept=psk` и переключить «Подключения к прокси (Connections to proxy)» в 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`. Этот файл должен содержать общий ключ в первой строке текста, например: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 Задайте права доступа к PSK файлу — он должен быть доступен для чтения только пользователю Zabbix. Измените параметры TLS в файле конфигурации `zabbix_agentd.conf`; например, выставьте: TLSConnect=psk TLSAccept=psk TLSPSKFile=/home/zabbix/zabbix_agentd.psk TLSPSKIdentity=PSK 001 Агент будет подключаться к серверу (активные проверки) и принимать от сервера и `zabbix_get` только те соединения, которые используют общий ключ. Идентификатором ключа будет «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?&#управление-зашифрованными-соединениями)). Настройте для этого агента шифрование с общим ключом в веб-интерфейсе Zabbix. - Перейдите к: *Настройка → Узлы сети (Configuration → Hosts)* - Выберите узел сети и нажмите на вкладку **Шифрование (Encryption)** Пример:  Все обязательные поля ввода отмечены красной звёздочкой. Когда кэш конфигурации синхронизируется с базой данных, новые подключения будут использовать общий ключ. Проверьте файлы журналов сервера и агента на предмет сообщений об ошибках. #### 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 gateway Когда Java gateway запущен и работает, вы должны указать Zabbix серверу где найти Zabbix Java gateway. Это делается, задавая параметры JavaGateway и JavaGatewayPort в [файле конфигурации сервера](/manual/appendix/config/zabbix_server). Если же узел сети, на котором работает приложение JMX, наблюдается через Zabbix прокси, то параметры соединения вместо этого указываются в [файле конфигурации прокси](/manual/appendix/config/zabbix_proxy). JavaGateway=192.168.3.14 JavaGatewayPort=10052 По умолчанию, сервер нe запускает процессы, связанные с мониторингом 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 gateway Когда Java gateway запущен и работает, вы должны указать Zabbix серверу где искать Zabbix Java gateway. Чтобы это сделать, укажите параметры JavaGateway и JavaGatewayPort в [файле конфигурации сервера](/manual/appendix/config/zabbix_server). Если же узел сети, на котором работает JMX приложение, наблюдается через Zabbix прокси, то параметры соединения указываются в [файле конфигурации прокси](/manual/appendix/config/zabbix_proxy). JavaGateway=192.168.3.14 JavaGatewayPort=10052 По умолчанию, сервер нe запускает процессы связанные с мониторингом 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 gateway Когда Java gateway запущен и работает, вы должны указать Zabbix серверу, где найти Zabbix Java gateway. Чтобы это сделать, задайте параметры JavaGateway и JavaGatewayPort в [файле конфигурации сервера](/manual/appendix/config/zabbix_server). Если же узел сети, на котором работает приложение JMX, наблюдается через Zabbix прокси, то параметры соединения вместо этого указываются в [файле конфигурации прокси](/manual/appendix/config/zabbix_proxy). JavaGateway=192.168.3.14 JavaGatewayPort=10052 По умолчанию, сервер нe запускает процессы, связанные с мониторингом 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 gateway Когда Java gateway запущен и работает, вы должны указать Zabbix серверу, где искать Zabbix Java gateway. Чтобы это сделать, укажите параметры JavaGateway и JavaGatewayPort в [файле конфигурации сервера](/manual/appendix/config/zabbix_server). Если же узел сети, на котором работает JMX приложение, наблюдается через Zabbix прокси, то параметры соединения указываются в [файле конфигурации прокси](/manual/appendix/config/zabbix_proxy). JavaGateway=192.168.3.14 JavaGatewayPort=10052 По умолчанию, сервер нe запускает процессы, связанные с мониторингом 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 интерфейс для вашего узла сети В разделе *Настройка → Узлы сети (Configuration → Hosts)* создайте/отредактируйте узел сети, и в поле *Интерфейсы (Interfaces)* добавьте интерфейс с типом «SNMP», указывая IP или DNS адрес.<br><br>Адрес из каждого полученного трапа сравнивается с IP и DNS адресами всех SNMP интерфейсов для поиска подходящих узлов сети. 2\. Настройте элемент данных - В разделе *Настройка → Узлы сети (Configuration → Hosts)* создайте/отредактируйте нужный элемент данных. - В поле *Ключ (Key)* используйте один из ключей SNMP трапов: |Ключ|<|<| |--|--|------| |Описание|Возвращаемое значение|Комментарии| |**snmptrap**\[регулярное выражение\]|<|<| |Отлов всех SNMP трапов, которые соответствуют [регулярному выражению](/manual/regular_expressions), указанному в поле **регулярное выражение**. Если регулярное выражение не указано, принимаются все трапы.|SNMP трап|Этот элемент данных можно привязать только к SNMP интерфейсам.<br>В параметре этого ключа элемента данных поддерживаются пользовательские макросы и глобальные регулярные выражения.| |**snmptrap.fallback**|<|<| |Отлов всех SNMP трапов, которые не были перехвачены ни одним из элементов данных snmptrap\[\] для этого интерфейса.|SNMP трап|Такой элемент данных можно привязать только к SNMP интерфейсам.| ::: noteclassic Многострочное совпадение по регулярному выражению в данный момент времени не поддерживается. ::: - Для обработки штампов времени выставьте *Тип информации (Type of information)* в значение «Журнал (лог)». Другие форматы, такие как «Числовой», также приемлемы, но для этого может потребоваться пользовательский обработчик трапов. ##### 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: ```ini net_snmp_perl_enable = 1 ``` 2. log traps to the trap file which will be read by Zabbix: ```ini log_enable = 1 log_file = [TRAP FILE] ``` 3. set the date-time format: ```ini date_time_format = %H:%M:%S %Y/%m/%d ``` ::: 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.: ```ini 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:<br><br> ```ini EVENT general .* "General event" Normal ``` ::: ##### Настройка SNMPTT Для начала, snmptrapd необходимо настроить на использование SNMPTT. ::: notetip Для лучшей производительности, SNMPTT нужно сконфигурировать как демон, используя **snmptthandler-embedded** для передачи ему трапов. Смотрите инструкции по [настройке SNMPTT](http://snmptt.sourceforge.net/docs/snmptt.shtml). ::: Когда SNMPTT настроен на получение трапов, настройте `snmptt.ini`: 1. включите использование модуля Perl из пакета NET-SNMP: ```ini net_snmp_perl_enable = 1 ``` 2. включите журналирование трапов в файл с трапами, который будет читаться Zabbix'ом: ```ini log_enable = 1 log_file = [TRAP ФАЙЛ] ``` 3. задайте формат даты/времени: ```ini 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-трапы). ::: Теперь задайте формат трапов, чтобы они распознавались Zabbix'ом (отредактируйте snmptt.conf): 1. Каждая инструкция FORMAT должна начинаться с "ZBXTRAP \[адрес\]", где \[адрес\] будет сравниваться с IP и DNS адресами у SNMP интерфейсов в Zabbix. Например: ```ini 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:<br><br> ```ini EVENT general .* "General event" Normal ``` ::: #### Configuring steps {width="600"} Step parameters: |Parameter|Description| |--|--------| |*Name*|Unique step name.<br>[User macros](/manual/config/macros/user_macros) are supported. *Note* that if user macros are used, these macros will be left unresolved in [web monitoring item](/manual/web_monitoring/items) names.| |*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"} Параметры шага: |Параметр|Описание| |--|--------| |*Имя*<br>*(Name)*|Уникальное имя шага.<br>Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros). *Обратите внимание* что если используется пользовательские макросы, то эти макросы останутся нераскрытыми в именах [элементов данных веб-мониторинга](/manual/web_monitoring/items).| |*URL*|URL для подключения и получения данных. Например:<br>https://www.example.com<br>http://www.example.com/download<br>Имена доментов можно указывать Юникод символами. Они автоматически конвертируются методом punycode в ASCII при выполнении шага веб-сценария.<br>Кнопку *Анализ* можно использовать, чтобы отделить из URL опциональные поля запроса (например, ?name=Admin&password=mypassword), переместив атрибуты и значения в *Поля запроса*, чтобы URL кодировка выполнялась автоматически.<br>Переменные можно использовать в URL, воспользовавшись синтаксисом {макрос}. Переменные можно URL кодировать вручную, используя {{macro}.urlencode()} синтаксис.<br>Поддерживаются пользовательские макросы и [макросы](/manual/appendix/macros/supported_by_location) {HOST.\*}.<br>Ограничено 2048 символами.| |*Поля запроса*<br>*(Query fields)*|Переменные HTTP GET для URL.<br>Задаются в виде пар атрибутов и значений.<br>Значения URL кодируются автоматически. Значения из переменных сценария, пользовательских макросов или макросов {HOST.\*} раскрываются и затем URL кодируются автоматически. При использовании {{макрос}.urlencode()} синтаксиса будет выполнена двойная URL кодировка этих переменных.<br>Поддерживаются пользовательские макросы и {HOST.\*} [макросы](/manual/appendix/macros/supported_by_location).| |*Post*|Переменные HTTP POST.<br>В режиме **Данные формы** задаются в виде пар атрибутов и значений.<br>Значения URL кодируются автоматически. Значения из переменных сценария, пользовательских макросов или {HOST.\*} макросов раскрываются и затем URL кодируются автоматически.<br>В режиме **Сырые данные** атрибуты/значения отображаются в одной строке и объединяются через символ **&**.<br>Сырые значения можно URL кодировать/декодировать вручную, используя синтаксис {{макрос}.urlencode()} или {{макрос}.urldecode()}.<br>Например: id=2345&userid={user}<br>Если {user} задан переменной на уровне веб-сценария, он будет заменён своим значением при выполнении шага. Если вы желаете URL кодировать значение, замените {user} на {{user}.urlencode()}.<br>Поддерживаются пользовательские макросы и [макросы](/manual/appendix/macros/supported_by_location) {HOST.\*}.| |*Переменные*<br>*(Variables)*|Список переменных на уровне шага, которые можно использовать в GET и POST функциях.<br>Задаются в виде пар атрибутов и значений.<br>Переменные на уровне шага переопределяют переменные уровня сценария и переменные из предыдущих шагов. Однако, значение переменной уровня шага влияет только на последующие шаги (а не на текущий шаг).<br>Такие переменные имеют следующий формат:<br>**{макрос}**=значение<br>**{макрос}**=regex:<регулярное выражение><br>Более подробную информацию вы найдете в описании переменных уровня [сценария](web_monitoring#настройка_веб_сценария).<br>Переменные автоматически URL кодируются, когда используются в полях запросов или в данных формы для переменных post, но их необходимо вручную URL кодировать, когда они используются в сыром post или напрямую в URL.| |*Заголовки*<br>*(Headers)*|Пользовательские HTTP заголовки, которые будут отправлены при выполнении запроса.<br>Задаются в виде пар атрибутов и значений.<br>Заголовок, заданный на уровне шага, будет использоваться для этого конкретного шага.<br>**Следует заметить, что при задании заголовка на уровне шага автоматически уничтожаются все ранее заданные заголовки, за исключением заголовков «User-Agent» по умолчанию, назначенных при выборе из выпадающего списка на уровне сценария.**<br>Тем не менее, даже заголовок «User-Agent» по умолчанию может быть переопределён путём назначения ему значения на уровне шага.<br>Например, если указать имя заголовка без указания значения, то это удалит заголовок по умолчанию, указанный на уровне сценария.<br>Поддерживаются пользовательские макросы и макросы {HOST.\*}.<br>Это поле задаёт опцию cURL [CURLOPT\_HTTPHEADER \[en\]](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html).<br>Возможность указать пользовательские заголовки поддерживается, *начиная с Zabbix 2.4*.| |*Следовать перенаправлениям*<br>*(Follow redirects)*|Отметьте для следования по HTTP перенаправлениям.<br>Этот параметр использует опцию cURL [CURLOPT\_FOLLOWLOCATION \[en\]](http://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html).| |*Режим получения*<br>*(Retrieve mode)*|Выберите режим получения:<br>**Тело** — получение только тела из HTTP ответа<br>**Заголовки** — получение только заголовков из HTTP ответа<br>**Тело и заголовки** — получение тела и заголовков из HTTP ответа| |*Время ожидания*<br>*(Timeout)*|Zabbix не будет тратить более указанного времени при обработке URL (от 1 секунды до максимум 1 часа). В действительности же этот параметр определяет максимальное время содания подключения к URL и максимальное время для выполнения HTTP запроса. Следовательно, Zabbix не будет тратить более **2 x Время ожидания** секунд на один шаг.<br>Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например, 30s, 1m, 1h.<br>Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros).| |*Требуемая строка*<br>*(Required string)*|Требуемый шаблон регулярных выражений.<br>Если полученное содержимое (HTML) не совпадает с требуемым шаблоном, то шаг будет считаться ошибочным. Если поле не заполнено, то проверка не производится.<br>Например:<br>Homepage of Zabbix<br>Welcome.\*admin<br>*Обратите внимание*: Ссылки на [регулярные выражения](regular_expressions), созданные в веб-интерфейсе Zabbix, в этом поле не поддерживаются.<br>Поддерживаются пользовательские макросы и [макросы](/manual/appendix/macros/supported_by_location) {HOST.\*}.| |*Требуемые коды состояния*<br>*(Required status codes)*|Список ожидаемых кодов состояния HTTP. Если Zabbix получает код не из списка, то шаг будет считаться ошибочным.<br>Если поле не заполнено, то проверка не производится.<br>Например: 200,201,210-299.<br>Поддердживаются пользовательские макросы.| ::: noteclassic Любые изменения в шагах веб-сценариев будут сохранены, только если сам сценарий был также сохранён. ::: Смотрите также [пример из реальной жизни](/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). #### Настройка тегов Вкладка **Теги (Tags)** позволяет задать [теги](/manual/config/tagging) уровня сценария.  Теги позволяют фильтровать веб-сценарии и [элементы данных](/manual/web_monitoring/items) веб-мониторинга. #### Configuring TLS Certificate signed by a certificate authority (CA) should be added to the default CA store. Alternatively a custom CA store location can be specified using the SSLCALocation configuration parameter; note that in this case the certificate directory must be prepared using the openssl c\_rehash utility, for example configure SSLCALocation and copy "ca.pem" inside that directory, then run the following command: c_rehash . #### Настройка TLS Сертификат, подписанный центром сертификации (certificate authority, CA), нужно добавить в хранилище CA по умолчанию. В качестве альтернативы можно указать собственное расположение хранилища центров сертификации в параметре конфигурации SSLCALocation; обратите внимание, что в этом случае директория сертификатов должна быть подготовлена при помощи openssl утилиты c\_rehash; например, настройте SSLCALocation и скопируйте «ca.pem» внутрь этой директории, а затем выполните следующую команду: c_rehash . #### Configuring unixODBC ODBC configuration is done by editing the **odbcinst.ini** and **odbc.ini** files. To verify the configuration file location, type: odbcinst -j **odbcinst.ini** is used to list the installed ODBC database drivers: [mysql] Description = ODBC for MySQL Driver = /usr/lib/libmyodbc5.so Parameter details: |Attribute|Description| |--|--------| |*mysql*|Database driver name.| |*Description*|Database driver description.| |*Driver*|Database driver library location.| **odbc.ini** is used to define data sources: [test] Description = MySQL test database Driver = mysql Server = 127.0.0.1 User = root Password = Port = 3306 Database = zabbix Parameter details: |Attribute|Description| |--|--------| |*test*|Data source name (DSN).| |*Description*|Data source description.| |*Driver*|Database driver name - as specified in odbcinst.ini| |*Server*|Database server IP/DNS.| |*User*|Database user for connection.| |*Password*|Database user password.| |*Port*|Database connection port.| |*Database*|Database name.| To verify if ODBC connection is working successfully, a connection to database should be tested. That can be done with the **isql** utility (included in the unixODBC package): isql test +---------------------------------------+ | Connected! | | | | sql-statement | | help [tablename] | | quit | | | +---------------------------------------+ #### Настройка unixODBC Настройка ODBC выполняется путём редактирования файлов **odbcinst.ini** и **odbc.ini**. Для проверки местоположения этих файлов введите: odbcinst -j **odbcinst.ini** используется для перечисления установленных драйверов баз данных ODBC: [mysql] Description = ODBC for MySQL Driver = /usr/lib/libmyodbc5.so Подробная информация: |Атрибут|Описание| |--|--------| |*mysql*|Имя драйвера базы данных.| |*Description*|Описание драйвера базы данных.| |*Driver*|Местоположение библиотеки драйвера базы данных.| **odbc.ini** используется для определения источников данных: [test] Description = MySQL test database Driver = mysql Server = 127.0.0.1 User = root Password = Port = 3306 Database = zabbix Подробная информация: |Атрибут|Описание| |--|--------| |*test*|Имя источника данных (DSN).| |*Description*|Описание источника данных.| |*Driver*|Имя драйвера базы данных — как указано в odbcinst.ini| |*Server*|IP/DNS сервера базы данных.| |*User*|Пользователь базы данных для подключения.| |*Password*|Пароль пользователя базы данных.| |*Port*|Порт подключения к базе данных.| |*Database*|Имя базы данных.| Для проверки, успешно ли работает соединение ODBC, подключение к базе данных необходимо протестировать. Для этого можно воспользоваться утилитой **isql** (включена в пакет unixODBC): isql test +---------------------------------------+ | Connected! | | | | sql-statement | | help [tablename] | | quit | | | +---------------------------------------+ ##### 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 ФАЙЛ] ``` ::: 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.0/Dockerfiles/snmptraps/alpine/conf/usr/sbin/zabbix_trap_handler.sh) получателя трапов для передачи трапов Zabbix серверу напрямую с snmptrapd. Чтобы его настроить, добавьте опцию `traphandle` в файл конфигурации (`snmptrapd.conf`) snmptrapd, смотрите [пример](https://raw.githubusercontent.com/zabbix/zabbix-docker/6.0/Dockerfiles/snmptraps/alpine/conf/etc/snmp/snmptrapd.conf). #### Connection encryption management Connections in Zabbix can use: - no encryption (default) - [RSA certificate-based encryption](/manual/encryption/using_certificates) - [PSK-based encryption](/manual/encryption/using_pre_shared_keys) There are two important parameters used to specify encryption between Zabbix components: - TLSConnect - specifies what encryption to use for outgoing connections (unencrypted, PSK or certificate) - TLSAccept - specifies what types of connections are allowed for incoming connections (unencrypted, PSK or certificate). One or more values can be specified. `TLSConnect` is used in the configuration files for Zabbix proxy (in active mode, specifies only connections to server) and Zabbix agent (for active checks). In Zabbix frontend the TLSConnect equivalent is the *Connections to host* field in *Configuration → Hosts → <some host> → Encryption* tab and the *Connections to proxy* field in *Administration → Proxies → <some proxy> → Encryption* tab. If the configured encryption type for connection fails, no other encryption types will be tried. `TLSAccept` is used in the configuration files for Zabbix proxy (in passive mode, specifies only connections from server) and Zabbix agent (for passive checks). In Zabbix frontend the TLSAccept equivalent is the *Connections from host* field in *Configuration → Hosts → <some host> → Encryption* tab and the *Connections from proxy* field in *Administration → Proxies → <some proxy> → Encryption* tab. Normally you configure only one type of encryption for incoming connections. But you may want to switch the encryption type, e.g. from unencrypted to certificate-based with minimum downtime and rollback possibility. To achieve this: - Set `TLSAccept=unencrypted,cert` in the agent configuration file and restart Zabbix agent - Test connection with zabbix\_get to the agent using certificate. If it works, you can reconfigure encryption for that agent in Zabbix frontend in the *Configuration → Hosts → <some host> → Encryption* tab by setting *Connections to host* to "Certificate". - When server configuration cache gets updated (and proxy configuration is updated if the host is monitored by proxy) then connections to that agent will be encrypted - If everything works as expected you can set `TLSAccept=cert` in the agent configuration file and restart Zabbix agent. Now the agent will be accepting only encrypted certificate-based connections. Unencrypted and PSK-based connections will be rejected. In a similar way it works on server and proxy. If in Zabbix frontend in host configuration *Connections from host* is set to "Certificate" then only certificate-based encrypted connections will be accepted from the agent (active checks) and zabbix\_sender (trapper items). Most likely you will configure incoming and outgoing connections to use the same encryption type or no encryption at all. But technically it is possible to configure it asymmetrically, e.g. certificate-based encryption for incoming and PSK-based for outgoing connections. Encryption configuration for each host is displayed in the Zabbix frontend, in *Configuration → Hosts* in the *Agent encryption* column. For example: |Example|Connections to host|Allowed connections from host|Rejected connections from host| |-------|-------------------|-------------------|-------------------| ||Unencrypted|Unencrypted|Encrypted, certificate and PSK-based encrypted| ||Encrypted, certificate-based|Encrypted, certificate-based|Unencrypted and PSK-based encrypted| ||Encrypted, PSK-based|Encrypted, PSK-based|Unencrypted and certificate-based encrypted| ||Encrypted, PSK-based|Unencrypted and PSK-based encrypted|Certificate-based encrypted| ||Encrypted, certificate-based|Unencrypted, PSK or certificate-based encrypted|\-| ::: noteimportant Connections are unencrypted by default. Encryption must be configured for each host and proxy individually. ::: #### Управление зашифрованными соединениями Соединения в Zabbix могут использовать: - отсутствие шифрования (по умолчанию) - [шифрование RSA на основе сертификатов](/manual/encryption/using_certificates) - [шифрование на основе PSK](/manual/encryption/using_pre_shared_keys) Имеется два важных параметра, которые используются, чтобы указать шифрование между компонентами Zabbix: - TLSConnect — указывает, какое шифрование использовать для исходящих соединений (unencrypted, PSK или certificate); - TLSAccept — указывает, какие виды соединений разрешены для входящих соединений (unencrypted, PSK или certificate). Можно указать одно или несколько значений. `TLSConnect` используется в файлах конфигурации Zabbix прокси (в активном режиме, задаёт только подключения к серверу) и Zabbix агентов (для активных проверок). В веб-интерфейсе Zabbix эквивалентом параметру TLSConnect является поле *Подключения к узлу сети* на вкладке *Настройка → Узлы сети → <какой-то узел сети> → Шифрование (Configuration → Hosts → <somehost> → Encryption)* и поле *Подключения к прокси (Connections to proxy)* на вкладке *Администрирование → Прокси → <какой-то прокси> → Шифрование (Administration → Proxies → <some proxy> → Encryption)*. Если настроенный тип шифрования для соединения завершится неудачей, другие типы шифрования не будут опробованы `TLSAccept` используется в файлах конфигурации Zabbix прокси (в пассивном режиме, задаёт только соединения от сервера) и Zabbix агента (для пассивных проверок). В веб-интерфейсе Zabbix эквивалентом параметра TLSAccept является поле *Соединения с узла сети (Connections from host)* на вкладке *Настройка → Узлы сети → <какой-то узел сети> → Шифрование (Configuration → Hosts → <somehost> → Encryption)* и поля *Соединения с прокси (Connections from proxy)* на вкладке *Администрирование → Прокси → <какой-то прокси> → Шифрование (Administration → Proxies → <some proxy> → Encryption)*. Как правило, вы настраиваете только один тип шифрования для входящих подключений. Но вы можете захотеть переключить режим шифрования, например, с незашированного на основанный на сертификатах с минимальным временем простоя и с возможностью отката. Чтобы достичь этого: - Выставьте `TLSAccept=unencrypted,cert` в файле конфигурации агента Zabbix и перезапустите агента. - Проверьте подключение от zabbix\_get к агенту с использованием сертификата. Если подключение работает, вы можете перенастроить шифрование у этого агента в веб-интерфейсе Zabbix на вкладке *Настройка → Узлы сети → <какой-то узел сети> → Шифрование (Configuration → Hosts → <some host> →Encryption)*, переключив настройку *Подключения к узлу сети (Connections to host)* на «Сертификат (Certificate)». - Когда кэш конфигурации сервера обновится (и обновится конфигурация прокси, если узел сети наблюдается через прокси), тогда подключения к этому агенту будут зашифрованными. - Если всё работает как ожидается, вы можете задать `TLSAccept=cert` в файле конфигурации агента и перезапустить Zabbix агента. Теперь агент будет принимать только зашифрованные подключения на основе сертификатов. Незашифрованные и основанные на PSK подключения будут отклонены. Шифрование на сервере и прокси работает аналогичным образом. Если в веб-интерфейсе Zabbix в настройке узла сети *Соединения с узла сети (Connections from host)* задано равным «Сертификат (Certificate)», тогда от агента (активные проверки) и zabbix\_sender (траппер элементы данных) будут приниматься только зашифрованные соединения на основе сертификатов. Скорее всего, вы настроите входящие и исходящие соединения на использование одного типа шифрования или без шифрования вовсе. Но, технически, имеется возможность настроить шифрование асимметрично, например, шифрование на основе сертификатов для входящих подключений и на основе PSK для исходящих подключений. Настройки шифрования по каждому узлу сети отображаются в веб-интерфейсе Zabbix *Настройка→Узлы сети (Configuration → Hosts)*, в столбце *Шифрование агента (Agent encryption)*. Примеры отображения настроек: |Пример|Подключения К узлу сети|Разрешённые подключения ОТ узла сети|Отклонённые подключения С узла сети| |-------|-------------------|-------------------|-------------------| ||Незашифровано|Незашифровано|Зашифровано, на основе сертификата и PSK| ||Зашифровано на основе сертификата|Зашифровано на основе сертификата|Незашифровано и зашифровано на основе PSK| ||Зашифровано на основе PSK|Зашифровано на основе PSK|Незашифровано и зашифровано на основе сертификата| ||Зашифровано на основе PSK|Незашифровано и зашифровано на основе PSK|Зашифровано на основе сертификата| ||Зашифровано на основе сертификата|Незашифровано, зашифровано на основе PSK или зашифровано на основе сертификата|\-| ::: noteimportant По умолчанию используются незашифрованные подключения. Шифрование необходимо настраивать по каждому узлу сети и прокси отдельно. ::: ### Connection options for Oracle plugin 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 Плагин Oracle, который поддерживается для Zabbix агента 2, теперь позволяет указать опцию логина `as sysdba`, `as sysoper` или `as sysasm`. Эта опция может быть добавлена либо к параметру <пользователь> ключа элемента данных, либо к параметру конфигурации плагина Plugins.Oracle.Sessions.<ИмяСессии>.User в формате `user as sysdba` (опция логина чувствительна к регистру; не должна завершаться пробелом). ### 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 поддерживает два вида идентификаторов соединений (методов подключения): - Лёгкое подключение (Easy Connect) - Имя сетевой службы (Net Service Name) Параметры настроек соединения для Zabbix сервера и Zabbix прокси могут быть заданы в их файлах конфигурации. Важнейшими параметрами для сервера и прокси являются *DBHost*, *DBUser*, *DBName* и *DBPassword*. Те же параметры являются важными и для веб-интерфейса: *$DB\["SERVER"\]*, *$DB\["PORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*, *$DB\["PASSWORD"\]*. Zabbix использует следующий синтактис строки подключения (connection string): {DBUser/DBPassword[@<connect_identifier>]} <connect\_identifier> может быть указан либо в формате "Net Service Name", либо "Easy Connect". @[[//]Host[:Port]/<service_name> | <net_service_name>] ##### Connections Some plugins support gathering metrics from multiple instances simultaneously. Both local and remote instances can be monitored. TCP and Unix-socket connections are supported. It is recommended to configure plugins to keep connections to instances in an open state. The benefits are reduced network congestion, latency, and CPU and memory usage due to the lower number of connections. The client library takes care of this. ::: notetip Time period for which unused connections should remain open can be determined by *Plugins.<PluginName>.KeepAlive* parameter.<br> Example: *Plugins.Memcached.KeepAlive* ::: ##### Соединения Некоторые плагины поддерживают сбор метрик с нескольких экземпляров одновременно. Можно наблюдать как локальные, так и удаленные экземпляры. Поддерживаются TCP и Unix-сокет соединения. Рекомендуется настроить плагины так, чтобы они соединения с экземплярами поддерживали в открытом состоянии. Преимущества - снижение перегрузок в сети, сокращение задержек и использование меньшего объема CPU и памяти из-за меньшего количества соединений. Клиентская библиотека позаботится об этом. ::: notetip Период времени, в течение которого неиспользуемые соединения должны оставаться открытыми, можно задать параметром *Plugins.<ИмяПлагина>.KeepAlive*.<br> Например: *Plugins.Memcached.KeepAlive* ::: #### 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. #### Введена согласованность в контрольных суммах sha256 элементов данных vfs.file.cksum В прежних версиях Zabbix элемент данных [`vfs.file.cksum`](/manual/config/items/itemtypes/zabbix_agent#данные-виртуальных-файловых-систем) агента Zabbix выдавал различные контрольные суммы sha256 для одного и того же файла в зависимости от платформы (архитектуры процессора) — суммы sha256 на AIX, HP-UX (Itanium) и Solaris (SPARC) отличались от сумм, произведённых на платформах Intel x86-64. Эта проблема теперь исправлена; однако, после обновления мониторинг контрольных сумм sha256 файлов на AIX, HP-UX или Solaris SPARC может привести к ложному обнаружению изменённых файлов. #### 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 агент», веб-сценарии, веб-проверки и элементы данных JavaScript были доработаны, чтобы конвертировать в UTF-8 из набора символов, указанного в заголовке HTTP либо теге meta HTTP. #### 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 на два узла сети. Запрос: ```json { "jsonrpc": "2.0", "method": "discoveryrule.copy", "params": { "discoveryids": [ "27426" ], "hostids": [ "10196", "10197" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```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 #### Копирование и вставка страниц Страницы панели можно скопировать и вставить (copy/paste), что позволяет создать новую страницу со свойствами существующей. Можно вставить страницы из той же самой или другой панели. Чтобы вставить существующую страницу на панель, сначала скопируйте её, используя [меню страниц](#меню-страниц):  Для вставки скопированной страницы: - убедитесь, что панель находится в [режиме редактирования](#просмотр-и-редактирование-панели) - нажмите на стрелку рядом с кнопкой *Добавить* (*Add*) и выберите опцию *Вставить страницу* (*Paste page*) #### 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). #### Копирование и вставка виджетов Для виджетов панели можно использовать технологию copy/paste (копирование и вставка), что позволяет создавать новый виджет со свойствами уже существующего. Виджеты можно копировать таким образом как в пределах той же панели, так и между панелями, открытыми в различных вкладках баузера. Виджет может быть скопирован, используя [меню виджетов](#меню-виджетов). Чтобы вставить виджет: - нажмите на стрелку рядом с кнопкой *Добавить* и выберите опцию *Вставить виджет*, при редактировании панели - используйте опцию *Вставить виджет* при добавлении нового виджета путём выбора некоторой области на панели (чтобы опция вставки была доступна, сначала виджет должен быть скопирован) Скопированный виджет может быть использован для вставки поверх существующего виджета, используя опцию *Вставить* в [меню виджета](#меню-виджетов). ##### 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. Установка производится путем простого копирования PHP файлов из папки ui в папку HTML-документов веб-сервера. Общепринятые места размещения папки HTML-документов для веб-сервера Apache включают: - /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), или на USB-накопителе или аналогичном носителе, при условии, однако, что документация распространяется вместе с программным обеспечением на том же носителе. Любое другое использование, например, любое распространение печатных копий или использование этой документации, полностью или частично, в другой публикации, требует предварительного письменного согласия уполномоченного представителя Zabbix. Все права на эту документацию, кроме прямо предоставлененных выше, Zabbix оставляет за собой. # Copyright notice Zabbix documentation is NOT distributed under the AGPL-3.0 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 НЕ распространяется под лицензией AGPL-3.0. Использование документации Zabbix регулируется следующими условиями: Вы можете создать печатную копию этой документации исключительно для личного использования. Преобразование в другие форматы разрешено при условии, что фактическое содержимое не изменяется и не редактируется каким-либо образом. Вы не должны публиковать или распространять эту документацию в какой-либо форме или на каких-либо носителях, за исключением случаев, когда вы распространяете документацию способом, аналогичным тому, как Zabbix распространяет ее (то есть, в электронном виде для загрузки на веб-сайте Zabbix), или на USB-накопителе или аналогичном носителе, при условии, однако, что документация распространяется вместе с программным обеспечением на том же носителе. Любое другое использование, такое как распространение печатных копий или использование этой документации, полностью или частично, в другой публикации, требует предварительного письменного согласия уполномоченного представителя Zabbix. Zabbix оставляет за собой все права на эту документацию, прямо не предоставленные выше. # correlation.create ## correlation.create # correlation.delete # correlation.delete # 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.| ### Операция корреляции Объект операции корреляции определяет операцию, которая будет выполнена при выполнении корреляции. Этот объект имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |**type**<br>(обязательное)|целое число|Тип операции.<br><br>Возможные значения:<br>0 - закрыть старые события;<br>1 - закрыть новое событие.| ### 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.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Корреляция Объект корреляции имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |correlationid|строка|*(только чтение)* ID корреляции.| |**name**<br>(обязательное)|строка|Имя корреляции.| |description|строка|Описание корреляции.| |status|целое число|Активирована корреляция или нет.<br><br>Возможные значения:<br>0 - *(по умолчанию)* активирована;<br>1 - деактивирована.| Обратите внимание, что для некоторых методов (обновление, удаление) комбинация обязательных/необязательных параметров отличается. # 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 для MongoDB. Вы можете получить этот шаблон: - В *Конфигурация → Шаблоны* на новых инсталяциях. - При обновлении с предыдущих версий последние шаблоны можно загрузить с [Git репозитория](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) Zabbix или найти их в директории *templates* в скачанной последней версии Zabbix. Затем, находясь в *Настройка → Шаблоны*, вы можете импортировать его в 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[]` item. Например: $ 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[]` сообщил информацию о памяти только по пользовательскому процессу и вычислил память потока ядра как будто оно было нулевым. Это отличается от случая выше, когда сообщалось ZBX\_NOTSUPPORTED. Будьте внимательны при использовании элементов данных `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 и особенно база данных могут потребовать значительных ресурсов процессора в зависимости от количества наблюдаемых параметров и выбранного типа базы данных. #### 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 } ``` #### Создание действия обнаружения Создать действие, которое свяжет обнаруженные узлы сети с шаблоном "10091" Запрос: ```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 action Create an action that will link discovered hosts to template "10091". Request: ``` {.java} { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Discovery action", "eventsource": 1, "status": 0, "esc_period": "0s", "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 21, "value": "1" }, { "conditiontype": 10, "value": "2" } ] }, "operations": [ { "esc_step_from": 1, "esc_period": "0s", "optemplate": [ { "templateid": "10091" } ], "operationtype": 6, "esc_step_to": 1 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Создание действия обнаружения Создает действие, которое назначит обнаруженным узлам сети шаблон "10091". Запрос: ``` {.java} { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Discovery action", "eventsource": 1, "status": 0, "esc_period": "0s", "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 21, "value": "1" }, { "conditiontype": 10, "value": "2" } ] }, "operations": [ { "esc_step_from": 1, "esc_period": "0s", "optemplate": [ { "templateid": "10091" } ], "operationtype": 6, "esc_step_to": 1 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ``` {.java} { "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 агентом в локальной сети. Это правило должно использовать одну проверку Zabbix агента по порту 10050. Запрос: ```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 Add a host to host group "Linux servers" when host name contains "SRV" or metadata contains "CentOS". Request: ``` {.java} { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers", "eventsource": "2", "status": "0", "filter": { "evaltype": "2", "formula": "A or B", "conditions": [ { "conditiontype": "22", "operator": "2", "value": "SRV", "value2": "", "formulaid": "B" }, { "conditiontype": "24", "operator": "2", "value": "CentOS", "value2": "", "formulaid": "A" } ] }, "operations": [ { "actionid": "9", "operationtype": "4", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opgroup": [ { "operationid": "16", "groupid": "2" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### Создание правила авторегистрации агента Добавляет узел сети в группу узлов сети "Linux servers", когда имя узла сети содержит "SRV" или метаданные содержат "CentOS". Запрос: ``` {.java} { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers", "eventsource": "2", "status": "0", "filter": { "evaltype": "2", "formula": "A or B", "conditions": [ { "conditiontype": "22", "operator": "2", "value": "SRV", "value2": "", "formulaid": "B" }, { "conditiontype": "24", "operator": "2", "value": "CentOS", "value2": "", "formulaid": "A" } ] }, "operations": [ { "actionid": "9", "operationtype": "4", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opgroup": [ { "operationid": "16", "groupid": "2" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ``` {.java} { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "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 } ``` #### Создание правила автоматической регистрации агента Добавьте узел сети в группу хостов "Linux servers", если имя узла сети содержит "SRV" или метаданные содержат "CentOS". 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 } ``` #### 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 } ``` #### Создание корреляции на тег нового события Создание корреляции, которое использует метод вычисления `И/ИЛИ` (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 } ``` #### Создание нового интерфейа Создайте второй IP интерфейс агента на узле сети "30052". Запрос: ```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 } ``` Ответ: ```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 } ``` #### Создание соответствия иконок Создать соответствие иконок для отображения узлов сети различных типов. Запрос: ```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 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "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 Запрос: ```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 } ``` Ответ: ```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 кластера услугу с именем «Zabbix сервер нода 2». Задайте теги проблем следующим образом: - Имя: компонент - Операция: Равно - Значение: HA нода 2 Переключитесь на вкладку *Теги* и добавьте тег услуги: `Zabbix сервер:нода 2`. Сохраните новую услугу. #### 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 } ``` #### Создание токена Создать включенный токен, срок действия которого никогда не истекает, и который аутентифицирует пользователя с ID 2. Запрос: ```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 } ``` Создать отключенный токен, срок действия которого истекает 21 января 2021 года. Этот токен будет аутентифицировать текущего пользователя. Запрос: ```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 an action that will be run when a trigger from host "10084" that has the word "memory" in its name goes into problem state. The action must first send a message to all users in user group "7". If the event is not resolved in 4 minutes, it will run script "3" on all hosts in group "2". On trigger recovery it will notify all users who received any messages regarding the problem before. On trigger update, message with custom subject and body will be sent to all who left acknowledgments and comments via all media types. Request: ``` {.java} { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "status": 0, "esc_period": "2m", "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 1, "operator": 0, "value": "10084" }, { "conditiontype": 3, "operator": 2, "value": "memory" } ] }, "operations": [ { "operationtype": 0, "esc_period": "0s", "esc_step_from": 1, "esc_step_to": 2, "evaltype": 0, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } }, { "operationtype": 1, "esc_step_from": 3, "esc_step_to": 4, "evaltype": 0, "opconditions": [ { "conditiontype": 14, "operator": 0, "value": "0" } ], "opcommand_grp": [ { "groupid": "2" } ], "opcommand": { "scriptid": "3" } } ], "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" } } ], "pause_suppressed": "0", "notify_if_canceled": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### Создание триггера действия Создает действие, которое сработает если триггер в статусе "Проблема" узла сети "10084" имеет в названии слово "memory". Действие обязано оповестить всех пользователей в группе "7". Если событие не перейдет в статус ОК в течении 4х минут, будет запущен скрипт "3" на всех узлах сети из группы "2". При восстановлении триггера будут уведомлены все пользователи, которые получили сообщение о проблеме ранее. В случае обновления, сообщение с пользовательским заголовком и содержанием будет отправлено всем пользователям кто оставил комментарии и подтвердил проблему, всеми способами оповещения. Запрос: ``` {.java} { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "status": 0, "esc_period": "2m", "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 1, "operator": 0, "value": "10084" }, { "conditiontype": 3, "operator": 2, "value": "memory" } ] }, "operations": [ { "operationtype": 0, "esc_period": "0s", "esc_step_from": 1, "esc_step_to": 2, "evaltype": 0, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } }, { "operationtype": 1, "esc_step_from": 3, "esc_step_to": 4, "evaltype": 0, "opconditions": [ { "conditiontype": 14, "operator": 0, "value": "0" } ], "opcommand_grp": [ { "groupid": "2" } ], "opcommand": { "scriptid": "3" } } ], "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" } } ], "pause_suppressed": "0", "notify_if_canceled": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ``` {.java} { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "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» перейдет в состояние ПРОБЛЕМА. Действие будет иметь 4 настроенные операции. Первая и немедленная операция отправит сообщение всем пользователям в группе пользователей «7» через тип носителя «1». Если событие не будет устранено в течение 30 минут, вторая операция запустит [script](/manual/web_interface/frontend_sections/administration/scripts#configuring-a-global-script) "5" (скрипт с областью действия "Операция действия") на всех хостах группы «2». Если событие устранено, операция восстановления уведомит всех пользователей, получивших сообщения о проблеме. Если событие обновлено, операция подтверждения/обновления уведомит (с настраиваемой темой и сообщением) всех пользователей, получивших сообщения о проблеме. Запрос: ```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 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-агента Создать элемент данных POST-запроса с предварительной обработкой JSON ответа. Запрос: ```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 } ``` Ответ: ```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-адресом, используя пользовательский макрос, поля запроса и пользовательские заголовки. Запрос: ```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 } ``` Ответ: ```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 } ``` #### Создать элемент данных "скрипт" Создать простой набор данных с помощью элемента данных "скрипт". Запрос: ```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 } ``` Ответ: ```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 } ``` #### Создание панели Создать панель с именем "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. #### Создание панели Новую панель можно создать двумя способами: - нажать на кнопку *Создать панель* при просмотре всех панелей - выбрать *Создать новое* из меню действий при просмотре отдельной панели Сначала вам будет предложено ввести общие параметры панели:  |Параметр|Описание| |--|--------| |*Владелец (Owner)*|Выберите пользователя системы, который будет владельцем панели.| |*Имя (Name)*|Введите имя панели.| |*Период отображения страницы по умолчанию (Default page display period)*|Выберите период, в течение которого отображается страница панели до переключения на следующую страницу в [слайд-шоу](#создание-слайд-шоу).| |*Запускать слайд-шоу автоматически (Start slideshow automatically)*|Отметьте этот флажок для автоматического запуска слайд-шоу, если на панели присутствует более одной страницы.| После нажатия на *Применить (Apply)*, откроется пустая панель: {width="600"} Для заполнения панели вы можете добавлять виджеты и страницы. Нажмите на кнопку *Сохранить изменения (Save changes)* для сохранения панели. При нажатии на *Отмена (Cancel)* панель создана не будет. #### 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 } ``` #### Создание графика Создать график с двумя элементами данных. Запрос: ```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: ```json { "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: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Создание прототипа графиков Создать прототип графика с двумя элементами данных. Запрос: ```json { "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 } ``` Ответ: ```json { "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: ```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" } ], "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: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "107819" ] }, "id": 1 } ``` #### Создание хоста Создайте хост под названием «Linux server» с IP-интерфейсом и тегами, добавьте его в группу, привяжите к нему шаблон и задайте MAC-адреса в инвентарь хоста. Запрос: ```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" } ], "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 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "107819" ] }, "id": 1 } ``` #### Creating a host group Create a host group called "Linux servers". Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.create", "params": { "name": "Linux servers" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107819" ] }, "id": 1 } ``` #### Создание группы узлов сети Создать группу узлов сети с именем "Linux servers". Запрос: ```json { "jsonrpc": "2.0", "method": "hostgroup.create", "params": { "name": "Linux servers" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```json { "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 выполните следующее: - Перейдите в: *Настройка → Группы узлов сети* - Нажмите на *Создать группу узлов сети* в верхнем правом углу экрана - В диалоге введите параметры группы  Все обязательные поля ввода отмечены красной звёздочкой. |Параметр|Описание| |---------|-----------| |*Имя группы*|Введите уникальное имя группы узлов сети.<br>Чтобы создать вложенную группу узлов сети, используйте прямую косую черту «/», например: `Европа/Латвия/Рига/Zabbix сервера`. Вы можете создать такую группу, даже если ни одна из родительских групп узлов сети (`Европа/Латвия/Рига`) не существует. В этом случае создание этих родительских групп узлов сети оставлено на усмотрение пользователя; они не будут созданы автоматически.<br>Косые черты в начале и в конце строки, а также несколько косых черт подряд не поддерживаются. Экранирование символа «/» не поддерживается.<br>Вложенное представление групп узлов сети поддерживается, начиная с Zabbix 3.2.0.| |*Применить права доступа и фильтры тегов ко всем подгруппам*|Эта опция доступна только пользователям с правами Супер-администратор и только при редактировании существующей группы узлов сети.<br>Выберите эту опцию и нажмите на *Обновить*, чтобы применить одинаковый уровень прав доступа / фильтры тегов ко всем вложенным группам узлов сети. Для групп пользователей, которые могли иметь разные [права доступа](/manual/config/users_and_usergroups/usergroup#настройка), назначенные на вложенные группы узлов сети, уровень прав доступа родительской группы узлов сети будет применён ко всем вложенным группам.<br>Это действие является одноразовой опцией, которая не сохраняется в базе данных.<br>Опция поддерживается, начиная с Zabbix 3.4.0.| **Права доступа к вложенным группам узлов сети** - При создании дочерней группы узлов сети у уже существующей родительской группы узлов сети права доступа [группы пользователей](/manual/config/users_and_usergroups/usergroup) к дочерней группе узлов сети наследуются от родителя (например, при создании `Рига/Zabbix сервера`, если `Рига` уже существует) - При создании родительской группы узлов сети при уже существующей дочерней группе узлов сети права доступа на родительскую группу узлов сети не задаются (например, при создании `Рига`, если `Рига/Zabbix сервера` уже существует) #### 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 } ``` #### Создание прототипа узла сети Создать прототип узла сети "{\#VM.NAME }" по LLD правилу "23542" с прототипом группы "{\#HV.NAME }", с тегом "Datacenter": "{\#DATACENTER.NAME }" и кастомизированным интерфейсом SNMPv2 127.0.0.1:161 с сообществом {$SNMP\_COMMUNITY}. Связать его с группой хостов "2". Запрос: ```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 } ``` Ответ: ```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 host" с настройками шифрования PSK. Учтите, что для узла сети должно быть [предварительно настроено использование PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example). Запрос: ```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 } ``` Ответ: ```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: ```json { "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: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10658" ] }, "id": 1 } ``` #### Создание хоста с SNMP интерфейсом Создайте хост с именем "SNMP host" с интерфейсом SNMPv3 и подробностями. Запрос: ```json { "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 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10658" ] }, "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 } ``` #### Создание обслуживания Создать со сбором данных для группы узлов сети с идентификатором "2" и с тегами проблем **service:mysqld** и **error**. Оно должно быть активно с 22.01.2013 по 22.01.2014, вступая в силу каждое воскресенье в 18:00 и длиться один час. Запрос: ```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 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### Creating a map To create a map, do the following: - Go to *Monitoring → Maps* - Go to the view with all maps - Click on *Create map* You can also use the *Clone* and *Full clone* buttons in the configuration form of an existing map to create a new map. Clicking on *Clone* will retain general layout attributes of the original map, but no elements. *Full clone* will retain both the general layout attributes and all elements of the original map. The **Map** tab contains general map attributes:  All mandatory input fields are marked with a red asterisk. General map attributes: |Parameter|Description| |--|--------| |*Owner*|Name of map owner.| |*Name*|Unique map name.| |*Width*|Map width in pixels.| |*Height*|Map height in pixels.| |*Background image*|Use background image:<br>**No image** - no background image (white background)<br>**Image** - selected image to be used as a background image. No scaling is performed. You may use a geographical map or any other image to enhance your map.| |*Automatic icon mapping*|You can set to use an automatic icon mapping, configured in *Administration → General → Icon mapping*. Icon mapping allows mapping certain icons against certain host inventory fields.| |*Icon highlight*|If you check this box, map elements will be highlighted.<br>Elements with an active trigger will receive a round background, in the same color as the highest severity trigger. Moreover, a thick green line will be displayed around the circle, if all problems are acknowledged.<br>Elements with "disabled" or "in maintenance" status will get a square background, gray and orange respectively.<br>See also: [Viewing maps](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps)| |*Mark elements on trigger status change*|A recent change of trigger status (recent problem or resolution) will be highlighted with markers (inward-pointing red triangles) on the three sides of the element icon that are free of the label. Markers are displayed for 30 minutes.| |*Display problems*|Select how problems are displayed with a map element:<br>**Expand single problem** - if there is only one problem, the problem name is displayed. Otherwise, the total number of problems is displayed.<br>**Number of problems** - the total number of problems is displayed<br>**Number of problems and expand most critical one** - the name of the most critical problem and the total number of problems is displayed.<br>'Most critical' is determined based on problem severity and, if equal, problem event ID (higher ID or later problem displayed first). For a *trigger map element* it is based on problem severity and if equal, trigger position in the trigger list. In case of multiple problems of the same trigger, the most recent one will be displayed.| |*Advanced labels*|If you check this box you will be able to define separate label types for separate element types.| |*Map element label type*|Label type used for map elements:<br>**Label** - map element label<br>**IP address** - IP address<br>**Element name** - element name (for example, host name)<br>**Status only** - status only (OK or PROBLEM)<br>**Nothing** - no labels are displayed| |*Map element label location*|Label location in relation to the map element:<br>**Bottom** - beneath the map element<br>**Left** - to the left<br>**Right** - to the right<br>**Top** - above the map element| |*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| |*Minimum trigger severity*|Problems below the selected minimum severity level will not be displayed on the map.<br>For example, with *Warning* selected, changes with *Information* and *Not classified* level triggers will not be reflected in the map.<br>This parameter is supported starting with Zabbix 2.2.| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*URLs*|URLs for each element type can be defined (with a label). These will be displayed as links when a user clicks on the element in the map viewing mode.<br>Macros can be used in map URL names and values. For a full list, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map URL names and values'.| #### Создание карты сети Для создания карты, сделайте следующее: - Перейдите в *Мониторинг → Карты сети (Monitoring → Maps)* - Перейдите к просмотру всех карт - Нажмите на *Создать карту сети (Create map)* Для создания новой карты вы также можете воспользоваться кнопками *Клонировать (Clone)* и *Полное клонирование (Full clone)* в диалоге настройки существующей карты. При нажатии на *Клонировать* сохранятся общие атрибуты макета оригинальной карты, но без элементов. *Полное клонирование* сохранит как общие атрибуты макета, так и все элементы оригинальной карты. Вкладка **Карта сети (Map)** содержит общие атрибуты карт сетей:  Все обязательные поля ввода отмечены красной звёздочкой. Общие атрибуты карты сети: |Параметр|Описание| |--|--------| |*Владелец (Owner)*|Имя владельца карты.| |*Имя (Name)*|Уникальное имя карты.| |*Ширина (Width)*|Ширина карты в пикселях.| |*Высота (Height)*|Высота карты в пикселях.| |*Фоновое изображение*<br>*(Background image)*|Использование фонового изображения:<br>**Нет изображения (No image)** — без фонового изображения (белый фон)<br>**Изображение (Image)** — выбранное изображение будет использовано в качестве фона. Масштабирование не производится. Вы можете использовать географическую карту или любое другое изображение для улучшения вашей карты.| |*Автоматическое соответствие иконок*<br>*(Automatic icon mapping)*|Вы можете указать использование автоматического соответствия иконок, заданного в *Администрирование → Общие → Соответствие иконок (Administration → General → Icon mapping)*. Соответствие иконок позволяет отображать определённые иконки в соответствии с полями инвентарных данных узлов сети.| |*Подсветка иконок*<br>*(Icon highlight)*|Если вы отметите эту опцию, иконки будут подсвечены.<br>Элементы с активными триггерами будут иметь фон в виде круга такого же цвета, что и триггер с наивысшей важностью. Кроме того, будет отображаться зеленая толстая линия вокруг круга, если все проблемы подтверждены.<br>Если элемент в состоянии «деактивирован» или «в обслуживании», будет использоваться фон в виде квадрата, серый и оранжевый соответственно.<br>Смотрите также: [Просмотр карт сети](/manual/web_interface/frontend_sections/monitoring/maps#просмотр-карт-сети).| |*Помечать элементы при изменении состояния триггера*<br>*(Mark elements on trigger status change)*|Недавнее изменение состояния триггера (недавняя проблема или её решение) будет подсвечиваться маркерами (указывающие внутрь красные треугольники) по трём сторонам иконки элемента, которые не заняты подписью. Маркеры отображаются в течение 30 минут.| |*Отображение проблем*<br>*(Display problems)*|Каким образом проблемы отображаются с элементом карты:<br>**Развёртывание одиночной проблемы (Expand single problem)** — если имеется только одна проблема, отобразится имя этой проблемы. В противном случае отобразится общее количество проблем.<br>**Количество проблем (Number of problems)** — отобразится общее количество проблем<br>**Количество проблем и раскрывать наиболее критичную (Number of problems and expand most critical one)** — имя наиболее критичной проблемы и общее количество проблем.<br>«Наиболее критичная» основывается на важности проблемы и, если имеются одинаковые, ID события проблемы (более высокий ID или более новая проблема отображается первой). В случае *элемента карты триггер* подход основан на важности проблемы и, если имеются одинаковые, позиции триггера в списке триггеров. В случае наличия нескольких проблем по одному триггеру, отобразится самая новая.| |*Расширенные подписи*<br>*(Advanced labels)*|Если эта опция выбрана, у вас будет возможность задать типы подписи для разных типов элементов.| |*Тип подписи к элементам карты*<br>*(Map element label type)*|Тип подписи, который будет использоваться для элементов карты:<br>**Подпись (Label)** — подпись к элементу карты<br>**IP адрес (IP address)** — IP адрес<br>**Название (Element name)** — имя элемента (например, имя узла сети)<br>**Только состояние (Status only)** — только состояние (ОК или ПРОБЛЕМА)<br>**Ничего (Nothing)** — подписи не будут отображаться| |*Размещение подписи к элементам карты*<br>*(Map element label location)*|Расположение подписи по отношению к иконке элемента карты:<br>**По нижнему краю (Bottom)** — ниже иконки<br>**По левой стороне (Left)** — слева<br>**По правой стороне (Right)** — справа<br>**По верхнему краю (Top)** — выше иконки| |*Отображение проблем*<br>*(Problem display)*|Отображение количества проблем как:<br>**Все (All)** — будет отображено общее количество проблем<br>**Раздельно (Separated)** — количество неподтверждённых проблем будет отображено отдельным числом из общего количества проблем<br>**Только неподтверждённые (Unacknowledged only)** — будет отображено только количество неподтверждённых проблем| |*Минимальная важность триггеров*<br>*(Minimum trigger severity)*|Проблемы с важностью ниже заданной в данной опции не будут отображаться на карте.<br> Например, с выбранной важностью *Предупреждение*, изменения состояний триггеров с *Информация* и *Не классифицировано* не будут отражены на карте.<br>Параметр поддерживается, начиная с Zabbix 2.2.| |*Подавленные проблемы*<br>*(Show suppressed problems)*|Выберите эту опцию для отображения проблем, которые в противном случае могут быть подавлены (т.е. не отображаться) из-за периода обслуживания узла сети.| |*URL'ы (URLs)*|Можно указать URL'ы для каждого типа элемента (с подписью). Они будут отображаться в виде ссылок, когда пользователь нажимает на элементе в режиме просмотра карты.<br>В именах и значениях URL можно использовать макросы. Смотрите полный список [поддерживаемых макросов](/manual/appendix/macros/supported_by_location), ищите «Имена и значения URL на картах».| #### 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 } ``` #### Создание нового глобального регулярного выражения. Запрос: ```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 } ``` Ответ: ```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. ::: #### Создание нового элемента данных Создадим новый [элемент данных](/manual/api/reference/item/object) на узле сети "Zabbix server", используя данные, полученные из предыдущего запроса`host.get`. Это можно сделать при помощи метода [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 } ``` Успешный ответ будет содержать идентификатор только что созданного элемента данных, который можно использовать для обозначения этого элемента данных в последующих запросах: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 3 } ``` ::: notetip Метод `item.create`, так же как и другие методы создания, может принимать массивы объектов и создавать несколько элементов данных с помощью одного вызова API. ::: #### 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 } ``` #### Создание элемента данных с предварительной обработкой Создать элемент данных, используя пользовательский множитель. Запрос: ```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 } ``` Ответ: ```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 правила Создать LLD правило Zabbix агента для обнаружения смонтированных файловых систем. Обнаруженные элементы будут обновляться каждые 30 секунд. Запрос: ```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 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` ##### 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 по адресу [Microsoft Entra ID](https://entra.microsoft.com). Для тестирования вы можете создать бесплатную пробную учётную запись в Microsoft Entra ID. 2\. В центре администрирования Microsoft Entra выберите *Applications (Приложения)* -> *Enterprise applications (Корпоративные приложения)* -> *New application (Новое приложение)* -> *Create your own application (Создать собственное приложение)*. 3\. Добавьте имя своего приложения и выберите опцию *Integrate any other application... (Интеграция любого другого приложения...)*. После этого нажмите *Create (Создать)*. {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 } ``` #### Создание роли Создать роль типа "User" и запретить доступ к двум элементам пользовательского интерфейса. Запрос: ```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 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "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 #### Создание слайд-шоу Если панель содержит две или более страниц (см. [Добавление страниц](#добавление-страниц)), то будет автоматически запускаться слайд-шоу, если одновременно с этим выполняется одно из: - в свойствах панели отмечено свойство *Запускать слайд-шоу автоматически* - URL панели содержит параметр `slideshow=1` Страницы чередуются в соответствии с интервалом, заданным в свойствах панели и отдельных страниц. Нажмите на: - *Остановить слайд-шоу* - чтобы остановить слайд-шоу - *Начать слайд-шоу* - чтобы начать слайд-шоу  Кнопки управления слайд-шоу также доступны в [режиме киоска](#просмотр-и-редактирование-панели) (когда отображается только содержимое страницы): -  - остановить слайд-шоу -  - начать слайд-шоу -  - перейти к предыдущей странице -  - перейти к следующей странице #### Creating a template To create a template, do the following: - Go to *Configuration → Templates* - Click on *Create template* - Edit template attributes The **Template** tab contains general template attributes. {width="600"} 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 *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 template when the template 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| |*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. ::: #### Создание шаблона Для создания шаблона выполните следующее: - Перейдите в *Настройка → Шаблоны (Configuration → Templates)* - Нажмите на *Создать шаблон (Create template)* - Измените атрибуты шаблона Вкладка **Шаблон (Template)** содержит общие атрибуты шаблона. {width="600"} Все обязательные поля ввода отмечены красной звёздочкой. Атрибуты шаблонов: |Параметр|Описание| |--|--------| |*Имя шаблона*<br>*(Template name)*|Уникальное имя шаблона. Разрешены буквенно-цифровые символы, пробелы, точки, тире и символы подчёркивания. Однако, пробелы в начале и конце имени запрещены.| |*Видимое имя*<br>*(Visible name)*|Если вы укажете это имя, то именно оно будет видимо в списках, картах и прочем.| |*Шаблоны*<br>*(Templates)*|Присоедините один или более «вложенных» шаблонов к этому шаблону. Все объекты (элементы данных, триггеры, графики и т.д.) будут унаследованы от присоединённых шаблонов.<br>Для присоединения нового шаблона начните печатать имя шаблона в поле *Шаблоны*. Появится список совпадающих шаблонов; прокрутите список и выберите. Альтернативный вариант — вы можете нажать *Выбрать (Select)* рядом с полем *Шаблоны*, после чего сначала выбрать группу узлов сети при помощи кнопки *Выбрать (Select)* рядом с полем *Группа узлов сети (Host groups)*, а затем отметить один или несколько шаблонов из показанного списка и нажать *Выбрать (Select)*. Шаблоны, выбранные в поле *Шаблоны*, будут присоединены к шаблону при сохранении или обновлении диалога конфигурации шаблона.<br>Для отсоединения шаблона, воспользуйтесь одной из двух опций в блоке *Шаблоны*:<br>*Отсоединить (Unlink)* — отсоединить шаблон, но оставить его элементы данных, триггеры и графики<br>*Отсоединить и очистить (Unlink and clear)* — отсоединить шаблон и удалить все его элементы данных, триггеры и графики| |*Группы*<br>*(Groups)*|Группы узлов сети / шаблонов, к которым принадлежит этот шаблон.| |*Описание*<br>*(Description)*|Введите описание шаблона.| Вкладка **Теги (Tags)** позволяет вам задать [теги](/manual/config/tagging) на уровне шаблона. Все проблемы узлов сети, присоединённых к этому шаблону, будут помечены тегами с их значениями, введёнными здесь.  В тегах поддерживаются пользовательские макросы, все макросы {INVENTORY.\*}, а также {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} и {HOST.ID}. Вкладка **Макросы (Macros)** позволяет вам задать [пользовательские макросы](/manual/config/macros/user_macros) уровня шаблона в виде пар имени и значения. Обратите внимание, что значения макросов могут храниться в виде обычного текста, скрытого текста или секрета Хранилища. Также поддерживается добавление описания.  Вы также можете здесь просмотреть макросы из присоединённых шаблонов и глобальные макросы, если вы выберете опцию *Унаследованные и макросы из шаблонов (Inherited and template macros)*. Это то место, где отображаются все опредёленные для этого шаблона пользовательские макросы со своими раскрытыми значениями, а также информация о том, откуда эти макросы.  Для удобства имеются ссылки на настройку соответствующих шаблонов и глобальных макросов. Также имеется возможность макрос вложенного шаблона или глобальный изменить на уровне этого шаблона, фактически создав копию этого макроса у шаблона. Вкладка **Преобразования значений (Value mapping)** позволяет настроить удобные для человека представления данных элемента данных в [преобразованиях значений](/manual/config/items/mapping). Кнопки: | | | |--|--------| | (Добавить)|Добавление шаблона. Добавленный шаблон должен появиться в списке.| | (Обновить)|Обновление свойств существующего шаблона.| | (Клонировать)|Создание другого шаблона, основанного на свойствах текущего шаблона, включая все объекты (элементы данных, триггеры и т.п.), унаследованные от присоединённых шаблонов.| | (Полное клонирование)|Создание другого шаблона, основанного на свойствах текущего шаблона, включая все объекты (элементы данных, триггеры и т.п.) — как унаследованные от присоединённых шаблонов, так и напрямую присоединённые к текущему шаблону.| | (Удалить)|Удаление шаблона; объекты из шаблона (элементы данных, триггеры и прочее) останутся присоединёнными к узлам сети.| | (Удалить и очистить)|Удаление шаблона и всех его объектов из присоединённых узлов сети.| | (Отмена)|Отмена изменений свойств шаблона.| Когда шаблон создан, самое время добавить в него какие-нибудь объекты. ::: noteimportant В шаблон необходимо сначала добавить элементы данных. Триггеры и графики нельзя добавлять без наличия соответствующих элементов данных. ::: #### 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 } ``` #### Создание веб-сценария Создать веб-сценарий для мониторинга домашней страницы компании. Сценарий будет состоять из двух шагов: проверить домашнюю страницу и страницу «О программе» и убедиться, что они возвращают код состояния HTTP 200. Запрос: ```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 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` ##### 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. ##### Создание базы данных [Создайте](/manual/appendix/install/db_scripts) отдельную базу данных для Zabbix прокси. 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. ##### Создание базы данных [Создайте](/manual/appendix/install/db_scripts) отдельную базу данных для Zabbix прокси. 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. ##### Создание базы данных [Создайте](/manual/appendix/install/db_scripts) отдельную базу данных для Zabbix прокси. Zabbix сервер и Zabbix прокси не могут использовать одну и ту же базу данных. Если они установлены на одном хосте, тогда имя базы данных прокси должно отличаться. #### 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 } ``` #### Создание зависимого элемента данных Создать зависимый элемент данных для основного элемента данных с идентификатором 24759. Разрешены зависимости только от одного и того же узла сети, поэтому у главного и зависимого элемента данных должен быть один и тот же узел сети. Запрос: ```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 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "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 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/Latvia` родительской группы `Europe`. - ввод `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 } ``` #### Создание интерфейсов Создать интерфейс на двух хостах. Запрос: ```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 } ``` Ответ: ```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 } ``` #### Создание нескольких триггеров Соответственно, если методы создания принимают массивы, мы можем добавить несколько [триггеров](/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 Console. **1.** Откройте раздел Workloads → Secrets и переключите проект на проект Zabbix Operator (по умолчанию «zabbix»). {width="600"} **2.** Создайте новый секрет с помощью опции *From YAML*. {width="600"} ##### Credentials (login:password) System: - root:zabbix Zabbix frontend: - Admin:zabbix Database: - root:<random> - zabbix:<random> ::: noteclassic Database passwords are randomly generated during the installation process.<br> Root password is stored inside the /root/.my.cnf file. It is not required to input a password under the "root" account. ::: To change the database user password, changes have to be made in the following locations: - MySQL; - /etc/zabbix/zabbix\_server.conf; - /etc/zabbix/web/zabbix.conf.php. ::: noteclassic Separate users `zabbix_srv` and `zabbix_web` are defined for the server and the frontend respectively. ::: ##### Учётные данные (логин:пароль) Системные: - root:zabbix Веб-интерфейс Zabbix: - Admin:zabbix База данных: - root:<random> - zabbix:<random> ::: noteclassic Пароли к базе данных генерируются случайным образом в процессе установки.<br> Пароль root хранится в файле /root/.my.cnf. Находясь под аккаунтом «root», вводить пароль не требуется. ::: Для изменения пароля пользователя базы данных, потребуется внести изменения в следующих местах: - MySQL; - /etc/zabbix/zabbix\_server.conf; - /etc/zabbix/web/zabbix.conf.php. ::: noteclassic Для работы с сервером и веб-интерфейсом настроены отдельные пользователи — `zabbix_srv` и `zabbix_web` соответственно. ::: ### 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; ### Критические Чтобы завершить успешное обновление сервера Zabbix server на MySQL и MariaDB, вам может потребоваться выставить `GLOBAL log_bin_trust_function_creators = 1` в MySQL, если включено бинарное журналирование (binary logging), нет привелегий суперпользователя и параметр `log_bin_trust_function_creators = 1` не выставлен в конфигурационном файле MySQL. Чтобы выставить эту переменную, используя консоль MySQL, выполните: mysql> SET GLOBAL log_bin_trust_function_creators = 1; После успешного завершения обновления параметр `log_bin_trust_function_creators` можно отключить: 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 аннулированный сертификат записывается как «certificate revoked». При истекшем CRL сообщение об ошибке меняется на «certificate expired», которое может ввести в заблуждение. [*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 macros The **LLD macros** tab allows to specify custom low-level discovery macros. Custom macros are useful in cases when the returned JSON does not have the required macros already defined. So, for example: - The native `vfs.fs.discovery` key for filesystem discovery returns a JSON with some pre-defined LLD macros such as {\#FSNAME}, {\#FSTYPE}. These macros can be used in item, trigger prototypes (see subsequent sections of the page) directly; defining custom macros is not needed; - The `vfs.fs.get` agent item also returns a JSON with [filesystem data](/manual/discovery/low_level_discovery/examples/mounted_filesystems), but without any pre-defined LLD macros. In this case you may define the macros yourself, and map them to the values in the JSON using JSONPath:  The extracted values can be used in discovered items, triggers, etc. Note that values will be extracted from the result of discovery and any preprocessing steps so far. |Parameter|Description| |--|--------| |*LLD macro*|Name of the low-level discovery macro, using the following syntax: {\#MACRO}.| |*JSONPath*|Path that is used to extract LLD macro value from an LLD row, using JSONPath syntax.<br>The values extracted from the returned JSON are used to replace the LLD macros in item, trigger, etc. prototype fields.<br>JSONPath can be specified using the dot notation or the bracket notation. Bracket notation should be used in case of any special characters and Unicode, like `$['unicode + special chars #1']['unicode + special chars #2']`.<br><br>For example, `$.foo` will extract "bar" and "baz" from this JSON: `[{"foo":"bar"}, {"foo":"baz"}]`<br>Note that `$.foo` will extract "bar" and "baz" also from this JSON: `{"data":[{"foo":"bar"}, {"foo":"baz"}]}` because a single "data" object is processed automatically (for [backwards compatibility](#overview) with the low-level discovery implementation in Zabbix versions before 4.2).| #### Настраиваемые макросы Вкладка **LLD макросы (LLD macros)** позволяет указать настраиваемые макросы низкоуровневого обнаружения. Настраиваемые макросы полезны в случаях, когда возвращаемый JSON не имеет нужных макросов, уже определённых должным образом. Так, например: - Встроенный ключ `vfs.fs.discovery` для обнаружения файловых систем возвращает JSON с некоторыми уже определёнными LLD макросами, такими как {\#FSNAME} и {\#FSTYPE}. Эти макросы могут быть непосредственно использованы в прототипах элементов данных и триггеров (смотрите последующие разделы на этой странице); определение настраиваемых макросов не требуется; - Элемент данных агента `vfs.fs.get` также возвращает JSON с [данными о файловой системе](/manual/discovery/low_level_discovery/examples/mounted_filesystems), однако, без готовых LLD макросов. В этом случае вы можете определить эти макросы самостоятельно, и выставить соответствие между ними и значениями в JSON-е, используя JSONPath:  Извлечённые значения могут использоваться в обнаруженных элементах данных, триггерах и т.п. Обратите внимание, что значения будут извлекаться из результата обнаружения после выполнения шагов предобработки. |Параметр|Описание| |--|--------| |*LLD макрос*<br>*(LLD macro)*|Имя макроса низкоуровневого обнаружения, с использованием следующего синтаксиса: {\#MACRO}.| |*JSONPath*|Путь, используемый для извлечения значения LLD макроса из строки LLD, используя синтаксис JSONPath.<br>Значения, извлекаемые из возвращаемого JSON-а, используются для замены LLD макросов в полях прототипов элемента данных, триггера и т.п.<br>JSONPath может быть указан, используя нотацию с точкой или с квадратными скобками. Нотация с квадратными скобками должна использоваться в случаях использования любых специальных символов и символов Unicode, наподобие следующего: `$['unicode + special chars #1']['unicode + special chars #2']`.<br><br>Например, `$.foo` извлечёт «bar» и «baz» из такого JSON-а: `[{"foo":"bar"}, {"foo":"baz"}]`<br>Обратите внимание, что `$.foo` также извлечёт «bar» и «baz» из такого JSON-а: `{"data":[{"foo":"bar"}, {"foo":"baz"}]}` из-за того, что одиночный объект "data" обрабатывается автоматически (для [обратной совместимости](#обзор) с реализацией низкоуровневого обнаружения в версиях Zabbix до 4.2).| #### 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| #### Ограничения пользовательских скриптов Доступная длина пользовательских скриптов зависит от используемой базы данных: |База данных|Ограничение в символах|Ограничение в байтах| |---|---|---| |**MySQL**|65535|65535| |**Oracle Database**|2048|4000| |**PostgreSQL**|65535|ограничений нет| |**SQLite (только Zabbix прокси)**|65535|ограничений нет| #### dashboard Changes:\ [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) added support of new widget type `item`.\ #### dashboard Changes:\ [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) added support of new widget type `item`.\ # dashboard.create # dashboard.create # dashboard.delete # dashboard.delete # dashboard.get # dashboard.get ##### 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 строк в высоту. ### 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.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Панель Объект панели имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |dashboardid|строка|*(только чтение)* ID панели.| |**name**<br>(required)|строка|Имя панели.| |userid|строка| ID владельца панели.| |private|целое число|Тип доступа к панели.<br><br>Возможные значения:<br>0 - общедоступная панель;<br>1 - *(по умолчанию)* приватная панель.| |display\_period|целое число|Период отображения панели (в секундах).<br><br>Возможные значения: 10, 30, 60, 120, 600, 1800, 3600.<br><br>По умолчанию: 30.| |auto\_start|целое число|Автоматический запуск слайд-шоу.<br><br>Возможные значения:<br>0 - не запускать слайд-шоу;<br>1 - *(по умолчанию)* автоматически запускать слайд-шоу.| Обратите внимание, что для некоторых методов (обновление, удаление) комбинация обязательных/необязательных параметров отличается. # 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.| ### Группа пользователей панели Список прав доступа к панели на основе групп пользователей. Этот список имеет следующие свойства: |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |**usrgrpid**<br>(обязательно)|string|ID группы пользователей.| |**permission**<br>(обязательно)|integer|Тип уровня прав доступа.<br><br>Возможные значения:<br>2 - только чтение;<br>3 - чтение-запись;| ### 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.| ### Пользователь панели Список прав доступа к панели на основе пользователей. Этот список имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |**userid**<br>(обязательное)|string|ID пользователя.| |**permission**<br>(обязательное)|integer|Тип уровня прав доступа.<br><br>Возможные значения:<br>2 - только чтение;<br>3 - чтение-запись;| # 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**<br>(required)|string|Widget field name.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).| |**value**<br>(required)|mixed|Widget field value depending on the type.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).| ### Поле виджета панели Объект поля виджета панели имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |----------------|------|----------------| |**type**<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 - SLA.| |**name**<br>(обязательно)|string|Имя поля виджета.<br><br>Возможные значения: см. [поля виджетов панели](/manual/api/reference/dashboard/widget_fields).| |**value**<br>(обязательно)|mixed|Значение поля виджета в зависимости от типа.<br><br>Возможные значения: см. [поля виджетов панели](/manual/api/reference/dashboard/widget_fields).| #### 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 creation We assume that a *zabbix* database user with *password* password exists and has permissions to create database objects in ORCL service located on the *host* Oracle database server. Zabbix requires a Unicode database character set and a `UTF8` national character set. Check current settings: sqlplus> select parameter,value from v$nls_parameters where parameter='NLS_CHARACTERSET' or parameter='NLS_NCHAR_CHARACTERSET'; Now prepare the database: cd /path/to/zabbix-sources/database/oracle sqlplus zabbix/password@oracle_host/ORCL sqlplus> @schema.sql # stop here if you are creating database for Zabbix proxy sqlplus> @images.sql sqlplus> @data.sql ::: notetip Please set the initialization parameter CURSOR\_SHARING=FORCE for best performance. ::: ### Создание базы данных Мы предполагаем, что существует пользователь базы данных *zabbix* с паролем *password*, и он имеет разрешения на создание объектов базы данных в службе ORCL, расположенной на сервере *хост* базы данных Oracle. Zabbix требует базу данных с набором символов Unicode и кодировкой UTF8. Проверить текущие настройки: sqlplus> select parameter,value from v$nls_parameters where parameter='NLS_CHARACTERSET' or parameter='NLS_NCHAR_CHARACTERSET'; Теперь подготовьте базу данных: cd /путь/к/исходникам-zabbix/database/oracle sqlplus zabbix/password@oracle_host/ORCL sqlplus> @schema.sql # остановитесь здесь, если вы создаёте базу данных для Zabbix прокси sqlplus> @images.sql sqlplus> @data.sql ::: notetip Пожалуйста, установите параметр инициализации CURSOR\_SHARING=FORCE для лучшей производительности. ::: #### Database credentials It is supported to store database credentials used by Zabbix server, proxies and frontend secretly in Vault: - Vault-related parameters for retrieving database credentials can be optionally entered in the frontend [installation wizard](/manual/installation/frontend). Database credentials retrieved from Vault will be cached by the frontend. Note that the filesystem temporary file directory is used for database credential caching in frontend. You may use the ZBX\_DATA\_CACHE\_TTL [constant](/manual/web_interface/definitions) to control how often the data cache is refreshed/invalidated. - For server/proxy the VaultDBPath configuration parameter may be used to specify the path from where credentials for database will be retrieved by keys 'password' and 'username' (for example: secret/zabbix/database). The following commands may be used to set the values for the path mentioned in example: # Enable "secret/" mount point if not already enabled, note that "kv-v2" must be used vault secrets enable -path=secret/ kv-v2 # Put new secrets with keys username and password under mount point "secret/" and path "secret/zabbix/database" vault kv put secret/zabbix/database username=zabbix password=<password> # Test that secret is successfully added vault kv get secret/zabbix/database # Finally test with Curl, note that "data" need to be manually added after mount point and "/v1" before the mount point, also see --capath parameter curl --header "X-Vault-Token: <VaultToken>" https://127.0.0.1:8200/v1/secret/data/zabbix/database #### Учётные данные базы данных Поддерживается секретное хранение в Хранилище учётных данных базы данных, используемых Zabbix сервером, прокси и веб-интерфейсом: - Относящиеся к хранилищу параметры для получения учётных данных базы данных можно опционально задать в [мастере установки](/manual/installation/frontend) веб-интерфейса. Учётные данные базы данных, полученные из Хранилища, будут внесены в кэш веб-интерфейса. Обратите внимание, что для кэширования учётных данных базы данных используется директория временных файлов файловой системы. Вы можете использовать [константу](/manual/web_interface/definitions) ZBX\_DATA\_CACHE\_TTL для контроля того, как часто кэш данных обновляется/аннулируется. - Для сервера/прокси можно использовать параметр конфигурации VaultDBPath, чтобы указать путь, откуда будут извлекаться учётные данные для базы данных с помощью ключей «password» и «username» (например: secret/zabbix/database). Можно использовать следующие команды, чтобы задать значения для пути, который упоминается в примере: # Включите точку монтирования «secret/», если она еще не включена, обратите внимание, что необходимо использовать «kv-v2» vault secrets enable -path=secret/ kv-v2 # Поместите новые секреты с ключами username и password под точкой монтирования «secret/» и путём «secret/zabbix/database» vault kv put secret/zabbix/database username=zabbix password=<пароль> # Проверьте, что секрет успешно добавлен vault kv get secret/zabbix/database # Наконец, проверьте с помощью Curl, обратите внимание, что необходимо вручную добавить «data» после точки монтирования и «/v1» перед точкой монтирования, также смотрите параметр --capath curl --header "X-Vault-Token: <ТокенХранилища>" https://127.0.0.1:8200/v1/secret/data/zabbix/database ##### 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. ::: ##### Системы управления базами данных |Программное обеспечение|Поддерживаемые версии|Комментарии| |--------|------------------|--------| |*MySQL/Percona*|8.0.X|Требуется, если MySQL (или Percona) используется основной базой данных Zabbix. Требуется InnoDB engine. Мы рекомендуем использовать библиотеку [MariaDB Connector/C](https://downloads.mariadb.org/connector-c/) при сборке сервера/прокси.| |*MariaDB*|10.5.00-10.6.X| Требуется InnoDB engine. Мы рекомендуем использовать библиотеку [MariaDB Connector/C](https://downloads.mariadb.org/connector-c/) при сборке сервера/прокси.| |*Oracle*|19c - 21c|Требуется, если используется Oracle основной базой данных Zabbix.| |*PostgreSQL*|13.0 - 14.X|Требуется, если используется PostgreSQL основной базой данных Zabbix.| |*TimescaleDB* для PostgreSQL|2.0.1-2.3|Требуется, если используется TimescaleDB основной базой данных Zabbix. Убедитесь, что установленая версия Timescale DB c поддержкой сжатия.| |*SQLite*|3.3.5-3.34.X|SQLite поддерживается только на стороне Zabbix прокси. Требуется, если используется SQLite основной базой данных Zabbix прокси.| ::: noteclassic Не смотря на, что Zabbix может работать с базами данных, поставляемыми в операционных системах, мы рекомендуем всегда использовать базы данных установленные из официальных репозиториев разработчика. ::: ##### 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.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. ::: ##### Системы управления базами данных |Программное обеспечение|Поддерживаемые версии|Комментарии| |--------|------------------|--------| |*MySQL/Percona*|8.0.X|Требуется, если MySQL (или Percona) используется как основная база данных Zabbix. Требуется InnoDB engine. Мы рекомендуем использовать библиотеку [MariaDB Connector/C](https://downloads.mariadb.org/connector-c/) для сборки сервера/прокси.| |*MariaDB*|10.5.00-10.6.X| Требуется InnoDB engine. Мы рекомендуем использовать библиотеку [MariaDB Connector/C](https://downloads.mariadb.org/connector-c/) для сборки сервера/прокси.| |*Oracle*|19c - 21c|Требуется, если используется Oracle основной базой данных Zabbix.| |*PostgreSQL*|13.X|Требуется, если используется PostgreSQL основной базой данных Zabbix.| |*TimescaleDB* for PostgreSQL|2.0.1-2.3|Требуется, если используется TimescaleDB основной базой данных Zabbix. Убедитесь, что установлена версия Timescale DB c поддержкой сжатия.| |*SQLite*|3.3.5-3.34.X|SQLite поддерживается только на стороне Zabbix прокси. Требуется, если используется SQLite основной базой данных Zabbix прокси.| ::: noteclassic Не смотря на, что Zabbix может работать с базами данных, поставляемыми в операционных системах, мы рекомендуем всегда использовать базы данных установленные из официальных репозиториев разработчика. ::: ## Databases ## Базы данных ## Databases ## Базы данных ## Databases ## Базы данных ## Databases ## Базы данных ## Databases ## Базы данных ## Databases ## Базы данных ## Databases ## Базы данных ## Databases ## Базы данных ## Databases ## Базы данных #### Database size Zabbix configuration data require a fixed amount of disk space and do not grow much. Zabbix database size mainly depends on these variables, which define the amount of stored historical data: - Number of processed values per second This is the average number of new values Zabbix server receives every second. For example, if you have 3000 items for monitoring with a refresh rate of 60 seconds, the number of values per second is calculated as 3000/60 = **50**. It means that 50 new values are added to Zabbix database every second. - Housekeeper settings for history Zabbix keeps values for a fixed period of time, normally several weeks or months. Each new value requires a certain amount of disk space for data and index. So, if you would like to keep 30 days of history and you receive 50 values per second, the total number of values will be around (**30**\*24\*3600)\* **50** = 129.600.000, or about 130M of values. Depending on the database engine used, type of received values (floats, integers, strings, log files, etc), the disk space for keeping a single value may vary from 40 bytes to hundreds of bytes. Normally it is around 90 bytes per value for numeric items^**2**^. In this case, it means that 130M of values will require 130M \* 90 bytes = **10.9GB** of disk space. ::: noteclassic The size of text/log item values is impossible to predict exactly, but you may expect around 500 bytes per value. ::: - Housekeeper setting for trends Zabbix keeps a 1-hour max/min/avg/count set of values for each item in the table **trends**. The data is used for trending and long period graphs. The one hour period cannot be customized. Zabbix database, depending on the database type, requires about 90 bytes per each total. Suppose you would like to keep trend data for 5 years. Values for 3000 items will require 3000\*24\*365\* **90** = **2.2GB** per year, or **11GB** for 5 years. - Housekeeper settings for events Each Zabbix event requires approximately 250 bytes of disk space^**1**^. It is hard to estimate the number of events generated by Zabbix daily. In the worst-case scenario, you may assume that Zabbix generates one event per second. For each recovered event, an `event_recovery` record is created. Normally, most of the events will be recovered. So, you can assume one `event_recovery` record per event. That means additional 80 bytes per event. Optionally, events can have tags, each tag record requiring approximately 100 bytes of disk space^**1**^. The number of tags per event (\#tags) depends on configuration. So, each will need an additional \#tags \* 100 bytes of disk space. It means that if you want to keep 3 years of events, this would require 3\*365\*24\*3600\* (250+80+\#tags\*100) = **\~30GB**+\#tags\*100B disk space^**2**^. ::: noteclassic ^**1**^ More when having non-ASCII event names, tags and values.<br> ^**2**^ The size approximations are based on MySQL and might be different for other databases. ::: The table contains formulas that can be used to calculate the disk space required for Zabbix system: |Parameter|Formula for required disk space (in bytes)| |---------|------------------------------------------| |*Zabbix configuration*|Fixed size. Normally 10MB or less.| |*History*|days\*(items/refresh rate)\*24\*3600\*bytes<br>items : number of items<br>days : number of days to keep history<br>refresh rate : average refresh rate of items<br>bytes : number of bytes required to keep single value, depends on database engine, normally \~90 bytes.| |*Trends*|days\*(items/3600)\*24\*3600\*bytes<br>items : number of items<br>days : number of days to keep history<br>bytes : number of bytes required to keep single trend, depends on the database engine, normally \~90 bytes.| |*Events*|days\*events\*24\*3600\*bytes<br>events : number of event per second. One (1) event per second in worst-case scenario.<br>days : number of days to keep history<br>bytes : number of bytes required to keep single event, depends on the database engine, normally \~330 + average number of tags per event \* 100 bytes.| So, the total required disk space can be calculated as:\ **Configuration + History + Trends + Events**\ The disk space will NOT be used immediately after Zabbix installation. Database size will grow then it will stop growing at some point, which depends on housekeeper settings. #### Размер базы данных Данные конфигурации Zabbix требуют фиксированное количество дискового пространства и сильно не увеличиваются. Размер базы данных Zabbix в основном зависит от следующих переменных, которые определяют объем хранимых исторических данных: - Количество обрабатываемых значений в секунду Это среднее количество новых значений, которые Zabbix сервер получает каждую секунду. Например: если имеется 3000 элементов данных с интервалом проверки 60 секунд, то количество обрабатываемых запросов за секунду рассчитывается 3000/60 = **50**. Это означает, что каждую секунду в базу данных Zabbix добавляется 50 новых значений. - Настройки очистки истории Zabbix хранит значения определенный период времени, обычно несколько недель или месяцев. Каждое новое значение требует определенный объем дискового пространства для данных и индексов. Таким образом, если требуется хранение 30 дней истории и каждую секунду мы получаем 50 новых значений, общее количество значений будет приблизительно (**30**\*24\*3600)\* **50** = 129.600.000 или около 130М значений. В зависимости от типа базы данных, типа полученных значений (с плавающей точкой, целое число, строки, файлы журналов и т.д.) может потребоваться от 40 байт до сотен байт дискового пространства для хранения одного значения. Обычно одно значение занимает около 90 байт для числового элемента данных^**2**^. В нашем случае это означает, что 130М значений потребуют 130M \* 90 байт = **10.9ГБ** дискового пространства. ::: noteclassic Размер значений текстовых/журнальных элементов данных невозможно предугадать точно, но можно ожидать около 500 байт на значение. ::: - Настройки очистки динамики изменений Zabbix хранит ежечасную статистику значений max/min/avg/count для каждого элемента данных в таблице trends. Эти данные используются для отслеживания **динамики изменений** и для графиков при отображении большого периода времени. Период в 1 час не является настраиваемым. Базе данных Zabbix, в зависимости от типа базы данных, требуется около 90 байт на один элемент динамики изменений. Предположим, что требуется хранить динамику изменений в течение 5 лет. Значения 3000 элементов данных потребуют 3000\*24\*365\* **90** = **2.2ГБ** за год, или **11ГБ** за 5 лет. - Настройки очистки событий Каждое событие Zabbix требует около 250 байт дискового пространства^**1**^. Сложно точно оценить количество событий, ежедневно генерируемых Zabbix сервером. В самом худшем случае, можно предположить, что Zabbix генерирует одно событие в секунду. По каждому событию восстановления создается запись в event_recovery. Обычно большая часть событий восстанавливается, поэтому мы можем предположить, что в event_recovery будет по одной записи по каждому событию. Это означает дополнительные 80 байт на каждое событие. Опционально, у событий могут быть теги, каждая запись тега требует приблизительно 100 байт дискового пространства^**1**^. Количество тегов на событие (\#теги) зависит от конфигурации. Таким образом, каждая запись потребует дополнительно \#теги \* 100 байт дискового пространства. Это означает, что для того, чтобы хранить события 3 года, потребуется 3\*365\*24\*3600\* (250+80+\#tags\*100) = **\~30ГБ**+\#теги\*100 байт дискового пространства^**2**^. ::: noteclassic ^**1**^ Больше, когда имеются не-ASCII имена событий, тегов и значения.<br> ^**2**^ Приблизительные размеры основаны на MySQL и могут отличаться для других баз данных. ::: Представленная ниже таблица содержит формулы для расчета требуемого дискового пространства для системы мониторинга Zabbix: |Параметр|Формула для расчета занимаемого места(в байтах)| |---------|------------------------------------------| |*Конфигурация Zabbix*|Фиксированный размер. Обычно 10МБ или меньше.| |*История*|дней\*(элементов данных/частота обновления)\*24\*3600\*байт<br>элементы данных : количество элементов данных<br>дней : количество дней хранения истории<br>частота обновления : среднее значение периода проверки элементов данных<br>байт : количество байт, требуемых для одного значения, зависит от типа базы данных, около 90 байт| |*Динамика изменений*|дней\*(элементов данных/3600)\*24\*3600\*байт<br>элеменов данных : количество элементов данных<br>дней : количество дней хранения динамики изменений<br>байт : количество байт, требуемых для одного значения, зависит от типа базы данных, около 90 байт.| |*События*|дней\*событий\*24\*3600\*байт<br>событий : количество событий в секунду. Одно (1) событие в секунду в худшем случае.<br>дней : количество дней хранения событий<br>байт : количество байт, требуемых для одного события, зависит от типа базы данных, обычно примерно 330 + среднее количество тегов на событие \* 100 байт.| Итак, общее количество требуемого места на жестком диске рассчитывается:\ **Конфигурация + История + Динамика изменений + События**\ Дисковое пространство НЕ будет использовано сразу же после установки Zabbix. Размер базы данных будет постепенно увеличиваться и остановится по достижении определенного момента, зависящего от настроек очистки базы данных. ## 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#стороннее-внешнее-программное-обеспечение). ## 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#требуемое-программное-обеспечение): - *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 сервер и прокси не запустятся, если будет обнаружена неподдерживаемая версия базы данных. Теперь имеется возможность, хотя и не рекомендуется её использовать, отключить проверку версии БД, изменив параметр AllowUnsupportedDBVersions конфигурации [сервера](/manual/appendix/config/zabbix_server) или [прокси](/manual/appendix/config/zabbix_proxy). ##### 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#требуемое-программное-обеспечение): - *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 сервер и прокси не запустятся, если будет обнаружена неподдерживаемая версия базы данных. Теперь имеется возможность, хоть и не рекомендуется её использовать, отключить проверку версии БД, изменив параметр AllowUnsupportedDBVersions конфигурации [сервера](/manual/appendix/config/zabbix_server) или [прокси](/manual/appendix/config/zabbix_proxy). ### 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). ### Базы данных Чтобы обеспечить оптимальное взаимодействие с пользователем и обеспечить максимальную производительность Zabbix в различных производственных средах, прекращена поддержка некоторых старых выпусков баз данных. Прежде всего это относится к версиям баз данных, срок обслуживания которых приближается к концу, и к версиям с неисправленными проблемами, которые могут помешать нормальной производительности. Начиная с Zabbix 6.0, официально поддерживаются следующие версии [баз данных](/manual/installation/requirements#программное-обеспечение): - *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 сервер и прокси не запустятся, если будет обнаружена неподдерживаемая версия базы данных. Теперь имеется возможность, хотя и не рекомендуется её использовать, отключить проверку версии БД, изменив параметр AllowUnsupportedDBVersions конфигурации [сервера](/manual/appendix/config/zabbix_server) или [прокси](/manual/appendix/config/zabbix_proxy). #### 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). #### 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). ##### 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". #### Соединения TLS к СУБД для MySQL on SLES 12 Пакеты для установки сервера/прокси на SUSE Linux Enterprise Server версии 12 теперь построены с использованием библиотеки MariaDB Connector/C, таким образом разрешая шифрование соединений к MySQL при использовании параметра DBTLSConnect [parameter](/manual/appendix/config/zabbix_server). Поддерживаемыми значениями шифрования являются "required" и "verify\_full". #### 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. #### TLS подключение к базе данных с MariaDB Если используется MariaDB, то соединение TLS к базе данных не поддерживается с опцией *verify\_ca* для [параметра](/manual/appendix/config/zabbix_server) DBTLSConnect . ##### Data collection with parameters Collect the content of a specific page and make use of parameters: - Create an item with type "Script" and two parameters: - **url : {$DOMAIN}** (the user macro {$DOMAIN} should be defined, preferably on the host level) - **subpage : /release_notes** {width=600} - In the *Script* field, enter: ```javascript var obj = JSON.parse(value); var url = obj.url; var subpage = obj.subpage; var request = new HttpRequest(); return request.get(url + subpage); ``` ##### Сбор данных с параметрами Получение содержимого указанной страницы с использованием параметров: - Создайте элемент данных с типом «Скрипт» и двумя параметрами: - **url : {$DOMAIN}** (пользовательский макрос {$DOMAIN} должен быть определён, желательно на уровне узла сети) - **subpage : /release_notes** {width=600} - В поле *Скрипт* введите следующий код: ```javascript var obj = JSON.parse(value); var url = obj.url; var subpage = obj.subpage; var request = new HttpRequest(); return request.get(url + subpage); ``` #### 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, у вас должен быть элемент данных, чтобы создать триггер. У вас должен быть триггер, чтобы создать действие. Таким образом, если вы хотите получать оповещения о слишком высокой загрузке CPU на *Сервере X*, вы сначала должны создать запись об узле сети для *Сервера X*, затем элемент данных для наблюдения за CPU, затем триггер, который сработает, если загрузка CPU будет слишком высокой, а затем действие, которое отправит вам e-mail. Хотя может показаться, что требуется слишком много шагов, при использовании шаблонов на самом деле это не так. Тем не менее, такое построение системы позволяет создавать очень гибкие инсталляции. #### Data limits for return values There is no limit for low-level discovery rule JSON data if it is received directly by Zabbix server. This is because the return values are processed without being stored in a database. There is also no limit for custom low-level discovery rules. However, if custom low-level discovery rule data is retrieved using a user parameter, the user parameter [return value limit](/manual/config/items/userparameters#command-result) applies. If data has to go through Zabbix proxy, it has to store this data in the database. In such a case, [database limits](/manual/config/items/item#text_data_limits) apply. #### Ограничения данных для возвращаемых значений Если значение получается непосредственно Zabbix сервером, то ограничений на данные JSON правил низкоуровневого обнаружения нет, так как возвращаемые значения обрабатываются без сохранения в базе данных. Также нет ограничений для пользовательских правил низкоуровневого обнаружения. Однако, если пользовательские данные LLD опрашиваются с помощью пользовательских параметров, то применяется ограничение на значение, возвращаемое [пользовательским параметром](/manual/config/items/userparameters#результат-команды). Если же данные поступают через Zabbix прокси, он должен сохранять эти данные в своей базе данных. В этом случае применяются [ограничения баз данных](/manual/config/items/item#ограничения-текстовых-данных). #### 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|Значение считается истинным, если оно передано и не равно нулю; в противном случае, оно считается ложным.| |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). ### Обновление схемы базы данных В базе данных в таблицу **items** добавлена новая колонка *name_upper*. Она содержит версию имени элемента данных или правила LLD, приведённую к верхнему регистру. Это изменение было внедрено, чтобы разрешить использование индексов при регистронезависимом поиске для [оптимизации](#оптимизация-запросов-api) запросов API. # 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 #### 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 gateway В случае возникновения каких-либо проблем с Java gateway или в случае, если сообщение об ошибке элемента данных в веб-интерфейсе недостаточно информативно, вы можете обратиться к файлу журнала Java gateway. По умолчанию, Java gateway записывает журнал в файл /tmp/zabbix\_java.log с уровнем журналирования «info». Бывает, что этой информации недостаточно и требуется информация уровня журналирования «debug». Чтобы увеличить уровень журналирования, отредактируйте файл lib/logback.xml и измените атрибут level тега <root> на значение "debug": <root level="debug"> <appender-ref ref="FILE" /> </root> Обратите внимание, что в отличие от Zabbix сервера или Zabbix прокси, вам не нужно перезапускать Zabbix Java gateway после изменения файла logback.xml — изменения в файле logback.xml подхватятся автоматически. Когда вы завершите отладку, вы можете вернуть уровень журналирования обратно в "info". Если вы хотите записывать журнал в другой файл или в совершенно другой носитель такой как база данных, настройте файл logback.xml в соответствии с вашими потребностями. Обратитесь к [Руководству по Logback](http://logback.qos.ch/manual/) для получения более подробных сведений. Иногда для отладки полезно запустить Java gateway как консольное приложение, а не как демон. Чтобы это сделать, закомментируйте переменную PID\_FILE в settings.sh. Если PID\_FILE не указан, скрипт startup.sh запускает Java gateway как консольное приложение, при этом Logback использует файл lib/logback-console.xml, который не только выводит журнал в консоль, но и имеет уровень журналирования "debug". В заключение, отметим, поскольку Java gateway использует SLF4J для журналирования, вы можете заменить Logback выбранным вами фреймворком, поместив соответствующий JAR файл в каталог lib. Обратитесь к [Руководству по SLF4](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 gateway Файл журнала Zabbix Java gateway: /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 gateway Файл журнала Zabbix Java gateway: /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 gateway Файл журнала Zabbix Java gateway: /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) для всей системы или включить аутентификацию LDAP только для конкретных групп пользователей. Чтобы установить LDAP в качестве метода аутентификации по умолчанию для всех пользователей, перейдите к вкладке *LDAP* и настройте параметры аутентификации, затем вернитесь на вкладку *Аутентификация* и установите переключатель *Аутентификация по умолчанию* в положение LDAP. Обратите внимание, что метод аутентификации можно точно настроить на уровне [групп пользователей](/manual/config/users_and_usergroups/usergroup). Даже если глобально настроена аутентификация LDAP, некоторые группы пользователей по-прежнему могут проходить аутентификацию средствами Zabbix. У этих групп [доступ к веб-интерфейсу](/manual/config/users_and_usergroups/usergroup#настройка) должен быть выставлен как Внутренний. И наоборот, если глобально используется внутренняя аутентификация, подробности аутентификации LDAP можно указать и использовать для конкретных групп пользователей, чей [доступ к веб-интерфейсу](/manual/config/users_and_usergroups/usergroup#настройка) настроен как LDAP. Если пользователь входит хотя бы в одну группу пользователей с аутентификацией LDAP, то этот пользователь не сможет использовать метод внутренней аутентификации. Методы аутентификации [HTTP](#аутентификация-http) и [SAML 2.0](#аутентификация-saml) могут использоваться в дополнение к методам аутентификации по умолчанию. #### Default global regular expressions Zabbix comes with several global regular expression in its default dataset. |Name|Expression|Matches| |--|------|------| |*File systems for discovery*|`^(btrfs|ext2|ext3|ext4|jfs|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|refs|apfs|ntfs|fat32|zfs)$`|"btrfs" or "ext2" or "ext3" or "ext4" or "jfs" or "reiser" or "xfs" or "ffs" or "ufs" or "jfs" or "jfs2" or "vxfs" or "hfs" or "refs" or "apfs" or "ntfs" or "fat32" or "zfs"| |*Network interfaces for discovery*|`^Software Loopback Interface`|Strings starting with "Software Loopback Interface".| | |`^lo$`|"lo"| | |`^(In)?[Ll]oop[Bb]ack[0-9._]*$`|Strings that optionally start with "In", then have "L" or "l", then "oop", then "B" or "b", then "ack", which can be optionally followed by any number of digits, dots or underscores.| | |`^NULL[0-9.]*$`|Strings starting with "NULL" optionally followed by any number of digits or dots.| | |`^[Ll]o[0-9.]*$`|Strings starting with "Lo" or "lo" and optionally followed by any number of digits or dots.| | |`^[Ss]ystem$`|"System" or "system"| | |`^Nu[0-9.]*$`|Strings starting with "Nu" optionally followed by any number of digits or dots.| |*Storage devices for SNMP discovery*|`^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$`|"Physical memory" or "Virtual memory" or "Memory buffers" or "Cached memory" or "Swap space"| |*Windows service names for discovery*|`^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$`|"MMCSS" or "gupdate" or "SysmonLog" or strings like "clr\_optimization\_v2.0.50727\_32" and "clr\_optimization\_v4.0.30319\_32" where instead of dots you can put any character except newline.| |*Windows service startup states for discovery*|`^(automatic|automatic delayed)$`|"automatic" or "automatic delayed"| #### Глобальные регулярные выражения по умолчанию Zabbix поставляется с несколькими глобальными регулярными выражениями в своем наборе данных по умолчанию. |Имя|Выражение|Соответствие| |--|------|------| |*File systems for discovery*|`^(btrfs|ext2|ext3|ext4|jfs|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|refs|apfs|ntfs|fat32|zfs)$`|«btrfs» или «ext2» или «ext3» или «ext4» или «jfs» или «reiser» или «xfs» или «ffs» или «ufs» или «jfs» или «jfs2» или «vxfs» или «hfs» или «refs» или «apfs» или «ntfs» или «fat32» или «zfs»| |*Network interfaces for discovery*|`^Software Loopback Interface`|Строки, начинающиеся с «Software Loopback Interface».| | |`^lo$`|«lo»| | |`^(In)?[Ll]oop[Bb]ack[0-9._]*$`|Строки, которые необязательно начинаются с «In», затем имеют «L» или «l», затем «oop», затем «B» или «b», затем «ack», за которыми может следовать любое количество цифр, точек или символов подчёркивания.| | |`^NULL[0-9.]*$`|Строки, начинающиеся с «NULL», за которыми может следовать любое количество цифр или точек.| | |`^[Ll]o[0-9.]*$`|Строки, начинающиеся с «Lo» или «lo», за которыми может следовать любое количество цифр или точек.| | |`^[Ss]ystem$`|«System» или «system»| | |`^Nu[0-9.]*$`|Строки, начинающиеся с «Nu», за которым может следовать любое количество цифр или точек.| |*Storage devices for SNMP discovery*|`^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$`|«Physical memory» или «Virtual memory» или «Memory buffers» или «Cached memory» или «Swap space»| |*Windows service names for discovery*|`^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$`|«MMCSS» или «gupdate» или «SysmonLog» или строки наподобие «clr\_optimization\_v2.0.50727\_32» и «clr\_optimization\_v4.0.30319\_32», где вместо точек можно поместить любой символ, за исключением перевода строки.| |*Windows service startup states for discovery*|`^(automatic|automatic delayed)$`|«automatic» или «automatic delayed»| #### 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 gateway|10052|TCP|по требованию| |Zabbix веб-сервис|10053|TCP|по требованию| |Zabbix веб-интерфейс|80|HTTP|по требованию| |^|443|HTTPS|по требованию| |Zabbix траппер|10051 |TCP| по требованию| ::: noteclassic Эти номера портов должны быть открыты в брандмауэре, чтобы подключения Zabbix были разрешены. Исходящие TCP подключения обычно не требуют явных настроек брандмауэра. ::: #### 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 настроен с четырьмя ролями пользователей, которые имеют заранее определённый набор прав: - Роль Администратор (Admin role) - Роль Гость (Guest role) - Роль Супер-администратор (Super admin role) - Роль Пользователь (User role) {width="600"} Отображается список всех пользователей, которым назначена соответствующая роль. Пользователи, включённые в деактивированные группы, обозначены красным цветом. ::: noteclassic Заданная по умолчанию роль *Супер-администратор* не может быть изменена или удалена, потому что в Zabbix должен существовать хотя бы один Супер-администратор с неограниченными привилегиями. ::: Пользователи типа *Супер-администратор* и необходимыми правами доступа могут изменять и удалять существующие роли, а также создавать новые роли с нужным набором настроек. Чтобы создать новую роль, нажмите кнопку *Создать роль пользователя* в правом верхнем углу. Для внесения изменений в существующую роль нажмите на название роли, чтобы открыть диалог настроек.  Доступные права вместе с наборами прав для преднастроенных ролей пользователей в Zabbix описаны ниже. | | | | | | | | |-|----------|--------------------------------------|----|----|----|----| |**Параметр**|<|**Описание**|**Роли пользователей по умолчанию**|<|<|<| | |<|<|*Роль Супер-администратора*|*Роль Администратора*|*Роль Пользователя*|*Роль Гостя*| |Тип пользователя<br>(User type)|<|Выбранный тип пользователя определяет список доступных разрешений.<br>После выбора типа пользователя ему по умолчанию предоставляются все доступные разрешения для этого типа пользователя.<br>Снимите нужные флажки, чтобы отозвать опредёленные разрешения для роли пользователя.<br>Флажки для разрешений, недоступных для этого типа пользователей, неактивны.|Супер-администратор|Администратор|Пользователь|Пользователь| |**Доступ к элементам веб-интерфейса (Access to UI elements)**|<|<|<|<|<|<| |*Мониторинг (Monitoring)*|<|<|<|<|<|<| | |Панель<br>(Dashboard)|Разрешение/запрет доступа к определённым подразделам раздела *Мониторинг* и содержащимся в них страницам.|Да|Да|Да|Да| |^|Проблемы<br>(Problems)|^|^|^|^|^| |^|Узлы сети<br>(Hosts)|^|^|^|^|^| |^|Последние данные<br>(Latest data)|^|^|^|^|^| |^|Карты сетей<br>(Maps)|^|^|^|^|^| |^|Обнаружение<br>(Discovery)|^|^|^|Нет|Нет| |*Услуги (Services)*|<|<|<|<|<|<| | |Услуги<br>(Services)|Разрешение/запрет доступа к определённым подразделам раздела *Услуги* и содержащимся в них страницам.|Да|Да|Да|Да| |^|Действия на услуги<br>(Service actions)|^|^|^|Нет|Нет| |^|SLA|^|^|^|^|^| |^|SLA отчёт<br>(SLA report)|^|^|^|Да|Да| |*Инвентаризация (Inventory)*|<|<|<|<|<|<| | |Обзор<br>(Overview)|Разрешение/запрет доступа к определённым подразделам раздела *Инвентаризация* и содержащимся в них страницам.|Да|Да|Да|Да| |^|Узлы сети<br>(Hosts)|^|^|^|^|^| |*Отчёты (Reports)*|<|<|<|<|<|<| | |Информация о системе<br>(System information)|Разрешение/запрет доступа к определённым подразделам раздела *Отчёты* и содержащимся в них страницам.|Да|Нет|Нет|Нет| |^|Отчёт о доступности<br>(Availability report)|^|^|Да|Да|Да| |^|100 наиболее активных триггеров<br>(Triggers top 100)|^|^|^|^|^| |^|Аудит<br>(Audit)|^|^|Нет|Нет|Нет| |^|Журнал действий<br>(Action log)|^|^|^|^|^| |^|Оповещения<br>(Notifications)|^|^|Да|^|^| |^|Регулярные отчёты<br>(Scheduled reports)|^|^|^|^|^| |*Настройка (Configuration)*|<|<|<|<|<|<| | |Группы узлов сети<br>(Host groups)|Разрешение/запрет доступа к определённым подразделам раздела *Настройка* и содержащимся в них страницам.|Да|Да|Нет|Нет| |^|Шаблоны<br>(Templates)|^|^|^|^|^| |^|Узлы сети<br>(Hosts)|^|^|^|^|^| |^|Обслуживание<br>(Maintenance)|^|^|^|^|^| |^|Действия<br>(Actions)|^|^|^|^|^| |^|Корреляция событий<br>(Event correlation)|^|^|Нет|^|^| |^|Обнаружение<br>(Discovery)|^|^|Да|^|^| |*Администрирование (Administration)*|<|<|<|<|<|<| | |Общие<br>(General)|Разрешение/запрет доступа к определённым подразделам раздела *Администрирование* и содержащимся в них страницам.|Да|Нет|Нет|Нет| |^|Прокси<br>(Proxies)|^|^|^|^|^| |^|Аутентификация<br>(Authentication)|^|^|^|^|^| |^|Группы пользователей<br>(User groups)|^|^|^|^|^| |^|Роли пользователей<br>(User roles)|^|^|^|^|^| |^|Пользователи<br>(Users)|^|^|^|^|^| |^|Способы оповещений<br>(Media types)|^|^|^|^|^| |^|Скрипты<br>(Scripts)|^|^|^|^|^| |^|Очередь<br>(Queue)|^|^|^|^|^| |*Доступ по умолчанию к новым элементам интерфейса*<br>*(Default access to new UI elements)*|<|Эта опция определяет, как новые разделы меню будут доступны после обновления Zabbix. Существующие разделы меню модулей остаются неизменными.|Да|Да|Да|Да| |**Доступ к услугам (Access to services)**|<|<|<|<|<|<| | |Доступ к услугам на чтение-запись<br>(Read-write access to services)|Выберите вариант доступа к услугам на чтение-запись:<br>**Нет** — совсем запретить доступ<br>**Все** — доступ ко всем услугам с правом чтения/записи<br>**Список услуг** — выберите услуги, для которых разрешить чтение/запись<br><br>Если предоставлен доступ с правом чтения/записи, он имеет преимущество перед настройками доступа с правом только чтения и динамически наследуется дочерними услугами.|Все|Все|Нет|Нет| |^|Доступ к услугам с тегом на чтение-запись<br>(Read-write access to services with tag)|Укажите имя тега и (не обязательно) значение, чтобы дополнительно предоставить доступ с правом чтения/записи к услугам с соответствующим тегом.<br>Эта возможность доступна, если для *Доступ к услугам на чтение-запись* выбрано «Список услуг».<br>Если предоставлен доступ с правом чтения/записи, он имеет преимущество перед настройками доступа с правом только чтения и динамически наследуется дочерними услугами.|^|^|^|^| |^|Доступ к услугам только на чтение<br>(Read-only access to services)|Выберите вариант доступа к услугам только на чтение:<br>**Нет** — совсем запретить доступ<br>**Все** — доступ ко всем услугам с правом только чтения<br>**Список услуг** — выберите услуги, для которых разрешить только чтение<br><br>Доступ с правом только чтения не имеет преимущества перед настройками доступа с правом чтения/записи и динамически наследуется дочерними услугами.|^|^|Все|Все| |^|Доступ к услугам с тегом только на чтение<br>(Read-only access to services with tag)|Укажите имя тега и (не обязательно) значение, чтобы дополнительно предоставить доступ с правом только чтения к услугам с соответствующим тегом.<br>Эта возможность доступна, если для *Доступ к услугам только на чтение* выбрано «Список услуг».<br>Доступ с правом только чтения не имеет преимущества перед настройками доступа с правом чтения/записи и динамически наследуется дочерними услугами.|^|^|^|^| |**Доступ к модулям (Access to modules)**|<|<|<|<|<|<| | |<Имя модуля><br>(<Module name>)|Разрешить/запретить доступ к конкретному модулю. В этом разделе показываются только активированные модули. К модулю, который в настоящее время деактивирован, нельзя предоставить или ограничить доступ.|Да|Да|Да|Да| |^|*Доступ по умолчанию к новым модулям*<br>*(Default access to new modules)*|Эта опция определяет, как новые модули и виджеты будут доступны после обновления Zabbix. Она также применяется к модулям и виджетам, добавленным в разделе *Администрирование > Общие > Модули*.|^|^|^|^| |**Доступ к API (Access to API)**|<|<|<|<|<|<| | |*Активировано*<br>*(Enabled)*|Активировать/деактивировать доступ к API.|Да|Да|Да|Нет| |^|*Методы API*<br>*(API methods)*|Выберите *Список разрешений*, чтобы разрешить только отмеченные методы API, или *Список запретов*, чтобы запретить только отмеченные методы API.<br><br>Начните набирать имя метода в поле поиска, затем выберите необходимый из предложенных вариантов.<br>Также можете нажать *Выбрать* и в открывшемся списке методов, доступных для этого типа пользователя, выбрать нужный. Учтите, что, если конкретное действие не отмечено в блоке *Доступ к действиям*, пользователи не смогут использовать методы API, относящиеся к этому действию.<br><br>Поддерживаются подстановочные символы. Примеры: `dashboard.*` (все методы «dashboard.» службы API) `*` (любой метод), `*.export` (методы с именем «.export» из всех служб API).<br><br>Если методы не указаны, правило Списка разрешений/запретов будет игнорироваться.|^|^|^|^| |**Доступ к действиям (Access to actions)**|<|<|<|<|<|<| | |Создание и изменение панелей<br>(Create and edit dashboards)|Если снять этот флажок, также будут отозваны права на использование методов API `.create`, `.update` и `.delete` для соответствующих элементов.|Да|Да|Да|Нет| |^|Создание и изменение карт<br>(Create and edit maps)|^|^|^|^|^| |^|Создание и изменение обслуживаний<br>(Create and edit maintenance)|^|^|^|Нет|^| |^|Добавление комментариев к проблемам<br>(Add problem comments)|Если снять этот флажок, также будут отозваны права на выполнение соответствующего действия при помощи метода API `event.acknowledge`.|^|^|Да|^| |^|Изменение важности<br>(Change severity)|^|^|^|^|^| |^|Подтверждение проблем<br>(Acknowledge problems)|^|^|^|^|^| |^|Закрытие проблем<br>(Close problems)|^|^|^|^|^| |^|Выполнение скриптов<br>(Execute scripts)|Если снять этот флажок, также будут отозваны права на использование метода API `script.execute`.|^|^|^|^| |^|Управление API токенами<br>(Manage API tokens)|Если снять этот флажок, также будут отозваны права на использование всех методов API `token.`|^|^|^|^| |^|Управление регулярными отчётами<br>(Manage scheduled reports)|Если снять этот флажок, также будут отозваны права на использование всех методов API `report.`|^|^|Нет|^| |^|Управление SLA<br>(Manage SLA)|Активировать/деактивировать права на управление [SLA](/manual/web_interface/frontend_sections/services/sla).|^|^|^|^| |^|Доступ по умолчанию к новым действиям<br>(Default access to new actions)|Эта опция определяет, как новые действия будут доступны после обновления Zabbix.|^|^|Да|^| Примечания: - Каждому пользователю может быть назначена только одна роль. - Если элемент ограничен, пользователи не смогут получить к нему доступ даже при вводе прямого URL-адреса этого элемента в браузере. - Пользователи с типом *Пользователь* или *Администратор* не могут изменять настройки своей роли. - Пользователи с типом *Супер-администратор* могут изменять настройки своей собственной роли (недоступно для *роли Супер-администратора* по умолчанию), но не могут изменить тип пользователя. - Пользователи всех уровней не могут изменять свой собственный тип пользователя. Смотрите также: - [Настройка пользователя](/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.<ИмяПлагина>.Default.<Параметр>` - например: `Plugins.MongoDB.Default.Uri=tcp://localhost:27017`. Для более подробной информации смотрите: - [Настройка плагинов](/manual/config/items/plugins#настройка-плагинов) - [Параметры файлов конфигурации плагинов](/manual/appendix/config/zabbix_agent2_plugins) ##### Default values Since Zabbix 6.0.18, you can set default values for the connection-related parameters (URI, username, password, etc.) in the configuration file in the format: *Plugins.<PluginName>.Default.<Parameter>=<Value>* For example, *Plugins.Mysql.Default.Username=zabbix*, *Plugins.MongoDB.Default.Uri=tcp://127.0.0.1:27017*, etc. If a value for such parameter is not provided in an item key or in the [named session](#named-sessions) parameters, the plugin will use the default value. If a default parameter is also undefined, hardcoded defaults will be used. ::: noteclassic If an item key does not have any parameters, Zabbix agent 2 will attempt to collect the metric using values defined in the default parameters section. ::: ##### Значения по умолчанию Начиная с версии Zabbix 6.0.18, в конфигурационном файле можно выставить значения по умолчанию для параметров, относящихся к соединению (URI, имя пользователя, пароль и т.д.), в следующем формате: *Plugins.<ИмяПлагина>.Default.<Параметр>=<Значение>* Например: *Plugins.Mysql.Default.Username=zabbix*, *Plugins.MongoDB.Default.Uri=tcp://127.0.0.1:27017* и т.д. Если значение для такого параметра не задано в ключе элемента данных или в параметрах [именованной сессии](#именованные-сессии), плагин будет использовать это значение по умолчанию. Если значение параметра по умолчанию тоже не определено, то будет использоваться жёстко заданное в коде значение по умолчанию. :::noteclassic Если элемент данных не имеет никаких параметров, Zabbix агент 2 будет пытаться собрать метрику, используя значения, определённые в секции значений параметров по умолчанию. ::: ##### Defining items Each item is defined in a ZBX\_METRIC structure: ``` {.c} typedef struct { char *key; unsigned flags; int (*function)(); char *test_param; } ZBX_METRIC; ``` Here, **key** is the item key (e.g., "dummy.random"), **flags** is either CF\_HAVEPARAMS or 0 (depending on whether the item accepts parameters or not), **function** is a C function that implements the item (e.g., "zbx\_module\_dummy\_random"), and **test\_param** is the parameter list to be used when Zabbix agent is started with the "-p" flag (e.g., "1,1000", can be NULL). An example definition may look like this: ``` {.c} static ZBX_METRIC keys[] = { { "dummy.random", CF_HAVEPARAMS, zbx_module_dummy_random, "1,1000" }, { NULL } } ``` Each function that implements an item should accept two pointer parameters, the first one of type AGENT\_REQUEST and the second one of type AGENT\_RESULT: ``` {.c} int zbx_module_dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result) { ... SET_UI64_RESULT(result, from + rand() % (to - from + 1)); return SYSINFO_RET_OK; } ``` These functions should return SYSINFO\_RET\_OK, if the item value was successfully obtained. Otherwise, they should return SYSINFO\_RET\_FAIL. See example "dummy" module below for details on how to obtain information from AGENT\_REQUEST and how to set information in AGENT\_RESULT. ##### Определение элементов данных Каждый элемент данных определяется в структуре ZBX\_METRIC: ``` {.c} typedef struct { char *key; unsigned flags; int (*function)(); char *test_param; } ZBX_METRIC; ``` Здесь, **key** — ключ элемента данных (например, "dummy.random"), **flags** — либо CF\_HAVEPARAMS, либо 0 (в зависимости от того, принимает ли элемент данных параметры или нет), **function** — C функция, которая обрабатывает элемент данных (например, «zbx\_module\_dummy\_random»), и **test\_param** — список параметров, который используется, когда Zabbix агент запускается с флагом «-p» (например, "1,1000", может быть NULL). Пример определения может выглядеть наподобие этого: ``` {.c} static ZBX_METRIC keys[] = { { "dummy.random", CF_HAVEPARAMS, zbx_module_dummy_random, "1,1000" }, { NULL } } ``` Каждая функция, которая обрабатывает элемент данных, должна принимать в качестве параметров два указателя, первый с типом AGENT\_REQUEST и второй с типом AGENT\_RESULT: ``` {.c} int zbx_module_dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result) { ... SET_UI64_RESULT(result, from + rand() % (to - from + 1)); return SYSINFO_RET_OK; } ``` Эти функции должны возвращать SYSINFO\_RET\_OK, если значение элемента данных получено успешно. В противном случае, функции должны возвращать SYSINFO\_RET\_FAIL. Смотрите пример модуля «dummy» ниже для получения деталей, как получать информацию из AGENT\_REQUEST и как указывать информацию в AGENT\_RESULT. #### 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#предобработка-значений-элементов-данных)*** \- *преобразование полученного метрикой значения* перед сохранением этого значения в базу данных. ***[триггер](/manual/config/triggers)*** \- *логическое выражение, которое определяет порог проблемы и используется для «оценки» данных, полученных элементами данных.* Если полученные данные превышают порог, триггер переходит из состояния «Ок» в состояние «Проблема». Когда полученные данные ниже порога, триггер остается/возвращается в состояние «Ок». ***[событие](/manual/config/events)*** \- *одиночное возникновение того, что заслуживает внимания, например изменение состояния триггера или обнаружение/авторегистрация агента.* ***[тег события](/manual/config/tagging)*** \- *предопределённый маркер для события.* Его можно использовать в корреляции событий, в определении прав доступа и т.д. ***[корреляция событий](/manual/config/event_correlation)*** \- *гибкий и точный метод корреляции проблем с решением этих проблем.* Например, вы можете задать, что проблема, которую сообщил один триггер, может быть решена другим триггером, который может использовать даже совершенно другой метод сбора данных. ***[проблема](/manual/web_interface/frontend_sections/monitoring/problems)*** \- *триггер, который находится в состоянии «Проблема».* ***[обновление проблемы](/manual/acknowledges#обновление-проблем)*** \- *варианты управления проблемами в 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)*** \- *набор объектов (элементов данных, триггеров, графиков, правил низкоуровневого обнаружения, веб-сценариев), готовых к применению на одном или нескольких узлах сети.* Задача шаблонов — ускорить развёртывание задач мониторинга узлов сети, а также упростить применение массовых изменений к задачам наблюдения. Шаблоны соединяются напрямую с отдельными узлами сети. ***[веб-сценарий](/manual/web_monitoring)*** \- *один или несколько HTTP-запросов для проверки доступности веб-сайта.* ***[веб-интерфейс](/manual/introduction/overview#архитектура)*** \- *поставляемый с Zabbix веб-интерфейс.* ***[панель](/manual/web_interface/frontend_sections/monitoring/dashboard)*** \- *настраиваемый раздел веб-интерфейса, который отображает сводку и визуализацию* важной информации в визуальных блоках, называемых виджетами. ***[виджет](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)*** \- *визуальный блок, который отображает информацию определенного вида и источника* (сводка, карта, график, часы и т.д.), используется на панели. ***[Zabbix API](/manual/api)*** \- *Zabbix API позволяет вам использовать протокол JSON RPC для создания, обновления и получения объектов Zabbix (например, узлов сети, элементов данных, графиков и прочих) или для выполнения любых других оригинальных задач.* ***[Zabbix сервер](/manual/concepts/server)*** \- *центральный процесс программного обеспечения Zabbix, который выполняет мониторинг, взаимодействует с прокси и агентами Zabbix, вычисляет триггеры, отправляет оповещения; центральное хранилище данных.* ***[Zabbix прокси](/manual/concepts/proxy)*** \- *процесс, который может собирать данные от имени Zabbix сервера, перенимая часть нагрузки сервера.* ***[Zabbix агент](/manual/concepts/agent)*** \- *процесс, разворачиваемый на наблюдаемых целях для активного мониторинга локальных ресурсов и приложений.* ***[Zabbix агент 2](/manual/concepts/agent2)*** \- *Zabbix агент нового поколения для активного мониторинга локальных ресурсов и приложений, который позволяет использовать пользовательские плагины для выполнения функций мониторинга.* ::: noteimportant Поскольку Zabbix агент 2 имеет во многом схожий функционал с Zabbix агентом, термин «Zabbix агент» в документации означает как Zabbix агента, так и Zabbix агента 2, если функционал не отличается. Zabbix агент 2 указывается отдельно в случае наличия разницы по функционалу. ::: ***[шифрование](/manual/encryption)*** \- *поддержка шифрованной связи между компонентами Zabbix (сервером, прокси, агентом и утилитами zabbix_sender и zabbix_get)* с использованием протокола защиты транспортного уровня (TLS). ***[обнаружение сети](/manual/discovery/network_discovery)*** \- *автоматическое обнаружение сетевых устройств*. ***[низкоуровневое обнаружение](/manual/discovery/low_level_discovery)*** \- *автоматическое обнаружение низкоуровневых объектов на конкретном устройстве* (например, файловые системы, сетевые интерфейсы и т.д.). ***[правило низкоуровневого обнаружения](/manual/discovery/low_level_discovery#правило-обнаружения)*** \- *набор определений для автоматического обнаружения низкоуровневых объектов* на устройстве. ***[прототип элементов данных](/manual/discovery/low_level_discovery#прототипы-элементов-данных)*** \- *метрика, у которой некоторые параметры представлены в виде переменных, готовых для низкоуровневого обнаружения*. После низкоуровневого обнаружения эти переменные автоматически заменяются реальными обнаруженными параметрами и метрика автоматически начинает сбор данных. ***[прототип триггеров](/manual/discovery/low_level_discovery#прототипы-триггеров)*** \- *триггер, у которого некоторые параметры представлены в виде переменных, готовых для низкоуровневого обнаружения*. После низкоуровневого обнаружения эти переменные автоматически заменяются реальными обнаруженными параметрами и триггер автоматически начинает оценку данных. *Прототипы* некоторых других объектов Zabbix также используются в низкоуровневом обнаружении — прототипы графиков, прототипы узлов сети, прототипы групп узлов сети. ***[авторегистрация агентов](/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 } ``` #### Удаление нескольких действий Удалить два действия. Запрос: ```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 } ``` #### Удаление нескольких корреляций Удаление двух корреляций. Запрос: ```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 } ``` #### Удаление нескольких правил обнаружения Удалить два правила обнаружения. Запрос: ```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 } ``` #### Удаление нескольких соответствий иконок Удалить два соответствия иконок. Запрос: ```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 } ``` #### Удаление нескольких изображений Удалить два изображения. Запрос: ```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 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 } ``` #### Удаление нескольких проски Удалить две прокси Запрос: ```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 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 } ``` #### Удаление нескольких токенов Удалить два токена. Запрос: ```json { "jsonrpc": "2.0", "method": "token.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188", "192" ] }, "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 } ``` #### Удаление нескольких панелей Удалить две панели. Запрос: ```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 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 } ``` #### Удаление нескольких прототипов графиков Удалить два прототипа графиков. Запрос: ```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 } ``` #### Удаление нескольких графиков Удалить два графика. Запрос: ```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 } ``` #### Удаление нескольких групп узлов сети Удалить две группы узлов сети. Запрос: ```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 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 } ``` #### Удаление нескольких прототипов узлов сети Удалить два прототипа узлов сети. Запрос: ```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 } ``` #### Удаление нескольких хостов Удалить два хоста. Запрос: ```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 правил Удалить два 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 } ``` #### Удаление нескольких периодов обслуживания Удалить два периода обслуживания. Запрос: ```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 } ``` #### Удаление нескольких способов оповещения Удалить два способа оповещения. Запрос: ```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 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 } ``` #### Удаление нескольких услуг Удалить две услуги. Запрос: ```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 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 } ``` #### Удаление нескольких панелей шаблона Удаление две панели шаблона. Запрос: ```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 } ``` #### Удаление нескольких шаблонов Удалить два шаблона. Запрос: ```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 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 } ``` #### Удаление нескольких групп пользователей Удалить две группы пользователей. Запрос: ```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 } ``` #### Удаление нескольких ролей пользователей Удалить две роли пользователей. Запрос: ```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 } ``` #### Удаление нескольких пользователей Удалить двух пользователей. Запрос: ```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 } ``` #### Удаление нескольких преобразований значений Удалить два преобразования значений. Запрос : ```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 } ``` #### Удаление нескольких веб-сценариев Удалить два веб-сценария. Запрос: ```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 может иметь новые ключи, которые не ограничены явным образом существующими настройками. Это может привести к бреши в безопасности. ::: ##### 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. Этот элемент данных будет возвращать целочисленное значение для данного датчика. ##### 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 прототип элемента данных с типом «Зависимый элемент данных (Dependent item)». В качестве основного элемента данных для этого прототипа выберите созданный ранее элемент данных `vfs.fs.get`.  Обратите внимание на использование настраиваемых макросов в имени и ключе прототипа элемента данных: - *Имя (Name)*: Free disk space on {\#FSNAME}, type: {\#FSTYPE} - *Ключ (Key)*: Free\[{\#FSNAME}\] В качестве типа информации используйте: - *Числовой (целое положительное)* для метрик наподобие «free», «total», «used» - *Числовой (с плавающей точной)* для метрик наподобие «pfree», «pused» (проценты) На вкладке «Предобработка (Preprocessing)» прототипа элемента данных выберите JSONPath и используйте следующее выражение JSONPath как параметр: $.[?(@.fsname=='{#FSNAME}')].bytes.free.first()  При запуске обнаружения будет создано по одному элементу данных на каждую точку монтирования. Этот элемент данных вернёт для данной точки монтирования количество свободных байтов. ##### 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 Создайте правило низкоуровневого обнаружения с типом «Зависимый элемент данных (Dependent item)»:  В качестве основного элемента данных выберите элемент данных `vfs.fs.get`, созданный ранее. На вкладке «LLD Макросы (LLD macros)» определите настраиваемые макросы с соответствующими путями 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]` ##### Устаревшие внутренние элементы данных для истории / динамики изменений Следующие внутренние элементы данных теперь считаются устаревшими и будут удалены в будущем мажорном выпуске: - `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(параметры объекта)` Этот метод позволяет сравнить файл импорта с текущими элементами системы и показывает, что будет изменено, если этот файл импорта будет импортирован. ::: 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(параметры объекта)` Этот метод позволяет импортировать данные конфигурации из сериализованной строки. ::: 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(параметры объекта)` Этот метод позволяет извлекать действия в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет получать оповещения по заданным параметрам. ::: 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(параметры объекта)` Метод позволяет получить записи журнала аудита в соответствии с заданными параметрами. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет получать корреляции в соответствии с заданными параметрами. ::: 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(параметры объекта)` Этот метод позволяет получать панели в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет получить проверки обнаружения по заданным параметрам. ::: 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(параметры объекта)` Метод позволяет получить обнаруженные узлы сети по заданным параметрам. ::: 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(параметры объекта)` Этот метод позволяет получать правила 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(параметры объектов)` Этот метод позволяет получать правила обнаружения в соответствии с заданными параметрами. ::: 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(параметры объекта)` Этот метод позволяет получать обнаруженные сервисы в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет извлекать события в соответствии с заданными параметрами. ::: 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(параметры объекта)` Этот метод позволяет получать графики в соответствии с заданными параметрами. ::: 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(параметры объекта)` Этот метод позволяет получать элементы графика в соответствии с заданными параметрами. ::: 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(параметры объекта)` Этот метод позволяет получать прототипы графиков в соответствии с заданными параметрами. ::: noteclassic Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Метод позволяет получить список узлов кластера высокой доступности по заданным параметрам. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `integer/array history.get(object parameters)` The method allows to retrieve history data according to the given parameters. ::: noteimportant This method may return historical data of a deleted entity if this data has 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 history.get(параметры объекта)` Метод позволяет получить данные истории по заданным параметрам. ::: noteimportant Этот метод может возвращать исторические данные удаленного объекта, если эти данные еще не были удалены служебной программой. ::: ::: noteclassic Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Метод позволяет получить хосты по заданным параметрам. ::: 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(параметры объекта)` Этот метод позволяет получать группы узлов сети в соответствии с заданными параметрами. ::: noteclassic Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет получать интерфейсы узлов сети в соответствии с заданными параметрами. ::: 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(параметры объекта)` Этот метод позволяет получать прототипы узлов сети в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет извлекать веб-сценарии по заданным параметрам. ::: 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(параметры объекта)` Метод позволяет получать карты иконок по заданным параметры. ::: 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(параметры объекта)` Этот метод позволяет получать изображения в соответствии с заданными параметрами. ::: 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(параметры объекта)` Этот метод позволяет получать элементы данных в соответствии с заданными параметрами. ::: 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(параметры объекта)` Этот метод позволяет получать прототипы элементов данных в соответствии с заданными параметрами. ::: 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(параметры объекта)` Этот метод позволяет получать обслуживания в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет получать карты по заданным параметрам. ::: 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(параметры объекта)` Метод позволяет извлекать задачи по заданным параметры. Этот метод предназначен для извлечения нерешенных проблем. Также возможно, если указано, для дополнительного получения недавно решенных проблем. период, который определяет, сколько лет «недавно», определяется в *Администрация* → *[Общие](/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(параметры объекта)` Этот метод позволяет получать прокси в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет получать глобальные регулярные выражения по заданным параметрам. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Метод позволяет получать запланированные отчеты по заданным параметрам. ::: 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(параметры объекта)` Этот метод позволяет получать роли в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет получать скрипты по заданным параметрам. ::: noteclassic Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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(параметры объекта)` Метод позволяет получать услуги по заданным параметры. ::: 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(параметры объекта)` Метод позволяет получать объекты 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(параметры объекта)` Метод позволяет получать задачи по заданным параметрам. Метод возвращает сведения только о задачах 'диагностической информации'. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Метод позволяет получить шаблоны панелей мониторинга в соответствии с заданными параметрами. ::: 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(параметры объекта)` Этот метод позволяет получать шаблоны в соответствии с заданными параметрами. ::: 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. ::: ### Описание `целое число/массив token.get(параметры объекта)` Этот метов позволяет получать токены в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет получить данные о трендах в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет получать триггеры по заданным параметрам. ::: 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 itemprototype.get(параметры объекта)` Этот метод позволяет получать прототипы элементов данных в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет получать пользователей по заданным параметрам. ::: 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(параметры объекта)` Метод позволяет получить группы пользователей в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет получить хостовые и глобальные макросы в соответствии с заданными параметрами. ::: 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(параметры объекта)` Метод позволяет получить преобразование значений в соответствии с заданными параметрами. ::: 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 Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив actionIds)` Этот метод позволяет удалять действия. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода могут быть отключены в настройках роли пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив действий)` Этот метод позволяет обновить существующие действия. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Метод позволяет получить объект аутентификации в соответствии с заданными параметрами. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект authentication)` Этот метод позволяет обновить существующие настройки аутентификации. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Метод позволяет получить объект авторегистрации по заданным параметрам. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект autoregistration)` Этот метод позволяет обновить существующую авторегистрацию. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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.update(объект/массив correlations)` Этот метод позволяет создавать новые корреляции. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив correlationids)` Этот метод позволяет удалять корреляции. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив correlations)` Этот метод позволяет обновить существующие корреляции. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив 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(массив 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(объект/массив 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(параметры объекта)` Этот метод позволяет копировать правила LLD со всеми их прототипами в заданные узлы сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив lldRules)` Этот метод позволяет создавать новые правила LLD. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив lldRuleIds)` Этот метод позволяет удалять правила LLD. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив lldRules)` Этот метод позволяет обновлять существующие правила LLD. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив discoveryRules)` Этот метод позволяет создавать новые правила обнаружения. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив discoveryRuleIds)` Этот метод позволяет удалять правила обнаружения. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив discoveryRules)` Этот метод позволяет обновлять существующие правила обнаружения. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив graphs)` Этот метод позволяет создавать новые графики. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив graphIds)` Этот метод позволяет удалять графики. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив graphPrototypes)` Этот метод позволяет создавать новые прототипы графиков. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив graphPrototypeIds)` Этот метод позволяет удалять прототипы графиков. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив graphPrototypes)` Этот метод позволяет обновлять существующие прототипы графиков. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив graphs)` Этот метод позволяет обновлять существующие графики. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив itemids)` Этот метод позволяет очистить историю элемента. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив hosts)` Этот метод позволяет создавать новые хосты. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив hosts)` Этот метод позволяет удалять узлы сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив hostGroups)` Этот метод позволяет создавать новые группы узлов сети. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив hostGroupIds)` Этот метод позволяет удалять группы узлов сети. Группу узлов сети нельзя удалить в случае, если: - она содержит узлы сети, которые принадлежат только этой группе узлов сети; - она отмечена как внутренняя; - она используется прототипом узлов сети; - она используется в глобальном скрипте; - она используется в условии корреляции. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет добавить одновременно несколько связанных объектов во все заданные группы узлов сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет удалить связанные объекты из нескольких групп узлов сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет заменить узлы сети и шаблоны на указанные сразу в нескольких группах узлов сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив hostGroups)` Этот метод позволяет обновлять существующие группы узлов сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив hostInterfaces)` Этот метод позволяет создавать новые интерфейсы узлов сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив hostInterfaceIds)` Этот метод позволяет удалять интерфейсы узлов сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет добавить одновременно несколько интерфейсов узлов сети на узлы сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет удалить интерфейсы узлов сети у заданных узлов сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет заменить все интерфейсы узла сети на заданном узле сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив hostInterfaces)` Этот метод позволяет обновлять существующие интерфейсы узлов сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет одновременно добавлять несколько связанных объектов во все заданные хосты. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет удалять связанные объекты с нескольких хостов. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет одновременно заменять или удалять связанные объекты и обновлять свойства на нескольких хостах. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив hostPrototypes)` Этот метод позволяет создавать новые прототипы узлов сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив hostPrototypeIds)` Этот метод позволяет удалять прототипы узлов сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив hostPrototypes)` Этот метод позволяет обновлять существующие прототипы узлов сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив hosts)` Этот метод позволяет обновлять существующие узлы сети. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Метод позволяет получить объект обслуживания в соответствии с заданными параметрами. ::: noteclassic Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект обслуживания)` Этот метод позволяет обновить существующие настройки управления. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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)` Этот метод позволяет создавать новые веб-сценарии. ::: noteclassic При создании веб-сценария также будет автоматически создан набор [элементов данных веб-мониторинга](/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(массив webScenarioIds)` Этот метод позволяет удалять веб-сценарии. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив webScenarios)` Этот метод позволяет обновлять существующие веб-сценарии. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив iconMaps)` Этот метод позволяет создавать новые соответствия иконок. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив iconMapIds)` Этот метод позволяет удалять соответствия иконок. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив iconMaps)` Этот метод позволяет обновлять существующие карты значков. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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. ::: ### Описание `object image.create(объект/массив images)` Этот метод позволяет создавать новые изображения. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив imageIds)` Этот метод позволяет удалять изображения. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив images)` Этот метод позволяет обновлять существующие изображения. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив items)` Этот метод позволяет создавать новые элементы данных. ::: noteclassic Веб элементы данных нельзя создавать через Zabbix API. ::: ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив itemIds)` Этот метод позволяет удалять элементы данных. ::: noteclassic Веб элементы данных нельзя удалить через Zabbix API. ::: ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив itemPrototypes)` Этот метод позволяет создавать новые прототипы элементов данных. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив itemPrototypeIds)` Этот метод позволяет удалять прототипы элементов данных. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив itemPrototypes)` Этот метод позволяет обновлять существующие прототипы элементов данных. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив items)` Этот метод позволяет обновлять существующие элементы данных. ::: noteclassic Веб элементы данных нельзя обновлять через Zabbix API. ::: ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив maintenances)` Этот метод позволяет создавать новые обслуживания. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив maintenanceIds)` Этот метод позволяет удалять периоды обслуживания. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив maintenances)` Этот метод позволяет обновлять существующие обслуживания. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив 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(массив 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(объект/массив 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(объект/массив mediaTypes)` Этот метод позволяет создавать новые способы оповещения. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив mediaTypeIds)` Этот метод позволяет удалять способы оповещения. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив mediaTypes)` Этот метод позволяет обновлять существующие способы оповещения. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив proxies)` Этот метод позволяет создавать новые прокси. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив proxies)` Этот метод позволяет удалять прокси. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив proxies)` Этот метод позволяет обновлять существующие прокси. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив regularExpressions)` Этот метод позволяет создавать новые глобальные регулярные выражения. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив regexpids)` Этот метод позволяет удалять глобальные регулярные выражения. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив RegularExpressions)` Этот метод позволяет обновлять существующие глобальные регулярные выражения. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив reports)` Этот метод позволяет создавать новые запланированные отчеты. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив reportids)` Этот метод позволяет удалять запланированные отчеты. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив reports)` Этот метод позволяет обновлять существующие запланированные отчеты. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив roles)` Этот метод позволяет создавать новые роли. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив roleids)` Этот метод позволяет удалить роли. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив roles)` Этот метод позволяет обновлять существующие роли. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив scripts)` Этот метод позволяет создавать новые сценарии. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив scriptIds)` Этот метод позволяет удалять скрипты. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет запустить скрипт на хосте или событии. ::: 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(массив 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(объект/массив scripts)` Этот метод позволяет обновлять существующие скрипты. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив 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(массив 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(объект/массив 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(параметры объекта)` Метод позволяет получить объект настроек по заданным параметры. ::: 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(настройки объекта)` Этот метод позволяет обновить существующие общие настройки. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив SLA)` Этот метод позволяет создавать новые объекты SLA. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив slaids)` Этот метод позволяет удалять записи SLA. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `object sla.getsli(object parameters)` This method allows to calculate the Service Level Indicator (SLI) data for a Service Level Agreement (SLA). ::: 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 sla.getsli(параметры объекта)` Этот метод позволяет рассчитать данные индикатора уровня обслуживания (SLI) для соглашения об уровне обслуживания (SLA). ::: noteclassic Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив slaids)` Этот метод позволяет обновлять существующие записи SLA. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив tasks)` Этот метод позволяет создать новую задачу (например, сбор диагностических данных, проверку элементов или правил низкоуровневого обнаружения без перезагрузки конфигурации). ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив templates)` Этот метод позволяет создавать новые шаблоны. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив templateDashboards)` Этот метод позволяет создавать новые шаблоны информационных панелей. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив templateDashboardIds)` Этот метод позволяет удалять панели шаблонов. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив templateDashboards)` Этот метод позволяет обновлять существующие шаблоны информационных панелей. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив 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 Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет одновременно добавить несколько связанных объектов к указанным шаблонам. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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 templategroup.massremove(параметры объекта)` Этот метод позволяет удалить связанные объекты из нескольких шаблонов. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(параметры объекта)` Этот метод позволяет заменить или удалить связанные объекты и обновить свойства сразу на нескольких шаблонах. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив templates)` Этот метод позволяет обновлять существующие шаблоны. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив tokens)` Этот метод позволяет создавать новые токены. ::: noteclassic Для роли пользователя требуется [разрешение](/manual/web_interface/frontend_sections/users/user_roles#configuration) *Управление токенами API*, чтобы управлять токенами для других пользователей. ::: ::: 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(массив tokenids)` Этот метод позволяет удалять токены. ::: noteclassic Для роли пользователя требуется [разрешение](/manual/web_interface/frontend_sections/users/user_roles#configuration) *Управление токенами API*, чтобы управлять токенами для других пользователей. ::: ### Description `object token.generate(array tokenids)` This method allows to generate 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 can be generated by this method only if it has been [created](create). ::: ### Описание `object token.generate(массив tokenids)` Этот метод позволяет генерировать токены. ::: noteclassic Для роли пользователя требуется [разрешение](/manual/web_interface/frontend_sections/users/user_roles#configuration) *Управление токенами API*, чтобы управлять токенами для других пользователей. ::: ::: noteimportant Токен может быть сгенерирован этим методом только в том случае, если он был [создан](create). ::: ### 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(объект/массив tokens)` Этот метод позволяет обновлять существующие токены. ::: noteclassic Для роли пользователя требуется [разрешение](/manual/web_interface/frontend_sections/users/user_roles#configuration) *Управление токенами API*, чтобы управлять токенами для других пользователей. ::: ### 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(объект/массив triggerDependencies)` Этот метод позволяет создавать новые зависимости триггеров. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив triggers)` Этот метод позволяет создавать новые триггеры. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив triggerIds)` Этот метод позволяет удалять триггеры. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(строка/массив triggers)` Этот метод позволяет удалять все зависимости триггера с заданных триггеров. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив triggerPrototypes)` Этот метод позволяет создавать новые прототипы триггеров. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив triggerPrototypeIds)` Этот метод позволяет удалять прототипы триггеров. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив triggerPrototypes)` Этот метод позволяет обновлять существующие прототипы триггеров. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив triggers)` Этот метод позволяет обновлять существующие триггеры. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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(объект/массив users)` Этот метод позволяет создавать новых пользователей. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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(массив users)` Этот метод позволяет удалять пользователей. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив userGroups)` Этот метод позволяет создавать новые группы пользователей. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив userGroupIds)` Этот метод позволяет удалять группы пользователей. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив userGroups)` Этот метод позволяет обновлять существующие группы пользователей. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив globalMacros)` Этот метод позволяет создавать новые глобальные макросы. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив hostMacros)` Этот метод позволяет создавать новые макросы хоста. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив hostMacroIds)` Этот метод позволяет удалять макросы хоста. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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.createglobal(объект/массив globalMacros)` Этот метод позволяет создавать новые глобальные макросы. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив globalMacros)` Этот метод позволяет обновлять существующие глобальные макросы. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив hostMacros)` Этот метод позволяет обновлять существующие макросы хоста. ::: noteclassic Этот метод доступен только пользователям с типом доступа *Администратор* и *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив userids)` Этот метод позволяет разблокировать пользователей. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив users)` Этот метод позволяет обновлять существующих пользователей. ::: noteclassic Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/administration/user_roles). ::: ::: noteclassic Сложность пароля пользователя проверяется в соответствии с правилами политики паролей, определенными API аутентификации. Подробнее см. в [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(объект/массив valuemaps)` Этот метод позволяет создавать новые карты значений. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(массив valuemapids)` Этот метод позволяет удалить преобразование значений. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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(объект/массив valuemaps)` Этот метод позволяет обновлять существующие преобразования значений. ::: noteclassic Этот метод доступен только пользователю с типом доступа *Супер-администратор*. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/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 Этот метод доступен только для не авторизованных пользователей и должен вызываться без параметра auth в запросе JSON-RPC ::: ### 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(параметры объекта)` Этот метод позволяет экспортировать данные конфигурации в виде сериализованной строки. ::: noteclassic Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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(массив)` Этот метод позволяет выйти из API и аннулирует текущий токен аутентификации. ::: noteclassic Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Часы*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/clock) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Обзор данных*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/data_overview) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Геокарта*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*График (классический)*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph_classic) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*График*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Прототип графиков*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph_prototype) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Значение элемента данных*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Карта сети*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Дерево навигации по карте*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map_tree) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Простой текст*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/plain_text) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Узлы сети с проблемами*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problem_hosts) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Проблемы по важности*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems_severity) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Проблемы*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*SLA отчёт*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/sla_report) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Топ узлов сети*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Обзор триггеров*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/trigger_overview) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*URL*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/url) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/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. ::: ### Описание Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Веб-мониторинг*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/web_monitoring) в методах `dashboard.create` и `dashboard.update`. ::: noteimportant Свойства полей виджета не проверяются во время создания или обновления информационной панели. Это позволяет пользователям изменять [встроенные виджеты](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) и создавать [пользовательские виджеты](/manual/modules#developing-modules), но также создает риск неправильного создания или обновления виджетов. Чтобы обеспечить успешное создание или обновление виджета *Веб-мониторинг*, ознакомьтесь с требованиями к параметрам, указанными в таблицах ниже. ::: ## 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 сервере должен быть создан элемент данных типа **Zabbix траппер** с соответствующим ключом. Обратите внимание, что входящие данные будут приняты только от узлов сети, указанных в поле **Разрешённые хосты** для этого элемента данных. [ ]{#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. [ ]{#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. #### Дополнительная информация об экспорте - Все поддерживаемые элементы экспортируются в один файл. - Объекты на узлах сети и в шаблонах (элементы данных, триггеры, графики, правила обнаружения), которые унаследованы из присоединённых шаблонов, не экспортируются. Любые изменения, выполненные над этими объектами на уровне узла сети (например, изменённый интервал обновления, изменённое регулярное выражение или прототипы, добавленные к правилу низкоуровневого обнаружения), при экспорте будут потеряны; при импорте все объекты из присоединённых шаблонов будут пересозданы такими, как они есть в исходном присоединённом шаблоне. - Объекты, созданные низкоуровневым обнаружением, и любые зависимые от них объекты не экспортируются. Например, если триггер создан для элемента данных, сгенерированного правилом обнаружения, то такой триггер не будет экспортирован. #### 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 и .yml для YAML, .xml для XML и .json для JSON. Смотрите [информацию о совместимости](/manual/appendix/compatibility) касательно поддерживаемых версий XML. - Импорт поддерживает конфигурационные файлы только в кодировке UTF-8 (как с, так и без [маркера последовательности байтов (BOM)](https://ru.wikipedia.org/wiki/%D0%9C%D0%B0%D1%80%D0%BA%D0%B5%D1%80_%D0%BF%D0%BE%D1%81%D0%BB%D0%B5%D0%B4%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D0%B8_%D0%B1%D0%B0%D0%B9%D1%82%D0%BE%D0%B2)); другие кодировки (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) приведут к ошибке конвертации при импорте. #### 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. #### Детали Мониторинг виртуальных машин выполняется в два шага. Первый, данные о виртуальных машинах собираются Zabbix процессами *vmware collector*. Эти процессы получают необходимую информацию с веб служб VMware через SOAP протокол, подготовалиивают эту информацию и записывают в разделяемую память Zabbix сервера. Затем эти данные извлекаются с помощью поллеров с использованием [VMware ключей](/manual/config/items/itemtypes/simple_checks/vmware_keys) простых проверок Zabbix. Начиная с версии Zabbix 2.4.4, собираемые данные разделены на 2 типа: данные конфигурации VMware и данные счётчиков производительности VMware. Оба эти типа собираются независимо *vmware коллекторами*. В связи с этим рекомендуется активировать больше коллекторов, чем служб VMware на мониторинге. В противном случае получение статистики, основанной на счетчиках производительности VMware, может задерживаться из-за получения данных конфигурации VMware (что занимает длительное время на больших инсталляциях). В настоящее время только статистика по хранилищам данных, сетевым интерфейсам и дисковым устройствам, а также элементы данных пользовательских счетчиков производительности основываются на информации со счётчиков производительности VMware. #### Details To avoid calculations with huge numbers, we consider the timestamp of the first value in specified period plus 1 ns as a new zero-time (current epoch time is of order 10^9^, epoch squared is 10^18^, double precision is about 10^-16^). 1 ns is added to provide all positive time values for *logarithmic* and *power* fits which involve calculating log(t). Time shift does not affect *linear*, *polynomial*, *exponential* (apart from easier and more precise calculations) but changes the shape of *logarithmic* and *power* functions. #### Подробности Для того, чтобы избежать вычислений с большими числами, мы рассматриваем штамп времени первого значения в указанном периоде плюс 1 наносекунда как новую точку отсчёта времени (текущие штампы времени порядка 10^9^, в квадрате уже 10^18^, а точность дробных значений около 10^-16^). 1 наносекунда прибавляется для того, чтобы все значения времени были положительными, поскольку построение логарифмической (*logarithmic*) и степенной (*power*) аппроксимаций подразумевает вычисление log(t). Этот сдвиг времени не влияет на линейную (*linear*), полиномиальную (*polynomial*) и экспоненциальную (*exponential*) функции (за исключением более легких и более точных вычислений), но изменяет форму логарифмической (*logarithmic*) и степенной (*power*) функций. #### 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. Предпочтительнее использовать шаблон проектрования Model-View-Controller (MVC, «Модель-Представление-Контроллер»), так как он также используется в веб-интерфейсе Zabbix и облегчит разработку. Строгая типизация PHP также приветствуется, но не обязательна. Обратите внимание, что с модулями вы можете легко добавлять новые пункты меню и соответствующие представления и действия в веб-интерфейс Zabbix. В настоящее время невозможно зарегистрировать новый API или создать новые таблицы базы данных с помощью модулей. #### 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<br>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<br>Fault| |*Check Point Next Generation Firewall by SNMP*|Check Point|Next Generation Firewall|-|Gaia|HOST-RESOURCES-MIB, CHECKPOINT-MIB, UCD-SNMP-MIB, SNMPv2-MIB, IF-MIB|Certified| |*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<br>Fault<br>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| |*FortiGate by SNMP*|Fortinet|FortiGate (NGFW)|-|FortiOS|HOST-RESOURCES-MIB<br>FORTINET-FORTIGATE-MIB<br>FORTINET-CORE-MIB<br>SNMPv2-MIB<br>IF-MIB<br>ENTITY-MIB|Performance<br>Inventory| |*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<br>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<br>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<br>Inventory| |*Netgear Fastpath SNMP*|Netgear|Netgear Fastpath|M5300-28G| |FASTPATH-SWITCHING-MIB,FASTPATH-BOXSERVICES-PRIVATE-MIB|Fault<br>Inventory| #### Устройства Список семейств устройств, по которым доступны шаблоны: |Имя шаблона|Производитель|Семейство устройств|Известные модели|ОС|Использованные MIB|**[Теги](/manual/config/templates_out_of_the_box/network_devices#теги)**| |----|--|--|----|--|----|-----| |*Alcatel Timetra TiMOS SNMP*|Alcatel|Alcatel Timetra|ALCATEL SR 7750|TiMOS|TIMETRA-SYSTEM-MIB,TIMETRA-CHASSIS-MIB|Certified| |*Brocade FC SNMP*|Brocade|Коммутаторы Brocade FC|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| |*Check Point Next Generation Firewall by SNMP*|Check Point|Next Generation Firewall|-|Gaia|HOST-RESOURCES-MIB, CHECKPOINT-MIB, UCD-SNMP-MIB, SNMPv2-MIB, IF-MIB|Certified| |*Cisco Catalyst 3750<модель устройства> 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 версии > 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 и < 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|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| |*FortiGate by SNMP*|Fortinet|FortiGate (NGFW)|-|FortiOS|HOST-RESOURCES-MIB<br>FORTINET-FORTIGATE-MIB<br>FORTINET-CORE-MIB<br>SNMPv2-MIB<br>IF-MIB<br>ENTITY-MIB|Performance<br>Inventory| |*Huawei VRP SNMP*|Huawei|Huawei VRP|S2352P-EI|\-|ENTITY-MIB,HUAWEI-ENTITY-EXTENT-MIB|Certified| |*Intel\_Qlogic Infiniband SNMP*|Intel/QLogic|Устройства Intel/QLogic Infiniband|Infiniband 12300| |ICS-CHASSIS-MIB|Fault Inventory| |*Juniper SNMP*|Juniper|Модели MX,SRX,EX|Juniper MX240, Juniper EX4200-24F|JunOS|JUNIPER-MIB|Certified| |*Mellanox SNMP*|Mellanox|Устройства Mellanox Infiniband|SX1036|MLNX-OS|HOST-RESOURCES-MIB,ENTITY-MIB,ENTITY-SENSOR-MIB,MELLANOX-MIB|Certified| |*MikroTik CCR<модель устройства> SNMP*|MikroTik|Роутеры MikroTik Cloud Core (CCR серии)|Отдельные специальные шаблоны доступны для 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<модель устройства> SNMP*|MikroTik|Коммутаторы MikroTik Cloud Router (CRS серии)|Отдельные специальные шаблоны доступны для 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<модель устройства> SNMP*|MikroTik|Коммутаторы MikroTik Cloud Smart (CSS серии)|Отдельные специальные шаблоны доступны для 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 <модель устройства> SNMP*|MikroTik|MikroTik hEX|Отдельные специальные шаблоны доступны для MikroTik hEX, MikroTik hEX lite, MikroTik hEX PoE, MikroTik hEX PoE lite, MikroTik hEX S|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik netPower <модель устройства> SNMP*|MikroTik|MikroTik netPower|Отдельные специальные шаблоны доступны для MikroTik netPower 15FR, MikroTik netPower 16P SNMP, MikroTik netPower Lite 7R|RouterOS/SwitchOS, SwitchOS Lite|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik PowerBox <модель устройства> SNMP*|MikroTik|MikroTik PowerBox|Отдельные специальные шаблоны доступны для MikroTik PowerBox, MikroTik PowerBox Pro|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certified| |*MikroTik RB<модель устройства> SNMP*|MikroTik|Роутеры MikroTik RB серии|Отдельные специальные шаблоны доступны для 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|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|Qtech QSW-2800-28T|\-|QTECH-MIB,ENTITY-MIB|Performance Inventory| |*Ubiquiti AirOS SNMP*|Ubiquiti|Беспроводные устройства Ubiquiti AirOS|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 #### 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 } ``` #### Деактивация действия (disable) Деактивировать действие, то есть, выставить его статус в «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 } ``` #### 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. Запрос: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "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. #### Отключение страниц ошибок веб-сервера по умолчанию Рекомендуется отключить страницы ошибок по умолчанию, чтобы избежать раскрытия информации. По умолчанию веб-сервер использует встроенные страницы ошибок:  Как часть процесса по улучшению защищенности веб-сервера, используемые по умолчанию страницы ошибок необходимо заменить/удалить. Можно использовать директиву "ErrorDocument", чтобы задать пользовательскую страницу/текст для веб-сервера Apache (используется как пример). Пожалуйста, обратитесь к документации по вашему веб-серверу для того, чтобы узнать как заменять/удалять используемые по умолчанию страницы ошибок. ### 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 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. #### Отключение отображения информации о веб-сервере Как часть процесса по улучшению защищенности веб-сервера, рекомендуется отключить все подписи веб-сервера. По умолчанию веб-сервер раскрывает подпись программного обеспечения:  Эту подпись можно отключить, добавив две строки в файл конфигурации Apache (используется как пример): ```ini ServerSignature Off ServerTokens Prod ``` Подпись PHP (HTTP заголовок X-Powered-By ) можно отключить, изменив файл конфигурации php.ini (подпись отключена по умолчанию): ```ini expose_php = Off ``` Чтобы изменения файлов конфигурации вступили в силу, необходимо перезапустить веб-сервер. Дополнительного уровня безопасности можно достичь, используя mod\_security (пакет libapache2-mod-security2) с Apache. mod\_security позволяет полностью удалить подпись сервера вместо удаления лишь версии из подписи сервера. После установки mod\_security, подпись можно изменить на любое значение, исправив "SecServerSignature" на любое желаемое значение. Пожалуйста, обратитесь к документации по вашему веб-серверу для того, чтобы узнать, как удалять/изменять подписи к программному обеспечению. ### Discovered entities The screenshots below illustrate how discovered items, triggers, and graphs look like in the host's configuration. Discovered entities are prefixed with an orange link to a discovery rule they come from. {width="600"} Note that discovered entities will not be created in case there are already existing entities with the same uniqueness criteria, for example, an item with the same key or graph with the same name. An error message is displayed in this case in the frontend that the low-level discovery rule could not create certain entities. The discovery rule itself, however, will not turn unsupported because some entity could not be created and had to be skipped. The discovery rule will go on creating/updating other entities. Items (similarly, triggers and graphs) created by a low-level discovery rule will be deleted automatically if a discovered entity (file system, interface, etc) stops being discovered (or does not pass the filter anymore). In this case the items, triggers and graphs will be deleted after the days defined in the *Keep lost resources period* field pass. When discovered entities become 'Not discovered anymore', a lifetime indicator is displayed in the item list. Move your mouse pointer over it and a message will be displayed indicating how many days are left until the item is deleted.  If entities were marked for deletion, but were not deleted at the expected time (disabled discovery rule or item host), they will be deleted the next time the discovery rule is processed. Entities containing other entities, which are marked for deletion, will not update if changed on the discovery rule level. For example, LLD-based triggers will not update if they contain items that are marked for deletion.  {width="600"} ### Обнаруженные объекты Представленные ниже снимки экрана иллюстрируют, как выглядят уже обнаруженные элементы данных, триггеры и графики в настройках узла сети. Обнаруженные объекты имеют префикс — ссылку золотистого цвета, которая ведёт к правилу обнаружения, создавшему эти объекты. {width="600"} Обратите внимание, что обнаруженные объекты не будут созданы в случае, если объекты с такими же условиями уникальности уже существуют — например, элемент данных с таким же ключом или график с таким же именем. В таком случае в веб-интерфейсе отобразится сообщение об ошибке, что правило низкоуровневого обнаружения не смогло создать определённые объекты. Само правило обнаружения, тем не менее, не станет неподдерживаемым из-за того, что некоторые объекты не смогли быть созданы и были пропущены. Правило обнаружения перейдёт к созданию/обновлению других объектов. Элементы данных (а также триггеры и графики), созданые с помощью правила низкоуровневого обнаружения, будут удалены автоматически, если обнаруженный объект (файловая система, интерфейс и т.д.) более не обнаруживается (или более не попадает под фильтр). В этом случае они будут удалены спустя некоторое количество дней, указанное в поле *Период сохранения потерянных ресурсов (Keep lost resources period)*. Когда обнаруженный объект становится «Более не обнаруживается», в списке элементов данных будет отображаться оранжевый индикатор времени жизни. Переместите курсор мыши на этот индикатор, и вы увидите сообщение с количеством дней до момента удаления элемента данных.  Если объекты помечены на удаление, но не были удалены в назначенное время (деактивировано правило обнаружения или узел сети элемента данных), они удалятся при следующем выполнении правила обнаружения. Объекты, которые содержат другие объекты, которые помечены на удаление, не будут обновлены, если будут изменены на уровне правила обнаружения. Например, триггеры на основе LLD не будут обновлены, если они содержат элементы данных, которые помечены на удаление.  {width="600"} #### 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. {width="600"} {width="600"} {width="600"} #### Обнаруженные объекты Во время своей работы сервер создаст реальные элементы данных, триггеры и графики на основе значений, которые вернёт правило SNMP обнаружения. В настройках узла сети они будут снабжены префиксом золотистого цвета, который является ссылкой на породившее их правило обнаружения. {width="600"} {width="600"} {width="600"} ### 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.| ### Обнаруженный узел сети ::: noteclassic Обнаруженный узел сети создается сервером Zabbix и не может быть изменены через API. ::: Объект обнаруженный узел сети содержит информацию об обнаруженном узле сети в соответствии с правилом сетевого обнаружения. Он обладает следующими свойствами. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |dhostid|string|ID обнаруженного узла сети.| |druleid|string|Идентификатор правила обнаружения, обнаружившего узел сети.| |lastdown|timestamp|Время последнего отказа обнаруженного узла сети.| |lastup|timestamp|Время последней активации обнаруженного узла сети.| |status|integer|Включен или выключен обнаруженный узел сети. Узел сети работает если у него есть хотя бы одна активная обнаруженная служба.<br><br>Возможные значения:<br>0 — узел сети работает;<br>1 — узел сети отключен.| ##### 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" } } ] ``` ##### Обнаружение объектов MBean Элемент данных обнаружения: `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>*(Host 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>Список диапазонов: 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>*(Service type)*|равно<br>не равно|Укажите тип сервиса обнаруженного сервиса или исключение типа сервиса.<br>**равно** — совпадает с обнаруженным сервисом.<br>**не равно** — не совпадает с обнаруженным сервисом.<br>Доступные типы сервисов: SSH, LDAP, SMTP, FTP, HTTP, HTTPS *(доступно с Zabbix 2.2)*, POP, NNTP, IMAP, TCP, Zabbix агент, SNMPv1 агент, SNMPv2 агент, SNMPv3 агент, ICMP пинг, telnet *(доступно начиная с версии Zabbix 2.2)*| |*Порт сервиса*<br>*(Service port)*|равно<br>не равно|Укажите диапазон TCP портов или исключение диапазона у обнаруженного узла сети.<br>**равно** — порт сервиса из указанного диапазона.<br>**не равно** — порт сервиса не из указанного диапазона.| |*Правило обнаружения*<br>*(Discovery rule)*|равно<br>не равно|Укажите правило обнаружения или исключение правила обнаружения.<br>**равно** — использование указанного правила обнаружения.<br>**не равно** — использование любого другого правила обнаружения, отличного от указанного.| |*Проверка обнаружения*<br>*(Discovery check)*|равно<br>не равно|Укажите проверку обнаружения или исключение проверки обнаружения.<br>**равно** — использование указанной проверки обнаружения.<br>**не равно** — использование любой другой проверки обнаружения, отличной от указанной.| |*Обнаруженный объект*<br>*(Discovery object)*|равно|Укажите обнаруженный объект.<br>**равно** — совпадает с обнаруженным объектом (устройством или сервисом).| |*Состояние обнаружения*<br>*(Discovery status)*|равно|**Доступен (Up)** — совпадает с событиями «Узел сети доступен» и «Сервис доступен»<br>**Недоступен (Down)** — совпадает с событиями «Узел сети недоступен» и «Сервис недоступен»<br>**Обнаружен (Discovered)** — совпадает с событиями «Узел сети обнаружен» и «Сервис обнаружен»<br>**Потерян (Lost)** — совпадает с событиями «Узел сети потерян» и «Сервис потерян»| |*Доступен/Недоступен*<br>*(Uptime/Downtime)*|больше чем или равно<br>меньше чем или равно|Время доступности для событий «Узел сети доступен» и «Сервис доступен». Время недоступности для событий «Узел сети недоступен» и «Сервис недоступен».<br>**больше чем или равно** — больше или совпадает. Параметр задается в секундах.<br>**меньше чем или равно** — меньше или совпадает. Параметр задается в секундах.| |*Полученное значение*<br>*(Received value)*|равно<br>не равно<br>больше чем или равно<br>меньше чем или равно<br>содержит<br>не содержит|Укажите полученное значение от проверки агента (Zabbix, SNMP) в правиле обнаружения. Регистрозависимое сравнение строк. Если в правиле заданы несколько проверок Zabbix агента или SNMP, проверяется каждое полученное от них значения (каждая проверка генерирует новое событие, которое сопоставляется со всеми условиями).<br>**равно** — совпадает с указанным значением.<br>**не равно** — не совпадает с указанным значением.<br>**больше чем или равно** — больше или совпадает с указанным значением.<br>**меньше чем или равно** — меньше или совпадает с указанным значением.<br>**содержит** — содержит указанную подстроку. Параметр задается в виде строки.<br>**не содержит** — не содержит указанную подстроку. Параметр задается строкой.| |*Прокси*<br>*(Proxy)*|равно<br>не равно|Укажите прокси или исключение прокси.<br>**равно** — используется указанный прокси.<br>**не равно** — используется любой другой прокси отличный от указанного.| ::: noteclassic Проверки сервисов в правиле обнаружения, которые приводят к событиям обнаружения, не выполняются одновременно. Поэтому, если в действии настроено **несколько** значений для условий `Тип сервиса`, `Порт сервиса` или `Полученное значение`, они будут сравниваться с одним событием обнаружения за раз, но **не** будут сравниваться с несколькими событиями одновременно. В результате действия с несколькими значениями по одним и тем же типам проверок могут быть выполнены некорректно. ::: #### 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 генерирует следующие события: |Событие|Когда генерируется| |--|--------| |Сервис доступен|Каждый раз, когда Zabbix обнаруживает активный сервис.| |Сервис недоступен|Каждый раз, когда Zabbix не может обнаружить сервис.| |Узел сети доступен|Если хотя бы один сервис доступен для IP.| |Узел сети недоступен|Если все сервисы не доступны.| |Сервис обнаружен|Если сервис стал доступен после его недоступности или обнаружен впервые.| |Сервис потерян|Если сервис потерян после того как был доступен.| |Узел сети обнаружен|Если узел сети стал доступен после его недоступности или обнаружен впервые.| |Узел сети потерян|Если узел сети потерян после того как был доступен.| ### 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 с использованием ключа элемента данных *systemd.unit.discovery*, подерживаемого Zabbix агентом 2. Обратите внимание, чтобы для отключенных модулей systemd были созданы элементы данных и триггеры из их прототипов, возможно, потребуется адаптировать (или вовсе удалить) запрещающие фильтры LLD в макросах {#UNIT.ACTIVESTATE} и {#UNIT.UNITFILESTATE}. Для получения более подробных сведений смотрите [Обнаружение 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, возможно также обнаруживать и **деактивированные** (disabled) модули systemd. В этом случае в результирующем JSON-е возвращаются три макроса: - {#UNIT.PATH} - {#UNIT.ACTIVESTATE} - {#UNIT.UNITFILESTATE}. ::: noteimportant Чтобы из прототипов создавались элементы данных и триггеры для деактивированных модулей systemd, убедитесь, что подправлены (или удалены) запрещающие фильтры LLD для {#UNIT.ACTIVESTATE} и {#UNIT.UNITFILESTATE}. ::: ### 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 #### Discovery rule The discovery rule form contains five tabs, representing, from left to right, the data flow during discovery: - *Discovery rule* - specifies, most importantly, the built-in item or custom script to retrieve discovery data - *Preprocessing* - applies some preprocessing to the discovered data - *LLD macros* - allows to extract some macro values to use in discovered items, triggers, etc - *Filters* - allows to filter the discovered values - *Overrides* - allows to modify items, triggers, graphs or host prototypes when applying to specific discovered objects The **Discovery rule** tab contains the item key to use for discovery (as well as some general discovery rule attributes):  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Name*|Name of discovery rule.| |*Type*|The type of check to perform discovery.<br>In this example we are using a *Zabbix agent* item type.<br>The discovery rule can also be a [dependent item](/manual/config/items/itemtypes/dependent_items), depending on a regular item. It cannot depend on another discovery rule. For a dependent item, select the respective type (*Dependent item*) and specify the master item in the 'Master item' field. The master item must exist.| |*Key*|Enter the discovery item key (up to 2048 characters).<br>For example, you may use the built-in "vfs.fs.discovery" item key to return a JSON string with the list of file systems present on the computer and their types.<br>Note that another option for filesystem discovery is using discovery results by the "vfs.fs.get" agent key, supported since Zabbix 4.4.5 (see [example](/manual/discovery/low_level_discovery/examples/mounted_filesystems)).| |*Update interval*|This field specifies how often Zabbix performs discovery. In the beginning, when you are just setting up file system discovery, you might wish to set it to a small interval, but once you know it works you can set it to 30 minutes or more, because file systems usually do not change very often.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 2h, 1d, since Zabbix 3.4.0.<br>[User macros](/manual/config/macros/user_macros) are supported, since Zabbix 3.4.0.<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 for an existing discovery rule the discovery can be performed immediately by pushing the *Check 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). Scheduling is supported since Zabbix 3.0.0.| |*Keep lost resources period*|This field allows you to specify the duration for how long the discovered entity will be retained (won't be deleted) once its discovery status becomes "Not discovered anymore" (between 1 hour to 25 years; or "0").<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 2h, 1d, since Zabbix 3.4.0.<br>[User macros](/manual/config/macros/user_macros) are supported, since Zabbix 3.4.0.<br>*Note:* If set to "0", entities will be deleted immediately. Using "0" is not recommended, since just wrongly editing the filter may end up in the entity being deleted with all the historical data.| |*Description*|Enter a description.| |*Enabled*|If checked, the rule will be processed.| ::: noteclassic Discovery rule history is not preserved. ::: #### Правило обнаружения Диалог правила обнаружения содержит пять вкладок, представляющих (слева направо) поток обработки данных во время обнаружения: - *Правило обнаружения (Discovery rule)* — самое главное, определяет встроенный элемент данных или пользовательский сценарий для получения данных обнаружения - *Предобработка (Preprocessing)* — применяет какую-либо предобработку к данным обнаружения - *LLD макросы (LLD macros)* — позволяет извлечь значения некоторых макросов, чтобы использовать в обнаруженных элементах данных, триггерах и т.д. - *Фильтры (Filters)* — позволяет отфильтровать обнаруженные значения - *Замещения (Overrides)* — позволяет изменить прототипы элементов данных, триггеров, графиков или узлов сети, когда они применяются к конкретным найденным объектам Вкладка **Правило обнаружения (Discovery rule)** содержит ключ элемента данных, используемого для обнаружения (а также некоторые общие атрибуты правила обнаружения):  Все обязательные поля ввода отмечены красной звёздочкой. |Параметр|Описание| |--|--------| |*Имя (Name)*|Имя правила обнаружения.| |*Тип*<br>*(Type)*|Тип проверки выполняемого обнаружения.<br>В данном примере мы используем тип *Zabbix агент*.<br>Правило обнаружения также может являться [зависимым элементом данных](/manual/config/items/itemtypes/dependent_items), зависящим от обычного элемента данных. Оно не может зависеть от другого правила обнаружения. Для зависимых элементов данных выберите соответствующий тип (*Зависимый элемент данных (Dependent item)*) и укажите основной элемент данных в поле «Основной элемент данных (Master item)». Основной элемент данных должен существовать.| |*Ключ*<br>*(Key)*|Введите ключ элемента данных, используемого для обнаружения (до 2048 символов).<br>Например, вы можете использовать встроенный ключ элемента данных «vfs.fs.discovery», который возвращает строку JSON со списком файловых систем, присутствующих в компьютере, и их типов.<br>Обратите внимание, что другой вариант обраружения файловых систем — это использовать результаты, возвращаемые ключом агента «vfs.fs.get», который поддерживается с версии Zabbix 4.4.5 (смотрите [пример](/manual/discovery/low_level_discovery/examples/mounted_filesystems)).| |*Интервал обновления*<br>*(Update interval)*|Это поле задаёт, как часто Zabbix выполняет обнаружение. Вначале, когда вы только настраиваете обнаружение файловых систем, вы можете указать маленький интервал; но как только вы удостоверитесь что всё работает, вы можете установить его в 30 минут или более, потому что обычно файловые системы не меняются очень часто.<br>Начиная с Zabbix 3.4.0, поддерживаются [суффиксы времени](/manual/appendix/suffixes), например 30s, 1m, 2h, 1d.<br>[Пользовательские макросы](/manual/config/macros/user_macros) поддерживаются, начиная с Zabbix 3.4.0.<br>*Обратите внимание*: интервал обновления может быть выставлен в «0» только если существует пользовательский интервал с ненулевым значением. Если укажете значение, равное «0», и пользовательский интервал (переменный или по расписанию) с ненулевым значением существует, элемент данных будет опрашиваться в течение действия переменного интервала.<br>*Обратите внимание*, что уже созданное правило обнаружения можно выполнить незамедлительно нажатием [кнопки](#кнопки-диалога) *Проверить сейчас*.| |*Пользовательские интервалы*<br>*(Custom intervals)*|Вы можете создавать пользовательские правила проверки элемента данных:<br>**Гибкий (Flexible)** — создание исключений из *Интервала обновления* (интервал с другой частотой обновления)<br>**По расписанию (Scheduling)** — создание пользовательского расписания проверки.<br>Для получения более подробной информации смотрите [Пользовательские интервалы](/manual/config/items/item/custom_intervals). Проверка по расписанию поддерживается, начиная с Zabix 3.0.0.| |*Период сохранения потерянных ресурсов*<br>*(Keep lost resources period)*|Это поле позволяет вам указать, как много дней обнаруженный объект будет храниться (не будет удалён), после того как его состояние обнаружения станет «более не обнаруживается (Not discovered anymore)» (от 1 часа до 25 лет; либо 0).<br>Начиная с Zabbix 3.4.0, поддерживаются [суффиксы времени](/manual/appendix/suffixes), например 30s, 1m, 2h, 1d.<br>[Пользовательские макросы](/manual/config/macros/user_macros) поддерживаются, начиная с Zabbix 3.4.0.<br>*Обратите внимание*: Если значение равно «0», объекты будут удалены сразу. Использование значения «0» не рекомендуется, так как простое ошибочное изменение фильтра может закончиться тем, что объект будет удалён вместе со всеми данными истории.| |*Описание (Description)*|Введите описание.| |*Активировано (Enabled)*|Если отмечено, правило будет обрабатываться.| ::: noteclassic История правил обнаружения не сохраняется. ::: ### Discovery rule The discovery rule object defines a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |druleid|string|*(readonly)* ID of the discovery rule.| |**iprange**<br>(required)|string|One or several IP ranges to check separated by commas.<br><br>Refer to the [network discovery configuration](/manual/discovery/network_discovery/rule) section for more information on supported formats of IP ranges.| |**name**<br>(required)|string|Name of the discovery rule.| |delay|string|Execution interval of the discovery rule. Accepts seconds, time unit with suffix and user macro.<br><br>Default: 1h.| |nextcheck|timestamp|*(readonly)* Time when the discovery rule will be executed next.| |proxy\_hostid|string|ID of the proxy used for discovery.| |status|integer|Whether the discovery rule is enabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Правило обнаружения Объект правила обнаружения определяет правило обнаружения сети. Он обладает следующими свойствами. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |druleid|строка|*(только для чтения)* ID правила обнаружения.| |**iprange**<br>(обязательное)|строка|Один или несколько диапазонов IP-адресов для проверки, разделенных запятыми.<br><br>Обратитесь к разделу [конфигурация обнаружения сети](/manual/discovery/network_discovery/rule) для получения дополнительной информации о поддерживаемых форматах диапазонов IP.| |**name**<br>(обязательное)|строка|Название правила обнаружения.| |delay|строка|Интервал выполнения правила обнаружения. Принимает секунды, единицу времени с суффиксом и пользовательский макрос.<br><br>По умолчанию: 1 час.| |nextcheck|штамп времени|*(только для чтения)* Время, когда правило обнаружения будет выполнено в следующий раз.| |proxy\_hostid|строка|ID прокси, используемого для обнаружения.| |status|целое число|Включено ли правило обнаружения.<br><br>Возможные значения:<br>0 - *(по умолчанию)* включено;<br>1 - отключено.| Обратите внимание, что для некоторых методов (обновление, удаление) комбинация обязательных/необязательных параметров отличается. # 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.  Все обязательные поля ввода отмечены красной звёздочкой. Ключом правила обнаружения на снимке экрана выше является *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. Частота проверок настраивается для каждого правила отдельно. Обратите внимание, что одно правило обнаружения всегда обрабатывается одним процессом обнаружения (discoverer). Диапазон IP адресов не разбивается между несколькими процессами обнаружения. Каждое правило имеет заданный набор проверок сервисов, которые будут выполняться по диапазону IP. ::: noteclassic Проверки обнаружения обрабатываются независимо от остальных проверок. Если какие-либо проверки не находят сервис (или завершаются с ошибкой), то другие проверки всё равно выполняются. ::: Каждая проверка сервиса и хоста (IP), выполняемая модулем сетевого обнаружения, генерирует событие обнаружения. |Событие|Результат проверки сервиса| |--|--------| |*Сервис обнаружен*<br>*(Service Discovered)*|Сервис «доступен» после того, как был «недоступен» или когда обнаружен первый раз.| |*Сервис доступен*<br>*(Service Up)*|Сервис «доступен» после того, как уже был «доступен».| |*Сервис потерян*<br>*(Service Lost)*|Сервис «недоступен» после того, как был «доступен».| |*Сервис недоступен*<br>*(Service Down)*|Сервис «недоступен» после того, как уже был «недоступен».| |*Узел сети обнаружен*<br>*(Host Discovered)*|По крайней мере один сервис на узле сети «доступен» после того, как все сервисы на этом узле сети были «недоступны», либо обнаружен сервис, относящийся к ещё не зарегистрированному узлу сети.| |*Узел сети доступен*<br>*(Host Up)*|По крайней мере один сервис на узле сети «доступен» после того, как по крайней мере один сервис на узле сети уже был «доступен».| |*Узел сети потерян*<br>*(Host Lost)*|Все сервисы на узле сети «недоступны» после того, как по крайней мере один был «доступен».| |*Узел сети недоступен*<br>*(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. #### Отображение На основе информации о подтверждении можно настроить отображение количества проблем на панели или картах. Чтобы сделать это, вам необходимо выбрать в опции *Отображение проблем (Problem display)*, доступной как в [настройках карты](/manual/config/visualization/maps/map#создание-карты-сети), так и в [виджете панели](/manual/web_interface/frontend_sections/monitoring/dashboard#добавление-виджетов) *Проблемы по степени важности (Problems by severity)*. Можно отобразить все проблемы, количество неподтверждённых проблем отдельно от общего количества или только количество неподтверждённых проблем. На основе информации об обновлении проблемы (подтверждение и т.д.) можно настроить операции обновления — отправить сообщение или выполнить удалённые команды. ##### 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*. ##### Отображение узлов сети в обслуживании Иконка с оранжевым гаечным ключом  вблизи имени узла сети означает, что этот узел сети находится в обслуживании в следующих разделах: - *Мониторинг → Панель (Monitoring → Dashboard)* - *Мониторинг → Проблемы (Monitoring → Problems)* - *Инвентаризация → Узлы сети → Детали инвентарных данных узла сети (Inventory → Hosts → Host inventory details)* - *Настройка → Узлы сети (Configuration → Hosts)* (Смотрите колонку «Состояние (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:  ##### Отображение подавленных проблем Обычно проблемы с узлов сети в обслуживании подавляются, то есть не отображаются в веб-интерфейсе. Однако, также имеется возможность настроить так, чтобы подавленные проблемы отображались при выборе опции *Отображение подавленных проблем (Show suppressedproblems)* в следующих местах: - *Мониторинг* → *Панель (Monitoring* → *Dashboard)* (при настройке виджетов *Узлы сети с проблемами*, *Проблемы*, *Проблемы по важности*, *Обзор триггеров*) - *Мониторинг* → *Проблемы (Monitoring* → *Problems)* (в фильтре) - *Мониторинг* → *Карты сети (Monitoring* → *Maps)* (в настройках карты) - Глобальные [оповещения](/manual/web_interface/user_profile/global_notifications) (в настройках профиля пользователя) При отображении подавленных проблем отображается следующая иконка: . При наведении курсора мыши отобразятся более подробные сведения:  #### 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 *Monitoring → Maps* the respective color will be displayed on the link if the trigger goes into a problem state.  ::: noteclassic If multiple triggers go into a problem state, the problem with the highest severity will determine the link style and color. If multiple triggers with the same severity are assigned to the same map link, the one with the lowest ID takes precedence. Note also that: 1. *Minimum trigger severity* and *Show suppressed problem* settings from map configuration affect which problems are taken into account. 2. In the case of triggers with multiple problems (multiple problem generation), each problem may have a severity that differs from trigger severity (changed manually), may have different tags (due to macros), and may be suppressed. ::: #### Просмотр В *Мониторинг → Карты сети (Monitoring → Maps)* отобразится соответствующий цвет у связи, если триггер перейдёт в состояние проблема.  ::: noteclassic Если несколько триггеров перейдут в состояние проблема, то триггер с наивысшей важностью будет определять цвет и стиль связи. Если несколько триггеров с одинаковой важностью назначены на одну связь карты сети, то триггер с наименьшим ID будет иметь приоритет. Обратите также внимание, что: 1. Настройки *Минимальная важность триггеров (Minimum trigger severity)* и *Подавленные проблемы (Show suppressed problem)* с настроек карты влияют на то, какие проблемы принимаются во внимание. 2. В случае наличия триггеров с несколькими проблемами (генерация множественных проблем), важность каждой проблемы может отличаться от важности триггера (изменено вручную), может иметь другие теги (из-за макросов), а также может быть подавлена. ::: ##### 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.| #### Параметры отображения Следующие параметры поддерживаются для настройки *Параметры отображения*. |Параметр|[тип](/manual/api/reference/dashboard/object#поле-виджета-панели)|имя|значение| |-----|-|-----|-------------------| |*History data selection*|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 секунд, чтобы после завершения обслуживания вернуться в нормальное состояние без вмешательства пользователя.  IP адреса, заданные в ZBX\_GUI\_ACCESS\_IP\_RANGE, смогут получить доступ к веб-интерфейсу, как всегда. ##### 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. ##### Отображение Результат в *Мониторинг → Последние данные*: {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. #### Просмотр Для просмотра веб-сценариев настроенных для узла сети, перейдите в *Мониторинг → Узлы сети (Monitoring → Hosts)*, найдите нужный узел сети в списке и нажмите на ссылку *Веб (Web)* в последней колонке. Нажмите на имя сценария для просмотра подробной статистики. {width="600"} Обзор сценариев веб-мониторинга можно также отобразить на *Мониторинг → Панель (Monitoring →Dashboard)* в виджете Веб-мониторинга. Последние результаты выполнения веб-сценария доступны в разделе *Мониторинг → Последние данные (Monitoring → Latest data)*. #### 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 Каждый может следить на изменениями в Docker файлах, используя [официальный репозиторий](https://github.com/zabbix/zabbix-docker) Zabbix на [github.com](https://github.com/). Вы можете создавать ответвления от проекта или свои собственные образы на основе официальных Docker файлов. ### Docker |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |docker.container\_info\[<ID>,<info>\]|<|<|<| |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.<br>**info** - the amount of information returned. Supported values: *short* (default) or *full*.|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>,<info>\]|<|<|<| |Низкоуровневая информация о контейнере.|Вывод API вызова [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect), преобразованный в JSON|**ID** — ID или имя контейнера<br>**info** — объём возвращаемой информации. Возможные значения: *short* (по умолчанию) или *full*.|Пользователь Агента 2 («zabbix») должен быть добавлен в [группу \[en\]](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) «docker» для достаточных привилегий. В противном случае проверка завершится с ошибкой.| |docker.container\_stats \[<ID>\]|<|<|<| |Статистика использования ресурсов контейнером.|Вывод API вызова [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) и использование CPU в процентах, преобразованные в JSON|**ID** — ID или имя контейнера|Пользователь Агента 2 («zabbix») должен быть добавлен в [группу \[en\]](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) «docker» для достаточных привилегий. В противном случае проверка завершится с ошибкой.| |docker.containers|<|<|<| |Список контейнеров.|Вывод API вызова [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList), преобразованный в JSON|\—|Пользователь Агента 2 («zabbix») должен быть добавлен в [группу \[en\]](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) «docker» для достаточных привилегий. В противном случае проверка завершится с ошибкой.| |docker.containers.discovery\[<опции>\]|<|<|<| |Список контейнеров. Используется [низкоуровневым обнаружением](/manual/discovery/low_level_discovery/).|Объект JSON |**опции** — задаёт, следует ли обнаруживать все или только запущенные контейнеры. Поддерживаемые значения:<br>*true* — возвращать все контейнеры;<br>*false* — возвращать только запущенные контейнеры (по умолчанию).|Пользователь Агента 2 («zabbix») должен быть добавлен в [группу \[en\]](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) «docker» для достаточных привилегий. В противном случае проверка завершится с ошибкой.| |docker.data\_usage|<|<|<| |Информация о текущем использовании данных.|Вывод API вызова [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage), преобразованный в JSON|\—|Пользователь Агента 2 («zabbix») должен быть добавлен в [группу \[en\]](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) «docker» для достаточных привилегий. В противном случае проверка завершится с ошибкой.| |docker.images|<|<|<| |Список образов.|Вывод API вызова [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList), преобразованный в JSON|\—|Пользователь Агента 2 («zabbix») должен быть добавлен в [группу \[en\]](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) «docker» для достаточных привилегий. В противном случае проверка завершится с ошибкой.| |docker.images.discovery|<|<|<| |Список образов. Используется [низкоуровневым обнаружением](/manual/discovery/low_level_discovery/).|Объект JSON |\—|Пользователь Агента 2 («zabbix») должен быть добавлен в [группу \[en\]](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) «docker» для достаточных привилегий. В противном случае проверка завершится с ошибкой.| |docker.info|<|<|<| |Информация о системе.|Вывод API вызова [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo), преобразованный в JSON|\—|Пользователь Агента 2 («zabbix») должен быть добавлен в [группу \[en\]](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) «docker» для достаточных привилегий. В противном случае проверка завершится с ошибкой.| |docker.ping|<|<|<| |Проверка, активен или нет Docker демон.|1 — подключение установлено<br><br>0 — подключение разорвано|\— |Пользователь Агента 2 («zabbix») должен быть добавлен в [группу \[en\]](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) «docker» для достаточных привилегий. В противном случае проверка завершится с ошибкой.| ### Docker Zabbix provides [Docker](https://www.docker.com) images for each Zabbix component as portable and self-sufficient containers to speed up deployment and update procedure. Zabbix components come with MySQL and PostgreSQL database support, Apache2 and Nginx web server support. These images are separated into different images. ::: noteimportant Since Zabbix 6.0, deterministic triggers need to be created during the installation. If binary logging is enabled for MySQL/MariaDB, this requires superuser privileges or setting the variable/configuration parameter *log_bin_trust_function_creators = 1*. See [Database creation scripts](/manual/appendix/install/db_scripts#mysql) for instructions how to set the variable.<br> Note that if executing from a console, the variable will only be set temporarily and will be dropped when a Docker is restarted. In this case, keep your SQL service running, only stop zabbix-server service by running 'docker compose down zabbix-server' and then 'docker compose up -d zabbix-server'.<br> Alternatively, you can set this variable in the configuration file. ::: ### Docker Чтобы ускорить процедуру развёртывания и обновления, Zabbix предоставляет образы [Docker](https://www.docker.com) для каждого компонента Zabbix в виде переносимых и самодостаточных контейнеров. Компоненты Zabbix поставляются с поддержкой баз данных MySQL и PostgreSQL, веб-серверов Apache2 и Nginx. Эти образы разделены на несколько отдельных образов. ::: noteimportant Начиная с версии Zabbix 6.0, во время инсталяции должны быть созданы детерминированные триггеры. Если для MySQL/MariaDB включено бинарное журналирование, то это требует привилегий суперпользователя либо выставления переменной / параметра конфигурации *log_bin_trust_function_creators = 1*. Смотрите [скрипты создания базы данных](/manual/appendix/install/db_scripts#mysql) для инструкций по установке этой переменной.<br> Обратите внимание, что при выполнении из консоли переменная будет выставляться только временно и будет сбрасываться при рестарте Docker-а. В этом случае сохраняйте ваш сервис SQL работающим, остановите лишь сервис zabbix-server командой 'docker compose down zabbix-server' и затем 'docker compose up -d zabbix-server'.<br> В качестве альтернативы, вы можете выставить эту переменную в конфигурационном файле. ::: # drule.create # drule.create # drule.delete # drule.delete # drule.get # drule.get # drule.update # drule.update # dservice.get # dservice.get #### Dummy module Zabbix includes a sample module written in C language. The module is located under src/modules/dummy: alex@alex:~trunk/src/modules/dummy$ ls -l -rw-rw-r-- 1 alex alex 9019 Apr 24 17:54 dummy.c -rw-rw-r-- 1 alex alex 67 Apr 24 17:54 Makefile -rw-rw-r-- 1 alex alex 245 Apr 24 17:54 README The module is well documented, it can be used as a template for your own modules. After ./configure has been run in the root of Zabbix source tree as described above, just run **make** in order to build **dummy.so**. ``` {.c} /* ** Zabbix ** Copyright (C) 2001-2020 Zabbix SIA ** ** This program is free software; you can redistribute it and/or modify ** it under the terms of the GNU General Public License as published by ** the Free Software Foundation; either version 2 of the License, or ** (at your option) any later version. ** ** This program is distributed in the hope that it will be useful, ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** GNU General Public License for more details. ** ** You should have received a copy of the GNU General Public License ** along with this program; if not, write to the Free Software ** Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. **/ #include <stdlib.h> #include <string.h> #include <time.h> #include <stdint.h> #include "module.h" /* the variable keeps timeout setting for item processing */ static int item_timeout = 0; /* module SHOULD define internal functions as static and use a naming pattern different from Zabbix internal */ /* symbols (zbx_*) and loadable module API functions (zbx_module_*) to avoid conflicts */ static int dummy_ping(AGENT_REQUEST *request, AGENT_RESULT *result); static int dummy_echo(AGENT_REQUEST *request, AGENT_RESULT *result); static int dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result); static ZBX_METRIC keys[] = /* KEY FLAG FUNCTION TEST PARAMETERS */ { {"dummy.ping", 0, dummy_ping, NULL}, {"dummy.echo", CF_HAVEPARAMS, dummy_echo, "a message"}, {"dummy.random", CF_HAVEPARAMS, dummy_random, "1,1000"}, {NULL} }; /****************************************************************************** * * * Function: zbx_module_api_version * * * * Purpose: returns version number of the module interface * * * * Return value: ZBX_MODULE_API_VERSION - version of module.h module is * * compiled with, in order to load module successfully Zabbix * * MUST be compiled with the same version of this header file * * * ******************************************************************************/ int zbx_module_api_version(void) { return ZBX_MODULE_API_VERSION; } /****************************************************************************** * * * Function: zbx_module_item_timeout * * * * Purpose: set timeout value for processing of items * * * * Parameters: timeout - timeout in seconds, 0 - no timeout set * * * ******************************************************************************/ void zbx_module_item_timeout(int timeout) { item_timeout = timeout; } /****************************************************************************** * * * Function: zbx_module_item_list * * * * Purpose: returns list of item keys supported by the module * * * * Return value: list of item keys * * * ******************************************************************************/ ZBX_METRIC *zbx_module_item_list(void) { return keys; } static int dummy_ping(AGENT_REQUEST *request, AGENT_RESULT *result) { SET_UI64_RESULT(result, 1); return SYSINFO_RET_OK; } static int dummy_echo(AGENT_REQUEST *request, AGENT_RESULT *result) { char *param; if (1 != request->nparam) { /* set optional error message */ SET_MSG_RESULT(result, strdup("Invalid number of parameters.")); return SYSINFO_RET_FAIL; } param = get_rparam(request, 0); SET_STR_RESULT(result, strdup(param)); return SYSINFO_RET_OK; } /****************************************************************************** * * * Function: dummy_random * * * * Purpose: a main entry point for processing of an item * * * * Parameters: request - structure that contains item key and parameters * * request->key - item key without parameters * * request->nparam - number of parameters * * request->params[N-1] - pointers to item key parameters * * request->types[N-1] - item key parameters types: * * REQUEST_PARAMETER_TYPE_UNDEFINED (key parameter is empty) * * REQUEST_PARAMETER_TYPE_ARRAY (array) * * REQUEST_PARAMETER_TYPE_STRING (quoted or unquoted string) * * * * result - structure that will contain result * * * * Return value: SYSINFO_RET_FAIL - function failed, item will be marked * * as not supported by zabbix * * SYSINFO_RET_OK - success * * * * Comment: get_rparam(request, N-1) can be used to get a pointer to the Nth * * parameter starting from 0 (first parameter). Make sure it exists * * by checking value of request->nparam. * * In the same manner get_rparam_type(request, N-1) can be used to * * get a parameter type. * * * ******************************************************************************/ static int dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result) { char *param1, *param2; int from, to; if (2 != request->nparam) { /* set optional error message */ SET_MSG_RESULT(result, strdup("Invalid number of parameters.")); return SYSINFO_RET_FAIL; } param1 = get_rparam(request, 0); param2 = get_rparam(request, 1); /* there is no strict validation of parameters and types for simplicity sake */ from = atoi(param1); to = atoi(param2); if (from > to) { SET_MSG_RESULT(result, strdup("Invalid range specified.")); return SYSINFO_RET_FAIL; } SET_UI64_RESULT(result, from + rand() % (to - from + 1)); return SYSINFO_RET_OK; } /****************************************************************************** * * * Function: zbx_module_init * * * * Purpose: the function is called on agent startup * * It should be used to call any initialization routines * * * * Return value: ZBX_MODULE_OK - success * * ZBX_MODULE_FAIL - module initialization failed * * * * Comment: the module won't be loaded in case of ZBX_MODULE_FAIL * * * ******************************************************************************/ int zbx_module_init(void) { /* initialization for dummy.random */ srand(time(NULL)); return ZBX_MODULE_OK; } /****************************************************************************** * * * Function: zbx_module_uninit * * * * Purpose: the function is called on agent shutdown * * It should be used to cleanup used resources if there are any * * * * Return value: ZBX_MODULE_OK - success * * ZBX_MODULE_FAIL - function failed * * * ******************************************************************************/ int zbx_module_uninit(void) { return ZBX_MODULE_OK; } /****************************************************************************** * * * Functions: dummy_history_float_cb * * dummy_history_integer_cb * * dummy_history_string_cb * * dummy_history_text_cb * * dummy_history_log_cb * * * * Purpose: callback functions for storing historical data of types float, * * integer, string, text and log respectively in external storage * * * * Parameters: history - array of historical data * * history_num - number of elements in history array * * * ******************************************************************************/ static void dummy_history_float_cb(const ZBX_HISTORY_FLOAT *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_integer_cb(const ZBX_HISTORY_INTEGER *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_string_cb(const ZBX_HISTORY_STRING *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_text_cb(const ZBX_HISTORY_TEXT *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_log_cb(const ZBX_HISTORY_LOG *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } /****************************************************************************** * * * Function: zbx_module_history_write_cbs * * * * Purpose: returns a set of module functions Zabbix will call to export * * different types of historical data * * * * Return value: structure with callback function pointers (can be NULL if * * module is not interested in data of certain types) * * * ******************************************************************************/ ZBX_HISTORY_WRITE_CBS zbx_module_history_write_cbs(void) { static ZBX_HISTORY_WRITE_CBS dummy_callbacks = { dummy_history_float_cb, dummy_history_integer_cb, dummy_history_string_cb, dummy_history_text_cb, dummy_history_log_cb, }; return dummy_callbacks; } ``` The module exports three new items: - `dummy.ping` - always returns '1' - `dummy.echo[param1]` - returns the first parameter as it is, for example, `dummy.echo[ABC]` will return ABC - `dummy.random[param1, param2]` - returns a random number within the range of param1-param2, for example, `dummy.random[1,1000000]` #### Пустой модуль Zabbix включает простой модуль, написанный на языке С. Модуль находится в src/modules/dummy: alex@alex:~trunk/src/modules/dummy$ ls -l -rw-rw-r-- 1 alex alex 9019 Apr 24 17:54 dummy.c -rw-rw-r-- 1 alex alex 67 Apr 24 17:54 Makefile -rw-rw-r-- 1 alex alex 245 Apr 24 17:54 README Модуль хорошо документирован, его можно использовать как шаблон для ваших собственных модулей. После выполнения ./configure в корне дерева исходных кодов Zabbix, как описано ранее, просто выполните **make** для сборки **dummy.so**. ``` {.c} /* ** Zabbix ** Copyright (C) 2001-2020 Zabbix SIA ** ** This program is free software; you can redistribute it and/or modify ** it under the terms of the GNU General Public License as published by ** the Free Software Foundation; either version 2 of the License, or ** (at your option) any later version. ** ** This program is distributed in the hope that it will be useful, ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** GNU General Public License for more details. ** ** You should have received a copy of the GNU General Public License ** along with this program; if not, write to the Free Software ** Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. **/ #include <stdlib.h> #include <string.h> #include <time.h> #include <stdint.h> #include "module.h" /* the variable keeps timeout setting for item processing */ static int item_timeout = 0; /* module SHOULD define internal functions as static and use a naming pattern different from Zabbix internal */ /* symbols (zbx_*) and loadable module API functions (zbx_module_*) to avoid conflicts */ static int dummy_ping(AGENT_REQUEST *request, AGENT_RESULT *result); static int dummy_echo(AGENT_REQUEST *request, AGENT_RESULT *result); static int dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result); static ZBX_METRIC keys[] = /* KEY FLAG FUNCTION TEST PARAMETERS */ { {"dummy.ping", 0, dummy_ping, NULL}, {"dummy.echo", CF_HAVEPARAMS, dummy_echo, "a message"}, {"dummy.random", CF_HAVEPARAMS, dummy_random, "1,1000"}, {NULL} }; /****************************************************************************** * * * Function: zbx_module_api_version * * * * Purpose: returns version number of the module interface * * * * Return value: ZBX_MODULE_API_VERSION - version of module.h module is * * compiled with, in order to load module successfully Zabbix * * MUST be compiled with the same version of this header file * * * ******************************************************************************/ int zbx_module_api_version(void) { return ZBX_MODULE_API_VERSION; } /****************************************************************************** * * * Function: zbx_module_item_timeout * * * * Purpose: set timeout value for processing of items * * * * Parameters: timeout - timeout in seconds, 0 - no timeout set * * * ******************************************************************************/ void zbx_module_item_timeout(int timeout) { item_timeout = timeout; } /****************************************************************************** * * * Function: zbx_module_item_list * * * * Purpose: returns list of item keys supported by the module * * * * Return value: list of item keys * * * ******************************************************************************/ ZBX_METRIC *zbx_module_item_list(void) { return keys; } static int dummy_ping(AGENT_REQUEST *request, AGENT_RESULT *result) { SET_UI64_RESULT(result, 1); return SYSINFO_RET_OK; } static int dummy_echo(AGENT_REQUEST *request, AGENT_RESULT *result) { char *param; if (1 != request->nparam) { /* set optional error message */ SET_MSG_RESULT(result, strdup("Invalid number of parameters.")); return SYSINFO_RET_FAIL; } param = get_rparam(request, 0); SET_STR_RESULT(result, strdup(param)); return SYSINFO_RET_OK; } /****************************************************************************** * * * Function: dummy_random * * * * Purpose: a main entry point for processing of an item * * * * Parameters: request - structure that contains item key and parameters * * request->key - item key without parameters * * request->nparam - number of parameters * * request->params[N-1] - pointers to item key parameters * * request->types[N-1] - item key parameters types: * * REQUEST_PARAMETER_TYPE_UNDEFINED (key parameter is empty) * * REQUEST_PARAMETER_TYPE_ARRAY (array) * * REQUEST_PARAMETER_TYPE_STRING (quoted or unquoted string) * * * * result - structure that will contain result * * * * Return value: SYSINFO_RET_FAIL - function failed, item will be marked * * as not supported by zabbix * * SYSINFO_RET_OK - success * * * * Comment: get_rparam(request, N-1) can be used to get a pointer to the Nth * * parameter starting from 0 (first parameter). Make sure it exists * * by checking value of request→nparam. * * In the same manner get_rparam_type(request, N-1) can be used to * * get a parameter type. * * * ******************************************************************************/ static int dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result) { char *param1, *param2; int from, to; if (2 != request->nparam) { /* set optional error message */ SET_MSG_RESULT(result, strdup("Invalid number of parameters.")); return SYSINFO_RET_FAIL; } param1 = get_rparam(request, 0); param2 = get_rparam(request, 1); /* there is no strict validation of parameters and types for simplicity sake */ from = atoi(param1); to = atoi(param2); if (from > to) { SET_MSG_RESULT(result, strdup("Invalid range specified.")); return SYSINFO_RET_FAIL; } SET_UI64_RESULT(result, from + rand() % (to - from + 1)); return SYSINFO_RET_OK; } /****************************************************************************** * * * Function: zbx_module_init * * * * Purpose: the function is called on agent startup * * It should be used to call any initialization routines * * * * Return value: ZBX_MODULE_OK - success * * ZBX_MODULE_FAIL - module initialization failed * * * * Comment: the module won't be loaded in case of ZBX_MODULE_FAIL * * * ******************************************************************************/ int zbx_module_init(void) { /* initialization for dummy.random */ srand(time(NULL)); return ZBX_MODULE_OK; } /****************************************************************************** * * * Function: zbx_module_uninit * * * * Purpose: the function is called on agent shutdown * * It should be used to cleanup used resources if there are any * * * * Return value: ZBX_MODULE_OK - success * * ZBX_MODULE_FAIL - function failed * * * ******************************************************************************/ int zbx_module_uninit(void) { return ZBX_MODULE_OK; } /****************************************************************************** * * * Functions: dummy_history_float_cb * * dummy_history_integer_cb * * dummy_history_string_cb * * dummy_history_text_cb * * dummy_history_log_cb * * * * Purpose: callback functions for storing historical data of types float, * * integer, string, text and log respectively in external storage * * * * Parameters: history - array of historical data * * history_num - number of elements in history array * * * ******************************************************************************/ static void dummy_history_float_cb(const ZBX_HISTORY_FLOAT *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_integer_cb(const ZBX_HISTORY_INTEGER *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_string_cb(const ZBX_HISTORY_STRING *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_text_cb(const ZBX_HISTORY_TEXT *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } static void dummy_history_log_cb(const ZBX_HISTORY_LOG *history, int history_num) { int i; for (i = 0; i < history_num; i++) { /* do something with history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */ } } /****************************************************************************** * * * Function: zbx_module_history_write_cbs * * * * Purpose: returns a set of module functions Zabbix will call to export * * different types of historical data * * * * Return value: structure with callback function pointers (can be NULL if * * module is not interested in data of certain types) * * * ******************************************************************************/ ZBX_HISTORY_WRITE_CBS zbx_module_history_write_cbs(void) { static ZBX_HISTORY_WRITE_CBS dummy_callbacks = { dummy_history_float_cb, dummy_history_integer_cb, dummy_history_string_cb, dummy_history_text_cb, dummy_history_log_cb, }; return dummy_callbacks; } ``` Модуль экпортирует 3 новых элемента данных: - `dummy.ping` — всегда возвращает «1» - `dummy.echo[param1]` — возвращает первый параметр как есть, например, `dummy.echo[ABC]` вернет ABC - `dummy.random[param1, param2]` — возвращает случайное число из диапазона param1-param2, например, `dummy.random[1,1000000]` #### 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 имеется дополнительная опция под названием *Динамический элемент*. Вы можете установить этот флажок, чтобы сделать виджет динамическим - то есть, способным отображать различное содержимое в зависимости от выбранного узла сети. Тогда после сохранения панели вы заметите, что в верхней части панели появилось новое поле для выбора узла сети (нажатие на кнопку *Выбрать* (*Select*) позволяет выбрать группу узлов сети во всплывающем окне):  Таким образом, у вас есть виджет, способный отображать содержимое на основании данных с выбранного узла сети. Преимущество этого в том, что вам не нужно создавать дополнительные виджеты только потому что, например, вы хотите видеть такие же графики, содержащие данные с разных узлов сети. #### 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) Лёгкое подключение использует следующие параметры для подключения к базе данных: - *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, задайте соответствующие параметры на шаге *Настройка соединения с базой данных* помощника по установке: - Хост базы данных: localhost - Порт базы данных: 1521 - Имя базы данных: ORCL - Пользователь: myusername - Пароль: 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_tree#service-configuration) a new service, click on the *Create service* button in the top right-hand corner. ### Изменение услуг Нажмите на кнопку *Изменить (Edit)*, чтобы перейти в режим редактирования. В режиме редактирования список дополнен флажками перед записями, а также дополнительными опциями: -  — добавить к данной услуге дочернюю -  — редактировать данную услугу -  — удалить данную услугу {width="600"} Для [настройки](/manual/it_services/service_tree#настройка-услуги) новой услуги нажмите на кнопку *Создать услугу (Create service)* в правом верхнем углу. ##### Element configuration ##### Настройка элемента #### Element tags Element tag values are explained in the table below. #### Теги элементов Значения тегов элементов описаны в таблице ниже. #### Element tags Element tag values are explained in the table below. #### Теги элементов Значения тегов элементов описаны в таблице ниже. #### 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<br>4 - SERVICE|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 email 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.| #### Теги элементов Значения тегов элементов описаны в таблице ниже. |Элемент|Свойство элемента|Обязательный|Тип|Диапазон^**[1](#примечания)**^|Описание| |--|--|-|--|----|--------| |media\_types| |\-| | |Корневой элемент способов оповещений.| | |name|x|`строка`| |Имя способа оповещения.| | |type|x|`строка`|0 — EMAIL<br>1 — SMS<br>2 — SCRIPT<br>4 — WEBHOOK|Транспорт, используемый способом оповещения.| | |status|\-|`строка`|0 — ENABLED (по умолчанию)<br>1 — DISABLED|Активирован ли способ оповещения.| | |max\_sessions|\-|`целое число`|Допустимые значения для SMS: 1 — (по умолчанию)<br><br>Допустимые значения для остальных способов оповещения: 0-100, 0 — без ограничений|Максимальное количество уведомлений, которые могут обрабатываться параллельно.| | |attempts|\-|`целое число`|1-10 (по умолчанию: 3)|Максимальное количество попыток отослать уведомление.| | |attempt\_interval|\-|`строка`|0-60s (по умолчанию: 10s)|Интервал между повторными попытками.<br><br>Принимаются секунды и единицы времени с суффиксом.| | |description|\-|`строка`| |Описание способа оповещения.| |message\_templates| |\-| | |Корневой элемент шаблонов сообщения способа оповещения.| | |event\_source|x|`строка`|0 — TRIGGERS<br>1 — DISCOVERY<br>2 — AUTOREGISTRATION<br>3 — INTERNAL<br>4 — SERVICE|Источник события.| | |operation\_mode|x|`строка`|0 — PROBLEM<br>1 — RECOVERY<br>2 — UPDATE|Режим работы.| | |subject|\-|`строка`| |Тема сообщения.| | |message|\-|`строка`| |Текст сообщения.| |*Используется только для способа оповещения Email*|<|<|<|<|<| | |smtp\_server|x|`строка`| |SMTP сервер.| | |smtp\_port|\-|`целое число`|По умолчанию: 25|Порт SMTP сервера для подключения.| | |smtp\_helo|x|`строка`| |SMTP helo.| | |smtp\_email|x|`строка`| |Email адрес, от имени которого отсылаются оповещения.| | |smtp\_security|\-|`строка`|0 — NONE (по умолчанию)<br>1 — STARTTLS<br>2 — SSL\_OR\_TLS|Уровень безопасности, который надо использовать для SMTP соединения.| | |smtp\_verify\_host|\-|`строка`|0 — NO (по умолчанию)<br>1 — YES|SSL проверка хоста для SMTP. Опционально, если smtp\_security выставлено в STARTTLS или SSL\_OR\_TLS.| | |smtp\_verify\_peer|\-|`строка`|0 — NO (по умолчанию)<br>1 — YES|SSL проверка сервера для SMTP. Опционально, если smtp\_security выставлено в STARTTLS или SSL\_OR\_TLS.| | |smtp\_authentication|\-|`строка`|0 — NONE (по умолчанию)<br>1 — PASSWORD|Метод аутентификации, который следует использовать для SMTP.| | |username|\-|`строка`| |Имя пользователя.| | |password|\-|`строка`| |Пароль аутентификации.| | |content\_type|\-|`строка`|0 — TEXT<br>1 — HTML (по умолчанию)|Формат сообщения.| |*Используется только для способа оповещения SMS*|<|<|<|<|<| | |gsm\_modem|x|`строка`| |Имя последовательного устройства модема GSM.| |*Используется только для способа оповещения Скрипт*|<|<|<|<|<| | |script name|x|`строка`| |Имя скрипта.| |parameters| |\-| | |Корневой элемент параметров скрипта.| |*Используется только для способа оповещения Вебхук*|<|<|<|<|<| | |script|x|`строка`| |Скрипт.| | |timeout|\-|`строка`|1-60s (по умолчанию: 30s)|Время ожидания запроса HTTP при выполнении скрипта JavaScript.| | |process\_tags|\-|`строка`|0 — NO (по умолчанию)<br>1 — YES|Обрабатывать ли возвращаемые теги.| | |show\_event\_menu|\-|`строка`|0 — NO (по умолчанию)<br>1 — YES|Если {EVENT.TAGS.\*} были успешно раскрыты в полях event\_menu\_url и event\_menu\_name, это поле означает присутствие пункта в меню события.| | |event\_menu\_url|\-|`строка`| |URL пункта меню события. Поддерживаются макросы {EVENT.TAGS.\*}.| | |event\_menu\_name|\-|`строка`| |Имя пункта меню события. Поддерживаются макросы {EVENT.TAGS.\*}.| |parameters| |\-| | |Корневой элемент параметров способа оповещений Вебхук.| | |name|x|`строка`| |Имя параметра вебхука.| | |value|\-|`строка`| |Значение параметра вебхука.| #### Element tags Element tag values are explained in the table below. |Element|Element property|Type|Range|Description| |--|--|--|----|--------| |images| | | |Root element for images.| | |name|`string`| |Unique image name.| | |imagetype|`integer`|1 - image<br>2 - background|Image type.| | |encodedImage| | |Base64 encoded image.| |maps| | | |Root element for maps.| | |name|`string`| |Unique map name.| | |width|`integer`| |Map width, in pixels.| | |height|`integer`| |Map height, in pixels.| | |label\_type|`integer`|0 - label<br>1 - host IP address<br>2 - element name<br>3 - status only<br>4 - nothing|Map element label type.| | |label\_location|`integer`|0 - bottom<br>1 - left<br>2 - right<br>3 - top|Map element label location by default.| | |highlight|`integer`|0 - no<br>1 - yes|Enable icon highlighting for active triggers and host statuses.| | |expandproblem|`integer`|0 - no<br>1 - yes|Display problem trigger for elements with a single problem.| | |markelements|`integer`|0 - no<br>1 - yes|Highlight map elements that have recently changed their status.| | |show\_unack|`integer`|0 - count of all problems<br>1 - count of unacknowledged problems<br>2 - count of acknowledged and unacknowledged problems separately|Problem display.| | |severity\_min|`integer`|0 - not classified<br>1 - information<br>2 - warning<br>3 - average<br>4 - high<br>5 - disaster|Minimum trigger severity to show on the map by default.| | |show\_suppressed|`integer`|0 - no<br>1 - yes|Display problems which would otherwise be suppressed (not shown) because of host maintenance.| | |grid\_size|`integer`|20, 40, 50, 75 or 100|Cell size of a map grid in pixels, if "grid\_show=1"| | |grid\_show|`integer`|0 - yes<br>1 - no|Display a grid in map configuration.| | |grid\_align|`integer`|0 - yes<br>1 - no|Automatically align icons in map configuration.| | |label\_format|`integer`|0 - no<br>1 - yes|Use advanced label configuration.| | |label\_type\_host|`integer`|0 - label<br>1 - host IP address<br>2 - element name<br>3 - status only<br>4 - nothing<br>5 - custom label|Display as host label, if "label\_format=1"| | |label\_type\_hostgroup|`integer`|0 - label<br>2 - element name<br>3 - status only<br>4 - nothing<br>5 - custom label|Display as host group label, if "label\_format=1"| | |label\_type\_trigger|`integer`|0 - label<br>2 - element name<br>3 - status only<br>4 - nothing<br>5 - custom label|Display as trigger label, if "label\_format=1"| | |label\_type\_map|`integer`|0 - label<br>2 - element name<br>3 - status only<br>4 - nothing<br>5 - custom label|Display as map label, if "label\_format=1"| | |label\_type\_image|`integer`|0 - label<br>2 - element name<br>4 - nothing<br>5 - custom label|Display as image label, if "label\_format=1"| | |label\_string\_host|`string`| |Custom label for host elements, if "label\_type\_host=5"| | |label\_string\_hostgroup|`string`| |Custom label for host group elements, if "label\_type\_hostgroup=5"| | |label\_string\_trigger|`string`| |Custom label for trigger elements, if "label\_type\_trigger=5"| | |label\_string\_map|`string`| |Custom label for map elements, if "label\_type\_map=5"| | |label\_string\_image|`string`| |Custom label for image elements, if "label\_type\_image=5"| | |expand\_macros|`integer`|0 - no<br>1 - yes|Expand macros in labels in map configuration.| | |background|`id`| |ID of the background image (if any), if "imagetype=2"| | |iconmap|`id`| |ID of the icon mapping (if any).| |urls| | | |Used by maps or each map element.| | |name|`string`| |Link name.| | |url|`string`| |Link URL.| | |elementtype|`integer`|0 - host<br>1 - map<br>2 - trigger<br>3 - host group<br>4 - image|Map item type the link belongs to.| |selements| | | | | | |elementtype|`integer`|0 - host<br>1 - map<br>2 - trigger<br>3 - host group<br>4 - image|Map element type.| | |label|`string`| |Icon label.| | |label\_location|`integer`|-1 - use map default<br>0 - bottom<br>1 - left<br>2 - right<br>3 - top| | | |x|`integer`| |Location on the X axis.| | |y|`integer`| |Location on the Y axis.| | |elementsubtype|`integer`|0 - single host group<br>1 - all host groups|Element subtype, if "elementtype=3"| | |areatype|`integer`|0 - same as whole map<br>1 - custom size|Area size, if "elementsubtype=1"| | |width|`integer`| |Width of area, if "areatype=1"| | |height|`integer`| |Height of area, if "areatype=1"| | |viewtype|`integer`|0 - place evenly in the area|Area placement algorithm, if "elementsubtype=1"| | |use\_iconmap|`integer`|0 - no<br>1 - yes|Use icon mapping for this element. Relevant only if iconmapping is activated on map level.| | |selementid|`id`| |Unique element record ID.| | |evaltype|`integer`| |Evaluation type for tags.| |tags| | | |Problem tags (for host and host group elements). If tags are given, only problems with these tags will be displayed on the map.| | |tag|`string`| |Tag name.| | |value|`string`| |Tag value.| | |operator|`integer`| |Operator.| |elements| | | |Zabbix entities that are represented on the map (host, host group, map etc).| | |host| | | | |icon\_off| | | |Image to use when element is in 'OK' status.| |icon\_on| | | |Image to use when element is in 'Problem' status.| |icon\_disabled| | | |Image to use when element is disabled.| |icon\_maintenance| | | |Image to use when element is in maintenance.| | |name|`string`| |Unique image name.| |shapes| | | | | | |type|`integer`|0 - rectangle<br>1 - ellipse|Shape type.| | |x|`integer`| |X coordinates of the shape in pixels.| | |y|`integer`| |Y coordinates of the shape in pixels.| | |width|`integer`| |Shape width.| | |height|`integer`| |Shape height.| | |border\_type|`integer`|0 - none<br>1 - bold line<br>2 - dotted line<br>3 - dashed line|Type of the border for the shape.| | |border\_width|`integer`| |Width of the border in pixels.| | |border\_color|`string`| |Border color represented in hexadecimal code.| | |text|`string`| |Text inside of shape.| | |font|`integer`|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|Text font style.| | |font\_size|`integer`| |Font size in pixels.| | |font\_color|`string`| |Font color represented in hexadecimal code.| | |text\_halign|`integer`|0 - center<br>1 - left<br>2 - right|Horizontal alignment of text.| | |text\_valign|`integer`|0 - middle<br>1 - top<br>2 - bottom|Vertical alignment of text.| | |background\_color|`string`| |Background (fill) color represented in hexadecimal code.| | |zindex|`integer`| |Value used to order all shapes and lines (z-index).| |lines| | | | | | |x1|`integer`| |X coordinates of the line point 1 in pixels.| | |y1|`integer`| |Y coordinates of the line point 1 in pixels.| | |x2|`integer`| |X coordinates of the line point 2 in pixels.| | |y2|`integer`| |Y coordinates of the line point 2 in pixels.| | |line\_type|`integer`|0 - none<br>1 - bold line<br>2 - dotted line<br>3 - dashed line|Line type.| | |line\_width|`integer`| |Line width in pixels.| | |line\_color|`string`| |Line color represented in hexadecimal code.| | |zindex|`integer`| |Value used to order all shapes and lines (z-index).| |links| | | |Links between map elements.| | |drawtype|`integer`|0 - line<br>2 - bold line<br>3 - dotted line<br>4 - dashed line|Link style.| | |color|`string`| |Link color (6 symbols, hex).| | |label|`string`| |Link label.| | |selementid1|`id`| |ID of one element to connect.| | |selementid2|`id`| |ID of the other element to connect.| |linktriggers| | | |Link status indicators.| | |drawtype|`integer`|0 - line<br>2 - bold line<br>3 - dotted line<br>4 - dashed line|Link style when trigger is in the 'Problem' state.| | |color|`string`| |Link color (6 symbols, hex) when trigger is in the 'Problem' state.| |trigger| | | |Trigger used for indicating link status.| | |description|`string`| |Trigger name.| | |expression|`string`| |Trigger expression.| | |recovery\_expression|`string`| |Trigger recovery expression.| #### Теги элементов Значения тегов элементов описаны в таблице ниже. |Элемент|Свойство элемента|Тип|Диапазон|Описание| |--|--|--|----|--------| |images| | | |Корневой элемент изображений.| | |name|`строка`| |Уникальное имя изображения.| | |imagetype|`целое число`|1 — image<br>2 — background|Тип изображения.| | |encodedImage| | |Изображение, закодированное в Base64.| |maps| | | |Корневой элемент карт сети.| | |name|`строка`| |Уникальное имя карты.| | |width|`целое число`| |Ширина карты, в пикселях.| | |height|`целое число`| |Высота карты, в пикселях.| | |label\_type|`целое число`|0 — подпись<br>1 — IP адрес узла сети<br>2 — имя элемента<br>3 — только состояние<br>4 — ничего|Тип подписи к элементам карты.| | |label\_location|`целое число`|0 — снизу<br>1 — слева<br>2 — справа<br>3 — сверху|Расположение подписи к элементам карты по умолчанию.| | |highlight|`целое число`|0 — нет<br>1 — да|Включение подсветки иконок для активных триггеров и состояний узлов сети.| | |expandproblem|`целое число`|0 — нет<br>1 — да|Отображение триггера с проблемой у элементов с одной проблемой.| | |markelements|`целое число`|0 — нет<br>1 — да|Подсветка элементов карты, которые недавно изменили своё состояние.| | |show\_unack|`целое число`|0 — количество всех проблем<br>1 — количество неподтвержденных проблем<br>2 — количество подтвержденных и неподтвержденных проблем раздельно|Отображение проблем.| | |severity\_min|`целое число`|0 — не классифицировано<br>1 — информация<br>2 — предупреждение<br>3 — средняя<br>4 — высокая<br>5 — чрезвычайная|Минимальная важность триггеров, которая отображается на карте, по умолчанию.| | |show\_suppressed|`целое число`|0 — нет<br>1 — да|Отображение проблем, которые в противном случае были бы подавлены (не показаны) по причине обслуживания узлов сети.| | |grid\_size|`целое число`|20, 40, 50, 75 или 100|Размер ячейки сетки карты в пикселях, если "grid\_show=1"| | |grid\_show|`целое число`|0 — да<br>1 — нет|Отображение сетки в настройке карты.| | |grid\_align|`целое число`|0 — да<br>1 — нет|Автоматическое выравнивание иконок в настройке карты.| | |label\_format|`целое число`|0 — нет<br>1 — да|Использование расширенной конфигурации подписей.| | |label\_type\_host|`целое число`|0 — подпись<br>1 — IP адрес узла сети<br>2 — имя элемента<br>3 — только состояние<br>4 — ничего<br>5 — пользовательская подпись|Метод отображения подписи к узлам сети, если "label\_format=1"| | |label\_type\_hostgroup|`целое число`|0 — подпись<br>2 — имя элемента<br>3 — только состояние<br>4 — ничего<br>5 — пользовательская подпись|Метод отображения подписи к группам узлов сети, если "label\_format=1"| | |label\_type\_trigger|`целое число`|0 — подпись<br>2 — имя элемента<br>3 — только состояние<br>4 — ничего<br>5 — пользовательская подпись|Метод отображения подписи к триггеров, если "label\_format=1"| | |label\_type\_map|`целое число`|0 — подпись<br>2 — имя элемента<br>3 — только состояние<br>4 — ничего<br>5 — пользовательская подпись|Метод отображения подписи к картам сети, если "label\_format=1"| | |label\_type\_image|`целое число`|0 — подпись<br>2 — имя элемента<br>4 — ничего<br>5 — пользовательская подпись|Метод отображения подписи к изображениям, если "label\_format=1"| | |label\_string\_host|`строка`| |Пользовательская подпись к элементам узлов сети, если "label\_type\_host=5"| | |label\_string\_hostgroup|`строка`| |Пользовательская подпись к элементам групп узлов сети, если "label\_type\_hostgroup=5"| | |label\_string\_trigger|`строка`| |Пользовательская подпись к элементам триггеров, если "label\_type\_trigger=5"| | |label\_string\_map|`строка`| |Пользовательская подпись к элементам карт сети, если "label\_type\_map=5"| | |label\_string\_image|`строка`| |Пользовательская подпись к элементам изображений, если "label\_type\_image=5"| | |expand\_macros|`целое число`|0 — нет<br>1 — да|Раскрытие макросов в подписях при настройке карты.| | |background|`id`| |Идентификатор фонового изображения (если имеется), если "imagetype=2"| | |iconmap|`id`| |Идентификатор соответствия иконок (если имеется).| |urls| | | |Используется картами сети либо каждым элементом карты.| | |name|`строка`| |Имя ссылки.| | |url|`строка`| |Сама ссылка URL.| | |elementtype|`целое число`|0 — узел сети<br>1 — карта<br>2 — триггер<br>3 — группа узлов сети<br>4 — изображение|Тип элемента карты, к которому относится ссылка.| |selements| | | | | | |elementtype|`целое число`|0 — узел сети<br>1 — карта<br>2 — триггер<br>3 — группа узлов сети<br>4 — изображение|Тип элемента карты.| | |label|`строка`| |Подпись к иконке.| | |label\_location|`целое число`|-1 — использование умолчаний карты<br>0 — снизу<br>1 — слева<br>2 — справа<br>3 — сверху| | | |x|`целое число`| |Расположение на оси X.| | |y|`целое число`| |Расположение на оси Y.| | |elementsubtype|`integer`|0 — одна группа узлов сети<br>1 — все узлы сети группы|Подтип элемента, если "elementtype=3"| | |areatype|`целое число`|0 — вписать во всю карту<br>1 — пользовательский размер|Размер области, если "elementsubtype=1"| | |width|`целое число`| |Ширина области, если "areatype=1"| | |height|`целое число`| |Высота области, если "areatype=1"| | |viewtype|`целое число`|0 — располагать равномерно в области|Алгоритм расположения в области, если "elementsubtype=1"| | |use\_iconmap|`целое число`|0 — нет<br>1 — да|Использование соответствия иконок для этого элемента. Уместно, только если соответствие иконок активировано на уровне карты.| | |selementid|`id`| |Уникальный идентификатор записи элемента.| | |evaltype|`целое число`| |Тип обработки тегов.| |tags| | | |Теги проблем (для элементов узел сети и группа узлов сети). Если теги указаны, на карте будут отображаться только проблемы с этими тегами.| | |tag|`строка`| |Имя тега.| | |value|`строка`| |Значение тега.| | |operator|`целое число`| |Оператор.| |elements| | | |Zabbix объекты, которые представлены на карте (узел сети, группа узлов сети, карта и т.д.).| | |host| | | | |icon\_off| | | |Изображение, используемое, когда элемент в состоянии «OK».| |icon\_on| | | |Изображение, используемое, когда элемент в состоянии «Проблема».| |icon\_disabled| | | |Изображение, используемое, когда элемент деактивирован.| |icon\_maintenance| | | |Изображение, используемое, когда элемент в обслуживании.| | |name|`строка`| |Уникальное имя изображения.| |shapes| | | | | | |type|`целое число`|0 — прямоугольник<br>1 — эллипс|Тип фигуры.| | |x|`целое число`| |Координата X фигуры (в пикселях).| | |y|`целое число`| |Координата Y фигуры (в пикселях).| | |width|`целое число`| |Ширина фигуры.| | |height|`целое число`| |Высота фигуры.| | |border\_type|`целое число`|0 — отсутствует<br>1 — жирная линия<br>2 — точечная линия<br>3 — пунктирная линия|Тип рамки фигуры.| | |border\_width|`целое число`| |Ширина рамки в пикселях.| | |border\_color|`строка`| |Цвет рамки, представленный в виде 16-ричного кода.| | |text|`строка`| |Текст внутри фигуры.| | |font|`целое число`|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|Стиль шрифта для текста.| | |font\_size|`целое число`| |Размер шрифта в пикселях.| | |font\_color|`строка`| |Цвет шрифта, представленный в виде 16-ричного кода.| | |text\_halign|`целое число`|0 — по центру<br>1 — по левой стороне<br>2 — по правой стороне|Выравнивание текста по горизонтали.| | |text\_valign|`целое число`|0 — по середине<br>1 — по верхнему краю<br>2 — по нижнему краю|Выравнивание текста по вертикали.| | |background\_color|`строка`| |Цвет фона (заливки), представленный в виде 16-ричного кода.| | |zindex|`целое число`| |Значение, используемое для указания порядка всех фигур и линий (z-index).| |lines| | | | | | |x1|`целое число`| |Координата X точки 1 линии в пикселях.| | |y1|`целое число`| |Координата Y точки 1 линии в пикселях.| | |x2|`целое число`| |Координата X точки 2 линии в пикселях.| | |y2|`целое число`| |Координата Y точки 2 линии в пикселях.| | |line\_type|`целое число`|0 — отсутствует<br>1 — жирная линия<br>2 — точечная линия<br>3 — пунктирная линия|Тип линии.| | |line\_width|`целое число`| |Ширина линии в пикселях.| | |line\_color|`строка`| |Цвет линии, представленный в виде 16-ричного кода.| | |zindex|`целое число`| |Значение, используемое для указания порядка всех фигур и линий (z-index).| |links| | | |Связи между элементами карты.| | |drawtype|`целое число`|0 — линия<br>2 — жирная линия<br>3 — точечная линия<br>4 — пунктирная линия|Стиль связи.| | |color|`строка`| |Цвет связи (6 символов, hex).| | |label|`строка`| |Подпись к связи.| | |selementid1|`id`| |Идентификатор первого элемента, с которым соединена связь.| | |selementid2|`id`| |Идентификатор второго элемента, с которым соединена связь.| |linktriggers| | | |Индикаторы состояния связей.| | |drawtype|`целое число`|0 — линия<br>2 — жирная линия<br>3 — точечная линия<br>4 — пунктирная линия|Стиль связи, когда триггер в состоянии «Проблема».| | |color|`строка`| |Цвет связи (6 символов, hex), когда триггер в состоянии «Проблема».| |trigger| | | |Триггер, используемый для индикации состояния связи.| | |description|`строка`| |Имя триггера.| | |expression|`строка`| |Выражение триггера.| | |recovery\_expression|`строка`| |Выражение восстановления триггера.| #### Email settings Initially there are several predefined notification [delivery methods](/manual/config/notifications/media) in Zabbix. [Email](/manual/config/notifications/media/email) is one of those. To configure email settings, go to *Administration → Media types* and click on *Email* in the list of pre-defined media types.  This will present us with the email settings configuration form.  All mandatory input fields are marked with a red asterisk. In the *Media type* tab, set the values of SMTP server, SMTP helo and SMTP email to the appropriate for your environment. ::: noteclassic 'SMTP email' will be used as the 'From' address for the notifications sent from Zabbix. ::: Next, it is required to define the content of the problem message. The content is defined by means of a message template, configured in the *Message templates* tab. Click on *Add* to create a message template, and select *Problem* as the message type.  Click on *Add* when ready and save the form. Now you have configured 'Email' as a working media type. The media type must also be linked to users by defining specific delivery addresses (like we did when [configuring a new user](login#adding_user)), otherwise it will not be used. #### Настройки E-mail Изначально в Zabbix имеется несколько предустановленных [способов доставки](/manual/config/notifications/media) оповещений. [E-mail](/manual/config/notifications/media/email) — один из них. Для конфигурирования настроек e-mail, перейдите в *Администрирование → Способы оповещений (Administration → Media types)* и нажмите на *Email* в списке предустановленных способов оповещений.  Отобразится диалог настроек e-mail.  Все обязательные поля ввода отмечены красной звёздочкой. На вкладке *Способ оповещений (Media type)* установите значения сервера SMTP, SMTP helo и SMTP e-mail, подходящие для вашей среды. ::: noteclassic «SMTP email» будет использоваться как адрес отправителя (поле «From:») при отправке оповещений от Zabbix. ::: Затем требуется определить содержимое сообщения о проблеме. Это содержимое определяется посредством шаблона сообщения, настраиваемого на вкладке *Шаблоны сообщений (Message templates)* . Для создания шаблона сообщения нажмите *Добавить (Add)* и выберите *Проблема (Problem)* в качестве типа сообщения.  Когда готовы, нажмите на *Добавить (Add)* и сохраните диалог. Теперь вы настроили «Email» как рабочий способ оповещения. Способ оповещения должен связываться с пользователями путём определения конкретных адресов доставки (как мы это делали, когда [настраивали нового пользователя](login#добавление-пользователя)), в противном случае он не будет использоваться. #### 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+ Добавлен новый плагин для прямого мониторинга Ember+ с помощью Zabbix агента 2. Для получения дополнительной информации см.: - [Readme плагина Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse?at=refs%2Fheads%2Frelease%2F6.0) - [Элементы данных агента 2](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#ember) - [Параметры плагина Ember+](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin) - [Установка агента 2](/manual/concepts/agent2#установка) ### 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>,<путь>\]|<|<|<| |Возвращает результат требуемого устройства.|Объект JSON|**uri** — URI устройства Ember+ . По умолчанию: 127.0.0.1:9998<br>**путь** — 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. Запрос: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```json { "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". Запрос: ```json { "jsonrpc": "2.0", "method": "mediatype.update", "params": { "mediatypeid": "6", "status": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```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". Запрос: ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "10092", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "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 } ``` #### Включение веб-сценария Включить веб-сценарий, то есть установить его статус в значение "0". Запрос: ```json { "jsonrpc": "2.0", "method": "httptest.update", "params": { "httptestid": "5", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Ответ: ```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 ``` #### Включение политики безопасности контента (CSP) на веб-сервере Чтобы защитить интерфейс Zabbix от межсайтового скриптинга (Cross Site Scripting, XSS), внедрения данных (data injection) и подобных атак, мы рекомендуем включить политику безопасности контента (Content Security Policy, CSP) на веб-сервере. Для этого настройте веб-сервер на возврат [HTTP-заголовка \[en\]](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy). ::: noteimportant Следующая конфигурация заголовка CSP предназначена только для установки веб-интерфейса Zabbix по умолчанию и для случаев, когда весь контент происходит из домена сайта (за исключением поддоменов). Другая конфигурация заголовка CSP может потребоваться, если вы, например, настраиваете виджет [*URL*](/manual/web_interface/frontend_sections/dashboards/widgets/url) для отображения контента из поддоменов сайта или внешних доменов, переключаете с *OpenStreetMap* на другой картографический движок или добавляете внешние CSS или виджеты. ::: Чтобы включить CSP для вашего веб-интерфейса Zabbix в конфигурации Apache, выполните следующие действия: 1\. Найдите ваш файл конфигурации виртуальных хостов: - `/etc/httpd/conf/httpd.conf` на системах на базе RHEL - `/etc/apache2/sites-available/000-default.conf` на Debian/Ubuntu 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 # на системах на базе RHEL: systemctl restart httpd.service # на 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 ``` #### Включение строгой транспортной безопасности HTTP (HSTS) на веб-сервере Чтобы защитить веб-интерфейс Zabbix от атак, понижающих версию протокола, мы рекомендуем включить [HSTS](https://ru.wikipedia.org/wiki/HSTS) политику на веб-сервере. Чтобы включить HSTS политику для веб-интерфейса вашего Zabbix в конфигурации Apache, выполните седующие шаги: 1\. Найдите файл конфигурации виртуальных хостов: - `/etc/httpd/conf/httpd.conf` на системах на базе RHEL - `/etc/apache2/sites-available/000-default.conf` на Debian/Ubuntu 2\. Добавьте следующую директиву к файл конфигурации ваших виртуальных хостов: ```ini <VirtualHost *:*> Header set Strict-Transport-Security "max-age=31536000" </VirtualHost> ``` 3\. Перезапустите службу Apache, чтобы применить изменения: ```bash # на системах на базе RHEL: systemctl restart httpd.service # на Debian/Ubuntu: systemctl restart apache2.service ``` #### Enabling MIB files On RedHat-based systems, MIB files should be enabled by default. On Debian-based systems, you have to edit the 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 файлы должны быть подключены по умолчанию. На системах на основе Debian вам нужно отредактировать файл `/etc/snmp/snmp.conf` и закомментировать строку, которая содержит `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 : #### Enabling multiple hosts Enable monitoring of two hosts, i.e., set their status to 0. Request: ```json { "jsonrpc": "2.0", "method": "host.massupdate", "params": { "hosts": [ { "hostid": "69665" }, { "hostid": "69666" } ], "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### Включение нескольких хостов Включить мониторинг двух хостов, т. е. установить их статус в 0. Запрос: ```json { "jsonrpc": "2.0", "method": "host.massupdate", "params": { "hosts": [ { "hostid": "69665" }, { "hostid": "69666" } ], "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```json { "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. #### Включение удалённого JMX мониторинга для Java приложений Приложению Java не требуется какое-либо дополнительно установленное программное обеспечение, но для поддержки удалённого мониторинга JMX приложение необходимо запустить с указанными ниже параметрами командной строки. Как минимум, если вы просто хотите начать мониторинг простого приложения 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 будет слушать входящие соединения JMX на порту 12345, только с локального хоста, без необходимости в аутентификации или SSL. Если вы хотите разрешить подключения с другого интерфейса, укажите параметр -Djava.rmi.server.hostname равным IP адресу этого интерфейса. Если вы хотите иметь более строгую проверку в плане безопасности, вам доступно множество других опций Java. Скажем, следующий пример запускает приложение с более мудрёным набором опций и открывает это приложение для более широкой сети, а не только для локального компьютера. 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=$ВАШЕ_ХРАНИЛИЩЕ_КЛЮЧЕЙ \ -Djavax.net.ssl.keyStorePassword=$ВАШ_ПАРОЛЬ_К_ХРАНИЛИЩУ_КЛЮЧЕЙ \ -Djavax.net.ssl.trustStore=$ВАШЕ_ДОВЕРЕННОЕ_ХРАНИЛИЩЕ \ -Djavax.net.ssl.trustStorePassword=$ВАШ_ПАРОЛЬ_К_ДОВЕРЕННОМУ_ХРАНИЛИЩУ \ -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 (или там, где этот файл расположен на вашем компьютере). Обратите внимание, что если вы хотите использовать SSL, вам необходимо изменить скрипт startup.sh, добавив в него опции Java gateway `-Djavax.net.ssl.*`, чтобы он знал, где найти хранилище ключей и доверенное хранилище. Смотрите [Мониторинг и Управление с использованием JMX \[en\]](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 ``` #### Включение Zabbix в корневом каталоге URL На системах на основе RHEL, добавьте виртуальный хост в файл конфигурации Apache (`/etc/httpd/conf/httpd.conf`) и настройте постоянную переадресацию для корневого каталога на Zabbix SSL URL. Обратите внимание, что *example.com* следует заменить на фактическое имя сервера. ```ini # Добавьте строки: <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. #### Доступные кодировки Чтобы убедиться, что полученные данные не повреждены, вы можете в параметре «кодировка» указать корректную кодировку для обработки проверки (например в «vfs.file.contents»). Список поддерживаемых кодировок (идентификаторов кодовых страниц) можно найти в документации к [libiconv](http://​www.gnu.org/​software/​libiconv/​) (GNU Project) или в документации к Microsoft Windows SDK по «Идентификаторам кодовых страниц»​. ​ Если кодировка не задана в параметре `​кодировка`, то применяются следующие стратегии преобразования: - Если кодировка не задана (или указана пустая строка), тогда предполагается наличие UTF-8 кодировки и данные обрабатываются «как есть»; - Анализ BOM — применяется к элементам данных «vfs.file.contents», «vfs.file.regexp», «vfs.file.regmatch». Предпринимается попытка определить корректную кодировку при помощи использования маркера последовательности байтов (BOM) в начале файла. Если BOM отсутствует — вместо этого применяется стандартное преобразование (см. выше). ##### 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 (pre-shared key) или сертификат.| |*Соединения с узла сети*|Выберите, какой тип подключений разрешён с узла сети (то есть, с Zabbix агента и Zabbix sender). Можно выбрать несколько типов соединений одновременно (полезно при тестировании и переключении на другой тип соединения). По умолчанию — «Без шифрования».| |*Издатель*|Разрешённый эмитент сертификата. Сертификат сначала подтверждается CA (центром сертификации). Если он действительный, подписан с помощью CA, тогда можно использовать поле *Издатель* для более строгого ограничения разрешённых CA. Это поле предназначено для использования, если ваша Zabbix инсталляция использует сертификаты от нескольких CA. Если поле не заполнено, то принимается любой CA.| |*Тема*|Разрешённая тема сертификата. Сертификат сначала подтверждается CA. Если он действительный, подписан с помощью CA, тогда можно использовать поле *Тема*, чтобы разрешить только одно значение строки *Тема*. Если поле пустое, тогда принимается любой сертификат, подписанный настроенным CA.| |*Идентификатор PSK*|Строка идентификации pre-shared key.<br>Не указывайте конфиденциальную информацию в идентификаторе PSK, так как он передаётся по сети в незашифрованном виде для информирования получателя, какой PSK использовать.| |*PSK*|Pre-shared key (строка в шестнадцатеричном формате). Максимальная длина: 512 шестнадцатеричных цифр (256-байт PSK), если Zabbix использует библиотеки GnuTLS или OpenSSL, 64 шестнадцатеричных цифры (32-байт PSK), если Zabbix использует библиотеку mbed TLS (PolarSSL). Пример: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952| ### Encryption with certificate authority verification ### Режим Verify CA ### Encryption with certificate authority verification Copy required MySQL CA to the Zabbix frontend server, assign proper permissions to allow the webserver to read this file. ::: noteclassic This mode doesn't work on SLES 12 and RHEL 7 due to older MySQL libraries. ::: ### Режим Verify CA Скопируйте нужный MySQL CA на сервер с веб-интерфейсом Zabbix, назначьте правильные права доступа, чтобы разрешить веб-серверу читать этот файл. ::: noteclassic Режим *Verify CA* не работает на SLES 12 и RHEL 7 из-за более старых библиотек MySQL. ::: ### Encryption with full verification ### Режим Verify full ### Encryption with full verification ### Режим Verify Full #### 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 #### Принудительное применение безопасных и SameSite сеансовых файлов cookie в Zabbix При настройке Zabbix важно принудительно применять атрибуты secure и SameSite для сеансовых файлов cookie для повышения безопасности и предотвращения атак с подделкой межсайтовых запросов (CSRF). Однако, принудительное применение ``SameSite=Strict`` может вызвать проблемы в определённых сценариях, такие как: - Виджеты URL панели отображают «пользователь не вошел в систему» ("user not logged in") при встраивании фреймов (iframes) того же домена. - Пользователи, получающие доступ к панели через HTTP вместо HTTPS, могут столкнуться с проблемами входа. - Невозможность поделиться URL-адресами к определённым разделам меню Zabbix или хостам. Чтобы смягчить эти проблемы, пользователи должны иметь возможность настроить политику SameSite. 1\. Безопасные файлы cookie Установка флага ``secure`` гарантирует, что файлы cookie будут передаваться только по HTTPS, предотвращая раскрытие информации при незашифрованных соединениях. Чтобы включить безопасные файлы cookie в Zabbix, добавьте или измените следующую настройку в конфигурации веб-сервера: Для Apache: Header always edit Set-Cookie ^(.*)$ $1;Secure Для Nginx: proxy_cookie_path / "/; Secure"; Убедитесь, что ваш веб-интерфейс Zabbix доступен через HTTPS; в противном случае файлы cookie с флагом ``Secure`` не будут отправляться. 2\. Настройка атрибута SameSite Настройки веб-сервера также могут принудительно применять атрибут 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). #### Количество объектов Добавлены новые [функции](/manual/appendix/functions), которые упрощают подсчет количества заданных узлов сети, элементов данных или значений, которые возвращаются [функциями цикла](/manual/appendix/functions/aggregate/foreach). Функции агрегации: - **count** -- общее количество значений в массиве, полученном от функции цикла (возвращается целое число); - **item\_count** -- общее количество активированных на момент опроса элементов данных, попадающих под заданный фильтр (возвращается целое число). Функция цикла: - **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. #### Количество объектов Добавлены новые [функции](/manual/appendix/functions), упрощающие подсчёт отдельных узлов сети, элементов данных или значений, которые возвращаются [функциями цикла](/manual/appendix/functions/aggregate/foreach). Функции агрегации: - **count** - общее количество значений в массиве, который вернулся при помощи функции цикла (возвращается целое положительное число); - **item\_count** - общее количество активированных в данный момент времени элементов данных, попадающих под критерий фильтра (возвращается целое положительное число). Функция цикла: - **exists\_foreach** - общее количество активированных в данный момент времени элементов данных, попадающих под критерий фильтра (возвращается массив). #### Определение аномалий Zabbix 5.2 внёс новые функции динамики изменений полезных для базисного мониторинга. Однако, эти функции до сих пор требуют необходимость определить относительных значений порогов (например, проверка, что веб-трафик в Сентябре 2021 менее чем в 2 раза выше по сравнению с Сентябрём 2020). Бывают такие случаи, когда определить такие пороги затруднительно. Например, веб-трафик нового, но крайне популярного веб-сайта может органично рости много раз за год, но темпы роста будет неизвестными. Тем не менее, внезапный всплеск трафика из-за DDOS атаки должен сгенерировать оповещение вне зависимости от органичности роста трафика. Алгоритмы определения аномалий как раз это и делают - они ищут данные, которые не выглядят нормально (исключения) в контексте других значений. Добавлена новая [функция истории](/manual/appendix/functions/history) trendstl(), которая использует метод 'расчленения' для вычисления частоты аномалий. Эта функция разделяет один ряд времени на три ряда времени: - ряд динамики изменений, который содержит только большие изменения в исходных данных (например, когда трафик веб-сайта показывает рост) - ряд сезонности, который содержит только сезонные изменения (например, меньше трафика на веб-сайт летом, больше осенью) - остаточный ряд, который содержит только остаточные значения, которые не могут быть объяснены как части динамики изменения или сезона  Обнаружение аномалий работает с остаточным рядом и проверяет имеются ли значения слишком далёкие от большинства значений остаточного ряда. "Далёкие" означает, что абсолютное значение из остаточного ряда в N раз больше, чем стандартное или среднее отклонения. ##### 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 агент 2 Каждый плагин Zabbix агент 2 теперь имеет отдельный [файл конфигурации](/manual/appendix/config/zabbix_agent2_plugins). По молчанию, эти файлы располагаются в `./zabbix_agent2.d/plugins.d/` директории. Этот путь указывается в `Include` параметре файла конфигурации агента 2 и может быть относительным к расположению [zabbix\_agent2.conf](/manual/appendix/config/zabbix_agent2) или [zabbix\_agent2.win.conf](/manual/appendix/config/zabbix_agent2_win) файлов. ##### 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>`. #### Файлы окружения В той же директории с файлами конфигурации compose на github.com вы можете найти файлы с переменными окружения по умолчанию для каждого компонента из файлов конфигурации compose. Эти файлы окружения называются приблизительно так: `.env_<тип компоненты>`. #### Error messages ODBC error messages are structured into fields to provide detailed information. For example, an error message might look like this: Cannot execute ODBC query: [SQL_ERROR]:[42601][7][ERROR: syntax error at or near ";"; Error while executing the query] - "`Cannot execute ODBC query`" - Zabbix message - "`[SQL_ERROR]`" - ODBC return code - "`[42601]`" - SQLState - "`[7]`" - Native error code - "`[ERROR: syntax error at or near ";"; Error while executing the query]`" - Native error message Note that the error message length is limited to 2048 bytes, so the message can be truncated. If there is more than one ODBC diagnostic record Zabbix tries to concatenate them (separated with `|`) as far as the length limit allows. #### Сообщения об ошибках Сообщения об ошибках ODBC структурированы по полям для предоставления подробной информации. Например, сообщение об ошибке может выглядеть следующим образом: Cannot execute ODBC query: [SQL_ERROR]:[42601][7][ERROR: syntax error at or near ";"; Error while executing the query] - «`Cannot execute ODBC query`» — сообщение Zabbix - «`[SQL_ERROR]`» — код, возвращаемый ODBC - «`[42601]`» — SQLState - «`[7]`» — исходный код ошибки - «`[ERROR: syntax error at or near ";"; Error while executing the query]`» — исходное сообщение об ошибке Обратите внимание, что длина сообщения об ошибке ограничена 2048 байтами, поэтому сообщение может быть усечено. Если имеется более одной диагностической записи ODBC, Zabbix пытается их скомпоновать (разделяя символом `|`), насколько позволяет ограничение по длине. #### 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). #### Ошибки при выполнении fping в контейнерах без root-доступа Когда контейнеры работают в режиме без root-доступа или в среде со специальными ограничениями, вы можете столкнуться с ошибками, связанными с выполнением fping при выполнении проверок ICMP, такими как: `fping: Operation not permitted`, — или потерей всех пакетов ко всем ресурсам. Для исправления этой проблема добавьте `--cap-add=net_raw` к командам «docker run» или «podman run». В дополнение к этому, выполнение fping в средах без root-доступа может потребовать модификации sysctl, то есть: sudo sysctl -w "net.ipv4.ping_group_range=0 1995" где «1995» — это GID zabbix. Для дополнительной информации смотрите [ZBX-22833](https://support.zabbix.com/browse/ZBX-22833) \[en\]. #### Escalation examples #### Примеры эскалаций #### Evaluation period An evaluation period is used in functions referencing the item history. It allows to specify the interval we are interested in. It can be specified as time period (30s, 10m, 1h) or as a value range (\#5 - for five latest values). The evaluation period is measured up to "now" - where "now" is the latest recalculation time of the trigger (see [Calculation time](#calculation_time) above); "now" is not the "now" time of the server. The evaluation period specifies either: - To consider all values between "now-time period" and "now" (or, with time shift, between "now-time shift-time period" and "now-time\_shift") - To consider no more than the num count of values from the past, up to "now" - If there are 0 available values for the time period or num count specified - then the trigger or calculated item that uses this function becomes unsupported Note that: - If only a single function (referencing data history) is used in the trigger, "now" is always the latest received value. For example, if the last value was received an hour ago, the evaluation period will be regarded as up to the latest value an hour ago. - A new trigger is calculated as soon as the first value is received (history functions); it will be calculated within 30 seconds for [date and time](/manual/appendix/functions/time) and nodata() functions. Thus the trigger will be calculated even though perhaps the set evaluation period (for example, one hour) has not yet passed since the trigger was created. The trigger will also be calculated after the first value, even though the evaluation range was set, for example, to ten latest values. #### Период вычисления Период вычисления используется в функциях, которые ссылаются на историю элемента данных. Это позволяет указать интересующий нас интервал. Интервал можно указать в виде периода времени (30s, 10m, 1h) или в виде диапазонов значений (\#5 — для пяти последних значений). Период вычисления измеряется до «сейчас», где «сейчас» — это время последнего пересчёта триггера (смотрите [Время вычисления](#время-вычисления) выше); «сейчас» — это не «текущее» время сервера. Период вычисления указывает либо: - Учитывать все значения между «сейчас - период времени» и «сейчас» (или, при наличии сдвига времени, между «сейчас - сдвиг\_времени - период времени» и «сейчас - сдвиг\_времени») - Учитывать не более чем количество значений из прошлого, до «сейчас» - Если имеется 0 доступных значений за этот период времени или указанное количество — тогда триггер или вычисляемый элемент данных, который использует такую функцию, становится неподдерживаемым Обратите внимание, что: - Если в триггере используется одна функция (которая ссылается на данные истории), «сейчас» всегда последнее полученное значение. Например, если последнее значение получено час назад, период вычисления будет рассматриваться до последнего значения часом ранее. - Новый триггер вычисляется сразу, как только получено первое значение (функции истории); он будет вычисляться в течение 30 секунд при наличии функций [даты и времени](/manual/appendix/functions/time) и функции nodata(). Таким образом, триггер будет вычислен, даже если заданный период оценки (например, один час) еще не прошёл с момента создания триггера. Триггер также будет вычислен после первого значения — даже если диапазон оценки был задан, например, последними десятью значениями. # event.acknowledge # event.acknowledge ##### 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 ##### Корреляция событий Корреляция событий (также называемая глобальной корреляцией событий) является способом настройки пользовательских правил закрытия событий (в результате чего генерируются ОК события). Правила определяют, каким образом новые события проблемы соотносятся с существующими событиями проблемы и позволяют закрыть новое событие или совпадающие события при помощи генерации ОК событий. Однако, корреляцию событий необходимо настраивать очень осторожно, так как она может негативно повлиять на производительность обработки событий или, при неправильной настройке, закрыть больше событий, чем требуется (в худшем случае могут быть закрыты вообще все события о проблемах). Несколько советов по настройке: 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. #### Меню события При нажатии на имени проблемы открывается меню события:  Меню события позволяет: - фильтровать проблемы триггера - перейти к настройкам триггера - перейти к простому графику/истории элементов данных, к которым относится проблема - перейти к внешней системе обработки заявок по данной проблеме (при соответствующих настройках [вебхука](/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 для более гибкого управления ситуациями или интеграции со сторонними инструментами. [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.| ### Тег события Объект тега события имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |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 сервере будут различаться более чем на 10 секунд. Обратите внимание, что «system.localtime» должен быть настроен как [пассивная проверка](/manual/appendix/items/activepassive#пассивные-проверки). ##### 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 Этот триггер сработает, если средняя загрузка за последний час более чем вдвое превысит среднюю загрузку за тот же час вчера. ##### 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 Этот триггер сработает, если по крайней мере два триггера в выражении будут в состоянии ПРОБЛЕМА. ##### 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 Сравнение строковых значений двух элементов данных: операнды здесь — это функции, которые возвращают строки. Проблема: создание оповещения, если версия 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 Сравнение двух строковых значений — операнды здесь: - функция, которая возвращает строку - комбинация макросов и строк Проблема: обнаружение изменений в 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}" Обратите внимание на кавычки вокруг второго операнда. ##### 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 Сравнение двух строковых значений — операнды здесь: - функция, которая возвращает строку - строковая константа со специальными символами \\ и " Проблема: определить, идентично ли содержимое файла `/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 сервера увеличилась более чем на 10% за последний месяц trendavg(/Exchange/system.cpu.load,1M:now/M)>1.1*trendavg(/Exchange/system.cpu.load,1M:now/M-1M) Вы можете также использовать поле [Имени события](/manual/config/triggers/trigger#настройка) в настройках триггера, чтобы создать осмысленное сообщение оповещения, например, для получения примерно следующего `"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)}) Также для подобных проблем полезно было бы разрешить закрывать триггер вручную в настройках самого триггера. ##### 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: Discovering MBeans This rule will return 3 objects: the top row of the column: MBean1, MBean2, MBean3. For more information about objects please refer to [supported macros](/manual/discovery/low_level_discovery/examples/jmx#supported_macros) table, *Discovery of MBeans* section. Discovery rule configuration collecting MBeans (without the attributes) looks like the following:  The key used here: jmx.discovery[beans,"*:type=GarbageCollector,name=*"] All the garbage collectors without attributes will be discovered. As Garbage collectors have the same attribute set, we can use desired attributes in item prototypes the following way:  The keys used here: jmx[{#JMXOBJ},CollectionCount] jmx[{#JMXOBJ},CollectionTime] jmx[{#JMXOBJ},Valid] LLD discovery rule will result in something close to this (items are discovered for two Garbage collectors): {width="600"} ##### Пример 1: Обнаружение MBeans Это правило вернёт 3 объекта: верхнюю строку со столбцами: MBean1, MBean2, MBean3. Для более подробной информации об объектах, пожалуйста, обратитесь к таблице [поддерживаемые макросы](/manual/discovery/low_level_discovery/examples/jmx#поддерживаемые-макросы), раздел *Обнаружение объектов MBean*. Конфигурация правила обнаружения для сбора объектов MBeans (без атрибутов) выглядит наподобие следующего:  Используемый здесь ключ: jmx.discovery[beans,"*:type=GarbageCollector,name=*"] Будут обнаружены все сборщики мусора (garbage collectors) без атрибутов. Поскольку сборщики мусора имеют одинаковый набор атрибутов, мы можем использовать желаемые атрибуты в прототипах элементов данных следующим образом:  Используемые здесь ключи: jmx[{#JMXOBJ},CollectionCount] jmx[{#JMXOBJ},CollectionTime] jmx[{#JMXOBJ},Valid] Правило LLD обнаружения приведёт к чему-то, близкому к этому (элементы данных обнаружены для двух сборщиков мусора): {width="600"} ##### 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 (или .1.2.3.45.6.7.8.0)| |**Ключ**|<Уникальная строка, которая используется как ссылка в триггерах><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 Тема сообщения: Проблема: {TRIGGER.NAME} При получении сообщения тема этого сообщения будет заменена на нечто подобное: Проблема: Загрузка процессора слишком высокая на Zabbix сервере ##### 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 Мониторинг двух экземпляров “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), например: `mysql.ping[MySQL1]`, `mysql.ping[MySQL2]` **Example 1** Restart of Windows on certain condition. In order to automatically restart Windows upon a problem detected by Zabbix, define the following script: |Script parameter|Value| |--|--------| |*Scope*|'Action operation'| |*Type*|'Script'| |*Command*|c:\\windows\\system32\\shutdown.exe -r -f| **Пример 1** Перезагрузка Windows при определённом условии. Для того, чтобы автоматически перезагрузить Windows, когда Zabbix обнаруживает проблемы, задайте следующий скрипт: |Параметр скрипта|Значение| |--|--------| |*Область*|«Операция действия»| |*Тип*|«Скрипт»| |*Команда*|c:\\windows\\system32\\shutdown.exe -r -f| ##### 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 Отправка повторяющихся оповещений каждые 30 минут (в общей сложности 5 раз) группе «MySQL администраторы». Для настройки: - На вкладке *Операции (Operations)* задайте *Длительность шага операции по умолчанию (Default operation step duration)* значением «30m» (30 минут) - Укажите шаги эскалаций *С (From)* «1» *До (To)* «5» - Выберите группу «MySQL администраторы» получателями сообщений {width="600"} Оповещения будут отправлены в 0:00, 0:30, 1:00, 1:30, 2:00 часов после начала проблемы (если, конечно, проблема не будет решена раньше). Если проблема решена и сообщение о восстановлении настроено, оно будет отправлено всем тем, кто получил хотя бы одно сообщение в этом сценарии эскалаций. ::: 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 Отправка простых GET запросов на получение данных с таких сервисов, как Elasticsearch: - Создайте GET элемент данных с URL: `localhost:9200/?pretty` - Обратите внимание на ответ: ```{=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\[что угодно\]. - 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*, и они одинаковые как у оригинального события, так и у нового события. Эта операция будет закрывать новые события о проблемах по тому же самому сетевому порту, оставив открытой только изначальную проблему. ##### 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. last(/Zabbix server/system.cpu.load[all,avg1])>5 Используя функцию «last()», мы ссылаемся на самое последнее значение. `/Zabbix server/system.cpu.load[all,avg1]` представляет короткое имя наблюдаемого параметра. Эта строка указывает, что сервер — «Zabbix server», а наблюдаемый ключ — «system.cpu.load\[all,avg1\]». Наконец, `>5` означает, что триггер будет переходить в состояние ПРОБЛЕМА всякий раз, когда самое последнее измерение загрузки процессора на сервере Zabbix server будет превышать 5. ##### 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 Для создания триггера «Ошибка в веб-сценарии» вы можете указать следующее выражение триггера: last(/узел_сети/web.test.fail[Сценарий])<>0 Не забудьте заменить «Сценарий» на реальное название вашего сценария. ##### 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 Использование макроса уровня узла сети в ключе элемента данных «Состояние демона SSH»: `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 Использование следующего регулярного выражения в LLD для обнаружения баз данных не будет принимать во внимание базу данных с заданным именем: ^TESTDATABASE$  Выбран *Тип выражения*: «Результат ЛОЖЬ». Не соответствует имени, содержащему строку «*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 Вычисление 10-минутного усреднения количества значений, обрабатываемых Zabbix. Использование функции **avg**: avg(/Zabbix Server/zabbix[wcache,values],10m) Обратите внимание, что интенсивное использование вычисляемых элементов данных с большими периодами времени может повлиять на производительность Zabbix сервера. ##### Example 2: Discovering MBean attributes This rule will return 9 objects with the following fields: MBean1Attribute1, MBean2Attribute1, MBean3Attribute1, MBean1Attribute2, MBean2Attribute2, MBean3Attribute2, MBean1Attribute3, MBean2Attribute3, MBean3Attribute3. For more information about objects please refer to [supported macros](/manual/discovery/low_level_discovery/examples/jmx#supported_macros) table, *Discovery of MBean attributes* section. Discovery rule configuration collecting MBean attributes looks like the following:  The key used here: jmx.discovery[attributes,"*:type=GarbageCollector,name=*"] All the garbage collectors with a single item attribute will be discovered.  In this particular case an item will be created from prototype for every MBean attribute. The main drawback of this configuration is that trigger creation from trigger prototypes is impossible as there is only one item prototype for all attributes. So this setup can be used for data collection, but is not recommended for automatic monitoring. ##### Пример 2: Обнаружение атрибутов MBean Этот объект вернёт 9 объектов со следующими полями: MBean1Attribute1, MBean2Attribute1, MBean3Attribute1, MBean1Attribute2, MBean2Attribute2, MBean3Attribute2, MBean1Attribute3, MBean2Attribute3, MBean3Attribute3. Для более подробной информации об объектах, пожалуйста, обратитесь к таблице [поддеживаемых макросов](/manual/discovery/low_level_discovery/examples/jmx#поддерживаемые-макросы), раздел *Обнаружение атрибутов MBean*. Конфигурация правила обнаружения, собирающего атрибуты MBean, выглядит наподобие следующего:  Используемый здесь ключ: jmx.discovery[attributes,"*:type=GarbageCollector,name=*"] Будут обнаружены все сборщики мусора с одним атрибутом.  В данном конкретном случае будет создан элемент данных из прототипа для каждого атрибута MBean. Главный недостаток этой конфигурации — что невозможно создание триггера из прототипа триггера, поскольку имеется только один прототип элемента данных для всех атрибутов. Поэтому такая настройка может использоваться для сбора данных, но не рекомендуется для автоматического мониторинга. ##### 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 Очень мало свободного места на диске. Выражение проблемы: если меньше 10ГБ за последние 5 минут max(/server/vfs.fs.size[/,free],5m)<10G Выражение восстановления: если больше 40ГБ за последние 10 минут 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. Параметрами мы можем передать имя пользователя и пароль: 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 Сообщение: Загрузка процессора: {?last(/zabbix.zabbix.com/system.cpu.load[,avg1])} При получении сообщения само сообщение будет заменено на нечто подобное: Загрузка процессора: 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| |**Ключ**|router.uptime| |**Тип информации**|Числовой (с плавающей точкой)| |**Единица измерения**|uptime| |**Множитель**|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.Postgres.Sessions.Session1.Uri=tcp://192.0.2.234:5432 Plugins.Postgres.Sessions.Session1.User=old_username Plugins.Postgres.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** Restart the host by using IPMI control. |Script parameter|Value| |--|--------| |*Scope*|'Action operation'| |*Type*|'IPMI'| |*Command*|reset| **Пример 2** Перезагрузка узла сети с использованием управления по IPMI. |Параметр скрипта|Значение| |--|--------| |*Область*|«Операция действия»| |*Тип*|«IPMI»| |*Команда*|reset| ##### 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 Отправка оповещения с задержкой о давней проблеме. Для настройки: - На вкладке *Операции (Operations)* задайте *Длительность шага операции по умолчанию (Default operation step duration)* значением «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 Отправка простых POST запросов на получение данных с таких сервисов, как Elasticsearch: - Создайте POST элемент данных с URL: `http://localhost:9200/str/values/_search?scroll=10s` - Настройте следующее тело POST, чтобы получать загрузку процессора (среднее значение за 1 минуту по каждому ядру) ```{=html} <!-- --> ``` { "query": { "bool": { "must": [{ "match": { "itemid": 28275 } }], "filter": [{ "range": { "clock": { "gt": 1517565836, "lte": 1517566137 } } }] } } } - Получено: ```{=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, чтобы получить значение элемента данных: `$.hits.hits[0]._source.value` ##### Example 2 ***Step 1*** Using host metadata to allow some basic protection against unwanted hosts registering. ##### Пример 2 ***Шаг 1*** Использование метаданных узла для обеспечения некоторой базовой защиты от регистрации нежелательных узлов сети. ##### 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\[\*\]. 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 Для создания триггера «Веб-сценарий завершился с ошибкой» с полезным описанием проблемы в имени триггера вы можете указать триггер с именем: Веб сценарий "​Scenario"​ завершился с ошибкой: {ITEM.VALUE} и выражением триггера: length(last(/узел_сети/web.test.error[Сценарий]))>0 and last(/узел_сети/web.test.fail[Сценарий])>0 Не забудьте заменить «Сценарий» на реальное название вашего сценария. ##### 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 слишком высокая»: `last(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}` Такой триггер можно создать на уровне шаблона, а не редактировать на отдельных узлах сети. ::: notetip Если в качестве параметра функции вы хотите использовать количество значений (например, **max(/узел сети/ключ,\#3)**), добавьте символ решётки (\#) непосредственно в значение макроса, например вот так: SOME\_PERIOD ⇒ \#3 ::: ##### 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, либо загрузка процессора больше значения 2 в течение последних 10 минут. ##### 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. Сумма двух функций: 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 Проверка, доступен ли Zabbix API, используя [apiinfo.version](/manual/api/reference/apiinfo/version). - Настройка элемента данных:  Обратите внимание на использование метода POST с данными JSON, установку заголовков запроса и запрос на возврат только заголовков: - Предварительная обработка значений элемента данных при помощи регулярного выражения, чтобы получить HTTP код:  - Проверка результата в *Последние данные*: {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. В данном же случае администраторы получат четыре сообщения до того, как проблема будет эскалирована Менеджеру баз данных. Обратите внимание, что менеджер получит сообщение только в случае, если проблема ещё не подтверждена, предположительно, никто не работает над ней. {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) Это выражение будет истинным, когда предыдущее значение контрольной суммы файла /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 Сообщение: Последнее значение: {?last(/{HOST.HOST}/{ITEM.KEY})} МАКС за 15 минут: {?max(/{HOST.HOST}/{ITEM.KEY},15m)} МИН за 15 минут: {?min(/{HOST.HOST}/{ITEM.KEY},15m)} При получении сообщения само сообщение будет заменено на нечто подобное: Последнее значение: 1.45 МАКС за 15 минут: 2.33 МИН за 15 минут: 1.01 **Example 3** Power off the host by using IPMI control. |Script parameter|Value| |--|--------| |*Scope*|'Action operation'| |*Type*|'IPMI'| |*Command*|power off| **Пример 3** Выключение узла сети с использованием управления по IPMI. |Параметр скрипта|Значение| |--|--------| |*Область*|«Операция действия»| |*Тип*|«IPMI»| |*Команда*|power off| ##### 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 Для создания триггера «Веб-приложение медленно отвечает» вы можете указать следующее выражение триггера: last(/узел_сети/web.test.in[Сценарий,,bps])<10000 Не забудьте заменить «Сценарий» на реальное название вашего сценария. ##### 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 слишком высокая»: `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 Усреднение за 5 минут количества запросов в секунду по группе узлов сети «MySQL Servers». 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 отправит сообщение всем гостевым пользователям. Если и это не поможет, спустя ещё час Zabbix перезагрузит сервер с этой базой данных MySQL (вторая удалённая команда), используя IPMI команды. {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])) Смотрите также: [Примеры агрегированных вычислений](/manual/config/items/itemtypes/calculated/aggregate#примеры-использования). ##### 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. - Настройка основного элемента данных для массового сбора данных в одном JSON:  Обратите внимание на использование макросов в полях запроса. Обратитесь к [Openweathermap API \[en\]](https://openweathermap.org/current) для получения подробных сведений о том, чем их заполнять. Пример JSON, который вернулся в ответе HTTP агенту: ``` {.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. - Настройка примера зависимого элемента данных для влажности:  Другие метрики погоды, такие как «Температура», добавляются тем же способом. - Пример предобработки значений зависимого элемента данных с использованием JSONPath:  - Проверка результата данных о погоде в *Последние данные*: {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 превышает 100 КБ за последние 5 минут. ##### 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 Синхронизация условия недоступности агентов с интервалом обновления элемента данных: - задайте макрос {$INTERVAL} и используйте его в интервале обновления элемента данных; - используйте {$INTERVAL} как параметр в триггере на недоступность агента: `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 Эскалация с несколькими операциями, назначенными на один шаг, и с использованием пользовательских интервалов. Длительность шага операции по умолчанию равна 30 минутам. {width="600"} Оповещения будут отправлены в следующем порядке: - администраторам MySQL в 0:00, 0:30, 1:00, 1:30 после начала проблемы - менеджеру баз данных в 2:00 и 2:10 (но не в 3:00; учитывая, что шаги 5 и 6 перекрываются со следующей операцией, более короткая пользовательская длительность в 10 минут перекрывает более длительную пользовательскую длительность, равную 1 часу) - Zabbix администраторам в 2:00, 2:10, 2:20, 2:30 после начала проблемы (задана пользовательская длительность шага, равная 10 минутам) - гостевым пользователям в 4:00 часа после начала проблемы (интервал по умолчанию, равный 30 минутам, возвращается между шагами 8 и 11) ##### 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 серверов недоступны. Обратите внимание на то, что в выражении используются два разных узла сети: last(/smtp1.example.com/net.tcp.service[smtp])=0 and last(/smtp2.example.com/net.tcp.service[smtp])=0 Это выражение будет истинным, когда оба SMTP сервера недоступны — и на smtp1.example.com, и на smtp2.example.com. ##### Example 5 Centralize configuration of working hours: - create a global {$WORKING\_HOURS} macro equal to `1-5,09:00-18:00`; - use it in the *Working time* field in *Administration* → *General* → *GUI*; - use it in the *When active* field in *Administration* → *Users* → *Media*; - use it to set up more frequent item polling during working hours:  - use it in the *Time period* action condition; - adjust the working time in *Administration* → *General* → *Macros*, if needed. ##### Пример 5 Централизованная настройка рабочего времени: - создайте глобальный макрос {$WORKING\_HOURS}, равный значению `1-5,09:00-18:00`; - используйте его в поле *Рабочее время (Working time)* в разделе *Администрирование* → *Общие* → *Веб-интерфейс* (*Administration* → *General* →*GUI*); - используйте его в поле *Когда активно (When active)* в *Администрирование* → *Пользователи* → *Оповещения* (*Administration* → *Users* →*Media*); - используйте его для настройки более частого опроса элементов данных в течение рабочего времени:  - используйте его в условии действия *Период времени (Time period)*; - измените рабочее время в *Администрирование* → *Общие* → *Макросы* (*Administration* → *General* → *Macros*) при необходимости. ##### 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 и получение его метрик за один запрос. - Настройте Nginx, следуя [официальному руководству](https://nginx.ru/ru/docs/http/ngx_http_stub_status_module.html). ```{=html} <!-- --> ``` - Настройте основной элемент данных для массового сбора данных:  Пример вывода состояния Nginx stub: Active connections: 1 Active connections: server accepts handled requests 52 52 52 Reading: 0 Writing: 1 Waiting: 0 Следующая задача — настроить зависимые элементы данных, которые извлекают необходимые данные. - Настройка примера зависимого элемента данных для запросов в секунду:  - Настройка предварительной обработки значений зависимого элемента данных при помощи регулярного выражения `server accepts handled requests\s+([0-9]+) ([0-9]+) ([0-9]+)`: {width="600"} - Проверьте полученный результат от модуля stub в *Последние данные*: {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 Информирование о значениях с нескольких узлов сети из выражения триггера. Сообщение: Имя проблемы: {TRIGGER.NAME} Выражение триггера: {TRIGGER.EXPRESSION} 1. Значение элемента данных на {HOST.NAME1}: {ITEM.VALUE1} ({ITEM.NAME1}) 2. Значение элемента данных на {HOST.NAME2}: {ITEM.VALUE2} ({ITEM.NAME2}) При получении сообщения само сообщение будет заменено на нечто подобное: Имя проблемы: Загрузка процессора слишком высокая на локальном хосте Выражение триггера: last(/Myhost/system.cpu.load[percpu,avg1])>5 or last(/Myotherhost/system.cpu.load[percpu,avg1])>5 1. Значение элемента данных на Myhost: 0.83 (Загрузка процессора (усреднение за 1 мин по ядрам)) 2. Значение элемента данных на Myotherhost: 5.125 (Загрузка процессора (усреднение за 1 мин по ядрам)) ##### 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 Вычисление с использованием суммы последних значений элементов данных по всей группе узлов сети. 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 Получение деталей по событию о проблеме и событию о восстановлении в сообщении о [восстановлении](/manual/config/notifications/action/recovery_operations): Сообщение: Проблема: ID события: {EVENT.ID} Значение события: {EVENT.VALUE} Состояние события: {EVENT.STATUS} Время события: {EVENT.TIME} Дата события: {EVENT.DATE} Возраст события: {EVENT.AGE} Подтверждение события: {EVENT.ACK.STATUS} История обновления события: {EVENT.UPDATE.HISTORY} Восстановление: ID события: {EVENT.RECOVERY.ID} Значение события: {EVENT.RECOVERY.VALUE} Состояние события: {EVENT.RECOVERY.STATUS} Время события: {EVENT.RECOVERY.TIME} Дата события: {EVENT.RECOVERY.DATE} Оперативные данные: {EVENT.OPDATA} При получении сообщения эти макросы будет заменены на нечто подобное: Проблема: ID события: 21874 Значение события: 1 Состояние события: PROBLEM Время события: 13:04:30 Дата события: 2018.01.02 Возраст события: 5m Подтверждение события: Yes История обновления события: 2018.01.02 13:05:51 "John Smith (Admin)" Действия: подтверждено. Восстановление: ID события: 21896 Значение события: 0 Состояние события: OK Время события: 13:10:07 Дата события: 2014.01.02 Оперативные данные: Текущее значение: 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 Используйте макрос прототипа узлов сети для настройки элементов данных у обнаруженных узлов сети: - на уровне прототипа узлов сети задайте пользовательский макрос {$SNMPVALUE} с значением в виде макроса [низкоуровневого обнаружения](/manual/config/macros/lld_macros) {\#SNMPVALUE}:  - назначьте шаблон *Generic SNMPv2* на прототип узлов сети; - используйте {$SNMPVALUE} в поле *SNMP OID* элементов данных шаблона *Generic SNMPv2*. ##### 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 агент нуждается в обновлении. Используется функция find(): find(/example.example.com/agent.version,,"like","beta8")=1 Это выражение будет истинным, когда версия Zabbix агента содержит «beta8». ##### 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 минут. ##### 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 минуты. Используется функция nodata(): nodata(/example.example.com/tick,3m)=1 Для того, чтобы этот триггер заработал, элемент данных «tick» должен быть определён как элемент данных с типом Zabbix [траппер](/manual/config/items/itemtypes/trapper). Узел сети должен периодически отправлять данные этому элементу данных, используя zabbix\_sender. Если никаких данных не было получено за последние 180 секунд, значение триггера станет ПРОБЛЕМА. *Обратите внимание*, что «nodata» можно использовать с любым типом элементов данных. ##### 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()<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. Индекс будет присоединён к OID'у данных, чтобы получить интересующее нас значение: HOST-RESOURCES-MIB::hrSWRunPerfMem.5388 = INTEGER: 31468 KBytes ##### Example of several dependencies For example, the Host is behind the Router2 and the Router2 is behind the Router1. Zabbix - Router1 - Router2 - Host If the Router1 is down, then obviously the Host and the Router2 are also unreachable, yet receiving three notifications about the Host, the Router1 and the Router2 all being down is excessive. So in this case we define two dependencies: the 'Host is down' trigger depends on the 'Router2 is down' trigger the 'Router2 is down' trigger depends on the 'Router1 is down' trigger Before changing the status of the 'Host is down' trigger, Zabbix will check for the corresponding trigger dependencies. If such are found and one of those triggers is in the 'Problem' state, then the trigger status will not be changed, the actions will not be executed and no notifications will be sent. Zabbix performs this check recursively. If the Router1 or the Router2 is unreachable, the Host trigger won't be updated. ##### Примеры нескольких зависимостей Например, узел сети Хост находится за маршрутизатором Роутер2, а Роутер2 находится за Роутер1. Zabbix — Роутер1 — Роутер2 — Хост Если Роутер1 недоступен, то очевидно, что и Хост, и Роутер2 тоже недоступны; и получение трёх оповещений о недоступности Хост, Роутер1 и Роутер2 является избыточным. Поэтому в данном случае мы зададим две зависимости: триггер «Хост недоступен» зависит от триггера «Роутер2 недоступен» триггер «Роутер2 недоступен» зависит от триггера «Роутер1 недоступен» Перед изменением состояния триггера «Хост недоступен» Zabbix проверит зависимости у соответствующих триггеров. Если они будут найдены, и один из триггеров в находится в состоянии ПРОБЛЕМА, то состояние триггера не будет изменено и, следовательно, действия не будут выполнены и оповещения не будут отправлены. Zabbix выполняет эту проверку рекурсивно. Если Роутер1 или Роутер2 недоступен, то триггер у Хост не будет изменён. 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 #Увеличение уровня журналирования у второго процесса поллера: 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. *Пример:* Проблема *Веб камера 3 недоступна* имеет теги `тип:видеонаблюдение`, `этаж:1-й` и `имя:вебкамера 3` и состояние *Предупреждение* Услуга **Веб камера 3** имеет единственный тег проблемы: `имя:вебкамера 3` {width=600} При обнаружении этой проблемы состояние услуги изменится с *ОК* на *Предупреждение*. Если услуга **Веб камера 3** имеет теги проблем `имя:вебкамера 3` и `этаж:2-й`, её состояние не изменится при обнаружении проблемы, так как условия удовлетворены лишь частично. ### 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 ### Примеры ### 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 and dealing with errors To get a warning when you are about to run out of free disk space on your host, you may use a trigger expression like this: timeleft(/host/vfs.fs.size[/,free],1h,0)}<1h However, error code -1 may come into play and put your trigger in a problem state. Generally it's good because you get a warning that your predictions don't work correctly and you should look at them more thoroughly to find out why. But sometimes it's bad because -1 can simply mean that there was no data about the host free disk space obtained in the last hour. If you are getting too many false positive alerts, consider using more complicated trigger expression ^[5](#footnotes)^: timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1 The situation is a bit more difficult with **forecast**. First of all, -1 may or may not put the trigger in a problem state depending on whether you have expression like `forecast(/host/item,(...))<...` or like `forecast(/host/item,(...))>...` Furthermore, -1 may be a valid forecast if it's normal for the item value to be negative. But probability of this situation in the real world situation is negligible (see [how](/manual/config/triggers/expression) the operator **=** works). So add `... or forecast(/host/item,(...))=-1` or `... and forecast(/host/item,(...))<>-1` if you want or don't want to treat -1 as a problem respectively. #### Footnotes ^**1**^ For example, a simple trigger like `timeleft(/host/item,1h,X) < 1h` may go into problem state when the item value approaches X and then suddenly recover once value X is reached. If the problem is item value being below X, use: `last(/host/item) < X or timeleft(/host/item,1h,X) < 1h` If the problem is item value being above X, use: `last(/host/item) > X or timeleft(/host/item,1h,X) < 1h` ^**2**^ Polynomial degree can be from 1 to 6, *polynomial1* is equivalent to *linear*. However, use higher degree polynomials [with caution](https://en.wikipedia.org/wiki/Runge's_phenomenon). If the evaluation period contains less points than needed to determine polynomial coefficients, polynomial degree will be lowered (e.g., *polynomial5* is requested, but there are only 4 points, therefore *polynomial3* will be fitted). ^**3**^ For example, fitting *exponential* or *power* functions involves calculating log() of item values. If data contains zeros or negative numbers, you will get an error since log() is defined for positive values only. ^**4**^ For *linear*, *exponential*, *logarithmic* and *power* fits all necessary calculations can be written explicitly. For *polynomial* only *value* can be calculated without any additional steps. Calculating *avg* involves computing polynomial antiderivative (analytically). Computing *max*, *min* and *delta* involves computing polynomial derivative (analytically) and finding its roots (numerically). Solving f(t) = 0 involves finding polynomial roots (numerically). ^**5**^ But in this case -1 can cause your trigger to recover from the problem state. To be fully protected use: `timeleft(/host/vfs.fs.size[/,free],1h,0)<1h and ({TRIGGER.VALUE}=0 and timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1 or {TRIGGER.VALUE}=1)` #### Примеры и обработка ошибок Для получения предупреждения о том, что у вашего узла сети скоро закончится свободное дисковое пространство, вы можете использовать следующее выражение триггера: timeleft(/узел сети/vfs.fs.size[/,free],1h,0)}<1h Однако, может появиться код ошибки -1 и перевести ваш триггер в состояние проблемы. Вообще говоря, это неплохо, потому что вы получите предупреждение о том, что ваши прогнозирования не работают должным образом, и вам стоит обратить на них внимание, чтобы разобраться почему. Но иногда это плохо, потому что -1 может просто означать, что за последний час не было получено никаких данных о свободном дисковом пространстве данного узла сети. Если вы получаете много сообщений о ложных тревогах, подумайте об использовании более сложного выражения триггера ^[5](#примечания)^: timeleft(/узел сети/vfs.fs.size[/,free],1h,0)<1h and timeleft(/узел сети/vfs.fs.size[/,free],1h,0)<>-1 С **forecast** ситуация немного сложнее. Начнём с того, что -1 может перевести, а может и не перевести триггер в состояние проблемы в зависимости от вашего выражения триггера, которое может быть вроде `forecast(/узел сети/элемент данных,(...))<...` или наподобие `forecast(/узел сети/элемент данных,(...))>...` Более того, -1 может быть вполне корректным результатом прогнозирования, если прогнозируемый элемент данных может принимать отрицательные значения. Но вероятность возникновения такой ситуации в реальных условиях пренебрежительно мала (смотрите, [как](/manual/config/triggers/expression) работает оператор **=**). Поэтому добавьте `... or forecast(/узел сети/элемент данных,(...))=-1` или `... and forecast(/узел сети/элемент данных,(...))<>-1`, если вы соответсвенно хотите или, наоборот, не хотите рассматривать -1 как проблему. #### Примечания ^**1**^ Например, простой триггер такой как `timeleft(/узел сети/элемент данных,1h,X) < 1h` может перейти в состояние проблемы, когда элемент данных приближается к X, и неожиданно восстановиться, как только значение X достигнуто. Если проблема выражается в том, что значение элемента данных меньше X, используйте: `last(/узел сети/элемент данных) < X or timeleft(/узел сети/элемент данных,1h,X) < 1h`. Если проблема заключается в том, что значение элемент данных больше X, используйте: `last(/узел сети/элемент данных) > X or timeleft(/узел сети/элемент данных,1h,X) < 1h` ^**2**^ Степень многочлена может быть от 1 до 6, при этом функция *polynomial1* равнозначна *linear*. Однако, использовать полиномы высоких степеней следует [с осторожностью](https://ru.wikipedia.org/wiki/Феномен_Рунге). Если период вычисления содержит меньше точек, чем требуется для определения коэффициентов полинома, степень полинома понизится (например, запрашивается *polynomial5*, но есть только 4 точки, поэтому для аппроксимации будет использована *polynomial3*). ^**3**^ Например, построение экспоненциальной (*exponential*) и степенной (*power*) функций требует логарифмических вычислений значений элемента данных. Если данные содержат нулевые или отрицательные числа, вы получите сообщение об ошибке, поскольку вычисление логарифма возможно только при положительных значениях. ^**4**^ При аппроксимации *linear*, *exponential*, *logarithmic* и *power* выражений все необходимые вычисления можно написать в явном виде. При *polynomial* можно вычислить только *value* без дополнительных шагов. Вычисление *avg* включает в себя вычисление первообразной полинома (аналитически). Вычисление *max*, *min* и *delta* включает в себя вычисление производной полинома (аналитически) и поиск его корней (численно). Решение f(t) = 0 требует нахождения корней полинома (численно). ^**5**^ Но в этом случае -1 может восстановить триггер из состояния проблемы. Для полной защищённости используйте: `timeleft(/узел сети/vfs.fs.size[/,free],1h,0)<1h and ({TRIGGER.VALUE}=0 and timeleft(/узел сети/vfs.fs.size[/,free],1h,0)<>-1 or {TRIGGER.VALUE}=1)` #### 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#настройка-глобального-скрипта), которые можно использовать как удалённые команды в операциях к действиям. #### 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" ``` #### Примеры Здесь представлены несколько фрагментов кода, демонстрирующих, как к тем данным, которые вы хотите отослать (переменная `data`), добавить заголовок протокола Zabbix, чтобы пакет, который вам нужно отправить в Zabbix, получился таким, чтобы он правильно интерпретировался. Эти фрагменты кода подразумевают, что данные не превышают 1 ГБ, поэтому формат больших пакетов не используется. ##### 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 Let's review two more practical examples of an LLD rule creation with the use of MBean. To understand the difference between an LLD rule collecting MBeans and an LLD rule collecting MBean attributes better please take a look at following table: | | | | |---|---|---| |**MBean1**|**MBean2**|**MBean3**| |MBean1Attribute1|MBean2Attribute1|MBean3Attribute1| |MBean1Attribute2|MBean2Attribute2|MBean3Attribute2| |MBean1Attribute3|MBean2Attribute3|MBean3Attribute3| ##### Примеры Давайте обратимся ещё к двум более практическим примерам создания правил LLD с применением MBean. Для лучшего понимания разницы между правилом LLD, собирающем объекты MBeans, и правилом LLD, собирающем атрибуты MBean, взгляните на следующую таблицу: | | | | |---|---|---| |**MBean1**|**MBean2**|**MBean3**| |MBean1Attribute1|MBean2Attribute1|MBean3Attribute1| |MBean1Attribute2|MBean2Attribute2|MBean3Attribute2| |MBean1Attribute3|MBean2Attribute3|MBean3Attribute3| #### 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 6.0 для каждого из компонентов Zabbix и запустит их в detach режиме. ::: noteimportant Не забудьте загрузить `.env_<тип компонента>` файлы с официального репозитория Zabbix на github.com с файлами конфигурации. ::: **Пример 2** # git checkout 6.0 # docker compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d Эта команда загрузит образ на основе Ubuntu 20.04 (focal), затем локально соберёт компоненты Zabbix 6.0 и запустит их в detach режиме. ##### 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. ##### Примеры корректного/некорректного синтаксиса Выражения (включая вызовы функций) нельзя использовать в качестве параметров к [функциям](/manual/appendix/functions) истории, динамики изменений или foreach. Однако, сами эти функции могут быть использованы в параметрах других (не относящихся к истории) функций. |Выражение|Пример| |-|---------| |Допустимое|`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)))`| |Недопустимое|`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>(ГБ)|База данных|Amazon EC2^**2**^| |-|-|-|-|-|-| |Маленькая|1 000|2|8|MySQL сервер,<br>Percona сервер,<br>MariaDB сервер,<br>PostgreSQL|m6i.large/m6g.large| |Средняя|10 000|4|16|MySQL сервер,<br>Percona сервер,<br>MariaDB сервер,<br>PostgreSQL|m6i.xlarge/m6g.xlarge| |Большая|100 000|16|64|MySQL сервер,<br>Percona сервер,<br>MariaDB сервер,<br>PostgreSQL,<br>Oracle|m6i.4xlarge/m6g.4xlarge| |Очень большая|1 000 000|32|96|MySQL сервер,<br>Percona сервер,<br>MariaDB сервер,<br>PostgreSQL,<br>Oracle|m6i.8xlarge/m6g.8xlarge| ^**1**^ 1 метрика = 1 элемент данных + 1 триггер + 1 график<br> ^**2**^ Пример с инстансами Amazon EC2 общего назначения, с использованием архитектур ARM64 или x86_64. Необходимый тип инстанса, такой как оптимизированный на Compute/Memory/Storage, необходимо выбрать во время оценки и тестирования инсталляции 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 / Память|База данных|Количество наблюдаемых хостов| |----|--------|----------|--------|---------------| |*Маленькая*|CentOS|Виртуальная машина|MySQL InnoDB|100| |*Средняя*|CentOS|2 CPU ядер/2GB|MySQL InnoDB|500| |*Большая*|RedHat Enterprise Linux|4 CPU ядер/8GB|RAID10 MySQL InnoDB or PostgreSQL|>1000| |*Очень большая*|RedHat Enterprise Linux|8 CPU ядер/16GB|Быстрый RAID10 MySQL InnoDB или PostgreSQL|>10000| ::: noteclassic Фактические параметры конфигурации зависят от количества активных элементов данных и частоты обновления этих элементов (ознакомьтесь с разделом [размер базы данных](/manual/installation/requirements#размер_базы_данных) этой страницы). Настоятельно рекомендуется запускать базу данных на отдельном сервере для крупных инсталляций. ::: ##### 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 Для элемента данных с ключом «ping» агент будет всегда возвращать «1». Более сложный пример: UserParameter=mysql.ping,mysqladmin -uroot ping|grep -c alive Агент будет возвращать «1», если MySQL сервер доступен, «0» — в противном случае. #### Examples of triggers #### Примеры триггеров ##### 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 } ``` ### Примеры Запрос: ``` {.json} { "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: ```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 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). ### Примеры Следующие примеры предназначены только для описания конфигурации объектов полей виджета информационной панели для виджета *Веб-мониторинг*. Для получения дополнительной информации о настройке информационной панели см. [`dashboard.create`](/manual/api/reference/dashboard/create). #### Examples The following examples show common configuration patterns for `AllowKey` and `DenyKey`. #### Примеры Следующие примеры демонстрируют распространенные шаблоны конфигурации для `AllowKey` и `DenyKey`. #### 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 for text/log items are truncated to 20 characters in some frontend locations. To see the full values of these macros you may use macro functions, e.g.: `{{ITEM.VALUE}.regsub("(.*)", \1)}`<br> `{{ITEM.LASTVALUE}.regsub("(.*)", \1)}` See also: {ITEM.VALUE} and {ITEM.LASTVALUE} [macro details](/manual/appendix/macros/supported_by_location). #### Примеры Способы использования функции макросов для модификации значений макросов проиллюстрированы следующими примерами полученных значений: |Полученное значение|Макрос|Вывод| |----|----|----| |`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")}`|`*НЕИЗВЕСТНО*` (ошибочное регулярное выражение)| |`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)}` (ошибочное регулярное выражение)| |`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)}"}` (ошибочное регулярное выражение)| |`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)}\"}")` (ошибочное регулярное выражение)| ##### Просмотр полных значений элемента данных Длинные значения раскрытых макросов {ITEM.VALUE} и {ITEM.LASTVALUE} для текстовых или журнальных элементов данных в некоторых местах веб-интерфейса обрезаются до 20 символов. Для просмотра полных значений этих макросов вы можете использовать функции макросов, например: `{{ITEM.VALUE}.regsub("(.*)", \1)}`<br> `{{ITEM.LASTVALUE}.regsub("(.*)", \1)}` Смотрите также: [более подробная информация о макросах](/manual/appendix/macros/supported_by_location) {ITEM.VALUE} и {ITEM.LASTVALUE}. #### 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#важные-замечания); - кавычки экранируются. **Функция макросов в параметре ключа элемента данных** Регулярное выражение: `.+:(\d+)$`<br> Ключ элемента данных: `net.tcp.service[tcp,,"{{ITEM.VALUE}.regsub(\".+:(\d+)$\",\1)}"]` Замечания: - регулярное выражение внутри функции макросов `regsub` заключается в двойные кавычки (из-за того, что содержит закрывающие скобки); - Символы кавычек, обрамляющие регулярное выражение, экранируются (из-за того, что весь третий параметр элемента данных заключается в кавычки); - третий параметр ключа элемента данных заключается в кавычки, поскольку он содержит запятую. **Функция макросов низкоуровневого обнаружения (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)}\"}")` Замечания по трём уровням экранирования: 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]+\"}"` Замечания: - Строки также требуют экранирования обратных слэшей; - Строки также требуют экранирования кавычек; - Снова случай с двумя уровнями экранирования: 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**\ Отправить **342.45** в качестве значения элемента данных **mysql.queries** наблюдаемого узла сети. Будут использованы отслеживаемый узел сети и сервер Zabbix, определённые в конфигурационном файле агента. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Наблюдаемый узел сети" -k mysql.queries -o 342.45**\ Отправить **342.45** в качестве значения элемента данных **mysql.queries** узла сети **Наблюдаемый узел сети**, используя сервер Zabbix, определённый в конфигурационном файле агента. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ Отправить значения из файла **data\_values.txt** на сервер Zabbix с IP **192.168.1.113**. Имена узлов и ключи определяются в файле. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ Отправить значение с отметкой времени из командной строки на сервер Zabbix, указанный в конфигурационном файле агента. Знак минуса во входных данных указывает, что имя узла сети также должно использоваться из того же конфигурационного файла. \ **echo '"Zabbix сервер" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ Отправить пустое значение элемента данных на сервер Zabbix с IP-адресом **192.168.1.113** на порт **10000** из командной строки. Пустые значения должны быть обозначены пустой строкой в двойных кавычках. **zabbix\_sender -z 192.168.1.113 -s "Наблюдаемый узел" -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**\ Отправить **342.45** в качестве значения для элемента данных **mysql.queries** в **Наблюдаемый узел** на Zabbix сервер с IP-адресом **192.168.1.113** с использованием TLS сертификата. **zabbix\_sender -z 192.168.1.113 -s "Наблюдаемый узел" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ Отправить **342.45** в качестве значения для элемента данных **mysql.queries** в **Наблюдаемый узел** на Zabbix сервер с IP-адресом **192.168.1.113** с использованием TLS и общего ключа (pre-shared key, PSK). [ ]{#lbAI} #### Example The following example demonstrates how to quickly setup VMware monitoring on Zabbix: - make sure that Zabbix server has been compiled with the required options (--with-libxml2 and --with-libcurl): the log file must contain "VMware monitoring: YES" during server startup. - set the StartVMwareCollectors option in Zabbix server configuration file to 2 or more - create a new host - set the host macros required for VMware authentication:  - link the host to the VMware service template:  - click on the **Add** button to save the host. #### Пример Следующий пример демонстрирует, как можно быстро настроить мониторинг VMware в Zabbix: - убедитесь, что Zabbix сервер скомпилирован с требуемыми опциями (--with-libxml2 и --with-libcurl): файл журнала при запуске сервера должен содержать: «VMware monitoring: YES». - задайте параметр StartVMwareCollectors в файле конфигурации Zabbix сервера значением 2 или более - создайте новый узел сети - укажите требуемые для аутентификации в VMware макросы на уровне узла сети:  - присоедините узел сети к шаблону службы VMware:  - нажмите на кнопку **Добавить**, чтобы сохранить узел сети. ### Example The required JSON string 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 in 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 the 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 16MB. For more details, see [data limits for LLD return values](/manual/discovery/low_level_discovery/notes#data-limits-for-return-values). ### Пример Требуемый формат строки JSON лучше всего иллюстирируется примером. Предположим, мы запускаем старый агент Zabbix 1.8 (один из тех, что не поддерживают «vfs.fs.discovery»), но при этом нам нужно иметь обнаружение файловых систем. Здесь простой скрипт на Perl для Linux, который обнаруживает смонтированные файловые системы и выводит JSON, содержащий имя файловой системы и её тип. Одним из способов его использования могло бы быть определить его как UserParameter с ключом «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 Символы, разрешённые в именах 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 макросам, используемым в прототипах; альтернатива — извлекать значения LLD макросов с помощью JSONPath `{#FSNAME}` → `$.fsname` и `{#FSTYPE}` → `$.fstype`, тогда можно использовать такой скрипт: ``` {.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 Вы не обязаны использовать имена макросов FSNAME/FSTYPE в пользовательских правилах LLD, вы можете выбирать такие имена, как вам нравится. В случае, если используется JSONPath, то строка LLD будет элементом массива, который может являться объектом, но также может быть другим массивом или значением. ::: Обратите внимание, если используется пользовательский параметр, то возвращаемое значение ограничено 16 МБ. Для получения более подробной информации смотрите [ограничения данных для возвращаемых значений LLD](/manual/discovery/low_level_discovery/notes#ограничения-данных-для-возвращаемых-значений). ##### 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. ##### Пример с использованием inline модификатора регулярного выражения Использование следующего регулярного выражения, которое включает inline модификатор (?i) для поиска соответствия символов «error»: (?i)error  Выбран *Тип выражения*: «Результат ИСТИНА». Есть соответствие по символам «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. #### Этапы выполнения :::noteclassic По умолчанию, все скрипты в Zabbix выполняются с имользованием оболочки *sh*, и оболочку по умолчанию изменить нельзя. Чтобы использовать другую оболочку, можно использовать следующий приём: создать файл скрипта и вызвать этот скрипт при выполнении команды. ::: Команда/скрипт выполняется одинаково как на Unix, так и на Windows платформах: 1. Zabbix (родительский процесс) cоздаёт конвейер для связи 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. #### Код завершения процесса До версии Zabbix 2.2, Zabbix агент возвращал 0 в случае успешного завершения процесса и код 255 в случае ошибки. Начиная с версии Zabbix 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, считается ошибкой выполнения. - Содержимое стандарного вывода ошибки и стандартного вывода собирается при ошибочных выполнениях и доступно в веб-интерфейсе (где отображается результат выполнения). - Для удалённых команд, выполняемых на Zabbix агенте/прокси, дополнительная запись в журнале может создаваться, используя параметр LogRemoteCommands на [агенте](/manual/appendix/config/zabbix_agentd)/[прокси](/manual/appendix/config/zabbix_proxy). Возможные сообщения в веб-интерфейсе и записи в журналах при ошибочных командах/скриптах: - Содержимое стандарного вывода ошибки и стандартного вывода при ошибочных выполнениях (если имеется). - «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, если значения были отправлены и все они были успешно обработаны сервером. Если данные были отправлены, но обработка хотя бы одного из значений не удалась, статус завершения равен 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 строк объектов. Если объектов больше, этот список можно раскрыть до максимум 1000 записей (значение SUBFILTER_VALUES_PER_GROUP в [определениях веб-интерфейса](/manual/web_interface/definitions)), нажав на иконку с многоточием, которая отображается в конце списка. Ранее нераскрываемый максимум был ограничен 100 записями. - Теперь в списке *Значения тегов* отображаются до 10 строк имен тегов. Если имеется большее количество имен тегов со значениями, этот список можно расширить до максимально 200 имен тегов, нажав на иконку с многоточием, которая отображается снизу. Ранее, нераскрываемый максимум был ограничен 20 строками с именами тегов. По каждому имени тега отображается до 10 строк значений (можно расширить до 1000 записей (значение SUBFILTER_VALUES_PER_GROUP в [определениях веб-интерфейса](/manual/web_interface/definitions))). #### Expanded command-line parameters for agent MSI installer packages Zabbix agent MSI installer packages (for both Zabbix agent and Zabbix agent 2) now support the following parameters when performing an [installation from the command line](/manual/installation/install_from_packages/win_msi#command-line-based-installation): - `HOSTNAMEITEM` - specifies the Zabbix agent item used to obtain the host name - `UNSAFEUSERPARAMETERS` - allows all characters (e.g., \ ' " ` * ?) to be passed in arguments to user-defined parameters - `STARTAGENTS` - specifies the number of pre-forked `zabbix_agentd` instances that process passive checks - `DONOTSTART` - prevents the MSI installer from starting the Zabbix agent service - `SOURCEIP` - specifies the source IP address for outgoing connections to the Zabbix server/proxy, or for connections made when executing certain items (e.g., `web.page.get`, `net.tcp.port`) #### Расширенные параметры командной строки для пакетов MSI инсталлятора агента Пакеты MSI инсталлятора Zabbix агента (как для Zabbix агента, так и для Zabbix агента 2) теперь при выполнении [установки из командной строки](/manual/installation/install_from_packages/win_msi#установка-через-командную-строку) поддерживают следующие параметры: - `HOSTNAMEITEM` — задаёт элемент данных Zabbix агента, используемый для получения имени узла сети - `UNSAFEUSERPARAMETERS` — разрешает передавать аргументами в пользовательские параметры все символы (например, \ ' " ` * ?) - `STARTAGENTS` — указывает количество экземпляров запускаемых при старте процессов `zabbix_agentd`, обрабатывающих пассивные проверки - `DONOTSTART` — запрещает инсталлятору MSI запускать службу Zabbix агента - `SOURCEIP` — задаёт локальный IP адрес для исходящих подключений к Zabbix серверу/прокси либо для подключений, производимых при выполнении определённых элементов данных (например, `web.page.get`, `net.tcp.port`) #### 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 При обновлении Zabbix на [Red Hat Enterprise Linux](/manual/installation/upgrade/packages/rhel#обновите-пакет-конфигурации-репозитория) вы можете столкнуться с проблемой просроченного ключа подписи для пакетов в [репозитории 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 ``` Чтобы решить такие проблемы, переустановите вручную последний пакет `zabbix-release` для вашего конкретного варианта RHEL (замените сслыку ниже на правильную из [репозитория 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 \[en\]](https://support.zabbix.com/browse/ZBX-24761). ##### 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 или [Zabbix API](/manual/api/reference/configuration). Поддерживаемые форматы экспорта: 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 Export format in YAML: ``` {.yaml} zabbix_export: version: '6.0' date: '2023-05-03T11:24:04Z' groups: - uuid: dc579cd7a1a34222933f24f52a68bcd8 name: 'Linux servers' hosts: - host: Example_host name: Example_host templates: - name: 'Zabbix server health' groups: - name: 'Linux servers' items: - name: Test_item1 type: ZABBIX_ACTIVE key: kernel.maxproc inventory_mode: DISABLED ``` #### Формат экспорта Формат экспорта в YAML: ``` {.yaml} zabbix_export: version: '6.0' date: '2023-05-03T11:24:04Z' groups: - uuid: dc579cd7a1a34222933f24f52a68bcd8 name: 'Linux servers' hosts: - host: Example_host name: Example_host templates: - name: 'Zabbix server health' groups: - name: 'Linux servers' items: - name: Test_item1 type: ZABBIX_ACTIVE key: kernel.maxproc inventory_mode: DISABLED ``` #### Export format Export to YAML: ``` {.yaml} zabbix_export: version: '6.0' date: '2021-08-31T12:55:10Z' images: - name: Zabbix_server_3D_(128) imagetype: '1' encodedImage: iVBOR...5CYII= maps: - name: 'Local network' width: '680' height: '200' label_type: '0' label_location: '0' highlight: '1' expandproblem: '1' markelements: '1' show_unack: '0' severity_min: '0' show_suppressed: '0' grid_size: '50' grid_show: '1' grid_align: '1' label_format: '0' label_type_host: '2' label_type_hostgroup: '2' label_type_trigger: '2' label_type_map: '2' label_type_image: '2' label_string_host: '' label_string_hostgroup: '' label_string_trigger: '' label_string_map: '' label_string_image: '' expand_macros: '1' background: { } iconmap: { } urls: { } selements: - elementtype: '0' elements: - host: 'Zabbix server' label: | {HOST.NAME} {HOST.CONN} label_location: '0' x: '111' 'y': '61' elementsubtype: '0' areatype: '0' width: '200' height: '200' viewtype: '0' use_iconmap: '0' selementid: '1' icon_off: name: Zabbix_server_3D_(128) icon_on: { } icon_disabled: { } icon_maintenance: { } urls: { } evaltype: '0' shapes: - type: '0' x: '0' 'y': '0' width: '680' height: '15' text: '{MAP.NAME}' font: '9' font_size: '11' font_color: '000000' text_halign: '0' text_valign: '0' border_type: '0' border_width: '0' border_color: '000000' background_color: '' zindex: '0' lines: { } links: { } ``` #### Формат экспорта Экспорт в YAML: ``` {.yaml} zabbix_export: version: '6.0' date: '2021-08-31T12:55:10Z' images: - name: Zabbix_server_3D_(128) imagetype: '1' encodedImage: iVBOR...5CYII= maps: - name: 'Local network' width: '680' height: '200' label_type: '0' label_location: '0' highlight: '1' expandproblem: '1' markelements: '1' show_unack: '0' severity_min: '0' show_suppressed: '0' grid_size: '50' grid_show: '1' grid_align: '1' label_format: '0' label_type_host: '2' label_type_hostgroup: '2' label_type_trigger: '2' label_type_map: '2' label_type_image: '2' label_string_host: '' label_string_hostgroup: '' label_string_trigger: '' label_string_map: '' label_string_image: '' expand_macros: '1' background: { } iconmap: { } urls: { } selements: - elementtype: '0' elements: - host: 'Zabbix server' label: | {HOST.NAME} {HOST.CONN} label_location: '0' x: '111' 'y': '61' elementsubtype: '0' areatype: '0' width: '200' height: '200' viewtype: '0' use_iconmap: '0' selementid: '1' icon_off: name: Zabbix_server_3D_(128) icon_on: { } icon_disabled: { } icon_maintenance: { } urls: { } evaltype: '0' shapes: - type: '0' x: '0' 'y': '0' width: '680' height: '15' text: '{MAP.NAME}' font: '9' font_size: '11' font_color: '000000' text_halign: '0' text_valign: '0' border_type: '0' border_width: '0' border_color: '000000' background_color: '' zindex: '0' lines: { } links: { } ``` #### Export format Export to YAML: ```yaml zabbix_export: version: '6.0' date: '2021-08-31T13:34:17Z' media_types: - name: Pushover type: WEBHOOK parameters: - name: endpoint value: 'https://api.pushover.net/1/messages.json' - name: eventid value: '{EVENT.ID}' - name: event_nseverity value: '{EVENT.NSEVERITY}' - name: event_source value: '{EVENT.SOURCE}' - name: event_value value: '{EVENT.VALUE}' - name: expire value: '1200' - name: message value: '{ALERT.MESSAGE}' - name: priority_average value: '0' - name: priority_default value: '0' - name: priority_disaster value: '0' - name: priority_high value: '0' - name: priority_information value: '0' - name: priority_not_classified value: '0' - name: priority_warning value: '0' - name: retry value: '60' - name: title value: '{ALERT.SUBJECT}' - name: token value: '<PUSHOVER TOKEN HERE>' - name: triggerid value: '{TRIGGER.ID}' - name: url value: '{$ZABBIX.URL}' - name: url_title value: Zabbix - name: user value: '{ALERT.SENDTO}' max_sessions: '0' script: | try { var params = JSON.parse(value), request = new HttpRequest(), data, response, severities = [ {name: 'not_classified', color: '#97AAB3'}, {name: 'information', color: '#7499FF'}, {name: 'warning', color: '#FFC859'}, {name: 'average', color: '#FFA059'}, {name: 'high', color: '#E97659'}, {name: 'disaster', color: '#E45959'}, {name: 'resolved', color: '#009900'}, {name: 'default', color: '#000000'} ], priority; if (typeof params.HTTPProxy === 'string' && params.HTTPProxy.trim() !== '') { request.setProxy(params.HTTPProxy); } if ([0, 1, 2, 3].indexOf(parseInt(params.event_source)) === -1) { throw 'Incorrect "event_source" parameter given: "' + params.event_source + '".\nMust be 0-3.'; } if (params.event_value !== '0' && params.event_value !== '1' && (params.event_source === '0' || params.event_source === '3')) { throw 'Incorrect "event_value" parameter given: ' + params.event_value + '\nMust be 0 or 1.'; } if ([0, 1, 2, 3, 4, 5].indexOf(parseInt(params.event_nseverity)) === -1) { params.event_nseverity = '7'; } if (params.event_value === '0') { params.event_nseverity = '6'; } priority = params['priority_' + severities[params.event_nseverity].name] || params.priority_default; if (isNaN(priority) || priority < -2 || priority > 2) { throw '"priority" should be -2..2'; } if (params.event_source === '0' && isNaN(params.triggerid)) { throw 'field "triggerid" is not a number'; } if (isNaN(params.eventid)) { throw 'field "eventid" is not a number'; } if (typeof params.message !== 'string' || params.message.trim() === '') { throw 'field "message" cannot be empty'; } data = { token: params.token, user: params.user, title: params.title, message: params.message, url: (params.event_source === '0') ? params.url + '/tr_events.php?triggerid=' + params.triggerid + '&eventid=' + params.eventid : params.url, url_title: params.url_title, priority: priority }; if (priority == 2) { if (isNaN(params.retry) || params.retry < 30) { throw 'field "retry" should be a number with value of at least 30 if "priority" is set to 2'; } if (isNaN(params.expire) || params.expire > 10800) { throw 'field "expire" should be a number with value of at most 10800 if "priority" is set to 2'; } data.retry = params.retry; data.expire = params.expire; } data = JSON.stringify(data); Zabbix.log(4, '[ Pushover Webhook ] Sending request: ' + params.endpoint + '\n' + data); request.addHeader('Content-Type: application/json'); response = request.post(params.endpoint, data); Zabbix.log(4, '[ Pushover Webhook ] Received response with status code ' + request.getStatus() + '\n' + response); if (response !== null) { try { response = JSON.parse(response); } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Failed to parse response received from Pushover'); response = null; } } if (request.getStatus() != 200 || response === null || typeof response !== 'object' || response.status !== 1) { if (response !== null && typeof response === 'object' && typeof response.errors === 'object' && typeof response.errors[0] === 'string') { throw response.errors[0]; } else { throw 'Unknown error. Check debug log for more information.'; } } return 'OK'; } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Pushover notification failed: ' + error); throw 'Pushover notification failed: ' + error; } description: | Please refer to setup guide here: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover Set token parameter with to your Pushover application key. When assigning Pushover media to the Zabbix user - add user key into send to field. message_templates: - event_source: TRIGGERS operation_mode: PROBLEM subject: 'Problem: {EVENT.NAME}' message: | Problem started at {EVENT.TIME} on {EVENT.DATE} Problem name: {EVENT.NAME} Host: {HOST.NAME} Severity: {EVENT.SEVERITY} Operational data: {EVENT.OPDATA} Original problem ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: RECOVERY subject: 'Resolved in {EVENT.DURATION}: {EVENT.NAME}' message: | Problem has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE} Problem name: {EVENT.NAME} Problem duration: {EVENT.DURATION} Host: {HOST.NAME} Severity: {EVENT.SEVERITY} Original problem ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: UPDATE subject: 'Updated problem in {EVENT.AGE}: {EVENT.NAME}' message: | {USER.FULLNAME} {EVENT.UPDATE.ACTION} problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}. {EVENT.UPDATE.MESSAGE} Current problem status is {EVENT.STATUS}, age is {EVENT.AGE}, acknowledged: {EVENT.ACK.STATUS}. - event_source: DISCOVERY operation_mode: PROBLEM subject: 'Discovery: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}' message: | Discovery rule: {DISCOVERY.RULE.NAME} Device IP: {DISCOVERY.DEVICE.IPADDRESS} Device DNS: {DISCOVERY.DEVICE.DNS} Device status: {DISCOVERY.DEVICE.STATUS} Device uptime: {DISCOVERY.DEVICE.UPTIME} Device service name: {DISCOVERY.SERVICE.NAME} Device service port: {DISCOVERY.SERVICE.PORT} Device service status: {DISCOVERY.SERVICE.STATUS} Device service uptime: {DISCOVERY.SERVICE.UPTIME} - event_source: AUTOREGISTRATION operation_mode: PROBLEM subject: 'Autoregistration: {HOST.HOST}' message: | Host name: {HOST.HOST} Host IP: {HOST.IP} Agent port: {HOST.PORT} ``` #### Формат экспорта Экспорт в YAML: ```yaml zabbix_export: version: '6.0' date: '2021-08-31T13:34:17Z' media_types: - name: Pushover type: WEBHOOK parameters: - name: endpoint value: 'https://api.pushover.net/1/messages.json' - name: eventid value: '{EVENT.ID}' - name: event_nseverity value: '{EVENT.NSEVERITY}' - name: event_source value: '{EVENT.SOURCE}' - name: event_value value: '{EVENT.VALUE}' - name: expire value: '1200' - name: message value: '{ALERT.MESSAGE}' - name: priority_average value: '0' - name: priority_default value: '0' - name: priority_disaster value: '0' - name: priority_high value: '0' - name: priority_information value: '0' - name: priority_not_classified value: '0' - name: priority_warning value: '0' - name: retry value: '60' - name: title value: '{ALERT.SUBJECT}' - name: token value: '<PUSHOVER TOKEN HERE>' - name: triggerid value: '{TRIGGER.ID}' - name: url value: '{$ZABBIX.URL}' - name: url_title value: Zabbix - name: user value: '{ALERT.SENDTO}' max_sessions: '0' script: | try { var params = JSON.parse(value), request = new HttpRequest(), data, response, severities = [ {name: 'not_classified', color: '#97AAB3'}, {name: 'information', color: '#7499FF'}, {name: 'warning', color: '#FFC859'}, {name: 'average', color: '#FFA059'}, {name: 'high', color: '#E97659'}, {name: 'disaster', color: '#E45959'}, {name: 'resolved', color: '#009900'}, {name: 'default', color: '#000000'} ], priority; if (typeof params.HTTPProxy === 'string' && params.HTTPProxy.trim() !== '') { request.setProxy(params.HTTPProxy); } if ([0, 1, 2, 3].indexOf(parseInt(params.event_source)) === -1) { throw 'Incorrect "event_source" parameter given: "' + params.event_source + '".\nMust be 0-3.'; } if (params.event_value !== '0' && params.event_value !== '1' && (params.event_source === '0' || params.event_source === '3')) { throw 'Incorrect "event_value" parameter given: ' + params.event_value + '\nMust be 0 or 1.'; } if ([0, 1, 2, 3, 4, 5].indexOf(parseInt(params.event_nseverity)) === -1) { params.event_nseverity = '7'; } if (params.event_value === '0') { params.event_nseverity = '6'; } priority = params['priority_' + severities[params.event_nseverity].name] || params.priority_default; if (isNaN(priority) || priority < -2 || priority > 2) { throw '"priority" should be -2..2'; } if (params.event_source === '0' && isNaN(params.triggerid)) { throw 'field "triggerid" is not a number'; } if (isNaN(params.eventid)) { throw 'field "eventid" is not a number'; } if (typeof params.message !== 'string' || params.message.trim() === '') { throw 'field "message" cannot be empty'; } data = { token: params.token, user: params.user, title: params.title, message: params.message, url: (params.event_source === '0') ? params.url + '/tr_events.php?triggerid=' + params.triggerid + '&eventid=' + params.eventid : params.url, url_title: params.url_title, priority: priority }; if (priority == 2) { if (isNaN(params.retry) || params.retry < 30) { throw 'field "retry" should be a number with value of at least 30 if "priority" is set to 2'; } if (isNaN(params.expire) || params.expire > 10800) { throw 'field "expire" should be a number with value of at most 10800 if "priority" is set to 2'; } data.retry = params.retry; data.expire = params.expire; } data = JSON.stringify(data); Zabbix.log(4, '[ Pushover Webhook ] Sending request: ' + params.endpoint + '\n' + data); request.addHeader('Content-Type: application/json'); response = request.post(params.endpoint, data); Zabbix.log(4, '[ Pushover Webhook ] Received response with status code ' + request.getStatus() + '\n' + response); if (response !== null) { try { response = JSON.parse(response); } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Failed to parse response received from Pushover'); response = null; } } if (request.getStatus() != 200 || response === null || typeof response !== 'object' || response.status !== 1) { if (response !== null && typeof response === 'object' && typeof response.errors === 'object' && typeof response.errors[0] === 'string') { throw response.errors[0]; } else { throw 'Unknown error. Check debug log for more information.'; } } return 'OK'; } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Pushover notification failed: ' + error); throw 'Pushover notification failed: ' + error; } description: | Please refer to setup guide here: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover Set token parameter with to your Pushover application key. When assigning Pushover media to the Zabbix user - add user key into send to field. message_templates: - event_source: TRIGGERS operation_mode: PROBLEM subject: 'Problem: {EVENT.NAME}' message: | Problem started at {EVENT.TIME} on {EVENT.DATE} Problem name: {EVENT.NAME} Host: {HOST.NAME} Severity: {EVENT.SEVERITY} Operational data: {EVENT.OPDATA} Original problem ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: RECOVERY subject: 'Resolved in {EVENT.DURATION}: {EVENT.NAME}' message: | Problem has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE} Problem name: {EVENT.NAME} Problem duration: {EVENT.DURATION} Host: {HOST.NAME} Severity: {EVENT.SEVERITY} Original problem ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: UPDATE subject: 'Updated problem in {EVENT.AGE}: {EVENT.NAME}' message: | {USER.FULLNAME} {EVENT.UPDATE.ACTION} problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}. {EVENT.UPDATE.MESSAGE} Current problem status is {EVENT.STATUS}, age is {EVENT.AGE}, acknowledged: {EVENT.ACK.STATUS}. - event_source: DISCOVERY operation_mode: PROBLEM subject: 'Discovery: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}' message: | Discovery rule: {DISCOVERY.RULE.NAME} Device IP: {DISCOVERY.DEVICE.IPADDRESS} Device DNS: {DISCOVERY.DEVICE.DNS} Device status: {DISCOVERY.DEVICE.STATUS} Device uptime: {DISCOVERY.DEVICE.UPTIME} Device service name: {DISCOVERY.SERVICE.NAME} Device service port: {DISCOVERY.SERVICE.PORT} Device service status: {DISCOVERY.SERVICE.STATUS} Device service uptime: {DISCOVERY.SERVICE.UPTIME} - event_source: AUTOREGISTRATION operation_mode: PROBLEM subject: 'Autoregistration: {HOST.HOST}' message: | Host name: {HOST.HOST} Host IP: {HOST.IP} Agent port: {HOST.PORT} ``` ##### Export format ``` {.yaml} groups: - name: 'Zabbix servers' ``` ##### Формат экспорта ``` {.yaml} groups: - name: 'Zabbix servers' ``` #### Exporting a host Export the configuration of a host as an XML string. Request: ```json { "jsonrpc": "2.0", "method": "configuration.export", "params": { "options": { "hosts": [ "10161" ] }, "format": "xml" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>5.4</version><date>2020-03-13T15:31:45Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><hosts><host><host>Export host</host><name>Export host</name><groups><group><name>Zabbix servers</name></group></groups><interfaces><interface><interface_ref>if1</interface_ref></interface></interfaces><items><item><name>Item</name><key>item.key</key><delay>30s</delay><tags><tag><tag>Application</tag><value>CPU</value></tag></tags><valuemap><name>Host status</name></valuemap><interface_ref>if1</interface_ref><request_method>POST</request_method></item></items><valuemaps><valuemap><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></host></hosts></zabbix_export>\n", "id": 1 } ``` #### Экспорт хоста Экспортирует конфигурацию хоста в виде строки XML. Запрос: ```json { "jsonrpc": "2.0", "method": "configuration.export", "params": { "options": { "hosts": [ "10161" ] }, "format": "xml" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>5.4</version><date>2020-03-13T15:31:45Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><hosts><host><host>Export host</host><name>Export host</name><groups><group><name>Zabbix servers</name></group></groups><interfaces><interface><interface_ref>if1</interface_ref></interface></interfaces><items><item><name>Item</name><key>item.key</key><delay>30s</delay><tags><tag><tag>Application</tag><value>CPU</value></tag></tags><valuemap><name>Host status</name></valuemap><interface_ref>if1</interface_ref><request_method>POST</request_method></item></items><valuemaps><valuemap><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></host></hosts></zabbix_export>\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 #### Экспорт Чтобы экспортировать узел сети, сделайте следующее: - Перейдите к: *Настройка* → *Узлы сети (Configuration* → *Hosts)* - Отметьте флажками узлы сети для экспорта - Нажмите *Экспорт (Export)* ниже списка  В зависимости от выбранного формата узлы сети экспортируются в локальный файл с именем по умолчанию: - *zabbix\_export\_hosts.yaml* — при экспорте в YAML (опция по умолчанию для экспорта) - *zabbix\_export\_hosts.xml* — при экспорте в XML - *zabbix\_export\_hosts.json* — при экспорте в JSON #### 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 #### Экспорт Для экспорта способов оповещений сделайте следующее: - Перейдите к: *Администрирование* → *Способы оповещений (Administration* → *Media types)* - Отметьте способы оповещений, которые нужно экспортировать - Нажмите на *Экспорт (Export)* ниже списка  В зависимости от выбранного формата, способы оповещений экспортируются в локальный файл с именем по умолчанию: - *zabbix\_export\_mediatypes.yaml* — при экспорте в YAML (опция по умолчанию для экспорта) - *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 #### Экспорт Для экспорта карт сети сделайте следующее: - Перейдите к: *Мониторинг → Карты сети (Monitoring* → *Maps)* - Отметьте карты сети, которые нужно экспортировать - Нажмите на *Экспорт (Export)* ниже списка  В зависимости от выбранного формата, карты сети экспортируются в локальный файл с именем по умолчанию: - *zabbix\_export\_maps.yaml* — при экспорте в YAML (опция по умолчанию для экспорта) - *zabbix\_export\_maps.xml* — при экспорте в XML - *zabbix\_export\_maps.json* — при экспорте в JSON #### 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 #### Экспорт Для экспорта шаблонов выполните следующее: - Перейдите к: *Настройка* → *Шаблоны (Configuration* → *Templates)* - Отметьте шаблоны, которые нужно экспортировать - Нажмите на *Экспорт (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"]} ###### Запрос экспорта Запрос на выполнение функции экспорта (Export) интерфейса Exporter. | | | |---|---| |направление|агент → плагин| |ответ|нет| Параметры, специфичные для запросов экспорта: |Имя|Тип|Комментарии| |---------|--------|----------| |key|string|Ключ плагина.| |parameters|array of strings (опционально)|Параметры для функции Export.| *Пример:* {"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"} ###### Ответ экспорта Ответ из функции Export интерфейса Exporter. | | | |---|---| |направление|плагин → агент| |ответ|неприменимо| Параметры, специфичные для ответов экспорта: |Имя|Тип|Комментарии| |---------|--------|----------| |value|string (опционально) |Значение ответа из функции Export. Отсутствует, если возвращается ошибка.| |error|string (опционально) |Сообщение об ошибке, если функция Export не была выполнена успешно. Отсутствует, если возвращается значение (value).| *Примеры:* {"id":5,"type":7,"value":"response"} или {"id":5,"type":7,"error":"сообщение об ошибке"} #### 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): - `zabbix[boottime]` - `zabbix[hosts]` - `zabbix[items]` - `zabbix[items_unsupported]` - `zabbix[preprocessing_queue]` (только сервер) - `zabbix[process,<тип>,<режим>,<состояние>]` (статистика только на основе типов процессов) - `zabbix[rcache,<кэш>,<режим>]` - `zabbix[requiredperformance]` - `zabbix[triggers]` (только сервер) - `zabbix[uptime]` - `zabbix[vcache,buffer,<режим>]` (только сервер) - `zabbix[vcache,cache,<параметр>]` - `zabbix[version]` - `zabbix[vmware,buffer,<режим>]` - `zabbix[wcache,<кэш>,<режим>]` (тип кэша «trends» только сервер) ### 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). #### Expressions with unknown operands Generally an unknown operand (such as an unsupported item) in the expression will immediately render the trigger value to `Unknown`. However, in some cases unknown operands (unsupported items, function errors) are admitted into expression evaluation: - The `nodata()` function is evaluated regardless of whether the referenced item is supported or not. - Logical expressions with OR and AND can be evaluated to known values in two cases regardless of unknown operands: - **Case 1**: "`1 or some_function(unsupported_item1) or some_function(unsupported_item2) or ...`" can be evaluated to known result ('1' or "Problem"), - **Case 2**: "`0 and some_function(unsupported_item1) and some_function(unsupported_item2) and ...`" can be evaluated to known result ('0' or "OK").<br> Zabbix tries to evaluate such logical expressions by taking unsupported items as unknown operands. In the two cases above a known value will be produced ("Problem" or "OK", respectively); in **all other** cases the trigger will evaluate to `Unknown`. - If the function evaluation for a supported item results in error, the function value becomes `Unknown` and it takes part as unknown operand in further expression evaluation. Note that unknown operands may "disappear" only in logical expressions as described above. In arithmetic expressions unknown operands always lead to the result `Unknown` (except division by 0). ::: noteimportant An expression that results in `Unknown` does not change the trigger state ("Problem/OK"). So, if it was "Problem" (see Case 1), it stays in the same problem state even if the known part is resolved ('1' becomes '0'), because the expression is now evaluated to `Unknown` and that does not change the trigger state. ::: If a trigger expression with several unsupported items evaluates to `Unknown` the error message in the frontend refers to the last unsupported item evaluated. #### Выражения с неизвестными операндами В большинстве случаев, неизвестный операнд (такой как неподдерживаемый элемент данных) в выражении незамедлительно изменит значение триггера на `Неизвестно`. Однако, в некоторых случаях неизвестные операнды (неподдерживаемые элементы данных, ошибки функций) при вычисления выражений допустимы: - Функция `nodata()` вычисляется независимо от того, поддерживается элемент данных, на который она ссылается, или же не поддерживается. - Логические выражения с ИЛИ и И могут быть вычислены в известные значения независимо от неизвестных операндов в двух случаях: - **Случай 1**: "1 `or` некая\_функция(неподдерживаемый\_элемент\_данных1) `or` некая\_функция(неподдерживаемый\_элемент\_данных2) `or` ..." может быть вычислено с известным результатом («1» или "Проблема"), - **Случай 2**: "0 `and` некая\_функция(неподдерживаемый\_элемент\_данных1) `and` некая\_функция(неподдерживаемый\_элемент\_данных2) `and` ..." может быть вычислено с известным результатом («0» или "OK").<br> Zabbix пытается вычислить такие логические выражения, принимая неподдерживаемые элементы данных как неизвестные операнды. В двух случаях, упомянутых выше, будет производиться известное значение; в остальных случаях значением триггера будет `Неизвестно`. - Если вычисление функции по поддерживаемому элементу данных приведёт к ошибке, значением функции будет `Неизвестно` и оно будет частью дальнейшего вычисления выражения как неизвестный операнд. Обратите внимание на то, что неизвестные операнды могут «исчезать» только в логических выражениях, описанных выше. В арифметических выражениях неизвестные операнды всегда приводят к результату `Неизвестно` (за исключением деления на 0). ::: noteimportant Выражение, приводящее к `Неизвестно`, не меняет состояние триггера («Проблема/OK»). Таком образом, если он был в состоянии «Проблема» (смотрите Случай 1), то остаётся в том же проблемном состоянии, даже если известная часть разрешается («1» становится «0»), потому что выражение теперь вычисляется в `Неизвестно`, а это не меняет состояние триггера. ::: Если выражение триггера с несколькими неподдерживаемыми элементами данных вычисляется как `Неизвестное`, сообщение об ошибке в веб-интерфейсе ссылается на последний вычисленный неподдерживаемый элемент данных. ### ExpressMS messenger webhook API changed API version changed to v4 in ExpressMS messenger webhook. ### Смена версии API в вебхуке мессенджера ExpressMS В вебхуке мессенджера ExpressMS версия API изменена на v4. #### Extended logging The data gathered by VMware collector can be logged for detailed debugging using debug level 5. 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="vmware collector,N"`, where N is a process number). The following examples demonstrate how extended logging can be started provided debug level 4 is already set: # Increase log level of all vmware collectors: zabbix_server -R log_level_increase="vmware collector" # Increase log level of second vmware collector: zabbix_server -R log_level_increase="vmware collector,2" If extended logging of VMware collector data is not required it can be stopped using the `-R log_level_decrease` option. #### Расширенное журналирование Можно записывать в файл журнала сбор данных коллектором VMware, используя уровень отладки 5. Этот уровень можно задать в файлах конфигурации [сервера](/manual/appendix/config/zabbix_server) и [прокси](/manual/appendix/config/zabbix_proxy) или используя опцию выполнения административных функций (`-R log_level_increase="vmware collector,N"`, где N является номером процесса). При условии, что уровень отладки 4 уже задан, расширенное журналирование можно запустить так, как демонстрируется в следующих примерах: # Увеличение уровня журналирования по всем коллекторам vmware: zabbix_server -R log_level_increase="vmware collector" # Увеличение уровня журналирования по второму коллектору vmware: zabbix_server -R log_level_increase="vmware collector,2" Если расширенное журналирование данных коллекторов VMware не требуется, его можно остановить командой с опцией `-R log_level_decrease`. #### 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 страницы. Это особенно полезно, если некоторые шаги веб-сценария завершаются с ошибкой. Для этой цели служит уровень отладки 5 (трассировка). Этот уровень можно указать в файлах конфигурации [сервера](/manual/appendix/config/zabbix_server) и [прокси](/manual/appendix/config/zabbix_proxy) или использовать опции выполнения административных функций (`-R log_level_increase="http poller,N"`, где N является номером процесса). При условии, что уровень отладки 4 уже задан, расширенный мониторинг можно запустить так, как демонстрируется в следующих примерах: # Увеличение уровня журналирования по всем http поллерам: zabbix_server -R log_level_increase="http poller" # Увеличение уровня журналирования по второму http поллеру: zabbix_server -R log_level_increase="http poller,2" Если расширенный мониторинг не требуется, его можно остановить, используя опцию `-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 будет отправлять не более одного трапа с наивысшей важностью за заданный период времени. Для получения более подробных сведений обратитесь к [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 Элемент данных, возвращающий текст (символ,​ журнал или текстовый типы данных), не станет неподерживаемым в случае появления чего-либо в стандартном выводе ошибок. ::: Возвращаемое значение ограничено 16 МБ (включая конечные пробелы, которые усекаются); также применяются [ограничения базы данных](/manual/config/items/item#ограничения-текстовых-данных). В случае, если выполняемый скрипт не найден или 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. #### Извлечение совпадающей части регулярного выражения Иногда при нахождении совпадения с регулярным выражением мы можем хотеть извлекать из требуемого файла только интересующие значения вместо получения всей строки. Начиная с Zabbix 2.2.0, элементы данных файлов журналов имеют возможность извлекать из строк файла желаемые значения. Это достигается с помощью дополнительного параметра **вывод** у элементов данных `log` и `logrt`. Использование параметра «вывод» позволяет обозначить «подгруппу совпадения», в которой мы можем быть заинтересованы. Так, например log[/путь/к/файлу,"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 автоматически переключится на другую ноду, если активная нода остановится. Для автоматического переключения необходимо иметь по крайней мере одну ноду в состоянии резерва. Как быстро произойдет автоматическое переключение? Все ноды обновляют своё время последнего доступа (и состояния, если оно меняется) каждые 5 секунд. Таким образом: - Если активная нода выключается и успевает сообщить своё состояние как "остановлена", другая нода подхватит нагрузку в течение **5 секунд**. - Если активная нода выключается / становится недоступной без возможности обновить своё состояние, резервные ноды будут ожидать **задержку автоматического переключения** + 5 секунд перед тем как перенять нагрузку на себя. Задержка автоматического переключения настраивается, поддерживаемый диапазон от 10 секунд до 15 минут (по умолчанию одна минута). Чтобы изменить задержку автоматического переключения, вы можете выполнить: ``` 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. ##### Избранные пользовательские графики более не поддерживаются Более невозможно добавить пользовательские графики в избранное в *Мониторинг* -> *Узлы сети* -> *Графики*. После обновления, любые из существующих пользовательских графиков будут удалены из избранного. ##### Field order and formatting Zabbix follows the recommendations of [RFC 4514](http://tools.ietf.org/html/rfc4514), which specifies a "reverse" order for these fields, starting with the lowest-level fields (`CN`), proceeding to the mid-level fields (`OU`, `O`), and concluding with the highest-level fields (`DC`). ```ini TLSServerCertIssuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com TLSServerCertSubject=CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com ``` In contrast, OpenSSL by default displays the `Issuer` and `Subject` strings in top-level to low-level order. In the following example, `Issuer` and `Subject` fields start with the top-level (`DC`) and end with the low-level (`CN`) field. The formatting with spaces and field separators also varies based on the options used, and thus will not match the format required by Zabbix. ```bash $ openssl x509 -noout -in /home/zabbix/zabbix_proxy.crt -issuer -subject 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 proxy $ openssl x509 -noout -text -in /home/zabbix/zabbix_proxy.crt Certificate: ... 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 proxy ``` To format *Issuer* and *Subject* strings correctly for Zabbix, invoke OpenSSL with the following options: ```bash $ openssl x509 -noout -issuer -subject \ -nameopt esc_2253,esc_ctrl,utf8,dump_nostr,dump_unknown,dump_der,sep_comma_plus,dn_rev,sname\ -in /home/zabbix/zabbix_proxy.crt ``` The output will then be in reverse order, comma-separated, and usable in Zabbix configuration files and frontend: ```bash issuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com subject=CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com ``` ##### Очерёдность полей и форматирование Zabbix следует рекомендациям [RFC 4514 \[en\]](http://tools.ietf.org/html/rfc4514), который определяет «обратный» порядок для этих полей, начиная с полей самого низкого уровня (`CN`), переходя к полям среднего уровня (`OU`, `O`) и завершая полями самого высокого уровня (`DC`). ```ini TLSServerCertIssuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com TLSServerCertSubject=CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com ``` В отличие от этого, OpenSSL по умолчанию отображает строки `Issuer` и `Subject` в порядке от верхнего уровня к нижнему. В следующем примере поля `Issuer` и `Subject` начинаются с верхнего уровня (`DC`) и заканчиваются полем нижнего уровня (`CN`). Форматирование с пробелами и разделителями полей также различается в зависимости от используемых параметров и, таким образом, не будет соответствовать формату, требуемому Zabbix. ```bash $ openssl x509 -noout -in /home/zabbix/zabbix_proxy.crt -issuer -subject 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 proxy $ openssl x509 -noout -text -in /home/zabbix/zabbix_proxy.crt Certificate: ... 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 proxy ``` Для того чтобы правильно отформатировать для Zabbix строки *Issuer* и *Subject*, вызовите OpenSSL со следующими параметрами: ```bash $ openssl x509 -noout -issuer -subject \ -nameopt esc_2253,esc_ctrl,utf8,dump_nostr,dump_unknown,dump_der,sep_comma_plus,dn_rev,sname\ -in /home/zabbix/zabbix_proxy.crt ``` Тогда вывод будет в обратном порядке, разделён запятыми и может использоваться в файлах конфигурации и веб-интерфейсе Zabbix: ```bash issuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com subject=CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com ``` ##### 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#настройка) - Сообщения в [способах оповещения](/manual/config/notifications/media#общие-параметры) ##### File locations - Configuration files are located in **/etc/zabbix**. - Zabbix server, proxy and agent logfiles are located in **/var/log/zabbix**. - Zabbix frontend is located in **/usr/share/zabbix**. - Home directory for the user **zabbix** is **/var/lib/zabbix**. ##### Расположение файлов - Файлы конфигурации расположены в **/etc/zabbix**. - Файлы журналов (логи) Zabbix сервера, прокси и агента расположены в **/var/log/zabbix**. - Веб-интерфейс Zabbix расположен в **/usr/share/zabbix**. - Домашний каталог пользователя **zabbix** — папка **/var/lib/zabbix**. ## 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 (если не изменено во время компиляции). [ ]{#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). ##### Файловая система Из-за реализации файла с трапами, для Zabbix требуется файловая система с поддержкой inode для того чтобы различать файлы (эта информация берётся из вызова stat()). #### Filter A filter can be used to generate real items, triggers, and graphs only for entities that match the criteria. The **Filters** tab contains discovery rule filter definitions allowing to filter discovery values: {width="600"} |Parameter|Description| |--|--------| |*Type of calculation*|The following options for calculating filters are available:<br>**And** - all filters must be passed;<br>**Or** - enough if one filter is passed;<br>**And/Or** - uses *And* with different macro names and *Or* with the same macro name;<br>**Custom expression** - offers the possibility to define a custom calculation of filters. The formula must include all filters in the list. Limited to 255 symbols.| |*Filters*|The following filter condition operators are available: *matches*, *does not match*, *exists*, *does not exist*.<br>*Matches* and *does not match* operators expect a [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE). For instance, if you are only interested in C:, D:, and E: file systems, you could put {\#FSNAME} into "Macro" and "\^C\|\^D\|\^E" regular expression into "Regular expression" text fields. Filtering is also possible by file system types using {\#FSTYPE} macro (e.g. "\^ext\|\^reiserfs") and by drive types (supported only by Windows agent) using {\#FSDRIVETYPE} macro (e.g., "fixed").<br>You can enter a regular expression or reference a global [regular expression](/manual/regular_expressions) in "Regular expression" field.<br>In order to test a regular expression you can use "grep -E", for example: ````for f in ext2 nfs reiserfs smbfs; do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; done```` <br><br> {\#FSDRIVETYPE} macro on Windows is supported since Zabbix **3.0.0**.<br><br>*Exists* and *does not exist* operators allow to filter entities based on the presence or absence of the specified LLD macro in the response (supported since version 5.4.0).<br>Defining several filters is supported since Zabbix **2.4.0**.<br>Note that if a macro from the filter is missing in the response, the found entity will be ignored, unless a "does not exist" condition is specified for this macro.<br><br>A warning will be displayed, if the absence of a macro affects the expression result. For example, if {#B} is missing in:<br>{#A} matches 1 and {#B} matches 2 - will give a warning<br>{#A} matches 1 or {#B} matches 2 - no warning.<br>This flexible warning logic is supported since Zabbix 6.0.11.| ::: notewarning A mistake or a typo in the regular expression used in the LLD rule (for example, an incorrect "File systems for discovery" regular expression) may cause deletion of thousands of configuration elements, historical values, and events for many hosts. ::: ::: noteimportant Zabbix database in MySQL must be created as case-sensitive if file system names that differ only by case are to be discovered correctly. ::: #### Фильтр правила обнаружения Фильтры могут использоваться для того, чтобы генерировать реальные элементы данных, триггеры и графики только для объектов, соответствующих неким критериям. Вкладка **Фильтры (Filters)** содержит определения правил фильтрации обнаружения, позволяющих фильтровать обнаруженные значения: {width="600"} |Параметр|Описание| |--|--------| |*Тип вычисления*<br>*(Type of calculation)*|Доступны следующие опции расчёта фильтров:<br>**И (And)** — должны выполниться все фильтры;<br>**Или (Or)** — достаточно выполнения одного фильтра;<br>**И/Или (And/Or)** — используется *И* для разных имён макросов и *Или* для одинаковых имён макросов;<br>**Пользовательское выражение (Custom expression)** — появляется возможность указать пользовательское вычисление фильтров. Формула должна включать в себя все фильтры из списка. Ограничено 255 символами.| |*Фильтры*<br>*(Filters)*|Доступны следующие операторы условий фильтра: *совпадает*, *не соответствует*, *существует*, *не существует* (*matches*, *does not match*, *exists*, *does not exist*).<br>Операторы *совпадает* и *не соответствует* ожидают [Perl Compatible Regular Expression](https://ru.wikipedia.org/wiki/PCRE) (PCRE). Например, если вы заинтересованы только в файловых системах C:, D: и E:, вы можете поместить {\#FSNAME} в текстовое поле «Макрос», а регулярное выражение «\^C\|\^D\|\^E» — в поле «Регулярное выражение». Фильтрация также возможна по типам файловых систем, при использовании макроса {\#FSTYPE} (например, «\^ext\|\^reiserfs») и по типу диска (поддерживается только Windows агентами), используя макрос {\#FSDRIVETYPE} (например, «fixed»).<br>В поле «Регулярное выражение» вы можете ввести регулярное выражение или ссылку на глобальное [регулярное выражение](/manual/regular_expressions).<br>Для проверки регулярного выражения вы можете использовать «grep -E», например: ````for f in ext2 nfs reiserfs smbfs; do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; done```` <br><br>Макрос {\#FSDRIVETYPE} на Windows поддерживается, начиная с Zabbix **3.0.0**.<br><br>Операторы *существует* и *не существует* позволяют фильтровать объекты на основе присутствия или отсутствия указанных LLD макросов в ответе (поддерживается с версии 5.4.0).<br>Определение нескольких фильтров поддерживается, начиная с Zabbix **2.4.0**.<br>Обратите внимание, что если какой-то макрос из фильтра пропущен в ответе, найденный объект будет игнорироваться, если только для этого макроса не задано условие «не существует».<br><br>Если отсутствие макроса влияет на результат выражения, то будет отображено предупреждение. Например, если {#B} отсутствует в:<br>{#A} совпадает 1 и {#B} совпадает 2 — выдаст предупреждение<br>{#A} совпадает 1 или {#B} совпадает 2 — предупреждения не будет.<br>Эта гибкая логика предупреждений поддерживается с версии Zabbix 6.0.11.| ::: notewarning Ошибка или опечатка в регулярном выражении, которое используется в LLD правиле (например, некорректное регулярное выражение «File systems for discovery»), может привести к удалению тысяч элементов конфигурации, данных истории и событий на большом количестве узлов сети. ::: ::: noteimportant Если имена файловых систем различаются только по регистру, то для корректной работы обнаружения необходимо, чтобы база данных Zabbix в MySQL была создана чувствительной к регистру. ::: ##### 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 The filter expression is an 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).| #### Выражение фильтра Выражение фильтра является арифметическим выражением в инфиксной нотации. Поддерживаемые операнды: |Операнд|Описание|Пример| |--|------|------| |`"<текст>"`<br>`'<text>'`|Текстовая константа.|'value: \\'1\\''<br>"value: '1'"| |`<число>`|Числовая константа, поддерживая научное представление.|123| |`<jsonpath начиная с $>`|Значение, указанное в JSONPath, начиная с корневого узла входного документа; поддерживаются только определённые пути.|$.object.name| |`<jsonpath начиная с @>`|Значение, указанное в JSONPath, начиная с текущего объекта/элемента; поддерживаются только определённые пути.|@.name| Поддерживаемые операторы: |Оператор|Тип|Описание|Результат| |--|--------|----|----| |`-`|бинарный|Вычитание.|Число.| |`+`|бинарный|Сложение.|Число.| |`/`|бинарный|Деление.|Число.| |`*`|бинарный|Умножение.|Число.| |`==`|бинарный|Равно.|Логический (1 или 0).| |`!=`|бинарный|Не равно.|Логический (1 или 0).| |`<`|бинарный|Меньше чем.|Логический (1 или 0).| |`<=`|бинарный|Меньше чем или равно.|Логический (1 или 0).| |`>`|бинарный|Больше чем.|Логический (1 или 0).| |`>=`|бинарный|Больше чем или равно.|Логический (1 или 0).| |`=~`|бинарный|Соответствие регулярному выражению.|Логический (1 или 0).| |`!`|унарный|Логическое НЕ.|Логический (1 или 0).| |`||`|бинарный|Логическое ИЛИ.|Логический (1 или 0).| |`&&`|бинарный|Логическое И.|Логический (1 или 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. ##### Фильтрация по узлу сети В режиме *по узлу сети (by host)* результаты могут быть отфильтрованы по узлу сети или по группе узлов сети. При указании родительской группы узлов сети неявно выбираются все вложенные группы. ##### Filtering by trigger template In the *by trigger template* mode results can be filtered by one or several parameters listed below. |Parameter|Description| |--|--------| |*Template group*|Select all hosts with triggers from templates belonging to that group. Any host group that includes at least one template can be selected.| |*Template*|Select hosts with triggers from the chosen template and all nested templates. Only triggers inherited from the selected template will be displayed. If a nested template has additional own triggers, those triggers will not be displayed.| |*Template trigger*|Select hosts with chosen trigger. Other triggers of the selected hosts will not be displayed.| |*Host group*|Select hosts belonging to the group.| ##### Фильтрация по шаблону триггера В режиме *по шаблону триггера (by trigger template)* результаты могут быть отфильтрованы по одному или нескольким параметрам, перечисленным ниже. |Параметр|Описание| |--|--------| |*Группа шаблона*<br>*(Template group)*|Выбрать все узлы сети с триггерами из шаблонов, относящихся к этой групе. Может быть выбрана любая группа узлов сети, включающая хотя бы один шаблон.| |*Шаблон*<br>*(Template)*|Выбрать узлы сети с триггерами из выбранного шаблона и всех вложенных шаблонов. Будут отображаться только триггеры, унаследованные из выбранного шаблона. Если вложенный шаблон имеет свои дополнительные триггеры, эти триггеры отображаться не будут.| |*Шаблонный триггер*<br>*(Template trigger)*|Выбрать узлы сети с данным триггером. Остальные триггеры выбранных узлов сети отображаться не будут.| |*Группа узлов сети*<br>*(Host group)*|Выбрать узлы сети, относящиеся к данной группе.| #### Filtering VMware event log records This example uses the [Matches regular expression](/manual/config/items/preprocessing#configuration) preprocessing step to filter unnecessary events from the VMware event log. 1\. On a working VMware Hypervisor host, check that the event log item [vmware.eventlog](/manual/config/items/itemtypes/simple_checks/vmware_keys) is present and working properly. Note that the event log item could already be present on the hypervisor if a [VMware](/manual/vm_monitoring#ready-to-use-templates) template has been linked during the host creation. 2\. On the VMware Hypervisor host, create a [dependent item](/manual/config/items/itemtypes/dependent_items) of "Log" type and set the event log item as its master. 3\. In the *Preprocessing* tab of the dependent item, select the "Matches regular expression" preprocessing step and specify, for example, one of the following parameters: ```bash # Filters all log events: pattern: .* logged in .* # Filters lines containing usernames after "User": pattern: \bUser\s+\K\S+ ``` ::: noteimportant If the regular expression is not matched, then the dependent item becomes unsupported with a corresponding error message. To avoid this, mark the "Custom on fail" checkbox and select an option such as discarding the value or setting a custom one. Please note that [discarded](/manual/config/items/preprocessing#configuration) values are not stored in the database; as a result, triggers are not evaluated and trend data is not generated. ::: Alternatively, you may use the [Regular expression](/manual/config/items/preprocessing#configuration) preprocessing step to extract matching groups and control output. For example: ```bash # Extracts and outputs the entire log event containing "logged in": pattern: .*logged in.* output: \0 # Extracts and outputs usernames following "User": pattern: User (.*?)(?=\ ) output: \1 ``` #### Фильтрация записей журнала событий VMware В этом примере используется шаг предварительной обработки [Совпадение регулярному выражению](/manual/config/items/preprocessing#настройка) для фильтрации ненужных событий из журнала событий VMware. 1\. Убедитесь, что на работающем узле сети гипервизора VMware элемент данных журнала событий [vmware.eventlog](/manual/config/items/itemtypes/simple_checks/vmware_keys) присутствует и работает должным образом. Обратите внимание, что элемент данных журнала событий уже может присутствовать у гипервизора, если при создании узла сети был присоединён шаблон [VMware](/manual/vm_monitoring#готовые-к-использованию-шаблоны). 2\. На узле сети гипервизора VMware создайте [зависимый элемент данных](/manual/config/items/itemtypes/dependent_items) с типом «Журнал (лог)» и выберите элемент данных журнала событий в качестве основного элемента данных. 3\. На вкладке *Предобработка* зависимого элемента данных выберите шаг предобработки «Совпадение регулярному выражению» и укажите, например, один из следующих параметров: ```bash # Фильтрация всех событий входа в систему: pattern: .* logged in .* # Фильтрация строк, содержащих имена пользователей после «User»: pattern: \bUser\s+\K\S+ ``` ::: noteimportant Если нет соответствия регулярному выражению, то зависимый элемент данных станет неподдерживаемым с соответствующим сообщением об ошибке. Чтобы избежать этого, отметьте флажок «Другое при ошибке» и выберите опцию — например, отбросить значение либо выставить пользовательское значение. Обратите внимание, что [отброшенные](/manual/config/items/preprocessing#настройка) значения не сохраняются в базе данных; в результате триггеры не пересчитываются и данные о динамике изменений не генерируются. ::: В качестве альтернативы вы можете использовать шаг предварительной обработки [Регулярное выражение](/manual/config/items/preprocessing#настройка) для извлечения соответствующих групп и управления выводом. Например: ```bash # Извлечь и вывести из журнала событий полное событие, содержащащее строку «logged in»: pattern: .*logged in.* output: \0 # Извлечь и вывести имена пользователей после «User»: pattern: User (.*?)(?=\ ) output: \1 ``` #### 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-агента Найти элемент данных HTTP-агента с типом XML тела POST запроса для определенного идентификатора узла сети. Запрос: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "hostids": "10255", "filter": { "type": 19, "post_type": 3 } }, "id": 3, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Ответ: ```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-агента Найти прототип элемента данных HTTP-агента с методом запроса HEAD для определенного идентификатора узла сети. Запрос: ```json { "jsonrpc": "2.0", "method": "itemprototype.get", "params": { "hostids": "10254", "filter": { "type": "19", "request_method": "3" } }, "id": 17, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Ответ: ```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 } ``` #### Поиск зависимого элемента данных Найти один зависимый элемент данных для элемента данных с идентификатором "25545". Запрос: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "filter": { "type": "18", "master_itemid": "25545" }, "limit": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```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 } ``` #### Поиск зависимых элементов данных по ключу Получить все зависимые элементы данных для узла сети с идентификатором "10116", в ключе которых есть слово "apache". Запрос: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10116", "search": { "key_": "apache" }, "filter": { "type": 18 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Ответ: ```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" в ключе элемента данных, и отсортировать результаты по имени. Запрос: ```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 } ``` Ответ: ```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 } ``` #### Firewall By default, only the ports listed in the [configuration changes](#firewall_configuration) above are open. To open additional ports, modify "*/etc/sysconfig/iptables*" file and reload firewall rules: systemctl reload iptables #### Брандмауэр По умолчанию, для подключений открыты только адреса портов, перечисленные в [изменениях конфигурации](#конфигурация-брандмауэра) выше. Чтобы открыть дополнительные порты, отредактируйте файл "*/etc/sysconfig/iptables*" и перезагрузите правила брандмауэра: systemctl reload iptables ##### Firewall configuration The appliance uses iptables firewall with predefined rules: - Opened SSH port (22 TCP); - Opened Zabbix agent (10050 TCP) and Zabbix trapper (10051 TCP) ports; - Opened HTTP (80 TCP) and HTTPS (443 TCP) ports; - Opened SNMP trap port (162 UDP); - Opened outgoing connections to NTP port (53 UDP); - ICMP packets limited to 5 packets per second; - All other incoming connections are dropped. ##### Конфигурация брандмауэра Готовое решение использует брандмауэр iptables с предустановленными правилами: - Открыт порт SSH (22 TCP); - Открыты порты Zabbix агента (10050 TCP) и Zabbix траппера (10051 TCP); - Открыты порты HTTP (80 TCP) и HTTPS (443 TCP); - Открыт порт SNMP трапов (162 UDP) - Открыты исходящие подключения на порт NTP (53 UDP); - ICMP пакеты ограничены 5 пакетами в секунду; - Все остальные входящие подключения отбрасываются. ##### Fit functions Default `fit` is the *linear* function. But if your monitored system is more complicated you have more options to choose from. |`fit`|x = f(t)| |-----|--------| |*linear*|x = a + b\*t| |*polynomialN*^[2](#footnotes)^|x = a~0~ + a~1~\*t + a~2~\*t^2^ + ... + a~n~\*t^n^| |*exponential*|x = a\*exp(b\*t)| |*logarithmic*|x = a + b\*log(t)| |*power*|x = a\*t^b^| ##### Функции аппроксимации По умолчанию `аппроксимация` является линейной (*linear*) функцией. Но если наблюдаемая система более сложная, вы можете выбрать один из следующих вариантов. |`аппроксимация`|x = f(t)| |-----|--------| |линейная (*linear*)|x = a + b\*t| |полиномиальная (*polynomialN*)^[2](#примечания)^|x = a~0~ + a~1~\*t + a~2~\*t^2^ + ... + a~n~\*t^n^| |экспоненциальная (*exponential*)|x = a\*exp(b\*t)| |логарифмическая (*logarithmic*)|x = a + b\*log(t)| |степенная (*power*)|x = a\*t^b^| #### 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», то проверка не будет производиться вообще. Вне времени переменных интервалов будет использоваться интервал обновления по умолчанию. Обратите внимание что, если переменный интервал совпадает с длительностью периода, элемент данных будет опрошен ровно один раз. Если переменный интервал больше, чем период, элемент данных может быть опрошен один раз или может быть не проверен вовсе (поэтому такая настройка не рекомендуется). Если гибкий интервал меньше, чем период, элемент данных будет опрошен по крайней мере один раз. Если переменный интервал задан равным «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. ::: #### Гибкие пользовательские параметры Гибкие пользовательские параметры допускают в ключе параметры. В этом случае гибкие пользовательские параметры могут быть основой для создания нескольких элементов данных. Гибкие пользовательские параметры имеют следующий синтаксис: UserParameter=ключ[*],команда |Параметр|Описание| |--|--------| |**Ключ**|Уникальный ключ элемента данных. \[\*\] задаёт, что ключ может принимать параметры из скобок. Параметры указываются при настройке элемента данных.| |**Команда**|Команда, которая выполняется для получения значения ключа.<br>*Только для гибких пользовательских параметров*:<br>Вы можете использовать в команде позиционные ссылки $1…$9 для того, чтобы сослаться на соответствующий параметр в ключе элемента данных.<br>Zabbix разбирает параметры, заключенные в \[ \] ключа элемента данных, и заменяет $1,…,$9 в команде соответственно.<br>$0 будет заменена оригинальной командой (до раскрытия $0,…,$9) для выполнения.<br>Позиционные ссылки интерпретируются Zabbix агентом независимо от того, заключены ли они в двойные (") или в одинарные (') кавычки.<br>Для использования позиционных ссылок без изменения, укажите двойной символ доллара — например, awk '{print $$2}'. В этом случае `$$2` фактически превратится в `$2` при выполнении команды.| ::: noteimportant Позиционные ссылки, начинающиеся со знака $, ищутся и заменяются Zabbix агентом только в случае гибких пользовательских параметров. В случае простых пользовательских параметров такая обработка ссылок пропускается и, следовательно, экранирование любых знаков $ не требуется. ::: ::: 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) #### Переключение локалей в веб-интерфейсе Было замечено, что локали в веб-интерфейсе могут переключаться без какой-либо явной логики, то есть некоторые страницы (или части страниц) отображаются на одном языке, тогда как другие страницы (или части страниц) — на другом. Обычно такая проблема может возникнуть, когда имеется несколько пользователей, некоторые из которых используют одну локаль, в то время как другие используют другую локаль. Известный вариант решения такой проблемы — отключение многопоточности в PHP и Apache. Эта проблема связана с тем, как локали работают [в PHP](https://www.php.net/manual/en/function.setlocale): информация о локали сохраняется по каждому процессу, а не по потоку. Поэтому в многопоточной среде, где несколько проектов выполняются одним и тем же процессом Apache, имеется вероятность, что локаль меняется в другом потоке, что меняет способ обработки данных в потоке Zabbix. Для получения более подробной информации смотрите соответствующие отчёты о проблеме: - [ZBX-10911](https://support.zabbix.com/browse/ZBX-10911) (Проблема с переключением локалей в веб-интерфейсе) - [ZBX-16297](https://support.zabbix.com/browse/ZBX-16297) (Проблема с обработкой чисел в графиках с использованием функции `bcdiv` из функций BC Math) ### 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.| ### История дробных чисел Объект истории дробных чисел имеет следующие свойства. |Параметр|Тип(/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |clock|timestamp|Время, когда было получено значение.| |itemid|string|ID соответствующего элемента данных.| |ns|integer|Наносекунды, когда было получено значение.| |value|float|Полученное значение.| ##### 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 агент должен иметь права «только на чтение» на файловую систему */proc*. Патчи к ядру от www.grsecurity.org ограничивают права доступа непривилегированных пользователей. ^**2**^ `vfs.dev.read[]`, `vfs.dev.write[]`: Zabbix агент будет прерывать «протухшие» подключения к устройствам, если значения элементов данных не опрашиваются более 3 часов. Это может произойти, если система имеет устройства с динамически меняющимися путями или если устройство было удалено вручную. Обратите также внимание, что эти элементы данных при использовании интервала обновления от 3 часов и более всегда будут возвращать значение «0». ^**3**^ `vfs.dev.read[]`, `vfs.dev.write[]`: Если первым параметром используется параметр по умолчанию *all*, тогда ключ вернёт суммарную статистику, включая все блочные устройства, такие как sda, sdb и их разделы (sda1, sda2, sdb3…) и несколько устройств (MD raid) на основе этих блочных устройств/разделов и логические разделы (LVM) на основе этих блочных устройств/разделов. В этих случаях возвращаемые значения следует рассматривать как относительные значения (изменяемые во времени), но не как абсолютные значения. ^**4**^ SSL (HTTPS) поддерживается только, если агент скомпилирован с поддержкой cURL. В противном случае элемент данных станет неподдерживаемым. ##### 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") без использования нумерации из таблицы. Числовые значения диапазонов (соответствующие значениям 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**^ Для строковых значений экспортируется только строка (например, "ZABBIX\_ACTIVE") без использования нумерации из таблицы. Числовые значения диапазонов (соответствующие значениям 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**^ Для строковых значений экспортируется только строка (например, "ZABBIX\_ACTIVE") без использования нумерации из таблицы. Числовые диапазоны значений (соответствующие значениям 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**^ Если несколько макросов в поле или макросы вперемешку с текстом не поддерживаются для данного места, то один макрос должен заполнять целиком всё поле. ^**2**^ Макросы, которые используются в именах и значениях тегов, раскрываются только во время процесса генерации событий. ^**3**^ URL-ы, которые содержат [секретные макросы](/manual/config/macros/user_macros#настройка), работать не будут, поскольку макросы в них будут раскрыты как «\*\*\*\*\*\*». ##### 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**^ net.if.in, net.if.out and net.if.total items do not provide statistics of loopback interfaces (e.g. lo0). ^**2**^ These values for these items are not supported for loopback interfaces on Solaris systems up to and including Solaris 10 6/06 as byte, error and utilization statistics are not stored and/or reported by the kernel. However, if you're monitoring a Solaris system via net-snmp, values may be returned as net-snmp carries legacy code from the cmu-snmp dated as old as 1997 that, upon failing to read byte values from the interface statistics returns the packet counter (which does exist on loopback interfaces) multiplied by an arbitrary value of 308. This makes the assumption that the average length of a packet is 308 octets, which is a very rough estimation as the MTU limit on Solaris systems for loopback interfaces is 8892 bytes. These values should not be assumed to be correct or even closely accurate. They are guesstimates. The Zabbix agent does not do any guess work, but net-snmp will return a value for these fields. ^**3**^ The command line on Solaris, obtained from /proc/pid/psinfo, is limited to 80 bytes and contains the command line as it was when the process was started. ^**4**^ Not supported on Windows Event Log. ^**5**^ On Windows XP vfs.file.time\[file,[change]{.underline}\] may be equal to vfs.file.time\[file,[access]{.underline}\]. ^**6**^ Supported only by Zabbix agent 2; not supported by Zabbix agent. ^**7**^ Supported only by Zabbix agent 2 on 64-bit Windows; not supported by Zabbix agent. ##### Примечания ^**1**^ Элементы данных net.if.in, net.if.out и net.if.total не предоставляют статистику по loopback интерфейсам (например, lo0). ^**2**^ Значения перечисленных элементов данных не поддерживаются для loopback интерфейсов на Solaris вплоть до Solaris 10 6/06 включительно, поскольку статистика байт, утилизации и ошибок не хранится и/или не отдаётся ядром. Однако, если вы мониторите систему через net-snmp, значения можно получить благодаря старому коду net-snmp от cmu-snmp, датированному 1997 годом, после ошибки чтения значений байтов из статистики интерфейса возвращается счётчик пакетов (который существует на loopback интерфейсе), умноженный на произвольное значение 308. Это дает предположение, что средний размер пакета 308 октетов, которое является очень грубым приближением, поскольку ограничение MTU на системах Solaris для loopback интерфейсов составляет 8892 байта. Эти значения не должны рассматриваться, как корректные и даже близкие к точным. Они предположительные. Zabbix агент не пытается выполнить работу по отгадыванию, однако net-snmp возвращает значения этих полей. ^**3**^ Командная строка на Solaris, получаемая с /proc/pid/psinfo, ограничена 80 байтами и содержит командную строку, которая была на момент запуска процесса. ^**4**^ Не поддеживается для Windows Event Log. ^**5**^ На Windows XP vfs.file.time\[файл,[change]{.underline}\] может быть равным vfs.file.time\[файл,[access]{.underline}\]. ^**6**^ Поддерживается только Zabbix агентом 2; не поддерживается Zabbix агентом. ^**7**^ Поддерживается только Zabbix агентом 2 на 64-ных Windows; не поддерживается Zabbix агентом. ##### Footnotes ^**1**^ Note that too many data gathering processes (pollers, unreachable pollers, ODBC pollers, HTTP pollers, Java pollers, pingers, trappers, proxypollers) together with IPMI manager, SNMP trapper and preprocessing workers can **exhaust** the per-process file descriptor limit for the preprocessing manager. ::: notewarning This will cause Zabbix server to stop (usually shortly after the start, but sometimes it can take more time). The configuration file should be revised or the limit should be raised to avoid this situation. ::: ^**2**^ When a lot of items are deleted it increases the load to the database, because the housekeeper will need to remove all the history data that these items had. For example, if we only have to remove 1 item prototype from the template, but this template is linked to 50 hosts and for every host the prototype is expanded to 100 real items, 5000 items in total have to be removed (1\*50\*100). If 500 is set for MaxHousekeeperDelete (MaxHousekeeperDelete=500), the housekeeper process will have to remove up to 2500000 values (5000\*500) for the deleted items from history and trends tables in one cycle. ##### Примечания ^**1**^ Обратите внимание, что слишком большое количество процессов сбора данных (поллеров, поллеров недоступных устройств, поллеров ODBC, поллеров HTTP, поллеров Java, пингеров, трапперов, поллеров прокси) вместе с IPMI менеджером, SNMP траппером и рабочими процессами предварительной обработки, могут **исчерпать** ограничение количества файловых дескрипторов на один процесс для менеджера предварительной обработки. ::: notewarning Это заставит Zabbix сервер остановиться (обычно вскоре после запуска, но иногда может занять более длительное время). Чтобы избежать подобной ситуации, необходимо пересмотреть файл конфигурации или увеличить лимит. ::: ^**2**^ При удалении большого количества элементов данных возрастает нагрузка на базу данных, поскольку процессу очистки базы данных (housekeeper) потребуется удалить все данные истории, относящиеся к этим элементам данных. Для примера, если нам нужно удалить всего 1 прототип элемента данных из шаблона, но этот шаблон связан с 50 узлами сети и на каждом из них на основе этого прототипа сгенерировано по 100 реальных элементов данных, то потребуется удалить суммарно 5000 элементов данных (1\*50\*100). Если для параметра MaxHousekeeperDelete задано значение 500 (MaxHousekeeperDelete=500), то для удаляемых элементов данных процесс housekeeper должен будет за один цикл удалять из таблиц истории и динамики изменений до 2500000 значений (5000\*500). ##### Footnotes ^**1**^ See [Creating custom performance counter names for VMware](/manual/appendix/items/perf_counters). ^**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 ##### Примечания ^**1**^ Смотрите [Создание пользовательских имен счётчиков производительности для VMware](/manual/appendix/items/perf_counters). ^**2**^ Значения по этим элементам данных извлекаются из счётчиков производительности VMware и [параметр](/manual/appendix/config/zabbix_server) VMwarePerfFrequency используется для обновления данных по этим элементам данных в Zabbix VMware кэше: - 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**^ - 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**^ - Начиная с версии 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. If an agent interface is not defined, the main SNMP interface will be used. If an SNMP interface is also not defined, the main JMX interface will be used. If a JMX interface is not defined 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.2.2, `{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 узла сети в этом порядке приоритетов либо в «UNKNOWN» при отсутствии у узла сети каких-либо интерфейсов. ^**2**^ В глобальных скриптах, полях IP/DNS интерфейса и веб-сценариях макрос будет раскрываться в основной интерфейс агента. Если интерфейс агента не определён, будет использоваться основной интерфейс SNMP. Если SNMP интерфейс также не определён, будет использоваться основной интерфейс JMX. Если же и JMX интерфейс не определён, будет использоваться основной интерфейс IPMI. Если у узла сети вообще нет никаких интерфейсов, макрос будет раскрыт в значение «UNKNOWN». ^**3**^ В подписях к элементам карты в этом макросе поддерживаются только функции **avg**, **last**, **max** и **min**, с секундами в качестве параметра. ^**4**^ Макросы `{HOST.*}` поддерживаются в полях веб-сценариев *Переменные*, *Заголовки*, *Файл SSL сертификата* и *Файл SSL ключа* и в полях шагов сценария *URL*, *Post*, *Заголовки* и *Требуемая строка*. Начиная с версии 5.2.2, макросы `{HOST.*}` более не поддерживаются в полях веб-сценария *Имя* и шага сценария *Имя*. ^**5**^ В именах графиков внутри этого макроса поддерживаются только функции **avg**, **last**, **max** и **min**, с секундами в качестве параметра. Макрос {HOST.HOST<1-9>} может использоваться в качестве узла сети внутри макроса. Например: last(/Cisco switch/ifAlias[{#SNMPINDEX}]) last(/{HOST.HOST}/ifAlias[{#SNMPINDEX}]) ^**6**^ Поддерживается с версии 5.2.5. ##### Forecasting horizon (**forecast** only)<br> Parameter `time` specifies how far in the future Zabbix should extrapolate dependencies it finds in historic data. No matter if you use `time_shift` or not, `time` is always counted starting from the current moment. ##### Горизонт предсказания (Только **forecast**)<br> Параметр `время` определяет, насколько далеко в будущее Zabbix будет экстраполировать зависимости, которые ему удастся найти в исторических данных. Независимо от того, используете ли вы `сдвиг_времени` или нет, `время` всегда отсчитывается от текущего момента. #### Format-specific notes #### Заметки о специфических форматах #### Form buttons Buttons at the bottom of the form allow to perform several operations. | | | |--|--------| ||Add a discovery rule. This button is only available for new discovery rules.| ||Update the properties of a discovery rule. This button is only available for existing discovery rules.| ||Create another discovery rule based on the properties of the current discovery rule.| ||Perform discovery based on the discovery rule immediately. The discovery rule must already exist. See [more details](/manual/config/items/check_now).<br>*Note* that when performing discovery immediately, configuration cache is not updated, thus the result will not reflect very recent changes to discovery rule configuration.| ||Test the discovery rule configuration. Use this button to verify the configuration settings (such as connectivity and parameter correctness) without permanently applying any changes.| ||Delete the discovery rule.| ||Cancel the editing of discovery rule properties.| #### Кнопки диалога Кнопки в нижней части диалога позволяют выполнить несколько видов операций. | | | |--|--------| | (Добавить)|Добавление правила обнаружения. Эта кнопка доступна только для новых правил обнаружения.| | (Обновить)|Обновление свойств правила обнаружения. Эта кнопка доступна только для уже существующих правил обнаружения.| | (Клонировать)|Создание другого правила обнаружения на основе свойств текущего правила обнанужения.| | (Выполнить сейчас)|Выполнение немедленного обнаружения на основе правила обнаружения. Правило обнаружения должно существовать. Смотрите [более подробную](/manual/config/items/check_now) информацию.<br>*Обратите внимание*, что когда обнаружение выполняется немедленно, кэш конфигурации не обновляется, поэтому на результат не повлияют совсем недавние изменения настроек правила обнаружения.| | (Тест)|Протестировать настройки правила обнаружения. Используйте эту кнопку для проверки настроек конфигурации (таких как подключение и корректность параметров) без постоянного применения каких-либо изменений.| | (Удалить)|Удаление правила обнаружения| | (Отмена)|Отмена изменения свойств правила обнаружения.| #### 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.| ##### Кнопки диалога Кнопки в нижней части диалога позволяют выполнить несколько видов операций. | | | |--|--------| | (Добавить)|Добавление отчёта. Эта кнопка доступна только для новых отчётов.| | (Обновить)|Обновление свойств отчёта.| | (Клонировать)|Создание другого отчёта на основе свойств текущего отчёта.| | (Тест)|Проверка корректности настройки отчёта путём отправки отчёта текущему пользователю.| | (Удалить)|Удаление отчёта.| | (Отмена)|Отмена изменения свойств отчёта.| #### 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, смотрите в таблице. |Поддерживаемое значение|Описание|Источник в структуре kinfo\_proc|Пытается быть совместимым с| |--|------|--|--| |vsize|Размер виртуальной памяти|kp\_eproc.e\_vm.vm\_map.size или ki\_size|ps -o vsz| |pmem|Процент физической памяти|вычисляется из rss|ps -o pmem| |rss|Размер резидентного набора|kp\_eproc.e\_vm.vm\_rssize или ki\_rssize|ps -o rss| |size ^[1](proc_mem_notes#примечания)^|Размер процесса (код + данные + стек)|tsize + dsize + ssize| | |tsize|Размер текста (кода)|kp\_eproc.e\_vm.vm\_tsize или ki\_tsize|ps -o tsiz| |dsize|Размер данных|kp\_eproc.e\_vm.vm\_dsize или ki\_dsize|ps -o dsiz| |ssize|Размер стека|kp\_eproc.e\_vm.vm\_ssize или ki\_ssize|ps -o ssiz| ## Frontend ## Веб-интерфейс ## Frontend ## Веб-интерфейс ## Frontend ## Веб-интерфейс ## Frontend ## Веб-интерфейс ## Frontend ## Веб-интерфейс ## Frontend ## Веб-интерфейс #### Frontend access By default, access to the frontend is allowed from anywhere. The frontend can be accessed at *http://<host>*. This can be customized in **/etc/nginx/conf.d/zabbix.conf**. Nginx has to be restarted after modifying this file. To do so, log in using SSH as **root** user and execute: systemctl restart nginx #### Доступ к веб-интерфейсу По умолчанию доступ к веб-интерфейсу разрешён отовсюду. До веб-интерфейса можно добраться по ссылке *http://<host>*. Этот параметр может быть изменён в **/etc/nginx/conf.d/zabbix.conf**. После внесения изменений в данный файл необходимо перезапустить nginx . Чтобы это сделать, авторизуйтесь как пользователь **root**, используя SSH, и выполните: systemctl restart nginx ##### Frontend configuration A Zabbix proxy does not have a frontend; it communicates with Zabbix server only. ##### Настройка веб-интерфейса Zabbix прокси не имеет веб-интерфейса; прокси обменивается информацией только с Zabbix сервером. ##### Frontend configuration A Zabbix proxy does not have a frontend; it communicates with Zabbix server only. ##### Настройка веб-интерфейса Zabbix прокси не имеет веб-интерфейса; прокси обменивается информацией только с Zabbix сервером. ##### Frontend configuration A Zabbix proxy does not have a frontend; it communicates with Zabbix server only. ##### Настройка веб-интерфейса Zabbix прокси не имеет веб-интерфейса; прокси обменивается информацией только с Zabbix сервером. **Frontend configuration** Create an action in the frontend, using some hard-to-guess secret code to disallow unwanted hosts: - Name: Autoregistration action Linux - Conditions: - Type of calculation: AND - Condition (A): Host metadata contains //Linux// - Condition (B): Host metadata contains //21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae// - Operations: - Send message to users: Admin via all media - Add to host groups: Linux servers - Link to templates: Linux Please note that this method alone does not provide strong protection because data is transmitted in plain text. Configuration cache reload is required for changes to have an immediate effect. **Настройка в веб-интерфейсе** Создайте действие в веб-интерфейсе, используя некоторый трудно-угадываемый секретный код для запрета нежелательных узлов сети: - Имя: Действие авторегистрации Linux - Условия: - Тип вычисления: И - Условие (А): Метаданные узлов сети содержат //Linux// - Условие (В): Метаданные узлов сети содержат //21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae// - Операции: - Отправить сообщение пользователям: Admin через все способы оповещения - Добавить в группы узлов сети: Linux сервера - Присоединить к шаблонам: Linux Пожалуйста, примите во внимание, что использование только этого метода не сможет обеспечить надёжную защиту, потому что данные передаются как простой текст. Чтобы изменения возымели немедленный эффект, необходимо обновление кэша конфигурации. #### Frontend configuration Loadable modules are supported by Zabbix agent, server and proxy. Therefore, item type in Zabbix frontend depends on where the module is loaded. If the module is loaded into the agent, then the item type should be "Zabbix agent" or "Zabbix agent (active)". If the module is loaded into server or proxy, then the item type should be "Simple check". History export through Zabbix modules does not need any frontend configuration. If the module is successfully loaded by server and provides **zbx\_module\_history\_write\_cbs()** function which returns at least one non-NULL callback function then history export will be enabled automatically. #### Настройка веб-интерфейса Подгружаемые модули поддерживаются Zabbix агентом, сервером и прокси. Следовательно, тип элемента данных в веб-интерфейсе Zabbix зависит от того, где этот модуль загружен. Если модуль загружен на стороне агента, тогда тип элемента данных должен быть «Zabbix агент» или «Zabbix агент (активный)». Если модуль загружен на стороне сервера или прокси, тогда тип элемента данных должен быть «Простая проверка». Экспорт истории через модули Zabbix не требует какой-либо настройки через веб-интерфейс. Если модуль успешно загружен сервером и предоставляет функцию **zbx\_module\_history\_write\_cbs()**, которая возвращает по крайней мере одну не-NULL функцию обратного вызова, то экспорт истории будет включён автоматически. **Frontend configuration** The first thing to do is to configure the frontend. Create 2 actions. The first action: - Name: Linux host autoregistration - Conditions: Host metadata contains *Linux* - Operations: Link to templates: Linux ::: noteclassic You can skip an "Add host" operation in this case. Linking to a template requires adding a host first so the server will do that automatically. ::: The second action: - Name: Windows host autoregistration - Conditions: Host metadata contains *Windows* - Operations: Link to templates: Windows **Настройка в веб-интерфейсе** Первое, что надо сделать, — это настроить веб-интерфейс. Создайте 2 действия. Первое действие: - Имя: Авторегистрация узлов сети Linux - Условия: Метаданные узлов сети содержит *Linux* - Операции: Присоединить к шаблонам: Linux ::: noteclassic В данном случае можно опустить операцию «Добавить узел сети». Присоединение к шаблону требует, чтобы узел сети уже был добавлен, поэтому сервер сделает это автоматически. ::: Второе действие: - Имя: Авторегистрация узлов сети Windows - Условия: Метаданные узлов сети содержит *Windows* - Операции: Присоединить к шаблонам: Windows **Frontend configuration** Update the action in the frontend: - Name: Autoregistration action Linux - Conditions: - Type of calculation: AND - Condition (A): Host metadata contains Linux - Condition (B): Host metadata contains 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae - Operations: - Send message to users: Admin via all media - Add to host groups: Linux servers - Link to templates: Linux - Link to templates: MySQL by Zabbix Agent **Настройка в веб-интерфейсе** В веб-интерфейсе обновите действие: - Имя: Действие авторегистрации Linux - Условия: - Тип вычисления: И - Условие (А): Метаданные узлов сети содержат Linux - Условие (В): Метаданные узлов сети содержат 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae - Операции: - Отправить сообщение пользователям: Admin через все способы оповещения - Добавить в группы узлов сети: Linux сервера - Присоединить к шаблонам: Linux - Присоединить к шаблонам: MySQL by Zabbix Agent ##### 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 Можно использовать файл конфигурации веб-интерфейса Zabbix (*zabbix.conf.php*), чтобы настроить SSO с аутентификацией Kerberos и ADFS: ```php $SSO['SETTINGS'] = [ 'security' => [ 'requestedAuthnContext' => [ 'urn:oasis:names:tc:SAML:2.0:ac:classes:Kerberos', ], 'requestedAuthnContextComparison' => 'exact' ] ]; ``` В этом случае, в настройках SAML в поле *ID объекта SP (SP name ID)* задайте: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified ### Frontend languages Catalan and Romanian languages are now enabled in the frontend. ### Языки веб-интерфейса В веб-интерфейсе теперь разрешены каталонский и румынский языки. #### Frontend languages Dutch, Georgian, and Spanish languages are now enabled in the frontend. #### Языки веб-интерфейса В веб-интерфейсе теперь разрешены голландский, грузинский и испанский языки. ### Frontend languages German and Vietnamese languages are now enabled in the frontend. ### Языки веб-интерфейса В веб-интерфейсе теперь включены Немецкий и Вьетнамский языки. ### 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). ### Веб-интерфейс ##### Разное - Теперь отображаются предупреждения о неправильной конфигурации очистки для TimescaleDB, если таблицы истории или динамики изменений содержат сжатые фрагменты (compressed chunks), но при этом опции *Переопределить период хранения истории элементов данных* или *Переопределить период хранения динамики изменения элементов данных* отключены. Для более подробной информации, обратитесь к разделу [Настройка TimescaleDB](/manual/appendix/install/timescaledb#настройка). ##### Frontend The minimum supported screen width for Zabbix frontend is 1200px. If stated as mandatory, the required software/library is strictly necessary. Optional ones are needed for supporting some specific function. |Software|Mandatory status|Version|Comments| |--|-|-|------| |*Apache*|One of|2.4 or later| | |*Nginx*|^|1.20 or later| | |*PHP*|Yes|7.2.5 or later, 8.0-8.3|PHP 7.4 or later is recommended. If you are using SAML authentication, PHP 7.3 or later is required (see *SAML PHP Toolkit* library below).<br><br>Added support for PHP versions:<br>- 8.0 and 8.1 since Zabbix 6.0.6;<br>- 8.2 since Zabbix 6.0.14;<br>- 8.3 since Zabbix 6.0.26.| |PHP extensions:|<|<|<| |*gd*|Yes|2.0.28 or later|PHP GD extension must support PNG images (*--with-png-dir*), JPEG (*--with-jpeg-dir*) images and FreeType 2 (*--with-freetype-dir*).<br>Version 2.3.0 or later might be required to avoid possible [text overlapping in graphs](/manual/installation/known_issues#text-overlapping) for some frontend languages.| |*bcmath*|^| |php-bcmath (*--enable-bcmath*)| |*ctype*|^| |php-ctype (*--enable-ctype*)| |*libXML*|^|2.6.15 or later|php-xml, if provided as a separate package by the distributor.| |*xmlreader*|^| |php-xmlreader, if provided as a separate package by the distributor.| |*xmlwriter*|^| |php-xmlwriter, if provided as a separate package by the distributor.| |*session*|^| |php-session, if provided as a separate package by the distributor.| |*sockets*|^| |php-net-socket (*--enable-sockets*). Required for user script support.| |*mbstring*|^| |php-mbstring (*--enable-mbstring*)| |*gettext*|^| |php-gettext (*--with-gettext*). Required for translations to work.| |*ldap*|No| |php-ldap. Required only if LDAP authentication is used in the frontend.| |*openssl*|^| |php-openssl. Required only if SAML authentication is used in the frontend.| |*mysqli*|^| |Required if MySQL is used as Zabbix backend database.| |*oci8*|^| |Required if Oracle is used as Zabbix backend database.| |*pgsql*|^| |Required if PostgreSQL is used as Zabbix backend database.| Third-party frontend libraries that are supplied with Zabbix: |Library|Mandatory status|Supplied version|Comments| |--|-|-|------| |[jQuery JavaScript Library](https://jquery.com/)|Yes|3.6.0|JavaScript library that simplifies the process of cross-browser development.| |[jQuery UI](https://jqueryui.com/)|^|1.12.1|A set of user interface interactions, effects, widgets, and themes built on top of jQuery.| |[SAML PHP Toolkit](https://github.com/SAML-Toolkits/php-saml)|^|4.3.1|A PHP toolkit that adds SAML 2.0 authentication support to be able to sign in to Zabbix.<br><br>Supplied version history:<br>- 3.4.1 since Zabbix 6.0.0;<br>- 4.0.0 since Zabbix 6.0.5 (toolkit requires PHP 7.3 or later);<br>- 4.3.1 since Zabbix 6.0.45 (recommended; toolkit requires PHP 7.3 or later).| |[Symfony Yaml Component](https://symfony.com/doc/current/components/yaml.html)|^|5.1.0|Adds support to export and import Zabbix configuration elements in the YAML format.| ::: noteclassic Zabbix may work on previous versions of Apache, MySQL, Oracle, and PostgreSQL as well. ::: ::: noteimportant For other fonts than the default DejaVu, PHP function [imagerotate](http://php.net/manual/en/function.imagerotate.php) might be required. If it is missing, these fonts might be rendered incorrectly when a graph is displayed. This function is only available if PHP is compiled with bundled GD, which is not the case in Debian and other distributions. ::: Third-party libraries used for writing and debugging Zabbix frontend code: |Library|Mandatory status|Minimum version|Description| |--|-|-|------| |[Composer](https://getcomposer.org/)|No|2.4.1|An application-level package manager for PHP that provides a standard format for managing dependencies of PHP software and required libraries.| |[PHPUnit](https://phpunit.de/)|^|8.5.29|A PHP unit testing framework for testing Zabbix frontend.| |[SASS](https://sass-lang.com/)|^|3.4.22|A preprocessor scripting language that is interpreted and compiled into Cascading Style Sheets (CSS).| ##### Веб-интерфейс Минимально поддерживаемая ширина экрана для Zabbix — 1200px. Если отмечено как обязательное, требуемое приложение/библиотека строго необходимы. Необязательные требуются для поддержки некоторых отдельных функций. |Приложение|Признак обязательности|Версия|Комментарии| |--|-|-|------| |*Apache*|Один из|2.4 или новее| | |*Nginx*|^|1.20 или новее| | |*PHP*|Да|7.2.5 или новее, 8.0-8.3|Рекомендуется использовать PHP 7.4 или новее. При использовании SAML аутентификации обязательно требуется PHP 7.3 или новее (смотрите ниже *SAML PHP Toolkit*).<br>Добавлена поддержка версий PHP:<br>- 8.0 и 8.1 с Zabbix 6.0.6;<br>- 8.2 с Zabbix 6.0.14;<br>- 8.3 с Zabbix 6.0.26.| |Расширения PHP:|<|<|<| |*gd*|Да|2.0.28 или новее|Расширение PHP GD должно поддерживать изображения PNG (*--with-png-dir*), JPEG (*--with-jpeg-dir*) и FreeType 2 (*--with-freetype-dir*).<br>Во избежание возможного [наложения текста в графиках](/manual/installation/known_issues#наложение-текста) для некоторых языков веб-интерфейса, может потребоваться версия 2.3.0 или новее.| |*bcmath*|^| |php-bcmath (*--enable-bcmath*)| |*ctype*|^| |php-ctype (*--enable-ctype*)| |*libXML*|^|2.6.15 или новее|php-xml, если поставляется как отдельный пакет от поставщика.| |*xmlreader*|^| |php-xmlreader, если поставляется как отдельный пакет от поставщика.| |*xmlwriter*|^| |php-xmlwriter, если поставляется как отдельный пакет от поставщика.| |*session*|^| |php-session, если поставляется как отдельный пакет от поставщика.| |*sockets*|^| |php-net-socket (*--enable-sockets*). Требуется для поддержки пользовательских скриптов.| |*mbstring*|^| |php-mbstring (*--enable-mbstring*)| |*gettext*|^| |php-gettext (*--with-gettext*). Требуется для работы переводов.| |*ldap*|Нет| |php-ldap. Требуется только, если в веб-интерфейсе используется LDAP аутентификация.| |*openssl*|^| |php-openssl. Требуется только, если в веб-интерфейсе используется SAML аутентификация.| |*mysqli*|^| |Требуется, если MySQL используется в качестве базы данных Zabbix.| |*oci8*|^| |Требуется, если Oracle используется в качестве базы данных Zabbix.| |*pgsql*|^| |Требуется, если PostgreSQL используется в качестве базы данных Zabbix.| Сторонние библиотеки веб-интерфейса, поставляемые с Zabbix: |Библиотеки|Признак обязательности|Поставляемая версия|Комментарии| |--|-|-|------| |[библиотека jQuery JavaScript](https://jquery.com/)|Да|3.6.0|Библиотека JavaScript, которая упрощает процесс кроссбраузерной разработки.| |[jQuery UI](https://jqueryui.com/)|^|1.12.1|Набор интерфейсных взаимодействий пользователя, эффектов, виджетов и тем, созданных на основе jQuery.| |[SAML PHP Toolkit](https://github.com/SAML-Toolkits/php-saml)|^|4.3.1|Набор инструментов PHP, который добавляет поддержку аутентификации SAML 2.0 для входа в Zabbix.<br><br>История поставляемых версий:<br>- 3.4.1 с версии Zabbix 6.0.0;<br>- 4.0.0 с версии Zabbix 6.0.5 (набор инструментов требует PHP 7.3 или новее);<br>- 4.3.1 с версии Zabbix 6.0.45 (рекомендуется; набор инструментов требует PHP 7.3 или новее).| |[Symfony Yaml компонент](https://symfony.com/doc/current/components/yaml.html)|^|5.1.0|Добавление поддержки экспорта и импорта элементов конфигурации Zabbix в формате YAML.| ::: noteclassic Zabbix может работать также и с предыдущими версиями Apache, MySQL, Oracle и PostgreSQL. ::: ::: noteimportant Для шрифтов помимо используемого по умолчанию DejaVu, может потребоваться функция PHP [imagerotate](http://php.net/manual/en/function.imagerotate.php). Если функция отсутствует, при отображении графиков шрифты могут отрисовываться некорректно. Эта функция доступна только если PHP скомпилирован вместе с GD, что не относится к Debian и некоторым другим дистрибутивам. ::: Сторонние библиотеки, используемые для написания и отладки кода Zabbix веб-интерфейса: |Библиотека|Признак обязательности|Минимальная версия|Описание| |--|-|-|------| |[Composer](https://getcomposer.org/)|Нет|2.4.1|Менеджер пакетов уровня приложений для PHP, который обеспечивает стандартный формат для управления зависимостями PHP программных приложений и требуемых библиотек.| |[PHPUnit](https://phpunit.de/)|^|8.5.29|Среда модульного тестирования PHP для тестирования Zabbix веб-интерфейса.| |[SASS](https://sass-lang.com/)|^|3.4.22|Язык сценариев препроцессора, который интерпретируется и компилируется в Cascading Style Sheets (CSS).| #### 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 и базой данных: - Отметьте *TLS шифрование базы данных* и *Удостоверять сертификат базы данных* - Укажите путь в поле *Файл TLS ключа базы данных* - Укажите путь в поле *Файл TLS CA базы данных* - Укажите путь в поле *Файл 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 encryption with certificate 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/mysql/ca.pem'; $DB['VERIFY_HOST'] = false; $DB['CIPHER_LIST'] = ''; ... Troubleshoot user using command-line tool to check if connection is possible for required user: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=REQUIRED --ssl-ca=/var/lib/mysql/ca.pem #### Веб-интерфейс Чтобы разрешить шифрование с проверкой сертификата для соединений между веб-интерфейсом 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/mysql/ca.pem'; $DB['VERIFY_HOST'] = false; $DB['CIPHER_LIST'] = ''; ... Протестируйте пользователя с помощью инструмента командной строки, чтобы проверить, что подключение для нужного пользователя возможно: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=REQUIRED --ssl-ca=/var/lib/mysql/ca.pem #### Frontend To enable encryption with full 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* Note that *Database host verification* is checked and grayed out - this step cannot be skipped for MySQL. ::: notewarning If *Database TLS cipher list* field is left empty, the common ciphers permitted by both frontend (client) and server will be enabled. Alternatively, the ciphers can be set explicitly, in conformance with the [cipher configuration requirements](https://dev.mysql.com/doc/refman/8.0/en/encrypted-connection-protocols-ciphers.html#encrypted-connection-cipher-configuration). ::: {width="600"} Alternatively, this can be set in */etc/zabbix/web/zabbix.conf.php*: ... // Used for TLS connection with strictly defined Cipher list. $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem'; $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem'; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = 'TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256:TLS_AES_128_CCM_SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-GC'; ... // or ... // Used for TLS connection without Cipher list defined - selected by MySQL server $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem'; $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem'; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = ''; ... #### Веб-интерфейс Чтобы разрешить шифрование с полной верификацией для подключений между веб-интерфейсом Zabbix и базой данных: - Отметьте *TLS шифрование базы данных (Database TLS encryption)* и *Удостоверять сертификат базы данных (Verify database certificate)* - Укажите путь в поле *Файл TLS ключа базы данных (Database TLS key file)* - Укажите путь в поле *Файл TLS CA базы данных (Database TLS CA file)* - Укажите путь в поле *Файл TLS сертификата базы данных (Database TLS certificate file)* Обратите внимание, что поле *Сверка хоста базы данных (Database host verification)* отмечено флажком и недоступно (затемнено серым) — этот шаг не может быть пропущен для MySQL. ::: notewarning Если поле *Список шифров TLS базы данных (Database TLS cipher list)* оставить пустым, будут включены общие шифры, разрешёееые как веб-интерфейсом (клиентом), так и сервером. В качестве альтернативы шифры можно задать явно в соответствии с [требованиями к конфигурации шифра \[en\]](https://dev.mysql.com/doc/refman/8.0/en/encrypted-connection-protocols-ciphers.html#encrypted-connection-cipher-configuration). ::: {width="600"} В качестве альтернативы, это может быть задано в */etc/zabbix/web/zabbix.conf.php*: ... // Используется для TLS-подключения со строго определённым списком шифров. $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem'; $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem'; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = 'TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256:TLS_AES_128_CCM_SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-GC'; ... // или ... // Используется для соединения TLS без заданного списка шифров — выбирается сервером MySQL $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem'; $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem'; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = true; $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"} ##### Frontend to the database A secure connection to the database can be configured during frontend installation: - Mark the *Database TLS encryption* checkbox in the [Configure DB connection](/manual/installation/frontend#configure-db-connection) step to enable transport encryption. - Mark the *Verify database certificate* checkbox that appears when *TLS encryption* field is checked to enable encryption with certificates. ::: noteclassic For MySQL, the *Database TLS encryption* checkbox is disabled, if *Database host* is set to localhost, because connection that uses a socket file (on Unix) or shared memory (on Windows) cannot be encrypted.<br> For PostgreSQL, the *TLS encryption* checkbox is disabled, if the value of the *Database host* field begins with a slash or the field is empty. ::: The following parameters become available in the TLS encryption in certificates mode (if both checkboxes are marked): |Parameter|Description| |--|--------| |*Database TLS CA file*|Specify the full path to a valid TLS certificate authority (CA) file.| |*Database TLS key file*|Specify the full path to a valid TLS key file.| |*Database TLS certificate file*|Specify the full path to a valid TLS certificate file.| |*Database host verification*|Mark this checkbox to activate host verification.<br>Disabled for MYSQL, because PHP MySQL library does not allow to skip the peer certificate validation step.| |*Database TLS cipher list*|Specify a custom list of valid ciphers. The format of the cipher list must conform to the OpenSSL standard.<br>Available for MySQL only.| ::: noteimportant TLS parameters must point to valid files. If they point to non-existent or invalid files, it will lead to the authorization error.<br> If certificate files are writable, the frontend generates a warning in the [System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix) report that "TLS certificate files must be read-only." (displayed only if the PHP user is the owner of the certificate). Certificates protected by passwords are not supported. ::: ##### Веб-интерфейс к базе данных Безопасные подключения к базе данных могут быть настроены во время установки веб-интерфейса: - Отметьте флажок *TLS шифрование базы данных* на шаге [Настройка соединения с базой данных](/manual/installation/frontend#настройка-соединения-с-базой-данных), чтобы включить шифрование на транспортном уровне. - Отметьте флажок *Удостоверять сертификат базы данных* (который появляется при выборе опции *TLS шифрование базы данных*), чтобы разрешить шифрование с сертификатом. ::: noteclassic Для MySQL флажок *TLS шифрование базы данных* отключён, если *Хост базы данных* выставлен в localhost, так как соединение, использующее сокет-файл (на Unix) или разделяемую память (на Windows), не может быть шифрованным.<br> Для PostgreSQL флажок *TLS шифрование базы данных* отключён, если значение поля *Хост базы данных* начинается с косой черты или же пустое. ::: В режиме TLS шифрования с сертификатом (если оба флажка отмечены) становятся доступными следующие параметры: |Параметр|Описание| |--|--------| |*Файл TLS CA базы данных*|Укажите полный путь к корректному файлу удостоверяющего центра (certificate authority, CA) TLS.| |*Файл TLS ключа базы данных*|Укажите полный путь к корректному файлу ключа TLS.| |*Файл TLS сертификата базы данных*|Укажите полный путь к корректному файлу сертификата TLS.| |*Сверка хоста базы данных*|Отметьте этот флажок, чтобы активировать сверку хоста.<br>Отключено для MYSQL, поскольку библиотека PHP MySQL не разрешает пропускать шаг валидации сертификата узла.| |*Список шифров TLS базы данных*|Укажите пользовательский список допустимых шифров. Формат списка шифров должен отвечать стандарту OpenSSL.<br>Доступно только для MySQL.| ::: noteimportant Параметры TLS должны указывать на корректные файлы. Если они указывают на несуществующие или некорректные файлы, это приведёт к ошибке авторизации.<br> Если файлы сертификатов доступны на запись, веб-интерфейс генерирует предупреждение в отчёте [Информация о системе](/manual/web_interface/frontend_sections/reports/status_of_zabbix) о том, что "TLS certificate files must be read-only" (отображается только если пользователь PHP является владельцем сертификата). Защищённые паролем сертификаты не поддерживаются. ::: #### 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). #### Параметры функций Параметры функций позволяют указать: - узел сети и ключ элемента данных (только функции, которые ссылаются на историю элемента данных узла сети) - параметры, специфичные для функции - другие выражения (недоступно для функций, которые ссылаются на историю элемента данных узла сети, смотрите [другие выражения](#другие-выражения) для ознакомления с примерами) Узел сети и ключ элемента данных можно указать в виде `/узел сети/ключ`. Элемент данных, на который ссылается функция, должен быть в поддерживаемом состоянии (за исключением функции **nodata()**, которая вычисляется также по неподдерживаемым элементам данных). В то время как в триггерах другие выражения триггеров в качестве параметров функции ограничены функциями, не связанными с историей, это ограничение не применяется к [вычисляемым элементам данных](/manual/config/items/itemtypes/calculated). ## Functions ## Функции #### Functions Before setting a trigger, it is necessary to define what a problem state is and how much time is needed to take action. Then there are two ways to set up a trigger signaling about a potential unwanted situation. First: the trigger must fire when the system is expected to be in a problem state after the "time to act". Second: the trigger must fire when the system is going to reach the problem state in less than "time to act". Corresponding trigger functions to use are **forecast** and **timeleft**. Note that underlying statistical analysis is basically identical for both functions. You may set up a trigger whichever way you prefer with similar results. #### Функции Перед настройкой триггера необходимо определить, что такое состояние проблемы и сколько времени нужно для принятия мер. Далее есть два способа настроить триггер, сигнализирующий о возможной нежелательной ситуации. Первый: триггер должен сработать, когда ожидается, что после «времени реагирования» система будет в проблемном состоянии. Второй: триггер должен сработать, когда прогнозируется, что система достигнет проблемного состояния за время, меньшее, чем «время реагирования». Для этого используются функции триггеров **forecast** и **timeleft** соответственно. Надо отметить, что статистический анализ, лежащий в основе этих двух функций, в основном идентичен. Вы можете настроить триггер любым удобным для вас способом с аналогичными результатами. #### Functions for Prometheus histograms It has been possible to collect [Prometheus metrics](/manual/config/items/itemtypes/prometheus) in Zabbix for a while now, but some of the metrics are difficult to work with. Specifically, the metrics of histogram type can be presented in Zabbix as multiple items with the same key names, but different parameters. However, even though such items are logically related and represent the same data, it has been difficult to analyze the collected data without specialized functions. To cover this functionality gap in the new version, **rate()** and **histogram\_quantile()** functions, producing the same result as their PromQL counterparts, have been added. Other new additions to complement this functionality are the **bucket\_rate\_foreach()** and the **bucket\_percentile()** functions. For more information see: - [History functions](/manual/appendix/functions/history#history_functions1) (see **rate()**) - [Aggregate functions](/manual/appendix/functions/aggregate#aggregate_functions1) (see **histogram\_quantile()**, **bucket\_percentile()**) - [Foreach functions](/manual/appendix/functions/aggregate/foreach) (see **bucket\_rate\_foreach()**) #### Функции для Prometheus гистограмм В Zabbix уже некоторое время имеется возможность сбора [Prometheus метрик](/manual/config/items/itemtypes/prometheus), но с некоторыми метриками было сложно работать. В частности, метрики с типом гистограмма могли быть представлены в Zabbix как несколько элементов данных с одинаковыми именами ключей, но с отличающимися параметрами. Вместе с тем, несмотря на то, что такие элементы данных логически связаны и представляют собой одни и те же данные, было сложно анализировать собранные данные без специальных функций. Чтобы восполнить такой пробел, в новой версии добавлены **rate()** и **histogram\_quantile()** функции, которые отдают такой же результат как и их аналоги в PromQL. Другие новые добавления дополняющие этот функционал - **bucket\_rate\_foreach()** и **bucket\_percentile()** функции. Для получения более подробных сведений смотрите: - [Функции истории](/manual/appendix/functions/history#функции_истории1) (смотрите **rate()**) - [Функции агрегации](/manual/appendix/functions/aggregate#функции_агрегации1) (смотрите **histogram\_quantile()**, **bucket\_percentile()**) - [Функции цикла](/manual/appendix/functions/aggregate/foreach) (смотрите **bucket\_rate\_foreach()**) #### 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)). #### Функции Функции позволяют обсчитывать собранные значения (вычислять среднее, минимальное, максимальное, сумму), искать строки, ссылаться на текущее время и принимать во внимание другие факторы. Имеется полный список [поддерживаемых функций](/manual/appendix/functions). Обычно функции возвращают числовые значения для последующего сравнения. При возврате строк можно выполнять сравнения при помощи операторов **=** и **<>** (смотрите [пример](#пример-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-specific parameters Function-specific parameters are placed after the item key and are separated from the item key by a comma. See the [supported functions](/manual/appendix/functions) for a complete list of these parameters. Most of numeric functions accept time as a parameter. You may use seconds or [time suffixes](/manual/appendix/suffixes) to indicate time. Preceded by a hash mark, the parameter has a different meaning: |Expression|Description| |----------|-----------| |**sum**(/host/key,**10m)**|Sum of values in the last 10 minutes.| |**sum**(/host/key,**\#10)**|Sum of the last ten values.| Parameters with a hash mark have a different meaning with the function **last** - they denote the Nth previous value, so given the values 30, 70, 20, 60, 50 (from the most recent to the least recent): - `last(/host/key,#2)` would return '70' - `last(/host/key,#5)` would return '50' ##### Параметры, зависящие от функции Параметры, которые зависят от используемой функции, помещаются после ключа элемента данных и отделяются от него запятой. Смотрите полный список этих параметров по [поддерживаемым функциям](/manual/appendix/functions). Большинство числовых функций принимают время в качестве параметра. Чтобы указать время, вы можете использовать секунды или [суффиксы времени](/manual/appendix/suffixes). Параметр, которому предшествует символ решётки, имеет другое значение: |Выражение|Описание| |----------|-----------| |**sum**(/узел сети/ключ,**10m)**|Сумма значений за последние 10 минут.| |**sum**(/узел сети/ключ,**\#10)**|Сумма последних десяти значений.| В случае с функцией **last** параметры с символом решётки имеют другой смысл — они обозначают N-ое предыдущее значение, таким образом, с учётом заданных значений 30, 70, 20, 60, 50 (от самого последнего к наименее последнему значению): - `last(/узел сети/ключ,#2)` вернёт «70» - `last(/узел сети/ключ,#5)` вернёт «50» ##### Function-specific parameters Function-specific parameters are placed after the item key and are separated from the item key by a comma. See the [supported functions](/manual/appendix/functions) for a complete list of these parameters. Most of numeric functions accept time as a parameter. You may use seconds or [time suffixes](/manual/appendix/suffixes) to indicate time. Preceded by a hashtag, the parameter has a different meaning: |Expression|Description| |----------|-----------| |**sum**(/host/key,**10m)**|Sum of values in the last 10 minutes.| |**sum**(/host/key,**\#10)**|Sum of the last ten values.| Parameters with a hashtag have a different meaning with the function **last** - they denote the Nth previous value, so given the values 3, 7, 2, 6, 5 (from most recent to least recent): - `last(/host/key,#2)` would return '7' - `last(/host/key,#5)` would return '5' #### Операторы Следующие операторы поддерживаются для триггеров **(представлены по убыванию приоритета выполнения)**: |ПРИОРИТЕТ|ОПЕРАТОР|ОПРЕДЕЛЕНИЕ|**Заметки по [неизвестным значениям](/ru/manual/config/triggers/expression#выражения_с_неподдерживаемыми_элементами_данных_и_неизвестными_значениями)**| |------------------|----------------|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |**1**|**-**|Унарный минус|**-**Неизвестно → Неизвестно| |**2**|**not**|Логическое НЕ|**not** Неизвестно → Неизвестно| |**3**|**\***|Умножение|0 **\*** Неизвестно → Неизвестно<br>(да, Неизвестно, не 0 - чтобы не потерять<br>Неизвестно в арифметических операциях)<br>1.2 **\*** Неизвестно → Неизвестно| |<|**/**|Деление|Неизвестно **/** 0 → ошибка<br>Неизвестно **/** 1.2 → Неизвестно<br>0.0 **/** Неизвестно → Неизвестно| |**4**|**+**|Арифметический плюс|1.2 **+** Неизвестно → Неизвестно| |<|**-**|Арифметический минус|1.2 **-** Неизвестно → Неизвестно| |**5**|**<**|Менее чем. Этот оператор может быть представлен в виде:<br><br>A<B ⇔ (A<B-0.000001)|1.2 **<** Неизвестно → Неизвестно| |<|**<=**|Менее чем или равно.Этот оператор может быть представлен в виде:<br><br>A<=B ⇔ (A≤B+0.000001)|Неизвестно **<=** Неизвестно → Неизвестно| |<|**>**|Более чем. Этот оператор может быть представлен в виде:<br><br>A>B ⇔ (A>B+0.000001)|<| |<|**>=**|Более чем или равно. Этот оператор может быть представлен в виде:<br><br>A>=B ⇔ (A≥B-0.000001)|<| |**6**|**=**|Равенство. Этот оператор может быть представлен в виде:<br><br>A=B ⇔ (A≥B-0.000001) и (A≤B+0.000001)|<| |<|**<>**|Не равно. Этот оператор может быть представлен в виде:<br><br>A<>B ⇔ (A<B-0.000001) или (A>B+0.000001)|<| |**7**|**and**|Логическое И|0 **and** Неизвестно → 0<br>1 **and** Неизвестно → Неизвестно<br>Неизвестно **and** Неизвестно → Неизвестно| |**8**|**or**|Логическое ИЛИ|1 **or** Неизвестно → 1<br>0 **or** Неизвестно → Неизвестно<br>Неизвестно **or** Неизвестно → Неизвестно| Операторы **not**, **and** and **or** регистрозависимы и должны быть в нижнем регистре. Они также должны быть окружены символами пробелов или круглыми скобками. Все операторы, кроме унарных **-** и **not**, имеют ассоциативность слева на право. Унарные **-** и **not** не ассоциативны (имеется в виду необходимо использовать **-(-1)** и **not (not 1)** вместо **--1** и **not not 1**). Результат вычисления: - Операторы **<**, **<=**, **>**, **>=**, **=**, **<>** должны давать '1' в выражении триггера, если указанное соотношение правдиво и '0', если оно ложно. Если по крайней мере один операнд Неизвестен, то и результат будет Неизвестно; - **and** по известным операндам должно давать '1', если оба из этих операндов сравнения не равны '0'; в противном случае, будет давать '0'; для неизвестных операндов **and** даст '0' только, если один из операндов сравнения равен '0'; в противном случае, он даст 'Неизвестно'; - **or** по известным операндам должно давать '1', если какой-либо из этих операндов сравнения не равен '0'; в противном случае, будет давать '0'; для неизвестных операндов **or** даст '1' только, если один из операндов сравнения не равен '0'; в противном случае, он даст 'Неизвестно'; - Результат логического операнда отрицания **not** для известного операнда равен '0', если значение этого операнда сравнения не равно '0'; '1', если значение его операнда сравнения равно '0'. Для неизвестных операндов **not** даст 'Неизвестно'. #### 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 поддерживают два общих параметра: `фильтр_элементов_данных` (подробнее смотрите ниже) и `период_времени`: функция_foreach(фильтр_элементов_данных,период_времени) Например: `avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)` вернёт среднее за пять минут значение для каждого из элементов данных «mysql.qps» в группе «MySQL server». Обратите внимание, что некоторые функции поддерживают дополнительные [параметры](#дополнительные-параметры). ### 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>*(Username)*|Уникальное имя пользователя, используется как логин.| |*Имя*<br>*(Name)*|Имя пользователя (опционально).<br>Если поле заполнено, оно отображается в информации подтверждений и в информации о получателе оповещения.| |*Фамилия*<br>*(Last name)*|Фамилия пользователя (опционально).<br>Если поле заполнено, оно отображается в информации подтверждений и в информации о получателе оповещения.| |*Группы*<br>*(Groups)*|Выбор [групп пользователей](usergroup), к которым принадлежит пользователь. С Zabbix 3.4.3 это поле имеет функцию автодополнения, таким образом после начала ввода имени группы пользователей вам будет предложен список соответствующих групп пользователей в выпадающем меню. Прокрутите вниз, чтобы выбрать необходимую группу. Альтернативный способ — для добавления групп нажмите на *Выбрать (Select)*. Нажмите на «x», чтобы удалить выбранную группу.<br>Принадлежность к группам пользователей определяет, к каким группам узлов сети и узлам сети пользователь будет иметь [доступ](permissions).| |*Пароль*<br>*(Password)*|Два поля для ввода пароля пользователя.<br>При наличии пароля отображается кнопка *Изменить пароль (Password)*, при нажатии на которую появятся поля пароля.<br>Обратите внимание, пароли длиннее 72 символов будут обрезаны.| |*Язык*<br>*(Language)*|Язык веб-интерфейса Zabbix.<br>Для работы перевода веб-интерфейса необходимо установить расширение php gettext.| |*Часовой пояс*<br>*(Time zone)*|Часовой пояс, который переопределяет глобальный [часовой пояс](/manual/web_interface/time_zone#обзор) на уровне пользователя или **Системное по умолчанию (System default)** для использования глобальных настроек часового пояса.| |*Тема*<br>*(Theme)*|Внешний вид веб-интерфейса:<br>**Системная по умолчанию (System default)** — использование системных настроек по умолчанию<br>**Синяя (Blue)** — стандартная синяя схема<br>**Тёмная (Dark)** — альтернативная тёмная тема<br>**Высококонтрастная светлая** — светлая тема с высоким контрастом<br>**Высококонтрастная тёмная (High-contrast dark)** — тёмная тема с высоким контрастом| |*Авто-вход*<br>*(Auto-login)*|Отметьте, если хотите, чтобы Zabbix запомнил пользователя и выполнял вход в систему автоматически в течении 30 дней. Для этого используются cookies браузера.| |*Авто-выход*<br>*(Auto-logout)*|При выборе этой опции пользователь будет автоматически выходить из системы после указанного количества секунд (минимальное значение 90 секунд, максимальное 1 день).<br>Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например, 90s, 5m, 2h, 1d.<br>Обратите внимание на случаи когда эта опция не будет работать:<br>\* Если активирована глобальная опция конфигурации «Показывать предупреждение, если Zabbix сервер недоступен» и веб-интерфейс Zabbix остается открытым;<br>\* Когда страницы меню Мониторинга выполняют фоновое обновление информации;<br>\* Если при входе в систему выбрана опция *Запоминать меня на 30 дней*.| |*Обновление*<br>*(Refresh)*|Выберите частоту обновления графиков, простых тестовых данных и прочего. Можно указать значение равное 0, тогда обновление будет отключено.| |*Строк на странице*<br>*(Rows per page)*|Вы можете задать, как много строк на странице будет отображаться в списках.| |*URL (после входа в систему)*<br>*(URL (after login))*|Zabbix перенаправит пользователя на указанный URL после успешного входа в систему, например, на страницу *Проблемы (Problems)*.| #### General recommendations - Start with understanding which component acts as a TLS client and which one acts as a TLS server in problem case.<br> Zabbix server, proxies and agents, depending on interaction between them, all can work as TLS servers and clients.<br> For example, Zabbix server connecting to agent for a passive check, acts as a TLS client. The agent is in role of TLS server.<br> Zabbix agent, requesting a list of active checks from proxy, acts as a TLS client. The proxy is in role of TLS server.<br> `zabbix_get` and `zabbix_sender` utilities always act as TLS clients. - Zabbix uses mutual authentication.<br> Each side verifies its peer and may refuse connection.<br> For example, Zabbix server connecting to agent can close connection immediately if agent's certificate is invalid. And vice versa - Zabbix agent accepting a connection from server can close connection if server is not trusted by agent. - Examine logfiles in both sides - in TLS client and TLS server.<br> The side which refuses connection may log a precise reason why it was refused. Other side often reports rather general error (e.g. "Connection closed by peer", "connection was non-properly terminated"). - Sometimes misconfigured encryption results in confusing error messages in no way pointing to real cause.<br> In subsections below we try to provide a (far from exhaustive) collection of messages and possible causes which could help in troubleshooting.<br> Please note that different crypto toolkits (OpenSSL, GnuTLS) often produce different error messages in same problem situations.<br> Sometimes error messages depend even on particular combination of crypto toolkits on both sides. #### Общие рекомендации - В случае проблем начните с понимания того, какой компонент действует как TLS клиент и какой действует как TLS сервер.<br> Zabbix сервер, прокси и агенты, в зависимости от взаимодействия между ними, все они могут действовать как в роли TLS сервера, так и в роли TLS клиента.<br> Например, Zabbix сервер, который подключается к агенту для пассивной проверки, действует как TLS клиент. Агент действует в роли TLS сервера.<br> Zabbix агент, запрашивая список активных проверок с прокси, действует как TLS клиент. Прокси действует как TLS сервер.<br> Утилиты `zabbix_get` и `zabbix_sender` всегда действуют как TLS клиенты. - Zabbix использует взаимную аутентификацию.<br> Каждая сторона проверяет своего партнера и может отказать в соединении.<br> Например, Zabbix сервер, подключаясь к агенту, может немедленно закрыть соединение, если сертификат агента ошибочен. И наоборот — Zabbix агент, принимая подключение от сервера, может закрыть соединение, если агент не доверяет серверу. - Исследуйте файлы журналов на обеих сторонах — и TLS клиента, и TLS сервера.<br> Сторона, которая отвергает соединение, может записать точную причину отказа в соединении. Другая сторона зачастую сообщает о весьма общей ошибке (например, "Connection closed by peer", "connection was non-properly terminated"). - Иногда неправильно настроенное шифрование приводит к запутанным сообщениям об ошибках, не указывая реальную причину проблем.<br> В подразделах ниже мы попытаемся предоставить (далеко не исчерпывающую) коллекцию сообщений и возможные причины, которые могут помочь в устранении проблем.<br> Пожалуйста, обратите внимание, что разные наборы инструментов криптографии (OpenSSL, GnuTLS) зачастую дают различные сообщения об ошибках в одних и тех же проблемных ситуациях.<br> Иногда сообщения об ошибках зависят даже от конкретной комбинации наборов инструментов криптографии с обеих сторон. #### 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 } ``` #### Генерация нескольких токенов Сгенерировать два токена. Запрос: ```json { "jsonrpc": "2.0", "method": "token.generate", "params": [ "1", "2" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Ответ: ```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) элемента данных. Пользователям, у которых активирован [режим отладки](/manual/web_interface/debug_mode) веб-интерфейса, будет отображаться серая вертикальная подпись в правом нижнем углу, указывающая, откуда взяты данные. На то, будет ли использована история или динамика изменений, влияют несколько факторов: - длительность истории элемента данных. Например, история элемента данных хранится 14 дней. В этом случае любые данные старше четырнадцати дней будут взяты из динамики изменений. ```{=html} <!-- --> ``` - перегруженность данных в графике. Если отображаемое количество секунд на пиксель графика по горизонтали превышает 3600/16, то тогда данные будут отображены из динамики изменений (даже если за этот период ещё имеется история элемента данных). ```{=html} <!-- --> ``` - если динамика изменений отключена, то для построения графика будет использоваться история элемента данных — если она доступна за требуемый период. Такое поведение поддерживается, начиная с Zabbix 2.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. #### Генерирование общего ключа Например, 256-битный (32 байт) PSK можно сгенерировать при помощи следующих команд: - с *OpenSSL*: ```{=html} <!-- --> ``` $ openssl rand -hex 32 af8ced32dfe8714e548694e2d29e1a14ba6fa13f216cb35c19d0feb1084b0429 - с *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» выше генерирует файл базы данных с идентификатором ключа и со связанным с ним значением. Zabbix ожидает в файле с ключом только значение, поэтому строку идентификации и двоеточие («:») нужно оттуда удалить. #### 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 text|Tile provider attribution text to be displayed in a small text box on the map. This field is visible 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*.| #### Географические карты На этой странице можно выбрать поставщика услуг плиток географической карты и настроить параметры поставщика услуг для [виджета панели](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) Геокарта. Для обеспечения визуализации с использованием географических карт, Zabbix использует JavaScript библиотеку интерактивных карт с открытым исходным кодом Leaflet. Пожалуйста, обратите внимание, что Zabbix не контролирует качество изображений, предоставляемых сторонними поставщиками плиток, включая предустановленных поставщиков плиток.  |Параметр|Описание| |--|--------| |Провайдер плитки<br>(Tile provider)|Выберите одного из доступных поставщиков плиток или выберите *Другое* для добавления другого поставщика плиток либо собственных плиток (смотрите [Использование пользовательского поставщика услуг плиток](#использование-пользовательского-поставщика-услуг-плиток)).| |URL плитки<br>(Tile URL)|Шаблон URL для загрузки и отображения слоя плиток на географических картах. Это поле доступно для редактирования только если параметр *Провайдер плитки (Tile provider)* имеет значение *Другое (Other)*.<br><br>Поддерживаются следующие шаблоны-заполнители:<br>*{s}* представляет один из доступных поддоменов;<br>*{z}* представляет параметр уровня масштабирования в URL;<br>*{x}* и *{y}* представляют координаты плитки;<br>*{r}* можно использовать, чтобы добавить "\@2x" к URL для загрузки сетчатых плиток.<br><br>Пример: `https://{s}.example.com/{z}/{x}/{y}{r}.png`| |Текст авторства<br>(Attribution text)|Текст атрибуции поставщика плиток, который будет отображаться в небольшом текстовом поле на карте. Это поле отображается только в случае, если параметр *Провайдер плитки (Tile provider)* имеет значение *Другое (Other)*.| |Максимальный уровень масштаба<br>(Max zoom level)|Наибольший уровень масштабирования карты. Это поле доступно для редактирования только если параметр *Провайдер плитки (Tile provider)* имеет значение *Другое (Other)*.| #### 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#географические-карты).  #### 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).  #### Виджет геокарты Для панелей представлен виджет геокарты, который позволяет отображать узлы сети на географических картах. Для получения более подробных сведений смотрите [виджет панели] /manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) *Геокарта* и [географические карты](/manual/web_interface/frontend_sections/administration/general#географические-карты).  ##### 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).  #### Изменение узла сети во всплывающем окне Диалог создания и изменения узлов сети теперь открывается в модальном (во всплывающем) окне в *Настройка* → *Узлы сети*, *Мониторинг* → *Узлы сети* и на любых других страницах, где имеется меню узла сети или другая прямая ссылка на настройки узла сети. Прямые ссылки на изменение узла сети всё ещё работают и открывают страницу изменения узла сети на полную страницу. #### 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; } #### Ошибка виджета геокарты Карты в виджете Геокарты могут не загружаться корректно, если вы обновились с более старой версии Zabbix с NGINX и не переключились на новый файл конфигурации в процессе обновления. Чтобы исправить эту проблемы, вы можете выбросить старый файл конфигурации, использовать файл конфигурации из пакета 6.0 и перенастроить его, как описано в [инструкциях по загрузке](https://www.zabbix.com/ru/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&components=server_frontend_agent&db=mysql&ws=nginx) в разделе *e. Настройте PHP для веб-интерфейса*. Как альтернатива, вы можете вручную изменить существующий файл конфигурации 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 } ``` #### Получить количество резервных узлов Запрос: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "countOutput": true, "filter": { "status": 0 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Ответ: ```json { "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 } ``` #### Получение списка узлов, упорядоченных по статусу Запрос: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "preservekeys": true, "sortfield": "status", "sortorder": "DESC" }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Ответ: ```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 } ``` #### 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 } ``` #### Получить список определенных узлов по их идентификаторам Запрос: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "ha_nodeids": ["ckuo7i1nw000e0sajwfttc1mp", "ckuo7i1nv000c0sajz85xcrtt"] }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Ответ: ```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 } ``` #### 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 } ``` #### Получить список остановленных узлов Запрос: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["ha_nodeid", "address", "port"], "filter": { "status": 1 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Ответ: ```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 } ``` ## Get started with Zabbix ## Начало работы с Zabbix #### 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 gateway Вы можете установить Java gateway как из исходных кодов, так и из пакетов, которые можно загрузить с [Zabbix веб-сайта](https://www.zabbix.com/ru/download). Воспользовавшись ссылками ниже, вы сможете получить информацию о том, как получить и запустить Zabbix Java gateway, как настроить Zabbix сервер (или Zabbix прокси) на использование Zabbix Java gateway для мониторинга JMX, и как в веб-интерфейсе Zabbix настроить элементы данных Zabbix, соответствующие конкретным счетчикам JMX. |Установка из|Инструкции|Инструкции| |-----------------|------------|------------| |*Исходных кодов*|[Установка](/manual/installation/install#установка_java_gateway)|[Настройка](/manual/concepts/java/from_sources)| |*Пакетов RHEL*|[Установка](/manual/installation/install_from_packages/rhel#установка_java_gateway)|[Настройка](/manual/concepts/java/from_rhel)| |*Пакетов Debian/Ubuntu*|[Установка](/manual/installation/install_from_packages/debian_ubuntu#установка_java_gateway)|[Настройка](/manual/concepts/java/from_debian_ubuntu)| ##### Getting the list of items **Agent request** The active checks request is used to obtain the active checks to be processed by agent. This request is sent by the agent upon start and then with _RefreshActiveChecks_ intervals. ```json { "request": "active checks", "host": "Zabbix server", "host_metadata": "mysql,nginx", "interface": "zabbix.server.lan", "ip": "159.168.1.1", "port": 12050 } ``` | Field | Type | Mandatory | Value | |-|-|-|--------| | request | _string_ | yes | `active checks` | | host | _string_ | yes | Host name. | | host_metadata | _string_ | no | The configuration parameter HostMetadata or HostMetadataItem metric value. | | interface | _string_ | no | The configuration parameter HostInterface or HostInterfaceItem metric value. | | ip | _string_ | no | The configuration parameter ListenIP first IP if set. | | port | _number_ | no | The configuration parameter ListenPort value if set and not default agent listening port. | **Server response** The active checks response is sent by the server back to agent after processing the active checks request. ```json { "response": "success", "data": [ { "key": "log[/home/zabbix/logs/zabbix_agentd.log]", "key_orig": "log[/home/zabbix/logs/zabbix_agentd.log]", "itemid": 1234, "delay": 30, "lastlogsize": 0, "mtime": 0 }, { "key": "agent.version", "key_orig": "agent.version", "itemid": 5678, "delay": 10, "lastlogsize": 0, "mtime": 0 } ] } ``` | Field |<| Type | Mandatory | Value | |-|------|--|-|-----------------------| | response |<| _string_ | yes | `success` \| `failed` | | info |<| _string_ | no | Error information in the case of failure. | | data |<| _array of objects_ | no | Active check items. | | | key | _string_ | no | Item key with expanded macros. | |^| key_orig | _string_ | no | Item key without expanded macros. | |^| itemid | _number_ | no | Item identifier. | |^| delay | _integer_ | no | Item update interval. | |^| lastlogsize | _number_ | no | Item lastlogsize. | |^| mtime | _number_ | no | Item mtime. | | refresh_unsupported |<| _number_ | no | Unsupported item refresh interval. | | regexp |<| _array of objects_ | no | Global regular expressions. | | | name | _string_ | no | Global regular expression name. | |^| expression | _string_ | no | Global regular expression. | |^| expression_type | _number_ | no | Global regular expression type. | |^| exp_delimiter | _string_ | no | Global regular expression delimiter. | |^| case_sensitive | _number_ | no | Global regular expression case sensitivity setting. | The server must respond with success. For example: 1. Agent opens a TCP connection 2. Agent asks for the list of checks 3. Server responds with a list of items (item key, delay) 4. Agent parses the response 5. TCP connection is closed 6. Agent starts periodical collection of data ::: noteimportant Note that (sensitive) configuration data may become available to parties having access to the Zabbix server trapper port when using an active check. This is possible because anyone may pretend to be an active agent and request item configuration data; authentication does not take place unless you use [encryption](/manual/encryption) options. ::: ##### Получение списка элементов данных **Запрос агента** Запрос на активные проверки используется для получения списка активных проверок, обрабатываемых агентом. Этот запрос отсылается агентом после старта и затем с интервалом _RefreshActiveChecks_ . ```json { "request": "active checks", "host": "Zabbix server", "host_metadata": "mysql,nginx", "interface": "zabbix.server.lan", "ip": "159.168.1.1", "port": 12050 } ``` | Поле | Тип | Обязательный | Значение | |-|-|-|--------| | request | _строка_ | да | `active checks` | | host | _строка_ | да | Имя узла сети. | | host_metadata | _строка_ | нет | Значение метрики параметра конфигурации HostMetadata или HostMetadataItem. | | interface | _строка_ | нет | Значение метрики параметра конфигурации HostInterface или HostInterfaceItem. | | ip | _строка_ | нет | Первый IP параметра конфигурации ListenIP, если задан. | | port | _число_ | нет | Значение параметра конфигурации ListenPort, если задано и не является портом, прослушиваемым агентом по умолчанию. | **Ответ сервера** Ответ активных проверок посылается сервером обратно агенту после обработки запроса на активные проверки. ```json { "response": "success", "data": [ { "key": "log[/home/zabbix/logs/zabbix_agentd.log]", "key_orig": "log[/home/zabbix/logs/zabbix_agentd.log]", "itemid": 1234, "delay": "30", "lastlogsize": 0, "mtime": 0 }, { "key": "agent.version", "key_orig": "agent.version", "itemid": 5678, "delay": "10", "lastlogsize": 0, "mtime": 0 } ] } ``` | Поле |<| Тип | Обязательный | Значение | |-|------|--|-|-----------------------| | response |<| _строка_ | да | `success` \| `failed` | | info |<| _строка_ | нет | Сообщение об ошибке в случае сбоя. | | data |<| _массив объектов_ | нет | Элементы данных для активных проверок. | | | key | _строка_ | нет | Ключ элемента данных с раскрытыми макросами. | |^| key_orig | _строка_ | нет | Ключ элемента данных с нераскрытыми макросами. | |^| itemid | _число_ | нет | Идентификатор элемента данных. | |^| delay | _целое_число_ | нет | Интервал обновления элемента данных. | |^| lastlogsize | _число_ | нет | Последний размер файла журнала (lastlogsize) элемента данных. | |^| mtime | _число_ | нет | Отметка времени последнего обновления (mtime) элемента данных. | | refresh_unsupported |<| _число_ | нет | Интервал обновления неподдерживаемого элемента данных. | | regexp |<| _массив объектов_ | нет | Глобальные регулярные выражения. | | | name | _строка_ | нет | Имя глобального регулярного выражения. | |^| expression | _строка_ | нет | Глобальное регулярное выражение. | |^| expression_type | _число_ | нет | Тип глобального регулярного выражения. | |^| exp_delimiter | _строка_ | нет | Разделитель глобального регулярного выражения. | |^| case_sensitive | _число_ | нет | Признак чувствительности к регистру глобального регулярного выражения. | Сервер обязан ответить успешно. Например: 1. Агент открывает TCP-соединение 2. Агент запрашивает список проверок 3. Сервер отвечает списком элементов данных (ключ элемента данных, интервал обновления) 4. Агент анализирует ответ 5. TCP-соединение закрывается 6. Агент начинает периодический сбор данных ::: noteimportant Обратите внимание, что при использовании активных проверок (чувствительные) данные конфигурации могут стать доступными лицам, имеющим доступ к порту траппера Zabbix сервера. Это возможно, так как любой может представиться активным агентом и запросить данные конфигурации элементов данных; аутентификация не производится, если только вы не используете опции [шифрования](/manual/encryption). ::: #### Getting Zabbix source code There are several ways of getting Zabbix source code: - You can [download](https://www.zabbix.com/download_sources#60LTS) the released stable versions from the official Zabbix website - You can [download](https://www.zabbix.com/developers) nightly builds from the official Zabbix website developer page - You can get the latest development version from the Git source code repository system: - The primary location of the full repository is at <https://git.zabbix.com/scm/zbx/zabbix.git> - Master and supported releases are also mirrored to Github at <https://github.com/zabbix/zabbix> A Git client must be installed to clone the repository. The official commandline Git client package is commonly called **git** in distributions. To install, for example, on Debian/Ubuntu, run: sudo apt-get update sudo apt-get install git To grab all Zabbix source, change to the directory you want to place the code in and execute: git clone https://git.zabbix.com/scm/zbx/zabbix.git #### Получение исходного кода Zabbix Имеется несколько способов получения исходного кода Zabbix: - Вы можете [загрузить](https://www.zabbix.com/ru/download_sources#60LTS) выпущенные стабильные версии с официального сайта Zabbix - Вы можете [загрузить](https://www.zabbix.com/ru/developers) ночные сборки со страницы разработчика с официального сайта Zabbix - Вы можете получить последние версии разработки из системы репозитория исходного кода Git: - Основное местоположение полного репозитория располагается в <https://git.zabbix.com/scm/zbx/zabbix.git> - Мастер и поддерживаемые выпуски так же зеркалируются в <https://github.com/zabbix/zabbix> Чтобы клонировать репозиторий, должен быть установлен Git клиент. Официальная командная строка пакета клиента Git в дистрибутивах, как правило, называется **git**. Чтобы установить **git**, например, на Debian/Ubuntu, выполните: sudo apt-get update sudo apt-get install git Чтобы получить весь исходный код Zabbix, смените директорию на ту, в которую хотите поместить код, и выполните: git clone https://git.zabbix.com/scm/zbx/zabbix.git #### 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. #### Глобальная корреляция событий События могут не коррелироваться должным образом, если промежуток времени между первым и вторым событием очень мал, то есть полсекунды и менее. ### Global JavaScript functions Additional global JavaScript functions have been implemented with Duktape: - `btoa(data)` - encodes the data to Base64 string. - `atob(base64_string)` - since version 6.0.31, decodes Base64 string as Uint8Array buffer (in Zabbix 6.0.0 - 6.0.30 returns a decoded string). ```javascript try { b64 = btoa("test string"); buffer = atob(b64); // Note that decoding logic depends on the data format of the buffer. decoded = String.fromCharCode.apply(this, [].slice.call(buffer)); } catch (error) { return {'error.name' : error.name, 'error.message' : error.message}; } ``` - `md5(data)` - calculates the MD5 hash of the data. - `sha256(data)` - calculates the SHA256 hash of the data. - `hmac('<hash type>',key,data)` - returns a HMAC hash as a hex-formatted string; `md5` and `sha256` are supported as the `hash type`; the `key` and `data` parameters support binary data. Examples: - `hmac('md5',key,data)` - `hmac('sha256',key,data)` - `sign(hash,key,data)` - returns calculated signature (RSA signature with SHA-256) as a string, where:<br> **hash** - only `sha256` is allowed, otherwise an error is thrown.<br> **key** - the private key. It should correspond to PKCS#1 or PKCS#8 standard. The key can be provided in different forms:<br> - with spaces instead of newlines - with escaped or non-escaped '\n's instead of newlines - without any newlines as a single-line string - as a JSON-formatted string The key also can be loaded from a user macro/secret macro/vault. **data** - the data that will be signed. It can be a string (binary data also supported) or buffer (Uint8Array/ArrayBuffer). Example: - `sign('sha256',key,data)` OpenSSL or GnuTLS is used to calculate the signatures. If Zabbix was built without any of these encryption libraries, an error will be thrown ('missing OpenSSL or GnuTLS library').<br>This function is supported since Zabbix 6.0.15. ### Глобальные функции JavaScript Дополнительные глобальные функции JavaScript реализованы при помощи Duktape: - `btoa(данные)` — кодирует данные в строку Base64. - `atob(строка_base64)` — начиная с версии 6.0.31, декодирует строку Base64 как буфер Uint8Array (в Zabbix 6.0.0 — 6.0.30 возвращает декодированную строку). ```javascript try { b64 = btoa("test string"); buffer = atob(b64); // Обратите внимание, что логика декодирования зависит от формата данных буфера. decoded = String.fromCharCode.apply(this, [].slice.call(buffer)); } catch (error) { return {'error.name' : error.name, 'error.message' : error.message}; } ``` - `md5(данные)` — вычисление MD5 хеш-суммы строки. - `sha256(данные)` — вычисление SHA256 хеш-суммы строки. - hmac('\<тип_хеша\>',ключ,данные) — возврат HMAC хеш-суммы в виде шестнадцатеричной строки; поддерживаются типы хеша `md5` и `sha256`; параметры ключ и данные поддерживают бинарные данные. Примеры: - `hmac('md5',key,data)` - `hmac('sha256',key,data)` - `sign(хеш,ключ,данные)` — возврат вычисленной подписи (RSA-подпись с SHA-256) в виде строки, где:<br> **хеш** — разрешено только `sha256`, иначе выбрасывается ошибка;<br> **ключ** — закрытый ключ (private key). Он должен соответствовать стандарту PKCS#1 или PKCS#8. Ключ может быть представлен в различных формах:<br> - с пробелами вместо переводов строк - с экранированными или неэкранированными «\n» вместо переводов строк - вообще без переводов строк, как одна строка - в виде строки в формате JSON Ключ также может быть загружен из пользовательского макроса/скрытого макроса/хранилища). **данные** — данные, которые будут подписаны. Это может быть строка (поддерживаются бинарные данные) или буфер (Uint8Array/ArrayBuffer). Пример: - `sign('sha256',key,data)` Для вычисления подписей используются OpenSSL или GnuTLS. Если Zabbix был скомпилирован без какой-либо из этих библиотек шифрования, будет выброшена ошибка («missing OpenSSL or GnuTLS library»).<br>Эта функция поддерживается, начиная с Zabbix 6.0.15. ### Global macro The global macro object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |globalmacroid|string|*(readonly)* ID of the global macro.| |**macro**<br>(required)|string|Macro string.| |**value**<br>(required)|string|Value of the macro.| |type|integer|Type of macro.<br><br>Possible values:<br>0 - *(default)* Text macro;<br>1 - Secret macro;<br>2 - Vault secret.| |description|string|Description of the macro.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Глобальный макрос Объект глобального макроса имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#типы_данных)|Описание| |--|--|------| |globalmacroid|string|*(только для чтения)* - идентификатор глобального макроса.| |**macro**<br>(обязательно)|string|Строка макроса.| |**value**<br>(обязательно)|string|Значение макроса.| |type|integer|Тип макроса.<br><br>Возможные значения:<br>0 - *(по умолчанию)* Текст;<br>1 - Скрытый текст;<br>2 - Секрет Хранилища.| |description|string|Описание макроса.| Обратите внимание, что для некоторых методов (например, update и delete) набор обязательных и необязательных параметров отличается. ##### 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. ##### Отображение глобальных оповещений Как только поступят сообщения, они отобразятся в плавающем окне сверху справа. Это окно можно свободно перемещать за заголовок окна.  Для этого окна доступны несколько элементов управления: -  Кнопка **Заснуть** приглушает звуковой сигнал текущего оповещения; -  Кнопка **Отключить звук/Включить звук** переключает между воспроизведением и невоспроизведением звукового сигнала вообще. #### Global regular expressions There is an advanced editor for creating and testing complex regular expressions in Zabbix frontend. Once a regular expression has been created this way, it can be used in several places in the frontend by referring to its name, prefixed with @, for example, *\@mycustomregexp*. To create a global regular expression: - Go to: *Administration → General* - Select *Regular expressions* from the dropdown - Click on *New regular expression* The **Expressions** tab allows to set the regular expression name and add subexpressions.  All mandatory input fields are marked with a red asterisk. |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Set the regular expression name. Any Unicode characters are allowed.| |*Expressions*|<|Click on *Add* in the Expressions block to add a new subexpression.| | |*Expression type*|Select expression type:<br>**Character string included** - match the substring<br>**Any character string included** - match any substring from a delimited list. The delimited list includes a comma (,), a dot (.) or a forward slash (/).<br>**Character string not included** - match any string except the substring<br>**Result is TRUE** - match the regular expression<br>**Result is FALSE** - do not match the regular expression| |^|*Expression*|Enter substring/regular expression.| |*Delimiter*|<|A comma (,), a dot (.) or a forward slash (/) to separate text strings in a regular expression. This parameter is active only when "*Any character string included*" expression type is selected.| |*Case sensitive*|<|A checkbox to specify whether a regular expression is sensitive to capitalization of letters.| A forward slash (/) in the expression is treated literally, rather than a delimiter. This way it is possible to save expressions containing a slash, without errors. ::: noteimportant A custom regular expression name in Zabbix may contain commas, spaces, etc. In those cases where that may lead to misinterpretation when referencing (for example, a comma in the parameter of an item key) the whole reference may be put in quotes like this: *"\@My custom regexp for purpose1, purpose2"*.<br> Regular expression names must not be quoted in other locations (for example, in LLD rule properties). ::: In the **Test** tab the regular expression and its subexpressions can be tested by providing a test string.  Results show the status of each subexpression and total custom expression status. Total custom expression status is defined as *Combined result*. If several sub expressions are defined Zabbix uses AND logical operator to calculate *Combined result*. It means that if at least one Result is False *Combined result* has also False status. #### Глобальные регулярные выражения В веб-интерфейсе Zabbix имеется продвинутый редактор для создания и тестирования сложных регулярных выражений. После того как регулярное выражение создано таким путём, его можно использовать в нескольких местах веб-интерфейса, используя ссылку на его имя с префиксом @, например: *\@моё\_пользовательское\_выражение*. Для создания глобального регулярного выражения: - Перейдите в: *Администрирование → Общие (Administration → General)* - Выберите *Регулярные выражения (Regular expressions)* в выпадающем списке - Нажмите на *Новое регулярное выражение (New regular expression)* Вкладка **Выражения (Expressions)** позволяет указать имя регулярного выражения и добавить подвыражения.  Все обязательные поля ввода отмечены красной звёздочкой. |Параметр|<|Описание| |-|----------|----------------------------------------| |*Имя (Name)*|<|Укажите имя регулярного выражения. Разрешены любые символы Unicode.| |*Выражения (Expressions)*|<|Нажмите на *Добавить (Add)* в блоке Выражения (Expressions), чтобы добавить новое подвыражение.| | |*Тип выражения*<br>*(Expression type)*|Выберите тип выражения:<br>**Строка символов включена (Character string included)** — совпадение по подстроке<br>**Любая строка символов включена (Any character string included)** — совпадение по любой из подстрок из списка с разделителями. Разделители в списке включают в себя запятую (,), точку (.) или прямую косую черту (/).<br>**Строка символов не включена (Character string not included)** — совпадение по любой строке за исключением подстроки<br>**Результат ИСТИНА (Result is TRUE)** — совпадение с регулярным выражением<br>**Результат ЛОЖЬ (Result is FALSE)** — отсутствие совпадения с регулярным выражением| | |*Выражение*<br>*(Expression)*|Укажите подстроку/регулярное выражение.| |*Разделитель*<br>*(Delimiter)*|<|Запятая (,), точка (.) или прямая косая черта (/) для разделения текстовых строк в регулярном выражении. Этот параметр доступен только когда выбран режим типа выражения «*Любая строка символов включена*».| |*Регистрозависимое*<br>*(Case sensitive)*|<|Отметьте эту опцию, чтобы указать, является ли регулярное выражение чувствительным к регистру букв.| Косая черта (/) в выражении воспринимается буквально, а не как разделитель. Таким образом можно сохранять выражения, содержащие косую черту, без ошибок. ::: noteimportant В Zabbix имя пользовательского регулярного выражения может содержать запятые, пробелы и т.п. В этих случаях, там, где имеется вероятность неверной интерпретации при использовании ссылки (например, запятая в параметре ключа элемента данных) нужно всю ссылку заключить в кавычки, вот таким образом: *"\@Моё выражение для цели1, цели2"*.<br> В других местах (например, в свойствах LLD правил) имена регулярных выражений нельзя заключать в кавычки. ::: На вкладке **Тест (Test)** регулярное выражение и его подвыражения могут быть протестированы путём указания тестовых исходных данных.  Результаты показывают состояние каждого подвыражения и всего пользовательского регулярного выражения. Состояние всего пользовательского выражения определяется как *Комбинированный результат (Combined result)*. Если задано несколько подвыражений, то, чтобы вычислить *Комбинированный результат*, Zabbix использует логический оператор И (AND). Это означает, что если хотя бы один Результат даёт ЛОЖЬ, то *Комбинированный результат* также будет иметь состояние ЛОЖЬ. ### GLPI integration A new [GLPI integration](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/glpi/) is available allowing to use the [webhook](/manual/config/notifications/media/webhook) media type to create problems in GLPI Assistance section based on Zabbix problem notifications. ### Интеграция GLPI Доступна новая [интеграция GLPI](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/glpi/), которая позволяет использовать способ оповещения [вебхук](/manual/config/notifications/media/webhook) для создания проблем в разделе GLPi Assistance на основе Zabbix оповещений о проблемах. ### 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). ### Обновление библиотеки Golang для Windows Библиотекой Golang, используемой Zabbix агентом 2 в сочетании с плагинами MongoDB или PostgreSQL для мониторинга Windows, теперь является `github.com/Microsoft/go-winio`, версии 0.6.0 (ранее -- `github.com/natefinch/npipe`). Смотрите также [требования к Агенту 2](/manual/installation/requirements#агент-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 Cloud Доступен новый [шаблон](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). Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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 preview In the *Preview* tab, a preview of the graph is displayed so you can immediately see what you are creating. {width="600"} Note that the preview will not show any data for template items. {width="600"} In this example, pay attention to the dashed bold line displaying the trigger level and the trigger information displayed in the legend. ::: noteclassic No more than 3 trigger lines can be displayed. If there are more triggers then the triggers with lower severity are prioritized for display. If graph height is set as less than 120 pixels, no trigger will be displayed in the legend. ::: ##### Предпросмотр графика На вкладке *Предпросмотр (Preview)* отображается предпросмотр графика, так что вы сразу сможете увидеть, что создаёте. {width="600"} Обратите внимание, что предварительный просмотр не будет отображать какие-либо данные по элементам данных из шаблона. {width="600"} В этом примере, обратите внимание на жирную пунктирную линию, которая отображает уровень триггера, и на информацию о триггере, которая отображается в легенде. ::: noteclassic Отображается не более 3 линий триггеров. Если триггеров больше, приоритет отображения отдается триггерам с более низкой важностью. Если высота графика меньше 120 пикселей, то триггеры в легенде к графику отображаться не будут. ::: # 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: {width="600"} {width="600"} A summary of our discovery rule: {width="600"} #### Прототипы графиков Следующий снимок экрана иллюстрирует, как мы можем использовать эти макросы в прототипах графиков: {width="600"} {width="600"} Общий вид нашего правила обнаружения: {width="600"} # 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 (дублирование данных, отсутствие данных и т.п.). ##### Агрегирование в виде суммы При использовании [агрегирования в виде суммы](/manual/config/visualization/graphs/aggregate#настройка) в графике за период менее одного часа, графики отображают некорректные (размноженные) значения, когда данные поступают из динамики изменений. ##### Наложение текста Для некоторых языков веб-интерфейса (например, японского), местные шрифты могут приводить к наложению текста в легенде графика. Чтобы избежать этого, используйте версию 2.3.0 (или более позднюю) расширения PHP GD. ##### 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.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.| ### Соединение с группой Объект соединения с группой связывает прототип узлов сети с группой узлов сети и имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |**groupid**<br>(обязательное)|строка|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.| ### Прототип Группы Объект прототипа группы определяет группу, которая будет создана для обнаруженного узла, и обладает следующими свойствами. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |group\_prototypeid|строка|*(только для чтения)* ID прототипа группы.| |**name**<br>(required)|строка| Название прототипа группы.| |hostid|строка|*(только для чтения)* ID прототипа узла сети.| |templateid|строка|*(только для чтения)* 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. #### Проверка модема GSM для способа оповещений SMS При настройке способа оповещений 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. #### Авторизация гостевого пользователя Автоматический вход в систему для гостевого пользователя (guest) удалён. После этого изменения гостевому пользователю необходимо будет входить в систему, как любому другому пользователю. Ранее гость мог сразу попасть практически на любую страницу мониторинга или отчётности, не проходя авторизацию. #### GUI debugging Problems related to the frontend performance may be diagnosed using the frontend [debug mode](/manual/web_interface/debug_mode). #### Отладка GUI Проблемы связанные с производительностью веб-интерфейса можно диагностировать при помощи [режима отладки](/ru/manual/web_interface/debug_mode) веб-интерфейса. #### GUI This section provides customization of several frontend-related defaults.  Configuration parameters: |Parameter|Description| |--|--------| |*Default language*|Default language for users who have not specified a language in their profiles and guest users.<br>For more information, see [Installation of additional frontend languages](/manual/appendix/install/locales).| |*Default time zone*|Default [time zone](/manual/web_interface/time_zone#overview) for users who have not specified a time zone in their profiles and guest users.| |*Default theme*|Default theme for users who have not specified a theme in their profiles and guest users.| |*Limit for search and filter results*|Maximum amount of elements (rows) that will be displayed in a web-interface list, for example, in *Configuration > Hosts*.<br>*Note*: If set to, for example, '50', only the first 50 elements will be displayed in all affected frontend lists. If some list contains more than fifty elements, the indication of that will be the '+' sign in *"Displaying 1 to 50 of **50+** found"*. Also, if filtering is used and still there are more than 50 matches, only the first 50 will be displayed.<br>Note that increasing the value of this parameter may lead to decreased performance and increased memory consumption on the web server side.| |*Max number of columns<br>and rows in overview tables*|Maximum number of columns and rows to display in Data overview and Trigger overview dashboard widgets. The same limit applies to both columns and rows. If more rows and/or columns than shown exist, the system will display a warning at the bottom of the table: "Not all results are displayed. Please provide more specific search criteria."| |*Max count of elements<br>to show inside table cell*|For entries that are displayed in a single table cell, no more than configured here will be shown.| |*Show warning if Zabbix server is down*|This parameter enables a warning message to be displayed in a browser window if the Zabbix server cannot be reached (possibly down). The message remains visible even if the user scrolls down the page. When hovered over, the message is temporarily hidden to reveal the contents underneath it.<br>This parameter is supported since Zabbix 2.0.1.| |*Working time*|This system-wide parameter defines working hours. In graphs, working time is displayed as a white background and non-working time is displayed as gray.<br>See [Time period specification](/manual/appendix/time_period) page for description of the time format.<br>[User macros](/manual/config/macros/user_macros) are supported (since Zabbix 3.4.0).| |*Show technical errors*|If checked, all registered users will be able to see technical errors (PHP/SQL). If unchecked, the information is only available to [Zabbix Super Admins](/manual/web_interface/frontend_sections/administration/users#users-1) and users belonging to the user groups with enabled [debug mode](/manual/web_interface/debug_mode).| |*Max history display period*|Maximum time period for which to display historical data in *Monitoring > Latest data*, host [web scenario](/manual/web_interface/frontend_sections/monitoring/hosts/web) information in *Monitoring > Hosts*, and in the *Data overview* dashboard widget.<br>Allowed range: 24 hours (default) - 1 week. [Time suffixes](/manual/appendix/suffixes), e.g. 1w (one week), 36h (36 hours), are supported.| |*Time filter default period*|Time period to be used in graphs and dashboards by default. Allowed range: 1 minute - 10 years (default: 1 hour).<br>[Time suffixes](/manual/appendix/suffixes), e.g. 10m (ten minutes), 5w (five weeks), are supported.<br>Note: when a user changes the time period while viewing a graph, this time period is stored as user preference, replacing the global default or a previous user selection.| |*Max period for time selector*|Maximum available time period for graphs and dashboards. Users will not be able to visualize older data. Allowed range: 1 year - 10 years (default: 2 years).<br>[Time suffixes](/manual/appendix/suffixes), e.g. 1y (one year), 365w (365 weeks), are supported.| #### Веб-интерфейс Эта страница содержит некоторые настройки умолчаний, связанных с веб-интерфейсом.  Параметры настроек: |Параметр|Описание| |--|--------| |*Язык по умолчанию*<br>*(Default language)*|Язык по умолчанию для пользователей, которые не указали язык в своих профилях, и гостевых пользователей.<br>Дополнительную информацию см. в разделе [Установка дополнительных языков веб-интерфейса](/manual/appendix/install/locales).| |*Часовой пояс по умолчанию*<br>*(Default time zone)*|[Часовой пояс](/manual/web_interface/time_zone#обзор) по умолчанию для пользователей, которые не указали часовой пояс в своих профилях, и гостевых пользователей.| |*Тема по умолчанию*<br>*(Default theme)*|Тема по умолчанию для пользователей, которые не указали тему в своих профилях, и гостевых пользователей.| |*Лимит элементов в результатах поиска и фильтрах*<br>*(Limit for search and filter results)*|Максимальное количество элементов (строк), которые будут отображаться в списках веб-интерфейса, например: *Настройка → Узлы сети (Configuration → Hosts)*.<br>*Примечание*: Если значение равно, например, «50», то будут отображаться только первые 50 элементов во всех затронутых списках веб-интерфейса. Если какие-нибудь списки содержат больше пятидесяти элементов, тогда такое превышение будет указываться знаком «+» в *Отображено с 1 по 50 из **50+** найденных*. Также, если используется фильтрация и имеется более 50 совпадений, то отобразятся только первые 50 совпадений.<br>Обратите внимание, что увеличение значения этого параметра может приводить к ухудшению производительности и увеличению потребления памяти на стороне веб-сервера.| |*Макс. количество колонок<br>и строк в таблицах обзора*<br>*(Max number of columns<br>and rows in overview tables)*|Максимальное количество столбцов и строк, которое будет отображаться в виджетах панели *Обзор данных (Data overview)* и *Обзор триггеров (Trigger overview)*. Один и тот же лимит применяется и к столбцам, и к строкам. Если существует больше строк и/или столбцов, чем показано, система отобразит предупреждение внизу таблицы: «Отображаются не все результаты. Укажите более конкретные критерии поиска».| |*Макс. количество элементов<br>отображаемое в ячейке таблицы*<br>*Max count of elements<br>to show inside table cell*|Для объектов, которые отображаются в одной ячейке таблицы, отображать не более, чем задано этим параметром.| |*Показывать предупреждение, если Zabbix сервер недоступен*<br>*(Show warning if Zabbix server is down)*|Этот параметр включает показ предупреждающего сообщения, если не удаётся «достучаться» до Zabbix сервера (возможно, выключенного). Сообщение остаётся на экране, даже если пользователь прокрутил страницу вниз. При наведении на сообщение курсора мыши оно временно исчезает, чтобы можно было увидеть содержимое под сообщением.<br>Этот параметр поддерживается с версии Zabbix 2.0.1.| |*Рабочее время*<br>*(Working time)*|Этот общесистемный параметр определяет часы работы. На графиках рабочее время отображается белым фоном, а нерабочее время — серым.<br>Описание формата времени смотрите на странице [Настройка периодов времени](/manual/appendix/time_period).<br>Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros) (с версии Zabbix 3.4.0).| |*Отображение технических ошибок*<br>*(Show technical errors)*|Если этот флажок установлен, все зарегистрированные пользователи смогут видеть технические ошибки (PHP/SQL). Если не установлен, информация будет доступна только [Супер-администраторам Zabbix](/manual/web_interface/frontend_sections/administration/users#пользователи-1) и пользователям, принадлежащим к группам пользователей с активированным [режимом отладки](/manual/web_interface/debug_mode).| |*Максимальный период отображения истории*<br>*(Max history display period)*|Наибольший период времени, для которого отображать данные истории в подразделах *Мониторинг → Последние данные (Monitoring → Latest data)*, информации [веб-сценариев](/manual/web_interface/frontend_sections/monitoring/hosts/web) узлов сети в *Мониторинг → Узлы сети (Monitoring → Hosts)*, а также в виджете панели *Обзор данных (Data overview)*.<br>Допустимый диапазон: 24 часа (по умолчанию) — 1 неделя. Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например: 1w (одна неделя), 36h (36 часов).| |*Период фильтра времени по умолчанию*<br>*(Time filter default period)*|Период времени, используемый по умолчанию в графиках и панелях. Допустимый диапазон: 1 минута — 10 лет (по умолчанию: 1 час).<br>Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например: 10m (десять минут), 5w (пять недель).<br>Примечание: когда пользователь меняет период времени при просмотре графика, этот период времени сохраняется в качестве предпочтений пользователя, заменяя глобальное значение по умолчанию или предыдущий выбор пользователя.| |*Макс. период селектора периода времени*<br>*(Max period for time selector)*|Наибольший доступный период времени для графиков и панелей. Пользователи не смогут визуализировать более старые данные. Допустимый диапазон: 1 год — 10 лет (по умолчанию: 2 года).<br>Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например: 1y (один год), 365w (365 недель).| ### 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) ### Обработка NaN значений в предобработке Prometheus Появилось новое поведение при обработке (пропуске) значений NaN. Таким образом, если набор данных состоит из допустимых числовых значений и NaN значений, тогда значения NaN пропускаются и: - 'avg', 'max', 'min', 'sum' возвращают результат, который вычисляется из допустимых значений - 'count' возвращает количество допустимых значений Если все значения набора данных являются NaN значениями, ктогда 'avg', 'max', 'min' и 'sum' вернет ошибку "нет данных (требуется по крайней мере одно значение)", тогда как 'count' вернет 0. Ранее, если NaN было первым значением в наборе данных, то: - 'avg', 'max', 'min', 'sum' возвращали ошибку "Value "NAN" of type "string" is not suitable for \ value type "Numeric (float)"" - '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, то элемент данных переходит в НЕПОДДЕРЖИВАЕМОЕ состояние с сообщением об ошибке. Для продолжения мониторинга журнального элемента данных регулярное выражение необходимо исправить. Если регулярное выражение компилируется успешно, но даёт сбой во время выполнения (на некоторых или на всех записях файла журнала), то журнальный элемент данных остаётся поддерживаемым и мониторинг продолжается. Ошибка времени выполнения добавляется в файл журнала Zabbix агента (без исходной журнальной записи). Обратите внимание, что запись ошибок времени выполнения при обработке регулярных выражений поддерживается с версии Zabbix 6.0.21. Частота добавления в журнал ограничена одной ошибкой времени выполнения на одну проверку, чтобы дать возможность Zabbix агенту контролировать свой собственный файл журнала. Например, если анализируется 10 записей и 3 из них вызывают ошибки времени выполнения, связанные с регулярным выражениями, то в файл журнала агента будет добавлена одна запись. Исключение: если MaxLinesPerSecond=1 и интервал обновления=1 (на каждую проверку разрешено анализировать только одну запись), то ошибки времени выполнения при обработке регулярных выражений вообще не пишутся. В случае ошибок времени выполнения zabbix_agentd записывает в файл журнала ключ элемента данных, а zabbix_agent2 записывает ID элемента данных, чтобы помочь идентифицировать, какой их элементов данных имеет ошибки времени выполнения. В случае ошибок времени выполнения рекомендуется переделать регулярное выражение. # hanode.get # hanode.get #### 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 (производительность IDE дисков может быть значительно улучшена с помощью утилиты hdparm) и SATA - 15К RPM лучше чем 10К, которые в свою очередь лучше чем 7200 RPM - используйте быстрое RAID хранилище - используйте быстрый Ethernet адаптер - большее количество ОЗУ всегда лучше **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**\[=*цель*\] Удалить из кластера высокой доступности (HA) ноду, указанную по своему имени или ID. Обратите внимание, что активные/резервные ноды удалить нельзя. **ha\_set\_failover\_delay**\[=*задержка*\] Изменить задержку автоматического переключения кластера высокой доступности (HA). Поддерживаются суффиксы времени, например: 10s, 1m. **secrets\_reload** Заново загрузить секреты из Хранилища. **service\_cache\_reload** Обновить кэш менеджера услуг. **prof\_enable**\[=*цель*\] Включить профилирование. Если цель не указана, то влияет на все процессы. Включённое профилирование предоставляет подробности всех блокировок на чтение/запись и мьютексов по имени функции. Поддерживается с версии Zabbix 6.0.13. **prof\_disable**\[=*цель*\] Выключить профилирование. Если цель не указана, то влияет на все процессы. Поддерживается с версии Zabbix 6.0.13. **log\_level\_increase**\[=*цель*\] Повысить уровень журналирования; если цель не указана, то влияет на все процессы. **log\_level\_decrease**\[=*цель*\] Понизить уровень журналирования; если цель не указана, то влияет на все процессы. [ ]{#lbAG} ##### HDD/flash image (raw) dd if=./zabbix_appliance_5.2.0.raw of=/dev/sdc bs=4k conv=fdatasync Replace */dev/sdc* with your Flash/HDD disk device. ##### HDD/flash образ (raw) dd if=./zabbix_appliance_5.2.0.raw of=/dev/sdc bs=4k conv=fdatasync Замените */dev/sdc* на ваше Flash/HDD устройство. #### 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 файла может обрабатываться двумя разными способами: - Если флажок *Со строкой заголовка* отмечен — значения строки заголовка интерпретируются как имена столбцов. В этом случае имена столбцов должны быть уникальны и строки с данными не должны содержать больше столбцов, чем строка заголовка; - Если флажок *Со строкой заголовка* не отмечен — строка заголовка интерпретируется как данные. Имена столбцов генерируются автоматически (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. ##### Скрытое меню Даже когда меню полностью скрыто, доступ к нему можно получить всего одним щелчком мыши. Нажмите на иконку меню (так называемый «гамбургер»), чтобы открыть меню. Обратите внимание, что меню появляется поверх содержимого страницы; чтобы переместить содержимое страницы вправо, измените режим отображения меню, нажав на кнопку отображения боковой панели рядом с логотипом Zabbix. #### 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> ``` #### Скрытие файла со списком распространённых паролей Для повышения сложности атак методом перебора пароля, рекомендуется ограничить доступ к файлу `ui/data/top_passwords.txt`, изменив конфигурацию веб-сервера. В данном файле находится список самых распространённых и контекстно-зависимых паролей, используемый для ограничения возможности пользователей от использования подобных паролей в случае, если параметр *Избегать легко угадываемых паролей* включён в [политике паролей](/manual/web_interface/frontend_sections/administration/authentication#внутренняя-аутентификация). Например, в NGINX доступ к файлу может быть ограничен при помощи директивы `location`: ```ini location = /data/top_passwords.txt { deny all; return 404; } ``` В Apache - используя файл `.htacess`: ```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> ​ #### Скрытие файла со списком общих паролей Для повышения сложности атак методом перебора пароля, рекомендуется ограничить доступ к файлу `ui/data/top_passwords.txt` при помощи изменения конфигурации веб-сервера. В данном файле находится список самых распространённых и контексто-зависимых паролей, используемый для ограничения возможности пользователей от использования подобных паролей в случае если параметр *Избегать легко угадываемых паролей* включен в [политике паролей](/manual/web_interface/frontend_sections/administration/authentication#внутренняя_аутентификация). Например, в NGINX доступ к файлу может быть ограничен с помощью директивы `location`: location = /data/top_passwords.txt {​​​​​​​ deny all; return 404; }​​​​​​​ В Apache с использованием файла `.htacess`: <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 сервера Новая версия привносит встроенное решение высокой доступности для Zabbix сервера. Решение состоит из нескольких zabbix\_server экземпляров или нод, где в один момент времени активной (под нагрузкой) может быть только одна нода, в то время как остальные ноды будут резервными, готовыми взять на себя нагрузку в случае, когда текущая нода остановится или откажет. Смотрите также: [Кластер высокой доступности](/manual/concepts/server/ha). #### High availability cluster Retrieve a list of server nodes and their status. [High availability cluster API](/manual/api/reference/hanode) #### Кластер высокой доступности Получить список серверных узлов и их статус. [API кластера высокой доступности](/manual/api/reference/hanode) #### High availability nodes If [high availability cluster](/manual/concepts/server/ha) is enabled, then another block of data is displayed with the status of each high availability node. {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Node name, as defined in server configuration.| |*Address*|Node IP address and port.| |*Last access*|Time of node last access.<br>Hovering over the cell shows the timestamp of last access in long format.| |*Status*|Node status:<br>**Active** - node is up and working<br>**Unavailable** - node hasn't been seen for more than failover delay (you may want to find out why)<br>**Stopped** - node has been stopped or couldn't start (you may want to start it or delete it)<br>**Standby** - node is up and waiting| #### Ноды кластера высокой доступности Если активирован [кластер высокой доступности](/manual/concepts/server/ha), то отображается дополнительный блок данных с состоянием каждой ноды кластера. {width="600"} Отображаемые данные: |Столбец|Описание| |--|--------| |*Имя (Name)*|Имя ноды, как определено в конфигурации сервера.| |*Адрес (Address)*|IP адрес и порт ноды.| |*Последний доступ*<br>*(Last access)*|Время последнего доступа ноды.<br>При наведении мышью на ячейку отобразится отметка времени последнего доступа в длинном формате.| |*Состояние*<br>*(Status)*|Состояние ноды:<br>**Активен (Active)** — нода поднята и в работе<br>**Недоступен (Unavailable)** — нода не была видна дольше, чем время переключения при отказе (возможно, вы захотите узнать причины)<br>**Остановлен (Stopped)** — нода была остановлена либо не смогла запуститься (возможно, вы захотите её запустить или удалить)<br>**Резервный (Standby)** — Нода поднята и находится в состоянии ожидания| # 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 for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - 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>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<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 for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - 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>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<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**. countunique() 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 for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - 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>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<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 (clock of value collection) is less than or equal to *sec* 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(/host/key) is always equal to last(/host/key,\#1)<br>last(/host/key,\#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 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);<br><br>nodata() function cannot be used in the expression by itself; at least one function from [another group](/manual/appendix/functions), referencing the host item, must be included in the expression (except [date and time functions](/manual/appendix/functions/time)). For detailed information on how the nodata() function works within expressions, see [Calculation time](/manual/config/triggers#calculation-time).| |**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.| #### Функции истории |ФУНКЦИЯ|<|<| |--|--|--| |**Описание**|**Параметры, специфичные для функции**|**Комментарии**| |**change** (/узел_сети/ключ)|<|<| |Величина разницы между последним и предыдущим значениями.| |Поддерживаемые типы значений: float, int, str, text, log<br><br>Для строк возвращается:<br>0 — значения равны<br>1 — значения отличаются<br><br>Пример:<br>=> **change**(/узел_сети/ключ)>10<br><br>Разница между числовыми значениями будет вычисляться, как показано на примере следующих значений («предыдущее» и «последнее» значение = разница):<br>«1» и «5» = `+4`<br>«3» и «1» = `-2`<br>«0» и «-2.5» = `-2.5`<br><br>Смотрите также: [abs](/manual/appendix/functions/math) для сравнения| |**changecount** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>,<режим>)|<|<| |Количество изменений между соседними значениями за определённый период вычисления.|Смотрите [общие параметры](#общие-параметры).<br><br>**режим** (опционально; должен быть в двойных кавычках)<br><br>Поддерживаются `режимы`:<br>*all* — считать все изменения (по умолчанию)<br>*dec* — считать убывания значений<br>*inc* — считать возрастания значений|Поддерживаемые типы значений: float, int, str, text, log<br><br>Для нечисловых типов значений параметр *режим* игнорируется.<br><br>Примеры:<br>=> **changecount**(/узел_сети/ключ, 1w) → количество изменений значения за последнюю неделю до [текущего момента](/manual/config/triggers#период-вычисления)<br>=> **changecount**(/узел_сети/ключ,\#10,"inc") → количество возрастаний значений (относительно соседнего значения) среди последних 10 значений<br>=> **changecount**(/узел_сети/ключ,24h,"dec") → количество убываний значений (относительно соседнего значения) за последние 24 часа до [текущего момента](/manual/config/triggers#период-вычисления)| |**count** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>,<оператор>,<шаблон>)|<|<| |Количество значений за определённый период вычисления.|Смотрите [общие параметры](#общие-параметры).<br><br>**оператор** (опционально; должен быть в двойных кавычках)<br><br>Поддерживаются `операторы`:<br>*eq* — равно (по умолчанию для integer и float)<br>*ne* — не равно<br>*gt* — больше, чем<br>*ge* — больше или равно<br>*lt* — меньше, чем<br>*le* — меньше или равно<br>*like* (по умолчанию для элементов данных символ, текст и журнал (лог)) — содержит подстроку шаблона (чувствительно к регистру)<br>*bitand* — побитовое И<br>*regexp* — чувствительное к регистру соответствие регулярному выражению, данному в `шаблоне`<br>*iregexp* — нечувствительное к регистру соответствие регулярному выражению, данному в `шаблоне`<br><br>Примечание:<br>*eq* (по умолчанию), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* поддерживаются для целочисленных элементов данных<br>*eq* (по умолчанию), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* поддерживаются для элементов данных с плавающей точкой<br>*like* (по умолчанию), *eq*, *ne*, *regexp*, *iregexp* поддерживаются для элементов данных символ, текст и журнал (лог)<br><br>**шаблон** (опционально) — искомый шаблон (строковые аргументы должны быть в двойных кавычках)|Поддерживаемые типы значений: float, integer, string, text, log<br><br>Элементы данных с плавающей точкой совпадают с точностью 2.22e-16; если база данных [не обновлена](https://www.zabbix.com/documentation/5.0/ru/manual/installation/upgrade_notes_500#включение-расширенного-диапазона-числовых-значений-с-плавающей-точкой), то точность составляет 0.000001.<br><br>Если третий параметр *bitand*, то четвёртый параметр `шаблон` может быть указан как два числа, разделённых косой чертой («/»): **число\_для\_сравнения/маска**. count() вычисляет «побитовое И» из значения и *маски* и сравнивает результат с *числом\_для\_сравнения*. Если результат «побитового И» равен *числу\_для\_сравнения*, то значение считается.<br>Если *число\_для\_сравнения* и *маска* равны, требуется указывать только *маску* (без «/»).<br><br>Если третий параметр *regexp* или *iregexp*, то четвёртый параметр `шаблон` может быть обычным или [глобальным](/manual/regular_expressions#глобальные-регулярные-выражения) (начинающимся с «@») регулярным выражением. В случае глобальных регулярных выражений чувствительность к регистру наследуется из настроек глобального регулярного выражения. При проверке соответствия регулярному выражению, значения с плавающей точкой всегда будут представлены с 4 цифрами после десятичной точки («.»). Также обратите внимение, что для больших чисел различие между десятичным (хранящимся в базе данных) и двоичным (используемом сервером Zabbix) представлениями может повлиять на 4-ю десятичную цифру.<br><br>Примеры:<br>=> **count**(/узел_сети/ключ,**10m**) → количество значений за последние 10 минут до [текущего момента](/manual/config/triggers#период-вычисления)<br>=> **count**(/узел_сети/ключy,**10m**,"like","error") → количество значений за последние 10 минут до [текущего момента](/manual/config/triggers#период-вычисления), которые содержат «error»<br>=> **count**(/узел_сети/ключ,**10m**,,12) → количество значений за последние 10 минут до [текущего момента](/manual/config/triggers#период-вычисления), которые равны «12»<br>=> **count**(/узел_сети/ключ,**10m**,"gt",12) → количество значений за последние 10 минут до [текущего момента](/manual/config/triggers#период-вычисления), превышающих «12»<br>=> **count**(/узел_сети/ключ,**\#10**,"gt",12) → количество значений среди 10 последних значений до [текущего момента](/manual/config/triggers#период-вычисления), которые больше чем «12»<br>=> **count**(/узел_сети/ключ,**10m:now-1d**,"gt",12) → количество значений за период между (24 часа и 10 минут назад) и (24 часа назад) от [текущего момента](/manual/config/triggers#период-вычисления), которые превышают «12»<br>=> **count**(/узел_сети/ключ,**10m**,"bitand","6/7") → количество значений за последние 10 минут до [текущего момента](/manual/config/triggers#период-вычисления), у которых в двоичном представлении последние три значащих бита равны «110».<br>=> **count**(/узел_сети/ключ,**10m:now-1d**) → количество значений за период между (24 часа и 10 минут назад) и (24 часа назад) от [текущего момента](/manual/config/triggers#период-вычисления)| |**countunique** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>,<оператор>,<шаблон>)|<|<| |Количество уникальных значений за определённый период вычисления.|Смотрите [общие параметры](#общие-параметры).<br><br>**оператор** (опционально; должен быть в двойных кавычках)<br><br>Поддерживаются `операторы`:<br>*eq* — равно (по умолчанию для integer и float)<br>*ne* — не равно<br>*gt* — больше, чем<br>*ge* — больше или равно<br>*lt* — меньше, чем<br>*le* — меньше или равно<br>*like* (по умолчанию для string, text и log) — значение содержит подстроку, заданную в `шаблоне` (с учётом регистра)<br>*bitand* — побитовое И<br>*regexp* — чувствительное к регистру соответствие регулярному выражению, данному в `шаблоне`<br>*iregexp* — нечувствительное к регистру соответствие регулярному выражению, данному в `шаблоне`<br><br>Примечание:<br>*eq* (по умолчанию), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* поддерживаются для целочисленных элементов данных<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* поддерживаются для элементов данных с плавающей точкой<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* поддерживаются для элементов данных символ, текст и журнал (лог)<br><br>**шаблон** (опционально) — искомый шаблон (строковые аргументы должны быть в двойных кавычках)|Поддерживаемые типы значений: float, integer, string, text, log<br><br>Элементы данных с плавающей точкой совпадают с точностью 2.22e-16; если база данных [не обновлена](https://www.zabbix.com/documentation/5.0/ru/manual/installation/upgrade_notes_500#включение-расширенного-диапазона-числовых-значений-с-плавающей-точкой), то точность составляет 0.000001.<br><br>Если третий параметр *bitand*, то четвёртый параметр `шаблон` может быть указан как два числа, разделённых косой чертой («/»): **число\_для\_сравнения/маска**. countunique() вычисляет «побитовое И» из значения и *маски* и сравнивает результат с *числом\_для\_сравнения*. Если результат «побитового И» равен *числу\_для\_сравнения*, то значение считается.<br>Если *число\_для\_сравнения* и *маска* равны, требуется указывать только *маску* (без «/»).<br><br>Если третий параметр *regexp* или *iregexp*, то четвёртый параметр `шаблон` может быть обычным или [глобальным](/manual/regular_expressions#глобальные-регулярные-выражения) (начинающимся с «@») регулярным выражением. В случае глобальных регулярных выражений чувствительность к регистру наследуется из настроек глобального регулярного выражения. При проверке соответствия регулярному выражению, значения с плавающей точкой всегда будут представлены с 4 цифрами после десятичной точки («.»). Также обратите внимение, что для больших чисел различие между десятичным (хранящимся в базе данных) и двоичным (используемом сервером Zabbix) представлениями может повлиять на 4-ю десятичную цифру.<br><br>Примеры:<br>=> **countunique**(/узел_сети/ключ,**10m**) → количество уникальных значений за последние 10 минут до [текущего момента](/manual/config/triggers#период-вычисления)<br>=> **countunique**(/узел_сети/ключ,**10m**,"like","error") → количество уникальных значений за последние 10 минут до [текущего момента](/manual/config/triggers#период-вычисления), которые содержат «error»<br>=> **countunique**(/узел_сети/ключ,**10m**,"gt",12) → количество уникальных значений за последние 10 минут до [текущего момента](/manual/config/triggers#период-вычисления), превышающих «12»<br>=> **countunique**(/узел_сети/ключ,**\#10**,"gt",12) → количество уникальных значений среди 10 последних значений до [текущего момента](/manual/config/triggers#период-вычисления), которые больше чем «12»<br>=> **countunique**(/узел_сети/ключ,**10m:now-1d**,"gt",12) → количество уникальных значений за период между (24 часа и 10 минут назад) и (24 часа назад) от [текущего момента](/manual/config/triggers#период-вычисления), которые превышают «12»<br>=> **countunique**(/узел_сети/ключ,**10m**,"bitand","6/7") → количество уникальных значений за последние 10 минут до [текущего момента](/manual/config/triggers#период-вычисления), у которых в двоичном представлении последние три значащих бита равны «110».<br>=> **countunique**(/узел_сети/ключ,**10m:now-1d**) → количество уникальных значений за период между (24 часа и 10 минут назад) и (24 часа назад) от [текущего момента](/manual/config/triggers#период-вычисления)| |**find** (/узел_сети/ключ,<(сек\|\#число)<:сдвиг_времени>>,<оператор>,<шаблон>)|<|<| |Поиск соответствующего значения.|Смотрите [общие параметры](#общие-параметры).<br><br>**сек** или **\#число** (опционально) — если не указано, то по умолчанию проверяется последнее значение<br><br>**оператор** (опционально; должен быть заключён в двойные кавычки)<br><br>Поддерживаются `операторы`:<br>*eq* — равно (по умолчанию для integer и float)<br>*ne* — не равно<br>*gt* — больше<br>*ge* — больше или равно<br>*lt* — меньше<br>*le* — меньше или равно<br>*like* (по умолчанию для string, text и log) — значение содержит подстроку, заданную в `шаблоне` (с учётом регистра)<br>*bitand* — побитовое И<br>*regexp* — чувствительное к регистру соответствие регулярному выражению, данному в `шаблоне`<br>*iregexp* — нечувствительное к регистру соответствие регулярному выражению, данному в `шаблоне`<br><br>Примечание:<br>*eq* (по умолчанию), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* поддерживаются для целочисленных элементов данных<br>*eq* (по умолчанию), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* поддерживаются для элементов данных с плавающей точкой<br>*like* (по умолчанию), *eq*, *ne*, *regexp*, *iregexp* поддерживаются для элементов данных символ, текст и журнал (лог)<br><br>**шаблон** — искомый шаблон (строковые аргументы должны быть в двойных кавычках); регулярное выражение [Perl Compatible Regular Expression](https://ru.wikipedia.org/wiki/PCRE) (PCRE) если `оператор` — *regexp* или *iregexp*.|Поддерживаемые типы значений: float, int, str, text, log<br><br>Возвращает:<br>1 — найдено<br>0 — в противном случае<br><br>Если обрабатывается более одного значения, «1» возвращается, если имеется по крайней мере одно совпадающее значение.<br><br>С третьим параметром *regexp* или *iregexp*, четвёртый параметр `шаблон` может быть обычным или [глобальным](/manual/regular_expressions#глобальные-регулярные-выражения) (начинающимся с «@») регулярным выражением. В случае глобальных регулярных выражений чувствительность к регистру наследуется из настроек глобального регулярного выражения.<br><br>Пример:<br>=> **find**(/узел_сети/ключ,**10m**,"like","error") → найти значение, содержащее «error» за последние 10 минут до [текущего момента](/manual/config/triggers#период-вычисления)| |**first** (/узел_сети/ключ,сек<:сдвиг_времени>)|<|<| |Первое (самое старое) значение за указанный период вычисления.|Смотрите [общие параметры](#общие-параметры).|Поддерживаемые типы значений: float, int, str, text, log<br><br>Пример:<br>=> **first**(/узел_сети/ключ,**1h**) → извлечь самое старое значение за последний час вплоть до [текущего момента](/manual/config/triggers#период-вычисления)<br><br>Смотрите также last().| |**fuzzytime** (/узел_сети/ключ,сек)|<|<| |Проверка того, насколько время пассивного агента отличается от времени Zabbix сервера/прокси.|Смотрите [общие параметры](#общие-параметры).|Поддерживаемые типы значений: float, int<br><br>Возвращает:<br>1 — если разница между значением пассивного элемента данных (как штампа времени) и штампом времени Zabbix сервера/прокси (временем получения значения) меньше или равна `сек` секунд<br>0 — в противном случае<br><br>Обычно используется с «system.localtime» для проверки, что локальное время синхронизировано с локальным временем Zabbix сервера. *Обратите внимание*, что «system.localtime» должно быть настроено как [пассивная проверка](/manual/appendix/items/activepassive#пассивные-проверки).<br>Также можно использовать с ключом vfs.file.time\[/путь/файл,modify\] для проверки, что файл не обновлялся длительное время.<br><br>Пример:<br>=> **fuzzytime**(/узел_сети/ключ,**60s**)=0 → обнаружение проблемы, если разница во времени превышает 60 секунд<br><br>Эту функцию не рекомендуется использовать в сложных триггерных выражениях (с участием нескольких элементов данных), поскольку это может привести к непредвиденным результатам (разница по времени будет считаться по наиболее свежей метрике), например, в таком: `fuzzytime(/узел_сети/system.localtime,60s)=0 or last(/узел_сети/trap)<>0`| |**last** (/узел_сети/ключ,<\#число<:сдвиг_времени>>)|<|<| |Самое новое значение.|Смотрите [общие параметры](#общие-параметры).<br><br>**\#число** (опционально) — N-ое значение из самых новых|Поддерживаемые типы значений: float, int, str, text, log<br><br>Обратите внимание, что \#число (с решёткой, \#N) здесь работает иначе, чем во многих других функциях.<br>Например:<br>last(/узел_сети/ключ) всегда идентичен last(/узел_сети/ключ,\#1)<br>last(/узел_сети/ключ,\#3) — третье из самых новых значение (*не* три последних значения)<br><br>Zabbix не гарантирует точный порядок значений, если в истории существует более двух значений за одну секунду.<br><br>Пример:<br>=> **last**(/узел_сети/ключ) → извлечь последнее значение<br>=> **last**(/узел_сети/ключ,**\#2**) → извлечь предыдущее значение<br>=> **last**(/узел_сети/ключ,**\#1**) <> **last**(/узел_сети/ключ,**\#2**) → последнее значение отличается от предыдущего<br><br>Смотрите также first().| |**logeventid** (/узел_сети/ключ,<\#число<:сдвиг_времени>>,<шаблон>)|<|<| |Проверка, соответствует ли указанному регулярному выражению идентификатор события последней записи из журнала.|Смотрите [общие параметры](#общие-параметры).<br><br>**\#число** (опционально) — N-ое из наиболее недавних значений<br><br>**шаблон** (опционально) — регулярное выражение, описывающее нужный шаблон, в формате [Perl Compatible Regular Expression](https://ru.wikipedia.org/wiki/PCRE) (PCRE) (строковые аргументы должны быть заключены в двойные кавычки).|Поддерживаемые типы значений: log<br><br>Возвращает:<br>0 — нет соответствия<br>1 — соответствует| |**logseverity** (/узел_сети/ключ,<\#число<:сдвиг_времени>>)|<|<| |Важность события последней записи в журнале.|Смотрите [общие параметры](#общие-параметры).<br><br>**\#число** (опционально) — N-ое из наиболее недавних значений|Поддерживаемые типы значений: log<br><br>Возвращает:<br>0 — важность по умолчанию<br>N — важность (целое число, полезно для журналов событий Windows: 1 — Уведомление, 2 — Предупреждение, 4 — Ошибка, 7 — Аудит отказов, 8 — Аудит успехов, 9 — Критическая ошибка, 10 — Детали).<br>Zabbix берёт важность журнала из поля **Информация** журнала событий Windows.| |**logsource** (/узел_сети/ключ,<\#число<:сдвиг_времени>>,<шаблон>)|<|<| |Проверка, соответствует ли регулярному выражению источник последней записи в журнале.|Смотрите [общие параметры](#общие-параметры).<br><br>**\#число** (опционально) — N-ое из наиболее недавних значений<br><br>**шаблон** (опционально) — регулярное выражение, описывающее нужный шаблон, в формате [Perl Compatible Regular Expression](https://ru.wikipedia.org/wiki/PCRE) (PCRE) (строковые аргументы должны быть заключены в двойные кавычки).|Поддерживаемые типы значений: log<br><br>Возвращает:<br>0 — нет соответствия<br>1 — соответствует<br><br>Обычно используется для журналов событий Windows. Например, logsource("VMware Server").| |**monodec** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>,<режим>)|<|<| |Проверка наличия монотонного убывания значений.|Смотрите [общие параметры](#общие-параметры).<br><br>**режим** (должен быть в двойных кавычках) — *weak* (каждое значение меньше или равно предыдущему; по умолчанию) или *strict* (каждое значение строго уменьшается)|Поддерживаемые типы значений: int<br><br>Возвращает 1, если все элементы в течение указанного периода времени непрерывно уменьшаются, 0 в противном случае.<br><br>Пример:<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**) — посчитать, на каком количестве узлов сети было уменьшение свободного места в области подкачки| |**monoinc** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>,<режим>)|<|<| |Проверка наличия монотонного возрастания значений.|Смотрите [общие параметры](#общие-параметры).<br><br>**режим** (должен быть в двойных кавычках) — *weak* (каждое значение больше или равно предыдущему; по умолчанию) или *strict* (каждое значение строго возрастает)|Поддерживаемые типы значений: int<br><br>Возвращает 1, если все элементы в течение указанного периода времени непрерывно возрастают, 0 в противном случае.<br><br>Пример:<br>=> **monoinc**(/Host1/system.localtime,**\#3**,"strict")=0 — проверка того, постоянно ли увеличивается локальное время системы| |**nodata** (/узел_сети/ключ,сек,<режим>)|<|<| |Проверка отсутствия полученных данных.|Смотрите [общие параметры](#общие-параметры).<br><br>**сек** период должен быть не менее 30 секунд, так как процесс синхронизации истории (history syncer) вычисляет эту функцию раз в 30 секунд.<br><br>nodata(/узел_сети/ключ,0) запрещено.<br><br>**режим** — при значении *strict* (в двойных кавычках) эта функция будет нечувствительна к доступности прокси (смотрите комментарии для более подробной информации).|Поддерживаются все типы значений.<br><br>Возвращает:<br>1 — если нет полученных данных за указанный период времени<br>0 — в противном случае<br><br>Начиная с версии Zabbix 5.0, триггеры «nodata», контролируемые прокси серверами, по умолчанию чувствительны к доступности прокси — если прокси становится недоступным, триггеры «nodata» не будут срабатывать немедленно после восстановления соединения, а пропустят данные за задержанный период. Обратите внимание, что для пассивных прокси подавление активируется если соединение восстанавливается более чем через 15 секунд и не менее чем через 2 секунды. Для активных прокси подавление активируется, если соединение восстанавливается более чем через 15 секунд.<br><br>Чтобы выключить чувствительность к доступности прокси, используйте третий параметр, например: **nodata**(/узел_сети/ключ,**5m**,**"strict"**); в этом случае функция будет работать так же, как и до версии 5.0.0, и срабатывать, как только период оценки отсутствия данных (пять минут) истечёт.<br><br>Обратите внимание, эта функция отобразит ошибку в случае, если за указанный в первом параметре период:<br>- нет данных и Zabbix сервер был перезапущен<br>- нет данных и было завершено обслуживание<br>- нет данных и элемент данных был добавлен или заново активирован<br>Ошибки отображаются в колонке *Инфо* в [настройке](/manual/web_interface/frontend_sections/configuration/hosts/triggers) триггеров.<br><br>Эта функция может работать неправильно, если есть расхождения по времени между Zabbix сервером, прокси и агентом. Смотрите также: [требования по синхронизации времени](/manual/installation/requirements#синхронизация-времени);<br><br>функция nodata() не может быть использована в выражении сама по себе; выражение должно включать как минимум одну функцию из [другой группы](/manual/appendix/functions) (за исключением [функций даты и времени](/manual/appendix/functions/time)), ссылающуюся на элемент данных узла сети. Подробную информацию о том, как функция nodata() работает в выражениях, смотрите в разделе [Время вычисления](/manual/config/triggers#время-вычисления).| |**percentile** (/узел_сети/ключ,(сек\|\#число)<:сдвиг_времени>,процент)|<|<| |P-й процентиль периода, где P (процент) указывается третьим параметром.|Смотрите [общие параметры](#общие-параметры).<br><br>**процент** — число с плавающей точкой от 0 до 100 (включительно), до 4 цифр после десятичной точки|Поддерживаемые типы значений: float, int| |**rate** (/узел_сети/ключ,сек<:сдвиг_времени>)|<|<| |Усреднённая за секунду скорость увеличения монотонно возрастающего счётчика в течение указанного периода времени.|Смотрите [общие параметры](#общие-параметры).|Поддерживаемые типы значений: float, int<br><br>Функционально соответствует функции «[rate \[en\]](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)» из PromQL.<br><br>Пример:<br>=> **rate**(/узел_сети/ключ,**30s**) → Если за 30 секунд значение монотонно возросло на 20, эта функция вернёт 0.67.| # 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, для отображения или дальнейшей обработки. [API истории](/ru/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)` ### Функция HMAC для JavaScript В подсистему JavaScript была добавлена новая функция, позволяющая вернуть хеш-сумму HMAC: - `hmac('<тип хеша>',key,string)` Это полезно в случаях, когда для подписи запросов требуется код аутентификации сообщения на основе хеш-суммы (hash-based message authentication code, 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**. #### Доступ к узлу сети с нескольких групп пользователей Пользователь может принадлежать любому числу групп пользователей. Эти группы могут иметь разные права доступа к узлам сети. Поэтому важно знать, какие узлы сети, в результате, будут доступны для непривилегированного пользователя. Например, давайте рассмотрим, как доступ к узлу сети **Х** (из Группы узлов сети 1) будет применяться в различных ситуациях для пользователей, которые состоят в группах А и В. - Если Группа пользователей А имеет только доступ на *Чтение* к Группе узлов сети 1, а Группа пользователей В имеет доступ *Чтение-Запись* к Группе узлов сети 1, то пользователь получит доступ на **Чтение-Запись** к узлу сети «Х». ::: noteimportant Право доступа «Чтение-Запись» имеет более высокий приоритет перед правом доступа «Чтение» с версии Zabbix 2.2. ::: - В таком же сценарии, как вышеописаный, если узел сети «Х» находится ещё и в Группе узлов сети 2, которая имеет право доступа **запрещено** для Групп пользователей А или В, доступ к узлу сети «Х» **будет невозможен**, несмотря на наличие прав доступа *Чтение-Запись* к Группе узлов сети 1. - Если Группа пользователей А не имеет заданных прав доступа и Группа узлов сети В имеет права доступа *Чтение-Запись* к Группе узлов сети 1, пользователь получит право доступа **Чтение-Запись** к узлу сети «Х». - Если Группа пользователей А имеет доступ *Запрещено* к Группе узлов сети 1 и Группа пользователей В имеет доступ на *Чтение-Запись* к Группе узлов сети 1, пользователь **не получит** доступа к узлу сети «Х». ##### 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. Нужно добавить интерфейс IPMI, с соответствующими IP адресом и номером порта, а также задать параметры аутентификации IPMI. Смотрите [настройку узлов сети](/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, на узел сети должны быть назначены следующие макросы: - **{$VMWARE.URL}** - URL SDK службы VMware (vCenter или ESX hypervisor) (<https://имя_сервера/sdk>). - **{$VMWARE.USERNAME}** - Имя пользователя службы VMware - **{$VMWARE.PASSWORD}** - Пароль к пользователю {$USERNAME} службы VMware ##### 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. ##### Настройка узлов сети Указать, что конкретные узлы сети должны наблюдаться через прокси, вы можете в диалоге [настройки узла сети](/manual/config/hosts/host), используя поле *Наблюдение через прокси (Monitored by proxy)*.  [Массовое обновление](/manual/config/hosts/hostupdate) узлов сети является ещё одним способом указать, что узлы сети должны наблюдаться через прокси. # host.create # host.create ##### Host creation A host is added if the *Add host* operation is selected. A host is also added, even if the *Add host* operation is missing, if you select operations resulting in actions on a host. Such operations are: - enable host - disable host - add host to a host group - link template to a host Created hosts are added to the *Discovered hosts* group (by default, configurable in *Administration* → *General* → *[Other](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). If you wish hosts to be added to another group, add a *Remove from host groups* operation (specifying "Discovered hosts") and also add an *Add to host groups* operation (specifying another host group), because a host must belong to a host group. The IP address of the discovered device is the criterion for finding a host in the system. If a host with that IP address and interface type already exists, that host will be the target for performing operations. If the IP address of the discovered host is changed or the interface is deleted, a new host will be created upon the next discovery. ##### Создание узлов сети Узел сети добавляется, если выбрана операция *Добавить узел сети*. Узел сети также добавляется, даже если операция *Добавить узел сети* пропущена, если вы выбрали операции, приводящие к действиям над узлом сети. Это такие операции, как: - активировать узел сети - деактивировать узел сети - добавить узел сети в группу узлов сети - присоединить шаблон к узлу сети Созданные узлы сети добавляются в группу *Discovered hosts* (по умолчанию, настраивается в *Администрирование* → *Общие* → *[Прочие](/manual/web_interface/frontend_sections/administration/general#прочие-параметры)*). Если вы желаете, чтобы узлы сети добавлялись в другую группу, добавьте операцию *Удалить из группы узлов сети* (укажите «Discovered hosts») и также добавьте операцию *Добавить в группу узлов сети* (укажите другую группу узлов сети), так как узел сети должен принадлежать по крайней мере одной группе узлов сети. IP-адрес обнаруженного устройства является критерием при поиске узла сети в системе. Если узел сети с таким IP-адресом и типом интерфейса уже существует, то он и будет целью для выполняемых операций. Если IP-адрес обнаруженного узла сети изменяется или интерфейс удаляется, то при следующем обнаружении будет создан новый узел сети. # 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 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.| ##### Теги графиков узла сети |Элемент|Свойство элемента|Обязательный|Тип|Диапазон^**[1](#примечания)**^|Описание| |--|--|-|--|----|--------| |graphs| |\-| | |Корневой элемент графиков.| | |name|x|`строка`| |Имя графика.| | |width|\-|`целое число`|20-65535 (по умолчанию: 900)|Ширина графика, в пикселях. Используется для предпросмотра и в круговом/расширенном графиках.| | |height|\-|`целое число`|20-65535 (по умолчанию: 200)|Высота графика, в пикселях. Используется для предпросмотра и в круговом/расширенном графиках.| | |yaxismin|\-|`дробное число`|По умолчанию: 0|Минимальное значение оси Y.<br><br>Используется, если «ymin\_type\_1» равен FIXED.| | |yaxismax|\-|`дробное число`|По умолчанию: 0|Максимальное значение оси Y.<br><br>Используется, если «ymax\_type\_1» равен FIXED.| | |show\_work\_period|\-|`строка`|0 — NO<br>1 — YES (по умолчанию)|Подсветка нерабочих часов.<br><br>Используется для обычных и стэкируемых графиков.| | |show\_triggers|\-|`строка`|0 — NO<br>1 — YES (по умолчанию)|Отображение значений простых триггеров в виде линии.<br><br>Используется для обычных и стэкируемых графиков.| | |type|\-|`строка`|0 — NORMAL (по умолчанию)<br>1 — STACKED<br>2 — PIE<br>3 — EXPLODED|Тип графика.| | |show\_legend|\-|`строка`|0 — NO<br>1 — YES (по умолчанию)|Отображение легенды графика.| | |show\_3d|\-|`строка`|0 — NO (по умолчанию)<br>1 — YES|Активация 3D стиля.<br><br>Используется для круговых и расширенных круговых графиков.| | |percent\_left|\-|`дробное число`|По умолчанию: 0|Отображение линии перцентиля для левой оси.<br><br>Используется только для обычных графиков.| | |percent\_right|\-|`дробное число`|По умолчанию: 0|Отображение линии перцентиля для правой оси.<br><br>Используется только для обычных графиков.| | |ymin\_type\_1|\-|`строка`|0 - CALCULATED (по умолчанию)<br>1 — FIXED<br>2 — ITEM|Минимальное значение оси Y.<br><br>Используется для обычных и стэкируемых графиков.| | |ymax\_type\_1|\-|`строка`|0 - CALCULATED (по умолчанию)<br>1 — FIXED<br>2 — ITEM|Максимальное значение оси Y.<br><br>Используется для обычных и стэкируемых графиков.| |ymin\_item\_1| |\-| | |Детали отдельного элемента данных.<br><br>Требуется, если «ymin\_type\_1» равно ITEM.| | |host|x|`строка`| |Узел сети элемента данных.| | |key|x|`строка`| |Ключ элемента данных.| |ymax\_item\_1| |\-| | |Детали отдельного элемента данных.<br><br>Требуется, если «ymax\_type\_1» равно ITEM.| | |host|x|`строка`| |Узел сети элемента данных.| | |key|x|`строка`| |Ключ элемента данных.| |graph\_items| |x| | |Корневой элемент элементов данных графиков.| | |sortorder|\-|`целое число`| |Порядок отрисовки. Меньшее значение отрисовывается первым. Можно использовать для отрисовки линий или регионов позади (или поверх) других.| | |drawtype|\-|`строка`|0 — SINGLE\_LINE (по умолчанию)<br>1 — FILLED\_REGION<br>2 — BOLD\_LINE<br>3 — DOTTED\_LINE<br>4 — DASHED\_LINE<br>5 — GRADIENT\_LINE|Стиль отрисовки элемента данных графика.<br><br>Используется только для обычных графиков.| | |color|\-|`строка`| |Цвет элемента (6 символов, hex).| | |yaxisside|\-|`строка`|0 — LEFT (по умолчанию)<br>1 — RIGHT|Позиция оси Y (слева или справа) для отрисовки элемента данных.<br><br>Используется для обычных и стэкируемых графиков.| | |calc\_fnc|\-|`строка`|1 — MIN<br>2 — AVG (по умолчанию)<br>4 — MAX<br>7 — ALL (минимум, среднее и максимум; используется только для простых графиков)<br>9 — LAST (используется только для круговых/расширенных графиков)|Данные для отрисовки, если существует более одного значения по элементу данных.| | |type|\-|`строка`|0 — SIMPLE (по умолчанию)<br>2 — GRAPH\_SUM (значение элемента данных представляется целым кругом; используется только для круговых/расширенных графиков)|Тип элемента данных графика.| |item| |x| | |Отдельный элемент данных.| | |host|x|`строка`| |Узел сети элемента данных.| | |key|x|`строка`| |Ключ элемента данных.| # 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.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Группа узлов сети Объект группы узлов сети имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#типы_данных)|Описание| |--|--|------| |groupid|string|*(только для чтения)* - идентификатор группы узлов сети.| |**name**<br>(обязательно)|string|Имя группы узлов сети.| |flags|integer|*(только для чтения)* - происхождение группы узлов сети.<br><br>Возможные значения:<br>0 - обычная группа узлов сети;<br>4 - обнаруженная группа узлов сети.| |internal|integer|*(только для чтения)* - используется ли группа системой внутренне. Внутренние группы удалить нельзя.<br><br>Возможные значения:<br>0 - *(по умолчанию)* не внутренняя;<br>1 - внутренняя.| |uuid|string|Универсальный уникальный идентификатор, используемый для сопоставления импортированных групп узлов сети с уже существующими. Генерируется автоматически, если не указан.| Обратите внимание, что для некоторых методов (например, update и delete) набор обязательных и необязательных параметров отличается. # 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 ### Host interface The host interface object has the following properties. ::: noteimportant Note that both IP and DNS are required. If you do not want to use DNS, set it to an empty string. ::: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |available|integer|*(readonly)* Availability of host interface.<br><br>Possible values are:<br>0 - *(default)* unknown;<br>1 - available;<br>2 - unavailable.| |details|object|Additional object for interface. **Required** if interface 'type' is SNMP.| |disable\_until|timestamp|*(readonly)* The next polling time of an unavailable host interface.| |**dns**<br>(required)|string|DNS name used by the interface.<br><br>Can be empty if the connection is made via IP.| |error|string|*(readonly)* Error text if host interface is unavailable.| |errors\_from|timestamp|*(readonly)* Time when host interface became unavailable.| |**hostid**<br>(required)|string|ID of the host the interface belongs to.| |interfaceid|string|*(readonly)* ID of the interface.| |**ip**<br>(required)|string|IP address used by the interface.<br><br>Can be empty if the connection is made via DNS.| |**main**<br>(required)|integer|Whether the interface is used as default on the host. Only one interface of some type can be set as default on a host.<br><br>Possible values are:<br>0 - not default;<br>1 - default.| |**port**<br>(required)|string|Port number used by the interface. Can contain user macros.| |**type**<br>(required)|integer|Interface type.<br><br>Possible values are:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>| |**useip**<br>(required)|integer|Whether the connection should be made via IP.<br><br>Possible values are:<br>0 - connect using host DNS name;<br>1 - connect using host IP address for this host interface.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Интерфейс узла сети Объект интерфейса узла сети имеет следующие свойства. ::: noteimportant Поля IP и DNS обязательны. Если DNS не используется, укажите его как пустую строку. ::: |Свойство|[Тип](/manual/api/reference_commentary#тип_данных)|Описание| |--|--|------| |available|integer|*(только для чтения)* - доступность интерфейса узла сети.<br><br>Возможные значения:<br>0 - *(по умолчанию)* неизвестно;<br>1 - доступен;<br>2 - недоступен.| |details|object|Дополнительный объект для интерфейса. **Обязательно** , если тип интерфейса - SNMP.| |disable\_until|timestamp|*(только для чтения)* - время следующей проверки недоступного интерфейса узла сети.| |**dns**<br>(обязательно)|string|DNS-имя, используемое интерфейсом.<br><br>Может быть пустым, если соединение выполняется по IP.| |error|string|*(только для чтения)* - текст ошибки, если интерфейс недоступен.| |errors\_from|timestamp|*(только для чтения)* - время, когда интерфейс узла сети стал недоступен.| |**hostid**<br>(обязательно)|string|Идентификатор узла сети, которому принадлежит интерфейс.| |interfaceid|string|*(только для чтения)* - идентификатор интерфейса.| |**ip**<br>(обязательно)|string|IP-адрес, используемый интерфейсом.<br><br>Может быть пустым, если соединение выполняется по DNS.| |**main**<br>(обязательно)|integer|Используется ли интерфейс как основной для узла. Для каждого типа интерфейса может быть только один основной.<br><br>Возможные значения:<br>0 - не основной;<br>1 - основной.| |**port**<br>(обязательно)|string|Номер порта, используемый интерфейсом. Может содержать пользовательские макросы.| |**type**<br>(обязательно)|integer|Тип интерфейса.<br><br>Возможные значения:<br>1 - агент;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>| |**useip**<br>(обязательно)|integer|Определяет, выполняется ли подключение по IP.<br><br>Возможные значения:<br>0 - подключение по DNS-имени узла;<br>1 - подключение по IP-адресу узла для этого интерфейса.| Обратите внимание, что для некоторых методов (например, update и delete) набор обязательных и необязательных параметров отличается. # hostinterface.update # hostinterface.update ##### 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|Time period of how long the history data should be stored. A time period using the time suffix, a user macro or LLD macro.| | |trends|\-|`string`|Default: 365d|Time period of how long the trends data should be stored. A time period using the time suffix, a 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 polling 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|Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>Used only by HTTP agent items.| | |verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host's 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.| ##### Теги элементов данных узла сети |Элемент|Свойство элемента|Требуется|Тип|Диапазон^**[1](#примечания)**^|Описание| |--|--|-|--|----|--------| |items| |\-| | |Корневой элемент элементов данных.| | |name|x|`строка`| |Имя элемента данных.| | |type|\-|`строка`|0 — ZABBIX\_PASSIVE (по умолчанию)<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|Тип элемента данных.| | |snmp\_oid|\-|`строка`| |Идентификатор объекта SNMP.<br><br>Обязателен для элементов данных SNMP.| | |key|x|`строка`| |Ключ элемента данных.| | |delay|\-|`строка`|По умолчанию: 1m|Интервал обновления элемента данных.<br><br>Обратите внимание, что `delay` всегда будет «0» для элементов данных типа траппер.<br><br>Воспринимаются секунды либо единицы времени с суффиком (30s, 1m, 2h, 1d).<br>Опционально могут быть указаны один или несколько [пользовательских интервалов](/manual/config/items/item/custom_intervals) - либо как гибкие интервалы, либо как расписания.<br>Несколько интервалов разделяются точкой с запятой.<br>Могут использоваться пользовательские макросы. Один макрос должен заполнять поле целиком. Несколько макросов в поле либо макросы вперемешку с текстом не поддерживаются.<br>Гибкие интервалы могут быть указаны как два макроса, разделённые прямой косой чертой (т.е. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| | |history|\-|`строка`|По умолчанию: 90d|Период времени, как долго хранить данные истории. Единица времени с суффиксом, пользовательский макрос или LLD-макрос.| | |trends|\-|`строка`|По умолчанию: 365d|Период времени, как долго хранить данные динамики изменений. Единица времени с суффиксом, пользовательский макрос или LLD-макрос.| | |status|\-|`строка`|0 — ENABLED (по умолчанию)<br>1 — DISABLED|Состояние элемента данных.| | |value\_type|\-|`строка`|0 — FLOAT<br>1 — CHAR<br>2 — LOG<br>3 — UNSIGNED (по умолчанию)<br>4 — TEXT|Тип получаемого значения.| | |allowed\_hosts|\-|`строка`| |Список IP адресов (разделенных запятыми) узлов сети, с которых разрешена отправка данных на элемент данных.<br><br>Используется элементами данных «траппер» и «HTTP агент».| | |units|\-|`строка`| |Единицы измерения получаемых значений (bps, B и т.п.).| | |params|\-|`текст`| |Дополнительные параметры в зависимости от типа элемента данных:<br>- выполняемый скрипт для элементов данных Скрипт, SSH и Telnet;<br>- SQL запрос для элементов данных Монитор баз данных;<br>- формула для вычисляемых элементов данных.| | |ipmi\_sensor|\-|`строка`| |IPMI датчик.<br><br>Используется только элементами данных IPMI.| | |authtype|\-|`строка`|Тип аутентификации для элементов данных SSH агент:<br>0 — PASSWORD (по умолчанию)<br>1 — PUBLIC\_KEY<br><br>Тип аутентификации для элементов данных HTTP агент:<br>0 — NONE (по умолчанию)<br>1 — BASIC<br>2 — NTLM|Тип аутентификации.<br><br>Используется только для элементов данных SSH и HTTP агент.| | |username|\-|`строка`| |Имя пользователя для аутентификации.<br>Используется для элементов данных типов простая проверка, SSH, Telnet, монитор баз данных, JMX и HTTP агент.<br><br>Обязателен для элементов данных SSH и Telnet.<br>При использовании JMX агентом, также должен быть указан пароль, либо оба свойства оставлены пустыми.| | |password|\-|`строка`| |Пароль для аутентификации.<br>Используется для элементов данных типов простая проверка, SSH, Telnet, монитор баз данных, JMX и HTTP агент.<br><br>При использовании JMX агентом, также должно быть указано имя пользователя, либо оба свойства оставлены пустыми.| | |publickey|\-|`строка`| |Имя файла открытого ключа (public key).<br><br>Обязательно для элементов данных SSH агент.| | |privatekey|\-|`строка`| |Имя файла закрытого ключа (private key).<br><br>Обязательно для элементов данных SSH агент.| | |description|\-|`текст`| |Описание элемента данных.| | |inventory\_link|\-|`строка`|0 — NONE<br><br>Имя поля инвентарных данных узла сети заглавными буквами. Например:<br>4 — ALIAS<br>6 — OS\_FULL<br>14 — HARDWARE<br>etc.|Поле инвентарных данных узла сети, заполняемое этим элементом данных.<br><br>Обратитесь к [странице инвентарных данных узла сети](/manual/api/reference/host/object#инвентарные-данные-узла-сети) для списка поддерживаемых полей инвентарных данных узлов сети и их ID.| | |logtimefmt|\-|`строка`| |Формат времени в записях в журнале. <br>Используется только элементами данных журнал (лог).| | |interface\_ref|\-|`строка`|Формат: `if<N>`|Ссылка на интерфейс узла сети.| | |jmx\_endpoint|\-|`строка`| |JMX endpoint.<br><br>Используется элементами данных типа JMX агент.| | |url|\-|`строка`| |Строка URL.<br><br>Требуется только для элементов данных HTTP агент.| | |allow\_traps|\-|`строка`|0 — NO (по умолчанию)<br>1 — YES|Позволяет отправку данных на элемент данных как для типа траппер.<br><br>Используется только элементами данных HTTP агент.| | |follow\_redirects|\-|`строка`|0 — NO<br>1 — YES (по умолчанию)|Следовать ответам перенаправлений HTTP при опросе данных.<br><br>Используется только элементами данных HTTP агент| |headers| |\-| | |Корневой элемент заголовков запросов HTTP(S), где имя заголовка используется как ключ, а значение заголовка как значение.<br>Используется только элементами данных HTTP агент.| | |name|x|`строка`| |Имя заголовка.| | |value|x|`строка`| |Значение заголовка.| | |http\_proxy|\-|`строка`| |Строка подключения к HTTP(S) прокси.<br><br>Используется только элементами данных HTTP агент.| | |output\_format|\-|`строка`|0 — RAW (по умолчанию)<br>1 — JSON|Как обрабатывать ответ.<br><br>Используется только элементами данных HTTP агент.| | |post\_type|\-|`строка`|0 — RAW (по умолчанию)<br>2 — JSON<br>3 — XML|Тип отсылаемых в теле запроса данных.<br><br>Используется только элементами данных HTTP агент.| | |posts|\-|`строка`| |Данные тела запроса HTTP(S).<br><br>Используется только элементами данных HTTP агент.| |query\_fields| |\-| | |Корневой элемент параметров запроса.<br><br>Используется только элементами данных HTTP агент.| | |name|x|`строка`| |Имя параметра.| | |value|\-|`строка`| |Значение параметра.| | |request\_method|\-|`строка`|0 — GET (по умолчанию)<br>1 — POST<br>2 — PUT<br>3 — HEAD|Метод запроса.<br><br>Используется только элементами данных HTTP агент.| | |retrieve\_mode|\-|`строка`|0 — BODY (по умолчанию)<br>1 — HEADERS<br>2 — BOTH|Какую часть ответа надо сохранить.<br><br>Используется только элементами данных HTTP агент.| | |ssl\_cert\_file|\-|`строка`| |Путь к файлу открытого ключа (public key) SSL.<br><br>Используется только элементами данных HTTP агент.| | |ssl\_key\_file|\-|`строка`| |Путь к файлу закрытого ключа (private key) SSL.<br><br>Используется только элементами данных HTTP агент.| | |ssl\_key\_password|\-|`строка`| |Пароль к файлу ключа SSL.<br><br>Используется только элементами данных HTTP агент.| | |status\_codes|\-|`строка`| |Диапазоны требуемых кодов состояний HTTP, разделенные запятыми. Поддерживаются пользовательские макросы.<br>Пример: 200,200-{$M},{$M},200-400<br><br>Используется только элементами данных HTTP агент.| | |timeout|\-|`строка`| |Время ожидания при выполнении запроса данных элемента данных. Поддерживаются пользовательские макросы.<br><br>Используется только элементами данных HTTP агент и Скрипт.| | |verify\_host|\-|`строка`|0 — NO (по умолчанию)<br>1 — YES|Проверять, содержится ли имя узла в URL в полях Common Name или Subject Alternate Name сертификата хоста.<br><br>Используется только элементами данных HTTP агент.| | |verify\_peer|\-|`строка`|0 — NO (по умолчанию)<br>1 — YES|Проверка подлинности сертификата хоста.<br><br>Используется только элементами данных HTTP агент.| |parameters| |\-| | |Корневой элемент для параметров, определяемых пользователем.<br><br>Используется только элементами данных Скрипт.| | |name|x|`строка`| |Имя параметра.<br><br>Используется только элементами данных Скрипт.| | |value|\-|`строка`| |Значение параметра.<br><br>Используется только элементами данных Скрипт.| |value map| |\-| | |Преобразование значений.| | |name|x|`строка`| |Имя преобразования значений, которое используется элементом данных.| |preprocessing| |\-| | |Корневой элемент для предобработки элементов данных.| |step| |\-| | |Отдельный шаг предварительной обработки значений элемента данных.| | |type|x|`строка`|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 (вычисляется как (полученное_значение-предыдущее_значение))<br>10 — CHANGE\_PER\_SECOND (вычисляется как (полученное_значение-предыдущее_значение)/(текущее_время-время_предыдущей_проверки))<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|Тип шага предварительной обработки значений элемента данных.| | |parameters|\-| | |Корневой элемент параметров шага предобработки значения элемента данных.| | |parameter|x|`строка`| |Отдельный параметр шага предобработки значения элемента данных.| | |error\_handler|\-|`строка`|0 — ORIGINAL\_ERROR (по умолчанию)<br>1 — DISCARD\_VALUE<br>2 — CUSTOM\_VALUE<br>3 — CUSTOM\_ERROR|Тип действия, используемого в случае ошибки шага предобработки.| | |error\_handler\_params|\-|`строка`| |Параметры обработчика ошибок, используемого с 'error\_handler'.| |master\_item| |\-| | |Отдельный элемент данных мастер элемента данных.<br><br>Обязателен для зависимых элементов данных.| | |key|x|`строка`| |Значение ключа мастер элемента данных зависимого элемента данных.<br><br>Допускается рекурсия до 3 зависимых элементов данных и максимальное количество зависимых элементов данных до 29999.| |triggers| |\-| | |Корневой элемент простых триггеров.| | |*Для значений тегов элементов триггеров, смотрите [теги триггеров](/manual/xml_export_import/hosts#теги-триггеров-узла-сети) узла сети.*| | | | | |tags| |\-| | |Корневой элемент тегов элемента данных.| | |tag|x|`строка`| |Имя тега.| | |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.| ##### Теги правил низкоуровневого обнаружения узла сети |Элемент|Свойство элемента|Обязательный|Тип|Диапазон^**[1](#примечания)**^|Описание| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Корневой элемент правил низкоуровневого обнаружения.| | |*По большинству значений тегов элементов, смотрите значения тегов элементов обычных элементов данных. Ниже описаны только те теги, которые являются специфичными для правил низкоуровневого обнаружения.*| | | | | | |type|\-|`строка`|0 — ZABBIX\_PASSIVE (по умолчанию)<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|Тип элемента данных.| | |lifetime|\-|`строка`|По умолчанию: 30d|Период времени, после которого элементы данных, которые более не обнаруживаются, будут удалены. Секунды, единицы времени с суффиксом или пользовательский макрос.| |filter| | | | |Отдельный фильтр.| | |evaltype|\-|`строка`|0 — AND\_OR (по умолчанию)<br>1 — AND<br>2 — OR<br>3 — FORMULA|Логика, используемая для проверки условий фильтра правила низкоуровневого обнаружения.| | |formula|\-|`строка`| |Пользовательская формула вычисления условий фильтра.| |conditions| |\-| | |Корневой элемент условий фильтров.| | |macro|x|`строка`| |Имя макроса низкоуровневого обнаружения.| | |value|\-|`строка`| |Значение фильтра: регулярное выражение или глобальное регулярное выражение.| | |operator|\-|`строка`|8 — MATCHES\_REGEX (по умолчанию)<br>9 — NOT\_MATCHES\_REGEX|Оператор условия.| | |formulaid|x|`символ`| |Произвольный уникальный идентификатор, используемый для ссылки на условие из пользовательского выражения. Может содержать только заглавные буквы. Идентификатор должен быть задан пользователем при модификации условий фильтра, но будет сгенерирован заново при последующем запросе.| |lld\_macro\_paths| |\-| | |Корневой элемент путей макросов низкоуровневого обнаружения.| | |lld\_macro|x|`строка`| |Имя макроса низкоуровневого обнаружения.| | |path|x|`строка`| |Селектор значения, которое будет назначено соответствующему макросу.| |preprocessing| |\-| | |Предобработка значения правила низкоуровневого обнаружения.| |step| |\-| | |Отдельный шаг предобработки значения правила низкоуровневого обнаружения.| | |*По большинству значений тегов элементов, смотрите значения тегов элементов для предобработки значений элементов данных узла сети. Ниже описаны только те теги, которые являются специфичными для предобработки значений правил низкоуровневого обнаружения.*| | | | | | |type|x|`строка`|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|Тип шага предобработки значения элемента данных.| |trigger\_prototypes| |\-| | |Корневой элемент прототипов триггеров.| | |*По значениям тегов элементов прототипов триггеров, смотрите теги обычных [триггеров узла сети](/manual/xml_export_import/hosts#теги-триггеров-узла-сети).*| | | | | |graph\_prototypes| |\-| | |Корневой элемент прототипов графиков.| | |*По значениям тегов элементов прототипов графиков, смотрите теги обычных [графиков узла сети](/manual/xml_export_import/hosts#теги-графиков-узла-сети).*| | | | | |host\_prototypes| |\-| | |Корневой элемент прототипов узлов сети.| | |*По значениям тегов элементов прототипов узлов сети, смотрите теги обычных [узлов сети](/manual/xml_export_import/hosts#теги-узла-сети).*| | | | | |item\_prototypes| |\-| | |Корневой элемент прототипов элементов данных.| | |*По значениям тегов элементов прототипов элементов данных, смотрите теги обычных [элементов данных узла сети](/manual/xml_export_import/hosts#теги-элементов-данных-узла-сети).*| | | | | |master\_item| |\-| | |Данные о прототипах элементов данных для отдельного основного элемента данных/прототипа основного элемента данных.| | |key|x|`строка`| |Для прототипов зависимых элементов данных — значение ключа основного элемента данных / прототипа основного элемента данных .<br><br>Требуется для зависимых элементов данных.| ### Host macro The host macro object defines a macro available on a host, host prototype or template. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostmacroid|string|*(readonly)* ID of the host macro.| |**hostid**<br>(required)|string|ID of the host that the macro belongs to.| |**macro**<br>(required)|string|Macro string.| |**value**<br>(required)|string|Value of the macro.| |type|integer|Type of macro.<br><br>Possible values:<br>0 - *(default)* Text macro;<br>1 - Secret macro;<br>2 - Vault secret.| |description|string|Description of the macro.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Макрос узла сети Объект макроса узла сети определяет макрос, доступный на узле сети, прототипе узла сети или шаблоне. Он имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#тип_данных)|Описание| |--|--|------| |hostmacroid|string|*(только для чтения)* - идентификатор макроса узла сети.| |**hostid**<br>(обязательно)|string|Идентификатор узла сети, которому принадлежит макрос.| |**macro**<br>(обязательно)|string|Строка макроса.| |**value**<br>(обязательно)|string|Значение макроса.| |type|integer|Тип макроса.<br><br>Возможные значения:<br>0 - *(по умолчанию)* Текст;<br>1 - Скрытый текст;<br>2 - Секрет Хранилища.| |description|string|Описание макроса.| Обратите внимание, что для некоторых методов (например, update и delete) набор обязательных и необязательных параметров отличается. 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.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) #### Меню узлов сети При нажатии на узел сети в виджете *Проблемы* отобразится меню узла сети. Оно включает в себя ссылки на инвентарные данные, последние данные, проблемы, графики, панели, веб-сценарии и настройку этого узла сети. Обратите внимание, что настройка узла сети доступна только для пользователей Администратор и Супер-администратор.  [Глобальные скрипты](/manual/web_interface/frontend_sections/administration/scripts) также можно запускать из меню узлов сети. Чтобы эти скрипты были доступны в меню узлов сети, нужно, чтобы их область действия была определена как «Действие вручную над узлом сети». Меню узлов сети доступно при нажатии на узел сети в некоторых других разделах веб-интерфейса: - Мониторинг → [Проблемы](problems) - Мониторинг → [Проблемы](problems) → Детали события - Мониторинг → [Узлы сети](hosts) - Мониторинг → Узлы сети → [Веб](/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. For Windows, it returns result of the gethostname() function, which queries namespace providers to determine the local host name. If no namespace provider responds, the NetBIOS name is returned. The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified, the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it. The "system.hostname" key supports two optional parameters - *type* and *transform*. *Type* parameter determines the type of the name the item should return. Supported values: - *netbios* (default) - returns the NetBIOS host name which is limited to 15 symbols and is in the UPPERCASE only; - *host* - case-sensitive, returns the full, real Windows host name (without a domain); - *shorthost* (supported since Zabbix 5.4.7) - returns part of the hostname before the first dot. It will return a full string if the name does not contain a dot. *Transform* parameter is supported since Zabbix 5.4.7 and allows to specify additional transformation rule for the hostname. Supported values: - *none* (default) - use the original letter case; - *lower* - convert the text into lowercase. So, to simplify the configuration of zabbix\_agentd.conf file and make it unified, two different approaches could be used. 1. Leave **Hostname** or **HostnameItem** parameters undefined and Zabbix agent will use NetBIOS host name as the hostname. 2. Leave **Hostname** parameter undefined and define **HostnameItem** like this:<br> **HostnameItem=system.hostname\[host\]** - for Zabbix agent to use the full, real (case-sensitive) Windows host name as the hostname<br> **HostnameItem=system.hostname\[shorthost,lower\]** - for Zabbix agent to use only part of the hostname before the first dot, converted into lowercase.<br> 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 Для выполнения [активных проверок](/manual/appendix/items/activepassive#активные-проверки) на узле сети Zabbix агенту требуется, чтобы было задано имя хоста. Кроме того, указанное значение имени хоста на стороне агента должно в точности совпадать с «[именем узла сети](/manual/config/hosts/host)», указанном для этого узла сети в веб-интерфейсе. Значение имени хоста на стороне агента можно задать параметрами **Hostname** или **HostnameItem** в [файле конфигурации](/manual/appendix/config/zabbix_agentd_win) агента — или будут использованы значения по умолчанию, если ни один из этих параметров не указан. Значением по умолчанию для параметра **HostnameItem** является значение, возвращаемое ключом агента «system.hostname». Для платформы Windows он вернёт результат функции *gethostname()*, которая опрашивает провайдеров пространств имён, чтобы определить имя локального хоста. Если никакой из провайдеров пространств имён не отвечает, возвращается NetBIOS имя хоста. Значением по умолчанию для параметра **Hostname** является значение, возвращаемое параметром **HostnameItem**. Таким образом, фактически, если оба этих параметра не заданы, то реальным именем узла сети будет NetBIOS имя хоста; Zabbix агент будет использовать NetBIOS имя хоста для получения списка активных проверок от Zabbix сервера и отправки ему результатов. Ключ «system.hostname» поддерживает два необязательных параметра — *тип* и *преобразование*. Параметр *тип* определяет тип имени, которое должен вернуть элемент данных. Поддерживаемые значения: - *netbios* (по умолчанию) — возвращает NetBIOS имя хоста, ограниченное до 15 символов и только В ВЕРХНЕМ РЕГИСТРЕ; - *host* — чувствительное к регистру, возвращает полное, реальное имя хоста Windows (без домена); - *shorthost* (поддерживается с версии Zabbix 5.4.7) — возвращает часть имени хоста до первой точки. Возвращается полная строка, если имя не содержит точку. Параметр *преобразование* поддерживается с версии Zabbix 5.4.7 и позволяет указать правило дополнительного преобразования для имени хоста. Поддерживаются значения: - *none* (по умолчанию) — использовать оригинальный регистр букв; - *lower* — приводить текст к нижнему регистру. Таким образом, чтобы упростить настройку файла zabbix\_agentd.conf и сделать его унифицированным, можно использовать два различных подхода. 1. Оставить параметры **Hostname** или **HostnameItem** не заданными, и тогда Zabbix агент будет использовать NetBIOS имя хоста как имя узла сети. 2. Оставить параметр **Hostname** не заданным и задать **HostnameItem** таким образом:<br> **HostnameItem=system.hostname\[host\]** — тогда Zabbix агент будет использовать полное, реальное (регистрозависимое) имя хоста Windows как имя узла сети<br> **HostnameItem=system.hostname\[shorthost,lower\]** — тогда Zabbix агент будет использовать только часть имени хоста до первой точки, приведённую к нижнему регистру.<br> Также при установке, запуске, остановке и удалении службы Windows имя хоста используется как часть имени службы Windows. Например, если в файле конфигурации Zabbix агента указано `Hostname=Windows_db_server`, тогда агент будет установлен как служба Windows «`Zabbix Agent [Windows_db_server]`». Поэтому, чтобы у каждого экземпляра Zabbix агента имелись разные имена служб Windows, каждый экземпляр должен использовать отличное от другого экземпляра имя узла сети. ##### 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 are the basis for generating real hosts. Prototypes, before becoming discovered, cannot have their own items and triggers, other than those from the linked templates. {width="600"} 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. ::: noteclassic Zabbix does not support nested host prototypes, i.e. host prototypes are not supported on hosts that are discovered by low-level discovery rule. ::: #### Прототипы узлов сети Прототипы узлов сети можно создать с помощью правила низкоуровневого обнаружения. Когда виртуальные машины обнаруживаются, на основе этих прототипов генерируются реальные узлы сети. Прототипы, до момента обнаружения, не могут иметь своих собственных элементов данных и триггеров, кроме тех, которые унаследованы из присоединённых шаблонов.  Чтобы узлы сети, созданные из прототипа, имели уникальные имена узлов сети, поле *Имя узла сети* должно содержать по крайней мере один [макрос низкоуровневого обнаружения](/manual/config/macros/lld_macros). Начиная с Zabbix 5.2, обнаруженные узлы сети можно настраивать с пользовательскими интерфейсами или наследовать IP адрес узла сети, которому принадлежит правило обнаружения (по умолчанию). Чтобы добавить один и более пользовательских интерфейсов, переключите параметр *Интерфейс* из режима *Наследовать* на *Пользовательское*, затем нажмите на  (Добавить) и выберите тип требуемого интерфейса в появившемся выпадающем меню. Прототипу узлов сети можно добавить все поддерживаемые типы интерфейсов: Zabbix агент, SNMP, JMX, IPMI. Поля интерфейсов поддерживают низкоуровневые макросы и [пользовательские макросы](/manual/config/macros/user_macros). Если задано несколько пользовательских интерфейсов - используйте колонку *По умолчанию*, чтобы определить основной интерфейс. Примечания: - Если выбран режим *Пользовательские*, но интерфейсы не заданы, узлы сети будут созданы без интерфейсов. - Если выбрано *Наследовать* у прототипа узлов сети, который принадлежит шаблону, обнаруженные узлы сети будут наследовать интерфейс узла сети, к которому присоединён шаблон. ::: notewarning Узел сети не будет создан, если интерфейс узла сети содержит некорректные данные :::  LLD макросы также можно использовать в видимом имени, полях прототипа групп узлов сети, значениях тегов, а также значениях пользовательских макросов прототипов узлов сети. Другие параметры, которые можно задать прототипу узлов сети: - Связь с существующими группами узлов сети - Связь с шаблонами - Шифрование Если *Создать активированным* выбрано, узел сети добавится в активированном состоянии. Если не выбрано, узел сети добавится, но в деактивированном состоянии. Если опция *Обнаружение* выбрана (по умолчанию), узел сети будет создан. Если опция не выбрана, узел сети не будет создаваться, если только этот параметр не переопределён в [правиле обнаружения](/manual/discovery/low_level_discovery#замещение). Эта возможность даёт дополнительную гибкость при создании правил обнаружения. В списке узлов сети обнаруженные узлы сети имеют префикс с именем правила обнаружения, которым они были созданы. Обнаруженные узлы сети могут быть удалены вручную. Обнаруженные узлы автоматически удаляются, основываясь на значении *Период хранения потерянных ресурсов (в днях)* правила обнаружения. Большинство опций конфигурации доступно только на чтение, исключая активацию/деактивацию узла сети и инвентарные данные. ::: noteclassic Zabbix не поддерживает вложенность прототипов узлов сети, т.е. прототипы узлов сети не поддерживаются на узлах сети, которые сами созданы правилами низкоуровневого обнаружения. ::: ### 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.| ### Тег прототипа узла сети Объект тега прототипа узла сети имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |**tag**<br>(обязательное)|string|Имя тега прототипа узла сети.| |value|строка|Значение тега прототипа узла сети.| # 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) #### Узлы сети и группы узлов сети Manage host groups, hosts and everything related to them, including host interfaces, host macros and maintenance periods. Управление группами узлов сети, узлами сети и всем, что с ними связано, включая интерфейсы узла сети, макросы узла сети и периоды обслуживания. [API узлов сети](/manual/api/reference/host) | [API групп узлов сети](/manual/api/reference/hostgroup) | [API интерфейсов узлов сети](/manual/api/reference/hostinterface) | [API пользовательских макросов](/manual/api/reference/usermacro) | [API преобразования значений](/manual/api/reference/valuemap) | [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| #### Узлы сети / прототипы узлов сети При настройке [узла сети](/manual/config/hosts/host) и [прототипа узла сети](/manual/vm_monitoring#прототипы-узлов-сети) пользовательские макросы могут использоваться в следующих полях: |Место|<|Несколько макросов/вперемешку с текстом^[1](supported_by_location_user#примечания)^| |-|------------------------------|----------| |IP адрес / DNS имя интерфейса|<|только DNS| |Порт интерфейса|<|нет| |*SNMP v1, v2*|<|<| | |SNMP community|да| |*SNMP v3*|<|<| | |Имя контекста|да| |^|Имя безопасности|да| |^|Пароль аутентификации|да| |^|Ключевая фраза безопасности|да| |*IPMI*|<|<| | |Имя пользователя|да| |^|Пароль|да| |*Теги*^[2](supported_by_location_user#примечания)^|<|<| | |Имена тегов|да| |^|Значения тегов|да| ##### 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.| ##### Теги узла сети |Элемент|Свойство элемента|Обязательный|Тип|Диапазон^**[1](#примечания)**^|Описание| |--|--|-|--|----|--------| |groups| |x| | |Корневой элемент групп узлов сети.| | |name|x|`строка`| |Имя группы узлов сети.| |hosts| |\-| | |Корневой элемент узлов сети.| | |host|x|`строка`| |Уникальное имя узла сети.| | |name|\-|`строка`| |Видимое имя узла сети.| | |description|\-|`текст`| |Описание узла сети.| | |status|\-|`строка`|0 - ENABLED (по умолчанию)<br>1 — DISABLED|Состояние узла сети.| | |ipmi\_authtype|\-|`строка`|-1 — DEFAULT (по умолчанию)<br>0 — NONE<br>1 — MD2<br>2 — MD5<br>4 — STRAIGHT<br>5 — OEM<br>6 — RMCP\_PLUS|Тип аутентификации сессии IPMI.| | |ipmi\_privilege|\-|`строка`|1 — CALLBACK<br>2 — USER (по умолчанию)<br>3 — OPERATOR<br>4 — ADMIN<br>5 — OEM|Уровень привилегий сессии IPMI.| | |ipmi\_username|\-|`строка`| |Имя пользователя для IPMI проверок.| | |ipmi\_password|\-|`строка`| |Пароль для IPMI проверок.| |proxy| |\-| | |Прокси.| | |name|x|`строка`| |Имя прокси (если имеется), которое наблюдает узел сети.| |templates| |\-| | |Корневой элемент присоединённых шаблонов.| | |name|x|`строка`| |Имя шаблона.| |interfaces| |\-| | |Корневой элемент интерфейсов узла сети.| | |default|\-|`строка`|0 — NO<br>1 — YES (по умолчанию)|Является ли данный интерфейс узла сети первичным.<br>У узла сети может быть только один первичный интерфейс каждого типа.| | |type|\-|`строка`|1 — ZABBIX (по умолчанию)<br>2 — SNMP<br>3 — IPMI<br>4 — JMX|Тип интерфейса.| | |useip|\-|`строка`|0 — NO<br>1 — YES (по умолчанию)|Использовать ли IP в качестве интерфейса для подключения к узлу сети (если нет, будет использоваться DNS).| | |ip|\-|`строка`| |IP адрес, может быть как IPv4, так и IPv6.<br>Обязателен, если подключение производится по IP.| | |dns|\-|`строка`| |DNS имя.<br><br>Обязателен, если подключение производится по DNS.| | |port|\-|`строка`| |Номер порта. Поддерживаются пользовательские макросы.| | |interface\_ref|x|`строка`|Формат: `if<N>`|Имя ссылки на интерфейс, которое используется в элементах данных.| |details| |\-| | |Корневой элемент для подробностей интерфейса.| | |version|\-|`строка`|1 — SNMPV1<br>2 — SNMP\_V2C (по умолчанию)<br>3 — SNMP\_V3|Использовать эту версию SNMP.| | |community|\-|`строка`| |SNMP community.<br><br>Обязательно для элементов данных SNMPv1 и SNMPv2.| | |contextname|\-|`строка`| |Имя контекста SNMPv3.<br><br>Используется только элементами данных SNMPv3.| | |securityname|\-|`строка`| |Имя безопасности SNMPv3.<br><br>Используется только элементами данных SNMPv3.| | |securitylevel|\-|`строка`|0 - NOAUTHNOPRIV (по умолчанию)<br>1 — AUTHNOPRIV<br>2 — AUTHPRIV|Уровень безопасности SNMPv3.<br><br>Используется только элементами данных SNMPv3.| | |authprotocol|\-|`строка`|0 — MD5 (по умолчанию)<br>1 — SHA1<br>2 — SHA224<br>3 — SHA256<br>4 — SHA384<br>5 — SHA512|Протокол аутентификации SNMPv3.<br><br>Используется только элементами данных SNMPv3.| | |authpassphrase|\-|`строка`| |Пароль аутентификации SNMPv3.<br><br>Используется только элементами данных SNMPv3.| | |privprotocol|\-|`строка`|0 — DES (по умолчанию)<br>1 — AES128<br>2 — AES192<br>3 — AES256<br>4 — AES192C<br>5 — AES256C|Протокол безопасности SNMPv3.<br><br>Используется только элементами данных SNMPv3.| | |privpassphrase|\-|`строка`| |Ключевая фраза безопасности SNMPv3.<br><br>Используется только элементами данных SNMPv3.| | |bulk|\-|`строка`|0 — NO<br>1 — YES (по умолчанию)|Использовать ли массовые запросы SNMP.| |items| |\-| | |Корневой элемент элементов данных.| | |*Для значений тегов элементов элементов данных, смотрите теги [элементы данных](/manual/xml_export_import/hosts#теги-элементов-данных-узла-сети) узла сети.*| | | | | |tags| |\-| | |Корневой элемент тегов узла сети.| | |tag|x|`строка`| |Имя тега.| | |value|\-|`строка`| |Значение тега.| |macros| |\-| | |Корневой элемент макросов.| | |macro|x| | |Имя пользовательского макроса.| | |type|\-|`строка`|0 — TEXT (по умолчанию)<br>1 — SECRET\_TEXT<br>2 — VAULT|Тип пользовательского макроса.| | |value|\-|`строка`| |Значение пользовательского макроса.| | |description|\-|`строка`| |Описание пользовательского макроса.| |inventory| |\-| | |Корневой элемент инвентарных данных узла сети.| | |<inventory\_property>|\-| | |Отдельное свойство инвентарных данных.<br><br>Все доступные свойства инвентарных данных перечислены под соответствующими тегами, т.е. <type>, <name>, <os> (смотрите примеры выше).| |inventory\_mode| |\-|`строка`|-1 — DISABLED<br>0 — MANUAL (default)<br>1 — AUTOMATIC|Режим инвентаризации.| |valuemaps| |\-| | |Корневой элемент преобразований значений узла сети.| | |name|x|`строка`| |Имя преобразования значений.| | |mapping|\-| | |Корневой элемент преобразования значений.| | |value|x|`строка`| |Значение преобразования значений.| | |newvalue|x|`строка`| |Новое значение преобразования значений.| ### 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.| ### Тег узла сети Объект тега узла сети имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#типы_данных)|Описание| |--|--|------| |**tag**<br>(обязательно)|строка|Имя тега узла сети.| |value|строка|Значение тега узла сети.| ##### 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.| | |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.| | |name|x|`string`| |Trigger name.| | |event_name|\-|`string`| |Event name.| | |opdata|\-|`string`| |Operational data.| | |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.| ##### Теги триггеров узла сети |Элемент|Свойство элемента|Обязательный|Тип|Диапазон^**[1](#примечания)**^|Описание| |--|--|-|--|----|--------| |triggers| |\-| | |Корневой элемент триггеров.| | |expression|x|`строка`| |Выражение триггера.| | |recovery\_mode|\-|`строка`|0 — EXPRESSION (по умолчанию)<br>1 — RECOVERY\_EXPRESSION<br>2 — NONE|Основа генерации событий OK.| | |recovery\_expression|\-|`строка`| |Выражение восстановления триггера.| | |correlation\_mode|\-|`строка`|0 — DISABLED (по умолчанию)<br>1 — TAG\_VALUE|Режим корреляции (без корреляции или корреляция событий по тегу).| | |correlation\_tag|\-|`строка`| |Имя тега, используемого для корреляции событий.| | |name|x|`строка`| |Имя триггера.| | |event_name|\-|`строка`| |Имя события.| | |opdata|\-|`строка`| |Оперативные данные.| | |url|\-|`строка`| |URL, связанный с триггером.| | |status|\-|`строка`|0 — ENABLED (по умолчанию)<br>1 — DISABLED|Состояние триггера.| | |priority|\-|`строка`|0 — NOT\_CLASSIFIED (по умолчанию)<br>1 — INFO<br>2 — WARNING<br>3 — AVERAGE<br>4 — HIGH<br>5 — DISASTER|Важность триггера.| | |description|\-|`текст`| |Описание триггера.| | |type|\-|`строка`|0 — SINGLE (по умолчанию)<br>1 — MULTIPLE|Тип генерации событий (одно событие о проблеме или множественные события о проблемах).| | |manual\_close|\-|`строка`|0 — NO (по умолчанию)<br>1 — YES|Закрытие вручную событий о проблемах.| |dependencies| |\-| | |Корневой элемент зависимостей.| | |name|x|`строка`| |Имя зависимого триггера.| | |expression|x|`строка`| |Выражение зависимого триггера.| | |recovery\_expression|\-|`строка`| |Выражение восстановления зависимого триггера.| |tags| |\-| | |Корневой элемент тегов событий.| | |tag|x|`строка`| |Имя тега.| | |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|Whether to validate that the host's certificate is authentic.| | |verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host name for the connection matches the one in the host's certificate.| | |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.| ##### Теги веб-сценариев узла сети |Элемент|Свойство элемента|Обязательный|Тип|Диапазон^**[1](#примечания)**^|Описание| |--|--|-|--|----|--------| |httptests| |\-| | |Корневой элемент веб-сценариев.| | |name|x|`строка`| |Имя веб-сценария.| | |delay|\-|`строка`|По умолчанию: 1m|Частота выполнения веб-сценария. Секунды, единицы времени с суффиксом или пользовательский макрос.| | |attempts|\-|`целое число`|1-10 (по умолчанию: 1)|Количество попыток выполнения шагов веб-сценария.| | |agent|\-|`строка`|По умолчанию: Zabbix|Агент клиента. Zabbix будет притворяться выбранным браузером. Эта опция полезна, когда веб-сайт возвращает разное содержимое для разных браузеров.| | |http\_proxy|\-|`строка`| |Укажите используемый HTTP прокси, используя формат: `http://[имя_пользователя[:пароль]@]прокси.моякомпания.com[:порт]`| |variables| |\-| | |Корневой элемент переменных (макросов) на уровне сценария, которые могут быть использованы в шагах сценария.| | |name|x|`текст`| |Имя переменной.| | |value|x|`текст`| |Значение переменной.| |headers| |\-| | |Корневой элемент заголовков HTTP, которые будут отосланы при выполнении запроса. Заголовки должны быть перечислены, используя такой же синтаксис, как если бы они появлялись в протоколе HTTP.| | |name|x|`текст`| |Имя заголовка.| | |value|x|`текст`| |Значение заголовка.| | |status|\-|`строка`|0 — ENABLED (по умолчанию)<br>1 — DISABLED|Состояние веб-сценария.| | |authentication|\-|`строка`|0 — NONE (по умолчанию)<br>1 — BASIC<br>2 — NTLM|Метод аутентификации.| | |http\_user|\-|`строка`| |Имя пользователя для basic, HTTP или NTLM аутентификации.| | |http\_password|\-|`строка`| |Пароль для basic, HTTP или NTLM аутентификации.| | |verify\_peer|\-|`строка`|0 — NO (по умолчанию)<br>1 — YES|Проверка SSL сертификата веб-сервера.| | |verify\_host|\-|`строка`|0 — NO (по умолчанию)<br>1 — YES|Проверка, что поле Общее Имя или поле Дополнительное Имя Субъекта сертификата веб-сервера совпадают.| | |ssl\_cert\_file|\-|`строка`| |Имя файла SSL сертификата, используемого для аутентификации клиента (должен быть в формате PEM).| | |ssl\_key\_file|\-|`строка`| |Имя файла закрытого ключа SSL, используемого для аутентификации клиента (должен быть в формате PEM).| | |ssl\_key\_password|\-|`строка`| |Пароль к файлу закрытого ключа SSL.| |steps| |x| | |Корневой элемент шагов веб-сценариев.| | |name|x|`строка`| |Имя шага веб-сценария.| | |url|x|`строка`| |Наблюдаемый URL.| |query\_fields| |\-| | |Корневой элемент полей запроса — массив полей HTTP, которые будут добавлены к URL при формировании запроса.| | |name|x|`строка`| |Имя поля запроса.| | |value|\-|`строка`| |Значение поля запроса.| |posts| |\-| | |Переменные HTTP POST как строка (сырые post данные) или как массив полей HTTP (данные полей формы).| | |name|x|`строка`| |Имя поля post.| | |value|x|`строка`| |Значение поля post.| |variables| |\-| | |Корневой элемент переменных (макросов) уровня шага, которые могут применяться после этого шага.<br><br>Если значение переменной имеет префикс «regex:», тогда её значение извлекается из данных, которые получены на этом шаге, в соответствии с шаблоном регулярного выражения, следующим за префиксом «regex:».| | |name|x|`строка`| |Имя переменной.| | |value|x|`строка`| |Значение переменной.| |headers| |\-| | |Корневой элемент HTTP заголовков, которые будут отправлены при выполнении запроса. Заголовки должны быть перечислены, используя такой же синтаксис, как если бы они появлялись в протоколе HTTP.| | |name|x|`строка`| |Имя заголовка.| | |value|x|`строка`| |Значение заголовка.| | |follow\_redirects|\-|`строка`|0 — NO<br>1 — YES (по умолчанию)|Следование HTTP перенаправлениям.| | |retrieve\_mode|\-|`строка`|0 — BODY (по умолчанию)<br>1 — HEADERS<br>2 — BOTH|Режим получения HTTP ответа.| | |timeout|\-|`строка`|По умолчанию: 15s|Время ожидания выполнения шага. Секунды, единицы времени с суффиксом или пользовательский макрос.| | |required|\-|`строка`| |Текст, который должен присутствовать в ответе. Игнорируется, если пусто.| | |status\_codes|\-|`строка`| |Список допустимых кодов состояний, разделённых запятыми. Игнорируется, если пустой. Например: 200-201,210-299| |tags| |\-| | |Корневой элемент тегов веб-сценария.| | |tag|x|`строка`| |Имя тега.| | |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, data kept in these tables will still be stored in partitions, however, the housekeeper will not drop outdated partitions, and warnings about incorrect configuration will be displayed. 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) является периодический процесс, выполняемый Zabbix сервером. Этот процесс удаляет устаревшую информацию и информацию, удалённую пользователями.  На этой странице задания очистки истории можно включить и отключить отдельно по видам задач для: событий и оповещений/услуг/аудита/сессий пользователей/истории значений/динамики изменений. Настройки очистки аудитных записей доступны в отдельном [разделе меню](/manual/web_interface/frontend_sections/administration/general#журнал-аудита). Если очистка истории включена, имеется возможность настроить, какое количество дней данные истории будут храниться, прежде чем они будут удалены процессом очистки истории. Удаление элемента данных/триггера также приведёт к удалению проблем, которые были сгенерированы этим удаляемым элементом данных/триггером. Также событие будет удалено процессом очистки истории, только если оно не связано с проблемой каким-либо образом. Это означает, что если событие является либо событием о проблеме, либо событием о восстановлении, то оно не будет удалено, пока не будет удалена соответствующая запись о проблеме. Процесс очистки истории сначала удалит проблемы и затем — события, чтобы избежать потенциальных проблем с зависшими записями событий или проблем. Для истории и динамики изменений доступны дополнительные параметры: *Переопределить период хранения истории элементов данных (Override itemhistory period)* и *Переопределить период хранения динамики изменения элементов данных (Override item trend period)*. Эти опции позволяют глобально задать, сколько дней будет храниться история/динамика изменений элементов данных (от 1 часа до 25 лет, либо «0»), в этом случае переопределяя значения, выставленные для отдельных элементов данных в полях *Период хранения истории/Период хранения динамики изменений (History storage period/Trend storage period)* в [настройках элементов данных](/manual/config/items/item). Обратите внимание, что период хранения не будет переопределён для тех элементов данных, в настройках которых выставлены опции *Не хранить историю (Do not keep history)* и/или *Не хранить динамику изменений (Do not keep trends)*. Имеется возможность переопределить период хранения истории/динамики изменений, даже если внутренний процесс очистки истории отключён. Таким образом, при использовании внешнего процесса очистки истории период хранения истории можно задать, используя поле *Период хранения данных (Data storage period)*. ::: noteimportant При использовании TimescaleDB, чтобы в полной мере воспользоваться преимуществами автоматического партиционирования таблиц истории и динамики изменений TimescaleDB, флажки *Переопределить период хранения истории элементов данных (Override item history period)* и *Переопределить период хранения динамики изменения элементов данных (Override item trend period)* должны быть выставлены, так же как и флажок *Активировать внутреннюю очистку истории (Enable internal housekeeping)* для истории и динамики изменений. В противном случае данные, хранящиеся в этих таблицах, будут храниться в партициях; однако, процесс очистки истории не будет удалять устаревшие партиции, и будет отображаться предупреждение о неправильной конфигурации. Если удаление устаревших партиций включено, то Zabbix сервер и веб-интерфейс более не будут отслеживать удалённые элементы данных, а история по удалённым элементам данных будет очищаться при удалении устаревших партиций. ::: В полях периодов поддерживаются [суффиксы времени](/manual/appendix/suffixes), например: 1d (один день), 1w (одна неделя). Минимальное значение равно 1 дню (1 часу для истории), максимальное — 25 годам. Кнопка *Сбросить по умолчанию (Reset defaults)* позволяет отменить любые сделанные изменения. # housekeeping.get # housekeeping.get #### 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. #### Как это работает В мониторинге журналов вы можете встретиться со строками, похожими на эти: Строка1: Приложение 1 остановлено Строка2: Приложение 2 остановлено Строка3: Приложение 1 перезапущено Строка4: Приложение 2 перезапущено Идея корреляции событий состоит в том, чтобы была возможность сопоставить событие о проблеме из Строки1 с решением из Строки3 и событие о проблеме из Строки2 с решением из Строки4 и закрыть эти проблемы по отдельности: Строка1: Приложение 1 остановлено Строка3: Приложение 1 перезапущено #проблема из Строки 1 закрыта Строка2: Приложение 2 остановлено Строка4: Приложение 2 перезапущено #проблема из Строки 2 закрыта Чтобы такое сделать, вам необходимо пометить эти связанные события как, например, «Приложение 1» и «Приложение 2». Это можно сделать, применив регулярное выражение к строке из файла журнала, чтобы извлечь значение тега. Затем при создании события они будут помечены как «Приложение 1» и «Приложение 2» соответственно, и проблема может быть сопоставлена с решением. ### 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 в атрибуции Geomap Текст атрибуции для [виджета панели Геокарта](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) теперь может содержать только обычный текст; поддержка HTML была прекращена. Если это поле уже содержит HTML, то после обновления оно будет отрисовано как обычный текст. В настройках [Географические карты](/manual/web_interface/frontend_sections/administration/general#географические-карты) в разделе Администрирование → Общие, поле *Атрибуция* теперь отображается только когда *Провайдер плитки* выставлено в *Другое*. ### 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 в атрибуции Geomap Текст атрибуции для [виджета панели Геокарта](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) теперь может содержать только обычный текст; поддержка HTML была прекращена. В настройках [Географические карты](/manual/web_interface/frontend_sections/administration/general#географические-карты) в разделе Администрирование → Общие, поле *Атрибуция* теперь отображается только когда *Провайдер плитки* выставлено в *Другое*. ### 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 или веб-сервера (например: базовая аутентификация, NTLM/Kerberos). Обратите внимание, что пользователь также должен существовать в Zabbix; однако, его пароль Zabbix не будет использоваться. ::: noteimportant Будьте осторожны! Перед переключением на аутентификацию веб-сервера убедитесь, что она настроена и работает правильно. :::  Параметры конфигурации: |Параметр|Описание| |--|--------| |*Активация HTTP аутентификации*<br>*(Enable HTTP authentication)*|Отметьте флажок, чтобы включить аутентификацию HTTP. При наведении указателя мыши на  появится подсказка с предупреждением, что в случае аутентификации веб-сервера все пользователи (даже с [доступом к веб-интерфейсу](/manual/config/users_and_usergroups/usergroup#настройка), установленному в LDAP/внутренний) будут аутентифицироваться веб-сервером, а не сервером Zabbix.| |*Диалог входа в систему по умолчанию*<br>*(Default login form)*|Укажите, следует ли направлять неаутентифицированных пользователей на:<br>**Диалог входа в систему Zabbix** — стандартную страницу входа Zabbix.<br>**HTTP диалог входа в систему** — страницу входа HTTP.<br>Рекомендуется включать аутентификацию на основе веб-сервера только для страницы `index_http.php`. Если для *Диалога входа в систему по умолчанию* установлено значение «HTTP диалог входа в систему», пользователь будет входить в систему автоматически, если модуль аутентификации веб-сервера установит действительный логин пользователя в переменной `$_SERVER`.<br>Поддерживаемые ключи `$_SERVER`: ` PHP_AUTH_USER`, `REMOTE_USER`, `AUTH_USER`.| |*Удаление имени домена*<br>*(Remove domain name)*|Список доменных имен через запятую, которые следует удалить из имени пользователя.<br>Например: `comp,any` - если имя пользователя «Admin\@any» или «comp\\Admin», пользователь войдет в систему как «Admin»; если имя пользователя «notacompany\\Admin», вход будет запрещён.| |*Регистрозависимый вход*<br>*(Case sensitive login)*|Снимите флажок, чтобы отключить для имен пользователей вход с учётом регистра (включённый по умолчанию).<br>Отключение входа с учётом регистра позволяет, например, войти в систему пользователем «admin», даже если пользователем Zabbix является «Admin» или «ADMIN».<br>Обратите внимание, что если вход с учётом регистра отключён и существует несколько Zabbix пользователей с похожими именами пользователей (например, Admin и admin), вход для этих пользователей всегда будет запрещён со следующим сообщением об ошибке: «Authentication failed: supplied credentials are not unique (Аутентификация не удалась: предоставленные учётные данные не уникальны)».| ::: notetip Для внутренних пользователей, которые не могут войти в систему с использованием учётных данных HTTP (с установленным по умолчанию диалогом входа HTTP), что приводит к ошибке 401, вы можете добавить строку «`ErrorDocument 401 /index.php?form=default`» к основным директивам аутентификации, что перенаправит на обычный диалог входа в Zabbix. ::: #### HttpRequest ::: noteimportant "HttpRequest" is a new name for this object since Zabbix 5.4. Previously it was called "CurlHttpRequest". Method names have also been changed in Zabbix 5.4. The old object/method names are now deprecated and their support will be discontinued after Zabbix 6.0. ::: This object encapsulates cURL handle allowing to make simple HTTP requests. Errors are thrown as exceptions. ::: noteimportant The initialization of multiple `HttpRequest` objects is limited to 10 per script execution. ::: |Method|Description| |--|--------| |`addHeader(value)`|Adds HTTP header field. This field is used for all following requests until cleared with the `clearHeader()` method.<br>The total length of header fields that can be added to a single `HttpRequest` object is limited to 128 Kbytes (special characters and header names included).| |`clearHeader()`|Clears HTTP header. If no header fields are set, `HttpRequest` will set Content-Type to application/json if the data being posted is JSON-formatted; text/plain otherwise.| |`connect(url)`|Sends HTTP CONNECT request to the URL and returns the response.| |`customRequest(method, url, data)`|Allows to specify any HTTP method in the first parameter. Sends the method request to the URL with optional *data* payload and returns the response.| |`delete(url, data)`|Sends HTTP DELETE request to the URL with optional *data* payload and returns the response.| |`getHeaders(<asArray>)`|Returns the object of received HTTP header fields.<br>The `asArray` parameter may be set to "true" (e.g. `getHeaders(true)`), "false" or be undefined. If set to "true" the received HTTP header field values will be returned as arrays; this should be used to retrieve the field values of multiple same-name headers.<br>If not set or set to "false", the received HTTP header field values will be returned as strings.| |`get(url, data)`|Sends HTTP GET request to the URL with optional *data* payload and returns the response.| |`head(url)`|Sends HTTP HEAD request to the URL and returns the response.| |`options(url)`|Sends HTTP OPTIONS request to the URL and returns the response.| |`patch(url, data)`|Sends HTTP PATCH request to the URL with optional *data* payload and returns the response.| |`put(url, data)`|Sends HTTP PUT request to the URL with optional *data* payload and returns the response.| |`post(url, data)`|Sends HTTP POST request to the URL with optional *data* payload and returns the response.| |`getStatus()`|Returns the status code of the last HTTP request.| |`setProxy(proxy)`|Sets HTTP proxy to "proxy" value. If this parameter is empty then no proxy is used.| |`setHttpAuth(bitmask, username, password)`|Sets enabled HTTP authentication methods (HTTPAUTH\_BASIC, HTTPAUTH\_DIGEST, HTTPAUTH\_NEGOTIATE, HTTPAUTH\_NTLM, HTTPAUTH\_NONE) in the 'bitmask' parameter.<br>The HTTPAUTH\_NONE flag allows to disable HTTP authentication.<br>Examples:<br>``request.setHttpAuth(HTTPAUTH_NTLM | HTTPAUTH_BASIC, username, password)`<br>`request.setHttpAuth(HTTPAUTH_NONE)``| |`trace(url, data)`|Sends HTTP TRACE request to the URL with optional *data* payload and returns the response.| Example: ```javascript try { Zabbix.log(4, 'jira webhook script value='+value); var result = { 'tags': { 'endpoint': 'jira' } }, params = JSON.parse(value), req = new HttpRequest(), fields = {}, resp; req.addHeader('Content-Type: application/json'); req.addHeader('Authorization: Basic '+params.authentication); fields.summary = params.summary; fields.description = params.description; fields.project = {"key": params.project_key}; fields.issuetype = {"id": params.issue_id}; resp = req.post('https://jira.example.com/rest/api/2/issue/', JSON.stringify({"fields": fields}) ); if (req.getStatus() != 201) { throw 'Response code: '+req.getStatus(); } resp = JSON.parse(resp); result.tags.issue_id = resp.id; result.tags.issue_key = resp.key; } catch (error) { Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields})); Zabbix.log(4, 'jira issue creation failed : '+error); result = {}; } return JSON.stringify(result); ``` #### HttpRequest ::: noteimportant HttpRequest — новое имя этого объекта с Zabbix 5.4. Ранее он назывался «CurlHttpRequest». Имена методов также изменились в Zabbix 5.4. Старые имена объекта/методов теперь считаются устаревшими, и их поддержка будет прекращена после Zabbix 6.0. ::: Этот объект инкапсулирует обработчик cURL, который позволяет выполнять простые HTTP запросы. Ошибки сообщаются как исключения. ::: noteimportant Инициализация нескольких объектов `HttpRequest` ограничена количеством 10 штук на выполняемый скрипт. ::: |Метод|Описание| |--|--------| |`addHeader(значение)`|Добавление поля HTTP заголовка. Это поле используется для всех последующих вызовов, до момента очистки при помощи метода `clearHeader()`.<br>Суммарная длина полей заголовков, которые могут быть добавлены к одному объекту `HttpRequest`, ограничена величиной 128 килобайт (включая специальные символы и имена заголовков).| |`clearHeader()`|Очистка HTTP заголовка. Если заданные поля заголовков отсутствуют, `HttpRequest` задаст Content-Type значением application/json, если публикуемые данные отформатированы в виде JSON; в противном случае — text/plain.| |`connect(url)`|Отправка на URL HTTP запроса CONNECT и получение ответа.| |`customRequest(метод, url, данные)`|Позволяет указать первым параметром любой HTTP метод. Отправляет на URL запрос указанным методом с опциональной полезной нагрузкой в параметре *данные* и возвращает ответ.| |`delete(url, данные)`|Отправка на URL HTTP запроса DELETE с опциональной полезной нагрузкой в параметре *данные* и получение ответа.| |`getHeaders(<в_виде_массива>)`|Возвращает объект полученных полей HTTP заголовков.<br>Параметр `в_виде_массива` можно задать значением «true» (например, `getHeaders(true)`), «false» или неопределённым. Если задано значением «true», полученные значения полей HTTP заголовков вернутся в виде массивов; это следует использовать для получения значений полей нескольких заголовков с одинаковыми именами.<br>Если не задано или значение «false», полученные значения полей HTTP заголовков возвращаются в виде строк.| |`get(url, данные)`|Отправка на URL HTTP запроса GET с опциональной полезной нагрузкой в параметре *данные* и получение ответа.| |`head(url)`|Отправка на URL HTTP запроса HEAD и получение ответа.| |`options(url)`|Отправка на URL HTTP запроса OPTIONS и получение ответа.| |`patch(url, данные)`|Отправка на URL HTTP запроса PATCH с опциональной полезной нагрузкой в параметре *данные* и получение ответа.| |`put(url, данные)`|Отправка на URL HTTP запроса PUT с опциональной полезной нагрузкой в параметре *данные* и получение ответа.| |`post(url, данные)`|Отправка на URL HTTP запроса POST с опциональной полезной нагрузкой в параметре *данные* и получение ответа.| |`getStatus()`|Получение кода состояния последнего HTTP запроса.| |`setProxy(прокси)`|Задаёт HTTP прокси значением «прокси». Если этот параметр пустой, то никакой прокси не используется.| |`setHttpAuth(битовая_маска, имя_пользователя, пароль)`|Включение методов HTTP аутентификации (HTTPAUTH\_BASIC, HTTPAUTH\_DIGEST, HTTPAUTH\_NEGOTIATE, HTTPAUTH\_NTLM, HTTPAUTH\_NONE) в параметре «битовая_маска».<br>Флаг HTTPAUTH\_NONE позволяет отключить HTTP аутентификацию.<br>Например:<br>`request.setHttpAuth(HTTPAUTH_NTLM | HTTPAUTH_BASIC, username, password)`<br>`request.setHttpAuth(HTTPAUTH_NONE)`| |`trace(url, данные)`|Отправка на URL HTTP запроса TRACE с опциональной полезной нагрузкой в параметре *данные* и получение ответа.| Пример: ```javascript try { Zabbix.log(4, 'jira webhook script value='+value); var result = { 'tags': { 'endpoint': 'jira' } }, params = JSON.parse(value), req = new HttpRequest(), fields = {}, resp; req.addHeader('Content-Type: application/json'); req.addHeader('Authorization: Basic '+params.authentication); fields.summary = params.summary; fields.description = params.description; fields.project = {"key": params.project_key}; fields.issuetype = {"id": params.issue_id}; resp = req.post('https://jira.example.com/rest/api/2/issue/', JSON.stringify({"fields": fields}) ); if (req.getStatus() != 201) { throw 'Response code: '+req.getStatus(); } resp = JSON.parse(resp); result.tags.issue_id = resp.id; result.tags.issue_key = resp.key; } catch (error) { Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields})); Zabbix.log(4, 'jira issue creation failed : '+error); result = {}; } return JSON.stringify(result); ``` #### 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 проверки Веб-сценарии и элементы данных с типом HTTP агент, использующие https протокол, Zabbix агент проверки `net.tcp.service[https...]` и `net.tcp.service.perf[https...]` могут завершится с ошибкой, если целевой сервер настроен на запрещение протокола TLS v1.0 и версии ниже. Пожалуйста, обратитесь к [ZBX-9879](https://support.zabbix.com/browse/ZBX-9879) для получения более подробных сведений и возможных вариантов решения. # 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! ::: #### Гистерезис Порой нам необходим некоторый интервал между состояниями ОК и Проблема, а не просто порог. Например, если мы хотим задать триггер, который переходит в состояние Проблема, когда температура в серверной комнате становится больше 20°C, и мы хотим, чтобы он оставался в этом состоянии, пока температура не опустится ниже 15°C, то просто порога в 20°C для триггера будет недостаточно. Вместо этого нам нужно сначала задать выражение триггера для события проблемы (температура выше 20°C). Затем нам нужно задать дополнительное условие восстановления (температура ниже 15°C). Это можно сделать, задавая дополнительный параметр *Выражение восстановления* в [настройках](/manual/config/triggers/trigger) триггера. В этом случае восстановление проблемы будет проходить в два этапа: - Во-первых, выражение проблемы (температура выше 20°C) должно быть вычислено в значение ЛОЖЬ - Во-вторых, выражение восстановления (температура ниже 15°C) должно быть вычислено в значение ИСТИНА Выражение восстановления будет вычисляться, только когда сначала будет решено событие о проблеме. ::: notewarning Выражение восстановления, которое в состоянии ИСТИНА, не решает проблему, если выражение проблемы по-прежнему равно ИСТИНА! ::: #### ICMP pings Zabbix uses external utility **fping** for processing of ICMP pings. The utility is not part of Zabbix distribution and has to be additionally installed. If the utility is missing, has wrong permissions or its location does not match the location set in the Zabbix server/proxy configuration file ('FpingLocation' parameter), ICMP pings (**icmpping**, **icmppingloss**, **icmppingsec**) will not be processed. See also: [known issues](/manual/installation/known_issues#simple_checks) **fping** must be executable by the user Zabbix daemons run as and setuid root. Run these commands as user **root** in order to set up correct permissions: chown root:zabbix /usr/sbin/fping chmod 4710 /usr/sbin/fping After performing the two commands above check ownership of the **fping** executable. In some cases the ownership can be reset by executing the chmod command. Also check, if user zabbix belongs to group zabbix by running: groups zabbix and if it's not add by issuing: usermod -a -G zabbix zabbix Defaults, limits and description of values for ICMP check parameters: |Parameter|Unit|Description|Fping's flag|Defaults set by|<|Allowed limits<br>by Zabbix|<| |--|--|--------|-|--|--|--|--| | | | | |**fping**|**Zabbix**|**min**|**max**| |packets|number|number of request packets to a target|-C| |3|1|10000| |interval|milliseconds|time to wait between successive packets|-p|1000| |20|unlimited| |size|bytes|packet size in bytes<br>56 bytes on x86, 68 bytes on x86_64|-b|56 or 68| |24|65507| |timeout|milliseconds|**fping v3.x** - timeout to wait after last packet sent, affected by *-C* flag<br> **fping v4.x** - individual timeout for each packet|-t|**fping v3.x** - 500<br>**fping v4.x** - inherited from *-p* flag, but not more than 2000| |50|unlimited| In addition Zabbix uses fping options *-i interval ms* (do not mix up with the item parameter *interval* mentioned in the table above, which corresponds to fping option *-p*) and *-S source IP address* (or *-I* in older fping versions). Those options are auto-detected by running checks with different option combinations. Zabbix tries to detect the minimal value in milliseconds that fping allows to use with *-i* by trying 3 values: 0, 1 and 10. The value that first succeeds is then used for subsequent ICMP checks. This process is done by each [ICMP pinger](/manual/concepts/server#server_process_types) process individually. Auto-detected fping options are invalidated every hour and detected again on the next attempt to perform ICMP check. Set DebugLevel>=4 in order to view details of this process in the server or proxy log file. ::: notewarning Warning: fping defaults can differ depending on platform and version - if in doubt, check fping documentation. ::: Zabbix writes IP addresses to be checked by any of three *icmpping\** keys to a temporary file, which is then passed to **fping**. If items have different key parameters, only ones with identical key parameters are written to a single file.<br> All IP addresses written to the single file will be checked by fping in parallel, so Zabbix icmp pinger process will spend fixed amount of time disregarding the number of IP addresses in the file. #### ICMP пинг Для обработки ICMP пингов Zabbix использует внешнюю утилиту **fping**. Эта утилита не является частью дистрибутива Zabbix и должна быть установлена дополнительно. Если утилиты нет, у неё выставлены неверные разрешения или её размещение не совпадает с размещением, заданным в файле конфигурации Zabbix сервера/прокси (параметры «FpingLocation»), ICMP пинги (**icmpping**, **icmppingloss**, **icmppingsec**) не будут обрабатываться. Смотрите также: [известные проблемы](/manual/installation/known_issues#простые-проверки) **fping** должен быть доступен для выполнения пользователем, от которого работают демоны Zabbix, и должен иметь setuid root. Выполните эти команды как пользователь **root**, чтобы настроить правильные разрешения: chown root:zabbix /usr/sbin/fping chmod 4710 /usr/sbin/fping После выполнения этих двух команд выше проверьте владельца исполняемого файла **fping**. В некоторых случаях владелец может сброситься при выполнении команды chmod. Также проверьте, принадлежит ли пользователь zabbix к группе zabbix, запустив команду: groups zabbix и, если нет, добавьте следующей командой: usermod -a -G zabbix zabbix Значения по умолчанию, ограничения и описания значений для параметров ICMP проверок: |Параметр|Ед. изм|Описание|Флаг у fping|Значения по умолчанию у|<|Разрешённые ограничения<br>в Zabbix|<| |--|--|--------|-|--|--|--|--| | | | | |**fping**|**Zabbix**|**мин**|**макс**| |пакеты|количество|количество запросов пакетов к цели|-C| |3|1|10000| |интервал|миллисекунды|время ожидания между последовательными пакетами|-p|1000| |20|без ограничений| |размер|байты|размер пакета в байтах<br>56 байт на x86, 68 байт на x86_64|-b|56 или 68| |24|65507| |время ожидания|миллисекунды|**fping v3.x** — время ожидания после отправки последнего пакета, на которое влияет флаг *-C*<br> **fping v4.x** — отдельное время ожидания по каждому пакету|-t|**fping v3.x** — 500<br>**fping v4.x** — наследуется от флага *-p*, но не более 2000| |50|без ограничений| Кроме того, Zabbix использует опции fping *-i интервал мс* (не путайте с параметром *интервал* элемента данных, упомянутым в таблице выше, который соответствует опции *-p*) и *-S исходящий IP адрес* (или *-I* в более старых версиях fping). Эти параметры автоматически определяются при выполнении проверок с различными комбинациями опций. Zabbix пытается определить минимальное значение в миллисекундах, которое fping позволяет использовать с *-i*, перебирая 3 значения: 0, 1 и 10. Первое удачное значение затем используется для последующих ICMP проверок. Этот процесс выполняется каждым процессом [ICMP пингер](/manual/concepts/server#типы-процессов-сервера) отдельно. Автоматически определённые опции fping аннулируются каждый час, и процесс определения выполняется снова при следующей попытке выполнения ICMP проверки. Задайте DebugLevel>=4 для просмотра сведений об этом процессе в файлах журналов сервера или прокси. ::: notewarning Предупреждение: Значения по умолчанию для fping могут различаться в зависимости от платформы и версии — если сомневаетесь, проверьте документацию по fping. ::: Zabbix записывает IP адреса, проверяемые по всем трем ключам *icmpping\**, во временный файл, который затем передается утилите **fping**. Если элементы данных имеют различные параметры ключа, то в один файл записываются только элементы данных с идентичными параметрами ключа.<br> Все записанные в один файл IP адреса проверяются утилитой fping в параллельном режиме, поэтому процесс Zabbix icmp pinger тратит фиксированное время вне зависимости от количества IP адресов в файле. ##### 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#создание-карты-сети) карты сети отмечена опция *Подсветка иконок*. . # iconmap.create # iconmap.create # iconmap.delete # iconmap.delete # iconmap.get # iconmap.get #### 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) для автоматического назначения подходящих иконок соответствующим узлам сети. Для создания нового соответствия иконок, нажмите на *Создать соответствие иконок (Create icon map)* в правом верхнем углу. {width="600"} Параметры настроек: |Параметр|Описание| |--|--------| |*Имя (Name)*|Уникальное имя соответствия иконок.| |*Преобразования*<br>*(Mappings)*|Список преобразований. Порядок преобразований определяет, какой приоритет будет иметь преобразование. Вы можете перемещать преобразования выше и ниже по списку, используя перетаскивание (drag-and-drop).| |*Поле инвентарных данных*<br>*(Inventory field)*|Поле инвентарных данных узла сети, которое будет просматриваться при поиске соответствий.| |*Выражение (Expression)*|Регулярное выражение описывающее соответствие.| |*Иконка (Icon)*|Иконка, используемая, если соответствие выражению найдено.| |*По умолчанию (Default)*|Иконка, используемая по умолчанию.| # 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. Если права доступа к файлам постоянного хранилища отозваны во время работы агента или возникают другие ошибки (например, заполнился диск), тогда ошибки вносятся в файл журнала агента, но элемент данных не становится НЕПОДДЕРЖИВАЕМЫМ. ##### 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 Аналогично, для остановки/перезапуска/просмотра состояния, используйте следующие команды: 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. ##### В случае ошибки тестирования вебхука - Отобразится сообщение *«Ошибка при тестировании способа оповещения. (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 ##### В случае успешного теста вебхука - Появится сообщение: *«Успешное тестирование способа оповещения. (Media type test successful.)»* - В сером поле *Ответ (Response)* отобразится полученный ответ сервера - Ниже поля *Ответ* будет указан тип ответа (JSON или Строка) # 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. ::: #### Изображения Раздел *Изображения (Images)* отображает все изображения, доступные в Zabbix. Изображения хранятся в базе данных. {width="600"} Выпадающее меню *Тип* позволяет вам переключаться между изображениями иконок и фоновыми рисунками: - Иконки используются при отображении элементов [карт сетей](/manual/config/visualization/maps/map) - Фоновые рисунки используются в качестве фона карт сетей **Добавление изображения** Вы можете добавить своё собственное изображение, нажав на кнопку *Создать иконку (Create icon)* или *Создать фон (Create background)* в правом верхнем углу.  Атрибуты изображений: |Параметр|Описание| |--|--------| |*Имя (Name)*|Уникальное имя изображения.| |*Загрузить (Upload)*|Выберите файл (PNG, JPEG, GIF) с локальной системы для загрузки в Zabbix.<br>*Обратите внимание*, что может быть возможно загрузить и другие форматы, которые будут преобразованы в PNG во время загрузки. Для обработки изображений используется библиотека GD, поэтому поддерживаемые форматы зависят от версии используемой библиотеки (для Zabbix требуется 2.0.28 или выше).| ::: noteclassic Максимальный размер загружаемого файла ограничен значением ZBX\_MAX\_IMAGE\_SIZE и составляет 1024x1024 байт или 1 МБ. Загрузка может быть неуспешной, если размер изображения близок к 1 МБ и параметр конфигурации `max_allowed_packet`в MySQL имеет значение по умолчанию в 1МБ. В этом случае увеличьте параметр [max\_allowed\_packet \[en\]](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet). ::: ### Image The image object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |imageid|string|*(readonly)* ID of the image.| |**name**<br>(required)|string|Name of the image.| |imagetype|integer|Type of image.<br><br>Possible values:<br>1 - *(default)* icon;<br>2 - background image.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Изображение Объект изображения имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |imageid|строка|*(только для чтения)* ID изображения.| |**name**<br>(обязательное)|строка|Имя изображения.| |imagetype|целое число|Тип изображения.<br><br>Возможные значения:<br>1 - *(default)* иконка;<br>2 - фоновое изображение.| Обратите внимание, что для некоторых методов (обновление, удаление) комбинация обязательных/необязательных параметров отличается. # 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 или нод. Каждая нода: - настраивается отдельно (файл конфигурации, скрипты, шифрование, экспорт данных) - использует ту же базу данных - имеет несколько режимов: активная, резервная, недоступная, остановленная Только одна нода может быть активной (рабочей) в один момент времени. На резервной ноде работает только один процесс — HA manager. Резервная нода не выполняет сбор данных, обработку или какие-либо другие обычные действия сервера; она не слушает порты; имеет минимальное количество подключений к базе данных. Как активные, так и резервные ноды выполняют обновление времени своего последнего доступа каждые 5 секунд. Каждая резервная нода наблюдает за временем последнего доступа активной ноды. Если время последнего доступа активной ноды превышает «задержку при аварийном переключении» в секундах, резервная нода переключает себя в в режим активной ноды и назначает состояние «недоступна» ранее активной ноде. Активная нода отслеживает свое собственное подключение к базе данных — если подключение потеряно более чем на `задержка при аварийном переключении-5` секунд, нода должна остановить всю обработку и переключиться в резервный режим. Активная нода также отслеживает состояния резервных нод — если время последнего доступа резервной ноды превышает «задержку при аварийном переключении» в секундах, резервной ноде присваивается состояние «недоступная». Ноды разрабытывались таким образом, чтобы быть совместимыми между минорными версиями Zabbix. #### Important notes - All [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system-data) items are disabled by default (even when `DenyKey` is empty), as if `DenyKey=system.run[*]` was set as the [last rule](#allowdeny-rule-order). Because of this, you can allow specific `system.run` items without explicitly denying other `system.run` items. - An item specified in `AllowKey` must also be specified in `DenyKey` (except for `system.run` items); otherwise, Zabbix agent **will not start**. - If possible, use `AllowKey` to allow only required items and deny everything else. Some keys can be abused to read unintended files via path traversal (e.g., `vfs.file.contents["../../../../etc/passwd"]`), and new Zabbix agent versions may introduce keys not covered by your `DenyKey` rules. - `AllowKey` and `DenyKey` configuration does not affect `HostnameItem`, `HostMetadataItem`, or `HostInterfaceItem` agent parameters. - Denied items become unsupported without any hints or error messages; for example: - Zabbix agent [`--print (-p)`](/manual/concepts/agent#other-agent-options) command-line parameter will not show denied item keys. - Zabbix agent [`--test (-t)`](/manual/concepts/agent#other-agent-options) command-line parameter will return "Unsupported item key." for denied item keys. - Zabbix agent log file will not log denied [remote commands](/manual/config/notifications/action/operation/remote_command) if `LogRemoteCommands=1`. #### Важные правила - Все элементы данных [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system-data) по умолчанию запрещены (даже когда `DenyKey` является пустым), как если бы [последним правилом](#порядок-правил-allowdeny) было добавлено `DenyKey=system.run[*]`. Благодаря этому, вы можете разрешить конкретные элементы данных `system.run` без явного запрета остальных элементов данных `system.run`. - Элемент данных, указанный в `AllowKey`, также должен быть указан в `DenyKey` (за исключением элементов данных `system.run`); в противном случае Zabbix агент **не запустится**. - По возможности, используйте `AllowKey` для разрешения только нужных элементов данных и запретите всё остальное. Некоторые ключи могут быть злонамеренно использованы для чтения непредназначенных для этого файлов через так называемые обходные пути (path traversal) (например, `vfs.file.contents["../../../../etc/passwd"]`), а новые версии Zabbix агента могут вводить ключи, не покрываемые вашими правилами `DenyKey`. - Настройки `AllowKey` и `DenyKey` не влияют на параметры агента `HostnameItem`, `HostMetadataItem` и `HostInterfaceItem`. - Запрещённые элементы данных становятся неподдерживаемыми без указания причины или какого-либо сообщения об ошибке; например: - Zabbix агент с параметром командной строки [`--print (-p)`](/manual/concepts/agent#опции) не будет показывать запрещённые ключи элементов данных. - Zabbix агент с параметром командной строки [`--test (-t)`](/manual/concepts/agent#опции) вернёт состояние «Unsupported item key.» (Неподдерживаемый ключ элемента данных) для запрещённых ключей элементов данных. - Zabbix агент не будет записывать в журнал агента отклонённые [удалённые команды](/manual/config/notifications/action/operation/remote_command), если задано `LogRemoteCommands=1`. #### 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. #### Важные замечания - Элементы данных монитора баз данных станут неподдерживаемыми, если процессы *odbc poller* не запускаются в конфигурации сервера или прокси. Чтобы включить ODBC поллеры, задайте *StartODBCPollers* параметр в файле конфигурации Zabbix [сервера](/manual/appendix/config/zabbix_server) или, если проверки выполняются на стороне прокси, в файле конфигурации Zabbix [прокси](/manual/appendix/config/zabbix_proxy). - Zabbix не ограничивает время выполнения запроса. Пользователь сам выбирает запросы, которые выполняются за разумное время. - Значение параметра [Timeout](/manual/appendix/config/zabbix_server) с Zabbix сервера используется как время ожидания выполнения входа в ODBC (обратите внимание, в зависимости от драйвера ODBC время ожидания выполнения входа может быть проигнорировано). - SQL команда должна вернуть набор данных, как и любой запрос с `select ...`. Синтаксис запроса будет зависеть от РСУБД, которая будет его обрабатывать. Синтаксис запроса к хранимой процедуре должен начинаться с ключевого слова `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 Не создавайте разные макросы с контекстом, которые соответствуют одной строке, чтобы избежать неопределённого поведения. ::: - Если макрос со своим контекстом не найден на узле сети, присоединённых шаблонах или на глобальном уровне, тогда будет произведён поиск макроса без контекста. - В контекстах макроса поддерживаются только макросы низкоуровневого обнаружения. Любые другие макросы игнорируются и обрабатываются как текстовые значения. Технически, контекст макроса задаётся с использованием правил, похожих на параметры [ключей элементов данных](/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​"]» одинаковы семантически, но различны для критерия уникальности. #### Important notes - The server and agent keep the trace of a monitored log's size and last modification time (for logrt) in two counters. Additionally: - The agent also internally uses inode numbers (on UNIX/GNU/Linux), file indexes (on Microsoft Windows) and MD5 sums of the first 512 log file bytes for improving decisions when logfiles get truncated and rotated. - On UNIX/GNU/Linux systems it is assumed that the file systems where log files are stored report inode numbers, which can be used to track files. - On Microsoft Windows Zabbix agent determines the file system type the log files reside on and uses: - On NTFS file systems 64-bit file indexes. - On ReFS file systems (only from Microsoft Windows Server 2012) 128-bit file IDs. - On file systems where file indexes change (e.g. FAT32, exFAT) a fall-back algorithm is used to take a sensible approach in uncertain conditions when log file rotation results in multiple log files with the same last modification time. - The inode numbers, file indexes and MD5 sums are internally collected by Zabbix agent. They are not transmitted to Zabbix server and are lost when Zabbix agent is stopped. - Do not modify the last modification time of log files with 'touch' utility, do not copy a log file with later restoration of the original name (this will change the file inode number). In both cases the file will be counted as different and will be analyzed from the start, which may result in duplicated alerts. - If there are several matching log files for `logrt[]` item and Zabbix agent is following the most recent of them and this most recent log file is deleted, a warning message `"there are no files matching "<regexp mask>" in "<directory>"` is logged. Zabbix agent ignores log files with modification time less than the most recent modification time seen by the agent for the `logrt[]` item being checked. - The agent starts reading the log file from the point it stopped the previous time. - The number of bytes already analyzed (the size counter) and last modification time (the time counter) are stored in the Zabbix database and are sent to the agent to make sure the agent starts reading the log file from this point in cases when the agent is just started or has received items which were previously disabled or not supported. However, if the agent has received a non-zero size counter from server, but the logrt\[\] or logrt.count\[\] item is unable to find matching files, the size counter is reset to 0 to analyze from the start if the files appear later. - Whenever the log file becomes smaller than the log size counter known by the agent, the counter is reset to zero and the agent starts reading the log file from the beginning taking the time counter into account. - If there are several matching files with the same last modification time in the directory, then the agent tries to correctly analyze all log files with the same modification time and avoid skipping data or analyzing the same data twice, although it cannot be guaranteed in all situations. The agent does not assume any particular log file rotation scheme nor determines one. When presented multiple log files with the same last modification time, the agent will process them in a lexicographically descending order. Thus, for some rotation schemes the log files will be analyzed and reported in their original order. For other rotation schemes the original log file order will not be honored, which can lead to reporting matched log file records in altered order (the problem does not happen if log files have different last modification times). - Zabbix agent processes new records of a log file once per *Update interval* seconds. - Zabbix agent does not send more than **maxlines** of a log file per second. The limit prevents overloading of network and CPU resources and overrides the default value provided by **MaxLinesPerSecond** parameter in the [agent configuration file](/manual/appendix/config/zabbix_agentd). - To find the required string Zabbix will process 10 times more new lines than set in MaxLinesPerSecond. Thus, for example, if a `log[]` or `logrt[]` item has *Update interval* of 1 second, by default the agent will analyze no more than 200 log file records and will send no more than 20 matching records to Zabbix server in one check. By increasing **MaxLinesPerSecond** in the agent configuration file or setting **maxlines** parameter in the item key, the limit can be increased up to 10000 analyzed log file records and 1000 matching records sent to Zabbix server in one check. If the *Update interval* is set to 2 seconds the limits for one check would be set 2 times higher than with *Update interval* of 1 second. - Additionally, log and log.count values are always limited to 50% of the agent send buffer size, even if there are no non-log values in it. So for the **maxlines** values to be sent in one connection (and not in several connections), the agent [BufferSize](/manual/appendix/config/zabbix_agentd) parameter must be at least maxlines x 2. Zabbix agent can upload data during log gathering and thus free the buffer, whereas Zabbix agent 2 will stop log gathering until the data is uploaded and the buffer is freed, which is performed asynchronously. - In the absence of log items all agent buffer size is used for non-log values. When log values come in they replace the older non-log values as needed, up to the designated 50%. - For log file records longer than 256kB, only the first 256kB are matched against the regular expression and the rest of the record is ignored. However, if Zabbix agent is stopped while it is dealing with a long record the agent internal state is lost and the long record may be analyzed again and differently after the agent is started again. - Special note for "\\" path separators: if file\_format is "file\\.log", then there should not be a "file" directory, since it is not possible to unambiguously define whether "." is escaped or is the first symbol of the file name. - Regular expressions for `logrt` are supported in filename only, directory regular expression matching is not supported. - On UNIX platforms a `logrt[]` item becomes NOTSUPPORTED if a directory where the log files are expected to be found does not exist. - On Microsoft Windows, if a directory does not exist the item will not become NOTSUPPORTED (for example, if directory is misspelled in item key). - An absence of log files for `logrt[]` item does not make it NOTSUPPORTED. Errors of reading log files for `logrt[]` item are logged as warnings into Zabbix agent log file but do not make the item NOTSUPPORTED. - Zabbix agent log file can be helpful to find out why a `log[]` or `logrt[]` item became NOTSUPPORTED. Zabbix can monitor its agent log file, except when at DebugLevel=4 or DebugLevel=5. - Searching for a question mark using a regular expression, e.g. `\?` may result in false positives if the text file contains NUL symbols, as those are replaced with "?" by Zabbix to continue processing the line until the newline character. #### Важные замечания - Сервер и агент следят за размером наблюдаемого журнала и временем последней модификации (для logrt) при помощи двух счётчиков. Кроме того: - Агент также использует номера inode (на UNIX/GNU/Linux), индексы файлов (на Microsoft Windows) и MD5 суммы первых 512 байт файла журнала для улучшения выбора в случае, когда файлы журнала усекаются и ротируются. - На системах UNIX/GNU/Linux предполагается, что файловые системы, где хранятся файлы журналов, сообщают номера inode-ов, которые могут быть использованы для отслеживания файлов. - На системах Microsoft Windows Zabbix агент определяет тип файловой системы, на которой находятся файлы журналов, и использует: - на файловых системах NTFS — 64-битные файловые индексы; - на файловых системах ReFS (только с Microsoft Windows Server 2012) — 128-битные ID файлов; - на файловых системах, где файловые индексы меняются (т.е. FAT32, exFAT), используется запасной алгоритм для получения разумного подхода в неопределённых условиях, когда ротация файла журнала приводит в результате к множеству файлов журналов с одинаковым временем изменения. - Номера inode, индексы файлов и суммы MD5 собираются Zabbix агентом. Они не передаются Zabbix серверу и теряются в случае остановки Zabbix агента. - Не меняйте время последней модификации файлов журналов утилитой «touch», не копируйте файл журнала с последующим восстановлением его имени (это изменит идентификатор inode файла). В обоих случаях файл будет рассматриваться как другой и будет проанализирован с самого начала, что может привести к дубликатам оповещений. - Если имеется несколько совпадающих файлов журналов для элемента данных `logrt[]` и Zabbix агент следит за наиболее новым из них и этот более новый файл журнала удаляется, то будет записано сообщение с предупреждением: «`There are no files matching "<шаблон регулярного выражения>" in "<директория>"`». Zabbix агент игнорирует файлы журналов со временем модификации меньшим, чем последнее время модификации, полученное агентом во время проверки элемента данных `logrt[]`. - Агент начинает читать файл журнала с той позиции, на которой он остановился последний раз. - Количество уже проанализированных байт (счётчик размера) и время последней модификации (счётчик времени) сохраняются в базе данных Zabbix и отправляются агенту, чтобы убедиться, что агент начнёт читать файл журнала с этой позиции в случаях, когда агент только что был запущен или агент получил элементы данных, которые были ранее деактивированы или не поддерживались. Однако, если агент получает ненулевой счётчик размера от сервера, но элементу данных logrt\[\] или logrt.count\[\] не удаётся найти соответствующие файлы, то счётчик размера сбрасывается в 0, чтобы начать анализ с самого начала, если файлы появятся позже. - Всякий раз, когда файл журнала становится меньше, чем известное агенту значение счётчика размера, счётчик обнуляется и агент начинает читать файл журнала с самого начала, принимая во внимание счётчик времени. - Eсли в папке есть несколько соответствующих файлов журналов с одинаковым временем последней модификации, агент пытается корректно проанализировать все файлы журналов с одинаковым временем модификации и избежать пропуска данных или повторного анализа тех же данных, хотя этого и нельзя гарантировать во всех возможных ситуациях. Агент ни предполагает какую либо определённую схему ротации файлов журналов, ни определяет её. Когда есть несколько фалов журналов с одинаковым временем последнего изменения, агент будет обрабатывать их лексикографически в порядке убывания. Таким образом, для некоторых схем ротации файлы журналов будут проанализированы в их оригинальном порядке. Для других же схем ротации журналов первоначальный порядок файла журнала не будет соблюдаться, что может привести к получению найденных по шаблону строк файла журнала в изменённом порядке (проблема не возникает, если файлы журнала имеют разное время последней модификации). - Zabbix агент обрабатывает новые записи файла журнала один раз за *Период обновления* секунд. - Zabbix агент отправляет не более чем **макс. кол-во строк** записей из файла журнала за секунду. Это ограничение предотвращает перегрузку сети и ресурсов процессора и переопределяет значение по умолчанию, предусмотренное параметром **MaxLinesPerSecond** в [файле конфигурации агента](/manual/appendix/config/zabbix_agentd). - Для поиска необходимой строки Zabbix обработает в 10 раз больше строк, чем указано в параметре MaxLinesPerSecond. Таким образом, например, если элемент данных `log[]` или `logrt[]` имеет *Интервал обновления* 1 секунда, то по умолчанию агент за одну проверку проанализирует не более чем 200 строк файла журнала и отправит Zabbix серверу не более 20 совпавших записей. Увеличением параметра **MaxLinesPerSecond** в файле конфигурации агента или указанием параметра **макс. кол-во строк** в ключе элемента данных, лимит можно увеличить вплоть до 10000 проанализированных записей в журнале и 1000 совпадающих записей для отправки Zabbix серверу за одну проверку. Если для параметра *Интервал обновления* указано значение 2 секунды, лимиты для одной проверки могут быть установлены вдвое больше, чем для *Интервала обновления* в 1 секунду. - Кроме того, значения log и log.count всегда ограничены 50% размера буфера отправки у агента, даже если в буфере нет значений, не связанных с данными из файлов журналов. Таким образом, чтобы значения **макс. кол-во строк** были отправлены за одно подключение (а не за несколько подключений), параметр агента [BufferSize](/manual/appendix/config/zabbix_agentd) должен быть равен по крайней мере («макс. кол-во строк» x 2). Zabbix агент может отсылать данные во время сбора данных из журналов и таким образом освобождать буфер, в то время как Zabbix агент 2 остановит сбор данных из журналов до тех пор, пока данные не будут отосланы и буфер освобождён, что выполняется асинхронно. - При отсутствии элементов данных журналов весь размер буфера используется для значений, не связанных с данными из журналов. Когда появляются значения от файлов журналов, они при необходимости заменяют более старые данные, не связанные с файлами журналов, до максимально предусмотренного уровня 50%. - Если в файле журнала строка длиннее 256 КБ, то только первые 256 КБ сопоставляются с регулярным выражением, остальная часть игнорируется. Однако, если Zabbix агент был остановлен в процессе обработки длинной строки, внутреннее состояние агента теряется и после перезапуска агента длинная строчка может быть проанализирована заново и иначе. - Специальное примечание для разделителей пути «\\»: если формат\_файла представлен как «file\\.log», тогда там не должно быть папки «file», поскольку невозможно однозначно определить, экранируется ли это символ «.» или же точка является первым символом в имени файла. - Регулярные выражения для `logrt` поддерживаются только в именах файлов, совпадение регулярного выражения с папкой не поддерживается. - На платформах UNIX элементы данных `logrt[]` становятся НЕПОДДЕРЖИВАЕМЫМИ в случае если папка, где должен был бы находиться файл журнала, не существует. - В Microsoft Windows, если папка не существует, то элемент данных не переводится в состояние НЕ ПОДДЕРЖИВАЕТСЯ (например, если в ключе элемента данных папка указана с ошибкой) - Отсутствие файла журнала для элемента данных `logrt[]` не переводит его в состояние НЕ ПОДДЕРЖИВАЕТСЯ. Ошибки чтения файлов журналов для элемента данных `logrt[]` записываются в журнал агента как предупреждения, но не переводят элемент данных в состояние НЕ ПОДДЕРЖИВАЕТСЯ. - Журнал Zabbix агента может быть очень полезен для поиска причин, почему элементы данных `log[]` или `logrt[]` становятся НЕПОДДЕРЖИВАЕМЫМИ. Zabbix может мониторить свой файл журнала агента, за исключением случая, когда он в режиме DebugLevel=4 или DebugLevel=5. - Поиск знака вопроса при помощи регулярного выражения, например: «`\?`», — может давать ложные срабатывания, если текстовый файл содержит символы NUL, поскольку они заменяются Zabbix-ом на «?», чтобы продолжать обрабатывать строку до символа перевода строки. ### Important notes To perform the database upgrade: 1. Stop Zabbix server. Stopping Zabbix server for the time of the upgrade is strongly recommended. However, if absolutely necessary, you can perform the upgrade while the server is running (only for MySQL, MariaDB, and PostgreSQL without TimescaleDB). 2. Back up your database. 3. Run the scripts for your database. 4. Start Zabbix server. ::: notewarning Run the scripts for the server database only. The proxy will not benefit from this upgrade. ::: If the database uses partitions, contact the DB administrator or Zabbix Support for help. CSV files can be removed after a successful upgrade to primary keys. Optionally, Zabbix frontend may be switched to [maintenance mode](/manual/web_interface/maintenance_mode). ### Важные примечания Чтобы выполнить обновление базы данных: 1. Остановите сервер Zabbix. На время обновления настоятельно рекомендуется остановить сервер Zabbix Однако, в случае крайней необходимости существует способ выполнить обновление при работающем сервере (только для MySQL, MariaDB и PostgreSQL без TimescaleDB). 2. Сделайте резервную копию базы данных. 3. Запустите скрипты для вашей базы данных. 4. Запустите сервер Zabbix. ::: notewarning Запустите скрипты только для базы данных сервера. Прокси-сервер не получит выгоды от этого обновления. ::: Если база данных использует партиционирование, обратитесь за помощью к администратору базы данных или в службу поддержки Zabbix. Файлы CSV можно удалить после успешного обновления на использование первичных ключей. При желании веб-интерфейс Zabbix можно переключить в [режим обслуживания](/manual/web_interface/maintenance_mode). #### 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/doc/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix For proxy with PostgreSQL (or SQLite): # cat /usr/share/doc/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix # cat /usr/share/doc/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db ##### Импорт данных Импортируйте начальную схему: # cat /usr/share/doc/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix Для прокси с PostgreSQL (или SQLite): # cat /usr/share/doc/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix # cat /usr/share/doc/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/doc/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix Для прокси с PostgreSQL (или SQLite): cat /usr/share/doc/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix cat /usr/share/doc/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db ##### Importing data Import initial schema: # zcat /usr/share/doc/zabbix-sql-scripts/mysql/schema.sql.gz | mysql -uzabbix -p zabbix For proxy with PostgreSQL (or SQLite): # zcat /usr/share/doc/zabbix-sql-scripts/postgresql/schema.sql.gz | sudo -u zabbix psql zabbix # zcat /usr/share/doc/zabbix-sql-scripts/sqlite3/schema.sql.gz | sqlite3 zabbix.db ##### Импорт данных Импортируйте начальную схему: # zcat /usr/share/doc/zabbix-sql-scripts/mysql/schema.sql.gz | mysql -uzabbix -p zabbix Для прокси с PostgreSQL (или SQLite): # zcat /usr/share/doc/zabbix-sql-scripts/postgresql/schema.sql.gz | sudo -u zabbix psql zabbix # zcat /usr/share/doc/zabbix-sql-scripts/sqlite3/schema.sql.gz | sqlite3 zabbix.db ##### Importing data Import initial schema: # zcat /usr/share/doc/zabbix-sql-scripts/mysql/schema.sql.gz | mysql -uzabbix -p zabbix For proxy with PostgreSQL (or SQLite): # zcat /usr/share/doc/zabbix-sql-scripts/postgresql/schema.sql.gz | sudo -u zabbix psql zabbix # zcat /usr/share/doc/zabbix-sql-scripts/sqlite3/schema.sql.gz | sqlite3 zabbix.db ##### Импорт данных Импортируйте начальную схему: # zcat /usr/share/doc/zabbix-sql-scripts/mysql/schema.sql.gz | mysql -uzabbix -p zabbix Для прокси с PostgreSQL (или SQLite): # zcat /usr/share/doc/zabbix-sql-scripts/postgresql/schema.sql.gz | sudo -u zabbix psql zabbix # zcat /usr/share/doc/zabbix-sql-scripts/sqlite3/schema.sql.gz | 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/doc/packages/zabbix-sql-scripts/mysql/create.sql.gz | mysql -uzabbix -p zabbix Вам будет предложено ввести пароль к только что созданной базе данных. С PostgreSQL: zcat /usr/share/doc/packages/zabbix-sql-scripts/postgresql/create.sql.gz | sudo -u zabbix psql zabbix С TimescaleDB, в дополнение к предыдущей команде, также выполните: zcat /usr/share/doc/packages/zabbix-sql-scripts/postgresql/timescaledb.sql.gz | sudo -u <имя пользователя> psql zabbix ::: notewarning TimescaleDB поддерживается только с Zabbix сервером. ::: Для прокси импортируйте исходную схему: zcat /usr/share/doc/packages/zabbix-sql-scripts/mysql/schema.sql.gz | mysql -uzabbix -p zabbix Для прокси с PostgreSQL: zcat /usr/share/doc/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/doc/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/doc/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/doc/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 data with Timescale DB With TimescaleDB, in addition to the import command for PostgreSQL, also run: # zcat /usr/share/doc/zabbix-sql-scripts/postgresql/timescaledb.sql.gz | sudo -u zabbix psql zabbix ::: notewarning TimescaleDB is supported with Zabbix server only. ::: #### Импорт данных при использовании Timescale DB При использовании TimescaleDB в дополнение к команде импорта для базы данных PostgreSQL, также выполните: # zcat /usr/share/doc/zabbix-sql-scripts/postgresql/timescaledb.sql.gz | 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: # zcat /usr/share/doc/zabbix-sql-scripts/postgresql/timescaledb.sql.gz | sudo -u zabbix psql zabbix ::: notewarning TimescaleDB is supported with Zabbix server only. ::: #### Импорт данных при использовании Timescale DB При использовании TimescaleDB в дополнение к команде импорта для базы данных PostgreSQL, также выполните: # zcat /usr/share/doc/zabbix-sql-scripts/postgresql/timescaledb.sql.gz | 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 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).| #### Импорт Чтобы импортировать узел сети, сделайте следующее: - Перейдите к: *Настройка* → *Узлы сети (Configuration* → *Hosts)* - Нажмите на *Импорт (Import)* справа - Выберите импортируемый файл - Отметьте необходимые опции в правилах импорта - Нажмите на *Импорт (Import)*  В веб-интерфейсе отобразится сообщение об успехе или об ошибке импорта. Правила импорта: |Правило|Описание| |----|-----------| |*Обновить существующее*<br>*(Update existing)*|Существующие элементы будут обновлены данными, взятыми из файла импорта. В противном случае они не будут обновлены.| |*Создать новое*<br>*(Create new)*|Импорт добавит новые элементы, используя данные из файла импорта. В противном случае они не будут добавлены.| |*Удалить отсутствующее*<br>*(Delete missing)*|Импорт удалит существующие элементы, которые отсутствуют в файле импорта. В противном случае они не будут удалены.<br>Если *Удалить отсутствующее* отмечено для присоединения шаблонов, то существующие присоединения шаблонов, не присутствующие в файле импорта, будут отсоединены. Начиная с Zabbix 6.0.13, объекты (элементы данных, триггеры, графики и т.д.), унаследованные от отсоединяемых шаблонов, не будут удалены (если только опция *Удалить отсутствующее* не выбрана также и для каждого из объектов).| #### 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.| #### Импорт Для импорта способов оповещений сделайте следующее: - Перейдите к: *Администрирование* → *Способы оповещений (Administration* → *Media types)* - Нажмите на *Импорт (Import)* справа - Выберите импортируемый файл - Отметьте необходимые опции в правилах импорта - Нажмите на *Импорт (Import)*  В веб-интерфейсе отобразится сообщение об успехе или об ошибке импорта. Правила импорта: |Правило|Описание| |----|-----------| |*Обновить существующее*<br>*(Update existing)*|Существующие элементы будут обновлены данными, взятыми из файла импорта. В противном случае они не будут обновлены.| |*Создать новое*<br>*(Create new)*|Импорт добавит новые элементы, используя данные из файла импорта. В противном случае они не будут добавлены.| |*Удалить отсутствующее*<br>*(Delete missing)*|Импорт удалит существующие элементы, которые отсутствуют в файле импорта. В противном случае они не будут удалены.| #### 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. ::: #### Импорт Для импорта карт сети сделайте следующее: - Перейдите к: *Мониторинг* → *Карты сети (Monitoring* → *Maps)* - Нажмите на *Импорт (Import)* справа - Выберите импортируемый файл - Отметьте необходимые опции в правилах импорта - Нажмите на *Импорт (Import)*  Все обязательные поля ввода отмечены красной звёздочкой. В веб-интерфейсе отобразится сообщение об успехе или об ошибке импорта. Правила импорта: |Правило|Описание| |----|-----------| |*Обновить существующее*<br>*(Update existing)*|Существующие карты сети будут обновлены данными, взятыми из файла импорта. В противном случае они обновлены не будут.| |*Создать новое*<br>*(Create new)*|Импорт добавит новые карты сети, используя данные из файла импорта. В противном случае они не будут добавлены.| Если вы не отметите обе опции для карты сети и выберите соответствующие опции для изображений, только изображения будут импортированы. Импорт изображений доступен только пользователям Zabbix Супер-администраторам. ::: 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. #### Импорт Для импорта шаблонов выполните следующее: - Перейдите в: *Настройка* → *Шаблоны (Configuration* → *Templates)* - Нажмите на *Импорт (Import)* справа - Выберите импортируемый файл - Отметьте необходимые опции в правилах импорта - Нажмите на *Импорт (Import)*  Все обязательные поля ввода отмечены красной звёздочкой. Правила импорта: |Правило|Описание| |----|-----------| |*Обновить существующее*<br>*(Update existing)*|Существующие элементы будут обновлены данными, взятыми из файла импорта. В противном случае они не будут обновляться.| |*Создать новое*<br>*(Create new)*|Импорт добавит новые элементы, используя данные из файла импорта. В противном случае они не будут добавлены.| |*Удалить отсутствующее*<br>*(Delete missing)*|Импорт удалит существующие элементы, которые отсутствуют в файле импорта. В противном случае они не будут удаляться.<br>Если для связи с шаблонами выбрана опция *Удалить отсутствующее*, то существующее присоединение к шаблону, но отсутствующее в файле импорта, будет удалено. Начиная с Zabbix 6.0.13, объекты, унаследованные от отсоединяемых шаблонов (элементы данных, триггеры, графики и т.п.), не будут удалены (если только опция «Удалить отсутствующее» не отмечена также для каждого из объектов).| На следующем экране вы можете просмотреть содержимое импортируемого шаблона. Если импортируемый шаблон новый, все перечисленные элементы будут зелёными. При обновлении существующего шаблона все новые элементы шаблона будут подсвечены зелёным; удаляемые из шаблона элементы будут подсвечены красным; элементы, которые не изменились, будут перечислены на серым фоне. {width="600"} Меню слева можно использовать для перехода по списку изменений. Раздел *Обновлено (Updated)* подсвечивает все изменения, сделанные над существующими элементами шаблона. Раздел *Добавлено (Added)* перечисляет новые элементы шаблона. Элементы каждого раздела сгруппированы по типу элемента; нажмите на серую стрелку, чтобы развернуть или свернуть группу элементов.  Проверьте изменения шаблона, затем нажмите *Импорт (Import)* для выполнения операции импорта шаблона. В веб-интерфейсе отобразится сообщение об успехе или об ошибке импорта. ### 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 syncer Производительность процессов history syncer была улучшена путём добавления новых блокировок на чтение/запись. Это уменьшает количество блокировок между процессами 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 syncers была улучшена путём добавления новых блокировок на чтение/запись. Это уменьшает количество блокировок между процессами 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#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: | | | |--|--------| |*Группы узлов сети*<br>*(Host groups)*|Группы узлов сети для отображения данных.| |*Узлы сети*<br>*(Hosts)*|Узлы сети для отображения данных.| |*Теги узла сети*<br>*(Host tags)*|Укажите теги для ограничения количества узлов сети, отображаемых в виджете. Можно как включать, так и исключать определённые теги и значения тегов. Можно указать несколько условий. Поиск соответствия имён тегов всегда чувствителен к регистру.<br><br>По каждому условию доступно несколько операторов:<br>**Существует** — включить указанные имена тегов<br>**Равно** — включить указанные имена тегов и их значения (с учётом регистра)<br>**Содержит** — включить указанные имена тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>**Не существует** — исключить указанные имена тегов<br>**Не равно** — исключить указанные имена тегов и их значения (с учётом регистра)<br>**Не содержит** — исключить имена указанных тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>Для условий имеется два типа вычислений:<br>**И/Или** — все условия должны соблюдаться, условия с одинаковыми именами тегов будут сгруппированы с условием Или<br>**Или** — достаточно соблюдения одного условия| |*Колонки*<br>*(Columns)*|Добавить данные [столбцов](#настройка-столбцов) для отображения.<br>Порядок столбцов определяет их отображение слева направо.<br>Столбцы могут быть переупорядочены путём перетаскивания выше или ниже за маркер перед именем столбца.| |*Порядок*<br>*(Order)*|Укажите сортировку строк:<br>**Первые N (Top N)** — в убывающем порядке по агрегированному значению *Сортировки по колонке*<br>**Последние N (Bottom N)** — в возрастающем порядке по агрегированному значению *Сортировки по колонке*| |*Сортировка по колонке*<br>*(Order column)*|Укажите колонку из определённых в списке *Колонки*, которая будет использоваться для сортировки *Первые N* или *Последние N*.| |*Количество узлов сети*<br>*(Host count)*|Количество отображаемых строк узлов сети (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#общие-параметры) для всех виджетов, вы можете выставить следующие специфичные опции: | | | |--|--------| |*Группы узлов сети*<br>*(Host groups)*|Выберите группы узлов сети для отображения на карте. Это поле с функцией автодополнения; таким образом, после начала ввода имени группы будет автоматически предложен список совпадающих групп узлов сети в выпадающем меню. Прокрутите список, чтобы выбрать необходимую. Нажмите на 'х', чтобы удалить выбранную.<br>Если ничего не выбрано ни в поле *Группы узлов сети*, ни в поле *Узлы сети*, то будут отображены все узлы сети с корректными координатами.| |*Узлы сети*<br>*(Hosts)*|Выберите узлы сети для отображения на карте. Это поле с функцией автодополнения; таким образом, после начала ввода имени будет автоматически предложен список совпадающих узлов сети в выпадающем меню. Прокрутите список, чтобы выбрать необходимый. Нажмите на 'х', чтобы удалить выбранный.<br>Если ничего не выбрано ни в поле *Группы узлов сети*, ни в поле *Узлы сети*, то будут отображены все узлы сети с корректными координатами.| |*Теги*<br>*(Tags)*|Укажите теги для ограничения количества узлов сети, отображаемых в виджете. Можно как включать, так и исключать определённые теги и значения тегов. Можно указать несколько условий. Поиск соответствия имён тегов всегда чувствителен к регистру.<br>По каждому условию доступно несколько операторов:<br>**Существует** — включить указанные имена тегов<br>**Равно** — включить указанные имена тегов и их значения (с учётом регистра)<br>**Содержит** — включить указанные имена тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>**Не существует** — исключить указанные имена тегов<br>**Не равно** — исключить указанные имена тегов и их значения (с учётом регистра)<br>**Не содержит** — исключить имена указанных тегов, в которых значения тегов содержат введённую строку (совпадение подстроки, без учёта регистра)<br>Для условий имеется два типа вычислений:<br>**И/Или** — все условия должны соблюдаться, условия с одинаковыми именами тегов будут сгруппированы с условием Или<br>**Или** — достаточно соблюдения одного условия| |*Начальный вид*<br>*(Initial view)*|Координаты центра и необязательный уровень масштабирования (через запятую) для отображения при первоначальной загрузке виджета, в формате `<широта>,<долгота>,<масштаб>`<br>Если указан начальный масштаб, то виджет геокарты загружается с данным уровнем масштабирования. В противном случае начальный масштаб рассчитывается как половина от [максимального масштаба](/manual/web_interface/frontend_sections/administration/general#географические-карты) для конкретного поставщика плиток.<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/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 поставляет zabbix-selinux-policy пакет как часть исходных пакетов RPM для [RHEL 8](http://repo.zabbix.com/zabbix/6.0/rhel/8/SRPMS/) и [RHEL 7](http://repo.zabbix.com/zabbix/6.0/rhel/8/SRPMS/). Этот пакет обеспечивает основные политики по умолчанию для SELinux и позволяет компонентам Zabbix работать "из коробки", разрешая Zabbix создавать и использовать сокеты и разрешая httpd подключения к PostgreSQL (используются веб-интерфейсом). Исходный файл *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 предоставляет пакет zabbix-selinux-policy как часть исходных пакетов RPM для [RHEL 8](http://repo.zabbix.com/zabbix/6.0/rhel/8/SRPMS/) и [RHEL 7](http://repo.zabbix.com/zabbix/6.0/rhel/7/SRPMS/). Этот пакет предоставляет базовую политику по умолчанию для SELinux и позволяет компонентам zabbix работать «из коробки», позволяя Zabbix создавать и использовать сокеты и разрешая httpd-подключение к PostgreSQL (используемое веб-интерфейсом). Исходный файл *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. ##### 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 **агента**: |Настройка соединений агента|Настройка шифров| |----------------------|--------------------| |TLSConnect=cert|TLSCipherCert, TLSCipherCert13| |TLSConnect=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert|TLSCipherCert, TLSCipherCert13| |TLSAccept=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert,psk|TLSCipherAll, TLSCipherAll13| Для Zabbix **сервера** и **прокси**: |Настройка соединений|Настройка шифров| |----------------|--------------------| |Исходящие соединения, используя PSK|TLSCipherPSK, TLSCipherPSK13| |Исходящие соединения, используя сертификаты|TLSCipherAll, TLSCipherAll13| |Входящие соединения, используя PSK, если у сервера нет сертификата|TLSCipherPSK, TLSCipherPSK13| |Входящие соединения, используя PSK, если у сервера есть сертификат|TLSCipherAll, TLSCipherAll13| В двух таблицах выше можно увидеть некоторые шаблоны: - TLSCipherAll и TLSCipherAll13 могут быть указаны, только если используется комбинированный список шифров на основе сертификатов **и** на основе PSK. Есть два случая, когда это имеет место: сервер (прокси) с настроенным сертификатом (шифры PSK всегда настраиваются на сервере и прокси, если криптобиблиотека поддерживает PSK), агент настраивается на приём как на основе сертификатов, так и PSK; - в остальных случаях достаточно TLSCipherCert\* и/или TLSCipherPSK\*. Следующие таблицы показывают встроенные по умолчанию значения `TLSCipher*`. Они могут являться хорошей отправной точкой для ваших собственных кастомизированных значений. |Параметр|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| |Параметр|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. **Примеры заданных пользователем алгоритмов шифрования** Смотрите ниже следующие примеры заданных пользователем алгоритмов шифрования: - [Тестирование строк шифра и разрешение только алгоритмов PFS](#тестирование-строк-шифра-и-разрешение-только-алгоритмов-pfs) - [Переключение от AES128 на AES256](#переключение-с-aes128-на-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 проверках, может быть некорректным образом задан значением '1', значением не по умолчанию для всех элементов данных в результате обновления с версии pre-4.0 Zabbix. Для получения более подробных сведений по устранению данной ситуации смотрите [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. ::: #### Нумерованные макросы Синтаксис нумерованых макросов {МАКРОС**<1-9>**} ограничен рамками **выражений триггеров**. Нумерованные макросы можно использовать, чтобы сослаться на узлы сети или функции в том порядке, в котором они указаны в выражении. Такие макросы как {HOST.IP1}, {HOST.IP2}, {HOST.IP3} будут раскрыты в IP первого, второго и третьего узла сети из выражения триггера (если только выражение триггера содержит эти узлы сети). Такие макросы как {FUNCTION.VALUE1}, {FUNCTION.VALUE2}, {FUNCTION.VALUE3} будут раскрыты в значение первой, второй и третьей функции, относящейся к элементам данных, из выражения триггера на момент события (если только выражение триггера содержит эти функции). Кроме того, макрос {HOST.HOST<1-9>} также поддерживается внутри макроса выражений `{?функ(/узел_сети/ключ,парам)}` в **именах графиков**. Например, `{?функ(/{HOST.HOST2}/ключ,парам)}` в имени графика будет ссылаться на узел сети второго элемента данных графика. ::: notewarning Нумерованные макросы не раскрываются в любом другом контексте, кроме двух упомянутых здесь случаев. В остальных случаях используйте макросы **без** номера (например, {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. #### Кэширование поиска индексов При запросе динамического индекса элемента данных, Zabbix извлекает и кэширует всю таблицу SNMP под базовым OID, даже если совпадение будет найдено ранее. Это делается на случай, если другой элемент данных в дальнейшем ссылается на тот же самый базовый OID — Zabbix будет искать индекс в кэше, вместо ещё одного запроса к наблюдаемому устройству. Обратите внимание, что каждый процесс поллера использует свой собственный кэш. Во всех последующих операциях получения значений проверяется только найденный индекс. Если он не изменился, значение запрашивается. Если он изменился, кэш перестраивается — каждый поллер, который встречает изменённый индекс, снова обходит и кэширует таблицу индексов SNMP. ## 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) ------------------------------------------------------------------------ Этот документ был создан: 18 Марта 2020 года, 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) ------------------------------------------------------------------------ Этот документ был создан: 11 июня 2021 года, 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) ------------------------------------------------------------------------ Этот документ был создан: 11 июня 2021 года, 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) ------------------------------------------------------------------------ Этот документ был создан: 11 июня 2021 года, 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) ------------------------------------------------------------------------ Этот документ создан: 22 ноября 2021 года, 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) ------------------------------------------------------------------------ Этот документ был создан: 04 сентября 2020 года, 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) ------------------------------------------------------------------------ Этот документ был создан: 04 сентября 2020 года, 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) ------------------------------------------------------------------------ Этот документ был создан: 22 ноября 2021 года, 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](#post-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 ``` * Следуйте [инструкциям по пост-миграции](#пост-миграция) для удаления старых таблиц. ### Informational ### Информационные ##### 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": "Checmical 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|Тип|Результат|Комментарии| |--|--|------|------| |`$.filters.price`|определённый|10| | |`$.filters.category`|определённый|fiction| | |`$.filters['no filters']`|определённый|no "filters"| | |`$.filters`|определённый|{<br>"price": 10,<br>"category": "fiction",<br>"no filters": "no \\"filters\\""<br>}| | |`$.books[1].title`|определённый|Sword of Honour| | |`$.books[-1].author`|определённый|J. R. R. Tolkien| | |`$.books.length()`|определённый|4| | |`$.tags[:]`|неопределённый|\["a", "b", "c", "d", "e" \]| | |`$.tags[2:]`|неопределённый|\["c", "d", "e" \]| | |`$.tags[:3]`|неопределённый|\["a", "b", "c"\]| | |`$.tags[1:4]`|неопределённый|\["b", "c", "d"\]| | |`$.tags[-2:]`|неопределённый|\["d", "e"\]| | |`$.tags[:-3]`|неопределённый|\["a", "b"\]| | |`$.tags[:-3].length()`|определённый|2| | |`$.books[0, 2].title`|неопределённый|\["Sayings of the Century", "Moby Dick"\]| | |`$.books[1]['author', "title"]`|неопределённый|\["Evelyn Waugh", "Sword of Honour"\]| | |`$..id`|неопределённый|\[1, 2, 3, 4\]| | |`$.services..price`|неопределённый|\[5, 154.99, 46, 24.5, 99.49\]| | |`$.books[?(@.id == 4 - 0.4 * 5)].title`|неопределённый|\["Sword of Honour"\]|Этот запрос показывает, что в запросах можно использовать математические операции. Конечно, этот запрос можно упростить до `$.books[?(@.id == 2)].title`| |`$.books[?(@.id == 2 \|\| @.id == 4)].title`|неопределённый|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(!(@.id == 2))].title`|неопределённый|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.id != 2)].title`|неопределённый|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.title =~ " of ")].title`|неопределённый|\["Sayings of the Century", "Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.price > 12.99)].title`|неопределённый|\["The Lord of the Rings"\]| | |`$.books[?(@.author > "Herman Melville")].title`|неопределённый|\["Sayings of the Century", "The Lord of the Rings"\]| | |`$.books[?(@.price > $.filters.price)].title`|неопределённый|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.category == $.filters.category)].title`|неопределённый|\["Sword of Honour","Moby Dick","The Lord of the Rings"\]| | |`$.books[?(@.category == "fiction" && @.price < 10)].title`|неопределённый|\["Moby Dick"\]| | |`$..[?(@.id)]`|неопределённый|\[<br>{<br>"category": "reference",<br>"author": "Nigel Rees",<br>"title": "Sayings of the Century",<br>"price": 8.95,<br>"id": 1<br>},<br>{<br>"category": "fiction",<br>"author": "Evelyn Waugh",<br>"title": "Sword of Honour",<br>"price": 12.99,<br>"id": 2<br>},<br>{<br>"category": "fiction",<br>"author": "Herman Melville",<br>"title": "Moby Dick",<br>"isbn": "0-553-21311-3",<br>"price": 8.99,<br>"id": 3<br>},<br>{<br>"category": "fiction",<br>"author": "J. R. R. Tolkien",<br>"title": "The Lord of the Rings",<br>"isbn": "0-395-19395-8",<br>"price": 22.99,<br>"id": 4<br>}<br>\]| | |`$.services..[?(@.price > 50)].description`|неопределённый|'\["Printing and assembling book in A5 format", "Rebinding torn book"\]| | |`$..id.length()`|определённый|4| | |`$.books[?(@.id == 2)].title.first()`|определённый|Sword of Honour| | |`$..tags.first().length()`|определённый|5|$..tags - неопределённый путь, поэтому он вернёт массив соответствующих элементов - \[\["a", "b", "c", "d", "e" \]\], first() вернёт первый элемент - \["a", "b", "c", "d", "e" \] и, наконец, length() вычислит его размер - 5.| |`$.books[*].price.min()`|определённый|8.95| | |`$..price.max()`|определённый|154.99| | |`$.books[?(@.category == "fiction")].price.avg()`|определённый|14.99| | |`$.books[?(@.category == $.filters.xyz)].title`|неопределённый| |Запрос без совпадения вернёт NULL по определённому и неопределённому путям.| |`$.services[?(@.active=="true")].servicegroup`|неопределённый|\[1000,1001\]|В сравнениях логических значений необходимо использовать текстовые константы.| |`$.services[?(@.active=="false")].servicegroup`|неопределённый|\[1002\]|В сравнениях логических значений необходимо использовать текстовые константы.| |`$.services[?(@.servicegroup=="1002")]~.first()`|определенный|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. Смотрите [более подробную информацию](/manual/appendix/install/windows_agent#установка-агента-как-службы-windows) по установке и запуску Zabbix агента на Windows. #### Installation A new [Zabbix web service](/manual/concepts/web_service) process and Google Chrome browser should be installed to enable generation of scheduled reports. The web service may be installed on the same machine where the Zabbix server is installed or on a different machine. Google Chrome browser should be installed on the same machine, where the web service is installed. #### Установка Чтобы активировать создание отчётов по расписанию, должны быть установлены новый процесс [веб-сервис Zabbix](/manual/concepts/web_service) и браузер Google Chrome. Веб-сервис может быть установлен на том же компьютере, где установлен Zabbix сервер, или на другой машине. Браузер Google Chrome должен быть установлен на том же компьютере, где установлен веб-сервис. #### 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 #### Установка из пакетов Замечено, что невозможно установить конкретную версию веб-интерфейсе выполнив, например: yum install -v zabbix-web-mysql-scl-5.0.0 В качестве решения такой проблемы, если вы желаете установить конкретную версию веб-интерфейса, укажите версию для всех компонент, например: 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 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.| #### Установка Пожалуйста, всегда читайте руководство по установке для конкретного модуля. Рекомендуется устанавливать новые модули по одному, чтобы легко обнаруживать сбои. Непосредственно перед установкой модуля: - Убедитесь, что вы загрузили модуль из надёжного источника. Установка вредоносного кода может привести к таким последствиям, как потеря данных - Различные версии одного и того же модуля (с тем же идентификатором) могут быть установлены параллельно, но одновременно может быть активирована только одна версия Шаги по установке модуля: - Распакуйте модуль в отдельную папку в папке `modules` веб-интерфейса Zabbix; - Убедитесь, что папка устанавливаемого модуля содержит как минимум файл manifest.json; - Перейдите к [администрированию модулей](/manual/web_interface/frontend_sections/administration/general#модули) и нажмите кнопку *Сканировать директорию *; - Новый модуль появится в списке вместе с описанием, статусом и информацией о версии и авторе модуля; - Активируйте модуль, нажав на его статус. Разрешение проблем: |Проблема|Решение| |---------|----------------------------------------| |*Модуль не появился в списке*|Убедитесь, что файл manifest.json присутствует в папке `modules/ваш-модуль/` веб-интерфейса Zabbix. Если это так, значит, модуль не соответствует текущей версии Zabbix. Если файл manifest.json не существует, возможно, вы распаковали его не в ту папку.| |*Веб-интерфейс не запускается*|Код модуля не совместим с текущей версией Zabbix или конфигурацией сервера. Пожалуйста, удалите файлы модуля и перезагрузите интерфейс. Вы увидите уведомление, что некоторые модули отсутствуют. Перейдите к [администрированию модулей](/manual/web_interface/frontend_sections/administration/general#модули) и нажмите *Сканировать директорию* снова, чтобы удалить несуществующие модули из базы данных.| |*Появляются сообщения об идентичном пространстве имен, ID или действии*|Новый модуль попытался зарегистрировать пространство имен, 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**: ```bash dnf 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**: ```bash dnf install postgresql-odbc ``` - **Debian/Ubuntu**: Пожалуйста, обратитесь к [документации PostgreSQL](https://www.postgresql.org/download/linux/ubuntu/) для загрузки необходимого драйвера базы данных под соответствующую платформу. Для получения дополнительной информации, пожалуйста, обратитесь к: [Установка 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 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. ::: ##### Установка Смотрите раздел [установки из пакетов](/manual/installation/install_from_packages) для получения более детальных сведений по установке Zabbix агента из пакетов. В качестве альтернативы вы можете обратиться к инструкциям по [ручной установке](/manual/installation/install#установка_демонов_zabbix) , если вы не хотите использовать пакеты. ::: noteimportant Как правило, 32-битный Zabbix агент будет работать и на 64-битных системах, но в отдельных случаях возможно возникновение ошибок. ::: #### 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*|IP/DNS сервера Zabbix.| |*Agent listen port*|Порт, который будет слушать агент (по умолчанию 10050).| |*Server or Proxy for active checks*|IP/DNS сервера/прокси Zabbix для активных проверок агента.| |*Enable PSK*|Отметьте флажок, чтобы включить поддержку TLS через общий (pre-shared) ключ.| |*Add agent location to the PATH*|Добавление местоположения агента в переменную PATH.|  Введите идентификатор и значение общего ключа. Этот шаг доступен только, если в предыдущем шаге вы отметили опцию *Enable PSK*.  Выберите компоненты Zabbix для установки - [демон Zabbix агента](/manual/concepts/agent), [Zabbix sender](/manual/concepts/sender), [Zabbix get](/manual/concepts/get).  Zabbix компоненты вместе с файлом конфигурации будут установлены в директорию *Zabbix Agent* в Program Files. 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 [из исходных кодов](/manual/installation/install#установка_веб_сервиса_zabbix) необходимо указать опцию конфигурирования `--enable-webservice`. Для настройки веб-сервиса Zabbix обновите параметры файла конфигурации [`zabbix_web_service.conf`](/manual/appendix/config/zabbix_web_service). ::: noteimportant Настоятельно рекомендуется настроить шифрование между сервером Zabbix и веб-сервисом Zabbix [с использованием сертификатов](/manual/encryption/using_certificates). По умолчанию данные, передаваемые между сервером Zabbix и веб-сервисом Zabbix, не шифруются, что может привести к несанкционированному доступу. ::: #### 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: - из заранее скомпилированных бинарных файлов — загрузите бинарные файлы и следуйте инструкции на странице [установки агента Windows из пакетов MSI](/manual/installation/install_from_packages/win_msi) - из исходных кодов — смотрите [Сборка Zabbix агента 2 на Windows](/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 из исходного кода, загрузите файл конфигурации и поместите его в поддиректорию HTML документов conf/, куда вы скопировали PHP файлы Zabbix. {width="550"} {width="350"} ::: notetip В случае, если веб-сервер имеет право на запись в каталог 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 Для установки одиночного экземпляра Zabbix агента с файлом конфигурации `c:\zabbix_agentd.conf` по умолчанию: zabbix_agentd.exe --install ::: noteimportant На 64-битных системах требуется 64-битная версия Zabbix агента, чтобы все проверки, связанные с запущенными 64-битными процессами, работали корректно. ::: Если вы хотите использовать файл конфигурации, отличный от `c:\zabbix_agentd.conf`, вы должны использовать следующую команду для установки службы: zabbix_agentd.exe --config <ваш_файл_конфигурации> --install Необходимо указать полный путь к файлу конфигурации. Можно установить несколько экземпляров Zabbix агента как службы, примерно следующим образом: zabbix_agentd.exe --config <файл_конфигурации_для_экземпляра_1> --install --multiple-agents zabbix_agentd.exe --config <файл_конфигурации_для_экземпляра_2> --install --multiple-agents ... zabbix_agentd.exe --config <файл_конфигурации_для_экземпляра_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. ### Установка debuginfo пакетов ::: noteclassic Пакеты Debuginfo в настоящее время доступны только для RHEL/CentOS версий 7, 6 и 5. ::: Чтобы включить debuginfo репозиторий, отредактируйте */etc/yum.repos.d/zabbix.repo* файл. Измените `enabled=0` на `enabled=1` у zabbix-debuginfo репозитория. [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 Это изменение позволит вам установить zabbix-debuginfo пакет. # yum install zabbix-debuginfo Этот единственный пакет содержит отладочную информацию по всем бинарным файлам 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.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* файл. Измените `enabled=0` на `enabled=1` у zabbix-debuginfo репозитория. [zabbix-debuginfo] name=Zabbix Official Repository debuginfo - $basearch baseurl=http://repo.zabbix.com/zabbix/6.0/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 в настоящее время доступны только для RHE версий 7, 6 и 5. ::: Чтобы включить debuginfo репозиторий, отредактируйте файл */etc/yum.repos.d/zabbix.repo*. Измените `enabled=0` на `enabled=1` у репозитория zabbix-debuginfo. [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 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* файл. Измените `enabled=0` на `enabled=1` у zabbix-debuginfo репозитория. [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-***<компонент>***-debuginfo пакеты. ##### Installing Elasticsearch and creating mapping Final two steps of making things work are installing Elasticsearch itself and creating mapping process. To install Elasticsearch, please refer to [Elasticsearch installation guide](https://www.elastic.co/guide/en/elasticsearch/reference/current/setup.html). ::: noteclassic Mapping is a data structure in Elasticsearch (similar to a table in a database). Mapping for all history data types is available here: `database/elasticsearch/elasticsearch.map`. ::: ::: notewarning Creation of mapping is mandatory. Some functionality will be broken if mapping is not created according to the instruction. ::: To create mapping for `text` type, send the following request to Elasticsearch: ``` {.java} curl -X PUT \ http://your-elasticsearch.here:9200/text \ -H 'content-type:application/json' \ -d '{ "settings": { "index": { "number_of_replicas": 1, "number_of_shards": 5 } }, "mappings": { "properties": { "itemid": { "type": "long" }, "clock": { "format": "epoch_second", "type": "date" }, "value": { "fields": { "analyzed": { "index": true, "type": "text", "analyzer": "standard" } }, "index": false, "type": "text" } } } }' ``` Similar request is required to be executed for `Character` and `Log` history values mapping creation with corresponding type correction. ::: noteclassic To work with Elasticsearch, please refer to the [Requirements](/manual/installation/requirements#serverproxy) for additional information. ::: ::: noteclassic [Housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper) is not deleting any data from Elasticsearch. ::: ##### Установка Elasticsearch и создание сопоставления Последними двумя шагами, чтобы все заработало, являются установка самого Elasticsearch и создание процесса сопоставления. Для установки Elasticsearch, пожалуйста, обратитесь к [инструкции по установке Elasticsearch](https://www.elastic.co/guide/en/elasticsearch/reference/current/setup.html) \[en\]. ::: noteclassic Сопоставление является структурой данных в Elasticsearch (аналогично таблице в базе данных). Сопоставления по всем типам данных истории доступны здесь: `database/elasticsearch/elasticsearch.map`. ::: ::: notewarning Создание сопоставления обязательно. Некоторый функционал будет поломан, если сопоставление не создано согласно этой инструкции. ::: Для создания сопоставления для типа `text` отправьте следующий запрос в Elasticsearch: ``` {.java} curl -X PUT \ http://your-elasticsearch.here:9200/text \ -H 'content-type:application/json' \ -d '{ "settings": { "index": { "number_of_replicas": 1, "number_of_shards": 5 } }, "mappings": { "properties": { "itemid": { "type": "long" }, "clock": { "format": "epoch_second", "type": "date" }, "value": { "fields": { "analyzed": { "index": true, "type": "text", "analyzer": "standard" } }, "index": false, "type": "text" } } } }' ``` Похожий запрос требуется выполнить для создания сопоставлений по значениям истории `Символ` и `Журнал (лог)` с соответствующим исправлением типа. ::: noteclassic Чтобы работать с Elasticsearch, пожалуйста, обратитесь к [странице требований](/manual/installation/requirements#сервер-прокси) для получения более подробной информации. ::: ::: noteclassic [Очистка истории](/manual/web_interface/frontend_sections/administration/general#очистка-истории) не удаляет никакие данные из Elasticsearch. ::: ##### Installing frontend Please see [Web interface installation](/manual/installation/frontend) page for information about Zabbix frontend installation wizard. ##### Установка веб-интерфейса Пожалуйста, обратитесь к странице [установки веб-интерфейса](/manual/installation/frontend) для получения более подробной информации о мастере установки веб-интерфейса Zabbix. #### Installing Java gateway It is required to install Java gateway only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database. To install from sources, first [download](/manual/installation/install#download-the-source-archive) and extract the source archive. To compile Java gateway, run the `./configure` script with `--enable-java` option. It is advisable that you specify the `--prefix` option to request installation path other than the default /usr/local, because installing Java gateway will create a whole directory tree, not just a single executable. ./configure --enable-java --prefix=$PREFIX To compile and package Java gateway into a JAR file, run `make`. Note that for this step you will need `javac` and `jar` executables in your path. make Now you have a zabbix-java-gateway-$VERSION.jar file in src/zabbix\_java/bin. If you are comfortable with running Java gateway from src/zabbix\_java in the distribution directory, then you can proceed to instructions for configuring and running [Java gateway](/manual/concepts/java/from_sources#overview-of-files). Otherwise, make sure you have enough privileges and run `make install`. make install Proceed to [setup](/manual/concepts/java/from_sources) for more details on configuring and running Java gateway. #### Установка Java gateway Java gateway необходимо установить, только если вы хотите мониторить приложения JMX. Java gateway легковесный и не требует наличия базы данных. Чтобы установить из исходного кода, сначала [загрузите](/manual/installation/install#загрузите-архив-исходных-кодов) и извлеките исходный код из архива. Чтобы скомпилировать Java gateway, выполните `./configure` скрипт с опцией `--enable-java`. Целесообразно указать опцию `--prefix` для изменения пути установки с /usr/local по умолчанию, так как при установке Java gateway будет создано целое дерево директорий, а не просто один исполняемый файл. ./configure --enable-java --prefix=$ПРЕФИКС Для компиляции и сборки пакета Java gateway в JAR файл выполните `make`. Обратите внимание, для выполнения этого шага вам потребуется наличие выполняемых файлов `javac` и `jar` в известных системе местах. make Теперь у вас имеется zabbix-java-gateway-$ВЕРСИЯ.jar файл в src/zabbix\_java/bin. Если вам удобно запускать Java gateway из src/zabbix\_java в директории с исходными кодами, тогда вам нужно перейти к инструкциям по настройке и запуску [Java gateway](/manual/concepts/java/from_sources#обзор-файлов). В противном случае убедитесь, что у вас имеются достаточные привилегии и выполните `make install`. make install Перейдите на страницу [настройки](/manual/concepts/java/from_sources) Java gateway для получения более подробных сведений о том, как настроить и запустить Java gateway. #### 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 Перезапустите веб-сервер. Теперь локали должны быть установлены. Для появления новых языков может потребоваться обновить страницу веб-интерфейса Zabbix в браузере нажатием Ctrl + F5. #### Installing MIB files On Debian-based systems: apt install snmp-mibs-downloader download-mibs On RedHat-based systems: dnf install net-snmp-libs #### Установка MIB файлов На системах на основе Debian: apt install snmp-mibs-downloader download-mibs На системах на основе RedHat: dnf 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. Загрузите MinGW-w64 с Обработкой Исключений SJLJ (set jump/long jump) и потоками Windows (например, *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 При компиляции используйте командную строку Windows вместо терминала MSYS, который поставляется с MinGW #### Installing OpenSSL development libraries 1. Download 32 and 64 bit builds from <https://curl.se/windows/>. 2. Extract files into *c:\\dev\\openssl32* and *c:\\dev\\openssl* directories accordingly. 3. After that remove extracted *\*.dll.a* (dll call wrapper libraries) as MinGW prioritizes them before static libraries. ::: noteimportant Make sure to revoke write access from non-administrator users to the OpenSSL install directory (`C:\dev\openssl32` or `C:\dev\openssl`). Otherwise, Zabbix agent 2 will load SSL settings from a path that can be modified by unprivileged users, resulting in a potential security vulnerability. ::: #### Установка библиотек разработки OpenSSL 1. Загрузите 32- и 64-битные сборки с <https://curl.se/windows/>. 2. Извлеките файлы в *c:\\dev\\openssl32* и *c:\\dev\\openssl* директории соответственно. 3. После чего удалите извлечённые *\*.dll.a* (библиотеки оболочки для вызова dll), так как MinGW ставит приоритет использования именно их перед использованием статических библиотек. ::: noteimportant Обязательно отмените доступ на запись для пользователей, не являющихся администраторами, в каталог установки OpenSSL (`C:\dev\openssl32` или `C:\dev\openssl`). В противном случае Zabbix агент 2 будет загружать настройки SSL из пути, который могут изменить непривилегированные пользователи, что приведёт к потенциальной уязвимости безопасности. ::: #### 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 Ubuntu/Debian systems using the *apt* package manager: apt install odbc-mariadb Installing MySQL database driver on RedHat/Fedora-based systems using the *dnf* package manager: dnf install mariadb-connector-odbc Installing MySQL database driver on SUSE-based systems using the *zypper* package manager: zypper in mariadb-connector-odbc #### Установка драйверов unixODBC Драйвер unixODBC базы данных должен быть установлен для базы данных, которая будет наблюдаться. unixODBC имеет список поддерживаемых баз данных и драйверов: <http://www.unixodbc.org/drivers.html>. В некоторых дистрибутивах Linux драйвера баз данных включены в репозитории пакетов. Установка драйвера базы данных MySQL на системы Ubuntu/Debian с помощью менеджера пакетов *apt*: apt install odbc-mariadb Установка драйвера базы данных MySQL на системы на базе RedHat/Fedora с помощью менеджера пакетов *dnf*: dnf install mariadb-connector-odbc Установка драйвера базы данных MySQL на системы на базе SUSE с помощью менеджера пакетов *zypper*: zypper in mariadb-connector-odbc #### 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 Ubuntu/Debian systems using the *apt* package manager: apt install unixodbc unixodbc-dev Installing unixODBC on RedHat/Fedora-based systems using the *dnf* package manager: dnf install unixODBC unixODBC-devel Installing unixODBC on SUSE-based systems using the *zypper* package manager: zypper in unixODBC-devel ::: noteclassic The unixodbc-dev or unixODBC-devel package is needed to compile Zabbix with unixODBC support. ::: #### Установка unixODBC Рекомендуемый способ установки unixODBC состоит в использовании репозиториев пакетов по умолчанию в операционной системе Linux. В наиболее популярные дистрибутивы Linux unixODBC добавлен в репозитории пакетов по умолчанию. Если он недоступен, его можно получить на домашней странице UnixODBC: <http://www.unixodbc.org/download.html>. Установка unixODBC на системы Ubuntu/Debian с помощью менеджера пакетов *apt*: apt install unixodbc unixodbc-dev Установка unixODBC на системы на базе RedHat/Fedora с помощью менеджера пакетов *dnf*: dnf install unixODBC unixODBC-devel Установка unixODBC на системы на базе SUSE с помощью менеджера пакетов *zypper*: zypper in unixODBC-devel ::: noteclassic Для компиляции Zabbix с поддержкой unixODBC требуется пакет unixodbc-dev либо unixODBC-devel. ::: #### Installing Zabbix daemons #### Установка демонов 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 репозитория Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), файлы перевода должны быть созданы вручную. Чтобы сгенерировать файлы перевода, выполните: make gettext locale/make_mo.sh Этот шаг не требуется при установке Zabbix из пакетов или файлов исходных кодов tar.gz. #### Installing Zabbix Operator #### Установка Zabbix Operator #### Installing Zabbix web interface #### Установка веб-интерфейса Zabbix #### 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 [supported Go version](/manual/installation/requirements#agent-2) must be installed to build Zabbix web service. ::: Run zabbix\_web\_service on the machine, where the web service is installed: zabbix_web_service Proceed to [setup](/manual/appendix/install/web_service) for more details on configuring Scheduled reports generation. #### Установка веб-сервиса Zabbix Установка веб-сервиса Zabbix требуется, только если вы хотите использовать [отчёты по расписанию](/manual/web_interface/frontend_sections/reports/scheduled). Чтобы установить из исходного кода, сначала [загрузите](/manual/installation/install#загрузите-архив-исходных-кодов) и извлеките исходный код из архива. Чтобы скомпилировать веб-сервис Zabbix, выполните скрипт `./configure` с опцией `--enable-webservice`. ::: noteclassic Для сборки веб-сервиса Zabbix должна быть установлена [поддерживаемая версия Go](/manual/installation/requirements#агент-2). ::: Выполните zabbix\_web\_service на машине, где был установлен веб-сервис: zabbix_web_service Перейдите к [установке](/manual/appendix/install/web_service) для получения более подробных сведений о настройке генерирования Регулярных отчетов. ### 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.| ### История целых чисел Объект истории целых чисел имеет следующие свойства. |Параметр|Тип(/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |clock|timestamp|Время, когда было получено значение.| |itemid|string|ID соответствующего элемента данных.| |ns|integer|Наносекунды, когда было получено значение.| |value|float|Полученное значение.| #### Integrations The following integrations are available, allowing predefined webhook media types to be used 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) - [Event-Driven Ansible](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/event_driven_ansible/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) - [Mantis Bug Tracker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/mantisbt/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) - [MS Teams Workflows](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/msteams-workflow?at=refs%2Fheads%2Frelease%2F6.0) - [LINE](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/line/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_ce/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. ::: #### Интеграции Доступны следующие интеграции, которые позволяют использовать подготовленные способы оповещения вебхук для отправки оповещений из 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) - [Event-Driven Ansible](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/event_driven_ansible/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) - [Mantis Bug Tracker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/mantisbt/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) - [MS Teams Workflows](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/msteams-workflow?at=refs%2Fheads%2Frelease%2F6.0) - [LINE](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/line/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** (вебхук не требуется). Чтобы преобразовать оповещения Zabbix в тикеты Spiceworks, используйте тип оповещений [e-mail способ оповещения](/manual/config/notifications/media/email) и введите e-mail адрес службы поддержки Spiceworks (например, help\@zabbix.on.spiceworks.com) в настройках выделенного под Spiceworks пользователя 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 интерфейс. - если были созданы 3 различных узла сети, будучи обнаруженными по критерию уникальности «IP», а затем правило обнаружения изменяется таким образом, что узлы сети A, B и C имеют одинаковый результат критерия уникальности, то B и C будут созданы как дополнительные интерфейсы для A, первого узла сети. Отдельные узлы сети B и C останутся. В *Мониторинг* → *Обнаружение* добавленные интерфейсы будут отображаться в столбце «Обнаруженное устройство», чёрным шрифтом и с отступом; однако столбец «Наблюдаемый узел сети» будет отображать только A, первый созданный узел сети. «Доступен/Недоступен (Uptime/Downtime)» не измеряется для 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.  Можно настроить следующие параметры политики паролей: |Параметр|Описание| |--|--------| |*Минимальная длина пароля*<br>*(Minimum password length)*|По умолчанию минимальная длина пароля установлена на 8. Поддерживаемый диапазон: 1-70. Обратите внимание, что пароли длиннее 72 символов будут усечены.| |*Пароль должен содержать*<br>*(Password must contain)*|Отметьте один или несколько флажков, чтобы требовать использования в пароле указанных символов:<br>- прописная и строчная латинская буква<br>- цифра<br>- специальный символ<br><br>Наведите указатель мыши на вопросительный знак, чтобы увидеть подсказку со списком символов для каждого варианта.| |*Избегать легко угадываемых паролей*<br>*(Avoid easy-to-guess passwords)*|Если отмечено, пароль будет проверяться на соответствие следующим требованиям:<br>- не должен содержать имя, фамилию или имя пользователя<br>- не должен быть одним из общеупотребительных или контекстно-зависимых паролей.<br><br>Список общеупотребительных и контекстно-зависимых паролей генерируется автоматически из списка NCSC «100 000 популярных паролей», списка SecList «1 миллион популярных паролей» и списка контекстно-зависимых паролей Zabbix. Внутренним пользователям не будет разрешено устанавливать пароли, включённые в этот список, поскольку такие пароли считаются слабыми из-за их частого использования.| Изменения в требованиях к сложности пароля не повлияют на существующие пароли пользователей, но если существующий пользователь решит изменить пароль, то новый пароль должен соответствовать текущим требованиям. Подсказка со списком требований будет отображаться рядом с полем *Пароль* в [профиле пользователя](/manual/web_interface/user_profile) и в [диалоге настройки пользователя](/manual/config/users_and_usergroups/user), доступном из меню *Администрирование→Пользователи*. #### 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>*(Event type)*|равно|**Элемент данных в состоянии "не поддерживается" (Item in "not supported" state)** — соответствует событию, когда элемент данных переходит из состояния «активировано» в состояние «не поддерживается»<br>**Правило низкоуровневого обнаружения в состоянии "не поддерживается" (Low-level discovery rule in "not supported" state)** — соответствует событию, когда правило низкоуровневого обнаружения переходит из состояния «активировано» в состояние «не поддерживается»<br>**Триггер в состоянии "неизвестно" (Trigger in "unknown" state)** — соответствует событию, когда триггер переходит из состояния «активировано» в состояние «неизвестно»| |*Группа узлов сети*<br>*(Host group)*|равно<br>не равно|Укажите группу узлов сети или группу узлов сети для исключения.<br>**равно** — событие относится к указанной группе узлов сети.<br>**не равно** — событие не относится к указанной группе узлов сети.| |*Имя тега*<br>*(Tag name)*|равно<br>не равно<br>содержит<br>не содержит|Укажите тег события или исключение тега события.<br>**равно** — событие имеет указанный тег<br>**не равно** — событие не имеет указанный тег<br>**содержит** — событие имеет тег, который содержит указанную строку<br>**не содержит** — событие не имеет тега, который содержит указанную строку| |*Значение тега*<br>*(Tag value)*|равно<br>не равно<br>содержит<br>не содержит|Укажите комбинацию тега события и его значения или исключение комбинации тега и значения.<br>**равно** — событие имеет указанные тег и значение<br>**не равно** — событие не имеет указанные тег и значение<br>**содержит** — событие содержит указанные строки тега и значения<br>**не содержит** — событие не содержит указанные строки тега и значения| |*Шаблон*<br>*(Template)*|равно<br>не равно|Укажите шаблон или шаблон для исключения.<br>**равно** — событие относится к элементу данных / триггеру / правилу низкоуровневого обнаружения, унаследованному из указанного шаблона.<br>**не равно** — событие не относится к элементу данных / триггеру / правилу низкоуровневого обнаружения, унаследованному из указанного шаблона.| |*Узел сети*<br>*(Host)*|равно<br>не равно|Укажите узел сети или узел сети для исключения.<br>**равно** — событие относится к указанному узлу сети.<br>**не равно** — событие не относится к указанному узлу сети.| #### Internal events Internal events happen when: - an item changes state from 'normal' to 'unsupported' - an item changes state from 'unsupported' to 'normal' - a low-level discovery rule changes state from 'normal' to 'unsupported' - a low-level discovery rule changes state from 'unsupported' to 'normal' - a trigger changes state from 'normal' to 'unknown' - a trigger changes state from 'unknown' to 'normal' Internal events are supported since Zabbix 2.2. The aim of introducing internal events is to allow users to be notified when any internal event takes place, for example, an item becomes unsupported and stops gathering data. Internal events are only created when internal actions for these events are enabled. To stop generation of internal events (for example, for items becoming unsupported), disable all actions for internal events in Configuration → Actions → Internal actions. ::: noteclassic If internal actions are disabled, while an object is in the 'unsupported' state, recovery event for this object will still be created. If internal actions are enabled, while an object is in the 'unsupported' state, recovery event for this object will be created, even though 'problem event' has not been created for the object. ::: See also: [Receiving notification on unsupported items](/manual/config/notifications/unsupported_item) #### Внутренние события Внутренние события возникают, когда: - элемент данных меняет своё состояние с «нормального» на «не поддерживается» - элемент данных меняет своё состояние с «не поддерживается» на «нормальное» - правило низкоуровневого обнаружения меняет своё состояние с «нормального» на «не поддерживается» - правило низкоуровневого обнаружения меняет своё состояние с «не поддерживается» на «нормальное» - триггер меняет своё состояние с «нормального» на «неизвестное» - триггер меняет своё состояние с «неизвестного» на «нормальное» Внутренние события поддерживаются, начиная с Zabbix 2.2. Цель введения внутренних событий — дать возможность пользователям узнавать, когда происходят некоторые внутренние события; например, элемент данных становится неподдерживаемым и перестаёт собирать данные. Внутренние события создаются, только когда активированы действия на эти события. Чтобы остановить генерирование внутренних событий (например, о том, что элементы данных становятся неподдерживаемыми), отключите все действия на внутренние события в Настройка → Действия → Внутренние действия. ::: noteclassic Если внутренние действия отключены, когда какой-либо объект находился в «неподдерживаемом» состоянии, событие восстановления по этому объекту все же будет создано. Если внутренние действия активированы, когда какой-либо объект находился в «неподдерживаемом» состоянии, событие восстановления по этому объекту будет создано, даже если «событие о проблеме» не было ранее создано по этому объекту. ::: Смотрите также: [Получение оповещений на неподдерживаемые элементы данных](/manual/config/notifications/unsupported_item) #### 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` (high-availability manager, менеджер высокой доступности) теперь может контролироваться с помощью [внутреннего элемента данных](/manual/config/items/itemtypes/internal#поддерживаемые-проверки) 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: - Внутренний элемент данных `zabbix[stats,<ip>,<порт>,queue,<от>,<до>]` — для прямых запросов внутренней очереди с удалённого Zabbix сервера/прокси - Элемент данных агента `zabbix.stats[<ip>,<порт>,queue,<от>,<до>]` — для запросов внутренней очереди удалённых Zabbix сервера/прокси через агента Смотрите также: [Внутренние элементы данных](/manual/config/items/itemtypes/internal), [Элементы данных Zabbix агента](/manual/config/items/itemtypes/zabbix_agent). #### Internal workings of bulk processing Zabbix server and proxy query SNMP devices for multiple values in a single request. This affects several types of SNMP items: - regular SNMP items - SNMP items [with dynamic indexes](/manual/config/items/itemtypes/snmp/dynamicindex) - SNMP [low-level discovery rules](/manual/discovery/low_level_discovery/examples/snmp_oids) All SNMP items on a single interface with identical parameters are scheduled to be queried at the same time. The first two types of items are taken by pollers in batches of at most 128 items, whereas low-level discovery rules are processed individually, as before. On the lower level, there are two kinds of operations performed for querying values: getting multiple specified objects and walking an OID tree. For "getting", a GetRequest-PDU is used with at most 128 variable bindings. For "walking", a GetNextRequest-PDU is used for SNMPv1 and GetBulkRequest with "max-repetitions" field of at most 128 is used for SNMPv2 and SNMPv3. Thus, the benefits of bulk processing for each SNMP item type are outlined below: - regular SNMP items benefit from "getting" improvements; - SNMP items with dynamic indexes benefit from both "getting" and "walking" improvements: "getting" is used for index verification and "walking" for building the cache; - SNMP low-level discovery rules benefit from "walking" improvements. However, there is a technical issue that not all devices are capable of returning 128 values per request. Some always return a proper response, but others either respond with a "tooBig(1)" error or do not respond at all once the potential response is over a certain limit. In order to find an optimal number of objects to query for a given device, Zabbix uses the following strategy. It starts cautiously with querying 1 value in a request. If that is successful, it queries 2 values in a request. If that is successful again, it queries 3 values in a request and continues similarly by multiplying the number of queried objects by 1.5, resulting in the following sequence of request sizes: 1, 2, 3, 4, 6, 9, 13, 19, 28, 42, 63, 94, 128. However, once a device refuses to give a proper response (for example, for 42 variables), Zabbix does two things. First, for the current item batch it halves the number of objects in a single request and queries 21 variables. If the device is alive, then the query should work in the vast majority of cases, because 28 variables were known to work and 21 is significantly less than that. However, if that still fails, then Zabbix falls back to querying values one by one. If it still fails at this point, then the device is definitely not responding and request size is not an issue. The second thing Zabbix does for subsequent item batches is it starts with the last successful number of variables (28 in our example) and continues incrementing request sizes by 1 until the limit is hit. For example, assuming the largest response size is 32 variables, the subsequent requests will be of sizes 29, 30, 31, 32, and 33. The last request will fail and Zabbix will never issue a request of size 33 again. From that point on, Zabbix will query at most 32 variables for this device. If large queries fail with this number of variables, it can mean one of two things. The exact criteria that a device uses for limiting response size cannot be known, but we try to approximate that using the number of variables. So the first possibility is that this number of variables is around the device's actual response size limit in the general case: sometimes response is less than the limit, sometimes it is greater than that. The second possibility is that a UDP packet in either direction simply got lost. For these reasons, if Zabbix gets a failed query, it reduces the maximum number of variables to try to get deeper into the device's comfortable range, but (starting from 2.2.8) only up to two times. In the example above, if a query with 32 variables happens to fail, Zabbix will reduce the count to 31. If that happens to fail, too, Zabbix will reduce the count to 30. However, Zabbix will not reduce the count below 30, because it will assume that further failures are due to UDP packets getting lost, rather than the device's limit. If, however, a device cannot handle bulk requests properly for other reasons and the heuristic described above does not work, since Zabbix 2.4 there is a "Use bulk requests" setting for each interface that allows to disable bulk requests for that device. #### Обработка массовых SNMP запросов Начиная с версии 2.2.3, Zabbix сервер и прокси одним запросом опрашивают множество SNMP элементов данных. Такое поведение затрагивает следующие типы SNMP элементов данных: - обычные SNMP элементы данных; - SNMP элементы данных [с динамическими индексами](/manual/config/items/itemtypes/snmp/dynamicindex); - [правила низкоуровневого обнаружения SNMP](/manual/discovery/low_level_discovery/examples/snmp_oids). Все элементы данных SNMP с одного интерфейса с идентичными параметрами планируются на опрос в одно время. Первые два типа элементов данных собираются поллерами порциями не более чем по 128 элементов данных, в то время как правила низкоуровневого обнаружения обрабатываются индивидуально, как и ранее. На низком уровне есть два вида операций, выполняемых при опросе значений: получение нескольких заданных объектов и обход дерева OID'ов. Для «получения» используется GetRequest-PDU c не более чем 128 привязанными переменными. Для «обхода» используется GetNextRequest-PDU для SNMPv1 и GetBulkRequest с полем «max-repetitions» с наибольшим количеством в 128 полученных значений для SNMPv2 и SNMPv3. Таким образом, преимущества массовой обработки для каждого типа SNMP элемента данных изложены ниже: - обычные SNMP элементы данных получают преимущество от улучшенного «получения»; - SNMP элементы данных с динамическими индексами получают преимущество и от улучшенного «получения», и от «обхода»: «получение» используется для проверки индексов, а «обход» для построения кэша значений; - правила низкоуровневого SNMP обнаружения получают преимущество от улучшенного «обхода». Тем не менее, есть техническая проблема: не все устройства способны вернуть 128 значений за один запрос. Некоторые всегда возвращают корректный ответ, но другие либо отвечают с ошибкой «tooBig(1)», либо не отвечают вообще, когда потенциальный запрос превышает определённый лимит. Для вычисления оптимального количества объектов, запрашиваемых с данного устройства, Zabbix использует следующую стратегию. Начинается с осторожного запроса одного значения. Если запрос выполнен успешно, запрашивается 2 значения за один запрос. Если запрос снова выполнен успешно, запрашивается 3 значения за запрос и продолжается аналогично путём умножения количества запрашиваемых значений на 1.5, в результате получается следующая последовательность размера запросов: 1, 2, 3, 4, 6, 9, 13, 19, 28, 42, 63, 94, 128. Однако, как только устройство отказывается давать корректный ответ (к примеру, на 42 переменных), Zabbix делает 2 вещи. Во-первых, для текущей серии элементов данных Zabbix делит пополам количество объектов на один запрос и запрашивает 21 переменную. Если устройство доступно, то запрос должен работать в большинстве случаев, потому что было известно, что с 28 переменными работало, а 21 значительно меньше. Однако, если проблема продолжается, Zabbix возвращается к опросу значений по одному. Если проблемы есть и в этом случае, значит устройство определённо не отвечает, а проблема не в размере запроса. Вторая вещь, которую делает Zabbix для дальнейших порций элементов данных, — он начинает с последнего удачного количества переменных (28 в нашем случае) и продолжает, увеличивая количество переменных за запрос на 1 до достижения лимита. Например, предположим, что наибольший размер ответа — это 32 переменных, тогда последующие запросы будут размерами 29, 30, 31, 32 и 33. Последний запрос будет неудачным, и Zabbix никогда более не запросит 33 значения за один запрос. С этого момента, Zabbix всегда будет опрашивать максимум по 32 переменных для этого устройства. Если большие запросы неудачно завершаются с этим количеством переменных, это может означать одно из двух. Точный критерий, используемый устройством для ограничения размера ответа, неизвестен, но мы пытаемся приблизительно оценить это, используя количество переменных. Поэтому первая возможность — что в общем случае это количество переменных где-то около реального ограничения размера ответа для данного устройства: иногда ответ меньше этого предела, иногда больше. Вторая возможность — что UDP пакет (в любом направлении) просто был потерян. По этим причинам, если Zabbix сталкивается с неудачным запросом, то он уменьшает максимальное количество переменных, чтобы попытаться углубиться в комфортный для устройства диапазон, но (начиная с 2.2.8) только до 2 раз. В примере выше, если запрос с 32 переменными будет неудачен, Zabbix уменьшит количество до 31. Если неудача случится снова, Zabbix уменьшит количество до 30. Однако, Zabbix не будет уменьшать количество ниже 30, потому что он предположит, что дальнейшие проблемы по причине потерянных UDP пакетов, нежели из-за ограничения устройства. Если, однако, устройство не умеет обрабатывать массовые запросы корректно и описанная выше эвристика не работает, то, начиная с Zabbix 2.4, у каждого интерфейса имеется настройка «Использовать массовые запросы», позволяющая отключить массовые запросы для этого устройства. 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#действия-на-триггеры), тип условия *Имя триггера* был переименован в *Имя события*, чтобы точнее описывать его функцию. Обратите внимание, что по умолчанию имя события совпадает с именем триггера, если только в [настройках триггера](/manual/config/triggers/trigger) не было задано настраиваемое имя события. #### Introduction MIB stands for the Management Information Base. MIB files allow to use textual representation of an OID (Object Identifier). It is possible to use raw OIDs when monitoring SNMP devices with Zabbix, but if you feel more comfortable using textual representation, you need to install MIB files. For example, ifHCOutOctets is textual representation of the OID 1.3.6.1.2.1.31.1.1.1.10 #### Введение MIB обозначает Базу Управляющей Информации (Management Information Base). MIB файлы позволяют вам использовать текстовое представление OID\'а (Идентификатора Объекта). При мониторинге Zabbix\'ом устройств SNMP можно использовать сырые OID\'ы, но если для Вас более комфортно использовать текстовое представление, то потребуется установить MIB файлы. Например, ifHCOutOctets является текстовым представлением OID\'а 1.3.6.1.2.1.31.1.1.1.10 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.\<ИмяПлагина>.Path* перенесен в *Plugins.\<ИмяПлагина>.System.Path*. - Параметр *Plugins.\<ИмяПлагина>.Capacity*, хоть и поддерживается ещё, является устаревшим; вместо него, пожалуйста, используйте *Plugins.\<ИмяПлагина>.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 по-прежнему поддерживается, установочные пакеты Zabbix для RHEL 7 и новее, SLES (всех версий), Debian 9 и новее, Ubuntu 16.04 и новее были обновлены и теперь используют PCRE2. Несмотря на множество преимуществ, переход на PCRE2 может привести к тому, что существующие шаблоны регулярных выражений PCRE станут ошибочными или изменят своё поведение. В частности, это изменение затрагивает шаблон *\^[\\w-\\.]*. Чтобы сделать это регулярное выражение снова корректным, не затрагивая семантику, измените выражение на *\^[-\\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: #### Ошибочные регулярные выражения после переключения на PCRE2 В Zabbix 6.0 добавлена поддержка PCRE2. Хотя PCRE по-прежнему поддерживается, установочные пакеты Zabbix для RHEL/CentOS 7 и для более новых версий, SLES (всех версий), Debian 9 и для более новых версий, Ubuntu 16.04 и для более новых версий были обновлены и теперь используют PCRE2. Несмотря на множество преимуществ, переход на PCRE2 может привести к тому, что существующие шаблоны регулярных выражений PCRE станут ошибочными или изменят свое поведение. В частности, это изменение затрагивает шаблон *^[\w-\.]*. Чтобы сделать это регулярное выражение снова корректным, не затрагивая семантику, измените выражение на *^[-\w\.]* . Такая проблема происходит из-за того, что PCRE2 рассматривает символ тире как разделитель, при этом создавая диапазон внутри класса символов. Обновлены следующие установочные пакеты Zabbix, теперь они используют PCRE2: #### Inventory details The **Overview** tab contains some general information about the host, latest monitoring data, and host configuration options: {width="600"} The **Details** tab contains all available inventory details for the host: {width="600"} The completeness of inventory data depends on how much inventory information is maintained with the host. If no information is maintained, the *Details* tab is disabled. #### Подробности инвентарных данных Вкладка **Обзор (Overview)** содержит лишь некоторую общую информацию об узле сети, последние данные мониторинга и параметры настройки узла сети: {width="600"} Вкладка **Детали (Details)** содержит все доступные подробности инвентарных данных по выбранному узлу сети: {width="600"} Полнота инвентарных данных зависит от того, сколько инвентарной информации поддерживается для узла сети. Если информация недоступна, вкладка *Детали* отключена. #### 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>узла сети*|Этот блок отображает подробности всех интерфейсов, настроенных у узла сети.| |*ОС*|Поле операционная система из инвентарных данных узла сети (если задано).| |*Аппаратное обеспечение*|Поле аппаратного обеспечения из инвентарных данных узла сети (если задано).| |*Программное обеспечение*|Поле программного обеспечения из инвентарных данных узла сети (если задано).| |*Описание*|Описание узла сети.| |*Мониторинг*|Ссылки на разделы мониторинга этого узла сети: *Веб*, *Последние данные*, *Проблемы*, *Графики*, *Панели*.| |*Настройка*|Ссылки на разделы настроек этого узла сети: *Узел сети*, *Элементы данных*, *Триггеры*, *Графики*, *Обнаружение*, *Веб*.<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 проверки IPMI проверки не будут работать со стандартным пакетом библиотеки OpenIPMI на Debian до 9 (stretch) версии и Ubuntu до 16.04 (xenial). Чтобы исправить проблему, пересоберите OpenIPMI библиотеку с включённым OpenSSL, как обсуждалось в [ZBX-6139](https://support.zabbix.com/browse/ZBX-6139). #### 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 нужно использовать следующий синтаксис: <команда> [<значение>] где - <команда> — одна из IPMI команд без пробелов - <значение> — «on», «off» или любое неотрицательное целое число. <значение> — опциональный параметр. #### 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). #### Проблема с IPv6 адресами в SNMPv3 трапах По причине проблемы в net-snmp, в SNMP трапах IPv6 адреса могут некорректно отображаться при использовании SNMPv3. Для получения более подробной информации и возможных вариантах решения смотрите [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 Вычисление выражений И/ИЛИ в фильтрах/переопределениях низкоуровневого обнаружения может в данной версии выполняться ошибочно. Исправлено в версии 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**. В Zabbix агенте 2 на платформе Windows эти элементы данных теперь позволяют использовать пользовательские 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 will also be formatted as multilined. {width="600"} 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 the format **ssh.run\[unique short description,<ip>,<port>,<encoding>,<ssh options>\]**|**unique short description** is required and should be unique for each SSH item per host.<br><br>Default port is 22, not the port specified in the interface to which this item is assigned.<br><br>**ssh options** (supported since version 6.0.25; require libssh of version 0.9.0 and higher or libssh2) allow passing additional SSH options in the format *key1=value1;key2=value2,value3*. Multiple values for one key can be passed separated by comma (in this case, the parameter must be [quoted](/manual/config/items/item/key#parameter---quoted-string)); multiple option keys can be passed separated by semicolon.<br><br>The following option keys are supported: `KexAlgorithms`, `HostkeyAlgorithms`, `Ciphers`, `MACs`. Option key and value support depends on the SSH library; if an option is not supported, an error will be returned, and the item will become unsupported.<br><br>Note that "+" sign for appending cipher settings and "!" for disabling specific cipher settings (as in GnuTLS and OpenSSL) are not supported.<br><br>Examples:<br>=> `ssh.run[KexAlgorithms,127.0.0.1,,,Ciphers=aes128-ctr]`<br>=> `ssh.run[KexAlgorithms,,,,"KexAlgorithms=diffie-hellman-group1-sha1;HostkeyAlgorithms=ssh-rsa,ssh-dss,ecdh-sha2-nistp256"]`| |*Authentication method*|One of the "Password" or "Public key".| | |*User name*|User name to authenticate on remote host. 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.|The return value of the executed shell command(s) is limited to 16MB (including trailing whitespace that is truncated); [database limits](/manual/config/items/item#text_data_limits) also apply.<br><br>Note that the libssh2 library may truncate executable scripts to \~32kB.<br><br>Examples:<br>*date +%s*<br>*systemctl status mysql-server*<br>*ps auxww \| grep httpd \| wc -l*| ##### Настройка элемента данных Фактически выполняемые команда(ы) необходимо поместить в поле *Выполняемый скрипт* при настройке элемента данных. Можно выполнять несколько команд одну за другой, размещая каждую на новой строке. В этом случае возвращаемые значения также будут отформатированы как многострочные. {width="600"} Все обязательные поля ввода отмечены красной звёздочкой. Поля, которые требуют информацию, специфичную для элементов данных SSH: |Параметр|Описание|Комментарии| |--|------|------| |*Тип (Type)*|Здесь выберите **SSH агент**.| | |*Ключ*<br>*(Key)*|Уникальный (в пределах узла сети) ключ элемента данных в формате **ssh.run\[уникальное короткое описание,<ip>,<порт>,<кодировка>,<опции_ssh>\]**|**уникальное короткое описание** обязательно и должно быть уникальным у всех элементов данных типа SSH в рамках одного узла сети.<br><br>По умолчанию порт 22, а не порт, указанный в интерфейсе узла сети, которому этот элемент данных назначен.<br><br>**опции_ssh** (поддерживается с версии 6.0.25; требует libssh версии 0.9.0 или выше либо libssh2) позволяют передать дополнительные опции SSH в формате *ключ1=значение1;ключ2=значение2,значение3*. Несколько значений для одного ключа можно передать через запятую (в этом случае параметр должен быть [заключён в кавычки](/manual/config/items/item/key#параметр---строка-заключённая-в-кавычки)); несколько ключей опций можно передать через разделитель «точка с запятой».<br><br>Поддерживаются следующие ключи опций : `KexAlgorithms`, `HostkeyAlgorithms`, `Ciphers`, `MACs`. Поддержка ключей и значений опций зависит от библиотеки SSH; если опция не поддерживается, будет возвращена ошибка и элемент данных станет неподдерживаемым.<br><br> Обратите внимание, что знак «+» для добавления настроек шифров и знак «!» для отключения конкретных настроек шифров (как в GnuTLS и OpenSSL) не поддерживаются.<br><br>Примеры:<br>=> `ssh.run[KexAlgorithms,127.0.0.1,,,Ciphers=aes128-ctr]`<br>=> `ssh.run[KexAlgorithms,,,,"KexAlgorithms=diffie-hellman-group1-sha1;HostkeyAlgorithms=ssh-rsa,ssh-dss,ecdh-sha2-nistp256"]`| |*Метод аутентификации*<br>*(Authentication method)*|Один из «Пароль (Password)» или «Публичный ключ (Public key)»| | |*Имя пользователя*<br>*(User name)*|Имя пользователя для аутентификации на удалённом хосте. Требуется.| | |*Файл публичного ключа*<br>*(Public key file)*|Имя файла открытого ключа, если *Метод аутентификации* задан значением «Публичный ключ». Требуется.|Например: *id\_rsa.pub* — имя по умолчанию файла открытого ключа, сгенерированного командой [ssh-keygen \[en\]](http://en.wikipedia.org/wiki/Ssh-keygen)| |*Файл приватного ключа*<br>*(Private key file)*|Имя файла закрытого ключа, если *Метод аутентификации* задан значением «Публичный ключ». Требуется.|Например: *id\_rsa* — имя по умолчанию файла закрытого ключа| |*Пароль* или<br>*Парольная фраза*<br>*(Password* или<br>*Key passphrase)*|Пароль для аутентификации или<br>Парольная фраза, **если** она была использована для закрытого ключа|Оставьте поле *Парольная фраза* пустым, если фраза не используется.<br>Смотрите также [известные проблемы](/manual/installation/known_issues#ssh-проверки) касательно использования парольных фраз.| |*Выполняемый скрипт*<br>*(Executed script)*|Команда(-ы) оболочки, выполняемые с использованием удалённой сессии SSH|Значение, возвращаемое выполняемыми командами оболочки, ограничено 16 МБ (включая конечные пробелы, которые усекаются); также применяются [ограничения базы данных](/manual/config/items/item#ограничения-текстовых-данных).<br><br>Обратите внимание, что библиотека libssh2 может усекать выполняемые скрипты до \~32 килобайт.<br><br>Примеры:<br>*date +%s*<br>*service status mysql-server*<br>*ps auxww \| grep httpd \| wc -l*| #### 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*.  #### Настройка элемента данных Зависимый элемент данных зависит от своего основного элемента данных. Поэтому сначала необходимо настроить (или использовать существующий) **основной элемент данных**: - Перейдите в: *Настройка* → *Узлы сети* - Нажмите на *Элементы данных* в строке с узлом сети - Нажмите на *Создать элемент данных* - В диалоге укажите параметры элемента данных  Все обязательные поля ввода отмечены красной звёздочкой. Нажмите на *Добавить* для сохранения основного элемента данных. Теперь вы можете настроить **зависимый элемент данных**.  Все обязательные поля ввода отмечены красной звёздочкой. Поля, которые требуют информации, специфичной для зависимых элементов данных: | | | |--|--------| |*Тип (Type)*|Выберите здесь **Зависимый элемент данных (Dependent item)**.| |*Ключ (Key)*|Укажите ключ, который будет использоваться для распознавания этого элемента данных.| |*Основной элемент данных*<br>*(Master item)*|Выберите основной элемент данных. Значение основного элемента данных будет использовано для заполнения значения зависимого элемента данных.| |*Тип информации*<br>*(Type of information)*|Выберите тип информации, который соответствует формату сохраняемых данных.| Вы можете использовать [предварительную обработку](/manual/config/items/item#предобработка-значений-элементов-данных) значений элементов данных для извлечения необходимой части из значения основного элемента данных. {width="600"} Без предварительной обработки значением зависимого элемента данных будет то же значение, что и у основного элемента данных. Нажмите на *Добавить (Add)*, чтобы сохранить зависимый элемент данных. Ссылка для более быстрого создания зависимого элемента данных может быть доступна после нажатия на кнопку  в списке элементов данных и выбора *Создать зависимый элемент данных (Create dependent item)*.  ##### Item configuration Configure a log monitoring [item](/manual/config/items/item#overview).  All mandatory input fields are marked with a red asterisk. Specifically for log monitoring items you enter: | | | |--|--------| |*Type*|Select **Zabbix agent (active)** here.| |*Key*|Use one of the following item keys:<br>**log\[\]** or **logrt\[\]**:<br>These two item keys allow to monitor logs and filter log entries by the content regexp, if present.<br>For example: `log[/var/log/syslog,error]`. Make sure that the file has read permissions for the 'zabbix' user otherwise the item status will be set to 'unsupported'.<br>**log.count\[\]** or **logrt.count\[\]**:<br>These two item keys allow to return the number of matching lines only.<br>See supported [Zabbix agent item](zabbix_agent#supported_item_keys) key section for details on using these item keys and their parameters.| |*Type of information*|Prefilled automatically:<br>For log\[\] or logrt\[\] items - `Log`;<br>For log.count\[\] or logrt.count\[\] items - `Numeric (unsigned)`.<br>If optionally using the `output` parameter, you may manually select the appropriate type of information other than `Log`.<br>Note that choosing a non-Log type of information will lead to the loss of local timestamp.| |*Update interval (in sec)*|The parameter defines how often Zabbix agent will check for any changes in the log file. Setting it to 1 second will make sure that you get new records as soon as possible.| |*Log time format*|In this field you may optionally specify the pattern for parsing the log line timestamp. 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 be set to 0 in Unix time, representing January 1, 1970.<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 message.<br>The log time format for this line would be "pppppp:yyyyMMdd:hhmmss".<br>Note that "p" and ":" characters are placeholders and can be any character except "yMdhms".| ##### Настройка элемента данных Настройте [элемент данных](/manual/config/items/item#обзор) для мониторинга журнала.  Все обязательные поля ввода отмечены красной звёздочкой. Специально для элементов данных наблюдения за журналами вам необходимо указать: | | | |--|--------| |*Тип*|Здесь выберите **Zabbix агент (активный)**.| |*Ключ*|Используйте один из следующих ключей:<br>**log\[\]** или **logrt\[\]:**<br>Эти два ключа элементов данных позволяют выполнять мониторинг файлов журналов и фильтровать записи в журналах по их содержимому при помощи регулярного выражения, если оно присутствует.<br>Например: `log[/var/log/syslog,error]`. Убедитесь, что у файла имеются права на чтение для пользователя «zabbix», в противном случае состояние элемента данных будет «не поддерживается».<br>**log.count\[\]** или **logrt.count\[\]**:<br>Эти два ключа элементов данных позволяют получить только количество соответствующих строк.<br>Для получения более подробных сведений касательно использования этих элементов данных и их параметров смотрите раздел поддерживаемых ключей [элементов данных Zabbix агентом](zabbix_agent#поддерживаемые-ключи-элементов-данных).| |*Тип информации*|Заполняется автоматически:<br>Для элементов данных log\[\] или logrt\[\] — `Журнал (лог)`;<br>для элементов данных log.count\[\] или logrt.count\[\] — `Числовой (целое положительное)`.<br>Если используется опциональный параметр `вывод`, вы можете вручную выбрать подходящий тип информации, отличный от «Журнал (лог)».<br>Обратите внимание, что выбор не журнального типа информации приведёт к потере локального штампа времени.| |*Интервал обновления (в сек)*|Этот параметр определяет, как часто Zabbix агент будет проверять наличие любых изменений в файле журнала. Указав этот параметр равным 1 секунде, вы можете быть уверенными, что получите новые записи как можно скорее.| |*Формат времени журнала*|В этом поле вы можете опционально задать шаблон для анализа штампа времени строки журнала. Поддерживаемые заменители:<br>\* **y**: *Год (1970-2038)*<br>\* **M**: *Месяц (01-12)*<br>\* **d**: *День (01-31)*<br>\* **h**: *Час (00-23)*<br>\* **m**: *Минута (00-59)*<br>\* **s**: *Секунда (00-59)*<br>Если оставить пустым, штамп времени будет выставлен в 0, что в формате Unix time представляет 1 января 1970 года.<br>Например, рассмотрим следующую строку из файла журнала Zabbix агента:<br>« 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211).»<br>Она начинается с шести символьных позиций для PID, далее следуют дата, время и остальная часть строки.<br>Форматом времени журнала для такой строки могло бы являться «pppppp:yyyyMMdd:hhmmss».<br>Обратите внимание, что символы «p» и «:» являются лишь заменителями и могут быть любыми символами, за исключением «yMdhms».| #### Item configuration in Zabbix frontend Configure a database monitoring [item](/manual/config/items/item#overview).  All mandatory input fields are marked with a red asterisk. Specifically for database monitoring items you must enter: | | | |--|--------| |*Type*|Select *Database monitor* here.| |*Key*|Enter one of the supported item keys:<br>**db.odbc.select**\[<unique short description>,<dsn>,<connection string>\] - this item is designed to return one value, i.e. the first column of the first row of the SQL query result. If a query returns more than one column, only the first column is read. If a query returns more than one line, only the first line is read.<br>**db.odbc.get**\[<unique short description>,<dsn>,<connection string>\] - this item is capable of returning multiple rows/columns in JSON format. Thus it may be used as a master item that collects all data in one system call, while JSONPath preprocessing may be used in dependent items to extract individual values. For more information, see an [example](/manual/discovery/low_level_discovery/examples/sql_queries#using-db.odbc.get) of the returned format, used in low-level discovery. This item is supported since Zabbix 4.4.<br>The unique description will serve to identify the item in triggers, etc.<br>Although `dsn` and `connection string` are optional parameters, at least one of them should be present. If both data source name (DSN) and connection string are defined, the DSN will be ignored.<br>The data source name, if used, must be set as specified in odbc.ini.<br>The connection string may contain driver-specific arguments.<br>**db.odbc.discovery**[<unique short description>,<dsn>,<connection string>] - this item returns [low-level discovery](/manual/discovery/low_level_discovery/examples/sql_queries) data.<br><br>Example (connection for MySQL ODBC driver 5):<br>=> db.odbc.get\[MySQL example,,"Driver=/usr/local/lib/libmyodbc5a.so;Database=master;Server=127.0.0.1;Port=3306"\]| |*User name*|Enter the database user name<br>This parameter is optional if user is specified in odbc.ini.<br>If connection string is used, and *User name* field is not empty, it is appended to the connection string as `UID=<user>`| |*Password*|Enter the database user password<br>This parameter is optional if password is specified in odbc.ini.<br>If connection string is used, and *Password* field is not empty, it is appended to the connection string as `PWD=<password>`.<br>Since Zabbix 6.0.34, special characters are supported in this field.<br><br>Before Zabbix 6.0.34, if the password contains a semicolon, it should be wrapped in curly brackets, for example, `{P?;)*word}`. After 6.0.34, wrapping the password in this case is still supported, but not required. The password will be appended to connection string after the username as `UID=<username>;PWD={P?;)*word}`. To test the resulting string, you can run the following command:<br>`isql -v -k 'Driver=libmaodbc.so;Database=zabbix;UID=zabbix;PWD={P?;)*word}'`| |*SQL query*|Enter the SQL query.<br>Note that with the `db.odbc.select[]` item the query must return one value only.| |*Type of information*|It is important to know what type of information will be returned by the query, so that it is selected correctly here. With an incorrect *type of information* the item will turn unsupported.| #### Настройка элемента данных в веб-интерфейсе Zabbix Настройка [элемента данных](/manual/config/items/item#обзор) для мониторинга баз данных.  Все обязательные поля ввода отмечены красной звёздочкой. Специально для элементов данных мониторинга баз данных вы должны указать: | | | |--|--------| |*Тип (Type)*|Выберите здесь *Монитор баз данных*.| |*Ключ*<br>*(Key)*|Введите один из поддерживаемых ключей элементов данных:<br>**db.odbc.select**\[<уникальное короткое описание>,<dsn>,<строка подключения>\] — этот элемент данных предназначен для получения одного значения, то есть первого столбца первой строки из результата SQL запроса. Если запрос возвращает более одного столбца, будет прочитан только первый столбец. Если запрос возвращает более одной строки, будет прочитана только первая строка.<br>**db.odbc.get**\[<уникальное короткое описание>,<dsn>,<строка подключения>\] — этот элемент данных способен возвращать несколько строк/столбцов в формате JSON. Таким образом, его можно использовать в качестве основного элемента данных, который собирает все данные за один системный вызов, а предварительную обработку JSONPath можно использовать в зависимых элементах данных для извлечения отдельных значений. Для получения более подробных сведений смотрите [пример](/manual/discovery/low_level_discovery/examples/sql_queries#использование-db.odbc.get) возвращаемого формата, использованного в низкоуровневом обнаружении. Этот элемент данных поддерживается с Zabbix 4.4.<br>Уникальное описание будет служить для идентификации элемента данных в триггерах и т.п.<br>Хотя `dsn` и `строка подключения` — опциональные параметры, по крайней мере один из них должен присутствовать. Если заданы оба параметра — и имя источника данных (DSN), и строка подключения, — то DSN будет игнорироваться.<br>Имя источника данных, если используется, необходимо указать в точности как указано в odbc.ini.<br>Строка подключения может содержать специфичные для драйверов аргументы.<br>**db.odbc.discovery**[<уникальное короткое описание>,<dsn>,<строка подключения>] — этот элемент данных возвращает данные [низкоуровневого обнаружения](/manual/discovery/low_level_discovery/examples/sql_queries).<br><br>Пример (подключение с использованием MySQL ODBC driver 5):<br>=> db.odbc.get\[MySQL example,,"Driver=/usr/local/lib/libmyodbc5a.so;Database=master;Server=127.0.0.1;Port=3306"\]| |*Имя пользователя*<br>*(User name)*|Введите имя пользователя для доступа к базе данных<br>Этот параметр необязателен, если пользователь указан в odbc.ini.<br>Если используется строка подключения и поле *Имя пользователя* непустое, тогда имя пользователя добавляется к строке подключения как `UID=<пользователь>`| |*Пароль*<br>*(Password)*|Введите пароль пользователя для доступа к базе данных<br>Этот параметр необязателен, если пароль указан в odbc.ini.<br>Если используется строка подключения и поле *Пароль* непустое, тогда пароль добавляется к строке подключения как `PWD=<пароль>`.<br>Начиная с версии Zabbix 6.0.34, в этом поле поддерживаются специальные символы.<br><br>До версии 6.0.34, если пароль содержал точку с запятой, его необходимо было заключить в фигурные скобки, например: `{P?;)*word}`. После 6.0.34 обрамление пароля фигурными скобками в этом случае всё ещё поддерживается, но не является обязательным. Пароль будет добавлен к строке подключения после имени пользователя как ` UID=<username>;PWD={P?;)*word}`. Чтобы протестировать полученную строку, можно выполнить следующую команду: <br>` isql -v -k 'Driver=libmaodbc.so;Database=zabbix;UID=zabbix;PWD={P?;)*word}'`| |*SQL запрос*<br>*(SQL query)*|Введите необходимый SQL запрос.<br>Обратите внимание, что для элемента данных `db.odbc.select[]` запрос должен возвращать только одно значение.| |*Тип информации*<br>*(Type of information)*|Важно знать, какой тип информации будет возвращаться заданным запросом, поэтому выберите здесь правильный тип информации. С неверным *типом информации* элемент данных станет неподдерживаемым.| ##### 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. ::: ##### Настройка элемента данных Для настройки элемента данных траппер: - Перейдите в: *Настройка* → *Узлы сети* - Нажмите на *Элементы данных* в строке с узлом сети - Нажмите на *Создать элемент данных* - Введите в диалоге параметры элемента данных  Все обязательные поля ввода отмечены красной звёздочкой. Поля, которые требуют указания информации, специфичной для траппер элемента данных: | | | |--|--------| |*Тип (Type)*|Здесь выберите **Zabbix траппер (Zabbix trapper)**.| |*Ключ (Key)*|Введите ключ, который будет использован для распознавания элемента данных при отправке данных.| |*Тип информации*<br>*(Type of information)*|Выберите тип информации, который будет соответствовать формату отсылаемых данных.| |*Разрешённые хосты*<br>*(Allowed hosts)*|Список разделённых запятыми IP адресов, опционально в CIDR представлении, или DNS имён.<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 \[en\]](https://tools.ietf.org/html/rfc4291#section-2.5.5).<br>Пример: 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>Пробелы и [пользовательские макросы](/manual/config/macros/user_macros) разрешены в этом поле с Zabbix 2.2.0.<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 ##### Настройка элемента данных Для [настройки элемента данных](/manual/config/items/item) на уровне узла сети: - В поле *Тип* выберите «IPMI агент» - Введите [ключ](/manual/config/items/item/key) элемента данных, уникальный в пределах узла сети (скажем, ipmi.fan.rpm) - В поле *Интерфейс узла сети* выберите подходящий IPMI интерфейс (IP и порт). Обратите внимание, IPMI интерфейс должен уже существовать на узле сети. - Укажите *IPMI датчик*, с которого забирать метрику (например, «FAN MOD 1A RPM» на Dell Poweredge). По умолчанию, необходимо указать ID датчика. Также имеется возможность использования префиксов до самого значения: - `id:` — чтобы указать ID датчика; - `name:` — чтобы указать полное имя датчика. Эта опция может быть полезна в ситуациях, когда датчики можно отличить, только указав полное имя. - Выберите соответствующий тип информации («Числовой (с плавающей точкой)» в данном случае; для дискретных датчиков — «Числовой (целое положительное)»), единицы измерения (скорее всего, «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. ##### Синтаксис фильтра элементов данных Фильтр элементов данных: /узел_сети/ключ[параметры]?[условия] состоит из четырёх частей, где: * узел_сети — имя узла сети * ключ — ключ элемента данных (без параметров) * параметры — параметры ключа элемента данных * условия — условия на основе группы узлов сети и/или тега элемента данных (как выражение) Пробелы допустимы только внутри выражения условий. **Использование подстановочных символов** * Подстановочный символ может быть использован для замены имени узла сети, ключа элемента данных или отдельного параметра ключа элемента данных. * Либо узел сети, либо ключ элемента данных должны быть указаны без подстановочного символа. Так, `/узел_сети/*` и `/*/ключ` являются корректными фильтрами, но `/*/*` некорректен. * Подстановочный символ не может быть использован как *часть* имени узла сети, ключа элемента данных, параметра ключа элемента данных. * Подстановочный символ соответствует не более чем одному параметру ключа элемента данных. Поэтому подстановочный символ должен быть указан для каждого параметра отдельно (т.е. `ключ[abc,*,*]`). **Выражение условий** Выражение условий поддерживает: * операнды: * group — группа узлов сети * tag — тег элемента данных * `"<текст>"` — строковая константа, с использованием символа обратной косой черты `\` для экранирования символов `"` и `\` * операторы чувствительного к регистру сравнения строк: `=`, `<>` * логические операторы: `and`, `or`, `not` * группировка при помощи круглых скобок: `(` `)` Строковые константы обязательно должны заключаться в кавычки. Поддерживается только чувствительное к регистру сравнение полных строк. :::notewarning При указании в фильтре тегов (т.е. `tag="имя_тега:значение"`), двоеточие (":") используется как разделитель. Всё после него рассматривается как значение тега. Поэтому в данный момент не поддерживается указание тегов, содержащих двоеточие (":") внутри имени. ::: **Примеры** Допустимы составные фильтры, ссылающиеся на ключ элемента данных, группу узлов сети и теги, как проиллюстрировано следующими примерами: |Пример синтаксиса|Описание| |--|--| |`/узел_сети/ключ[abc,*]`|Соответствует подобным элементам данных на конкретном узле сети.| |`/*/ключ`|Соответствует одинаковому элементу данных на любом узле сети.| |`/*/ключ?[group="ABC" and tag="имя_тега:значение"]`|Соответствует тому же элементу данных любого узла сети из группы ABC, имеющему тег «имя_тега:значение».| |`/*/ключ[a,*,c]?[(group="ABC" and tag="Тег1") or (group="DEF" and (tag="Тег2" or tag="Тег3:значение"))]`|Соответствует подобным элементам данных любого узла сети из групп 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#правило-обнаружения), в поле *Тип* выберите **JMX агент**. Для обнаружения JMX объектов поддерживаются два ключа элементов данных — jmx.discovery\[\] и jmx.get\[\]: |**Ключ элемента данных**|<|<|<| |-|--------|--------|----------| |<|Возвращаемое значение|Параметры|Комментарий| |**jmx.discovery**\[<режим обнаружения>,<имя объекта>,<уникальное короткое описание>\]|<|<|<| |<|Этот элемент данных возвращает массив JSON с LLD макросами, описывающими объекты MBean или их атрибуты.|**режим обнаружения** — один из следующих: *attributes* (вернуть атрибуты JMX MBean, по умолчанию) или *beans* (вернуть объекты JMX MBean)<br>**имя объекта** — шаблон имени объекта (см. [документацию \[en\]](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)), идентифицирующий имена MBean-ов, которые надо вернуть (по умолчанию пусто, вернёт все зарегистрированные bean-ы)<br>**уникальное короткое описание** — уникальное описание, позволяющее на том же узле сети задать несколько элементов данных JMX с тем же режимом обнаружения и именем объекта (опционально)|Примеры:<br>→ jmx.discovery — вернуть все атрибуты JMX MBean-ов<br>→ jmx.discovery\[beans\] — вернуть все JMX MBean-ы<br>→ jmx.discovery\[attributes,"\*:type=GarbageCollector,name=\*"\] — вернуть все атрибуты сборщика мусора (garbage collector-а)<br>→ jmx.discovery\[beans,"\*:type=GarbageCollector,name=\*"\] — вернуть все сборщики мустора<br><br>Имеются некоторые [ограничения](#ограничения) относительно того, какие свойства MBean-ов этот элемент данных может вернуть, вызванные ограниченным набором символов, который поддерживается при генерации имён макросов (поддерживаемые символы могут быть описаны следующим регулярным выражением: «`A-Z0-9_\.`»). Поэтому для обнаружения, скажем, свойств MBean-ов, содержащих слова через дефис (знак минус) или не-ASCII символы, вам нужно использовать `jmx.get[]`.<br><br>Поддерживается с версии Zabbix Java gateway 3.4.| |**jmx.get**\[<режим обнаружения>,<имя объекта>,<уникальное короткое описание>\]|<|<|<| |<|Этот элемент данных возвращает массив JSON с объектами MBean или их атрибутами.<br><br>По сравнению с `jmx.discovery[]`, он не определяет LLD макросы.|**режим обнаружения** — один из следующих: *attributes* (вернуть атрибуты JMX MBean, по умолчанию) или *beans* (вернуть объекты JMX MBean)<br>**имя объекта** — шаблон имени объекта (см. [документацию \[en\]](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)), идентифицирующий имена MBean-ов, которые надо вернуть (по умолчанию пусто, вернёт все зарегистрированные bean-ы)<br>**уникальное короткое описание** — уникальное описание, позволяющее на том же узле сети задать несколько элементов данных JMX с тем же режимом обнаружения и именем объекта (опционально)|При использовании этого элемента данных необходимо определить настраиваемые макросы низкоуровневого обнаружения, указывающие на значения, извлекаемые из возвращаемого JSON-а с помощью JSONPath.<br><br>Поддерживается с версии Zabbix Java gateway 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) применима к получению работающего правила обнаружения «Монитора баз данных». В правилах обнаружения «Монитор баз данных» можно использовать два ключа элементов данных: - **db.odbc.discovery**\[<уникальное короткое описание>,<dsn>,<строка подключения>\] — этот элемент данных преобразует результат SQL-запроса в массив JSON, превращает имена столбцов из результата запроса в имена макросов низкоуровневого обнаружения в парах с обнаруженными значениями полей. Эти макросы можно использовать при создании прототипов элементов данных, триггеров и т.п. Смотрите также: [Использование db.odbc.discovery](#использование-db.odbc.discovery). ```{=html} <!-- --> ``` - **db.odbc.get**\[<уникальное короткое описание>,<dsn>,<строка подключения>\] — этот элемент данных преобразует результат SQL-запроса в массив JSON, сохраняя оригинальные имена столбцов из результата запроса в качестве имён полей в JSON в сочетании с обнаруженными значениями. В сравнении с `db.odbc.discovery[]`, этот элемент данных не создает макросы низкоуровневого обнаружения в возвращаемом JSON, поэтому не требуется проверять, могут ли имена столбцов быть корректными именами макросов. Макросы низкоуровневого обнаружения можно определить дополнительным шагом по мере необходимости, используя функционал [настраиваемых макросов](/manual/discovery/low_level_discovery#настраиваемые-макросы) с JSONPath, указывающим на обнаруженные значения в полученном JSON. Смотрите также: [Использование db.odbc.get](#использование-db.odbc.get). #### Item keys The table provides details on the simple checks that can be used to monitor [VMware environments](/manual/vm_monitoring). Parameters without angle brackets are mandatory. Parameters marked with angle brackets **<** **>** are optional. |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 ^**[1](vmware_keys#footnotes)**^<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 global unique identifier|<| |vmware.hv.cpu.usage\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor usage (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |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 global unique identifier|<| |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 global unique identifier|<| |vmware.hv.datacenter.name\[url,uuid\]|<|<|<|<| |<|VMware hypervisor datacenter name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.datastore.discovery\[url,uuid\]|<|<|<|<| |<|Discovery of VMware hypervisor datastores.|JSON object|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.datastore.list\[url,uuid\]|<|<|<|<| |<|List of VMware hypervisor datastores.|JSON object|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.datastore.multipath\[url,uuid,<datastore>,<partitionid>\]|<|<|<|<| |<|Number of available datastore paths.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**datastore** - datastore UUID or 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 global unique identifier<br>**datastore** - datastore UUID or 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 global unique identifier<br>**datastore** - datastore UUID or 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 global unique identifier<br>**datastore** - datastore UUID or 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 global unique identifier|<| |vmware.hv.hw.cpu.freq\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor frequency (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.cpu.model\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor model.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.cpu.num\[url,uuid\]|<|<|<|<| |<|Number of processor cores on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.cpu.threads\[url,uuid\]|<|<|<|<| |<|Number of processor threads on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.memory\[url,uuid\]|<|<|<|<| |<|VMware hypervisor total memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.model\[url,uuid\]|<|<|<|<| |<|VMware hypervisor model.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.uuid\[url,uuid\]|<|<|<|<| |<|VMware hypervisor BIOS UUID.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.vendor\[url,uuid\]|<|<|<|<| |<|VMware hypervisor vendor name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.maintenance\[url,uuid\]|<|<|<|<| |<|VMware hypervisor maintenance status.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|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 global unique identifier|<| |vmware.hv.memory.used\[url,uuid\]|<|<|<|<| |<|VMware hypervisor used memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |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 global unique identifier<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 global unique identifier<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 global unique identifier<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 global unique identifier<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 global unique identifier|The item might not work in the VMware vSphere 6.5 and newer, because VMware has deprecated the *VMware Rollup Health State* sensor. | |vmware.hv.sensors.get\[url,uuid\]|<|<|<|<| |<|VMware hypervisor HW vendor state sensors.|JSON|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |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 global unique identifier|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 global unique identifier|<| |vmware.hv.version\[url,uuid\]|<|<|<|<| |<|VMware hypervisor version.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.vm.num\[url,uuid\]|<|<|<|<| |<|Number of virtual machines on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |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 global unique identifier|<| |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 global unique identifier|<| |vmware.vm.cpu.num\[url,uuid\]|<|<|<|<| |<|Number of processors on VMware virtual machine.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |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 global unique identifier<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 global unique identifier|<| |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 global unique identifier<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 global unique identifier|<| |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 global unique identifier|<| |vmware.vm.datacenter.name\[url,uuid\]|<|<|<|<| |<|VMware virtual machine datacenter name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |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 global unique identifier|<| |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 global unique identifier|<| |vmware.vm.hv.name\[url,uuid\]|<|<|<|<| |<|VMware virtual machine hypervisor name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size\[url,uuid\]|<|<|<|<| |<|VMware virtual machine total memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.ballooned\[url,uuid\]|<|<|<|<| |<|VMware virtual machine ballooned memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.compressed\[url,uuid\]|<|<|<|<| |<|VMware virtual machine compressed memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |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 global unique identifier|<| |vmware.vm.memory.size.private\[url,uuid\]|<|<|<|<| |<|VMware virtual machine private memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.shared\[url,uuid\]|<|<|<|<| |<|VMware virtual machine shared memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.swapped\[url,uuid\]|<|<|<|<| |<|VMware virtual machine swapped memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |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 global unique identifier|<| |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 global unique identifier|<| |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 global unique identifier|<| |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 global unique identifier|<| |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 global unique identifier<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 global unique identifier<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 global unique identifier<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 global unique identifier<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 global unique identifier|<| |vmware.vm.storage.committed\[url,uuid\]|<|<|<|<| |<|VMware virtual machine committed storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |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 global unique identifier<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 global unique identifier<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 global unique identifier<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 global unique identifier|<| |vmware.vm.storage.unshared\[url,uuid\]|<|<|<|<| |<|VMware virtual machine unshared storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |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 global unique identifier<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 global unique identifier|<| |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 global unique identifier|<| |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 global unique identifier<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 global unique identifier<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 global unique identifier|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 - for bytes<br>Float - for percentage|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<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). |Ключ|<|<|<|<| |-|------|--|------|------| |<|Описание|Возвращаемое значение|Параметры|Комментарии| |vmware.cl.perfcounter\[<url>,<id>,<путь>,<экземпляр>\]|<|<|<|<| |<|Метрики счётчиков производительности VMware кластера.|Целое число|**url** — URL службы VMware<br>**id** — ID кластера VMware<br>**путь** — путь к счётчику производительности ^**[1](vmware_keys#примечания)**^<br>**экземпляр** — экземпляр счётчика производительности|`id` можно получить с vmware.cluster.discovery\[\] из {\#CLUSTER.ID}| |vmware.cluster.discovery\[<url>\]|<|<|<|<| |<|Обнаружение кластеров VMware.|Объект JSON|**url** — URL службы VMware|<| |vmware.cluster.status\[<url>, <имя>\]|<|<|<|<| |<|Состояние кластера VMware.|Целое число<br>0 — серый;<br>1 — зелёный;<br>2 — жёлтый;<br>3 — красный.|**url** — URL службы VMware<br>**имя** — имя кластера VMware|<| |vmware.datastore.discovery\[<url>\]|<|<|<|<| |<|Обнаружение хранилищ VMware.|Объект JSON|**url** — URL службы VMware|<| |vmware.datastore.hv.list\[<url>,<хранилище>\]|<|<|<|<| |<|Список гипервизоров по хранилищу.|Объект JSON|**url** — URL службы VMware<br>**хранилище** — имя хранилища|<| |vmware.datastore.read\[<url>,<хранилище>,<режим>\]|<|<|<|<| |<|Время операций чтения из хранилища (миллисекунды).|Целое число ^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**хранилище** — имя хранилища<br>**режим** — latency (среднее значение, по умолчанию), maxlatency (максимальное значение)|<| |vmware.datastore.size\[<url>,<хранилище>,<режим>\]|<|<|<|<| |<|Размер хранилища VMware в байтах или в процентах от общего размера.|Целое число — для байт<br>Число с плавающей точкой — для процентов|**url** — URL службы VMware<br>**хранилище** — имя хранилища<br>**режим** — возможные значения:<br>total (по умолчанию), free, pfree (свободно, в процентах), uncommitted|<| |vmware.datastore.write\[<url>,<хранилище>,<режим>\]|<|<|<|<| |<|Время операций записи в хранилище (миллисекунды).|Целое число ^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**хранилище** — имя хранилища<br>**режим** — latency (среднее значение, по умолчанию), maxlatency (максимальное значение)|<| |vmware.dc.discovery\[<url>\]|<|<|<|<| |<|Обнаружение датацентров VMware.|Объект JSON|**url** — URL службы VMware|<| |vmware.eventlog\[<url>,<режим>\]|<|<|<|<| |<|Журнал событий VMware.|Журнал (лог)|**url** — URL службы VMware<br>**режим** - *all* (по умолчанию), *skip* — пропуск обработки старых данных|Для каждого URL должен быть только один ключ vmware.eventlog\[\] элемента данных.<br><br>Смотрите также: [примеры фильтрации](/manual/config/items/preprocessing/examples#фильтрация-записей-журнала-событий-vmware) записей журнала событий VMware.| |vmware.fullname\[<url>\]|<|<|<|<| |<|Полное имя сервиса VMware.|Строка|**url** — URL службы VMware|<| |vmware.hv.cluster.name\[<url>,<uuid>\]|<|<|<|<| |<|Имя кластера гипервизора VMware.|Строка|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.cpu.usage\[<url>,<uuid>\]|<|<|<|<| |<|Использование процессора гипервизором VMware (Гц).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.cpu.usage.perf\[<url>,<uuid>\]|<|<|<|<| |<|Использование процессора гипервизора VMware в процентном отношении за интервал времени.|Число с плавающей точкой|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.cpu.utilization\[<url>,<uuid>\]|<|<|<|<| |<|Использование процессора гипервизора VMware в процентном отношении за интервал времени, зависит от управления питанием или HT.|Число с плавающей точкой|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.datacenter.name\[<url>,<uuid>\]|<|<|<|<| |<|Имя центра обработки данных гипервизора VMware.|Строка|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.datastore.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Обнаружение хранилищ у гипервизора VMware|Объект JSON|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.datastore.list\[<url>,<uuid>\]|<|<|<|<| |<|Список хранилищ у гипервизора VMware.|Объект JSON|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.datastore.multipath\[<url>,<uuid>,<хранилище>,<partitionid>\]|<|<|<|<| |<|Количство доступных путей до хранилища.|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware<br>**хранилище** — имя или UUID хранилища<br>**partitionid** — внутренний ID физического устройства с vmware.hv.datastore.discovery|<| |vmware.hv.datastore.read\[<url>,<uuid>,<хранилище>,<режим>\]|<|<|<|<| |<|Среднее время операций чтения с хранилища данных (в миллисекундах)|Целое число ^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware<br>**хранилище** — имя или UUID хранилища<br>**режим** — latency (по умолчанию)|<| |vmware.hv.datastore.size\[<url>,<uuid>,<хранилище>,<режим>\]|<|<|<|<| |<|Размер пространства VMware хранилища в байтах или в процентах от общего размера.|Целое число — для байт<br>Число с плавающей точкой — для процентов|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware<br>**хранилище** — имя или UUID хранилища<br>**режим** — возможные значения:<br>total (по умолчанию), free, pfree (свободного места, в процентах), uncommitted|<| |vmware.hv.datastore.write\[<url>,<uuid>,<хранилище>,<режим>\]|<|<|<|<| |<|Среднее время операций записи в хранилище данных (в миллисекундах)|Целое число ^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware<br>**хранилище** — имя или UUID хранилища<br>**режим** — latency (по умолчанию)|<| |vmware.hv.discovery\[<url>\]|<|<|<|<| |<|Обнаружение гипервизоров VMware.|Объект JSON|**url** — URL службы VMware|<| |vmware.hv.fullname\[<url>,<uuid>\]|<|<|<|<| |<|Имя гипервизора VMware.|Строка|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.hw.cpu.freq\[<url>,<uuid>\]|<|<|<|<| |<|Частота процессора гипервизора VMware (Гц).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.hw.cpu.model\[<url>,<uuid>\]|<|<|<|<| |<|Модель процессора гипервизора VMware.|Строка|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.hw.cpu.num\[<url>,<uuid>\]|<|<|<|<| |<|Количество ядер процессора у гипервизора VMware.|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.hw.cpu.threads\[<url>,<uuid>\]|<|<|<|<| |<|Количество потоков процессора у гипервизора VMware.|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.hw.memory\[<url>,<uuid>\]|<|<|<|<| |<|Общее количество памяти гипервизора VMware (в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.hw.model\[<url>,<uuid>\]|<|<|<|<| |<|Модель гипервизора VMware.|Строка|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.hw.uuid\[<url>,<uuid>\]|<|<|<|<| |<|UUID BIOS гипервизора VMware.|Строка|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.hw.vendor\[<url>,<uuid>\]|<|<|<|<| |<|Имя поставщика гипервизора VMware.|Строка|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.maintenance\[<url>,<uuid>\]|<|<|<|<| |<|Состояние обслуживания гипервизора VMware.|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|Возвращает «0» — не в обслуживании или «1» — в обслуживании| |vmware.hv.memory.size.ballooned\[<url>,<uuid>\]|<|<|<|<| |<|Размер раздутой памяти гипервизора VMware (в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.memory.used\[<url>,<uuid>\]|<|<|<|<| |<|Размер используемой памяти гипервизором VMware (в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.network.in\[<url>,<uuid>,<mode>\]|<|<|<|<| |<|Статистика по входящему трафику на сетевом интерфейсе гипервизора VMware (в байтах в секунду).|Целое число ^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware<br>**режим** — bps (по умолчанию)|<| |vmware.hv.network.out\[<url>,<uuid>,<режим>\]|<|<|<|<| |<|Статистика по исходящему трафику на сетевом интерфейсе гипервизора VMware (в байтах в секунду).|Целое число ^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware<br>**режим** — bps (по умолчанию)|<| |vmware.hv.perfcounter\[<url>,<uuid>,<путь>,<экземпляр>\]|<|<|<|<| |<|Значение счётчика производительности гипервизора VMware.|Целое число ^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware<br>**путь** — путь к счётчику производительности ^**[1](vmware_keys#примечания)**^<br>**экземпляр** — экземпляр счётчика производительности. Оставьте пустым для получения агрегированных значений (по умолчанию)|<| |vmware.hv.power\[<url>,<uuid>,<макс>\]|<|<|<|<| |<|Энергопотребление гипервизора VMware (Вт).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware<br>**макс** — максимально разрешённое энергопотребление|<| |vmware.hv.sensor.health.state\[<url>,<uuid>\]|<|<|<|<| |<|Сводный датчик состояния работоспособности гипервизора VMware.|Целое число:<br>0 — серый;<br>1 — зелёный;<br>2 — жёлтый;<br>3 — красный|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|Этот элемент данных может не работать в VMware vSphere 6.5 и новее, т.к. VMware объявила датчик *VMware Rollup Health State* устаревшим.| |vmware.hv.sensors.get\[<url>,<uuid>\]|<|<|<|<| |<|Датчики состояний поставщика оборудования гипервизора VMware.|JSON|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.status\[<url>,<uuid>\]|<|<|<|<| |<|Состояние гипервизора VMware.|Целое число:<br>0 — серый;<br>1 — зеленый;<br>2 — жёлтый;<br>3 — красный.|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|Используется свойство общего состояния хост системы.| |vmware.hv.uptime\[<url>,<uuid>\]|<|<|<|<| |<|Время работы гипервизора VMware (в секундах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.version\[<url>,<uuid>\]|<|<|<|<| |<|Версия гипервизора VMware.|Строка|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.hv.vm.num\[<url>,<uuid>\]|<|<|<|<| |<|Количество виртуальных машин на гипервизоре VMware.|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware|<| |vmware.version\[<url>\]|<|<|<|<| |<|Версия сервиса VMware.|Строка|**url** — URL службы VMware|<| |vmware.vm.cluster.name\[<url>,<uuid>\]|<|<|<|<| |<|Имя виртуальной машины VMware.|Строка|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.cpu.latency\[<url>,<uuid>\]|<|<|<|<| |<|Процент времени, в течение которого виртуальная машина не может работать из-за того, что борется за доступ к физическому CPU.|Число с плавающей точкой|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.cpu.num\[<url>,<uuid>\]|<|<|<|<| |<|Количество процессоров на виртуальной машине VMware.|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.cpu.readiness\[<url>,<uuid>,<экземпляр>\]|<|<|<|<| |<|Процент времени, в течение которого виртуальная машина была готова, но не получилось ее запланировать на запуск на физическом CPU.|Число с плавающей точкой|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**экземпляр** — экземпляр CPU|<| |vmware.vm.cpu.ready\[<url>,<uuid>\]|<|<|<|<| |<|Время (в миллисекундах), когда виртуальная машина была готова, но не запланирована на выполнение на физическом CPU. Время готовности CPU зависит от количества виртуальных машин на хосте и их загрузки CPU (%).|Целое число ^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.cpu.swapwait\[<url>,<uuid>,<экземпляр>\]|<|<|<|<| |<|Процент времени CPU, потраченного на ожидание замены.|Число с плавающей точкой|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**экземпляр** — экземпляр CPU|<| |vmware.vm.cpu.usage\[<url>,<uuid>\]|<|<|<|<| |<|Использование процессора виртуальной машины VMware (Гц).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.cpu.usage.perf\[<url>,<uuid>\]|<|<|<|<| |<|Использование процессора виртуальной машины VMware в процентах в течение интервала.|Число с плавающей точкой|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.datacenter.name\[<url>,<uuid>\]|<|<|<|<| |<|Имя центра обработки данных виртуальной машины VMware.|Строка|URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.discovery\[<url>\]|<|<|<|<| |<|Обнаружение виртуальных машин VMware.|Объект JSON|**url** — URL службы VMware|<| |vmware.vm.guest.memory.size.swapped\[<url>,<uuid>\]|<|<|<|<| |<|Объём гостевой физической памяти, которая выгружается в файл подкачки (КБ).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.guest.osuptime\[<url>,<uuid>\]|<|<|<|<| |<|Всего времени с момента последней загрузки операционной системы (в секундах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.hv.name\[<url>,<uuid>\]|<|<|<|<| |<|Имя гипервизора виртуальной машины VMware.|Строка|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.memory.size\[<url>,<uuid>\]|<|<|<|<| |<|Общий размер памяти виртуальной машины VMware (в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.memory.size.ballooned\[<url>,<uuid>\]|<|<|<|<| |<|Размер раздутой памяти виртуальной машины VMware(в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.memory.size.compressed\[<url>,<uuid>\]|<|<|<|<| |<|Размер сжатой памяти виртуальной машины VMware (в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.memory.size.consumed\[<url>,<uuid>\]|<|<|<|<| |<|Объём физической памяти гипервизора (хоста), потребляемый для поддержания страниц физической памяти гостевой ОС (КБ).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.memory.size.private\[<url>,<uuid>\]|<|<|<|<| |<|Размер приватной памяти виртуальной машины VMware (в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.memory.size.shared\[<url>,<uuid>\]|<|<|<|<| |<|Размер разделяемой памяти виртуальной машины VMware (в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.memory.size.swapped\[<url>,<uuid>\]|<|<|<|<| |<|Размер памяти, выгруженной в файл подкачки виртуальной машины VMware (в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.memory.size.usage.guest\[<url>,<uuid>\]|<|<|<|<| |<|Размер памяти (в байтах), используемой виртуальной машиной VMware (статистика гостевой виртуальной машины).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.memory.size.usage.host\[<url>,<uuid>\]|<|<|<|<| |<|Размер памяти (в байтах), используемой виртуальной машиной VMware (статистика гипревизора)|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.memory.usage\[<url>,<uuid>\]|<|<|<|<| |<|Процент потреблённой физической памяти гипервизора.|Число с плавающей точкой|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.net.if.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Обнаружение сетевых интерфейсов виртуальной машины VMware.|Объект JSON|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.net.if.in\[<url>,<uuid>,<экземпляр>,<режим>\]|<|<|<|<| |<|Статистика по входящему трафику на сетевом интерфейсе виртуальной машины VMware (в байтах/пакетах в секунду).|Целое число ^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**экземпляр** — экземпляр сетевого интерфейса<br>**режим** — bps (по умолчанию)/pps — байты/пакеты в секунду|<| |vmware.vm.net.if.out\[<url>,<uuid>,<экземпляр>,<режим>\]|<|<|<|<| |<|Статистика по исходящему трафику на сетевом интерфейсе виртуальной машины VMware (в байтах/пакетах в секунду).|Целое число ^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**экземпляр** — экземпляр сетевого интерфейса<br>**режим** — bps (по умолчанию)/pps — байты/пакеты в секунду|<| |vmware.vm.net.if.usage\[<url>,<uuid>,<экземпляр>\]|<|<|<|<| |<|Утилизация сети виртуальной машиной VMware (объединённое отношение передачи и получения) в течение интервала (Кб/сек).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**экземпляр** — экземпляр сетевого интерфейса|<| |vmware.vm.perfcounter\[<url>,<uuid>,<путь>,<экземпляр>\]|<|<|<|<| |<|Значение счётчика производительности у виртуальной машины VMware.|Целое число ^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**uuid** — имя хоста гипервизора VMware<br>**путь** — путь к счётчику производительности ^**[1](vmware_keys#примечания)**^<br>**экземпляр** — экземпляр счётчика производительности. Оставьте пустым для получения агрегированных значений (по умолчанию)|<| |vmware.vm.powerstate\[<url>,<uuid>\]|<|<|<|<| |<|Состояние питания виртуальной машины VMware.|Целое число:<br>0 — выключено;<br>1 — включено;<br>2 — приостановлено.|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.storage.committed\[<url>,<uuid>\]|<|<|<|<| |<|Объём записанных данных на хранилище данных виртуальной машины VMware (в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.storage.readoio\[<url>,<uuid>,<экземпляр>\]|<|<|<|<| |<|Среднее количество невыполненных запросов на чтение к виртуальному диску в течение интервала сбора данных.|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**экземпляр** — экземпляр дискового устройства (обязательно)|<| |vmware.vm.storage.totalreadlatency\[<url>,<uuid>,<экземпляр>\]|<|<|<|<| |<|Среднее время чтения с виртуального диска (миллисекунды).|Целое число|**url** - URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**экземпляр** — экземпляр дискового устройства (обязательно)|<| |vmware.vm.storage.totalwritelatency\[<url>,<uuid>,<экземпляр>\]|<|<|<|<| |<|Среднее время записи на виртуальный диск (миллисекунды).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**экземпляр** — экземпляр дискового устройства (обязательно)|<| |vmware.vm.storage.uncommitted\[<url>,<uuid>\]|<|<|<|<| |<|Объём незаписанных данных на хранилище данных виртуальной машины VMware (в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.storage.unshared\[<url>,<uuid>\]|<|<|<|<| |<|Размер неразделяемого пространства хранилища виртуальной машины VMware (в байтах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.storage.writeoio\[<url>,<uuid>,<экземпляр>\]|<|<|<|<| |<|Среднее количество невыполненных запросов на запись на виртуальный диск в течение интервала сбора данных.|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**экземпляр** — экземпляр дискового устройства (обязательно)|<| |vmware.vm.uptime\[<url>,<uuid>\]|<|<|<|<| |<|Время непрерывной работы виртуальной машины VMware (в секундах).|Целое число|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.vfs.dev.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Обнаружение дисковых устройств виртуальной машины VMware.|Объект JSON|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|<| |vmware.vm.vfs.dev.read\[<url>,<uuid>,<экземпляр>,<режим>\]|<|<|<|<| |<|Статистика чтения с дискового устройства виртуальной машины VMware (байт/операций в секунду).|Целое число^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**экземпляр** — экземпляр дискового устройства<br>**режим** — bps (по умолчанию)/ops — байт/операций в секунду|<| |vmware.vm.vfs.dev.write\[<url>,<uuid>,<экземпляр>,<режим>\]|<|<|<|<| |<|Статистика записи на дисковое устройство виртуальной машины VMware (байт/операций в секунду).|Целое число^**[2](vmware_keys#примечания)**^|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**экземпляр** — экземпляр дискового устройства<br>**режим** — bps (по умолчанию)/ops — байт/операций в секунду|<| |vmware.vm.vfs.fs.discovery\[<url>,<uuid>\]|<|<|<|<| |<|Обнаружение файловых систем виртуальной машины VMware.|Объект JSON|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware|На гостевой виртуальной машине должны быть установлены VMware Tools.| |vmware.vm.vfs.fs.size\[<url>,<uuid>,<fsname>,<режим>\]|<|<|<|<| |<|Статистика файловой системы виртуальной машины VMware (в байтах/процентах).|Целое число — для байтов<br>Число с плавающей точкой — для процентов|**url** — URL службы VMware<br>**uuid** — имя хоста виртуальной машины VMware<br>**fsname** — имя файловой системы<br>**режим** — total/free/used/pfree/pused|На гостевой виртуальной машине должны быть установлены VMware Tools.| #### 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#правило-обнаружения), такой: 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#правило-обнаружения): 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#правило-обнаружения), является vfs.dev.discovery Этот элемент данных поддерживается только на платформах Linux, начиная с Zabbix агента 4.4. Вы можете создать правила обнаружения, используя этот элемент данных и: - фильтр: **{\#DEVNAME} совпадает `sd[\D]$`** — для обнаружения устройств с именами «sd0», «sd1», «sd2», ... - фильтр: **{\#DEVTYPE} совпадает `disk` И {\#DEVNAME} не соответствует `^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#правило-обнаружения): service.discovery Этот элемент данных поддерживается с версии Zabbix агента для Windows 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#правило-обнаружения): systemd.unit.discovery ::: noteimportant Этот ключ [элемента данных](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) поддерживается только в Zabbix агенте 2. ::: Этот элемент данных возвращает JSON с информацией о модулях (units) systemd, например: [{ "{#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#правило-обнаружения), является внутренним элементом данных: 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 The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is wmi.getall[<namespace>,<query>] This [item](/manual/config/items/itemtypes/zabbix_agent/win_keys) transforms the query result into a JSON array. For example: select * from Win32_DiskDrive where Name like '%PHYSICALDRIVE%' may return something like this: ```json [ { "DeviceID" : "\\.\PHYSICALDRIVE0", "BytesPerSector" : 512, "Capabilities" : [ 3, 4 ], "CapabilityDescriptions" : [ "Random Access", "Supports Writing" ], "Caption" : "VBOX HARDDISK ATA Device", "ConfigManagerErrorCode" : 0, "ConfigManagerUserConfig" : "False", "CreationClassName" : "Win32_DiskDrive", "Description" : "Disk drive", "FirmwareRevision" : "1.0", "Index" : 0, "InterfaceType" : "IDE" }, { "DeviceID" : "\\.\PHYSICALDRIVE1", "BytesPerSector" : 512, "Capabilities" : [ 3, 4 ], "CapabilityDescriptions" : [ "Random Access", "Supports Writing" ], "Caption" : "VBOX HARDDISK ATA Device", "ConfigManagerErrorCode" : 0, "ConfigManagerUserConfig" : "False", "CreationClassName" : "Win32_DiskDrive", "Description" : "Disk drive", "FirmwareRevision" : "1.0", "Index" : 1, "InterfaceType" : "IDE" } ] ``` This item is supported since Zabbix Windows agent 4.4. #### Ключ элемента данных Элемент данных, используемый в [правиле обнаружения](/manual/discovery/low_level_discovery#правило-обнаружения): wmi.getall[<пространство_имён>,<запрос>] Этот [элемент данных](/manual/config/items/itemtypes/zabbix_agent/win_keys) преобразует результат запроса в массив JSON. Например: select * from Win32_DiskDrive where Name like '%PHYSICALDRIVE%' может вернуть что-то наподобие этого: ```json [ { "DeviceID" : "\\.\PHYSICALDRIVE0", "BytesPerSector" : 512, "Capabilities" : [ 3, 4 ], "CapabilityDescriptions" : [ "Random Access", "Supports Writing" ], "Caption" : "VBOX HARDDISK ATA Device", "ConfigManagerErrorCode" : 0, "ConfigManagerUserConfig" : "False", "CreationClassName" : "Win32_DiskDrive", "Description" : "Disk drive", "FirmwareRevision" : "1.0", "Index" : 0, "InterfaceType" : "IDE" }, { "DeviceID" : "\\.\PHYSICALDRIVE1", "BytesPerSector" : 512, "Capabilities" : [ 3, 4 ], "CapabilityDescriptions" : [ "Random Access", "Supports Writing" ], "Caption" : "VBOX HARDDISK ATA Device", "ConfigManagerErrorCode" : 0, "ConfigManagerUserConfig" : "False", "CreationClassName" : "Win32_DiskDrive", "Description" : "Disk drive", "FirmwareRevision" : "1.0", "Index" : 1, "InterfaceType" : "IDE" } ] ``` Этот элемент данных поддерживается, начиная с версии Zabbix агента для Windows 4.4. #### Item key To configure the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule), use the following item: - `perf_instance.discovery[object]` Note that the object name may be localized. For example: ```bash perf_instance.discovery[Processor] # The object name is in English. perf_instance.discovery[Processador] # The object name is in Portuguese. ``` Alternatively, to ensure that the object name is provided in English, independent of OS localization, use the following item: - `perf_instance_en.discovery[object]` For example: ```bash perf_instance_en.discovery[Processor] perf_instance_en.discovery[Memory] ``` These items are supported since Zabbix Windows agent 5.0.1. #### Ключ элемента данных Для настройки [правила обнаружения](/manual/discovery/low_level_discovery#правило-обнаружения) используйте следующий элемент данных: - `perf_instance.discovery[объект]` Обратите внимание, что имя объекта может быть локализованным. Например: ```bash perf_instance.discovery[Processor] # Имя объекта по-английски. perf_instance.discovery[Processador] # Имя объекта по-португальски. ``` В качестве альтернативы, чтобы гарантировать, что имя объекта указано на английском языке, независимо от локализации ОС, используйте следующий элемент данных: - `perf_instance_en.discovery[объект]` Например: ```bash perf_instance_en.discovery[Processor] perf_instance_en.discovery[Memory] ``` Эти элементы данных поддерживаются, начиная с версии Zabbix агента для Windows 5.0.1. #### 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. 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  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 агент». Для настройки правила обнаружения выполните следующее: - Перейдите к: *Настройка* → *Шаблоны (Configuration* → *Templates)* - Нажмите на *Обнаружение (Discovery)* в строке с соответствующим шаблоном  - Нажмите на *Создать правило обнаружения (Create discovery rule)* в правом верхнем углу экрана - Заполните диалог правила обнаружения нужными атрибутами, как на снимке экрана ниже  Все обязательные поля ввода отмечены красной звёздочкой. Идентификаторы объектов (OID'ы) для обнаружения определяются в поле «SNMP OID» в следующем формате: `discovery[{#МАКРОС1}, oid1, {#МАКРОС2}, oid2, …,]` где *{\#МАКРОС}*, *{\#МАКРОС2}* … — это корректные имена LLD макросов, а *oid1*, *oid2*... — OID'ы, способные генерировать осмысленные значения для этих макросов. Ко всем обнаруженным объектам применяется встроенный макрос *{\#SNMPINDEX}*, содержащий индекс обнаруженных OID'ов. Обнаруженные объекты группируются по значению макроса *{\#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}, имеющим индексы обнаруженных OID-ов — **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, не проверяет подлинность сертификата, не проверяет имя хоста в SSL сертификате, только извлекает заголовок ответа (запрос HEAD). По умолчанию используется порт 443, если он не указан. **imap** Создаёт TCP-соединение и ожидает, что первые 4 символа ответа будут «\* OK», после чего посылает «a1 LOGOUT\\r\\n». По умолчанию используется порт 143, если он не указан. **ldap** Открывает соединение на сервер LDAP и выполняет операцию поиска (LDAP search) с фильтром, выставленным в (objectClass=\*). Ожидает успешного извлечения первого атрибута у первого элемента. По умолчанию используется порт 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), где major и minor являются версиями протокола, а 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 \[en\]](http://tools.ietf.org/html/rfc4330#section-5). По умолчанию используется порт 123, если он не указан. # itemprototype.create # itemprototype.create # itemprototype.delete # itemprototype.delete # itemprototype.get # itemprototype.get ### Item prototypes Item prototypes that can be created based on systemd service discovery include, for example: - Item name: `{#UNIT.DESCRIPTION} active state info`; item key: `systemd.unit.info["{#UNIT.NAME}"]` - Item name: `{#UNIT.DESCRIPTION} load state info`; item key: `systemd.unit.info["{#UNIT.NAME}",LoadState]` `systemd.unit.info` [agent items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) are supported since Zabbix 4.4. ### Прототипы элементов данных Прототипы элементов данных, которые могут быть созданы на основе обнаружения служб systemd, включают, например: - Имя элемента данных: `{#UNIT.DESCRIPTION} active state info`; ключ элемента данных: `systemd.unit.info["{#UNIT.NAME}"]` - Имя элемента данных: `{#UNIT.DESCRIPTION} load state info`; ключ элемента данных: `systemd.unit.info["{#UNIT.NAME}",LoadState]` [Элемент данных](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) `systemd.unit.info` поддерживается с версии Zabbix 4.4. #### Item prototypes The following screenshot illustrates how we can use these macros in item prototypes:  You can create as many item prototypes as needed: {width="600"} #### Прототипы элементов данных Следующий снимок экрана иллюстрирует, как мы можем использовать эти макросы в прототипах элементов данных:  Мы можем создать столько прототипов элементов данных, сколько нам необходимо: {width="600"} ### 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.| ### Тег прототипа элемента данных Объект тега прототипа элемента данных имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |**tag**<br>(обязательное)|строка|Название тэга прототипа элемента данных.| |value|строка|Значение тэга прототипа элемента данных.| # 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) #### Элементы данных Определяет элементы данных для мониторинга. [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 Элемент данных [docker.container_stats](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#docker) в Zabbix агенте 2 теперь возвращает такжи и свойство `pids_stats` с текущим количеством процессов/потоков в контейнере. #### Items / item prototypes In an [item](/manual/config/items/item) or an [item prototype](/manual/discovery/low_level_discovery/item_prototypes) configuration, user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Item key parameters|<|yes| |Update interval|<|no| |Custom intervals|<|no| |History storage period|<|no| |Trend storage period|<|no| |Description|<|yes| |*Calculated/aggregate item*|<|<| | |Formula (expression constants and function parameters; item key parameters; (*aggregate item only*) filter conditions (host group name and tag name))|yes| |*Database monitor*|<|<| | |Username|yes| |^|Password|yes| |^|SQL query|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 proxy|yes| |^|HTTP authentication username|yes| |^|HTTP authentication password|yes| |^|SSl certificate file|yes| |^|SSl key file|yes| |^|SSl key password|yes| |^|Allowed hosts|yes| |*JMX agent*|<|<| | |JMX endpoint|yes| |*Script item*|<|<| | |Parameter names and values|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| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes| |*Preprocessing*|<|<| | |Step parameters (including custom scripts)|yes| #### Элементы данных / прототипы элементов данных При настройке [элементов данных](/manual/config/items/item) или [прототипов элементов данных](/manual/discovery/low_level_discovery/item_prototypes) пользовательские макросы могут использоваться в следующих полях: |Место|<|Несколько макросов/вперемешку с текстом^[1](supported_by_location_user#примечания)^| |-|------------------------------|----------| |Параметры ключа элемента данных|<|да| |Интервал обновления|<|нет| |Пользовательские интервалы|<|нет| |Период хранения истории|<|нет| |Период хранения динамики изменений|<|нет| |Описание|<|да| |*Вычисляемый/агрегируемый элемент данных*|<|<| | |Формула (константы выражения и параметры функции; параметры ключа элемента данных; (*только агрегируемый элемент данных*) условия фильтра (имя группы узлов сети и имя тега))|да| |*Монитор баз данных*|<|<| | |Имя пользователя|да| |^|Пароль|да| |^|SQL запрос|да| |*HTTP агент*|<|<| | |URL^[3](supported_by_location_user#примечания)^|да| |^|Поля запроса|да| |^|Время ожидания|нет| |^|Тело запроса|да| |^|Заголовки (имена и значения)|да| |^|Требуемые коды состояния|да| |^|HTTP прокси|да| |^|Имя пользователя для HTTP аутентификации|да| |^|Пароль для HTTP аутентификации|да| |^|Файл SSL сертификата|да| |^|Файл SSL ключа|да| |^|Пароль к SSL ключу|да| |^|Разрешённые хосты|да| |*JMX агент*|<|<| | |JMX endpoint|да| |*Скриптовый элемент данных*|<|<| | |Имена и значения параметров|да| |*SNMP агент*|<|<| | |SNMP OID|да| |*SSH агент*|<|<| | |Имя пользователя|да| |^|Файл публичного ключа|да| |^|Файл приватного ключа|да| |^|Пароль|да| |^|Выполняемый скрипт|да| |*TELNET агент*|<|<| | |Имя пользователя|да| |^|Пароль|да| |^|Выполняемый скрипт|да| |*Zabbix траппер*|<|<| | |Разрешённые хосты|да| |*Теги*^[2](supported_by_location_user#примечания)^|<|<| | |Имена тегов|да| |^|Значения тегов|да| |*Предобработка*|<|<| | |Параметры шагов (включая пользовательские скрипты)|да| #### 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 вы можете использовать два элемента данных: - Внутренний элемент данных `zabbix[stats,<ip>,<порт>]` - для прямых удалённых запросов к Zabbix серверу/прокси. <ip> и <порт> используются для идентификации необходимого целевого экземпляра. - Элемент данных агента `zabbix.stats[<ip>,<порт>]` для удалённых запросов к Zabbix серверу/прокси через агента. <ip> и <порт> используются для идентификации необходимого целевого экземпляра. Смотрите также: [Внутренние элементы данных](/manual/config/items/itemtypes/internal), [Элементы данных Zabbix агента](/manual/config/items/itemtypes/zabbix_agent). Следующая диаграмма иллюстрирует использование обоих элементов данных в зависимости от контекста.  -  - Сервер → внешний экземпляр Zabbix (`zabbix[stats,<ip>,<порт>]`) -  - Сервер → прокси → внешний экземпляр Zabbix (`zabbix[stats,<ip>,<порт>]`) -  - Сервер → агент → внешний экземпляр Zabbix (`zabbix.stats[<ip>,<порт>]`) -  - Сервер → прокси → агент → внешний экземпляр Zabbix (`zabbix.stats[<ip>,<порт>]`) Чтобы убедиться, что целевой экземпляр разрешает запросы к себе со стороны внешнего экземпляра, укажите адрес внешнего экземпляра в параметре '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.| ### Тег элемента данных Объект тега элемента данных имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |**tag**<br>(обязательное)|строка|Имя тега элемента данных.| |value|строка|Значение тега элемента данных.| ##### 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]  Когда элемент данных будет настроен, подождите минуту, пока изменения конфигурации вступят в силу, и затем перейдите в [Последние данные](/manual/web_interface/frontend_sections/monitoring/latest_data), чтобы убедиться, что элемент данных начал собирать данные. # 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. #### Предварительная обработка значений элементов данных Для визуализации процесса предобработки данных мы можем использовать следующую упрощённую диаграмму:  Диаграмма выше показывает только процессы, объекты и основные действия, связанные с предварительной обработкой значений элементов данных, в **упрощённой** форме. Диаграмма не отображает изменения направлений при различных условиях, обработку ошибок или циклы. На диаграмме показан только один рабочий процесс («preprocessing worker») предварительной обработки (в реальных сценариях могут использоваться несколько таких процессов), обрабатывается только одно значение элемента данных, и мы предполагаем, что этот элемент данных требует выполнения по крайней мере одного шага предварительной обработки. Цель этой диаграммы — показать идею конвейера предварительной обработки значений элемента данных. - Данные элемента данных и значение элемента данных передаются менеджеру предварительной обработки с использованием механизма IPC на основе сокета. - Элемент данных помещается в очередь предварительной обработки. ::: noteclassic Элементы данных могут помещаться в конец и начало очереди предварительной обработки. Внутренние элементы данных Zabbix всегда помещаются в начало очереди предварительной обработки, тогда как другие элементы данных помещаются в конец. ::: - На этом этапе поток данных останавливается до тех пор, пока не появится хотя бы один не занятый (не выполняющий никакие задачи) рабочий процесс («worker») предварительной обработки. - Когда «worker» становится доступным, ему направляется задача предварительной обработки. - После завершения предварительной обработки (как неудачного, так и успешного выполнения шагов предварительной обработки), обработанное значение передаётся обратно менеджеру предварительной обработки. - Менеджер предварительной обработки конвертирует результат в желаемый формат (заданный типом значения элемента данных) и помещает его в очередь предобработки. Если у текущего элемента данных имеются зависимые элементы данных, то зависимые элементы данных также добавляются в очередь предобработки. Зависимые элементы данных помещаются в очередь предварительной обработки сразу после основного элемента данных, но только по тем основным элементам данных, у которых имеется значение и они не находятся в НЕПОДДЕРЖИВАЕМОМ состоянии. #### 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. #### Обработка значений элементов данных Для визуализации потока данных от источника данных к базе данных Zabbix мы можем использовать следующую упрощённую диаграмму:  Диаграмма выше в **упрощенной** форме показывает только процессы, объекты и действия, которые связаны с предварительной обработкой значений элементов данных. Диаграмма не отображает изменения направлений при различных условиях, обработку ошибок или циклы. Локальный кэш данных в менеджере предобработки тоже не показан, так как он не влияет напрямую на поток данных. Цель этой диаграммы — показать процессы, вовлеченные в обработку значений элементов данных, а также способ их взаимодействия. - Сбор данных начинается с сырых данных от источника данных. В этот момент данные содержат только ID, штамп времени и значение (также может быть несколько значений). - Не важно какой используется тип сборщика данных, идея одинакова для активных, пассивных проверок, для траппер элементов данных и т.д., поскольку меняется только формат данных и инициатор передачи (либо сборщик данных ожидает соединение и данные, либо сборщик данных инициирует соединение и запрашивает данные). Сырые данные проверяются, конфигурация элемента данных извлекается из кэша конфигурации (в данные добавляются конфигурационные данные). - Механизм IPC на основе сокета используется для передачи данных от сборщиков данных к менеджеру предобработки. В этот момент сборщик данных продолжает сбор данных без ожидания ответа от менеджера предварительной обработки. - Выполняется предварительная обработка данных. Это включает в себя выполнение шагов предварительной обработки и обработку зависимых элементов данных. ::: noteclassic В процессе выполнения предварительной обработки элемент данных может изменить свое состояние на НЕ ПОДДЕРЖИВАЕТСЯ, если какой-либо шаг предварительной обработки завершается с ошибкой. ::: - Данные истории из локального кэша данных менеджера предобработки сбрасываются в кэш истории. - Тут поток данных останавливается до следующей синхронизации кэша истории (когда процесс history syncer выполняет синхронизацию данных). - Процесс синхронизации начинается с нормализации записываемых данных в базу данных Zabbix. Нормализация данных выполняет конвертации в желаемый тип элемента данных (тип, заданный в конфигурации элемента данных), включая обрезку текстовых данных на основе предопределённых размеров для этих типов (HISTORY\_STR\_VALUE\_LEN для строк, HISTORY\_TEXT\_VALUE\_LEN для текста и HISTORY\_LOG\_VALUE\_LEN для журнал (лог) значений). Данные будут отправлены в базу данных Zabbix после завершения нормализации. ::: noteclassic Элемент данных может изменить своё состояние на НЕ ПОДДЕРЖИВАЕТСЯ, если процесс нормализации завершится с ошибкой (например, когда текстовое значение не удалось преобразовать в число). ::: - Выполняется обработка собранных данных — проверяются триггеры, обновляется конфигурация элементов данных, если элемент данных становится НЕПОДДЕРЖИВАЕМЫМ, и тому подобное. - Этот момент считается завершением потока данных с точки зрения обработки значений элементов данных. #### Item values displayed as HTML using iframes Item data in the [Plain text](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/plain_text) widget, when displayed as HTML-formatted text, is now isolated in iframes. #### Значения элементов данных отображаются в формате HTML с использованием iframe Значения элементов данных в виджете [Простой текст (Plain text)](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/plain_text) при отображении в виде HTML-форматированного текста теперь изолированы в iframe'ы. #### 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*|<|объект|Имя узла сети этого элемента данных.| | |host|строка|Имя узла сети.| |^|name|строка|Видимое имя узла сети.| |*groups*|<|массив|Список групп узлов сети для узла сети этого элемента данных; в массиве должен быть по крайней мере один элемент.| | |\-|строка|Имя группы узла сети.| |*itemid*|<|число|ID элемента данных.| |*name*|<|строка|Видимое имя элемента данных.| |*clock*|<|число|Количество секунд с начала эпохи до момента сбора значения (целая часть).| |*ns*|<|число|Количество наносекунд, которые нужно добавить к `clock` для получения точного времени сбора значения.| |*timestamp*<br>(только *Журнал (лог)*)|<|число|0 если недоступно.| |*source*<br>(только *Журнал (лог)*)|<|строка|Пустая строка если недоступно.| |*severity*<br>(только *Журнал (лог)*)|<|число|0 если недоступно.| |*eventid*<br>(только *Журнал (лог)*)|<|число|0 если недоступно.| |*value*|<|число(для числовых элементов данных) или<br>строка (для текстовых элементов данных)|Собранное значение элемента данных.| |*type*|<|число|Тип собранного значения:<br>0 — Числовой (с плавающей точной), 1 — Символ, 2 — Журнал (лог), 3 — Числовой (целое положительное), 4 — Текст| #### Item value suffixes Suffixes can also be used to display numeric item values in a human-readable format. To enable this, use one of the following suffixes in the *Units* field when [configuring an item](/manual/config/items/item#configuration): - **B** - bytes - **Bps** - bytes per second - **s** - seconds, displayed using up to three largest non-zero time units - **uptime** - elapsed time in hh:mm:ss or N days, hh:mm:ss - **unixtime** - Unix timestamp, formatted as yyyy.mm.dd hh:mm:ss The following additional rules apply to how these suffixes are interpreted and displayed: - For B and Bps, Zabbix uses base-2 conversion (1K = 1024B), following the [JEDEC](https://en.wikipedia.org/wiki/JEDEC_memory_standards) standard. - For other units (such as Hz, W, etc.), Zabbix uses base-10 conversion (1K = 1000). - For s (seconds): - The format includes yyy mmm ddd hhh mmm sss ms; only up to three largest non-zero time units are displayed (e.g., 1M 10d 4h). - If a unit is zero and between two non-zero units, it is omitted (e.g., 10d 56m instead of 10d 0h 56m). When *Units* are used, the following multiplier suffixes are automatically applied to item values: - **K**, **M**, **G**, **T** - kilo, mega, giga, tera - **P**, **E**, **Z**, **Y** - peta, exa, zetta, yotta *(these are applied in frontend only)* #### Суффиксы значений элементов данных Суффиксы также могут использоваться для отображения числовых значений элементов данных в удобном для восприятия формате. Чтобы включить это, используйте один из следующих суффиксов в поле *Единицы измерения* при [настройке элемента данных](/manual/config/items/item#настройка): - **B** — байты - **Bps** — байты в секунду - **s** — секунды, отображаются с использованием до трёх самых больших ненулевых единиц времени - **uptime** — прошедшее время в формате «чч:мм:сс» или «N дней, чч:мм:сс» - **unixtime** — отметка времени Unix, отформатированная как «гггг.мм.дд чч:мм:сс» К тому, каким образом эти суффиксы интерпретируются и отображаются, применяются следующие дополнительные правила : - Для «B» (байты) и «Bps» (байты в секунду) Zabbix использует преобразование с основанием 2 (1K = 1024B), следуя стандарту [JEDEC \[en\]](https://en.wikipedia.org/wiki/JEDEC_memory_standards). - Для остальных единиц (таких как Гц, Вт и т. д.) Zabbix использует преобразование по основанию 10 (1K = 1000). - Для «s» (секунды): - Формат включает «ггг ммм ддд ччч ммм ссс мс»; отображаются только до трёх самых больших ненулевых единиц времени (например, «1M 10д 4ч»). - Если единица равна нулю и находится между двумя ненулевыми единицами, она опускается (например, «10д 56м» вместо «10д 0ч 56м»). При использовании *Единиц измерения* к значениям элементов данных автоматически применяются следующие суффиксы множителей: - **K**, **M**, **G**, **T** — кило, мега, гига, тера - **P**, **E**, **Z**, **Y** — пета, экса, зетта, иотта *(эти применяются только в веб-интерфейсе)* ##### 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) указывает на столбец, для которого настроены пороговые значения, а второе число указывает на пороговое место в списке, отсортированном по возрастанию. Однако, если пороговые значения настроены в другом порядке, значения будут отсортированы по возрастанию после обновления конфигурации виджета в интерфейсе Zabbix. (например, `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold. 1": "5"`). ::: |Параметр|<|[тип](/manual/api/reference/dashboard/object#dashboard-widget-field)|имя|значение| |-|--------|--|--------|-------------------------------| |*Элемент*|<|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>Параметр *Интервал агрегации* недоступен, если для *Функция агрегации* установлено значение *none*.<br><br>По умолчанию: `1h`.| |*Отображение*|<|0|columns.display.0|1 - *(по умолчанию)* Как есть;<br>2 - Столбцы;<br>3 - Индикаторы.| |*Min*|<|1|columns.min.0|Любое числовое значение.<br><br>Параметр *Min* недоступен, если для *Отображение* установлено значение «Как есть».| |*Max*|<|1|columns.max.0|Любое числовое значение.<br><br>Параметр *Max* недоступен, если для *Отображение* установлено значение «Как есть».| |*Данные истории*|<|0|columns.history.0|1 - *(по умолчанию)* Авто;<br>2 - История;<br>3 - Динамика изменений.| |*Пороги*|<|<|<|<| |<|*Цвет*|1|columnsthresholds.color.0.0|Шестнадцатеричный код цвета (например, `FF0000`).<br><br>По умолчанию: `""` (пусто).| |^|*Порог*|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 gateway требуется Java 11 Из-за обновлённых минимальных версий библиотеки logback теперь для 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 gateway Если вы получили Zabbix из репозитория исходных кодов или скачали архив, то необходимые зависимости уже включены в дерево исходного кода. Если вы получили Zabbix из пакетов вашего дистрибутива, то необходимые зависимости обеспечиваются системой управления пакетами. В обоих вышеупомянутых случаях программное обеспечение готово к использованию, и скачивать какие-либо дополнительные файлы не нужно. Однако, если вы хотите использовать другие версии этих зависимостей (например, если вы готовите пакет для определённого дистрибутива Linux), ниже приведён список версий библиотек, для которых подтверждена работоспособность Java gateway. Zabbix также может работать с другими версиями этих библиотек. Следующая таблица содержит список JAR файлов, которые поставляются вместе в Java gateway в оригинальном коде: |Библиотека|Признак обязательности|Комментарии| |--|-|-------| |[android-json](https://mvnrepository.com/artifact/com.vaadin.external.google/android-json)|Да|Версия 4.3r1 или новее.<br>JSON (JavaScript Object Notation) — это легковесный формат обмена данными. Это совместимая с org.json реализация Android, которая была извлечена из Android SDK.| |[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 gateway может быть скомпилирован с использованием Oracle Java или с использованием OpenJDK (версия 1.6 или новее) с открытым исходным кодом. Пакеты, поставляемые Zabbix, скомпилированы с использованием OpenJDK. Таблица, приведённая ниже, содержит информацию о пакетах OpenJDK, использованных для сборки пакетов Zabbix в зависимости от дистрибутива: |Дистрибутив|Пакет 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 gateway [Java gateway](/manual/concepts/java) необходимо устанавливать только, если вы хотите мониторить JMX приложения. Java gateway легковесный и не требует наличия базы данных. После добавления требуемого репозитория вы можете установить Zabbix Java gateway, выполнив следующую команду: apt install zabbix-java-gateway Перейдите к [разделу настройки](/manual/concepts/java/from_debian_ubuntu) для получения более подробных сведений касательно настройки и запуска Java gateway. ### 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 [Java gateway](/manual/concepts/java) необходимо устанавливать только, если вы хотите мониторить JMX приложения. Java gateway легковесный и не требует наличия базы данных. Как только требуемый репозиторий добавлен, вы можете установить Zabbix Java gateway выполнив следующую команду: # dnf install zabbix-java-gateway Перейдите к [разделу настройки](/manual/concepts/java/from_rhel_centos) для получения более подробных сведений касательно настройки и запуску Java gateway. ### 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 gateway [Java gateway](/manual/concepts/java) необходимо устанавливать только, если вы хотите мониторить JMX приложения. Java gateway легковесный и не требует наличия базы данных. После добавления требуемого репозитория вы можете установить Zabbix Java gateway, выполнив следующую команду: dnf install zabbix-java-gateway Перейдите к [разделу настройки](/manual/concepts/java/from_rhel) для получения более подробных сведений касательно настройки и запуска Java gateway. #### 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 В подсистему JavaScript добавлены HTTP методы PATCH, HEAD, OPTIONS, TRACE и CONNECT. Также, подсистема теперь поддерживает отправку пользовательских запросов методом HTTP при помощи нового JS метода HttpRequest.customRequest. Смотрите также: [Дополнительные объекты 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» и заданным пользователем телом функции. Результатом шага предобработки является значение, которое возвращается из этой функции, например, для выполнения конвертации из градусов Фаренгейта в градусы Цельсия пользователю необходимо ввести: return (value - 32) * 5 / 9 Это будет обёрнуто сервером в функцию JavaScript : ``` {.java} function (value) { return (value - 32) * 5 / 9 } ``` Входной параметр «value» всегда передаётся как строка. Возвращаемое значение автоматически приводится к строке через метод ToString() (если он завершится с ошибкой, тогда эта ошибка возвращается в виде строкового значения), с несколькими исключениями: - возврат неопределённого значения приведёт к ошибке - возврат значения null приведет к тому, что входящее значение будет отброшено, очень похоже на предварительную обработку «Отбросить значение» на действие «Другое при ошибке». Ошибки можно вернуть при помощи выбрасывания значений/объектов в качестве исключений (обычно это строки или объекты ошибок). Например: ``` {.java} if (value == 0) throw "Zero input value" return 1/value ``` У каждого скрипта есть 10-секундный тайм-аут — время ожидания выполнения (в зависимости от скрипта, срабатывание тайм-аута может занять более длительное время); превышение времени ожидания вернёт ошибку. Также применяется ограничение heap памяти в 512 мегабайт (64 мегабайта до версии 6.0.19). Байт-код шага предобработки JavaScript кэшируется и используется повторно, когда шаг применяется в следующий раз. Любые изменения в шагах предварительной обработки элемента данных вызовут сброс закэшированного скрипта и затем его перекомпиляцию. Последовательные ошибки во время выполнения (3 раза подряд) вызовут повторную инициализацию механизма для уменьшения вероятности того, что один скрипт сломает всю среду выполнения для следующих скриптов (это действие заносится в журнал с режимом отладки DebugLevel 4 и выше). Предобработка JavaScript реализована при помощи механизма JavaScript Duktape (<https://duktape.org/>). Смотрите также: [Дополнительные объекты и глобальные функции JavaScript](/manual/config/items/preprocessing/javascript/javascript_objects) ### JavaScript preprocessing The heap limit for scripts has been upped from 64 to 512 megabytes. ### Предобработка JavaScript Ограничение на размер кучи (heap) было повышено с 64 to 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 вебхук (пользовательский)  Этот скрипт создаст проблему (issue) в 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 #### 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 long ```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#размер-базы-данных). При меньшем хранении истории, вы всё равно сможете просматривать старые данные на графиках, поскольку для отображения старых данных графики будут использовать значения динамики изменений. ::: noteimportant Если история установлена в значение «0», то элемент данных будет обновлять только зависимые элементы данных и поля инвентарных данных. Функции триггера не будут вычисляться, так как триггерные вычисления основаны только на данных истории. ::: ::: notetip В качестве альтернативного подхода к хранению истории ознакомьтесь с функционалом [экспорта истории](/manual/config/items/loadablemodules#предоставление-обратного-вызова-экспорту-истории) в подгружаемых модулях. ::: #### 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. ::: #### Хранение динамики изменений Динамика изменений является встроенным механизмом обработки данных истории, где по числовым типам данных для каждого часа хранятся значения минимума, максимума, среднее и общее количество значений. Вы можете указать, как много дней будет храниться динамика изменений: - в [диалоге](/manual/config/items/item) свойств элемента данных - при массовом обновлении элементов данных - при настройке задач очистки истории Обычно динамика изменений может храниться намного дольше чем история. Любые более старые данные будут удалены при помощи автоматической очистки базы данных (Housekeeper). Во время работы, по мере поступления новых значений, Zabbix сервер собирает и хранит динамику изменений в специальном кэше динамики изменений. Сервер сбрасывает динамику изменения **предыдущего часа** каждого элемента данных в базу данных (при этом она становится доступной из веб-интерфейса) в следующих случаях: - сервер получает первое за текущий час значение элемента данных - до конца текущего часа остаётся 5 или менее минут и всё ещё не пришло ни одно значение элемента данных за текущий час - сервер останавливается Таким образом, самое раннее, когда можно увидеть новое значение динамики изменения текущего часа в веб-интерфейсе — это начало следующего часа (если элемент данных обновляется регулярно), а самое позднее — конец следующего часа (если элемент данных обновляется редко), что даёт 2 часа максимум. Если в момент сбрасывания значения динамики изменения сервер замечает, что значение за соответствующий час в базе данных уже имеется (например, сервер был перезапущен в середине часа), ему, возможно, придётся выполнять SQL инструкции обновления вместо вставки. Поэтому на больших инсталляциях, если необходим перезапуск сервера, постарайтесь спланировать его так, чтобы остановка сервера произошла в конце часа, а запуск — в начале следующего, чтобы избежать перекрытие данных динамики изменений. При работе со значениями динамики изменений Zabbix сервер к таблицам истории базы данных не обращается. ::: noteimportant Если динамика изменений установлена в значение «0», Zabbix сервер вообще не будет считать и хранить динамику изменений. ::: ::: noteclassic Динамика изменений вычисляется и сохраняется с использованием того же типа данных, что и исходные значения. В результате среднее значение вычисления значений целочисленных типов данных округляется, и чем меньше интервал значений, тем меньше будет точность результата. Например, если элемент данных имеет значения 0 и 1, то средним значением будет 0, а не 0.5. Перезапуск сервера также может привести к потере точности вычислений средних значений у целочисленных типов данных за текущий час. ::: ##### 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**|<|<|<| |Максимальное количество открытых файлов, поддерживаемое ОС.|Целое число| | | |**kernel.maxproc**|<|<|<| |Максимальное количество процессов, поддерживаемое ОС.|Целое число| | | |**kernel.openfiles**|<|<|<| |Получение количества открытых в данный момент файловых дескрипторов.|Целое число| |Этот элемент данных поддерживается, начиная с 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 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: ```ini # SSHKeyLocation= ``` Uncomment it and set the full path to the folder where the public and private keys will be located: ```ini SSHKeyLocation=/home/zabbix/.ssh ``` Save the file and restart Zabbix server afterwards. The path */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 an [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 the *zabbix* user account with a home directory elsewhere, for example, */var/lib/zabbix* (as for system accounts). Before generating the keys, you could reallocate the home directory to */home/zabbix*, so that it corresponds with the `SSHKeyLocation` Zabbix server configuration parameter mentioned above. ::: noteclassic The following steps can be skipped if *zabbix* account has been added manually according to the [installation section](/manual/installation/install#create_user_account). In such a case the home directory for the *zabbix* account is most likely already */home/zabbix*. ::: To change the home directory of the *zabbix* user account, all working processes which are using it have to be stopped: ```bash systemctl stop zabbix-agent systemctl stop zabbix-server ``` To change the home directory location with an attempt to move it (if it exists) the following command should be executed: ```bash usermod -m -d /home/zabbix zabbix ``` It is also possible that a home directory did not exist in the old location, so it should be created at the new location. A safe attempt to do that is: ```bash 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: ```bash chown zabbix:zabbix /home/zabbix chmod 700 /home/zabbix ``` Previously stopped processes can now be started again: ```bash systemctl start zabbix-agent systemctl start zabbix-server ``` Now, the steps to generate the public and private keys can be performed with the following commands (for better readability, command prompts are commented out): ```bash 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): /home/zabbix/.ssh/id_rsa # Enter passphrase (empty for no passphrase): <Leave empty> # Enter same passphrase again: <Leave empty> # 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+ | # +-----------------+ ``` ::: noteclassic The public and private keys (*id\_rsa.pub* and *id\_rsa*) 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` и найдите следующую строку: ```ini # SSHKeyLocation= ``` Раскомментируйте её и укажите полный путь к папке, где размещены открытые и закрытые ключи (public and private keys): ```ini SSHKeyLocation=/home/zabbix/.ssh ``` Затем сохраните файл и перезапустите сервер Zabbix. Здесь */home/zabbix* — домашняя папка для учётной записи пользователя *zabbix*, а *.ssh* — папка внутри неё, куда по умолчанию с помощью команды [ssh-keygen \[en\]](http://en.wikipedia.org/wiki/Ssh-keygen) будут сгенерированы открытые и закрытые ключи. Обычно при установке сервера Zabbix из пакетов на разных дистрибутивах ОС создается аккаунт пользователя *zabbix* с домашней папкой в не очень стандартных местах, например, */var/lib/zabbix* (как для системных аккаунтов). До начала создания ключей рассмотрите вариант перемещения домашней папки в более известное место (интуитивно ожидаемое). Этот вариант будет соответствовать параметру `SSHKeyLocation` конфигурации Zabbix сервера, упомянутому выше. ::: noteclassic Эти шаги можно пропустить, если учётная запись *zabbix* добавлена вручную в соответствии с [разделом установки](/manual/installation/install#создайте-аккаунт-пользователя), потому что в этом случае домашняя папка, скорее всего, уже расположена в */home/zabbix*. ::: Для изменения этой настройки у учётной записи пользователя *zabbix* все работающие процессы, которые его используют, потребуется остановить: ```bash systemctl stop zabbix-agent systemctl stop zabbix-server ``` Чтобы изменить местоположение домашней папки с попыткой переместить её (если папка существует), вы должны выполнить команду: ```bash usermod -m -d /home/zabbix zabbix ``` Вполне возможно, что домашняя папка не существует в старом месте, поэтому в новом месте её необходимо создать. Безопасная попытка, чтобы сделать это: ```bash test -d /home/zabbix || mkdir /home/zabbix ``` Чтобы быть уверенным, что всё безопасно, можно выполнить дополнительные команды для установки разрешений к домашней папке: ```bash chown zabbix:zabbix /home/zabbix chmod 700 /home/zabbix ``` Теперь можно снова запустить ранее остановленные процессы: ```bash systemctl start zabbix-agent systemctl start zabbix-server ``` Теперь шаги генерирования открытых и закрытых ключей можно выполнить следующими командами (для лучшей читабельности запросы команд закомментированы): ```bash 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): /home/zabbix/.ssh/id_rsa # 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+| # +-----------------+ ``` ::: noteclassic Открытые и закрытые ключи (*id\_rsa.pub* и *id\_rsa* соответственно) будут сгенерированы по умолчанию в папке */home/zabbix/.ssh*, которая соответствует параметру конфигурации `SSHKeyLocation` Zabbix сервера. ::: ::: noteimportant Утилитой ssh-keygen и сервером SSH могут поддерживаться ключи и других типов, нежели «rsa»; но они могут не поддерживаться используемой 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 миллисекунд, время ожидания — 500 миллисекунд, а все остальные параметры будут заполнены значениями по умолчанию. #### 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. #### Известные проблемы Смотрите [известные проблемы](/manual/installation/known_issues#графики) по графикам. #### 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#медленная-синхронизация-конфигурации-с-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), который установит Zabbix прокси и Zabbix агенты в кластер Kubernetes. Чтобы узнать больше о настройке шаблонов, обратитесь к [работа с 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 эксабайт). Обратите внимание, что файловая система может иметь меньшее ограничение на максимальный размер файлов. ### 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) теперь отображает количество элементов данных с последними данными. ### LDAP authentication External LDAP authentication 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. Zabbix LDAP authentication works at least with Microsoft Active Directory and OpenLDAP.  Configuration parameters: |Parameter|Description| |--|--------| |*Enable LDAP authentication*|Mark the checkbox to enable LDAP authentication.| |*LDAP host*|Name of LDAP server. For example: ldap://ldap.zabbix.com<br>For secure LDAP server use *ldaps* protocol.<br>ldaps://ldap.zabbix.com<br>With OpenLDAP 2.x.x and later, a full LDAP URI of the form ldap://hostname:port or ldaps://hostname:port may be used.| |*Port*|Port of LDAP server. Default is 389.<br>For secure LDAP connection port number is normally 636.<br>Not used when using full LDAP URIs.| |*Base DN*|Base path to search accounts:<br>ou=Users,ou=system (for OpenLDAP),<br>DC=company,DC=com (for Microsoft Active Directory)| |*Search attribute*|LDAP account attribute used for search:<br>uid (for OpenLDAP),<br>sAMAccountName (for Microsoft Active Directory)| |*Bind DN*|LDAP account for binding and searching over the LDAP server, examples:<br>uid=ldap\_search,ou=system (for OpenLDAP),<br>CN=ldap\_search,OU=user\_group,DC=company,DC=com (for Microsoft Active Directory)<br>Anonymous binding is also supported. Note that anonymous binding potentially opens up domain configuration to unauthorized users (information about users, computers, servers, groups, services, etc.). For security reasons, disable anonymous binds on LDAP hosts and use authenticated access instead.| |*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."| |*Bind password*|LDAP password of the account for binding and searching over the LDAP server.| |*Test authentication*|Header of a section for testing| |*Login*|Name of a test user (which is currently logged in the Zabbix frontend). This user name must exist in the LDAP server.<br>Zabbix will not activate LDAP authentication if it is unable to authenticate the test user.| |*User password*|LDAP password of the test user.| ::: notewarning In case of trouble with certificates, to make a secure LDAP connection (ldaps) work you may need to add a `TLS_REQCERT allow` line to the /etc/openldap/ldap.conf configuration file. It may decrease the security of connection to the LDAP catalog. ::: ::: notetip It is recommended to create a separate LDAP account (*Bind DN*) to perform binding and searching over the LDAP server with minimal privileges in the LDAP instead of using real user accounts (used for logging in the Zabbix frontend).<br> Such an approach provides more security and does not require changing the *Bind password* when the user changes his own password in the LDAP server.<br> In the table above it's *ldap\_search* account name. ::: ### Аутентификация LDAP Внешнюю аутентификацию LDAP можно использовать для проверки имён пользователей и паролей. Обратите внимание, что пользователь также должен существовать в Zabbix, однако его пароль Zabbix не будет использоваться. Аутентификация Zabbix LDAP работает как минимум с Microsoft Active Directory и OpenLDAP.  Параметры конфигурации: |Параметр|Описание| |--|--------| |*Активация LDAP аутентификации*<br>*(Enable LDAP authentication)*|Поставьте флажок, чтобы включить аутентификацию LDAP.| |*Хост LDAP*<br>*(LDAP host)*|Имя сервера LDAP. Например: ldap://ldap.zabbix.com<br>Для защищённого сервера LDAP используйте протокол *ldaps*.<br>ldaps://ldap.zabbix.com<br>Для OpenLDAP 2.x.x и более поздних версий можно использовать полный URI LDAP в форме ldap://имяхоста:порт или ldaps://имяхоста:порт.| |*Порт*<br>*(Port)*|Порт сервера LDAP. По умолчанию — 389.<br>Для безопасного подключения LDAP номер порта обычно равен 636.<br>Не используется при использовании полных URI LDAP.| |*База для поиска (Base DN)*|Базовый путь для поиска учётных записей:<br>ou=Users,ou=system (для OpenLDAP),<br>DC=company,DC=com (для Microsoft Active Directory)| |*Атрибут поиска*<br>*(Search attribute)*|Атрибут учётной записи LDAP, используемый для поиска:<br>uid (для OpenLDAP),<br>sAMAccountName (для Microsoft Active Directory)| |*Имя для подключения (Bind DN)*|Учётная запись LDAP для подключения и поиска на сервере LDAP, примеры:<br>uid=ldap\_search,ou=system (для OpenLDAP),<br>CN=ldap\_search,OU=user\_group ,DC=company,DC=com (для Microsoft Active Directory)<br>Анонимное подключение также поддерживается. Обратите внимание, что анонимное подключение потенциально открывает доступ к конфигурации домена неавторизованным пользователям (информация о пользователях, компьютерах, серверах, группах, службах и т. д.). Из соображений безопасности отключите анонимные подключения на хостах LDAP и используйте вместо этого аутентифицированный доступ.| |*Регистрозависимый вход*<br>*(Case sensitive login)*|Снимите флажок, чтобы отключить для имен пользователей вход с учётом регистра (включённый по умолчанию).<br>Отключение входа с учётом регистра позволяет, например, войти в систему пользователем «admin», даже если пользователем Zabbix является «Admin» или «ADMIN».<br>Обратите внимание, что если вход с учётом регистра отключён и существует несколько Zabbix пользователей с похожими именами пользователей (например, Admin и admin), вход для этих пользователей всегда будет запрещён со следующим сообщением об ошибке: «Authentication failed: supplied credentials are not unique (Аутентификация не удалась: предоставленные учётные данные не уникальны)».| |*Пароль подключения (Bind password)*|Пароль LDAP учётной записи для подключения и поиска на сервере LDAP.| |*Тест аутентификации*<br>*(Test authentication)*|Заголовок секции для тестирования| |*Вход в систему*<br>*(Login)*|Имя тестового пользователя (который в данный момент зарегистрирован в веб-интерфейсе Zabbix). Это имя пользователя должно существовать на сервере LDAP.<br>Zabbix не будет активировать аутентификацию LDAP, если он не сможет аутентифицировать тестового пользователя.| |*Пароль пользователя*<br>*(User password)*|Пароль LDAP тестового пользователя.| ::: notewarning В случае проблем с сертификатами, чтобы обеспечить работу безопасного соединения LDAP (ldaps), вам может потребоваться добавить строку `TLS_REQCERT allow` в файл конфигурации `/etc/openldap/ldap.conf`. Это может снизить безопасность подключения к каталогу LDAP. ::: ::: notetip Рекомендуется создать отдельную учётную запись LDAP (*Bind DN*) для выполнения подключения и поиска на сервере LDAP с минимальными привилегиями в LDAP вместо использования учётных записей реальных пользователей (которые подключаются к веб-интерфейсу Zabbix).<br> Такой подход обеспечивает большую безопасность и не требует изменения *Пароля подключения (Bind password)*, когда пользователь меняет свой пароль на сервере LDAP.<br> В таблице выше эта учётная запись имеет имя *ldap\_search*. ::: #### 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.| #### Легенда Для настройки *Легенды* поддерживаются следующие параметры. |Параметр|[тип](/manual/api/reference/dashboard/object#поле-виджета-панели)|имя|значение| |-----|-|-----|-------------------| |*Show legend*|0|легенда|0 - отключено;<br>1 - *(по умолчанию)* включено.| |*Number of rows*|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`. Проблема заключается в порядке флагов линкера, и одно из решений — указать полный путь к библиотеке в переменной 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 \[en\]](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 ##### Ограничения - Зависимости разрешены только в пределах одного узла сети (шаблона) - Прототип элемента данных может зависеть от другого прототипа элемента данных или от обычного элемента данных с этого же узла сети - Максимальное количество зависимых элементов данных от одного основного элемента данных ограничено 29999 элементами данных (независимо от количества уровней зависимости) - Разрешено максимум 3 уровня зависимости - Зависимый элемент данных с основным элементом данных из шаблона не экспортируется в XML #### Limitations on using X.509 v3 certificate extensions When implementing X.509 v3 certificates within Zabbix, certain extensions may not be fully supported or could result in inconsistent behavior. **Subject Alternative Name extension** Zabbix does not support the *Subject Alternative Name* extension, which is used to specify alternative DNS names such as IP addresses or email addresses. Zabbix can only validate the value in the *Subject* field of the certificate (see [Restricting Allowed Certificate Issuer and Subject](#restricting-allowed-certificate-issuer-and-subject)). If certificates include the `subjectAltName` field, the outcome of certificate validation may vary depending on the specific crypto toolkits used to compile Zabbix components. As a result, Zabbix may either accept or reject certificates based on these combinations. **Extended Key Usage extension** Zabbix supports the *Extended Key Usage* extension. However, if used, it is generally required that both *clientAuth* (for TLS WWW client authentication) and *serverAuth* (for TLS WWW server authentication) attributes are specified. For example: - In passive checks, where Zabbix agent operates as a TLS server, the *serverAuth* attribute must be included in the agent's certificate. - For active checks, where the agent operates as a TLS client, the *clientAuth* attribute must be included in the agent's certificate. While GnuTLS may issue a warning for key usage violations, it typically allows communication to proceed despite these warnings. **Name Constraints extension** Support for the *Name Constraints* extension varies among crypto toolkits. Ensure that your chosen toolkit supports this extension. This extension may restrict Zabbix from loading CA certificates if this section is marked as critical, depending on the specific toolkit in use. #### Ограничения при использовании расширений сертификатов X.509 v3 При реализации сертификатов X.509 v3 в Zabbix некоторые расширения могут поддерживаться не полностью или могут привести к несовместимому поведению. **Расширение «Альтернативное имя субъекта» (Subject Alternative Name)** Zabbix не поддерживает расширение «Subject Alternative Name», которое используется для указания альтернативных имён DNS — таких как IP адрес или e-mail адрес. В Zabbix проверяется только значение поля «Субъект» сертификата (смотри [Ограничение разрешённых Эмитента и Субъекта сертификата](#ограничение-разрешённых-эмитента-и-субъекта-сертификата)). Если сертификат содержит поле `subjectAltName`, то результат проверки сертификата может зависеть от конкретной комбинации наборов криптографических инструментов, используемых для компиляции компонентов Zabbix. В результате, в зависимости от этих комбинаций, Zabbix может либо принимать, либо отклонять сертификаты. **Расширение «Использование Расширенного Ключа» (Extended Key Usage)** Zabbix поддерживает расширение *Extended Key Usage*. Однако, если оно используется, то, как правило, требуется, чтобы были указаны как *clientAuth* (для аутентификации клиента TLS WWW), так и *serverAuth* (для аутентификации сервера TLS WWW). Например: - При пассивных проверках, где Zabbix агент выступает в роли TLS сервера, в сертификате агента должен присутствовать атрибут *serverAuth*. - При активных проверках, где агент выступает в качестве TLS клиента, в сертификате агента должен присутствовать атрибут *clientAuth*. Хотя GnuTLS может выдавать предупреждение о нарушениях использования ключа, он обычно позволяет продолжать соединение, несмотря на эти предупреждения. **Расширение «Ограничения Имени» (Name Constraints)** Поддержка расширения *Name Constraints* различается в разных наборах инструментов шифрования. Убедитесь, что выбранный вами набор инструментов поддерживает это расширение. В зависимости от конкретного набора инструментов криптографии, если эта секция помечена как критическая, то это расширение может помешать Zabbix в загрузке сертификатов CA. #### 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 переговоров (TLS handshake), кэширование сессий и мандаты (tickets) не реализованы. - Добавление шифрования увеличивает время на проверки элементов данных и действия, в зависимости от сетевых задержек: - Например, если задержка пакета составляет 100мс, тогда открытие TCP соединения и отправка незашифрованного запроса займет около 200мс. При наличии шифрования добавится около 1000 мс на установление TLS соединения. - Возможно, потребуется увеличить время ожидания (тайм-ауты), в противном случае некоторые элементы данных и действия, выполняющие удалённые скрипты на агентах, смогут работать с незашифрованными соединениями, но не смогут при шифрованном соединении (будет превышено время ожидания). - Шифрование не поддерживается [сетевым обнаружением](/manual/discovery/network_discovery). Проверки агентов Zabbix, выполняемые сетевым обнаружением, будут нешифрованными, и если агент Zabbix настроен отвергать нешифрованные соединения, то такие проверки не будут успешными. #### Limitations Support of loadable modules is implemented for the Unix platform only. It means that it does not work for Windows agents. In some cases a module may need to read module-related configuration parameters from *zabbix\_agentd.conf*. It is not supported currently. If you need your module to use some configuration parameters you should probably implement parsing of a module-specific configuration file. #### Ограничения Поддержка подгружаемых модулей реализована только на платформах Unix. Это означает, что подгружаемый модуль не работает на Zabbix агентах под Windows. В некоторых случаях модулю может потребоваться прочитать параметры, имеющие отношение к модулю, из *zabbix\_agentd.conf*. В настоящее время этот функционал не поддерживается. Если вам необходимо в вашем модуле использовать некоторые параметры конфигурации, то вам, вероятно, следует реализовать анализ отдельного файла конфигурации модуля. ##### Limitations There are some limitations associated with the algorithm of creating LLD macro names from MBean property names: - attribute names are changed to uppercase - attribute names are ignored (no LLD macros are generated) if they consist of unsupported characters for LLD macro names. Supported characters can be described by the following regular expression: `A-Z0-9_\.` - if an attribute is called "obj" or "domain" they will be ignored because of the overlap with the values of the reserved Zabbix properties {\#JMXOBJ} and {\#JMXDOMAIN} (supported since Zabbix 3.4.3.) Please consider this jmx.discovery (with "beans" mode) example. MBean has the following properties defined (some of which will be ignored; see below): name=test тип=Type attributes []=1,2,3 Name=NameOfTheTest domAin=some As a result of JMX discovery, the following LLD macros will be generated: - {\#JMXDOMAIN} - Zabbix internal, describing the domain of MBean - {\#JMXOBJ} - Zabbix internal, describing MBean object - {\#JMXNAME} - created from "name" property Ignored properties are: - тип : its name contains unsupported characters (non-ASCII) - attributes\[\] : its name contains unsupported characters (square brackets are not supported) - Name : it's already defined (name=test) - domAin : it's a Zabbix reserved name ##### Ограничения Имеются некоторые ограничения, связанные с алгоритмом создания имён LLD макросов из имён свойств MBean: - имена атрибутов приводятся к верхнему регистру - имена атрибутов игнорируются (LLD макросы не генерируются), если они состоят из символов, не поддерживаемых для имён LLD макросов. Поддерживаемые символы могут быть описаны следующим регулярным выражением: `A-Z0-9_\.` - если атрибуты называются «obj» или «domain», они будут проигнорированы, т.к. перекрываются со значениями зарезервированных в Zabbix свойств {\#JMXOBJ} и {\#JMXDOMAIN} (поддерживются с версии Zabbix 3.4.3.) Пожалуйста, рассмотрите данный пример jmx.discovery (с режимом «beans»). MBean имеет следующие определённые для него свойства (некоторые из них будут игнорироваться; см. ниже): name=test тип=Type attributes []=1,2,3 Name=NameOfTheTest domAin=some В результате JMX обнаружения, будут сгенерированы следующие LLD макросы: - {\#JMXDOMAIN} — внутренний макрос Zabbix, описывающий домен MBean - {\#JMXOBJ} — внутренний макрос Zabbix, описывающий объект MBean - {\#JMXNAME} — создан из свойства «name» Проигнорированные свойства: - тип : его имя содержит неподдерживаемые символы (не-ASCII) - attributes\[\] : его имя содержит неподдерживаемые символы (квадратные скобки не поддерживаются) - Name : уже определено (name=test) - domAin : зарезервированное имя Zabbix #### 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. #### Ограничения Zabbix агент для Windows не поддерживает нестандартные конфигурации Windows, где CPU распределены неравномерно по узлам NUMA. Если логические CPU распределены неравномерно, то метрики производительности CPU могут быть недоступными для некоторых CPU. Например, если имеется 72 логических CPU с 2 нодами NUMA, обе ноды должны иметь по 36 CPU каждая. ### 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#дополнительные-объекты-javascript) в предварительной обработке: - Суммарный размер всех сообщений, которые могут быть записаны в журнал методом `log()`, был ограничен до 8 МБ на выполнение скрипта. - Инициализация нескольких объектов `HttpRequest` была ограничена до 10 на выполнение скрипта. - Суммарная длина полей заголовков, которые могут быть добавлены к одному объекту `HttpRequest` методом `addHeader()`, была ограничена до 128 килобайт (включая специальные символы и имена заголовков). ### 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#дополнительные-объекты-javascript) в предварительной обработке: - Суммарный размер всех сообщений, которые могут быть записаны в журнал методом `log()`, был ограничен до 8 МБ на выполнение скрипта. - Инициализация нескольких объектов `HttpRequest` была ограничена до 10 на выполнение скрипта. - Суммарная длина полей заголовков, которые могут быть добавлены к одному объекту `HttpRequest` методом `addHeader()`, была ограничена до 128 килобайт (включая специальные символы и имена заголовков). #### 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#использование-фильтра)) могут работать некорректно при применении к объектам, содержащим определённые символы Unicode (например, ȼ, ɇ). Эта проблема возникает из-за того, как сопоставление (collation) по умолчанию utf8mb4\_bin для баз данных MySQL или MariaDB обрабатывает сортировку и сравнение символов Unicode. Чтобы устранить это ограничение, пользователи могут изменить сопоставление столбцов базы данных на альтернативные, такие как utf8mb4\_0900\_bin, utf8mb4\_0900\_ai\_ci или utf8mb4\_unicode\_520\_ci. Однако, следует отметить, что изменение параметров сопоставления может привести к неожиданному поведению при обработке пустых мест, а также при сортировке и фильтрации других символов. Более подробную информацию об изменении параметров сопоставления смотрите в [документации MySQL \[en\]](https://dev.mysql.com/doc/refman/8.4/en/alter-table.html#alter-table-character-set) или [документации MariaDB \[en\]](https://mariadb.com/kb/en/alter-database/). Подробнее о различиях параметров сопоставления смотрите в [наборах символов Unicode \[en\]](https://dev.mysql.com/doc/refman/8.4/en/charset-unicode-sets.html) в документации MySQL. #### Linking a template To link a template to the host, do the following: - Go to *Configuration → Hosts* - Click on the required host - 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 field and select one or several templates from the list in a popup window - Click on *Add/Update* in the host attributes form The host will now have all the entities (items, triggers, graphs, etc) of the template. ::: noteimportant Linking multiple templates to the same host will fail if in those templates there are items with the same item key. And, as triggers and graphs use items, they cannot be linked to a single host from multiple templates either, if using identical item keys. ::: When entities (items, triggers, graphs etc.) are added from the template: - previously existing identical entities on the host are updated as entities of the template, and **any existing host-level customizations to the entity are lost** - entities from the template are added - any directly linked entities that, prior to template linkage, existed only on the host remain untouched In the lists, all entities from the template now are prefixed by the template name, indicating that these belong to the particular template. The template name itself (in gray text) is a link allowing to access the list of those entities on the template level. If some entity (item, trigger, graph etc.) is not prefixed by the template name, it means that it existed on the host before and was not added by the template. #### Присоединение шаблона Для присоединения шаблона к узлу сети, сделайте следующее: - Перейдите в *Настройка → Узлы сети (Configuration → Hosts)* - Щёлкните мышью на требуемом узле сети - Начните вводить название шаблона в поле *Шаблоны (Templates)*. Появится список с совпадающими шаблонами; просто прокрутите список, чтобы выбрать интересующие шаблоны. - Кроме того, вы можете нажать на *Выбрать (Select)* сразу после поля и выбрать один или несколько шаблонов из списка во всплывающем окне - Нажмите на *Добавить/Обновить (Add/Update)* в диалоге атрибутов узла сети Узел сети теперь будет включать в себя все объекты (элементы данных, триггеры, графики и т.д.) с шаблона. ::: noteimportant Присоединение нескольких шаблонов к одному узлу сети завершится ошибкой, если в этих шаблонах будут элементы данных с одинаковыми ключами. И, так как триггеры и графики используют элементы данных, их также нельзя присоединить к одному узлу сети из нескольких шаблонов в случае, если используются одинаковые ключи элементов данных. ::: Когда объекты (элементы данных, триггеры, графики и т.п.) добавляются из шаблона: - ранее существовавшие идентичные объекты у узла сети будут обновлены как объекты из шаблона, при этом **все имевшиеся настройки этих объектов на уровне узла сети теряются** - будут добавлены объекты из шаблона - любые напрямую присоединённые объекты, которые существовали до добавления шаблона только на узле сети, останутся нетронутыми В списках, все объекты из шаблона теперь будут иметь префикс имени шаблона, который указывает на принадлежность этих объектов соответствующему шаблону. Само название шаблона (серым текстом) является ссылкой, дающей доступ к списку этих объектов на уровне шаблона. Если какой-то объект (элемент данных, триггер, график и т.п.) не имеет префикс с именем шаблона, то это означает, что этот объект существовал на узле сети ранее и не был добавлен шаблоном. #### 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.| #### Связи элементов После того, как вы расставите элементы на карте, самое время соединить их. Для соединения двух элементов вы должны сначала выбрать их. Когда элементы будут выбраны, нажмите на *Добавить (Add)* справа от подписи Связь (Link). При наличии созданной связи, диалог одного элемента теперь содержит дополнительный раздел *Связи (Links)*. Нажмите на *Изменить (Edit)* для редактирования атрибутов связи. {width="600"} Атрибуты связей: |Параметр|Описание| |--|--------| |*Подпись*<br>*(Label)*|Подпись, которая будет отображаться поверх связи.<br>В этом поле поддерживаются [макросы](/manual/appendix/macros/supported_by_location) выражений, но только с функциями `avg`, `last`, `min` и `max`, со временем в качестве параметра (например, `{?avg(/узел сети/ключ,1h)}`).| |*Подключаться через*<br>*(Connect to)*|Элемент, к которому присоединяется связь.| |*Тип (ОК)*<br>*(Type (OK))*|Стиль связи по умолчанию:<br>**Линия (Line)** — одиночная линия<br>**Жирная линия (Bold line)** — жирная линия<br>**Точечная линия (Dot)** — точки<br>**Пунктирная линия (Dashed line)** — пунктирная линия| |*Цвет (ОК)*<br>*(Color (OK))*|Цвет связи по умолчанию.| |*[Индикаторы связи](links)*<br>*(Link indicators)*|Список триггеров, соединённых со связью. В случае, если триггер в состоянии ПРОБЛЕМА, его стиль применяется к связи.| ##### 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 поставляется с набором предопределённых шаблонов для различных ОС, устройств и приложений. Чтобы начать наблюдение как можно быстрее, вы можете присоединить соответствующий шаблон к узлу сети; но нужно учесть, что эти шаблоны потребуется доработать для вашей среды. Некоторые проверки могут не понадобиться, а интервалы проверок могут быть слишком частыми. Доступна более подробная информация о [шаблонах](/manual/config/templates). ##### Linking templates to several hosts To update template linkage of many hosts, in *Configuration → Hosts* select some hosts by marking their checkboxes, then click on **[Mass update](/manual/config/hosts/hostupdate)** below the list and then select *Link templates*:  To link additional templates, start typing the template name in the auto-complete field until a dropdown appears offering the matching templates. Just scroll down to select the template to link. The *Replace* option will allow to link a new template while unlinking any template that was linked to the hosts before. The *Unlink* option will allow to specify which templates to unlink. The *Clear when unlinking* option will allow to not only unlink any previously linked templates, but also remove all elements inherited from them (items, triggers, etc.). ::: notetip Zabbix offers a sizable set of predefined templates. You can use these for reference, but beware of using them unchanged in production as they may contain too many items and poll for data too often. If you feel like using them, fine-tune them to fit your real needs. ::: ##### Присоединение шаблонов к нескольким узлам сети Чтобы обновить присоединение шаблона к множеству узлов сети, в *Настройка → Узлы сети (Configuration → Hosts)* выберите несколько узлов сети, отмечая их флажками, затем нажмите на **[Массовое обновление](/manual/config/hosts/hostupdate) (Mass update)** ниже списка, а затем выберите *Присоединить шаблоны (Link templates)*:  Чтобы присоединить дополнительные шаблоны, начните вводить имя шаблона в поле с функцией автодополнения до появления выпадающего списка с предлагаемыми совпавшими шаблонами. Просто прокрутите список, чтобы выбрать интересующие шаблоны. Опция *Замена (Replace)* позволит присоединить новый шаблон и отсоединить все шаблоны, ранее присоединённые к узлам сети. Опция *Отсоединить (Unlink)* позволит указать, какие шаблоны нужно отсоединить. Опция *Очистить при отсоединении (Clear when unlinking)* позволит не только отсоединить любые ранее присоединённые шаблоны, но также и удалить все унаследованные элементы с этих шаблонов (элементы данных, триггеры и т.п.). ::: notetip Zabbix предлагает значительный набор уже предустановленных шаблонов. Вы можете их использовать для примера, но будьте осторожны, используя эти шаблоны в производственной среде без изменений, так как они могут содержать слишком много элементов данных и опрашивать данные слишком часто. Если вы хотите их использовать, настройте их в соответствии с вашими реальными потребностями. ::: #### 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. #### Соединение шаблона с узлом сети Когда шаблон будет готов, остается только добавить его к узлу сети. Для этого перейдите в *Настройки → Узлы сети*, нажмите на «Новый узел сети», откроется диалог его настроек, найдите поле **Шаблоны**. Здесь, начните печатать *Новый шаблон* в поле *Шаблоны*. Имя шаблона, который мы создали ранее, должно появится во всплывающем списке. Прокрутите список и выберите шаблон. Обратите внимание, что шаблон появится в поле *Шаблоны*.  Нажмите *Обновить* в диалоге для сохранения изменений. Теперь шаблон добавлен к узлу сети со всеми своими объектами, которые он имеет. Как вы уже могли догадаться, такой способ можно применять также и к любым другим узлам сети. Любые изменения элементов данных, триггеров и остальных объектов на уровне шаблона будут распространяться и на узлы сети, с которыми этот шаблон соединён. #### 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 #### Доступные ссылки По каждой записи доступны следующие ссылки: - Узлы сети - Мониторинг - Последние данные - Проблемы - Графики - Панели - Веб-сценарии - Настройка - Элементы данных - Триггеры - Графики - Правила обнаружения - Веб-сценарии ```{=html} <!-- --> ``` - Группы узлов сети - Мониторинг - Последние данные - Проблемы - Веб-сценарии - Настройка - Узлы сети - Шаблоны ```{=html} <!-- --> ``` - Шаблоны - Настройка - Элементы данных - Триггеры - Графики - Панели шаблонов - Правила обнаружения - Веб-сценарии ##### Links Clicking on a map element opens a menu with some available links. ##### Ссылки Щелчок мышью по элементу карты открывает меню с некоторыми доступными ссылками. #### Linux kernel threads #### Потоки ядра Linux #### 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, смотрите в таблице. |Поддерживаемое значение|Описание|Источник в файле /proc/<pid>/status| |--|------|--| |vsize ^[1](proc_mem_notes#примечания)^|Размер виртуальной памяти|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. Например, ядра Linux 2.4 не поддерживают значения `hwm`, `pin`, `peak`, `pte` и `swap`. 2. Мы заметили, что процесс само-диагностики активных проверок Zabbix агента с `proc.mem[...,...,...,...,data]` отображает значение, которое на 4 КБ больше, чем отдаёт строка `VmData` в файле агента /proc/<pid>/status. Во время измерения себя сегмент данных агента увеличивается на 4 КБ и затем возвращается к предыдущему размеру. ##### 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"} Отображаемые данные: |Столбец|Описание| |--|--------| |*Запланированная проверка*<br>*(Scheduled check)*|Время, когда проверка должна была выполниться.| |*Задерживается на*<br>*(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 Путь макроса правила обнаружения имеет следующие свойства: |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |**lld\_macro**<br>(обязательное)|string|Макрос правила обнаружения.| |**path**<br>(обязательное)|string|Селектор для значения, которое будет присвоено соответствующему макросу.| ### 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 Объект фильтра правила обнаружения определяет набор условий, которые могут быть использованы для фильтрации обнаруженных объектов. Он имеет следующие свойства: |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |**conditions**<br>(обязательное)|array|Набор условий фильтрации для использования при фильтрации результатов. | |**evaltype**<br>(обязательное)|integer|Метод оценки условия фильтра.<br><br>Возможные значения:<br>0 - и/или;<br>1 - и;<br>2 - или;<br>3 - пользовательское выражение.| |eval\_formula|string|*(только для чтения) * Сгенерированное выражение, которое будет использоваться для оценки условий фильтра. Выражение содержит идентификаторы, которые ссылаются на конкретные условия фильтра по их `formulaid`. Значение `eval_formula` равно значению `formula` для фильтров с пользовательским выражением.| |formula|string|Пользовательское выражение, используемое для оценки фильтров с пользовательским выражением. Выражение должно содержать идентификаторы, которые ссылаются на конкретные условия фильтра по их `formulaid`. Идентификаторы, используемые в выражении, должны точно соответствовать условиям фильтра: ни одно условие не может остаться неиспользованным или пропущенным.<br><br>Обязательно для фильтров с пользовательским выражением.| ##### 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 переопределяет тренды Правило обнаружения переопределяет значение трендов, которые установлены для обнаруженного элемента данных. Оно имеет следующие свойства: |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |**trends**<br>(обязательное)|string|Переопределяет значения прототипа элемента данных, которые указывают как долго должны храниться данные о трендах. Также может быть пользовательским макросом или макросом правила обнаружения.| ### 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#типы-данных)|Описание| |--|--|------| |**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 value.| |follow\_redirects|integer|HTTP agent LLD rule field. Follow response redirects while polling 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.| |verify\_host|integer|HTTP agent LLD rule field. Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| |verify\_peer|integer|HTTP agent LLD rule field. Whether to validate that the host's certificate is authentic.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Правило LLD Объект правила низкоуровневого обнаружения (LLD) имеет следующие свойства. |Свойство|[Тип](/manual/api/reference_commentary#типы-данных)|Описание| |--|--|------| |itemid|string|*(только для чтения)* ID правила LLD.| |**delay**<br>(обязательно)|string|Интервал обновления правила LLD. Принимает секунды или единицу времени с суффиксом, а также с одним или несколькими [настраиваемыми интервалами](/manual/config/items/item/custom_intervals), которые состоят из гибких интервалов и интервалов расписания в виде сериализованных строк. Также поддерживает пользовательские макросы. Гибкие интервалы могут быть записаны в виде двух макросов, разделенных косой чертой. Интервалы разделяются точкой с запятой.<br><br>Необязательно для Zabbix trapper, зависимых элементов данных и для Zabbix агента (активного) с ключом `mqtt.get`.| |**hostid**<br>(обязательно)|string|ID узла сети, к которому принадлежит правило LLD.| |**interfaceid**<br>(обязательно)|string|ID интерфейса узла сети для правила LLD. Используется только для правил LLD узла сети.<br><br>Не требуется для Zabbix агента (активный), Zabbix internal, Zabbix trapper, зависимых элементов данных, мониторинга базы данных и скриптовых правил LLD. Необязательно для HTTP агента LLD.| |**key\_**<br>(обязательно)|string|Ключ правила LLD.| |**name**<br>(обязательно)|string|Имя правила LLD.| |**type**<br>(обязательно)|integer|Тип правила LLD.<br><br>Возможные значения:<br>0 - Zabbix агент;<br>2 - Zabbix trapper;<br>3 - простая проверка;<br>5 - Zabbix internal;<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|URL строка, обязательная для HTTP агент LLD. Поддерживает пользовательские макросы, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |allow\_traps|integer|Поле для HTTP агента LLD. Позволяет принимать значения как в типе элемента trapper.<br><br>0 - *(по умолчанию)* Не разрешать принимать входящие данные.<br>1 - Разрешить принимать входящие данные.| |authtype|integer|Используется только для SSH агента или HTTP агента LLD.<br><br>Возможные значения для SSH агента:<br>0 - *(по умолчанию)* пароль;<br>1 - открытый ключ.<br><br>Возможные значения для HTTP агента:<br>0 - *(по умолчанию)* нет;<br>1 - базовая аутентификация;<br>2 - NTLM| |description|string|Описание правила LLD.| |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 датчик. Используется только для IPMI правил LLD.| |jmx\_endpoint|string|Пользовательская строка подключения для JMX агента.<br><br>Значение по умолчанию:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |lifetime|string|Период времени, после которого элементы, больше не обнаруженные, будут удалены. Принимает секунды, единицу времени с суффиксом и пользовательский макрос.<br><br>По умолчанию: `30д`.| |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 и Telnet LLD;<br>- SQL-запрос для правил LLD мониторинга базы данных;<br>- формула для вычисляемых правил LLD.| |parameters|array|Дополнительные параметры для правил LLD типа скрипт. Массив объектов с уникальными свойствами 'name' и 'value'.| |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', где значение может быть пустой строкой.| |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|(только для чтения) ID родительского шаблона правила LLD.| |timeout|string|Тайм-аут запроса для получения данных элемента. Используется для HTTP агента и скриптовых правил LLD. Поддерживает пользовательские макросы.<br><br>по умолчанию: 3с<br>максимальное значение: 60с| |trapper\_hosts|string|Разрешенные узлы сети. Используется для trapper LLD и HTTP агента LLD.| |username|string|Имя пользователя для аутентификации. Используется для простой проверки, SSH, Telnet, мониторинга базы данных, JMX и HTTP агента LLD.<br><br>Обязательно для SSH и Telnet LLD.| |uuid|string|Универсальный уникальный идентификатор, используемый для связывания импортированных правил LLD с уже существующими. Используется только для правил LLD на шаблонах. Автоматически генерируется, если не указан.| |verify\_host|integer|Поле для HTTP агента LLD. Следует ли проверять, что имя узла для подключения совпадает с указанным в сертификате узла.<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 [Плагин](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) MongoDB более не является частью 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 [Плагин](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) MongoDB более не является частью Zabbix агента 2 и, вместо этого, доступен в виде загружаемого плагина. Список поддерживаемых версий MongoDB расширен до *2.6-5.3*. Функционал плагина и список поддерживаемых [элементов данных](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) не изменился. Плагин MongoDB вместе с другими загружаемыми плагинами, которые могут быть потенциально добавлены в будущем, хранятся в отдельном новом репозитории [zabbix-agent2-plugins](http://repo.zabbix.com/zabbix-agent2-plugins/). Пакет *zabbix-release* теперь добавляет этот репозиторий в пользовательскую систему. Чтобы продолжить мониторинг MongoDB при установке из официальных пакетов Zabbix, обновите пакет *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| |--|--|--|----| |[Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of Ember+.|ember.get|This plugin is supported since Zabbix 6.0.30. [Pre-compiled plugin binaries](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) for Windows are available since Zabbix 6.0.39 and are compatible with 6.0.30 version.<br><br>See also [Ember+ plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin#parameters).| |[MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|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, mongodb.version|This plugin is loadable since Zabbix 6.0.6 (built-in previously). [Pre-compiled plugin binaries](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) for Windows are available since Zabbix 6.0.19 and are compatible with previous 6.0 versions.<br><br>To configure encrypted connections to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) parameters.<br>Supported in plugin versions 1.2.0, 6.0.13 and newer^[1](#footnotes)^.<br>Currently, TLS parameters cannot be passed as item key parameters.<br><br>See also [MongoDB plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#parameters).| |[MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of MSSQL database.|mssql.availability.group.get, mssql.custom.query, mssql.db.get, mssql.job.status.get, mssql.last.backup.get, mssql.local.db.get, mssql.mirroring.get, mssql.nonlocal.db.get, mssql.perfcounter.get, mssql.ping, mssql.quorum.get, mssql.quorum.member.get, mssql.replica.get, mssql.version|This plugin is supported since Zabbix 6.0.27. [Pre-compiled plugin binaries](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) for Windows are available since Zabbix 6.0.28 and are compatible with 6.0.27 version.<br><br>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>See also [MSSQL plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin#parameters).| |[PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|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.version, pgsql.wal.stat |This plugin is loadable since Zabbix 6.0.10 (built-in previously). [Pre-compiled plugin binaries](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) for Windows are available since Zabbix 6.0.19 and are compatible with previous 6.0 versions.<br><br>To configure encrypted connections to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) or [default](#default-values) parameters.<br>Currently, TLS parameters cannot be passed as item key parameters.<br><br>See also [PostgreSQL plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#parameters).| See also: [Building loadable plugins](/manual/config/items/plugins/build). #### Подгружаемые ::: notetip Подгружаемые плагины, когда выполняются с:<br> - *--V --version* - печатают версию плагина и информацию о лицензии;<br> - *-h --help* - печатают справочную информацию. ::: Нажмите на имя плагина, чтобы перейти к репозиторию плагина с дополнительной информацией. |Имя плагина|Описание|Поддерживаемые ключи элементов данных|Комментарии| |--|--|--|----| |[Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse?at=refs%2Fheads%2Frelease%2F6.0)|Мониторинг Ember+.|ember.get|Данный плагин поддерживается, начиная с версии Zabbix 6.0.30. [Предварительно скомпилированные бинарные файлы плагина](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) для Windows доступны, начиная с версии Zabbix 6.0.39, и совместимы с версией 6.0.30.<br><br>Смотрите также [Параметры конфигурации плагина Ember+](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin#параметры).| |[MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Мониторинг серверов и кластеров MongoDB (документоориентированная, распределённая база данных).|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, mongodb.version|Данный плагин является подгружаемым, начиная с версии 6.0.6 (ранее был встроенным). [Предварительно скомпилированные бинарные файлы плагина](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) для Windows доступны, начиная с версии Zabbix 6.0.19, и совместимы с предыдущими версиями 6.0.<br><br>Для настройки шифрованного подключения к базе данных укажите параметры TLS в файле конфигурации агента как параметры [именованной сессии](#именованные-сессии).<br>Поддерживается в плагинах версий 1.2.1, 6.0.13 и новее^[1](#примечания)^.<br>В настоящее время параметры TLS нельзя передать в виде параметров ключа элемента данных.<br><br>Смотрите также: [конфигурационный файл плагина MongoDB](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#configuration-file).| |[MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0)|Мониторинг баз данных MSSQL.|mssql.availability.group.get, mssql.custom.query, mssql.db.get, mssql.job.status.get, mssql.last.backup.get, mssql.local.db.get, mssql.mirroring.get, mssql.nonlocal.db.get, mssql.perfcounter.get, mssql.ping, mssql.quorum.get, mssql.quorum.member.get, mssql.replica.get, mssql.version|Данный плагин поддерживается, начиная с версии 6.0.27. [Предварительно скомпилированные бинарные файлы плагина](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) для Windows доступны, начиная с версии Zabbix 6.0.28 и совместимы с версией 6.0.27.<br><br>Для настройки шифрованного подключения к базе данных укажите параметры TLS в файле конфигурации агента как параметры [именованной сессии](#именованные-сессии) или [по умолчанию](#значения-по-умолчанию).<br>В настоящее время параметры TLS нельзя передать в виде параметров ключа элемента данных.<br><br>Смотрите также: [параметры конфигурации плагина MSSQL](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin#параметры).| |[PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Мониторинг 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, <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.version, pgsql.wal.stat |Данный плагин является подгружаемым, начиная с версии 6.0.10 (ранее был встроенным). [Предварительно скомпилированные бинарные файлы плагина](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) для Windows доступны, начиная с версии Zabbix 6.0.19, и совместимы с предыдущими версиями 6.0.<br><br>Для настройки шифрованного подключения к базе данных укажите параметры TLS в файле конфигурации агента как параметры [именованной сессии](#именованные-сессии) или [по умолчанию](#значения-по-умолчанию).<br>В настоящее время параметры TLS нельзя передать в виде параметров ключа элемента данных.<br><br>Смотрите также: [параметры конфигурации плагина PostgreSQL](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#параметры).| Смотрите также: [Создание подгружаемых плагинов](/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 теперь поддерживает шифрование TLS при соединении с MongoDB с использованием именованных сессий. Обновлённый плагин (MongoDB plugin 1.2.1) включён в официальные пакеты Zabbix, начиная с версии Zabbix 6.0.14. Обратите внимание, что 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 Постоянный файл элементов данных обновляется после успешной отправки каждой партии данных \(содержащей данные по элементам данных\) на сервер. Например, по умолчанию «BufferSize» равен 100. Если элемент данных журнала нашёл 70 совпадающих записей, то первые 50 записей будут отправлены одной партией, постоянный файл будет обновлён, затем оставшиеся 20 записей будут отправлены второй партией \(возможно, с некоторой задержкой на буферизацию большего количества данных\), и затем постоянный файл будет снова обновлён. #### 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 data See additional information on [log monitoring](log_items). |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**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. | |**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><br><br>Matching lines are counted in the new lines since the last log check by the agent, and thus depend on the item update interval.<br>If the file is missing or permissions do not allow access, item turns unsupported. <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, with the file name specified using a regular [expression](/manual/regular_expressions). Note that the regular expression applies only to the file name and does not need to match the entire name (e.g., /path/to/agent will match zabbix\_agentd.log)<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>In the `file regexp` parameter, the log directory path and log file regular expression must be separated by the correct directory separator:<br> - on Windows, the separator must be a backslash (\\);<br> - on other systems, it must be a forward slash (/).<br>Forward slashes may be tolerated on Windows at other positions, except the one that separates the log directory path and the log file regular expression (see examples below).<br><br>Examples for Windows:<br>=> logrt["c:/dir1/dir2/dir3&#92;filename.\*\\.log","pattern_to_match"] → will collect data from log files in "c:/dir1/dir2/dir3" where the file name starts with "filename" and ends with any extension matching ".log"<br>=> logrt["//example.com/share/dir1/dir2/dir3\\filename.\*\\.log","pattern_to_match"] → will collect data from log files in the network share "//example.com/share/dir1/dir2/dir3" where the file name starts with "filename" and ends with any extension matching ".log".<br><br>Examples for other systems:<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. | |**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, with the file name specified using a regular [expression](/manual/regular_expressions). Note that the regular expression applies only to the file name and does not need to match the entire name (e.g., /path/to/agent will match zabbix\_agentd.log)<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><br>Matching lines are counted in the new lines since the last log check by the agent, and thus depend on the item update interval.<br><br>Log rotation is based on the last modification time of files. <br><br>This item is not supported for Windows Event Log.<br><br>Supported since Zabbix 3.2.0.<br>In the `file regexp` parameter, the log directory path and log file regular expression must be separated by the correct directory separator:<br> - on Windows, the separator must be a backslash (\\);<br> - on other systems, it must be a forward slash (/).<br>Forward slashes may be tolerated on Windows at other positions, except the one that separates the log directory path and the log file regular expression (see examples below):<br><br>Examples for Windows:<br>=> logrt.count["c:/dir1/dir2/dir3&#92;filename.\*\\.log","pattern_to_match"] → will count the number of matches for the pattern "pattern_to_match" in log files located in "c:/dir1/dir2/dir3"<br>=> logrt.count["//example.com/share/dir1/dir2/dir3\\filename.\*\\.log","pattern_to_match"] → will count the number of matches for the pattern "pattern_to_match" in log files on the network share "//example.com/share/dir1/dir2/dir3".<br><br>Examples for other systems:<br>=> logrt.count["/home/zabbix/logs/^logfile[0-9]{1,3}\$",,,100] → will count the number of matches for the pattern "^logfile[0-9]{1,3}\$" in log files in the "/home/zabbix/logs" directory<br>=> logrt.count["/home/user/^logfile_.*_[0-9]{1,3}\$","pattern_to_match","UTF-8",100] → will count the number of occurrences of the pattern "pattern_to_match" in log files located in "/home/user".| ##### Данные журналов Смотрите дополнительную информацию о [мониторинге журналов](log_items). |Ключ элемента данных|<|<|<| |--|--|------|------| |Описание|Возвращаемое значение|Параметры|Комментарии| |**log**\[файл,\<регулярное выражение\>,\<кодировка\>,\<макс. кол-во строк\>,\<режим\>,\<вывод\>,\<максзадержка\>,\<опции\>,\<постоянное\_хранилище\>\]|<|<|<| |Мониторинг файлов журналов (логов).|Журнал (лог)|**файл** — абсолютный путь и имя файла журнала<br>**регулярное выражение** — регулярное [выражение](/manual/regular_expressions#обзор), описывающее необходимый шаблон содержимого<br>**кодировка** — [идентификатор](/manual/config/items/itemtypes/zabbix_agent#доступные-кодировки) кодовой страницы<br>**макс. кол-во строк** — максимальное количество новых строк в секунду, которое агент будет отправлять Zabbix серверу или прокси. Этот параметр переопределяет значение «MaxLinesPerSecond» в [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**режим** (начиная с 2.0 версии) — возможные значения:<br>*all* (по умолчанию), *skip* — пропуск обработки старых данных (влияет только на недавно созданные элементы данных, которые ещё не получали никаких данных).<br>**вывод** (начиная с 2.2 версии) — опциональный шаблон форматирования вывода. **\\0** — управляющая последовательность заменяется найденной частью текста (начиная от первого символа совпадения, заканчивая символом, где совпадение заканчивается), тогда как **\\N** (где N=1...9) — управляющая последовательность заменяется N-ой совпадающей группой (или пустой строкой, если N превышает количество найденных групп).<br>**максзадержка** (начиная с версии 3.2) — максимальная задержка в секундах. Тип: число с плавающей точкой. Значения: 0 — (по умолчанию) никогда не игнорировать строки в файлах журналов; > 0.0 — игнорировать более старые строки с целью получения наиболее новых строк, проанализированных в течение «максзадержка» секунд. Перед использованием прочитайте заметки по [максзадержка](log_items#использование-параметра-максзадержка)!<br>**опции** (начиная с версии 4.4.7) — дополнительные опции:<br>*mtime-noreread* — не уникальные записи, перечитывать только, если размер файла изменяется (игнорировать изменение времени модификации). (Этот параметр устарел, начиная с 5.0.2, так как сейчас mtime игнорируется.)<br>**постоянное\_хранилище** (начиная с версий 5.0.18, 5.4.9, только в zabbix\_agentd на Unix системах; не поддерживается в Agent2) — абсолютный путь к директории, где хранить данные долговременного хранения. Смотрите также дополнительные заметки о [файлах долговременного хранения](log_items#примечания-к-постоянным-файлам-у-log-элементов-данных).|Элемент данных должен быть настроен как [активная проверка](/manual/appendix/items/activepassive#активные-проверки).<br>Если файл не существует или доступ к нему не разрешён, элемент данных перейдёт в неподдерживаемое состояние.<br><br>Если параметр `вывод` оставить пустым — будет возвращена вся строка, содержащая текст, соответствующий регулярному выражению. Обратите внимание, что все глобальные регулярные выражения, исключая «Результат ИСТИНА», всегда возвращают всю строку, соответствующую выражению, и параметр `вывод` игнорируется.<br><br>Извлечение содержимого согласно параметру `вывод` производится на стороне агента.<br><br>*Примеры*:<br>=> log\[/var/log/syslog\]<br>=> log\[/var/log/syslog,error\]<br>=> log\[/home/zabbix/logs/logfile,,,100\]<br><br>*Использование параметра `вывод` для извлечения числа из записи в журнале:*<br>=> log\[/app1/app.log,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\]→ будет соответствовать записи в журнале "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" и на сервер отправится только число «6080». Так как отправляется числовое значение, у этого элемента данных можно изменить «Тип информации» с «Журнал (лог)» на «Числовой (целое положительное)», и это значение можно будет использовать на графиках, в триггерах и т.п.<br><br>*Использование параметра `вывод` для изменения вывода записи журнала перед отправкой на сервер:*<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"\]→ будет соответствовать записи в журнале "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" и на сервер будет отправлена изменённая запись "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08".| |**log.count**\[файл,\<регулярное выражение\>,\<кодировка\>,\<макс. кол-во строк\>,\<режим\>,\<максзадержка\>,\<опции\>,\<постоянное\_хранилище\>\]|<|<|<| |Подсчёт количества совпадающих строк в наблюдаемом файле журнала (логе).|Целое число|**файл** — абсолютный путь и имя файла журнала<br>**регулярное выражение** — регулярное [выражение](/manual/regular_expressions#обзор), описывающее необходимый шаблон содержимого<br>**кодировка** — [идентификатор](/manual/config/items/itemtypes/zabbix_agent#доступные-кодировки) кодовой страницы<br>**макс. кол-во строк** — максимальное количество новых строк в секунду, которое агент будет анализировать (не может превышать 10000). Значением по умолчанию является 10\*«MaxLinesPerSecond» в [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**режим** — возможные значения:<br>*all* (по умолчанию), *skip* — пропуск обработки старых данных (влияет только на недавно созданные элементы данных).<br>**максзадержка** — максимальная задержка в секундах. Тип: число с плавающей точкой. Значения: 0 — (по умолчанию) никогда не игнорировать строки в файлах журналов; > 0.0 — игнорировать более старые строки с целью получения наиболее новых строк, проанализированных в течение «максзадержка» секунд. Перед использованием прочитайте заметки по [максзадержка](log_items#использование-параметра-максзадержка)!<br>**опции** (начиная с версии 4.4.7) — дополнительные опции:<br>*mtime-noreread* — не уникальные записи, перечитывать только, если размер файла изменяется (игнорировать изменения времени модификации). (Этот параметр устарел, начиная с 5.0.2, так как сейчас mtime игнорируется.)<br>**постоянное\_хранилище** (начиная с версий 5.0.18, 5.4.9, только в zabbix\_agentd на Unix системах; не поддерживается в Agent2) — абсолютный путь к директории, где хранить данные долговременного хранения. Смотрите также дополнительные заметки о [файлах долговременного хранения](log_items#примечания-к-постоянным-файлам-у-log-элементов-данных).|Элемент данных должен быть настроен как [активная проверка](/manual/appendix/items/activepassive#активные-проверки).<br><br><br>Количество совпадающих строк вычисляется за счет новых строк, начиная со времени последней проверки журнала агентом; таким образом, количество зависит от интервала обновления элемента данных.<br>Если файл не существует или доступ к нему не разрешён, элемент данных переходит в неподдерживаемое состояние.<br><br>Этот элемент данных не поддерживается для Журнала событий Windows.<br><br>Поддерживается, начиная с Zabbix 3.2.0.| |**logrt**\[регулярное\_выражение\_файла,\<регулярное выражение\>,\<кодировка\>,\<макс. кол-во строк\>,\<режим\>,\<вывод\>,\<максзадержка\>,\<опции\>,\<постоянное\_хранилище\>\]|<|<|<| |Мониторинг файлов журналов (логов) с поддержкой ротации файлов журналов.|Журнал (лог)|**регулярное\_выражение\_файла** — абсолютный путь к файлу и регулярное [выражение](/manual/regular_expressions#обзор), описывающее его имя. Обратите внимание, что регулярное выражение применяется только к имени файла, и не требуется, чтобы оно соответствовало полному пути (например, /path/to/agent будет соответствовать и файлу zabbix\_agentd.log)<br>**регулярное выражение** — регулярное [выражение](/manual/regular_expressions#обзор), описывающее необходимый шаблон содержимого<br>**кодировка** — [идентификатор](/manual/config/items/itemtypes/zabbix_agent#доступные-кодировки) кодовой страницы<br>**макс. кол-во строк** — максимальное количество новых строк в секунду, которое агент будет отправлять Zabbix серверу или прокси. Этот параметр переопределяет значение «MaxLinesPerSecond» в [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**режим** (начиная с 2.0 версии) — возможные значения:<br>*all* (по умолчанию), *skip* — пропуск обработки старых данных (влияет только на недавно созданные элементы данных, которые еще не получали никаких данных).<br>**вывод** (начиная с 2.2 версии) — опциональный шаблон форматирования вывода. **\\0** — управляющая последовательность заменяется найденной частью текста (начиная от первого символа совпадения, заканчивая символом, где совпадение заканчивается), тогда **\\N** (где N=1...9) — управляющая последовательность заменяется N-ой совпадающей группой (или пустой строкой, если N превышает количество найденных групп).<br>**максзадержка** (начиная с версии 3.2) — максимальная задержка в секундах. Тип: число с плавающей точкой. Значения: 0 — (по умолчанию) никогда не игнорировать строки в файлах журналов; > 0.0 — игнорировать более старые строки с целью получения наиболее новых строк, проанализированных в течение «максзадержка» секунд. Перед использованием прочитайте заметки по [максзадержка](log_items#использование-параметра-максзадержка)!<br>**опции** (начиная с версии 4.0; *mtime-reread*, *mtime-noreread* опции начиная с 4.4.7) — тип ротации файлов журналов и другие опции. Возможные значения:<br>*rotate* (по умолчанию),<br>*copytruncate* — обратите внимание, что *copytruncate* нельзя использовать вместе с *maxdelay*. В этом случае *maxdelay* должен быть равен 0 или не указан; смотрите [copytruncate](log_items#заметки-по-обработке-ротации-copytruncate-файлов-журналов) заметки,<br>*mtime-reread* — не уникальные записи, перечитывать, если время модификации или размер изменились (по умолчанию),<br>*mtime-noreread* — не уникальные записи, перечитывать только, если размер файла изменяется (игнорирование изменения времени модификации).<br>**постоянное\_хранилище** (начиная с версий 5.0.18, 5.4.9, только в zabbix\_agentd на Unix системах; не поддерживается в Agent2) — абсолютный путь к директории, где хранить данные долговременного хранения. Смотрите также дополнительные заметки о [файлах долговременного хранения](log_items#примечания-к-постоянным-файлам-у-log-элементов-данных).|Элемент данных должен быть настроен как [активная проверка](/manual/appendix/items/activepassive#активные-проверки).<br>Ротация журналов основывается на времени последней модификации файлов.<br><br>Обратите внимание, что logrt разработан для работы с одним активным файлом журнала, с несколькими другими совпадающими уже устаревшими неактивными файлами. Если, например, директория содержит множество активных файлов журналов, по каждому такому файлу необходимо создавать отдельный logrt элемент данных. В противном случае, если один logrt элемент данных подхватит слишком много файлов, это может привести к исчерпанию памяти и сбою в мониторинге.<br><br>Если параметр `вывод` оставить пустым — будет возвращена вся строка, содержащая соответствующий регулярному выражению текст. Обратите внимание, что все глобальные регулярные выражения, исключая «Результат ИСТИНА», всегда возвращают всю соответствующую выражению строку, и параметр `вывод` игнорируется.<br><br>Извлечение содержимого согласно параметру `вывод` производится на стороне агента.<br><br>В параметре `регулярное_выражение_файла` путь к директории файла журнала и регулярное выражение имени файла журнала должны быть разделены правильным разделителем:<br> - в Windows разделителем должна быть обратная косая черта (\\);<br> - в других системах это должна быть прямая косая черта (/).<br>В Windows прямая косая черта может допускаться в других позициях, за исключением той, которая разделяет путь к директории файла журнала и регулярное выражение имени файла журнала (смотрите примеры ниже).<br><br>Примеры для Windows:<br>=> logrt["c:/dir1/dir2/dir3&#92;filename.\*\\.log","pattern_to_match"] → будет собирать данные из файлов в директории «c:/dir1/dir2/dir3», где имя файла начинается с «filename» и оканчивается любым расширением, соответствующим строке «.log»<br>=> logrt["//example.com/share/dir1/dir2/dir3\\filename.\*\\.log","pattern_to_match"] → будет собирать данные из лог-файлов, расположенных на сетевом ресурсе «//example.com/share/dir1/dir2/dir3», где имя файла начинается с «filename» и оканчивается любым расширением, соответствующим строке «.log».<br><br>*Примеры для других систем*:<br>=> logrt\["/home/zabbix/logs/\^logfile\[0-9\]{1,3}$",,,100\] → совпадает с файлом наподобие «logfile1» (но не совпадает с «.logfile1»)<br>=> logrt\["/home/user/logfile\_.\*\_\[0-9\]{1,3}","pattern\_to\_match","UTF-8",100\] → будет собирать данные с файлов таких как «logfile\_abc\_1» или «logfile\_\_001».<br><br>*Использование параметра `вывод` для извлечения числа из записи в журнале:*<br>=> logrt\[/app1/\^test.\*log$,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\] → будет соответствовать записи в журнале «2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors», и на сервер отправится только число «6080». Так как отправляется числовое значение, у этого элемента данных можно изменить «Тип информации» с «Журнал (лог)» на «Числовой (целое положительное)», и это значение можно будет использовать на графиках, в триггерах и т.д.<br><br>*Использование параметра `вывод` для изменения вывода записи журнала перед отправкой на сервер:*<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"\]→ будет соответствовать записи в журнале «2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors», и на сервер отправится изменённая запись «2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08».| |**logrt.count**\[регулярное\_выражение\_файла ,\<регулярное выражение\>,\<кодировка\>,\<макс. кол-во строк\>,\<режим\>,\<максзадержка\>,\<опции\>,\<постоянное\_хранилище\>\]|<|<|<| |Подсчёт количества совпадающих строк в наблюдаемом файле журнала (логе) с поддержкой ротации файлов журналов.|Целое число|**регулярное\_выражение\_файла ** — абсолютный путь к файлу и регулярное [выражение](/manual/regular_expressions#обзор), описывающее его имя. Обратите внимание, что регулярное выражение применяется только к имени файла, и не требуется, чтобы оно соответствовало полному пути (например, /path/to/agent будет соответствовать и файлу zabbix\_agentd.log)<br>**регулярное выражение** — регулярное [выражение](/manual/regular_expressions#обзор), описывающее необходимый шаблон содержимого<br>**кодировка** — [идентификатор](/manual/config/items/itemtypes/zabbix_agent#доступные-кодировки) кодовой страницы<br>**макс. кол-во строк** — максимальное количество новых строк в секунду, которое агент будет анализировать (не может превышать 10000). Значением по умолчанию является 10\*«MaxLinesPerSecond» в [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**режим** — возможные значения:<br>*all* (по умолчанию), *skip* — пропуск обработки старых данных (влияет только на недавно созданные элементы данных).<br>**максзадержка** — максимальная задержка в секундах. Тип: число с плавающей точкой. Значения: 0 — (по умолчанию) никогда не игнорировать строки в файлах журналов; > 0.0 — игнорировать более старые строки с целью получения наиболее новых строк, проанализированных в течение «максзадержка» секунд. Перед использованием прочитайте заметки по [максзадержка](log_items#использование-параметра-максзадержка)!<br>**опции** (начиная с версии 4.0; *mtime-reread*, *mtime-noreread* опции начиная с 4.4.7) — тип ротации файлов журналов и другие опции. Возможные значения:<br>*rotate* (по умолчанию),<br>*copytruncate* — обратите внимание, что *copytruncate* нельзя использовать вместе с *maxdelay*. В этом случае *maxdelay* должен быть равен 0 или не указан; смотрите [copytruncate](log_items#заметки-по-обработке-ротации-copytruncate-файлов-журналов) заметки,<br>*mtime-reread* — не уникальные записи, перечитывать, если время модификации или размер изменились (по умолчанию),<br>*mtime-noreread* — не уникальные записи, перечитывать только, если размер файла изменяется (игнорирование изменения времени модификации).<br>**постоянное\_хранилище** (начиная с версий 5.0.18, 5.4.9, только в zabbix\_agentd на Unix системах; не поддерживается в Agent2) — абсолютный путь к директории, где хранить данные долговременного хранения. Смотрите также дополнительные заметки о [файлах долговременного хранения](log_items#примечания-к-постоянным-файлам-у-log-элементов-данных).|Элемент данных должен быть настроен как [активная проверка](/manual/appendix/items/activepassive#активные-проверки).<br><br>Количество совпадающих строк вычисляется за счёт новых строк, начиная со времени последней проверки журнала агентом; таким образом, количество зависит от интервала обновления элемента данных.<br><br>Ротация журналов основывается на времени последней модификации файлов.<br><br>Этот элемент данных не поддерживается для Журнала событий Windows.<br><br>Поддерживается, начиная с Zabbix 3.2.0.<br><br>В параметре `регулярное_выражение_файла` путь к директории файла журнала и регулярное выражение имени файла журнала должны быть разделены правильным разделителем:<br> - в Windows разделителем должна быть обратная косая черта (\\);<br> - в других системах это должна быть прямая косая черта (/).<br>В Windows прямая косая черта может допускаться в других позициях, за исключением той, которая разделяет путь к директории файла журнала и регулярное выражение имени файла журнала (смотрите примеры ниже).<br><br>Примеры для Windows:<br>=> logrt.count["c:/dir1/dir2/dir3&#92;filename.\*\\.log","pattern_to_match"] → подсчёт количества совпадений с шаблоном «pattern_to_match» в журнальных файлах, расположенных в папке «c:/dir1/dir2/dir3»<br>=> logrt.count["//example.com/share/dir1/dir2/dir3\\filename.\*\\.log","pattern_to_match"] → подсчёт количества совпадений с шаблоном «pattern_to_match» в журнальных файлах, расположенных на сетевом ресурсе «//example.com/share/dir1/dir2/dir3».<br><br>Примеры для других систем:<br>=> logrt.count["/home/zabbix/logs/^logfile[0-9]{1,3}\$",,,100] → подсчёт количества совпадений с шаблоном «^logfile[0-9]{1,3}\$» в журнальных файлах, расположенных в папке «/home/zabbix/logs»<br>=> logrt.count["/home/user/^logfile_.*_[0-9]{1,3}\$","pattern_to_match","UTF-8",100] → подсчёт того, сколько раз шаблон «pattern_to_match» встречается в журнальных файлах, расположенных в «/home/user».| #### 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; ``` ##### Журналирование Добавление записи «Log test» в журнал Zabbix сервера и получение при возврате «1» в качестве значения элемента данных: - Создайте элемент данных с типом «Скрипт».\ - В поле *Скрипт* введите следующий код: ```javascript 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. Запрос: ```json { "jsonrpc": "2.0", "method": "user.logout", "params": [], "id": 1, "auth": "16a46baf181ef9602e1687f3110abf8a" } ``` Ответ: ```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.| ### История журналов (логов) У объекта истории журналов (логов) есть следующие свойства. |Параметр|Тип(/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |id|string|ID записи истории.| |clock|timestamp|Время, когда было получено значение.| |itemid|string|ID соответствующего элемента данных.| |logeventid|integer|ID записи из журнала событий Windows.| |ns|integer|Наносекунды, когда было получено значение.| |severity|integer|Уровень записи из журнала событий Windows.| |source|string|Источник записи из журнала событий Windows.| |timestamp|timestamp|Время записи из журнала событий Windows.| |value|text|Полученное значение.| #### 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 Мы рекомендуем [создать](/manual/installation/install#создайте-аккаунт-пользователя) пользователя *zabbix* как системного, то есть, без возможности входа в систему. Некоторые пользователи игнорируют эту рекомендацию и используют ту же самую учётную запись для входа в систему (например, используя SSH) на хост с работающим Zabbix. Это может привести к аварийному останову демона 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 Это происходит из-за того, что по умолчанию настройка systemd в файле `/etc/systemd/logind.conf` равна `RemoveIPC=yes`. Когда вы выполняете выход из системы, ранее созданные компонентами Zabbix семафоры удаляются, что приводит к сбою. Выдержка из документации по systemd: 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". Имеется 2 способа решения этой проблемы: 1. (рекомендуемый) Перестаньте использовать аккаунт *zabbix* для чего-либо кроме процессов Zabbix, выделите отдельную учётную запись для остальных потребностей. 2. (не рекомендуемый) Задайте `RemoveIPC=no` в `/etc/systemd/logind.conf` и перезагрузите систему. Обратите внимание, что 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** для входа под [Супер-администратором](/manual/config/users_and_usergroups/permissions) Zabbix. Будет предоставлен доступ к меню *Настройка* и *Администрирование*. В целях безопасности настоятельно рекомендуется изменить пароль по умолчанию для учётной записи администратора сразу после первого входа. #### 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} ### Цели для управления уровнем журналирования *тип-процесса*\ Все процессы указанного типа (active checks, collector, listener) *тип-процесса,N*\ Тип и номер процесса (например, «listener,3») *pid*\ Идентификатор процесса, до 65535. Для больших значений укажите цель как «тип-процесса,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} ### Цели управления уровнем журналирования *тип-процесса* Все процессы указанного типа (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) *тип-процесса,N* Тип и номер процесса (например, «poller,3») *pid* Идентификатор процесса, до 65535. Для больших значений укажите цель как «тип-процесса,N» Опции управления уровнем профилирования *тип-процесса* Все процессы указанного типа (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) *тип-процесса,N* Тип и номер процесса (например, «history syncer,1») *pid* Идентификатор процесса, до 65535. Для больших значений укажите цель как «тип-процесса,N» *область* Вместе с типом процесса и номером можно указать область профилирования (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} ### Цели для управления уровнем журналирования *тип-процесса* Все процессы указанного типа (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) *тип-процесса,N* Тип и номер процесса (например, «poller,3») *pid* Идентификатор процесса, до 65535. Для больших значений укажите цель как «тип-процесса,N» Цели управления уровнем профилирования *тип-процесса* Все процессы указанного типа (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) *тип-процесса,N* Тип и номер процесса (например, «history syncer,1») *pid* Идентификатор процесса, до 65535. Для больших значений укажите цель как «тип-процесса,N» *область* Вместе с типом процесса можно указать область профилирования (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"} ###### Запрос журналирования Запрос отсылается плагином, чтобы записать журнальное сообщение в журнальный файл агента. | | | |---|---| |направление|плагин → агент| |ответ|нет| Параметры, специфичные для запросов журналирования: |Имя|Тип|Комментарии| |---------|--------|----------| |severity|uint32|Важность сообщения (уровень журналирования).| |message|string|Сообщение для журнала.| *Пример:* {"id":0,"type":1,"severity":3,"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. #### Logrotate для Zabbix сервера и прокси Утилита logrotate включена только в пакеты zabbix-agent, zabbix-agent2 и zabbix-web-service, но требует отдельной установки для Zabbix сервера и прокси. Необходимые для logrotate зависимости были добавлены в пакеты сервера и прокси для RHEL и SUSE, начиная с версии Zabbix 6.4.4rc1. ##### Log rotation Zabbix does not provide any log rotation system - that should be handled by the user. The log rotation should first rename the old file and only later delete it so that no traps are lost: 1. Zabbix opens the trap file at the last known location and goes to step 3 2. Zabbix checks if the currently opened file has been rotated by comparing the inode number to the defined trap file's inode number. If there is no opened file, Zabbix resets the last location and goes to step 1. 3. Zabbix reads the data from the currently opened file and sets the new location. 4. The new data are parsed. If this was the rotated file, the file is closed and goes back to step 2. 5. If there was no new data, Zabbix sleeps for 1 second and goes back to step 2. ##### Ротация журнала Zabbix не предоставляет какую-либо систему ротации журналов — это должно быть обеспечено пользователем. При ротации журнала старый файл должен быть сначала переименован и только после этого удалён, чтобы никакие трапы не пропали: 1. Zabbix открывает файл с трапами с последней известной позиции и переходит к 3 шагу. 2. Zabbix проверяет, была ли выполнена ротация открытого в данный момент файла, сравнивая номера inode с заданным у файла трапов номером inode. Если открытого файла нет, Zabbix сбрасывает последнюю позицию и переходит к 1 шагу. 3. Zabbix читает данные из открытого в данный момент файла и устанавливает новую позицию. 4. Обрабатываются новые данные. Если этот файл был ротирован, то он закрывается и Zabbix переходит назад ко 2 шагу. 5. Если не было новых данных, Zabbix засыпает на 1 секунду и возвращается ко 2 шагу. #### 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#настройка-низкоуровневого-обнаружения) пользовательские макросы могут использоваться в следующих полях: |Место|<|Несколько макросов/вперемешку с текстом^[1](supported_by_location_user#примечания)^| |-|------------------------------|----------| |Параметры ключа|<|да| |Интервал обновления|<|нет| |Пользовательские интервалы|<|нет| |Период сохранения потерянных ресурсов|<|нет| |Описание|<|да| |*SNMP агент*|<|<| | |SNMP OID|да| |*SSH агент*|<|<| | |Имя пользователя|да| |^|Файл публичного ключа|да| |^|Файл приватного ключа|да| |^|Пароль|да| |^|Выполняемый скрипт|да| |*TELNET агент*|<|<| | |Имя пользователя|да| |^|Пароль|да| |^|Выполняемый скрипт|да| |*Zabbix траппер*|<|<| | |Разрешённые хосты|да| |*Монитор баз данных*|<|<| | |Имя пользователя|да| |^|Пароль|да| |^|SQL запрос|да| |*JMX агент*|<|<| | |JMX endpoint|да| |*HTTP агент*|<|<| | |URL^[3](supported_by_location_user#примечания)^|да| |^|Поля запроса|да| |^|Время ожидания|нет| |^|Тело запроса|да| |^|Заголовки (имена и значения)|да| |^|Требуемые коды состояния|да| |^|Имя пользователя для HTTP аутентификации|да| |^|Пароль для HTTP аутентификации|да| |*Фильтры*|<|<| | |Регулярное выражение|да| |*Замещения*|<|<| | |Фильтры: регулярное выражение|да| |^|Операции: интервал обновления (для прототипов элементов данных)|нет| |^|Операции: период хранения истории (для прототипов элементов данных)|нет| |^|Операции: период хранения динамики изменений (для прототипов элементов данных)|нет| #### 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, эти макросы могут быть определены пользователем в дополнительном шаге с использованием функциональности [настраиваемых LLD макросов](/manual/discovery/low_level_discovery#настраиваемые-макросы) с JSONPath, которые будут указывать на обнаруженные значения в полученном JSON. Эти макросы можно затем использовать для создания прототипов элементов данных, триггеров, графиков и т.п. #### 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#поддерживаемые-функции-макросов) `fmtnum` теперь ограничен: 0-20. ## Macros ## Макросы #### Macros #### Макросы ## Macros ## Макросы ### Macros for expression debugging New macros are now supported to 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. For more details, see [Supported macros](/manual/appendix/macros/supported_by_location). ### Макросы для отладки выражений Теперь для упрощения отладки выражений триггеров поддерживаются новые макросы: - {TRIGGER.EXPRESSION.EXPLAIN}, {TRIGGER.EXPRESSION.RECOVERY.EXPLAIN} - раскрывается в частично раскрытый триггер или выражение восстановления, где применяются только те функции, которые имеют в своём основании элементы данных; - {FUNCTION.VALUE<1-9>}, {FUNCTION.RECOVERY.VALUE<1-9>} - результатом раскрытия является N-ая функция, которая имеет в своём основании элемент данных, на момент возникновения события. Для получения более подробных сведений смотрите [Поддерживаемые макросы](/manual/appendix/macros/supported_by_location). 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). ### Macros in user-defined global scripts To enhance security, it is recommended to use [macro functions](/manual/config/macros/macro_functions) instead of plain macros in user-defined global [scripts](/manual/web_interface/frontend_sections/administration/scripts), as macros are not automatically escaped. ### Макросы в определяемых пользователем глобальных скриптах Для повышения безопасности рекомендуется в определяемых пользователем глобальных [скриптах](/manual/web_interface/frontend_sections/administration/scripts) использовать [функции макросов](/manual/config/macros/macro_functions) вместо обычных макросов, поскольку макросы не экранируются автоматически. #### Macros This section allows to define system-wide [user macros](/manual/config/macros/user_macros) as name-value pairs. Note that macro values can be kept as plain text, secret text or Vault secret. Adding a description is also supported. {width="600"} #### Макросы Эта страница позволяет определить общесистемные [пользовательские макросы](/manual/config/macros/user_macros) в виде пар имя-значение. Обратите внимание, что значения макросов могут храниться в виде обычного текста, секретного текста либо секрета Хранилища. Также поддерживается добавление описания. {width="600"} #### Macro support Built-in and user macros in tags are resolved at the time of the event. Until the event has occurred these macros will be shown in Zabbix frontend unresolved. Low-level discovery macros are resolved during discovery process. 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 macros with context are supported for the tag name/value; 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 #### Поддержка макросов Встроенные и пользовательские макросы в тегах раскрываются во время события. До наступления события эти макросы отображаются в веб-интерфейсе Zabbix нераскрытыми. Макросы низкоуровневого обнаружения (LLD) раскрываются во время процесса обнаружения. В тегах триггеров можно использовать следующие макросы: - макросы {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} и {HOST.ID} можно использовать для заполнения имени тега или значения тега. - [Макросы](/manual/appendix/macros/supported_by_location) {INVENTORY.\*} можно использовать в качестве ссылки на значения инвентарных данных с одного или нескольких узлов сети в выражении триггера. - [Пользовательские макросы](/manual/config/macros/user_macros) и пользовательские макросы с контекстом поддерживаются в именах тегов/значениях. Контекст пользовательских макросов может включать макросы низкоуровневого обнаружения. - В прототипах триггеров можно использовать макросы низкоуровневого обнаружения в именах и значениях тегов. В оповещениях на триггеры можно использовать следующие макросы: - макросы {EVENT.TAGS} и {EVENT.RECOVERY.TAGS} раскрываются в разделённый запятой список тегов событий или тегов событий о восстановлении - макросы {EVENT.TAGSJSON} и {EVENT.RECOVERY.TAGSJSON} раскрываются в JSON массив, содержащий [объекты](/manual/api/reference/event/object#тег-события) тегов событий или объекты тегов событий о восстановлении В тегах к шаблонам, узлам сети, элементам данных и веб-сценариям можно использовать следующие макросы: - Макросы {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} и {HOST.ID} - [Макросы](/manual/appendix/macros/supported_by_location) {INVENTORY.\*} - [Пользовательские макросы](/manual/config/macros/user_macros) - Макросы низкоуровневого обнаружения можно использовать в тегах к прототипам элементов данных В тегах к прототипам узлов сети можно использовать следующие макросы: - Макросы {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} и {HOST.ID} - [Макросы](/manual/appendix/macros/supported_by_location) {INVENTORY.\*} - [Пользовательские макросы](/manual/config/macros/user_macros) - [Макросы низкоуровневого обнаружения](/manual/config/macros/lld_macros) будут раскрыты в процессе обнаружения и затем будут добавлены к обнаруженному узлу сети #### 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). #### Поддержка макросов для типов оповещений email При настройке [типа оповещений email](/manual/config/notifications/media/email), теперь [в полях имени пользователя и пароля](/manual/appendix/macros/supported_by_location_user#другие-места) можно использовать макросы. # maintenance.create # maintenance.create # maintenance.delete # maintenance.delete # maintenance.get # maintenance.get ##### Maintenance periods The maintenance period window is for scheduling time for a recurring or a one-time maintenance. The form is dynamic with available fields changing based on the *Period type* selected.  |Period type|Description| |--|--------| |*One time only*|Define the date and time, and the length of the maintenance period.| |*Daily*|*Every day(s)* - maintenance frequency: 1 (default) - every day, 2 - every two days, etc.<br>*At (hour:minute)* - time of the day when maintenance starts.<br>*Maintenance period length* - for how long the maintenance will be active.| |*Weekly*|*Every week(s)* - maintenance frequency: 1 (default) - every week, 2 - every two weeks, etc.<br>*Day of week* - on which day the maintenance should take place.<br>*At (hour:minute)* - time of the day when maintenance starts.<br>*Maintenance period length* - for how long the maintenance will be active.| |*Monthly*|*Month* - select all months during which the regular maintenance is carried out.<br>*Date*: **Day of month** - Select this option if the maintenance takes place on the same date each month (for example, every 1st day of the month). Then, select the required day in the new field that appears.<br>*Date*: **Day of week** - Select this option if the maintenance takes place only on certain days (for example, every first Monday of the month). Then, in the drop-down select the required week of the month (first, second, third, fourth, or last) and mark the checkboxes for maintenance day(s).<br>*At (hour:minute)* - time of the day when maintenance starts.<br>*Maintenance period length* - for how long the maintenance will be active.| When done, press *Add* to add the maintenance period to the *Periods* block. Notes: - When *Every day/Every week* parameter is greater than 1, the starting day or week is the day/week that the *Active since* time falls on. For example: - with *Active since* set to January 1 at 12:00 and a one-hour maintenance set for every two days at 23:00 will result in the first maintenance period starting on January 1 at 23:00, while the second maintenance period will start on January 3 at 23:00; - with the same *Active since* time and a one-hour maintenance set for every two days at 01:00, the first maintenance period will start on January 3 at 01:00, while the second maintenance period will start on January 5 at 01:00. - Daylight Saving Time (**DST**) changes do not affect how long the maintenance will be. - Let's say we have a two-hour maintenance that usually starts at 01:00 and finishes at 03:00: - If after one hour of maintenance (at 02:00) a DST change happens and current time changes from 02:00 to 03:00, the maintenance will continue for one more hour till 04:00; - If after two hours of maintenance (at 03:00) a DST change happens and current time changes from 03:00 to 02:00, the maintenance will stop because two hours have passed. - If a maintenance period is set to 1 day it usually starts at 00:00 and finishes at 00:00 the next day: - Since Zabbix calculates days in hours, the actual period of the maintenance is 24 hours. - If current time changes forward one hour, the maintenance will stop at 01:00 the next day. - If current time changes back one hour, the maintenance will stop at 23:00 that day. - If a maintenance period starts during the hour, skipped by DST change: - The maintenance will not start. ##### Периоды обслуживания Диалог периода обслуживания предназначен для планирования времени периодического или однократного обслуживания. Доступные поля диалога меняются динамически на основе выбранного *Тип периода*.  |Тип периода|Описание| |--|--------| |*Единовременно*<br>*(One time only)*|Конкретные дата и время, а также длительность периода обслуживания.| |*Ежедневно*<br>*(Daily)*|*Каждый день(и) (Every day(s))* — частота обслуживания: 1 (по умолчанию) — каждый день, 2 — каждые два дня и т.д.<br>*В (час:минута) (At (hour:minute))* — время суток начала обслуживания.<br>*Длительность периода обслуживания (Maintenance period length)* — как долго обслуживание будет активно.| |*Еженедельно*<br>*(Weekly)*|*Каждую неделю(и) (Every week(s))* — частота обслуживания: 1 (по умолчанию) — каждую неделю, 2 — каждую вторую неделю и т.д.<br>*День недели (Day of week)* — в какой день недели обслуживание должно выполняться.<br>*В (час:минута) (At (hour:minute))* — время суток начала обслуживания.<br>*Длительность периода обслуживания (Maintenance period length)* — как долго обслуживание будет активно.| |*Ежемесячно*<br>*(Monthly)*|*Месяц (Month)* — выберите все месяцы, в течение которых будет выполняться регулярное обслуживание.<br>*Дата (Date)*: **День месяца (Day of month)** — выберите эту опцию, если обслуживание проводится в одно и то же число месяца (например, каждый 1-й день месяца). Затем, выберите требуемое число в появившемся новом поле.<br>*Дата (Date)*: **День недели (Day of week)** — выберите эту опцию, если обслуживание проводится только в определенные дни недели (например, каждый первый понедельник месяца). Затем, в выпадающем списке выберите требуемую неделю месяца (первая, вторая, третья, четвертая или последняя) и отметьте дни недели обслуживания.<br>*В (час:минута) (At (hour:minute))* — время суток начала обслуживания.<br>*Длительность периода обслуживания (Maintenance period length)* — как долго обслуживание будет активно.| Когда завершите, нажмите на *Добавить (Add)* для добавления периода обслуживания в блок *Периоды (Periods)*. Примечания: - Когда значение параметра *Каждый день/Каждую неделю* больше 1, день или неделя начала - это день/неделя, на которые выпадает момент *Активно с*. Например: - когда параметр *Активно с* задан значением 1 января в 12:00 и обслуживание на один час задано на каждый второй день с 23:00, это приведёт к первому периоду обслуживания на 1 января в 23:00, тогда как второй период обслуживания начнётся 3 января в 23:00; - с таким же временем *Активно с* и обслуживанием на один час с периодом каждые два дня в 01:00, первый период обслуживания начнётся 3 января в 01:00, тогда как второй период обслуживания начнется 5 января в 01:00. - Перемена летнего времени (**DST**) не влияет на продолжительность обслуживания. - Допустим, у нас есть двухчасовое обслуживание, которое обычно начинается в 01:00 и заканчивается в 03:00: - Если после одного часа обслуживания (в 02:00) происходит переход на летнее время и текущее время меняется с 02:00 на 03:00, обслуживание продлится ещё один час до 04:00; - Если после двух часов обслуживания (в 03:00) происходит переход на зимнее время и текущее время меняется с 03:00 на 02:00, обслуживание остановится, так как два часа прошли. - Если период обслуживания задан 1 днём и обычно начинается в 00:00 и заканчивается к 00:00 следующего дня: - Так как Zabbix вычисляет дни в часах, фактический период обслуживания — 24 часа. - Если текущее время меняется на один час вперёд, тогда обслуживание остановится в 01:00 следующего дня. - Если текущее время меняется на один час назад, тогда обслуживание остановится в 23:00 этого же дня. - Если обслуживание начинается в течение часа, пропущенного в связи с переходом на летнее время: - Обслуживание не начнётся. # 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 its self-tests.| ### Цели Makefile Поставляемые Zabbix подгружаемые плагины имеют простые файлы makefile со следующими целями (targets): |Цель|Описание| |--|--------| |make|Собрать плагин.| |make clean|Удалить все файлы, которые обычно создаются при построении плагина.| |make check|Выполнить автотесты. Требуется реальная база данных PostgreSQL.| |make style|Проверить стиль кодирования Go при помощи утилиты 'golangci-lint'.| |make format|Отформатировать код Go при помощи вызова 'go fmt'.| |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#управление_работой): - `ha_status` — вывод состояния HA кластера в журнал Zabbix сервера (и в стандартный вывод); - `ha_remove_node=цель` — удаление HA ноды заданной своим <цель> — именем или идентификатором ноды (имя/идентификатор можно получить из вывода при выполнении ha\_status), например: ``` zabbix_server -R ha_remove_node=zabbix-node-02 ``` Обратите внимание, что активные / резервные ноды нельзя удалить. - `ha_set_failover_delay=задержка` — установка задержки аварийного переключения HA (от 10 секунд до 15 минут; поддерживаются суффиксы времени, такие как 10s, 1m) Состояние нод можно отслеживать: - в *Отчеты* → *[Информация о системе](/manual/web_interface/frontend_sections/reports/status_of_zabbix#ноды-кластера-высокой-доступности)*; - в виджете панели *Информация о системе*; - используя опцию управления работой `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 с командной строки вы также должны учитывать синтаксис командной оболочки. Например, если какой-то параметр ключа должен быть заключён в двойные кавычки, вам придется явно экранировать эти двойные кавычки, в противном случае они будут обрезаны командной оболочкой как специальные символы и не будут переданы Zabbix утилите. Примеры: zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]' zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0] ##### Mandatory interface The only mandatory function is **zbx\_module\_api\_version()**: ``` {.c} int zbx_module_api_version(void); ``` This function should return the API version implemented by this module and in order for the module to be loaded this version must match module API version supported by Zabbix. Version of module API supported by Zabbix is ZBX\_MODULE\_API\_VERSION. So this function should return this constant. Old constant ZBX\_MODULE\_API\_VERSION\_ONE used for this purpose is now defined to equal ZBX\_MODULE\_API\_VERSION to preserve source compatibility, but it's usage is not recommended. ##### Обязательный интерфейс Единственная обязательная функция — **zbx\_module\_api\_version()**: ``` {.c} int zbx_module_api_version(void); ``` Эта функция должна возвращать версию API, реализованную в модуле, и, чтобы модуль загрузился, версия должна совпадать с версией модулей API, поддерживаемой Zabbix. Версией модулей API, поддерживаемой Zabbix, является ZBX\_MODULE\_API\_VERSION. Таким образом, эта функция должна возвращать эту константу. Прежняя константа ZBX\_MODULE\_API\_VERSION\_ONE, которая ранее использовалась для этих целей, теперь определена равной ZBX\_MODULE\_API\_VERSION для сохранения совместимости исходного кода, но её использование не рекомендуется. ##### 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. ##### Подготовка манифеста Ожидается, что каждый модуль будет иметь файл manifest.json со следующими полями в формате JSON: |Параметр|Обязательный|Тип|По умолчанию|Описание| |---------|---|----|--|-------------------| |manifest\_version|Да|Double|\-|Манифестная версия модуля. В настоящее время поддерживается версия **1**.| |id|Да|String|\-|Идентификатор модуля (Module ID). Только один модуль с данным ID может быть активирован одновременно.| |name|Да|String|\-|Название модуля как отображается в разделе «Администрирование».| |version|Да|String|\-|Версия модуля как отображается в разделе «Администрирование».| |namespace|Да|String|\-|Пространство имен PHP для Module.php и классов действий.| |author|Нет|String|""|Автор модуля как отображается в разделе «Администрирование».| |url|Нет|String|""|URL модуля как отображается в разделе «Администрирование».| |description|Нет|String|""|Описание модуля как отображается в разделе «Администрирование».| |actions|Нет|Object|{}|Действия для регистрации с этим модулем. Смотрите «Действия».| |config|Нет|Object|{}|Конфигурация модуля.| Для справки см. пример файла `manifest.json` в разделе [Справочные материалы](#справочные-материалы) section. ##### 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 и он начинается с «http» или «https», в разделе *Инвентаризация* это отобразится в виде ссылки. # map.create # map.create # map.delete # map.delete # map.get # map.get #### 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"} Отображаемые данные: |Столбец|Описание| |--|--------| |*Имя (Name)*|Имя карты сети. Нажмите на имя карты, чтобы [увидеть](/manual/web_interface/frontend_sections/monitoring/maps#просмотр-карт-сети) карту сети.| |*Ширина (Width)*|Ширина карты сети.| |*Высота (Height)*|Высота карты сети.| |*Действия*<br>*(Actions)*|Доступны два действия:<br>**Свойства (Properties)** — изменение общих [свойств](/manual/config/visualization/maps/map#создание-карты-сети) карты <br>**Конструктор (Constructor)** — доступ к сетке для добавления [элементов карты сети](/manual/config/visualization/maps/map#добавление-элементов)| Чтобы [настроить](/manual/config/visualization/maps/map#создание-карты-сети) новую карту сети, нажмите на кнопку *Создать карту сети (Create map)* в верхнем правом углу. Чтобы импортировать карту сети из файла YAML, XML или JSON, нажмите на кнопку *Импорт (Import)* в верхнем правом углу. Пользователь, который импортирует карту сети, будет назначен её владельцем. Две кнопки под списком предлагают некоторые опции массового редактирования: - *Экспорт* — экспорт карт сети в файл 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 макросы (LLD macros)» и настроить следующие сопоставления: {#VOLUME}=$.labels['volume'] {#METRIC}=$['name'] {#HELP}=$['help'] # map.update # map.update ### 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MariaDB теперь 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MariaDB теперь 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MariaDB теперь 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MariaDB теперь 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MariaDB теперь 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MariaDB теперь 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MariaDB теперь 12.0.X. #### MariaDB 12.2 support The maximum [supported version](/manual/installation/requirements#required-software) for MariaDB is now 12.2.X. #### Поддержка MariaDB 12.2 Максимально [поддерживаемая версия](/manual/installation/requirements#требуемое-программное-обеспечение) для MariaDB теперь 12.2.X. #### MariaDB/MySQL 8.0+ without mysqlsh This upgrade method takes more time and should be used only if an upgrade with *mysqlsh* is not possible. ##### Table upgrade * Log in to MySQL console as root (recommended) or any user with FILE privileges. * If performing migration with a running Zabbix server, start MySQL with the [local_infile](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_local_infile) variable enabled. * Rename old tables and create new tables by running `history_pk_prepare.sql`: ``` {.bash} mysql -uzabbix -p<password> zabbix < /usr/share/zabbix-sql-scripts/mysql/history_pk_prepare.sql ``` ##### Migration with stopped server *max_execution_time* must be disabled before migrating data to avoid timeout during migration. ``` {.sql} SET @@max_execution_time=0; INSERT IGNORE INTO history SELECT * FROM history_old; INSERT IGNORE INTO history_uint SELECT * FROM history_uint_old; INSERT IGNORE INTO history_str SELECT * FROM history_str_old; INSERT IGNORE INTO history_log SELECT * FROM history_log_old; INSERT IGNORE INTO history_text SELECT * FROM history_text_old; ``` Follow [post-migration instructions](#post-migration) to drop the old tables. ##### Migration with running server Check for which paths import/export is enabled: ``` {.sql} mysql> SELECT @@secure_file_priv; +-----------------------+ | @@secure_file_priv | +-----------------------+ | /var/lib/mysql-files/ | +-----------------------+ ``` If *secure_file_priv* value is a path to a directory, export/import will be performed for files in that directory. In this case, edit paths to files in queries accordingly or set the *secure_file_priv* value to an empty string for the upgrade time. If *secure_file_priv* value is empty, export/import can be performed from any location. If *secure_file_priv* value is NULL, set it to the path that contains exported table data ('/var/lib/mysql-files/' in the example above). For more information, see [MySQL documentation](https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_secure_file_priv). *max_execution_time* must be disabled before exporting data to avoid timeout during export. ``` {.sql} 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'; ``` Follow [post-migration instructions](#post-migration) to drop the old tables. #### MariaDB/MySQL 8.0+ без mysqlsh Этот метод обновления занимает больше времени и должен использоваться, только если обновление с *mysqlsh* невозможно. ##### Обновление таблиц * Подключитесь к консоли MySQL как root (рекомендуемый вариант) или любой пользователь с привилегиями FILE. * Если миграция выполняется при работающем Zabbix сервере, запустите MySQL с активированной переменной [local_infile](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_local_infile). * Переименуйте старые таблицы и создайте новые таблицы путём выполнения `history_pk_prepare.sql`: ``` {.bash} mysql -uzabbix -p<пароль> zabbix < /usr/share/zabbix-sql-scripts/mysql/history_pk_prepare.sql ``` ##### Миграция с остановленным сервером Параметр *max_execution_time* должен быть отключён перед миграцией данных во избежание тайм-аута во время миграции. ``` {.sql} SET @@max_execution_time=0; INSERT IGNORE INTO history SELECT * FROM history_old; INSERT IGNORE INTO history_uint SELECT * FROM history_uint_old; INSERT IGNORE INTO history_str SELECT * FROM history_str_old; INSERT IGNORE INTO history_log SELECT * FROM history_log_old; INSERT IGNORE INTO history_text SELECT * FROM history_text_old; ``` Следуйте [инструкциям по пост-миграции](#пост-миграция), чтобы удалить старые таблицы. ##### Миграция при работающем сервере Проверьте, для каких путей разрешены импорт/экспорт: ``` {.sql} mysql> SELECT @@secure_file_priv; +-----------------------+ | @@secure_file_priv | +-----------------------+ | /var/lib/mysql-files/ | +-----------------------+ ``` Если значение *secure_file_priv* является путём к папке, экспорт/импорт будут выполняться для файлов в этой папке. В этом случае, отредактируйте пути к файлам в запросах соответственно либо на время обновления выставьте значение *secure_file_priv* в пустую строку. Если значение *secure_file_priv* пустое, экспорт/импорт могут выполняться из любого места. Если значением *secure_file_priv* является NULL, выставьте его в путь, который содержит данные заэкспортированных таблиц ('/var/lib/mysql-files/' в примере выше). Для более подробной информации, смотрите [документацию MySQL \[en\]](https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_secure_file_priv). Параметр *max_execution_time* должен быть отключён перед экспортом данных во избежание тайм-аута во время экспорта. ``` {.sql} 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'; ``` Следуйте [инструкциям по пост-миграции](#пост-миграция), чтобы удалить старые таблицы. ##### 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*. ##### Опции массового редактирования Кнопки ниже списка предлагают некоторые опции массового редактирования: - *Удалить* — удалить скрипты Для использования этой опции отметьте флажки перед соответствующими скриптами и нажмите на кнопку *Удалить*. ##### 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 item status to *Enabled* - *Disable* - change item status to *Disabled* - *Execute now* - execute a check for new item values immediately. Supported for **passive** checks only (see [more details](/manual/config/items/check_now)). Note that when checking for values immediately, configuration cache is not updated, thus the values will not reflect very recent changes to item configuration. - *Clear history and trends* - delete history and trend data for items. - *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/check_now)). Обратите внимание, что когда выполняется немедленная проверка значений, кэш конфигурации не обновляется, поэтому значения не будут отражать совсем недавние изменения настроек элементов данных. - *Очистить историю и динамику изменений* — удалить данные истории и динамики изменений для элементов данных - *Копировать* — скопировать элемент данных в другие узлы сети или шаблоны - *Массовое обновление* — [обновление нескольких свойств](/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 low-level discovery rule status to *Enabled*. - *Disable* - change the low-level discovery rule status to *Disabled*. - *Execute now* - perform discovery based on the discovery rules immediately. See [more details](/manual/config/items/check_now). Note that when performing discovery immediately, the configuration cache is not updated, thus the result will not reflect very recent changes to discovery rule configuration. - *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. ##### Опции массового редактирования Кнопки ниже списка предлагают некоторые опции массового редактирования: - *Активировать* — изменить состояние правила низкоуровневого обнаружения на *Активировано*. - *Отключить* — изменить состояние правила низкоуровневого обнаружения на *Деактивировано*. - *Выполнить сейчас* — немедленно выполнить обнаружение на основе правил обнаружения. Смотрите [более подробную информацию](/manual/config/items/check_now). Обратите внимание, что при выполнении немедленного обнаружения кэш конфигурации не обновляется, поэтому на результат не повлияют совсем недавние изменения конфигурации правила обнаружения. - *Удалить* — удалить правила низкоуровневого обнаружения. Для использования этих опций отметьте флажки перед соответствующими правилами обнаружения, затем нажмите на требуемую кнопку. ##### 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. ##### Опции массового редактирования Кнопки ниже списка предлагают некоторые опции массового редактирования: - *Активировать (Enable)* — изменить состояние способов оповещения на *Активировано* - *Отключить (Disable)* — изменить состояние способов оповещения на *Деактивировано* - *Экспорт (Export)* — экспортировать способы оповещения в файл формата YAML, XML или JSON - *Удалить (Delete)* — удалить способы оповещения Для использования этих опций отметьте флажки перед соответствующими способами оповещения, затем нажмите на требуемую кнопку. ##### 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* - *Clear history and trends* - clear history and trend data for the scenarios - *Delete* - delete the web scenarios To use these options, mark the checkboxes before the respective web scenarios, then click on the required button. ##### Опции массового редактирования Кнопки ниже списка предлагают некоторые опции массового редактирования: - *Активировать* — поменять состояние веб-сценария на *Активировано* - *Отключить* — поменять состояние веб-сценария на *Деактивировано* - *Очистить историю и динамику изменений* — очистить всю историю и динамику изменений для выбранных сценариев - *Удалить* — удалить веб-сценарий Для использования этих опций отметьте флажки перед соответствующими веб-сценариями, затем нажмите на требуемую кнопку. ##### 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. ##### Опции массового редактирования Кнопки ниже списка предлагают некоторые опции массового редактирования: - *Активировать* — поменять состояние веб-сценария на *Активировано* - *Отключить* — поменять состояние веб-сценария на *Деактивировано* - *Удалить* — удалить веб-сценарий Для использования этих опций отметьте флажки перед соответствующими веб-сценариями, затем нажмите на требуемую кнопку. ##### 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. ##### Опции массового редактирования Кнопки ниже списка предлагают некоторые опции массового редактирования: - *Активировать (Enable)* — изменить состояние группы пользователей на *Активировано* - *Отключить (Disable)* — изменить состояние группы пользователей на *Деактивировано* - *Активировать режим отладки (Enable debug mode)* — включить режим отладки для группы пользователей - *Деактивировать режим отладки (Disable debug mode)* — выключить режим отладки для группы пользователей - *Удалить (Delete)* — удалить группу пользователей Для использования этих опций отметьте флажки перед соответствующими группами пользователей, затем нажмите на требуемую кнопку. ##### 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. ##### Опции массового редактирования Кнопки под списком предлагают некоторые опции массового редактирования: - *Активировать узлы сети (Enable hosts)* — изменить состояние узлов сети, наблюдаемых через выбранные прокси, на *Под наблюдением (Monitored)* - *Деактивировать узлы сети (Disable hosts)* — изменить состояние узлов сети, наблюдаемых через выбранные прокси, на *Без наблюдения (Not monitored)* - *Удалить (Delete)* — удалить прокси-серверы Для использования этих опций установите флажки перед соответствующими прокси-серверами, затем нажмите на нужную кнопку. ##### 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#обновление-проблем) Для использования этой опции отметьте соответствующие проблемы и затем нажмите на кнопку *Массовое обновление*. ##### 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. ##### Опции массового редактирования Кнопки ниже списка предлагают некоторые опции массового редактирования: - *Разблокировать (Unblock)* — повторно активировать доступ к системе заблокированным пользователям - *Удалить (Delete)* — удалить пользователей Для использования этих опций отметьте флажки перед соответствующими пользователями, затем нажмите на требуемую кнопку. ##### Mass update Sometimes you may want to delete or change the status of a number of reports at once. Instead of opening each individual report for editing, you may use the mass update function for that. To mass-update some reports, do the following: - Mark the checkboxes of the reports to update in the list - Click the required button below the list to make the changes (*Enable*, *Disable*, or *Delete*) ##### Массовое обновление Иногда вам может потребоваться удалить или изменить статус сразу нескольких отчётов. Вместо того, чтобы открывать на редактирование каждый отчёт по отдельности, вы можете использовать для этого функцию массового обновления. Для массового изменения нескольких отчётов выполните следующее: - В списке отчётов отметьте флажками те, которые нужно обновить - Нажмите на нужную кнопку под списком, чтобы произвести изменения (*Активировать (Enable)*, *Отключить (Disable)* или *Удалить (Delete)*) ##### 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  Задайте тип информации как «Текст (Text)», чтобы иметь возможность обрабатывать большие данные в формате 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 testing It is possible to test if a configured media type works. The testing request will be sent to Zabbix server. Zabbix server will attempt to send an alert using the specified media type and will return the result to frontend. The frontend will wait for the server to return the results. **Email** For example, to test an email media type: - Locate the relevant email in the [list](#overview) of media types - Click on *Test* in the last column of the list (a testing window will open) - Enter a *Send to* recipient address and with body and optional subject - Send a test message by clicking on *Test* Test success or failure message will be displayed in the same window: |<|{width="600"}| |-|-----------------------------------------------------------------------------------------| **Webhook** To test a webhook media type: - Locate the relevant webhook in the [list](#overview) of media types - Click on *Test* in the last column of the list (a testing window will open) - Edit the webhook parameter values, if needed - Click on *Test* By default, webhook tests are performed with parameters entered during configuration. However, it is possible to change attribute values for testing. Replacing or deleting values in the testing window affects the test procedure only, the actual webhook attribute values will remain unchanged. |<|{width="600"}| |-|-----------------------------------------------------------------------| To view media type test log entries without leaving the test window: - Click on *Open log* (a new popup window will open). |<|{width="600"}| |-|-------------------------------------------------------------------------| #### Тест способа оповещения Имеется возможность проверки, работает ли настроенный способ оповещения. Тестовый запрос будет отправлен на Zabbix сервер. Zabbix сервер попытается отправить оповещение, используя указанный способ оповещения, и вернёт результат в веб-интерфейс. Веб-интерфейс будет ожидать ответа от сервера. **Email** Например, для проверки способа оповещений e-mail: - Найдите подходящий e-mail в [списке](#обзор) способов оповещения - Нажмите *Тест (Test)* в последней колонке списка (откроется окно тестирования) - Введите адрес получателя в поле *Отправлять на (Send to)*, далее укажите тему (необязательно) и текст сообщения тестового оповещения. - Для отправки тестового уведомления, нажмите на *Тест (Test)* Сообщение об успехе или неудаче тестирования отобразится в этом же окне: |<|{width="600"}| |-|-----------------------------------------------------------------------------------------| **Вебхук** Чтобы проверить способ оповещения с типом вебхук: - Выберите подходящий вебхук в [списке](#обзор) типов оповещений - Нажмите на *Тест (Test)* в последней колонке строки (откроется окно тестирования) - При необходимости измените значения параметров вебхука - Нажмите на *Тест (Test)* По умолчанию тестирование вебхука выполняется с параметрами, указанными во время настройки. Тем не менее, для тестирования значения параметров можно изменить. Замена или удаление значений в окне теста влияет только на процедуру тестирования, реальные значения вебхука останутся нетронутыми. |<|{width="600"}| |-|-----------------------------------------------------------------------| Для просмотра журнала тестирования способа оповещений, не выходя из окна тестирования: - Нажмите на *Открыть журнал (Open log)* (откроется новое всплывающее окно). |<|{width="600"}| |-|-------------------------------------------------------------------------| # mediatype.update # mediatype.update ### Memcached |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |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.<br>**user, password** - Memcached login credentials.| | |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** - Memcached login credentials.<br>**type** - stat type to be returned: *items*, *sizes*, *slabs* or *settings* (empty by default, returns general statistics).| | ### Memcached |Ключ|<|<|<| |--|--|------|------| |**Описание**|**Возвращаемое значение**|**Параметры**|**Комментарии**| |memcached.ping\[строка_подкл,<пользователь>,<пароль>\]|<|<|<| |Проверка можно ли установить подключение.|1 — подключение активно<br><br>0 — подключение разорвано (если имеется какая-либо ошибка, включая проблемы с аутентификацией или проблемы с настройками)|**строка_подкл** — URI или имя сессии.<br>**пользователь, пароль** — учётные данные для входа в Memchached.| | |memcached.stats\[строка_подкл,<пользователь>,<пароль>,<тип>\]|<|<|<| |Получение вывода команды STATS.|JSON — вывод, преобразованный в JSON|**строка_подкл** — URI или имя сессии.<br>**пользователь, пароль** — учётные данные для входа в Memchached.<br>**тип** — тип возвращаемой статистики: *items*, *sizes*, *slabs* или *settings* (по умолчанию пусто, возвращается общая статистика).| | #### 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) Для размера памяти вы можете использовать: - **К** — килобайт - **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)! ::: # 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](#post-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; ``` * Следуйте [инструкциям по пост-миграции](#пост-миграция) для удаления старых таблиц. #### 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). #### MikroTik - *MikroTik CCR1009-7G-1C-1S+ SNMP* - мониторинг MikroTik CCR1009-7G-1C-1S+ роутеров через SNMP; - *MikroTik CCR1009-7G-1C-1S+PC SNMP* - мониторинг MikroTik CCR1009-7G-1C-1S+PC роутеров через SNMP; - *MikroTik CCR1009-7G-1C-PC SNMP* - мониторинг MikroTik CCR1009-7G-1C-PC роутеров через SNMP; - *MikroTik CCR1016-12G SNMP* - мониторинг MikroTik CCR1016-12G роутеров через SNMP; - *MikroTik CCR1016-12S-1S+ SNMP* - мониторинг MikroTik CCR1016-12S-1S+ роутеров через SNMP; - *MikroTik CCR1036-12G-4S-EM SNMP* - мониторинг MikroTik CCR1036-12G-4S-EM роутеров через SNMP; - *MikroTik CCR1036-12G-4S SNMP* - мониторинг MikroTik CCR1036-12G-4S роутеров через SNMP; - *MikroTik CCR1036-8G-2S+ SNMP* - мониторинг MikroTik CCR1036-8G-2S+ роутеров через SNMP; - *MikroTik CCR1036-8G-2S+EM SNMP* - мониторинг MikroTik CCR1036-8G-2S+EM роутеров через SNMP; - *MikroTik CCR1072-1G-8S+ SNMP* - мониторинг MikroTik CCR1072-1G-8S+ роутеров через SNMP; - *MikroTik CCR2004-16G-2S+ SNMP* - мониторинг MikroTik CCR2004-16G-2S+ роутеров через SNMP; - *MikroTik CCR2004-1G-12S+2XS SNMP* - мониторинг MikroTik CCR2004-1G-12S+2XS роутеров через SNMP; - *MikroTik CRS106-1C-5S SNMP* - мониторинг MikroTik CRS106-1C-5S коммутаторов через SNMP; - *MikroTik CRS109-8G-1S-2HnD-IN SNMP* - мониторинг MikroTik CRS109-8G-1S-2HnD-IN коммутаторов через SNMP; - *MikroTik CRS112-8G-4S-IN SNMP* - мониторинг MikroTik CRS112-8G-4S-IN коммутаторов через SNMP; - *MikroTik CRS112-8P-4S-IN SNMP* - мониторинг MikroTik CRS112-8P-4S-IN коммутаторов через SNMP; - *MikroTik CRS125-24G-1S-2HnD-IN SNMP* - мониторинг MikroTik CRS125-24G-1S-2HnD-IN коммутаторов через SNMP; - *MikroTik CRS212-1G-10S-1S+IN SNMP* - мониторинг MikroTik CRS212-1G-10S-1S+IN коммутаторов через SNMP; - *MikroTik CRS305-1G-4S+IN SNMP* - мониторинг MikroTik CRS305-1G-4S+IN коммутаторов через SNMP; - *MikroTik CRS309-1G-8S+IN SNMP* - мониторинг MikroTik CRS309-1G-8S+IN коммутаторов через SNMP; - *MikroTik CRS312-4C+8XG-RM SNMP* - мониторинг MikroTik CRS312-4C+8XG-RM коммутаторов через SNMP; - *MikroTik CRS317-1G-16S+RM SNMP* - мониторинг MikroTik CRS317-1G-16S+RM коммутаторов через SNMP; - *MikroTik CRS326-24G-2S+IN SNMP* - мониторинг MikroTik CRS326-24G-2S+IN коммутаторов через SNMP; - *MikroTik CRS326-24G-2S+RM SNMP* - мониторинг MikroTik CRS326-24G-2S+RM коммутаторов через SNMP; - *MikroTik CRS326-24S+2Q+RM SNMP* - мониторинг MikroTik CRS326-24S+2Q+RM коммутаторов через SNMP; - *MikroTik CRS328-24P-4S+RM SNMP* - мониторинг MikroTik CRS328-24P-4S+RM коммутаторов через SNMP; - *MikroTik CRS328-4C-20S-4S+RM SNMP* - мониторинг MikroTik CRS328-4C-20S-4S+RM коммутаторов через SNMP; - *MikroTik CRS354-48G-4S+2Q+RM SNMP* - мониторинг MikroTik CRS354-48G-4S+2Q+RM коммутаторов через SNMP; - *MikroTik CRS354-48P-4S+2Q+RM SNMP* - мониторинг MikroTik CRS354-48P-4S+2Q+RM коммутаторов через SNMP; - *MikroTik CSS326-24G-2S+RM SNMP* - мониторинг MikroTik CSS326-24G-2S+RM коммутаторов через SNMP; - *MikroTik CSS610-8G-2S+IN SNMP* - мониторинг MikroTik CSS610-8G-2S+IN коммутаторов через SNMP; - *MikroTik FiberBox SNMP* - мониторинг MikroTik FiberBox коммутаторов через SNMP; - *MikroTik hEX lite SNMP* - мониторинг MikroTik hEX lite роутеров через SNMP; - *MikroTik hEX PoE lite SNMP* - мониторинг MikroTik hEX PoE lite роутеров через SNMP; - *MikroTik hEX PoE SNMP* - мониторинг MikroTik hEX PoE роутеров через SNMP; - *MikroTik hEX S SNMP* - мониторинг MikroTik hEX S роутеров через SNMP; - *MikroTik hEX SNMP* - мониторинг MikroTik hEX роутеров через SNMP; - *MikroTik netPower 15FR SNMP* - мониторинг MikroTik netPower 15FR коммутаторов через SNMP; - *MikroTik netPower 16P SNMP* - мониторинг MikroTik netPower 16P коммутаторов через SNMP; - *MikroTik netPower Lite 7R SNMP* - мониторинг MikroTik netPower Lite 7R коммутаторов через SNMP; - *MikroTik PowerBox Pro SNMP* - мониторинг MikroTik PowerBox Pro роутеров через SNMP; - *MikroTik PowerBox SNMP* - мониторинг MikroTik PowerBox роутеров через SNMP; - *MikroTik RB1100AHx4 Dude Edition SNMP* - мониторинг MikroTik RB1100AHx4 Dude Edition роутеров через SNMP; - *MikroTik RB1100AHx4 SNMP* - мониторинг MikroTik RB1100AHx4 роутеров через SNMP; - *MikroTik RB2011iL-IN SNMP* - мониторинг MikroTik RB2011iL-IN роутеров через SNMP; - *MikroTik RB2011iL-RM SNMP* - мониторинг MikroTik RB2011iL-RM роутеров через SNMP; - *MikroTik RB2011iLS-IN SNMP* - мониторинг MikroTik RB2011iLS-IN роутеров через SNMP; - *MikroTik RB2011UiAS-IN SNMP* - мониторинг MikroTik RB2011UiAS-IN роутеров через SNMP; - *MikroTik RB2011UiAS-RM SNMP* - мониторинг MikroTik RB2011UiAS-RM роутеров через SNMP; - *MikroTik RB260GS SNMP* - мониторинг MikroTik RB260GS коммутаторов через SNMP; - *MikroTik RB3011UiAS-RM SNMP* - мониторинг MikroTik RB3011UiAS-RM роутеров через SNMP; - *MikroTik RB4011iGS+RM SNMP* - мониторинг MikroTik RB4011iGS+RM роутеров через SNMP; - *MikroTik RB5009UG+S+IN SNMP* - мониторинг MikroTik RB5009UG+S+IN роутеров через SNMP; - *Mikrotik SNMP* - общий шаблон мониторинга MikroTik устройств. Вы можете найти эти шаблоны: - В разделе *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить с [Zabbix Git репозитория](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates) и вручную импортировать в Zabbix в разделе *Настройка* → *Шаблоны*. Если шаблон с таким же именем уже будет существовать, выберите *Удалить отсутствующее* опцию, чтобы добиться чистого импорта. Таким образом, элементы, которые были исключены из шаблона, будут удалены (обратите внимание, история по удалённым элементам данных будет потеряна). ##### 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). ### Веб-интерфейс #### 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 \<модель устройства> SNMP* -- 53 новых помодельных шаблона для мониторинга различных моделей сетевых маршрутизаторов и коммутаторов MikroTik, смотрите [полный список](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/mikrotik); - *Mikrotik SNMP* -- универсальный шаблон для мониторинга устройств MikroTik. #### 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), [подгружаемые плагины](/manual/extensions/plugins#подгружаемые) агента 2 или [веб-сервис](/manual/concepts/web_service) с использованием версии Go старше 1.23, рекомендуется пересобрать эти компоненты с использованием [поддерживаемой версии Go](/manual/installation/requirements#агент-2), чтобы получить последние обновления безопасности и исправления ошибок. Компоненты, собранные с использованием более старой версии Go, продолжат работать, но для [обновления](/manual/installation/upgrade/sources#процесс-обновления-агента) потребуется более новая среда 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 ##### Минимальное количество свободного места за неделю среди кластеров Просмотр минимального количества свободного места среди кластеров за неделю. - добавьте набор данных: узлы сети `cluster*`, ключ «Free disk space on /data» - выберите функцию агрегации `мин` и укажите период `1w` - отобразится столбчатый график, где каждый столбец будет представлять минимальное количество места на диске за неделю по каждому тому /data кластера ## 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#настройка-операции) действия, все оставшиеся шаги эскалаций выполнятся либо с задержкой, вызванной периодом обслуживания, либо без задержки. Период обслуживания не отменяет операции.| |*Период времени, указанный в условии **Период времени** действия, завершается после первоначальной отправки оповещения*|Выполнятся все оставшиеся шаги эскалации. Условие *Период времени* не может прервать операции; это условие влияет на то, когда начинается или не начинается действие, а не операция.| |*Проблема началась в течение периода обслуживания и продолжается (не исправлена) после окончания обслуживания*|В зависимости от опции *Приостановить операции для подавленных проблем* в [настройках](/manual/config/notifications/action/operation#настройка-операции) действия, все шаги выполнятся либо с момента завершения обслуживания, либо сразу же.| |*Проблема началась в течение периода обслуживания без сбора данных и продолжается (не исправлена) после окончания обслуживания*|Прежде чем выполнятся все шаги эскалаций, нужно дождаться срабатывания триггера.| |*Разные эскалации следуют в тесном порядке и перекрываются*|Выполнение каждой новой эскалации заменяет предыдущую эскалацию, но по крайней мере для одного шага эскалации, который всегда обязательно выполняется при предыдущей эскалации. Такое поведение уместно для действий на события, которые создаются на КАЖДОЕ вычисление проблемы триггера.| |*В процессе выполнения эскалации (например, во время отправки сообщения), основанном на любом типе событий:<br>- действие деактивировано<br>На основе события на триггер:<br>- триггер деактивирован<br>- узел сети или элемент данных деактивирован<br>На основе внутреннего события о триггере:<br>- триггер деактивирован<br>На основе внутреннего события об элементах данных/правилах низкоуровневого обнаружения:<br>- элемент данных деактивирован<br>- узел сети деактивирован*|Будет отправлено сообщение, которое уже в процессе отправки, затем будет отправлено ещё одно сообщение на эскалацию. Это последующее сообщение будет иметь следующий текст в начале тела сообщения (*NOTE: Escalation cancelled*) с указанием причины (например, *NOTE: Escalation cancelled: action '<Имя действия>' disabled*). Таким образом получатель будет проинформирован о том, что эскалация отменена и дальнейшие шаги не будут выполнены. Это сообщение будет отправлено всем, кто получал оповещения ранее. Причина отмены также будет записана в файл журнала сервера (начиная с [уровня отладки](/manual/appendix/config/zabbix_server) 3=Предупреждения).<br><br>Обратите внимание, что сообщение *Escalation canceled* также будет отправлено, если все операции завершены, а операции восстановления настроены, но ещё не выполнялись.| |*В процессе выполнения эскалации (например, во время отправки сообщения) удалено действие*|Сообщения более не отсылаются. Информация будет записана в файл журнала сервера (начиная с [уровня отладки](/manual/appendix/config/zabbix_server) 3=Предупреждения), например: `escalation cancelled: action id:334 deleted`| #### 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#настройка) - сообщение [способов оповещений](/manual/config/notifications/media#общие-параметры) - Язык по умолчанию веб-интерфейса Zabbix изменён с Британского на Американский Английский. Поддержка Британского Английского прекращена. - Ссылка Share в основном меню заменена на ссылку [Интеграции](https://www.zabbix.com/integrations), которая ведёт на страницу Интеграции веб-сайта Zabbix. - Если веб-интерфейс Zabbix открывается с одним из языков, поддерживаемых на веб-сайте Zabbix, то при нажатии на ссылку Интеграции будет открыта страница Интеграции на соответствующем языке. Для все остальных языков, включая Английский, страница Интеграции откроется на Английском языке. - Пользовательское выражение, которое используется в [настройках действия](/manual/config/notifications/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#опции-массового-редактирования), была переименована в *Очистить историю и динамику изменений* для более точного описания её функции, в точности такой же как и кнопка *Очистить историю и динамику изменений* [диалога конфигурации](/manual/config/items/item) элемента данных. #### 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. - 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). #### Прочие - Язык по умолчанию Zabbix веб-интерфейса изменён с Британского на Американский Английский. Поддержка Британского Английского прекращена. - Ссылка Share в основном меню заменена на ссылку Интеграции, которая ведёт на страницу [Интеграции](https://www.zabbix.com/integrations) веб-сайта Zabbix. - Если Zabbix веб-интерфейс с одним из поддерживаемых языков на Zabbix веб-сайте, то при нажатии на ссылку Интеграции будет открыта страница Интеграции на соответствующем языке. Для все остальных языки, включая Английский, страница Интеграции будет открыта на Английском языке. - Пользовательское выражение, которое используется в [настройках действия](/manual/config/notifications/action/#настройка-действия) для вычисления условий, теперь может быть длиной вплоть до 1024 символов (ранее 255). #### 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 В версиях 6.0.0-6.0.27 ZIP-файлов загрузки Zabbix агента для Windows отсутствуют файлы zabbix_sender.h и zabbix_sender.lib, необходимые для zabbix_sender.dll. ### 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) должен быть указан в именованной сессии, в то время как остальные параметры могут быть определены либо в именованной сессии, либо в ключе элемента данных. ##### Modbus data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**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.<br><br>On Windows, this item follows UNC paths in the **endpoint** parameter, which can be a [security risk](/manual/installation/requirements/best_practices#unc-path-access-on-windows-by-zabbix-agent).| ##### Данные Modbus |Ключ элемента данных|<|<|<| |--|--|------|------| |Описание|Возвращаемое значение|Параметры|Комментарии| |**modbus.get**\[точка входа,<id ведомого>,<функция>,<адрес>,<количество>,<тип>,<порядок следования байтов>,<сдвиг>\]|<|<|<| |Чтение данных Modbus.|JSON объект|**точка входа** — точка входа, определяемая в виде `протокол://строка_подключения`<br>**id ведомого** — ID ведомого<br>**функция** — функция Modbus<br>**адрес** — адрес первого регистра, флага или входа<br>**количество** — количество записей для чтения<br>**тип** — тип данных<br>**порядок следования байтов** — настройка порядка следования байтов<br>**сдвиг** — количество регистров, начиная с «адреса», результаты которых будут отброшены.<br><br>Смотрите также [подробное описание](/manual/appendix/items/modbus) параметров.|Поддерживается начиная с Zabbix 5.2.0.<br><br>В Windows, этот элемент данных использует UNC пути в параметре **точка входа**, что может являться [угрозой безопасности](/manual/installation/requirements/best_practices#доступ-к-unc-путям-в-windows-через-zabbix-агент).| ##### Modes (**forecast** only)<br> Every time a trigger function is evaluated, it gets data from the specified history period and fits a specified function to the data. So, if the data is slightly different, the fitted function will be slightly different. If we simply calculate the value of the fitted function at a specified time in the future, you will know nothing about how the analyzed item is expected to behave between now and that moment in the future. For some `fit` options (like *polynomial*) a simple value from the future may be misleading. |`mode`|**forecast** result| |------|-------------------| |*value*|f(now + `time`)| |*max*|max~now\ <=\ t\ <=\ now\ +\ `time`~ f(t)| |*min*|min~now\ <=\ t\ <=\ now\ +\ `time`~ f(t)| |*delta*|*max* - *min*| |*avg*|average of f(t) (now <= t <= now + `time`) according to [definition](https://en.wikipedia.org/wiki/Mean_of_a_function)| ##### Режимы (Только **forecast**)<br> Каждый раз, когда вычисляется функция триггера, данные запрашиваются из указанного периода истории и по полученным данным строится указанная аппроксимация. Поэтому, если данные немного изменятся, то и построенная аппроксимация немного изменится. Если мы будем просто рассчитывать значение функции аппроксимации в заданный момент времени в будущем, то вы ничего не будете знать о том, как согласно прогнозу будет меняться анализируемый элемент данных между текущим моментом и этим моментом в будущем. При некоторых параметрах `аппроксимации` (вроде *polynomial*) просто лишь одно значение из будущего может ввести в заблуждение. |`режим`|Результат **forecast**| |------|-------------------| |значение (*value*)|f(сейчас + `время`)| |максимум (*max*)|max~сейчас\ <=\ t\ <=\ сейчас\ +\ `время`~ f(t)| |минимум (*min*)|min~сейчас\ <=\ t\ <=\ сейчас\ +\ `время`~ f(t)| |дельта (*delta*)|*max* - *min*| |среднее (*avg*)|среднее значение f(t) (сейчас <= t <= сейчас + `время`) в соответствии с [определением](https://ru.wikipedia.org/wiki/Среднее_значение_функции)| ### 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 Кнопки, описанные ниже, доступны, только когда раздел *Услуги* находится в режиме Изменить. ::: Для изменения существующей услуги нажмите на значок карандаша рядом с услугой. Для клонирования существующей услуги нажмите на значок карандаша, чтобы открыть диалог услуги, а затем нажмите на кнопку Клонировать. При клонировании услуги её ссылки на родительские услуги сохраняются, а ссылки на дочерние — нет. Для удаления услуги нажмите на значок `x` рядом с ней. При удалении родительской услуги её дочерние услуги не удаляются, а перемещаются на один уровень выше в дереве услуг (дочерние услуги 1-го уровня получат тот же уровень, что и удалённая родительская услуга). Две кнопки под списком услуг предлагают некоторые опции массового изменения: - *Массовое обновление* — массовое обновление свойств услуг - *Удалить* — удаление услуг Чтобы воспользоваться этими опциями, отметьте необходимые услуги, затем нажмите на требуемую кнопку. #### Module API In order for a shared library to be treated as a Zabbix module, it should implement and export several functions. There are currently six functions in the Zabbix module API, only one of which is mandatory and the other five are optional. #### API модулей Для того чтобы разделяемая библиотека обрабатывалась как модуль Zabbix, она должна реализовывать и экспортировать несколько функций. На данный момент имеется шесть функций в API модулей Zabbix, только одна из которых обязательна, а остальные пять — не обязательны. #### Modules This section allows to administer custom [frontend modules](/manual/modules). {width="600"} Click on *Scan directory* to register/unregister any custom modules. Registered modules will appear in the list, along with their details. Unregistered modules will be removed from the list. You may filter modules by name or status (enabled/disabled). Click on the module status in the list to enable/disable a module. You may also mass enable/disable modules by selecting them in the list and then clicking on the *Enable/Disable* buttons below the list. #### Модули Эта страница позволяет администрировать пользовательские [модули веб-интерфейса](/manual/modules). {width="600"} Нажмите на *Сканировать директорию (Scan directory)*, чтобы зарегистрировать/отменить регистрацию любых пользовательских модулей. Зарегистрированные модули появятся в списке вместе с их подробностями. Незарегистрированные модули будут удалены из списка. Вы можете отфильтровать модули по имени или состоянию (активировано/деактивировано). Нажмите на состояние модуля в списке, чтобы активировать/деактивировать модуль. Вы также можете массово активировать/деактивировать модули, выбрав их в списке, а затем нажав кнопки *Активировать/Отключить (Enable/Disable)* под списком. ##### 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`) с вложенными папками, содержащими контроллеры, представления и любой другой код: 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`. Модуль не будет регистрироваться без этого файла. `Module.php` отвечает за регистрацию пунктов меню и обработку событий, таких как «onBeforeAction» и «onTerminate». Директории *actions* (действия), *views* (представления) и *partials* (составляющие) содержат код PHP и JavaScript, необходимый для действий модуля. ### 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 Объект модуля имеет следующие свойства: |Свойство|[Тип](/manual/api/reference_commentary#data_types)|Описание| |--|--|------| |**moduleid**<br>(обязательное)|строка|ID модуля.| |status|integer|Включен ли модуль.<br><br>Возможные значения:<br>0 - Отключен;<br>1 - *(default)* Включен.| ### MongoDB |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |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.| | |mongodb.collections.discovery\[connString,<user>,<password>\]|<|<|<| |Returns a list of discovered collections. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.collections.usage\[connString,<user>,<password>\]|<|<|<| |Returns usage statistics for collections.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |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.| | |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).| | |mongodb.db.discovery\[connString,<user>,<password>\]|<|<|<| |Returns a list of discovered databases. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |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.| | |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.| | |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.| | |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.| | |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.| | |mongodb.server.status\[connString,<user>,<password>\]|<|<|<| |Returns database state.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |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.| | |mongodb.version\[connString,<user>,<password>\]|<|<|<| |Returns the database server version.|String|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | ### MongoDB |Ключ|<|<|<| |--|--|------|------| |**Описание**|**Возвращаемое значение**|**Параметры**|**Комментарии**| |mongodb.collection.stats\[строка_подкл,<имя_пользователя>,<пароль>,<база_данных>,коллекция\]|<|<|<| |Получение различной статистики хранилища по заданной коллекции.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.<br>**база_данных** — имя базы данных (по умолчанию: admin).<br>**коллекция** — имя коллекции.| | |mongodb.collections.discovery\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Получение списка обнаруженных коллекций. Используется [низкоуровневым обнаружением](/manual/discovery/low_level_discovery).|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | |mongodb.collections.usage\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Получение статистики использования по коллекциям.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | |mongodb.connpool.stats\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Получение информации касательно открытых исходящих подключений с текущего экземпляра базы данных к другим членам кластера сегментов или набора реплик.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | |mongodb.db.stats\[строка_подкл,<имя_пользователя>,<пароль>,<база_данных>\]|<|<|<| |Получение статистики, отражающей состояние системы заданной базы.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.<br>**база_данных** — имя базы (по умолчанию: admin).| | |mongodb.db.discovery\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Получение списка обнаруженных баз данных. Используется [низкоуровневым обнаружением](/manual/discovery/low_level_discovery).|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | |mongodb.jumbo\_chunks.count\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Получение количества jumbo chunk.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | |mongodb.oplog.stats\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Получение состояния набора реплик, используя данные полученные от oplog.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | |mongodb.ping\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Проверка, можно ли установить подключение.|1 — подключение успешно<br><br>0 — подключение разорвано (если имеется какая-либо ошибка, включая проблемы с аутентификацией или проблемы с настройками).|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | |mongodb.rs.config\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Получение текущей конфигурации набора реплик.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | |mongodb.rs.status\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Получение состояния набора реплик с точки видимости члена, откуда вызывается метод.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | |mongodb.server.status\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Получение состояния базы данных.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | |mongodb.sh.discovery\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Получение списка обнаруженных сегментов, находящихся в кластере.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | |mongodb.version\[строка_подкл,<имя_пользователя>,<пароль>\]|<|<|<| |Получение версии сервера базы данных.|Строка|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные к MongoDB.| | #### 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 Следующие парамеры плагина MongoDB более не являются обязательными, если параметр Plugins.MongoDB.Sessions.<ИмяСессии>.TLSConnect установлен в `verify_ca` или `verify_full`: - Plugins.MongoDB.Sessions.<ИмяСессии>.TLSCertFile - Plugins.MongoDB.Sessions.<ИмяСессии>.TLSKeyFile Смотрите также: [Параметры плагина MongoDB](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#параметры). #### 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. #### Обновлён раздел Мониторинг → Последние данные В разделе Последние данные сделаны несколько улучшений: - Вместо времени последней проверки теперь отображается время с момента последней проверки (например, 1m 20s). - При наведении на последнее значение элемента данных отобразится сырое значение без применения единиц преобразования и соответствия значений. - Если узел сети находится в обслуживании, рядом с именем узла сети отобразится оранжевая иконка в виде гаечного ключа. #### 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. ## Переломные изменения #### 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 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 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 → 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` — параметр фильтра «Инвентарные данные узла сети»: массив полей инвентарных данных: \[поле\], \[значение\] - `evaltype` — параметр фильтра «Теги», стратегия фильтрации по тегам: 0 — И/Или, 2 — Или - `tags` — параметр фильтра «Теги»: массив определённых тегов: \[тег\], \[оператор\], \[значение\] - `show_tags` — параметр фильтра «Отображать теги»: 0 — нет, 1 — один, 2 — два, 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` — столбец сортировки: clock (время), host (узел сети), severity (важность), name (имя) - `sortorder` — порядок сортировки либо результатов: DESC — по убыванию, ASC — по возрастанию - `age_state` — параметр фильтра «Возраст менее чем»: должно быть 'age\_state=1' для включения возраста ('age'). Используется только когда 'show' равно 3. - `age` — параметр фильтра «Возраст менее чем»: дней - `groupids` — параметр фильтра «Группы узлов сети»: массив идентификаторов групп узлов сети - `hostids` — параметр фильтра «Узлы сети»: массив идентификаторов узлов сети - `triggerids` — параметр фильтра «Триггеры»: массив идентификаторов триггеров - `show_timeline` — параметр фильтра «Шкала времени»: для отображения должно быть 'show\_timeline=1' - `details` — параметр фильтра «Подробная информация»: для отображения должно быть 'details=1' - `from` — начало диапазона дат, может быть 'относительным' (например: now-1m). Используется только когда 'filter\_custom\_time' равно 1. - `to` — конец диапазона дат, может быть 'относительным' (например: now-1m). Используется только когда 'filter\_custom\_time' равно 1. #### 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). #### Монотонное изменение Теперь имеется возможность проверки монотонного увеличения или уменьшения значений элементов данных с использованием **monoinc()** или **monodec()** [функции истории](/manual/appendix/functions/history). #### 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. #### Дополнительная информация Смотрите раздел [мониторинга виртуальных машин](/manual/vm_monitoring) для получения более подробной информации о настройке Zabbix для мониторинга сред VMware. #### 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#глобальные-функции-javascript) теперь возвращает массив 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. #### Перемещение и копирование элементов Можно **переместить** несколько выбранных элементов в другое место на карте, если нажать на один из выбранных элементов, а затем, удерживая кнопку мыши, передвинуть курсор в желаемое место. Можно **скопировать** один и более элементов, если, выбрав элементы, затем нажать на выбранный элемент правой кнопкой мыши и выбрать из меню *Копировать (Copy)*. {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\[<url\_ брокера>,тема,<имя_пользователя>,<пароль>\]|<|<|<| |Подписка на заданную тему или темы (с шаблонами), которые предоставляются брокером, и ожидание публикаций.|Зависит от содержимого темы.<br><br>Если использовался шаблон, возвращает содержимое темы в виде JSON.|**url\_брокера** — URL брокера MQTT (если пустой, используется *localhost* с портом 1883).<br>**тема** — тема MQTT (обязательно). Поддерживаются шаблоны (+,\#).<br>**имя_пользователя,пароль** — учётные данные для аутентификации (если требуется)|Элемент данных необходимо настроить [активной проверкой](/manual/appendix/items/activepassive#активные_проверки) (тип элемента данных «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 Добавлен новый плагин для прямого мониторинга MSSQL с помощью Zabbix агента 2. Для получения дополнительной информации см.: - [readme плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [элементы данных агента 2](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) - [параметры плагина MSSQL](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin) - [Установка Агента 2](/manual/concepts/agent2#установка) #### 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 |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |mssql.availability.group.get\[URI,<user>,<password>\]|<|<|<| |Returns availability groups.|JSON object|**URI** - MSSQL server URI (the only supported schema is `sqlserver://`). Embedded credentials will be ignored. Since Zabbix 6.0.36, it is possible to specify an instance name as part of the URI, i.e.: `sqlserver://localhost/InstanceName` (no port). If port is specified, the instance name is ignored;<br>**user, password** - username, password to send to protected MSSQL server.|Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.custom.query\[URI,<user>,<password>,queryName,<args...>\]|<|<|<| |Returns the result of a custom query.|JSON object|**URI** - MSSQL server URI (the only supported schema is `sqlserver://`). Embedded credentials will be ignored. Since Zabbix 6.0.36, it is possible to specify an instance name as part of the URI, i.e.: `sqlserver://localhost/InstanceName` (no port). If port is specified, the instance name is ignored;<br>**user, password** - username, password to send to protected MSSQL server;<br>**queryName** - name of a custom query configured in `Plugins.MSSQL.CustomQueriesDir` without the .sql extension;<br>**args** - one or several comma-separated arguments to pass to a query.|Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.db.get|<|<|<| |Returns all available MSSQL databases.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.job.status.get|<|<|<| |Returns the status of jobs.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.last.backup.get|<|<|<| |Returns the last backup time for all databases.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.local.db.get|<|<|<| |Returns databases that are participating in an Always On availability group and replica (primary or secondary) and are located on the server that the connection was established to.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.mirroring.get|<|<|<| |Returns mirroring info.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.nonlocal.db.get|<|<|<| |Returns databases that are participating in an Always On availability group and replica (primary or secondary) located on other servers (the database is not local to the SQL Server instance that the connection was established to).|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.perfcounter.get|<|<|<| |Returns the performance counters.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.ping|<|<|<| |Ping the database. Test if connection is correctly configured.|1 - alive,<br>0 - not alive| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.quorum.get|<|<|<| |Returns the quorum info.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.quorum.members.get|<|<|<| |Returns the quorum members.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.replica.get|<|<|<| |Returns the replicas.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.version|<|<|<| |Returns the MSSQL version.|String| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| ### MSSQL |Ключ|<|<|<| |--|--|------|------| |**Описание**|**Возвращаемое значение**|**Параметры**|**Комментарии**| |mssql.availability.group.get\[URI,<имя_пользователя>,<пароль>\]|<|<|<| |Возвращает доступность группы.|JSON object|**URI** — URI сервера MSSQL (поддерживается только схема `sqlserver://`). Встроенные креденшиалы будут проигнорированы. Начиная с версии Zabbix 6.0.36, можно указать имя экземпляра как часть URI, например: `sqlserver://localhost/InstanceName` (без порта). Если указан порт, имя экземпляра игнорируется;<br>**имя_пользователя, пароль** — имя пользователя и пароль, пересылаемые на защищённый сервер MSSQL.|Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.custom.query\[URI,<имя_пользователя>,<пароль>,имяЗапроса,<аргументы...>\]|<|<|<| |Возвращает результат пользовательского запроса.|Объект JSON|**URI** — URI сервера MSSQL (поддерживается только схема `sqlserver://`). Встроенные креденшиалы будут проигнорированы. Начиная с версии Zabbix 6.0.36, можно указать имя экземпляра как часть URI, например: `sqlserver://localhost/InstanceName` (без порта). Если указан порт, имя экземпляра игнорируется;<br>**имя_пользователя, пароль** — имя пользователя и пароль, пересылаемые на защищённый сервер MSSQL;<br>**имяЗапроса** — имя пользовательского запроса, настроенного в `Plugins.MSSQL.CustomQueriesDir` без расширения .sql;<br>**аргументы** — один или несколько перечисленных через запятую аргументов, которые будут переданы запросу.|Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.db.get|<|<|<| |Возвращает все доступные базы данных MSSQL.|Объект JSON| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.job.status.get|<|<|<| |Возвращает состояние джобов.|Объект JSON| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.last.backup.get|<|<|<| |Возвращает для всех баз данных время последнего резервного копирования.|Объект JSON| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.local.db.get|<|<|<| |Возвращает базы данных, которые участвуют в группе доступности Always On, и реплики (основная или вторичная) расположены на сервере, к которому установлено подключение.|Объект JSON| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.mirroring.get|<|<|<| |Возвращает информацию о зеркалировании.|Объект JSON| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.nonlocal.db.get|<|<|<| |Возвращает базы данных, которые участвуют в группе доступности Always On и реплики (основная или вторичная) расположены на других серверах (база данных не является локальной на экземпляре сервера SQL, к которому установлено подключение).|Объект JSON| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.perfcounter.get|<|<|<| |Возвращает счётчики производительности.|Объект JSON| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.ping|<|<|<| |Пинг базы данных. Тестирует, верно ли настроено подключение.|1 — жив,<br>0 — не жив| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.quorum.get|<|<|<| |Возвращает информацию о кворуме.|Объект JSON| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.quorum.members.get|<|<|<| |Возвращает информацию о членах кворума.|Объект JSON| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.replica.get|<|<|<| |Возвращает реплики.|Объект JSON| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.version|<|<|<| |Возвращает версию MSSQL.|Строка| |Поддерживается с версии Zabbix 6.0.27. Для получения дополнительной информации см. readme [плагина MSSQL \[en\]](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| #### 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: ```javascript 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*: - Создайте элемент данных с типом «Скрипт».\ - В поле *Скрипт* введите следующий код: ```javascript 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) агента Alias, чтобы разрешить использовать отличающиеся ключи элементов данных обнаружений в различных правилах обнаружения, например: `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 в режиме multi‐primary При использовании Групповой Репликации MySQL 8.0 в режиме multi‐primary вы можете столкнуться с ошибкой во время фиксации транзакции, похожей на следующую: 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;] Эта ошибка, по-видимому, вызвана проблемами с операциями отката, включающими ограничения внешнего ключа (foreign key constraints). Смотрите также: - [ZBX-26060 \[en\]](https://support.zabbix.com/browse/ZBX-26060) для связанного отчета о проблеме. - [MySQL Bug #96758 "Rollbacks with Foreign Keys on single node" \[en\]](https://bugs.mysql.com/bug.php?id=96758) относительно вышестоящей проблемы. #### MySQL 8.0+ with mysqlsh This method can be used with a running Zabbix server, but it is recommended to stop the server for the time of the upgrade. The MySQL Shell (*mysqlsh*) must be [installed](https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-install-linux-quick.html) and able to connect to the DB. * Log in to MySQL console as root (recommended) or as any user with FILE privileges. * Start MySQL with the [local_infile](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_local_infile) variable enabled. * Rename old tables and create new tables by running `history_pk_prepare.sql`. ``` {.bash} mysql -uzabbix -p<password> zabbix < /usr/share/zabbix-sql-scripts/mysql/history_pk_prepare.sql ``` * Export and import data. Connect via mysqlsh. If using a socket connection, specifying the path might be required. sudo mysqlsh -uroot -S /run/mysqld/mysqld.sock --no-password -Dzabbix Run (CSVPATH can be changed as needed): ``` {.javascript} 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" }); ``` * Follow [post-migration instructions](#post-migration) to drop the old tables. #### MySQL 8.0+ с mysqlsh Этот метод можно использовать при работающем сервере Zabbix, но рекомендуется остановить сервер на время обновления. Оболочка MySQL (*mysqlsh*) должна быть [установлена](https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-install-linux-quick.html) и способна подключаться к базе данных. * Подключитесь к консоли MySQL как root (рекомендуемый вариант) или как любой пользователь с привилегиями FILE. * Запустите MySQL с активированной переменной [local_infile](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_local_infile). * Переименуйте старые таблицы и создайте новые таблицы путём запуска `history_pk_prepare.sql`. ``` {.bash} mysql -uzabbix -p<пароль> zabbix < /usr/share/zabbix-sql-scripts/mysql/history_pk_prepare.sql ``` * Сделайте экспорт и импорт данных. Подключитесь через mysqlsh. При использовании сокет-подключения может потребоваться указать путь. sudo mysqlsh -uroot -S /run/mysqld/mysqld.sock --no-password -Dzabbix Выполните (CSVPATH может быть изменён, как нужно): ``` {.javascript} 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" }); ``` * Следуйте [инструкциям по пост-миграции](#пост-миграция) для удаления старых таблиц. #### 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MySQL теперь 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.1 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MySQL теперь 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MySQL теперь 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MySQL теперь 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MySQL теперь 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 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MySQL теперь 9.5.X. #### MySQL 9.6 support The maximum [supported version](/manual/installation/requirements#thirdparty-external-surrounding-software) for MySQL is now 9.6.X. #### Поддержка MySQL 9.6 Максимально [поддерживаемая версия](/manual/installation/requirements#стороннее-внешнее-программное-обеспечение) для MySQL теперь 9.6.X. #### MySQL configuration Modern versions of the database are ready out-of-the-box for `required` [encryption mode](/manual/appendix/install/db_encrypt#terminology). A server-side certificate will be created after initial setup and launch. Create users and roles for the main components: mysql> CREATE USER   'zbx_srv'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>',   'zbx_web'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>' REQUIRE SSL   PASSWORD HISTORY 5; mysql> CREATE ROLE 'zbx_srv_role', 'zbx_web_role'; mysql> GRANT SELECT, UPDATE, DELETE, INSERT, CREATE, DROP, ALTER, INDEX, REFERENCES ON zabbix.* TO 'zbx_srv_role'; mysql> GRANT SELECT, UPDATE, DELETE, INSERT ON zabbix.* TO 'zbx_web_role'; mysql> GRANT 'zbx_srv_role' TO 'zbx_srv'@'%'; mysql> GRANT 'zbx_web_role' TO 'zbx_web'@'%'; mysql> SET DEFAULT ROLE 'zbx_srv_role' TO 'zbx_srv'@'%'; mysql> SET DEFAULT ROLE 'zbx_web_role' TO 'zbx_web'@'%'; Note that the X.509 protocol is not used to check identity, but the user is configured to use only encrypted connections. See [MySQL documentation](https://dev.mysql.com/doc/refman/8.0/en/create-user.html#create-user-tls) for more details about configuring users. Run to check connection (socket connection cannot be used to test secure connections): mysql -u zbx_srv -p -h 10.211.55.9 --ssl-mode=REQUIRED Check current status and available cipher suites: mysql> status -------------- mysql Ver 8.0.21 for Linux on x86_64 (MySQL Community Server - GPL) Connection id: 62 Current database: Current user: zbx_srv@bfdb.local SSL: Cipher in use is TLS_AES_256_GCM_SHA384 mysql> SHOW SESSION STATUS LIKE 'Ssl_cipher_list'\G; *************************** 1. row *************************** Variable_name: Ssl_cipher_list Value: TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256:TLS_AES_128_CCM_SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-DSS-AES128-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES256-SHA:CAMELLIA256-SHA:CAMELLIA128-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA 1 row in set (0.00 sec) ERROR: No query specified #### Настройка MySQL Современные версии базы данных готовы для [режима шифрования](/manual/appendix/install/db_encrypt#терминология) `required` «прямо из коробки». Сертификат на стороне сервера будет создан после первоначальной настройки и запуска. Создайте пользователей и роли для основных компонентов: mysql> CREATE USER   'zbx_srv'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>',   'zbx_web'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>' REQUIRE SSL   PASSWORD HISTORY 5; mysql> CREATE ROLE 'zbx_srv_role', 'zbx_web_role'; mysql> GRANT SELECT, UPDATE, DELETE, INSERT, CREATE, DROP, ALTER, INDEX, REFERENCES ON zabbix.* TO 'zbx_srv_role'; mysql> GRANT SELECT, UPDATE, DELETE, INSERT ON zabbix.* TO 'zbx_web_role'; mysql> GRANT 'zbx_srv_role' TO 'zbx_srv'@'%'; mysql> GRANT 'zbx_web_role' TO 'zbx_web'@'%'; mysql> SET DEFAULT ROLE 'zbx_srv_role' TO 'zbx_srv'@'%'; mysql> SET DEFAULT ROLE 'zbx_web_role' TO 'zbx_web'@'%'; Обратите внимание, что протокол X.509 не используется для проверки идентичности, но пользователь настраивается на использование только шифрованных соединений. Обратитесь к [документации MySQL \[en\]](https://dev.mysql.com/doc/refman/8.0/en/create-user.html#create-user-tls) за подробностями относительно настроек пользователя. Выполните проверку подключения (подключения на базе сокета нельзя использовать для тестирования безопасных соединений): mysql -u zbx_srv -p -h 10.211.55.9 --ssl-mode=REQUIRED Проверить текущее состояние и доступные наборы шифров: mysql> status -------------- mysql Ver 8.0.21 for Linux on x86_64 (MySQL Community Server - GPL) Connection id: 62 Current database: Current user: zbx_srv@bfdb.local SSL: Cipher in use is TLS_AES_256_GCM_SHA384 mysql> SHOW SESSION STATUS LIKE 'Ssl_cipher_list'\G; *************************** 1. row *************************** Variable_name: Ssl_cipher_list Value: TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256:TLS_AES_128_CCM_SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-DSS-AES128-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES256-SHA:CAMELLIA256-SHA:CAMELLIA128-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA 1 row in set (0.00 sec) ERROR: No query specified #### MySQL configuration Set MySQL CE server configuration option (*/etc/my.cnf.d/server-tls.cnf*) to: [mysqld] ... # in this examples keys are located in the MySQL CE datadir directory ssl_ca=ca.pem ssl_cert=server-cert.pem ssl_key=server-key.pem require_secure_transport=ON tls_version=TLSv1.3 ... Keys for the MySQL CE server and client (Zabbix frontend) should be created manually according to the MySQL CE documentation: [Creating SSL and RSA certificates and keys using MySQL](https://dev.mysql.com/doc/refman/8.0/en/creating-ssl-rsa-files-using-mysql.html) or [Creating SSL certificates and keys using openssl](https://dev.mysql.com/doc/refman/5.7/en/creating-ssl-files-using-openssl.html) ::: noteimportant MySQL server certificate should contain the Common Name field set to the FQDN name as Zabbix frontend will use the DNS name to communicate with the database or IP address of the database host. ::: Create MySQL user: mysql> CREATE USER 'zbx_srv'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>', 'zbx_web'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>' REQUIRE X509 PASSWORD HISTORY 5; Check if it is possible to log in with that user: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=VERIFY_IDENTITY --ssl-ca=/var/lib/mysql/ca.pem --ssl-cert=/var/lib/mysql/client-cert.pem --ssl-key=/var/lib/mysql/client-key.pem #### Настройка MySQL Выставьте опции конфигурации сервера MySQL CE (*/etc/my.cnf.d/server-tls.cnf*) в: [mysqld] ... # in this examples keys are located in the MySQL CE datadir directory ssl_ca=ca.pem ssl_cert=server-cert.pem ssl_key=server-key.pem require_secure_transport=ON tls_version=TLSv1.3 ... Ключи для сервера MySQL CE и клиента (веб-интерфейс Zabbix) нужно создать вручную в соответствии с документацией MySQL CE documentation: [Creating SSL and RSA certificates and keys using MySQL \[en\]](https://dev.mysql.com/doc/refman/8.0/en/creating-ssl-rsa-files-using-mysql.html) или [Creating SSL certificates and keys using openssl \[en\]](https://dev.mysql.com/doc/refman/5.7/en/creating-ssl-files-using-openssl.html). ::: noteimportant Сертификат сервера MySQL должен содержать поле Common Name, заданное в FQDN-имя, поскольку веб-интерфейс Zabbix для коммуникаций с базой данных будет использовать DNS-имя или IP-адрес хоста базы данных. ::: Создайте пользователя: mysql> CREATE USER 'zbx_srv'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>', 'zbx_web'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>' REQUIRE X509 PASSWORD HISTORY 5; Проверьте, можно ли подключиться этим пользователем: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=VERIFY_IDENTITY --ssl-ca=/var/lib/mysql/ca.pem --ssl-cert=/var/lib/mysql/client-cert.pem --ssl-key=/var/lib/mysql/client-key.pem #### 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 Если Zabbix используется с MySQL инсталляцией в Azure, в журналах Zabbix может появиться расплывчатое сообщение об ошибке *\[9002\] Some errors occurred*. Этот общий текст ошибки отправляется 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-подключение к базе данных (TLS connection to database)» и значение секрета «MySQL database certificates (client)». ### 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, чтобы гарантировать, что сеанс не будет прерван. Смотрите также: [Важные примечания](#важные-примечания) #### MySQL If a value contains a non-ASCII character in non UTF8 encoding - this character and the following will be discarded when the database stores this value. No warning messages will be written to the *zabbix\_server.log*.<br> Relevant for at least MySQL version 5.1.61. #### MySQL Если значение содержит non-ASCII символ в не UTF8 кодировке — этот символ и следующий за ним символ будут отброшены при записи этого значения базой данных. Никакие предупреждающие сообщения не записываются в *zabbix\_server.log*.<br> Такое поведение соответствует по крайней мере MySQL версии 5.1.61. ### MySQL |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |mysql.custom.query\[connString,<username>,<password>,queryName,<args...>\]|<|<|<| |Returns the result of a custom query.|JSON object|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.<br>**queryName** - name of a custom query, must match SQL file name without an extension.<br>**args** - one or several comma-separated arguments to pass to a query.|Supported since Zabbix 6.0.21. For more information see the [MySQL plugin](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mysql/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mysql.db.discovery\[connString,<username>,<password>\]|<|<|<| |List of MySQL databases. Used for [low-level discovery](/manual/discovery/low_level_discovery).|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).|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. If none found, an error is returned. If this parameter is not specified, all hosts are returned.<br>Note that before Zabbix 6.0.23, the "masterHost" parameter is ignored and always the first master host is returned.| | |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.custom.query\[строка_подкл,<имя_пользователя>,<пароль>,имяЗапроса,<аргументы...>\]|<|<|<| |Возвращает результат пользовательского запроса.|Объект JSON|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные для входа в MySQL.<br>**имяЗапроса** — имя пользовательского запроса, должно совпадать с именем SQL файла без расширения.<br>**аргументы** — один или несколько перечисленных через запятую аргументов, которые будут переданы запросу.|Поддерживается с версии Zabbix 6.0.21. Для получения дополнительной информации смотрите файл readme [плагина MySQL](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mysql/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mysql.db.discovery\[строка_подкл, <имя_пользователя>, <пароль>\]|<|<|<| |Список баз данных MySQL. Используется [низкоуровневым обнаружением](/manual/discovery/low_level_discovery).|Результат SQL запроса «show databases» в формате LLD JSON.|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные для входа в MySQL.| | |mysql.db.size\[строка_подкл, <имя_пользователя>, <пароль>,имя_базы\]|<|<|<| |Размер базы данных в байтах.|Результат SQL запроса «select coalesce(sum(data\_length + index\_length),0) as size from information\_schema.tables where table\_schema=?» для указанной базы данных в байтах.|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные для входа в MySQL.<br>**имя_базы** — имя базы данных.| | |mysql.get\_status\_variables\[строка_подкл, <имя_пользователя>, <пароль>\]|<|<|<| |Значения глобальных переменных состояния.|Результат SQL запроса «show global status» в формате JSON.|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные для входа в MySQL.| | |mysql.ping\[строка_подкл, <имя_пользователя>, <пароль>\]|<|<|<| |Проверка, можно ли установить подключение.|1 — подключение успешно<br><br>0 — подключение разорвано (если имеется какая-либо ошибка, включая проблемы с аутентификацией или проблемы с настройками).|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные для входа в MySQL.| | |mysql.replication.discovery\[строка_подкл, <имя_пользователя>, <пароль>\]|<|<|<| |Список репликаций MySQL. Используется [низкоуровневым обнаружением](/manual/discovery/low_level_discovery).|Результат SQL запроса «show slave status» в формате LLD JSON.|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные для входа в MySQL.| | |mysql.replication.get\_slave\_status\[строка_подкл, <имя_пользователя>, <пароль>, <хост_мастера>\]|<|<|<| |Состояние репликации.|Результат SQL запроса «show slave status» в формате JSON.|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные для входа в MySQL.<br>**хост_мастера** — Имя хоста мастера репликации. Если не найдено, возвращается ошибка. Если данный параметр не указан, возвращаются все хосты.<br>Обратите внимание, что до версии Zabbix 6.0.23, параметр "хост_мастера" игнорируется и всегда возвращается первый хоста мастера.| | |mysql.version\[строка_подкл, <имя_пользователя>, <пароль>\]|<|<|<| |Версия MySQL.|Строка с версией MySQL экземпляра.|**строка_подкл** — URI или имя сессии.<br>**имя_пользователя, пароль** — учётные данные для входа в 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.** Проверьте набор символов базы данных и сопоставление. Например: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | latin2 | latin2 _general_ci | +--------------------------+----------------------+ Как мы видим, набор символов в выводе - не 'utf8', а сопоставление -не 'utf8\_bin', поэтому нам нужно их исправить. **2.** Остановите Zabbix. **3.** Создайте резервную копию базы данных! **4.** Исправьте набор символов и сопоставление на уровне базы данных: alter database <your DB name> character set utf8 collate utf8_bin; Исправленные значения: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | utf8 | utf8_bin | +--------------------------+----------------------+ **5.** Загрузите [скрипт](https://support.zabbix.com/secure/attachment/113858/113858_utf8_convert.sql), чтобы исправить набор символов и сопоставление на уровне таблицы и столбца: mysql <your DB name> < utf8_convert.sql **6.** Выполните скрипт: 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; Обратите внимание, что кодировка данных на диске будет изменена. Например, при преобразовании таких символов, как Æ, Ñ, Ö из 'latin1' в 'utf8' они перейдут с 1 байта на 2 байта. Таким образом, для исправленной базы данных может потребоваться больше места, чем раньше. **7.** Если ошибок нет - вы можете создать резервную копию базы данных с исправленной базой данных. **8.** Запустите Zabbix. #### MySQL/MariaDB 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. ```bash 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). ```bash cd database/mysql mysql -uzabbix -p<password> zabbix < schema.sql # stop here if you are creating database for Zabbix proxy mysql -uzabbix -p<password> zabbix < images.sql mysql -uzabbix -p<password> zabbix < data.sql ``` `log_bin_trust_function_creators` can be disabled after the schema has been successfully imported: ```bash mysql -uroot -p<password> mysql> SET GLOBAL log_bin_trust_function_creators = 0; mysql> quit; ``` #### MySQL/MariaDB Для корректной работы Zabbix сервера/прокси с базой данных MySQL поддерживаются наборы символов utf8 (также известный как utf8mb3) и utf8mb4 (с сопоставлениями utf8\_bin и utf8mb4\_bin соответственно). Для новых установок рекоммендуется использовать utf8mb4. Для Zabbix 6.0.11 и новее во время импорта схемы необходимо создавать детерминированные триггеры. В MySQL и MariaDB для этого необходимо установить `GLOBAL log_bin_trust_function_creators = 1`, если включено двоичное ведение журнала (binary logging) и нет привилегий суперпользователя, а параметр `log_bin_trust_function_creators = 1` не выставлен в файле конфигурации MySQL. Если Вы устанавливаете из Zabbix **пакетов**, следуйте [инструкциям](https://www.zabbix.com/download) для вашей платформы. Если Вы устанавливаете Zabbix из исходных кодов: * Создайте и настройте базу данных и пользователя. ```bash 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 не нужны). ```bash cd database/mysql mysql -uzabbix -p<password> zabbix < schema.sql # остановитесь здесь, если вы создаёте базу данных для Zabbix прокси mysql -uzabbix -p<password> zabbix < images.sql mysql -uzabbix -p<password> zabbix < data.sql ``` После успешного импорта схемы параметр `log_bin_trust_function_creators` можно выключить: ```bash mysql -uroot -p<password> mysql> SET GLOBAL log_bin_trust_function_creators = 0; mysql> quit; ``` #### 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 и производные от неё использовали «utf8» как синоним для utf8mb3 — собственная 3-байтовая реализация командой разработчиков MySQL стандарта UTF8, который является 4-байтовым. Начиная с версии MySQL 8.0.28 и MariaDB 10.6.1, набор символов «utf8mb3» является устаревшим, и в какой-то момент его поддержка будет прекращена, в то время как «utf8» станет ссылкой на «utf8mb4». Начиная с версии Zabbix 6.0, поддерживается «utf8mb4». Во избежание проблем в будущем, строго рекомендуется использовать «utf8mb4». Другим преимуществом переключения на «utf8mb4» является поддержка дополнительных символов Юникода. ::: notewarning Поскольку версии Zabbix до 6.0 не знают об utf8mb4, обеспечьте сначала обновление сервера Zabbix и схемы базы данных до версии 6.0.x, прежде чем выполнять переход на utf8mb4. ::: **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 <your DB name> 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 <your DB name> < utf8mb4_convert.sql **6.** Выполните скрипт: SET @ZABBIX_DATABASE = '<имя вашей базы данных>'; If MariaDB → set innodb_strict_mode = OFF; CALL zbx_convert_utf8(); If 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** Следующие параметры плагина MySQL более не являются обязательными, если Plugins.Mysql.Sessions.<ИмяСессии>.TLSConnect имеет одно из значений - *verify_ca* или *verify_full*: - Plugins.Mysql.Sessions.<ИмяСессии>.TLSCertFile - Plugins.Mysql.Sessions.<ИмяСессии>.TLSKeyFile ##### Named sessions Named sessions represent an additional level of plugin parameters and can be used to specify separate sets of authentication parameters for each of the instances being monitored. Each named session parameter should have the following structure: *Plugins.<PluginName>.Sessions.<SessionName>.<Parameter>=<Value>* A session name can be used as a connString item key parameter instead of specifying a URI, username, and/or password separately. In item keys, the first parameter can be either a connString or a URI. If the first key parameter doesn't match any session name, it will be treated as a URI. Note that embedding credentials into a URI is not supported, use named session parameters instead. The list of available [named session parameters](/manual/appendix/config/zabbix_agent2_plugins) depends on the plugin. *In Zabbix versions before 6.0.17*, when providing a connString (session name) in key parameters, item key parameters for username and password must be empty. The values will be taken from the session parameters. If an authentication parameter is not specified for the named session, a hardcoded default value will be used. *Since Zabbix 6.0.17*, it is possible to override session parameters by specifying new values in the item key parameters (see [example](#example-2)). *Since Zabbix 6.0.18*, if a parameter is not defined for the named session, Zabbix agent 2 will use the value defined in the [default plugin parameter](#default-values). ##### Именованные сессии Именованные сессии представляют дополнительный уровень параметров плагина и могут использоваться для определения отдельных наборов параметров аутентификации для каждого наблюдаемого экземпляра. Каждый параметр именованной сессии должен иметь следующую структуру: Plugins.<ИмяПлагина>.Sessions.<ИмяСессии>.<Параметр>=<Значение> Имя сессии может использоваться в качестве параметра строка_подключения в ключе элемента данных вместо указания URI, имени пользователя и пароля по отдельности. В ключах элементов данных первым параметром может быть либо строка_подключения, либо Uri. Если первый параметр ключа не совпадает ни с каким именем сессии, указанным в файле конфигурации, он будет рассматриваться как Uri. Обратите внимание, что передача встроенных в URI учётных данных не поддерживается, вместо этого рекомендуется использовать именованные сессии. Список доступных [параметров именованных сессий](/manual/appendix/config/zabbix_agent2_plugins) зависит от плагина. *В Zabbix до версии 6.0.17*, когда в параметрах ключа указывается строка_подключения (имя сессии), параметры ключа элемента данных для имени пользователя и пароля должны быть пустыми. Значения будут браться из параметров сессии. Если параметр аутентификации для именованной сессии не указан, будет использоваться жёстко заданное значение по умолчанию. *Начиная с Zabbix 6.0.17*, вы можете переопределить параметры сессии, указывая новые значения в параметрах ключа элемента данных (смотри [пример](#пример-2)). *Начиная с Zabbix 6.0.18*, если параметр не определён для именованной сессии, Zabbix агент 2 будет использовать значение, определённое в [параметрах плагина по умолчанию](#значения-по-умолчанию). ## 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 для получения метрик [ ]{#lbAC} ## NAME zabbix\_js - Zabbix JS utility [ ]{#lbAC} ## НАИМЕНОВАНИЕ zabbix\_js — утилита Zabbix для выполнения скриптов JavaScript [ ]{#lbAC} ## NAME zabbix\_proxy - Zabbix proxy daemon [ ]{#lbAC} ## НАИМЕНОВАНИЕ zabbix\_proxy — демон сервиса zabbix прокси [ ]{#lbAC} ## NAME zabbix\_sender - Zabbix sender utility [ ]{#lbAC} ## НАИМЕНОВАНИЕ zabbix\_sender — утилита Zabbix для отправки метрик [ ]{#lbAC} ## NAME zabbix\_server - Zabbix server daemon [ ]{#lbAC} ## НАИМЕНОВАНИЕ zabbix\_server — демон службы Zabbix сервера [ ]{#lbAC} ## NAME zabbix\_web\_service - Zabbix web service [ ]{#lbAC} ## НАИМЕНОВАНИЕ zabbix\_web\_service — веб-сервис Zabbix [ ]{#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 агент различает активные проверки по их ключам. Например, logrt\[/home/zabbix/test.log\] и logrt\[/home/zabbix/test.log,\] — разные элементы данных. Изменение в веб-интерфейсе элемента данных logrt\[/home/zabbix/test.log,,,10\] на logrt\[/home/zabbix/test.log,,,20\] приведёт к удалению элемента данных logrt[/home/zabbix/test.log,,,10] из списка активных проверок агента и созданию элемента данных logrt\[/home/zabbix/test.log,,,20\] \(некоторые атрибуты сохраняются при изменениях в веб-интерфейсе / на стороне сервера, но не на стороне агента\). Имя файла состоит из MD5 суммы ключа элемента данных с длиной ключа, добавляемой для уменьшения возможных пересечений. Например, состояние элемента данных logrt\[/home/zabbix50/test.log,,,,,,,,/home/zabbix50/agent_private\] будет храниться в постоянном файле c963ade4008054813bbc0a650bb8e09266. Несколько элементов данных могут использовать одно и то же значение **постоянного\_хранилища**. **постоянное\_хранилище** указывается с учетом структуры конкретной файловой системы, точек монтирования и опций монтирования, а также настроек зеркалирования хранилища — постоянный файл должен располагаться на том же зеркале файловой системы, что и наблюдаемый файл журнала. Если директорию **постоянного\_хранилища** не удаётся создать или она не существует, или права доступа Zabbix агента не позволяют создавать/записывать/читать/удалять файлы, тогда элемент данных журнала становится НЕПОДДЕРЖИВАЕМЫМ. ##### 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. ##### Соглашение об именах Прежде чем создавать модуль, важно придти к соглашению об именах для различных элементов модуля, таких как папки и файлы, чтобы мы могли придерживаться организованной структуры. Вы также можете найти примеры выше, в разделе [Структура модуля](#структура-модуля). |Элемент|Правила именования|Пример| |----|------------|-------| |*Папка модуля*|Строчные буквы \[a-z\], нижнее подчёркивание и десятичные цифры|example\_v2| |*Папки действий*|Строчные буквы \[a-z\] и нижнее подчёркивание|data\_export| |*Файлы действий*|CamelCase, заканчивающийся типом действия|SomethingView.php| |*Файлы представлений и составляющих*|Строчные буквы \[a-z\]<br>Слова, разделённые точкой<br>С префиксом `module.`, за которым следует имя модуля<br>Оканчивается типом действия и расширением файла `.php`|module.example.something.view.php| |*Файлы Javascript*|Те же правила, что и для файлов представлений и составляющих, за исключением расширения: `.js.php` .|module.example.something.view.js.php| Обратите внимание, что префикс 'module' и включение имени модуля является обязательным для файлов представлений и составляющих, за исключением случаев, когда нужно заменить базовые отображаемые элементы или составляющие Zabbix. Однако, это правило не распространяется на имена файлов действий. 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 sender и содержат штамп времени более старый, чем время создания проблемы, в этом случае также отобразится отрицательная длительность проблемы. ::: 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 и новее Различные процессы Zabbix могут случайным образом аварийно завершать работу при запуске на NetBSD версий 8.X и 9.X. Такое поведение связано со слишком малым размером стека по умолчанию (4МБ), который необходимо увеличить, выполнив: ulimit -s 10240 Для получения более подробной информации, пожалуйста, обратитесь к соответствующему отчёту о проблеме: [ZBX-18275](https://support.zabbix.com/browse/ZBX-18275). #### Net service name Since Zabbix 5.4.0 it is possible to connect to Oracle by using net service name. <net\_service\_name> is a simple name for a service that resolves to a connect descriptor. In order to use the service name for creating a connection, this service name has to be defined in the tnsnames.ora file located on both the database server and the client systems. The easiest way to make sure that the connection will succeed is to define the location of tnsnames.ora file in the TNS\_ADMIN environment variable. The default location of the tnsnames.ora file is: $ORACLE_HOME/network/admin/ A simple tnsnames.ora file example: ORCL = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = ORCL) ) ) To set configuration parameters for the "Net Service Name" connection method, use one of the following options: - Set an empty parameter DBHost and set DBName as usual: ```{=html} <!-- --> ``` DBHost= DBName=ORCL - Set both parameters and leave both empty: ```{=html} <!-- --> ``` DBHost= DBName= In the second case, the TWO\_TASK environment variable has to be set. It specifies the default remote Oracle service (service name). When this variable is defined, the connector connects to the specified database by using an Oracle listener that accepts connection requests. This variable is for use on Linux and UNIX only. Use the LOCAL environment variable for Microsoft Windows. **Example:** Connect to a database using Net Service Name set as ORCL and the default port. Database parameters set in the server or proxy configuration file (zabbix\_server.conf and zabbix\_proxy.conf): DBHost= #DBPort= DBUser=myusername DBName=ORCL DBPassword=mypassword During Zabbix frontend installation, set the corresponding parameters in the *Configure DB connection* step of the setup wizard: - Database host: - Database port: 0 - 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"] = ''; $DB["PORT"] = '0'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; Connection string used by Zabbix to establish connection: DBUser/DBPassword@ORCL #### Имя сетевой службы (Net Service Name) Начиная с версии Zabbix 5.4.0, возможно подключиться к Oracle, используя имя сетевой службы. <net\_service\_name> — это простое имя для службы, которое раскрывается в дескриптор соединения. Чтобы использовать имя службы для создания подключения, это имя службы должно быть определено в файле tnsnames.ora, расположенном как на сервере базы данных, так и на клиентской системе. Самый лёгкий способ убедиться, что соединение будет установлено успешно, — это определить местоположение файла tnsnames.ora в переменной окружения TNS\_ADMIN. По умолчанию местоположение файла tnsnames.ora такое: $ORACLE_HOME/network/admin/ Простой пример файла tnsnames.ora: ORCL = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = ORCL) ) ) Чтобы задать параметры конфигурации для метода подключения «Имя сетевой службы», используйте одну из следующих опций: - Задайте параметр DBHost пустым, а параметр DBName — как обычно: ```{=html} <!-- --> ``` DBHost= DBName=ORCL - Задайте оба параметра и оставьте их пустыми: ```{=html} <!-- --> ``` DBHost= DBName= Во втором случае должна быть установлена переменная окружения TWO\_TASK. Она указывает удалённую службу Oracle (имя службы) по умолчанию. Когда эта переменная определена, коннектор подключается к указанной базе, используя Oracle листенер (listener), принимающий запросы на соединения. Эта переменная используется только в Linux и UNIX. Для Microsoft Windows используйте переменную среды LOCAL. **Пример:** Подключиться к базе данных, используя имя сетевой службы, заданное как ORCL, и порт по умолчанию. Параметры базы данных задаются в файле конфигурации сервера или прокси (zabbix\_server.conf и zabbix\_proxy.conf): DBHost= #DBPort= DBUser=myusername DBName=ORCL DBPassword=mypassword Во время установки веб-интерфейса Zabbix, задайте соответствующие параметры на шаге *Настройка подключения к БД* помощника по установке: - Хост базы данных: - Порт базы данных: 0 - Имя базы данных: ORCL - Пользователь: myusername - Пароль: mypassword {width="600"} Альтернативный вариант — можно задать эти параметры в файле конфигурации веб-интерфейса (zabbix.conf.php): $DB["TYPE"] = 'ORACLE'; $DB["SERVER"] = ''; $DB["PORT"] = '0'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; Строка подключения, используемая Zabbix-ом, чтобы установить соединение: DBUser/DBPassword@ORCL ##### 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>,имя,<тип>,<время ожидания>,<количество>,<протокол>\]|<|<|<| |Проверка, работает ли DNS сервис.|0 — DNS не работает (сервер не ответил или ответ DNS некорректен)<br><br>1 — DNS работает|**ip** — IP адрес DNS сервера (оставьте пустым, чтобы использовались DNS сервера по умолчанию, на Windows поддерживается Zabbix агентом 2, игнорируется Zabbix агентом)<br>**имя** — проверяемое имя DNS<br>**тип** — запрашиваемый тип записи (по умолчанию SOA)<br>**время ожидания** (игнорируется в Windows, если только не используется Zabbix агент 2 версии 6.0.1 или новее) — время ожидания ответа в секундах (по умолчанию 1 секунда)<br>**количество** (игнорируется в Windows, если только не используется Zabbix агент 2 версии 6.0.1 или новее) — количество попыток запросов (по умолчанию 2)<br>**протокол** (с версии 3.0) — используемый протокол при выполнении DNS запросов: *udp* (по умолчанию) или *tcp*|*Пример*:<br>=> net.dns\[8.8.8.8,zabbix.com,MX,2,1\]<br><br>Возможные значения для `тип`:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (не поддерживается Zabbix агентом на Windows, 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>,имя,<тип>,<время ожидания>,<количество>,<протокол>\]|<|<|<| |Выполнение DNS запроса.|Строка символов с требуемым типом информации|**ip** — IP адрес DNS сервера (оставьте пустым, чтобы использовались DNS сервера по умолчанию, игнорируется в Windows, если только не используется Zabbix агент 2 версии 6.0.1 или новее)<br>**имя** — проверяемое имя DNS<br>**тип** — запрашиваемый тип записи (по умолчанию *SOA*)<br>**время ожидания** (игнорируется в Windows, если только не используется Zabbix агент 2 версии 6.0.1 или новее) — время ожидания ответа в секундах (по умолчанию 1 секунда)<br>**количество** (игнорируется в Windows, если только не используется Zabbix агент 2 версии 6.0.1 или новее) — количество попыток запросов (по умолчанию 2)<br>**протокол** (с версии 3.0) — используемый протокол при выполнении DNS запросов: *udp* (по умолчанию) или *tcp*|*Пример ключа*:<br>=> net.dns.record\[8.8.8.8,zabbix.com,MX,2,1\]<br><br>Возможные значения для `тип`:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (не поддерживается Zabbix агентом на Windows, 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.query*| |**net.if.collisions**\[if\]|<|<|<| |Коллизии за пределами окна (out-of-window).|Целое число|**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,<режим>\]|<|<|<| |Статистика по входящему трафику сетевого интерфейса.|Целое число|**if** — имя сетевого интерфейса (Unix); полное описание сетевого интерфейса или IPv4 адрес; или, если в фигурных скобках, GUID сетевого интерфейса (Windows)<br>**режим** — возможные значения:<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>Вы можете получить описания сетевых интерфейсов в Windows, используя элементы данных net.if.discovery или net.if.list.<br><br>Вы можете использовать этот ключ с шагом предобработки *Изменение в секунду* для получения статистики байт в секунду.| |**net.if.out**\[if,<режим>\]|<|<|<| |Статистика по исходящему трафику сетевого интерфейса.|Целое число|**if** — имя сетевого интерфейса (Unix); полное описание сетевого интерфейса или IPv4 адрес; или, если в фигурных скобках, GUID сетевого интерфейса (Windows)<br>**режим** — возможные значения:<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>Вы можете получить описания сетевых интерфейсов в Windows, используя элементы данных net.if.discovery или net.if.list.<br><br>Вы можете использовать этот ключ с шагом предобработки *Изменение в секунду* для получения статистики байт в секунду.| |**net.if.total**\[if,<режим>\]|<|<|<| |Суммарная статистика входящего и исходящего трафика на сетевом интерфейсе.|Целое число|**if** — имя сетевого интерфейса (Unix); полное описание сетевого интерфейса или IPv4 адрес; или, если в фигурных скобках, GUID сетевого интерфейса (Windows)<br>**режим** — возможные значения:<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>Вы можете получить описания сетевых интерфейсов в Windows, используя элементы данных net.if.discovery или net.if.list.<br><br>Вы можете использовать этот ключ с шагом предобработки *Изменение в секунду* для получения статистики байт в секунду.<br><br>Обратите внимание, отброшенные пакеты поддерживаются только, если оба ключа net.if.in и net.if.out работают с отброшенными пакетами на вашей платформе.| |**net.tcp.listen**\[порт\]|<|<|<| |Проверка, находится ли TCP порт в состоянии LISTEN.|0 — не находится в состоянии LISTEN<br><br>1 — находится в состоянии LISTEN|**порт** — номер TCP порта|Пример:<br>=> net.tcp.listen\[80\]<br><br>В Linux поддерживается Zabbix агентом, начиная с версии 1.8.4<br><br>Начиная с Zabbix 3.0.0, в ядрах Linux 2.6.14 и более новых, информация о TCP сокетах в состоянии listen берётся из интерфейса ядра NETLINK, если это возможно. В противном случае, информация берётся из файлов /proc/net/tcp и /proc/net/tcp6.| |**net.tcp.port**\[<ip>,порт\]|<|<|<| |Проверка возможности создания TCP подключения на указанный номер порта.|0 — не удалось подключиться<br><br>1 — удалось подключиться|**ip** — IP адрес или DNS имя (по умолчанию 127.0.0.1)<br>**порт** — номер порта|Пример:<br>=> net.tcp.port\[,80\] → можно использовать для проверки доступности веб-сервера, работающего на 80 порту.<br><br>Для простого тестирования производительности TCP используйте net.tcp.service.perf\[tcp,<ip>,<порт>\]<br><br>Обратите внимание, что эти проверки могут привести к дополнительным записям в системных файлах журналов (обычно журналируются сессии SMTP и SSH).| |**net.tcp.service**\[сервис,<ip>,<порт>\]|<|<|<| |Проверка, запущен ли сервис и принимает ли он TCP подключения.|0 — сервис недоступен<br><br>1 — сервис запущен|**сервис** — один из:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (смотри [подробности](/manual/appendix/items/service_check_details))<br>**ip** — IP адрес или DNS имя (по умолчанию 127.0.0.1)<br>**порт** — номер порта (по умолчанию используется стандартный номер порта сервиса)|Пример:<br>=> net.tcp.service\[ftp,,45\] — можно использовать для тестирования доступности FTP сервера на TCP 45 порту.<br><br>Обратите внимание, что эти проверки могут привести к дополнительным записям в системных файлах журналов (обычно журналируются сессии SMTP и SSH).<br><br>Проверка шифрованных протоколов (таких как IMAP на 993 порту или POP на 995 порту) в настоящее время не поддерживается. В качестве обходного решения, пожалуйста, для подобных проверок используйте net.tcp.port.<br><br>Проверка LDAP и HTTPS на платформе Windows поддерживается только Zabbix агентом 2.<br><br>Обратите внимание, что telnet проверка ищет запрос на вход (с «:» в конце).<br><br>Сервисы *https* и *telnet* поддерживается Zabbix с версии 2.0.| |**net.tcp.service.perf**\[сервис,<ip>,<порт>\]|<|<|<| |Проверка производительности TCP сервиса.|Число с плавающей точкой<br><br>0 — сервис недоступен<br><br>секунды — количество секунд, потраченное на подключение к сервису|**сервис** — один из:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (смотри [детали](/manual/appendix/items/service_check_details))<br>**ip** — IP адрес или DNS имя (по умолчанию 127.0.0.1)<br>**порт** — номер порта (по умолчанию используется стандартный номер порта сервиса)|Пример:<br>=> net.tcp.service.perf\[ssh\] — можно использовать для тестирования скорости изначального ответа от SSH сервера.<br><br>Проверка шифрованных протоколов (таких как IMAP на 993 порту или POP на 995 порту) в настоящее время не поддерживается. В качестве обходного решения, пожалуйста, для подобных проверок используйте net.tcp.service.perf\[tcp,<ip>,<порт>\].<br><br>Проверка LDAP и HTTPS на платформе Windows поддерживается только Zabbix агентом 2.<br><br>Обратите внимание, что telnet проверка ищет запрос на вход (с «:» в конце).<br><br>Сервисы *https* и *telnet* поддерживается Zabbix с версии 2.0.| |**net.tcp.socket.count**\[<локальный_адрес>,<локальный_порт>,<удалённый_адрес>,<удалённый_порт>,<состояние>\]|<|<|<| |Получение количества TCP сокетов соответствующих заданным параметрам.|Целое число|**локальный_адрес** — локальный IPv4/6 адрес или CIDR подсеть<br>**локальный_порт** — номер локального порта или имя сервиса<br>**удалённый_адрес** — удалённый IPv4/6 адрес или CIDR подсеть<br>**удалённый_порт** — номер удалённого порта или имя сервиса<br>**состояние** — состояние соединения (*established*, *syn\_sent*, *syn\_recv*, *fin\_wait1*, *fin\_wait2*, *time\_wait*, *close*, *close\_wait*, *last\_ack*, *listen*, *closing*)|Этот элемент данных поддерживается только на Linux как Zabbix агентом, так и агентом 2. В Zabbix агенте 2 этот ключ также поддерживается на 64-битной Windows.<br><br>Например:<br>=> net.tcp.socket.count\[,80,,,established\] → получение количества соединений на локальный TCP порт 80 в состоянии «established»<br><br>Этот элемент данных поддерживается, начиная с Zabbix 6.0.| |**net.udp.listen**\[порт\]|<|<|<| |Проверка, находится ли UDP порт в состоянии LISTEN.|0 — не находится в состоянии LISTEN<br><br>1 — находится в состоянии LISTEN|**порт** — номер UDP порта|Например:<br>=> net.udp.listen\[68\]<br><br>В Linux поддерживается Zabbix агентом, начиная с версии 1.8.4| |**net.udp.service**\[сервис,<ip>,<порт>\]|<|<|<| |Проверка, запущен ли сервис и отвечает ли он на UDP запросы.|0 — сервис недоступен<br><br>1 — сервис запущен|**сервис** — *ntp* (смотрите [подробности](/manual/appendix/items/service_check_details))<br>**ip** — IP адрес или DNS имя (по умолчанию 127.0.0.1)<br>**порт** — номер порта (по умолчанию используется стандартный номер порта сервиса)|Пример:<br>=> net.udp.service\[ntp,,45\] → можно использовать для тестирования доступности NTP сервиса на 45 порту UDP.<br><br>Этот элемент данных поддерживается, начиная с Zabbix 3.0.0, но *ntp* сервис был доступен в net.tcp.service\[\] элементе данных и в предыдущих версиях.| |**net.udp.service.perf**\[сервис,<ip>,<порт>\]|<|<|<| |Проверка производительности UDP сервиса.|0 — сервис недоступен<br><br>секунды — количество секунд, потраченное на ожидание ответа от сервиса|**сервис** — *ntp* (смотрите [подробности](/manual/appendix/items/service_check_details))<br>**ip** — IP адрес или DNS имя (по умолчанию 127.0.0.1)<br>**порт** — номер порта (по умолчанию используется стандартный номер порта сервиса)|Пример:<br>=> net.udp.service.perf\[ntp\] → можно использовать для тестирования времени отклика от NTP сервиса.<br><br>Этот элемент данных поддерживается, начиная с Zabbix 3.0.0, но *ntp* сервис был доступен в net.tcp.service\[\] элементе данных и в предыдущих версиях.| |**net.udp.socket.count**\[<локальный_адрес>,<локальный_порт>,<удалённый_адрес>,<удалённый_порт>,<состояние>\]|<|<|<| |Получение количества UDP сокетов, соответствующих заданным параметрам.|Целое число|**локальный_адрес** — локальный IPv4/6 адрес или CIDR подсеть<br>**локальный_порт** — номер локального порта или имя сервиса<br>**удалённый_адрес** — удалённый IPv4/6 адрес или CIDR подсеть<br>**удалённый_порт** — номер удалённого порта или имя сервиса<br>**состояние** — состояние соединения (*established*, *unconn*)|Этот элемент данных поддерживается только на Linux как Zabbix агентом, так и агентом 2. В Zabbix агенте 2 этот ключ также поддерживается на 64-битной Windows.<br><br>Например:<br>=> net.tcp.socket.count\[,,,,established\] → возвращает количество UDP сокетов в состоянии «established»<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#примечания)^| |-|------------------------------|----------| |Интервал обновления|<|нет| |*SNMP v1, v2*|<|<| | |SNMP community|да| |^|SNMP OID|да| |*SNMP v3*|<|<| | |Имя контекста|да| |^|Имя безопасности|да| |^|Пароль аутентификации|да| |^|Ключевая фраза безопасности|да| |^|SNMP OID|да| #### New action Delivering notifications is one of the things [actions](/manual/config/notifications/action) do in Zabbix. Therefore, to set up a notification, go to *Configuration → Actions* and click *Create action*.  All mandatory input fields are marked with a red asterisk. In this form, enter a name for the action. In the most simple case, if we do not add any more specific [conditions](/manual/config/notifications/action/conditions), the action will be taken upon any trigger change from 'Ok' to 'Problem'. We still should define what the action should do - and that is done in the *Operations* tab. Click on *Add* in the Operations block, which opens a new operation form.  All mandatory input fields are marked with a red asterisk. Here, click on *Add* in the *Send to Users* block and select the user ('user') we have defined. Select 'Email' as the value of *Send only to*. When done with this, click on *Add*, and the operation should be added: {width="600"} That is all for a simple action configuration, so click *Add* in the action form. #### Новое действие Доставка оповещений является одной из задач [действий](/manual/config/notifications/action), которые делаются в Zabbix. Поэтому для настройки оповещений перейдите в *Настройка → Действия* и нажмите на *Создать действие*.  Все обязательные поля ввода отмечены красной звёздочкой. В этом диалоге введите имя действия. В простейшем случае, если мы не будем добавлять более конкретных [условий](/manual/config/notifications/action/conditions), действие будет выбрано при изменении состояния любого триггера с «ОK» на «Проблема». Ещё нужно определить, что именно действие должно делать — это настраивается на вкладке *Операции*. Нажмите во блоке *Операции* на *Добавить*, откроется диалог новой операции.  Все обязательные поля ввода отмечены красной звёздочкой. Здесь, нажмите на *Добавить* в блоке *Отправка пользователям* и выберите пользователя («user»), которого мы добавили. В поле *Отправлять только через* выберите значение «Email». Когда закончите с этим, нажмите на *Добавить* и операция добавится: {width="600"} Это всё, что требуется для настройки простого действия, поэтому нажмите на *Добавить* в диалоге действия. ### New functions ### Новые функции #### 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` добавлен новый индекс, чтобы сократить время ответа базы данных и веб-интерфейса при фильтрации записей по *Recordset ID* в [Журнале аудита](/manual/web_interface/frontend_sections/reports/audit). Обратите внимание, что пользователи с большими журналами аудита могут столкнуться с увеличением времени обновления из-за размера базы данных. #### 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. #### Новый элемент данных для плагина PostgreSQL Zabbix agent 2 В плагин PostgreSQL Zabbix agent 2 добавлен новый [элемент данных](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#postgresql), **pgsql.version**. Этот элемент данных возвращает версию 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 Был добавлен новый элемент данных для плагина MySQL для Zabbix агента 2. Этот новый элемент данных, [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. ### Макросы позиции более не поддерживаются Поддержка макросов позиции в имени элемента данных ($1, $2...$9), считалась устаревшей начиная с Zabbix 4.0, и теперь, полностью удалена. #### 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. Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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 (Oracle Cloud Infrastructure, OCI). Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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 Cluster by HTTP* для мониторинга каждого кластера YugabyteDB. Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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. Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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. Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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) Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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) Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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) Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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*. Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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#new_templates) in Zabbix 6.0.0 ##### Новые шаблоны Смотрите список [новых шаблонов](/manual/introduction/whatsnew600#шаблоны) в Zabbix 6.0.0 #### 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). Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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*. Вы можете получить этот шаблон: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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. Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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. Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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 агент. Вы можете получить эти шаблоны: - В *Настройка* → *Шаблоны* на новых инсталляциях; - При обновлении с предыдущих версий последние шаблоны можно загрузить из [Git репозитория Zabbix](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, имеется возможность работы с пользовательскими MBean, возвращающими непримитивные типы данных, которые переопределяют метод **toString()**. ### Notation ### Обозначение ::: noteclassic If installing from [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), you need to run the following command prior to proceeding to the next steps: <br><br> `make dbschema` ::: ::: noteclassic При установке из [Zabbix Git репозитория](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), Вам необходимо выполнить следующую команду прежде, чем приступать к последующим шагам: <br><br> `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 Для поддержки SourceIP в простых проверках LDAP (например в `net.tcp.service[ldap]`) требуется OpenLDAP версии 2.6.1 или новее. SourceIP поддерживается в простых проверках LDAP с версии Zabbix 6.0.1. ::: ::: 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. ::: ::: noteimportant Инструкции, представленные на этой странице, предназначены для опытных пользователей; возможно, их потребуется скорректировать для вашей конкретной конфигурации. Обновление до первичных ключей может занять много времени и ресурсов. Убедитесь, что на диске достаточно свободного места; в зависимости от размера вашей базы данных и хранимых данных, процессу может потребоваться место, до 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. При выборе параметров для ключа элемента данных proc.mem[] на AIX, попытайтесь указать узкие критерии выбора процесса. В противном случае есть риск того, что в результат proc.mem[] окажутся сосчитаны нежелательные процессы. Пример: ``` $ zabbix_agentd -t proc.mem[,,,НесуществующийПроцесс,rss] proc.mem[,,,НесуществующийПроцесс,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 деактивированы / не поддерживаются на узле сети, сам узел сети деактивирован/удалён, узел сети находится в режиме обслуживания и так далее), то соединение будет разорвано со стороны Zabbix сервера и прокси через 3 — 4 часа, в зависимости от времени запуска Zabbix сервера/прокси. #### 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>,<индекс CPU на узле NUMA>)\% 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`» (или какую-то другую цифру или символ), добавленный в конце имени. Например, тогда как `ipmitool` и OpenIPMI-2.0.19 отображают имена датчиков как «`PhysicalSecurity`» или «`CATERR`», в OpenIPMI-2.0.16, 2.0.17 и 2.0.18 эти имена — «`PhysicalSecurity0`» или «`CATERR0`» соответственно. При настройке элемента данных IPMI для Zabbix сервера, использующего OpenIPMI-2.0.16, 2.0.17 и 2.0.18, добавьте к их именам «0» в поле *IPMI датчик* для элементов данных IPMI агента. Когда ваш Zabbix сервер будет обновлён в новом Linux дистрибутиве, использующем OpenIPMI-2.0.19 (или более позднюю), элементы данных с такими IPMI дискретными датчиками перейдут в состояние «НЕ ПОДДЕРЖИВАЕТСЯ». Вам потребуется изменить их имена *IPMI датчик* (удалить «0» в конце) и подождать некоторое время, пока они станут «Активированными» снова. #### 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` подразумевает, что разные файлы журналов имеют разные записи (по крайней мере штампы времени в них отличаются), поэтому MD5 суммы начальных блоков (до первых 512 байт) будут отличаться. Два файла с одинаковыми MD5 суммами начальных блоков означают, что один из них оригинал, а второй — копия. Элемент данных `logrt` с опцией `copytruncate` делает попытку корректной обработки копий файлов журналов без дубликатов сообщений. Тем не менее, такие варианты как создание нескольких копий файлов журналов с одинаковыми штампами времени, ротация файлов журналов чаще чем интервал обновления logrt\[\] элемента данных, частый перезапуск агента — не рекомендуются. Агент пытается справиться со всеми этими ситуациями, но хорошие результаты не гарантируются при всех обстоятельствах. #### Notes on inclusion The `Include` statement in configuration files is processed immediately when encountered. For predictable behavior, it is recommended to place the `Include` parameter at the end of the configuration file. If the `Include` parameter is used for including a file, the file must be readable. If the `Include` parameter is used for including a directory: - All files in the directory must be readable. - No particular order of inclusion should be assumed (e.g. files are not included in alphabetical order). Therefore do not define one parameter in several ''Include'' files (e.g. to override a general setting with a specific one). - All files in the directory are included into configuration. - Beware of file backup copies automatically created by some text editors. For example, if editing the ''include/my_specific.conf'' file produces a backup copy ''include/my_specific_conf.BAK'' then both files will be included. Move ''include/my_specific.conf.BAK'' out of the "Include" directory. On Linux, contents of the ''Include'' directory can be checked with a ''ls -al'' command for unnecessary files. If the `Include` parameter is used for including files using a pattern: - All files matching the pattern must be readable. - No particular order of inclusion should be assumed (e.g. files are not included in alphabetical order). Therefore do not define one parameter in several ''Include'' files (e.g. to override a general setting with a specific one). #### Специальные заметки о параметре «Include» Оператор `Include` в файлах конфигурации обрабатывается сразу же при обнаружении. Для предсказуемого поведения рекомендуется размещать параметр `Include` в конце файла конфигурации. Если параметр `Include` используется для включения файла, этот файл должен быть доступен на чтение. Если параметр `Include` используется для включения директории: - Все файлы из этой директории должны быть доступны на чтение. - Не следует предполагать какой-либо определённый порядок чтения файлов (например, файлы не включаются в алфавитном порядке). Поэтому не указывайте один параметр в нескольких разных Include-файлах (например, чтобы переопределить общую настройку более конкретной). - Все файлы из этой папки включаются в конфигурацию. - Остерегайтесь файлов архивных копий, создаваемых некоторыми текстовыми редакторами. Например, если при редактировании файла «include/my_specific.conf» добавится файл с резервной копией «include/my_specific_conf.BAK», то затем будут включены оба эти файла. Переместите «include/my_specific.conf.BAK» за пределы Include-директории. В Linux для обнаружения ненужных файлов содержимое Include-директории можно проверить командой «ls -al». Если параметр `Include` используется для включения файлов с использованием шаблона: - Все попадающие под шаблон файлы должны быть доступны на чтение. - Не следует предполагать какой-либо определённый порядок чтения файлов (например, файлы не включаются в алфавитном порядке). Поэтому не указывайте один параметр в нескольких разных Include-файлах (например, чтобы переопределить общую настройку более конкретной). ### 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. ### Заметки по установке Обратитесь к [инстракциям по установке](https://www.zabbix.com/ru/download?zabbix=5.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql) по каждой платформе на странице загрузки чтобы: - установить репозиторий - установить сервер / агент / веб-интерфейс - создать начальную базу данных, импортировать начальные данные - настроить базу данных для работы с Zabbix сервером - настроить PHP для работы с Zabbix веб-интерфейсом - запустить процессы сервера / агента - настроить Zabbix веб-интерфейс Если вы хотите запускать Zabbix агента с правами root, смотрите [Запуск агента с правами root](https://www.zabbix.com/documentation/5.0/manual/appendix/install/run_agent_as_root). Процессу веб-сервиса Zabbix, который используется для [генерации регулярных отчетов](/manual/web_interface/frontend_sections/reports/scheduled), требуется браузер 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/ru/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql) по каждой платформе на странице загрузки, чтобы: - установить репозиторий - установить сервер / агент / веб-интерфейс - создать начальную базу данных, импортировать начальные данные - настроить базу данных для работы с Zabbix сервером - настроить PHP для работы с Zabbix веб-интерфейсом - запустить процессы сервера / агента - настроить Zabbix веб-интерфейс Если вы хотите запускать Zabbix агента с правами root, смотрите [Запуск агента с правами root](/manual/appendix/install/run_agent_as_root). Процессу веб-сервиса Zabbix, который используется для [генерации регулярных отчетов](/manual/web_interface/frontend_sections/reports/scheduled), требуется браузер 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) по каждой платформе на странице загрузки, чтобы: - установить репозиторий - установить сервер / агент / веб-интерфейс - создать начальную базу данных, импортировать начальные данные - настроить базу данных для работы с Zabbix сервером - настроить PHP для работы с Zabbix веб-интерфейсом - запустить процессы сервера / агента - настроить Zabbix веб-интерфейс Если вы хотите запускать Zabbix агента с правами root, смотрите [Запуск агента с правами root](/manual/appendix/install/run_agent_as_root). Процессу веб-сервиса Zabbix, который используется для [генерации отчётов по расписанию](/manual/web_interface/frontend_sections/reports/scheduled), требуется браузер 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. ### Заметки по установке Обратитесь к [инстракциям по установке](https://www.zabbix.com/ru/download?zabbix=5.0&os_distribution=debian&os_version=10_buster&db=mysql) по каждой платформе на странице загрузки чтобы: - установить репозиторий - установить сервер / агент / веб-интерфейс - создать начальную базу данных, импортировать начальные данные - настроить базу данных для работы с Zabbix сервером - настроить PHP для работы с Zabbix веб-интерфейсом - запустить процессы сервера / агента - настроить Zabbix веб-интерфейс Если вы хотите запускать Zabbix агента с правами root, смотрите [Запуск агента с правами root](/manual/appendix/install/run_agent_as_root). Процессу веб-сервиса Zabbix, который используется для [генерации регулярных отчетов](/manual/web_interface/frontend_sections/reports/scheduled), требуется браузер Google Chrome. Этот браузер не включен в пакеты и его нужно установить отдельно вручную. ### 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) по каждой платформе на странице загрузки для: - установки репозитория - установке сервера / агента / веб-интерфейса - создания начальной базы данных, импорта начальных данных - настройки базы данных для работы с Zabbix сервером - настройки PHP для работы с Zabbix веб-интерфейсом - запуска процессов сервера / агента - настройки Zabbix веб-интерфейса Если вы хотите запускать Zabbix агента с правами root, смотрите [Запуск агента с правами root](/manual/appendix/install/run_agent_as_root). Процессу веб-сервиса Zabbix, который используется для [генерации отчётов по расписанию](/manual/web_interface/frontend_sections/reports/scheduled), требуется браузер 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 Для поиска датчиков на узле сети запустите Zabbix сервер с включённым **DebugLevel=4**. Подождите пару минут и поищите записи об обнаруженных датчиках в журнале Zabbix сервера: $ 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 \[en\]](https://www.intel.com/content/dam/www/public/us/en/documents/product-briefs/ipmi-second-gen-interface-spec-v2-rev1-1.pdf) (пожалуйста, обратите внимание, что [не планируется дальнейших обновлений \[en\]](http://www.intel.com/content/www/us/en/servers/ipmi/ipmi-specifications.html) к спецификации IPMI). Начнем с параметра «тип\_чтения» (reading\_type). Для расшифровки кода «reading\_type» используйте раздел «Table 42-1, Event/Reading Type Code Ranges» из спецификации. Большинство датчиков из нашего примера имеют «reading\_type:0x1», означающих «порог» датчика. «Table 42-3, Sensor Type Codes» показывает, что «type:0x1» — датчик температуры, «type:0x2» — датчик напряжения, «type:0x4» — датчик частоты вращения вентилятора системы охлаждения и так далее. Пороговые датчики иногда называют «аналоговыми» датчиками, так как они измеряют непрерывные параметры, такие как температуру, напряжение, частоту вращения в минуту. Другой пример — датчик с «reading\_type:0x3». «Table 42-1, Event/Reading Type Code Ranges» говорит, что коды типов чтения 02h-0Ch означают «Общий Дискретный» датчик. Дискретные датчики имеют до 15 возможных состояний (другими словами — до 15 значащих бит). К примеру, для датчика «CATERR» с «type:0x7» «Table 42-3, Sensor Type Codes» показывает, что этот тип обозначает «Процессор» и значение отдельных битов: 00h (наименьший значащий бит) — IERR (внутренняя ошибка процессора), 01h — Перегрев процессора и т.д. В нашем примере есть несколько датчиков с «reading\_type:0x6f». Для этих датчиков «Table 42-1, Event/Reading Type Code Ranges» советует использовать «Table 42-3, Sensor Type Codes» для расшифровки значений битов. Например, датчик «Power Unit Stat» имеет тип «type:0x9», который означает «Блок питания». Смещение 00h означает «Выключено/Обесточено». Другими словами, если младший значащий бит равен 1, то сервер выключен. Для проверки этого бита можно воспользоваться [функцией](/manual/appendix/functions) **band** с маской «1». Выражение триггера для предупреждения о выключенном сервере может выглядеть следующим образом: bitand(last(/www.example.com/Power Unit Stat,#1),1)=1 #### Notes on persistent files for log\*\[\] items #### Примечания к постоянным файлам у элементов данных log\*\[\] ##### 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 агенты предоставляют одновременно пороговые и дискретные датчики под одним именем. В версиях Zabbix до 2.2.8 и 2.4.3 выбирался первый полученный датчик. Начиная с версий 2.2.8 и 2.4.3, предпочтение всегда отдаётся пороговому датчику. ::: notetip After enabling a trigger (changing its configuration status from *Disabled* to *Enabled*), the trigger expression is evaluated as soon as an item in it receives a value or the time to handle [date and time](/manual/appendix/functions/time) and/or nodata() functions comes. ::: ::: notetip После включения триггера (изменение его состояния конфигурации с *Деактивирован* на *Активирован*) выражение триггера будет вычислено, как только элемент данных из выражения получит своё значение или когда подойдёт время обработки функции [даты и времени](/manual/appendix/functions/time) и/или функции nodata(). ::: ::: 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` расположен в папке `/conf` документов HTML Zabbix на веб-сервере. Однако, местоположение этой папки может различаться в зависимости от операционной системы и веб-сервера, который она использует. Например, местоположение для: - SUSE и RedHat: `/etc/zabbix/web/maintenance.inc.php`. - систем на базе Debian: `/usr/share/zabbix/conf/`. Смотрите также [Копирование файлов PHP](/manual/installation/install#копирование-файлов-php). ::: |Параметр|Подробности| |--|--------| |**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 Вы можете найти более подробную информацию о настройке SSL для веб-интерфейса Zabbix, обращаясь к этим [наилучшим практикам](/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#настройка-операции) теперь имеется возможность отменить оповещения об отмененных эскалациях, убрав отметку с соответствующей опции. #### 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). #### Оповещение об отменённых эскалациях При настройке [операций на действие](/manual/config/notifications/action/operation#настройка-операции) теперь имеется возможность отменить оповещения об отмененных эскалациях, убрав отметку с соответствующей опции. #### Удален раздел Мониторинг → Обзор Раздел Обзор в меню Мониторинг полностью удалён. К этому же функционалу можно получить доступ, используя [виджеты](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) *Обзор данных* и *Обзор триггеров* панели. ##### 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). #### Прочие - Язык по умолчанию Zabbix веб-интерфейса изменён с Британского на Американский Английский. Поддержка Британского Английского прекращена. - Ссылка Share в основном меню заменена на ссылку Интеграции, которая ведёт на страницу [Интеграции](https://www.zabbix.com/integrations) веб-сайта Zabbix. - Если Zabbix веб-интерфейс с одним из поддерживаемых языков на Zabbix веб-сайте, то при нажатии на ссылку Интеграции будет открыта страница Интеграции на соответствующем языке. Для все остальных языки, включая Английский, страница Интеграции будет открыта на Английском языке. - Пользовательское выражение, которое используется в [настройках действия](/manual/config/notifications/action/#настройка-действия) для вычисления условий, теперь может быть длиной вплоть до 1024 символов (ранее 255). ## 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 и более старых версиях 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 поддерживает числовые представления (индексы) объектов и имён счётчиков производительности. Zabbix поддерживает такие числовые представления в виде параметров к ключам элементов данных `perf_counter`, `perf_counter_en` и в параметрах конфигурации `PerfCounter`, `PerfCounterEn`. Однако, если вы не можете гарантировать, что числовые индексы сопоставляются с корректными строками на отдельных хостах, не рекомендуется их использовать. Если вам нужно создать переносимые элементы данных, которые будут работать на разных узлах сети и с разными локализованными версиями Windows, вы можете использовать ключ `perf_counter_en` или параметр конфигурации `PerfCounterEn`, которые позволяют использовать имена на английском языке независимо от языковых настроек системы. Для того чтобы найти цифровые эквиваленты, запустите **regedit**, а затем найдите *HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\WindowsNT\\CurrentVersion\\Perflib\\009*. Запись в реестре содержит информацию наподобие этой: 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 .... Здесь вы можете найти соответствующие числа для каждой части строки счётчика производительности, такой как «\\System\\% Processor Time»: System → 2 % Processor Time → 6 Затем вы можете использовать эти числа для преобразования пути в числа: \2\6 #### Obtaining sensor names Sensor labels, as printed by the *sensors* command, cannot always be used directly because the naming of labels may be different for each sensor chip vendor. For example, *sensors* output might contain the following lines: $ sensors in0: +2.24 V (min = +0.00 V, max = +3.32 V) Vcore: +1.15 V (min = +0.00 V, max = +2.99 V) +3.3V: +3.30 V (min = +2.97 V, max = +3.63 V) +12V: +13.00 V (min = +0.00 V, max = +15.94 V) M/B Temp: +30.0°C (low = -127.0°C, high = +127.0°C) Out of these, only one label may be used directly: $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,in0] 2.240000 Attempting to use other labels (like *Vcore* or *+12V*) will not work. $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,Vcore] ZBX_NOTSUPPORTED To find out the actual sensor name, which can be used by Zabbix to retrieve the sensor readings, run *sensors -u*. In the output, the following may be observed: $ sensors -u ... Vcore: in1_input: 1.15 in1_min: 0.00 in1_max: 2.99 in1_alarm: 0.00 ... +12V: in4_input: 13.00 in4_min: 0.00 in4_max: 15.94 in4_alarm: 0.00 ... So *Vcore* should be queried as *in1*, and *+12V* should be queried as *in4*. According to [specification](https://www.kernel.org/doc/Documentation/hwmon/sysfs-interface), these are voltages on chip pins and generally speaking may need scaling. $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,in1] 1.301000 Not only voltage (in), but also current (curr), temperature (temp) and fan speed (fan) readings can be retrieved by Zabbix. #### Получение имён датчиков Метки датчиков не всегда могут быть использованы непосредственно в том виде, как они выводятся утилитой *sensors*, т.к. именование меток может отличаться у каждого производителя контроллеров. Например, вывод утилиты *sensors* может содержать следующие строки: $ sensors in0: +2.24 V (min = +0.00 V, max = +3.32 V) Vcore: +1.15 V (min = +0.00 V, max = +2.99 V) +3.3V: +3.30 V (min = +2.97 V, max = +3.63 V) +12V: +13.00 V (min = +0.00 V, max = +15.94 V) M/B Temp: +30.0°C (low = -127.0°C, high = +127.0°C) Из этих строк только одна строка может использоваться непосредственно: $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,in0] 2.240000 Попытки использовать остальные метки (такие как *Vcore* или *+12V*) работать не будут. $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,Vcore] ZBX_NOTSUPPORTED Чтобы найти фактическое имя датчика, которое можно использовать в Zabbix для получения его показаний, запустите *sensors -u*. В полученном выводе можно увидеть следующее: $ sensors -u ... Vcore: in1_input: 1.15 in1_min: 0.00 in1_max: 2.99 in1_alarm: 0.00 ... +12V: in4_input: 13.00 in4_min: 0.00 in4_max: 15.94 in4_alarm: 0.00 ... Таким образом, *Vcore* может быть опрошен как *in1*, а *+12V* должен опрашиваться как *in4*. [^1]: Согласно [спецификации \[en\]](https://www.kernel.org/doc/Documentation/hwmon/sysfs-interface), это напряжения на выводах микросхемы и, в общем случае, может понадобиться масштабирование. $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,in1] 1.301000 В Zabbix можно получать не только показания напряжения (in), но также тока (curr), температуры (temp) и скорости вращения вентилятора (fan). #### ODBC checks - MySQL unixODBC driver should not be used with Zabbix server or Zabbix proxy compiled against MariaDB connector library and vice versa, if possible it is also better to avoid using the same connector as the driver due to an [upstream bug](https://bugs.mysql.com/bug.php?id=73709). Suggested setup: PostgreSQL, SQLite or Oracle connector → MariaDB or MySQL unixODBC driver MariaDB connector → MariaDB unixODBC driver MySQL connector → MySQL unixODBC driver See [ZBX-7665](https://support.zabbix.com/browse/ZBX-7665) for more information and available workarounds. - XML data queried from Microsoft SQL Server may get truncated in various ways on Linux and UNIX systems. - It has been observed that using ODBC checks for monitoring Oracle databases using various versions of Oracle Instant Client for Linux causes Zabbix server to crash.<br> See also: [ZBX-18402](https://support.zabbix.com/browse/ZBX-18402), [ZBX-20803](https://support.zabbix.com/browse/ZBX-20803). - If using FreeTDS UnixODBC driver, you need to prepend a 'SET NOCOUNT ON' statement to an SQL query (for example, ````SET NOCOUNT ON DECLARE @strsql NVARCHAR(max) SET @strsql = ....````). Otherwise, database monitor item in Zabbix will fail to retrieve the information with an error "SQL query returned empty result".<br> See [ZBX-19917](https://support.zabbix.com/browse/ZBX-19917) for more information. #### ODBC проверки - Драйвер MySQL unixODBC лучше не использовать с Zabbix сервером или Zabbix прокси, скомпилированными с библиотекой MariaDB, и наоборот, по возможности лучше избегать использование того же коннектора, что и драйвер, по причине [зарегистрированной проблемы](https://bugs.mysql.com/bug.php?id=73709). Предлагаемая установка: PostgreSQL, SQLite или Oracle коннекторы → MariaDB или MySQL unixODBC драйвер MariaDB коннектор → MariaDB unixODBC драйвер\ MySQL коннектор → MySQL unixODBC драйвер Пожалуйста, обратитесь к [ZBX-7665](https://support.zabbix.com/browse/ZBX-7665) для получения более подробных сведений и вариантов обходных решений. - Данные XML, запрошенные с Microsoft SQL Server, могут обрезаться различными способами на Linux и UNIX системах. - Было замечено, что использование ODBC проверок для мониторинга баз данных Oracle с использованием различных версий Oracle Instant Client for Linux приводит к аварийной остановке Zabbix сервера.<br> Смотрите также [ZBX-18402](https://support.zabbix.com/browse/ZBX-18402), [ZBX-20803](https://support.zabbix.com/browse/ZBX-20803). - При использовании драйвера UnixODBC FreeTDS, нужно SQL-запрос предварить утверждением 'SET NOCOUNT ON' (например: ````SET NOCOUNT ON DECLARE @strsql NVARCHAR(max) SET @strsql = ....````). В противном случае элемент данных с типом "Монитор баз данных" в Zabbix при получении информации завершится ошибкой "SQL query returned empty result".<br> Обратитесь к [ZBX-19917](https://support.zabbix.com/browse/ZBX-19917) для получения более подробной информации. #### 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) #### События OK Событие OK закрывает связанные событие(-я) о проблеме и может быть создано тремя компонентами: - триггеры — на основании настроек «Генерация ОК со�