3 Шаблони

Преглед

Шаблони су exported са многим повезаним објектима и објектним односима.

Извоз шаблона садржи:

• Повезане групе шаблона – Повезане групе шаблона (ако се користе у конфигурацији host prototype)
• Подаци шаблона
• Повезивање са другим шаблонима
• Веза са групама шаблона
• Директно повезане ставке
• Директно повезани покретачи
• Директно повезани графикони
• Директно повезане контролне табле
• Директно повезана правила откривања са свим прототиповима
• Директно повезани веб сценарији
• Мапе вредности

Извоз

Да бисте извезли шаблоне, урадите следеће:

1. Идите на Прикупљање података → Шаблони.
2. Означите поља за потврду шаблона за извоз.
3. Кликните на Извези испод листе.

У зависности од изабраног формата, шаблони се извозе у локалну датотеку са подразумеваним именом:

• zabbix_export_templates.yaml - у YAML извозу (подразумевана опција за извоз);
• zabbix_export_templates.xml - у XML извозу;
• zabbix_export_templates.json - у JSON извозу.

Увоз

Да бисте увезли шаблоне, урадите следеће:

1. Идите на Прикупљање података → Шаблони.
2. Кликните на Увези у горњем десном углу.
3. Изаберите датотеку за увоз.
4. Кликните на Увези у доњем десном углу обрасца за конфигурацију.

Ако означите поље за потврду Напредне опције, биће приказана детаљна листа свих елемената за увоз - означите или скините ознаку за свако правило увоза према потреби.

Ако кликнете на поље за потврду у реду Све, сви елементи испод њега ће бити означени/неозначени.

Правила увоза:

На следећем екрану ћете моћи да видите садржај шаблона који се увози. Ако је ово нови шаблон, сви елементи ће бити приказани зеленом бојом. Ако ажурирате постојећи шаблон, нови елементи шаблона ће бити означени зеленом бојом; уклоњени елементи шаблона биће истакнути црвеном бојом; елементи који се нису променили биће наведени на сивој позадини.

Мени са леве стране се може користити за навигацију кроз листу промена. Одељак Ажурирано истиче све промене направљене на постојећим елементима шаблона. Одељак Додано наводи нове елементе шаблона. Елементи у сваком одељку су груписани према типу елемента; кликните на сиву стрелицу да бисте проширили или скупили групу елемената.

Прегледајте промене шаблона, а затим кликните на Увези да бисте извршили увоз шаблона. Порука о успеху или неуспеху увоза ће бити приказана на корисничком интерфејсу.

Export format

When a template is exported, Zabbix generates a structured YAML, JSON, or XML document. This document contains elements that represent all parts of the template, such as template metadata, items, macros, triggers, dashboards, and more.

Each element serves a specific purpose and may contain nested elements.

The following sections describe each element in the export format.

The Linux by Zabbix agent template is used as an example.

An ellipsis (...) indicates content omitted for brevity. The note (see table below) is used when the element is explained in more detail in later sections.

Извезени елементи

Извезени елементи су објашњени у табелама испод.

Шаблони

|<|name|string|(обавезно) Име добављача шаблона.| |^|version|string|(обавезно) Верзија шаблона.
За out-of-the-box шаблон, верзија се приказује на следећи начин: главна верзија Zabbix, граничник ("-"), број ревизије (повећан са сваком новом верзијом шаблона и ресетован са сваком већом верзијом Zabbix-а). На пример, 8.0-0, 7.0-3, 7.2-0, 7.2-3.| |templates|<| |Root елемент за повезане шаблоне.| | |name|string|(обавезно) Име шаблона.| |groups|<| |Root елемент за групе шаблона.| | |name|string|(обавезно) Име групе шаблона.| |items|<| |Основни елемент за ставке шаблона.| |discovery_rules|<| |Основни елемент за шаблонска правила откривања ниског нивоа.| |httptests|<| |Root елемент за шаблони веб сценарија.| |tags|<| |Root елемент за ознаке шаблона.| |<|tag|string|(обавезно) Име ознаке.| |^|value|string|Вредност ознаке.| |macros|<| |Root елемент за макрое корисника шаблона.| |<|macro|string|(обавезно) Име корисничког макроа.| |^|type|string|Тип корисничког макроа.
Могуће вредности:¹ TEXT (0, подразумевано), SECRET_TEXT (1), VAULT (2).
Погледајте такође : Објекат корисничког макроа (type).| |^|value|string|Вредност корисничког макроа.| |^|description|string|Опис корисничког макроа.| |dashboards|<| |Root елемент за шаблонске контролне табле.| |valuemaps|<| |Root елемент за мапе вредности шаблона.|

Шаблон ставки

|password|<|string|(обавезно за SSH и TELNET ставке) Лозинка за аутентификацију.
Подржано за SIMPLE, ODBC, JMX и HTTP_AGENT ставке.
Када се користи за JMX ставке, потребно је навести и username (погледајте изнад) или оба елемента треба оставити празна.|

|publickey|<|string|(обавезно за SSH ставке) Назив датотеке јавног кључа.| |privatekey|<|string|(обавезно за SSH ставке) Назив датотеке приватног кључа.| |description|<|text|Опис ставке.| |inventory_link|<|string|Поље инвентара домаћина које је попуњено овом ставком.
Могуће вредности:¹ NONE (0), ALIAS (4), итд. (погледајте Host inventory за подржана поља).| |valuemap|<| |Root елемент за мапирање вредности ставке.| | |name|string|(required) Назив мапе вредности која ће се користити за ову ставку.| |logtimefmt|<|string|Формат времена у записима логова.
Подржано за ставке типа LOG.| |preprocessing|<| |Root елемент за предобраду вредности ставке.| | |step| |Коренски елемент за template item value preprocessing steps.| |jmx_endpoint|<|string|JMX крајња тачка.
Подржано за JMX ставке.| |master_item|<| |(обавезно за DEPENDENT ставке) Коренски елемент за мастер ставку зависне ставке.| | |key|string|(обавезно) Кључ мастер ставке зависне ставке.| |timeout|<|string|Време истека захтева за прикупљање података ставке.
Подржано за Timeouts списак типова ставки.| |url|<|string|(обавезно за HTTP_AGENT ставке) URL адреса.| |query_fields|<| |Коренски елемент за параметре упита.
Подржано за HTTP_AGENT ставке.| |<|name|string|(обавезно за HTTP_AGENT ставке) Назив параметра упита.| |^|value|string|Вредност параметра упита.
Подржано за HTTP_AGENT ставке.| |parameters|<| |Коренски елемент за параметре дефинисане од стране корисника.
Подржано за ITEM_TYPE_SCRIPT и ITEM_TYPE_BROWSER ставке.| |<|name|string|(обавезно за ITEM_TYPE_SCRIPT и ITEM_TYPE_BROWSER ставке) Назив параметра дефинисаног од стране корисника.| |^|value|string|Вредност параметра дефинисаног од стране корисника.
Подржано за ITEM_TYPE_SCRIPT и ITEM_TYPE_BROWSER ставке.| |posts|<|string|Тело HTTP(S) захтева.
Подржано за HTTP_AGENT ставке.| |status_codes|<|string|Опсег тражених HTTP статус кодова, одвојених зарезима.
Подржано за HTTP_AGENT ставке.| |follow_redirects|<|string|Прати преусмеравања одговора при прикупљању података.
Подржано за HTTP_AGENT ставке.
Могуће вредности:¹ NO (0), YES (1, default).| |post_type|<|string|Тип тела података.
Подржано за HTTP_AGENT ставке.
Могуће вредности:¹ RAW (0, default), JSON (2), XML (3).| |http_proxy|<|string|Конекцијски низ за HTTP(S) прокси..
Подржано за HTTP_AGENT ставке.| |headers|<| |Коренски елемент за HTTP заглавља.
Подржано за HTTP_AGENT ставке.| |<|name|string|(обавезно за HTTP_AGENT ставке) Назив заглавља.| |^|value|string|(обавезно за HTTP_AGENT ставке) Вредност заглавља.| |retrieve_mode|<|string|Који део одговора треба да се чува.
Подржано за HTTP_AGENT ставке.
Могуће вредности:¹ BODY (0, default), HEADERS (1), BOTH (2).| |request_method|<|string|Тип методе захтева.
Подржано за HTTP_AGENT ставке.
Могуће вредности:¹ GET (0, default), POST (1), PUT (2), HEAD (3).| |output_format|<|string|Како обрадити одговор.
Подржано за HTTP_AGENT ставке.
Могуће вредности:¹ RAW (0, default), JSON (1).| |allow_traps|<|string|Дозволи попуњавање вредности слично trapper ставци.
Подржано за HTTP_AGENT ставке.
Могуће вредности:¹ NO (0, default), YES (1).| |ssl_cert_file|<|string|Путања до јавног SSL кључа.
Подржано за HTTP_AGENT ставке.| |ssl_key_file|<|string|Путања до приватног SSL кључа.
Подржано за HTTP_AGENT ставке.| |ssl_key_password|<|string|Лозинка за SSL кључ.
Подржано за HTTP_AGENT ставке.| |verify_peer|<|string|Ако је потребно проверити да је сертификат домаћина аутентичан.
Подржано за HTTP_AGENT ставке.
Могуће вредности:¹ NO (0, default), YES (1).| |verify_host|<|string|Ако је потребно проверити да се име домаћина за везу подудара са оним у сертификату домаћина.
Подржано за HTTP_AGENT ставке.
Могуће вредности:¹ NO (0, default), YES (1).| |tags|<| |Коренски елемент за ознаке ставке.| |<|tag|string|(equired) Назив ознаке.| |^|value|string|Вредност ознаке.| |triggers|<|<|Коренски елемент за template item triggers.|

Кораци претходне обраде вредности ставке шаблона

Тригери ставки шаблона

Правила низак-ниво откривања шаблона

Филтери правила низак-ниво-откривања шаблона

Операције замене правила Низак-Ниво-Откривања у шаблону

Шаблони веб сценарија

Кораци веб сценарија шаблона

|<|name|string|(обавезно) Име променљиве.| |^|value|text|(обавезно) Вредност променљиве.| |headers|<| |Root елемент за HTTP заглавља која се шаљу приликом извршавања захтева.| |<|name|string|(обавезно) Име заглавља.| |^|value|text|(обавезно) Вредност заглавља.| |follow_redirects|<|string|Прати HTTP преусмеравања.
Могуће вредности:¹ NO (0), YES (1, default).| |retrieve_mode|<|string|Режим преузимања HTTP одговора.
Могуће вредности:¹ BODY (0, default), HEADERS (1), BOTH (2).| |timeout|<|string|Истек (користећи секунде, time suffix, или user macro) извршавања корака.
Подразумевано: 15s.| |required|<|string|Текст који мора бити присутан у одговору (игнорисан ако је празан).| |status_codes|<|string|Листа прихваћених HTTP статусних кодова раздвојених зарезима (нпр., 200-201,210-299; игнорисано ако је празно).|

Template macro configuration

zabbix_export:
         (...)
         templates:
           - uuid: f8f7908280354f2abeed07dc788c3747
             (...)
             macros:
               - macro: '{$AGENT.TIMEOUT}'
                 (...)
                 config:
                   type: TEXT
                   priority: '1'
                   label: 'Seconds since the last Zabbix agent seen'
                   description: 'Timeout after which agent is considered unavailable.'
               - macro: '{$CPU.UTIL.CRIT}'
                 (...)
                 config:
                   type: TEXT
                   priority: '2'
                   section_name: Thresholds
                   label: 'Threshold of CPU utilization expressed'
                   description: 'Critical threshold of CPU utilization expressed in %. In the range from 0 to 100 inclusive.'
                   regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
               (...)
               - macro: '{$IFCONTROL}'
                 (...)
                 config:
                   type: CHECKBOX
                   priority: '19'
                   label: 'Interfaces control'
                   description: 'Fire a trigger when the interface operational status changes to "Link down".'
                   options:
                     - checked: '1'
                       unchecked: '0'
               (...)

Контролне табле шаблона

Виџети шаблона контролне табле

Мапе вредности шаблона

Footnotes

¹ API целобројне вредности у заградама, на пример, ENABLED (0), помињу се само као референца. За више информација погледајте страницу повезаног API објекта у уносу у табели или на крају сваког одељка.