Integrace ADVANTECH Zabbix

Použité symboly

• Nebezpečí: Informace týkající se bezpečnosti uživatele nebo možného poškození routeru.
• Pozor: Problémy, které mohou nastat v konkrétních situacích.
• Informace, upozornění: Užitečné tipy nebo informace zvláštního zájmu.
• Exampten: Exampsoubor funkce, příkazu nebo skriptu.

Licence open source softwaru

Software v tomto zařízení používá různé části softwaru s otevřeným zdrojovým kódem, který se řídí následujícími licencemi: GPL verze 2 a 3, LGPL verze 2, licence ve stylu BSD, licence ve stylu MIT. Seznam komponent spolu s kompletními licenčními texty naleznete na samotném zařízení: Viz odkaz Licence ve spodní části hlavního routeru Web (Obecný stav) nebo nasměrujte prohlížeč na adresu DEVICE_IP/licence. CGI. Máte-li zájem o získání zdroje, kontaktujte nás prosím na adrese: techSupport@advantech-bb.com

Úpravy a ladění spustitelných souborů spojených s LGPL

Výrobce zařízení tímto uděluje právo používat techniky ladění (např. dekompilaci) a provádět zákaznické úpravy jakéhokoli spustitelného souboru spojeného s knihovnou LGPL pro své účely. Upozorňujeme, že tato práva jsou omezena na použití zákazníkem. Žádná další distribuce takto upravených spustitelných souborů a žádný přenos informací získaných během těchto akcí nesmí být prováděn.

Advantech Czech sro, Sokolská 71, 562 04 Ústí nad Orlicí, Česká republika.
Dokument č. APP-0089-EN, revize ze 4. října 2022. Vydáno v ČR.

Server Zabbix

Vzdálené monitorování je proces dohledu nad IT systémy ze serveru centrální správy. Obecně platí, že monitorování zlepšuje spolehlivost a bezpečnost vaší sítě, protože usnadňuje včasnou detekci chybných podmínek. Úvod do vzdáleného monitorování a seznam dalších monitorovacích nástrojů naleznete v poznámce k aplikaci Remote Monitoring [1]. Tento dokument popisuje monitorování celulárních routerů Advantech pomocí Zabbix 5.0 LTS. Zabbix je open-source monitorovací softwarový nástroj pro různé IT komponenty, včetně sítí, serverů, virtuálních strojů (VM) a cloudových služeb. Může monitorovat řadu parametrů sítě a stav a integritu serverů1.

Monitorování operací

Zabbix monitoruje hostitele (např. routery) prostřednictvím jednoho nebo více rozhraní. Existují dva typy rozhraní (protokoly), které lze použít s routery Advantech:

• SNMP, který podporuje také SNMP Trapy (viz Sekce 2).
• Agent, který podporuje aktivní i pasivní kontroly (viz část 3).

Jednotlivé kontroly stavu jsou definovány jako položky. Každá položka představuje specifický Typ informace (číselný nebo znakový), získaný prostřednictvím specifického typu kontroly (SNMP, SSH, pasivní nebo aktivní agent) s konkrétní periodou aktualizace a intervalem ukládání. Každá položka má jedinečný klíč, např. „system.cpu.load“. Sadu položek (a další entity, jako jsou spouštěče, grafy nebo pravidla zjišťování) lze seskupit do šablony, aby se urychlilo nasazení monitorovacích úloh na hostiteli. Šablony jsou propojeny s hostiteli nebo s jinými šablonami. Šablony pro monitorování routerů Advantech zbx_conel_templates.xml lze stáhnout z portálu Advantech Engineering Portal2. Položky jsou logicky seskupeny do aplikací (např. Informace, Stav, Rozhraní). Některé položky také automaticky vyplňují pole inventáře hostitele (např. název, operační systém, sériové číslo).

Chcete-li začít sledovat router, musíte vytvořit hostitele a

1. Dejte mu libovolný, ale jedinečný název hostitele,
2. Přiřaďte hostitele skupině hostitelů, např. „Routers“,
3. Nastavte rozhraní, která se mají použít (SNMP nebo Agent), případně včetně šifrovacích klíčů,
4. Šablony odkazů, které definují položky, které mají být monitorovány (seznam kompatibilních šablon naleznete v následujících částech).

Pokud vše funguje dobře, měli byste po několika minutách vidět

• Zelené indikátory dostupnosti a šifrování agenta v části Konfigurace – hostitelé,
• Podrobnosti o inventáři směrovače v části Inventář – hostitelé,
• Načtené informace o stavu pod Monitoring – Nejnovější data

Každá položka má nastavenou obnovovací frekvenci, takže některé položky se mohou zaplnit později než jiné. Pokud chcete požádat o okamžitou aktualizaci konkrétních (nebo všech) položek, otevřete Konfigurace hostitele, klikněte na Položky na horní liště, zaškrtněte položky, které chcete aktualizovat, a klikněte na tlačítko Provést nyní.

Instalace a konfigurace serveru

Nejjednodušší způsob instalace serveru Zabbix je stáhnout3 obraz ISO a nainstalovat4 zařízení Zabbix na virtuální počítač, např. VirtualBox5. Heslo „root“ bude „zabbix“; budete to potřebovat pouze pro pokročilé změny konfigurace, jako je nasazení certifikátů TLS.

• Po instalaci se připojte ze svého Web prohlížeče adminovi Web stránka na http:// a přihlaste se jako „Admin“ s heslem „zabbix“.
• Pokud chcete používat šablony Advantech, stáhněte si zbx_conel_templates.xml z portálu Advantech Engineering Portal, poté vstupte do sekce Konfigurace Zabbix a klikněte na Šablony nebo zadejte http:// /templates.php a poté importujte soubor zbx_conel_templates.xmlfile.

Zabbix SNMP šablony

Pro monitorování celulárního routeru Advantech přes standardní SNMP

• V konfiguraci routeru [2] povolte službu SNMP,
• V konfiguraci hostitele Zabbix přidejte rozhraní SNMP a propojte hostitele s jednou nebo více šablonami SNMP (viz níže).

Pro monitorování SNMP není vyžadována aplikace Zabbix Router. Následující šablony SNMP lze použít s celulárními směrovači Advantech (odsazení zobrazuje vnořené šablony)

Doporučujeme vytvořit šablonu specifickou pro váš router (např. „ICR-3211“) a poté zahrnout (nebo nezahrnout) jednotlivé moduly šablon v závislosti na funkcích routeru a vašich potřebách monitorování. Napřample, měli byste zahrnout „Conel GPS SNMP“ pouze v případě, že je k dispozici poloha GPS.

Vlastní šablony Advantech, označené [3], nejsou součástí výchozí instalace; je třeba je stáhnout a nainstalovat ručně. Název „Conel“ se používá pro konzistenci s SNMP OID [3].

Každý směrovač potřebuje odpovídající položku v konfiguraci hostitele Zabbix

• „Název hostitele“ v konfiguraci serveru se musí shodovat s názvem „Název hostitele“ v konfiguraci agenta.
• Monitorovací rozhraní (protokoly) musí být explicitně uvedeny a musí být specifikována IP adresa routeru nebo DNS jméno.

Záložka Šifrování musí odpovídat výše popsané konfiguraci agenta

•  Pole „Connections to host“ v konfiguraci serveru musí odpovídat polím Accept unencrypted, Accept Pre-Shared Key (PSK) a Accept certificate.
• „Připojení z hostitele“ v konfiguraci serveru musí odpovídat Šifrovanému připojení v konfiguraci agenta.
• PSK a jeho identita (pokud je použita) se také musí shodovat.

Pro použití certifikátů TLS potřebuje server Zabbix své vlastní certifikáty (TLSCAFile, TLSCert- File a TLSKeyFile), jak je popsáno v příručce Zabbix. Vidět https://www.zabbix.com/documentation/current/manual/encryption/using_certificates

Účelem certifikátu musí být „ověření serveru“. Při generování pomocí OpenSSL musí být nastaveno „použití rozšířeného klíče = ověření serveru“.

Šablony agentů Zabbix

V závislosti na konfiguraci serveru Zabbix může agent provádět velké množství kontrol (měření). Data se shromažďují v „položkách“. V sekci 3.4 můžete vidět úplný seznam podporovaných položek.

• Nevytvářejte prosím zbytečné zatížení routeru a nepoužívejte příliš mnoho metrik.

S celulárními směrovači Advantech lze použít následující (pasivní) šablony agentů (odsazení zobrazuje vnořené šablony)

Vlastní konfigurace položek

Kromě standardních položek můžete definovat vlastní položky, které bude váš agent sledovat, aktivní nebo pasivní. Konfigurace vlastních položek je ve spodní části obrazovky Konfigurace.

Pole Příkaz podporuje pouze omezenou sadu znaků: dvojité uvozovky (“) nejsou povoleny a znaky dolaru „$“ musí mít předponu zpětné lomítko „\$“. Pokud potřebujete vytvořit složitější kontrolu, vytvořte prosím shell skript a použijte pole Příkaz k jeho spuštění.

Položky podporované agentem Zabbix

Standardní položky Zabbix (šeky) jsou podrobně popsány https://www.zabbix.com/documentation/current/manual/config/items/itemtypes/zabbix_agent
Dokumentace Zabbix také uvádí, které z položek jsou podporovány na různých platformách: https://www.zabbix.com/documentation/current/manual/appendix/items/supported_by_platform

Následující tabulka doplňuje tyto informace a vysvětluje, které standardní položky agentů jsou podporovány na mobilních směrovačích Advantech.

Kromě výše uvedeného jsou podporovány následující položky specifické pro Advantech

licence

Shrnuje licence Open-Source Software (OSS) používané tímto modulem.

Související dokumenty

1. Advantech Czech: Poznámka k aplikaci vzdáleného monitorování
2. Advantech Czech: Poznámka k aplikaci SNMP OID

Dokumenty týkající se produktu můžete získat na Engineering Portal na adrese icr. Adresa Advantech.cz. Chcete-li získat příručku pro rychlý start, uživatelskou příručku, konfigurační příručku nebo firmware vašeho routeru, přejděte na stránku Router Models, vyhledejte požadovaný model a přepněte na kartu Manuals nebo Firmware. Instalační balíčky a příručky Router Apps jsou k dispozici na stránce Router Apps. Pro vývojové dokumenty přejděte na stránku DevZone.

Dokumenty / zdroje

Integrace ADVANTECH Zabbix [pdf] Instalační průvodce Integrace Zabbix

Reference

• Uživatelská příručka