<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="hu">
	<id>http://wiki.farkas-attila.hu/index.php?action=history&amp;feed=atom&amp;title=NetBox%3A%3AZabbix_integr%C3%A1ci%C3%B3</id>
	<title>NetBox::Zabbix integráció - Laptörténet</title>
	<link rel="self" type="application/atom+xml" href="http://wiki.farkas-attila.hu/index.php?action=history&amp;feed=atom&amp;title=NetBox%3A%3AZabbix_integr%C3%A1ci%C3%B3"/>
	<link rel="alternate" type="text/html" href="http://wiki.farkas-attila.hu/index.php?title=NetBox::Zabbix_integr%C3%A1ci%C3%B3&amp;action=history"/>
	<updated>2026-11-21T01:17:46Z</updated>
	<subtitle>Az oldal laptörténete a wikiben</subtitle>
	<generator>MediaWiki 1.38.4</generator>
	<entry>
		<id>http://wiki.farkas-attila.hu/index.php?title=NetBox::Zabbix_integr%C3%A1ci%C3%B3&amp;diff=902&amp;oldid=prev</id>
		<title>ApelPro: NetBox (SoT) oldal + NetBox-Zabbix integrációs példa (config-generálás, Ansible/SSH MikroTikhez)</title>
		<link rel="alternate" type="text/html" href="http://wiki.farkas-attila.hu/index.php?title=NetBox::Zabbix_integr%C3%A1ci%C3%B3&amp;diff=902&amp;oldid=prev"/>
		<updated>2026-09-30T19:51:16Z</updated>

		<summary type="html">&lt;p&gt;NetBox (SoT) oldal + NetBox-Zabbix integrációs példa (config-generálás, Ansible/SSH MikroTikhez)&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Új lap&lt;/b&gt;&lt;/p&gt;&lt;div&gt;[[category:Monitoring]]&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Megjegyzés:&amp;#039;&amp;#039;&amp;#039; ez az oldal szándékosan nincs a menüből közvetlenül linkelve - a [[NetBox|NetBox]] és a [[Monitoring::Zabbix|Zabbix]] oldalakról hivatkozunk rá, mint a két rendszer &amp;#039;&amp;#039;&amp;#039;gyakorlati összekötésének&amp;#039;&amp;#039;&amp;#039; részletes leírására.&lt;br /&gt;
&lt;br /&gt;
== Miért kell összekötni a kettőt? ==&lt;br /&gt;
A [[NetBox|NetBox]] tudja, &amp;#039;&amp;#039;&amp;#039;minek kellene létezni&amp;#039;&amp;#039;&amp;#039; a hálózaton (SoT) - a [[Monitoring::Zabbix|Zabbix]] azt figyeli, &amp;#039;&amp;#039;&amp;#039;mi létezik és hogy viselkedik ténylegesen&amp;#039;&amp;#039;&amp;#039;. Ha ezt a két host-listát &amp;#039;&amp;#039;&amp;#039;kézzel, párhuzamosan&amp;#039;&amp;#039;&amp;#039; tartjuk karban, előbb-utóbb &amp;#039;&amp;#039;&amp;#039;szétcsúsznak&amp;#039;&amp;#039;&amp;#039;: felveszünk egy routert a NetBox-ba, de elfelejtjük a Zabbix-ba is; vagy leszerelünk egy szervert, ami a Zabbix-ban &amp;quot;monitorozott, de már nem létező&amp;quot; hostként árválkodik tovább. A cél, hogy a Zabbix host-listája &amp;#039;&amp;#039;&amp;#039;automatikusan, egy irányban&amp;#039;&amp;#039;&amp;#039; kövesse a NetBox-ban rögzített adatokat.&lt;br /&gt;
&lt;br /&gt;
== Az integráció elve ==&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
   NetBox (SoT: eszköz létrehozva/módosítva/törölve)&lt;br /&gt;
        |&lt;br /&gt;
        | Webhook (HTTP POST-esemény egy általunk megadott címre)&lt;br /&gt;
        v&lt;br /&gt;
   Szinkronizáló szolgáltatás/szkript&lt;br /&gt;
        |&lt;br /&gt;
        | Zabbix API-hívás (host.create / host.update / host.delete)&lt;br /&gt;
        v&lt;br /&gt;
   Zabbix (host-lista mindig a NetBox aktuális állapotát tükrözi)&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
A &amp;#039;&amp;#039;&amp;#039;NetBox Webhooks&amp;#039;&amp;#039;&amp;#039; funkciója konfigurálható úgy, hogy egy adott esemény (pl. &amp;quot;device&amp;quot; objektum létrehozása/módosítása a DCIM-ben) esetén HTTP POST-ot küldjön egy általunk megadott URL-re, a változott objektum adataival (JSON). Egy ezt fogadó, kis szolgáltatás/szkript ezt lefordítja a &amp;#039;&amp;#039;&amp;#039;Zabbix JSON-RPC API&amp;#039;&amp;#039;&amp;#039; megfelelő hívására (lásd a &amp;#039;&amp;#039;host.create&amp;#039;&amp;#039; példát a [[Monitoring::Zabbix|Zabbix oldalon]]). Az elvet több közösségi projekt (pl. a nyílt forráskódú &amp;#039;&amp;#039;netbox-zabbix-sync&amp;#039;&amp;#039;) is pontosan így implementálja - a lényeg nem a konkrét eszköz, hanem a &amp;#039;&amp;#039;&amp;#039;&amp;quot;webhook → fordítás → cél-API hívás&amp;quot;&amp;#039;&amp;#039;&amp;#039; minta, ami tetszőleges hasonló integrációra (pl. NetBox → Nagios, NetBox → Prometheus service-discovery) újrafelhasználható.&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Fontos irány:&amp;#039;&amp;#039;&amp;#039; az adatáramlás &amp;#039;&amp;#039;&amp;#039;egyirányú&amp;#039;&amp;#039;&amp;#039; - a NetBox-ból a Zabbix felé. A Zabbix-ban mért &amp;#039;&amp;#039;&amp;#039;élő állapot&amp;#039;&amp;#039;&amp;#039; (pl. hogy egy host éppen elérhető-e) soha nem írja felül a NetBox-ban rögzített, tervezett/adminisztratív adatokat - a két rendszer szerepe emiatt marad tiszta és nem keveredik össze.&lt;br /&gt;
&lt;br /&gt;
== Példa: router-konfiguráció generálása a SoT-ból és kiosztása Ansible-lel ==&lt;br /&gt;
A NetBox gyakorlati hasznának másik, a fentitől független példája, amikor nem egy másik &amp;#039;&amp;#039;&amp;#039;rendszer&amp;#039;&amp;#039;&amp;#039; host-listáját, hanem egy &amp;#039;&amp;#039;&amp;#039;eszköz konfigurációját&amp;#039;&amp;#039;&amp;#039; állítjuk elő a benne rögzített adatokból - pl. MikroTik routerek alapkonfigurációját.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
   NetBox (SoT: eszközök, interfészek, IP-címek)&lt;br /&gt;
        |&lt;br /&gt;
        | pynetbox API-hívás&lt;br /&gt;
        v&lt;br /&gt;
   Python generátor script + Jinja2 sablon&lt;br /&gt;
        |&lt;br /&gt;
        | legenerált, eszközönkénti .rsc fájlok&lt;br /&gt;
        v&lt;br /&gt;
   Ansible playbook (megadott host lista alapján)&lt;br /&gt;
        |&lt;br /&gt;
        | SSH (community.routeros collection)&lt;br /&gt;
        v&lt;br /&gt;
   MikroTik routerek (a generált konfiguráció importálva)&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 1. lépés - Jinja2 sablon a RouterOS-szkripthez ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;text&amp;quot;&amp;gt;&lt;br /&gt;
{# templates/mikrotik.rsc.j2 #}&lt;br /&gt;
/system identity set name={{ device.name }}&lt;br /&gt;
{% for iface in device.interfaces %}&lt;br /&gt;
/ip address add address={{ iface.ip }} interface={{ iface.name }}&lt;br /&gt;
{% endfor %}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== 2. lépés - a NetBox-ból a sablonba: Python generátor script ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
import pynetbox&lt;br /&gt;
from jinja2 import Environment, FileSystemLoader&lt;br /&gt;
&lt;br /&gt;
nb = pynetbox.api(&amp;quot;https://netbox.example.com&amp;quot;, token=&amp;quot;NETBOX_API_TOKEN&amp;quot;)&lt;br /&gt;
env = Environment(loader=FileSystemLoader(&amp;quot;templates&amp;quot;))&lt;br /&gt;
template = env.get_template(&amp;quot;mikrotik.rsc.j2&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
# Csak a &amp;quot;router&amp;quot; szerepű, MikroTik gyártmányú eszközök a NetBox-ból&lt;br /&gt;
for dev in nb.dcim.devices.filter(role=&amp;quot;router&amp;quot;, manufacturer=&amp;quot;mikrotik&amp;quot;):&lt;br /&gt;
    interfaces = []&lt;br /&gt;
    for iface in nb.dcim.interfaces.filter(device_id=dev.id):&lt;br /&gt;
        ip = nb.ipam.ip_addresses.filter(interface_id=iface.id)&lt;br /&gt;
        if ip:&lt;br /&gt;
            interfaces.append({&amp;quot;name&amp;quot;: iface.name, &amp;quot;ip&amp;quot;: str(ip[0])})&lt;br /&gt;
&lt;br /&gt;
    rendered = template.render(device={&amp;quot;name&amp;quot;: dev.name, &amp;quot;interfaces&amp;quot;: interfaces})&lt;br /&gt;
    with open(f&amp;quot;generated/{dev.name}.rsc&amp;quot;, &amp;quot;w&amp;quot;) as f:&lt;br /&gt;
        f.write(rendered)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
A script minden, a NetBox-ban &amp;quot;router&amp;quot; szerepkörrel és &amp;quot;mikrotik&amp;quot; gyártóval rögzített eszközhöz legenerál egy önálló, névre szóló &amp;#039;&amp;#039;.rsc&amp;#039;&amp;#039; (RouterOS-szkript) fájlt a &amp;#039;&amp;#039;generated/&amp;#039;&amp;#039; mappába - a tartalma kizárólag a NetBox-ban rögzített adatokból (eszköznév, interfészek, IP-címek) épül fel.&lt;br /&gt;
&lt;br /&gt;
=== 3. lépés - a megadott host lista (Ansible inventory) ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;ini&amp;quot;&amp;gt;&lt;br /&gt;
# hosts.ini&lt;br /&gt;
[mikrotik_routers]&lt;br /&gt;
router01 ansible_host=192.168.1.1&lt;br /&gt;
router02 ansible_host=192.168.1.2&lt;br /&gt;
&lt;br /&gt;
[mikrotik_routers:vars]&lt;br /&gt;
ansible_user=admin&lt;br /&gt;
ansible_connection=network_cli&lt;br /&gt;
ansible_network_os=community.routeros.routeros&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Megjegyzés:&amp;#039;&amp;#039;&amp;#039; ez itt egy egyszerű, statikus hoszt-lista - ha a kiosztást is a NetBox-ból szeretnénk vezérelni (ne kelljen a hoszt-listát is kézzel karbantartani), ugyanerre a szerepre a korábban (lásd a [[NetBox|NetBox oldalon]]) említett &amp;#039;&amp;#039;netbox.netbox&amp;#039;&amp;#039; gyűjtemény &amp;#039;&amp;#039;&amp;#039;nb_inventory&amp;#039;&amp;#039;&amp;#039; dinamikus inventory-pluginja is bevethető - ez esetben a &amp;quot;megadott host lista&amp;quot; maga is élőben, a NetBox API-ból jönne.&lt;br /&gt;
&lt;br /&gt;
=== 4. lépés - Ansible playbook: feltöltés és alkalmazás SSH-n keresztül ===&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;yaml&amp;quot;&amp;gt;&lt;br /&gt;
# deploy_mikrotik.yml&lt;br /&gt;
---&lt;br /&gt;
- name: Generált RouterOS-konfiguráció kiosztása SSH-n keresztül&lt;br /&gt;
  hosts: mikrotik_routers&lt;br /&gt;
  gather_facts: no&lt;br /&gt;
  tasks:&lt;br /&gt;
    - name: Legenerált script feltöltése a routerre&lt;br /&gt;
      ansible.netcommon.net_put:&lt;br /&gt;
        src: &amp;quot;generated/{{ inventory_hostname }}.rsc&amp;quot;&lt;br /&gt;
        dest: &amp;quot;{{ inventory_hostname }}.rsc&amp;quot;&lt;br /&gt;
&lt;br /&gt;
    - name: Feltöltött script importálása/alkalmazása&lt;br /&gt;
      community.routeros.command:&lt;br /&gt;
        commands:&lt;br /&gt;
          - &amp;quot;/import file-name={{ inventory_hostname }}.rsc&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
Futtatás (a &amp;#039;&amp;#039;community.routeros&amp;#039;&amp;#039; gyűjtemény telepítése után):&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;bash&amp;quot;&amp;gt;&lt;br /&gt;
ansible-galaxy collection install community.routeros ansible.netcommon&lt;br /&gt;
ansible-playbook -i hosts.ini deploy_mikrotik.yml&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
A &amp;#039;&amp;#039;net_put&amp;#039;&amp;#039; modul SSH-n (SFTP-n) keresztül &amp;#039;&amp;#039;&amp;#039;felmásolja&amp;#039;&amp;#039;&amp;#039; a router saját fájltárolójába a hozzá tartozó, a 2. lépésben legenerált &amp;#039;&amp;#039;.rsc&amp;#039;&amp;#039; fájlt, a &amp;#039;&amp;#039;community.routeros.command&amp;#039;&amp;#039; pedig - szintén SSH-n keresztül - kiadja a &amp;#039;&amp;#039;/import&amp;#039;&amp;#039; parancsot, ami ténylegesen &amp;#039;&amp;#039;&amp;#039;végrehajtja&amp;#039;&amp;#039;&amp;#039; a feltöltött szkript tartalmát a routeren.&lt;br /&gt;
&lt;br /&gt;
== Az egész lánc összefoglalva ==&lt;br /&gt;
* A &amp;#039;&amp;#039;&amp;#039;NetBox&amp;#039;&amp;#039;&amp;#039; rögzíti, milyen routereknek, interfészeknek, IP-címeknek &amp;#039;&amp;#039;&amp;#039;kellene&amp;#039;&amp;#039;&amp;#039; léteznie - ez az egyetlen hely, ahol ezt az adatot kézzel karbantartjuk.&lt;br /&gt;
* A &amp;#039;&amp;#039;&amp;#039;Python + Jinja2&amp;#039;&amp;#039;&amp;#039; pár ebből az adatból, &amp;#039;&amp;#039;&amp;#039;automatikusan&amp;#039;&amp;#039;&amp;#039; állít elő eszközönkénti, kész RouterOS-szkripteket - nem kell kézzel írni/másolni egyetlen konfigurációs sort sem.&lt;br /&gt;
* Az &amp;#039;&amp;#039;&amp;#039;Ansible&amp;#039;&amp;#039;&amp;#039; (a &amp;#039;&amp;#039;community.routeros&amp;#039;&amp;#039; gyűjteménnyel) a megadott host-lista minden elemére &amp;#039;&amp;#039;&amp;#039;SSH-n keresztül&amp;#039;&amp;#039;&amp;#039; feltölti és alkalmazza is ezt a szkriptet.&lt;br /&gt;
* Ugyanez az elv (NetBox → generátor/webhook → cél-rendszer API-hívása) áll a fentebb tárgyalt &amp;#039;&amp;#039;&amp;#039;Zabbix-szinkron&amp;#039;&amp;#039;&amp;#039; mögött is - csak ott a &amp;quot;cél-rendszer&amp;quot; nem egy router, hanem maga a Zabbix.&lt;/div&gt;</summary>
		<author><name>ApelPro</name></author>
	</entry>
</feed>