Integrazione ADVANTECH Zabbix
Simbuli usati
- Periculu: Infurmazioni riguardanti a sicurità di l'utilizatori o danni potenziali à u router.
- Attenzione: I prublemi chì ponu accade in situazioni specifiche.
- infurmazione, avvisu: Cunsiglii utili o informazioni d'interessu speciale.
- ExampLe: Example di funzione, cumandamentu o script.
Licenza di Software Open Source
U software in questu dispusitivu usa diverse pezzi di software open-source guvernati da e seguenti licenze: GPL versioni 2 è 3, LGPL versione 2, licenze in stile BSD, licenze in stile MIT. A lista di cumpunenti, inseme cù testi di licenza cumpleta, ponu esse truvati nantu à u dispusitivu stessu: Vede u ligame Licenze in u fondu di u principale di u router. Web pagina (Statu Generale) o puntate u vostru navigatore per indirizzà DEVICE_IP/licenze. CGI. Sè site interessatu à ottene a fonte, per piacè cuntattateci à: techSupport@advantech-bb.com
Modificazioni è debugging di eseguibili ligati à LGPL
U fabricatore di u dispositivu cun questu cuncede u dirittu di utilizà tecniche di debugging (per esempiu, decompilation) è fà mudificazioni di u cliente di qualsiasi eseguibile ligatu cù una biblioteca LGPL per i so scopi. Nota chì questi diritti sò limitati à l'usu di u cliente. Nisuna distribuzione ulteriore di tali eseguibili mudificati è nisuna trasmissione di l'infurmazioni ottenute durante queste azioni ponu esse fattu.
Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, Czech Republic.
Documentu N ° APP-0089-EN, rivisione da u 4 ottobre 2022. Rilasciatu in a Repubblica Ceca.
Servitore Zabbix
U monitoraghju remotu hè u prucessu di surviglianza di i sistemi IT da un servitore di gestione cintrali. In generale, u monitoraghju migliurà l'affidabilità è a sicurità di a vostra reta perchè facilita a deteczione precoce di cundizioni errate. Per una introduzione di u monitoraghju remoto è una lista di altri strumenti di monitoraghju, vede a Nota di l'Applicazione di Monitoraggio Remote [1]. Stu documentu descrive u monitoraghju di i routers cellulari Advantech chì utilizanu Zabbix 5.0 LTS. Zabbix hè un strumentu software di surviglianza open-source per diversi cumpunenti IT, cumprese rete, servitori, macchine virtuali (VM) è servizii cloud. Pò monitorà numerosi paràmetri di una rete è a salute è l'integrità di i servitori1.
Operazioni di monitoraghju
Zabbix monitoreghja Hosts (per esempiu routers) attraversu una o più Interfacce. Ci hè dui tipi di interfaccia (protokolli) chì ponu esse utilizati cù i router Advantech:
- SNMP, chì supporta ancu SNMP Traps (vede a Sezione 2).
- Agente, chì sustene i cuntrolli attivi è passivi (vede a Sezione 3).
I cuntrolli di status individuale sò definiti cum'è Elementi. Ogni Elementu rapprisenta un Tipu specificu d'infurmazione (numericu o caratteru), ottenutu via un tipu di cuntrollu specificu (SNMP, SSH, agenti passivi o attivu) cù un periodu di aghjurnamentu specificu è intervalu di almacenamentu. Ogni articulu hà una Chjave unica, per esempiu "system.cpu.load". Un inseme di Elementi (è altre entità cum'è Triggers, Graphs, o Discovery Rules) ponu esse raggruppati in un Template per accelerà a implementazione di e funzioni di monitoraghju in un host. I mudelli sò ligati à Hosts o à altri Templates. I mudelli per u monitoraghju di u router Advantech zbx_conel_templates.xml ponu esse scaricati da u Advantech Engineering Portal2. L'articuli sò raggruppati logicamente in Applicazioni (per esempiu Info, Status, Interfacce). Certi Articuli ancu auto-populate i campi di l'Inventariu di l'ospiti (per esempiu, Nome, OS, Numeru Serial).
Per inizià a monitorizazione di un router avete bisognu di creà un Host, è
- Dà un Hostname arbitrariu ma unicu,
- Assignà l'ospite à un gruppu d'ospiti, per esempiu "Routers",
- Stabilite l'Interfacce chì deve esse aduprate (SNMP o Agente), possibbilmente cumprese e chjave di criptografia,
- Ligami mudelli chì definiscenu l'Articuli per esse monitorati (vede e seguenti sezzioni per una lista di mudelli cumpatibili).
Se tuttu funziona bè, duvete vede dopu qualchì minutu
- Disponibilità Verde è indicatori di criptografia di l'Agent in Configurazione - Hosts,
- Detaglii di l'inventariu di u router sottu Inventariu - Hosts,
- L'infurmazione di u statu ricuperatu sottu Monitoring - Ultime dati
Ogni articulu hà una freccia di rinfrescante sfida, cusì certi elementi ponu esse populati più tardi cà l'altri. Se vulete dumandà una aghjurnazione immediata di l'articuli specifichi (o tutti), apre a Configurazione di l'ospite, cliccate Articuli nantu à a barra superiore, verificate l'articuli chì vulete aghjurnà è cliccate nantu à u buttone Eseguite avà.
Installazione è cunfigurazione di u servitore
U modu più faciule per installà un servitore Zabbix hè di scaricà3 l'imaghjini ISO è install4 un Appliance Zabbix in una macchina virtuale, per esempiu VirtualBox5. A password "root" serà "zabbix"; avete bisognu di questu solu per cambiamenti di cunfigurazione avanzati, cum'è implementazione di certificati TLS.
- Una volta installatu, cunnette da u vostru Web navigatore à l'amministratore Web pagina à http:// è accede cum'è "Admin" cù una password "zabbix".
- Se vulete usà Advantech Templates, scaricate zbx_conel_templates.xml da u Advantech Engineering Portal, dopu entre in a sezione Zabbix Configuration è cliccate Templates, o entre http:// /templates.php è poi impurtate u zbx_conel_templates.xmlfile.
Modelli SNMP Zabbix
Per monitorà un router cellulare Advantech via u SNMP standard
- In a cunfigurazione di u router [2], attivate u serviziu SNMP,
- In a Zabbix Host Configuration, aghjunghje una Interfaccia SNMP è ligà l'Host à unu o più Templates SNMP (vede sottu).
L'App Router Zabbix ùn hè micca necessariu per u monitoraghju SNMP. I seguenti mudelli SNMP ponu esse aduprati cù i routers cellulari Advantech (l'indentazione mostra mudelli nidificati)
| Template | Nome di l'articulu | Invintariu populatu |
| Modulu Conel Basic SNMP [3] | Nome di u produttu Firmware Numeru di seria Batteria RTC Temperature Voltage | Type OS
Numero di serie A |
| Modulu SNMP genericu | Disponibilità di l'agente SNMP Nome di u sistema
ID di l'ughjettu di u sistema Descrizione di u sistema Locu di u sistema Dati di cuntattu di u sistema Uptime |
Nome
Location Contact |
| Modulu ICMP Ping | ICMP ping ICMP perdita
Tempu di risposta ICMP |
|
| Interfacce di modulu SNMP simplice | Tipu d'interfaccia Status operativu Velocità
Bits ricevuti Bits mandati Pacchetti in entrata scartati Pacchetti in entrata cù errori Pacchetti in uscita scartati Pacchetti in uscita cù errori |
| Modulu Conel Mobile 1 SNMP [3] | Modem IMEI Modem ESN Modem MEID Registrazione mobile Tecnulugia mobile Operatore mobile Carta mobile Uptime mobile
Qualità di u signale mobile Livellu di signale mobile (CSQ) Forza di u signale mobile Soglia di forza Fair (A) Soglia di forza Debule (B) |
Numero di serie B |
| Modulu Conel Mobile 1 Data SNMP [3] | Dati in entrata mobile 1/2 Dati in uscita mobile 1/2 Connessioni mobile 1/2 Tempu in linea mobile 1/2 Tempu offline mobile Segnale mobile mediu Segnale mobile min
Segnale mobile max |
|
| Modulu Conel GPS SNMP [3] | Altitudine di locu Latitudine di locu Longitudine di locu Satelliti GPS |
Latitude Longitudine |
Hè ricumandemu di creà un mudellu specificu per u vostru router (per esempiu "ICR-3211") è poi include (o micca) i moduli di mudelli individuali secondu e funzioni di u router è i vostri bisogni di monitoraghju. Per esample, tu avissi a include u "Conel GPS SNMP" solu s'è a pusizione GPS hè dispunibule.
I mudelli persunalizati Advantech, indicati da [3], ùn sò micca inclusi in a stallazione predeterminata; anu da esse scaricatu è installatu manualmente. U nome "Conel" hè utilizatu per a coerenza cù l'OID SNMP [3].
| Template | Nome di trigger | Cundizione |
| Modulu SNMP genericu | U nome di u sistema hè cambiatu L'ospite hè statu riavviatu Nisuna raccolta di dati SNMP |
Uptime < 10 m |
| Modulu ICMP Ping | Indisponibile da ICMP ping Alta perdita di ping ICMP
Tempu di risposta ping ICMP elevatu |
20 < perdita ICMP < 100 Tempu di risposta ICMP> 0.15 |
| Modulu Conel Mobile SNMP [3] | Signal Mobile Fair Signal Mobile debule | B < forza di signale ≤ Una forza di signale ≤ B |
Zabbix Agent Router App
Cunfigurazione di cunnessione
Per monitorà un router cellulare Advantech via l'agente Zabbix:
- Stallà u Zabbix Agent Router App à u router. Per più infurmazione nantu à cumu carricà una app di router, vede u Manuale di cunfigurazione [2], capitulu Personalizazione -> Apps Router.
- In a Configurazione di l'Agente, cunfigurà a cunnessione à u servitore Zabbix.
- In a Configurazione di l'Ospitu Zabbix, aghjunghje una Interfaccia di l'Agente, definisce i paràmetri di criptografia per esse allinati cù a cunfigurazione di l'Agente, è ligà l'Ospitu à unu o più Modelli di Agente. A cunfigurazione di a cunnessione di l'Agent hè in a parte superiore di a pantalla di cunfigurazione.
A parte inferiore hè aduprata per a cunfigurazione chjave persunalizata (vede a Sezione 3.3).
| Habilita l'agente | Se l'agente serà iniziatu. | |
| Permette cumandamenti remoti | Sia chì i cumandamenti remoti da u servitore Zabbix sò permessi. Quandu hè disattivatu, i cuntrolli "system.run" seranu rifiutati. | |
| Ascolta Port | L'agente (modu passiu) ascoltarà in questu portu per e cunnessione da u servitore. Default hè 10050. | |
| Accetta Server | A cunnessione in entrata (modu passiu) serà accettata solu da l'ospiti listati quì. Inserite un indirizzu IP di u vostru servitore Zabbix. Quandu hè viotu, u modu passiu hè disattivatu. | |
| Accetta micca criptatu | Accettate cunnessione (passive) senza criptografia. Ùn hè micca cunsigliatu! I seguenti cuntrolli "Accetta xxx" currispondenu à u campu "Connections to host" in a cunfigurazione di Zabbix Encryption, vede Figura X. | |
| Accetta Chjave Pre-Shared (PSK) | Accettate cunnessione (passive) cù TLS è una chjave pre-spartita (PSK). Quandu hè attivatu, u PSK è a so identità deve esse cunfigurati. | |
| Accetta certificatu | Accettate cunnessione (passive) cù TLS è un certificatu. Quandu hè attivatu, a CA è u Certificatu Locale è a Chjave Privata Locale deve esse cunfigurata. | |
| Cunnette i Servitori | IP:portu (o hostname:port) di u servitore Zabbix per i cuntrolli attivi. Diversi indirizzi delimitati da virgola ponu esse furniti per utilizà parechji servitori Zabbix indipendenti in parallelu. Quandu viotu, i cuntrolli attivi seranu disattivati. | |
| Cripta a cunnessione | Cumu l'agente deve cunnette à u servitore Zabbix. Deve currisponde à u campu "Connections from host" in a cunfigurazione di criptografia Zabbix, Figura X. | |
| Hostname | Nome host unicu. Deve currisponde à u campu "Nome di l'ospite" in a cunfigurazione di Zabbix Host, Figura Y. | |
| Refresh Checks ognunu | Quantu spessu l'Agente recupera a lista di cuntrolli attivi da u Servitore, in seconde. Predefinitu hè 10 s. | |
| Mandate Buffer à ognunu | Quanti risultati di cuntrollu (articuli) deve u buffer di l'Agente prima di stabilisce una cunnessione è sincronizà i valori da stu buffer à u servitore Zabbix. Predefinitu hè 5 s. | |
| Max Buffer Size | Definisce a dimensione massima di u buffer. Quandu questa dimensione di buffer hè ghjunta, l'Agente sincronizza immediatamente i valori buffered. Predeterminatu hè 100 B. |
| Identità PSK | Stringa d'identità chjave pre-spartita. Deve currisponde à u campu "identità PSK" in a cunfigurazione Zabbix Encryption, Figura X. U stessu PSK hè utilizatu per i cuntrolli passivi è attivi. | |
| Chjave Pre-Shared (PSK) | Chjave pre-spartita per esse usata. Deve currisponde à u campu "PSK" in a cunfigurazione Zabbix Encryption, Figura X. | |
| Certificatu CA | Catena di certificati CA per l'autorità chì emette i certificati di u servitore Zabbix. | |
| Certificatu Locale | Certificatu di u router, chì currisponde à a chjave privata. U scopu deve include "autentificazione di u cliente". Quandu hè generatu da OpenSSL, u "utilizazione di chjave estesa = auth client" deve esse stabilitu. U certificatu CA di l'autorità chì hà emessu stu certificatu deve esse inclusu in u TLSCAFile in a cunfigurazione di u servitore. | |
| Chjave Privata Locale | Chjave privata di u router. A listessa chjave privata è i certificati sò utilizati per i cuntrolli passivi è attivi. | |
| Accetta l'emittente di u certificatu | Emittente di certificatu di u servitore permessu. Quandu specificatu, currisponde à u certificatu di u servitore. | |
| Accetta Cert Subject | Sugettu di certificatu di u servitore permessu. Quandu specificatu, currisponde à u certificatu di u servitore. |
Ogni Router hà bisognu di una entrata currispondente in a cunfigurazione Zabbix Host
- U "Nome d'ospite" in a cunfigurazione di u servitore currisponde à u "Nome d'ospite" in a cunfigurazione di l'Agente.
- L'interfacce di monitoraghju (protokolli) anu da esse esplicitamente listate è l'indirizzu IP di u router o u nome DNS deve esse specificatu.
A tabulazione Encryption deve currisponde à a cunfigurazione di l'Agente descritta sopra
- I "Connessioni à l'ospitu" in a cunfigurazione di u servitore currispondenu à i campi Accetta micca criptatu, Accetta Chjave Pre-Shared (PSK) è Acceptà i campi di certificatu.
- A "Connessione da l'ospite" in a cunfigurazione di u servitore deve currisponde à a Cunnessione Encrypt in a cunfigurazione di l'Agente.
- U PSK è a so identità (se usata) anu ancu cuncordatu.
Per utilizà i certificati TLS, u servitore Zabbix hà bisognu di i so propri certificati (TLSCAFile, TLSCert- File è TLSKeyFile) cum'è descrittu in u Manuale Zabbix. Vede https://www.zabbix.com/documentation/current/manual/encryption/using_certificates
U scopu di u certificatu deve include "autentificazione di u servitore". Quandu hè generatu da OpenSSL, u "utilizazione di chjave estesa = auth server" deve esse stabilitu.
Zabbix Agent Templates
Sicondu a cunfigurazione di u servitore Zabbix, l'agente pò fà un gran numaru di cuntrolli (misurazioni). I dati sò riuniti in "articuli". In a Sezione 3.4 pudete vede una lista completa di l'articuli supportati.
- Per piacè ùn create micca una carica inutile nantu à u router è evite micca aduprà troppe metriche.
I seguenti mudelli di agenti (passivi) ponu esse aduprati cù i routers cellulari Advantech (l'indentazione mostra mudelli nidificati)
| Template | Nome di l'articulu | Invintariu populatu |
| Modulu CPU Linux da l'agente Zabbix | Caricà interruzioni media per seconda
Cambia u cuntestu per u tempu di l'ospiti CPU secondu (è simili) |
|
| Modulu Conel Resources per Agent [3] | Storage / free Storage / used Storage / opt free Storage / opt used Storage / var / data free
Storage /var/data used Memoria di sistema dispunibile Memoria di sistema utilizata |
|
| Modulu Conel Integrità per Agent [3] | Checksum /etc/passwd Checksum /etc/settings.* |
Cunfigurazione di l'articuli persunalizati
In più di l'articuli standard pudete definisce l'articuli persunalizati per esse monitoratu da u vostru agente, attivu o passiu. A cunfigurazione di l'articuli persunalizati hè in a parte inferiore di a pantalla di cunfigurazione.
| Articulu | Descrizzione |
| Chjave persunalizata | Chjave di un articulu Zabbix. |
| Cumanda | Cumanda per eseguisce, cù argumenti opzionali. Questu deve esse un solu cumandamentu in una sola linea. U cumandamentu serà eseguitu è una prima linea di a pruduzzioni testuale (stdout) serà usata cum'è valore. |
| Pausa | Limita u tempu di calculu di un cuntrollu. Default 3 s. |
U campu Command supporta solu un inseme limitatu di caratteri: i virgulette (") ùn sò micca permesse è i segni di dollari "$" anu da esse prefissatu cù una barra backslash "\$". Sè avete bisognu di custruisce un verificatu più cumplessu, crea un script di shell è utilizate u campu di Command per attivà.
Articuli supportati da Zabbix Agent
L'articuli standard Zabbix (cuntrolli) sò descritti in dettagli https://www.zabbix.com/documentation/current/manual/config/items/itemtypes/zabbix_agent
A documentazione di Zabbix indica ancu quale di l'articuli sò supportati in diverse piattaforme: https://www.zabbix.com/documentation/current/manual/appendix/items/supported_by_platform
A tabella seguente cumplementa sta infurmazione è spiega quale di l'articuli di l'agente standard sò supportati nantu à i routers cellulari Advantech.
| Elementu Chjave | Supportatu |
| agent.hostname | Iè |
| agent.ping | Iè |
| agente.versione | Iè |
| kernel.maxfiles | Iè |
| kernel.maxproc | Iè |
| log[file, , , , , , ] per esempiu: log[/var/log/messages,"fallimentu di l'autentificazione", salta "] | Active solu |
| log.count[file, , , , , ] | Active solu |
| logrt[file_regexp, , , , , ,
, ] |
Active solu |
| logrt.count[file_regexp, , , , ,
, ] |
Active solu |
| net.dns[ ,zona, , , ] | Iè |
| net.dns.record[ ,zona, , , ] | Iè |
| net.if.collisions[se] | Iè |
| net.se.scuperta | Iè |
| net.se.in[se, ] | Iè |
| net.if.out[se, ] | Iè |
| net.se.totale[se, ] | Iè |
| net.tcp.listen[port] | Iè |
| net.tcp.port[ ,portu] | Iè |
| net.tcp.service[serviziu, , ] | Iè |
| net.tcp.service.perf[serviziu, , ] | Iè |
| net.udp.listen[port] | Iè |
| net.udp.service[serviziu, , ] | Iè |
| net.udp.service.perf[serviziu, , ] | Iè |
| proc.cpu.util[ , , , , , ] | Iè |
| proc.mem[ , , , ] | Iè |
| proc.num[ , , , ] | Iè |
| sensor [dispositiu,sensore, ] | Innò |
| sistema.bottime | Iè |
| sistema.cpu.discovery | Iè |
| system.cpu.intr | Iè |
| sistema.cpu.load[ , ] | Iè |
| system.cpu.num[ ] | Iè |
| sistema.cpu.switches | Iè |
| system.cpu.util[ , , ] | Iè |
| system.hostname | Iè |
| sistema.hw.chassis[ ] | Innò |
| sistema.hw.cpu[ , ] | Iè |
| system.hw.dispositivi[ ] | Innò |
| system.hw.macaddr[ , ] | Iè |
| system.localtime[ ] | Solu passivu |
| system.run[cumanda, ]
p.e sistema.run[ls/] |
Se attivatu |
| system.stat[risorsa, ] | Innò |
| sistema.sw.arch | Iè |
| system.sw.os[ ] | Iè |
| system.sw.packages[ , , ] | Innò |
| sistema.swap.in[ , ] | Innò |
| sistema.swap.out[ , ] | Innò |
| sistema.swap.size[ , ] | Innò |
| sistema.uname | Iè |
| sistema.uptime | Iè |
| system.users.num | Innò |
| vfs.dev.discovery | Innò |
| vfs.dev.read[ , , ] | Innò |
| vfs.dev.write[ , , ] | Innò |
| vfs.dir.count[dir, , , , ,
, , , , ] p.e vfs.dir.count[/dev] |
Iè |
| vfs.dir.size[dir, , , , ] | Iè |
| vfs.file.cksum[file] | Iè |
| vfs.file.cuntenuti[file, ] | Iè |
| vfs.file.esiste[file, , ] | Iè |
| vfs.file.md5sum[file] | Iè |
| vfs.file.regexp[file,regexp, , ] | Iè |
| vfs.file.regmatch[file,regexp, ] | Iè |
| vfs.file.taglia[file] | Iè |
| vfs.file.tempu[file, ] | Iè |
| vfs.fs.discovery | Iè |
| vfs.fs.get | Innò |
| vfs.fs.inode[fs, ] | Innò |
| vfs.fs.size [fs, ] | Iè |
| vm.memory.size[ ] | Iè |
| web.page.get[host, , ] | Iè |
| web.page.perf[host, , ] | Iè |
| web.page.regexp[host, , ,regexp, , ] | Iè |
In più di ciò chì sopra, i seguenti elementi specifichi Advantech sò supportati
| Elementu Chjave | Descrizzione |
| vfs.settings.discovery | Lista di /etc/settings.* è
/opt/*/etc/settings files per autodis-covery |
| vfs.settings.value[nome,parametru] per esempiu
vfs.settings.value[wifi_ap, WIFI_AP_SSID] |
Recupera un valore unicu da u router config /etc/settings.[name] |
| vfs.settings.umod[nome,parametru] per esempiu
vfs.settings.umod[gps, MOD_GPS_ENABLED] |
Recupera un valore unicu da una cunfigurazione di l'app di router
/opt/[nome]/etc/settings |
Licenze
Riassume i licenze di u Software Open-Source (OSS) utilizati da stu modulu.
- Advantech Czech: Nota di l'applicazione di Monitoraghju Remote
- Advantech Czech: Nota di l'applicazione SNMP OID
Pudete ottene documenti in relazione à u produttu nantu à u Portal di Ingegneria à icr. Advantech.cz indirizzu. Per uttene a Guida Rapida di u vostru Router, Manuale d'Usuariu, Manuale di Cunfigurazione, o Firmware andate à a pagina di Modelli di Router, truvate u mudellu necessariu, è cambiate à a tabulazione Manuali o Firmware, rispettivamente. I pacchetti di stallazione Router Apps è manuali sò dispunibuli nantu à a pagina Router Apps. Per i Documenti di Sviluppu, andate à a pagina DevZone.
Documenti / Risorse
 |
Integrazione ADVANTECH Zabbix [pdfGuida d'installazione Integrazione Zabbix |
