Zabbix MAC-Adressen an Switchports auslesen und beim Client anzeigen lassen an welchen Switch und Port dieser angeschlossen ist

Dieses Thema ist noch nicht vollständig! Es wird noch daran gearbeitet!

Changelog:

• 07.10.2026 erste öffentliche Version

---

Vorwort

Bei einem Kunden überwachen wir mit Zabbix auch alle CLients. Mit einem stark abgespeckten Template, die Admins interessieren sich an den Clients nur für wenige Dinge wie die Speicherplatzbelegung auf Laufwerk C:, wie schon nicht mehr gebootet wurde, die Seriennummern der Monitore und ob die IP-Adresseinstellungen stimmen.

In dem Zuge kam die Idee auf, beim Client auch gleich anzeigen zu lassen, an welchem Switch und Port dieser hängt, unter Latest data kann man sich das hier nun bei allen Clienst anzeigen lassen:

zusätzlich wird die Information auch umgekehrt hinterlegt, man könnte beim Switchport anzeigen lassen welcher Client daran hängt, die Information wird nach dem gleichen Prinzip (mehr dazu weiter in diesem Artikel) hinterlegt:

Das ganze funktioniert wie folgt:

• Aus den Switchen werden die MAC-Adressen ausgelesen die direkt an einem Switchport hängen, also nicht von einem anderem intelligenten Switch kommen. Ist da ein dummer Switch hinter, werden alle MACs von diesem übernommen.
• Das geschieht über ein Template welches ein Item vom Typ External Skript anstößt.
• Pro Switch werden diese Informationen im JSON-Format in einem Verzeichnis auf dem Zabbix-Server gespeichert (unterhalb von {{code|/var/lib/zabbix/externalscripts), pro MAC-Adresse eine Zeile in der Textdatei
• Die Client-Hosts haben ein Template welches per WMI die aktuelle MAC-Adresse ausliest
• Mit dieser MAC macht ein Item vom Typ External Skript ein grep auf das Verzeichnis mit den ablegten JSON der Switche. Es bekommt die Zeile mit den Daten im JSON-Format zurück
• Das JSON wird per Items vom Typ Dependent item in seine Einzelteile zerlegt.

In meinem Client-Template wird in einem 2. Unterordner pro Client ein JSON abgelegt mit diesen Daten. Darauf könnte man mit der gleichen Methode am Switch die Client-IP und Namen hinterlegen. Das habe ich nicht umgesetzt da hier die Beschreibung der Ports gepflegt wird, die Information wäre also redundant.

---

MAC-Adressen von Switchen abrufen

Meldet euch per SSH am Zabbix-Server an und wechselt in das External-Skript Verzeichnis:

cd /usr/lib/zabbix/externalscripts

Erstellt das Verzeichnis im welchen die JSONs abgelegt werden und setzt den Zabbix-Benutzer als Besitzer:

mkdir macfinder
chown zabbix:zabbix macfinder

Das funktioniert je nach Switch anders, deshalb gibt es für verschiedene Switch-Hersteller und -Typen verschiedene Skripte:

---

Avaya-Switche

Das folgende Skript wurde mit Avaya-Switchen vom Typ

Modelle:   3510GT-PWR+
           3524GT-PWR+
           4950GTS
Firmware: 5.x
Software: v5.3.x

getestet.
Die MAC-Adressen bei diesen Modellen finden sich hinter OID

1.3.6.1.2.1.17.4.3.1.2

ein snmpwalk, z.B. so ein Aufruf

snmpwalk -v2c -On -c testcommu 192.168.0.1 1.3.6.1.2.1.17.4.3.1.2

gibt eine Ausgabe wie folgt:

.1.3.6.1.2.1.17.4.3.1.2.40.99.54.224.67.188 = INTEGER: 8193
.1.3.6.1.2.1.17.4.3.1.2.40.99.54.236.96.83 = INTEGER: 10
.1.3.6.1.2.1.17.4.3.1.2.40.99.54.236.96.84 = INTEGER: 10
.1.3.6.1.2.1.17.4.3.1.2.48.19.137.21.14.81 = INTEGER: 14
.1.3.6.1.2.1.17.4.3.1.2.48.19.137.21.148.216 = INTEGER: 77
.1.3.6.1.2.1.17.4.3.1.2.48.19.137.37.139.121 = INTEGER: 8193
.1.3.6.1.2.1.17.4.3.1.2.48.19.137.37.241.97 = INTEGER: 8193
.1.3.6.1.2.1.17.4.3.1.2.48.19.137.37.241.103 = INTEGER: 8193
.1.3.6.1.2.1.17.4.3.1.2.48.19.137.37.241.109 = INTEGER: 15
.1.3.6.1.2.1.17.4.3.1.2.48.19.137.37.241.110 = INTEGER: 15
.1.3.6.1.2.1.17.4.3.1.2.48.19.137.37.241.112 = INTEGER: 11
.1.3.6.1.2.1.17.4.3.1.2.48.19.137.37.241.113 = INTEGER: 11
.1.3.6.1.2.1.17.4.3.1.2.48.19.137.37.241.121 = INTEGER: 8193

Wenn der Wert am Ende 0 oder 8193 ist, ist es eine MAC die er von einem anderem Switch hat.
Die MAC selbst ist in der OID codiert, die letzten 6 Zahlen:
OID:

.1.3.6.1.2.1.17.4.3.1.2.48.19.137.37.241.112 = INTEGER: 11

die letzten 6 Zahlen:

48.19.137.37.241.112

sind die Dezimalwerte, in HEX ist das dann

30:13:89:25:f1:70

Der Wert dahinter ist die Portnummer, in diesem Fall die 11. Über die OID

.1.3.6.1.2.1.2.2.1.2.11

bekommen wir den Port Alias

.1.3.6.1.2.1.2.2.1.2.11 = STRING: Avaya Ethernet Routing Switch 3524GT PWR+ Module - Unit 1 Port 11

Über

.1.3.6.1.2.1.31.1.1.1.18.11

die Port Beschreibung

.1.3.6.1.2.1.31.1.1.1.18.11 = STRING: Panel W1

Aus diesen Informationen baut sich das Skript das zusammen.

Das eigentliche Skript:

nano  macportnameiptable-avaya

#!/bin/bash

# $1 = Community
# $2 = IP-Address or FQDN
# $3 = Base OID
if [[ $# -ne 3 ]]; then
   echo "Error - not 3 Parameter!"
   echo "Usage:"
   echo "macportnameiptable community IP-Address-or-FQDN Base-OID"
   echo " "
   exit 1
fi
#s_systemname=$(snmpget -v2c -O qv -c $1 $2 1.3.6.1.2.1.1.5.0)
# 1. Systemnamen abfragen (Fehlermeldungen abfangen)
s_systemname=$(snmpget -v2c -O qv -c $1 $2 1.3.6.1.2.1.1.5.0 2>/dev/null | xargs)

# 2. Wenn s_systemname leer ist oder "No Such..." enthält, IP-Adresse ($2) nutzen
if [ -z "$s_systemname" ] || [[ "$s_systemname" == *"No Such"* ]]; then
    s_systemname="$2"
else
    # Leerzeichen im Systemnamen durch Unterstriche ersetzen
    s_systemname="${s_systemname// /_}"
fi


output_from_command=$(snmpwalk -v2c -O nq -c $1 $2 $3)
# -O Parameter:
# n = OID numerisch darstellen
# q = kurze Ausgabe - OID, Leerzeichen, Wert
result="[\n"
while IFS= read -r line; do
    # Zeile in OID und Port aufteilen
    # [0] ist die OID
    # [1] ist der Port
    stringarray=($line)
    if [ "${stringarray[1]}" -ne "8193" ] && [ "${stringarray[1]}" -ne "0" ]; then
        stringoid=${stringarray[0]}
        #echo "${stringoid}"
        IFS='.'; macnumbers=($stringoid); unset IFS;
        # .1.3.6.1.2.1.17.4.3.1.2.248.177.86.223.76.59 8193
        mac1=$( printf "%02x" ${macnumbers[12]} )
        mac2=$( printf "%02x" ${macnumbers[13]} )
        mac3=$( printf "%02x" ${macnumbers[14]} )
        mac4=$( printf "%02x" ${macnumbers[15]} )
        mac5=$( printf "%02x" ${macnumbers[16]} )
        mac6=$( printf "%02x" ${macnumbers[17]} )
        #echo "MAC: ${macnumbers[12]}:${macnumbers[13]}:${macnumbers[14]}:${macnumbers[15]}:${macnumbers[16]}:${macnumbers[17]}"
        mac_complete="${mac1}:${mac2}:${mac3}:${mac4}:${mac5}:${mac6}"
        # Beschreibung des Ports holen
        s_portdescription=$(snmpget -v2c -O qv -c $1 $2 .1.3.6.1.2.1.31.1.1.1.18.${stringarray[1]})
        s_portalias=$(snmpget -v2c -O qv -c $1 $2 .1.3.6.1.2.1.2.2.1.2.${stringarray[1]} | cut -d "-" -f 2 | xargs)
        result="${result}{\"switchname\":\"${s_systemname}\",\"portnumber\":\"${stringarray[1]}\",\"portalias\":\"${s_portalias}\",\"portdescription\":\"${s_portdescription}\",\"MAC\":\"${mac_complete}\"},\n"
        #result="${result}\"${stringarray[1]}\":\"${mac_complete}\",\n"
        #echo ${stringarray[1]} --- ${stringarray[0]}
    fi
done <<< "$output_from_command"
result="${result::-3}\n]"
echo -e $result > /usr/lib/zabbix/externalscripts/macfinder/${s_systemname}.json
echo -e $result

Das Skript ausführbar machen und den Besitz an den Benutzer zabbix übertragen:

chmod +x macportnameiptable-avaya
chown zabbix:zabbix macportnameiptable-avaya