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

Massenbearbeitung – Hinzufügen von Geräten, Gruppenaufträgen und Vorlageninstanzen
Massenbearbeitung – Aktualisieren von Geräten und Jobs (Schwellenwerte, Namen, Intervalle, Jobparameter)
Massenbearbeitung – Löschen von Jobs
Vorlagenfunktionalität
Detaillierte Bestandsaufnahme einschließlich Schwellenwerten

Der CSV-Export/Import berücksichtigt nur zwei Gruppenebenen über einem Gerät. Geräte und Jobs in tieferen Baumstrukturen werden nur mit zwei Gruppen darüber 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-Export-Symbol:

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

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

CSV – Gruppen-Tags

Tag	Beschreibung
GROUP_NAME_1	Gruppenname unterhalb der übergeordneten Import-/Exportgruppe
GROUP_NAME_2	Gruppenname unter GROUP_NAME_1 (über Geräten)

CSV – Geräte-Tags

Tag	Beschreibung
DEVICE_NAME	Name des Geräts. Dieses Tag darf bei Hinzufügen/Aktualisieren nicht leer sein.
DEVICE_TYPE	Typ des Geräts. Mögliche Schlüssel: Firewall, Firewall_pix, Gateway, Host, ids_ips, Schnittstelle, Sonstiges, Proxy, Drucker, Router, Server, SSL, Switch, VPN, WLAN
DEVICE_ADDRESS	DNS-Name oder IP-Adresse des Geräts
DEVICE_SUBNET_MASK	Subnetzmaske des Geräts

CSV – Job-Tags

Tag	Beschreibung
JOB_NAME	Name des Auftrags. Dieses Tag darf bei Add-/Update-Vorgängen nicht leer sein.
JOB_TYPE	Typ des Jobs. Dieser Eintrag kann nicht geändert werden. Mögliche Schlüssel für Hinzufügen-Vorgänge: dhcp, remote_disk, dns, dns_query, fetchfile, http, ping, imap, remote_nwinterface, parsefile, pop3, remote_process, shell, smtp, snmp, sql, tcp, buslay
JOB_AGENT	Anmeldename des Kollektors, der den Job ausführt.
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_PARAMETERS	Zeichenfolge, die alle für die Ausführung eines Jobs erforderlichen Parameter enthält. Bitte beachten Sie, dass \r als $!r!$ und \n als $!n!$codiert werden muss. Beispiel für einen ICMP-Job: interval_mode=0&packets=10&bytes=56&icmpid_random=0
JOB_ALARM_LIMITS	Alarm Limit-Zeichenfolge. 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 „Vollständiger Inhalt“ angegeben wird.

Beispiel: PID-Seriennummer

CSV – andere Tags

Tag	Beschreibung
TEMPLATE_NAME	Name der Vorlage, mit der ein Gerät oder eine Jobinstanz verknüpft ist
TYPE	Typ des Objekts (Gruppe, Gerät, Auftrag), kann nicht geändert werden
ID	Objekt-ID für Aktualisierungs-/Löschvorgang
BEFEHL	Mögliche Werte: ignore: Zeile wird ignoriert (als wäre sie aus der CSV-Datei gelöscht worden) use: Wenn nicht hinzufügen/aktualisieren, als übergeordnetes Element zum Hinzufügen unten verwenden (erforderlich für Aufträge 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) delete: Nur Jobs können gelöscht werden

CSV – Export

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

Konfigurationsbeispiel:

Eigenschaft	Beschreibung
Name	Name der Exportkonfiguration
Spaltentrennzeichen	Wählen Sie eine der folgenden Optionen: , ; \| : oder Tabulator
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ätetags 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 das Tag DEVICE_NAME zu Informationszwecken hinzugefügt. Grundlegend: 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 Vollständig: umfasst den grundlegenden Inhalt sowie DEVICE_SUBNET_MASK, DEVICE_SYSLOG_SOURCE, DEVICE_SYSLOG_LEVEL, DEVICE_WEB_LINK, DEVICE_REMOTE_ACCESS und alle PID-Tags
Gruppen	Wenn Sie dieses Kästchen anklicken, enthält die Datei auch den Gruppennamen, der die Objekte enthält, sowie den Namen der zugehörigen Gruppe.
Geräte, Aufträge	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 erstellen, navigieren Sie zum neuen Objekt, klicken Sie auf „Generieren“ und dann auf die Schaltfläche „Generieren“ im rechten Bereich:

Öffnen Sie die CSV-Datei nach der Erstellung mit Internet Explorer, Firefox, Excel oder einer beliebigen Tabellenkalkulationsanwendung oder speichern Sie sie lokal. Ändern Sie die Parameter nach Bedarf oder lassen Sie sie unverändert.

Beispiel für die Ausgabe einer CSV-Exportdatei:

CSV – Import

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

Konfiguration:

Eigenschaft	Beschreibung
Name	Name der CSV-Importkonfiguration
Spaltentrennzeichen	Wählen Sie je nach dem in der zu importierenden Datei verwendeten Trennzeichen eine der folgenden Optionen: , ; \| : oder Tabulator.
Gruppe „Unterhalb von“	Einstiegspunkt des Objektbaums, um darunter Objekte hinzuzufügen. Bei den Befehlen „Aktualisieren“, „Löschen“ und „Verwenden“ 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 für hinzugefügte Objekte leer gelassen.
Datei hochladen	Bereich zum Hochladen vorbereiteter CSV-Importdateien

Bevor ein Import gestartet wird, wird eine Konsistenzprüfung der Datei durchgeführt, die manuell durch Klicken auf „Prüfen” gestartet werden kann. Auf der Importseite wird eine statistische Übersicht angezeigt. Die Protokolldatei enthält weitere Informationen zu jeder verarbeiteten Zeile.

CSV – Importbeispiel

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

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

Verwenden Sie ein vorhandenes Importobjekt oder erstellen Sie ein neues mit „CSV-Import hinzufügen”. Dasselbe 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 „Prüfen“:

Wenn die Überprüfung fehlschlägt, öffnen Sie die unter dem Abschnitt „Result Details“ (Ergebnisdetails) bereitgestellte Protokolldatei und korrigieren Sie die Fehler in der Importdatei:

Wenn die Überprüfung erfolgreich war, überprüfen Sie die im Abschnitt „Result Details“ (Ergebnisdetails) aufgeführten Objekte und klicken Sie auf „Import“ (Importieren):

Nach Abschluss des Imports werden die Ergebnisdetails erneut angezeigt:

Die resultierenden Objekte sollten nun unter dem ausgewählten Eintragspfad angezeigt werden:

CSV – Import mit Vorlagen

Bei Verwendung des CSV-Imports kann die Spalte TEMPLATE_NAME der CSV-Quelldatei verwendet werden, um Instanzen vorhandener Vorlagen zu erstellen. Beachten Sie Folgendes zum Import von Vorlagen:

Die Spalte TEMPLATE_NAME wird nur interpretiert, wenn für die jeweilige Zeile der Befehl add verwendet wird
Der Import prüft, ob genau eine Vorlage der obersten Ebene des entsprechenden Typs vorhanden ist, andernfalls wird ein Fehler gemeldet
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 Elements 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.

Dokumentation

CSV exportieren/importieren