NovýZabbix

22. 5. 2025

Zabbix Java Gateway: Instalace, tipy a monitoring Tomcatu a WildFly

Zhlédnout záznam

Výběr operačního systému

Návod obsahuje postup pro RHEL platformy na verzi 9, kde stačí případně jen poupravit repozitáře. Návod pro Debian je připraven pro verzi 12, která je aktuálně poslední podporovanou verzí.

Co je Zabbix Java Gateway?

• Samostatná komponenta Zabbixu pro monitoring Java aplikací pomocí JMX (Java Management Extensions).
• Umožňuje Zabbixu sbírat metriky přímo z Java aplikací.
• Musí být připojena k Zabbix serveru nebo Zabbix proxy.
• Je napsaná v Javě (vyžaduje Java Runtime Environment).

Doporučení pro nasazení

Pouze jedna Java Gateway na jeden Zabbix Server nebo Proxy.
(Pro více Java Gateway nasaďte další Zabbix Proxy (active/passive).)

Komunikace mezi komponentami Zabbixu a Java Gateway nemůže být šifrovaná.
Od verze 7.4 je to poslední zbývající interní komunikační kanál Zabbixu bez šifrování.

Komunikaci z Java Gateway na monitorované Java aplikace lze zabezpečit (šifrováním a/nebo autentizací).

Sjednocení verzí je kritické – Zabbix Java Gateway musí odpovídat verzi Zabbix serveru/proxy.

Nezapomeňte v konfiguraci Java Gateway (zabbix_java_gateway.conf) explicitně definovat povolené IP adresy.

Osvědčené postupy instalace

Java Runtime Environment (JRE) se automaticky nainstaluje spolu se Zabbix Java Gateway (je postavená na Javě).

Zabbix neposkytuje dedikovanou šablonu přímo pro Java Gateway – použijte obecnou Java šablonu.

Pro konkrétní Java server mohou být potřeba vlastní knihovny (JAR soubory), typicky umístěné v bin adresáři aplikace.

Správné nastavení Java pollerů je zásadní – konfigurace musí být sladěná na obou stranách:

• Zabbix Server/Proxy (počet Java pollerů)
• Zabbix Java Gateway (start pollers)

Doporučená praxe: nasadit Zabbix Java Gateway na stejný server jako Zabbix Server nebo Proxy kvůli vyšší bezpečnosti.

Instalace a self-monitoring

Now, when we are aware of basic description of what Zabbix Java Gateway is, and we have learned it’s terminology, we can proceed with the installation.

[epel]
...
excludepkgs=zabbix*

rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rocky/9/x86_64/zabbix-release-latest.el9.noarch.rpm
dnf clean all

dnf install zabbix-java-gateway

wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.0+debian12_all.deb
dpkg -i zabbix-release_latest_7.0+debian12_all.deb
apt update

apt install zabbix-java-gateway

Umístění konfiguračních souborů

• Zabbix Java Gateway

/etc/zabbix/zabbix_java_gateway.conf - hlavní konfigurační soubor
/etc/zabbix/zabbix_java_gateway_logback.xml - konfigurace logování

• Zabbix Server

/etc/zabbix/zabbix_server.conf

• Zabbix Proxy

/etc/zabbix/zabbix_proxy.conf

Povolení Zabbix Java Gateway

Po instalaci povolte Java monitoring na serveru nebo proxy úpravou konfiguračního souboru

nano /etc/zabbix/zabbix_server.conf

A upravte následující parametry, kde:

• JavaGateway: IP nebo DNS adresa Zabbix Java Gateway
• JavaGatewayPort: komunikační port
• StartJavaPollers: počet Java pollerů spouštěných na Zabbix serveru/proxy

JavaGateway=127.0.0.1
JavaGatewayPort=10052
StartJavaPollers=5

StartJavaPollers je důležitý parametr, na který je potřeba vždy myslet

• Výchozí hodnota je vypnuto (0), tedy Java monitoring je neaktivní
• Doporučená startovní hodnota: 5 pollerů
• Pokud hodnotu změníte, sladěte toto číslo také v konfiguraci Java Gateway
• Pokud používáte více Zabbix serverů/proxy s jednou gateway, sečtěte jejich počty pollerů

Po finální konfiguraci nezapomeňte restartovat komponentu Zabbix serveru

systemctl restart zabbix-server

Povolení self-monitoringu Java Gateway

Upravte konfigurační soubor Zabbix Java Gateway

nano /etc/zabbix/zabbix_java_gateway.conf

Speciální monitorovací sekce (self-monitoring):
Odkomentujte následující řádek pro povolení vestavěného JMX monitoringu samotné gateway (JAVA_OPTIONS):

JAVA_OPTIONS="$JAVA_OPTIONS -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=12345
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -
Dcom.sun.management.jmxremote.registry.ssl=false"

Důležité: Ujistěte se, že každá Java volba (-Dcom…) začíná hned za mezerou a že uvnitř nejsou žádné další mezery navíc!

Aplikujte nové nastavení, spusťte Zabbix Java Gateway a povolte její automatické spuštění po restartu serveru.

systemctl enable zabbix-java-gateway.service --now

Ověření a nastavení monitoringu

Vytvořte hosta pro samotnou Zabbix Java Gateway (nebo použijte existujícího hosta)

• Přidejte nové rozhraní typu JMX
• Aplikujte vestavěnou šablonu: Generic Java JMX

Po krátké chvíli se ikona JMX zbarví zeleně. Java Gateway je nyní připravená a monitorovaná.

Monitoring Tomcatu – instalace a nastavení

Pro tento ukázkový monitoring setup nainstalujeme také Tomcat a další potřebné balíčky.

Upozorňujeme, že následující příklad je proveden na Rocky Linux 9. Ve vašem prostředí bude Tomcat nejspíš už nainstalovaný (nebo součástí vašeho stávajícího aplikačního setupu).

dnf install tomcat tomcat-webapps tomcat-admin-webapps tomcat-docs-webapp

Po instalaci Tomcatu je potřeba povolit JMX monitoring s autentizací, abychom zajistili bezpečnost.

Upravte /etc/tomcat/tomcat.conf.

nano /etc/tomcat/tomcat.conf

Přidejte následující (nezapomeňte nahradit IP adresu – musí to být monitorovaný host, ne Zabbix server ani Java Gateway!)

V našem případě byl parametr -Djavax.sql.DataSource.Factory=org.apache.commons.dbcp.BasicDataSourceFactory už předdefinovaný, takže další parametry umístíme hned za něj. Dbejte na správné uvozovky a zalamování/odsazení pomocí \.

# Set default javax.sql.DataSource factory to apache commons one. See rhbz#1214381
JAVA_OPTS="-Djavax.sql.DataSource.Factory=org.apache.commons.dbcp.BasicDataSourceFactory \
-Dcom.sun.management.jmxremote \
-Dcom.sun.management.jmxremote.port=9010 \
-Dcom.sun.management.jmxremote.rmi.port=9010 \
-Dcom.sun.management.jmxremote.ssl=false \
-Dcom.sun.management.jmxremote.authenticate=true \
-Dcom.sun.management.jmxremote.password.file=/etc/tomcat/jmxremote.password \
-Dcom.sun.management.jmxremote.access.file=/etc/tomcat/jmxremote.access \
-Djava.rmi.server.hostname=185.74.63.152 \
-Djava.net.preferIPv4Stack=true"

Pro vytvoření JMX přístupových rolí a hesel je potřeba vytvořit nebo upravit následující soubory

Upravte (nebo vytvořte) /etc/tomcat/jmxremote.access:

nano /etc/tomcat/jmxremote.access

V tomto souboru definujeme uživatelskou roli s požadovanými oprávněními.

monitorRole readonly
controlRole readwrite

Upravte (nebo vytvořte) /etc/tomcat/jmxremote.password:

nano /etc/tomcat/jmxremote.password

V tomto souboru definujeme hesla pro uživatele nakonfigurované pro JMX přístup

monitorRole Password1
controlRole Password2

Nastavte správná oprávnění z bezpečnostních důvodů (uživatel ve vašem systému může být jiný – my používáme stejného uživatele, pod kterým běží služba Tomcat)

chmod 600 /etc/tomcat/jmxremote.*
chown tomcat:tomcat /etc/tomcat/jmxremote.*

Po úpravě všech konfiguračních souborů dle doporučení nezapomeňte restartovat službu Tomcat

systemctl restart tomcat.service

A pokud je to potřeba, otevřete port ve firewallu (9010/tcp).

firewall-cmd --permanent --add-port=9010/tcp
firewall-cmd --reload

Vytvořte ve webovém rozhraní Zabbixu hosta pro monitoring Tomcatu

• Připojte šablonu Apache Tomcat by JMX.
• Nastavte správnou IP nebo DNS adresu Tomcatu a port (ujistěte se, že firewall umožňuje přístup ze Zabbix Java Gateway). V našem případě běží Tomcat, Zabbix Server i Zabbix Java Gateway na stejném hostu, proto používáme localhost. V praxi je takové nasazení spíše nepravděpodobné.
• Nastavte správné makro (viz další screenshot).

Šablony v Zabbixu používají uživatelská makra pro uživatelské jméno a heslo. Klikněte na Macros a poté vyberte Inherited and host macros.

• {$TOMCAT.PASSWORD} – v našem případě je to Password1 (best practice: označte tuto hodnotu jako Secret text)
• {$TOMCAT.USER} – náš uživatel je monitorRole

V tuto chvíli by měly vaše monitoring položky na hostu Tomcat začít přijímat data.

Šablona také obsahuje Low-Level Discovery (LLD).

Závěrečné tipy a monitoring databáze

• Pro rychlé ladění doporučujeme použít jconsole (součást balíčku JDK), který můžete spustit na svém desktopu
• Pokud nevidíte metriky, které vás zajímají (například statistiky DB connection poolu), může být potřeba je povolit na úrovni driveru/poolu. Například lze přidat parametr jmxEnabled=“true“ – ten bývá často definovaný v context.xml

• Také se podívejte na naše webinářové PDF materiály pro více informací

The post Instalace Zabbix Java Gateway a monitoring Tomcatu appeared first on initMAX s.r.o..

Výběr operačního systému

Návod obsahuje postup pro RHEL platformy na verzi 10, kde stačí případně jen poupravit repozitáře. Návod pro Debian je připraven pro verzi 13, která je aktuálně poslední podporovanou verzí.

Než začneme

Pro účely této ukázky si nejdříve přepneme SELinux do Permissive módu.

Pokud plánujete SELinux trvale deaktivovat, můžete tak učinit úpravou konfiguračního souboru. Nicméně, doporučujeme zvážit možnost naučit se s SELinuxem pracovat a využít jeho bezpečnostní výhody. Podrobné informace o správném nastavení a monitorování SELinuxu naleznete v našem samostatném článku.​

setenforce 0

Instalace PostgreSQL

V prvním kroku si naistalujeme repozitáře pro PostgreSQL a zakážeme výchozí, systémové PostgreSQL repozitáře.

dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-10-x86_64/pgdg-redhat-repo-latest.noarch.rpm
dnf -qy module disable postgresql

Následně pak nainstalujeme PostgreSQL, v tomto případě to bude aktuálně podporovaná verze 18.

dnf install -y postgresql18-server

Inicializujeme databázi a nastavíme její automatické spouštění.

/usr/pgsql-18/bin/postgresql-18-setup initdb
systemctl enable postgresql-18 --now

Instalace Zabbix serveru a jeho součástí

Databáze je nyní nainstalovaná, a můžeme tedy přikročit k instalaci Zabbix serveru a všech jeho součástí.

Nejprve si z repozitáře EPEL vyloučíme jakékoliv instalační balíčky týkající se Zabbixu. Za předpokladu, že je nainstalován.

To provedeme tak, že na konec souboru /etc/yum.repos.d/epel.repo vložíme následující řádek:

[epel]
...
excludepkgs=zabbix*

Přidáme si repozitáře Zabbixu a vyčistíme instalační cache.

rpm -Uvh https://repo.zabbix.com/zabbix/8.0/release/rocky/10/noarch/zabbix-release-latest.el10.noarch.rpm
dnf clean all

A nainstalujeme všechny potřebné součásti Zabbixu.

V tomto případě použijeme jako primárního monitorovacího agenta Zabbix Agent 2, který vám doporučujeme používat, jelikož přináší daleko více funkcionalit.

dnf install zabbix-server-pgsql zabbix-web-pgsql zabbix-apache-conf zabbix-sql-scripts zabbix-agent2 zabbix-web-service

Inicializace databáze

Nejprve vytvoříme databázového uživatele pro Zabbix, budeme vyzváni k zadání jeho přístupového hesla.

cd /tmp
sudo -u postgres createuser --pwprompt zabbix

V tuto chvíli jsme schopni naimportovat výchozí schéma a data. Opět budeme vyzváni k zadání hesla.
Zde použijeme heslo z předchozího kroku.

sudo -u postgres createdb -O zabbix zabbix
zcat /usr/share/zabbix/sql-scripts/postgresql/server.sql.gz | sudo -u zabbix psql zabbix

Nastavení firewallu

Nazávěr na firewallu povolíme porty, které jsou nezbytné pro běh Zabbix serveru.

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-port=10051/tcp
firewall-cmd --reload

Instalace TimescaleDB

Nejčistší varianta je instalace z oficiálních TimescaleDB/TigerData repozitářů, jenže pro EL/10 zatím nejsou (v našem případě) potřebné balíčky k dispozici. Proto použijeme malý workaround přes oficiální PGDG non-free repo, abychom mohli nainstalovat Community/TSL variantu.

Jakmile budou balíčky pro EL/10 v oficiálním TimescaleDB repozitáři dostupné, přejdeme na něj (a tenhle workaround už nebude potřeba).

Přidání repozitářů (PGDG non-free)

dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/non-free/EL-10-x86_64/pgdg-redhat-nonfree-repo-latest.noarch.rpm

Instalace TimescaleDB (TSL / Community)

dnf install timescaledb-tsl_18

Dále si nainstalujeme timescaledb-tune. V ideálním případě bychom použili oficiální TimescaleDB balíčky, kde bývá tento nástroj součástí distribuce, ale protože na EL/10 zatím jedeme workaround přes PGDG, doinstalujeme ho zvlášť.

dnf install -y golang

# nainstaluje binary do /usr/local/sbin
GOBIN=/usr/local/sbin go install github.com/timescale/timescaledb-tune/cmd/timescaledb-tune@latest

Spustíme utilitu timescaledb-tune a jako parametr jí předáme vyšší hodnotu maximálního množství připojení (--max-conns), které pro tyto testovací účely nastavíme na 125.

Tato utilita slouží k přizpůsobení výchozího nastavení PostgreSQL vůčihledně výkonu a adekvátnímu nastavení parametrů PostgreSQL pro fungování s TimescaleDB.

Zároveň nám tato utilit pomocí instalačního průvodce pomůže vybrat aktuální a platný konfigurační soubor PostgreSQL a nastaví i automatické načítání knihoven TimescaleDB.

Prosím, odpovídejte „ano“ (y) na všechny otázky. Pozor, automatický tuner předpokládá, že PostgreSQL běží na samostatném serveru, a proto může být potřeba případně upravit parametry.

timescaledb-tune --pg-config /usr/pgsql-18/bin --max-conns=125

Následně restartujeme systémovou službu pro PostgreSQL:

systemctl restart postgresql-18.service

Zbývá již jen vytvořit a aktivovat samotnou TimescaleDB:

Pozor: Během vývoje došlo ke změně cesty z původní /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql na novou /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql.

echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix
cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix

Nastavení Zabbix serveru

Otevřeme konfigurační soubor Zabbix serveru v cestě:

nano /etc/zabbix/zabbix_server.conf

V tomto konfiguračním souboru upravíme následující parametry tak, jak vídíte na předloze níže:

...
DBPassword=password
StartReportWriters=1
WebServiceURL=http://localhost:10053/report
...

V dalším kroku doinstalujeme všechny jazykové balíčky pro Zabbix frontend:

dnf install glibc-langpack-en glibc-langpack-cs glibc-langpack-sk glibc-langpack-fr glibc-langpack-de glibc-langpack-es glibc-langpack-it glibc-langpack-zh glibc-langpack-pt glibc-langpack-da glibc-langpack-nb glibc-langpack-pl glibc-langpack-tr glibc-langpack-he glibc-langpack-ja glibc-langpack-ko glibc-langpack-ru glibc-langpack-uk glibc-langpack-ca glibc-langpack-ka glibc-langpack-vi glibc-langpack-uz

A nakonec restartujeme všechny související služby a nastavíme je tak, aby se spouštěly automaticky po startu:

systemctl restart zabbix-server zabbix-web-service zabbix-agent2 httpd php-fpm
systemctl enable zabbix-server zabbix-web-service zabbix-agent2 httpd php-fpm

Pro ověření stavu, že nám Zabbix server nastartoval v pořádku můžeme kromě jiného zkontrolovat i jeho log soubor:

less /var/log/zabbix/zabbix_server.log

V případě, že uvidíte v log souboru zprávu o tom, že je verze TimescaleDB příliš nová, pak to není žádný velký problém. Zabbix nedokáže dostatečně rychle reagovat na nejnovější verze TimescaleDB tak, aby ji ve svém kódu nastavil jako podporovanou, ovšem kompatibilita je Zabbixem zaručena a námi ověřena.

V případě této chyby stačí otevřít konfigurační soubor Zabbix serveru v cestě /etc/zabbix/zabbix_server.conf a zde upravte následující konfigurační parametr:

AllowUnsupportedDBVersions=1

Soubor s tímto nastavením uložte a zrestartujte systémovou službu Zabbix serveru.

systemctl restart zabbix-server

Nastavení Zabbix frontendu

V prohlížeči si otevřeme cílové URL, na kterém Zabbix běží. Například tedy http://192.168.0.50/zabbix, kde nás uvítá průvodce prvotní instalací.

Po zvolení implicitního jazyka se tlačítkem Next step posuneme na stránku s kontrolou minimálních požadavků.

Pokud je kontrola v pořádku, pak se tedy můžeme kliknutím na Next step posunout na další stránku s nastavením připojení do databáze.

Zde vyplňujeme pouze políčko Password pro přístup do databáze, nic dalšího není třeba měnit.

Po vyplnění opět klikneme na Next step.

Na následující stránce se základním nastavením vyplníme název serveru, časové pásmo, a kliknutím na Next step pokračujeme k souhrnu konfigurace.

V tomto souhrnu zkontrolumeme všechny zadané hodnoty a kliknutím na Next step dokončíme instalaci.

Nyní již kliknutím na tlačítko Finish přejdeme na přihlašovací obrazovku.

Po úspěšném přihlášení pomocí dříve zadaných údajů můžeme začít používat nejnovější Zabbix verze 8.0 (Admin/zabbix).

A takto vypada úvodní dashboard nového Zabbixu 8.0:

Nastavení Zabbix reportingu

Proto, aby byl plně funkční reporting se všemi jeho vylepšeními si nejprve musíme nainstalovat Google Chrome.

Následujícím příkazem stáhneme instalační balíček, a ten také nainstalujeme:

wget https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm
dnf localinstall google-chrome-stable_current_x86_64.rpm

V dalším kroku upravíme v Zabbix frontendu parametr „Frontend URL“ na aktuálně platnou hodnotu, toto nastavení se nachází zde:

Administration -> General -> Other

Příklad této konfigurace pak můžete vidět na obrázku níže.

---

Instalace závislostí

apt install sudo gpg curl wget

Instalace PostgreSQL

V prvním kroku si nainstalujeme repozitáře pro PostgreSQL a zakážeme výchozí systémové repozitáře PostgreSQL. Na otázku ‚This script will enable the PostgreSQL APT repository on apt.postgresql.org on
your system. The distribution codename used will be trixie-pgdg.‚ stiskněte Enter pro pokračování a potvrzení instalace z oficiálního repozitáře.

apt install -y postgresql-common
/usr/share/postgresql-common/pgdg/apt.postgresql.org.sh

Následně pak nainstalujeme PostgreSQL, v tomto případě to bude aktuálně podporovaná verze 18.

apt -y install postgresql-18

Nastartování PostgreSQL a nastavení automatického spuštění při startu systému

systemctl enable postgresql --now

Instalace Zabbix serveru a jeho součástí

Databáze je nyní nainstalovaná, a můžeme tedy přikročit k instalaci Zabbix serveru a všech jeho součástí.

Přidáme si repozitáře Zabbixu a vyčistíme instalační cache.

wget https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/zabbix-release_latest_8.0+debian13_all.deb
dpkg -i zabbix-release_latest_8.0+debian13_all.deb
apt update

A nainstalujeme všechny potřebné součásti Zabbixu.

V tomto případě použijeme jako primárního monitorovacího agenta Zabbix Agent 2, který vám doporučujeme používat, jelikož přináší daleko více funkcionalit.

apt install zabbix-server-pgsql zabbix-frontend-php php8.4-pgsql zabbix-apache-conf zabbix-sql-scripts zabbix-agent2 zabbix-web-service

Inicializace databáze

Nejprve vytvoříme databázového uživatele pro Zabbix. Během procesu budeme vyzváni k zadání jeho přístupového hesla. Dále vytvoříme prázdnou databázi a nastavíme jí příslušná oprávnění.

sudo -u postgres createuser --pwprompt zabbix
sudo -u postgres createdb -O zabbix zabbix

V tuto chvíli jsme schopni naimportovat výchozí schéma a data. Opět budeme vyzváni k zadání hesla.
Zde použijeme heslo z předchozího kroku.

zcat /usr/share/zabbix/sql-scripts/postgresql/server.sql.gz | sudo -u zabbix psql zabbix

Instalace TimescaleDB

Nyní se pustíme do instalace TimescaleDB a začneme tím, že přidáme její oficiální repozitář.

echo "deb https://packagecloud.io/timescale/timescaledb/debian/ $(lsb_release -c -s) main" | sudo tee /etc/apt/sources.list.d/timescaledb.list
wget --quiet -O - https://packagecloud.io/timescale/timescaledb/gpgkey | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/timescaledb.gpg

Nainstalujme TimescaleDB.

apt update
apt install timescaledb-2-postgresql-18 timescaledb-2-loader-postgresql-18

Spustíme utilitu timescaledb-tune a jako parametr jí předáme vyšší hodnotu maximálního množství připojení (--max-conns), které pro tyto testovací účely nastavíme na 125.

Tato utilita slouží k přizpůsobení výchozího nastavení PostgreSQL vůčihledně výkonu a adekvátnímu nastavení parametrů PostgreSQL pro fungování s TimescaleDB.

Zároveň nám tato utilit pomocí instalačního průvodce pomůže vybrat aktuální a platný konfigurační soubor PostgreSQL a nastaví i automatické načítání knihoven TimescaleDB.

Prosím, odpovídejte „ano“ (y) na všechny otázky. Pozor, automatický tuner předpokládá, že PostgreSQL běží na samostatném serveru, a proto může být potřeba případně upravit parametry.

timescaledb-tune --pg-config /usr/bin --max-conns=125

Následně restartujeme systémovou službu pro PostgreSQL:

systemctl restart postgresql

Zbývá již jen vytvořit a aktivovat samotnou TimescaleDB:

echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix
cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix

Nastavení Zabbix serveru

Otevřeme konfigurační soubor Zabbix serveru v cestě:

nano /etc/zabbix/zabbix_server.conf

V tomto konfiguračním souboru upravíme následující parametry tak, jak vídíte na předloze níže:

...
DBPassword=password
StartReportWriters=1
WebServiceURL=http://localhost:10053/report
...

V dalším kroku nastavíme jazykové balíčky pro Zabbix frontend. Můžete zvolit pouze ty, které potřebujete, nebo povolit všechny.

sed -i '/# en_US.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# en_GB.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# cs_CZ.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# sk_SK.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# fr_FR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# de_DE.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# es_ES.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# it_IT.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# zh_CN.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# pt_PT.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# pt_BR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# da_DK.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# nb_NO.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# pl_PL.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# tr_TR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# he_IL.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ja_JP.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ko_KR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ru_RU.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# uk_UA.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ca_ES.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ka_GE.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# uz_UZ.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# vi_VN UTF-8/s/^# //' /etc/locale.gen
locale-gen

A nakonec restartujeme všechny související služby a nastavíme je tak, aby se spouštěly automaticky po startu:

systemctl restart zabbix-server zabbix-web-service zabbix-agent2 apache2
systemctl enable zabbix-server zabbix-web-service zabbix-agent2 apache2

Pro ověření stavu, že nám Zabbix server nastartoval v pořádku můžeme kromě jiného zkontrolovat i jeho log soubor:

less /var/log/zabbix/zabbix_server.log

V případě, že uvidíte v log souboru zprávu o tom, že je verze TimescaleDB příliš nová, pak to není žádný velký problém. Zabbix nedokáže dostatečně rychle reagovat na nejnovější verze TimescaleDB tak, aby ji ve svém kódu nastavil jako podporovanou, ovšem kompatibilita je Zabbixem zaručena a námi ověřena.

V případě této chyby stačí otevřít konfigurační soubor Zabbix serveru v cestě /etc/zabbix/zabbix_server.conf a zde upravte následující konfigurační parametr:

AllowUnsupportedDBVersions=1

Soubor s tímto nastavením uložte a zrestartujte systémovou službu Zabbix serveru.

systemctl restart zabbix-server

Nastavení Zabbix frontendu

V prohlížeči si otevřeme cílové URL, na kterém Zabbix běží. Například tedy http://192.168.0.50/zabbix, kde nás uvítá průvodce prvotní instalací.

Po zvolení implicitního jazyka se tlačítkem Next step posuneme na stránku s kontrolou minimálních požadavků.

Pokud je kontrola v pořádku, pak se tedy můžeme kliknutím na Next step posunout na další stránku s nastavením připojení do databáze.

Zde vyplňujeme pouze políčko Password pro přístup do databáze, nic dalšího není třeba měnit.

Po vyplnění opět klikneme na Next step.

Na následující stránce se základním nastavením vyplníme název serveru, časové pásmo, a kliknutím na Next step pokračujeme k souhrnu konfigurace.

V tomto souhrnu zkontrolumeme všechny zadané hodnoty a kliknutím na Next step dokončíme instalaci.

Nyní již kliknutím na tlačítko Finish přejdeme na přihlašovací obrazovku.

Po úspěšném přihlášení pomocí dříve zadaných údajů můžeme začít používat nejnovější Zabbix verze 8.0 (Admin/zabbix).

A takto vypada úvodní dashboard nového Zabbixu 8.0:

Nastavení Zabbix reportingu

Proto, aby byl plně funkční reporting se všemi jeho vylepšeními si nejprve musíme nainstalovat Google Chrome.

Následujícím příkazem stáhneme instalační balíček, a ten také nainstalujeme:

curl -fSsL https://dl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor | sudo tee /usr/share/keyrings/google-chrome.gpg >> /dev/null
echo deb [arch=amd64 signed-by=/usr/share/keyrings/google-chrome.gpg] http://dl.google.com/linux/chrome/deb/ stable main | sudo tee /etc/apt/sources.list.d/google-chrome.list
apt update
apt install google-chrome-stable

V dalším kroku upravíme v Zabbix frontendu parametr „Frontend URL“ na aktuálně platnou hodnotu, toto nastavení se nachází zde:

Administration -> General -> Other

Příklad této konfigurace pak můžete vidět na obrázku níže.

Dokončovací práce

• Zkontrolujte, že správně běží Zabbix server, databázový server a mají správnou verzi

Podpora pro Item Browser

Veškeré potřebné kroky naleznete v samostatném návodu na naší wiki.

NovýZabbix

21. 6. 2024

7.0 Workshop: Zabbix 7.0 – Monitorování pomocí Browser Item pomocí aplikace Selenium

Zhlédnout záznam

Vlastní rebranding

Veškeré potřebné kroky naleznete v samostatném návodu na naší wiki.

The post Zabbix 8.0 LTS – návod na instalaci v 5 minutách appeared first on initMAX s.r.o..

Meta Developer účet

• Pokud již máte Facebook účet, přejděte na developers.facebook.com a přihlaste se svým osobním Facebook účtem.
• Pokud Facebook účet nemáte, založte si jej na facebook.com pomocí e-mailu nebo telefonu.
• Následně na developers.facebook.com klikněte na „Get Started“, ověřte e-mail a telefon, a akceptujte podmínky pro vytvoření Meta Developer účtu.

Vytvoření aplikace s WhatsApp produktem

Klikněte My Apps

Dále klikněte na Create App

Vyplňte název aplikace (např. Whats-Zabbix).

Vyplňte kontaktní e-mail aplikace (existující e-mailová adresa).

Z use-case vybereme možnost „Ostatní“.

Pro přístup k části WhatsApp je potřeba zvolit typ aplikace „Firemní“.

Znovu vyplníme název aplikace a e-mail, portfolio prozatím necháme prázdné.

Po vytvoření kostry aplikace k ní přidáme produkt WhatsApp, o který nám jde.

Pravděpodobně pro nás neexistuje žádné vhodné portfolio, proto jej vytvoříme. Pokud však již vhodné portfolio existuje, můžete ho vybrat a tuto část přeskočit.

V kroku pro vytvoření portfolia vyplňte název firmy a účtu, dále pak vaše jméno a firemní e-mail. (Omlouváme se, ale nepodařilo se nám zajistit screenshot v anglické verzi.)

V dalším kroku už jen počkáte na potvrzení. Pokud je váš účet příliš nový, je možné, že budete muset počkat až jednu hodinu, než bude možné portfolio vytvořit.

Když se nyní znovu podíváme do naší aplikace, v části WhatsApp > API Setup se nám nově zobrazí naše portfolio, které potvrdíme.

Hned poté se nám objeví naše WhatsApp aplikace a její údaje.

Přidání čísel pro notifikace

Protože se jedná o free verzi aplikace, je nutné předem zadat čísla, na která budeme chtít zasílat notifikace (může jich být maximálně 5). Pokud bychom použili vlastní ověřené telefonní číslo, tento krok by nebyl nutný, ale aplikace by již nebyla zdarma.

Telefonní číslo vygenerované společností Meta slouží primárně pro testování, ale bez problémů jej můžeme použít i pro naše zamýšlené notifikace. Jediným omezením je nutnost každých 90 dní prodloužit používání tohoto čísla. Toto omezení se netýká vlastních ověřených telefonních čísel.

Zde si rovnou poznamenáme naše „Phone Number ID“, které budeme později potřebovat pro vytvoření „Media Template“ v Zabbixu.

Následně zadáte vaše telefonní číslo pro WhatsApp. Do aplikace WhatsApp na tomto čísle vám přijde zpráva s číselným ověřovacím kódem.

Po chvíli by vám do aplikace WhatsApp mělo přijít ověřovací číslo, které vyplníte do formuláře. Stejným způsobem postupujte i pro další případná telefonní čísla. Pozor, tato čísla je nutné zadat ještě před jejich použitím pro zasílání notifikací ze Zabbixu.

Odeslání první testovací zprávy

Pro odeslání naší první testovací zprávy už máme připraveno vše důležité a můžeme využít přímo aplikační formulář pro testování. Pro tento první test nám však ještě chybí zásadní věc – přístupový token.

Tento token si můžeme vygenerovat přímo zde, ale pozor: token má platnost pouze 1 hodinu. Proto jej nepoužívejte jako trvalý token pro Zabbix!

Nejprve klikneme na tlačítko „Generate access token“.

V nově otevřeném pop-up okně potvrdíme přihlášení pod naším uživatelským účtem.

Na další stránce potvrdíme udělení přístupu pro naši aplikaci.

Odsouhlasíme souhrn oprávnění.

Počkáme na dokončení operace a poté okno zavřeme.

Po spárování uživatelského účtu se nám konečně vygeneruje token.

• První řádek obsahuje náš token (znovu připomínáme, že jeho platnost je pouze 1 hodina!).
• Naše odchozí (testovací) telefonní číslo
• Telefonní číslo, na které budeme odesílat testovací notifikaci
• Tlačítko pro odeslání naší testovací notifikace

Po kontrole všech polí můžete kliknout na tlačítko „Send message“. Během několika okamžiků by vám měla přijít testovací zpráva.

Úprava meta šablony „hello_world“

Na stejné stránce, kde jste přidávali telefonní čísla, najdete níže v bodě č. 5 modře uvedený odkaz „see the Overview page“. Tento odkaz si otevřete v novém okně – jedná se o nejjednodušší způsob, jak se rychle dostat k nastavení šablon zpráv.

Šablony nastavujeme z jednoduchého důvodu – WhatsApp Cloud API neumožňuje zasílat libovolné zprávy na neověřená telefonní čísla. Pomocí šablon proto využíváme workaround, kdy předem určíme, jak bude zpráva vypadat.

Pro neověřená (testovací) telefonní čísla máme k dispozici pouze jednu předdefinovanou šablonu, konkrétně „hello_world“. Pokud bychom použili vlastní ověřené telefonní číslo, můžeme si vytvořit šablony vlastní – například různé varianty dle závažnosti s barevnou hlavičkou či speciální šablonu pro zprávy informující o vyřešení problému.

Zde klikneme na „Manage templates“.

Klikneme na naši šablonu „hello_world“.

Klikneme na tlačítko „Edit template“.

V první sekci zkontrolujeme ale neměníme jazyk šablony („Select language“).

Dále budeme vyplňovat sekce „Header“, „Body“ a „Footer“.

Pozor: Zde buďte velmi opatrní – šablonu lze upravit pouze jednou za 24 hodin! Použijte náš přiložený příklad („example“) a případně upravte jen doménu svého Zabbixu.

Přepněte typ proměnné („Variable“) na „Name“.

Obsah pro sekci „Header“:

{{event_status}}

Obsah pro sekci „Body“:

*Problem name:* {{event_name}}
*Problem started* at {{event_time}} on {{event_date}}
*Host:* {{host_name}}
*Severity:* {{event_severity}}
*Operational data:* {{item_lastvalue}}
*Original problem ID:* {{event_id}}

Do příkladu pro obsah vložte naše vzorová data:

• {{event_name}} Windows: Operating system description has changed
• {{event_time}} 10:57:12
• {{event_date}} 28.4.2025
• {{host_name}} DC1
• {{event_severity}} Information
• {{item_lastvalue}} version123
• {{event_id}} 123

Obsah pro sekci „Footer“:

WhatsAPP notification developed by initMAX s.r.o.

Naši šablonu rovnou rozšíříme o odkaz na zobrazení problému podle jeho jména a další odkaz na zobrazení posledních naměřených hodnot.

Do prvního odkazu vložíme název „Visit problem page“. Do URL vložíme náš odkaz bez posledního parametru – ten tam automaticky doplní META.

Pozor: URL adresu si upravte podle své vlastní!

https://www.initmax.cz/zabbix/zabbix.php?action=problem.view&filter_set=1&name=

• Priklad URL pro overeni: https://www.initmax.cz/zabbix/zabbix.php?action=problem.view&filter_set=1&name=problem

Do druhého odkazu vložíme název „Check latest data“. Do URL vložíme náš odkaz bez posledního parametru – ten tam automaticky doplní META.

Pozor: URL adresu si upravte podle své vlastní!

https://www.initmax.cz/zabbix/history.php?action=showgraph&itemids%5B%5D=

• Priklad URL pro overeni: https://www.initmax.cz/zabbix/history.php?action=showgraph&itemids%5B%5D=12344

V pravém rohu obrazovky můžete vidět náhled předgenerované zprávy. Vše si pečlivě zkontrolujte!

Posledním krokem je uložení šablon. Po jejich uložení je po dobu následujících 24 hodin nebudete moci upravovat! Proto je velmi důležité vše zkontrolovat a udělat správně hned napoprvé.

Generování dlouhodobého systémového tokenu

Na straně Meta providera máme nyní vše připravené a ověřené. Nyní je čas přesunout se do Zabbixu. Protože ale pro naše notifikace potřebujeme token, který ideálně neexpiruje, pustíme se ještě do jeho vygenerování.

Toto nastavení provedeme na stránce https://business.facebook.com/, kde se přesuneme do sekce:

Settings → Users → System Users

Zde klikneme na tlačítko „+ Add“.

Zde vytvoříme uživatele. V našem případě můžete zvolit název například „Zabbix-WhatsApp“. Pro jeho systémovou roli stačí zvolit úroveň „Employee“ – nedávejte mu administrátorská oprávnění!

Po vytvoření uživatele mu musíme přidělit příslušná oprávnění k aplikaci.

Oprávnění nastavíme pomocí tlačítka se třemi tečkami („…“).

V části „Apps“ vybereme naši aplikaci a nastavíme maximální dostupná oprávnění (při testování s nižší úrovní oprávnění se nám nepodařilo aplikaci úspěšně provozovat).

Totéž platí i pro sekci „WhatsApp accounts“.

V dalším okně počkáme na potvrzení a následně jej zavřeme tlačítkem „Done“.

Po nastavení uživatelských oprávnění k aplikacím můžeme nakonec kliknout na „Generate token“.

V prvním kroku vybereme naši WhatsApp aplikaci.

V dalším kroku nastavíme platnost tokenu („Token expiration“). Pro bezpečný a bezproblémový provoz zvolíme možnost „Never“ (token tedy nikdy neexpiruje).

V sekci opravneni tokenu pro apliaci zvolime jen tyto 2 opravneni

• whatsapp_business_messaging
• whatsapp_business_management

V posledním kroku se nám zobrazí náš vygenerovaný token. Tento token si pečlivě uložte, protože později jej nebude možné znovu zobrazit – pouze vygenerovat nový.

Tento token budeme potřebovat jako druhou a zároveň poslední položku pro nastavení media typu v Zabbixu.

Import YAML média typu do Zabbixu

Připravili jsme pro vás šablonu pro WhatsApp. Tuto šablonu naleznete zde:
https://git.initmax.cz/initMAX-Public/zabbix-templates

Následně staženou šablonu importujte do Zabbixu:

Alerts → Media types → Import

Vyberte staženou šablonu a klikněte na „Import“.

Po úspěšném importu se vám zobrazí hláška „Imported successfully“. Následně klikněte na naši šablonu, kde dokončíme její nastavení.

Zde je potřeba vyplnit dva parametry:

• access_token: Zde vložte váš permanentní token, který jste získali v předchozím kroku v kapitole „Generování dlouhodobého systémového tokenu“.
• phone_number_id: Zde vložte číselné ID uvedené v kapitole „Přidání čísel pro notifikace“ – toto ID najdete hned pod vaším testovacím číslem.

Následně nastavení uložíme. Poté můžeme naši notifikaci rovnou otestovat přímo v Zabbixu pomocí tlačítka „Test“.

Testování notifikace v Zabbixu

Využijeme testovací tlačítko, které je přímo dostupné u našeho média.

Ve formuláři vyplníme naše telefonní číslo. Toto číslo se musí shodovat s číslem, které jsme přidali v sekci „Přidání čísel pro notifikace“. Následně klikneme na tlačítko „Test“.

Výstup by měl vrátit zprávu „Media type test successful.“ a ve spodní části „Response: OK“.

Příklad přijaté testovací notifikace se vzorovými daty. Na screenshotu vidíme nevyplněná vestavěná makra Zabbixu (např. {EVENT.NAME}, {HOST.NAME}), což je v pořádku, protože se jedná o testovací zprávu. Při reálném použití budou tato pole správně vyplněna.

Použití u uživatelů

Nezapomeňte jako poslední krok přidat nový media typ vašim uživatelům. V rámci free režimu je doporučeno přidávat média ručně. Je sice možné použít i JIT (Just-in-time provisioning), ale protože je v tomto režimu limit maximálně 5 telefonních čísel a zároveň musíte čísla ručně registrovat a ověřovat, doporučujeme tuto konfiguraci provádět manuálně.

Příklad nastavení vidíte zde. Nezapomeňte telefonní čísla vždy zadávat v úplném formátu včetně mezinárodní předvolby (např. +420…).

Rozdíly mezi Free Sandboxem a Produkční verzí WhatsApp Cloud API

⚠️ Co se stane po 90 dnech s testovacím číslem?

U testovacího čísla, které získáte od společnosti Meta, platí omezení, že každých 90 dní je nutné jeho platnost prodloužit.

• Pokud číslo včas neprodloužíte:
  • Nebudete moci posílat ani přijímat zprávy.
  • Bude nutné číslo opětovně aktivovat (prodloužit) přímo v nastavení Meta Developer účtu.
• Doporučení:
  • Pravidelně kontrolujte stav čísla.
  • Ideálně přejděte na vlastní produkční číslo, abyste se vyhnuli nutnosti pravidelných obnov.

The post Zabbix a WhatsApp – Integrace notifikací appeared first on initMAX s.r.o..

Důvody pro skrytí login formuláře

• Bezpečnostní opatření
• Omezení přístupu na veřejně dostupný login
• Přesměrování na vlastní autentizační systém

Technické řešení

Rebranding Zabbixu je možné provést bez nutnosti zasahovat do zdrojových kódů aplikace. Díky tomu je taková úprava bezpečná a bez problémů přežije i případné aktualizace Zabbixu na novější verze.

Celý proces spočívá v úpravě nebo vytvoření konfiguračního souboru brand.conf.php, který by měl být typicky umístěn zde:

Pro verzi 7.0 a starší

/usr/share/zabbix/local/conf/brand.conf.php

Pro verzi 7.2 a novější

/usr/share/zabbix/ui/local/conf/brand.conf.php

Příklad 1 – Minimalistický login – pouze SAML nebo guest

Ukázka konfigurace Zabbixu, kdy je standardní přihlášení (uživatelské jméno, heslo a tlačítko) kompletně skryté a k dispozici jsou pouze možnosti přihlášení přes SAML nebo jako host (guest). Ideální řešení pro prostředí s centrálním řízením identity.

Poznámka: Tato konfigurace předpokládá, že máte v Zabbixu již aktivní ověřování pomocí SAML a současně povolený účet hosta. Pokud tyto podmínky nejsou splněny, zobrazí se uživatelům pouze logo bez jakékoliv možnosti přihlášení.

Nastavení brand.conf.php

Vytvořte nebo upravte soubor brand.conf.php:

Pro verzi 7.0 a starší

sudo nano /usr/share/zabbix/local/conf/brand.conf.php

Pro verzi 7.2 a novější

sudo nano /usr/share/zabbix/ui/local/conf/brand.conf.php

Příklad obsahu souboru:

<?php
// Check if the current page is the main login page (index.php)
$is_index = substr($_SERVER['SCRIPT_NAME'], -10) === '/index.php';
// Basic rebranding configuration array
$brand_conf = [
    // Custom branding options go here (logo, footer, help link) - Explained in another topic
];

// If the current page is not the main login page, return default branding
if (!$is_index) {
    return $brand_conf;
}

// CSS to hide standard login fields (username, password) and login button, leaving only guest/SAML login options visible
$css = <<<'CSS'
.signin-container form ul {
    li:has([name="name"]),
    li:has([name="password"]),
    li:has(#autologin),
    li:has(button[type="submit"]) {
        display: none !important;
    }
    li.sign-in-txt:has(a[href="index.php?enter=guest"]) { display: flex; flex-direction: column-reverse; }
    li.sign-in-txt a[href="index.php?enter=guest"] { width: fit-content; margin: 0 auto 10px; }
    li.sign-in-txt a[href="index.php?enter=guest"]:hover { width: fit-content; margin: 0 auto 9px; }
}
CSS;

// Inject custom CSS into the footer branding configuration
$brand_conf['BRAND_FOOTER'] = [$brand_conf['BRAND_FOOTER']??null, new CTag('style', true, $css)];

// Return the final branding configuration
return $brand_conf;

V případě potřeby můžete jednotlivé části zakomentovat pomocí dvou obrácených lomítek //.

Co znamenají jednotlivé části v PHP kódu?

• $is_index – Zjišťuje, zda se uživatel nachází na hlavní přihlašovací stránce (index.php).
• $brand_conf – Pole obsahující konfiguraci vzhledu (loga, patička, odkazy).
• $css – Vlastní CSS styly pro skrytí standardních přihlašovacích prvků na stránce.
• BRAND_FOOTER – Umožňuje vložení vlastního obsahu (např. stylů nebo textů) do patičky stránky.

Nastavení oprávnění

Ujistěte se, že soubory a složky mají správná oprávnění a vlastníka (obvykle www-data nebo apache, v závislosti na konfiguraci webového serveru):

Pro verzi 7.0 a starší

sudo chown www-data:www-data /usr/share/zabbix/local/conf/brand.conf.php
sudo chmod 644 /usr/share/zabbix/local/conf/brand.conf.php

Pro verzi 7.2 a novější

sudo chown -R www-data:www-data /usr/share/zabbix/ui/local/conf/brand.conf.php
sudo chmod 644 /usr/share/zabbix/ui/local/conf/brand.conf.php

Příklad 2 – Přizpůsobený branding s oddělenými možnostmi přihlášení

Tento příklad ukazuje komplexnější úpravu login stránky Zabbixu. Obsahuje vlastní logo, barevné odlišení jednotlivých typů přihlášení a doplněné informační texty. Praktické pro organizace, které používají více způsobů autentizace současně.

Nastavení brand.conf.php

Vytvořte nebo upravte soubor brand.conf.php:

Pro verzi 7.0 a starší

sudo nano /usr/share/zabbix/local/conf/brand.conf.php

Pro verzi 7.2 a novější

sudo nano /usr/share/zabbix/ui/local/conf/brand.conf.php

Příklad obsahu souboru:

<?php
// Check if the current page is the main login page (index.php)
$is_index = substr($_SERVER['SCRIPT_NAME'], -10) === '/index.php';

// Basic rebranding configuration array
$brand_conf = [
    // Custom branding options go here (logo, footer, help link) - Explained in another topic
];

// If the current page is not the main login page, return default branding
if (!$is_index) {
    return $brand_conf;
}

$sso_url = (new CUrl('index_sso.php'))->setArgument('request', getRequest('request'))->getUrl();
// Customize footer branding by adding CSS and injecting custom HTML template and JS
$brand_conf['BRAND_FOOTER'] = [
    // Include existing footer branding content if set, otherwise null
    $brand_conf['BRAND_FOOTER'] ?? null,
    // Custom CSS to hide the original SAML login link
    new CTag('style', true, <<<'CSS'
.signin-container form ul {
    li.sign-in-txt:has(a[href="index_sso.php"]) { display: none; }
}
CSS),
    // HTML template to insert new login elements (SAML and standard login sections)
    (new CTag('template', true, [
        new CListItem((new CTag('h2', true, _('SAML login')))->addStyle('text-align:center; color:#0d142d;')),
        // Description text for SAML login (e.g., for company employees)
        new CListItem((new CDiv('Prefered way of login for initMAX employee'))->addStyle('text-align:center; color:#A9A9A9;')),
        // Button for SAML Single Sign-On login
        new CListItem((new CSimpleButton(_('Sign in with Single Sign-On (SAML)')))->onClick("window.location = '{$sso_url}'")->addStyle('background-color: #0d142d;border-color: #0d142d;')),
        // Divider line with "or" between login methods
        (new CListItem([
            (new CTag('hr'))->addStyle('width: 44%'),
            (new CSpan(_('or')))->addStyle('text-transform: uppercase;'),
            (new CTag('hr'))->addStyle('width: 44%'),
        ]))->addStyle('display: flex;'),
        // Title for Standard login section
        new CListItem((new CTag('h2', true, _('Standard login')))->addStyle('text-align:center; color:#0d142d;')),
        // Description text for standard login (e.g., for customers)
        new CListItem((new CDiv('Customer login'))->addStyle('text-align:center; color:#A9A9A9;')),
    ]))->setId('initmax-login-template'),
    // JavaScript code to insert the prepared HTML template elements into the existing login form
    new CTag('script', true, <<<'JS'
for (const el of [...document.querySelector('#initmax-login-template').content.children].reverse()) document.querySelector('form ul').prepend(el);
JS)
];

// Return the final branding configuration with all customizations applied
return $brand_conf;

V případě potřeby můžete jednotlivé části zakomentovat pomocí dvou obrácených lomítek //.

Co znamenají jednotlivé části v PHP kódu?

• $is_index – Zjišťuje podle aktuální URL, zda se uživatel nachází na hlavní přihlašovací stránce (index.php).
• $brand_conf – Pole obsahující konfiguraci vzhledu (loga, patička, odkazy).
• $sso_url – Dynamicky sestavená URL pro přesměrování uživatele na SAML Single Sign-On přihlášení (index_sso.php).
• $css – Vlastní CSS styly pro skrytí původního odkazu na SAML přihlášení.
• BRAND_FOOTER – Umožňuje vložení vlastního obsahu (např. stylů, HTML šablon nebo JavaScriptu) do patičky stránky. V tomto příkladu přidává nové sekce s odlišnými způsoby přihlášení.
• HTML template – Připravená sada HTML prvků, která definuje rozdělení přihlašovací stránky na SAML přihlášení (pro zaměstnance) a standardní přihlášení (pro zákazníky).
• JavaScript – Vkládá připravené prvky z HTML šablony přímo do přihlašovacího formuláře na stránce.

Nastavení oprávnění

Ujistěte se, že soubory a složky mají správná oprávnění a vlastníka (obvykle www-data nebo apache, v závislosti na konfiguraci webového serveru):

Pro verzi 7.0 a starší

sudo chown www-data:www-data /usr/share/zabbix/local/conf/brand.conf.php
sudo chmod 644 /usr/share/zabbix/local/conf/brand.conf.php

Pro verzi 7.2 a novější

sudo chown -R www-data:www-data /usr/share/zabbix/ui/local/conf/brand.conf.php
sudo chmod 644 /usr/share/zabbix/ui/local/conf/brand.conf.php

Vlastní rebranding

Veškeré potřebné kroky naleznete v samostatném návodu na naší wiki.

The post Úprava a skrytí login formuláře v Zabbix Frontendu appeared first on initMAX s.r.o..

Návod, jak aktualizovat PostgreSQL, naleznete v našem wiki článku. Dále zde najdete i návod na aktualizaci TimescaleDB.

Výběr operačního systému

Návod obsahuje postup pro RHEL platformy na verzi 9, kde stačí případně jen poupravit repozitáře. Návod pro Debian je připraven pro verzi 12, která je aktuálně poslední podporovanou verzí.

NovýZabbix

10. 7. 2025

Aktualizace na poslední verzi 7.4

Zhlédnout záznam

Přípravné kroky

• Přečtěte si „poznámky k vydané verzi“ (release notes) [ Official release notes for Zabbix 7.4 ]
• Přečtěte si důkladně dokument „poznámky k aktualizaci“ (upgrade notes) [ Official upgrade notes for Zabbix 7.4 ]
• Zkontrolujte a případně optimalizujte výkon současné databáze dle doporučení vendora a s ohledem na požadavky Zabbix instance
• Zkontrolujte, zda verze veškerých komponent odpovídají matici kompatiblity nové verze Zabbix
• Zazálohujte konfigurační soubory Zabbix serveru a Zabbix proxy
• Zázálohujte databáze Zabbix serveru, případně Zabbix proxy
• Zazálohujte veškeré možné úpravy „na míru“, které byly na úrovni Zabbix ručně provedeny
• Musíte vypnout HA na straně Zabbix serveru.

Kontrola verzí

Nejprve zkontrolujeme verze všech komponent, na kterých je běh Zabbixu a jeho součástí závislý, tak aby přesně odpovídaly oficiální matici kompatibility pro Zabbix 7.4.

php-fpm -v
psql -V

Záloha konfiguračních souborů Zabbix

Než se pustíme do dalších kroků, zazálohujeme veškeré konfigurační soubory Zabbix serveru a Zabbix Proxy.

cp -R /etc/zabbix/ /<backup directory>/
cp -R /usr/lib/zabbix/alertscripts/ /<backup directory>/
cp -R /usr/lib/zabbix/externalscripts/ /<backup directory>/
cp -R /usr/share/zabbix/ /<backup directory>/
cp /etc/httpd/conf/httpd.conf /<backup directory>/
cp /etc/httpd/conf.d/zabbix.conf /<backup directory>/

Zastavení služeb

Nejprve zastavíme Zabbix server a webserver, aby do databáze již nic nezapisovaly.

systemctl stop zabbix-server
systemctl stop httpd

Aktualizace databáze (Volitelně)

Dejte si prosím pozor na kombinaci PostgreSQL 17 a TimescaleDB 2.17. Tato verze má problém s načítáním starších dat. V případě potíží doporučujeme provést jednu z následujících akcí:

• Downgrade extenze – přejděte na verzi TimescaleDB 2.16.2.
• Aktualizace na TimescaleDB 2.18 – tento problém řeší.
• Použití workaroundu – do souboru postgresql.conf přidejte parametr pro vypnutí vektorizace a restartuje DB.

timescaledb.enable_vectorized_aggregation = off

Detailní návod na aktualizaci PostgreSQL naleznete na naší wiki.

Aktualizace Zabbix

Vše jsme úspěšně zazálohovali a zaktualizovali všechny verze návazných komponent dle oficiální matice kompatibility nové verze Zabbixu.

Nyní přejdeme k aktualizaci samotného Zabbixu a všech jeho součástí.

Nejprve si stáhneme instalační balíčky pro repozitáře nové verze Zabbixu a smažeme instalační cache:

rpm -Uvh https://repo.zabbix.com/zabbix/7.4/release/rocky/9/noarch/zabbix-release-latest.el9.noarch.rpm
dnf clean all

Po tomto úkonu máme dostupné repozitáře nové verze a můžeme tedy zaktualizovat veškeré další komponenty Zabbix, a to postupně i na všech Zabbix Proxy:

dnf update zabbix-* -y

Po úspěšném dokončení aktualizace balíčků Zabbix serveru a všech jeho součástí můžeme Zabbix znovu spustit, aby se dokončil upgrade databázové struktury.

systemctl start zabbix-server.service

Postupné činnosti i celý proces aktualizace, včetně případných zásahů do struktury databázového schématu, lze sledovat v log souboru Zabbix serveru:

tail -f /var/log/zabbix/zabbix_server.log

Po úspěšném dokončení aktualizace databázové struktury můžeme znovu spustit náš webový server. To provedeme následujícím příkazem:

systemctl start httpd

Záloha konfiguračních souborů Zabbix

Než se pustíme do dalších kroků, zazálohujeme veškeré konfigurační soubory Zabbix serveru a Zabbix Proxy.

cp -R /etc/zabbix/ /<backup directory>/
cp -R /usr/lib/zabbix/alertscripts/ /<backup directory>/
cp -R /usr/lib/zabbix/externalscripts/ /<backup directory>/
cp -R /usr/share/zabbix/ /<backup directory>/
cp -R /etc/apache2/ /<backup directory>/

Zastavení služeb

Nejprve zastavíme Zabbix server a webserver, aby do databáze již nic nezapisovaly.

systemctl stop zabbix-server
systemctl stop apache2

Aktualizace databáze (Volitelně)

Dejte si prosím pozor na kombinaci PostgreSQL 17 a TimescaleDB 2.7. Tato verze má problém s načítáním starších dat. V případě potíží doporučujeme provést jednu z následujících akcí:

• Downgrade extenze – přejděte na verzi TimescaleDB 2.16.2.
• Aktualizace na TimescaleDB 2.8 – tento problém řeší.
• Použití workaroundu – do souboru postgresql.conf přidejte parametr pro vypnutí vektorizace a restartuje DB.

timescaledb.enable_vectorized_aggregation = off

Detailní návod na aktualizaci PostgreSQL naleznete na naší wiki.

Aktualizace Zabbix

Vše jsme úspěšně zazálohovali a zaktualizovali všechny verze návazných komponent dle oficiální matice kompatibility nové verze Zabbixu.

Nyní přejdeme k aktualizaci samotného Zabbixu a všech jeho součástí.

Nejprve si stáhneme instalační balíčky pro repozitáře nové verze Zabbixu a nainstalujeme je:

wget https://repo.zabbix.com/zabbix/7.4/release/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.4+debian12_all.deb
dpkg -i zabbix-release_latest_7.4+debian12_all.deb

Po tomto úkonu máme dostupné repozitáře nové verze a můžeme tedy zaktualizovat veškeré další komponenty Zabbix, a to postupně i na všech Zabbix Proxy:

apt update
apt install --only-upgrade $(dpkg -l | grep zabbix | awk '{print $2}')

Po úspěšném dokončení aktualizace balíčků Zabbix serveru a všech jeho součástí můžeme Zabbix znovu spustit, aby se dokončil upgrade databázové struktury.

systemctl start zabbix-server.service

Postupné činnosti i celý proces aktualizace, včetně případných zásahů do struktury databázového schématu, lze sledovat v log souboru Zabbix serveru:

tail -f /var/log/zabbix/zabbix_server.log

Po úspěšném dokončení aktualizace databázové struktury můžeme znovu spustit náš webový server. To provedeme následujícím příkazem:

systemctl start apache2

Dokončovací práce

• Zkontrolujte, že správně běží Zabbix server, databázový server a mají správnou verzi
• Zkontrolujte také, zda při startu serveru nebo proxy v systému neuvidíte následující chybu: ‚…the user limit of 1024 file descriptors is insufficient. The maximum number of concurrent checks per worker has been reduced…‘ Návod na odstranění naleznete na naší wiki.
• Zkontrolujte, že běží všechny Zabbix proxy a mají správnou verzi. Je zajištěna zpětná kompatibilita (částečná) pro verzi 7.0. Nicméně i tak důrazně doporučujeme používat stejnou verzi, jakou má Zabbix server. Starší verze nejsou podporovány.
• Zkontrolujte stav Zabbix serveru a Zabbix proxy (log soubory, nepodporované položky, fronty, monitorovací skripty, atd.).
• Zkontrolujte, zda vaše servery mají přiděleny poslední verze oficiálních šablon od Zabbixu. [ Zabbix GIT ]

Co je nového v Zabbixu 7.4

Informace o novinkách v Zabbixu 7.4 naleznete v našem článku, nebo se můžete podívat na náš webinář, který je zaměřen právě na tyto novinky.

A to je vše! Nyní můžete začít využívat váš nově zaktualizovaný Zabbix ve verzi 7.4 se všemi jeho opravami i novinkami.

The post Zabbix – aktualizace na poslední verzi 7.4 appeared first on initMAX s.r.o..

Výběr operačního systému

Návod obsahuje postup pro RHEL platformy na verzi 9, kde stačí případně jen poupravit repozitáře. Návod pro Debian je připraven pro verzi 12, která je aktuálně poslední podporovanou verzí.

NovýZabbix

11. 7. 2025

Instalace Zabbixu 7.4 v pěti minutách

Zhlédnout záznam

Než začneme

Pro účely této ukázky si nejdříve přepneme SELinux do Permissive módu.

Pokud plánujete SELinux trvale deaktivovat, můžete tak učinit úpravou konfiguračního souboru. Nicméně, doporučujeme zvážit možnost naučit se s SELinuxem pracovat a využít jeho bezpečnostní výhody. Podrobné informace o správném nastavení a monitorování SELinuxu naleznete v našem samostatném článku.​

setenforce 0

Instalace PostgreSQL

V prvním kroku si naistalujeme repozitáře pro PostgreSQL a zakážeme výchozí, systémové PostgreSQL repozitáře.

dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm
dnf -qy module disable postgresql

Následně pak nainstalujeme PostgreSQL, v tomto případě to bude aktuálně podporovaná verze 17.

dnf install -y postgresql17-server

Inicializujeme databázi a nastavíme její automatické spouštění.

/usr/pgsql-17/bin/postgresql-17-setup initdb
systemctl enable postgresql-17 --now

Instalace Zabbix serveru a jeho součástí

Databáze je nyní nainstalovaná, a můžeme tedy přikročit k instalaci Zabbix serveru a všech jeho součástí.

Nejprve si z repozitáře EPEL vyloučíme jakékoliv instalační balíčky týkající se Zabbixu. Za předpokladu, že je nainstalován.

To provedeme tak, že na konec souboru /etc/yum.repos.d/epel.repo vložíme následující řádek:

[epel]
...
excludepkgs=zabbix*

Přidáme si repozitáře Zabbixu a vyčistíme instalační cache.

rpm -Uvh https://repo.zabbix.com/zabbix/7.4/release/rocky/9/noarch/zabbix-release-latest.el9.noarch.rpm
dnf clean all

A nainstalujeme všechny potřebné součásti Zabbixu.

V tomto případě použijeme jako primárního monitorovacího agenta Zabbix Agent 2, který vám doporučujeme používat, jelikož přináší daleko více funkcionalit.

dnf install zabbix-server-pgsql zabbix-web-pgsql zabbix-apache-conf zabbix-sql-scripts zabbix-agent2 zabbix-web-service

Inicializace databáze

Nejprve vytvoříme databázového uživatele pro Zabbix, budeme vyzváni k zadání jeho přístupového hesla.

cd /tmp
sudo -u postgres createuser --pwprompt zabbix

V tuto chvíli jsme schopni naimportovat výchozí schéma a data. Opět budeme vyzváni k zadání hesla.
Zde použijeme heslo z předchozího kroku.

sudo -u postgres createdb -O zabbix zabbix
zcat /usr/share/zabbix/sql-scripts/postgresql/server.sql.gz | sudo -u zabbix psql zabbix

Nastavení firewallu

Nazávěr na firewallu povolíme porty, které jsou nezbytné pro běh Zabbix serveru.

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-port=10051/tcp
firewall-cmd --reload

Instalace TimescaleDB

Nyní se pustíme do instalace TimescaleDB a začneme tím, že přidáme její oficiální repozitář.

tee /etc/yum.repos.d/timescale_timescaledb.repo <<EOL
[timescale_timescaledb]
name=timescale_timescaledb
baseurl=https://packagecloud.io/timescale/timescaledb/el/$(rpm -E %{rhel})/\$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/timescale/timescaledb/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOL

Nainstalujme TimescaleDB.

dnf install timescaledb-2-postgresql-17 timescaledb-2-loader-postgresql-17

Spustíme utilitu timescaledb-tune a jako parametr jí předáme vyšší hodnotu maximálního množství připojení (--max-conns), které pro tyto testovací účely nastavíme na 125.

Tato utilita slouží k přizpůsobení výchozího nastavení PostgreSQL vůčihledně výkonu a adekvátnímu nastavení parametrů PostgreSQL pro fungování s TimescaleDB.

Zároveň nám tato utilit pomocí instalačního průvodce pomůže vybrat aktuální a platný konfigurační soubor PostgreSQL a nastaví i automatické načítání knihoven TimescaleDB.

Prosím, odpovídejte „ano“ (y) na všechny otázky. Pozor, automatický tuner předpokládá, že PostgreSQL běží na samostatném serveru, a proto může být potřeba případně upravit parametry.

timescaledb-tune --pg-config /usr/pgsql-17/bin --max-conns=125

Následně restartujeme systémovou službu pro PostgreSQL:

systemctl restart postgresql-17.service

Zbývá již jen vytvořit a aktivovat samotnou TimescaleDB:

Pozor: Během vývoje došlo ke změně cesty z původní /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql na novou /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql.

echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix
cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix

Nastavení Zabbix serveru

Otevřeme konfigurační soubor Zabbix serveru v cestě:

nano /etc/zabbix/zabbix_server.conf

V tomto konfiguračním souboru upravíme následující parametry tak, jak vídíte na předloze níže:

...
DBPassword=password
StartReportWriters=1
WebServiceURL=http://localhost:10053/report
...

V dalším kroku doinstalujeme všechny jazykové balíčky pro Zabbix frontend:

dnf install glibc-langpack-en glibc-langpack-cs glibc-langpack-sk glibc-langpack-fr glibc-langpack-de glibc-langpack-es glibc-langpack-it glibc-langpack-zh glibc-langpack-pt glibc-langpack-da glibc-langpack-nb glibc-langpack-pl glibc-langpack-tr glibc-langpack-he glibc-langpack-ja glibc-langpack-ko glibc-langpack-ru glibc-langpack-uk glibc-langpack-ca glibc-langpack-ka glibc-langpack-vi glibc-langpack-uz

A nakonec restartujeme všechny související služby a nastavíme je tak, aby se spouštěly automaticky po startu:

systemctl restart zabbix-server zabbix-web-service zabbix-agent2 httpd php-fpm
systemctl enable zabbix-server zabbix-web-service zabbix-agent2 httpd php-fpm

Pro ověření stavu, že nám Zabbix server nastartoval v pořádku můžeme kromě jiného zkontrolovat i jeho log soubor:

less /var/log/zabbix/zabbix_server.log

V případě, že uvidíte v log souboru zprávu o tom, že je verze TimescaleDB příliš nová, pak to není žádný velký problém. Zabbix nedokáže dostatečně rychle reagovat na nejnovější verze TimescaleDB tak, aby ji ve svém kódu nastavil jako podporovanou, ovšem kompatibilita je Zabbixem zaručena a námi ověřena.

V případě této chyby stačí otevřít konfigurační soubor Zabbix serveru v cestě /etc/zabbix/zabbix_server.conf a zde upravte následující konfigurační parametr:

AllowUnsupportedDBVersions=1

Soubor s tímto nastavením uložte a zrestartujte systémovou službu Zabbix serveru.

systemctl restart zabbix-server

Nastavení Zabbix frontendu

V prohlížeči si otevřeme cílové URL, na kterém Zabbix běží. Například tedy http://192.168.0.50/zabbix, kde nás uvítá průvodce prvotní instalací.

Po zvolení implicitního jazyka se tlačítkem Next step posuneme na stránku s kontrolou minimálních požadavků.

Pokud je kontrola v pořádku, pak se tedy můžeme kliknutím na Next step posunout na další stránku s nastavením připojení do databáze.

Zde vyplňujeme pouze políčko Password pro přístup do databáze, nic dalšího není třeba měnit.

Po vyplnění opět klikneme na Next step.

Na následující stránce se základním nastavením vyplníme název serveru, časové pásmo, a kliknutím na Next step pokračujeme k souhrnu konfigurace.

V tomto souhrnu zkontrolumeme všechny zadané hodnoty a kliknutím na Next step dokončíme instalaci.

Nyní již kliknutím na tlačítko Finish přejdeme na přihlašovací obrazovku.

Po úspěšném přihlášení pomocí dříve zadaných údajů můžeme začít používat nejnovější Zabbix verze 7.4 (Admin/zabbix).

A takto vypada úvodní dashboard nového Zabbixu 7.4:

Nastavení Zabbix reportingu

Proto, aby byl plně funkční reporting se všemi jeho vylepšeními si nejprve musíme nainstalovat Google Chrome.

Následujícím příkazem stáhneme instalační balíček, a ten také nainstalujeme:

wget https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm
dnf localinstall google-chrome-stable_current_x86_64.rpm

V dalším kroku upravíme v Zabbix frontendu parametr „Frontend URL“ na aktuálně platnou hodnotu, toto nastavení se nachází zde:

Administration -> General -> Other

Příklad této konfigurace pak můžete vidět na obrázku níže.

---

Instalace závislostí

apt install sudo gpg curl wget

Instalace PostgreSQL

V prvním kroku si nainstalujeme repozitáře pro PostgreSQL a zakážeme výchozí systémové repozitáře PostgreSQL. Na otázku ‚This script will enable the PostgreSQL APT repository on apt.postgresql.org on your system. The distribution codename used will be bookworm-pgdg.‚ stiskněte Enter pro pokračování a potvrzení instalace z oficiálního repozitáře.

apt install -y postgresql-common
/usr/share/postgresql-common/pgdg/apt.postgresql.org.sh

Následně pak nainstalujeme PostgreSQL, v tomto případě to bude aktuálně podporovaná verze 17.

apt -y install postgresql-17

Nastartování PostgreSQL a nastavení automatického spuštění při startu systému

systemctl enable postgresql --now

Instalace Zabbix serveru a jeho součástí

Databáze je nyní nainstalovaná, a můžeme tedy přikročit k instalaci Zabbix serveru a všech jeho součástí.

Přidáme si repozitáře Zabbixu a vyčistíme instalační cache.

wget https://repo.zabbix.com/zabbix/7.4/release/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.4+debian12_all.deb
dpkg -i zabbix-release_latest_7.4+debian12_all.deb
apt update

A nainstalujeme všechny potřebné součásti Zabbixu.

V tomto případě použijeme jako primárního monitorovacího agenta Zabbix Agent 2, který vám doporučujeme používat, jelikož přináší daleko více funkcionalit.

apt install zabbix-server-pgsql zabbix-frontend-php php8.2-pgsql zabbix-apache-conf zabbix-sql-scripts zabbix-agent2 zabbix-web-service

Inicializace databáze

Nejprve vytvoříme databázového uživatele pro Zabbix. Během procesu budeme vyzváni k zadání jeho přístupového hesla. Dále vytvoříme prázdnou databázi a nastavíme jí příslušná oprávnění.

sudo -u postgres createuser --pwprompt zabbix
sudo -u postgres createdb -O zabbix zabbix

V tuto chvíli jsme schopni naimportovat výchozí schéma a data. Opět budeme vyzváni k zadání hesla.
Zde použijeme heslo z předchozího kroku.

zcat /usr/share/zabbix/sql-scripts/postgresql/server.sql.gz | sudo -u zabbix psql zabbix

Instalace TimescaleDB

Nyní se pustíme do instalace TimescaleDB a začneme tím, že přidáme její oficiální repozitář.

echo "deb https://packagecloud.io/timescale/timescaledb/debian/ $(lsb_release -c -s) main" | sudo tee /etc/apt/sources.list.d/timescaledb.list
wget --quiet -O - https://packagecloud.io/timescale/timescaledb/gpgkey | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/timescaledb.gpg

Nainstalujme TimescaleDB.

apt update
apt install timescaledb-2-postgresql-17 timescaledb-2-loader-postgresql-17

Spustíme utilitu timescaledb-tune a jako parametr jí předáme vyšší hodnotu maximálního množství připojení (--max-conns), které pro tyto testovací účely nastavíme na 125.

Tato utilita slouží k přizpůsobení výchozího nastavení PostgreSQL vůčihledně výkonu a adekvátnímu nastavení parametrů PostgreSQL pro fungování s TimescaleDB.

Zároveň nám tato utilit pomocí instalačního průvodce pomůže vybrat aktuální a platný konfigurační soubor PostgreSQL a nastaví i automatické načítání knihoven TimescaleDB.

Prosím, odpovídejte „ano“ (y) na všechny otázky. Pozor, automatický tuner předpokládá, že PostgreSQL běží na samostatném serveru, a proto může být potřeba případně upravit parametry.

timescaledb-tune --pg-config /usr/bin --max-conns=125

Následně restartujeme systémovou službu pro PostgreSQL:

systemctl restart postgresql

Zbývá již jen vytvořit a aktivovat samotnou TimescaleDB:

Pozor: Během vývoje došlo ke změně cesty z původní /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql na novou /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql.

echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix
cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix

Nastavení Zabbix serveru

Otevřeme konfigurační soubor Zabbix serveru v cestě:

nano /etc/zabbix/zabbix_server.conf

V tomto konfiguračním souboru upravíme následující parametry tak, jak vídíte na předloze níže:

...
DBPassword=password
StartReportWriters=1
WebServiceURL=http://localhost:10053/report
...

V dalším kroku nastavíme jazykové balíčky pro Zabbix frontend. Můžete zvolit pouze ty, které potřebujete, nebo povolit všechny.

sed -i '/# en_US.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# en_GB.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# cs_CZ.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# sk_SK.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# fr_FR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# de_DE.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# es_ES.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# it_IT.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# zh_CN.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# pt_PT.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# pt_BR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# da_DK.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# nb_NO.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# pl_PL.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# tr_TR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# he_IL.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ja_JP.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ko_KR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ru_RU.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# uk_UA.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ca_ES.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ka_GE.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# uz_UZ.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# vi_VN UTF-8/s/^# //' /etc/locale.gen
locale-gen

A nakonec restartujeme všechny související služby a nastavíme je tak, aby se spouštěly automaticky po startu:

systemctl restart zabbix-server zabbix-web-service zabbix-agent2 apache2
systemctl enable zabbix-server zabbix-web-service zabbix-agent2 apache2

Pro ověření stavu, že nám Zabbix server nastartoval v pořádku můžeme kromě jiného zkontrolovat i jeho log soubor:

less /var/log/zabbix/zabbix_server.log

V případě, že uvidíte v log souboru zprávu o tom, že je verze TimescaleDB příliš nová, pak to není žádný velký problém. Zabbix nedokáže dostatečně rychle reagovat na nejnovější verze TimescaleDB tak, aby ji ve svém kódu nastavil jako podporovanou, ovšem kompatibilita je Zabbixem zaručena a námi ověřena.

V případě této chyby stačí otevřít konfigurační soubor Zabbix serveru v cestě /etc/zabbix/zabbix_server.conf a zde upravte následující konfigurační parametr:

AllowUnsupportedDBVersions=1

Soubor s tímto nastavením uložte a zrestartujte systémovou službu Zabbix serveru.

systemctl restart zabbix-server

Nastavení Zabbix frontendu

V prohlížeči si otevřeme cílové URL, na kterém Zabbix běží. Například tedy http://192.168.0.50/zabbix, kde nás uvítá průvodce prvotní instalací.

Po zvolení implicitního jazyka se tlačítkem Next step posuneme na stránku s kontrolou minimálních požadavků.

Pokud je kontrola v pořádku, pak se tedy můžeme kliknutím na Next step posunout na další stránku s nastavením připojení do databáze.

Zde vyplňujeme pouze políčko Password pro přístup do databáze, nic dalšího není třeba měnit.

Po vyplnění opět klikneme na Next step.

Na následující stránce se základním nastavením vyplníme název serveru, časové pásmo, a kliknutím na Next step pokračujeme k souhrnu konfigurace.

V tomto souhrnu zkontrolumeme všechny zadané hodnoty a kliknutím na Next step dokončíme instalaci.

Nyní již kliknutím na tlačítko Finish přejdeme na přihlašovací obrazovku.

Po úspěšném přihlášení pomocí dříve zadaných údajů můžeme začít používat nejnovější Zabbix verze 7.4 (Admin/zabbix).

A takto vypada úvodní dashboard nového Zabbixu 7.4:

Nastavení Zabbix reportingu

Proto, aby byl plně funkční reporting se všemi jeho vylepšeními si nejprve musíme nainstalovat Google Chrome.

Následujícím příkazem stáhneme instalační balíček, a ten také nainstalujeme:

curl -fSsL https://dl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor | sudo tee /usr/share/keyrings/google-chrome.gpg >> /dev/null
echo deb [arch=amd64 signed-by=/usr/share/keyrings/google-chrome.gpg] http://dl.google.com/linux/chrome/deb/ stable main | sudo tee /etc/apt/sources.list.d/google-chrome.list
apt update
apt install google-chrome-stable

V dalším kroku upravíme v Zabbix frontendu parametr „Frontend URL“ na aktuálně platnou hodnotu, toto nastavení se nachází zde:

Administration -> General -> Other

Příklad této konfigurace pak můžete vidět na obrázku níže.

Dokončovací práce

• Zkontrolujte, že správně běží Zabbix server, databázový server a mají správnou verzi
• Zkontrolujte také, zda při startu serveru nebo proxy v systému neuvidíte následující chybu: ‚…the user limit of 1024 file descriptors is insufficient. The maximum number of concurrent checks per worker has been reduced…‘ Návod na odstranění naleznete na naší wiki.

Podpora pro Item Browser

Veškeré potřebné kroky naleznete v samostatném návodu na naší wiki.

NovýZabbix

21. 6. 2024

7.0 Workshop: Zabbix 7.0 – Monitorování pomocí Browser Item pomocí aplikace Selenium

Zhlédnout záznam

Vlastní rebranding

Veškeré potřebné kroky naleznete v samostatném návodu na naší wiki.

The post Zabbix 7.4 – návod na instalaci v 5 minutách appeared first on initMAX s.r.o..

Návod je určen pro distribuce na bázi RPM. (RHEL, CentOS, Rocky Linux, ALMA, Fedora,…)

Co je SELinux a jak funguje?

SELinux (Security-Enhanced Linux) je bezpečnostní modul Linuxu, který implementuje povinné řízení přístupu (Mandatory Access Control, MAC). Na rozdíl od standardního řízení přístupu (Discretionary Access Control, DAC), kde uživatelé určují práva ke svým souborům, MAC definuje bezpečnostní politiky spravované administrátorem, které omezují akce programů a uživatelů na základě jasně definovaných pravidel.

SELinux pracuje ve třech režimech:

• Enforcing – politiky jsou vynucovány, přístup je aktivně blokován při porušení pravidel.
• Permissive – SELinux je aktivní, ale neblokuje přístup, pouze loguje porušení pravidel.
• Disabled – SELinux je zcela vypnutý.

Stav SELinux zjistíte příkazem:

sestatus

Příklad výstupu:

SELinux status:                 enabled
SELinuxfs mount:                /sys/fs/selinux
SELinux root directory:         /etc/selinux
Loaded policy name:             targeted
Current mode:                   enforcing
Mode from config file:          enforcing
Policy MLS status:              enabled
Policy deny_unknown status:     allowed
Max kernel policy version:      33

• enabled – SELinux je aktivní.
• enforcing – Politika je vynucována.
• targeted – Používá se standardní cílená politika.

Zabbix balíček zabbix-selinux-policy

Balíček zabbix-selinux-policy obsahuje specifická pravidla SELinuxu potřebná pro hladký běh Zabbix serveru, proxy a agenta, aniž by bylo nutné SELinux vypínat. Balíček je dostupný v oficiálním Zabbix repozitáři.

Instalace balíčku:

dnf install zabbix-selinux-policy

Dočasné vypnutí SELinuxu

Pokud potřebujete SELinux rychle deaktivovat, použijte:

setenforce 0

• 0 znamená přepnutí do režimu Permissive (vše povoleno, incidenty se pouze logují).
• 1 znamená přepnutí zpět do režimu Enforcing (incidenty se blokují a logují).

Změna je platná jen do restartu systému. Ověřit aktuální režim:

getenforce

Permanentní vypnutí SELinuxu

Pro trvalé vypnutí SELinuxu upravte /etc/selinux/config:

nano /etc/selinux/config

Změňte:

SELINUX=enforcing

na

SELINUX=disabled

Restartujte systém:

reboot

Opětovné zapnutí SELinuxu a relabel

Pro opětovné aktivování SELinuxu je doporučeno nejprve nastavit režim permissive, ověřit správnost politik a teprve poté přejít do režimu enforcing. Nastavte tedy nejprve:

SELINUX=permissive

Poté nastavte relabel:

touch /.autorelabel
reboot

Soubor .autorelabel vytvořte přímo v /. Tento proces po restartu nastaví správné SELinux kontexty. Kontext souborů označuje metadata, která definují, jaká SELinux pravidla se na daný soubor vztahují. Pokud by relabel neproběhl, soubory (např. /etc/passwd) budou mít nesprávný nebo žádný kontext, což může vést k nemožnosti přihlášení.

Po ověření režimu permissive můžete přejít na enforcing. Nejprve změňte konfiguraci v souboru /etc/selinux/config:

SELINUX=enforcing

Tato změna se aplikuje po restartu systému. Pro okamžitou aplikaci změny bez restartu použijte příkaz:

setenforce 1

Vytváření vlastních politik SELinux

Pokud SELinux blokuje operaci aplikace zabbix_server, zjistíte to z logů auditd:

grep AVC /var/log/audit/audit.log | grep zabbix_server

Příklad záznamu:

type=AVC msg=audit(1743521737.355:209): avc: denied { name_bind } for pid=1620 comm="zabbix_server" src=10055 scontext=system_u:system_r:zabbix_t:s0 tcontext=system_u:object_r:unreserved_port_t:s0 tclass=tcp_socket permissive=0

Tato chyba ukazuje, že SELinux brání Zabbix serveru použít port 10055. K vytvoření pravidla, které tuto akci povolí, nainstalujte nástroj audit2allow:

dnf install policycoreutils policycoreutils-python-utils -y

Vytvořte politiku pro Zabbix server

Spusťte příkaz:

grep zabbix_server /var/log/audit/audit.log | audit2allow -m zabbix_server_policy > zabbix_server_policy.te

Co dělají jednotlivé části:

• grep zabbix_server /var/log/audit/audit.log: Vybere z audit logu pouze záznamy týkající se Zabbix serveru.
• audit2allow -m zabbix_server_policy: Analyzuje výstup a vytvoří návrh politiky SELinuxu

Ukázka obsahu souboru zabbix_server_policy.te:

module zabbix_server_policy 1.0;

require {
	type krb5_keytab_t;
	type unreserved_port_t;
	type zabbix_t;
	class dir search;
	class tcp_socket name_bind;
}

#============= zabbix_t ==============
allow zabbix_t krb5_keytab_t:dir search;

#!!!! This avc can be allowed using the boolean 'nis_enable

Tento soubor obsahuje pravidla, která povolují Zabbix serveru:

• Používat konkrétní porty (např. nerezervované porty),
• Prohledávat adresáře se soubory Kerberos klíčů (krb5_keytab_t).

module zabbix_server_policy 1.0;
→ Název a verze modulu.

require { ... }
→ Modul potřebuje přístup k těmto věcem:

• krb5_keytab_t → soubory s Kerberos klíči (např. /etc/krb5.keytab)
• unreserved_port_t → běžné síťové porty
• zabbix_t → proces Zabbix serveru
• dir search → umožňuje procházet adresáře
• tcp_socket name_bind → umožňuje bindnout se na TCP port

allow zabbix_t krb5_keytab_t:dir search;
→ Zabbix může procházet adresář s Kerberos klíčem.

#!!!! This avc can be allowed using the boolean 'nis_enable'
→ Komentář: něco podobného by šlo povolit pomocí booleanu 'nis_enable'.

Bezpečnostní poznámka:
Tento příklad zároveň ukazuje potenciální nevýhodu automatizovaného vytváření pravidel pomocí audit2allow.
Může dojít k tomu, že se spolu s potřebnými pravidly omylem povolí i přístupy, které nejsou žádoucí – například k souborům s Kerberos klíči.
Proto je důležité výstup ze audit2allow pečlivě zkontrolovat a upravit, než se politika zkompiluje a aplikuje.

Dále pravidlo zkompilujte a aplikujte:

checkmodule -M -m -o zabbix_server_policy.mod zabbix_server_policy.te
semodule_package -o zabbix_server_policy.pp -m zabbix_server_policy.mod
semodule -i zabbix_server_policy.pp

• checkmodule -M -m: Zkompiluje .te soubor do .mod modulu.
• semodule_package: Převede .mod soubor na .pp instalační balíček.
• semodule -i: Instaluje vytvořený balíček politik do systému SELinux.

Ověření aplikace politiky:

semodule -l | grep zabbix_server_policy

Výstup by měl ukázat nainstalovanou politiku zabbix_server_policy, což potvrzuje její úspěšnou aplikaci do systému SELinux.

Pro vylistování SELinux politik například pro Zabbix použijte

semodule -l | grep zabbix

Tento příkaz zobrazí všechny aktuálně nainstalované SELinux moduly, které mají v názvu „zabbix“.

zabbix
zabbix_server_policy

Chcete-li si zobrazit, jaká pravidla obsahuje konkrétní SELinux modul (např. zabbix_server_policy), můžete použít následující postup:

mkdir -p /tmp/policyview && \
cd /tmp/policyview && \
semodule --extract zabbix_server_policy && \
strings zabbix_server_policy.pp

Doplnění existující SELinux politiky o nové pravidlo

Pokud potřebujete později doplnit existující politiku o další pravidlo, upravte existující .te soubor (např. přidejte další allow pravidlo) a opakujte celý postup kompilace a aplikace politiky:

checkmodule -M -m -o zabbix_server_policy.mod zabbix_server_policy.te
semodule_package -o zabbix_server_policy.pp -m zabbix_server_policy.mod
semodule -i zabbix_server_policy.pp

SELinux automaticky aktualizuje existující politiku novými pravidly, aniž by bylo nutné původní politiku odstraňovat.

grep zabbix_server /var/log/audit/audit.log | audit2allow -m zabbix_server_policy > zabbix_server_policy.te

Jak odstraním vlastní SELinux politiku?

Použijte příkaz semodule:

semodule -r zabbix_server_policy

Monitoring SELinux AVC denials pomocí Zabbixu

Abychom mohli SELinux monitorovat, musíme nejdříve získat oprávnění ke čtení příslušného log souboru. Bezpečnou cestou je přesměrovat jeho obsah do samostatného souboru, který bude vytvořen speciálně pro náš účel a dostupný pro Zabbix agenta – nikoliv změnou oprávnění na původních systémových souborech, čímž zachováme bezpečnostní standardy systému.

Zprávy AVC denial vypadají v logu takto:

type=AVC msg=audit(1744268323.007:2345954): avc: denied { search } for pid=2102180 comm="zabbix_server" name="krb5" ...

Tyto zprávy se zapisují do audit logu:
/var/log/audit/audit.log
Budeme monitorovat právě tyto zprávy.

Nejprve vytvořte skript, který bude průběžně sledovat audit.log a vybírat z něj pouze AVC zprávy:

nano /usr/local/bin/selinux-denial-logger.sh

Obsah skriptu:

#!/bin/bash

tail -F /var/log/audit/audit.log | grep --line-buffered -E "avc:\s+denied" >> /var/log/selinux_denials.log

Poté nastavte spustitelná oprávnění skriptu:

chmod +x /usr/local/bin/selinux-denial-logger.sh

Automatické spouštění skriptu pomocí systemd

Aby byl vytvořený skript spouštěn automaticky po restartu systému a běžel kontinuálně, je nutné vytvořit odpovídající systemd službu.
Vytvořte novou systemd službu příkazem:

nano /etc/systemd/system/selinux-denial-logger.service

Obsah souboru systemd služby:

[Unit]
Description=SELinux AVC Denial Logger by initMAX s.r.o.
After=auditd.service

[Service]
Type=simple
ExecStart=/usr/local/bin/selinux-denial-logger.sh
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Aktivujte a spusťte nově vytvořenou službu:

systemctl daemon-reload 
systemctl enable selinux-denial-logger.service --now

Zkontrolujte, zda služba běží bez problémů:

systemctl status selinux-denial-logger.service

Nastavení rotace logů pomocí log rotate

Aby bylo zajištěno, že logovací soubor nenaroste příliš, je vhodné použít nástroj logrotate k jeho pravidelné rotaci.
Vytvořte konfiguraci rotace logu pomocí příkazu:

nano /etc/logrotate.d/selinux_denials

Obsah konfigurace logrotate:

/var/log/selinux_denials.log {
    weekly
    rotate 4
    missingok
    notifempty
    compress
    delaycompress
    copytruncate
}

Tato konfigurace zajistí týdenní rotaci logů, zachová 4 týdny historie, logy budou komprimovány a po každé rotaci bude služba restartována, aby pokračoval zápis do správného logu.

Import šablony a požadavky

Pro monitoring SELinux pomocí Zabbixu jsme připravili vlastní šablonu SELinux, kterou lze snadno importovat do vašeho Zabbix serveru.

Požadavky

• Zabbix verze: 7.0 a vyšší
• Zabbix agent: doporučeno používat Zabbix agent 2 (nutné pro systemd.unit.info a jednodušší integraci)
• Zabbix agent: Pro použití klíčů log* je nutné, aby agent běžel v aktivním režimu (active checks).
• Systém s SELinuxem: např. RHEL, AlmaLinux, CentOS Stream, Fedora apod.
• Agent: musí mít přístup k následujícím souborům (mívá povoleno ve výchozím nastavení):
  • /sys/fs/selinux/enforce
  • /etc/selinux/config
  • /var/log/selinux_denials.log – soubor generovaný externím skriptem (viz výše)

Šablonu lze stáhnout z našeho repozitáře zde: https://git.initmax.cz/initMAX-Public/zabbix-templates/-/tree/production/free/SELinux_by_Zabbix_Agent_2

Import šablony

V Zabbix frontend přejděte do části Data collection → Templates.

Klikněte na Import.

Vyberte soubor template_SELinux_by_Zabbix_Agent_2.yaml z našeho repozitáře a potvrďte import.

Po importu připojte šablonu k hostu s povolenou aktivní komunikací – ta je nezbytná pro zpracování logů pomocí log[*].

Správnost nastavení si můžete zkontrolovat přes Monitoring > Latest data u daného hosta.

Pokud dojde k detekci blokace, Zabbix vytvoří problémovou událost. Ta se automaticky uzavře, pokud po dobu 30 minut nedojde k žádné další blokaci.

Tento časový interval lze upravit pomocí uživatelského makra {$TRIGGER.CLOSE.TIME}, a to buď přímo v šabloně, nebo individuálně na úrovni konkrétního hosta.

Každý záznam problému obsahuje v názvu informace o PIDu, názvu procesu (Comm) a typu objektu (Class), který byl blokován. Díky tomu lze problém snadno identifikovat už na první pohled.

Zároveň jsou k události přiřazeny tagy jako comm, class, pid a source, které umožňují efektivní filtrování událostí, směrování notifikací a zobrazení v přehledných dashboardech.

Na obrázku níže je vidět, jak se SELinux události zobrazují v sekci „Monitoring → Problems“.

Doporučení: SELinux je důležitou součástí zabezpečení systému a obecně není doporučeno jej vypínat. Balíček zabbix-selinux-policy řeší většinu běžných problémů se Zabbixem, ale nestandardní operace (např. specifické porty nebo přístup k nestandardním souborům) musí administrátor řešit vlastními politikami, jak je popsáno výše. Doporučujeme investovat čas do pochopení fungování SELinuxu, abyste mohli bezpečnostní politiky efektivně spravovat.

The post SELinux: integrace se Zabbixem a dalšími nástroji appeared first on initMAX s.r.o..

Zabbix

18. 1. 2024

Skriptování v Zabbixu 7.0

Zhlédnout záznam

Výběr operačního systému

Návod obsahuje postup pro RHEL platformy na verzi 9, kde stačí případně jen poupravit repozitáře. Návod pro Debian je připraven pro verzi 12, která je aktuálně poslední podporovanou verzí.

Povolení globálních skriptů

Od Zabbix verze 7.0 jsou globální frontend skripty standardně zakázány z bezpečnostních důvodů. Tato restrikce je součástí snahy o vyšší bezpečnost prostředí Zabbix serveru. Globální skripty však mohou výrazně usnadnit správu, proto pokud chcete využívat jejich výhody, musíte je explicitně povolit.

Defaultně je v konfiguraci Zabbix serveru nastavena hodnota EnableGlobalScripts=0, což znamená, že je tato funkce vypnutá. Pokud se pokusíte spustit skript bez povolení, objeví se chyba:

„Global script execution on Zabbix server is disabled by server configuration.“

Zda jsou globální skripty povolené, můžete také jednoduše zkontrolovat přímo v GUI v sekci Reports → System information v položce „Global scripts on Zabbix server“. Pokud je toto nastavení již povoleno, řádek s touto položkou se ve výpisu nezobrazuje. 

Pro povolení globálních skriptů postupujte následovně:

Upravte konfigurační soubor Zabbix serveru příkazem:

nano /etc/zabbix/zabbix_server.conf

V souboru vyhledejte řádek s hodnotou EnableGlobalScripts=0 a změňte ho na:

EnableGlobalScripts=1

Tato změna povoluje provádění globálních skriptů.

Restartujte službu Zabbix serveru:

systemctl restart zabbix-server

Po tomto kroku můžete v Zabbixu globální skripty využívat.

Zprovoznění předdefinovaných frontend skriptů (nmap a traceroute)

Zabbix obsahuje několik užitečných frontend skriptů již ve výchozím stavu, ovšem často nejsou ihned funkční kvůli chybějícím systémovým balíčkům nebo nedostatečným oprávněním. Ukážeme si, jak zprovoznit dva z těchto předdefinovaných skriptů – konkrétně nmap a traceroute.

Instalace potřebných balíčků

Na Zabbix serveru nebo proxy nainstalujte balíčky:

dnf install nmap traceroute

apt install nmap traceroute

Nastavení sudo pravidla

Aby Zabbix mohl spouštět příkazy s vyššími oprávněními (v tomto případě pro nástroj nmap), vytvořte speciální sudoers soubor, například /etc/sudoers.d/zabbix_scripts, a vložte do něj následující obsah:

nano /etc/sudoers.d/zabbix_scripts

A vložte následující obsah:

zabbix ALL=(ALL) NOPASSWD: /usr/bin/nmap

Toto pravidlo umožní uživateli zabbix spouštět příkaz nmap bez nutnosti zadávat heslo, což zajistí správnou funkčnost skriptu ve frontendovém rozhraní.
Pravidla v souboru sudoers definují, jaké příkazy mohou uživatelé spouštět s oprávněními root bez nutnosti autentizace. Další příkazy lze přidávat na samostatné řádky stejným způsobem.

Uložte soubor a ověřte správnou syntaxi příkazem:

visudo -cf /etc/sudoers.d/zabbix_scripts

Pokud kontrola projde bez chyb, můžete nyní používat frontend skripty nmap a traceroute přímo ze Zabbix rozhraní.

Příklad 1 – Vypsání konfiguračního souboru Zabbix agenta

Nyní si ukážeme, jak vytvořit vlastní frontend skript v Zabbix GUI, který načítá konfiguraci Zabbix agenta s rozlišením verze agenta. Nejdříve je potřeba povolit spouštění vlastních skriptů na straně Zabbix agenta.

Povolení skriptů v konfiguraci Zabbix agenta (Agent i Agent 2)

Na vzdáleném hostovi upravte konfiguraci Zabbix agenta příkazem podle typu agenta:

• Pro klasický Zabbix agent:

nano /etc/zabbix/zabbix_agentd.conf

• Pro Zabbix agent 2:

nano /etc/zabbix/zabbix_agent2.conf

Povolení DenyKey

Pokud ještě nemáte povolenou tuto možnost, je potřeba ji nejprve aktivovat.

V konfiguraci nejprve najděte a odkomentujte řádek s DenyKey:

DenyKey=system.run[*]

Před řádek s pravidlem DenyKey vložte pravidlo AllowKey., které povolí spuštění pouze konkrétního skriptu (nikdy nepoužívejte obecné pravidlo s *, které může být bezpečnostním rizikem):

AllowKey=system.run[pgrep -a 'zabbix_agent2' >/dev/null && { echo "==== Zabbix Agent 2 Configuration ===="; grep -Ev '^#|^$' /etc/zabbix/zabbix_agent2.conf; } ; pgrep -a 'zabbix_agentd' >/dev/null && { echo "==== Zabbix Agent (Classic) Configuration ===="; grep -Ev '^#|^$' /etc/zabbix/zabbix_agentd.conf; }]

Poté restartujte službu agenta podle typu:

• Zabbix agent:

systemctl restart zabbix-agent

• Zabbix agent 2:

systemctl restart zabbix-agent2

Vytvoření skriptu ve frontendu

Postupujte následovně:

• Přejděte do sekce Alerts → Scripts.
• Klikněte na tlačítko Create script.
• Vyplňte pole:
  • Name: Například „Zabbix Agent Config“.
  • Scope: Vyberte „Manual host action“.
  • Type: Vyberte „Script“.
  • Execute on: Vyberte „Zabbix agent“.
  • Commands: Vložte následující příkaz:

pgrep -a 'zabbix_agent2' >/dev/null && { echo "==== Zabbix Agent 2 Configuration ===="; grep -Ev '^#|^$' /etc/zabbix/zabbix_agent2.conf; } ; pgrep -a 'zabbix_agentd' >/dev/null && { echo "==== Zabbix Agent (Classic) Configuration ===="; grep -Ev '^#|^$' /etc/zabbix/zabbix_agentd.conf; }

Dále je možné (volitelně) vyplnit následující nastavení:

• Description – popis účelu skriptu
• Host group – omezení použití pouze pro určité skupiny hostů
• User group – omezení použití pouze pro určité uživatelské skupiny
• Možnosti nastavení Required host permissions:
  • Read – Uživatelé s oprávněním „Read“ k hostovi mohou skript spustit.
  • Write – Skript lze spustit pouze s oprávněním „Write“ k hostovi.

• Klikněte na tlačítko Add.

Příklad 2 – Zobrazení posledních 10 řádků Zabbix agent logu

Pokud chcete mít možnost zobrazit posledních 10 řádků ze Zabbix agent logu přímo přes frontend, můžete vytvořit tento skript:

Na vzdáleném hostovi upravte konfiguraci Zabbix agenta příkazem podle typu agenta:

• Pro klasický Zabbix agent:

nano /etc/zabbix/zabbix_agentd.conf

• Pro Zabbix agent 2:

nano /etc/zabbix/zabbix_agent2.conf

Povolení DenyKey

Pokud ještě nemáte povolenou tuto možnost, je potřeba ji nejprve aktivovat.

V konfiguraci nejprve najděte a odkomentujte řádek s DenyKey:

DenyKey=system.run[*]

Před řádek s pravidlem DenyKey vložte pravidlo AllowKey, které povolí spuštění pouze konkrétního skriptu (nikdy nepoužívejte obecné pravidlo s *, které může být bezpečnostním rizikem):

AllowKey=system.run[echo 'Last 10 lines from Zabbix agent log on server *:'; tail -n 10 /var/log/zabbix/zabbix_agent*.log]

Poté restartujte službu agenta podle typu:

• Zabbix agent:

systemctl restart zabbix-agent

• Zabbix agent 2:

systemctl restart zabbix-agent2

Ve frontendu vytvořte skript s nastavením:

• Name: Například „Show agent log“.
• Scope: Vyberte „Manual host action“.
• Type: Vyberte „Script“.
• Execute on: Vyberte „Zabbix agent“.
• Commands: Vložte následující příkaz:

echo 'Last 10 lines from Zabbix agent log on server {HOST.HOST}:'; tail -n 10 /var/log/zabbix/zabbix_agent*.log

Opět volitelně nastavte popis, host group nebo user group dle potřeb.

Nakonec klikněte na tlačítko Add.

Příklad 3 – Povolení restartu aplikace pomoci Zabbix agenta

Nastavení sudo pravidla

Aby Zabbix mohl spouštět příkazy s vyššími oprávněními (v tomto případě restart aplikace  crond a rsyslog), vytvořte speciální sudoers soubor, například /etc/sudoers.d/zabbix_scripts, a vložte do něj následující obsah:

nano /etc/sudoers.d/zabbix_scripts

A vložte následující obsah:

zabbix ALL=(ALL) NOPASSWD: /usr/bin/systemctl restart rsyslog
zabbix ALL=(ALL) NOPASSWD: /usr/bin/systemctl restart crond

Tyto pravidla umožní uživateli zabbix spouštět příkazy pro restart bez nutnosti zadávat heslo.

Uložte soubor a ověřte správnou syntaxi příkazem:

visudo -cf /etc/sudoers.d/zabbix_scripts

Na vzdáleném hostovi upravte konfiguraci Zabbix agenta příkazem podle typu agenta:

• Pro klasický Zabbix agent:

nano /etc/zabbix/zabbix_agentd.conf

• Pro Zabbix agent 2:

nano /etc/zabbix/zabbix_agent2.conf

Povolení DenyKey

Pokud ještě nemáte povolenou tuto možnost, je potřeba ji nejprve aktivovat.

V konfiguraci nejprve najděte a odkomentujte řádek s DenyKey:

DenyKey=system.run[*]

Před řádek s pravidlem DenyKey vložte pravidlo AllowKey, které povolí spuštění pouze konkrétního skriptu (nikdy nepoužívejte obecné pravidlo s *, které může být bezpečnostním rizikem):

AllowKey=system.run[sudo systemctl restart rsyslog && echo "Service * restarted successfully." || echo "Restart of service * failed."]
AllowKey=system.run[sudo systemctl restart crond && echo "Service * restarted successfully." || echo "Restart of service * failed."]

Poté restartujte službu agenta podle typu:

• Zabbix agent:

systemctl restart zabbix-agent

• Zabbix agent 2:

systemctl restart zabbix-agent2

Vytvoření skriptu pro restart služby s výběrem z menu

Nová funkcionalita v Zabbix 7.0 umožňuje použití uživatelského vstupu s dropdown menu. Tímto způsobem umožníme uživatelům vybrat, kterou službu chtějí restartovat (například rsyslog nebo crond).

• Přejděte do sekce Alerts → Scripts.
• Klikněte na tlačítko Create script.
• Vyplňte pole:
  • Name: „Restart service“.
  • Scope: „Manual host action“.
  • Type: „Script“.
  • Execute on: „Zabbix agent“.
  • Commands: Vložte následující příkaz:

sudo systemctl restart {MANUALINPUT} && echo "Service {MANUALINPUT} restarted successfully." || echo "Restart of service {MANUALINPUT} failed."

Přidání dropdown menu

• Klikněte na Advanced configuration.
• Zaškrtněte Enable user input.
• Do pole Input prompt zadejte: Service name.
• V Input type vyberte: Dropdown.
• Do Dropdown options zadejte:
  • Enable user input: Zaškrtněte.
  • Input prompt: „Service name“.
  • Input type: Vyberte Dropdown.
  • Dropdown options: Zadejte rsyslog,crond.
• Klikněte na tlačítko Add a můžete používat nový skript přímo z GUI.

rsyslog,crond

• Uložte změny.

Příklad spuštění skriptu

Jakmile jsou skripty vytvořené (v Alerts → Scripts a nastavené jako Manual host action), zobrazí se při levém kliknutí na host v sekci Monitoring → Hosts v kontextové nabídce (viz obrázky). Tam pak stačí vybrat konkrétní skript (například Restart service nebo Show agent log). Stejné skripty lze obdobným způsobem spustit i v mapách – kliknutím na ikonu hosta se otevře nabídka s dostupnými akcemi. Tímto způsobem máš rychlý přístup k ovládání hostů přímo z přehledu nebo z mapy.

Frontend scripts timeout

• Před verzí 7.0: Timeout byl řízen parametrem Timeout= v konfiguračních souborech Zabbix serveru (zabbix_server.conf) a Zabbix agenta (zabbix_agentd.conf nebo zabbix_agent2.conf) s rozsahem 1-30 sekund a vztahoval se pouze na pasivní kontroly.
• Od verze 7.0: Timeout se nastavuje přímo ve frontendu a vztahuje se i na aktivní kontroly. Výchozí hodnota je 60 sekund, rozsah lze nastavit v rozmezí 1-300 sekund. U aktivních kontrol je potřeba brát v úvahu také nastavení refresh intervalu, který definuje, jak často agent načítá novou konfiguraci a tím i frekvenci dotazů na nové hodnoty. Výchozí hodnota tohoto intervalu je 5 sekund, což může ovlivnit chování timeoutu. Pokud je timeout kratší než refresh interval, požadavek na kontrolu se nemusí nikdy provést, proto je potřeba zvolit hodnoty v souladu s tímto nastavením.

Jak změnit timeout ve frontendu

• Přejděte do Administration → General → Timeouts.
• Najděte možnost Script execution.
• Změňte hodnotu podle potřeby (rozsah 1-300 sekund).
• Klikněte na Update.

Wait vs. Nowait u system.run v action operations

Zabbix umožňuje při použití system.run v action skriptech definovat, zda má příkaz běžet v režimu Wait (výchozí) nebo Nowait.
Rozdíl mezi Wait a Nowait

• Wait (výchozí chování) – Skript se spustí a Zabbix čeká na jeho dokončení, než provede další kroky v rámci akce.
• Nowait – Skript se spustí, ale Zabbix nečeká na jeho dokončení – okamžitě pokračuje dál.

Kde lze použít Nowait?

• Nowait je možné použít pouze v action skriptech (např. v sekci Action operations v Zabbixu).
• Nelze jej použít v běžných frontend skriptech, kde Zabbix vždy čeká na výsledek.

Jak správně nastavit AllowKey pro Nowait?
Pokud je v AllowKey povolen konkrétní příkaz, např.:

AllowKey=system.run[myscript.sh]

…pak varianta s nowait nebude fungovat (system.run[myscript.sh,nowait]).
Správné řešení:
Aby bylo možné použít nowait, je nutné povolit hvězdičkový zápis:

AllowKey=system.run[myscript.sh,*]

Pozor: Pokud v konfiguraci není povolen nowait, může Zabbix odmítnout provedení skriptu s touto volbou.
Kdy použít Wait a kdy Nowait?

• Wait (synchronní provedení) – Hodí se pro krátké skripty, kde je nutné znát výsledek příkazu před provedením dalších operací.
• Nowait (asynchronní provedení) – Vhodné pro dlouhotrvající úlohy, kde není potřeba čekat na výsledek (např. restart služby, spuštění skriptu na pozadí).

Krátké tipy

• Bezpečnost a oprávnění
  Ujisti se, že máš správně nastavené uživatelské a host groupy, které mohou skripty spouštět. Příliš široké nastavení oprávnění může vést k bezpečnostním rizikům.
• SELinux / firewall
  Pokud máš aktivní SELinux či firewall, může být nutné provést další kroky (např. povolit potřebné porty nebo upravit SELinux pravidla), aby skripty fungovaly bez omezení.
• Záloha a logování
  Než provedeš změny v konfiguračních souborech Zabbixu, vytvoř si zálohu. Pokud se objeví chyby, zkontroluj log Zabbix serveru či agenta (typicky v /var/log/zabbix/), abys mohl rychle odhalit případné problémy.
• Ověření funkčnosti
  Po úpravách a restartu služeb vždy proveď testovací spuštění skriptů, abys ověřil, že veškeré změny proběhly správně a skripty se dají spustit bez chyb.
• Doba běhu skriptů (timeout)
  Pokud se skript nespustí nebo se ukončí s chybou, může být problém s nastaveným timeoutem. Ten můžeš upravit v Administration → General → Timeouts (položka „Script execution“). Pro běžné operace obvykle stačí výchozích 60 sekund, ale při rozsáhlejších skriptech může být potřeba hodnotu zvýšit.

The post Frontend scripty a sudo v Zabbixu appeared first on initMAX s.r.o..

Výběr operačního systému

Návod obsahuje postup pro RHEL platformy na verzi 9, kde stačí případně jen poupravit repozitáře. Návod pro Debian je připraven pro verzi 12, která je aktuálně poslední podporovanou verzí.

NovýZabbix

19. 12. 2024

Instalace Zabbixu 7.2 v pěti minutách

Zhlédnout záznam

Než začneme

Pro účely této ukázky si nejdříve přepneme SELinux do Permissive módu.

Pokud plánujete SELinux trvale deaktivovat, můžete tak učinit úpravou konfiguračního souboru. Nicméně, doporučujeme zvážit možnost naučit se s SELinuxem pracovat a využít jeho bezpečnostní výhody. Podrobné informace o správném nastavení a monitorování SELinuxu naleznete v našem samostatném článku.​

setenforce 0

Instalace PostgreSQL

V prvním kroku si naistalujeme repozitáře pro PostgreSQL a zakážeme výchozí, systémové PostgreSQL repozitáře.

dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm
dnf -qy module disable postgresql

Následně pak nainstalujeme PostgreSQL, v tomto případě to bude aktuálně podporovaná verze 17.

dnf install -y postgresql17-server

Inicializujeme databázi a nastavíme její automatické spouštění.

/usr/pgsql-17/bin/postgresql-17-setup initdb
systemctl enable postgresql-17 --now

Instalace Zabbix serveru a jeho součástí

Databáze je nyní nainstalovaná, a můžeme tedy přikročit k instalaci Zabbix serveru a všech jeho součástí.

Nejprve si z repozitáře EPEL vyloučíme jakékoliv instalační balíčky týkající se Zabbixu. Za předpokladu, že je nainstalován.

To provedeme tak, že na konec souboru /etc/yum.repos.d/epel.repo vložíme následující řádek:

[epel]
...
excludepkgs=zabbix*

Přidáme si repozitáře Zabbixu a vyčistíme instalační cache.

rpm -Uvh https://repo.zabbix.com/zabbix/7.2/release/rocky/9/noarch/zabbix-release-latest-7.2.el9.noarch.rpm
dnf clean all

A nainstalujeme všechny potřebné součásti Zabbixu.

V tomto případě použijeme jako primárního monitorovacího agenta Zabbix Agent 2, který vám doporučujeme používat, jelikož přináší daleko více funkcionalit.

dnf install zabbix-server-pgsql zabbix-web-pgsql zabbix-apache-conf zabbix-sql-scripts zabbix-agent2 zabbix-web-service

Inicializace databáze

Nejprve vytvoříme databázového uživatele pro Zabbix, budeme vyzváni k zadání jeho přístupového hesla.

cd /tmp
sudo -u postgres createuser --pwprompt zabbix

V tuto chvíli jsme schopni naimportovat výchozí schéma a data. Opět budeme vyzváni k zadání hesla.
Zde použijeme heslo z předchozího kroku.

sudo -u postgres createdb -O zabbix zabbix
zcat /usr/share/zabbix/sql-scripts/postgresql/server.sql.gz | sudo -u zabbix psql zabbix

Nastavení firewallu

Nazávěr na firewallu povolíme porty, které jsou nezbytné pro běh Zabbix serveru.

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-port=10051/tcp
firewall-cmd --reload

Instalace TimescaleDB

Nyní se pustíme do instalace TimescaleDB a začneme tím, že přidáme její oficiální repozitář.

tee /etc/yum.repos.d/timescale_timescaledb.repo <<EOL
[timescale_timescaledb]
name=timescale_timescaledb
baseurl=https://packagecloud.io/timescale/timescaledb/el/$(rpm -E %{rhel})/\$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/timescale/timescaledb/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOL

Nainstalujme TimescaleDB.

dnf install timescaledb-2-postgresql-17 timescaledb-2-loader-postgresql-17

Spustíme utilitu timescaledb-tune a jako parametr jí předáme vyšší hodnotu maximálního množství připojení (--max-conns), které pro tyto testovací účely nastavíme na 125.

Tato utilita slouží k přizpůsobení výchozího nastavení PostgreSQL vůčihledně výkonu a adekvátnímu nastavení parametrů PostgreSQL pro fungování s TimescaleDB.

Zároveň nám tato utilit pomocí instalačního průvodce pomůže vybrat aktuální a platný konfigurační soubor PostgreSQL a nastaví i automatické načítání knihoven TimescaleDB.

Prosím, odpovídejte „ano“ (y) na všechny otázky. Pozor, automatický tuner předpokládá, že PostgreSQL běží na samostatném serveru, a proto může být potřeba případně upravit parametry.

timescaledb-tune --pg-config /usr/pgsql-17/bin --max-conns=125

Následně restartujeme systémovou službu pro PostgreSQL:

systemctl restart postgresql-17.service

Zbývá již jen vytvořit a aktivovat samotnou TimescaleDB:

Pozor, během vývoje došlo ke změně cesty z původní /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql na novou /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql.

echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix
cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix

Nastavení Zabbix serveru

Otevřeme konfigurační soubor Zabbix serveru v cestě:

nano /etc/zabbix/zabbix_server.conf

V tomto konfiguračním souboru upravíme následující parametry tak, jak vídíte na předloze níže:

...
DBPassword=password
StartReportWriters=1
WebServiceURL=http://localhost:10053/report
...

V dalším kroku doinstalujeme všechny jazykové balíčky pro Zabbix frontend:

dnf install glibc-langpack-en glibc-langpack-cs glibc-langpack-sk glibc-langpack-fr glibc-langpack-de glibc-langpack-es glibc-langpack-it glibc-langpack-zh glibc-langpack-pt glibc-langpack-da glibc-langpack-nb glibc-langpack-pl glibc-langpack-tr glibc-langpack-he glibc-langpack-ja glibc-langpack-ko glibc-langpack-ru glibc-langpack-uk glibc-langpack-ca glibc-langpack-ka glibc-langpack-vi

A nakonec restartujeme všechny související služby a nastavíme je tak, aby se spouštěly automaticky po startu:

systemctl restart zabbix-server zabbix-web-service zabbix-agent2 httpd php-fpm
systemctl enable zabbix-server zabbix-web-service zabbix-agent2 httpd php-fpm

Pro ověření stavu, že nám Zabbix server nastartoval v pořádku můžeme kromě jiného zkontrolovat i jeho log soubor:

less /var/log/zabbix/zabbix_server.log

V případě, že uvidíte v log souboru zprávu o tom, že je verze TimescaleDB příliš nová, pak to není žádný velký problém. Zabbix nedokáže dostatečně rychle reagovat na nejnovější verze TimescaleDB tak, aby ji ve svém kódu nastavil jako podporovanou, ovšem kompatibilita je Zabbixem zaručena a námi ověřena.

V případě této chyby stačí otevřít konfigurační soubor Zabbix serveru v cestě /etc/zabbix/zabbix_server.conf a zde upravte následující konfigurační parametr:

AllowUnsupportedDBVersions=1

Soubor s tímto nastavením uložte a zrestartujte systémovou službu Zabbix serveru.

systemctl restart zabbix-server

Nastavení Zabbix frontendu

V prohlížeči si otevřeme cílové URL, na kterém Zabbix běží. Například tedy http://192.168.0.50/zabbix, kde nás uvítá průvodce prvotní instalací.

Po zvolení implicitního jazyka se tlačítkem Next step posuneme na stránku s kontrolou minimálních požadavků.

Pokud je kontrola v pořádku, pak se tedy můžeme kliknutím na Next step posunout na další stránku s nastavením připojení do databáze.

Zde vyplňujeme pouze políčko Password pro přístup do databáze, nic dalšího není třeba měnit.

Po vyplnění opět klikneme na Next step.

Na následující stránce se základním nastavením vyplníme název serveru, časové pásmo, a kliknutím na Next step pokračujeme k souhrnu konfigurace.

V tomto souhrnu zkontrolumeme všechny zadané hodnoty a kliknutím na Next step dokončíme instalaci.

Nyní již kliknutím na tlačítko Finish přejdeme na přihlašovací obrazovku.

Po úspěšném přihlášení pomocí dříve zadaných údajů můžeme začít používat nejnovější Zabbix verze 7.2 (Admin/zabbix).

A takto vypada úvodní dashboard nového Zabbixu 7.2:

Nastavení Zabbix reportingu

Proto, aby byl plně funkční reporting se všemi jeho vylepšeními si nejprve musíme nainstalovat Google Chrome.

Následujícím příkazem stáhneme instalační balíček, a ten také nainstalujeme:

wget https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm
dnf localinstall google-chrome-stable_current_x86_64.rpm

V dalším kroku upravíme v Zabbix frontendu parametr „Frontend URL“ na aktuálně platnou hodnotu, toto nastavení se nachází zde:

Administration -> General -> Other

Příklad této konfigurace pak můžete vidět na obrázku níže.

---

Instalace závislostí

apt install sudo gpg curl wget

Instalace PostgreSQL

V prvním kroku si nainstalujeme repozitáře pro PostgreSQL a zakážeme výchozí systémové repozitáře PostgreSQL. Na otázku ‚This script will enable the PostgreSQL APT repository on apt.postgresql.org on your system. The distribution codename used will be bookworm-pgdg.‘ stiskněte Enter pro pokračování a potvrzení instalace z oficiálního repozitáře.

apt install -y postgresql-common
/usr/share/postgresql-common/pgdg/apt.postgresql.org.sh

Následně pak nainstalujeme PostgreSQL, v tomto případě to bude aktuálně podporovaná verze 17.

apt -y install postgresql-17

Nastartování PostgreSQL a nastavení automatického spuštění při startu systému

systemctl enable postgresql --now

Instalace Zabbix serveru a jeho součástí

Databáze je nyní nainstalovaná, a můžeme tedy přikročit k instalaci Zabbix serveru a všech jeho součástí.

Přidáme si repozitáře Zabbixu a vyčistíme instalační cache.

wget https://repo.zabbix.com/zabbix/7.2/release/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.2+debian12_all.deb
dpkg -i zabbix-release_latest_7.2+debian12_all.deb
apt update

A nainstalujeme všechny potřebné součásti Zabbixu.

V tomto případě použijeme jako primárního monitorovacího agenta Zabbix Agent 2, který vám doporučujeme používat, jelikož přináší daleko více funkcionalit.

apt install zabbix-server-pgsql zabbix-frontend-php php8.2-pgsql zabbix-apache-conf zabbix-sql-scripts zabbix-agent2 zabbix-web-service

Inicializace databáze

Nejprve vytvoříme databázového uživatele pro Zabbix. Během procesu budeme vyzváni k zadání jeho přístupového hesla. Dále vytvoříme prázdnou databázi a nastavíme jí příslušná oprávnění.

sudo -u postgres createuser --pwprompt zabbix
sudo -u postgres createdb -O zabbix zabbix

V tuto chvíli jsme schopni naimportovat výchozí schéma a data. Opět budeme vyzváni k zadání hesla.
Zde použijeme heslo z předchozího kroku.

zcat /usr/share/zabbix/sql-scripts/postgresql/server.sql.gz | sudo -u zabbix psql zabbix

Instalace TimescaleDB

Nyní se pustíme do instalace TimescaleDB a začneme tím, že přidáme její oficiální repozitář.

echo "deb https://packagecloud.io/timescale/timescaledb/debian/ $(lsb_release -c -s) main" | sudo tee /etc/apt/sources.list.d/timescaledb.list
wget --quiet -O - https://packagecloud.io/timescale/timescaledb/gpgkey | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/timescaledb.gpg

Nainstalujme TimescaleDB.

apt update
apt install timescaledb-2-postgresql-17 timescaledb-2-loader-postgresql-17

Spustíme utilitu timescaledb-tune a jako parametr jí předáme vyšší hodnotu maximálního množství připojení (--max-conns), které pro tyto testovací účely nastavíme na 125.

Tato utilita slouží k přizpůsobení výchozího nastavení PostgreSQL vůčihledně výkonu a adekvátnímu nastavení parametrů PostgreSQL pro fungování s TimescaleDB.

Zároveň nám tato utilit pomocí instalačního průvodce pomůže vybrat aktuální a platný konfigurační soubor PostgreSQL a nastaví i automatické načítání knihoven TimescaleDB.

Prosím, odpovídejte „ano“ (y) na všechny otázky. Pozor, automatický tuner předpokládá, že PostgreSQL běží na samostatném serveru, a proto může být potřeba případně upravit parametry.

timescaledb-tune --pg-config /usr/bin --max-conns=125

Následně restartujeme systémovou službu pro PostgreSQL:

systemctl restart postgresql

Zbývá již jen vytvořit a aktivovat samotnou TimescaleDB:

Pozor, během vývoje došlo ke změně cesty z původní /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql na novou /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql.

echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix
cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix

Nastavení Zabbix serveru

Otevřeme konfigurační soubor Zabbix serveru v cestě:

nano /etc/zabbix/zabbix_server.conf

V tomto konfiguračním souboru upravíme následující parametry tak, jak vídíte na předloze níže:

...
DBPassword=password
StartReportWriters=1
WebServiceURL=http://localhost:10053/report
...

V dalším kroku nastavíme jazykové balíčky pro Zabbix frontend. Můžete zvolit pouze ty, které potřebujete, nebo povolit všechny.

sed -i '/# en_US.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# en_GB.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# cs_CZ.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# sk_SK.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# fr_FR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# de_DE.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# es_ES.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# it_IT.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# zh_CN.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# pt_PT.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# pt_BR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# da_DK.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# nb_NO.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# pl_PL.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# tr_TR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# he_IL.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ja_JP.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ko_KR.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ru_RU.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# uk_UA.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ca_ES.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# ka_GE.UTF-8 UTF-8/s/^# //' /etc/locale.gen
sed -i '/# vi_VN UTF-8/s/^# //' /etc/locale.gen
locale-gen

A nakonec restartujeme všechny související služby a nastavíme je tak, aby se spouštěly automaticky po startu:

systemctl restart zabbix-server zabbix-web-service zabbix-agent2 apache2
systemctl enable zabbix-server zabbix-web-service zabbix-agent2 apache2

Pro ověření stavu, že nám Zabbix server nastartoval v pořádku můžeme kromě jiného zkontrolovat i jeho log soubor:

less /var/log/zabbix/zabbix_server.log

V případě, že uvidíte v log souboru zprávu o tom, že je verze TimescaleDB příliš nová, pak to není žádný velký problém. Zabbix nedokáže dostatečně rychle reagovat na nejnovější verze TimescaleDB tak, aby ji ve svém kódu nastavil jako podporovanou, ovšem kompatibilita je Zabbixem zaručena a námi ověřena.

V případě této chyby stačí otevřít konfigurační soubor Zabbix serveru v cestě /etc/zabbix/zabbix_server.conf a zde upravte následující konfigurační parametr:

AllowUnsupportedDBVersions=1

Soubor s tímto nastavením uložte a zrestartujte systémovou službu Zabbix serveru.

systemctl restart zabbix-server

Nastavení Zabbix frontendu

V prohlížeči si otevřeme cílové URL, na kterém Zabbix běží. Například tedy http://192.168.0.50/zabbix, kde nás uvítá průvodce prvotní instalací.

Po zvolení implicitního jazyka se tlačítkem Next step posuneme na stránku s kontrolou minimálních požadavků.

Pokud je kontrola v pořádku, pak se tedy můžeme kliknutím na Next step posunout na další stránku s nastavením připojení do databáze.

Zde vyplňujeme pouze políčko Password pro přístup do databáze, nic dalšího není třeba měnit.

Po vyplnění opět klikneme na Next step.

Na následující stránce se základním nastavením vyplníme název serveru, časové pásmo, a kliknutím na Next step pokračujeme k souhrnu konfigurace.

V tomto souhrnu zkontrolumeme všechny zadané hodnoty a kliknutím na Next step dokončíme instalaci.

Nyní již kliknutím na tlačítko Finish přejdeme na přihlašovací obrazovku.

Po úspěšném přihlášení pomocí dříve zadaných údajů můžeme začít používat nejnovější Zabbix verze 7.2 (Admin/zabbix).

A takto vypada úvodní dashboard nového Zabbixu 7.2:

Nastavení Zabbix reportingu

Proto, aby byl plně funkční reporting se všemi jeho vylepšeními si nejprve musíme nainstalovat Google Chrome.

Následujícím příkazem stáhneme instalační balíček, a ten také nainstalujeme:

curl -fSsL https://dl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor | sudo tee /usr/share/keyrings/google-chrome.gpg >> /dev/null
echo deb [arch=amd64 signed-by=/usr/share/keyrings/google-chrome.gpg] http://dl.google.com/linux/chrome/deb/ stable main | sudo tee /etc/apt/sources.list.d/google-chrome.list
apt update
apt install google-chrome-stable

V dalším kroku upravíme v Zabbix frontendu parametr „Frontend URL“ na aktuálně platnou hodnotu, toto nastavení se nachází zde:

Administration -> General -> Other

Příklad této konfigurace pak můžete vidět na obrázku níže.

Dokončovací práce

• Zkontrolujte, že správně běží Zabbix server, databázový server a mají správnou verzi
• Zkontrolujte také, zda při startu serveru nebo proxy v systému neuvidíte následující chybu: ‚…the user limit of 1024 file descriptors is insufficient. The maximum number of concurrent checks per worker has been reduced…‘ Návod na odstranění naleznete na naší wiki.

Podpora pro Item Browser

Veškeré potřebné kroky naleznete v samostatném návodu na naší wiki.

NovýZabbix

21. 6. 2024

7.0 Workshop: Zabbix 7.0 – Monitorování pomocí Browser Item pomocí aplikace Selenium

Zhlédnout záznam

Vlastní rebranding

Veškeré potřebné kroky naleznete v samostatném návodu na naší wiki.

The post Zabbix 7.2 – návod na instalaci v 5 minutách appeared first on initMAX s.r.o..

Návod, jak aktualizovat PostgreSQL, naleznete v našem wiki článku. Dále zde najdete i návod na aktualizaci TimescaleDB.

Výběr operačního systému

Návod obsahuje postup pro RHEL platformy na verzi 9, kde stačí případně jen poupravit repozitáře. Návod pro Debian je připraven pro verzi 12, která je aktuálně poslední podporovanou verzí.

NovýZabbix

18. 12. 2024

Aktualizace na poslední verzi Zabbix 7.2

Zhlédnout záznam

Přípravné kroky

• Přečtěte si „poznámky k vydané verzi“ (release notes) [ Official release notes for Zabbix 7.2 ]
• Přečtěte si důkladně dokument „poznámky k aktualizaci“ (upgrade notes) [ Official upgrade notes for Zabbix 7.2 ]
• Zkontrolujte a případně optimalizujte výkon současné databáze dle doporučení vendora a s ohledem na požadavky Zabbix instance
• Zkontrolujte, zda verze veškerých komponent odpovídají matici kompatiblity nové verze Zabbix
• Zazálohujte konfigurační soubory Zabbix serveru a Zabbix proxy
• Zázálohujte databáze Zabbix serveru, případně Zabbix proxy
• Zazálohujte veškeré možné úpravy „na míru“, které byly na úrovni Zabbix ručně provedeny
• Musíte vypnout HA na straně Zabbix serveru.

Kontrola verzí

Nejprve zkontrolujeme verze všech komponent, na kterých je běh Zabbixu a jeho součástí závislý, tak aby přesně odpovídaly oficiální matici kompatibility pro Zabbix 7.2.

php-fpm -v
psql -V

Záloha konfiguračních souborů Zabbix

Než se pustíme do dalších kroků, zazálohujeme veškeré konfigurační soubory Zabbix serveru a Zabbix Proxy.

cp -R /etc/zabbix/ /<backup directory>/
cp -R /usr/lib/zabbix/alertscripts/ /<backup directory>/
cp -R /usr/lib/zabbix/externalscripts/ /<backup directory>/
cp -R /usr/share/zabbix/ /<backup directory>/
cp /etc/httpd/conf/httpd.conf /<backup directory>/
cp /etc/httpd/conf.d/zabbix.conf /<backup directory>/

Zastavení služeb

Nejprve zastavíme Zabbix server a webserver, aby do databáze již nic nezapisovaly.

systemctl stop zabbix-server
systemctl stop httpd

Aktualizace databáze (Volitelně)

Dejte si prosím pozor na kombinaci PostgreSQL 17 a TimescaleDB 2.17. Tato verze má problém s načítáním starších dat. V případě potíží doporučujeme provést jednu z následujících akcí:

• Downgrade extenze – přejděte na verzi TimescaleDB 2.16.2.
• Aktualizace na TimescaleDB 2.18 – tento problém řeší.
• Použití workaroundu – do souboru postgresql.conf přidejte parametr pro vypnutí vektorizace a restartuje DB.

timescaledb.enable_vectorized_aggregation = off

Detailní návod na aktualizaci PostgreSQL naleznete na naší wiki.

Aktualizace Zabbix

Vše jsme úspěšně zazálohovali a zaktualizovali všechny verze návazných komponent dle oficiální matice kompatibility nové verze Zabbixu.

Nyní přejdeme k aktualizaci samotného Zabbixu a všech jeho součástí.

Nejprve si stáhneme instalační balíčky pro repozitáře nové verze Zabbixu a smažeme instalační cache:

rpm -Uvh https://repo.zabbix.com/zabbix/7.2/release/rocky/9/noarch/zabbix-release-latest-7.2.el9.noarch.rpm
dnf clean all

Po tomto úkonu máme dostupné repozitáře nové verze a můžeme tedy zaktualizovat veškeré další komponenty Zabbix, a to postupně i na všech Zabbix Proxy:

dnf update zabbix-* -y

Po úspěšném dokončení aktualizace balíčků Zabbix serveru a všech jeho součástí můžeme Zabbix znovu spustit, aby se dokončil upgrade databázové struktury.

systemctl start zabbix-server.service

Postupné činnosti i celý proces aktualizace, včetně případných zásahů do struktury databázového schématu, lze sledovat v log souboru Zabbix serveru:

tail -f /var/log/zabbix/zabbix_server.log

Po úspěšném dokončení aktualizace databázové struktury můžeme znovu spustit náš webový server. To provedeme následujícím příkazem:

systemctl start httpd

Záloha konfiguračních souborů Zabbix

Než se pustíme do dalších kroků, zazálohujeme veškeré konfigurační soubory Zabbix serveru a Zabbix Proxy.

cp -R /etc/zabbix/ /<backup directory>/
cp -R /usr/lib/zabbix/alertscripts/ /<backup directory>/
cp -R /usr/lib/zabbix/externalscripts/ /<backup directory>/
cp -R /usr/share/zabbix/ /<backup directory>/
cp -R /etc/apache2/ /<backup directory>/

Zastavení služeb

Nejprve zastavíme Zabbix server a webserver, aby do databáze již nic nezapisovaly.

systemctl stop zabbix-server
systemctl stop apache2

Aktualizace databáze (Volitelně)

Dejte si prosím pozor na kombinaci PostgreSQL 17 a TimescaleDB 2.7. Tato verze má problém s načítáním starších dat. V případě potíží doporučujeme provést jednu z následujících akcí:

• Downgrade extenze – přejděte na verzi TimescaleDB 2.16.2.
• Aktualizace na TimescaleDB 2.8 – tento problém řeší.
• Použití workaroundu – do souboru postgresql.conf přidejte parametr pro vypnutí vektorizace a restartuje DB.

timescaledb.enable_vectorized_aggregation = off

Detailní návod na aktualizaci PostgreSQL naleznete na naší wiki.

Aktualizace Zabbix

Vše jsme úspěšně zazálohovali a zaktualizovali všechny verze návazných komponent dle oficiální matice kompatibility nové verze Zabbixu.

Nyní přejdeme k aktualizaci samotného Zabbixu a všech jeho součástí.

Nejprve si stáhneme instalační balíčky pro repozitáře nové verze Zabbixu a nainstalujeme je:

wget https://repo.zabbix.com/zabbix/7.2/release/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.2+debian12_all.deb
dpkg -i zabbix-release_latest_7.2+debian12_all.deb

Po tomto úkonu máme dostupné repozitáře nové verze a můžeme tedy zaktualizovat veškeré další komponenty Zabbix, a to postupně i na všech Zabbix Proxy:

apt update
apt install --only-upgrade $(dpkg -l | grep zabbix | awk '{print $2}')

Po úspěšném dokončení aktualizace balíčků Zabbix serveru a všech jeho součástí můžeme Zabbix znovu spustit, aby se dokončil upgrade databázové struktury.

systemctl start zabbix-server.service

Postupné činnosti i celý proces aktualizace, včetně případných zásahů do struktury databázového schématu, lze sledovat v log souboru Zabbix serveru:

tail -f /var/log/zabbix/zabbix_server.log

Po úspěšném dokončení aktualizace databázové struktury můžeme znovu spustit náš webový server. To provedeme následujícím příkazem:

systemctl start apache2

Dokončovací práce

• Zkontrolujte, že správně běží Zabbix server, databázový server a mají správnou verzi
• Zkontrolujte také, zda při startu serveru nebo proxy v systému neuvidíte následující chybu: ‚…the user limit of 1024 file descriptors is insufficient. The maximum number of concurrent checks per worker has been reduced…‘ Návod na odstranění naleznete na naší wiki.
• Zkontrolujte, že běží všechny Zabbix proxy a mají správnou verzi. Je zajištěna zpětná kompatibilita (částečná) pro verzi 7.0. Nicméně i tak důrazně doporučujeme používat stejnou verzi, jakou má Zabbix server. Starší verze nejsou podporovány.
• Zkontrolujte stav Zabbix serveru a Zabbix proxy (log soubory, nepodporované položky, fronty, monitorovací skripty, atd.).
• Zkontrolujte, zda vaše servery mají přiděleny poslední verze oficiálních šablon od Zabbixu. [ Zabbix GIT ]

Co je nového v Zabbixu 7.2

Informace o novinkách v Zabbixu 7.2 naleznete v našem článku, nebo se můžete podívat na náš webinář, který je zaměřen právě na tyto novinky.

NovýZabbix

12. 12. 2024

Co je nového v Zabbixu 7.2

Zhlédnout záznam

A to je vše! Nyní můžete začít využívat váš nově zaktualizovaný Zabbix ve verzi 7.2 se všemi jeho opravami i novinkami.

The post Zabbix – aktualizace na poslední verzi 7.2 appeared first on initMAX s.r.o..

Upozorňujeme, že bezplatný plán Teams nepodporuje funkci MS Teams Workflow.

Pokud ve svém MS Teams vidíte hlášku: ‚Important: You must update your Webhook URL for this connection in order for your notifications to keep posting into Microsoft Teams.‚ tento návod vás provede novou možností integrace, která nahrazuje starou verzi konektoru za MS Teams Workflow.

Kontrola hlášky v MS Teams

Tato část je pouze pro uživatele Zabbixu, kteří již mají integraci s MS Teams nastavenou. Pokud ji nemáte, tento krok ignorujte a pokračujte na další.

• Ověřte, zda v MS Teams vidíte hlášku: „Important: You must update your Webhook URL for this connection in order for your notifications to keep posting into Microsoft Teams.“
• Tato hláška znamená, že je třeba aktualizovat webhook URL pro zachování funkčnosti notifikací.

Nastavení v MS Teams

• Klikněte na menu v levé části obrazovky označené třemi tečkami.
• Do vyhledávacího pole napište „Workflows“.
• Ze seznamu vyberte oficiální verzi (poznáte ji podle obrázku) a klikněte na tlačítko „Add“.

• V levé části se nám v menu objeví nové tlačítko s názvem „Workflows“ a klikneme na něj.
• V okně Workflows klikneme na „+ New flow“.

• V okně Workflows klikneme na vyhledávání a zadáme: „Post a channel when a webhook request is received“.
• Ve výsledcích vyhledávání klikneme na první výsledek, který není svázán s žádným uživatelem, jak je zobrazeno na obrázku.

• V nově otevřeném pop-up okně zadáme název naší aplikace, abychom ji v budoucnu snadno identifikovali.
• Po zadání názvu můžeme pokračovat tlačítkem „Next“.

• Na další stránce vybereme naši Teams skupinu, kam budeme chtít posílat notifikace, případně zvolíme stejnou skupinu, kterou již používáme pro staré nastavení webhooku.
• Uvnitř naší Teams skupiny si vybereme konkrétní kanál.

• Na finální stránce si zkopírujeme naši vygenerovanou URL, která bude používána v Zabbixu.
• Doporučujeme zatím stránku v Teams nezavírat a pro jistotu si URL poznamenat mimo Zabbix a Teams.

Nastavení URL Zabbixu

V Zabbix webovém rozhraní přejděte na Administration → Macros.

Nastavte globální proměnnou {$ZABBIX.URL} s URL Zabbix frontend rozhraní. Ujistěte se, že URL obsahuje protokol (http nebo https). Tato URL adresa bude součástí vaší události jako odkaz na problém.

Import media typu

Přejděte do Alerts → Media types a naimportujte soubor media_msteams_workflow.yaml. Je možné, že šablonu již ve vašem Zabbixu máte, ale pro jistotu ji znovu importujte, může obsahovat aktualizace. Je potřeba přepnout se na konkrétní verzi v levém horním rohu, kde si zvolíte vaši verzi Zabbixu.

Konfigurace media typu MS Teams Workflow

Otevřete nastavení pro nový media type MS Teams Workflow a nahraďte zástupný text <PLACE WEBHOOK URL HERE> URL adresou workflow endpointu získanou v posledním kroku v části „Nastavení v MS Teams„.

Nezapomeňte nastavení uložit.

Otestování našeho nastavení

Pro otestování našeho nastavení využijeme vestavěnou funkci tlačítka Test na úrovni Media.

Je potřeba vyplnit základní parametry (jedná se o testovací data), část teams_endpoint se vyplní automaticky.

• alert_message = TEST Message
• alert_subject = TEST Subject
• event_severity = 3 (Zde lze napsat cokoliv; zde je číslo 3 pro příklad, protože do části event_severity lze zadávat čísla podle úrovní závažnosti. Možné hodnoty: 0 – Not classified, 1 – Information, 2 – Warning, 3 – Average, 4 – High, 5 – Disaster.)
• event_source = 1 (Možné hodnoty: 0 – Trigger, 1 – Discovery, 2 – Autoregistration, 3 – Internal, 4 – Service.)
• zabbix_url = https://www.initmax.cz/zabbix (Zde vyplňte stejnou URL adresu, kterou jste zadali do makra; bohužel v této části si Zabbix neumí makro přeložit, proto ji vyplníme ručně.)

Po vyplnění parametrů odešlete formulář kliknutím na tlačítko Test.

Po odeslání uvidíte ověřovací zprávu a v části Response uvidíte výsledek. Mělo by se vám vrátit „OK“.

Pokud se vám vrátila zpráva „OK,“ je vše v pořádku. Pokud se nevrátí, v této části nebo v horní části pop-up okna uvidíte, co konkrétně nefunguje. K dispozici je také velmi užitečná sekce pod tlačítkem Open log.

Nyní se můžeme podívat do naší Teams skupiny na novou zprávu, která byla vytvořena pomocí Zabbixu přes funkcionalitu Microsoft Teams – Workflows.

Finalizace a rady na závěr

Pro použití nastavení si musíte vytvořit odpovídající akci nebo ji upravit. Nezapomeňte uživatelům, kterým se zasílá notifikace, doplnit adresu v médiích – obvykle se jedná o sběrný účet. Toto není součástí tohoto návodu, protože se jedná o běžné nastavení notifikací a není zde potřeba nic speciálního.

Do části Send to je jedno, co zadáte. Na obrázku vidíte původní a nové nastavení pro našeho uživatele používaného pro notifikace. Nezapomeňte také upravit odpovídající akce.

Použití parametru http_proxy pro media type v Zabbixu umožňuje přesměrovat požadavky přes proxy server. Tento parametr je užitečný, pokud váš Zabbix server nemá přímý přístup k internetu (např. kvůli bezpečnostním omezením) a připojuje se k externím službám (např. webhooky pro Microsoft Teams) přes proxy server.

Obsah zprávy a vzhled zprávy v Microsoft Teams si můžete upravit na úrovni šablony zprávy (message template) v části nastavení media typu v Zabbixu nebo přímou úpravou JavaScriptového kódu. Můžete například nastavit různé barvy pro odlišné úrovně závažnosti (severity). Podrobnější dokumentaci naleznete na webu Microsoftu.

The post Integrace Microsoft Teams v pěti krocích appeared first on initMAX s.r.o..

Přesně tím se bude zabývat tento článek. Zabbix umožňuje nativně změnit logo pro přihlašovací obrazovku a obě loga v menu. Tento rebranding lze jednoduše provést pomocí skrytého nastavení v souboru brand.conf.php.

Pokud chcete v Zabbixu provést rebranding, postupujte podle následujících kroků:

Vytvoření adresářové struktury a souborů

Nejprve zajistěte, že máte požadovanou strukturu adresářů. Vytvořte adresáře conf a rebranding:

Pro verzi 7.0 a starší

sudo mkdir -p /usr/share/zabbix/local/conf
sudo mkdir -p /usr/share/zabbix/rebranding

Pro verzi 7.2 a novější

sudo mkdir -p /usr/share/zabbix/ui/local/conf
sudo mkdir -p /usr/share/zabbix/ui/rebranding

Nahrání vlastních log

Připravte si loga s následujícími rozměry:

• Hlavní logo: 114×30 px
• Logo pro postranní panel: 91×24 px
• Kompaktní logo pro postranní panel: 24×24 px

Doporučené formáty souborů jsou SVG nebo PNG s transparentním pozadím. Ostatní formáty budou fungovat také, ale mohou mít okraje.

Případně můžete pro testování využít naše testovací data (obrázky a konfiguraci).

Nahrajte své obrázky do adresáře /usr/share/zabbix/rebranding. Můžete použít příkaz scp nebo rsync, pokud nahráváte z jiného serveru, nebo jednoduše zkopírujte soubory přímo:

Pro verzi 7.0 a starší

sudo cp /cesta/k/vašim/obrázkům/*.svg /usr/share/zabbix/rebranding/

Pro verzi 7.2 a novější

sudo cp /cesta/k/vašim/obrázkům/*.svg /usr/share/zabbix/ui/rebranding/

Oprávnění k souborům vyřešíme později.

Nastavení brand.conf.php

Vytvořte nebo upravte soubor brand.conf.php:

Pro verzi 7.0 a starší

sudo nano /usr/share/zabbix/local/conf/brand.conf.php

Pro verzi 7.2 a novější

sudo nano /usr/share/zabbix/ui/local/conf/brand.conf.php

Příklad obsahu souboru:

<?php
return [
    'BRAND_LOGO' => './rebranding/initMAX_Zabbix_Logo_Colors_114x30.svg',
    'BRAND_LOGO_SIDEBAR' => './rebranding/initMAX_Zabbix_Logo_White_91x24.svg',
    'BRAND_LOGO_SIDEBAR_COMPACT' => './rebranding/initMAX_Zabbix_Symbol_White_24x24.svg',
    'BRAND_FOOTER' => 'initMAX s.r.o.',
    'BRAND_HELP_URL' => 'https://www.initmax.com/'
];

Ujistěte se, že názvy souborů odpovídají nastavení v brand.conf.php.

V případě potřeby můžete jednotlivé části zakomentovat pomocí dvou obrácených lomítek //.

Co znamenají jednotlivé části v PHP kódu?

• BRAND_LOGO – Hlavní logo, které se zobrazí na přihlašovací obrazovce.
• BRAND_LOGO_SIDEBAR – Logo, které se objeví v levém menu.
• BRAND_LOGO_SIDEBAR_COMPACT – Logo pro levé menu v kompaktním režimu (symbol).
• BRAND_FOOTER – Možnost přidat vlastní text do patičky.
• BRAND_HELP_URL – URL, která se otevře po kliknutí na tlačítko „Help“.

Nastavení oprávnění

Ujistěte se, že soubory a složky mají správná oprávnění a vlastníka (obvykle www-data nebo apache, v závislosti na konfiguraci webového serveru):

Pro verzi 7.0 a starší

sudo chown -R www-data:www-data /usr/share/zabbix/local/conf
sudo chmod 755 /usr/share/zabbix/local/conf
sudo chmod 644 /usr/share/zabbix/local/conf/brand.conf.php
sudo chown -R www-data:www-data /usr/share/zabbix/rebranding
sudo chmod 755 /usr/share/zabbix/rebranding
sudo chmod 644 /usr/share/zabbix/rebranding/*

Pro verzi 7.2 a novější

sudo chown -R www-data:www-data /usr/share/zabbix/ui/local/conf
sudo chmod 755 /usr/share/zabbix/ui/local/conf
sudo chmod 644 /usr/share/zabbix/ui/local/conf/brand.conf.php
sudo chown -R www-data:www-data /usr/share/zabbix/ui/rebranding
sudo chmod 755 /usr/share/zabbix/ui/rebranding
sudo chmod 644 /usr/share/zabbix/ui/rebranding/*

Kontrola rebrandingu

Otevřete Zabbix webové rozhraní a zkontrolujte, zda se nové logo a další prvky rebrandingu zobrazují správně. Pravděpodobně bude potřeba vymazat cache prohlížeče, aby se změny plně projevily.

Dodatečný tip: Pokud se v kompaktním režimu ikona zobrazuje dvakrát, jedná se o známý bug (viz ZBX-23676), který je vyřešen ve verzích od:

pre-7.2.0alpha2 (master) – commit 6f04c309093

pre-7.0.6rc1 – commit 0026d10fee4

Další nápady na vylepšení rebrandingu

Pro lepší přizpůsobení Zabbixu můžete přidat vlastní ikony a favicon, což zajistí konzistentní vzhled v záložkách prohlížeče i na mobilních zařízeních. Ikony stačí nahrát do adresáře, kde jsou umístěny webové soubory Zabbixu.

Pokud potřebujete ikony rychle vygenerovat, můžete použít RealFaviconGenerator – stačí nahrát vaše logo a stáhnout si balíček hotových ikon.

Tip: Doporučujeme nahrát ikony do adresáře s rebrandingem. Pokud je ale chcete přidat trvale, bude nutné upravit konfiguraci Apache nebo Nginx, aby se např. favicon.ico nepřepsalo po aktualizaci. V případě potřeby nás neváhejte kontaktovat o radu.

The post Rebranding Zabbixu appeared first on initMAX s.r.o..

POZOR: Současná verze TimescaleDB NEFUNGUJE s nejnovější verzí PostgreSQL (18)

Výhody TimescaleDB v Zabbixu

TimescaleDB přináší do Zabbixu několik zásadních výhod, které zvyšují výkon a efektivitu při práci s velkými objemy časových dat:

• Škálovatelnost a Výkon: TimescaleDB je navrženo tak, aby efektivně spravovalo velké množství časových dat. Díky architektuře hypertables umožňuje rychlé zápisy a čtení dat, což je klíčové pro systémy monitorování, jako je Zabbix, které generují obrovské množství metrik.
• Komprese dat: TimescaleDB nabízí schopnost komprese historických dat, což snižuje nároky na úložiště a může vést až k 90% úspoře místa na disku. Komprese však znemožňuje změnu již zkomprimovaných dat; pro případnou úpravu je nutné data nejprve dekomprimovat, provést změnu a poté opět komprimovat.
• Snadná správa: TimescaleDB je plně kompatibilní s PostgreSQL, což znamená, že správci, kteří jsou obeznámeni s PostgreSQL, se snadno zorientují i v TimescaleDB. Implementace je jednoduchá a přidává jen minimální režijní náklady na správu databáze. Dále je možné některá nastavení TimescaleDB upravovat přímo v administraci Zabbixu, konkrétně v sekci Administration > Housekeeping.

Tabulky v Zabbixu využívající TimescaleDB

Zabbix používá TimescaleDB k ukládání velkého množství časových dat, která jsou rozdělena do několika klíčových tabulek. Aby byl tento proces efektivní a dobře spravovaný, využívá se speciální struktura zvaná hypertable, která je navržena pro práci s časovými daty v TimescaleDB. Pro usnadnění konverze existujících tabulek na hypertables a optimalizaci správy těchto dat obsahuje soubor /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql skript s potřebnými příkazy. Tento skript automatizuje převod klíčových tabulek Zabbixu na hypertables, což zajišťuje efektivní práci s velkými objemy dat.

Poznámka: Od verze Zabbixu 7.2 se skript schema.sql pro TimescaleDB nachází v následující cestě:
/usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql.

Každý příkaz ve skriptu využívá funkci create_hypertable, která je klíčová pro převod běžných tabulek PostgreSQL na hypertables. Hypertable funguje tak, že data automaticky spravuje v menších podtabulkách, zvaných chunky. Toto dělení umožňuje efektivní dotazování a ukládání dat, což je nezbytné pro rychlý přístup k velkým množstvím časových sérií. Proces konverze tabulek na hypertables zahrnuje několik důležitých parametrů:

• Název tabulky (např. 'history_text'): Určuje, která konkrétní tabulka bude převedena na hypertable. V případě tabulky history_text se jedná o textová data, jako jsou zprávy a logy, která jsou v Zabbixu monitorována.
• Časový sloupec (např. 'clock'): Tento parametr definuje sloupec obsahující časové značky (timestamp), které jsou klíčové pro rozdělení dat do jednotlivých chunků. Sloupec 'clock' specifikuje čas, kdy byla data zaznamenána, což umožňuje jejich správné rozdělení a třídění.
• chunk_time_interval (např. 86400): Tento parametr určuje časový interval v sekundách pro jednotlivé chunky. Hodnota 86400 sekund odpovídá jednomu dni. To znamená, že veškerá data shromážděná během jednoho dne budou uložena v jednom chunku. Tento interval lze přizpůsobit podle požadavků na výkon a množství dat, které je třeba zpracovat.
• migrate_data (např. true): Když je tento parametr nastaven na true, všechna existující data v tabulce jsou automaticky migrována do nové struktury chunků. Tato funkce je důležitá při konverzi již existujících tabulek na hypertables, aby nedošlo ke ztrátě dat.
• if_not_exists (např. true): Tento parametr zajišťuje, že pokud hypertable již existuje, příkaz ji nebude znovu vytvářet, což zabraňuje možným chybám a ztrátám dat. Pokud hypertable ještě neexistuje, bude nově vytvořena.

Použitím těchto nastavení TimescaleDB zajišťuje efektivní správu a přístup k velkým objemům časových dat, což je nezbytné pro systémy jako Zabbix, které generují a analyzují velké množství metrik. Níže jsou uvedeny klíčové tabulky, které byly přeměněny na hypertables pro zajištění lepšího výkonu a efektivity:

• history: Uchovává numerická data s plovoucí desetinnou čárkou.

PERFORM create_hypertable('history', 'clock', chunk_time_interval => 86400, migrate_data => true, if_not_exists => true);

• history_uint: Ukládá celá čísla.

PERFORM create_hypertable('history_uint', 'clock', chunk_time_interval => 86400, migrate_data => true, if_not_exists => true);

• history_log: Obsahuje logovací informace.

PERFORM create_hypertable('history_log', 'clock', chunk_time_interval => 86400, migrate_data => true, if_not_exists => true);

• history_text: Ukládá textová data, jako jsou zprávy a logy.

PERFORM create_hypertable('history_text', 'clock', chunk_time_interval => 86400, migrate_data => true, if_not_exists => true);

• history_str: Uchovává krátké textové řetězce.

PERFORM create_hypertable('history_str', 'clock', chunk_time_interval => 86400, migrate_data => true, if_not_exists => true);

• history_bin: Uchovává binární data. (Od verze 7.0.2)

PERFORM create_hypertable('history_bin', 'clock', chunk_time_interval => 86400, migrate_data => true, if_not_exists => true);

• auditlog: Obsahuje logovací informace o aktivitách uživatelů. (Od verze 7.0)

PERFORM create_hypertable('auditlog', 'auditid', chunk_time_interval => 604800, time_partitioning_func => 'cuid_timestamp', migrate_data => true, if_not_exists => true);

• trends: Ukládá agregované historické údaje o metrikách.

PERFORM create_hypertable('trends', 'clock', chunk_time_interval => 2592000, migrate_data => true, if_not_exists => true);

• trends_uint: Ukládá agregovaná historická data pro metriky celých čísel.

PERFORM create_hypertable('trends_uint', 'clock', chunk_time_interval => 2592000, migrate_data => true, if_not_exists => true);

Instalace TimescaleDB v Zabbixu

Příprava na instalaci

Před zahájením instalace TimescaleDB je nutné mít nainstalovaný PostgreSQL a také balíček zabbix-sql-scripts z oficiálního repozitáře pro konkrétní používanou verzi Zabbixu. Zatímco Zabbix jako takový nemusí být nutně nainstalován, zmíněný balíček zabbix-sql-scripts je nezbytný, protože obsahuje potřebné SQL skripty pro konfiguraci databáze. U PostgreSQL se doporučuje instalace z oficiálního repozitáře PostgreSQL, spíše než použití systémového repozitáře, aby byla zajištěna kompatibilita a přístup k nejnovějším funkcím a opravám zabezpečení.

Je důležité poznamenat, že všechny následující příkazy a nastavení se provádějí pouze na serveru PostgreSQL. Instalace TimescaleDB z oficiálního repozitáře TimescaleDB, který podporuje komunitní verzi licence, umožňuje přístup k pokročilým funkcím, jako je komprese dat. Díky komunitní licenci mají uživatelé možnost využívat kompresi, což může výrazně snížit nároky na úložiště a zlepšit výkon dotazů na historická data.

Přidání oficiálního repozitáře TimescaleDB

Pro instalaci TimescaleDB z oficiálního repozitáře je třeba přidat repozitář do systému. Na distribucích založených na RHEL, jako je Rocky Linux, postupujte následovně:

tee /etc/yum.repos.d/timescale_timescaledb.repo <<EOL
[timescale_timescaledb]
name=timescale_timescaledb
baseurl=https://packagecloud.io/timescale/timescaledb/el/$(rpm -E %{rhel})/\$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/timescale/timescaledb/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOL

Nainstalujme TimescaleDB.

Nahraďte číslo verze (16) odpovídající verzí PostgreSQL, kterou používáte.

dnf install timescaledb-2-postgresql-16 timescaledb-2-loader-postgresql-16

Spustíme utility timescaledb-tune a jako parametr jí předáme vyšší hodnotu maximálního množství připojení (--max-conns), které pro tyto testovací účely nastavíme na 125.

Tato utility slouží k přizpůsobení výchozího nastavení PostgreSQL relativně výkonu a adekvátnímu nastavení parametrů PostgreSQL pro fungování s TimescaleDB.

Zároveň nám tato utility pomocí instalačního průvodce pomůže vybrat aktuální a platný konfigurační soubor PostgreSQL a nastaví i automatické načítání knihoven TimescaleDB.

Prosím, odpovídejte „ano“ (y) na všechny otázky. Pozor, automatický tuner předpokládá, že PostgreSQL běží na samostatném serveru, a proto může být potřeba případně upravit parametry.

Nahraďte číslo verze (16) odpovídající verzí PostgreSQL, kterou používáte.

timescaledb-tune --pg-config /usr/pgsql-16/bin --max-conns=125

Následně restartujeme systémovou službu pro PostgreSQL:

Nahraďte číslo verze (16) odpovídající verzí PostgreSQL, kterou používáte.

systemctl restart postgresql-16.service

Zbývá již jen vytvořit a aktivovat samotnou TimescaleDB:

Pozor, během vývoje došlo ke změně cesty z původní /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql na novou /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql.

Poznámka: Od verze Zabbixu 7.2 se skript schema.sql pro TimescaleDB nachází v následující cestě:
/usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql.

Ignorování varování: Při spuštění skriptu schema.sql na verzi TimescaleDB 2.9.0 a vyšší mohou být zobrazena varování o nedodržení osvědčených postupů. Tato varování lze ignorovat, protože konfigurace bude úspěšně dokončena i přes ně.

Dlouhá doba migrace: Migrace existujících historických dat, trendů a audit logů může trvat dlouho. !!! Během této doby musí být Zabbix server a frontend vypnutý !!!, aby byla zajištěna konzistence dat.

Pro verzi Zabbixu 7.0 a starší:

echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix
cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix

Od verze Zabbixu 7.2:

echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix
cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix

Dodatečné informace

Nastavení parametrů čištění (Administration > Housekeeping): Skript schema.sql nastavuje následující parametry čištění:

• Override item history period: Povolit přepsání období uchování historie položek.
• Override item trend period: Povolit přepsání období uchování trendů.

Aby bylo možné použít partitioned housekeeping pro historii a trendy, musí být obě tyto možnosti povoleny. Je také možné povolit přepsání pouze pro historii nebo pouze pro trendy. Pokud bude nastavení aplikováno bude nastavení pro historii a trendy na úrovni itemu ignorovano.

Další parametry ve skriptu schema.sql: Tento skript nastavuje také dva další parametry:

• Enable compression: Povolit kompresi.
• Compress records older than 7 days: Komprimovat záznamy starší než 7 dnů.

Pro úspěšné odstranění komprimovaných dat pomoci housekeeper musí být povoleny jak možnosti Override item history period, tak Override item trend period. Pokud je přepsání deaktivováno a tabulky mají komprimované chunky, správce údržby nebude odstraňovat data z těchto tabulek a v sekcích Housekeeping a System information se zobrazí varování o nesprávné konfiguraci​

V případě, že uvidíte v Zabbix Server log souboru zprávu o tom, že je verze TimescaleDB příliš nová, pak to není žádný velký problém. Zabbix nedokáže dostatečně rychle reagovat na nejnovější verze TimescaleDB tak, aby ji ve svém kódu nastavil jako podporovanou, ovšem kompatibilita je Zabbixem zaručena a námi ověřena.

Pokud se chceme vyhnout zprávám o nekompatibilitě v log souboru Zabbixu, pak stačí otevřít konfigurační soubor Zabbix serveru v cestě /etc/zabbix/zabbix_server.conf a zde upravte následující konfigurační parametr:

AllowUnsupportedDBVersions=1

Soubor s tímto nastavením uložte a znovu nastartujte systémovou službu Zabbix serveru.

systemctl restart zabbix-server

A to je vše! Podařilo se Vám zprovoznit rozšíření pro TimescaleDB a máte základní databázový performance tuning. Následující kroky by měly smeřovat k zálohování a monitoringu DB.

The post Implementace TimescaleDB v Zabbixu: Výhody, Klíčové Tabulky a Instalace appeared first on initMAX s.r.o..

Toto hlášení indikuje, že aktuální limit souborových deskriptorů pro uživatele (v tomto případě uživatele, pod kterým běží Zabbix server nebo proxy) je nastaven na 1024. Tento limit je nedostatečný pro množství operací, které Zabbix provádí, což vede k automatickému snížení maximálního počtu současně probíhajících kontrol na worker. V praxi to znamená, že systém nemůže otevřít dostatek souborů nebo síťových připojení současně, což omezuje efektivitu a výkon Zabbixu při zpracování dat.

Co jsou souborové deskriptory?

Souborové deskriptory jsou identifikátory používané operačním systémem k přístupu k souborům a síťovým zdrojům. Každý proces v systému má svůj limit souborových deskriptorů, což omezuje počet současně otevřených souborů nebo socketů.

Proč zvyšovat limit souborových deskriptorů?

S rostoucím počtem zařízení a dat, které Zabbix monitoruje, může být zapotřebí více souborových deskriptorů. Pokud Zabbix instance potřebuje více deskriptorů, než je aktuální limit, může dojít k chybám nebo omezení výkonu, což může vést ke snížení počtu současných kontrol na worker a zpomalit zpracování dat.

Postup navýšení limitu souborových deskriptorů

Zjištění aktuálního limitu

Nejprve zjistěte aktuální limit souborových deskriptorů pro běžící proces zabbix_server jedním příkazem:

cat /proc/$(pgrep -o zabbix_server)/limits | grep "Max open files"

Tento příkaz vrátí aktuální měkký a tvrdý limit souborových deskriptorů pro proces zabbix_server. Například:

Max open files   1024   524288   files

• První hodnota je měkký limit (soft limit).
• Druhá hodnota je tvrdý limit (hard limit).

Právě soft limit potřebujeme navýšit z 1024 na 10000. Hodnota se musí nastavit podle vašich konkrétních potřeb a může být i vyšší než tento příklad. Zabbix vás případně upozorní v logu, pokud nastavení není dostatečné.

Vytvoření adresáře pro override konfiguraci

Vytvořte adresář pro uložení nové konfigurace systému:

mkdir /etc/systemd/system/zabbix-server.service.d

Nastavení oprávnění

Nastavte správná oprávnění pro tento adresář:

chmod 755 /etc/systemd/system/zabbix-server.service.d

Vytvoření override konfigurace

Vytvořte soubor s override konfigurací pro zvýšení limitu souborových deskriptorů. V tomto příkladu nastavujeme limit na 10000:

echo -e "[Service]\nLimitAS=infinity\nLimitRSS=infinity\nLimitNOFILE=10000\nLimitNPROC=1024" \
| sudo tee /etc/systemd/system/zabbix-server.service.d/override.conf

Nastavení oprávnění pro override konfiguraci

Nastavte správná oprávnění pro tento soubor:

chmod 644 /etc/systemd/system/zabbix-server.service.d/override.conf

Ověření obsahu override konfigurace

Ověřte, že obsah souboru byl správně uložen:

cat /etc/systemd/system/zabbix-server.service.d/override.conf

Aktivace změn

Načtěte nové nastavení systemd:

systemctl daemon-reload

Ověření stavu služby

Zkontrolujte stav služby Zabbix serveru:

systemctl status zabbix-server.service

Na obrázku je vidět, že Zabbix server služba využívá dodatečnou konfiguraci, která je uložena v adresáři /etc/systemd/system/zabbix-server.service.d/ jako soubor override.conf. Tato dodatečná konfigurace obsahuje změny potřebné pro zvýšení limitu souborových deskriptorů.

Restart aplikace

Pro aplikaci nových limitů restartujte službu Zabbix serveru:

systemctl restart zabbix-server.service

Ověření konfigurace po restartu Zabbix serveru

Znovu zkontrolujte aktuální limit souborových deskriptorů pro běžící proces zabbix_server:

cat /proc/$(pgrep -o zabbix_server)/limits | grep "Max open files"

Měli byste vidět, že proces aktuálně běží s novým limitem:

Max open files   10000   10000   files

Závěr

Zvýšení limitu souborových deskriptorů pro konkrétního uživatele může pomoci zabránit problémům spojeným s výkonem a stabilitou Zabbix serveru nebo proxy od verze 7.0. Dodržováním výše uvedených kroků můžete zvýšit limity souborových deskriptorů pro specifického uživatele a zajistit, že vaše Zabbix instance bude moci efektivně zpracovávat více současných požadavků.

The post Zabbix 7.0 a navýšení systémových limitů appeared first on initMAX s.r.o..

NovýZabbix

13. 6. 2024

Aktualizace na poslední verzi Zabbix 7.0

Zhlédnout záznam

Přípravné kroky

• Přečtěte si „poznámky k vydané verzi“ (release notes) [ Official release notes for Zabbix 7.0 LTS ]
• Přečtěte si důkladně dokument „poznámky k aktualizaci“ (upgrade notes) [ Official upgrade notes for Zabbix 7.0 LTS ]
• Zkontrolujte a případně optimalizujte výkon současné databáze dle doporučení vendora a s ohledem na požadavky Zabbix instance
• Zkontrolujte, zda verze veškerých komponent odpovídají matici kompatiblity nové verze Zabbix
• Zazálohujte konfigurační soubory Zabbix serveru a Zabbix proxy
• Zázálohujte databáze Zabbix serveru, případně Zabbix proxy
• Zazálohujte veškeré možné úpravy „na míru“, které byly na úrovni Zabbix ručně provedeny
• Musíte vypnout HA na straně Zabbix serveru.

Kontrola verzí

Nejprve zkontrolujeme verze všech komponent, na kterých je běh Zabbixu a jeho součástí závislý, tak aby přesně odpovídaly oficiální matici kompatibility pro Zabbix 7.0.

php-fpm -v
psql -V

Záloha konfiguračních souborů Zabbix

Než se pustíme do dalších kroků, zazálohujeme veškeré konfigurační soubory Zabbix serveru a Zabbix Proxy.

cp -R /etc/zabbix/ /<backup directory>/
cp -R /usr/lib/zabbix/alertscripts/ /<backup directory>/
cp -R /usr/lib/zabbix/externalscripts/ /<backup directory>/
cp -R /usr/share/zabbix/ /<backup directory>/
cp /etc/httpd/conf/httpd.conf /<backup directory>/
cp /etc/httpd/conf.d/zabbix.conf /<backup directory>/

Zastavení služeb

Nejprve zastavíme Zabbix server a webserver, aby do databáze již nic nezapisovaly.

systemctl stop zabbix-server
systemctl stop httpd

Aktualizace PHP

Nová verze Zabbix 7.0 vyžaduje pro svůj chod PHP v rozmezí verzí 8.0.0 až 8.3.x. Aktuálně máme na serveru verzi 8.0, ale i tak si provedeme aktualizaci.

Případnou aktualizaci provedeme změnou nastavení balíčkovacího systému dnf na úrovni OS. Máme dobré zkušenosti s předposlední verzí, při použití nejnovější verze se může objevit chyba přímo v PHP, která může způsobit problém v používání.

dnf module switch-to php:8.2 -y

Aktualizace databáze

Nejprve zastavíme aktuálně běžící službu PostgreSQL:

(Detailní návod na aktualizaci PostgreSQL naleznete na naší wiki.)

systemctl stop postgresql-13

Následně nainstalujeme konkrétně podporovanou verzi, v našem případě PostgreSQL verze 16:

dnf install -y postgresql16-server

Dále si nainstalujeme rozšíření TimescaleDB, musíme ho však nainstalovat ve stejné verzi, jakou používá vaše stará verze databáze! Pokud nebude ve stejné verzi, nebude nám fungovat příkaz pro upgrade. Pomocí následujícího příkazu si porovnáte aktuálně nainstalovanou verzi pro PostgreSQL 13 a nainstalujete stejné verze balíčků pro PostgreSQL 16:

VERSION=$(rpm -qa | grep timescaledb-2-postgresql-13 | head -1 | sed -n 's/.*-\([0-9]\+\.[0-9]\+\.[0-9]\+\)-.*/\1/p') && dnf install -y timescaledb-2-loader-postgresql-16-$VERSION-0.el9.x86_64 timescaledb-2-postgresql-16-$VERSION-0.el9.x86_64

Poznámka: Pokud verze rozšíření TimescaleDB nebude stejná, uvidíte při upgradu následující chybu:

Nyní můžeme přistoupit k inicializaci databáze nové verze PostgreSQL:

/usr/pgsql-16/bin/postgresql-16-setup initdb

Po úspěšné instalaci všech závislostí spustíme dodaný aktualizační skript, který kvůli kompatibilitě zkontroluje a případně i opraví interní tabulky a schémata oproti změnám mezi verzemi (pod uživatelem postgres):

su - postgres

Přeneseme konfiguraci oprávnění (pg_hba.conf) ze staré verze na novou:

cat /var/lib/pgsql/13/data/pg_hba.conf > /var/lib/pgsql/16/data/pg_hba.conf

Případně i konfiguraci samotného databázového serveru (kompatibilitu jednotlivých konfiguračních direktiv mezi verzemi si předem ověřte):

cat /var/lib/pgsql/13/data/postgresql.conf > /var/lib/pgsql/16/data/postgresql.conf

Spustíme migraci databáze

/usr/pgsql-16/bin/pg_upgrade -b /usr/pgsql-13/bin -B /usr/pgsql-16/bin -d /var/lib/pgsql/13/data -D /var/lib/pgsql/16/data -k

Odhlásíme se od uživatele postgres:

logout

Nyní lze zakázat automatické spouštění staré služby po startu:

systemctl disable postgresql-13.service

A nastartovat novou verzi databázového serveru PostgreSQL, včetně jejího automatického spouštění po startu systému:

systemctl enable postgresql-16.service --now

Po úspěšném spuštění PostgreSQL serveru jako první krok musíme zkontrolovat a případně aktualizovat naši TimescaleDB uvnitř Zabbix databáze:

su - postgres

psql -X

\c zabbix

V dalším kroku aktualizujeme stav i v rámci samotné databáze v PostgreSQL:

ALTER EXTENSION timescaledb UPDATE;

Po úspěšné aktualizaci bezpečně opustíme psql konzoli:

exit

Po úspěšné aktualizaci doporučujeme provést VACUUM a reindexaci databází, toto provedeme následujícími příkazy:

/usr/pgsql-16/bin/vacuumdb --all --analyze-in-stages
reindexdb

Dalším krokem je smazání starého PostgreSQL clusteru:

./delete_old_cluster.sh
rm -rf 13 delete_old_cluster.sh

Nyní můžeme odebrat staré verze balíčků. Odhlásíme se od uživatele postgres a odstraníme nepotřebné balíčky. TimescaleDB balíčky jsou nahrazeny, proto již na systému nejsou a není tedy potřeba je mazat:

logout

dnf remove postgresql13-*

V posledním kroku lze smazat složku obsahující konfigurační soubory staré verze:

rm -rf /usr/pgsql-13/

Aktualizace Zabbix

Vše jsme úspěšně zazálohovali a zaktualizovali všechny verze návazných komponent dle oficiální matice kompatibility nové verze Zabbixu.

Nyní přejdeme k aktualizaci samotného Zabbixu a všech jeho součástí.

Nejprve si stáhneme instalační balíčky pro repozitáře nové verze Zabbixu a smažeme instalační cache:

rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rocky/9/x86_64/zabbix-release-latest.el9.noarch.rpm
dnf clean all

Po tomto úkonu máme dostupné repozitáře nové verze a můžeme tedy zaktualizovat veškeré další komponenty Zabbix, a to postupně i na všech Zabbix Proxy:

dnf update zabbix-* -y

Po úspěšném dokončení aktualizace balíčků Zabbix serveru a všech jeho součástí můžeme Zabbix znovu spustit, aby se dokončil upgrade databázové struktury, který je nezbytný pro další kroky, protože součástí upgradu je i vytvoření tabulky history_bin. Existence této tabulky je nutná pro následující kroky aktualizující funkce TimescaleDB.

systemctl start zabbix-server.service

Po úspěšné aktualizaci je nutné Zabbix znovu zastavit, aby bylo možné přejít k dalším krokům aktualizujícím TimescaleDB.

Poznámka: V případě, že se po opětovném spuštění Zabbix serveru objeví chyba ohledně kompatibility databáze, stačí v konfiguračním souboru Zabbix serveru upravit následující direktivu.

V této verzi Zabbix toto není chyba kompatibility, ale pouze chybějící číslo TimescaleDB v samotném zdrojovém kódu Zabbixu!

Odpovídající verze databáze a doplňku pak vždy hledejte v matici kompatibility v oficiální dokumentaci Zabbixu pro vaši konkrétní verzi.

Otevřeme si konfigurační soubor Zabbix serveru:

nano /etc/zabbix/zabbix_server.conf

Zde upravíme následující parametr:

AllowUnsupportedDBVersions=1

A nakonec restartujeme službu Zabbix serveru:

systemctl restart zabbix-server.service

Postupné činnosti i celý proces aktualizace, včetně případných zásahů do struktury databázového schématu, lze sledovat v log souboru Zabbix serveru:

tail -f /var/log/zabbix/zabbix_server.log

Jakmile uvidíme, že upgrade proběhl a Zabbix se začal spouštět, vypneme ho a můžeme pokračovat dalším krokem.

Chybu ohledně history_bin a tabulky auditlog můžete ignorovat, protože ji vyřešíme v následujícím kroku. To je také důvod, proč musíme Zabbix ihned po upgradu struktury vypnout.

 69771:20241104:132134.582 [Z3005] query failed: [0] PGRES_FATAL_ERROR:ERROR:  table "history_bin" is not a hypertable
 [select set_integer_now_func('history_bin', 'zbx_ts_unix_now', true)]
 69771:20241104:132134.582 Table "history_bin" is not a hypertable. Execute TimescaleDB configuration step as described in Zabbix documentation to upgrade schema.
 69802:20241104:132134.585 server #29 started [unreachable poller #1]
 69771:20241104:132134.589 [Z3005] query failed: [0] PGRES_FATAL_ERROR:ERROR:  unrecognized parameter namespace "timescaledb"
 [alter table auditlog set (timescaledb.compress,timescaledb.compress_segmentby='auditid',timescaledb.compress_orderby='clock')]
 69771:20241104:132134.590 [Z3005] query failed: [0] PGRES_FATAL_ERROR:ERROR:  "auditlog" is not a hypertable or a continuous aggregate
 [select add_compression_policy('auditlog', compress_created_before => interval '612000')]
 69771:20241104:132134.590 failed to add compression policy to table 'auditlog'

systemctl stop zabbix-server.service

Protože naše Zabbix databáze používá extenzi TimescaleDB, musíme povinně ještě spustit znovu SQL skript obsahující inicializaci hypertabulek. Novinkou ve verzi 7.0 je také hypertabulkovaná tabulka auditlog a history_bin. Pozor, tento krok lze provést až po automatické aktualizaci Zabbix databáze po prvním spuštění Zabbix serveru.

• VOLITELNĚ: Tabulka auditlog může obsahovat velké množství dat, což může zpomalit proces aktualizace. Zvažte, zda ji nechcete vyprázdnit pomocí příkazu TRUNCATE TABLE auditlog;, čímž si výrazně zrychlíte proces migrace na tabulky timescaledb. Příkaz se spouští nad databází Zabbixu.

cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix

Po úspěšném dokončení aktualizace balíčků Zabbix serveru a všech jeho součástí můžeme službu znovu spustit:

systemctl start zabbix-server.service
systemctl start httpd

Nastartování serveru si ověřím přes Zabbix server log:

tail -f /var/log/zabbix/zabbix_server.log

Performance tuning po upgrade PostgreSQL

Po úspěšném spuštění Zabbix serveru můžeme udělat ještě další volitelný krok a to je po upgrade DB spustit znovu script timescaledb-tune na její případné doladění.

Jako parametry tohoto příkazu zvolíme cestu ke konfiguračnímu souboru PostgreSQL a zároveň zvýšíme omezení na maximální počet příchozích spojení do databáze, který je implicitně pro potřeby monitoringu příliš nízký:

timescaledb-tune --pg-config=/usr/pgsql-16/bin/pg_config --max-conns=100

Pro aplikaci nově nastavených konfiguračních parametrů zrestartujeme službu PostgreSQL (ideálně vypněte Zabbix server během tohoto procesu, ale není to nutné):

systemctl restart postgresql-16.service

Dokončovací práce

• Zkontrolujte, že správně běží Zabbix server, databázový server a mají správnou verzi
• Zkontrolujte také, zda při startu serveru nebo proxy v systému neuvidíte následující chybu: ‚…the user limit of 1024 file descriptors is insufficient. The maximum number of concurrent checks per worker has been reduced…‘ Návod na odstranění naleznete na naší wiki.
• Zkontrolujte, že běží všechny Zabbix proxy a mají správnou verzi (Od verze 6.0 je zde zpětná kompatibilita, ale i tak doporučujeme používat stejnou verzi, jakou má Zabbix server)
• Zkontrolujte stav Zabbix serveru a Zabbix proxy (log soubory, nepodporované položky, fronty, monitorovací skripty, atd.).
• Zkontrolujte, zda vaše servery mají přiděleny poslední verze oficiálních šablon od Zabbixu. [ Zabbix GIT ]

Podpora pro nový Item Browser

Veškeré potřebné kroky naleznete v samostatném návodu na naší wiki ZDE.

NovýZabbix

21. 6. 2024

7.0 Workshop: Zabbix 7.0 – Monitorování pomocí Browser Item pomocí aplikace Selenium

Zhlédnout záznam

Doinstalace komponent a nastavení pro Reporting

Veškeré potřebné kroky naleznete v samostatném návodu na naší wiki ZDE.

Zabbix

14. 3. 2024

Reporting v Zabbixu 7.0

Zhlédnout záznam

A to je vše! Nyní můžete začít využívat váš nově zaktualizovaný Zabbix ve verzi 7.0 LTS se všemi jeho opravami i novinkami.

The post Zabbix – aktualizace na poslední verzi 7.0 LTS appeared first on initMAX s.r.o..

Browser item v Zabbixu umožňuje získávat data z webových stránek pomocí prohlížeče. Je to nový typ itemu, který využívá webového prohlížeče k interakci s webovými stránkami, čímž umožňuje monitorovat a sbírat data, která jsou dostupná pouze prostřednictvím webových rozhraní. Tento typ itemu je užitečný pro sledování stavů, které nelze přímo monitorovat prostřednictvím standardních protokolů nebo API. Je zde také možnost přímo získat screenshot z Vámi monitorované stránky.

Položky typu Browser shromažďují data spuštěním uživatelem definovaného JavaScript kódu a získáváním dat přes HTTP/HTTPS. Tento item může simulovat akce v prohlížeči jako je klikání, zadávání textu, navigace po webových stránkách a další interakce uživatele s weby nebo webovými aplikacemi.

Kromě skriptu lze zadat volitelný seznam parametrů (páry name, value) a časový limit.

Podrobnější informace naleznete na stránkách dokumentace Zabbixu:

• Browser items
• Browser item JavaScript objects

Příprava prostředí

Nainstalujeme Podman, ve kterém následně budeme provozovat Docker kontejner se Seleniem.

Jedná se o systémově čistší způsob, než by byla instalace plného grafického rozhraní včetně Google Chrome a následně pak i Selenium WebDriveru na samotný Zabbix Server.

Upozorňujeme, že kontejner může pro svůj běh vyžadovat poměrně dost operační paměti RAM (>2GB) a je s tím potřeba dopředu počítat.

Nejprve pro jistotu zaktualizujeme OS, kterým je v tomto případě Rocky Linux 9:

dnf -y update

Nainstalujeme Podman a potřebné závislosti:

dnf -y install podman podman-compose

Následně stáhneme oficiální Selenium předpis pro docker-compose a uložíme ho s názvem, který podman-compose implicitně očekává.

Tento „plný“ předpis obsahuje všechny tři nejpoužívanější prohlížeče, které pro základní testování dozajisté nejsou třeba, pro účely naší ukázky to však zatím takto ponecháme.

wget https://raw.githubusercontent.com/SeleniumHQ/docker-selenium/trunk/docker-compose-v3-full-grid.yml -O docker-compose.yml

A s tímto předpisem i spustíme kontejner pomocí podman-compose:

podman-compose up -d

Ověřte, že kontejner skutečně běží:

podman ps

Nyní by měl být Selenium server dostupný na adrese http://localhost:4444, tento port jsme si definovali při spuštění kontejneru.

TIP: Selenium můžete také kontrolovat přímo pomocí URL adresy Selenium serveru, v našem příkladu je to http://localhost:4444. Po načtení se zobrazí stránka Selenium Grid, kde vidíte stav a dostupné prohlížeče nebo nastavení pro souběžná spojení. Můžeme zde také nastavit sledování uživatelského prohlížeče přes VNC, ke kterému však nejprve nastavíme heslo. Implicitně je heslo nastaveno na „secret“ a tak důrazně doporučujeme tuto hodnotu změnit.

Nastavení Zabbix serveru

Pro funkčnost celého tohoto řešení nejprve povolíme Selenium WebDriver na úrovni samotného Zabbix Serveru.

Otevřte si tedy konfigurační soubor Zabbix serveru:

nano /etc/zabbix/zabbix_server.conf

A zde upravte konfigurační direktivu WebDriverURL tak, aby odpovídala vámi zvolené adrese a portu spuštěného kontejneru. V našem případě je to http://localhost:4444.

### Option: WebDriverURL
#       WebDriver interface HTTP[S] URL. For example http://localhost:4444 used with Selenium WebDriver standalone server.
#
# Mandatory: no
# Default:
# WebDriverURL=
WebDriverURL=http://localhost:4444

Následně povolíme Browser Pollers, tedy procesy, které samotné hodnoty pro item Browser sbírají.

To uděláme adekvátním nastavením direktivy StartBrowserPollers, kterou pro účely našeho příkladu postačí nechat na hodnotě 5.

### Option: StartBrowserPollers
#       Number of pre-forked instances of browser item pollers.
#
# Mandatory: no
# Range: 0-1000
# Default:
# StartBrowserPollers=1
StartBrowserPollers=5

Upravený konfigurační soubor uložte a pro aplikování změn zrestartujte Zabbix Server:

systemctl restart zabbix-server

Nastavení Zabbix frontendu

Pro rychlé otestování funkčnosti máme k dispozici Zabbixem dodávanou ukázkovou šablonu, kterou najdete zde. Šablonu si stáhněte a naimportujte ji do svého Zabbixu.

Následně si vytvoříme testovacího hosta a tuto šablonu mu přiřadíme:

Pro správnou funkčnost nesmíme zapomenout změnit nastavení maker uvnitř samotné šablony. Nejdůležitější bude samozřejmě cílové URL, které chceme monitorovat, tedy makro {$WEBSITE.DOMAIN} (zvýrazněné na obrázku níže). V makrech šablony ale nalezneme i spoustu dalších užitečných parametrů jako je volba prohlížeče, intervaly kontrol, nebo rozlišení.

S tímto nastavením hosta uložíme a můžeme se přesunout k náhledu dat. Rychlost načtení aktuálních dat se odvíjí od nastaveného intervalu, který je primárně říděn makrem šablony. Pro okamžité spuštění lze ovšem naštěstí využít tlačítko Execute now, a to na položce Website by Browser: Website {$WEBSITE.DOMAIN} Get data.

Vůbec nejlepší náhled na sbíraná data najdeme přímo přes dashboard, který je dodávaný Zabbixem spolu se šablonou.

Tento dashboard najdeme v sekci Monitoring -> Hosts, vyfiltrujeme si našeho nově vytvořeného hosta a následně se na tento dashboard můžeme snadno prokliknout:

Po otevření nás čeká předpřipravený dashboard, kde screenshot naší první spuštěné kontroly a spoustu dalších užitečných výkonnostních metrik.

Všimněte si, že součástí screenshotu je také legislativně nezbytné upozornění ohledně cookies. Odstranění tohoto upozornění si najdete v nasledující kapitole, kde si ukážeme jak více přizpůsobit tuto šablonu některým specifickým požadavkům.

Úprava šablony a vlastní testy

Při úpravách budeme vycházet z původní Zabbix šablony, což je pro potřeby naší ukázky dostačující. V případě produkčního provozu je však vždy lepší mít pro každou specifickou kontrolu šablonu vlastní, kde lze definovat vše potřebné a neupravuje se šablona jedna.

Při předchozím testování se nám například na sbíraných screenshotech nelíbí upozornění na cookies.
Nejsnazší způsob, jak se této lišty zbavit, je v rámci stránky kliknout na tlačíto I accept all, čímž cookies potvrdíme.

Nyní si tedy ukážeme, jak si toto jednoduché kliknutí přidat jako součást našeho testu.

Otevřeme si naši vzorovou šablonu „Website by Browser“, kde najdeme položku s tagem component: raw.
Tato položka se jmenuje Website by Browser: Website {$WEBSITE.DOMAIN} Get data, a v jednom z předchozích kroků jsme ji použili pro ruční vynucení kontroly.

Součástí nastavení této položky je i skript napsaný v JavaScriptu – otevřte si ho pomocí tlačítka pro úpravu, zvýrazněného červeně na screenshotu níže.

Do skriptu přidáme následující sekci:

// Accept Cookies to hide this element
el = browser.findElement("xpath", "//a[contains(text(),'I accept all')]");
if (el === null) {
    throw Error("cannot find Cookie button");
    }
el.click();

Tento kus kódu prohledá obsah načtené stránky pomocí xpath a objeví element, který obsahuje text „I accept all„, a v posledním kroku na něj klikne.

XPath je standardní technika Selenium pro navigaci ve struktuře HTML stránky a popis procesu lze snadno najít na internetu.

Zde můžete vidět, jak vypadá výsledný skript:

Skript uložíme pomocí tlačítka Apply, položku uložíme tlačítkem Update a vrátíme se zpět na našeho testovacího hosta, kde si prohlédneme výsledek.
Opět nezapomeňte, že nová data přijdou se zpožděním v závislosti na přednastavením intervalu – pro zrychlení této operace si opět můžeme pomoci kliknutím na tlačítko Execute now tak, jako v předchozím případě.

Ve výše zobrazeném screenshotu pak můžete vidět výsledek, kde nám lišta s upozorněním na cookies zmizela.

Tímto je naše vzorové nastavení položky typu Browser hotové a naš příklad použití je u konce.
Nezapomeňte, že všechny schopnosti a možnosti nastavení této položky naleznete v dokumentaci Zabbixu tak, jak jsme zmínili na začátku článku.

The post Instalace a základní použití pro Item Browser appeared first on initMAX s.r.o..

Článek počítá s tím, že pokud jsou k dispozici volitelné patche (float a primární klíče), pak byly do DB již aplikovány.
Pokud si nejste jisti, pak informace o tomto stavu se zobrazuje zároveň i ve frontendu v sekci System information, např. políčko: „Database history tables upgraded: No“.

Dopředu upozorňujeme, že migraci děláte pouze na vlastní nebezpečí a neneseme žádnou odpovědnost za případné škody způsobené neodborným zásahem.

Každá verze Zabbixu i databáze má svá konkrétní specifika, která je nutné brát v potaz už při návrhu migračního plánu a jednotlivých činností. Dle našich zkušeností se velká část problémů po migraci (například s promazáváním) může projevit až později. Doporučujeme tedy, abyste nás před zásahem do produkčního prostředí raději kontaktovali pro případnou konzultaci. Rádi vám s celým procesem bezchybné migrace a následnými kroky pomůžeme.

PostgreSQLZabbix

21. 11. 2024

Migrace Zabbix databáze z MySQL do PostgreSQL krok za krokem

Zhlédnout záznam

Kontrola verzí

Jako vůbec první krok před samotnou migrací je třeba vědět konkrétní aktuálně BĚŽÍCÍ verzi Zabbix serveru. Tedy nikoliv to, co nám zobrazuje patička ve webovém frontendu.

Toto nejbezpečněji zjistíme v logu samotného Zabbix serveru při jeho startu:

cat /var/log/zabbix/zabbix_server.log | grep "Starting Zabbix Server. Zabbix"

Výstup tohoto příkazu v našem případě vypadá následovně:

1933256:20240510:164211.482 Starting Zabbix Server. Zabbix 7.0.0 (revision 9bc845eca94)

Jako další možnost je zjištění verze instalačních balíčků podpůrných knihoven Zabbixu pro MySQL, což je ilustrováno příkazem níže.

Toto ale nemusí být skutečná, aktuálně běžící verze!

rpm -qa | grep zabbix-server-mysql

Výstup tohoto příkazu vypadá takto:

zabbix-server-mysql-7.0.0.release1.el9.x86_64

Dalším způsobem zjištění verze Zabbix serveru je pak kontrola verze samotným spouštěcím souborem. Ovšem i tato informace může být za jistých okolností zavádějící a nemusí to být verze aktuálně spuštěná.

zabbix_server -V

Výstup pak vypadá následovně:

zabbix_server (Zabbix) 7.0.0
Revision 9bc845eca94 30 January 2024, compilation time: Jan 30 2024 00:00:00

Přípravné kroky

MySQL triggery

Zabbix od verze 6.0.11 obsahuje databázové triggery a s těmi se musí při migraci počítat. Následující sadou příkazů tedy zjistíme, jestli se to naší databázové instance bude také týkat.

Přihlásíme se do mysql konzole:

mysql

Přepneme se do databáze ‚zabbix‘:

use zabbix;