### ### # 10 Cookies used by Zabbix # 10 Файли cookie, які використовує Zabbix # 10 Notifications upon events # 10 Повідомлення про події # 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 з версій до Zabbix5.4.0. Перегляньте розділ [процедура оновлення](/manual/installation/upgrade), щоб отримати всю відповідну інформацію про оновлення попередніх версій Zabbix. # 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. Maintenance # 11. Обслуговування # 11 Time zones # 11 Часові пояси # 11 Upgrade notes for 6.0.1 # 11 Примітки по оновленню до 6.0.1 # 11 What's new in Zabbix 6.0.6 # 11 Що нового у Zabbix 6.0.6 # 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 # 13. Problem acknowledgment # 13. Підтвердження проблеми # 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. Configuration export/import # 14. Експорт/імпорт конфігурації # 14 Configuring Kerberos with Zabbix # 14 Налаштування Kerberos за допомогою Zabbix # 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 parameters # 15 Upgrade notes for 6.0.5 This minor version doesn't have any upgrade notes. # 15 Примітки по оновленню до 6.0.5 Ця другорядна версія не має приміток щодо оновлення. # 15 What's new in Zabbix 6.0.10 # 15 Що нового у Zabbix 6.0.10 # 16. Distributed monitoring # 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 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 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 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 Configuring a host # 1 Налаштування вузла # 1 Configuring a template # 1 Налаштування шаблону # 1 Configuring a user # 1 Налаштування користувача # 1 Database creation # 1 Створення бази даних # 1 Foreach functions # 1 Функції Foreach # 1 General # 1 Загальні # 1 Getting Zabbix # 1 Отримання Zabbix # 1 Global notifications # 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 Приймаючі групи У інтерфейсі групи хостів можна [експортувати](/manual/xml_export_import) лише за допомогою експорту хосту або шаблону. Коли хост або шаблон експортується, усі групи, до яких він належить, експортуються разом із ним автоматично. API дозволяє експортувати групи хостів незалежно від хостів або шаблонів. # 1 Hosts and host groups # 1 Вузли та групи вузлів # 1. Introduction Please use the sidebar to access content in the Introduction section. # 1. Вступ Будь ласка, використовуйте бічну панель, щоб отримати доступ до вступного розділу. # 1 Item prototypes # 1 Прототипи елементів # 1 Login and configuring user # 1 Вхід і налаштування користувача # 1 Manual structure # 1 Структура посібника # 1 Menu # 1 Меню # 1 Monitoring # 1 Моніторинг # 1 MySQL encryption configuration [comment]: # (tags: ssl) # 1 Конфігурація шифрування MySQL [comment]: # (теги: ssl) # 1 Proxies # 1 Проксі # 1 Simple graphs # 1 Прості графіки # 1 Web monitoring items # 1 Елементи веб-моніторингу # 20 Modules # 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 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 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 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 Веб-моніторинг # 25 Upgrade notes for 6.0.15 This minor version doesn't have any upgrade notes. # 25 Примітки по оновленню до 6.0.15 Ця другорядна версія не має приміток щодо оновлення. # 26 Upgrade notes for 6.0.16 This minor version doesn't have any upgrade notes. # 26 Примітки по оновленню до 6.0.16 Ця другорядна версія не має приміток щодо оновлення. # 27 Upgrade notes for 6.0.17 # 27 Примітки по оновленню до 6.0.17 # 28 Upgrade notes for 6.0.18 # 28 Примітки по оновленню до 6.0.18 # 29 Upgrade notes for 6.0.19 # 29 Примітки по оновленню до 6.0.19 # 2 Active agent autoregistration # 2 Автоматична реєстрація активних агентів # 2 Custom graphs # 2 Користувацькі графіки # 2. Definitions # 2. Визначення # 2 Host group elements # 2 Елементи групи вузлів # 2 Linking/unlinking # 2 Зв’язування/від’єднання # 2 New host # 2 Новий вузол # 2 Permissions # 2 Права доступу # 2 Proxies # 2 Проксі # 2 Real-life scenario # 2 Реальний сценарій # 2 Repairing Zabbix database character set and collation # 2 Відновлення набору символів і сортування бази даних Zabbix # 2 Requirements # 2 Вимоги # 2 Services # 2 Послуги # 2 Sound in browsers # 2 Звук в браузерах # 2 Templates # 2 Шаблони # 2 Trigger expression # 2 Вираз тригеру # 2 Trigger prototypes # 2 Прототипи тригерів # 2 What is Zabbix # 2 Що таке Zabbix # 3 Ad-hoc graphs # 3 Спеціальні графіки # 3 Authentication [comment]: # (tags: ldap, saml) # 3 Автентифікація [коментар]: # (tags: ldap, saml) # 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 Graph prototypes # 3 Прототипи графіків # 3 Hosts # 3 Вузли мережі # 3 Hosts # 3 Вузли мережі # 3 Hosts # 3 Вузли мережі # 3 Link indicators # 3 Індикатори зв'язків # 3 Nesting # 3 Вкладення # 3 New item # 3 Новий елемент # 3 Passive and active agent checks # 3 Пасивні та активні перевірки агенту # 3 SLA # 3 SLA # 3 Trigger dependencies # 3 Залежності тригерів # 3 Triggers # 3 Тригери # 3 User groups # 3 Групи користувачів # 3 User settings # 3 Налаштування користувача # 3 Zabbix features # 3 Можливості Zabbix # 3. Zabbix processes Please use the sidebar to access content in the Zabbix process section. # 3. Процеси Zabbix Для доступу до вмісту розділу "Процеси Zabbix", будь ласка, використовуйте бічну панель. # 4 Aggregation in graphs # 4 Агрегація в графіках # 4 Host dashboards # 4 Панелі вузла # 4 Host prototypes # 4 Прототипи вузлів # 4. Installation Please use the sidebar to access content in the Installation section. # 4. Встановлення Будь ласка, використовуйте бічну панель, щоб отримати доступ до розділу встановлення. # 4 Maintenance # 4 Технічне обслуговування # 4 Mass update # 4 Масове оновлення # 4 New trigger [comment]: # (tags: trigger) # 4 Новий тригер [comment]: # (tags: trigger) # 4 Reports # 4 Звіти # 4 SLA report # 4 Звіт SLA # 4 User groups # 4 Групи користувачів # 4 Zabbix agent 2 (UNIX) # 4 Zabbix агент 2 (UNIX) # 4 Zabbix overview # 4 Огляд Zabbix # 5 Actions # 5 Дії # 5 Audit № 5 Аудит # 5 Frontend maintenance mode # 5 Режим обслуговування інтерфейсу # 5 Installation from containers # 5 Встановлення з контейнерів # 5. Quickstart Please use the sidebar to access content in the Quickstart section. # 5. Швидкий старт Будь ласка, використовуйте бічну панель для доступу до вмісту в розділі швидкого старту. # 5 Receiving problem notification # 5 Отримання повідомлення про проблему # 5 TimescaleDB setup # 5 Налаштування TimescaleDB # 5 User roles # 5 Ролі користувачів ### 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.3 ### 6.0.3 ### 6.0.7 ### 6.0.7 ### 6.0.9 ### 6.0.9 # 6 Action log # 6 Журнал дій # 6 Administration # 6 Адміністрування # 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 agent, ssh, telnet тощо. Різні контрольовані системи/пристрої та перевірки можуть повертати символи, відмінні від ASCII, у значенні. Для таких випадків майже всі можливі ключі zabbix містять додатковий параметр ключа елемента - **<encoding>**. Цей ключовий параметр необов’язковий, але його слід вказати, якщо повернуте значення не в кодуванні UTF8 і містить символи, відмінні від ASCII. Інакше результат може бути неочікуваним і непередбачуваним. Нижче наведено опис поведінки з різними серверними частинами бази даних у таких випадках. # 6 Event correlation # 6 Кореляція подій # 6 Mass update # 6 Масове оновлення # 6 New template # 6 Новий шаблон # 6 Page parameters # 6 Параметри сторінки # 6 Tagging # 6 Теги # 6 Users # 6 Користувачі # 6 What's new in Zabbix 6.0.1 # 6 Що нового у Zabbix 6.0.1 # 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 Get # 7 Get # 7 Media types # 7 Методи повідомлень # 7 Real-time export of events, item values, trends # 7 Експорт у реальному часі подій, значень елементів, тенденцій # 7 Services # 7 Послуги # 7 Upgrade procedure # 7 Процедура оновлення # 7 Visualization # 7 Візуалізація # 7 What's new in Zabbix 6.0.2 # 7 Що нового у Zabbix 6.0.2 # 8 Creating your own theme # 8 Створення власної теми # 8 Distribution-specific notes on setting up Nginx for Zabbix # 8 Спеціальні примітки щодо налаштування Nginx для Zabbix # 8 Scripts # 8 Сценарії # 8. Service monitoring # 8. Моніторинг послуг # 8 Templates # 8 Шаблони # 8 What's new in Zabbix 6.0.3 # 8 Що нового у Zabbix 6.0.3 # 9 Debug mode # 9 Режим налагодження # 9 Queue # 9 Черга # 9 Templates out of the box # 9 Шаблони з коробки # 9. Web monitoring # 9. Веб-моніторинг # 9 What's new in Zabbix 6.0.4 # 9 Що нового у Zabbix 6.0.4 # 9 Zabbix web service # 9 Веб-сервіс Zabbix ### Access control ### Управління доступом #### 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:\ [ZBX-21804](https://support.zabbix.com/browse/ZBX-21804) `action.create`, `action.get`, `action.update`, `action.delete`: removed requirement of write permissions for hosts, host groups, templates, triggers, proxy.\ #### дія Зміни:\ [ZBX-21804](https://support.zabbix.com/browse/ZBX-21804) `action.create`, `action.get`, `action.update`, `action.delete`: видалено вимогу дозволів на запис для вузлів, груп вузлів, шаблонів, тригерів, проксі.\ #### action Changes:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) added new `conditiontype` values *(27 - Service, 28 - Service name)*.\ [ZBXNEXT-6250](https://support.zabbix.com/browse/ZBXNEXT-6250) `action.get`, `action.create`, `action.update`: added new property `notify_if_canceled`.\ #### дія Зміни:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) додано нові значення `conditiontype` *(27 - Служба, 28 - Назва служби)*.\ [ZBXNEXT-6250](https://support.zabbix.com/browse/ZBXNEXT-6250) `action.get`, `action.create`, `action.update`: додано нову властивість `повідомити_якщо_скасовано`.\ #### action Changes:\ [ZBXNEXT-6920](https://support.zabbix.com/browse/ZBXNEXT-6920) `action.create`, `action.update`: added strict validation of the methods parameters.\ [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`.\ #### action Зміни:\ [ZBXNEXT-6920](https://support.zabbix.com/browse/ZBXNEXT-6920) `action.create`, `action.update`: додано сувору перевірку параметрів методів.\ [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 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#data_types)|Опис| |--|--|------| |**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>Потрібно для фільтрів користувацьких виразів.| # action.get # action.get # > Action object The following objects are directly related to the `action` API. # > Об'єкт дії Наступні об’єкти безпосередньо пов’язані з `action` API. #### 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#data_types)|Опис| |--|--|------| |opconditionid|string|*(readonly)* ID умови операції дії| |**conditiontype**<br>(обов’язково)|integer|Тип умови.<br><br>Можливі значення:<br>14 - подія підтверджена.| |**value**<br>(обов’язково)|string|Значення для порівняння.| |operationid|string|*(readonly)* ID операції.| |operator|integer|Оператор умови.<br><br>Можливі значення:<br>0 - *(default)* =.| Наступні оператори та значення підтримуються для кожного типу умови операції. |Умова|Назва умови|Підтримувані оператори|Очікуване значення| |---------|--------------|-------------------|--------------| |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#data_types)|Опис| |--|--|------| |default\_msg|integer|Чи використовувати текст і тему повідомлення про дію за замовчуванням.<br><br>Можливі значення:<br>0 - використовувати дані з операції;<br>1 - *(за замовчуванням)* використовувати дані з способу оповіщення.| |mediatypeid|string|Ідентифікатор способу оповіщення, який буде використано для надсилання повідомлення.| |message|string|Текст повідомлення операції.| |subject|string|Тема повідомлення операції.| ### Action operation The action operation object defines an operation that will be performed when an action is executed. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationid|string|*(readonly)* ID of the action operation.| |**operationtype**<br>(required)|integer|Type of operation.<br><br>Possible values:<br>0 - send message;<br>1 - global script;<br>2 - add host;<br>3 - remove host;<br>4 - add to host group;<br>5 - remove from host group;<br>6 - link to template;<br>7 - unlink from template;<br>8 - enable host;<br>9 - disable host;<br>10 - set host inventory mode.<br><br>Note that only types '0' and '1' are supported for trigger and service actions, only '0' is supported for internal actions. All types are supported for discovery and autoregistration actions.| |actionid|string|*(readonly)* ID of the action that the operation belongs to.| |esc\_period|string|Duration of an escalation step in seconds. Must be greater than 60 seconds. Accepts seconds, time unit with suffix and user macro. If set to 0 or 0s, the default action escalation period will be used.<br><br>Default: 0s.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |esc\_step\_from|integer|Step to start escalation from.<br><br>Default: 1.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |esc\_step\_to|integer|Step to end escalation at.<br><br>Default: 1.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |evaltype|integer|Operation condition evaluation method.<br><br>Possible values:<br>0 - *(default)* AND / OR;<br>1 - AND;<br>2 - OR.| |opcommand|object|Object containing data on global script run by the operation.<br><br>Each object has one following property: `scriptid` - *(string)* ID of the script.<br><br>Required for global script operations.| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_grpid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`groupid` - *(string)* ID of the host group.<br><br>Required for global script operations if `opcommand_hst` is not set.| |opcommand\_hst|array|Host to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_hstid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`hostid` - *(string)* ID of the host; if set to 0 the command will be run on the current host.<br><br>Required for global script operations if `opcommand_grp` is not set.| |opconditions|array|Operation conditions used for trigger actions.<br><br>The operation condition object is [described in detail below](/manual/api/reference/action/object#action_operation_condition).| |opgroup|array|Host groups to add hosts to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`groupid` - *(string)* ID of the host group.<br><br>Required for "add to host group" and "remove from host group" operations.| |opmessage|object|Object containing the data about the message sent by the operation.<br><br>The operation message object is [described in detail below](/manual/api/reference/action/object#action_operation_message).<br><br>Required for message operations.| |opmessage\_grp|array|User groups to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`usrgrpid` - *(string)* ID of the user group.<br><br>Required for message operations if `opmessage_usr` is not set.| |opmessage\_usr|array|Users to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`userid` - *(string)* ID of the user.<br><br>Required for message operations if `opmessage_grp` is not set.| |optemplate|array|Templates to link the hosts to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`templateid` - *(string)* ID of the template.<br><br>Required for "link to template" and "unlink from template" operations.| |opinventory|object|Inventory mode set host to.<br><br>Object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`inventory_mode` - *(string)* Inventory mode.<br><br>Required for "Set host inventory mode" operations.| ### Операція дії Об’єкт операції дії визначає операцію, яка виконуватиметься під час виконання дії. Має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |operationid|string|*(readonly)* ID операції дії.| |**operationtype**<br>(обов'язково)|integer|Тип операції.<br><br>Можливі значення:<br>0 - надіслати повідомлення;<br>1 - глобальний сценарій;<br>2 - додати хост;<br>3 - видалити хост;<br>4 - додати до групи хостів;<br>5 - видалити з групи хостів;<br>6 - посилання на шаблон;<br>7 - видалити зв'язок із шаблоном;<br >8 - увімкнути хост;<br>9 - вимкнути хост;<br>10 - встановити режим інвентаризації хоста.<br><br>Зауважте, що лише типи «0» і «1» підтримуються для тригерів і дій служби, лише «0» підтримується для внутрішніх дій. Усі типи підтримуються для дій виявлення та автореєстрації.| |actionid|string|*(лише для читання)* ID дії, до якої належить операція.| |esc\_period|string|Тривалість кроку ескалації в секундах. Має бути більше 60 секунд. Приймає секунди, одиниці вимірювання часу з суфіксом і макрос користувача. Якщо встановлено значення 0 або 0 с, використовуватиметься період ескалації дії за замовчуванням.<br><br>За замовчуванням: 0 с.<br><br>Зверніть увагу, що ескалація підтримується лише для ініціаторів, внутрішніх і службових дій і лише у звичайному режимі. операцій.| |esc\_step\_from|integer|Крок, з якого починається ескалація.<br><br>За замовчуванням: 1.<br><br>Зауважте, що ескалація підтримується лише для ініціаторів, внутрішніх і службових дій і лише під час звичайних операцій .| |esc\_step\_to|integer|Крок для завершення ескалації.<br><br>За замовчуванням: 1.<br><br>Зауважте, що ескалація підтримується лише для ініціаторів, внутрішніх і службових дій і лише під час звичайних операцій .| |evaltype|integer|Метод оцінки умови операції.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* І / АБО;<br>1 - І;<br>2 - АБО.| |opcommand|object|Об’єкт, що містить дані про глобальний сценарій, запущений операцією.<br><br>Кожен об’єкт має таку властивість: `scriptid` - *(string)* ідентифікатор сценарію.<br><br>Обов’язково для глобальних операцій сценарію.| |opcommand\_grp|array|Групи хостів для запуску глобальних сценаріїв.<br><br>Кожен об'єкт має такі властивості:<br>`opcommand_grpid` - *(_string, readonly_)* ідентифікатор об'єкта;<br> `operationid` - *(string, readonly)* ID операції;<br>`groupid` - *(string)* ID групи хостів.<br><br>Потрібно для операцій глобального сценарію, якщо `opcommand_hst` є не встановлено.| |opcommand\_hst|array|Хост для запуску глобальних сценаріїв.<br><br>Кожен об’єкт має такі властивості:<br>`opcommand_hstid` - *(_string, readonly_)* ідентифікатор об’єкта;<br>` operationid` - *(string, readonly)* ID операції;<br>`hostid` - *(string)* ID хоста; якщо встановлено значення 0, команда буде виконана на поточному хості.<br><br>Потрібно для операцій глобального сценарію, якщо `opcommand_grp` не встановлено.| |opconditions|array|Умови роботи, що використовуються для дій ініціатора.<br><br>Об’єкт умови операції [докладно описано нижче](/manual/api/reference/action/object#action_operation_condition).| |opgroup|array|Групи хостів для додавання хостів.<br><br>Кожен об'єкт має такі властивості:<br>`operationid` - *(_string, readonly_)* ID операції;<br>`groupid` - *(string)* ID групи хостів.<br><br>Потрібно для операцій «додати до групи хостів» і «видалити з групи хостів».| |opmessage|object|Об’єкт, що містить дані про повідомлення, надіслане операцією.<br><br>Об’єкт повідомлення про операцію [докладно описано нижче](/manual/api/reference/action/object#action_operation_message).< br <br>Потрібно для операцій з повідомленнями.| |opmessage\_grp|array|Групи користувачів для надсилання повідомлень.<br><br>Кожен об’єкт має такі властивості:<br>`operationid` - *(_string, readonly_)* ID операції;<br>` usrgrpid` - *(string)* ID групи користувачів.<br><br>Потрібно для операцій з повідомленнями, якщо `opmessage_usr` не встановлено.| |opmessage\_usr|масив|Користувачі для надсилання повідомлень.<br><br>Кожен об’єкт має такі властивості:<br>`operationid` - *(_string, readonly_)* ID операції;<br>`userid ` - *(string)* ID користувача.<br><br>Потрібно для операцій з повідомленнями, якщо `opmessage_grp` не встановлено.| |optemplate|array|Шаблони для зв’язування хостів.<br><br>Кожен об’єкт має такі властивості:<br>`operationid` - *(_string, readonly_)* ID операції;<br>`templateid` - *(string)* Ідентифікатор шаблону.<br><br>Потрібно для операцій «посилання на шаблон» і «від’єднання від шаблону».| |opinventory|object|Режим інвентаризації встановлено для хоста.<br><br>Об’єкт має такі властивості:<br>`operationid` - *(_string, readonly_)* ідентифікатор операції;<br>`inventory_mode` - * (string)* Режим інвентаризації.<br><br>Потрібен для операцій «Установити режим інвентаризації хоста».| ##### 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 Модуль матиме контроль над діями фронтенду, визначеними в об'єкті *actions* у файлі manifest.json. Таким чином визначаються нові дії. Так само ви можете перевизначити існуючі дії. Кожен ключ у actions повинен представляти назву дії, а відповідні значення повинні містити ключі `class` і, за бажанням, ключі `layout` і `view`. Одна дія визначається чотирма компонентами: ім'ям, контролером, view і layout. Перевірка та підготовка даних зазвичай виконується в контролері, форматування виводу виконується у view або його частинах, а 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 деякої дії, залишивши контролер недоторканим. У такому випадку просто помістіть необхідні файли view та/або partial файли view у каталог `views` модуля. Для довідки перегляньте приклад файлу контролера дій у розділі [Довідка](#reference). Будь ласка, не соромтеся досліджувати поточні дії вихідного коду 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 у розділі [Довідка](#reference). ### Action The action object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |actionid|string|*(readonly)* ID of the action.| |**esc\_period**<br>(required)|string|Default operation step duration. Must be at least 60 seconds. Accepts seconds, time unit with suffix and user macro.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |**eventsource**<br>(required)|integer|*(constant)* Type of events that the action will handle.<br><br>Refer to the [event "source" property](/manual/api/reference/event/object#event) for a list of supported event types.| |**name**<br>(required)|string|Name of the action.| |status|integer|Whether the action is enabled or disabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |pause\_suppressed|integer|Whether to pause escalation during maintenance periods or not.<br><br>Possible values:<br>0 - Don't pause escalation;<br>1 - *(default)* Pause escalation.<br><br>Note that this parameter is valid for trigger actions only.| |notify\_if\_canceled|integer|Whether to notify when escalation is canceled.<br><br>Possible values:<br>0 - Don't notify when escalation is canceled;<br>1 - *(default)* Notify when escalation is canceled.<br><br>Note that this parameter is valid for trigger actions only.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Дія Об'єкт дії має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |actionid|string|*(лише читання)* ID дії.| |**esc\_period**<br>(обов'язково)|string|Тривалість кроку операції за замовчуванням. Має бути не менше 60 секунд. Приймає секунди, одиницю вимірювання часу з суфіксом і макрос користувача.<br><br>Зауважте, що ескалація підтримується лише для тригерів, внутрішніх і службових дій і лише в звичайних операціях.| |**eventsource**<br>(обов’язково)|integer|*(константа)* Тип подій, які дія оброблятиме.<br><br>Зверніться до [event "source" property](/manual/api /reference/event/object#event) для списку підтримуваних типів подій.| |**name**<br>(обов'язково)|string|Назва дії.| |status|integer|Увімкнено чи вимкнено дію.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* увімкнено;<br>1 - вимкнено.| |pause\_suppressed|integer|Чи призупинити ескалацію під час періодів обслуговування чи ні.<br><br>Можливі значення:<br>0 - Не призупиняти ескалацію;<br>1 - *(за замовчуванням)* Призупинити ескалацію. <br><br>Зверніть увагу, що цей параметр дійсний лише для тригерних дій.| |notify\_if\_canceled|integer|Чи сповіщати, коли ескалацію скасовано.<br><br>Можливі значення:<br>0 - Не повідомляти, коли ескалацію скасовано;<br>1 - *(за замовчуванням)* Повідомляти, коли ескалацію скасовано.<br><br>Зверніть увагу, що цей параметр дійсний лише для дій ініціатора.| Зауважте, що для деяких методів (оновлення, видалення) комбінація обов’язкових/необов’язкових параметрів відрізняється. # Action This class is designed to work with actions. Object references:\ - [Action](/manual/api/reference/action/object#action) - [Action condition](/manual/api/reference/action/object#action_condition) - [Action operation](/manual/api/reference/action/object#action_operation) Available methods:\ - [action.create](/manual/api/reference/action/create) - create new actions - [action.delete](/manual/api/reference/action/delete) - delete actions - [action.get](/manual/api/reference/action/get) - retrieve actions - [action.update](/manual/api/reference/action/update) - update actions # Дія Цей клас призначений для роботи з діями. Посилання на об'єкти:\ - [Дія](/manual/api/reference/action/object#action) - [Умова дії](/manual/api/reference/action/object#action_condition) - [Операція дії](/manual/api/reference/action/object#action_operation) Доступні методи:\ - [action.create](/manual/api/reference/action/create) - створювати нові дії - [action.delete](/manual/api/reference/action/delete) - дії видалення - [action.get](/manual/api/reference/action/get) - отримати дії - [action.update](/manual/api/reference/action/update) - оновлення дій # action.update # action.update ### Action update operation The action update operation object defines an operation that will be performed when a problem is updated (commented upon, acknowledged, severity changed, or manually closed). Update operations are possible for trigger and service actions. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationid|string|*(readonly)* ID of the action operation.| |**operationtype**<br>(required)|integer|Type of operation.<br><br>Possible values for trigger and service actions:<br>0 - send message;<br>1 - global script;<br>12 - notify all involved.| |opcommand|object|Object containing data on global action type script run by the operation.<br><br>Each object has one following property: `scriptid` - *(string)* ID of the action type script.<br><br>Required for global script operations.| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>Each object has the following properties:<br>`groupid` - *(string)* ID of the host group.<br><br>Required for global script operations if `opcommand_hst` is not set.| |opcommand\_hst|array|Host to run global scripts on.<br><br>Each object has the following properties:<br>`hostid` - *(string)* ID of the host; if set to 0 the command will be run on the current host.<br><br>Required for global script operations if `opcommand_grp` is not set.| |opmessage|object|Object containing the data about the message sent by the update operation.<br><br>The operation message object is [described in detail above](/manual/api/reference/action/object#action_operation_message).| |opmessage\_grp|array|User groups to send messages to.<br><br>Each object has the following properties:<br>`usrgrpid` - *(string)* ID of the user group.<br><br>Required only for `send message` operations if `opmessage_usr` is not set.<br>Is ignored for `send update message` operations.| |opmessage\_usr|array|Users to send messages to.<br><br>Each object has the following properties:<br>`userid` - *(string)* ID of the user.<br><br>Required only for `send message` operations if `opmessage_grp` is not set.<br>Is ignored for `send update message` operations.| ### Операція оновлення дії Об’єкт операції оновлення дії визначає операцію, яка виконуватиметься, коли проблему буде оновлено (прокоментовано, підтверджено, змінено серйозність або закрито вручну). Операції оновлення можливі для дій тригера та служби. Має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |operationid|string|*(readonly)* ID операції дії.| |**operationtype**<br>(обов’язково)|integer|Тип операції.<br><br>Можливі значення для тригерів і дій служби:<br>0 - надіслати повідомлення;<br>1 - глобальний сценарій;<br>12 - повідомити всіх причетних.| |opcommand|object|Об’єкт, що містить дані про сценарій типу глобальної дії, який виконується операцією.<br><br>Кожен об’єкт має одну наступну властивість: `scriptid` - *(string)* ID сценарію типу дії.<br> <br>Потрібно для глобальних операцій сценаріїв.| |opcommand\_grp|array|Групи хостів для запуску глобальних сценаріїв.<br><br>Кожен об’єкт має такі властивості:<br>`groupid` - *(string)* ID групи хостів.<br><br>Потрібно для глобальних операцій сценаріїв, якщо `opcommand_hst` не встановлено.| |opcommand\_hst|array|Хост для запуску глобальних сценаріїв.<br><br>Кожен об'єкт має такі властивості:<br>`hostid` - *(string)* ID хоста; якщо встановлено значення 0, команда буде виконана на поточному хості.<br><br>Потрібно для операцій глобального сценарію, якщо `opcommand_grp` не встановлено.| |opmessage|object|Об’єкт, що містить дані про повідомлення, надіслане операцією оновлення.<br><br>Об’єкт повідомлення про операцію [докладно описано вище](/manual/api/reference/action/object#action_operation_message). | |opmessage\_grp|array|Групи користувачів для надсилання повідомлень.<br><br>Кожен об’єкт має такі властивості:<br>`usrgrpid` - *(string)* ID групи користувачів.<br><br >Потрібно лише для операцій `надіслати повідомлення`, якщо `opmessage_usr` не встановлено.<br>Ігнорується для операцій `надіслати повідомлення оновлення`.| |opmessage\_usr|array|Користувачі для надсилання повідомлень.<br><br>Кожен об’єкт має такі властивості:<br>`userid` - *(string)* ідентифікатор користувача.<br><br>Обов’язково лише для операцій `надіслати повідомлення`, якщо `opmessage_grp` не встановлено.<br>Ігнорується для операцій `надіслати повідомлення оновлення`.| #### 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 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 } ``` #### Додавання хостів до груп хостів Додайте два хости до груп хостів з ідентифікаторами 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 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 } ``` ##### 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. ##### 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. Зверніть увагу, що для активних перевірок, вузли одного кластеру повинні бути відокремлені від інших Zabbix серверів комою, а самі вузли повинні бути розділені **крапкою з комою**, наприклад: ``` ServerActive=zabbix-node-01;zabbix-node-02 ``` # alert.get # alert.get ### 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.| ### Сповіщення ::: noteclassic Сповіщення створюються сервером Zabbix і не можуть бути змінені через API. ::: Об'єкт сповіщення містить інформацію про те, чи успішно виконано певні дії. Має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |alertid|рядок|ID сповіщення.| |actionid|рядок|Ідентифікатор дії, яка створила сповіщення.| |alerttype|ціле|Тип сповіщення.<br><br>Можливі значення:<br>0 - повідомлення;<br>1 - віддалена команда.| |годинник|мітка часу|Час, коли було створено сповіщення.| |помилка|рядок|Текст помилки, якщо є проблеми з надсиланням повідомлення або виконанням команди.| |esc\_step|integer|Крок ескалації дії, під час якого було створено сповіщення.| |eventid|рядок|ID події, яка ініціювала дію.| |mediatypeid|рядок|Ідентифікатор типу носія, який було використано для надсилання повідомлення.| |повідомлення|текст|Текст повідомлення. Використовується для сповіщень про повідомлення.| |повторних спроб|ціле число|Кількість спроб Zabbix надіслати повідомлення.| |sendto|string|Адреса, ім'я користувача або інший ідентифікатор одержувача. Використовується для сповіщень про повідомлення.| |статус|ціле число|Статус, що вказує, чи операція виконана успішно.<br><br>Можливі значення для сповіщень про повідомлення:<br>0 - повідомлення не надіслано.<br>1 - повідомлення надіслано.<br>2 - помилка після кількох спроб.<br>3 - нове сповіщення ще не оброблено менеджером сповіщень.<br><br>Можливі значення для сповіщень команди:<br>0 - команда не виконується.<br>1 - команда виконується .<br>2 - спробував запустити команду на агенті Zabbix, але він був недоступний.| |тема|рядок|Тема повідомлення. Використовується для сповіщень про повідомлення.| |ідентифікатор користувача|рядок|ідентифікатор користувача, якому надіслано повідомлення.| |p\_eventid|рядок|Ідентифікатор події проблеми, яка згенерувала сповіщення.| |acknowledgeid|рядок|Ідентифікатор підтвердження, яке згенерувало сповіщення.| # > Alert object The following objects are directly related to the `alert` API. # > Об'єкт сповіщення Наступні об’єкти безпосередньо пов’язані з API `alert`. # Alert This class is designed to work with alerts. Object references:\ - [Alert](/manual/api/reference/alert/object#alert) Available methods:\ - [alert.get](/manual/api/reference/alert/get) - retrieve alerts # Сповіщення Цей клас призначений для роботи з оповіщеннями. Посилання на об'єкти:\ - [Попередження](/manual/api/reference/alert/object#alert) Доступні методи:\ - [alert.get](/manual/api/reference/alert/get) - отримання сповіщень 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`. ::: ##### 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. # API info This class is designed to retrieve meta information about the API. Available methods:\ - [apiinfo.version](/manual/api/reference/apiinfo/version) - retrieving the version of the Zabbix API # Інформація про API Цей клас призначений для отримання метаінформації про API. Доступні методи:\ - [apiinfo.version](/manual/api/reference/apiinfo/version) - отримання версії Zabbix API # apiinfo.version # apiinfo.version #### - 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_tokens). Цей розділ доступний для користувача, лише якщо дію *Керування маркерами API* дозволено в [користувач налаштування ролі (/manual/web_interface/frontend_sections/administration/user_roles). {width="600"} Ви можете фільтрувати маркери API за назвою, датою закінчення терміну дії або статусом (увімкнено/вимкнено). Натисніть на статус маркера у списку, щоб швидко ввімкнути/вимкнути маркер. Ви також можете масово ввімкнути/вимкнути маркери, вибравши їх у списку, а потім натиснувши кнопки Увімкнути/Вимкнути під списком. ::: приміткаважливо Користувачі не можуть переглядати значення *Auth token* токенів, призначених їм у Zabbix. Значення *Auth token* відображається лише один раз – відразу після створення маркера. Якщо він був втрачений, маркер потрібно відновити. ::: ### API versions To simplify API versioning, since Zabbix 2.0.4, the version of the API matches the version of Zabbix itself. You can use the [apiinfo.version](/manual/api/reference/apiinfo/version) method to find out the version of the API you're working with. This can be useful for adjusting your application to use version-specific features. We guarantee feature backward compatibility inside of a major version. When making backward incompatible changes between major releases, we usually leave the old features as deprecated in the next release, and only remove them in the release after that. Occasionally, we may remove features between major releases without providing any backward compatibility. It is important that you never rely on any deprecated features and migrate to newer alternatives as soon as possible. ::: notetip You can follow all of the changes made to the API in the [API changelog](/manual/api/changes_5.4_-_6.0). ::: ### версії API Для спрощення керування версіями API, починаючи з Zabbix 2.0.4, версія API відповідає версії самого Zabbix. Ви можете використовувати [apiinfo.version](/manual/api/reference/apiinfo/version) метод пошуку версії API, з якою ви працюєте. Це може бути корисно для налаштування вашого додатка на використання специфічних для певної версії функцій. Ми гарантуємо зворотну сумісність функцій всередині мажорної версії. При внесенні зворотно несумісних змін між мажорними випусками, ми зазвичай залишаємо старі функції застарілими(deprecated) в наступному випуску, і видаляємо їх лише у подальших випусках. Іноді ми можемо видаляти можливості між мажорними випусками без забезпечення зворотної сумісності. Важливо, щоб ви ніколи не покладалися на застарілі функції і переходили на новіші альтернативи якомога швидше. ::: notetip Ви можете стежити за всіма змінами, внесеними до API, у [Журналі змін API](/manual/api/changes_5.4_-_6.0). ::: # Appendix 1. Reference commentary № Додаток 1. Опорний коментар # Appendix 2. Changes from 5.4 to 6.0 # Додаток 2. Зміни з 5.4 на 6.0 ##### AS/400 IBM AS/400 platform can be monitored using SNMP. More information is available at <http://publib-b.boulder.ibm.com/Redbooks.nsf/RedbookAbstracts/sg244504.html?Open>. ##### AS/400 Платформу IBM AS/400 можливо моніторити за допомогою SNMP. Більше інформації доступно <http://publib-b.boulder.ibm.com/Redbooks.nsf/RedbookAbstracts/sg244504.html?Open>. #### auditlog Changes:\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) dropped support of property `note`.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) dropped support of `resourcetype` values *(2 - Configuration of Zabbix, 7 - Graph element)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) dropped support of `action` values *(5 - Enable, 6 - Disable)*.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) dropped support of `action` value *(3 - Login)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `auditlog.get`: dropped support of parameter `selectDetails`.\ #### журнал аудиту Зміни:\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) припинено підтримку властивості `note`.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) припинено підтримку значень `resourcetype` *(2 – Configuration of Zabbix, 7 – Graph element)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) припинено підтримку значень `action` *(5 - Enable, 6 - Disable)*.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) припинено підтримку значення `action` *(3 - Login)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `auditlog.get`: припинено підтримку параметра `selectDetails`.\ #### auditlog Changes:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) added new `resourcetype` *(48 - SLA)*.\ [ZBXNEXT-6923](https://support.zabbix.com/browse/ZBXNEXT-6923) added new `resourcetype` *(47 - High availability node)*.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) added support of `action` values *(8 - Login, 9 - Failed login, 10 - History clear)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) added support of properties: `username`, `recordsetid`, `details`.\ #### журнал аудиту Зміни:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) додано новий `resourcetype` *(48 - SLA)*.\ [ZBXNEXT-6923](https://support.zabbix.com/browse/ZBXNEXT-6923) додано новий `resourcetype` *(47 - вузол високої доступності)*.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) додано підтримку значень `action` *(8 - Вхід, 9 - Невдалий вхід, 10 - Очищення історії)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) додано підтримку властивостей: `username`, `recordsetid`, `details`.\ # auditlog.get # auditlog.get # > Audit log object The following objects are directly related to the `auditlog` API. # > Об'єкт журналу аудиту Наступні об’єкти безпосередньо пов’язані з API журналу аудиту. # Audit log This class is designed to work with audit log. Object references:\ - [Audit log object](/manual/api/reference/auditlog/object) Available methods:\ - [auditlog.get](/manual/api/reference/auditlog/get) - retrieve audit log records # Журнал аудиту Цей клас призначений для роботи з журналом аудиту. Посилання на об'єкти:\ - [Об'єкт журналу аудиту](/manual/api/reference/auditlog/object) Доступні методи:\ - [auditlog.get](/manual/api/reference/auditlog/get) - отримати записи журналу аудиту #### authentication Changes:\ [ZBXNEXT-4029](https://support.zabbix.com/browse/ZBXNEXT-4029) added new password policy fields `passwd_min_length` and `passwd_check_rules`.\ #### автентифікація Зміни:\ [ZBXNEXT-4029](https://support.zabbix.com/browse/ZBXNEXT-4029) додано нові поля політики паролів `passwd_min_length` і `passwd_check_rules`.\ # authentication.get # authentication.get # > Authentication object The following objects are directly related to the `authentication` API. # > Об'єкт автентифікації Наступні об’єкти безпосередньо пов’язані з API `автентифікації`. # Authentication This class is designed to work with authentication settings. Object references:\ - [Authentication](/manual/api/reference/authentication/object#authentication) Available methods:\ - [authentication.get](/manual/api/reference/authentication/get) - retrieve authentication - [authentication.update](/manual/api/reference/authentication/update) - update authentication # Автентифікація Цей клас призначений для роботи з параметрами автентифікації. Посилання на об'єкти:\ - [Автентифікація](/manual/api/reference/authentication/object#authentication) Доступні методи:\ - [authentication.get](/manual/api/reference/authentication/get) - отримати автентифікацію - [authentication.update](/manual/api/reference/authentication/update) - оновлення автентифікації # authentication.update # authentication.update ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## АВТОР ТОВ Zabbix -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## АВТОР ТОВ Zabbix -------------------------------------------------- ---------------------- [ ]{#index} # autoregistration.get # autoregistration.get # > Autoregistration object The following objects are directly related to the `autoregistration` API. # > Об'єкт автореєстрації Наступні об’єкти безпосередньо пов’язані з API автореєстрації. # Autoregistration This class is designed to work with autoregistration. Object references:\ - [Autoregistration](/manual/api/reference/autoregistration/object#autoregistration) Available methods:\ - [autoregistration.get](/manual/api/reference/autoregistration/get) - retrieve autoregistration - [autoregistration.update](/manual/api/reference/autoregistration/update) - update autoregistration #Автореєстрація Цей клас призначений для роботи з автореєстрацією. Посилання на об'єкти:\ - [Autoregistration](/manual/api/reference/autoregistration/object#autoregistration) Доступні методи:\ - [autoregistration.get](/manual/api/reference/autoregistration/get) - отримати автореєстрацію - [autoregistration.update](/manual/api/reference/autoregistration/update) - оновити автореєстрацію # autoregistration.update # autoregistration.update ### Backward incompatible changes ### Зворотно несумісні зміни ## Breaking changes ## Критичні зміни ##### Buttons | | | |---|---| ||Clone the service.<br>When a service is cloned, its parent links are preserved, while the child links are not.| ##### Кнопки | | | |---|---| ||Клонуйте службу.<br>Коли службу клоновано, її батьківські посилання збережено, а дочірні посилання - ні.| ##### 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). #### 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 } ``` #### Змінити власника інформаційної панелі Доступно лише для адміністраторів і суперадміністраторів. Запит: ```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 } ``` #### CHANGES IN 6.0.0 #### Зміни в 6.0.0 #### CHANGES IN 6.0.18 #### Зміни в 6.0.18 #### 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 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 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 } ``` #### 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 } ``` #### 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 } ``` ##### 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 дозволить перейти до наступного елемента меню. [comment]: # attributes: noaside # 11 Recipes for monitoring [коментар]: # атрибути: не осторонь # 11 Рецепти моніторингу #### configuration Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `configuration.import`, `configuration.importcompare`: option `deleteMissing: true` for `templateLinkage` will now unlink missing templates (instead of unlink and clear).\ #### конфігурація Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `configuration.import`, `configuration.importcompare`: параметр `deleteMissing: true` для `templateLinkage` тепер від’єднає відсутні шаблони ( замість від’єднання та очищення).\ # configuration.export # configuration.export # configuration.import # configuration.import # configuration.importcompare # configuration.importcompare #### 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 на веб-сервері) має бути змінено, щоб розкоментувати такі рядки: // Режим обслуговування. define('ZBX_DENY_GUI_ACCESS', 1); // Масив IP-адрес, яким дозволено підключатися до інтерфейсу (необов’язково). $ZBX_GUI_ACCESS_IP_RANGE = масив ('127.0.0.1'); // Повідомлення, що відображається на екрані попередження (необов’язково). $ZBX_GUI_ACCESS_MESSAGE = 'Ми оновлюємо базу даних MySQL до 15:00. Залишайтеся з нами...'; # Configuration This class is designed to export and import Zabbix configuration data. Available methods:\ - [configuration.export](/manual/api/reference/configuration/export) - exporting the configuration - [configuration.import](/manual/api/reference/configuration/import) - importing the configuration - [configuration.importcompare](/manual/api/reference/configuration/importcompare) - comparing import file with current system elements # Конфігурація Цей клас призначений для експорту та імпорту конфігураційних даних Zabbix. Доступні методи:\ - [configuration.export](/manual/api/reference/configuration/export) - експорт конфігурації - [configuration.import](/manual/api/reference/configuration/import) - імпорт конфігурації - [configuration.importcompare](/manual/api/reference/configuration/importcompare) - порівняння файлу імпорту з поточними елементами системи #### 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 } ``` ### 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 залишає за собою будь-які права на цю документацію, прямо не надані вище. # correlation.create # correlation.create # correlation.delete # correlation.delete #### Correlation filter condition The correlation filter condition object defines a specific condition that must be checked before running the correlation operations. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|Type of condition.<br><br>Possible values:<br>0 - old event tag;<br>1 - new event tag;<br>2 - new event host group;<br>3 - event tag pair;<br>4 - old event tag value;<br>5 - new event tag value.| |tag|string|Event tag (old or new). Required when type of condition is: 0, 1, 4, 5.| |groupid|string|Host group ID. Required when type of condition is: 2.| |oldtag|string|Old event tag. Required when type of condition is: 3.| |newtag|string|New event tag. Required when type of condition is: 3.| |value|string|Event tag (old or new) value. Required when type of condition is: 4, 5.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Required when type of condition is: 2, 4, 5.| ::: notetip To better understand how to use filters with various types of expressions, see examples on the [correlation.get](get#retrieve_correlations) and [correlation.create](create#using_a_custom_expression_filter) method pages. ::: The following operators and values are supported for each condition type. |Condition|Condition name|Supported operators|Expected value| |---------|--------------|-------------------|--------------| |2|Host group|=, <>|Host group ID.| |4|Old event tag value|=, <>, like, not like|string| |5|New event tag value|=, <>, like, not like|string| #### Умова фільтра кореляції Об’єкт умови фільтра кореляції визначає конкретну умову, яку необхідно перевірити перед виконанням операцій кореляції. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**type**<br>(обов’язково)|ціле|Тип умови.<br><br>Можливі значення:<br>0 - старий тег події;<br>1 - новий тег події;<br>2 - нова група хостів події;<br>3 - пара тегів події;<br>4 - старе значення тегу події;<br>5 - нове значення тегу події.| |тег|рядок|Тег події (старий чи новий). Необхідний, якщо тип умови: 0, 1, 4, 5.| |groupid|рядок|Ідентифікатор групи хостів. Необхідний, якщо тип умови: 2.| |oldtag|рядок|Старий тег події. Необхідно, якщо тип умови: 3.| |новий тег|рядок|Новий тег події. Необхідно, якщо тип умови: 3.| |значення|рядок|Значення тегу події (старе або нове). Необхідно, якщо тип умови: 4, 5.| |formulaid|рядок|Довільний унікальний ідентифікатор, який використовується для посилання на умову з користувацького виразу. Може містити лише великі літери. Ідентифікатор має бути визначений користувачем під час зміни умов фільтра, але буде згенеровано заново під час їхнього запиту пізніше.| |operator|integer|Оператор умови.<br><br>Потрібний, якщо тип умови: 2, 4, 5.| ::: notetip Щоб краще зрозуміти, як використовувати фільтри з різними типами виразів, перегляньте приклади на сторінках методів [correlation.get](get#retrieve_correlations) і [correlation.create](create#using_a_custom_expression_filter). ::: Наступні оператори та значення підтримуються для кожної умови типу. |Умова|Назва умови|Підтримувані оператори|Очікуване значення| |---------|--------------|-------------------|---- ----------| |2|Група хостів|=, <>|Ідентифікатор групи хостів.| |4|Старе значення тегу події|=, <>, подобається, не подобається|рядок| |5|Нове значення тегу події|=, <>, як, не як|рядок| ### Correlation filter The correlation filter object defines a set of conditions that must be met to perform the configured correlation operations. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**evaltype**<br>(required)|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression filters.| ### Кореляційний фільтр Об’єкт кореляційного фільтра визначає набір умов, які мають бути виконані для виконання налаштованих операцій кореляції. Має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**evaltype**<br>(обов’язково)|ціле|Метод оцінки умови фільтра.<br><br>Можливі значення:<br>0 - та/або;<br>1 - і;<br>2 - або;<br>3 - спеціальний вираз.| |**conditions**<br>(обов’язково)|масив|Набір умов фільтра для використання для фільтрації результатів.| |eval\_formula|рядок|*(лише для читання)* Згенерований вираз, який використовуватиметься для оцінки умов фільтра. Вираз містить ідентифікатори, які посилаються на конкретні умови фільтра за його "формулою". Значення `eval_formula` дорівнює значенню `formula` для фільтрів із спеціальним виразом.| |формула|рядок|Визначений користувачем вираз, який буде використовуватися для оцінки умов фільтрів за допомогою спеціального виразу. Вираз має містити ідентифікатори, які посилаються на конкретні умови фільтра за його "формулою". Ідентифікатори, які використовуються у виразі, мають точно відповідати ідентифікаторам, визначеним в умовах фільтра: жодна умова не може залишатися невикористаною або пропущеною.<br><br>Потрібно для фільтрів користувацьких виразів.| # correlation.get # correlation.get # > Correlation object The following objects are directly related to the `correlation` API. # > Об'єкт кореляції Наступні об’єкти безпосередньо пов’язані з `correlation` API. ### 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>(обов'язково)|рядок|Ім'я кореляції.| |опис|рядок|Опис кореляції.| |статус|ціле|Чи кореляція увімкнена чи вимкнена.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* увімкнено;<br>1 - вимкнено.| Зауважте, що для деяких методів (оновлення, видалення) комбінація обов’язкових/необов’язкових параметрів відрізняється. # Correlation This class is designed to work with correlations. Object references:\ - [Correlation](/manual/api/reference/correlation/object#correlation) Available methods:\ - [correlation.create](/manual/api/reference/correlation/create) - creating new correlations - [correlation.delete](/manual/api/reference/correlation/delete) - deleting correlations - [correlation.get](/manual/api/reference/correlation/get) - retrieving correlations - [correlation.update](/manual/api/reference/correlation/update) - updating correlations # Кореляція Цей клас призначений для роботи з кореляціями. Посилання на об'єкти:\ - [Кореляція](/manual/api/reference/correlation/object#correlation) Доступні методи:\ - [correlation.create](/manual/api/reference/correlation/create) - створення нових кореляцій - [correlation.delete](/manual/api/reference/correlation/delete) - видалення кореляцій - [correlation.get](/manual/api/reference/correlation/get) - отримання кореляцій - [correlation.update](/manual/api/reference/correlation/update) - оновлення кореляцій # correlation.update # correlation.update #### Create a discovery action Create an action that will link discovered hosts to template "10091". Request: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Discovery action", "eventsource": 1, "status": 0, "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 21, "operator": 0, "value": "1" }, { "conditiontype": 10, "operator": 0, "value": "2" } ] }, "operations": [ { "operationtype": 6, "optemplate": [ { "templateid": "10091" } ] } ] }, "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, "status": 0, "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 21, "operator": 0, "value": "1" }, { "conditiontype": 10, "operator": 0, "value": "2" } ] }, "operations": [ { "operationtype": 6, "optemplate": [ { "templateid": "10091" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Create a discovery rule Create a discovery rule to find machines running the Zabbix agent in the local network. The rule must use a single Zabbix agent check on port 10050. Request: ```json { "jsonrpc": "2.0", "method": "drule.create", "params": { "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "dchecks": [ { "type": "9", "key_": "system.uname", "ports": "10050", "uniq": "0" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Створіть правило відкриття Створіть правило виявлення, щоб знайти машини, на яких працює агент Zabbix у локальній мережі. Правило має використовувати одну перевірку агента 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 "AlmaLinux". Request: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers", "eventsource": "2", "status": "0", "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», якщо ім’я вузла мережі містить «SRV» або метадані містять «AlmaLinux». Запит: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers", "eventsource": "2", "status": "0", "filter": { "evaltype": "2", "conditions": [ { "conditiontype": "22", "operator": "2", "value": "SRV" }, { "conditiontype": "24", "operator": "2", "value": "AlmaLinux" } ] }, "operations": [ { "operationtype": "4", "opgroup": [ { "groupid": "2" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### Create a 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 } ``` #### Створіть нову кореляцію тегів події Створіть кореляцію за допомогою методу оцінки «І/АБО» з однією умовою та однією операцією. За замовчуванням кореляція буде ввімкнена. Запит: ```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 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 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: ```json { "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: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### Створіть тригерну дію Створіть дію, яка виконуватиметься, коли тригер із хосту "10084", який містить слово "пам'ять" у своєму імені, переходить у стан проблеми. Дія повинна спочатку надіслати повідомлення всім користувачам у групі користувачів «7». Якщо подію не буде вирішено протягом 4 хвилин, буде запущено сценарій «3» на всіх хостах у групі «2». Під час відновлення тригера він сповістить усіх користувачів, які раніше отримували будь-які повідомлення щодо проблеми. Після оновлення тригера повідомлення з настроюваною темою та основним текстом буде надіслано всім, хто залишив підтвердження та коментарі через усі типи медіа. Запит: ```json { "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 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### 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 } ``` #### Створення інформаційної панелі Створіть інформаційну панель під назвою «Моя інформаційна панель» з одним віджетом «Проблеми» з тегами та використовуючи два типи спільного доступу (група користувачів і користувач) на одній сторінці інформаційної панелі. Запит: ```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 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 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 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» з інтерфейсом 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 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. ::: #### Створення нового елемента Тепер створіть новий [item](/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`, як і інші методи *create*, також може приймати масиви об'єктів і створювати декілька елементів одним викликом API. ::: #### 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 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 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 } ``` Успішна відповідь міститиме ідентифікатори новостворених тригерів: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 4 } ``` ### Cryptography ### Криптографія #### dashboard Changes:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) added new widget type `slareport` and widget field types *(9 - Service, 10 - SLA)*.\ [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) added new widget type `item`.\ #### dashboard Зміни:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) додано новий тип віджетів `slareport` і типи полів віджетів *(9 - Сервіс, 10 - SLA)*.\ [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) додано новий тип віджета `item`.\ # dashboard.create # dashboard.create # dashboard.delete # dashboard.delete # dashboard.get # dashboard.get # > Dashboard object The following objects are directly related to the `dashboard` API. # > Об'єкт інформаційної панелі Наступні об’єкти безпосередньо пов’язані з API `dashboard`. ### Dashboard page The dashboard page object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboard\_pageid|string|*(readonly)* ID of the dashboard page.| |name|string|Dashboard page name.<br><br>Default: empty string.| |display\_period|integer|Dashboard page display period (in seconds).<br><br>Possible values: 0, 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 0 (will use the default page display period).| |widgets|array|Array of the [dashboard widget](object#dashboard-widget) objects.| ### Сторінка інформаційної панелі Об’єкт сторінки приладної дошки має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |dashboard\_pageid|рядок|*(лише читання)* Ідентифікатор сторінки приладної дошки.| |ім'я|рядок|Назва сторінки інформаційної панелі.<br><br>За замовчуванням: порожній рядок.| |display\_period|integer|Період відображення сторінки інформаційної панелі (у секундах).<br><br>Можливі значення: 0, 10, 30, 60, 120, 600, 1800, 3600.<br><br>За замовчуванням: 0 (використовуватиме період відображення сторінки за замовчуванням).| |widgets|array|Масив об’єктів [віджет інформаційної панелі](object#dashboard-widget).| ### 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 інформаційної панелі.| |**назва**<br>(обов’язково)|рядок|Назва інформаційної панелі.| |ідентифікатор користувача|рядок|Ідентифікатор користувача інформаційної панелі власника.| |приватне|ціле|Тип спільного доступу до інформаційної панелі.<br><br>Можливі значення:<br>0 - загальнодоступна інформаційна панель;<br>1 - *(за замовчуванням)* приватна інформаційна панель.| |display\_period|integer|Період відображення сторінки за умовчанням (у секундах).<br><br>Можливі значення: 10, 30, 60, 120, 600, 1800, 3600.<br><br>За замовчуванням: 30.| |auto\_start|integer|Автоматичний запуск слайд-шоу.<br><br>Можливі значення:<br>0 - не запускати слайд-шоу автоматично;<br>1 - *(за замовчуванням)* автоматично запускати слайд-шоу.| Зауважте, що для деяких методів (оновлення, видалення) комбінація обов’язкових/необов’язкових параметрів відрізняється. # Dashboard This class is designed to work with dashboards. Object references:\ - [Dashboard](/manual/api/reference/dashboard/object#dashboard) - [Dashboard page](/manual/api/reference/dashboard/object#dashboard_page) - [Dashboard widget](/manual/api/reference/dashboard/object#dashboard_widget) - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard_widget_field) - [Dashboard user](/manual/api/reference/dashboard/object#dashboard_user) - [Dashboard user group](/manual/api/reference/dashboard/object#dashboard_user_group) Available methods:\ - [dashboard.create](/manual/api/reference/dashboard/create) - creating new dashboards - [dashboard.delete](/manual/api/reference/dashboard/delete) - deleting dashboards - [dashboard.get](/manual/api/reference/dashboard/get) - retrieving dashboards - [dashboard.update](/manual/api/reference/dashboard/update) - updating dashboards # Панель приладів Цей клас призначений для роботи з інформаційними панелями. Посилання на об'єкти:\ - [Інформаційна панель](/manual/api/reference/dashboard/object#dashboard) - [Сторінка панелі інструментів](/manual/api/reference/dashboard/object#dashboard_page) - [Віджет інформаційної панелі](/manual/api/reference/dashboard/object#dashboard_widget) - [Поле віджета інформаційної панелі](/manual/api/reference/dashboard/object#dashboard_widget_field) - [Користувач інформаційної панелі](/manual/api/reference/dashboard/object#dashboard_user) - [Група користувачів панелі інструментів](/manual/api/reference/dashboard/object#dashboard_user_group) Доступні методи:\ - [dashboard.create](/manual/api/reference/dashboard/create) - створення нових інформаційних панелей - [dashboard.delete](/manual/api/reference/dashboard/delete) - видалення інформаційних панелей - [dashboard.get](/manual/api/reference/dashboard/get) - отримання інформаційних панелей - [dashboard.update](/manual/api/reference/dashboard/update) - оновлення інформаційних панелей # 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#data_types)|Опис| |--|--|------| |**usrgrpid**<br>(обов’язково)|рядок|Ідентифікатор групи користувачів.| |**дозвіл**<br>(обов’язково)|ціле|Тип рівня дозволу.<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#data_types)|Опис| |--|--|------| |**userid**<br>(обов’язково)|рядок|Ідентифікатор користувача.| |**permission**<br>(обов’язково)|ціле|Тип рівня дозволу.<br><br>Можливі значення:<br>2 - лише читання;<br>3 - читання-запис;| ### 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#data_types)|Опис| |--|--|------| |**тип**<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 - SLA.| |**назва**<br>(обов’язково)|рядок|Ім’я поля віджета.<br><br>Можливі значення: див. [Поля віджета панелі інструментів](/manual/api/reference/dashboard/widget_fields).| |**значення**<br>(обов’язково)|змішане|Значення поля віджета залежно від типу.<br><br>Можливі значення: див. [Поля віджета панелі інструментів](/manual/api/reference/dashboard/widget_fields) .| # dcheck.get # dcheck.get #### 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 } ``` #### Видалити інтерфейс хоста Видаліть інтерфейс хоста з ідентифікатором 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 } ``` #### 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 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 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 } ``` ### 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. ::: ### Опис `configuration.importcompare(object parameters)` Цей метод дозволяє порівняти файл імпорту з поточними елементами системи та показує, що зміниться, якщо цей файл імпорту буде імпортовано. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `boolean configuration.import(object parameters)` This method allows to import configuration data from a serialized string. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `boolean configuration.import(object parameters)` Цей метод дозволяє імпортувати конфігураційні дані з серіалізованого рядка. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array action.get(object parameters)` The method allows to retrieve actions according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array action.get(object parameters)` Метод дозволяє отримати дії за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача] /manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array alert.get(object parameters)` The method allows to retrieve alerts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array alert.get(object parameters)` Метод дозволяє отримувати оповіщення за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array auditlog.get(object parameters)` The method allows to retrieve audit log records according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array auditlog.get(object parameters)` Метод дозволяє отримувати записи журналу аудиту за заданими параметрами. ::: noteclassic Цей метод доступний лише для користувачів типу *Суперадміністратор*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача (/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array correlation.get(object parameters)` The method allows to retrieve correlations according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array correlation.get(object parameters)` Метод дозволяє відновлювати кореляції за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array dashboard.get(object parameters)` The method allows to retrieve dashboards according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array dashboard.get(object parameters)` Метод дозволяє отримати дашборди за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array dcheck.get(object parameters)` The method allows to retrieve discovery checks according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array dcheck.get(object parameters)` Метод дозволяє отримувати перевірки виявлення за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array dhost.get(object parameters)` The method allows to retrieve discovered hosts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array dhost.get(object parameters)` Метод дозволяє отримати виявлені хости за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array discoveryrule.get(object parameters)` The method allows to retrieve LLD rules according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array discoveryrule.get(object parameters)` Метод дозволяє отримати правила LLD за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array drule.get(object parameters)` The method allows to retrieve discovery rules according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array drule.get(object parameters)` Метод дозволяє отримати правила виявлення за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array dservice.get(object parameters)` The method allows to retrieve discovered services according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array dservice.get(object parameters)` Метод дозволяє отримати виявлені сервіси за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array event.get(object parameters)` The method allows to retrieve events according to the given parameters. ::: noteimportant This method may return events of a deleted entity if these events have not been removed by the housekeeper yet. ::: ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array event.get(object parameters)` Метод дозволяє отримувати події за заданими параметрами. ::: noteimportant Цей метод може повертати події видаленої сутності, якщо ці події ще не були видалені службою очистки історії. ::: ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array graph.get(object parameters)` The method allows to retrieve graphs according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array graph.get(object parameters)` Метод дозволяє отримувати графіки за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array graphitem.get(object parameters)` The method allows to retrieve graph items according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array graphitem.get(object parameters)` Метод дозволяє отримувати елементи графа за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array graphprototype.get(object parameters)` The method allows to retrieve graph prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array graphprototype.get(object parameters)` Метод дозволяє отримувати прототипи графів за заданими параметрами. ::: 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(object parameters)` Метод дозволяє отримати список вузлів кластера високої доступності відповідно до заданих параметрів. ::: noteclassic Цей метод доступний лише для користувачів типу *Super admin*. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array host.get(object parameters)` The method allows to retrieve hosts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array host.get(object parameters)` Метод дозволяє отримати хости за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `integer/array hostgroup.get(object parameters)` The method allows to retrieve host groups according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `integer/array hostgroup.get(object parameters)` Метод дозволяє отримати групи хостів за заданими параметрами. ::: 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(object parameters)` Метод дозволяє отримати інтерфейси хостів відповідно до заданих параметрів. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object action.create(object/array actions)` This method allows to create new actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object action.create(object/array actions)` Цей метод дозволяє створювати нові дії. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object action.delete(array actionIds)` This method allows to delete actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object action.delete(array actionIds) Цей спосіб дозволяє видаляти дії. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача (/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object action.update(object/array actions)` This method allows to update existing actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object action.update(object/array actions)` Цей метод дозволяє оновлювати існуючі дії. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object authentication.get(object parameters)` The method allows to retrieve authentication object according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object authentication.get(object parameters)' Метод дозволяє отримати об'єкт аутентифікації за заданими параметрами. ::: noteclassic Цей метод доступний лише для користувачів типу *Суперадміністратор*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача (/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object authentication.update(object authentication)` This method allows to update existing authentication settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object authentication.update(object authentication)` Цей метод дозволяє оновити існуючі налаштування автентифікації. ::: noteclassic Цей метод доступний лише для користувачів типу *Суперадміністратор*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object autoregistration.get(object parameters)` The method allows to retrieve autoregistration object according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object autoregistration.get(object parameters)` Метод дозволяє отримати об'єкт авторегеляції відповідно до заданих параметрів. ::: NoteClassic Цей метод доступний лише для типу користувача Super Admin *. Дозволи на виклик методу можуть бути скасовані в налаштуваннях ролей користувача. Для отримання додаткової інформації див. ::: ### Description `object autoregistration.update(object autoregistration)` This method allows to update existing autoregistration. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object autoregistration.update(object autoregistration)` Цей спосіб дозволяє оновити існуючу автореєстрацію. ::: noteclassic Цей метод доступний лише для користувачів типу *Суперадміністратор*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Для отримання додаткової інформації див. [Ролі користувача] /manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `object correlation.create(object/array correlations)` This method allows to create new correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object correlation.create(object/array correlations)` Цей метод дозволяє створювати нові кореляції. ::: noteclassic Цей метод доступний лише для користувачів типу *Суперадміністратор*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object correlation.delete(array correlationids)` This method allows to delete correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object correlation.delete(array correlationids)` Цей метод дозволяє видалити кореляції. ::: noteclassic Цей метод доступний лише для користувачів типу *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object correlation.update(object/array correlations)` This method allows to update existing correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object correlation.update(object/array correlations)` Цей метод дозволяє оновити існуючі кореляції. ::: noteclassic Цей метод доступний лише для користувачів типу *Суперадміністратор*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object dashboard.create(object/array dashboards)` This method allows to create new dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object dashboard.create(object/array dashboards)` Цей метод дозволяє створювати нові інформаційні панелі. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object dashboard.delete(array dashboardids)` This method allows to delete dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object dashboard.delete(array dashboardids)` Цей спосіб дозволяє видаляти інформаційні панелі. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object dashboard.update(object/array dashboards)` This method allows to update existing dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object dashboard.update(object/array dashboards)` Цей метод дозволяє оновити наявні інформаційні панелі. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object discoveryrule.copy(object parameters)` This method allows to copy LLD rules with all of the prototypes to the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object discoveryrule.copy(object parameters)` Цей метод дозволяє скопіювати правила LLD з усіма прототипами на задані хости. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача (/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object discoveryrule.create(object/array lldRules)` This method allows to create new LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `Object Discoveryrule.create(object/array lldRules)` Цей метод дозволяє створювати нові правила LLD. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object discoveryrule.delete(array lldRuleIds)` This method allows to delete LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object discoveryrule.delete(array lldRuleIds)` Цей метод дозволяє видалити правила LLD. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object discoveryrule.update(object/array lldRules)` This method allows to update existing LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object discoveryrule.update(object/array lldRules)` Цей метод дозволяє оновити існуючі правила LLD. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object drule.create(object/array discoveryRules)` This method allows to create new discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object drule.create(object/array discoveryRules)` Цей метод дозволяє створювати нові правила відкриття. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object drule.delete(array discoveryRuleIds)` This method allows to delete discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object drule.delete(array discoveryRuleIds)` Цей метод дозволяє видалити правила виявлення. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object drule.update(object/array discoveryRules)` This method allows to update existing discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object drule.update(object/array discoveryRules)` Цей метод дозволяє оновити існуючі правила виявлення. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object event.acknowledge(object/array parameters)` This method allows to update events. Following update actions can be performed: - Close event. If event is already resolved, this action will be skipped. - Acknowledge event. If event is already acknowledged, this action will be skipped. - Unacknowledge event. If event is not acknowledged, this action will be skipped. - Add message. - Change event severity. If event already has same severity, this action will be skipped. ::: noteimportant Only trigger events can be updated.\ Only problem events can be updated.\ Read/Write rights for trigger are required to close the event or to change event's severity.\ To close an event, manual close should be allowed in the trigger. ::: ::: 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 event.acknowledge(object/array parameters)` Цей метод дозволяє оновлювати події. Можна виконати такі дії оновлення: - Закрити подію. Якщо подію вже вирішено, цю дію буде пропущено. - Підтвердити подію. Якщо подію вже підтверджено, ця дія буде пропущена. - Подія непідтвердження. Якщо подію не підтверджено, ця дія буде пропущена. - Додати повідомлення. - Зміна серйозності події. Якщо подія вже має такий самий рівень серйозності, цю дію буде пропущено. ::: noteimportant Можна оновити лише тригерні події.\ Лише проблемні події можна оновити.\ Щоб закрити подію або змінити серйозність події, потрібні права читання/запису для тригера.\ Щоб закрити подію, у тригері має бути дозволено ручне закриття. ::: ::: 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(object/array graphs)` Цей метод дозволяє створювати нові графіки. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object graph.delete(array graphIds)` This method allows to delete graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object graph.delete(array graphIds)` Цей спосіб дозволяє видаляти графіки. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object graphprototype.create(object/array graphPrototypes)` This method allows to create new graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object graphprototype.create(object/array graphPrototypes)` Цей метод дозволяє створювати нові прототипи графів. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object graphprototype.delete(array graphPrototypeIds)` This method allows to delete graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object graphprototype.delete(array graphPrototypeIds)` Цей метод дозволяє видаляти прототипи графів. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object graphprototype.update(object/array graphPrototypes)` This method allows to update existing graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object graphprototype.update(object/array graphPrototypes)` Цей метод дозволяє оновлювати існуючі прототипи графів. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object graph.update(object/array graphs)` This method allows to update existing graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `Object graph.update(Object/Array graphs)` Цей метод дозволяє оновлювати існуючі графіки. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object history.clear(array itemids)` This method allows to clear item history. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object history.clear(array itemids)` Цей метод дозволяє очистити історію елементів. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object host.create(object/array hosts)` This method allows to create new hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object host.create(object/array hosts)` Цей метод дозволяє створювати нові хости. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object host.delete(array hosts)` This method allows to delete hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object host.delete(array hosts)` Цей метод дозволяє видаляти хости. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object hostgroup.create(object/array hostGroups)` This method allows to create new host groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object hostgroup.create(object/array hostGroups)` Цей метод дозволяє створювати нові групи хостів. ::: noteclassic Цей метод доступний лише для користувачів типу *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object hostgroup.delete(array hostGroupIds)` This method allows to delete host groups. A host group can not be deleted if: - it contains hosts that belong to this group only; - it is marked as internal; - it is used by a host prototype; - it is used in a global script; - it is used in a correlation condition. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object hostgroup.delete(array hostGroupIds)` Цей метод дозволяє видаляти групи хостів. Групу хостів не можна видалити, якщо: - містить хости, які належать лише до цієї групи; - позначено як внутрішнє; - використовується прототипом хоста; - використовується в глобальному сценарії; - використовується в умові кореляції. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object hostgroup.massadd(object parameters)` This method allows to simultaneously add multiple related objects to all the given host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object hostgroup.massadd(object parameters)` Цей метод дозволяє одночасно додавати кілька пов’язаних об’єктів до всіх заданих груп хостів. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object hostgroup.massremove(object parameters)` This method allows to remove related objects from multiple host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object hostgroup.massremove(object parameters)` Цей метод дозволяє видалити пов’язані об’єкти з кількох груп хостів. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object hostgroup.massupdate(object parameters)` This method allows to replace hosts and templates with the specified ones in multiple host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object hostgroup.massupdate(object parameters)` Цей метод дозволяє замінювати хости та шаблони на вказані в кількох групах хостів. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object hostgroup.update(object/array hostGroups)` This method allows to update existing hosts groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object hostgroup.update(object/array hostGroups)` Цей метод дозволяє оновити існуючі групи хостів. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object hostinterface.create(object/array hostInterfaces)` Цей метод дозволяє створювати нові хост-інтерфейси. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object hostinterface.delete(array hostInterfaceIds)` This method allows to delete host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object hostinterface.delete(array hostInterfaceIds)` Цей метод дозволяє видаляти інтерфейси хостів. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object hostinterface.massadd(object parameters)` This method allows to simultaneously add host interfaces to multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object hostinterface.massadd(object parameters)` Цей метод дозволяє одночасно додавати інтерфейси хостів до кількох хостів. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object hostinterface.massremove(object parameters)` This method allows to remove host interfaces from the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object hostinterface.massremove(object parameters)` Цей метод дозволяє видалити інтерфейси хостів із заданих хостів. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object hostinterface.replacehostinterfaces(object parameters)` This method allows to replace all host interfaces on a given host. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object hostinterface.replacehostinterfaces(object parameters)` Цей метод дозволяє замінити всі інтерфейси вузлів на заданому вузлі. ::: noteclassic Цей метод доступний лише для користувачів типу *Адміністратор* чи *Супер-адміністратор*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Перегляньте [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ### Description `object housekeeping.get(object parameters)` The method allows to retrieve housekeeping object according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Опис `object housekeeping.get(object parameters)` Метод дозволяє отримати об'єкт господарювання за заданими параметрами. ::: 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(object housekeeping)` Цей спосіб дозволяє оновити існуючі налаштування домашнього господарства. ::: 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 `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(object parameters)` Цей метод дозволяє експортувати дані конфігурації як серіалізований рядок. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## ОПИС **zabbix\_agent2** — додаток для моніторингу параметрів різних сервісів.\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## ОПИС **zabbix\_agentd** — це демон для моніторингу різних параметрів сервера. [ ]{#lbAE} ## DESCRIPTION **zabbix\_get** is a command line utility for getting data from Zabbix agent. [ ]{#lbAE} ## ОПИС **zabbix\_get** — утиліта командного рядка для отримання даних від агента Zabbix. [ ]{#lbAE} ## DESCRIPTION **zabbix\_js** is a command line utility that can be used for embedded script testing. [ ]{#lbAE} ## ОПИС **zabbix\_js** — це утиліта командного рядка, яку можна використовувати для тестування вбудованих сценаріїв. [ ]{#lbAE} ## DESCRIPTION **zabbix\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE} ## ОПИС **zabbix\_proxy** — це демон, який збирає дані моніторингу з пристроїв і надсилає їх на сервер Zabbix. [ ]{#lbAE} ## DESCRIPTION **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE} ## ОПИС **zabbix\_sender** — це утиліта командного рядка для надсилання даних моніторингу на сервер або проксі Zabbix. На сервері Zabbix має бути створений елемент типу **Zabbix trapper** з відповідним ключем. Зауважте, що вхідні значення прийматимуться лише від хостів, указаних у полі **Allowed hosts** для цього елемента. [ ]{#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 tag The details object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>1 - (default) - use bulk requests.| |community|string|SNMP community (required). Used only by SNMPv1 and SNMPv2 interfaces.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.| |privpassphrase|string|SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.| |authprotocol|integer|SNMPv3 authentication protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 context name. Used only by SNMPv3 interfaces.| ### Тег деталей Об'єкт деталей має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**version**<br>(required)|integer|Версія інтерфейсу SNMP.<br><br>Можливі значення:<br>1 – SNMPv1;<br>2 – SNMPv2c;<br>3 – SNMPv3| |bulk|integer|Чи використовувати масові запити SNMP.<br><br>Можливі значення:<br>0 - не використовувати масові запити;<br>1 - (за замовчуванням) - використовувати масові запити.| |community|string|Спільнота SNMP (обов'язково). Використовується лише інтерфейсами SNMPv1 та SNMPv2.| |securityname|string|Назва безпеки SNMPv3. Використовується лише інтерфейсами SNMPv3.| |securitylevel|integer|Рівень безпеки SNMPv3. Використовується лише інтерфейсами SNMPv3.<br><br>Можливі значення:<br>0 - (за замовчуванням) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 пароль автентифікації. Використовується лише інтерфейсами SNMPv3.| |privpassphrase|string|SNMPv3 пароль конфіденційності. Використовується лише інтерфейсами SNMPv3.| |authprotocol|integer|Протокол автентифікації SNMPv3. Використовується лише інтерфейсами SNMPv3.<br><br>Можливі значення:<br>0 - (за замовчуванням) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br >4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 протокол конфіденційності. Використовується лише інтерфейсами SNMPv3.<br><br>Можливі значення:<br>0 - (за замовчуванням) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br >4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 ім'я контексту. Використовується лише інтерфейсами SNMPv3.| #### 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. #### Розробка модулів Перевага надається проектуванню шаблонів програмного забезпечення за моделлю "модель-вид-контролер" (MVC - Model-view-controller), оскільки вона також використовується в Zabbix frontend і полегшить розробку. Сувора типізація PHP також вітається, але не є обов'язковою. Зверніть увагу, що за допомогою модулів ви можете легко додавати нові пункти меню та відповідні візуалізації і дії до фронтенду Zabbix. Наразі неможливо зареєструвати новий API або створити нові таблиці бази даних за допомогою модулів. # dhost.get # dhost.get #### Disable action Disable action, that is, set its status to "1". Request: ```json { "jsonrpc": "2.0", "method": "action.update", "params": { "actionid": "2", "status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "2" ] }, "id": 1 } ``` #### Вимкнути дію Відключити дію, тобто встановити її статус на «1». Запит: ```json { "jsonrpc": "2.0", "method": "action.update", "params": { "actionid": "2", "status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "2" ] }, "id": 1 } ``` #### Disable correlation Request: ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "status": "1" }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Вимкнути кореляцію Запит: ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "status": "1" }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Disable trapping Disable LLD trapping for discovery rule. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "28336", "allow_traps": 0 }, "id": 36, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28336" ] }, "id": 36 } ``` #### Вимкнути захоплення Вимкнути перехоплення LLD для правила виявлення. Запит: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "28336", "allow_traps": 0 }, "id": 36, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28336" ] }, "id": 36 } ``` ### 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 з активного основного сервера - перезапустіть основний сервер (він запуститься в автономному режимі) ### 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|рядок|ID виявленого хоста.| |druleid|рядок|ID правила виявлення, яке виявило хост.| |lastdown|мітка часу|Час останнього виходу з ладу знайденого хоста.| |lastup|мітка часу|Час, коли виявлений хост востаннє піднімався.| |статус|ціле число|Чи відкритий хост працює чи не працює. Хост працює, якщо на ньому є принаймні одна активна виявлена служба.<br><br>Можливі значення:<br>0 - хост працює;<br>1 - хост не працює.| # > Discovered host object The following objects are directly related to the `dhost` API. # > Виявлений хост-об’єкт Наступні об’єкти безпосередньо пов’язані з `dhost` API. # Discovered host This class is designed to work with discovered hosts. Object references:\ - [Discovered host](/manual/api/reference/dhost/object#discovered_host) Available methods:\ - [dhost.get](/manual/api/reference/dhost/get) - retrieve discovered hosts # Виявлений хост Цей клас призначений для роботи з відкритими хостами. Посилання на об'єкти:\ - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) Доступні методи:\ - [dhost.get](/manual/api/reference/dhost/get) - отримати виявлені хости ### Discovered service ::: noteclassic Discovered services are created by the Zabbix server and cannot be modified via the API. ::: The discovered service object contains information about a service discovered by a network discovery rule on a host. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dserviceid|string|ID of the discovered service.| |dcheckid|string|ID of the discovery check used to detect the service.| |dhostid|string|ID of the discovered host running the service.| |dns|string|DNS of the host running the service.| |ip|string|IP address of the host running the service.| |lastdown|timestamp|Time when the discovered service last went down.| |lastup|timestamp|Time when the discovered service last went up.| |port|integer|Service port number.| |status|integer|Status of the service.<br><br>Possible values:<br>0 - service up;<br>1 - service down.| |value|string|Value returned by the service when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.| ### Виявлена служба ::: noteclassic Виявлені служби створюються сервером Zabbix і не можуть бути змінені через API. ::: Виявлений об’єкт служби містить інформацію про службу, виявлену за допомогою правила виявлення мережі на хості. Має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |dserviceid|рядок|ID виявленої служби.| |dcheckid|рядок|Ідентифікатор перевірки відкриття, який використовується для виявлення служби.| |dhostid|рядок|Ідентифікатор виявленого хоста, на якому запущена служба.| |dns|рядок|DNS хоста, на якому запущена служба.| |ip|рядок|IP-адреса хоста, на якому запущена служба.| |lastdown|мітка часу|Час останнього вимкнення знайденої служби.| |lastup|timestamp|Час останнього підключення знайденої служби.| |порт|ціле|Номер порту служби.| |статус|ціле|Статус служби.<br><br>Можливі значення:<br>0 - послуга активна;<br>1 - служба не працює.| |значення|рядок|Значення, яке повертає служба під час виконання перевірки виявлення агента Zabbix, SNMPv1, SNMPv2 або SNMPv3.| # > Discovered service object The following objects are directly related to the `dservice` API. # > Виявлений службовий об'єкт Наступні об’єкти безпосередньо пов’язані з `dservice` API. # Discovered service This class is designed to work with discovered services. Object references:\ - [Discovered service](/manual/api/reference/dservice/object#discovered_service) Available methods:\ - [dservice.get](/manual/api/reference/dservice/get) - retrieve discovered services # Виявлена служба Цей клас призначений для роботи з виявленими службами. Посилання на об'єкти:\ - [Виявлена служба](/manual/api/reference/dservice/object#discovered_service) Доступні методи:\ - [dservice.get](/manual/api/reference/dservice/get) - отримати виявлені служби # > Discovery check object The following objects are directly related to the `dcheck` API. # > Об'єкт перевірки виявлення Наступні об’єкти безпосередньо пов’язані з `dcheck` API. ### Discovery check The discovery check object defines a specific check performed by a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dcheckid|string|*(readonly)* ID of the discovery check.| |druleid|string|*(readonly)* ID of the discovery rule that the check belongs to.| |key\_|string|The value of this property differs depending on the type of the check:<br>- key to query for Zabbix agent checks, required;<br>- SNMP OID for SNMPv1, SNMPv2 and SNMPv3 checks, required.| |ports|string|One or several port ranges to check separated by commas. Used for all checks except for ICMP.<br><br>Default: 0.| |snmp\_community|string|SNMP community.<br><br>Required for SNMPv1 and SNMPv2 agent checks.| |snmpv3\_authpassphrase|string|Authentication passphrase used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.| |snmpv3\_authprotocol|integer|Authentication protocol used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.<br><br>Possible values:<br>0 - *(default)* MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |snmpv3\_contextname|string|SNMPv3 context name. Used only by SNMPv3 checks.| |snmpv3\_privpassphrase|string|Privacy passphrase used for SNMPv3 agent checks with security level set to *authPriv*.| |snmpv3\_privprotocol|integer|Privacy protocol used for SNMPv3 agent checks with security level set to *authPriv*.<br><br>Possible values:<br>0 - *(default)* DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |snmpv3\_securitylevel|string|Security level used for SNMPv3 agent checks.<br><br>Possible values:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |snmpv3\_securityname|string|Security name used for SNMPv3 agent checks.| |**type**<br>(required)|integer|Type of check.<br><br>Possible values:<br>0 - SSH;<br>1 - LDAP;<br>2 - SMTP;<br>3 - FTP;<br>4 - HTTP;<br>5 - POP;<br>6 - NNTP;<br>7 - IMAP;<br>8 - TCP;<br>9 - Zabbix agent;<br>10 - SNMPv1 agent;<br>11 - SNMPv2 agent;<br>12 - ICMP ping;<br>13 - SNMPv3 agent;<br>14 - HTTPS;<br>15 - Telnet.| |uniq|integer|Whether to use this check as a device uniqueness criteria. Only a single unique check can be configured for a discovery rule. Used for Zabbix agent, SNMPv1, SNMPv2 and SNMPv3 agent checks.<br><br>Possible values:<br>0 - *(default)* do not use this check as a uniqueness criteria;<br>1 - use this check as a uniqueness criteria.| |host\_source|integer|Source for host name.<br><br>Possible values:<br>1 - *(default)* DNS;<br>2 - IP;<br>3 - discovery value of this check.| |name\_source|integer|Source for visible name.<br><br>Possible values:<br>0 - *(default)* not specified;<br>1 - DNS;<br>2 - IP;<br>3 - discovery value of this check.| ### Перевірка відкриття Об’єкт перевірки виявлення визначає конкретну перевірку, що виконується правилом виявлення мережі. Має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |dcheckid|рядок|*(лише для читання)* Ідентифікатор перевірки виявлення.| |druleid|рядок|*(лише для читання)* Ідентифікатор правила виявлення, до якого належить перевірка.| |key\_|string|Значення цієї властивості відрізняється залежно від типу перевірки:<br>- обов’язковий ключ для запиту на перевірки агента Zabbix;<br>- SNMP OID для перевірок SNMPv1, SNMPv2 і SNMPv3 .| |ports|string|Один або кілька діапазонів портів для перевірки, розділених комами. Використовується для всіх перевірок, крім ICMP.<br><br>За замовчуванням: 0.| |snmp\_community|рядок|Спільнота SNMP.<br><br>Потрібно для перевірки агента SNMPv1 і SNMPv2.| |snmpv3\_authpassphrase|рядок|Парольна фраза автентифікації, яка використовується для перевірок агента SNMPv3 із встановленим рівнем безпеки *authNoPriv* або *authPriv*.| |snmpv3\_authprotocol|ціле число|Протокол автентифікації, який використовується для перевірок агента SNMPv3 із встановленим рівнем безпеки *authNoPriv* або *authPriv*.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* MD5;<br >1 – SHA1;<br>2 – SHA224;<br>3 – SHA256;<br>4 – SHA384;<br>5 – SHA512.| |snmpv3\_contextname|рядок|ім'я контексту SNMPv3. Використовується лише перевірками SNMPv3.| |snmpv3\_privpassphrase|рядок|Парольна фраза конфіденційності, яка використовується для перевірок агента SNMPv3 із встановленим рівнем безпеки *authPriv*.| |snmpv3\_privprotocol|ціле|Протокол конфіденційності, який використовується для перевірок агента SNMPv3 із встановленим рівнем безпеки *authPriv*.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* DES;<br>1 - AES128 ;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |snmpv3\_securitylevel|рядок|Рівень безпеки, який використовується для перевірок агента SNMPv3.<br><br>Можливі значення:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |snmpv3\_securityname|рядок|Ім'я безпеки, яке використовується для перевірок агента SNMPv3.| |**тип**<br>(обов’язково)|ціле|Тип перевірки.<br><br>Можливі значення:<br>0 - SSH;<br>1 - LDAP;<br>2 - SMTP;< br>3 - FTP;<br>4 - HTTP;<br>5 - POP;<br>6 - NNTP;<br>7 - IMAP;<br>8 - TCP;<br>9 - Zabbix agent;< br>10 - агент SNMPv1;<br>11 - агент SNMPv2;<br>12 - пінг ICMP;<br>13 - агент SNMPv3;<br>14 - HTTPS;<br>15 - Telnet.| |uniq|integer|Чи використовувати цю перевірку як критерій унікальності пристрою. Для правила виявлення можна налаштувати лише одну унікальну перевірку. Використовується для перевірки агента Zabbix, SNMPv1, SNMPv2 і SNMPv3.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* не використовувати цю перевірку як критерій унікальності;<br>1 - використовувати цю перевірку як критерій унікальності.| |host\_source|integer|Джерело для імені хоста.<br><br>Можливі значення:<br>1 - *(за замовчуванням)* DNS;<br>2 - IP;<br>3 - значення виявлення цієї перевірки .| |name\_source|ціле число|Джерело для видимого імені.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* не вказано;<br>1 - DNS;<br>2 - IP;<br >3 - значення відкриття цієї перевірки.| # Discovery check This class is designed to work with discovery checks. Object references:\ - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) Available methods:\ - [dcheck.get](/manual/api/reference/dcheck/get) - retrieve discovery checks # Перевірка виявлення Цей клас призначений для роботи з перевірками виявлення. Посилання на об'єкти:\ - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) Доступні методи:\ - [dcheck.get](/manual/api/reference/dcheck/get) - отримати перевірки виявлення #### discoveryrule Bug fixes:\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `discoveryrule.create`, `discoveryrule.update`: property `interfaceid` is no longer required to create/update a HTTP agent type LLD rule.\ #### правило виявлення Виправлення помилок:\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `discoveryrule.create`, `discoveryrule.update`: властивість `interfaceid` більше не потрібна для створення/оновлення типу агента HTTP Правило LLD.\ #### discoveryrule Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `discoveryrule.update`: the parameter `uuid` can now be updated.\ #### правило виявлення Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `discoveryrule.update`: тепер можна оновити параметр `uuid`.\ # discoveryrule.copy # discoveryrule.copy # discoveryrule.create # discoveryrule.create # discoveryrule.delete # discoveryrule.delete # discoveryrule.get # discoveryrule.get # > Discovery rule object The following objects are directly related to the `drule` API. # > Об'єкт правила виявлення Наступні об’єкти безпосередньо пов’язані з API `drule`. ### 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>(обов’язково)|рядок|Назва правила виявлення.| |затримка|рядок|Інтервал виконання правила відкриття. Приймає секунди, одиниці вимірювання часу з суфіксом і макрос користувача.<br><br>За замовчуванням: 1 год.| |nextcheck|timestamp|*(лише для читання)* Час, коли правило виявлення буде виконано наступним чином.| |proxy\_hostid|рядок|Ідентифікатор проксі, який використовується для виявлення.| |статус|ціле число|Чи ввімкнено правило виявлення.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* увімкнено;<br>1 - вимкнено.| Зауважте, що для деяких методів (оновлення, видалення) комбінація обов’язкових/необов’язкових параметрів відрізняється. # Discovery rule This class is designed to work with network discovery rules. ::: notetip This API is meant to work with network discovery rules. For the low-level discovery rules see the [LLD rule API](discoveryrule). ::: Object references:\ - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) Available methods:\ - [drule.create](/manual/api/reference/drule/create) - create new discovery rules - [drule.delete](/manual/api/reference/drule/delete) - delete discovery rules - [drule.get](/manual/api/reference/drule/get) - retrieve discovery rules - [drule.update](/manual/api/reference/drule/update) - update discovery rules # Правило відкриття Цей клас призначений для роботи з правилами виявлення мережі. ::: notetip Цей API призначений для роботи з правилами виявлення мережі. Правила виявлення низького рівня див. у [API правил LLD](discoveryrule). ::: Посилання на об'єкти:\ - [Правило виявлення](/manual/api/reference/drule/object#discovery_rule) Доступні методи:\ - [drule.create](/manual/api/reference/drule/create) - створити нові правила відкриття - [drule.delete](/manual/api/reference/drule/delete) - видалити правила виявлення - [drule.get](/manual/api/reference/drule/get) - отримання правил виявлення - [drule.update](/manual/api/reference/drule/update) - оновлення правил виявлення # discoveryrule.update # discoveryrule.update #### 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. #### Відображення На основі інформації про підтвердження можна налаштувати спосіб відображення кількості проблем на інформаційній панелі чи картах. Для цього вам потрібно зробити вибір у параметрі *Відображення проблеми*, доступному як у [map configuration](/manual/config/visualization/maps/map#creating_a_map), так і в *Проблеми за ступенем тяжкості* [віджеті панелі інструментів]( /manual/web_interface/frontend_sections/monitoring/dashboard##adding_widgets). Можна відобразити кількість усіх проблем, кількість непідтверджених проблем окремо від загальної чи тільки кількість непідтверджених проблем. На основі інформації про оновлення проблеми (підтвердження тощо) можна налаштувати операції оновлення – надіслати повідомлення або виконати віддалені команди. # drule.create # drule.create # drule.delete # drule.delete # drule.get # drule.get # drule.update # drule.update # dservice.get # dservice.get #### Element tags Element tag values are explained in the table below. #### Теги елементів Значення тегів елемента пояснюються в таблиці нижче. #### Element tags Element tag values are explained in the table below. #### Теги елементів даних Значення тегів елемента даних пояснюються в таблиці нижче. ### Enabling high availability ### Увімкнення високої доступності #### 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 } ``` #### Error handling Up to that point everything we've tried has worked fine. But what happens if we try to make an incorrect call to the API? Let's try to create another host by calling [host.create](/manual/api/reference/host/create) but omitting the mandatory `groups` parameter. ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Linux server", "interfaces": [ { "type": 1, "main": 1, "useip": 1, "ip": "192.168.3.1", "dns": "", "port": "10050" } ] }, "id": 7, "auth": "0424bd59b807674191e7d77572075f33" } ``` The response will then contain an error message: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` If an error occurred, instead of the `result` property, the response object will contain an `error` property with the following data: - `code` - an error code; - `message` - a short error summary; - `data` - a more detailed error message. Errors can occur in different cases, such as, using incorrect input values, a session timeout or trying to access unexisting objects. Your application should be able to gracefully handle these kinds of errors. #### Обробка помилок До цього моменту все, що ви спробували, працювало нормально. Але що станеться, якщо ви спробуєте зробити некоректний виклик API? Спробуйте створити інший хост, викликавши [host.create](/manual/api/reference/host/create), але опустивши обов'язковий параметр `groups`: ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Linux server", "interfaces": [ { "type": 1, "main": 1, "useip": 1, "ip": "192.168.3.1", "dns": "", "port": "10050" } ] }, "id": 7, "auth": "0424bd59b807674191e7d77572075f33" } ``` Відповідь міститиме повідомлення про помилку: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` Якщо сталася помилка, замість властивості `result` об'єкт відповіді буде містити властивість `error` з наступними даними: - `code` - код помилки; - `message` - короткий опис помилки; - `data` - більш детальне повідомлення про помилку. Помилки можуть виникати у різних випадках, наприклад, при використанні неправильних вхідних даних, таймауті сеансу або спробі отримати доступ до неіснуючих об'єктів. Ваша програма повинна вміти коректно обробляти такі помилки. # event.acknowledge # event.acknowledge # event.get # event.get # > Event object The following objects are directly related to the `event` API. # > Об'єкт події Наступні об’єкти безпосередньо пов’язані з `event` API. ### 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#data_types)|Опис| |--|--|------| |тег|рядок|Назва тегу події.| |значення|рядок|Значення тегу події.| # Event This class is designed to work with events. Object references:\ - [Event](/manual/api/reference/event/object#host) Available methods:\ - [event.get](/manual/api/reference/event/get) - retrieving events - [event.acknowledge](/manual/api/reference/event/acknowledge) - acknowledging events # Подія Цей клас призначений для роботи з подіями. Посилання на об'єкти:\ - [Подія](/manual/api/reference/event/object#host) Доступні методи:\ - [event.get](/manual/api/reference/event/get) - отримання подій - [event.acknowledge](/manual/api/reference/event/acknowledge) - визнання подій ### Example ### Приклади ##### 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(/host/web.test.fail[сценарій])<>0 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ##### 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 Щоб створити тригер «Помилка веб-сценарію» з корисним описом проблеми в назві тригера, ви можете визначити тригер із назвою: Помилка веб-сценарію "Сценарій": {ITEM.VALUE} і тригерний вираз: length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ##### 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(/host/web.test.in[Scenario,,bps])<10000 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади #### Examples #### Приклади #### Examples of triggers #### Приклади тригерів ### Examples Request: ``` {.java} { "jsonrpc": "2.0", "method": "autoregistration.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tls_accept": "3" }, "id": 1 } ``` ### Приклади запит: ``` {.java} { "jsonrpc": "2.0", "method": "autoregistration.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "tls_accept": "3" }, "id": 1 } ``` ### Examples Request: ```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_ACCECT": "3", "TLS_PSK_IDENTITY": "PSK 001", "TLS_PSK": "11111595725AC58DD977BEEF14B97461A7C1045B9A1C923453302C5473193478" }, "Auth": "038e1d7b1735c6a5436ee9eae095879e", "ID": 1 } `` ` Відповідь: `` `json { "jsonrpc": "2.0", "result": true, "ID": 1 } `` ` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "housekeeping.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hk_events_mode": "1", "hk_events_trigger": "365d", "hk_events_service": "1d", "hk_events_internal": "1d", "hk_events_discovery": "1d", "hk_events_autoreg": "1d", "hk_services_mode": "1", "hk_services": "365d", "hk_audit_mode": "1", "hk_audit": "365d", "hk_sessions_mode": "1", "hk_sessions": "365d", "hk_history_mode": "1", "hk_history_global": "0", "hk_history": "90d", "hk_trends_mode": "1", "hk_trends_global": "0", "hk_trends": "365d", "db_extension": "", "compression_status": "0", "compress_older": "7d" }, "id": 1 } ``` ### Приклади Запит: ```json { "jsonrpc": "2.0", "method": "housekeeping.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "hk_events_mode": "1", "hk_events_trigger": "365d", "hk_events_service": "1d", "hk_events_internal": "1d", "hk_events_discovery": "1d", "hk_events_autoreg": "1d", "hk_services_mode": "1", "hk_services": "365d", "hk_audit_mode": "1", "hk_audit": "365d", "hk_sessions_mode": "1", "hk_sessions": "365d", "hk_history_mode": "1", "hk_history_global": "0", "hk_history": "90d", "hk_trends_mode": "1", "hk_trends_global": "0", "hk_trends": "365d", "db_extension": "", "compression_status": "0", "compress_older": "7d" }, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "housekeeping.update", "params": { "hk_events_mode": "1", "hk_events_trigger": "200d", "hk_events_internal": "2d", "hk_events_discovery": "2d" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "hk_events_mode", "hk_events_trigger", "hk_events_internal", "hk_events_discovery" ], "id": 1 } ``` ### Приклади Запит: ```json { "jsonrpc": "2.0", "method": "housekeeping.update", "params": { "hk_events_mode": "1", "hk_events_trigger": "200d", "hk_events_internal": "2d", "hk_events_discovery": "2d" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ "hk_events_mode", "hk_events_trigger", "hk_events_internal", "hk_events_discovery" ], "id": 1 } ``` ## 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 "Monitored Host" -k mysql.queries -o 342.45**\ Надішліть **342.45** як значення для елемента **mysql.queries** хосту **Monitored Host** за допомогою сервера 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 server" 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 "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**\ Надішліть **342.45** як значення для елемента **mysql.queries** у хості **Monitored Host** на сервер з IP-адресою **192.168.1.113** за допомогою TLS із сертифікатом. **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**\ Надішліть **342.45** як значення для елемента **mysql.queries** у хості **Monitored Host** на сервер з IP-адресою **192.168.1.113** за допомогою TLS зі спільним ключем (PSK). [ ]{#lbAI} ### Example workflow The following section will walk you through some usage examples in more detail. ### Приклад робочого процесу У наступному розділі ми розглянемо деякі приклади використання більш детально. ## 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} ##### 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. #### 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 #### Експорт Щоб експортувати хости, виконайте такі дії: - Перейдіть до: *Конфігурація* → *Вузли мережі* - Позначте прапорці вузлів мережі для експорту - Натисніть *Експорт* під списком  Залежно від вибраного формату хости експортуються в локальний файл із назвою за замовчуванням: - *zabbix\_export\_hosts.yaml* - в експорті YAML (параметр за замовчуванням для експорт) - *zabbix\_export\_hosts.xml* - в експорті XML - *zabbix\_export\_hosts.json* - в експорті JSON ### 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 ``` ## 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 agent 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} ### Float history The float history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|float|Received value.| ### Історія плавання Об'єкт історії float має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |годинник|мітка часу|Час, коли це значення було отримано.| |itemid|рядок|ID пов'язаного елемента.| |ns|ціле|Наносекунди, коли було отримано значення.| |value|float|Отримане значення.| ##### 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) у цій таблиці використовуються лише для впорядкування. #### 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 підтримують два загальні параметри: `item filter` (деталі див. нижче) і `time period`: foreach_function(фільтр елементів,період часу) Наприклад: `avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)` поверне п’ятихвилинне середнє значення кожного елемента «mysql.qps» у групі сервера MySQL. Зауважте, що деякі функції підтримують додаткові [параметри](#additional_parameters). ### 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 #### Загальні #### 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 } ``` #### graph Changes:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graph.get`: Graph availability doesn't depend on permissions to items specified in graph "ymin_itemid" and "ymax_itemid" fields.\ Graph having MIN or MAX Y axis linked to inaccessible items will still be accessible but MIN/MAX Y axis works the same way as if specified calculation method is "Calculated".\ #### графік Зміни:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graph.get`: доступність графіка не залежить від дозволів на елементи, указані в полях графа "ymin_itemid" і "ymax_itemid". \ Графік із MIN або MAX віссю Y, пов’язаною з недоступними елементами, все ще буде доступним, але MIN/MAX вісь Y працює так само, як якщо б указаний метод обчислення був «Обчислений».\ #### graph Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graph.update`: the parameter `uuid` can now be updated.\ #### графік Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graph.update`: тепер можна оновити параметр `uuid`.\ # graph.create # graph.create # graph.delete # graph.delete # graph.get # graph.get # graphitem.get # graphitem.get ### Graph item ::: noteclassic Graph items can only be modified via the `graph` API. ::: The graph item object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitemid|string|*(readonly)* ID of the graph item.| |**color**<br>(required)|string|Graph item's draw color as a hexadecimal color code.| |**itemid**<br>(required)|string|ID of the item.| |calc\_fnc|integer|Value of the item that will be displayed.<br><br>Possible values:<br>1 - minimum value;<br>2 - *(default)* average value;<br>4 - maximum value;<br>7 - all values;<br>9 - last value, used only by pie and exploded graphs.| |drawtype|integer|Draw style of the graph item.<br><br>Possible values:<br>0 - *(default)* line;<br>1 - filled region;<br>2 - bold line;<br>3 - dot;<br>4 - dashed line;<br>5 - gradient line.| |graphid|string|ID of the graph that the graph item belongs to.| |sortorder|integer|Position of the item in the graph.<br><br>Default: starts with 0 and increases by one with each entry.| |type|integer|Type of graph item.<br><br>Possible values:<br>0 - *(default)* simple;<br>2 - graph sum, used only by pie and exploded graphs.| |yaxisside|integer|Side of the graph where the graph item's Y scale will be drawn.<br><br>Possible values:<br>0 - *(default)* left side;<br>1 - right side.| ### Елемент графіка ::: noteclassic Елементи графіка можна змінювати лише через API `graph`. ::: Об’єкт елемента графіка має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |gitemid|рядок|*(тільки для читання)* ID елемента графіка.| |**color**<br>(обов’язково)|рядок|Колір малювання елемента графіка як шістнадцятковий код кольору.| |**itemid**<br>(обов'язково)|рядок|ID елемента.| |calc\_fnc|ціле число|Значення елемента, яке буде показано.<br><br>Можливі значення:<br>1 - мінімальне значення;<br>2 - *(за замовчуванням)* середнє значення;<br>4 - максимальне значення;<br>7 - усі значення;<br>9 - останнє значення, використовується лише для секторних і розкомпонованих графіків.| |drawtype|integer|Стиль малювання елемента графіка.<br><br>Можливі значення:<br>0 - лінія *(за замовчуванням)*;<br>1 - зафарбована область;<br>2 - жирна лінія;< br>3 - точка;<br>4 - пунктирна лінія;<br>5 - лінія градієнта.| |graphid|рядок|ID графа, до якого належить елемент графа.| |sortorder|integer|Позиція елемента на графіку.<br><br>За замовчуванням: починається з 0 і збільшується на одиницю з кожним записом.| |type|integer|Тип елемента графіка.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* простий;<br>2 - сума графіка, використовується лише для секторних і розкомпонованих графіків.| |yaxisside|ціле число|Сторона графіка, де буде намальовано шкалу Y елемента графіка.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* ліва сторона;<br>1 - права сторона.| # > Graph item object The following objects are directly related to the `graphitem` API. # > Об'єкт елемента графіка Наступні об’єкти безпосередньо пов’язані з API `graphitem`. # Graph item This class is designed to work with graph items. Object references:\ - [Graph item](/manual/api/reference/graphitem/object#graph_item) Available methods:\ - [graphitem.get](/manual/api/reference/graphitem/get) - retrieving graph items # Елемент графіка Цей клас призначений для роботи з елементами графа. Посилання на об'єкти:\ - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) Доступні методи:\ - [graphitem.get](/manual/api/reference/graphitem/get) - отримання елементів графіка # > Graph object The following objects are directly related to the `graph` API. # > Графічний об'єкт Наступні об’єкти безпосередньо пов’язані з API `graph`. #### graphprototype Changes:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graphprototype.get`: Graph prototype availability doesn't depend on permissions to items specified in graph prototype "ymin_itemid" and "ymax_itemid" fields.\ #### прототип графіку Зміни:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graphprototype.get`: доступність прототипу графа не залежить від дозволів на елементи, указані в прототипі графіку "ymin_itemid" і "ymax_itemid" поля.\ #### graphprototype Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graphprototype.update`: the parameter `uuid` can now be updated.\ #### прототип графіку Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graphprototype.update`: тепер можна оновити параметр `uuid`.\ # graphprototype.create # graphprototype.create # graphprototype.delete # graphprototype.delete # graphprototype.get # graphprototype.get # > Graph prototype object The following objects are directly related to the `graphprototype` API. # > Об'єкт прототипу Graph Наступні об’єкти безпосередньо пов’язані з API `graphprototype`. ### Graph prototype The graph prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|string|*(readonly)* ID of the graph prototype.| |**height**<br>(required)|integer|Height of the graph prototype in pixels.| |**name**<br>(required)|string|Name of the graph prototype.| |**width**<br>(required)|integer|Width of the graph prototype in pixels.| |graphtype|integer|Graph prototypes's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show discovered pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|string|*(readonly)* ID of the parent template graph prototype.| |yaxismax|float|The fixed maximum value for the Y axis.| |yaxismin|float|The fixed minimum value for the Y axis.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymin\_type would be set to '0' (calculated).| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |discover|integer|Graph prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new graphs will be discovered;<br>1 - new graphs will not be discovered and existing graphs will be marked as lost.| |uuid|string|Universal unique identifier, used for linking imported graph prototypes to already existing ones. Used only for graph prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Прототип графа Об'єкт-прототип графа має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |graphid|рядок|*(лише читання)* ID прототипу графа.| |**height**<br>(обов’язково)|ціле число|Висота прототипу графіка в пікселях.| |**name**<br>(обов'язково)|рядок|Ім'я прототипу графа.| |**width**<br>(обов'язково)|integer|Ширина прототипу графіка в пікселях.| |graphtype|integer|Тип макета прототипів графіків.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* звичайний;<br>1 - складений;<br>2 - кругова;<br>3 - вибухнув.| |percent\_left|float|Лівий процентиль.<br><br>За замовчуванням: 0.| |percent\_right|float|Правий процентиль.<br><br>За замовчуванням: 0.| |показати\_3d|ціле|Чи відображати виявлені кругові та розкомпоновані графіки в 3D.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* відображати в 2D;<br>1 - відображати в 3D. | |show\_legend|integer|Чи показувати легенду на виявленому графіку.<br><br>Можливі значення:<br>0 - приховати;<br>1 - *(за замовчуванням)* показати.| |show\_work\_period|ціле число|Чи показувати робочий час на виявленому графіку.<br><br>Можливі значення:<br>0 - приховати;<br>1 - *(за замовчуванням)* показати.| |templateid|рядок|*(лише читання)* Ідентифікатор прототипу графа батьківського шаблону.| |yaxismax|float|Фіксоване максимальне значення для осі Y.| |yaxismin|float|Фіксоване мінімальне значення для осі Y.| |ymax\_itemid|рядок|Ідентифікатор елемента, який використовується як максимальне значення для осі Y.<br><br>Починаючи з Zabbix 6.0.7, якщо користувач не має доступу до зазначеного елемента, графік відображається як ymax\_type буде встановлено на '0' (обчислено).| |ymax\_type|integer|Метод обчислення максимального значення для осі Y.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* обчислено;<br>1 - фіксоване;<br>2 - елемент .| |ymin\_itemid|рядок|Ідентифікатор елемента, який використовується як мінімальне значення для осі Y.<br><br>Починаючи з Zabbix 6.0.7, якщо користувач не має доступу до зазначеного елемента, графік відображається як ymin\_type буде встановлено на '0' (обчислено).| |ymin\_type|integer|Метод обчислення мінімального значення для осі Y.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* обчислено;<br>1 - фіксоване;<br>2 - елемент .| |discover|integer|Статус виявлення прототипу графа.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* нові графіки будуть виявлені;<br>1 - нові графіки не будуть виявлені, а існуючі - будуть бути позначений як втрачений.| |uuid|рядок|Універсальний унікальний ідентифікатор, який використовується для зв’язування імпортованих прототипів графів із уже існуючими. Використовується лише для прототипів графів у шаблонах. Автоматично генерується, якщо не вказано.<br><br>Для операцій оновлення це поле є *лише для читання*.| Зауважте, що для деяких методів (оновлення, видалення) комбінація обов’язкових/необов’язкових параметрів відрізняється. # Graph prototype This class is designed to work with graph prototypes. Object references:\ - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) Available methods:\ - [graphprototype.create](/manual/api/reference/graphprototype/create) - creating new graph prototypes - [graphprototype.delete](/manual/api/reference/graphprototype/delete) - deleting graph prototypes - [graphprototype.get](/manual/api/reference/graphprototype/get) - retrieving graph prototypes - [graphprototype.update](/manual/api/reference/graphprototype/update) - updating graph prototypes # Прототип графа Цей клас призначений для роботи з прототипами графів. Посилання на об'єкти:\ - [Прототип графіка](/manual/api/reference/graphprototype/object#graph_prototype) Доступні методи:\ - [graphprototype.create](/manual/api/reference/graphprototype/create) - створення нових прототипів графів - [graphprototype.delete](/manual/api/reference/graphprototype/delete) - видалення прототипів графів - [graphprototype.get](/manual/api/reference/graphprototype/get) - отримання прототипів графів - [graphprototype.update](/manual/api/reference/graphprototype/update) - оновлення прототипів графів # graphprototype.update # graphprototype.update ### Graph The graph object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|string|*(readonly)* ID of the graph.| |**height**<br>(required)|integer|Height of the graph in pixels.| |**name**<br>(required)|string|Name of the graph| |**width**<br>(required)|integer|Width of the graph in pixels.| |flags|integer|*(readonly)* Origin of the graph.<br><br>Possible values are:<br>0 - *(default)* a plain graph;<br>4 - a discovered graph.| |graphtype|integer|Graph's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_triggers|integer|Whether to show the trigger line on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|string|*(readonly)* ID of the parent template graph.| |yaxismax|float|The fixed maximum value for the Y axis.<br><br>Default: 100.| |yaxismin|float|The fixed minimum value for the Y axis.<br><br>Default: 0.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |uuid|string|Universal unique identifier, used for linking imported graphs to already existing ones. Used only for graphs on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Графік Об'єкт граф має наступні властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |graphid|рядок|*(readonly)* ID графіка.| |**height**<br>(обов'язково)|ціле число|Висота графіка в пікселях.| |**name**<br>(обов'язково)|рядок|Назва графіка| |**width**<br>(обов'язково)|integer|Ширина графіка в пікселях.| |flags|integer|*(лише читання)* Походження графіка.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* простий граф;<br>4 - відкритий граф.| |graphtype|integer|Тип макета графіка.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* звичайний;<br>1 - складений;<br>2 - кругова;<br>3 - розкомплектований .| |percent\_left|float|Лівий процентиль.<br><br>За замовчуванням: 0.| |percent\_right|float|Правий процентиль.<br><br>За замовчуванням: 0.| |показати\_3d|ціле|Чи відображати секторні та розчленовані графіки в 3D.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* відображати в 2D;<br>1 - відображати в 3D.| |show\_legend|integer|Чи показувати легенду на графіку.<br><br>Можливі значення:<br>0 - приховати;<br>1 - *(за замовчуванням)* показати.| |show\_work\_period|ціле число|Чи показувати робочий час на графіку.<br><br>Можливі значення:<br>0 - приховати;<br>1 - *(за замовчуванням)* показати.| |show\_triggers|ціле число|Чи показувати лінію тригера на графіку.<br><br>Можливі значення:<br>0 - приховати;<br>1 - *(за замовчуванням)* показати.| |templateid|рядок|*(лише для читання)* Ідентифікатор графа батьківського шаблону.| |yaxismax|float|Фіксоване максимальне значення для осі Y.<br><br>За замовчуванням: 100.| |yaxismin|float|Фіксоване мінімальне значення для осі Y.<br><br>За замовчуванням: 0.| |ymax\_itemid|рядок|Ідентифікатор елемента, який використовується як максимальне значення для осі Y.<br><br>Починаючи з Zabbix 6.0.7, якщо користувач не має доступу до зазначеного елемента, графік відображається як ymax\_type буде встановлено на '0' (обчислено).| |ymax\_type|integer|Метод обчислення максимального значення для осі Y.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* обчислено;<br>1 - фіксоване;<br>2 - елемент .| |ymin\_itemid|рядок|Ідентифікатор елемента, який використовується як мінімальне значення для осі Y.<br><br>Починаючи з Zabbix 6.0.7, якщо користувач не має доступу до зазначеного елемента, графік відображається як ymax\_type буде встановлено на '0' (обчислено).| |ymin\_type|integer|Метод обчислення мінімального значення для осі Y.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* обчислено;<br>1 - фіксоване;<br>2 - елемент .| |uuid|рядок|Універсальний унікальний ідентифікатор, який використовується для зв'язування імпортованих графіків із уже існуючими. Використовується лише для графіків на шаблонах. Автоматично генерується, якщо не вказано.<br><br>Для операцій оновлення це поле є *лише для читання*.| Зауважте, що для деяких методів (оновлення, видалення) комбінація обов’язкових/необов’язкових параметрів відрізняється. # Graph This class is designed to work with graphs. Object references:\ - [Graph](/manual/api/reference/graph/object#graph) Available methods:\ - [graph.create](/manual/api/reference/graph/create) - creating new graphs - [graph.delete](/manual/api/reference/graph/delete) - deleting graphs - [graph.get](/manual/api/reference/graph/get) - retrieving graphs - [graph.update](/manual/api/reference/graph/update) - updating graphs # Графік Цей клас призначений для роботи з графіками. Посилання на об'єкти:\ - [Графік](/manual/api/reference/graph/object#graph) Доступні методи:\ - [graph.create](/manual/api/reference/graph/create) - створення нових графіків - [graph.delete](/manual/api/reference/graph/delete) - видалення графіків - [graph.get](/manual/api/reference/graph/get) - отримання графіків - [graph.update](/manual/api/reference/graph/update) - оновлення графіків # graph.update # graph.update #### groups/group |Parameter|Type|Description|Details| |---------|----|-----------|-------| |name|*string*|Group name.| | #### групи/група |Параметр|Тип|Опис|Деталі| |---------|----|-----------|-------| |ім'я|*string*|Назва групи.| | # hanode.get # hanode.get #### Hardware #### Апаратне забезпечення ##### 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. ##### Приховане меню Навіть якщо меню повністю приховано, повне меню доступне лише одним клацанням миші, натиснувши піктограму бургера. Зауважте, що він знову з’являється над вмістом сторінки; щоб перемістити вміст сторінки праворуч, потрібно відкрити меню, натиснувши кнопку «Показати бічній панелі». ### High availability node ::: noteclassic Nodes are created by the Zabbix server and cannot be modified via the API. ::: The High availability node object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |ha\_nodeid|string|ID of the node.| |name|string|Name assigned to the node, using the HANodeName configuration entry of zabbix\_server.conf. Empty for a server running in standalone mode.| |address|string|IP or DNS name where the node connects from.| |port|integer|Port on which the node is running.| |lastaccess|integer|Heartbeat time, t.i. time of last update from the node. UTC timestamp.| |status|integer|State of the node.<br><br>Possible values:<br>0 - standby;<br>1 - stopped manually;<br>2 - unavailable;<br>3 - active.| ### Вузол високої доступності ::: noteclassic Вузли створюються сервером Zabbix і не можуть бути змінені через API. ::: Об’єкт вузла високої доступності має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |ha\_nodeid|рядок|ID вузла.| |ім'я|рядок|Ім'я, призначене вузлу, використовуючи запис конфігурації HANodeName у zabbix\_server.conf. Порожньо для сервера, що працює в автономному режимі.| |адреса|рядок|ІР-адреса або ім'я DNS, звідки підключається вузол.| |порт|ціле|Порт, на якому працює вузол.| |lastaccess|ціле|Час серцебиття, т.і. час останнього оновлення з вузла. Мітка часу UTC.| |статус|ціле|Стан вузла.<br><br>Можливі значення:<br>0 - режим очікування;<br>1 - зупинено вручну;<br>2 - недоступний;<br>3 - активний.| # > High availability node object The following object is related to operating a High availability cluster of Zabbix servers. # > Об'єкт вузла високої доступності Наступний об’єкт пов’язаний з керуванням кластером високої доступності серверів Zabbix. # High availability node This class is designed to work with server nodes that are part of a High availability cluster, or a standalone server instance. Object references:\ - [High availability node](/manual/api/reference/hanode/object#hanode) Available methods:\ - [hanode.get](/manual/api/reference/hanode/get) - retrieving nodes # Вузол високої доступності Цей клас призначений для роботи з серверними вузлами, які є частиною кластера високої доступності або окремого екземпляра сервера. Посилання на об'єкти:\ - [Вузол високої доступності](/manual/api/reference/hanode/object#hanode) Доступні методи:\ - [hanode.get](/manual/api/reference/hanode/get) - отримання вузлів #### history Changes:\ [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) added new API method `history.clear`.\ #### історія Зміни:\ [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) додано новий метод API `history.clear`.\ # history.clear # history.clear # history.get # history.get # > History object The following objects are directly related to the `history` API. ::: noteclassic History objects differ depending on the item's type of information. They are created by the Zabbix server and cannot be modified via the API. ::: # > Об'єкт історії Наступні об’єкти безпосередньо пов’язані з API історії. ::: noteclassic Об’єкти історії відрізняються залежно від типу інформації елемента. Вони створюються сервером Zabbix і не можуть бути змінені через API. ::: # History This class is designed to work with history data. Object references:\ - [History](/manual/api/reference/history/object#history) Available methods:\ - [history.get](/manual/api/reference/history/get) - retrieving history data. # Історія Цей клас призначений для роботи з даними історії. Посилання на об'єкти:\ - [Історія](/manual/api/reference/history/object#history) Доступні методи:\ - [history.get](/manual/api/reference/history/get) - отримання даних історії. # host.create # host.create # host.delete # host.delete # host.get # host.get #### host group Changes:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: `hosts` and `templates` fields are now required.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: added strict validation of the method parameters.\ #### група вузлів мережі Зміни:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: поля `hosts` і `templates` тепер є обов’язковими.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: додано сувору перевірку параметрів методу.\ #### hostgroup Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: the parameter `uuid` can now be updated.\ #### група вузлів мережі Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: тепер можна оновити параметр `uuid`.\ # 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 object The following objects are directly related to the `hostgroup` API. # > Об'єкт групи хостів Наступні об’єкти безпосередньо пов’язані з API `hostgroup`. ### Host group The host group object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|*(readonly)* ID of the host group.| |**name**<br>(required)|string|Name of the host group.| |flags|integer|*(readonly)* Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.| |internal|integer|*(readonly)* Whether the group is used internally by the system. An internal group cannot be deleted.<br><br>Possible values:<br>0 - *(default)* not internal;<br>1 - internal.| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Приймаюча група Об'єкт групи хостів має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |groupid|рядок|*(лише для читання)* Ідентифікатор хост-групи.| |**name**<br>(обов'язково)|рядок|Ім'я хост-групи.| |flags|integer|*(лише читання)* Походження групи хостів.<br><br>Можливі значення:<br>0 - звичайна група хостів;<br>4 - відкрита група хостів.| |internal|integer|*(лише для читання)* Чи використовується група внутрішньо системою. Внутрішню групу неможливо видалити.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* не внутрішня;<br>1 - внутрішня.| |uuid|рядок|Універсальний унікальний ідентифікатор, який використовується для зв’язування імпортованих груп хостів із уже існуючими. Автоматично генерується, якщо не вказано.<br><br>Для операцій оновлення це поле є *лише для читання*.| Зауважте, що для деяких методів (оновлення, видалення) комбінація обов’язкових/необов’язкових параметрів відрізняється. # Host group This class is designed to work with host groups. Object references:\ - [Host group](/manual/api/reference/hostgroup/object#host_group) Available methods:\ - [hostgroup.create](/manual/api/reference/hostgroup/create) - creating new host groups - [hostgroup.delete](/manual/api/reference/hostgroup/delete) - deleting host groups - [hostgroup.get](/manual/api/reference/hostgroup/get) - retrieving host groups - [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - adding related objects to host groups - [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - removing related objects from host groups - [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - replacing or removing related objects from host groups - [hostgroup.update](/manual/api/reference/hostgroup/update) - updating host groups # Приймаюча група Цей клас призначений для роботи з приймаючими групами. Посилання на об'єкти:\ - [Група хостів](/manual/api/reference/hostgroup/object#host_group) Доступні методи:\ - [hostgroup.create](/manual/api/reference/hostgroup/create) - створення нових груп хостів - [hostgroup.delete](/manual/api/reference/hostgroup/delete) - видалення груп хостів - [hostgroup.get](/manual/api/reference/hostgroup/get) - отримання груп хостів - [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - додавання пов'язаних об'єктів до груп хостів - [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - видалення пов'язаних об'єктів із груп хостів - [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - заміна або видалення пов'язаних об'єктів із груп хостів - [hostgroup.update](/manual/api/reference/hostgroup/update) - оновлення груп хостів # hostgroup.update # hostgroup.update # hostinterface.create # hostinterface.create # hostinterface.delete # hostinterface.delete # hostinterface.get # hostinterface.get # hostinterface.massadd # hostinterface.massadd # hostinterface.massremove # hostinterface.massremove # > Host interface object The following objects are directly related to the `hostinterface` API. # > Об'єкт інтерфейсу хоста Наступні об’єкти безпосередньо пов’язані з API 'hostinterface'. # hostinterface.replacehostinterfaces # hostinterface.replacehostinterfaces # Host interface This class is designed to work with host interfaces. Object references:\ - [Host interface](/manual/api/reference/hostinterface/object#host_interface) Available methods:\ - [hostinterface.create](/manual/api/reference/hostinterface/create) - creating new host interfaces - [hostinterface.delete](/manual/api/reference/hostinterface/delete) - deleting host interfaces - [hostinterface.get](/manual/api/reference/hostinterface/get) - retrieving host interfaces - [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - adding host interfaces to hosts - [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - removing host interfaces from hosts - [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - replacing host interfaces on a host - [hostinterface.update](/manual/api/reference/hostinterface/update) - updating host interfaces # Інтерфейс вузла Цей клас призначений для роботи з інтерфейсами вузлів.. Посилання на об'єкти:\ - [Інтерфейс вузла](/manual/api/reference/hostinterface/object#host_interface) Доступні методи:\ - [hostinterface.create](/manual/api/reference/hostinterface/create) - створення нових інтерфейсів вузла - [hostinterface.delete](/manual/api/reference/hostinterface/delete) - видалення інтерфейсів вузла - [hostinterface.get](/manual/api/reference/hostinterface/get) - отримання інтерфейсів вузла - [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - масове додавання інтерфейсів до вузлів - [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - масове видалення інтерфейсів з вузлів - [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - заміна інтерфейсів на вузлі - [hostinterface.update](/manual/api/reference/hostinterface/update) - оновлення інтерфейсів вузла # hostinterface.update # hostinterface.update # host.massadd # host.massadd # host.massremove # host.massremove # host.massupdate # host.massupdate # > Host object The following objects are directly related to the host API. # > Об'єкт вузла Наступні об'єкти безпосередньо пов'язані з API вузла. #### hostprototype Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: the parameter `uuid` can now be updated.\ #### прототип вузла мережі Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: тепер можна оновити параметр `uuid`.\ # hostprototype.create # hostprototype.create # hostprototype.delete # hostprototype.delete # hostprototype.get # hostprototype.get # > Host prototype object The following objects are directly related to the `hostprototype` API. # > Об'єкт прототипу хосту Наступні об’єкти безпосередньо пов’язані з API `hostprototype`. # hostprototype.update # hostprototype.update ##### 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](#footnotes)**^|Опис| |--|--|-|--|----|--------| |groups| |x| | |Кореневий елемент для груп вузлів мережі.| | |name|x|`string`| |Назва групи вузла мережі.| |вузли мережі| |\-| | |Кореневий елемент для вузлів мережі.| | |вузол мережі|x|`string`| |Унікальне ім'я вузла мережі.| | |name|\-|`string`| |Видиме ім'я хоста.| | |description|\-|`text`| |Опис вузла мережі.| | |status|\-|`string`|0 - УВІМКНЕНО (за замовчуванням)<br>1 - ВИМКНЕНО|Статус вузла мережі.| | |ipmi\_authtype|\-|`string`|-1 - DEFAULT (за замовчуванням)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM< br>6 - RMCP\_PLUS|Тип автентифікації сеансу IPMI.| | |ipmi\_privilege|\-|`string`|1 - ЗВОРОТНИЙ ДЗВІНОК<br>2 - КОРИСТУВАЧ (за замовчуванням)<br>3 - ОПЕРАТОР<br>4 - АДМІНІСТРАТОР<br>5 - OEM|Рівень привілеїв сеансу IPMI.| | |ipmi\_username|\-|`string`| |Ім'я користувача для перевірок IPMI.| | |ipmi\_password|\-|`string`| |Пароль для перевірки IPMI.| |proxy| |\-| | |Проксі.| | |name|x|`string`| |Ім'я проксі-сервера (якщо є), який контролює вузол мережі.| |templates| |\-| | |Кореневий елемент для зв'язаних шаблонів.| | |name|x|`string`| |Назва шаблону.| |interfaces| |\-| | |Кореневий елемент для інтерфейсів вузла мережі.| | |default|\-|`string`|0 - НІ<br>1 - ТАК (за замовчуванням)|Чи це основний інтерфейс хоста.<br>На хості може бути лише один основний інтерфейс одного типу.| | |type|\-|`string`|1 - ZABBIX (за замовчуванням)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Тип інтерфейсу.| | |useip|\-|`string`|0 - НІ<br>1 - ТАК (за замовчуванням)|Чи використовувати IP як інтерфейс для підключення до хосту (якщо ні, використовуватиметься DNS).| | |ip|\-|`string`| |IP-адреса, може бути IPv4 або IPv6.<br><br>Потрібно, якщо підключення здійснюється через IP.| | |dns|\-|`string`| |Назва DNS.<br><br>Потрібно, якщо підключення здійснюється через DNS.| | |port|\-|`string`| |Номер порту. Підтримує макроси користувача.| | |interface\_ref|x|`string`|Формат: `if<N>`|Назва посилання на інтерфейс, яка буде використовуватися в елементах даних.| |details| |\-| | |Кореневий елемент для деталей інтерфейсу.| | |version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (за замовчуванням)<br>3 - SNMP\_V3|Використовувати цю версію SNMP.| | |community|\-|`string`| |Спільнота SNMP.<br><br>Потрібно для елементів SNMPv1 і SNMPv2.| | |contextname|\-|`string`| |Назва контексту SNMPv3.<br><br>Використовується лише елементами SNMPv3.| | |securityname|\-|`string`| |Назва безпеки SNMPv3.<br><br>Використовується лише елементами SNMPv3.| | |securitylevel|\-|`string`|0 - NOAUTHNOPRIV (за замовчуванням)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|Рівень безпеки SNMPv3.<br><br>Використовується лише елементами SNMPv3.| | |authprotocol|\-|`string`|0 - MD5 (за замовчуванням)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|Протокол автентифікації SNMPv3 .<br><br>Використовується лише елементами SNMPv3.| | |authpassphrase|\-|`string`| |Парольна фраза автентифікації 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.| | |privassphrase|\-|`рядок`| |Парольна фраза конфіденційності SNMPv3.<br><br>Використовується лише елементами SNMPv3.| | |bulk|\-|`string`|0 - НІ<br>1 - ТАК (за замовчуванням)|Використовувати масові запити для SNMP.| |items| |\-| | |Кореневий елемент для елементів.| | |*Для значень тегів елементів елемента даних див. теги вузла мережі [item](/manual/xml_export_import/hosts#host_item_tags).*| | | | | |tags| |\-| | |Кореневий елемент для тегів вузла мережі.| | |tag|x|`string`| |Назва тегу.| | |value|\-|`рядок`| |Значення тегу.| |macros| |\-| | |Кореневий елемент для макросів.| | |macro|x| | |Ім'я макросу користувача.| | |type|\-|`string`|0 - TEXT (за замовчуванням)<br>1 - SECRET\_TEXT<br>2 - VAULT|Тип макросу.| | |value|\-|`string`| |Значення макросу користувача.| | |description|\-|`string`| |Опис макросу користувача.| |inventory| |\-| | |Кореневий елемент для інвентаризації вузла мережі.| | |<inventory\_property>|\-| | |Окрема властивість інвентарю.<br><br>Усі доступні властивості інвентарю перераховані під відповідними тегами, напр. <type>, <name>, <os> (див. приклад вище).| |inventory\_mode| |\-|`string`|-1 - ВИМКНЕНО<br>0 - ВРУЧНИЙ (за замовчуванням)<br>1 - АВТОМАТИЧНИЙ|Режим інвентаризації.| |valuemaps| |\-| | |Кореневий елемент для карт значень вузла мережі.| | |name|x|`string`| |Назва карти значень.| | |mapping|\-| | |Кореневий елемент для відображень.| | |value|x|`string`| |Значення відображення.| | |newvalue|x|`string`| |Нове значення відображення.| # host.update # host.update #### housekeeping Changes:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) added support of property `hk_events_service`.\ #### housekeeping Зміни:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) додано підтримку властивості `hk_events_service`.\ # housekeeping.get # housekeeping.get # > Housekeeping object The following objects are directly related to the `housekeeping` API. # > Господарський об'єкт Наступні об’єкти безпосередньо пов’язані з API «housekeeping». # Housekeeping This class is designed to work with housekeeping. Object references:\ - [Housekeeping](/manual/api/reference/housekeeping/object#housekeeping) Available methods:\ - [housekeeping.get](/manual/api/reference/housekeeping/get) - retrieve housekeeping - [housekeeping.update](/manual/api/reference/housekeeping/update) - update housekeeping # Прибирання Цей клас призначений для роботи з прибиранням. Посилання на об'єкти:\ - [Прибирання](/manual/api/reference/housekeeping/object#housekeeping) Доступні методи:\ - [housekeeping.get](/manual/api/reference/housekeeping/get) - retrieve housekeeping - [housekeeping.update](/manual/api/reference/housekeeping/update) - update housekeeping # housekeeping.update # housekeeping.update #### httptest Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `httptest.update`: the parameter `uuid` can now be updated.\ #### HTTP-тест Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `httptest.update`: тепер можна оновити параметр `uuid`.\ # httptest.create # httptest.create # httptest.delete # httptest.delete # httptest.get # httptest.get # httptest.update # httptest.update #### iconmap Changes:\ [ZBXNEXT-6914](https://support.zabbix.com/browse/ZBXNEXT-6914) `iconmap.create`, `iconmap.update`: dropped support of the icon mapping object property `sortorder`.\ #### карта значків Зміни:\ [ZBXNEXT-6914](https://support.zabbix.com/browse/ZBXNEXT-6914) `iconmap.create`, `iconmap.update`: припинено підтримку властивості об’єкта зіставлення значків `sortorder`.\ # iconmap.create # iconmap.create # iconmap.delete # iconmap.delete # iconmap.get # iconmap.get # iconmap.update # iconmap.update # image.create # image.create # image.delete # image.delete # image.get # image.get # 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. #### Importing hosts and items Import the host and items contained in the XML string. If any items in XML are missing, they will be deleted from the database, and everything else will be left unchanged. Request: ```json { "jsonrpc": "2.0", "method": "configuration.import", "params": { "format": "xml", "rules": { "valueMaps": { "createMissing": true, "updateExisting": false }, "hosts": { "createMissing": true, "updateExisting": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>5.4</version><date>2020-03-13T15:31:45Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><hosts><host><host>Export host</host><name>Export host</name><groups><group><name>Zabbix servers</name></group></groups><interfaces><interface><interface_ref>if1</interface_ref></interface></interfaces><items><item><name>Item</name><key>item.key</key><delay>30s</delay><valuemap><name>Host status</name></valuemap><interface_ref>if1</interface_ref><request_method>POST</request_method></item></items><valuemaps><valuemap><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></host></hosts></zabbix_export>" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### Імпорт хостів і елементів Імпортуйте хост і елементи, що містяться в рядку XML. Якщо якісь елементи в XML відсутні, їх буде видалено з бази даних, а все інше залишиться без змін. Запит: ```json { "jsonrpc": "2.0", "method": "configuration.import", "params": { "format": "xml", "rules": { "valueMaps": { "createMissing": true, "updateExisting": false }, "hosts": { "createMissing": true, "updateExisting": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>5.4</version><date>2020-03-13T15:31:45Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><hosts><host><host>Export host</host><name>Export host</name><groups><group><name>Zabbix servers</name></group></groups><interfaces><interface><interface_ref>if1</interface_ref></interface></interfaces><items><item><name>Item</name><key>item.key</key><delay>30s</delay><valuemap><name>Host status</name></valuemap><interface_ref>if1</interface_ref><request_method>POST</request_method></item></items><valuemaps><valuemap><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></host></hosts></zabbix_export>" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### Importing hosts and items Import the template and items contained in the YAML string. If any items in YAML are missing, they will be shown as deleted, and everything else will be left unchanged. Request: ```json { "jsonrpc": "2.0", "method": "configuration.import", "params": { "format": "xml", "rules": { "groups": { "createMissing": true, "updateExisting": true }, "templates": { "createMissing": true, "updateExisting": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "discoveryRules": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": false } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><zabbix_export><version>5.4</version><date>2021-05-27T07:12:07Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><templates><template><uuid>e1bde9bf2f0544f5929f45b82502e744</uuid><template>Export template</template><name>Export template</name><groups><group><name>Zabbix servers</name></group></groups><items><item><uuid>3237bc89226e42ed8207574022470e83</uuid><name>Item</name><key>item.key</key><delay>30s</delay><valuemap><name>Host status</name></valuemap><triggers><trigger><uuid>bd1ed0089e4b4f35b762c9d6c599c348</uuid><expression>last(/Export template/item.key)=0</expression><name>Trigger</name></trigger></triggers></item></items><discovery_rules><discovery_rule><uuid>c91616bcf4a44f349539a1b40cb0979d</uuid><name>Discovery rule</name><key>rule.key</key><item_prototypes><item_prototype><uuid>7e164881825744248b3039af3435cf4b</uuid><name>Item prototype</name><key>prototype.key</key></item_prototype></item_prototypes></discovery_rule></discovery_rules><valuemaps><valuemap><uuid>7e666857c5df4af3a338349586f2afc3</uuid><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc":"2.0", "result":{ "templates":{ "updated":[ { "before":{ "uuid":"e1bde9bf2f0544f5929f45b82502e744", "template":"Export template", "name":"Export template" }, "after":{ "uuid":"e1bde9bf2f0544f5929f45b82502e744", "template":"Export template", "name":"Export template" }, "items":{ "added":[ { "after":{ "uuid":"3237bc89226e42ed8207574022470e83", "name":"Item", "key":"item.key", "delay":"30s", "valuemap":{ "name":"Host status" } }, "triggers":{ "added":[ { "after":{ "uuid":"bd1ed0089e4b4f35b762c9d6c599c348", "expression":"last(/Export template/item.key)=0", "name":"Trigger" } } ] } } ], "removed":[ { "before":{ "uuid":"bd3e7b28b3d544d6a83ed01ddaa65ab6", "name":"Old Item", "key":"ite_old.key", "delay":"30s", "valuemap":{ "name":"Host status" } } } ] }, "discovery_rules":{ "updated":[ { "before":{ "uuid":"c91616bcf4a44f349539a1b40cb0979d", "name":"Discovery rule", "key":"rule.key" }, "after":{ "uuid":"c91616bcf4a44f349539a1b40cb0979d", "name":"Discovery rule", "key":"rule.key" }, "item_prototypes":{ "updated":[ { "before":{ "uuid":"7e164881825744248b3039af3435cf4b", "name":"Old item prototype", "key":"prototype_old.key" }, "after":{ "uuid":"7e164881825744248b3039af3435cf4b", "name":"Item prototype", "key":"prototype.key" } } ] } } ] } } ] } }, "id":1 } ``` #### Імпорт хостів і елементів Імпортуйте шаблон і елементи, що містяться в рядку YAML. Якщо будь-які елементи в YAML відсутні, вони будуть показані як видалені, а все інше залишиться без змін. Запит: ```json { "jsonrpc": "2.0", "method": "configuration.import", "params": { "format": "xml", "rules": { "groups": { "createMissing": true, "updateExisting": true }, "templates": { "createMissing": true, "updateExisting": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "discoveryRules": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": false } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><zabbix_export><version>5.4</version><date>2021-05-27T07:12:07Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><templates><template><uuid>e1bde9bf2f0544f5929f45b82502e744</uuid><template>Export template</template><name>Export template</name><groups><group><name>Zabbix servers</name></group></groups><items><item><uuid>3237bc89226e42ed8207574022470e83</uuid><name>Item</name><key>item.key</key><delay>30s</delay><valuemap><name>Host status</name></valuemap><triggers><trigger><uuid>bd1ed0089e4b4f35b762c9d6c599c348</uuid><expression>last(/Export template/item.key)=0</expression><name>Trigger</name></trigger></triggers></item></items><discovery_rules><discovery_rule><uuid>c91616bcf4a44f349539a1b40cb0979d</uuid><name>Discovery rule</name><key>rule.key</key><item_prototypes><item_prototype><uuid>7e164881825744248b3039af3435cf4b</uuid><name>Item prototype</name><key>prototype.key</key></item_prototype></item_prototypes></discovery_rule></discovery_rules><valuemaps><valuemap><uuid>7e666857c5df4af3a338349586f2afc3</uuid><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ``` {.java} { "jsonrpc":"2.0", "result":{ "templates":{ "updated":[ { "before":{ "uuid":"e1bde9bf2f0544f5929f45b82502e744", "template":"Export template", "name":"Export template" }, "after":{ "uuid":"e1bde9bf2f0544f5929f45b82502e744", "template":"Export template", "name":"Export template" }, "items":{ "added":[ { "after":{ "uuid":"3237bc89226e42ed8207574022470e83", "name":"Item", "key":"item.key", "delay":"30s", "valuemap":{ "name":"Host status" } }, "triggers":{ "added":[ { "after":{ "uuid":"bd1ed0089e4b4f35b762c9d6c599c348", "expression":"last(/Export template/item.key)=0", "name":"Trigger" } } ] } } ], "removed":[ { "before":{ "uuid":"bd3e7b28b3d544d6a83ed01ddaa65ab6", "name":"Old Item", "key":"ite_old.key", "delay":"30s", "valuemap":{ "name":"Host status" } } } ] }, "discovery_rules":{ "updated":[ { "before":{ "uuid":"c91616bcf4a44f349539a1b40cb0979d", "name":"Discovery rule", "key":"rule.key" }, "after":{ "uuid":"c91616bcf4a44f349539a1b40cb0979d", "name":"Discovery rule", "key":"rule.key" }, "item_prototypes":{ "updated":[ { "before":{ "uuid":"7e164881825744248b3039af3435cf4b", "name":"Old item prototype", "key":"prototype_old.key" }, "after":{ "uuid":"7e164881825744248b3039af3435cf4b", "name":"Item prototype", "key":"prototype.key" } } ] } } ] } } ] } }, "id":1 } ``` #### 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).| #### Імпорт Щоб імпортувати хости, виконайте такі дії: - Перейдіть до: *Конфігурація* → *Вузли мережі* - Натисніть *Імпорт* праворуч - Виберіть файл імпорту - Позначте необхідні параметри в правилах імпорту - Натисніть *Імпорт*  Повідомлення про успішне або невдале імпортування відображатиметься у інтерфейсі. Правила імпорту: |Правило|Опис| |----|-----------| |*Оновити наявні*|Існуючі елементи буде оновлено даними, взятими з файлу імпорту. Інакше вони не будуть оновлені.| |*Створити новий*|Імпорт додасть нові елементи, використовуючи дані з файлу імпорту. Інакше він не додасть їх.| |*Видалити відсутні*|Імпорт видалить існуючі елементи, яких немає у файлі імпорту. Інакше їх не буде видалено.<br>Якщо для зв’язування шаблону позначено *Видалити відсутні*, існуюче зв’язування шаблону, якого немає у файлі імпорту, буде скасовано. Починаючи з Zabbix 6.0.13, сутності (елементи, тригери, графіки тощо), успадковані з незв’язаних шаблонів, не буде видалено (якщо для кожної сутності також не вибрано параметр *Видалити відсутні*).| ## 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) ------------------------------------------------------------------------ Цей документ створено : 21:23:35 GMT, 18 березня 2020 року ## 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) ------------------------------------------------------------------------ Цей документ створено о 12:58:30 GMT, 11 червня 2021 року ## 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) ------------------------------------------------------------------------ Цей документ створено о 08:42:29 GMT, 11 червня 2021 року ## 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) ------------------------------------------------------------------------ Цей документ створено: 08:42:39 GMT, 11 червня 2021 року ## 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) ------------------------------------------------------------------------ Цей документ створено о 14:07:57 GMT, 22 листопада 2021 року ## 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) ------------------------------------------------------------------------ Цей документ створено: 16:12:22 GMT, 04 вересня 2020 року ## 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 ## Покажчик [ІМ'Я](#lbAC) [СИНТАКСИС](#lbAC) [ОПИС](#lbAD) [ОПЦІЇ](#lbAE) [](#lbAF) [](#lbAG) [ФАЙЛИ](#lbAH) [ДИВ. ТАКОЖ](#lbAI) [АВТОР](#lbAJ) ------------------------------------------------------------------------ Цей документ створено о 20:50:13 GMT, 22 листопада 2021 року ### Informational ### Інформаційні #### 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` в тому місці, де встановлено web-інтерфейс Zabbix - Переконайтеся, що папка вашого модуля містить принаймні файл manifest.json - Перейдіть до [Адміністрування модулів](/manual/web_interface/frontend_sections/administration/general#modules) і натисніть кнопку *Сканувати директорію* - Новий модуль з'явиться в списку разом із його версією, автором, описом і статусом - Увімкніть модуль, натиснувши на його статус Вирішення проблем: |Проблема|Рішення| |---------|-------------------------------------------- -| |*Модуль не з’явився у списку*|Переконайтеся, що файл manifest.json існує в папці `modules/your-module/` інтерфейсу Zabbix. Якщо так, це означає, що модуль не підходить для поточної версії Zabbix. Якщо файл manifest.json не існує, ймовірно, ви розпакували не в той каталог.| |*Збій інтерфейсу*|Код модуля несумісний із поточною версією Zabbix або конфігурацією сервера. Будь ласка, видаліть файли модуля та перезавантажте інтерфейс. Ви побачите повідомлення про те, що деякі модулі відсутні. Перейдіть до [Адміністрування модулів](/manual/web_interface/frontend_sections/administration/general#modules) і знову натисніть *Сканувати директорію*, щоб видалити неіснуючі модулі з бази даних.| |*З’являється повідомлення про помилку щодо ідентичного простору імен, ідентифікатора або дій*|Новий модуль намагався зареєструвати простір імен, ідентифікатор або дії, які вже зареєстровані іншими активними модулями. Вимкніть конфліктуючий модуль (згаданий у повідомленні про помилку), перш ніж увімкнути новий.| |*З’являються повідомлення про технічні помилки*|Повідомити про помилки розробнику модуля.| #### - 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), файли перекладу слід створити вручну. Щоб створити файли перекладу, запустіть: зробити gettext locale/make_mo.sh Цей крок не потрібен, якщо Zabbix встановлюється з пакетів або вихідних файлів tar.gz. #### - Installing Zabbix web interface #### - Встановлення веб-інтерфейсу Zabbix ### 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)|Опис| |--|--|------| |годинник|мітка часу|Час, коли це значення було отримано.| |itemid|рядок|ID пов'язаного елемента.| |ns|ціле|Наносекунди, коли було отримано значення.| |значення|ціле|Отримане значення.| #### item Bug fixes:\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `item.create`, `item.update`: property `interfaceid` is no longer required to create/update a HTTP agent type item.\ #### елемент Виправлення помилок:\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `item.create`, `item.update`: властивість `interfaceid` більше не потрібна для створення/оновлення типу агента HTTP елемент.\ #### item Changes:\ [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `item.get`, `item.create`, `item.update`: added the third parameter to the Prometheus pattern preprocessing step. The second parameter will now determine an aggregation method: `value`, `label`, `function`. The third parameter will now contain Prometheus output for the aggregation method `label` or an aggregation function for the aggregation method `function`.\ #### елемент Зміни:\ [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `item.get`, `item.create`, `item.update`: додано третій параметр до етапу попередньої обробки шаблону Prometheus . Другий параметр тепер визначатиме метод агрегації: `value`, `label`, `function`. Третій параметр тепер міститиме вихідні дані Prometheus для методу агрегації `label` або функцію агрегації для методу агрегування `function`.\ #### item Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `item.update`: the parameter `uuid` can now be updated.\ #### елемент даних Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `item.update`: тепер можна оновити параметр `uuid`.\ # item.create # item.create # item.delete # item.delete # item.get # item.get #### itemprototype Bug fixes:\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `itemprototype.create`, `itemprototype.update`: property `interfaceid` is no longer required to create/update a HTTP agent type item prototype.\ #### прототип елемента Виправлення помилок:\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `itemprototype.create`, `itemprototype.update`: властивість `interfaceid` більше не потрібна для створення/оновлення типу агента HTTP прототип елемента.\ #### item prototype Changes:\ [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: added the third parameter to the Prometheus pattern preprocessing step. The second parameter will now determine an aggregation method: `value`, `label`, `function`. The third parameter will now contain Prometheus output for the aggregation method `label` or an aggregation function for the aggregation method `function`.\ #### прототип елемента Зміни:\ [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: додано третій параметр до етапу попередньої обробки шаблону Prometheus . Другий параметр тепер визначатиме метод агрегації: `value`, `label`, `function`. Третій параметр тепер міститиме вихідні дані Prometheus для методу агрегації `label` або функцію агрегації для методу агрегування `function`.\ #### itemprototype Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `itemprototype.update`: the parameter `uuid` can now be updated.\ #### прототип елемента даних Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `itemprototype.update`: тепер можна оновити параметр `uuid`.\ # itemprototype.create # itemprototype.create # itemprototype.delete # itemprototype.delete # itemprototype.get # itemprototype.get # itemprototype.update # itemprototype.update # item.update # item.update #### 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 See [known issues](/manual/installation/known_issues#graphs) for graphs. #### Відомі проблеми [Відомі проблеми](/manual/installation/known_issues#graphs) для графіків. #### 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, де процесори розподіляються нерівномірно між вузлами NUMA. Якщо логічні ЦП розподілені нерівномірно, показники продуктивності ЦП можуть бути недоступні для деяких ЦП. Наприклад, якщо є 72 логічних ЦП з 2 вузлами NUMA, обидва вузли повинні мати по 36 ЦП кожен. ### LLD macro path The LLD macro path has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**lld\_macro**<br>(required)|string|LLD macro.| |**path**<br>(required)|string|Selector for value which will be assigned to corresponding macro.| ### Шлях макросу LLD Шлях макросу LLD має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**lld\_macro**<br>(обов’язково)|рядок|LLD макрос.| |**path**<br>(обов’язково)|рядок|Селектор для значення, яке буде призначено відповідному макросу.| #### LLD rule filter condition The LLD rule filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.| ::: notetip To better understand how to use filters with various types of expressions, see examples on the [discoveryrule.get](get#retrieving_filter_conditions) and [discoveryrule.create](create#using_a_custom_expression_filter) method pages. ::: #### Умова фільтра правила LLD Об’єкт умов фільтра правила LLD визначає окрему перевірку значення макросу LLD. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**macro**<br>(обов’язково)|рядок|макрос LLD для виконання перевірки.| |**value**<br>(обов’язково)|рядок|Значення для порівняння.| |formulaid|рядок|Довільний унікальний ідентифікатор, який використовується для посилання на умову з користувацького виразу. Може містити лише великі літери. Ідентифікатор має бути визначений користувачем під час зміни умов фільтра, але буде згенеровано заново під час їхнього запиту пізніше.| |оператор|ціле|Оператор умови.<br><br>Можливі значення:<br>8 - *(за замовчуванням)* відповідає регулярному виразу;<br>9 - не відповідає регулярному виразу;<br>12 - існує;< br>13 - не існує.| ::: notetip Щоб краще зрозуміти, як використовувати фільтри з різними типами виразів, перегляньте приклади на сторінках методів [discoveryrule.get](get#retrieving_filter_conditions) і [discoveryrule.create](create#using_a_custom_expression_filter). ::: ### LLD rule filter The LLD rule filter object defines a set of conditions that can be used to filter discovered objects. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |**evaltype**<br>(required)|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression filters.| ### Фільтр правил LLD Об’єкт фільтра правила LLD визначає набір умов, які можна використовувати для фільтрації виявлених об’єктів. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**conditions**<br>(обов’язково)|масив|Набір умов фільтра для використання для фільтрації результатів.| |**evaltype**<br>(обов’язково)|ціле|Метод оцінки умови фільтра.<br><br>Можливі значення:<br>0 - та/або;<br>1 - і;<br>2 - або;<br>3 - спеціальний вираз.| |eval\_formula|рядок|*(лише для читання)* Згенерований вираз, який використовуватиметься для оцінки умов фільтра. Вираз містить ідентифікатори, які посилаються на конкретні умови фільтра за його "формулою". Значення `eval_formula` дорівнює значенню `formula` для фільтрів із спеціальним виразом.| |формула|рядок|Визначений користувачем вираз, який буде використовуватися для оцінки умов фільтрів за допомогою спеціального виразу. Вираз має містити ідентифікатори, які посилаються на конкретні умови фільтра за його "формулою". Ідентифікатори, які використовуються у виразі, мають точно відповідати ідентифікаторам, визначеним в умовах фільтра: жодна умова не може залишатися невикористаною або пропущеною.<br><br>Потрібно для фільтрів користувацьких виразів.| # > LLD rule object The following objects are directly related to the `discoveryrule` API. # > Об'єкт правила LLD Наступні об’єкти безпосередньо пов’язані з API «discoveryrule». #### LLD rule override filter condition The LLD rule override filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.| #### Умова фільтра перевизначення правила LLD Об’єкт умов фільтра заміни правила LLD визначає окрему перевірку значення макросу LLD. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**macro**<br>(обов’язково)|рядок|макрос LLD для виконання перевірки.| |**value**<br>(обов’язково)|рядок|Значення для порівняння.| |formulaid|рядок|Довільний унікальний ідентифікатор, який використовується для посилання на умову з користувацького виразу. Може містити лише великі літери. Ідентифікатор має бути визначений користувачем під час зміни умов фільтра, але буде згенеровано заново під час їхнього запиту пізніше.| |оператор|ціле|Оператор умови.<br><br>Можливі значення:<br>8 - *(за замовчуванням)* відповідає регулярному виразу;<br>9 - не відповідає регулярному виразу;<br>12 - існує;< br>13 - не існує.| #### LLD rule override filter The LLD rule override filter object defines a set of conditions that if they match the discovered object the override is applied. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**evaltype**<br>(required)|integer|Override filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |**conditions**<br>(required)|array|Set of override filter conditions to use for matching the discovered objects.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating override filter conditions. The expression contains IDs that reference specific override filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of override filters with a custom expression. The expression must contain IDs that reference specific override filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the override filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression override filters.| #### Фільтр перевизначення правил LLD Об’єкт фільтра заміни правила LLD визначає набір умов, якщо вони відповідають виявленому об’єкту, застосовується заміна. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**evaltype**<br>(обов’язково)|integer|Замінити метод оцінки умов фільтра.<br><br>Можливі значення:<br>0 - і/або;<br>1 - і;<br>2 - або;<br>3 - спеціальний вираз.| |**conditions**<br>(обов’язково)|масив|Набір умов заміни фільтра для використання для зіставлення виявлених об’єктів.| |eval\_formula|рядок|*(лише для читання)* Згенерований вираз, який використовуватиметься для оцінки умов заміни фільтра. Вираз містить ідентифікатори, які посилаються на конкретні умови заміни фільтра за його "формулою". Значення `eval_formula` дорівнює значенню `formula` для фільтрів із спеціальним виразом.| |формула|рядок|Визначений користувачем вираз, який буде використовуватися для оцінки умов заміни фільтрів за допомогою спеціального виразу. Вираз має містити ідентифікатори, які посилаються на конкретні умови заміни фільтра за його `formulaid`. Ідентифікатори, які використовуються у виразі, мають точно відповідати ідентифікаторам, визначеним в умовах заміни фільтра: жодна умова не може залишатися невикористаною або пропущеною.<br><br>Потрібно для фільтрів заміни користувацького виразу.| ##### LLD rule override operation discover LLD rule override operation discover status that is set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**discover**<br>(required)|integer|Override the discover status for selected object.<br><br>Possible values:<br>0 - Yes, continue discovering the objects;<br>1 - No, new objects will not be discovered and existing ones will be marked as lost.| ##### Виявлення операції перевизначення правила LLD Статус виявлення операції перевизначення правила LLD, встановлений для виявленого об’єкта. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**discover**<br>(обов’язково)|ціле число|Замінити статус виявлення для вибраного об’єкта.<br><br>Можливі значення:<br>0 – Так, продовжити виявлення об’єктів;<br>1 – Ні , нові об'єкти не будуть виявлені, а існуючі будуть позначені як втрачені.| ##### LLD rule override operation history LLD rule override operation history value that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**history**<br>(required)|string|Override the history of item prototype which is a time unit of how long the history data should be stored. Also accepts user macro and LLD macro.| ##### Історія операцій перевизначення правила LLD Правило LLD замінює значення історії операцій, яке встановлено для виявленого елемента. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**history**<br>(обов’язково)|рядок|Замінити історію прототипу елемента, яка є одиницею часу, яка визначає, як довго мають зберігатися дані історії. Також приймає макрос користувача та макрос LLD.| ##### LLD rule override operation inventory LLD rule override operation inventory mode value that is set to discovered host. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**inventory\_mode**<br>(required)|integer|Override the host prototype inventory mode.<br><br>Possible values are:<br>-1 - disabled;<br>0 - *(default)* manual;<br>1 - automatic.| ##### Інвентаризація операцій перевизначає правило LLD Правило LLD замінює значення режиму інвентаризації операції, яке встановлено на виявлений хост. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**inventory\_mode**<br>(обов’язково)|integer|Замінити режим інвентаризації прототипу хосту.<br><br>Можливі значення:<br>-1 - вимкнено;<br>0 - *(за замовчуванням )* ручна;<br>1 - автоматична.| ##### LLD rule override operation period LLD rule override operation period is an update interval value (supports custom intervals) that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**delay**<br>(required)|string|Override the update interval of the item prototype. Accepts seconds or a time unit with suffix (30s,1m,2h,1d) as well as flexible and scheduling intervals and user macros or LLD macros. Multiple intervals are separated by a semicolon.| ##### Період дії перевизначення правила LLD Період дії перевизначення правила LLD – це значення інтервалу оновлення (підтримує спеціальні інтервали), яке встановлено для виявленого елемента. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**delay**<br>(обов’язково)|рядок|Замінити інтервал оновлення прототипу елемента. Приймає секунди або одиницю вимірювання часу з суфіксом (30 с, 1 хв, 2 год, 1 д), а також гнучкі інтервали планування та макроси користувача або макроси LLD. Кілька інтервалів розділяються крапкою з комою.| ##### LLD rule override operation severity LLD rule override operation severity value that is set to discovered trigger. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**severity**<br>(required)|integer|Override the severity of trigger prototype.<br><br>Possible values are: 0 - *(default)* not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.| ##### Правило LLD перевизначає серйозність операції Правило LLD перевизначає значення серйозності операції, яке встановлено як виявлений тригер. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**severity**<br>(обов’язково)|ціле число|Замінити серйозність прототипу тригера.<br><br>Можливі значення: 0 - *(за замовчуванням)* не класифіковано;<br>1 - інформація;< br>2 - попередження;<br>3 - середній;<br>4 - високий;<br>5 - катастрофа.| ##### LLD rule override operation status LLD rule override operation status that is set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**status**<br>(required)|integer|Override the status for selected object.<br><br>Possible values:<br>0 - Create enabled;<br>1 - Create disabled.| ##### Статус операції перевизначення правила LLD Правило LLD перевизначає статус операції, встановлений для виявленого об’єкта. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**status**<br>(обов’язково)|ціле число|Замінити статус для вибраного об’єкта.<br><br>Можливі значення:<br>0 – Створювати ввімкнено;<br>1 – Створювати вимкнено.| ##### LLD rule override operation tag LLD rule override operation tag object contains tag name and value that are set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|New tag name.| |value|string|New tag value.| ##### Тег операції перевизначення правила LLD Об’єкт тегу операції заміни правила LLD містить ім’я та значення тегу, встановлені для виявленого об’єкта. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**tag**<br>(обов’язково)|рядок|Назва нового тегу.| |значення|рядок|Нове значення тегу.| ##### LLD rule override operation template LLD rule override operation template object that is linked to discovered host. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templateid**<br>(required)|string|Override the template of host prototype linked templates.| ##### Шаблон операції перевизначення правила LLD Об’єкт шаблону операції заміни правила LLD, який пов’язано з виявленим хостом. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**templateid**<br>(обов’язково)|рядок|Замінити шаблон пов’язаних шаблонів прототипу хосту.| #### LLD rule override operation The LLD rule override operation is combination of conditions and actions to perform on the prototype object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**operationobject**<br>(required)|integer|Type of discovered object to perform the action.<br><br>Possible values:<br>0 - Item prototype;<br>1 - Trigger prototype;<br>2 - Graph prototype;<br>3 - Host prototype.| |operator|integer|Override condition operator.<br><br>Possible values:<br>0 - *(default)* equals;<br>1 - does not equal;<br>2 - contains;<br>3 - does not contain;<br>8 - matches;<br>9 - does not match.| |value|string|Pattern to match item, trigger, graph or host prototype name depending on selected object.| |opstatus|object|Override operation status object for item, trigger and host prototype objects.| |opdiscover|object|Override operation discover status object (all object types).| |opperiod|object|Override operation period (update interval) object for item prototype object.| |ophistory|object|Override operation history object for item prototype object.| |optrends|object|Override operation trends object for item prototype object.| |opseverity|object|Override operation severity object for trigger prototype object.| |optag|array|Override operation tag object for trigger and host prototype objects.| |optemplate|array|Override operation template object for host prototype object.| |opinventory|object|Override operation inventory object for host prototype object.| #### Операція заміни правила LLD Операція перевизначення правила LLD — це комбінація умов і дій, які потрібно виконати над об’єктом-прототипом. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**operationobject**<br>(обов’язково)|integer|Тип виявленого об’єкта для виконання дії.<br><br>Можливі значення:<br>0 – прототип елемента;<br>1 – прототип тригера;< br>2 - Прототип графа;<br>3 - Прототип хоста.| |оператор|ціле|Оператор умови заміни.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* дорівнює;<br>1 - не дорівнює;<br>2 - містить;<br>3 - не містить;<br>8 - збігається;<br>9 - не збігається.| |значення|рядок|Шаблон для відповідності імені елемента, тригера, графіка чи прототипу хосту залежно від вибраного об’єкта.| |opstatus|object|Заміна об’єкта стану операції для об’єктів елемента, тригера та хост-прототипу.| |opdiscover|об'єкт|Перевизначити операцію виявлення об'єкта статусу (усі типи об'єктів).| |opperiod|object|Перевизначати об’єкт періоду операції (інтервал оновлення) для об’єкта прототипу елемента.| |ophistory|object|Замінити об’єкт історії операцій для об’єкта прототипу елемента.| |optrends|object|Замінити об’єкт трендів операцій для об’єкта прототипу елемента.| |opseverity|object|Замінити об’єкт серйозності операції для об’єкта прототипу тригера.| |optag|масив|Заміна об'єкта тегу операції для об'єктів тригера та прототипу хоста.| |optemplate|масив|Замінити об'єкт шаблону операції для об'єкта прототипу хоста.| |opinventory|object|Замінити об’єкт інвентаризації операцій для об’єкта прототипу хоста.| ##### LLD rule override operation trends LLD rule override operation trends value that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**trends**<br>(required)|string|Override the trends of item prototype which is a time unit of how long the trends data should be stored. Also accepts user macro and LLD macro.| ##### Правило LLD перевизначає тенденції роботи Правило LLD перевизначає значення тенденцій операцій, яке встановлено для виявленого елемента. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**trends**<br>(обов’язково)|рядок|Замінити тенденції прототипу елемента, який є одиницею часу, що визначає, як довго слід зберігати дані тенденцій. Також приймає макрос користувача та макрос LLD.| ### LLD rule overrides The LLD rule overrides object defines a set of rules (filters, conditions and operations) that are used to override properties of different prototype objects. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Unique override name.| |**step**<br>(required)|integer|Unique order number of the override.| |stop|integer|Stop processing next overrides if matches.<br><br>Possible values:<br>0 - *(default)* don't stop processing overrides;<br>1 - stop processing overrides if filter matches.| |filter|object|Override filter.| |operations|array|Override operations.| ### Перевизначення правил LLD Правило LLD overrides object визначає набір правил (фільтрів, умов і операцій), які використовуються для заміни властивостей різних об’єктів-прототипів. Він має такі властивості: |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**name**<br>(обов'язково)|рядок|Унікальне ім'я заміни.| |**step**<br>(обов'язково)|ціле|Унікальний порядковий номер перевизначення.| |зупинити|ціле число|Зупинити обробку наступних замін, якщо збігається.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* не зупиняти обробку замін;<br>1 - зупинити обробку замін, якщо фільтр збігається. | |фільтр|об'єкт|Замінити фільтр.| |операції|масив|Перевизначити операції.| # LLD rule This class is designed to work with low level discovery rules. Object references:\ - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) Available methods:\ - [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) - copying LLD rules - [discoveryrule.create](/manual/api/reference/discoveryrule/create) - creating new LLD rules - [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) - deleting LLD rules - [discoveryrule.get](/manual/api/reference/discoveryrule/get) - retrieving LLD rules - [discoveryrule.update](/manual/api/reference/discoveryrule/update) - updating LLD rules # Правило LLD Цей клас призначений для роботи з правилами виявлення низького рівня. Посилання на об'єкти:\ - [Правило LLD](/manual/api/reference/discoveryrule/object#lld_rule) Доступні методи:\ - [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) - копіювання правил LLD - [discoveryrule.create](/manual/api/reference/discoveryrule/create) - створення нових правил LLD - [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) - видалення правил LLD - [discoveryrule.get](/manual/api/reference/discoveryrule/get) - отримання правил LLD - [discoveryrule.update](/manual/api/reference/discoveryrule/update) - оновлення правил LLD ### 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|рядок|ID запису історії.| |годинник|мітка часу|Час, коли це значення було отримано.| |itemid|рядок|ID пов'язаного елемента.| |logeventid|ціле|Ідентифікатор запису журналу подій Windows.| |ns|ціле|Наносекунди, коли було отримано значення.| |серйозність|ціле|Рівень запису журналу подій Windows.| |джерело|рядок|Джерело запису журналу подій Windows.| |мітка часу|мітка часу|Час запису журналу подій Windows.| |значення|текст|Отримане значення.| ### Log level control targets *process-type* All processes of specified type (active checks, collector, listener) *process-type,N* Process type and number (e.g., listener,3) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Print known items and exit. For each item either generic defaults are used, or specific defaults for testing are supplied. These defaults are listed in square brackets as item key parameters. Returned values are enclosed in square brackets and prefixed with the type of the returned value, separated by a pipe character. For user parameters type is always **t**, as the agent can not determine all possible return values. Items, displayed as working, are not guaranteed to work from the Zabbix server or zabbix\_get when querying a running agent daemon as permissions or environment may be different. Returned value types are: d Number with a decimal part. m Not supported. This could be caused by querying an item that only works in the active mode like a log monitoring item or an item that requires multiple collected values. Permission issues or incorrect user parameters could also result in the not supported state. s Text. Maximum length not limited. t Text. Same as **s**. u Unsigned integer. **-t**, **--test** *item-key* Test single item and exit. See **--print** for output description. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### Цілі контролю рівня журналу *process-type* Всі процеси вказаного типу (активні перевірки, колектор, слухач) *process-type,N* Тип та номер процесу (наприклад, listener,3) *pid* Ідентифікатор процесу, до 65535. Для більших значень вкажіть ціль у вигляді "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Вивести відомі елементи і вийти. Для кожного елемента використовуються або загальні значення за замовчуванням або специфічні значення за замовчуванням для тестування. Ці значення за замовчуванням перераховано у квадратних дужках як ключові параметри елемента. Значення, що повертаються взято у квадратні дужки і додано префікс з типом значення, що повертається значення, відокремленого символом труби. Для параметрів користувача тип завжди **t**, оскільки агент не може визначити всі можливі значення, що повертаються. Елементи, відображені як робочі, не гарантують роботу з сервера Zabbix або zabbix\_get при запиті до запущеного демона агента, оскільки дозволи або середовище може відрізнятися. Типи значень, що повертаються: d Число з десятковою частиною. m Не підтримується. Це може бути спричинено запитом елемента, який працює лише в активному режимі, наприклад, елемент моніторингу журналу або елемент, який вимагає декілька зібраних значень. Проблеми з правами доступу або неправильні параметри користувача також можуть призвести до стану "не підтримується". s Текст. Максимальна довжина не обмежена. t Текст. Те саме, що і **s**. u Ціле число без знаку. **-t**, **--test** *item-key* Перевірити один елемент і вийти. Дивіться **--print** для опису виводу. **-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести інформацію про версію і завершити роботу. [ ]{#lbAH} #### Macros #### Макроси #### maintenance Changes:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`,`maintenance.delete`: added strict validation of the methods parameters.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.get`,`maintenance.update`: dropped support for parameter `timeperiodid` of the timeperiod object.\ #### обслуговування Зміни:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`, `maintenance.delete`: додано сувору перевірку параметрів методів.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.get`,`maintenance.update`: припинено підтримку параметра `timeperiodid` об'єкта періоду часу.\ #### maintenance Changes:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: the parameter `groupids` is now deprecated. Use `groups` instead.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: the parameter `hostids` is now deprecated. Use `hosts` instead.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: changed the type of parameters `groups`, `hosts`, `timeperiods` and `tags` from `array` to `object/array`.\ #### обслуговування Зміни:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: параметр `groupids` більше не підтримується. Замість цього використовуйте `groups`.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: параметр `hostids` більше не підтримується. Замість цього використовуйте `hosts`.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: змінено тип параметрів `groups`, `hosts`, `timeperiods` і `tags` від `array` до `object/array`.\ # maintenance.create # maintenance.create # maintenance.delete # maintenance.delete # maintenance.get # maintenance.get # Maintenance This class is designed to work with maintenances. Object references:\ - [Maintenance](/manual/api/reference/maintenance/object#maintenance) - [Time period](/manual/api/reference/maintenance/object#time_period) Available methods:\ - [maintenance.create](/manual/api/reference/maintenance/create) - creating new maintenances - [maintenance.delete](/manual/api/reference/maintenance/delete) - deleting maintenances - [maintenance.get](/manual/api/reference/maintenance/get) - retrieving maintenances - [maintenance.update](/manual/api/reference/maintenance/update) - updating maintenances # Обслуговування Цей клас призначений для роботи з обслуговуванням. Посилання на об'єкти:\ - [Технічне обслуговування](/manual/api/reference/maintenance/object#maintenance) - [Період часу](/manual/api/reference/maintenance/object#time_period) Доступні методи:\ - [maintenance.create](/manual/api/reference/maintenance/create) - створення нових засобів обслуговування - [maintenance.delete](/manual/api/reference/maintenance/delete) - видалення технічного обслуговування - [maintenance.get](/manual/api/reference/maintenance/get) - отримання технічного обслуговування - [maintenance.update](/manual/api/reference/maintenance/update) - оновлення технічного обслуговування # maintenance.update # maintenance.update ##### 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|\-|Ідентифікатор модуля. Одночасно можна ввімкнути лише один модуль із заданим ідентифікатором.| |name|Так|String|\-|Назва модуля, що відображається в розділі "Адміністрування"| |version|Так|String|\-|Версія модуля, що відображається в розділі "Адміністрування".| |namespace|Так|String|\-|Простір імен PHP для Module.php і класів дій.| |author|Ні|String|""|Автор модуля, що відображається в розділі "Адміністрування".| |url|Ні|Рядок|""|URL-адреса модуля, яка відображається в розділі адміністрування.| |description|Ні|String|""|Опис модуля, що відображається в розділі "Адміністрування".| |actions|No|Object|{}|Дії для реєстрації в цьому модулі. Див. Дії.| |config|Ні|Object|{}|Конфігурація модуля.| Для довідки перегляньте приклад manifest.json у розділі [Довідка](#reference). #### mediatype Changes:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) message template object: added support of `conditiontype` value: 4 - *(event created on service status update)*.\ #### медіатип Зміни:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) об’єкт шаблону повідомлення: додано підтримку значення `conditiontype`: 4 - *(подія, створена під час оновлення статусу служби)*.\ #### mediatype Changes:\ [ZBXNEXT-6885](https://support.zabbix.com/browse/ZBXNEXT-6885) `mediatype.create`, `mediatype.update`: added strict validation of the methods parameters.\ #### mediatype Зміни:\ [ZBXNEXT-6885](https://support.zabbix.com/browse/ZBXNEXT-6885) `mediatype.create`, `mediatype.update`: додано сувору перевірку параметрів методів.\ ##### Mikrotik routers Use SNMP agent provided by Mikrotik. See <http://www.mikrotik.com> for more information. ##### Маршрутизатори Mikrotik Використовується агент SNMP наданий Mikrotik. Дивиться <http://www.mikrotik.com> для додаткової інформації. #### 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 } ``` ##### 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`) з вкладеними папками, що містять контролери, views та будь-який інший код: example_module_directory/ (обов’язково) manifest.json (обов’язково) Метадані та визначення дії. Module.php Ініціалізація модуля та обробка подій. actions/ Файли управління діями. SomethingView.php SomethingCreate.php SomethingDelete.php data_export/ ExportAsXml.php ExportAsExcel.php views/ view файли. example.something.view.php example.something.delete.php js/файли JavaScript, які використовуються у view. example.something.view.js.php partials/ Будь-які додаткові файли для використання у view example.something.reusable.php js/файли JavaScript, що використовуються в partials. example.something.reusable.js.php Як бачите, єдиний обов’язковий файл у каталозі користувацького модуля – це `manifest.json`. Без цього файлу модуль не зареєструється. `Module.php` відповідає за реєстрацію пунктів меню та обробку подій, таких як «onBeforeAction» і «onTerminate». Каталоги *actions*, *views* і *partials* містять PHP і JavaScript код, необхідний для дій модуля. #### Monitoring specific applications #### Моніторинг конкретних програм #### 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 Export and import must be performed in tmux/screen to ensure that the session isn't dropped. See also: [Important notes](#important-notes) ### MySQL Експорт і імпорт потрібно виконувати в tmux/screen, щоб гарантувати, що сеанс не буде перервано. Дивіться також: [Важливі примітки](#important-notes) #### MySQL 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*.\ Relevant for at least MySQL version 5.1.61 #### MySQL Якщо значення містить символ, відмінний від ASCII, у кодуванні, відмінному від UTF8, цей символ і наступні символи буде відкинуто, коли база даних збереже це значення. На адресу не надходитимуть жодні попереджувальні повідомлення *zabbix\_server.log*.\ Актуально принаймні для версії MySQL 5.1.61 ## 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 JS [ ]{#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 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. ##### Правила іменування Перш ніж створювати модуль, важливо домовитися про правила іменування різних елементів модуля, таких як каталоги та файли, щоб ми могли все добре організувати. Ви також можете знайти приклади вище, у розділі [Структура модуля](#module_structure). |Елемент|Правила найменування|Приклад| |----|------------|-------| |*Каталог модулів*|Малі літери \[a-z\], підкреслення та десяткові цифри|example\_v2| |*Підкаталоги дій*|Малі літери \[a-z\] і символ підкреслення|data\_export| |*Файли дій*|CamelCase, що закінчується типом дії|SomethingView.php| |*Файли view і partials*|Малі літери \[a-z\]<br>Слова, розділені крапкою<br>З префіксом `module.`, після якого йде назва модуля<br>Закінчується типом дії та розширенням файлу .php|module.example .something.view.php| |*Файли Javascript*|Застосовуються ті самі правила, що й для view та partials, за винятком розширення файлу .js.php.|module.example.something.view.js.php| Зауважте, що префікс 'module' є обов'язковим для назв файлів view і partials, якщо тільки вам не потрібно перевизначити основні стандартні view або partials файли Zabbix. Це правило, однак, не стосується назв файлів дій. ##### New templates See the list of [new templates](/manual/introduction/whatsnew600#templates) in Zabbix 6.0.0. ##### Нові шаблони Перегляньте список [нових шаблонів](/manual/introduction/whatsnew600#templates) у Zabbix 6.0.0. ### Notation ### Позначення ::: 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. ::: ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## ВАРІАНТИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix агент на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix proxy in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix проксі на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix server in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. Examples of running Zabbix server with command line parameters: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix сервер на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. *-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести версію і вийти. Приклади запуску сервера Zabbix з параметрами командного рядка: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовувати альтернативний конфігураційний файл *config-file* замість стандартного. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Вивести інформацію про версію та вийдіть. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний файл конфігурації *config-file* замість стандартного. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. ## OPTIONS **-s**, **--host** *host-name-or-IP* Specify host name or IP address of a host. **-p**, **--port** *port-number* Specify port number of agent running on the host. Default is 10050. **-I**, **--source-address** *IP-address* Specify source IP address. **-t**, **--timeout** *seconds* Specify timeout. Valid range: 1-30 seconds (default: 30) **-k**, **--key** *item-key* Specify key of item to retrieve value for. **--tls-connect** *value* How to connect to agent. Values: [ ]{#lbAF} ## ПАРАМЕТРИ **-s**, **--host** *host-name-or-IP* Вкажіть ім'я або IP-адресу хоста. **-p**, **--port** *port-number* Укажіть номер порту агента, який працює на хості. За замовчуванням 10050. **-I**, **--source-address** *IP-address* Вкажіть IP-адресу джерела. **-t**, **--timeout** *seconds* Вкажіть час очікування. Дійсний діапазон: 1-30 секунд (за замовчуванням: 30) **-k**, **--key** *item-key* Укажіть ключ елемента, для якого потрібно отримати значення. **--tls-connect** *value* Як підключитися до агента. Значення: [ ]{#lbAF} ## OPTIONS **-s**, **--script** *script-file* Specify the file name of the script to execute. If '-' is specified as file name, the script will be read from stdin. **-p**, **--param** *input-param* Specify the input parameter. **-i**, **--input** *input-file* Specify the file name of the input parameter. If '-' is specified as file name, the input will be read from stdin. **-l**, **--loglevel** *log-level* Specify the log level. **-t**, **--timeout** *timeout* Specify the timeout in seconds. Valid range: 1\-60 seconds (default: 10) **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## ПАРАМЕТРИ **-s**, **--script** *script-file* Вказати ім'я файлу скрипта для виконання. Якщо в якості імені файлу вказати '-' ім'я файлу, то скрипт буде прочитано з stdin. **-p**, **--param** *input-param* Вказати вхідний параметр. **-i**, **--input** *input-file* Вказати ім'я файлу вхідного параметра. Якщо в якості імені файлу вказати '-' ім'я файлу, то вхідні дані будуть прочитані з stdin. **-l**, **--loglevel** *log-level* Вказати рівень журналу. **-t**, **--timeout** *timeout* Вказати таймаут у секундах. Допустимий діапазон: 1\-60 секунд (за замовчуванням: 10) **-h**, **--help** Показати цю довідку і вийти. **-V**, **--version** Вивести інформацію про версію і вийти. [ ]{#lbAF} #### Oracle Instructions for creating and configuring Oracle database are provided in a separate [section](/manual/appendix/install/oracle). #### Oracle Інструкції щодо створення та налаштування бази даних Oracle наведено в окремому [розділі](/manual/appendix/install/oracle). ### Other changes and bug fixes ### Інші зміни та виправлення помилок #### Overview A vertical menu in a sidebar provides access to various Zabbix frontend sections. The menu is dark blue in the default theme. {width="600"} #### Огляд Вертикальне меню на бічній панелі забезпечує доступ до різних розділів інтерфейсу Zabbix. У типовій темі меню темно-синього кольору. {width="600"} #### Overview By default, Zabbix provides a number of predefined themes. You may follow the step-by-step procedure provided here in order to create your own. Feel free to share the result of your work with Zabbix community if you created something nice. #### Огляд За замовчуванням Zabbix надає кілька попередньо визначених тем. Ви можете виконати наведену тут покрокову процедуру, щоб створити свій власний. Не соромтеся поділитися результатом своєї роботи зі спільнотою Zabbix, якщо ви створили щось хороше. #### Overview Debug mode may be used to diagnose performance problems with frontend pages. #### Огляд Режим налагодження можна використовувати для діагностики проблем продуктивності зовнішніх сторінок. #### Overview Depending on user role permissions, the *User settings* section may contain the following pages: - *User profile* - for customizing certain Zabbix frontend features; - *API tokens* - for managing API tokens assigned to the current user. The list of available pages appears upon pressing on the  user icon near the bottom of the Zabbix menu (not available for a guest user). It is also possible to switch between pages by using a title dropdown in the top left corner. | | | |---|---| |{width="300"}|{width="300"}| |Third-level menu.|Title dropdown.| #### Overview Залежно від дозволів ролі користувача, розділ *Налаштування користувача* може містити такі сторінки: - *User profile* - для налаштування певних функцій інтерфейсу Zabbix; - *API tokens* -для керування токенами API, призначеними поточному користувачеві. Список доступних сторінок з’являється після натискання піктограми користувача  у нижній частині меню Zabbix (недоступно для гостя користувач). Також можна перемикатися між сторінками за допомогою спадного списку заголовків у верхньому лівому куті. | | | |---|---| |{width="300"}|{width="300"}| |Third-level menu.|Title dropdown.| #### Overview For an easy access to Zabbix from anywhere and from any platform, the web-based interface is provided. ::: noteclassic If using more than one frontend instance make sure that the locales and libraries (LDAP, SAML etc.) are installed and configured identically for all frontends. ::: #### Огляд Для легкого доступу до Zabbix з будь-якого місця та з будь-якої платформи надається веб-інтерфейс. ::: noteclassic Якщо використовується більше одного екземпляра інтерфейсу, переконайтеся, що локалі та бібліотеки (LDAP, SAML тощо) встановлені та налаштовані однаково для всіх інтерфейсів. ::: #### Overview Global notifications are a way of displaying issues that are currently happening right on the screen you're at in Zabbix frontend. Without global notifications, working in some other location than *Problems* or the *Dashboard* would not show any information regarding issues that are currently happening. Global notifications will display this information regardless of where you are. Global notifications involve both showing a message and [playing a sound](sound). ::: noteimportant The auto play of sounds may be disabled in recent browser versions by default. In this case, you need to change this setting manually. ::: #### Огляд Глобальні сповіщення – це спосіб відображення проблем, які зараз відбуваються прямо на екрані, на якому ви перебуваєте у інтерфейсі Zabbix. Без глобальних сповіщень робота в якомусь іншому місці, ніж *Проблеми* або *Інформаційна панель*, не відображатиме жодної інформації щодо проблем, які зараз відбуваються. Глобальні сповіщення відображатимуть цю інформацію незалежно від того, де ви перебуваєте. Глобальні сповіщення включають як показ повідомлення, так і [відтворення звуку](звук). ::: приміткаважливо Автоматичне відтворення звуків може бути вимкнено в останніх версіях браузера за замовчуванням. У цьому випадку вам потрібно змінити цей параметр вручну. ::: ### Overview High availability (HA) is typically required in critical infrastructures that can afford virtually no downtime. So for any service that may fail there must be a failover option in place to take over should the current service fail. Zabbix offers a **native** high-availability solution that is easy to set up and does not require any previous HA expertise. Native Zabbix HA may be useful for an extra layer of protection against software/hardware failures of Zabbix server or to have less downtime due to maintenance. In the Zabbix high availability mode multiple Zabbix servers are run as nodes in a cluster. While one Zabbix server in the cluster is active, others are on standby, ready to take over if necessary.  Switching to Zabbix HA is non-committal. You may switch back to standalone operation at any point. See also: [Implementation details](#implementation-details) ### Огляд Висока доступність (HA) зазвичай потрібна в критичних інфраструктурах, які практично не можуть дозволити собі простоїв. Тож, для будь-якого сервісу, який може вийти з ладу, має бути передбачена можливість переключення на інший ресурс, у разі відмови поточного сервісу. Zabbix пропонує **власне** рішення високої доступності, яке легко налаштувати і яке не потребує попереднього досвіду роботи з HA. Це вбудоване рішення може бути корисним як додатковий рівень захисту від програмних або апаратних збоїв сервера Zabbix або для зменшення часу простою під час технічного обслуговування. У режимі високої доступності Zabbix, кілька Zabbix серверів працюють як вузли кластеру. Поки один Zabbix сервер у кластері активний, інші знаходяться в режимі очікування і готові взяти на себе роботу, в разі потреби.  Перехід на Zabbix HA не є незворотнім. Ви можете повернутися до режиму самостійної роботи в будь-який момент. Дивіться також: [Деталі реалізації](#implementation-details) #### Overview Hosts are [exported](/manual/xml_export_import) with many related objects and object relations. Host export contains: - linked host groups - host data - template linkage - host group linkage - host interfaces - directly linked items - directly linked triggers - directly linked graphs - directly linked discovery rules with all prototypes - directly linked web scenarios - host macros - host inventory data - value maps #### Огляд Вузли мережі [експортуються](/manual/xml_export_import) із багатьма пов’язаними об’єктами та об’єктними зв’язками. Експорт хосту містить: - пов'язані групи хостів - дані вузла мережі - посилання на шаблон - прив'язка групи вузла мережі - інтерфейси вузла мережі - безпосередньо пов'язані елементи даних - безпосередньо пов'язані тригери - безпосередньо зв'язані графи - безпосередньо пов'язані правила відкриття з усіма прототипами - безпосередньо пов'язані веб-сценарії - макроси вузла мережі - дані інвентаризації вузла мережі - карти значень #### Overview In order to use any other language than English in Zabbix web interface, its locale should be installed on the web server. Additionally, the PHP gettext extension is required for the translations to work. #### Огляд Щоб використовувати будь-яку іншу мову, окрім англійської, у веб-інтерфейсі Zabbix, її локаль повинна бути встановлена на веб-сервері. Крім того, для роботи перекладів потрібне розширення PHP gettext. #### Overview In the *Administration → Proxies* section proxies for [distributed monitoring](/manual/distributed_monitoring) can be configured in the Zabbix frontend. #### Огляд У розділі *Адміністрування → Проксі* можна налаштувати проксі для [розподіленого моніторингу](/manual/distributed_monitoring) у інтерфейсі Zabbix. #### Overview In the *Administration → User groups* section user groups of the system are maintained. #### Огляд У розділі *Адміністрування → Групи* користувачів ведуться групи користувачів системи. #### Overview In the *Administration → User roles* section roles that can be assigned to system users and specific permissions for each role are maintained. #### Огляд У розділі *Адміністрування → Ролі користувачів* зберігаються ролі, які можна призначати користувачам системи, і спеціальні дозволи для кожної ролі. #### Overview In the *Administration → Users* section users of the system are maintained. #### Огляд У розділі *Адміністрування → Користувачі* здійснюється обслуговування користувачів системи. #### Overview In this section, you will learn how to log in and set up a system user in Zabbix. #### Огляд У цьому розділі ви дізнаєтесь, як увійти та налаштувати користувача системи Zabbix. #### Overview In this section you will learn how to set up alerting in the form of notifications in Zabbix. With items collecting data and triggers designed to "fire" upon problem situations, it would also be useful to have some alerting mechanism in place that would notify us about important events even when we are not directly looking at Zabbix frontend. This is what notifications do. Email being the most popular delivery method for problem notifications, we will learn how to set up an email notification. #### Огляд У цьому розділі ви дізнаєтесь, як налаштувати оповіщення у вигляді повідомлень у Zabbix. З елементами, які збирають дані, і тригерами, розробленими для "спрацьовування" проблемних ситуацій, також було б корисно мати певний механізм сповіщення, який сповіщав би нас про важливі події, навіть якщо ми безпосередньо не дивимось на інтерфейс Zabbix. Це те, що роблять сповіщення. Електронна пошта є найпопулярнішим способом доставки сповіщень про проблеми, тому ми дізнаємося, як налаштувати сповіщення електронною поштою. #### Overview In this section you will learn how to set up a new host. A host in Zabbix is a networked entity (physical, virtual) that you wish to monitor. The definition of what can be a "host" in Zabbix is quite flexible. It can be a physical server, a network switch, a virtual machine or some application. #### Огляд У цьому розділі ви дізнаєтесь, як налаштувати новий вузол. Вузол у Zabbix — це мережева сутність (фізична, віртуальна), яку ви бажаєте моніторити. Визначення того, що може бути "вузлом" у Zabbix, досить гнучке. Це може бути фізичний сервер, мережевий комутатор, віртуальна машина або якийсь додаток. #### Overview In this section, you will learn how to set up an item. Items are the basis of gathering data in Zabbix. Without items, there is no data - because only an item defines a single metric or what kind of data to collect from a host. #### Огляд У цьому розділі ви дізнаєтеся, як налаштувати елемент. Елементи є основою для збору даних у Zabbix. Без елементів немає даних, тому що лише елемент визначає один показник або тип даних, які потрібно збирати з вузла. #### Overview In this section you will learn how to set up a trigger. Items only collect data. To automatically evaluate incoming data we need to define triggers. A trigger contains an expression that defines a threshold of what is an acceptable level for the data. If that level is surpassed by the incoming data, a trigger will "fire" or go into a 'Problem' state - letting us know that something has happened that may require attention. If the level is acceptable again, trigger returns to an 'Ok' state. #### Огляд У цьому розділі ви дізнаєтесь, як налаштувати тригер. Елементи лише збирають дані. Щоб автоматично оцінювати вхідні дані, нам потрібно визначити тригери. Тригер містить вираз, який визначає порогове значення прийнятного рівня для даних. Якщо вхідні дані перевищують цей рівень, спрацьовує тригер, або переходить у стан "Проблема", повідомляючи нам, що трапилося щось, що може потребувати уваги. Якщо рівень знову прийнятний, тригер повертається до стану "OK". ### Overview In Zabbix 6.0, [service monitoring](/manual/it_services) functionality has been reworked significantly (see [What's new in Zabbix 6.0.0](https://www.zabbix.com/documentation/6.0/en/manual/introduction/whatsnew600#services) for the list of changes). This page describes how services and SLAs, defined in earlier Zabbix versions, are changed during an upgrade to Zabbix 6.0 or newer. ### Огляд У Zabbix 6.0 функціональність [сервісу моніторингу](/manual/it_services) була значно перероблена (перегляньте список змін у розділі [Що нового в Zabbix 6.0.0](https://www.zabbix.com/documentation/6.0/en/manual/introduction/whatsnew600#services)). На цій сторінці описано, як послуги та SLA, визначені в попередніх версіях Zabbix, змінюються під час оновлення до Zabbix 6.0 або новішої. #### Overview It is possible to enhance Zabbix frontend functionality by adding third-party modules or by developing your own modules without the need to change the source code of Zabbix. Note that the module code will run with the same privileges as Zabbix source code. This means: - third-party modules can be harmful. You must trust the modules you are installing; - Errors in a third-party module code may crash the frontend. If this happens, just remove the module code from the frontend. As soon as you reload Zabbix frontend, you'll see a note saying that some modules are absent. Go to [Module administration](/manual/web_interface/frontend_sections/administration/general#modules) (in *Administration* → *General* → *Modules*) and click *Scan directory* again to remove non-existent modules from the database. #### Огляд Ви можете розширити функціональність інтерфейсу Zabbix, додавши сторонні модулі або розробивши власні модулі без необхідності змінювати вихідний код Zabbix. Зверніть увагу, що код модуля буде виконуватися з тими ж привілеями, що і вихідний код Zabbix. Це означає, що - сторонні модулі можуть бути небезпечними. Ви повинні довіряти модулям, які ви встановлюєте; - помилки в коді сторонніх модулів можуть призвести до аварійного завершення роботи фронтенду. Якщо це сталося, просто видаліть код модуля з фронтенду. Як тільки ви перезавантажите фронтенд Zabbix, ви побачите повідомлення про те, що деякі модулі відсутні. Перейдіть у [Адміністрування модулів](/manual/web_interface/frontend_sections/administration/general#modules) (в розділі *Адміністрування* → *Загальні* → *Модулі*) і натисніть *Сканувати директорію* ще раз, щоб видалити неіснуючі модулі з бази даних #### Overview Kerberos authentication can be used in web monitoring and HTTP items in Zabbix since version 4.4.0. This section describes an example of configuring Kerberos with Zabbix server to perform web monitoring of `www.example.com` with user 'zabbix'. #### Огляд Автентифікацію Kerberos можна використовувати в веб-моніторингу та елементах HTTP в Zabbix, починаючи з версії 4.4.0. У цьому розділі описано приклад налаштування Kerberos із сервером Zabbix для виконання веб-моніторингу `www.example.com` за допомогою користувача 'zabbix'. #### Overview Linking is a process whereby templates are applied to hosts, whereas unlinking removes the association with the template from a host. ::: noteimportant Templates are linked directly to individual hosts and not to host groups. Simply adding a template to a host group will not link it. Host groups are used only for logical grouping of hosts and templates. ::: #### Огляд Зв’язування — це процес, за допомогою якого шаблони застосовуються до вузлів, тоді як від’єднання видаляє зв’язок шаблоном з вузлом. ::: noteimportant Шаблони пов’язані безпосередньо з окремими вузлами, а не з групами вузлів. Просте додавання шаблону до групи вузлів не прив’яже його. Групи вузлів використовуються лише для логічного групування вузлів і шаблонів. ::: #### Overview Problem events in Zabbix can be acknowledged by users. If a user gets notified about a problem event, they can go to Zabbix frontend, open the problem update popup window of that problem using one of the ways listed below and acknowledge the problem. When acknowledging, they can enter their comment for it, saying that they are working on it or whatever else they may feel like saying about it. This way, if another system user spots the same problem, they immediately see if it has been acknowledged and the comments so far. This way the workflow of resolving problems with more than one system user can take place in a coordinated way. Acknowledgment status is also used when defining [action operations](/manual/config/notifications/action/operation). You can define, for example, that a notification is sent to a higher level manager only if an event is not acknowledged for some time. To acknowledge events and comment on them, a user must have at least read permissions to the corresponding triggers. To change problem severity or close problem, a user must have read-write permissions to the corresponding triggers. There are **several** ways to access the problem update popup window, which allows acknowledging a problem. - You may select problems in *Monitoring* → *Problems* and then click on *Mass update* below the list - You can click in the *Ack* column showing the acknowledgment status of problems in: - *Monitoring → Dashboard* (*Problems* and *Problems by severity* widgets) - *Monitoring → Problems* - *Monitoring → Problems → Event details* The *Ack* column contains either a 'Yes' or a 'No' link, indicating an acknowledged or an unacknowledged problem respectively. Clicking on the links will take you to the problem update popup window. - You can click on an unresolved problem cell in: - *Monitoring → Dashboard* (*Trigger overview* widget) The popup menu contains an *Acknowledge* option that will take you to the problem update window. #### Огляд Проблемні події в Zabbix можуть бути визнані користувачами. Якщо користувач отримує сповіщення про проблему, він може перейти до інтерфейсу Zabbix, відкрити спливаюче вікно оновлення цієї проблеми одним із способів, перелічених нижче, і підтвердити проблему. Підтверджуючи, вони можуть ввести свій коментар до цього, сказавши,що вони над цим працюють, або будь-що інше, що вони можуть сказати про це. Таким чином, якщо інший користувач системи помітить ту саму проблему, він одразу побачить, чи було її підтверджено, і коментарі до цього часу. Таким чином робочий процес вирішення проблем із кількома користувачами системи може відбуватися скоординовано. Статус підтвердження також використовується під час визначення [операцій дій](/manual/config/notifications/action/operation). Ви можете визначити, наприклад, що сповіщення надсилається менеджеру вищого рівня, лише якщо подія не підтверджується протягом деякого часу. Щоб підтверджувати події та коментувати їх, користувач повинен мати принаймні дозволи на читання відповідних тригерів. Щоб змінити серйозність проблеми або закрити проблему, користувач повинен мати дозволи на читання та запис для відповідних тригерів. Існує **кілька** способів отримати доступ до спливаючого вікна оновлення проблеми, яке дозволяє підтвердити проблему. - Ви можете вибрати проблеми в *Моніторинг* → *Проблеми*, а потім натиснути *Масове оновлення* під списком - Ви можете клацнути в стовпці *Підтвердження*, який показує стан підтвердження проблем у: - *Моніторинг → Інформаційна панель* (віджети *Проблеми* та *Проблеми за ступенем серйозності*) - *Моніторинг → Проблеми* - *Моніторинг → Проблеми → Деталі події* Стовпець *Підтвердження* містить посилання «Так» або «Ні», що вказує на підтверджену або непідтверджену проблему відповідно. Натиснувши посилання, ви перейдете до спливаючого вікна оновлення проблеми. - Ви можете натиснути клітинку невирішеної проблеми в: - *Моніторинг → Інформаційна панель* (*Віджет «Огляд тригерів») Спливаюче меню містить опцію *Підтвердити*, яка переведе вас до вікна оновлення проблеми. #### Overview Some new items are automatically added for monitoring when web scenarios are created. All items inherit tags from the web scenario. #### Огляд Деякі нові елементи автоматично додаються для моніторингу під час створення веб-сценаріїв. Усі елементи успадковують теги з веб-сценарію. #### Overview Sound is used in [global notifications](/manual/web_interface/user_profile/global_notifications). For the sounds to be played in Zabbix frontend, *Frontend messaging* must be enabled in the user profile *Messaging* tab, with all trigger severities checked, and sounds should also be enabled in the global notification pop-up window. If for some reasons audio cannot be played on the device, the  button in the global notification pop-up window will permanently remain in the "mute" state and the message "Cannot support notification audio for this device." will be displayed upon hovering over the  button. Sounds, including the default audio clips, are supported in MP3 format only. The sounds of Zabbix frontend have been successfully tested in recent Firefox/Opera browsers on Linux and in Chrome, Firefox, Microsoft Edge, and Opera browsers on Windows. ::: noteimportant The auto play of sounds may be disabled in recent browser versions by default. In this case, you need to change this setting manually. ::: #### Огляд Звук використовується в [глобальних сповіщеннях](/manual/web_interface/user_profile/global_notifications). Щоб звуки відтворювалися у інтерфейсі Zabbix, *Повідомлення у веб-інтерфейсі* має бути ввімкнено у профілі користувача на вкладці *Повідомлення*, з позначеними всіма рівнями серйозності тригерів, а звуки також мають бути ввімкнені в глобальному спливаючому вікні сповіщень. Якщо з певних причин аудіо не відтворюється на пристрої, кнопка  у спливаючому вікні глобального сповіщення постійно залишатиметься в стані «без звуку» та повідомлення «Неможливо підтримувати звук сповіщень для цього пристрою.» відображатиметься після наведення курсора на кнопку . Звуки, включаючи стандартні аудіокліпи, підтримуються лише у форматі MP3. Звуки інтерфейсу Zabbix були успішно протестовані в останніх браузерах Firefox/Opera в Linux і браузерах Chrome, Firefox, Microsoft Edge і Opera в Windows. ::: noteimportant Автоматичне відтворення звуків може бути вимкнено в останніх версіях браузера за замовчуванням. У цьому випадку вам потрібно змінити цей параметр вручну. ::: ### Overview The *Administration → Authentication* section allows to specify the global user authentication method to Zabbix and internal password requirements. The available methods are internal, HTTP, LDAP, and SAML authentication. ### Огляд У розділі *Адміністрування → Автентифікація* можна вказати глобальний метод автентифікації користувача для Zabbix і вимоги до внутрішнього пароля. Доступні методи: внутрішня, HTTP, LDAP і SAML автентифікація. #### Overview The *Administration → General* section contains a number of subsections for setting frontend-related defaults and customizing Zabbix. The list of available subsections appears upon pressing on *General* in the *Administration* menu section. It is also possible to switch between subsections by using the title dropdown in the top left corner. #### Огляд Розділ *Адміністрування → Загальні* містить низку підрозділів для налаштування параметрів інтерфейсу за замовчуванням і налаштування Zabbix. Список доступних підрозділів з’являється після натискання *Загальні* в розділі меню *Адміністрування*. Також можна перемикатися між підрозділами за допомогою спадного списку заголовків у верхньому лівому куті. #### Overview The Administration menu is for administrative functions of Zabbix. This menu is available to users of [Super Administrators](/manual/config/users_and_usergroups/permissions) type only. #### Огляд Меню адміністрування призначене для адміністративних функцій Zabbix. Це меню доступне лише для користувачів типу [супер-адміністратори](/manual/config/users_and_usergroups/permissions). #### Overview The Monitoring menu is all about displaying data. Whatever information Zabbix is configured to gather, visualize and act upon, it will be displayed in the various sections of the Monitoring menu. #### Огляд У меню моніторингу відображаються дані. Яку б інформацію не налаштував Zabbix для збору, візуалізації та дії, вона буде відображатися в різних розділах меню моніторингу. #### Overview The Reports menu features several sections that contain a variety of predefined and user-customizable reports focused on displaying an overview of such parameters as system information, triggers and gathered data. #### Огляд Меню «Звіти» містить кілька розділів, які містять різноманітні попередньо визначені та настроювані користувачем звіти, орієнтовані на відображення огляду таких параметрів, як системна інформація, тригери та зібрані дані. #### Overview The Services menu is for the [service monitoring](/manual/it_services) functions of Zabbix. #### Огляд Меню «Сервіси» призначене для функцій [сервісного моніторингу] /manual/it_services) Zabbix. ### Overview This section allows to view and [configure](/manual/it_services/sla) SLAs. ### Огляд Цей розділ дозволяє переглядати та [налаштовувати](/manual/it_services/sla) SLA. #### Overview This section presents a step-by-step real-life example of how web monitoring can be used. Let's use Zabbix web monitoring to monitor the web interface of Zabbix. We want to know if it is available, provides the right content and how quickly it works. To do that we also must log in with our user name and password. #### Огляд У цьому розділі покроково наведено реальний приклад того, як можна використовувати веб-моніторинг. Давайте використаємо веб-моніторинг Zabbix для моніторингу веб-інтерфейсу Zabbix. Ми хочемо знати, чи він доступний, надає потрібний вміст і як швидко працює. Для цього ми також повинні увійти, використовуючи своє ім’я користувача та пароль. #### Overview While many things in the frontend can be configured using the frontend itself, some customisations are currently only possible by editing a definitions file. This file is `defines.inc.php` located in /include of the Zabbix HTML document directory. #### Огляд Хоча багато речей у інтерфейсі можна налаштувати за допомогою самого інтерфейсу, деякі налаштування наразі можливі лише шляхом редагування файлу визначень. Файл `defines.inc.php` знаходиться в /include каталогу документів HTML Zabbix. #### Overview Zabbix agent 2 is a new generation of Zabbix agent and may be used in place of Zabbix agent. This section lists parameters supported in a Zabbix agent 2 configuration file (zabbix\_agent2.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported in the beginning of the line. #### Огляд Zabbix agent 2 — це нове покоління Zabbix агента, який може використовуватися замість Zabbix agent. У цьому розділі перераховано параметри, які підтримуються у файлі конфігурації Zabbix agent 2 (zabbix\_agent2.conf). Зауважте, що: - Значення за замовчуванням відображають параметри процесу за замовчуванням, а не значення в надісланих файлах конфігурації; - Zabbix підтримує конфігураційні файли лише в кодуванні UTF-8 без [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Коментарі, що починаються з "\#", підтримуються лише на початку рядка. ### Overview Zabbix API allows you to programmatically retrieve and modify the configuration of Zabbix and provides access to historical data. It is widely used to: - Create new applications to work with Zabbix; - Integrate Zabbix with third-party software; - Automate routine tasks. The Zabbix API is a web based API and is shipped as part of the web frontend. It uses the JSON-RPC 2.0 protocol which means two things: - The API consists of a set of separate methods; - Requests and responses between the clients and the API are encoded using the JSON format. More info about the protocol and JSON can be found in the [JSON-RPC 2.0 specification](http://www.jsonrpc.org/specification) and the [JSON format homepage](http://json.org/). For more information about integrating Zabbix functionality into your Python applications, see the [zabbix_utils](https://github.com/zabbix/python-zabbix-utils) Python library for Zabbix API. ### Огляд Zabbix API дозволяє програмно отримувати та змінювати налаштування Zabbix і забезпечує доступ до історичних даних. Це є широко використовується для: - Створення нові програми для роботи з Zabbix; - Інтегрування Zabbix у стороннє програмне забезпечення; - Автоматизації рутинних завдань. Zabbix API — це web API, яке постачається як частина веб-інтерфейсу. Воно використовує протокол JSON-RPC 2.0, що означає дві речі: - API складається з набору окремих методів. - Запити та відповіді між клієнтами та API кодуються у форматі JSON. Додаткову інформацію про протокол і JSON можна знайти в [специфікації JSON-RPC 2.0] (http://www.jsonrpc.org/specification) і [на домашній сторінці формату JSON](http://json.org/). Щоб дізнатися більше про інтеграцію функцій Zabbix у ваші програми Python, перегляньте [zabbix_utils](https://github.com/zabbix/python-zabbix-utils) - Python бібліотеку для Zabbix API. #### Overview Zabbix supports TimescaleDB, a PostgreSQL-based database solution of automatically partitioning data into time-based chunks to support faster performance at scale. ::: notewarning Currently TimescaleDB is not supported by Zabbix proxy. ::: Instructions on this page can be used for creating TimescaleDB database or migrating from existing PostgreSQL tables to TimescaleDB. #### Огляд Zabbix підтримує TimescaleDB, базу даних на базі PostgreSQL, яка автоматично розбиває дані на фрагменти, що базуються на часовому діапазоні, для підтримки більшої продуктивності в масштабі. ::: приміткапопередження Наразі TimescaleDB не підтримується проксі Zabbix. ::: Інструкції на цій сторінці можна використовувати для створення бази даних TimescaleDB або міграції з існуючих таблиць PostgreSQL до TimescaleDB. #### Overview Zabbix web frontend can be temporarily disabled in order to prohibit access to it. This can be useful for protecting the Zabbix database from any changes initiated by users, thus protecting the integrity of database. Zabbix database can be stopped and maintenance tasks can be performed while Zabbix frontend is in maintenance mode. Users from defined IP addresses will be able to work with the frontend normally during maintenance mode. #### Огляд Веб-інтерфейс Zabbix можна тимчасово відключити, щоб заборонити доступ до нього. Це може бути корисним для захисту бази даних Zabbix від будь-яких змін, ініційованих користувачами, таким чином захищаючи цілісність бази даних. Базу даних Zabbix можна зупинити та виконати завдання з обслуговування, поки інтерфейс Zabbix перебуває в режимі обслуговування. Користувачі з визначених IP-адрес зможуть нормально працювати з інтерфейсом у режимі обслуговування. #### Overview Zabbix web service is a process that is used for communication with external web services. This section lists parameters supported in Zabbix web service configuration file (zabbix\_web\_service.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Огляд Веб-сервіс Zabbix — це процес, який використовується для зв’язку із зовнішніми веб-сервісами. У цьому розділі перераховано параметри, які підтримуються у файлі конфігурації веб-сервісу Zabbix (zabbix\_web\_service.conf). Зауважте, що: - Значення за замовчуванням відображають параметри процесу за замовчуванням, а не значення в надісланих файлах конфігурації; - Zabbix підтримує конфігураційні файли лише в кодуванні UTF-8 без [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Коментарі, що починаються з "\#", підтримуються лише на початку рядка. ### Parameters `(array)` IDs of hosts to delete. ### Параметри `(array)` ID хостів для видалення. ### Parameters `(array)` IDs of items to clear. ### Параметри `(array)` ID елементів для очищення. ### Parameters `(array)` IDs of proxies to delete. ### Параметри `(array)` ID проксі для видалення. ### Parameters `(array)` IDs of the actions to delete. ### Параметри `(array)` Ідентифікатори дій для видалення. ### Parameters `(array)` IDs of the correlations to delete. ### Параметри `(array)` Ідентифікатори кореляцій, які потрібно видалити. ### Parameters `(array)` IDs of the dashboards to delete. ### Параметри `(array)` Ідентифікатори інформаційних панелей для видалення. ### Parameters `(array)` IDs of the discovery rules to delete. ### Параметри `(array)` ідентифікатори правил виявлення для видалення. ### Parameters `(array)` IDs of the graph prototypes to delete. ### Параметри `(масив)` ID прототипів графіків для видалення. ### Parameters `(array)` IDs of the graphs to delete. ### Параметри `(array)` ID графіків для видалення. ### Parameters `(array)` IDs of the host groups to delete. ### Параметри `(array)` ID груп хостів для видалення. ### Parameters `(array)` IDs of the host interfaces to delete. ### Параметри `(array)` ID хост-інтерфейсів для видалення. ### Parameters `(array)` IDs of the host prototypes to delete. ### Параметри `(array)` ID прототипів вузлів для видалення. ### Parameters `(array)` IDs of the LLD rules to delete. ### Параметри `(array)` ідентифікатори правил LLD для видалення. ### Parameters `(array)` The method accepts an empty array. ### Параметри `(array)` Метод приймає порожній масив. ### Parameters `(object/array)` Action properties to be updated. The `actionid` property must be defined for each action, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard action properties](object#action), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) object to replace the current filter.| |operations|array|Action [operations](/manual/api/reference/action/object#action_operation) to replace existing operations.| |recovery\_operations|array|Action [recovery operations](/manual/api/reference/action/object#action_recovery_operation) to replace existing recovery operations.| |update\_operations|array|Action [update operations](/manual/api/reference/action/object#action_update_operation) to replace existing update operations.| ### Параметри `(object/array)` Властивості дії, які потрібно оновити. Властивість `actionid` має бути визначена для кожної дії, усі інші властивості необов’язкові. Будуть оновлені лише передані властивості, всі інші залишаться незмінними. Окрім [стандартних властивостей дії](object#action), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |filter|object|Дія [filter](/manual/api/reference/action/object#action_filter) об’єкт для заміни поточного фільтра.| |operations|array|Дія [operations](/manual/api/reference/action/object#action_operation) для заміни існуючих операцій.| |recovery\_operations|array|Дія [операції відновлення](/manual/api/reference/action/object#action_recovery_operation) для заміни існуючих операцій відновлення.| |update\_operations|array|Дія [операції оновлення](/manual/api/reference/action/object#action_update_operation) для заміни існуючих операцій оновлення.| ### Parameters `(object/array)` Actions to create. Additionally to the [standard action properties](object#action), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) object for the action.| |operations|array|Action [operations](/manual/api/reference/action/object#action_operation) to create for the action.| |recovery\_operations|array|Action [recovery operations](/manual/api/reference/action/object#action_recovery_operation) to create for the action.| |update\_operations|array|Action [update operations](/manual/api/reference/action/object#action_update_operation) to create for the action.| ### Параметри `(object/array)` Дії для створення. На додаток до [стандартних властивостей дії](object#action), метод приймає наступні параметри. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Дія [фільтр](/manual/api/reference/action/object#action_filter) об’єкт для дії.|| |operations|array|Дія [операції](/manual/api/reference/action/object#action_operation), щоб створити для дії.| |recovery\_operations|array|Дія [операції відновлення](/manual/api/reference/action/object#action_recovery_operation), яку потрібно створити для дії.| |update\_operations|array|Дія [операції оновлення](/manual/api/reference/action/object#action_update_operation), яку потрібно створити для дії.| ### Parameters `(object/array)` Correlation properties to be updated. The `correlationid` property must be defined for each correlation, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard correlation properties](object#correlation), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Correlation [filter](/manual/api/reference/correlation/object#correlation_filter) object to replace the current filter.| |operations|array|Correlation [operations](/manual/api/reference/correlation/object#correlation_operation) to replace existing operations.| ### Параметри Властивості кореляції `(object/array) буде оновлено. Властивість correlationid має бути визначена для кожної кореляції, усі інші властивості необов’язкові. Будуть оновлені лише передані властивості, всі інші залишаться незмінними. Окрім [стандартних властивостей кореляції](object#correlation), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |фільтр|об’єкт|Об’єкт кореляції [фільтр](/manual/api/reference/correlation/object#correlation_filter) для заміни поточного фільтра.| |operations|array|Кореляційні [операції](/manual/api/reference/correlation/object#correlation_operation) для заміни існуючих операцій.| ### Parameters `(object/array)` Correlations to create. Additionally to the [standard correlation properties](object#correlation), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**operations**<br>(required)|array|Correlation [operations](/manual/api/reference/correlation/object#correlation_operation) to create for the correlation.| |**filter**<br>(required)|object|Correlation [filter](/manual/api/reference/correlation/object#correlation_filter) object for the correlation.| ### Параметри `(object/array)` Кореляції для створення. Окрім [стандартних властивостей кореляції](object#correlation), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**operations**<br>(обов’язково)|масив|Кореляційні [операції](/manual/api/reference/correlation/object#correlation_operation) для створення кореляції.| |**filter**<br>(обов’язково)|об’єкт|Об’єкт кореляції [фільтр](/manual/api/reference/correlation/object#correlation_filter) для кореляції.| ### Parameters `(object/array)` Dashboard properties to be updated. The `dashboardid` property must be specified for each dashboard, all other properties are optional. Only the specified properties will be updated. Additionally to the [standard dashboard properties](object#dashboard), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |pages|array|Dashboard [pages](object#dashboard_page) to replace the existing dashboard pages.<br><br>Dashboard pages are updated by the `dashboard_pageid` property. New dashboard pages will be created for objects without `dashboard_pageid` property and the existing dashboard pages will be deleted if not reused. Dashboard pages will be ordered in the same order as specified. Only the specified properties of the dashboard pages will be updated. At least one dashboard page object is required for `pages` property.| |users|array|Dashboard [user](object#dashboard_user) shares to replace the existing elements.| |userGroups|array|Dashboard [user group](object#dashboard_user_group) shares to replace the existing elements.| ### Параметри `(object/array)` властивості інформаційної панелі, які потрібно оновити. Для кожної інформаційної панелі необхідно вказати властивість `dashboardid`, усі інші властивості необов’язкові. Буде оновлено лише вказані властивості. Окрім [стандартних властивостей інформаційної панелі](object#dashboard), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |pages|array|Інформаційна панель [сторінки](object#dashboard_page) для заміни існуючих сторінок інформаційної панелі.<br><br>Сторінки інформаційної панелі оновлюються за допомогою властивості `dashboard_pageid`. Буде створено нові сторінки інформаційної панелі для об’єктів без властивості `dashboard_pageid`, а наявні сторінки інформаційної панелі буде видалено, якщо вони не будуть використані повторно. Сторінки інформаційної панелі будуть упорядковані в тому ж порядку, що й указано. Буде оновлено лише вказані властивості сторінок інформаційної панелі. Для властивості `pages` потрібен принаймні один об’єкт сторінки приладної панелі.| |users|масив|Інформаційна панель [користувач](object#dashboard_user) ділиться для заміни існуючих елементів.| |userGroups|масив|Інформаційна панель [група користувачів](object#dashboard_user_group) ділиться для заміни існуючих елементів.| ### Parameters `(object/array)` Dashboards to create. Additionally to the [standard dashboard properties](object#dashboard), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**pages**<br>(required)|array|Dashboard [pages](object#dashboard_page) to be created for the dashboard. Dashboard pages will be ordered in the same order as specified. At least one dashboard page object is required for `pages` property.| |users|array|Dashboard [user](object#dashboard_user) shares to be created on the dashboard.| |userGroups|array|Dashboard [user group](object#dashboard_user_group) shares to be created on the dashboard.| ### Параметри `(object/array)` Інформаційні панелі для створення. Окрім [стандартних властивостей інформаційної панелі](object#dashboard), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**pages**<br>(обов’язково)|масив|Інформаційна панель [сторінки](object#dashboard_page), яку потрібно створити для інформаційної панелі. Сторінки інформаційної панелі будуть упорядковані в тому ж порядку, що й указано. Для властивості `pages` потрібен принаймні один об’єкт сторінки приладної панелі.| |users|масив|На панелі інструментів [користувач](object#dashboard_user) спільний доступ буде створено на панелі інструментів.| |userGroups|масив|Інформаційна панель [група користувачів](object#dashboard_user_group) спільні ресурси, які будуть створені на інформаційній панелі.| ### Parameters `(object/array)` Discovery rule properties to be updated. The `druleid` property must be defined for each discovery rule, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard discovery rule properties](object#discovery_rule), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dchecks|array|Discovery [checks](/manual/api/reference/dcheck/object) to replace existing checks.| ### Параметри `(object/array)` Властивості правила виявлення буде оновлено. Властивість `druleid` має бути визначена для кожного правила виявлення, усі інші властивості необов’язкові. Будуть оновлені лише передані властивості, всі інші залишаться незмінними. Окрім [стандартних властивостей правила виявлення](object#discovery_rule), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |dchecks|масив|[перевірки] виявлення (/manual/api/reference/dcheck/object) для заміни існуючих перевірок.| ### Parameters `(object/array)` Discovery rules to create. Additionally to the [standard discovery rule properties](object#discovery_rule), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**dchecks**<br>(required)|array|Discovery [checks](/manual/api/reference/dcheck/object) to create for the discovery rule.| ### Параметри `(object/array)` Правила виявлення для створення. Окрім [стандартних властивостей правила виявлення](object#discovery_rule), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**dchecks**<br>(обов’язково)|масив|Виявлення [перевірки](/manual/api/reference/dcheck/object) для створення для правила виявлення.| ### Parameters `(object/array)` Graph properties to be updated. The `graphid` property must be defined for each graph, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph properties](object#graph) the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### Параметри `(object/array)` властивості графіка, які потрібно оновити. Властивість `graphid` має бути визначена для кожного графіка, усі інші властивості необов’язкові. Будуть оновлені лише передані властивості, всі інші залишаться незмінними. Додатково до [стандартних властивостей графа](object#graph) метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |gitems|масив|Графік [елементи](/manual/api/reference/graphitem/object) для заміни існуючих елементів графіка. Якщо для елемента графіка визначено властивість `gitemid`, його буде оновлено, інакше буде створено новий елемент графіка.| ### Parameters `(object/array)` Graph prototype properties to be updated. The `graphid` property must be defined for each graph prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph prototype properties](object#graph_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### Параметри `(object/array)` Властивості прототипу графіка, які потрібно оновити. Властивість `graphid` має бути визначена для кожного прототипу графа, усі інші властивості необов’язкові. Будуть оновлені лише передані властивості, всі інші залишаться незмінними. Окрім [стандартних властивостей прототипу графа](object#graph_prototype), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |gitems|масив|Графік [елементи](/manual/api/reference/graphitem/object) для заміни існуючих елементів графіка. Якщо для елемента графіка визначено властивість `gitemid`, його буде оновлено, інакше буде створено новий елемент графіка.| ### Parameters `(object/array)` Graph prototypes to create. Additionally to the [standard graph prototype properties](object#graph_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**gitems**<br>(required)|array|Graph [items](/manual/api/reference/graphitem/object) to be created for the graph prototypes. Graph items can reference both items and item prototypes, but at least one item prototype must be present.| ### Параметри `(object/array)` Створення прототипів графіків. Окрім [стандартних властивостей прототипу графа](object#graph_prototype), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**gitems**<br>(обов’язково)|масив|Графік [items](/manual/api/reference/graphitem/object), який буде створено для прототипів графів. Елементи графіка можуть посилатися як на елементи, так і на прототипи елементів, але має бути присутнім принаймні один прототип елемента.| ### Parameters `(object/array)` Graphs to create. Additionally to the [standard graph properties](object#graph), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**gitems**<br>(required)|array|Graph [items](/manual/api/reference/graphitem/object) to be created for the graph.| ### Параметри `(object/array)` Графіки для створення. Окрім [стандартних властивостей графа](object#graph), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**gitems**<br>(обов’язково)|масив|Графік [items](/manual/api/reference/graphitem/object), який буде створено для графіка.| ### Parameters `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Параметри `(object/array)` [Властивості групи хостів](object#host_group) потрібно оновити. Властивість groupid має бути визначена для кожної групи хостів, усі інші властивості необов’язкові. Будуть оновлені лише вказані властивості, всі інші залишаться незмінними. ### Parameters `(object/array)` Host groups to create. The method accepts host groups with the [standard host group properties](object#host_group). ### Параметри `(об’єкт/масив)` Групи хостів для створення. Метод приймає групи хостів із [стандартними властивостями групи хостів](object#host_group). ### Parameters `(object/array)` Host interfaces to create. The method accepts host interfaces with the [standard host interface properties](object#host_interface). ### Параметри `(object/array)` Інтерфейси хосту для створення. Метод приймає інтерфейси хоста зі [стандартними властивостями інтерфейсу хоста](object#host_interface). ### Parameters `(object/array)` Hosts to create. Additionally to the [standard host properties](object#host), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host [groups](/manual/api/reference/hostgroup/object) to add the host to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Interfaces](/manual/api/reference/hostinterface/object) to be created for the host.| |tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the host.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the host.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.| ### Параметри `(object/array)` Hosts to create. Окрім [стандартних властивостей хоста](object#host), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**groups**<br>(обов’язково)|object/array|Хост [групи](/manual/api/reference/hostgroup/object), до яких потрібно додати хост.<br><br>Групи хостів повинні мати визначено властивість `groupid`.| |інтерфейси|об’єкт/масив|[Інтерфейси](/manual/api/reference/hostinterface/об’єкт), який буде створено для хосту.| |теги|об'єкт/масив|Хост [теги](/manual/api/reference/host/object#host_tag).| |шаблони|об’єкт/масив|[Шаблони](/manual/api/reference/template/object), які потрібно зв’язати з хостом.<br><br>Шаблони повинні мати властивість `templateid`.| |макроси|об’єкт/масив|[Макроси користувача](/manual/api/reference/usermacro/об’єкт), який буде створено для хосту.| |інвентаризація|об'єкт|Властивості хосту [інвентаризація](/manual/api/reference/host/object#host_inventory).| ### Parameters `(object)` Authentication properties to be updated. ### Параметри Властивості автентифікації `(object)` буде оновлено. ### Parameters `(object)` Autoregistration properties to be updated. ### Параметри Властивості автореєстрації `(object)` буде оновлено. ### Parameters `(object)` Housekeeping properties to be updated. ### Параметри `(object)` Властивості прибирання буде оновлено. ### Parameters `(object)` Parameters containing the host interfaces to be created on the given hosts. The method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to create on the given hosts.| ### Параметри `(object)` Параметри, що містять інтерфейси хостів, які будуть створені на вказаних хостах. Метод приймає наступні параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**hosts**<br>(обов’язково)|object/array|Хости, які потрібно оновити.<br><br>Хости повинні мати визначену властивість `hostid`.| |**interfaces**<br>(обов’язково)|object/array|[Інтерфейси хостів](/manual/api/reference/hostinterface/object) для створення на вказаних хостах.| ### Parameters `(object)` Parameters containing the ID of the host to be updated and the new host interfaces. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostid**<br>(required)|string|ID of the host to be updated.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces with.| ### Параметри `(object)` Параметри, що містять ідентифікатор вузла, який потрібно оновити, і нові інтерфейси вузлаа. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**hostid**<br>(обов'язково)|string|ID вузла, який потрібно оновити.| |**interfaces**<br>(обов'язково)|object/array|[Інтерфейси вузла](/manual/api/reference/hostinterface/object) для заміни поточних інтерфейсів вузла.| ### Parameters `(object)` Parameters containing the IDs of the host groups to update and the objects that should be removed. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupids**<br>(required)|string/array|IDs of the host groups to be updated.| |hostids|string/array|Hosts to remove from all host groups.| |templateids|string/array|Templates to remove from all host groups.| ### Параметри `(object)` Параметри, що містять ідентифікатори груп хостів для оновлення та об’єктів, які слід видалити. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**groupids**<br>(обов’язково)|рядок/масив|Ідентифікатори груп хостів, які потрібно оновити.| |hostids|рядок/масив|Хости для видалення з усіх груп хостів.| |templateids|рядок/масив|Шаблони для видалення з усіх груп хостів.| ### Parameters `(object)` Parameters containing the IDs of the host groups to update and the objects that should be updated. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.| |**hosts**<br>(required)|object/array|Hosts to replace the current hosts on the given host groups.<br>All other hosts, except the ones mentioned, will be excluded from host groups.<br>Discovered hosts will not be affected.<br><br>The hosts must have the `hostid` property defined.| |**templates**<br>(required)|object/array|Templates to replace the current templates on the given host groups.<br>All other templates, except the ones mentioned, will be excluded from host groups.<br><br>The templates must have the `templateid` property defined.| ### Параметри `(object)` Параметри, що містять ідентифікатори груп хостів для оновлення та об’єктів, які потрібно оновити. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**groups**<br>(обов’язково)|object/array|Групи хостів, які потрібно оновити.<br><br>Групи хостів повинні мати визначену властивість `groupid`.| |**hosts**<br>(обов’язково)|object/array|Hosts для заміни поточних хостів у вказаних групах хостів.<br>Усі інші хости, окрім зазначених, буде виключено з груп хостів.<br >Виявлені хости не вплинуть.<br><br>Хости повинні мати визначену властивість `hostid`.| |**шаблони**<br>(обов’язково)|об’єкт/масив|Шаблони для заміни поточних шаблонів у вказаних групах хостів.<br>Усі інші шаблони, окрім згаданих, буде виключено з груп хостів.<br <br>Шаблони повинні мати визначену властивість `templateid`.| ### Parameters `(object)` Parameters containing the IDs of the host groups to update and the objects to add to all the host groups. The method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.| |hosts|object/array|Hosts to add to all host groups.<br><br>The hosts must have the `hostid` property defined.| |templates|object/array|Templates to add to all host groups.<br><br>The templates must have the `templateid` property defined.| ### Параметри `(object)` Параметри, що містять ідентифікатори груп хостів, які потрібно оновити, і об’єкти, які потрібно додати до всіх груп хостів. Метод приймає наступні параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**groups**<br>(обов’язково)|object/array|Групи хостів, які потрібно оновити.<br><br>Групи хостів повинні мати визначену властивість `groupid`.| |hosts|object/array|Хости для додавання до всіх груп хостів.<br><br>Хости повинні мати визначену властивість `hostid`.| |templates|object/array|Шаблони для додавання до всіх груп хостів.<br><br>Шаблони повинні мати визначену властивість `templateid`.| ### Parameters `(object)` Parameters containing the IDs of the hosts to be updated and the interfaces to be removed. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostids**<br>(required)|string/array|IDs of the hosts to be updated.| |**interfaces**<br>(required)|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the ip, dns and port properties defined| ### Параметри `(object)` Параметри, що містять ідентифікатори хостів, які потрібно оновити, та інтерфейсів, які потрібно видалити. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |**hostids**<br>(обов’язково)|string/array|Ідентифікатори хостів, які потрібно оновити.| |**interfaces**<br>(обов’язково)|string/array|Інтерфейси хостів, які потрібно видалити з указаних хостів.<br><br>Об’єкт інтерфейсу хостів повинен мати визначені властивості ip, dns і порт| ### Parameters `(object)` Parameters defining the LLD rules to copy and the target hosts. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.| ### Параметри `(object)` Параметри, що визначають правила LLD для копіювання та ціль господарі. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |discoveryids|масив|Ідентифікатори правил LLD, які потрібно скопіювати.| |hostids|масив|Ідентифікатори хостів, до яких потрібно скопіювати правила LLD.| ### Performing requests Once you've set up the frontend, you can use remote HTTP requests to call the API. To do that you need to send HTTP POST requests to the `api_jsonrpc.php` file located in the frontend directory. For example, if your Zabbix frontend is installed under *http://example.com/zabbix*, the HTTP request to call the `apiinfo.version` method may look like this: ```yaml POST http://example.com/zabbix/api_jsonrpc.php HTTP/1.1 Content-Type: application/json-rpc { "jsonrpc": "2.0", "method": "apiinfo.version", "id": 1, "auth": null, "params": {} } ``` The request must have the `Content-Type` header set to one of these values: `application/json-rpc`, `application/json` or `application/jsonrequest`. ### Виконання запитів Після налаштування інтерфейсу ви можете використовувати віддалені HTTP-запити для того, щоб викликати API. Для цього вам потрібно надіслати запити HTTP POST до файлу `api_jsonrpc.php`, який розташований у каталозі фронтенду. Наприклад, якщо ваш інтерфейс Zabbix налаштований на `https://example.com/zabbix`, запит HTTP для виклику методу `apiinfo.version` може виглядати так: ```yaml POST http://example.com/zabbix/api_jsonrpc.php HTTP/1.1 Content-Type: application/json-rpc { "jsonrpc": "2.0", "method": "apiinfo.version", "id": 1, "auth": null, "params": {} } ``` Запит повинен мати заголовок `Content-Type`, встановлений в одне з цих значень: `application/json-rpc`, `application/json` або `application/jsonrequest`. #### PostgreSQL If a value contains a non-ASCII character in non UTF8 encoding - this will lead to a failed SQL query (PGRES\_FATAL\_ERROR:ERROR invalid byte sequence for encoding) and data will not be stored. An appropriate warning message will be written to the *zabbix\_server.log*.\ Relevant for at least PostgreSQL version 9.1.3 #### PostgreSQL Якщо значення містить символ, відмінний від ASCII, у кодуванні, відмінному від UTF8, це призведе до помилки SQL-запиту (PGRES\_FATAL\_ERROR:ERROR недійсна послідовність байтів для кодування), і дані не будуть збережені. Відповідне попередження буде записано в *zabbix\_server.log*.\ Актуально принаймні для PostgreSQL версії 9.1.3 ### Post-migration For all databases, once the migration is completed, do the following: * Verify that everything works as expected. * Drop old tables: ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ### Після міграції Для всіх баз даних після завершення міграції виконайте такі дії: * Переконайтеся, що все працює належним чином. * Видалити старі таблиці: ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ##### Preparing frontend Make sure that Zabbix server address:port is **not defined** in the frontend configuration (found in `conf/zabbix.conf.php` of the frontend files directory). {width="600"} Zabbix frontend will autodetect the active node by reading settings from the nodes table in Zabbix database. Node address of the active node will be used as the Zabbix server address. ##### Підготовка web-інтерфейсу Переконайтеся, що в конфігураційному файлі web-інтерфейсу ( знаходиться у `conf/zabbix.conf.php` в директорії з файлами веб-інтерфейсу) **не вказано** адреса:порт Zabbix сервера. {width="600"} Web-інтерфейс Zabbix автоматично визначить активний вузол, зчитавши налаштування з таблиці вузлів у базі даних Zabbix. Адреса активного вузла буде використана як адреса Zabbix сервера. #### Property labels Some of the objects properties are marked with short labels to describe their behavior. The following labels are used: - *readonly* - the value of the property is set automatically and cannot be defined or changed by the client; - *constant* - the value of the property can be set when creating an object, but cannot be changed after. #### Мітки властивостей Деякі з властивостей об’єктів позначені короткими мітками для опису їх поведінки. Використовуються такі мітки: - *readonly* - значення властивості встановлюється автоматично і не може бути визначено або змінено клієнтом; - *constant* - значення властивості можна встановити під час створення об'єкта, але не можна змінити після. #### proxy Changes:\ [ZBXNEXT-6889](https://support.zabbix.com/browse/ZBXNEXT-6889) `proxy.create`, `proxy.update`: dropped support of `interface.interfaceid` and `interface.hostid` properties.\ #### проксі Зміни:\ [ZBXNEXT-6889](https://support.zabbix.com/browse/ZBXNEXT-6889) `proxy.create`, `proxy.update`: припинено підтримку властивостей `interface.interfaceid` і `interface.hostid`. \ ##### Proxy configuration HA cluster nodes (servers) must be listed in the configuration of either passive or active Zabbix proxy. For a passive proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **comma**. ``` Server=zabbix-node-01,zabbix-node-02 ``` For an active proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **semicolon**. ``` Server=zabbix-node-01;zabbix-node-02 ``` ##### Конфігурація проксі Вузли (сервери) кластера HA повинні бути вказані в конфігурації пасивного або активного Zabbix проксі. Для пасивного проксі імена вузлів кластеру мають бути вказані в [параметрі](/manual/appendix/config/zabbix_proxy) Server і розділені **комою**. ``` Server=zabbix-node-01,zabbix-node-02 ``` Для активного проксі імена вузлів кластеру мають бути вказані в [параметрі](/manual/appendix/config/zabbix_proxy) Server і розділені **крапкою з комою**. ``` Server=zabbix-node-01;zabbix-node-02 ``` # proxy.create # proxy.create # proxy.delete # proxy.delete # proxy.get # proxy.get # > Proxy object The following objects are directly related to the `proxy` API. # > Об'єкт проксі Наступні об'єкти безпосередньо пов'язані з API `proxy`. # proxy.update # proxy.update #### Reference This section contains basic versions of different module elements introduced in the previous sections. **manifest.json** ``` {.java} { "manifest_version": 1.0, "id": "example_module", "name": "Example module", "version": "1.0", "namespace": "Example", "author": "John Smith", "url": "http://module.example.com", "description": "Short description of the module.", "actions": { "example.something.view": { "class": "SomethingView", "view": "module.example.something.view" }, "example.something.create": { "class": "SomethingCreate", "layout": null }, "example.something.delete": { "class": "SomethingDelete", "layout": null }, "example.something.export.xml": { "class": "data_export/ExportAsXml", "layout": null }, "example.something.export.excel": { "class": "data_export/ExportAsExcel", "layout": null } }, "config": { "username": "john_smith" } } ``` **Module.php** ``` {.php} <?php declare(strict_types = 1); namespace Modules\Example; use APP; use CController as CAction; /** * Please see Core\CModule class for additional reference. */ class Module extends \Core\CModule { /** * Initialize module. */ public function init(): void { // Initialize main menu (CMenu class instance). APP::Component()->get('menu.main') ->findOrAdd(_('Reports')) ->getSubmenu() ->add((new \CMenuItem(_('Example wide report'))) ->setAction('example.report.wide.php') ) ->add((new \CMenuItem(_('Example narrow report'))) ->setAction('example.report.narrow.php') ); } /** * Event handler, triggered before executing the action. * * @param CAction $action Action instance responsible for current request. */ public function onBeforeAction(CAction $action): void { } /** * Event handler, triggered on application exit. * * @param CAction $action Action instance responsible for current request. */ public function onTerminate(CAction $action): void { } } ``` **Action controller** ``` {.php} <?php declare(strict_types = 1); namespace Modules\Example\Actions; use CControllerResponseData; use CControllerResponseFatal; use CController as CAction; /** * Example module action. */ class SomethingView extends CAction { /** * Initialize action. Method called by Zabbix core. * * @return void */ public function init(): void { /** * Disable SID (Session ID) validation. Session ID validation should only be used for actions which involve data * modification, such as update or delete actions. In such case Session ID must be presented in the URL, so that * the URL would expire as soon as the session expired. */ $this->disableSIDvalidation(); } /** * Check and sanitize user input parameters. Method called by Zabbix core. Execution stops if false is returned. * * @return bool true on success, false on error. */ protected function checkInput(): bool { $fields = [ 'name' => 'required|string', 'email' => 'required|string', 'phone' => 'string' ]; // Only validated data will further be available using $this->hasInput() and $this->getInput(). $ret = $this->validateInput($fields); if (!$ret) { $this->setResponse(new CControllerResponseFatal()); } return $ret; } /** * Check if the user has permission to execute this action. Method called by Zabbix core. * Execution stops if false is returned. * * @return bool */ protected function checkPermissions(): bool { $permit_user_types = [USER_TYPE_ZABBIX_ADMIN, USER_TYPE_SUPER_ADMIN]; return in_array($this->getUserType(), $permit_user_types); } /** * Prepare the response object for the view. Method called by Zabbix core. * * @return void */ protected function doAction(): void { $contacts = $this->getInput('email'); if ($this->hasInput('phone')) { $contacts .= ', '.$this->getInput('phone'); } $data = [ 'name' => $this->getInput('name'), 'contacts' => $contacts ]; $response = new CControllerResponseData($data); $this->setResponse($response); } } ``` **Action view** ``` {.php} <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ``` #### Довідка Цей розділ містить базові версії різних елементів модуля, представлених у попередніх розділах. **manifest.json** ``` {.java} { "manifest_version": 1.0, "id": "example_module", "name": "Приклад модуля", "version": "1.0", "namespace": "Example", "author": "Лесь Подервʼянський", "url": "http://module.example.com", "description": "Short description of the module.", "actions": { "example.something.view": { "class": "SomethingView", "view": "module.example.something.view" }, "example.something.create": { "class": "SomethingCreate", "layout": null }, "example.something.delete": { "class": "SomethingDelete", "layout": null }, "example.something.export.xml": { "class": "data_export/ExportAsXml", "layout": null }, "example.something.export.excel": { "class": "data_export/ExportAsExcel", "layout": null } }, "config": { "username": "john_smith" } } ``` **Module.php** ``` {.php} <?php declare(strict_types = 1); namespace Modules\Example; use APP; use CController as CAction; /** * Дивіться клас Core\CModule для додаткової інформації. */ class Module extends \Core\CModule { /** * Initialize module. */ public function init(): void { // Ініціалізація головного меню (екземпляр класу CMenu). APP::Component()->get('menu.main') ->findOrAdd(_('Reports')) ->getSubmenu() ->add((new \CMenuItem(_('Example wide report'))) ->setAction('example.report.wide.php') ) ->add((new \CMenuItem(_('Example narrow report'))) ->setAction('example.report.narrow.php') ); } /** * Обробник подій, що запускається перед виконанням дії. * * @param CAction $action Екземпляр дії, відповідальний за поточний запит. */ public function onBeforeAction(CAction $action): void { } /** * Обробник подій, що запускається при виході з програми. * * @param CAction $action Екземпляр дії, відповідальний за поточний запит. */ public function onTerminate(CAction $action): void { } } ``` **Action controller** ``` {.php} <?php declare(strict_types = 1); namespace Modules\Example\Actions; use CControllerResponseData; use CControllerResponseFatal; use CController як CAction; /** * Приклад action модуля. */ class SomethingView extends CAction { /** * Ініціалізація дії. Метод викликається ядром Zabbix. * * @return void */ public function init(): void { /** * Вимкнути перевірку SID (ID сеансу). Перевірку ідентифікатора сеансу слід використовувати лише для дій, які включають дані * модифікації, наприклад оновлення або видалення. У такому випадку ідентифікатор сеансу повинен бути представлений в URL-адресі, щоб * термін дії URL-адреси закінчився, щойно завершиться сесія. */ $this->disableSIDvalidation(); } /** * Перевірка та очищення вхідних параметрів користувача. Метод, що викликається ядром Zabbix. Виконання зупиняється, якщо повертається false. * * @return bool true on success, false on error. */ protected function checkInput(): bool { $fields = [ 'name' => 'required|string', 'email' => 'required|string', 'phone' => 'string' ]; // Лише підтверджені дані надалі будуть доступні за допомогою $this->hasInput() і $this->getInput(). $ret = $this->validateInput($fields); if (!$ret) { $this->setResponse(новий CControllerResponseFatal()); } return $ret; } /** * Перевірте, чи має користувач дозвіл на виконання цієї дії. Метод викликається ядром Zabbix. * Виконання зупиняється, якщо повертається false. * * @return bool */ protected function checkPermissions(): bool { $permit_user_types = [USER_TYPE_ZABBIX_ADMIN, USER_TYPE_SUPER_ADMIN]; return in_array($this->getUserType(), $permit_user_types); } /** * Підготуйте об'єкт відповіді для view. Метод викликається ядром Zabbix. * * @return void */ protected function$data doAction(): void { $contacts = $this->getInput('email'); if ($this->hasInput('phone')) { $contacts .= ', '.$this->getInput('phone'); } $data = [ 'name' => $this->getInput('name'), 'contacts' => $contacts ]; $response = new CControllerResponseData($data); $this->setResponse($response); } } ``` **Action view** ``` {.php} <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ``` #### regexp Changes:\ [ZBXNEXT-6717](https://support.zabbix.com/browse/ZBXNEXT-6717) added `regexp.get`, `regexp.create`, `regexp.update` and `regexp.delete` API.\ #### регулярний вираз Зміни:\ [ZBXNEXT-6717](https://support.zabbix.com/browse/ZBXNEXT-6717) додано API `regexp.get`, `regexp.create`, `regexp.update` і `regexp.delete`.\ # regexp.create # regexp.create # regexp.delete # regexp.delete # regexp.get # regexp.get # regexp.update # regexp.update #### Removing hosts from host groups Remove two hosts from the given host groups. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massremove", "params": { "groupids": [ "5", "6" ], "hostids": [ "30050", "30001" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Видалення хостів із груп хостів Вилучіть два хости з указаних груп хостів. Запит: ```json { "jsonrpc": "2.0", "method": "hostgroup.massremove", "params": { "groupids": [ "5", "6" ], "hostids": [ "30050", "30001" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Removing interfaces Remove the "127.0.0.1" SNMP interface from two hosts. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.massremove", "params": { "hostids": [ "30050", "30052" ], "interfaces": { "dns": "", "ip": "127.0.0.1", "port": "161" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` #### Видалення інтерфейсів Видаліть інтерфейс SNMP "127.0.0.1" з двох хостів. Запит: ```json { "jsonrpc": "2.0", "method": "hostinterface.massremove", "params": { "hostids": [ "30050", "30052" ], "interfaces": { "dns": "", "ip": "127.0.0.1", "port": "161" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` #### Renaming a dashboard Rename a dashboard to "SQL server status". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "name": "SQL server status" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### Перейменування інформаційної панелі Перейменуйте інформаційну панель на «Стан сервера SQL». Запит: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "name": "SQL server status" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### Renaming a host group Rename a host group to "Linux hosts." Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.update", "params": { "groupid": "7", "name": "Linux hosts" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "7" ] }, "id": 1 } ``` #### Перейменування групи хостів Перейменуйте групу хостів на «Linux hosts». Запит: ```json { "jsonrpc": "2.0", "method": "hostgroup.update", "params": { "groupid": "7", "name": "Linux hosts" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "7" ] }, "id": 1 } ``` #### Replace conditions, but keep the evaluation method Request: ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "filter": { "conditions": [ { "type": 3, "oldtag": "error", "newtag": "ok" } ] } }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Замінити умови, але зберегти метод оцінки Запит: ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "filter": { "conditions": [ { "type": 3, "oldtag": "error", "newtag": "ok" } ] } }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Replacing host interfaces Replace all host interfaces with a single agent interface. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.replacehostinterfaces", "params": { "hostid": "30052", "interfaces": { "dns": "", "ip": "127.0.0.1", "main": 1, "port": "10050", "type": 1, "useip": 1 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30081" ] }, "id": 1 } ``` #### Заміна інтерфейсів хоста Замініть усі інтерфейси хоста єдиним інтерфейсом агента. Запит: ```json { "jsonrpc": "2.0", "method": "hostinterface.replacehostinterfaces", "params": { "hostid": "30052", "interfaces": { "dns": "", "ip": "127.0.0.1", "main": 1, "port": "10050", "type": 1, "useip": 1 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30081" ] }, "id": 1 } ``` #### Replacing hosts and templates in a host group Replace all hosts in a host group to ones mentioned host and unlink all templates from host group. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massupdate", "params": { "groups": [ { "groupid": "6" } ], "hosts": [ { "hostid": "30050" } ], "templates": [] }, "auth": "f223adf833b2bf2ff38574a67bba6372", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "6", ] }, "id": 1 } ``` #### Заміна хостів і шаблонів у групі хостів Замініть усі хости в групі хостів на згадані хости та від’єднайте всі шаблони від групи хостів. Запит: ```json { "jsonrpc": "2.0", "method": "hostgroup.massupdate", "params": { "groups": [ { "groupid": "6" } ], "hosts": [ { "hostid": "30050" } ], "templates": [] }, "auth": "f223adf833b2bf2ff38574a67bba6372", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "6", ] }, "id": 1 } ``` # report.create # report.create # report.delete # report.delete # report.get # report.get # > Report object The following objects are directly related to the `report` API. # > Об'єкт звіту Наступні об’єкти безпосередньо пов’язані з API `report`. ### Report The filter allows to select the report based on the SLA name as well as the service name. It is also possible to limit the displayed period. {width="600"} Each column (period) displays the SLI for that period. SLIs that are in breach of the set SLO are highlighted in red. 20 periods are displayed in the report. A maximum of 100 periods can be displayed, if both the *From* date and *To* date are specified. ### Звіт Фільтр дозволяє вибрати звіт на основі назви SLA, а також назви служби. Також можна обмежити відображуваний період. {width="600"} Кожен стовпець (період) відображає SLI для цього періоду. SLI, які порушують встановлений SLO, виділені червоним кольором. У звіті відображається 20 періодів. Можна відобразити максимум 100 періодів, якщо вказано обидві дати *Від* і *До*. # report.update # report.update ### Reserved ID value "0" Reserved ID value "0" can be used to filter elements and to remove referenced objects. For example, to remove a referenced proxy from a host, proxy\_hostid should be set to 0 ("proxy\_hostid": "0") or to filter hosts monitored by server option proxyids should be set to 0 ("proxyids": "0"). ### Зарезервоване значення ідентифікатора "0" Зарезервоване значення ідентифікатора «0» можна використовувати для фільтрації елементів і видалення об’єктів, на які посилаються. Наприклад, щоб видалити проксі-сервер, на який посилається, з хоста, proxy\_hostid має бути встановлено на 0 ("proxy\_hostid": "0") або щоб фільтрувати хости, які контролюються параметром сервера, proxyids має бути встановлено на 0 ("proxyids": "0"). #### Retrieve alerts by action ID Retrieve all alerts generated by action "3". Request: ```json { "jsonrpc": "2.0", "method": "alert.get", "params": { "output": "extend", "actionids": "3" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "alertid": "1", "actionid": "3", "eventid": "21243", "userid": "1", "clock": "1362128008", "mediatypeid": "1", "sendto": "support@company.com", "subject": "PROBLEM: Zabbix agent on Linux server is unreachable for 5 minutes: ", "message": "Trigger: Zabbix agent on Linux server is unreachable for 5 minutes: \nTrigger status: PROBLEM\nTrigger severity: Not classified", "status": "0", "retries": "3", "error": "", "esc_step": "1", "alerttype": "0", "p_eventid": "0", "acknowledgeid": "0" } ], "id": 1 } ``` #### Отримувати сповіщення за ідентифікатором дії Отримати всі сповіщення, згенеровані дією «3». Запит: ```json { "jsonrpc": "2.0", "method": "alert.get", "params": { "output": "extend", "actionids": "3" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "alertid": "1", "actionid": "3", "eventid": "21243", "userid": "1", "clock": "1362128008", "mediatypeid": "1", "sendto": "support@company.com", "subject": "PROBLEM: Zabbix agent on Linux server is unreachable for 5 minutes: ", "message": "Trigger: Zabbix agent on Linux server is unreachable for 5 minutes: \nTrigger status: PROBLEM\nTrigger severity: Not classified", "status": "0", "retries": "3", "error": "", "esc_step": "1", "alerttype": "0", "p_eventid": "0", "acknowledgeid": "0" } ], "id": 1 } ``` #### Retrieve all discovery rules Retrieve all configured discovery rules and the discovery checks they use. Request: ```json { "jsonrpc": "2.0", "method": "drule.get", "params": { "output": "extend", "selectDChecks": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "druleid": "2", "proxy_hostid": "0", "name": "Local network", "iprange": "192.168.3.1-255", "delay": "5s", "nextcheck": "1348754327", "status": "0", "dchecks": [ { "dcheckid": "7", "druleid": "2", "type": "3", "key_": "", "snmp_community": "", "ports": "21", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" }, { "dcheckid": "8", "druleid": "2", "type": "4", "key_": "", "snmp_community": "", "ports": "80", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" } ] }, { "druleid": "6", "proxy_hostid": "0", "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "delay": "1h", "nextcheck": "0", "status": "0", "dchecks": [ { "dcheckid": "10", "druleid": "6", "type": "9", "key_": "system.uname", "snmp_community": "", "ports": "10050", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "2", "name_source": "3" } ] } ], "id": 1 } ``` #### Отримати всі правила виявлення Отримати всі налаштовані правила виявлення та перевірки виявлення, які вони використовують. Запит: ```json { "jsonrpc": "2.0", "method": "drule.get", "params": { "output": "extend", "selectDChecks": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "druleid": "2", "proxy_hostid": "0", "name": "Local network", "iprange": "192.168.3.1-255", "delay": "5s", "nextcheck": "1348754327", "status": "0", "dchecks": [ { "dcheckid": "7", "druleid": "2", "type": "3", "key_": "", "snmp_community": "", "ports": "21", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" }, { "dcheckid": "8", "druleid": "2", "type": "4", "key_": "", "snmp_community": "", "ports": "80", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" } ] }, { "druleid": "6", "proxy_hostid": "0", "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "delay": "1h", "nextcheck": "0", "status": "0", "dchecks": [ { "dcheckid": "10", "druleid": "6", "type": "9", "key_": "system.uname", "snmp_community": "", "ports": "10050", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "2", "name_source": "3" } ] } ], "id": 1 } ``` #### Retrieve audit log Retrieve two latest audit log records. Request: ```json { "jsonrpc": "2.0", "method": "auditlog.get", "params": { "output": "extend", "sortfield": "clock", "sortorder": "DESC", "limit": 2 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "auditid": "cksstgfam0001yhdcc41y20q2", "userid": "1", "username": "Admin", "clock": "1629975715", "ip": "127.0.0.1", "action": "1", "resourcetype": "0", "resourceid": "0", "resourcename": "Jim", "recordsetid": "cksstgfal0000yhdcso67ondl", "details": "{\"user.name\":[\"update\",\"Jim\",\"\"],\"user.medias[37]\":[\"add\"],\"user.medias[37].\":[\"add\"],\"user.medias[37].mediatypeid\":[\"add\",\"1\"],\"user.medias[37].sendto\":[\"add\",\"support123@company.com\"]}" }, { "auditid": "ckssofl0p0001yhdcqxclsg8r", "userid": "1", "username": "Admin", "clock": "1629967278", "ip": "127.0.0.1", "action": "0", "resourcetype": "0", "resourceid": "20", "resourcename": "John", "recordsetid": "ckssofl0p0000yhdcpxyo1jgo", "details": "{\"user.username\":[\"add\",\"John\"], \"user.userid:\":[\"add\",\"20\"],\"user.usrgrps[28]\":[\"add\"],\"user.usrgrps[28].usrgrpid\":[\"add\", \"7\"]}" } ], "id": 1 } ``` #### Отримати журнал аудиту Отримати два останні записи журналу аудиту. Запит: ```json { "jsonrpc": "2.0", "method": "auditlog.get", "params": { "output": "extend", "sortfield": "clock", "sortorder": "DESC", "limit": 2 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "auditid": "cksstgfam0001yhdcc41y20q2", "userid": "1", "username": "Admin", "clock": "1629975715", "ip": "127.0.0.1", "action": "1", "resourcetype": "0", "resourceid": "0", "resourcename": "Jim", "recordsetid": "cksstgfal0000yhdcso67ondl", "details": "{\"user.name\":[\"update\",\"Jim\",\"\"],\"user.medias[37]\":[\"add\"],\"user.medias[37].\":[\"add\"],\"user.medias[37].mediatypeid\":[\"add\",\"1\"],\"user.medias[37].sendto\":[\"add\",\"support123@company.com\"]}" }, { "auditid": "ckssofl0p0001yhdcqxclsg8r", "userid": "1", "username": "Admin", "clock": "1629967278", "ip": "127.0.0.1", "action": "0", "resourcetype": "0", "resourceid": "20", "resourcename": "John", "recordsetid": "ckssofl0p0000yhdcpxyo1jgo", "details": "{\"user.username\":[\"add\",\"John\"], \"user.userid:\":[\"add\",\"20\"],\"user.usrgrps[28]\":[\"add\"],\"user.usrgrps[28].usrgrpid\":[\"add\", \"7\"]}" } ], "id": 1 } ``` #### Retrieve correlations Retrieve all configured correlations together with correlation conditions and operations. The filter uses the "and/or" evaluation type, so the `formula` property is empty and `eval_formula` is generated automatically. Request: ```json { "jsonrpc": "2.0", "method": "correlation.get", "params": { "output": "extend", "selectOperations": "extend", "selectFilter": "extend" }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "correlationid": "1", "name": "Correlation 1", "description": "", "status": "0", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "type": "3", "oldtag": "error", "newtag": "ok", "formulaid": "A" } ], "eval_formula": "A" }, "operations": [ { "type": "0" } ] } ], "id": 1 } ``` #### Отримати кореляції Отримати всі налаштовані кореляції разом із умовами та операціями кореляції. Фільтр використовує тип оцінки "і/або", тому властивість `formula` порожня, а `eval_formula` генерується автоматично. Запит: ```json { "jsonrpc": "2.0", "method": "correlation.get", "params": { "output": "extend", "selectOperations": "extend", "selectFilter": "extend" }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "correlationid": "1", "name": "Correlation 1", "description": "", "status": "0", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "type": "3", "oldtag": "error", "newtag": "ok", "formulaid": "A" } ], "eval_formula": "A" }, "operations": [ { "type": "0" } ] } ], "id": 1 } ``` #### Retrieve discovered hosts by discovery rule Retrieve all hosts and the discovered services they are running that have been detected by discovery rule "4". Request: ```json { "jsonrpc": "2.0", "method": "dhost.get", "params": { "output": "extend", "selectDServices": "extend", "druleids": "4" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dservices": [ { "dserviceid": "1", "dhostid": "1", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697227", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.1", "dns": "station.company.lan" } ], "dhostid": "1", "druleid": "4", "status": "0", "lastup": "1337697227", "lastdown": "0" }, { "dservices": [ { "dserviceid": "2", "dhostid": "2", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.4", "dns": "john.company.lan" } ], "dhostid": "2", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" }, { "dservices": [ { "dserviceid": "3", "dhostid": "3", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.26", "dns": "printer.company.lan" } ], "dhostid": "3", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" }, { "dservices": [ { "dserviceid": "4", "dhostid": "4", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.7", "dns": "mail.company.lan" } ], "dhostid": "4", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" } ], "id": 1 } ``` #### Отримати виявлені хости за правилом виявлення Отримати всі хости та виявлені служби, які вони запускають, які були виявлені правилом виявлення "4". Запит: ```json { "jsonrpc": "2.0", "method": "dhost.get", "params": { "output": "extend", "selectDServices": "extend", "druleids": "4" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "dservices": [ { "dserviceid": "1", "dhostid": "1", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697227", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.1", "dns": "station.company.lan" } ], "dhostid": "1", "druleid": "4", "status": "0", "lastup": "1337697227", "lastdown": "0" }, { "dservices": [ { "dserviceid": "2", "dhostid": "2", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.4", "dns": "john.company.lan" } ], "dhostid": "2", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" }, { "dservices": [ { "dserviceid": "3", "dhostid": "3", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.26", "dns": "printer.company.lan" } ], "dhostid": "3", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" }, { "dservices": [ { "dserviceid": "4", "dhostid": "4", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.7", "dns": "mail.company.lan" } ], "dhostid": "4", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" } ], "id": 1 } ``` #### Retrieve discovery actions Retrieve all configured discovery actions together with action conditions and operations. The filter uses the "and" evaluation type, so the `formula` property is empty and `eval_formula` is generated automatically. Request: ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 1 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "2", "name": "Auto discovery. Linux servers.", "eventsource": "1", "status": "1", "esc_period": "0s", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "conditiontype": "10", "operator": "0", "value": "0", "value2": "", "formulaid": "B" }, { "conditiontype": "8", "operator": "0", "value": "9", "value2": "", "formulaid": "C" }, { "conditiontype": "12", "operator": "2", "value": "Linux", "value2": "", "formulaid": "A" } ], "eval_formula": "A and B and C" }, "operations": [ { "operationid": "1", "actionid": "2", "operationtype": "6", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "optemplate": [ { "templateid": "10001" } ] }, { "operationid": "2", "actionid": "2", "operationtype": "4", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opgroup": [ { "groupid": "2" } ] } ] } ], "id": 1 } ``` #### Отримати дії виявлення Отримати всі налаштовані дії виявлення разом із умовами дій та операціями. Фільтр використовує тип оцінки "and", тому властивість `formula` порожня, а `eval_formula` генерується автоматично. Запит: ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 1 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "2", "name": "Auto discovery. Linux servers.", "eventsource": "1", "status": "1", "esc_period": "0s", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "conditiontype": "10", "operator": "0", "value": "0", "value2": "", "formulaid": "B" }, { "conditiontype": "8", "operator": "0", "value": "9", "value2": "", "formulaid": "C" }, { "conditiontype": "12", "operator": "2", "value": "Linux", "value2": "", "formulaid": "A" } ], "eval_formula": "A and B and C" }, "operations": [ { "operationid": "1", "actionid": "2", "operationtype": "6", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "optemplate": [ { "templateid": "10001" } ] }, { "operationid": "2", "actionid": "2", "operationtype": "4", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opgroup": [ { "groupid": "2" } ] } ] } ], "id": 1 } ``` #### Retrieve discovery checks for a discovery rule Retrieve all discovery checks used by discovery rule "6". Request: ```json { "jsonrpc": "2.0", "method": "dcheck.get", "params": { "output": "extend", "dcheckids": "6" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dcheckid": "6", "druleid": "4", "type": "3", "key_": "", "snmp_community": "", "ports": "21", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" } ], "id": 1 } ``` #### Отримати перевірки виявлення для правила виявлення Отримати всі перевірки виявлення, які використовуються правилом відкриття "6". Запит: ```json { "jsonrpc": "2.0", "method": "dcheck.get", "params": { "output": "extend", "dcheckids": "6" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "dcheckid": "6", "druleid": "4", "type": "3", "key_": "", "snmp_community": "", "ports": "21", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" } ], "id": 1 } ``` #### Retrieve LLD rule by URL Retrieve LLD rule for host by rule URL field value. Only exact match of URL string defined for LLD rule is supported. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "hostids": "10257", "filter": { "type": 19, "url": "http://127.0.0.1/discoverer.php" } }, "id": 39, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28336", "type": "19", "snmp_oid": "", "hostid": "10257", "name": "API HTTP agent", "key_": "api_discovery_rule", "delay": "5s", "status": "0", "trapper_hosts": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "5", "description": "", "lifetime": "30d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "http://127.0.0.1/discoverer.php", "query_fields": [ { "mode": "json" }, { "elements": "2" } ], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": { "X-Type": "api", "Authorization": "Bearer mF_A.B5f-2.1JcM" }, "retrieve_mode": "0", "request_method": "1", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] } ], "id": 39 } ``` #### Отримати правило LLD за URL-адресою Отримати правило LLD для хоста за значенням поля URL-адреси правила. Підтримується лише точний збіг рядка URL-адреси, визначеного для правила LLD. Запит: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "hostids": "10257", "filter": { "type": 19, "url": "http://127.0.0.1/discoverer.php" } }, "id": 39, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28336", "type": "19", "snmp_oid": "", "hostid": "10257", "name": "API HTTP agent", "key_": "api_discovery_rule", "delay": "5s", "status": "0", "trapper_hosts": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "5", "description": "", "lifetime": "30d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "http://127.0.0.1/discoverer.php", "query_fields": [ { "mode": "json" }, { "elements": "2" } ], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": { "X-Type": "api", "Authorization": "Bearer mF_A.B5f-2.1JcM" }, "retrieve_mode": "0", "request_method": "1", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] } ], "id": 39 } ``` #### Retrieve LLD rule with overrides Retrieve one LLD rule that has various override settings. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": ["name"], "itemids": "30980", "selectOverrides": ["name", "step", "stop", "filter", "operations"] }, "id": 39, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "name": "Discover database host", "overrides": [ { "name": "Discover MySQL host", "step": "1", "stop": "1", "filter": { "evaltype": "2", "formula": "", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mysqld\\.service$", "formulaid": "A" }, { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mariadb\\.service$", "formulaid": "B" } ], "eval_formula": "A or B" }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optag": [ { "tag": "Database", "value": "MySQL" } ], "optemplate": [ { "templateid": "10170" } ] } ] }, { "name": "Discover PostgreSQL host", "step": "2", "stop": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^postgresql\\.service$", "formulaid": "A" } ], "eval_formula": "A" }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optag": [ { "tag": "Database", "value": "PostgreSQL" } ], "optemplate": [ { "templateid": "10263" } ] } ] } ] } ], "id": 39 } ``` #### Отримати правило LLD із перевизначеннями Отримайте одне правило LLD, яке має різні налаштування заміни. Запит: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": ["name"], "itemids": "30980", "selectOverrides": ["name", "step", "stop", "filter", "operations"] }, "id": 39, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "name": "Discover database host", "overrides": [ { "name": "Discover MySQL host", "step": "1", "stop": "1", "filter": { "evaltype": "2", "formula": "", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mysqld\\.service$", "formulaid": "A" }, { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mariadb\\.service$", "formulaid": "B" } ], "eval_formula": "A or B" }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optag": [ { "tag": "Database", "value": "MySQL" } ], "optemplate": [ { "templateid": "10170" } ] } ] }, { "name": "Discover PostgreSQL host", "step": "2", "stop": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^postgresql\\.service$", "formulaid": "A" } ], "eval_formula": "A" }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optag": [ { "tag": "Database", "value": "PostgreSQL" } ], "optemplate": [ { "templateid": "10263" } ] } ] } ] } ], "id": 39 } ``` #### Retrieve services discovered on a host Retrieve all discovered services detected on discovered host "11". Request: ```json { "jsonrpc": "2.0", "method": "dservice.get", "params": { "output": "extend", "dhostids": "11" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dserviceid": "12", "dhostid": "11", "value": "", "port": "80", "status": "1", "lastup": "0", "lastdown": "1348650607", "dcheckid": "5", "ip": "192.168.1.134", "dns": "john.local" }, { "dserviceid": "13", "dhostid": "11", "value": "", "port": "21", "status": "1", "lastup": "0", "lastdown": "1348650610", "dcheckid": "6", "ip": "192.168.1.134", "dns": "john.local" } ], "id": 1 } ``` #### Отримати служби, виявлені на хості Отримати всі виявлені служби, виявлені на виявленому хості "11". Запит: ```json { "jsonrpc": "2.0", "method": "dservice.get", "params": { "output": "extend", "dhostids": "11" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "dserviceid": "12", "dhostid": "11", "value": "", "port": "80", "status": "1", "lastup": "0", "lastdown": "1348650607", "dcheckid": "5", "ip": "192.168.1.134", "dns": "john.local" }, { "dserviceid": "13", "dhostid": "11", "value": "", "port": "21", "status": "1", "lastup": "0", "lastdown": "1348650610", "dcheckid": "6", "ip": "192.168.1.134", "dns": "john.local" } ], "id": 1 } ``` #### Retrieve trigger actions Retrieve all configured trigger actions together with action conditions and operations. Request: ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectRecoveryOperations": "extend", "selectUpdateOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 0 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "3", "name": "Report problems to Zabbix administrators", "eventsource": "0", "status": "1", "esc_period": "1h", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [], "eval_formula": "" }, "operations": [ { "operationid": "3", "actionid": "3", "operationtype": "0", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opmessage": [ { "default_msg": "1", "subject": "", "message": "", "mediatypeid" => "0" } ], "opmessage_grp": [ { "usrgrpid": "7" } ] } ], "recovery_operations": [ { "operationid": "7", "actionid": "3", "operationtype": "11", "evaltype": "0", "opconditions": [], "opmessage": { "default_msg": "0", "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}", "message": "Trigger: {TRIGGER.NAME}\r\nTrigger status: {TRIGGER.STATUS}\r\nTrigger severity: {TRIGGER.SEVERITY}\r\nTrigger URL: {TRIGGER.URL}\r\n\r\nItem values:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n\r\nOriginal event ID: {EVENT.ID}", "mediatypeid": "0" } } ], "update_operations": [ { "operationid": "31", "operationtype": "12", "evaltype": "0", "opmessage": { "default_msg": "1", "subject": "", "message": "", "mediatypeid": "0" } }, { "operationid": "32", "operationtype": "0", "evaltype": "0", "opmessage": { "default_msg": "0", "subject": "Updated: {TRIGGER.NAME}", "message": "{USER.FULLNAME} updated problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} with the following message:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nCurrent problem status is {EVENT.STATUS}", "mediatypeid": "1" }, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage_usr": [] }, { "operationid": "33", "operationtype": "1", "evaltype": "0", "opcommand": { "scriptid": "3" }, "opcommand_hst": [ { "hostid": "10084" } ], "opcommand_grp": [] } ] } ], "id": 1 } ``` #### Отримати тригерні дії Отримати всі налаштовані тригерні дії разом із умовами дії та операціями. Запит: ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectRecoveryOperations": "extend", "selectUpdateOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 0 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "3", "name": "Report problems to Zabbix administrators", "eventsource": "0", "status": "1", "esc_period": "1h", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [], "eval_formula": "" }, "operations": [ { "operationid": "3", "actionid": "3", "operationtype": "0", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opmessage": [ { "default_msg": "1", "subject": "", "message": "", "mediatypeid" => "0" } ], "opmessage_grp": [ { "usrgrpid": "7" } ] } ], "recovery_operations": [ { "operationid": "7", "actionid": "3", "operationtype": "11", "evaltype": "0", "opconditions": [], "opmessage": { "default_msg": "0", "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}", "message": "Trigger: {TRIGGER.NAME}\r\nTrigger status: {TRIGGER.STATUS}\r\nTrigger severity: {TRIGGER.SEVERITY}\r\nTrigger URL: {TRIGGER.URL}\r\n\r\nItem values:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n\r\nOriginal event ID: {EVENT.ID}", "mediatypeid": "0" } } ], "update_operations": [ { "operationid": "31", "operationtype": "12", "evaltype": "0", "opmessage": { "default_msg": "1", "subject": "", "message": "", "mediatypeid": "0" } }, { "operationid": "32", "operationtype": "0", "evaltype": "0", "opmessage": { "default_msg": "0", "subject": "Updated: {TRIGGER.NAME}", "message": "{USER.FULLNAME} updated problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} with the following message:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nCurrent problem status is {EVENT.STATUS}", "mediatypeid": "1" }, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage_usr": [] }, { "operationid": "33", "operationtype": "1", "evaltype": "0", "opcommand": { "scriptid": "3" }, "opcommand_hst": [ { "hostid": "10084" } ], "opcommand_grp": [] } ] } ], "id": 1 } ``` #### Retrieving a dashboard by ID Retrieve all data about dashboards "1" and "2". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.get", "params": { "output": "extend", "selectPages": "extend", "selectUsers": "extend", "selectUserGroups": "extend", "dashboardids": [ "1", "2" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dashboardid": "1", "name": "Dashboard", "userid": "1", "private": "0", "display_period": "30", "auto_start": "1", "users": [], "userGroups": [], "pages": [ { "dashboard_pageid": "1", "name": "", "display_period": "0", "widgets": [ { "widgetid": "9", "type": "systeminfo", "name": "", "x": "12", "y": "8", "width": "12", "height": "5", "view_mode": "0", "fields": [] }, { "widgetid": "8", "type": "problemsbysv", "name": "", "x": "12", "y": "4", "width": "12", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "7", "type": "problemhosts", "name": "", "x": "12", "y": "0", "width": "12", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "6", "type": "discovery", "name": "", "x": "6", "y": "9", "width": "6", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "5", "type": "web", "name": "", "x": "0", "y": "9", "width": "6", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "4", "type": "problems", "name": "", "x": "0", "y": "3", "width": "12", "height": "6", "view_mode": "0", "fields": [] }, { "widgetid": "3", "type": "favmaps", "name": "", "x": "8", "y": "0", "width": "4", "height": "3", "view_mode": "0", "fields": [] }, { "widgetid": "1", "type": "favgraphs", "name": "", "x": "0", "y": "0", "width": "4", "height": "3", "view_mode": "0", "fields": [] } ] }, { "dashboard_pageid": "2", "name": "", "display_period": "0", "widgets": [] }, { "dashboard_pageid": "3", "name": "Custom page name", "display_period": "60", "widgets": [] } ] }, { "dashboardid": "2", "name": "My dashboard", "userid": "1", "private": "1", "display_period": "60", "auto_start": "1", "users": [ { "userid": "4", "permission": "3" } ], "userGroups": [ { "usrgrpid": "7", "permission": "2" } ], "pages": [ { "dashboard_pageid": "4", "name": "", "display_period": "0", "widgets": [ { "widgetid": "10", "type": "problems", "name": "", "x": "0", "y": "0", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": "2", "name": "groupids", "value": "4" } ] } ] } ] } ], "id": 1 } ``` #### Отримання інформаційної панелі за ідентифікатором Отримати всі дані про інформаційні панелі «1» і «2». Запит: ```json { "jsonrpc": "2.0", "method": "dashboard.get", "params": { "output": "extend", "selectPages": "extend", "selectUsers": "extend", "selectUserGroups": "extend", "dashboardids": [ "1", "2" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "dashboardid": "1", "name": "Dashboard", "userid": "1", "private": "0", "display_period": "30", "auto_start": "1", "users": [], "userGroups": [], "pages": [ { "dashboard_pageid": "1", "name": "", "display_period": "0", "widgets": [ { "widgetid": "9", "type": "systeminfo", "name": "", "x": "12", "y": "8", "width": "12", "height": "5", "view_mode": "0", "fields": [] }, { "widgetid": "8", "type": "problemsbysv", "name": "", "x": "12", "y": "4", "width": "12", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "7", "type": "problemhosts", "name": "", "x": "12", "y": "0", "width": "12", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "6", "type": "discovery", "name": "", "x": "6", "y": "9", "width": "6", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "5", "type": "web", "name": "", "x": "0", "y": "9", "width": "6", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "4", "type": "problems", "name": "", "x": "0", "y": "3", "width": "12", "height": "6", "view_mode": "0", "fields": [] }, { "widgetid": "3", "type": "favmaps", "name": "", "x": "8", "y": "0", "width": "4", "height": "3", "view_mode": "0", "fields": [] }, { "widgetid": "1", "type": "favgraphs", "name": "", "x": "0", "y": "0", "width": "4", "height": "3", "view_mode": "0", "fields": [] } ] }, { "dashboard_pageid": "2", "name": "", "display_period": "0", "widgets": [] }, { "dashboard_pageid": "3", "name": "Custom page name", "display_period": "60", "widgets": [] } ] }, { "dashboardid": "2", "name": "My dashboard", "userid": "1", "private": "1", "display_period": "60", "auto_start": "1", "users": [ { "userid": "4", "permission": "3" } ], "userGroups": [ { "usrgrpid": "7", "permission": "2" } ], "pages": [ { "dashboard_pageid": "4", "name": "", "display_period": "0", "widgets": [ { "widgetid": "10", "type": "problems", "name": "", "x": "0", "y": "0", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": "2", "name": "groupids", "value": "4" } ] } ] } ] } ], "id": 1 } ``` #### Retrieving data by name Retrieve all data about two host groups named "Zabbix servers" and "Linux servers". Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.get", "params": { "output": "extend", "filter": { "name": [ "Zabbix servers", "Linux servers" ] } }, "auth": "6f38cddc44cfbb6c1bd186f9a220b5a0", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "groupid": "2", "name": "Linux servers", "internal": "0" }, { "groupid": "4", "name": "Zabbix servers", "internal": "0" } ], "id": 1 } ``` #### Отримання даних за іменем Отримати всі дані про дві групи хостів під назвою «Zabbix servers» і «Linux servers». Запит: ```json { "jsonrpc": "2.0", "method": "hostgroup.get", "params": { "output": "extend", "filter": { "name": [ "Zabbix servers", "Linux servers" ] } }, "auth": "6f38cddc44cfbb6c1bd186f9a220b5a0", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "groupid": "2", "name": "Linux servers", "internal": "0" }, { "groupid": "4", "name": "Zabbix servers", "internal": "0" } ], "id": 1 } ``` #### Retrieving data by name Retrieve all data about two hosts named "Zabbix server" and "Linux server". Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "filter": { "host": [ "Zabbix server", "Linux server" ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10160", "proxy_hostid": "0", "host": "Zabbix server", "status": "0", "lastaccess": "0", "ipmi_authtype": "-1", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "name": "Zabbix server", "flags": "0", "description": "The Zabbix monitoring server.", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "inventory_mode": "1" }, { "hostid": "10167", "proxy_hostid": "0", "host": "Linux server", "status": "0", "lastaccess": "0", "ipmi_authtype": "-1", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "name": "Linux server", "flags": "0", "description": "", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "inventory_mode": "1" } ], "id": 1 } ``` #### Отримання даних за іменем Отримати всі дані про два хости під назвами «сервер Zabbix» і «сервер Linux». Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "filter": { "host": [ "Zabbix server", "Linux server" ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10160", "proxy_hostid": "0", "host": "Zabbix server", "status": "0", "lastaccess": "0", "ipmi_authtype": "-1", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "name": "Zabbix server", "flags": "0", "description": "The Zabbix monitoring server.", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "inventory_mode": "1" }, { "hostid": "10167", "proxy_hostid": "0", "host": "Linux server", "status": "0", "lastaccess": "0", "ipmi_authtype": "-1", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "name": "Linux server", "flags": "0", "description": "", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "inventory_mode": "1" } ], "id": 1 } ``` #### Retrieving discovery rules from a host Retrieve all discovery rules for specific host ID. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": "extend", "hostids": "10202" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "27425", "type": "0", "snmp_oid": "", "hostid": "10202", "name": "Network interface discovery", "key_": "net.if.discovery", "delay": "1h", "status": "0", "trapper_hosts": "", "templateid": "22444", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "119", "description": "Discovery of network interfaces as defined in global regular expression \"Network interfaces for discovery\".", "lifetime": "30d", "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", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] }, { "itemid": "27426", "type": "0", "snmp_oid": "", "hostid": "10202", "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "delay": "1h", "status": "0", "trapper_hosts": "", "templateid": "22450", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "119", "description": "Discovery of file systems of different types as defined in global regular expression \"File systems for discovery\".", "lifetime": "30d", "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", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] } ], "id": 1 } ``` #### Отримання правил виявлення з хосту Отримати всі правила виявлення для певного ідентифікатора хоста. Запит: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": "extend", "hostids": "10202" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "27425", "type": "0", "snmp_oid": "", "hostid": "10202", "name": "Network interface discovery", "key_": "net.if.discovery", "delay": "1h", "status": "0", "trapper_hosts": "", "templateid": "22444", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "119", "description": "Discovery of network interfaces as defined in global regular expression \"Network interfaces for discovery\".", "lifetime": "30d", "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", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] }, { "itemid": "27426", "type": "0", "snmp_oid": "", "hostid": "10202", "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "delay": "1h", "status": "0", "trapper_hosts": "", "templateid": "22450", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "119", "description": "Discovery of file systems of different types as defined in global regular expression \"File systems for discovery\".", "lifetime": "30d", "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", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] } ], "id": 1 } ``` #### Retrieving filter conditions Retrieve the name of the LLD rule "24681" and its filter conditions. The filter uses the "and" evaluation type, so the `formula` property is empty and `eval_formula` is generated automatically. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": ["name"], "selectFilter": "extend", "itemids": ["24681"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "24681", "name": "Filtered LLD rule", "filter": { "evaltype": "1", "formula": "", "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1", "operator": "8", "formulaid": "A" }, { "macro": "{#MACRO2}", "value": "@regex2", "operator": "9", "formulaid": "B" }, { "macro": "{#MACRO3}", "value": "", "operator": "12", "formulaid": "C" }, { "macro": "{#MACRO4}", "value": "", "operator": "13", "formulaid": "D" } ], "eval_formula": "A and B and C and D" } } ], "id": 1 } ``` #### Отримання умов фільтра Отримайте ім’я правила LLD «24681» та його умови фільтрації. Фільтр використовує тип оцінки "and", тому властивість `formula` порожня, а `eval_formula` генерується автоматично. Запит: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": ["name"], "selectFilter": "extend", "itemids": ["24681"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "24681", "name": "Filtered LLD rule", "filter": { "evaltype": "1", "formula": "", "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1", "operator": "8", "formulaid": "A" }, { "macro": "{#MACRO2}", "value": "@regex2", "operator": "9", "formulaid": "B" }, { "macro": "{#MACRO3}", "value": "", "operator": "12", "formulaid": "C" }, { "macro": "{#MACRO4}", "value": "", "operator": "13", "formulaid": "D" } ], "eval_formula": "A and B and C and D" } } ], "id": 1 } ``` #### Retrieving graphs from hosts Retrieve all graphs from host "10107" and sort them by name. Request: ```json { "jsonrpc": "2.0", "method": "graph.get", "params": { "output": "extend", "hostids": 10107, "sortfield": "name" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "graphid": "612", "name": "CPU jumps", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "439", "show_work_period": "1", "show_triggers": "1", "graphtype": "0", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "0", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "613", "name": "CPU load", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "433", "show_work_period": "1", "show_triggers": "1", "graphtype": "0", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "1", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "614", "name": "CPU utilization", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "387", "show_work_period": "1", "show_triggers": "0", "graphtype": "1", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "1", "ymax_type": "1", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "645", "name": "Disk space usage /", "width": "600", "height": "340", "yaxismin": "0", "yaxismax": "0", "templateid": "0", "show_work_period": "0", "show_triggers": "0", "graphtype": "2", "show_legend": "1", "show_3d": "1", "percent_left": "0", "percent_right": "0", "ymin_type": "0", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "4" } ], "id": 1 } ``` #### Отримання графіків із хостів Отримайте всі графіки з хосту "10107" і відсортуйте їх за назвою. Запит: ```json { "jsonrpc": "2.0", "method": "graph.get", "params": { "output": "extend", "hostids": 10107, "sortfield": "name" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "graphid": "612", "name": "CPU jumps", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "439", "show_work_period": "1", "show_triggers": "1", "graphtype": "0", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "0", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "613", "name": "CPU load", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "433", "show_work_period": "1", "show_triggers": "1", "graphtype": "0", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "1", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "614", "name": "CPU utilization", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "387", "show_work_period": "1", "show_triggers": "0", "graphtype": "1", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "1", "ymax_type": "1", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "645", "name": "Disk space usage /", "width": "600", "height": "340", "yaxismin": "0", "yaxismax": "0", "templateid": "0", "show_work_period": "0", "show_triggers": "0", "graphtype": "2", "show_legend": "1", "show_3d": "1", "percent_left": "0", "percent_right": "0", "ymin_type": "0", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "4" } ], "id": 1 } ``` #### Retrieving host groups Retrieve names of the groups host "Zabbix server" is member of, but no host details themselves. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectGroups": "extend", "filter": { "host": [ "Zabbix server" ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10085", "groups": [ { "groupid": "2", "name": "Linux servers", "internal": "0", "flags": "0" }, { "groupid": "4", "name": "Zabbix servers", "internal": "0", "flags": "0" } ] } ], "id": 2 } ``` #### Отримання груп вузлів Отримати імена груп, учасником яких є «Zabbix server», але без даних про сам хост. Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectGroups": "extend", "filter": { "host": [ "Zabbix server" ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10085", "groups": [ { "groupid": "2", "name": "Linux servers", "internal": "0", "flags": "0" }, { "groupid": "4", "name": "Zabbix servers", "internal": "0", "flags": "0" } ] } ], "id": 2 } ``` #### Retrieving hosts We now have a valid user authentication token that can be used to access the data in Zabbix. For example, let's use the [host.get](/manual/api/reference/host/get) method to retrieve the IDs, host names and interfaces of all configured [hosts](/manual/api/reference/host/object): ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": [ "hostid", "host" ], "selectInterfaces": [ "interfaceid", "ip" ] }, "id": 2, "auth": "0424bd59b807674191e7d77572075f33" } ``` ::: noteimportant Note that the `auth` property is now set to the authentication token we've obtained by calling `user.login`. ::: The response object will contain the requested data about the hosts: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "host": "Zabbix server", "interfaces": [ { "interfaceid": "1", "ip": "127.0.0.1" } ] } ], "id": 2 } ``` ::: notetip For performance reasons we recommend to always list the object properties you want to retrieve and avoid retrieving everything. ::: #### Отримання хостів Тепер у вас є дійсний токен автентифікації користувача, який можна використовувати для доступу до даних у Zabbix. Наприклад, ви можете використовувати метод[host.get](/manual/api/reference/host/get) для отримання ідентифікаторів, імен хостів та інтерфейсів всіх налаштованих[хостів](/manual/api/reference/host/object): ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": [ "hostid", "host" ], "selectInterfaces": [ "interfaceid", "ip" ] }, "id": 2, "auth": "0424bd59b807674191e7d77572075f33" } ``` ::: noteimportant Зверніть увагу, що властивість `auth` тепер має значення токену автентифікації, який ми отримали за допомогою виклику `user.login`. ::: Об'єкт відповіді буде містити запитувані дані про хости: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "host": "Zabbix server", "interfaces": [ { "interfaceid": "1", "ip": "127.0.0.1" } ] } ], "id": 2 } ``` ::: notetip З міркувань продуктивності завжди рекомендується перераховувати конкретні властивості об’єкта, які потрібно отримати. Таким чином, ви уникнете отримання одразу всіх властивостей. ::: #### Retrieving item history data Return 10 latest values received from a numeric(float) item. Request: ```json { "jsonrpc": "2.0", "method": "history.get", "params": { "output": "extend", "history": 0, "itemids": "23296", "sortfield": "clock", "sortorder": "DESC", "limit": 10 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "23296", "clock": "1351090996", "value": "0.085", "ns": "563157632" }, { "itemid": "23296", "clock": "1351090936", "value": "0.16", "ns": "549216402" }, { "itemid": "23296", "clock": "1351090876", "value": "0.18", "ns": "537418114" }, { "itemid": "23296", "clock": "1351090816", "value": "0.21", "ns": "522659528" }, { "itemid": "23296", "clock": "1351090756", "value": "0.215", "ns": "507809457" }, { "itemid": "23296", "clock": "1351090696", "value": "0.255", "ns": "495509699" }, { "itemid": "23296", "clock": "1351090636", "value": "0.36", "ns": "477708209" }, { "itemid": "23296", "clock": "1351090576", "value": "0.375", "ns": "463251343" }, { "itemid": "23296", "clock": "1351090516", "value": "0.315", "ns": "447947017" }, { "itemid": "23296", "clock": "1351090456", "value": "0.275", "ns": "435307141" } ], "id": 1 } ``` #### Отримання даних історії елементів Повертає 10 останніх значень, отриманих від числового елемента (float). Запит: ```json { "jsonrpc": "2.0", "method": "history.get", "params": { "output": "extend", "history": 0, "itemids": "23296", "sortfield": "clock", "sortorder": "DESC", "limit": 10 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "23296", "clock": "1351090996", "value": "0.085", "ns": "563157632" }, { "itemid": "23296", "clock": "1351090936", "value": "0.16", "ns": "549216402" }, { "itemid": "23296", "clock": "1351090876", "value": "0.18", "ns": "537418114" }, { "itemid": "23296", "clock": "1351090816", "value": "0.21", "ns": "522659528" }, { "itemid": "23296", "clock": "1351090756", "value": "0.215", "ns": "507809457" }, { "itemid": "23296", "clock": "1351090696", "value": "0.255", "ns": "495509699" }, { "itemid": "23296", "clock": "1351090636", "value": "0.36", "ns": "477708209" }, { "itemid": "23296", "clock": "1351090576", "value": "0.375", "ns": "463251343" }, { "itemid": "23296", "clock": "1351090516", "value": "0.315", "ns": "447947017" }, { "itemid": "23296", "clock": "1351090456", "value": "0.275", "ns": "435307141" } ], "id": 1 } ``` #### Retrieving linked templates Retrieve the IDs and names of templates linked to host "10084". Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectParentTemplates": [ "templateid", "name" ], "hostids": "10084" }, "id": 1, "auth": "70785d2b494a7302309b48afcdb3a401" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "parentTemplates": [ { "name": "Linux", "templateid": "10001" }, { "name": "Zabbix Server", "templateid": "10047" } ] } ], "id": 1 } ``` #### Отримання зв'язаних шаблонів Отримайте ідентифікатори та назви шаблонів, пов’язаних із хостом «10084». Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectParentTemplates": [ "templateid", "name" ], "hostids": "10084" }, "id": 1, "auth": "70785d2b494a7302309b48afcdb3a401" } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "parentTemplates": [ { "name": "Linux", "templateid": "10001" }, { "name": "Zabbix Server", "templateid": "10047" } ] } ], "id": 1 } ``` #### Retrieving the version of the API Retrieve the version of the Zabbix API. Request: ```json { "jsonrpc": "2.0", "method": "apiinfo.version", "params": [], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "4.0.0", "id": 1 } ``` #### Отримання версії API Отримайте версію Zabbix API. запит: ```json { "jsonrpc": "2.0", "method": "apiinfo.version", "params": [], "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": "4.0.0", "id": 1 } ``` ### Return values `(array)` Returns an array with changes in configuration, that will be made. ### Повернуті значення `(array)` Повертає масив зі змінами в конфігурації, які будуть внесені. ### Return values `(array)` Returns array with the names of updated parameters. ### Повернуті значення `(array)` Повертає масив із назвами оновлених параметрів. ### Return values `(array)` Returns array with the names of updated parameters. ### Повернуті значення `(array)` Повертає масив із назвами оновлених параметрів. ### Return values `(boolean )` Returns boolean true as result on successful update. ### Повернуті значення `(boolean )` Повертає логічне значення true як результат успішного оновлення. ### Return values `(boolean)` Returns `true` if importing has been successful. ### Повернуті значення `(boolean)` Повертає `true`, якщо імпортування було успішним. ### Return values `(boolean)` Returns `true` if the copying was successful. ### Повернуті значення `(boolean)` Повертає `true`, якщо копіювання було успішним. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори очищених елементів у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the created actions under the `actionids` property. The order of the returned IDs matches the order of the passed actions. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених дій у властивості `actionids`. Порядок повернених ідентифікаторів відповідає порядку виконаних дій. ### Return values `(object)` Returns an object containing the IDs of the created correlations under the `correlationids` property. The order of the returned IDs matches the order of the passed correlations. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених кореляцій у властивості `correlationids`. Порядок повернених ідентифікаторів відповідає порядку переданих кореляцій. ### Return values `(object)` Returns an object containing the IDs of the created dashboards under the `dashboardids` property. The order of the returned IDs matches the order of the passed dashboards. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інформаційних панелей у властивості `dashboardids`. Порядок повернених ідентифікаторів відповідає порядку переданих інформаційних панелей. ### Return values `(object)` Returns an object containing the IDs of the created discovery rules under the `druleids` property. The order of the returned IDs matches the order of the passed discovery rules. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених правил виявлення у властивості `druleids`. Порядок повернених ідентифікаторів відповідає порядку переданих правил виявлення. ### Return values `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених прототипів графів у властивості `graphids`. Порядок повернених ідентифікаторів відповідає порядку переданих прототипів графів. ### Return values `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених графіків у властивості `graphids`. Порядок повернених ідентифікаторів відповідає порядку переданих графіків. ### Return values `(object)` Returns an object containing the IDs of the created host groups under the `groupids` property. The order of the returned IDs matches the order of the passed host groups. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених груп хостів у властивості `groupids`. Порядок повернених ідентифікаторів відповідає порядку переданих груп хостів. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених хост-інтерфейсів у властивості `interfaceids`. Порядок повернених ідентифікаторів відповідає порядку переданих інтерфейсів хоста. ### Return values `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених прототипів хостів у властивості `hostids`. Порядок повернутих ідентифікаторів відповідає порядку переданих прототипів хосту. ### Return values `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених хостів у властивості `hostids`. Порядок повернених ідентифікаторів відповідає порядку переданих хостів. ### Return values `(object)` Returns an object containing the IDs of the created LLD rules under the `itemids` property. The order of the returned IDs matches the order of the passed LLD rules. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених правил LLD у властивості `itemids`. Порядок повернених ідентифікаторів відповідає порядку переданих правил LLD. ### Return values `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених веб-сценаріїв у властивості `httptestids`. Порядок повернених ідентифікаторів відповідає порядку переданих веб-сценаріїв. ### Return values `(object)` Returns an object containing the IDs of the deleted actions under the `actionids` property. ### Повернуті значення `(object)` повертає об’єкт, що містить ідентифікатори видалених дій у властивості `actionids`. ### Return values `(object)` Returns an object containing the IDs of the deleted correlations under the `correlationids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених кореляцій у властивості `correlationids`. ### Return values `(object)` Returns an object containing the IDs of the deleted dashboards under the `dashboardids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інформаційних панелей у властивості `dashboardids`. ### Return values `(object)` Returns an object containing the IDs of the deleted discovery rules under the `druleids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених правил виявлення у властивості `druleids`. ### Return values `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених прототипів графів у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених графіків у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the deleted icon maps under the `iconmapids` property. ### Повернені значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених карт значків відповідно до властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the deleted items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених елементів даних у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the deleted LLD rules under the `ruleids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених правил LLD у властивості `ruleids`. ### Return values `(object)` Returns an object containing the IDs of the updated actions under the `actionids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених дій у властивості `actionids`. ### Return values `(object)` Returns an object containing the IDs of the updated correlations under the `correlationids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених кореляцій у властивості `correlationids`. ### Return values `(object)` Returns an object containing the IDs of the updated dashboards under the `dashboardids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених інформаційних панелей у властивості `dashboardids`. ### Return values `(object)` Returns an object containing the IDs of the updated discovery rules under the `druleids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених правил виявлення у властивості `druleids`. ### Return values `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених подій у властивості `eventids`. ### Return values `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених прототипів графів у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених графіків у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених елементів даних у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the updated LLD rules under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених правил LLD у властивості `itemids`. ### Return values `(object)` Returns authentication object. ### Повернуті значення `(object)` Повертає об'єкт автентифікації. ### Return values `(object)` Returns autoregistration object. ### Повернуті значення `(object)` Повертає об'єкт автореєстрації. ### Return values `(object)` Returns housekeeping object. ### Повернуті значення `(object)` Повертає об'єкт господарювання. ### Return values `(string)` Returns a serialized string containing the requested configuration data. ### Повернуті значення `(string)` Повертає серіалізований рядок, що містить запитувані дані конфігурації. ### Return values `(string)` Returns the version of the Zabbix API. ::: notetip Starting from Zabbix 2.0.4 the version of the API matches the version of Zabbix. ::: ### Повернуті значення `(string)` Повертає версію Zabbix API. ::: notetip Починаючи з Zabbix 2.0.4 версія API відповідає версії Zabbix. ::: #### role Changes:\ [ZBXNEXT-6787](https://support.zabbix.com/browse/ZBXNEXT-6787) added support of new properties `services.read.mode`, `services.read.list`, `services.read.tag`, `services.write.mode`, `services.write.list` and `services.write.tag`.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) added support of value `manage_services` for `name` property in `action` object.\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) added support of value `manage_sla` for `name` property in `action` object.\ #### роль Зміни:\ [ZBXNEXT-6787](https://support.zabbix.com/browse/ZBXNEXT-6787) додано підтримку нових властивостей `services.read.mode`, `services.read.list`, `services.read.tag` , `services.write.mode`, `services.write.list` і `services.write.tag`.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) додано підтримку значення `manage_services` для властивості `name` в об’єкті `action`.\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) додано підтримку значення `manage_sla` для властивості `name` в об’єкті `action`.\ #### role Changes:\ [ZBXNEXT-6787](https://support.zabbix.com/browse/ZBXNEXT-6787) dropped support of value `manage_services` for `name` property in `action` object.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) dropped support of value `configuration.services` for `name` property in UI object.\ #### роль Зміни:\ [ZBXNEXT-6787](https://support.zabbix.com/browse/ZBXNEXT-6787) припинено підтримку значення `manage_services` для властивості `name` в об’єкті `action`.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) припинено підтримку значення `configuration.services` для властивості `name` в об’єкті інтерфейсу користувача.\ # role.create # role.create # role.delete # role.delete ### Runtime control options **userparameter\_reload** Reload user parameters from the configuration file **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} ### Параметри керування виконанням (Runtime options) **userparameter\_reload** Перезавантаження параметрів користувача з файлу конфігурації **log\_level\_increase**\[=*target*\] Підвищити рівень журналу, впливає на всі процеси, якщо ціль не вказано **log\_level\_decrease**\[=*target*\] Зниження рівня журналу, впливає на всі процеси, якщо ціль не вказано [ ]{#lbAG} #### Scenario #### Сценарій #### script Changes:\ [ZBX-19466](https://support.zabbix.com/browse/ZBX-19466) changed validation of `script` object to be unique by combination of 2 properties: `name` and `menu_path`.\ #### скрипт Зміни:\ [ZBX-19466](https://support.zabbix.com/browse/ZBX-19466) змінено перевірку об’єкта `script` на унікальність за допомогою комбінації 2 властивостей: `name` і `menu_path`.\ #### Searching by host inventory data Retrieve hosts that contain "Linux" in the host inventory "OS" field. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": [ "host" ], "selectInventory": [ "os" ], "searchInventory": { "os": "Linux" } }, "id": 2, "auth": "7f9e00124c75e8f25facd5c093f3e9a0" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "host": "Zabbix server", "inventory": { "os": "Linux Ubuntu" } }, { "hostid": "10107", "host": "Linux server", "inventory": { "os": "Linux Mint" } } ], "id": 1 } ``` #### Пошук за даними інвентаризації хоста Отримати хости, які містять «Linux» у полі «ОС» хостів. Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": [ "host" ], "selectInventory": [ "os" ], "searchInventory": { "os": "Linux" } }, "id": 2, "auth": "7f9e00124c75e8f25facd5c093f3e9a0" } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "host": "Zabbix server", "inventory": { "os": "Linux Ubuntu" } }, { "hostid": "10107", "host": "Linux server", "inventory": { "os": "Linux Mint" } } ], "id": 1 } ``` #### Searching by host tags Retrieve hosts that have tag "Host name" equal to "Linux server". Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectTags": "extend", "evaltype": 0, "tags": [ { "tag": "Host name", "value": "Linux server", "operator": 1 } ] }, "auth": "7f9e00124c75e8f25facd5c093f3e9a0", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10085", "tags": [ { "tag": "Host name", "value": "Linux server" }, { "tag": "OS", "value": "RHEL 7" } ] } ], "id": 1 } ``` Retrieve hosts that have these tags not only on host level but also in their linked parent templates. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "tags": [{"tag": "A", "value": "1", "operator": "0"}], "inheritedTags": true }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10623", "name": "PC room 1" }, { "hostid": "10601", "name": "Office" } ], "id": 1 } ``` #### Пошук за тегами хоста Отримати хости, які мають тег «Ім’я хоста», що дорівнює «серверу Linux». Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectTags": "extend", "evaltype": 0, "tags": [ { "tag": "Host name", "value": "Linux server", "operator": 1 } ] }, "auth": "7f9e00124c75e8f25facd5c093f3e9a0", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10085", "tags": [ { "tag": "Host name", "value": "Linux server" }, { "tag": "OS", "value": "RHEL 7" } ] } ], "id": 1 } ``` Отримувати хости, які мають ці теги не лише на рівні хосту, але й у своїх пов’язаних батьківських шаблонах. Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "tags": [{"tag": "A", "value": "1", "operator": "0"}], "inheritedTags": true }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10623", "name": "PC room 1" }, { "hostid": "10601", "name": "Office" } ], "id": 1 } ``` #### Searching for hosts using wildcards Find hosts whose name contains word "server" and have interface ports "10050" or "10071". Sort the result by host name in descending order and limit it to 5 hosts. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid", "host"], "selectInterfaces": ["port"], "filter": { "port": ["10050", "10071"] }, "search": { "host": "*server*" }, "searchWildcardsEnabled": true, "searchByAny": true, "sortfield": "host", "sortorder": "DESC", "limit": 5 }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "50003", "host": "WebServer-Tomcat02", "interfaces": [ { "port": "10071" } ] }, { "hostid": "50005", "host": "WebServer-Tomcat01", "interfaces": [ { "port": "10071" } ] }, { "hostid": "50004", "host": "WebServer-Nginx", "interfaces": [ { "port": "10071" } ] }, { "hostid": "99032", "host": "MySQL server 01", "interfaces": [ { "port": "10050" } ] }, { "hostid": "99061", "host": "Linux server 01", "interfaces": [ { "port": "10050" } ] } ], "id": 1 } ``` #### Пошук хостів за допомогою символів підстановки Знайдіть хости, назва яких містить слово «сервер» і мають порти інтерфейсу «10050» або «10071». Відсортуйте результат за назвою хоста в порядку спадання та обмежте його 5 хостами. Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid", "host"], "selectInterfaces": ["port"], "filter": { "port": ["10050", "10071"] }, "search": { "host": "*server*" }, "searchWildcardsEnabled": true, "searchByAny": true, "sortfield": "host", "sortorder": "DESC", "limit": 5 }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "50003", "host": "WebServer-Tomcat02", "interfaces": [ { "port": "10071" } ] }, { "hostid": "50005", "host": "WebServer-Tomcat01", "interfaces": [ { "port": "10071" } ] }, { "hostid": "50004", "host": "WebServer-Nginx", "interfaces": [ { "port": "10071" } ] }, { "hostid": "99032", "host": "MySQL server 01", "interfaces": [ { "port": "10050" } ] }, { "hostid": "99061", "host": "Linux server 01", "interfaces": [ { "port": "10050" } ] } ], "id": 1 } ``` #### Searching for hosts using wildcards with "preservekeys" If you add the parameter "preservekeys" to the previous request, the result is returned as an associative array, where the keys are the id of the objects. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid", "host"], "selectInterfaces": ["port"], "filter": { "port": ["10050", "10071"] }, "search": { "host": "*server*" }, "searchWildcardsEnabled": true, "searchByAny": true, "sortfield": "host", "sortorder": "DESC", "limit": 5, "preservekeys": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "50003": { "hostid": "50003", "host": "WebServer-Tomcat02", "interfaces": [ { "port": "10071" } ] }, "50005": { "hostid": "50005", "host": "WebServer-Tomcat01", "interfaces": [ { "port": "10071" } ] }, "50004": { "hostid": "50004", "host": "WebServer-Nginx", "interfaces": [ { "port": "10071" } ] }, "99032": { "hostid": "99032", "host": "MySQL server 01", "interfaces": [ { "port": "10050" } ] }, "99061": { "hostid": "99061", "host": "Linux server 01", "interfaces": [ { "port": "10050" } ] } }, "id": 1 } ``` #### Пошук хостів за допомогою символів підстановки з "preservekeys" Якщо ви додаєте параметр "preservekeys" до попереднього запиту, результат повертається у вигляді асоціативного масиву, де ключі є ідентифікаторами об'єктів. Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid", "host"], "selectInterfaces": ["port"], "filter": { "port": ["10050", "10071"] }, "search": { "host": "*server*" }, "searchWildcardsEnabled": true, "searchByAny": true, "sortfield": "host", "sortorder": "DESC", "limit": 5, "preservekeys": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "50003": { "hostid": "50003", "host": "WebServer-Tomcat02", "interfaces": [ { "port": "10071" } ] }, "50005": { "hostid": "50005", "host": "WebServer-Tomcat01", "interfaces": [ { "port": "10071" } ] }, "50004": { "hostid": "50004", "host": "WebServer-Nginx", "interfaces": [ { "port": "10071" } ] }, "99032": { "hostid": "99032", "host": "MySQL server 01", "interfaces": [ { "port": "10050" } ] }, "99061": { "hostid": "99061", "host": "Linux server 01", "interfaces": [ { "порт": "10050" } ] } }, "id": 1 } ``` #### Searching hosts by problem severity Retrieve hosts that have "Disaster" problems. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "severities": 5 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10160", "name": "Zabbix server" } ], "id": 1 } ``` Retrieve hosts that have "Average" and "High" problems. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "severities": [3, 4] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "20170", "name": "Database" }, { "hostid": "20183", "name": "workstation" } ], "id": 1 } ``` #### Пошук хостів за серйозністю проблеми Отримати хости, які мають проблеми "Лихо". Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "severities": 5 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10160", "name": "Zabbix server" } ], "id": 1 } ``` Отримати хости, які мають проблеми "Середній" і "Високий". Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "severities": [3, 4] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "20170", "name": "Database" }, { "hostid": "20183", "name": "workstation" } ], "id": 1 } ``` #### Searching host with tags and template tags Retrieve a host with tags and all tags that are linked to parent templates. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "hostids": 10502, "selectTags": ["tag", "value"], "selectInheritedTags": ["tag", "value"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10502", "name": "Desktop", "tags": [ { "tag": "A", "value": "1" } ], "inheritedTags": [ { "tag": "B", "value": "2" } ] } ], "id": 1 } ``` #### Пошук хосту з тегами та тегами шаблону Отримайте хост із тегами та всі теги, пов’язані з батьківськими шаблонами. Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "hostids": 10502, "selectTags": ["tag", "value"], "selectInheritedTags": ["tag", "value"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10502", "name": "Desktop", "tags": [ { "tag": "A", "value": "1" } ], "inheritedTags": [ { "tag": "B", "value": "2" } ] } ], "id": 1 } ``` ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Alert](/manual/api/reference/alert/object) - [Item](/manual/api/reference/item/object) - [Host](/manual/api/reference/host/object) - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) - [Trigger](/manual/api/reference/trigger/object) ### Дивись також - [Попередження](/manual/api/reference/alert/object) - [Елемент](/manual/api/reference/item/object) - [Хост](/manual/api/reference/host/object) - [Правило LLD](/manual/api/reference/discoveryrule/object#lld_rule) - [Тригер](/manual/api/reference/trigger/object) ### See also - [Audit log object](/manual/api/reference/auditlog/object) ### Дивись також - [Об'єкт журналу аудиту](/manual/api/reference/auditlog/object) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) - [Host](/manual/api/reference/host/object#host) ### Дивись також - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) - [Хост](/manual/api/reference/host/object#host) ### See also - [Discovered service](/manual/api/reference/dservice/object#discovered_service) - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) ### Дивись також - [Виявлена служба](/manual/api/reference/dservice/object#discovered_service) - [Правило виявлення](/manual/api/reference/drule/object#discovery_rule) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovery rule](/manual/api/reference/discoveryrule/object#discovery_rule) - [Graph item](/manual/api/reference/graphitem/object#graph_item) - [Item](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) ### Дивись також - [Правило виявлення](/manual/api/reference/discoveryrule/object#discovery_rule) - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) - [Елемент](/manual/api/reference/item/object#item) - [Хост](/manual/api/reference/host/object#host) - [Група хостів](/manual/api/reference/hostgroup/object#host_group) - [Шаблон](/manual/api/reference/template/object#template) ### See also - [Discovery rule](/manual/api/reference/discoveryrule/object#discovery_rule) - [Graph item](/manual/api/reference/graphitem/object#graph_item) - [Item](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) ### Дивись також - [Правило виявлення](/manual/api/reference/discoveryrule/object#discovery_rule) - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) - [Елемент](/manual/api/reference/item/object#item) - [Хост](/manual/api/reference/host/object#host) - [Група хостів](/manual/api/reference/hostgroup/object#host_group) - [Шаблон](/manual/api/reference/template/object#template) ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) ------------------------------------------------------------------------ [ ]{#index} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) -------------------------------------------------- ---------------------- [ ]{#index} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### Дивись також - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### Дивись також - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph](/manual/api/reference/graph/object#graph) ### Дивись також - [Графік](/manual/api/reference/graph/object#graph) ### See also - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Host](/manual/api/reference/host/object#host) - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) - [LLD rule filter](object#lld_rule_filter) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### Дивись також - [Прототип графіка](/manual/api/reference/graphprototype/object#graph_prototype) - [Хост](/manual/api/reference/host/object#host) - [Прототип елемента](/manual/api/reference/itemprototype/object#item_prototype) - [Фільтр правил LLD](object#lld_rule_filter) - [Прототип тригера](/manual/api/reference/triggerprototype/object#trigger_prototype) ### See also - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### Дивись також - [Група хостів](/manual/api/reference/hostgroup/object#host_group) - [Шаблон](/manual/api/reference/template/object#template) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) ### See also - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) - [Host inventory](object#host_inventory) - [Host tag](object#host_tag) ### Дивись також - [Група хостів](/manual/api/reference/hostgroup/object#host_group) - [Шаблон](/manual/api/reference/template/object#template) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) - [Інвентар хоста](object#host_inventory) - [Тег хоста](object#host_tag) ### See also - [hostgroup.update](update) - [hostgroup.massadd](massadd) - [Host](/manual/api/reference/host/object#host) - [Template](/manual/api/reference/template/object#template) ### Дивись також - [hostgroup.update](оновлення) - [hostgroup.massadd](massadd) - [Хост](/manual/api/reference/host/object#host) - [Шаблон](/manual/api/reference/template/object#template) ### See also - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### Дивись також - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### See also - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### Дивись також - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### Дивись також - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### See also - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### Дивись також - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Елемент](/manual/api/reference/item/object#item) ### See also - [Host](/manual/api/reference/host/object#host) - [Media type](/manual/api/reference/mediatype/object#media_type) - [User](/manual/api/reference/user/object#user) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Тип медіа](/manual/api/reference/mediatype/object#media_type) - [Користувач](/manual/api/reference/user/object#user) ### See also - [Host](/manual/api/reference/host/object#host) - [Template](/manual/api/reference/template/object#template) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Шаблон](/manual/api/reference/template/object#template) ### See also - [Host](/manual/api/reference/host/object#host) - [Template](/manual/api/reference/template/object#template) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Шаблон](/manual/api/reference/template/object#template) ### See also - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### Перегляньте також - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### See also - [host.update](update) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### Дивись також - [host.update](оновити) - [Група хостів](/manual/api/reference/hostgroup/object#host_group) - [Шаблон](/manual/api/reference/template/object#template) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) ### See also - [host.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### Дивись також - [host.update](оновити) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) ### See also - [LLD rule filter](object#lld_rule_filter) - [LLD macro paths](object#lld_macro_path) - [LLD rule preprocessing](object#lld_rule_preprocessing) ### Дивись також - [Фільтр правил LLD](object#lld_rule_filter) - [Шляхи макросу LLD](object#lld_macro_path) - [Попередня обробка правила LLD](object#lld_rule_preprocessing) ### See also - [Scenario step](object#scenario_step) ### Дивись також - [Крок сценарію](object#scenario_step) ### See also - [Scenario step](object#scenario_step) ### Дивись також - [Крок сценарію](object#scenario_step) #### Server To enable encryption with certificate verification for connections between Zabbix server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_ca DBTLSCAFile=/etc/ssl/mysql/ca.pem ... #### Сервер Щоб увімкнути шифрування з перевіркою сертифіката для з’єднань між сервером Zabbix і базою даних, налаштуйте */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_ca DBTLSCAFile=/etc/ssl/mysql/ca.pem ... #### Server To enable encryption with full verification for connections between Zabbix server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_full DBTLSCAFile=/etc/ssl/mysql/ca.pem DBTLSCertFile=/etc/ssl/mysql/client-cert.pem DBTLSKeyFile=/etc/ssl/mysql/client-key.pem ... #### Сервер Щоб увімкнути шифрування з повною перевіркою з’єднань між сервером Zabbix і базою даних, налаштуйте */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_full DBTLSCAFile=/etc/ssl/mysql/ca.pem DBTLSCertFile=/etc/ssl/mysql/client-cert.pem DBTLSKeyFile=/etc/ssl/mysql/client-key.pem ... #### Server To enable transport-only encryption for connections between server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=required ... #### Сервер Щоб увімкнути лише транспортне шифрування для з’єднань між сервером і базою даних, налаштуйте */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=required ... #### service Changes:\ [ZBXNEXT-6787](https://support.zabbix.com/browse/ZBXNEXT-6787) added new property `readonly`.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) added support of properties `weight`, `propagation_rule` and `propagation_value`.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) added support of `status` value *(-1 - OK)*.\ [ZBXNEXT-2406](https://support.zabbix.com/browse/ZBXNEXT-2406) `service.get`: added support of parameters `deep_parentids` and `selectProblemEvents`.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) `service.create`, `service.update`: added support of parameter `status_rules`.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) `service.get`: added support of parameter `selectStatusRules`.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) `service.get`: added support of `count` for parameter `selectAlarms`.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) `service.create`, `service.update`: added support of parameters `children`, `parents` and `tags`.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) `service.get`: added support of parameters `evaltype`, `tags`, `selectChildren`, `selectParents`, `selectTags`.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) `service.get`: added support of parameters `problem_tags`, `without_problem_tags` and `selectProblemTags`.\ [ZBXNEXT-6674](https://support.zabbix.com/browse/ZBXNEXT-6674) `service.create`, `service.update`: added support of parameter `problem_tags`.\ #### сервіс Зміни:\ [ZBXNEXT-6787](https://support.zabbix.com/browse/ZBXNEXT-6787) додано нову властивість `readonly`.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) додано підтримку властивостей `weight`, `propagation_rule` і `propagation_value`.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) додано підтримку значення `status` *(-1 - OK)*.\ [ZBXNEXT-2406](https://support.zabbix.com/browse/ZBXNEXT-2406) `service.get`: додано підтримку параметрів `deep_parentids` і `selectProblemEvents`.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) `service.create`, `service.update`: додано підтримку параметра `статус_правил`.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) `service.get`: додано підтримку параметра `selectStatusRules`.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) `service.get`: додано підтримку `count` для параметра `selectAlarms`.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) `service.create`, `service.update`: додано підтримку параметрів `children`, `parents` і `tags`. \ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) `service.get`: додано підтримку параметрів `evaltype`, `tags`, `selectChildren`, `selectParents`, `selectTags `.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) `service.get`: додано підтримку параметрів `problem_tags`, `without_problem_tags` і `selectProblemTags`.\ [ZBXNEXT-6674](https://support.zabbix.com/browse/ZBXNEXT-6674) `service.create`, `service.update`: додано підтримку параметра `problem_tags`.\ #### settings Changes:\ [ZBXNEXT-6945](https://support.zabbix.com/browse/ZBXNEXT-6945) `settings.get`, `settings.update`: added support of parameters `geomaps_tile_provider`, `geomaps_tile_url`, `geomaps_max_zoom` and `geomaps_attribution`.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `settings.get`, `settings.update`: added support of parameter `auditlog_enabled`.\ #### налаштування Зміни:\ [ZBXNEXT-6945](https://support.zabbix.com/browse/ZBXNEXT-6945) `settings.get`, `settings.update`: додано підтримку параметрів `geomaps_tile_provider`, `geomaps_tile_url`, `geomaps_max_zoom` і `geomaps_attribution`.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `settings.get`, `settings.update`: додано підтримку параметра `auditlog_enabled`.\ #### Setting the maximum for the Y scale Set the maximum of the Y scale to a fixed value of 100. Request: ```json { "jsonrpc": "2.0", "method": "graph.update", "params": { "graphid": "439", "ymax_type": 1, "yaxismax": 100 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### Встановлення максимуму для шкали Y Встановіть максимальне значення шкали Y на фіксоване значення 100. Запит: ```json { "jsonrpc": "2.0", "method": "graph.update", "params": { "graphid": "439", "ymax_type": 1, "yaxismax": 100 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### sla Changes:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) added new API `sla` with methods: `sla.create`, `sla.delete`, `sla.get`, `sla.getsli`, `sla.update`.\ #### сла Зміни:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) додано новий API `sla` з методами: `sla.create`, `sla.delete`, `sla.get`, ` sla.getsli`, `sla.update`.\ #### SLES 15 In SUSE Linux Enterprise Server 15 you need to configure `php-fpm`: cp /etc/php7/fpm/php-fpm.conf{.default,} cp /etc/php7/fpm/php-fpm.d/www.conf{.default,} sed -i 's/user = nobody/user = wwwrun/; s/group = nobody/group = www/' /etc/php7/fpm/php-fpm.d/www.conf #### SLES 15 У SUSE Linux Enterprise Server 15 вам потрібно налаштувати `php-fpm`: cp /etc/php7/fpm/php-fpm.conf{.default,} cp /etc/php7/fpm/php-fpm.d/www.conf{.default,} sed -i 's/user = nobody/user = wwwrun/; s/group = nobody/group = www/' /etc/php7/fpm/php-fpm.d/www.conf #### Slideshow It is possible to activate a slideshow in the dashboard: - `/zabbix.php?action=dashboard.view&slideshow=1` - activate slideshow #### Слайд-шоу Слайд-шоу можна активувати на інформаційній панелі: - `/zabbix.php?action=dashboard.view&slideshow=1` - активувати показ слайдів ### Source CAction::create() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::create() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::delete() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::delete() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::get() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::get() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::update() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::update() у *ui/include/classes/api/services/CAction.php*. ### Source CAlert::get() in *ui/include/classes/api/services/CAlert.php*. ### Джерело CAlert::get() у *ui/include/classes/api/services/CAlert.php*. ### Source CAPIInfo::version() in *ui/include/classes/api/services/CAPIInfo.php*. ### Джерело CAPIInfo::version() у *ui/include/classes/api/services/CAPIInfo.php*. ### Source CAuditLog::get() in *ui/include/classes/api/services/CAuditLog.php*. ### Джерело CAuditLog::get() у *ui/include/classes/api/services/CAuditLog.php*. ### Source CAuthentication::get() in *ui/include/classes/api/services/CAuthentication.php*. ### Джерело CAuthentication::get() in *ui/include/classes/api/services/CAuthentication.php*. ### Source CAuthentication::update() in *ui/include/classes/api/services/CAuthentication.php*. ### Джерело CAuthentication::update() в *ui/include/classes/api/services/CAuthentication.php*. ### Source CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### Джерело CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### Source CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### Джерело CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### Source CConfiguration::export() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::export() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::importcompare() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CConfiguration::import() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::import() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CCorrelation::create() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::create() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::delete() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::delete() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::get() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::update() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::update() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::create() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::delete() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::get() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::update() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### Джерело CDCheck::get() в *ui/include/classes/api/services/CDCheck.php*. ### Source CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Джерело CDHost::get() в *ui/include/classes/api/services/CDHost.php*. ### Source CDiscoveryRule::create() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::create() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::delete() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::delete() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::get() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::get() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::update() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::update() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::create() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::delete() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::get() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::update() в *ui/include/classes/api/services/CDRule.php*. ### Source CDService::get() in *ui/include/classes/api/services/CDService.php*. ### Джерело CDService::get() в*ui/include/classes/api/services/CDService.php*. ### Source CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### Джерело CEvent::acknowledge() в *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### Джерело CEvent::get() в *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CProblem.php*. ### Джерело CEvent::get() у *ui/include/classes/api/services/CProblem.php*. ### Source CGraph::create() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::create() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::delete() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::get() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### Джерело CGraphItem::get() у *ui/include/classes/api/services/CGraphItem.php*. ### Source CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::create() в *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::delete() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::get() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::update() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::update() у *ui/include/classes/api/services/CGraph.php*. ### Source CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### Джерело CHaNode::get() у *ui/include/classes/api/services/CHaNode.php*. ### Source CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### Джерело CHistory::clear() у *ui/include/classes/api/services/CHistory.php*. ### Source CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ### Джерело CHistory::get() у *ui/include/classes/api/services/CHistory.php*. ### Source CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::create() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::delete() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::delete() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::get() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::get() в *ui/include/classes/api/services/CHost.php*. ### Source CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::create() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::delete() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::delete() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::get() у *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massAdd() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massRemove() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massUpdate() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::update() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::create() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::delete() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::get() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::massAdd() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::massRemove() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::replaceHostInterfaces() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::update() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massAdd() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massRemove() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massUpdate() в *ui/include/classes/api/services/CHost.php*. ### Source CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::create() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::delete() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::get() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::update() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHost::update() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::update() в *ui/include/classes/api/services/CHost.php*. ### Source CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Джерело CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Джерело CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::delete() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::get() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::update() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CIconMap::create() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::create() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::delete() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::get() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::get() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::update() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::update() в *ui/include/classes/api/services/CIconMap.php*. ### Source CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::create() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::delete() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::delete() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::get() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::get() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::update() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::update() в *ui/include/classes/api/services/CImage.php*. ### Source CItem::create() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::create() в *ui/include/classes/api/services/CItem.php*. ### Source CItem::delete() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::delete() в *ui/include/classes/api/services/CItem.php*. ### Source CItem::get() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::get() в *ui/include/classes/api/services/CItem.php*. ### Source CItemPrototype::create() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::create() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::delete() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::delete() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::get() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::get() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::update() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::update() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItem::update() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::update() в *ui/include/classes/api/services/CItem.php*. ### Source CMaintenance::create() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::create() в *ui/include/classes/api/services/CMaintenance.php*. ### Source CMaintenance::delete() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::delete() в *ui/include/classes/api/services/CMaintenance.php*. ### Source CMaintenance::get() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::get() в *ui/include/classes/api/services/CMaintenance.php*. ### Source CMaintenance::update() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::update() у *ui/include/classes/api/services/CMaintenance.php*. ### Source CMap::create() in *ui/include/classes/api/services/CMap.php*. ### Джерело CMap::create() у *ui/include/classes/api/services/CMap.php*. ### Source CMap::delete() in *ui/include/classes/api/services/CMap.php*. ### Джерело CMap::delete() у *ui/include/classes/api/services/CMap.php*. ### Source CMap::get() in *ui/include/classes/api/services/CMap.php*. ### Джерело CMap::get() у *ui/include/classes/api/services/CMap.php*. ### Source CMap::update() in *ui/include/classes/api/services/CMap.php*. ### Джерело CMap::update() у *ui/include/classes/api/services/CMap.php*. ### Source CMediaType::create() in *ui/include/classes/api/services/CMediaType.php*. ### Джерело CMediaType::create() у *ui/include/classes/api/services/CMediaType.php*. ### Source CMediaType::delete() in *ui/include/classes/api/services/CMediaType.php*. ### Джерело CMediaType::delete() у *ui/include/classes/api/services/CMediaType.php*. ### Source CMediaType::get() in *ui/include/classes/api/services/CMediaType.php*. ### Джерело CMediaType::get() у *ui/include/classes/api/services/CMediaType.php*. ### Source CMediaType::update() in *ui/include/classes/api/services/CMediaType.php*. ### Джерело CMediaType::update() у *ui/include/classes/api/services/CMediaType.php*. ### Source CProxy::create() in *ui/include/classes/api/services/CProxy.php*. ### Джерело CProxy::create() у *ui/include/classes/api/services/CProxy.php*. ### Source CProxy::delete() in *ui/include/classes/api/services/CProxy.php*. ### Джерело CProxy::delete() у *ui/include/classes/api/services/CProxy.php*. ### Source CProxy::get() in *ui/include/classes/api/services/CProxy.php*. ### Джерело CProxy::get() у *ui/include/classes/api/services/CProxy.php*. ### Source CProxy::update() in *ui/include/classes/api/services/CProxy.php*. ### Джерело CProxy::update() у *ui/include/classes/api/services/CProxy.php*. ### Source CRegexp::create() in *ui/include/classes/api/services/CRegexp.php*. ### Джерело CRegexp::create() у *ui/include/classes/api/services/CRegexp.php*. ### Source CRegexp::delete() in *ui/include/classes/api/services/CRegexp.php*. ### Джерело CRegexp::delete() у *ui/include/classes/api/services/CRegexp.php*. ### Source CRegexp::get() in *ui/include/classes/api/services/CRegexp.php*. ### Джерело CRegexp::get() у *ui/include/classes/api/services/CRegexp.php*. ### Source CRegexp::update() in *ui/include/classes/api/services/CRegexp.php*. ### Джерело CRegexp::update() у *ui/include/classes/api/services/CRegexp.php*. ### Source CReport::create() in *ui/include/classes/api/services/CReport.php*. ### Джерело CReport::create() у *ui/include/classes/api/services/CReport.php*. ### Source CReport::delete() in *ui/include/classes/api/services/CReport.php*. ### Джерело CReport::delete() у *ui/include/classes/api/services/CReport.php*. ### Source CReport::get() in *ui/include/classes/api/services/CReport.php*. ### Джерело CReport::get() у *ui/include/classes/api/services/CReport.php*. ### Source CReport::update() in *ui/include/classes/api/services/CReport.php*. ### Джерело CReport::update() у *ui/include/classes/api/services/CReport.php*. ### Source CRole::create() in *ui/include/classes/api/services/CRole.php*. ### Джерело CRole::create() у *ui/include/classes/api/services/CRole.php*. ### Source CRole::delete() in *ui/include/classes/api/services/CRole.php*. ### Джерело CRole::delete() у *ui/include/classes/api/services/CRole.php*. ### Source CRole::get() in *ui/include/classes/api/services/CRole.php*. ### Джерело CRole::get() у *ui/include/classes/api/services/CRole.php*. ### Source CRole::update() in *ui/include/classes/api/services/CRole.php*. ### Джерело CRole::update() у *ui/include/classes/api/services/CRole.php*. ### Source CScript::create() in *ui/include/classes/api/services/CScript.php*. ### Джерело CScript::create() у *ui/include/classes/api/services/CScript.php*. ### Source CScript::delete() in *ui/include/classes/api/services/CScript.php*. ### Джерело CScript::delete() у *ui/include/classes/api/services/CScript.php*. ### Source CScript::execute() in *ui/include/classes/api/services/CScript.php*. ### Джерело CScript::execute() у *ui/include/classes/api/services/CScript.php*. ### Source CScript::get() in *ui/include/classes/api/services/CScript.php*. ### Джерело CScript::get() у *ui/include/classes/api/services/CScript.php*. ### Source CScript::getScriptsByHosts() in *ui/include/classes/api/services/CScript.php*. ### Джерело CScript::getScriptsByHosts() у *ui/include/classes/api/services/CScript.php*. ### Source CScript::update() in *ui/include/classes/api/services/CScript.php*. ### Джерело CScript::update() у *ui/include/classes/api/services/CScript.php*. ### Source CService::create() in *ui/include/classes/api/services/CService.php*. ### Джерело CService::create() у *ui/include/classes/api/services/CService.php*. ### Source CService::delete() in *ui/include/classes/api/services/CService.php*. ### Джерело CService::delete() у *ui/include/classes/api/services/CService.php*. ### Source CService::get() in *ui/include/classes/api/services/CService.php*. ### Джерело CService::get() у *ui/include/classes/api/services/CService.php*. ### Source CService::update() in *ui/include/classes/api/services/CService.php*. ### Джерело CService::update() у *ui/include/classes/api/services/CService.php*. ### Source CSettings::get() in *ui/include/classes/api/services/CSettings.php*. ### Джерело CSettings::get() у *ui/include/classes/api/services/CSettings.php*. ### Source CSettings::update() in *ui/include/classes/api/services/CSettings.php*. ### Джерело CSettings::update() у *ui/include/classes/api/services/CSettings.php*. ### Source CSla::create() in *ui/include/classes/api/services/CSla.php*. ### Джерело CSla::create() у *ui/include/classes/api/services/CSla.php*. ### Source CSla::delete() in *ui/include/classes/api/services/CSla.php*. ### Джерело CSla::delete() у *ui/include/classes/api/services/CSla.php*. ### Source CSla:get() in *ui/include/classes/api/services/CSla.php*. ### Джерело CSla:get() у *ui/include/classes/api/services/CSla.php*. ### Source CSla::getSli() in *ui/include/classes/api/services/CSla.php* ### Джерело CSla::getSli() у *ui/include/classes/api/services/CSla.php* ### Source CSla::update() in *ui/include/classes/api/services/CSla.php*. ### Джерело CSla::update() у *ui/include/classes/api/services/CSla.php*. ### Source CTask::create() in *ui/include/classes/api/services/CTask.php*. ### Джерело CTask::create() у *ui/include/classes/api/services/CTask.php*. ### Source CTask::get() in *ui/include/classes/api/services/CTask.php*. ### Джерело CTask::get() у *ui/include/classes/api/services/CTask.php*. ### Source CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### Джерело CTemplate::create() у *ui/include/classes/api/services/CTemplate.php*. ### Source CTemplateDashboard::create() in *ui/include/classes/api/services/CTemplateDashboard.php*. ### Джерело CTemplateDashboard::create() у *ui/include/classes/api/services/CTemplateDashboard.php*. ### Source CTemplateDashboard::delete() in *ui/include/classes/api/services/CTemplateDashboard.php*. ### Джерело CTemplateDashboard::delete() у *ui/include/classes/api/services/CTemplateDashboard.php*. ### Source CTemplateDashboard::get() in *ui/include/classes/api/services/CTemplateDashboard.php*. ### Джерело CTemplateDashboard::get() у *ui/include/classes/api/services/CTemplateDashboard.php*. ### Source CTemplateDashboard::update() in *ui/include/classes/api/services/CTemplateDashboard.php*. ### Джерело CTemplateDashboard::update() у *ui/include/classes/api/services/CTemplateDashboard.php*. ### Source CTemplate::delete() in *ui/include/classes/api/services/CTemplate.php*. ### Джерело CTemplate::delete() у *ui/include/classes/api/services/CTemplate.php*. ### Source CTemplate::get() in *ui/include/classes/api/services/CTemplate.php*. ### Джерело CTemplate::get() у *ui/include/classes/api/services/CTemplate.php*. ### Source CTemplate::massAdd() in *ui/include/classes/api/services/CTemplate.php*. ### Джерело CTemplate::massAdd() у *ui/include/classes/api/services/CTemplate.php*. ### Source CTemplate::massRemove() in *ui/include/classes/api/services/CTemplate.php*. ### Джерело CTemplate::massRemove() у *ui/include/classes/api/services/CTemplate.php*. ### Source CTemplate::massUpdate() in *ui/include/classes/api/services/CTemplate.php*. ### Джерело CTemplate::massUpdate() у *ui/include/classes/api/services/CTemplate.php*. ### Source CTemplate::update() in *ui/include/classes/api/services/CTemplate.php*. ### Джерело CTemplate::update() у *ui/include/classes/api/services/CTemplate.php*. ### Source CToken::create() in *ui/include/classes/api/services/CToken.php*. ### Джерело CToken::create() у *ui/include/classes/api/services/CToken.php*. ### Source CToken::delete() in *ui/include/classes/api/services/CToken.php*. ### Джерело CToken::delete() у *ui/include/classes/api/services/CToken.php*. ### Source CToken::generate() in *ui/include/classes/api/services/CToken.php*. ### Джерело CToken::generate() у *ui/include/classes/api/services/CToken.php*. ### Source CToken::get() in *ui/include/classes/api/services/CToken.php*. ### Джерело CToken::get() у *ui/include/classes/api/services/CToken.php*. ### Source CToken::update() in *ui/include/classes/api/services/CToken.php*. ### Джерело CToken::update() у *ui/include/classes/api/services/CToken.php*. ### Source CTrend::get() in *ui/include/classes/api/services/CTrend.php*. ### Джерело CTrend::get() у *ui/include/classes/api/services/CTrend.php*. ### Source CTrigger::addDependencies() in *ui/include/classes/api/services/CTrigger.php*. ### Джерело CTrigger::addDependencies() у *ui/include/classes/api/services/CTrigger.php*. ### Source CTrigger::create() in *ui/include/classes/api/services/CTrigger.php*. ### Джерело CTrigger::create() у *ui/include/classes/api/services/CTrigger.php*. ### Source CTrigger::deleteDependencies() in *ui/include/classes/api/services/CTrigger.php*. ### Джерело CTrigger::deleteDependencies() у *ui/include/classes/api/services/CTrigger.php*. ### Source CTrigger::delete() in *ui/include/classes/api/services/CTrigger.php*. ### Джерело CTrigger::delete() у *ui/include/classes/api/services/CTrigger.php*. ### Source CTrigger::get() in *ui/include/classes/api/services/CTrigger.php*. ### Джерело CTrigger::get() у *ui/include/classes/api/services/CTrigger.php*. ### Source CTriggerPrototype::create() in *ui/include/classes/api/services/CTriggerPrototype.php*. ### Джерело CTriggerPrototype::create() у *ui/include/classes/api/services/CTriggerPrototype.php*. ### Source CTriggerPrototype::delete() in *ui/include/classes/api/services/CTriggerPrototype.php*. ### Джерело CTriggerPrototype::delete() у *ui/include/classes/api/services/CTriggerPrototype.php*. ### Source CTriggerPrototype::get() in *ui/include/classes/api/services/CTriggerPrototype.php*. ### Джерело CTriggerPrototype::get() у *ui/include/classes/api/services/CTriggerPrototype.php*. ### Source CTriggerPrototype::update() in *ui/include/classes/api/services/CTriggerPrototype.php*. ### Джерело CTriggerPrototype::update() у *ui/include/classes/api/services/CTriggerPrototype.php*. ### Source CTrigger::update() in *ui/include/classes/api/services/CTrigger.php*. ### Джерело CTrigger::update() у *ui/include/classes/api/services/CTrigger.php*. ### Source CUser::checkAuthentication() in *ui/include/classes/api/services/CUser.php*. ### Джерело CUser::checkAuthentication() у *ui/include/classes/api/services/CUser.php*. ### Source CUser::create() in *ui/include/classes/api/services/CUser.php*. ### Джерело CUser::create() у *ui/include/classes/api/services/CUser.php*. ### Source CUser::delete() in *ui/include/classes/api/services/CUser.php*. ### Джерело CUser::delete() у *ui/include/classes/api/services/CUser.php*. ### Source CUser::get() in *ui/include/classes/api/services/CUser.php*. ### Джерело CUser::get() у *ui/include/classes/api/services/CUser.php*. ### Source CUserGroup::create() in *ui/include/classes/api/services/CUserGroup.php*. ### Джерело CUserGroup::create() у *ui/include/classes/api/services/CUserGroup.php*. ### Source CUserGroup::delete() in *ui/include/classes/api/services/CUserGroup.php*. ### Джерело CUserGroup::delete() у *ui/include/classes/api/services/CUserGroup.php*. ### Source CUserGroup::get() in *ui/include/classes/api/services/CUserGroup.php*. ### Джерело CUserGroup::get() у *ui/include/classes/api/services/CUserGroup.php*. ### Source CUserGroup::update() in *ui/include/classes/api/services/CUserGroup.php*. ### Джерело CUserGroup::update() у *ui/include/classes/api/services/CUserGroup.php*. ### Source CUser::login() in *ui/include/classes/api/services/CUser.php*. ### Джерело CUser::login() у *ui/include/classes/api/services/CUser.php*. ### Source CUser::login() in *ui/include/classes/api/services/CUser.php*. ### Джерело CUser::login() у *ui/include/classes/api/services/CUser.php*. ### Source CUserMacro::createGlobal() in *ui/include/classes/api/services/CUserMacro.php*. ### Джерело CUserMacro::createGlobal() у *ui/include/classes/api/services/CUserMacro.php*. ### Source CUserMacro::create() in *ui/include/classes/api/services/CUserMacro.php*. ### Джерело CUserMacro::create() у *ui/include/classes/api/services/CUserMacro.php*. ### Source CUserMacro::deleteGlobal() in *ui/include/classes/api/services/CUserMacro.php*. ### Джерело CUserMacro::deleteGlobal() у *ui/include/classes/api/services/CUserMacro.php*. ### Source CUserMacro::delete() in *ui/include/classes/api/services/CUserMacro.php*. ### Джерело CUserMacro::delete() у *ui/include/classes/api/services/CUserMacro.php*. ### Source CUserMacro::get() in *ui/include/classes/api/services/CUserMacro.php*. ### Джерело CUserMacro::get() у *ui/include/classes/api/services/CUserMacro.php*. ### Source CUserMacro::updateGlobal() in *ui/include/classes/api/services/CUserMacro.php*. ### Джерело CUserMacro::updateGlobal() у *ui/include/classes/api/services/CUserMacro.php*. ### Source CUserMacro::update() in *ui/include/classes/api/services/CUserMacro.php*. ### Джерело CUserMacro::update() у *ui/include/classes/api/services/CUserMacro.php*. ### Source CUser::unblock() in *ui/include/classes/api/services/CUser.php*. ### Джерело CUser::unblock() у *ui/include/classes/api/services/CUser.php*. ### Source CUser::update() in *ui/include/classes/api/services/CUser.php*. ### Джерело CUser::update() у *ui/include/classes/api/services/CUser.php*. ### Source CValueMap::create() in *ui/include/classes/api/services/CValueMap.php*. ### Джерело CValueMap::create() у *ui/include/classes/api/services/CValueMap.php*. ### Source CValueMap::delete() in *ui/include/classes/api/services/CValueMap.php*. ### Джерело CValueMap::delete() у *ui/include/classes/api/services/CValueMap.php*. ### Source CValueMap::get() in *ui/include/classes/api/services/CValueMap.php*. ### Джерело CValueMap::get() у *ui/include/classes/api/services/CValueMap.php*. ### Source CValueMap::update() in *ui/include/classes/api/services/CValueMap.php*. ### Джерело CValueMap::update() у *ui/include/classes/api/services/CValueMap.php*. #### SQLite Using SQLite is supported for **Zabbix proxy** only! The database will be automatically created if it does not exist. Return to the [installation section](/manual/installation/install). #### SQLite Використання SQLite підтримується лише для **Zabbix proxy**! База даних буде створена автоматично, якщо вона не існує. Поверніться до [розділу встановлення](/manual/installation/install). ##### Step 1 Add a new web scenario. We will add a scenario to monitor the web interface of Zabbix. The scenario will execute a number of steps. Go to *Configuration → Hosts*, pick a host and click on *Web* in the row of that host. Then click on *Create web scenario*.  All mandatory input fields are marked with a red asterisk. In the new scenario form we will name the scenario as *Zabbix frontend*. We will also create two variables: {user} and {password}. You may also want to add a new *Application:Zabbix frontend* tag in the Tags tab. ##### Крок 1 Додайте новий веб-сценарій. Ми додамо сценарій для моніторингу веб-інтерфейсу Zabbix. Сценарій виконуватиме декілька кроків. Перейдіть до *Конфігурація → Хости*, виберіть хост і натисніть *Веб* у рядку цього хосту. Потім натисніть *Створити веб-сценарій*.  Усі обов’язкові поля для введення позначені червоною зірочкою. У новій формі сценарію ми назвемо сценарій *інтерфейс Zabbix*. Ми також створимо дві змінні: {user} і {password}. Ви також можете додати новий тег *Application:Zabbix frontend* на вкладці «Теги». ##### Step 1 Install Kerberos package. For Debian/Ubuntu: apt install krb5-user For RHEL: dnf install krb5-workstation ##### Крок 1 Встановіть пакет Kerberos. Для Debian/Ubuntu: apt install krb5-user Для RHEL: dnf install krb5-workstation ##### Step 1 To define your own theme you'll need to create a CSS file and save it in the `assets/styles/` folder (for example, *custom-theme.css*). You can either copy the files from a different theme and create your theme based on it or start from scratch. ##### Крок 1 Щоб визначити власну тему, вам потрібно створити файл CSS і зберегти його в папці `assets/styles/` (наприклад, *custom-theme.css*). Ви можете або скопіювати файли з іншої теми та створити свою тему на її основі, або почати з нуля. ##### Step 2 Add your theme to the list of themes returned by the APP::getThemes() method. You can do this by overriding the ZBase::getThemes() method in the APP class. This can be done by adding the following code before the closing brace in *include/classes/core/APP.php*: public static function getThemes() { return array_merge(parent::getThemes(), [ 'custom-theme' => _('Custom theme') ]); } ::: noteimportant Note that the name you specify within the first pair of quotes must match the name of the theme file without extension. ::: To add multiple themes, just list them under the first theme, for example: public static function getThemes() { return array_merge(parent::getThemes(), [ 'custom-theme' => _('Custom theme'), 'anothertheme' => _('Another theme'), 'onemoretheme' => _('One more theme') ]); } Note that every theme except the last one must have a trailing comma. ::: notetip To change graph colors, the entry must be added in the *graph\_theme* database table. ::: ##### Крок 2 Додайте свою тему до списку тем, які повертає метод APP::getThemes(). Це можна зробити, перевизначивши метод ZBase::getThemes() у класі APP. Це можна зробити, додавши такий код перед закриваючою дужкою в *include/classes/core/APP.php*: · public static function getThemes() { · return array_merge(parent::getThemes(), [ · 'custom-theme' => _('Custom theme') · ]); · } ::: noteimportant Зауважте, що назва, яку ви вказуєте в першій парі лапок, має збігатися з назвою файлу теми без розширення. ::: Щоб додати кілька тем, просто перелічіть їх під першою темою, наприклад: · public static function getThemes() { · return array_merge(parent::getThemes(), [ · 'custom-theme' => _('Custom theme'), · 'anothertheme' => _('Another theme'), · 'onemoretheme' => _('One more theme') · ]); · } Зауважте, що кожна тема, крім останньої, повинна мати кінцеву кому. ::: підказка Щоб змінити кольори графіка, потрібно додати запис у таблицю бази даних *graph\_theme*. ::: ##### Step 2 Configure Kerberos configuration file (see MIT documentation for details) ``` {.java} cat /etc/krb5.conf [libdefaults] default_realm = EXAMPLE.COM # The following krb5.conf variables are only for MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` ##### Крок 2 Налаштувати файл конфігурації Kerberos (докладніше див. у документації MIT) ``` {.java} cat /etc/krb5.conf [libdefaults] default_realm = EXAMPLE.COM # Les variables krb5.conf següents són només per a MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` ##### Step 2 Define steps for the scenario. Click on *Add* button in the *Steps* tab to add individual steps. *Web scenario step 1* We start by checking that the first page responds correctly, returns with HTTP response code 200 and contains text "Zabbix SIA". {width="600"} When done configuring the step, click on *Add*. *Web scenario step 2* We continue by logging in to the Zabbix frontend, and we do so by reusing the macros (variables) we defined on the scenario level - {user} and {password}. {width="600"} ::: noteimportant Note that Zabbix frontend uses JavaScript redirect when logging in, thus first we must log in, and only in further steps we may check for logged-in features. Additionally, the login step must use full URL to **index.php** file. ::: Take note also of how we are getting the content of the `{sid}` variable (session ID) using a variable syntax with regular expression: `regex:name="csrf-token" content="([0-9a-z]{16})"`. This variable will be required in step 4. *Web scenario step 3* Being logged in, we should now verify the fact. To do so, we check for a string that is only visible when logged in - for example, **Administration**. {width="600"} *Web scenario step 4* Now that we have verified that frontend is accessible and we can log in and retrieve logged-in content, we should also log out - otherwise Zabbix database will become polluted with lots and lots of open session records. {width="600"} *Web scenario step 5* We can also check that we have logged out by looking for the **Username** string. {width="600"} *Complete configuration of steps* A complete configuration of web scenario steps should look like this: {width="600"} ##### Крок 2 Визначте кроки для сценарію. Натисніть кнопку *Додати* на вкладці *Кроки*, щоб додати окремі кроки. *Крок 1 веб-сценарію* Ми починаємо з перевірки, що перша сторінка відповідає правильно, повертає код відповіді HTTP 200 і містить текст «Zabbix SIA». {width="600"} Після завершення налаштування кроку натисніть *Додати*. *Крок 2 веб-сценарію* Ми продовжуємо, входячи в інтерфейс Zabbix, і ми робимо це, повторно використовуючи макроси (змінні), які ми визначили на рівні сценарію - {user} і {password}. {width="600"} ::: приміткаважливо Зауважте, що інтерфейс Zabbix використовує перенаправлення JavaScript під час входу, тому спочатку ми повинні авторизуватися, і лише на наступних кроках ми можемо перевірити наявність функцій входу. Крім того, на етапі входу має використовуватися повна URL-адреса файлу **index.php**. ::: Зверніть також увагу на те, як ми отримуємо вміст змінної `{sid}` (ідентифікатор сеансу) за допомогою синтаксису змінної з регулярним виразом: `regex:name="csrf-token" content="([0-9a-z ]{16})"`. Ця змінна знадобиться на кроці 4. *Веб-сценарій крок 3* Увійшовши в систему, ми повинні перевірити факт. Для цього ми перевіряємо рядок, який відображається лише після входу в систему, наприклад, **Адміністрування**. {width="600"} *Веб-сценарій крок 4* Тепер, коли ми переконалися, що інтерфейс доступний, і ми можемо увійти та отримати вміст, який авторизувався, нам також слід вийти - інакше база даних Zabbix буде забруднена великою кількістю відкритих записів сеансу. {width="600"} *Крок 5 веб-сценарію* Ми також можемо перевірити, чи ми вийшли, знайшовши Рядок **Ім’я користувача**. {width="600"} *Повна конфігурація кроків* Повна конфігурація етапів веб-сценарію має виглядати так: {width="600"} ##### Step 3 Activate the new theme. In Zabbix frontend, you may either set this theme to be the default one or change your theme in the user profile. Enjoy the new look and feel! ##### Крок 3 Активуйте нову тему. У інтерфейсі Zabbix ви можете або встановити цю тему як тему за замовчуванням, або змінити свою тему в профілі користувача. Насолоджуйтесь новим зовнішнім виглядом! ##### Step 3 Create a Kerberos ticket for user *zabbix*. Run the following command as user *zabbix*: kinit zabbix ::: noteimportant It is important to run the above command as user *zabbix*. If you run it as *root* the authentication will not work. ::: ##### Крок 3 Створіть квиток Kerberos для користувача *zabbix*. Виконайте наступну команду від імені користувача *zabbix*: kinit zabbix ::: noteimportant Важливо виконати наведену вище команду як користувач *zabbix*. Якщо ви запустите його як *root*, автентифікація не працюватиме. ::: ##### Step 3 Save the finished web monitoring scenario. The scenario will be added to a host. To view web scenario information go to *Monitoring → Hosts*, locate the host in the list and click on the Web hyperlink in the last column. {width="600"} Click on the scenario name to see more detailed statistics: {width="600"} ##### Крок 3 Збережіть готовий сценарій веб-моніторингу. Сценарій буде додано до хосту. Щоб переглянути інформацію про веб-сценарій, перейдіть до *Моніторинг → Хости*, знайдіть хост у списку та клацніть гіперпосилання Веб в останньому стовпчику. {width="600"} Натисніть на назву сценарію, щоб переглянути детальнішу статистику: {width="600"} ##### Step 4 Create a web scenario or HTTP agent item with Kerberos authentication type. Optionally can be tested with the following curl command: curl -v --negotiate -u : http://example.com Note that for lengthy web monitoring it is necessary to take care of renewing the Kerberos ticket. Default time of ticket expiration is 10h. ##### Крок 4 Створіть веб-сценарій або елемент HTTP-агента з типом автентифікації Kerberos. Додатково можна перевірити за допомогою такої команди curl: curl -v --negotiate -u : http://example.com Зверніть увагу, що для тривалого веб-моніторингу необхідно подбати про оновлення квитка Kerberos. За замовчуванням термін дії квитка становить 10 годин. #### Steps #### Кроки ### String history The string 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|string|Received value.| ### Історія рядків Об'єкт історії рядків має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |годинник|мітка часу|Час, коли це значення було отримано.| |itemid|рядок|ID пов'язаного елемента.| |ns|ціле|Наносекунди, коли було отримано значення.| |значення|рядок|Отримане значення.| ### Structure The API consists of a number of methods that are nominally grouped into separate APIs. Each of the methods performs one specific task. For example, the `host.create` method belongs to the *host* API and is used to create new hosts. Historically, APIs are sometimes referred to as "classes". ::: notetip Most APIs contain at least four methods: `get`, `create`, `update` and `delete` for retrieving, creating, updating and deleting data respectively, but some of the APIs may provide a totally different set of methods. ::: ### Структура API складається з кількох методів, номінально згрупованих у окремі API. Кожен із методів виконує одну певну задачу. Наприклад, метод `host.create` належить до API *host* і використовується для створення нових хостів. Історично так склалось, що API іноді називають "класами". ::: notetip Більшість API містять принаймні чотири методи: `get`, `create`, `update` і `delete` для отримання, створення, оновлення та видалення даних відповідно, але деякі API можуть надавати повністю різний набір методів. ::: ## SYNOPSIS **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *номер-порту*\] \[**-I** *IP-адреса*\] \[**-t** *тайм-аут*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *номер порту*\] \[**-I** *IP-адреса*\] \[**-t** *час очікування*\] **--tls-connect** **cert** **--tls-ca-файл** *CA-файл* \[**--tls-crl-файл** *CRL-файл*\] \[**--tls-agent-cert-issuer** *сертифікат-емітент*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *файл-сертифіката* **--tls-key-file** *key-file* \[**--tls-cipher13** *шифр-рядок*\] \[**--tls-cipher** *шифр-рядок*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *port-number*\] \[**-I** *IP-адреса*\] \[**-t** *час очікування*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-ідентифікація* **--tls-psk-файл** *PSK-файл* \[**--tls-cipher13** *шифр-рядок*\] \[**--tls-cipher** *шифр-рядок*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_proxy** \[**-c** *config-file*\]\ **zabbix\_proxy** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_proxy** \[**-c** *конфігураційний файл*\]\ **zabbix\_proxy** \[**-c** *конфігураційний файл*\] **-R** *параметр виконання*\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender -h**\ **zabbix\_sender -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender -h**\ **zabbix\_sender -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} # Task This class is designed to work with tasks (such as checking items or low-level discovery rules without config reload). Object references:\ - [Task](/manual/api/reference/task/object) - ['Check now' request object](/manual/api/reference/task/object#check_now_request_object) - ['Diagnostic information' request object](/manual/api/reference/task/object#diagnostic_information_request_object) - [Statistic request object](/manual/api/reference/task/object#statistic_request_object) - [Statistic result object](/manual/api/reference/task/object#statistic_result_object) Available methods:\ - [task.create](/manual/api/reference/task/create) - creating new tasks - [task.get](/manual/api/reference/task/get) - retrieving tasks # Задача Цей клас призначений для роботи із задачами (такими як перевірка елементів або низько-рівневі правила виявлення без перезавантаження конфігурації). Об'єктні посилання:\ - [Задача](/manual/api/reference/task/object) - [Запит об'єкту 'Перевірити зараз'](/manual/api/reference/task/object#check_now_request_object) - [Запит об'єкту 'Діагностична інформація'](/manual/api/reference/task/object#diagnostic_information_request_object) - [Статистичний запит об'єкту](/manual/api/reference/task/object#statistic_request_object) - [Статистичний результат об'єкту](/manual/api/reference/task/object#statistic_result_object) Доступні методи:\ - [task.create](/manual/api/reference/task/create) - створити нову задачу - [task.get](/manual/api/reference/task/get) - отримати задачу #### template Changes:\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `template.create`, `template.update`, `template.delete`, `template.massadd`, `template.massupdate`, `template.massremove`: added strict validation of the methods parameters.\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `template.create`, `template.update`, `template.massadd`, `template.massupdate`: dropped support of parameter `hosts`.\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `template.massremove`: dropped support of parameter `hostids`. #### шаблон Зміни:\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `template.create`, `template.update`, `template.delete`, `template.massadd`, `template.massupdate `, `template.massremove`: додано сувору перевірку параметрів методів.\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `template.create`, `template.update`, `template.massadd`, `template.massupdate`: припинено підтримку параметра `вузлів мережі`.\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `template.massremove`: припинено підтримку параметра `hostids`. #### template Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `template.update`: the parameter `uuid` can now be updated.\ #### шаблон Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `template.update`: тепер можна оновити параметр `uuid`.\ #### templatedashboard Changes:\ [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) added support of new widget type `item`.\ #### шаблон інформаційної панелі Зміни:\ [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) додано підтримку нового типу віджетів `item`.\ #### templatedashboard Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `templatedashboard.update`: the parameter `uuid` can now be updated.\ #### шаблон інформаційної панелі Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `templatedashboard.update`: тепер можна оновити параметр `uuid`.\ ### Text history The text 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.| |ns|integer|Nanoseconds when the value was received.| |value|text|Received value.| ### Історія тексту Об'єкт історії тексту має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |id|рядок|ID запису історії.| |годинник|мітка часу|Час, коли це значення було отримано.| |itemid|рядок|ID пов'язаного елемента.| |ns|ціле|Наносекунди, коли було отримано значення.| |значення|текст|Отримане значення.| # The following krb5.conf variables are only for MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` # Наступні змінні krb5.conf призначені лише для MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` # This topic does not exist yet. We are sorry, the page you are looking for cannot be found. Return to the homepage, try searching, or get [help](https://www.zabbix.com/support). # Цей розділ ще не створено. Нажаль, сторінка яку ви шукаєте не знайдена. Поверніться до домашньої сторінки, або [зверніться по допомогу](https://www.zabbix.com/support). #### Time period selector The [time period selector](/manual/config/visualization/graphs/simple#time_period_selector) allows to select often required periods with one mouse click. The time period selector can be opened by clicking on the time period tab next to the filter. #### Селектор періоду часу [Селектор періоду часу](/manual/config/visualization/graphs/simple#time_period_selector) дозволяє вибирати часто потрібні періоди одним клацанням миші. Вибір періоду часу можна відкрити, клацнувши вкладку періоду часу поруч із фільтром. ##### Time period The **second** parameter allows to specify the time period for aggregation. The time period can only be expressed as time, the amount of values (prefixed with **\#**) is not supported. [Supported unit symbols](/manual/appendix/suffixes) can be used in this parameter for convenience, for example '5m' (five minutes) instead of '300s' (300 seconds) or '1d' (one day) instead of '86400' (86400 seconds). Time period is ignored by the server if passed with the *last\_foreach* function and can thus be omitted: last_foreach(/*/key?[group="host group"]) Time period is not supported with the *exists\_foreach* function. ##### Період часу **Другий** параметр дозволяє вказати період часу для агрегації. Період часу можна виразити лише як час, кількість значень (з префіксом **\#**) не підтримується. [Підтримувані одиниці вимірювання](/manual/appendix/suffixes) можна використовувати в цьому параметрі для зручності, наприклад, «5m» (п’ять хвилин) замість «300s» (300 секунд) або «1d» (один день) замість «86400» (86400 секунд). Період часу ігнорується сервером, якщо він передається за допомогою функції *last\_foreach*, тому його можна пропустити: last_foreach(/*/key?[group="host group"]) Період часу не підтримується функцією *exists\_foreach*. #### TimescaleDB Instructions for creating and configuring TimescaleDB are provided in a separate [section](/manual/appendix/install/timescaledb). #### TimescaleDB Інструкції щодо створення та налаштування TimescaleDB наведено в окремому [розділі](/manual/appendix/install/timescaledb). #### trigger Changes:\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `trigger.adddependencies`, `trigger.deletedependencies`: dropped the ability to edit the dependencies of inherited triggers.\ #### тригер Зміни:\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `trigger.adddependencies`, `trigger.deletedependencies`: вилучено можливість редагувати залежності успадкованих тригерів.\ #### trigger Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `trigger.update`: the parameter `uuid` can now be updated.\ #### тригер Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `trigger.update`: тепер можна оновити параметр `uuid`.\ #### triggerprototype Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `triggerprototype.update`: the parameter `uuid` can now be updated.\ #### прототип тригера Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `triggerprototype.update`: тепер можна оновити параметр `uuid`.\ ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-agent-cert-issuer** *cert-issuer* Allowed agent certificate issuer. **--tls-agent-cert-subject** *cert-subject* Allowed agent certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **unencrypted** підключатися без шифрування (за замовчуванням) ```{=html} <!-- --> ``` **psk** підключатися за допомогою TLS і заздалегідь наданого ключа ```{=html} <!-- --> ``` **cert** підключитися за допомогою TLS і сертифіката ```{=html} <!-- --> ``` **--tls-ca-файл** *CA-file* Повне ім'я файлу, що містить сертифікати центрів сертифікації верхнього рівня для для однорангової перевірки сертифікатів. **--tls-crl-file** *CRL-file* Повна назва файлу, що містить відкликані сертифікати. **--tls-agent-cert-issuer** *cert-issuer* Дозволений видавець сертифікатів агента. **--tls-agent-cert-subject** *cert-subject* Дозволений суб'єкт сертифіката агента. **--tls-cert-file** *cert-file* Повне ім'я файлу, що містить сертифікат або ланцюжок сертифікатів. **--tls-key-file** *key-file* Повний шлях до файлу, що містить закритий ключ. **--tls-psk-identity** *PSK-identity* Рядок PSK-ідентифікатора. **--tls-psk-file** *PSK-file* Повна назва файлу, що містить попередньо наданий ключ. **--tls-cipher13** *cipher-string* Рядок шифру для OpenSSL 1.1.1 або новішої версії для TLS 1.3. Замінити критерії вибору набору шифрів за замовчуванням. Ця опція недоступна, якщо Версія OpenSSL менша за 1.1.1. **--tls-cipher** *cipher-string* Рядок пріоритету GnuTLS (для TLS 1.2 і вище) або рядок шифру OpenSSL (тільки для TLS 1.2). Перевизначає критерії вибору набору шифрів за замовчуванням. **-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести інформацію про версію і вийти. [ ]{#lbAG} ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-server-cert-issuer** *cert-issuer* Allowed server certificate issuer. **--tls-server-cert-subject** *cert-subject* Allowed server certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-v**, **--verbose** Verbose mode, **-vv** for more details. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **unencrypted** підключення без шифрування (за замовчуванням) ```{=html} <!-- --> ``` **psk** підключитися за допомогою TLS і спільного ключа ```{=html} <!-- --> ``` **cert** підключитися за допомогою TLS і сертифіката ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Повний шлях до файлу, що містить сертифікати ЦС верхнього рівня для перевірки однорангових сертифікатів. **--tls-crl-file** *CRL-file* Повний шлях до файлу, що містить анульовані сертифікати. **--tls-server-cert-issuer** *cert-issuer* Дозволений емітент сертифіката сервера. **--tls-server-cert-subject** *cert-subject* Дозволена тема сертифіката сервера. **--tls-cert-file** *cert-file* Повний шлях до файлу, що містить сертифікат або ланцюжок сертифікатів. **--tls-key-file** *key-file* Повний шлях до файлу, що містить закритий ключ. **--tls-psk-identity** *PSK-identity* Рядок ідентифікатора PSK. **--tls-psk-file** *PSK-file* Повний шлях до файлу, що містить попередній спільний ключ. **--tls-cipher13** *cipher-string* Рядок шифру для OpenSSL 1.1.1 або новішої версії для TLS 1.3. Замінити критерії вибору набору шифрів за замовчуванням. Ця опція недоступна, якщо версія OpenSSL не перевищує 1.1.1. **--tls-cipher** *cipher-string* Рядок пріоритету GnuTLS (для TLS 1.2 і вище) або рядок шифру OpenSSL (лише для TLS 1.2). Замінити критерії вибору набору шифрів за замовчуванням. **-v**, **--verbose** Детальний режим, **-vv** для отримання додаткової інформації. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Виведіть інформацію про версію та вийдіть. [ ]{#lbAG} #### Unlinking templates Unlink a template from two hosts and delete all of the templated entities. Request: ```json { "jsonrpc": "2.0", "method": "host.massremove", "params": { "hostids": ["69665", "69666"], "templateids_clear": "325" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### Роз'єднання шаблонів Від’єднайте шаблон від двох хостів і видаліть усі шаблонні сутності. Запит: ```json { "jsonrpc": "2.0", "method": "host.massremove", "params": { "hostids": ["69665", "69666"], "templateids_clear": "325" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### Updating an item Enable an item, that is, set its status to "0": ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "10092", "status": 0 }, "auth": "0424bd59b807674191e7d77572075f33", "id": 5 } ``` A successful response will contain the ID of the updated item: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 5 } ``` ::: notetip The `item.update` method as well as other update methods can also accept arrays of objects and update multiple items with one API call. ::: #### Оновлення елемента даних Увімкніть елемент, встановивши для нього статус "0": ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "10092", "status": 0 }, "auth": "0424bd59b807674191e7d77572075f33", "id": 5 } ``` Успішна відповідь міститиме ідентифікатор оновленого елемента: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 5 } ``` ::: notetip Метод item.update, а також інші *методи оновлення* також може приймати масиви об’єктів і оновлювати кілька елементів одним викликом API. ::: #### Updating dashboard pages Rename the first dashboard page, replace widgets on the second dashboard page and add a new page as the third one. Delete all other dashboard pages. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "pages": [ { "dashboard_pageid": 1, "name": 'Renamed Page' }, { "dashboard_pageid": 2, "widgets": [ { "type": "clock", "x": 0, "y": 0, "width": 4, "height": 3 } ] }, { "display_period": 60 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 2 } ``` #### Оновлення сторінок панелі інструментів Перейменуйте першу сторінку інформаційної панелі, замініть віджети на другій сторінці інформаційної панелі та додайте нову сторінку як третю. Видаліть усі інші сторінки інформаційної панелі. Запит: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "pages": [ { "dashboard_pageid": 1, "name": 'Renamed Page' }, { "dashboard_pageid": 2, "widgets": [ { "type": "clock", "x": 0, "y": 0, "width": 4, "height": 3 } ] }, { "display_period": 60 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 2 } ``` #### Updating LLD rule preprocessing options Update an LLD rule with preprocessing rule “JSONPath”. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "44211", "preprocessing": [ { "type": 12, "params": "$.path.to.json", "error_handler": 2, "error_handler_params": "5" } ] }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Оновлення параметрів попередньої обробки правила LLD Оновіть правило LLD за допомогою правила попередньої обробки «JSONPath». Запит: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "44211", "preprocessing": [ { "type": 12, "params": "$.path.to.json", "error_handler": 2, "error_handler_params": "5" } ] }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Updating LLD rule script Update an LLD rule script with a different script and remove unnecessary parameters that were used by previous script. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "23865", "parameters": [], "script": "Zabbix.Log(3, 'Log test');\nreturn 1;" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Оновлення сценарію правила LLD Оновіть сценарій правила LLD іншим сценарієм і видаліть непотрібні параметри, які використовувалися попереднім сценарієм. Запит: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "23865", "parameters": [], "script": "Zabbix.Log(3, 'Log test');\nreturn 1;" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Updating multiple triggers Enable multiple triggers, that is, set their status to 0: ```json { "jsonrpc": "2.0", "method": "trigger.update", "params": [ { "triggerid": "13938", "status": 0 }, { "triggerid": "13939", "status": 0 } ], "auth": "0424bd59b807674191e7d77572075f33", "id": 6 } ``` A successful response will contain the IDs of the updated triggers: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938", "13939" ] }, "id": 6 } ``` ::: notetip This is the preferred method of updating. Some API methods like `host.massupdate` allow to write more simple code, but it's not recommended to use those methods, since they will be removed in the future releases. ::: #### Оновлення кількох тригерів Увімкніть кілька тригерів, встановивши для них статус "0": ```json { "jsonrpc": "2.0", "method": "trigger.update", "params": [ { "triggerid": "13938", "status": 0 }, { "triggerid": "13939", "status": 0 } ], "auth": "0424bd59b807674191e7d77572075f33", "id": 6 } ``` Успішна відповідь міститиме ідентифікатори оновлених тригерів: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938", "13939" ] }, "id": 6 } ``` ::: notetip Це найкращий метод оновлення. Деякі методи API, такі як `host.massupdate`, дозволяють писати простіший код. Однак не рекомендується використовувати ці методи, оскільки їх буде видалено в наступних випусках. ::: #### Updating problems The problem update popup allows to: - comment on the problem - view comments and actions so far - change problem severity - acknowledge/unacknowledge problem - manually close problem {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Problem*|If only one problem is selected, the problem name is displayed.<br>If several problems are selected, *N problems selected* is displayed.| |*Message*|Enter text to comment on the problem (maximum 2048 characters).| |*History*|Previous activities and comments on the problem are listed, along with the time and user details.<br>For the meaning of icons used to denote user actions see the [event detail](/manual/web_interface/frontend_sections/monitoring/problems#viewing_details) page.<br>Note that history is displayed if only one problem is selected for the update.| |*Scope*|Define the scope of such actions as changing severity, acknowledging or manually closing problems:<br>**Only selected problem** - will affect this event only<br>**Selected and all other problems of related triggers** - in case of acknowledgment/closing problem, will affect this event and all other problems that are not acknowledged/closed so far. If the scope contains problems already acknowledged or closed, these problems will not be acknowledged/closed repeatedly. On the other hand, the number of message and severity change operations are not limited.| |*Change severity*|Mark the checkbox and click on the severity button to update problem severity.<br>The checkbox for changing severity is available if read-write permissions exist for at least one of the selected problems. Only those problems that are read-writable will be updated when clicking on *Update*.<br>If read-write permissions exist for none of the selected triggers, the checkbox is disabled.| |*Acknowledge*|Mark the checkbox to acknowledge the problem.<br>This checkbox is available if there is at least one unacknowledged problem among the selected.<br>It is not possible to add another acknowledgment for an already acknowledged problem (it is possible to add another comment though).| |*Unacknowledge*|Mark the checkbox to unacknowledge the problem.<br>This checkbox is available if there is at least one acknowledged problem among the selected.| |*Close problem*|Mark the checkbox to manually close the selected problem(s).<br>The checkbox for closing a problem is available if the *Allow manual close* option is checked in [trigger configuration](/manual/config/triggers/trigger) for at least one of the selected problems. Only those problems will be closed that are allowed to be closed when clicking on *Update*.<br>If no problem is manually closeable, the checkbox is disabled.<br>Already closed problems will not be closed repeatedly.| #### Проблеми з оновленням Спливаюче вікно оновлення проблеми дозволяє: - прокоментувати проблему - переглянути коментарі та дії на даний момент - змінити ступінь серйозності проблеми - підтвердити/непідтвердити проблему - закрити проблему вручну {width="600"} Усі обов’язкові поля для введення позначені червоною зірочкою. |Параметр|Опис| |--|--------| |*Проблема*|Якщо вибрано лише одну проблему, відображається назва проблеми.<br>Якщо вибрано декілька проблем, відображається *N проблем вибрано*.| |*Повідомлення*|Введіть текст для коментаря до проблеми (максимум 2048 символів).| |*Історія*|Наведено список попередніх дій і коментарів щодо проблеми разом із часом і деталями користувача.<br>Значення піктограм, які використовуються для позначення дій користувача, див. у [деталі події (/manual/web_interface/frontend_sections/monitoring /problems#viewing_details).<br>Зауважте, що історія відображається, якщо для оновлення вибрано лише одну проблему.| |*Область*|Визначте область таких дій, як зміна серйозності, підтвердження чи закриття проблем вручну:<br>**Тільки вибрана проблема** – вплине лише на цю подію<br>**Вибрані та всі інші проблеми пов’язаних тигерів** - у разі проблеми з підтвердженням/закриттям, це вплине на цю подію та всі інші проблеми, які наразі не підтверджені/закриті. Якщо область містить уже підтверджені або вирішені проблеми, ці проблеми не будуть визнаватися/закриватися повторно. З іншого боку, кількість операцій зміни повідомлень і серйозності не обмежена.| |*Змінити серйозність*|Поставте прапорець і натисніть кнопку серйозності, щоб оновити серйозність проблеми.<br>Прапорець для зміни серйозності доступний, якщо є дозволи на читання та запис принаймні для однієї з вибраних проблем. Лише ті проблеми, які доступні для читання та запису, будуть оновлені після натискання *Оновити*.<br>Якщо дозволи на читання та запис не існують для жодного з вибраних тригерів, прапорець буде вимкнено.| |*Підтвердити*|Поставте прапорець, щоб підтвердити проблему.<br>Цей прапорець доступний, якщо серед вибраних є принаймні одна непідтверджена проблема.<br>Неможливо додати ще одне підтвердження для вже підтвердженої проблеми (вона але можна додати ще один коментар).| |*Зняти підтвердження*|Позначте поле, щоб скасувати підтвердження проблеми.<br>Цей прапорець доступний, якщо серед вибраних є принаймні одна підтверджена проблема.| |*Закрити проблему*|Поставте прапорець, щоб вручну закрити вибрану(і) проблему(и).<br>Прапорець для закриття проблеми доступний, якщо опцію *Дозволити закриття вручну* позначено в [конфігурації тригера](/manual/config /triggers/trigger) принаймні для однієї з вибраних проблем. Буде закрито лише ті проблеми, які дозволено закрити, натиснувши *Оновити*.<br>Якщо жодну проблему не можна закрити вручну, прапорець вимкнено.<br>Уже закриті проблеми не будуть закриті повторно.| #### Use cases #### Варіанти використання #### user Changes:\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) added new method `user.unblock`.\ [ZBXNEXT-4029](https://support.zabbix.com/browse/ZBXNEXT-4029) `user.create`, `user.update`: implemented password strength validation according the password policy.\ #### користувач Зміни:\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) додано новий метод `user.unblock`.\ [ZBXNEXT-4029](https://support.zabbix.com/browse/ZBXNEXT-4029) `user.create`, `user.update`: реалізовано перевірку надійності пароля відповідно до політики паролів.\ #### user Changes:\ [ZBXNEXT-7971](https://support.zabbix.com/browse/ZBXNEXT-7971) `user.create`, `user.update`: increased max length of the "url" field to 2048 characters.\ #### користувач Зміни:\ [ZBXNEXT-7971](https://support.zabbix.com/browse/ZBXNEXT-7971) `user.create`, `user.update`: максимальну довжину поля "url" збільшено до 2048 символів.\ #### user Changes:\ [ZBXNEXT-8012](https://support.zabbix.com/browse/ZBXNEXT-8012) `user.checkAuthentication`: added new parameter `token`.\ #### користувач Зміни:\ [ZBXNEXT-8012](https://support.zabbix.com/browse/ZBXNEXT-8012) `user.checkAuthentication`: додано новий параметр `token`.\ #### usergroup Changes:\ [ZBXNEXT-6866](https://support.zabbix.com/browse/ZBXNEXT-6866) `usergroup.create`, `usergroup.update`: `userids` parameter is now deprecated. Use `users` instead.\ #### група користувачів Зміни:\ [ZBXNEXT-6866](https://support.zabbix.com/browse/ZBXNEXT-6866) `usergroup.create`, `usergroup.update`: параметр `userids` більше не підтримується. Замість цього використовуйте `users`.\ #### User permission check Does the user have permission to write to hosts whose names begin with "MySQL" or "Linux" ? Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "countOutput": true, "search": { "host": ["MySQL", "Linux"] }, "editable": true, "startSearch": true, "searchByAny": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "0", "id": 1 } ``` ::: noteclassic Zero result means no hosts with read/write permissions. ::: #### Перевірка прав користувача Чи має користувач дозвіл записувати на хости, імена яких починаються з "MySQL" або "Linux"? Запит: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "countOutput": true, "search": { "host": ["MySQL", "Linux"] }, "editable": true, "startSearch": true, "searchByAny": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": "0", "id": 1 } ``` ::: noteclassic Нульовий результат означає відсутність хостів з дозволами на читання/запис. ::: #### Using a custom expression filter Create a correlation that will use a custom filter condition. The formula IDs "A" or "B" have been chosen arbitrarily. Condition type will be "Host group" with operator "<>". Request: ```json { "jsonrpc": "2.0", "method": "correlation.create", "params": { "name": "new host group correlation", "description": "a custom description", "status": 0, "filter": { "evaltype": 3, "formula": "A or B", "conditions": [ { "type": 2, "operator": 1, "formulaid": "A" }, { "type": 2, "operator": 1, "formulaid": "B" } ] }, "operations": [ { "type": 1 } ] }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "2" ] }, "id": 1 } ``` #### Використання спеціального фільтра виразів Створіть кореляцію, яка використовуватиме спеціальну умову фільтра. Ідентифікатори формул "A" або "B" вибрано довільно. Тип умови буде «Група хостів» з оператором «<>». Запит: ```json { "jsonrpc": "2.0", "method": "correlation.create", "params": { "name": "new host group correlation", "description": "a custom description", "status": 0, "filter": { "evaltype": 3, "formula": "A or B", "conditions": [ { "type": 2, "operator": 1, "formulaid": "A" }, { "type": 2, "operator": 1, "formulaid": "B" } ] }, "operations": [ { "type": 1 } ] }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "2" ] }, "id": 1 } ``` #### Using a custom expression filter Create an LLD rule with a filter that will use a custom expression to evaluate the conditions. The LLD rule must only discover objects the "{\#MACRO1}" macro value of which matches both regular expression "regex1" and "regex2", and the value of "{\#MACRO2}" matches either "regex3" or "regex4". The formula IDs "A", "B", "C" and "D" have been chosen arbitrarily. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Filtered LLD rule", "key_": "lld", "hostid": "10116", "type": 0, "interfaceid": "13", "delay": "30s", "filter": { "evaltype": 3, "formula": "(A and B) and (C or D)", "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1", "formulaid": "A" }, { "macro": "{#MACRO1}", "value": "@regex2", "formulaid": "B" }, { "macro": "{#MACRO2}", "value": "@regex3", "formulaid": "C" }, { "macro": "{#MACRO2}", "value": "@regex4", "formulaid": "D" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Використання спеціального фільтра виразів Створіть правило LLD із фільтром, який використовуватиме спеціальний вираз для оцінки умов. Правило LLD має виявляти лише об’єкти, значення макросу «{\#MACRO1}» якого відповідає регулярним виразам «regex1» і «regex2», а значення «{\#MACRO2}» відповідає «regex3» або «regex4». ". Ідентифікатори формул «A», «B», «C» і «D» вибрано довільно. Запит: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Filtered LLD rule", "key_": "lld", "hostid": "10116", "type": 0, "interfaceid": "13", "delay": "30s", "filter": { "evaltype": 3, "formula": "(A and B) and (C or D)", "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1", "formulaid": "A" }, { "macro": "{#MACRO1}", "value": "@regex2", "formulaid": "B" }, { "macro": "{#MACRO2}", "value": "@regex3", "formulaid": "C" }, { "macro": "{#MACRO2}", "value": "@regex4", "formulaid": "D" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Using a custom expression filter Create a trigger action that will use a custom filter condition. The action must send a message for each trigger with severity higher or equal to "Warning" for hosts "10084" and "10106". The formula IDs "A", "B" and "C" have been chosen arbitrarily. Request: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "status": 0, "esc_period": "2m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "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" } } ], "pause_suppressed": "0", "notify_if_canceled": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Використання спеціального фільтра виразів Створіть дію тригера, яка використовуватиме спеціальну умову фільтра. Дія має надсилати повідомлення для кожного тригера з серйозністю, вищою або рівною "Попередження" для хостів "10084" і "10106". Ідентифікатори формул "A", "B" і "C" вибрано довільно. Запит: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "status": 0, "esc_period": "2m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "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" } } ], "pause_suppressed": "0", "notify_if_canceled": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Using a filter Create an LLD rule with a set of conditions to filter the results by. The conditions will be grouped together using the logical "and" operator. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Filtered LLD rule", "key_": "lld", "hostid": "10116", "type": 0, "interfaceid": "13", "delay": "30s", "filter": { "evaltype": 1, "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1" }, { "macro": "{#MACRO2}", "value": "@regex2", "operator": "9" }, { "macro": "{#MACRO3}", "value": "", "operator": "12" }, { "macro": "{#MACRO4}", "value": "", "operator": "13" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Використання фільтра Створіть правило LLD із набором умов для фільтрації результатів. Умови будуть згруповані разом за допомогою логічного оператора "and". Запит: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Filtered LLD rule", "key_": "lld", "hostid": "10116", "type": 0, "interfaceid": "13", "delay": "30s", "filter": { "evaltype": 1, "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1" }, { "macro": "{#MACRO2}", "value": "@regex2", "operator": "9" }, { "macro": "{#MACRO3}", "value": "", "operator": "12" }, { "macro": "{#MACRO4}", "value": "", "operator": "13" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` ##### Using filter You can use the filter to display only the services you are interested in. ##### Використання фільтра Ви можете використовувати фільтр для відображення лише тих послуг, які вас цікавлять. #### valuemap Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `valuemap.update`: the parameter `uuid` can now be updated.\ #### карта значень Зміни:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `valuemap.update`: тепер можна оновити параметр `uuid`.\ #### View mode buttons The following buttons located in the top right corner are common for every section: | | | |--|--------| ||Display page in kiosk mode. In this mode only page content is displayed.<br>To exit kiosk mode, move the mouse cursor until the  exit button appears and click on it. You will be taken back to normal mode.| #### Кнопки режиму перегляду Наступні кнопки, розташовані у верхньому правому куті, є загальними для кожного розділу: | | | |--|--------| ||Відображати сторінку в режимі кіоску. У цьому режимі відображається лише вміст сторінки.<br>Щоб вийти з режиму кіоску, перемістіть курсор миші до  з’явиться кнопка виходу та натисніть її. Ви повернетеся до звичайного режиму.| # > Web scenario object The following objects are directly related to the `webcheck` API. # > Об'єкт веб-сценарію Наступні об’єкти безпосередньо пов’язані з API 'webcheck'. ### Web server hardening ### Зміцнення веб-серверу ##### Windows Use Zabbix Windows agent included (pre-compiled) into Zabbix distribution. ##### Windows Використовуйте агент Zabbix для Windows включений (попередньо скомпільований) в дистрибутив Zabbix. #### Working with the menu A [global search](/manual/web_interface/global_search) box is located below the Zabbix logo. The menu can be collapsed or hidden completely: - To collapse, click on  next to Zabbix logo - To hide, click on  next to Zabbix logo | | | |---|---| ||| |Collapsed menu with only the icons visible.|Hidden menu.| #### Робота з меню Поле [глобального пошуку](/manual/web_interface/global_search) розташоване під логотипом Zabbix. Меню можна згорнути або повністю приховати: - Щоб згорнути, натисніть на  поруч із логотипом Zabbix - Щоб приховати, натисніть на  поруч із Логотип Zabbix | | | |---|---| ||| |Згорнуте меню з видимими лише значками.|Приховане меню.| # zabbix\_agent2 Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_agent2 Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Індекс](#index) [Повернутися до основного вмісту](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_agentd Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_agentd Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Індекс](#index) [Повернутися до основного вмісту](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # Zabbix API changes in 6.0 # Зміни API Zabbix у версії 6.0 # Zabbix documentation 6.0 These pages contain official Zabbix documentation. Use the sidebar navigation to browse documentation pages. To be able to watch pages, log in with your [Zabbix forums](http://www.zabbix.com/forum/) username and password. # Документація Zabbix 6.0 Ці сторінки містять офіційну документацію Zabbix. Використовуйте навігацію на бічній панелі, щоб переглядати сторінки документації. Щоб мати можливість переглядати сторінки, увійдіть, використовуючи своє ім’я користувача та пароль [на форумах Zabbix](http://www.zabbix.com/forum/). # zabbix\_get Section: User Commands (1)\ Updated: 2021-06-01\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_get Розділ: Команди користувача (1)\ Оновлено: 01.06.2021\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_js Section: User Commands (1)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_js Розділ: Команди користувача (1)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # Zabbix manpages These are Zabbix manpages for Zabbix processes. # Сторінки довідки Zabbix Це сторінки довідки Zabbix для процесів Zabbix. # Zabbix Manual Welcome to the user manual for Zabbix software. These pages are created to help users successfully manage their monitoring tasks with Zabbix, from the simple to the more complex ones. # Посібник Zabbix Ласкаво просимо до посібника користувача програмного забезпечення Zabbix. Ці сторінки створені, щоб допомогти користувачам успішно керувати своїми завданнями моніторингу за допомогою Zabbix, від простих до складніших. # zabbix\_proxy Section: Maintenance Commands (8)\ Updated: 2020-09-04\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_proxy Розділ: Команди обслуговування (8)\ Оновлено: 04.09.2020\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_sender Section: User Commands (1)\ Updated: 2021-06-01\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_sender Розділ: Команди користувача (1)\ Оновлено: 01.06.2021\ [Зміст](#index) [Повернутися до основного вмісту](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_server Section: Maintenance Commands (8)\ Updated: 2020-09-04\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_server Розділ: Команди обслуговування (8)\ Оновлено: 04.09.2020\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_web\_service Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_web\_service Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} ### ### # 11 Time zones # 11 Часові пояси # 13. Problem acknowledgment # 13. Підтвердження проблеми # 14. Configuration export/import # 14. Експорт/імпорт конфігурації # 18. Web interface # 18. Веб-інтерфейс # 19 API # 19. API # 1 Action log # 1 Журнал дій # 1 Database creation # 1 Створення бази даних # 1 Foreach functions # 1 Функції Foreach # 1 Global notifications # 1 Глобальні сповіщення # 1 High availability # 1 Висока доступність # 1 Introduction Please use the sidebar to access content in the Introduction section. # 1. Вступ Будь ласка, використовуйте бічну панель, щоб отримати доступ до вмісту вступного розділу. # 1 Login and configuring user # 1 Вхід і налаштування користувача # 1 Manual structure # 1 Структура посібника # 1 Menu # 1 Меню # 1 Problem suppression # 1 Приховування проблеми # 1 Web monitoring items # 1 Елементи веб-моніторингу # 2 Frontend sections # 2 Інтерфейсні розділи # 2 New host # 2 Новий вузол мережі # 2 Passive and active agent checks # 2 Passive and active agent checks # 2 Real-life scenario # 2 Реальний сценарій # 2 Repairing Zabbix database character set and collation # 2 Відновлення набору символів і сортування бази даних Zabbix # 2 Sound in browsers # 2 Звук в браузерах # 3 Database upgrade to primary keys # 3 Оновлення бази даних до первинних ключів # 3 New item # 3 Новий елемент даних # 3 User settings # 3 Налаштування користувача # 4 New trigger # 4 Новий тригер # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 Zabbix agent 2 (UNIX) # 4 Zabbix агент 2 (UNIX) # 5 Frontend maintenance mode # 5 Режим обслуговування інтерфейсу # 5 Quickstart Please use the sidebar to access content in the Quickstart section. # 5. Швидкий початок Будь ласка, використовуйте бічну панель для доступу до вмісту в розділі швидкого початку. # 5 Receiving problem notification # 5 Отримання повідомлення про проблему # 5 TimescaleDB setup # 5 Налаштування TimescaleDB # 6 Action log # 6 Журнал дій # 6 New template # 6 Новий шаблон # 6 Page parameters # 6 Параметри сторінки # 6 Zabbix appliance # 6. Готове рішення Zabbix # 7 Configuration Please use the sidebar to access content in the Configuration section. # 7 Конфігурація Будь ласка, використовуйте бічну панель для доступу до вмісту розділу Конфігурація. # 8 Creating your own theme # 8 Створення власної теми # 9 Zabbix web service # 9 Веб-сервіс Zabbix # action.create # action.create # action.delete # action.delete # action.get # action.get # > Action object The following objects are directly related to the `action` API. # > Об'єкт дії Наступні об’єкти безпосередньо пов’язані з `action` API. # Actions Actions are responsible for 'business logic' of the module. An action usually consists of a [controller](#controller) and an [action view](views#action-view). A module can: - Call actions that are already defined in Zabbix frontend. - Override default actions with custom actions. - Define completely new actions. To override a default action behavior with some custom behavior, define an action with the same name in the module configuration. When the action is called, the module action will be executed instead of the default Zabbix action. Action files should be stored in the *actions* folder. The actions need to be specified in the [manifest.json](manifest). # Actions Дії відповідають за «бізнес-логіку» модуля. Зазвичай дія складається з [контролера](#controller) і [перегляду дії](views#action-view). Модуль може: - Викликати дії, які вже визначені у інтерфейсі Zabbix. - Замінювати дії за замовчуванням власними діями. - Визначати абсолютно нові дії. Щоб замінити поведінку дій за замовчуванням на якусь настроювану поведінку, визначте дію з такою самою назвою в конфігурації модуля. Під час виклику дії буде виконано дію модуля замість типової дії Zabbix. Файли дій повинні зберігатися в папці *actions*. Дії потрібно вказати в [manifest.json](маніфест). ### actions Actions to register with the module. Defining *class* object key for each action is required, other action keys are optional. *Type*: Object Supported object keys if *[type](#type)* is *module*: - **write.your.action.name** (object) - action name, should be written in lowercase [a-z], separating words with dots. Supports the keys: - **class** (string; required) - action class name. - **layout** (string) - action layout. Supported values: *layout.json*, *layout.htmlpage* (default), *null*. - **view** (string) - action view. *Example*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` Supported object keys if *[type](#type)* is *widget*: - **widget.{id}.view** (object) - file and class name for widget view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.view*). Supports the keys: - **class** (string; required) - action class name for widget view mode to extend the default CControllerDashboardWidgetView class. The class source file must be located in the *actions* directory. - **view** (string) - widget view. Must be located in the *views* directory. If the view file is *widget.view.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. - **widget.{id}.edit** (object) - file name for widget configuration view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.edit*). Supports the keys: - **class** (string; required) - action class name for widget configuration view mode. The class source file must be located in the *actions* directory. - **view** (string) - widget configuration view. Must be located in the *views* directory. If the view file is *widget.edit.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. *Example*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ``` ### actions Дії для реєстрації в модулі. Необхідно визначити ключ об’єкта *class* для кожної дії, інші ключі дії необов’язкові. *Тип*: Object Підтримувані ключі об’єктів, якщо *[type](#type)* є *module*: - **write.your.action.name** (object) - назва дії, має бути написано малими літерами [a-z], розділяючи слова крапками. Підтримує ключі: - **class** (string; required) - назва класу дії. - **layout** (string) - розкладка дії. Підтримувані значення: *layout.json*, *layout.htmlpage* (за замовчуванням), *null*. - **view** (string) - представлення дії. *Приклад*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` Підтримувані ключі об’єктів, якщо *[type](#type)* є *widget*: - **widget.{id}.view** (object) - ім'я файлу та класу для представлення віджетів. Замініть **{id}** значенням [id](#id) віджета (наприклад, *widget.example_clock.view*). Підтримує ключі: - **class** (string; required) - ім'я класу дії для режиму перегляду віджетів для розширення стандартного класу CControllerDashboardWidgetView. Вихідний файл класу має бути розташований у каталозі *actions*. - **view** (string) - представлення віджета. Повинен знаходитися в каталозі *views*. Якщо файл представлення *widget.view.php*, що очікується за замовчуванням, цей параметр може бути пропущений. Якщо ви використовуєте інше ім’я, вкажіть його тут. - **widget.{id}.edit** (object) - ім'я файлу для представлення конфігурації віджета. Замініть **{id}** значенням [id](#id) віджета (наприклад, *widget.example_clock.edit*). Підтримує ключі: - **class** (string; required) - назва класу дії для режиму представлення конфігурації віджета. Вихідний файл класу має бути розташований у каталозі *actions*. - **view** (string) - представлення конфігурації віджета. Повинен знаходитися в каталозі *views*. Якщо файл представлення *widget.edit.php*, що очікується за замовчуванням, цей параметр може бути пропущений. Якщо ви використовуєте інше ім’я, вкажіть його тут. *Приклад*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ``` # Action This class is designed to work with actions. Object references:\ - [Action](/manual/api/reference/action/object#action) - [Action condition](/manual/api/reference/action/object#action_condition) - [Action operation](/manual/api/reference/action/object#action_operation) Available methods:\ - [action.create](/manual/api/reference/action/create) - create new actions - [action.delete](/manual/api/reference/action/delete) - delete actions - [action.get](/manual/api/reference/action/get) - retrieve actions - [action.update](/manual/api/reference/action/update) - update actions # Дія Цей клас призначений для роботи з діями. Посилання на об'єкти:\ - [Дія](/manual/api/reference/action/object#action) - [Умова дії](/manual/api/reference/action/object#action_condition) - [Операція дії](/manual/api/reference/action/object#action_operation) Доступні методи:\ - [action.create](/manual/api/reference/action/create) - створювати нові дії - [action.delete](/manual/api/reference/action/delete) - дії видалення - [action.get](/manual/api/reference/action/get) - отримати дії - [action.update](/manual/api/reference/action/update) - оновлення дій # action.update # action.update ### Action view This is a reference file for defining an action view. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ```` ### Action view Це довідковий файл для створення Action view. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ```` #### action [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) Added new property `pause_symptoms`.\ #### action [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) Додано нову властивість `pause_symptoms`.\ ##### Add a blank module to Zabbix frontend 1. Create a directory *MyAddress* in the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). 2. Create a *manifest.json* file with basic module metadata (see the description of supported [parameters](../file_structure/manifest)). **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "My External IP Address" } ``` 3. In Zabbix frontend, go to *Administration → General → Modules* section and click on the *Scan directory* button.  4. Locate the new module *My IP Address* in the list and click on the "Disabled" hyperlink to change the module's status from "Disabled" to "Enabled". {width="600"} The module is now registered in the frontend. However, it is not visible yet, because you still need to define the module functionality. Once you add content to the module directory, you will immediately see the changes in Zabbix frontend upon refreshing the page. ##### Додайте порожній модуль до інтерфейсу Zabbix 1. Створіть каталог *MyAddress* у каталозі *modules* вашої інсталяції web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). 2. Створіть файл *manifest.json* із базовими метаданими модуля (перегляньте опис підтримуваних [параметрів](../file_structure/manifest)). **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "Моя зовнішня IP-адреса" } ``` 3. У інтерфейсі Zabbix перейдіть до розділу *Адміністрування → Загальні → Модулі* та натисніть кнопку *Сканувати каталог*.  4. Знайдіть у списку новий модуль *Моя IP-адреса* та натисніть гіперпосилання «Дезактивовано», щоб змінити статус модуля з «Дезактивовано» на «Активовано». {width="600"} Тепер модуль зареєстровано у фронтенді. Однак його ще не видно, тому що вам ще потрібно визначити функціональність модуля. Після того, як ви додасте контент до каталогу модулів, ви одразу побачите зміни у фронтенді Zabbix при оновленні сторінки. ### Add a blank widget to Zabbix frontend 1. Create a directory *lesson_gauge_chart* in the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). ::: noteclassic All custom widgets are treated as external modules and must be added to the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). The directory *zabbix/ui/widgets* is reserved for Zabbix built-in widgets and gets updated along with Zabbix UI. ::: 2. Create a *manifest.json* file with basic widget metadata (see the description of supported [parameters](../file_structure/manifest)). **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix SIA" } ``` 3. In Zabbix frontend, go to *Administration → General → Modules* section and click on the *Scan directory* button.  4. Locate the new module *Gauge chart* in the list and click on the "Disabled" hyperlink to change the module's status from "Disabled" to "Enabled". {width="600"} 5. Open a dashboard, switch it to the edit mode and add a new widget. In the *Type* field, select "Gauge chart". {width="600"} 6. At this point, the *Gauge chart* widget configuration contains only common widget fields *Name* and *Refresh interval*. Click on *Add* to add the widget to the dashboard. {width="600"} 7. A blank widget should appear on the dashboard. Click on *Save changes* in the top right corner to save the dashboard. {width="600"} ### Додайте порожній віджет до інтерфейсу Zabbix 1. Створіть каталог *lesson_gauge_chart* у каталозі *modules* там де у вас встановлено web-інтерфейс Zabbix (наприклад, *zabbix/ui/modules*). ::: noteclassic Усі користувальницькі віджети розглядаються як зовнішні модулі та мають бути додані до каталогу *modules* вашого інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). Каталог *zabbix/ui/widgets* зарезервовано для вбудованих віджетів Zabbix і оновлюється разом із Zabbix UI. ::: 2. Створіть файл *manifest.json* із базовими метаданими віджетів (перегляньте опис підтримуваних [параметрів](../file_structure/manifest)). **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix SIA" } ``` 3. У інтерфейсі Zabbix перейдіть до розділу *Адміністрування → Загальні → Модулі* та натисніть кнопку *Сканувати директорію*.  4. Знайдіть новий модуль *Gauge chart* у списку та клацніть гіперпосилання «Дезактивовано», щоб змінити статус модуля з «Дезактивовано» на «Активовано». {width="600"} 5. Відкрийте інформаційну панель, переведіть її в режим редагування та додайте новий віджет. У полі *Тип* виберіть «Калібрувальна діаграма». {width="600"} 6. На цьому етапі конфігурація віджета *Gauge chart* містить лише загальні поля віджета *Name* і *Refresh interval*. Натисніть *Додати*, щоб додати віджет на інформаційну панель. {width="600"} 7. На інформаційній панелі має з’явитися порожній віджет. Натисніть *Зберегти зміни* у верхньому правому куті, щоб зберегти інформаційну панель. {width="600"} ### Add a widget view :::noteclassic The widget's **view** file should be located in the *views* directory (for this tutorial, *ui/modules/lesson_gauge_chart/views/*). If the file has the default name *widget.view.php*, you do not need to register it in the *manifest.json* file. If the file has a different name, specify it in the *actions/widget.lesson_gauge_chart.view* section of the [manifest.json](devel/modules/file_structure/manifest) file. ::: 1. Create a directory *views* in the *lesson_gauge_chart* directory. 2. Create a *widget.view.php* file in the *views* directory. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, 'Hello, world!') ) ->show(); ``` 3. Refresh the dashboard. The *Gauge chart* widget now displays "Hello, world!". {width="600"} ### Додавання view віджету :::noteclassic Файл **view** віджета має бути розташований у каталозі *views* (для цієї інструкції *ui/modules/lesson_gauge_chart/views/*). Якщо файл має назву за замовчуванням *widget.view.php*, вам не потрібно реєструвати його у файлі *manifest.json*. Якщо файл має іншу назву, укажіть її в розділі *actions/widget.lesson_gauge_chart.view* файлу [manifest.json](devel/modules/file_structure/manifest). ::: 1. Створіть каталог *views* у каталозі *lesson_gauge_chart*. 2. Створіть файл *widget.view.php* у каталозі *views*. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * View віджета Gauge chart. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->additem( new CTag('h1', true, 'Hello, world!') ) ->show(); ``` 3. Оновіть інформаційну панель. Віджет *Gauge chart* тепер відображає «Hello, world!». {width="600"} ### Add CSS styles to the widget In this section you will learn how to add custom CSS styles to make the widget look more appealing. 1. For widget styles, create a new directory *css* in the *assets* directory. 2. Create a *widget.css* file in the *assets/css* directory. To style widget elements, use the selector *div.dashboard-widget-{widget id}*. To configure CSS for the whole widget, use the selector *form.dashboard-widget-{widget id}* **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart .chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart .chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart .description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2; text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart { margin-top: 8px; } ``` 3. Open *manifest.json* and add the CSS file name (*widget.css*) to the array in the *assets/css* section. This will allow the CSS styles defined in *widget.css* to load with the dashboard page. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix SIA", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` 4. Refresh the dashboard page to see the finished version of the widget. {width="600"} ### Додайте CSS стилі до віджету У цьому розділі ви дізнаєтеся, як додати власні стилі CSS, щоб зробити віджет більш привабливим. 1. Для стилів віджетів створіть новий каталог *css* у каталозі *assets*. 2. Створіть файл *widget.css* у каталозі *assets/css*. Щоб стилізувати елементи віджета, використовуйте селектор *div.dashboard-widget-{widget id}*. Щоб налаштувати CSS для всього віджета, використовуйте селектор *form.dashboard-widget-{widget id}* **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart .chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart .chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart .description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2;text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart { margin-top: 8px; } ``` 3. Відкрийте *manifest.json* і додайте назву файлу CSS (*widget.css*) до масиву в розділі *assets/css*. Це дозволить стилям CSS, визначеним у *widget.css*, завантажуватись зі сторінкою інформаційної панелі. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "leson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix SIA", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` 4. Оновіть сторінку інформаційної панелі, щоб побачити готову версію віджета. {width="600"} ## Adding a module Open *Administration→General→Modules* page and press *Scan directory*.  Locate your module in the list and activate it. To activate a module, press on the *Disabled* hyperlink - the module's state will change to *Enabled*. Press on the module name to view additional information about the module, such as author, version, or short description (if defined in the manifest). ## Додавання модуля Відкрийте сторінку *Адміністрування→Загальні→Модулі* і натисніть *Сканувати дерикторію*.  Знайдіть свій модуль у списку та активуйте його. Щоб активувати модуль, натисніть на гіперпосилання *Дезактивовано* - стан модуля зміниться на *Активовно*. Натисніть назву модуля, щоб переглянути додаткову інформацію про модуль, наприклад автора, версію або короткий опис (якщо визначено в маніфесті). #### Adding item to template To add an item to the template, go to the item list for 'New host'. In *Data collection → 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 the item to. {width="600"} All mandatory input fields are marked with a red asterisk. - Click on *Copy*. If you now go to *Data collection* → *Templates*, 'New template' should have one new item in it. We will stop at one item only for now, but similarly you can add any other items, triggers or other entities to the template until it's a fairly complete set of entities for given purpose (monitoring OS, monitoring single application). #### Додавання елемента даних до шаблону Щоб додати елемент даних до шаблону, перейдіть до списку елементів для 'New host'. У *Збір даних → Хости* натисніть *Елементи* біля пункту 'New host'. Потім: - Поставте прапорець біля елементу даних 'CPU Load' у списку. - Натисніть *Копіювати* під списком. - Виберіть шаблон, до якого потрібно скопіювати елемент. {width="600"} Усі обов’язкові поля для введення позначені червоною зірочкою. - Натисніть *Копіювати*. Якщо ви зараз перейдете до *Збір даних* → *Шаблони*, у 'New template' має бути один новий елемент даних. Наразі ми зупинимося лише на одному елементі даних, але так само ви можете додати будь-які інші елементи даних, тригери чи інші сутності до шаблону, доки це не буде досить повний набір сутностей для певної мети (моніторинг ОС, моніторинг окремої програми). ##### Adding permissions By default, a new user has no permissions to access hosts and templates. 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 *Host permissions* tab to assign permissions to host groups. {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. {width="600"} In this pop-up, 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*. To grant permissions to templates, you will need to switch to the *Template permissions* tab and specify template groups. ::: noteimportant In Zabbix, access rights to hosts and templates 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'). У формі властивостей групи перейдіть на вкладку *Дозволи вузла мережі*, щоб призначити дозволи групам вузлів мережі. {width="600"} Цей користувач має мати доступ лише для читання до групи *серверів Linux*, тому натисніть *Вибрати* поруч із полем вибору групи вузлів мережі. {width="600"} У цьому спливаючому вікні встановіть прапорець поруч із 'Сервери Linux', а потім натисніть *Вибрати*. *Сервери Linux* повинні відображатися в полі вибору. Натисніть кнопку 'Читати', щоб встановити рівень дозволу, а потім натисніть *Додати*, щоб додати групу до списку дозволів. У формі властивостей групи користувачів натисніть *Оновити*. Щоб надати дозволи на шаблони, вам потрібно буде перейти на вкладку *Дозволи шаблону* та вказати групи шаблонів. ::: noteimportant У Zabbix права доступу до вузлів мережі і шаблонів призначаються [групам користувачів](/manual/config/users_and_usergroups/usergroup), а не окремим користувачам. ::: Готово! Ви можете спробувати увійти, використовуючи облікові дані нового користувача. #### Adding template To start working with templates, we must first create one. To do that, in *Data collection* → *Templates* click on *Create template*. This will present us with a template configuration form. {width="600"} 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. ***Template groups*** - Select one or several groups by clicking *Select* button. The template must belong to a group. ::: noteclassic Access permissions to template groups are assigned in the [user group](/manual/quickstart/login#adding-permissions) configuration on the **Template permissions** tab in the same way as host permissions. All access permissions are assigned to groups, not individual templates, that's why including the template into at least one group is mandatory. ::: When done, click *Add*. Your new template should be visible in the list of templates. You can also use the [filter](/manual/web_interface/frontend_sections/data_collection/templates#using-filter) to find your template. {width="600"} As you may see, the template is there, but it holds nothing in it - no items, triggers or other entities. #### Додавання шаблону Щоб почати працювати з шаблонами, ми повинні спочатку його створити. Для цього в *Збір даних* → *Шаблони* натисніть *Створити шаблон*. Це надасть нам форму конфігурації шаблону. {width="600"} Усі обов’язкові поля для введення позначені червоною зірочкою. Тут потрібно ввести наступні параметри: ***Назва шаблону*** - Введіть назву шаблону. Допускаються буквено-цифрові символи, пробіли та підкреслення. ***Групи шаблонів*** - Виберіть одну або кілька груп, натиснувши кнопку *Вибрати*. Шаблон має належати до групи. ::: noteclassic Права доступу до груп шаблонів призначаються в налаштуванні[групи користувачів](/manual/quickstart/login#adding-permissions) на вкладці **Дозволи шаблону** так само, як дозволи вузла мережі. Усі права доступу призначаються групам, а не окремим шаблонам, тому включення шаблону принаймні до однієї групи є обов’язковим. ::: Після завершення натисніть *Додати*. Ваш новий шаблон має бути видимим у списку шаблонів. Ви також можете скористатися [фільтром](/manual/web_interface/frontend_sections/data_collection/templates#using-filter), щоб знайти свій шаблон. {width="600"} Як ви можете бачити, шаблон відображається, але він не містить нічого - жодних елементів даних, тригерів чи інших сутностей. #### Adding trigger To configure a trigger for our item, go to *Data collection → Hosts*, find 'New host' and click on *Triggers* next to it and then on *Create trigger*. This presents us with a trigger definition 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. #### Додавання тригера Щоб налаштувати тригер для нашого елемента даних, перейдіть до *Збір даних → Хости*, знайдіть 'New host' і натисніть *Тригери* поруч із ним, а потім — *Створити тригер*. Це представляє нам форму визначення тригера.\  Важлива інформація для нашого тригера: *Ім'я* - Введіть *CPU load too high on 'New host' for 3 minutes* як значення. Це буде назва тригера, яка відображатиметься в списках та в інших місцях. *Вираз* - Введіть: avg(/New host/system.cpu.load,3m)>2 Це вираз тригера. Переконайтеся, що вираз введено правильно, до останнього символу. Ключ елемента даних тут (system.cpu.load) використовується для посилання на елемент даних. Цей конкретний вираз в основному говорить про те, що поріг проблеми перевищено, коли середнє значення навантаження ЦП протягом 3 хвилин перевищує 2. Ви можете дізнатися більше про [синтаксис виразів тригера](/manual/config/triggers/expression). Після завершення натисніть *Додати*. Новий тригер має з’явитися в списку тригерів. #### Adding user To view information about users, go to *Users → 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:  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'.  Усі обов’язкові поля для введення позначені червоною зірочкою. За замовчуванням для нових користувачів не визначено медіа (методи доставки сповіщень). Щоб створити його, перейдіть на вкладку 'Медіа' та натисніть *Додати*.  У цьому спливаючому вікні введіть електронну адресу користувача. Ви можете вказати період часу, протягом якого медіа буде активним (опис формату див. на сторінці [Специфікація періоду часу](/manual/appendix/time_period)), за замовчуванням медіа завжди активно. Ви також можете налаштувати рівні [серйозності тригера](/manual/config/triggers/severity), для яких медіа буде активним, але поки що залиште всі їх увімкненими. Натисніть *Додати*, щоб зберегти медіа, а потім перейдіть на вкладку 'Дозволи'. На вкладці 'Дозволи' обов’язкове поле *Роль*. Роль визначає, які елементи інтерфейсу користувач може переглядати та які дії йому дозволено виконувати. Натисніть Вибрати та виберіть одну з ролей зі списку. Наприклад, виберіть *Роль адміністратора*, щоб дозволити доступ до всіх розділів інтерфейсу Zabbix, окрім Адміністрування. Пізніше ви можете змінити дозволи або створити більше ролей користувачів. Після вибору ролі на тій же вкладці з’являться дозволи:  Натисніть *Додати* у формі властивостей користувача, щоб зберегти користувача. Новий користувач з’явиться в списку користувачів. {width="600"} ##### 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. ### Add JavaScript to the widget In this section, you will learn how to add Javascript elements to the widget. You will add: - A gauge chart made using JavaScript - to show at a glance if the latest value is normal or too high/too low. - An *Advanced configuration* section for optional parameters, such as color, minimum and maximum values, units and the *Description* field created earlier. 1. Create a *widget.edit.js.php* file in the *views* directory. JavaScript will be responsible for hiding optional fields behind the *Advanced configuration* checkbox and initializing the color picker in the configuration view. You can add it to the same directory as the configuration view. Since the JavaScript for the configuration view should be loaded with the form, you will need to include it into the *widget.edit.php* file as shown in the next steps. **ui/modules/lesson_gauge_chart/views/widget.edit.js.php** ```php <?php use Modules\LessonGaugeChart\Widget; ?> window.widget_lesson_gauge_chart_form = new class { init({color_palette}) { this._form = document.getElementById('widget-dialogue-form'); this._advanced_configuration = document.getElementById('adv_conf'); this._unit_select = document.getElementById('value_units'); this._unit_value = document.getElementById('value_static_units'); this._advanced_configuration.addEventListener('change', () => this.updateForm()); this._unit_select.addEventListener('change', () => this.updateForm()); colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } this.updateForm(); } updateForm() { const show_advanced_configuration = this._advanced_configuration.checked; for (const element of this._form.querySelectorAll('.js-advanced-configuration')) { element.style.display = show_advanced_configuration ? '' : 'none'; } this._unit_value.disabled = this._unit_select.value == <?= Widget::UNIT_AUTO ?>; } }; ``` 2. Create a *Widget.php* file in the main widget directory *lesson_gauge_chart* to create a new class *Widget*. The *Widget* class will extend the *CWidget* base class to add/override the default widget settings (in this case - translations). JavaScript, provided below, displays the string "No data" in case of missing data. The "No data" string is present in the Zabbix UI translation files. If there are any widget constants, it is recommended to also specify them in the *Widget* class. **ui/modules/lesson_gauge_chart/Widget.php** ```php <?php namespace Modules\LessonGaugeChart; use Zabbix\Core\CWidget; class Widget extends CWidget { public const UNIT_AUTO = 0; public const UNIT_STATIC = 1; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` 3. Open *includes/WidgetForm.php* and add the new fields: *Advanced configuration* (checkbox), *Color* (color picker), *Min* (numeric field), *Max* (numeric field), and *Units* (select). **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Modules\LessonGaugeChart\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldCheckBox, CWidgetFieldColor, CWidgetFieldMultiSelectItem, CWidgetFieldNumericBox, CWidgetFieldSelect, CWidgetFieldTextBox }; /** * Gauge chart widget form. */ class WidgetForm extends CWidgetForm { public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ->setFilterParameter('numeric', true) ) ->addField( new CWidgetFieldCheckBox('adv_conf', _('Advanced configuration')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ) ->addField( (new CWidgetFieldNumericBox('value_min', _('Min'))) ->setDefault(0) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldNumericBox('value_max', _('Max'))) ->setDefault(100) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldSelect('value_units', _('Units'), [ Widget::UNIT_AUTO => _x('Auto', 'history source selection method'), Widget::UNIT_STATIC => _x('Static', 'history source selection method') ]))->setDefault(Widget::UNIT_AUTO) ) ->addField( (new CWidgetFieldTextBox('value_static_units')) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 4. Open *views/widget.edit.php* and add the field visual components to the configuration view. The *addField()* method of the *CWidgetFormView* class takes a CSS class string as the second parameter. Add the *js-advanced-configuration* string to those fields and their labels, which should be hidden if *Advanced configuration* is not selected. To add a JavaScript file to the configuration view, use the *includeJsFile()* method. To add inline JavaScript, use the *addJavaScript()* method. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ use Zabbix\Widgets\Fields\CWidgetFieldGraphDataSet; $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (new CWidgetFormView($data)) ->addField( new CWidgetFieldMultiSelectItemView($data['fields']['itemid'], $data['captions']['items']['itemid']) ) ->addField( new CWidgetFieldCheckBoxView($data['fields']['adv_conf']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']), 'js-advanced-configuration' ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_min']), 'js-advanced-configuration' ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_max']), 'js-advanced-configuration' ) ->addItem([ $lefty_units->getLabel()->addClass('js-advanced-configuration'), (new CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ]))->addClass('js-advanced-configuration') ]) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']), 'js-advanced-configuration' ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('widget_lesson_gauge_chart_form.init('.json_encode([ 'color_palette' => CWidgetFieldGraphDataSet::DEFAULT_COLOR_PALETTE ], JSON_THROW_ON_ERROR).');') ->show(); ``` 5. Return to the dashboard, click on the gear icon in the widget to open the widget configuration form. The widget configuration form now contains a new *Advanced configuration* checkbox. {width="600"} 6. Mark the *Advanced configuration* checkbox to see additional widget configuration fields. Fill in the fields with values and select a widget color. {width="600"} 7. Click on *Apply* in the widget configuration form. Then click on *Save changes* in the top right corner to save the dashboard. 8. Open *actions/WidgetView.php* and update the controller. The **$this->fields_values** property now contains the values of all the *Advanced configuration* fields. Finalize the controller to enable passing the configuration and selected item value to the widget view. **ui/modules/lesson_gauge_chart/actions/WidgetView.php** ```php <?php namespace Modules\LessonGaugeChart\Actions; use API, CControllerDashboardWidgetView, CControllerResponseData; class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $db_items = API::Item()->get([ 'output' => ['itemid', 'value_type', 'name', 'units'], 'itemids' => $this->fields_values['itemid'], 'webitems' => true, 'filter' => [ 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT] ] ]); $history_value = null; if ($db_items) { $item = $db_items[0]; $history = API::History()->get([ 'output' => API_OUTPUT_EXTEND, 'itemids' => $item['itemid'], 'history' => $item['value_type'], 'sortfield' => 'clock', 'sortorder' => ZBX_SORT_DOWN, 'limit' => 1 ]); if ($history) { $history_value = convertUnitsRaw([ 'value' => $history[0]['value'], 'units' => $item['units'] ]); } } $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getName()), 'history' => $history_value, 'fields_values' => $this->fields_values, 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` 9. Open and modify *views/widget.view.php*. You need to create a container for the gauge chart, which you will draw in the next steps, and a container for the description. To pass values to JavaScript as a JSON object, use the *setVar()* method. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem([ (new CDiv())->addClass('chart'), $data['fields_values']['description'] ? (new CDiv($data['fields_values']['description']))->addClass('description') : null ]) ->setVar('history', $data['history']) ->setVar('fields_values', $data['fields_values']) ->show(); ``` 10. Create a new directory *assets* in the *lesson_gauge_chart* directory. This directory will be used for storing JavaScript, CSS, and potentially any other assets, such as fonts or images. 11. For widget view JavaScript, create a directory *js* in the *assets* directory. 12. Create a *class.widget.js* file in the *assets/js* directory. This JavaScript widget class will extend the base JavaScript class of all dashboard widgets - *CWidget*. The dashboard relies on a correct implementation of a widget and communicates any relevant information to the widget through calling the respective JavaScript methods. The dashboard also expects the widget to generate events when some interaction occurs. Thus, the *CWidget* class contains a set of methods with the default implementation of widget behavior, which can be customized by extending the class. In this case, some customization is necessary, therefore custom logic will be implemented for the following widget behavior: - widget initialization that is responsible for defining the initial state of the widget (see the *\_init()* method); - displaying widget contents (that is, drawing the gauge chart) if the widget update process has been successful and without errors (see the *\_processUpdateResponse(response)* method and the related *\_resizeChart()* and *\_updatedChart()* methods) - resizing the widget (see the *resize()* method and the related *\_resizeChart()* method) For other aspects of the gauge chart widget, the default implementation for widget behavior will be used. To learn more about the JavaScript methods of the *CWidget* class, see: [JavaScript](/devel/modules/widgets/presentation/javascript). Since this JavaScript is required for the widget view, it should be loaded with the dashboard page. To enable JavaScript loading, you will need to update the *assets/js* and *js_class* parameters of **manifest.json** as shown in the next step. **ui/modules/lesson_gauge_chart/assets/js/class.widget.js** ```js class WidgetLessonGaugeChart extends CWidget { static UNIT_AUTO = 0; static UNIT_STATIC = 1; _init() { super._init(); this._refresh_frame = null; this._chart_container = null; this._canvas = null; this._chart_color = null; this._min = null; this._max = null; this._value = null; this._last_value = null; this._units = ''; } _processUpdateResponse(response) { if (response.history === null) { this._value = null; this._units = ''; } else { this._value = Number(response.history.value); this._units = response.fields_values.value_units == WidgetLessonGaugeChart.UNIT_AUTO ? response.history.units : response.fields_values.value_static_units; } this._chart_color = response.fields_values.chart_color; this._min = Number(response.fields_values.value_min); this._max = Number(response.fields_values.value_max); if (this._canvas === null) { super._processUpdateResponse(response); this._chart_container = this._content_body.querySelector('.chart'); this._canvas = document.createElement('canvas'); this._chart_container.appendChild(this._canvas); this._resizeChart(); } else { this._updatedChart(); } } resize() { super.resize(); if (this._state === WIDGET_STATE_ACTIVE) { this._resizeChart(); } } _resizeChart() { const ctx = this._canvas.getContext('2d'); const dpr = window.devicePixelRatio; this._canvas.style.display = 'none'; const size = Math.min(this._chart_container.offsetWidth, this._chart_container.offsetHeight); this._canvas.style.display = ''; this._canvas.width = size * dpr; this._canvas.height = size * dpr; ctx.scale(dpr, dpr); this._canvas.style.width = `${size}px`; this._canvas.style.height = `${size}px`; this._refresh_frame = null; this._updatedChart(); } _updatedChart() { if (this._last_value === null) { this._last_value = this._min; } const start_time = Date.now(); const end_time = start_time + 400; const animate = () => { const time = Date.now(); if (time <= end_time) { const progress = (time - start_time) / (end_time - start_time); const smooth_progress = 0.5 + Math.sin(Math.PI * (progress - 0.5)) / 2; let value = this._value !== null ? this._value : this._min; value = (this._last_value + (value - this._last_value) * smooth_progress - this._min) / (this._max - this._min); const ctx = this._canvas.getContext('2d'); const size = this._canvas.width; const char_weight = size / 12; const char_shadow = 3; const char_x = size / 2; const char_y = size / 2; const char_radius = (size - char_weight) / 2 - char_shadow; const font_ratio = 32 / 100; ctx.clearRect(0, 0, size, size); ctx.beginPath(); ctx.shadowBlur = char_shadow; ctx.shadowColor = '#bbb'; ctx.strokeStyle = '#eee'; ctx.lineWidth = char_weight; ctx.lineCap = 'round'; ctx.arc(char_x, char_y, char_radius, Math.PI * 0.749, Math.PI * 2.251, false); ctx.stroke(); ctx.beginPath(); ctx.strokeStyle = `#${this._chart_color}`; ctx.lineWidth = char_weight - 2; ctx.lineCap = 'round'; ctx.arc(char_x, char_y, char_radius, Math.PI * 0.75, Math.PI * (0.75 + (1.5 * Math.min(1, Math.max(0, value)))), false ); ctx.stroke(); ctx.shadowBlur = 2; ctx.fillStyle = '#1f2c33'; ctx.font = `${(char_radius * font_ratio)|0}px Arial`; ctx.textAlign = 'center'; ctx.textBaseline = 'middle'; ctx.fillText(`${this._value !== null ? this._value : t('No data')}${this._units}`, char_x, char_y, size - char_shadow * 4 - char_weight * 2 ); ctx.fillStyle = '#768d99'; ctx.font = `${(char_radius * font_ratio * .5)|0}px Arial`; ctx.textBaseline = 'top'; ctx.textAlign = 'left'; ctx.fillText(`${this._min}${this._min != '' ? this._units : ''}`, char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight ); ctx.textAlign = 'right'; ctx.fillText(`${this._max}${this._max != '' ? this._units : ''}`, size - char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight ); requestAnimationFrame(animate); } else { this._last_value = this._value; } }; requestAnimationFrame(animate); } } ``` 13. Open *manifest.json* and add: - file name (*class.widget.js*) to the array in the *assets/js* section; - class name (*WidgetLessonGaugeChart*) to the *js_class* parameter in the *widget* section. The *WidgetLessonGaugeChart* class will now be automatically loaded with the dashboard. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix SIA", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "js": ["class.widget.js"] } } ``` ### Додайте JavaScript до віджету У цьому розділі ви дізнаєтеся, як додати до віджету елементи Javascript: Ви додасте: - Діаграма, створена за допомогою JavaScript, щоб відразу показати, чи є останнє значення нормальним або занадто високим/низьким. - Розділ *Розширена конфігурація* для додаткових параметрів, таких як колір, мінімальне і максимальне значення, одиниці виміру і поле *Опис*, створене раніше. 1. Створіть файл *widget.edit.js.php* в каталозі *views*. JavaScript відповідатиме за приховування необов'язкових полів за чекбоксом *Розширена конфігурація* та ініціалізацію піпетки кольорів у view конфігурації. Ви можете додати його до тієї самої директорії, що й view конфігурації. Оскільки JavaScript для view конфігурації повинен завантажуватися разом з формою, вам потрібно включити його в файл *widget.edit.php*, як показано на наступних кроках **ui/modules/lesson_gauge_chart/views/widget.edit.js.php** ```php <?php use Modules\LessonGaugeChart\Widget; ?> window.widget_lesson_gauge_chart_form = new class { init({color_palette}) { this._form = document.getElementById('widget-dialogue-form'); this._advanced_configuration = document.getElementById('adv_conf'); this._unit_select = document.getElementById('value_units'); this._unit_value = document.getElementById('value_static_units'); this._advanced_configuration.addEventListener('change', () => this.updateForm()); this._unit_select.addEventListener('change', () => this.updateForm()); colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } this.updateForm(); } updateForm() { const show_advanced_configuration = this._advanced_configuration.checked; for (const element of this._form.querySelectorAll('.js-advanced-configuration')) { element.style.display = show_advanced_configuration ? '' : 'none'; } this._unit_value.disabled = this._unit_select.value == <?= Widget::UNIT_AUTO ?>; } }; ``` 2. Створіть файл *Widget.php* у головному каталозі віджетів *lesson_gauge_chart* для створення нового класу *Widget*. Клас *Widget* розширює базовий клас *CWidget* для додавання/перевизначення налаштувань віджету за замовчуванням (у цьому випадку - перекладів).JavaScript, наведений нижче, виводить рядок "Немає даних" у разі відсутності даних.Рядок "Немає даних" присутній у файлах перекладу інтерфейсу користувача Zabbix. Якщо є якісь константи віджета, рекомендується також вказати їх у класі *Widget*. **ui/modules/lesson_gauge_chart/Widget.php** ```php <?php namespace Modules\LessonGaugeChart; use Zabbix\Core\CWidget; class Widget extends CWidget { public const UNIT_AUTO = 0; public const UNIT_STATIC = 1; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` 3. Відкрийте *includes/WidgetForm.php* і додайте нові поля: *Додаткова конфігурація* (чекбокс), *Колір* (перемикач кольорів), *Мін* (числове поле), *Макс* (числове поле) і *Одиниці виміру* (вибір). **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Modules\LessonGaugeChart\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldCheckBox, CWidgetFieldColor, CWidgetFieldMultiSelectItem, CWidgetFieldNumericBox, CWidgetFieldSelect, CWidgetFieldTextBox }; /** * Gauge chart widget form. */ class WidgetForm extends CWidgetForm { public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ->setFilterParameter('numeric', true) ) ->addField( new CWidgetFieldCheckBox('adv_conf', _('Advanced configuration')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ) ->addField( (new CWidgetFieldNumericBox('value_min', _('Min'))) ->setDefault(0) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldNumericBox('value_max', _('Max'))) ->setDefault(100) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldSelect('value_units', _('Units'), [ Widget::UNIT_AUTO => _x('Auto', 'history source selection method'), Widget::UNIT_STATIC => _x('Static', 'history source selection method') ]))->setDefault(Widget::UNIT_AUTO) ) ->addField( (new CWidgetFieldTextBox('value_static_units')) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 4. Відкрийте *views/widget.edit.php* і додайте візуальні компоненти полів до view конфігурації. Метод *addField()* класу *CWidgetFormView* приймає рядок класу CSS як другий параметр. Додайте рядок *js-advanced-configuration* до цих полів та їхніх міток, які мають бути приховані, якщо не вибрано *Advanced configuration*. Щоб додати файл JavaScript до view конфігурації, використовуйте метод *includeJsFile()*. Щоб додати вбудований JavaScript, використовуйте метод *addJavaScript()*. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ use Zabbix\Widgets\Fields\CWidgetFieldGraphDataSet; $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (new CWidgetFormView($data)) ->addField( new CWidgetFieldMultiSelectItemView($data['fields']['itemid'], $data['captions']['items']['itemid']) ) ->addField( new CWidgetFieldCheckBoxView($data['fields']['adv_conf']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']), 'js-advanced-configuration' ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_min']), 'js-advanced-configuration' ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_max']), 'js-advanced-configuration' ) ->addItem([ $lefty_units->getLabel()->addClass('js-advanced-configuration'), (new CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ]))->addClass('js-advanced-configuration') ]) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']), 'js-advanced-configuration' ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('widget_lesson_gauge_chart_form.init('.json_encode([ 'color_palette' => CWidgetFieldGraphDataSet::DEFAULT_COLOR_PALETTE ], JSON_THROW_ON_ERROR).');') ->show(); ``` 5. Поверніться до інформаційної панелі, натисніть на іконку шестерні у віджеті, щоб відкрити форму конфігурації віджету. Форма конфігурації віджету тепер містить новий чекбокс *Розширена конфігурація*. {width="600"} 6. Встановіть чекбокс *Розширена конфігурація*, щоб побачити додаткові поля конфігурації віджету. Заповніть поля значеннями та виберіть колір віджету. {width="600"} 7. Натисніть на *Застосувати* у формі конфігурації віджету. Потім натисніть на *Зберегти зміни* у верхньому правому куті, щоб зберегти дашборд. 8. Відкрийте *actions/WidgetView.php* і оновіть контролер. Властивість **$this->fields_values** тепер містить значення всіх полів *Розширена конфігурація*.Доопрацюйте контролер, щоб уможливити передачу конфігурації та значення вибраного елемента до віджету. **ui/modules/lesson_gauge_chart/actions/WidgetView.php** ```php <?php namespace Modules\LessonGaugeChart\Actions; use API, CControllerDashboardWidgetView, CControllerResponseData; class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $db_items = API::Item()->get([ 'output' => ['itemid', 'value_type', 'name', 'units'], 'itemids' => $this->fields_values['itemid'], 'webitems' => true, 'filter' => [ 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT] ] ]); $history_value = null; if ($db_items) { $item = $db_items[0]; $history = API::History()->get([ 'output' => API_OUTPUT_EXTEND, 'itemids' => $item['itemid'], 'history' => $item['value_type'], 'sortfield' => 'clock', 'sortorder' => ZBX_SORT_DOWN, 'limit' => 1 ]); if ($history) { $history_value = convertUnitsRaw([ 'value' => $history[0]['value'], 'units' => $item['units'] ]); } } $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getName()), 'history' => $history_value, 'fields_values' => $this->fields_values, 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` 9. Відкрийте та відредактуйте *views/widget.view.php*. Вам потрібно створити контейнер для колійної діаграми, яку ви намалюєте в наступних кроках, і контейнер для опису. Щоб передати значення в JavaScript як JSON-об'єкт, використовуйте метод *setVar()*. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem([ (new CDiv())->addClass('chart'), $data['fields_values']['description'] ? (new CDiv($data['fields_values']['description']))->addClass('description') : null ]) ->setVar('history', $data['history']) ->setVar('fields_values', $data['fields_values']) ->show(); ``` 10. Створіть новий каталог *assets* у каталозі *lesson_gauge_chart*. Цей каталог буде використовуватися для зберігання JavaScript, CSS і, можливо, будь-яких інших ресурсів, таких як шрифти або зображення. 11. Для перегляду JavaScript віджетів створіть каталог *js* у каталозі *assets*. 12. Створіть файл *class.widget.js* в каталозі *assets/js*. Цей клас JavaScript-віджету розширює базовий JavaScript-клас усіх віджетів інформаційної панелі - *CWidget*. Інформаційна панель покладається на коректну реалізацію віджета і передає будь-яку відповідну інформацію віджету через виклик відповідних методів JavaScript. Інформаційна панель також очікує, що віджет буде генерувати події, коли відбувається певна взаємодія. Таким чином, клас *CWidget* містить набір методів з реалізацією поведінки віджета за замовчуванням, яку можна налаштувати, розширивши клас. У цьому випадку необхідна певна кастомізація, тому буде реалізовано кастомну логіку для наступної поведінки віджету: -ініціалізація віджету, яка відповідає за визначення початкового стану віджету (див. метод *\_init()*); -відображення вмісту віджету (тобто малювання графіку), якщо процес оновлення віджету пройшов успішно та без помилок (див. метод *\_processUpdateResponse(response)* та пов'язані з ним методи *\_resizeChart()* та *\_updatedChart()*); - зміна розміру віджету (див. метод *resize()* та пов'язаний з ним метод *\_resizeChart()*). Для інших аспектів віджету колійної діаграми буде використано реалізацію за замовчуванням для поведінки віджету.Щоб дізнатися більше про методи JavaScript класу *CWidget*, див: [JavaScript](/devel/modules/widgets/presentation/javascript). Оскільки цей JavaScript необхідний для відображення віджету, його слід завантажити разом зі сторінкою дашборду. Щоб увімкнути завантаження JavaScript, вам потрібно оновити параметри *assets/js* і *js_class* у **manifest.json**, як показано в наступному кроці. **ui/modules/lesson_gauge_chart/assets/js/class.widget.js** ```js class WidgetLessonGaugeChart extends CWidget { static UNIT_AUTO = 0; static UNIT_STATIC = 1; _init() { super._init(); this._refresh_frame = null; this._chart_container = null; this._canvas = null; this._chart_color = null; this._min = null; this._max = null; this._value = null; this._last_value = null; this._units = ''; } _processUpdateResponse(response) { if (response.history === null) { this._value = null; this._units = ''; } else { this._value = Number(response.history.value); this._units = response.fields_values.value_units == WidgetLessonGaugeChart.UNIT_AUTO ? response.history.units : response.fields_values.value_static_units; } this._chart_color = response.fields_values.chart_color; this._min = Number(response.fields_values.value_min); this._max = Number(response.fields_values.value_max); if (this._canvas === null) { super._processUpdateResponse(response); this._chart_container = this._content_body.querySelector('.chart'); this._canvas = document.createElement('canvas'); this._chart_container.appendChild(this._canvas); this._resizeChart(); } else { this._updatedChart(); } } resize() { super.resize(); if (this._state === WIDGET_STATE_ACTIVE) { this._resizeChart(); } } _resizeChart() { const ctx = this._canvas.getContext('2d'); const dpr = window.devicePixelRatio; this._canvas.style.display = 'none'; const size = Math.min(this._chart_container.offsetWidth, this._chart_container.offsetHeight); this._canvas.style.display = ''; this._canvas.width = size * dpr; this._canvas.height = size * dpr; ctx.scale(dpr, dpr); this._canvas.style.width = `${size}px`; this._canvas.style.height = `${size}px`; this._refresh_frame = null; this._updatedChart(); } _updatedChart() { if (this._last_value === null) { this._last_value = this._min; } const start_time = Date.now(); const end_time = start_time + 400; const animate = () => { const time = Date.now(); if (time <= end_time) { const progress = (time - start_time) / (end_time - start_time); const smooth_progress = 0.5 + Math.sin(Math.PI * (progress - 0.5)) / 2; let value = this._value !== null ? this._value : this._min; value = (this._last_value + (value - this._last_value) * smooth_progress - this._min) / (this._max - this._min); const ctx = this._canvas.getContext('2d'); const size = this._canvas.width; const char_weight = size / 12; const char_shadow = 3; const char_x = size / 2; const char_y = size / 2 ;const char_radius = (size - char_weight) / 2 - char_shadow; const font_ratio = 32 / 100; ctx.clearRect(0, 0, size, size); ctx.beginPath();ctx.shadowBlur = char_shadow; ctx.shadowColor = '#bbb'; ctx.strokeStyle = '#eee'; ctx.lineWidth = char_weight; ctx.lineCap = 'round'; ctx.arc(char_x, char_y, char_radius, Math.PI * 0.749, Math.PI * 2.251, false); ctx.stroke(); ctx.beginPath(); ctx.strokeStyle = `#${this._chart_color}`; ctx.lineWidth = char_weight - 2; ctx.lineCap = 'round'; ctx.arc(char_x, char_y, char_radius, Math.PI * 0.75,Math.PI * (0.75 + (1.5 * Math.min(1, Math.max(0, value)))), false ); ctx.stroke(); ctx.shadowBlur = 2; ctx.fillStyle = '#1f2c33'; ctx.font = `${(char_radius * font_ratio)|0}px Arial`; ctx.textAlign = 'center'; ctx.textBaseline = 'middle'; ctx.fillText(`${this._value !== null ? this._value : t('No data')}${this._units}`, char_x, char_y, size - char_shadow * 4 - char_weight * 2 ); ctx.fillStyle = '#768d99'; ctx.font = `${(char_radius * font_ratio * .5)|0}px Arial`; ctx.textBaseline = 'top'; ctx.textAlign = 'left'; ctx.fillText(`${this._min}${this._min != '' ? this._units : ''}`, char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight ); ctx.textAlign = 'right'; ctx.fillText(`${this._max}${this._max != '' ? this._units : ''}`, size - char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight ); requestAnimationFrame(animate); } else { this._last_value = this._value; } }; requestAnimationFrame(animate); } } ``` 13. Відкрийте *manifest.json* і додайте: - ім'я файлу (*class.widget.js*) до масиву в секції *assets/js*; - ім'я класу (*WidgetLessonGaugeChart*) до параметра *js_class* в секції *widget*. Клас *WidgetLessonGaugeChart* тепер буде автоматично завантажуватися з інформаційною панеллю. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix SIA", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "js": ["class.widget.js"] } } ``` ### Add settings to a configuration view and use them in a widget view In this section, you will learn how to add a widget configuration field and show the entered value in the widget view as text. The widget configuration consists of a form (*Zabbix\\Widgets\\CWidgetForm*) and a widget form view (*widget.edit.php*). To add fields (*Zabbix\\Widgets\\CWidgetField*), you need to create a *WidgetForm* class, which will extend *Zabbix\\Widgets\\CWidgetForm*. The form contains the set of fields (*Zabbix\\Widgets\\CWidgetField*) of various types, which are used to validate user-entered values. The form field (*Zabbix\\Widgets\\CWidgetField*) for each input element type converts the value into a single format to store it in the database. :::noteclassic The widget's **form** file should be located in the *includes* directory (for this tutorial, *ui/modules/lesson_gauge_chart/includes/*). If the file has the default name *WidgetForm.php*, you do not need to register it in the *manifest.json* file. If the file has a different name, specify it in the *widget/form_class* section of the [manifest.json](devel/modules/file_structure/manifest) file. ::: 1. Create a new directory *includes* in the *lesson_gauge_chart* directory. 2. Create a *WidgetForm.php* file in the *includes* directory. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Zabbix\Widgets\CWidgetForm; class WidgetForm extends CWidgetForm { } ``` 3. Add a *Description* field to widget configuration form. This is a regular text field, where a user can enter any character set. You can use the *CWidgetFieldTextBox* class for it. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Zabbix\Widgets\CWidgetForm; use Zabbix\Widgets\Fields\CWidgetFieldTextBox; class WidgetForm extends CWidgetForm { public function addFields(): self { return $this ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 4. In the *views* directory, create a widget configuration view file *widget.edit.php* and add a view for the new *Description* field. For the *CWidgetFieldTextBox* field class, the view is *CWidgetFieldTextBoxView.* **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ (new CWidgetFormView($data)) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->show(); ``` 5. Go to the dashboard and click on the gear icon in the widget to open the widget configuration form. 6. The widget configuration form now contains a new *Description* text field. Enter any value, for example, *Gauge chart description*. {width="600"} 7. Click on *Apply* in the widget configuration form. Then click on *Save changes* in the top right corner to save the dashboard. Note that the new description is not visible anywhere, and the widget still displays "Hello, world!". For the new description to appear in the widget, the *Description* field value needs to be retrieved from the database and passed to the widget view. For that, you need to create an action class. 8. Create a new directory *actions* in the *lesson_gauge_chart* directory. 9. Create a *WidgetView.php* file in the *actions* directory. The *WidgetView* action class will extend the *CControllerDashboardWidgetView* class. Values of the widget configuration fields are stored in the **$fields_values** property of the action class. **ui/modules/lesson_gauge_chart/actions/WidgetView.php** ```php <?php namespace Modules\LessonGaugeChart\Actions; use CControllerDashboardWidgetView, CControllerResponseData; class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getName()), 'description' => $this->fields_values['description'], 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` 10. Open *manifest.json* and register *WidgetView* as an action class in the *actions/widget.lesson_gauge_chart.view* section. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix SIA", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } } } ``` 11. Now you can use the value of the description field, contained in *$data['description']*, in the widget view. Open *views/widget.view.php* and replace the static text "Hello, world!" with *$data['description']*. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, $data['description']) ) ->show(); ``` 12. Refresh the dashboard page. You should now see the widget description text instead of "Hello, world!". {width="600"} ### Додайте налаштування до конфігурації view та використовуйте їх у view віджетів У цьому розділі ви дізнаєтесь, як додати поле конфігурації віджета та показати введене значення у вигляді тексту у вікні віджета. Конфігурація віджета складається з форми (*Zabbix\\Widgets\\CWidgetForm*) і view форми віджета (*widget.edit.php*). Щоб додати поля (*Zabbix\\Widgets\\CWidgetField*), вам потрібно створити клас *WidgetForm*, який буде розширювати *Zabbix\\Widgets\\CWidgetForm*. Форма містить набір полів (*Zabbix\\Widgets\\CWidgetField*) різних типів, які використовуються для перевірки введених користувачем значень. Поле форми (*Zabbix\\Widgets\\CWidgetField*) для кожного типу елемента вводу перетворює значення в єдиний формат для зберігання в базі даних. :::noteclassic Файл **форми** віджета має бути розташований у каталозі *includes* (для цієї інструкції *ui/modules/lesson_gauge_chart/includes/*). Якщо файл має назву за замовчуванням *WidgetForm.php*, вам не потрібно реєструвати його у файлі *manifest.json*. Якщо файл має іншу назву, укажіть її в розділі *widget/form_class* файлу [manifest.json](devel/modules/file_structure/manifest). ::: 1. Створіть новий каталог *includes* у каталозі *lesson_gauge_chart*. 2. Створіть файл *WidgetForm.php* у каталозі *includes*. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Zabbix\Widgets\CWidgetForm; class WidgetForm extends CWidgetForm { } ``` 3. Додайте поле *Опис* до форми конфігурації віджета. Це звичайне текстове поле, куди користувач може ввести будь-який набір символів. Для цього можна використовувати клас *CWidgetFieldTextBox*. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Zabbix\Widgets\CWidgetForm; use Zabbix\Widgets\Fields\CWidgetFieldTextBox; class WidgetForm extends CWidgetForm { public function addFields(): self { return $this ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 4. У каталозі *views* створіть файл конфігурації view віджета *widget.edit.php* і додайте view для нового поля *Description*. Для класу полів *CWidgetFieldTextBox* view має вигляд *CWidgetFieldTextBoxView.* **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ (new CWidgetFormView($data)) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->show(); ``` 5. Перейдіть на інформаційну панель і клацніть значок шестірні у віджеті, щоб відкрити форму налаштування віджета. 6. Форма конфігурації віджета тепер містить нове текстове поле *Опис*. Введіть будь-яке значення, наприклад, *Опис gauge chart*. {width="600"} 7. Натисніть *Застосувати* у формі налаштування віджета. Потім натисніть *Зберегти зміни* у верхньому правому куті, щоб зберегти інформаційну панель. Зауважте, що новий опис ніде не видно, а віджет все ще відображає «Hello, world!». Щоб новий опис з’явився у віджеті, потрібно отримати значення поля *Опис* із бази даних і передати його у view віджета. Для цього вам потрібно створити клас дій. 8. Створіть новий каталог *actions* у каталозі *lesson_gauge_chart*. 9. Створіть файл *WidgetView.php* у каталозі *actions*. Клас дій *WidgetView* розширить клас *CControllerDashboardWidgetView*. Значення полів конфігурації віджета зберігаються у властивості **$fields_values** класу дій. **ui/modules/lesson_gauge_chart/actions/WidgetView.php** ```php <?php namespace Modules\LessonGaugeChart\Actions; use CControllerDashboardWidgetView, CControllerResponseData; class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getName()), 'description' => $this->fields_values['description'], 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` 10. Відкрийте *manifest.json* і зареєструйте *WidgetView* як клас дій у розділі *actions/widget.lesson_gauge_chart.view*. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "leson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix SIA", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } } } ``` 11. Тепер ви можете використовувати значення поля опису, що міститься в *$data['description']*, у view віджетів. Відкрийте *views/widget.view.php* і замініть статичний текст «Hello, world!» на *$data['description']*. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->additem( new CTag('h1', true, $data['description']) ) ->show(); ``` 12. Оновіть сторінку інформаційної панелі. Тепер ви маєте побачити текст опису віджета замість «Hello, world!». {width="600"} ##### 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. Зверніть увагу, що для активних перевірок, вузли одного кластеру повинні бути відокремлені від інших Zabbix серверів комою, а самі вузли повинні бути розділені **крапкою з комою**, наприклад: ``` ServerActive=zabbix-node-01;zabbix-node-02 ``` # alert.get # alert.get # > Alert object The following objects are directly related to the `alert` API. # > Об'єкт сповіщення Наступні об’єкти безпосередньо пов’язані з API `alert`. # Alert This class is designed to work with alerts. Object references:\ - [Alert](/manual/api/reference/alert/object#alert) Available methods:\ - [alert.get](/manual/api/reference/alert/get) - retrieve alerts # Сповіщення Цей клас призначений для роботи з оповіщеннями. Посилання на об'єкти:\ - [Попередження](/manual/api/reference/alert/object#alert) Доступні методи:\ - [alert.get](/manual/api/reference/alert/get) - отримання сповіщень # API info This class is designed to retrieve meta information about the API. Available methods:\ - [apiinfo.version](/manual/api/reference/apiinfo/version) - retrieving the version of the Zabbix API # Інформація про API Цей клас призначений для отримання метаінформації про API. Доступні методи:\ - [apiinfo.version](/manual/api/reference/apiinfo/version) - отримання версії Zabbix API # apiinfo.version # apiinfo.version ### API versions To simplify API versioning, since Zabbix 2.0.4, the version of the API matches the version of Zabbix itself. You can use the [apiinfo.version](/manual/api/reference/apiinfo/version) method to find out the version of the API you are working with. This can be useful for adjusting your application to use version-specific features. Zabbix guarantees feature backward compatibility inside a major version. When making backward incompatible changes between major releases, Zabbix usually leaves the old features as deprecated in the next release, and only removes them in the release after that. Occasionally, Zabbix may remove features between major releases without providing any backward compatibility. It is important that you never rely on any deprecated features and migrate to newer alternatives as soon as possible. ::: notetip You can follow all the changes made to the API in the [API changelog](/manual/api/changes). ::: ### версії API Для спрощення керування версіями API, починаючи з Zabbix 2.0.4, версія API відповідає версії самого Zabbix. Ви можете використовувати [apiinfo.version](/manual/api/reference/apiinfo/version) метод пошуку версії API, з якою ви працюєте. Це може бути корисно для налаштування вашого додатка на використання специфічних для певної версії функцій. Zabbix гарантує зворотну сумісність функцій всередині мажорної версії. При внесенні зворотно несумісних змін між мажорними випусками, Zabbix зазвичай залишає старі функції застарілими(deprecated) в наступному випуску, і видаляє їх лише у подальших випусках. Іноді Zabbix може видаляти можливості між мажорними випусками без забезпечення зворотної сумісності. Важливо, щоб ви ніколи не покладалися на застарілі функції і переходили на новіші альтернативи якомога швидше. ::: notetip Ви можете стежити за всіма змінами, внесеними до API, у [Журналі змін API](/manual/api/changes). ::: #### API [ZBXNEXT-8051](https://support.zabbix.com/browse/ZBXNEXT-8051) Authorization method changed from `auth` parameter to `Authorization` header.\ [ZBXNEXT-8051](https://support.zabbix.com/browse/ZBXNEXT-8051) Deprecated parameter `auth`.\ #### API [ZBXNEXT-8051](https://support.zabbix.com/browse/ZBXNEXT-8051) Метод авторизації змінено з параметра `auth` на заголовок `Authorization`.\ [ZBXNEXT-8051](https://support.zabbix.com/browse/ZBXNEXT-8051) Задіприкейчино параметр `auth`.\ # Appendix 1. Reference commentary № Додаток 1. Опорний коментар # Appendix 2. Changes from 6.2 to 6.4 # Додаток 2. Зміни з 6.2 до 6.4 ### assets/css *assets/css* is reserved and should only contain CSS style files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "css": ["mywidget.css"] } ``` ### assets/css *assets/css* зарезервований і має містити лише файли стилю CSS. Щоб використовувати його віджетом, укажіть ці файли в *[manifest.json](/devel/modules/file_structure/manifest)*. Наприклад: ```json "assets": { "css": ["mywidget.css"] } ``` ### assets CSS styles and JavaScript files to include. *Type*: Object *Supported object keys:* - **css** (array) - CSS files to include. The files must be located in the *assets/css*. - **js** (array) - JavaScript files to include. The files must be located in the *assets/js*. *Example*: ```json "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } ``` ### assets Стилі CSS і файли JavaScript для включення. *Тип*: Object *Підтримувані ключі об’єктів:* - **css** (array) - файли CSS для включення. Файли мають бути розташовані в *assets/css*. - **js** (array) - файли JavaScript для включення. Файли мають бути розташовані в *assets/js*. *Приклад*: ```json "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } ``` ### assets/js *assets/js* directory is reserved and should only contain JavaScript files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "js": ["class.widget.js"] } ``` ### assets/js Каталог *assets/js* зарезервований і має містити лише файли JavaScript. Щоб використовувати його віджетом, укажіть ці файли в *[manifest.json](/devel/modules/file_structure/manifest)*. Наприклад: ```json "assets": { "js": ["class.widget.js"] } ``` # Assets The folder *assets* may contain any files and subfolders that do not belong to other directories. You can use it for: - JavaScript styles (must be inside *[assets/js](#assetsjs)*); - CSS styles (must be inside *[assets/css](#assetscss)*); - Images; - Fonts; - Anything else you need to include. # Assets Папка *assets* може містити будь-які файли та підпапки, які не належать до інших каталогів. Ви можете використовувати її для: - Стилі JavaScript (має бути всередині *[assets/js](#assetsjs)*); - Стилі CSS (має бути в *[assets/css](#assetscss)*); - Зображення; - Шрифти; - Усе, що вам потрібно додати. # auditlog.get # auditlog.get # > Audit log object The following objects are directly related to the `auditlog` API. # > Об'єкт журналу аудиту Наступні об’єкти безпосередньо пов’язані з API журналу аудиту. # Audit log This class is designed to work with audit log. Object references:\ - [Audit log object](/manual/api/reference/auditlog/object) Available methods:\ - [auditlog.get](/manual/api/reference/auditlog/get) - retrieve audit log records # Журнал аудиту Цей клас призначений для роботи з журналом аудиту. Посилання на об'єкти:\ - [Об'єкт журналу аудиту](/manual/api/reference/auditlog/object) Доступні методи:\ - [auditlog.get](/manual/api/reference/auditlog/get) - отримати записи журналу аудиту #### auditlog [ZBXNEXT-8105](https://support.zabbix.com/browse/ZBXNEXT-8105) Added new [audit log](/manual/api/reference/auditlog/object#audit-log) entry resource type (51 - Connector).\ #### auditlog [ZBXNEXT-8105](https://support.zabbix.com/browse/ZBXNEXT-8105) Додано новий тип ресурсу [журнал аудиту](/manual/api/reference/auditlog/object#audit-log) (51 - Connector).\ # authentication.get # authentication.get # > Authentication object The following objects are directly related to the `authentication` API. # > Об'єкт автентифікації Наступні об’єкти безпосередньо пов’язані з API `автентифікації`. # Authentication This class is designed to work with authentication settings. Object references:\ - [Authentication](/manual/api/reference/authentication/object#authentication) Available methods:\ - [authentication.get](/manual/api/reference/authentication/get) - retrieve authentication - [authentication.update](/manual/api/reference/authentication/update) - update authentication # Автентифікація Цей клас призначений для роботи з параметрами автентифікації. Посилання на об'єкти:\ - [Автентифікація](/manual/api/reference/authentication/object#authentication) Доступні методи:\ - [authentication.get](/manual/api/reference/authentication/get) - отримати автентифікацію - [authentication.update](/manual/api/reference/authentication/update) - оновлення автентифікації #### Authentication To access any data in Zabbix, you need to either: - use an existing [API token](/manual/web_interface/frontend_sections/users/api_tokens) (created in Zabbix frontend or using the [Token API](/manual/api/reference/token)); - use an authentication token obtained with the [user.login](/manual/api/reference/user/login) method. For example, if you wanted to obtain a new authentication token by logging in as a standard *Admin* user, then a JSON request would look like this: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"user.login","params":{"username":"Admin","password":"zabbix"},"id":1}' ``` If you provided the credentials correctly, the response returned by the API should contain the user authentication token: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` #### Автентифікація Щоб отримати доступ до будь-яких даних у Zabbix, вам потрібно: - використовувати існуючий [API-токен](/manual/web_interface/frontend_sections/users/api_tokens) (створений у інтерфейсі Zabbix або за допомогою [Token API](/manual/api/reference/token)); - використовувати токен автентифікації, отриманий методом [user.login](/manual/api/reference/user/login). Наприклад, якщо ви хочете отримати новий токен автентифікації, увійшовши як стандартний користувач *Admin*, то JSON-запит буде виглядати наступним чином: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"user.login","params":{"username":"Admin","password":"zabbix"},"id":1}' ``` Якщо ви правильно вказали облікові дані, відповідь, повернута API, повинна містити токен автентифікації користувача: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` # authentication.update # authentication.update #### authentication [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Removed properties `saml_idp_entityid`, `saml_sso_url`, `saml_slo_url`, `saml_username_attribute`, `saml_sp_entityid`, `saml_nameid_format`, `saml_sign_messages`, `saml_sign_assertions`, `saml_sign_authn_requests`, `saml_sign_logout_requests`, `saml_sign_logout_responses`, `saml_encrypt_nameid`, `saml_encrypt_assertions`. These properties are now part of [User directory](/manual/api/changes#userdirectory) API.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Renamed property `ldap_configured` to `ldap_auth_enabled`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Added new properties `ldap_jit_status`, `saml_jit_status`, `jit_provision_interval`, `disabled_usrgrpid`.\ #### authentication [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Вилучено властивості `saml_idp_entityid`, `saml_sso_url`, `saml_slo_url`, `saml_username_attribute`, `saml_sp_entityid`, `saml_nameid_format`, `saml_ sign_messages `, `saml_sign_assertions`, `saml_sign_authn_requests`, `saml_sign_logout_requests`, `saml_sign_logout_responses`, `saml_encrypt_nameid`, `saml_encrypt_assertions`. Тепер ці властивості є частиною [Каталогу користувача](/manual/api/changes#userdirectory) API.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Перейменовано властивість `ldap_configured` на `ldap_auth_enabled`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Додано нові властивості `ldap_jit_status`, `saml_jit_status`, `jit_provision_interval`, `disabled_usrgrpid`.\ ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} #### Authorization methods #### Методи авторизації ### author Module author. The author will be displayed in the Administration section. *Type*: String *Example*: ```json "author": "John Smith" ``` ### author Автор модуля. Автор буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "author": "Лесь Подерв'янський" ``` ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## АВТОР ТОВ Zabbix -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## АВТОР ТОВ Zabbix -------------------------------------------------- ---------------------- [ ]{#index} # autoregistration.get # autoregistration.get # > Autoregistration object The following objects are directly related to the `autoregistration` API. # > Об'єкт автореєстрації Наступні об’єкти безпосередньо пов’язані з API автореєстрації. # Autoregistration This class is designed to work with autoregistration. Object references:\ - [Autoregistration](/manual/api/reference/autoregistration/object#autoregistration) Available methods:\ - [autoregistration.get](/manual/api/reference/autoregistration/get) - retrieve autoregistration - [autoregistration.update](/manual/api/reference/autoregistration/update) - update autoregistration #Автореєстрація Цей клас призначений для роботи з автореєстрацією. Посилання на об'єкти:\ - [Autoregistration](/manual/api/reference/autoregistration/object#autoregistration) Доступні методи:\ - [autoregistration.get](/manual/api/reference/autoregistration/get) - отримати автореєстрацію - [autoregistration.update](/manual/api/reference/autoregistration/update) - оновити автореєстрацію # autoregistration.update # autoregistration.update ## Backward incompatible changes ## Зворотно несумісні зміни ##### By Zabbix cookie A *"zbx_session"* cookie is used to authorize an API request from Zabbix UI performed using JavaScript (from a module or a custom widget). ##### Файл cookie Zabbix Файл cookie *"zbx_session "* використовується для авторизації API-запиту з інтерфейсу Zabbix, що виконується за допомогою JavaScript (з модуля або кастомного віджета). #### Calculation time A trigger is recalculated every time Zabbix server receives a new value that is part of the expression. When a new value is received, each function that is included in the expression is recalculated (not just the one that received the new value). Additionally, a trigger is recalculated each time when a new value is received **and** every 30 seconds if time-based functions are used in the expression. Time-based functions are **nodata()**, **date()**, **dayofmonth()**, **dayofweek()**, **time()**, **now()**; they are recalculated every 30 seconds by the Zabbix history syncer process. Triggers that reference trend functions **only** are evaluated once per the smallest time period in the expression. See also [trend functions](/manual/appendix/functions/trends). #### Calculation time A trigger is recalculated every time Zabbix server receives a new value that is part of the expression. When a new value is received, each function that is included in the expression is recalculated (not just the one that received the new value). Additionally, a trigger is recalculated each time when a new value is received **and** every 30 seconds if time-based functions are used in the expression. Time-based functions are **nodata()**, **date()**, **dayofmonth()**, **dayofweek()**, **time()**, **now()**; they are recalculated every 30 seconds by the Zabbix history syncer process. Triggers that reference trend functions **only** are evaluated once per the smallest time period in the expression. See also [trend functions](/manual/appendix/functions/trends). #### - 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 застосовано деякі зміни. ### config Default values for the module options. The object may contain any custom keys. If specified, these values will be written into the database during module registration. New variables added later will be written upon the first call. Afterwards, the variable values can only be changed directly in the database. *Type*: Object *Example*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ``` ### config Значення за замовчуванням для параметрів модуля. Об'єкт може містити будь-які спеціальні ключі. Якщо вказано, ці значення будуть записані в базу даних під час реєстрації модуля. Нові змінні, додані пізніше, будуть записані під час першого виклику. Після цього значення змінних можна змінити лише безпосередньо в базі даних. *Тип*: Object *Приклад*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ``` #### Configuration A problem can be suppressed through the **[problem update](/manual/acknowledgment#updating-problems)** window, where suppression is one of the problem update options along with commenting, changing severity, acknowledging, etc. A problem may also be unsuppressed through the same problem update window. #### Конфігурація Проблему можна сховати за допомогою вікна **[оновлення проблеми](/manual/acknowledgment#updating-problems)**, де приховування є одним із параметрів оновлення проблеми разом із коментування, зміна серйозності, підтвердження тощо. Проблема також може бути знову зроблена видимою в тому самому вікні оновлення проблеми. # configuration.export # configuration.export # configuration.import # configuration.import # configuration.importcompare # configuration.importcompare # Configuration This class is designed to export and import Zabbix configuration data. Available methods:\ - [configuration.export](/manual/api/reference/configuration/export) - exporting the configuration - [configuration.import](/manual/api/reference/configuration/import) - importing the configuration - [configuration.importcompare](/manual/api/reference/configuration/importcompare) - comparing import file with current system elements # Конфігурація Цей клас призначений для експорту та імпорту конфігураційних даних Zabbix. Доступні методи:\ - [configuration.export](/manual/api/reference/configuration/export) - експорт конфігурації - [configuration.import](/manual/api/reference/configuration/import) - імпортування конфігурації - [configuration.importcompare](/manual/api/reference/configuration/importcompare) - порівняння файлу імпорту з поточними елементами системи # Configuration This page describes classes that can be used to create a widget configuration view with custom configuration fields. The widget configuration view is the part of the widget that allows the user to configure widget parameters for [presentation](/presentation). # Конфігурація На цій сторінці описано класи, які можна використовувати для створення конфігурації view віджета з настроюваними полями конфігурації. View конфігурації віджета — це частина віджета, яка дозволяє користувачеві налаштовувати параметри віджета для [презентації](/presentation). #### connector [ZBXNEXT-8105](https://support.zabbix.com/browse/ZBXNEXT-8105) Added new Connector API with methods `connector.create`, `connector.update`, `connector.get`, `connector.delete`.\ #### connector [ZBXNEXT-8105](https://support.zabbix.com/browse/ZBXNEXT-8105) Додано новий API конектора з методами `connector.create`, `connector.update`, `connector.get`, `connector.delete` `.\ ### Controller Action controller workflow: 1) Check that all parameters passed in an HTTP request are valid: - Call the controller's *checkInput()* method - Use validation rules defined in CNewValidator.php - Call *validateInput()* method 2) Check user permissions. 3) Prepare the data according to passed parameters: if *checkInput()* returns true, Zabbix calls the controller's *doAction()* method. 4) Prepare the **$data** array for the view. Use *CControllerResponseData* and *setResponse()* method to store response in the **$data** array. Example: ````php /** * Validate input parameters. * * @return bool */ protected function checkInput(): bool { $ret = $this->validateInput([ 'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED]) ]); if (!$ret) { $this->setResponse(new CControllerResponseFatal()); } return $ret; } /** * Check user permissions. * * @return bool */ protected function checkPermissions() { return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN; } /** * Execute action and generate response object. */ protected function do Action(): void { $data = [ 'hosts_count' => API::Host()->get([ 'countOutput' => true, 'filter' => [ 'status' => $this->getInput('status') ] ]) ]; $this->setResponse(new CControllerResponseData($data)); } ```` ::: notetip You can view the full list of available controller classes in Zabbix [source code](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers?at=refs%2Fheads%2Frelease%2F6.4). ::: ### Контролер Робочий процес контролера дій: 1) Перевірте, чи всі параметри, передані в HTTP-запиті, дійсні: - Викличте метод контролера *checkInput()* - Використовуйте правила перевірки, визначені в CNewValidator.php - Викличте метод *validateInput()* 2) Перевірте дозволи користувача. 3) Підготуйте дані відповідно до переданих параметрів: якщо *checkInput()* повертає true, Zabbix викликає метод контролера *doAction()*. 4) Підготуйте масив **$data** для перегляду. Використовуйте метод *CControllerResponseData* і *setResponse()* для збереження відповіді в масиві **$data**. Приклад: ````php /** * Перевірка вхідних параметрів. * * @return bool */ protected function checkInput(): bool { $ret = $this->validateInput([ 'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED]) ]); if (!$ret) { $this->setResponse(new CControllerResponseFatal()); } return $ret; } /** * Перевірка дозволів користувача. * * @return bool */ protected function checkPermissions() { return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN; } /** * Виконати дію та створити об’єкт відповіді. */ protected function $datado Action(): void { $data = [ 'hosts_count' => API::Host()->get([ 'countOutput' => true, 'filter' => [ 'status' => $this->getInput('status') ] ]) ]; $this->setResponse(new CControllerResponseData($data)); } ```` ::: підказка Ви можете переглянути повний список доступних класів контролерів у Zabbix [початковий код](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers?at=refs%2Fheads%2Frelease%2F6.4). ::: ### 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 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 залишає за собою будь-які права на цю документацію, прямо не надані вище. # correlation.create # correlation.create # correlation.delete # correlation.delete # correlation.get # correlation.get # > Correlation object The following objects are directly related to the `correlation` API. # > Об'єкт кореляції Наступні об’єкти безпосередньо пов’язані з `correlation` API. # Correlation This class is designed to work with correlations. Object references:\ - [Correlation](/manual/api/reference/correlation/object#correlation) Available methods:\ - [correlation.create](/manual/api/reference/correlation/create) - creating new correlations - [correlation.delete](/manual/api/reference/correlation/delete) - deleting correlations - [correlation.get](/manual/api/reference/correlation/get) - retrieving correlations - [correlation.update](/manual/api/reference/correlation/update) - updating correlations # Кореляція Цей клас призначений для роботи з кореляціями. Посилання на об'єкти:\ - [Кореляція](/manual/api/reference/correlation/object#correlation) Доступні методи:\ - [correlation.create](/manual/api/reference/correlation/create) - створення нових кореляцій - [correlation.delete](/manual/api/reference/correlation/delete) - видалення кореляцій - [correlation.get](/manual/api/reference/correlation/get) - отримання кореляцій - [correlation.update](/manual/api/reference/correlation/update) - оновлення кореляцій # correlation.update # correlation.update #### Create a discovery action Create a discovery action that will link discovered hosts to template "10001". [Request](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Створити дію виявлення Створіть дію, яка зв’яже виявлені хости з шаблоном «10001». [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Discovery action", "eventsource": 1, "status": 0, "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 21, "operator": 0, "value": "1" }, { "conditiontype": 10, "operator": 0, "value": "2" } ] }, "operations": [ { "operationtype": 6, "optemplate": [ { "templateid": "10001" } ] } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "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](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### Створити правило автореєстрації агента Створіть дію автореєстрації, яка додає хост до групи хостів «2», коли ім'я хоста містить «SRV» або метадані містять «AlmaLinux». [Запит](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` ##### Create a menu section 1. Create a *Module.php* file in the *MyAddress* directory. This file implements a new *Module* class that extends the default *CModule* class. The *Module* class will insert a new *My Address* menu section into the main menu. The *setAction()* method specifies an action to be executed upon clicking on the menu section. To start with, you can use the predefined action *userprofile.edit*, which will open the *User profile* page. In [part III](#part-iii---module-action) of this tutorial, you will learn how to create a custom action. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->add((new CMenuItem(_('My Address'))) ->setAction('userprofile.edit')); } } ``` :::noteclassic You can replace `'userprofile.edit'` with other actions, for example, `'charts.view'` (opens custom graphs), `'problems.view'` (opens *Monitoring → Problems*), or `'report.status'` (opens *System information* report). ::: 3. Refresh Zabbix frontend. There is now a new *My Address* section at the bottom of the Zabbix main menu. Click on *My Address* to open the *User profile* page. {width="600"} ##### Створення розділу меню 1. Створіть файл *Module.php* у каталозі *MyAddress*. Цей файл реалізує новий клас *Module*, який розширює стандартний клас *CModule*. Клас *Module* вставить новий розділ меню *My Address* в головне меню. Метод *setAction()* визначає дію, яка буде виконана після натискання на розділ меню. Для початку ви можете скористатися попередньо визначеною дією *userprofile.edit*, яка відкриє сторінку *Профіль користувача*. У [частині III](#part-iii---module-action) цієї інструкції ви дізнаєтесь, як створити користувацьку дію. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->add((новий CMenuItem(_('My Address'))) ->setAction('userprofile.edit')); } } ``` :::noteclassic Ви можете замінити «userprofile.edit» іншими діями, наприклад «charts.view» (відкриває користувацькі графіки), «problems.view» (відкриває *Моніторинг → Проблеми*) або `'report.status'` (відкриває звіт *Інформація про систему*). ::: 3. Оновіть інтерфейс Zabbix. Тепер у нижній частині головного меню Zabbix є новий розділ *Моя адреса*. Натисніть *Моя адреса*, щоб відкрити сторінку *Профіль користувача*. {width="600"} # Create a module (tutorial) # Створення модуля (інструкція) # Create a plugin (tutorial) # Створення плагіна (посібник) #### 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/alerts/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](/manual/api#performing-requests): ```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" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### Створіть тригерну дію Створіть дію, яка виконуватиметься, коли тригер із хосту "10084", який містить слово "пам'ять" у своєму імені, переходить у стан проблеми. Дія повинна спочатку надіслати повідомлення всім користувачам у групі користувачів «7». Якщо подію не буде вирішено протягом 4 хвилин, буде запущено сценарій «3» на всіх хостах у групі «2». Під час відновлення тригера він сповістить усіх користувачів, які раніше отримували будь-які повідомлення щодо проблеми. Після оновлення тригера повідомлення з настроюваною темою та основним текстом буде надіслано всім, хто залишив підтвердження та коментарі через усі типи медіа. Запит: ```json { "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 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` # Create a widget (tutorial) # Створення віджета (інструкція) #### Creating a new item Now, create a new [item](/manual/api/reference/item/object) on the host "Zabbix server" using the data you have obtained from the previous `host.get` request. This can be done using the [item.create](/manual/api/reference/item/create) method: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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},"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. ::: #### Створення нового елемента Тепер створіть новий [item](/manual/api/reference/item/object) на хості "Zabbix server", використовуючи дані, які ви отримали з попереднього `host.get`-запиту. Це можна зробити за допомогою методу [item.create](/manual/api/reference/item/create): ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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},"id":3}' ``` Успішна відповідь міститиме ідентифікатор щойно створеного елемента, який можна використовувати для посилання на елемент у таких запитах: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 3 } ``` ::: notetip Метод `item.create`, як і інші методи *create*, також може приймати масиви об'єктів і створювати декілька елементів одним викликом API. ::: #### Creating multiple triggers Thus, if *create methods* accept arrays, you can add multiple [triggers](/manual/api/reference/trigger/object), for example, this one: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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",}],"id":4}' ``` The 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), наприклад, цей: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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",}],"id":4}' ``` Успішна відповідь міститиме ідентифікатори новостворених тригерів: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 4 } ``` ##### CSS styles CSS files may contain a custom attribute `theme` to define different style for a specific frontend themes. Available themes and their attribute values: - **Blue** - [theme='blue-theme'] - **Dark** - [theme='dark-theme'] - **High-contrast light** - [theme='hc-light'] - **High-contrast dark** - [theme='hc-dark'] Example: ```css .widget { background-color: red; } [theme='dark-theme'] .widget { background-color: green; } ``` ##### Стилі CSS Файли CSS можуть містити користувацький атрибут `theme` для визначення іншого стилю для певних тем інтерфейсу. Доступні теми та значення їхніх атрибутів: - **Блакитна** - [theme='blue-theme'] - **Темна** - [theme='dark-theme'] - **Висококонтрастна світла** - [theme='hc-light'] - **Висококонтрастна темна** - [theme='hc-dark'] приклад: ```css .widget { background-color: червоний; } [theme='dark-theme'] .widget { background-color: зелений; } ``` ### CWidgetField The *CWidgetField* class is a base class from which all form field classes (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList*, etc.) are inherited. Classes extending *CWidgetField* are responsible for receiving, saving, and validating widget configuration values. The following *CWidgetField* classes are available. |CWidgetField class|Database field type|Description| |----|--|------------| |*CWidgetFieldCheckBox*|int32|Single checkbox.| |*CWidgetFieldCheckBoxList*|array of int32|Multiple checkboxes under a single configuration field.| |*CWidgetFieldColor*|string|Color selection field.| |*CWidgetFieldDatePicker*|string|Date selection field.| |*CWidgetFieldHostPatternSelect*|string|Multiselect field that allows to select one or multiple hosts. Supports defining host name patterns (all matching hosts will be selected).| |*CWidgetFieldIntegerBox*|int32|Field to enter an integer. Can be used to configure minimum and maximum values.| |*CWidgetFieldLatLng*|string|Text box that allows to enter comma-separated latitude, longitude, and map zoom level.| |*CWidgetFieldMultiSelectAction*|ID|Multiselect field for selecting actions (from the list of actions defined in the *Alerts → Actions*).| |*CWidgetFieldMultiSelectGraph*|ID|Multiselect field for selecting custom graphs.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Multiselect field for selecting custom graph prototypes.| |*CWidgetFieldMultiSelectGroup*|ID|Multiselect field for selecting host groups.| |*CWidgetFieldMultiSelectHost*|ID|Multiselect field for selecting hosts.| |*CWidgetFieldMultiSelectItem*|ID|Multiselect field for selecting items.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Multiselect field for selecting item prototypes.| |*CWidgetFieldMultiSelectMediaType*|ID|Multiselect field for selecting media types.| |*CWidgetFieldMultiSelectService*|ID|Multiselect field for selecting services.| |*CWidgetFieldMultiSelectSla*|ID|Multiselect field for selecting SLAs.| |*CWidgetFieldMultiSelectUser*|ID|Multiselect field for selecting users.| |*CWidgetFieldNumericBox*|string|Field to enter a float number.| |*CWidgetFieldRadioButtonList*|int32|Radio box group that consists of one or more radio boxes.| |*CWidgetFieldRangeControl*|int32|Slider to select an integer type value.| |*CWidgetFieldSelect*|int32|Dropdown select box.| |*CWidgetFieldSeverities*|array of int32|*CWidgetFieldCheckBoxList* preset with trigger severities.| |*CWidgetFieldTags*|array of (string, int32, string)|Allows to configure one or more tag filter rows.| |*CWidgetFieldTextArea*|string|Text area for entering multi-line text.| |*CWidgetFieldTextBox*|string|Text box for entering single-line text.| |*CWidgetFieldTimeZone*|string|Dropdown with timezones.| |*CWidgetFieldUrl*|string|Text box that allows to enter URLs.| The following *CWidgetField* classes have been created for particular widgets. These classes have very specific use cases, but they can also be reused if needed. |CWidgetField class|Database field type|Description| |----|--|------------| |*CWidgetFieldColumnsList*|array of (multiple mixed)|For *Top hosts* widget. Create a table with custom columns of allowed types.| |*CWidgetFieldGraphDataSet*|array of (multiple mixed)|For *Graph* widget. Setup dataset configuration and all related options.| |*CWidgetFieldGraphOverride*|array of (multiple mixed)|For *Graph* widget. Setup overrides for specific hosts/items. Any dataset configuration can be overridden.| |*CWidgetFieldNavTree*|string|For *Map navigation tree* widget. Replaces widget view in edit mode with the map selection tree.| |*CWidgetFieldReference*|string|For *Map navigation tree* widget. Creates a unique identifier for this widget on dashboard. It is used to reference this widget from other widgets.| |*CWidgetFieldSelectResource*|ID|For *Map* widget. Allows to select Zabbix network map.| |*CWidgetFieldThresholds*|array of (string, string)|For *Top hosts* widget. Allows to configure color and number pairs.| |*CWidgetFieldWidgetSelect*|string|For *Map* widget. Allows to select a map navigation tree from the current dashboard. Must be used in combination with *CWidgetFieldReference* in the *Map navigation tree* widget.| ### CWidgetField Клас *CWidgetField* є базовим класом, від якого успадковуються всі класи полів форми (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList* тощо). Класи, що розширюють *CWidgetField*, відповідають за отримання, збереження та перевірку значень конфігурації віджетів. Доступні такі класи *CWidgetField*. |Клас CWidgetField|Тип поля бази даних|Опис| |----|--|------------| |*CWidgetFieldCheckBox*|int32|Один чекбокс.| |*CWidgetFieldCheckBoxList*|масив int32|Кілька чекбоксів під одним полем конфігурації.| |*CWidgetFieldColor*|string|Поле вибору кольору.| |*CWidgetFieldDatePicker*|string|Поле вибору дати.| |*CWidgetFieldHostPatternSelect*|string|Множинне поле для вибору, яке дозволяє вибрати один або кілька хостів. Підтримує визначення шаблонів імен хостів (усі відповідні хости будуть вибрані).| |*CWidgetFieldIntegerBox*|int32|Поле для введення цілого числа. Можна використовувати для налаштування мінімальних і максимальних значень.| |*CWidgetFieldLatLng*|string|Текстове поле, яке дозволяє вводити через кому широту, довготу та рівень масштабування карти.| |*CWidgetFieldMultiSelectAction*|ID|Поле множинного вибору для вибору дій (зі списку дій, визначених у *Сповіщення → Дії*).| |*CWidgetFieldMultiSelectGraph*|ID|Множинне поле для вибору власних графіків.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Поле для вибору користувацьких прототипів графів.| |*CWidgetFieldMultiSelectGroup*|ID|Множинне поле для вибору груп хостів.| |*CWidgetFieldMultiSelectHost*|ID|Поле множинного вибору для вибору хостів.| |*CWidgetFieldMultiSelectItem*|ID|Множинне поле для вибору елементів даних.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Множинне поле для вибору прототипів елементів даних.| |*CWidgetFieldMultiSelectMediaType*|ID|Множинне поле для вибору типів медіа.| |*CWidgetFieldMultiSelectService*|ID|Множинне поле для вибору служб.| |*CWidgetFieldMultiSelectSla*|ID|Множинне поле для вибору SLA.| |*CWidgetFieldMultiSelectUser*|ID|Множинне поле для вибору користувачів.| |*CWidgetFieldNumericBox*|string|Поле для введення числа з плаваючою точкою.| |*CWidgetFieldRadioButtonList*|int32|Група radiobox-ів, яка складається з одного або кількох radiobox-ів.| |*CWidgetFieldRangeControl*|int32|Повзунок для вибору значення цілочисельного типу.| |*CWidgetFieldSelect*|int32|Випадаюче вікно вибору.| |*CWidgetFieldSeverities*|масив int32|*CWidgetFieldCheckBoxList* попередньо налаштованих із рівнями серйозності тригера.| |*CWidgetFieldTags*|array (string, int32, string)|Дозволяє налаштувати один або кілька рядків фільтра тегів.| |*CWidgetFieldTextArea*|string|Текстова область для введення багаторядкового тексту.| |*CWidgetFieldTextBox*|string|Текстове поле для введення однорядкового тексту.| |*CWidgetFieldTimeZone*|string|Випадаюче меню з часовими поясами.| |*CWidgetFieldUrl*|string|Текстове поле, яке дозволяє вводити URL-адреси.| Наступні класи *CWidgetField* були створені для окремих віджетів. Ці класи мають дуже специфічні випадки використання, але їх також можна використовувати повторно, якщо це необхідно. |Клас CWidgetField|Тип поля бази даних|Опис| |----|--|------------| |*CWidgetFieldColumnsList*|масив (кілька змішаних)|Для віджета *Top hosts*. Створює таблицю з настроюваними стовпцями дозволених типів.| |*CWidgetFieldGraphDataSet*|масив (кілька змішаних)|Для віджета *Graph*. Налаштувує конфігурацію набору даних і всі пов’язані параметри.| |*CWidgetFieldGraphOverride*|масив (кілька змішаних)|Для віджета *Graph*. Перевизначення налаштувань для певних хостів/елементів. Будь-яку конфігурацію набору даних можна змінити.| |*CWidgetFieldNavTree*|string|Для віджета *Map navigation tree*. Замінює вигляд віджету в режимі редагування на дерево вибору мапи.| |*CWidgetFieldReference*|string|Для віджета *Map navigation tree*. Створює унікальний ідентифікатор для цього віджета на інформаційній панелі. Він використовується для посилання на цей віджет з інших віджетів.| |*CWidgetFieldSelectResource*|ID|Для віджета *Map*. Дозволяє вибрати карту мережі Zabbix.| |*CWidgetFieldThresholds*|масив (string, string)|Для віджета *Top hosts*. Дозволяє налаштувати пари кольорів і чисел.| |*CWidgetFieldWidgetSelect*|string|Для віджета *Map*. Дозволяє вибрати дерево навігації карти з поточної інформаційної панелі. Потрібно використовувати разом із *CWidgetFieldReference* у віджеті *Навігаційне дерево карти*.| ### CWidgetFormView The *CWidgetFormView* class is required for specifying the presentation logic of the fields defined in the *WidgetForm* class, determining their appearance and behavior when rendered in the configuration view. The *CWidgetFormView* class supports the following methods: - *addField()* - receives an instance of the *CWidgetFieldView* class as a parameter; each [*CWidgetField*](#cwidgetfield) class, has a respective *CWidgetFieldView* class for using in the widget configuration view. - *includeJsFile()* - allows to add a JavaScript file to the widget configuration view. - *addJavaScript()* - allows to add inline JavaScript that will be executed as soon as the widget configuration view is loaded. The *CWidgetFormView* class should be located in the *views* directory. **views/widget.edit.php example** ```php <?php /** * My custom widget form view. * * @var CView $this * @var array $data */ use Zabbix\Widgets\Fields\CWidgetFieldGraphDataSet; (new CWidgetFormView($data)) ->addField( new CWidgetFieldMultiSelectItemView($data['fields']['itemid'], $data['captions']['items']['itemid']) ) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']), 'js-advanced-configuration' ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']), 'js-advanced-configuration' ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_widget_form.init('.json_encode([ 'color_palette' => CWidgetFieldGraphDataSet::DEFAULT_COLOR_PALETTE ], JSON_THROW_ON_ERROR).');') ->show(); ``` ### CWidgetFormView Клас *CWidgetFormView* потрібен для визначення логіки представлення полів, визначених у класі *WidgetForm*, визначення їх зовнішнього вигляду та поведінки під час візуалізації у вікні конфігурації. Клас *CWidgetFormView* підтримує такі методи: - *addField()* - отримує в якості параметра екземпляр класу *CWidgetFieldView*; кожен клас [*CWidgetField*](#cwidgetfield) має відповідний клас *CWidgetFieldView* для використання в view конфігурації віджета. - *includeJsFile()* - дозволяє додати файл JavaScript до view конфігурації віджета. - *addJavaScript()* - дозволяє додати вбудований JavaScript, який буде виконано, щойно буде завантажено view конфігурації віджета. Клас *CWidgetFormView* має бути розташований у каталозі *views*. **views/widget.edit.php приклад** ```php <?php /** * My custom widget form view. * * @var CView $this * @var array $data */ use Zabbix\Widgets\Fields\CWidgetFieldGraphDataSet; (new CWidgetFormView($data)) ->addField( new CWidgetFieldMultiSelectItemView($data['fields']['itemid'], $data['captions']['items']['itemid']) ) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']), 'js-advanced-configuration' ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']), 'js-advanced-configuration' ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_widget_form.init('.json_encode([ 'color_palette' => CWidgetFieldGraphDataSet::DEFAULT_COLOR_PALETTE ], JSON_THROW_ON_ERROR).');') ->show(); ``` # dashboard.create # dashboard.create # dashboard.delete # dashboard.delete # dashboard.get # dashboard.get # > Dashboard object The following objects are directly related to the `dashboard` API. # > Об'єкт інформаційної панелі Наступні об’єкти безпосередньо пов’язані з API `dashboard`. # Dashboard This class is designed to work with dashboards. Object references:\ - [Dashboard](/manual/api/reference/dashboard/object#dashboard) - [Dashboard page](/manual/api/reference/dashboard/object#dashboard_page) - [Dashboard widget](/manual/api/reference/dashboard/object#dashboard_widget) - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard_widget_field) - [Dashboard user](/manual/api/reference/dashboard/object#dashboard_user) - [Dashboard user group](/manual/api/reference/dashboard/object#dashboard_user_group) Available methods:\ - [dashboard.create](/manual/api/reference/dashboard/create) - creating new dashboards - [dashboard.delete](/manual/api/reference/dashboard/delete) - deleting dashboards - [dashboard.get](/manual/api/reference/dashboard/get) - retrieving dashboards - [dashboard.update](/manual/api/reference/dashboard/update) - updating dashboards # Панель приладів Цей клас призначений для роботи з інформаційними панелями. Посилання на об'єкти:\ - [Інформаційна панель](/manual/api/reference/dashboard/object#dashboard) - [Сторінка панелі інструментів](/manual/api/reference/dashboard/object#dashboard_page) - [Віджет інформаційної панелі](/manual/api/reference/dashboard/object#dashboard_widget) - [Поле віджета інформаційної панелі](/manual/api/reference/dashboard/object#dashboard_widget_field) - [Користувач інформаційної панелі](/manual/api/reference/dashboard/object#dashboard_user) - [Група користувачів панелі інструментів](/manual/api/reference/dashboard/object#dashboard_user_group) Доступні методи:\ - [dashboard.create](/manual/api/reference/dashboard/create) - створення нових інформаційних панелей - [dashboard.delete](/manual/api/reference/dashboard/delete) - видалення інформаційних панелей - [dashboard.get](/manual/api/reference/dashboard/get) - отримання інформаційних панелей - [dashboard.update](/manual/api/reference/dashboard/update) - оновлення інформаційних панелей # dashboard.update # dashboard.update #### dashboard [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) Added new [dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) types (11 - User, 12 - Action, 13 - Media type).\ Added new possible value combinations of the dashboard widget field object properties for different widget types:\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Added `"type": 11, "name": "userids", "value": <user ID>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Added `"type": 12, "name": "actionids", "value": <action ID>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Added `"type": 13, "name": "mediatypeids", "value": <media type ID>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Added `"type": 0, "name": "statuses", "value": <0 - In progress; 1 - Sent/Executed; 2 - Failed>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Added `"type": 1, "name": "message", "value": "<any string value>"`.\ [ZBXNEXT-7661](https://support.zabbix.com/browse/ZBXNEXT-7661) `item`: Added `"type": 1, "name": "thresholds.color.<N>", "value": "<hexadecimal color code>"`.\ [ZBXNEXT-7661](https://support.zabbix.com/browse/ZBXNEXT-7661) `item`: Added `"type": 1, "name": "thresholds.threshold.<N>", "value": "<any string value>"`.\ [ZBXNEXT-5491](https://support.zabbix.com/browse/ZBXNEXT-5491) `svggraph`: Added `"type": 1, "name": "ds.data_set_label.<N>", "value": "<any string value>"`.\ [ZBXNEXT-8165](https://support.zabbix.com/browse/ZBXNEXT-8165) `tophosts`: Added `"type": 0, "name": "columns.decimal_places.<N>", "value": <valid values range: 0-10>`.\ #### dashboard [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) Додано нові типи [полів віджетів панелі інструментів](/manual/api/reference/dashboard/object#dashboard-widget-field) (11 - Користувач, 12 - Дія, 13 - Методи повідомлень).\ Додано нові можливі комбінації значень властивостей об’єкта поля віджета інформаційної панелі для різних типів віджетів:\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: додано `"type": 11, "name": "userids", "value": <user ID> `.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: додано `"type": 12, "name": "actionids", "value": <action ID> `.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: додано `"type": 13, "name": "mediatypeids", "value": <media type ID >`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: додано `"type": 0, "name": "statuses", "value": <0 - In progress 1 - Sent/Executed; 2 - Failed>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: додано `"type": 1, "name": "message", "value": "<any string value>"`.\ [ZBXNEXT-7661](https://support.zabbix.com/browse/ZBXNEXT-7661) `item`: додано `"type": 1, "name": "thresholds.color.<N>", "value" ": "<шістнадцятковий код кольору>"`.\ [ZBXNEXT-7661](https://support.zabbix.com/browse/ZBXNEXT-7661) `item`: додано `"type": 1, "name": "thresholds.threshold.<N>", "value" ": "<any string value>"`.\ [ZBXNEXT-5491](https://support.zabbix.com/browse/ZBXNEXT-5491) `svggraph`: додано `"type": 1, "name": "ds.data_set_label.<N>", "value" ": "<any string value>"`.\ [ZBXNEXT-8165](https://support.zabbix.com/browse/ZBXNEXT-8165) `tophosts`: додано `"type": 0, "name": "columns.decimal_places.<N>", "value" ": <діапазон дійсних значень: 0-10>`.\ # dcheck.get # dcheck.get ### description Module description. *Type*: String *Example*: ```json "description": "This is a clock widget." ``` ### description Опис модуля. *Тип*: String *Приклад*: ```json "description": "Це віджет годинника." ``` ### 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/users/user_roles) for more information. ::: ### Опис `object action.create(object/array actions)` Цей метод дозволяє створювати нові дії. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/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 These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Action log*](/manual/web_interface/frontend_sections/dashboards/widgets/action_log) widget in `dashboard.create` and `dashboard.update` methods. ### Опис Ці параметри та можливі значення властивостей для відповідних об'єктів полів віджета дашборду дозволяють налаштувати віджет [*Action log*](/manual/web_interface/frontend_sections/dashboards/widgets/action_log) у методах `dashboard.create` та `dashboard.update`. ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## ОПИС **zabbix\_agent2** — додаток для моніторингу параметрів різних сервісів.\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## ОПИС **zabbix\_agentd** — це демон для моніторингу різних параметрів сервера. [ ]{#lbAE} ## DESCRIPTION **zabbix\_get** is a command line utility for getting data from Zabbix agent. [ ]{#lbAE} ## ОПИС **zabbix\_get** — утиліта командного рядка для отримання даних від агента Zabbix. [ ]{#lbAE} ## DESCRIPTION **zabbix\_js** is a command line utility that can be used for embedded script testing. [ ]{#lbAE} ## ОПИС **zabbix\_js** — це утиліта командного рядка, яку можна використовувати для тестування вбудованих сценаріїв. [ ]{#lbAE} ## DESCRIPTION **zabbix\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE} ## ОПИС **zabbix\_proxy** — це демон, який збирає дані моніторингу з пристроїв і надсилає їх на сервер Zabbix. [ ]{#lbAE} ## DESCRIPTION **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE} ## ОПИС **zabbix\_sender** — це утиліта командного рядка для надсилання даних моніторингу на сервер або проксі Zabbix. На сервері Zabbix має бути створений елемент типу **Zabbix trapper** з відповідним ключем. Зауважте, що вхідні значення прийматимуться лише від хостів, указаних у полі **Allowed hosts** для цього елемента. [ ]{#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} # Developer Center This section contains everything you need to quickly start developing custom Zabbix extensions: - [Frontend modules](/devel/modules) - [Dashboard widgets](/devel/modules/widgets) - [Plugins](/devel/plugins) for Zabbix agent 2 # Центр розробників У цьому розділі міститься все, що вам потрібно, щоб швидко розпочати розробку власних розширень Zabbix: - [Модулі інтерфейсу](/devel/modules) - [Віджети інформаційної панелі](/devel/modules/widgets) - [Плагіни](/devel/plugins) для Zabbix agent 2 # dhost.get # dhost.get ### Disabling HA cluster 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 з активного основного сервера - перезапустіть основний сервер (він запуститься в автономному режимі) ### 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|рядок|ID виявленого хоста.| |druleid|рядок|ID правила виявлення, яке виявило хост.| |lastdown|мітка часу|Час останнього виходу з ладу знайденого хоста.| |lastup|мітка часу|Час, коли виявлений хост востаннє піднімався.| |статус|ціле число|Чи відкритий хост працює чи не працює. Хост працює, якщо на ньому є принаймні одна активна виявлена служба.<br><br>Можливі значення:<br>0 - хост працює;<br>1 - хост не працює.| # > Discovered host object The following objects are directly related to the `dhost` API. # > Виявлений хост-об’єкт Наступні об’єкти безпосередньо пов’язані з `dhost` API. # Discovered host This class is designed to work with discovered hosts. Object references:\ - [Discovered host](/manual/api/reference/dhost/object#discovered_host) Available methods:\ - [dhost.get](/manual/api/reference/dhost/get) - retrieve discovered hosts # Виявлений хост Цей клас призначений для роботи з відкритими хостами. Посилання на об'єкти:\ - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) Доступні методи:\ - [dhost.get](/manual/api/reference/dhost/get) - отримати виявлені хости ### Discovered service ::: noteclassic Discovered services are created by the Zabbix server and cannot be modified via the API. ::: The discovered service object contains information about a service discovered by a network discovery rule on a host. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dserviceid|string|ID of the discovered service.| |dcheckid|string|ID of the discovery check used to detect the service.| |dhostid|string|ID of the discovered host running the service.| |dns|string|DNS of the host running the service.| |ip|string|IP address of the host running the service.| |lastdown|timestamp|Time when the discovered service last went down.| |lastup|timestamp|Time when the discovered service last went up.| |port|integer|Service port number.| |status|integer|Status of the service.<br><br>Possible values:<br>0 - service up;<br>1 - service down.| |value|string|Value returned by the service when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.| ### Виявлена служба ::: noteclassic Виявлені служби створюються сервером Zabbix і не можуть бути змінені через API. ::: Виявлений об’єкт служби містить інформацію про службу, виявлену за допомогою правила виявлення мережі на хості. Має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |dserviceid|рядок|ID виявленої служби.| |dcheckid|рядок|Ідентифікатор перевірки відкриття, який використовується для виявлення служби.| |dhostid|рядок|Ідентифікатор виявленого хоста, на якому запущена служба.| |dns|рядок|DNS хоста, на якому запущена служба.| |ip|рядок|IP-адреса хоста, на якому запущена служба.| |lastdown|мітка часу|Час останнього вимкнення знайденої служби.| |lastup|timestamp|Час останнього підключення знайденої служби.| |порт|ціле|Номер порту служби.| |статус|ціле|Статус служби.<br><br>Можливі значення:<br>0 - послуга активна;<br>1 - служба не працює.| |значення|рядок|Значення, яке повертає служба під час виконання перевірки виявлення агента Zabbix, SNMPv1, SNMPv2 або SNMPv3.| # > Discovered service object The following objects are directly related to the `dservice` API. # > Виявлений службовий об'єкт Наступні об’єкти безпосередньо пов’язані з `dservice` API. # Discovered service This class is designed to work with discovered services. Object references:\ - [Discovered service](/manual/api/reference/dservice/object#discovered_service) Available methods:\ - [dservice.get](/manual/api/reference/dservice/get) - retrieve discovered services # Виявлена служба Цей клас призначений для роботи з виявленими службами. Посилання на об'єкти:\ - [Виявлена служба](/manual/api/reference/dservice/object#discovered_service) Доступні методи:\ - [dservice.get](/manual/api/reference/dservice/get) - отримати виявлені служби # > Discovery check object The following objects are directly related to the `dcheck` API. # > Об'єкт перевірки виявлення Наступні об’єкти безпосередньо пов’язані з `dcheck` API. # Discovery check This class is designed to work with discovery checks. Object references:\ - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) Available methods:\ - [dcheck.get](/manual/api/reference/dcheck/get) - retrieve discovery checks # Перевірка виявлення Цей клас призначений для роботи з перевірками виявлення. Посилання на об'єкти:\ - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) Доступні методи:\ - [dcheck.get](/manual/api/reference/dcheck/get) - отримати перевірки виявлення ##### 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}. ::: ##### 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}. ::: # discoveryrule.copy # discoveryrule.copy # discoveryrule.create # discoveryrule.create # discoveryrule.delete # discoveryrule.delete # discoveryrule.get # discoveryrule.get # > Discovery rule object The following objects are directly related to the `drule` API. # > Об'єкт правила виявлення Наступні об’єкти безпосередньо пов’язані з API `drule`. # Discovery rule This class is designed to work with network discovery rules. ::: notetip This API is meant to work with network discovery rules. For the low-level discovery rules see the [LLD rule API](discoveryrule). ::: Object references:\ - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) Available methods:\ - [drule.create](/manual/api/reference/drule/create) - create new discovery rules - [drule.delete](/manual/api/reference/drule/delete) - delete discovery rules - [drule.get](/manual/api/reference/drule/get) - retrieve discovery rules - [drule.update](/manual/api/reference/drule/update) - update discovery rules # Правило відкриття Цей клас призначений для роботи з правилами виявлення мережі. ::: notetip Цей API призначений для роботи з правилами виявлення мережі. Правила виявлення низького рівня див. у [API правил LLD](discoveryrule). ::: Посилання на об'єкти:\ - [Правило виявлення](/manual/api/reference/drule/object#discovery_rule) Доступні методи:\ - [drule.create](/manual/api/reference/drule/create) - створити нові правила відкриття - [drule.delete](/manual/api/reference/drule/delete) - видалити правила виявлення - [drule.get](/manual/api/reference/drule/get) - отримання правил виявлення - [drule.update](/manual/api/reference/drule/update) - оновлення правил виявлення # discoveryrule.update # discoveryrule.update #### discoveryrule [ZBXNEXT-6406](https://support.zabbix.com/browse/ZBXNEXT-6406) Property `interfaceid` is no longer mandatory for [LLD rule](/manual/api/reference/discoveryrule/object#lld-rule) types "Simple check" (3), "External check" (10), "SSH agent" (13), and "TELNET agent" (14).\ [ZBXNEXT-4428](https://support.zabbix.com/browse/ZBXNEXT-4428), [ZBXNEXT-8246](https://support.zabbix.com/browse/ZBXNEXT-8246) Added new [LLD rule preprocessing](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) types "SNMP walk value" (28), "SNMP walk to JSON" (29).\ #### discoveryrule [ZBXNEXT-6406](https://support.zabbix.com/browse/ZBXNEXT-6406) Властивість `interfaceid` більше не є обов’язковою для [правила LLD](/manual/api/reference/discoveryrule/object#lld-rule ) типу «Проста перевірка» (3), «Зовнішня перевірка» (10), «Агент SSH» (13) і «Агент TELNET» (14).\ [ZBXNEXT-4428](https://support.zabbix.com/browse/ZBXNEXT-4428), [ZBXNEXT-8246](https://support.zabbix.com/browse/ZBXNEXT-8246) Додано нові типи [правил попередньої обробки LLD](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) «SNMP walk value» (28), «SNMP walk to JSON» (29).\ #### 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/dashboards##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. #### Відображення На основі інформації про підтвердження можна налаштувати спосіб відображення кількості проблем на інформаційній панелі чи картах. Для цього вам потрібно зробити вибір у параметрі *Відображення проблеми*, доступному як у [map configuration](/manual/config/visualization/maps/map#creating_a_map), так і в *Проблеми за ступенем тяжкості* [віджеті панелі інструментів]( /manual/web_interface/frontend_sections/dashboards##adding_widgets). Можна відобразити кількість усіх проблем, кількість непідтверджених проблем окремо від загальної чи тільки кількість непідтверджених проблем. На основі інформації про оновлення проблеми (підтвердження тощо) можна налаштувати операції оновлення – надіслати повідомлення або виконати віддалені команди. #### 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. #### Відображення статусу тригера Якщо тригер визначено, вам може бути цікаво переглянути його статус. Якщо навантаження ЦП перевищило пороговий рівень, який ви визначили в тригері, проблема буде відображена в *Моніторинг → Проблеми*. {width="600"} Блимання в стовпці статусу вказує на нещодавню зміну статусу тригера, яка відбулася за останні 30 хвилин. #### Display Once suppressed the problem is marked by a blinking  suppression icon in the *Info* column, before being hidden. The suppression icon is blinking while the suppression task is in the waiting list. Once the task manager has suppressed the problem, the icon will stop blinking. If the suppression icon keeps blinking for a long time, this may indicate a server problem, for example, if the server is down and the task manager cannot complete the task. The same logic applies to unsuppression. In the short period after the task is submitted and the server has not completed it, the unsuppression icon is blinking. A suppressed problem may be both hidden or shown, depending on the problem filter/widget settings. When shown in the problem list, a suppressed problem is marked by the suppression icon and suppression details are shown on mouseover:  Suppression details are also displayed in a popup when positioning the mouse on the suppression icon in the *Actions* column. #### Відображення Після приховування проблема позначається блиманням  значка приховування в стовпці *Інформація*, перш ніж його приховати. Значок придушення блимає, поки завдання придушення знаходиться в списку очікування. Після того, як диспетчер завдань вирішить проблему, значок перестане блимати. Якщо піктограма придушення продовжує блимати протягом тривалого часу, це може вказувати на проблему з сервером, наприклад, якщо сервер не працює і диспетчер завдань не може завершити завдання. Така ж логіка застосовується і до зняття приховування. Протягом короткого періоду після того, як завдання було надіслано, але сервер не встиг його виконати, піктограма зняття приховування блимає. Прихована проблема може бути як прихованою, так і відображеною, залежно від налаштувань фільтра проблеми/віджета. При відображенні у списку проблем прихована проблема позначається піктограмою придушення та деталі придушення показуються при наведенні миші:  Деталі придушення також відображаються у спливаючому вікні, якщо навести курсор миші на придушення у стовпці *Дії*. # drule.create # drule.create # drule.delete # drule.delete # drule.get # drule.get # drule.update # drule.update #### drule [ZBXNEXT-7921](https://support.zabbix.com/browse/ZBXNEXT-7921) Removed property `nextcheck`.\ #### drule [ZBXNEXT-7921](https://support.zabbix.com/browse/ZBXNEXT-7921) Видалено властивість `nextcheck`.\ # dservice.get # dservice.get #### Element tags Element tag values are explained in the table below. #### Теги елементів даних Значення тегів елемента даних пояснюються в таблиці нижче. #### Element tags Element tag values are explained in the table below. #### Теги елементів Значення тегів елемента пояснюються в таблиці нижче. #### 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 *Alerts → Media types* and click on *Email* in the list of pre-defined media types.  This will present us with the email settings definition 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. #### Налаштування електронної пошти Спочатку в Zabbix існує кілька попередньо визначених [методів доставки](/manual/config/notifications/media) сповіщень. [Електронна пошта](/manual/config/notifications/media/email) є одним із них. Щоб налаштувати параметри електронної пошти, перейдіть до *Сповіщення → Типи медіа* та натисніть *Електронна пошта* у списку попередньо визначених типів медіа.  Це надасть нам форму визначення параметрів електронної пошти.  Усі обов’язкові поля для введення позначені червоною зірочкою. На вкладці *Тип медіа* встановіть значення сервера SMTP, SMTP helo та електронну адресу SMTP відповідно до вашого середовища. ::: noteclassic 'Електронна адреса SMTP' використовуватиметься як адреса 'Від' для повідомлень, надісланих із Zabbix. ::: Далі необхідно визначити зміст повідомлення про проблему. Зміст визначається за допомогою шаблону повідомлення, налаштованого на вкладці *Шаблони повідомлень*. Натисніть *Додати*, щоб створити шаблон повідомлення, і виберіть *Проблема* як тип повідомлення.  Натисніть *Додати*, коли будете готові, і збережіть форму. Тепер ви налаштували 'Електронну пошту' як робочий тип медіа. Тип медіа також має бути пов’язаний із користувачами шляхом визначення конкретних адрес доставки (як ми робили під час [налаштування нового користувача](login#adding_user)), інакше він не використовуватиметься. ### Enabling high availability ### Увімкнення високої доступності #### Error handling Up to the present moment, everything you have tried has worked fine. But what would happen if you tried making an incorrect call to the API? Try to create another host by calling [host.create](/manual/api/reference/host/create) but omitting the mandatory `groups` parameter: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.create","params":{"host":"Linux server","interfaces":[{"type":1,"main":1,"useip":1,"ip":"192.168.3.1","dns":"","port":"10050"}]},"id":7}' ``` The response will then contain an error message: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` If an error has occurred, instead of the `result` property, the response object will contain the `error` property with the following data: - `code` - an error code; - `message` - a short error summary; - `data` - a more detailed error message. Errors can occur in various cases, such as, using incorrect input values, a session timeout or trying to access non-existing objects. Your application should be able to gracefully handle these kinds of errors. #### Обробка помилок До цього моменту все, що ви спробували, працювало нормально. Але що станеться, якщо ви спробуєте зробити некоректний виклик API? Спробуйте створити інший хост, викликавши [host.create](/manual/api/reference/host/create), але опустивши обов'язковий параметр `groups`: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.create","params":{"host":"Linux server","interfaces":[{"type":1,"main":1,"useip":1,"ip":"192.168.3.1","dns":"","port":"10050"}]},"id":7}' ``` Тоді відповідь міститиме повідомлення про помилку: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` Якщо сталася помилка, замість властивості `result` об'єкт відповіді буде містити властивість `error` з наступними даними: - `code` - код помилки; - `message` - короткий опис помилки; - `data` - більш детальне повідомлення про помилку. Помилки можуть виникати у різних випадках, наприклад, при використанні неправильних вхідних даних, таймауті сеансу або спробі отримати доступ до неіснуючих об'єктів. Ваша програма повинна вміти коректно обробляти такі помилки. # event.acknowledge # event.acknowledge # event.get # event.get # > Event object The following objects are directly related to the `event` API. # > Об'єкт події Наступні об’єкти безпосередньо пов’язані з `event` API. ### 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#data_types)|Опис| |--|--|------| |тег|рядок|Назва тегу події.| |значення|рядок|Значення тегу події.| # Event This class is designed to work with events. Object references:\ - [Event](/manual/api/reference/event/object#host) Available methods:\ - [event.get](/manual/api/reference/event/get) - retrieving events - [event.acknowledge](/manual/api/reference/event/acknowledge) - acknowledging events # Подія Цей клас призначений для роботи з подіями. Посилання на об'єкти:\ - [Подія](/manual/api/reference/event/object#host) Доступні методи:\ - [event.get](/manual/api/reference/event/get) - отримання подій - [event.acknowledge](/manual/api/reference/event/acknowledge) - визнання подій #### event [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) Added new property `cause_eventid`.\ [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) `event.acknowledge`: Added new [event update actions](/manual/api/reference/event/acknowledge#parameters) "change event rank to cause" (128), "change event rank to symptom" (256).\ [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) `event.acknowledge`: Added new parameter `cause_eventid`.\ [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) `event.get`: Added new parameter `symptom`.\ #### подeventія [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) Додано нову властивість `cause_eventid`.\ [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) `event.acknowledge`: додано нові [дії оновлення подій](/manual/api/reference/event/acknowledge#parameters) " змінити ранг події на причину" (128), "змінити ранг події на симптом" (256).\ [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) `event.acknowledge`: додано новий параметр `cause_eventid`.\ [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) `event.get`: додано новий параметр `symptom`.\ ### Example ### Приклади ##### 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(/host/web.test.fail[сценарій])<>0 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ##### 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 Щоб створити тригер «Помилка веб-сценарію» з корисним описом проблеми в назві тригера, ви можете визначити тригер із назвою: Помилка веб-сценарію "Сценарій": {ITEM.VALUE} і тригерний вираз: length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ##### 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(/host/web.test.in[Scenario,,bps])<10000 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади #### Examples #### Приклади ##### 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. ##### 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. # Examples This section provides files of sample modules and widgets, which you can use as a base for your custom modules. To use a module: 1. Download the ZIP archive. 2. Unpack the content into a separate directory inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). 3. Register the module in Zabbix frontend. # Приклади У цьому розділі представлені файли зразків модулів та віджетів, які ви можете використовувати як основу для власних модулів. Щоб використовувати модуль: 1. Завантажте ZIP-архів. 2. Розпакуйте вміст в окремий підкаталог у каталозі з *модулями* web-серверу Zabbix (наприклад */zabbix/ui/modules*). 3. Зареєструйте модуль у інтерфейсі Zabbix. # Examples You can use several empty examples as well as existing loadable plugins supplied by Zabbix as a reference: - [Examples](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/debug/external) - [MongoDB plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse) - [PostgreSQL plugin](https://git.zabbix.com/projects/AP/repos/postgresql/browse) # Приклади Ви можете використати кілька порожніх прикладів, а також існуючі плагіни, що можна завантажити, надані Zabbix, як посилання: - [Приклади](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/debug/external) - [Плагін MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse) - [Плагін PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse) ## 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 "Monitored Host" -k mysql.queries -o 342.45**\ Надішліть **342.45** як значення для елемента **mysql.queries** хосту **Monitored Host** за допомогою сервера 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 server" 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 "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**\ Надішліть **342.45** як значення для елемента **mysql.queries** у хості **Monitored Host** на сервер з IP-адресою **192.168.1.113** за допомогою TLS із сертифікатом. **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**\ Надішліть **342.45** як значення для елемента **mysql.queries** у хості **Monitored Host** на сервер з IP-адресою **192.168.1.113** за допомогою TLS зі спільним ключем (PSK). [ ]{#lbAI} ### Example workflow The following section will walk you through some examples of usage in a greater detail. ### Приклад робочого процесу У наступному розділі ми розглянемо деякі приклади використання більш детально. ## 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} ##### 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. ### 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 ``` ## 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 agent 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} ##### - 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 agent (10050 TCP) і Zabbix trapper (10051 TCP); - Відкриті порти HTTP (80 TCP) і HTTPS (443 TCP); - Відкритий порт SNMP trap (162 UDP); - Відкриті вихідні з'єднання на порт NTP (53 UDP); - Пакети ICMP обмежені 5 пакетами в секунду; - Усі інші вхідні з'єднання скидаються. ### Float history The float history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|float|Received value.| ### Історія плавання Об'єкт історії float має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |годинник|мітка часу|Час, коли це значення було отримано.| |itemid|рядок|ID пов'язаного елемента.| |ns|ціле|Наносекунди, коли було отримано значення.| |value|float|Отримане значення.| ##### 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) у цій таблиці використовуються лише для впорядкування. #### 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 підтримують два загальні параметри: `item filter` (деталі див. нижче) і `time period`: foreach_function(фільтр елементів,період часу) Наприклад: `avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)` поверне п’ятихвилинне середнє значення кожного елемента «mysql.qps» у групі сервера MySQL. Зауважте, що деякі функції підтримують додаткові [параметри](#additional_parameters). ### Further reading Now, you have enough knowledge to start working with the Zabbix API, however, do not stop here. For further reading you are advised to have a look at the [list of available APIs](/manual/api/reference). ### Більше інформації Тепер у вас достатньо знань, щоб почати працювати з Zabbix API, однак не зупиняйтеся на цьому. Для подальшого читання радимо переглянути [список доступних API](/manual/api/reference). # graph.create # graph.create # graph.delete # graph.delete # graph.get # graph.get # graphitem.get # graphitem.get # > Graph item object The following objects are directly related to the `graphitem` API. # > Об'єкт елемента графіка Наступні об’єкти безпосередньо пов’язані з API `graphitem`. # Graph item This class is designed to work with graph items. Object references:\ - [Graph item](/manual/api/reference/graphitem/object#graph_item) Available methods:\ - [graphitem.get](/manual/api/reference/graphitem/get) - retrieving graph items # Елемент графіка Цей клас призначений для роботи з елементами графа. Посилання на об'єкти:\ - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) Доступні методи:\ - [graphitem.get](/manual/api/reference/graphitem/get) - отримання елементів графіка # > Graph object The following objects are directly related to the `graph` API. # > Графічний об'єкт Наступні об’єкти безпосередньо пов’язані з API `graph`. # graphprototype.create # graphprototype.create # graphprototype.delete # graphprototype.delete # graphprototype.get # graphprototype.get # > Graph prototype object The following objects are directly related to the `graphprototype` API. # > Об'єкт прототипу Graph Наступні об’єкти безпосередньо пов’язані з API `graphprototype`. # Graph prototype This class is designed to work with graph prototypes. Object references:\ - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) Available methods:\ - [graphprototype.create](/manual/api/reference/graphprototype/create) - creating new graph prototypes - [graphprototype.delete](/manual/api/reference/graphprototype/delete) - deleting graph prototypes - [graphprototype.get](/manual/api/reference/graphprototype/get) - retrieving graph prototypes - [graphprototype.update](/manual/api/reference/graphprototype/update) - updating graph prototypes # Прототип графа Цей клас призначений для роботи з прототипами графів. Посилання на об'єкти:\ - [Прототип графіка](/manual/api/reference/graphprototype/object#graph_prototype) Доступні методи:\ - [graphprototype.create](/manual/api/reference/graphprototype/create) - створення нових прототипів графів - [graphprototype.delete](/manual/api/reference/graphprototype/delete) - видалення прототипів графів - [graphprototype.get](/manual/api/reference/graphprototype/get) - отримання прототипів графів - [graphprototype.update](/manual/api/reference/graphprototype/update) - оновлення прототипів графів # graphprototype.update # graphprototype.update #### graphprototype [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graphprototype.get`: Graph prototype availability does not depend on permissions to the items specified in the [graph prototype properties](/manual/api/reference/graphprototype/object#graph-prototype) `ymin_itemid` and `ymax_itemid`.\ #### graphprototype [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graphprototype.get`: Доступність прототипу графа не залежить від прав доступу до елементів, вказаних у [властивості прототипу графа](/manual/api/reference/graphprototype/object#graph-prototype) `ymin_itemid` та `ymax_itemid`.\ ##### 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 This class is designed to work with graphs. Object references:\ - [Graph](/manual/api/reference/graph/object#graph) Available methods:\ - [graph.create](/manual/api/reference/graph/create) - creating new graphs - [graph.delete](/manual/api/reference/graph/delete) - deleting graphs - [graph.get](/manual/api/reference/graph/get) - retrieving graphs - [graph.update](/manual/api/reference/graph/update) - updating graphs # Графік Цей клас призначений для роботи з графіками. Посилання на об'єкти:\ - [Графік](/manual/api/reference/graph/object#graph) Доступні методи:\ - [graph.create](/manual/api/reference/graph/create) - створення нових графіків - [graph.delete](/manual/api/reference/graph/delete) - видалення графіків - [graph.get](/manual/api/reference/graph/get) - отримання графіків - [graph.update](/manual/api/reference/graph/update) - оновлення графіків # graph.update # graph.update #### graph [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graph.get`: Graph availability does not depend on permissions to the items specified in the [graph properties](/manual/api/reference/graph/object#graph) `ymin_itemid` and `ymax_itemid`.\ #### graph [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graph.get`: доступність графа не залежить від дозволів на елементи, указані у [властивості графа](/manual/api) /reference/graph/object#graph) `ymin_itemid` і `ymax_itemid`.\ # hanode.get # hanode.get # > High availability node object The following object is related to operating a High availability cluster of Zabbix servers. # > Об'єкт вузла високої доступності Наступний об’єкт пов’язаний з керуванням кластером високої доступності серверів Zabbix. # High availability node This class is designed to work with server nodes that are part of a High availability cluster, or a standalone server instance. Object references:\ - [High availability node](/manual/api/reference/hanode/object#hanode) Available methods:\ - [hanode.get](/manual/api/reference/hanode/get) - retrieving nodes # Вузол високої доступності Цей клас призначений для роботи з серверними вузлами, які є частиною кластера високої доступності або окремого екземпляра сервера. Посилання на об'єкти:\ - [Вузол високої доступності](/manual/api/reference/hanode/object#hanode) Доступні методи:\ - [hanode.get](/manual/api/reference/hanode/get) - отримання вузлів # history.clear # history.clear # history.get # history.get # > History object The following objects are directly related to the `history` API. ::: noteclassic History objects differ depending on the item's type of information. They are created by the Zabbix server and cannot be modified via the API. ::: # > Об'єкт історії Наступні об’єкти безпосередньо пов’язані з API історії. ::: noteclassic Об’єкти історії відрізняються залежно від типу інформації елемента. Вони створюються сервером Zabbix і не можуть бути змінені через API. ::: # History This class is designed to work with history data. Object references:\ - [History](/manual/api/reference/history/object#history) Available methods:\ - [history.get](/manual/api/reference/history/get) - retrieving history data. # Історія Цей клас призначений для роботи з даними історії. Посилання на об'єкти:\ - [Історія](/manual/api/reference/history/object#history) Доступні методи:\ - [history.get](/manual/api/reference/history/get) - отримання даних історії. # host.create # host.create # host.delete # host.delete # host.get # host.get # 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 object The following objects are directly related to the `hostgroup` API. # > Об'єкт групи хостів Наступні об’єкти безпосередньо пов’язані з API `hostgroup`. # hostgroup.update # hostgroup.update # hostinterface.create # hostinterface.create # hostinterface.delete # hostinterface.delete # hostinterface.get # hostinterface.get # hostinterface.massadd # hostinterface.massadd # hostinterface.massremove # hostinterface.massremove # > Host interface object The following objects are directly related to the `hostinterface` API. # > Об'єкт інтерфейсу хоста Наступні об’єкти безпосередньо пов’язані з API 'hostinterface'. # hostinterface.replacehostinterfaces # hostinterface.replacehostinterfaces # Host interface This class is designed to work with host interfaces. Object references:\ - [Host interface](/manual/api/reference/hostinterface/object#host_interface) Available methods:\ - [hostinterface.create](/manual/api/reference/hostinterface/create) - creating new host interfaces - [hostinterface.delete](/manual/api/reference/hostinterface/delete) - deleting host interfaces - [hostinterface.get](/manual/api/reference/hostinterface/get) - retrieving host interfaces - [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - adding host interfaces to hosts - [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - removing host interfaces from hosts - [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - replacing host interfaces on a host - [hostinterface.update](/manual/api/reference/hostinterface/update) - updating host interfaces # Інтерфейс вузла Цей клас призначений для роботи з інтерфейсами вузлів. Посилання на об'єкти:\ - [Інтерфейс вузла](/manual/api/reference/hostinterface/object#host_interface) Доступні методи:\ - [hostinterface.create](/manual/api/reference/hostinterface/create) - створення нових інтерфейсів вузла - [hostinterface.delete](/manual/api/reference/hostinterface/delete) - видалення інтерфейсів вузла - [hostinterface.get](/manual/api/reference/hostinterface/get) - отримання інтерфейсів вузла - [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - масове додавання інтерфейсів до вузлів - [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - масове видалення інтерфейсів з вузлів - [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - заміна інтерфейсів на вузлі - [hostinterface.update](/manual/api/reference/hostinterface/update) - оновлення інтерфейсів вузла # hostinterface.update # hostinterface.update # host.massadd # host.massadd # host.massremove # host.massremove # host.massupdate # host.massupdate # hostprototype.create # hostprototype.create # hostprototype.delete # hostprototype.delete # hostprototype.get # hostprototype.get # > Host prototype object The following objects are directly related to the `hostprototype` API. # > Об'єкт прототипу хосту Наступні об’єкти безпосередньо пов’язані з API `hostprototype`. # hostprototype.update # hostprototype.update # host.update # host.update # housekeeping.get # housekeeping.get # > Housekeeping object The following objects are directly related to the `housekeeping` API. # > Господарський об'єкт Наступні об’єкти безпосередньо пов’язані з API «housekeeping». # housekeeping.update # housekeeping.update ### How modules work - An enabled module is launched on each HTTP request, before executing the action code. - The module will register new actions or redefine the existing ones. - The module will add new frontend sections and remove or redefine the existing ones. - The module will hook to frontend events like onBeforeAction and onTerminate, if needed. - The requested action is finally executed by running the action code - either the default one, or module-defined. ### Як працюють модулі - Увімкнений модуль запускається під час кожного HTTP запиту перед виконанням коду дії. - Модуль буде реєструвати нові дії або перевизначати існуючі. - Модуль додасть нові розділи інтерфейсу та видалить або перевизначить існуючі. - Якщо потрібно, модуль підключатиметься до зовнішніх подій, таких як onBeforeAction і onTerminate. - Запитувана дія остаточно виконується шляхом запуску коду дії - стандартного або визначеного модулем. # httptest.create # httptest.create # httptest.delete # httptest.delete # httptest.get # httptest.get # httptest.update # httptest.update #### httptest [ZBXNEXT-7921](https://support.zabbix.com/browse/ZBXNEXT-7921) Removed property `nextcheck`.\ #### httptest [ZBXNEXT-7921](https://support.zabbix.com/browse/ZBXNEXT-7921) Видалено властивість `nextcheck`.\ # iconmap.create # iconmap.create # iconmap.delete # iconmap.delete # iconmap.get # iconmap.get # iconmap.update # iconmap.update ### id Module ID. Must be unique. To avoid future naming conflicts, it is recommended to use prefix for modules (author or company name, or any other). For example, if a module is an example for lessons and the module name is "My module", then the ID will be "example_my_module". *Type*: String *Example*: ```json "id": "example_my_module" ``` ### id ID модуля. Повинно бути унікальним. Щоб уникнути майбутніх конфліктів іменування, рекомендується використовувати префікс для модулів (назва автора, компанії чи будь-який інший). Наприклад, якщо модуль є прикладом для уроків, а назва модуля – «Мій модуль», тоді ідентифікатор буде «example_my_module». *Тип*: String *Приклад*: ```json "id": "example_my_module" ``` # image.create # image.create # image.delete # image.delete # image.get # image.get # 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. ## 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) ------------------------------------------------------------------------ Цей документ створено о 21:23:35 GMT, 18 березня 2020 року ## 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) ------------------------------------------------------------------------ Цей документ створено о 12:58:30 GMT, 11 червня 2021 року ## 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 ## Покажчик [ІМ'Я](# фунтів АБ) [СИНТАКСИС](#lbAC) [ОПИС](#lb AD) [ПААМЕТРИ](#lbAE) [](#lbAF) [ПРИКЛАДИ](#lbAG) [ДИВ. ТАКОЖ](#lbAH) [АВТОР](#lbAI) -------------------------------------------------- ---------------------- Цей документ створено о 08:42:29 GMT, 11 червня 2021 року ## 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) ------------------------------------------------------------------------ Цей документ створено: 08:42:39 GMT, 11 червня 2021 року ## 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) -------------------------------------------------- ---------------------- Цей документ створено о 14:07:57 GMT, 22 листопада 2021 року ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [](#lbAG) [FILES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created by [man2html](/manpages), using the manual pages.\ Time: 20:50:13 GMT, November 22, 2021 ## Покажчик [ІМ'Я](#lbAB) [СИНТАКСИС](#lbAC) [ОПИС](#lbAD) [ОПЦІЇ](#lbAE) [](#lbAF) [](#lbAG) [ФАЙЛИ](#lbAH) [ДИВ. ТАКОЖ](#lbAI) [АВТОР](#lbAJ) -------------------------------------------------- ---------------------- Цей документ створено [man2html](/manpages), за допомогою сторінок посібника.\ Час: 20:50:13 GMT, 22 листопада 2021 року ## 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) -------------------------------------------------- ---------------------- Цей документ створено о 16:12:22 GMT, 04 вересня 2020 року #### 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), файли перекладу слід створити вручну. Щоб створити файли перекладу, запустіть: зробити gettext locale/make_mo.sh Цей крок не потрібен, якщо Zabbix встановлюється з пакетів або вихідних файлів tar.gz. ### 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)|Опис| |--|--|------| |годинник|мітка часу|Час, коли це значення було отримано.| |itemid|рядок|ID пов'язаного елемента.| |ns|ціле|Наносекунди, коли було отримано значення.| |значення|ціле|Отримане значення.| # item.create # item.create # item.delete # item.delete # item.get # item.get # itemprototype.create # itemprototype.create # itemprototype.delete # itemprototype.delete # itemprototype.get # itemprototype.get # itemprototype.update # itemprototype.update #### itemprototype [ZBXNEXT-6406](https://support.zabbix.com/browse/ZBXNEXT-6406) Property `interfaceid` is no longer mandatory for [item prototype](/manual/api/reference/itemprototype/object#item-prototype) types "Simple check" (3), "External check" (10), "SSH agent" (13), and "TELNET agent" (14).\ [ZBXNEXT-4428](https://support.zabbix.com/browse/ZBXNEXT-4428), [ZBXNEXT-8246](https://support.zabbix.com/browse/ZBXNEXT-8246) Added new [item prototype preprocessing](/manual/api/reference/itemprototype/object#item-prototype-preprocessing) types "SNMP walk value" (28), "SNMP walk to JSON" (29).\ #### itemprototype [ZBXNEXT-6406](https://support.zabbix.com/browse/ZBXNEXT-6406) Властивість `interfaceid` більше не є обов'язковою для типів [item prototype](/manual/api/reference/itemprototype/object#item-prototype) «Проста перевірка» (3), «Зовнішня перевірка» (10), «SSH-агент» (13) і «TELNET-агент» (14).\ [ZBXNEXT-4428](https://support.zabbix. com/browse/ZBXNEXT-4428), [ZBXNEXT-8246](https://support.zabbix.com/browse/ZBXNEXT-8246) Додано нові типи [попередня обробка прототипу елемента даних](/manual/api/reference/itemprototype/object#item-prototype-preprocessing): «SNMP walk value» (28), «SNMP walk to JSON» (29).\ #### itemprototype [ZBXNEXT-6980](https://support.zabbix.com/browse/ZBXNEXT-6980) `itemprototype.create`, `itemprototype.update`: Added strict validation of the method parameters.\ #### itemprototype [ZBXNEXT-6980](https://support.zabbix.com/browse/ZBXNEXT-6980) `itemprototype.create`, `itemprototype.update`: додано сувору перевірку параметрів методу.\ # item.update # item.update #### item [ZBXNEXT-6406](https://support.zabbix.com/browse/ZBXNEXT-6406) Property `interfaceid` is no longer mandatory for [item](/manual/api/reference/item/object#item) types "Simple check" (3), "External check" (10), "SSH agent" (13), and "TELNET agent" (14).\ [ZBXNEXT-4428](https://support.zabbix.com/browse/ZBXNEXT-4428), [ZBXNEXT-8246](https://support.zabbix.com/browse/ZBXNEXT-8246) Added new [item preprocessing](/manual/api/reference/item/object#item-preprocessing) types "SNMP walk value" (28), "SNMP walk to JSON" (29).\ #### item [ZBXNEXT-6406](https://support.zabbix.com/browse/ZBXNEXT-6406) Властивість `interfaceid` більше не є обов'язковою для типів [item](/manual/api/reference/item/object#item) «Проста перевірка» (3), «Зовнішня перевірка» (10), «SSH-агент» (13) та «TELNET-агент» (14).\ [ZBXNEXT-4428](https://support.zabbix. com/browse/ZBXNEXT-4428), [ZBXNEXT-8246](https://support.zabbix.com/browse/ZBXNEXT-8246) Додано нові типи [item preprocessing](/manual/api/reference/item/object#item-preprocessing) «SNMP walk value» (28), «SNMP walk to JSON» (29).\ #### item [ZBXNEXT-6980](https://support.zabbix.com/browse/ZBXNEXT-6980) `item.create`, `item.update`: Added strict validation of the method parameters.\ #### item [ZBXNEXT-6980](https://support.zabbix.com/browse/ZBXNEXT-6980) `item.create`, `item.update`: додано сувору перевірку параметрів методу.\ ### JavaScript A JavaScript class can be used to add dynamic behavior and interactivity to the widget configuration view. For example, you can initialize a color picker, defined in the [*CWidgetFormView*](#cwidgetformview) class. The JavaScript class should be loaded with the form, therefore it should be referenced in the [*CWidgetFormView*](#cwidgetformview) class by using the methods *includeJsFile()* and *addJavaScript()*. In the example below, a singleton class instance is immediately created and stored under the *window.my_custom_widget_form* name. Thus, opening the form for the second time will re-create the instance. The JavaScript class should be located in the *views* directory. **views/widget.edit.js.php example** ```php <?php use Modules\LessonGaugeChart\Widget; ?> window.widget_lesson_gauge_chart_form = new class { init({color_palette}) { this._advanced_configuration = document.getElementById('adv_conf'); this._advanced_configuration.addEventListener('change', () => this.updateForm()); colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } this.updateForm(); } updateForm() { const show_advanced_configuration = this._advanced_configuration.checked; for (const element of this._form.querySelectorAll('.js-advanced-configuration')) { element.style.display = show_advanced_configuration ? '' : 'none'; } } }; ``` ### JavaScript Клас JavaScript можна використовувати для додавання динамічної поведінки та інтерактивності до view конфігурації віджета. Наприклад, ви можете ініціалізувати засіб вибору кольорів, визначений у класі [*CWidgetFormView*](#cwidgetformview). Клас JavaScript має бути завантажений разом із формою, тому на нього слід посилатися в класі [*CWidgetFormView*](#cwidgetformview) за допомогою методів *includeJsFile()* і *addJavaScript()*. У наведеному нижче прикладі екземпляр класу singleton одразу створюється та зберігається під назвою *window.my_custom_widget_form*. Таким чином, відкриття форми вдруге призведе до повторного створення екземпляра. Клас JavaScript має бути розташований у каталозі *views*. **views/widget.edit.js.php приклад** ```php <?php use Modules\LessonGaugeChart\Widget; ?> window.widget_lesson_gauge_chart_form = new class { init({color_palette}) { this._advanced_configuration = document.getElementById('adv_conf'); this._advanced_configuration.addEventListener('change', () => this.updateForm()); colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } this.updateForm(); } updateForm() { const show_advanced_configuration = this._advanced_configuration.checked; for (const element of this._form.querySelectorAll('.js-advanced-configuration')) { element.style.display = show_advanced_configuration ? '' : 'none'; } } }; ``` ### JavaScript The JavaScript class is responsible for determining widget behavior, such as updating widget data, resizing the widget, displaying widget elements, etc. All JavaScript operations use and/or extend the base JavaScript class of all dashboard widgets - *CWidget*. The *CWidget* class contains a set of methods with the default implementation for widget behavior. Depending on widget complexity, these methods can be utilized as is or extended. The *CWidget* class contains the following methods: - Methods that define widget lifecycle: *\_init()*, *\_registerEvents()*, *\_doActivate()*, *\_doDeactivate()*, *\_doDestroy()*, *setEditMode()*. - Methods that handle updating and displaying widget data: *\_promiseUpdate()*, *\_getUpdateRequestData()*, *\_processUpdateResponse(response)*, *\_processUpdateErrorResponse(error)*, *\_setContents()*. - Methods that modify widget appearance: *resize()*, *\_hasPadding()*. The JavaScript class should be located in the *assets/js* directory and specified in the [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) parameter in the *manifest.json* file. ### JavaScript Клас JavaScript відповідає за визначення поведінки віджетів, наприклад оновлення даних віджетів, зміну розміру віджетів, відображення елементів віджетів тощо. Усі операції JavaScript використовують і/або розширюють базовий клас JavaScript усіх віджетів інформаційної панелі - *CWidget*. Клас *CWidget* містить набір методів із реалізацією за замовчуванням для поведінки віджетів. Залежно від складності віджета, ці методи можна використовувати як є або розширити. Клас *CWidget* містить такі методи: - Методи, що визначають життєвий цикл віджета: *\_init()*, *\_registerEvents()*, *\_doActivate()*, *\_doDeactivate()*, *\_doDestroy()*, *setEditMode()*. - Методи, які обробляють оновлення та відображення даних віджетів: *\_promiseUpdate()*, *\_getUpdateRequestData()*, *\_processUpdateResponse(response)*, *\_processUpdateErrorResponse(error)*, *\_setContents()*. - Методи, які змінюють зовнішній вигляд віджета: *resize()*, *\_hasPadding()*. Клас JavaScript має розташовуватися в каталозі *assets/js* і вказуватися в параметрі [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) у *manifest.json* файл. #### 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` - активувати звичайний режим ##### Lifecycle methods The widget lifecycle methods are invoked by the dashboard, and at different stages of the widget's lifecycle during its existence within the dashboard. ##### Методи життєвого циклу Методи життєвого циклу віджета викликаються інформаційною панеллю та на різних етапах життєвого циклу віджета під час його існування на інформаційній панелі. #### 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, де процесори розподіляються нерівномірно між вузлами NUMA. Якщо логічні ЦП розподілені нерівномірно, показники продуктивності ЦП можуть бути недоступні для деяких ЦП. Наприклад, якщо є 72 логічних ЦП з 2 вузлами NUMA, обидва вузли повинні мати по 36 ЦП кожен. ##### 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 template to host With a template ready, it only remains to add it to a host. For that, go to *Data collection → 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. This way it can be applied to any other host as well. Any changes to the items, triggers and other entities at the template level will propagate to the hosts the template is linked to. #### Пов'язування шаблону з вузлом мережі З шаблоном готово, залишається тільки додати його на вузол мережі. Для цього перейдіть до *Збір даних → Хости*, клацніть 'New host', щоб відкрити форму його властивостей, і знайдіть поле **Шаблони**. Почніть вводити *Новий шаблон* у полі *Шаблони*. Назва шаблону, який ми створили, має з’явитися у спадному списку. Прокрутіть вниз, щоб вибрати. Переконайтеся, що він з’явився в полі *Шаблони*.  Натисніть *Оновити* у формі, щоб зберегти зміни. Тепер шаблон додано до вузла мережі з усіма об’єктами, які він містить. Таким чином його можна також застосувати до будь-якого іншого вузла мережі. Будь-які зміни в елементах даних, тригерах та інших сутностях на рівні шаблону поширюватимуться на вузли мережі, з якими пов’язано шаблон. # > LLD rule object The following objects are directly related to the `discoveryrule` API. # > Об'єкт правила LLD Наступні об’єкти безпосередньо пов’язані з API «discoveryrule». # LLD rule This class is designed to work with low level discovery rules. Object references:\ - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) Available methods:\ - [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) - copying LLD rules - [discoveryrule.create](/manual/api/reference/discoveryrule/create) - creating new LLD rules - [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) - deleting LLD rules - [discoveryrule.get](/manual/api/reference/discoveryrule/get) - retrieving LLD rules - [discoveryrule.update](/manual/api/reference/discoveryrule/update) - updating LLD rules # Правило LLD Цей клас призначений для роботи з правилами виявлення низького рівня. Посилання на об'єкти:\ - [Правило LLD](/manual/api/reference/discoveryrule/object#lld_rule) Доступні методи:\ - [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) - копіювання правил LLD - [discoveryrule.create](/manual/api/reference/discoveryrule/create) - створення нових правил LLD - [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) - видалення правил LLD - [discoveryrule.get](/manual/api/reference/discoveryrule/get) - отримання правил LLD - [discoveryrule.update](/manual/api/reference/discoveryrule/update) - оновлення правил LLD ### 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|рядок|ID запису історії.| |годинник|мітка часу|Час, коли це значення було отримано.| |itemid|рядок|ID пов'язаного елемента.| |logeventid|ціле|Ідентифікатор запису журналу подій Windows.| |ns|ціле|Наносекунди, коли було отримано значення.| |серйозність|ціле|Рівень запису журналу подій Windows.| |джерело|рядок|Джерело запису журналу подій Windows.| |мітка часу|мітка часу|Час запису журналу подій Windows.| |значення|текст|Отримане значення.| #### 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 all menu sections will be granted. #### Вхід {width="350"} Це екран привітання Zabbix. Введіть ім’я користувача **Admin** з паролем **zabbix**, щоб увійти як [суперкористувач Zabbix](/manual/config/users_and_usergroups/permissions). Буде надано доступ до всіх розділів меню. ### Log level control targets *process-type* All processes of specified type (active checks, collector, listener) *process-type,N* Process type and number (e.g., listener,3) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Print known items and exit. For each item either generic defaults are used, or specific defaults for testing are supplied. These defaults are listed in square brackets as item key parameters. Returned values are enclosed in square brackets and prefixed with the type of the returned value, separated by a pipe character. For user parameters type is always **t**, as the agent can not determine all possible return values. Items, displayed as working, are not guaranteed to work from the Zabbix server or zabbix\_get when querying a running agent daemon as permissions or environment may be different. Returned value types are: d Number with a decimal part. m Not supported. This could be caused by querying an item that only works in the active mode like a log monitoring item or an item that requires multiple collected values. Permission issues or incorrect user parameters could also result in the not supported state. s Text. Maximum length not limited. t Text. Same as **s**. u Unsigned integer. **-t**, **--test** *item-key* Test single item and exit. See **--print** for output description. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### Цілі контролю рівня журналу *process-type* Всі процеси вказаного типу (активні перевірки, колектор, слухач) *process-type,N* Тип та номер процесу (наприклад, listener,3) *pid* Ідентифікатор процесу, до 65535. Для більших значень вкажіть ціль у вигляді "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Вивести відомі елементи і вийти. Для кожного елемента використовуються або загальні значення за замовчуванням або специфічні значення за замовчуванням для тестування. Ці значення за замовчуванням перераховано у квадратних дужках як ключові параметри елемента. Значення, що повертаються взято у квадратні дужки і додано префікс з типом значення, що повертається значення, відокремленого символом труби. Для параметрів користувача тип завжди **t**, оскільки агент не може визначити всі можливі значення, що повертаються. Елементи, відображені як робочі, не гарантують роботу з сервера Zabbix або zabbix\_get при запиті до запущеного демона агента, оскільки дозволи або середовище може відрізнятися. Типи значень, що повертаються: d Число з десятковою частиною. m Не підтримується. Це може бути спричинено запитом елемента, який працює лише в активному режимі, наприклад, елемент моніторингу журналу або елемент, який вимагає декілька зібраних значень. Проблеми з правами доступу або неправильні параметри користувача також можуть призвести до стану "не підтримується". s Текст. Максимальна довжина не обмежена. t Текст. Те саме, що і **s**. u Ціле число без знаку. **-t**, **--test** *item-key* Перевірити один елемент і вийти. Дивіться **--print** для опису виводу. **-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести інформацію про версію і завершити роботу. [ ]{#lbAH} ### Log level control targets *process-type* All processes of specified type (alerter, alert manager, configuration syncer, discoverer, escalator, 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) *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" ```{=html} <!-- --> ``` [ ]{#lbAH} ### Цілі контролю рівня журналу *process-type* Усі процеси вказаного типу (alerter, alert manager,configuration syncer, discoverer, escalator, history syncer,housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller,java poller, lld manager, lld worker, poller, preprocessing manager,preprocessing worker, proxy poller, self-monitoring, snmp trapper,task manager, timer, trapper, unreachable poller, vmware collector) *process-type,N* Тип і номер процесу (наприклад, poller, 3) *pid* Ідентифікатор процесу, до 65535. Для більших значень укажіть ціль як "process-type,N" ```{=html} <!-- --> ``` [ ]{#lbAH} ### Log level control targets *process-type* All processes of specified type (configuration syncer, data sender, discoverer, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector) *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" ```{=html} <!-- --> ``` **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### Цілі контролю рівня журналу *process-type* Усі процеси вказаного типу (configuration syncer, data sender, discoverer, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector) *process-type,N* Тип і номер процесу (наприклад, poller, 3) *pid* Ідентифікатор процесу, до 65535. Для більших значень укажіть ціль як "process-type,N" ```{=html} <!-- --> ``` **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Виведіть інформацію про версію та вийдіть. [ ]{#lbAH} # maintenance.create # maintenance.create # maintenance.delete # maintenance.delete # maintenance.get # maintenance.get # Maintenance This class is designed to work with maintenances. Object references:\ - [Maintenance](/manual/api/reference/maintenance/object#maintenance) - [Time period](/manual/api/reference/maintenance/object#time_period) Available methods:\ - [maintenance.create](/manual/api/reference/maintenance/create) - creating new maintenances - [maintenance.delete](/manual/api/reference/maintenance/delete) - deleting maintenances - [maintenance.get](/manual/api/reference/maintenance/get) - retrieving maintenances - [maintenance.update](/manual/api/reference/maintenance/update) - updating maintenances # Обслуговування Цей клас призначений для роботи з обслуговуванням. Посилання на об'єкти:\ - [Технічне обслуговування](/manual/api/reference/maintenance/object#maintenance) - [Період часу](/manual/api/reference/maintenance/object#time_period) Доступні методи:\ - [maintenance.create](/manual/api/reference/maintenance/create) - створення нових засобів обслуговування - [maintenance.delete](/manual/api/reference/maintenance/delete) - видалення технічного обслуговування - [maintenance.get](/manual/api/reference/maintenance/get) - отримання технічного обслуговування - [maintenance.update](/manual/api/reference/maintenance/update) - оновлення технічного обслуговування # manifest.json Any module needs the manifest.json file. The file must be located in the module's primary directory (for example, *zabbix/ui/modules/module_name/manifest.json*). As a bare minimum, manifest.json should specify these fields: ```json { "manifest_version": 2.0, "id": "my_ip_address", "name": "My IP Address", "namespace": "MyIPAddress", "version": "1.0" } ``` Parameters supported in **manifest.json** (press on the parameter name for a detailed description): |Parameter |Description |Required | |--|--------|--| |[manifest_version](#manifest-version)|Manifest version of the module.| Yes | |[id](#id) |Unique module ID. |^| |[name](#name) |Module name that will be displayed in the Administration section. |^| |[namespace](#namespace) |PHP namespace for module classes.|^| |[version](#version) |Module version. |^| |[type](#type) |Type of the module. For widget must be set to *widget* | Yes for widgets, otherwise no | |[widget](#widget) |Widget configuration. Used for widgets only. |^| |[actions](#actions) | Actions to register with the module. |^| |[assets](#assets) | CSS styles and JavaScript files to include. | No | |[author](#author) |Module author. |^| |[config](#config) |Default values for custom module options. |^| |[description](#description) |Module description.|^| |[url](#url) |A link to the module description. |^| # manifest.json Для будь-якого модуля потрібний файл manifest.json. Файл має бути розташований у основному каталозі модуля (наприклад *zabbix/ui/modules/module_name/manifest.json*). Як мінімум, у файлі manifest.json мають бути вказані такі поля: ```json { "manifest_version": 2.0, "id": "my_ip_address", "name": "My IP Address", "namespace": "MyIPAddress", "version": "1.0" } ``` Параметри, які підтримуються в **manifest.json** (натисніть назву параметра для детального опису): |Параметр |Опис |Обов'язковий | |--|--------|--| |[manifest_version](#manifest-version)|Версія маніфесту модуля.| Так | |[id](#id) |Унікальний ідентифікатор модуля. |^| |[name](#name) |Назва модуля, що відображатиметься в розділі Адміністрування. |^| |[namespace](#namespace) |Простір імен PHP для класів модулів.|^| |[version](#version) |Версія модуля. |^| |[type](#type) |Тип модуля. Для віджета потрібно встановити *widget* | Так для віджетів, ні для решти | |[widget](#widget) |Конфігурація віджета. Використовується лише для віджетів. |^| |[actions](#actions) | Дії для реєстрації в модулі. |^| |[assets](#assets) | Стилі CSS і файли JavaScript для включення. | Ні | |[author](#author) |Автор модуля. |^| |[config](#config) |Значення за замовчуванням для користувацьких параметрів модуля. |^| |[description](#description) |Опис модуля.|^| |[url](#url) |Посилання на опис модуля. |^| ### manifest_version {#manifest-version} Manifest version of the module. Currently, supported version is **2.0**. *Type*: Double *Example*: ```json "manifest_version": 2.0 ``` ### manifest_version {#manifest-version} Версія маніфесту модуля. Наразі підтримується версія **2.0**. *Тип*: Double *Приклад*: ```json "manifest_version": 2.0 ``` ##### 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. #### mediatype [ZBXNEXT-6796](https://support.zabbix.com/browse/ZBXNEXT-6796) Removed property `exec_params`.\ [ZBXNEXT-6796](https://support.zabbix.com/browse/ZBXNEXT-6796) Added new property `parameters` (contains a list of [parameter](reference/mediatype/object#script-parameters) objects for "script" media types).\ #### mediatype [ZBXNEXT-6796](https://support.zabbix.com/browse/ZBXNEXT-6796) Видалено властивість `exec_params`.\ [ZBXNEXT-6796](https://support.zabbix.com/browse/ZBXNEXT-6796) Додано нову властивість `parameters` (містить список об’єктів [parameter](reference/mediatype/object#script-parameters) для методів сповіщення "script").\ # 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, і допоможе вам зорієнтуватися в доступних класах і методах. ### Module example - When creating a host group, grant read permissions to configured user groups - [hg_auto_perm.zip](/../assets/en/devel/modules/examples/hg_auto_perm.zip) ### Приклад модуля - Під час створення групи хостів надайте дозволи на читання налаштованим групам користувачів - [hg_auto_perm.zip](/../assets/en/devel/modules/examples/hg_auto_perm.zip) # Module file structure All code related to a module is stored in a single directory inside the **modules** directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). # Структура файлів модуля Весь код, пов’язаний з модулем, зберігається в одному каталозі всередині каталогу **modules** вашої установки web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). ### Module file tree ````yaml 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 assets/ Any additional files to be used in views. Must be specified in manifest.json. js/ JavaScript files used in views. example.something.view.js.php css/ CSS files used in views. example.something.css image.png Images used in views. example.something.file Any file for using in views. ```` ### Дерево файлів модуля ````yaml example_module_directory/ (обов’язково) manifest.json (обов’язково) Метадані та визначення дії. Module.php Ініціалізація модуля та обробка подій. actions/ Файли управління діями. SomethingView.php SomethingCreate.php SomethingDelete.php data_export/ ExportAsXml.php ExportAsExcel.php views/ view файли. example.something.view.php example.something.delete.php assets/ Будь-які додаткові файли для використання у view. Необхідно вказати в manifest.json. js/файли JavaScript, які використовуються у view. example.something.view.js.php css/ файли CSS, які використовуються у view. example.something.css image.png Зображення, що використовуються у view. example.something.file Будь-який файл для використання у view. ```` # Modules # Модулі #### module [ZBXNEXT-7469](https://support.zabbix.com/browse/ZBXNEXT-7469) Added new Module API with methods `module.create`, `module.delete`, `module.get`, `module.update`.\ #### module [ZBXNEXT-7469](https://support.zabbix.com/browse/ZBXNEXT-7469) Додано новий модуль API з методами `module.create`, `module.delete`, `module.get`, `module.update`.\ 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. 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. #### 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 Export and import must be performed in tmux/screen to ensure that the session isn't dropped. See also: [Important notes](#important-notes) ### MySQL Експорт і імпорт потрібно виконувати в tmux/screen, щоб гарантувати, що сеанс не буде перервано. Дивіться також: [Важливі примітки](#important-notes) #### MySQL 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*.\ Relevant for at least MySQL version 5.1.61 #### MySQL Якщо значення містить символ, відмінний від ASCII, у кодуванні, відмінному від UTF8, цей символ і наступні символи буде відкинуто, коли база даних збереже це значення. На адресу не надходитимуть жодні попереджувальні повідомлення *zabbix\_server.log*.\ Актуально принаймні для версії MySQL 5.1.61 ### name Module name that will be displayed in the Administration section. *Type*: String *Example*: ```json "name": "My module" ``` ### name Назва модуля, яка буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "name": "Мій модуль" ``` ### namespace PHP namespace for module classes. *Type*: String *Example*: ```json "namespace": "ClockWidget" ``` ### namespace Простір імен PHP для класів модулів. *Тип*: String *Приклад*: ```json "namespace": "ClockWidget" ``` ## 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 JS [ ]{#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} #### 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 *Alerts → Actions → Trigger actions* and click on *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), дію буде вжито після будь-якої зміни тригера з 'ОК' на 'Проблема'. Ми все ще повинні визначити, що має робити дія - і це робиться на вкладці *Операції*. Натисніть *Додати* у блоці Операції, що відкриє нову форму операції.  Усі обов’язкові поля для введення позначені червоною зірочкою. Тут натисніть *Додати* у блоці *Надіслати користувачам* і виберіть користувача ('користувач'), якого ми визначили. Виберіть 'Електронна пошта' як значення *Надіслати лише до*. Після цього натисніть *Додати*, і операцію буде додано: {width="600"} Це все для простої конфігурації дії, тому натисніть *Додати* у формі дії. ### 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` ::: ::: 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 a time-based function comes. ::: ::: 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 a time-based function comes. ::: ## OPTIONS **-c**, **--config** *config-file* Use *config-file*. **Zabbix sender** reads server details from the agentd configuration file. By default **Zabbix sender** does not read any configuration file. Only parameters **Hostname**, **ServerActive**, **SourceIP**, **TLSConnect**, **TLSCAFile**, **TLSCRLFile**, **TLSServerCertIssuer**, **TLSServerCertSubject**, **TLSCertFile**, **TLSKeyFile**, **TLSPSKIdentity** and **TLSPSKFile** are supported. All addresses defined in the agent **ServerActive** configuration parameter are used for sending data. If sending of batch data fails to one address, the following batches are not sent to this address. **-z**, **--zabbix-server** *server* Hostname or IP address of Zabbix server. If a host is monitored by a proxy, proxy hostname or IP address should be used instead. When used together with **--config**, overrides the entries of **ServerActive** parameter specified in agentd configuration file. **-p**, **--port** *port* Specify port number of Zabbix server trapper running on the server. Default is 10051. When used together with **--config**, overrides the port entries of **ServerActive** parameter specified in agentd configuration file. **-I**, **--source-address** *IP-address* Specify source IP address. When used together with **--config**, overrides **SourceIP** parameter specified in agentd configuration file. **-t**, **--timeout** *seconds* Specify timeout. Valid range: 1-300 seconds (default: 60) **-s**, **--host** *host* Specify host name the item belongs to (as registered in Zabbix frontend). Host IP address and DNS name will not work. When used together with **--config**, overrides **Hostname** parameter specified in agentd configuration file. **-k**, **--key** *key* Specify item key to send value to. **-o**, **--value** *value* Specify item value. **-i**, **--input-file** *input-file* Load values from input file. Specify **-** as **<input-file>** to read values from standard input. Each line of file contains whitespace delimited: **<hostname> <key> <value>**. Each value must be specified on its own line. Each line must contain 3 whitespace delimited entries: **<hostname> <key> <value>**, where "hostname" is the name of monitored host as registered in Zabbix frontend, "key" is target item key and "value" - the value to send. Specify **-** as **<hostname>** to use hostname from agent configuration file or from **--host** argument. An example of a line of an input file: **"Linux DB3" db.connections 43** The value type must be correctly set in item configuration of Zabbix frontend. Zabbix sender will send up to 250 values in one connection. [Size limit](/manual/appendix/protocols/header_datalen) for sending values from an input file depends on the size described in Zabbix communication protocol. Contents of the input file must be in the UTF-8 encoding. All values from the input file are sent in a sequential order top-down. Entries must be formatted using the following rules: - Quoted and non-quoted entries are supported. - Double-quote is the quoting character. - Entries with whitespace must be quoted. - Double-quote and backslash characters inside quoted entry must be escaped with a backslash. - Escaping is not supported in non-quoted entries. - Linefeed escape sequences (\\n) are supported in quoted strings. - Linefeed escape sequences are trimmed from the end of an entry. **-T**, **--with-timestamps** This option can be only used with **--input-file** option. Each line of the input file must contain 4 whitespace delimited entries: **<hostname> <key> <timestamp> <value>**. Timestamp should be specified in Unix timestamp format. If target item has triggers referencing it, all timestamps must be in an increasing order, otherwise event calculation will not be correct. An example of a line of the input file: **"Linux DB3" db.connections 1429533600 43** For more details please see option **--input-file**. If a timestamped value is sent for a host that is in a “no data” maintenance type then this value will be dropped; however, it is possible to send a timestamped value in for an expired maintenance period and it will be accepted. **-N**, **--with-ns** This option can be only used with **--with-timestamps** option. Each line of the input file must contain 5 whitespace delimited entries: **<hostname> <key> <timestamp> <ns> <value>**. An example of a line of the input file: **"Linux DB3" db.connections 1429533600 7402561 43** For more details please see option **--input-file**. **-r**, **--real-time** Send values one by one as soon as they are received. This can be used when reading from standard input. **--tls-connect** *value* How to connect to server or proxy. Values: [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте *config-file*. **Zabbix sender** читає деталі сервера з файлу конфігурації агента. За замовчуванням **Zabbix sender** не читає жоден файл конфігурації. Підтримуються лише параметри **Hostname**, **ServerActive**, **SourceIP**, **TLSConnect**, **TLSCAFile**, **TLSCRLFile**, **TLSServerCertIssuer**, **TLSServerCertSubject**, **TLSCertFile**, **TLSKeyFile**, **TLSPSKIdentity** і **TLSPSKFile**. Усі адреси, визначені в параметрі конфігурації агента **ServerActive**, використовуються для надсилання даних. Якщо надсилання пакетних даних не вдається на одну адресу, наступні пакети не надсилаються на цю адресу. **-z**, **--zabbix-server** *server* Ім'я хоста або IP-адреса сервера Zabbix. Якщо хост контролюється проксі-сервером, замість нього слід використовувати назву хоста або IP-адресу проксі-сервера. Якщо використовується разом із **--config**, замінює записи параметра **ServerActive**, указаного у файлі конфігурації agentd. **-p**, **--port** *port* Вкажіть номер порту трапера сервера Zabbix, який працює на сервері. За замовчуванням — 10051. Якщо використовується разом із **--config**, замінює записи порту параметра **ServerActive**, указаного у файлі конфігурації agentd. **-I**, **--source-address** *IP-address* Вкажіть IP-адресу джерела. Якщо використовується разом із **--config**, замінює параметр **SourceIP**, указаний у файлі конфігурації agentd. **-t**, **--timeout** *seconds* Вкажіть час очікування. Дійсний діапазон: 1-300 секунд (за замовчуванням: 60) **-s**, **--host** *host* Вкажіть ім’я хоста, до якого належить елемент даних (як зареєстровано у інтерфейсі Zabbix). IP-адреса хоста та ім’я DNS не працюватимуть. Якщо використовується разом із **--config**, замінює параметр **Hostname**, указаний у файлі конфігурації agentd. **-k**, **--key** *key* Укажіть ключ елемента даних, до якого потрібно надіслати значення. **-o**, **--value** *value* Вкажіть значення елементу даних. **-i**, **--input-file** *input-file* Завантажити значення з вхідного файлу. Укажіть **-** як **<input-file>**, щоб читати значення зі стандартного введення. Кожен рядок файлу містить розділені пробілами: **<ім’я хоста> <ключ> <значення>**. Кожне значення має бути вказано в окремому рядку. Кожен рядок має містити 3 записи, розділені пробілами: **<ім’я хоста> <ключ> <значення>**, де «ім’я хосту» — це ім’я контрольованого хосту, зареєстроване у інтерфейсі Zabbix, «ключ» — ключ цільового елемента та «значення» - значення для надсилання. Укажіть **-** як **<hostname>**, щоб використовувати ім’я хоста з файлу конфігурації агента або з аргументу **--host**. Приклад рядка вхідного файлу: **"Linux DB3" db.connections 43** Тип значення має бути правильно встановлено в конфігурації елемента даних інтерфейсу Zabbix. Zabbix sender надішле до 250 значень за одне підключення. [Обмеження розміру](/manual/appendix/protocols/header_datalen) для надсилання значень із вхідного файлу залежить від розміру, описаного в протоколі зв’язку Zabbix. Вміст вхідного файлу має бути в кодуванні UTF-8. Усі значення з вхідного файлу надсилаються в послідовному порядку зверху вниз. Записи мають бути відформатовані за такими правилами: - Підтримуються як записи в лапках так і без. - Подвійні лапки - символ взяття в лапки. - Записи з пробілами повинні бути взяті в лапки. - Символи подвійних лапок та зворотної косої риски всередині рядка, що цитується, слід екранувати зворотною косою рискою. - Екранування не підтримується в записах без лапок. - У рядках у лапках підтримуються екрановані послідовності переведення рядка (\\n). - Екран-послідовності переходу рядка обрізаються з кінця запису. **-T**, **--with-timestamps** Цей параметр можна використовувати лише з параметром **--input-file**. Кожен рядок вхідного файлу має містити 4 записи, розділені пробілами: **<hostname> <key> <timestamp> <ns> <value>**. Мітку часу слід вказувати у форматі Unix timestamp. Якщо цільовий елемент має тригери, які посилаються на нього, усі позначки часу мають бути в порядку зростання, інакше обчислення події буде неправильним. Приклад рядка вхідного файлу: **"Linux DB3" db.connections 1429533600 43** Щоб дізнатися більше, дивіться опцію **--input-file**. Якщо значення з міткою часу надсилається для хоста, який має тип обслуговування «немає даних», це значення буде видалено; однак можна надіслати значення з міткою часу для періоду обслуговування, що минув, і воно буде прийнято. **-N**, **--with-ns** Цей параметр можна використовувати лише з параметром **--with-timestamps**. Кожен рядок вхідного файлу має містити 5 записів, розділених пробілами: **<hostname> <key> <timestamp> <ns> <value>**. Приклад рядка вхідного файлу: **"Linux DB3" db.connections 1429533600 7402561 43** Щоб дізнатися більше, дивіться опцію **--input-file**. **-r**, **--real-time** Надсилайте значення одне за одним, щойно вони будуть отримані. Це можна використовувати під час читання зі стандартного введення. **--tls-connect** *value* Як підключитися до сервера або проксі. Значення: [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix агент на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix proxy in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix проксі на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix server in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. Examples of running Zabbix server with command line parameters: ```yaml shell> zabbix_server -c /usr/local/etc/zabbix_server.conf shell> zabbix_server --help shell> zabbix_server -V ``` [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix сервер на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. *-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести версію і вийти. Приклади запуску сервера Zabbix з параметрами командного рядка: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовувати альтернативний конфігураційний файл *config-file* замість стандартного. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Вивести інформацію про версію та вийдіть. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний файл конфігурації *config-file* замість стандартного. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| ## OPTIONS **-s**, **--host** *host-name-or-IP* Specify host name or IP address of a host. **-p**, **--port** *port-number* Specify port number of agent running on the host. Default is 10050. **-I**, **--source-address** *IP-address* Specify source IP address. **-t**, **--timeout** *seconds* Specify timeout. Valid range: 1-30 seconds (default: 30) **-k**, **--key** *item-key* Specify key of item to retrieve value for. **--tls-connect** *value* How to connect to agent. Values: [ ]{#lbAF} ## ПАРАМЕТРИ **-s**, **--host** *host-name-or-IP* Вкажіть ім'я або IP-адресу хоста. **-p**, **--port** *port-number* Укажіть номер порту агента, який працює на хості. За замовчуванням 10050. **-I**, **--source-address** *IP-address* Вкажіть IP-адресу джерела. **-t**, **--timeout** *seconds* Вкажіть час очікування. Дійсний діапазон: 1-30 секунд (за замовчуванням: 30) **-k**, **--key** *item-key* Укажіть ключ елемента, для якого потрібно отримати значення. **--tls-connect** *value* Як підключитися до агента. Значення: [ ]{#lbAF} ## OPTIONS **-s**, **--script** *script-file* Specify the file name of the script to execute. If '-' is specified as file name, the script will be read from stdin. **-p**, **--param** *input-param* Specify the input parameter. **-i**, **--input** *input-file* Specify the file name of the input parameter. If '-' is specified as file name, the input will be read from stdin. **-l**, **--loglevel** *log-level* Specify the log level. **-t**, **--timeout** *timeout* Specify the timeout in seconds. Valid range: 1\-60 seconds (default: 10) **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## ПАРАМЕТРИ **-s**, **--script** *script-file* Вказати ім'я файлу скрипта для виконання. Якщо в якості імені файлу вказати '-' ім'я файлу, то скрипт буде прочитано з stdin. **-p**, **--param** *input-param* Вказати вхідний параметр. **-i**, **--input** *input-file* Вказати ім'я файлу вхідного параметра. Якщо в якості імені файлу вказати '-' ім'я файлу, то вхідні дані будуть прочитані з stdin. **-l**, **--loglevel** *log-level* Вказати рівень журналу. **-t**, **--timeout** *timeout* Вказати таймаут у секундах. Допустимий діапазон: 1\-60 секунд (за замовчуванням: 10) **-h**, **--help** Показати цю довідку і вийти. **-V**, **--version** Вивести інформацію про версію і вийти. [ ]{#lbAF} #### Oracle Instructions for creating and configuring Oracle database are provided in a separate [section](/manual/appendix/install/oracle). #### Oracle Інструкції щодо створення та налаштування бази даних Oracle наведено в окремому [розділі](/manual/appendix/install/oracle). ## Other changes and bug fixes ## Інші зміни та виправлення помилок #### Overview As an alternative to setting up manually or reusing an existing server for Zabbix, users may [download](http://www.zabbix.com/download_appliance) a Zabbix appliance or a Zabbix appliance installation CD image. Zabbix appliance and installation CD versions are based on AlmaLinux 8 (x86\_64). Zabbix appliance installation CD can be used for instant deployment of Zabbix server (MySQL). ::: noteimportant You can use this appliance to evaluate Zabbix. The appliance is not intended for serious production use. ::: #### Огляд Як альтернативу налаштуванню вручну або повторному використанню існуючого сервера для Zabbix, користувачі можуть [завантажити](http://www.zabbix.com/download_appliance) готове рішення Zabbix або образ компакт-диска для встановлення готового рішення Zabbix. Версії готового рішення Zabbix та інсталяційного компакт-диска базуються на AlmaLinux 8 (x86\_64). Інсталяційний компакт-диск готового рішення Zabbix можна використовувати для миттєвого розгортання сервера Zabbix (MySQL). ::: noteimportant Ви можете використовувати це готове рішення для оцінки Zabbix. Готове рішення не призначене для серйозного виробничого використання. ::: #### Overview By default, Zabbix provides a number of predefined themes. You may follow the step-by-step procedure provided here in order to create your own. Feel free to share the result of your work with Zabbix community if you created something nice. #### Огляд За замовчуванням Zabbix надає кілька попередньо визначених тем. Ви можете виконати наведену тут покрокову процедуру, щоб створити свій власний. Не соромтеся поділитися результатом своєї роботи зі спільнотою Zabbix, якщо ви створили щось хороше. ### Overview Custom loadable plugins extend Zabbix agent 2 functionality. They are compiled separately, but use a package shared with Zabbix agent 2. Each plugin is a *Go* package that defines the structure and implements one or several plugin interfaces (*Exporter*, *Configurator*, *Runner*). Jump to: - [Write your first plugin](/devel/plugins/how_to) - [Plugin interfaces](/devel/plugins/interfaces) ### Connection diagram Zabbix agent 2 connects bidirectionally to the plugins using UNIX sockets on Linux and Named Pipes on Windows. The connection diagram below illustrates the communication process between Zabbix agent 2 and a loadable plugin and the metrics collection process.  ### Огляд Користувацькі завантажувані плагіни розширюють функціональність Zabbix agent 2. Вони компілюються окремо, але використовують спільний з Zabbix agent 2 пакет. Кожен плагін — це пакет *Go*, який визначає структуру та реалізує один або кілька інтерфейсів плагіна (*Exporter*, *Configurator*, *Runner*). Перейти до: - [Напишіть свій перший плагін](/devel/plugins/how_to) - [Інтерфейси плагінів](/devel/plugins/interfaces) ### Схема підключення Zabbix agent 2 двонаправлено підключається до плагінів за допомогою UNIX-сокетів у Linux та іменованих каналів (Named Pipes) у Windows. Наведена нижче схема з'єднання ілюструє процес зв'язку між Zabbix agent 2 і завантажуваним плагіном та процес збору метрик.  #### Overview Global notifications are a way of displaying issues that are currently happening right on the screen you're at in Zabbix frontend. Without global notifications, working in some other location than *Problems* or the *Dashboard* would not show any information regarding issues that are currently happening. Global notifications will display this information regardless of where you are. Global notifications involve both showing a message and [playing a sound](sound). ::: noteimportant The auto play of sounds may be disabled in recent browser versions by default. In this case, you need to change this setting manually. ::: #### Огляд Глобальні сповіщення – це спосіб відображення проблем, які зараз відбуваються прямо на екрані, на якому ви перебуваєте у інтерфейсі Zabbix. Без глобальних сповіщень робота в якомусь іншому місці, ніж *Проблеми* або *Інформаційна панель*, не відображатиме жодної інформації щодо проблем, які зараз відбуваються. Глобальні сповіщення відображатимуть цю інформацію незалежно від того, де ви перебуваєте. Глобальні сповіщення включають як показ повідомлення, так і [відтворення звуку](звук). ::: приміткаважливо Автоматичне відтворення звуків може бути вимкнено в останніх версіях браузера за замовчуванням. У цьому випадку вам потрібно змінити цей параметр вручну. ::: ### Overview High availability (HA) is typically required in critical infrastructures that can afford virtually no downtime. So for any service that may fail there must be a failover option in place to take over should the current service fail. Zabbix offers a **native** high-availability solution that is easy to set up and does not require any previous HA expertise. Native Zabbix HA may be useful for an extra layer of protection against software/hardware failures of Zabbix server or to have less downtime due to maintenance. In the Zabbix high availability mode multiple Zabbix servers are run as nodes in a cluster. While one Zabbix server in the cluster is active, others are on standby, ready to take over if necessary.  Switching to Zabbix HA is non-committal. You may switch back to standalone operation at any point. See also: [Implementation details](#implementation-details) ### Огляд Висока доступність (HA) зазвичай потрібна в критичних інфраструктурах, які практично не можуть дозволити собі простоїв. Тож, для будь-якого сервісу, який може вийти з ладу, має бути передбачена можливість переключення на інший ресурс, у разі відмови поточного сервісу. Zabbix пропонує **власне** рішення високої доступності, яке легко налаштувати і яке не потребує попереднього досвіду роботи з HA. Це вбудоване рішення може бути корисним як додатковий рівень захисту від програмних або апаратних збоїв сервера Zabbix або для зменшення часу простою під час технічного обслуговування. У режимі високої доступності Zabbix, кілька Zabbix серверів працюють як вузли кластеру. Поки один Zabbix сервер у кластері активний, інші знаходяться в режимі очікування і готові взяти на себе роботу, в разі потреби.  Перехід на Zabbix HA не є незворотнім. Ви можете повернутися до режиму самостійної роботи в будь-який момент. Дивіться також: [Деталі реалізації](#implementation-details) #### Overview In order to use any other language than English in Zabbix web interface, its locale should be installed on the web server. Additionally, the PHP gettext extension is required for the translations to work. #### Огляд Щоб використовувати будь-яку іншу мову, окрім англійської, у веб-інтерфейсі Zabbix, її локаль повинна бути встановлена на веб-сервері. Крім того, для роботи перекладів потрібне розширення PHP gettext. #### Overview In this section, you will learn how to log in and set up a system user in Zabbix. #### Огляд У цьому розділі ви дізнаєтесь, як увійти та налаштувати користувача системи Zabbix. #### Overview In this section you will learn how to set up alerting in the form of notifications in Zabbix. With items collecting data and triggers designed to "fire" upon problem situations, it would also be useful to have some alerting mechanism in place that would notify us about important events even when we are not directly looking at Zabbix frontend. This is what notifications do. Email being the most popular delivery method for problem notifications, we will learn how to set up an email notification. #### Огляд У цьому розділі ви дізнаєтесь, як налаштувати оповіщення у вигляді повідомлень у Zabbix. З елементами даних, які збирають дані, і тригерами, розробленими для "спрацьовування" проблемних ситуацій, також було б корисно мати певний механізм сповіщення, який сповіщав би нас про важливі події, навіть якщо ми безпосередньо не дивимось на інтерфейс Zabbix. Це те, що роблять сповіщення. Електронна пошта є найпопулярнішим способом доставки сповіщень про проблеми, тому ми дізнаємося, як налаштувати сповіщення електронною поштою. #### Overview In this section you will learn how to set up a new host. A host in Zabbix is a networked entity (physical, virtual) that you wish to monitor. The definition of what can be a "host" in Zabbix is quite flexible. It can be a physical server, a network switch, a virtual machine or some application. #### Огляд У цьому розділі ви дізнаєтесь, як налаштувати новий вузол мережі. Вузол мережі у Zabbix — це мережева сутність (фізична, віртуальна), яку ви бажаєте моніторити. Визначення того, що може бути "вузлом мережі" у Zabbix, досить гнучке. Це може бути фізичний сервер, мережевий комутатор, віртуальна машина або якийсь додаток. #### Overview In this section, you will learn how to set up an item. Items are the basis of gathering data in Zabbix. Without items, there is no data - because only an item defines a single metric or what kind of data to collect from a host. #### Огляд У цьому розділі ви дізнаєтеся, як налаштувати елемент даних. Елементи даних є основою для збору даних у Zabbix. Без елементів даних немає даних, тому що лише елемент даних визначає один показник або тип даних, які потрібно збирати з вузла мережі. #### Overview In this section you will learn how to set up a template. Previously we learned how to set up an item, a trigger and how to get a problem notification for the host. While all of these steps offer a great deal of flexibility in themselves, it may appear like a lot of steps to take if needed for, say, a thousand hosts. Some automation would be handy. This is where templates come to help. Templates allow to group useful items, triggers and other entities so that those can be reused again and again by applying to hosts in a single step. When a template is linked to a host, the host inherits all entities of the template. So, basically a pre-prepared bunch of checks can be applied very quickly. #### Огляд У цьому розділі ви дізнаєтеся, як налаштувати шаблон. Раніше ми дізналися, як налаштувати елемент даних, тригер і як отримати сповіщення про проблему для вузла мережі. Хоча всі ці кроки самі по собі пропонують велику гнучкість, може здатися, що їх потрібно виконати багато, якщо це необхідно, скажімо, для тисячі вузлів мережі. Трохи автоматизації було б зручно. Тут на допомогу приходять шаблони. Шаблони дозволяють групувати корисні елементи даних, тригери та інші сутності, щоб їх можна було повторно використовувати знову і знову, застосовуючи до вузлів мережі за один крок. Коли шаблон пов’язано з вузлом мережі, вузол мережі успадковує всі сутності шаблону. Отже, в основному, заздалегідь підготовлену групу перевірок можна застосувати дуже швидко. #### Overview In this section you will learn how to set up a trigger. Items only collect data. To automatically evaluate incoming data we need to define triggers. A trigger contains an expression that defines a threshold of what is an acceptable level for the data. If that level is surpassed by the incoming data, a trigger will "fire" or go into a 'Problem' state - letting us know that something has happened that may require attention. If the level is acceptable again, trigger returns to an 'Ok' state. #### Огляд У цьому розділі ви дізнаєтесь, як налаштувати тригер. Елементи даних лише збирають дані. Щоб автоматично оцінювати вхідні дані, нам потрібно визначити тригери. Тригер містить вираз, який визначає порогове значення прийнятного рівня для даних. Якщо вхідні дані перевищують цей рівень, спрацьовує тригер, або переходить у стан 'Проблема', повідомляючи нам, що трапилося щось, що може потребувати уваги. Якщо рівень знову прийнятний, тригер повертається до стану 'OK'. #### Overview Kerberos authentication can be used in web monitoring and HTTP items in Zabbix since version 4.4.0. This section describes an example of configuring Kerberos with Zabbix server to perform web monitoring of `www.example.com` with user 'zabbix'. #### Огляд Автентифікацію Kerberos можна використовувати в веб-моніторингу та елементах HTTP в Zabbix, починаючи з версії 4.4.0. У цьому розділі описано приклад налаштування Kerberos із сервером Zabbix для виконання веб-моніторингу `www.example.com` за допомогою користувача 'zabbix'. #### Overview Problem events in Zabbix can be acknowledged by users. If a user gets notified about a problem event, they can go to Zabbix frontend, open the problem update popup window of that problem using one of the ways listed below and acknowledge the problem. When acknowledging, they can enter their comment for it, saying that they are working on it or whatever else they may feel like saying about it. This way, if another system user spots the same problem, they immediately see if it has been acknowledged and the comments so far. This way the workflow of resolving problems with more than one system user can take place in a coordinated way. Acknowledgment status is also used when defining [action operations](/manual/config/notifications/action/operation). You can define, for example, that a notification is sent to a higher level manager only if an event is not acknowledged for some time. To acknowledge events and comment on them, a user must have at least read permissions to the corresponding triggers. To change problem severity or close problem, a user must have read-write permissions to the corresponding triggers. There are **several** ways to access the problem update popup window, which allows acknowledging a problem. - You may select problems in *Monitoring* → *Problems* and then click on *Mass update* below the list - You can click on *Update* in the *Update* column of a problem in: - *Dashboards* (*Problems* and *Problems by severity* widgets) - *Monitoring → Problems* - *Monitoring → Problems → Event details* - You can click on an unresolved problem cell in: - *Dashboards* (*Trigger overview* widget) The popup menu contains an *Update* option that will take you to the problem update window. #### Огляд Проблемні події в Zabbix можуть бути визнані користувачами. Якщо користувач отримує сповіщення про проблему, він може перейти до інтерфейсу Zabbix, відкрити спливаюче вікно оновлення цієї проблеми одним із способів, перелічених нижче, і підтвердити проблему. Підтверджуючи, вони можуть ввести свій коментар до цього, сказавши,що вони над цим працюють, або будь-що інше, що вони можуть сказати про це. Таким чином, якщо інший користувач системи помітить ту саму проблему, він одразу побачить, чи було її підтверджено, і коментарі до цього часу. Таким чином робочий процес вирішення проблем із кількома користувачами системи може відбуватися скоординовано. Статус підтвердження також використовується під час визначення [операцій дій](/manual/config/notifications/action/operation). Ви можете визначити, наприклад, що сповіщення надсилається менеджеру вищого рівня, лише якщо подія не підтверджується протягом деякого часу. Щоб підтверджувати події та коментувати їх, користувач повинен мати принаймні дозволи на читання відповідних тригерів. Щоб змінити серйозність проблеми або закрити проблему, користувач повинен мати дозволи на читання та запис для відповідних тригерів. Існує **кілька** способів отримати доступ до спливаючого вікна оновлення проблеми, яке дозволяє підтвердити проблему. - Ви можете вибрати проблеми в *Моніторинг* → *Проблеми*, а потім натиснути *Масове оновлення* під списком - Ви можете натиснути на *Оновити* в колонці *Оновити* проблеми в: - *Дашборди* (віджети *Проблеми* та *Проблеми за ступенем серйозності*) - *Моніторинг → Проблеми* - *Моніторинг → Проблеми → Деталі події* -Ви можете натиснути на клітинку з невирішеною проблемою: - *Дашборди* (віджет *Огляд тригерів*) Спливне меню містить опцію *Оновити*, за допомогою якої ви перейдете до вікна оновлення проблеми. #### Overview Problem suppression offers a way of temporarily hiding a problem that can be dealt with later. This is useful for cleaning up the problem list in order to give the highest priority to the most urgent issues. For example, sometimes an issue may arise on the weekend that is not urgent enough to be dealt with immediately, so it can be "snoozed" until Monday morning. Problem suppression allows to hide a *single* problem, in contrast to problem suppression through host maintenance when all problems of the maintenance host are hidden. Operations for trigger actions will be paused for suppressed problems the same way as it is done with [host maintenance](/manual/maintenance). #### Огляд Приховування проблеми пропонує спосіб тимчасово приховати проблему, яка можна вирішити пізніше. Це корисно для очищення списку проблем для того, щоб надавати найвищий пріоритет найбільш актуальним питанням. Наприклад, іноді у вихідні, може виникнути проблема, яка не на стільки термінова, щоб негайно її вирішити, тому її можна "відкласти" до ранку понеділка. Приховування проблеми дозволяє приховати *окрему* проблему, на відміну від приховування через обслуговування хоста, коли всі проблеми хоста, який обслуговується, приховані. Операції для тригерних дій також буде призупинено для пригнічених проблем так, як це робиться за допомогою [обслуговування хоста](/manual/maintenance). #### Overview Some new items are automatically added for monitoring when web scenarios are created. All items inherit tags from the web scenario. #### Огляд Деякі нові елементи автоматично додаються для моніторингу під час створення веб-сценаріїв. Усі елементи успадковують теги з веб-сценарію. #### Overview Sound is used in [global notifications](/manual/web_interface/user_profile/global_notifications). For the sounds to be played in Zabbix frontend, *Frontend messaging* must be enabled in the user profile *Messaging* tab, with all trigger severities checked, and sounds should also be enabled in the global notification pop-up window. If for some reasons audio cannot be played on the device, the  button in the global notification pop-up window will permanently remain in the "mute" state and the message "Cannot support notification audio for this device." will be displayed upon hovering over the  button. Sounds, including the default audio clips, are supported in MP3 format only. The sounds of Zabbix frontend have been successfully tested in recent Firefox/Opera browsers on Linux and in Chrome, Firefox, Microsoft Edge, and Opera browsers on Windows. ::: noteimportant The auto play of sounds may be disabled in recent browser versions by default. In this case, you need to change this setting manually. ::: #### Огляд Звук використовується в [глобальних сповіщеннях](/manual/web_interface/user_profile/global_notifications). Щоб звуки відтворювалися у інтерфейсі Zabbix, *Повідомлення у веб-інтерфейсі* має бути ввімкнено у профілі користувача на вкладці *Повідомлення*, з позначеними всіма рівнями серйозності тригерів, а звуки також мають бути ввімкнені в глобальному спливаючому вікні сповіщень. Якщо з певних причин аудіо не відтворюється на пристрої, кнопка  у спливаючому вікні глобального сповіщення постійно залишатиметься в стані «без звуку» та повідомлення «Неможливо підтримувати звук сповіщень для цього пристрою.» відображатиметься після наведення курсора на кнопку . Звуки, включаючи стандартні аудіокліпи, підтримуються лише у форматі MP3. Звуки інтерфейсу Zabbix були успішно протестовані в останніх браузерах Firefox/Opera в Linux і браузерах Chrome, Firefox, Microsoft Edge і Opera в Windows. ::: noteimportant Автоматичне відтворення звуків може бути вимкнено в останніх версіях браузера за замовчуванням. У цьому випадку вам потрібно змінити цей параметр вручну. ::: #### Overview The Monitoring menu is all about displaying data. Whatever information Zabbix is configured to gather, visualize and act upon, it will be displayed in the various sections of the Monitoring menu. #### Огляд У меню моніторингу відображаються дані. Яку б інформацію не налаштував Zabbix для збору, візуалізації та дії, вона буде відображатися в різних розділах меню моніторингу. #### Overview The Reports menu features several sections that contain a variety of predefined and user-customizable reports focused on displaying an overview of such parameters as system information, triggers and gathered data. #### Огляд Меню «Звіти» містить кілька розділів, які містять різноманітні попередньо визначені та настроювані користувачем звіти, орієнтовані на відображення огляду таких параметрів, як системна інформація, тригери та зібрані дані. #### Overview The Services menu is for the [service monitoring](/manual/it_services) functions of Zabbix. #### Огляд Меню «Сервіси» призначене для функцій [сервісного моніторингу] /manual/it_services) Zabbix. ### Overview The Zabbix API allows you to programmatically retrieve and modify configuration of Zabbix and provides access to historical data. It is widely used to: - Create new applications to work with Zabbix; - Integrate Zabbix into a third-party software; - Automate routine tasks. The Zabbix API is an HTTP-based API, and it is shipped as a part of the web frontend. It uses the JSON-RPC 2.0 protocol, which means two things: - The API consists of a set of separate methods. - Requests and responses between the clients and the API are encoded using the JSON format. More information about the protocol and JSON can be found in the [JSON-RPC 2.0 specification](http://www.jsonrpc.org/specification) and the [JSON format homepage](http://json.org/). For more information about integrating Zabbix functionality into your Python applications, see the [zabbix_utils](https://github.com/zabbix/python-zabbix-utils) Python library for Zabbix API. ### Огляд Zabbix API дозволяє програмно отримувати та змінювати налаштування Zabbix і забезпечує доступ до історичних даних. Це є широко використовується для: - Створення нові програми для роботи з Zabbix; - Інтегрування Zabbix у стороннє програмне забезпечення; - Автоматизації рутинних завдань. Zabbix API — це API на основі HTTP, який постачається як частина веб-інтерфейсу. Він використовує протокол JSON-RPC 2.0, що означає дві речі: - API складається з набору окремих методів. - Запити та відповіді між клієнтами та API кодуються у форматі JSON. Додаткову інформацію про протокол і JSON можна знайти в [специфікації JSON-RPC 2.0] (http://www.jsonrpc.org/specification) і [на домашній сторінці формату JSON](http://json.org/). Щоб дізнатися більше про інтеграцію функцій Zabbix у ваші програми Python, перегляньте [zabbix_utils](https://github.com/zabbix/python-zabbix-utils) - Python бібліотеку для Zabbix API. ### Overview This section allows to view and [configure](/manual/it_services/sla) SLAs. ### Огляд Цей розділ дозволяє переглядати та [налаштовувати](/manual/it_services/sla) SLA. #### Overview This section presents a step-by-step real-life example of how web monitoring can be used. Let's use Zabbix web monitoring to monitor the web interface of Zabbix. We want to know if it is available, provides the right content and how quickly it works. To do that we also must log in with our user name and password. #### Огляд У цьому розділі покроково наведено реальний приклад того, як можна використовувати веб-моніторинг. Давайте використаємо веб-моніторинг Zabbix для моніторингу веб-інтерфейсу Zabbix. Ми хочемо знати, чи він доступний, надає потрібний вміст і як швидко працює. Для цього ми також повинні увійти, використовуючи своє ім’я користувача та пароль. #### Overview Zabbix supports TimescaleDB, a PostgreSQL-based database solution of automatically partitioning data into time-based chunks to support faster performance at scale. ::: notewarning Currently TimescaleDB is not supported by Zabbix proxy. ::: Instructions on this page can be used for creating TimescaleDB database or migrating from existing PostgreSQL tables to TimescaleDB. #### Огляд Zabbix підтримує TimescaleDB, базу даних на базі PostgreSQL, яка автоматично розбиває дані на фрагменти, що базуються на часовому діапазоні, для підтримки більшої продуктивності в масштабі. ::: приміткапопередження Наразі TimescaleDB не підтримується проксі Zabbix. ::: Інструкції на цій сторінці можна використовувати для створення бази даних TimescaleDB або міграції з існуючих таблиць PostgreSQL до TimescaleDB. #### Overview Zabbix web frontend can be temporarily disabled in order to prohibit access to it. This can be useful for protecting the Zabbix database from any changes initiated by users, thus protecting the integrity of database. Zabbix database can be stopped and maintenance tasks can be performed while Zabbix frontend is in maintenance mode. Users from defined IP addresses will be able to work with the frontend normally during maintenance mode. #### Огляд Веб-інтерфейс Zabbix можна тимчасово відключити, щоб заборонити доступ до нього. Це може бути корисним для захисту бази даних Zabbix від будь-яких змін, ініційованих користувачами, таким чином захищаючи цілісність бази даних. Базу даних Zabbix можна зупинити та виконати завдання з обслуговування, поки інтерфейс Zabbix перебуває в режимі обслуговування. Користувачі з визначених IP-адрес зможуть нормально працювати з інтерфейсом у режимі обслуговування. ### Parameters `(array)` IDs of hosts to delete. ### Параметри `(array)` ID хостів для видалення. ### Parameters `(array)` IDs of items to clear. ### Параметри `(array)` ID елементів для очищення. ### Parameters `(array)` IDs of the actions to delete. ### Параметри `(array)` Ідентифікатори дій для видалення. ### Parameters `(array)` IDs of the correlations to delete. ### Параметри `(array)` Ідентифікатори кореляцій, які потрібно видалити. ### Parameters `(array)` IDs of the dashboards to delete. ### Параметри `(array)` Ідентифікатори інформаційних панелей для видалення. ### Parameters `(array)` IDs of the discovery rules to delete. ### Параметри `(array)` ідентифікатори правил виявлення для видалення. ### Parameters `(array)` IDs of the graph prototypes to delete. ### Параметри `(масив)` ID прототипів графіків для видалення. ### Parameters `(array)` IDs of the graphs to delete. ### Параметри `(array)` ID графіків для видалення. ### Parameters `(array)` IDs of the host groups to delete. ### Параметри `(array)` ID груп хостів для видалення. ### Parameters `(array)` IDs of the host interfaces to delete. ### Параметри `(array)` ID хост-інтерфейсів для видалення. ### Parameters `(array)` IDs of the LLD rules to delete. ### Параметри `(array)` ідентифікатори правил LLD для видалення. ### Parameters `(array)` The method accepts an empty array. ### Параметри `(array)` Метод приймає порожній масив. ### Parameters `(object/array)` Actions to create. Additionally to the [standard action properties](object#action), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) object for the action.| |operations|array|Action [operations](/manual/api/reference/action/object#action_operation) to create for the action.| |recovery\_operations|array|Action [recovery operations](/manual/api/reference/action/object#action_recovery_operation) to create for the action.| |update\_operations|array|Action [update operations](/manual/api/reference/action/object#action_update_operation) to create for the action.| ### Параметри `(object/array)` Дії для створення. На додаток до [стандартних властивостей дії](object#action), метод приймає наступні параметри. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Дія [фільтр](/manual/api/reference/action/object#action_filter) об’єкт для дії.|| |operations|array|Дія [операції](/manual/api/reference/action/object#action_operation), щоб створити для дії.| |recovery\_operations|array|Дія [операції відновлення](/manual/api/reference/action/object#action_recovery_operation), яку потрібно створити для дії.| |update\_operations|array|Дія [операції оновлення](/manual/api/reference/action/object#action_update_operation), яку потрібно створити для дії.| ### Parameters `(object/array)` Correlation properties to be updated. The `correlationid` property must be defined for each correlation, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard correlation properties](object#correlation), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Correlation [filter](/manual/api/reference/correlation/object#correlation_filter) object to replace the current filter.| |operations|array|Correlation [operations](/manual/api/reference/correlation/object#correlation_operation) to replace existing operations.| ### Параметри Властивості кореляції `(object/array) буде оновлено. Властивість correlationid має бути визначена для кожної кореляції, усі інші властивості необов’язкові. Будуть оновлені лише передані властивості, всі інші залишаться незмінними. Окрім [стандартних властивостей кореляції](object#correlation), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |фільтр|об’єкт|Об’єкт кореляції [фільтр](/manual/api/reference/correlation/object#correlation_filter) для заміни поточного фільтра.| |operations|array|Кореляційні [операції](/manual/api/reference/correlation/object#correlation_operation) для заміни існуючих операцій.| ### Parameters `(object/array)` Discovery rule properties to be updated. The `druleid` property must be defined for each discovery rule, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard discovery rule properties](object#discovery_rule), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dchecks|array|Discovery [checks](/manual/api/reference/dcheck/object) to replace existing checks.| ### Параметри `(object/array)` Властивості правила виявлення буде оновлено. Властивість `druleid` має бути визначена для кожного правила виявлення, усі інші властивості необов’язкові. Будуть оновлені лише передані властивості, всі інші залишаться незмінними. Окрім [стандартних властивостей правила виявлення](object#discovery_rule), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |dchecks|масив|[перевірки] виявлення (/manual/api/reference/dcheck/object) для заміни існуючих перевірок.| ### Parameters `(object/array)` Graph properties to be updated. The `graphid` property must be defined for each graph, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph properties](object#graph) the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### Параметри `(object/array)` властивості графіка, які потрібно оновити. Властивість `graphid` має бути визначена для кожного графіка, усі інші властивості необов’язкові. Будуть оновлені лише передані властивості, всі інші залишаться незмінними. Додатково до [стандартних властивостей графа](object#graph) метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |gitems|масив|Графік [елементи](/manual/api/reference/graphitem/object) для заміни існуючих елементів графіка. Якщо для елемента графіка визначено властивість `gitemid`, його буде оновлено, інакше буде створено новий елемент графіка.| ### Parameters `(object/array)` Graph prototype properties to be updated. The `graphid` property must be defined for each graph prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph prototype properties](object#graph_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### Параметри `(object/array)` Властивості прототипу графіка, які потрібно оновити. Властивість `graphid` має бути визначена для кожного прототипу графа, усі інші властивості необов’язкові. Будуть оновлені лише передані властивості, всі інші залишаться незмінними. Окрім [стандартних властивостей прототипу графа](object#graph_prototype), метод приймає такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |gitems|масив|Графік [елементи](/manual/api/reference/graphitem/object) для заміни існуючих елементів графіка. Якщо для елемента графіка визначено властивість `gitemid`, його буде оновлено, інакше буде створено новий елемент графіка.| ### Parameters `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Параметри `(object/array)` [Властивості групи хостів](object#host_group) потрібно оновити. Властивість groupid має бути визначена для кожної групи хостів, усі інші властивості необов’язкові. Будуть оновлені лише вказані властивості, всі інші залишаться незмінними. ### Parameters `(object)` Parameters defining the desired output. The method supports only one parameter. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| ### Параметри `(object)` Параметри, що визначають бажаний результат. Метод підтримує лише один параметр. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |output|query|Цей параметр є загальним для всіх методів `get`, описаних у [довідковому коментарі](/manual/api/reference_commentary#common_get_method_parameters).| ### Parameters `(object)` Parameters defining the desired output. The method supports only one parameter. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| ### Параметри `(object)` Параметри, що визначають бажаний результат. Метод підтримує лише один параметр. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|Цей параметр є загальним для всіх методів `get`, описаних у [довідковому коментарі](/manual/api/reference_commentary#common_get_method_parameters).| ### Parameters `(object)` Parameters defining the desired output. The method supports only one parameter. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| ### Параметри `(object)` Параметри, що визначають бажаний результат. Метод підтримує лише один параметр. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |output|query|Цей параметр є загальним для всіх методів `get`, описаних у [довідковому коментарі](/manual/api/reference_commentary#common_get_method_parameters).| ### Parameters `(object)` Parameters defining the LLD rules to copy and the target hosts. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.| ### Параметри `(object)` Параметри, що визначають правила LLD для копіювання та ціль господарі. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |discoveryids|масив|Ідентифікатори правил LLD, які потрібно скопіювати.| |hostids|масив|Ідентифікатори хостів, до яких потрібно скопіювати правила LLD.| ### Part 1: Writing the Go code In this section you will learn how to write the plugin that adds a new metric to Zabbix agent 2. 1. Create a new directory *myip* in */usr/local/zabbix/go/plugins/*. 2. Create the file *main.go* inside *myip* directory and define the name of your Go package. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main ``` ::: notetip Keep the file open to add more lines as described in the next steps. ::: 3. Specify the packages to import. These are the packages that support the plugin. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) ``` 4. Define the plugin structure. Embed the *plugin.Base* structure to gain access to the standard plugin functionality. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin ``` 5. Implement plugin interface [Export](/devel/plugins/interfaces). The Export interface performs a poll and returns a value. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error) ``` 6. Add logging. Log messages will appear in the Zabbix agent 2 log. You can use one of the logging functions available to plugins: *Critf()*, *Errf()*, *Infof()*, *Warningf()*, *Debugf()*, *Tracef()*. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) } ``` 7. Implement the core plugin logic. This logic fetches the response from the specified URL and reads it, then returns the IP address as a response and closes the request. In case of an error when executing the GET request or reading a response, the error is returned instead. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } ``` 8. Register the metric. Zabbix agent 2 initiates running *init()* function upon startup. This function will call *plugin.RegisterMetrics(structure, plugin name, metric name, description)* method to get the plugin data. The *plugin.RegisterMetrics* method parameter description: - **structure** - a pointer to plugin implementation; grants access to the plugin structure, including list of available plugin interfaces (for example, *&impl*). - **name** - plugin name; must be unique (for example, *"Myip"*). - **metric name** - metric name (for example, *"myip"*). This is the item key used to gather data from a plugin. - **description** - metric description; must start with a capital letter and end with a period (for example, *""Return the external IP address of the host where agent is running."*). ::: notetip To register several metrics, repeat the parameters **metric name** and **description** for each metric. For example: `plugin.RegisterMetrics(&impl, "Myip", "metric.one", "Metric one description.", "metric.two", "Metric two description.")` ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } ``` 9. Define the *main()* function, which will create a new plugin handler instance, assign it to be used for logging by the plugin and then execute the plugin handler. ::: noteimportant Defining the *main()* function is mandatory. ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } func main() { h, err := container.NewHandler(impl.Name()) if err != nil { panic(fmt.Sprintf("failed to create plugin handler %s", err.Error())) } impl.Logger = &h err = h.Execute() if err != nil { panic(fmt.Sprintf("failed to execute plugin handler %s", err.Error())) } } ``` ### Частина 1: Написання коду на Go У цьому розділі ви дізнаєтеся, як написати плагін, який додає нову метрику до Zabbix агента 2. 1. Створіть новий каталог *myip* в */usr/local/zabbix/go/plugins/*. 2. Створіть файл *main.go* всередині каталогу *myip* і визначте ім'я вашого Go пакету. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main ``` ::: notetip Тримайте файл відкритим, щоб додати нові рядки, як описано в наступних кроках. ::: 3. Вкажіть пакети для імпорту. Це пакети, які підтримують плагін. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) ``` 4. Визначте структуру плагіна. Додайте структуру *plugin.Base*, щоб отримати доступ до стандартного функціоналу плагіна. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin ``` 5. Реалізуйте інтерфейс плагіна [Export] (/devel/plugins/interfaces). Інтерфейс експорту виконує опитування і повертає значення. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error) ``` 6. Додайте логування. Повідомлення журналу з'являться в log файлі Zabbix Agent 2. Ви можете використовувати одну з функцій логування, доступних для плагінів: *Critf()*, *Errf()*, *Infof()*, *Warningf()*, *Debugf()*, *Tracef()*. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) } ``` 7. Реалізуйте основну логіку плагіна. Ця логіка отримує відповідь за вказаною URL-адресою і читає її, потім повертає IP-адресу як відповідь і закриває запит. У разі помилки при виконанні GET-запиту або читанні відповіді, замість неї повертається помилка. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } ``` 8. Зареєструйте метрику. Zabbix агент 2 ініціює виконання функції *init()* при запуску. Ця функція викличе метод *plugin.RegisterMetrics(structure, plugin name, metric name, description)* для отримання даних плагіна. Опис параметрів методу *plugin.RegisterMetrics*: - **structure** - вказівник на реалізацію плагіна; надає доступ до структури плагіна, включаючи список доступних інтерфейсів плагіна (наприклад, *&impl*) .- **name** - назва плагіна; має бути унікальною (наприклад, *"Myip "*). - **metric name** - назва метрики (наприклад, *"myip "*). Це ключ елемента, який використовується для збору даних з плагіна. - **description** - опис метрики; має починатися з великої літери і закінчуватися крапкою (наприклад, *""Return the external IP address of the host where agent is running."*). :: notetip Щоб зареєструвати кілька метрик, повторіть параметри **metric name** та **description** для кожної метрики. Наприклад: `plugin.RegisterMetrics(&impl, "Myip", "metric.one", "Опис першої метрики.", "metric.two", "Опис другої метрики.")`. ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } ``` 9. Визначте функцію *main()*, яка створить новий екземпляр обробника плагіна, призначить його для ведення журналу плагіном, а потім виконає обробник плагіна. ::: noteimportant Визначення функції *main()* є обов'язковим. ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } func main() { h, err := container.NewHandler(impl.Name()) if err != nil { panic(fmt.Sprintf("failed to create plugin handler %s", err.Error())) } impl.Logger = &h err = h.Execute() if err != nil { panic(fmt.Sprintf("failed to execute plugin handler %s", err.Error())) } } ``` ### Part 2: Building the plugin In this section you will learn how to compile the plugin. 1. To create Go files for dependency handling and download the dependencies automatically execute this bash script from the CLI. ```bash go mod init myip GOPROXY=direct go get git.zabbix.com/ap/plugin-support/plugin@branchname go mod tidy go build ``` **Make sure** to specify the correct branch name, i.e. replace `branchname` (see Line 2) with one of the following: - `release/*` - for the stable release branch, where "\*" is the release version (i.e. `6.4`) - `master` - for the master branch - `<commit hash>` - for the specific commit version (use the specific commit hash) The output should be similar to this: ```go go: creating new go.mod: module myip go: to add module requirements and sums: go mod tidy go: finding module for package git.zabbix.com/ap/plugin-support/plugin/container go: finding module for package git.zabbix.com/ap/plugin-support/plugin go: found git.zabbix.com/ap/plugin-support/plugin in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 go: found git.zabbix.com/ap/plugin-support/plugin/container in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 ``` 2. Create an executable *myip* for the loadable plugin. 3. Specify the path to the plugin configuration file in the *Plugins.Myip.System.Path* parameter of Zabbix agent 2 configuration file. ::: noteimportant Plugin name in the configuration parameter name (*Myip* in this tutorial) must match the plugin name defined in the *plugin.RegisterMetrics()* function. ::: ```bash echo 'Plugins.Myip.System.Path=/usr/local/zabbix/go/plugins/myip/myip' > /etc/zabbix_agent2.d/plugins.d/myip.conf ``` 4. Test the metric: ```bash zabbix_agent2 -t myip ``` The response should contain an external IP address of your host. ::: notetip In case of an error, check whether the user *zabbix* has permissions to access */usr/local/zabbix/go/plugins/myip* directory. ::: ### Частина 2: Створення плагіна У цьому розділі ви дізнаєтеся, як скомпілювати плагін. 1. Щоб створити файли Go для обробки залежностей і автоматично завантажити залежності, виконайте цей сценарій bash із CLI. ```bash go mod init myip GOPROXY=direct go get git.zabbix.com/ap/plugin-support/plugin@branchname go mod tidy go build ``` **Переконайтеся**, що вказали правильну назву гілки, тобто замініть `branchname` (див. рядок 2) на одне з наступного: - `release/*` - для гілки стабільного релізу, де "\*" є версією релізу (тобто `6.4`) - `master` - для головної гілки - `<commit hash>` - для конкретної версії коміту (використовуйте спеціальний хеш коміту) Результат має бути подібним до цього: ```go go: creating new go.mod: module myip go: to add module requirements and sums: go mod tidy go: finding module for package git.zabbix.com/ap/plugin-support/plugin/container go: finding module for package git.zabbix.com/ap/plugin-support/plugin go: found git.zabbix.com/ap/plugin-support/plugin in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 go: found git.zabbix.com/ap/plugin-support/plugin/container in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 ``` 2. Створіть виконуваний файл *myip* для завантажуваного плагіна. 3. Вкажіть шлях до файлу конфігурації плагіна в параметрі *Plugins.Myip.System.Path* файлу конфігурації Zabbix agent 2. ::: noteimportant Ім’я плагіна в назві параметра конфігурації (*Myip* у цьому підручнику) має відповідати імені плагіна, визначеному у функції *plugin.RegisterMetrics()*. ::: ```bash echo 'Plugins.Myip.System.Path=/usr/local/zabbix/go/plugins/myip/myip' > /etc/zabbix_agent2.d/plugins.d/myip.conf ``` 4. Протестуйте метрику ```bash zabbix_agent2 -t myip ``` Відповідь має містити зовнішню IP-адресу вашого хосту. ::: notetip У разі помилки перевірте, чи має користувач *zabbix* права доступу до каталогу */usr/local/zabbix/go/plugins/myip*. ::: ## Part I - "Hello, world!" In this section you will learn how to create the minimum required widget elements and add a new widget to Zabbix frontend. ## Частина I - "Hello, world!" У цьому розділі ви дізнаєтесь, як створити мінімально необхідні елементи віджета та додати новий віджет до інтерфейсу Zabbix. ## Part II - Gauge chart ## Частина II - Калібрувальна діаграма (Gauge chart) ### Part III - Module action An action is implemented in two files - *actions/MyAddress.php* and *views/my.address.php*. The ***actions/MyAddress.php*** file takes care of the business logic implementation, while the ***views/my.address.php*** file is responsible for the view. 1. Create a directory *actions* in the *MyAddress* directory. 2. Create a *MyAddress.php* file in the *actions* directory. The action logic will be defined in the *MyAddress* class. This action class will implement four functions: *init()*, *checkInput()*, *checkPermissions()*, and *doAction()*. Zabbix frontend calls the *doAction()* function when the action is requested. This function is responsible for the business logic of the module. ::: noteimportant The data must be organized as an associative array. The array can be multidimensional and may contain any data expected by the view. ::: **ui/modules/MyAddress/actions/MyAddress.php** ```php <?php namespace Modules\MyAddress\Actions; use CController, CControllerResponseData; class MyAddress extends CController { public function init(): void { $this->disableCsrfValidation(); } protected function checkInput(): bool { return true; } protected function checkPermissions(): bool { return true; } protected function doAction(): void { $data = ['my-ip' => file_get_contents("https://api.seeip.org")]; $response = new CControllerResponseData($data); $this->setResponse($response); } } ``` 3. Create a new directory *views* in the *MyAddress* directory. 4. Create a *my.address.php* file in the *views* directory and define the module view. Note that the variable `$data` is available in the view without specifically defining it. The framework automatically passes the associative array to the view. **ui/modules/MyAddress/views/my.address.php** ```php <?php (new CHtmlPage()) ->setTitle(_('The HTML Title of My Address Page')) ->addItem(new CDiv($data['my-ip'])) ->show(); ``` 5. The module action has to be registered in the *manifest.json* file. Open *manifest.json* and add a new object `actions` that contains: - the action key with the action name written in lowercase (a-z) and with words separated by dots (for example, `my.address`); - the action class name (`MyAddress`) as a value for the `class` key of the `my.address` object; - the action view name (`my.address`) as a value for the `view` key of the `my.address` object. **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "My External IP Address", "actions": { "my.address": { "class": "MyAddress", "view": "my.address" } } } ``` 6. Open *Module.php* and change the action name in the **setAction()** method to *my.address*. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setAction('my.address') ); } } ``` 7. Refresh Zabbix frontend. Click on the *My address* menu section to see the IP address of your computer. {width="600"} ### Частина III - Дія модуля Дія реалізована в двох файлах - *actions/MyAddress.php* і *views/my.address.php*. Файл ***actions/MyAddress.php*** відповідає за реалізацію бізнес-логіки, тоді як файл ***views/my.address.php*** відповідає за зовнішній вигляд. 1. Створіть каталог *actions* у каталозі *MyAddress*. 2. Створіть файл *MyAddress.php* у каталозі *actions*. Логіка дій буде визначена в класі *MyAddress*. Цей клас дій реалізує чотири функції: *init()*, *checkInput()*, *checkPermissions()* і *doAction()*. Фронтенд Zabbix запускає функцію *doAction()*, коли викликається дія. Ця функція відповідає за бізнес-логіку модуля. ::: noteimportant Дані повинні бути організовані як асоціативний масив. Масив може бути багатовимірним і може містити будь-які дані, які очікує view. ::: **ui/modules/MyAddress/actions/MyAddress.php** ```php <?php namespace Modules\MyAddress\Actions; use CController, CControllerResponseData; class MyAddress extends CController { public function init(): void { $this->disableCsrfValidation(); } protected function checkInput(): bool { return true; } protected function checkPermissions(): bool { return true; } protected function doAction(): void { $data = ['my-ip' => file_get_contents("https://api.seeip.org")]; $response = new CControllerResponseData($data); $this->setResponse($response); } } ``` 3. Створіть новий каталог *views* у каталозі *MyAddress*. 4. Створіть файл *my.address.php* у каталозі *views* і визначте вигляд модуля. Зауважте, що змінна `$data` доступна у view без її спеціального визначення. Фреймворк автоматично передає асоціативний масив у view. **ui/modules/MyAddress/views/my.address.php** ```php <?php (new CHtmlPage()) ->setTitle(_('The HTML Title of My Address Page')) ->addItem(new CDiv($data['my-ip'])) ->show(); ``` 5. Дія модуля має бути зареєстрована у файлі *manifest.json*. Відкрийте *manifest.json* і додайте новий об’єкт «actions», який містить: - ключ дії з назвою дії, написаною малими літерами (a-z) і словами, розділеними крапками (наприклад, `my.address`); - ім'я класу дії (`MyAddress`) як значення для ключа `class` об'єкта `my.address`; - ім'я для view дії (`my.address`) як значення для ключа `view` об'єкта `my.address`. **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "My External IP Address", "actions": { "my.address": { "class": "MyAddress", "view": "my.address" } } } ``` 6. Відкрийте *Module.php* і змініть назву дії в методі **setAction()** на *my.address*. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setAction('my.address') ); } } ``` 7. Оновіть інтерфейс Zabbix. Натисніть на розділ меню *Моя адреса*, щоб побачити IP-адресу вашого комп’ютера. {width="600"} ### Part II - Menu section location change In this part, you will move the *My Address* menu section to the *Monitoring* section. As a result, users will be able to access two sub-menu pages from the *Monitoring → My Address* menu section. 1. Open and edit the *Module.php* file. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setAction('userprofile.edit') ); } } ``` 2. Refresh Zabbix frontend. Expand the *Monitoring* menu section and observe that the *My address* section is now located below the *Discovery* section. {width="600"} ### Частина II - Зміна розташування розділу меню У цій частині ви перемістите розділ меню *Моя адреса* в розділ *Моніторинг*. У результаті користувачі матимуть доступ до двох сторінок підменю з розділу меню *Моніторинг → Моя адреса*. 1. Відкрийте та відредагуйте файл *Module.php*. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setAction('userprofile.edit') ); } } ``` 2. Оновіть інтерфейс Zabbix. Розгорніть розділ меню *Моніторинг* і зверніть увагу, що розділ *Моя адреса* тепер розташований під розділом *Виявлення*. {width="600"} ### Part I - New menu section ### Частина I - Новий розділ меню ### Performing requests Once you have set up the frontend, you can use remote HTTP requests to call the API. To do that, you need to send HTTP POST requests to the `api_jsonrpc.php` file located in the frontend directory. For example, if your Zabbix frontend is installed under `https://example.com/zabbix`, an HTTP request to call the `apiinfo.version` method may look like this: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"apiinfo.version","params":{},"id":1}' ``` The request must have the `Content-Type` header set to one of these values: `application/json-rpc`, `application/json` or `application/jsonrequest`. The request object contains the following properties: - `jsonrpc` - the version of the JSON-RPC protocol used by the API (Zabbix API implements JSON-RPC version 2.0); - `method` - the API method being called; - `params` - the parameters that will be passed to the API method; - `id` - an arbitrary identifier of the request. If the request is correct, the response returned by the API should look like this: ```json { "jsonrpc": "2.0", "result": "6.4.0", "id": 1 } ``` The response object, in turn, contains the following properties: - `jsonrpc` - the version of the JSON-RPC protocol; - `result` - the data returned by the method; - `id` - an identifier of the corresponding request. ### Виконання запитів Після налаштування інтерфейсу ви можете використовувати віддалені HTTP-запити для того, щоб викликати API. Для цього вам потрібно надіслати запити HTTP POST до файлу `api_jsonrpc.php`, який розташований у каталозі фронтенду. Наприклад, якщо ваш інтерфейс Zabbix налаштований на `https://example.com/zabbix`, запит HTTP для виклику методу `apiinfo.version` може виглядати так: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"apiinfo.version","params":{},"id":1}' ``` Запит повинен мати заголовок `Content-Type`, встановлений в одне з цих значень: `application/json-rpc`, `application/json` або `application/jsonrequest`. Об'єкт запиту містить такі властивості: - `jsonrpc` - версія протоколу JSON-RPC, що використовується API (Zabbix API реалізує JSON-RPC версії 2.0); - `method` - метод API, що викликається; - `params` - параметри, які будуть передані методу API; - `id` - довільний ідентифікатор запиту. Якщо запит правильний, відповідь, повернута API, має виглядати так: ```json { "jsonrpc": "2.0", "result": "6.4.0", "id": 1 } ``` Об'єкт відповіді, в свою чергу, містить такі властивості: - `jsonrpc` - версія протоколу JSON-RPC; - `result` - дані, які повертає метод; - `id` - ідентифікатор відповідного запиту. ### plugin.Configurator *Configurator* interface provides plugin configuration parameters from Zabbix agent 2 configuration files. ### plugin.Configurator Інтерфейс *Configurator* надає параметри конфігурації плагіна з конфігураційних файлів Zabbix agent 2. ### plugin.Exporter *Exporter* is the simplest interface that performs a poll and returns a value (values), nothing, or error. It accepts a preparsed item key, parameters, and context. Access to all other plugin interfaces is exclusive and no method can be called if a plugin is already performing a task. Also, there is a limit of 100 maximum concurrent *Export()* calls per plugin, which can be reduced according to the requirements for each plugin. ### plugin.Exporter *Exporter* — це найпростіший інтерфейс, який виконує опитування та повертає значення (або кілька значень), нічого або помилку. Він приймає підготовлений ключ елемента даних, параметри та контекст. Доступ до всіх інших інтерфейсів плагінів є ексклюзивним, і жоден метод не може бути викликаний, якщо плагін уже виконує завдання. Крім того, існує обмеження в 100 одночасних викликів *Export()* для одного плагіна, яке можна зменшити відповідно до вимог для кожного плагіна. # Plugin interfaces This section describes available plugin interfaces. # Інтерфейси плагінів У цьому розділі описано доступні інтерфейси плагінів. ### plugin.Runner *Runner* interface provides the means for performing initialization when a plugin is started (activated) and deinitialization when a plugin is stopped (deactivated). For example, a plugin can start/stop some background *goroutine* by implementing the Runner interface. ### plugin.Runner Інтерфейс *Runner* надає засоби для виконання ініціалізації, коли плагін запущено (активовано), і деініціалізації, коли плагін зупинено (дезактивовано). Наприклад, плагін може запускати/зупиняти деяку фонову *goroutine* шляхом реалізації інтерфейсу Runner. # Plugins # Плагіни #### Possible deadlocks with MySQL/MariaDB When running under high load, and with more than one LLD worker involved, it is possible to run into a deadlock caused by an InnoDB error related to the row-locking strategy (see [upstream bug](https://github.com/mysql/mysql-server/commit/7037a0bdc83196755a3bf3e935cfb3c0127715d5)). The error has been fixed in MySQL since 8.0.29, but not in MariaDB. For more details, see [ZBX-21506](https://support.zabbix.com/browse/ZBX-21506). #### Possible deadlocks with MySQL/MariaDB When running under high load, and with more than one LLD worker involved, it is possible to run into a deadlock caused by an InnoDB error related to the row-locking strategy (see [upstream bug](https://github.com/mysql/mysql-server/commit/7037a0bdc83196755a3bf3e935cfb3c0127715d5)). The error has been fixed in MySQL since 8.0.29, but not in MariaDB. For more details, see [ZBX-21506](https://support.zabbix.com/browse/ZBX-21506). #### PostgreSQL If a value contains a non-ASCII character in non UTF8 encoding - this will lead to a failed SQL query (PGRES\_FATAL\_ERROR:ERROR invalid byte sequence for encoding) and data will not be stored. An appropriate warning message will be written to the *zabbix\_server.log*.\ Relevant for at least PostgreSQL version 9.1.3 #### PostgreSQL Якщо значення містить символ, відмінний від ASCII, у кодуванні, відмінному від UTF8, це призведе до помилки SQL-запиту (PGRES\_FATAL\_ERROR:ERROR недійсна послідовність байтів для кодування), і дані не будуть збережені. Відповідне попередження буде записано в *zabbix\_server.log*.\ Актуально принаймні для PostgreSQL версії 9.1.3 ### Post-migration For all databases, once the migration is completed, do the following: * Verify that everything works as expected. * Drop old tables: ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ### Після міграції Для всіх баз даних після завершення міграції виконайте такі дії: * Переконайтеся, що все працює належним чином. * Видалити старі таблиці: ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ##### Preparing frontend Make sure that Zabbix server address:port is **not defined** in the frontend configuration (found in `conf/zabbix.conf.php` of the frontend files directory). {width="600"} Zabbix frontend will autodetect the active node by reading settings from the nodes table in Zabbix database. Node address of the active node will be used as the Zabbix server address. ##### Підготовка web-інтерфейсу Переконайтеся, що в конфігураційному файлі web-інтерфейсу ( знаходиться у `conf/zabbix.conf.php` в директорії з файлами веб-інтерфейсу) **не вказано** адреса:порт Zabbix сервера. {width="600"} Web-інтерфейс Zabbix автоматично визначить активний вузол, зчитавши налаштування з таблиці вузлів у базі даних Zabbix. Адреса активного вузла буде використана як адреса Zabbix сервера. ## Pre-requisites Before proceeding make sure, that: - The module is located inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). - The module has at least a basic version of [manifest.json](/devel/modules/file_structure/manifest) file. - You have access to the Administration menu section in Zabbix (requires Super admin user role type). :::notetip The frontend will not install or even recognize incompatible modules. ::: ## Необхідні умови Перш ніж продовжити, переконайтеся, що: - Модуль знаходиться в каталозі *modules* вашої інсталяції web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). - Модуль має принаймні базову версію файлу [manifest.json](/devel/modules/file_structure/manifest). - Ви маєте доступ до розділу меню «Адміністрування» в Zabbix (потрібна роль суперадміністратора). :::notetip Інтерфейс не встановить і навіть не розпізнає несумісні модулі. ::: ##### Presentation modification methods The widget presentation modification methods are responsible for modifying widget appearance. ##### Методи модифікації презентації Методи модифікації представлення віджетів відповідають за зміну зовнішнього вигляду віджетів. # Presentation This page describes the components that can be used to create a widget presentation view. The widget presentation view is the part of the widget that receives the data according to its [configuration](/configuration) and displays it on the dashboard in a container. The presentation view consists of three parts: - [Widget action](#widget-action) - [Widget view](#widget-view) - [JavaScript](#javascript) # Презентація Ця сторінка описує компоненти, які можуть бути використані для створення представлення віджету. Представлення віджету - це частина віджету, яка отримує дані відповідно до його [конфігурації](/configuration) і відображає їх на інформаційній панелі в контейнері. Вид презентації складається з трьох частин: - [Action віджета](#widget-action) - [View віджетів](#widget-view) - [JavaScript](#javascript) #### problem [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) Added new property `cause_eventid`.\ [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) `problem.get`: Added new parameter `symptom`.\ #### problem [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) Додано нову властивість `cause_eventid`.\ [ZBXNEXT-7964](https://support.zabbix.com/browse/ZBXNEXT-7964) `problem.get`: Додано новий параметр `symptom`.\ ##### Protection against brute force attacks In case of five consecutive failed login attempts, Zabbix interface will pause for 30 seconds in order to prevent brute force and dictionary attacks. The IP address of a failed login attempt will be displayed after a successful login. ##### Захист від атак перебором У разі п’яти послідовних невдалих спроб входу інтерфейс Zabbix призупиняється на 30 секунд, щоб запобігти атакам перебору та словниковим атакам. IP-адреса невдалої спроби входу буде відображена після успішного входу. ##### Proxy configuration HA cluster nodes (servers) must be listed in the configuration of either passive or active Zabbix proxy. For a passive proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **comma**. ``` Server=zabbix-node-01,zabbix-node-02 ``` For an active proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **semicolon**. ``` Server=zabbix-node-01;zabbix-node-02 ``` ##### Конфігурація проксі Вузли (сервери) кластера HA повинні бути вказані в конфігурації пасивного або активного Zabbix проксі. Для пасивного проксі імена вузлів кластеру мають бути вказані в [параметрі](/manual/appendix/config/zabbix_proxy) Server і розділені **комою**. ``` Server=zabbix-node-01,zabbix-node-02 ``` Для активного проксі імена вузлів кластеру мають бути вказані в [параметрі](/manual/appendix/config/zabbix_proxy) Server і розділені **крапкою з комою**. ``` Server=zabbix-node-01;zabbix-node-02 ``` #### proxy [ZBXNEXT-2557](https://support.zabbix.com/browse/ZBXNEXT-2557) Added new properties `version`, `compatibility`.\ #### proxy [ZBXNEXT-2557](https://support.zabbix.com/browse/ZBXNEXT-2557) Додано нові властивості `version`, `compatibility`.\ #### proxy [ZBXNEXT-2557](https://support.zabbix.com/browse/ZBXNEXT-2557) `proxy.get`: Added strict validation of the method parameters.\ #### proxy [ZBXNEXT-2557](https://support.zabbix.com/browse/ZBXNEXT-2557) `proxy.get`: додано сувору перевірку параметрів методу.\ #### Receiving notification Now, with delivering notifications configured, it would be fun to actually receive one. To help with that, we might on purpose increase the load on our host - so that our [trigger](trigger#adding_trigger) "fires" and we receive a problem notification. Open the console on your host and run: cat /dev/urandom | md5sum You may run one or several of [these processes](http://en.wikipedia.org/wiki/Md5sum). Now go to *Monitoring → Latest data* and see how the values of 'CPU Load' have increased. Remember, for our trigger to *fire*, the 'CPU Load' value has to go over '2' for 3 minutes running. Once it does: - in *Monitoring → Problems* you should see the trigger with a flashing 'Problem' status - you should receive a problem notification in your email ::: noteimportant If notifications do not work: - verify once again that both the email settings and the action have been configured properly - make sure the user you created has at least read permissions on the host which generated the event, as noted in the *[Adding user](login#adding_user)* step. The user, being part of the 'Zabbix administrators' user group must have at least read access to 'Linux servers' host group that our host belongs to. - Additionally, you can check out the action log by going to *Reports → Action log*. ::: #### Отримання сповіщення Тепер, коли надсилання сповіщень налаштовано, було б цікаво отримати таке. Щоб допомогти з цим, ми можемо навмисно збільшити навантаження на наш вузол мережі, щоб наш [тригер](trigger#adding_trigger) "спрацював", і ми отримали сповіщення про проблему. Відкрийте консоль на вузлі мережі та запустіть: cat /dev/urandom | md5sum Ви можете запустити один або декілька з [цих процесів](http://en.wikipedia.org/wiki/Md5sum). Тепер перейдіть до *Моніторинг → Останні дані* та подивіться, як зросли значення 'CPU Load'. Пам’ятайте, щоб наш тригер *спрацював*, значення 'CPU Load' має перевищувати '2' протягом 3 хвилин. Як тільки це станеться: - у *Моніторинг → Проблеми* ви повинні побачити тригер із блимаючим статусом 'Проблема'. - ви повинні отримати сповіщення про проблему на свою електронну пошту ::: noteimportant Якщо сповіщення не працюють: - ще раз переконайтеся, що параметри електронної пошти та дію налаштовано належним чином - переконайтеся, що створений вами користувач має принаймні дозволи на читання на вузлі мережі, який створив подію, як зазначено на кроці *[Додавання користувача](login#adding_user)*. Користувач, який є частиною групи користувачів 'Адміністратори Zabbix', повинен мати принаймні доступ для читання до групи вузлів мережі 'Сервери Linux', до якої належить наш вузол мережі. - Крім того, ви можете переглянути журнал дій, перейшовши до *Звіти → Журнал дій*. ::: # Register a new module This section explains how to add a new module to Zabbix frontend. # Реєстрація нового модуля У цьому розділі пояснюється, як додати новий модуль до інтерфейсу Zabbix. ### Report The filter allows to select the report based on the SLA name as well as the service name. It is also possible to limit the displayed period. {width="600"} Each column (period) displays the SLI for that period. SLIs that are in breach of the set SLO are highlighted in red. 20 periods are displayed in the report. A maximum of 100 periods can be displayed, if both the *From* date and *To* date are specified. ### Звіт Фільтр дозволяє вибрати звіт на основі назви SLA, а також назви служби. Також можна обмежити відображуваний період. {width="600"} Кожен стовпець (період) відображає SLI для цього періоду. SLI, які порушують встановлений SLO, виділені червоним кольором. У звіті відображається 20 періодів. Можна відобразити максимум 100 періодів, якщо вказано обидві дати *Від* і *До*. ##### - Repositories Official Zabbix [repository](/manual/installation/install_from_packages/rhel) has been added to */etc/yum.repos.d*: [zabbix] name=Zabbix Official Repository - $basearch baseurl=http://repo.zabbix.com/zabbix/6.4/rhel/8/$basearch/ enabled=1 gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 ##### - Репозиторії Офіційний [репозиторій] Zabbix (/manual/installation/install_from_packages/rhel) додано до */etc/yum.repos.d*: [zabbix] name=Zabbix Official Repository - $basearch baseurl=http://repo.zabbix.com/zabbix/6.4/rhel/8/$basearch/ enabled=1 gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 ### Required mode ### Необхідний режим ### Reserved ID value "0" Reserved ID value "0" can be used to filter elements and to remove referenced objects. For example, to remove a referenced proxy from a host, proxy\_hostid should be set to 0 ("proxy\_hostid": "0") or to filter hosts monitored by server option proxyids should be set to 0 ("proxyids": "0"). ### Зарезервоване значення ідентифікатора "0" Зарезервоване значення ідентифікатора «0» можна використовувати для фільтрації елементів і видалення об’єктів, на які посилаються. Наприклад, щоб видалити проксі-сервер, на який посилається, з хоста, proxy\_hostid має бути встановлено на 0 ("proxy\_hostid": "0") або щоб фільтрувати хости, які контролюються параметром сервера, proxyids має бути встановлено на 0 ("proxyids": "0"). ### Retrieve an item value via API The widget should show the last value of an item of user's choice. For that, you need to add the ability to select items in the widget configuration. In this section, you will learn how to add an item selection field to the widget form and how to add the visual part of this field to the configuration view. Then, the widget controller will be able to retrieve item data and its value via an API request. Once received, the value can be displayed in the widget view. 1. Open *includes/WidgetForm.php* and add the *CWidgetFieldMultiSelectItem* field. This will allow selecting an item in the configuration form. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox }; /** * Gauge chart widget form. */ class WidgetForm extends CWidgetForm { public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 2. Open *views/widget.edit.php* and add the field visual component to the configuration view. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ (new CWidgetFormView($data)) ->addField( new CWidgetFieldMultiSelectItemView($data['fields']['itemid'], $data['captions']['items']['itemid']) ) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->show(); ``` 3. Return to the dashboard and click on the gear icon in the widget to open the widget configuration form. 4. The widget configuration form now contains a new input field *Item*. Select the host "Zabbix server" and the item "Load average (1m avg)". {width=600} 5. Click on *Apply* in the widget configuration form. Then click on *Save changes* in the top right corner to save the dashboard. 6. Open and modify *actions/WidgetView.php*. From now on, the item ID will be available in the widget controller in *$this->fields\_values\['itemid'\]*. The *doAction()* controller method collects the item data (name, value type, units) using the API method *[item.get](/manual/api/reference/item/get)* and the item last value using the API method *[history.get](/manual/api/reference/history/get)*. **ui/modules/lesson_gauge_chart/actions/WidgetView.php** ```php <?php namespace Modules\LessonGaugeChart\Actions; use API, CControllerDashboardWidgetView, CControllerResponseData; class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $db_items = API::Item()->get([ 'output' => ['itemid', 'value_type', 'name', 'units'], 'itemids' => $this->fields_values['itemid'], 'webitems' => true, 'filter' => [ 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT] ] ]); $value = null; if ($db_items) { $item = $db_items[0]; $history = API::History()->get([ 'output' => API_OUTPUT_EXTEND, 'itemids' => $item['itemid'], 'history' => $item['value_type'], 'sortfield' => 'clock', 'sortorder' => ZBX_SORT_DOWN, 'limit' => 1 ]); if ($history) { $value = convertUnitsRaw([ 'value' => $history[0]['value'], 'units' => $item['units'] ]); } } $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getName()), 'value' => $value, 'description' => $this->fields_values['description'], 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` 7. Open *views/widget.view.php* and add the item value to the widget view. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem([ new CTag('h1', true, $data['description']), new CDiv($data['value'] !== null ? $data['value']['value'] : _('No data')) ]) ->show(); ``` 8. Refresh the dashboard page. The widget will display the latest item value. {width="600"} ### Отримати значення елемента даних через API Віджет має відображати останнє значення елемента за вибором користувача. Для цього вам потрібно додати можливість вибору елементів у конфігурації віджета. У цьому розділі ви дізнаєтесь, як додати поле вибору елемента до форми віджета та як додати візуальну частину цього поля до view конфігурації. Тоді контролер віджетів зможе отримати дані елемента та його значення через запит API. Після отримання значення може бути відображене у вікні віджетів. 1. Відкрийте *includes/WidgetForm.php* і додайте поле *CWidgetFieldMultiSelectItem*. Це дозволить вибрати пункт у формі конфігурації. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php amespace Modules\LessonGaugeChart\Includes; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox }; /** * Gauge chart widget form. */ class WidgetForm extends CWidgetForm { public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 2. Відкрийте *views/widget.edit.php* і додайте візуальний компонент поля до view конфігурації. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ (new CWidgetFormView($data)) ->addField(new CWidgetFieldMultiSelectItemView($data['fields']['itemid'], $data['captions']['items']['itemid']) ) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->show(); ``` 3. Поверніться на інформаційну панель і клацніть значок шестірні у віджеті, щоб відкрити форму налаштування віджета. 4. Форма конфігурації віджета тепер містить нове поле введення *Елемент*. Виберіть хост «Zabbix сервер» і елемент даних "Load average (1m avg)". {width=600} 5. Натисніть *Застосувати* у формі налаштування віджета. Потім натисніть *Зберегти зміни* у верхньому правому куті, щоб зберегти інформаційну панель. 6. Відкрийте та змініть *actions/WidgetView.php*. Відтепер ідентифікатор елемента буде доступний у контролері віджетів у *$this->fields\_values\['itemid'\]*. Метод контролера *doAction()* збирає дані елемента (ім’я, тип значення, одиниці виміювання) за допомогою методу API *[item.get](/manual/api/reference/item/get)* та останнє значення елемента за допомогою Метод API *[history.get](/manual/api/reference/history/get)*. **ui/modules/lesson_gauge_chart/actions/WidgetView.php** ```php <?php namespace Modules\LessonGaugeChart\Actions; use API, CControllerDashboardWidgetView, CControllerResponseData; class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $db_items = API::Item()->get([ 'output' => ['itemid', 'value_type', 'name', 'units'], 'itemids' => $this->fields_values['itemid'], 'webitems' => true, 'filter' => [ 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT] ] ]); $value = null; if ($db_items) { $item = $db_items[0]; $history = API::History()->get([ 'output' => API_OUTPUT_EXTEND, 'itemids' => $item['itemid'], 'history' => $item['value_type'], 'sortfield' => 'clock', 'sortorder' => ZBX_SORT_DOWN, 'limit' => 1 ]); if ($history) { $value = convertUnitsRaw([ 'value' => $history[0]['value'], 'units' => $item['units'] ]); } } $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getName()), 'value' => $value, 'description' => $this->fields_values['description'], 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` 7. Відкрийте *views/widget.view.php* і додайте значення елемента до view віджета. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem([ new CTag('h1', true, $data['description']), new CDiv($data['value'] !== null ? $data['value']['value'] : _('No data')) ]) ->show(); ``` 8. Оновіть сторінку інформаційної панелі. Віджет відображатиме останнє значення елемента. {width="600"} #### Retrieving hosts Now you have a valid user authentication token that can be used to access the data in Zabbix. For example, you can use the [host.get](/manual/api/reference/host/get) method to retrieve the IDs, host names and interfaces of all the configured [hosts](/manual/api/reference/host/object): Request: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data @data.json ``` ::: notetip `data.json` is a file that contains a JSON query. Instead of a file, you can pass the query in the `--data` argument. ::: data.json ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": [ "hostid", "host" ], "selectInterfaces": [ "interfaceid", "ip" ] }, "id": 2 } ``` The response object will contain the requested data about the hosts: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "host": "Zabbix server", "interfaces": [ { "interfaceid": "1", "ip": "127.0.0.1" } ] } ], "id": 2 } ``` ::: notetip For performance reasons it is always recommended to list the object properties you want to retrieve. Thus, you will avoid retrieving everything. ::: #### Отримання хостів Тепер у вас є дійсний токен автентифікації користувача, який можна використовувати для доступу до даних у Zabbix. Наприклад, ви можете використовувати метод[host.get](/manual/api/reference/host/get) для отримання ідентифікаторів, імен хостів та інтерфейсів всіх налаштованих[хостів](/manual/api/reference/host/object): Запит: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data @data.json ``` ::: notetip `data.json` – це файл, який містить запит JSON. Замість файлу ви можете передати запит в аргументі `--data`. ::: data.json ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": [ "hostid", "host" ], "selectInterfaces": [ "interfaceid", "ip" ] }, "id": 2 } ``` Об'єкт відповіді буде містити запитувані дані про хости: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "host": "Zabbix server", "interfaces": [ { "interfaceid": "1", "ip": "127.0.0.1" } ] } ], "id": 2 } ``` ::: notetip З міркувань продуктивності завжди рекомендується перераховувати конкретні властивості об’єкта, які потрібно отримати. Таким чином, ви уникнете отримання одразу всіх властивостей. ::: #### Retrieving the version of the API Retrieve the version of the Zabbix API. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "apiinfo.version", "params": [], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "6.4.0", "id": 1 } ``` #### Отримання версії API Отримайте версію Zabbix API. запит: ```json { "jsonrpc": "2.0", "method": "apiinfo.version", "params": [], "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": "4.0.0", "id": 1 } ``` ### Return values `(array)` Returns an array with changes in configuration, that will be made. ### Повернуті значення `(array)` Повертає масив зі змінами в конфігурації, які будуть внесені. ### Return values `(boolean )` Returns boolean true as result on successful update. ### Повернуті значення `(boolean )` Повертає логічне значення true як результат успішного оновлення. ### Return values `(boolean)` Returns `true` if importing has been successful. ### Повернуті значення `(boolean)` Повертає `true`, якщо імпортування було успішним. ### Return values `(boolean)` Returns `true` if the copying was successful. ### Повернуті значення `(boolean)` Повертає `true`, якщо копіювання було успішним. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори очищених елементів у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the created actions under the `actionids` property. The order of the returned IDs matches the order of the passed actions. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених дій у властивості `actionids`. Порядок повернених ідентифікаторів відповідає порядку виконаних дій. ### Return values `(object)` Returns an object containing the IDs of the created correlations under the `correlationids` property. The order of the returned IDs matches the order of the passed correlations. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених кореляцій у властивості `correlationids`. Порядок повернених ідентифікаторів відповідає порядку переданих кореляцій. ### Return values `(object)` Returns an object containing the IDs of the created dashboards under the `dashboardids` property. The order of the returned IDs matches the order of the passed dashboards. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інформаційних панелей у властивості `dashboardids`. Порядок повернених ідентифікаторів відповідає порядку переданих інформаційних панелей. ### Return values `(object)` Returns an object containing the IDs of the created discovery rules under the `druleids` property. The order of the returned IDs matches the order of the passed discovery rules. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених правил виявлення у властивості `druleids`. Порядок повернених ідентифікаторів відповідає порядку переданих правил виявлення. ### Return values `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених прототипів графів у властивості `graphids`. Порядок повернених ідентифікаторів відповідає порядку переданих прототипів графів. ### Return values `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених графіків у властивості `graphids`. Порядок повернених ідентифікаторів відповідає порядку переданих графіків. ### Return values `(object)` Returns an object containing the IDs of the created host groups under the `groupids` property. The order of the returned IDs matches the order of the passed host groups. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених груп хостів у властивості `groupids`. Порядок повернених ідентифікаторів відповідає порядку переданих груп хостів. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених хост-інтерфейсів у властивості `interfaceids`. Порядок повернених ідентифікаторів відповідає порядку переданих інтерфейсів хоста. ### Return values `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених прототипів хостів у властивості `hostids`. Порядок повернутих ідентифікаторів відповідає порядку переданих прототипів хосту. ### Return values `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених хостів у властивості `hostids`. Порядок повернених ідентифікаторів відповідає порядку переданих хостів. ### Return values `(object)` Returns an object containing the IDs of the created LLD rules under the `itemids` property. The order of the returned IDs matches the order of the passed LLD rules. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених правил LLD у властивості `itemids`. Порядок повернених ідентифікаторів відповідає порядку переданих правил LLD. ### Return values `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених веб-сценаріїв у властивості `httptestids`. Порядок повернених ідентифікаторів відповідає порядку переданих веб-сценаріїв. ### Return values `(object)` Returns an object containing the IDs of the deleted actions under the `actionids` property. ### Повернуті значення `(object)` повертає об’єкт, що містить ідентифікатори видалених дій у властивості `actionids`. ### Return values `(object)` Returns an object containing the IDs of the deleted correlations under the `correlationids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених кореляцій у властивості `correlationids`. ### Return values `(object)` Returns an object containing the IDs of the deleted dashboards under the `dashboardids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інформаційних панелей у властивості `dashboardids`. ### Return values `(object)` Returns an object containing the IDs of the deleted discovery rules under the `druleids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених правил виявлення у властивості `druleids`. ### Return values `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених прототипів графів у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених графіків у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the deleted items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених елементів даних у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the updated actions under the `actionids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених дій у властивості `actionids`. ### Return values `(object)` Returns an object containing the IDs of the updated correlations under the `correlationids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених кореляцій у властивості `correlationids`. ### Return values `(object)` Returns an object containing the IDs of the updated dashboards under the `dashboardids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених інформаційних панелей у властивості `dashboardids`. ### Return values `(object)` Returns an object containing the IDs of the updated discovery rules under the `druleids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених правил виявлення у властивості `druleids`. ### Return values `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених подій у властивості `eventids`. ### Return values `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених прототипів графів у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених графіків у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених елементів даних у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the updated LLD rules under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених правил LLD у властивості `itemids`. ### Return values `(object)` Returns authentication object. ### Повернуті значення `(object)` Повертає об'єкт автентифікації. ### Return values `(object)` Returns autoregistration object. ### Повернуті значення `(object)` Повертає об'єкт автореєстрації. ### Return values `(object)` Returns housekeeping object. ### Повернуті значення `(object)` Повертає об'єкт господарювання. ### Return values `(string)` Returns a serialized string containing the requested configuration data. ### Повернуті значення `(string)` Повертає серіалізований рядок, що містить запитувані дані конфігурації. ### Return values `(string)` Returns the version of the Zabbix API. ::: notetip Starting from Zabbix 2.0.4 the version of the API matches the version of Zabbix. ::: ### Повернуті значення `(string)` Повертає версію Zabbix API. ::: notetip Починаючи з Zabbix 2.0.4 версія API відповідає версії Zabbix. ::: #### RHEL Nginx is available only in EPEL: # dnf -y install epel-release #### RHEL Nginx доступний лише в EPEL: # dnf -y install epel-release ### Runtime control options **config\_cache\_reload** Reload configuration cache. Ignored if cache is being currently loaded. Active Zabbix proxy will connect to the Zabbix server and request configuration data. Default configuration file (unless **-c** option is specified) will be used to find PID file and signal will be sent to process, listed in PID file. **snmp\_cache\_reload** Reload SNMP cache. **housekeeper\_execute** Execute the housekeeper. Ignored if housekeeper is being currently executed. **diaginfo**\[=*section*\] Log internal diagnostic information of the specified section. Section can be *historycache*, *preprocessing*. By default diagnostic information of all sections is logged. **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} ### Параметри runtime-option **config\_cache\_reload** Перезавантажити кеш конфігурації. Ігнорується, якщо зараз завантажується кеш. Активний проксі-сервер Zabbix підключатиметься до сервера Zabbix і запитуватиме конфігураційні дані. Файл конфігурації за замовчуванням (якщо не вказано параметр **-c**) використовуватиметься для пошуку файлу PID, а сигнал буде надіслано до процесу, зазначеного у файлі PID. **snmp\_cache\_reload** Перезавантажте кеш SNMP. **housekeeper\_execute** Стратити економку. Ігнорується, якщо зараз працює економка виконано. **diaginfo**\[=*section*\] Реєстрація внутрішньої діагностичної інформації вказаного розділу. Розділ може бути *historycache*, *preprocessing*. За замовчуванням реєструється діагностична інформація всіх розділів. **log\_level\_increase**\[=*target*\] Підвищити рівень журналу, впливає на всі процеси, якщо ціль не вказано. **log\_level\_decrease**\[=*target*\] Зниження рівня журналу, впливає на всі процеси, якщо ціль не вказано. [ ]{#lbAG} ### Runtime control options **userparameter\_reload** Reload user parameters from the configuration file **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} ### Параметри керування виконанням (Runtime options) **userparameter\_reload** Перезавантаження параметрів користувача з файлу конфігурації **log\_level\_increase**\[=*target*\] Підвищити рівень журналу, впливає на всі процеси, якщо ціль не вказано **log\_level\_decrease**\[=*target*\] Зниження рівня журналу, впливає на всі процеси, якщо ціль не вказано [ ]{#lbAG} #### Scenario #### Сценарій #### script [ZBX-19466](https://support.zabbix.com/browse/ZBX-19466) Changed validation of [Script](/manual/api/reference/script/object#script) object to be unique by combination of 2 properties: `name` and `menu_path`.\ #### script [ZBX-19466](https://support.zabbix.com/browse/ZBX-19466) Змінено перевірку об'єкта [Script](/manual/api/reference/script/object#script) на унікальність за комбінацією 2 властивостей: `name` та `menu_path`.\ #### script [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) Added new properties `url`, `new_window`.\ [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) Added new [Script](/manual/api/reference/script/object#script) type "URL" (6).\ [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) Added new method `script.getscriptsbyevents`.\ [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) `script.create`: Property `scope` is now mandatory.\ [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) `script.create`: Property `command` is now mandatory for [Script](/manual/api/reference/script/object#script) types "Script" (0), "IPMI" (1), "SSH" (2), "TELNET" (3), and "Webhook" (5).\ [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) `script.getscriptsbyhosts`: Method now automatically resolves macros in properties `confirmation`, `url`.\ #### guion [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) Додано нові властивості `url`, `new_window`.\ [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) Додано новий [Script](/manual/api/reference/script/object#script) типу «URL» (6).\ [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) Додано новий метод `cript.getscriptsbyevents`.\ [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) `script.create`: Властивість `scope` тепер є обов'язковою.\ [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) `script.create`: Властивість `command` тепер є обов'язковою для [Script](/manual/api/reference/script/object#script) типів «Script» (0), «IPMI» (1), «SSH» (2), «TELNET» (3) і «Webhook» (5).\ [ZBXNEXT-3496](https://support.zabbix.com/browse/ZBXNEXT-3496) `script.getscriptsbyhosts`: Метод тепер автоматично резолвить макроси у властивостях `confirmation`, `url`.\ #### Sections [Introduction](about) provides general information about current Zabbix software. Reading this section should equip you with some good reasons to choose Zabbix. [Zabbix concepts](/manual/definitions) explain the terminology used in Zabbix and provides details on Zabbix components. [Installation](/manual/installation/getting_zabbix) and [Quickstart](/manual/quickstart/item) sections should help you to get started with Zabbix. [Zabbix appliance](/manual/appliance) is an alternative for getting a quick taster of what it is like to use Zabbix. [Configuration](/manual/config) is one of the largest and more important sections in this manual. It contains loads of essential advice about how to set up Zabbix to monitor your environment, from setting up hosts to getting essential data to viewing data to configuring notifications and remote commands to be executed in case of problems. [Service monitoring](/manual/it_services) section details how to use Zabbix for a high-level overview of your monitoring environment. [Web monitoring](/manual/web_monitoring) should help you learn how to monitor the availability of web sites. [Virtual machine monitoring](/manual/vm_monitoring) presents a how-to for configuring VMware environment monitoring. [Maintenance](/manual/maintenance), [Regular expressions](/manual/regular_expressions), [Event acknowledgment](/manual/acknowledges) and [XML export/import](/manual/xml_export_import) are further sections that reveal how to use these various aspects of Zabbix software. [Discovery](/manual/discovery) contains instructions for setting up automatic discovery of network devices, active agents, file systems, network interfaces, etc. [Distributed monitoring](/manual/distributed_monitoring) deals with the possibilities of using Zabbix in larger and more complex environments. [Encryption](/manual/encryption) helps explaining the possibilities of encrypting communications between Zabbix components. [Web interface](/manual/web_interface) contains information specific for using the web interface of Zabbix. [API](/manual/api) section presents details of working with Zabbix API. Detailed lists of technical information are included in [Appendixes](/manual/appendix). This is where you will also find a FAQ section. #### Розділи [Вступ](about) надає загальну інформацію про поточне програмне забезпечення Zabbix. Прочитавши цей розділ, ви отримаєте кілька вагомих причин вибрати Zabbix. [Концепції Zabbix](/manual/definitions) пояснюють термінологію, яка використовується в Zabbix і надає детальну інформацію про компоненти Zabbix. Розділи [Встановлення](/manual/installation/getting_zabbix) і [Швидкий початок](/manual/quickstart/item) мають допомогти вам почати роботу з Zabbix. [Готове рішення Zabbix](/manual/appliance) — це альтернатива для швидкого ознайомлення з використанням Zabbix. [Налаштування](/manual/config) є одним із найбільших і важливіших розділів цього посібника. Він містить безліч важливих порад про те, як налаштувати Zabbix для моніторингу вашого середовища, від налаштування вузлів мережі до отримання важливих даних для перегляду даних до налаштування сповіщень і віддалених команд, які будуть виконуватися у разі виникнення проблем. У розділі [Моніторинг служби](/manual/it_services) детально описано, як використовувати Zabbix для загального огляду вашого середовища моніторингу. [Веб-моніторинг](/manual/web_monitoring) допоможе вам навчитися стежити за доступністю веб-сайтів. [Моніторинг віртуальної машини](/manual/vm_monitoring) представляє інструкції для налаштування моніторингу середовища VMware. [Технічне обслуговування](/manual/maintenance), [Регулярні вирази](/manual/regular_expressions), [Підтвердження подій](/manual/acknowledges) і [Експорт/імпорт XML](/manual/xml_export_import) — це додаткові розділи, у яких показано, як використовувати ці різні аспекти програмного забезпечення Zabbix. [Виявлення](/manual/discovery) містить інструкції з налаштування автоматичного виявлення мережевих пристроїв, активних агентів, файлових систем, мережевих інтерфейсів тощо. [Розподілений моніторинг](/manual/distributed_monitoring) стосується можливості використання Zabbix у більших і складніших середовищах. [Шифрування](/manual/encryption) допомагає пояснити можливості шифрування зв’язку між компонентами Zabbix. [Веб-інтерфейс](/manual/web_interface) містить інформацію, специфічну для використання веб-інтерфейсу Zabbix. Розділ [API](/manual/api) містить подробиці роботи з Zabbix API. Детальні списки технічної інформації включені в [Додатки](/manual/appendix). Тут ви також знайдете розділ поширених запитань. ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) - [Script](/manual/api/reference/script/object) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Alert](/manual/api/reference/alert/object) - [Item](/manual/api/reference/item/object) - [Host](/manual/api/reference/host/object) - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) - [Trigger](/manual/api/reference/trigger/object) ### Дивись також - [Попередження](/manual/api/reference/alert/object) - [Елемент](/manual/api/reference/item/object) - [Хост](/manual/api/reference/host/object) - [Правило LLD](/manual/api/reference/discoveryrule/object#lld_rule) - [Тригер](/manual/api/reference/trigger/object) ### See also - [Audit log object](/manual/api/reference/auditlog/object) ### Дивись також - [Об'єкт журналу аудиту](/manual/api/reference/auditlog/object) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) - [Host](/manual/api/reference/host/object#host) ### Дивись також - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) - [Хост](/manual/api/reference/host/object#host) ### See also - [Discovered service](/manual/api/reference/dservice/object#discovered_service) - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) ### Дивись також - [Виявлена служба](/manual/api/reference/dservice/object#discovered_service) - [Правило виявлення](/manual/api/reference/drule/object#discovery_rule) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) ------------------------------------------------------------------------ [ ]{#index} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) -------------------------------------------------- ---------------------- [ ]{#index} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### Дивись також - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### Дивись також - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph](/manual/api/reference/graph/object#graph) ### Дивись також - [Графік](/manual/api/reference/graph/object#graph) ### See also - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Host](/manual/api/reference/host/object#host) - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) - [LLD rule filter](object#lld_rule_filter) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### Дивись також - [Прототип графіка](/manual/api/reference/graphprototype/object#graph_prototype) - [Хост](/manual/api/reference/host/object#host) - [Прототип елемента](/manual/api/reference/itemprototype/object#item_prototype) - [Фільтр правил LLD](object#lld_rule_filter) - [Прототип тригера](/manual/api/reference/triggerprototype/object#trigger_prototype) ### See also - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### Дивись також - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### See also - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### Дивись також - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### Дивись також - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### See also - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### Дивись також - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Елемент](/manual/api/reference/item/object#item) ### See also - [Host](/manual/api/reference/host/object#host) - [Media type](/manual/api/reference/mediatype/object#media_type) - [User](/manual/api/reference/user/object#user) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Тип медіа](/manual/api/reference/mediatype/object#media_type) - [Користувач](/manual/api/reference/user/object#user) ### See also - [host.update](update) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### Дивись також - [host.update](оновити) - [Група хостів](/manual/api/reference/hostgroup/object#host_group) - [Шаблон](/manual/api/reference/template/object#template) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) ### See also - [host.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### Дивись також - [host.update](оновити) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) ### See also - [LLD rule filter](object#lld_rule_filter) - [LLD macro paths](object#lld_macro_path) - [LLD rule preprocessing](object#lld_rule_preprocessing) ### Дивись також - [Фільтр правил LLD](object#lld_rule_filter) - [Шляхи макросу LLD](object#lld_macro_path) - [Попередня обробка правила LLD](object#lld_rule_preprocessing) ### See also - [Scenario step](object#scenario_step) ### Дивись також - [Крок сценарію](object#scenario_step) ### See also - [Scenario step](object#scenario_step) ### Дивись також - [Крок сценарію](object#scenario_step) #### Server To enable encryption with certificate verification for connections between Zabbix server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_ca DBTLSCAFile=/etc/ssl/mysql/ca.pem ... #### Сервер Щоб увімкнути шифрування з перевіркою сертифіката для з’єднань між сервером Zabbix і базою даних, налаштуйте */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_ca DBTLSCAFile=/etc/ssl/mysql/ca.pem ... #### Server To enable encryption with full verification for connections between Zabbix server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_full DBTLSCAFile=/etc/ssl/mysql/ca.pem DBTLSCertFile=/etc/ssl/mysql/client-cert.pem DBTLSKeyFile=/etc/ssl/mysql/client-key.pem ... #### Сервер Щоб увімкнути шифрування з повною перевіркою з’єднань між сервером Zabbix і базою даних, налаштуйте */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_full DBTLSCAFile=/etc/ssl/mysql/ca.pem DBTLSCertFile=/etc/ssl/mysql/client-cert.pem DBTLSKeyFile=/etc/ssl/mysql/client-key.pem ... #### Server To enable transport-only encryption for connections between server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=required ... #### Сервер Щоб увімкнути лише транспортне шифрування для з’єднань між сервером і базою даних, налаштуйте */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=required ... #### Slideshow It is possible to activate a slideshow in the dashboard: - `/zabbix.php?action=dashboard.view&slideshow=1` - activate slideshow #### Слайд-шоу Слайд-шоу можна активувати на інформаційній панелі: - `/zabbix.php?action=dashboard.view&slideshow=1` - активувати показ слайдів ### Source CAction::create() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::create() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::delete() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::delete() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::get() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::get() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::update() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::update() у *ui/include/classes/api/services/CAction.php*. ### Source CAlert::get() in *ui/include/classes/api/services/CAlert.php*. ### Джерело CAlert::get() у *ui/include/classes/api/services/CAlert.php*. ### Source CAPIInfo::version() in *ui/include/classes/api/services/CAPIInfo.php*. ### Джерело CAPIInfo::version() у *ui/include/classes/api/services/CAPIInfo.php*. ### Source CAuditLog::get() in *ui/include/classes/api/services/CAuditLog.php*. ### Джерело CAuditLog::get() у *ui/include/classes/api/services/CAuditLog.php*. ### Source CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### Джерело CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### Source CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### Джерело CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### Source CConfiguration::export() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::export() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::importcompare() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CConfiguration::import() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::import() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CCorrelation::create() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::create() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::delete() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::delete() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::get() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::update() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::update() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::create() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::delete() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::get() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::update() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### Джерело CDCheck::get() в *ui/include/classes/api/services/CDCheck.php*. ### Source CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Джерело CDHost::get() в *ui/include/classes/api/services/CDHost.php*. ### Source CDiscoveryRule::create() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::create() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::delete() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::delete() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::get() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::get() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::update() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::update() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::create() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::delete() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::get() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::update() в *ui/include/classes/api/services/CDRule.php*. ### Source CDService::get() in *ui/include/classes/api/services/CDService.php*. ### Джерело CDService::get() в*ui/include/classes/api/services/CDService.php*. ### Source CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### Джерело CEvent::acknowledge() в *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### Джерело CEvent::get() в *ui/include/classes/api/services/CEvent.php*. ### Source CGraph::create() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::create() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::delete() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::get() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### Джерело CGraphItem::get() у *ui/include/classes/api/services/CGraphItem.php*. ### Source CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::create() в *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::delete() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::get() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::update() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::update() у *ui/include/classes/api/services/CGraph.php*. ### Source CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### Джерело CHaNode::get() у *ui/include/classes/api/services/CHaNode.php*. ### Source CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### Джерело CHistory::clear() у *ui/include/classes/api/services/CHistory.php*. ### Source CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ### Джерело CHistory::get() у *ui/include/classes/api/services/CHistory.php*. ### Source CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::create() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::delete() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::delete() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::get() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::get() в *ui/include/classes/api/services/CHost.php*. ### Source CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::create() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::delete() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::delete() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::get() у *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massAdd() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massRemove() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massUpdate() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::update() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::create() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::delete() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::get() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::massAdd() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::massRemove() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::replaceHostInterfaces() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::update() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massAdd() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massRemove() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massUpdate() в *ui/include/classes/api/services/CHost.php*. ### Source CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::create() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::delete() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::get() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::update() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHost::update() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::update() в *ui/include/classes/api/services/CHost.php*. ### Source CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Джерело CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Джерело CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::delete() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::get() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::update() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CIconMap::create() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::create() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::delete() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::get() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::get() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::update() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::update() в *ui/include/classes/api/services/CIconMap.php*. ### Source CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::create() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::delete() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::delete() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::get() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::get() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::update() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::update() в *ui/include/classes/api/services/CImage.php*. ### Source CItem::create() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::create() в *ui/include/classes/api/services/CItem.php*. ### Source CItem::delete() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::delete() в *ui/include/classes/api/services/CItem.php*. ### Source CItem::get() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::get() в *ui/include/classes/api/services/CItem.php*. ### Source CItemPrototype::create() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::create() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::delete() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::delete() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::get() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::get() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::update() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::update() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItem::update() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::update() в *ui/include/classes/api/services/CItem.php*. ### Source CMaintenance::create() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::create() в *ui/include/classes/api/services/CMaintenance.php*. ### Source CMaintenance::delete() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::delete() в *ui/include/classes/api/services/CMaintenance.php*. ### Source CMaintenance::get() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::get() в *ui/include/classes/api/services/CMaintenance.php*. #### SQLite Using SQLite is supported for **Zabbix proxy** only! The database will be automatically created if it does not exist. Return to the [installation section](/manual/installation/install). #### SQLite Використання SQLite підтримується лише для **Zabbix proxy**! База даних буде створена автоматично, якщо вона не існує. Поверніться до [розділу встановлення](/manual/installation/install). ##### Starting Zabbix server as cluster node Two parameters are required in the server [configuration](/manual/appendix/config/zabbix_server) to start a Zabbix server as cluster node: - **HANodeName** parameter must be specified for each Zabbix server that will be an HA cluster node. This is a unique node identifier (e.g. `zabbix-node-01`) that the server will be referred to in agent and proxy configurations. If you do not specify HANodeName, then the server will be started in standalone mode. - **NodeAddress** parameter must be specified for each node. The NodeAddress parameter (address:port) will be used by Zabbix frontend to connect to the active server node. NodeAddress must match the IP or FQDN name of the respective Zabbix server. Restart all Zabbix servers after making changes to the configuration files. They will now be started as cluster nodes. The new status of the servers can be seen in *Reports* → *[System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix#status_of_ha_cluster_nodes)* and also by running: ``` zabbix_server -R ha_status ``` This runtime command will log the current HA cluster status into the Zabbix server log (and to stdout): {width="600"} ##### Запуск Zabbix сервера як вузла кластера У [конфігурації](/manual/appendix/config/zabbix_server) сервера необхідно вказати два параметри, щоб запустити Zabbix сервер як вузол кластера: - Параметр **HANodeName** необхідно вказати для кожного Zabbix сервера, який буде вузлом кластера високої доступності. Це унікальний ідентифікатор вузла (наприклад, `zabbix-node-01`), за допомогою якого можна звертатися до сервера у конфігураціях агента та проксі. Якщо ви не вкажете HANodeName, то сервер буде запущено в автономному режимі. - Для кожного вузла необхідно вказати параметр **NodeAddress**. Параметр NodeAddress (адреса:порт) використовуватиметься web-інтерфейсом Zabbix для підключення до активної ноди. NodeAddress має відповідати IP-адресі або FQDN імені відповідного Zabbix сервера. Перезапустіть всі Zabbix сервери, після внесення змін до конфігураційних файлів. Тепер вони будуть запущені як вузли кластера. Новий статус серверів можна побачити в розділі *Звіти* → *[Інформація про систему](/manual/web_interface/frontend_sections/reports/status_of_zabbix#status_of_ha_cluster_nodes)* а також за допомогою команди: ``` zabbix_server -R ha_status ``` Ця команда виведе поточний стан кластера високої доступності в log-файл Zabbix сервера (і в стандартний потік виводу): {width="600"} ##### Step 1 Install Kerberos package. For Debian/Ubuntu: apt install krb5-user For RHEL: dnf install krb5-workstation ##### Крок 1 Встановіть пакет Kerberos. Для Debian/Ubuntu: apt install krb5-user Для RHEL: dnf install krb5-workstation ##### Step 1 To define your own theme you'll need to create a CSS file and save it in the `assets/styles/` folder (for example, *custom-theme.css*). You can either copy the files from a different theme and create your theme based on it or start from scratch. ##### Крок 1 Щоб визначити власну тему, вам потрібно створити файл CSS і зберегти його в папці `assets/styles/` (наприклад, *custom-theme.css*). Ви можете або скопіювати файли з іншої теми та створити свою тему на її основі, або почати з нуля. ##### Step 2 Add your theme to the list of themes returned by the APP::getThemes() method. You can do this by overriding the ZBase::getThemes() method in the APP class. This can be done by adding the following code before the closing brace in *include/classes/core/APP.php*: public static function getThemes() { return array_merge(parent::getThemes(), [ 'custom-theme' => _('Custom theme') ]); } ::: noteimportant Note that the name you specify within the first pair of quotes must match the name of the theme file without extension. ::: To add multiple themes, just list them under the first theme, for example: public static function getThemes() { return array_merge(parent::getThemes(), [ 'custom-theme' => _('Custom theme'), 'anothertheme' => _('Another theme'), 'onemoretheme' => _('One more theme') ]); } Note that every theme except the last one must have a trailing comma. ::: notetip To change graph colors, the entry must be added in the *graph\_theme* database table. ::: ##### Крок 2 Додайте свою тему до списку тем, які повертає метод APP::getThemes(). Це можна зробити, перевизначивши метод ZBase::getThemes() у класі APP. Це можна зробити, додавши такий код перед закриваючою дужкою в *include/classes/core/APP.php*: · public static function getThemes() { · return array_merge(parent::getThemes(), [ · 'custom-theme' => _('Custom theme') · ]); · } ::: noteimportant Зауважте, що назва, яку ви вказуєте в першій парі лапок, має збігатися з назвою файлу теми без розширення. ::: Щоб додати кілька тем, просто перелічіть їх під першою темою, наприклад: · public static function getThemes() { · return array_merge(parent::getThemes(), [ · 'custom-theme' => _('Custom theme'), · 'anothertheme' => _('Another theme'), · 'onemoretheme' => _('One more theme') · ]); · } Зауважте, що кожна тема, крім останньої, повинна мати кінцеву кому. ::: підказка Щоб змінити кольори графіка, потрібно додати запис у таблицю бази даних *graph\_theme*. ::: ##### Step 2 Configure Kerberos configuration file (see MIT documentation for details) ``` {.java} cat /etc/krb5.conf [libdefaults] default_realm = EXAMPLE.COM # The following krb5.conf variables are only for MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` ##### Крок 2 Налаштувати файл конфігурації Kerberos (докладніше див. у документації MIT) ``` {.java} cat /etc/krb5.conf [libdefaults] default_realm = EXAMPLE.COM # The following krb5.conf variables are only for MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` ##### Step 2 Define steps for the scenario. Click on *Add* button in the *Steps* tab to add individual steps. *Web scenario step 1* We start by checking that the first page responds correctly, returns with HTTP response code 200 and contains text "Zabbix SIA". {width="600"} When done configuring the step, click on *Add*. *Web scenario step 2* We continue by logging in to the Zabbix frontend, and we do so by reusing the macros (variables) we defined on the scenario level - {user} and {password}. {width="600"} ::: noteimportant Note that Zabbix frontend uses JavaScript redirect when logging in, thus first we must log in, and only in further steps we may check for logged-in features. Additionally, the login step must use full URL to **index.php** file. ::: Take note also of how we are getting the content of the `{sid}` variable (session ID) using a variable syntax with regular expression: `regex:name="csrf-token" content="([0-9a-z]{16})"`. This variable will be required in step 4. *Web scenario step 3* Being logged in, we should now verify the fact. To do so, we check for a string that is only visible when logged in - for example, **Administration**. {width="600"} *Web scenario step 4* Now that we have verified that frontend is accessible and we can log in and retrieve logged-in content, we should also log out - otherwise Zabbix database will become polluted with lots and lots of open session records. {width="600"} *Web scenario step 5* We can also check that we have logged out by looking for the **Username** string. {width="600"} *Complete configuration of steps* A complete configuration of web scenario steps should look like this: {width="600"} ##### Крок 2 Визначте кроки для сценарію. Натисніть кнопку *Додати* на вкладці *Кроки*, щоб додати окремі кроки. *Крок 1 веб-сценарію* Ми починаємо з перевірки, що перша сторінка відповідає правильно, повертає код відповіді HTTP 200 і містить текст «Zabbix SIA». {width="600"} Після завершення налаштування кроку натисніть *Додати*. *Крок 2 веб-сценарію* Ми продовжуємо, входячи в інтерфейс Zabbix, і ми робимо це, повторно використовуючи макроси (змінні), які ми визначили на рівні сценарію - {user} і {password}. {width="600"} ::: приміткаважливо Зауважте, що інтерфейс Zabbix використовує перенаправлення JavaScript під час входу, тому спочатку ми повинні авторизуватися, і лише на наступних кроках ми можемо перевірити наявність функцій входу. Крім того, на етапі входу має використовуватися повна URL-адреса файлу **index.php**. ::: Зверніть також увагу на те, як ми отримуємо вміст змінної `{sid}` (ідентифікатор сеансу) за допомогою синтаксису змінної з регулярним виразом: `regex:name="csrf-token" content="([0-9a-z ]{16})"`. Ця змінна знадобиться на кроці 4. *Веб-сценарій крок 3* Увійшовши в систему, ми повинні перевірити факт. Для цього ми перевіряємо рядок, який відображається лише після входу в систему, наприклад, **Адміністрування**. {width="600"} *Веб-сценарій крок 4* Тепер, коли ми переконалися, що інтерфейс доступний, і ми можемо увійти та отримати вміст, який авторизувався, нам також слід вийти - інакше база даних Zabbix буде забруднена великою кількістю відкритих записів сеансу. {width="600"} *Крок 5 веб-сценарію* Ми також можемо перевірити, чи ми вийшли, знайшовши Рядок **Ім’я користувача**. {width="600"} *Повна конфігурація кроків* Повна конфігурація етапів веб-сценарію має виглядати так: {width="600"} ##### Step 3 Activate the new theme. In Zabbix frontend, you may either set this theme to be the default one or change your theme in the user profile. Enjoy the new look and feel! ##### Крок 3 Активуйте нову тему. У інтерфейсі Zabbix ви можете або встановити цю тему як тему за замовчуванням, або змінити свою тему в профілі користувача. Насолоджуйтесь новим зовнішнім виглядом! ##### Step 3 Create a Kerberos ticket for user *zabbix*. Run the following command as user *zabbix*: kinit zabbix ::: noteimportant It is important to run the above command as user *zabbix*. If you run it as *root* the authentication will not work. ::: ##### Крок 3 Створіть квиток Kerberos для користувача *zabbix*. Виконайте наступну команду від імені користувача *zabbix*: kinit zabbix ::: noteimportant Важливо виконати наведену вище команду як користувач *zabbix*. Якщо ви запустите його як *root*, автентифікація не працюватиме. ::: ##### Step 3 Save the finished web monitoring scenario. The scenario will be added to a host. To view web scenario information go to *Monitoring → Hosts*, locate the host in the list and click on the Web hyperlink in the last column. {width="600"} Click on the scenario name to see more detailed statistics: {width="600"} ##### Крок 3 Збережіть готовий сценарій веб-моніторингу. Сценарій буде додано до хосту. Щоб переглянути інформацію про веб-сценарій, перейдіть до *Моніторинг → Хости*, знайдіть хост у списку та клацніть гіперпосилання Веб в останньому стовпчику. {width="600"} Натисніть на назву сценарію, щоб переглянути детальнішу статистику: {width="600"} ##### Step 4 Create a web scenario or HTTP agent item with Kerberos authentication type. Optionally can be tested with the following curl command: curl -v --negotiate -u : http://example.com Note that for lengthy web monitoring it is necessary to take care of renewing the Kerberos ticket. Default time of ticket expiration is 10h. ##### Крок 4 Створіть веб-сценарій або елемент HTTP-агента з типом автентифікації Kerberos. Додатково можна перевірити за допомогою такої команди curl: curl -v --negotiate -u : http://example.com Зверніть увагу, що для тривалого веб-моніторингу необхідно подбати про оновлення квитка Kerberos. За замовчуванням термін дії квитка становить 10 годин. #### Steps #### Кроки ### String history The string 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|string|Received value.| ### Історія рядків Об'єкт історії рядків має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |годинник|мітка часу|Час, коли це значення було отримано.| |itemid|рядок|ID пов'язаного елемента.| |ns|ціле|Наносекунди, коли було отримано значення.| |значення|рядок|Отримане значення.| ### Structure The API consists of a number of methods that are nominally grouped into separate APIs. Each of the methods performs one specific task. For example, the `host.create` method belongs to the *host* API and is used to create new hosts. Historically, APIs are sometimes referred to as "classes". ::: notetip Most APIs contain at least four methods: `get`, `create`, `update` and `delete` for retrieving, creating, updating and deleting data respectively, but some APIs may provide a totally different set of methods. ::: ### Структура API складається з кількох методів, номінально згрупованих у окремі API. Кожен із методів виконує одну певну задачу. Наприклад, метод `host.create` належить до API *host* і використовується для створення нових хостів. Історично так склалось, що API іноді називають "класами". ::: notetip Більшість API містять принаймні чотири методи: `get`, `create`, `update` і `delete` для отримання, створення, оновлення та видалення даних відповідно, але деякі API можуть надавати повністю різний набір методів. ::: #### Structure The content of this manual is divided into sections and subsections to provide easy access to particular subjects of interest. When you navigate to respective sections, make sure that you expand section folders to reveal full content of what is included in subsections and individual pages. Cross-linking between pages of related content is provided as much as possible to make sure that relevant information is not missed by the users. #### Структура Зміст цього посібника поділено на розділи та підрозділи для того, щоб забезпечити легкий доступ до певних тем, які вас цікавлять. Коли ви переходите до відповідних розділів, переконайтеся, що ви розгорнули папки розділів, щоб побачити повний зміст того, що міститься в підрозділах та окремих сторінках. Перехресні посилання між сторінками пов'язаного контенту надаються настільки, наскільки це можливо, для того, щоб переконатися, що відповідна інформація не буде пропущена користувачами. ## SYNOPSIS **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## СИНТАКСИС **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## SYNOPSIS **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *номер-порту*\] \[**-I** *IP-адреса*\] \[**-t** *тайм-аут*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *номер порту*\] \[**-I** *IP-адреса*\] \[**-t** *час очікування*\] **--tls-connect** **cert** **--tls-ca-файл** *CA-файл* \[**--tls-crl-файл** *CRL-файл*\] \[**--tls-agent-cert-issuer** *сертифікат-емітент*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *файл-сертифіката* **--tls-key-file** *key-file* \[**--tls-cipher13** *шифр-рядок*\] \[**--tls-cipher** *шифр-рядок*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *port-number*\] \[**-I** *IP-адреса*\] \[**-t** *час очікування*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-ідентифікація* **--tls-psk-файл** *PSK-файл* \[**--tls-cipher13** *шифр-рядок*\] \[**--tls-cipher** *шифр-рядок*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_proxy** \[**-c** *config-file*\]\ **zabbix\_proxy** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_proxy** \[**-c** *конфігураційний файл*\]\ **zabbix\_proxy** \[**-c** *конфігураційний файл*\] **-R** *параметр виконання*\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender -h**\ **zabbix\_sender -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender -h**\ **zabbix\_sender -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} ##### System requirements: - *RAM*: 1.5 GB - *Disk space*: at least 8 GB should be allocated for the virtual machine - *CPU*: 2 cores minimum Zabbix installation CD/DVD boot menu: {width="600"} Zabbix appliance contains a Zabbix server (configured and running on MySQL) and a frontend. Zabbix virtual appliance is available in the following formats: - VMware (.vmx) - Open virtualization format (.ovf) - Microsoft Hyper-V 2012 (.vhdx) - Microsoft Hyper-V 2008 (.vhd) - KVM, Parallels, QEMU, USB stick, VirtualBox, Xen (.raw) - KVM, QEMU (.qcow2) To get started, boot the appliance and point a browser at the IP the appliance has received over DHCP. ::: noteimportant DHCP must be enabled on the host. ::: To get the IP address from inside the virtual machine run: ip addr show To access Zabbix frontend, go to **http://<host\_ip>** (for access from the host's browser bridged mode should be enabled in the VM network settings). ::: notetip If the appliance fails to start up in Hyper-V, you may want to press `Ctrl+Alt+F2` to switch tty sessions. ::: ##### Системні вимоги: - *ОЗП*: 1,5 ГБ - *Дисковий простір*: принаймні 8 ГБ має бути виділено для віртуальної машини - *ЦП*: мінімум 2 ядра Меню завантаження CD/DVD інсталяційного Zabbix: {width="600"} Готове рішення Zabbix містить сервер Zabbix (налаштований і працює на MySQL) і frontend. Віртуальне готове рішення Zabbix доступне у таких форматах: - VMware (.vmx) - Open virtualization format (.ovf) - Microsoft Hyper-V 2012 (.vhdx) - Microsoft Hyper-V 2008 (.vhd) - KVM, Parallels, QEMU, USB-накопичувач, VirtualBox, Xen (.raw) - KVM, QEMU (.qcow2) Щоб розпочати роботу, завантажте пристрій і вкажіть у браузері IP-адресу, яку готове рішення отримало через DHCP. ::: noteimportant DHCP має бути ввімкнено на хості. ::: Щоб отримати IP-адресу з віртуальної машини, виконайте: ip addr show Щоб отримати доступ до інтерфейсу Zabbix, перейдіть за адресою **http://<host\_ip>** (для доступу з браузера хоста в мережевих налаштуваннях віртуальної машини має бути включений мостовий режим). ::: notetip Якщо готове рішення не запускається в Hyper-V, ви можете натиснути `Ctrl+Alt+F2`, щоб перемкнути сеанси tty. ::: #### template [ZBXNEXT-1111](https://support.zabbix.com/browse/ZBXNEXT-1111) Added new properties `vendor_name`, `vendor_version`.\ #### template [ZBXNEXT-1111](https://support.zabbix.com/browse/ZBXNEXT-1111) Додано нові властивості `vendor_name`, `vendor_version`.\ ### Text history The text 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.| |ns|integer|Nanoseconds when the value was received.| |value|text|Received value.| ### Історія тексту Об'єкт історії тексту має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |id|рядок|ID запису історії.| |годинник|мітка часу|Час, коли це значення було отримано.| |itemid|рядок|ID пов'язаного елемента.| |ns|ціле|Наносекунди, коли було отримано значення.| |значення|текст|Отримане значення.| The ***\_doActivate()*** method makes the widget active and interactive by enabling custom event listeners (for responding to user actions) and initiating the widget update cycle (for keeping its content up-to-date). This method is invoked when the dashboard page is activated, that is, when it becomes fully displayed in the user interface. Note that before the *\_doActivate()* method is invoked, the widget is in the inactive state (`WIDGET_STATE_INACTIVE`). After successful invocation, the widget transitions to the active state (`WIDGET_STATE_ACTIVE`). In the active state, the widget is responsive, listens to events, updates its content periodically, and can interact with other widgets. Example: ```js _doActivate() { super._doActivate(); if (this._has_contents) { this._activateContentsEvents(); } } ``` Метод ***\_doActivate()*** робить віджет активним та інтерактивним, вмикаючи користувацькі listener-и подій (для реагування на дії користувача) та ініціюючи цикл оновлення віджета (для підтримання його вмісту в актуальному стані). Цей метод викликається, коли сторінка дашборду активована, тобто коли вона стає повністю відображеною в інтерфейсі користувача. Зверніть увагу, що до виклику методу *\_doActivate()* віджет знаходиться в неактивному стані (`WIDGET_STATE_INACTIVE`). Після успішного виклику віджет переходить в активний стан (`WIDGET_STATE_ACTIVE`). В активному стані віджет реагує на події, періодично оновлює свій вміст і може взаємодіяти з іншими віджетами. приклад: ```js _doActivate() { super._doActivate(); if (this._has_contents) { this._activateContentsEvents(); } } ``` The ***\_doDeactivate()*** method stops any activity and interactivity of the widget by deactivating custom event listeners and stopping the widget update cycle. This method is invoked when the dashboard page is deactivated, that is, switched away or deleted, or when the widget is deleted from the dashboard page. Note that before the *\_doDeactivate()* method is invoked, the widget is in the active state (`WIDGET_STATE_ACTIVE`). After successful invocation, the widget transitions to the inactive state (`WIDGET_STATE_INACTIVE`). Example: ```js _doDeactivate() { super._doDeactivate(); this._deactivateContentsEvents(); } ``` Метод ***\_doDeactivate()*** зупиняє будь-яку активність та інтерактивність віджета, деактивуючи користувацькі listener-и подій та зупиняючи цикл оновлення віджета. Цей метод викликається, коли сторінка інформаційної панелі деактивована, тобто переключена або видалена, або коли віджет видалено зі сторінки інформаційної панелі. Зверніть увагу, що до виклику методу *\_doDeactivate()* віджет знаходиться в активному стані (`WIDGET_STATE_ACTIVE`), після успішного виклику віджет переходить в неактивний стан (`WIDGET_STATE_INACTIVE`). приклад: ```js _doActivate() { super._doActivate(); if (this._has_contents) { this._activateContentsEvents(); } } ``` The ***\_doDestroy()*** method performs cleanup tasks before the widget is deleted from the dashboard, which can include closing a database connection that was established during widget initialization, cleaning up temporary data to free up system memory and avoid resource leaks, unregistering event listeners related to resize events or button clicks to prevent unnecessary event handling and memory leaks, etc. This method is invoked when the widget or the dashboard page that contains it is deleted. Note that before the *\_doDestroy()* method is invoked, a widget in an active state (`WIDGET_STATE_ACTIVE`) is always deactivated with the invocation of the *\_doDeactivate()* method. Example: ```js _doDestroy() { super._doDestroy(); if (this._filter_widget) { this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_MARK, this._events.mark); this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_SELECT, this._events.select); } } ``` Метод ***\_doDestroy()*** виконує завдання очищення перед видаленням віджета з панелі інструментів, які можуть включати закриття з'єднання з базою даних, яке було встановлено під час ініціалізації віджета, очищення тимчасових даних, щоб звільнити системну пам'ять і уникнути витоку ресурсів, скасування реєстрації listener-ів подій, пов'язаних зі зміною розміру або натисканням кнопок, щоб запобігти непотрібній обробці подій і витоку пам'яті тощо. Цей метод викликається, коли видаляється віджет або сторінка інформаційної панелі, яка його містить. Зверніть увагу, що перед викликом методу *\_doDestroy()* віджет в активному стані (`WIDGET_STATE_ACTIVE`) завжди деактивується викликом методу *\_doDeactivate()*. приклад: ```js _doDestroy() { super._doDestroy(); if (this._filter_widget) { this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_MARK, this._events.mark); this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_SELECT, this._events.select); } } ``` # The following krb5.conf variables are only for MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` # Наступні змінні krb5.conf призначені лише для MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` The ***\_getUpdateRequestData()*** method prepares the server request data for updating the widget by gathering various properties and their corresponding values (widget identifiers, filter settings, time ranges, etc.) from the widget's state and configuration, and constructing a data object that represents the necessary information to be sent to the server in the update request. This method is invoked only as part of the default *\_promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js _getUpdateRequestData() { return { templateid: this._dashboard.templateid ?? undefined, dashboardid: this._dashboard.dashboardid ?? undefined, widgetid: this._widgetid ?? undefined, name: this._name !== '' ? this._name : undefined, fields: Object.keys(this._fields).length > 0 ? this._fields : undefined, view_mode: this._view_mode, edit_mode: this._is_edit_mode ? 1 : 0, dynamic_hostid: this._dashboard.templateid !== null || this.supportsDynamicHosts() ? (this._dynamic_hostid ?? undefined) : undefined, ...this._content_size }; } ``` Метод ***\_getUpdateRequestData()*** готує дані для запиту на оновлення віджета, збираючи різні властивості та відповідні їм значення (ідентифікатори віджета, налаштування фільтрів, часові діапазони тощо) зі стану та конфігурації віджета і створюючи об'єкт даних, який представляє необхідну інформацію, що надсилається на сервер у запиті на оновлення. Цей метод викликається лише як частина методу за замовчуванням [*\_promiseUpdate()*], тобто під час процесу оновлення віджета. Реалізація за замовчуванням: ```js _getUpdateRequestData() { return { templateid: this._dashboard.templateid ?? undefined, dashboardid: this._dashboard.dashboardid ?? undefined, widgetid: this._widgetid ?? undefined, name: this._name !== '' ? this._name : undefined, fields: Object.keys(this._fields).length > 0 ? this._fields : undefined, view_mode: this._view_mode, edit_mode: this._is_edit_mode ? 1 : 0, dynamic_hostid: this._dashboard.templateid !== null || this.supportsDynamicHosts() ? (this._dynamic_hostid ?? undefined) : undefined, ...this._content_size }; } ``` The ***\_hasPadding()*** method is responsible for applying an 8px vertical padding at the bottom of the widget when it is configured to [show its header](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters). This method is invoked when the dashboard page is activated, that is, when it becomes the displayed page in the user interface. Default implementation: ```js _hasPadding() { return this._view_mode !== ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER; } ``` For some widgets it is necessary to use all of the available widget space to configure, for example, a custom background color. The following is an example of the implementation of the *\_hasPadding()* method used in the Zabbix-native [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value) widget. ```js _hasPadding() { return false; } ``` Метод ***\_hasPadding()*** відповідає за застосування вертикального відступу 8px внизу віджета, коли він налаштований на [відображення його заголовку](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters). Цей метод викликається, коли сторінка дашборда активована, тобто коли вона стає сторінкою, що відображається в інтерфейсі користувача. Реалізація за замовчуванням: ```js _hasPadding() { return this._view_mode !== ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER; } ``` Для деяких віджетів необхідно використовувати весь доступний простір віджету, щоб налаштувати, наприклад, користувацький колір фону. Нижче наведено приклад реалізації методу *\_hasPadding()*, який використовується у віджеті [*Значення елементу даних*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value), що є нативним для Zabbix. ```js _hasPadding() { return this._view_mode !== ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER; } ``` The ***\_init()*** method defines the initial state and/or values of the widget, without performing any HTML or data manipulation. This method is invoked when a widget is created (a widget object is instantiated), typically by adding the widget to a dashboard page or loading the dashboard page. Example: ```js _init() { super._init(); this._time_offset = 0; this._interval_id = null; this._clock_type = CWidgetClock.TYPE_ANALOG; this._time_zone = null; this._show_seconds = true; this._time_format = 0; this._tzone_format = 0; this._show = []; this._has_contents = false; this._is_enabled = true; } ``` Метод ***\_init()*** визначає початковий стан та/або значення віджета, не виконуючи жодних маніпуляцій з HTML або даними. Цей метод викликається при створенні віджета (екземплярі об'єкта віджета), як правило, шляхом додавання віджета на сторінку інформаційної панелі або завантаження сторінки інформаційної панелі. приклад: ```js _init() { super._init(); this._time_offset = 0; this._interval_id = null; this._clock_type = CWidgetClock.TYPE_ANALOG; this._time_zone = null; this._show_seconds = true; this._time_format = 0; this._tzone_format = 0; this._show = []; this._has_contents = false; this._is_enabled = true; } ``` The ***\_processUpdateErrorResponse(error)*** method handles the response received from the server after the update request if the response is an error, and displays the error message/-s. This method is invoked only as part of the default *\_promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js _processUpdateErrorResponse(error) { this._setErrorContents({error}); } _setErrorContents({error}) { const message_box = makeMessageBox('bad', error.messages, error.title)[0]; this._content_body.innerHTML = ''; this._content_body.appendChild(message_box); this._removeInfoButtons(); } ``` Метод ***\_processUpdateErrorResponse(error)*** обробляє відповідь, отриману від сервера після запиту на оновлення, якщо відповідь є помилковою, і виводить повідомлення про помилку. Цей метод викликається тільки як частина стандартного методу *\_promiseUpdate()*, тобто під час процесу оновлення віджету. Реалізація за замовчуванням: ```js _processUpdateErrorResponse(error) { this._setErrorContents({error}); } _setErrorContents({error}) { const message_box = makeMessageBox('bad', error.messages, error.title)[0]; this._content_body.innerHTML = ''; this._content_body.appendChild(message_box); this._removeInfoButtons(); } ``` The ***\_processUpdateResponse(response)*** method handles the response received from the server after the update request, and, if the update process has been successful and without errors, clears widget data and displays new contents with the *\_setContents()* method. This method is invoked only as part of the default *\_promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js _processUpdateResponse(response) { this._setContents({ name: response.name, body: response.body, messages: response.messages, info: response.info, debug: response.debug }); } ``` Метод ***\_processUpdateResponse(response)*** обробляє відповідь, отриману від сервера після запиту на оновлення, і, якщо процес оновлення пройшов успішно і без помилок, очищає дані віджета і відображає новий вміст методом *\_setContents()*. Цей метод викликається тільки в складі методу за замовчуванням *\_promiseUpdate()*, тобто під час процесу оновлення віджета. Реалізація за замовчуванням: ```js _processUpdateResponse(response) { this._setContents({ name: response.name, body: response.body, messages: response.messages, info: response.info, debug: response.debug }); } ``` The ***\_promiseUpdate()*** method initiates the data update process by retrieving data, typically using web requests or API calls. This method is invoked when a dashboard page is displayed and periodically after, until the dashboard page is switched to another dashboard page. The following is an example of the default implementation of the *\_promiseUpdate()* method used by most Zabbix-native widgets. In the default implementation, the *\_promiseUpdate()* method follows a general pattern for retrieving data from the server. It creates a new `Curl` object with the appropriate URL and request parameters, sends a `POST` request using the *fetch()* method with the data object constructed by the *\_getUpdateRequestData()* method, and processes the response (or an error response) with the *\_processUpdateResponse(response)* or *\_processUpdateErrorResponse(error)* accordingly. This implementation is suitable for most widgets as they typically retrieve data in a JSON format and handle it in a consistent manner. ```js _promiseUpdate() { const curl = new Curl('zabbix.php'); curl.setArgument('action', `widget.${this._type}.view`); return fetch(curl.getUrl(), { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(this._getUpdateRequestData()), signal: this._update_abort_controller.signal }) .then((response) => response.json()) .then((response) => { if ('error' in response) { this._processUpdateErrorResponse(response.error); return; } this._processUpdateResponse(response); }); } ``` Метод ***\_promiseUpdate()*** ініціює процес оновлення даних шляхом отримання даних, як правило, за допомогою веб-запитів або викликів API. Цей метод викликається під час відображення сторінки дашборду і періодично після цього, поки сторінка дашборду не буде переключена на іншу сторінку дашборду. Нижче наведено приклад реалізації за замовчуванням методу *\_promiseUpdate()*, який використовується більшістю власних віджетів Zabbix. У стандартній реалізації метод *\_promiseUpdate()* відповідає загальному шаблону для отримання даних із сервера. Він створює новий об'єкт `Curl` з відповідним URL і параметрами запиту, відправляє запит `POST` методом *fetch()* з об'єктом даних, побудованим методом *\_getUpdateRequestData()*, і обробляє відповідь (або повідомлення про помилку) за допомогою *\_processUpdateResponse(response)* або *\_processUpdateErrorResponse(error)* відповідно. Ця реалізація підходить для більшості віджетів, оскільки вони зазвичай отримують дані у форматі JSON і обробляють їх у незмінний спосіб. ```js _promiseUpdate() { const curl = new Curl('zabbix.php'); curl.setArgument('action', `widget.${this._type}.view`); return fetch(curl.getUrl(), { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(this._getUpdateRequestData()), signal: this._update_abort_controller.signal }) .then((response) => response.json()) .then((response) => { if ('error' in response) { this._processUpdateErrorResponse(response.error); return; } this._processUpdateResponse(response); }); } ``` The ***\_registerEvents()*** method defines the HTML structure of the widget, without performing any data manipulation. This method is invoked before the first activation of the dashboard page, that is, before the dashboard and its widgets are fully displayed to the user. Example: ```js _registerEvents() { super._registerEvents(); this._events.resize = () => { const padding = 25; const header_height = this._view_mode == ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER ? 0 : this._content_header.offsetHeight; this._target.style.setProperty( '--content-height', `${this._cell_height * this._pos.height - padding * 2 - header_height}px` ); } } ``` Метод ***\_registerEvents()*** визначає HTML-структуру віджета, не виконуючи жодних маніпуляцій з даними. Цей метод викликається перед першою активацією сторінки дашборду, тобто перед тим, як дашборд та його віджети будуть повністю відображені користувачеві. приклад: ```js _registerEvents() { super._registerEvents(); this._events.resize = () => { const padding = 25; const header_height = this._view_mode == ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER ? 0 : this._content_header.offsetHeight; this._target.style.setProperty( '--content-height', `${this._cell_height * this._pos.height - padding * 2 - header_height}px` ); } } ``` The ***resize()*** method is responsible for adjusting widget's visual elements to accommodate the new widget size, which can include rearranging elements, adjusting element dimensions, text truncation, implementing lazy loading to improve responsiveness during resizing, etc. This method is invoked when the widget is resized, for example, when the user manually resizes the widget or when the browser window is resized. Example: ```js resize() { if (this._state === WIDGET_STATE_ACTIVE) { this._startUpdating(); } } ``` Метод ***resize()*** відповідає за адаптацію візуальних елементів віджета до нового розміру віджета, яка може включати перестановку елементів, регулювання розмірів елементів, усічення тексту, реалізацію лінивого завантаження для поліпшення відгуку при зміні розміру і т.д. Цей метод викликається при зміні розміру віджета, наприклад, коли користувач вручну змінює розмір віджета або коли змінюється розмір вікна браузера. Приклад: ```js resize() { if (this._state === WIDGET_STATE_ACTIVE) { this._startUpdating(); } } ``` The ***\_setContents()*** method displays widget contents if the widget update process has been successful and without errors, which can include manipulating DOM elements, updating UI components, applying styles or formatting, etc. This method is invoked only as part of the default *\_processUpdateResponse(response)* method, that is, during the process of handling the response received from the server after the update request. Default implementation: ```js _setContents({name, body, messages, info, debug}) { this._setHeaderName(name); this._content_body.innerHTML = ''; if (messages !== undefined) { const message_box = makeMessageBox('bad', messages)[0]; this._content_body.appendChild(message_box); } if (body !== undefined) { this._content_body.insertAdjacentHTML('beforeend', body); } if (debug !== undefined) { this._content_body.insertAdjacentHTML('beforeend', debug); } this._removeInfoButtons(); if (info !== undefined) { this._addInfoButtons(info); } } ``` Метод ***\_setContents()*** відображає вміст віджету, якщо процес оновлення віджету пройшов успішно і без помилок, які можуть включати маніпуляції з DOM-елементами, оновлення компонентів інтерфейсу, застосування стилів або форматування і т.д. Цей метод викликається тільки в складі стандартного методу *\_processUpdateResponse(response)*, тобто в процесі обробки відповіді, отриманої від сервера після запиту оновлення. Реалізація за замовчуванням: ```js _setContents({name, body, messages, info, debug}) { this._setHeaderName(name); this._content_body.innerHTML = ''; if (messages !== undefined) { const message_box = makeMessageBox('bad', messages)[0]; this._content_body.appendChild(message_box); } if (body !== undefined) { this._content_body.insertAdjacentHTML('beforeend', body); } if (debug !== undefined) { this._content_body.insertAdjacentHTML('beforeend', debug); } this._removeInfoButtons(); if (info !== undefined) { this._addInfoButtons(info); } } ``` The ***setEditMode()*** method defines the appearance and behavior of the widget when the dashboard transitions into editing mode. This method is invoked when the dashboard transitions into editing mode, typically when a user interacts with the widget's *Edit* button or the dashboard's *Edit dashboard* button. Example: ```js setEditMode() { if (this._has_contents) { this._deactivateContentsEvents(); this._removeTree(); } super.setEditMode(); if (this._has_contents && this._state === WIDGET_STATE_ACTIVE) { this._makeTree(); this._activateTree(); this._activateContentsEvents(); } } ``` Метод ***setEditMode()*** визначає зовнішній вигляд і поведінку віджета, коли інформаційна панель переходить у режим редагування. Цей метод викликається, коли інформаційна панель переходить у режим редагування, зазвичай, коли користувач взаємодіє з кнопкою *Редагувати* віджета або кнопкою *Редагувати інформаційну панель* на інформаційній панелі. приклад: ```js setEditMode() { if (this._has_contents) { this._deactivateContentsEvents(); this._removeTree(); } super.setEditMode(); if (this._has_contents && this._state === WIDGET_STATE_ACTIVE) { this._makeTree(); this._activateTree(); this._activateContentsEvents(); } } ``` This is a step-by-step tutorial that shows how to create a simple dashboard widget. ::: noteimportant The minimum required Zabbix version for this tutorial is 6.4.4. ::: You can download all files of this widget as a ZIP archive: [lesson_gauge_chart.zip](../../../../assets/en/devel/modules/examples/demo_widget_gauge.zip). Це покрокова інструкція, яка показує, як створити простий віджет інформаційної панелі. ::: noteimportant Мінімальна необхідна версія Zabbix для цієї інструкції – 6.4.4. ::: Ви можете завантажити всі файли цього віджета як ZIP-архів: [lesson_gauge_chart.zip](../../../../assets/en/devel/modules/examples/demo_widget_gauge.zip). This is a step-by-step tutorial that shows how to create a simple Zabbix frontend module. You can download all files of this module as a ZIP archive: [MyAddress.zip](../../../../assets/en/devel/modules/examples/MyAddress.zip). Це покрокова інструкція, яка показує, як створити простий модуль фронтенду Zabbix. Ви можете завантажити всі файли цього модуля у вигляді ZIP-архіву: [MyAddress.zip](../../../../assets/en/devel/modules/examples/MyAddress.zip). This is a step-by-step tutorial to create a simple loadable plugin for Zabbix agent 2. Це покроковий посібник зі створення простого завантажуваного плагіна для Zabbix agent 2. This page contains navigation links for dashboard widget parameters and possible property values for the respective [dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) objects. To see the parameters and property values for each widget, go to individual widget pages for: - [Action log](/manual/api/reference/dashboard/widget_fields/action_log) - [Clock](/manual/api/reference/dashboard/widget_fields/clock) - [Discovery status](/manual/api/reference/dashboard/widget_fields/discovery_status) - [Favorite graphs](/manual/api/reference/dashboard/widget_fields/favorite_graphs) - [Favorite maps](/manual/api/reference/dashboard/widget_fields/favorite_maps) - [Geomap](/manual/api/reference/dashboard/widget_fields/geomap) - [Graph](/manual/api/reference/dashboard/widget_fields/graph) - [Graph (classic)](/manual/api/reference/dashboard/widget_fields/graph_classic) - [Graph prototype](/manual/api/reference/dashboard/widget_fields/graph_prototype) - [Host availability](/manual/api/reference/dashboard/widget_fields/host_availability) - [Item value](/manual/api/reference/dashboard/widget_fields/item_value) - [Map](/manual/api/reference/dashboard/widget_fields/map) - [Map navigation tree](/manual/api/reference/dashboard/widget_fields/map_tree) - [Plain text](/manual/api/reference/dashboard/widget_fields/plain_text) - [Problem hosts](/manual/api/reference/dashboard/widget_fields/problem_hosts) - [Problems](/manual/api/reference/dashboard/widget_fields/problems) - [SLA report](/manual/api/reference/dashboard/widget_fields/sla_report) - [System information](/manual/api/reference/dashboard/widget_fields/system) - [Problems by severity](/manual/api/reference/dashboard/widget_fields/problems_severity) - [Top hosts](/manual/api/reference/dashboard/widget_fields/top_hosts) - [Trigger overview](/manual/api/reference/dashboard/widget_fields/trigger_overview) - [URL](/manual/api/reference/dashboard/widget_fields/url) - [Web monitoring](/manual/api/reference/dashboard/widget_fields/web_monitoring) Deprecated widgets: - [Data overview](/manual/api/reference/dashboard/widget_fields/data_overview) This page contains navigation links for dashboard widget parameters and possible property values for the respective [dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) objects. To see the parameters and property values for each widget, go to individual widget pages for: - [Action log](/manual/api/reference/dashboard/widget_fields/action_log) - [Clock](/manual/api/reference/dashboard/widget_fields/clock) - [Discovery status](/manual/api/reference/dashboard/widget_fields/discovery_status) - [Favorite graphs](/manual/api/reference/dashboard/widget_fields/favorite_graphs) - [Favorite maps](/manual/api/reference/dashboard/widget_fields/favorite_maps) - [Geomap](/manual/api/reference/dashboard/widget_fields/geomap) - [Graph](/manual/api/reference/dashboard/widget_fields/graph) - [Graph (classic)](/manual/api/reference/dashboard/widget_fields/graph_classic) - [Graph prototype](/manual/api/reference/dashboard/widget_fields/graph_prototype) - [Host availability](/manual/api/reference/dashboard/widget_fields/host_availability) - [Item value](/manual/api/reference/dashboard/widget_fields/item_value) - [Map](/manual/api/reference/dashboard/widget_fields/map) - [Map navigation tree](/manual/api/reference/dashboard/widget_fields/map_tree) - [Plain text](/manual/api/reference/dashboard/widget_fields/plain_text) - [Problem hosts](/manual/api/reference/dashboard/widget_fields/problem_hosts) - [Problems](/manual/api/reference/dashboard/widget_fields/problems) - [SLA report](/manual/api/reference/dashboard/widget_fields/sla_report) - [System information](/manual/api/reference/dashboard/widget_fields/system) - [Problems by severity](/manual/api/reference/dashboard/widget_fields/problems_severity) - [Top hosts](/manual/api/reference/dashboard/widget_fields/top_hosts) - [Trigger overview](/manual/api/reference/dashboard/widget_fields/trigger_overview) - [URL](/manual/api/reference/dashboard/widget_fields/url) - [Web monitoring](/manual/api/reference/dashboard/widget_fields/web_monitoring) Deprecated widgets: - [Data overview](/manual/api/reference/dashboard/widget_fields/data_overview) # This topic does not exist yet. We are sorry, the page you are looking for cannot be found. Return to the homepage, try searching, or get [help](https://www.zabbix.com/support). # Цей розділ ще не створено. Нажаль, сторінка яку ви шукаєте не знайдена. Поверніться до домашньої сторінки, або [зверніться по допомогу](https://www.zabbix.com/support). ##### Time period The **second** parameter allows to specify the time period for aggregation. The time period can only be expressed as time, the amount of values (prefixed with **\#**) is not supported. [Supported unit symbols](/manual/appendix/suffixes) can be used in this parameter for convenience, for example '5m' (five minutes) instead of '300s' (300 seconds) or '1d' (one day) instead of '86400' (86400 seconds). Time period is ignored by the server if passed with the *last\_foreach* function and can thus be omitted: last_foreach(/*/key?[group="host group"]) Time period is not supported with the *exists\_foreach* function. ##### Період часу **Другий** параметр дозволяє вказати період часу для агрегації. Період часу можна виразити лише як час, кількість значень (з префіксом **\#**) не підтримується. [Підтримувані одиниці вимірювання](/manual/appendix/suffixes) можна використовувати в цьому параметрі для зручності, наприклад, «5m» (п’ять хвилин) замість «300s» (300 секунд) або «1d» (один день) замість «86400» (86400 секунд). Період часу ігнорується сервером, якщо він передається за допомогою функції *last\_foreach*, тому його можна пропустити: last_foreach(/*/key?[group="host group"]) Період часу не підтримується функцією *exists\_foreach*. #### TimescaleDB Instructions for creating and configuring TimescaleDB are provided in a separate [section](/manual/appendix/install/timescaledb). #### TimescaleDB Інструкції щодо створення та налаштування TimescaleDB наведено в окремому [розділі](/manual/appendix/install/timescaledb). #### triggerprototype [ZBXNEXT-7972](https://support.zabbix.com/browse/ZBXNEXT-7972) Added new property `url_name`.\ #### triggerprototype [ZBXNEXT-7972](https://support.zabbix.com/browse/ZBXNEXT-7972) Додано нову властивість `url_name`.\ #### trigger [ZBXNEXT-7972](https://support.zabbix.com/browse/ZBXNEXT-7972) Added new property `url_name`.\ #### trigger [ZBXNEXT-7972](https://support.zabbix.com/browse/ZBXNEXT-7972) Додано нову властивість `url_name`.\ # Tutorials This section contains practical step-by-step tutorials to illustrate how to build a custom [module](/devel/modules/tutorials/module) and a [widget](/devel/modules/tutorials/widget) in Zabbix. # Інструкції Цей розділ містить практичні покрокові інструкції, що ілюструють, як створити власний [модуль](/devel/modules/tutorials/module) та [віджет](/devel/modules/tutorials/widget) у Zabbix. ### type Type of the module. Required for widgets and must equal "widget". *Type*: String *Default*: "module" *Example*: ```json "type": "widget" ``` ### type Тип модуля. Необхідний для віджетів і має дорівнювати "widget". *Тип*: String *За замовчуванням*: "module" *Приклад*: ```json "type": "widget" ``` ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-agent-cert-issuer** *cert-issuer* Allowed agent certificate issuer. **--tls-agent-cert-subject** *cert-subject* Allowed agent certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **unencrypted** підключатися без шифрування (за замовчуванням) ```{=html} <!-- --> ``` **psk** підключатися за допомогою TLS і заздалегідь наданого ключа ```{=html} <!-- --> ``` **cert** підключитися за допомогою TLS і сертифіката ```{=html} <!-- --> ``` **--tls-ca-файл** *CA-file* Повне ім'я файлу, що містить сертифікати центрів сертифікації верхнього рівня для для однорангової перевірки сертифікатів. **--tls-crl-file** *CRL-file* Повна назва файлу, що містить відкликані сертифікати. **--tls-agent-cert-issuer** *cert-issuer* Дозволений видавець сертифікатів агента. **--tls-agent-cert-subject** *cert-subject* Дозволений суб'єкт сертифіката агента. **--tls-cert-file** *cert-file* Повне ім'я файлу, що містить сертифікат або ланцюжок сертифікатів. **--tls-key-file** *key-file* Повний шлях до файлу, що містить закритий ключ. **--tls-psk-identity** *PSK-identity* Рядок PSK-ідентифікатора. **--tls-psk-file** *PSK-file* Повна назва файлу, що містить попередньо наданий ключ. **--tls-cipher13** *cipher-string* Рядок шифру для OpenSSL 1.1.1 або новішої версії для TLS 1.3. Замінити критерії вибору набору шифрів за замовчуванням. Ця опція недоступна, якщо Версія OpenSSL менша за 1.1.1. **--tls-cipher** *cipher-string* Рядок пріоритету GnuTLS (для TLS 1.2 і вище) або рядок шифру OpenSSL (тільки для TLS 1.2). Перевизначає критерії вибору набору шифрів за замовчуванням. **-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести інформацію про версію і вийти. [ ]{#lbAG} ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-server-cert-issuer** *cert-issuer* Allowed server certificate issuer. **--tls-server-cert-subject** *cert-subject* Allowed server certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-v**, **--verbose** Verbose mode, **-vv** for more details. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **unencrypted** підключення без шифрування (за замовчуванням) ```{=html} <!-- --> ``` **psk** підключитися за допомогою TLS і спільного ключа ```{=html} <!-- --> ``` **cert** підключитися за допомогою TLS і сертифіката ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Повний шлях до файлу, що містить сертифікати ЦС верхнього рівня для перевірки однорангових сертифікатів. **--tls-crl-file** *CRL-file* Повний шлях до файлу, що містить анульовані сертифікати. **--tls-server-cert-issuer** *cert-issuer* Дозволений емітент сертифіката сервера. **--tls-server-cert-subject** *cert-subject* Дозволена тема сертифіката сервера. **--tls-cert-file** *cert-file* Повний шлях до файлу, що містить сертифікат або ланцюжок сертифікатів. **--tls-key-file** *key-file* Повний шлях до файлу, що містить закритий ключ. **--tls-psk-identity** *PSK-identity* Рядок ідентифікатора PSK. **--tls-psk-file** *PSK-file* Повний шлях до файлу, що містить попередній спільний ключ. **--tls-cipher13** *cipher-string* Рядок шифру для OpenSSL 1.1.1 або новішої версії для TLS 1.3. Замінити критерії вибору набору шифрів за замовчуванням. Ця опція недоступна, якщо версія OpenSSL не перевищує 1.1.1. **--tls-cipher** *cipher-string* Рядок пріоритету GnuTLS (для TLS 1.2 і вище) або рядок шифру OpenSSL (лише для TLS 1.2). Замінити критерії вибору набору шифрів за замовчуванням. **-v**, **--verbose** Детальний режим, **-vv** для отримання додаткової інформації. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Виведіть інформацію про версію та вийдіть. [ ]{#lbAG} ##### Update process methods The widget update process methods are responsible for retrieving updated data from Zabbix server or any other data source and displaying it in the widget. ##### Методи процесу оновлення Методи процесу оновлення віджета відповідають за отримання оновлених даних із сервера Zabbix або будь-якого іншого джерела даних і відображення їх у віджеті. #### Updating an item Enable an item by setting its status to "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.update","params":{"itemid":"10092","status":0},"id":5}' ``` The successful response will contain the ID of the updated item: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 5 } ``` ::: notetip The `item.update` method as well as other *update methods* can also accept arrays of objects and update multiple items with one API call. ::: #### Оновлення елемента даних Увімкніть елемент, встановивши для нього статус "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.update","params":{"itemid":"10092","status":0},"id":5}' ``` Успішна відповідь міститиме ідентифікатор оновленого елемента: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 5 } ``` ::: notetip Метод item.update, а також інші *методи оновлення* також може приймати масиви об’єктів і оновлювати кілька елементів одним викликом API. ::: #### Updating multiple triggers Enable multiple triggers by setting their status to "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.update","params":[{"triggerid":"13938","status":0},{"triggerid":"13939","status":0}],"id":6}' ``` The successful response will contain the IDs of the updated triggers: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938", "13939" ] }, "id": 6 } ``` ::: notetip This is the preferred method of updating. Some API methods, such as the `host.massupdate` allow to write a simpler code. However, it is not recommended to use these methods as they will be removed in the future releases. ::: #### Оновлення кількох тригерів Увімкніть кілька тригерів, встановивши для них статус "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.update","params":[{"triggerid":"13938","status":0},{"triggerid":"13939","status":0}],"id":6}' ``` Успішна відповідь міститиме ідентифікатори оновлених тригерів: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938", "13939" ] }, "id": 6 } ``` ::: notetip Це найкращий метод оновлення. Деякі методи API, такі як `host.massupdate`, дозволяють писати простіший код. Однак не рекомендується використовувати ці методи, оскільки їх буде видалено в наступних випусках. ::: #### Updating problems The problem update popup allows to: - comment on the problem - view comments and actions so far - change problem severity - suppress/unsuppress problem - acknowledge/unacknowledge problem - change symptom problem to cause problem - manually close problem {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Problem*|If only one problem is selected, the problem name is displayed.<br>If several problems are selected, *N problems selected* is displayed.| |*Message*|Enter text to comment on the problem (maximum 2048 characters).| |*History*|Previous activities and comments on the problem are listed, along with the time and user details.<br>For the meaning of icons used to denote user actions see the [event detail](/manual/web_interface/frontend_sections/monitoring/problems#viewing_details) page.<br>Note that history is displayed if only one problem is selected for the update.| |*Scope*|Define the scope of such actions as changing severity, acknowledging or manually closing problems:<br>**Only selected problem** - will affect this event only<br>**Selected and all other problems of related triggers** - in case of acknowledgment/closing problem, will affect this event and all other problems that are not acknowledged/closed so far. If the scope contains problems already acknowledged or closed, these problems will not be acknowledged/closed repeatedly. On the other hand, the number of message and severity change operations are not limited.| |*Change severity*|Mark the checkbox and click on the severity button to update problem severity.<br>The checkbox for changing severity is available if read-write permissions exist for at least one of the selected problems. Only those problems that are read-writable will be updated when clicking on *Update*.<br>If read-write permissions exist for none of the selected triggers, the checkbox is disabled.| |*Suppress*|Mark the checkbox to suppress the problem:<br>**Indefinitely** - suppress indefinitely<br>**Until** - suppress until a given time. Both [absolute and relative](/manual/config/visualization/graphs/simple#time-period-selector) time formats are supported, for example:<br>`now+1d` - for one day from now (default)<br>`now/w` - until the end of the current week<br>`2022-05-28 12:00:00` - until absolute date/time<br>Note that a simple period (e. g., `1d`, `1w`) is not supported.<br>Availability of this option depends on the "Suppress problems" user role settings.<br>See also: [Problem suppression](/manual/acknowledgment/suppression)| |*Unsuppress*|Mark the checkbox to unsuppress the problem. This checkbox is active only if at least one of the selected problems is suppressed.<br>Availability of this option depends on the "Suppress problems" user role settings.| |*Acknowledge*|Mark the checkbox to acknowledge the problem.<br>This checkbox is available if there is at least one unacknowledged problem among the selected.<br>It is not possible to add another acknowledgment for an already acknowledged problem (it is possible to add another comment though).| |*Unacknowledge*|Mark the checkbox to unacknowledge the problem.<br>This checkbox is available if there is at least one acknowledged problem among the selected.| |*Convert to cause*|Mark the checkbox to convert the symptom problem(s) to cause problem(s).| |*Close problem*|Mark the checkbox to manually close the selected problem(s).<br>The checkbox for closing a problem is available if the *Allow manual close* option is checked in [trigger configuration](/manual/config/triggers/trigger) for at least one of the selected problems. Only those problems will be closed that are allowed to be closed when clicking on *Update*.<br>If no problem is manually closeable, the checkbox is disabled.<br>Already closed problems will not be closed repeatedly.| #### Проблеми з оновленням Спливаюче вікно оновлення проблеми дозволяє: - прокоментувати проблему - переглянути коментарі та дії - змінити ступінь серйозності проблеми - приховати/розкрити проблему - підтвердити/непідтвердити проблему - змінити симптом проблеми на її причину - закрити проблему вручну {width="600"} Усі обов’язкові поля для введення позначені червоною зірочкою. |Параметр|Опис| |--|--------| |*Проблема*|Якщо вибрано лише одну проблему, відображається назва проблеми.<br>Якщо вибрано кілька проблем, відображається *N проблем вибрано*.| |*Повідомлення*|Введіть текст для коментаря до проблеми (максимум 2048 символів).| |*Історія*|Наведено попередні дії та коментарі щодо проблеми, а також час і відомості про користувача.<br>Значення піктограм, які використовуються для позначення дій користувача, див. [деталі події](/manual/web_interface/frontend_sections/ monitoring/problems#viewing_details).<br>Зверніть увагу, що історія відображається, якщо для оновлення вибрано лише одну проблему.| |*Область*|Визначте область таких дій, як зміна серйозності, підтвердження чи закриття проблем вручну:<br>**Лише вибрана проблема** – вплине лише на цю подію<br>**Вибрані та всі інші проблеми пов’язаних тригерів ** - у разі проблеми з підтвердженням/закриттям, це вплине на цю подію та всі інші проблеми, які наразі не підтверджені/закриті. Якщо область містить уже підтверджені або вирішені проблеми, ці проблеми не будуть визнаватися/закриватися повторно. З іншого боку, кількість операцій зміни повідомлень і серйозності не обмежена.| |*Змінити серйозність*|Поставте чекбокс і натисніть кнопку серйозності, щоб оновити серйозність проблеми.<br>Чекбокс для зміни серйозності доступний, якщо є дозволи на читання та запис принаймні для однієї з вибраних проблем. Лише ті проблеми, які доступні для читання та запису, будуть оновлені після натискання *Оновити*.<br>Якщо дозволи на читання та запис не існують для жодного з вибраних тригерів, чекбокс буде вимкнено.| |*Приховувати*|Поставте чекбокс, щоб приховати проблему:<br>**На невизначений термін** - приховувати на невизначений термін<br>**До** - приховувати до певного часу. Підтримуються як [абсолютний, так і відносний](/manual/config/visualization/graphs/simple#time-period-selector) формати часу, наприклад:<br>`зараз+1д` - на один день (за замовчуванням)< br>`зараз/с` - до кінця поточного тижня<br>`2022-05-28 12:00:00` - до абсолютної дати/часу<br>Зверніть увагу, що вказання просто періоду (наприклад, `1d` , `1w`) не підтримується.<br>Доступність цього параметра залежить від налаштувань ролі користувача «Приховувати проблеми».<br>Див. також: [Припинення проблеми](/manual/acknowledgment/suppression)| |*Unsuppress*|Позначте поле, щоб скасувати приховування проблеми. Цей прапорець активний, лише якщо принаймні одна з вибраних проблем прихована.<br>Доступність цього параметра залежить від налаштувань ролі користувача «Припинити проблеми».| |*Підтвердити*|Поставте прапорець, щоб підтвердити проблему.<br>Цей прапорець доступний, якщо серед вибраних є принаймні одна непідтверджена проблема.<br>Неможливо додати ще одне підтвердження для вже підтвердженої проблеми (вона але можна додати ще один коментар).| |*Unacknowledge*|Позначте прапорець, щоб скасувати підтвердження проблеми.<br>Цей прапорець доступний, якщо серед вибраних є принаймні одна підтверджена проблема.| |*Перетворити на причину*|Позначте прапорець, щоб перетворити симптом проблеми на причину, що її викликає.| |*Закрити проблему*|Поставте прапорець, щоб вручну закрити вибрану(і) проблему(и).<br>Прапорець для закриття проблеми доступний, якщо опцію *Дозволити закриття вручну* позначено в [конфігурації тригера](/manual/config /triggers/trigger) принаймні для однієї з вибраних проблем. Буде закрито лише ті проблеми, які дозволено закрити, натиснувши *Оновити*.<br>Якщо жодну проблему не можна закрити вручну, прапорець вимкнено.<br>Уже закриті проблеми не будуть закриті повторно.| ### Upgrading HA cluster To perform a major version upgrade for the HA nodes: - stop all nodes; - create a full database backup; - if the database uses replication make sure that all nodes are in sync and have no issues. Do not upgrade if replication is broken. - select a single node that will perform database upgrade, change its configuration to standalone mode by commenting out HANodeName and [upgrade](/manual/installation/upgrade) it; - make sure that database upgrade is fully completed (*System information* should display that Zabbix server is running); - restart the node in HA mode; - upgrade and start the rest of nodes (it is not required to change them to standalone mode as the database is already upgraded at this point). In a minor version upgrade it is sufficient to upgrade the first node, make sure it has upgraded and running, and then start upgrade on the next node. ### Оновлення кластера високої доступності Щоб застосувати мажорне оновлення для вузлів кластеру високої доступності: - зупиніть всі ноди кластеру; - створіть повну резервну копію бази даних; - якщо база даних використовує реплікацію, переконайтеся, що всі вузли синхронізовані та не мають проблем. Не виконуйте оновлення, якщо реплікація порушена. - виберіть один вузол, який виконуватиме оновлення бази даних, змініть його конфігурацію на автономний режим, закоментувавши HANodeName і [оновіть](/manual/installation/upgrade) його; - переконайтеся, що оновлення бази даних повністю завершено (*Інформація про систему* має показувати, що Zabbix сервер працює); - перезапустити вузол в режимі HA; - оновіть і запустіть решту вузлів (переводити їх у автономний режим не потрібно, оскільки база даних вже оновлена на цьому етапі). При мінорному оновленні достатньо оновити перший вузол, переконатися, що він оновився і працює, а потім почати оновлення на наступному вузлі. ### url A link to the module description. *Type*: String *Example*: ```json "url": "http://example.com" ``` ### url Посилання на опис модуля. *Тип*: String *Приклад*: ```json "url": "http://example.com" ``` #### userdirectory [ZBX-22800](https://support.zabbix.com/browse/ZBX-22800) `userdirectory.get`: Restored sorting by `name`.\ #### userdirectory [ZBX-22800](https://support.zabbix.com/browse/ZBX-22800) `userdirectory.get`: Відновлено сортування за `name`.\ #### userdirectory [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Added new properties `idp_type`, `provision_status`, `user_username`, `user_lastname`, `user_ref_attr`, `group_membership`, `group_basedn`, `group_name`, `group_member`, `group_filter`, `idp_entityid`, `sp_entityid`, `sso_url`, `slo_url`, `username_attribute`, `nameid_format`, `scim_status`, `encrypt_nameid`, `encrypt_assertions`, `sign_messages`, `sign_assertions`, `sign_authn_requests`, `sign_logout_requests`, `sign_logout_responses`, `provision_media`, `provision_groups`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: Removed support for searching by `base_dn`, `bind_dn`, `host`, `search_attribute`, `search_filter`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: Removed support for filtering by `host`, `name`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: Added support for filtering by `idp_type`, `provision_status`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: Added new parameters `selectProvisionMedia`, `selectProvisionGroups`.\ #### userdirectory [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Додано нові властивості `idp_type`, `provision_status`, `user_username`, `user_lastname`, `user_ref_attr`, `group_membership`, ` group_basedn`, `group_name`, `group_member`, `group_filter`, `idp_entityid`, `sp_entityid`, `sso_url`, `slo_url`, `username_attribute`, `nameid_format`, `scim_status`, `encrypt_nameid`, `encrypt_assertions` , `sign_messages`, `sign_assertions`, `sign_authn_requests`, `sign_logout_requests`, `sign_logout_responses`, `provision_media`, `provision_groups`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: видалено підтримку пошуку за `base_dn`, `bind_dn`, `host`, `search_attribute`, ` search_filter`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: видалено підтримку фільтрації за `host`, `name`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: додано підтримку фільтрації за `idp_type`, `provision_status`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `userdirectory.get`: додано нові параметри `selectProvisionMedia`, `selectProvisionGroups`.\ #### user [ZBXNEXT-8012](https://support.zabbix.com/browse/ZBXNEXT-8012) `user.checkAuthentication`: Added new parameter `token`.\ #### user [ZBXNEXT-8012](https://support.zabbix.com/browse/ZBXNEXT-8012) `user.checkAuthentication`: Додано новий параметр `token`.\ #### user [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) Removed support for deprecated property `alias`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Property `roleid` is no longer mandatory.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Added new properties `userdirectoryid`, `ts_provisioned`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Added new method `user.provision`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `user.create`: Parameter `usrgrps` is no longer mandatory.\ [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) `user.create`, `user.update`: Removed support for deprecated parameter `user_medias`.\ [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) `user.login`: Removed support for deprecated parameter `user`.\ [ZBXNEXT-3100](https://support.zabbix.com/browse/ZBXNEXT-3100) `user.update`: Added new parameter `current_passwd`.\ #### user [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) Вилучено підтримку застарілої властивості `alias`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Властивість `roleid` більше не є обов’язковою.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Додано нові властивості `userdirectoryid`, `ts_provisioned`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) Додано новий метод `user.provision`.\ [ZBXNEXT-276](https://support.zabbix.com/browse/ZBXNEXT-276) `user.create`: Параметр `usrgrps` більше не є обов’язковим.\ [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) `user.create`, `user.update`: вилучено підтримку застарілого параметра `user_medias`.\ [ZBXNEXT-8085](https://support.zabbix.com/browse/ZBXNEXT-8085) `user.login`: видалено підтримку застарілого параметра `user`.\ [ZBXNEXT-3100](https://support.zabbix.com/browse/ZBXNEXT-3100) `user.update`: додано новий параметр `current_passwd`.\ #### Using a custom expression filter Create a trigger action that uses a custom expression - "A and (B or C)" - for evaluating action conditions. Once a trigger with a severity higher or equal to "Warning" from host "10084" or host "10106" goes into a PROBLEM state, the action will send a message to all users in user group "7" via media type "1". The formula IDs "A", "B" and "C" have been chosen arbitrarily. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "15m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Використання спеціального фільтра виразів Створіть дію тригера, яка використовує користувацький вираз - «A and (B or C)» - для оцінки умов дії. Як тільки тригер зі ступенем серйозності вище або дорівнює «Warning» з хоста «10084» або хоста «10106» перейде в стан ПРОБЛЕМА, дія надішле повідомлення всім користувачам групи користувачів «7» через тип медіа «1». Ідентифікатори формул «A», «B» і «C» обрано довільно. [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "status": 0, "esc_period": "15m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } } ], }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` ##### - Using a static IP address By default the appliance uses DHCP to obtain the IP address. To specify a static IP address: - Log in as root user; - Open */etc/sysconfig/network-scripts/ifcfg-eth0* file; - Replace *BOOTPROTO=dhcp* with *BOOTPROTO=none* - Add the following lines: - *IPADDR=<IP address of the appliance>* - *PREFIX=<CIDR prefix>* - *GATEWAY=<gateway IP address>* - *DNS1=<DNS server IP address>* - Run **systemctl restart network** command. Consult the official Red Hat [documentation](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/deployment_guide/s1-networkscripts-interfaces) if needed. ##### - Використання статичної IP-адреси За замовчуванням готове рішення використовує DHCP для отримання IP-адреси. Щоб указати статичну IP-адресу: - Увійдіть як користувач root; - Відкрийте файл */etc/sysconfig/network-scripts/ifcfg-eth0*; - Замініть *BOOTPROTO=dhcp* на *BOOTPROTO=none* - Додайте такі рядки: - *IPADDR=<IP-адреса готового рішення>* - *PREFIX=<префікс CIDR>* - *GATEWAY=<IP-адреса шлюзу>* - *DNS1=<IP-адреса сервера DNS>* - Виконайте команду **systemctl restart network**. За потреби зверніться до офіційної [документації](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/deployment_guide/s1-networkscripts-interfaces) Red Hat. ### Verify CA mode Copy required MySQL CA to the Zabbix frontend server, assign proper permissions to allow the webserver to read this file. ::: noteclassic *Verify CA* mode doesn't work on SLES 12 and RHEL 7 due to older MySQL libraries. ::: ### Перевірте режим CA Скопіюйте необхідний MySQL CA на інтерфейсний сервер Zabbix, призначте відповідні дозволи, щоб дозволити веб-серверу читати цей файл. ::: noteclassic Режим *Перевірка CA* не працює на SLES 12 і RHEL 7 через застарілі бібліотеки MySQL. ::: ### Verify Full mode ### Перевірити повний режим ### version Module version. The version will be displayed in the Administration section. *Type*: String *Example*: ```json "version": "1.0" ``` ### version Версія модуля. Версія буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "version": "1.0" ``` #### Viewing data With an item defined, you might be curious if it is actually gathering data. For that, go to *Monitoring → Latest data*, select 'New host' in the filter and click on *Apply*. {width="600"} With that said, it may take up to 60 seconds for the first data to arrive. That, by default, is how often the server reads configuration changes and picks up new items to execute. If you see no value in the 'Change' column, maybe only one value has been received so far. Wait 30 seconds for another value to arrive. If you do not see information about the item as in the screenshot, make sure that: - you have filled out the item 'Key' and 'Type of information' fields exactly as in the screenshot; - both the agent and the server are running; - host status is 'Monitored' and its availability icon is green; - the host selected in the host filter is correct; - the item is enabled. #### Перегляд даних Якщо елемент даних визначено, вам може бути цікаво, чи він справді збирає дані. Для цього перейдіть до *Моніторинг → Останні дані*, виберіть 'New host' у фільтрі та натисніть *Застосувати*. {width="600"} З огляду на це, для надходження перших даних може знадобитися до 60 секунд. За замовчуванням це те, як часто сервер читає зміни налаштувань та вибирає нові елементи даних для виконання. Якщо ви не бачите значення в стовпці 'Змінити', можливо, наразі було отримано лише одне значення. Зачекайте 30 секунд, поки не прийде інше значення. Якщо ви не бачите інформації про елемент даних, як на знімку екрану, переконайтеся, що: - ви заповнили поля елементу даних 'Ключ' і 'Тип інформації' точно так, як на знімку екрану; - і агент, і сервер запущені; - стан вузла мережі 'Відстежується', а значок доступності зелений; - вузол мережі, вибраний у фільтрі вузлів мережі, правильний; - елемент даних включено. #### View mode buttons The following buttons located in the top right corner are common for every section: | | | |--|--------| ||Display page in kiosk mode. In this mode only page content is displayed.<br>To exit kiosk mode, move the mouse cursor until the  exit button appears and click on it. You will be taken back to normal mode.| #### Кнопки режиму перегляду Наступні кнопки, розташовані у верхньому правому куті, є загальними для кожного розділу: | | | |--|--------| ||Відображати сторінку в режимі кіоску. У цьому режимі відображається лише вміст сторінки.<br>Щоб вийти з режиму кіоску, перемістіть курсор миші до  з’явиться кнопка виходу та натисніть її. Ви повернетеся до звичайного режиму.| # Views View file receives the data from a controller and then prepares the HTML look of it. :::noteclassic Defining view(s) for a frontend module is optional, unless the module is a widget.\ Dashboard widgets need at least two views: one for the edit mode and one for the view mode (should be stored in the *views* directory). ::: It is possible to use pre-defined Zabbix HTML classes (from the */zabbix/ui/include/classes/html*) in the view as well as add new HTML and CSS classes. New classes should be stored in the module's *assets* folder. Example: ```` ... (new CColHeader(_('Name'))) ```` This will add a new column name *Name* and style the top table row as on other Zabbix pages. # Views View-файл отримує дані від контролера, а потім генерує їх HTML-відображення. :::noteclassic Створювати view-файл для інтерфейсного модуля необов’язково, якщо тільки модуль не є віджетом.\ Для віджетів інформаційної панелі потрібно принаймні два типу view: один для режиму редагування та інший для режиму перегляду (має зберігатися в каталозі *views*). ::: У view-файлах можна використовувати попередньо визначені класи Zabbix HTML (з */zabbix/ui/include/classes/html*), а також додавати нові класи HTML і CSS. Нові класи повинні зберігатися в каталозі модуля *assets* . приклад: ```` ... (new CColHeader(_('Name'))) ```` Це додасть нову назву стовпця *Name* і стилізує верхній рядок таблиці, аналогічно до інших сторінок Zabbix. # > Web scenario object The following objects are directly related to the `webcheck` API. # > Об'єкт веб-сценарію Наступні об’єкти безпосередньо пов’язані з API 'webcheck'. ### What a module can be used for - Adding new functionality via custom frontend sections; - Creating custom dashboard widget types (see [widget modules](/devel/modules/widgets)); - Overriding or extending the existing functionality. ### Для чого можна використовувати модуль - Додавання нової функціональності через користувацькі розділи інтерфейсу; - Створення користувацьких типів віджетів інформаційної панелі (див. [модулі віджетів](/devel/modules/widgets)); - Заміна або розширення наявної функціональності. ### What a module cannot be used for - Registering a new API method or modifying an existing one. ### Для чого не можна використовувати модуль - Реєстрація нового методу API або зміна існуючого. ### What is a PHP frontend module? - A module is an entity with a unique ID, name, description, author, and other fields defined in it's manifest file, along with PHP, Javascript and other files located in a single directory inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). - A module should conform to simple rules to guarantee correct operation. - A module must be installed (unpacked) and enabled in the frontend by the administrator. ### Що таке PHP frontend модуль ? - Модуль - це сутність з унікальним ідентифікатором, назвою, описом, автором та іншими полями, визначеними у файлі маніфесту, разом з PHP, Javascript та іншими файлами, розташованими в одному каталозі всередині каталогу *modules* вашої інсталяції web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). - Модуль повинен відповідати простим правилам, щоб гарантувати правильну роботу. - Модуль повинен бути встановлений (розпакований) і активований у web-інтерфейсі адміністратором. ## What you'll build During this tutorial, you will first build a [basic](#part-i---hello-world) "Hello, world!" widget and then convert it into a [more advanced](#part-ii---gauge-chart) widget that displays an item value as a gauge chart. Here's how the finished widget will look like: {width="600"} ## Що ви створите У цьому посібнику ви спочатку створите [базовий](#part-i---hello-world) віджет "Hello, world!", а потім перетворите його на [більш просунутий](#part-ii---gauge-chart) віджет, який відображає значення елемента даних у вигляді гістограми.Ось як виглядатиме готовий віджет: {width="600"} ### What you'll build During this tutorial, you will first build a frontend module that adds a new *My Address* menu section and then convert it into a [more advanced](#part-iii---module-action) frontend module that makes an HTTP request to *https://api.seeip.org* and displays the response - the IP address of your computer - on a new page in the newly created *My Address* menu section. Here's how the finished module will look like: {width="600"} ### Що ви створите У цьому уроці ви спочатку створите модуль інтерфейсу, який додає новий розділ меню *Моя адреса*, а потім перетворите його на [більш просунутий] (#part-iii---module-action) модуль інтерфейсу, який робить HTTP-запит до *https://api.seeip.org* і відображає відповідь - IP-адресу вашого комп'ютера - на новій сторінці в новоствореному розділі меню *Моя адреса*. Ось як виглядатиме готовий модуль: {width="600"} ### What you'll create During this tutorial, you will add a new loadable plugin **MyIP**. The plugin will implement 1 metric called **myip**, which returns the external IP address of the host where Zabbix agent 2 is running. ### Що ви створите Під час цього уроку ви додасте новий завантажуваний плагін **MyIP**. Плагін реалізує 1 метрику під назвою **myip**, яка повертає зовнішню IP-адресу хоста, на якому запущено Zabbix Agent 2. ### Where to go next Whether you prefer to learn by doing or read the guidelines first, these pages contain the information and steps required to build your own modules: - [Step-by-step tutorials for writing your first module](/devel/modules/tutorials) - [Module file structure](/devel/modules/file_structure) - [Widget module specifics](/devel/modules/widgets) - [Module examples to reuse](/devel/modules/examples) ### Куди рухатися далі Незалежно від того, чи віддаєте ви перевагу навчанню на практиці, чи спочатку читаєте інструкції, ці сторінки містять інформацію та кроки, необхідні для створення власних модулів: - [Покрокові посібники для написання вашого першого модуля](/devel/modules/tutorials) - [Файлова структура модуля](/devel/modules/file_structure) - [Особливості модуля віджетів](/devel/modules/widgets) - [Приклади модулів для повторного використання](/devel/modules/examples) ### Widget action The widget action class (*WidgetView*) contains methods for operations with widgets in the presentation view mode. The majority of widget actions use and/or extend the default controller class *CControllerDashboardWidgetView*. The widget action class should be located in the *actions* directory and specified in the [*actions*](/devel/modules/file_structure/manifest#actions) parameter (*actions/widget.{id}.view/class*) in the *manifest.json* file. **actions/WidgetView.php example (implemented in the Zabbix-native [*System information*](/manual/web_interface/frontend_sections/dashboards/widgets/system) widget)** ```php class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getDefaultName()), 'system_info' => CSystemInfoHelper::getData(), 'info_type' => $this->fields_values['info_type'], 'user_type' => CWebUser::getType(), 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` ### Widget action Клас дій віджетів (*WidgetView*) містить методи для роботи з віджетами в режимі перегляду презентації. Більшість дій віджетів використовують та/або розширюють клас контролера за замовчуванням *CControllerDashboardWidgetView*. Клас дій віджета має розташовуватися в каталозі *actions* і вказуватися в параметрі [*actions*](/devel/modules/file_structure/manifest#actions) (*actions/widget.{id}.view/class*) у файлі *manifest.json*. **actions/WidgetView.php приклад (реалізований у стандартному для Zabbix віджеті [*Системна інформація*](/manual/web_interface/frontend_sections/dashboards/widgets/system)** ```php class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getDefaultName()), 'system_info' => CSystemInfoHelper::getData(), 'info_type' => $this->fields_values['info_type'], 'user_type' => CWebUser::getType(), 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` ### Widget examples - Minimal widget - [widget_min.zip](/../assets/en/devel/modules/examples/widget_min.zip) - "Hello, world" widget using CSS only - [hello_world_css.zip](/../assets/en/devel/modules/examples/hello_world_css.zip) - "Hello, world" widget using JavaScript only - [hello_world_js.zip](/../assets/en/devel/modules/examples/hello_world_js.zip) - "Hello, world" widget using PHP - [hello_world_php.zip](/../assets/en/devel/modules/examples/hello_world_php.zip) ::: notetip You can also use [Zabbix native widgets](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/widgets) as examples. ::: ### Приклади віджетів - Мінімальний віджет - [widget_min.zip](/../assets/en/devel/modules/examples/widget_min.zip) - Віджет "Hello, world" лише з використанням CSS - [hello_world_css.zip](/../assets/en/devel/modules/examples/hello_world_css.zip) - Віджет "Hello, world" використовує лише JavaScript - [hello_world_js.zip](/../assets/en/devel/modules/examples/hello_world_js.zip) - Віджет "Hello, world" з використанням PHP - [hello_world_php.zip](/../assets/en/devel/modules/examples/hello_world_php.zip) ::: підказка Ви також можете використовувати [власні віджети Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/widgets) як приклади. ::: ### WidgetForm The *WidgetForm* class extends the default class *CWidgetForm* and contains a set of [*CWidgetField*](#cwidgetfield) fields that are required for defining widget configuration storage structure in the database and handling input validation. The *WidgetForm* class should be located in the *includes* directory. If the class has a different name, the name should be specified in the [*widget/form_class*](/devel/modules/file_structure/manifest#widget) parameter in the *manifest.json* file. **includes/WidgetForm.php example** ```php <?php namespace Modules\MyCustomWidget\Includes; use Modules\MyCustomWidget\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox, CWidgetFieldColor }; class WidgetForm extends CWidgetForm { public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ->setFilterParameter('numeric', true) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ); } } ``` ### WidgetForm Клас *WidgetForm* розширює стандартний клас *CWidgetForm* і містить набір полів [*CWidgetField*](#cwidgetfield). які необхідні для визначення структури зберігання конфігурації віджета в базі даних і обробки валідації вхідних даних. Клас *WidgetForm* має бути розташований у каталозі *includes*. Якщо клас має іншу назву, її потрібно вказати в параметрі [*widget/form_class*](/devel/modules/file_structure/manifest#widget) у файлі *manifest.json*. **includes/WidgetForm.php приклад** ```php <?php namespace Modules\MyCustomWidget\Includes; use Modules\MyCustomWidget\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox, CWidgetFieldColor }; class WidgetForm extends CWidgetForm { public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ->setFilterParameter('numeric', true) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ); } } ``` ## Widget preview Widget modules, once added, become immediately visible in the dashboard widget list. You can open a dashboard, switch to the edit mode and add the widget to the dashboard as usual. When you make some changes to the widget, refresh the dashboard to view how the widget looks with the most recent updates. ## Попередній перегляд віджета Модулі віджетів після додавання відразу стають видимими в списку віджетів інформаційної панелі. Ви можете відкрити інформаційну панель, перейти в режим редагування та додати віджет на інформаційну панель, як зазвичай. Після внесення змін у віджет, оновіть інформаційну панель, щоб побачити, як виглядає віджет з останніми оновленнями. ### Widget Primary widget class, extends the base class of all dashboard widgets - *CWidget*. Required for overriding the default widget behavior. The *Widget* class should be located in the root directory of the widget (for example, *zabbix/ui/modules/my_custom_widget*). **Widget.php example** ```php <?php namespace Modules\MyCustomWidget; use Zabbix\Core\CWidget; class Widget extends CWidget { public const MY_CONSTANT = 0; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` ### Віджет Основний клас віджетів, розширює базовий клас усіх віджетів інформаційної панелі - *CWidget*. Необхідний для заміни поведінки віджета за замовчуванням. Клас *Widget* має бути розташований у кореневому каталозі віджета (наприклад, *zabbix/ui/modules/my_custom_widget*). **Приклад Widget.php** ```php <?php namespace Modules\MyCustomWidget; use Zabbix\Core\CWidget; class Widget extends CWidget { public const MY_CONSTANT = 0; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` # Widgets Widgets are Zabbix frontend modules used for the dashboards. Unless otherwise noted, all module guidelines are also applicable to widgets. However, a widget is notably different from a module. To build a widget: - specify the type "widget" in the [manifest.json file](/devel/modules/file_structure/manifest) ("type": "widget"); - include at least two views: one for the [widget presentation mode](/devel/modules/widgets/presentation#widget-view) and one for the [widget configuration mode](/devel/modules/widgets/configuration#widget-configuration-view) (example.widget.view.php and example.widget.edit.php); - and a [controller](/devel/modules/widgets/presentation#widget-actions) for widget presentation (WidgetView.php); - use and extend default [widget classes](/devel/modules/widgets/configuration). # Віджети Віджети — це інтерфейсні модулі Zabbix, які використовуються для інформаційних панелей. Якщо не зазначено інше, усі інструкції щодо модуля також застосовуються до віджетів. Однак віджет значно відрізняється від модуля. Щоб створити віджет: - вкажіть тип "widget" у [файлі manifest.json](/devel/modules/file_structure/manifest) ("type": "widget"); - включіть принаймні два view: один для [режиму презентації віджетів](/devel/modules/widgets/presentation#widget-view) і один для [режиму конфігурації віджетів](/devel/modules/widgets/configuration#widget- configuration-view) (example.widget.view.php і example.widget.edit.php); - і [контролер](/devel/modules/widgets/presentation#widget-actions) для представлення віджетів (WidgetView.php); - використовуйте та розширюйте стандартні [класи віджетів](/devel/modules/widgets/configuration). ### Widget view The widget view class (*CWidgetView*) is responsible for building the widget presentation view. The widget view class should be located in the *views* directory. If the file containing the widget view class has a different name than the default (*widget.view.php*), then it must be specified in the *manifest.json* file [*actions*](/devel/modules/file_structure/manifest#actions) parameter (*actions/widget.{id}.view/view*). **views/widget.view.php example** ```php <?php /** * My custom widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, $data['name']) ) ->show(); ``` ### Widget view Клас view віджетів (*CWidgetView*) відповідає за створення представлення view віджетів. Клас view віджета має бути розташований у каталозі *views*. Якщо файл, що містить клас view віджетів, має іншу назву, ніж назва за замовчуванням (*widget.view.php*), тоді її потрібно вказати у файлі *manifest.json* [*actions*](/devel/modules/file_structure /manifest#actions) параметр (*actions/widget.{id}.view/view*). **views/widget.view.php приклад** ```php <?php /** * My custom widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->additem( new CTag('h1', true, $data['name']) ) ->show(); ``` ### widget Widget configuration. Used, if *[type](#type)* is set to *widget*. *Type*: Object *Supported object keys:* - **name** (string) - used in the widget list and as default header. If empty, "name" parameter from the module will be used. - **template_support** (boolean) - determines whether the widget should be available in template dashboards. Supported values: *true*, *false* (default). - **size** (object) - default widget dimensions. Supports keys: - *width* (integer) - default widget width. - *height* (integer) - default widget height. - **form_class** (string) - class with widget fields form. Must be located in the *includes* directory. If the class is *WidgetForm.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. - **js_class** (string) - name of a JavaScript class for widget view mode to extend the default CWidget class. The class will be loaded with the dashboard. The class source file must be located in the assets/js directory. See also: [assets](#assets). - **use_time_selector** (boolean) - determines whether the widget requires dashboard time selector. Supported values: *true*, *false* (default). - **refresh_rate** (integer) - widget refresh rate in seconds (default: 60). *Example*: ```json "widget": { "name": "", "template_support": true, "size": { "width": 12, "height": 5 }, "form_class": "WidgetForm", "js_class": "CWidget", "use_time_selector": false, "refresh_rate": 60 } ``` ### widget Конфігурація віджета. Використовується, якщо *[type](#type)* має значення *widget*. *Тип*: Object *Підтримувані ключі об’єктів:* - **name** (string) - використовується у списку віджетів і як заголовок за замовчуванням. Якщо значення пусте, буде використано параметр "name" модуля. - **template_support** (boolean) - визначає, чи повинен віджет бути доступним на дашборді шаблонів. Підтримувані значення: *true*, *false* (за замовчуванням). - **size** (object) - розміри віджета за замовчуванням. Підтримує ключі: - *width* (integer) - ширина віджета за замовчуванням. - *height* (integer) - висота віджета за замовчуванням. - **form_class** (string) - клас з формою полів віджетів. Повинен знаходитися в каталозі *includes*. Якщо класом є *WidgetForm.php*, який очікується за замовчуванням, цей параметр можна опустити. Якщо ви використовуєте інше ім’я, вкажіть його тут. - **js_class** (stringdashboard) - назва класу JavaScript для режиму перегляду віджетів для розширення стандартного класу CWidget. Клас буде завантажено разом із панеллю інструментів. Вихідний файл класу має бути розташований у каталозі assets/js. Дивіться також: [assets](#assets). - **use_time_selector** (boolean) - визначає, чи потрібен віджет селектор часу на інформаційній панелі. Підтримувані значення: *true*, *false* (за замовчуванням). - **refresh_rate** (integer) - частота оновлення віджета в секундах (за замовчуванням: 60). *Приклад*: ```json "widget": { "name": "", "template_support": true, "size": { "width": 12, "height": 5 }, "form_class": "WidgetForm", "js_class": "CWidget", "use_time_selector": false, "refresh_rate": 60 } ``` ### Writing a module A sample module writing process consists of the following steps (where available, click on the file or folder name to view additional details about the step): 1. Create a new directory for the module inside **zabbix/ui/modules/**. 2. Add [manifest.json](/devel/modules/file_structure/manifest) file with module metadata. 3. Create *[views](/devel/modules/file_structure/views)* folder and define a module view(s). 4. Create *[actions](/devel/modules/file_structure/actions)* folder and define a module action(s). 5. Create Module.php (or Widget.php for dashboard widgets) file and define initialization and event handling rules. 6. Create *[assets](/devel/modules/file_structure/assets)* folder for JavaScript files (place into *assets/js*), CSS styles (place into *assets/css*), or any other additional files. 7. Make sure to specify required views, actions and asset files in the manifest.json. 8. [Register](/devel/modules/file_structure/register) the module in Zabbix frontend and start using it. :::notetip You can register and enable a module as soon as you create manifest.json file. Once the module is enabled, you can preview all changes made to module files immediately by refreshing Zabbix frontend. ::: ### Написання модуля Приклад процесу написання модуля складається з наступних кроків (там, де це можливо, клацніть на назві файлу або папки, щоб переглянути додаткову інформацію про крок): 1. Створіть новий каталог для модуля всередині **zabbix/ui/modules/**. 2. Додайте файл [manifest.json](/devel/modules/file_structure/manifest) із метаданими модуля. 3. Створіть папку *[views](/devel/modules/file_structure/views)* та визначте вид(и) модуля. 4. Створіть папку *[actions](/devel/modules/file_structure/actions)* та визначте дії модуля. 5. Створіть файл Module.php (або Widget.php для віджетів інформаційної панелі) і визначте правила ініціалізації та обробки подій. 6. Створіть папку *[assets](/devel/modules/file_structure/assets)* для файлів JavaScript (розмістіть у *assets/js*), стилів CSS (розмістіть у *assets/css*) або будь-яких інших додаткових файлів. 7. Переконайтеся, що в manifest.json вказані необхідні views, actions та assets. 8. [Зареєструйте](/devel/modules/file_structure/register) модуль у інтерфейсі Zabbix і почніть його використовувати. :::notetip Ви можете зареєструвати та ввімкнути модуль, щойно створите файл manifest.json. Після ввімкнення модуля ви можете одразу переглянути всі зміни, внесені до файлів модуля, перезавантаживши інтерфейс Zabbix. ::: # zabbix\_agent2 Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_agent2 Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_agentd Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_agentd Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # Zabbix API changes in 6.4 # Зміни Zabbix API у версії 6.4 # Zabbix documentation These pages contain official Zabbix documentation. Use the sidebar navigation to browse documentation pages. To be able to watch pages, log in with your [Zabbix forums](http://www.zabbix.com/forum/) username and password. # Документація Zabbix Ці сторінки містять офіційну документацію Zabbix. Використовуйте навігацію на бічній панелі, щоб переглядати сторінки документації. Щоб мати можливість переглядати сторінки, увійдіть, використовуючи своє ім’я користувача та пароль [на форумах Zabbix](http://www.zabbix.com/forum/). # zabbix\_get Section: User Commands (1)\ Updated: 2021-06-01\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_get Розділ: Команди користувача (1)\ Оновлено: 01.06.2021\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_js Section: User Commands (1)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_js Розділ: Команди користувача (1)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # Zabbix manpages These are Zabbix manpages for Zabbix processes. # Сторінки довідки Zabbix Це сторінки довідки Zabbix для процесів Zabbix. # Zabbix Manual Welcome to the user manual for Zabbix software. These pages are created to help users successfully manage their monitoring tasks with Zabbix, from the simple to the more complex ones. # Посібник Zabbix Ласкаво просимо до посібника користувача програмного забезпечення Zabbix. Ці сторінки створені, щоб допомогти користувачам успішно керувати своїми завданнями моніторингу за допомогою Zabbix, від простих до складніших. # zabbix\_proxy Section: Maintenance Commands (8)\ Updated: 2020-09-04\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_proxy Розділ: Команди обслуговування (8)\ Оновлено: 04.09.2020\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} ### Zabbix Security Advisories and CVE database See [Zabbix Security Advisories and CVE database](https://www.zabbix.com/security_advisories). ### Zabbix Security Advisories and CVE database See [Zabbix Security Advisories and CVE database](https://www.zabbix.com/security_advisories). # zabbix\_sender Section: User Commands (1)\ Updated: 2021-06-01\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_sender Розділ: Команди користувача (1)\ Оновлено: 01.06.2021\ [Зміст](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_server Section: Maintenance Commands (8)\ Updated: 2020-09-04\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_server Розділ: Команди обслуговування (8)\ Оновлено: 04.09.2020\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_web\_service Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_web\_service Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} ### ### # 10 Virtual machine monitoring # 10 Моніторинг віртуальних машин # 11 Time zones # 11 Часові пояси # 13 Problem acknowledgment # 13. Підтвердження проблеми # 14 Configuration export/import # 14. Експорт/імпорт конфігурації # 15 Data export # 15 Експорт даних # 17 Encryption # 17 Шифрування # 18 Web interface # 18. Веб-інтерфейс # 1 Creating an item # 1 Створення елементу данних # 1 Database creation # 1 Створення бази даних # 1 Foreach functions # 1 Функції Foreach # 1 Global notifications # 1 Глобальні сповіщення # 1 Graphs # 1 Графіки # 1 High availability # 1 Висока доступність # 1 Introduction Please use the sidebar to access content in the Introduction section. # 1. Вступ Будь ласка, використовуйте бічну панель, щоб отримати доступ до вмісту вступного розділу. # 1 Login and configuring user # 1 Вхід і налаштування користувача # 1 Manual structure # 1 Структура посібника # 1 Menu # 1 Меню # 1 Problem suppression # 1 Приховування проблеми # 1 Web monitoring items # 1 Елементи веб-моніторингу # 2 Frontend sections # 2 Інтерфейсні розділи # 2 Monitor Windows with Zabbix agent # 2 Monitor Windows with Zabbix agent # 2 New host # 2 Новий вузол мережі # 2 Passive and active agent checks # 2 Passive and active agent checks # 2 Real-life scenario # 2 Реальний сценарій # 2 Repairing Zabbix database character set and collation # 2 Відновлення набору символів і сортування бази даних Zabbix # 2 Sound in browsers # 2 Звук в браузерах # 3 New item # 3 Новий елемент даних # 3 Templates # 3 Шаблони # 3 User settings # 3 Налаштування користувача # 3 Zabbix processes Please use the sidebar to access content in the Zabbix process section. # 3. Процеси Zabbix Для доступу до вмісту розділу "Процеси Zabbix", будь ласка, використовуйте бічну панель. # 4 New trigger # 4 Новий тригер # 4 Proxy # 4 Проксі # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 Zabbix agent 2 (UNIX) # 4 Zabbix агент 2 (UNIX) # 5 Frontend maintenance mode # 5 Режим обслуговування інтерфейсу # 5 Quickstart Please use the sidebar to access content in the Quickstart section. # 5. Швидкий початок Будь ласка, використовуйте бічну панель для доступу до вмісту в розділі швидкого початку. # 5 Receiving problem notification # 5 Отримання повідомлення про проблему # 6 Action log # 6 Журнал дій # 6 New template # 6 Новий шаблон # 6 Page parameters # 6 Параметри сторінки # 6 Zabbix appliance # 6. Готове рішення Zabbix ## 7.0.1 ## 7.0.1 # 8 Creating your own theme # 8 Створення власної теми # 9 Queue # 9 Черга # 9 Zabbix web service # 9 Веб-сервіс Zabbix # action.create # action.create # action.delete # action.delete # action.get # action.get # Actions Actions are responsible for 'business logic' of the module. An action usually consists of a [controller](#controller) and an [action view](views#action-view). A module can: - Call actions that are already defined in Zabbix frontend. - Override default actions with custom actions. - Define completely new actions. To override a default action behavior with some custom behavior, define an action with the same name in the module configuration. When the action is called, the module action will be executed instead of the default Zabbix action. Action files should be stored in the *actions* folder. The actions need to be specified in the [manifest.json](manifest). # Actions Дії відповідають за «бізнес-логіку» модуля. Зазвичай дія складається з [контролера](#controller) і [перегляду дії](views#action-view). Модуль може: - Викликати дії, які вже визначені у інтерфейсі Zabbix. - Замінювати дії за замовчуванням власними діями. - Визначати абсолютно нові дії. Щоб замінити поведінку дій за замовчуванням на якусь настроювану поведінку, визначте дію з такою самою назвою в конфігурації модуля. Під час виклику дії буде виконано дію модуля замість типової дії Zabbix. Файли дій повинні зберігатися в папці *actions*. Дії потрібно вказати в [manifest.json](маніфест). ### actions Actions to register with the module. Defining *class* object key for each action is required, other action keys are optional. *Type*: Object Supported object keys if *[type](#type)* is *module*: - **write.your.action.name** (object) - action name, should be written in lowercase [a-z], separating words with dots. Supports the keys: - **class** (string; required) - action class name. - **layout** (string) - action layout. Supported values: *layout.json*, *layout.htmlpage* (default), *null*. - **view** (string) - action view. *Example*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` Supported object keys if *[type](#type)* is *widget*: - **widget.{id}.view** (object) - file and class name for widget view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.view*). Supports the keys: - **class** (string; required) - action class name for widget view mode to extend the default CControllerDashboardWidgetView class. The class source file must be located in the *actions* directory. - **view** (string) - widget view. Must be located in the *views* directory. If the view file is *widget.view.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. - **widget.{id}.edit** (object) - file name for widget configuration view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.edit*). Supports the keys: - **class** (string; required) - action class name for widget configuration view mode. The class source file must be located in the *actions* directory. - **view** (string) - widget configuration view. Must be located in the *views* directory. If the view file is *widget.edit.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. *Example*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ``` ### actions Дії для реєстрації в модулі. Необхідно визначити ключ об’єкта *class* для кожної дії, інші ключі дії необов’язкові. *Тип*: Object Підтримувані ключі об’єктів, якщо *[type](#type)* є *module*: - **write.your.action.name** (object) - назва дії, має бути написано малими літерами [a-z], розділяючи слова крапками. Підтримує ключі: - **class** (string; required) - назва класу дії. - **layout** (string) - розкладка дії. Підтримувані значення: *layout.json*, *layout.htmlpage* (за замовчуванням), *null*. - **view** (string) - представлення дії. *Приклад*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` Підтримувані ключі об’єктів, якщо *[type](#type)* є *widget*: - **widget.{id}.view** (object) - ім'я файлу та класу для представлення віджетів. Замініть **{id}** значенням [id](#id) віджета (наприклад, *widget.example_clock.view*). Підтримує ключі: - **class** (string; required) - ім'я класу дії для режиму перегляду віджетів для розширення стандартного класу CControllerDashboardWidgetView. Вихідний файл класу має бути розташований у каталозі *actions*. - **view** (string) - представлення віджета. Повинен знаходитися в каталозі *views*. Якщо файл представлення *widget.view.php*, що очікується за замовчуванням, цей параметр може бути пропущений. Якщо ви використовуєте інше ім’я, вкажіть його тут. - **widget.{id}.edit** (object) - ім'я файлу для представлення конфігурації віджета. Замініть **{id}** значенням [id](#id) віджета (наприклад, *widget.example_clock.edit*). Підтримує ключі: - **class** (string; required) - назва класу дії для режиму представлення конфігурації віджета. Вихідний файл класу має бути розташований у каталозі *actions*. - **view** (string) - представлення конфігурації віджета. Повинен знаходитися в каталозі *views*. Якщо файл представлення *widget.edit.php*, що очікується за замовчуванням, цей параметр може бути пропущений. Якщо ви використовуєте інше ім’я, вкажіть його тут. *Приклад*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ``` #### Actions and alerts Define actions and operations to notify users about certain events or automatically execute remote commands. Gain access to information about generated alerts and their receivers. [Action API](/manual/api/reference/action) | [Alert API](/manual/api/reference/alert) #### Дії та сповіщення Визначення дій та операції для сповіщення користувачів про певні події або автоматичного виконання віддалених команд. Отримання доступу до інформації про згенеровані сповіщення та їх отримувачів. [API дій](/manual/api/reference/action) | [API сповіщень](/manual/api/reference/alert) # action.update # action.update ### Action view This is a reference file for defining an action view. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ```` ### Action view Це довідковий файл для створення Action view. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ```` #### action [ZBXNEXT-6524](https://support.zabbix.com/browse/ZBXNEXT-6524) Added support of two new values in `operationtype` property (13 - Add host tags, 14 - Remove host tags) and new property `optag` for two `eventsource` action types (1 - Discovery, 2 - Autoregistration) available only in the `operations` property.\ [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `action.get`: Filter conditions will be sorted in the order of their placement in the formula.\ #### action [ZBXNEXT-6524](https://support.zabbix.com/browse/ZBXNEXT-6524) Додано підтримку двох нових значень у властивості `operationtype` (13 - Додати теги хоста, 14 - Видалити теги хоста) і нову властивість ` optag` для двох типів дій `eventsource` (1 - виявлення, 2 - автореєстрація), доступних лише у властивості `operations`.\ [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `action.get`: умови фільтра будуть відсортовані в порядку їх розміщення у формулі.\ ### Add advanced configuration settings to a configuration view In this section, you will learn how to add an expandable/collapsible *Advanced configuration* section with optional parameters, such as color, minimum and maximum values, units and the *Description* field created earlier. 1. Create a *Widget.php* file in the main widget directory *lesson_gauge_chart* to create a new class *Widget*. The *Widget* class will extend the *CWidget* base class to add/override the default widget settings (in this case - translations). JavaScript, provided below, displays the string "No data" in case of missing data. The "No data" string is present in the Zabbix UI translation files. If there are any widget constants, it is recommended to also specify them in the *Widget* class. **ui/modules/lesson_gauge_chart/Widget.php** ```php <?php namespace Modules\LessonGaugeChart; use Zabbix\Core\CWidget; class Widget extends CWidget { public const UNIT_AUTO = 0; public const UNIT_STATIC = 1; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` 2. Open *includes/WidgetForm.php* and add the new fields *Color* (color picker), *Min* (numeric field), *Max* (numeric field), and *Units* (select), and define the default color palette for the color picker, so that it can be used in the next steps. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Modules\LessonGaugeChart\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldColor, CWidgetFieldMultiSelectItem, CWidgetFieldNumericBox, CWidgetFieldSelect, CWidgetFieldTextBox }; /** * Gauge chart widget form. */ class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ) ->addField( (new CWidgetFieldNumericBox('value_min', _('Min'))) ->setDefault(0) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldNumericBox('value_max', _('Max'))) ->setDefault(100) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldSelect('value_units', _('Units'), [ Widget::UNIT_AUTO => _x('Auto', 'history source selection method'), Widget::UNIT_STATIC => _x('Static', 'history source selection method') ]))->setDefault(Widget::UNIT_AUTO) ) ->addField( (new CWidgetFieldTextBox('value_static_units')) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 3. Open *views/widget.edit.php* and add the field visual components to the configuration view. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid'])) ->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_min']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_max']) ) ->addItem([ $lefty_units->getLabel(), (new CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ])) ]) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ) ->show(); ``` ::: noteclassic The *addField()* method of the *CWidgetFormView* class takes a CSS class string as the second parameter. ::: 4. Return to the dashboard, switch to the edit mode and click on the gear icon in the widget to open the widget configuration form. The widget configuration form now contains a new expandable/collapsible section *Advanced configuration*. {width="600"} 5. Expand the *Advanced configuration* section to see additional widget configuration fields. Note that the field *Color* has no color picker yet. This is because the color picker must be initialized with JavaScript, which will be added in the next section - [*Add JavaScript to the widget*](#add-javascript-to-the-widget). {width="600"} ### Додайте розширені параметри конфігурації до перегляду конфігурації У цьому розділі ви дізнаєтеся, як додати розширюваний/згортаний розділ *Розширена конфігурація* з необов’язковими параметрами, такими як колір, мінімальні та максимальні значення, одиниці вимірювання та поле *Опис*, що створене раніше. 1. Створіть файл *Widget.php* у головному каталозі віджетів *lesson_gauge_chart*, щоб створити новий клас *Widget*. Клас *Widget* розширить базовий клас *CWidget*, щоб додати/замінити параметри віджета за замовчуванням (у цьому випадку - переклади). JavaScript, наведений нижче, відображає рядок «Немає даних» у разі відсутності даних. Рядок «Немає даних» присутній у файлах перекладу інтерфейсу Zabbix. Якщо є будь-які константи віджетів, рекомендується також вказати їх у класі *Widget*. **ui/modules/lesson_gauge_chart/Widget.php** ```php <?phpnamespace Modules\LessonGaugeChart;use Zabbix\Core\CWidget;class Widget extends CWidget {public const UNIT_AUTO = 0;public const UNIT_STATIC = 1;public function getTranslationStrings(): array {return ['class.widget.js' => ['No data' => _('No data')]];}}``` 2. Відкрийте *includes/WidgetForm.php* і додайте нові поля *Color* (вибір кольору), *Min* (числове поле), *Max* (числове поле) і *Units* (вибір), а також визначте палітру кольорів за замовчуванням для засобу вибору кольорів, щоб її можна було використовувати на наступних кроках. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php простір імен Modules\LessonGaugeChart\Includes; використовувати Modules\LessonGaugeChart\Widget; використовувати Zabbix\Widgets\{ CWidgetField, CWidgetForm }; використовувати Zabbix\Widgets\Fields\{ CWidgetFieldColor, CWidgetFieldMultiSelectItem, CWidgetFieldNumericBox, CWidgetFieldSelect, CWidgetFieldTextBox }; /** * Форма віджета вимірювальної діаграми. */ class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; публічна функція addFields(): self { повернути $це ->addField( (новий CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( (новий CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ) ->addField( (новий CWidgetFieldNumericBox('value_min', _('Min'))) ->setDefault(0) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (новий CWidgetFieldNumericBox('value_max', _('Max'))) ->setDefault(100) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (новий CWidgetFieldSelect('value_units', _('Units'), [ Віджет::UNIT_AUTO => _x('Авто', 'метод вибору джерела історії'), Віджет::UNIT_STATIC => _x('Статичний', 'метод вибору джерела історії') ]))->setDefault(Widget::UNIT_AUTO) ) ->addField( (новий CWidgetFieldTextBox('value_static_units')) ) ->addField( новий CWidgetFieldTextBox('опис', _('Опис')) ); } } ``` 3. Відкрийте *views/widget.edit.php* і додайте візуальні компоненти поля до перегляду конфігурації. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Перегляд форми віджета вимірювальної діаграми. * * @var CПереглянути $це * @var масив $data */ $lefty_units = новий CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (новий CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (новий CWidgetFormView($data)) ->addField( (новий CWidgetFieldMultiSelectItemView($data['fields']['itemid'])) ->setPopupParameter('numeric', true) ) ->addFieldset( (новий CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( новий CWidgetFieldColorView($data['fields']['chart_color']) ) ->addField( новий CWidgetFieldNumericBoxView($data['fields']['value_min']) ) ->addField( новий CWidgetFieldNumericBoxView($data['fields']['value_max']) ) ->addItem([ $lefty_units->getLabel(), (новий CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ])) ]) ->addField( новий CWidgetFieldTextBoxView($data['fields']['description']) ) ) ->показати(); ``` ::: noteclassic Метод *addField()* класу *CWidgetFormView* приймає рядок класу CSS як другий параметр. ::: 4. Поверніться на інформаційну панель, перейдіть у режим редагування та клацніть значок шестірні у віджеті, щоб відкрити форму налаштування віджета. Форма конфігурації віджета тепер містить новий розділ, який можна розширювати/згортати *Розширена конфігурація*. {width="600"} 5. Розгорніть розділ *Додаткова конфігурація*, щоб побачити додаткові поля конфігурації віджетів. Зауважте, що поле *Колір* ще не має вибору кольору. Це пояснюється тим, що засіб вибору кольорів має бути ініціалізовано за допомогою JavaScript, який буде додано в наступному розділі – [*Додати JavaScript до віджета*](#add-javascript-to-the-widget). {width="600"} ### Add CSS styles to the widget In this section you will learn how to add custom CSS styles to make the widget look more appealing. 1. For widget styles, create a new directory *css* in the *assets* directory. 2. Create a *widget.css* file in the *assets/css* directory. To style widget elements, use the selector *div.dashboard-widget-{widget id}*. To configure CSS for the whole widget, use the selector *form.dashboard-widget-{widget id}* **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart .chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart .chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart .description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2; text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart { margin-top: 8px; } ``` 3. Open *manifest.json* and add the CSS file name (*widget.css*) to the array in the *assets/css* section. This will allow the CSS styles defined in *widget.css* to load with the dashboard page. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` 4. Refresh the dashboard page to see the finished version of the widget. {width="600"} ### Додайте CSS стилі до віджету У цьому розділі ви дізнаєтеся, як додати власні стилі CSS, щоб зробити віджет більш привабливим. 1. Для стилів віджетів створіть новий каталог *css* у каталозі *assets*. 2. Створіть файл *widget.css* у каталозі *assets/css*. Щоб стилізувати елементи віджета, використовуйте селектор *div.dashboard-widget-{widget id}*. Щоб налаштувати CSS для всього віджета, використовуйте селектор *form.dashboard-widget-{widget id}* **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart .chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart .chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart .description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2;text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart { margin-top: 8px; } ``` 3. Відкрийте *manifest.json* і додайте назву файлу CSS (*widget.css*) до масиву в розділі *assets/css*. Це дозволить стилям CSS, визначеним у *widget.css*, завантажуватись зі сторінкою інформаційної панелі. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "leson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` 4. Оновіть сторінку інформаційної панелі, щоб побачити готову версію віджета. {width="600"} ## Adding a module Open *Administration→General→Modules* page and press *Scan directory*.  Locate your module in the list and activate it. To activate a module, press on the *Disabled* hyperlink - the module's state will change to *Enabled*. Press on the module name to view additional information about the module, such as author, version, or short description (if defined in the manifest). ## Додавання модуля Відкрийте сторінку *Адміністрування→Загальні→Модулі* і натисніть *Сканувати дерикторію*.  Знайдіть свій модуль у списку та активуйте його. Щоб активувати модуль, натисніть на гіперпосилання *Дезактивовано* - стан модуля зміниться на *Активовно*. Натисніть назву модуля, щоб переглянути додаткову інформацію про модуль, наприклад автора, версію або короткий опис (якщо визначено в маніфесті). #### Adding item to template To add an item to the template, go to the item list for 'New host'. In *Data collection → 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 the item to. {width="600"} All mandatory input fields are marked with a red asterisk. - Click on *Copy*. If you now go to *Data collection* → *Templates*, 'New template' should have one new item in it. We will stop at one item only for now, but similarly you can add any other items, triggers or other entities to the template until it's a fairly complete set of entities for given purpose (monitoring OS, monitoring single application). #### Додавання елемента даних до шаблону Щоб додати елемент даних до шаблону, перейдіть до списку елементів для 'New host'. У *Збір даних → Хости* натисніть *Елементи* біля пункту 'New host'. Потім: - Поставте прапорець біля елементу даних 'CPU Load' у списку. - Натисніть *Копіювати* під списком. - Виберіть шаблон, до якого потрібно скопіювати елемент. {width="600"} Усі обов’язкові поля для введення позначені червоною зірочкою. - Натисніть *Копіювати*. Якщо ви зараз перейдете до *Збір даних* → *Шаблони*, у 'New template' має бути один новий елемент даних. Наразі ми зупинимося лише на одному елементі даних, але так само ви можете додати будь-які інші елементи даних, тригери чи інші сутності до шаблону, доки це не буде досить повний набір сутностей для певної мети (моніторинг ОС, моніторинг окремої програми). ## Administration With the Zabbix API you can change administration settings of your monitoring system. ## Адміністрація За допомогою Zabbix API ви можете змінювати налаштування адміністрування вашої системи моніторингу. ##### 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. Зверніть увагу, що для активних перевірок, вузли одного кластеру повинні бути відокремлені від інших Zabbix серверів комою, а самі вузли повинні бути розділені **крапкою з комою**, наприклад: ``` ServerActive=zabbix-node-01;zabbix-node-02 ``` # alert.get # alert.get ## Alerts The Zabbix API allows you to manage the actions and alerts of your monitoring system. ## Сповіщення Zabbix API дозволяє вам керувати діями та сповіщеннями вашої системи моніторингу. #### alert [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `alert.get`: Added strict validation of the method parameters.\ #### alert [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `alert.get`: додано сувору перевірку параметрів методу.\ ### API information Retrieve the version of the Zabbix API so that your application could use version-specific features. [API info API](/manual/api/reference/apiinfo) ### Інформація про API Отримайте версію Zabbix API, щоб ваша програма могла використовувати особливості версії. [API інформації про API](/manual/api/reference/apiinfo) # apiinfo.version # apiinfo.version #### API Tokens Manage authorization tokens. [Token API](/manual/api/reference/token) #### API Токени Керуйте токенами авторизації. [API токенів](/manual/api/reference/token) ### API versions To simplify API versioning, since Zabbix 2.0.4, the version of the API matches the version of Zabbix itself. You can use the [apiinfo.version](/manual/api/reference/apiinfo/version) method to find out the version of the API you are working with. This can be useful for adjusting your application to use version-specific features. Zabbix guarantees feature backward compatibility inside a major version. When making backward incompatible changes between major releases, Zabbix usually leaves the old features as deprecated in the next release, and only removes them in the release after that. Occasionally, Zabbix may remove features between major releases without providing any backward compatibility. It is important that you never rely on any deprecated features and migrate to newer alternatives as soon as possible. ::: notetip You can follow all the changes made to the API in the [API changelog](/manual/api/changes). ::: ### версії API Для спрощення керування версіями API, починаючи з Zabbix 2.0.4, версія API відповідає версії самого Zabbix. Ви можете використовувати [apiinfo.version](/manual/api/reference/apiinfo/version) метод пошуку версії API, з якою ви працюєте. Це може бути корисно для налаштування вашого додатка на використання специфічних для певної версії функцій. Zabbix гарантує зворотну сумісність функцій всередині мажорної версії. При внесенні зворотно несумісних змін між мажорними випусками, Zabbix зазвичай залишає старі функції застарілими(deprecated) в наступному випуску, і видаляє їх лише у подальших випусках. Іноді Zabbix може видаляти можливості між мажорними випусками без забезпечення зворотної сумісності. Важливо, щоб ви ніколи не покладалися на застарілі функції і переходили на новіші альтернативи якомога швидше. ::: notetip Ви можете стежити за всіма змінами, внесеними до API, у [Журналі змін API](/manual/api/changes). ::: # Appendix 1. Reference commentary № Додаток 1. Опорний коментар # Appendix 2. Changes from 6.4 to 7.0 # Додаток 2. Зміни з 6.4 на 7.0 # Appendix 3. Changes in 7.0 # Додаток 3. Зміни в 7.0 ### assets/css *assets/css* is reserved and should only contain CSS style files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "css": ["mywidget.css"] } ``` ### assets/css *assets/css* зарезервований і має містити лише файли стилю CSS. Щоб використовувати його віджетом, укажіть ці файли в *[manifest.json](/devel/modules/file_structure/manifest)*. Наприклад: ```json "assets": { "css": ["mywidget.css"] } ``` ### assets CSS styles and JavaScript files to include. *Type*: Object *Supported object keys:* - **css** (array) - CSS files to include. The files must be located in the *assets/css*. - **js** (array) - JavaScript files to include. The files must be located in the *assets/js*. *Example*: ```json "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } ``` ### assets Стилі CSS і файли JavaScript для включення. *Тип*: Object *Підтримувані ключі об’єктів:* - **css** (array) - файли CSS для включення. Файли мають бути розташовані в *assets/css*. - **js** (array) - файли JavaScript для включення. Файли мають бути розташовані в *assets/js*. *Приклад*: ```json "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } ``` ### assets/js *assets/js* directory is reserved and should only contain JavaScript files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "js": ["class.widget.js"] } ``` ### assets/js Каталог *assets/js* зарезервований і має містити лише файли JavaScript. Щоб використовувати його віджетом, укажіть ці файли в *[manifest.json](/devel/modules/file_structure/manifest)*. Наприклад: ```json "assets": { "js": ["class.widget.js"] } ``` # Assets The folder *assets* may contain any files and subfolders that do not belong to other directories. You can use it for: - JavaScript styles (must be inside *[assets/js](#assetsjs)*); - CSS styles (must be inside *[assets/css](#assetscss)*); - Images; - Fonts; - Anything else you need to include. # Assets Папка *assets* може містити будь-які файли та підпапки, які не належать до інших каталогів. Ви можете використовувати її для: - Стилі JavaScript (має бути всередині *[assets/js](#assetsjs)*); - Стилі CSS (має бути в *[assets/css](#assetscss)*); - Зображення; - Шрифти; - Усе, що вам потрібно додати. # auditlog.get # auditlog.get #### Audit log Track configuration changes each user has done. [Audit log API](/manual/api/reference/auditlog) #### Журнал аудиту Відстежуйте зміни конфігурації, внесені кожним користувачем. [API журналу аудиту](/manual/api/reference/auditlog) #### auditlog [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) Added new [audit log](/manual/api/reference/auditlog/object#audit-log) entry action (12 - Push) and resource type (53 - History).\ #### auditlog [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) Додано нову дію запису [журнал аудиту](/manual/api/reference/auditlog/object#audit-log) (12 - Push ) і тип ресурсу (53 - Історія).\ #### Authentication Change authentication configuration options. [Authentication API](/manual/api/reference/authentication) #### Автентифікація Зміна параметрів конфігурації автентифікації. [API автентифікації](/manual/api/reference/authentication) # authentication.get # authentication.get #### Authentication To access any data in Zabbix, you need to either: - use an existing [API token](/manual/web_interface/frontend_sections/users/api_tokens) (created in Zabbix frontend or using the [Token API](/manual/api/reference/token)); - use an authentication token obtained with the [user.login](/manual/api/reference/user/login) method. For example, if you wanted to obtain a new authentication token by logging in as a standard *Admin* user, then a JSON request would look like this: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"user.login","params":{"username":"Admin","password":"zabbix"},"id":1}' ``` If you provided the credentials correctly, the response returned by the API should contain the user authentication token: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` #### Автентифікація Щоб отримати доступ до будь-яких даних у Zabbix, вам потрібно: - використовувати існуючий [API-токен](/manual/web_interface/frontend_sections/users/api_tokens) (створений у інтерфейсі Zabbix або за допомогою [Token API](/manual/api/reference/token)); - використовувати токен автентифікації, отриманий методом [user.login](/manual/api/reference/user/login). Наприклад, якщо ви хочете отримати новий токен автентифікації, увійшовши як стандартний користувач *Admin*, то JSON-запит буде виглядати наступним чином: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"user.login","params":{"username":"Admin","password":"zabbix"},"id":1}' ``` Якщо ви правильно вказали облікові дані, відповідь, повернута API, повинна містити токен автентифікації користувача: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` # authentication.update # authentication.update #### authentication [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) Added new properties `mfa_status` and `mfaid`.\ #### authentication [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) Додано нові властивості `mfa_status` і `mfaid`.\ #### authentication [ZBXNEXT-8880](https://support.zabbix.com/browse/ZBXNEXT-8880) Properties `http_auth_enabled`, `http_login_form`, `http_strip_domains`, `http_case_sensitive` will be available only if `$ALLOW_HTTP_AUTH` is enabled in the [frontend configuration file](/manual/installation/frontend#install) (*zabbix.conf.php*).\ #### authentication [ZBXNEXT-8880](https://support.zabbix.com/browse/ZBXNEXT-8880) Властивості `http_auth_enabled`, `http_login_form`, `http_strip_domains`, `http_case_sensitive` будуть доступні, лише якщо `$ALLOW_HTTP_AUTH` включено в [файл конфігурації інтерфейсу](/manual/installation/frontend#install) (*zabbix.conf.php*).\ ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## АВТОР Олексій Владишев <<alex@zabbix.com>> -------------------------------------------------- ---------------------- [ ]{#index} #### Authorization methods #### Методи авторизації ### author Module author. The author will be displayed in the Administration section. *Type*: String *Example*: ```json "author": "John Smith" ``` ### author Автор модуля. Автор буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "author": "Лесь Подерв'янський" ``` ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## АВТОР ТОВ Zabbix -------------------------------------------------- ---------------------- [ ]{#index} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## АВТОР ТОВ Zabbix -------------------------------------------------- ---------------------- [ ]{#index} # autoregistration.get # autoregistration.get # autoregistration.update # autoregistration.update ## Backward incompatible changes ## Зворотно несумісні зміни ##### By Zabbix cookie A *"zbx_session"* cookie is used to authorize an API request from Zabbix UI performed using JavaScript (from a module or a custom widget). ##### Файл cookie Zabbix Файл cookie *"zbx_session "* використовується для авторизації API-запиту з інтерфейсу Zabbix, що виконується за допомогою JavaScript (з модуля або кастомного віджета). ### Changes from 6.4 to 7.0 ### Зміни з 6.4 до 7.0 ### Changes in 7.0 ### Зміни в 7.0 #### - 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 extension development This page lists all changes to developing custom Zabbix extensions. # Зміни в розробці розширень На цій сторінці перераховано всі зміни в розробці спеціальних розширень Zabbix. ### config Default values for the module options. The object may contain any custom keys. If specified, these values will be written into the database during module registration. New variables added later will be written upon the first call. Afterwards, the variable values can only be changed directly in the database. *Type*: Object *Example*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ``` ### config Значення за замовчуванням для параметрів модуля. Об'єкт може містити будь-які спеціальні ключі. Якщо вказано, ці значення будуть записані в базу даних під час реєстрації модуля. Нові змінні, додані пізніше, будуть записані під час першого виклику. Після цього значення змінних можна змінити лише безпосередньо в базі даних. *Тип*: Object *Приклад*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ``` #### Configuration A problem can be suppressed through the **[problem update](/manual/acknowledgment#updating-problems)** window, where suppression is one of the problem update options along with commenting, changing severity, acknowledging, etc. A problem may also be unsuppressed through the same problem update window. #### Конфігурація Проблему можна сховати за допомогою вікна **[оновлення проблеми](/manual/acknowledgment#updating-problems)**, де приховування є одним із параметрів оновлення проблеми разом із коментування, зміна серйозності, підтвердження тощо. Проблема також може бути знову зроблена видимою в тому самому вікні оновлення проблеми. # configuration.export # configuration.export # configuration.import # configuration.import # configuration.importcompare # configuration.importcompare # Configuration This page describes classes that can be used to create a widget configuration view with custom configuration fields. The widget configuration view is the part of the widget that allows the user to configure widget parameters for [presentation](/presentation). # Конфігурація На цій сторінці описано класи, які можна використовувати для створення конфігурації view віджета з настроюваними полями конфігурації. View конфігурації віджета — це частина віджета, яка дозволяє користувачеві налаштовувати параметри віджета для [презентації](/presentation). #### connector [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Added new property `item_value_type`, which is supported if `data_type` is set to "Item values" (0).\ [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Added new property `attempt_interval`, which is supported if `max_attempts` is greater than 1.\ #### connector [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Додано нову властивість `item_value_type`, яка підтримується, якщо `data_type` має значення «Значення елементів» (0).\ [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Додано нову властивість `attempt_interval`, яка підтримується, якщо `max_attempts` більше 1.\ ### Controller Action controller workflow: 1) Check that all parameters passed in an HTTP request are valid: - Call the controller's *checkInput()* method - Use validation rules defined in CNewValidator.php - Call *validateInput()* method 2) Check user permissions. 3) Prepare the data according to passed parameters: if *checkInput()* returns true, Zabbix calls the controller's *doAction()* method. 4) Prepare the **$data** array for the view. Use *CControllerResponseData* and *setResponse()* method to store response in the **$data** array. Example: ````php /** * Validate input parameters. * * @return bool */ protected function checkInput(): bool { $ret = $this->validateInput([ 'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED]) ]); if (!$ret) { $this->setResponse(new CControllerResponseFatal()); } return $ret; } /** * Check user permissions. * * @return bool */ protected function checkPermissions() { return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN; } /** * Execute action and generate response object. */ protected function do Action(): void { $data = [ 'hosts_count' => API::Host()->get([ 'countOutput' => true, 'filter' => [ 'status' => $this->getInput('status') ] ]) ]; $this->setResponse(new CControllerResponseData($data)); } ```` ::: notetip You can view the full list of available controller classes in Zabbix [source code](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers). ::: ### Контролер Робочий процес контролера дій: 1) Перевірте, чи всі параметри, передані в HTTP-запиті, дійсні: - Викличте метод контролера *checkInput()* - Використовуйте правила перевірки, визначені в CNewValidator.php - Викличте метод *validateInput()* 2) Перевірте дозволи користувача. 3) Підготуйте дані відповідно до переданих параметрів: якщо *checkInput()* повертає true, Zabbix викликає метод контролера *doAction()*. 4) Підготуйте масив **$data** для перегляду. Використовуйте метод *CControllerResponseData* і *setResponse()* для збереження відповіді в масиві **$data**. Приклад: ````php /** * Перевірка вхідних параметрів. * * @return bool */ protected function checkInput(): bool { $ret = $this->validateInput([ 'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED]) ]); if (!$ret) { $this->setResponse(new CControllerResponseFatal()); } return $ret; } /** * Перевірка дозволів користувача. * * @return bool */ protected function checkPermissions() { return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN; } /** * Виконати дію та створити об’єкт відповіді. */ protected function $datado Action(): void { $data = [ 'hosts_count' => API::Host()->get([ 'countOutput' => true, 'filter' => [ 'status' => $this->getInput('status') ] ]) ]; $this->setResponse(new CControllerResponseData($data)); } ```` ::: підказка Ви можете переглянути повний список доступних класів контролерів у Zabbix [початковий код](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers). ::: ### 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 залишає за собою будь-які права на цю документацію, прямо не надані вище. ### 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 object The following objects are directly related to the `correlation` API. # Об'єкт кореляції Наступні об’єкти безпосередньо пов’язані з `correlation` API. # correlation.update # correlation.update #### correlation [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `correlation.get`: Filter conditions will be sorted in the order of their placement in the formula.\ #### correlation [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `correlation.get`: умови фільтра будуть відсортовані в порядку їх розміщення у формулі.\ #### Create a discovery action Create a discovery action that will link template "10001" to discovered hosts. [Request](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Створення дії виявлення Створіть дію виявлення, яка зв’яже шаблон «10001» із виявленими вузлами мережі. [Запит](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "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](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### Створити правило автореєстрації агента Створіть дію автореєстрації, яка додає хост до групи хостів «2», коли ім'я хоста містить «SRV» або метадані містять «AlmaLinux». [Запит](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` ##### Create a menu section 1. Create a *Module.php* file in the *MyAddress* directory. This file implements a new *Module* class that extends the default *CModule* class. The *Module* class will insert a new *My Address* menu section into the main menu. The *setAction()* method specifies an action to be executed upon clicking on the menu section. To start with, you can use the predefined action *userprofile.edit*, which will open the *User profile* page. In [part III](#part-iii---module-action) of this tutorial, you will learn how to create a custom action. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->add((new CMenuItem(_('My Address'))) ->setAction('userprofile.edit')); } } ``` :::noteclassic You can replace `'userprofile.edit'` with other actions, for example, `'charts.view'` (opens custom graphs), `'problems.view'` (opens *Monitoring → Problems*), or `'report.status'` (opens *System information* report). ::: 3. Refresh Zabbix frontend. There is now a new *My Address* section at the bottom of the Zabbix main menu. Click on *My Address* to open the *User profile* page. {width="600"} ##### Створення розділу меню 1. Створіть файл *Module.php* у каталозі *MyAddress*. Цей файл реалізує новий клас *Module*, який розширює стандартний клас *CModule*. Клас *Module* вставить новий розділ меню *My Address* в головне меню. Метод *setAction()* визначає дію, яка буде виконана після натискання на розділ меню. Для початку ви можете скористатися попередньо визначеною дією *userprofile.edit*, яка відкриє сторінку *Профіль користувача*. У [частині III](#part-iii---module-action) цієї інструкції ви дізнаєтесь, як створити користувацьку дію. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->add((новий CMenuItem(_('My Address'))) ->setAction('userprofile.edit')); } } ``` :::noteclassic Ви можете замінити «userprofile.edit» іншими діями, наприклад «charts.view» (відкриває користувацькі графіки), «problems.view» (відкриває *Моніторинг → Проблеми*) або `'report.status'` (відкриває звіт *Інформація про систему*). ::: 3. Оновіть інтерфейс Zabbix. Тепер у нижній частині головного меню Zabbix є новий розділ *Моя адреса*. Натисніть *Моя адреса*, щоб відкрити сторінку *Профіль користувача*. {width="600"} # Create a module (tutorial) # Створення модуля (інструкція) # Create a plugin (tutorial) # Створення плагіна (посібник) #### 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/alerts/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](/manual/api#performing-requests): ```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" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### Створення дії тригеру Створіть дію, яка виконуватиметься, коли тригер із хосту "10084", який містить слово "пам'ять" у своєму імені, переходить у стан проблеми. Дія матиме 4 налаштовані операції. Дія повинна спочатку надіслати повідомлення всім користувачам у групі користувачів «7» за допомогою способу сповіщення "1". Якщо подію не буде вирішено протягом 30 хвилин, буде запущено другу операцію [script](/manual/web_interface/frontend_sections/alerts/scripts#configuring-a-global-script) «5» (скрипт із областю дії "Операція дії") на всіх хостах у групі «2». Якщо подію буде вирішено, операція відновлення повідомить усіх користувачів, які отримали повідомлення про проблему. Якщо подію буде оновлено, операція підтвердження/оновлення повідомить (зі спеціальною темою та повідомленням) усіх користувачів, які отримали повідомлення про проблему. [Request](/manual/api#performing-requests): ```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" } } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` # Create a widget (tutorial) # Створення віджета (інструкція) #### Creating a new item Now, create a new [item](/manual/api/reference/item/object) on the host "Zabbix server" using the data you have obtained from the previous `host.get` request. This can be done using the [item.create](/manual/api/reference/item/create) method: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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},"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. ::: #### Створення нового елемента Тепер створіть новий [item](/manual/api/reference/item/object) на хості "Zabbix server", використовуючи дані, які ви отримали з попереднього `host.get`-запиту. Це можна зробити за допомогою методу [item.create](/manual/api/reference/item/create): ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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},"id":3}' ``` Успішна відповідь міститиме ідентифікатор щойно створеного елемента, який можна використовувати для посилання на елемент у таких запитах: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 3 } ``` ::: notetip Метод `item.create`, як і інші методи *create*, також може приймати масиви об'єктів і створювати декілька елементів одним викликом API. ::: #### Creating multiple triggers Thus, if *create methods* accept arrays, you can add multiple [triggers](/manual/api/reference/trigger/object), for example, this one: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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",}],"id":4}' ``` The 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), наприклад, цей: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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",}],"id":4}' ``` Успішна відповідь міститиме ідентифікатори новостворених тригерів: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 4 } ``` ##### CSS styles CSS files may contain a custom attribute `theme` to define different style for a specific frontend themes. Available themes and their attribute values: - **Blue** - [theme='blue-theme'] - **Dark** - [theme='dark-theme'] - **High-contrast light** - [theme='hc-light'] - **High-contrast dark** - [theme='hc-dark'] Example: ```css .widget { background-color: red; } [theme='dark-theme'] .widget { background-color: green; } ``` ##### Стилі CSS Файли CSS можуть містити користувацький атрибут `theme` для визначення іншого стилю для певних тем інтерфейсу. Доступні теми та значення їхніх атрибутів: - **Блакитна** - [theme='blue-theme'] - **Темна** - [theme='dark-theme'] - **Висококонтрастна світла** - [theme='hc-light'] - **Висококонтрастна темна** - [theme='hc-dark'] приклад: ```css .widget { background-color: червоний; } [theme='dark-theme'] .widget { background-color: зелений; } ``` #### Custom script limit Available custom script length depends on the database used: |Database|Limit in characters|Limit in bytes| |---|---|---| |*MySQL*|65535|65535| |*PostgreSQL*|65535|not limited| |*Oracle*|2048|4000| |*SQLite (only Zabbix proxy)*|65535|not limited| #### Обмеження спеціального сценарію Доступна довжина спеціального сценарію залежить від використовуваної бази даних: |База даних|Обмеження в символах|Обмеження в байтах| |---|---|---| |*MySQL*|65535|65535| |*PostgreSQL*|65535|не обмежено| |*Oracle*|2048|4000| |*SQLite (тільки Zabbix проксі)*|65535|не обмежено| ### CWidgetField The *CWidgetField* class is a base class from which all form field classes (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList*, etc.) are inherited. Classes extending *CWidgetField* are responsible for receiving, saving, and validating widget configuration values. The following *CWidgetField* classes are available. |CWidgetField class|Database field type|Description| |----|----|----------| |*CWidgetFieldCheckBox*|int32|Single checkbox.| |*CWidgetFieldCheckBoxList*|array of int32|Multiple checkboxes under a single configuration field.| |*CWidgetFieldColor*|string|Color selection field.| |*CWidgetFieldDatePicker*|string|Date selection field.| |*CWidgetFieldHostPatternSelect*|string|Multiselect field that allows to select one or multiple hosts. Supports defining host name patterns (all matching hosts will be selected).| |*CWidgetFieldIntegerBox*|int32|Field to enter an integer. Can be used to configure minimum and maximum values.| |*CWidgetFieldLatLng*|string|Text box that allows to enter comma-separated latitude, longitude, and map zoom level.| |*CWidgetFieldMultiSelectAction*|ID|Multiselect field for selecting actions (from the list of actions defined in the *Alerts → Actions*).| |*CWidgetFieldMultiSelectGraph*|ID|Multiselect field for selecting custom graphs.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Multiselect field for selecting custom graph prototypes.| |*CWidgetFieldMultiSelectGroup*|ID|Multiselect field for selecting host groups.| |*CWidgetFieldMultiSelectHost*|ID|Multiselect field for selecting hosts.| |*CWidgetFieldMultiSelectItem*|ID|Multiselect field for selecting items.| |*CWidgetFieldMultiSelectItemPattern*|ID|Multiselect field for selecting item patterns.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Multiselect field for selecting item prototypes.| |*CWidgetFieldMultiSelectMap*|ID|Multiselect field for selecting maps.| |*CWidgetFieldMultiSelectMediaType*|ID|Multiselect field for selecting media types.| |*CWidgetFieldMultiSelectOverrideHost*|ID|Multiselect field for selecting a data source (dashboard or other widget) containing a host for which the widget can display data.| |*CWidgetFieldMultiSelectService*|ID|Multiselect field for selecting services.| |*CWidgetFieldMultiSelectSla*|ID|Multiselect field for selecting SLAs.| |*CWidgetFieldMultiSelectUser*|ID|Multiselect field for selecting users.| |*CWidgetFieldNumericBox*|string|Field to enter a float number.| |*CWidgetFieldRadioButtonList*|int32|Radio box group that consists of one or more radio boxes.| |*CWidgetFieldRangeControl*|int32|Slider to select an integer type value.| |*CWidgetFieldReference*|string|Creates a unique identifier for this widget on dashboard. It is used to reference this widget from other widgets.| |*CWidgetFieldSelect*|int32|Dropdown select box.| |*CWidgetFieldSeverities*|array of int32|*CWidgetFieldCheckBoxList* preset with trigger severities.| |*CWidgetFieldTags*|array of (string, int32, string)|Allows to configure one or more tag filter rows.| |*CWidgetFieldTextArea*|string|Text area for entering multi-line text.| |*CWidgetFieldTextBox*|string|Text box for entering single-line text.| |*CWidgetFieldTimePeriod*|array of string|Time period selecting field.| |*CWidgetFieldTimeZone*|string|Dropdown with timezones.| |*CWidgetFieldThresholds*|array of (string, string)|Allows configuring color and number pairs.| |*CWidgetFieldUrl*|string|Text box that allows to enter URLs.| The following *CWidgetField* classes have been created for particular widgets. These classes have very specific use cases, but they can also be reused if needed. |CWidgetField class|Database field type|Description| |----|----|----------| |*CWidgetFieldColumnsList*|array of (multiple mixed)|For *Top hosts* widget. Create a table with custom columns of allowed types.| |*CWidgetFieldNavTree*|string|For *Map navigation tree* widget. Replaces widget view in edit mode with the map selection tree.| ### CWidgetField Клас *CWidgetField* є базовим класом, від якого успадковуються всі класи полів форми (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList* тощо). Класи, що розширюють *CWidgetField*, відповідають за отримання, збереження та перевірку значень конфігурації віджетів. Доступні такі класи *CWidgetField*. |Клас CWidgetField|Тип поля бази даних|Опис| |----|----|----------| |*CWidgetFieldCheckBox*|int32|Один checkbox.| |*CWidgetFieldCheckBoxList*|array of int32|Кілька checkbox-ів під одним полем конфігурації.| |*CWidgetFieldColor*|string|Поле вибору кольору.| |*CWidgetFieldDatePicker*|string|Поле вибору дати.| |*CWidgetFieldHostPatternSelect*|string|Множинне поле для вибору, яке дозволяє вибрати один або кілька хостів. Підтримує визначення шаблонів імен хостів (усі відповідні хости будуть вибрані).| |*CWidgetFieldIntegerBox*|int32|Поле для введення цілого числа. Можна використовувати для налаштування мінімальних і максимальних значень.| |*CWidgetFieldLatLng*|string|Текстове поле, яке дозволяє вводити через кому широту, довготу та рівень масштабування карти.| |*CWidgetFieldMultiSelectAction*|ID|Поле множинного вибору для вибору дій (зі списку дій, визначених у *Сповіщення → Дії*).| |*CWidgetFieldMultiSelectGraph*|ID|Множинне поле для вибору власних графіків.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Множинне поле для вибору власних прототипів графів.| |*CWidgetFieldMultiSelectGroup*|ID|Поле множинного вибору для вибору груп вузлів.| |*CWidgetFieldMultiSelectHost*|ID|Множинне поле для вибору хостів.| |*CWidgetFieldMultiSelectItem*|ID|Множинне поле для вибору елементів.| |*CWidgetFieldMultiSelectItemPattern*|ID|Множинне поле для вибору шаблонів елементів.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Множинне поле для вибору прототипів елементів.| |*CWidgetFieldMultiSelectMap*|ID|Множинне поле для вибору карт.| |*CWidgetFieldMultiSelectMediaType*|ID|Множинне поле для вибору типів медіа.| |*CWidgetFieldMultiSelectOverrideHost*|ID|Поле множинного вибору для вибору джерела даних (інформаційної панелі чи іншого віджета), що містить хост, для якого віджет може відображати дані.| |*CWidgetFieldMultiSelectService*|ID|Множинне поле для вибору служб.| |*CWidgetFieldMultiSelectSla*|ID|Множинне поле для вибору SLA.| |*CWidgetFieldMultiSelectUser*|ID|Множинне поле для вибору користувачів.| |*CWidgetFieldNumericBox*|string|Поле для введення числа з плаваючою точкою.| |*CWidgetFieldRadioButtonList*|int32|Група radio box-ів , яка складається з одного або кількох radio box-ів.| |*CWidgetFieldRangeControl*|int32|Повзунок для вибору значення цілочисельного типу.| |*CWidgetFieldReference*|string|Створює унікальний ідентифікатор для цього віджета на інформаційній панелі. Він використовується для посилання на цей віджет з інших віджетів.| |*CWidgetFieldSelect*|int32|Розкривне поле вибору.| |*CWidgetFieldSeverities*|array of int32|*CWidgetFieldCheckBoxList* попередньо налаштованих із рівнями серйозності тригера.| |*CWidgetFieldTags*|array of (string, int32, string)|Дозволяє налаштувати один або кілька рядків фільтра тегів.| |*CWidgetFieldTextArea*|string|Текстова область для введення багаторядкового тексту.| |*CWidgetFieldTextBox*|string|Текстове поле для введення однорядкового тексту.| |*CWidgetFieldTimePeriod*|array of string|Поле вибору періоду часу.| |*CWidgetFieldTimeZone*|string|Випадаюче меню з часовими поясами.| |*CWidgetFieldThresholds*|array of (string, string)|Дозволяє налаштувати пари кольорів і чисел.| |*CWidgetFieldUrl*|string|Текстове поле, яке дозволяє вводити URL-адреси.| Наступні класи *CWidgetField* були створені для окремих віджетів. Ці класи мають дуже специфічні випадки використання, але їх також можна використовувати повторно, якщо це необхідно. |Клас CWidgetField|Тип поля бази даних|Опис| |----|----|----------| |*CWidgetFieldColumnsList*|array of (multiple mixed)|Для віджета *Top hosts*. Створює таблицю з настроюваними стовпцями дозволених типів.| |*CWidgetFieldNavTree*|string|Для віджета *Навігаційне дерево карти*. Замінює вигляд віджета в режимі редагування деревом вибору карти.| ### CWidgetFormView The *CWidgetFormView* class is required for specifying the presentation logic of the fields defined in the *WidgetForm* class, determining their appearance and behavior when rendered in the configuration view. The *CWidgetFormView* class supports the following methods: - *addField()* - receives an instance of the *CWidgetFieldView* class as a parameter; each [*CWidgetField*](#cwidgetfield) class, has a respective *CWidgetFieldView* class for using in the widget configuration view. - *addFieldset()* - receives an instance of the *CWidgetFieldsGroupView* class that combines fields into a collapsible container. - *addFieldsGroup()* - receives an instance of *CWidgetFormFieldsetCollapsibleView* that visually (with a border) combines fields into a group. - *includeJsFile()* - allows to add a JavaScript file to the widget configuration view. - *addJavaScript()* - allows to add inline JavaScript that will be executed as soon as the widget configuration view is loaded. The *CWidgetFormView* class should be located in the *views* directory. **views/widget.edit.php example** ```php <?php /** * My custom widget form view. * * @var CView $this * @var array $data */ use Modules\MyCustomWidget\Includes\WidgetForm; (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_custom_widget_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ]).');') ->show(); ``` ### CWidgetFormView Клас *CWidgetFormView* потрібен для визначення логіки представлення полів, визначених у класі *WidgetForm*, визначення їх зовнішнього вигляду та поведінки під час візуалізації у вікні конфігурації. Клас *CWidgetFormView* підтримує такі методи: - *addField()* - отримує в якості параметра екземпляр класу *CWidgetFieldView*; кожен клас [*CWidgetField*](#cwidgetfield) має відповідний клас *CWidgetFieldView* для використання в view конфігурації віджета. - *addFieldset()* - отримує екземпляр класу *CWidgetFieldsGroupView*, який об’єднує поля в контейнер, що згортається. - *addFieldsGroup()* - отримує екземпляр *CWidgetFormFieldsetCollapsibleView*, який візуально ((за допомогою рамки) об’єднує поля в групу. - *includeJsFile()* - дозволяє додати файл JavaScript до view конфігурації віджета. - *addJavaScript()* - дозволяє додати вбудований JavaScript, який буде виконано, щойно буде завантажено view конфігурації віджета. Клас *CWidgetFormView* має бути розташований у каталозі *views*. **views/widget.edit.php приклад** ```php <?php /** * My custom widget form view. * * @var CView $this * @var array $data */ use Modules\MyCustomWidget\Includes\WidgetForm; (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_custom_widget_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ]).');') ->show(); ``` # dashboard.create # dashboard.create # dashboard.delete # dashboard.delete # dashboard.get # dashboard.get #### Dashboards Manage dashboards and make scheduled reports based on them. [Dashboard API](/manual/api/reference/dashboard) | [Template dashboard API](/manual/api/reference/templatedashboard) | [Report API](/manual/api/reference/report) #### Інформаційні панелі (дашборди) Керуйте інформаційними панелями та створюйте на їх основі планові звіти. [API інформаційної панелі](/manual/api/reference/dashboard) | [Шаблон інформаційної панелі API](/manual/api/reference/templatedashboard) | [Репорт API](/manual/api/reference/report) # dashboard.update # dashboard.update #### dashboard [ZBXNEXT-8316](https://support.zabbix.com/browse/ZBXNEXT-8316), [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193), [ZBX-24488](https://support.zabbix.com/browse/ZBX-24488), [ZBX-24490](https://support.zabbix.com/browse/ZBX-24490) Renamed [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type `plaintext` to [`itemhistory`](/manual/api/reference/dashboard/widget_fields/item_history), replaced its dashboard widget fields `itemids.0`, `style`, `show_as_html` with `columns.0.itemid`, `layout`, `columns.0.display`, and added new dashboard widget fields.\ [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) Replaced dashboard widget fields `columns.0.timeshift`, `columns.0.aggregate_interval` with `columns.0.time_period._reference`, `columns.0.time_period.from`, `columns.0.time_period.from` in [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#item-value) widget.\ [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299) Replaced dashboard widget field `unacknowledged` with two new fields `acknowledgement_status` and `acknowledged_by_me` in [`problems`](/manual/api/reference/dashboard/widget_fields/problems#parameters) widget.\ [ZBXNEXT-8245](https://support.zabbix.com/browse/ZBXNEXT-8245) Removed dashboard widget field `adv_conf` in [`clock`](/manual/api/reference/dashboard/widget_fields/clock#parameters) and [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters) widgets.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Changed dashboard widget field naming: complex data fields renamed from `str.str.index1.index2` to `str.index1.str.index2` (e.g. `thresholds.0.threshold.1`, `ds.0.hosts.1`); fields referencing database objects renamed from `str` to `str.index1` (e.g. `itemid.0`, `severities.0`).\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Replaced dashboard widget field `filter_widget_reference` with `sysmapid._reference`, and removed field `source_type` in [`map`](/manual/api/reference/dashboard/widget_fields/map#parameters) widget.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Replaced dashboard widget field `dynamic` with `override_hostid._reference` in [`gauge`](/manual/api/reference/dashboard/widget_fields/gauge#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters), [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters), [`plaintext`](/manual/api/reference/dashboard/widget_fields/plain_text#parameters), and [`url`](/manual/api/reference/dashboard/widget_fields/url#parameters) widgets.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Replaced dashboard widget fields `graph_time` with `time_period._reference`, `time_from` with `time_period.from`, `time_to` with `time_period.to` in [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#time-period) widget.\ [ZBXNEXT-9044](https://support.zabbix.com/browse/ZBXNEXT-9044) Changed the value range of the dashboard widget parameters `x` (from 0-23 to 0-71 ) and `y` (from 0-62 to 0-63) as well as `width` (from 1–24 to 1–72) and `height` (from 2–32 to 1–64).\ #### dashboard [ZBXNEXT-8316](https://support.zabbix.com/browse/ZBXNEXT-8316), [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193), [ZBX-24488 ](https://support.zabbix.com/browse/ZBX-24488), [ZBX-24490](https://support.zabbix.com/browse/ZBX-24490) Перейменовано [віджет інформаційної панелі](/manual/ api/reference/dashboard/object#dashboard-widget) тип `plaintext` в [`itemhistory`](/manual/api/reference/dashboard/widget_fields/item_history), замінено його поля віджета інформаційної панелі `itemids.0`, `style `, `show_as_html` на `columns.0.itemid`, `layout`, `columns.0.display`, а також додано нові поля віджетів інформаційної панелі.\ [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) Поля віджетів інформаційної панелі `columns.0.timeshift`, `columns.0.aggregate_interval` замінено на `columns.0.time_period._reference `, `columns.0.time_period.from`, `columns.0.time_period.from` у віджеті [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#item-value).\ [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299) Поле віджета інформаційної панелі «unacknowledged» замінено двома новими полями «acknowledgement_status» і «acknowledged_by_me» у віджеті [`problems`](/manual/ api/reference/dashboard/widget_fields/problems#parameters) .\ [ZBXNEXT-8245](https://support.zabbix.com/browse/ZBXNEXT-8245) Видалено поле віджета інформаційної панелі `adv_conf` у віджетах [`clock`](/manual/api/reference/dashboard/widget_fields/clock#parameters) ) і [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters) .\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Змінено найменування полів віджетів інформаційної панелі: складні поля даних перейменовано з `str.str.index1.index2` на `str.index1.str. index2` (наприклад, `thresholds.0.threshold.1`, `ds.0.hosts.1`); поля, що посилаються на об’єкти бази даних, перейменовані з `str` на `str.index1` (наприклад, `itemid.0`, `severities.0`).\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Замінено поле віджета інформаційної панелі `filter_widget_reference` на `sysmapid._reference`, а також видалено поле `source_type` в віджеті [`map`](/ manual/api/reference/dashboard/widget_fields/map#parameters) .\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Замінено поле віджета інформаційної панелі `dynamic` на `override_hostid._reference` в віджетах [`gauge`](/manual/api/reference/dashboard) /widget_fields/gauge#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters ), [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters), [`plaintext`](/manual/api/reference/dashboard/widget_fields/plain_text#parameters) і [`url `](/manual/api/reference/dashboard/widget_fields/url#parameters) .\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Замінено поля віджета інформаційної панелі `graph_time` на `time_period._reference`, `time_from` на `time_period.from`, `time_to` на `time_period.to` у віджеті [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#time-period).\ [ZBXNEXT-9044](https://support.zabbix.com/browse/ZBXNEXT-9044) Змінено діапазон значень параметрів віджета інформаційної панелі «x» (з 0-23 до 0-71) і «y» (з 0-62 до 0-63), а також "ширина" (від 1-24 до 1-72) і "висота" (від 2-32 до 1-64).\ #### dashboard [ZBXNEXT-8956](https://support.zabbix.com/browse/ZBXNEXT-8956) Added new dashboard widget fields `groupids._reference`, `hostids._reference`, `itemid._reference`, `graphid._reference`, `reference` in multiple widgets.\ [ZBXNEXT-9057](https://support.zabbix.com/browse/ZBXNEXT-9057) Added new dashboard widget field `show_software_update_check_details` in [`systeminfo`](/manual/api/reference/dashboard/widget_fields/system) widget.\ [ZBXNEXT-8686](https://support.zabbix.com/browse/ZBXNEXT-8686) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`itemnavigator`](/manual/api/reference/dashboard/widget_fields/item_navigator).\ [ZBXNEXT-8685](https://support.zabbix.com/browse/ZBXNEXT-8685) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`hostnavigator`](/manual/api/reference/dashboard/widget_fields/host_navigator).\ [ZBXNEXT-8683](https://support.zabbix.com/browse/ZBXNEXT-8683) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`honeycomb`](/manual/api/reference/dashboard/widget_fields/honeycomb).\ [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Added new dashboard widget field `legend_lines_mode` in [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) widget.\ [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) Added new dashboard widget fields `aggregate_function`, `history`, `time_period._reference`, `time_period.from`, `time_period.from` in [`item`](/manual/api/reference/dashboard/widget_fields/item_value#advanced-configuration) widget.\ [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Added new dashboard widget field `interface_type` value (5 - Zabbix Agent(active checks)) in [`hostavail`](/manual/api/reference/dashboard/widget_fields/host_availability#parameters) widget.\ [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Added new dashboard widget field `only_totals` in [`hostavail`](/manual/api/reference/dashboard/widget_fields/host_availability#parameters) widget.\ [ZBXNEXT-7687](https://support.zabbix.com/browse/ZBXNEXT-7687) Added new dashboard widget field `maintenance` in [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#parameters) widget.\ [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`toptriggers`](/manual/api/reference/dashboard/widget_fields/top_triggers).\ [ZBXNEXT-743](https://support.zabbix.com/browse/ZBXNEXT-743) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`gauge`](/manual/api/reference/dashboard/widget_fields/gauge).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331), [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145), [ZBXNEXT-8908](https://support.zabbix.com/browse/ZBXNEXT-8908), [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Added new dashboard widget field `legend_aggregation` in [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) widget.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Added new dashboard widget field `reference` in [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), and [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters) widgets.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Added new dashboard widget fields `time_period._reference`, `time_period.from`, `time_period.to` in [`actionlog`](/manual/api/reference/dashboard/widget_fields/action_log#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters), and [`toptriggers`](/manual/api/reference/dashboard/widget_fields/top_triggers#parameters) widgets.\ #### dashboard [ZBXNEXT-8956](https://support.zabbix.com/browse/ZBXNEXT-8956) Додано нові поля віджетів інформаційної панелі `groupids._reference`, `hostids._reference`, `itemid._reference`, `graphid._reference` , `reference` у кількох віджетах.\ [ZBXNEXT-9057](https://support.zabbix.com/browse/ZBXNEXT-9057) Додано нове поле віджета інформаційної панелі `show_software_update_check_details` в віджеті [`systeminfo`](/manual/api/reference/dashboard/widget_fields/system) .\ [ZBXNEXT-8686](https://support.zabbix.com/browse/ZBXNEXT-8686) Додано новий [віджет інформаційної панелі](/manual/api/reference/dashboard/object#dashboard-widget) типу [`itemnavigator`] (/manual/api/reference/dashboard/widget_fields/item_navigator).\ [ZBXNEXT-8685](https://support.zabbix.com/browse/ZBXNEXT-8685) Додано новий [віджет інформаційної панелі](/manual/api/reference/dashboard/object#dashboard-widget) типу [`hostnavigator`] (/manual/api/reference/dashboard/widget_fields/host_navigator).\ [ZBXNEXT-8683](https://support.zabbix.com/browse/ZBXNEXT-8683) Додано новий [віджет інформаційної панелі](/manual/api/reference/dashboard/object#dashboard-widget) типу [`honeycomb`] (/manual/api/reference/dashboard/widget_fields/honeycomb).\ [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Додано нове поле віджета інформаційної панелі `legend_lines_mode` в віджеті [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) .\ [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) Додано нові поля віджетів інформаційної панелі `aggregate_function`, `history`, `time_period._reference`, `time_period.from`, `time_period`. from` у віджеті [`item`](/manual/api/reference/dashboard/widget_fields/item_value#advanced-configuration).\ [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Додано нове значення «interface_type» поля віджета інформаційної панелі (5 – Zabbix Agent (активні перевірки)) у віджеті [`hostavail`](/manual /api/reference/dashboard/widget_fields/host_availability#parameters) .\ [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Додано нове поле віджета інформаційної панелі `only_totals` в віджеті [`hostavail`](/manual/api/reference/dashboard/widget_fields/host_availability#parameters) .\ [ZBXNEXT-7687](https://support.zabbix.com/browse/ZBXNEXT-7687) Додано нове поле «обслуговування» віджета інформаційної панелі в віджеті [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#parameters) .\ [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) Додано новий [віджет інформаційної панелі](/manual/api/reference/dashboard/object#dashboard-widget) типу [`toptriggers`] (/manual/api/reference/dashboard/widget_fields/top_triggers).\ [ZBXNEXT-743](https://support.zabbix.com/browse/ZBXNEXT-743) Додано новий [віджет інформаційної панелі](/manual/api/reference/dashboard/object#dashboard-widget) типу [`gauge`] (/manual/api/reference/dashboard/widget_fields/gauge).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331), [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145), [ZBXNEXT-8908 ](https://support.zabbix.com/browse/ZBXNEXT-8908), [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Додано новий [віджет інформаційної панелі](/manual /api/reference/dashboard/object#dashboard-widget) типу [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Додано нове поле віджета інформаційної панелі `legend_aggregation` у віджеті [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) .\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Додано нове поле «посилання» віджета інформаційної панелі в віджетах [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters) і [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters) .\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Додано нові поля віджетів інформаційної панелі `time_period._reference`, `time_period.from`, `time_period.to` в [`actionlog`] (/manual/api/reference/dashboard/widget_fields/action_log#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/ reference/dashboard/widget_fields/graph_prototype#parameters) і віджети [`toptriggers`](/manual/api/reference/dashboard/widget_fields/top_triggers#parameters).\ #### dashboard [ZBXNEXT-9215](https://support.zabbix.com/browse/ZBXNEXT-9215) Added new dashboard widget field `ds.0.itemids.0._reference` in [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#data-set) and [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart#data-set) widgets.\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Added new dashboard widget field `stroke` in [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart) widget.\ #### dashboard [ZBXNEXT-9215](https://support.zabbix.com/browse/ZBXNEXT-9215) Додано нове поле віджета інформаційної панелі `ds.0.itemids.0._reference` в [`svggraph`](/manual/api/ reference/dashboard/widget_fields/graph#data-set) і віджети [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart#data-set).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Додано нове поле віджета інформаційної панелі `stroke` в віджет [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart) .\ ## Data collection The Zabbix API allows you to manage the configuration of your monitoring system. ## Збір даних Zabbix API дозволяє вам керувати конфігурацією вашої системи моніторингу. # dcheck.get # dcheck.get #### dcheck [ZBXNEXT-8079](https://support.zabbix.com/browse/ZBXNEXT-8079) Added new property `allow_redirect`.\ #### dперdcheckевірка [ZBXNEXT-8079](https://support.zabbix.com/browse/ZBXNEXT-8079) Додано нову властивість `allow_redirect`.\ #### Delete multiple actions Delete two actions. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### Видалити кілька дій Видалити дві дії. [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` ### 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/users/user_roles) for more information. ::: ### Опис `integer/array action.get(object parameters)` Метод дозволяє отримати дії за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача] /manual/web_interface/frontend_sections/users/user_roles) для отримання додаткової інформації. ::: ### description Module description. *Type*: String *Example*: ```json "description": "This is a clock widget." ``` ### description Опис модуля. *Тип*: String *Приклад*: ```json "description": "Це віджет годинника." ``` ### 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/users/user_roles) for more information. ::: ### Опис `object action.create(object/array actions)` Цей метод дозволяє створювати нові дії. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/users/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/users/user_roles) for more information. ::: ### Опис `object action.delete(array actionIds) Цей спосіб дозволяє видаляти дії. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача (/manual/web_interface/frontend_sections/users/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 **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\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE} ## ОПИС **zabbix\_proxy** — це демон, який збирає дані моніторингу з пристроїв і надсилає їх на сервер Zabbix. [ ]{#lbAE} ## DESCRIPTION **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE} ## ОПИС **zabbix\_sender** — це утиліта командного рядка для надсилання даних моніторингу на сервер або проксі Zabbix. На сервері Zabbix має бути створений елемент типу **Zabbix trapper** з відповідним ключем. Зауважте, що вхідні значення прийматимуться лише від хостів, указаних у полі **Allowed hosts** для цього елемента. [ ]{#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} # dhost.get # dhost.get ### Disabling HA cluster 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 з активного основного сервера - перезапустіть основний сервер (він запуститься в автономному режимі) # discoveryrule.copy # discoveryrule.copy # discoveryrule.create # discoveryrule.create # discoveryrule.delete # discoveryrule.delete # discoveryrule.get # discoveryrule.get # discoveryrule.update # discoveryrule.update #### discoveryrule [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `discoveryrule.get`, `discoveryrule.create`, `discoveryrule.update`: The properties `headers` and `query_fields` changed from name-indexed object to array of objects with separate `name` and `value` properties.\ #### виявлення [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `discoveryrule.get`, `discoveryrule.create`, `discoveryrule.update`: властивості `headers` і `query_fields` змінено з індексованого за іменем об'єкта на масив об'єктів з окремими властивостями `name` і `value`.\ #### discoveryrule [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Added new LLD rule `type` (22 - Browser).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Added new [LLD rule preprocessing](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) type "SNMP get value" (30).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Property `timeout` is now also supported if item `type` is set to "SNMP agent" (20) and `snmp_oid` starts with "`get[`".\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Property `timeout` is now supported if item `type` is set to "Zabbix agent" (0), "Simple check" (3) and `key_` does not start with "`vmware.`" and "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "SNMP agent" (20) and `snmp_oid` starts with "`walk[`".\ [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Added support for [LLD rule preprocessing](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) type "Matches regular expression" (14).\ [ZBXNEXT-6986](https://support.zabbix.com/browse/ZBXNEXT-6986) Deprecated method `discoveryrule.copy`.\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) It is now possible to store more data for the `query_fields` property, have repeated `header` and `query_fields` entries.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) Added new properties `lifetime_type`, `enabled_lifetime` and `enabled_lifetime_type`.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) Changed default value of `lifetime` parameter from `30d` to `7d`.\ [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `discoveryrule.get`: Filter conditions will be sorted in the order of their placement in the formula.\ #### Правило виявлення [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Додано нове правило LLD `type` (22 - Браузер).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Додано новий тип [Попередня обробка правила LLD](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) типу "SNMP get value" (30).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Властивість `timeout` тепер також підтримується, якщо для елемента `type` встановлено значення "SNMP agent" (20) і `snmp_oid` запускається з "`get[`".\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Властивість `timeout` тепер підтримується, якщо для елемента `type` встановлено значення "Zabbix agent" (0), "Simple check" ( 3) і `key_` не починається з "`vmware.`" і "`icmpping`", "Zabbix agent (активний)" (7), "Зовнішня перевірка" (10), "Монітор бази даних" (11), "Агент SSH" (13), "Агент TELNET" (14), "Агент SNMP" (20) і `snmp_oid` починається з "`walk[`".\ [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Додано підтримку типу [Попередня обробка правила LLD](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) " Відповідає регулярному виразу" (14).\ [ZBXNEXT-6986](https://support.zabbix.com/browse/ZBXNEXT-6986) Задіприкейчен метод `discoveryrule.copy`.\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) Тепер можна зберігати більше даних для властивості `query_fields`, мати повторні записи `header` і `query_fields`.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) Додано нові властивості `lifetime_type`, `enabled_lifetime` і `enabled_lifetime_type`.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) Значення за замовчуванням параметра `lifetime` змінено з `30d` на `7d`.\ [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `discoveryrule.get`: умови фільтра будуть відсортовані в порядку їх розташування у формулі.\ #### 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/dashboards##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. #### Відображення На основі інформації про підтвердження можна налаштувати спосіб відображення кількості проблем на інформаційній панелі чи картах. Для цього вам потрібно зробити вибір у параметрі *Відображення проблеми*, доступному як у [map configuration](/manual/config/visualization/maps/map#creating_a_map), так і в *Проблеми за ступенем тяжкості* [віджеті панелі інструментів]( /manual/web_interface/frontend_sections/dashboards##adding_widgets). Можна відобразити кількість усіх проблем, кількість непідтверджених проблем окремо від загальної чи тільки кількість непідтверджених проблем. На основі інформації про оновлення проблеми (підтвердження тощо) можна налаштувати операції оновлення – надіслати повідомлення або виконати віддалені команди. #### 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. #### Відображення статусу тригера Якщо тригер визначено, вам може бути цікаво переглянути його статус. Якщо навантаження ЦП перевищило пороговий рівень, який ви визначили в тригері, проблема буде відображена в *Моніторинг → Проблеми*. {width="600"} Блимання в стовпці статусу вказує на нещодавню зміну статусу тригера, яка відбулася за останні 30 хвилин. #### Display Once suppressed the problem is marked by a blinking  suppression icon in the *Info* column, before being hidden. The suppression icon is blinking while the suppression task is in the waiting list. Once the task manager has suppressed the problem, the icon will stop blinking. If the suppression icon keeps blinking for a long time, this may indicate a server problem, for example, if the server is down and the task manager cannot complete the task. The same logic applies to unsuppression. In the short period after the task is submitted and the server has not completed it, the unsuppression icon is blinking. A suppressed problem may be both hidden or shown, depending on the problem filter/widget settings. When shown in the problem list, a suppressed problem is marked by the suppression icon and suppression details are shown on mouseover:  Suppression details are also displayed in a popup when positioning the mouse on the suppression icon in the *Actions* column. #### Відображення Після приховування проблема позначається блиманням  значка приховування в стовпці *Інформація*, перш ніж його приховати. Значок придушення блимає, поки завдання придушення знаходиться в списку очікування. Після того, як диспетчер завдань вирішить проблему, значок перестане блимати. Якщо піктограма придушення продовжує блимати протягом тривалого часу, це може вказувати на проблему з сервером, наприклад, якщо сервер не працює і диспетчер завдань не може завершити завдання. Така ж логіка застосовується і до зняття приховування. Протягом короткого періоду після того, як завдання було надіслано, але сервер не встиг його виконати, піктограма зняття приховування блимає. Прихована проблема може бути як прихованою, так і відображеною, залежно від налаштувань фільтра проблеми/віджета. При відображенні у списку проблем прихована проблема позначається піктограмою придушення та деталі придушення показуються при наведенні миші:  Деталі придушення також відображаються у спливаючому вікні, якщо навести курсор миші на придушення у стовпці *Дії*. # drule.create # drule.create # drule.delete # drule.delete # drule.get # drule.get # drule.update # drule.update #### drule [ZBXNEXT-2732](https://support.zabbix.com/browse/ZBXNEXT-2732) Added new property `concurrency_max`.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Renamed `proxy_hostid` to `proxyid` #### drule [ZBXNEXT-2732](https://support.zabbix.com/browse/ZBXNEXT-2732) Додано нову властивість `concurrency_max`.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Перейменовано `proxy_hostid` на `proxyid` # dservice.get # dservice.get ### Enabling high availability ### Увімкнення високої доступності #### Error handling Up to the present moment, everything you have tried has worked fine. But what would happen if you tried making an incorrect call to the API? Try to create another host by calling [host.create](/manual/api/reference/host/create) but omitting the mandatory `groups` parameter: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.create","params":{"host":"Linux server","interfaces":[{"type":1,"main":1,"useip":1,"ip":"192.168.3.1","dns":"","port":"10050"}]},"id":7}' ``` The response will then contain an error message: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` If an error has occurred, instead of the `result` property, the response object will contain the `error` property with the following data: - `code` - an error code; - `message` - a short error summary; - `data` - a more detailed error message. Errors can occur in various cases, such as, using incorrect input values, a session timeout or trying to access non-existing objects. Your application should be able to gracefully handle these kinds of errors. #### Обробка помилок До цього моменту все, що ви спробували, працювало нормально. Але що станеться, якщо ви спробуєте зробити некоректний виклик API? Спробуйте створити інший хост, викликавши [host.create](/manual/api/reference/host/create), але опустивши обов'язковий параметр `groups`: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.create","params":{"host":"Linux server","interfaces":[{"type":1,"main":1,"useip":1,"ip":"192.168.3.1","dns":"","port":"10050"}]},"id":7}' ``` Тоді відповідь міститиме повідомлення про помилку: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` Якщо сталася помилка, замість властивості `result` об'єкт відповіді буде містити властивість `error` з наступними даними: - `code` - код помилки; - `message` - короткий опис помилки; - `data` - більш детальне повідомлення про помилку. Помилки можуть виникати у різних випадках, наприклад, при використанні неправильних вхідних даних, таймауті сеансу або спробі отримати доступ до неіснуючих об'єктів. Ваша програма повинна вміти коректно обробляти такі помилки. # event.acknowledge # event.acknowledge #### Event correlation Create custom event correlation rules. [Correlation API](/manual/api/reference/correlation) #### Кореляція подій Створення власних правил кореляції подій. [API кореляції](/manual/api/reference/correlation) # event.get # event.get #### Events Retrieve events generated by triggers, network discovery and other Zabbix systems for more flexible situation management or third-party tool integration. [Event API](/manual/api/reference/event) #### Події Отримувати події, створені тригерами, виявленням мережі та іншими системами Zabbix для більш гнучкого управління ситуацією або інтеграцією в сторонні інструменти. [Event API](/manual/api/reference/event) ### Event tag The event tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| ### Тег події Об'єкт тегу події має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |тег|рядок|Назва тегу події.| |значення|рядок|Значення тегу події.| #### event [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: Added new parameters `selectAcknowledges`, `selectAlerts`, `trigger_severities`, and `groupBy`.\ [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: Deprecated parameters `select_acknowledges` and `select_alerts`.\ [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299), [ZBX-23240](https://support.zabbix.com/browse/ZBX-23240) `event.get`: Added new parameters `action` and `action_userids`.\ #### event [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: додано нові параметри `selectAcknowledges`, `selectAlerts`, `trigger_severities` і `groupBy`.\ [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: Задіприкейчені параметри `select_acknowledges` і `select_alerts`.\ [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299), [ZBX-23240](https://support.zabbix.com/browse/ZBX-23240) `event.get` : Додано нові параметри `action` і `action_userids`.\ #### event [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: Added strict validation of the method parameters.\ #### event [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `event.get`: додано сувору перевірку параметрів методу.\ ### Example ### Приклади ##### 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(/host/web.test.fail[сценарій])<>0 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ##### 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 Щоб створити тригер «Помилка веб-сценарію» з корисним описом проблеми в назві тригера, ви можете визначити тригер із назвою: Помилка веб-сценарію "Сценарій": {ITEM.VALUE} і тригерний вираз: length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ##### 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(/host/web.test.in[Scenario,,bps])<10000 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади #### Examples #### Приклади # Examples This section provides files of sample modules and widgets, which you can use as a base for your custom modules. To use a module: 1. Download the ZIP archive. 2. Unpack the content into a separate directory inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). 3. Register the module in Zabbix frontend. # Приклади У цьому розділі представлені файли зразків модулів та віджетів, які ви можете використовувати як основу для власних модулів. Щоб використовувати модуль: 1. Завантажте ZIP-архів. 2. Розпакуйте вміст в окремий підкаталог у каталозі з *модулями* web-серверу Zabbix (наприклад */zabbix/ui/modules*). 3. Зареєструйте модуль у інтерфейсі Zabbix. ## 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 "Monitored Host" -k mysql.queries -o 342.45**\ Надішліть **342.45** як значення для елемента **mysql.queries** хосту **Monitored Host** за допомогою сервера 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 server" 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 "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**\ Надішліть **342.45** як значення для елемента **mysql.queries** у хості **Monitored Host** на сервер з IP-адресою **192.168.1.113** за допомогою TLS із сертифікатом. **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**\ Надішліть **342.45** як значення для елемента **mysql.queries** у хості **Monitored Host** на сервер з IP-адресою **192.168.1.113** за допомогою TLS зі спільним ключем (PSK). [ ]{#lbAI} ### Example workflow The following section will walk you through some examples of usage in a greater detail. ### Приклад робочого процесу У наступному розділі ми розглянемо деякі приклади використання більш детально. ## 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} #### Export and import Export and import Zabbix configuration data for configuration backups, migration or large-scale configuration updates. [Configuration API](/manual/api/reference/configuration) #### Експорт та імпорт Експорт та імпорт даних конфігурації Zabbix для резервних копій конфігурації, міграція або масштабні оновлення конфігурації. [API конфігурації](/manual/api/reference/configuration) ##### Export format Data can be exported using the Zabbix web frontend or [Zabbix API](/manual/api/reference/configuration). Supported export formats are YAML, XML and JSON. ##### Формат експорту Дані можна експортувати за допомогою веб-інтерфейсу Zabbix або [Zabbix API](/manual/api/reference/configuration). Підтримувані формати експорту: YAML, XML і JSON. #### Exporting To export templates, do the following: 1. Go to *Data collection* → *Templates*. 2. Mark the checkboxes of the templates to export. 3. Click *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. #### Експорт Щоб експортувати шаблони, виконайте такі дії: 1. Перейдіть до *Збір даних* → *Шаблони*. 2. Позначте шаблони для експорту. 3. Натисніть *Експорт* під списком.  Залежно від обраного формату шаблони експортуються в локальний файл із назвою за замовчуванням: - `zabbix_export_templates.yaml` - в експорті YAML (параметр експорту за замовчуванням); - `zabbix_export_templates.xml` - в експорті XML; - `zabbix_export_templates.json` - в експорті JSON. ### 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 ``` ## 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 agent 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} ### Further reading Now, you have enough knowledge to start working with the Zabbix API, however, do not stop here. For further reading you are advised to have a look at the [list of available APIs](/manual/api/reference). ### Більше інформації Тепер у вас достатньо знань, щоб почати працювати з Zabbix API, однак не зупиняйтеся на цьому. Для подальшого читання радимо переглянути [список доступних API](/manual/api/reference). #### General Change certain global configuration options. [Autoregistration API](/manual/api/reference/autoregistration) | [Icon map API](/manual/api/reference/iconmap) | [Image API](/manual/api/reference/image) | [Settings API](/manual/api/reference/settings) | [Regular expression API](/manual/api/reference/regexp) | [Module API](/manual/api/reference/module) | [Connector API](/manual/api/reference/connector) #### Загальне Зміна певних параметрів глобальної конфігурації. [API автореєстрації](/manual/api/reference/autoregistration) | [API карти значків](/manual/api/reference/iconmap) | [API образів](/manual/api/reference/image) | [API налаштувань](/manual/api/reference/settings) | [API регулярного виразу](/manual/api/reference/regexp) | [API модуля](/manual/api/reference/module) | [API конектора](/manual/api/reference/connector) # graph.create # graph.create # graph.delete # graph.delete # graph.get # graph.get # graphitem.get # graphitem.get # graphprototype.create # graphprototype.create # graphprototype.delete # graphprototype.delete # graphprototype.get # graphprototype.get # graphprototype.update # graphprototype.update #### Graphs Edit graphs or separate graph items for better presentation of the gathered data. [Graph API](/manual/api/reference/graph) | [Graph item API](/manual/api/reference/graphitem) #### Графіки Редагування графіків або відокремлення їх елементів даних для кращого представлення зібраних даних. [API графіків](/manual/api/reference/graph) | [API елементів даних графіків ](/manual/api/reference/graphitem) ##### Graphs With the item working for a while, it might be time to see something visual. [Simple graphs](/manual/config/visualization/graphs/simple) are available for any monitored numeric item without any additional configuration. These graphs are generated on runtime. To view the graph, go to *Monitoring → Latest data* and click on the 'Graph' link next to the item. {width="600"} ##### Графіки Коли елемент даних працює деякий час, можливо, настав час побачити щось візуальне. [Прості графіки](/manual/config/visualization/graphs/simple) доступні для будь-якого відстежуваного числового елемента даних без додаткового налаштування. Ці графіки генеруються під час виконання. Щоб переглянути графік, перейдіть до *Моніторинг → Останні дані* та натисніть посилання 'Графік' поруч із елементом даних. {width="600"} # graph.update # graph.update #### graph [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `graph.get`: Method now also supports `status` property if `selectGraphDiscovery` parameter is used. #### graph [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `graph.get`: метод тепер також підтримує властивість `status`, якщо використовується параметр `selectGraphDiscovery`. # hanode.get # hanode.get #### 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) # history.clear # history.clear # 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 історії](/manual/api/reference/history) #### history [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193) `history.get`: Parameter `sortfield` now supports `ns`.\ [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) Added new method `history.push`.\ #### history [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193) `history.get`: параметр `sortfield` тепер підтримує `ns`.\ [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) Додано новий метод `history.push`.\ # host.create # host.create # host.delete # host.delete # host.get # host.get # hostgroup.create # hostgroup.create # hostgroup.delete # hostgroup.delete # hostgroup.get # hostgroup.get # hostgroup.massadd # hostgroup.massadd # hostgroup.massremove # hostgroup.massremove # hostgroup.massupdate # hostgroup.massupdate # hostgroup.update # hostgroup.update #### hostgroup [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `hostgroup.get`: Method now also supports `status` property if `selectGroupDiscoveries` parameter is used. #### хост-група [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `hostgroup.get`: метод тепер також підтримує властивість `status`, якщо використовується параметр `selectGroupDiscoveries`. #### hostgroup [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Renamed parameters `selectHostPrototype` to `selectHostPrototypes`, `selectDiscoveryRule` to `selectDiscoveryRules`, `selectGroupDiscovery` to `selectGroupDiscoveries`; now each parameter will return an array of objects instead of an object.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Renamed output properties `hostPrototype` to `hostPrototypes`, `discoveryRule` to `discoveryRules`, `groupDiscovery` to `groupDiscoveries`.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Removed support for `groupid` property in `selectGroupDiscoveries` (previously - `selectGroupDiscovery`) parameter.\ #### Група хостів [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: перейменовано параметри `selectHostPrototype` на `selectHostPrototypes`, `selectDiscoveryRule` на `selectDiscoveryRules`, `selectGroupDiscovery ` на `selectGroupDiscoveries`; тепер кожен параметр повертатиме масив об’єктів замість об’єкта.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: перейменовано вихідні властивості `hostPrototype` на `hostPrototypes`, `discoveryRule` на `discoveryRules`, `groupDiscovery` на `groupDiscoveries`.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: вилучено підтримку властивості `groupid` у параметрі `selectGroupDiscoveries` (раніше - `selectGroupDiscovery`).\ # hostinterface.create # hostinterface.create # hostinterface.delete # hostinterface.delete # hostinterface.get # hostinterface.get # hostinterface.massadd # hostinterface.massadd # hostinterface.massremove # hostinterface.massremove # hostinterface.replacehostinterfaces # hostinterface.replacehostinterfaces # hostinterface.update # hostinterface.update # host.massadd # host.massadd # host.massremove # host.massremove # host.massupdate # host.massupdate # hostprototype.create # hostprototype.create # hostprototype.delete # hostprototype.delete # hostprototype.get # hostprototype.get # hostprototype.update # hostprototype.update #### 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) #### Хости та групи хостів Керуйте групами хостів, хостами та всім, що з ними пов’язано, включаючи інтерфейси хостів, макроси хостів та періоди обслуговування. [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) # host.update # host.update #### host [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) Added new properties `monitored_by` and `proxy_groupid`.\ [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) Added new read-only property `assigned_proxyid`.\ [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) `host.get`: Added new parameter `proxy_groupids`.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `host.get`: Method now also supports `status`, `ts_disable` and `disable_source` properties if `selectHostDiscovery` parameter is used. #### Вузол мережі [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) Додано нові властивості `monitored_by` і `proxy_groupid`.\ [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) Додано нову властивість тільки для читання `assigned_proxyid`.\ [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) `host.get`: додано новий параметр `proxy_groupids`.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `host.get`: метод тепер також підтримує властивості `status`, `ts_disable` і `disable_source`, якщо параметр `selectHostDiscovery` використовується. #### Housekeeping Configure housekeeping. [Housekeeping API](/manual/api/reference/housekeeping) #### Housekeeping Налаштування Housekeeping-у (видалення старих записів). [Housekeeping API](/manual/api/reference/housekeeping) # housekeeping.get # housekeeping.get # housekeeping.update # housekeeping.update ### How modules work - An enabled module is launched on each HTTP request, before executing the action code. - The module will register new actions or redefine the existing ones. - The module will add new frontend sections and remove or redefine the existing ones. - The module will hook to frontend events like onBeforeAction and onTerminate, if needed. - The requested action is finally executed by running the action code - either the default one, or module-defined. ### Як працюють модулі - Увімкнений модуль запускається під час кожного HTTP запиту перед виконанням коду дії. - Модуль буде реєструвати нові дії або перевизначати існуючі. - Модуль додасть нові розділи інтерфейсу та видалить або перевизначить існуючі. - Якщо потрібно, модуль підключатиметься до зовнішніх подій, таких як onBeforeAction і onTerminate. - Запитувана дія остаточно виконується шляхом запуску коду дії - стандартного або визначеного модулем. # httptest.create # httptest.create # httptest.delete # httptest.delete # httptest.get # httptest.get # httptest.update # httptest.update # iconmap.create # iconmap.create # iconmap.delete # iconmap.delete # iconmap.get # iconmap.get # iconmap.update # iconmap.update ### id Module ID. Must be unique. To avoid future naming conflicts, it is recommended to use prefix for modules (author or company name, or any other). For example, if a module is an example for lessons and the module name is "My module", then the ID will be "example_my_module". *Type*: String *Example*: ```json "id": "example_my_module" ``` ### id ID модуля. Повинно бути унікальним. Щоб уникнути майбутніх конфліктів іменування, рекомендується використовувати префікс для модулів (назва автора, компанії чи будь-який інший). Наприклад, якщо модуль є прикладом для уроків, а назва модуля – «Мій модуль», тоді ідентифікатор буде «example_my_module». *Тип*: String *Приклад*: ```json "id": "example_my_module" ``` # image.create # image.create # image.delete # image.delete # image.get # image.get # 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. ## 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) ------------------------------------------------------------------------ Цей документ створено о 21:23:35 GMT, 18 березня 2020 року ## 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) ------------------------------------------------------------------------ Цей документ створено о 12:58:30 GMT, 11 червня 2021 року ## 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) ------------------------------------------------------------------------ Цей документ створено: 08:42:39 GMT, 11 червня 2021 року ## 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) -------------------------------------------------- ---------------------- Цей документ створено о 14:07:57 GMT, 22 листопада 2021 року ## 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) -------------------------------------------------- ---------------------- Цей документ створено о 16:12:22 GMT, 04 вересня 2020 року ## 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) -------------------------------------------------- ---------------------- Цей документ створено: 20:50:13 GMT, 22 листопада 2021 р. #### 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), файли перекладу слід створити вручну. Щоб створити файли перекладу, запустіть: зробити gettext locale/make_mo.sh Цей крок не потрібен, якщо Zabbix встановлюється з пакетів або вихідних файлів tar.gz. # item.create # item.create # item.delete # item.delete # item.get # item.get # itemprototype.create # itemprototype.create # itemprototype.delete # itemprototype.delete # itemprototype.get # itemprototype.get # itemprototype.update # itemprototype.update #### item prototype [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) The `params` property is now *required* for preprocessing steps of the type "Check for not supported value".\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: The properties `headers` and `query_fields` changed from name-indexed object to array of objects with separate `name` and `value` properties.\ #### прототип елемента даних [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Властивість `params` тепер *обов’язкова* для етапів попередньої обробки типу «Перевірити значення, що не підтримується».\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: властивості `headers` і `query_fields` змінено з індексованого за іменем об'єкта на масив об'єктів з окремими властивостями `name` і `value`.\ #### item prototype [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Added new item prototype `type` (22 - Browser).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Added new [item prototype preprocessing](/manual/api/reference/itemprototype/object#item-prototype-preprocessing) type "SNMP get value" (30).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Property `timeout` is now also supported if item `type` is set to "SNMP agent" (20) and `snmp_oid` starts with "`get[`".\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Property `timeout` is now supported if item `type` is set to "Zabbix agent" (0), "Simple check" (3) and `key_` does not start with "`vmware.`" and "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "SNMP agent" (20) and `snmp_oid` starts with "`walk[`".\ [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Added *scope* and *pattern* components to parameters for steps of the type "Check for not supported value".\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) It is now possible to store more data for the `query_fields` property, have repeated `header` and `query_fields` entries. #### прототип елемента даних [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Додано новий прототип елемента `type` (22 - Браузер).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Додано новий тип "SNMP get value" (30) [попередня обробка прототипу елемента](/manual/api/reference/itemprototype/object#item-prototype-preprocessing) .\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Властивість `timeout` тепер також підтримується, якщо для елемента `type` встановлено значення "SNMP agent" (20) і `snmp_oid` запускається з "`get[`".\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Властивість `timeout` тепер підтримується, якщо для елемента `type` встановлено значення "Zabbix agent" (0), "Simple check" ( 3) і `key_` не починається з "`vmware.`" і "`icmpping`", "Zabbix agent (активний)" (7), "Зовнішня перевірка" (10), "Монітор бази даних" (11), "Агент SSH" (13), "Агент TELNET" (14), "Агент SNMP" (20) і `snmp_oid` починається з "`walk[`".\ [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Додано компоненти *scope* та *pattern* до параметрів для кроків типу «Перевірка на непідтримуване значення».\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) Тепер можна зберігати більше даних для властивості `query_fields`, мати повторні записи `header` і `query_fields`. #### Items Define items to monitor. [Item API](/manual/api/reference/item) #### Елементи даних Визначення елементів даних для моніторингу. [API елементів даних](/manual/api/reference/item) # item.update # item.update #### item [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) The `params` property is now *required* for preprocessing steps of the type "Check for not supported value".\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `item.get`, `item.create`, `item.update`: The properties `headers` and `query_fields` changed from name-indexed object to array of objects with separate `name` and `value` properties.\ #### елемент даних [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Властивість `params` тепер *обов’язкова* для етапів попередньої обробки типу «Перевірити значення, що не підтримується».\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) `item.get`, `item.create`, `item.update`: властивості `headers` і `query_fields` змінено з індексованого за іменем об'єкта на масив об'єктів з окремими властивостями `name` і `value`.\ #### item [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Added new item `type` (22 - Browser).\ [ZBXNEXT-7460](https://support.zabbix.com/browse/ZBXNEXT-7460) Added new read-only property `name_resolved`.\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Added new [item preprocessing](/manual/api/reference/item/object#item-preprocessing) type "SNMP get value" (30).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Property `timeout` is now also supported if item `type` is set to "SNMP agent" (20) and `snmp_oid` starts with "`get[`".\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Property `timeout` is now supported if item `type` is set to "Zabbix agent" (0), "Simple check" (3) and `key_` does not start with "`vmware.`" and "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "SNMP agent" (20) and `snmp_oid` starts with "`walk[`".\ [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Added *scope* and *pattern* components to parameters for steps of the type "Check for not supported value".\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) It is now possible to store more data for the `query_fields` property, have repeated `header` and `query_fields` entries.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `item.get`: Method now also supports `status`, `ts_disable` and `disable_source` properties if `selectItemDiscovery` parameter is used. #### елемент даних [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Додано новий елемент `type` (22 - Браузер).\ [ZBXNEXT-7460](https://support.zabbix.com/browse/ZBXNEXT-7460) Додано нову властивість лише для читання`name_resolved` .\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Додано новий тип [попередньої обробки елементів](/manual/api/reference/item/object#item-preprocessing) "SNMP get value" (30).\ [ZBXNEXT-8645](https://support.zabbix.com/browse/ZBXNEXT-8645) Властивість `timeout` тепер також підтримується, якщо для елемента `type` встановлено значення "SNMP agent" (20) і `snmp_oid` запускається з "`get[`".\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Властивість `timeout` тепер підтримується, якщо для елемента `type` встановлено значення "Zabbix agent" (0), "Simple check" ( 3) і `key_` не починається з "`vmware.`" і "`icmpping`", "Zabbix agent (активний)" (7), "Зовнішня перевірка" (10), "Монітор бази даних" (11), "Агент SSH" (13), "Агент TELNET" (14), "Агент SNMP" (20) і `snmp_oid` починається з "`walk[`".\ [ZBXNEXT-7726](https://support.zabbix.com/browse/ZBXNEXT-7726) Додано компоненти *scope* та *pattern* до параметрів для кроків типу «Перевірка на непідтримуване значення».\ [ZBXNEXT-7578](https://support.zabbix.com/browse/ZBXNEXT-7578) Тепер можна зберігати більше даних для властивості `query_fields`, мати повторні записи `header` і `query_fields`.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `item.get`: метод тепер також підтримує властивості `status`, `ts_disable` і `disable_source`, якщо використовується параметр `selectItemDiscovery` . ### JavaScript A JavaScript class can be used to add dynamic behavior and interactivity to the widget configuration view. For example, you can initialize a color picker, defined in the [*CWidgetFormView*](#cwidgetformview) class. The JavaScript class should be loaded with the form, therefore it should be referenced in the [*CWidgetFormView*](#cwidgetformview) class by using the methods *includeJsFile()* and *addJavaScript()*. In the example below, a singleton class instance is immediately created and stored under the *window.my_custom_widget_form* name. Thus, opening the form for the second time will re-create the instance. The JavaScript class should be located in the *views* directory. **views/widget.edit.js.php example** ```php <?php use Modules\MyCustomWidget\Widget; ?> window.my_custom_widget_form = new class { init({color_palette}) { colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } } }; ``` ### JavaScript Клас JavaScript можна використовувати для додавання динамічної поведінки та інтерактивності до конфігурації view віджета. Наприклад, ви можете ініціалізувати засіб вибору кольорів, визначений у класі [*CWidgetFormView*](#cwidgetformview). Клас JavaScript має бути завантажений разом із формою, тому на нього слід посилатися в класі [*CWidgetFormView*](#cwidgetformview) за допомогою методів *includeJsFile()* і *addJavaScript()*. У наведеному нижче прикладі екземпляр класу singleton одразу створюється та зберігається під назвою *window.my_custom_widget_form*. Таким чином, відкриття форми вдруге призведе до повторного створення екземпляра. Клас JavaScript має бути розташований у каталозі *views*. **views/widget.edit.js.php приклад** ```php <?php use Modules\MyCustomWidget\Widget; ?> window.my_custom_widget_form = new class { init({color_palette}) { colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } } }; ``` ### JavaScript The JavaScript class is responsible for determining widget behavior, such as updating widget data, resizing the widget, displaying widget elements, etc. All JavaScript operations use and/or extend the base JavaScript class of all dashboard widgets - *CWidget*. The *CWidget* class contains a set of methods with the default implementation for widget behavior. Depending on widget complexity, these methods can be utilized as is or extended. The *CWidget* class contains the following methods: - Methods that define widget lifecycle: *onInitialize()*, *onStart()*, *onActivate()*, *onDeactivate()*, *onDestroy()*, *onEdit()*. - Methods that handle updating and displaying widget data: *promiseUpdate()*, *getUpdateRequestData()*, *processUpdateResponse(response)*, *processUpdateErrorResponse(error)*, *setContents(response)*. - Methods that modify widget appearance: *onResize()*, *hasPadding()*. The JavaScript class should be located in the *assets/js* directory and specified in the [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) parameter in the *manifest.json* file. ### JavaScript Клас JavaScript відповідає за визначення поведінки віджетів, наприклад оновлення даних віджетів, зміну розміру віджетів, відображення елементів віджетів тощо. Усі операції JavaScript використовують і/або розширюють базовий клас JavaScript усіх віджетів інформаційної панелі - *CWidget*. Клас *CWidget* містить набір методів із реалізацією за замовчуванням для поведінки віджетів. Залежно від складності віджета, ці методи можна використовувати як є або розширити. Клас *CWidget* містить такі методи: - Методи, що визначають життєвий цикл віджета: *onInitialize()*, *onStart()*, *onActivate()*, *onDeactivate()*, *onDestroy()*, *onEdit()*. - Методи, які обробляють оновлення та відображення даних віджетів: *promiseUpdate()*, *getUpdateRequestData()*, *processUpdateResponse(response)*, *processUpdateErrorResponse(error)*, *setContents(response)*. - Методи, які змінюють зовнішній вигляд віджета: *onResize()*, *hasPadding()*. Клас JavaScript має розташовуватися в каталозі *assets/js* і вказуватися в параметрі [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) у *manifest.json* файл. ##### Lifecycle methods The widget lifecycle methods are invoked by the dashboard, and at different stages of the widget's lifecycle during its existence within the dashboard. ##### Методи життєвого циклу Методи життєвого циклу віджета викликаються інформаційною панеллю та на різних етапах життєвого циклу віджета під час його існування на інформаційній панелі. #### 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, де процесори розподіляються нерівномірно між вузлами NUMA. Якщо логічні ЦП розподілені нерівномірно, показники продуктивності ЦП можуть бути недоступні для деяких ЦП. Наприклад, якщо є 72 логічних ЦП з 2 вузлами NUMA, обидва вузли повинні мати по 36 ЦП кожен. ##### 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 template to host With a template ready, it only remains to add it to a host. For that, go to *Data collection → 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. This way it can be applied to any other host as well. Any changes to the items, triggers and other entities at the template level will propagate to the hosts the template is linked to. #### Пов'язування шаблону з вузлом мережі З шаблоном готово, залишається тільки додати його на вузол мережі. Для цього перейдіть до *Збір даних → Хости*, клацніть 'New host', щоб відкрити форму його властивостей, і знайдіть поле **Шаблони**. Почніть вводити *Новий шаблон* у полі *Шаблони*. Назва шаблону, який ми створили, має з’явитися у спадному списку. Прокрутіть вниз, щоб вибрати. Переконайтеся, що він з’явився в полі *Шаблони*.  Натисніть *Оновити* у формі, щоб зберегти зміни. Тепер шаблон додано до вузла мережі з усіма об’єктами, які він містить. Таким чином його можна також застосувати до будь-якого іншого вузла мережі. Будь-які зміни в елементах даних, тригерах та інших сутностях на рівні шаблону поширюватимуться на вузли мережі, з якими пов’язано шаблон. ### 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. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### Цілі контролю рівня журналу *process-type* Всі процеси вказаного типу (активні перевірки, колектор, слухач) *process-type,N* Тип та номер процесу (наприклад, listener,3) *pid* Ідентифікатор процесу, до 65535. Для більших значень вкажіть ціль у вигляді "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Вивести відомі елементи і вийти. Для кожного елемента використовуються або загальні значення за замовчуванням або специфічні значення за замовчуванням для тестування. Ці значення за замовчуванням перераховано у квадратних дужках як ключові параметри елемента. Значення, що повертаються взято у квадратні дужки і додано префікс з типом значення, що повертається значення, відокремленого символом труби. Для параметрів користувача тип завжди **t**, оскільки агент не може визначити всі можливі значення, що повертаються. Елементи, відображені як робочі, не гарантують роботу з сервера Zabbix або zabbix\_get при запиті до запущеного демона агента, оскільки дозволи або середовище може відрізнятися. Типи значень, що повертаються: d Число з десятковою частиною. m Не підтримується. Це може бути спричинено запитом елемента, який працює лише в активному режимі, наприклад, елемент моніторингу журналу або елемент, який вимагає декілька зібраних значень. Проблеми з правами доступу або неправильні параметри користувача також можуть призвести до стану "не підтримується". s Текст. Максимальна довжина не обмежена. t Текст. Те саме, що і **s**. u Ціле число без знаку. **-t**, **--test** *item-key* Перевірити один елемент і вийти. Дивіться **--print** для опису виводу. **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести інформацію про версію і завершити роботу. [ ]{#lbAH} ### Log level control targets *process-type* All processes of specified type (availability manager, browser poller, configuration syncer, data sender, discovery manager, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, odbc poller, poller, agent poller, http agent poller, snmp poller, preprocessing manager, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector) *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, discovery manager, history syncer, housekeeper, http poller, preprocessing manager, icmp pinger, ipmi manager, ipmi poller, java poller, poller, agent poller, http agent poller, snmp poller, 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) **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### Цілі контролю рівня журналу *process-type* Усі процеси вказаного типу (availability manager, browser poller, configuration syncer, data sender, discovery manager, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, odbc poller, poller, agent poller, http agent poller, snmp poller, preprocessing manager, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector) *process-type,N* Тип і номер процесу (наприклад, poller, 3) *pid* Ідентифікатор процесу, до 65535. Для більших значень укажіть ціль як "process-type,N" Цілі контролю рівня профілювання *process-type* Усі процеси вказаного типу (configuration syncer, data sender, discovery manager, history syncer, housekeeper, http poller, preprocessing manager, icmp pinger, ipmi manager, ipmi poller, java poller, poller, agent poller, http agent poller, snmp poller, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector, history poller, availability manager, odbc poller) *process-type,N* Тип і номер процесу (наприклад, history syncer,1) *pid* Ідентифікатор процесу, до 65535. Для більших значень укажіть ціль як "process-type,N" *scope* Разом з типом процесу можно вказати область профілювання (rwlock, mutex, processing) (наприклад, history syncer,1,processing) **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Вивести інформацію про версію та вийти. [ ]{#lbAH} #### Low-level discovery Configure low-level discovery rules as well as item, trigger and graph prototypes to monitor dynamic entities. [LLD rule API](/manual/api/reference/discoveryrule) | [Item prototype API](/manual/api/reference/itemprototype) | [Trigger prototype API](/manual/api/reference/triggerprototype) | [Graph prototype API](/manual/api/reference/graphprototype) | [Host prototype API](/manual/api/reference/hostprototype) #### Низькорівневе виявлення Налаштування правил низькорівневого виявлення, а також прототипів елементів даних, тригерів і графіків для моніторингу динамічних сутностей. [API правил LLD](/manual/api/reference/discoveryrule) | [API Прототипа елемента даних](/manual/api/reference/itemprototype) | [API Прототипа тригера](/manual/api/reference/triggerprototype) | [API Прототипа графа](/manual/api/reference/graphprototype) | [API Прототипа хоста](/manual/api/reference/hostprototype) #### Macros Manage macros. [User macro API](/manual/api/reference/usermacro) #### Макроси Керуйте макросами. [API користувацьких макросів](/manual/api/reference/usermacro) # maintenance.create # maintenance.create # maintenance.delete # maintenance.delete # maintenance.get # maintenance.get # manifest.json Any module needs the manifest.json file. The file must be located in the module's primary directory (for example, *zabbix/ui/modules/module_name/manifest.json*). As a bare minimum, manifest.json should specify these fields: ```json { "manifest_version": 2.0, "id": "my_ip_address", "name": "My IP Address", "namespace": "MyIPAddress", "version": "1.0" } ``` Parameters supported in **manifest.json** (press on the parameter name for a detailed description): |Parameter |Description |Required | |--|--------|--| |[manifest_version](#manifest-version)|Manifest version of the module.| Yes | |[id](#id) |Unique module ID. |^| |[name](#name) |Module name that will be displayed in the Administration section. |^| |[namespace](#namespace) |PHP namespace for module classes.|^| |[version](#version) |Module version. |^| |[type](#type) |Type of the module. For widget must be set to *widget* | Yes for widgets, otherwise no | |[widget](#widget) |Widget configuration. Used for widgets only. |^| |[actions](#actions) | Actions to register with the module. |^| |[assets](#assets) | CSS styles and JavaScript files to include. | No | |[author](#author) |Module author. |^| |[config](#config) |Default values for custom module options. |^| |[description](#description) |Module description.|^| |[url](#url) |A link to the module description. |^| # manifest.json Для будь-якого модуля потрібний файл manifest.json. Файл має бути розташований у основному каталозі модуля (наприклад *zabbix/ui/modules/module_name/manifest.json*). Як мінімум, у файлі manifest.json мають бути вказані такі поля: ```json { "manifest_version": 2.0, "id": "my_ip_address", "name": "My IP Address", "namespace": "MyIPAddress", "version": "1.0" } ``` Параметри, які підтримуються в **manifest.json** (натисніть назву параметра для детального опису): |Параметр |Опис |Обов'язковий | |--|--------|--| |[manifest_version](#manifest-version)|Версія маніфесту модуля.| Так | |[id](#id) |Унікальний ідентифікатор модуля. |^| |[name](#name) |Назва модуля, що відображатиметься в розділі Адміністрування. |^| |[namespace](#namespace) |Простір імен PHP для класів модулів.|^| |[version](#version) |Версія модуля. |^| |[type](#type) |Тип модуля. Для віджета потрібно встановити *widget* | Так для віджетів, ні для решти | |[widget](#widget) |Конфігурація віджета. Використовується лише для віджетів. |^| |[actions](#actions) | Дії для реєстрації в модулі. |^| |[assets](#assets) | Стилі CSS і файли JavaScript для включення. | Ні | |[author](#author) |Автор модуля. |^| |[config](#config) |Значення за замовчуванням для користувацьких параметрів модуля. |^| |[description](#description) |Опис модуля.|^| |[url](#url) |Посилання на опис модуля. |^| ### manifest_version {#manifest-version} Manifest version of the module. Currently, supported version is **2.0**. *Type*: Double *Example*: ```json "manifest_version": 2.0 ``` ### manifest_version {#manifest-version} Версія маніфесту модуля. Наразі підтримується версія **2.0**. *Тип*: Double *Приклад*: ```json "manifest_version": 2.0 ``` #### Maps Configure maps to create detailed dynamic representations of your IT infrastructure. [Map API](/manual/api/reference/map) #### Карти Налаштуйте карти для створення детальних динамічних представлень вашої ІТ інфраструктури. [API карти](/manual/api/reference/map) ##### 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. #### Media types Configure media types and multiple ways users will receive alerts. [Media type API](/manual/api/reference/mediatype) #### Способи оповіщень Налаштування способів оповіщень та способів, якими користувачі отримуватимуть сповіщення [API способів оповіщень](/manual/api/reference/mediatype) #### mediatype [ZBXNEXT-4165](https://support.zabbix.com/browse/ZBXNEXT-4165) `mediatype.get`: Added new parameter `selectActions`.\ [ZBXNEXT-9138](https://support.zabbix.com/browse/ZBXNEXT-9138) `mediatype.get`, `mediatype.create`, `mediatype.update`: Added new property `message_format`.\ [ZBXNEXT-9138](https://support.zabbix.com/browse/ZBXNEXT-9138) `mediatype.get`, `mediatype.create`, `mediatype.update`: Deprecated property `content_type`.\ #### mediatype [ZBXNEXT-4165](https://support.zabbix.com/browse/ZBXNEXT-4165) `mediatype.get`: додано новий параметр `selectActions`.\ [ZBXNEXT-9138](https://support.zabbix.com/browse/ZBXNEXT-9138) `mediatype.get`, `mediatype.create`, `mediatype.update`: додано нову властивість `message_format`.\ [ZBXNEXT-9138](https://support.zabbix.com/browse/ZBXNEXT-9138) `mediatype.get`, `mediatype.create`, `mediatype.update`: діприкейтед властивість `content_type`.\ # 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, і допоможе вам зорієнтуватися в доступних класах і методах. #### mfa [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) Added new [MFA](/manual/api/reference/mfa) API with methods `mfa.create`, `mfa.update`, `mfa.get`, `mfa.delete`. #### mfa [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) Додано новий API [MFA](/manual/api/reference/mfa) з методами `mfa.create`, `mfa.update `, `mfa.get`, `mfa.delete`. ### Module example - When creating a host group, grant read permissions to configured user groups - [hg_auto_perm.zip](/../assets/en/devel/modules/examples/hg_auto_perm.zip) ### Приклад модуля - Під час створення групи хостів надайте дозволи на читання налаштованим групам користувачів - [hg_auto_perm.zip](/../assets/en/devel/modules/examples/hg_auto_perm.zip) # Module file structure All code related to a module is stored in a single directory inside the **modules** directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). # Структура файлів модуля Весь код, пов’язаний з модулем, зберігається в одному каталозі всередині каталогу **modules** вашої установки web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). ### Module file tree ````yaml 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 assets/ Any additional files to be used in views. Must be specified in manifest.json. js/ JavaScript files used in views. example.something.view.js.php css/ CSS files used in views. example.something.css image.png Images used in views. example.something.file Any file for using in views. ```` ### Дерево файлів модуля ````yaml example_module_directory/ (обов’язково) manifest.json (обов’язково) Метадані та визначення дії. Module.php Ініціалізація модуля та обробка подій. actions/ Файли управління діями. SomethingView.php SomethingCreate.php SomethingDelete.php data_export/ ExportAsXml.php ExportAsExcel.php views/ view файли. example.something.view.php example.something.delete.php assets/ Будь-які додаткові файли для використання у view. Необхідно вказати в manifest.json. js/файли JavaScript, які використовуються у view. example.something.view.js.php css/ файли CSS, які використовуються у view. example.something.css image.png Зображення, що використовуються у view. example.something.file Будь-який файл для використання у view. ```` # Modules # Модулі ##### Modules ##### Модулі ## Monitoring The Zabbix API allows you to access history and other data gathered during monitoring. ## Моніторинг Zabbix API дозволяє отримати доступ до історії та інших зібраних даних під час моніторингу. 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. 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. ### MySQL Export and import must be performed in tmux/screen to ensure that the session isn't dropped. See also: [Important notes](#important-notes) ### MySQL Експорт і імпорт потрібно виконувати в tmux/screen, щоб гарантувати, що сеанс не буде перервано. Дивіться також: [Важливі примітки](#important-notes) #### MySQL 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*.\ Relevant for at least MySQL version 5.1.61 #### MySQL Якщо значення містить символ, відмінний від ASCII, у кодуванні, відмінному від UTF8, цей символ і наступні символи буде відкинуто, коли база даних збереже це значення. На адресу не надходитимуть жодні попереджувальні повідомлення *zabbix\_server.log*.\ Актуально принаймні для версії MySQL 5.1.61 ### name Module name that will be displayed in the Administration section. *Type*: String *Example*: ```json "name": "My module" ``` ### name Назва модуля, яка буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "name": "Мій модуль" ``` ### namespace PHP namespace for module classes. *Type*: String *Example*: ```json "namespace": "ClockWidget" ``` ### namespace Простір імен PHP для класів модулів. *Тип*: String *Приклад*: ```json "namespace": "ClockWidget" ``` ## 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 JS [ ]{#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} #### Network discovery Manage network-level discovery rules to automatically find and monitor new hosts. Gain full access to information about discovered services and hosts. [Discovery rule API](/manual/api/reference/drule) | [Discovery check API](/manual/api/reference/dcheck) | [Discovered host API](/manual/api/reference/dhost) | [Discovered service API](/manual/api/reference/dservice) #### Виявлення мережі Керуйте правилами виявлення на рівні мережі для автоматичного пошуку та моніторингу нових вузлів. Отримайте повний доступ до інформації про виявлені сервіси та вузли. [API правил виявлення](/manual/api/reference/drule) | [API Перевірка виявленнь](/manual/api/reference/dcheck) | [API Виявлень вузла](/manual/api/reference/dhost) | [API Виявлень служб](/manual/api/reference/dservice) ### Notation ### Позначення ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix агент на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix proxy in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix проксі на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix server in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. Examples of running Zabbix server with command line parameters: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix сервер на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. **-T**, **--test-config** Перевірити файл конфігурації та вийти. *-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести версію і вийти. Приклади запуску сервера Zabbix з параметрами командного рядка: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний файл конфігурації *config-file* замість стандартного. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовувати альтернативний конфігураційний файл *config-file* замість стандартного. **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Вивести інформацію про версію та вийдіть. [ ]{#lbAF} #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| ## Other changes and bug fixes ### Інші зміни та виправлення помилок #### Overview By default, Zabbix provides a number of predefined themes. You may follow the step-by-step procedure provided here in order to create your own. Feel free to share the result of your work with Zabbix community if you created something nice. #### Огляд За замовчуванням Zabbix надає кілька попередньо визначених тем. Ви можете виконати наведену тут покрокову процедуру, щоб створити свій власний. Не соромтеся поділитися результатом своєї роботи зі спільнотою Zabbix, якщо ви створили щось хороше. ### Overview Custom loadable plugins extend Zabbix agent 2 functionality. They are compiled separately, but use a package shared with Zabbix agent 2. Each plugin is a *Go* package that defines the structure and implements one or several plugin interfaces (*Exporter*, *Configurator*, *Runner*). Jump to: - [Write your first plugin](/devel/plugins/how_to) - [Plugin interfaces](/devel/plugins/interfaces) See also: - [Example plugin for Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) ### Connection diagram Zabbix agent 2 connects bidirectionally to the plugins using UNIX sockets on Linux and Named Pipes on Windows. The connection diagram below illustrates the communication process between Zabbix agent 2 and a loadable plugin and the metrics collection process.  ### Огляд Користувацькі завантажувані плагіни розширюють функціональність Zabbix agent 2. Вони компілюються окремо, але використовують спільний з Zabbix agent 2 пакет. Кожен плагін — це пакет *Go*, який визначає структуру та реалізує один або кілька інтерфейсів плагіна (*Exporter*, *Configurator*, *Runner*). Перейти до: - [Напишіть свій перший плагін](/devel/plugins/how_to) - [Інтерфейси плагінів](/devel/plugins/interfaces) Дивіться також: - [Приклад плагіна для Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) ### Схема підключення Zabbix agent 2 двонаправлено підключається до плагінів за допомогою UNIX-сокетів у Linux та іменованих каналів (Named Pipes) у Windows. Наведена нижче схема з'єднання ілюструє процес зв'язку між Zabbix agent 2 і завантажуваним плагіном та процес збору метрик.  ### Overview High availability (HA) is typically required in critical infrastructures that can afford virtually no downtime. So for any service that may fail there must be a failover option in place to take over should the current service fail. Zabbix offers a **native** high-availability solution that is easy to set up and does not require any previous HA expertise. Native Zabbix HA may be useful for an extra layer of protection against software/hardware failures of Zabbix server or to have less downtime due to maintenance. In the Zabbix high availability mode multiple Zabbix servers are run as nodes in a cluster. While one Zabbix server in the cluster is active, others are on standby, ready to take over if necessary.  Switching to Zabbix HA is non-committal. You may switch back to standalone operation at any point. See also: [Implementation details](#implementation-details) ### Огляд Висока доступність (HA) зазвичай потрібна в критичних інфраструктурах, які практично не можуть дозволити собі простоїв. Тож, для будь-якого сервісу, який може вийти з ладу, має бути передбачена можливість переключення на інший ресурс, у разі відмови поточного сервісу. Zabbix пропонує **власне** рішення високої доступності, яке легко налаштувати і яке не потребує попереднього досвіду роботи з HA. Це вбудоване рішення може бути корисним як додатковий рівень захисту від програмних або апаратних збоїв сервера Zabbix або для зменшення часу простою під час технічного обслуговування. У режимі високої доступності Zabbix, кілька Zabbix серверів працюють як вузли кластеру. Поки один Zabbix сервер у кластері активний, інші знаходяться в режимі очікування і готові взяти на себе роботу, в разі потреби.  Перехід на Zabbix HA не є незворотнім. Ви можете повернутися до режиму самостійної роботи в будь-який момент. Дивіться також: [Деталі реалізації](#implementation-details) #### Overview In order to use any other language than English in Zabbix web interface, its locale should be installed on the web server. Additionally, the PHP gettext extension is required for the translations to work. #### Огляд Щоб використовувати будь-яку іншу мову, окрім англійської, у веб-інтерфейсі Zabbix, її локаль повинна бути встановлена на веб-сервері. Крім того, для роботи перекладів потрібне розширення PHP gettext. #### Overview In this section, you will learn how to log in and set up a system user in Zabbix. #### Огляд У цьому розділі ви дізнаєтесь, як увійти та налаштувати користувача системи Zabbix. #### Overview In this section you will learn how to set up a new host. A host in Zabbix is a networked entity (physical, virtual) that you wish to monitor. The definition of what can be a "host" in Zabbix is quite flexible. It can be a physical server, a network switch, a virtual machine or some application. #### Огляд У цьому розділі ви дізнаєтесь, як налаштувати новий вузол мережі. Вузол мережі у Zabbix — це мережева сутність (фізична, віртуальна), яку ви бажаєте моніторити. Визначення того, що може бути "вузлом мережі" у Zabbix, досить гнучке. Це може бути фізичний сервер, мережевий комутатор, віртуальна машина або якийсь додаток. #### Overview In this section, you will learn how to set up an item. Items are the basis of gathering data in Zabbix. Without items, there is no data - because only an item defines a single metric or what kind of data to collect from a host. #### Огляд У цьому розділі ви дізнаєтеся, як налаштувати елемент даних. Елементи даних є основою для збору даних у Zabbix. Без елементів даних немає даних, тому що лише елемент даних визначає один показник або тип даних, які потрібно збирати з вузла мережі. #### Overview In this section you will learn how to set up a template. Previously we learned how to set up an item, a trigger and how to get a problem notification for the host. While all of these steps offer a great deal of flexibility in themselves, it may appear like a lot of steps to take if needed for, say, a thousand hosts. Some automation would be handy. This is where templates come to help. Templates allow to group useful items, triggers and other entities so that those can be reused again and again by applying to hosts in a single step. When a template is linked to a host, the host inherits all entities of the template. So, basically a pre-prepared bunch of checks can be applied very quickly. #### Огляд У цьому розділі ви дізнаєтеся, як налаштувати шаблон. Раніше ми дізналися, як налаштувати елемент даних, тригер і як отримати сповіщення про проблему для вузла мережі. Хоча всі ці кроки самі по собі пропонують велику гнучкість, може здатися, що їх потрібно виконати багато, якщо це необхідно, скажімо, для тисячі вузлів мережі. Трохи автоматизації було б зручно. Тут на допомогу приходять шаблони. Шаблони дозволяють групувати корисні елементи даних, тригери та інші сутності, щоб їх можна було повторно використовувати знову і знову, застосовуючи до вузлів мережі за один крок. Коли шаблон пов’язано з вузлом мережі, вузол мережі успадковує всі сутності шаблону. Отже, в основному, заздалегідь підготовлену групу перевірок можна застосувати дуже швидко. #### Overview In this section you will learn how to set up a trigger. Items only collect data. To automatically evaluate incoming data we need to define triggers. A trigger contains an expression that defines a threshold of what is an acceptable level for the data. If that level is surpassed by the incoming data, a trigger will "fire" or go into a 'Problem' state - letting us know that something has happened that may require attention. If the level is acceptable again, trigger returns to an 'Ok' state. #### Огляд У цьому розділі ви дізнаєтесь, як налаштувати тригер. Елементи даних лише збирають дані. Щоб автоматично оцінювати вхідні дані, нам потрібно визначити тригери. Тригер містить вираз, який визначає порогове значення прийнятного рівня для даних. Якщо вхідні дані перевищують цей рівень, спрацьовує тригер, або переходить у стан 'Проблема', повідомляючи нам, що трапилося щось, що може потребувати уваги. Якщо рівень знову прийнятний, тригер повертається до стану 'OK'. #### Overview Problem events in Zabbix can be acknowledged by users. If a user gets notified about a problem event, they can go to Zabbix frontend, open the problem update popup window of that problem using one of the ways listed below and acknowledge the problem. When acknowledging, they can enter their comment for it, saying that they are working on it or whatever else they may feel like saying about it. This way, if another system user spots the same problem, they immediately see if it has been acknowledged and the comments so far. This way the workflow of resolving problems with more than one system user can take place in a coordinated way. Acknowledgment status is also used when defining [action operations](/manual/config/notifications/action/operation). You can define, for example, that a notification is sent to a higher level manager only if an event is not acknowledged for some time. To acknowledge events and comment on them, a user must have at least read permissions to the corresponding triggers. To change problem severity or close problem, a user must have read-write permissions to the corresponding triggers. There are **several** ways to access the problem update popup window, which allows acknowledging a problem. - You may select problems in *Monitoring* → *Problems* and then click on *Mass update* below the list - You can click on *Update* in the *Update* column of a problem in: - *Dashboards* (*Problems* and *Problems by severity* widgets) - *Monitoring → Problems* - *Monitoring → Problems → Event details* - You can click on an unresolved problem cell in: - *Dashboards* (*Trigger overview* widget) The popup menu contains an *Update* option that will take you to the problem update window. #### Огляд Проблемні події в Zabbix можуть бути визнані користувачами. Якщо користувач отримує сповіщення про проблему, він може перейти до інтерфейсу Zabbix, відкрити спливаюче вікно оновлення цієї проблеми одним із способів, перелічених нижче, і підтвердити проблему. Підтверджуючи, вони можуть ввести свій коментар до цього, сказавши,що вони над цим працюють, або будь-що інше, що вони можуть сказати про це. Таким чином, якщо інший користувач системи помітить ту саму проблему, він одразу побачить, чи було її підтверджено, і коментарі до цього часу. Таким чином робочий процес вирішення проблем із кількома користувачами системи може відбуватися скоординовано. Статус підтвердження також використовується під час визначення [операцій дій](/manual/config/notifications/action/operation). Ви можете визначити, наприклад, що сповіщення надсилається менеджеру вищого рівня, лише якщо подія не підтверджується протягом деякого часу. Щоб підтверджувати події та коментувати їх, користувач повинен мати принаймні дозволи на читання відповідних тригерів. Щоб змінити серйозність проблеми або закрити проблему, користувач повинен мати дозволи на читання та запис для відповідних тригерів. Існує **кілька** способів отримати доступ до спливаючого вікна оновлення проблеми, яке дозволяє підтвердити проблему. - Ви можете вибрати проблеми в *Моніторинг* → *Проблеми*, а потім натиснути *Масове оновлення* під списком - Ви можете натиснути на *Оновити* в колонці *Оновити* проблеми в: - *Дашборди* (віджети *Проблеми* та *Проблеми за ступенем серйозності*) - *Моніторинг → Проблеми* - *Моніторинг → Проблеми → Деталі події* -Ви можете натиснути на клітинку з невирішеною проблемою: - *Дашборди* (віджет *Огляд тригерів*) Спливне меню містить опцію *Оновити*, за допомогою якої ви перейдете до вікна оновлення проблеми. #### Overview Problem suppression offers a way of temporarily hiding a problem that can be dealt with later. This is useful for cleaning up the problem list in order to give the highest priority to the most urgent issues. For example, sometimes an issue may arise on the weekend that is not urgent enough to be dealt with immediately, so it can be "snoozed" until Monday morning. Problem suppression allows to hide a *single* problem, in contrast to problem suppression through host maintenance when all problems of the maintenance host are hidden. Operations for trigger actions will be paused for suppressed problems the same way as it is done with [host maintenance](/manual/maintenance). #### Огляд Приховування проблеми пропонує спосіб тимчасово приховати проблему, яка можна вирішити пізніше. Це корисно для очищення списку проблем для того, щоб надавати найвищий пріоритет найбільш актуальним питанням. Наприклад, іноді у вихідні, може виникнути проблема, яка не на стільки термінова, щоб негайно її вирішити, тому її можна "відкласти" до ранку понеділка. Приховування проблеми дозволяє приховати *окрему* проблему, на відміну від приховування через обслуговування хоста, коли всі проблеми хоста, який обслуговується, приховані. Операції для тригерних дій також буде призупинено для пригнічених проблем так, як це робиться за допомогою [обслуговування хоста](/manual/maintenance). #### Overview Some new items are automatically added for monitoring when web scenarios are created. All items inherit tags from the web scenario. #### Огляд Деякі нові елементи автоматично додаються для моніторингу під час створення веб-сценаріїв. Усі елементи успадковують теги з веб-сценарію. #### Overview Templates are [exported](/manual/xml_export_import) with many related objects and object relations. Template export contains: - Linked template groups - Linked host groups (if used in [host prototype](/manual/discovery/low_level_discovery/host_prototypes) configuration) - Template data - Linkage to other templates - Linkage to template groups - Directly linked items - Directly linked triggers - Directly linked graphs - Directly linked dashboards - Directly linked discovery rules with all prototypes - Directly linked web scenarios - Value maps #### Огляд Шаблони [експортуються](/manual/xml_export_import) із багатьма пов’язаними об’єктами та об’єктними зв’язками. Експорт шаблону містить: — Зв’язані групи шаблонів - Пов’язані групи хостів (якщо використовуються в конфігурації [прототип хоста](/manual/discovery/low_level_discovery/host_prototypes)) - Дані шаблону - Зв'язок з іншими шаблонами - Зв’язок із групами шаблонів - Безпосередньо пов'язані елементи даних - Безпосередньо пов'язані тригери - Безпосередньо пов'язані графи - Безпосередньо пов'язані інформаційні панелі - Безпосередньо пов'язані правила виявлення з усіма прототипами - Безпосередньо пов'язані веб-сценарії - Карти значень #### Overview The Monitoring menu is all about displaying data. Whatever information Zabbix is configured to gather, visualize and act upon, it will be displayed in the various sections of the Monitoring menu. #### Огляд У меню моніторингу відображаються дані. Яку б інформацію не налаштував Zabbix для збору, візуалізації та дії, вона буде відображатися в різних розділах меню моніторингу. #### Overview The Reports menu features several sections that contain a variety of predefined and user-customizable reports focused on displaying an overview of such parameters as system information, triggers and gathered data. #### Огляд Меню «Звіти» містить кілька розділів, які містять різноманітні попередньо визначені та настроювані користувачем звіти, орієнтовані на відображення огляду таких параметрів, як системна інформація, тригери та зібрані дані. #### Overview The Services menu is for the [service monitoring](/manual/it_services) functions of Zabbix. #### Огляд Меню «Сервіси» призначене для функцій [сервісного моніторингу] /manual/it_services) Zabbix. ### Overview This section allows to view and [configure](/manual/it_services/sla) SLAs. ### Огляд Цей розділ дозволяє переглядати та [налаштовувати](/manual/it_services/sla) SLA. #### Overview Zabbix supports data export in real-time in two ways: - [export to files](/manual/config/export/files) - [streaming to external systems](/manual/config/export/streaming) The following entities can be exported: - trigger events - item values - trends (export to files only) #### Огляд Zabbix підтримує експорт даних у режимі реального часу двома способами: - [експорт у файли](/manual/config/export/files) - [потокове передавання у зовнішні системи](/manual/config/export/streaming) Можна експортувати такі сутності: - події тригеру - значення елементів даних - тренди (лише експорт у файли) ### Parameters `(array)` IDs of hosts to delete. ### Параметри `(array)` ID хостів для видалення. ### Parameters `(array)` IDs of items to clear. ### Параметри `(array)` ID елементів для очищення. ### Parameters `(array)` IDs of the actions to delete. ### Параметри `(array)` Ідентифікатори дій для видалення. ### Parameters `(array)` IDs of the correlations to delete. ### Параметри `(array)` Ідентифікатори кореляцій, які потрібно видалити. ### Parameters `(array)` IDs of the dashboards to delete. ### Параметри `(array)` Ідентифікатори інформаційних панелей для видалення. ### Parameters `(array)` IDs of the discovery rules to delete. ### Параметри `(array)` ідентифікатори правил виявлення для видалення. ### Parameters `(array)` IDs of the graph prototypes to delete. ### Параметри `(масив)` ID прототипів графіків для видалення. ### Parameters `(array)` IDs of the graphs to delete. ### Параметри `(array)` ID графіків для видалення. ### Parameters `(array)` IDs of the host groups to delete. ### Параметри `(array)` ID груп хостів для видалення. ### Parameters `(array)` IDs of the host interfaces to delete. ### Параметри `(array)` ID хост-інтерфейсів для видалення. ### Parameters `(array)` IDs of the LLD rules to delete. ### Параметри `(array)` ідентифікатори правил LLD для видалення. ### Parameters `(array)` The method accepts an empty array. ### Параметри `(array)` Метод приймає порожній масив. ### Parameters `(object/array)` Actions to create. Additionally to the [standard action properties](object#action), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|[Action filter](/manual/api/reference/action/object#action_filter) object for the action.| |operations|array|[Action operations](/manual/api/reference/action/object#action_operation) to create for the action.| |recovery\_operations|array|[Action recovery operations](/manual/api/reference/action/object#action_recovery_operation) to create for the action.| |update\_operations|array|[Action update operations](/manual/api/reference/action/object#action_update_operation) to create for the action.| ### Параметри `(object/array)` Дії для створення. На додаток до [стандартних властивостей дії](object#action), метод приймає наступні параметри. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|[Дія фільтру](/manual/api/reference/action/object#action_filter) об’єкт для дії.|| |operations|array|[Дія операції](/manual/api/reference/action/object#action_operation), щоб створити для дії.| |recovery\_operations|array|[Дія операції відновлення](/manual/api/reference/action/object#action_recovery_operation), яку потрібно створити для дії.| |update\_operations|array|[Дія операції оновлення](/manual/api/reference/action/object#action_update_operation), яку потрібно створити для дії.| ### Parameters `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Параметри `(object/array)` [Властивості групи хостів](object#host_group) потрібно оновити. Властивість groupid має бути визначена для кожної групи хостів, усі інші властивості необов’язкові. Будуть оновлені лише вказані властивості, всі інші залишаться незмінними. ### Part 1: Writing the Go code In this section you will learn how to write the plugin that adds a new metric to Zabbix agent 2. 1. Create a new directory *myip* in */usr/local/zabbix/go/plugins/*. 2. Create the file *main.go* inside *myip* directory and define the name of your Go package. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main ``` ::: notetip Keep the file open to add more lines as described in the next steps. ::: 3. Specify the packages to import. These are the packages that support the plugin. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) ``` 4. Define the plugin structure. Embed the *plugin.Base* structure to gain access to the standard plugin functionality. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin ``` 5. Implement plugin interface [Export](/devel/plugins/interfaces). The Export interface performs a poll and returns a value. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error) ``` 6. Add logging. Log messages will appear in the Zabbix agent 2 log. You can use one of the logging functions available to plugins: *Critf()*, *Errf()*, *Infof()*, *Warningf()*, *Debugf()*, *Tracef()*. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) } ``` 7. Implement the core plugin logic. This logic fetches the response from the specified URL and reads it, then returns the IP address as a response and closes the request. In case of an error when executing the GET request or reading a response, the error is returned instead. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } ``` 8. Register the metric. Zabbix agent 2 initiates running *init()* function upon startup. This function will call *plugin.RegisterMetrics(structure, plugin name, metric name, description)* method to get the plugin data. The *plugin.RegisterMetrics* method parameter description: - **structure** - a pointer to plugin implementation; grants access to the plugin structure, including list of available plugin interfaces (for example, *&impl*). - **name** - plugin name; must be unique (for example, *"Myip"*). - **metric name** - metric name (for example, *"myip"*). This is the item key used to gather data from a plugin. - **description** - metric description; must start with a capital letter and end with a period (for example, *""Return the external IP address of the host where agent is running."*). ::: notetip To register several metrics, repeat the parameters **metric name** and **description** for each metric. For example: `plugin.RegisterMetrics(&impl, "Myip", "metric.one", "Metric one description.", "metric.two", "Metric two description.")` ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } ``` 9. Define the *main()* function, which will create a new plugin handler instance, assign it to be used for logging by the plugin and then execute the plugin handler. ::: noteimportant Defining the *main()* function is mandatory. ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } func main() { h, err := container.NewHandler(impl.Name()) if err != nil { panic(fmt.Sprintf("failed to create plugin handler %s", err.Error())) } impl.Logger = &h err = h.Execute() if err != nil { panic(fmt.Sprintf("failed to execute plugin handler %s", err.Error())) } } ``` ### Частина 1: Написання коду на Go У цьому розділі ви дізнаєтеся, як написати плагін, який додає нову метрику до Zabbix агента 2. 1. Створіть новий каталог *myip* в */usr/local/zabbix/go/plugins/*. 2. Створіть файл *main.go* всередині каталогу *myip* і визначте ім'я вашого Go пакету. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main ``` ::: notetip Тримайте файл відкритим, щоб додати нові рядки, як описано в наступних кроках. ::: 3. Вкажіть пакети для імпорту. Це пакети, які підтримують плагін. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) ``` 4. Визначте структуру плагіна. Додайте структуру *plugin.Base*, щоб отримати доступ до стандартного функціоналу плагіна. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin ``` 5. Реалізуйте інтерфейс плагіна [Export] (/devel/plugins/interfaces). Інтерфейс експорту виконує опитування і повертає значення. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error) ``` 6. Додайте логування. Повідомлення журналу з'являться в log файлі Zabbix Agent 2. Ви можете використовувати одну з функцій логування, доступних для плагінів: *Critf()*, *Errf()*, *Infof()*, *Warningf()*, *Debugf()*, *Tracef()*. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) } ``` 7. Реалізуйте основну логіку плагіна. Ця логіка отримує відповідь за вказаною URL-адресою і читає її, потім повертає IP-адресу як відповідь і закриває запит. У разі помилки при виконанні GET-запиту або читанні відповіді, замість неї повертається помилка. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } ``` 8. Зареєструйте метрику. Zabbix агент 2 ініціює виконання функції *init()* при запуску. Ця функція викличе метод *plugin.RegisterMetrics(structure, plugin name, metric name, description)* для отримання даних плагіна. Опис параметрів методу *plugin.RegisterMetrics*: - **structure** - вказівник на реалізацію плагіна; надає доступ до структури плагіна, включаючи список доступних інтерфейсів плагіна (наприклад, *&impl*) .- **name** - назва плагіна; має бути унікальною (наприклад, *"Myip "*). - **metric name** - назва метрики (наприклад, *"myip "*). Це ключ елемента, який використовується для збору даних з плагіна. - **description** - опис метрики; має починатися з великої літери і закінчуватися крапкою (наприклад, *""Return the external IP address of the host where agent is running."*). :: notetip Щоб зареєструвати кілька метрик, повторіть параметри **metric name** та **description** для кожної метрики. Наприклад: `plugin.RegisterMetrics(&impl, "Myip", "metric.one", "Опис першої метрики.", "metric.two", "Опис другої метрики.")`. ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } ``` 9. Визначте функцію *main()*, яка створить новий екземпляр обробника плагіна, призначить його для ведення журналу плагіном, а потім виконає обробник плагіна. ::: noteimportant Визначення функції *main()* є обов'язковим. ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } func main() { h, err := container.NewHandler(impl.Name()) if err != nil { panic(fmt.Sprintf("failed to create plugin handler %s", err.Error())) } impl.Logger = &h err = h.Execute() if err != nil { panic(fmt.Sprintf("failed to execute plugin handler %s", err.Error())) } } ``` ### Part 2: Building the plugin In this section you will learn how to compile the plugin. 1. To create Go files for dependency handling and download the dependencies automatically execute this bash script from the CLI. ```bash go mod init myip GOPROXY=direct go get git.zabbix.com/ap/plugin-support/plugin@branchname go mod tidy go build ``` **Make sure** to specify the correct branch name, i.e. replace `branchname` (see Line 2) with one of the following: - `release/*` - for the stable release branch, where "\*" is the release version (i.e. `7.0`) - `master` - for the master branch - `<commit hash>` - for the specific commit version (use the specific commit hash) The output should be similar to this: ```go go: creating new go.mod: module myip go: to add module requirements and sums: go mod tidy go: finding module for package git.zabbix.com/ap/plugin-support/plugin/container go: finding module for package git.zabbix.com/ap/plugin-support/plugin go: found git.zabbix.com/ap/plugin-support/plugin in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 go: found git.zabbix.com/ap/plugin-support/plugin/container in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 ``` 2. Create an executable *myip* for the loadable plugin. 3. Specify the path to the plugin configuration file in the *Plugins.Myip.System.Path* parameter of Zabbix agent 2 configuration file. ::: noteimportant Plugin name in the configuration parameter name (*Myip* in this tutorial) must match the plugin name defined in the *plugin.RegisterMetrics()* function. ::: ```bash echo 'Plugins.Myip.System.Path=/usr/local/zabbix/go/plugins/myip/myip' > /etc/zabbix_agent2.d/plugins.d/myip.conf ``` 4. Test the metric: ```bash zabbix_agent2 -t myip ``` The response should contain an external IP address of your host. ::: notetip In case of an error, check whether the user *zabbix* has permissions to access */usr/local/zabbix/go/plugins/myip* directory. ::: ### Частина 2: Створення плагіна У цьому розділі ви дізнаєтеся, як скомпілювати плагін. 1. Щоб створити файли Go для обробки залежностей і автоматично завантажити залежності, виконайте цей сценарій bash із CLI. ```bash go mod init myip GOPROXY=direct go get git.zabbix.com/ap/plugin-support/plugin@branchname go mod tidy go build ``` **Переконайтеся**, що вказали правильну назву гілки, тобто замініть `branchname` (див. рядок 2) на одне з наступного: - `release/*` - для гілки стабільного релізу, де "\*" є версією релізу (тобто `7.0`) - `master` - для головної гілки - `<commit hash>` - для конкретної версії коміту (використовуйте спеціальний хеш коміту) Результат має бути подібним до цього: ```go go: creating new go.mod: module myip go: to add module requirements and sums: go mod tidy go: finding module for package git.zabbix.com/ap/plugin-support/plugin/container go: finding module for package git.zabbix.com/ap/plugin-support/plugin go: found git.zabbix.com/ap/plugin-support/plugin in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 go: found git.zabbix.com/ap/plugin-support/plugin/container in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 ``` 2. Створіть виконуваний файл *myip* для завантажуваного плагіна. 3. Вкажіть шлях до файлу конфігурації плагіна в параметрі *Plugins.Myip.System.Path* файлу конфігурації Zabbix agent 2. ::: noteimportant Ім’я плагіна в назві параметра конфігурації (*Myip* у цьому підручнику) має відповідати імені плагіна, визначеному у функції *plugin.RegisterMetrics()*. ::: ```bash echo 'Plugins.Myip.System.Path=/usr/local/zabbix/go/plugins/myip/myip' > /etc/zabbix_agent2.d/plugins.d/myip.conf ``` 4. Протестуйте метрику ```bash zabbix_agent2 -t myip ``` Відповідь має містити зовнішню IP-адресу вашого хосту. ::: notetip У разі помилки перевірте, чи має користувач *zabbix* права доступу до каталогу */usr/local/zabbix/go/plugins/myip*. ::: ## Part I - "Hello, world!" In this section you will learn how to create the minimum required widget elements and add a new widget to Zabbix frontend. ## Частина I - "Hello, world!" У цьому розділі ви дізнаєтесь, як створити мінімально необхідні елементи віджета та додати новий віджет до інтерфейсу Zabbix. ## Part II - Gauge chart ## Частина II - Калібрувальна діаграма (Gauge chart) ### Part III - Module action An action is implemented in two files - *actions/MyAddress.php* and *views/my.address.php*. The ***actions/MyAddress.php*** file takes care of the business logic implementation, while the ***views/my.address.php*** file is responsible for the view. 1. Create a directory *actions* in the *MyAddress* directory. 2. Create a *MyAddress.php* file in the *actions* directory. The action logic will be defined in the *MyAddress* class. This action class will implement four functions: *init()*, *checkInput()*, *checkPermissions()*, and *doAction()*. Zabbix frontend calls the *doAction()* function when the action is requested. This function is responsible for the business logic of the module. ::: noteimportant The data must be organized as an associative array. The array can be multidimensional and may contain any data expected by the view. ::: **ui/modules/MyAddress/actions/MyAddress.php** ```php <?php namespace Modules\MyAddress\Actions; use CController, CControllerResponseData; class MyAddress extends CController { public function init(): void { $this->disableCsrfValidation(); } protected function checkInput(): bool { return true; } protected function checkPermissions(): bool { return true; } protected function doAction(): void { $data = ['my-ip' => file_get_contents("https://api.seeip.org")]; $response = new CControllerResponseData($data); $this->setResponse($response); } } ``` 3. Create a new directory *views* in the *MyAddress* directory. 4. Create a *my.address.php* file in the *views* directory and define the module view. Note that the variable `$data` is available in the view without specifically defining it. The framework automatically passes the associative array to the view. **ui/modules/MyAddress/views/my.address.php** ```php <?php (new CHtmlPage()) ->setTitle(_('The HTML Title of My Address Page')) ->addItem(new CDiv($data['my-ip'])) ->show(); ``` 5. The module action has to be registered in the *manifest.json* file. Open *manifest.json* and add a new object `actions` that contains: - the action key with the action name written in lowercase (a-z) and with words separated by dots (for example, `my.address`); - the action class name (`MyAddress`) as a value for the `class` key of the `my.address` object; - the action view name (`my.address`) as a value for the `view` key of the `my.address` object. **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "My External IP Address.", "actions": { "my.address": { "class": "MyAddress", "view": "my.address" } } } ``` 6. Refresh Zabbix frontend. Click on *My address → External IP* to see the IP address of your computer. {width="600"} ### Частина III - Дія модуля Дія реалізована в двох файлах - *actions/MyAddress.php* і *views/my.address.php*. Файл ***actions/MyAddress.php*** відповідає за реалізацію бізнес-логіки, тоді як файл ***views/my.address.php*** відповідає за зовнішній вигляд. 1. Створіть каталог *actions* у каталозі *MyAddress*. 2. Створіть файл *MyAddress.php* у каталозі *actions*. Логіка дій буде визначена в класі *MyAddress*. Цей клас дій реалізує чотири функції: *init()*, *checkInput()*, *checkPermissions()* і *doAction()*. Фронтенд Zabbix запускає функцію *doAction()*, коли викликається дія. Ця функція відповідає за бізнес-логіку модуля. ::: noteimportant Дані повинні бути організовані як асоціативний масив. Масив може бути багатовимірним і може містити будь-які дані, які очікує view. ::: **ui/modules/MyAddress/actions/MyAddress.php** ```php <?php namespace Modules\MyAddress\Actions; use CController, CControllerResponseData; class MyAddress extends CController { public function init(): void { $this->disableCsrfValidation(); } protected function checkInput(): bool { return true; } protected function checkPermissions(): bool { return true; } protected function doAction(): void { $data = ['my-ip' => file_get_contents("https://api.seeip.org")]; $response = new CControllerResponseData($data); $this->setResponse($response); } } ``` 3. Створіть новий каталог *views* у каталозі *MyAddress*. 4. Створіть файл *my.address.php* у каталозі *views* і визначте вигляд модуля. Зауважте, що змінна `$data` доступна у view без її спеціального визначення. Фреймворк автоматично передає асоціативний масив у view. **ui/modules/MyAddress/views/my.address.php** ```php <?php (new CHtmlPage()) ->setTitle(_('The HTML Title of My Address Page')) ->addItem(new CDiv($data['my-ip'])) ->show(); ``` 5. Дія модуля має бути зареєстрована у файлі *manifest.json*. Відкрийте *manifest.json* і додайте новий об’єкт «actions», який містить: - ключ дії з назвою дії, написаною малими літерами (a-z) і словами, розділеними крапками (наприклад, `my.address`); - ім'я класу дії (`MyAddress`) як значення для ключа `class` об'єкта `my.address`; - ім'я для view дії (`my.address`) як значення для ключа `view` об'єкта `my.address`. **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "My External IP Address", "actions": { "my.address": { "class": "MyAddress", "view": "my.address" } } } ``` 6. Оновіть інтерфейс Zabbix. Натисніть на розділ меню *Моя адреса → Зовнішня IP-адреса*, щоб побачити IP-адресу вашого комп’ютера. {width="600"} ### Part II - Menu section location change In this part, you will move the *My Address* menu section to the *Monitoring* section and then add a nested menu to it. As a result, users will be able to access two sub-menu pages from the *Monitoring → My Address* menu section. 1. Open and edit the *Module.php* file. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setAction('userprofile.edit') ); } } ``` 2. Refresh Zabbix frontend. Expand the *Monitoring* menu section and observe that the *My address* section is now located below the *Discovery* section. {width="600"} 3. To add nested pages to the *My Address* menu section, open and edit the *Module.php* file again. This step creates two subsections: - *External IP* that executes a new 'my.address' action that will be defined in the next steps; - *User profile* that executes the predefined 'userprofile.edit' action to open the *User profile* page. Note that for the nested menu, you need to use the *CMenu* class in addition to the classes used in the previous steps. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenu, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setSubMenu( new CMenu([ (new CMenuItem(_('External IP')))->setAction('my.address'), (new CMenuItem(_('User profile')))->setAction('userprofile.edit') ]) ) ); } } ``` 4. Refresh Zabbix frontend. Observe that the *My address* menu section now contains a third-level menu with two pages - *External IP* and *User profile*. {width="600"} ### Частина II - Зміна розташування розділу меню У цій частині ви перемістите розділ меню *Моя адреса* в розділ *Моніторинг* і потім додасте до нього вкладене меню. У результаті користувачі матимуть доступ до двох сторінок підменю з розділу меню *Моніторинг → Моя адреса*. 1. Відкрийте та відредагуйте файл *Module.php*. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setAction('userprofile.edit') ); } } ``` 2. Оновіть інтерфейс Zabbix. Розгорніть розділ меню *Моніторинг* і зверніть увагу, що розділ *Моя адреса* тепер розташований під розділом *Виявлення*. {width="600"} 3. Щоб додати вкладені сторінки до розділу меню *Моя адреса*, знову відкрийте та відредагуйте файл *Module.php*. Цей крок створює два підрозділи: - *Зовнішня IP-адреса*, який виконує нову дію «my.address», яка буде визначена в наступних кроках; - *Профіль користувача*, який виконує попередньо визначену дію «userprofile.edit», щоб відкрити сторінку *Профіль користувача*. Зауважте, що для вкладеного меню вам потрібно використовувати клас *CMenu* на додаток до класів, використаних у попередніх кроках. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenu, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setSubMenu( new CMenu([ (new CMenuItem(_('External IP')))->setAction('my.address'), (new CMenuItem(_('User profile')))->setAction('userprofile.edit') ]) ) ); } } ``` 4. Оновіть інтерфейс Zabbix. Зверніть увагу, що розділ меню *Моя адреса* тепер містить меню третього рівня з двома сторінками - *Зовнішня IP-адреса* та *Профіль користувача*. {width="600"} ### Part I - New menu section ### Частина I - Новий розділ меню ### plugin.Configurator *Configurator* interface provides plugin configuration parameters from Zabbix agent 2 configuration files. ### plugin.Configurator Інтерфейс *Configurator* надає параметри конфігурації плагіна з конфігураційних файлів Zabbix agent 2. ### plugin.Exporter *Exporter* is the simplest interface that performs a poll and returns a value (values), nothing, or error. It accepts a preparsed item key, parameters, and context. Access to all other plugin interfaces is exclusive and no method can be called if a plugin is already performing a task. Also, there is a limit of 100 maximum concurrent *Export()* calls per plugin, which can be reduced according to the requirements for each plugin. ### plugin.Exporter *Exporter* — це найпростіший інтерфейс, який виконує опитування та повертає значення (або кілька значень), нічого або помилку. Він приймає підготовлений ключ елемента даних, параметри та контекст. Доступ до всіх інших інтерфейсів плагінів є ексклюзивним, і жоден метод не може бути викликаний, якщо плагін уже виконує завдання. Крім того, існує обмеження в 100 одночасних викликів *Export()* для одного плагіна, яке можна зменшити відповідно до вимог для кожного плагіна. # Plugin interfaces This section describes available plugin interfaces. # Інтерфейси плагінів У цьому розділі описано доступні інтерфейси плагінів. ### plugin.Runner *Runner* interface provides the means for performing initialization when a plugin is started (activated) and deinitialization when a plugin is stopped (deactivated). For example, a plugin can start/stop some background *goroutine* by implementing the Runner interface. ### plugin.Runner Інтерфейс *Runner* надає засоби для виконання ініціалізації, коли плагін запущено (активовано), і деініціалізації, коли плагін зупинено (дезактивовано). Наприклад, плагін може запускати/зупиняти деяку фонову *goroutine* шляхом реалізації інтерфейсу Runner. # Plugins # Плагіни #### PostgreSQL If a value contains a non-ASCII character in non UTF8 encoding - this will lead to a failed SQL query (PGRES\_FATAL\_ERROR:ERROR invalid byte sequence for encoding) and data will not be stored. An appropriate warning message will be written to the *zabbix\_server.log*.\ Relevant for at least PostgreSQL version 9.1.3 #### PostgreSQL Якщо значення містить символ, відмінний від ASCII, у кодуванні, відмінному від UTF8, це призведе до помилки SQL-запиту (PGRES\_FATAL\_ERROR:ERROR недійсна послідовність байтів для кодування), і дані не будуть збережені. Відповідне попередження буде записано в *zabbix\_server.log*.\ Актуально принаймні для PostgreSQL версії 9.1.3 ##### Preparing frontend Make sure that Zabbix server address:port is **not defined** in the frontend configuration (found in `conf/zabbix.conf.php` of the frontend files directory). {width="600"} Zabbix frontend will autodetect the active node by reading settings from the nodes table in Zabbix database. Node address of the active node will be used as the Zabbix server address. ##### Підготовка web-інтерфейсу Переконайтеся, що в конфігураційному файлі web-інтерфейсу ( знаходиться у `conf/zabbix.conf.php` в директорії з файлами веб-інтерфейсу) **не вказано** адреса:порт Zabbix сервера. {width="600"} Web-інтерфейс Zabbix автоматично визначить активний вузол, зчитавши налаштування з таблиці вузлів у базі даних Zabbix. Адреса активного вузла буде використана як адреса Zabbix сервера. ## Pre-requisites Before proceeding make sure, that: - The module is located inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). - The module has at least a basic version of [manifest.json](/devel/modules/file_structure/manifest) file. - You have access to the Administration menu section in Zabbix (requires Super admin user role type). :::notetip The frontend will not install or even recognize incompatible modules. ::: ## Необхідні умови Перш ніж продовжити, переконайтеся, що: - Модуль знаходиться в каталозі *modules* вашої інсталяції web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). - Модуль має принаймні базову версію файлу [manifest.json](/devel/modules/file_structure/manifest). - Ви маєте доступ до розділу меню «Адміністрування» в Zabbix (потрібна роль суперадміністратора). :::notetip Інтерфейс не встановить і навіть не розпізнає несумісні модулі. ::: ##### Presentation modification methods The widget presentation modification methods are responsible for modifying widget appearance. ##### Методи модифікації презентації Методи модифікації представлення віджетів відповідають за зміну зовнішнього вигляду віджетів. # Presentation This page describes the components that can be used to create a widget presentation view. The widget presentation view is the part of the widget that receives the data according to its [configuration](/configuration) and displays it on the dashboard in a container. The presentation view consists of three parts: - [Widget action](#widget-action) - [Widget view](#widget-view) - [JavaScript](#javascript) # Презентація Ця сторінка описує компоненти, які можуть бути використані для створення представлення віджету. Представлення віджету - це частина віджету, яка отримує дані відповідно до його [конфігурації](/configuration) і відображає їх на інформаційній панелі в контейнері. Вид презентації складається з трьох частин: - [Action віджета](#widget-action) - [View віджетів](#widget-view) - [JavaScript](#javascript) #### Problems Retrieve problems according to the given parameters. [Problem API](/manual/api/reference/problem) #### Проблеми Отримати проблеми за заданими параметрами. [API проблеми](/manual/api/reference/problem) #### problem [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299), [ZBX-23240](https://support.zabbix.com/browse/ZBX-23240) `problem.get`: Added new parameters `action` and `action_userids`.\ #### problem [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299), [ZBX-23240](https://support.zabbix.com/browse/ZBX-23240) `problem.get` : Додано нові параметри `action` і `action_userids`.\ #### problem [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `problem.get`: Added strict validation of the method parameters.\ #### problem [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `problem.get`: додано сувору перевірку параметрів методу.\ ##### Protection against brute force attacks In case of five consecutive failed login attempts, Zabbix interface will pause for 30 seconds in order to prevent brute force and dictionary attacks. The IP address of a failed login attempt will be displayed after a successful login. ##### Захист від атак перебором У разі п’яти послідовних невдалих спроб входу інтерфейс Zabbix призупиняється на 30 секунд, щоб запобігти атакам перебору та словниковим атакам. IP-адреса невдалої спроби входу буде відображена після успішного входу. #### Proxies and proxy groups Manage the proxies used in your distributed monitoring setup. [Proxy API](/manual/api/reference/proxy) | [Proxy group API](/manual/api/reference/proxygroup) #### Проксі та групи проксі Керуйте проксі-серверами, які використовуються в налаштуваннях розподіленого моніторингу. [API проксі](/manual/api/reference/proxy) | [API групи проксі](/manual/api/reference/proxygroup) ##### Proxy configuration HA cluster nodes (servers) must be listed in the configuration of either passive or active Zabbix proxy. For a passive proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **comma**. ``` Server=zabbix-node-01,zabbix-node-02 ``` For an active proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **semicolon**. ``` Server=zabbix-node-01;zabbix-node-02 ``` ##### Конфігурація проксі Вузли (сервери) кластера HA повинні бути вказані в конфігурації пасивного або активного Zabbix проксі. Для пасивного проксі імена вузлів кластеру мають бути вказані в [параметрі](/manual/appendix/config/zabbix_proxy) Server і розділені **комою**. ``` Server=zabbix-node-01,zabbix-node-02 ``` Для активного проксі імена вузлів кластеру мають бути вказані в [параметрі](/manual/appendix/config/zabbix_proxy) Server і розділені **крапкою з комою**. ``` Server=zabbix-node-01;zabbix-node-02 ``` #### proxygroup [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) Added new [proxygroup](/manual/api/reference/proxygroup) API.\ #### proxygroup [ZBXNEXT-8758](https://support.zabbix.com/browse/ZBXNEXT-8758) Додано новий API [proxygroup](/manual/api/reference/proxygroup).\ #### proxy [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Removed `interface` and `auto_compress` object properties.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Added `address` and `port` properties for passive Zabbix Proxies.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Renamed properties `host` to `name`, `status` to `operating_mode`, `proxy_address` to `allowed_addresses`.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Changed `operating_mode` (previously - `status`) property values (0 - active proxy, 1 - passive proxy) .\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) `proxy.get`: Removed support for parameter `selectInterface`.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) `proxy.create` and `proxy.update`: Removed support for parameter `interface`.\ #### proxy [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Видалено властивості об’єктів `interface` і `auto_compress`.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Додано властивості `address` і `port` для пасивних проксі Zabbix.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Перейменовано властивості `host` на `name`, `status` на `operating_mode`, `proxy_address` на `allowed_addresses`.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Змінено значення властивостей `operating_mode` (раніше — `status`) (0 — активний проксі, 1 — пасивний проксі) .\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) `proxy.get`: вилучено підтримку параметра `selectInterface`.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) `proxy.create` і `proxy.update`: вилучено підтримку параметра `interface`.\ # Register a new module This section explains how to add a new module to Zabbix frontend. # Реєстрація нового модуля У цьому розділі пояснюється, як додати новий модуль до інтерфейсу Zabbix. ### Report The filter allows to select the report based on the SLA name as well as the service name. It is also possible to limit the displayed period. {width="600"} Each column (period) displays the SLI for that period. SLIs that are in breach of the set SLO are highlighted in red. 20 periods are displayed in the report. A maximum of 100 periods can be displayed, if both the *From* date and *To* date are specified. ### Звіт Фільтр дозволяє вибрати звіт на основі назви SLA, а також назви служби. Також можна обмежити відображуваний період. {width="600"} Кожен стовпець (період) відображає SLI для цього періоду. SLI, які порушують встановлений SLO, виділені червоним кольором. У звіті відображається 20 періодів. Можна відобразити максимум 100 періодів, якщо вказано обидві дати *Від* і *До*. #### Retrieve discovery actions Retrieve all configured discovery actions together with action conditions and operations. The filter uses the "and" evaluation type, so the `formula` property is empty and `eval_formula` is generated automatically. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 1 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "2", "name": "Auto discovery. Linux servers.", "eventsource": "1", "status": "1", "esc_period": "0s", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "conditiontype": "10", "operator": "0", "value": "0", "value2": "", "formulaid": "B" }, { "conditiontype": "8", "operator": "0", "value": "9", "value2": "", "formulaid": "C" }, { "conditiontype": "12", "operator": "2", "value": "Linux", "value2": "", "formulaid": "A" } ], "eval_formula": "A and B and C" }, "operations": [ { "operationid": "1", "actionid": "2", "operationtype": "6", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "optemplate": [ { "templateid": "10001" } ] }, { "operationid": "2", "actionid": "2", "operationtype": "4", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opgroup": [ { "groupid": "2" } ] } ] } ], "id": 1 } ``` #### Отримати дії виявлення Отримати всі налаштовані дії виявлення разом із умовами дій та операціями. Фільтр використовує тип оцінки "and", тому властивість `formula` порожня, а `eval_formula` генерується автоматично. [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 1 } }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "2", "name": "Auto discovery. Linux servers.", "eventsource": "1", "status": "1", "esc_period": "0s", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "conditiontype": "10", "operator": "0", "value": "0", "value2": "", "formulaid": "B" }, { "conditiontype": "8", "operator": "0", "value": "9", "value2": "", "formulaid": "C" }, { "conditiontype": "12", "operator": "2", "value": "Linux", "value2": "", "formulaid": "A" } ], "eval_formula": "A and B and C" }, "operations": [ { "operationid": "1", "actionid": "2", "operationtype": "6", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "optemplate": [ { "templateid": "10001" } ] }, { "operationid": "2", "actionid": "2", "operationtype": "4", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opgroup": [ { "groupid": "2" } ] } ] } ], "id": 1 } ``` #### Retrieve trigger actions Retrieve all configured trigger actions together with action conditions and operations. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectRecoveryOperations": "extend", "selectUpdateOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 0 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "3", "name": "Report problems to Zabbix administrators", "eventsource": "0", "status": "1", "esc_period": "1h", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [], "eval_formula": "" }, "operations": [ { "operationid": "3", "actionid": "3", "operationtype": "0", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opmessage": [ { "default_msg": "1", "subject": "", "message": "", "mediatypeid" => "0" } ], "opmessage_grp": [ { "usrgrpid": "7" } ] } ], "recovery_operations": [ { "operationid": "7", "actionid": "3", "operationtype": "11", "evaltype": "0", "opconditions": [], "opmessage": { "default_msg": "0", "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}", "message": "Trigger: {TRIGGER.NAME}\r\nTrigger status: {TRIGGER.STATUS}\r\nTrigger severity: {TRIGGER.SEVERITY}\r\nTrigger URL: {TRIGGER.URL}\r\n\r\nItem values:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n\r\nOriginal event ID: {EVENT.ID}", "mediatypeid": "0" } } ], "update_operations": [ { "operationid": "31", "operationtype": "12", "evaltype": "0", "opmessage": { "default_msg": "1", "subject": "", "message": "", "mediatypeid": "0" } }, { "operationid": "32", "operationtype": "0", "evaltype": "0", "opmessage": { "default_msg": "0", "subject": "Updated: {TRIGGER.NAME}", "message": "{USER.FULLNAME} updated problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} with the following message:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nCurrent problem status is {EVENT.STATUS}", "mediatypeid": "1" }, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage_usr": [] }, { "operationid": "33", "operationtype": "1", "evaltype": "0", "opcommand": { "scriptid": "3" }, "opcommand_hst": [ { "hostid": "10084" } ], "opcommand_grp": [] } ] } ], "id": 1 } ``` #### Отримати тригерні дії Отримати всі налаштовані тригерні дії разом із умовами дії та операціями. [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectRecoveryOperations": "extend", "selectUpdateOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 0 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "3", "name": "Report problems to Zabbix administrators", "eventsource": "0", "status": "1", "esc_period": "1h", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [], "eval_formula": "" }, "operations": [ { "operationid": "3", "actionid": "3", "operationtype": "0", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opmessage": [ { "default_msg": "1", "subject": "", "message": "", "mediatypeid" => "0" } ], "opmessage_grp": [ { "usrgrpid": "7" } ] } ], "recovery_operations": [ { "operationid": "7", "actionid": "3", "operationtype": "11", "evaltype": "0", "opconditions": [], "opmessage": { "default_msg": "0", "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}", "message": "Trigger: {TRIGGER.NAME}\r\nTrigger status: {TRIGGER.STATUS}\r\nTrigger severity: {TRIGGER.SEVERITY}\r\nTrigger URL: {TRIGGER.URL}\r\n\r\nItem values:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n\r\nOriginal event ID: {EVENT.ID}", "mediatypeid": "0" } } ], "update_operations": [ { "operationid": "31", "operationtype": "12", "evaltype": "0", "opmessage": { "default_msg": "1", "subject": "", "message": "", "mediatypeid": "0" } }, { "operationid": "32", "operationtype": "0", "evaltype": "0", "opmessage": { "default_msg": "0", "subject": "Updated: {TRIGGER.NAME}", "message": "{USER.FULLNAME} updated problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} with the following message:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nCurrent problem status is {EVENT.STATUS}", "mediatypeid": "1" }, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage_usr": [] }, { "operationid": "33", "operationtype": "1", "evaltype": "0", "opcommand": { "scriptid": "3" }, "opcommand_hst": [ { "hostid": "10084" } ], "opcommand_grp": [] } ] } ], "id": 1 } ``` ### Return values `(array)` Returns an array with changes in configuration, that will be made. ### Повернуті значення `(array)` Повертає масив зі змінами в конфігурації, які будуть внесені. ### Return values `(boolean )` Returns boolean true as result on successful update. ### Повернуті значення `(boolean )` Повертає логічне значення true як результат успішного оновлення. ### Return values `(boolean)` Returns `true` if importing has been successful. ### Повернуті значення `(boolean)` Повертає `true`, якщо імпортування було успішним. ### Return values `(boolean)` Returns `true` if the copying was successful. ### Повернуті значення `(boolean)` Повертає `true`, якщо копіювання було успішним. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори очищених елементів у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the created actions under the `actionids` property. The order of the returned IDs matches the order of the passed actions. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених дій у властивості `actionids`. Порядок повернених ідентифікаторів відповідає порядку виконаних дій. ### Return values `(object)` Returns an object containing the IDs of the created correlations under the `correlationids` property. The order of the returned IDs matches the order of the passed correlations. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених кореляцій у властивості `correlationids`. Порядок повернених ідентифікаторів відповідає порядку переданих кореляцій. ### Return values `(object)` Returns an object containing the IDs of the created dashboards under the `dashboardids` property. The order of the returned IDs matches the order of the passed dashboards. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інформаційних панелей у властивості `dashboardids`. Порядок повернених ідентифікаторів відповідає порядку переданих інформаційних панелей. ### Return values `(object)` Returns an object containing the IDs of the created discovery rules under the `druleids` property. The order of the returned IDs matches the order of the passed discovery rules. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених правил виявлення у властивості `druleids`. Порядок повернених ідентифікаторів відповідає порядку переданих правил виявлення. ### Return values `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених прототипів графів у властивості `graphids`. Порядок повернених ідентифікаторів відповідає порядку переданих прототипів графів. ### Return values `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених графіків у властивості `graphids`. Порядок повернених ідентифікаторів відповідає порядку переданих графіків. ### Return values `(object)` Returns an object containing the IDs of the created host groups under the `groupids` property. The order of the returned IDs matches the order of the passed host groups. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених груп хостів у властивості `groupids`. Порядок повернених ідентифікаторів відповідає порядку переданих груп хостів. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених хост-інтерфейсів у властивості `interfaceids`. Порядок повернених ідентифікаторів відповідає порядку переданих інтерфейсів хоста. ### Return values `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених прототипів хостів у властивості `hostids`. Порядок повернутих ідентифікаторів відповідає порядку переданих прототипів хосту. ### Return values `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених хостів у властивості `hostids`. Порядок повернених ідентифікаторів відповідає порядку переданих хостів. ### Return values `(object)` Returns an object containing the IDs of the created LLD rules under the `itemids` property. The order of the returned IDs matches the order of the passed LLD rules. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених правил LLD у властивості `itemids`. Порядок повернених ідентифікаторів відповідає порядку переданих правил LLD. ### Return values `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених веб-сценаріїв у властивості `httptestids`. Порядок повернених ідентифікаторів відповідає порядку переданих веб-сценаріїв. ### Return values `(object)` Returns an object containing the IDs of the deleted actions under the `actionids` property. ### Повернуті значення `(object)` повертає об’єкт, що містить ідентифікатори видалених дій у властивості `actionids`. ### Return values `(object)` Returns an object containing the IDs of the deleted correlations under the `correlationids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених кореляцій у властивості `correlationids`. ### Return values `(object)` Returns an object containing the IDs of the deleted dashboards under the `dashboardids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інформаційних панелей у властивості `dashboardids`. ### Return values `(object)` Returns an object containing the IDs of the deleted discovery rules under the `druleids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених правил виявлення у властивості `druleids`. ### Return values `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених прототипів графів у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених графіків у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the deleted items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених елементів даних у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the updated actions under the `actionids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених дій у властивості `actionids`. ### Return values `(object)` Returns an object containing the IDs of the updated correlations under the `correlationids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених кореляцій у властивості `correlationids`. ### Return values `(object)` Returns an object containing the IDs of the updated dashboards under the `dashboardids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених інформаційних панелей у властивості `dashboardids`. ### Return values `(object)` Returns an object containing the IDs of the updated discovery rules under the `druleids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених правил виявлення у властивості `druleids`. ### Return values `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених подій у властивості `eventids`. ### Return values `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених прототипів графів у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених графіків у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених елементів даних у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the updated LLD rules under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених правил LLD у властивості `itemids`. ### Return values `(object)` Returns authentication object. ### Повернуті значення `(object)` Повертає об'єкт автентифікації. ### Return values `(object)` Returns autoregistration object. ### Повернуті значення `(object)` Повертає об'єкт автореєстрації. ### Return values `(object)` Returns housekeeping object. ### Повернуті значення `(object)` Повертає об'єкт господарювання. ### Return values `(string)` Returns a serialized string containing the requested configuration data. ### Повернуті значення `(string)` Повертає серіалізований рядок, що містить запитувані дані конфігурації. ### Return values `(string)` Returns the version of the Zabbix API. ::: notetip Starting from Zabbix 2.0.4 the version of the API matches the version of Zabbix. ::: ### Повернуті значення `(string)` Повертає версію Zabbix API. ::: notetip Починаючи з Zabbix 2.0.4 версія API відповідає версії Zabbix. ::: ### Runtime control options **config\_cache\_reload** Reload configuration cache. Ignored if cache is being currently loaded. Active Zabbix proxy will connect to the Zabbix server and request configuration data. Default configuration file (unless **-c** option is specified) will be used to find PID file and signal will be sent to process, listed in PID file. **snmp\_cache\_reload** Reload SNMP cache. **housekeeper\_execute** Execute the housekeeper. Ignored if housekeeper is being currently executed. **diaginfo**\[=*section*\] Log internal diagnostic information of the specified section. Section can be *historycache*, *preprocessing*, *locks*. By default diagnostic information of all sections is logged. **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} ### Параметри runtime-option **config\_cache\_reload** Перезавантажити кеш конфігурації. Ігнорується, якщо зараз завантажується кеш. Активний проксі-сервер Zabbix підключатиметься до сервера Zabbix і запитуватиме конфігураційні дані. Файл конфігурації за замовчуванням (якщо не вказано параметр **-c**) використовуватиметься для пошуку файлу PID, а сигнал буде надіслано до процесу, зазначеного у файлі PID. **snmp\_cache\_reload** Перезавантажте кеш SNMP. **housekeeper\_execute** Стратити економку. Ігнорується, якщо зараз працює економка виконано. **diaginfo**\[=*section*\] Реєстрація внутрішньої діагностичної інформації вказаного розділу. Розділ може бути *historycache*, *preprocessing*, *locks*. За замовчуванням реєструється діагностична інформація всіх розділів. **log\_level\_increase**\[=*target*\] Підвищити рівень журналу, впливає на всі процеси, якщо ціль не вказано. **log\_level\_decrease**\[=*target*\] Зниження рівня журналу, впливає на всі процеси, якщо ціль не вказано. [ ]{#lbAG} #### Runtime control options: **userparameter_reload** Reload user parameters from the configuration file **log_level_increase** Increase log level **log_level_decrease** Decrease log level **help** List available runtime control options **metrics** List available metrics **version** Display version **-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. **-v**, **--verbose** Enable verbose output when test item or print known items. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} #### Параметри контролю виконання: **userparameter reload** Перезавантаження параметрів користувача з файлу конфігурації **loglevel increase** Підвищити рівень журналу **loglevel decrease** Зменшити рівень журналу **help** Список доступних параметрів керування часом виконання **metrics** Список доступних показників **version** Показати версію **-p**, **--print** Роздрукувати відомі елементи та вийти. Для кожного елемента використовуються або загальні параметри за замовчуванням, або надаються спеціальні параметри за замовчуванням для тестування. Ці значення за замовчуванням наведено в квадратних дужках як ключові параметри елемента. Повернуті значення береться в квадратні дужки та має префікс типу повернутого значення, розділених вертикальною рискою. Тип параметрів користувача завжди **t**, оскільки агент не може визначити всі можливі значення, що повертаються. Елементи, які відображаються як робочі, не гарантують роботу на сервері Zabbix або zabbix\_get під час запиту до запущеного демона агента, оскільки дозволи або середовище можуть відрізнятися. Типи повернених значень: d Число з десятковою частиною. m Не підтримується. Це може бути викликано запитом до елемента, який працює лише в активному режимі, як-от елемент моніторингу журналу, або елемент, який вимагає кількох зібраних значень. Проблеми з дозволом або неправильні параметри користувача також можуть призвести до непідтримуваного стану. s Текст. Максимальна довжина не обмежена. t Текст. Те саме, що **s**. u Ціле число без знака. \ **-t**, **--test** *item-key* Перевірити один предмет і вийти. Див. **--print** для опису результату. **-v**, **--verbose** Увімкнути докладний вивід під час тестування або друку відомих елементів. **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Вивести інформацію про версію та вийти. [ ]{#lbAG} ### #### Runtime control options **userparameter\_reload** Reload user parameters from the configuration file **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} ### #### Параметри керування виконанням (Runtime options) **userparameter\_reload** Перезавантаження параметрів користувача з файлу конфігурації **log\_level\_increase**\[=*target*\] Підвищити рівень журналу, впливає на всі процеси, якщо ціль не вказано **log\_level\_decrease**\[=*target*\] Зниження рівня журналу, впливає на всі процеси, якщо ціль не вказано [ ]{#lbAG} ##### RUNTIME CONTROL Runtime control options: **config\_cache\_reload** Reload configuration cache. Ignored if cache is being currently loaded. Default configuration file (unless **-c** option is specified) will be used to find PID file and signal will be sent to process, listed in PID file. **snmp\_cache\_reload** Reload SNMP cache, clear the SNMP properties (engine time, engine boots, engine id, credentials) for all hosts. **housekeeper\_execute** Execute the housekeeper. Ignored if housekeeper is being currently executed. **trigger_housekeeper\_execute** Execute the trigger housekeeper (remove problems for deleted triggers). Ignored if trigger housekeeper for services is being currently executed. **diaginfo**\[=*section*\] Log internal diagnostic information of the specified section. Section can be *historycache*, *preprocessing*, *alerting*, *lld*, *valuecache*, *locks*. By default diagnostic information of all sections is logged. **ha_status** Log high availability (HA) cluster status. ##### RUNTIME CONTROL Параметри керування виконанням **config\_cache\_reload** Перезавантажити кеш конфігурації. Ігнорується, якщо зараз завантажується кеш. Файл конфігурації за замовчуванням (якщо не вказано параметр **-c**) використовуватиметься для пошуку файлу PID, а сигнал буде надіслано до процесу, зазначеного у файлі PID. **snmp\_cache\_reload** Перезавантажте кеш SNMP, очистити властивості SNMP (engine time, engine boots, engine id, credentials) для всіхвузлів мережі. **housekeeper\_execute** Запустити housekeeper. Ігнорується, якщо зараз запущений housekeeper. **trigger_housekeeper\_execute** Запустити housekeeper для тригерів (усунути проблеми для видалених тригерів). Ігнорується, якщо наразі виконується housekeeper для тригерів. **diaginfo**\[=*section*\] Реєстрація внутрішньої діагностичної інформації вказаного розділу. Розділ може бути *historycache*, *preprocessing*, *alerting*, *lld*, *valuecache*, *locks*. За замовчуванням реєструється діагностична інформація всіх розділів. **ha_status** Журнал стану кластера високої доступності (HA). #### Scenario #### Сценарій #### Scripts Configure and execute scripts to help you with your daily tasks. [Script API](/manual/api/reference/script) #### Скрипти Налаштування та виконання сценаріїв, які допоможуть вам виконувати щоденні завдання. [API скриптів](/manual/api/reference/script) #### script [ZBXNEXT-8121](https://support.zabbix.com/browse/ZBXNEXT-8121) Added new properties `manualinput`, `manualinput_prompt`, `manualinput_validator`, `manualinput_validator_type`, `manualinput_default_value`.\ [ZBXNEXT-8121](https://support.zabbix.com/browse/ZBXNEXT-8121) `script.execute`: Added new parameter `manualinput`.\ #### script [ZBXNEXT-8121](https://support.zabbix.com/browse/ZBXNEXT-8121) Додано нові властивості `manualinput`, `manualinput_prompt`, `manualinput_validator`, `manualinput_validator_type`, `manualinput_default_value`.\ [ZBXNEXT-8121](https://support.zabbix.com/browse/ZBXNEXT-8121) `script.execute`: додано новий параметр `manualinput`.\ #### script [ZBXNEXT-8880](https://support.zabbix.com/browse/ZBXNEXT-8880) `script.create` and `script.update`: Parameter `execute_on` value "1" (run on Zabbix server) will be supported only if execution of global scripts is enabled on Zabbix server.\ [ZBXNEXT-8121](https://support.zabbix.com/browse/ZBXNEXT-8121) `script.getscriptsbyhosts`: Method no longer accepts array of host IDs. It now accepts object with the following parameters `hostid`, `scriptid`, `manualinput`.\ [ZBXNEXT-8121](https://support.zabbix.com/browse/ZBXNEXT-8121) `script.getscriptsbyevents`: Method no longer accepts array of event IDs. It now accepts object with the following parameters `eventid`, `scriptid`, `manualinput`.\ #### script [ZBXNEXT-8880](https://support.zabbix.com/browse/ZBXNEXT-8880) `script.create` і `script.update`: значення параметра `execute_on` "1" (запуск на сервері Zabbix) буде підтримуватись, лише якщо на сервері Zabbix увімкнено виконання глобальних сценаріїв.\ [ZBXNEXT-8121](https://support.zabbix.com/browse/ZBXNEXT-8121) `script.getscriptsbyhosts`: метод більше не приймає масив ідентифікаторів хостів. Тепер він приймає об’єкт із такими параметрами `hostid`, `scriptid`, `manualinput`.\ [ZBXNEXT-8121](https://support.zabbix.com/browse/ZBXNEXT-8121) `script.getscriptsbyevents`: метод більше не приймає масив ідентифікаторів подій. Тепер він приймає об’єкт із такими параметрами `eventid`, `scriptid`, `manualinput`.\ ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) - [Script](/manual/api/reference/script/object) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Audit log object](/manual/api/reference/auditlog/object) ### Дивись також - [Об'єкт журналу аудиту](/manual/api/reference/auditlog/object) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) - [Host](/manual/api/reference/host/object#host) ### Дивись також - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) - [Хост](/manual/api/reference/host/object#host) ### See also - [Discovered service](/manual/api/reference/dservice/object#discovered_service) - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) ### Дивись також - [Виявлена служба](/manual/api/reference/dservice/object#discovered_service) - [Правило виявлення](/manual/api/reference/drule/object#discovery_rule) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) ------------------------------------------------------------------------ [ ]{#index} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) -------------------------------------------------- ---------------------- [ ]{#index} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### Дивись також - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### Дивись також - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph](/manual/api/reference/graph/object#graph) ### Дивись також - [Графік](/manual/api/reference/graph/object#graph) ### See also - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Host](/manual/api/reference/host/object#host) - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) - [LLD rule filter](object#lld_rule_filter) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### Дивись також - [Прототип графіка](/manual/api/reference/graphprototype/object#graph_prototype) - [Хост](/manual/api/reference/host/object#host) - [Прототип елемента](/manual/api/reference/itemprototype/object#item_prototype) - [Фільтр правил LLD](object#lld_rule_filter) - [Прототип тригера](/manual/api/reference/triggerprototype/object#trigger_prototype) ### See also - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### Дивись також - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### See also - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### Дивись також - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### Дивись також - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### See also - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### Дивись також - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Елемент](/manual/api/reference/item/object#item) ### See also - [Host](/manual/api/reference/host/object#host) - [Media type](/manual/api/reference/mediatype/object#media_type) - [User](/manual/api/reference/user/object#user) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Тип медіа](/manual/api/reference/mediatype/object#media_type) - [Користувач](/manual/api/reference/user/object#user) ### See also - [host.update](update) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### Дивись також - [host.update](оновити) - [Група хостів](/manual/api/reference/hostgroup/object#host_group) - [Шаблон](/manual/api/reference/template/object#template) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) ### See also - [host.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### Дивись також - [host.update](оновити) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) ### See also - [LLD rule filter](object#lld_rule_filter) - [LLD macro paths](object#lld_macro_path) - [LLD rule preprocessing](object#lld_rule_preprocessing) ### Дивись також - [Фільтр правил LLD](object#lld_rule_filter) - [Шляхи макросу LLD](object#lld_macro_path) - [Попередня обробка правила LLD](object#lld_rule_preprocessing) ### See also - [Scenario step](object#scenario_step) ### Дивись також - [Крок сценарію](object#scenario_step) ### See also - [Scenario step](object#scenario_step) ### Дивись також - [Крок сценарію](object#scenario_step) #### Server To enable encryption with certificate verification for connections between Zabbix server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_ca DBTLSCAFile=/etc/ssl/mysql/ca.pem ... #### Сервер Щоб увімкнути шифрування з перевіркою сертифіката для з’єднань між сервером Zabbix і базою даних, налаштуйте */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_ca DBTLSCAFile=/etc/ssl/mysql/ca.pem ... #### Server To enable encryption with full verification for connections between Zabbix server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_full DBTLSCAFile=/etc/ssl/mysql/ca.pem DBTLSCertFile=/etc/ssl/mysql/client-cert.pem DBTLSKeyFile=/etc/ssl/mysql/client-key.pem ... #### Сервер Щоб увімкнути шифрування з повною перевіркою з’єднань між сервером Zabbix і базою даних, налаштуйте */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_full DBTLSCAFile=/etc/ssl/mysql/ca.pem DBTLSCertFile=/etc/ssl/mysql/client-cert.pem DBTLSKeyFile=/etc/ssl/mysql/client-key.pem ... #### Server To enable transport-only encryption for connections between server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=required ... #### Сервер Щоб увімкнути лише транспортне шифрування для з’єднань між сервером і базою даних, налаштуйте */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=required ... #### Service Level Agreement Define Service Level Objectives (SLO), retrieve detailed Service Level Indicators (SLI) information about service performance. [SLA API](/manual/api/reference/sla) #### Угода про рівень обслуговування Визначення цілей рівня обслуговування (SLO), отримання детальних індикаторів рівня обслуговування (SLI) продуктивністі сервісу. [SLA API](/manual/api/reference/sla) #### Services Manage services for service-level monitoring and retrieve detailed SLA information about any service. [Service API](/manual/api/reference/service) #### Сервіси Керуйте сервісами для моніторингу рівня обслуговування та отримуйте детальну інформацію про SLA будь-якого сервісу. [API сервісу](/manual/api/reference/service) ## Services The Zabbix API allows you to access data gathered during service monitoring. ## Сервіси Zabbix API дозволяє отримати доступ до зібраних даних під час моніторингу сервісу. #### settings [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Added new property `timeout_browser`.\ [ZBXNEXT-8837](https://support.zabbix.com/browse/ZBXNEXT-8837) Added new property `auditlog_mode`.\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Added new properties `timeout_zabbix_agent`, `timeout_simple_check`, `timeout_snmp_agent`, `timeout_external_check`, `timeout_db_monitor`, `timeout_http_agent`, `timeout_ssh_agent`, `timeout_telnet_agent`, `timeout_script`.\ #### settings [ZBXNEXT-9150](https://support.zabbix.com/browse/ZBXNEXT-9150) Додано нову властивість `timeout_browser`.\ [ZBXNEXT-8837](https://support.zabbix.com/browse/ZBXNEXT-8837) Додано нову властивість `auditlog_mode`.\ [ZBXNEXT-1096](https://support.zabbix.com/browse/ZBXNEXT-1096) Додано нові властивості `timeout_zabbix_agent`, `timeout_simple_check`, `timeout_snmp_agent`, `timeout_external_check`, `timeout_db_monitor`, `timeout_http_agent`, ` timeout_ssh_agent`, `timeout_telnet_agent`, `timeout_script`.\ #### Slideshow It is possible to activate a slideshow in the dashboard: - `/zabbix.php?action=dashboard.view&slideshow=1` - activate slideshow #### Слайд-шоу Слайд-шоу можна активувати на інформаційній панелі: - `/zabbix.php?action=dashboard.view&slideshow=1` - активувати показ слайдів ### Source CAction::create() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::create() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::delete() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::delete() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::get() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::get() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::update() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::update() у *ui/include/classes/api/services/CAction.php*. ### Source CAlert::get() in *ui/include/classes/api/services/CAlert.php*. ### Джерело CAlert::get() у *ui/include/classes/api/services/CAlert.php*. ### Source CAPIInfo::version() in *ui/include/classes/api/services/CAPIInfo.php*. ### Джерело CAPIInfo::version() у *ui/include/classes/api/services/CAPIInfo.php*. ### Source CAuditLog::get() in *ui/include/classes/api/services/CAuditLog.php*. ### Джерело CAuditLog::get() у *ui/include/classes/api/services/CAuditLog.php*. ### Source CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### Джерело CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### Source CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### Джерело CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### Source CConfiguration::export() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::export() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::importcompare() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CConfiguration::import() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::import() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CCorrelation::create() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::create() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::delete() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::delete() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::get() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::update() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::update() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::create() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::delete() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::get() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::update() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### Джерело CDCheck::get() в *ui/include/classes/api/services/CDCheck.php*. ### Source CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Джерело CDHost::get() в *ui/include/classes/api/services/CDHost.php*. ### Source CDiscoveryRule::create() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::create() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::delete() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::delete() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::get() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::get() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::update() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::update() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::create() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::delete() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::get() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::update() в *ui/include/classes/api/services/CDRule.php*. ### Source CDService::get() in *ui/include/classes/api/services/CDService.php*. ### Джерело CDService::get() в*ui/include/classes/api/services/CDService.php*. ### Source CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### Джерело CEvent::acknowledge() в *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### Джерело CEvent::get() в *ui/include/classes/api/services/CEvent.php*. ### Source CGraph::create() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::create() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::delete() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::get() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### Джерело CGraphItem::get() у *ui/include/classes/api/services/CGraphItem.php*. ### Source CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::create() в *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::delete() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::get() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::update() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::update() у *ui/include/classes/api/services/CGraph.php*. ### Source CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### Джерело CHaNode::get() у *ui/include/classes/api/services/CHaNode.php*. ### Source CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### Джерело CHistory::clear() у *ui/include/classes/api/services/CHistory.php*. ### Source CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ### Джерело CHistory::get() у *ui/include/classes/api/services/CHistory.php*. ### Source CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::create() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::delete() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::delete() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::get() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::get() в *ui/include/classes/api/services/CHost.php*. ### Source CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::create() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::delete() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::delete() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::get() у *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massAdd() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massRemove() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massUpdate() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::update() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::create() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::delete() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::get() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::massAdd() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::massRemove() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::replaceHostInterfaces() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::update() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massAdd() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massRemove() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massUpdate() в *ui/include/classes/api/services/CHost.php*. ### Source CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::create() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::delete() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::get() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::update() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHost::update() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::update() в *ui/include/classes/api/services/CHost.php*. ### Source CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Джерело CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Джерело CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::delete() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::get() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::update() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CIconMap::create() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::create() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::delete() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::get() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::get() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::update() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::update() в *ui/include/classes/api/services/CIconMap.php*. ### Source CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::create() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::delete() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::delete() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::get() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::get() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::update() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::update() в *ui/include/classes/api/services/CImage.php*. ### Source CItem::create() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::create() в *ui/include/classes/api/services/CItem.php*. ### Source CItem::delete() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::delete() в *ui/include/classes/api/services/CItem.php*. ### Source CItem::get() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::get() в *ui/include/classes/api/services/CItem.php*. ### Source CItemPrototype::create() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::create() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::delete() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::delete() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::get() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::get() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::update() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::update() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItem::update() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::update() в *ui/include/classes/api/services/CItem.php*. ### Source CMaintenance::create() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::create() в *ui/include/classes/api/services/CMaintenance.php*. ### Source CMaintenance::delete() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::delete() в *ui/include/classes/api/services/CMaintenance.php*. ##### Step 1 Install Kerberos package. For Debian/Ubuntu: apt install krb5-user For RHEL: dnf install krb5-workstation ##### Крок 1 Встановіть пакет Kerberos. Для Debian/Ubuntu: apt install krb5-user Для RHEL: dnf install krb5-workstation ##### Step 1 To define your own theme you'll need to create a CSS file and save it in the `assets/styles/` folder (for example, *custom-theme.css*). You can either copy the files from a different theme and create your theme based on it or start from scratch. ##### Крок 1 Щоб визначити власну тему, вам потрібно створити файл CSS і зберегти його в папці `assets/styles/` (наприклад, *custom-theme.css*). Ви можете або скопіювати файли з іншої теми та створити свою тему на її основі, або почати з нуля. ##### Step 2 Add your theme to the list of themes returned by the APP::getThemes() method. You can do this by overriding the ZBase::getThemes() method in the APP class. This can be done by adding the following code before the closing brace in *include/classes/core/APP.php*: public static function getThemes() { return array_merge(parent::getThemes(), [ 'custom-theme' => _('Custom theme') ]); } ::: noteimportant Note that the name you specify within the first pair of quotes must match the name of the theme file without extension. ::: To add multiple themes, just list them under the first theme, for example: public static function getThemes() { return array_merge(parent::getThemes(), [ 'custom-theme' => _('Custom theme'), 'anothertheme' => _('Another theme'), 'onemoretheme' => _('One more theme') ]); } Note that every theme except the last one must have a trailing comma. ::: notetip To change graph colors, the entry must be added in the *graph\_theme* database table. ::: ##### Крок 2 Додайте свою тему до списку тем, які повертає метод APP::getThemes(). Це можна зробити, перевизначивши метод ZBase::getThemes() у класі APP. Це можна зробити, додавши такий код перед закриваючою дужкою в *include/classes/core/APP.php*: · public static function getThemes() { · return array_merge(parent::getThemes(), [ · 'custom-theme' => _('Custom theme') · ]); · } ::: noteimportant Зауважте, що назва, яку ви вказуєте в першій парі лапок, має збігатися з назвою файлу теми без розширення. ::: Щоб додати кілька тем, просто перелічіть їх під першою темою, наприклад: · public static function getThemes() { · return array_merge(parent::getThemes(), [ · 'custom-theme' => _('Custom theme'), · 'anothertheme' => _('Another theme'), · 'onemoretheme' => _('One more theme') · ]); · } Зауважте, що кожна тема, крім останньої, повинна мати кінцеву кому. ::: підказка Щоб змінити кольори графіка, потрібно додати запис у таблицю бази даних *graph\_theme*. ::: ##### Step 2 Configure Kerberos configuration file (see MIT documentation for details) ``` {.java} cat /etc/krb5.conf [libdefaults] default_realm = EXAMPLE.COM # The following krb5.conf variables are only for MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` ##### Крок 2 Налаштувати файл конфігурації Kerberos (докладніше див. у документації MIT) ``` {.java} cat /etc/krb5.conf [libdefaults] default_realm = EXAMPLE.COM # The following krb5.conf variables are only for MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` ##### Step 3 Activate the new theme. In Zabbix frontend, you may either set this theme to be the default one or change your theme in the user profile. Enjoy the new look and feel! ##### Крок 3 Активуйте нову тему. У інтерфейсі Zabbix ви можете або встановити цю тему як тему за замовчуванням, або змінити свою тему в профілі користувача. Насолоджуйтесь новим зовнішнім виглядом! ##### Step 3 Create a Kerberos ticket for user *zabbix*. Run the following command as user *zabbix*: kinit zabbix ::: noteimportant It is important to run the above command as user *zabbix*. If you run it as *root* the authentication will not work. ::: ##### Крок 3 Створіть квиток Kerberos для користувача *zabbix*. Виконайте наступну команду від імені користувача *zabbix*: kinit zabbix ::: noteimportant Важливо виконати наведену вище команду як користувач *zabbix*. Якщо ви запустите його як *root*, автентифікація не працюватиме. ::: ##### Step 4 Create a web scenario or HTTP agent item with Kerberos authentication type. Optionally can be tested with the following curl command: curl -v --negotiate -u : http://example.com Note that for lengthy web monitoring it is necessary to take care of renewing the Kerberos ticket. Default time of ticket expiration is 10h. ##### Крок 4 Створіть веб-сценарій або елемент HTTP-агента з типом автентифікації Kerberos. Додатково можна перевірити за допомогою такої команди curl: curl -v --negotiate -u : http://example.com Зверніть увагу, що для тривалого веб-моніторингу необхідно подбати про оновлення квитка Kerberos. За замовчуванням термін дії квитка становить 10 годин. ### Structure The API consists of a number of methods that are nominally grouped into separate APIs. Each of the methods performs one specific task. For example, the `host.create` method belongs to the *host* API and is used to create new hosts. Historically, APIs are sometimes referred to as "classes". ::: notetip Most APIs contain at least four methods: `get`, `create`, `update` and `delete` for retrieving, creating, updating and deleting data respectively, but some APIs may provide a totally different set of methods. ::: ### Структура API складається з кількох методів, номінально згрупованих у окремі API. Кожен із методів виконує одну певну задачу. Наприклад, метод `host.create` належить до API *host* і використовується для створення нових хостів. Історично так склалось, що API іноді називають "класами". ::: notetip Більшість API містять принаймні чотири методи: `get`, `create`, `update` і `delete` для отримання, створення, оновлення та видалення даних відповідно, але деякі API можуть надавати повністю різний набір методів. ::: #### Structure The content of this manual is divided into sections and subsections to provide easy access to particular subjects of interest. When you navigate to respective sections, make sure that you expand section folders to reveal full content of what is included in subsections and individual pages. Cross-linking between pages of related content is provided as much as possible to make sure that relevant information is not missed by the users. #### Структура Зміст цього посібника поділено на розділи та підрозділи для того, щоб забезпечити легкий доступ до певних тем, які вас цікавлять. Коли ви переходите до відповідних розділів, переконайтеся, що ви розгорнули папки розділів, щоб побачити повний зміст того, що міститься в підрозділах та окремих сторінках. Перехресні посилання між сторінками пов'язаного контенту надаються настільки, наскільки це можливо, для того, щоб переконатися, що відповідна інформація не буде пропущена користувачами. ## SYNOPSIS **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2** \[**-c** *config-file*\] **-T**\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## СИНТАКСИС **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2** \[**-c** *config-file*\] **-T**\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## SYNOPSIS **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd** \[**-c** *config-file*\] **-T**\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd** \[**-c** *config-file*\] **-T**\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *номер-порту*\] \[**-I** *IP-адреса*\] \[**-t** *тайм-аут*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *номер порту*\] \[**-I** *IP-адреса*\] \[**-t** *час очікування*\] **--tls-connect** **cert** **--tls-ca-файл** *CA-файл* \[**--tls-crl-файл** *CRL-файл*\] \[**--tls-agent-cert-issuer** *сертифікат-емітент*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *файл-сертифіката* **--tls-key-file** *key-file* \[**--tls-cipher13** *шифр-рядок*\] \[**--tls-cipher** *шифр-рядок*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *port-number*\] \[**-I** *IP-адреса*\] \[**-t** *час очікування*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-ідентифікація* **--tls-psk-файл** *PSK-файл* \[**--tls-cipher13** *шифр-рядок*\] \[**--tls-cipher** *шифр-рядок*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_proxy** \[**-c** *config-file*\]\ **zabbix\_proxy** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_proxy** \[**-c** *config-file*\] **-T**\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_proxy** \[**-c** *конфігураційний файл*\]\ **zabbix\_proxy** \[**-c** *конфігураційний файл*\] **-R** *параметр виконання*\ **zabbix\_proxy** \[**-c** *config-file*\] **-T**\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server** \[**-c** *config-file*\] **-T**\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server** \[**-c** *config-file*\] **-T**\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service** \[**-c** *config-file*\] **-T**\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service** \[**-c** *config-file*\] **-T**\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} #### Tasks Interact with Zabbix server task manager, creating tasks and retrieving response. [Task API](/manual/api/reference/task) #### Завдання Взаємодійте з диспетчером завдань сервера Zabbix, створюючи та отримуючи відповідь. [API завдання](/manual/api/reference/task) #### task [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Renamed property `proxy_hostid` to `proxyid`.\ #### task [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Перейменовано властивість `proxy_hostid` на `proxyid`.\ #### templatedashboard [ZBXNEXT-8686](https://support.zabbix.com/browse/ZBXNEXT-8686) Added new [template dashboard widget](/manual/api/reference/templatedashboard/object#template-dashboard-widget) type `itemnavigator`.\ [ZBXNEXT-8685](https://support.zabbix.com/browse/ZBXNEXT-8685) Added new [template dashboard widget](/manual/api/reference/templatedashboard/object#template-dashboard-widget) type `hostnavigator`.\ [ZBXNEXT-8683](https://support.zabbix.com/browse/ZBXNEXT-8683) Added new [template dashboard widget](/manual/api/reference/templatedashboard/object#template-dashboard-widget) type `honeycomb`.\ [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) Added new [template dashboard widget](/manual/api/reference/templatedashboard/object#template-dashboard-widget) type `toptriggers`.\ [ZBXNEXT-743](https://support.zabbix.com/browse/ZBXNEXT-743) Added new [template dashboard widget](/manual/api/reference/templatedashboard/object#template-dashboard-widget) type `gauge`.\ [ZBXNEXT-8086](https://support.zabbix.com/browse/ZBXNEXT-8079) Added new [template dashboard widget](/manual/api/reference/templatedashboard/object#template-dashboard-widget) types `actionlog`, `dataover`, `discovery`, `favgraphs`, `favmaps`, `hostavail`, `map`, `navtree`, `problemhosts`, `problems`, `problemsbysv`, `slareport`, `svggraph`, `systeminfo`, `tophosts`, `trigover`, `web`.\ [ZBXNEXT-8086](https://support.zabbix.com/browse/ZBXNEXT-8079) Added new [template dashboard widget field](/manual/api/reference/templatedashboard/object#template-dashboard-widget-field) types (8 - Map, 9 - Service, 10 - SLA, 11 - User, 12 - Action, 13 - Media type).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Added new [template dashboard widget](/manual/api/reference/templatedashboard/object#template-dashboard-widget) type `piechart`.\ #### шаблон інформаційної панелі [ZBXNEXT-8686](https://support.zabbix.com/browse/ZBXNEXT-8686) Додано новий [шаблон віджета інформаційної панелі](/manual/api/reference/templatedashboard/object#template-dashboard-widget) типу `itemnavigator `.\ [ZBXNEXT-8685](https://support.zabbix.com/browse/ZBXNEXT-8685) Додано новий [шаблон віджета інформаційної панелі](/manual/api/reference/templatedashboard/object#template-dashboard-widget) типу `hostnavigator `.\ [ZBXNEXT-8683](https://support.zabbix.com/browse/ZBXNEXT-8683) Додано новий [шаблон віджета інформаційної панелі](/manual/api/reference/templatedashboard/object#template-dashboard-widget) типу `honeycomb `.\ [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) Додано новий [шаблон віджета інформаційної панелі](/manual/api/reference/templatedashboard/object#template-dashboard-widget) типу `toptriggers `.\ [ZBXNEXT-743](https://support.zabbix.com/browse/ZBXNEXT-743) Додано новий [шаблон віджета інформаційної панелі](/manual/api/reference/templatedashboard/object#template-dashboard-widget) типу `gauge `.\ [ZBXNEXT-8086](https://support.zabbix.com/browse/ZBXNEXT-8079) Додано новий [шаблон віджета інформаційної панелі](/manual/api/reference/templatedashboard/object#template-dashboard-widget) типів `actionlog `, `dataover`, `discovery`, `favgraphs`, `favmaps`, `hostavail`, `map`, `navtree`, `problemhosts`, `problems`, `problemsbysv`, `slareport`, `svggraph`, `systeminfo`, `tophosts`, `trigover`, `web`.\ [ZBXNEXT-8086](https://support.zabbix.com/browse/ZBXNEXT-8079) Додано нове [поле віджета панелі інструментів шаблону](/manual/api/reference/templatedashboard/object#template-dashboard-widget-field) типи (8 - Карта, 9 - Служба, 10 - SLA, 11 - Користувач, 12 - Дія, 13 - Спосіб оповіщення).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Додано новий [шаблон віджета інформаційної панелі](/manual/api/reference/templatedashboard/object#template-dashboard-widget) типу `piechart `.\ #### templatedashboard [ZBXNEXT-9044](https://support.zabbix.com/browse/ZBXNEXT-9044) Changed the value range of the dashboard widget parameters `x` (from 0-23 to 0-71 ) and `y` (from 0-62 to 0-63) as well as `width` (from 1–24 to 1–72) and `height` (from 2–32 to 1–64).\ #### шаблон інформаційної панелі [ZBXNEXT-9044](https://support.zabbix.com/browse/ZBXNEXT-9044) Змінено діапазон значень параметрів віджета інформаційної панелі «x» (з 0-23 до 0-71) і «y» (з 0-62 до 0-63), а також "ширина" (від 1-24 до 1-72) і "висота" (від 2-32 до 1-64).\ #### Templates and template groups Manage templates and link them to hosts or other templates. [Template API](/manual/api/reference/template) | [Template group API](/manual/api/reference/templategroup) | [Value map API](/manual/api/reference/valuemap) #### Шаблони та групи шаблонів Керування шаблонами та приєднання їх до хостів чи інших шаблонів. [API шаблону](/manual/api/reference/template) | [API групи шаблонів](/manual/api/reference/templategroup) | [API конвертованихзначень](/manual/api/reference/valuemap) The ***getUpdateRequestData()*** method prepares the server request data for updating the widget by gathering various properties and their corresponding values (widget identifiers, filter settings, time ranges, etc.) from the widget's state and configuration, and constructing a data object that represents the necessary information to be sent to the server in the update request. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js getUpdateRequestData() { return { templateid: this._dashboard.templateid ?? undefined, dashboardid: this._dashboard.dashboardid ?? undefined, widgetid: this._widgetid ?? undefined, name: this._name !== '' ? this._name : undefined, fields: Object.keys(this._fields).length > 0 ? this._fields : undefined, view_mode: this._view_mode, edit_mode: this._is_edit_mode ? 1 : 0, dynamic_hostid: this._dashboard.templateid !== null || this.supportsDynamicHosts() ? (this._dynamic_hostid ?? undefined) : undefined, ...this._contents_size }; } ``` Метод ***getUpdateRequestData()*** готує дані для запиту на оновлення віджета, збираючи різні властивості та відповідні їм значення (ідентифікатори віджета, налаштування фільтрів, часові діапазони тощо) зі стану та конфігурації віджета і створюючи об'єкт даних, який представляє необхідну інформацію, що надсилається на сервер у запиті на оновлення. Цей метод викликається лише як частина методу за замовчуванням *promiseUpdate()*, тобто під час процесу оновлення віджета. Реалізація за замовчуванням: ```js getUpdateRequestData() { return { templateid: this._dashboard.templateid ?? undefined, dashboardid: this._dashboard.dashboardid ?? undefined, widgetid: this._widgetid ?? undefined, name: this._name !== '' ? this._name : undefined, fields: Object.keys(this._fields).length > 0 ? this._fields : undefined, view_mode: this._view_mode, edit_mode: this._is_edit_mode ? 1 : 0, dynamic_hostid: this._dashboard.templateid !== null || this.supportsDynamicHosts() ? (this._dynamic_hostid ?? undefined) : undefined, ...this._content_size }; } ``` The ***hasPadding()*** method is responsible for applying an 8px vertical padding at the bottom of the widget when it is configured to [show its header](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters). This method is invoked when the dashboard page is activated, that is, when it becomes the displayed page in the user interface. Default implementation: ```js hasPadding() { return this.getViewMode() !== ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER; } ``` For some widgets it is necessary to use all of the available widget space to configure, for example, a custom background color. The following is an example of the implementation of the *hasPadding()* method used in the Zabbix-native [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value) widget. ```js hasPadding() { return false; } ``` Метод ***hasPadding()*** відповідає за застосування вертикального відступу 8px внизу віджета, коли він налаштований на [відображення його заголовку](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters). Цей метод викликається, коли сторінка дашборда активована, тобто коли вона стає сторінкою, що відображається в інтерфейсі користувача. Реалізація за замовчуванням: ```js hasPadding() { return this.getViewMode() !== ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER; } ``` Для деяких віджетів необхідно використовувати весь доступний простір віджету, щоб налаштувати, наприклад, користувацький колір фону. Нижче наведено приклад реалізації методу *hasPadding()*, який використовується у віджеті [*Значення елементу даних*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value), що є нативним для Zabbix. ```js hasPadding() { return false; } ``` The ***onActivate()*** method makes the widget active and interactive by enabling custom event listeners (for responding to user actions) and initiating the widget update cycle (for keeping its content up-to-date). This method is invoked when the dashboard page is activated, that is, when it becomes fully displayed in the user interface. Note that before the *onActivate()* method is invoked, the widget is in the inactive state (`WIDGET_STATE_INACTIVE`). After successful invocation, the widget transitions to the active state (`WIDGET_STATE_ACTIVE`). In the active state, the widget is responsive, listens to events, updates its content periodically, and can interact with other widgets. Example: ```js onActivate() { this._startClock(); this._resize_observer = new ResizeObserver(this._events.resize); this._resize_observer.observe(this._target); } ``` Метод ****onActivate()*** робить віджет активним та інтерактивним, вмикаючи користувацькі listener-и подій (для реагування на дії користувача) та ініціюючи цикл оновлення віджета (для підтримання його вмісту в актуальному стані). Цей метод викликається, коли сторінка дашборду активована, тобто коли вона стає повністю відображеною в інтерфейсі користувача. Зверніть увагу, що до виклику методу *onActivate()* віджет знаходиться в неактивному стані (`WIDGET_STATE_INACTIVE`). Після успішного виклику віджет переходить в активний стан (`WIDGET_STATE_ACTIVE`). В активному стані віджет реагує на події, періодично оновлює свій вміст і може взаємодіяти з іншими віджетами. приклад: ```js onActivate() { this._startClock(); this._resize_observer = new ResizeObserver(this._events.resize); this._resize_observer.observe(this._target); } ``` The ***onDeactivate()*** method stops any activity and interactivity of the widget by deactivating custom event listeners and stopping the widget update cycle. This method is invoked when the dashboard page is deactivated, that is, switched away or deleted, or when the widget is deleted from the dashboard page. Note that before the *onDeactivate()* method is invoked, the widget is in the active state (`WIDGET_STATE_ACTIVE`). After successful invocation, the widget transitions to the inactive state (`WIDGET_STATE_INACTIVE`). Example: ```js onDeactivate() { this._stopClock(); this._resize_observer.disconnect(); } ``` Метод ***onDeactivate()*** зупиняє будь-яку активність та інтерактивність віджета, деактивуючи користувацькі listener-и подій та зупиняючи цикл оновлення віджета. Цей метод викликається, коли сторінка інформаційної панелі деактивована, тобто переключена або видалена, або коли віджет видалено зі сторінки інформаційної панелі. Зверніть увагу, що до виклику методу *onDeactivate()* віджет знаходиться в активному стані (`WIDGET_STATE_ACTIVE`), після успішного виклику віджет переходить в неактивний стан (`WIDGET_STATE_INACTIVE`). приклад: ```js onDeactivate() { this._stopClock(); this._resize_observer.disconnect(); } ``` The ***onDestroy()*** method performs cleanup tasks before the widget is deleted from the dashboard, which can include closing a database connection that was established during widget initialization, cleaning up temporary data to free up system memory and avoid resource leaks, unregistering event listeners related to resize events or button clicks to prevent unnecessary event handling and memory leaks, etc. This method is invoked when the widget or the dashboard page that contains it is deleted. Note that before the *onDestroy()* method is invoked, a widget in an active state (`WIDGET_STATE_ACTIVE`) is always deactivated with the invocation of the *onDeactivate()* method. Example: ```js onDestroy() { if (this._filter_widget) { this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_MARK, this._events.mark); this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_SELECT, this._events.select); } } ``` Метод ***onDestroy()*** виконує завдання очищення перед видаленням віджета з панелі інструментів, які можуть включати закриття з'єднання з базою даних, яке було встановлено під час ініціалізації віджета, очищення тимчасових даних, щоб звільнити системну пам'ять і уникнути витоку ресурсів, скасування реєстрації listener-ів подій, пов'язаних зі зміною розміру або натисканням кнопок, щоб запобігти непотрібній обробці подій і витоку пам'яті тощо. Цей метод викликається, коли видаляється віджет або сторінка інформаційної панелі, яка його містить. Зверніть увагу, що перед викликом методу *onDestroy()* віджет в активному стані (`WIDGET_STATE_ACTIVE`) завжди деактивується викликом методу *onDeactivate()*. приклад: ```js onDestroy() { if (this._filter_widget) { this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_MARK, this._events.mark); this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_SELECT, this._events.select); } } ``` The ***onEdit()*** method defines the appearance and behavior of the widget when the dashboard transitions into editing mode. This method is invoked when the dashboard transitions into editing mode, typically when a user interacts with the widget's *Edit* button or the dashboard's *Edit dashboard* button. Example: ```js onEdit() { this._deactivateGraph(); } ``` Метод **onEdit()*** визначає зовнішній вигляд і поведінку віджета, коли інформаційна панель переходить у режим редагування. Цей метод викликається, коли інформаційна панель переходить у режим редагування, зазвичай, коли користувач взаємодіє з кнопкою *Редагувати* віджета або кнопкою *Редагувати інформаційну панель* на інформаційній панелі. приклад: ```js onEdit() { this._deactivateGraph(); } ``` The ***onInitialize()*** method defines the initial state and/or values of the widget, without performing any HTML or data manipulation. This method is invoked when a widget is created (a widget object is instantiated), typically by adding the widget to a dashboard page or loading the dashboard page. Example: ```js onInitialize() { this._time_offset = 0; this._interval_id = null; this._clock_type = CWidgetClock.TYPE_ANALOG; this._time_zone = null; this._show_seconds = true; this._time_format = 0; this._tzone_format = 0; this._show = []; this._has_contents = false; this._is_enabled = true; } ``` Метод ***onInitialize()*** визначає початковий стан та/або значення віджета, не виконуючи жодних маніпуляцій з HTML або даними. Цей метод викликається при створенні віджета (екземплярі об'єкта віджета), як правило, шляхом додавання віджета на сторінку інформаційної панелі або завантаження сторінки інформаційної панелі. приклад: ```js onInitialize() { this._time_offset = 0; this._interval_id = null; this._clock_type = CWidgetClock.TYPE_ANALOG; this._time_zone = null; this._show_seconds = true; this._time_format = 0; this._tzone_format = 0; this._show = []; this._has_contents = false; this._is_enabled = true; } ``` The ***onResize()*** method is responsible for adjusting widget's visual elements to accommodate the new widget size, which can include rearranging elements, adjusting element dimensions, text truncation, implementing lazy loading to improve responsiveness during resizing, etc. This method is invoked when the widget is resized, for example, when the user manually resizes the widget or when the browser window is resized. Example: ```js onResize() { if (this.getState() === WIDGET_STATE_ACTIVE) { this._startUpdating(); } } ``` Метод ***onResize()*** відповідає за адаптацію візуальних елементів віджета до нового розміру віджета, яка може включати перестановку елементів, регулювання розмірів елементів, усічення тексту, реалізацію лінивого завантаження для поліпшення відгуку при зміні розміру і т.д. Цей метод викликається при зміні розміру віджета, наприклад, коли користувач вручну змінює розмір віджета або коли змінюється розмір вікна браузера. Приклад: ```js onResize() { if (this.getState() === WIDGET_STATE_ACTIVE) { this._startUpdating(); } } ``` The ***onStart()*** method defines the HTML structure of the widget, without performing any data manipulation. This method is invoked before the first activation of the dashboard page, that is, before the dashboard and its widgets are fully displayed to the user. Example: ```js onStart() { this._events.resize = () => { const padding = 25; const header_height = this._view_mode === ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER ? 0 : this._header.offsetHeight; this._target.style.setProperty( '--content-height', `${this._cell_height * this._pos.height - padding * 2 - header_height}px` ); } } ``` Метод ***onStart()*** визначає HTML-структуру віджета, не виконуючи жодних маніпуляцій з даними. Цей метод викликається перед першою активацією сторінки дашборду, тобто перед тим, як дашборд та його віджети будуть повністю відображені користувачеві. приклад: ```js onStart() { this._events.resize = () => { const padding = 25; const header_height = this._view_mode == ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER ? 0 : this._header.offsetHeight; this._target.style.setProperty( '--content-height', `${this._cell_height * this._pos.height - padding * 2 - header_height}px` ); } } ``` The ***processUpdateErrorResponse(error)*** method handles the response received from the server after the update request if the response is an error, and displays the error message/-s. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js processUpdateErrorResponse(error) { this._updateMessages(error.messages, error.title); } ``` Метод ***processUpdateErrorResponse(error)*** обробляє відповідь, отриману від сервера після запиту на оновлення, якщо відповідь є помилковою, і виводить повідомлення про помилку. Цей метод викликається тільки як частина стандартного методу *promiseUpdate()*, тобто під час процесу оновлення віджету. Реалізація за замовчуванням: ```js processUpdateErrorResponse(error) { this._updateMessages(error.messages, error.title); } ``` The ***processUpdateResponse(response)*** method handles the response received from the server after the update request, and, if the update process has been successful and without errors, clears widget data and displays new contents with the *setContents()* method. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js processUpdateResponse(response) { this._setHeaderName(response.name); this._updateMessages(response.messages); this._updateInfo(response.info); this._updateDebug(response.debug); this.setContents(response); } ``` Метод ***processUpdateResponse(response)*** обробляє відповідь, отриману від сервера після запиту на оновлення, і, якщо процес оновлення пройшов успішно і без помилок, очищає дані віджета і відображає новий вміст методом *setContents()*. Цей метод викликається тільки в складі методу за замовчуванням *promiseUpdate()*, тобто під час процесу оновлення віджета. Реалізація за замовчуванням: ```js processUpdateResponse(response) { this._setHeaderName(response.name); this._updateMessages(response.messages); this._updateInfo(response.info); this._updateDebug(response.debug); this.setContents(response); } ``` The ***promiseUpdate()*** method initiates the data update process by retrieving data, typically using web requests or API calls. This method is invoked when a dashboard page is displayed and periodically after, until the dashboard page is switched to another dashboard page. The following is an example of the default implementation of the *promiseUpdate()* method used by most Zabbix-native widgets. In the default implementation, the *promiseUpdate()* method follows a general pattern for retrieving data from the server. It creates a new `Curl` object with the appropriate URL and request parameters, sends a `POST` request using the *fetch()* method with the data object constructed by the *getUpdateRequestData()* method, and processes the response (or an error response) with the *processUpdateResponse(response)* or *processUpdateErrorResponse(error)* accordingly. This implementation is suitable for most widgets as they typically retrieve data in a JSON format and handle it in a consistent manner. ```js promiseUpdate() { const curl = new Curl('zabbix.php'); curl.setArgument('action', `widget.${this._type}.view`); return fetch(curl.getUrl(), { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(this.getUpdateRequestData()), signal: this._update_abort_controller.signal }) .then((response) => response.json()) .then((response) => { if ('error' in response) { this.processUpdateErrorResponse(response.error); return; } this.processUpdateResponse(response); }); } ``` Метод ***promiseUpdate()*** ініціює процес оновлення даних шляхом отримання даних, як правило, за допомогою веб-запитів або викликів API. Цей метод викликається під час відображення сторінки дашборду і періодично після цього, поки сторінка дашборду не буде переключена на іншу сторінку дашборду. Нижче наведено приклад реалізації за замовчуванням методу *promiseUpdate()*, який використовується більшістю власних віджетів Zabbix. У стандартній реалізації метод *promiseUpdate()* відповідає загальному шаблону для отримання даних із сервера. Він створює новий об'єкт `Curl` з відповідним URL і параметрами запиту, відправляє запит `POST` методом *fetch()* з об'єктом даних, побудованим методом *getUpdateRequestData()*, і обробляє відповідь (або повідомлення про помилку) за допомогою *processUpdateResponse(response)* або *processUpdateErrorResponse(error)* відповідно. Ця реалізація підходить для більшості віджетів, оскільки вони зазвичай отримують дані у форматі JSON і обробляють їх у незмінний спосіб. ```js promiseUpdate() { const curl = new Curl('zabbix.php'); curl.setArgument('action', `widget.${this._type}.view`); return fetch(curl.getUrl(), { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(this.getUpdateRequestData()), signal: this._update_abort_controller.signal }) .then((response) => response.json()) .then((response) => { if ('error' in response) { this.processUpdateErrorResponse(response.error); return; } this.processUpdateResponse(response); }); } ``` The ***setContents(response)*** method displays widget contents if the widget update process has been successful and without errors, which can include manipulating DOM elements, updating UI components, applying styles or formatting, etc. This method is invoked only as part of the default *processUpdateResponse(response)* method, that is, during the process of handling the response received from the server after the update request. Default implementation: ```js setContents(response) { this._body.innerHTML = response.body ?? ''; } ``` Метод ***setContents(response)*** відображає вміст віджету, якщо процес оновлення віджету пройшов успішно і без помилок, які можуть включати маніпуляції з DOM-елементами, оновлення компонентів інтерфейсу, застосування стилів або форматування і т.д. Цей метод викликається тільки в складі стандартного методу *processUpdateResponse(response)*, тобто в процесі обробки відповіді, отриманої від сервера після запиту оновлення. Реалізація за замовчуванням: ```js setContents(response) { this._body.innerHTML = response.body ?? ''; } ``` This is a step-by-step tutorial that shows how to create a simple dashboard widget. You can download all files of this widget as a ZIP archive: [lesson_gauge_chart.zip](../../../../assets/en/devel/modules/examples/lesson_gauge_chart.zip). Це покрокова інструкція, яка показує, як створити простий віджет інформаційної панелі. ::: noteimportant Мінімальна необхідна версія Zabbix для цієї інструкції – 6.4.4. ::: Ви можете завантажити всі файли цього віджета як ZIP-архів: [lesson_gauge_chart.zip](../../../../assets/en/devel/modules/examples/lesson_gauge_chart.zip). This is a step-by-step tutorial that shows how to create a simple Zabbix frontend module. You can download all files of this module as a ZIP archive: [MyAddress.zip](../../../../assets/en/devel/modules/examples/MyAddress.zip). Це покрокова інструкція, яка показує, як створити простий модуль фронтенду Zabbix. Ви можете завантажити всі файли цього модуля у вигляді ZIP-архіву: [MyAddress.zip](../../../../assets/en/devel/modules/examples/MyAddress.zip). This is a step-by-step tutorial to create a simple loadable plugin for Zabbix agent 2. ::: notetip Feel free to use our [example repository](https://git.zabbix.com/projects/AP/repos/example/browse) as a template or guide for creating your own plugins. ::: Це покрокова інструкція зі створення простого завантажуваного плагіна для Zabbix agent 2. ::: notetip Не соромтеся використовувати наш [репозиторій прикладів](https://git.zabbix.com/projects/AP/repos/example/browse) як шаблон або посібник для створення власних плагінів. ::: # This topic does not exist yet. We are sorry, the page you are looking for cannot be found. Return to the homepage, try searching, or get [help](https://www.zabbix.com/support). # Цей розділ ще не створено. Нажаль, сторінка яку ви шукаєте не знайдена. Поверніться до домашньої сторінки, або [зверніться по допомогу](https://www.zabbix.com/support). #### Trends Retrieve trend values calculated by Zabbix server for presentation or further processing. [Trend API](/manual/api/reference/trend) #### Тренди Отримати значення трендів, обчислені сервером Zabbix для презентації або подальшої обробки. [API Трендів](/manual/api/reference/trend) #### Triggers Configure triggers to notify you about problems in your system. Manage trigger dependencies. [Trigger API](/manual/api/reference/trigger) #### Тригери Налаштування тригерів для сповіщення про проблеми у вашій системі. Керування залежностями тригерів. [API тригера](/manual/api/reference/trigger) #### trigger [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `trigger.get`: Method now also supports `status`, `ts_disable` and `disable_source` properties if `selectTriggerDiscovery` parameter is used. #### тригер [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `trigger.get`: метод тепер також підтримує властивості `status`, `ts_disable` і `disable_source`, якщо використовується параметр `selectTriggerDiscovery` . # Tutorials This section contains practical step-by-step tutorials to illustrate how to build a custom [module](/devel/modules/tutorials/module) and a [widget](/devel/modules/tutorials/widget) in Zabbix. # Інструкції Цей розділ містить практичні покрокові інструкції, що ілюструють, як створити власний [модуль](/devel/modules/tutorials/module) та [віджет](/devel/modules/tutorials/widget) у Zabbix. ### type Type of the module. Required for widgets and must equal "widget". *Type*: String *Default*: "module" *Example*: ```json "type": "widget" ``` ### type Тип модуля. Необхідний для віджетів і має дорівнювати "widget". *Тип*: String *За замовчуванням*: "module" *Приклад*: ```json "type": "widget" ``` ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-server-cert-issuer** *cert-issuer* Allowed server certificate issuer. **--tls-server-cert-subject** *cert-subject* Allowed server certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-v**, **--verbose** Verbose mode, **-vv** for more details. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **unencrypted** підключення без шифрування (за замовчуванням) ```{=html} <!-- --> ``` **psk** підключитися за допомогою TLS і спільного ключа ```{=html} <!-- --> ``` **cert** підключитися за допомогою TLS і сертифіката ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Повний шлях до файлу, що містить сертифікати ЦС верхнього рівня для перевірки однорангових сертифікатів. **--tls-crl-file** *CRL-file* Повний шлях до файлу, що містить анульовані сертифікати. **--tls-server-cert-issuer** *cert-issuer* Дозволений емітент сертифіката сервера. **--tls-server-cert-subject** *cert-subject* Дозволена тема сертифіката сервера. **--tls-cert-file** *cert-file* Повний шлях до файлу, що містить сертифікат або ланцюжок сертифікатів. **--tls-key-file** *key-file* Повний шлях до файлу, що містить закритий ключ. **--tls-psk-identity** *PSK-identity* Рядок ідентифікатора PSK. **--tls-psk-file** *PSK-file* Повний шлях до файлу, що містить попередній спільний ключ. **--tls-cipher13** *cipher-string* Рядок шифру для OpenSSL 1.1.1 або новішої версії для TLS 1.3. Замінити критерії вибору набору шифрів за замовчуванням. Ця опція недоступна, якщо версія OpenSSL не перевищує 1.1.1. **--tls-cipher** *cipher-string* Рядок пріоритету GnuTLS (для TLS 1.2 і вище) або рядок шифру OpenSSL (лише для TLS 1.2). Замінити критерії вибору набору шифрів за замовчуванням. **-v**, **--verbose** Детальний режим, **-vv** для отримання додаткової інформації. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Виведіть інформацію про версію та вийдіть. [ ]{#lbAG} ##### Update process methods The widget update process methods are responsible for retrieving updated data from Zabbix server or any other data source and displaying it in the widget. ##### Методи процесу оновлення Методи процесу оновлення віджета відповідають за отримання оновлених даних із сервера Zabbix або будь-якого іншого джерела даних і відображення їх у віджеті. #### Updating an item Enable an item by setting its status to "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.update","params":{"itemid":"10092","status":0},"id":5}' ``` The successful response will contain the ID of the updated item: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 5 } ``` ::: notetip The `item.update` method as well as other *update methods* can also accept arrays of objects and update multiple items with one API call. ::: #### Оновлення елемента даних Увімкніть елемент, встановивши для нього статус "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.update","params":{"itemid":"10092","status":0},"id":5}' ``` Успішна відповідь міститиме ідентифікатор оновленого елемента: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 5 } ``` ::: notetip Метод item.update, а також інші *методи оновлення* також може приймати масиви об’єктів і оновлювати кілька елементів одним викликом API. ::: #### Updating multiple triggers Enable multiple triggers by setting their status to "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.update","params":[{"triggerid":"13938","status":0},{"triggerid":"13939","status":0}],"id":6}' ``` The successful response will contain the IDs of the updated triggers: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938", "13939" ] }, "id": 6 } ``` ::: notetip This is the preferred method of updating. Some API methods, such as the `host.massupdate` allow to write a simpler code. However, it is not recommended to use these methods as they will be removed in the future releases. ::: #### Оновлення кількох тригерів Увімкніть кілька тригерів, встановивши для них статус "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.update","params":[{"triggerid":"13938","status":0},{"triggerid":"13939","status":0}],"id":6}' ``` Успішна відповідь міститиме ідентифікатори оновлених тригерів: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938", "13939" ] }, "id": 6 } ``` ::: notetip Це найкращий метод оновлення. Деякі методи API, такі як `host.massupdate`, дозволяють писати простіший код. Однак не рекомендується використовувати ці методи, оскільки їх буде видалено в наступних випусках. ::: #### Updating problems The problem update popup allows to: - comment on the problem - view comments and actions so far - change problem severity - suppress/unsuppress problem - acknowledge/unacknowledge problem - change symptom problem to cause problem - manually close problem {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Problem*|If only one problem is selected, the problem name is displayed.<br>If several problems are selected, *N problems selected* is displayed.| |*Message*|Enter text to comment on the problem (maximum 2048 characters).| |*History*|Previous activities and comments on the problem are listed, along with the time and user details.<br>For the meaning of icons used to denote user actions see the [event detail](/manual/web_interface/frontend_sections/monitoring/problems#viewing_details) page.<br>Note that history is displayed if only one problem is selected for the update.| |*Scope*|Define the scope of such actions as changing severity, acknowledging or manually closing problems:<br>**Only selected problem** - will affect this event only<br>**Selected and all other problems of related triggers** - in case of acknowledgment/closing problem, will affect this event and all other problems that are not acknowledged/closed so far. If the scope contains problems already acknowledged or closed, these problems will not be acknowledged/closed repeatedly. On the other hand, the number of message and severity change operations are not limited.| |*Change severity*|Mark the checkbox and click on the severity button to update problem severity.<br>The checkbox for changing severity is available if read-write permissions exist for at least one of the selected problems. Only those problems that are read-writable will be updated when clicking on *Update*.<br>If read-write permissions exist for none of the selected triggers, the checkbox is disabled.| |*Suppress*|Mark the checkbox to suppress the problem:<br>**Indefinitely** - suppress indefinitely<br>**Until** - suppress until a given time. Both [absolute and relative](/manual/web_interface/time_period_selector) time formats are supported, for example:<br>`now+1d` - for one day from now (default)<br>`now/w` - until the end of the current week<br>`2022-05-28 12:00:00` - until absolute date/time<br>Note that a simple period (e. g., `1d`, `1w`) is not supported.<br>Availability of this option depends on the "Suppress problems" user role settings.<br>See also: [Problem suppression](/manual/acknowledgment/suppression)| |*Unsuppress*|Mark the checkbox to unsuppress the problem. This checkbox is active only if at least one of the selected problems is suppressed.<br>Availability of this option depends on the "Suppress problems" user role settings.| |*Acknowledge*|Mark the checkbox to acknowledge the problem.<br>This checkbox is available if there is at least one unacknowledged problem among the selected.<br>It is not possible to add another acknowledgment for an already acknowledged problem (it is possible to add another comment though).| |*Unacknowledge*|Mark the checkbox to unacknowledge the problem.<br>This checkbox is available if there is at least one acknowledged problem among the selected.| |*Convert to cause*|Mark the checkbox to convert the symptom problem(s) to cause problem(s).| |*Close problem*|Mark the checkbox to manually close the selected problem(s).<br>The checkbox for closing a problem is available if the *Allow manual close* option is checked in [trigger configuration](/manual/config/triggers/trigger) for at least one of the selected problems. Only those problems will be closed that are allowed to be closed when clicking on *Update*.<br>If no problem is manually closeable, the checkbox is disabled.<br>Already closed problems will not be closed repeatedly.| #### Оновлення проблем Спливаюче вікно оновлення проблеми дозволяє: - прокоментувати проблему - переглянути коментарі та дії - змінити ступінь серйозності проблеми - приховати/розкрити проблему - підтвердити/непідтвердити проблему - змінити симптом проблеми на її причину - закрити проблему вручну {width="600"} Усі обов’язкові поля для введення позначені червоною зірочкою. |Параметр|Опис| |--|--------| |*Проблема*|Якщо вибрано лише одну проблему, відображається назва проблеми.<br>Якщо вибрано кілька проблем, відображається *N проблем вибрано*.| |*Повідомлення*|Введіть текст для коментаря до проблеми (максимум 2048 символів).| |*Історія*|Наведено попередні дії та коментарі щодо проблеми, а також час і відомості про користувача.<br>Значення піктограм, які використовуються для позначення дій користувача, див. [деталі події](/manual/web_interface/frontend_sections/ monitoring/problems#viewing_details).<br>Зверніть увагу, що історія відображається, якщо для оновлення вибрано лише одну проблему.| |*Область*|Визначте область таких дій, як зміна серйозності, підтвердження чи закриття проблем вручну:<br>**Лише вибрана проблема** – вплине лише на цю подію<br>**Вибрані та всі інші проблеми пов’язаних тригерів ** - у разі проблеми з підтвердженням/закриттям, це вплине на цю подію та всі інші проблеми, які наразі не підтверджені/закриті. Якщо область містить уже підтверджені або вирішені проблеми, ці проблеми не будуть визнаватися/закриватися повторно. З іншого боку, кількість операцій зміни повідомлень і серйозності не обмежена.| |*Змінити серйозність*|Поставте чекбокс і натисніть кнопку серйозності, щоб оновити серйозність проблеми.<br>Чекбокс для зміни серйозності доступний, якщо є дозволи на читання та запис принаймні для однієї з вибраних проблем. Лише ті проблеми, які доступні для читання та запису, будуть оновлені після натискання *Оновити*.<br>Якщо дозволи на читання та запис не існують для жодного з вибраних тригерів, чекбокс буде вимкнено.| |*Приховувати*|Поставте чекбокс, щоб приховати проблему:<br>**На невизначений термін** - приховувати на невизначений термін<br>**До** - приховувати до певного часу. Підтримуються як [абсолютний, так і відносний](/manual/config/visualization/graphs/simple#time-period-selector) формати часу, наприклад:<br>`зараз+1д` - на один день (за замовчуванням)< br>`зараз/с` - до кінця поточного тижня<br>`2022-05-28 12:00:00` - до абсолютної дати/часу<br>Зверніть увагу, що вказання просто періоду (наприклад, `1d` , `1w`) не підтримується.<br>Доступність цього параметра залежить від налаштувань ролі користувача «Приховувати проблеми».<br>Див. також: [Припинення проблеми](/manual/acknowledgment/suppression)| |*Unsuppress*|Позначте поле, щоб скасувати приховування проблеми. Цей прапорець активний, лише якщо принаймні одна з вибраних проблем прихована.<br>Доступність цього параметра залежить від налаштувань ролі користувача «Припинити проблеми».| |*Підтвердити*|Поставте прапорець, щоб підтвердити проблему.<br>Цей прапорець доступний, якщо серед вибраних є принаймні одна непідтверджена проблема.<br>Неможливо додати ще одне підтвердження для вже підтвердженої проблеми (вона але можна додати ще один коментар).| |*Unacknowledge*|Позначте прапорець, щоб скасувати підтвердження проблеми.<br>Цей прапорець доступний, якщо серед вибраних є принаймні одна підтверджена проблема.| |*Перетворити на причину*|Позначте прапорець, щоб перетворити симптом проблеми на причину, що її викликає.| |*Закрити проблему*|Поставте прапорець, щоб вручну закрити вибрану(і) проблему(и).<br>Прапорець для закриття проблеми доступний, якщо опцію *Дозволити закриття вручну* позначено в [конфігурації тригера](/manual/config /triggers/trigger) принаймні для однієї з вибраних проблем. Буде закрито лише ті проблеми, які дозволено закрити, натиснувши *Оновити*.<br>Якщо жодну проблему не можна закрити вручну, прапорець вимкнено.<br>Уже закриті проблеми не будуть закриті повторно.| ### url A link to the module description. For widgets, this link will be opened when clicking on the help icon {class="nozoom"} in the [*Add widget*](/manual/web_interface/frontend_sections/dashboards#adding-widgets) or [*Edit widget*](/manual/web_interface/frontend_sections/dashboards#widgets) window. If **url** is not specified, clicking on the help icon will open the general [Dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets) page. *Type*: String *Example*: ```json "url": "http://example.com" ``` ### url Посилання на опис модуля. Для віджетів це посилання буде відкрито, якщо натиснути піктограму довідки {class="nozoom"} у [*Додати віджет*](/manual/web_interface/frontend_sections/dashboards#adding-widgets) або вікні [*Редагувати віджет*](/manual/web_interface/frontend_sections/dashboards#widgets). Якщо **url** не вказано, клацання піктограми довідки відкриє загальну сторінку [Віджети інформаційної панелі](/manual/web_interface/frontend_sections/dashboards/widgets). *Тип*: String *Приклад*: ```json "url": "http://example.com" ``` #### userdirectory [ZBXNEXT-8760](https://support.zabbix.com/browse/ZBXNEXT-8760) `userdirectory.create`, `userdirectory.update`: Added new properties to media mappings - `active`, `severity`, `period`.\ #### userdirectory [ZBXNEXT-8760](https://support.zabbix.com/browse/ZBXNEXT-8760) `userdirectory.create`, `userdirectory.update`: додано нові властивості для зіставлення медіа — `active`, `severity`, ` period`.\ #### usergroup [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) Added new properties `mfa_status` and `mfaid`.\ [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) `usergroup.get`: Added new parameters `mfa_status` and `mfaids`.\ #### usergroup [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) Додано нові властивості `mfa_status` і `mfaid`.\ [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) `usergroup.get`: додано нові параметри `mfa_status` і `mfaids`.\ #### usergroup [ZBXNEXT-8760](https://support.zabbix.com/browse/ZBXNEXT-8760) `usergroup.update`: Added restriction on changes of group users for provisioned users.\ #### usergroup [ZBXNEXT-8760](https://support.zabbix.com/browse/ZBXNEXT-8760) `usergroup.update`: додано обмеження на зміни користувачів групи для підготовлених користувачів.\ #### Users and user groups Add users that will have access to Zabbix, assign them to user groups and grant permissions. Make roles for granular management of user rights. [User API](/manual/api/reference/user) | [User group API](/manual/api/reference/usergroup) | [User directory API](/manual/api/reference/userdirectory) | [User role API](/manual/api/reference/role) #### Користувачі та групи користувачів Додавання користувачів, які матимуть доступ до Zabbix, додавання їх до груп користувачів і надання дозволів. Створення ролей для детального керування правами користувачів. [API користувача](/manual/api/reference/user) | [API Групи користувачів](/manual/api/reference/usergroup) | [API Каталогу користувача](/manual/api/reference/userdirectory) | [API Ролі користувача](/manual/api/reference/role) ## Users The Zabbix API allows you to manage users of your monitoring system. ## Користувачі Zabbix API дозволяє вам керувати користувачами вашої системи моніторингу. #### user [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) Added new method `user.resettotp`.\ [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) `user.login`: Method now also returns `mfaid` if `userData` parameter is used.\ #### user [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) Додано новий метод `user.resettotp`.\ [ZBXNEXT-6876](https://support.zabbix.com/browse/ZBXNEXT-6876) `user.login`: метод тепер також повертає `mfaid`, якщо використовується параметр `userData`.\ #### user [ZBXNEXT-8760](https://support.zabbix.com/browse/ZBXNEXT-8760) `user.update`: Property `userdirectoryid` for user is made read-only.\ [ZBXNEXT-8760](https://support.zabbix.com/browse/ZBXNEXT-8760) `user.get`: Added new read-only property `userdirectory_mediaid` for media created by provision action.\ #### user [ZBXNEXT-8760](https://support.zabbix.com/browse/ZBXNEXT-8760) `user.update`: властивість `userdirectoryid` для користувача робиться доступною лише для читання.\ [ZBXNEXT-8760](https://support.zabbix.com/browse/ZBXNEXT-8760) `user.get`: додано нову властивість лише для читання`userdirectory_mediaid` для медіафайлів, створених попередньою дією.\ #### Using a custom expression filter Create a trigger action that uses a custom expression - "A and (B or C)" - for evaluating action conditions. Once a trigger with a severity higher or equal to "Warning" from host "10084" or host "10106" goes into a PROBLEM state, the action will send a message to all users in user group "7" via media type "1". The formula IDs "A", "B" and "C" have been chosen arbitrarily. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "15m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Використання спеціального фільтра виразів Створіть дію тригера, яка використовує настроюваний вираз - "A і (B або C)" - для оцінки умов дії. Як тільки тригер зі ступенем серйозності рівним або вище «Попередження» з хоста «10084» або хоста «10106» перейде в стан ПРОБЛЕМА, дія надішле повідомлення всім користувачам у групі користувачів «7» через спосіб сповіщення «1». [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "15m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` ##### - Using a static IP address By default the appliance uses DHCP to obtain the IP address. To specify a static IP address: - Log in as root user; - Open */etc/sysconfig/network-scripts/ifcfg-eth0* file; - Replace *BOOTPROTO=dhcp* with *BOOTPROTO=none* - Add the following lines: - *IPADDR=<IP address of the appliance>* - *PREFIX=<CIDR prefix>* - *GATEWAY=<gateway IP address>* - *DNS1=<DNS server IP address>* - Run **systemctl restart network** command. Consult the official Red Hat [documentation](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/deployment_guide/s1-networkscripts-interfaces) if needed. ##### - Використання статичної IP-адреси За замовчуванням готове рішення використовує DHCP для отримання IP-адреси. Щоб указати статичну IP-адресу: - Увійдіть як користувач root; - Відкрийте файл */etc/sysconfig/network-scripts/ifcfg-eth0*; - Замініть *BOOTPROTO=dhcp* на *BOOTPROTO=none* - Додайте такі рядки: - *IPADDR=<IP-адреса готового рішення>* - *PREFIX=<префікс CIDR>* - *GATEWAY=<IP-адреса шлюзу>* - *DNS1=<IP-адреса сервера DNS>* - Виконайте команду **systemctl restart network**. За потреби зверніться до офіційної [документації](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/deployment_guide/s1-networkscripts-interfaces) Red Hat. ### version Module version. The version will be displayed in the Administration section. *Type*: String *Example*: ```json "version": "1.0" ``` ### version Версія модуля. Версія буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "version": "1.0" ``` #### Viewing data With an item defined, you might be curious if it is actually gathering data. For that, go to *Monitoring → Latest data*, select 'New host' in the filter and click on *Apply*. {width="600"} With that said, it may take up to 60 seconds for the first data to arrive. That, by default, is how often the server reads configuration changes and picks up new items to execute. If you see no value in the 'Change' column, maybe only one value has been received so far. Wait 30 seconds for another value to arrive. If you do not see information about the item as in the screenshot, make sure that: - you have filled out the item 'Key' and 'Type of information' fields exactly as in the screenshot; - both the agent and the server are running; - host status is 'Monitored' and its availability icon is green; - the host selected in the host filter is correct; - the item is enabled. #### Перегляд даних Якщо елемент даних визначено, вам може бути цікаво, чи він справді збирає дані. Для цього перейдіть до *Моніторинг → Останні дані*, виберіть 'New host' у фільтрі та натисніть *Застосувати*. {width="600"} З огляду на це, для надходження перших даних може знадобитися до 60 секунд. За замовчуванням це те, як часто сервер читає зміни налаштувань та вибирає нові елементи даних для виконання. Якщо ви не бачите значення в стовпці 'Змінити', можливо, наразі було отримано лише одне значення. Зачекайте 30 секунд, поки не прийде інше значення. Якщо ви не бачите інформації про елемент даних, як на знімку екрану, переконайтеся, що: - ви заповнили поля елементу даних 'Ключ' і 'Тип інформації' точно так, як на знімку екрану; - і агент, і сервер запущені; - стан вузла мережі 'Відстежується', а значок доступності зелений; - вузол мережі, вибраний у фільтрі вузлів мережі, правильний; - елемент даних включено. #### View mode buttons The following buttons located in the top right corner are common for every section: | | | |--|--------| ||Display page in kiosk mode. In this mode only page content is displayed.<br>To exit kiosk mode, move the mouse cursor until the  exit button appears and click on it. You will be taken back to normal mode.| #### Кнопки режиму перегляду Наступні кнопки, розташовані у верхньому правому куті, є загальними для кожного розділу: | | | |--|--------| ||Відображати сторінку в режимі кіоску. У цьому режимі відображається лише вміст сторінки.<br>Щоб вийти з режиму кіоску, перемістіть курсор миші до  з’явиться кнопка виходу та натисніть її. Ви повернетеся до звичайного режиму.| # Views View file receives the data from a controller and then prepares the HTML look of it. :::noteclassic Defining view(s) for a frontend module is optional, unless the module is a widget.\ Dashboard widgets need at least two views: one for the edit mode and one for the view mode (should be stored in the *views* directory). ::: It is possible to use pre-defined Zabbix HTML classes (from the */zabbix/ui/include/classes/html*) in the view as well as add new HTML and CSS classes. New classes should be stored in the module's *assets* folder. Example: ```` ... (new CColHeader(_('Name'))) ```` This will add a new column name *Name* and style the top table row as on other Zabbix pages. # Views View-файл отримує дані від контролера, а потім генерує їх HTML-відображення. :::noteclassic Створювати view-файл для інтерфейсного модуля необов’язково, якщо тільки модуль не є віджетом.\ Для віджетів інформаційної панелі потрібно принаймні два типу view: один для режиму редагування та інший для режиму перегляду (має зберігатися в каталозі *views*). ::: У view-файлах можна використовувати попередньо визначені класи Zabbix HTML (з */zabbix/ui/include/classes/html*), а також додавати нові класи HTML і CSS. Нові класи повинні зберігатися в каталозі модуля *assets* . приклад: ```` ... (new CColHeader(_('Name'))) ```` Це додасть нову назву стовпця *Name* і стилізує верхній рядок таблиці, аналогічно до інших сторінок Zabbix. ## vmware.hv.diskinfo.get The item **vmware.hv.diskinfo.get[]** returns JSON objects with the following structure (values are provided as an example): ```json [ { "instance": "mpx.vmhba32:C0:T0:L0", "hv_uuid": "8002299e-d7b9-8728-d224-76004bbb6100", "datastore_uuid": "", "operational_state": [ "ok" ], "lun_type": "disk", "queue_depth": 1, "model": "USB DISK", "vendor": "SMI Corp", "revision": "1100", "serial_number": "CCYYMMDDHHmmSS9S62CK", "vsan": {} }, { // other instances } ] ``` ## vmware.hv.diskinfo.get The item **vmware.hv.diskinfo.get[]** returns JSON objects with the following structure (values are provided as an example): ```json [ { "instance": "mpx.vmhba32:C0:T0:L0", "hv_uuid": "8002299e-d7b9-8728-d224-76004bbb6100", "datastore_uuid": "", "operational_state": [ "ok" ], "lun_type": "disk", "queue_depth": 1, "model": "USB DISK", "vendor": "SMI Corp", "revision": "1100", "serial_number": "CCYYMMDDHHmmSS9S62CK", "vsan": {} }, { // other instances } ] ``` #### Web monitoring Configure web scenarios to monitor your web applications and services. [Web scenario API](/manual/api/reference/httptest) #### Веб моніторинг Налаштуйте веб-сценарії для моніторингу веб-додатків і служб. [API веб-сценарію](/manual/api/reference/httptest) ### What a module can be used for - Adding new functionality via custom frontend sections; - Creating custom dashboard widget types (see [widget modules](/devel/modules/widgets)); - Overriding or extending the existing functionality. ### Для чого можна використовувати модуль - Додавання нової функціональності через користувацькі розділи інтерфейсу; - Створення користувацьких типів віджетів інформаційної панелі (див. [модулі віджетів](/devel/modules/widgets)); - Заміна або розширення наявної функціональності. ### What a module cannot be used for - Registering a new API method or modifying an existing one. ### Для чого не можна використовувати модуль - Реєстрація нового методу API або зміна існуючого. ### What is a PHP frontend module? - A module is an entity with a unique ID, name, description, author, and other fields defined in it's manifest file, along with PHP, Javascript and other files located in a single directory inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). - A module should conform to simple rules to guarantee correct operation. - A module must be installed (unpacked) and enabled in the frontend by the administrator. ### Що таке PHP frontend модуль ? - Модуль - це сутність з унікальним ідентифікатором, назвою, описом, автором та іншими полями, визначеними у файлі маніфесту, разом з PHP, Javascript та іншими файлами, розташованими в одному каталозі всередині каталогу *modules* вашої інсталяції web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). - Модуль повинен відповідати простим правилам, щоб гарантувати правильну роботу. - Модуль повинен бути встановлений (розпакований) і активований у web-інтерфейсі адміністратором. ## What you'll build During this tutorial, you will first build a [basic](#part-i---hello-world) "Hello, world!" widget and then convert it into a [more advanced](#part-ii---gauge-chart) widget that displays an item value as a gauge chart. Here's how the finished widget will look like: {width="600"} ## Що ви створите У цьому посібнику ви спочатку створите [базовий](#part-i---hello-world) віджет "Hello, world!", а потім перетворите його на [більш просунутий](#part-ii---gauge-chart) віджет, який відображає значення елемента даних у вигляді гістограми.Ось як виглядатиме готовий віджет: {width="600"} ### What you'll build During this tutorial, you will first build a frontend module that adds a new *My Address* menu section and then convert it into a [more advanced](#part-iii---module-action) frontend module that makes an HTTP request to *https://api.seeip.org* and displays the response - the IP address of your computer - on a new page in the newly created *My Address* menu section. Here's how the finished module will look like: {width="600"} ### Що ви створите У цьому уроці ви спочатку створите модуль інтерфейсу, який додає новий розділ меню *Моя адреса*, а потім перетворите його на [більш просунутий] (#part-iii---module-action) модуль інтерфейсу, який робить HTTP-запит до *https://api.seeip.org* і відображає відповідь - IP-адресу вашого комп'ютера - на новій сторінці в новоствореному розділі меню *Моя адреса*. Ось як виглядатиме готовий модуль: {width="600"} ### What you'll create During this tutorial, you will add a new loadable plugin **MyIP**. The plugin will implement 1 metric called **myip**, which returns the external IP address of the host where Zabbix agent 2 is running. ### Що ви створите Під час цього уроку ви додасте новий завантажуваний плагін **MyIP**. Плагін реалізує 1 метрику під назвою **myip**, яка повертає зовнішню IP-адресу хоста, на якому запущено Zabbix Agent 2. ### Where to go next Whether you prefer to learn by doing or read the guidelines first, these pages contain the information and steps required to build your own modules: - [Step-by-step tutorials for writing your first module](/devel/modules/tutorials) - [Module file structure](/devel/modules/file_structure) - [Widget module specifics](/devel/modules/widgets) - [Module examples to reuse](/devel/modules/examples) ### Куди рухатися далі Незалежно від того, чи віддаєте ви перевагу навчанню на практиці, чи спочатку читаєте інструкції, ці сторінки містять інформацію та кроки, необхідні для створення власних модулів: - [Покрокові посібники для написання вашого першого модуля](/devel/modules/tutorials) - [Файлова структура модуля](/devel/modules/file_structure) - [Особливості модуля віджетів](/devel/modules/widgets) - [Приклади модулів для повторного використання](/devel/modules/examples) ### Widget action The widget action class (*WidgetView*) contains methods for operations with widgets in the presentation view mode. The majority of widget actions use and/or extend the default controller class *CControllerDashboardWidgetView*. The widget action class should be located in the *actions* directory and specified in the [*actions*](/devel/modules/file_structure/manifest#actions) parameter (*actions/widget.{id}.view/class*) in the *manifest.json* file. **actions/WidgetView.php example (implemented in the Zabbix-native [*System information*](/manual/web_interface/frontend_sections/dashboards/widgets/system) widget)** ```php class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getDefaultName()), 'system_info' => CSystemInfoHelper::getData(), 'info_type' => $this->fields_values['info_type'], 'user_type' => CWebUser::getType(), 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` ### Widget action Клас дій віджетів (*WidgetView*) містить методи для роботи з віджетами в режимі перегляду презентації. Більшість дій віджетів використовують та/або розширюють клас контролера за замовчуванням *CControllerDashboardWidgetView*. Клас дій віджета має розташовуватися в каталозі *actions* і вказуватися в параметрі [*actions*](/devel/modules/file_structure/manifest#actions) (*actions/widget.{id}.view/class*) у файлі *manifest.json*. **actions/WidgetView.php приклад (реалізований у стандартному для Zabbix віджеті [*Системна інформація*](/manual/web_interface/frontend_sections/dashboards/widgets/system)** ```php class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getDefaultName()), 'system_info' => CSystemInfoHelper::getData(), 'info_type' => $this->fields_values['info_type'], 'user_type' => CWebUser::getType(), 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` ### Widget examples - Minimal widget - [widget_min.zip](/../assets/en/devel/modules/examples/widget_min.zip) - "Hello, world" widget using CSS only - [hello_world_css.zip](/../assets/en/devel/modules/examples/hello_world_css.zip) - "Hello, world" widget using JavaScript only - [hello_world_js.zip](/../assets/en/devel/modules/examples/hello_world_js.zip) - "Hello, world" widget using PHP - [hello_world_php.zip](/../assets/en/devel/modules/examples/hello_world_php.zip) ::: notetip You can also use [Zabbix native widgets](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/widgets) as examples. ::: ### Приклади віджетів - Мінімальний віджет - [widget_min.zip](/../assets/en/devel/modules/examples/widget_min.zip) - Віджет "Hello, world" лише з використанням CSS - [hello_world_css.zip](/../assets/en/devel/modules/examples/hello_world_css.zip) - Віджет "Hello, world" використовує лише JavaScript - [hello_world_js.zip](/../assets/en/devel/modules/examples/hello_world_js.zip) - Віджет "Hello, world" з використанням PHP - [hello_world_php.zip](/../assets/en/devel/modules/examples/hello_world_php.zip) ::: підказка Ви також можете використовувати [власні віджети Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/widgets) як приклади. ::: ### WidgetForm The *WidgetForm* class extends the default class *CWidgetForm* and contains a set of [*CWidgetField*](#cwidgetfield) fields that are required for defining widget configuration storage structure in the database and handling input validation. The *WidgetForm* class should be located in the *includes* directory. If the class has a different name, the name should be specified in the [*widget/form_class*](/devel/modules/file_structure/manifest#widget) parameter in the *manifest.json* file. **includes/WidgetForm.php example** ```php <?php namespace Modules\MyCustomWidget\Includes; use Modules\MyCustomWidget\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox, CWidgetFieldColor }; class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ); } } ``` ### WidgetForm Клас *WidgetForm* розширює стандартний клас *CWidgetForm* і містить набір полів [*CWidgetField*](#cwidgetfield). які необхідні для визначення структури зберігання конфігурації віджета в базі даних і обробки валідації вхідних даних. Клас *WidgetForm* має бути розташований у каталозі *includes*. Якщо клас має іншу назву, її потрібно вказати в параметрі [*widget/form_class*](/devel/modules/file_structure/manifest#widget) у файлі *manifest.json*. **includes/WidgetForm.php приклад** ```php <?php namespace Modules\MyCustomWidget\Includes; use Modules\MyCustomWidget\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox, CWidgetFieldColor }; class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ); } } ``` ## Widget preview Widget modules, once added, become immediately visible in the dashboard widget list. You can open a dashboard, switch to the edit mode and add the widget to the dashboard as usual. When you make some changes to the widget, refresh the dashboard to view how the widget looks with the most recent updates. ## Попередній перегляд віджета Модулі віджетів після додавання відразу стають видимими в списку віджетів інформаційної панелі. Ви можете відкрити інформаційну панель, перейти в режим редагування та додати віджет на інформаційну панель, як зазвичай. Після внесення змін у віджет, оновіть інформаційну панель, щоб побачити, як виглядає віджет з останніми оновленнями. ### Widget Primary widget class, extends the base class of all dashboard widgets - *CWidget*. Required for overriding the default widget behavior. The *Widget* class should be located in the root directory of the widget (for example, *zabbix/ui/modules/my_custom_widget*). **Widget.php example** ```php <?php namespace Modules\MyCustomWidget; use Zabbix\Core\CWidget; class Widget extends CWidget { public const MY_CONSTANT = 0; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` ### Віджет Основний клас віджетів, розширює базовий клас усіх віджетів інформаційної панелі - *CWidget*. Необхідний для заміни поведінки віджета за замовчуванням. Клас *Widget* має бути розташований у кореневому каталозі віджета (наприклад, *zabbix/ui/modules/my_custom_widget*). **Приклад Widget.php** ```php <?php namespace Modules\MyCustomWidget; use Zabbix\Core\CWidget; class Widget extends CWidget { public const MY_CONSTANT = 0; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` # Widgets Widgets are Zabbix frontend modules used for the dashboards. Unless otherwise noted, all module guidelines are also applicable to widgets. However, a widget is notably different from a module. To build a widget: - specify the type "widget" in the [manifest.json file](/devel/modules/file_structure/manifest) ("type": "widget"); - include at least two views: one for the [widget presentation mode](/devel/modules/widgets/presentation#widget-view) and one for the [widget configuration mode](/devel/modules/widgets/configuration#widget-configuration-view) (example.widget.view.php and example.widget.edit.php); - and a [controller](/devel/modules/widgets/presentation#widget-actions) for widget presentation (WidgetView.php); - use and extend default [widget classes](/devel/modules/widgets/configuration). # Віджети Віджети — це інтерфейсні модулі Zabbix, які використовуються для інформаційних панелей. Якщо не зазначено інше, усі інструкції щодо модуля також застосовуються до віджетів. Однак віджет значно відрізняється від модуля. Щоб створити віджет: - вкажіть тип "widget" у [файлі manifest.json](/devel/modules/file_structure/manifest) ("type": "widget"); - включіть принаймні два view: один для [режиму презентації віджетів](/devel/modules/widgets/presentation#widget-view) і один для [режиму конфігурації віджетів](/devel/modules/widgets/configuration#widget- configuration-view) (example.widget.view.php і example.widget.edit.php); - і [контролер](/devel/modules/widgets/presentation#widget-actions) для представлення віджетів (WidgetView.php); - використовуйте та розширюйте стандартні [класи віджетів](/devel/modules/widgets/configuration). ### Widget view The widget view class (*CWidgetView*) is responsible for building the widget presentation view. The widget view class should be located in the *views* directory. If the file containing the widget view class has a different name than the default (*widget.view.php*), then it must be specified in the *manifest.json* file [*actions*](/devel/modules/file_structure/manifest#actions) parameter (*actions/widget.{id}.view/view*). **views/widget.view.php example** ```php <?php /** * My custom widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, $data['name']) ) ->show(); ``` ### Widget view Клас view віджетів (*CWidgetView*) відповідає за створення представлення view віджетів. Клас view віджета має бути розташований у каталозі *views*. Якщо файл, що містить клас view віджетів, має іншу назву, ніж назва за замовчуванням (*widget.view.php*), тоді її потрібно вказати у файлі *manifest.json* [*actions*](/devel/modules/file_structure /manifest#actions) параметр (*actions/widget.{id}.view/view*). **views/widget.view.php приклад** ```php <?php /** * My custom widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->additem( new CTag('h1', true, $data['name']) ) ->show(); ``` ### widget Widget configuration. Used, if *[type](#type)* is set to *widget*. *Type*: Object *Supported object keys:* - **name** (string) - used in the widget list and as default header. If empty, "name" parameter from the module will be used. - **size** (object) - default widget dimensions. Supports keys: - *width* (integer) - default widget width. - *height* (integer) - default widget height. - **form_class** (string) - class with widget fields form. Must be located in the *includes* directory. If the class is *WidgetForm.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. - **js_class** (string) - name of a JavaScript class for widget view mode to extend the default CWidget class. The class will be loaded with the dashboard. The class source file must be located in the assets/js directory. See also: [assets](#assets). - **use_time_selector** (boolean) - determines whether the widget requires dashboard time selector. Supported values: *true*, *false* (default). - **refresh_rate** (integer) - widget refresh rate in seconds (default: 60). *Example*: ```json "widget": { "name": "", "size": { "width": 12, "height": 5 }, "form_class": "WidgetForm", "js_class": "CWidget", "use_time_selector": false, "refresh_rate": 60 } ``` ### widget Конфігурація віджета. Використовується, якщо *[type](#type)* має значення *widget*. *Тип*: Object *Підтримувані ключі об’єктів:* - **name** (string) - використовується у списку віджетів і як заголовок за замовчуванням. Якщо значення пусте, буде використано параметр "name" модуля. - **size** (object) - розміри віджета за замовчуванням. Підтримує ключі: - *width* (integer) - ширина віджета за замовчуванням. - *height* (integer) - висота віджета за замовчуванням. - **form_class** (string) - клас з формою полів віджетів. Повинен знаходитися в каталозі *includes*. Якщо класом є *WidgetForm.php*, який очікується за замовчуванням, цей параметр можна опустити. Якщо ви використовуєте інше ім’я, вкажіть його тут. - **js_class** (string) - назва класу JavaScript для режиму перегляду віджетів для розширення стандартного класу CWidget. Клас буде завантажено разом із панеллю інструментів. Вихідний файл класу має бути розташований у каталозі assets/js. Дивіться також: [assets](#assets). - **use_time_selector** (boolean) - визначає, чи потрібен віджет селектор часу на інформаційній панелі. Підтримувані значення: *true*, *false* (за замовчуванням). - **refresh_rate** (integer) - частота оновлення віджета в секундах (за замовчуванням: 60). *Приклад*: ```json "widget": { "name": "", "size": { "width": 12, "height": 5 }, "form_class": "WidgetForm", "js_class": "CWidget", "use_time_selector": false, "refresh_rate": 60 } ``` ### Writing a module A sample module writing process consists of the following steps (where available, click on the file or folder name to view additional details about the step): 1. Create a new directory for the module inside **zabbix/ui/modules/**. 2. Add [manifest.json](/devel/modules/file_structure/manifest) file with module metadata. 3. Create *[views](/devel/modules/file_structure/views)* folder and define a module view(s). 4. Create *[actions](/devel/modules/file_structure/actions)* folder and define a module action(s). 5. Create Module.php (or Widget.php for dashboard widgets) file and define initialization and event handling rules. 6. Create *[assets](/devel/modules/file_structure/assets)* folder for JavaScript files (place into *assets/js*), CSS styles (place into *assets/css*), or any other additional files. 7. Make sure to specify required views, actions and asset files in the manifest.json. 8. [Register](/devel/modules/file_structure/register) the module in Zabbix frontend and start using it. :::notetip You can register and enable a module as soon as you create manifest.json file. Once the module is enabled, you can preview all changes made to module files immediately by refreshing Zabbix frontend. ::: ### Написання модуля Приклад процесу написання модуля складається з наступних кроків (там, де це можливо, клацніть на назві файлу або папки, щоб переглянути додаткову інформацію про крок): 1. Створіть новий каталог для модуля всередині **zabbix/ui/modules/**. 2. Додайте файл [manifest.json](/devel/modules/file_structure/manifest) із метаданими модуля. 3. Створіть папку *[views](/devel/modules/file_structure/views)* та визначте вид(и) модуля. 4. Створіть папку *[actions](/devel/modules/file_structure/actions)* та визначте дії модуля. 5. Створіть файл Module.php (або Widget.php для віджетів інформаційної панелі) і визначте правила ініціалізації та обробки подій. 6. Створіть папку *[assets](/devel/modules/file_structure/assets)* для файлів JavaScript (розмістіть у *assets/js*), стилів CSS (розмістіть у *assets/css*) або будь-яких інших додаткових файлів. 7. Переконайтеся, що в manifest.json вказані необхідні views, actions та assets. 8. [Зареєструйте](/devel/modules/file_structure/register) модуль у інтерфейсі Zabbix і почніть його використовувати. :::notetip Ви можете зареєструвати та ввімкнути модуль, щойно створите файл manifest.json. Після ввімкнення модуля ви можете одразу переглянути всі зміни, внесені до файлів модуля, перезавантаживши інтерфейс Zabbix. ::: # zabbix\_agent2 Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_agent2 Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_agentd Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_agentd Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} #### Zabbix agent For passive checks Zabbix agent needs to know the IP address or DNS name of Zabbix server. If you have provided correct information during the agent installation, the configuration file is already updated. Otherwise, you need to manually specify it. Go to the `C:\Program files\Zabbix Agent` folder, open the file *zabbix_agentd.conf* and add the IP/DNS of your Zabbix server to the *Server* parameter. Example: Server=192.0.2.22 #### Zabbix agent For passive checks Zabbix agent needs to know the IP address or DNS name of Zabbix server. If you have provided correct information during the agent installation, the configuration file is already updated. Otherwise, you need to manually specify it. Go to the `C:\Program files\Zabbix Agent` folder, open the file *zabbix_agentd.conf* and add the IP/DNS of your Zabbix server to the *Server* parameter. Example: Server=192.0.2.22 #### Zabbix agent In the `C:\Program files\Zabbix Agent` folder open the file *zabbix_agentd.conf* and add: - The name of the host you created in Zabbix web interface to the *Hostname* parameter. - The IP address or DNS name of your Zabbix server machine to the *ServerActive* parameter (might be prefilled if you have provided it during Zabbix agent setup). Example: ServerActive= 192.0.2.22 Hostname=Windows workstation #### Zabbix agent In the `C:\Program files\Zabbix Agent` folder open the file *zabbix_agentd.conf* and add: - The name of the host you created in Zabbix web interface to the *Hostname* parameter. - The IP address or DNS name of your Zabbix server machine to the *ServerActive* parameter (might be prefilled if you have provided it during Zabbix agent setup). Example: ServerActive= 192.0.2.22 Hostname=Windows workstation # Zabbix documentation These pages contain official Zabbix documentation. Use the sidebar navigation to browse documentation pages. To be able to watch pages, log in with your [Zabbix forums](http://www.zabbix.com/forum/) username and password. # Документація Zabbix Ці сторінки містять офіційну документацію Zabbix. Використовуйте навігацію на бічній панелі, щоб переглядати сторінки документації. Щоб мати можливість переглядати сторінки, увійдіть, використовуючи своє ім’я користувача та пароль [на форумах Zabbix](http://www.zabbix.com/forum/). #### Zabbix frontend 1\. Log into Zabbix frontend. 2\. [Create a host](/manual/config/hosts/host) in Zabbix web interface. This host will represent your Windows machine. 3\. In the *Interfaces* parameter, add *Agent* interface and specify the IP address or DNS name of the Windows machine where the agent is installed. 4\. In the *Templates* parameter, type or select *Windows by Zabbix agent*. {width="600"} #### Zabbix frontend 1\. Log into Zabbix frontend. 2\. [Create a host](/manual/config/hosts/host) in Zabbix web interface. This host will represent your Windows machine. 3\. In the *Interfaces* parameter, add *Agent* interface and specify the IP address or DNS name of the Windows machine where the agent is installed. 4\. In the *Templates* parameter, type or select *Windows by Zabbix agent*. {width="600"} # Zabbix manpages These are Zabbix manpages for Zabbix processes. # Сторінки довідки Zabbix Це сторінки довідки Zabbix для процесів Zabbix. # Zabbix Manual Welcome to the user manual for Zabbix software. These pages are created to help users successfully manage their monitoring tasks with Zabbix, from the simple to the more complex ones. # Посібник Zabbix Ласкаво просимо до посібника користувача програмного забезпечення Zabbix. Ці сторінки створені, щоб допомогти користувачам успішно керувати своїми завданнями моніторингу за допомогою Zabbix, від простих до складніших. # zabbix\_proxy Section: Maintenance Commands (8)\ Updated: 2020-09-04\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_proxy Розділ: Команди обслуговування (8)\ Оновлено: 04.09.2020\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_sender Section: User Commands (1)\ Updated: 2021-06-01\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_sender Розділ: Команди користувача (1)\ Оновлено: 01.06.2021\ [Зміст](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_server Section: Maintenance Commands (8)\ Updated: 2020-09-04\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_server Розділ: Команди обслуговування (8)\ Оновлено: 04.09.2020\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_web\_service Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_web\_service Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} ### ### # 10 Virtual machine monitoring # 10 Моніторинг віртуальних машин # 11 Time zones # 11 Часові пояси # 13 Problem acknowledgment # 13. Підтвердження проблеми # 14 Configuration export/import # 14. Експорт/імпорт конфігурації # 15 Data export # 15 Експорт даних # 17 Encryption # 17 Шифрування # 18 Web interface # 18. Веб-інтерфейс # 1 Creating an item # 1 Створення елементу данних # 1 Database creation # 1 Створення бази даних # 1 Foreach functions # 1 Функції Foreach # 1 Global notifications # 1 Глобальні сповіщення # 1 Graphs # 1 Графіки # 1 High availability # 1 Висока доступність # 1 Introduction Please use the sidebar to access content in the Introduction section. # 1. Вступ Будь ласка, використовуйте бічну панель, щоб отримати доступ до вмісту вступного розділу. # 1 Login and configuring user # 1 Вхід і налаштування користувача # 1 Manual structure # 1 Структура посібника # 1 Menu # 1 Меню # 1 Problem suppression # 1 Приховування проблеми # 1 Web monitoring items # 1 Елементи веб-моніторингу # 2 Frontend sections # 2 Інтерфейсні розділи # 2 Monitor Windows with Zabbix agent # 2 Monitor Windows with Zabbix agent # 2 New host # 2 Новий вузол мережі # 2 Passive and active agent checks # 2 Passive and active agent checks # 2 Real-life scenario # 2 Реальний сценарій # 2 Repairing Zabbix database character set and collation # 2 Відновлення набору символів і сортування бази даних Zabbix # 2 Sound in browsers # 2 Звук в браузерах # 3 New item # 3 Новий елемент даних # 3 Templates # 3 Шаблони # 3 User settings # 3 Налаштування користувача # 3 Zabbix processes Please use the sidebar to access content in the Zabbix process section. # 3. Процеси Zabbix Для доступу до вмісту розділу "Процеси Zabbix", будь ласка, використовуйте бічну панель. # 4 New trigger # 4 Новий тригер # 4 Proxy # 4 Проксі # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 Zabbix agent 2 (UNIX) # 4 Zabbix агент 2 (UNIX) # 5 Frontend maintenance mode # 5 Режим обслуговування інтерфейсу # 5 Quickstart Please use the sidebar to access content in the Quickstart section. # 5. Швидкий початок Будь ласка, використовуйте бічну панель для доступу до вмісту в розділі швидкого початку. # 5 Receiving problem notification # 5 Отримання повідомлення про проблему # 6 Action log # 6 Журнал дій # 6 New template # 6 Новий шаблон # 6 Page parameters # 6 Параметри сторінки # 6 Zabbix appliance # 6. Готове рішення Zabbix # 8 Creating your own theme # 8 Створення власної теми # 9 Queue # 9 Черга # 9 Zabbix web service # 9 Веб-сервіс Zabbix # action.create # action.create # action.delete # action.delete # action.get # action.get # Actions Actions are responsible for 'business logic' of the module. An action usually consists of a [controller](#controller) and an [action view](views#action-view). A module can: - Call actions that are already defined in Zabbix frontend. - Override default actions with custom actions. - Define completely new actions. To override a default action behavior with some custom behavior, define an action with the same name in the module configuration. When the action is called, the module action will be executed instead of the default Zabbix action. Action files should be stored in the *actions* folder. The actions need to be specified in the [manifest.json](manifest). # Actions Дії відповідають за «бізнес-логіку» модуля. Зазвичай дія складається з [контролера](#controller) і [перегляду дії](views#action-view). Модуль може: - Викликати дії, які вже визначені у інтерфейсі Zabbix. - Замінювати дії за замовчуванням власними діями. - Визначати абсолютно нові дії. Щоб замінити поведінку дій за замовчуванням на якусь настроювану поведінку, визначте дію з такою самою назвою в конфігурації модуля. Під час виклику дії буде виконано дію модуля замість типової дії Zabbix. Файли дій повинні зберігатися в папці *actions*. Дії потрібно вказати в [manifest.json](маніфест). ### actions Actions to register with the module. Defining *class* object key for each action is required, other action keys are optional. *Type*: Object Supported object keys if *[type](#type)* is *module*: - **write.your.action.name** (object) - action name, should be written in lowercase [a-z], separating words with dots. Supports the keys: - **class** (string; required) - action class name. - **layout** (string) - action layout. Supported values: *layout.json*, *layout.htmlpage* (default), *null*. - **view** (string) - action view. *Example*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` Supported object keys if *[type](#type)* is *widget*: - **widget.{id}.view** (object) - file and class name for widget view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.view*). Supports the keys: - **class** (string; required) - action class name for widget view mode to extend the default CControllerDashboardWidgetView class. The class source file must be located in the *actions* directory. - **view** (string) - widget view. Must be located in the *views* directory. If the view file is *widget.view.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. - **widget.{id}.edit** (object) - file name for widget configuration view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.edit*). Supports the keys: - **class** (string; required) - action class name for widget configuration view mode. The class source file must be located in the *actions* directory. - **view** (string) - widget configuration view. Must be located in the *views* directory. If the view file is *widget.edit.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. *Example*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ``` ### actions Дії для реєстрації в модулі. Необхідно визначити ключ об’єкта *class* для кожної дії, інші ключі дії необов’язкові. *Тип*: Object Підтримувані ключі об’єктів, якщо *[type](#type)* є *module*: - **write.your.action.name** (object) - назва дії, має бути написано малими літерами [a-z], розділяючи слова крапками. Підтримує ключі: - **class** (string; required) - назва класу дії. - **layout** (string) - розкладка дії. Підтримувані значення: *layout.json*, *layout.htmlpage* (за замовчуванням), *null*. - **view** (string) - представлення дії. *Приклад*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` Підтримувані ключі об’єктів, якщо *[type](#type)* є *widget*: - **widget.{id}.view** (object) - ім'я файлу та класу для представлення віджетів. Замініть **{id}** значенням [id](#id) віджета (наприклад, *widget.example_clock.view*). Підтримує ключі: - **class** (string; required) - ім'я класу дії для режиму перегляду віджетів для розширення стандартного класу CControllerDashboardWidgetView. Вихідний файл класу має бути розташований у каталозі *actions*. - **view** (string) - представлення віджета. Повинен знаходитися в каталозі *views*. Якщо файл представлення *widget.view.php*, що очікується за замовчуванням, цей параметр може бути пропущений. Якщо ви використовуєте інше ім’я, вкажіть його тут. - **widget.{id}.edit** (object) - ім'я файлу для представлення конфігурації віджета. Замініть **{id}** значенням [id](#id) віджета (наприклад, *widget.example_clock.edit*). Підтримує ключі: - **class** (string; required) - назва класу дії для режиму представлення конфігурації віджета. Вихідний файл класу має бути розташований у каталозі *actions*. - **view** (string) - представлення конфігурації віджета. Повинен знаходитися в каталозі *views*. Якщо файл представлення *widget.edit.php*, що очікується за замовчуванням, цей параметр може бути пропущений. Якщо ви використовуєте інше ім’я, вкажіть його тут. *Приклад*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ``` #### Actions and alerts Define actions and operations to notify users about certain events or automatically execute remote commands. Gain access to information about generated alerts and their receivers. [Action API](/manual/api/reference/action) | [Alert API](/manual/api/reference/alert) #### Дії та сповіщення Визначення дій та операції для сповіщення користувачів про певні події або автоматичного виконання віддалених команд. Отримання доступу до інформації про згенеровані сповіщення та їх отримувачів. [API дій](/manual/api/reference/action) | [API сповіщень](/manual/api/reference/alert) # action.update # action.update ### Action view This is a reference file for defining an action view. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ```` ### Action view Це довідковий файл для створення Action view. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ```` ### Add advanced configuration settings to a configuration view In this section, you will learn how to add an expandable/collapsible *Advanced configuration* section with optional parameters, such as color, minimum and maximum values, units and the *Description* field created earlier. 1. Create a *Widget.php* file in the main widget directory *lesson_gauge_chart* to create a new class *Widget*. The *Widget* class will extend the *CWidget* base class to add/override the default widget settings (in this case - translations). JavaScript, provided below, displays the string "No data" in case of missing data. The "No data" string is present in the Zabbix UI translation files. If there are any widget constants, it is recommended to also specify them in the *Widget* class. **ui/modules/lesson_gauge_chart/Widget.php** ```php <?php namespace Modules\LessonGaugeChart; use Zabbix\Core\CWidget; class Widget extends CWidget { public const UNIT_AUTO = 0; public const UNIT_STATIC = 1; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` 2. Open *includes/WidgetForm.php* and add the new fields *Color* (color picker), *Min* (numeric field), *Max* (numeric field), and *Units* (select), and define the default color palette for the color picker, so that it can be used in the next steps. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Modules\LessonGaugeChart\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldColor, CWidgetFieldMultiSelectItem, CWidgetFieldNumericBox, CWidgetFieldSelect, CWidgetFieldTextBox }; /** * Gauge chart widget form. */ class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ) ->addField( (new CWidgetFieldNumericBox('value_min', _('Min'))) ->setDefault(0) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldNumericBox('value_max', _('Max'))) ->setDefault(100) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldSelect('value_units', _('Units'), [ Widget::UNIT_AUTO => _x('Auto', 'history source selection method'), Widget::UNIT_STATIC => _x('Static', 'history source selection method') ]))->setDefault(Widget::UNIT_AUTO) ) ->addField( (new CWidgetFieldTextBox('value_static_units')) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 3. Open *views/widget.edit.php* and add the field visual components to the configuration view. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid'])) ->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_min']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_max']) ) ->addItem([ $lefty_units->getLabel(), (new CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ])) ]) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ) ->show(); ``` ::: noteclassic The *addField()* method of the *CWidgetFormView* class takes a CSS class string as the second parameter. ::: 4. Return to the dashboard, switch to the edit mode and click on the gear icon in the widget to open the widget configuration form. The widget configuration form now contains a new expandable/collapsible section *Advanced configuration*. {width="600"} 5. Expand the *Advanced configuration* section to see additional widget configuration fields. Note that the field *Color* has no color picker yet. This is because the color picker must be initialized with JavaScript, which will be added in the next section - [*Add JavaScript to the widget*](#add-javascript-to-the-widget). {width="600"} ### Додайте розширені параметри конфігурації до перегляду конфігурації У цьому розділі ви дізнаєтеся, як додати розширюваний/згортаний розділ *Розширена конфігурація* з необов’язковими параметрами, такими як колір, мінімальні та максимальні значення, одиниці вимірювання та поле *Опис*, що створене раніше. 1. Створіть файл *Widget.php* у головному каталозі віджетів *lesson_gauge_chart*, щоб створити новий клас *Widget*. Клас *Widget* розширить базовий клас *CWidget*, щоб додати/замінити параметри віджета за замовчуванням (у цьому випадку - переклади). JavaScript, наведений нижче, відображає рядок «Немає даних» у разі відсутності даних. Рядок «Немає даних» присутній у файлах перекладу інтерфейсу Zabbix. Якщо є будь-які константи віджетів, рекомендується також вказати їх у класі *Widget*. **ui/modules/lesson_gauge_chart/Widget.php** ```php <?phpnamespace Modules\LessonGaugeChart;use Zabbix\Core\CWidget;class Widget extends CWidget {public const UNIT_AUTO = 0;public const UNIT_STATIC = 1;public function getTranslationStrings(): array {return ['class.widget.js' => ['No data' => _('No data')]];}}``` 2. Відкрийте *includes/WidgetForm.php* і додайте нові поля *Color* (вибір кольору), *Min* (числове поле), *Max* (числове поле) і *Units* (вибір), а також визначте палітру кольорів за замовчуванням для засобу вибору кольорів, щоб її можна було використовувати на наступних кроках. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php простір імен Modules\LessonGaugeChart\Includes; використовувати Modules\LessonGaugeChart\Widget; використовувати Zabbix\Widgets\{ CWidgetField, CWidgetForm }; використовувати Zabbix\Widgets\Fields\{ CWidgetFieldColor, CWidgetFieldMultiSelectItem, CWidgetFieldNumericBox, CWidgetFieldSelect, CWidgetFieldTextBox }; /** * Форма віджета вимірювальної діаграми. */ class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; публічна функція addFields(): self { повернути $це ->addField( (новий CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( (новий CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ) ->addField( (новий CWidgetFieldNumericBox('value_min', _('Min'))) ->setDefault(0) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (новий CWidgetFieldNumericBox('value_max', _('Max'))) ->setDefault(100) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (новий CWidgetFieldSelect('value_units', _('Units'), [ Віджет::UNIT_AUTO => _x('Авто', 'метод вибору джерела історії'), Віджет::UNIT_STATIC => _x('Статичний', 'метод вибору джерела історії') ]))->setDefault(Widget::UNIT_AUTO) ) ->addField( (новий CWidgetFieldTextBox('value_static_units')) ) ->addField( новий CWidgetFieldTextBox('опис', _('Опис')) ); } } ``` 3. Відкрийте *views/widget.edit.php* і додайте візуальні компоненти поля до перегляду конфігурації. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Перегляд форми віджета вимірювальної діаграми. * * @var CПереглянути $це * @var масив $data */ $lefty_units = новий CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (новий CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (новий CWidgetFormView($data)) ->addField( (новий CWidgetFieldMultiSelectItemView($data['fields']['itemid'])) ->setPopupParameter('numeric', true) ) ->addFieldset( (новий CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( новий CWidgetFieldColorView($data['fields']['chart_color']) ) ->addField( новий CWidgetFieldNumericBoxView($data['fields']['value_min']) ) ->addField( новий CWidgetFieldNumericBoxView($data['fields']['value_max']) ) ->addItem([ $lefty_units->getLabel(), (новий CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ])) ]) ->addField( новий CWidgetFieldTextBoxView($data['fields']['description']) ) ) ->показати(); ``` ::: noteclassic Метод *addField()* класу *CWidgetFormView* приймає рядок класу CSS як другий параметр. ::: 4. Поверніться на інформаційну панель, перейдіть у режим редагування та клацніть значок шестірні у віджеті, щоб відкрити форму налаштування віджета. Форма конфігурації віджета тепер містить новий розділ, який можна розширювати/згортати *Розширена конфігурація*. {width="600"} 5. Розгорніть розділ *Додаткова конфігурація*, щоб побачити додаткові поля конфігурації віджетів. Зауважте, що поле *Колір* ще не має вибору кольору. Це пояснюється тим, що засіб вибору кольорів має бути ініціалізовано за допомогою JavaScript, який буде додано в наступному розділі – [*Додати JavaScript до віджета*](#add-javascript-to-the-widget). {width="600"} ### Add CSS styles to the widget In this section you will learn how to add custom CSS styles to make the widget look more appealing. 1. For widget styles, create a new directory *css* in the *assets* directory. 2. Create a *widget.css* file in the *assets/css* directory. To style widget elements, use the selector *div.dashboard-widget-{widget id}*. To configure CSS for the whole widget, use the selector *form.dashboard-widget-{widget id}* **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart .chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart .chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart .description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2; text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart { margin-top: 8px; } ``` 3. Open *manifest.json* and add the CSS file name (*widget.css*) to the array in the *assets/css* section. This will allow the CSS styles defined in *widget.css* to load with the dashboard page. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` 4. Refresh the dashboard page to see the finished version of the widget. {width="600"} ### Додайте CSS стилі до віджету У цьому розділі ви дізнаєтеся, як додати власні стилі CSS, щоб зробити віджет більш привабливим. 1. Для стилів віджетів створіть новий каталог *css* у каталозі *assets*. 2. Створіть файл *widget.css* у каталозі *assets/css*. Щоб стилізувати елементи віджета, використовуйте селектор *div.dashboard-widget-{widget id}*. Щоб налаштувати CSS для всього віджета, використовуйте селектор *form.dashboard-widget-{widget id}* **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart .chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart .chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart .description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2;text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart { margin-top: 8px; } ``` 3. Відкрийте *manifest.json* і додайте назву файлу CSS (*widget.css*) до масиву в розділі *assets/css*. Це дозволить стилям CSS, визначеним у *widget.css*, завантажуватись зі сторінкою інформаційної панелі. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "leson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` 4. Оновіть сторінку інформаційної панелі, щоб побачити готову версію віджета. {width="600"} ## Adding a module Open *Administration→General→Modules* page and press *Scan directory*.  Locate your module in the list and activate it. To activate a module, press on the *Disabled* hyperlink - the module's state will change to *Enabled*. Press on the module name to view additional information about the module, such as author, version, or short description (if defined in the manifest). ## Додавання модуля Відкрийте сторінку *Адміністрування→Загальні→Модулі* і натисніть *Сканувати дерикторію*.  Знайдіть свій модуль у списку та активуйте його. Щоб активувати модуль, натисніть на гіперпосилання *Дезактивовано* - стан модуля зміниться на *Активовно*. Натисніть назву модуля, щоб переглянути додаткову інформацію про модуль, наприклад автора, версію або короткий опис (якщо визначено в маніфесті). ## Administration With the Zabbix API you can change administration settings of your monitoring system. ## Адміністрація За допомогою Zabbix API ви можете змінювати налаштування адміністрування вашої системи моніторингу. ##### 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. Зверніть увагу, що для активних перевірок, вузли одного кластеру повинні бути відокремлені від інших Zabbix серверів комою, а самі вузли повинні бути розділені **крапкою з комою**, наприклад: ``` ServerActive=zabbix-node-01;zabbix-node-02 ``` # alert.get # alert.get ## Alerts The Zabbix API allows you to manage the actions and alerts of your monitoring system. ## Сповіщення Zabbix API дозволяє вам керувати діями та сповіщеннями вашої системи моніторингу. ### API information Retrieve the version of the Zabbix API so that your application could use version-specific features. [API info API](/manual/api/reference/apiinfo) ### Інформація про API Отримайте версію Zabbix API, щоб ваша програма могла використовувати особливості версії. [API інформації про API](/manual/api/reference/apiinfo) # apiinfo.version # apiinfo.version #### API Tokens Manage authorization tokens. [Token API](/manual/api/reference/token) #### API Токени Керуйте токенами авторизації. [API токенів](/manual/api/reference/token) ### API versions To simplify API versioning, since Zabbix 2.0.4, the version of the API matches the version of Zabbix itself. You can use the [apiinfo.version](/manual/api/reference/apiinfo/version) method to find out the version of the API you are working with. This can be useful for adjusting your application to use version-specific features. Zabbix guarantees feature backward compatibility inside a major version. When making backward incompatible changes between major releases, Zabbix usually leaves the old features as deprecated in the next release, and only removes them in the release after that. Occasionally, Zabbix may remove features between major releases without providing any backward compatibility. It is important that you never rely on any deprecated features and migrate to newer alternatives as soon as possible. ::: notetip You can follow all the changes made to the API in the [API changelog](/manual/api/changes). ::: ### версії API Для спрощення керування версіями API, починаючи з Zabbix 2.0.4, версія API відповідає версії самого Zabbix. Ви можете використовувати [apiinfo.version](/manual/api/reference/apiinfo/version) метод пошуку версії API, з якою ви працюєте. Це може бути корисно для налаштування вашого додатка на використання специфічних для певної версії функцій. Zabbix гарантує зворотну сумісність функцій всередині мажорної версії. При внесенні зворотно несумісних змін між мажорними випусками, Zabbix зазвичай залишає старі функції застарілими(deprecated) в наступному випуску, і видаляє їх лише у подальших випусках. Іноді Zabbix може видаляти можливості між мажорними випусками без забезпечення зворотної сумісності. Важливо, щоб ви ніколи не покладалися на застарілі функції і переходили на новіші альтернативи якомога швидше. ::: notetip Ви можете стежити за всіма змінами, внесеними до API, у [Журналі змін API](/manual/api/changes). ::: # Appendix 1. Reference commentary № Додаток 1. Опорний коментар ### assets/css *assets/css* is reserved and should only contain CSS style files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "css": ["mywidget.css"] } ``` ### assets/css *assets/css* зарезервований і має містити лише файли стилю CSS. Щоб використовувати його віджетом, укажіть ці файли в *[manifest.json](/devel/modules/file_structure/manifest)*. Наприклад: ```json "assets": { "css": ["mywidget.css"] } ``` ### assets CSS styles and JavaScript files to include. *Type*: Object *Supported object keys:* - **css** (array) - CSS files to include. The files must be located in the *assets/css*. - **js** (array) - JavaScript files to include. The files must be located in the *assets/js*. *Example*: ```json "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } ``` ### assets Стилі CSS і файли JavaScript для включення. *Тип*: Object *Підтримувані ключі об’єктів:* - **css** (array) - файли CSS для включення. Файли мають бути розташовані в *assets/css*. - **js** (array) - файли JavaScript для включення. Файли мають бути розташовані в *assets/js*. *Приклад*: ```json "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } ``` ### assets/js *assets/js* directory is reserved and should only contain JavaScript files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "js": ["class.widget.js"] } ``` ### assets/js Каталог *assets/js* зарезервований і має містити лише файли JavaScript. Щоб використовувати його віджетом, укажіть ці файли в *[manifest.json](/devel/modules/file_structure/manifest)*. Наприклад: ```json "assets": { "js": ["class.widget.js"] } ``` # Assets The folder *assets* may contain any files and subfolders that do not belong to other directories. You can use it for: - JavaScript styles (must be inside *[assets/js](#assetsjs)*); - CSS styles (must be inside *[assets/css](#assetscss)*); - Images; - Fonts; - Anything else you need to include. # Assets Папка *assets* може містити будь-які файли та підпапки, які не належать до інших каталогів. Ви можете використовувати її для: - Стилі JavaScript (має бути всередині *[assets/js](#assetsjs)*); - Стилі CSS (має бути в *[assets/css](#assetscss)*); - Зображення; - Шрифти; - Усе, що вам потрібно додати. # auditlog.get # auditlog.get #### Audit log Track configuration changes each user has done. [Audit log API](/manual/api/reference/auditlog) #### Журнал аудиту Відстежуйте зміни конфігурації, внесені кожним користувачем. [API журналу аудиту](/manual/api/reference/auditlog) #### Authentication Change authentication configuration options. [Authentication API](/manual/api/reference/authentication) #### Автентифікація Зміна параметрів конфігурації автентифікації. [API автентифікації](/manual/api/reference/authentication) # authentication.get # authentication.get #### Authentication To access any data in Zabbix, you need to either: - use an existing [API token](/manual/web_interface/frontend_sections/users/api_tokens) (created in Zabbix frontend or using the [Token API](/manual/api/reference/token)); - use an authentication token obtained with the [user.login](/manual/api/reference/user/login) method. For example, if you wanted to obtain a new authentication token by logging in as a standard *Admin* user, then a JSON request would look like this: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"user.login","params":{"username":"Admin","password":"zabbix"},"id":1}' ``` If you provided the credentials correctly, the response returned by the API should contain the user authentication token: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` #### Автентифікація Щоб отримати доступ до будь-яких даних у Zabbix, вам потрібно: - використовувати існуючий [API-токен](/manual/web_interface/frontend_sections/users/api_tokens) (створений у інтерфейсі Zabbix або за допомогою [Token API](/manual/api/reference/token)); - використовувати токен автентифікації, отриманий методом [user.login](/manual/api/reference/user/login). Наприклад, якщо ви хочете отримати новий токен автентифікації, увійшовши як стандартний користувач *Admin*, то JSON-запит буде виглядати наступним чином: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"user.login","params":{"username":"Admin","password":"zabbix"},"id":1}' ``` Якщо ви правильно вказали облікові дані, відповідь, повернута API, повинна містити токен автентифікації користувача: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` # authentication.update # authentication.update #### Authorization methods #### Методи авторизації ### author Module author. The author will be displayed in the Administration section. *Type*: String *Example*: ```json "author": "John Smith" ``` ### author Автор модуля. Автор буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "author": "Лесь Подерв'янський" ``` # autoregistration.get # autoregistration.get # autoregistration.update # autoregistration.update ## Backward incompatible changes ## Зворотно несумісні зміни ##### By Zabbix cookie A *"zbx_session"* cookie is used to authorize an API request from Zabbix UI performed using JavaScript (from a module or a custom widget). ##### Файл cookie Zabbix Файл cookie *"zbx_session "* використовується для авторизації API-запиту з інтерфейсу Zabbix, що виконується за допомогою JavaScript (з модуля або кастомного віджета). # Changes to extension development This page lists all changes to developing custom Zabbix extensions. # Зміни в розробці розширень На цій сторінці перераховано всі зміни в розробці спеціальних розширень Zabbix. ### config Default values for the module options. The object may contain any custom keys. If specified, these values will be written into the database during module registration. New variables added later will be written upon the first call. Afterwards, the variable values can only be changed directly in the database. *Type*: Object *Example*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ``` ### config Значення за замовчуванням для параметрів модуля. Об'єкт може містити будь-які спеціальні ключі. Якщо вказано, ці значення будуть записані в базу даних під час реєстрації модуля. Нові змінні, додані пізніше, будуть записані під час першого виклику. Після цього значення змінних можна змінити лише безпосередньо в базі даних. *Тип*: Object *Приклад*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ``` #### Configuration A problem can be suppressed through the **[problem update](/manual/acknowledgment#updating-problems)** window, where suppression is one of the problem update options along with commenting, changing severity, acknowledging, etc. A problem may also be unsuppressed through the same problem update window. #### Конфігурація Проблему можна сховати за допомогою вікна **[оновлення проблеми](/manual/acknowledgment#updating-problems)**, де приховування є одним із параметрів оновлення проблеми разом із коментування, зміна серйозності, підтвердження тощо. Проблема також може бути знову зроблена видимою в тому самому вікні оновлення проблеми. ##### Configuration examples For a basic example of how to set up Zabbix for monitoring VMware using the *VMware FQDN* template, see [*Monitor VMware with Zabbix*](/manual/guides/monitor_vmware). For a more detailed example of how to create a host, a low-level discovery rule, and a host prototype for monitoring VMware, see [*Setup example*](/manual/vm_monitoring/example). ##### Configuration examples For a basic example of how to set up Zabbix for monitoring VMware using the *VMware FQDN* template, see [*Monitor VMware with Zabbix*](/manual/guides/monitor_vmware). For a more detailed example of how to create a host, a low-level discovery rule, and a host prototype for monitoring VMware, see [*Setup example*](/manual/vm_monitoring/example). # configuration.export # configuration.export # configuration.import # configuration.import # configuration.importcompare # configuration.importcompare # Configuration This page describes classes that can be used to create a widget configuration view with custom configuration fields. The widget configuration view is the part of the widget that allows the user to configure widget parameters for [presentation](/presentation). # Конфігурація На цій сторінці описано класи, які можна використовувати для створення конфігурації view віджета з настроюваними полями конфігурації. View конфігурації віджета — це частина віджета, яка дозволяє користувачеві налаштовувати параметри віджета для [презентації](/presentation). ### 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 залишає за собою будь-які права на цю документацію, прямо не надані вище. ### 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 object The following objects are directly related to the `correlation` API. # Об'єкт кореляції Наступні об’єкти безпосередньо пов’язані з `correlation` API. # correlation.update # correlation.update #### Create a discovery action Create a discovery action that will link template "10001" to discovered hosts. [Request](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Створення дії виявлення Створіть дію виявлення, яка зв’яже шаблон «10001» із виявленими вузлами мережі. [Запит](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "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](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### Створити правило автореєстрації агента Створіть дію автореєстрації, яка додає хост до групи хостів «2», коли ім'я хоста містить «SRV» або метадані містять «AlmaLinux». [Запит](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` ##### Create a menu section 1. Create a *Module.php* file in the *MyAddress* directory. This file implements a new *Module* class that extends the default *CModule* class. The *Module* class will insert a new *My Address* menu section into the main menu. The *setAction()* method specifies an action to be executed upon clicking on the menu section. To start with, you can use the predefined action *userprofile.edit*, which will open the *User profile* page. In [part III](#part-iii---module-action) of this tutorial, you will learn how to create a custom action. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->add((new CMenuItem(_('My Address'))) ->setAction('userprofile.edit')); } } ``` :::noteclassic You can replace `'userprofile.edit'` with other actions, for example, `'charts.view'` (opens custom graphs), `'problems.view'` (opens *Monitoring → Problems*), or `'report.status'` (opens *System information* report). ::: 3. Refresh Zabbix frontend. There is now a new *My Address* section at the bottom of the Zabbix main menu. Click on *My Address* to open the *User profile* page. {width="600"} ##### Створення розділу меню 1. Створіть файл *Module.php* у каталозі *MyAddress*. Цей файл реалізує новий клас *Module*, який розширює стандартний клас *CModule*. Клас *Module* вставить новий розділ меню *My Address* в головне меню. Метод *setAction()* визначає дію, яка буде виконана після натискання на розділ меню. Для початку ви можете скористатися попередньо визначеною дією *userprofile.edit*, яка відкриє сторінку *Профіль користувача*. У [частині III](#part-iii---module-action) цієї інструкції ви дізнаєтесь, як створити користувацьку дію. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->add((новий CMenuItem(_('My Address'))) ->setAction('userprofile.edit')); } } ``` :::noteclassic Ви можете замінити «userprofile.edit» іншими діями, наприклад «charts.view» (відкриває користувацькі графіки), «problems.view» (відкриває *Моніторинг → Проблеми*) або `'report.status'` (відкриває звіт *Інформація про систему*). ::: 3. Оновіть інтерфейс Zabbix. Тепер у нижній частині головного меню Zabbix є новий розділ *Моя адреса*. Натисніть *Моя адреса*, щоб відкрити сторінку *Профіль користувача*. {width="600"} # Create a module (tutorial) # Створення модуля (інструкція) # Create a plugin (tutorial) # Створення плагіна (посібник) #### 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/alerts/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](/manual/api#performing-requests): ```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" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### Створення дії тригеру Створіть дію, яка виконуватиметься, коли тригер із хосту "10084", який містить слово "пам'ять" у своєму імені, переходить у стан проблеми. Дія матиме 4 налаштовані операції. Дія повинна спочатку надіслати повідомлення всім користувачам у групі користувачів «7» за допомогою способу сповіщення "1". Якщо подію не буде вирішено протягом 30 хвилин, буде запущено другу операцію [script](/manual/web_interface/frontend_sections/alerts/scripts#configuring-a-global-script) «5» (скрипт із областю дії "Операція дії") на всіх хостах у групі «2». Якщо подію буде вирішено, операція відновлення повідомить усіх користувачів, які отримали повідомлення про проблему. Якщо подію буде оновлено, операція підтвердження/оновлення повідомить (зі спеціальною темою та повідомленням) усіх користувачів, які отримали повідомлення про проблему. [Request](/manual/api#performing-requests): ```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" } } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` # Create a widget (tutorial) # Створення віджета (інструкція) #### Creating a new item Now, create a new [item](/manual/api/reference/item/object) on the host "Zabbix server" using the data you have obtained from the previous `host.get` request. This can be done using the [item.create](/manual/api/reference/item/create) method: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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},"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. ::: #### Створення нового елемента Тепер створіть новий [item](/manual/api/reference/item/object) на хості "Zabbix server", використовуючи дані, які ви отримали з попереднього `host.get`-запиту. Це можна зробити за допомогою методу [item.create](/manual/api/reference/item/create): ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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},"id":3}' ``` Успішна відповідь міститиме ідентифікатор щойно створеного елемента, який можна використовувати для посилання на елемент у таких запитах: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 3 } ``` ::: notetip Метод `item.create`, як і інші методи *create*, також може приймати масиви об'єктів і створювати декілька елементів одним викликом API. ::: #### Creating multiple triggers Thus, if *create methods* accept arrays, you can add multiple [triggers](/manual/api/reference/trigger/object), for example, this one: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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",}],"id":4}' ``` The 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), наприклад, цей: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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",}],"id":4}' ``` Успішна відповідь міститиме ідентифікатори новостворених тригерів: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 4 } ``` ##### CSS styles CSS files may contain a custom attribute `theme` to define different style for a specific frontend themes. Available themes and their attribute values: - **Blue** - [theme='blue-theme'] - **Dark** - [theme='dark-theme'] - **High-contrast light** - [theme='hc-light'] - **High-contrast dark** - [theme='hc-dark'] Example: ```css .widget { background-color: red; } [theme='dark-theme'] .widget { background-color: green; } ``` ##### Стилі CSS Файли CSS можуть містити користувацький атрибут `theme` для визначення іншого стилю для певних тем інтерфейсу. Доступні теми та значення їхніх атрибутів: - **Блакитна** - [theme='blue-theme'] - **Темна** - [theme='dark-theme'] - **Висококонтрастна світла** - [theme='hc-light'] - **Висококонтрастна темна** - [theme='hc-dark'] приклад: ```css .widget { background-color: червоний; } [theme='dark-theme'] .widget { background-color: зелений; } ``` ### CWidgetField The *CWidgetField* class is a base class from which all form field classes (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList*, etc.) are inherited. Classes extending *CWidgetField* are responsible for receiving, saving, and validating widget configuration values. The following *CWidgetField* classes are available. |CWidgetField class|Database field type|Description| |----|----|----------| |*CWidgetFieldCheckBox*|int32|Single checkbox.| |*CWidgetFieldCheckBoxList*|array of int32|Multiple checkboxes under a single configuration field.| |*CWidgetFieldColor*|string|Color selection field.| |*CWidgetFieldDatePicker*|string|Date selection field.| |*CWidgetFieldHostPatternSelect*|string|Multiselect field that allows to select one or multiple hosts. Supports defining host name patterns (all matching hosts will be selected).| |*CWidgetFieldIntegerBox*|int32|Field to enter an integer. Can be used to configure minimum and maximum values.| |*CWidgetFieldLatLng*|string|Text box that allows to enter comma-separated latitude, longitude, and map zoom level.| |*CWidgetFieldMultiSelectAction*|ID|Multiselect field for selecting actions (from the list of actions defined in the *Alerts → Actions*).| |*CWidgetFieldMultiSelectGraph*|ID|Multiselect field for selecting custom graphs.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Multiselect field for selecting custom graph prototypes.| |*CWidgetFieldMultiSelectGroup*|ID|Multiselect field for selecting host groups.| |*CWidgetFieldMultiSelectHost*|ID|Multiselect field for selecting hosts.| |*CWidgetFieldMultiSelectItem*|ID|Multiselect field for selecting items.| |*CWidgetFieldMultiSelectItemPattern*|ID|Multiselect field for selecting item patterns.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Multiselect field for selecting item prototypes.| |*CWidgetFieldMultiSelectMap*|ID|Multiselect field for selecting maps.| |*CWidgetFieldMultiSelectMediaType*|ID|Multiselect field for selecting media types.| |*CWidgetFieldMultiSelectOverrideHost*|ID|Multiselect field for selecting a data source (dashboard or other widget) containing a host for which the widget can display data.| |*CWidgetFieldMultiSelectService*|ID|Multiselect field for selecting services.| |*CWidgetFieldMultiSelectSla*|ID|Multiselect field for selecting SLAs.| |*CWidgetFieldMultiSelectUser*|ID|Multiselect field for selecting users.| |*CWidgetFieldNumericBox*|string|Field to enter a float number.| |*CWidgetFieldRadioButtonList*|int32|Radio box group that consists of one or more radio boxes.| |*CWidgetFieldRangeControl*|int32|Slider to select an integer type value.| |*CWidgetFieldReference*|string|Creates a unique identifier for this widget on dashboard. It is used to reference this widget from other widgets.| |*CWidgetFieldSelect*|int32|Dropdown select box.| |*CWidgetFieldSeverities*|array of int32|*CWidgetFieldCheckBoxList* preset with trigger severities.| |*CWidgetFieldTags*|array of (string, int32, string)|Allows to configure one or more tag filter rows.| |*CWidgetFieldTextArea*|string|Text area for entering multi-line text.| |*CWidgetFieldTextBox*|string|Text box for entering single-line text.| |*CWidgetFieldTimePeriod*|array of string|Time period selecting field.| |*CWidgetFieldTimeZone*|string|Dropdown with timezones.| |*CWidgetFieldThresholds*|array of (string, string)|Allows configuring color and number pairs.| |*CWidgetFieldUrl*|string|Text box that allows to enter URLs.| The following *CWidgetField* classes have been created for particular widgets. These classes have very specific use cases, but they can also be reused if needed. |CWidgetField class|Database field type|Description| |----|----|----------| |*CWidgetFieldColumnsList*|array of (multiple mixed)|For *Top hosts* widget. Create a table with custom columns of allowed types.| |*CWidgetFieldNavTree*|string|For *Map navigation tree* widget. Replaces widget view in edit mode with the map selection tree.| ### CWidgetField Клас *CWidgetField* є базовим класом, від якого успадковуються всі класи полів форми (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList* тощо). Класи, що розширюють *CWidgetField*, відповідають за отримання, збереження та перевірку значень конфігурації віджетів. Доступні такі класи *CWidgetField*. |Клас CWidgetField|Тип поля бази даних|Опис| |----|----|----------| |*CWidgetFieldCheckBox*|int32|Один checkbox.| |*CWidgetFieldCheckBoxList*|array of int32|Кілька checkbox-ів під одним полем конфігурації.| |*CWidgetFieldColor*|string|Поле вибору кольору.| |*CWidgetFieldDatePicker*|string|Поле вибору дати.| |*CWidgetFieldHostPatternSelect*|string|Множинне поле для вибору, яке дозволяє вибрати один або кілька хостів. Підтримує визначення шаблонів імен хостів (усі відповідні хости будуть вибрані).| |*CWidgetFieldIntegerBox*|int32|Поле для введення цілого числа. Можна використовувати для налаштування мінімальних і максимальних значень.| |*CWidgetFieldLatLng*|string|Текстове поле, яке дозволяє вводити через кому широту, довготу та рівень масштабування карти.| |*CWidgetFieldMultiSelectAction*|ID|Поле множинного вибору для вибору дій (зі списку дій, визначених у *Сповіщення → Дії*).| |*CWidgetFieldMultiSelectGraph*|ID|Множинне поле для вибору власних графіків.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Множинне поле для вибору власних прототипів графів.| |*CWidgetFieldMultiSelectGroup*|ID|Поле множинного вибору для вибору груп вузлів.| |*CWidgetFieldMultiSelectHost*|ID|Множинне поле для вибору хостів.| |*CWidgetFieldMultiSelectItem*|ID|Множинне поле для вибору елементів.| |*CWidgetFieldMultiSelectItemPattern*|ID|Множинне поле для вибору шаблонів елементів.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Множинне поле для вибору прототипів елементів.| |*CWidgetFieldMultiSelectMap*|ID|Множинне поле для вибору карт.| |*CWidgetFieldMultiSelectMediaType*|ID|Множинне поле для вибору типів медіа.| |*CWidgetFieldMultiSelectOverrideHost*|ID|Поле множинного вибору для вибору джерела даних (інформаційної панелі чи іншого віджета), що містить хост, для якого віджет може відображати дані.| |*CWidgetFieldMultiSelectService*|ID|Множинне поле для вибору служб.| |*CWidgetFieldMultiSelectSla*|ID|Множинне поле для вибору SLA.| |*CWidgetFieldMultiSelectUser*|ID|Множинне поле для вибору користувачів.| |*CWidgetFieldNumericBox*|string|Поле для введення числа з плаваючою точкою.| |*CWidgetFieldRadioButtonList*|int32|Група radio box-ів , яка складається з одного або кількох radio box-ів.| |*CWidgetFieldRangeControl*|int32|Повзунок для вибору значення цілочисельного типу.| |*CWidgetFieldReference*|string|Створює унікальний ідентифікатор для цього віджета на інформаційній панелі. Він використовується для посилання на цей віджет з інших віджетів.| |*CWidgetFieldSelect*|int32|Розкривне поле вибору.| |*CWidgetFieldSeverities*|array of int32|*CWidgetFieldCheckBoxList* попередньо налаштованих із рівнями серйозності тригера.| |*CWidgetFieldTags*|array of (string, int32, string)|Дозволяє налаштувати один або кілька рядків фільтра тегів.| |*CWidgetFieldTextArea*|string|Текстова область для введення багаторядкового тексту.| |*CWidgetFieldTextBox*|string|Текстове поле для введення однорядкового тексту.| |*CWidgetFieldTimePeriod*|array of string|Поле вибору періоду часу.| |*CWidgetFieldTimeZone*|string|Випадаюче меню з часовими поясами.| |*CWidgetFieldThresholds*|array of (string, string)|Дозволяє налаштувати пари кольорів і чисел.| |*CWidgetFieldUrl*|string|Текстове поле, яке дозволяє вводити URL-адреси.| Наступні класи *CWidgetField* були створені для окремих віджетів. Ці класи мають дуже специфічні випадки використання, але їх також можна використовувати повторно, якщо це необхідно. |Клас CWidgetField|Тип поля бази даних|Опис| |----|----|----------| |*CWidgetFieldColumnsList*|array of (multiple mixed)|Для віджета *Top hosts*. Створює таблицю з настроюваними стовпцями дозволених типів.| |*CWidgetFieldNavTree*|string|Для віджета *Навігаційне дерево карти*. Замінює вигляд віджета в режимі редагування деревом вибору карти.| ### CWidgetFormView The *CWidgetFormView* class is required for specifying the presentation logic of the fields defined in the *WidgetForm* class, determining their appearance and behavior when rendered in the configuration view. The *CWidgetFormView* class supports the following methods: - *addField()* - receives an instance of the *CWidgetFieldView* class as a parameter; each [*CWidgetField*](#cwidgetfield) class, has a respective *CWidgetFieldView* class for using in the widget configuration view. - *addFieldset()* - receives an instance of the *CWidgetFieldsGroupView* class that combines fields into a collapsible container. - *addFieldsGroup()* - receives an instance of *CWidgetFormFieldsetCollapsibleView* that visually (with a border) combines fields into a group. - *includeJsFile()* - allows to add a JavaScript file to the widget configuration view. - *addJavaScript()* - allows to add inline JavaScript that will be executed as soon as the widget configuration view is loaded. The *CWidgetFormView* class should be located in the *views* directory. **views/widget.edit.php example** ```php <?php /** * My custom widget form view. * * @var CView $this * @var array $data */ use Modules\MyCustomWidget\Includes\WidgetForm; (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_custom_widget_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ]).');') ->show(); ``` ### CWidgetFormView Клас *CWidgetFormView* потрібен для визначення логіки представлення полів, визначених у класі *WidgetForm*, визначення їх зовнішнього вигляду та поведінки під час візуалізації у вікні конфігурації. Клас *CWidgetFormView* підтримує такі методи: - *addField()* - отримує в якості параметра екземпляр класу *CWidgetFieldView*; кожен клас [*CWidgetField*](#cwidgetfield) має відповідний клас *CWidgetFieldView* для використання в view конфігурації віджета. - *addFieldset()* - отримує екземпляр класу *CWidgetFieldsGroupView*, який об’єднує поля в контейнер, що згортається. - *addFieldsGroup()* - отримує екземпляр *CWidgetFormFieldsetCollapsibleView*, який візуально ((за допомогою рамки) об’єднує поля в групу. - *includeJsFile()* - дозволяє додати файл JavaScript до view конфігурації віджета. - *addJavaScript()* - дозволяє додати вбудований JavaScript, який буде виконано, щойно буде завантажено view конфігурації віджета. Клас *CWidgetFormView* має бути розташований у каталозі *views*. **views/widget.edit.php приклад** ```php <?php /** * My custom widget form view. * * @var CView $this * @var array $data */ use Modules\MyCustomWidget\Includes\WidgetForm; (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_custom_widget_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ]).');') ->show(); ``` # dashboard.create # dashboard.create # dashboard.delete # dashboard.delete # dashboard.get # dashboard.get #### Dashboards Manage dashboards and make scheduled reports based on them. [Dashboard API](/manual/api/reference/dashboard) | [Template dashboard API](/manual/api/reference/templatedashboard) | [Report API](/manual/api/reference/report) #### Інформаційні панелі (дашборди) Керуйте інформаційними панелями та створюйте на їх основі планові звіти. [API інформаційної панелі](/manual/api/reference/dashboard) | [Шаблон інформаційної панелі API](/manual/api/reference/templatedashboard) | [Репорт API](/manual/api/reference/report) # dashboard.update # dashboard.update ## Data collection The Zabbix API allows you to manage the configuration of your monitoring system. ## Збір даних Zabbix API дозволяє вам керувати конфігурацією вашої системи моніторингу. # dcheck.get # dcheck.get #### Delete multiple actions Delete two actions. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### Видалити кілька дій Видалити дві дії. [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` ### 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/users/user_roles) for more information. ::: ### Опис `integer/array action.get(object parameters)` Метод дозволяє отримати дії за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача] /manual/web_interface/frontend_sections/users/user_roles) для отримання додаткової інформації. ::: ### description Module description. *Type*: String *Example*: ```json "description": "This is a clock widget." ``` ### description Опис модуля. *Тип*: String *Приклад*: ```json "description": "Це віджет годинника." ``` ### 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/users/user_roles) for more information. ::: ### Опис `object action.create(object/array actions)` Цей метод дозволяє створювати нові дії. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/users/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/users/user_roles) for more information. ::: ### Опис `object action.delete(array actionIds) Цей спосіб дозволяє видаляти дії. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача (/manual/web_interface/frontend_sections/users/user_roles) для отримання додаткової інформації. ::: ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## ОПИС **zabbix\_agent2** — додаток для моніторингу параметрів різних сервісів.\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## ОПИС **zabbix\_agentd** — це демон для моніторингу різних параметрів сервера. [ ]{#lbAE} ## DESCRIPTION **zabbix\_get** is a command line utility for getting data from Zabbix agent. [ ]{#lbAE} ## ОПИС **zabbix\_get** — утиліта командного рядка для отримання даних від агента Zabbix. [ ]{#lbAE} ## DESCRIPTION **zabbix\_js** is a command line utility that can be used for embedded script testing. [ ]{#lbAE} ## ОПИС **zabbix\_js** — це утиліта командного рядка, яку можна використовувати для тестування вбудованих сценаріїв. [ ]{#lbAE} ## DESCRIPTION **zabbix\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE} ## ОПИС **zabbix\_proxy** — це демон, який збирає дані моніторингу з пристроїв і надсилає їх на сервер Zabbix. [ ]{#lbAE} ## DESCRIPTION **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE} ## ОПИС **zabbix\_sender** — це утиліта командного рядка для надсилання даних моніторингу на сервер або проксі Zabbix. На сервері Zabbix має бути створений елемент типу **Zabbix trapper** з відповідним ключем. Зауважте, що вхідні значення прийматимуться лише від хостів, указаних у полі **Allowed hosts** для цього елемента. [ ]{#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} # Developer Center This section contains everything you need to quickly start developing custom Zabbix extensions: - [Frontend modules](/devel/modules) - [Dashboard widgets](/devel/modules/widgets) - [Plugins](/devel/plugins) for Zabbix agent 2 # Центр розробників У цьому розділі міститься все, що вам потрібно, щоб швидко розпочати розробку власних розширень Zabbix: - [Модулі інтерфейсу](/devel/modules) - [Віджети інформаційної панелі](/devel/modules/widgets) - [Плагіни](/devel/plugins) для Zabbix agent 2 # dhost.get # dhost.get ### Disabling HA cluster 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 з активного основного сервера - перезапустіть основний сервер (він запуститься в автономному режимі) # discoveryrule.create # discoveryrule.create # discoveryrule.delete # discoveryrule.delete # discoveryrule.get # discoveryrule.get # discoveryrule.update # discoveryrule.update #### 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/dashboards##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. #### Відображення На основі інформації про підтвердження можна налаштувати спосіб відображення кількості проблем на інформаційній панелі чи картах. Для цього вам потрібно зробити вибір у параметрі *Відображення проблеми*, доступному як у [map configuration](/manual/config/visualization/maps/map#creating_a_map), так і в *Проблеми за ступенем тяжкості* [віджеті панелі інструментів]( /manual/web_interface/frontend_sections/dashboards##adding_widgets). Можна відобразити кількість усіх проблем, кількість непідтверджених проблем окремо від загальної чи тільки кількість непідтверджених проблем. На основі інформації про оновлення проблеми (підтвердження тощо) можна налаштувати операції оновлення – надіслати повідомлення або виконати віддалені команди. #### Display Once suppressed the problem is marked by a blinking  suppression icon in the *Info* column, before being hidden. The suppression icon is blinking while the suppression task is in the waiting list. Once the task manager has suppressed the problem, the icon will stop blinking. If the suppression icon keeps blinking for a long time, this may indicate a server problem, for example, if the server is down and the task manager cannot complete the task. The same logic applies to unsuppression. In the short period after the task is submitted and the server has not completed it, the unsuppression icon is blinking. A suppressed problem may be both hidden or shown, depending on the problem filter/widget settings. When shown in the problem list, a suppressed problem is marked by the suppression icon and suppression details are shown on mouseover:  Suppression details are also displayed in a popup when positioning the mouse on the suppression icon in the *Actions* column. #### Відображення Після приховування проблема позначається блиманням  значка приховування в стовпці *Інформація*, перш ніж його приховати. Значок придушення блимає, поки завдання придушення знаходиться в списку очікування. Після того, як диспетчер завдань вирішить проблему, значок перестане блимати. Якщо піктограма придушення продовжує блимати протягом тривалого часу, це може вказувати на проблему з сервером, наприклад, якщо сервер не працює і диспетчер завдань не може завершити завдання. Така ж логіка застосовується і до зняття приховування. Протягом короткого періоду після того, як завдання було надіслано, але сервер не встиг його виконати, піктограма зняття приховування блимає. Прихована проблема може бути як прихованою, так і відображеною, залежно від налаштувань фільтра проблеми/віджета. При відображенні у списку проблем прихована проблема позначається піктограмою придушення та деталі придушення показуються при наведенні миші:  Деталі придушення також відображаються у спливаючому вікні, якщо навести курсор миші на придушення у стовпці *Дії*. # drule.create # drule.create # drule.delete # drule.delete # drule.get # drule.get # drule.update # drule.update # dservice.get # dservice.get ### Enabling high availability ### Увімкнення високої доступності #### Error handling Up to the present moment, everything you have tried has worked fine. But what would happen if you tried making an incorrect call to the API? Try to create another host by calling [host.create](/manual/api/reference/host/create) but omitting the mandatory `groups` parameter: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.create","params":{"host":"Linux server","interfaces":[{"type":1,"main":1,"useip":1,"ip":"192.168.3.1","dns":"","port":"10050"}]},"id":7}' ``` The response will then contain an error message: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` If an error has occurred, instead of the `result` property, the response object will contain the `error` property with the following data: - `code` - an error code; - `message` - a short error summary; - `data` - a more detailed error message. Errors can occur in various cases, such as, using incorrect input values, a session timeout or trying to access non-existing objects. Your application should be able to gracefully handle these kinds of errors. #### Обробка помилок До цього моменту все, що ви спробували, працювало нормально. Але що станеться, якщо ви спробуєте зробити некоректний виклик API? Спробуйте створити інший хост, викликавши [host.create](/manual/api/reference/host/create), але опустивши обов'язковий параметр `groups`: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.create","params":{"host":"Linux server","interfaces":[{"type":1,"main":1,"useip":1,"ip":"192.168.3.1","dns":"","port":"10050"}]},"id":7}' ``` Тоді відповідь міститиме повідомлення про помилку: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` Якщо сталася помилка, замість властивості `result` об'єкт відповіді буде містити властивість `error` з наступними даними: - `code` - код помилки; - `message` - короткий опис помилки; - `data` - більш детальне повідомлення про помилку. Помилки можуть виникати у різних випадках, наприклад, при використанні неправильних вхідних даних, таймауті сеансу або спробі отримати доступ до неіснуючих об'єктів. Ваша програма повинна вміти коректно обробляти такі помилки. # event.acknowledge # event.acknowledge #### Event correlation Create custom event correlation rules. [Correlation API](/manual/api/reference/correlation) #### Кореляція подій Створення власних правил кореляції подій. [API кореляції](/manual/api/reference/correlation) # event.get # event.get #### Events Retrieve events generated by triggers, network discovery and other Zabbix systems for more flexible situation management or third-party tool integration. [Event API](/manual/api/reference/event) #### Події Отримувати події, створені тригерами, виявленням мережі та іншими системами Zabbix для більш гнучкого управління ситуацією або інтеграцією в сторонні інструменти. [Event API](/manual/api/reference/event) ### Event tag The event tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| ### Тег події Об'єкт тегу події має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |тег|рядок|Назва тегу події.| |значення|рядок|Значення тегу події.| ### Example ### Приклади ##### 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(/host/web.test.fail[сценарій])<>0 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ##### 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 Щоб створити тригер «Помилка веб-сценарію» з корисним описом проблеми в назві тригера, ви можете визначити тригер із назвою: Помилка веб-сценарію "Сценарій": {ITEM.VALUE} і тригерний вираз: length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ##### 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(/host/web.test.in[Scenario,,bps])<10000 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади #### Examples #### Приклади ##### 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. ##### 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. # Examples This section provides files of sample modules and widgets, which you can use as a base for your custom modules. To use a module: 1. Download the ZIP archive. 2. Unpack the content into a separate directory inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). 3. Register the module in Zabbix frontend. # Приклади У цьому розділі представлені файли зразків модулів та віджетів, які ви можете використовувати як основу для власних модулів. Щоб використовувати модуль: 1. Завантажте ZIP-архів. 2. Розпакуйте вміст в окремий підкаталог у каталозі з *модулями* web-серверу Zabbix (наприклад */zabbix/ui/modules*). 3. Зареєструйте модуль у інтерфейсі Zabbix. ## 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 "Monitored Host" -k mysql.queries -o 342.45**\ Надішліть **342.45** як значення для елемента **mysql.queries** хосту **Monitored Host** за допомогою сервера 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 server" 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 "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**\ Надішліть **342.45** як значення для елемента **mysql.queries** у хості **Monitored Host** на сервер з IP-адресою **192.168.1.113** за допомогою TLS із сертифікатом. **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**\ Надішліть **342.45** як значення для елемента **mysql.queries** у хості **Monitored Host** на сервер з IP-адресою **192.168.1.113** за допомогою TLS зі спільним ключем (PSK). [ ]{#lbAI} ### Example workflow The following section will walk you through some examples of usage in a greater detail. ### Приклад робочого процесу У наступному розділі ми розглянемо деякі приклади використання більш детально. ## 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} #### Export and import Export and import Zabbix configuration data for configuration backups, migration or large-scale configuration updates. [Configuration API](/manual/api/reference/configuration) #### Експорт та імпорт Експорт та імпорт даних конфігурації Zabbix для резервних копій конфігурації, міграція або масштабні оновлення конфігурації. [API конфігурації](/manual/api/reference/configuration) ##### Export format Data can be exported using the Zabbix web frontend or [Zabbix API](/manual/api/reference/configuration). Supported export formats are YAML, XML and JSON. ##### Формат експорту Дані можна експортувати за допомогою веб-інтерфейсу Zabbix або [Zabbix API](/manual/api/reference/configuration). Підтримувані формати експорту: YAML, XML і JSON. #### Exporting To export templates, do the following: 1. Go to *Data collection* → *Templates*. 2. Mark the checkboxes of the templates to export. 3. Click *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. #### Експорт Щоб експортувати шаблони, виконайте такі дії: 1. Перейдіть до *Збір даних* → *Шаблони*. 2. Позначте шаблони для експорту. 3. Натисніть *Експорт* під списком.  Залежно від обраного формату шаблони експортуються в локальний файл із назвою за замовчуванням: - `zabbix_export_templates.yaml` - в експорті YAML (параметр експорту за замовчуванням); - `zabbix_export_templates.xml` - в експорті XML; - `zabbix_export_templates.json` - в експорті JSON. ### 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 ``` ## 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 agent 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} ### Further reading Now, you have enough knowledge to start working with the Zabbix API, however, do not stop here. For further reading you are advised to have a look at the [list of available APIs](/manual/api/reference). ### Більше інформації Тепер у вас достатньо знань, щоб почати працювати з Zabbix API, однак не зупиняйтеся на цьому. Для подальшого читання радимо переглянути [список доступних API](/manual/api/reference). #### General Change certain global configuration options. [Autoregistration API](/manual/api/reference/autoregistration) | [Icon map API](/manual/api/reference/iconmap) | [Image API](/manual/api/reference/image) | [Settings API](/manual/api/reference/settings) | [Regular expression API](/manual/api/reference/regexp) | [Module API](/manual/api/reference/module) | [Connector API](/manual/api/reference/connector) #### Загальне Зміна певних параметрів глобальної конфігурації. [API автореєстрації](/manual/api/reference/autoregistration) | [API карти значків](/manual/api/reference/iconmap) | [API образів](/manual/api/reference/image) | [API налаштувань](/manual/api/reference/settings) | [API регулярного виразу](/manual/api/reference/regexp) | [API модуля](/manual/api/reference/module) | [API конектора](/manual/api/reference/connector) # graph.create # graph.create # graph.delete # graph.delete # graph.get # graph.get # graphitem.get # graphitem.get # graphprototype.create # graphprototype.create # graphprototype.delete # graphprototype.delete # graphprototype.get # graphprototype.get # graphprototype.update # graphprototype.update #### Graphs Edit graphs or separate graph items for better presentation of the gathered data. [Graph API](/manual/api/reference/graph) | [Graph item API](/manual/api/reference/graphitem) #### Графіки Редагування графіків або відокремлення їх елементів даних для кращого представлення зібраних даних. [API графіків](/manual/api/reference/graph) | [API елементів даних графіків ](/manual/api/reference/graphitem) # graph.update # graph.update # hanode.get # hanode.get #### 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) # history.clear # history.clear # 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 історії](/manual/api/reference/history) # host.create # host.create # host.delete # host.delete # host.get # host.get # hostgroup.create # hostgroup.create # hostgroup.delete # hostgroup.delete # hostgroup.get # hostgroup.get # hostgroup.massadd # hostgroup.massadd # hostgroup.massremove # hostgroup.massremove # hostgroup.massupdate # hostgroup.massupdate # hostgroup.update # hostgroup.update # hostinterface.create # hostinterface.create # hostinterface.delete # hostinterface.delete # hostinterface.get # hostinterface.get # hostinterface.massadd # hostinterface.massadd # hostinterface.massremove # hostinterface.massremove # hostinterface.replacehostinterfaces # hostinterface.replacehostinterfaces # hostinterface.update # hostinterface.update # host.massadd # host.massadd # host.massremove # host.massremove # host.massupdate # host.massupdate # hostprototype.create # hostprototype.create # hostprototype.delete # hostprototype.delete # hostprototype.get # hostprototype.get # hostprototype.update # hostprototype.update #### 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) #### Хости та групи хостів Керуйте групами хостів, хостами та всім, що з ними пов’язано, включаючи інтерфейси хостів, макроси хостів та періоди обслуговування. [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) # host.update # host.update #### Housekeeping Configure housekeeping. [Housekeeping API](/manual/api/reference/housekeeping) #### Housekeeping Налаштування Housekeeping-у (видалення старих записів). [Housekeeping API](/manual/api/reference/housekeeping) # housekeeping.get # housekeeping.get # housekeeping.update # housekeeping.update ### How modules work - An enabled module is launched on each HTTP request, before executing the action code. - The module will register new actions or redefine the existing ones. - The module will add new frontend sections and remove or redefine the existing ones. - The module will hook to frontend events like onBeforeAction and onTerminate, if needed. - The requested action is finally executed by running the action code - either the default one, or module-defined. ### Як працюють модулі - Увімкнений модуль запускається під час кожного HTTP запиту перед виконанням коду дії. - Модуль буде реєструвати нові дії або перевизначати існуючі. - Модуль додасть нові розділи інтерфейсу та видалить або перевизначить існуючі. - Якщо потрібно, модуль підключатиметься до зовнішніх подій, таких як onBeforeAction і onTerminate. - Запитувана дія остаточно виконується шляхом запуску коду дії - стандартного або визначеного модулем. # httptest.create # httptest.create # httptest.delete # httptest.delete # httptest.get # httptest.get # httptest.update # httptest.update # iconmap.create # iconmap.create # iconmap.delete # iconmap.delete # iconmap.get # iconmap.get # iconmap.update # iconmap.update ### id Module ID. Must be unique. To avoid future naming conflicts, it is recommended to use prefix for modules (author or company name, or any other). For example, if a module is an example for lessons and the module name is "My module", then the ID will be "example_my_module". *Type*: String *Example*: ```json "id": "example_my_module" ``` ### id ID модуля. Повинно бути унікальним. Щоб уникнути майбутніх конфліктів іменування, рекомендується використовувати префікс для модулів (назва автора, компанії чи будь-який інший). Наприклад, якщо модуль є прикладом для уроків, а назва модуля – «Мій модуль», тоді ідентифікатор буде «example_my_module». *Тип*: String *Приклад*: ```json "id": "example_my_module" ``` # image.create # image.create # image.delete # image.delete # image.get # image.get # 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. ## 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) ------------------------------------------------------------------------ Цей документ створено о 21:23:35 GMT, 18 березня 2020 року ## 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) ------------------------------------------------------------------------ Цей документ створено о 12:58:30 GMT, 11 червня 2021 року ## 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 ## Покажчик [ІМ'Я](# фунтів АБ) [СИНТАКСИС](#lbAC) [ОПИС](#lb AD) [ПААМЕТРИ](#lbAE) [](#lbAF) [ПРИКЛАДИ](#lbAG) [ДИВ. ТАКОЖ](#lbAH) [АВТОР](#lbAI) -------------------------------------------------- ---------------------- Цей документ створено о 08:42:29 GMT, 11 червня 2021 року ## 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) ------------------------------------------------------------------------ Цей документ створено: 08:42:39 GMT, 11 червня 2021 року ## 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) -------------------------------------------------- ---------------------- Цей документ створено о 14:07:57 GMT, 22 листопада 2021 року ## 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) -------------------------------------------------- ---------------------- Цей документ створено о 16:12:22 GMT, 04 вересня 2020 року ## 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) -------------------------------------------------- ---------------------- Цей документ створено: 20:50:13 GMT, 22 листопада 2021 р. # item.create # item.create # item.delete # item.delete # item.get # item.get # itemprototype.create # itemprototype.create # itemprototype.delete # itemprototype.delete # itemprototype.get # itemprototype.get # itemprototype.update # itemprototype.update #### Items Define items to monitor. [Item API](/manual/api/reference/item) #### Елементи даних Визначення елементів даних для моніторингу. [API елементів даних](/manual/api/reference/item) # item.update # item.update ### JavaScript A JavaScript class can be used to add dynamic behavior and interactivity to the widget configuration view. For example, you can initialize a color picker, defined in the [*CWidgetFormView*](#cwidgetformview) class. The JavaScript class should be loaded with the form, therefore it should be referenced in the [*CWidgetFormView*](#cwidgetformview) class by using the methods *includeJsFile()* and *addJavaScript()*. In the example below, a singleton class instance is immediately created and stored under the *window.my_custom_widget_form* name. Thus, opening the form for the second time will re-create the instance. The JavaScript class should be located in the *views* directory. **views/widget.edit.js.php example** ```php <?php use Modules\MyCustomWidget\Widget; ?> window.my_custom_widget_form = new class { init({color_palette}) { colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } } }; ``` ### JavaScript Клас JavaScript можна використовувати для додавання динамічної поведінки та інтерактивності до конфігурації view віджета. Наприклад, ви можете ініціалізувати засіб вибору кольорів, визначений у класі [*CWidgetFormView*](#cwidgetformview). Клас JavaScript має бути завантажений разом із формою, тому на нього слід посилатися в класі [*CWidgetFormView*](#cwidgetformview) за допомогою методів *includeJsFile()* і *addJavaScript()*. У наведеному нижче прикладі екземпляр класу singleton одразу створюється та зберігається під назвою *window.my_custom_widget_form*. Таким чином, відкриття форми вдруге призведе до повторного створення екземпляра. Клас JavaScript має бути розташований у каталозі *views*. **views/widget.edit.js.php приклад** ```php <?php use Modules\MyCustomWidget\Widget; ?> window.my_custom_widget_form = new class { init({color_palette}) { colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } } }; ``` ### JavaScript The JavaScript class is responsible for determining widget behavior, such as updating widget data, resizing the widget, displaying widget elements, etc. All JavaScript operations use and/or extend the base JavaScript class of all dashboard widgets - *CWidget*. The *CWidget* class contains a set of methods with the default implementation for widget behavior. Depending on widget complexity, these methods can be utilized as is or extended. The *CWidget* class contains the following methods: - Methods that define widget lifecycle: *onInitialize()*, *onStart()*, *onActivate()*, *onDeactivate()*, *onDestroy()*, *onEdit()*. - Methods that handle updating and displaying widget data: *promiseUpdate()*, *getUpdateRequestData()*, *processUpdateResponse(response)*, *processUpdateErrorResponse(error)*, *setContents(response)*. - Methods that modify widget appearance: *onResize()*, *hasPadding()*. The JavaScript class should be located in the *assets/js* directory and specified in the [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) parameter in the *manifest.json* file. ### JavaScript Клас JavaScript відповідає за визначення поведінки віджетів, наприклад оновлення даних віджетів, зміну розміру віджетів, відображення елементів віджетів тощо. Усі операції JavaScript використовують і/або розширюють базовий клас JavaScript усіх віджетів інформаційної панелі - *CWidget*. Клас *CWidget* містить набір методів із реалізацією за замовчуванням для поведінки віджетів. Залежно від складності віджета, ці методи можна використовувати як є або розширити. Клас *CWidget* містить такі методи: - Методи, що визначають життєвий цикл віджета: *onInitialize()*, *onStart()*, *onActivate()*, *onDeactivate()*, *onDestroy()*, *onEdit()*. - Методи, які обробляють оновлення та відображення даних віджетів: *promiseUpdate()*, *getUpdateRequestData()*, *processUpdateResponse(response)*, *processUpdateErrorResponse(error)*, *setContents(response)*. - Методи, які змінюють зовнішній вигляд віджета: *onResize()*, *hasPadding()*. Клас JavaScript має розташовуватися в каталозі *assets/js* і вказуватися в параметрі [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) у *manifest.json* файл. #### 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` - активувати звичайний режим ##### Lifecycle methods The widget lifecycle methods are invoked by the dashboard, and at different stages of the widget's lifecycle during its existence within the dashboard. ##### Методи життєвого циклу Методи життєвого циклу віджета викликаються інформаційною панеллю та на різних етапах життєвого циклу віджета під час його існування на інформаційній панелі. #### 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, де процесори розподіляються нерівномірно між вузлами NUMA. Якщо логічні ЦП розподілені нерівномірно, показники продуктивності ЦП можуть бути недоступні для деяких ЦП. Наприклад, якщо є 72 логічних ЦП з 2 вузлами NUMA, обидва вузли повинні мати по 36 ЦП кожен. ##### 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). ### 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. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### Цілі контролю рівня журналу *process-type* Всі процеси вказаного типу (активні перевірки, колектор, слухач) *process-type,N* Тип та номер процесу (наприклад, listener,3) *pid* Ідентифікатор процесу, до 65535. Для більших значень вкажіть ціль у вигляді "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Вивести відомі елементи і вийти. Для кожного елемента використовуються або загальні значення за замовчуванням або специфічні значення за замовчуванням для тестування. Ці значення за замовчуванням перераховано у квадратних дужках як ключові параметри елемента. Значення, що повертаються взято у квадратні дужки і додано префікс з типом значення, що повертається значення, відокремленого символом труби. Для параметрів користувача тип завжди **t**, оскільки агент не може визначити всі можливі значення, що повертаються. Елементи, відображені як робочі, не гарантують роботу з сервера Zabbix або zabbix\_get при запиті до запущеного демона агента, оскільки дозволи або середовище може відрізнятися. Типи значень, що повертаються: d Число з десятковою частиною. m Не підтримується. Це може бути спричинено запитом елемента, який працює лише в активному режимі, наприклад, елемент моніторингу журналу або елемент, який вимагає декілька зібраних значень. Проблеми з правами доступу або неправильні параметри користувача також можуть призвести до стану "не підтримується". s Текст. Максимальна довжина не обмежена. t Текст. Те саме, що і **s**. u Ціле число без знаку. **-t**, **--test** *item-key* Перевірити один елемент і вийти. Дивіться **--print** для опису виводу. **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести інформацію про версію і завершити роботу. [ ]{#lbAH} ### Log level control targets *process-type* All processes of specified type (availability manager, browser poller, configuration syncer, data sender, discovery manager, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, odbc poller, poller, agent poller, http agent poller, snmp poller, preprocessing manager, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector) *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, discovery manager, history syncer, housekeeper, http poller, preprocessing manager, icmp pinger, ipmi manager, ipmi poller, java poller, poller, agent poller, http agent poller, snmp poller, 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) **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### Цілі контролю рівня журналу *process-type* Усі процеси вказаного типу (availability manager, browser poller, configuration syncer, data sender, discovery manager, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, odbc poller, poller, agent poller, http agent poller, snmp poller, preprocessing manager, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector) *process-type,N* Тип і номер процесу (наприклад, poller, 3) *pid* Ідентифікатор процесу, до 65535. Для більших значень укажіть ціль як "process-type,N" Цілі контролю рівня профілювання *process-type* Усі процеси вказаного типу (configuration syncer, data sender, discovery manager, history syncer, housekeeper, http poller, preprocessing manager, icmp pinger, ipmi manager, ipmi poller, java poller, poller, agent poller, http agent poller, snmp poller, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector, history poller, availability manager, odbc poller) *process-type,N* Тип і номер процесу (наприклад, history syncer,1) *pid* Ідентифікатор процесу, до 65535. Для більших значень укажіть ціль як "process-type,N" *scope* Разом з типом процесу можно вказати область профілювання (rwlock, mutex, processing) (наприклад, history syncer,1,processing) **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Вивести інформацію про версію та вийти. [ ]{#lbAH} #### Low-level discovery Configure low-level discovery rules as well as item, trigger and graph prototypes to monitor dynamic entities. [LLD rule API](/manual/api/reference/discoveryrule) | [Item prototype API](/manual/api/reference/itemprototype) | [Trigger prototype API](/manual/api/reference/triggerprototype) | [Graph prototype API](/manual/api/reference/graphprototype) | [Host prototype API](/manual/api/reference/hostprototype) #### Низькорівневе виявлення Налаштування правил низькорівневого виявлення, а також прототипів елементів даних, тригерів і графіків для моніторингу динамічних сутностей. [API правил LLD](/manual/api/reference/discoveryrule) | [API Прототипа елемента даних](/manual/api/reference/itemprototype) | [API Прототипа тригера](/manual/api/reference/triggerprototype) | [API Прототипа графа](/manual/api/reference/graphprototype) | [API Прототипа хоста](/manual/api/reference/hostprototype) #### Macros Manage macros. [User macro API](/manual/api/reference/usermacro) #### Макроси Керуйте макросами. [API користувацьких макросів](/manual/api/reference/usermacro) # maintenance.create # maintenance.create # maintenance.delete # maintenance.delete # maintenance.get # maintenance.get # manifest.json Any module needs the manifest.json file. The file must be located in the module's primary directory (for example, *zabbix/ui/modules/module_name/manifest.json*). As a bare minimum, manifest.json should specify these fields: ```json { "manifest_version": 2.0, "id": "my_ip_address", "name": "My IP Address", "namespace": "MyIPAddress", "version": "1.0" } ``` Parameters supported in **manifest.json** (press on the parameter name for a detailed description): |Parameter |Description |Required | |--|--------|--| |[manifest_version](#manifest-version)|Manifest version of the module.| Yes | |[id](#id) |Unique module ID. |^| |[name](#name) |Module name that will be displayed in the Administration section. |^| |[namespace](#namespace) |PHP namespace for module classes.|^| |[version](#version) |Module version. |^| |[type](#type) |Type of the module. For widget must be set to *widget* | Yes for widgets, otherwise no | |[widget](#widget) |Widget configuration. Used for widgets only. |^| |[actions](#actions) | Actions to register with the module. |^| |[assets](#assets) | CSS styles and JavaScript files to include. | No | |[author](#author) |Module author. |^| |[config](#config) |Default values for custom module options. |^| |[description](#description) |Module description.|^| |[url](#url) |A link to the module description. |^| # manifest.json Для будь-якого модуля потрібний файл manifest.json. Файл має бути розташований у основному каталозі модуля (наприклад *zabbix/ui/modules/module_name/manifest.json*). Як мінімум, у файлі manifest.json мають бути вказані такі поля: ```json { "manifest_version": 2.0, "id": "my_ip_address", "name": "My IP Address", "namespace": "MyIPAddress", "version": "1.0" } ``` Параметри, які підтримуються в **manifest.json** (натисніть назву параметра для детального опису): |Параметр |Опис |Обов'язковий | |--|--------|--| |[manifest_version](#manifest-version)|Версія маніфесту модуля.| Так | |[id](#id) |Унікальний ідентифікатор модуля. |^| |[name](#name) |Назва модуля, що відображатиметься в розділі Адміністрування. |^| |[namespace](#namespace) |Простір імен PHP для класів модулів.|^| |[version](#version) |Версія модуля. |^| |[type](#type) |Тип модуля. Для віджета потрібно встановити *widget* | Так для віджетів, ні для решти | |[widget](#widget) |Конфігурація віджета. Використовується лише для віджетів. |^| |[actions](#actions) | Дії для реєстрації в модулі. |^| |[assets](#assets) | Стилі CSS і файли JavaScript для включення. | Ні | |[author](#author) |Автор модуля. |^| |[config](#config) |Значення за замовчуванням для користувацьких параметрів модуля. |^| |[description](#description) |Опис модуля.|^| |[url](#url) |Посилання на опис модуля. |^| ### manifest_version {#manifest-version} Manifest version of the module. Currently, supported version is **2.0**. *Type*: Double *Example*: ```json "manifest_version": 2.0 ``` ### manifest_version {#manifest-version} Версія маніфесту модуля. Наразі підтримується версія **2.0**. *Тип*: Double *Приклад*: ```json "manifest_version": 2.0 ``` #### Maps Configure maps to create detailed dynamic representations of your IT infrastructure. [Map API](/manual/api/reference/map) #### Карти Налаштуйте карти для створення детальних динамічних представлень вашої ІТ інфраструктури. [API карти](/manual/api/reference/map) ##### 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. #### Media types Configure media types and multiple ways users will receive alerts. [Media type API](/manual/api/reference/mediatype) #### Способи оповіщень Налаштування способів оповіщень та способів, якими користувачі отримуватимуть сповіщення [API способів оповіщень](/manual/api/reference/mediatype) # 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, і допоможе вам зорієнтуватися в доступних класах і методах. ### Module example - When creating a host group, grant read permissions to configured user groups - [hg_auto_perm.zip](/../assets/en/devel/modules/examples/hg_auto_perm.zip) ### Приклад модуля - Під час створення групи хостів надайте дозволи на читання налаштованим групам користувачів - [hg_auto_perm.zip](/../assets/en/devel/modules/examples/hg_auto_perm.zip) # Module file structure All code related to a module is stored in a single directory inside the **modules** directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). # Структура файлів модуля Весь код, пов’язаний з модулем, зберігається в одному каталозі всередині каталогу **modules** вашої установки web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). ### Module file tree ````yaml 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 assets/ Any additional files to be used in views. Must be specified in manifest.json. js/ JavaScript files used in views. example.something.view.js.php css/ CSS files used in views. example.something.css image.png Images used in views. example.something.file Any file for using in views. ```` ### Дерево файлів модуля ````yaml example_module_directory/ (обов’язково) manifest.json (обов’язково) Метадані та визначення дії. Module.php Ініціалізація модуля та обробка подій. actions/ Файли управління діями. SomethingView.php SomethingCreate.php SomethingDelete.php data_export/ ExportAsXml.php ExportAsExcel.php views/ view файли. example.something.view.php example.something.delete.php assets/ Будь-які додаткові файли для використання у view. Необхідно вказати в manifest.json. js/файли JavaScript, які використовуються у view. example.something.view.js.php css/ файли CSS, які використовуються у view. example.something.css image.png Зображення, що використовуються у view. example.something.file Будь-який файл для використання у view. ```` # Modules # Модулі ## Monitoring The Zabbix API allows you to access history and other data gathered during monitoring. ## Моніторинг Zabbix API дозволяє отримати доступ до історії та інших зібраних даних під час моніторингу. 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. 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. ### MySQL Export and import must be performed in tmux/screen to ensure that the session isn't dropped. See also: [Important notes](#important-notes) ### MySQL Експорт і імпорт потрібно виконувати в tmux/screen, щоб гарантувати, що сеанс не буде перервано. Дивіться також: [Важливі примітки](#important-notes) #### MySQL 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*.\ Relevant for at least MySQL version 5.1.61 #### MySQL Якщо значення містить символ, відмінний від ASCII, у кодуванні, відмінному від UTF8, цей символ і наступні символи буде відкинуто, коли база даних збереже це значення. На адресу не надходитимуть жодні попереджувальні повідомлення *zabbix\_server.log*.\ Актуально принаймні для версії MySQL 5.1.61 ### name Module name that will be displayed in the Administration section. *Type*: String *Example*: ```json "name": "My module" ``` ### name Назва модуля, яка буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "name": "Мій модуль" ``` ### namespace PHP namespace for module classes. *Type*: String *Example*: ```json "namespace": "ClockWidget" ``` ### namespace Простір імен PHP для класів модулів. *Тип*: String *Приклад*: ```json "namespace": "ClockWidget" ``` ## 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 JS [ ]{#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} #### Network discovery Manage network-level discovery rules to automatically find and monitor new hosts. Gain full access to information about discovered services and hosts. [Discovery rule API](/manual/api/reference/drule) | [Discovery check API](/manual/api/reference/dcheck) | [Discovered host API](/manual/api/reference/dhost) | [Discovered service API](/manual/api/reference/dservice) #### Виявлення мережі Керуйте правилами виявлення на рівні мережі для автоматичного пошуку та моніторингу нових вузлів. Отримайте повний доступ до інформації про виявлені сервіси та вузли. [API правил виявлення](/manual/api/reference/drule) | [API Перевірка виявленнь](/manual/api/reference/dcheck) | [API Виявлень вузла](/manual/api/reference/dhost) | [API Виявлень служб](/manual/api/reference/dservice) ### Notation ### Позначення ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix агент на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix proxy in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix проксі на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix server in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. Examples of running Zabbix server with command line parameters: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix сервер на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. **-T**, **--test-config** Перевірити файл конфігурації та вийти. *-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести версію і вийти. Приклади запуску сервера Zabbix з параметрами командного рядка: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний файл конфігурації *config-file* замість стандартного. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовувати альтернативний конфігураційний файл *config-file* замість стандартного. **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Вивести інформацію про версію та вийдіть. [ ]{#lbAF} #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| ## OPTIONS **-s**, **--host** *host-name-or-IP* Specify host name or IP address of a host. **-p**, **--port** *port-number* Specify port number of agent running on the host. Default is 10050. **-I**, **--source-address** *IP-address* Specify source IP address. **-t**, **--timeout** *seconds* Specify timeout. Valid range: 1-30 seconds (default: 30) **-k**, **--key** *item-key* Specify key of item to retrieve value for. **-P**, **--protocol** *value* Protocol used to communicate with agent. Values: **auto** connect using JSON protocol, fallback and retry with plaintext protocol (default) **json** connect using JSON protocol **plaintext** connect using plaintext protocol where just item key is sent (6.4.x and older releases) **--tls-connect** *value* How to connect to agent. Values: [ ]{#lbAF} ## ПАРАМЕТРИ **-s**, **--host** *host-name-or-IP* Вкажіть ім'я або IP-адресу хоста. **-p**, **--port** *port-number* Укажіть номер порту агента, який працює на хості. За замовчуванням 10050. **-I**, **--source-address** *IP-address* Вкажіть IP-адресу джерела. **-t**, **--timeout** *seconds* Вкажіть час очікування. Дійсний діапазон: 1-30 секунд (за замовчуванням: 30) **-k**, **--key** *item-key* Укажіть ключ елемента, для якого потрібно отримати значення. **-P**, **--protocol** *value* Протокол, який використовується для зв'язку з агентом. Значення: **auto** підключення за допомогою протоколу JSON, резервний варіант і повторна спроба за допомогою протоколу відкритого тексту (за замовчуванням) **json** підключитися за допомогою протоколу JSON **plaintext** підключитися за допомогою протоколу відкритого тексту, де надсилається лише ключ елемента (версії 6.4.x і старіші) **--tls-connect** *value* Як підключитися до агента. Значення: [ ]{#lbAF} ## OPTIONS **-s**, **--script** *script-file* Specify the file name of the script to execute. If '-' is specified as file name, the script will be read from stdin. **-p**, **--param** *input-param* Specify the input parameter. **-i**, **--input** *input-file* Specify the file name of the input parameter. If '-' is specified as file name, the input will be read from stdin. **-w**, **--webdriver** *url* Specify the webdriver URL. **-l**, **--loglevel** *log-level* Specify the log level. **-t**, **--timeout** *timeout* Specify the timeout in seconds. Valid range: 1\-60 seconds (default: 10) **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## ПАРАМЕТРИ **-s**, **--script** *script-file* Вказати ім'я файлу скрипта для виконання. Якщо в якості імені файлу вказати '-' ім'я файлу, то скрипт буде прочитано з stdin. **-p**, **--param** *input-param* Вказати вхідний параметр. **-i**, **--input** *input-file* Вказати ім'я файлу вхідного параметра. Якщо в якості імені файлу вказати '-' ім'я файлу, то вхідні дані будуть прочитані з stdin. **-w**, **--webdriver** *url* Указати URL-адресу веб-драйвера. **-l**, **--loglevel** *log-level* Вказати рівень журналу. **-t**, **--timeout** *timeout* Вказати таймаут у секундах. Допустимий діапазон: 1\-60 секунд (за замовчуванням: 10) **-h**, **--help** Показати цю довідку і вийти. **-V**, **--version** Вивести інформацію про версію і вийти. [ ]{#lbAF} ## Other changes and bug fixes ### Інші зміни та виправлення помилок #### Overview By default, Zabbix provides a number of predefined themes. You may follow the step-by-step procedure provided here in order to create your own. Feel free to share the result of your work with Zabbix community if you created something nice. #### Огляд За замовчуванням Zabbix надає кілька попередньо визначених тем. Ви можете виконати наведену тут покрокову процедуру, щоб створити свій власний. Не соромтеся поділитися результатом своєї роботи зі спільнотою Zabbix, якщо ви створили щось хороше. ### Overview Custom loadable plugins extend Zabbix agent 2 functionality. They are compiled separately, but use a package shared with Zabbix agent 2. Each plugin is a *Go* package that defines the structure and implements one or several plugin interfaces (*Exporter*, *Configurator*, *Runner*). Jump to: - [Write your first plugin](/devel/plugins/how_to) - [Plugin interfaces](/devel/plugins/interfaces) See also: - [Example plugin for Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) ### Connection diagram Zabbix agent 2 connects bidirectionally to the plugins using UNIX sockets on Linux and Named Pipes on Windows. The connection diagram below illustrates the communication process between Zabbix agent 2 and a loadable plugin and the metrics collection process.  ### Огляд Користувацькі завантажувані плагіни розширюють функціональність Zabbix agent 2. Вони компілюються окремо, але використовують спільний з Zabbix agent 2 пакет. Кожен плагін — це пакет *Go*, який визначає структуру та реалізує один або кілька інтерфейсів плагіна (*Exporter*, *Configurator*, *Runner*). Перейти до: - [Напишіть свій перший плагін](/devel/plugins/how_to) - [Інтерфейси плагінів](/devel/plugins/interfaces) Дивіться також: - [Приклад плагіна для Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) ### Схема підключення Zabbix agent 2 двонаправлено підключається до плагінів за допомогою UNIX-сокетів у Linux та іменованих каналів (Named Pipes) у Windows. Наведена нижче схема з'єднання ілюструє процес зв'язку між Zabbix agent 2 і завантажуваним плагіном та процес збору метрик.  ### Overview High availability (HA) is typically required in critical infrastructures that can afford virtually no downtime. So for any service that may fail there must be a failover option in place to take over should the current service fail. Zabbix offers a **native** high-availability solution that is easy to set up and does not require any previous HA expertise. Native Zabbix HA may be useful for an extra layer of protection against software/hardware failures of Zabbix server or to have less downtime due to maintenance. In the Zabbix high availability mode multiple Zabbix servers are run as nodes in a cluster. While one Zabbix server in the cluster is active, others are on standby, ready to take over if necessary.  Switching to Zabbix HA is non-committal. You may switch back to standalone operation at any point. See also: [Implementation details](#implementation-details) ### Огляд Висока доступність (HA) зазвичай потрібна в критичних інфраструктурах, які практично не можуть дозволити собі простоїв. Тож, для будь-якого сервісу, який може вийти з ладу, має бути передбачена можливість переключення на інший ресурс, у разі відмови поточного сервісу. Zabbix пропонує **власне** рішення високої доступності, яке легко налаштувати і яке не потребує попереднього досвіду роботи з HA. Це вбудоване рішення може бути корисним як додатковий рівень захисту від програмних або апаратних збоїв сервера Zabbix або для зменшення часу простою під час технічного обслуговування. У режимі високої доступності Zabbix, кілька Zabbix серверів працюють як вузли кластеру. Поки один Zabbix сервер у кластері активний, інші знаходяться в режимі очікування і готові взяти на себе роботу, в разі потреби.  Перехід на Zabbix HA не є незворотнім. Ви можете повернутися до режиму самостійної роботи в будь-який момент. Дивіться також: [Деталі реалізації](#implementation-details) #### Overview In order to use any other language than English in Zabbix web interface, its locale should be installed on the web server. Additionally, the PHP gettext extension is required for the translations to work. #### Огляд Щоб використовувати будь-яку іншу мову, окрім англійської, у веб-інтерфейсі Zabbix, її локаль повинна бути встановлена на веб-сервері. Крім того, для роботи перекладів потрібне розширення PHP gettext. #### Overview In this section, you will learn how to log in and set up a system user in Zabbix. #### Огляд У цьому розділі ви дізнаєтесь, як увійти та налаштувати користувача системи Zabbix. #### Overview In this section you will learn how to set up a new host. A host in Zabbix is a networked entity (physical, virtual) that you wish to monitor. The definition of what can be a "host" in Zabbix is quite flexible. It can be a physical server, a network switch, a virtual machine or some application. #### Огляд У цьому розділі ви дізнаєтесь, як налаштувати новий вузол мережі. Вузол мережі у Zabbix — це мережева сутність (фізична, віртуальна), яку ви бажаєте моніторити. Визначення того, що може бути "вузлом мережі" у Zabbix, досить гнучке. Це може бути фізичний сервер, мережевий комутатор, віртуальна машина або якийсь додаток. #### Overview In this section, you will learn how to set up an item. Items are the basis of gathering data in Zabbix. Without items, there is no data - because only an item defines a single metric or what kind of data to collect from a host. #### Огляд У цьому розділі ви дізнаєтеся, як налаштувати елемент даних. Елементи даних є основою для збору даних у Zabbix. Без елементів даних немає даних, тому що лише елемент даних визначає один показник або тип даних, які потрібно збирати з вузла мережі. #### Overview In this section you will learn how to set up a template. Previously we learned how to set up an item, a trigger and how to get a problem notification for the host. While all of these steps offer a great deal of flexibility in themselves, it may appear like a lot of steps to take if needed for, say, a thousand hosts. Some automation would be handy. This is where templates come to help. Templates allow to group useful items, triggers and other entities so that those can be reused again and again by applying to hosts in a single step. When a template is linked to a host, the host inherits all entities of the template. So, basically a pre-prepared bunch of checks can be applied very quickly. #### Огляд У цьому розділі ви дізнаєтеся, як налаштувати шаблон. Раніше ми дізналися, як налаштувати елемент даних, тригер і як отримати сповіщення про проблему для вузла мережі. Хоча всі ці кроки самі по собі пропонують велику гнучкість, може здатися, що їх потрібно виконати багато, якщо це необхідно, скажімо, для тисячі вузлів мережі. Трохи автоматизації було б зручно. Тут на допомогу приходять шаблони. Шаблони дозволяють групувати корисні елементи даних, тригери та інші сутності, щоб їх можна було повторно використовувати знову і знову, застосовуючи до вузлів мережі за один крок. Коли шаблон пов’язано з вузлом мережі, вузол мережі успадковує всі сутності шаблону. Отже, в основному, заздалегідь підготовлену групу перевірок можна застосувати дуже швидко. #### Overview In this section you will learn how to set up a trigger. Items only collect data. To automatically evaluate incoming data we need to define triggers. A trigger contains an expression that defines a threshold of what is an acceptable level for the data. If that level is surpassed by the incoming data, a trigger will "fire" or go into a 'Problem' state - letting us know that something has happened that may require attention. If the level is acceptable again, trigger returns to an 'Ok' state. #### Огляд У цьому розділі ви дізнаєтесь, як налаштувати тригер. Елементи даних лише збирають дані. Щоб автоматично оцінювати вхідні дані, нам потрібно визначити тригери. Тригер містить вираз, який визначає порогове значення прийнятного рівня для даних. Якщо вхідні дані перевищують цей рівень, спрацьовує тригер, або переходить у стан 'Проблема', повідомляючи нам, що трапилося щось, що може потребувати уваги. Якщо рівень знову прийнятний, тригер повертається до стану 'OK'. #### Overview Problem events in Zabbix can be acknowledged by users. If a user gets notified about a problem event, they can go to Zabbix frontend, open the problem update popup window of that problem using one of the ways listed below and acknowledge the problem. When acknowledging, they can enter their comment for it, saying that they are working on it or whatever else they may feel like saying about it. This way, if another system user spots the same problem, they immediately see if it has been acknowledged and the comments so far. This way the workflow of resolving problems with more than one system user can take place in a coordinated way. Acknowledgment status is also used when defining [action operations](/manual/config/notifications/action/operation). You can define, for example, that a notification is sent to a higher level manager only if an event is not acknowledged for some time. To acknowledge events and comment on them, a user must have at least read permissions to the corresponding triggers. To change problem severity or close problem, a user must have read-write permissions to the corresponding triggers. There are **several** ways to access the problem update popup window, which allows acknowledging a problem. - You may select problems in *Monitoring* → *Problems* and then click on *Mass update* below the list - You can click on *Update* in the *Update* column of a problem in: - *Dashboards* (*Problems* and *Problems by severity* widgets) - *Monitoring → Problems* - *Monitoring → Problems → Event details* - You can click on an unresolved problem cell in: - *Dashboards* (*Trigger overview* widget) The popup menu contains an *Update* option that will take you to the problem update window. #### Огляд Проблемні події в Zabbix можуть бути визнані користувачами. Якщо користувач отримує сповіщення про проблему, він може перейти до інтерфейсу Zabbix, відкрити спливаюче вікно оновлення цієї проблеми одним із способів, перелічених нижче, і підтвердити проблему. Підтверджуючи, вони можуть ввести свій коментар до цього, сказавши,що вони над цим працюють, або будь-що інше, що вони можуть сказати про це. Таким чином, якщо інший користувач системи помітить ту саму проблему, він одразу побачить, чи було її підтверджено, і коментарі до цього часу. Таким чином робочий процес вирішення проблем із кількома користувачами системи може відбуватися скоординовано. Статус підтвердження також використовується під час визначення [операцій дій](/manual/config/notifications/action/operation). Ви можете визначити, наприклад, що сповіщення надсилається менеджеру вищого рівня, лише якщо подія не підтверджується протягом деякого часу. Щоб підтверджувати події та коментувати їх, користувач повинен мати принаймні дозволи на читання відповідних тригерів. Щоб змінити серйозність проблеми або закрити проблему, користувач повинен мати дозволи на читання та запис для відповідних тригерів. Існує **кілька** способів отримати доступ до спливаючого вікна оновлення проблеми, яке дозволяє підтвердити проблему. - Ви можете вибрати проблеми в *Моніторинг* → *Проблеми*, а потім натиснути *Масове оновлення* під списком - Ви можете натиснути на *Оновити* в колонці *Оновити* проблеми в: - *Дашборди* (віджети *Проблеми* та *Проблеми за ступенем серйозності*) - *Моніторинг → Проблеми* - *Моніторинг → Проблеми → Деталі події* -Ви можете натиснути на клітинку з невирішеною проблемою: - *Дашборди* (віджет *Огляд тригерів*) Спливне меню містить опцію *Оновити*, за допомогою якої ви перейдете до вікна оновлення проблеми. #### Overview Problem suppression offers a way of temporarily hiding a problem that can be dealt with later. This is useful for cleaning up the problem list in order to give the highest priority to the most urgent issues. For example, sometimes an issue may arise on the weekend that is not urgent enough to be dealt with immediately, so it can be "snoozed" until Monday morning. Problem suppression allows to hide a *single* problem, in contrast to problem suppression through host maintenance when all problems of the maintenance host are hidden. Operations for trigger actions will be paused for suppressed problems the same way as it is done with [host maintenance](/manual/maintenance). #### Огляд Приховування проблеми пропонує спосіб тимчасово приховати проблему, яка можна вирішити пізніше. Це корисно для очищення списку проблем для того, щоб надавати найвищий пріоритет найбільш актуальним питанням. Наприклад, іноді у вихідні, може виникнути проблема, яка не на стільки термінова, щоб негайно її вирішити, тому її можна "відкласти" до ранку понеділка. Приховування проблеми дозволяє приховати *окрему* проблему, на відміну від приховування через обслуговування хоста, коли всі проблеми хоста, який обслуговується, приховані. Операції для тригерних дій також буде призупинено для пригнічених проблем так, як це робиться за допомогою [обслуговування хоста](/manual/maintenance). #### Overview Some new items are automatically added for monitoring when web scenarios are created. All items inherit tags from the web scenario. #### Огляд Деякі нові елементи автоматично додаються для моніторингу під час створення веб-сценаріїв. Усі елементи успадковують теги з веб-сценарію. #### Overview Templates are [exported](/manual/xml_export_import) with many related objects and object relations. Template export contains: - Linked template groups - Linked host groups (if used in [host prototype](/manual/discovery/low_level_discovery/host_prototypes) configuration) - Template data - Linkage to other templates - Linkage to template groups - Directly linked items - Directly linked triggers - Directly linked graphs - Directly linked dashboards - Directly linked discovery rules with all prototypes - Directly linked web scenarios - Value maps #### Огляд Шаблони [експортуються](/manual/xml_export_import) із багатьма пов’язаними об’єктами та об’єктними зв’язками. Експорт шаблону містить: — Зв’язані групи шаблонів - Пов’язані групи хостів (якщо використовуються в конфігурації [прототип хоста](/manual/discovery/low_level_discovery/host_prototypes)) - Дані шаблону - Зв'язок з іншими шаблонами - Зв’язок із групами шаблонів - Безпосередньо пов'язані елементи даних - Безпосередньо пов'язані тригери - Безпосередньо пов'язані графи - Безпосередньо пов'язані інформаційні панелі - Безпосередньо пов'язані правила виявлення з усіма прототипами - Безпосередньо пов'язані веб-сценарії - Карти значень #### Overview The Monitoring menu is all about displaying data. Whatever information Zabbix is configured to gather, visualize and act upon, it will be displayed in the various sections of the Monitoring menu. #### Огляд У меню моніторингу відображаються дані. Яку б інформацію не налаштував Zabbix для збору, візуалізації та дії, вона буде відображатися в різних розділах меню моніторингу. #### Overview The Reports menu features several sections that contain a variety of predefined and user-customizable reports focused on displaying an overview of such parameters as system information, triggers and gathered data. #### Огляд Меню «Звіти» містить кілька розділів, які містять різноманітні попередньо визначені та настроювані користувачем звіти, орієнтовані на відображення огляду таких параметрів, як системна інформація, тригери та зібрані дані. #### Overview The Services menu is for the [service monitoring](/manual/it_services) functions of Zabbix. #### Огляд Меню «Сервіси» призначене для функцій [сервісного моніторингу] /manual/it_services) Zabbix. ### Overview The Zabbix API allows you to programmatically retrieve and modify configuration of Zabbix and provides access to historical data. It is widely used to: - create new applications to work with Zabbix; - integrate Zabbix into a third-party software; - automate routine tasks. The Zabbix API is an HTTP-based API, and it is shipped as a part of the web frontend. It uses the JSON-RPC 2.0 protocol, which means two things: - the API consists of a set of separate methods; - requests and responses between the clients and the API are encoded using the JSON format. For more information about the protocol and JSON, see the [JSON-RPC 2.0 specification](http://www.jsonrpc.org/specification) and the [JSON format homepage](http://json.org/). For more information about integrating Zabbix functionality into your Python applications, see the [zabbix_utils](https://github.com/zabbix/python-zabbix-utils) Python library for Zabbix API. ### Огляд Zabbix API дозволяє програмно отримувати та змінювати налаштування Zabbix і забезпечує доступ до історичних даних. Це широко використовується для: - створення нових програм для роботи з Zabbix; - інтегрування Zabbix у стороннє програмне забезпечення; - автоматизації рутинних завдань. Zabbix API — це API на основі HTTP, який постачається як частина веб-інтерфейсу. Він використовує протокол JSON-RPC 2.0, що означає дві речі: - API складається з набору окремих методів. - запити та відповіді між клієнтами та API кодуються у форматі JSON. Додаткову інформацію про протокол і JSON можна знайти в [специфікації JSON-RPC 2.0] (http://www.jsonrpc.org/specification) і [на домашній сторінці формату JSON](http://json.org/). Щоб дізнатися більше про інтеграцію функцій Zabbix у ваші програми Python, перегляньте [zabbix_utils](https://github.com/zabbix/python-zabbix-utils) - Python бібліотеку для Zabbix API. ### Overview This section allows to view and [configure](/manual/it_services/sla) SLAs. ### Огляд Цей розділ дозволяє переглядати та [налаштовувати](/manual/it_services/sla) SLA. #### Overview Zabbix supports data export in real-time in two ways: - [export to files](/manual/config/export/files) - [streaming to external systems](/manual/config/export/streaming) The following entities can be exported: - trigger events - item values - trends (export to files only) #### Огляд Zabbix підтримує експорт даних у режимі реального часу двома способами: - [експорт у файли](/manual/config/export/files) - [потокове передавання у зовнішні системи](/manual/config/export/streaming) Можна експортувати такі сутності: - події тригеру - значення елементів даних - тренди (лише експорт у файли) ### Parameters `(array)` IDs of hosts to delete. ### Параметри `(array)` ID хостів для видалення. ### Parameters `(array)` IDs of items to clear. ### Параметри `(array)` ID елементів для очищення. ### Parameters `(array)` IDs of the actions to delete. ### Параметри `(array)` Ідентифікатори дій для видалення. ### Parameters `(array)` IDs of the correlations to delete. ### Параметри `(array)` Ідентифікатори кореляцій, які потрібно видалити. ### Parameters `(array)` IDs of the dashboards to delete. ### Параметри `(array)` Ідентифікатори інформаційних панелей для видалення. ### Parameters `(array)` IDs of the discovery rules to delete. ### Параметри `(array)` ідентифікатори правил виявлення для видалення. ### Parameters `(array)` IDs of the graph prototypes to delete. ### Параметри `(масив)` ID прототипів графіків для видалення. ### Parameters `(array)` IDs of the graphs to delete. ### Параметри `(array)` ID графіків для видалення. ### Parameters `(array)` IDs of the host groups to delete. ### Параметри `(array)` ID груп хостів для видалення. ### Parameters `(array)` IDs of the host interfaces to delete. ### Параметри `(array)` ID хост-інтерфейсів для видалення. ### Parameters `(array)` IDs of the LLD rules to delete. ### Параметри `(array)` ідентифікатори правил LLD для видалення. ### Parameters `(array)` The method accepts an empty array. ### Параметри `(array)` Метод приймає порожній масив. ### Parameters `(object/array)` Actions to create. Additionally to the [standard action properties](object#action), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|[Action filter](/manual/api/reference/action/object#action_filter) object for the action.| |operations|array|[Action operations](/manual/api/reference/action/object#action_operation) to create for the action.| |recovery\_operations|array|[Action recovery operations](/manual/api/reference/action/object#action_recovery_operation) to create for the action.| |update\_operations|array|[Action update operations](/manual/api/reference/action/object#action_update_operation) to create for the action.| ### Параметри `(object/array)` Дії для створення. На додаток до [стандартних властивостей дії](object#action), метод приймає наступні параметри. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|[Дія фільтру](/manual/api/reference/action/object#action_filter) об’єкт для дії.|| |operations|array|[Дія операції](/manual/api/reference/action/object#action_operation), щоб створити для дії.| |recovery\_operations|array|[Дія операції відновлення](/manual/api/reference/action/object#action_recovery_operation), яку потрібно створити для дії.| |update\_operations|array|[Дія операції оновлення](/manual/api/reference/action/object#action_update_operation), яку потрібно створити для дії.| ### Parameters `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Параметри `(object/array)` [Властивості групи хостів](object#host_group) потрібно оновити. Властивість groupid має бути визначена для кожної групи хостів, усі інші властивості необов’язкові. Будуть оновлені лише вказані властивості, всі інші залишаться незмінними. ### Part 1: Writing the Go code In this section you will learn how to write the plugin that adds a new metric to Zabbix agent 2. 1. Create a new directory *myip* in */usr/local/zabbix/go/plugins/*. 2. Create the file *main.go* inside *myip* directory and define the name of your Go package. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main ``` ::: notetip Keep the file open to add more lines as described in the next steps. ::: 3. Specify the packages to import. These are the packages that support the plugin. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) ``` 4. Define the plugin structure. Embed the *plugin.Base* structure to gain access to the standard plugin functionality. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin ``` 5. Implement plugin interface [Export](/devel/plugins/interfaces). The Export interface performs a poll and returns a value. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error) ``` 6. Add logging. Log messages will appear in the Zabbix agent 2 log. You can use one of the logging functions available to plugins: *Critf()*, *Errf()*, *Infof()*, *Warningf()*, *Debugf()*, *Tracef()*. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) } ``` 7. Implement the core plugin logic. This logic fetches the response from the specified URL and reads it, then returns the IP address as a response and closes the request. In case of an error when executing the GET request or reading a response, the error is returned instead. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } ``` 8. Register the metric. Zabbix agent 2 initiates running *init()* function upon startup. This function will call *plugin.RegisterMetrics(structure, plugin name, metric name, description)* method to get the plugin data. The *plugin.RegisterMetrics* method parameter description: - **structure** - a pointer to plugin implementation; grants access to the plugin structure, including list of available plugin interfaces (for example, *&impl*). - **name** - plugin name; must be unique (for example, *"Myip"*). - **metric name** - metric name (for example, *"myip"*). This is the item key used to gather data from a plugin. - **description** - metric description; must start with a capital letter and end with a period (for example, *""Return the external IP address of the host where agent is running."*). ::: notetip To register several metrics, repeat the parameters **metric name** and **description** for each metric. For example: `plugin.RegisterMetrics(&impl, "Myip", "metric.one", "Metric one description.", "metric.two", "Metric two description.")` ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } ``` 9. Define the *main()* function, which will create a new plugin handler instance, assign it to be used for logging by the plugin and then execute the plugin handler. ::: noteimportant Defining the *main()* function is mandatory. ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } func main() { h, err := container.NewHandler(impl.Name()) if err != nil { panic(fmt.Sprintf("failed to create plugin handler %s", err.Error())) } impl.Logger = &h err = h.Execute() if err != nil { panic(fmt.Sprintf("failed to execute plugin handler %s", err.Error())) } } ``` ### Частина 1: Написання коду на Go У цьому розділі ви дізнаєтеся, як написати плагін, який додає нову метрику до Zabbix агента 2. 1. Створіть новий каталог *myip* в */usr/local/zabbix/go/plugins/*. 2. Створіть файл *main.go* всередині каталогу *myip* і визначте ім'я вашого Go пакету. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main ``` ::: notetip Тримайте файл відкритим, щоб додати нові рядки, як описано в наступних кроках. ::: 3. Вкажіть пакети для імпорту. Це пакети, які підтримують плагін. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) ``` 4. Визначте структуру плагіна. Додайте структуру *plugin.Base*, щоб отримати доступ до стандартного функціоналу плагіна. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin ``` 5. Реалізуйте інтерфейс плагіна [Export] (/devel/plugins/interfaces). Інтерфейс експорту виконує опитування і повертає значення. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error) ``` 6. Додайте логування. Повідомлення журналу з'являться в log файлі Zabbix Agent 2. Ви можете використовувати одну з функцій логування, доступних для плагінів: *Critf()*, *Errf()*, *Infof()*, *Warningf()*, *Debugf()*, *Tracef()*. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) } ``` 7. Реалізуйте основну логіку плагіна. Ця логіка отримує відповідь за вказаною URL-адресою і читає її, потім повертає IP-адресу як відповідь і закриває запит. У разі помилки при виконанні GET-запиту або читанні відповіді, замість неї повертається помилка. **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } ``` 8. Зареєструйте метрику. Zabbix агент 2 ініціює виконання функції *init()* при запуску. Ця функція викличе метод *plugin.RegisterMetrics(structure, plugin name, metric name, description)* для отримання даних плагіна. Опис параметрів методу *plugin.RegisterMetrics*: - **structure** - вказівник на реалізацію плагіна; надає доступ до структури плагіна, включаючи список доступних інтерфейсів плагіна (наприклад, *&impl*) .- **name** - назва плагіна; має бути унікальною (наприклад, *"Myip "*). - **metric name** - назва метрики (наприклад, *"myip "*). Це ключ елемента, який використовується для збору даних з плагіна. - **description** - опис метрики; має починатися з великої літери і закінчуватися крапкою (наприклад, *""Return the external IP address of the host where agent is running."*). :: notetip Щоб зареєструвати кілька метрик, повторіть параметри **metric name** та **description** для кожної метрики. Наприклад: `plugin.RegisterMetrics(&impl, "Myip", "metric.one", "Опис першої метрики.", "metric.two", "Опис другої метрики.")`. ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } ``` 9. Визначте функцію *main()*, яка створить новий екземпляр обробника плагіна, призначить його для ведення журналу плагіном, а потім виконає обробник плагіна. ::: noteimportant Визначення функції *main()* є обов'язковим. ::: **/usr/local/zabbix/go/plugins/myip/main.go** ```go package main import ( "fmt" "io/ioutil" "net/http" "git.zabbix.com/ap/plugin-support/plugin/container" "git.zabbix.com/ap/plugin-support/plugin" ) type Plugin struct { plugin.Base } var impl Plugin func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){ p.Infof("received request to handle %s key with %d parameters", key, len(params)) resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, err } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return string(body), nil } func init() { plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } func main() { h, err := container.NewHandler(impl.Name()) if err != nil { panic(fmt.Sprintf("failed to create plugin handler %s", err.Error())) } impl.Logger = &h err = h.Execute() if err != nil { panic(fmt.Sprintf("failed to execute plugin handler %s", err.Error())) } } ``` ## Part II - Gauge chart ## Частина II - Калібрувальна діаграма (Gauge chart) ### Part III - Module action An action is implemented in two files - *actions/MyAddress.php* and *views/my.address.php*. The ***actions/MyAddress.php*** file takes care of the business logic implementation, while the ***views/my.address.php*** file is responsible for the view. 1. Create a directory *actions* in the *MyAddress* directory. 2. Create a *MyAddress.php* file in the *actions* directory. The action logic will be defined in the *MyAddress* class. This action class will implement four functions: *init()*, *checkInput()*, *checkPermissions()*, and *doAction()*. Zabbix frontend calls the *doAction()* function when the action is requested. This function is responsible for the business logic of the module. ::: noteimportant The data must be organized as an associative array. The array can be multidimensional and may contain any data expected by the view. ::: **ui/modules/MyAddress/actions/MyAddress.php** ```php <?php namespace Modules\MyAddress\Actions; use CController, CControllerResponseData; class MyAddress extends CController { public function init(): void { $this->disableCsrfValidation(); } protected function checkInput(): bool { return true; } protected function checkPermissions(): bool { return true; } protected function doAction(): void { $data = ['my-ip' => file_get_contents("https://api.seeip.org")]; $response = new CControllerResponseData($data); $this->setResponse($response); } } ``` 3. Create a new directory *views* in the *MyAddress* directory. 4. Create a *my.address.php* file in the *views* directory and define the module view. Note that the variable `$data` is available in the view without specifically defining it. The framework automatically passes the associative array to the view. **ui/modules/MyAddress/views/my.address.php** ```php <?php (new CHtmlPage()) ->setTitle(_('The HTML Title of My Address Page')) ->addItem(new CDiv($data['my-ip'])) ->show(); ``` 5. The module action has to be registered in the *manifest.json* file. Open *manifest.json* and add a new object `actions` that contains: - the action key with the action name written in lowercase (a-z) and with words separated by dots (for example, `my.address`); - the action class name (`MyAddress`) as a value for the `class` key of the `my.address` object; - the action view name (`my.address`) as a value for the `view` key of the `my.address` object. **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "My External IP Address.", "actions": { "my.address": { "class": "MyAddress", "view": "my.address" } } } ``` 6. Refresh Zabbix frontend. Click on *My address → External IP* to see the IP address of your computer. {width="600"} ### Частина III - Дія модуля Дія реалізована в двох файлах - *actions/MyAddress.php* і *views/my.address.php*. Файл ***actions/MyAddress.php*** відповідає за реалізацію бізнес-логіки, тоді як файл ***views/my.address.php*** відповідає за зовнішній вигляд. 1. Створіть каталог *actions* у каталозі *MyAddress*. 2. Створіть файл *MyAddress.php* у каталозі *actions*. Логіка дій буде визначена в класі *MyAddress*. Цей клас дій реалізує чотири функції: *init()*, *checkInput()*, *checkPermissions()* і *doAction()*. Фронтенд Zabbix запускає функцію *doAction()*, коли викликається дія. Ця функція відповідає за бізнес-логіку модуля. ::: noteimportant Дані повинні бути організовані як асоціативний масив. Масив може бути багатовимірним і може містити будь-які дані, які очікує view. ::: **ui/modules/MyAddress/actions/MyAddress.php** ```php <?php namespace Modules\MyAddress\Actions; use CController, CControllerResponseData; class MyAddress extends CController { public function init(): void { $this->disableCsrfValidation(); } protected function checkInput(): bool { return true; } protected function checkPermissions(): bool { return true; } protected function doAction(): void { $data = ['my-ip' => file_get_contents("https://api.seeip.org")]; $response = new CControllerResponseData($data); $this->setResponse($response); } } ``` 3. Створіть новий каталог *views* у каталозі *MyAddress*. 4. Створіть файл *my.address.php* у каталозі *views* і визначте вигляд модуля. Зауважте, що змінна `$data` доступна у view без її спеціального визначення. Фреймворк автоматично передає асоціативний масив у view. **ui/modules/MyAddress/views/my.address.php** ```php <?php (new CHtmlPage()) ->setTitle(_('The HTML Title of My Address Page')) ->addItem(new CDiv($data['my-ip'])) ->show(); ``` 5. Дія модуля має бути зареєстрована у файлі *manifest.json*. Відкрийте *manifest.json* і додайте новий об’єкт «actions», який містить: - ключ дії з назвою дії, написаною малими літерами (a-z) і словами, розділеними крапками (наприклад, `my.address`); - ім'я класу дії (`MyAddress`) як значення для ключа `class` об'єкта `my.address`; - ім'я для view дії (`my.address`) як значення для ключа `view` об'єкта `my.address`. **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "My External IP Address", "actions": { "my.address": { "class": "MyAddress", "view": "my.address" } } } ``` 6. Оновіть інтерфейс Zabbix. Натисніть на розділ меню *Моя адреса → Зовнішня IP-адреса*, щоб побачити IP-адресу вашого комп’ютера. {width="600"} ### Part II - Menu section location change In this part, you will move the *My Address* menu section to the *Monitoring* section and then add a nested menu to it. As a result, users will be able to access two sub-menu pages from the *Monitoring → My Address* menu section. 1. Open and edit the *Module.php* file. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setAction('userprofile.edit') ); } } ``` 2. Refresh Zabbix frontend. Expand the *Monitoring* menu section and observe that the *My address* section is now located below the *Discovery* section. {width="600"} 3. To add nested pages to the *My Address* menu section, open and edit the *Module.php* file again. This step creates two subsections: - *External IP* that executes a new 'my.address' action that will be defined in the next steps; - *User profile* that executes the predefined 'userprofile.edit' action to open the *User profile* page. Note that for the nested menu, you need to use the *CMenu* class in addition to the classes used in the previous steps. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenu, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setSubMenu( new CMenu([ (new CMenuItem(_('External IP')))->setAction('my.address'), (new CMenuItem(_('User profile')))->setAction('userprofile.edit') ]) ) ); } } ``` 4. Refresh Zabbix frontend. Observe that the *My address* menu section now contains a third-level menu with two pages - *External IP* and *User profile*. {width="600"} ### Частина II - Зміна розташування розділу меню У цій частині ви перемістите розділ меню *Моя адреса* в розділ *Моніторинг* і потім додасте до нього вкладене меню. У результаті користувачі матимуть доступ до двох сторінок підменю з розділу меню *Моніторинг → Моя адреса*. 1. Відкрийте та відредагуйте файл *Module.php*. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setAction('userprofile.edit') ); } } ``` 2. Оновіть інтерфейс Zabbix. Розгорніть розділ меню *Моніторинг* і зверніть увагу, що розділ *Моя адреса* тепер розташований під розділом *Виявлення*. {width="600"} 3. Щоб додати вкладені сторінки до розділу меню *Моя адреса*, знову відкрийте та відредагуйте файл *Module.php*. Цей крок створює два підрозділи: - *Зовнішня IP-адреса*, який виконує нову дію «my.address», яка буде визначена в наступних кроках; - *Профіль користувача*, який виконує попередньо визначену дію «userprofile.edit», щоб відкрити сторінку *Профіль користувача*. Зауважте, що для вкладеного меню вам потрібно використовувати клас *CMenu* на додаток до класів, використаних у попередніх кроках. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenu, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setSubMenu( new CMenu([ (new CMenuItem(_('External IP')))->setAction('my.address'), (new CMenuItem(_('User profile')))->setAction('userprofile.edit') ]) ) ); } } ``` 4. Оновіть інтерфейс Zabbix. Зверніть увагу, що розділ меню *Моя адреса* тепер містить меню третього рівня з двома сторінками - *Зовнішня IP-адреса* та *Профіль користувача*. {width="600"} ### Part I - New menu section ### Частина I - Новий розділ меню ### plugin.Configurator *Configurator* interface provides plugin configuration parameters from Zabbix agent 2 configuration files. ### plugin.Configurator Інтерфейс *Configurator* надає параметри конфігурації плагіна з конфігураційних файлів Zabbix agent 2. ### plugin.Exporter *Exporter* is the simplest interface that performs a poll and returns a value (values), nothing, or error. It accepts a preparsed item key, parameters, and context. Access to all other plugin interfaces is exclusive and no method can be called if a plugin is already performing a task. Also, there is a limit of 100 maximum concurrent *Export()* calls per plugin, which can be reduced according to the requirements for each plugin. ### plugin.Exporter *Exporter* — це найпростіший інтерфейс, який виконує опитування та повертає значення (або кілька значень), нічого або помилку. Він приймає підготовлений ключ елемента даних, параметри та контекст. Доступ до всіх інших інтерфейсів плагінів є ексклюзивним, і жоден метод не може бути викликаний, якщо плагін уже виконує завдання. Крім того, існує обмеження в 100 одночасних викликів *Export()* для одного плагіна, яке можна зменшити відповідно до вимог для кожного плагіна. # Plugin interfaces This section describes available plugin interfaces. # Інтерфейси плагінів У цьому розділі описано доступні інтерфейси плагінів. ### plugin.Runner *Runner* interface provides the means for performing initialization when a plugin is started (activated) and deinitialization when a plugin is stopped (deactivated). For example, a plugin can start/stop some background *goroutine* by implementing the Runner interface. ### plugin.Runner Інтерфейс *Runner* надає засоби для виконання ініціалізації, коли плагін запущено (активовано), і деініціалізації, коли плагін зупинено (дезактивовано). Наприклад, плагін може запускати/зупиняти деяку фонову *goroutine* шляхом реалізації інтерфейсу Runner. # Plugins # Плагіни #### PostgreSQL If a value contains a non-ASCII character in non UTF8 encoding - this will lead to a failed SQL query (PGRES\_FATAL\_ERROR:ERROR invalid byte sequence for encoding) and data will not be stored. An appropriate warning message will be written to the *zabbix\_server.log*.\ Relevant for at least PostgreSQL version 9.1.3 #### PostgreSQL Якщо значення містить символ, відмінний від ASCII, у кодуванні, відмінному від UTF8, це призведе до помилки SQL-запиту (PGRES\_FATAL\_ERROR:ERROR недійсна послідовність байтів для кодування), і дані не будуть збережені. Відповідне попередження буде записано в *zabbix\_server.log*.\ Актуально принаймні для PostgreSQL версії 9.1.3 ##### Preparing frontend Make sure that Zabbix server address:port is **not defined** in the frontend configuration (found in `conf/zabbix.conf.php` of the frontend files directory). {width="600"} Zabbix frontend will autodetect the active node by reading settings from the nodes table in Zabbix database. Node address of the active node will be used as the Zabbix server address. ##### Підготовка web-інтерфейсу Переконайтеся, що в конфігураційному файлі web-інтерфейсу ( знаходиться у `conf/zabbix.conf.php` в директорії з файлами веб-інтерфейсу) **не вказано** адреса:порт Zabbix сервера. {width="600"} Web-інтерфейс Zabbix автоматично визначить активний вузол, зчитавши налаштування з таблиці вузлів у базі даних Zabbix. Адреса активного вузла буде використана як адреса Zabbix сервера. ## Pre-requisites Before proceeding make sure, that: - The module is located inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). - The module has at least a basic version of [manifest.json](/devel/modules/file_structure/manifest) file. - You have access to the Administration menu section in Zabbix (requires Super admin user role type). :::notetip The frontend will not install or even recognize incompatible modules. ::: ## Необхідні умови Перш ніж продовжити, переконайтеся, що: - Модуль знаходиться в каталозі *modules* вашої інсталяції web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). - Модуль має принаймні базову версію файлу [manifest.json](/devel/modules/file_structure/manifest). - Ви маєте доступ до розділу меню «Адміністрування» в Zabbix (потрібна роль суперадміністратора). :::notetip Інтерфейс не встановить і навіть не розпізнає несумісні модулі. ::: ##### Presentation modification methods The widget presentation modification methods are responsible for modifying widget appearance. ##### Методи модифікації презентації Методи модифікації представлення віджетів відповідають за зміну зовнішнього вигляду віджетів. # Presentation This page describes the components that can be used to create a widget presentation view. The widget presentation view is the part of the widget that receives the data according to its [configuration](/configuration) and displays it on the dashboard in a container. The presentation view consists of three parts: - [Widget action](#widget-action) - [Widget view](#widget-view) - [JavaScript](#javascript) # Презентація Ця сторінка описує компоненти, які можуть бути використані для створення представлення віджету. Представлення віджету - це частина віджету, яка отримує дані відповідно до його [конфігурації](/configuration) і відображає їх на інформаційній панелі в контейнері. Вид презентації складається з трьох частин: - [Action віджета](#widget-action) - [View віджетів](#widget-view) - [JavaScript](#javascript) #### Problems Retrieve problems according to the given parameters. [Problem API](/manual/api/reference/problem) #### Проблеми Отримати проблеми за заданими параметрами. [API проблеми](/manual/api/reference/problem) ##### Protection against brute force attacks In case of five consecutive failed login attempts, Zabbix interface will pause for 30 seconds in order to prevent brute force and dictionary attacks. The IP address of a failed login attempt will be displayed after a successful login. ##### Захист від атак перебором У разі п’яти послідовних невдалих спроб входу інтерфейс Zabbix призупиняється на 30 секунд, щоб запобігти атакам перебору та словниковим атакам. IP-адреса невдалої спроби входу буде відображена після успішного входу. #### Proxies and proxy groups Manage the proxies used in your distributed monitoring setup. [Proxy API](/manual/api/reference/proxy) | [Proxy group API](/manual/api/reference/proxygroup) #### Проксі та групи проксі Керуйте проксі-серверами, які використовуються в налаштуваннях розподіленого моніторингу. [API проксі](/manual/api/reference/proxy) | [API групи проксі](/manual/api/reference/proxygroup) ##### Proxy configuration HA cluster nodes (servers) must be listed in the configuration of either passive or active Zabbix proxy. For a passive proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **comma**. ``` Server=zabbix-node-01,zabbix-node-02 ``` For an active proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **semicolon**. ``` Server=zabbix-node-01;zabbix-node-02 ``` ##### Конфігурація проксі Вузли (сервери) кластера HA повинні бути вказані в конфігурації пасивного або активного Zabbix проксі. Для пасивного проксі імена вузлів кластеру мають бути вказані в [параметрі](/manual/appendix/config/zabbix_proxy) Server і розділені **комою**. ``` Server=zabbix-node-01,zabbix-node-02 ``` Для активного проксі імена вузлів кластеру мають бути вказані в [параметрі](/manual/appendix/config/zabbix_proxy) Server і розділені **крапкою з комою**. ``` Server=zabbix-node-01;zabbix-node-02 ``` # Register a new module This section explains how to add a new module to Zabbix frontend. # Реєстрація нового модуля У цьому розділі пояснюється, як додати новий модуль до інтерфейсу Zabbix. ### Report The filter allows to select the report based on the SLA name as well as the service name. It is also possible to limit the displayed period. {width="600"} Each column (period) displays the SLI for that period. SLIs that are in breach of the set SLO are highlighted in red. 20 periods are displayed in the report. A maximum of 100 periods can be displayed, if both the *From* date and *To* date are specified. ### Звіт Фільтр дозволяє вибрати звіт на основі назви SLA, а також назви служби. Також можна обмежити відображуваний період. {width="600"} Кожен стовпець (період) відображає SLI для цього періоду. SLI, які порушують встановлений SLO, виділені червоним кольором. У звіті відображається 20 періодів. Можна відобразити максимум 100 періодів, якщо вказано обидві дати *Від* і *До*. #### Retrieve discovery actions Retrieve all configured discovery actions together with action conditions and operations. The filter uses the "and" evaluation type, so the `formula` property is empty and `eval_formula` is generated automatically. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 1 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "2", "name": "Auto discovery. Linux servers.", "eventsource": "1", "status": "1", "esc_period": "0s", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "conditiontype": "10", "operator": "0", "value": "0", "value2": "", "formulaid": "B" }, { "conditiontype": "8", "operator": "0", "value": "9", "value2": "", "formulaid": "C" }, { "conditiontype": "12", "operator": "2", "value": "Linux", "value2": "", "formulaid": "A" } ], "eval_formula": "A and B and C" }, "operations": [ { "operationid": "1", "actionid": "2", "operationtype": "6", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "optemplate": [ { "templateid": "10001" } ] }, { "operationid": "2", "actionid": "2", "operationtype": "4", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opgroup": [ { "groupid": "2" } ] } ] } ], "id": 1 } ``` #### Отримати дії виявлення Отримати всі налаштовані дії виявлення разом із умовами дій та операціями. Фільтр використовує тип оцінки "and", тому властивість `formula` порожня, а `eval_formula` генерується автоматично. [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 1 } }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "2", "name": "Auto discovery. Linux servers.", "eventsource": "1", "status": "1", "esc_period": "0s", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "conditiontype": "10", "operator": "0", "value": "0", "value2": "", "formulaid": "B" }, { "conditiontype": "8", "operator": "0", "value": "9", "value2": "", "formulaid": "C" }, { "conditiontype": "12", "operator": "2", "value": "Linux", "value2": "", "formulaid": "A" } ], "eval_formula": "A and B and C" }, "operations": [ { "operationid": "1", "actionid": "2", "operationtype": "6", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "optemplate": [ { "templateid": "10001" } ] }, { "operationid": "2", "actionid": "2", "operationtype": "4", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opgroup": [ { "groupid": "2" } ] } ] } ], "id": 1 } ``` #### Retrieve trigger actions Retrieve all configured trigger actions together with action conditions and operations. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectRecoveryOperations": "extend", "selectUpdateOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 0 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "3", "name": "Report problems to Zabbix administrators", "eventsource": "0", "status": "1", "esc_period": "1h", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [], "eval_formula": "" }, "operations": [ { "operationid": "3", "actionid": "3", "operationtype": "0", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opmessage": [ { "default_msg": "1", "subject": "", "message": "", "mediatypeid" => "0" } ], "opmessage_grp": [ { "usrgrpid": "7" } ] } ], "recovery_operations": [ { "operationid": "7", "actionid": "3", "operationtype": "11", "evaltype": "0", "opconditions": [], "opmessage": { "default_msg": "0", "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}", "message": "Trigger: {TRIGGER.NAME}\r\nTrigger status: {TRIGGER.STATUS}\r\nTrigger severity: {TRIGGER.SEVERITY}\r\nTrigger URL: {TRIGGER.URL}\r\n\r\nItem values:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n\r\nOriginal event ID: {EVENT.ID}", "mediatypeid": "0" } } ], "update_operations": [ { "operationid": "31", "operationtype": "12", "evaltype": "0", "opmessage": { "default_msg": "1", "subject": "", "message": "", "mediatypeid": "0" } }, { "operationid": "32", "operationtype": "0", "evaltype": "0", "opmessage": { "default_msg": "0", "subject": "Updated: {TRIGGER.NAME}", "message": "{USER.FULLNAME} updated problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} with the following message:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nCurrent problem status is {EVENT.STATUS}", "mediatypeid": "1" }, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage_usr": [] }, { "operationid": "33", "operationtype": "1", "evaltype": "0", "opcommand": { "scriptid": "3" }, "opcommand_hst": [ { "hostid": "10084" } ], "opcommand_grp": [] } ] } ], "id": 1 } ``` #### Отримати тригерні дії Отримати всі налаштовані тригерні дії разом із умовами дії та операціями. [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectRecoveryOperations": "extend", "selectUpdateOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 0 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "3", "name": "Report problems to Zabbix administrators", "eventsource": "0", "status": "1", "esc_period": "1h", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [], "eval_formula": "" }, "operations": [ { "operationid": "3", "actionid": "3", "operationtype": "0", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opmessage": [ { "default_msg": "1", "subject": "", "message": "", "mediatypeid" => "0" } ], "opmessage_grp": [ { "usrgrpid": "7" } ] } ], "recovery_operations": [ { "operationid": "7", "actionid": "3", "operationtype": "11", "evaltype": "0", "opconditions": [], "opmessage": { "default_msg": "0", "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}", "message": "Trigger: {TRIGGER.NAME}\r\nTrigger status: {TRIGGER.STATUS}\r\nTrigger severity: {TRIGGER.SEVERITY}\r\nTrigger URL: {TRIGGER.URL}\r\n\r\nItem values:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n\r\nOriginal event ID: {EVENT.ID}", "mediatypeid": "0" } } ], "update_operations": [ { "operationid": "31", "operationtype": "12", "evaltype": "0", "opmessage": { "default_msg": "1", "subject": "", "message": "", "mediatypeid": "0" } }, { "operationid": "32", "operationtype": "0", "evaltype": "0", "opmessage": { "default_msg": "0", "subject": "Updated: {TRIGGER.NAME}", "message": "{USER.FULLNAME} updated problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} with the following message:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nCurrent problem status is {EVENT.STATUS}", "mediatypeid": "1" }, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage_usr": [] }, { "operationid": "33", "operationtype": "1", "evaltype": "0", "opcommand": { "scriptid": "3" }, "opcommand_hst": [ { "hostid": "10084" } ], "opcommand_grp": [] } ] } ], "id": 1 } ``` #### Retrieving hosts Now you have a valid user authentication token that can be used to access the data in Zabbix. For example, you can use the [host.get](/manual/api/reference/host/get) method to retrieve the IDs, host names and interfaces of all the configured [hosts](/manual/api/reference/host/object): Request: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data @data.json ``` ::: notetip `data.json` is a file that contains a JSON query. Instead of a file, you can pass the query in the `--data` argument. ::: data.json ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": [ "hostid", "host" ], "selectInterfaces": [ "interfaceid", "ip" ] }, "id": 2 } ``` The response object will contain the requested data about the hosts: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "host": "Zabbix server", "interfaces": [ { "interfaceid": "1", "ip": "127.0.0.1" } ] } ], "id": 2 } ``` ::: notetip For performance reasons it is always recommended to list the object properties you want to retrieve. Thus, you will avoid retrieving everything. ::: #### Отримання хостів Тепер у вас є дійсний токен автентифікації користувача, який можна використовувати для доступу до даних у Zabbix. Наприклад, ви можете використовувати метод[host.get](/manual/api/reference/host/get) для отримання ідентифікаторів, імен хостів та інтерфейсів всіх налаштованих[хостів](/manual/api/reference/host/object): Запит: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data @data.json ``` ::: notetip `data.json` – це файл, який містить запит JSON. Замість файлу ви можете передати запит в аргументі `--data`. ::: data.json ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": [ "hostid", "host" ], "selectInterfaces": [ "interfaceid", "ip" ] }, "id": 2 } ``` Об'єкт відповіді буде містити запитувані дані про хости: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "host": "Zabbix server", "interfaces": [ { "interfaceid": "1", "ip": "127.0.0.1" } ] } ], "id": 2 } ``` ::: notetip З міркувань продуктивності завжди рекомендується перераховувати конкретні властивості об’єкта, які потрібно отримати. Таким чином, ви уникнете отримання одразу всіх властивостей. ::: ### Return values `(array)` Returns an array with changes in configuration, that will be made. ### Повернуті значення `(array)` Повертає масив зі змінами в конфігурації, які будуть внесені. ### Return values `(boolean )` Returns boolean true as result on successful update. ### Повернуті значення `(boolean )` Повертає логічне значення true як результат успішного оновлення. ### Return values `(boolean)` Returns `true` if importing has been successful. ### Повернуті значення `(boolean)` Повертає `true`, якщо імпортування було успішним. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори очищених елементів у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the created actions under the `actionids` property. The order of the returned IDs matches the order of the passed actions. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених дій у властивості `actionids`. Порядок повернених ідентифікаторів відповідає порядку виконаних дій. ### Return values `(object)` Returns an object containing the IDs of the created correlations under the `correlationids` property. The order of the returned IDs matches the order of the passed correlations. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених кореляцій у властивості `correlationids`. Порядок повернених ідентифікаторів відповідає порядку переданих кореляцій. ### Return values `(object)` Returns an object containing the IDs of the created dashboards under the `dashboardids` property. The order of the returned IDs matches the order of the passed dashboards. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інформаційних панелей у властивості `dashboardids`. Порядок повернених ідентифікаторів відповідає порядку переданих інформаційних панелей. ### Return values `(object)` Returns an object containing the IDs of the created discovery rules under the `druleids` property. The order of the returned IDs matches the order of the passed discovery rules. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених правил виявлення у властивості `druleids`. Порядок повернених ідентифікаторів відповідає порядку переданих правил виявлення. ### Return values `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених прототипів графів у властивості `graphids`. Порядок повернених ідентифікаторів відповідає порядку переданих прототипів графів. ### Return values `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених графіків у властивості `graphids`. Порядок повернених ідентифікаторів відповідає порядку переданих графіків. ### Return values `(object)` Returns an object containing the IDs of the created host groups under the `groupids` property. The order of the returned IDs matches the order of the passed host groups. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених груп хостів у властивості `groupids`. Порядок повернених ідентифікаторів відповідає порядку переданих груп хостів. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених хост-інтерфейсів у властивості `interfaceids`. Порядок повернених ідентифікаторів відповідає порядку переданих інтерфейсів хоста. ### Return values `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених прототипів хостів у властивості `hostids`. Порядок повернутих ідентифікаторів відповідає порядку переданих прототипів хосту. ### Return values `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених хостів у властивості `hostids`. Порядок повернених ідентифікаторів відповідає порядку переданих хостів. ### Return values `(object)` Returns an object containing the IDs of the created LLD rules under the `itemids` property. The order of the returned IDs matches the order of the passed LLD rules. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених правил LLD у властивості `itemids`. Порядок повернених ідентифікаторів відповідає порядку переданих правил LLD. ### Return values `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених веб-сценаріїв у властивості `httptestids`. Порядок повернених ідентифікаторів відповідає порядку переданих веб-сценаріїв. ### Return values `(object)` Returns an object containing the IDs of the deleted actions under the `actionids` property. ### Повернуті значення `(object)` повертає об’єкт, що містить ідентифікатори видалених дій у властивості `actionids`. ### Return values `(object)` Returns an object containing the IDs of the deleted correlations under the `correlationids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених кореляцій у властивості `correlationids`. ### Return values `(object)` Returns an object containing the IDs of the deleted dashboards under the `dashboardids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інформаційних панелей у властивості `dashboardids`. ### Return values `(object)` Returns an object containing the IDs of the deleted discovery rules under the `druleids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених правил виявлення у властивості `druleids`. ### Return values `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених прототипів графів у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених графіків у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the deleted items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених елементів даних у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the updated actions under the `actionids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених дій у властивості `actionids`. ### Return values `(object)` Returns an object containing the IDs of the updated correlations under the `correlationids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених кореляцій у властивості `correlationids`. ### Return values `(object)` Returns an object containing the IDs of the updated dashboards under the `dashboardids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених інформаційних панелей у властивості `dashboardids`. ### Return values `(object)` Returns an object containing the IDs of the updated discovery rules under the `druleids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених правил виявлення у властивості `druleids`. ### Return values `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених подій у властивості `eventids`. ### Return values `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених прототипів графів у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених графіків у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених елементів даних у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the updated LLD rules under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених правил LLD у властивості `itemids`. ### Return values `(object)` Returns authentication object. ### Повернуті значення `(object)` Повертає об'єкт автентифікації. ### Return values `(object)` Returns autoregistration object. ### Повернуті значення `(object)` Повертає об'єкт автореєстрації. ### Return values `(object)` Returns housekeeping object. ### Повернуті значення `(object)` Повертає об'єкт господарювання. ### Return values `(string)` Returns a serialized string containing the requested configuration data. ### Повернуті значення `(string)` Повертає серіалізований рядок, що містить запитувані дані конфігурації. ### Return values `(string)` Returns the version of the Zabbix API. ::: notetip Starting from Zabbix 2.0.4 the version of the API matches the version of Zabbix. ::: ### Повернуті значення `(string)` Повертає версію Zabbix API. ::: notetip Починаючи з Zabbix 2.0.4 версія API відповідає версії Zabbix. ::: ### Runtime control options **config\_cache\_reload** Reload configuration cache. Ignored if cache is being currently loaded. Active Zabbix proxy will connect to the Zabbix server and request configuration data. Default configuration file (unless **-c** option is specified) will be used to find PID file and signal will be sent to process, listed in PID file. **snmp\_cache\_reload** Reload SNMP cache. **housekeeper\_execute** Execute the housekeeper. Ignored if housekeeper is being currently executed. **diaginfo**\[=*section*\] Log internal diagnostic information of the specified section. Section can be *historycache*, *preprocessing*, *locks*. By default diagnostic information of all sections is logged. **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} ### Параметри runtime-option **config\_cache\_reload** Перезавантажити кеш конфігурації. Ігнорується, якщо зараз завантажується кеш. Активний проксі-сервер Zabbix підключатиметься до сервера Zabbix і запитуватиме конфігураційні дані. Файл конфігурації за замовчуванням (якщо не вказано параметр **-c**) використовуватиметься для пошуку файлу PID, а сигнал буде надіслано до процесу, зазначеного у файлі PID. **snmp\_cache\_reload** Перезавантажте кеш SNMP. **housekeeper\_execute** Стратити економку. Ігнорується, якщо зараз працює економка виконано. **diaginfo**\[=*section*\] Реєстрація внутрішньої діагностичної інформації вказаного розділу. Розділ може бути *historycache*, *preprocessing*, *locks*. За замовчуванням реєструється діагностична інформація всіх розділів. **log\_level\_increase**\[=*target*\] Підвищити рівень журналу, впливає на всі процеси, якщо ціль не вказано. **log\_level\_decrease**\[=*target*\] Зниження рівня журналу, впливає на всі процеси, якщо ціль не вказано. [ ]{#lbAG} #### Runtime control options: **userparameter_reload** Reload user parameters from the configuration file **log_level_increase** Increase log level **log_level_decrease** Decrease log level **help** List available runtime control options **metrics** List available metrics **version** Display version **-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. **-v**, **--verbose** Enable verbose output when test item or print known items. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} #### Параметри контролю виконання: **userparameter reload** Перезавантаження параметрів користувача з файлу конфігурації **loglevel increase** Підвищити рівень журналу **loglevel decrease** Зменшити рівень журналу **help** Список доступних параметрів керування часом виконання **metrics** Список доступних показників **version** Показати версію **-p**, **--print** Роздрукувати відомі елементи та вийти. Для кожного елемента використовуються або загальні параметри за замовчуванням, або надаються спеціальні параметри за замовчуванням для тестування. Ці значення за замовчуванням наведено в квадратних дужках як ключові параметри елемента. Повернуті значення береться в квадратні дужки та має префікс типу повернутого значення, розділених вертикальною рискою. Тип параметрів користувача завжди **t**, оскільки агент не може визначити всі можливі значення, що повертаються. Елементи, які відображаються як робочі, не гарантують роботу на сервері Zabbix або zabbix\_get під час запиту до запущеного демона агента, оскільки дозволи або середовище можуть відрізнятися. Типи повернених значень: d Число з десятковою частиною. m Не підтримується. Це може бути викликано запитом до елемента, який працює лише в активному режимі, як-от елемент моніторингу журналу, або елемент, який вимагає кількох зібраних значень. Проблеми з дозволом або неправильні параметри користувача також можуть призвести до непідтримуваного стану. s Текст. Максимальна довжина не обмежена. t Текст. Те саме, що **s**. u Ціле число без знака. \ **-t**, **--test** *item-key* Перевірити один предмет і вийти. Див. **--print** для опису результату. **-v**, **--verbose** Увімкнути докладний вивід під час тестування або друку відомих елементів. **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Вивести інформацію про версію та вийти. [ ]{#lbAG} ### #### Runtime control options **userparameter\_reload** Reload user parameters from the configuration file **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} ### #### Параметри керування виконанням (Runtime options) **userparameter\_reload** Перезавантаження параметрів користувача з файлу конфігурації **log\_level\_increase**\[=*target*\] Підвищити рівень журналу, впливає на всі процеси, якщо ціль не вказано **log\_level\_decrease**\[=*target*\] Зниження рівня журналу, впливає на всі процеси, якщо ціль не вказано [ ]{#lbAG} ##### RUNTIME CONTROL Runtime control options: **config\_cache\_reload** Reload configuration cache. Ignored if cache is being currently loaded. Default configuration file (unless **-c** option is specified) will be used to find PID file and signal will be sent to process, listed in PID file. **snmp\_cache\_reload** Reload SNMP cache, clear the SNMP properties (engine time, engine boots, engine id, credentials) for all hosts. **housekeeper\_execute** Execute the housekeeper. Ignored if housekeeper is being currently executed. **trigger_housekeeper\_execute** Execute the trigger housekeeper (remove problems for deleted triggers). Ignored if trigger housekeeper for services is being currently executed. **diaginfo**\[=*section*\] Log internal diagnostic information of the specified section. Section can be *historycache*, *preprocessing*, *alerting*, *lld*, *valuecache*, *locks*. By default diagnostic information of all sections is logged. **ha_status** Log high availability (HA) cluster status. ##### RUNTIME CONTROL Параметри керування виконанням **config\_cache\_reload** Перезавантажити кеш конфігурації. Ігнорується, якщо зараз завантажується кеш. Файл конфігурації за замовчуванням (якщо не вказано параметр **-c**) використовуватиметься для пошуку файлу PID, а сигнал буде надіслано до процесу, зазначеного у файлі PID. **snmp\_cache\_reload** Перезавантажте кеш SNMP, очистити властивості SNMP (engine time, engine boots, engine id, credentials) для всіхвузлів мережі. **housekeeper\_execute** Запустити housekeeper. Ігнорується, якщо зараз запущений housekeeper. **trigger_housekeeper\_execute** Запустити housekeeper для тригерів (усунути проблеми для видалених тригерів). Ігнорується, якщо наразі виконується housekeeper для тригерів. **diaginfo**\[=*section*\] Реєстрація внутрішньої діагностичної інформації вказаного розділу. Розділ може бути *historycache*, *preprocessing*, *alerting*, *lld*, *valuecache*, *locks*. За замовчуванням реєструється діагностична інформація всіх розділів. **ha_status** Журнал стану кластера високої доступності (HA). #### Scenario #### Сценарій #### Scripts Configure and execute scripts to help you with your daily tasks. [Script API](/manual/api/reference/script) #### Скрипти Налаштування та виконання сценаріїв, які допоможуть вам виконувати щоденні завдання. [API скриптів](/manual/api/reference/script) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) - [Script](/manual/api/reference/script/object) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Audit log object](/manual/api/reference/auditlog/object) ### Дивись також - [Об'єкт журналу аудиту](/manual/api/reference/auditlog/object) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) - [Host](/manual/api/reference/host/object#host) ### Дивись також - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) - [Хост](/manual/api/reference/host/object#host) ### See also - [Discovered service](/manual/api/reference/dservice/object#discovered_service) - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) ### Дивись також - [Виявлена служба](/manual/api/reference/dservice/object#discovered_service) - [Правило виявлення](/manual/api/reference/drule/object#discovery_rule) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) ------------------------------------------------------------------------ [ ]{#index} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) -------------------------------------------------- ---------------------- [ ]{#index} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### Дивись також - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### Дивись також - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph](/manual/api/reference/graph/object#graph) ### Дивись також - [Графік](/manual/api/reference/graph/object#graph) ### See also - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Host](/manual/api/reference/host/object#host) - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) - [LLD rule filter](object#lld_rule_filter) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### Дивись також - [Прототип графіка](/manual/api/reference/graphprototype/object#graph_prototype) - [Хост](/manual/api/reference/host/object#host) - [Прототип елемента](/manual/api/reference/itemprototype/object#item_prototype) - [Фільтр правил LLD](object#lld_rule_filter) - [Прототип тригера](/manual/api/reference/triggerprototype/object#trigger_prototype) ### See also - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### Дивись також - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### See also - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### Дивись також - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### Дивись також - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### See also - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### Дивись також - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Елемент](/manual/api/reference/item/object#item) ### See also - [Host](/manual/api/reference/host/object#host) - [Media type](/manual/api/reference/mediatype/object#media_type) - [User](/manual/api/reference/user/object#user) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Тип медіа](/manual/api/reference/mediatype/object#media_type) - [Користувач](/manual/api/reference/user/object#user) ### See also - [host.update](update) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### Дивись також - [host.update](оновити) - [Група хостів](/manual/api/reference/hostgroup/object#host_group) - [Шаблон](/manual/api/reference/template/object#template) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) ### See also - [host.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### Дивись також - [host.update](оновити) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) ### See also - [LLD rule filter](object#lld_rule_filter) - [LLD macro paths](object#lld_macro_path) - [LLD rule preprocessing](object#lld_rule_preprocessing) ### Дивись також - [Фільтр правил LLD](object#lld_rule_filter) - [Шляхи макросу LLD](object#lld_macro_path) - [Попередня обробка правила LLD](object#lld_rule_preprocessing) ### See also - [Scenario step](object#scenario_step) ### Дивись також - [Крок сценарію](object#scenario_step) ### See also - [Scenario step](object#scenario_step) ### Дивись також - [Крок сценарію](object#scenario_step) #### Service Level Agreement Define Service Level Objectives (SLO), retrieve detailed Service Level Indicators (SLI) information about service performance. [SLA API](/manual/api/reference/sla) #### Угода про рівень обслуговування Визначення цілей рівня обслуговування (SLO), отримання детальних індикаторів рівня обслуговування (SLI) продуктивністі сервісу. [SLA API](/manual/api/reference/sla) #### Services Manage services for service-level monitoring and retrieve detailed SLA information about any service. [Service API](/manual/api/reference/service) #### Сервіси Керуйте сервісами для моніторингу рівня обслуговування та отримуйте детальну інформацію про SLA будь-якого сервісу. [API сервісу](/manual/api/reference/service) ## Services The Zabbix API allows you to access data gathered during service monitoring. ## Сервіси Zabbix API дозволяє отримати доступ до зібраних даних під час моніторингу сервісу. #### Slideshow It is possible to activate a slideshow in the dashboard: - `/zabbix.php?action=dashboard.view&slideshow=1` - activate slideshow #### Слайд-шоу Слайд-шоу можна активувати на інформаційній панелі: - `/zabbix.php?action=dashboard.view&slideshow=1` - активувати показ слайдів ### Source CAction::create() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::create() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::delete() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::delete() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::get() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::get() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::update() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::update() у *ui/include/classes/api/services/CAction.php*. ### Source CAlert::get() in *ui/include/classes/api/services/CAlert.php*. ### Джерело CAlert::get() у *ui/include/classes/api/services/CAlert.php*. ### Source CAPIInfo::version() in *ui/include/classes/api/services/CAPIInfo.php*. ### Джерело CAPIInfo::version() у *ui/include/classes/api/services/CAPIInfo.php*. ### Source CAuditLog::get() in *ui/include/classes/api/services/CAuditLog.php*. ### Джерело CAuditLog::get() у *ui/include/classes/api/services/CAuditLog.php*. ### Source CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### Джерело CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### Source CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### Джерело CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### Source CConfiguration::export() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::export() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::importcompare() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CConfiguration::import() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::import() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CCorrelation::create() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::create() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::delete() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::delete() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::get() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::update() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::update() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::create() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::delete() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::get() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::update() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### Джерело CDCheck::get() в *ui/include/classes/api/services/CDCheck.php*. ### Source CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Джерело CDHost::get() в *ui/include/classes/api/services/CDHost.php*. ### Source CDiscoveryRule::create() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::create() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::delete() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::delete() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::get() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::get() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::update() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::update() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::create() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::delete() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::get() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::update() в *ui/include/classes/api/services/CDRule.php*. ### Source CDService::get() in *ui/include/classes/api/services/CDService.php*. ### Джерело CDService::get() в*ui/include/classes/api/services/CDService.php*. ### Source CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### Джерело CEvent::acknowledge() в *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### Джерело CEvent::get() в *ui/include/classes/api/services/CEvent.php*. ### Source CGraph::create() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::create() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::delete() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::get() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### Джерело CGraphItem::get() у *ui/include/classes/api/services/CGraphItem.php*. ### Source CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::create() в *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::delete() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::get() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::update() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::update() у *ui/include/classes/api/services/CGraph.php*. ### Source CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### Джерело CHaNode::get() у *ui/include/classes/api/services/CHaNode.php*. ### Source CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### Джерело CHistory::clear() у *ui/include/classes/api/services/CHistory.php*. ### Source CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ### Джерело CHistory::get() у *ui/include/classes/api/services/CHistory.php*. ### Source CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::create() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::delete() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::delete() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::get() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::get() в *ui/include/classes/api/services/CHost.php*. ### Source CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::create() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::delete() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::delete() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::get() у *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massAdd() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massRemove() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massUpdate() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::update() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::create() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::delete() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::get() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::massAdd() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::massRemove() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::replaceHostInterfaces() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::update() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massAdd() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massRemove() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massUpdate() в *ui/include/classes/api/services/CHost.php*. ### Source CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::create() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::delete() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::get() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::update() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHost::update() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::update() в *ui/include/classes/api/services/CHost.php*. ### Source CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Джерело CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Джерело CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::delete() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::get() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::update() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CIconMap::create() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::create() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::delete() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::get() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::get() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::update() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::update() в *ui/include/classes/api/services/CIconMap.php*. ### Source CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::create() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::delete() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::delete() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::get() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::get() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::update() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::update() в *ui/include/classes/api/services/CImage.php*. ### Source CItem::create() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::create() в *ui/include/classes/api/services/CItem.php*. ### Source CItem::delete() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::delete() в *ui/include/classes/api/services/CItem.php*. ### Source CItem::get() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::get() в *ui/include/classes/api/services/CItem.php*. ### Source CItemPrototype::create() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::create() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::delete() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::delete() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::get() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::get() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::update() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::update() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItem::update() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::update() в *ui/include/classes/api/services/CItem.php*. ### Source CMaintenance::create() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::create() в *ui/include/classes/api/services/CMaintenance.php*. ### Source CMaintenance::delete() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::delete() в *ui/include/classes/api/services/CMaintenance.php*. #### SQLite Using SQLite is supported for **Zabbix proxy** only! The database will be automatically created if it does not exist. Return to the [installation section](/manual/installation/install). #### SQLite Використання SQLite підтримується лише для **Zabbix proxy**! База даних буде створена автоматично, якщо вона не існує. Поверніться до [розділу встановлення](/manual/installation/install). ##### Step 1 Install Kerberos package. For Debian/Ubuntu: apt install krb5-user For RHEL: dnf install krb5-workstation ##### Крок 1 Встановіть пакет Kerberos. Для Debian/Ubuntu: apt install krb5-user Для RHEL: dnf install krb5-workstation ##### Step 1 To define your own theme you'll need to create a CSS file and save it in the `assets/styles/` folder (for example, *custom-theme.css*). You can either copy the files from a different theme and create your theme based on it or start from scratch. ##### Крок 1 Щоб визначити власну тему, вам потрібно створити файл CSS і зберегти його в папці `assets/styles/` (наприклад, *custom-theme.css*). Ви можете або скопіювати файли з іншої теми та створити свою тему на її основі, або почати з нуля. ##### Step 2 Add your theme to the list of themes returned by the APP::getThemes() method. You can do this by overriding the ZBase::getThemes() method in the APP class. This can be done by adding the following code before the closing brace in *include/classes/core/APP.php*: public static function getThemes() { return array_merge(parent::getThemes(), [ 'custom-theme' => _('Custom theme') ]); } ::: noteimportant Note that the name you specify within the first pair of quotes must match the name of the theme file without extension. ::: To add multiple themes, just list them under the first theme, for example: public static function getThemes() { return array_merge(parent::getThemes(), [ 'custom-theme' => _('Custom theme'), 'anothertheme' => _('Another theme'), 'onemoretheme' => _('One more theme') ]); } Note that every theme except the last one must have a trailing comma. ::: notetip To change graph colors, the entry must be added in the *graph\_theme* database table. ::: ##### Крок 2 Додайте свою тему до списку тем, які повертає метод APP::getThemes(). Це можна зробити, перевизначивши метод ZBase::getThemes() у класі APP. Це можна зробити, додавши такий код перед закриваючою дужкою в *include/classes/core/APP.php*: · public static function getThemes() { · return array_merge(parent::getThemes(), [ · 'custom-theme' => _('Custom theme') · ]); · } ::: noteimportant Зауважте, що назва, яку ви вказуєте в першій парі лапок, має збігатися з назвою файлу теми без розширення. ::: Щоб додати кілька тем, просто перелічіть їх під першою темою, наприклад: · public static function getThemes() { · return array_merge(parent::getThemes(), [ · 'custom-theme' => _('Custom theme'), · 'anothertheme' => _('Another theme'), · 'onemoretheme' => _('One more theme') · ]); · } Зауважте, що кожна тема, крім останньої, повинна мати кінцеву кому. ::: підказка Щоб змінити кольори графіка, потрібно додати запис у таблицю бази даних *graph\_theme*. ::: ##### Step 2 Configure Kerberos configuration file (see MIT documentation for details) ``` {.java} cat /etc/krb5.conf [libdefaults] default_realm = EXAMPLE.COM # The following krb5.conf variables are only for MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` ##### Крок 2 Налаштувати файл конфігурації Kerberos (докладніше див. у документації MIT) ``` {.java} cat /etc/krb5.conf [libdefaults] default_realm = EXAMPLE.COM # The following krb5.conf variables are only for MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` ##### Step 3 Activate the new theme. In Zabbix frontend, you may either set this theme to be the default one or change your theme in the user profile. Enjoy the new look and feel! ##### Крок 3 Активуйте нову тему. У інтерфейсі Zabbix ви можете або встановити цю тему як тему за замовчуванням, або змінити свою тему в профілі користувача. Насолоджуйтесь новим зовнішнім виглядом! ##### Step 3 Create a Kerberos ticket for user *zabbix*. Run the following command as user *zabbix*: kinit zabbix ::: noteimportant It is important to run the above command as user *zabbix*. If you run it as *root* the authentication will not work. ::: ##### Крок 3 Створіть квиток Kerberos для користувача *zabbix*. Виконайте наступну команду від імені користувача *zabbix*: kinit zabbix ::: noteimportant Важливо виконати наведену вище команду як користувач *zabbix*. Якщо ви запустите його як *root*, автентифікація не працюватиме. ::: ##### Step 4 Create a web scenario or HTTP agent item with Kerberos authentication type. Optionally can be tested with the following curl command: curl -v --negotiate -u : http://example.com Note that for lengthy web monitoring it is necessary to take care of renewing the Kerberos ticket. Default time of ticket expiration is 10h. ##### Крок 4 Створіть веб-сценарій або елемент HTTP-агента з типом автентифікації Kerberos. Додатково можна перевірити за допомогою такої команди curl: curl -v --negotiate -u : http://example.com Зверніть увагу, що для тривалого веб-моніторингу необхідно подбати про оновлення квитка Kerberos. За замовчуванням термін дії квитка становить 10 годин. ### Structure The API consists of a number of methods that are nominally grouped into separate APIs. Each of the methods performs one specific task. For example, the `host.create` method belongs to the *host* API and is used to create new hosts. Historically, APIs are sometimes referred to as "classes". ::: notetip Most APIs contain at least four methods: `get`, `create`, `update` and `delete` for retrieving, creating, updating and deleting data respectively, but some APIs may provide a totally different set of methods. ::: ### Структура API складається з кількох методів, номінально згрупованих у окремі API. Кожен із методів виконує одну певну задачу. Наприклад, метод `host.create` належить до API *host* і використовується для створення нових хостів. Історично так склалось, що API іноді називають "класами". ::: notetip Більшість API містять принаймні чотири методи: `get`, `create`, `update` і `delete` для отримання, створення, оновлення та видалення даних відповідно, але деякі API можуть надавати повністю різний набір методів. ::: #### Structure The content of this manual is divided into sections and subsections to provide easy access to particular subjects of interest. When you navigate to respective sections, make sure that you expand section folders to reveal full content of what is included in subsections and individual pages. Cross-linking between pages of related content is provided as much as possible to make sure that relevant information is not missed by the users. #### Структура Зміст цього посібника поділено на розділи та підрозділи для того, щоб забезпечити легкий доступ до певних тем, які вас цікавлять. Коли ви переходите до відповідних розділів, переконайтеся, що ви розгорнули папки розділів, щоб побачити повний зміст того, що міститься в підрозділах та окремих сторінках. Перехресні посилання між сторінками пов'язаного контенту надаються настільки, наскільки це можливо, для того, щоб переконатися, що відповідна інформація не буде пропущена користувачами. ## SYNOPSIS **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2** \[**-c** *config-file*\] **-T**\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## СИНТАКСИС **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2** \[**-c** *config-file*\] **-T**\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## SYNOPSIS **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd** \[**-c** *config-file*\] **-T**\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd** \[**-c** *config-file*\] **-T**\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *номер-порту*\] \[**-I** *IP-адреса*\] \[**-t** *тайм-аут*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *номер порту*\] \[**-I** *IP-адреса*\] \[**-t** *час очікування*\] **--tls-connect** **cert** **--tls-ca-файл** *CA-файл* \[**--tls-crl-файл** *CRL-файл*\] \[**--tls-agent-cert-issuer** *сертифікат-емітент*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *файл-сертифіката* **--tls-key-file** *key-file* \[**--tls-cipher13** *шифр-рядок*\] \[**--tls-cipher** *шифр-рядок*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *port-number*\] \[**-I** *IP-адреса*\] \[**-t** *час очікування*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-ідентифікація* **--tls-psk-файл** *PSK-файл* \[**--tls-cipher13** *шифр-рядок*\] \[**--tls-cipher** *шифр-рядок*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_proxy** \[**-c** *config-file*\]\ **zabbix\_proxy** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_proxy** \[**-c** *config-file*\] **-T**\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_proxy** \[**-c** *конфігураційний файл*\]\ **zabbix\_proxy** \[**-c** *конфігураційний файл*\] **-R** *параметр виконання*\ **zabbix\_proxy** \[**-c** *config-file*\] **-T**\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server** \[**-c** *config-file*\] **-T**\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server** \[**-c** *config-file*\] **-T**\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service** \[**-c** *config-file*\] **-T**\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service** \[**-c** *config-file*\] **-T**\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} #### Tasks Interact with Zabbix server task manager, creating tasks and retrieving response. [Task API](/manual/api/reference/task) #### Завдання Взаємодійте з диспетчером завдань сервера Zabbix, створюючи та отримуючи відповідь. [API завдання](/manual/api/reference/task) #### Templates and template groups Manage templates and link them to hosts or other templates. [Template API](/manual/api/reference/template) | [Template group API](/manual/api/reference/templategroup) | [Value map API](/manual/api/reference/valuemap) #### Шаблони та групи шаблонів Керування шаблонами та приєднання їх до хостів чи інших шаблонів. [API шаблону](/manual/api/reference/template) | [API групи шаблонів](/manual/api/reference/templategroup) | [API конвертованихзначень](/manual/api/reference/valuemap) The ***getUpdateRequestData()*** method prepares the server request data for updating the widget by gathering various properties and their corresponding values (widget identifiers, filter settings, time ranges, etc.) from the widget's state and configuration, and constructing a data object that represents the necessary information to be sent to the server in the update request. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js getUpdateRequestData() { return { templateid: this._dashboard.templateid ?? undefined, dashboardid: this._dashboard.dashboardid ?? undefined, widgetid: this._widgetid ?? undefined, name: this._name !== '' ? this._name : undefined, fields: Object.keys(this._fields).length > 0 ? this._fields : undefined, view_mode: this._view_mode, edit_mode: this._is_edit_mode ? 1 : 0, dynamic_hostid: this._dashboard.templateid !== null || this.supportsDynamicHosts() ? (this._dynamic_hostid ?? undefined) : undefined, ...this._contents_size }; } ``` Метод ***getUpdateRequestData()*** готує дані для запиту на оновлення віджета, збираючи різні властивості та відповідні їм значення (ідентифікатори віджета, налаштування фільтрів, часові діапазони тощо) зі стану та конфігурації віджета і створюючи об'єкт даних, який представляє необхідну інформацію, що надсилається на сервер у запиті на оновлення. Цей метод викликається лише як частина методу за замовчуванням *promiseUpdate()*, тобто під час процесу оновлення віджета. Реалізація за замовчуванням: ```js getUpdateRequestData() { return { templateid: this._dashboard.templateid ?? undefined, dashboardid: this._dashboard.dashboardid ?? undefined, widgetid: this._widgetid ?? undefined, name: this._name !== '' ? this._name : undefined, fields: Object.keys(this._fields).length > 0 ? this._fields : undefined, view_mode: this._view_mode, edit_mode: this._is_edit_mode ? 1 : 0, dynamic_hostid: this._dashboard.templateid !== null || this.supportsDynamicHosts() ? (this._dynamic_hostid ?? undefined) : undefined, ...this._content_size }; } ``` The ***hasPadding()*** method is responsible for applying an 8px vertical padding at the bottom of the widget when it is configured to [show its header](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters). This method is invoked when the dashboard page is activated, that is, when it becomes the displayed page in the user interface. Default implementation: ```js hasPadding() { return this.getViewMode() !== ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER; } ``` For some widgets it is necessary to use all of the available widget space to configure, for example, a custom background color. The following is an example of the implementation of the *hasPadding()* method used in the Zabbix-native [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value) widget. ```js hasPadding() { return false; } ``` Метод ***hasPadding()*** відповідає за застосування вертикального відступу 8px внизу віджета, коли він налаштований на [відображення його заголовку](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters). Цей метод викликається, коли сторінка дашборда активована, тобто коли вона стає сторінкою, що відображається в інтерфейсі користувача. Реалізація за замовчуванням: ```js hasPadding() { return this.getViewMode() !== ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER; } ``` Для деяких віджетів необхідно використовувати весь доступний простір віджету, щоб налаштувати, наприклад, користувацький колір фону. Нижче наведено приклад реалізації методу *hasPadding()*, який використовується у віджеті [*Значення елементу даних*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value), що є нативним для Zabbix. ```js hasPadding() { return false; } ``` The ***onActivate()*** method makes the widget active and interactive by enabling custom event listeners (for responding to user actions) and initiating the widget update cycle (for keeping its content up-to-date). This method is invoked when the dashboard page is activated, that is, when it becomes fully displayed in the user interface. Note that before the *onActivate()* method is invoked, the widget is in the inactive state (`WIDGET_STATE_INACTIVE`). After successful invocation, the widget transitions to the active state (`WIDGET_STATE_ACTIVE`). In the active state, the widget is responsive, listens to events, updates its content periodically, and can interact with other widgets. Example: ```js onActivate() { this._startClock(); this._resize_observer = new ResizeObserver(this._events.resize); this._resize_observer.observe(this._target); } ``` Метод ****onActivate()*** робить віджет активним та інтерактивним, вмикаючи користувацькі listener-и подій (для реагування на дії користувача) та ініціюючи цикл оновлення віджета (для підтримання його вмісту в актуальному стані). Цей метод викликається, коли сторінка дашборду активована, тобто коли вона стає повністю відображеною в інтерфейсі користувача. Зверніть увагу, що до виклику методу *onActivate()* віджет знаходиться в неактивному стані (`WIDGET_STATE_INACTIVE`). Після успішного виклику віджет переходить в активний стан (`WIDGET_STATE_ACTIVE`). В активному стані віджет реагує на події, періодично оновлює свій вміст і може взаємодіяти з іншими віджетами. приклад: ```js onActivate() { this._startClock(); this._resize_observer = new ResizeObserver(this._events.resize); this._resize_observer.observe(this._target); } ``` The ***onDeactivate()*** method stops any activity and interactivity of the widget by deactivating custom event listeners and stopping the widget update cycle. This method is invoked when the dashboard page is deactivated, that is, switched away or deleted, or when the widget is deleted from the dashboard page. Note that before the *onDeactivate()* method is invoked, the widget is in the active state (`WIDGET_STATE_ACTIVE`). After successful invocation, the widget transitions to the inactive state (`WIDGET_STATE_INACTIVE`). Example: ```js onDeactivate() { this._stopClock(); this._resize_observer.disconnect(); } ``` Метод ***onDeactivate()*** зупиняє будь-яку активність та інтерактивність віджета, деактивуючи користувацькі listener-и подій та зупиняючи цикл оновлення віджета. Цей метод викликається, коли сторінка інформаційної панелі деактивована, тобто переключена або видалена, або коли віджет видалено зі сторінки інформаційної панелі. Зверніть увагу, що до виклику методу *onDeactivate()* віджет знаходиться в активному стані (`WIDGET_STATE_ACTIVE`), після успішного виклику віджет переходить в неактивний стан (`WIDGET_STATE_INACTIVE`). приклад: ```js onDeactivate() { this._stopClock(); this._resize_observer.disconnect(); } ``` The ***onDestroy()*** method performs cleanup tasks before the widget is deleted from the dashboard, which can include closing a database connection that was established during widget initialization, cleaning up temporary data to free up system memory and avoid resource leaks, unregistering event listeners related to resize events or button clicks to prevent unnecessary event handling and memory leaks, etc. This method is invoked when the widget or the dashboard page that contains it is deleted. Note that before the *onDestroy()* method is invoked, a widget in an active state (`WIDGET_STATE_ACTIVE`) is always deactivated with the invocation of the *onDeactivate()* method. Example: ```js onDestroy() { if (this._filter_widget) { this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_MARK, this._events.mark); this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_SELECT, this._events.select); } } ``` Метод ***onDestroy()*** виконує завдання очищення перед видаленням віджета з панелі інструментів, які можуть включати закриття з'єднання з базою даних, яке було встановлено під час ініціалізації віджета, очищення тимчасових даних, щоб звільнити системну пам'ять і уникнути витоку ресурсів, скасування реєстрації listener-ів подій, пов'язаних зі зміною розміру або натисканням кнопок, щоб запобігти непотрібній обробці подій і витоку пам'яті тощо. Цей метод викликається, коли видаляється віджет або сторінка інформаційної панелі, яка його містить. Зверніть увагу, що перед викликом методу *onDestroy()* віджет в активному стані (`WIDGET_STATE_ACTIVE`) завжди деактивується викликом методу *onDeactivate()*. приклад: ```js onDestroy() { if (this._filter_widget) { this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_MARK, this._events.mark); this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_SELECT, this._events.select); } } ``` The ***onEdit()*** method defines the appearance and behavior of the widget when the dashboard transitions into editing mode. This method is invoked when the dashboard transitions into editing mode, typically when a user interacts with the widget's *Edit* button or the dashboard's *Edit dashboard* button. Example: ```js onEdit() { this._deactivateGraph(); } ``` Метод **onEdit()*** визначає зовнішній вигляд і поведінку віджета, коли інформаційна панель переходить у режим редагування. Цей метод викликається, коли інформаційна панель переходить у режим редагування, зазвичай, коли користувач взаємодіє з кнопкою *Редагувати* віджета або кнопкою *Редагувати інформаційну панель* на інформаційній панелі. приклад: ```js onEdit() { this._deactivateGraph(); } ``` The ***onInitialize()*** method defines the initial state and/or values of the widget, without performing any HTML or data manipulation. This method is invoked when a widget is created (a widget object is instantiated), typically by adding the widget to a dashboard page or loading the dashboard page. Example: ```js onInitialize() { this._time_offset = 0; this._interval_id = null; this._clock_type = CWidgetClock.TYPE_ANALOG; this._time_zone = null; this._show_seconds = true; this._time_format = 0; this._tzone_format = 0; this._show = []; this._has_contents = false; this._is_enabled = true; } ``` Метод ***onInitialize()*** визначає початковий стан та/або значення віджета, не виконуючи жодних маніпуляцій з HTML або даними. Цей метод викликається при створенні віджета (екземплярі об'єкта віджета), як правило, шляхом додавання віджета на сторінку інформаційної панелі або завантаження сторінки інформаційної панелі. приклад: ```js onInitialize() { this._time_offset = 0; this._interval_id = null; this._clock_type = CWidgetClock.TYPE_ANALOG; this._time_zone = null; this._show_seconds = true; this._time_format = 0; this._tzone_format = 0; this._show = []; this._has_contents = false; this._is_enabled = true; } ``` The ***onResize()*** method is responsible for adjusting widget's visual elements to accommodate the new widget size, which can include rearranging elements, adjusting element dimensions, text truncation, implementing lazy loading to improve responsiveness during resizing, etc. This method is invoked when the widget is resized, for example, when the user manually resizes the widget or when the browser window is resized. Example: ```js onResize() { if (this.getState() === WIDGET_STATE_ACTIVE) { this._startUpdating(); } } ``` Метод ***onResize()*** відповідає за адаптацію візуальних елементів віджета до нового розміру віджета, яка може включати перестановку елементів, регулювання розмірів елементів, усічення тексту, реалізацію лінивого завантаження для поліпшення відгуку при зміні розміру і т.д. Цей метод викликається при зміні розміру віджета, наприклад, коли користувач вручну змінює розмір віджета або коли змінюється розмір вікна браузера. Приклад: ```js onResize() { if (this.getState() === WIDGET_STATE_ACTIVE) { this._startUpdating(); } } ``` The ***onStart()*** method defines the HTML structure of the widget, without performing any data manipulation. This method is invoked before the first activation of the dashboard page, that is, before the dashboard and its widgets are fully displayed to the user. Example: ```js onStart() { this._events.resize = () => { const padding = 25; const header_height = this._view_mode === ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER ? 0 : this._header.offsetHeight; this._target.style.setProperty( '--content-height', `${this._cell_height * this._pos.height - padding * 2 - header_height}px` ); } } ``` Метод ***onStart()*** визначає HTML-структуру віджета, не виконуючи жодних маніпуляцій з даними. Цей метод викликається перед першою активацією сторінки дашборду, тобто перед тим, як дашборд та його віджети будуть повністю відображені користувачеві. приклад: ```js onStart() { this._events.resize = () => { const padding = 25; const header_height = this._view_mode == ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER ? 0 : this._header.offsetHeight; this._target.style.setProperty( '--content-height', `${this._cell_height * this._pos.height - padding * 2 - header_height}px` ); } } ``` The ***processUpdateErrorResponse(error)*** method handles the response received from the server after the update request if the response is an error, and displays the error message/-s. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js processUpdateErrorResponse(error) { this._updateMessages(error.messages, error.title); } ``` Метод ***processUpdateErrorResponse(error)*** обробляє відповідь, отриману від сервера після запиту на оновлення, якщо відповідь є помилковою, і виводить повідомлення про помилку. Цей метод викликається тільки як частина стандартного методу *promiseUpdate()*, тобто під час процесу оновлення віджету. Реалізація за замовчуванням: ```js processUpdateErrorResponse(error) { this._updateMessages(error.messages, error.title); } ``` The ***processUpdateResponse(response)*** method handles the response received from the server after the update request, and, if the update process has been successful and without errors, clears widget data and displays new contents with the *setContents()* method. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js processUpdateResponse(response) { this._setHeaderName(response.name); this._updateMessages(response.messages); this._updateInfo(response.info); this._updateDebug(response.debug); this.setContents(response); } ``` Метод ***processUpdateResponse(response)*** обробляє відповідь, отриману від сервера після запиту на оновлення, і, якщо процес оновлення пройшов успішно і без помилок, очищає дані віджета і відображає новий вміст методом *setContents()*. Цей метод викликається тільки в складі методу за замовчуванням *promiseUpdate()*, тобто під час процесу оновлення віджета. Реалізація за замовчуванням: ```js processUpdateResponse(response) { this._setHeaderName(response.name); this._updateMessages(response.messages); this._updateInfo(response.info); this._updateDebug(response.debug); this.setContents(response); } ``` The ***promiseUpdate()*** method initiates the data update process by retrieving data, typically using web requests or API calls. This method is invoked when a dashboard page is displayed and periodically after, until the dashboard page is switched to another dashboard page. The following is an example of the default implementation of the *promiseUpdate()* method used by most Zabbix-native widgets. In the default implementation, the *promiseUpdate()* method follows a general pattern for retrieving data from the server. It creates a new `Curl` object with the appropriate URL and request parameters, sends a `POST` request using the *fetch()* method with the data object constructed by the *getUpdateRequestData()* method, and processes the response (or an error response) with the *processUpdateResponse(response)* or *processUpdateErrorResponse(error)* accordingly. This implementation is suitable for most widgets as they typically retrieve data in a JSON format and handle it in a consistent manner. ```js promiseUpdate() { const curl = new Curl('zabbix.php'); curl.setArgument('action', `widget.${this._type}.view`); return fetch(curl.getUrl(), { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(this.getUpdateRequestData()), signal: this._update_abort_controller.signal }) .then((response) => response.json()) .then((response) => { if ('error' in response) { this.processUpdateErrorResponse(response.error); return; } this.processUpdateResponse(response); }); } ``` Метод ***promiseUpdate()*** ініціює процес оновлення даних шляхом отримання даних, як правило, за допомогою веб-запитів або викликів API. Цей метод викликається під час відображення сторінки дашборду і періодично після цього, поки сторінка дашборду не буде переключена на іншу сторінку дашборду. Нижче наведено приклад реалізації за замовчуванням методу *promiseUpdate()*, який використовується більшістю власних віджетів Zabbix. У стандартній реалізації метод *promiseUpdate()* відповідає загальному шаблону для отримання даних із сервера. Він створює новий об'єкт `Curl` з відповідним URL і параметрами запиту, відправляє запит `POST` методом *fetch()* з об'єктом даних, побудованим методом *getUpdateRequestData()*, і обробляє відповідь (або повідомлення про помилку) за допомогою *processUpdateResponse(response)* або *processUpdateErrorResponse(error)* відповідно. Ця реалізація підходить для більшості віджетів, оскільки вони зазвичай отримують дані у форматі JSON і обробляють їх у незмінний спосіб. ```js promiseUpdate() { const curl = new Curl('zabbix.php'); curl.setArgument('action', `widget.${this._type}.view`); return fetch(curl.getUrl(), { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(this.getUpdateRequestData()), signal: this._update_abort_controller.signal }) .then((response) => response.json()) .then((response) => { if ('error' in response) { this.processUpdateErrorResponse(response.error); return; } this.processUpdateResponse(response); }); } ``` The ***setContents(response)*** method displays widget contents if the widget update process has been successful and without errors, which can include manipulating DOM elements, updating UI components, applying styles or formatting, etc. This method is invoked only as part of the default *processUpdateResponse(response)* method, that is, during the process of handling the response received from the server after the update request. Default implementation: ```js setContents(response) { this._body.innerHTML = response.body ?? ''; } ``` Метод ***setContents(response)*** відображає вміст віджету, якщо процес оновлення віджету пройшов успішно і без помилок, які можуть включати маніпуляції з DOM-елементами, оновлення компонентів інтерфейсу, застосування стилів або форматування і т.д. Цей метод викликається тільки в складі стандартного методу *processUpdateResponse(response)*, тобто в процесі обробки відповіді, отриманої від сервера після запиту оновлення. Реалізація за замовчуванням: ```js setContents(response) { this._body.innerHTML = response.body ?? ''; } ``` This is a step-by-step tutorial that shows how to create a simple dashboard widget. You can download all files of this widget as a ZIP archive: [lesson_gauge_chart.zip](../../../../assets/en/devel/modules/examples/lesson_gauge_chart.zip). Це покрокова інструкція, яка показує, як створити простий віджет інформаційної панелі. ::: noteimportant Мінімальна необхідна версія Zabbix для цієї інструкції – 6.4.4. ::: Ви можете завантажити всі файли цього віджета як ZIP-архів: [lesson_gauge_chart.zip](../../../../assets/en/devel/modules/examples/lesson_gauge_chart.zip). This is a step-by-step tutorial that shows how to create a simple Zabbix frontend module. You can download all files of this module as a ZIP archive: [MyAddress.zip](../../../../assets/en/devel/modules/examples/MyAddress.zip). Це покрокова інструкція, яка показує, як створити простий модуль фронтенду Zabbix. Ви можете завантажити всі файли цього модуля у вигляді ZIP-архіву: [MyAddress.zip](../../../../assets/en/devel/modules/examples/MyAddress.zip). This is a step-by-step tutorial to create a simple loadable plugin for Zabbix agent 2. ::: notetip Feel free to use our [example repository](https://git.zabbix.com/projects/AP/repos/example/browse) as a template or guide for creating your own plugins. ::: Це покрокова інструкція зі створення простого завантажуваного плагіна для Zabbix agent 2. ::: notetip Не соромтеся використовувати наш [репозиторій прикладів](https://git.zabbix.com/projects/AP/repos/example/browse) як шаблон або посібник для створення власних плагінів. ::: # This topic does not exist yet. We are sorry, the page you are looking for cannot be found. Return to the homepage, try searching, or get [help](https://www.zabbix.com/support). # Цей розділ ще не створено. Нажаль, сторінка яку ви шукаєте не знайдена. Поверніться до домашньої сторінки, спробуйте пошук або отримайте [допомогу](https://www.zabbix.com/support). #### TimescaleDB Instructions for creating and configuring TimescaleDB are provided in a separate [section](/manual/appendix/install/timescaledb). #### TimescaleDB Інструкції щодо створення та налаштування TimescaleDB наведено в окремому [розділі](/manual/appendix/install/timescaledb). #### Trends Retrieve trend values calculated by Zabbix server for presentation or further processing. [Trend API](/manual/api/reference/trend) #### Тренди Отримати значення трендів, обчислені сервером Zabbix для презентації або подальшої обробки. [API Трендів](/manual/api/reference/trend) #### Triggers Configure triggers to notify you about problems in your system. Manage trigger dependencies. [Trigger API](/manual/api/reference/trigger) #### Тригери Налаштування тригерів для сповіщення про проблеми у вашій системі. Керування залежностями тригерів. [API тригера](/manual/api/reference/trigger) # Tutorials This section contains practical step-by-step tutorials to illustrate how to build a custom [module](/devel/modules/tutorials/module) and a [widget](/devel/modules/tutorials/widget) in Zabbix. # Інструкції Цей розділ містить практичні покрокові інструкції, що ілюструють, як створити власний [модуль](/devel/modules/tutorials/module) та [віджет](/devel/modules/tutorials/widget) у Zabbix. ### type Type of the module. Required for widgets and must equal "widget". *Type*: String *Default*: "module" *Example*: ```json "type": "widget" ``` ### type Тип модуля. Необхідний для віджетів і має дорівнювати "widget". *Тип*: String *За замовчуванням*: "module" *Приклад*: ```json "type": "widget" ``` ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-agent-cert-issuer** *cert-issuer* Allowed agent certificate issuer. **--tls-agent-cert-subject** *cert-subject* Allowed agent certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **unencrypted** підключатися без шифрування (за замовчуванням) ```{=html} <!-- --> ``` **psk** підключатися за допомогою TLS і заздалегідь наданого ключа ```{=html} <!-- --> ``` **cert** підключитися за допомогою TLS і сертифіката ```{=html} <!-- --> ``` **--tls-ca-файл** *CA-file* Повне ім'я файлу, що містить сертифікати центрів сертифікації верхнього рівня для для однорангової перевірки сертифікатів. **--tls-crl-file** *CRL-file* Повна назва файлу, що містить відкликані сертифікати. **--tls-agent-cert-issuer** *cert-issuer* Дозволений видавець сертифікатів агента. **--tls-agent-cert-subject** *cert-subject* Дозволений суб'єкт сертифіката агента. **--tls-cert-file** *cert-file* Повне ім'я файлу, що містить сертифікат або ланцюжок сертифікатів. **--tls-key-file** *key-file* Повний шлях до файлу, що містить закритий ключ. **--tls-psk-identity** *PSK-identity* Рядок PSK-ідентифікатора. **--tls-psk-file** *PSK-file* Повна назва файлу, що містить попередньо наданий ключ. **--tls-cipher13** *cipher-string* Рядок шифру для OpenSSL 1.1.1 або новішої версії для TLS 1.3. Замінити критерії вибору набору шифрів за замовчуванням. Ця опція недоступна, якщо Версія OpenSSL менша за 1.1.1. **--tls-cipher** *cipher-string* Рядок пріоритету GnuTLS (для TLS 1.2 і вище) або рядок шифру OpenSSL (тільки для TLS 1.2). Перевизначає критерії вибору набору шифрів за замовчуванням. **-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести інформацію про версію і вийти. [ ]{#lbAG} ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-server-cert-issuer** *cert-issuer* Allowed server certificate issuer. **--tls-server-cert-subject** *cert-subject* Allowed server certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-v**, **--verbose** Verbose mode, **-vv** for more details. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **unencrypted** підключення без шифрування (за замовчуванням) ```{=html} <!-- --> ``` **psk** підключитися за допомогою TLS і спільного ключа ```{=html} <!-- --> ``` **cert** підключитися за допомогою TLS і сертифіката ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Повний шлях до файлу, що містить сертифікати ЦС верхнього рівня для перевірки однорангових сертифікатів. **--tls-crl-file** *CRL-file* Повний шлях до файлу, що містить анульовані сертифікати. **--tls-server-cert-issuer** *cert-issuer* Дозволений емітент сертифіката сервера. **--tls-server-cert-subject** *cert-subject* Дозволена тема сертифіката сервера. **--tls-cert-file** *cert-file* Повний шлях до файлу, що містить сертифікат або ланцюжок сертифікатів. **--tls-key-file** *key-file* Повний шлях до файлу, що містить закритий ключ. **--tls-psk-identity** *PSK-identity* Рядок ідентифікатора PSK. **--tls-psk-file** *PSK-file* Повний шлях до файлу, що містить попередній спільний ключ. **--tls-cipher13** *cipher-string* Рядок шифру для OpenSSL 1.1.1 або новішої версії для TLS 1.3. Замінити критерії вибору набору шифрів за замовчуванням. Ця опція недоступна, якщо версія OpenSSL не перевищує 1.1.1. **--tls-cipher** *cipher-string* Рядок пріоритету GnuTLS (для TLS 1.2 і вище) або рядок шифру OpenSSL (лише для TLS 1.2). Замінити критерії вибору набору шифрів за замовчуванням. **-v**, **--verbose** Детальний режим, **-vv** для отримання додаткової інформації. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Виведіть інформацію про версію та вийдіть. [ ]{#lbAG} ##### Update process methods The widget update process methods are responsible for retrieving updated data from Zabbix server or any other data source and displaying it in the widget. ##### Методи процесу оновлення Методи процесу оновлення віджета відповідають за отримання оновлених даних із сервера Zabbix або будь-якого іншого джерела даних і відображення їх у віджеті. #### Updating an item Enable an item by setting its status to "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.update","params":{"itemid":"10092","status":0},"id":5}' ``` The successful response will contain the ID of the updated item: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 5 } ``` ::: notetip The `item.update` method as well as other *update methods* can also accept arrays of objects and update multiple items with one API call. ::: #### Оновлення елемента даних Увімкніть елемент, встановивши для нього статус "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.update","params":{"itemid":"10092","status":0},"id":5}' ``` Успішна відповідь міститиме ідентифікатор оновленого елемента: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 5 } ``` ::: notetip Метод item.update, а також інші *методи оновлення* також може приймати масиви об’єктів і оновлювати кілька елементів одним викликом API. ::: #### Updating multiple triggers Enable multiple triggers by setting their status to "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.update","params":[{"triggerid":"13938","status":0},{"triggerid":"13939","status":0}],"id":6}' ``` The successful response will contain the IDs of the updated triggers: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938", "13939" ] }, "id": 6 } ``` ::: notetip This is the preferred method of updating. Some API methods, such as the `host.massupdate` allow to write a simpler code. However, it is not recommended to use these methods as they will be removed in the future releases. ::: #### Оновлення кількох тригерів Увімкніть кілька тригерів, встановивши для них статус "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.update","params":[{"triggerid":"13938","status":0},{"triggerid":"13939","status":0}],"id":6}' ``` Успішна відповідь міститиме ідентифікатори оновлених тригерів: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938", "13939" ] }, "id": 6 } ``` ::: notetip Це найкращий метод оновлення. Деякі методи API, такі як `host.massupdate`, дозволяють писати простіший код. Однак не рекомендується використовувати ці методи, оскільки їх буде видалено в наступних випусках. ::: #### Updating problems The problem update popup allows to: - comment on the problem - view comments and actions so far - change problem severity - suppress/unsuppress problem - acknowledge/unacknowledge problem - change symptom problem to cause problem - manually close problem {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Problem*|If only one problem is selected, the problem name is displayed.<br>If several problems are selected, *N problems selected* is displayed.| |*Message*|Enter text to comment on the problem (maximum 2048 characters).| |*History*|Previous activities and comments on the problem are listed, along with the time and user details.<br>For the meaning of icons used to denote user actions see the [event detail](/manual/web_interface/frontend_sections/monitoring/problems#viewing_details) page.<br>Note that history is displayed if only one problem is selected for the update.| |*Scope*|Define the scope of such actions as changing severity, acknowledging or manually closing problems:<br>**Only selected problem** - will affect this event only<br>**Selected and all other problems of related triggers** - in case of acknowledgment/closing problem, will affect this event and all other problems that are not acknowledged/closed so far. If the scope contains problems already acknowledged or closed, these problems will not be acknowledged/closed repeatedly. On the other hand, the number of message and severity change operations are not limited.| |*Change severity*|Mark the checkbox and click on the severity button to update problem severity.<br>The checkbox for changing severity is available if read-write permissions exist for at least one of the selected problems. Only those problems that are read-writable will be updated when clicking on *Update*.<br>If read-write permissions exist for none of the selected triggers, the checkbox is disabled.| |*Suppress*|Mark the checkbox to suppress the problem:<br>**Indefinitely** - suppress indefinitely<br>**Until** - suppress until a given time. Both [absolute and relative](/manual/web_interface/time_period_selector) time formats are supported, for example:<br>`now+1d` - for one day from now (default)<br>`now/w` - until the end of the current week<br>`2022-05-28 12:00:00` - until absolute date/time<br>Note that a simple period (e. g., `1d`, `1w`) is not supported.<br>Availability of this option depends on the "Suppress problems" user role settings.<br>See also: [Problem suppression](/manual/acknowledgment/suppression)| |*Unsuppress*|Mark the checkbox to unsuppress the problem. This checkbox is active only if at least one of the selected problems is suppressed.<br>Availability of this option depends on the "Suppress problems" user role settings.| |*Acknowledge*|Mark the checkbox to acknowledge the problem.<br>This checkbox is available if there is at least one unacknowledged problem among the selected.<br>It is not possible to add another acknowledgment for an already acknowledged problem (it is possible to add another comment though).| |*Unacknowledge*|Mark the checkbox to unacknowledge the problem.<br>This checkbox is available if there is at least one acknowledged problem among the selected.| |*Convert to cause*|Mark the checkbox to convert the symptom problem(s) to cause problem(s).| |*Close problem*|Mark the checkbox to manually close the selected problem(s).<br>The checkbox for closing a problem is available if the *Allow manual close* option is checked in [trigger configuration](/manual/config/triggers/trigger) for at least one of the selected problems. Only those problems will be closed that are allowed to be closed when clicking on *Update*.<br>If no problem is manually closeable, the checkbox is disabled.<br>Already closed problems will not be closed repeatedly.| #### Оновлення проблем Спливаюче вікно оновлення проблеми дозволяє: - прокоментувати проблему - переглянути коментарі та дії - змінити ступінь серйозності проблеми - приховати/розкрити проблему - підтвердити/непідтвердити проблему - змінити симптом проблеми на її причину - закрити проблему вручну {width="600"} Усі обов’язкові поля для введення позначені червоною зірочкою. |Параметр|Опис| |--|--------| |*Проблема*|Якщо вибрано лише одну проблему, відображається назва проблеми.<br>Якщо вибрано кілька проблем, відображається *N проблем вибрано*.| |*Повідомлення*|Введіть текст для коментаря до проблеми (максимум 2048 символів).| |*Історія*|Наведено попередні дії та коментарі щодо проблеми, а також час і відомості про користувача.<br>Значення піктограм, які використовуються для позначення дій користувача, див. [деталі події](/manual/web_interface/frontend_sections/ monitoring/problems#viewing_details).<br>Зверніть увагу, що історія відображається, якщо для оновлення вибрано лише одну проблему.| |*Область*|Визначте область таких дій, як зміна серйозності, підтвердження чи закриття проблем вручну:<br>**Лише вибрана проблема** – вплине лише на цю подію<br>**Вибрані та всі інші проблеми пов’язаних тригерів ** - у разі проблеми з підтвердженням/закриттям, це вплине на цю подію та всі інші проблеми, які наразі не підтверджені/закриті. Якщо область містить уже підтверджені або вирішені проблеми, ці проблеми не будуть визнаватися/закриватися повторно. З іншого боку, кількість операцій зміни повідомлень і серйозності не обмежена.| |*Змінити серйозність*|Поставте чекбокс і натисніть кнопку серйозності, щоб оновити серйозність проблеми.<br>Чекбокс для зміни серйозності доступний, якщо є дозволи на читання та запис принаймні для однієї з вибраних проблем. Лише ті проблеми, які доступні для читання та запису, будуть оновлені після натискання *Оновити*.<br>Якщо дозволи на читання та запис не існують для жодного з вибраних тригерів, чекбокс буде вимкнено.| |*Приховувати*|Поставте чекбокс, щоб приховати проблему:<br>**На невизначений термін** - приховувати на невизначений термін<br>**До** - приховувати до певного часу. Підтримуються як [абсолютний, так і відносний](/manual/config/visualization/graphs/simple#time-period-selector) формати часу, наприклад:<br>`зараз+1д` - на один день (за замовчуванням)< br>`зараз/с` - до кінця поточного тижня<br>`2022-05-28 12:00:00` - до абсолютної дати/часу<br>Зверніть увагу, що вказання просто періоду (наприклад, `1d` , `1w`) не підтримується.<br>Доступність цього параметра залежить від налаштувань ролі користувача «Приховувати проблеми».<br>Див. також: [Припинення проблеми](/manual/acknowledgment/suppression)| |*Unsuppress*|Позначте поле, щоб скасувати приховування проблеми. Цей прапорець активний, лише якщо принаймні одна з вибраних проблем прихована.<br>Доступність цього параметра залежить від налаштувань ролі користувача «Припинити проблеми».| |*Підтвердити*|Поставте прапорець, щоб підтвердити проблему.<br>Цей прапорець доступний, якщо серед вибраних є принаймні одна непідтверджена проблема.<br>Неможливо додати ще одне підтвердження для вже підтвердженої проблеми (вона але можна додати ще один коментар).| |*Unacknowledge*|Позначте прапорець, щоб скасувати підтвердження проблеми.<br>Цей прапорець доступний, якщо серед вибраних є принаймні одна підтверджена проблема.| |*Перетворити на причину*|Позначте прапорець, щоб перетворити симптом проблеми на причину, що її викликає.| |*Закрити проблему*|Поставте прапорець, щоб вручну закрити вибрану(і) проблему(и).<br>Прапорець для закриття проблеми доступний, якщо опцію *Дозволити закриття вручну* позначено в [конфігурації тригера](/manual/config /triggers/trigger) принаймні для однієї з вибраних проблем. Буде закрито лише ті проблеми, які дозволено закрити, натиснувши *Оновити*.<br>Якщо жодну проблему не можна закрити вручну, прапорець вимкнено.<br>Уже закриті проблеми не будуть закриті повторно.| ### url A link to the module description. For widgets, this link will be opened when clicking on the help icon {class="nozoom"} in the [*Add widget*](/manual/web_interface/frontend_sections/dashboards#adding-widgets) or [*Edit widget*](/manual/web_interface/frontend_sections/dashboards#widgets) window. If **url** is not specified, clicking on the help icon will open the general [Dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets) page. *Type*: String *Example*: ```json "url": "http://example.com" ``` ### url Посилання на опис модуля. Для віджетів це посилання буде відкрито, якщо натиснути піктограму довідки {class="nozoom"} у [*Додати віджет*](/manual/web_interface/frontend_sections/dashboards#adding-widgets) або вікні [*Редагувати віджет*](/manual/web_interface/frontend_sections/dashboards#widgets). Якщо **url** не вказано, клацання піктограми довідки відкриє загальну сторінку [Віджети інформаційної панелі](/manual/web_interface/frontend_sections/dashboards/widgets). *Тип*: String *Приклад*: ```json "url": "http://example.com" ``` #### Users and user groups Add users that will have access to Zabbix, assign them to user groups and grant permissions. Make roles for granular management of user rights. [User API](/manual/api/reference/user) | [User group API](/manual/api/reference/usergroup) | [User directory API](/manual/api/reference/userdirectory) | [User role API](/manual/api/reference/role) #### Користувачі та групи користувачів Додавання користувачів, які матимуть доступ до Zabbix, додавання їх до груп користувачів і надання дозволів. Створення ролей для детального керування правами користувачів. [API користувача](/manual/api/reference/user) | [API Групи користувачів](/manual/api/reference/usergroup) | [API Каталогу користувача](/manual/api/reference/userdirectory) | [API Ролі користувача](/manual/api/reference/role) ## Users The Zabbix API allows you to manage users of your monitoring system. ## Користувачі Zabbix API дозволяє вам керувати користувачами вашої системи моніторингу. #### Using a custom expression filter Create a trigger action that uses a custom expression - "A and (B or C)" - for evaluating action conditions. Once a trigger with a severity higher or equal to "Warning" from host "10084" or host "10106" goes into a PROBLEM state, the action will send a message to all users in user group "7" via media type "1". The formula IDs "A", "B" and "C" have been chosen arbitrarily. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "15m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Використання спеціального фільтра виразів Створіть дію тригера, яка використовує настроюваний вираз - "A і (B або C)" - для оцінки умов дії. Як тільки тригер зі ступенем серйозності рівним або вище «Попередження» з хоста «10084» або хоста «10106» перейде в стан ПРОБЛЕМА, дія надішле повідомлення всім користувачам у групі користувачів «7» через спосіб сповіщення «1». [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "15m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` ### version Module version. The version will be displayed in the Administration section. *Type*: String *Example*: ```json "version": "1.0" ``` ### version Версія модуля. Версія буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "version": "1.0" ``` #### View mode buttons The following buttons located in the top right corner are common for every section: | | | |--|--------| ||Display page in kiosk mode. In this mode only page content is displayed.<br>To exit kiosk mode, move the mouse cursor until the  exit button appears and click on it. You will be taken back to normal mode.| #### Кнопки режиму перегляду Наступні кнопки, розташовані у верхньому правому куті, є загальними для кожного розділу: | | | |--|--------| ||Відображати сторінку в режимі кіоску. У цьому режимі відображається лише вміст сторінки.<br>Щоб вийти з режиму кіоску, перемістіть курсор миші до  з’явиться кнопка виходу та натисніть її. Ви повернетеся до звичайного режиму.| # Views View file receives the data from a controller and then prepares the HTML look of it. :::noteclassic Defining view(s) for a frontend module is optional, unless the module is a widget.\ Dashboard widgets need at least two views: one for the edit mode and one for the view mode (should be stored in the *views* directory). ::: It is possible to use pre-defined Zabbix HTML classes (from the */zabbix/ui/include/classes/html*) in the view as well as add new HTML and CSS classes. New classes should be stored in the module's *assets* folder. Example: ```` ... (new CColHeader(_('Name'))) ```` This will add a new column name *Name* and style the top table row as on other Zabbix pages. # Views View-файл отримує дані від контролера, а потім генерує їх HTML-відображення. :::noteclassic Створювати view-файл для інтерфейсного модуля необов’язково, якщо тільки модуль не є віджетом.\ Для віджетів інформаційної панелі потрібно принаймні два типу view: один для режиму редагування та інший для режиму перегляду (має зберігатися в каталозі *views*). ::: У view-файлах можна використовувати попередньо визначені класи Zabbix HTML (з */zabbix/ui/include/classes/html*), а також додавати нові класи HTML і CSS. Нові класи повинні зберігатися в каталозі модуля *assets* . приклад: ```` ... (new CColHeader(_('Name'))) ```` Це додасть нову назву стовпця *Name* і стилізує верхній рядок таблиці, аналогічно до інших сторінок Zabbix. ## vmware.hv.diskinfo.get The item **vmware.hv.diskinfo.get[]** returns JSON objects with the following structure (values are provided as an example): ```json [ { "instance": "mpx.vmhba32:C0:T0:L0", "hv_uuid": "8002299e-d7b9-8728-d224-76004bbb6100", "datastore_uuid": "", "operational_state": [ "ok" ], "lun_type": "disk", "queue_depth": 1, "model": "USB DISK", "vendor": "SMI Corp", "revision": "1100", "serial_number": "CCYYMMDDHHmmSS9S62CK", "vsan": {} }, { // other instances } ] ``` ## vmware.hv.diskinfo.get The item **vmware.hv.diskinfo.get[]** returns JSON objects with the following structure (values are provided as an example): ```json [ { "instance": "mpx.vmhba32:C0:T0:L0", "hv_uuid": "8002299e-d7b9-8728-d224-76004bbb6100", "datastore_uuid": "", "operational_state": [ "ok" ], "lun_type": "disk", "queue_depth": 1, "model": "USB DISK", "vendor": "SMI Corp", "revision": "1100", "serial_number": "CCYYMMDDHHmmSS9S62CK", "vsan": {} }, { // other instances } ] ``` #### Web monitoring Configure web scenarios to monitor your web applications and services. [Web scenario API](/manual/api/reference/httptest) #### Веб моніторинг Налаштуйте веб-сценарії для моніторингу веб-додатків і служб. [API веб-сценарію](/manual/api/reference/httptest) ### What a module can be used for - Adding new functionality via custom frontend sections; - Creating custom dashboard widget types (see [widget modules](/devel/modules/widgets)); - Overriding or extending the existing functionality. ### Для чого можна використовувати модуль - Додавання нової функціональності через користувацькі розділи інтерфейсу; - Створення користувацьких типів віджетів інформаційної панелі (див. [модулі віджетів](/devel/modules/widgets)); - Заміна або розширення наявної функціональності. ### What a module cannot be used for - Registering a new API method or modifying an existing one. ### Для чого не можна використовувати модуль - Реєстрація нового методу API або зміна існуючого. ### What is a PHP frontend module? - A module is an entity with a unique ID, name, description, author, and other fields defined in it's manifest file, along with PHP, Javascript and other files located in a single directory inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). - A module should conform to simple rules to guarantee correct operation. - A module must be installed (unpacked) and enabled in the frontend by the administrator. ### Що таке PHP frontend модуль ? - Модуль - це сутність з унікальним ідентифікатором, назвою, описом, автором та іншими полями, визначеними у файлі маніфесту, разом з PHP, Javascript та іншими файлами, розташованими в одному каталозі всередині каталогу *modules* вашої інсталяції web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). - Модуль повинен відповідати простим правилам, щоб гарантувати правильну роботу. - Модуль повинен бути встановлений (розпакований) і активований у web-інтерфейсі адміністратором. ## What you'll build During this tutorial, you will first build a [basic](#part-i---hello-world) "Hello, world!" widget and then convert it into a [more advanced](#part-ii---gauge-chart) widget that displays an item value as a gauge chart. Here's how the finished widget will look like: {width="600"} ## Що ви створите У цьому посібнику ви спочатку створите [базовий](#part-i---hello-world) віджет "Hello, world!", а потім перетворите його на [більш просунутий](#part-ii---gauge-chart) віджет, який відображає значення елемента даних у вигляді гістограми.Ось як виглядатиме готовий віджет: {width="600"} ### What you'll build During this tutorial, you will first build a frontend module that adds a new *My Address* menu section and then convert it into a [more advanced](#part-iii---module-action) frontend module that makes an HTTP request to *https://api.seeip.org* and displays the response - the IP address of your computer - on a new page in the newly created *My Address* menu section. Here's how the finished module will look like: {width="600"} ### Що ви створите У цьому уроці ви спочатку створите модуль інтерфейсу, який додає новий розділ меню *Моя адреса*, а потім перетворите його на [більш просунутий] (#part-iii---module-action) модуль інтерфейсу, який робить HTTP-запит до *https://api.seeip.org* і відображає відповідь - IP-адресу вашого комп'ютера - на новій сторінці в новоствореному розділі меню *Моя адреса*. Ось як виглядатиме готовий модуль: {width="600"} ### What you'll create During this tutorial, you will add a new loadable plugin **MyIP**. The plugin will implement 1 metric called **myip**, which returns the external IP address of the host where Zabbix agent 2 is running. ### Що ви створите Під час цього уроку ви додасте новий завантажуваний плагін **MyIP**. Плагін реалізує 1 метрику під назвою **myip**, яка повертає зовнішню IP-адресу хоста, на якому запущено Zabbix Agent 2. ### Where to go next Whether you prefer to learn by doing or read the guidelines first, these pages contain the information and steps required to build your own modules: - [Step-by-step tutorials for writing your first module](/devel/modules/tutorials) - [Module file structure](/devel/modules/file_structure) - [Widget module specifics](/devel/modules/widgets) - [Module examples to reuse](/devel/modules/examples) ### Куди рухатися далі Незалежно від того, чи віддаєте ви перевагу навчанню на практиці, чи спочатку читаєте інструкції, ці сторінки містять інформацію та кроки, необхідні для створення власних модулів: - [Покрокові посібники для написання вашого першого модуля](/devel/modules/tutorials) - [Файлова структура модуля](/devel/modules/file_structure) - [Особливості модуля віджетів](/devel/modules/widgets) - [Приклади модулів для повторного використання](/devel/modules/examples) ### Widget action The widget action class (*WidgetView*) contains methods for operations with widgets in the presentation view mode. The majority of widget actions use and/or extend the default controller class *CControllerDashboardWidgetView*. The widget action class should be located in the *actions* directory and specified in the [*actions*](/devel/modules/file_structure/manifest#actions) parameter (*actions/widget.{id}.view/class*) in the *manifest.json* file. **actions/WidgetView.php example (implemented in the Zabbix-native [*System information*](/manual/web_interface/frontend_sections/dashboards/widgets/system) widget)** ```php class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getDefaultName()), 'system_info' => CSystemInfoHelper::getData(), 'info_type' => $this->fields_values['info_type'], 'user_type' => CWebUser::getType(), 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` ### Widget action Клас дій віджетів (*WidgetView*) містить методи для роботи з віджетами в режимі перегляду презентації. Більшість дій віджетів використовують та/або розширюють клас контролера за замовчуванням *CControllerDashboardWidgetView*. Клас дій віджета має розташовуватися в каталозі *actions* і вказуватися в параметрі [*actions*](/devel/modules/file_structure/manifest#actions) (*actions/widget.{id}.view/class*) у файлі *manifest.json*. **actions/WidgetView.php приклад (реалізований у стандартному для Zabbix віджеті [*Системна інформація*](/manual/web_interface/frontend_sections/dashboards/widgets/system)** ```php class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getDefaultName()), 'system_info' => CSystemInfoHelper::getData(), 'info_type' => $this->fields_values['info_type'], 'user_type' => CWebUser::getType(), 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` ### Widget examples - Minimal widget - [widget_min.zip](/../assets/en/devel/modules/examples/widget_min.zip) - "Hello, world" widget using CSS only - [hello_world_css.zip](/../assets/en/devel/modules/examples/hello_world_css.zip) - "Hello, world" widget using JavaScript only - [hello_world_js.zip](/../assets/en/devel/modules/examples/hello_world_js.zip) - "Hello, world" widget using PHP - [hello_world_php.zip](/../assets/en/devel/modules/examples/hello_world_php.zip) ::: notetip You can also use [Zabbix native widgets](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/widgets) as examples. ::: ### Приклади віджетів - Мінімальний віджет - [widget_min.zip](/../assets/en/devel/modules/examples/widget_min.zip) - Віджет "Hello, world" лише з використанням CSS - [hello_world_css.zip](/../assets/en/devel/modules/examples/hello_world_css.zip) - Віджет "Hello, world" використовує лише JavaScript - [hello_world_js.zip](/../assets/en/devel/modules/examples/hello_world_js.zip) - Віджет "Hello, world" з використанням PHP - [hello_world_php.zip](/../assets/en/devel/modules/examples/hello_world_php.zip) ::: підказка Ви також можете використовувати [власні віджети Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/widgets) як приклади. ::: ### WidgetForm The *WidgetForm* class extends the default class *CWidgetForm* and contains a set of [*CWidgetField*](#cwidgetfield) fields that are required for defining widget configuration storage structure in the database and handling input validation. The *WidgetForm* class should be located in the *includes* directory. If the class has a different name, the name should be specified in the [*widget/form_class*](/devel/modules/file_structure/manifest#widget) parameter in the *manifest.json* file. **includes/WidgetForm.php example** ```php <?php namespace Modules\MyCustomWidget\Includes; use Modules\MyCustomWidget\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox, CWidgetFieldColor }; class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ); } } ``` ### WidgetForm Клас *WidgetForm* розширює стандартний клас *CWidgetForm* і містить набір полів [*CWidgetField*](#cwidgetfield). які необхідні для визначення структури зберігання конфігурації віджета в базі даних і обробки валідації вхідних даних. Клас *WidgetForm* має бути розташований у каталозі *includes*. Якщо клас має іншу назву, її потрібно вказати в параметрі [*widget/form_class*](/devel/modules/file_structure/manifest#widget) у файлі *manifest.json*. **includes/WidgetForm.php приклад** ```php <?php namespace Modules\MyCustomWidget\Includes; use Modules\MyCustomWidget\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox, CWidgetFieldColor }; class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ); } } ``` ## Widget preview Widget modules, once added, become immediately visible in the dashboard widget list. You can open a dashboard, switch to the edit mode and add the widget to the dashboard as usual. When you make some changes to the widget, refresh the dashboard to view how the widget looks with the most recent updates. ## Попередній перегляд віджета Модулі віджетів після додавання відразу стають видимими в списку віджетів інформаційної панелі. Ви можете відкрити інформаційну панель, перейти в режим редагування та додати віджет на інформаційну панель, як зазвичай. Після внесення змін у віджет, оновіть інформаційну панель, щоб побачити, як виглядає віджет з останніми оновленнями. ### Widget Primary widget class, extends the base class of all dashboard widgets - *CWidget*. Required for overriding the default widget behavior. The *Widget* class should be located in the root directory of the widget (for example, *zabbix/ui/modules/my_custom_widget*). **Widget.php example** ```php <?php namespace Modules\MyCustomWidget; use Zabbix\Core\CWidget; class Widget extends CWidget { public const MY_CONSTANT = 0; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` ### Віджет Основний клас віджетів, розширює базовий клас усіх віджетів інформаційної панелі - *CWidget*. Необхідний для заміни поведінки віджета за замовчуванням. Клас *Widget* має бути розташований у кореневому каталозі віджета (наприклад, *zabbix/ui/modules/my_custom_widget*). **Приклад Widget.php** ```php <?php namespace Modules\MyCustomWidget; use Zabbix\Core\CWidget; class Widget extends CWidget { public const MY_CONSTANT = 0; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` # Widgets Widgets are Zabbix frontend modules used for the dashboards. Unless otherwise noted, all module guidelines are also applicable to widgets. However, a widget is notably different from a module. To build a widget: - specify the type "widget" in the [manifest.json file](/devel/modules/file_structure/manifest) ("type": "widget"); - include at least two views: one for the [widget presentation mode](/devel/modules/widgets/presentation#widget-view) and one for the [widget configuration mode](/devel/modules/widgets/configuration#widget-configuration-view) (example.widget.view.php and example.widget.edit.php); - and a [controller](/devel/modules/widgets/presentation#widget-actions) for widget presentation (WidgetView.php); - use and extend default [widget classes](/devel/modules/widgets/configuration). # Віджети Віджети — це інтерфейсні модулі Zabbix, які використовуються для інформаційних панелей. Якщо не зазначено інше, усі інструкції щодо модуля також застосовуються до віджетів. Однак віджет значно відрізняється від модуля. Щоб створити віджет: - вкажіть тип "widget" у [файлі manifest.json](/devel/modules/file_structure/manifest) ("type": "widget"); - включіть принаймні два view: один для [режиму презентації віджетів](/devel/modules/widgets/presentation#widget-view) і один для [режиму конфігурації віджетів](/devel/modules/widgets/configuration#widget- configuration-view) (example.widget.view.php і example.widget.edit.php); - і [контролер](/devel/modules/widgets/presentation#widget-actions) для представлення віджетів (WidgetView.php); - використовуйте та розширюйте стандартні [класи віджетів](/devel/modules/widgets/configuration). ### Widget view The widget view class (*CWidgetView*) is responsible for building the widget presentation view. The widget view class should be located in the *views* directory. If the file containing the widget view class has a different name than the default (*widget.view.php*), then it must be specified in the *manifest.json* file [*actions*](/devel/modules/file_structure/manifest#actions) parameter (*actions/widget.{id}.view/view*). **views/widget.view.php example** ```php <?php /** * My custom widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, $data['name']) ) ->show(); ``` ### Widget view Клас view віджетів (*CWidgetView*) відповідає за створення представлення view віджетів. Клас view віджета має бути розташований у каталозі *views*. Якщо файл, що містить клас view віджетів, має іншу назву, ніж назва за замовчуванням (*widget.view.php*), тоді її потрібно вказати у файлі *manifest.json* [*actions*](/devel/modules/file_structure /manifest#actions) параметр (*actions/widget.{id}.view/view*). **views/widget.view.php приклад** ```php <?php /** * My custom widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->additem( new CTag('h1', true, $data['name']) ) ->show(); ``` ### widget Widget configuration. Used, if *[type](#type)* is set to *widget*. *Type*: Object *Supported object keys:* - **name** (string) - used in the widget list and as default header. If empty, "name" parameter from the module will be used. - **size** (object) - default widget dimensions. Supports keys: - *width* (integer) - default widget width. - *height* (integer) - default widget height. - **form_class** (string) - class with widget fields form. Must be located in the *includes* directory. If the class is *WidgetForm.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. - **js_class** (string) - name of a JavaScript class for widget view mode to extend the default CWidget class. The class will be loaded with the dashboard. The class source file must be located in the assets/js directory. See also: [assets](#assets). - **use_time_selector** (boolean) - determines whether the widget requires dashboard time selector. Supported values: *true*, *false* (default). - **refresh_rate** (integer) - widget refresh rate in seconds (default: 60). *Example*: ```json "widget": { "name": "", "size": { "width": 12, "height": 5 }, "form_class": "WidgetForm", "js_class": "CWidget", "use_time_selector": false, "refresh_rate": 60 } ``` ### widget Конфігурація віджета. Використовується, якщо *[type](#type)* має значення *widget*. *Тип*: Object *Підтримувані ключі об’єктів:* - **name** (string) - використовується у списку віджетів і як заголовок за замовчуванням. Якщо значення пусте, буде використано параметр "name" модуля. - **size** (object) - розміри віджета за замовчуванням. Підтримує ключі: - *width* (integer) - ширина віджета за замовчуванням. - *height* (integer) - висота віджета за замовчуванням. - **form_class** (string) - клас з формою полів віджетів. Повинен знаходитися в каталозі *includes*. Якщо класом є *WidgetForm.php*, який очікується за замовчуванням, цей параметр можна опустити. Якщо ви використовуєте інше ім’я, вкажіть його тут. - **js_class** (string) - назва класу JavaScript для режиму перегляду віджетів для розширення стандартного класу CWidget. Клас буде завантажено разом із панеллю інструментів. Вихідний файл класу має бути розташований у каталозі assets/js. Дивіться також: [assets](#assets). - **use_time_selector** (boolean) - визначає, чи потрібен віджет селектор часу на інформаційній панелі. Підтримувані значення: *true*, *false* (за замовчуванням). - **refresh_rate** (integer) - частота оновлення віджета в секундах (за замовчуванням: 60). *Приклад*: ```json "widget": { "name": "", "size": { "width": 12, "height": 5 }, "form_class": "WidgetForm", "js_class": "CWidget", "use_time_selector": false, "refresh_rate": 60 } ``` ### Writing a module A sample module writing process consists of the following steps (where available, click on the file or folder name to view additional details about the step): 1. Create a new directory for the module inside **zabbix/ui/modules/**. 2. Add [manifest.json](/devel/modules/file_structure/manifest) file with module metadata. 3. Create *[views](/devel/modules/file_structure/views)* folder and define a module view(s). 4. Create *[actions](/devel/modules/file_structure/actions)* folder and define a module action(s). 5. Create Module.php (or Widget.php for dashboard widgets) file and define initialization and event handling rules. 6. Create *[assets](/devel/modules/file_structure/assets)* folder for JavaScript files (place into *assets/js*), CSS styles (place into *assets/css*), or any other additional files. 7. Make sure to specify required views, actions and asset files in the manifest.json. 8. [Register](/devel/modules/file_structure/register) the module in Zabbix frontend and start using it. :::notetip You can register and enable a module as soon as you create manifest.json file. Once the module is enabled, you can preview all changes made to module files immediately by refreshing Zabbix frontend. ::: ### Написання модуля Приклад процесу написання модуля складається з наступних кроків (там, де це можливо, клацніть на назві файлу або папки, щоб переглянути додаткову інформацію про крок): 1. Створіть новий каталог для модуля всередині **zabbix/ui/modules/**. 2. Додайте файл [manifest.json](/devel/modules/file_structure/manifest) із метаданими модуля. 3. Створіть папку *[views](/devel/modules/file_structure/views)* та визначте вид(и) модуля. 4. Створіть папку *[actions](/devel/modules/file_structure/actions)* та визначте дії модуля. 5. Створіть файл Module.php (або Widget.php для віджетів інформаційної панелі) і визначте правила ініціалізації та обробки подій. 6. Створіть папку *[assets](/devel/modules/file_structure/assets)* для файлів JavaScript (розмістіть у *assets/js*), стилів CSS (розмістіть у *assets/css*) або будь-яких інших додаткових файлів. 7. Переконайтеся, що в manifest.json вказані необхідні views, actions та assets. 8. [Зареєструйте](/devel/modules/file_structure/register) модуль у інтерфейсі Zabbix і почніть його використовувати. :::notetip Ви можете зареєструвати та ввімкнути модуль, щойно створите файл manifest.json. Після ввімкнення модуля ви можете одразу переглянути всі зміни, внесені до файлів модуля, перезавантаживши інтерфейс Zabbix. ::: # zabbix\_agent2 Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_agent2 Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_agentd Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_agentd Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} #### Zabbix agent For passive checks Zabbix agent needs to know the IP address or DNS name of Zabbix server. If you have provided correct information during the agent installation, the configuration file is already updated. Otherwise, you need to manually specify it. Go to the `C:\Program files\Zabbix Agent` folder, open the file *zabbix_agentd.conf* and add the IP/DNS of your Zabbix server to the *Server* parameter. Example: Server=192.0.2.22 #### Zabbix agent For passive checks Zabbix agent needs to know the IP address or DNS name of Zabbix server. If you have provided correct information during the agent installation, the configuration file is already updated. Otherwise, you need to manually specify it. Go to the `C:\Program files\Zabbix Agent` folder, open the file *zabbix_agentd.conf* and add the IP/DNS of your Zabbix server to the *Server* parameter. Example: Server=192.0.2.22 #### Zabbix agent In the `C:\Program files\Zabbix Agent` folder open the file *zabbix_agentd.conf* and add: - The name of the host you created in Zabbix web interface to the *Hostname* parameter. - The IP address or DNS name of your Zabbix server machine to the *ServerActive* parameter (might be prefilled if you have provided it during Zabbix agent setup). Example: ServerActive= 192.0.2.22 Hostname=Windows workstation #### Zabbix agent In the `C:\Program files\Zabbix Agent` folder open the file *zabbix_agentd.conf* and add: - The name of the host you created in Zabbix web interface to the *Hostname* parameter. - The IP address or DNS name of your Zabbix server machine to the *ServerActive* parameter (might be prefilled if you have provided it during Zabbix agent setup). Example: ServerActive= 192.0.2.22 Hostname=Windows workstation # Zabbix documentation These pages contain official Zabbix documentation. Use the sidebar navigation to browse documentation pages. To be able to watch pages, log in with your [Zabbix forums](http://www.zabbix.com/forum/) username and password. # Документація Zabbix Ці сторінки містять офіційну документацію Zabbix. Використовуйте навігацію на бічній панелі, щоб переглядати сторінки документації. Щоб мати можливість переглядати сторінки, увійдіть, використовуючи своє ім’я користувача та пароль [на форумах Zabbix](http://www.zabbix.com/forum/). #### Zabbix frontend 1\. Log into Zabbix frontend. 2\. [Create a host](/manual/config/hosts/host) in Zabbix web interface. This host will represent your Windows machine. 3\. In the *Interfaces* parameter, add *Agent* interface and specify the IP address or DNS name of the Windows machine where the agent is installed. 4\. In the *Templates* parameter, type or select *Windows by Zabbix agent*. {width="600"} #### Zabbix frontend 1\. Log into Zabbix frontend. 2\. [Create a host](/manual/config/hosts/host) in Zabbix web interface. This host will represent your Windows machine. 3\. In the *Interfaces* parameter, add *Agent* interface and specify the IP address or DNS name of the Windows machine where the agent is installed. 4\. In the *Templates* parameter, type or select *Windows by Zabbix agent*. {width="600"} # zabbix\_get Section: User Commands (1)\ Updated: 2021-06-01\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_get Розділ: Команди користувача (1)\ Оновлено: 01.06.2021\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_js Section: User Commands (1)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_js Розділ: Команди користувача (1)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # Zabbix manpages These are Zabbix manpages for Zabbix processes. # Сторінки довідки Zabbix Це сторінки довідки Zabbix для процесів Zabbix. # Zabbix Manual Welcome to the user manual for Zabbix software. These pages are created to help users successfully manage their monitoring tasks with Zabbix, from the simple to the more complex ones. # Посібник Zabbix Ласкаво просимо до посібника користувача програмного забезпечення Zabbix. Ці сторінки створені, щоб допомогти користувачам успішно керувати своїми завданнями моніторингу за допомогою Zabbix, від простих до складніших. # zabbix\_proxy Section: Maintenance Commands (8)\ Updated: 2020-09-04\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_proxy Розділ: Команди обслуговування (8)\ Оновлено: 04.09.2020\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_sender Section: User Commands (1)\ Updated: 2021-06-01\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_sender Розділ: Команди користувача (1)\ Оновлено: 01.06.2021\ [Зміст](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_server Section: Maintenance Commands (8)\ Updated: 2020-09-04\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_server Розділ: Команди обслуговування (8)\ Оновлено: 04.09.2020\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_web\_service Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_web\_service Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} ### ### # 10 Virtual machine monitoring # 10 Моніторинг віртуальних машин # 11 Time zones # 11 Часові пояси # 13 Problem acknowledgment # 13. Підтвердження проблеми # 14 Configuration export/import # 14. Експорт/імпорт конфігурації # 15 Data export # 15 Експорт даних # 17 Encryption # 17 Шифрування # 18 Web interface # 18. Веб-інтерфейс # 1 Creating an item # 1 Створення елементу данних # 1 Database creation # 1 Створення бази даних # 1 Foreach functions # 1 Функції Foreach # 1 Global notifications # 1 Глобальні сповіщення # 1 Graphs # 1 Графіки # 1 High availability # 1 Висока доступність # 1 Introduction Please use the sidebar to access content in the Introduction section. # 1. Вступ Будь ласка, використовуйте бічну панель, щоб отримати доступ до вмісту вступного розділу. # 1 Login and configuring user # 1 Вхід і налаштування користувача # 1 Manual structure # 1 Структура посібника # 1 Menu # 1 Меню # 1 Problem suppression # 1 Приховування проблеми # 1 Web monitoring items # 1 Елементи веб-моніторингу # 2 Frontend sections # 2 Інтерфейсні розділи # 2 Monitor Windows with Zabbix agent # 2 Monitor Windows with Zabbix agent # 2 New host # 2 Новий вузол мережі # 2 Passive and active agent checks # 2 Passive and active agent checks # 2 Real-life scenario # 2 Реальний сценарій # 2 Repairing Zabbix database character set and collation # 2 Відновлення набору символів і сортування бази даних Zabbix # 2 Sound in browsers # 2 Звук в браузерах # 3 New item # 3 Новий елемент даних # 3 Templates # 3 Шаблони # 3 User settings # 3 Налаштування користувача # 3 Zabbix processes Please use the sidebar to access content in the Zabbix process section. # 3. Процеси Zabbix Для доступу до вмісту розділу "Процеси Zabbix", будь ласка, використовуйте бічну панель. # 4 New trigger # 4 Новий тригер # 4 Proxy # 4 Проксі # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 Zabbix agent 2 (UNIX) # 4 Zabbix агент 2 (UNIX) # 5 Frontend maintenance mode # 5 Режим обслуговування інтерфейсу # 5 Quickstart Please use the sidebar to access content in the Quickstart section. # 5. Швидкий початок Будь ласка, використовуйте бічну панель для доступу до вмісту в розділі швидкого початку. # 5 Receiving problem notification # 5 Отримання повідомлення про проблему # 6 Action log # 6 Журнал дій # 6 New template # 6 Новий шаблон # 6 Page parameters # 6 Параметри сторінки # 6 Zabbix appliance # 6. Готове рішення Zabbix # 8 Creating your own theme # 8 Створення власної теми # 9 Queue # 9 Черга # 9 Zabbix web service # 9 Веб-сервіс Zabbix # action.create # action.create # action.delete # action.delete # action.get # action.get # Actions Actions are responsible for 'business logic' of the module. An action usually consists of a [controller](#controller) and an [action view](views#action-view). A module can: - Call actions that are already defined in Zabbix frontend. - Override default actions with custom actions. - Define completely new actions. To override a default action behavior with some custom behavior, define an action with the same name in the module configuration. When the action is called, the module action will be executed instead of the default Zabbix action. Action files should be stored in the *actions* folder. The actions need to be specified in the [manifest.json](manifest). # Actions Дії відповідають за «бізнес-логіку» модуля. Зазвичай дія складається з [контролера](#controller) і [перегляду дії](views#action-view). Модуль може: - Викликати дії, які вже визначені у інтерфейсі Zabbix. - Замінювати дії за замовчуванням власними діями. - Визначати абсолютно нові дії. Щоб замінити поведінку дій за замовчуванням на якусь настроювану поведінку, визначте дію з такою самою назвою в конфігурації модуля. Під час виклику дії буде виконано дію модуля замість типової дії Zabbix. Файли дій повинні зберігатися в папці *actions*. Дії потрібно вказати в [manifest.json](маніфест). ### actions Actions to register with the module. Defining *class* object key for each action is required, other action keys are optional. *Type*: Object Supported object keys if *[type](#type)* is *module*: - **write.your.action.name** (object) - action name, should be written in lowercase [a-z], separating words with dots. Supports the keys: - **class** (string; required) - action class name. - **layout** (string) - action layout. Supported values: *layout.json*, *layout.htmlpage* (default), *null*. - **view** (string) - action view. *Example*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` Supported object keys if *[type](#type)* is *widget*: - **widget.{id}.view** (object) - file and class name for widget view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.view*). Supports the keys: - **class** (string; required) - action class name for widget view mode to extend the default CControllerDashboardWidgetView class. The class source file must be located in the *actions* directory. - **view** (string) - widget view. Must be located in the *views* directory. If the view file is *widget.view.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. - **widget.{id}.edit** (object) - file name for widget configuration view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.edit*). Supports the keys: - **class** (string; required) - action class name for widget configuration view mode. The class source file must be located in the *actions* directory. - **view** (string) - widget configuration view. Must be located in the *views* directory. If the view file is *widget.edit.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. *Example*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ``` ### actions Дії для реєстрації в модулі. Необхідно визначити ключ об’єкта *class* для кожної дії, інші ключі дії необов’язкові. *Тип*: Object Підтримувані ключі об’єктів, якщо *[type](#type)* є *module*: - **write.your.action.name** (object) - назва дії, має бути написано малими літерами [a-z], розділяючи слова крапками. Підтримує ключі: - **class** (string; required) - назва класу дії. - **layout** (string) - розкладка дії. Підтримувані значення: *layout.json*, *layout.htmlpage* (за замовчуванням), *null*. - **view** (string) - представлення дії. *Приклад*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` Підтримувані ключі об’єктів, якщо *[type](#type)* є *widget*: - **widget.{id}.view** (object) - ім'я файлу та класу для представлення віджетів. Замініть **{id}** значенням [id](#id) віджета (наприклад, *widget.example_clock.view*). Підтримує ключі: - **class** (string; required) - ім'я класу дії для режиму перегляду віджетів для розширення стандартного класу CControllerDashboardWidgetView. Вихідний файл класу має бути розташований у каталозі *actions*. - **view** (string) - представлення віджета. Повинен знаходитися в каталозі *views*. Якщо файл представлення *widget.view.php*, що очікується за замовчуванням, цей параметр може бути пропущений. Якщо ви використовуєте інше ім’я, вкажіть його тут. - **widget.{id}.edit** (object) - ім'я файлу для представлення конфігурації віджета. Замініть **{id}** значенням [id](#id) віджета (наприклад, *widget.example_clock.edit*). Підтримує ключі: - **class** (string; required) - назва класу дії для режиму представлення конфігурації віджета. Вихідний файл класу має бути розташований у каталозі *actions*. - **view** (string) - представлення конфігурації віджета. Повинен знаходитися в каталозі *views*. Якщо файл представлення *widget.edit.php*, що очікується за замовчуванням, цей параметр може бути пропущений. Якщо ви використовуєте інше ім’я, вкажіть його тут. *Приклад*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ``` #### Actions and alerts Define actions and operations to notify users about certain events or automatically execute remote commands. Gain access to information about generated alerts and their receivers. [Action API](/manual/api/reference/action) | [Alert API](/manual/api/reference/alert) #### Дії та сповіщення Визначення дій та операції для сповіщення користувачів про певні події або автоматичного виконання віддалених команд. Отримання доступу до інформації про згенеровані сповіщення та їх отримувачів. [API дій](/manual/api/reference/action) | [API сповіщень](/manual/api/reference/alert) # action.update # action.update ### Action view This is a reference file for defining an action view. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ```` ### Action view Це довідковий файл для створення Action view. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ```` ### Add advanced configuration settings to a configuration view In this section, you will learn how to add an expandable/collapsible *Advanced configuration* section with optional parameters, such as color, minimum and maximum values, units and the *Description* field created earlier. 1. Create a *Widget.php* file in the main widget directory *lesson_gauge_chart* to create a new class *Widget*. The *Widget* class will extend the *CWidget* base class to add/override the default widget settings (in this case - translations). JavaScript, provided below, displays the string "No data" in case of missing data. The "No data" string is present in the Zabbix UI translation files. If there are any widget constants, it is recommended to also specify them in the *Widget* class. **ui/modules/lesson_gauge_chart/Widget.php** ```php <?php namespace Modules\LessonGaugeChart; use Zabbix\Core\CWidget; class Widget extends CWidget { public const UNIT_AUTO = 0; public const UNIT_STATIC = 1; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` 2. Open *includes/WidgetForm.php* and add the new fields *Color* (color picker), *Min* (numeric field), *Max* (numeric field), and *Units* (select), and define the default color palette for the color picker, so that it can be used in the next steps. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php namespace Modules\LessonGaugeChart\Includes; use Modules\LessonGaugeChart\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldColor, CWidgetFieldMultiSelectItem, CWidgetFieldNumericBox, CWidgetFieldSelect, CWidgetFieldTextBox }; /** * Gauge chart widget form. */ class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ) ->addField( (new CWidgetFieldNumericBox('value_min', _('Min'))) ->setDefault(0) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldNumericBox('value_max', _('Max'))) ->setDefault(100) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (new CWidgetFieldSelect('value_units', _('Units'), [ Widget::UNIT_AUTO => _x('Auto', 'history source selection method'), Widget::UNIT_STATIC => _x('Static', 'history source selection method') ]))->setDefault(Widget::UNIT_AUTO) ) ->addField( (new CWidgetFieldTextBox('value_static_units')) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ); } } ``` 3. Open *views/widget.edit.php* and add the field visual components to the configuration view. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Gauge chart widget form view. * * @var CView $this * @var array $data */ $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid'])) ->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_min']) ) ->addField( new CWidgetFieldNumericBoxView($data['fields']['value_max']) ) ->addItem([ $lefty_units->getLabel(), (new CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ])) ]) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ) ->show(); ``` ::: noteclassic The *addField()* method of the *CWidgetFormView* class takes a CSS class string as the second parameter. ::: 4. Return to the dashboard, switch to the edit mode and click on the gear icon in the widget to open the widget configuration form. The widget configuration form now contains a new expandable/collapsible section *Advanced configuration*. {width="600"} 5. Expand the *Advanced configuration* section to see additional widget configuration fields. Note that the field *Color* has no color picker yet. This is because the color picker must be initialized with JavaScript, which will be added in the next section - [*Add JavaScript to the widget*](#add-javascript-to-the-widget). {width="600"} ### Додайте розширені параметри конфігурації до перегляду конфігурації У цьому розділі ви дізнаєтеся, як додати розширюваний/згортаний розділ *Розширена конфігурація* з необов’язковими параметрами, такими як колір, мінімальні та максимальні значення, одиниці вимірювання та поле *Опис*, що створене раніше. 1. Створіть файл *Widget.php* у головному каталозі віджетів *lesson_gauge_chart*, щоб створити новий клас *Widget*. Клас *Widget* розширить базовий клас *CWidget*, щоб додати/замінити параметри віджета за замовчуванням (у цьому випадку - переклади). JavaScript, наведений нижче, відображає рядок «Немає даних» у разі відсутності даних. Рядок «Немає даних» присутній у файлах перекладу інтерфейсу Zabbix. Якщо є будь-які константи віджетів, рекомендується також вказати їх у класі *Widget*. **ui/modules/lesson_gauge_chart/Widget.php** ```php <?phpnamespace Modules\LessonGaugeChart;use Zabbix\Core\CWidget;class Widget extends CWidget {public const UNIT_AUTO = 0;public const UNIT_STATIC = 1;public function getTranslationStrings(): array {return ['class.widget.js' => ['No data' => _('No data')]];}}``` 2. Відкрийте *includes/WidgetForm.php* і додайте нові поля *Color* (вибір кольору), *Min* (числове поле), *Max* (числове поле) і *Units* (вибір), а також визначте палітру кольорів за замовчуванням для засобу вибору кольорів, щоб її можна було використовувати на наступних кроках. **ui/modules/lesson_gauge_chart/includes/WidgetForm.php** ```php <?php простір імен Modules\LessonGaugeChart\Includes; використовувати Modules\LessonGaugeChart\Widget; використовувати Zabbix\Widgets\{ CWidgetField, CWidgetForm }; використовувати Zabbix\Widgets\Fields\{ CWidgetFieldColor, CWidgetFieldMultiSelectItem, CWidgetFieldNumericBox, CWidgetFieldSelect, CWidgetFieldTextBox }; /** * Форма віджета вимірювальної діаграми. */ class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; публічна функція addFields(): self { повернути $це ->addField( (новий CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( (новий CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ) ->addField( (новий CWidgetFieldNumericBox('value_min', _('Min'))) ->setDefault(0) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (новий CWidgetFieldNumericBox('value_max', _('Max'))) ->setDefault(100) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ) ->addField( (новий CWidgetFieldSelect('value_units', _('Units'), [ Віджет::UNIT_AUTO => _x('Авто', 'метод вибору джерела історії'), Віджет::UNIT_STATIC => _x('Статичний', 'метод вибору джерела історії') ]))->setDefault(Widget::UNIT_AUTO) ) ->addField( (новий CWidgetFieldTextBox('value_static_units')) ) ->addField( новий CWidgetFieldTextBox('опис', _('Опис')) ); } } ``` 3. Відкрийте *views/widget.edit.php* і додайте візуальні компоненти поля до перегляду конфігурації. **ui/modules/lesson_gauge_chart/views/widget.edit.php** ```php <?php /** * Перегляд форми віджета вимірювальної діаграми. * * @var CПереглянути $це * @var масив $data */ $lefty_units = новий CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (новий CWidgetFieldTextBoxView($data['fields']['value_static_units'])) ->setPlaceholder(_('value')) ->setWidth(ZBX_TEXTAREA_TINY_WIDTH); (новий CWidgetFormView($data)) ->addField( (новий CWidgetFieldMultiSelectItemView($data['fields']['itemid'])) ->setPopupParameter('numeric', true) ) ->addFieldset( (новий CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( новий CWidgetFieldColorView($data['fields']['chart_color']) ) ->addField( новий CWidgetFieldNumericBoxView($data['fields']['value_min']) ) ->addField( новий CWidgetFieldNumericBoxView($data['fields']['value_max']) ) ->addItem([ $lefty_units->getLabel(), (новий CFormField([ $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN), $lefty_static_units->getView() ])) ]) ->addField( новий CWidgetFieldTextBoxView($data['fields']['description']) ) ) ->показати(); ``` ::: noteclassic Метод *addField()* класу *CWidgetFormView* приймає рядок класу CSS як другий параметр. ::: 4. Поверніться на інформаційну панель, перейдіть у режим редагування та клацніть значок шестірні у віджеті, щоб відкрити форму налаштування віджета. Форма конфігурації віджета тепер містить новий розділ, який можна розширювати/згортати *Розширена конфігурація*. {width="600"} 5. Розгорніть розділ *Додаткова конфігурація*, щоб побачити додаткові поля конфігурації віджетів. Зауважте, що поле *Колір* ще не має вибору кольору. Це пояснюється тим, що засіб вибору кольорів має бути ініціалізовано за допомогою JavaScript, який буде додано в наступному розділі – [*Додати JavaScript до віджета*](#add-javascript-to-the-widget). {width="600"} ### Add CSS styles to the widget In this section you will learn how to add custom CSS styles to make the widget look more appealing. 1. For widget styles, create a new directory *css* in the *assets* directory. 2. Create a *widget.css* file in the *assets/css* directory. To style widget elements, use the selector *div.dashboard-widget-{widget id}*. To configure CSS for the whole widget, use the selector *form.dashboard-widget-{widget id}* **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart .chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart .chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart .description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2; text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart { margin-top: 8px; } ``` 3. Open *manifest.json* and add the CSS file name (*widget.css*) to the array in the *assets/css* section. This will allow the CSS styles defined in *widget.css* to load with the dashboard page. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` 4. Refresh the dashboard page to see the finished version of the widget. {width="600"} ### Додайте CSS стилі до віджету У цьому розділі ви дізнаєтеся, як додати власні стилі CSS, щоб зробити віджет більш привабливим. 1. Для стилів віджетів створіть новий каталог *css* у каталозі *assets*. 2. Створіть файл *widget.css* у каталозі *assets/css*. Щоб стилізувати елементи віджета, використовуйте селектор *div.dashboard-widget-{widget id}*. Щоб налаштувати CSS для всього віджета, використовуйте селектор *form.dashboard-widget-{widget id}* **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart .chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart .chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart .description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2;text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart { margin-top: 8px; } ``` 3. Відкрийте *manifest.json* і додайте назву файлу CSS (*widget.css*) до масиву в розділі *assets/css*. Це дозволить стилям CSS, визначеним у *widget.css*, завантажуватись зі сторінкою інформаційної панелі. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "leson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` 4. Оновіть сторінку інформаційної панелі, щоб побачити готову версію віджета. {width="600"} ## Adding a module Open *Administration→General→Modules* page and press *Scan directory*.  Locate your module in the list and activate it. To activate a module, press on the *Disabled* hyperlink - the module's state will change to *Enabled*. Press on the module name to view additional information about the module, such as author, version, or short description (if defined in the manifest). ## Додавання модуля Відкрийте сторінку *Адміністрування→Загальні→Модулі* і натисніть *Сканувати дерикторію*.  Знайдіть свій модуль у списку та активуйте його. Щоб активувати модуль, натисніть на гіперпосилання *Дезактивовано* - стан модуля зміниться на *Активовно*. Натисніть назву модуля, щоб переглянути додаткову інформацію про модуль, наприклад автора, версію або короткий опис (якщо визначено в маніфесті). ## Administration With the Zabbix API you can change administration settings of your monitoring system. ## Адміністрація За допомогою Zabbix API ви можете змінювати налаштування адміністрування вашої системи моніторингу. ##### 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. Зверніть увагу, що для активних перевірок, вузли одного кластеру повинні бути відокремлені від інших Zabbix серверів комою, а самі вузли повинні бути розділені **крапкою з комою**, наприклад: ``` ServerActive=zabbix-node-01;zabbix-node-02 ``` # alert.get # alert.get ## Alerts The Zabbix API allows you to manage the actions and alerts of your monitoring system. ## Сповіщення Zabbix API дозволяє вам керувати діями та сповіщеннями вашої системи моніторингу. ### API information Retrieve the version of the Zabbix API so that your application could use version-specific features. [API info API](/manual/api/reference/apiinfo) ### Інформація про API Отримайте версію Zabbix API, щоб ваша програма могла використовувати особливості версії. [API інформації про API](/manual/api/reference/apiinfo) # apiinfo.version # apiinfo.version #### API Tokens Manage authorization tokens. [Token API](/manual/api/reference/token) #### API Токени Керуйте токенами авторизації. [API токенів](/manual/api/reference/token) ### API versions To simplify API versioning, since Zabbix 2.0.4, the version of the API matches the version of Zabbix itself. You can use the [apiinfo.version](/manual/api/reference/apiinfo/version) method to find out the version of the API you are working with. This can be useful for adjusting your application to use version-specific features. Zabbix guarantees feature backward compatibility inside a major version. When making backward incompatible changes between major releases, Zabbix usually leaves the old features as deprecated in the next release, and only removes them in the release after that. Occasionally, Zabbix may remove features between major releases without providing any backward compatibility. It is important that you never rely on any deprecated features and migrate to newer alternatives as soon as possible. ::: notetip You can follow all the changes made to the API in the [API changelog](/manual/api/changes). ::: ### версії API Для спрощення керування версіями API, починаючи з Zabbix 2.0.4, версія API відповідає версії самого Zabbix. Ви можете використовувати [apiinfo.version](/manual/api/reference/apiinfo/version) метод пошуку версії API, з якою ви працюєте. Це може бути корисно для налаштування вашого додатка на використання специфічних для певної версії функцій. Zabbix гарантує зворотну сумісність функцій всередині мажорної версії. При внесенні зворотно несумісних змін між мажорними випусками, Zabbix зазвичай залишає старі функції застарілими(deprecated) в наступному випуску, і видаляє їх лише у подальших випусках. Іноді Zabbix може видаляти можливості між мажорними випусками без забезпечення зворотної сумісності. Важливо, щоб ви ніколи не покладалися на застарілі функції і переходили на новіші альтернативи якомога швидше. ::: notetip Ви можете стежити за всіма змінами, внесеними до API, у [Журналі змін API](/manual/api/changes). ::: # Appendix 1. Reference commentary № Додаток 1. Опорний коментар ### assets/css *assets/css* is reserved and should only contain CSS style files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "css": ["mywidget.css"] } ``` ### assets/css *assets/css* зарезервований і має містити лише файли стилю CSS. Щоб використовувати його віджетом, укажіть ці файли в *[manifest.json](/devel/modules/file_structure/manifest)*. Наприклад: ```json "assets": { "css": ["mywidget.css"] } ``` ### assets CSS styles and JavaScript files to include. *Type*: Object *Supported object keys:* - **css** (array) - CSS files to include. The files must be located in the *assets/css*. - **js** (array) - JavaScript files to include. The files must be located in the *assets/js*. *Example*: ```json "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } ``` ### assets Стилі CSS і файли JavaScript для включення. *Тип*: Object *Підтримувані ключі об’єктів:* - **css** (array) - файли CSS для включення. Файли мають бути розташовані в *assets/css*. - **js** (array) - файли JavaScript для включення. Файли мають бути розташовані в *assets/js*. *Приклад*: ```json "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } ``` ### assets/js *assets/js* directory is reserved and should only contain JavaScript files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "js": ["class.widget.js"] } ``` ### assets/js Каталог *assets/js* зарезервований і має містити лише файли JavaScript. Щоб використовувати його віджетом, укажіть ці файли в *[manifest.json](/devel/modules/file_structure/manifest)*. Наприклад: ```json "assets": { "js": ["class.widget.js"] } ``` # Assets The folder *assets* may contain any files and subfolders that do not belong to other directories. You can use it for: - JavaScript styles (must be inside *[assets/js](#assetsjs)*); - CSS styles (must be inside *[assets/css](#assetscss)*); - Images; - Fonts; - Anything else you need to include. # Assets Папка *assets* може містити будь-які файли та підпапки, які не належать до інших каталогів. Ви можете використовувати її для: - Стилі JavaScript (має бути всередині *[assets/js](#assetsjs)*); - Стилі CSS (має бути в *[assets/css](#assetscss)*); - Зображення; - Шрифти; - Усе, що вам потрібно додати. # auditlog.get # auditlog.get #### Audit log Track configuration changes each user has done. [Audit log API](/manual/api/reference/auditlog) #### Журнал аудиту Відстежуйте зміни конфігурації, внесені кожним користувачем. [API журналу аудиту](/manual/api/reference/auditlog) #### Authentication Change authentication configuration options. [Authentication API](/manual/api/reference/authentication) #### Автентифікація Зміна параметрів конфігурації автентифікації. [API автентифікації](/manual/api/reference/authentication) # authentication.get # authentication.get #### Authentication To access any data in Zabbix, you need to either: - use an existing [API token](/manual/web_interface/frontend_sections/users/api_tokens) (created in Zabbix frontend or using the [Token API](/manual/api/reference/token)); - use an authentication token obtained with the [user.login](/manual/api/reference/user/login) method. For example, if you wanted to obtain a new authentication token by logging in as a standard *Admin* user, then a JSON request would look like this: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"user.login","params":{"username":"Admin","password":"zabbix"},"id":1}' ``` If you provided the credentials correctly, the response returned by the API should contain the user authentication token: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` #### Автентифікація Щоб отримати доступ до будь-яких даних у Zabbix, вам потрібно: - використовувати існуючий [API-токен](/manual/web_interface/frontend_sections/users/api_tokens) (створений у інтерфейсі Zabbix або за допомогою [Token API](/manual/api/reference/token)); - використовувати токен автентифікації, отриманий методом [user.login](/manual/api/reference/user/login). Наприклад, якщо ви хочете отримати новий токен автентифікації, увійшовши як стандартний користувач *Admin*, то JSON-запит буде виглядати наступним чином: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"user.login","params":{"username":"Admin","password":"zabbix"},"id":1}' ``` Якщо ви правильно вказали облікові дані, відповідь, повернута API, повинна містити токен автентифікації користувача: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` # authentication.update # authentication.update #### Authorization methods #### Методи авторизації ### author Module author. The author will be displayed in the Administration section. *Type*: String *Example*: ```json "author": "John Smith" ``` ### author Автор модуля. Автор буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "author": "Лесь Подерв'янський" ``` # autoregistration.get # autoregistration.get # autoregistration.update # autoregistration.update ## Backward incompatible changes ## Зворотно несумісні зміни ##### By Zabbix cookie A *"zbx_session"* cookie is used to authorize an API request from Zabbix UI performed using JavaScript (from a module or a custom widget). ##### Файл cookie Zabbix Файл cookie *"zbx_session "* використовується для авторизації API-запиту з інтерфейсу Zabbix, що виконується за допомогою JavaScript (з модуля або кастомного віджета). ### config Default values for the module options. The object may contain any custom keys. If specified, these values will be written into the database during module registration. New variables added later will be written upon the first call. Afterwards, the variable values can only be changed directly in the database. *Type*: Object *Example*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ``` ### config Значення за замовчуванням для параметрів модуля. Об'єкт може містити будь-які спеціальні ключі. Якщо вказано, ці значення будуть записані в базу даних під час реєстрації модуля. Нові змінні, додані пізніше, будуть записані під час першого виклику. Після цього значення змінних можна змінити лише безпосередньо в базі даних. *Тип*: Object *Приклад*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ``` #### Configuration A problem can be suppressed through the **[problem update](/manual/acknowledgment#updating-problems)** window, where suppression is one of the problem update options along with commenting, changing severity, acknowledging, etc. A problem may also be unsuppressed through the same problem update window. #### Конфігурація Проблему можна сховати за допомогою вікна **[оновлення проблеми](/manual/acknowledgment#updating-problems)**, де приховування є одним із параметрів оновлення проблеми разом із коментування, зміна серйозності, підтвердження тощо. Проблема також може бути знову зроблена видимою в тому самому вікні оновлення проблеми. ##### Configuration examples For a basic example of how to set up Zabbix for monitoring VMware using the *VMware FQDN* template, see [*Monitor VMware with Zabbix*](/manual/guides/monitor_vmware). For a more detailed example of how to create a host, a low-level discovery rule, and a host prototype for monitoring VMware, see [*Setup example*](/manual/vm_monitoring/example). ##### Configuration examples For a basic example of how to set up Zabbix for monitoring VMware using the *VMware FQDN* template, see [*Monitor VMware with Zabbix*](/manual/guides/monitor_vmware). For a more detailed example of how to create a host, a low-level discovery rule, and a host prototype for monitoring VMware, see [*Setup example*](/manual/vm_monitoring/example). # configuration.export # configuration.export # configuration.import # configuration.import # configuration.importcompare # configuration.importcompare # Configuration This page describes classes that can be used to create a widget configuration view with custom configuration fields. The widget configuration view is the part of the widget that allows the user to configure widget parameters for [presentation](/presentation). # Конфігурація На цій сторінці описано класи, які можна використовувати для створення конфігурації view віджета з настроюваними полями конфігурації. View конфігурації віджета — це частина віджета, яка дозволяє користувачеві налаштовувати параметри віджета для [презентації](/presentation). ### 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 залишає за собою будь-які права на цю документацію, прямо не надані вище. ### 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 object The following objects are directly related to the `correlation` API. # Об'єкт кореляції Наступні об’єкти безпосередньо пов’язані з `correlation` API. # correlation.update # correlation.update #### Create a discovery action Create a discovery action that will link template "10001" to discovered hosts. [Request](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Створення дії виявлення Створіть дію виявлення, яка зв’яже шаблон «10001» із виявленими вузлами мережі. [Запит](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "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](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### Створити правило автореєстрації агента Створіть дію автореєстрації, яка додає хост до групи хостів «2», коли ім'я хоста містить «SRV» або метадані містять «AlmaLinux». [Запит](/manual/api#performing-requests): ```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" } ] } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` ##### Create a menu section 1. Create a *Module.php* file in the *MyAddress* directory. This file implements a new *Module* class that extends the default *CModule* class. The *Module* class will insert a new *My Address* menu section into the main menu. The *setAction()* method specifies an action to be executed upon clicking on the menu section. To start with, you can use the predefined action *userprofile.edit*, which will open the *User profile* page. In [part III](#part-iii---module-action) of this tutorial, you will learn how to create a custom action. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->add((new CMenuItem(_('My Address'))) ->setAction('userprofile.edit')); } } ``` :::noteclassic You can replace `'userprofile.edit'` with other actions, for example, `'charts.view'` (opens custom graphs), `'problems.view'` (opens *Monitoring → Problems*), or `'report.status'` (opens *System information* report). ::: 3. Refresh Zabbix frontend. There is now a new *My Address* section at the bottom of the Zabbix main menu. Click on *My Address* to open the *User profile* page. {width="600"} ##### Створення розділу меню 1. Створіть файл *Module.php* у каталозі *MyAddress*. Цей файл реалізує новий клас *Module*, який розширює стандартний клас *CModule*. Клас *Module* вставить новий розділ меню *My Address* в головне меню. Метод *setAction()* визначає дію, яка буде виконана після натискання на розділ меню. Для початку ви можете скористатися попередньо визначеною дією *userprofile.edit*, яка відкриє сторінку *Профіль користувача*. У [частині III](#part-iii---module-action) цієї інструкції ви дізнаєтесь, як створити користувацьку дію. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->add((новий CMenuItem(_('My Address'))) ->setAction('userprofile.edit')); } } ``` :::noteclassic Ви можете замінити «userprofile.edit» іншими діями, наприклад «charts.view» (відкриває користувацькі графіки), «problems.view» (відкриває *Моніторинг → Проблеми*) або `'report.status'` (відкриває звіт *Інформація про систему*). ::: 3. Оновіть інтерфейс Zabbix. Тепер у нижній частині головного меню Zabbix є новий розділ *Моя адреса*. Натисніть *Моя адреса*, щоб відкрити сторінку *Профіль користувача*. {width="600"} # Create a module (tutorial) # Створення модуля (інструкція) #### 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/alerts/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](/manual/api#performing-requests): ```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" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### Створення дії тригеру Створіть дію, яка виконуватиметься, коли тригер із хосту "10084", який містить слово "пам'ять" у своєму імені, переходить у стан проблеми. Дія матиме 4 налаштовані операції. Дія повинна спочатку надіслати повідомлення всім користувачам у групі користувачів «7» за допомогою способу сповіщення "1". Якщо подію не буде вирішено протягом 30 хвилин, буде запущено другу операцію [script](/manual/web_interface/frontend_sections/alerts/scripts#configuring-a-global-script) «5» (скрипт із областю дії "Операція дії") на всіх хостах у групі «2». Якщо подію буде вирішено, операція відновлення повідомить усіх користувачів, які отримали повідомлення про проблему. Якщо подію буде оновлено, операція підтвердження/оновлення повідомить (зі спеціальною темою та повідомленням) усіх користувачів, які отримали повідомлення про проблему. [Request](/manual/api#performing-requests): ```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" } } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` # Create a widget (tutorial) # Створення віджета (інструкція) #### Creating a new item Now, create a new [item](/manual/api/reference/item/object) on the host "Zabbix server" using the data you have obtained from the previous `host.get` request. This can be done using the [item.create](/manual/api/reference/item/create) method: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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},"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. ::: #### Створення нового елемента Тепер створіть новий [item](/manual/api/reference/item/object) на хості "Zabbix server", використовуючи дані, які ви отримали з попереднього `host.get`-запиту. Це можна зробити за допомогою методу [item.create](/manual/api/reference/item/create): ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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},"id":3}' ``` Успішна відповідь міститиме ідентифікатор щойно створеного елемента, який можна використовувати для посилання на елемент у таких запитах: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 3 } ``` ::: notetip Метод `item.create`, як і інші методи *create*, також може приймати масиви об'єктів і створювати декілька елементів одним викликом API. ::: #### Creating multiple triggers Thus, if *create methods* accept arrays, you can add multiple [triggers](/manual/api/reference/trigger/object), for example, this one: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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",}],"id":4}' ``` The 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), наприклад, цей: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"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",}],"id":4}' ``` Успішна відповідь міститиме ідентифікатори новостворених тригерів: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 4 } ``` ##### CSS styles CSS files may contain a custom attribute `theme` to define different style for a specific frontend themes. Available themes and their attribute values: - **Blue** - [theme='blue-theme'] - **Dark** - [theme='dark-theme'] - **High-contrast light** - [theme='hc-light'] - **High-contrast dark** - [theme='hc-dark'] Example: ```css .widget { background-color: red; } [theme='dark-theme'] .widget { background-color: green; } ``` ##### Стилі CSS Файли CSS можуть містити користувацький атрибут `theme` для визначення іншого стилю для певних тем інтерфейсу. Доступні теми та значення їхніх атрибутів: - **Блакитна** - [theme='blue-theme'] - **Темна** - [theme='dark-theme'] - **Висококонтрастна світла** - [theme='hc-light'] - **Висококонтрастна темна** - [theme='hc-dark'] приклад: ```css .widget { background-color: червоний; } [theme='dark-theme'] .widget { background-color: зелений; } ``` ### CWidgetField The *CWidgetField* class is a base class from which all form field classes (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList*, etc.) are inherited. Classes extending *CWidgetField* are responsible for receiving, saving, and validating widget configuration values. The following *CWidgetField* classes are available. |CWidgetField class|Database field type|Description| |----|----|----------| |*CWidgetFieldCheckBox*|int32|Single checkbox.| |*CWidgetFieldCheckBoxList*|array of int32|Multiple checkboxes under a single configuration field.| |*CWidgetFieldColor*|string|Color selection field.| |*CWidgetFieldDatePicker*|string|Date selection field.| |*CWidgetFieldHostPatternSelect*|string|Multiselect field that allows to select one or multiple hosts. Supports defining host name patterns (all matching hosts will be selected).| |*CWidgetFieldIntegerBox*|int32|Field to enter an integer. Can be used to configure minimum and maximum values.| |*CWidgetFieldLatLng*|string|Text box that allows to enter comma-separated latitude, longitude, and map zoom level.| |*CWidgetFieldMultiSelectAction*|ID|Multiselect field for selecting actions (from the list of actions defined in the *Alerts → Actions*).| |*CWidgetFieldMultiSelectGraph*|ID|Multiselect field for selecting custom graphs.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Multiselect field for selecting custom graph prototypes.| |*CWidgetFieldMultiSelectGroup*|ID|Multiselect field for selecting host groups.| |*CWidgetFieldMultiSelectHost*|ID|Multiselect field for selecting hosts.| |*CWidgetFieldMultiSelectItem*|ID|Multiselect field for selecting items.| |*CWidgetFieldMultiSelectItemPattern*|ID|Multiselect field for selecting item patterns.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Multiselect field for selecting item prototypes.| |*CWidgetFieldMultiSelectMap*|ID|Multiselect field for selecting maps.| |*CWidgetFieldMultiSelectMediaType*|ID|Multiselect field for selecting media types.| |*CWidgetFieldMultiSelectOverrideHost*|ID|Multiselect field for selecting a data source (dashboard or other widget) containing a host for which the widget can display data.| |*CWidgetFieldMultiSelectService*|ID|Multiselect field for selecting services.| |*CWidgetFieldMultiSelectSla*|ID|Multiselect field for selecting SLAs.| |*CWidgetFieldMultiSelectUser*|ID|Multiselect field for selecting users.| |*CWidgetFieldNumericBox*|string|Field to enter a float number.| |*CWidgetFieldRadioButtonList*|int32|Radio box group that consists of one or more radio boxes.| |*CWidgetFieldRangeControl*|int32|Slider to select an integer type value.| |*CWidgetFieldReference*|string|Creates a unique identifier for this widget on dashboard. It is used to reference this widget from other widgets.| |*CWidgetFieldSelect*|int32|Dropdown select box.| |*CWidgetFieldSeverities*|array of int32|*CWidgetFieldCheckBoxList* preset with trigger severities.| |*CWidgetFieldTags*|array of (string, int32, string)|Allows to configure one or more tag filter rows.| |*CWidgetFieldTextArea*|string|Text area for entering multi-line text.| |*CWidgetFieldTextBox*|string|Text box for entering single-line text.| |*CWidgetFieldTimePeriod*|array of string|Time period selecting field.| |*CWidgetFieldTimeZone*|string|Dropdown with timezones.| |*CWidgetFieldThresholds*|array of (string, string)|Allows configuring color and number pairs.| |*CWidgetFieldUrl*|string|Text box that allows to enter URLs.| The following *CWidgetField* classes have been created for particular widgets. These classes have very specific use cases, but they can also be reused if needed. |CWidgetField class|Database field type|Description| |----|----|----------| |*CWidgetFieldColumnsList*|array of (multiple mixed)|For *Top hosts* widget. Create a table with custom columns of allowed types.| |*CWidgetFieldNavTree*|string|For *Map navigation tree* widget. Replaces widget view in edit mode with the map selection tree.| ### CWidgetField Клас *CWidgetField* є базовим класом, від якого успадковуються всі класи полів форми (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList* тощо). Класи, що розширюють *CWidgetField*, відповідають за отримання, збереження та перевірку значень конфігурації віджетів. Доступні такі класи *CWidgetField*. |Клас CWidgetField|Тип поля бази даних|Опис| |----|----|----------| |*CWidgetFieldCheckBox*|int32|Один checkbox.| |*CWidgetFieldCheckBoxList*|array of int32|Кілька checkbox-ів під одним полем конфігурації.| |*CWidgetFieldColor*|string|Поле вибору кольору.| |*CWidgetFieldDatePicker*|string|Поле вибору дати.| |*CWidgetFieldHostPatternSelect*|string|Множинне поле для вибору, яке дозволяє вибрати один або кілька хостів. Підтримує визначення шаблонів імен хостів (усі відповідні хости будуть вибрані).| |*CWidgetFieldIntegerBox*|int32|Поле для введення цілого числа. Можна використовувати для налаштування мінімальних і максимальних значень.| |*CWidgetFieldLatLng*|string|Текстове поле, яке дозволяє вводити через кому широту, довготу та рівень масштабування карти.| |*CWidgetFieldMultiSelectAction*|ID|Поле множинного вибору для вибору дій (зі списку дій, визначених у *Сповіщення → Дії*).| |*CWidgetFieldMultiSelectGraph*|ID|Множинне поле для вибору власних графіків.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Множинне поле для вибору власних прототипів графів.| |*CWidgetFieldMultiSelectGroup*|ID|Поле множинного вибору для вибору груп вузлів.| |*CWidgetFieldMultiSelectHost*|ID|Множинне поле для вибору хостів.| |*CWidgetFieldMultiSelectItem*|ID|Множинне поле для вибору елементів.| |*CWidgetFieldMultiSelectItemPattern*|ID|Множинне поле для вибору шаблонів елементів.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Множинне поле для вибору прототипів елементів.| |*CWidgetFieldMultiSelectMap*|ID|Множинне поле для вибору карт.| |*CWidgetFieldMultiSelectMediaType*|ID|Множинне поле для вибору типів медіа.| |*CWidgetFieldMultiSelectOverrideHost*|ID|Поле множинного вибору для вибору джерела даних (інформаційної панелі чи іншого віджета), що містить хост, для якого віджет може відображати дані.| |*CWidgetFieldMultiSelectService*|ID|Множинне поле для вибору служб.| |*CWidgetFieldMultiSelectSla*|ID|Множинне поле для вибору SLA.| |*CWidgetFieldMultiSelectUser*|ID|Множинне поле для вибору користувачів.| |*CWidgetFieldNumericBox*|string|Поле для введення числа з плаваючою точкою.| |*CWidgetFieldRadioButtonList*|int32|Група radio box-ів , яка складається з одного або кількох radio box-ів.| |*CWidgetFieldRangeControl*|int32|Повзунок для вибору значення цілочисельного типу.| |*CWidgetFieldReference*|string|Створює унікальний ідентифікатор для цього віджета на інформаційній панелі. Він використовується для посилання на цей віджет з інших віджетів.| |*CWidgetFieldSelect*|int32|Розкривне поле вибору.| |*CWidgetFieldSeverities*|array of int32|*CWidgetFieldCheckBoxList* попередньо налаштованих із рівнями серйозності тригера.| |*CWidgetFieldTags*|array of (string, int32, string)|Дозволяє налаштувати один або кілька рядків фільтра тегів.| |*CWidgetFieldTextArea*|string|Текстова область для введення багаторядкового тексту.| |*CWidgetFieldTextBox*|string|Текстове поле для введення однорядкового тексту.| |*CWidgetFieldTimePeriod*|array of string|Поле вибору періоду часу.| |*CWidgetFieldTimeZone*|string|Випадаюче меню з часовими поясами.| |*CWidgetFieldThresholds*|array of (string, string)|Дозволяє налаштувати пари кольорів і чисел.| |*CWidgetFieldUrl*|string|Текстове поле, яке дозволяє вводити URL-адреси.| Наступні класи *CWidgetField* були створені для окремих віджетів. Ці класи мають дуже специфічні випадки використання, але їх також можна використовувати повторно, якщо це необхідно. |Клас CWidgetField|Тип поля бази даних|Опис| |----|----|----------| |*CWidgetFieldColumnsList*|array of (multiple mixed)|Для віджета *Top hosts*. Створює таблицю з настроюваними стовпцями дозволених типів.| |*CWidgetFieldNavTree*|string|Для віджета *Навігаційне дерево карти*. Замінює вигляд віджета в режимі редагування деревом вибору карти.| ### CWidgetFormView The *CWidgetFormView* class is required for specifying the presentation logic of the fields defined in the *WidgetForm* class, determining their appearance and behavior when rendered in the configuration view. The *CWidgetFormView* class supports the following methods: - *addField()* - receives an instance of the *CWidgetFieldView* class as a parameter; each [*CWidgetField*](#cwidgetfield) class, has a respective *CWidgetFieldView* class for using in the widget configuration view. - *addFieldset()* - receives an instance of the *CWidgetFieldsGroupView* class that combines fields into a collapsible container. - *addFieldsGroup()* - receives an instance of *CWidgetFormFieldsetCollapsibleView* that visually (with a border) combines fields into a group. - *includeJsFile()* - allows to add a JavaScript file to the widget configuration view. - *addJavaScript()* - allows to add inline JavaScript that will be executed as soon as the widget configuration view is loaded. The *CWidgetFormView* class should be located in the *views* directory. **views/widget.edit.php example** ```php <?php /** * My custom widget form view. * * @var CView $this * @var array $data */ use Modules\MyCustomWidget\Includes\WidgetForm; (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_custom_widget_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ]).');') ->show(); ``` ### CWidgetFormView Клас *CWidgetFormView* потрібен для визначення логіки представлення полів, визначених у класі *WidgetForm*, визначення їх зовнішнього вигляду та поведінки під час візуалізації у вікні конфігурації. Клас *CWidgetFormView* підтримує такі методи: - *addField()* - отримує в якості параметра екземпляр класу *CWidgetFieldView*; кожен клас [*CWidgetField*](#cwidgetfield) має відповідний клас *CWidgetFieldView* для використання в view конфігурації віджета. - *addFieldset()* - отримує екземпляр класу *CWidgetFieldsGroupView*, який об’єднує поля в контейнер, що згортається. - *addFieldsGroup()* - отримує екземпляр *CWidgetFormFieldsetCollapsibleView*, який візуально ((за допомогою рамки) об’єднує поля в групу. - *includeJsFile()* - дозволяє додати файл JavaScript до view конфігурації віджета. - *addJavaScript()* - дозволяє додати вбудований JavaScript, який буде виконано, щойно буде завантажено view конфігурації віджета. Клас *CWidgetFormView* має бути розташований у каталозі *views*. **views/widget.edit.php приклад** ```php <?php /** * My custom widget form view. * * @var CView $this * @var array $data */ use Modules\MyCustomWidget\Includes\WidgetForm; (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_custom_widget_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ]).');') ->show(); ``` # dashboard.create # dashboard.create # dashboard.delete # dashboard.delete # dashboard.get # dashboard.get #### Dashboards Manage dashboards and make scheduled reports based on them. [Dashboard API](/manual/api/reference/dashboard) | [Template dashboard API](/manual/api/reference/templatedashboard) | [Report API](/manual/api/reference/report) #### Інформаційні панелі (дашборди) Керуйте інформаційними панелями та створюйте на їх основі планові звіти. [API інформаційної панелі](/manual/api/reference/dashboard) | [Шаблон інформаційної панелі API](/manual/api/reference/templatedashboard) | [Репорт API](/manual/api/reference/report) # dashboard.update # dashboard.update ## Data collection The Zabbix API allows you to manage the configuration of your monitoring system. ## Збір даних Zabbix API дозволяє вам керувати конфігурацією вашої системи моніторингу. # dcheck.get # dcheck.get #### Delete multiple actions Delete two actions. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### Видалити кілька дій Видалити дві дії. [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` ### 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/users/user_roles) for more information. ::: ### Опис `integer/array action.get(object parameters)` Метод дозволяє отримати дії за заданими параметрами. ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача] /manual/web_interface/frontend_sections/users/user_roles) для отримання додаткової інформації. ::: ### description Module description. *Type*: String *Example*: ```json "description": "This is a clock widget." ``` ### description Опис модуля. *Тип*: String *Приклад*: ```json "description": "Це віджет годинника." ``` ### 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/users/user_roles) for more information. ::: ### Опис `object action.create(object/array actions)` Цей метод дозволяє створювати нові дії. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/users/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/users/user_roles) for more information. ::: ### Опис `object action.delete(array actionIds) Цей спосіб дозволяє видаляти дії. ::: noteclassic Цей метод доступний лише для користувачів типу *Admin* і *Super admin*. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача (/manual/web_interface/frontend_sections/users/user_roles) для отримання додаткової інформації. ::: ## 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\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE} ## ОПИС **zabbix\_proxy** — це демон, який збирає дані моніторингу з пристроїв і надсилає їх на сервер Zabbix. [ ]{#lbAE} ## DESCRIPTION **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE} ## ОПИС **zabbix\_sender** — це утиліта командного рядка для надсилання даних моніторингу на сервер або проксі Zabbix. На сервері Zabbix має бути створений елемент типу **Zabbix trapper** з відповідним ключем. Зауважте, що вхідні значення прийматимуться лише від хостів, указаних у полі **Allowed hosts** для цього елемента. [ ]{#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} # dhost.get # dhost.get ### Disabling HA cluster 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 з активного основного сервера - перезапустіть основний сервер (він запуститься в автономному режимі) # discoveryrule.create # discoveryrule.create # discoveryrule.delete # discoveryrule.delete # discoveryrule.get # discoveryrule.get # discoveryrule.update # discoveryrule.update #### 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/dashboards##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. #### Відображення На основі інформації про підтвердження можна налаштувати спосіб відображення кількості проблем на інформаційній панелі чи картах. Для цього вам потрібно зробити вибір у параметрі *Відображення проблеми*, доступному як у [map configuration](/manual/config/visualization/maps/map#creating_a_map), так і в *Проблеми за ступенем тяжкості* [віджеті панелі інструментів]( /manual/web_interface/frontend_sections/dashboards##adding_widgets). Можна відобразити кількість усіх проблем, кількість непідтверджених проблем окремо від загальної чи тільки кількість непідтверджених проблем. На основі інформації про оновлення проблеми (підтвердження тощо) можна налаштувати операції оновлення – надіслати повідомлення або виконати віддалені команди. #### Display Once suppressed the problem is marked by a blinking  suppression icon in the *Info* column, before being hidden. The suppression icon is blinking while the suppression task is in the waiting list. Once the task manager has suppressed the problem, the icon will stop blinking. If the suppression icon keeps blinking for a long time, this may indicate a server problem, for example, if the server is down and the task manager cannot complete the task. The same logic applies to unsuppression. In the short period after the task is submitted and the server has not completed it, the unsuppression icon is blinking. A suppressed problem may be both hidden or shown, depending on the problem filter/widget settings. When shown in the problem list, a suppressed problem is marked by the suppression icon and suppression details are shown on mouseover:  Suppression details are also displayed in a popup when positioning the mouse on the suppression icon in the *Actions* column. #### Відображення Після приховування проблема позначається блиманням  значка приховування в стовпці *Інформація*, перш ніж його приховати. Значок придушення блимає, поки завдання придушення знаходиться в списку очікування. Після того, як диспетчер завдань вирішить проблему, значок перестане блимати. Якщо піктограма придушення продовжує блимати протягом тривалого часу, це може вказувати на проблему з сервером, наприклад, якщо сервер не працює і диспетчер завдань не може завершити завдання. Така ж логіка застосовується і до зняття приховування. Протягом короткого періоду після того, як завдання було надіслано, але сервер не встиг його виконати, піктограма зняття приховування блимає. Прихована проблема може бути як прихованою, так і відображеною, залежно від налаштувань фільтра проблеми/віджета. При відображенні у списку проблем прихована проблема позначається піктограмою придушення та деталі придушення показуються при наведенні миші:  Деталі придушення також відображаються у спливаючому вікні, якщо навести курсор миші на придушення у стовпці *Дії*. # drule.create # drule.create # drule.delete # drule.delete # drule.get # drule.get # drule.update # drule.update # dservice.get # dservice.get ### Enabling high availability ### Увімкнення високої доступності #### Error handling Up to the present moment, everything you have tried has worked fine. But what would happen if you tried making an incorrect call to the API? Try to create another host by calling [host.create](/manual/api/reference/host/create) but omitting the mandatory `groups` parameter: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.create","params":{"host":"Linux server","interfaces":[{"type":1,"main":1,"useip":1,"ip":"192.168.3.1","dns":"","port":"10050"}]},"id":7}' ``` The response will then contain an error message: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` If an error has occurred, instead of the `result` property, the response object will contain the `error` property with the following data: - `code` - an error code; - `message` - a short error summary; - `data` - a more detailed error message. Errors can occur in various cases, such as, using incorrect input values, a session timeout or trying to access non-existing objects. Your application should be able to gracefully handle these kinds of errors. #### Обробка помилок До цього моменту все, що ви спробували, працювало нормально. Але що станеться, якщо ви спробуєте зробити некоректний виклик API? Спробуйте створити інший хост, викликавши [host.create](/manual/api/reference/host/create), але опустивши обов'язковий параметр `groups`: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"host.create","params":{"host":"Linux server","interfaces":[{"type":1,"main":1,"useip":1,"ip":"192.168.3.1","dns":"","port":"10050"}]},"id":7}' ``` Тоді відповідь міститиме повідомлення про помилку: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "No groups for host \"Linux server\"." }, "id": 7 } ``` Якщо сталася помилка, замість властивості `result` об'єкт відповіді буде містити властивість `error` з наступними даними: - `code` - код помилки; - `message` - короткий опис помилки; - `data` - більш детальне повідомлення про помилку. Помилки можуть виникати у різних випадках, наприклад, при використанні неправильних вхідних даних, таймауті сеансу або спробі отримати доступ до неіснуючих об'єктів. Ваша програма повинна вміти коректно обробляти такі помилки. # event.acknowledge # event.acknowledge #### Event correlation Create custom event correlation rules. [Correlation API](/manual/api/reference/correlation) #### Кореляція подій Створення власних правил кореляції подій. [API кореляції](/manual/api/reference/correlation) # event.get # event.get #### Events Retrieve events generated by triggers, network discovery and other Zabbix systems for more flexible situation management or third-party tool integration. [Event API](/manual/api/reference/event) #### Події Отримувати події, створені тригерами, виявленням мережі та іншими системами Zabbix для більш гнучкого управління ситуацією або інтеграцією в сторонні інструменти. [Event API](/manual/api/reference/event) ### Event tag The event tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| ### Тег події Об'єкт тегу події має такі властивості. |Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |тег|рядок|Назва тегу події.| |значення|рядок|Значення тегу події.| ### Example ### Приклади ##### 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(/host/web.test.fail[сценарій])<>0 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ##### 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 Щоб створити тригер «Помилка веб-сценарію» з корисним описом проблеми в назві тригера, ви можете визначити тригер із назвою: Помилка веб-сценарію "Сценарій": {ITEM.VALUE} і тригерний вираз: length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ##### 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(/host/web.test.in[Scenario,,bps])<10000 Обов’язково замініть «Сценарій» справжньою назвою сценарію. ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади ### Examples ### Приклади #### Examples #### Приклади # Examples This section provides files of sample modules and widgets, which you can use as a base for your custom modules. To use a module: 1. Download the ZIP archive. 2. Unpack the content into a separate directory inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). 3. Register the module in Zabbix frontend. # Приклади У цьому розділі представлені файли зразків модулів та віджетів, які ви можете використовувати як основу для власних модулів. Щоб використовувати модуль: 1. Завантажте ZIP-архів. 2. Розпакуйте вміст в окремий підкаталог у каталозі з *модулями* web-серверу Zabbix (наприклад */zabbix/ui/modules*). 3. Зареєструйте модуль у інтерфейсі Zabbix. ## 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 "Monitored Host" -k mysql.queries -o 342.45**\ Надішліть **342.45** як значення для елемента **mysql.queries** хосту **Monitored Host** за допомогою сервера 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 server" 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 "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**\ Надішліть **342.45** як значення для елемента **mysql.queries** у хості **Monitored Host** на сервер з IP-адресою **192.168.1.113** за допомогою TLS із сертифікатом. **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**\ Надішліть **342.45** як значення для елемента **mysql.queries** у хості **Monitored Host** на сервер з IP-адресою **192.168.1.113** за допомогою TLS зі спільним ключем (PSK). [ ]{#lbAI} ### Example workflow The following section will walk you through some examples of usage in a greater detail. ### Приклад робочого процесу У наступному розділі ми розглянемо деякі приклади використання більш детально. ## 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} #### Export and import Export and import Zabbix configuration data for configuration backups, migration or large-scale configuration updates. [Configuration API](/manual/api/reference/configuration) #### Експорт та імпорт Експорт та імпорт даних конфігурації Zabbix для резервних копій конфігурації, міграція або масштабні оновлення конфігурації. [API конфігурації](/manual/api/reference/configuration) ##### Export format Data can be exported using the Zabbix web frontend or [Zabbix API](/manual/api/reference/configuration). Supported export formats are YAML, XML and JSON. ##### Формат експорту Дані можна експортувати за допомогою веб-інтерфейсу Zabbix або [Zabbix API](/manual/api/reference/configuration). Підтримувані формати експорту: YAML, XML і JSON. #### Exporting To export templates, do the following: 1. Go to *Data collection* → *Templates*. 2. Mark the checkboxes of the templates to export. 3. Click *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. #### Експорт Щоб експортувати шаблони, виконайте такі дії: 1. Перейдіть до *Збір даних* → *Шаблони*. 2. Позначте шаблони для експорту. 3. Натисніть *Експорт* під списком.  Залежно від обраного формату шаблони експортуються в локальний файл із назвою за замовчуванням: - `zabbix_export_templates.yaml` - в експорті YAML (параметр експорту за замовчуванням); - `zabbix_export_templates.xml` - в експорті XML; - `zabbix_export_templates.json` - в експорті JSON. ### 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 ``` ## 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 agent 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} ### Further reading Now, you have enough knowledge to start working with the Zabbix API, however, do not stop here. For further reading you are advised to have a look at the [list of available APIs](/manual/api/reference). ### Більше інформації Тепер у вас достатньо знань, щоб почати працювати з Zabbix API, однак не зупиняйтеся на цьому. Для подальшого читання радимо переглянути [список доступних API](/manual/api/reference). #### General Change certain global configuration options. [Autoregistration API](/manual/api/reference/autoregistration) | [Icon map API](/manual/api/reference/iconmap) | [Image API](/manual/api/reference/image) | [Settings API](/manual/api/reference/settings) | [Regular expression API](/manual/api/reference/regexp) | [Module API](/manual/api/reference/module) | [Connector API](/manual/api/reference/connector) #### Загальне Зміна певних параметрів глобальної конфігурації. [API автореєстрації](/manual/api/reference/autoregistration) | [API карти значків](/manual/api/reference/iconmap) | [API образів](/manual/api/reference/image) | [API налаштувань](/manual/api/reference/settings) | [API регулярного виразу](/manual/api/reference/regexp) | [API модуля](/manual/api/reference/module) | [API конектора](/manual/api/reference/connector) # graph.create # graph.create # graph.delete # graph.delete # graph.get # graph.get # graphitem.get # graphitem.get # graphprototype.create # graphprototype.create # graphprototype.delete # graphprototype.delete # graphprototype.get # graphprototype.get # graphprototype.update # graphprototype.update #### Graphs Edit graphs or separate graph items for better presentation of the gathered data. [Graph API](/manual/api/reference/graph) | [Graph item API](/manual/api/reference/graphitem) #### Графіки Редагування графіків або відокремлення їх елементів даних для кращого представлення зібраних даних. [API графіків](/manual/api/reference/graph) | [API елементів даних графіків ](/manual/api/reference/graphitem) # graph.update # graph.update # hanode.get # hanode.get #### 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) # history.clear # history.clear # 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 історії](/manual/api/reference/history) # host.create # host.create # host.delete # host.delete # host.get # host.get # hostgroup.create # hostgroup.create # hostgroup.delete # hostgroup.delete # hostgroup.get # hostgroup.get # hostgroup.massadd # hostgroup.massadd # hostgroup.massremove # hostgroup.massremove # hostgroup.massupdate # hostgroup.massupdate # hostgroup.update # hostgroup.update # hostinterface.create # hostinterface.create # hostinterface.delete # hostinterface.delete # hostinterface.get # hostinterface.get # hostinterface.massadd # hostinterface.massadd # hostinterface.massremove # hostinterface.massremove # hostinterface.replacehostinterfaces # hostinterface.replacehostinterfaces # hostinterface.update # hostinterface.update # host.massadd # host.massadd # host.massremove # host.massremove # host.massupdate # host.massupdate # hostprototype.create # hostprototype.create # hostprototype.delete # hostprototype.delete # hostprototype.get # hostprototype.get # hostprototype.update # hostprototype.update #### 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) #### Хости та групи хостів Керуйте групами хостів, хостами та всім, що з ними пов’язано, включаючи інтерфейси хостів, макроси хостів та періоди обслуговування. [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) # host.update # host.update #### Housekeeping Configure housekeeping. [Housekeeping API](/manual/api/reference/housekeeping) #### Housekeeping Налаштування Housekeeping-у (видалення старих записів). [Housekeeping API](/manual/api/reference/housekeeping) # housekeeping.get # housekeeping.get # housekeeping.update # housekeeping.update ### How modules work - An enabled module is launched on each HTTP request, before executing the action code. - The module will register new actions or redefine the existing ones. - The module will add new frontend sections and remove or redefine the existing ones. - The module will hook to frontend events like onBeforeAction and onTerminate, if needed. - The requested action is finally executed by running the action code - either the default one, or module-defined. ### Як працюють модулі - Увімкнений модуль запускається під час кожного HTTP запиту перед виконанням коду дії. - Модуль буде реєструвати нові дії або перевизначати існуючі. - Модуль додасть нові розділи інтерфейсу та видалить або перевизначить існуючі. - Якщо потрібно, модуль підключатиметься до зовнішніх подій, таких як onBeforeAction і onTerminate. - Запитувана дія остаточно виконується шляхом запуску коду дії - стандартного або визначеного модулем. # httptest.create # httptest.create # httptest.delete # httptest.delete # httptest.get # httptest.get # httptest.update # httptest.update # iconmap.create # iconmap.create # iconmap.delete # iconmap.delete # iconmap.get # iconmap.get # iconmap.update # iconmap.update ### id Module ID. Must be unique. To avoid future naming conflicts, it is recommended to use prefix for modules (author or company name, or any other). For example, if a module is an example for lessons and the module name is "My module", then the ID will be "example_my_module". *Type*: String *Example*: ```json "id": "example_my_module" ``` ### id ID модуля. Повинно бути унікальним. Щоб уникнути майбутніх конфліктів іменування, рекомендується використовувати префікс для модулів (назва автора, компанії чи будь-який інший). Наприклад, якщо модуль є прикладом для уроків, а назва модуля – «Мій модуль», тоді ідентифікатор буде «example_my_module». *Тип*: String *Приклад*: ```json "id": "example_my_module" ``` # image.create # image.create # image.delete # image.delete # image.get # image.get # 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. ## 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) ------------------------------------------------------------------------ Цей документ створено о 21:23:35 GMT, 18 березня 2020 року ## 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) ------------------------------------------------------------------------ Цей документ створено о 12:58:30 GMT, 11 червня 2021 року ## 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) ------------------------------------------------------------------------ Цей документ створено: 08:42:39 GMT, 11 червня 2021 року ## 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) -------------------------------------------------- ---------------------- Цей документ створено о 14:07:57 GMT, 22 листопада 2021 року ## 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) -------------------------------------------------- ---------------------- Цей документ створено о 16:12:22 GMT, 04 вересня 2020 року ## 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) -------------------------------------------------- ---------------------- Цей документ створено: 20:50:13 GMT, 22 листопада 2021 р. # item.create # item.create # item.delete # item.delete # item.get # item.get # itemprototype.create # itemprototype.create # itemprototype.delete # itemprototype.delete # itemprototype.get # itemprototype.get # itemprototype.update # itemprototype.update #### Items Define items to monitor. [Item API](/manual/api/reference/item) #### Елементи даних Визначення елементів даних для моніторингу. [API елементів даних](/manual/api/reference/item) # item.update # item.update ### JavaScript A JavaScript class can be used to add dynamic behavior and interactivity to the widget configuration view. For example, you can initialize a color picker, defined in the [*CWidgetFormView*](#cwidgetformview) class. The JavaScript class should be loaded with the form, therefore it should be referenced in the [*CWidgetFormView*](#cwidgetformview) class by using the methods *includeJsFile()* and *addJavaScript()*. In the example below, a singleton class instance is immediately created and stored under the *window.my_custom_widget_form* name. Thus, opening the form for the second time will re-create the instance. The JavaScript class should be located in the *views* directory. **views/widget.edit.js.php example** ```php <?php use Modules\MyCustomWidget\Widget; ?> window.my_custom_widget_form = new class { init({color_palette}) { colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } } }; ``` ### JavaScript Клас JavaScript можна використовувати для додавання динамічної поведінки та інтерактивності до конфігурації view віджета. Наприклад, ви можете ініціалізувати засіб вибору кольорів, визначений у класі [*CWidgetFormView*](#cwidgetformview). Клас JavaScript має бути завантажений разом із формою, тому на нього слід посилатися в класі [*CWidgetFormView*](#cwidgetformview) за допомогою методів *includeJsFile()* і *addJavaScript()*. У наведеному нижче прикладі екземпляр класу singleton одразу створюється та зберігається під назвою *window.my_custom_widget_form*. Таким чином, відкриття форми вдруге призведе до повторного створення екземпляра. Клас JavaScript має бути розташований у каталозі *views*. **views/widget.edit.js.php приклад** ```php <?php use Modules\MyCustomWidget\Widget; ?> window.my_custom_widget_form = new class { init({color_palette}) { colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } } }; ``` ### JavaScript The JavaScript class is responsible for determining widget behavior, such as updating widget data, resizing the widget, displaying widget elements, etc. All JavaScript operations use and/or extend the base JavaScript class of all dashboard widgets - *CWidget*. The *CWidget* class contains a set of methods with the default implementation for widget behavior. Depending on widget complexity, these methods can be utilized as is or extended. The *CWidget* class contains the following methods: - Methods that define widget lifecycle: *onInitialize()*, *onStart()*, *onActivate()*, *onDeactivate()*, *onDestroy()*, *onEdit()*. - Methods that handle updating and displaying widget data: *promiseUpdate()*, *getUpdateRequestData()*, *processUpdateResponse(response)*, *processUpdateErrorResponse(error)*, *setContents(response)*. - Methods that modify widget appearance: *onResize()*, *hasPadding()*. The JavaScript class should be located in the *assets/js* directory and specified in the [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) parameter in the *manifest.json* file. ### JavaScript Клас JavaScript відповідає за визначення поведінки віджетів, наприклад оновлення даних віджетів, зміну розміру віджетів, відображення елементів віджетів тощо. Усі операції JavaScript використовують і/або розширюють базовий клас JavaScript усіх віджетів інформаційної панелі - *CWidget*. Клас *CWidget* містить набір методів із реалізацією за замовчуванням для поведінки віджетів. Залежно від складності віджета, ці методи можна використовувати як є або розширити. Клас *CWidget* містить такі методи: - Методи, що визначають життєвий цикл віджета: *onInitialize()*, *onStart()*, *onActivate()*, *onDeactivate()*, *onDestroy()*, *onEdit()*. - Методи, які обробляють оновлення та відображення даних віджетів: *promiseUpdate()*, *getUpdateRequestData()*, *processUpdateResponse(response)*, *processUpdateErrorResponse(error)*, *setContents(response)*. - Методи, які змінюють зовнішній вигляд віджета: *onResize()*, *hasPadding()*. Клас JavaScript має розташовуватися в каталозі *assets/js* і вказуватися в параметрі [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) у *manifest.json* файл. ##### Lifecycle methods The widget lifecycle methods are invoked by the dashboard, and at different stages of the widget's lifecycle during its existence within the dashboard. ##### Методи життєвого циклу Методи життєвого циклу віджета викликаються інформаційною панеллю та на різних етапах життєвого циклу віджета під час його існування на інформаційній панелі. #### 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, де процесори розподіляються нерівномірно між вузлами NUMA. Якщо логічні ЦП розподілені нерівномірно, показники продуктивності ЦП можуть бути недоступні для деяких ЦП. Наприклад, якщо є 72 логічних ЦП з 2 вузлами NUMA, обидва вузли повинні мати по 36 ЦП кожен. ##### 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). ### 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. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### Цілі контролю рівня журналу *process-type* Всі процеси вказаного типу (активні перевірки, колектор, слухач) *process-type,N* Тип та номер процесу (наприклад, listener,3) *pid* Ідентифікатор процесу, до 65535. Для більших значень вкажіть ціль у вигляді "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Вивести відомі елементи і вийти. Для кожного елемента використовуються або загальні значення за замовчуванням або специфічні значення за замовчуванням для тестування. Ці значення за замовчуванням перераховано у квадратних дужках як ключові параметри елемента. Значення, що повертаються взято у квадратні дужки і додано префікс з типом значення, що повертається значення, відокремленого символом труби. Для параметрів користувача тип завжди **t**, оскільки агент не може визначити всі можливі значення, що повертаються. Елементи, відображені як робочі, не гарантують роботу з сервера Zabbix або zabbix\_get при запиті до запущеного демона агента, оскільки дозволи або середовище може відрізнятися. Типи значень, що повертаються: d Число з десятковою частиною. m Не підтримується. Це може бути спричинено запитом елемента, який працює лише в активному режимі, наприклад, елемент моніторингу журналу або елемент, який вимагає декілька зібраних значень. Проблеми з правами доступу або неправильні параметри користувача також можуть призвести до стану "не підтримується". s Текст. Максимальна довжина не обмежена. t Текст. Те саме, що і **s**. u Ціле число без знаку. **-t**, **--test** *item-key* Перевірити один елемент і вийти. Дивіться **--print** для опису виводу. **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести інформацію про версію і завершити роботу. [ ]{#lbAH} ### Log level control targets *process-type* All processes of specified type (availability manager, browser poller, configuration syncer, data sender, discovery manager, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, odbc poller, poller, agent poller, http agent poller, snmp poller, preprocessing manager, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector) *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, discovery manager, history syncer, housekeeper, http poller, preprocessing manager, icmp pinger, ipmi manager, ipmi poller, java poller, poller, agent poller, http agent poller, snmp poller, 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) **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### Цілі контролю рівня журналу *process-type* Усі процеси вказаного типу (availability manager, browser poller, configuration syncer, data sender, discovery manager, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, odbc poller, poller, agent poller, http agent poller, snmp poller, preprocessing manager, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector) *process-type,N* Тип і номер процесу (наприклад, poller, 3) *pid* Ідентифікатор процесу, до 65535. Для більших значень укажіть ціль як "process-type,N" Цілі контролю рівня профілювання *process-type* Усі процеси вказаного типу (configuration syncer, data sender, discovery manager, history syncer, housekeeper, http poller, preprocessing manager, icmp pinger, ipmi manager, ipmi poller, java poller, poller, agent poller, http agent poller, snmp poller, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector, history poller, availability manager, odbc poller) *process-type,N* Тип і номер процесу (наприклад, history syncer,1) *pid* Ідентифікатор процесу, до 65535. Для більших значень укажіть ціль як "process-type,N" *scope* Разом з типом процесу можно вказати область профілювання (rwlock, mutex, processing) (наприклад, history syncer,1,processing) **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Вивести інформацію про версію та вийти. [ ]{#lbAH} #### Low-level discovery Configure low-level discovery rules as well as item, trigger and graph prototypes to monitor dynamic entities. [LLD rule API](/manual/api/reference/discoveryrule) | [Item prototype API](/manual/api/reference/itemprototype) | [Trigger prototype API](/manual/api/reference/triggerprototype) | [Graph prototype API](/manual/api/reference/graphprototype) | [Host prototype API](/manual/api/reference/hostprototype) #### Низькорівневе виявлення Налаштування правил низькорівневого виявлення, а також прототипів елементів даних, тригерів і графіків для моніторингу динамічних сутностей. [API правил LLD](/manual/api/reference/discoveryrule) | [API Прототипа елемента даних](/manual/api/reference/itemprototype) | [API Прототипа тригера](/manual/api/reference/triggerprototype) | [API Прототипа графа](/manual/api/reference/graphprototype) | [API Прототипа хоста](/manual/api/reference/hostprototype) #### Macros Manage macros. [User macro API](/manual/api/reference/usermacro) #### Макроси Керуйте макросами. [API користувацьких макросів](/manual/api/reference/usermacro) # maintenance.create # maintenance.create # maintenance.delete # maintenance.delete # maintenance.get # maintenance.get # manifest.json Any module needs the manifest.json file. The file must be located in the module's primary directory (for example, *zabbix/ui/modules/module_name/manifest.json*). As a bare minimum, manifest.json should specify these fields: ```json { "manifest_version": 2.0, "id": "my_ip_address", "name": "My IP Address", "namespace": "MyIPAddress", "version": "1.0" } ``` Parameters supported in **manifest.json** (press on the parameter name for a detailed description): |Parameter |Description |Required | |--|--------|--| |[manifest_version](#manifest-version)|Manifest version of the module.| Yes | |[id](#id) |Unique module ID. |^| |[name](#name) |Module name that will be displayed in the Administration section. |^| |[namespace](#namespace) |PHP namespace for module classes.|^| |[version](#version) |Module version. |^| |[type](#type) |Type of the module. For widget must be set to *widget* | Yes for widgets, otherwise no | |[widget](#widget) |Widget configuration. Used for widgets only. |^| |[actions](#actions) | Actions to register with the module. |^| |[assets](#assets) | CSS styles and JavaScript files to include. | No | |[author](#author) |Module author. |^| |[config](#config) |Default values for custom module options. |^| |[description](#description) |Module description.|^| |[url](#url) |A link to the module description. |^| # manifest.json Для будь-якого модуля потрібний файл manifest.json. Файл має бути розташований у основному каталозі модуля (наприклад *zabbix/ui/modules/module_name/manifest.json*). Як мінімум, у файлі manifest.json мають бути вказані такі поля: ```json { "manifest_version": 2.0, "id": "my_ip_address", "name": "My IP Address", "namespace": "MyIPAddress", "version": "1.0" } ``` Параметри, які підтримуються в **manifest.json** (натисніть назву параметра для детального опису): |Параметр |Опис |Обов'язковий | |--|--------|--| |[manifest_version](#manifest-version)|Версія маніфесту модуля.| Так | |[id](#id) |Унікальний ідентифікатор модуля. |^| |[name](#name) |Назва модуля, що відображатиметься в розділі Адміністрування. |^| |[namespace](#namespace) |Простір імен PHP для класів модулів.|^| |[version](#version) |Версія модуля. |^| |[type](#type) |Тип модуля. Для віджета потрібно встановити *widget* | Так для віджетів, ні для решти | |[widget](#widget) |Конфігурація віджета. Використовується лише для віджетів. |^| |[actions](#actions) | Дії для реєстрації в модулі. |^| |[assets](#assets) | Стилі CSS і файли JavaScript для включення. | Ні | |[author](#author) |Автор модуля. |^| |[config](#config) |Значення за замовчуванням для користувацьких параметрів модуля. |^| |[description](#description) |Опис модуля.|^| |[url](#url) |Посилання на опис модуля. |^| ### manifest_version {#manifest-version} Manifest version of the module. Currently, supported version is **2.0**. *Type*: Double *Example*: ```json "manifest_version": 2.0 ``` ### manifest_version {#manifest-version} Версія маніфесту модуля. Наразі підтримується версія **2.0**. *Тип*: Double *Приклад*: ```json "manifest_version": 2.0 ``` #### Maps Configure maps to create detailed dynamic representations of your IT infrastructure. [Map API](/manual/api/reference/map) #### Карти Налаштуйте карти для створення детальних динамічних представлень вашої ІТ інфраструктури. [API карти](/manual/api/reference/map) ##### 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. #### Media types Configure media types and multiple ways users will receive alerts. [Media type API](/manual/api/reference/mediatype) #### Способи оповіщень Налаштування способів оповіщень та способів, якими користувачі отримуватимуть сповіщення [API способів оповіщень](/manual/api/reference/mediatype) # 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, і допоможе вам зорієнтуватися в доступних класах і методах. ### Module example - When creating a host group, grant read permissions to configured user groups - [hg_auto_perm.zip](/../assets/en/devel/modules/examples/hg_auto_perm.zip) ### Приклад модуля - Під час створення групи хостів надайте дозволи на читання налаштованим групам користувачів - [hg_auto_perm.zip](/../assets/en/devel/modules/examples/hg_auto_perm.zip) # Module file structure All code related to a module is stored in a single directory inside the **modules** directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). # Структура файлів модуля Весь код, пов’язаний з модулем, зберігається в одному каталозі всередині каталогу **modules** вашої установки web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). ### Module file tree ````yaml 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 assets/ Any additional files to be used in views. Must be specified in manifest.json. js/ JavaScript files used in views. example.something.view.js.php css/ CSS files used in views. example.something.css image.png Images used in views. example.something.file Any file for using in views. ```` ### Дерево файлів модуля ````yaml example_module_directory/ (обов’язково) manifest.json (обов’язково) Метадані та визначення дії. Module.php Ініціалізація модуля та обробка подій. actions/ Файли управління діями. SomethingView.php SomethingCreate.php SomethingDelete.php data_export/ ExportAsXml.php ExportAsExcel.php views/ view файли. example.something.view.php example.something.delete.php assets/ Будь-які додаткові файли для використання у view. Необхідно вказати в manifest.json. js/файли JavaScript, які використовуються у view. example.something.view.js.php css/ файли CSS, які використовуються у view. example.something.css image.png Зображення, що використовуються у view. example.something.file Будь-який файл для використання у view. ```` # Modules # Модулі ## Monitoring The Zabbix API allows you to access history and other data gathered during monitoring. ## Моніторинг Zabbix API дозволяє отримати доступ до історії та інших зібраних даних під час моніторингу. 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. 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. ### MySQL Export and import must be performed in tmux/screen to ensure that the session isn't dropped. See also: [Important notes](#important-notes) ### MySQL Експорт і імпорт потрібно виконувати в tmux/screen, щоб гарантувати, що сеанс не буде перервано. Дивіться також: [Важливі примітки](#important-notes) #### MySQL 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*.\ Relevant for at least MySQL version 5.1.61 #### MySQL Якщо значення містить символ, відмінний від ASCII, у кодуванні, відмінному від UTF8, цей символ і наступні символи буде відкинуто, коли база даних збереже це значення. На адресу не надходитимуть жодні попереджувальні повідомлення *zabbix\_server.log*.\ Актуально принаймні для версії MySQL 5.1.61 ### name Module name that will be displayed in the Administration section. *Type*: String *Example*: ```json "name": "My module" ``` ### name Назва модуля, яка буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "name": "Мій модуль" ``` ### namespace PHP namespace for module classes. *Type*: String *Example*: ```json "namespace": "ClockWidget" ``` ### namespace Простір імен PHP для класів модулів. *Тип*: String *Приклад*: ```json "namespace": "ClockWidget" ``` ## 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 JS [ ]{#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} #### Network discovery Manage network-level discovery rules to automatically find and monitor new hosts. Gain full access to information about discovered services and hosts. [Discovery rule API](/manual/api/reference/drule) | [Discovery check API](/manual/api/reference/dcheck) | [Discovered host API](/manual/api/reference/dhost) | [Discovered service API](/manual/api/reference/dservice) #### Виявлення мережі Керуйте правилами виявлення на рівні мережі для автоматичного пошуку та моніторингу нових вузлів. Отримайте повний доступ до інформації про виявлені сервіси та вузли. [API правил виявлення](/manual/api/reference/drule) | [API Перевірка виявленнь](/manual/api/reference/dcheck) | [API Виявлень вузла](/manual/api/reference/dhost) | [API Виявлень служб](/manual/api/reference/dservice) ### Notation ### Позначення ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix агент на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix proxy in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix проксі на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix server in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. Examples of running Zabbix server with command line parameters: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний *config-file* замість стандартного. **-f**, **--foreground** Запустіть Zabbix сервер на передньому плані. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. **-T**, **--test-config** Перевірити файл конфігурації та вийти. *-h**, **--help** Відобразити цю довідку і вийти. **-V**, **--version** Вивести версію і вийти. Приклади запуску сервера Zabbix з параметрами командного рядка: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовуйте альтернативний файл конфігурації *config-file* замість стандартного. **-R**, **--runtime-control** *runtime-option* Виконуйте адміністративні функції згідно з *runtime-option*. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## ПАРАМЕТРИ **-c**, **--config** *config-file* Використовувати альтернативний конфігураційний файл *config-file* замість стандартного. **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Вивести інформацію про версію та вийдіть. [ ]{#lbAF} #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| ## Other changes and bug fixes ### Інші зміни та виправлення помилок #### Overview By default, Zabbix provides a number of predefined themes. You may follow the step-by-step procedure provided here in order to create your own. Feel free to share the result of your work with Zabbix community if you created something nice. #### Огляд За замовчуванням Zabbix надає кілька попередньо визначених тем. Ви можете виконати наведену тут покрокову процедуру, щоб створити свій власний. Не соромтеся поділитися результатом своєї роботи зі спільнотою Zabbix, якщо ви створили щось хороше. ### Overview Custom loadable plugins extend Zabbix agent 2 functionality. They are compiled separately, but use a package shared with Zabbix agent 2. Each plugin is a *Go* package that defines the structure and implements one or several plugin interfaces (*Exporter*, *Configurator*, *Runner*). Jump to: - [Write your first plugin](/devel/plugins/how_to) - [Plugin interfaces](/devel/plugins/interfaces) See also: - [Example plugin for Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) ### Connection diagram Zabbix agent 2 connects bidirectionally to the plugins using UNIX sockets on Linux and Named Pipes on Windows. The connection diagram below illustrates the communication process between Zabbix agent 2 and a loadable plugin and the metrics collection process.  ### Огляд Користувацькі завантажувані плагіни розширюють функціональність Zabbix agent 2. Вони компілюються окремо, але використовують спільний з Zabbix agent 2 пакет. Кожен плагін — це пакет *Go*, який визначає структуру та реалізує один або кілька інтерфейсів плагіна (*Exporter*, *Configurator*, *Runner*). Перейти до: - [Напишіть свій перший плагін](/devel/plugins/how_to) - [Інтерфейси плагінів](/devel/plugins/interfaces) Дивіться також: - [Приклад плагіна для Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) ### Схема підключення Zabbix agent 2 двонаправлено підключається до плагінів за допомогою UNIX-сокетів у Linux та іменованих каналів (Named Pipes) у Windows. Наведена нижче схема з'єднання ілюструє процес зв'язку між Zabbix agent 2 і завантажуваним плагіном та процес збору метрик.  ### Overview High availability (HA) is typically required in critical infrastructures that can afford virtually no downtime. So for any service that may fail there must be a failover option in place to take over should the current service fail. Zabbix offers a **native** high-availability solution that is easy to set up and does not require any previous HA expertise. Native Zabbix HA may be useful for an extra layer of protection against software/hardware failures of Zabbix server or to have less downtime due to maintenance. In the Zabbix high availability mode multiple Zabbix servers are run as nodes in a cluster. While one Zabbix server in the cluster is active, others are on standby, ready to take over if necessary.  Switching to Zabbix HA is non-committal. You may switch back to standalone operation at any point. See also: [Implementation details](#implementation-details) ### Огляд Висока доступність (HA) зазвичай потрібна в критичних інфраструктурах, які практично не можуть дозволити собі простоїв. Тож, для будь-якого сервісу, який може вийти з ладу, має бути передбачена можливість переключення на інший ресурс, у разі відмови поточного сервісу. Zabbix пропонує **власне** рішення високої доступності, яке легко налаштувати і яке не потребує попереднього досвіду роботи з HA. Це вбудоване рішення може бути корисним як додатковий рівень захисту від програмних або апаратних збоїв сервера Zabbix або для зменшення часу простою під час технічного обслуговування. У режимі високої доступності Zabbix, кілька Zabbix серверів працюють як вузли кластеру. Поки один Zabbix сервер у кластері активний, інші знаходяться в режимі очікування і готові взяти на себе роботу, в разі потреби.  Перехід на Zabbix HA не є незворотнім. Ви можете повернутися до режиму самостійної роботи в будь-який момент. Дивіться також: [Деталі реалізації](#implementation-details) #### Overview In order to use any other language than English in Zabbix web interface, its locale should be installed on the web server. Additionally, the PHP gettext extension is required for the translations to work. #### Огляд Щоб використовувати будь-яку іншу мову, окрім англійської, у веб-інтерфейсі Zabbix, її локаль повинна бути встановлена на веб-сервері. Крім того, для роботи перекладів потрібне розширення PHP gettext. #### Overview In this section, you will learn how to log in and set up a system user in Zabbix. #### Огляд У цьому розділі ви дізнаєтесь, як увійти та налаштувати користувача системи Zabbix. #### Overview In this section you will learn how to set up a new host. A host in Zabbix is a networked entity (physical, virtual) that you wish to monitor. The definition of what can be a "host" in Zabbix is quite flexible. It can be a physical server, a network switch, a virtual machine or some application. #### Огляд У цьому розділі ви дізнаєтесь, як налаштувати новий вузол мережі. Вузол мережі у Zabbix — це мережева сутність (фізична, віртуальна), яку ви бажаєте моніторити. Визначення того, що може бути "вузлом мережі" у Zabbix, досить гнучке. Це може бути фізичний сервер, мережевий комутатор, віртуальна машина або якийсь додаток. #### Overview In this section, you will learn how to set up an item. Items are the basis of gathering data in Zabbix. Without items, there is no data - because only an item defines a single metric or what kind of data to collect from a host. #### Огляд У цьому розділі ви дізнаєтеся, як налаштувати елемент даних. Елементи даних є основою для збору даних у Zabbix. Без елементів даних немає даних, тому що лише елемент даних визначає один показник або тип даних, які потрібно збирати з вузла мережі. #### Overview In this section you will learn how to set up a template. Previously we learned how to set up an item, a trigger and how to get a problem notification for the host. While all of these steps offer a great deal of flexibility in themselves, it may appear like a lot of steps to take if needed for, say, a thousand hosts. Some automation would be handy. This is where templates come to help. Templates allow to group useful items, triggers and other entities so that those can be reused again and again by applying to hosts in a single step. When a template is linked to a host, the host inherits all entities of the template. So, basically a pre-prepared bunch of checks can be applied very quickly. #### Огляд У цьому розділі ви дізнаєтеся, як налаштувати шаблон. Раніше ми дізналися, як налаштувати елемент даних, тригер і як отримати сповіщення про проблему для вузла мережі. Хоча всі ці кроки самі по собі пропонують велику гнучкість, може здатися, що їх потрібно виконати багато, якщо це необхідно, скажімо, для тисячі вузлів мережі. Трохи автоматизації було б зручно. Тут на допомогу приходять шаблони. Шаблони дозволяють групувати корисні елементи даних, тригери та інші сутності, щоб їх можна було повторно використовувати знову і знову, застосовуючи до вузлів мережі за один крок. Коли шаблон пов’язано з вузлом мережі, вузол мережі успадковує всі сутності шаблону. Отже, в основному, заздалегідь підготовлену групу перевірок можна застосувати дуже швидко. #### Overview Problem events in Zabbix can be acknowledged by users. If a user gets notified about a problem event, they can go to Zabbix frontend, open the problem update popup window of that problem using one of the ways listed below and acknowledge the problem. When acknowledging, they can enter their comment for it, saying that they are working on it or whatever else they may feel like saying about it. This way, if another system user spots the same problem, they immediately see if it has been acknowledged and the comments so far. This way the workflow of resolving problems with more than one system user can take place in a coordinated way. Acknowledgment status is also used when defining [action operations](/manual/config/notifications/action/operation). You can define, for example, that a notification is sent to a higher level manager only if an event is not acknowledged for some time. To acknowledge events and comment on them, a user must have at least read permissions to the corresponding triggers. To change problem severity or close problem, a user must have read-write permissions to the corresponding triggers. There are **several** ways to access the problem update popup window, which allows acknowledging a problem. - You may select problems in *Monitoring* → *Problems* and then click on *Mass update* below the list - You can click on *Update* in the *Update* column of a problem in: - *Dashboards* (*Problems* and *Problems by severity* widgets) - *Monitoring → Problems* - *Monitoring → Problems → Event details* - You can click on an unresolved problem cell in: - *Dashboards* (*Trigger overview* widget) The popup menu contains an *Update* option that will take you to the problem update window. #### Огляд Проблемні події в Zabbix можуть бути визнані користувачами. Якщо користувач отримує сповіщення про проблему, він може перейти до інтерфейсу Zabbix, відкрити спливаюче вікно оновлення цієї проблеми одним із способів, перелічених нижче, і підтвердити проблему. Підтверджуючи, вони можуть ввести свій коментар до цього, сказавши,що вони над цим працюють, або будь-що інше, що вони можуть сказати про це. Таким чином, якщо інший користувач системи помітить ту саму проблему, він одразу побачить, чи було її підтверджено, і коментарі до цього часу. Таким чином робочий процес вирішення проблем із кількома користувачами системи може відбуватися скоординовано. Статус підтвердження також використовується під час визначення [операцій дій](/manual/config/notifications/action/operation). Ви можете визначити, наприклад, що сповіщення надсилається менеджеру вищого рівня, лише якщо подія не підтверджується протягом деякого часу. Щоб підтверджувати події та коментувати їх, користувач повинен мати принаймні дозволи на читання відповідних тригерів. Щоб змінити серйозність проблеми або закрити проблему, користувач повинен мати дозволи на читання та запис для відповідних тригерів. Існує **кілька** способів отримати доступ до спливаючого вікна оновлення проблеми, яке дозволяє підтвердити проблему. - Ви можете вибрати проблеми в *Моніторинг* → *Проблеми*, а потім натиснути *Масове оновлення* під списком - Ви можете натиснути на *Оновити* в колонці *Оновити* проблеми в: - *Дашборди* (віджети *Проблеми* та *Проблеми за ступенем серйозності*) - *Моніторинг → Проблеми* - *Моніторинг → Проблеми → Деталі події* -Ви можете натиснути на клітинку з невирішеною проблемою: - *Дашборди* (віджет *Огляд тригерів*) Спливне меню містить опцію *Оновити*, за допомогою якої ви перейдете до вікна оновлення проблеми. #### Overview Problem suppression offers a way of temporarily hiding a problem that can be dealt with later. This is useful for cleaning up the problem list in order to give the highest priority to the most urgent issues. For example, sometimes an issue may arise on the weekend that is not urgent enough to be dealt with immediately, so it can be "snoozed" until Monday morning. Problem suppression allows to hide a *single* problem, in contrast to problem suppression through host maintenance when all problems of the maintenance host are hidden. Operations for trigger actions will be paused for suppressed problems the same way as it is done with [host maintenance](/manual/maintenance). #### Огляд Приховування проблеми пропонує спосіб тимчасово приховати проблему, яка можна вирішити пізніше. Це корисно для очищення списку проблем для того, щоб надавати найвищий пріоритет найбільш актуальним питанням. Наприклад, іноді у вихідні, може виникнути проблема, яка не на стільки термінова, щоб негайно її вирішити, тому її можна "відкласти" до ранку понеділка. Приховування проблеми дозволяє приховати *окрему* проблему, на відміну від приховування через обслуговування хоста, коли всі проблеми хоста, який обслуговується, приховані. Операції для тригерних дій також буде призупинено для пригнічених проблем так, як це робиться за допомогою [обслуговування хоста](/manual/maintenance). #### Overview Some new items are automatically added for monitoring when web scenarios are created. All items inherit tags from the web scenario. #### Огляд Деякі нові елементи автоматично додаються для моніторингу під час створення веб-сценаріїв. Усі елементи успадковують теги з веб-сценарію. #### Overview Template groups are used for the logical grouping of templates and assigning user permissions to them. Each template must have at least one template group assigned. A template may belong to multiple template groups, and each template group may contain multiple templates. Note that in Zabbix, all permissions are based on groups: [user groups](/manual/config/users_and_usergroups), [host groups](/manual/config/hosts/host_groups), and template groups. So, even if a single user needs access to a single template, it is granted by adding the user to a user group that has permission to access the template group containing that template. #### Overview Template groups are used for the logical grouping of templates and assigning user permissions to them. Each template must have at least one template group assigned. A template may belong to multiple template groups, and each template group may contain multiple templates. Note that in Zabbix, all permissions are based on groups: [user groups](/manual/config/users_and_usergroups), [host groups](/manual/config/hosts/host_groups), and template groups. So, even if a single user needs access to a single template, it is granted by adding the user to a user group that has permission to access the template group containing that template. #### Overview Templates are [exported](/manual/xml_export_import) with many related objects and object relations. Template export contains: - Linked template groups - Linked host groups (if used in [host prototype](/manual/discovery/low_level_discovery/host_prototypes) configuration) - Template data - Linkage to other templates - Linkage to template groups - Directly linked items - Directly linked triggers - Directly linked graphs - Directly linked dashboards - Directly linked discovery rules with all prototypes - Directly linked web scenarios - Value maps #### Огляд Шаблони [експортуються](/manual/xml_export_import) із багатьма пов’язаними об’єктами та об’єктними зв’язками. Експорт шаблону містить: — Зв’язані групи шаблонів - Пов’язані групи хостів (якщо використовуються в конфігурації [прототип хоста](/manual/discovery/low_level_discovery/host_prototypes)) - Дані шаблону - Зв'язок з іншими шаблонами - Зв’язок із групами шаблонів - Безпосередньо пов'язані елементи даних - Безпосередньо пов'язані тригери - Безпосередньо пов'язані графи - Безпосередньо пов'язані інформаційні панелі - Безпосередньо пов'язані правила виявлення з усіма прототипами - Безпосередньо пов'язані веб-сценарії - Карти значень #### Overview The Monitoring menu is all about displaying data. Whatever information Zabbix is configured to gather, visualize and act upon, it will be displayed in the various sections of the Monitoring menu. #### Огляд У меню моніторингу відображаються дані. Яку б інформацію не налаштував Zabbix для збору, візуалізації та дії, вона буде відображатися в різних розділах меню моніторингу. #### Overview The Reports menu features several sections that contain a variety of predefined and user-customizable reports focused on displaying an overview of such parameters as system information, triggers and gathered data. #### Огляд Меню «Звіти» містить кілька розділів, які містять різноманітні попередньо визначені та настроювані користувачем звіти, орієнтовані на відображення огляду таких параметрів, як системна інформація, тригери та зібрані дані. #### Overview The Services menu is for the [service monitoring](/manual/it_services) functions of Zabbix. #### Огляд Меню «Сервіси» призначене для функцій [сервісного моніторингу] /manual/it_services) Zabbix. ### Overview This section allows to view and [configure](/manual/it_services/sla) SLAs. ### Огляд Цей розділ дозволяє переглядати та [налаштовувати](/manual/it_services/sla) SLA. #### Overview Zabbix supports data export in real-time in two ways: - [export to files](/manual/config/export/files) - [streaming to external systems](/manual/config/export/streaming) The following entities can be exported: - trigger events - item values - trends (export to files only) #### Огляд Zabbix підтримує експорт даних у режимі реального часу двома способами: - [експорт у файли](/manual/config/export/files) - [потокове передавання у зовнішні системи](/manual/config/export/streaming) Можна експортувати такі сутності: - події тригеру - значення елементів даних - тренди (лише експорт у файли) ### Parameters `(array)` IDs of hosts to delete. ### Параметри `(array)` ID хостів для видалення. ### Parameters `(array)` IDs of items to clear. ### Параметри `(array)` ID елементів для очищення. ### Parameters `(array)` IDs of the actions to delete. ### Параметри `(array)` Ідентифікатори дій для видалення. ### Parameters `(array)` IDs of the correlations to delete. ### Параметри `(array)` Ідентифікатори кореляцій, які потрібно видалити. ### Parameters `(array)` IDs of the dashboards to delete. ### Параметри `(array)` Ідентифікатори інформаційних панелей для видалення. ### Parameters `(array)` IDs of the discovery rules to delete. ### Параметри `(array)` ідентифікатори правил виявлення для видалення. ### Parameters `(array)` IDs of the graph prototypes to delete. ### Параметри `(масив)` ID прототипів графіків для видалення. ### Parameters `(array)` IDs of the graphs to delete. ### Параметри `(array)` ID графіків для видалення. ### Parameters `(array)` IDs of the host groups to delete. ### Параметри `(array)` ID груп хостів для видалення. ### Parameters `(array)` IDs of the host interfaces to delete. ### Параметри `(array)` ID хост-інтерфейсів для видалення. ### Parameters `(array)` IDs of the LLD rules to delete. ### Параметри `(array)` ідентифікатори правил LLD для видалення. ### Parameters `(array)` The method accepts an empty array. ### Параметри `(array)` Метод приймає порожній масив. ### Parameters `(object/array)` Actions to create. Additionally to the [standard action properties](object#action), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|[Action filter](/manual/api/reference/action/object#action_filter) object for the action.| |operations|array|[Action operations](/manual/api/reference/action/object#action_operation) to create for the action.| |recovery\_operations|array|[Action recovery operations](/manual/api/reference/action/object#action_recovery_operation) to create for the action.| |update\_operations|array|[Action update operations](/manual/api/reference/action/object#action_update_operation) to create for the action.| ### Параметри `(object/array)` Дії для створення. На додаток до [стандартних властивостей дії](object#action), метод приймає наступні параметри. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|[Дія фільтру](/manual/api/reference/action/object#action_filter) об’єкт для дії.|| |operations|array|[Дія операції](/manual/api/reference/action/object#action_operation), щоб створити для дії.| |recovery\_operations|array|[Дія операції відновлення](/manual/api/reference/action/object#action_recovery_operation), яку потрібно створити для дії.| |update\_operations|array|[Дія операції оновлення](/manual/api/reference/action/object#action_update_operation), яку потрібно створити для дії.| ### Parameters `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Параметри `(object/array)` [Властивості групи хостів](object#host_group) потрібно оновити. Властивість groupid має бути визначена для кожної групи хостів, усі інші властивості необов’язкові. Будуть оновлені лише вказані властивості, всі інші залишаться незмінними. ## Part II - Gauge chart ## Частина II - Калібрувальна діаграма (Gauge chart) ### Part III - Module action An action is implemented in two files - *actions/MyAddress.php* and *views/my.address.php*. The ***actions/MyAddress.php*** file takes care of the business logic implementation, while the ***views/my.address.php*** file is responsible for the view. 1. Create a directory *actions* in the *MyAddress* directory. 2. Create a *MyAddress.php* file in the *actions* directory. The action logic will be defined in the *MyAddress* class. This action class will implement four functions: *init()*, *checkInput()*, *checkPermissions()*, and *doAction()*. Zabbix frontend calls the *doAction()* function when the action is requested. This function is responsible for the business logic of the module. ::: noteimportant The data must be organized as an associative array. The array can be multidimensional and may contain any data expected by the view. ::: **ui/modules/MyAddress/actions/MyAddress.php** ```php <?php namespace Modules\MyAddress\Actions; use CController, CControllerResponseData; class MyAddress extends CController { public function init(): void { $this->disableCsrfValidation(); } protected function checkInput(): bool { return true; } protected function checkPermissions(): bool { return true; } protected function doAction(): void { $data = ['my-ip' => file_get_contents("https://api.seeip.org")]; $response = new CControllerResponseData($data); $this->setResponse($response); } } ``` 3. Create a new directory *views* in the *MyAddress* directory. 4. Create a *my.address.php* file in the *views* directory and define the module view. Note that the variable `$data` is available in the view without specifically defining it. The framework automatically passes the associative array to the view. **ui/modules/MyAddress/views/my.address.php** ```php <?php (new CHtmlPage()) ->setTitle(_('The HTML Title of My Address Page')) ->addItem(new CDiv($data['my-ip'])) ->show(); ``` 5. The module action has to be registered in the *manifest.json* file. Open *manifest.json* and add a new object `actions` that contains: - the action key with the action name written in lowercase (a-z) and with words separated by dots (for example, `my.address`); - the action class name (`MyAddress`) as a value for the `class` key of the `my.address` object; - the action view name (`my.address`) as a value for the `view` key of the `my.address` object. **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "My External IP Address.", "actions": { "my.address": { "class": "MyAddress", "view": "my.address" } } } ``` 6. Refresh Zabbix frontend. Click on *My address → External IP* to see the IP address of your computer. {width="600"} ### Частина III - Дія модуля Дія реалізована в двох файлах - *actions/MyAddress.php* і *views/my.address.php*. Файл ***actions/MyAddress.php*** відповідає за реалізацію бізнес-логіки, тоді як файл ***views/my.address.php*** відповідає за зовнішній вигляд. 1. Створіть каталог *actions* у каталозі *MyAddress*. 2. Створіть файл *MyAddress.php* у каталозі *actions*. Логіка дій буде визначена в класі *MyAddress*. Цей клас дій реалізує чотири функції: *init()*, *checkInput()*, *checkPermissions()* і *doAction()*. Фронтенд Zabbix запускає функцію *doAction()*, коли викликається дія. Ця функція відповідає за бізнес-логіку модуля. ::: noteimportant Дані повинні бути організовані як асоціативний масив. Масив може бути багатовимірним і може містити будь-які дані, які очікує view. ::: **ui/modules/MyAddress/actions/MyAddress.php** ```php <?php namespace Modules\MyAddress\Actions; use CController, CControllerResponseData; class MyAddress extends CController { public function init(): void { $this->disableCsrfValidation(); } protected function checkInput(): bool { return true; } protected function checkPermissions(): bool { return true; } protected function doAction(): void { $data = ['my-ip' => file_get_contents("https://api.seeip.org")]; $response = new CControllerResponseData($data); $this->setResponse($response); } } ``` 3. Створіть новий каталог *views* у каталозі *MyAddress*. 4. Створіть файл *my.address.php* у каталозі *views* і визначте вигляд модуля. Зауважте, що змінна `$data` доступна у view без її спеціального визначення. Фреймворк автоматично передає асоціативний масив у view. **ui/modules/MyAddress/views/my.address.php** ```php <?php (new CHtmlPage()) ->setTitle(_('The HTML Title of My Address Page')) ->addItem(new CDiv($data['my-ip'])) ->show(); ``` 5. Дія модуля має бути зареєстрована у файлі *manifest.json*. Відкрийте *manifest.json* і додайте новий об’єкт «actions», який містить: - ключ дії з назвою дії, написаною малими літерами (a-z) і словами, розділеними крапками (наприклад, `my.address`); - ім'я класу дії (`MyAddress`) як значення для ключа `class` об'єкта `my.address`; - ім'я для view дії (`my.address`) як значення для ключа `view` об'єкта `my.address`. **ui/modules/MyAddress/manifest.json** ```json { "manifest_version": 2.0, "id": "my-address", "name": "My IP Address", "version": "1.0", "namespace": "MyAddress", "description": "My External IP Address", "actions": { "my.address": { "class": "MyAddress", "view": "my.address" } } } ``` 6. Оновіть інтерфейс Zabbix. Натисніть на розділ меню *Моя адреса → Зовнішня IP-адреса*, щоб побачити IP-адресу вашого комп’ютера. {width="600"} ### Part II - Menu section location change In this part, you will move the *My Address* menu section to the *Monitoring* section and then add a nested menu to it. As a result, users will be able to access two sub-menu pages from the *Monitoring → My Address* menu section. 1. Open and edit the *Module.php* file. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setAction('userprofile.edit') ); } } ``` 2. Refresh Zabbix frontend. Expand the *Monitoring* menu section and observe that the *My address* section is now located below the *Discovery* section. {width="600"} 3. To add nested pages to the *My Address* menu section, open and edit the *Module.php* file again. This step creates two subsections: - *External IP* that executes a new 'my.address' action that will be defined in the next steps; - *User profile* that executes the predefined 'userprofile.edit' action to open the *User profile* page. Note that for the nested menu, you need to use the *CMenu* class in addition to the classes used in the previous steps. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenu, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setSubMenu( new CMenu([ (new CMenuItem(_('External IP')))->setAction('my.address'), (new CMenuItem(_('User profile')))->setAction('userprofile.edit') ]) ) ); } } ``` 4. Refresh Zabbix frontend. Observe that the *My address* menu section now contains a third-level menu with two pages - *External IP* and *User profile*. {width="600"} ### Частина II - Зміна розташування розділу меню У цій частині ви перемістите розділ меню *Моя адреса* в розділ *Моніторинг* і потім додасте до нього вкладене меню. У результаті користувачі матимуть доступ до двох сторінок підменю з розділу меню *Моніторинг → Моя адреса*. 1. Відкрийте та відредагуйте файл *Module.php*. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setAction('userprofile.edit') ); } } ``` 2. Оновіть інтерфейс Zabbix. Розгорніть розділ меню *Моніторинг* і зверніть увагу, що розділ *Моя адреса* тепер розташований під розділом *Виявлення*. {width="600"} 3. Щоб додати вкладені сторінки до розділу меню *Моя адреса*, знову відкрийте та відредагуйте файл *Module.php*. Цей крок створює два підрозділи: - *Зовнішня IP-адреса*, який виконує нову дію «my.address», яка буде визначена в наступних кроках; - *Профіль користувача*, який виконує попередньо визначену дію «userprofile.edit», щоб відкрити сторінку *Профіль користувача*. Зауважте, що для вкладеного меню вам потрібно використовувати клас *CMenu* на додаток до класів, використаних у попередніх кроках. **ui/modules/MyAddress/Module.php** ```php <?php namespace Modules\MyAddress; use Zabbix\Core\CModule, APP, CMenu, CMenuItem; class Module extends CModule { public function init(): void { APP::Component()->get('menu.main') ->findOrAdd(_('Monitoring')) ->getSubmenu() ->insertAfter(_('Discovery'), (new CMenuItem(_('My Address')))->setSubMenu( new CMenu([ (new CMenuItem(_('External IP')))->setAction('my.address'), (new CMenuItem(_('User profile')))->setAction('userprofile.edit') ]) ) ); } } ``` 4. Оновіть інтерфейс Zabbix. Зверніть увагу, що розділ меню *Моя адреса* тепер містить меню третього рівня з двома сторінками - *Зовнішня IP-адреса* та *Профіль користувача*. {width="600"} ### Part I - New menu section ### Частина I - Новий розділ меню ### plugin.Configurator *Configurator* interface provides plugin configuration parameters from Zabbix agent 2 configuration files. ### plugin.Configurator Інтерфейс *Configurator* надає параметри конфігурації плагіна з конфігураційних файлів Zabbix agent 2. ### plugin.Exporter *Exporter* is the simplest interface that performs a poll and returns a value (values), nothing, or error. It accepts a preparsed item key, parameters, and context. Access to all other plugin interfaces is exclusive and no method can be called if a plugin is already performing a task. Also, there is a limit of 100 maximum concurrent *Export()* calls per plugin, which can be reduced according to the requirements for each plugin. ### plugin.Exporter *Exporter* — це найпростіший інтерфейс, який виконує опитування та повертає значення (або кілька значень), нічого або помилку. Він приймає підготовлений ключ елемента даних, параметри та контекст. Доступ до всіх інших інтерфейсів плагінів є ексклюзивним, і жоден метод не може бути викликаний, якщо плагін уже виконує завдання. Крім того, існує обмеження в 100 одночасних викликів *Export()* для одного плагіна, яке можна зменшити відповідно до вимог для кожного плагіна. # Plugin interfaces This section describes available plugin interfaces. # Інтерфейси плагінів У цьому розділі описано доступні інтерфейси плагінів. ### plugin.Runner *Runner* interface provides the means for performing initialization when a plugin is started (activated) and deinitialization when a plugin is stopped (deactivated). For example, a plugin can start/stop some background *goroutine* by implementing the Runner interface. ### plugin.Runner Інтерфейс *Runner* надає засоби для виконання ініціалізації, коли плагін запущено (активовано), і деініціалізації, коли плагін зупинено (дезактивовано). Наприклад, плагін може запускати/зупиняти деяку фонову *goroutine* шляхом реалізації інтерфейсу Runner. # Plugins # Плагіни #### PostgreSQL If a value contains a non-ASCII character in non UTF8 encoding - this will lead to a failed SQL query (PGRES\_FATAL\_ERROR:ERROR invalid byte sequence for encoding) and data will not be stored. An appropriate warning message will be written to the *zabbix\_server.log*.\ Relevant for at least PostgreSQL version 9.1.3 #### PostgreSQL Якщо значення містить символ, відмінний від ASCII, у кодуванні, відмінному від UTF8, це призведе до помилки SQL-запиту (PGRES\_FATAL\_ERROR:ERROR недійсна послідовність байтів для кодування), і дані не будуть збережені. Відповідне попередження буде записано в *zabbix\_server.log*.\ Актуально принаймні для PostgreSQL версії 9.1.3 ##### Preparing frontend Make sure that Zabbix server address:port is **not defined** in the frontend configuration (found in `conf/zabbix.conf.php` of the frontend files directory). {width="600"} Zabbix frontend will autodetect the active node by reading settings from the nodes table in Zabbix database. Node address of the active node will be used as the Zabbix server address. ##### Підготовка web-інтерфейсу Переконайтеся, що в конфігураційному файлі web-інтерфейсу ( знаходиться у `conf/zabbix.conf.php` в директорії з файлами веб-інтерфейсу) **не вказано** адреса:порт Zabbix сервера. {width="600"} Web-інтерфейс Zabbix автоматично визначить активний вузол, зчитавши налаштування з таблиці вузлів у базі даних Zabbix. Адреса активного вузла буде використана як адреса Zabbix сервера. ## Pre-requisites Before proceeding make sure, that: - The module is located inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). - The module has at least a basic version of [manifest.json](/devel/modules/file_structure/manifest) file. - You have access to the Administration menu section in Zabbix (requires Super admin user role type). :::notetip The frontend will not install or even recognize incompatible modules. ::: ## Необхідні умови Перш ніж продовжити, переконайтеся, що: - Модуль знаходиться в каталозі *modules* вашої інсталяції web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). - Модуль має принаймні базову версію файлу [manifest.json](/devel/modules/file_structure/manifest). - Ви маєте доступ до розділу меню «Адміністрування» в Zabbix (потрібна роль суперадміністратора). :::notetip Інтерфейс не встановить і навіть не розпізнає несумісні модулі. ::: ##### Presentation modification methods The widget presentation modification methods are responsible for modifying widget appearance. ##### Методи модифікації презентації Методи модифікації представлення віджетів відповідають за зміну зовнішнього вигляду віджетів. # Presentation This page describes the components that can be used to create a widget presentation view. The widget presentation view is the part of the widget that receives the data according to its [configuration](/configuration) and displays it on the dashboard in a container. The presentation view consists of three parts: - [Widget action](#widget-action) - [Widget view](#widget-view) - [JavaScript](#javascript) # Презентація Ця сторінка описує компоненти, які можуть бути використані для створення представлення віджету. Представлення віджету - це частина віджету, яка отримує дані відповідно до його [конфігурації](/configuration) і відображає їх на інформаційній панелі в контейнері. Вид презентації складається з трьох частин: - [Action віджета](#widget-action) - [View віджетів](#widget-view) - [JavaScript](#javascript) #### Problems Retrieve problems according to the given parameters. [Problem API](/manual/api/reference/problem) #### Проблеми Отримати проблеми за заданими параметрами. [API проблеми](/manual/api/reference/problem) ##### Protection against brute force attacks In case of five consecutive failed login attempts, Zabbix interface will pause for 30 seconds in order to prevent brute force and dictionary attacks. The IP address of a failed login attempt will be displayed after a successful login. ##### Захист від атак перебором У разі п’яти послідовних невдалих спроб входу інтерфейс Zabbix призупиняється на 30 секунд, щоб запобігти атакам перебору та словниковим атакам. IP-адреса невдалої спроби входу буде відображена після успішного входу. #### Proxies and proxy groups Manage the proxies used in your distributed monitoring setup. [Proxy API](/manual/api/reference/proxy) | [Proxy group API](/manual/api/reference/proxygroup) #### Проксі та групи проксі Керуйте проксі-серверами, які використовуються в налаштуваннях розподіленого моніторингу. [API проксі](/manual/api/reference/proxy) | [API групи проксі](/manual/api/reference/proxygroup) ##### Proxy configuration HA cluster nodes (servers) must be listed in the configuration of either passive or active Zabbix proxy. For a passive proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **comma**. ``` Server=zabbix-node-01,zabbix-node-02 ``` For an active proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **semicolon**. ``` Server=zabbix-node-01;zabbix-node-02 ``` ##### Конфігурація проксі Вузли (сервери) кластера HA повинні бути вказані в конфігурації пасивного або активного Zabbix проксі. Для пасивного проксі імена вузлів кластеру мають бути вказані в [параметрі](/manual/appendix/config/zabbix_proxy) Server і розділені **комою**. ``` Server=zabbix-node-01,zabbix-node-02 ``` Для активного проксі імена вузлів кластеру мають бути вказані в [параметрі](/manual/appendix/config/zabbix_proxy) Server і розділені **крапкою з комою**. ``` Server=zabbix-node-01;zabbix-node-02 ``` # Register a new module This section explains how to add a new module to Zabbix frontend. # Реєстрація нового модуля У цьому розділі пояснюється, як додати новий модуль до інтерфейсу Zabbix. ### Report The filter allows to select the report based on the SLA name as well as the service name. It is also possible to limit the displayed period. {width="600"} Each column (period) displays the SLI for that period. SLIs that are in breach of the set SLO are highlighted in red. 20 periods are displayed in the report. A maximum of 100 periods can be displayed, if both the *From* date and *To* date are specified. ### Звіт Фільтр дозволяє вибрати звіт на основі назви SLA, а також назви служби. Також можна обмежити відображуваний період. {width="600"} Кожен стовпець (період) відображає SLI для цього періоду. SLI, які порушують встановлений SLO, виділені червоним кольором. У звіті відображається 20 періодів. Можна відобразити максимум 100 періодів, якщо вказано обидві дати *Від* і *До*. #### Retrieve discovery actions Retrieve all configured discovery actions together with action conditions and operations. The filter uses the "and" evaluation type, so the `formula` property is empty and `eval_formula` is generated automatically. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 1 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "2", "name": "Auto discovery. Linux servers.", "eventsource": "1", "status": "1", "esc_period": "0s", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "conditiontype": "10", "operator": "0", "value": "0", "value2": "", "formulaid": "B" }, { "conditiontype": "8", "operator": "0", "value": "9", "value2": "", "formulaid": "C" }, { "conditiontype": "12", "operator": "2", "value": "Linux", "value2": "", "formulaid": "A" } ], "eval_formula": "A and B and C" }, "operations": [ { "operationid": "1", "actionid": "2", "operationtype": "6", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "optemplate": [ { "templateid": "10001" } ] }, { "operationid": "2", "actionid": "2", "operationtype": "4", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opgroup": [ { "groupid": "2" } ] } ] } ], "id": 1 } ``` #### Отримати дії виявлення Отримати всі налаштовані дії виявлення разом із умовами дій та операціями. Фільтр використовує тип оцінки "and", тому властивість `formula` порожня, а `eval_formula` генерується автоматично. [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 1 } }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "2", "name": "Auto discovery. Linux servers.", "eventsource": "1", "status": "1", "esc_period": "0s", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "conditiontype": "10", "operator": "0", "value": "0", "value2": "", "formulaid": "B" }, { "conditiontype": "8", "operator": "0", "value": "9", "value2": "", "formulaid": "C" }, { "conditiontype": "12", "operator": "2", "value": "Linux", "value2": "", "formulaid": "A" } ], "eval_formula": "A and B and C" }, "operations": [ { "operationid": "1", "actionid": "2", "operationtype": "6", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "optemplate": [ { "templateid": "10001" } ] }, { "operationid": "2", "actionid": "2", "operationtype": "4", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opgroup": [ { "groupid": "2" } ] } ] } ], "id": 1 } ``` #### Retrieve trigger actions Retrieve all configured trigger actions together with action conditions and operations. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectRecoveryOperations": "extend", "selectUpdateOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 0 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "3", "name": "Report problems to Zabbix administrators", "eventsource": "0", "status": "1", "esc_period": "1h", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [], "eval_formula": "" }, "operations": [ { "operationid": "3", "actionid": "3", "operationtype": "0", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opmessage": [ { "default_msg": "1", "subject": "", "message": "", "mediatypeid" => "0" } ], "opmessage_grp": [ { "usrgrpid": "7" } ] } ], "recovery_operations": [ { "operationid": "7", "actionid": "3", "operationtype": "11", "evaltype": "0", "opconditions": [], "opmessage": { "default_msg": "0", "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}", "message": "Trigger: {TRIGGER.NAME}\r\nTrigger status: {TRIGGER.STATUS}\r\nTrigger severity: {TRIGGER.SEVERITY}\r\nTrigger URL: {TRIGGER.URL}\r\n\r\nItem values:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n\r\nOriginal event ID: {EVENT.ID}", "mediatypeid": "0" } } ], "update_operations": [ { "operationid": "31", "operationtype": "12", "evaltype": "0", "opmessage": { "default_msg": "1", "subject": "", "message": "", "mediatypeid": "0" } }, { "operationid": "32", "operationtype": "0", "evaltype": "0", "opmessage": { "default_msg": "0", "subject": "Updated: {TRIGGER.NAME}", "message": "{USER.FULLNAME} updated problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} with the following message:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nCurrent problem status is {EVENT.STATUS}", "mediatypeid": "1" }, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage_usr": [] }, { "operationid": "33", "operationtype": "1", "evaltype": "0", "opcommand": { "scriptid": "3" }, "opcommand_hst": [ { "hostid": "10084" } ], "opcommand_grp": [] } ] } ], "id": 1 } ``` #### Отримати тригерні дії Отримати всі налаштовані тригерні дії разом із умовами дії та операціями. [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectRecoveryOperations": "extend", "selectUpdateOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 0 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "3", "name": "Report problems to Zabbix administrators", "eventsource": "0", "status": "1", "esc_period": "1h", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [], "eval_formula": "" }, "operations": [ { "operationid": "3", "actionid": "3", "operationtype": "0", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opmessage": [ { "default_msg": "1", "subject": "", "message": "", "mediatypeid" => "0" } ], "opmessage_grp": [ { "usrgrpid": "7" } ] } ], "recovery_operations": [ { "operationid": "7", "actionid": "3", "operationtype": "11", "evaltype": "0", "opconditions": [], "opmessage": { "default_msg": "0", "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}", "message": "Trigger: {TRIGGER.NAME}\r\nTrigger status: {TRIGGER.STATUS}\r\nTrigger severity: {TRIGGER.SEVERITY}\r\nTrigger URL: {TRIGGER.URL}\r\n\r\nItem values:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n\r\nOriginal event ID: {EVENT.ID}", "mediatypeid": "0" } } ], "update_operations": [ { "operationid": "31", "operationtype": "12", "evaltype": "0", "opmessage": { "default_msg": "1", "subject": "", "message": "", "mediatypeid": "0" } }, { "operationid": "32", "operationtype": "0", "evaltype": "0", "opmessage": { "default_msg": "0", "subject": "Updated: {TRIGGER.NAME}", "message": "{USER.FULLNAME} updated problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} with the following message:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nCurrent problem status is {EVENT.STATUS}", "mediatypeid": "1" }, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage_usr": [] }, { "operationid": "33", "operationtype": "1", "evaltype": "0", "opcommand": { "scriptid": "3" }, "opcommand_hst": [ { "hostid": "10084" } ], "opcommand_grp": [] } ] } ], "id": 1 } ``` ### Return values `(array)` Returns an array with changes in configuration, that will be made. ### Повернуті значення `(array)` Повертає масив зі змінами в конфігурації, які будуть внесені. ### Return values `(boolean )` Returns boolean true as result on successful update. ### Повернуті значення `(boolean )` Повертає логічне значення true як результат успішного оновлення. ### Return values `(boolean)` Returns `true` if importing has been successful. ### Повернуті значення `(boolean)` Повертає `true`, якщо імпортування було успішним. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. ### Return values `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори очищених елементів у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the created actions under the `actionids` property. The order of the returned IDs matches the order of the passed actions. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених дій у властивості `actionids`. Порядок повернених ідентифікаторів відповідає порядку виконаних дій. ### Return values `(object)` Returns an object containing the IDs of the created correlations under the `correlationids` property. The order of the returned IDs matches the order of the passed correlations. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених кореляцій у властивості `correlationids`. Порядок повернених ідентифікаторів відповідає порядку переданих кореляцій. ### Return values `(object)` Returns an object containing the IDs of the created dashboards under the `dashboardids` property. The order of the returned IDs matches the order of the passed dashboards. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інформаційних панелей у властивості `dashboardids`. Порядок повернених ідентифікаторів відповідає порядку переданих інформаційних панелей. ### Return values `(object)` Returns an object containing the IDs of the created discovery rules under the `druleids` property. The order of the returned IDs matches the order of the passed discovery rules. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених правил виявлення у властивості `druleids`. Порядок повернених ідентифікаторів відповідає порядку переданих правил виявлення. ### Return values `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених прототипів графів у властивості `graphids`. Порядок повернених ідентифікаторів відповідає порядку переданих прототипів графів. ### Return values `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених графіків у властивості `graphids`. Порядок повернених ідентифікаторів відповідає порядку переданих графіків. ### Return values `(object)` Returns an object containing the IDs of the created host groups under the `groupids` property. The order of the returned IDs matches the order of the passed host groups. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених груп хостів у властивості `groupids`. Порядок повернених ідентифікаторів відповідає порядку переданих груп хостів. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених хост-інтерфейсів у властивості `interfaceids`. Порядок повернених ідентифікаторів відповідає порядку переданих інтерфейсів хоста. ### Return values `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених прототипів хостів у властивості `hostids`. Порядок повернутих ідентифікаторів відповідає порядку переданих прототипів хосту. ### Return values `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених хостів у властивості `hostids`. Порядок повернених ідентифікаторів відповідає порядку переданих хостів. ### Return values `(object)` Returns an object containing the IDs of the created LLD rules under the `itemids` property. The order of the returned IDs matches the order of the passed LLD rules. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених правил LLD у властивості `itemids`. Порядок повернених ідентифікаторів відповідає порядку переданих правил LLD. ### Return values `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори створених веб-сценаріїв у властивості `httptestids`. Порядок повернених ідентифікаторів відповідає порядку переданих веб-сценаріїв. ### Return values `(object)` Returns an object containing the IDs of the deleted actions under the `actionids` property. ### Повернуті значення `(object)` повертає об’єкт, що містить ідентифікатори видалених дій у властивості `actionids`. ### Return values `(object)` Returns an object containing the IDs of the deleted correlations under the `correlationids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених кореляцій у властивості `correlationids`. ### Return values `(object)` Returns an object containing the IDs of the deleted dashboards under the `dashboardids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інформаційних панелей у властивості `dashboardids`. ### Return values `(object)` Returns an object containing the IDs of the deleted discovery rules under the `druleids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених правил виявлення у властивості `druleids`. ### Return values `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених прототипів графів у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених графіків у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the deleted items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори видалених елементів даних у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the updated actions under the `actionids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених дій у властивості `actionids`. ### Return values `(object)` Returns an object containing the IDs of the updated correlations under the `correlationids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених кореляцій у властивості `correlationids`. ### Return values `(object)` Returns an object containing the IDs of the updated dashboards under the `dashboardids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених інформаційних панелей у властивості `dashboardids`. ### Return values `(object)` Returns an object containing the IDs of the updated discovery rules under the `druleids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених правил виявлення у властивості `druleids`. ### Return values `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених подій у властивості `eventids`. ### Return values `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених прототипів графів у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених графіків у властивості `graphids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості `groupids`. ### Return values `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених інтерфейсів хостів у властивості `interfaceids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених хостів у властивості `hostids`. ### Return values `(object)` Returns an object containing the IDs of the updated items under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених елементів даних у властивості `itemids`. ### Return values `(object)` Returns an object containing the IDs of the updated LLD rules under the `itemids` property. ### Повернуті значення `(object)` Повертає об’єкт, що містить ідентифікатори оновлених правил LLD у властивості `itemids`. ### Return values `(object)` Returns authentication object. ### Повернуті значення `(object)` Повертає об'єкт автентифікації. ### Return values `(object)` Returns autoregistration object. ### Повернуті значення `(object)` Повертає об'єкт автореєстрації. ### Return values `(object)` Returns housekeeping object. ### Повернуті значення `(object)` Повертає об'єкт господарювання. ### Return values `(string)` Returns a serialized string containing the requested configuration data. ### Повернуті значення `(string)` Повертає серіалізований рядок, що містить запитувані дані конфігурації. ### Return values `(string)` Returns the version of the Zabbix API. ::: notetip Starting from Zabbix 2.0.4 the version of the API matches the version of Zabbix. ::: ### Повернуті значення `(string)` Повертає версію Zabbix API. ::: notetip Починаючи з Zabbix 2.0.4 версія API відповідає версії Zabbix. ::: ### Runtime control options **config\_cache\_reload** Reload configuration cache. Ignored if cache is being currently loaded. Active Zabbix proxy will connect to the Zabbix server and request configuration data. Default configuration file (unless **-c** option is specified) will be used to find PID file and signal will be sent to process, listed in PID file. **snmp\_cache\_reload** Reload SNMP cache. **housekeeper\_execute** Execute the housekeeper. Ignored if housekeeper is being currently executed. **diaginfo**\[=*section*\] Log internal diagnostic information of the specified section. Section can be *historycache*, *preprocessing*, *locks*. By default diagnostic information of all sections is logged. **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} ### Параметри runtime-option **config\_cache\_reload** Перезавантажити кеш конфігурації. Ігнорується, якщо зараз завантажується кеш. Активний проксі-сервер Zabbix підключатиметься до сервера Zabbix і запитуватиме конфігураційні дані. Файл конфігурації за замовчуванням (якщо не вказано параметр **-c**) використовуватиметься для пошуку файлу PID, а сигнал буде надіслано до процесу, зазначеного у файлі PID. **snmp\_cache\_reload** Перезавантажте кеш SNMP. **housekeeper\_execute** Стратити економку. Ігнорується, якщо зараз працює економка виконано. **diaginfo**\[=*section*\] Реєстрація внутрішньої діагностичної інформації вказаного розділу. Розділ може бути *historycache*, *preprocessing*, *locks*. За замовчуванням реєструється діагностична інформація всіх розділів. **log\_level\_increase**\[=*target*\] Підвищити рівень журналу, впливає на всі процеси, якщо ціль не вказано. **log\_level\_decrease**\[=*target*\] Зниження рівня журналу, впливає на всі процеси, якщо ціль не вказано. [ ]{#lbAG} #### Runtime control options: **userparameter_reload** Reload user parameters from the configuration file **log_level_increase** Increase log level **log_level_decrease** Decrease log level **help** List available runtime control options **metrics** List available metrics **version** Display version **-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. **-v**, **--verbose** Enable verbose output when test item or print known items. **-T**, **--test-config** Validate configuration file and exit. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} #### Параметри контролю виконання: **userparameter reload** Перезавантаження параметрів користувача з файлу конфігурації **loglevel increase** Підвищити рівень журналу **loglevel decrease** Зменшити рівень журналу **help** Список доступних параметрів керування часом виконання **metrics** Список доступних показників **version** Показати версію **-p**, **--print** Роздрукувати відомі елементи та вийти. Для кожного елемента використовуються або загальні параметри за замовчуванням, або надаються спеціальні параметри за замовчуванням для тестування. Ці значення за замовчуванням наведено в квадратних дужках як ключові параметри елемента. Повернуті значення береться в квадратні дужки та має префікс типу повернутого значення, розділених вертикальною рискою. Тип параметрів користувача завжди **t**, оскільки агент не може визначити всі можливі значення, що повертаються. Елементи, які відображаються як робочі, не гарантують роботу на сервері Zabbix або zabbix\_get під час запиту до запущеного демона агента, оскільки дозволи або середовище можуть відрізнятися. Типи повернених значень: d Число з десятковою частиною. m Не підтримується. Це може бути викликано запитом до елемента, який працює лише в активному режимі, як-от елемент моніторингу журналу, або елемент, який вимагає кількох зібраних значень. Проблеми з дозволом або неправильні параметри користувача також можуть призвести до непідтримуваного стану. s Текст. Максимальна довжина не обмежена. t Текст. Те саме, що **s**. u Ціле число без знака. \ **-t**, **--test** *item-key* Перевірити один предмет і вийти. Див. **--print** для опису результату. **-v**, **--verbose** Увімкнути докладний вивід під час тестування або друку відомих елементів. **-T**, **--test-config** Перевірити файл конфігурації та вийти. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Вивести інформацію про версію та вийти. [ ]{#lbAG} ### #### Runtime control options **userparameter\_reload** Reload user parameters from the configuration file **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} ### #### Параметри керування виконанням (Runtime options) **userparameter\_reload** Перезавантаження параметрів користувача з файлу конфігурації **log\_level\_increase**\[=*target*\] Підвищити рівень журналу, впливає на всі процеси, якщо ціль не вказано **log\_level\_decrease**\[=*target*\] Зниження рівня журналу, впливає на всі процеси, якщо ціль не вказано [ ]{#lbAG} ##### RUNTIME CONTROL Runtime control options: **config\_cache\_reload** Reload configuration cache. Ignored if cache is being currently loaded. Default configuration file (unless **-c** option is specified) will be used to find PID file and signal will be sent to process, listed in PID file. **snmp\_cache\_reload** Reload SNMP cache, clear the SNMP properties (engine time, engine boots, engine id, credentials) for all hosts. **housekeeper\_execute** Execute the housekeeper. Ignored if housekeeper is being currently executed. **trigger_housekeeper\_execute** Execute the trigger housekeeper (remove problems for deleted triggers). Ignored if trigger housekeeper for services is being currently executed. **diaginfo**\[=*section*\] Log internal diagnostic information of the specified section. Section can be *historycache*, *preprocessing*, *alerting*, *lld*, *valuecache*, *locks*. By default diagnostic information of all sections is logged. **ha_status** Log high availability (HA) cluster status. ##### RUNTIME CONTROL Параметри керування виконанням **config\_cache\_reload** Перезавантажити кеш конфігурації. Ігнорується, якщо зараз завантажується кеш. Файл конфігурації за замовчуванням (якщо не вказано параметр **-c**) використовуватиметься для пошуку файлу PID, а сигнал буде надіслано до процесу, зазначеного у файлі PID. **snmp\_cache\_reload** Перезавантажте кеш SNMP, очистити властивості SNMP (engine time, engine boots, engine id, credentials) для всіхвузлів мережі. **housekeeper\_execute** Запустити housekeeper. Ігнорується, якщо зараз запущений housekeeper. **trigger_housekeeper\_execute** Запустити housekeeper для тригерів (усунути проблеми для видалених тригерів). Ігнорується, якщо наразі виконується housekeeper для тригерів. **diaginfo**\[=*section*\] Реєстрація внутрішньої діагностичної інформації вказаного розділу. Розділ може бути *historycache*, *preprocessing*, *alerting*, *lld*, *valuecache*, *locks*. За замовчуванням реєструється діагностична інформація всіх розділів. **ha_status** Журнал стану кластера високої доступності (HA). #### Scenario #### Сценарій #### Scripts Configure and execute scripts to help you with your daily tasks. [Script API](/manual/api/reference/script) #### Скрипти Налаштування та виконання сценаріїв, які допоможуть вам виконувати щоденні завдання. [API скриптів](/manual/api/reference/script) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) - [Script](/manual/api/reference/script/object) ### Дивись також - [Фільтр дій](object#action_filter) - [Операція дії](object#action_operation) ### See also - [Audit log object](/manual/api/reference/auditlog/object) ### Дивись також - [Об'єкт журналу аудиту](/manual/api/reference/auditlog/object) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### Дивись також - [Фільтр кореляції](object#correlation_filter) - [Операція кореляції](object#correlation_operation) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### Дивись також - [Сторінка інформаційної панелі](object#dashboard_page) - [Віджет інформаційної панелі](object#dashboard_widget) - [Поле віджета інформаційної панелі](object#dashboard_widget_field) - [Користувач інформаційної панелі](object#dashboard_user) - [Група користувачів панелі інструментів](object#dashboard_user_group) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) - [Host](/manual/api/reference/host/object#host) ### Дивись також - [Виявлений хост](/manual/api/reference/dhost/object#discovered_host) - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) - [Хост](/manual/api/reference/host/object#host) ### See also - [Discovered service](/manual/api/reference/dservice/object#discovered_service) - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) ### Дивись також - [Виявлена служба](/manual/api/reference/dservice/object#discovered_service) - [Правило виявлення](/manual/api/reference/drule/object#discovery_rule) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### Дивись також - [Перевірка виявлення](/manual/api/reference/dcheck/object#discovery_check) ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) ------------------------------------------------------------------------ [ ]{#index} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) -------------------------------------------------- ---------------------- [ ]{#index} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ## ДИВІТЬСЯ ТАКОЖ Документація <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### Дивись також - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### Дивись також - [Елемент графіка](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph](/manual/api/reference/graph/object#graph) ### Дивись також - [Графік](/manual/api/reference/graph/object#graph) ### See also - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Host](/manual/api/reference/host/object#host) - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) - [LLD rule filter](object#lld_rule_filter) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### Дивись також - [Прототип графіка](/manual/api/reference/graphprototype/object#graph_prototype) - [Хост](/manual/api/reference/host/object#host) - [Прототип елемента](/manual/api/reference/itemprototype/object#item_prototype) - [Фільтр правил LLD](object#lld_rule_filter) - [Прототип тригера](/manual/api/reference/triggerprototype/object#trigger_prototype) ### See also - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### Дивись також - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### See also - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### Дивись також - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### Дивись також - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### See also - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### Дивись також - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Елемент](/manual/api/reference/item/object#item) ### See also - [Host](/manual/api/reference/host/object#host) - [Media type](/manual/api/reference/mediatype/object#media_type) - [User](/manual/api/reference/user/object#user) ### Дивись також - [Хост](/manual/api/reference/host/object#host) - [Тип медіа](/manual/api/reference/mediatype/object#media_type) - [Користувач](/manual/api/reference/user/object#user) ### See also - [host.update](update) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### Дивись також - [host.update](оновити) - [Група хостів](/manual/api/reference/hostgroup/object#host_group) - [Шаблон](/manual/api/reference/template/object#template) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) ### See also - [host.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### Дивись також - [host.update](оновити) - [Макрос користувача](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Інтерфейс хоста](/manual/api/reference/hostinterface/object#host_interface) ### See also - [LLD rule filter](object#lld_rule_filter) - [LLD macro paths](object#lld_macro_path) - [LLD rule preprocessing](object#lld_rule_preprocessing) ### Дивись також - [Фільтр правил LLD](object#lld_rule_filter) - [Шляхи макросу LLD](object#lld_macro_path) - [Попередня обробка правила LLD](object#lld_rule_preprocessing) ### See also - [Scenario step](object#scenario_step) ### Дивись також - [Крок сценарію](object#scenario_step) ### See also - [Scenario step](object#scenario_step) ### Дивись також - [Крок сценарію](object#scenario_step) #### Service Level Agreement Define Service Level Objectives (SLO), retrieve detailed Service Level Indicators (SLI) information about service performance. [SLA API](/manual/api/reference/sla) #### Угода про рівень обслуговування Визначення цілей рівня обслуговування (SLO), отримання детальних індикаторів рівня обслуговування (SLI) продуктивністі сервісу. [SLA API](/manual/api/reference/sla) #### Services Manage services for service-level monitoring and retrieve detailed SLA information about any service. [Service API](/manual/api/reference/service) #### Сервіси Керуйте сервісами для моніторингу рівня обслуговування та отримуйте детальну інформацію про SLA будь-якого сервісу. [API сервісу](/manual/api/reference/service) ## Services The Zabbix API allows you to access data gathered during service monitoring. ## Сервіси Zabbix API дозволяє отримати доступ до зібраних даних під час моніторингу сервісу. #### Slideshow It is possible to activate a slideshow in the dashboard: - `/zabbix.php?action=dashboard.view&slideshow=1` - activate slideshow #### Слайд-шоу Слайд-шоу можна активувати на інформаційній панелі: - `/zabbix.php?action=dashboard.view&slideshow=1` - активувати показ слайдів ### Source CAction::create() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::create() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::delete() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::delete() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::get() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::get() у *ui/include/classes/api/services/CAction.php*. ### Source CAction::update() in *ui/include/classes/api/services/CAction.php*. ### Джерело CAction::update() у *ui/include/classes/api/services/CAction.php*. ### Source CAlert::get() in *ui/include/classes/api/services/CAlert.php*. ### Джерело CAlert::get() у *ui/include/classes/api/services/CAlert.php*. ### Source CAPIInfo::version() in *ui/include/classes/api/services/CAPIInfo.php*. ### Джерело CAPIInfo::version() у *ui/include/classes/api/services/CAPIInfo.php*. ### Source CAuditLog::get() in *ui/include/classes/api/services/CAuditLog.php*. ### Джерело CAuditLog::get() у *ui/include/classes/api/services/CAuditLog.php*. ### Source CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### Джерело CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### Source CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### Джерело CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### Source CConfiguration::export() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::export() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::importcompare() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CConfiguration::import() in *ui/include/classes/api/services/CConfiguration.php*. ### Джерело CConfiguration::import() в *ui/include/classes/api/services/CConfiguration.php*. ### Source CCorrelation::create() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::create() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::delete() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::delete() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::get() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::update() in *ui/include/classes/api/services/CCorrelation.php*. ### Джерело CCorrelation::update() в *ui/include/classes/api/services/CCorrelation.php*. ### Source CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::create() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::delete() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::get() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### Джерело CDashboard::update() в *ui/include/classes/api/services/CDashboard.php*. ### Source CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### Джерело CDCheck::get() в *ui/include/classes/api/services/CDCheck.php*. ### Source CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Джерело CDHost::get() в *ui/include/classes/api/services/CDHost.php*. ### Source CDiscoveryRule::create() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::create() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::delete() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::delete() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::get() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::get() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::update() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Джерело CDiscoveryRule::update() в *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::create() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::delete() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::get() у *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### Джерело CDRule::update() в *ui/include/classes/api/services/CDRule.php*. ### Source CDService::get() in *ui/include/classes/api/services/CDService.php*. ### Джерело CDService::get() в*ui/include/classes/api/services/CDService.php*. ### Source CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### Джерело CEvent::acknowledge() в *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### Джерело CEvent::get() в *ui/include/classes/api/services/CEvent.php*. ### Source CGraph::create() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::create() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::delete() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::get() у *ui/include/classes/api/services/CGraph.php*. ### Source CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### Джерело CGraphItem::get() у *ui/include/classes/api/services/CGraphItem.php*. ### Source CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::create() в *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::delete() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::get() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Джерело CGraphPrototype::update() у *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### Джерело CGraph::update() у *ui/include/classes/api/services/CGraph.php*. ### Source CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### Джерело CHaNode::get() у *ui/include/classes/api/services/CHaNode.php*. ### Source CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### Джерело CHistory::clear() у *ui/include/classes/api/services/CHistory.php*. ### Source CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ### Джерело CHistory::get() у *ui/include/classes/api/services/CHistory.php*. ### Source CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::create() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::delete() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::delete() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::get() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::get() в *ui/include/classes/api/services/CHost.php*. ### Source CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::create() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::delete() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::delete() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::get() у *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massAdd() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massRemove() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::massUpdate() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### Джерело CHostGroup::update() в *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::create() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::delete() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::get() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::massAdd() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::massRemove() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::replaceHostInterfaces() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### Джерело CHostInterface::update() в *ui/include/classes/api/services/CHostInterface.php*. ### Source CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massAdd() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massRemove() в *ui/include/classes/api/services/CHost.php*. ### Source CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::massUpdate() в *ui/include/classes/api/services/CHost.php*. ### Source CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::create() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::delete() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::get() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### Джерело CHostPrototype::update() в *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHost::update() in *ui/include/classes/api/services/CHost.php*. ### Джерело CHost::update() в *ui/include/classes/api/services/CHost.php*. ### Source CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Джерело CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Джерело CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::delete() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::get() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ### Джерело CHttpTest::update() в *ui/include/classes/api/services/CHttpTest.php*. ### Source CIconMap::create() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::create() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::delete() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::get() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::get() в *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::update() in *ui/include/classes/api/services/CIconMap.php*. ### Джерело CIconMap::update() в *ui/include/classes/api/services/CIconMap.php*. ### Source CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::create() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::delete() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::delete() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::get() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::get() в *ui/include/classes/api/services/CImage.php*. ### Source CImage::update() in *ui/include/classes/api/services/CImage.php*. ### Джерело CImage::update() в *ui/include/classes/api/services/CImage.php*. ### Source CItem::create() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::create() в *ui/include/classes/api/services/CItem.php*. ### Source CItem::delete() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::delete() в *ui/include/classes/api/services/CItem.php*. ### Source CItem::get() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::get() в *ui/include/classes/api/services/CItem.php*. ### Source CItemPrototype::create() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::create() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::delete() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::delete() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::get() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::get() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItemPrototype::update() in *ui/include/classes/api/services/CItemPrototype.php*. ### Джерело CItemPrototype::update() в *ui/include/classes/api/services/CItemPrototype.php*. ### Source CItem::update() in *ui/include/classes/api/services/CItem.php*. ### Джерело CItem::update() в *ui/include/classes/api/services/CItem.php*. ### Source CMaintenance::create() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::create() в *ui/include/classes/api/services/CMaintenance.php*. ### Source CMaintenance::delete() in *ui/include/classes/api/services/CMaintenance.php*. ### Джерело CMaintenance::delete() в *ui/include/classes/api/services/CMaintenance.php*. ##### Step 1 Install Kerberos package. For Debian/Ubuntu: apt install krb5-user For RHEL: dnf install krb5-workstation ##### Крок 1 Встановіть пакет Kerberos. Для Debian/Ubuntu: apt install krb5-user Для RHEL: dnf install krb5-workstation ##### Step 1 To define your own theme you'll need to create a CSS file and save it in the `assets/styles/` folder (for example, *custom-theme.css*). You can either copy the files from a different theme and create your theme based on it or start from scratch. ##### Крок 1 Щоб визначити власну тему, вам потрібно створити файл CSS і зберегти його в папці `assets/styles/` (наприклад, *custom-theme.css*). Ви можете або скопіювати файли з іншої теми та створити свою тему на її основі, або почати з нуля. ##### Step 2 Add your theme to the list of themes returned by the APP::getThemes() method. You can do this by overriding the ZBase::getThemes() method in the APP class. This can be done by adding the following code before the closing brace in *include/classes/core/APP.php*: public static function getThemes() { return array_merge(parent::getThemes(), [ 'custom-theme' => _('Custom theme') ]); } ::: noteimportant Note that the name you specify within the first pair of quotes must match the name of the theme file without extension. ::: To add multiple themes, just list them under the first theme, for example: public static function getThemes() { return array_merge(parent::getThemes(), [ 'custom-theme' => _('Custom theme'), 'anothertheme' => _('Another theme'), 'onemoretheme' => _('One more theme') ]); } Note that every theme except the last one must have a trailing comma. ::: notetip To change graph colors, the entry must be added in the *graph\_theme* database table. ::: ##### Крок 2 Додайте свою тему до списку тем, які повертає метод APP::getThemes(). Це можна зробити, перевизначивши метод ZBase::getThemes() у класі APP. Це можна зробити, додавши такий код перед закриваючою дужкою в *include/classes/core/APP.php*: · public static function getThemes() { · return array_merge(parent::getThemes(), [ · 'custom-theme' => _('Custom theme') · ]); · } ::: noteimportant Зауважте, що назва, яку ви вказуєте в першій парі лапок, має збігатися з назвою файлу теми без розширення. ::: Щоб додати кілька тем, просто перелічіть їх під першою темою, наприклад: · public static function getThemes() { · return array_merge(parent::getThemes(), [ · 'custom-theme' => _('Custom theme'), · 'anothertheme' => _('Another theme'), · 'onemoretheme' => _('One more theme') · ]); · } Зауважте, що кожна тема, крім останньої, повинна мати кінцеву кому. ::: підказка Щоб змінити кольори графіка, потрібно додати запис у таблицю бази даних *graph\_theme*. ::: ##### Step 2 Configure Kerberos configuration file (see MIT documentation for details) ``` {.java} cat /etc/krb5.conf [libdefaults] default_realm = EXAMPLE.COM # The following krb5.conf variables are only for MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` ##### Крок 2 Налаштувати файл конфігурації Kerberos (докладніше див. у документації MIT) ``` {.java} cat /etc/krb5.conf [libdefaults] default_realm = EXAMPLE.COM # The following krb5.conf variables are only for MIT Kerberos. kdc_timesync = 1 ccache_type = 4 forwardable = true proxiable = true [realms] EXAMPLE.COM = { } [domain_realm] .example.com=EXAMPLE.COM example.com=EXAMPLE.COM ``` ##### Step 3 Activate the new theme. In Zabbix frontend, you may either set this theme to be the default one or change your theme in the user profile. Enjoy the new look and feel! ##### Крок 3 Активуйте нову тему. У інтерфейсі Zabbix ви можете або встановити цю тему як тему за замовчуванням, або змінити свою тему в профілі користувача. Насолоджуйтесь новим зовнішнім виглядом! ##### Step 3 Create a Kerberos ticket for user *zabbix*. Run the following command as user *zabbix*: kinit zabbix ::: noteimportant It is important to run the above command as user *zabbix*. If you run it as *root* the authentication will not work. ::: ##### Крок 3 Створіть квиток Kerberos для користувача *zabbix*. Виконайте наступну команду від імені користувача *zabbix*: kinit zabbix ::: noteimportant Важливо виконати наведену вище команду як користувач *zabbix*. Якщо ви запустите його як *root*, автентифікація не працюватиме. ::: ##### Step 4 Create a web scenario or HTTP agent item with Kerberos authentication type. Optionally can be tested with the following curl command: curl -v --negotiate -u : http://example.com Note that for lengthy web monitoring it is necessary to take care of renewing the Kerberos ticket. Default time of ticket expiration is 10h. ##### Крок 4 Створіть веб-сценарій або елемент HTTP-агента з типом автентифікації Kerberos. Додатково можна перевірити за допомогою такої команди curl: curl -v --negotiate -u : http://example.com Зверніть увагу, що для тривалого веб-моніторингу необхідно подбати про оновлення квитка Kerberos. За замовчуванням термін дії квитка становить 10 годин. ### Structure The API consists of a number of methods that are nominally grouped into separate APIs. Each of the methods performs one specific task. For example, the `host.create` method belongs to the *host* API and is used to create new hosts. Historically, APIs are sometimes referred to as "classes". ::: notetip Most APIs contain at least four methods: `get`, `create`, `update` and `delete` for retrieving, creating, updating and deleting data respectively, but some APIs may provide a totally different set of methods. ::: ### Структура API складається з кількох методів, номінально згрупованих у окремі API. Кожен із методів виконує одну певну задачу. Наприклад, метод `host.create` належить до API *host* і використовується для створення нових хостів. Історично так склалось, що API іноді називають "класами". ::: notetip Більшість API містять принаймні чотири методи: `get`, `create`, `update` і `delete` для отримання, створення, оновлення та видалення даних відповідно, але деякі API можуть надавати повністю різний набір методів. ::: #### Structure The content of this manual is divided into sections and subsections to provide easy access to particular subjects of interest. When you navigate to respective sections, make sure that you expand section folders to reveal full content of what is included in subsections and individual pages. Cross-linking between pages of related content is provided as much as possible to make sure that relevant information is not missed by the users. #### Структура Зміст цього посібника поділено на розділи та підрозділи для того, щоб забезпечити легкий доступ до певних тем, які вас цікавлять. Коли ви переходите до відповідних розділів, переконайтеся, що ви розгорнули папки розділів, щоб побачити повний зміст того, що міститься в підрозділах та окремих сторінках. Перехресні посилання між сторінками пов'язаного контенту надаються настільки, наскільки це можливо, для того, щоб переконатися, що відповідна інформація не буде пропущена користувачами. ## SYNOPSIS **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2** \[**-c** *config-file*\] **-T**\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## СИНТАКСИС **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] \[**-v**\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2** \[**-c** *config-file*\] **-T**\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## SYNOPSIS **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd** \[**-c** *config-file*\] **-T**\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd** \[**-c** *config-file*\] **-T**\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *номер-порту*\] \[**-I** *IP-адреса*\] \[**-t** *тайм-аут*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *номер порту*\] \[**-I** *IP-адреса*\] \[**-t** *час очікування*\] **--tls-connect** **cert** **--tls-ca-файл** *CA-файл* \[**--tls-crl-файл** *CRL-файл*\] \[**--tls-agent-cert-issuer** *сертифікат-емітент*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *файл-сертифіката* **--tls-key-file** *key-file* \[**--tls-cipher13** *шифр-рядок*\] \[**--tls-cipher** *шифр-рядок*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -s** *ім'я-хоста-або-IP* \[**-p** *port-number*\] \[**-I** *IP-адреса*\] \[**-t** *час очікування*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-ідентифікація* **--tls-psk-файл** *PSK-файл* \[**--tls-cipher13** *шифр-рядок*\] \[**--tls-cipher** *шифр-рядок*\] **-k** *ключ-елементу-даних*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_proxy** \[**-c** *config-file*\]\ **zabbix\_proxy** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_proxy** \[**-c** *config-file*\] **-T**\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_proxy** \[**-c** *конфігураційний файл*\]\ **zabbix\_proxy** \[**-c** *конфігураційний файл*\] **-R** *параметр виконання*\ **zabbix\_proxy** \[**-c** *config-file*\] **-T**\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server** \[**-c** *config-file*\] **-T**\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server** \[**-c** *config-file*\] **-T**\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service** \[**-c** *config-file*\] **-T**\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} ## СИНТАКСИС **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service** \[**-c** *config-file*\] **-T**\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} #### Tasks Interact with Zabbix server task manager, creating tasks and retrieving response. [Task API](/manual/api/reference/task) #### Завдання Взаємодійте з диспетчером завдань сервера Zabbix, створюючи та отримуючи відповідь. [API завдання](/manual/api/reference/task) #### Templates and template groups Manage templates and link them to hosts or other templates. [Template API](/manual/api/reference/template) | [Template group API](/manual/api/reference/templategroup) | [Value map API](/manual/api/reference/valuemap) #### Шаблони та групи шаблонів Керування шаблонами та приєднання їх до хостів чи інших шаблонів. [API шаблону](/manual/api/reference/template) | [API групи шаблонів](/manual/api/reference/templategroup) | [API конвертованихзначень](/manual/api/reference/valuemap) The ***getUpdateRequestData()*** method prepares the server request data for updating the widget by gathering various properties and their corresponding values (widget identifiers, filter settings, time ranges, etc.) from the widget's state and configuration, and constructing a data object that represents the necessary information to be sent to the server in the update request. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js getUpdateRequestData() { return { templateid: this._dashboard.templateid ?? undefined, dashboardid: this._dashboard.dashboardid ?? undefined, widgetid: this._widgetid ?? undefined, name: this._name !== '' ? this._name : undefined, fields: Object.keys(this._fields).length > 0 ? this._fields : undefined, view_mode: this._view_mode, edit_mode: this._is_edit_mode ? 1 : 0, dynamic_hostid: this._dashboard.templateid !== null || this.supportsDynamicHosts() ? (this._dynamic_hostid ?? undefined) : undefined, ...this._contents_size }; } ``` Метод ***getUpdateRequestData()*** готує дані для запиту на оновлення віджета, збираючи різні властивості та відповідні їм значення (ідентифікатори віджета, налаштування фільтрів, часові діапазони тощо) зі стану та конфігурації віджета і створюючи об'єкт даних, який представляє необхідну інформацію, що надсилається на сервер у запиті на оновлення. Цей метод викликається лише як частина методу за замовчуванням *promiseUpdate()*, тобто під час процесу оновлення віджета. Реалізація за замовчуванням: ```js getUpdateRequestData() { return { templateid: this._dashboard.templateid ?? undefined, dashboardid: this._dashboard.dashboardid ?? undefined, widgetid: this._widgetid ?? undefined, name: this._name !== '' ? this._name : undefined, fields: Object.keys(this._fields).length > 0 ? this._fields : undefined, view_mode: this._view_mode, edit_mode: this._is_edit_mode ? 1 : 0, dynamic_hostid: this._dashboard.templateid !== null || this.supportsDynamicHosts() ? (this._dynamic_hostid ?? undefined) : undefined, ...this._content_size }; } ``` The ***hasPadding()*** method is responsible for applying an 8px vertical padding at the bottom of the widget when it is configured to [show its header](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters). This method is invoked when the dashboard page is activated, that is, when it becomes the displayed page in the user interface. Default implementation: ```js hasPadding() { return this.getViewMode() !== ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER; } ``` For some widgets it is necessary to use all of the available widget space to configure, for example, a custom background color. The following is an example of the implementation of the *hasPadding()* method used in the Zabbix-native [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value) widget. ```js hasPadding() { return false; } ``` Метод ***hasPadding()*** відповідає за застосування вертикального відступу 8px внизу віджета, коли він налаштований на [відображення його заголовку](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters). Цей метод викликається, коли сторінка дашборда активована, тобто коли вона стає сторінкою, що відображається в інтерфейсі користувача. Реалізація за замовчуванням: ```js hasPadding() { return this.getViewMode() !== ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER; } ``` Для деяких віджетів необхідно використовувати весь доступний простір віджету, щоб налаштувати, наприклад, користувацький колір фону. Нижче наведено приклад реалізації методу *hasPadding()*, який використовується у віджеті [*Значення елементу даних*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value), що є нативним для Zabbix. ```js hasPadding() { return false; } ``` The ***onActivate()*** method makes the widget active and interactive by enabling custom event listeners (for responding to user actions) and initiating the widget update cycle (for keeping its content up-to-date). This method is invoked when the dashboard page is activated, that is, when it becomes fully displayed in the user interface. Note that before the *onActivate()* method is invoked, the widget is in the inactive state (`WIDGET_STATE_INACTIVE`). After successful invocation, the widget transitions to the active state (`WIDGET_STATE_ACTIVE`). In the active state, the widget is responsive, listens to events, updates its content periodically, and can interact with other widgets. Example: ```js onActivate() { this._startClock(); this._resize_observer = new ResizeObserver(this._events.resize); this._resize_observer.observe(this._target); } ``` Метод ****onActivate()*** робить віджет активним та інтерактивним, вмикаючи користувацькі listener-и подій (для реагування на дії користувача) та ініціюючи цикл оновлення віджета (для підтримання його вмісту в актуальному стані). Цей метод викликається, коли сторінка дашборду активована, тобто коли вона стає повністю відображеною в інтерфейсі користувача. Зверніть увагу, що до виклику методу *onActivate()* віджет знаходиться в неактивному стані (`WIDGET_STATE_INACTIVE`). Після успішного виклику віджет переходить в активний стан (`WIDGET_STATE_ACTIVE`). В активному стані віджет реагує на події, періодично оновлює свій вміст і може взаємодіяти з іншими віджетами. приклад: ```js onActivate() { this._startClock(); this._resize_observer = new ResizeObserver(this._events.resize); this._resize_observer.observe(this._target); } ``` The ***onDeactivate()*** method stops any activity and interactivity of the widget by deactivating custom event listeners and stopping the widget update cycle. This method is invoked when the dashboard page is deactivated, that is, switched away or deleted, or when the widget is deleted from the dashboard page. Note that before the *onDeactivate()* method is invoked, the widget is in the active state (`WIDGET_STATE_ACTIVE`). After successful invocation, the widget transitions to the inactive state (`WIDGET_STATE_INACTIVE`). Example: ```js onDeactivate() { this._stopClock(); this._resize_observer.disconnect(); } ``` Метод ***onDeactivate()*** зупиняє будь-яку активність та інтерактивність віджета, деактивуючи користувацькі listener-и подій та зупиняючи цикл оновлення віджета. Цей метод викликається, коли сторінка інформаційної панелі деактивована, тобто переключена або видалена, або коли віджет видалено зі сторінки інформаційної панелі. Зверніть увагу, що до виклику методу *onDeactivate()* віджет знаходиться в активному стані (`WIDGET_STATE_ACTIVE`), після успішного виклику віджет переходить в неактивний стан (`WIDGET_STATE_INACTIVE`). приклад: ```js onDeactivate() { this._stopClock(); this._resize_observer.disconnect(); } ``` The ***onDestroy()*** method performs cleanup tasks before the widget is deleted from the dashboard, which can include closing a database connection that was established during widget initialization, cleaning up temporary data to free up system memory and avoid resource leaks, unregistering event listeners related to resize events or button clicks to prevent unnecessary event handling and memory leaks, etc. This method is invoked when the widget or the dashboard page that contains it is deleted. Note that before the *onDestroy()* method is invoked, a widget in an active state (`WIDGET_STATE_ACTIVE`) is always deactivated with the invocation of the *onDeactivate()* method. Example: ```js onDestroy() { if (this._filter_widget) { this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_MARK, this._events.mark); this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_SELECT, this._events.select); } } ``` Метод ***onDestroy()*** виконує завдання очищення перед видаленням віджета з панелі інструментів, які можуть включати закриття з'єднання з базою даних, яке було встановлено під час ініціалізації віджета, очищення тимчасових даних, щоб звільнити системну пам'ять і уникнути витоку ресурсів, скасування реєстрації listener-ів подій, пов'язаних зі зміною розміру або натисканням кнопок, щоб запобігти непотрібній обробці подій і витоку пам'яті тощо. Цей метод викликається, коли видаляється віджет або сторінка інформаційної панелі, яка його містить. Зверніть увагу, що перед викликом методу *onDestroy()* віджет в активному стані (`WIDGET_STATE_ACTIVE`) завжди деактивується викликом методу *onDeactivate()*. приклад: ```js onDestroy() { if (this._filter_widget) { this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_MARK, this._events.mark); this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_SELECT, this._events.select); } } ``` The ***onEdit()*** method defines the appearance and behavior of the widget when the dashboard transitions into editing mode. This method is invoked when the dashboard transitions into editing mode, typically when a user interacts with the widget's *Edit* button or the dashboard's *Edit dashboard* button. Example: ```js onEdit() { this._deactivateGraph(); } ``` Метод **onEdit()*** визначає зовнішній вигляд і поведінку віджета, коли інформаційна панель переходить у режим редагування. Цей метод викликається, коли інформаційна панель переходить у режим редагування, зазвичай, коли користувач взаємодіє з кнопкою *Редагувати* віджета або кнопкою *Редагувати інформаційну панель* на інформаційній панелі. приклад: ```js onEdit() { this._deactivateGraph(); } ``` The ***onInitialize()*** method defines the initial state and/or values of the widget, without performing any HTML or data manipulation. This method is invoked when a widget is created (a widget object is instantiated), typically by adding the widget to a dashboard page or loading the dashboard page. Example: ```js onInitialize() { this._time_offset = 0; this._interval_id = null; this._clock_type = CWidgetClock.TYPE_ANALOG; this._time_zone = null; this._show_seconds = true; this._time_format = 0; this._tzone_format = 0; this._show = []; this._has_contents = false; this._is_enabled = true; } ``` Метод ***onInitialize()*** визначає початковий стан та/або значення віджета, не виконуючи жодних маніпуляцій з HTML або даними. Цей метод викликається при створенні віджета (екземплярі об'єкта віджета), як правило, шляхом додавання віджета на сторінку інформаційної панелі або завантаження сторінки інформаційної панелі. приклад: ```js onInitialize() { this._time_offset = 0; this._interval_id = null; this._clock_type = CWidgetClock.TYPE_ANALOG; this._time_zone = null; this._show_seconds = true; this._time_format = 0; this._tzone_format = 0; this._show = []; this._has_contents = false; this._is_enabled = true; } ``` The ***onResize()*** method is responsible for adjusting widget's visual elements to accommodate the new widget size, which can include rearranging elements, adjusting element dimensions, text truncation, implementing lazy loading to improve responsiveness during resizing, etc. This method is invoked when the widget is resized, for example, when the user manually resizes the widget or when the browser window is resized. Example: ```js onResize() { if (this.getState() === WIDGET_STATE_ACTIVE) { this._startUpdating(); } } ``` Метод ***onResize()*** відповідає за адаптацію візуальних елементів віджета до нового розміру віджета, яка може включати перестановку елементів, регулювання розмірів елементів, усічення тексту, реалізацію лінивого завантаження для поліпшення відгуку при зміні розміру і т.д. Цей метод викликається при зміні розміру віджета, наприклад, коли користувач вручну змінює розмір віджета або коли змінюється розмір вікна браузера. Приклад: ```js onResize() { if (this.getState() === WIDGET_STATE_ACTIVE) { this._startUpdating(); } } ``` The ***onStart()*** method defines the HTML structure of the widget, without performing any data manipulation. This method is invoked before the first activation of the dashboard page, that is, before the dashboard and its widgets are fully displayed to the user. Example: ```js onStart() { this._events.resize = () => { const padding = 25; const header_height = this._view_mode === ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER ? 0 : this._header.offsetHeight; this._target.style.setProperty( '--content-height', `${this._cell_height * this._pos.height - padding * 2 - header_height}px` ); } } ``` Метод ***onStart()*** визначає HTML-структуру віджета, не виконуючи жодних маніпуляцій з даними. Цей метод викликається перед першою активацією сторінки дашборду, тобто перед тим, як дашборд та його віджети будуть повністю відображені користувачеві. приклад: ```js onStart() { this._events.resize = () => { const padding = 25; const header_height = this._view_mode == ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER ? 0 : this._header.offsetHeight; this._target.style.setProperty( '--content-height', `${this._cell_height * this._pos.height - padding * 2 - header_height}px` ); } } ``` The ***processUpdateErrorResponse(error)*** method handles the response received from the server after the update request if the response is an error, and displays the error message/-s. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js processUpdateErrorResponse(error) { this._updateMessages(error.messages, error.title); } ``` Метод ***processUpdateErrorResponse(error)*** обробляє відповідь, отриману від сервера після запиту на оновлення, якщо відповідь є помилковою, і виводить повідомлення про помилку. Цей метод викликається тільки як частина стандартного методу *promiseUpdate()*, тобто під час процесу оновлення віджету. Реалізація за замовчуванням: ```js processUpdateErrorResponse(error) { this._updateMessages(error.messages, error.title); } ``` The ***processUpdateResponse(response)*** method handles the response received from the server after the update request, and, if the update process has been successful and without errors, clears widget data and displays new contents with the *setContents()* method. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js processUpdateResponse(response) { this._setHeaderName(response.name); this._updateMessages(response.messages); this._updateInfo(response.info); this._updateDebug(response.debug); this.setContents(response); } ``` Метод ***processUpdateResponse(response)*** обробляє відповідь, отриману від сервера після запиту на оновлення, і, якщо процес оновлення пройшов успішно і без помилок, очищає дані віджета і відображає новий вміст методом *setContents()*. Цей метод викликається тільки в складі методу за замовчуванням *promiseUpdate()*, тобто під час процесу оновлення віджета. Реалізація за замовчуванням: ```js processUpdateResponse(response) { this._setHeaderName(response.name); this._updateMessages(response.messages); this._updateInfo(response.info); this._updateDebug(response.debug); this.setContents(response); } ``` The ***promiseUpdate()*** method initiates the data update process by retrieving data, typically using web requests or API calls. This method is invoked when a dashboard page is displayed and periodically after, until the dashboard page is switched to another dashboard page. The following is an example of the default implementation of the *promiseUpdate()* method used by most Zabbix-native widgets. In the default implementation, the *promiseUpdate()* method follows a general pattern for retrieving data from the server. It creates a new `Curl` object with the appropriate URL and request parameters, sends a `POST` request using the *fetch()* method with the data object constructed by the *getUpdateRequestData()* method, and processes the response (or an error response) with the *processUpdateResponse(response)* or *processUpdateErrorResponse(error)* accordingly. This implementation is suitable for most widgets as they typically retrieve data in a JSON format and handle it in a consistent manner. ```js promiseUpdate() { const curl = new Curl('zabbix.php'); curl.setArgument('action', `widget.${this._type}.view`); return fetch(curl.getUrl(), { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(this.getUpdateRequestData()), signal: this._update_abort_controller.signal }) .then((response) => response.json()) .then((response) => { if ('error' in response) { this.processUpdateErrorResponse(response.error); return; } this.processUpdateResponse(response); }); } ``` Метод ***promiseUpdate()*** ініціює процес оновлення даних шляхом отримання даних, як правило, за допомогою веб-запитів або викликів API. Цей метод викликається під час відображення сторінки дашборду і періодично після цього, поки сторінка дашборду не буде переключена на іншу сторінку дашборду. Нижче наведено приклад реалізації за замовчуванням методу *promiseUpdate()*, який використовується більшістю власних віджетів Zabbix. У стандартній реалізації метод *promiseUpdate()* відповідає загальному шаблону для отримання даних із сервера. Він створює новий об'єкт `Curl` з відповідним URL і параметрами запиту, відправляє запит `POST` методом *fetch()* з об'єктом даних, побудованим методом *getUpdateRequestData()*, і обробляє відповідь (або повідомлення про помилку) за допомогою *processUpdateResponse(response)* або *processUpdateErrorResponse(error)* відповідно. Ця реалізація підходить для більшості віджетів, оскільки вони зазвичай отримують дані у форматі JSON і обробляють їх у незмінний спосіб. ```js promiseUpdate() { const curl = new Curl('zabbix.php'); curl.setArgument('action', `widget.${this._type}.view`); return fetch(curl.getUrl(), { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(this.getUpdateRequestData()), signal: this._update_abort_controller.signal }) .then((response) => response.json()) .then((response) => { if ('error' in response) { this.processUpdateErrorResponse(response.error); return; } this.processUpdateResponse(response); }); } ``` The ***setContents(response)*** method displays widget contents if the widget update process has been successful and without errors, which can include manipulating DOM elements, updating UI components, applying styles or formatting, etc. This method is invoked only as part of the default *processUpdateResponse(response)* method, that is, during the process of handling the response received from the server after the update request. Default implementation: ```js setContents(response) { this._body.innerHTML = response.body ?? ''; } ``` Метод ***setContents(response)*** відображає вміст віджету, якщо процес оновлення віджету пройшов успішно і без помилок, які можуть включати маніпуляції з DOM-елементами, оновлення компонентів інтерфейсу, застосування стилів або форматування і т.д. Цей метод викликається тільки в складі стандартного методу *processUpdateResponse(response)*, тобто в процесі обробки відповіді, отриманої від сервера після запиту оновлення. Реалізація за замовчуванням: ```js setContents(response) { this._body.innerHTML = response.body ?? ''; } ``` This is a step-by-step tutorial that shows how to create a simple dashboard widget. You can download all files of this widget as a ZIP archive: [lesson_gauge_chart.zip](../../../../assets/en/devel/modules/examples/lesson_gauge_chart.zip). Це покрокова інструкція, яка показує, як створити простий віджет інформаційної панелі. ::: noteimportant Мінімальна необхідна версія Zabbix для цієї інструкції – 6.4.4. ::: Ви можете завантажити всі файли цього віджета як ZIP-архів: [lesson_gauge_chart.zip](../../../../assets/en/devel/modules/examples/lesson_gauge_chart.zip). This is a step-by-step tutorial that shows how to create a simple Zabbix frontend module. You can download all files of this module as a ZIP archive: [MyAddress.zip](../../../../assets/en/devel/modules/examples/MyAddress.zip). Це покрокова інструкція, яка показує, як створити простий модуль фронтенду Zabbix. Ви можете завантажити всі файли цього модуля у вигляді ZIP-архіву: [MyAddress.zip](../../../../assets/en/devel/modules/examples/MyAddress.zip). # This topic does not exist yet. We are sorry, the page you are looking for cannot be found. Return to the homepage, try searching, or get [help](https://www.zabbix.com/support). # Цей розділ ще не створено. Нажаль, сторінка яку ви шукаєте не знайдена. Поверніться до домашньої сторінки, спробуйте пошук або отримайте [допомогу](https://www.zabbix.com/support). #### Trends Retrieve trend values calculated by Zabbix server for presentation or further processing. [Trend API](/manual/api/reference/trend) #### Тренди Отримати значення трендів, обчислені сервером Zabbix для презентації або подальшої обробки. [API Трендів](/manual/api/reference/trend) #### Triggers Configure triggers to notify you about problems in your system. Manage trigger dependencies. [Trigger API](/manual/api/reference/trigger) #### Тригери Налаштування тригерів для сповіщення про проблеми у вашій системі. Керування залежностями тригерів. [API тригера](/manual/api/reference/trigger) # Tutorials This section contains practical step-by-step tutorials to illustrate how to build a custom [module](/devel/modules/tutorials/module) and a [widget](/devel/modules/tutorials/widget) in Zabbix. # Інструкції Цей розділ містить практичні покрокові інструкції, що ілюструють, як створити власний [модуль](/devel/modules/tutorials/module) та [віджет](/devel/modules/tutorials/widget) у Zabbix. ### type Type of the module. Required for widgets and must equal "widget". *Type*: String *Default*: "module" *Example*: ```json "type": "widget" ``` ### type Тип модуля. Необхідний для віджетів і має дорівнювати "widget". *Тип*: String *За замовчуванням*: "module" *Приклад*: ```json "type": "widget" ``` ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-server-cert-issuer** *cert-issuer* Allowed server certificate issuer. **--tls-server-cert-subject** *cert-subject* Allowed server certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-v**, **--verbose** Verbose mode, **-vv** for more details. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **unencrypted** підключення без шифрування (за замовчуванням) ```{=html} <!-- --> ``` **psk** підключитися за допомогою TLS і спільного ключа ```{=html} <!-- --> ``` **cert** підключитися за допомогою TLS і сертифіката ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Повний шлях до файлу, що містить сертифікати ЦС верхнього рівня для перевірки однорангових сертифікатів. **--tls-crl-file** *CRL-file* Повний шлях до файлу, що містить анульовані сертифікати. **--tls-server-cert-issuer** *cert-issuer* Дозволений емітент сертифіката сервера. **--tls-server-cert-subject** *cert-subject* Дозволена тема сертифіката сервера. **--tls-cert-file** *cert-file* Повний шлях до файлу, що містить сертифікат або ланцюжок сертифікатів. **--tls-key-file** *key-file* Повний шлях до файлу, що містить закритий ключ. **--tls-psk-identity** *PSK-identity* Рядок ідентифікатора PSK. **--tls-psk-file** *PSK-file* Повний шлях до файлу, що містить попередній спільний ключ. **--tls-cipher13** *cipher-string* Рядок шифру для OpenSSL 1.1.1 або новішої версії для TLS 1.3. Замінити критерії вибору набору шифрів за замовчуванням. Ця опція недоступна, якщо версія OpenSSL не перевищує 1.1.1. **--tls-cipher** *cipher-string* Рядок пріоритету GnuTLS (для TLS 1.2 і вище) або рядок шифру OpenSSL (лише для TLS 1.2). Замінити критерії вибору набору шифрів за замовчуванням. **-v**, **--verbose** Детальний режим, **-vv** для отримання додаткової інформації. **-h**, **--help** Відобразити цю довідку та вийти. **-V**, **--version** Виведіть інформацію про версію та вийдіть. [ ]{#lbAG} ##### Update process methods The widget update process methods are responsible for retrieving updated data from Zabbix server or any other data source and displaying it in the widget. ##### Методи процесу оновлення Методи процесу оновлення віджета відповідають за отримання оновлених даних із сервера Zabbix або будь-якого іншого джерела даних і відображення їх у віджеті. #### Updating an item Enable an item by setting its status to "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.update","params":{"itemid":"10092","status":0},"id":5}' ``` The successful response will contain the ID of the updated item: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 5 } ``` ::: notetip The `item.update` method as well as other *update methods* can also accept arrays of objects and update multiple items with one API call. ::: #### Оновлення елемента даних Увімкніть елемент, встановивши для нього статус "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.update","params":{"itemid":"10092","status":0},"id":5}' ``` Успішна відповідь міститиме ідентифікатор оновленого елемента: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 5 } ``` ::: notetip Метод item.update, а також інші *методи оновлення* також може приймати масиви об’єктів і оновлювати кілька елементів одним викликом API. ::: #### Updating multiple triggers Enable multiple triggers by setting their status to "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.update","params":[{"triggerid":"13938","status":0},{"triggerid":"13939","status":0}],"id":6}' ``` The successful response will contain the IDs of the updated triggers: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938", "13939" ] }, "id": 6 } ``` ::: notetip This is the preferred method of updating. Some API methods, such as the `host.massupdate` allow to write a simpler code. However, it is not recommended to use these methods as they will be removed in the future releases. ::: #### Оновлення кількох тригерів Увімкніть кілька тригерів, встановивши для них статус "0": ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.update","params":[{"triggerid":"13938","status":0},{"triggerid":"13939","status":0}],"id":6}' ``` Успішна відповідь міститиме ідентифікатори оновлених тригерів: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938", "13939" ] }, "id": 6 } ``` ::: notetip Це найкращий метод оновлення. Деякі методи API, такі як `host.massupdate`, дозволяють писати простіший код. Однак не рекомендується використовувати ці методи, оскільки їх буде видалено в наступних випусках. ::: #### Updating problems The problem update popup allows to: - comment on the problem - view comments and actions so far - change problem severity - suppress/unsuppress problem - acknowledge/unacknowledge problem - change symptom problem to cause problem - manually close problem {width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Problem*|If only one problem is selected, the problem name is displayed.<br>If several problems are selected, *N problems selected* is displayed.| |*Message*|Enter text to comment on the problem (maximum 2048 characters).| |*History*|Previous activities and comments on the problem are listed, along with the time and user details.<br>For the meaning of icons used to denote user actions see the [event detail](/manual/web_interface/frontend_sections/monitoring/problems#viewing_details) page.<br>Note that history is displayed if only one problem is selected for the update.| |*Scope*|Define the scope of such actions as changing severity, acknowledging or manually closing problems:<br>**Only selected problem** - will affect this event only<br>**Selected and all other problems of related triggers** - in case of acknowledgment/closing problem, will affect this event and all other problems that are not acknowledged/closed so far. If the scope contains problems already acknowledged or closed, these problems will not be acknowledged/closed repeatedly. On the other hand, the number of message and severity change operations are not limited.| |*Change severity*|Mark the checkbox and click on the severity button to update problem severity.<br>The checkbox for changing severity is available if read-write permissions exist for at least one of the selected problems. Only those problems that are read-writable will be updated when clicking on *Update*.<br>If read-write permissions exist for none of the selected triggers, the checkbox is disabled.| |*Suppress*|Mark the checkbox to suppress the problem:<br>**Indefinitely** - suppress indefinitely<br>**Until** - suppress until a given time. Both [absolute and relative](/manual/web_interface/time_period_selector) time formats are supported, for example:<br>`now+1d` - for one day from now (default)<br>`now/w` - until the end of the current week<br>`2022-05-28 12:00:00` - until absolute date/time<br>Note that a simple period (e. g., `1d`, `1w`) is not supported.<br>Availability of this option depends on the "Suppress problems" user role settings.<br>See also: [Problem suppression](/manual/acknowledgment/suppression)| |*Unsuppress*|Mark the checkbox to unsuppress the problem. This checkbox is active only if at least one of the selected problems is suppressed.<br>Availability of this option depends on the "Suppress problems" user role settings.| |*Acknowledge*|Mark the checkbox to acknowledge the problem.<br>This checkbox is available if there is at least one unacknowledged problem among the selected.<br>It is not possible to add another acknowledgment for an already acknowledged problem (it is possible to add another comment though).| |*Unacknowledge*|Mark the checkbox to unacknowledge the problem.<br>This checkbox is available if there is at least one acknowledged problem among the selected.| |*Convert to cause*|Mark the checkbox to convert the symptom problem(s) to cause problem(s).| |*Close problem*|Mark the checkbox to manually close the selected problem(s).<br>The checkbox for closing a problem is available if the *Allow manual close* option is checked in [trigger configuration](/manual/config/triggers/trigger) for at least one of the selected problems. Only those problems will be closed that are allowed to be closed when clicking on *Update*.<br>If no problem is manually closeable, the checkbox is disabled.<br>Already closed problems will not be closed repeatedly.| #### Оновлення проблем Спливаюче вікно оновлення проблеми дозволяє: - прокоментувати проблему - переглянути коментарі та дії - змінити ступінь серйозності проблеми - приховати/розкрити проблему - підтвердити/непідтвердити проблему - змінити симптом проблеми на її причину - закрити проблему вручну {width="600"} Усі обов’язкові поля для введення позначені червоною зірочкою. |Параметр|Опис| |--|--------| |*Проблема*|Якщо вибрано лише одну проблему, відображається назва проблеми.<br>Якщо вибрано кілька проблем, відображається *N проблем вибрано*.| |*Повідомлення*|Введіть текст для коментаря до проблеми (максимум 2048 символів).| |*Історія*|Наведено попередні дії та коментарі щодо проблеми, а також час і відомості про користувача.<br>Значення піктограм, які використовуються для позначення дій користувача, див. [деталі події](/manual/web_interface/frontend_sections/ monitoring/problems#viewing_details).<br>Зверніть увагу, що історія відображається, якщо для оновлення вибрано лише одну проблему.| |*Область*|Визначте область таких дій, як зміна серйозності, підтвердження чи закриття проблем вручну:<br>**Лише вибрана проблема** – вплине лише на цю подію<br>**Вибрані та всі інші проблеми пов’язаних тригерів ** - у разі проблеми з підтвердженням/закриттям, це вплине на цю подію та всі інші проблеми, які наразі не підтверджені/закриті. Якщо область містить уже підтверджені або вирішені проблеми, ці проблеми не будуть визнаватися/закриватися повторно. З іншого боку, кількість операцій зміни повідомлень і серйозності не обмежена.| |*Змінити серйозність*|Поставте чекбокс і натисніть кнопку серйозності, щоб оновити серйозність проблеми.<br>Чекбокс для зміни серйозності доступний, якщо є дозволи на читання та запис принаймні для однієї з вибраних проблем. Лише ті проблеми, які доступні для читання та запису, будуть оновлені після натискання *Оновити*.<br>Якщо дозволи на читання та запис не існують для жодного з вибраних тригерів, чекбокс буде вимкнено.| |*Приховувати*|Поставте чекбокс, щоб приховати проблему:<br>**На невизначений термін** - приховувати на невизначений термін<br>**До** - приховувати до певного часу. Підтримуються як [абсолютний, так і відносний](/manual/config/visualization/graphs/simple#time-period-selector) формати часу, наприклад:<br>`зараз+1д` - на один день (за замовчуванням)< br>`зараз/с` - до кінця поточного тижня<br>`2022-05-28 12:00:00` - до абсолютної дати/часу<br>Зверніть увагу, що вказання просто періоду (наприклад, `1d` , `1w`) не підтримується.<br>Доступність цього параметра залежить від налаштувань ролі користувача «Приховувати проблеми».<br>Див. також: [Припинення проблеми](/manual/acknowledgment/suppression)| |*Unsuppress*|Позначте поле, щоб скасувати приховування проблеми. Цей прапорець активний, лише якщо принаймні одна з вибраних проблем прихована.<br>Доступність цього параметра залежить від налаштувань ролі користувача «Припинити проблеми».| |*Підтвердити*|Поставте прапорець, щоб підтвердити проблему.<br>Цей прапорець доступний, якщо серед вибраних є принаймні одна непідтверджена проблема.<br>Неможливо додати ще одне підтвердження для вже підтвердженої проблеми (вона але можна додати ще один коментар).| |*Unacknowledge*|Позначте прапорець, щоб скасувати підтвердження проблеми.<br>Цей прапорець доступний, якщо серед вибраних є принаймні одна підтверджена проблема.| |*Перетворити на причину*|Позначте прапорець, щоб перетворити симптом проблеми на причину, що її викликає.| |*Закрити проблему*|Поставте прапорець, щоб вручну закрити вибрану(і) проблему(и).<br>Прапорець для закриття проблеми доступний, якщо опцію *Дозволити закриття вручну* позначено в [конфігурації тригера](/manual/config /triggers/trigger) принаймні для однієї з вибраних проблем. Буде закрито лише ті проблеми, які дозволено закрити, натиснувши *Оновити*.<br>Якщо жодну проблему не можна закрити вручну, прапорець вимкнено.<br>Уже закриті проблеми не будуть закриті повторно.| ### url A link to the module description. For widgets, this link will be opened when clicking on the help icon {class="nozoom"} in the [*Add widget*](/manual/web_interface/frontend_sections/dashboards#adding-widgets) or [*Edit widget*](/manual/web_interface/frontend_sections/dashboards#widgets) window. If **url** is not specified, clicking on the help icon will open the general [Dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets) page. *Type*: String *Example*: ```json "url": "http://example.com" ``` ### url Посилання на опис модуля. Для віджетів це посилання буде відкрито, якщо натиснути піктограму довідки {class="nozoom"} у [*Додати віджет*](/manual/web_interface/frontend_sections/dashboards#adding-widgets) або вікні [*Редагувати віджет*](/manual/web_interface/frontend_sections/dashboards#widgets). Якщо **url** не вказано, клацання піктограми довідки відкриє загальну сторінку [Віджети інформаційної панелі](/manual/web_interface/frontend_sections/dashboards/widgets). *Тип*: String *Приклад*: ```json "url": "http://example.com" ``` #### Users and user groups Add users that will have access to Zabbix, assign them to user groups and grant permissions. Make roles for granular management of user rights. [User API](/manual/api/reference/user) | [User group API](/manual/api/reference/usergroup) | [User directory API](/manual/api/reference/userdirectory) | [User role API](/manual/api/reference/role) #### Користувачі та групи користувачів Додавання користувачів, які матимуть доступ до Zabbix, додавання їх до груп користувачів і надання дозволів. Створення ролей для детального керування правами користувачів. [API користувача](/manual/api/reference/user) | [API Групи користувачів](/manual/api/reference/usergroup) | [API Каталогу користувача](/manual/api/reference/userdirectory) | [API Ролі користувача](/manual/api/reference/role) ## Users The Zabbix API allows you to manage users of your monitoring system. ## Користувачі Zabbix API дозволяє вам керувати користувачами вашої системи моніторингу. #### Using a custom expression filter Create a trigger action that uses a custom expression - "A and (B or C)" - for evaluating action conditions. Once a trigger with a severity higher or equal to "Warning" from host "10084" or host "10106" goes into a PROBLEM state, the action will send a message to all users in user group "7" via media type "1". The formula IDs "A", "B" and "C" have been chosen arbitrarily. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "15m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Використання спеціального фільтра виразів Створіть дію тригера, яка використовує настроюваний вираз - "A і (B або C)" - для оцінки умов дії. Як тільки тригер зі ступенем серйозності рівним або вище «Попередження» з хоста «10084» або хоста «10106» перейде в стан ПРОБЛЕМА, дія надішле повідомлення всім користувачам у групі користувачів «7» через спосіб сповіщення «1». [Запит](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "15m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } } ] }, "id": 1 } ``` Відповідь: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` ### version Module version. The version will be displayed in the Administration section. *Type*: String *Example*: ```json "version": "1.0" ``` ### version Версія модуля. Версія буде відображатися в розділі Адміністрування. *Тип*: String *Приклад*: ```json "version": "1.0" ``` # Views View file receives the data from a controller and then prepares the HTML look of it. :::noteclassic Defining view(s) for a frontend module is optional, unless the module is a widget.\ Dashboard widgets need at least two views: one for the edit mode and one for the view mode (should be stored in the *views* directory). ::: It is possible to use pre-defined Zabbix HTML classes (from the */zabbix/ui/include/classes/html*) in the view as well as add new HTML and CSS classes. New classes should be stored in the module's *assets* folder. Example: ```` ... (new CColHeader(_('Name'))) ```` This will add a new column name *Name* and style the top table row as on other Zabbix pages. # Views View-файл отримує дані від контролера, а потім генерує їх HTML-відображення. :::noteclassic Створювати view-файл для інтерфейсного модуля необов’язково, якщо тільки модуль не є віджетом.\ Для віджетів інформаційної панелі потрібно принаймні два типу view: один для режиму редагування та інший для режиму перегляду (має зберігатися в каталозі *views*). ::: У view-файлах можна використовувати попередньо визначені класи Zabbix HTML (з */zabbix/ui/include/classes/html*), а також додавати нові класи HTML і CSS. Нові класи повинні зберігатися в каталозі модуля *assets* . приклад: ```` ... (new CColHeader(_('Name'))) ```` Це додасть нову назву стовпця *Name* і стилізує верхній рядок таблиці, аналогічно до інших сторінок Zabbix. ## vmware.hv.diskinfo.get The item **vmware.hv.diskinfo.get[]** returns JSON objects with the following structure (values are provided as an example): ```json [ { "instance": "mpx.vmhba32:C0:T0:L0", "hv_uuid": "8002299e-d7b9-8728-d224-76004bbb6100", "datastore_uuid": "", "operational_state": [ "ok" ], "lun_type": "disk", "queue_depth": 1, "model": "USB DISK", "vendor": "SMI Corp", "revision": "1100", "serial_number": "CCYYMMDDHHmmSS9S62CK", "vsan": {} }, { // other instances } ] ``` ## vmware.hv.diskinfo.get The item **vmware.hv.diskinfo.get[]** returns JSON objects with the following structure (values are provided as an example): ```json [ { "instance": "mpx.vmhba32:C0:T0:L0", "hv_uuid": "8002299e-d7b9-8728-d224-76004bbb6100", "datastore_uuid": "", "operational_state": [ "ok" ], "lun_type": "disk", "queue_depth": 1, "model": "USB DISK", "vendor": "SMI Corp", "revision": "1100", "serial_number": "CCYYMMDDHHmmSS9S62CK", "vsan": {} }, { // other instances } ] ``` #### Web monitoring Configure web scenarios to monitor your web applications and services. [Web scenario API](/manual/api/reference/httptest) #### Веб моніторинг Налаштуйте веб-сценарії для моніторингу веб-додатків і служб. [API веб-сценарію](/manual/api/reference/httptest) ### What a module can be used for - Adding new functionality via custom frontend sections; - Creating custom dashboard widget types (see [widget modules](/devel/modules/widgets)); - Overriding or extending the existing functionality. ### Для чого можна використовувати модуль - Додавання нової функціональності через користувацькі розділи інтерфейсу; - Створення користувацьких типів віджетів інформаційної панелі (див. [модулі віджетів](/devel/modules/widgets)); - Заміна або розширення наявної функціональності. ### What a module cannot be used for - Registering a new API method or modifying an existing one. ### Для чого не можна використовувати модуль - Реєстрація нового методу API або зміна існуючого. ### What is a PHP frontend module? - A module is an entity with a unique ID, name, description, author, and other fields defined in it's manifest file, along with PHP, Javascript and other files located in a single directory inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). - A module should conform to simple rules to guarantee correct operation. - A module must be installed (unpacked) and enabled in the frontend by the administrator. ### Що таке PHP frontend модуль ? - Модуль - це сутність з унікальним ідентифікатором, назвою, описом, автором та іншими полями, визначеними у файлі маніфесту, разом з PHP, Javascript та іншими файлами, розташованими в одному каталозі всередині каталогу *modules* вашої інсталяції web-інтерфейсу Zabbix (наприклад, *zabbix/ui/modules*). - Модуль повинен відповідати простим правилам, щоб гарантувати правильну роботу. - Модуль повинен бути встановлений (розпакований) і активований у web-інтерфейсі адміністратором. ## What you'll build During this tutorial, you will first build a [basic](#part-i---hello-world) "Hello, world!" widget and then convert it into a [more advanced](#part-ii---gauge-chart) widget that displays an item value as a gauge chart. Here's how the finished widget will look like: {width="600"} ## Що ви створите У цьому посібнику ви спочатку створите [базовий](#part-i---hello-world) віджет "Hello, world!", а потім перетворите його на [більш просунутий](#part-ii---gauge-chart) віджет, який відображає значення елемента даних у вигляді гістограми.Ось як виглядатиме готовий віджет: {width="600"} ### What you'll build During this tutorial, you will first build a frontend module that adds a new *My Address* menu section and then convert it into a [more advanced](#part-iii---module-action) frontend module that makes an HTTP request to *https://api.seeip.org* and displays the response - the IP address of your computer - on a new page in the newly created *My Address* menu section. Here's how the finished module will look like: {width="600"} ### Що ви створите У цьому уроці ви спочатку створите модуль інтерфейсу, який додає новий розділ меню *Моя адреса*, а потім перетворите його на [більш просунутий] (#part-iii---module-action) модуль інтерфейсу, який робить HTTP-запит до *https://api.seeip.org* і відображає відповідь - IP-адресу вашого комп'ютера - на новій сторінці в новоствореному розділі меню *Моя адреса*. Ось як виглядатиме готовий модуль: {width="600"} ### Where to go next Whether you prefer to learn by doing or read the guidelines first, these pages contain the information and steps required to build your own modules: - [Step-by-step tutorials for writing your first module](/devel/modules/tutorials) - [Module file structure](/devel/modules/file_structure) - [Widget module specifics](/devel/modules/widgets) - [Module examples to reuse](/devel/modules/examples) ### Куди рухатися далі Незалежно від того, чи віддаєте ви перевагу навчанню на практиці, чи спочатку читаєте інструкції, ці сторінки містять інформацію та кроки, необхідні для створення власних модулів: - [Покрокові посібники для написання вашого першого модуля](/devel/modules/tutorials) - [Файлова структура модуля](/devel/modules/file_structure) - [Особливості модуля віджетів](/devel/modules/widgets) - [Приклади модулів для повторного використання](/devel/modules/examples) ### Widget action The widget action class (*WidgetView*) contains methods for operations with widgets in the presentation view mode. The majority of widget actions use and/or extend the default controller class *CControllerDashboardWidgetView*. The widget action class should be located in the *actions* directory and specified in the [*actions*](/devel/modules/file_structure/manifest#actions) parameter (*actions/widget.{id}.view/class*) in the *manifest.json* file. **actions/WidgetView.php example (implemented in the Zabbix-native [*System information*](/manual/web_interface/frontend_sections/dashboards/widgets/system) widget)** ```php class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getDefaultName()), 'system_info' => CSystemInfoHelper::getData(), 'info_type' => $this->fields_values['info_type'], 'user_type' => CWebUser::getType(), 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` ### Widget action Клас дій віджетів (*WidgetView*) містить методи для роботи з віджетами в режимі перегляду презентації. Більшість дій віджетів використовують та/або розширюють клас контролера за замовчуванням *CControllerDashboardWidgetView*. Клас дій віджета має розташовуватися в каталозі *actions* і вказуватися в параметрі [*actions*](/devel/modules/file_structure/manifest#actions) (*actions/widget.{id}.view/class*) у файлі *manifest.json*. **actions/WidgetView.php приклад (реалізований у стандартному для Zabbix віджеті [*Системна інформація*](/manual/web_interface/frontend_sections/dashboards/widgets/system)** ```php class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getDefaultName()), 'system_info' => CSystemInfoHelper::getData(), 'info_type' => $this->fields_values['info_type'], 'user_type' => CWebUser::getType(), 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` ### WidgetForm The *WidgetForm* class extends the default class *CWidgetForm* and contains a set of [*CWidgetField*](#cwidgetfield) fields that are required for defining widget configuration storage structure in the database and handling input validation. The *WidgetForm* class should be located in the *includes* directory. If the class has a different name, the name should be specified in the [*widget/form_class*](/devel/modules/file_structure/manifest#widget) parameter in the *manifest.json* file. **includes/WidgetForm.php example** ```php <?php namespace Modules\MyCustomWidget\Includes; use Modules\MyCustomWidget\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox, CWidgetFieldColor }; class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ); } } ``` ### WidgetForm Клас *WidgetForm* розширює стандартний клас *CWidgetForm* і містить набір полів [*CWidgetField*](#cwidgetfield). які необхідні для визначення структури зберігання конфігурації віджета в базі даних і обробки валідації вхідних даних. Клас *WidgetForm* має бути розташований у каталозі *includes*. Якщо клас має іншу назву, її потрібно вказати в параметрі [*widget/form_class*](/devel/modules/file_structure/manifest#widget) у файлі *manifest.json*. **includes/WidgetForm.php приклад** ```php <?php namespace Modules\MyCustomWidget\Includes; use Modules\MyCustomWidget\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox, CWidgetFieldColor }; class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ); } } ``` ## Widget preview Widget modules, once added, become immediately visible in the dashboard widget list. You can open a dashboard, switch to the edit mode and add the widget to the dashboard as usual. When you make some changes to the widget, refresh the dashboard to view how the widget looks with the most recent updates. ## Попередній перегляд віджета Модулі віджетів після додавання відразу стають видимими в списку віджетів інформаційної панелі. Ви можете відкрити інформаційну панель, перейти в режим редагування та додати віджет на інформаційну панель, як зазвичай. Після внесення змін у віджет, оновіть інформаційну панель, щоб побачити, як виглядає віджет з останніми оновленнями. ### Widget Primary widget class, extends the base class of all dashboard widgets - *CWidget*. Required for overriding the default widget behavior. The *Widget* class should be located in the root directory of the widget (for example, *zabbix/ui/modules/my_custom_widget*). **Widget.php example** ```php <?php namespace Modules\MyCustomWidget; use Zabbix\Core\CWidget; class Widget extends CWidget { public const MY_CONSTANT = 0; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` ### Віджет Основний клас віджетів, розширює базовий клас усіх віджетів інформаційної панелі - *CWidget*. Необхідний для заміни поведінки віджета за замовчуванням. Клас *Widget* має бути розташований у кореневому каталозі віджета (наприклад, *zabbix/ui/modules/my_custom_widget*). **Приклад Widget.php** ```php <?php namespace Modules\MyCustomWidget; use Zabbix\Core\CWidget; class Widget extends CWidget { public const MY_CONSTANT = 0; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` # Widgets Widgets are Zabbix frontend modules used for the dashboards. Unless otherwise noted, all module guidelines are also applicable to widgets. However, a widget is notably different from a module. To build a widget: - specify the type "widget" in the [manifest.json file](/devel/modules/file_structure/manifest) ("type": "widget"); - include at least two views: one for the [widget presentation mode](/devel/modules/widgets/presentation#widget-view) and one for the [widget configuration mode](/devel/modules/widgets/configuration#widget-configuration-view) (example.widget.view.php and example.widget.edit.php); - and a [controller](/devel/modules/widgets/presentation#widget-actions) for widget presentation (WidgetView.php); - use and extend default [widget classes](/devel/modules/widgets/configuration). # Віджети Віджети — це інтерфейсні модулі Zabbix, які використовуються для інформаційних панелей. Якщо не зазначено інше, усі інструкції щодо модуля також застосовуються до віджетів. Однак віджет значно відрізняється від модуля. Щоб створити віджет: - вкажіть тип "widget" у [файлі manifest.json](/devel/modules/file_structure/manifest) ("type": "widget"); - включіть принаймні два view: один для [режиму презентації віджетів](/devel/modules/widgets/presentation#widget-view) і один для [режиму конфігурації віджетів](/devel/modules/widgets/configuration#widget- configuration-view) (example.widget.view.php і example.widget.edit.php); - і [контролер](/devel/modules/widgets/presentation#widget-actions) для представлення віджетів (WidgetView.php); - використовуйте та розширюйте стандартні [класи віджетів](/devel/modules/widgets/configuration). ### Widget view The widget view class (*CWidgetView*) is responsible for building the widget presentation view. The widget view class should be located in the *views* directory. If the file containing the widget view class has a different name than the default (*widget.view.php*), then it must be specified in the *manifest.json* file [*actions*](/devel/modules/file_structure/manifest#actions) parameter (*actions/widget.{id}.view/view*). **views/widget.view.php example** ```php <?php /** * My custom widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, $data['name']) ) ->show(); ``` ### Widget view Клас view віджетів (*CWidgetView*) відповідає за створення представлення view віджетів. Клас view віджета має бути розташований у каталозі *views*. Якщо файл, що містить клас view віджетів, має іншу назву, ніж назва за замовчуванням (*widget.view.php*), тоді її потрібно вказати у файлі *manifest.json* [*actions*](/devel/modules/file_structure /manifest#actions) параметр (*actions/widget.{id}.view/view*). **views/widget.view.php приклад** ```php <?php /** * My custom widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->additem( new CTag('h1', true, $data['name']) ) ->show(); ``` ### widget Widget configuration. Used, if *[type](#type)* is set to *widget*. *Type*: Object *Supported object keys:* - **name** (string) - used in the widget list and as default header. If empty, "name" parameter from the module will be used. - **size** (object) - default widget dimensions. Supports keys: - *width* (integer) - default widget width. - *height* (integer) - default widget height. - **form_class** (string) - class with widget fields form. Must be located in the *includes* directory. If the class is *WidgetForm.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. - **js_class** (string) - name of a JavaScript class for widget view mode to extend the default CWidget class. The class will be loaded with the dashboard. The class source file must be located in the assets/js directory. See also: [assets](#assets). - **use_time_selector** (boolean) - determines whether the widget requires dashboard time selector. Supported values: *true*, *false* (default). - **refresh_rate** (integer) - widget refresh rate in seconds (default: 60). *Example*: ```json "widget": { "name": "", "size": { "width": 12, "height": 5 }, "form_class": "WidgetForm", "js_class": "CWidget", "use_time_selector": false, "refresh_rate": 60 } ``` ### widget Конфігурація віджета. Використовується, якщо *[type](#type)* має значення *widget*. *Тип*: Object *Підтримувані ключі об’єктів:* - **name** (string) - використовується у списку віджетів і як заголовок за замовчуванням. Якщо значення пусте, буде використано параметр "name" модуля. - **size** (object) - розміри віджета за замовчуванням. Підтримує ключі: - *width* (integer) - ширина віджета за замовчуванням. - *height* (integer) - висота віджета за замовчуванням. - **form_class** (string) - клас з формою полів віджетів. Повинен знаходитися в каталозі *includes*. Якщо класом є *WidgetForm.php*, який очікується за замовчуванням, цей параметр можна опустити. Якщо ви використовуєте інше ім’я, вкажіть його тут. - **js_class** (string) - назва класу JavaScript для режиму перегляду віджетів для розширення стандартного класу CWidget. Клас буде завантажено разом із панеллю інструментів. Вихідний файл класу має бути розташований у каталозі assets/js. Дивіться також: [assets](#assets). - **use_time_selector** (boolean) - визначає, чи потрібен віджет селектор часу на інформаційній панелі. Підтримувані значення: *true*, *false* (за замовчуванням). - **refresh_rate** (integer) - частота оновлення віджета в секундах (за замовчуванням: 60). *Приклад*: ```json "widget": { "name": "", "size": { "width": 12, "height": 5 }, "form_class": "WidgetForm", "js_class": "CWidget", "use_time_selector": false, "refresh_rate": 60 } ``` ### Writing a module A sample module writing process consists of the following steps (where available, click on the file or folder name to view additional details about the step): 1. Create a new directory for the module inside **zabbix/ui/modules/**. 2. Add [manifest.json](/devel/modules/file_structure/manifest) file with module metadata. 3. Create *[views](/devel/modules/file_structure/views)* folder and define a module view(s). 4. Create *[actions](/devel/modules/file_structure/actions)* folder and define a module action(s). 5. Create Module.php (or Widget.php for dashboard widgets) file and define initialization and event handling rules. 6. Create *[assets](/devel/modules/file_structure/assets)* folder for JavaScript files (place into *assets/js*), CSS styles (place into *assets/css*), or any other additional files. 7. Make sure to specify required views, actions and asset files in the manifest.json. 8. [Register](/devel/modules/file_structure/register) the module in Zabbix frontend and start using it. :::notetip You can register and enable a module as soon as you create manifest.json file. Once the module is enabled, you can preview all changes made to module files immediately by refreshing Zabbix frontend. ::: ### Написання модуля Приклад процесу написання модуля складається з наступних кроків (там, де це можливо, клацніть на назві файлу або папки, щоб переглянути додаткову інформацію про крок): 1. Створіть новий каталог для модуля всередині **zabbix/ui/modules/**. 2. Додайте файл [manifest.json](/devel/modules/file_structure/manifest) із метаданими модуля. 3. Створіть папку *[views](/devel/modules/file_structure/views)* та визначте вид(и) модуля. 4. Створіть папку *[actions](/devel/modules/file_structure/actions)* та визначте дії модуля. 5. Створіть файл Module.php (або Widget.php для віджетів інформаційної панелі) і визначте правила ініціалізації та обробки подій. 6. Створіть папку *[assets](/devel/modules/file_structure/assets)* для файлів JavaScript (розмістіть у *assets/js*), стилів CSS (розмістіть у *assets/css*) або будь-яких інших додаткових файлів. 7. Переконайтеся, що в manifest.json вказані необхідні views, actions та assets. 8. [Зареєструйте](/devel/modules/file_structure/register) модуль у інтерфейсі Zabbix і почніть його використовувати. :::notetip Ви можете зареєструвати та ввімкнути модуль, щойно створите файл manifest.json. Після ввімкнення модуля ви можете одразу переглянути всі зміни, внесені до файлів модуля, перезавантаживши інтерфейс Zabbix. ::: # zabbix\_agent2 Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_agent2 Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_agentd Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_agentd Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} #### Zabbix agent For passive checks Zabbix agent needs to know the IP address or DNS name of Zabbix server. If you have provided correct information during the agent installation, the configuration file is already updated. Otherwise, you need to manually specify it. Go to the `C:\Program files\Zabbix Agent` folder, open the file *zabbix_agentd.conf* and add the IP/DNS of your Zabbix server to the *Server* parameter. Example: Server=192.0.2.22 #### Zabbix agent For passive checks Zabbix agent needs to know the IP address or DNS name of Zabbix server. If you have provided correct information during the agent installation, the configuration file is already updated. Otherwise, you need to manually specify it. Go to the `C:\Program files\Zabbix Agent` folder, open the file *zabbix_agentd.conf* and add the IP/DNS of your Zabbix server to the *Server* parameter. Example: Server=192.0.2.22 #### Zabbix agent In the `C:\Program files\Zabbix Agent` folder open the file *zabbix_agentd.conf* and add: - The name of the host you created in Zabbix web interface to the *Hostname* parameter. - The IP address or DNS name of your Zabbix server machine to the *ServerActive* parameter (might be prefilled if you have provided it during Zabbix agent setup). Example: ServerActive= 192.0.2.22 Hostname=Windows workstation #### Zabbix agent In the `C:\Program files\Zabbix Agent` folder open the file *zabbix_agentd.conf* and add: - The name of the host you created in Zabbix web interface to the *Hostname* parameter. - The IP address or DNS name of your Zabbix server machine to the *ServerActive* parameter (might be prefilled if you have provided it during Zabbix agent setup). Example: ServerActive= 192.0.2.22 Hostname=Windows workstation # Zabbix documentation These pages contain official Zabbix documentation. Use the sidebar navigation to browse documentation pages. To be able to watch pages, log in with your [Zabbix forums](http://www.zabbix.com/forum/) username and password. # Документація Zabbix Ці сторінки містять офіційну документацію Zabbix. Використовуйте навігацію на бічній панелі, щоб переглядати сторінки документації. Щоб мати можливість переглядати сторінки, увійдіть, використовуючи своє ім’я користувача та пароль [на форумах Zabbix](http://www.zabbix.com/forum/). #### Zabbix frontend 1\. Log into Zabbix frontend. 2\. [Create a host](/manual/config/hosts/host) in Zabbix web interface. This host will represent your Windows machine. 3\. In the *Interfaces* parameter, add *Agent* interface and specify the IP address or DNS name of the Windows machine where the agent is installed. 4\. In the *Templates* parameter, type or select *Windows by Zabbix agent*. {width="600"} #### Zabbix frontend 1\. Log into Zabbix frontend. 2\. [Create a host](/manual/config/hosts/host) in Zabbix web interface. This host will represent your Windows machine. 3\. In the *Interfaces* parameter, add *Agent* interface and specify the IP address or DNS name of the Windows machine where the agent is installed. 4\. In the *Templates* parameter, type or select *Windows by Zabbix agent*. {width="600"} # Zabbix manpages These are Zabbix manpages for Zabbix processes. # Сторінки довідки Zabbix Це сторінки довідки Zabbix для процесів Zabbix. # Zabbix Manual Welcome to the user manual for Zabbix software. These pages are created to help users successfully manage their monitoring tasks with Zabbix, from the simple to the more complex ones. # Посібник Zabbix Ласкаво просимо до посібника користувача програмного забезпечення Zabbix. Ці сторінки створені, щоб допомогти користувачам успішно керувати своїми завданнями моніторингу за допомогою Zabbix, від простих до складніших. # zabbix\_proxy Section: Maintenance Commands (8)\ Updated: 2020-09-04\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_proxy Розділ: Команди обслуговування (8)\ Оновлено: 04.09.2020\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_sender Section: User Commands (1)\ Updated: 2021-06-01\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_sender Розділ: Команди користувача (1)\ Оновлено: 01.06.2021\ [Зміст](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_server Section: Maintenance Commands (8)\ Updated: 2020-09-04\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_server Розділ: Команди обслуговування (8)\ Оновлено: 04.09.2020\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} # zabbix\_web\_service Section: Maintenance Commands (8)\ Updated: 2019-01-29\ [Index](#index) [Return to Main Contents](/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} # zabbix\_web\_service Розділ: Команди обслуговування (8)\ Оновлено: 29.01.2019\ [Покажчик](#index) [Повернутися до основного вмісту](/manpages) -------------------------------------------------- ---------------------- [ ]{#lbAB} acknowledge підтвердити acknowledged підтверджено Boolean to decimal Логічний до десяткового Change per second Зміна за секунду Check for error in JSON Перевірка на помилки в JSON Check for error in XML Перевірка на наявність помилок в XML Check for error using regular expression Перевірка на наявність помилок за допомогою регулярного виразу Check for not supported value Перевірка на непідтримуване значення Custom multiplier Індивідуальний множник dashboard dashboard Discard unchanged Відкинути без змін Discard unchanged with heartbeat Викиньте без змін з пульсом discovery виявлення Does not match regular expression Не відповідає регулярному виразу fire спрацьовує frontend frontend Hexademical to decimal Шістнадцяткове в десяткове host Вузол мережі In range В діапазоні item елемент даних Left trim Обрізати зліва LLD LLD low-level discovery Низькорівневе виявлення Matches regular expression Відповідає регулярному виразу media type Спосіб оповіщення Octal to decimal Вісімкове в десяткове OK event Подія ОК preprocessing попередня обробка preprocessing step крок попередньої обробки problem event проблемна подія Prometheus pattern Prometheus маска Regular expression Регулярний вираз Replace Замінити Right trim Обрізати справа scheduled report регулярний звіт Simple change Проста зміна tag тег tag name ім'я тегу tag value значення тегу template шаблон trigger тригер Trim Обрізати unacknowledge непідтверджено unacknowledged непідтверджений Zabbix Zabbix Congratulations, you have translated your first "string"! Вітання, ви щойно переклали перший "рядок"! Did you see the automatic translation there? If you click a translation in that tab, it gets added to the translation input. Ви бачили там автоматичний переклад? Якщо ви натиснете переклад на цій вкладці, він буде додано до введення перекладу. If a string has a lot of placeables, we have another trick for you. Якщо рядок має багато позначок, то ми маємо інший трюк для Вас. In the next string, click the Machinery tab. У наступному рядку натисніть вкладку Machinery. In this sentence, click the dot-dot-dot at the end… У цьому реченні натисніть три крапки в кінці… Keep translating, we'll show you tips and tricks about Pontoon. Продовжуйте перекладати, і ми покажемо вам поради та підказки про Pontoon. Machinery shows you suggestions from Machine Translation and Translation Memory. Machinery показує Вам пропозиції машинного перекладу та перекладацької пам'яті. Nice! The "placeable" has been automatically pasted to your translation. Чудово! Слово "позначення" було автоматично додано до Вашого перекладу. Now go on, grasshopper, and translate to your heart's content! А тепер давай, конику, перекладай досхочу! <strong><a href="%(test)s">Click the Copy button</a> just <em>below</em> the translation input.</strong> <strong><a href="%(test)s">Натисніть кнопку Скопіювати</a> трохи <em>нижче</em> поля для перекладу.</strong> That's all for now. There's a lot more to Pontoon that you'll discover as you use it. Наразі це все. У Pontoon є ще багато можливостей, які ви відкриєте для себе під час використання. The entire string is copied, and you just translate in-between placeables. Convenient, right? Копіюється ввесь рядок і Ви просто перекладаєте його між позначками. Зручно, правда? The quick brown fox jumps over the lazy dog. Швидка бура лисиця перестрибує ледачого пса. There are <b>different</b> %(types)s of placeables and you usually don't need to translate them. Існують <b>різні</b> %(типи)s позначень і зазвичай їх не потрібно перекладати. Welcome to Pontoon! Translate this sentence and press Enter. Ласкаво просимо до Pontoon! Перекладіть це речення та натисніть Enter. (0 - infinitely) (0 - нескінченно) 0 or 1 0 або 1 (0 - use action default) (0 - використовувати замовчування дії) 0 - use default port 0 - використовувати порт по замовчуванню %1$d characters exceeds maximum length of %2$d characters %1$d символів перевищують максимальну довжину в %2$d символа %1$d day %1$d дні %1$d day %1$d день %1$d day %1$d днів %1$d matches for %2$s found %1$d співпадінь для %2$s знайдено %1$d of %3$d%2$s problem is shown відображено %1$d з %3$d%2$s проблем %1$d of %3$d%2$s problem is shown відображено %1$d з %3$d%2$s проблеми %1$d of %3$d%2$s problem is shown відображено %1$d з %3$d%2$s проблем (%1$s %2$s) (%1$s %2$s) %1$s action %1$s дія %1$s action %1$s дій %1$s action %1$s дії %1$s event %1$s події %1$s event %1$s подій %1$s event %1$s подія "%1$s" is expected "%1$s" очікувалось %1$s item %1$s елементів даних %1$s item %1$s елемент даних %1$s item %1$s елементи даних %1$s Item %1$s елемента даних %1$s Item %1$s елемент даних %1$s Item %1$s елементів даних %1$s [Line: %2$s | Column: %3$s] %1$s [Рядок: %2$s | Стовпчик: %3$s] %1$s message %1$s повідомлення %1$s message %1$s повідомлення %1$s message %1$s повідомлень %1$s minute %1$s хвилин %1$s minute %1$s хвилина %1$s minute %1$s хвилини %1$s of %2$s element in problem state %1$s з %2$s елемента в стані проблеми %1$s of %2$s element in problem state %1$s з %2$s елементів в стані проблеми %1$s of %2$s element in problem state %1$s з %2$s елементів в стані проблеми %1$s preselected, use down,up arrow keys and enter to select %1$s відібрано, використовуйте клавіші вниз, вверх та ентер щоб вибрати %1$s problem %1$s проблеми %1$s problem %1$s проблема %1$s problem %1$s проблем %1$s problem in total %1$s проблем всього %1$s problem in total %1$s проблема всього %1$s problem in total %1$s проблеми всього %1$s, read only %1$s, тільки читання %1$s retry left залишилась %1$s спроба %1$s retry left залишилось %1$s спроби %1$s retry left залишилось %1$s спроб %1$s second %1$s секунд %1$s second %1$s секунди %1$s second %1$s секунда %1$s, selected %1$s, обрано %1$s, Severity, %2$s %1$s, Важливість, %2$s %1$s widget %1$s віджет %1$s (year %2$s) %1$s (рік %2$s) 100 busiest triggers 100 найбільш активних тригерів 10 seconds 10 секунд 1 minute 1 хвилина 30 seconds 30 секунд 3D view 3D вид %4$s failed login attempt logged. Last failed attempt was from %1$s on %2$s at %3$s. Зафіксовано %4$s невдалих спроби входу в систему. Остання невдала спроба була з %1$s о %2$s %3$s. %4$s failed login attempt logged. Last failed attempt was from %1$s on %2$s at %3$s. Зафіксовано %4$s невдалих спроб входу в систему. Остання невдала спроба була з %1$s о %2$s %3$s. %4$s failed login attempt logged. Last failed attempt was from %1$s on %2$s at %3$s. Зафіксовано %4$s невдалу спробу входу в систему. Остання невдала спроба була з %1$s о %2$s %3$s. 500 latest values 500 останніх значень 5 minutes 5 хвилин 5 seconds 5 секунд a boolean is expected очікується логічне значення abschange() - Absolute difference between last and previous value abschange() - Різниця по модулю між останнім і попереднім значениям Acceptable SLA Допустимий рівень SLA Access denied Доступ заборонено Access denied! Доступ заборонено! a character string is expected очікується рядок символів Ack Підтверджено Acknowledge Підтвердити Acknowledged Підтверджено Acknowledged PROBLEM events Підтверджені події ПРОБЛЕМА Acknowledged RESOLVED events Підтверджені ВИРІШЕНІ події Action Дія Action "%1$s" already exists. Дія "%1$s" вже існує. Action "%1$s" no operations defined. В дії "%1$s" не вказано операцій. Action added Дію додано Action condition value must be empty. Значення умови дії має бути пустим. Action deleted Дію видалено Action disabled Дії дезактивовано Action disabled Дії дезактивовано Action disabled Дію дезактивовано Action enabled Дії активовано Action enabled Дію активовано Action enabled Дії активовано Action log Журнал дій Actions Дії Action updated Дію оновлено Active Активний Active Активний Active since Активно із Active till Активно до Add Додати Add a new widget Додати новий віджет Add child Додати підлеглу Add child element Додати підлеглий елемент Added Додано Added, %1$s Додано, %1$s Add host Додати вузел мережі Add multiple maps Додати кілька карт Add new data set Додати новий набір даних Add new or existing applications Додати нові або існуючі групи елементів даних Add new or existing host groups Додати нові або існуючі групи вузлів мережі Add new override Додати нове заміщення ADD OVERRIDE ДОДАТИ ЗАМІЩЕННЯ Add prototype Додати прототип Add submaps Додати підкарти Add to favourites Додати до обраного Add to host group Додати до групи вузлів мережі Add to host groups Додати до груп вузлів мережі Add widget Додати віджет Adjust widget refresh interval Скоригувати інтервал оновлення віджету Admin Адміністратор Administration Адміністрування Advanced labels Розширені ярлики AES AES affects only filtered data впливає тільки на відфільтровані дані Age Вік Age less than З віком менше ніж Age less than %s З віком менше ніж %s agent агент Agent Агент Agent availability check. Returns nothing - unavailable; 1 - available Перевірка доступності агента. Нічого не повертає - не доступний; 1 - доступний Agent encryption Шифрування агента Agent host name. Returns string Ім'я агента вузла мережі. Повертає текст Agent interfaces Інтерфейси агента Agent or SNMP or JMX or IPMI interface Інтерфейс Агента або SNMP або JMX або IPMI a hexadecimal colour code (6 symbols) is expected очікувався шістнядцятковий код кольору (6 символів) Alert message Повідомлення тривоги Alias Аліас Align map elements Вирівняти елементи карти all всі All Все All dashboards Всі панелі All groups Всі групи All hosts Всі вузли мережі All links should have "Name" and "URL" specified Всі посилання повинні мати вказані "І'мя" та "URL-запит" All maps Всі карти мереж all media всі методи повідомлень Allowed hosts Дозволені вузли мережі Allow manual close Дозволити закриття вручну All problems Всі проблеми All problems if tag values match Всі проблеми якщо значення тегів співпадають All screens Всі комплексні екрани All slide shows Всі слайд-шоу All tags Всі теги All templates Всі шаблони Alternatively, you can install it manually: Альтернативно, ви можете встановити його вручну: an array is expected очікується масив an array or a character string is expected очікується масив або рядок символів And Та AND ТА And/Or Та/Або an empty string is expected очікувався пустий рядок an even number of hexadecimal characters is expected очікується парна кількість шістнадцяткових символів an explicit time is expected очікувався чіткий час a number is expected очікується число a number is too large число занадто велике a numeric value is expected очікується числове значення Any Будь-який Any character string included Містить будь-який рядок символів Application Група елементів даних Application "%1$s" already exists. Група елементів даних "%1$s" вже існує. Application added Групу елементів даних додано Application deleted Групу елементів даних видалено Application deleted Груп елементів даних видалено Application deleted Групи елементів даних видалено Application error. Помилка програми. Application prototypes Прототипи груп елементів даних Applications Групи елементів даних Application updated Групу елементів даних оновлено Application with applicationid "%1$s" does not exist. Група елементів даних з applicationid "%1$s" не існує. Application with ID "%1$s" is not available on "%2$s". Група елементів даних з ID "%1$s" недоступна для "%2$s". Apply Задіяти Apply permissions and tag filters to all subgroups Задіяти права та фільтри тегів до всіх підгруп Approaching Наближається Apr Кві April Квітень Area size Розмір області Area type Тип області Are you sure you want perform this action? Ви дійсно хочете виконати цю дію? Are you sure you want to delete Ви дійсно хочете видалити Are you sure, you want to leave this page? Ви впевнені що хочете покинути цю сторінку? Arithmetic Арифметика as Blue синім ascending за зростанням as Green зеленим As is Як є As plain text Як простий текст as Red червоним Asset tag Етикетка власника At %1$s:%2$s %3$s of every week Об %1$s:%2$s %3$s кожні %4$s тижнів At %1$s:%2$s %3$s of every week Об %1$s:%2$s %3$s кожен %4$s тиждень At %1$s:%2$s %3$s of every week Об %1$s:%2$s %3$s кожні %4$s тижні At %1$s:%2$s every day Об %1$s:%2$s кожних %3$s дні At %1$s:%2$s every day Об %1$s:%2$s кожен %3$s день At %1$s:%2$s every day Об %1$s:%2$s кожних %3$s днів At %1$s:%2$s on %3$s %4$s of every %5$s О %1$s:%2$s %3$s %4$s кожний %5$s At %1$s:%2$s on day %3$s of every %4$s О %1$s:%2$s на %3$s день кожний %4$s At (hour:minute) В (час:хвилина) a time is expected очікувався час a time period is expected очікується період часу a time range is expected очікується період часу a time unit is expected очікується одиниця часу At least one host group or host must be selected. Принаймні она група вузлів мережі або вузол мережі має бути вибрано. At least one interface must exist. Принаймні один інтерфейс має існувати. At least one maintenance period must be created. Має бути створено як мінімум один період обслуговування. At least one of MySQL, PostgreSQL, Oracle or IBM DB2 should be supported. Принаймні одна з MySQL, PostgreSQL, Oracle або IBM DB2 має підтримуватись. At least one operation must exist. Принаймні одна операція має існувати. At least one operation or recovery operation must exist. Принаймні одна операція або операція відновлення має існувати. At least one operation, recovery operation or update operation must exist. Принаймні одна операція, операція відновлення або операція оновлення має існувати. at least one override option must be specified принаймні одне заміщення має бути вказано At least one update operation is mandatory Принаймні одна операція оновлення є обов'язковою At least one update operation or message must exist. Принаймні одна операція оновлення або повідомлення мають існувати. At least one user or user group must be selected. Принаймні одного користувача чи група користувачів має бути вибрано. Attempt interval Інтервал спроб Attempts Спроби Audit Аудит Audit data storage period Період зберігання даних аудиту Audit data storage period "%1$s". Період зберігання даних аудиту "%1$s". Audit log Журнал аудиту Aug Сер August Серпень a user macro is expected очікується макрос користувача Authentication Аутентифікація Authentication algorithm Алгоритм аутентифікації Authentication failed: %1$s. Невдала аутентийікація: %1$s. Authentication method Метод аутентифікації Authentication method changed Метод аутентифікації змінено Authentication passphrase Пароль для аутентифікації Authentication protocol Протокол аутентифікації Authentication settings updated Налаштування аутентифікації оновлено Auto Авто Auto-login Авто-вхід Auto-login and auto-logout options cannot be enabled together. Опції авто-вхід та авто-вихід неможливо активувати разом. Auto-logout Авто-вихід Automatic Автоматично Automatic icon mapping Автоматичне призначення іконок Automatic icon selection Автоматичний вибір іконок auto-registered host автоматично зареєстрований вузел мережі auto registration автореєстрація Auto registration Автоматична реєстрація Auto-registration data storage period Період зберігання даних автореєстрації Auto-registration event and alert data storage period Період зберігання даних про події автореєстрації та повідомлень Auto-registration event and alert data storage period "%1$s". Період зберігання даних про події автореєстрації та повідомлень "%1$s". Availability Доступність Availability report Звіт про доступність Available Доступний Average Середня avg сер. avg() - Average value of a period T avg() - Середнє значення за період Т Axes Вісі Back Назад Background Фонове зображення Background colour Колір фону Background image Фонове зображення band() - Bitwise AND of last (most recent) T value and mask band() - Побітове ТА останнього (найбільш недавнього) значення Т та маска Base colour Базовий колір Base DN База для пошуку (BaseDN) Basic Проста Bind DN Ім'я для підключення (BindDN) Bind password Пароль підключення (Bind password) blinking мигання Blinking Мигання Blocked Заблоковано Blue Блакитна Body Тіло Body and headers Тіло та заголовки Bold line Товста лінія Boolean to decimal Логічне до десяткового Border Рамка Border colour Колір рамки Border type Тип рамки Border width Ширина рамки both username and password should be either present or empty як ім'я користувача, так і пароль мають або бути вказані або залишатись пустими Bottom По нижньому краю Bring forward Перемістити вперед Bring to front Перемістити на самий перед Bulgarian (bg_BG) Болгарська (bg_BG) By host По вузлу мережі By trigger template По шаблону тригера calculated вираховуване Calculated Вираховується автоматично Calculate SLA, acceptable SLA (in %) Вираховувати SLA, допустимий рівень SLA (у %) Calendar Календар Callback Зворотній виклик Canada (136 characters) Канада (136 символів) Cancel Скасувати та повернутись Cannot add action Не вдалося додати дію Cannot add action condition Не вдалося додати умову дії Cannot add a discovered application "%1$s" to a web scenario. Не вдалось додати виявлену групу елементів даних "%1$s" до веб сценарію. Cannot add a non-numeric item "%1$s" to graph "%2$s". Не вдалося додати не числовий елемент даних "%1$s" на графік "%2$s". Cannot add a non-numeric item "%1$s" to graph prototype "%2$s". Не вдалося додати не числовий елемент даних "%1$s" до прототипу графіка "%2$s". Cannot add application Не вдалося додати групу елементів даних Cannot add correlation Не вдалося додати кореляцію Cannot add correlation condition Не вдалося додати умову кореляції Cannot add dependency from a host to a template. Не вдалося додати залежність від вузла мережі до шаблону. Cannot add dependency from trigger "%1$s:%2$s" to non existing trigger "%3$s:%4$s". Не вдалось додати залежність від тригера "%1$s:%2$s" до неіснуючого тригера "%3$s:%4$s". Cannot add discovery rule Не вдалося додати правило виявлення Cannot add graph Не вдалося додати графік Cannot add graph prototype Не вдалось додати прототип графіку Cannot add group Не вдалося додати групу Cannot add host Не вдалося додати вузел мережі Cannot add host prototype Не вдалося додати прототип вузла мережі Cannot add image Не вдалося додати картинку Cannot add item Не вдалося додати елемент даних Cannot add item "%1$s" from "%2$s" to application "%3$s" from "%4$s". Не вдалося додати елемент даних "%1$s" з "%2$s" в групу елементів даних "%3$s" з "%4$s". Cannot add item prototype Не вдалось додати прототип елементів даних Cannot add items. Не вдалося додати прототип елемента даних. Cannot add maintenance Не вдалося додати період сервісу Cannot add map element of the map "%1$s" due to circular reference. Не вдалось додати елемент карти мережі на карту мережі "%1$s" по причині зациклювання. Cannot add media type Не вдалося додати метод повідомлень Cannot add more than one item with type "Graph sum" on graph "%1$s". Не вдалося додати більше одного елементу даних з типом "Сума графіку" до графіку "%1$s". Cannot add more than one item with type "Graph sum" on graph prototype "%1$s". Неможливо додати більше одного елемента даних з типом "Сумарний графік" до прототипу графіка "%1$s". Cannot add network map Не вдалося додати карту мережі Cannot add new application "%1$s". Не вдалося додати нову групу елементів даних "%1$s". Cannot add proxy Не вдалося додати проксі Cannot add regular expression Не вдалося додати регулярний вираз Cannot add screen Не вдалося додати комплексний екран Cannot add script Не вдалося додати скрипт Cannot add service Не вдалося додати послугу Cannot add slide show Не вдалося додати слайд-шоу Cannot add submaps. Max depth reached. Не вдалося додати під-карти. Досягнуто максимальну глибину вкладеності. Cannot add template Не вдалося додати шаблон Cannot add trigger Не вдалося додати тригер Cannot add trigger prototype Не вдалось додати прототип тригера Cannot add user Не вдалося додати користувача Cannot add user. Both passwords must be equal. Не вдалося додати користувача. Обидва паролі мають співпадати. Cannot add value map Не вдалося додати перетворення значення Cannot add web scenario Не вдалося додати веб сценарій Cannot add widgets in kiosk mode Не вдалося додати віджети в режим кіоску cannot be changed неможливо змінити cannot be empty не може бути пустим Can not be removed Неможливо видалити Cannot bind anonymously to LDAP server. Не вдалося анонімно прив'язатися до LDAP сервера. Cannot bind to LDAP server. Не вдалося прив'язатися до LDAP сервера. Cannot clear history Не вдалося очистити історію Cannot clone graph prototypes. Не вдалося клонувати прототипи графіків. Cannot clone host prototypes. Не вдалося клонувати прототипи вузлів мережі. Cannot clone item prototypes. Не вдалося клонувати прототипи елементів даних. Cannot clone trigger prototypes. Не вдалося клонувати прототипи тригерів. Cannot close problem: %1$s. Не вдалося закрити проблему: %1$s. Cannot connect to LDAP server. Не вдалося підключитись до LDAP сервера. Cannot connect to the database. Не вдалося підключитись до бази даних. cannot convert to JSON, result value too long не вдалося конвертувати в JSON, результативне значення надто довге Cannot copy graph Не вдалося скопіювати графіки Cannot copy graph Не вдалося скопіювати графіки Cannot copy graph Не вдалося скопіювати графік Cannot copy item Не вдалося скопіювати елементи даних Cannot copy item Не вдалося скопіювати елементи даних Cannot copy item Не вдалося скопіювати елемент даних Cannot copy trigger Не вдалося скопіювати тригер Cannot copy trigger Не вдалося скопіювати тригери Cannot copy trigger Не вдалося скопіювати тригери Cannot copy trigger "%1$s:%2$s", because it has multiple hosts in the expression. Не вдалося скопіювати тригер "%1$s:%2$s", тому що він містить декілька вузлів мережі у виразі. Cannot create a host prototype on a discovered host "%1$s". Не вдалося створити прототип вузла мережі у виявленого вузла мережі "%1$s". Cannot create another database connection. Не вдалося сворити інше з'єднання з базою даних. Cannot create circular dependencies. Не вдалося створити залежності утворюючі кільце. Cannot create dependency on trigger itself. Неможливо створити залежність тригера самого від себе. Cannot create dependency on trigger prototype itself. Не можливо створити залежність прототипа тригера до самого себе. Cannot create discovery rule Не вдалося створити правило виявлення Cannot create icon map Не вдалося створити призначення іконок Cannot create new application, web scenario is already assigned to application. Не вдалося створити нову групу елементів даних, веб сценарій вже приєднано до групи елементів даних. Cannot create the configuration file. Не вдалося створити конфігураційний файл. Cannot create widget: %1$s. Не вдалося створити віджет: %1$s. Cannot delete action Не вдалося видалити дію Cannot delete application Не вдалося видалити групи елементів даних Cannot delete application Не вдалося видалити групи елементів даних Cannot delete application Не вдалося видалити групу елементів даних Cannot delete correlation Не вдалося видалити кореляцію Cannot delete dashboard Не вдалося видалити панель Cannot delete dashboard Не вдалося видалити панелі Cannot delete dashboard Не вдалося видалити панелі Cannot delete dependency Не вдалося видалити залежність Cannot delete discovered application "%1$s". Не вдалося видалити виявлену групу елементів даних "%1$s". Cannot delete discovery rule Не вдалося видалити правило виявлення Cannot delete discovery rules Не вдалося видалити плавила виявлення Cannot delete graph Не вдалося видалити графік Cannot delete graph prototype Не вдалося видалити прототип графіка Cannot delete graph prototypes Не вдалося видалити прототипи графіків Cannot delete graphs Не вдалося видалити графіки Cannot delete group Не вдалося видалити групу Cannot delete group Не вдалося видалити групи Cannot delete group Не вдалося видалити групи Cannot delete host Не вдалося видалити вузел мережі Cannot delete host because maintenance "%1$s" must contain at least one host or host group. Не вдалось видалити вузли мережі тому, що обслуговування "%1$s" має містити принаймні один вузел мережі або групу вузлів мережі. Cannot delete host because maintenance "%1$s" must contain at least one host or host group. Не вдалось видалити вузли мережі тому, що обслуговування "%1$s" має містити принаймні один вузел мережі або групу вузлів мережі. Cannot delete host because maintenance "%1$s" must contain at least one host or host group. Не вдалось видалити вузел мережі тому, що обслуговування "%1$s" має містити принаймні один вузел мережі або групу вузлів мережі. Cannot delete host group because maintenance "%1$s" must contain at least one host or host group. Не вдалось видалити групу вузлів мережі тому, що обслуговування "%1$s" має містити принаймні один вузел мережі або групу вузлів мережі. Cannot delete host group because maintenance "%1$s" must contain at least one host or host group. Не вдалось видалити групи вузлів мережі тому, що обслуговування "%1$s" має містити принаймні один вузел мережі або групу вузлів мережі. Cannot delete host group because maintenance "%1$s" must contain at least one host or host group. Не вдалось видалити групи вузлів мережі тому, що обслуговування "%1$s" має містити принаймні один вузел мережі або групу вузлів мережі. Cannot delete host prototype. Не вдалося видалити прототип вузла мережі. Cannot delete host prototypes Не вдалося видалити прототипи вузлів мережі Cannot delete icon map Не вдалося видалити призначення іконок Cannot delete image Не вдалося видалити картинку Cannot delete inventory. Не вдалося видалити інвентарні дані. Cannot delete item Не вдалося видалити елемент даних Cannot delete item prototype Не вдалося видалити прототип елементів даних Cannot delete item prototypes Не вдалося видалити прототипи елементів даних Cannot delete items Не вдалося видалити елементи даних Cannot delete maintenance Не вдалося видалити період сервісу Cannot delete media type Не вдалося видалити методи повідомлень Cannot delete media type Не вдалося видалити метод повідомлень Cannot delete media type Не вдалося видалити методи повідомлень Cannot delete network map Не вдалося видалити карту мережі Cannot delete proxy Не вдалося видалити проксі Cannot delete proxy Не вдалося видалити проксі Cannot delete proxy Не вдалося видалити проксі Cannot delete regular expression Не вдалося видалити регулярний вираз Cannot delete regular expression Не вдалося видалити регулярний вираз Cannot delete regular expression Не вдалося видалити регулярний вираз Cannot delete screen Не вдалося видалити комплексний екран Cannot delete script Не вдалося видалити скрипти Cannot delete script Не вдалося видалити скрипт Cannot delete script Не вдалося видалити скрипти Cannot delete scripts. Script "%1$s" is used in action operation "%2$s". Не вдалося видалити скрипт. Скрипт "%1$s" використовується в операції дії "%2$s". Cannot delete selected actions Не вдалося видалити вибрані дії Cannot delete selected correlations Не вдалося видалити вибрані кореляції Cannot delete service Не вдалося видалити послугу Cannot delete slide show Не вдалося видалити слайд-шоу Cannot delete template Не вдалося видалити шаблон Cannot delete templated application. Не вдалося видалити шаблонну групу елементів даних. Cannot delete templated graph. Не вдалося видалити шаблонний графік. Cannot delete templated graph prototype. Не вдалося видалити шаблонний прототип графіку. Cannot delete templated host prototype. Не вдалося видалити шаблонний прототип вузла мережі. Cannot delete templated item. Не вдалося видалити шаблонний елемент даних. Cannot delete templated item prototype. Не вдалося видалити шаблонний прототип елемента даних. Cannot delete templated items. Не вдалося видалити шаблонні елементи даних. Cannot delete templated trigger "%1$s:%2$s". Не вдалося видалити шаблонний тригер "%1$s:%2$s". Cannot delete templated trigger prototype "%1$s:%2$s". Не вдалося видалити шаблонний прототип тригера "%1$s:%2$s". Cannot delete templated web scenario "%1$s". Не вдалося видалити шаблонний веб сценарій "%1$s". Cannot delete trigger Не вдалося видалити тригер Cannot delete trigger prototype Не вдалося видалити прототип тригера Cannot delete trigger prototypes Не вдалося видалити прототипи тригерів Cannot delete triggers Не вдалося видалити тригери Cannot delete user Не вдалося видалити користувача Cannot delete value map Не вдалося видалити перетворення значеннь Cannot delete value map Не вдалося видалити перетворення значення Cannot delete value map Не вдалося видалити перетворення значеннь Cannot delete web scenario Не вдалося видалити веб сценарій Cannot delete Zabbix internal user "%1$s", try disabling that user. Не вдалося видалити внутрішнього користувача Zabbix "%1$s", спробуйте відключити цього користувача. Cannot disable action Не вдалося дезактивувати дії Cannot disable action Не вдалося дезактивувати дію Cannot disable action Не вдалося дезактивувати дії Cannot disable correlation Не вдалося дезактивувати кореляцію Cannot disable correlation Не вдалося дезактивувати кореляції Cannot disable correlation Не вдалося дезактивувати кореляції Cannot disable discovery rule Не вдалося дезактивувати правила виявлення Cannot disable discovery rule Не вдалося дезактивувати правило виявлення Cannot disable discovery rule Не вдалося дезактивувати правила виявлення Cannot disable host Не вдалося дезактивувати вузли мережі Cannot disable host Не вдалося дезактивувати вузел мережі Cannot disable host Не вдалося дезактивувати вузли мережі Cannot disable item Не вдалося дезактивувати елемент даних Cannot disable item Не вдалося дезактивувати елементи даних Cannot disable item Не вдалося дезактивувати елементи даних Cannot disable media type Не вдалося дезактивувати метод повідомлень Cannot disable media type Не вдалося дезактивувати методи повідомлень Cannot disable media type Не вдалося дезактивувати методи повідомлень Cannot disable trigger Не вдалося дезактивувати тригер Cannot disable trigger Не вдалося дезактивувати тригери Cannot disable trigger Не вдалося дезактивувати тригери Cannot disable user group Не вдалося дезактивувати групи користувачів Cannot disable user group Не вдалося дезактивувати групи користувачів Cannot disable user group Не вдалося дезактивувати групу користувачів Cannot disable web scenario Не вдалося відключити веб сценарії Cannot disable web scenario Не вдалося відключити веб сценарії Cannot disable web scenario Не вдалося відключити веб сценарій Cannot display item queue. Не вдалося відобразити чергу елементів даних. Cannot display more than one item with type "Graph sum". Не вдалося відобразити більше одного елемента даних з типом "Сумарний графік". Cannot enable action Не вдалося активувати дії Cannot enable action Не вдалося активувати дії Cannot enable action Не вдалося активувати дію Cannot enable correlation Не вдалося активувати кореляції Cannot enable correlation Не вдалося активувати кореляції Cannot enable correlation Не вдалося активувати кореляцію Cannot enable discovery rule Не вдалося активувати правило виявлення Cannot enable discovery rule Не вдалося активувати правила виявлення Cannot enable discovery rule Не вдалося активувати правила виявлення Cannot enable host Не вдалося активувати вузли мережі Cannot enable host Не вдалося активувати вузли мережі Cannot enable host Не вдалося активувати вузел мережі Cannot enable item Не вдалося активувати елементи даних Cannot enable item Не вдалося активувати елемент даних Cannot enable item Не вдалося активувати елементи даних Cannot enable media type Не вдалося активувати методи повідомлень Cannot enable media type Не вдалося активувати методи повідомлень Cannot enable media type Не вдалося активувати метод повідомлень Cannot enable trigger Не вдалося активувати тригер Cannot enable trigger Не вдалося активувати тригери Cannot enable trigger Не вдалося активувати тригери Cannot enable user group Не вдалося активувати групу користувачів Cannot enable user group Не вдалося активувати групи користувачів Cannot enable user group Не вдалося активувати групи користувачів Cannot enable web scenario Не вдалося активувати веб сценарії Cannot enable web scenario Не вдалося активувати веб сценарій Cannot enable web scenario Не вдалося активувати веб сценарії Cannot execute script Не вдалося виконати скрипт Cannot expand macros. Не вдалося розкрити макроси. Cannot find background image "%1$s" used in map "%2$s". Не вдалося знайти фонове зображення "%1$s" використовуване в карті мережі "%2$s". Cannot find graph "%1$s" used in screen "%2$s". Не вдалося знайти графік "%1$s" який використовується в комплексному екрані "%2$s". Cannot find group "%1$s" used in map "%2$s". Не вдалося знайти групу "%1$s" яка використовується в карті мережі "%2$s". Cannot find group "%1$s" used in screen "%2$s". Не вдалося знайти групу "%1$s" яка використовується в комплексному екрані "%2$s". Cannot find host "%1$s" used in map "%2$s". Не вдалося знайти вузел мережі "%1$s" який використовується в карті мережі "%2$s". Cannot find host "%1$s" used in screen "%2$s". Не вдалося знайти вузел мережі "%1$s" який використовується в комплексному екрані "%2$s". Cannot find host group "%1$s" for host prototype "%2$s" of discovery rule "%3$s" on "%4$s". Не вдалося знайти групу вузлів мережі "%1$s" для прототипу вузлів мережі "%2$s" правила виявлення "%3$s" на "%4$s". Cannot find host interface on "%1$s" for item key "%2$s". Не вдалося знайти інтерфейс вузла мережі "%1$s" для ключа елемента даних "%2$s". Cannot find icon "%1$s" used in map "%2$s". Не вдалося знайти іконку "%1$s" яка використовується в карті мережі "%2$s". Cannot find icon map "%1$s" used in map "%2$s". Не вдалося знайти призначення іконок "%1$s" використовуване в карті мережі "%2$s". Cannot find item "%1$s" on "%2$s" used as the Y axis MAX value for graph "%3$s". Не вдалося знайти елемент даних "%1$s" в "%2$s", який використовується як MAX значення вісі Y в графіку "%3$s". Cannot find item "%1$s" on "%2$s" used as the Y axis MAX value for graph prototype "%3$s" of discovery rule "%4$s" on "%5$s". Не вдалося найти елемент даних "%1$s" в "%2$s", який використовується як MAX значення вісі Y в прототипі графіку "%3$s" правила виявлення "%4$s" на "%5$s". Cannot find item "%1$s" on "%2$s" used as the Y axis MIN value for graph "%3$s". Не вдалося знайти елемент даних "%1$s" в "%2$s", який використовується як MIN значення вісі Y в графіку "%3$s". Cannot find item "%1$s" on "%2$s" used as the Y axis MIN value for graph prototype "%3$s" of discovery rule "%4$s" on "%5$s". Не вдалося знайти елемент даних "%1$s" в "%2$s", який використовується як MIN значення вісі Y в прототипі графіку "%3$s" правила виявлення "%4$s" на "%5$s". Cannot find item "%1$s" on "%2$s" used in graph "%3$s". Не вдалося знайти елемент даних "%1$s" в "%2$s", який використовується в графіку "%3$s". Cannot find item "%1$s" on "%2$s" used in graph prototype "%3$s" of discovery rule "%4$s" on "%5$s". Не вдалося знайти елемент даних "%1$s" в "%2$s", який використовується в прототипі графіку "%3$s" правила виявлення "%4$s" на "%5$s". Cannot find item "%1$s" used in screen "%2$s". Не вдалося знайти елемент даних "%1$s" який використовується в комплексному екрані "%2$s". Cannot find map "%1$s" used in map "%2$s". Не вдалось знайти карту мережі "%1$s" яка використовується в карті мережі "%2$s". Cannot find map "%1$s" used in screen "%2$s". Не вдалося знайти карту мережі "%1$s" яка використовується в комплексному екрані "%2$s". Cannot find screen "%1$s" used in screen "%2$s". Не вдалося знайти комплексний екран "%1$s" який використовується в комплексному екрані "%2$s". Cannot find template "%1$s" for host prototype "%2$s" of discovery rule "%3$s" on "%4$s". Не вдалося знайти шаблон "%1$s" для прототипу вузлів мережі "%2$s" правила виявлення "%3$s" в "%4$s". Cannot find trigger "%1$s" used in map "%2$s". Не вдалось знайти тригер "%1$s" який використовується в карті мережі "%2$s". Cannot find value map "%1$s" used for item "%2$s" on "%3$s". Не вдалося знайти перетворення значень "%1$s" яке використовується в елементі даних "%2$s" на "%3$s". Cannot find value map "%1$s" used for item prototype "%2$s" of discovery rule "%3$s" on "%4$s". Не вдалося знайти перетворення значень "%1$s" яке використовується в прототипі елементів даних "%2$s" правила виявлення "%3$s" на "%4$s". Cannot format tree. Не вдалося побудувати дерево. Cannot format Tree. Check logic structure in service links. Не вдалося побудувати дерево. Перевірте логічну структуру в з'єднаннях між послугами. Cannot have empty visible template name. Видиме ім'я шаблону не може бути пустим. Cannot import screen "%1$s": subscreen "%2$s" does not exist. Не вдалося імпортувати комплексний екран "%1$s": під-екран "%2$s" не існує. Cannot import screen "%1$s": subscreen "%2$s" does not exist. Не вдалося імпортувати комплексний екран "%1$s": під-екрани "%2$s" не існують. Cannot import screen "%1$s": subscreen "%2$s" does not exist. Не вдалося імпортувати комплексний екран "%1$s": під-екрани "%2$s" не існують. Cannot import template "%1$s", linked template "%2$s" does not exist. Не вдалося імпортувати шаблон "%1$s", приєднані шаблони "%2$s" не існують. Cannot import template "%1$s", linked template "%2$s" does not exist. Не вдалося імпортувати шаблон "%1$s", приєднані шаблони "%2$s" не існують. Cannot import template "%1$s", linked template "%2$s" does not exist. Не вдалося імпортувати шаблон "%1$s", приєднаний шаблон "%2$s" не існує. Cannot include JS file "%s". Не вдалося включити JS файл "%s". Cannot include view file "%s". Не вдалося включити файлу вигляду "%s". Cannot insert trigger expression Не вдалося вставити вираз тригера Cannot link template Не вдалося приєднати шаблон Cannot link template. Не вдалося приєднати шаблон. Cannot logout. Не вдалося виконати вихід. Cannot mass update host name. Неможливо масово оновити ім'я вузла мережі. Cannot mass update template name. Неможливо масово оновити ім'я шаблону. Cannot mass update visible host name. Неможливо масово оновити видиме ім'я вузла мережі. Cannot mass update visible template name. Неможливо масово оновити видиме ім'я шаблону. Cannot pass duplicate template IDs for the linkage: %s. Неможливо передати одинакові ID шаблонів для приєднання: %s. Cannot perform delete statement on table "%1$s" without where condition. Неможливо виконати запит видалення з таблиці "%1$s" без виразу where. cannot perform Scroll API request, data could be truncated неможливо виконати запит Scroll API, дані могли бути обрізані Cannot perform update statement on table "%1$s" without values. Неможливо виконати запит оновлення таблиці "%1$s" без значень. Cannot perform update statement on table "%1$s" without where condition. Неможливо виконати запит оновлення таблиці "%1$s" без виразу where. Cannot process applications from different hosts or templates. Не вдалося обробити групи елементів даних з різних вузлів мережі або шаблонів. Cannot read JSON: %1$s. Не вдалося прочитати JSON: %1$s. Cannot read the response, check connection with the Zabbix server "%1$s". Не вдалося прочитати відповідь, перевірте з'єднання з Zabbix сервером "%1$s". Cannot read XML: %1$s. Не вдалося прочитати XML: %1$s. Cannot rename guest user. Не вдалось перейменувати гостьового користувача. Cannot save discovery rule without checks. Не вдалось зберегти правило виявлення без перевірок. Cannot save widget "%1$s". Не вдалося зберегти віджет "%1$s". Cannot send command, check connection with Zabbix server "%1$s". Не вдалося відправити команду, перевірте з'єднання з Zabbix сервером "%1$s". Cannot send request Не вдалося відправити запит Cannot send request: %1$s. Не вдалося відправити запит: %1$s. Cannot set "%1$s" for action "%2$s". Не вдалося встановити "%1$s" для дії "%2$s". Cannot set "%1$s" for graph "%2$s". Не вдалося встановити "%1$s" для графіка "%2$s". Cannot set "%1$s" for graph prototype "%2$s". Не вдалося встановити "%1$s" для прототипу графіка "%2$s". Cannot set "%1$s" for item "%2$s". Не вдалося задати "%1$s" для елемента даних "%2$s". Cannot set "%1$s" for template screen "%2$s". Не вдалося встановити "%1$s" шаблонному комплексному екрану "%2$s". Cannot set inventory fields for disabled inventory. Не вдалося задати поля інтентарних даних при відключеній інвентаризації. Cannot set resource ID for screen element. Не вдалося встановити ID ресурсу для елемента комплексного екрану. Cannot set "templateid" field for application prototype in item prototype "%1$s". Не вдалося задати поле "templateid" для прототипу групи елементів даних в прототипі елементів даних "%1$s". Cannot set "templateid" for screen "%1$s". Не вдалося встановити "templateid" для комплексного екрану "%1$s". Cannot switch host for interface. Не вдалося переключити вузел мережі на інтерфейс. Cannot unblock users Не вдалося розблокувати користувачів Cannot unlink and clear applications. Не вдалося від'єднати і очистити групи елементів даних. Cannot unlink and clear discovery rules Не вдалося від'єднати та очистити правила виявлення Cannot unlink and clear Web scenarios. Не вдалося від'єднати і очистити веб сценарії. Cannot unlink template Не вдалося від'єднати шаблон Cannot unlink template. Не вдалося від'єднати шаблон. Cannot unlink trigger "%s", it has items from template that is left linked to host. Не вдалося від'єднати тригер "%s", він містить елементи даних із шаблону, який залишається приєднаним до вузла мережі. Cannot update "%1$s" for action "%2$s". Не вдалося оновити "%1$s" для дії "%2$s". Cannot update "%1$s" for graph "%2$s". Не вдалося оновити "%1$s" для графіка "%2$s". Cannot update "%1$s" for graph prototype "%2$s". Не вдалося оновити "%1$s" для прототипу графіка "%2$s". Cannot update "%1$s" for item "%2$s". Не вдалося оновити "%1$s" для елемента даних "%2$s". Cannot update "%1$s" for templated trigger "%2$s". Не вдалося оновити "%1$s" для шаблонного графіка "%2$s". Cannot update "%1$s" for templated trigger prototype "%2$s". Не вдалося оновити "%1$s" для шаблонного прототипу графіка "%2$s". Cannot update "%2$s" for a discovered host "%1$s". Не вдалося оновити "%1$s" для виявленого вузла мережі "%2$s". Cannot update "%2$s" for a discovered item "%1$s". Не вдалося оновити "%1$s" для виявленого елемента даних "%2$s". Cannot update "%2$s" for a discovered trigger "%1$s". Не вдалося оновити "%2$s" у виявленого тригера "%1$s". Cannot update action Не вдалося оновити дію Cannot update a discovered graph. Не вдалося оновити виявлений графік. Cannot update a discovered host group. Не вдалося оновити виявлену групу вузлів мережі. Cannot update application Не вдалося оновити групу елементів даних Cannot update a templated web scenario "%1$s": %2$s. Не вдалося оновити успадкований із шаблону веб-сценарій "%1$s": %2$s. Cannot update authentication Не вдалося оновити аутентифікацію Cannot update configuration Не вдалося оновити налаштування Cannot update correlation Не вдалося оновити кореляцію Cannot update debug mode Не вдалося оновити режим дебаг Cannot update description Не вдалося оновити опис Cannot update discovered application "%1$s". Не вдалося оновити виявлену групу елементів даних "%1$s". Cannot update discovery rule Не вдалося оновити правило виявлення Cannot update event Не вдалося оновити подію Cannot update event Не вдалося оновити події Cannot update event Не вдалося оновити події Cannot update frontend access Не вдалося оновити доступ до веб-інтерфейсу Cannot update graph Не вдалося оновити графік Cannot update graph prototype Не вдалося оновити прототип графіку Cannot update group Не вдалося оновити групу Cannot update groups for discovered host "%1$s". Не вдалося оновити групи для виявленого вузла мережі "%1$s". Cannot update host Не вдалося оновити вузел мережі Cannot update host encryption settings. Connection settings for both directions should be specified. Не вдалося оновити налаштування шифрування вузла мережі. Потрібно вказати налаштування з'єднання для обох сторін. Cannot update host prototype Не вдалося оновити прототип вузла мережі Cannot update host prototype Не вдалося оновити прототипи вузлів мережі Cannot update host prototype Не вдалося оновити прототипи вузлів мережі Cannot update hosts Не вдалося оновити вузли мережі Cannot update icon map Не вдалося оновити призначення іконок Cannot update image Не вдалося оновити картинку Cannot update "imagetype" for image "%1$s". Не вдалося оновити "imagetype" для картинки "%1$s". Cannot update interface for discovered host "%1$s". Не вдалося оновити інтерфейс для виявленого вузла мережі "%1$s". Cannot update item Не вдалося оновити елемент даних Cannot update item prototype Не вдалося оновити прототипи елементів даних Cannot update item prototype Не вдалося оновити прототип елемента даних Cannot update item prototype Не вдалося оновити прототипи елементів даних Cannot update items Не вдалося оновити елементи даних Cannot update macros Не вдалося оновити макроси Cannot update maintenance Не вдалося оновити період сервісу Cannot update media type Не вдалося оновити метод повідомлень Cannot update network map Не вдалося оновити карту мережі Cannot update proxy Не вдалося оновити проксі Cannot update proxy for discovered host "%1$s". Не вдалося оновити проксі для виявленого вузла мережі "%1$s". Cannot update regular expression Не вдалося оновити регулярний вираз Cannot update screen Не вдалося оновити комплексний екран Cannot update script Не вдалося оновити скрипт Cannot update service Не вдалося оновити послугу Cannot update slide show Не вдалося оновити слайд-шоу Cannot update step for a templated web scenario "%1$s": %2$s. Не вдалося оновити успадкований із шаблону крок веб-сценарію "%1$s": %2$s. Cannot update template Не вдалося оновити шаблон Cannot update templated applications. Не вдалося оновити шаблоні групи елементів даних. Cannot update "templateid" for screen "%1$s". Не вдалося оновити "templateid" для шаблонного комплексного екрану "%1$s". Cannot update "templateid" for template screen "%1$s". Не вдалося оновити "templateid" для шаблонного комплексного екрану "%1$s". Cannot update templates on discovered host "%1$s". Не вдалося оновити шаблони для виявленого вузла мережі "%1$s". Cannot update trigger Не вдалося оновити тригер Cannot update trigger "%1$s": %2$s. Не вдалося оновити тригер "%1$s": %2$s. Cannot update trigger prototype Не вдалося оновити прототип тригера Cannot update trigger prototype Не вдалося оновити прототипи тригерів Cannot update trigger prototype Не вдалося оновити прототипи тригерів Cannot update trigger prototype "%1$s": %2$s. Не вдалося оновити прототип тригера "%1$s": %2$s. Cannot update trigger prototypes Не вдалося оновити прототипи тригерів Cannot update user Не вдалося оновити дані користувача Cannot update user. Both passwords must be equal. Не вдалося оновити дані користувача. Обидва паролі мають співпадати. Cannot update value map Не вдалося оновити перетворення значення Cannot update web scenario Не вдалося оновити веб сценарій Cannot validate discovery check: invalid request or connection to Zabbix server failed. Не вдалося валідувати перевірку виявлення: помилковий запит або невдале з'єднання з Zabbix сервером. Case sensitive Чутливий до регістру Case sensitive login Логін чутливий до регістру Catalan (ca_ES) Каталонська (ca_ES) Catches all SNMP traps that match regex. If regexp is unspecified, catches any trap. Ловить SNMP трапи, які співпадають з регулярним виразом. Якщо регулярний вираз не задано, ловить всі трапи. Catches all SNMP traps that were not caught by any of snmptrap[] items. Ловить всі SNMP трапи, які не були піймані жодним елементом даних snmptrap[]. Centre По центру CERT CERT Certificate Сертіфикат Change Змінити Change Зміна change() - Difference between last and previous value change() - Різниця між останнім та попереднім значенням Change password Змінити пароль Change per second Зміна в секунду Change severity Змінити важливість Character Символ Character string included Містить рядок символів Character string not included Не містить рядок символів Chassis Шассі Chassis information. Returns string Інформація про шасі. Повертає текст Check already exists. Перевірка вже існує. Check expression part starting from "%1$s". Перевірте частину виразу починаючи з "%1$s". check expression starting from "%1$s" перевірте вираз починаючи з "%1$s" Check now Перевірити зараз Check of pre-requisites Перевірка попередніх умов Checks Перевірки Checks if DNS service is up. Returns 0 - DNS is down (server did not respond or DNS resolution failed); 1 - DNS is up Перевіряє доступність DNS сервісу. Повертає 0 - DNS не доступний (сервер не відповів або DNS запит не виконано); 1 - DNS доступний Checks if file exists. Returns 0 - not found; 1 - regular file or a link (symbolic or hard) to regular file exists Перевіряє існування файлу. Повертає 0 - файл не знайдено; 1 - звичайний файл або посилання (жорстке або символічне) на існуючий звичайний файл Checks if it is possible to make TCP connection to specified port. Returns 0 - cannot connect; 1 - can connect Перевіряє чи можливо створити TCP з'єднання до певного порту. Повертає 0 - не вдалося під'єднатись; 1 - вдалося під'єднатись Checks if service is running and accepting TCP connections. Returns 0 - service is down; 1 - service is running Перевіряє чи запущений сервіс і чи приймає TCP з'єднання. Повертає 0 - якщо сервіс недоступний; 1 - сервіс запущено Checks if service is running and responding to UDP requests. Returns 0 - service is down; 1 - service is running Перевіряє чи запущений сервіс і чи приймає UDP запити. Повертає 0 - якщо сервіс недоступний; 1 - сервіс запущено Checks if this TCP port is in LISTEN state. Returns 0 - it is not in LISTEN state; 1 - it is in LISTEN state Перевіряє чи знаходиться цей TCP порт в стані LISTEN. Повертає 0 - якщо він не в стані LISTEN; 1 - він в стані LISTEN Checks if this UDP port is in LISTEN state. Returns 0 - it is not in LISTEN state; 1 - it is in LISTEN state Перевіряє чи знаходиться цей UDP порт в стані LISTEN. Повертає 0 - якщо він не в стані LISTEN; 1 - він в стані LISTEN Checks performance of TCP service. Returns 0 - service is down; seconds - the number of seconds spent while connecting to the service Перевіряє швидкодію TCP сервісу. Повертає 0 - сервіс недоступний; секунди - тривалість секунд, затрачених в процесі під'єднання до сервісу Checks performance of UDP service. Returns 0 - service is down; seconds - the number of seconds spent waiting for response from the service Перевіряє швидкодію UDP сервісу. Повертає 0 - сервіс недоступний; секунди - тривалість секунд, затрачених в процесі під'єднання до сервісу Checks should be unique. Перевірки повинні бути унікальними. Check the key, please. Default example was passed. Будь ласка, перевірте ключ. Приклад по замовчуванню показано. Check type Тип перевірки Chinese (zh_CN) Китайська (zh_CN) Chinese (zh_TW) Китайська (zh_TW) circular item dependency is not allowed кільцева залежність елементів даних не дозволена Circular reference in screens: %1$s. Посилання, утворююче кільце, в комплексних екранах: %1$s. Circular reference in templates: %1$s. Посилання, утворююче кільце, в шаблонах: %1$s. Circular template linkage is not allowed. Приєднання шаблону, утворююче кільце, не дозволено. Clear Очистити Clear history Очистити історію Clear history and trends Очистити історію та динаміку змін Clear when unlinking Очистити при від'єднанні Click and drag to desired size. Натисніть та тягніть до бажаного розміру. Clock Годинник Clone Клонувати Close Закрити Close expression constructor Закрити конструктор виразу Close new event Закрити нову подію Close old events Закрити старі події Close problem Закрити проблему CLOSING ЗАКРИТТЯ Collapse Згорнути colour колір Colour Колір Colour "%1$s" is not correct: expecting hexadecimal colour code (6 symbols). Колір "%1$s" не коректний: очікується шістнадцятковий код кольору (6 символів). Colour (OK) Колір (ОК) Column added Стовпчик додано Column deleted Стовпчик видалено Columns Стовпчиків Column span Об'єднати стовпчики Combined result Комбінований результат Command Команда Commands Команди comma-separated list список, розділений комами Commercial Комерційні Compact view Компактний вигляд Comparing several triggers with "and" is not allowed. Порівняння декількох тригерів з "and" заборонено. Compression Стиснення Concurrent sessions Одночасні сесії Condition Умова Condition "%2$s" is not used in formula "%3$s" for action "%1$s". Умова "%2$s" не використовується в формулі "%3$s" для дії "%1$s". Condition "%2$s" is not used in formula "%3$s" for correlation "%1$s". Умова "%2$s" не використовується в формулі "%3$s" для кореляції "%1$s". Condition "%2$s" is not used in formula "%3$s" for discovery rule "%1$s". Умова "%2$s" не використовується в формулі "%3$s" для правила виявлення "%1$s". Condition "%2$s" used in formula "%3$s" for action "%1$s" is not defined. Умову "%2$s" яка використовується в формулі "%3$s" для дії "%1$s" не задано. Condition "%2$s" used in formula "%3$s" for correlation "%1$s" is not defined. Умову "%2$s", використовувану в формулі "%3$s" для кореляції "%1$s", не визначено. Condition "%2$s" used in formula "%3$s" for discovery rule "%1$s" is not defined. Умову "%2$s" яка використовується в формулі "%3$s" для правила виявлення "%1$s" не задано. Conditions Умови Conditions duplicates for correlation "%1$s". Дублікати умов для кореляції "%1$s". Configuration Налаштування Configuration cache statistics. Cache - buffer (modes: pfree, total, used, free). Статистика конфігураційного кешу. Кеш - буфер (режими: pfree, total, used, free). Configuration file "%1$s" created. Файл конфігурації "%1$s" створено. Configuration import Імпорт конфігурації Configuration of actions Налаштування дій Configuration of applications Налаштування груп елементів даних Configuration of authentication Налаштування аутентифікації Configuration of discovery rules Налаштування правил виявлення Configuration of graph prototypes Налаштування прототипу графіків Configuration of graphs Налаштування графіків Configuration of GUI Налаштування веб-інтерфейсу Configuration of host groups Налаштування груп вузлів мережі Configuration of host prototypes Налаштування прототипів вузлів мережі Configuration of hosts Налаштування вузлів мережі Configuration of housekeeping Налаштування очистки Configuration of icon mapping Налаштування призначення іконок Configuration of images Налаштування картинок Configuration of item prototypes Налаштування прототипів елементів даних Configuration of items Налаштування елементів даних Configuration of macros Налаштування макросів Configuration of maintenance periods Налаштування періодів обслуговування Configuration of media types Налаштування методів повідомлень Configuration of network maps Налаштування карт мереж Configuration of proxies Налаштування проксі Configuration of regular expressions Налаштування регулярних виразів Configuration of screens Налаштування комплексних екранів Configuration of scripts Налаштування скриптів Configuration of services Налаштування сервісів Configuration of slide shows Налаштування слайд-шоу Configuration of templates Налаштування шаблонів Configuration of trigger displaying options Налаштування опцій відображення тригерів Configuration of trigger prototypes Налаштування протитипів тригерів Configuration of triggers Налаштування тригерів Configuration of trigger severities Налаштування важливостей тригерів Configuration of user groups Налаштування груп користувачів Configuration of users Налаштування користувачів Configuration of value mapping Налаштування перетворення значень Configuration of web monitoring Налаштування веб-моніторингу Configuration of working time Налаштування робочого часу Configuration of Zabbix Налаштування Zabbix Configuration updated Налаштування оновлено configure налаштувати Configure DB connection Налаштування з'єднання з БД Confirmation text Текст підтвердження Congratulations! You have successfully installed Zabbix frontend. Вітаємо! Ви успішно встановили веб-інтерфейс Zabbix. Connected З'єднано Connections З'єднання Connection security Безпека з'єднання Connections from host З'єднання від вузла мережі Connections from proxy З'єднання з проксі Connections to host З'єднання до вузла мережі Connections to proxy З'єднання до проксі Connection timeout of %1$s seconds exceeded when connecting to Zabbix server "%2$s". Перевищено час очікування %1$s секунд при під'єднанні до Zabbix сервера "%2$s". Connection to Zabbix server "%s" failed. Possible reasons: 1. Incorrect server IP/DNS in the "zabbix.conf.php"; 2. Incorrect DNS server configuration. Не вдалося під'єднатись до Zabbix сервера "%s". Можливі причини: 1. Некоректні IP/DNS сервера в "zabbix.conf.php"; 2. Некоректне налаштування DNS сервера. Connection to Zabbix server "%s" refused. Possible reasons: 1. Incorrect server IP/DNS in the "zabbix.conf.php"; 2. Security environment (for example, SELinux) is blocking the connection; 3. Zabbix server daemon not running; 4. Firewall is blocking TCP connection. Підключення до Zabbix сервера "%s" відхилено. Можливі причини: 1. Некоректні IP/DNS сервера в "zabbix.conf.php"; 2. Середовище безпеки (наприклад, SELinux) блокує підключення; 3. Демон Zabbix сервера не запущено; 4. Фаєрвол блокує TCP з'єднання. Connection to Zabbix server "%s" timed out. Possible reasons: 1. Incorrect server IP/DNS in the "zabbix.conf.php"; 2. Firewall is blocking TCP connection. Перевищено час очікування при підключенні до Zabbix сервера "%s". Можливі причини: 1. Некоректні IP/DNS сервера в "zabbix.conf.php"; 2. Фаєрвол блокує TCP з'єднання. Connect to Підключатись використовуючи Constructor Конструктор Contact Контактна інформація contains містить Contains Містить Content controls Керування вмістом Content menu Меню вмісту Context name Ім'я контексту Contract number Номер контракту Convert to JSON Конвертувати в JSON Coordinates Координати Copy Копіювати Correlation Кореляція Correlation "%1$s" already exists. Кореляція "%1$s" вже існує. Correlation added Кореляцію додано Correlation deleted Кореляцію видалено Correlation disabled Кореляції дезактивовано Correlation disabled Кореляції дезактивовано Correlation disabled Кореляцію дезактивовано Correlation enabled Кореляції активовано Correlation enabled Кореляцію активовано Correlation enabled Кореляції активовано Correlation is missing parameters: %1$s У кореляції відсутні параметри: %1$s Correlation name cannot be empty. Ім'я кореляції не може бути пустим. Correlation rule Правило кореляції Correlation updated Кореляцію оновлено Could not save image! Не вдалося зберегти картинку! Count Кількість count() - Number of successfully retrieved values V (which fulfill operator O) for period T count() - Кількість успішно отриманих значень V (які задовільняють оператор О) за період Т Count of context switches. Returns integer Кількість перемикань контексту. Повертає ціле число Count of directory entries, recursively. Returns integer Кількість записів в директорії, рекурсивно. Повертає ціле число Count of matched lines in log file monitoring. Returns integer Кількість співпавших рядків в лог файлі. Повертає ціле число Count of matched lines in log file monitoring with log rotation support. Returns integer Кількість співпавших рядків в лог файлі з підтримкою ротації. Повертає ціле число CPU information. Returns string or integer Інформація о CPU. Повертає текст або число CPU load. Returns float Завантаження CPU. Повертає дробове значення CPU utilisation percentage. Returns float Утилізація CPU у відсотках. Повертає дробове число Create action Створити дію Create application Створити групу елементів даних Create application (select host first) Створити групу елементів даних (спочатку виберіть вузел мережі) Create background Створити фонове зображення Create correlation Створити кореляцію Create dashboard Створити панель Create dependent item Створити залежний елемент даних Create disabled Створювати дезактивованим Create discovery rule Створити правило виявлення Create enabled Створювати активованим Create graph Створити графік Create graph prototype Створити прототип графіка Create graph (select host first) Створити графік (спочатку оберіть вузел мережі) Create host Створити вузел мережі Create host group Створити групу вузлів мережі Create host prototype Створити прототип вузла мережі Create hosts from selected prototypes as disabled? Створювати вузли мережі з вибраних прототипів як дезактивовані? Create hosts from selected prototypes as enabled? Створити вузли мережі з вибраних прототипів як активовані? Create icon Створити іконку Create icon map Створити призначення іконок Create item Створити елемент даних Create item prototype Створити прототип елемента даних Create item (select host first) Створити елемент даних (оберіть спочатку вузел мережі) Create items from selected prototypes as disabled? Створити елементи даних з вибраних прототипів як дезактивовані? Create items from selected prototypes as enabled? Створити елементи даних з вибраних прототипів як активовані? Create maintenance period Створити період сервісу Create map Створити карту мережі Create media type Створити метод повідомлень Create new Створити нові Create proxy Створити проксі Create screen Створити комплексний екран Create script Створити скрипт Create slide show Створити слайд-шоу Create template Створити шаблон Create trigger Створити тригер Create trigger prototype Створити прототип тригера Create trigger (select host first) Створити тригер (оберіть спочатку вузел мережі) Create triggers from selected prototypes as disabled? Створити тригери з вибраних прототипів як дезактивовані? Create triggers from selected prototypes as enabled? Створити тригера з вибраних прототипів як активовані? Create user Створити користувача Create user group Створити групу користувачів Create value map Створити перетворення значення Create web scenario Створити веб сценарій Create web scenario (select host first) Створити веб сценарій (спочатку виберіть вузел мережі) Critical Критична Current host Поточний вузел мережі Current value Поточне значення Custom Користувацьке Custom expression Довільний вираз Custom graphs Графіки користувача Custom intervals Довільні інтервали Custom label Ярлик користувача Custom label for map "%2$s" elements of type "%1$s" may not be empty. Ярлик користувача для елементів карти мережі "%2$s" типу "%1$s" не може бути пустим. Custom multiplier Користувацький множник Custom screens Комплексні екрани користувачів Custom script Користувацький скрипт Custom severity names affect all locales and require manual translation! Імена користувацьких важливостей впливають на всі мови і потребують ручного перекладу! Custom size Користувацький розмір Custom slides Слайдшоу користувачів Czech (cs_CZ) Чеська (cs_CZ) d д Daily Щодня Dark Темна Dashboard ПАНЕЛЬ Dashboard "%1$s" already exists. Панель "%1$s" вже існує. Dashboard "%1$s" cell X - %2$s Y - %3$s is already taken. Панель "%1$s" комірку X - %2$s Y - %3$s вже зайнято. Dashboard "%1$s" widget in cell X - %2$s Y - %3$s is out of bounds. Віджет панелі "%1$s" в комірці X - %2$s Y - %3$s виходить за межі. Dashboard created Панель створено Dashboard deleted Панель видалено Dashboard deleted Панелі видалено Dashboard deleted Панелі видалено Dashboard properties Властивості панелі Dashboards Панелі Dashboard sharing Спільний доступ до панелі Dashboard updated Панель обновлено Dashed line Пунктирна лінія Data Дані Database host Хост бази даних Database monitor Монітор бази даних Database name Ім'я бази даних Database password Пароль до бази даних Database port Порт бази даних Database schema Схема бази даних Database server Сервер бази даних Database type Тип бази даних Database user Користувач бази даних Data from %1$s. Generated in %2$s sec. Дані із %1$s. Згенеровано за %2$s сек. Data is not properly encoded. Дані закодовано неправильно. Data overview Огляд даних Data set Набір даних Data storage period Період зберігання даних Date Дата date() - Current date date() - Поточна дата Date HW decommissioned Дата списання HW Date HW installed Дата встановлення HW Date HW maintenance expires Дата закінчення гарантії HW Date HW purchased Дата придбання HW Day День Day before yesterday Позавчора Day of month День в місяць dayofmonth() - Day of month dayofmonth() - День місяця Day of week День в тиждень dayofweek() - Day of week dayofweek() - День тижня days днів Days Днів %d device %d пристрої %d device %d пристрій %d device %d пристроїв DD.MM.YY DD.MM.YY Debug Дебаг Debug mode Режим діагност. Debug mode updated Режим діагностики оновлено Dec Гру December Грудень default по замовчуванню Default По замовчуванню Default authentication Аутентифікація по замовчуванню Default delay Затримка по замовчуванню Default host inventory mode Режим інвентаризації вузлів мережі по замовчуванню Default login form Форма логіну по замовчуванню Default media type Метод повідомлень по замовчуванню Default message Повідомлення по замовчуванню Default operation step duration Тривалість кроку операції по замовчуванню Default subject Тема по замовчуванню Default theme Тема по замовчуванню Default theme "%1$s". Тема по замовчуванню "%1$s". Delay Затримка Delayed by Затримується на Delete Видалити Delete all elements that are not present in the XML file? Видалити всі елементи, яких немає в XML файлі? Delete and clear Видалити та очистити Delete and clear selected templates? (Warning: all linked hosts will be cleared!) Видалити та очистити вибрані шаблони? (УВАГА: всі приєднані вузли мережі буде очищено!) Delete and clear template? (Warning: all linked hosts will be cleared!) Видалити та очистити шаблон? (УВАГА: всі приєднані вузли мережі буде очищено!) Delete application? Видалити групу елементів даних? Delete current action? Видалити поточну дію? Delete current correlation? Видалити потчну кореляцію? Deleted Видалено Delete dashboard? Видалити панель? Deleted: Host "%1$s". Видалено: Вузел мережі "%1$s". Deleted: Host prototype "%1$s" on "%2$s". Видалено: Прототип вузлів мережі "%1$s" з "%2$s". Delete discovery rule? Видалити правило виявлення? Deleted: Template "%1$s". Видалено: Шаблон "%1$s". Delete expression? Видалити вираз? Delete graph? Видалити графік? Delete graph prototype? Видалити прототип графиків? Delete history of selected items? Видалити історію вибраних елементів даних? Delete history of selected web scenarios? Видалити історію вибраних веб сценаріїв? Delete icon map? Видалити призначення іконок? Delete item? Видалити елемент даних? Delete item prototype? Видалити прототип елементів даних? Delete links between selected elements? Видалити лінки між обраними елементами? Delete maintenance period? Видалити період сервісу? Delete media type? Видалити метод повідомлень? Delete missing Видалити відсутні Delete proxy? Видалити проксі? Delete regular expression? Видалити регулярний вираз? Delete screen? Видалити комплексний екран? Delete script? Видалити скрипт? Delete selected actions? Видалити вибрані дії? Delete selected applications? Видалити вибрані групи елементів даних? Delete selected correlations? Видалити вибрані кореляції? Delete selected dashboards? Видалити обрані панелі? Delete selected discovery rules? Видалити вибрані правила виявлення? Delete selected elements? Видалити вибрані елементи? Delete selected graph prototypes? Видалити вибрані прототипи графіків? Delete selected graphs? Видалити вибрані графіки? Delete selected group? Видалити вибрану групу? Delete selected groups? Видалити вибрані групи? Delete selected host? Видалити вибраний вузел мережі? Delete selected host groups? Видалити вибрані групи вузлів мережі? Delete selected host prototype? Видалити вибраний прототип вузлів мережі? Delete selected host prototypes? Видалити вибрані прототипи вузлів мережі? Delete selected hosts? Видалити вибрані вузли мережі? Delete selected image? Видалити вибрані картинки? Delete selected item prototypes? Видалити вибрані прототипи елементів даних? Delete selected items? Видалити вибрані елементи даних? Delete selected maintenance periods? Видалити вибрані періоди сервісу? Delete selected map? Видалити вибрану карту мережі? Delete selected maps? Видалити вибрані карти? Delete selected media types? Видалити вибрані методи повідомлень? Delete selected proxies? Видалити вибрані проксі? Delete selected regular expressions? Видалити вибрані регулярні вирази? Delete selected screens? Видалити вибрані комплексні екрани? Delete selected scripts? Видалити вибрані скрипти? Delete selected shapes? Видалити обрані фігури? Delete selected slide shows? Видалити вибрані слайд-шоу? Delete selected templates? Видалити вибрані шаблони? Delete selected trigger prototypes? Видалити вибрані прототипи тригерів? Delete selected triggers? Видалити вибрані тригери? Delete selected user? Видалити обраного користувача? Delete selected users? Видалити вибраних користувачів? Delete selected value mapping? Видалити вибрані перетворення значень? Delete selected value mapping? It is used for %d item! Видалити вибране перетворення значення? Воно використовується в %d елементах даних! Delete selected value mapping? It is used for %d item! Видалити вибране перетворення значення? Воно використовується в %d елементі даних! Delete selected value mapping? It is used for %d item! Видалити вибране перетворення значення? Воно використовується в %d елементах даних! Delete selected value maps? Видалити вибрані перетворення значень? Delete selected web scenarios? Видалити вибрані веб сценарії? Delete service "%1$s"? Видалити послугу "%1$s"? Delete slide show? Видалити слайд-шоу? Delete template? Видалити шаблон? Delete trigger? Видалити тригер? Delete trigger prototype? Видалити прототип тригерів? Delete web scenario? Видалити веб сценарій? Delimiter Розділювач delta() - Difference between MAX and MIN value of a period T delta() - Різниця між МАКС та МІН значенням за період Т Deny Заборонено Dependencies Залежності Dependent Залежність Dependent item Залежний елемент даних Depends on Залежить від Deployment status Статус розгортання DES DES descending за спаданням Description Опис Description updated Опис оновлено Details Деталі Details of web scenario Деталі про веб сценарій Device Пристрій Device interrupts. Returns integer Перериви пристрою. Повертає ціле число Device uniqueness criteria Критерій унікальності пристрою diff() - Difference between last and preceding values (1 - true, 0 - false) diff() - Відмінність останнього та попереднього значень (1 - істина, 0 - фальш) Dimension (cols x rows) Розмір (стовпчиків Х рядків) directory or script name cannot be empty тека або ім'я скрипта не можуть бути пустими Directory size (in bytes). Returns integer Розмір папки (в байтах). Повертає ціле Disable Дезактивувати Disabled Дезактивовано DISABLED ДЕЗАКТИВОВАНО Disable debug mode Дезактивувати діагностичний режим Disable debug mode in selected groups? Дезактивувати діагностичний режим для вибраних груп? Disable host Дезактивувати вузел мережі Disable host? Дезактивувати вузел мережі? Disable hosts Дезактивувати вузли мережі Disable hosts in the selected host groups? Дезактивувати вузли мережі у вибраних групах вузлів мережі? Disable hosts monitored by selected proxies? Дезактивувати вузли мережі, які моніторяться обраними проксі? Disable selected actions? Дезактивувати вузли мережі? Disable selected applications? Дезактивувати вибрані групи елементів даних? Disable selected correlations? Дезактивувати вибрані кореляції? Disable selected discovery rules? Дезактивувати вибрані правила виявлення? Disable selected groups? Дезактивувати вибрані групи? Disable selected hosts? Дезактивувати вибрані вузли мережі? Disable selected items? Дезактивувати вибрані елементи даних? Disable selected media types? Дезактивувати вибрані методи повідомлень? Disable selected triggers? Дезактивувати вибрані тригери? Disable selected web scenarios? Дезактивувати вибрані веб сценарії? Disaster Критична Discovered Виявлено Discovered by Виявлено Discovered device Виявлений пристрій discovered host виявлений вузел мережі Discovered items Оновленні елементи даних discovered service виявлений сервіс discovery виявлення Discovery Виявлення Discovery by proxy Виявлення через проксі Discovery check Перевірка виявлення Discovery check error Помилка перевірки виявлення Discovery checks Перевірки виявлення Discovery list Список виявлення Discovery object Об'єкт виявлення Discovery rule Правило виявлення Discovery rule "%1$s" already exists. Правило виявлення "%1$s" вже існує. Discovery rule "%1$s" already exists on "%2$s". Правило виявлення "%1$s" вже існує у "%2$s". Discovery rule "%1$s" already exists on "%2$s", inherited from another template. Правило виявлення "%1$s" вже існує у "%2$s", успадковано з іншого шаблону. Discovery rule "%1$s" is used in "%2$s" action. Правило виявлення "%1$s" використовується в "%2$s" дії. Discovery rule created Правило виявлення створено Discovery rule deleted Правило виявлення видалено Discovery rule disabled Правило виявлення дезактивовано Discovery rule disabled Правила виявлення дезактивовано Discovery rule disabled Правила виявлення дезактивовано Discovery rule enabled Правила виявлення активовано Discovery rule enabled Правило виявлення активовано Discovery rule enabled Правила виявлення активовано discovery rule is disabled правило виявлення дезактивировано Discovery rules Правила виявлення Discovery rules deleted Правила виявлення видалено Discovery rule updated Правило виявлення оновлено Discovery status Стан виявлення Disk read statistics. Returns integer with type in sectors, operations, bytes; float with type in sps, ops, bps Статистика читання диска. Повертає ціле число для типів sectors, operations, bytes; дробове число для типів sps, ops, bps Disk space in bytes or in percentage from total. Returns integer for bytes; float for percentage Розмір дискового простору в байтах або відсотках від загального. Повертає ціле число для байт; дробове для відсотків Disk write statistics. Returns integer with type in sectors, operations, bytes; float with type in sps, ops, bps Статистика запису на диск. Повертає ціле число для типів sectors, operations, bytes; дробове число для типів sps, ops, bps Display graph Показати графік Displaying %1$s of %2$s found Відображено %1$s із %2$s знайдених Displaying %1$s to %2$s of %3$s found Відображено від %1$s до %2$s з %3$s знайдених Displaying options Опції відображення Display OK triggers for Відображати тригери ОК протягом Display problems Відображення проблем Display stacked graph Показати стекований графік d.M d M DNS DNS DNS name DNS ім'я does not contain не містить does not equal не дорівнює does not match не співпадає Do not calculate Не підраховувати Dot Лінія з крапок Down Недоступно Down Недоступний Download the configuration file Завантажити конфігураційний файл Downtime Недоступний Do you wish to replace the conditional expression? Ви дійсно хочете замінити умовний вираз? Draw Креслити Draw style Стиль креслення Dropdown first entry Перший запис у випадаючому списку Dropdown first entry "%1$s". Перший запис у випадаючому списку "%1$s". Dropdown remember selected "%1$s". Запам'ятовувати вибране у випадаючому списку "%1$s". Duplicate "%1$s" value "%2$s" for correlation. Дублікат "%1$s" значення "%2$s" в кореляції. Duplicate "%1$s" value "%2$s" for correlation "%3$s". Дублікат "%1$s" значення "%2$s" в кореляції "%3$s". Duplicate dependencies in trigger "%1$s". Дублюючі залежності в тригері "%1$s". Duplicate dependencies in trigger prototype "%1$s". Дублікат залежності в прототипі тригерів "%1$s". Duplicate "description" value "%1$s" for media type. Дублікат значення "%1$s" для "description" у метода повідомлень. Duplicate host. Host with the same host name "%s" already exists in data. Дублікат вузла мережі. Вузел мережі з таким же ім'ям "%s" вже існує в даних. Duplicate host. Host with the same visible name "%s" already exists in data. Дублікат вузла мережі. Вузел мережі з таким же видимим ім'ям "%s" вже існує в даних. Duplicate "name" value "%1$s" for application prototype in item prototype "%2$s". Дублікат значення "%1$s" для "name" у прототипу групи елементів даних "%2$s". Duplicate "name" value "%1$s" for map. Дублікат значення "%1$s" для "name" у карти мережі. Duplicate "name" value "%1$s" for screen. Дублікат значення "%1$s" для "name" у комплексного екрану. Duplicate severity name "%s". Дублікат назви важливості "%s". Duplicate userid "%1$s" in users for map "%2$s". Дублікат userid "%1$s" у користувачів для карти мережі "%2$s". Duplicate userid "%1$s" in users for screen "%2$s". Дублікат userid "%1$s" у користувачів для комплексного екрану "%2$s". Duplicate usrgrpid "%1$s" in user groups for map "%2$s". Дублікат usrgrpid "%1$s" у групах користувачів для карти мережі "%2$s". Duplicate usrgrpid "%1$s" in user groups for screen "%2$s". Дублікат usrgrpid "%1$s" у групах користувачів для комплексного екрану "%2$s". Duration Тривалість Dutch (nl_NL) Голландська (nl_NL) Dynamic item Динамічний елемент Dynamic items Динамічні елементи даних Each URL should have a unique name. Please make sure there is only one URL named Кожнен URL-запит повинен мати унікальне ім'я. Будь ласка переконайтесь що це тільки один URL-запит з таким іменем Edit Змінити Edit dashboard Редагувати панель Edit map Редагувати карту мережі Edit screen Редагувати комплексний екран Edit slide show Редагувати слайд шоу Edit tree element Редагувати елемент дерева Edit trigger Редагувати тригер Edit widget Редагувати віджет Effective value Результативне значення Elasticsearch error: %1$s. Помилка Elasticsearch: %1$s. Elasticsearch url is not set for type: %1$s. Elasticsearch url не встановлено для типу: %1$s. Element Елемент Element name Назва елемента Ellipse Еліпс Email Email Empty Пусто Empty action condition. Умова дії пуста. Empty application prototype name in item prototype "%1$s". Пусте ім'я прототипу групи елементів даних в прототипі елементів даних "%1$s". Empty colour. Пустий колір. Empty correlation ID. Пустий ID кореляції. Empty filter condition formula ID for action "%1$s". Пустий ID формули умови фільтру для дії "%1$s". Empty filter condition formula ID for discovery rule "%1$s". Пустий ID формули умови фільтру для правила виявлення "%1$s". Empty filter condition macro for discovery rule "%1$s". Пустий макрос умови фільтру для правила виявлення "%1$s". Empty input parameter. Вхідний параметр пустий. Empty input parameters. Пусті вхідні параметри. Empty map ID. Пустий ID карти мережі. Empty media type ID. Пустий ID методу повідомлень. Empty name. Пусте ім'я. Empty parameters Пусті параметри Empty screen ID. Пустий ID комплексного екрану. Empty screen ID for screen. Пустий screen ID для комплексного екрану. Empty screen ID for template screen. Пустий screen ID для шаблонного комплексного екрану. Empty SSL certificate file for web scenario "%1$s". Пустий файл SSL сертифікату у веб сценарії "%1$s". Empty SSL key file for web scenario "%1$s". Пустий файл SSL ключа у веб сценарії "%1$s". Enable Активувати Enable confirmation Задіяти підтвердження Enabled Активовано Enable debug mode Активувати діагностичний режим Enable debug mode in selected groups? Активувати діагностичний режим для вибраних груп? Enable host Активувати вузел мережі Enable host? Активувати вузел мережі? Enable hosts Активувати вузли мережі Enable hosts monitored by selected proxies? Активувати вузли мережі, які моніторяться обраними проксі? Enable HTTP authentication Активувати HTTP аутентифікацію Enable internal housekeeping Активувати внутрішню очистку Enable LDAP authentication Активувати LDAP аутентифікацію Enable selected actions? Активувати вибрані дії? Enable selected applications? Активувати вибрані групи елементів даних? Enable selected correlations? Активувати вибрані кореляції? Enable selected discovery rules? Активувати вибрані правила виявлення? Enable selected groups? Активувати вибрані групи? Enable selected hosts? Активувати вибрані вузли мережі? Enable selected items? Активувати вибрані елементи даних? Enable selected media types? Активувати вибрані методи повідомлень? Enable selected triggers? Активувати вибрані тригери? Enable selected web scenarios? Активувати вибрані прототипи веб сценаріїв? Enable trapping Активувати трапи Encryption Шифрування English (en_GB) Англійська (en_GB) English (en_US) Англійська (en_US) equals дорівнює Equals Дорівнює Error Помилка Error: %1$s Помилка: %1$s Error in search request for table "%1$s". Помилка в запиті пошуку в таблиці "%1$s". Error message Повідомлення про помилку esc_step_from and esc_step_to must be set together. esc_step_from та esc_step_to повинні встановлюватись одночасно. Event Подія Event acknowledged Подію підтвержено Event correlation Кореляція подій Event correlation rules Правила кореляції події Event details Подробиці події Event generation Генерація події Event ID ID події Event list [previous 20] Список подій [20 попередніх] Event log monitoring. Returns log Моніторинг журналів подій. Повертає записи з журналу Events and alerts Події і повідомлення Event source Джерело події Event tag pair Пара тегів події Event type Тип події Event updated Події оновлено Event updated Подій оновлено Event updated Подію оновлено Every day(s) Щодня Every week(s) Щотижня Exclude Виключено Exclude host groups Виключити групи вузлів мережі Execute Виконати Executed Виконано Executed script Скрипт для виконання Execute on Виконати на Execute SQL error [%1$s] in [%2$s]. Помилка виконання SQL [%1$s] у [%2$s]. Execute WMI query and return the first selected object. Returns integer, float, string or text (depending on the request) Виконує WMI запит та повертає перший вибраний об'єкт. Повертає ціле число, дробове число, рядок або текст (в залежності від запиту) Execution confirmation Підтвердження виконання Expand Розгорнути Expand macros Розкрити макроси Expand single problem Розгортати одиночну проблему Expired Завершено Exploded Розширений круговий Export Експорт Export to CSV Експортувати в CSV Expression Вираз Expression cannot be empty Вираз не може бути пустим Expression constructor Конструктор виразу expression is empty вираз пустий Expressions Вирази Expression syntax error. Синтаксична помилка у виразі. Expression type Тип виразу Expression Variable Elements Значення елементів Виразу External check Зовнішня перевірка Ez Texting Ez Texting F Пт Fail Помилка Failed Помилковий Failed to create dashboard Помилка при створенні панелі failed to parse JSON не вдалося проаналізувати JSON Failed to parse URL. Помилка при обробці URL. Failed to update dashboard Помилка при оновленні панелі Failed to update template. Помилка при оновленні шаблону. Failure Audit Аудит відмов FALSE ФАЛЬШ Fatal error, please report to the Zabbix team Критична помилка, будь-ласка повідомте про це команді Zabbix Favourite graphs Обрані графіки Favourite maps Обрані карти мереж Favourite screens Обрані комплексні екрани Feb Лют February Лютий Field Поле Field "%1$s" cannot be set to NULL. Поле "%1$s" не може бути встановлено в NULL. Field "%1$s" is mandatory. Поле "%1$s" є обов'язковим. Field "%1$s" is missing a value for map "%2$s". В полі "%1$s" відсутнє значення для карти мережі "%2$s". Field "%1$s" is missing a value for media type "%2$s". В полі "%1$s" відсутнє значення для методу повідомлень "%2$s". Field "%1$s" is missing a value for screen "%2$s". В полі "%1$s" відсутнє значення для комплексного екрану "%2$s". Field "%1$s" is not correct: %2$s Поле "%1$s" некоректне: %2$s Field "%1$s" is not integer. Поле "%1$s" не ціле число. Field "%1$s" is not string. Поле "%1$s" не рядок. Field "%1$s" is required for media type "%2$s". Поле "%1$s" є обов'язковим для методу повідомлень "%2$s". Field "%1$s" must be missing. Поле "%1$s" не повинно бути присутнім. Field "host" is mandatory. Поле "host" є обов'язковим. File checksum, calculated by the UNIX cksum algorithm. Returns integer Контрольна сума файлу, вираховується алгоритмом UNIX cksum. Повертає ціле число File format is unsupported. Формат файлу не підтримується. File is too big, max upload size is %1$s bytes. Файл занадто великий, максимальний розмір файлу для завантаження %1$s байт. File provided to a view does not exist. Tried to find "%s". Файл вказаний для відображення не існує. Була спроба знайти "%s". File size (in bytes). Returns integer Розмір файлу (в байтах). Повертає ціле число File time information. Returns integer (Unix timestamp) Інформація часу файлу. Повертає ціле число (Unix timestamp) Fill Заливка Filled region Заповнений регіон Filter Фільтр Filters Фільтри Find string in a file. Returns 0 - match not found; 1 - found Пошук рядка в файлі. Повертає 0 - відповідностей не знайдено; 1 - знайдено Find string in a file. Returns the line containing the matched string, or as specified by the optional output parameter Пошук рядка в файлі. Повертає рядок, який містить відповідність, або як задано в додатковому параметрі output Find string on a web page. Returns the matched string, or as specified by the optional output parameter Пошук рядка на веб сторінці. Повертає рядок, який містить відповідність, або як задано в додатковому параметрі output Finish Завершити Finnish (fi_FI) Фінська (fi_FI) first перший First Перша first parameter is expected очікується перший параметр Fit Апроксимація Fit to map Вписати в карту мережі Fixed Фіксоване Flexible Гнучкий Follow redirects Слідувати перенаправленням Font Шрифт Font colour Колір шрифту Font size Розмір шрифту forecast() - Forecast for next t seconds based on period T forecast() - Прогноз значення через t секунд на основі періоду Т For guest, password must be empty Для Гостя пароль повинен бути пустим Form data Дані форми Formula Формула fourth четвертий French (fr_FR) Французька (fr_FR) Fri П'ят Friday П'ятниця From З Frontend access Доступ до веб-інтерфейсу Frontend access updated Доступ до веб-інтерфейсу оновлено Frontend messaging Повідомлення у веб-інтерфейсі FTP FTP Full Повне Full clone Клонувати повністю Fullscreen На весь екран Function Функція fuzzytime() - Difference between item value (as timestamp) and Zabbix server timestamp is less than or equal to T seconds (1 - true, 0 - false) fuzzytime() - Різниця між значенням елементу даних (як штамп часу) та штампом часу Zabbix сервера є меншою за або дорівнює T секунд (1 - істина, 0 - фальш) General Загальні Generated in %s sec Згенеровано за %s сек. Georgian (ka_GE) Грузинська (ka_GE) German (de_DE) Німецька (de_DE) Get content of web page. Returns web page source as text Отримання вмісту веб сторінки. Повертає джерельний код веб сторінки у вигляді тексту Given expression is not a macro Наданий вираз це не макрос global housekeeping settings глобальних налаштуваннях очистки історії Global regular expression "%1$s" does not exist. Глобальний регулярний вираз "%1$s" не існує. Global script Глобальний скрипт Global scripts Глобальні скрипти Global value Глобальне значення GMT%1$s GMT%1$s Go back to %1$s Повернутись до %1$s Google Chrome Google Chrome Go to Перейти до Go to dashboard Перейти на ПАНЕЛЬ Gradient line Градієнтна лінія Graph Графік Graph "%1$s" already exists on "%2$s". Графік "%1$s" вже існує у "%2$s". Graph "%1$s" already exists on "%2$s" (inherited from another template). Графік "%1$s" вже існує у "%2$s" (успадковано із іншого шаблону). Graph "%1$s" already exists on "%2$s" (items are not identical). Графік "%1$s" вже існує у "%2$s" (елементи даних не ідентичні). Graph "%1$s" cannot inherit. No required items on "%2$s". Графік "%1$s" не може бути успадковано. Не вистачає обов'язкових елементів даних у "%2$s". Graph "%1$s" cannot inherit. No required items on "%2$s" (Ymax value item). Графік "%1$s" не може бути успадковано. Не вистачає обов'язкових елементів даних у "%2$s" (елемента даних для макс. значення вісі Y). Graph "%1$s" cannot inherit. No required items on "%2$s" (Ymin value item). Графік "%1$s" не може бути успадковано. Не вистачає обов'язкових елементів даних у "%2$s" (елемента даних для мін. значення вісі Y). Graph "%1$s" does not exist on template "%2$s". Графік "%1$s" не існує в шаблоні "%2$s". Graph "%1$s" with templated items cannot contain items from other hosts. Графік "%1$s" з елементами даних із шаблону не може містити елементи даних з інших вузлів мережі. Graph added Графік додано Graph (classic) Графік (класичний) Graph copied Графіки скопійовано Graph copied Графік скопійовано Graph copied Графіки скопійовано Graph deleted Графік видалено Graph element Елемент графіка Graph prototype Прототип графіків Graph prototype "%1$s" contains item prototypes from multiple discovery rules. Прототип графіків "%1$s" містить прототипи елементів даних від декількох правил виявлення. Graph prototype "%1$s" must have at least one item prototype. Прототип графіків "%1$s" повинен містити принаймні один прототип елементів даних. Graph prototype "%1$s" with templated items cannot contain items from other hosts. Прототип графіку "%1$s" з елементами даних із шаблону не може містити елементи даних з інших вузлів мережі. Graph prototype added Прототип графіків додано Graph prototype deleted Прототип графіків видалено Graph prototype not found. Прототип графіків не знайдено. Graph prototypes Прототипи графіків Graph prototypes deleted Прототипи графіків видалено Graph prototype updated Прототип графіків оновлено Graph prototype with ID "%1$s" is not available. Прототип графіка з ID "%1$s" недоступний. Graphs Графіки Graphs deleted Графіки видалено Graph sum Сума графіку Graph type Тип графіка Graph updated Графік оновлено Graph with ID "%1$s" is not available. Графік з ID "%1$s" недоступний. Graph with name "%1$s" already exists in graphs or graph prototypes. Графік з іменем "%1$s" вже існує в графіках або в прототипах графіків. Graph with same name but other type exist. Графік з таким же іменем, але іншого типу, вже існує. Greek (el_GR) Грецька (el_GR) Grid Сітка Group Група Group "%1$s" cannot be deleted, because it is used by a host prototype. Групу "%1$s" не може бути видалено, так як вона використовується прототипом вузлів мережі. Group "%1$s" cannot be deleted, because it is used in a correlation condition. Група "%1$s" не може бути видалена, так як вона використовується в умові кореляції. Group "%1$s" does not exist. Група "%1$s" не існує. Group "%1$s" for host "%2$s" does not exist. Група "%1$s" для вузла мережі "%2$s" не існує. Group added Групу додано Group deleted Групи видалено Group deleted Групи видалено Group deleted Групу видалено Group for discovered hosts Група для виявлених вузлів Group for discovered hosts "%1$s". Група для виявлених вузлів мережі "%1$s". Grouping by Згруповано по Group name Назва групи Group prototype cannot be based on a discovered host group "%1$s". Прототип групи не може бути заснований на виявленій групі вузлів мережі "%1$s". Group prototypes Прототипи груп Groups Групи Group updated Групу оновлено GSM modem GSM модем GUI Веб інтерфейс GUI access disabled. Доступ до GUI відключено. h г Hardware Апаратна конфігурація Hardware (Full details) Апаратна частина (повні деталі) Hardware sensor reading. Returns float Значення апаратного сенсору. Повертає дробове число Headers Заголовки Hebrew (he_IL) Іврит (he_IL) Height Висота Help Допомога Hexadecimal to decimal Шістнадцяткове в десяткове hh гг hh.mm hh.mm H:i H:i Hidden Прихована Hide debug Сховати діагностичну інф. Hide groups without problems Сховати групи без проблем Hide selected Не відображувати тільки відібрані Hierarchy Ієрархія High Висока High-contrast dark Висококонтрастна темна High-contrast light Висококонтрастна світла Highlight whole row Підсвічувати весь рядок H:i:s H:i:s History Історія History cleared Історію очищено History clearing can take a long time. Continue? Очистка журналу може забрати багато часу. Продовжувати? History data selection Вибір даних історії History data storage period Період зберігання даних історії History data storage period "%1$s". Період зберігання даних історії "%1$s". History of events Історія подій History storage period Період зберігання історії Horizontal Горизонтальний Horizontal align Вирівнювання по горизонталі host вузел мережі Host Вузли мережі Host Вузли мережі Host Вузел мережі Host "%1$s" already exists. Вузел мережі "%1$s" вже існує. Host "%1$s" cannot be without host group. Вузел мережі "%1$s" не може бути без групи вузлів мережі. Host "%1$s" is monitored with proxy "%2$s". Вузел мережі "%1$s" під спостереженням через проксі "%2$s". Host access Доступ до вузла мережі Host added Вузел мережі додано Host (ascending) Вузел мережі (в порядку зростання) Host cannot have more than one default interface of the same type. У вузла мережі не може бути більше одного інтерфейсу по замовчуванню однакового типу. Host count Кількість вузлів мережі Host deleted Вузел мережі видалено Host disabled Вузел мережі дезактивовано Host disabled Вузли мережі дезактивовано Host disabled Вузли мережі дезактивовано Host enabled Вузли мережі активовано Host enabled Вузел мережі активовано Host enabled Вузли мережі активовано host group група вузлів мережі Host group Група вузлів мережі Host group "%1$s" already exists. Група вузлів мережі "%1$s" вже існує. Host group "%1$s" cannot be deleted, because it is used in a global script. Група вузлів мережі "%1$s" не може бути видалена, так як вона використовується в глобальному скрипті. Host group "%1$s" is internal and can not be deleted. Група вузлів мережі "%1$s" являється внутрішньою і не може бути видалена. Host group elements Елементи групи вузлів мережі Host group issues Події в групі вузлів мережі Host group label type Тип ярлика до групи вузлів мережі Host groups Групи вузлів мережі Host group with ID "%1$s" is not available. Група вузлів мережі з ID "%1$s" недоступна. hostid of dependent item and master item should match hostid залежного елемента даних та головного елемента даних мають співпадати Host info Інформація по вузлах мережі Host interface Інтерфейс вузла мережі Host inventory Інвентарні дані вузла мережі Host inventory overview Огляд інвентарних даних вузла мережі Host IP IP адреса вузла мережі host is not monitored вузел мережі без спостереження Host issues Події вузла мережі "host:key" pair is expected очікувалась пара "вузел мережі:ключ" Host label type Тип ярлика до вузла мережі Host macros Макроси вузла мережі Host metadata Метадані вузла мережі Host name Ім'я вузла мережі Host networks Мережі вузла мережі host pattern маска вузла мережі Host prototype Прототип вузла мережі Host prototype "%1$s" already exists on "%2$s". Прототип вузлів мережі "%1$s" уже існую в "%2$s". Host prototype "%1$s" already exists on "%2$s", inherited from another template. Прототип вузлів мережі "%1$s" вже існує в "%2$s", успадкований з іншого шаблону. Host prototype added Прототип вузлів мережі додано Host prototype deleted Прототип вузлів мережі видалено Host prototypes Прототипи вузлів мережі Host prototypes deleted Прототипи вузлів мережі видалено Host prototype updated Прототипи вузлів мережі оновлено Host prototype updated Прототипи вузлів мережі оновлено Host prototype updated Прототип вузлів мережі оновлено Host prototype with host name "%1$s" already exists in discovery rule "%2$s". Прототип вузлів мережі з іменем вузла мережі "%1$s" вже існує в правилі виявлення "%2$s". Host prototype with visible name "%1$s" already exists in discovery rule "%2$s". Прототип вузлів мережі з видимим іменем вузла мережі "%1$s" вже існує в правилі виявлення "%2$s". Host router Шлюз вузла мережі Hosts Вузли мережі Hosts and groups Вузли мережі та групи Host screens Комплексні екрани вузла мережі Hosts location Розміщення вузлів Host subnet mask Маска підмережі вузла мережі Hosts updated Вузли мережі оновлено Host time Час вузла мережі Host updated Вузел мережі оновлено Host update failed. Помилка при оновленні вузла мережі. Host with ID "%1$s" is not available. Вузел мережі з ID "%1$s" недоступний. Host with the same name "%1$s" already exists. Вузел мережі з таким самим іменем "%1$s" вже існує. Host with the same name "%s" already exists. Вузел мережі з цим самим іменем "%s" вже існує. Host with the same visible name "%1$s" already exists. Вузел мережі з таким самим видимим іменем "%1$s" вже існує. Host with the same visible name "%s" already exists. Вузел мережі з цим самим видимим іменем "%s" вже існує. Hours Годин Housekeeping Очистка HTTP HTTP HTTP agent HTTP агент HTTP authentication HTTP аутентифікація HTTP login form HTTP діалог входу в систему HTTP proxy HTTP проксі HTTPS HTTPS HTTP settings Налаштування HTTP Hungarian (hu_HU) Угорська (hu_HU) HW architecture Архітектура HW ICMP ping ICMP ping icon іконка Icon Іконка Icon (default) Іконка (по замовчуванню) Icon (disabled) Іконка (відключено) Icon highlight Виділення іконки Icon (maintenance) Іконка (обслуговування) Icon map Призначення іконок Icon map "%1$s" cannot be deleted. Used in map "%2$s". Призначення іконок "%1$s" не може бути видалено. Використовується в карті мережі "%2$s". Icon map created Призначення іконок створено Icon map deleted Призначення іконок видалено Icon mapping Призначення іконок Icon map "%s" already exists. Призначення іконок "%s" вже існує. Icon map updated Призначення іконок оновлено Icon (problem) Іконка (проблема) Icons Іконки Icon with ID "%1$s" is not available. Іконка з ID "%1$s" недоступна. ID ID Identification of the system. Returns string Ідентифікатор системи. Повертає рядок If you think this message is wrong, please consult your administrators about getting the necessary permissions. Якщо Ви вважаєте це повідомлення помилковим, то зверніться до вашого адміністратора для отримання необхідних прав доступу. image картинка Image Картинка Image "%1$s" already exists. Картинка "%1$s" вже існує. Image added Картинку додано Image deleted Картинку видалено Image label type Тип ярлика до картинки Image load error [%1$s] in [%2$s]. Помилка завантаження зображення [%1$s] в [%2$s]. Images Картинки Images for all maps will be updated! Картинки для всіх карт мереж буде оновлено! Image updated Картинку оновлено IMAP IMAP Immediately Негайно Import Імпорт Imported successfully Імпортовано успішно Import failed Імпорт не вдався Import file Імпорт файлу Impossible to filter by inventory field "%s", which does not exist. Неможливо фільтрувати по неіснуючому полю інвентарних даних "%s". in в Inaccessible graph Недоступний графік Inaccessible group Недоступна група Inaccessible host Недоступний вузел мережі Inaccessible item Недоступний елемент даних Inaccessible maintenance Недоступне обслуговування Inaccessible map Недоступна карта мережі Inaccessible template Недоступний шаблон Inaccessible trigger Недоступний тригер Inaccessible user Недоступний користувач Include Включено Include subgroups Включити субгрупи including subgroups включаючи субгрупи Incoming traffic statistics on network interface. Returns integer Статистика вхідного трафіку мережевого інтерфейсу. Повертає ціле число Incorrect %1$s label type value for map "%2$s". Некоректне значення %1$s типу підпису для карти мережі "%2$s". Incorrect acceptable SLA for service "%1$s". Некоректне допустиме SLA для послуги "%1$s". Incorrect acknowledgement action operationid. Некоректний operationid операції підтвердження. Incorrect action condition discovery check. Некоректна перевірка виявлення в умові дії. Incorrect action condition discovery check. Discovery check does not exist or you have no access to it. Некоректна перевірка виявлення в умові дії. Перевірка виявлення не існує або у вас немає прав доступу до неї. Incorrect action condition discovery object. Некоректний об'єкт виявлення в умові дії. Incorrect action condition discovery rule. Discovery rule does not exist or you have no access to it. Некоректна правило виявлення в умові дії. Правило виявлення не існує або у вас немає прав доступу до нього. Incorrect action condition discovery status. Некоректний стан виявлення в умові дії. Incorrect action condition event type. Некоректний тип події в умові дії. Incorrect action condition host group. Host group does not exist or you have no access to it. Некоректна група вузлів мережі в умові дії. Група вузлів мережі не існує або у вас немає прав доступу до неї. Incorrect action condition host. Host does not exist or you have no access to it. Некоректний вузел мережі в умові дії. Вузел мережі не існує або у вас немає прав доступу до нього. Incorrect action condition port "%1$s". Некоректний порт "%1$s" в умові дії. Incorrect action condition proxy. Proxy does not exist or you have no access to it. Некоректний проксі в умові дії. Проксі не існує або у вас немає прав доступу до нього. Incorrect action condition template. Template does not exist or you have no access to it. Некоректний шаблон в умові дії. Шаблон не існує або у вас немає прав доступу до нього. Incorrect action condition trigger severity. Некоректна важливість тригера в умові дії. Incorrect action condition trigger. Trigger does not exist or you have no access to it. Некоректний тригер в умові дії. Тригер не існує або у вас немає прав доступу до нього. Incorrect action condition type. Некоректний тип умови дії. Incorrect action operation command type. Некоректний тип команди в операції дії. Incorrect action operation condition acknowledge type. Некоректний тип підтвердження для умови в операції дії. Incorrect action operation condition type. Некоректний тип умови в операції дії. Incorrect action operation escalation step values. Некоректні значення кроку ескалації для операції дії. Incorrect action operation host group. Host group does not exist or you have no access to this host group. Некоректна група вузлів мережі в операції дії. Група вузлів мережі не існує або у вас немає прав доступу до цієї групи вузлів мережі. Incorrect action operation host. Host does not exist or you have no access to this host. Некоректний вузел мережі для операції дії. Вузел мережі не існує або ви не маєте до нього доступу. Incorrect action operationid. Некоректний id операції дії. Incorrect action operation port "%s". Некоректний порт "%s" для операції дії. Incorrect action operation template. Template does not exist or you have no access to this template. Некоректний шаблон в операції дії. Шаблон не існує або у вас немає прав доступу до цього шаблону. Incorrect action operation type "%1$s" for event source "%2$s". Некоректний тип операції дії "%1$s" для джерела події "%2$s". Incorrect action operation user group. User group does not exist or you have no access to this user group. Некоректна група користувачів для операції дії. Група користувачів не існує або ви не маєте до неї доступу. Incorrect action operation user. User does not exist or you have no access to this user. Некоректний користувач для операції дії. Користувач не існує або ви не маєте до нього доступу. Incorrect algorithm for service "%1$s". Некоректний алгоритм для послуги "%1$s". Incorrect API "%1$s". Некоректний API "%1$s". Incorrect arguments passed to function Функції передано некоректні параметри Incorrect arguments passed to function. Функції передано некоректні параметри. Incorrect arguments passed to method. Некоректні параметри передано методу. Incorrect authentication protocol for item "%1$s". Некоректний протокол аутентифікації для елемента даних "%1$s". Incorrect bulk value for interface. Некоректне масове значення для інтерфейсу. Incorrect calculate SLA value for service "%1$s". Некоректне значення для вирахування SLA для послуги "%1$s". Incorrect characters used for host name "%s". Використано некоректні символи в імені вузла мережі "%s". Incorrect characters used for proxy name "%1$s". Використано некоректні символи в імені проксі "%1$s". Incorrect characters used for template name "%1$s". Використано некоректні символи в імені шаблону "%1$s". Incorrect conditions for action "%1$s". Некоректні умови для дії "%1$s". Incorrect conditions for discovery rule "%1$s". Некоректні умови для правила виявлення "%1$s". Incorrect correlation ID. Некоректний ID кореляції. Incorrect custom expression "%2$s" for action "%1$s": %3$s. Некоректний довільний вираз "%2$s" для дії "%1$s": %3$s. Incorrect custom expression "%2$s" for correlation "%1$s": %3$s. Некоректний довільний вираз "%2$s" для кореляції "%1$s": %3$s. Incorrect custom expression "%2$s" for discovery rule "%1$s": %3$s. Некоректний довільний вираз "%2$s" для правила виявлення "%1$s": %3$s. Incorrect data. Некоректні дані. incorrect element count некоректна кількість елементів Incorrect evaltype value. Некоректне значення evaltype. Incorrect event object "%1$s" (%2$s) for event source "%3$s" (%4$s), only the following objects are supported: %5$s. Некоректний об'єкт події "%1$s" (%2$s) для джерела події" %3$s" (%4$s), підтримуються тільки наступні об'єкти: %5$s. Incorrect eventobject value. Некоректне значення eventobject. Incorrect eventsource value. Некоректне значення eventsource. Incorrect field "%1$s" name or value in where statement for table "%2$s". Некоректне ім'я або значення поля "%1$s" в операторі where для таблиці "%2$s". Incorrect fields for sysmap. Некоректні поля для sysmap. Incorrect file upload. Некоректний завантажуваний файл. Incorrect filter condition formula ID for action "%1$s". Некоректний ID формули умови фільтру для дії "%1$s". Incorrect filter condition formula ID for discovery rule "%1$s". Некоректний ID формули умови фільтру для правила виявлення "%1$s". Incorrect filter condition formula ID given for correlation "%1$s". Задано некоректний ID формули умови фільтру для кореляції "%1$s". Incorrect filter condition macro for discovery rule "%1$s". Некоректний макрос умови фільтру для правила виявлення "%1$s". Incorrect filter condition operator for action "%1$s". Некоректний оператор умови фільтру для дії "%1$s". Incorrect filter condition operator for discovery rule "%1$s". Некоректний оператор умови фільтру для правила виявлення "%1$s". Incorrect filter condition type for action "%1$s". Некоректний тип умови фільтру для дії "%1$s". Incorrect function is used Використано некоректну функцію Incorrect graph ID "%1$s" provided for screen element. Некоректний ID графіку "%1$s" вказано для елементу комплексного екрану. Incorrect graph prototype ID "%1$s" provided for screen element. Некоректний ID прототипу графіку "%1$s" вказано для елементу комплексного екрану. Incorrect "height" value for map "%1$s". Некоректне значення "height" у карти мережі "%1$s". Incorrect host group. Некоректна група вузлів мережі. Incorrect host group ID "%1$s" provided for screen element. Некоректний ID групи вузлів мережі "%1$s" вказано для елементу комплексного екрану. Incorrect host ID "%1$s" provided for screen element. Некоректний ID вузла мережі "%1$s" вказано для елементу комплексного екрану. Incorrect image index. Некоректний номер картинки. Incorrect input parameters. Некоректні вхідні параметри. Incorrect interface DNS parameter "%s" provided. Для інтерфейсу вказано некоректний параметр DNS "%s". Incorrect interface port "%s" provided. Для інтерфейсу вказано некоректний порт "%s". Incorrect inventory field "%s". Некоректне поле "%s" інвентарних даних. Incorrect inventory mode in action operation. Некоректний режим інвентарних даних в операції дії. Incorrect item for axis value. Некоректний елемент даних для значення вісі. Incorrect item ID "%1$s" provided for screen element. Некоректний ID елемента даних "%1$s" вказано для елемента комплексного екрану. Incorrect item key "%1$s" provided for trigger expression on "%2$s". У виразі тригера "%2$s" вказано некоректний ключ елемента даних "%1$s". Incorrect item prototype ID "%1$s" provided for screen element. Некоректний ID прототипу елемента даних "%1$s" вказано для елемента комплексного екрану. Incorrect item value type Некоректний тип значення елемента даних Incorrect item value type "%1$s" provided for trigger function "%2$s". Некоректний тип значення елемента даних "%1$s" вказано для функції тригера "%2$s". Incorrect list of items. Некоректний список елементів даних. Incorrect maintenance date Некоректна дата періоду сервісу Incorrect maintenance - date must be between 1970.01.01 and 2038.01.18 Некоректний сервіс - дата має бути між 1970.01.01 та 2038.01.18 Incorrect maintenance day period Некоректний день періоду сервісу Incorrect maintenance days of week Некоректний день тижня періоду сервісу Incorrect maintenance month period Некоректний місяць періоду сервісу Incorrect maintenance period Некоректний період сервісу Incorrect maintenance period (minimum 5 minutes) Некоректний період сервісу (мінімум 5 хвилин) Incorrect maintenance week period Некоректний тиждень періоду сервісу Incorrect map ID. Некоректний ID карти мережі. Incorrect map ID "%1$s" provided for screen element. Некоректний ID карти мережі "%1$s" вказано для елемента комплексного екрану. Incorrect max columns provided for screen element. Некоректне значення максимальної кількості колонок вказано для елемента комплексного екрану. Incorrect media type ID. Некоректний ID методу повідомлень. Incorrect method "%1$s.%2$s". Некоректний метод "%1$s.%2$s". Incorrect object value. Некоректне значення об'єкта. Incorrect parameter for action "%1$s". Некоректний параметр для дії "%1$s". Incorrect parameter for operations. Некоректний параметр для операцій. Incorrect parameters for action update method "%1$s". Некоректні параметри для методу оновлення дії "%1$s". Incorrect parameters for condition. Некоректні параметри для умови. Incorrect parameters for maintenance. Некоректні параметри для сервісу. Incorrect parent for service "%1$s". Некоректна батьківська для послуги "%1$s". Incorrect parent service. Некоректна батьківська послуга. Incorrect "permission" value "%1$s" in user groups for map "%2$s". Некоректне значення "%1$s" для "permission" в групах користувачів для карти мережі "%2$s". Incorrect "permission" value "%1$s" in user groups for screen "%2$s". Некоректне значення "%1$s" для "permission" в групах користувачів для комплексного екрану "%2$s". Incorrect "permission" value "%1$s" in users for map "%2$s". Некоректне значення "%1$s" для "permission" в користувачах для карти мережі "%2$s". Incorrect "permission" value "%1$s" in users for screen "%2$s". Некоректне значення "%1$s" для "permission" в користувачах для комплексного екрану "%2$s". Incorrect port range. Некоректний діапазон портів. Incorrect privacy protocol for item "%1$s". Некоректний протокол приватності для елемента даних "%1$s". Incorrect "private" value "%1$s" for map "%2$s". Некоректне значення "%1$s" для "private" для карти мережі "%2$s". Incorrect "private" value "%1$s" for screen "%2$s". Некоректне значення "%1$s" для "private" для комплексного екрану "%2$s". Incorrect regular expression "%1$s": "%2$s" Некоректний регулярний вираз "%1$s": "%2$s" Incorrect resource type provided for screen item. Вказано некоректний тип ресурсу для елементу комплексного екрану. Incorrect response received from Zabbix server "%1$s". Некоректну відповідь отримано від Zabbix сервера "%1$s". Incorrect screen ID. Некоректний ID комплексного екрану. Incorrect screen ID "%1$s" provided for screen element. Некоректний ID комплексного екрану "%1$s" вказано для елемента комплексного екрану. Incorrect screen provided for slide show. Некоректний комплексний екран вказано для слайд-шоу. Incorrect service end time. Некоректний час завершення послуги. Incorrect service start time. Некоректний час початку послуги. Incorrect service time type. Некоректний тип часу послуги. Incorrect SNMP community. Некоректне SNMP community. Incorrect SNMP OID. Некоректний SNMP OID. Incorrect "soft" field value for dependency for service "%1$s". Некоректне значення поля "не жорстка" для залежності у послуги "%1$s". Incorrect sort order for service "%1$s". Некоректный порядок сортування в послуги "%1$s". Incorrect source value. Некоректне значення джерела. Incorrect status for host "%1$s". Некоректний статус для вузла мережі "%1$s". Incorrect status for service "%1$s". Некоректний стан для послуги "%1$s". Incorrect style provided for screen element. Некоректний стиль вказано для елемента комплексного екрану. incorrect syntax near "%1$s" некоректний синтаксис біля "%1$s" Incorrect templated web scenario step count. Некоректна кількість кроків шаблонного веб сценарію. Incorrect template screen ID. Некоректний ID шаблонного комплексного екрану. Incorrect trigger expression Некоректний вираз тригера Incorrect trigger expression. Некоректний вираз тригера. Incorrect trigger expression. Host "%1$s" does not exist or you have no access to this host. Некоректний вираз тригера. Вузел мережі "%1$s" не існує або ви не маєте до цього вузла мережі. Incorrect trigger expression. Trigger expression elements should not belong to a template and a host simultaneously. Некоректний вираз тригера. Елементи виразу тригера не повинні належати шаблону та вузлу мережі одночасно. Incorrect trigger function "%1$s" provided in expression. У виразі вказано некоректну функцію тригера "%1$s". Incorrect trigger ID for service "%1$s". Некоректний ID тригера для послуги "%1$s". Incorrect trigger prototype expression. Host "%1$s" does not exist or you have no access to this host. Некоректний вираз прототипу тригера. Вузел мережі "%1$s" не існує або у вас немає права доступу до нього. Incorrect trigger prototype expression. Trigger prototype expression elements should not belong to a template and a host simultaneously. Некоректний вираз прототипу тригера. Елементи виразу прототипу тригера не повинні належати шаблону та вузлу мережі одночасно. Incorrect type of calculation for action "%1$s". Некоректний тип підрахунку для дії "%1$s". Incorrect type of calculation for correlation "%1$s". Некоректний тип обчислення для кореляції "%1$s". Incorrect type of calculation for discovery rule "%1$s". Некоректний тип підрахунку для правила виявлення "%1$s". Incorrect user group. Некоректна група користувачів. Incorrect user group ID specified for map "%1$s". Некоректне значення ID групи користувачів вказано для карти мережі "%1$s". Incorrect user group ID specified for screen "%1$s". Некоректне значення ID групи користувачів вказано для комплексного екрану "%1$s". Incorrect user ID specified for map "%1$s". Некоректне значення ID користувача вказано для карти мережі "%1$s". Incorrect user ID specified for screen "%1$s". Некоректне значення ID користувача вказано для комплексного екрану "%1$s". Incorrect value "%1$s" for "%2$s" field. Некоректне значення "%1$s" для поля "%2$s". Incorrect value "%1$s" for "%2$s" field: must be between %3$s and %4$s. Некоректне значення "%1$s" для поля "%2$s": має бути між %3$s та %4$s. Incorrect value "%1$s" for float field "%2$s". Значення "%1$s" є некоректним для поля дробового числа "%2$s". Incorrect value "%1$s" for int field "%2$s". Значення "%1$s" є некоректним для поля цілого числа "%2$s". Incorrect value "%1$s" for unsigned int field "%2$s". Значення "%1$s" є некоректним для поля числа без знаку "%2$s". Incorrect value "%1$s" in field "%2$s" for correlation "%3$s". Некоректне значення "%1$s" в полі "%2$s" для кореляції "%3$s". Incorrect value "%1$s" in field "%2$s" for media type "%3$s". Некоректне значення "%1$s" в полі "%2$s" для методу повідомлень "%3$s". Incorrect value for "%1$s" field. Некоректне значення для поля "%1$s". Incorrect value for field "%1$s": %2$s. Некоректне значення для поля "%1$s": %2$s. Incorrect value for field "%1$s": cannot be empty. Некоректне значення для поля "%1$s": не може бути пустим. Incorrect value used for proxy status "%1$s". Некоректне значення використано для статусу проксі "%1$s". Incorrect value used for PSK field. It should consist of an even number of hexadecimal characters. Некоректне значення використано для поля PSK. Воно має містити парну кількість шістнадцяткових символів. Incorrect "width" value for map "%1$s". Некоректне значення "width" для карти мережі "%1$s". Indonesian (id_ID) Індонезійська (id_ID) Info Інфо Information Інформація Information about a service. Returns integer with param as state, startup; string - with param as displayname, path, user; text - with param as description; Specifically for state: 0 - running, 1 - paused, 2 - start pending, 3 - pause pending, 4 - continue pending, 5 - stop pending, 6 - stopped, 7 - unknown, 255 - no such service; Specifically for startup: 0 - automatic, 1 - automatic delayed, 2 - manual, 3 - disabled, 4 - unknown Інформація про сервіс. Повертає ціле число для параметрів state, startup; рядок - для параметрів displayname, path, user; текст - для параметра description; Особливості для state: 0 - запущений, 1 - призупинений, 2 - запускається, 3 - призупиняється, 4 - відновлюється, 5 - зупиняється, 6 - зупинений, 7 - невідомо, 255 - сервіс відсутній; Особливості для startup: 0 - автоматичний, 1 - автоматичний з затримкою, 2 - вручну, 3 - відімкнений, 4 - невідомо Inherited and host macros Макроси вузла мережі та успадковані Inherited and template macros Успадковані та макроси із шаблонів In maintenance В періоді сервісу In progress В роботі Insert Вставити Insert expression Вставити вираз Install Встановлення Installation Інсталяція Installer name Ім'я інсталятора Interface Інтерфейс Interface is linked to item "%1$s" on "%2$s". Інтерфейс зв'язаний з елементом даних "%1$s" у "%2$s". Interface is used by items that require this type of the interface. Інтерфейс використовується елементами даних, яким потрібен цей тип інтерфейсу. Interface with DNS "%1$s" cannot have empty IP address. У інтерфейсу з DNS іменем "%1$s" не може бути пуста IP адреса. Interface with IP "%1$s" cannot have empty DNS name. У інтерфейсу з IP адресою "%1$s" не може бути пусте DNS ім'я. Interface with IP "%1$s" cannot have empty DNS name while having "Use DNS" property on "%2$s". У інтерфейсу з IP адресою "%1$s" не може бути пусте DNS ім'я, коли встановлено "Використовувати DNS" у "%2$s". internal внутрішній Internal Внутрішня Internal Внутрішній Internal Внутрішня Internal data storage period Період зберігання внутрішніх даних Internal error. Внутрішня помилка. Internal event and alert data storage period Період зберігання даних про внутрішні події і повідомлення Internal event and alert data storage period "%1$s". Період зберігання даних внутрішніх подій та повідомлень "%1$s". Internal JSON-RPC error. Внутрішня помилка JSON-RPC. Internet Explorer Internet Explorer Interval Інтервал Invalid action condition: %1$s. Неправильна умова дії: %1$s. invalid address range "%1$s" неправильний діапазон адрес "%1$s" Invalid audit data storage period: %1$s. Неправильний період зберігання даних аудиту: %1$s. Invalid auto-registration data storage period: %1$s. Неправильний період зберігання даних автореєстрації: %1$s. Invalid blinking on trigger status change: %1$s. Неправильне миготіння тригера при зміні статусу: %1$s. invalid byte sequence in UTF-8 помилкова послідовність байт в UTF-8 Invalid data storage period for services: %1$s. Помилковий період зберігання для послуг: %1$s. Invalid date. Помилкова дата. invalid delay некоректна затримка Invalid displaying of OK triggers: %1$s. Неправильне відображення тригерів в стані ОК: %1$s. Invalid email address "%1$s". Помилкова адреса email "%1$s". Invalid email address for media type with ID "%1$s". Помилкова адреса email у методу повідомлень з ID "%1$s". Invalid fifth parameter. Неправильний п'ятий параметр. Invalid first parameter. Неправильний перший параметр. Invalid fourth parameter. Неправильний четвертий параметр. Invalid history data storage period: %1$s. Неправильний період зберігання даних історії: %1$s. invalid history storage period некоректний період зберігання історії invalid host group name некоректне ім'я групи вузлів мережі Invalid hostid for macro "%1$s". Неправильний hostid для макросу "%1$s". invalid host name некоректне ім'я вузла мережі Invalid internal data storage period: %1$s. Неправильний період зберігання внутрішніх даних: %1$s. Invalid interval "%1$s". Неправильний інтервал "%1$s". Invalid IP address "%1$s". Неправильна IP адреса "%1$s". Invalid JSON. An error occurred on the server while parsing the JSON text. Неправильний JSON. На сервері виникла помилка при аналізі тексту JSON. Invalid key "%1$s": %2$s. Неправильний ключ "%1$s": %2$s. Invalid key "%1$s" for discovery rule "%2$s" on "%3$s": %4$s. Неправильний ключ "%1$s" для правила виявлення "%2$s" в "%3$s": %4$s. Invalid key "%1$s" for item "%2$s" on "%3$s": %4$s. Неправильний ключ "%1$s" для елемента даних "%2$s" в "%3$s": %4$s. Invalid key "%1$s" for item prototype "%2$s" on "%3$s": %4$s. Неправильний ключ "%1$s" для прототипу елементів даних "%2$s" в "%3$s": %4$s. Invalid macro "%1$s": %2$s. Неправильний макрос "%1$s": %2$s. Invalid method parameters. Неправильні параметри методу. Invalid network discovery data storage period: %1$s. Неправильний період зберігання даних про події виявлення в мережі: %1$s. Invalid number of parameters. Неправильна кількість параметрів. Invalid parameter "%1$s": %2$s. Неправильний параметр "%1$s": %2$s. Invalid params. Неправильні параметри. Invalid refresh of unsupported items: %1$s Неправильне оновлення непідтримуваних елементів даних: %1$s invalid regular expression помилковий регулярний вираз Invalid Request. Неправильний запит. Invalid response code "%1$s". Неправильний код відповіді "%1$s". Invalid second parameter. Неправильний другий параметр. Invalid tag "%1$s": %2$s. Неправильний тег "%1$s": %2$s. Invalid third parameter. Неправильний третій параметр. Invalid time period. Неправильний період часу. Invalid trends data storage period: %1$s. Неправильний період зберігання даних трендів: %1$s. invalid trend storage period некоректний період зберігання трендів Invalid trigger data storage period: %1$s. Неправильний період зберігання даних тригерів: %1$s. Invalid user sessions data storage period: %1$s. Неправильний період зберігання даних сесій користувачів: %1$s. Invalid view name given "%s". Allowed chars: "a-z" and ".". Отримано помилкове ім'я вигляду "%s". Дозволені символи : "a-z" та ".". Inventory Інвентаризація Inventory disabled for host "%1$s". Інвентарні данні дезактивовано для вузла мережі "%1$s". Inventory field Поле інвентарних даних Inventory mode Режим інвентарних даних IP IP IP address IP-адрес IP and DNS cannot be empty for host interface. IP та DNS не можуть бути пустими для інтерфейсу вузла мережі. IPMI IPMI IPMI agent IPMI агент IPMI authentication algorithm Алгоритм аутентифікації IPMI IPMI interfaces Інтерфейси IPMI IPMI password Пароль IPMI IPMI privilege level Рівень привілеїв IPMI IPMI scripts can be executed only by server. IPMI скрипти можуть бути виконані тільки на сервері. IPMI sensor IPMI датчик IPMI username Ім'я користувача IPMI IP range Діапазон IP адрес IP range "%1$s" exceeds "%2$s" address limit Діапазон IP "%1$s" перевищує ліміт адрес "%2$s" iregexp() - Regular expression V matching last value in period T (non case-sensitive; 1 - match, 0 - no match) iregexp() - Регулярний вираз V відповідає останньому значенню за період Т (не залежить від регістру; 1 - відповідає, 0 - не відповідає) is greater than or equals більше ніж чи дорівнює is less than or equals менше ніж чи дорівнює is not enclosed in {} or is malformed не обгорнуте в {} або неправильно сформоване Is online? В системі? Issue Проблема Issuer Видавець Italian (it_IT) Італійська (it_IT) item елемент даних Item Елемент даних Item "%1$s:%2$s" has invalid port: "%3$s". Елемент даних "%1$s:%2$s" має неправильний порт: "%3$s". Item "%1$s" already exists on "%2$s". Елемент даних "%1$s" вже існує в "%2$s". Item "%1$s" already exists on "%2$s", inherited from another template. Елемент даних "%1$s" вже існує в "%2$s", успадковано з іншого шаблону. Item "%1$s" cannot populate a missing host inventory field number "%2$d". Choices are: from 0 (do not populate) to %3$d. Елемент даних "%1$s" не може заповнювати відсутнє поле під номером "%2$d" інвентарних даних вузла мережі. Оберіть з: від 0 (не заповнювати) до %3$d. Item "%1$s" does not exist on template "%2$s". Елемент даних "%1$s" не існує в шаблоні "%2$s". Item "%1$s" does not exist or you have no access to this item Елемент даних "%1$s" не існує або у вас немає прав доступу до нього Item "%1$s" has master item and cannot be copied. Елемент даних "%1$s" має мастер-елемент та не може бути скопійовано. Item "%1$s" on "%2$s": application "%3$s" does not exist. Елемент даних "%1$s" в "%2$s": група елементів даних "%3$s" не існує. Item added Елемент додано Item copied Елементи даних скопійовано Item copied Елементи даних скопійовано Item copied Елемент даних скопійовано Item count Кількість елементів даних Item deleted Елемент даних видалено Item disabled Елемент даних дезактивовано Item disabled Елементи даних дезактивовано Item disabled Елементи даних дезактивовано Item enabled Елементи даних активовано Item enabled Елемент даних активовано Item enabled Елементи даних активовано Item in "not supported" state Елемент даних в стані "не підтримується" item is disabled елемент даних дезактивовано Item not selected Елемент даних не вибрано item pattern маска елементу даних Item pre-processing is missing parameters: %1$s Відсутні параметри в попередній обробці елемента даних: %1$s Item pre-processing is not allowed for discovery rules. Попередня обробка елементів даних не дозволена для правил виявлення. Item prototype Прототип елемента даних Item prototype "%1$s" already exists on "%2$s". Прототип елемента даних "%1$s" вже існує в "%2$s". Item prototype "%1$s" already exists on "%2$s", inherited from another template. Прототип елемента даних "%1$s" вже існує в "%2$s", успадкований з іншого шаблону. Item prototype "%1$s" already exists on "%2$s", linked to another rule. Прототип елемента даних "%1$s" вже існує у "%2$s", приєднаний до іншого правила. Item prototype added Прототип елемента даних додано Item prototype deleted Прототип елемента даних видалено Item prototypes Прототипи елементів даних Item prototypes deleted Прототипи елементів даних видалено Item prototype updated Прототипи елементів даних оновлено Item prototype updated Прототип елемента даних оновлено Item prototype updated Прототипи елементів даних оновлено Item prototype with ID "%1$s" is not available. Прототип елементів даних з ID "%1$s" недоступний. Items Елементи даних Items deleted Елементи даних видалено Items list Список елементів Items location Розміщення елементів даних Items updated Елементи оновлено Item updated Елемент даних оновлено Item uses host interface from non-parent host. Елемент даних використовує інтерфейс не від батьківського вузла мережі. Item uses incorrect interface type. Елемент даних використовує некоректний тип інтерфейсу. Item values Значення елемента даних Item will not be refreshed. Please enter a correct update interval. Елемент не було оновлено. Будь ласка введіть коректний інтервал оновлення. Item will not be refreshed. Specified update interval requires having at least one either flexible or scheduling interval. Елемент даних не може бути оновлено. Вказаний інтервал оновлення повинен мати принаймні один гнучкий або запланований інтервал. Item will not be refreshed. Update interval should be between 1s and 1d. Also Scheduled/Flexible intervals can be used. Елемент даних не буде оновлено. Інтервал оновлення повинен бути між 1s та 1d. Також може використовуватись запланований/гнучкий інтервал. Item with ID "%1$s" is not available. Елемент даних з ID "%1$s" недоступний. Item with key "%1$s" already exists on "%2$s". Елемент даних з ключем "%1$s" вже існує в "%2$s". Item with key "%1$s" already exists on "%2$s" as a discovery rule. Елемент даних з ключем "%1$s" вже існує в "%2$s" як правило виявлення. Item with key "%1$s" already exists on "%2$s" as an item. Елемент даних з ключем "%1$s" вже існує в "%2$s" як елемент даних. Item with key "%1$s" already exists on "%2$s" as an item created from item prototype. Елемент даних з ключем "%1$s" вже існує в "%2$s" як елемент даних створений з прототипу елемента даних. Item with key "%1$s" already exists on "%2$s" as an item prototype. Елемент даних з ключем "%1$s" вже існує в "%2$s" як прототип елемента даних. Item with key "%1$s" already exists on "%2$s" as unknown item element. Елемент даних з ключем "%1$s" вже існує в "%2$s" як невідомий елемент даних. It is not possible to filter by user password. Неможливо фільтрувати по паролю користувача. It is not possible to search by user password. Неможливо виконувати пошук по паролю користувача. Jabber Jabber Jabber identifier Ідентифікатор Jabber Jan Січ January Січень Japanese (ja_JP) Японська (ja_JP) JMX JMX JMX agent JMX агент JMX endpoint JMX endpoint JMX interfaces Інтерфейси JMX JSON data JSON дані JSON Path Шлях JSON JSON string is expected очікувався JSON рядок Jul Лип July Липень Jun Чер June Червень Keep lost resources period Період зберігання втрачених ресурсів Key Ключ Key "%1$s" does not match <grpmax|grpmin|grpsum|grpavg>["Host group(s)", "Item key", "<last|min|max|avg|sum|count>", "parameter"]. Ключ "%1$s" не співпадає з <grpmax|grpmin|grpsum|grpavg>["Група вузлів мережі", "Ключ елемента даних", "<last|min|max|avg|sum|count>", "параметр"]. key is empty ключ пустий Key passphrase Фраза-пароль ключа Keyword Ключове слово Kiosk mode Режим кіоску Korean (ko_KR) Корейська (ko_KR) Label Ярлик Label location Розміщення ярлика Language Мова last ост. last ост. Last Остання Last %1$d day Останній %1$d день Last %1$d day Останні %1$d дні Last %1$d day Останні %1$d днів Last %1$d hour Останні %1$d годин Last %1$d hour Останні %1$d години Last %1$d hour Остання %1$d година Last %1$d minute Остання %1$d хвилина Last %1$d minute Останні %1$d хвилин Last %1$d minute Останні %1$d хвилини Last %1$d month Останній %1$d місяць Last %1$d month Останні %1$d місяці Last %1$d month Останні %1$d місяців Last %1$d second Останні %1$d секунд Last %1$d second Остання %1$d секунда Last %1$d second Останні %1$d секунди Last %1$d year Останні %1$d роки Last %1$d year Останній %1$d рік Last %1$d year Останні %1$d років Last 24 hours Останні 24 години Last 30 days Останні 30 днів Last 365 days Останні 365 днів Last 7 days Останні 7 днів Last change Остання зміна Last change (descending) Остання зміна (в порядку спадання) Last check Остання перевірка Last hour graph Графік за останню годину last() - Last (most recent) T value last() - Останнє (найбільш недавнє) значення Т Last month graph Графік за останній місяць Last of За останні Last seen (age) Востаннє помітний (вік) Last value Останнє значення Last week graph Графік за останній тиждень Latest data Останні дані Latest values Останні значення Latvian (lv_LV) Латвійська (lv_LV) LDAP LDAP LDAP authentication LDAP аутентифікація LDAP host Хост LDAP LDAP is not configured LDAP не налаштовано LDAP login successful Вдалий вхід через LDAP LDAP settings Налаштування LDAP left зліва Left З лівого боку Left trim Обрізати зліва Left Y Вісь Y зліва Legend Легенда Limit for search and filter results Ліміт елементів в пошуку/фільтрі Line Лінія Line colour Колір лінії Line type Тип лінії Line width Товщина лінії Link Лінк Linked map Пов'язана карта Linked templates Приєднані шаблони Linked to Приєднаний до Link indicators Індикатори лінка Link new templates Приєднати нові шаблони Links Зв'язки Link selementid1 field is pointing to a nonexistent map selement ID "%1$s" for map "%2$s". Поле лінку selementid1 вказує на не існуючий selement ID "%1$s" для карти мережі "%2$s". Link selementid2 field is pointing to a nonexistent map selement ID "%1$s" for map "%2$s". Поле лінку selementid2 вказує на не існуючий selement ID "%1$s" для карти мережі "%2$s". Link templates Приєднати шаблони Link to template Приєднати до шаблону Link to templates Приєднати до шаблонів Listing of installed packages. Returns text Список встановлених пакетів. Повертає текст Listing of MAC addresses. Returns string Список MAC адрес. Повертає рядок Listing of PCI or USB devices. Returns text Список PCI та USB пристроїв. Повертає текст Listing of services. Returns 0 - if empty; text - list of services separated by a newline Список сервісів. Повертає 0 - якщо список пустий; текст - список сервісів розділених переводом рядка List is empty Список пустий list of characters список символів List of user group shares Список груп користувачів спільного доступу List of user shares Список користувачів спільного доступу Lithuanian (lt_LT) Литовський (lt_LT) Loading time of full web page (in seconds). Returns float Повний час завантаження веб сторінки (в секундах). Повертає дробове число Local Локальний Local time Локальний (дійсний) час Location Місцезнаходження Location latitude Розміщення (широта) Location longitude Розміщення (довгота) Log Лог (багато полів) logeventid() - Event ID of last log entry matching regular expression T (1 - match, 0 - no match) logeventid() - ID події останнього запису логу відповідає регулярному виразу Т (1 - відповідає, 0 - не відповідає) Log file monitoring. Returns log Моніторинг файлів журналів. Повертає лог Log file monitoring with log rotation support. Returns log Моніторинг файлів журналів з підтримкою ротації. Повертає лог Login Вхід в систему Login failed. Невдала спроба входу. Login name or password is incorrect. Некоректне ім'я користувача або пароль. Logout Вихід із системи logseverity() - Log severity of the last log entry logseverity() - Важливість останнього запису логу logsource() - Log source of the last log entry matching parameter T (1 - match, 0 - no match) logsource() - Джерело в останньому записі логу відповідає параметру Т (1 - відповідає, 0 - не відповідає) Log time format Формат часу в журналі Log unmatched SNMP traps Записувати не співпадаючі SNMP трапи Lost Втрачено low-level discovery rule правило низькорівневого виявлення Low-level discovery rule in "not supported" state Правило низькорівневого виявлення в стані "не підтримується" m м m хв M M M Пн MAC address A MAC адреса A MAC address B MAC адреса B Macro Макро Macro "%1$s" already exists. Макрос "%1$s" вже існує. Macro "%1$s" already exists on "%2$s". Макрос "%1$s" вже існує в "%2$s". Macro "%1$s" is not unique. Макрос "%1$s" не унікальний. macro is empty макрос пустий macro(s) макрос(и) Macros Макроси Macros updated Макроси оновлено Macro with hostmacroid "%1$s" does not exist. Макросу з hostmacroid "%1$s" не існує. Main filter Головний фільтр Main navigation Головна навігація Maintenance Сервіс MAINTENANCE В СТАНІ СЕРВІСУ Maintenance: %1$s Обслуговування: %1$s Maintenance "%1$s" already exists. Сервіс "%1$s" вже існує. Maintenance "Active since" value cannot be bigger than "Active till". Значення "Активно з" в сервісі не може бути більше ніж "Активно до". Maintenance added Період сервісу додано Maintenance deleted Сервіс видалено Maintenance period Період сервісу Maintenance period length Тривалість періоду сервісу Maintenance periods Періоди сервісу Maintenance type Тип сервісу Maintenance updated Сервіс оновлено Maintenance with data collection Сервіс зі збором даних Maintenance without data collection Сервіс без збору даних Mandatory parameter is missing. Пропущено обов'язковий параметр. <manual> <вручну> Manual Вручну Manually closed Закритий вручну map карта мережі Map Карта мережі Map "%1$s" already exists. Карта мережі "%1$s" вже існує. Map "%1$s" is public and read-only sharing is disallowed. Карта мережі "%1$s" є публічною, тому спільний доступ тільки на читання не дозволений. Map element Елемент карти мережі Map element is missing parameters: %1$s Відсутні параметри в елемента карти мережі: %1$s Map element label location Розміщення підпису до елементу карти мережі Map element label type Тип підпису до елементу карти мережі Map label type Тип позначки карти мережі Map name cannot be empty. Ім'я карти мережі не може бути пустим. Map navigation tree Дерево навігації карт мереж Map owner cannot be empty. Власник карти мережі не може бути пустим. Mapped to Перетворюється на Mappings Призначення Maps Карти мереж Map shape Фігура карти мережі Map update failed. Оновлення карти мережі неуспішне. Map with ID "%1$s" is not available. Карта мережі з ID "%1$s" недоступна. Mar Бер March Березень Mark elements on trigger status change Відмічати елементи при зміні стану тригера Mark others Не помічати тільки відібрані Mark selected Помітити тільки відібрані Mask Маска Mass update Масове оновлення Mass update elements Масове оновлення елементів Mass update shapes Масове оновлення фігур Master item Головний елемент даних matches співпадає max макс. Max Макс Max columns Макс стовпчиків Max count of elements to show inside table cell Макс. кількість елементів для відображення в комірці таблиці Max count of elements to show inside table cell "%1$s". Макс. кількість елементів для відображення у комірці таблиці "%1$s". maximum dependent items count reached досягнуто максимальну кількість залежних елементів даних maximum number of dependency levels reached досягнуто максимальну кількість рівнів залежності Maximum number of opened files supported by OS. Returns integer Максимальна кількість відкритих файлів яку підтримує ОС. Повертає ціле число Maximum number of processes supported by OS. Returns integer Максимальна кількість процесів яку підтримує ОС. Повертає ціле число Maximum time period to display is %1$s day. Максимальний період часу відображення %1$s днів. Maximum time period to display is %1$s day. Максимальний період часу відображення %1$s дні. Maximum time period to display is %1$s day. Максимальний період часу відображення %1$s день. Maximum total length of email address exceeded for media type with ID "%1$s". Перевищено максимальну довжину email адреси у методу повідомлень з ID "%1$s". max() - Maximum value for period T max() - Максимальне значення за період Т May Тра May Травень m-d m-d MD2 MD2 MD5 MD5 MD5 checksum of file. Returns character string (MD5 hash of the file) MD5 контрольна сума файлу. Повертає рядок символів (MD5 хеш файлу) m-d H:i m-d H:i Media Метод повідомлення Media type Тип засобу передачі Media type "%1$s" already exists. Метод повідомлень "%1$s" вже існує. Media type added Метод повідомлень додано Media type deleted Методи повідомлень видалено Media type deleted Методи повідомлень видалено Media type deleted Метод повідомлень видалено Media type disabled Методи повідомлень дезактивовано Media type disabled Метод повідомлень дезактивовано Media type disabled Методи повідомлень дезактивовано Media type enabled Методи повідомлень активовано Media type enabled Методи повідомлень активовано Media type enabled Метод повідомлень активовано Media type is missing parameters: %1$s В методі повідомлень відсутні параметри: %1$s Media types Методи повідомлень Media types used by action "%s". Методи повідомлень використовуються у дії "%s". Media type updated Метод повідомлень оновлено Media type with ID "%1$s" is not available. Метод повідомлень з ID "%1$s" недоступний. Members Члени групи Memory limit: %1$s Ліміт пам'яті: %1$s Memory size in bytes or in percentage from total. Returns integer for bytes; float for percentage Розмір пам'яті в байтах або у відсотках від загальної. Повертає ціле число в байтах; дробове для відсотків Memory used by process in bytes. Returns integer Пам'ять яка використовується процесом в байтах. Повертає ціле число Message Повідомлення Message/Command Повідомлення/Команда Messages Повідомлення Message text limit Обреження тексту повідомлення Message timeout Таймаут повідомлення Messaging Повідомлення Method not found. Метод не знайдено. Middle Посередині min мін. Min Мін minimum length is %1$s characters мінімальна довжина %1$s символів Minimum required limit on execution time of PHP scripts is %s (configuration option "max_execution_time"). Мінімально необхідний ліміт часу виконання в PHP - %s (параметр конфігурації "max_execution_time"). Minimum required limit on input parse time for PHP scripts is %s (configuration option "max_input_time"). Мінімально необхідний ліміт часу аналізу скриптів в PHP - %s (параметр конфігурації "max_input_time"). Minimum required PHP memory limit is %s (configuration option "memory_limit"). Мінімально необхідний ліміт пам'яті в PHP - %s (параметр конфігурації "memory_limit"). Minimum required PHP upload filesize is %s (configuration option "upload_max_filesize"). Мінімально необхідний розмір файлу, який завантажується в PHP - %s (параметр конфігурації "upload_max_filesize"). Minimum required PHP version is %s. Мінімально необхідна версія PHP це %s. Minimum required size of PHP post is %s (configuration option "post_max_size"). Мінімально необхідний розмір PHP post - %s (параметр конфігурації "post_max_size"). Minimum severity Мінімальна важливість Minimum time period to display is %1$s minute. Мінімальний період часу для відображеня %1$s хвилина. Minimum time period to display is %1$s minute. Мінімальний період часу для відображеня %1$s хвилини. Minimum time period to display is %1$s minute. Мінімальний період часу для відображеня %1$s хвилин. min() - Minimum value for period T max() - Мінімальне значення за період Т Minutes Хвилин Missing data Відсутні дані Missing "gitemid" field for item. Відсутнє поле "gitemid" для елемента даних. Missing "itemid" field for item. Відсутнє поле "itemid" для елемента даних. Missing items for graph "%1$s". Відсутні елементи даних для графіку "%1$s". Missing items for graph prototype "%1$s". Відсутні елементи даних для прототипу графіка "%1$s". Missing key "%1$s" for host "%2$s". Відсутній ключ "%1$s" для вузла мережі "%2$s". Missing "name" field for application prototype in item prototype "%1$s". Відсутнє поле "name" для прототипу групи елементів даних в прототипі елементів даних "%1$s". Missing "name" field for graph. Відсутнє поле "name" для графіку. Missing "name" field for graph prototype. Відсутнє поле "name" для прототипу графіка. mm мм Mode Режим Model Модель Mon Пн Monday Понеділок Monitored by Спостереження через Monitored by proxy Спостерігається через проксі Monitored host Вузел мережі під спостереженням Monitoring Моніторинг Monospace Моноширинний Month Місяць Monthly Щомісяця More matches found... Знайдено більше співпадінь... More than %1$d matches for %2$s found Знайдено більше ніж %1$d відповідностей з %2$s More than 10 minutes Більше 10 хвилин More than one graph with name "%1$s" within host. Більше ніж один графік з ім'ям "%1$s" у вузла мережі. Mozilla Firefox Mozilla Firefox ms мс Multiple Багатократно Multiple PROBLEM events Багатократні події ПРОБЛЕМА must be a valid LDAP user має бути дійсним користувачем LDAP must be between "%1$s" and "%2$s" має бути між "%1$s" та "%2$s" must contain at least one low-level discovery macro має містити принаймні один макрос низькорівневого виявлення Mute Вимкнути звук name назва Name Ім'я Name Ім'я Name of the form field should not exceed 255 characters. Ім'я поля форми не має перевищувати 255 символів. Network discovery data storage period Період зберігання даних мережевого оновлення Network discovery event and alert data storage period Період зберігання подій та повідомлень мережевого виявлення Network discovery event and alert data storage period "%1$s". Період зберігання подій та повідомлень мережевого виявлення "%1$s". Network interface list (includes interface type, status, IPv4 address, description). Returns text Список мережевих інтерфейсів (містить тип, стан, IPv4 адресу, опис). Повертає текст Network map added Карту мережі додано Network map deleted Карту мережі видалено Network maps Карти мереж Network map updated Карту мережі оновлено Never Ніколи new новий new новий New Новий New application Нова група елементів даних New application prototype Новий прототип групи елементів даних New condition Нова умова New dashboard Нова панель New element Новий елемент New event host group Група вузлів нової події New event tag value Значення тегу нової події New host group Нова група вузлів мережі New operation Нова операція New regular expression Новий регулярний вираз New service time Новий період послуги New triggers Нові тригери Next step Наступний крок NNTP NNTP No Ні No "%1$s" given for correlation. "%1$s" не задано для кореляції. No "%1$s" given for correlation "%2$s". "%1$s" не задано для кореляції "%2$s". No "%1$s" given for graph. Не вказано "%1$s" для графіку. No "%1$s" given for graph prototype. Не вказано "%1$s" для прототипу графіків. No "%1$s" given for map. Не вказано "%1$s" для карти мережі. No "%1$s" given for media type. Не вказано "%1$s" для методу повідомлень. No "%1$s" given for screen. Не вказано "%1$s" для комплексного екрану. No "%1$s" given for template screen. Не вказано "%1$s" для шаблонного екрану. No "%2$s" given for a filter condition of action "%1$s". Не вказано "%2$s" для умови фільтру в дії "%1$s". No "%2$s" given for a filter condition of discovery rule "%1$s". Не вказано "%2$s" для умови фільтру в правилі виявлення "%1$s". No "%2$s" given for the filter of action "%1$s". Не вказано "%2$s" для фільтру в дії "%1$s". No "%2$s" given for the filter of discovery rule "%1$s". Не вказано "%2$s" для фільтру в правилі виявлення "%1$s". No agent interfaces found. Інтерфейсів агента не знайдено. No applications found. Групи елементів даних не знайдено. No authentication type specified for action operation command "%s". Не вказано тип аутентифікації для команди "%s" в операції дії. No authentication user name specified. Для аутентифікації не вказано ім'я користувача. No authentication user name specified for action operation command "%s". Не вказано імені користувача аутентифікації для команди "%s" в операції дії. No command specified for action operation. Не вказано команди в операції дії. No command type specified for action operation. Не вказано тип команди в операції дії. No conditions defined. Умов не визначено. No condition type given for correlation "%1$s". Тип умови не задано для кореляції "%1$s". no data немає даних No data Немає даних No data. Данні відсутні. No data collection Без збору даних No data found. Дані не знайдено. nodata() - No data received during period of time T (1 - true, 0 - false) nodata() - Відсутність отриманих даних за період часу Т (1 - істина, 0 - фальш) No default interface for "%1$s" type on "%2$s". Відсутній інтерфейс по замовчуванню "%1$s" типу у вузла мережі "%2$s". No details Подробиці відсутні No discovery rule IDs given. ID правил виявлення не вказано. No encryption Без шифрування No execution target specified for action operation command "%s". Не вказано ціль виконання для команди "%s" в операції дії. No file was uploaded. Файл не було завантажено. No graph ID provided for screen element. Для елемента комплексного екрану не вказано ID графіка. No graph item with graphid "%s". Немає елемента графіку з graphid "%s". No graph prototype ID provided for screen element. Не вказано ID прототипу графіка для елемента комплексного екрану. No graphs added. Графіків не додано. No host given for macro "%1$s". Не вказано вузел мережі для макросу "%1$s". No host group ID provided for screen element. Не вказано ID групи вузлів мережі для елемента комплексного екрану. No host groups with groupid "%s". Немає груп вузлів мережі з groupid "%s". No host IDs given. Не вказано ID вузлів мережі. No host selected. Не вибрано вузел мережі. No host with hostid "%s". Немає вузла мережі з hostid "%s". No icon for map element "%s". Немає іконки для елемента карти мережі "%s". No image Немає картинки No interface found Інтерфейсу не знайдено No interface found. Інтерфейсу не знайдено. No interface provided for proxy "%s". Не вказано інтерфейс для проксі "%s". No interfaces for host "%s". Немає інтерфейсів для вузла мережі "%s". No inventory mode specified for action operation. Не вказано режим інвентарних даних для операції дії. No IPMI interfaces found. Інтерфейсів IPMI не знайдено. No item ID provided for screen element. Не вказано ID елемента даних для елемента комплексного екрану. No item prototype ID provided for screen element. Не вказано ID прототипу елемента даних для елемента комплексного екрану. No items defined. Елементів даних не визначено. No item with itemid="%1$s". Немає елемента даних з itemid="%1$s". No JMX interfaces found. Інтерфейсів JMX не знайдено. No macros found. Макроси не знайдено. No map ID provided for screen element. Не вказано ID карти мережі для елемента комплексного екрану. No maps added. Карти мереж не додано. No matches found Відповідностей не знайдено Non-boolean flags are deprecated. Не логічні атрибути більше не використовуються. none немає None Немає nonempty key and value pair expected очікувались не пуста пара ключа та значення No operation type given for correlation "%1$s". Тип операції не задано для кореляції "%1$s". No permissions for system access. Немає прав доступу до системи. No permissions to referred object or it does not exist! Немає прав доступу до запитуваного об'єкту або він не існує! No private key file specified. Файл приватного ключа не вказано. No private key file specified for action operation command "%s". Не вказано файл приватного ключа для команди "%s" в операції дії. (no proxy) (без проксі) No proxy Без проксі No public key file specified. Файл публічного ключа не вказано. No public key file specified for action operation command "%s". Не вказано файл публічного ключа для команди "%s" в операції дії. No recipients for action operation message. Немає отримувачів повідомлення в операції дії. No refresh Не оновлювати Normal Звичайний Normal view Звичайний вигляд Norwegian (nb_NO) Норвежський (nb_NO) No screen ID provided for screen element. Не вказано ID комплексного екрану для елемента комплексного екрану. No screens added. Комплексні екрани не додано. No script specified for action operation command. Не вказано скрипт для команди в операції дії. No SNMP community specified. Не вказано SNMP community. No SNMP interfaces found. Інтерфейсів SNMP не знайдено. No SNMP OID specified. Не вказано SNMP OID. Not Ack Не підтверджено Not allowed to set password for user "guest". Забороняється встановлювати пароль для користувача "гість". Not all templates are linked to "%s". Не всі шаблони приєднані до "%s". No target selected Ціль не обрано No target selected. Ціль не обрано. Not authorised. Не авторизовано. Not available Недоступний Not classified Не класифіковано Note Примітка Notes Примітки Nothing Нічого Nothing to do. Нічого робити. Notification report Звіт про повідомлення Notifications Повідомлення Notify all involved Повідомити всіх залучених not in не в No triggers defined. Тригерів не визначено. No trigger with triggerid "%1$s". Немає тригера з triggerid "%1$s". not selected не обрано Not supported Не підтримується Not Templated items Немає елементів даних з шаблону No URL provided for screen element. Для елемента комплексного екрану не вказано URL. Nov Лис November Листопад now() - Number of seconds since the Epoch now() - Кількість секунд починаючи з Epoch NTLM NTLM number число Number of CPUs. Returns integer Кількість CPU. Повертає ціле число Number of enabled items on the host. Кількість активованих елементів даних у вузла мережі. Number of hosts (enabled/disabled/templates) Кількість вузлів мережі (активовані/дезактивовані/шаблони) Number of items (enabled/disabled/not supported) Кількість елементів даних (активовані/дезактивовані/не підтримуються) Number of items in proxy history that are not yet sent to the server Кількість елементів даних в історії проксі, які ще не були відправлені на сервер Number of items in the queue which are delayed by from to to seconds, inclusive. Кількість елементів даних в черзі, які затримується від і до секунд, включно. Number of items in Zabbix database. Кількість елементів даних в базі даних Zabbix. Number of monitored hosts Кількість вузлів мережі під спостереженням Number of out-of-window collisions. Returns integer Кількість колізій out-of-window. Повертає ціле число Number of problems Кількість проблем Number of problems and expand most critical one Кількість проблем та розкривати найбільш критичну Number of processor cores on VMware hypervisor, <url> - VMware service URL, <uuid> - VMware hypervisor host name Кількість ядер процесора у гіпервізора VMware, <url> - URL сервісу VMware, <uuid> - ім'я хоста гіпервізора VMware Number of processors on VMware virtual machine, <url> - VMware service URL, <uuid> - VMware virtual machine host name Кількість процесорів віртуальної машини VMware, <url> - URL сервіс VMware, <uuid> - ім'я хоста віртуальної машини VMware Number of processor threads on VMware hypervisor, <url> - VMware service URL, <uuid> - VMware hypervisor host name Кількість потоків процесора у гіпервізора VMware, <url> - URL сервісу VMware, <uuid> - ім'я хоста гіпервізора VMware Number of rows Кількість рядків Number of slides Кількість слайдів Number of status changes Кількість змін стану Number of steps Кількість кроків Number of triggers (enabled/disabled [problem/ok]) Кількість тригерів (активовані/дезактивовані [проблема/ок]) Number of triggers in Zabbix database. Кількість тригерів в базі даних Zabbix. Number of unsupported items in Zabbix database. Кількість елементів даних в базі даних Zabbix, які не підтримуються. Number of unsupported items on the host. Кількість елементів даних у вузла мережі, які не підтримуються. Number of users logged in. Returns integer Кількість користувачів в системі. Повертає ціле число Number of users (online) Кількість користувачів (підключених в даний момент) Number of values stored in table HISTORY. Кількість значень збережених в таблиці HISTORY. Number of values stored in table HISTORY_LOG. Кількість значень збережених в таблиці HISTORY_LOG. Number of values stored in table HISTORY_STR. Кількість значень збережених в таблиці HISTORY_STR. Number of values stored in table HISTORY_TEXT. Кількість значень збережених в таблиці HISTORY_TEXT. Number of values stored in table HISTORY_UINT. Кількість значень збережених в таблиці HISTORY_UINT. Number of values stored in table TRENDS. Кількість значень збережених в таблиці TRENDS. Number of values stored in table TRENDS_UINT. Кількість значений збережених в таблиці TRENDS_UINT. Number of virtual machines on VMware hypervisor, <url> - VMware service URL, <uuid> - VMware hypervisor host name Кількість віртуальних машин на гіпервізорі VMware, <url> - URL служби VMware, <uuid> - ім'я хоста VMware гіпервізора Number or percentage of inodes. Returns integer for number; float for percentage Кількість inode у відсотках. Повертає ціле число для кількості; дробове - для відсотків Numeral systems Числові системи Numeric (float) Числовий (дробове) Numeric (integer) Числовий (ціле) Numeric (unsigned) Числовий (ціле додатне) Oct Жов Octal to decimal Вісімкове в десяткове October Жовтень OEM OEM of із off вимк Off Вимкн Ok Ок OK OK OK event closes подія ОК закриває OK event generation генерація події OK Old event tag value Значення тега старої події on в On Увімк Once Один раз One Одна One of the objects is left without a host group. Один із об'єктів залишився без групи вузлів мережі. One-time downtime Однократна недоступність One time only Одноразово Only administrators can set map owner. Тільки адміністратори можуть задавати власника карти мережі. Only administrators can set screen owner. Тільки адміністратори можуть задавати власника комплексного екрану. Only administrators can set slide show owner. Тільки адміністратори можуть задавати власника слайд шоу. Only items assigned to enabled hosts are counted Підраховуються елементи даних тільки у вузлів мережі під спостереженням Only one change step is allowed. Дозволено тільки один крок зміни. Only one check can be unique. Тільки одна перевірка може бути унікальною. Only selected problem Тільки вибрані проблеми Only selected problem Тільки вибрана проблема Only selected problem Тільки вибрані проблеми Only super admins can create correlations. Тільки супер адміністратори можуть створювати кореляції. (Only super admins can create groups) (Тільки супер адміністратори можуть створювати групи) Only Super Admins can create host groups. Тільки Супер-Адміністратори можуть створювати групи вузлів мережі. Only Super Admins can create media types. Тільки Супер-Адміністратори можуть створювати методи повідомлень. Only Super Admins can create user groups. Тільки Супер Адміністратори можуть створювати групи користувачів. Only super admins can create value maps. Тільки супер адміністратори можуть створювати перетворення значень. Only Super Admins can delete media types. Тільки Супер-Адміністратори можуть видаляти методи повідомлень. Only Super Admins can delete user groups. Тільки Супер-Адміністратори можуть видаляти групи користувачів. Only super admins can delete value maps. Тільки супер адміністратори можуть видаляти перетворення значень. Only Super Admins can edit media types. Тільки Супер-Адміністратори можуть редагувати методи повідомлень. Only super admins can set dashboard owner. Тільки супер адмін може встановлювати власника панелі. Only super admins can update correlations. Тільки супер адміністратори можуть оновлювати кореляції. Only Super Admins can update user groups. Тільки Супер Адміністратори можуть оновлювати групи користувачів. Only super admins can update value maps. Тільки супер адміністратори можуть оновлювати перетворення значень. Only the last 20%% of the indicator is displayed. Індикатор відображує тільки останні 20%%. Only triggers assigned to enabled hosts and depending on enabled items are counted Підраховуються тригери тільки у вузлів мережі під спостереженням та які залежать від активних елементів даних Only Zabbix agent, SNMPv1, SNMPv2 and SNMPv3 checks can be made unique. Тільки Zabbix агент, SNMPv1, SNMPv2 та SNMPv3 перевірки можуть бути зроблені унікальними. On status change triggers blink for Мигання тригерів при зміні стану протягом OOB IP address OOB IP адреса OOB router OOB роутер OOB subnet mask OOB маска підмережі Opera Opera Operating system information. Returns string Інформація про операційну систему. Повертає рядок Operation cannot be performed due to unauthorized request. Операцію не може бути виконано через несанкціонований запит. Operation condition Умова операції Operation details Деталі операції Operation has no group to operate. Операція не має групи для функціонування. Operation has no template to operate. Операція не має шаблону для функціонування. Operations Операції Operation "%s" already exists. Операція "%s" вже існує. Operation type Тип операції Operator Оператор Options Опції Or Або OR АБО Original Оригінальне OS ОС OS (Full details) ОС (Повні деталі) OS (Short) ОС (Короткий опис) other інший Other Інші Other configuration parameters Інші параметри налаштувань Other parameters Інші параметри Others Інші Outgoing traffic statistics on network interface. Returns integer Статистика вихідного трафіку на мережевому інтерфейсі. Повертає ціле число output вивід Overridden by Перевизначено в Override item history period Перевизначити період зберігання історії елементів даних Override item trend period Перевизначити період зберігання трендів елементів даних Overrides Заміщення Overview Огляд Overview by proxy Огляд по проксі Owner Власник Page received incorrect data Сторінка отримала некоректні дані Parameter Параметр Parameter "%1$s" is deprecated. Параметр "%1$s" застарів. Parameters Параметри Parent discovery rules Батьківські правила виявлення Parent graphs Батьківські графіки Parent items Батьківські елементи даних Parent service Батьківська ІТ послуга Parent triggers Батьківські тригери Parent web scenarios Батьківські веб сценарії Parse Аналіз Parse error Помилка розбору Parse SQL error [%1$s] in [%2$s]. Помилка аналізу SQL [%1$s] у [%2$s]. Passive Пасивний Password Пароль Password is not mandatory for non internal authentication type. Пароль не обов'язковий для не внутрішнього типу аутентифікації. Password (once again) Пароль (підтвердження) Password should not be empty Пароль не може бути пустим Paste Вставити Paste without external links Вставити без зовнішніх зв'язків path шлях pattern шаблон Pause operations for suppressed problems Призупиняти операції для подавлених проблем Peak memory usage: %1$s Пікове використання пам'яті: %1$s Percentage Відсотки Percentile line (left) Процентна лінія (зліва) Percentile line (right) Процентна лінія (справа) percentile() - Percentile P of a period T percentile() - Процентне P за період Т Performs a DNS query. Returns character string with the required type of information Виконує DNS запит. Повертає рядок символів з необхідним типом інформації Period Період Periods Періоди Period type Тип періоду Permissions Права доступу Permissions can be assigned for user groups only. Права доступу можуть бути призначені тільки групам користувачів. Persian (fa_IR) Персидська (fa_IR) PHP bcmath PHP bcmath PHP bcmath extension missing (PHP configuration parameter --enable-bcmath). Розширення PHP bcmath відсутнє (параметр конфігурації PHP --enable-bcmath). PHP ctype PHP ctype PHP ctype extension missing (PHP configuration parameter --enable-ctype). Розширення PHP ctype відсутнє (параметр конфігурації PHP --enable-ctype). PHP databases support Підтримка баз даних PHP PHP gd PHP gd PHP gd extension missing (PHP configuration parameter --with-gd). Розширення PHP gd відсутнє (параметр конфігурації PHP --with-gd). PHP gd FreeType support Підтримка PHP gd FreeType PHP gd FreeType support missing. Підтримка PHP gd FreeType відсутня. PHP gd JPEG image support missing. Підтримка PHP gd JPEG зображень відсутня. PHP gd JPEG support Підтримка JPEG в PHP gd PHP gd PNG image support missing. Підтримка PHP gd PNG зображень відсутня. PHP gd PNG support Підтримка PNG в PHP gd PHP gettext PHP gettext PHP gettext extension missing (PHP configuration parameter --with-gettext). Translations will not be available. Розширення PHP gettext відсутнє (параметр конфігурації PHP --with-gettext). Переклади будуть недоступні. PHP LDAP PHP LDAP PHP LDAP extension missing. PHP LDAP модуль відсутній. PHP libxml PHP libxml PHP libxml extension missing. Розширення PHP libxml відсутнє. PHP mbstring PHP mbstring PHP mbstring extension missing (PHP configuration parameter --enable-mbstring). Розширення PHP mbstring відсутнє (параметр конфігурації PHP --enable-mbstring). PHP option "%1$s" Опція PHP "%1$s" PHP option "%1$s" must be set to "%2$s" Опція PHP "%1$s" повинна бути задана як "%2$s" PHP session PHP session PHP session auto start must be disabled (PHP directive "session.auto_start"). Автоматичний старт сесій в PHP повинен бути відключений (PHP директива "session.auto_start"). PHP session extension missing (PHP configuration parameter --enable-session). Розширення PHP session відсутнє (параметр конфігурації PHP --enable-session). PHP sockets PHP sockets PHP sockets extension missing (PHP configuration parameter --enable-sockets). Розширення PHP sockets відсутнє (параметр конфігурації PHP --enable-sockets). PHP string function overloading must be disabled. Перевантаження функції PHP string повинно бути відімкнене. PHP version Версія PHP PHP xmlreader PHP xmlreader PHP xmlreader extension missing. Розширення PHP xmlreader відсутнє. PHP xmlwriter PHP xmlwriter PHP xmlwriter extension missing. Розширення PHP xmlwriter відсутнє. Pie Круговий Placing algorithm Алгоритм розміщення Plain text Текст Play Грати Play sound Програвати звуковий сигнал Please check configuration parameters. If all is correct, press "%1$s" button, or "%2$s" button to change configuration parameters. Будь-ласка, перевірте параметри конфігурації. Якщо все вірно, то натисніть кнопку "%1$s" а для зміни параметрів конфігурації натисніть кнопку "%2$s". Please create database manually, and set the configuration parameters for connection to this database. Press "%1$s" button when done. Будь-ласка, вручну створіть базу даних та вкажіть параметри для з'єднання з цією базою. Натисніть кнопку "%1$s" для завершення. Please enter the host name or host IP address and port number of the Zabbix server, as well as the name of the installation (optional). Будь-ласка, вкажіть ім'я хоста або IP адресу хоста та номер порту Zabbix сервера, а також ім'я інсталяції (опція). Please select two elements Будь-ласка, оберіть два елементи Points Крапки Point size Розмір крапок Polish (pl_PL) Польська (pl_PL) POP POP Populates host inventory field Заповнює поле інвентарних даних вузла мережі Port Порт Port cannot be empty for host interface. Порт не може бути порожнім для інтерфейсу вузла мережі. Port range Діапазон портів Portuguese (pt_BR) Португальська (pt_BR) Portuguese (pt_PT) Португальська (pt_PT) Post fields Поля Post Post type Тип Post Pre-installation summary Узагальнення інсталяції Preprocessing Попередня обробка Preprocessing steps Кроки попередньої обробки Preview Попередній перегляд Previous month Попередній місяць Previous week Попередній тиждень Previous year Попередній рік prev() - Previous value prev() - Попереднє значення Primary POC cell Головний мобільний для контакту Primary POC email Головний email для контакту Primary POC name Головне ім'я для контакту Primary POC notes Головні нотатки для контакту Primary POC phone A Головний телефон А для контакту Primary POC phone B Головний телефон B для контакту Primary POC screen name Головне нік-ім'я для контакту Privacy passphrase Ключова фраза приватності Privacy protocol Протокол приватності Private Приватний Private key file Файл приватного ключа Privilege level Рівень привілеїв Problem Проблема PROBLEM ПРОБЛЕМА Problem created Виникла Проблема Problem display Відображення проблем PROBLEM event generation mode Режим генерації подій ПРОБЛЕМА Problem expression Вираз для проблеми Problem hosts Вузли мережі з проблемами Problem, if all children have problems Проблема, якщо всі підлеглі мають проблеми Problem, if at least one child has a problem Проблема, якщо хоча б у одного із підлеглих наявна проблема Problem is not suppressed Проблему не подавлено Problem is suppressed Проблему подавлено Problem on Проблема на problem pattern маска проблеми Problem resolved Проблему вирішено Problems Проблеми Problems by severity Проблеми за важливістю Problem time Тривалість проблем Process CPU utilisation percentage. Returns float Утилізація CPU процесом у відсотках. Повертає дробове число Properties Властивості Provided URL "%1$s" is invalid. Наданий URL "%1$s" є некоректним. Proxies Проксі Proxy Проксі Proxy "%1$s" for host "%2$s" does not exist. Проксі "%1$s" для вузла мережі "%2$s" не існує. Proxy "%1$s" is used by action "%2$s". Проксі "%1$s" використовується дією "%2$s". Proxy "%1$s" is used by discovery rule "%2$s". Проксі "%1$s" використовується в правилі виявлення "%2$s". Proxy added Проксі додано Proxy address Адреса проксі Proxy deleted Проксі видалено Proxy deleted Проксі видалено Proxy deleted Проксі видалено Proxy interface creation failed. Помилка при створенні інтерфейсу проксі. Proxy interface update failed. Помилка при оновленні інтерфейсу проксі. Proxy mode Режим проксі Proxy name Ім'я проксі Proxy "%s" already exists. Проксі "%s" вже існує. Proxy updated Проксі оновлено PSK PSK PSK identity Ідентифікатор PSK PSK is too short. Minimum is %1$s hex-digits. PSK занадто короткий. Мінімум це %1$s шістнадцяткових чисел. Public Публічний Public key Публічний ключ Public key file Файл публічного ключа Query fields Поля запиту Queue Черга Queue of items to be updated Черга елементів даних які очікують оновлення Raw data Необроблені дані Raw post Необроблений post Read Читання Read only Тільки читання Read-only Тільки читання Read-write Читання-запис Reason Причина Received value Отримане значення Recent problems Останні проблеми Recipient Отримувач Recipient (ascending) Отримувач (у порядку зростання) Recipient (descending) Отримувач (в порядку спадання) Recovery Відновлення Recovery expression Вираз для відновлення Recovery expression syntax error. Синтаксична помилка у виразі для відновлення. Recovery operations Операції відновлення Recovery time Час відновлення Rectangle Прямокутник Refresh Оновити refreshed every %1$s sec. оновлюється кожних %1$s сек. Refresh interval Період оновлення Refresh interval multiplier Множник періоду оновлення Refresh unsupported items Оновлювати непідтримувані елементи даних Refresh unsupported items "%1$s". Оновлювати непідтримувані елементи даних "%1$s". regexp() - Regular expression V matching last value in period T (1 - match, 0 - no match) regexp() - Регулярний вираз V відповідає останньому значенню за період Т (1 - відповідає, 0 - не відповідає) Regular Звичайні regular expression регулярний вираз Regular expression Регулярний вираз Regular expression added Регулярний вираз додано Regular expression deleted Регулярні вирази видалено Regular expression deleted Регулярний вираз видалено Regular expression deleted Регулярні вирази видалено Regular expression does not exist. Регулярний вираз не існує. Regular expression must be a string Регулярний вираз має бути рядком Regular expressions Регулярні вирази Regular expression "%s" already exists. Регулярний вираз "%s" вже існує. Regular expression updated Регулярний вираз оновлено Regular items Звичайні елементи даних Release to create a new widget. Відпустіть для створення нового віджета. Remember me for 30 days Запам'ятати мене на 30 днів remember selected запам'ятати обране Remote command Віддалена команда Remove Видалити Remove, %1$s Видалити, %1$s Removed, %1$s Видалено, %1$s Remove domain name Видалити ім'я домену Remove from favourites Вилучити з обраного Remove from host group Видалити з групи вузлів мережі Remove from host groups Видалити із груп вузлів мережі Remove host Видалити вузел мережі Remove host groups Видалити групи вузлів мережі Replace Замінити Replace applications Замінити групи елементів даних Replace dependencies Замінити залежності Replace host groups Замінити групи вузла мережі Replace tags Замінити теги Reports Звіти Request body Запит тіла Request body type Тип запиту тіла Request sent successfully Запит успішно відправлено Request type Тип запиту Required Вимагається текст-відповідь Required host permissions Необхідні права на вузел мережі Required performance of the Zabbix server, in new values per second expected. Необхідна швидкодія Zabbix сервера, в одиницях очікуваної кількості нових значень в секунду. Required performance (vps) Необхідна продуктивність (знач/сек) Required server performance, new values per second Необхідна потужність сервера, нових значень в секунду Required status codes Необхідні коди статусу Required string Необхідна строка Reset Скинути Reset all fields to default values? Скинути всі поля в значення по замовчуванню? Reset confirmation Скинути підтвердження Reset defaults Скинути по замовчуванню Resolved Вирішено RESOLVED ВИРІШЕНО Resolved by Вирішено цим Resolved by correlation rule. Вирішено правилом кореляції. Resolved by correlation rule "%1$s". Вирішено правилом кореляції "%1$s". Resolved by user "%1$s". Вирішено користувачем "%1$s". Resource Ресурс Response code Код відповіді Response time Час відповіді Result Результат Result is FALSE Результат ФАЛЬШ Result is TRUE Результат ІСТИНА Result type Тип результату Retrieve mode Режим отримання Retrieve only headers Отримати тільки заголовки Retrieving contents of a file. Returns text Отримує вміст файлу. Повертає текст Retry Повторити Return a JSON object describing the MBean objects or their attributes. Can be used for LLD. Повертає JSON об'єкт, який описує MBean об'єкти або їх атрибути. Може бути використано для LLD правила. Return first column of the first row of the SQL query result. Повертає першу колонку першого рядка результату SQL запиту. Returns a JSON object describing the host network interfaces configured in Zabbix. Can be used for LLD. Повертає JSON об'єкт, який описує мережеві інтерфейси вузла мережі створеного в Zabbix. Може бути використано для LLD правила. Returns availability of a particular type of checks on the host. Value of this item corresponds to availability icons in the host list. Valid types are: agent, snmp, ipmi, jmx. Повертає доступність певного типу перевірок на вузлі мережі. Значення цього елементу даних відповідає іконкам доступності в списку вузлів мережі. Допустимі типи: agent, snmp, ipmi, jmx. Returns current maintenance status of the host. Повертає поточний стан сервісу вузла мережі. Returns ICMP ping response time in seconds. Example: 0.02 Повертає час відповіді в секундах на ICMP ping. Наприклад: 0.02 Returns information associated with Zabbix Java gateway. Valid params are: ping, version. Повертає інформацію про Zabbix Java gateway. Допустимі параметри: ping, version. Returns percentage of lost ICMP ping packets. Повертає відсоток втрачених ICMP ping пакетів. Return value of an attribute of MBean object. Повертає значення атрибута MBean об'єкта. right справа Right З правого боку Right trim Обрізати справа Right Y Вісь Y справа RMCP+ RMCP+ Romanian (ro_RO) Румунська (ro_RO) root корінь Row added Рядок додано Row deleted Рядок видалено Rows Рядків Row span Об'єднати рядки Rows per page Рядків на сторінку ruleid of dependent item and master item should match ruleid залежного елементу даних та головного елементу даних мають співпадати Rules Правила Run commands Виконати команди Run custom commands on %1$s Виконати команди користувача на %1$s Run global script Виконати глобальний скрипт Run IPMI command Виконати IPMI команду Run remote commands on current host Виконати віддалені команди на поточному вузлі мережі Run remote commands on host groups Виконати віддалені команди в групах вузлів мережі Run remote commands on hosts Виконати віддалені команди на вузлах мережі Run specified command on the host. Returns text result of the command; 1 - with mode as nowait (regardless of command result) Виконує вказану команду на вузлі мережі. Повертає текстовий результат команди; 1 - якщо mode вказаний як nowait (незалежно від результату команди) Run SSH commands Виконати SSH команди Run TELNET commands Виконати TELNET команди Russian (ru_RU) Російська (ru_RU) s с S Нд S Сб Safari Safari Sans-Serif Sans-Serif Sat Суб Saturday Субота Save changes Зберегти зміни Save it as "%1$s" Зберегти як "%1$s" Scenario Сценарій Schedule Заплановано Scheduled check Запланована перевірка Scheduling По розкладу Scope Межі Screen Комплексний екран Screen "%1$s" already exists. Комплексний екран "%1$s" вже існує. Screen "%1$s" already exists on template "%2$s". Комплексний екран "%1$s" вже існує в шаблоні "%2$s". Screen "%1$s" cell X - %2$s Y - %3$s is already taken. Комірка X - %2$s Y - %3$s комплексного екрану "%1$s" вже зайнята. Screen "%1$s" column span in cell X - %2$s Y - %3$s is incorrect. Об'єднання стовпчиків в комірці X - %2$s Y - %3$s комплексного екрану "%1$s" некоректне. Screen "%1$s" column span in cell X - %2$s Y - %3$s is too big. Об'єднання стовпчиків в комірці X - %2$s Y - %3$s комплексного екрану "%1$s" занадто велике. Screen "%1$s" is public and read-only sharing is disallowed. Комплексний екран "%1$s" є публічним, тому спільний доступ тільки на читання не дозволений. Screen "%1$s" row span in cell X - %2$s Y - %3$s is incorrect. Об'єднання рядків в комірці X - %2$s Y - %3$s комплексного екрану "%1$s" некоректне. Screen "%1$s" row span in cell X - %2$s Y - %3$s is too big. Об'єднання рядків в комірці X - %2$s Y - %3$s комплексного екрану "%1$s" занадто велике. Screen added Комплексний екран додано Screen deleted Комплексний екран видалено Screen name cannot be empty. Ім'я комплексного екрану не може бути пустим. Screen owner cannot be empty. Власник комплексного екрану не може бути пустим. Screens Комплексні екрани Screen updated Комплексний екран оновлено Script Скрипт Script "%1$s" already exists. Скрипт "%1$s" уже існує. Script added Скрипт додано Script deleted Скрипт видалено Script deleted Скрипти видалено Script deleted Скрипти видалено Script menu path "%1$s" already used in script name "%2$s". Шлях меню скрипта "%1$s" вже використовується в імені скрипта "%2$s". Script name Назва скрипта Script name "%1$s" already used in menu path for script "%2$s". Ім'я скрипта "%1$s" вже використовується в шляху меню для скрипта "%2$s". Script parameters Параметри скрипта Script parameters "%1$s" are missing the last new line feed for media type "%2$s". В кінці параметрів скрипта "%1$s" відсутній символ нового рядка для методу повідомлень "%2$s". Script profiler Профілювання скрипта Scripts Скрипти Script updated Скрипт оновлено Search Пошук Search attribute Атрибут пошуку Search pattern is empty Шаблон пошуку пустий second другий Secondary POC cell Другорядний мобільний для контакту Secondary POC email Другорядний email для контакту Secondary POC name Другорядне ім'я для контакту Secondary POC notes Другорядні нотатки для контакту Secondary POC phone A Другорядний телефон А для контакту Secondary POC phone B Другорядний телефон B для контакту Secondary POC screen name Другорядне нік-ім'я для контакту second parameter is expected очікується другий параметр Seconds Секунд Security level Рівень безпеки Security name Ім'я безпеки Select Вибрати selected вибрано Selected Відібрані Selected, %1$s in position %2$d of %3$d Вибрано, %1$s в позиції %2$d з %3$d Selected, %1$s, read only, in position %2$d of %3$d Вибрано, %1$s, тільки читання, в позиції %2$d з %3$d Selected actions deleted Вибрані дії видалено Selected and all other problems of related triggers Вибрані та всі інші проблеми пов'язаних тригерів Selected correlations deleted Видалено вибрані кореляції Selected elements Вибрані елементи Selected items only Тільки обрані елементи даних Select prototype Обрати прототип Select widget Виберіть віджет Send backward Перемістити назад Send message Надіслати повідомлення Send message to user groups Надіслати повідомлення групі користувачів Send message to users Надіслати повідомлення користувачам Send only to Надіслати тільки на Send to Надіслати Send to back Перемістити на самий зад Send to User groups Надіслати групі користувачів Send to Users Надіслати користувачам Sent Надіслано Sep Вер Separated Непідтверджені окремо September Вересень Serial number A Серійний номер А Serial number B Серійний номер Б Serif Serif Server Сервер Server (proxy) Сервер (проксі) Server time Час на сервері Service Послуга Service "%1$s" cannot be deleted, because it is dependent on another service. Послуга "%1$s" не може бути видалена, тому що інша послуга залежить від неї. Service "%1$s" cannot be dependent on itself. Послуга "%1$s" не може залежати сама від себе. Service "%1$s" cannot be linked to a trigger and have children at the same time. Послуга "%1$s" не може бути пов'язана з тригером і бути підлеглою одночасно. Service "%1$s" is already hardlinked to a different service. Послуга "%1$s" вже жорстко з'єднана з іншою послугою. Service availability report Звіт доступності послуги Service cannot be parent and child at the same time. Послуга не може бути батьківською та підлеглою одночасно. Service created Послугу створено Service data storage period Період зберігання даних послуг Service data storage period "%1$s". Період зберігання даних послуг "%1$s". Service deleted Послугу видалено Service dependencies Залежності послуг Service parent Батьківська послуга Service port Порт сервісу Services Послуги Services form a circular dependency. Послуги утворюють кільцеву залежність. Service start time must be less than end time. Час початку послуги має бути меншим за час закінчення. Service times Періоди послуги Service type Тип сервісу Service updated Послугу оновлено Session terminated, re-login, please. Сесія завершилась, будь-ласка повторно увійдіть в систему. Set custom time period Задати користувацький період часу Set host inventory mode Встановити режим інвентарних даних вузла мережі Setting LDAP dereferencing mode failed. Не вдалося встановити інший режим LDAP. Setting LDAP protocol failed. Не вдалося встановити протокол LDAP. Setting LDAP referrals to "Off" failed. Не вдалося встановити партнерів LDAP в "Off". Severity Важливість Severity changed Важливість змінено Severity changes Зміна важливості Severity decreased Важливість зменшено Severity (descending) Важливість (в порядку спадання) Severity increased Важливість збільшено SHA SHA Shape Фігура Sharing Спільний доступ Sharing option "%1$s" is missing a value for map "%2$s". В опції спільного доступу "%1$s" відсутнє значення для карти мережі "%2$s". Sharing option "%1$s" is missing a value for screen "%2$s". В опції спільного доступу "%1$s" відсутнє значення для комплексного екрану "%2$s". short description короткий опис Shortened Скорочено should be empty має бути пустим Show Відобразити Show details Відображувати деталі Show hosts in maintenance Відображувати вузли мережі в періодах сервісу show icon mappings показати призначення іконок Show items without data Відображувати елементи даних без історії Show latest values Відображувати останні значення Show legend Відображувати легенду Show lines Відображувати лінії Shown Показана Show problems Відображувати проблеми Show selected Відобразити тільки відібрані Show suppressed problems Відображувати подавлені проблеми Show tags Відображати теги Show text as HTML Відобразити текст у вигляді HTML Show timeline Відображувати вибір часу Show triggers Відображувати тригери Show unacknowledged only Відображувати тільки непідтверджені Show unavailable maps Відображувати недоступні карти Show value Відображувати значення show value mappings перетворення значень Show warning if Zabbix server is down Відображувати попередження, якщо Zabbix сервер недоступний Show working time Відображувати робочий час Sign in Увійти Sign in with HTTP Вхід по HTTP Sign out Вихід Simple Простий Simple change Проста зміна Simple check Проста перевірка Simple graph Простий графік Simple graph prototype Прототип простого графіку Single Один раз Site address A Адреса А Site address B Адреса B Site address C Адреса C Site city Місто Site country Країна Site notes Примітки Site rack location Місце знаходження стійки Site state / province Область / район Site ZIP / postal Поштовий індекс Size Розмір Size of the response received from Zabbix server "%1$s" exceeds the allowed size of %2$s bytes. This value can be increased in the ZBX_SOCKET_BYTES_LIMIT constant in include/defines.inc.php. Розмір отриманої відповіді від Zabbix сервера "%1$s" перевищує допустимий розмір в %2$s байт. Це значення може бути збільшене за допомогою константи ZBX_SOCKET_BYTES_LIMIT в include/defines.inc.php. Skipped copying of graph "%1$s" to host "%2$s". Пропущено копіювання графіку "%1$s" у вузол мережі "%2$s". SLA SLA Slide Слайд Slides Слайди Slide show Слайдшоу Slide show "%1$s" already exists. Слайд шоу "%1$s" вже існує. Slide show "%1$s" is public and read-only sharing is disallowed. Слайд шоу "%1$s" є публічним, тому спільний доступ тільки на читання не дозволений. Slide show added Слайдшоу додано Slide show deleted Слайдшоу видалено Slide show must contain slides. Слайдшоу повинно містити слайди. Slide show owner cannot be empty. Власник слайд шоу не може бути пустим. Slide shows Слайдшоу Slide show "%s" already exists. Слайдшоу "%s" вже існує. Slide show updated Слайдшоу оновлено Slovak (sk_SK) Словацька (sk_SK) SMS SMS SMTP SMTP SMTP email SMTP адрес електронної пошти SMTP helo SMTP привітання (helo) SMTP server SMTP сервер SMTP server port Порт SMTP серверу "%s" must be between 1970.01.01 and 2038.01.18. "%s" має бути між 1970.01.01 та 2038.01.18. SNMP SNMP SNMP community SNMP community SNMP interfaces SNMP інтерфейси SNMP OID SNMP OID SNMP trap SNMP трап SNMP trap key is invalid. Ключ SNMP trap помилковий. SNMPv1 agent SNMPv1 агент SNMPv2 agent SNMPv2 агент SNMPv3 agent SNMPv3 агент Snooze Подрімати Soft Не жорстка Software Програмне забезпечення Software application A Програмне забезпечення A Software application B Програмне забезпечення B Software application C Програмне забезпечення C Software application D Програмне забезпечення D Software application E Програмне забезпечення E Software architecture information. Returns string Інформація про архітектуру програмного забезпечення. Повертає рядок Software (Full details) Програмне забезпечення (повні деталі) Sort entries by Сортування записів за Sorting by field "%1$s" not allowed. Сортування по полю "%1$s" не дозволено. Sort order (0->999) Порядок сортування (0->999) Sort triggers by Сортувати тригери за Source Джерело Source type Тип джерела Spanish (es_ES) Іспанська (es_ES) Specified script does not exist or you do not have rights on it for action operation command. Вказаний скрипт не існує або ви не маєте до нього доступу для команди операції дії. Specify some filter condition to see the items. Вкажіть якусь умову в фільтрі щоб бачити елементи даних. Specify some filter condition to see the values. Вкажіть якусь умову в фільтрі щоб бачити значення. Speed Швидкість SQL count: %1$s (selects: %2$s | executes: %3$s) SQL запитів: %1$s (selects: %2$s | executes: %3$s) SQL query SQL запит SQL statement execution has failed "%1$s" Помилка при виконанні SQL запиту "%1$s" SQL statement execution has failed "%1$s". Помилка при виконанні SQL запиту "%1$s". SSH SSH SSH agent SSH агент SSL certificate file Файл SSL сертифікату SSL key file Файл SSL ключа SSL key password Пароль SSL ключа SSL/TLS SSL/TLS SSL verify host Перевіряти SSL host SSL verify peer Перевіряти SSL peer Stacked Накладається шарами в стек Staircase Сходинки Standard items Стандартні елементи даних Start in Початок в Starting TLS failed. Старт TLS не вдалий. STARTTLS STARTTLS Startup time of Zabbix server, Unix timestamp. Час запуску Zabbix сервера, Unix timestamp. State Стан Static Статично Status Стан Status (ascending) Статус (в порядку зростання) Status calculation Підрахунок статусу Status calculation algorithm Алгоритм підрахунку статусу Status codes Коди станів Status (descending) Статус (в порядку спадання) Status disabled Стан дезактивовано Status maintenance Стан обслуговування Status of discovery Стан виявлення Status ok Стан ок Status only Тільки статус Status problem Стан проблеми Step Крок Step "%1$s" [%2$s of %3$s] failed: %4$s Крок "%1$s" [%2$s з %3$s] помилковий: %4$s Step duration Тривалість кроку Step of web scenario Крок веб сценарію Steps Кроки Step with name "%1$s" already exists. Крок з іменем "%1$s" вже існує. Stop Стоп Straight Straight str() - Find string V in last (most recent) value (1 - found, 0 - not found) str() - Пошук рядка V в останньому (найбільш недавньому) значенні (1 -знайдено, 0 - не знайдено) strlen() - Length of last (most recent) T value in characters strlen() - Довжина останнього (найбільш недавнього) значення Т в символах Structured data Структуровані дані Style Спосіб Subfilter Субфільтр Subject Тема Subject Суб'єкт Submap Суб-карта <sub-menu/sub-menu/...>script <підменю/підменю/...>скрипт Sub navigation Суб-навігація Success Audit Аудит успіхів Success message Повідомлення про успіх Sum of incoming and outgoing traffic statistics on network interface. Returns integer Сумарна статистика вхідного та вихідного трафіку на мережевому інтерфейсі. Повертає ціле число sum() - Sum of values of a period T sum() - Сума значень за період Т Sun Нед Sunday Неділя supplied credentials are not unique наданий обліковий запис не унікальний Support Підтримка Suppressed till: %1$s Подавлено до: %1$s Surname Прізвище Swap in (from device into memory) statistics. Returns integer Статистика swap in (з пристрою в пам'ять). Повертає ціле число Swap out (from memory onto device) statistics. Returns integer Статистика swap out (з пам'яті в пристрій). Повертає ціле число Swap space size in bytes or in percentage from total. Returns integer for bytes; float for percentage Розмір файлу підкачки в байтах або у відсотках від всього розміру. Повертає ціле число для байтів; дробове для відсотків Swedish (sv_SE) Шведська (sv_SE) Switching authentication method will reset all except this session! Continue? Переключення методу аутентифікації скине всі сесії за виключенням цієї! Продовжити? System boot time. Returns integer (Unix timestamp) Час завантаження системи. Повертає ціле число (Unix timestamp) System default Системна по замовчуванню System error. Системна помилка. System error occurred. Please contact Zabbix administrator. Трапилась системна помилка. Зв'яжіться з адміністратором Zabbix. System host name. Returns string Ім'я вузла мережі системи. Повертає рядок System information Інформація про систему System statistics. Returns integer or float Статистика системи. Повертає ціле або дробове число System time. Returns integer with type as utc; string - with type as local Час системи. Повертає ціле число для type як utc; рядок - для type як local System uptime in seconds. Returns integer Час безперервної роботи системи в секундах (uptime). Повертає ціле число T Чт T Вт Table "%1$s" does not exist. Таблиця "%1$s" не існує. Table "%1$s" doesn't have a field named "%2$s". Таблиця "%1$s" не має поля з ім'ям "%2$s". tag тег Tag Тег Tag display priority Пріоритет відображення тегів Tag filter Фільтр тегів Tag for matching Тег для співпадіння Tag name Ім'я тегу Tags Теги Tag value Значення тегу Target Ціль Target list Список цілей Target type Тип цілі TCP TCP Telnet Telnet TELNET agent TELNET агент Template Шаблон Template "%1$s" already exists. Шаблон "%1$s" вже існує. Template "%1$s" cannot be without host group. Шаблон "%1$s" не може бути без групи вузлів мережі. Template "%1$s" for host "%2$s" does not exist. Шаблон "%1$s" для вузла мережі "%2$s" не існує. Template added Шаблон додано Template cannot be linked to another template more than once even through other templates. Шаблон не може бути приєднано до іншого шаблону більше ніж один раз, навіть через інші шаблони. Template deleted Шаблон видалено Templated items Елементи даних з шаблону Template group Група шаблону template ID "%1$s" is passed %2$s times шаблон з ID "%1$s" передано %2$s разів Template linkage Зв'язки з шаблонами Template macros Макроси з шаблону Template name Ім'я шаблону Templates Шаблони Templates "%1$s" unlinked from hosts "%2$s". Шаблони "%1$s" від'єднано від вузлів мережі "%2$s". Template screen "%1$s" already exists. Шаблонний комплексний екран "%1$s" вже існує. Template screens Комплексні екрани з шаблону Template trigger Тригер з шаблону Template updated Шаблон оновлено Template value Значення з шаблону Template with the same name "%1$s" already exists. Шаблон з таким самим іменем "%1$s" вже існує. Template with the same name "%s" already exists. Шаблон із цим самим ім'ям "%s" вже існує. Template with the same visible name "%1$s" already exists. Шаблон із цим самим видимим ім'ям "%1$s" вже існує. Template with the same visible name "%s" already exists. Шаблон із цим самим видимим ім'ям "%s" вже існує. Test Тест Test authentication Тест аутентифікації Test confirmation Тест підтвердження Test data Тестові дані Test expressions Тест виразів Test string Тестовий рядок Text Текст (одне поле) The "%1$s.%2$s" method must be called without the "auth" parameter. Метод "%1$s.%2$s" повинен викликатись без "auth" параметра. The application is not discovered anymore and will be deleted in %1$s (on %2$s at %3$s). Група елементів даних більше не виявляється та буде видалена через %1$s (%2$s о %3$s). The application is not discovered anymore and will be deleted the next time discovery rule is processed. Група елементів даних більше не виявляється та буде видалена при наступному виконанні правила виявлення. The host group is not discovered anymore and will be deleted in %1$s (on %2$s at %3$s). Група вузлів мережі більше не виявляється та буде видалена через %1$s (%2$s о %3$s). The host group is not discovered anymore and will be deleted the next time discovery rule is processed. Група вузлів мережі більше не виявляється та буде видалена при наступному виконанні правила виявлення. The host is not discovered anymore and will be deleted in %1$s (on %2$s at %3$s). Вузел мережі більше не виявляється та буде видалений через %1$s (%2$s о %3$s). The host is not discovered anymore and will be deleted the next time discovery rule is processed. Вузел мережі більше не виявляється та буде видалений при наступному виконанні правила виявлення. The image is used in icon map %1$s. Картинка використовується у призначеннях іконок %1$s. The image is used in icon map %1$s. Картинка використовується у призначеннях іконок %1$s. The image is used in icon map %1$s. Картинка використовується у призначенні іконок %1$s. The image is used in map %1$s. Картинка використовується у карті мережі %1$s. The image is used in map %1$s. Картинка використовується у картах мереж %1$s. The image is used in map %1$s. Картинка використовується у картах мереж %1$s. The item is not discovered anymore and will be deleted in %1$s (on %2$s at %3$s). Елемент даних більш не виявляється і буде видалений через %1$s (%2$s о %3$s). The item is not discovered anymore and will be deleted the next time discovery rule is processed. Елемент даних більше не виявляється та буде видалений при наступному виконанні правила виявлення. Theme Тема інтерфейсу The number of processes. Returns integer Кількість процесів. Повертає ціле число the parameter "%1$s" is missing параметр "%1$s" відсутній The received JSON is not a valid JSON-RPC Request. Отриманий JSON не являється правильним запитом JSON-RPC. The requested remote-procedure does not exist / is not available Запитувана віддалена процедура не існує / недоступна the tag "%1$s" is missing тег "%1$s" відсутній The web scenario application belongs to a different host than the web scenario host. Група елементів даних веб сценарію належить іншому вузлу мережі ніж вузлу мережі цього веб сценарію. The X coordinate of screen element located at X - %1$s and Y - %2$s of screen "%3$s" is too big. X координата елементу комплексного екрана розміщеного в X - %1$s та Y - %2$s на комплексному екрані "%3$s" занадто велика. The Y coordinate of screen element located at X - %1$s and Y - %2$s of screen "%3$s" is too big. Y координата елементу комплексного екрана розміщеного в X - %1$s та Y - %2$s на комплексному екрані "%3$s" занадто велика. third третій This day last week Цей день попереднього тижня This field is automatically populated by item "%s". Це поле автоматично заповнюється елементом даних "%s". This month Цей місяць This month so far Цей місяць по нині This screen column is not empty. Delete it? Стовпчик комплексного екрану не порожній. Видалити його? This screen row is not empty. Delete it? Рядок комплексного екрану не порожній. Видалити його? This week Цей тиждень This week so far Цей тиждень по нині This year Цей рік This year so far Цей рік по нині Threshold Межа Thu Чет Thursday Четвер Till До Time Час Time a particular Zabbix process or a group of processes (identified by <type> and <mode>) spent in <state> in percentage. Час конкретного процесу Zabbix або групи процесів (задається <типом> та <режимом>), проведений у <стані> у відсотках. Time (ascending) Час (в порядку зростання) time() - Current time time() - Поточний час Time (descending) Час (в порядку спадання) timeleft() - Time to reach threshold estimated based on period T timeleft() - Час досягнення порогу, вирахуваний на основі періоду Т Time of proxy last access. Name - proxy name. Param - lastaccess. Unix timestamp. Час останнього доступу проксі. Ім'я - ім'я проксі. Параметр - lastaccess. Штамп часу unix timestamp. Timeout Час очікування Time period Період часу time shift зсув часу Time shift Зсув часу Timestamp Час виникнення (штамп) Time type Тип часу Time zone for PHP is not set (configuration parameter "date.timezone"). Часовий пояс для PHP не вказано (параметр конфігурації "date.timezone"). To До Today Сьогодні Today so far Сьогодні по нині too many decimal places надто багато десяткових знаків Top По верхньому краю To set a host interface select a single item type for all items Для встановлення інтерфейсу вузла мережі виберіть один тип елемента даних для всіх елементів даних Total Всього TOTAL ВСЬОГО Total Elasticsearch time: %1$s Повний час Elasticsearch: %1$s Total SQL time: %1$s Всього затрачено часу на SQL: %1$s Total time: %1$s Всього затрачено часу: %1$s Transaction has not been closed. Aborting... Транзакція не була закрита. Скасування... Transform SQL query result into a JSON object for low-level discovery. Перетворює результат SQL запиту в об'єкт JSON для низькорівневого виявлення. Transparency Прозорість Transport error. Помилка транспорту. Treat as 0 Вважати як 0 Trend data storage period Період зберігання даних трендів Trend data storage period "%1$s". Період зберігання даних трендів "%1$s". Trends Динаміка Trend storage period Період зберігання трендів trigger тригер Trigger Тригер Trigger "%1$s" already exists on "%2$s". Тригер "%1$s" вже існує у "%2$s". Trigger "%1$s" belongs to templates with different linkages. Тригер "%1$s" належить шаблонам з різними зв'язками. Trigger "%1$s" depends on trigger "%2$s", which does not exist. Тригер "%1$s" залежить від тригера "%2$s", який не існує. Trigger added Тригер додано Trigger cannot be dependent on a trigger that is inherited from it. Тригер не може залежати від тригера, який успадкований від нього. Trigger copied Тригери скопійовано Trigger copied Тригери скопійовано Trigger copied Тригер скопійовано Trigger data storage period Період зберігання даних тригерів Trigger deleted Тригер видалено Trigger description Опис тригера Trigger details Деталі тригера Trigger disabled Тригер дезактивовано Trigger disabled Тригери дезактивовано Trigger disabled Тригери дезактивовано Trigger displaying options Параметри відображення тригера trigger does not allow manual closing для тригера не дозволено закриття вручну Trigger enabled Тригер активовано Trigger enabled Тригери активовано Trigger enabled Тригери активовано Trigger event and alert data storage period Період зберігання даних подій і повідомлень тригерів Trigger event and alert data storage period "%1$s". Період зберігання даних подій про тригери та повідомлення "%1$s". Trigger has items from template "%1$s" that is not linked to host. Тригер має елементи даних з шаблону "%1$s", який не приєднано до вузла мережі. Trigger info Інформація по тригерам Trigger in template "%1$s" has dependency with trigger in template "%2$s". Тригер з шаблону "%1$s" має залежність від тригера з шаблону "%2$s". Trigger in "unknown" state Тригер в "невідомому" стані Trigger label type Тип ярлика до тригера Trigger name Ім'я тригера Trigger overview Огляд тригерів Trigger prototype Прототип тригера Trigger prototype "%1$s" already exists on "%2$s". Прототип тригера "%1$s" вже існує в "%2$s". Trigger prototype "%1$s" belongs to templates with different linkages. Прототип тригера "%1$s" належить шаблонам з різними зв'язками. Trigger prototype "%1$s" contains item prototypes from multiple discovery rules. Прототип тригера "%1$s" містить прототипи елементів даних з декількох правил виявлення. Trigger prototype "%1$s" depends on trigger "%2$s", which does not exist. Прототип тригера "%1$s" залежить від тригера "%2$s", який не існує. Trigger prototype "%1$s" must contain at least one item prototype. Прототип тригера "%1$s" повинен містити принаймні один прототип елемента даних. Trigger prototype added Прототип тригера додано Trigger prototype cannot be dependent on a trigger that is inherited from it. Прототип тригера не може залежати від тригера який успадкований від нього. trigger prototype cannot be moved to another template or host прототип тригера неможливо перемістити в другий шаблон або вузел мережі Trigger prototype deleted Прототип тригера видалено Trigger prototypes Прототипи тригерів Trigger prototypes deleted Прототипи тригера видалено Trigger prototypes updated Прототипи тригерів оновлено Trigger prototype updated Прототип тригера оновлено Trigger prototype updated Прототипи тригерів оновлено Trigger prototype updated Прототипи тригерів оновлено Triggers Тригери Triggers deleted Тригери видалено Trigger severities Важливість тригера Trigger severity Важливість тригера Trigger status "OK" Стан тригера "ОК" Trigger status "Problem" Стан тригера "Проблема" Triggers top 100 Найбільш активні 100 тригерів Trigger updated Тригер оновлено trigger with linkages cannot be moved to another template or host тригера зв зв'язками неможливо перемістити в другий шаблон або вузел мережі Trim Обрізати TRUE ІСТИНА Try to read inaccessible property "%s". Спроба читання недоступної властивості "%s". Tue Вів Tuesday Вівторок Turkish (tr_TR) Турецька (tr_TR) Two items ("%1$s" and "%2$s") cannot populate one host inventory field "%3$s", this would lead to a conflict. Два елементи даних ("%1$s" та "%2$s") не можуть заповнювати одне поле "%3$s" інвентарних даних вузла мережі, це призвело б до конфлікту. Two map elements should be selected Необхідно вибрати два елемента карти мережі Type Тип Type (ascending) Тип (в порядку зростання) Type (descending) Тип (в порядку спадання) Type (Full details) Тип (повні деталі) type here to search почніть друкувати для пошуку Type of calculation Тип підрахунку Type of information Тип інформації Type of information must be "Numeric (unsigned)" or "Numeric (float)" for aggregate items. Тип інформації повинен бути "Числовий (ціле додатне)" або "Числовий (дробове)" для агрегованих елементів даних. Type (OK) Тип (ОК) Types Типи Ukrainian (uk_UA) Українська (uk_UA) Unable to create the configuration file. Не вдалося створити файл налаштувань. Unable to overwrite the existing configuration file. Не вдалося перезаписати існуючий файл налаштувань. Unable to select configuration. Неможливо вибрати конфігурацію. Unable to upload file because "file_uploads" is disabled. Неможливо завантажити файл, так як "file_uploads" відімкнено. Unacknowledged Непідтверджено Unacknowledged only Тільки непідтверджені Unacknowledged PROBLEM events Непідтверджені події ПРОБЛЕМА Unacknowledged RESOLVED events Непідтверджені ВИРІШЕНІ події Unblock Разблокувати Unblock selected users? Розблокувати вибраних користувачів? unexpected end of key неочікуваний кінець ключа unexpected end of macro неочікуваний кінець макросу unexpected parameter "%1$s" неочікуваний параметр "%1$s" unexpected tag "%1$s" неочікуваний тег "%1$s" unexpected text "%1$s" неочікуваний текст "%1$s" unexpected value "%1$s" неочікуване значення "%1$s" Units Одиниця виміру unknown невідомо Unknown Невідомо UNKNOWN НЕВІДОМО Unknown action Невідома дія Unknown error Невідома помилка Unknown function. Невідома функція. Unknown host item, no such item in selected host Невідомий елемент даних вузла мережі, немає цього елемента в обраному вузлі Unknown host, no such host present in system Невідомий вузел мережі, його не представлено в системі Unknown interface type. Невідомий тип інтерфейсу. Unknown resource Невідомий ресурс Unknown step failed: %1$s Помилка в невідомому кроці: %1$s Unknown value type Невідомий тип Unlimited Необмежено Unlink Від'єднати Unlink and clear Від'єднати та очистити Unlinked: Application "%1$s" on "%2$s". Від'єднано: Група елементів даних "%1$s" від "%2$s". Unlinked: Discovery rule "%1$s" on "%2$s". Від'єднано: Правило виявлення "%1$s" від "%2$s". Unlinked: Host prototype "%1$s" on "%2$s". Від'єднано: Прототип вузлів мережі "%1$s" на "%2$s". Unlinked: Item "%1$s" on "%2$s". Від'єднано: Елемент даних "%1$s" від "%2$s". Unlinked: Item prototype "%1$s" on "%2$s". Від'єднано: Прототип елемента даних "%1$s" від "%2$s". Unlinked: Web scenario "%1$s" on "%2$s". Від'єднано: Веб сценарій "%1$s" на "%2$s". Unlink from template Від'єднати від шаблону Unlink from templates Від'єднати від шаблонів Unmute Увімк. звук Unsupported import file extension "%1$s". Непідтримуване розширення файлу імпорту "%1$s". Unsupported import format "%1$s". Непідтримуваний формат імпорту "%1$s". Unsupported parameter "%2$s" for a filter condition of action "%1$s". Непідтримуваний параметр "%2$s" для дії умови фільтру "%1$s". Unsupported parameter "%2$s" for a filter condition of discovery rule "%1$s". Непідтримуваний параметр "%2$s" для правила виявлення умови фільтру "%1$s". Unsupported parameter "%2$s" for the filter of action "%1$s". Непідтримуваний параметр "%2$s" для фільтру в дії "%1$s". Unsupported parameter "%2$s" for the filter of discovery rule "%1$s". Непідтримуваний параметр "%2$s" для фільтру в правилі виявлення "%1$s". unsupported version number непідтримуваний номер версії Up Доступний Up Доступно Update Оновити Updated Оновлено Updated: %s Оновлено: %s Updated status of host "%1$s". Стан вузла мережі "%1$s" оновлено. Update existing Оновити існуючі Update interval Інтервал оновлення Update operations Операції оновлення Update problem Оновити проблему Upload Завантажити Upper level maps Карти верхнього рівня Uptime Доступний Uptime/Downtime Доступний/Недоступний Uptime of Zabbix server process in seconds. Час роботи процесу Zabbix сервера в секундах (uptime). URL URL URL A URL A URL (after login) URL (після входу в систему) URL B URL B URL C URL C URL is not properly encoded. URL закодовано некоректно. URL name should be unique for map "%1$s". Ім'я URL має бути унікальним для карти мережі "%1$s". URL parameter cannot be array. Параметр URL не може бути масивом. URL parameter name is empty. Ім'я параметра URL не може бути пустим. URLs URLи URL should have both "name" and "url" fields for map "%1$s". URL повинен мати обидва поля "name" та "url" для карти мережі "%1$s". USA (160 characters) США (160 символів) Use bulk requests Використовувати масові запити Use custom event status colours Використовувати користувацькі кольори статусів подій Used in actions Використовується в діях Used in items Використовується в елементах даних Use if severity Використовувати, якщо важливість User Користувач User "%1$s" cannot be without user group. Користувач "%1$s" не може бути без групи користувачів. User "%1$s" is dashboard "%2$s" owner. Користувач "%1$s" власник панелі "%2$s". User "%1$s" is map "%2$s" owner. Користувач "%1$s" є власником карти мережі "%2$s". User "%1$s" is screen "%2$s" owner. Користувач "%1$s" є власником комплексного екрану "%2$s". User "%1$s" is slide show "%2$s" owner. Користувач "%1$s" є власником слайд шоу "%2$s". User "%1$s" is used in "%2$s" action. Користувач "%1$s" використовується в дії "%2$s". User action Дія користувача User added Користувача додано User agent string Рядок user agent User cannot add himself to a disabled group or a group with disabled GUI access. Користувач не може додати сам себе у відключену групу або в групу з відключеним доступом до Веб-інтерфейсу. User cannot change their user type. Користувач не може змінювати собі тип користувача. User can't change type for himself Користувач не може змінювати тип сам собі User deleted Користувача видалено User group Група користувачів User group "%1$s" already exists. Група користувачів "%1$s" вже існує. User group "%1$s" is used in "%2$s" action. Група користувачів "%1$s" використовується в дії "%2$s". User group "%1$s" is used in configuration for database down messages. Група користувачів "%1$s" використовується в налаштуваннях відправки повідомлень про недоступність бази даних. User group "%1$s" is used in script "%2$s". Група користувачів "%1$s" використовується в скрипті "%2$s". User group disabled Групи користувачів дезактивовано User group disabled Групи користувачів дезактивовано User group disabled Групу користувачів дезактивовано User group enabled Групу користувачів активовано User group enabled Групи користувачів активовано User group enabled Групи користувачів активовано User group for database down message Повідомлення для групи користувачів при недоступності бази даних User group for database down message "%1$s". Група користувачів для повідомлення про недоступність бази даних "%1$s". User groups Групи користувачів User group sharing is missing parameters: %1$s for map "%2$s". У спільного доступу групи користувачів відсутні параметри: %1$s для карти мережі "%2$s". User group sharing is missing parameters: %1$s for screen "%2$s". У спільного доступу групи користувачів відсутні параметри: %1$s для комплексного екрану "%2$s". User group with ID "%1$s" is not available. Група користувачів з ID "%1$s" недоступна. User is not allowed to delete himself. Користувачу не дозволено видалити самого себе. User macro missing parameters: %1$s У макросу користувача відсутні параметри: %1$s User menu Меню користувача User name Ім'я користувача Username Ім'я користувача Username and password Ім'я користувача та пароль User password Пароль користувача User profile Профіль користувача User/Recipient Користувач/Отримувач Users Користувачі User session data storage period Період зберігання даних сесій користувачів User session data storage period "%1$s". Період зберігання даних сесій користувачів "%1$s". User sessions Сесії користувачів User sharing is missing parameters: %1$s for map "%2$s". У спільного доступу користувачів відсутні параметри: %1$s для карти мережі "%2$s". User sharing is missing parameters: %1$s for screen "%2$s". У спільного доступу користувачів відсутні параметри: %1$s для комплексного екрану "%2$s". Users unblocked Розблоковані користувачі User type Тип користувача User updated Дані користувача оновлено User with alias "%s" already exists. Користувач з псевдонімом "%s" вже існує. User with ID "%1$s" is not available. Користувач з ID "%1$s" недоступний. value значення Value Значення value %1$s already exists значення %1$s вже існує Value "%1$s" is invalid for parameter "grid_align". Choices are: "%2$s