
- Der
geoip-Filter liest lokale.mmdb-Dateien von MaxMind, keine entfernte API. - Sie benötigen ein MaxMind-Konto mit Lizenzschlüssel, um GeoLite2 herunterzuladen.
- Ein Cronjob mit
curlundtarersetzt den manuellen Download in unter 5 Minuten. - Nach dem Dateitausch ist ein Neustart von Logstash nötig, damit die neue Datenbank greift.
- Prüfen Sie danach die Felder
geoip.country_nameundgeoip.locationmit einem Testevent.
Warum ist die Aktualisierung der GeoIP-Datenbank in Logstash so wichtig?
Die GeoIP-Datenbank liefert die geografische Zuordnung einer Adresse IP, und veraltete Daten verfälschen jede Auswertung. Adressblöcke werden weltweit neu vergeben, Provider wechseln ihre Netze, und MaxMind veröffentlicht für GeoLite2 wöchentliche Updates. Wer monatelang dieselbe .mmdb-Datei einsetzt, arbeitet mit einem Zerrbild der Realität.
Kurz gesagt :
- Der geoip-Filter nutzt lokale .mmdb-Dateien von MaxMind ohne API-Aufruf; ein MaxMind-Konto mit Lizenzschlüssel ist für GeoLite2-Downloads nötig.
- Nach dem Dateitausch ist ein Logstash-Neustart erforderlich, da der Filter das Handle auf den ursprünglichen Inode hält.
- Ein Cronjob mit curl und atomarem mv automatisiert die Aktualisierung in unter 5 Minuten; danach geoip.country_name und geoip.location mit einem Testevent prüfen.
- Veraltete Datenbanken verfälschen Auswertungen; für französische Teams ist die dokumentierte Update-Routine Teil der CNIL-Datenverarbeitungsdokumentation.
Ich habe in Audits mehrfach gesehen, dass Angriffsanalysen auf falsche Länder zeigten, weil die Datenbank ein halbes Jahr alt war. Für Teams in Frankreich kommt ein zweiter Aspekt hinzu: Die CNIL verlangt eine dokumentierte Datenverarbeitung, und ein Log-Enrichment mit Geo-Daten gehört in das Verarbeitungsregister. Eine nachvollziehbare Update-Routine ist Teil dieser Dokumentation.
Merken Sie sich den Kern: Die Datenbank ist kein statisches Asset, sondern ein Betriebsmittel mit Ablaufdatum.
Wie funktioniert der geoip-Filter im Elastic Stack technisch?
Der Filter lädt beim Pipeline-Start eine lokale MaxMind-Datei in den Speicher und schlägt pro Event im Adressbaum nach. Es gibt keinen Netzwerkaufruf, keine Latenz, keine externe Abhängigkeit – das ist der Grund für die hohe Durchsatzrate. Der Preis dafür: Eine neue Datenbank wird erst nach einem Neustart des Prozesses wirksam.
Das Plugin erwartet das MMDB-Format, also die Binärstruktur von MaxMind. Sie können die Datei nicht einfach per Symlink austauschen und hoffen, dass Logstash folgt. Der Filter hält das Handle auf den ursprünglichen Inode. Wer das ignoriert, wundert sich über unveränderte Ergebnisse (mir ist genau das passiert, bevor ich die Neustart-Routine eingeführt habe).
Wie erstellen Sie einen MaxMind-Account und einen Lizenzschlüssel?
Ohne Account und Lizenzschlüssel liefert MaxMind seit Dezember keine GeoLite2-Downloads mehr aus. Der Schlüssel ist ein String von etwa 40 Zeichen, den Sie im Konto unter „Manage License Keys“ erzeugen. Behandeln Sie ihn wie ein Passwort und legen Sie ihn nicht im Klartext in ein Git-Repository.
- Konto auf der offiziellen MaxMind-Seite anlegen und E-Mail bestätigen.
- Im Bereich „My Account“ einen neuen Lizenzschlüssel generieren.
- Schlüssel in einem Secret-Store ablegen (Vault, Systemd-Environment oder verschlüsselte Datei).
- Im Verarbeitungsregister dokumentieren, dass IP-Adressen an einen US-Anbieter übertragen werden.
Für französische Unternehmen ist der letzte Punkt kein Formalismus. Prüfen Sie die Standardvertragsklauseln und ob ein Transfer in die USA für Ihre Rechtsgrundlage tragfähig ist. Im Zweifel gehört diese Bewertung in die Hände einer Datenschutzbeauftragten oder eines Datenschutzbeauftragten.
Wie laden Sie die GeoLite2-Datenbank manuell herunter?
Der manuelle Weg eignet sich für den Erstaufbau und für Systeme ohne Internetzugang im Betrieb. Sie laden ein Archiv von rund 60 Megabyte, entpacken es und platzieren die MMDB-Datei in einem dedizierten Verzeichnis.
- Archiv
GeoLite2-City.tar.gzüber die MaxMind-Downloadseite beziehen. - Mit
tar -xzfentpacken und die DateiGeoLite2-City.mmdbisolieren. - Nach
/etc/logstash/geoip/kopieren und mitchown logstash:logstashdie Rechte setzen. - Leserechte mit
chmod 640einschränken, damit keine fremden Nutzer die Daten lesen. - Freien Speicher prüfen – bei knapper Root-Partition scheitert der Tausch sonst mitten im Betrieb.
Wie automatisieren Sie die Aktualisierung mit einem Cronjob?
Ein Shell-Skript mit curl und einem atomaren Dateitausch erledigt die Routine in wenigen Sekunden. Der Trick liegt im atomaren mv: Erst wird die neue Datei vollständig geschrieben, dann ersetzt sie die alte in einem einzigen Schritt. So liest Logstash nie eine halb geschriebene Datei.
Hier ein kommentiertes Beispiel, das ich in ähnlicher Form auf mehreren Servern einsetze:
#!/bin/bash
set -euo pipefail LICENSE_KEY="${MAXMIND_LICENSE_KEY:?Schlüssel fehlt}"
TARGET_DIR="/etc/logstash/geoip"
TMP_DIR=$(mktemp -d) trap 'rm -rf "$TMP_DIR"' EXIT curl -fsSL -o "$TMP_DIR/geo.tar.gz" \ "https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-City&license_key=${LICENSE_KEY}&suffix=tar.gz" tar -xzf "$TMP_DIR/geo.tar.gz" -C "$TMP_DIR" NEW_DB=$(find "$TMP_DIR" -name 'GeoLite2-City.mmdb' -print -quit)
install -o logstash -g logstash -m 640 "$NEW_DB" "$TARGET_DIR/GeoLite2-City.mmdb.new"
mv -f "$TARGET_DIR/GeoLite2-City.mmdb.new" "$TARGET_DIR/GeoLite2-City.mmdb" systemctl restart logstash
Die Zeile set -euo pipefail bricht das Skript bei jedem Fehler ab, statt still weiterzulaufen. Der trap räumt das temporäre Verzeichnis auf, selbst wenn curl scheitert. Planen Sie den Lauf wöchentlich, etwa montags um 3 Uhr, passend zum Veröffentlichungsrhythmus von MaxMind.
Wie konfigurieren Sie den geoip-Filter im Pipeline-File?
Der Filter braucht einen Quellfeldnamen, ein Zielfeld und den absoluten Pfad zur Datenbank. Ein relativer Pfad ist die häufigste Ursache für stille Fehlkonfigurationen, weil Logstash ihn gegen das Arbeitsverzeichnis auflöst und dann ins Leere greift.
filter { geoip { source => "client_ip" target => "geoip" database => "/etc/logstash/geoip/GeoLite2-City.mmdb" tag_on_failure => ["_geoip_lookup_failure"] }
}
Das Feld tag_on_failure ist Gold wert. Ohne diesen Tag verschwinden fehlgeschlagene Lookups lautlos, und Sie merken erst Wochen später, dass die Anreicherung ausgefallen ist. Ich empfehle zusätzlich einen Alarm auf die Anzahl dieser Tags pro Stunde.
Müssen Sie Logstash nach dem Dateitausch neu starten?
Ja, in der Regel ist ein vollständiger Neustart nötig, weil das Plugin die MMDB-Datei beim Pipeline-Start in den Speicher lädt. Der Parameter --config.reload.automatic überwacht Konfigurationsdateien, nicht aber die GeoIP-Datenbank selbst.
| Methode | Ausfallzeit | Aufwand pro Lauf | Risiko |
|---|---|---|---|
| Manueller Download | Neustart nötig, 15 bis 40 Sekunden | 10 bis 15 Minuten | Wird vergessen, Daten veralten |
| Cronjob mit Neustart | Neustart nötig, 15 bis 40 Sekunden | unter 1 Minute automatisiert | Fehler bleibt unbemerkt ohne Monitoring |
| Cronjob mit Reload-API | keine, aber Datenbank greift oft nicht | unter 1 Minute automatisiert | Alte Daten bleiben im Speicher aktiv |
| Blue-Green mit zwei Instanzen | 0 Sekunden | höherer Architekturaufwand | Doppelte Ressourcen, komplexeres Routing |
Für Pipelines mit hohem Durchsatz lohnt der Blue-Green-Ansatz. Bei kleineren Installationen ist der kurze Neustart um 3 Uhr nachts schlicht pragmatischer.
Wie prüfen Sie, ob die neue Datenbank tatsächlich aktiv ist?
Ein Testevent mit einer bekannten Adresse IP zeigt sofort, ob die Anreicherung greift und welche Felder gefüllt werden. Nutzen Sie dafür die Logstash-API oder eine kleine Testdatei mit einem einzigen Dokument.
- Event mit einer festen Test-IP durch die Pipeline schicken, etwa aus dem Bereich eines bekannten Providers.
- Prüfen, ob
geoip.country_name,geoip.city_nameundgeoip.locationgesetzt sind. - Im Log
/var/log/logstash/logstash-plain.lognach Fehlern zum Filter suchen. - Bei Abweichungen Dateipfad, Leserechte und Dateigröße kontrollieren.
- Den Test in ein Monitoring überführen, damit die Prüfung nicht einmalig bleibt.
Welche Fehler sollten Sie bei der Aktualisierung vermeiden?
Die häufigsten Ausfälle entstehen nicht durch fehlende Daten, sondern durch übersehene Details im Betrieb. Ein abgelaufener Lizenzschlüssel blockiert den Download, ohne dass jemand es merkt. Ein falscher Pfad führt zu leeren Geo-Feldern bei intakter Pipeline.
- Lizenzschlüssel ohne Ablaufüberwachung einsetzen.
- Die Datei überschreiben, während Logstash läuft, ohne Neustart.
- Leserechte für den Dienstnutzer
logstashvergessen. - Den Datentransfer zu MaxMind nicht im Verarbeitungsregister dokumentieren.
- Eine Datenbank einsetzen, die älter als drei Monate ist.
Bon, ein letzter Punkt, der oft untergeht: Prüfen Sie nach jedem Update, ob Ihr Log-Retention-Konzept noch passt. Geo-Daten in alten Indizes bleiben alt – eine Neuberechnung historischer Daten ist meist nicht gewollt und datenschutzrechtlich heikel.
Häufig gestellte Fragen zur GeoIP-Aktualisierung
Wie oft sollte die GeoIP-Datenbank in Logstash aktualisiert werden?
MaxMind veröffentlicht GeoLite2 wöchentlich, ein Rhythmus von einer bis zwei Wochen ist ein guter Kompromiss. Wer Angriffsanalysen betreibt, sollte wöchentlich aktualisieren, weil neue Provider-Blöcke sonst fehlen.
Kann ich statt GeoLite2 die kostenpflichtige GeoIP2-Datenbank verwenden?
Ja, der Filter akzeptiert beide Formate, die Konfiguration bleibt identisch. Der Preis liegt je nach Volumen und Modul im Bereich einiger hundert Euro pro Jahr, genaue Konditionen nennt MaxMind auf Anfrage.
Warum liefert der geoip-Filter nach dem Update keine Daten mehr?
Meist stimmt der Pfad in der Konfiguration nicht oder der Dienstnutzer darf die Datei nicht lesen. Prüfen Sie beides, dann die Logs – ein korruptes Archiv ist die dritthäufigste Ursache.
Gibt es europäische Alternativen zu MaxMind?
Es gibt Anbieter wie IP2Location, doch die Integration in den geoip-Filter ist auf das MMDB-Format optimiert. Prüfen Sie die Kompatibilität, bevor Sie den Anbieter wechseln, sonst schreiben Sie eigene Lookup-Logik.
Für mich bleibt die Kombination aus MaxMind-Datenbank, atomarem Dateitausch und überwachtem Neustart die robusteste Lösung. Sie ist unspektakulär, aber sie hält – und darauf kommt es im Betrieb an.




