Der CSV-Export/Import wird für folgende Aufgaben verwendet:

Massenmanipulation – Hinzufügen von Geräten, Gruppenjobs und Vorlageninstanzen
Massenmanipulation – Aktualisierung von Geräten und Jobs (Schwellenwerte, Namen, Intervalle, Jobparameter)
Massenmanipulation – Löschung von Arbeitsplätzen
Vorlagenfunktionalität
Detaillierte Bestandsaufnahme inklusive Schwellenwerten

Der CSV-Export/Import berücksichtigt nur zwei Gruppenebenen über einem Gerät. Geräte und Jobs in tieferen Baumstrukturen werden nur mit den beiden oben genannten Gruppen exportiert.

Um die Exportfunktion zu verwenden, navigieren Sie zu /root/Configurations und wählen Sie die entsprechende Funktion aus dem Menü aus oder klicken Sie auf das CSV-Exportsymbol:

Import und Export werden als der Benutzer ausgeführt, der die Aktion initiiert oder das Scheduler-Objekt bearbeitet (nur Export). Beim Import einer CSV-Datei muss diese das gleiche Format haben wie bei der Erstellung durch die Exportfunktion.

Jede Spalte verfügt über ein Tag (in Großbuchstaben) in der Kopfzeile, um den Typ der Spalte zu identifizieren. Die im nächsten Abschnitt beschriebenen Tags werden definiert.

CSV – Gruppen-Tags

Etikett	Beschreibung
GROUP_NAME_1	Gruppenname unter übergeordnetem Import/Export
GROUP_NAME_2	Gruppenname unter GROUP_NAME_1 (über den Geräten)

CSV – Geräte-Tags

Etikett	Beschreibung
GERÄTENAME	Name des Geräts. Dieses Tag sollte für den Vorgang „Hinzufügen/Aktualisieren“ nicht leer sein
GERÄTETYP	Typ des Geräts. Mögliche Schlüssel: Firewall, firewall_pix, Gateway, Host, ids_ips, Schnittstelle, andere, Proxy, Drucker, Router, Server , SSL, Switch, VPN, WLAN
GERÄTE_ADRESSE	DNS-Name oder IP-Adresse des Geräts
DEVICE_SUBNET_MASK	Subnetzmaske des Geräts

CSV – Job-Tags

Etikett	Beschreibung
BERUFSBEZEICHNUNG	Name des Jobs. Dieses Tag sollte für den Vorgang „Hinzufügen/Aktualisieren“ nicht leer sein
AUFTRAGSTYP	Art des Jobs. Dieses Element kann nicht geändert werden. Mögliche Schlüssel für den Add-Vorgang: dhcp, remote_disk, dns, dns_query, fetchfile, http, ping, imap, remote_nwinterface, parsefile, pop3, remote_process, shell, smtp, snmp, sql, tcp, buslay
BERUFSBERATER	Anmeldename des Kollektor , der den Job ausführen wird
JOB_INTERVAL	Intervall in Sekunden. Mögliche Werte: 5, 10, 20, 30, 40, 50, 60 (1 Minute), 120 (2 Minuten), 180 (3 Minuten), 240 (4 Minuten), 300 (5 Minuten), 360 (6 Minuten) , 600 (10 Minuten), 1800 (30 Minuten), 3600 (1 Stunde), 7200 (2 Stunden), 21600 (6 Stunden), 43200 (12 Stunden), 86400 (1 Tag), 604800 (7 Tage)
JOB_EXECUTION	Mögliche Werte: gestartet , gestoppt
JOB_PARAMETER	Zeichenfolge, die alle erforderlichen Parameter zum Ausführen eines Jobs enthält. Bitte beachten Sie, dass \r als $!r!$ und \n als $!n!$ kodiert werden muss. Beispiel für einen ICMP-Job: Interval_mode=0&packets=10&bytes=56&icmpid_random=0
JOB_ALARM_LIMITS	Alarm Limit . Beispiel für einen ICMP-Job : WarningCond=Or&Warning1=error_code;<>;0;1;&MajorCond=Or&Major1=packetloss;%3d;100;1;

CSV – PID-Tags

Es gibt verschiedene PID-Tags, die Eigenschaften und benutzerdefinierte Eigenschaften enthalten, die Objekten zugewiesen sind. Diese Spalten werden erstellt, wenn beim Export Standard- oder Vollinhalt angegeben wird.

Beispiel: PID-Seriennr

CSV – andere Tags

Etikett	Beschreibung
VORLAGE_NAME	Name der Vorlage, mit der ein Gerät oder eine Jobinstanz verknüpft ist
TYP	Der Objekttyp (Gruppe, Gerät, Job) kann nicht geändert werden
AUSWEIS	Objekt-ID für den Aktualisierungs-/Löschvorgang
BEFEHL	Mögliche Werte: ignorieren : Zeile wird ignoriert (als ob sie aus der CSV-Datei gelöscht würde) Verwendung : Wenn nicht hinzufügen/aktualisieren, als übergeordnetes Element zum Hinzufügen unten verwenden (notwendig für Jobs und Vorlagen). add : Objekt hinzufügen (für Jobs: Ein Gerät muss mit dem Befehl add , use oder update definiert werden) update : Konfiguration aktualisieren (Jobtypen können nicht geändert werden) löschen : Nur Jobs können gelöscht werden

CSV – Export

Um ein Exportobjekt zu erstellen, navigieren Sie zu /root/Configurations und wählen Sie CSV-Export hinzufügen :

Konfigurationsbeispiel:

Eigentum	Beschreibung
Name	Name der Exportkonfiguration
Spaltentrenner	Wählen Sie eines von , ; \| : oder Tab
Unterhalb der Gruppe	Einstiegspunkt des Objektbaums. Objekte unterhalb dieser Gruppe werden exportiert. Navigieren Sie zu der Gruppe, die die zu exportierenden Geräte enthält
Inhalt	Ermöglicht die Auswahl der zu exportierenden Datenmenge. Die Tags GROUP_NAME_1 und GROUP_NAME_2 werden nur exportiert, wenn in der Konfiguration Gruppen ausgewählt sind. Die Geräte-Tags werden nur exportiert, wenn Geräte ausgewählt sind. Die Job-Tags werden nur exportiert, wenn Jobs ausgewählt sind. Wenn nur Jobs exportiert werden, wird zu Informationszwecken das Tag DEVICE_NAME hinzugefügt. Basic: besteht aus: GROUP_NAME_1, GROUP_NAME_2, DEVICE_NAME, DEVICE_TYPE, DEVICE_ADDRESS, JOB_NAME, JOB_TYPE, JOB_AGENT, JOB_INTERVAL, JOB_EXECUTION, JOB_PARAMETERS, JOB_ALARM_LIMITS, TEMPLATE_NAME, TYPE, ID, COMMAND Voll: besteht aus grundlegenden Inhalten und DEVICE_SUBNET_MASK, DEVICE_SYSLOG_SOURCE, DEVICE_SYSLOG_LEVEL, DEVICE_WEB_LINK, DEVICE_REMOTE_ACCESS sowie allen PID- Tags
Gruppen	Wenn Sie auf dieses Kästchen klicken, enthält die Datei auch den Gruppennamen, der die Objekte enthält, sowie den Namen der mit der Gruppe verbundenen Gruppe
Geräte, Jobs	In diesem Abschnitt kann die Anzahl der Einträge in der CSV-Datei reduziert werden, indem ein Filter definiert wird, wie in der obigen Beispielkonfiguration angegeben

Um eine Exportdatei zu generieren, navigieren Sie zum neuen Objekt, klicken Sie auf „Generieren“ und klicken Sie im rechten Bereich auf die Schaltfläche „Generieren“ :

Öffnen Sie nach der Generierung die CSV-Datei mit dem Internet Explorer. Firefox, Excel oder ein beliebiges Tabellenkalkulationsprogramm oder speichern Sie es lokal. Ändern Sie die Parameter bei Bedarf oder lassen Sie sie unverändert.

Beispielausgabe einer CSV-Exportdatei:

CSV – Import

Navigieren Sie zu /root/Configurations und wählen Sie CSV-Import hinzufügen :

Aufbau:

Eigentum	Beschreibung
Name	Name der CSV-Importkonfiguration
Spaltentrenner	Wählen Sie eines von , ; \| : oder Tab, je nachdem, welches Trennzeichen in der zu importierenden Datei verwendet wird
Unterhalb der Gruppe	Einstiegspunkt des Objektbaums zum Hinzufügen von Objekten darunter. Für Aktualisierungs-, Lösch- und Verwendungsbefehle werden der Typ und die ID in der CSV-Datei verwendet und dieser Konfigurationseintrag wird ignoriert
Datei	Die zu importierende CSV-Datei. Leere Einträge werden gelöscht. Nicht vorhandene Einträge werden für vorhandene Objekte nicht geändert und bleiben für hinzugefügte Objekte leer
Datei hochladen	Bereich zum Hochladen vorbereiteter CSV-Importdateien

Bevor ein Import gestartet wird, wird eine Konsistenzprüfung der Datei durchgeführt, die manuell durch Drücken von Prüfen ausgelöst werden kann. Eine statistische Übersicht wird auf der Importseite angezeigt. Die Protokolldatei enthält weitere Informationen für jede behandelte Zeile.

CSV – Importbeispiel

Als Vorlage für den Import kann eine zuvor exportierte CSV-Datei verwendet werden. Neue Geräte, Jobs und Geräte- oder Jobvorlageninstanzen können mithilfe der unten gezeigten Konfiguration hinzugefügt werden. Nach dem Export sind alle Befehle standardmäßig auf Ignorieren eingestellt.

Im folgenden Beispiel sollen zwei Geräte mit je zwei Jobs unterhalb der bestehenden Gruppe Region Zürich unterhalb der Gruppe Geräte hinzugefügt werden. Die ID- Spalte wurde bei den exportierten Objekten belassen, um die vorhandenen Gruppen zu identifizieren. Die Befehlsspalte wurde von „Ignorieren“ auf „Verwenden“ für die Gruppen und „ Hinzufügen “ für die neuen Geräte und Jobs geändert:

Verwenden Sie ein beliebiges vorhandenes Importobjekt oder erstellen Sie mit „CSV-Import hinzufügen“ ein neues. Das gleiche Importobjekt kann für verschiedene Importaufgaben verwendet werden. Für zukünftige automatisierte Importvorgänge können mehrere Importobjekte erstellt werden.

Klicken Sie auf Importieren , um die Importkonfiguration zu öffnen:

Ziehen Sie die vorbereitete CSV-Datei per Drag & Drop in den Bereich „Datei hochladen“ und klicken Sie auf „Überprüfen“ :

Wenn die Prüfung fehlschlägt, öffnen Sie die Protokolldatei unterhalb des Abschnitts „Ergebnisdetails“ und korrigieren Sie die Fehler in der Importdatei:

Wenn die Prüfung erfolgreich war, überprüfen Sie die im Abschnitt „Ergebnisdetails“ aufgeführten Objekte und klicken Sie auf „Importieren“ :

Nach Abschluss des Imports werden die Ergebnisdetails erneut angezeigt:

Die resultierenden Objekte sollten nun unterhalb des ausgewählten Eintragsbaumpfads erscheinen:

CSV – Import mit Vorlagen

Beim CSV-Import kann die Spalte TEMPLATE_NAME der Quell-CSV-Datei zum Erstellen von Instanzen vorhandener Vorlagen verwendet werden. Beachten Sie Folgendes beim Vorlagenimport:

Die Spalte TEMPLATE_NAME wird nur interpretiert, wenn der Befehl add für die entsprechende Zeile verwendet wird
Der Import prüft, ob genau eine Top-Level-Vorlage des entsprechenden Typs vorhanden ist, andernfalls wird ein Fehler angezeigt
Vorlagen werden für Gruppen, Geräte und Jobs unterstützt
Die neuen Objekte werden als Instanzen aus der Vorlage erstellt
Gruppen und Geräte werden unterhalb des aktuellen übergeordneten Geräts hinzugefügt
Jobs werden unterhalb des aktuellen Geräts hinzugefügt (zuletzt hinzugefügt oder durch den Befehl „use“ definiert).
Es ist nicht möglich, eine Gruppe unterhalb eines Geräts hinzuzufügen

Docs

CSV exportieren/importieren