11 Напомене о надоградњи за 7.0.0

Ове напомене су за надоградњу са Zabbix-а 6.4.к на Zabbix 7.0.0.

Све белешке су груписане у:

• Прекидне промене - промене које могу да покваре постојеће инсталације и друго критичне информације везане за процес надоградње
• Остало - све преостале информације које описују промене у Zabbix функционалности

Погледајте такође:

• Процедура надоградње за све релевантне информације о надоградњи са верзија пре Zabbix-а 6.4.0;
• Надоградња HA кластера за упутства о надоградњи сервера у кластеру високе доступности (HA).

Процес надоградње

Да бисте довршили успешну надоградњу Zabbix сервера на MySQL/MariaDB, можда ћете морати да поставите GLOBAL log_bin_trust_function_creators = 1 у MySQL-у ако је бинарно евидентирање омогућено, не постоје привилегије суперкорисника и log_bin_trust_function_creators = 1 није подешено у MySQL конфигурационој датотеци.

Да бисте подесили променљиву помоћу MySQL конзоле, покрените:

mysql> SET GLOBAL log_bin_trust_function_creators = 1;

Када се надоградња успешно заврши, ова опција се може онемогућити:

mysql> SET GLOBAL log_bin_trust_function_creators = 0;

Преломне промене

Пад сервера са PostgreSQL/TimescaleDB након надоградње на 7.0.1 са 7.0.0

Надоградња на Zabbix 7.0.1 (или новију) са Zabbix 7.0.0 са PostgreSQL/TimescaleDB доводи до пада сервера. Овај проблем је узрокован решењем проблема са компресијом у табели аудитлог у Zabbix 7.0 који неповратно мења политику компресије табеле аудитлог.

Погледајте познати проблеми за детаље о ручном поправљању табеле евиденције ревизије.

Ако још нисте извршили надоградњу на Zabbix 7.0.0, имајте на уму да не би требало бити таквих проблема за надоградње са верзије Zabbix пре-7.0 на 7.0.1. За упутства за надоградњу погледајте Надоградња TimescaleDB шеме.

Грешка при враћању базе података са PostgreSQL/TimescaleDB након надоградње са 7.0.0-7.0.4

Коришћење pg_restore за враћање резервне копије PostgreSQL/TimescaleDB креиране у Zabbix-у 7.0.0-7.0.4 ће резултирати недостајућим грешка функције base36_decode, због чега враћање није успело. Ова грешка се јавља приликом враћања резервне копије направљене помоћу pg_dump.

Погледајте познати проблеми за детаље о ручном решавању овог проблема пре прављења резервну копију.

Ако још нисте извршили надоградњу на Zabbix 7.0.0, имајте на уму да не би требало бити таквих проблема за надоградње са верзије Zabbix-а пре-7.0 на 7.0.5. За упутства за надоградњу погледајте Надоградња TimescaleDB шеме.

Минимална потребна верзија PHP-а

Минимална потребна верзија PHP-а је подигнута са 7.4.0 на 8.0.0.

Подразумевана локација за конфигурациону датотеку Windows агента

Подразумевана локација на којој Zabbix агент на Windows-у тражи конфигурациону датотеку је промењено. Сада га агент тражи у директоријуму где је агент бинарни zabbix_agentd.exe се налази (уместо C:\zabbix_agentd.conf, као раније).

Zabbix агент 2 на Windows-у је већ тражио подразумевану конфигурациону датотеку у директоријум где се налази бинарни zabbix_agent2.exe. Међутим, у новој верзији агент 2 очекује да ће конфигурациона датотека бити названа zabbix_agent2.conf (уместо zabbix_agent2.win.conf)

Такође погледајте: Инсталирање Zabbix агента на Windows.

Дозвољене су празне вредности у конфигурацији додатка агента 2

Празне вредности су сада дозвољене у конфигурационим параметрима везаним за додатке на Zabbix агенту 2.

TimescaleDB 1.x више није подржан

Подршка за TimescaleDB 1.x је уклоњена.

Типови података двоструке прецизности на TimescaleDB

Пре надоградње на Zabbix 7.0.0, потребно је ручно надоградити TimescaleDB да бисте користили типове података двоструке прецизности ако се TimescaleDB користи са компресијом. Можете да утврдите да ли TimescaleDB не користи типове података двоструке прецизности по упозорењу у одељку предњег дела Информације о систему или евиденцији Zabbix сервера: "База података није надограђена да користи вредности двоструке прецизности. Подршка за стари нумерички тип ће бити уклоњена у будућим верзијама."

За више информација погледајте Надоградња на нумеричке вредности проширеног опсега.

Аудитлог конвертован у хипертабелу на TimescaleDB

Табела auditlog је конвертована у хипертабелу на TimescaleDB-у у новим инсталацијама да би имала користи од аутоматског партиционисања на време (7 дана подразумевано) и бољих перформанси.

Да бисте успешно надоградили постојеће инсталације, погледајте Надоградња TimescaleDB шеме.

Такође погледајте: Подржане верзије TimescaleDB

Одвојена табела базе података за проксије

Прокси записи су премештени из табеле hosts и сада се чувају у новој табели proxy.

Такође, оперативни подаци проксија (као што су последњи приступ, верзија, компатибилност) су премештени из табеле host_rtdata и сада се чувају у новој табели proxy_rtdata.

У API-ју постоји и нови прокси објекат. Све операције са проксијима треба да се ажурирају да би се обављале преко овог новог прокси објекта.

Временско ограничење извршења упита за ставке монитора базе података

На основу промена у конфигурацији временског ограничења ставке, временско ограничење за пријаву на ODBC и временско ограничење за извршавање упита за монитор базе података ставке су сада ограничене на вредност параметра Timeout постављену у конфигурација ставке образац.

Ажурирани агент/агент2 ставке

• wmi.get и wmi.getall, када се користи са Zabbix агентом 2, сада врати JSON са логичким вредностима представљеним као стрингови (на пример, "RealTimeProtectionEnabled": "True" уместо "RealTimeProtectionEnabled": true враћено претходно) да би одговарало излазном формату ових ставки на Zabbix агенту;
• oracle.ts.stats има нови параметар conname за навођење назив циљног контејнера. JSON формат враћених података је ажуриран. Када у кључним параметрима није наведен tablespace, type или conname, враћени подаци ће укључивати додатни JSON ниво са именом контејнера, омогућавајући разликовање између контејнера.
• net.dns.* ставке се више не могу конфигурисати без параметра name. Иако је увек наведен као обавезан, параметар name, ако се изостави, претходно би се разрешио на подразумевану вредност (zabbix.com), што више није случај.

За листу измена ставки које не утичу на компатибилност, погледајте Шта је ново у Zabbix-у 7.0.0.

SNMP замке са Zabbix високом доступношћу

Zabbix сада може да чита SNMP трап датотеке са тачног места у случају да се активни чвор пребаци у подешавање високе доступности.

Међутим, да би ова функционалност функционисала, потребно је ажурирати формат времена у било којој bash, perl и SNMPTT скрипти на "%Y-%m-%dT%H:%M:%S%z" (тј. 2024-01-10T11:56:14+0300).

Повећана максимална величина и број виџета на контролној табли

Подразумевана ширина је повећана 3 пута за све виџете. Имајте на уму да ако користите прилагођене виџете, можда ћете морати да ажурирате одговарајуће параметре датотеке manifest.json (на пример, када конфигуришете прилагођени [Clock] (/manual/api/reference/dashboard/widget_fields/clock#configuring-a-clock-widget) виџет, width је за бити промењен из 4 у 12).

Виџет сада може имати до 72 колоне у ширину (раније 24) и од 1 до 64 реда у висину (раније 2 до 32). Контролна табла сада може да држи до 72 виџета хоризонтално.

Историја ставки и виџети за обичан текст

Нови Историја ставки виџет контролне табле заменио је виџет Обичан текст, нудећи неколико побољшања.

За разлику од виџета Обичан текст, који је приказивао само најновије податке о ставци у обичном тексту, виџет Историја предмета подржава различите опције приказа за више типова ставки (нумеричке, знаковне, евиденцијске, текстуалне и бинарне). На пример, може да прикаже траке или индикаторе напретка, слике за бинарне типове података (корисно за ставке прегледача) и истакне текстуалне вредности (корисно за надгледање датотеке евиденције).

Након надоградње, сви претходно конфигурисани виџети Обичан текст биће аутоматски замењени виџетима историја ставки, уз задржавање истих поставки конфигурације. Међутим, све API скрипте који се односе на виџет Обичан текст морају се ажурирати ручно.

Промене у резолуцији одређених уграђених макроа након надоградње на 7.0.4

У Zabbix-у 7.0.4, понашање решавања макроа {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {EVENT.CAUSE.*}, {EVENT.TAGS.*} и {EVENT.SYMPTOMS} су исправљени ради доследности са другим уграђеним макроима. Сада ће се решити у *UNKNOWN* ако дође до грешке приликом процене њихове вредности.

Као резултат ове промене, да би се обезбедила одговарајућа функционалност, неопходно је ажурирати типове медија за следеће интеграције: iTop, Jira Service Desk, ManageEngine ServiceDesk, SolarWinds Service Desk.

Ова промена такође може утицати на било које прилагођене скрипте или интеграције које користе горе поменуте макрое.

API промене

Погледајте листу промена API-ја у Zabbix-у 7.0.0.

Остало

Oracle DB је застарео

Подршка за Oracle као позадинску базу података је застарела од Zabbix-а 7.0 и очекује се да ће бити потпуно уклоњен у будућим верзијама.

Провера ажурирања софтвера

Провера ажурирања софтвера је сада подразумевано додата новим и постојећим инсталацијама - Zabbix кориснички интерфејс ће комуницирати са јавном Zabbix крајњом тачком да провери ажурирања.

Ову проверу можете да онемогућите тако што ћете подесити AllowSoftwareUpdateCheck=0 у серверу конфигурација.

Вредности у покретном зарезу су исечене за целобројне ставке

Сада, ако се прими вредност с покретним зарезом за непотписану цео број, вредност ће бити исечена из децималног дела и сачувана као цео број. Раније би вредност са помичним зарезом учинила да цели број није подржан.

Формат времена у САД

Прикази времена и датума на корисничком интерфејсу сада су у складу са стандардним приказом времена/датума у САД када се користи подразумевани (en_US) језик корисничког интерфејса.

Before	Now
	[]
(../../../assets/en/manual/introduction/us_time_now.png)

Asynchronous pollers

Након надоградње све провере агента, HTTP агента и walk[OID] SNMP-а биће премештене у асинхрони pollers.

Откривање функција cURL библиотеке у току рада

Раније су функције cURL библиотеке откривене у време израде Zabbix сервера, проксија или агента. Ако су cURL карактеристике биле надограђене, да би се искористиле, одговарајућа Zabbix компонента је морала да се поново компајлира.

Сада је потребно само поновно покретање да би надограђене функције cURL библиотеке постале доступне у Zabbix-у. Рекомпилација више није потребна. Ово важи за Zabbix сервер, прокси или агент.

Поред тога:

• Минимална потребна верзија cURL-а за време изградње је подигнута на 7.19.1;
• Када се гради, Zabbix само проверава да ли је cURL библиотека доступна (ако се захтева) и задовољава захтев за верзију;
• Приликом издавања грешке у cURL библиотеци током извршавања биће додата верзија која је у употреби (нпр. "cURL библиотека не подржава SSL/TLS (користећи верзију 7.88.1)");
• Када се Zabbix сервер покрене и SMTP аутентификација се евидентира, он ће записати доступност SMTP аутентификације за cURL библиотеку која се користи.

Конфигурација временског ограничења ставке се мења

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

Када користите надограђени сервер (верзија 7.0.0 или новију) са старијим проксијем или агентом, прокси или агент ће радити као и раније:

• прокси ће користити параметар Timeout из конфигурационе датотеке проксија;
• агент ће користити параметар Timeout из конфигурационе датотеке агента.

Параметри временског ограничења су уклоњени из конфигурационих датотека Modbus и MQTT додаци. Временска ограничења за извршење захтева сада могу да се подесе помоћу обрасца конфигурација ставке.

Ставке претраживача

Нови тип ставке – Ставка претраживача – додат је Zabbix-у, омогућавајући праћење сложених веб локација и веб апликација помоћу претраживача. Ставке претраживача омогућавају извршавање кориснички дефинисаног JavaScript кода за симулацију радњи у вези са прегледачем као што су кликтање, уношење текста, навигација кроз веб странице итд.

Поред тога, ова функција додаје следеће промене:

• Website by Browser шаблон је додат у шаблоне из кутије;
• ITEM_TYPE_BROWSER (22) тип ставке је додат у ставку шаблон или домаћин, правило откривања ниског нивоа и конфигурацију прототипа ставке извоз/увоз;
• StartBrowserPollers и WebDriverURL Zabbix сервер/прокси су додани параметри конфигурационе датотеке;
• Временско ограничење ставке прегледача је додато на временска ограничења прокси или глобално (ако се прокси не користи);
• -w <webdriver url> параметар командне линије за омогућавање надгледања прегледача је додат zabbix_js услужном програму командне линије.

Истодобност у откривању мреже

У новој верзији процес откривања мреже је прерађен како би се омогућила истовременост између провера услуга. Додан је нови процес менаџера откривања заједно са подесивим бројем радника за откривање (или нити). Менаџер открића обрађује правила откривања и креира посао откривања по сваком правилу са задацима (провере услуга). Сервисни чекови се преузимају и извели радници открића.

Параметар StartDiscoverers сада одређује укупан број доступних радника за откривање за откривање. Подразумевани број StartDiscoverers је повећан са 1 на 5, а опсег од 0-250 до 0-1000. Процеси discoverer из претходних верзија Zabbix-а су избачени.

Поред тога, број доступних радника по сваком правилу се сада може конфигурисати у корисничком интерфејсу. Овај параметар је опциони. Током надоградње биће постављен на "Један" као у претходним верзијама Zabbix-а.

Иконе замењене фонтовима

Све иконе у предњем делу су пребачене са слика икона на фонтове.

Најновији филтер података

У Надгледање → Најновији подаци, подфилтер и подаци се више не приказују подразумевано ако филтер није подешен. Међутим, имајте на уму да претходно сачувани филтери који су подешени помоћу само подфилтера остају непромењени. У таквим случајевима, подфилтер ће остати видљив, а подаци ће бити приказани чак и без подешавања главног филтера.

Конфигурациони параметри

Подразумевана вредност за неколико конфигурационих параметара је промењена:

• BufferSize конфигурациони параметар за Zabbix агент 2 је повећан са 100 на 1000;
• Plugins.<PluginName>.System.Capacity конфигурациони параметар за Zabbix агент 2 је повећан са 100 на 1000 (максимално). Имајте на уму да је параметар Plugins.<PluginName>.Capacity, који је застарео у Zabbix-у 6.0, потпуно уклоњен;
• StartAgents конфигурациони параметар за Zabbix агент је повећан са 3 на 10. Имајте на уму да за мање системе (тј. Raspberry Pi) подразумевана вредност може остати 3.

Ове промене не утичу на постојеће инсталације где су ови параметри експлицитно подешени.

Агрегатни прорачуни

Неколико агрегатних функција је ажуриранa. Сада:

• Функције агрегата сада такође подржавају ненумеричке типове за израчунавање. Ово може бити корисно, на пример, са функцијама count и count_foreach. – Збирне функције count и count_foreach подржавају опционе параметре оператор и образац, који се може користити за фино подешавање филтрирања ставки и бројање само вредности које одговарају датим критеријумима. – Све foreach functions више не укључују неподржане ставке у бројању.
• Функција last_foreach, претходно конфигурисана да игнорише аргумент временског периода, прихвата је као опциони параметар.

Стари нумерички (уложен) тип вредности је испуштен

Од Zabbix -а 5.0, нумерички (уложен) тип података подржава прецизност од приближно 15 цифара и распон од приближно -1.79E+308 до 1.79E+308. Стари нумерички тип је онемогућен, али и даље подржан. Од Zabbix-а 6.4, он је застарео, а почевши од Zabbix-а 7.0, потпуно је уклоњен.

Ако ваша инсталација није надограђена да користи нумеричке вредности проширеног опсега, следеће упозорење се приказује у Извештаји → Информације о систему: "Табеле историје базе података су надограђене: Не. Подршка за стари нумерички тип је застарела. Надоградите на нумеричке вредности проширеног опсега".

Приликом надоградње на Zabbix 7.0, следеће базе података се надограђују аутоматски:

• MySQL
• PostgreSQL/TimescaleDB (без компресије)
• Oracle

Међутим, за Oracle, старије верзије MySQL-а и велике инсталације, препоручује се да се тип података ручно надогради пре надоградње на Zabbix 7.0.

За TimescaleDB са компресијом, база података мора да се надогради ручно.

За детаље о надоградњи погледајте Надоградња на нумеричке вредности проширеног опсега.

Подешавање типа покретања услуге Windows агента

Опција за подешавање типа покретања Zabbix агент/агент 2 Windows услуге (-S --startup-type) је додат. Ова опција омогућава конфигурисање услуге агента/агента 2 да се аутоматски покрене при покретању Windows-а (automatic), након што се аутоматски покренути сервиси заврше са покретањем (delayed), када их корисник или апликација покрене ручно (manual) или да бисте у потпуности онемогућили услугу (disabled).

Када се врши инсталација Windows агента са MSI, подразумевани тип покретања на Windows Server 2008/Vista и новијим верзијама сада је delayed ако није другачије наведено у STARTUPTYPE команда- параметар линије. Ово побољшава поузданост и перформансе Windows сервиса Zabbix агент/агент 2, посебно током рестартовања система.

Шаблони

За нове шаблоне и промене постојећих шаблона погледајте Промене шаблона.

New directory structure for database-related files

When installing Zabbix from packages and preparing the database schema, the location of database-related files has changed to better correspond to the file structure in the sources:

• Base initialization files (schema.sql, data.sql, images.sql) are located at the root of the database directory.
• Optional files/patches for upgrading database tables are located in the option-patches directory.
• Database extensions and addons are now subdirectories, named after the extension and located in the respective database directory.
• TimescaleDB-specific changes:
  • The abbreviation tsdb has been replaced by timescaledb.
  • The option-patches directory includes with-compression and without-compression subdirectories; these contain optional files/patches for upgrading database tables depending on TimescaleDB compression settings.
  • The hypertable schema creation file for TimescaleDB has been moved to database/postgresql/timescaledb/schema.sql.

Below is a comparison of the previous and current directory structures for MySQL and PostgreSQL databases.

# Previous:                                       # Current:
       
       database                                            database
       ├── mysql                                           ├── mysql
       │  ├── data.sql                                     │  ├── option-patches
       │  ├── double.sql                                   │  │  ├── double.sql
       │  ├── history_pk_prepare.sql                       │  │  └── history_pk_prepare.sql
       │  ├── images.sql                                   │  ├── data.sql
       │  └── schema.sql                                   │  ├── images.sql
       │                                                   │  └── schema.sql
       │                                                   │
       ├── postgresql                                      ├── postgresql
       │  ├── tsdb_history_pk_upgrade_no_compression       │  ├── option-patches
       │  │  ├── history_pk.sql                            │  │  ├── double.sql
       │  │  ├── history_pk_log.sql                        │  │  └── history_pk_prepare.sql
       │  │  ├── history_pk_str.sql                        │  ├── timescaledb
       │  │  ├── history_pk_text.sql                       │  │  ├── option-patches
       │  │  └── history_pk_uint.sql                       │  │  │  ├── with-compression
       │  ├── tsdb_history_pk_upgrade_with_compression     │  │  │  │  ├── history_pk.sql
       │  │  ├── history_pk.sql                            │  │  │  │  ├── history_pk_log.sql
       │  │  ├── history_pk_log.sql                        │  │  │  │  ├── history_pk_str.sql
       │  │  ├── history_pk_str.sql                        │  │  │  │  ├── history_pk_text.sql
       │  │  ├── history_pk_text.sql                       │  │  │  │  ├── history_pk_uint.sql
       │  │  └── history_pk_uint.sql                       │  │  │  │  └── trends_upgrade.sql
       │  ├── data.sql                                     │  │  │  └── without-compression
       │  ├── double.sql                                   │  │  │     ├── history_pk.sql
       │  ├── history_pk_prepare.sql                       │  │  │     ├── history_pk_log.sql
       │  ├── images.sql                                   │  │  │     ├── history_pk_str.sql
       │  ├── schema.sql                                   │  │  │     ├── history_pk_text.sql
       │  └── timescaledb.sql                              │  │  │     ├── history_pk_uint.sql
       │                                                   │  │  │     └── trends_upgrade.sql
       │                                                   │  │  └── schema.sql
       │                                                   │  ├── data.sql
       │                                                   │  ├── images.sql
       │                                                   │  └── schema.sql
       ├── ...                                             ├── ...

Please update your scripts, if any, containing the previous directory structure.

JSON протокол за проверу пасивног агента

Протокол заснован на JSON-у за пасивне провере агента је имплементиран.

За компатибилност са старијим агентима, додат је прелазак на стари протокол отвореног текста. Ако агент врати "ZBX_NOTSUPPORTED", Zabbix ће кеширати интерфејс као стари протокол и поново покушати проверу слањем само кључа ставке отвореног текста.

Zabbix get сада може да се покрене са новом опцијом -P --protocol <value> где је "vrednost" или:

• auto - повежите се користећи JSON протокол, вратите се назад и покушајте поново са протоколом отвореног текста (подразумевано);
• json - повезивање помоћу кључа JSON протокола;
• plaintext - повежите се помоћу протокола отвореног текста где се шаље само кључ ставке.

Ако кључ ставке није подржан, Zabbix get ће сада вратити излазни код 1 уместо 0.