CSV exportieren/importieren
Der CSV-Export/-Import wird für folgende Aufgaben verwendet:
- Massenmanipulation - Hinzufügen von Geräten, Gruppen von Jobs und Vorlageninstanzen
- Massenmanipulation - Aktualisieren von Geräten und Jobs (Schwellenwerte, Namen, Intervalle, Jobparameter)
- Massenmanipulation - Löschen von Arbeitsplätzen
- Vorlagenfunktionalität
- Detaillierte Bestandsaufnahme einschließlich Schwellenwerte
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ü 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 hat 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
Schild | Beschreibung |
---|---|
GROUP_NAME_1 | Gruppenname unter dem übergeordneten Import/Export |
GROUP_NAME_2 | Gruppenname unter GROUP_NAME_1 (über Geräten) |
CSV - Geräte-Tags
Schild | Beschreibung |
---|---|
GERÄTENAME | Name des Geräts. Dieses Tag sollte für den Vorgang zum Hinzufügen/Aktualisieren nicht leer sein |
GERÄTETYP | Typ des Geräts. Mögliche Schlüssel: firewall, firewall_pix, gateway, host, ids_ips, interface, other, proxy, printer, 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
Schild | Beschreibung |
---|---|
BERUFSBEZEICHNUNG | Name des Jobs. Dieses Tag sollte für den Vorgang zum Hinzufügen/Aktualisieren nicht leer sein |
AUFTRAGSTYP | Art des Jobs. Dieser Artikel kann nicht geändert werden. Mögliche Schlüssel für die Hinzufügungsoperation: 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_AUSFÜHRUNG | 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 ICMP-Job: interval_mode=0&packets=10&bytes=56&icmpid_random=0 |
JOB_ALARM_LIMITS | Alarm Limit . Beispiel für 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 Objekten zugewiesene Eigenschaften und benutzerdefinierte Eigenschaften enthalten. Diese Spalten werden erstellt, wenn Standard- oder Vollständiger Inhalt beim Export angegeben wird.
Beispiel: PID Seriennr
CSV - andere Tags
Schild | Beschreibung |
---|---|
TEMPLATE_NAME | Name der Vorlage, mit der eine Geräte- oder Jobinstanz verknüpft ist |
TYP | Art des Objekts (Gruppe, Gerät, Job), kann nicht geändert werden |
ICH WÜRDE | Objekt-ID für Aktualisierungs-/Löschvorgang |
BEFEHL | Mögliche Werte: ignorieren : Zeile wird ignoriert (als ob sie aus der CSV-Datei gelöscht würde) verwenden : Wenn nicht hinzufügen/aktualisieren, als übergeordnetes Element verwenden, um unten hinzuzufügen (erforderlich 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 (Auftragstypen können nicht geändert werden) löschen : Nur Jobs können gelöscht werden |
CSV-Export
Navigieren Sie zum Erstellen eines Exportobjekts zu /root/Configurations und wählen Sie CSV-Export hinzufügen aus:
Konfigurationsbeispiel:
Eigentum | Beschreibung |
---|---|
Name | Name der Exportkonfiguration |
Spaltentrenner | Wählen Sie eines von , ; | : oder tab |
Unten 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ätekennzeichen 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. 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 | Durch Anklicken dieses Kästchens enthält die Datei auch den Gruppennamen, der die Objekte enthält, sowie den gruppenzugehörigen Gruppennamen |
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 zu dem neuen Objekt, klicken Sie auf Generieren und klicken Sie im rechten Bereich auf die Schaltfläche Generieren :
Öffnen Sie nach der Generierung die CSV mit dem Internet Explorer; Firefox, Excel oder eine beliebige Tabellenkalkulationsanwendung oder speichern Sie sie lokal. Ändern Sie die Parameter bei Bedarf oder belassen Sie sie so, wie sie sind.
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 nach Trennzeichen, das in der zu importierenden Datei verwendet wird |
Unten Gruppe | Einstiegspunkt des Objektbaums, um darunter Objekte hinzuzufügen. Für Update-, Delete- und Use -Befehle 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 bei vorhandenen Objekten nicht geändert und bei hinzugefügten Objekten leer gelassen |
Datei hochladen | Bereich zum Hochladen vorbereiteter CSV-Importdateien |
Vor dem Start eines Imports wird eine Konsistenzprüfung der Datei durchgeführt, die manuell durch Drücken von Prüfen ausgelöst werden kann. Auf der Importseite wird eine statistische Übersicht angezeigt. Die Protokolldatei enthält weitere Informationen für jede verarbeitete 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 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 je zwei Jobs unterhalb der bestehenden Gruppe Region Zürich unterhalb der Gruppe Geräte hinzugefügt werden. Die ID- Spalte wurde von 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 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 Upload File und klicken Sie auf Check :
Wenn die Prüfung fehlschlägt, öffnen Sie die unter dem Abschnitt Ergebnisdetails bereitgestellte Protokolldatei und korrigieren Sie die Fehler in der Importdatei:
Wenn die Prüfung erfolgreich war, überprüfen Sie die Objekte, die im Abschnitt Ergebnisdetails aufgeführt sind, und klicken Sie auf Importieren :
Nach Abschluss des Imports werden die Ergebnisdetails erneut angezeigt:
Die resultierenden Objekte sollten nun unter dem ausgewählten Eintragsbaumpfad erscheinen:
CSV - Import mit Vorlagen
Bei Verwendung des CSV-Imports kann die Spalte TEMPLATE_NAME der Quell-CSV-Datei verwendet werden, um Instanzen vorhandener Vorlagen zu erstellen. Beachten Sie beim Vorlagenimport Folgendes:
- Die Spalte TEMPLATE_NAME wird nur interpretiert, wenn für die entsprechende Zeile der Befehl add verwendet wird
- Der Import prüft, ob genau ein Top-Level-Template des entsprechenden Typs existiert, andernfalls zeigt er einen Fehler an
- 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 unter dem aktuellen Gerät hinzugefügt (zuletzt hinzugefügt oder durch den Befehl „use“ definiert)
- Es ist nicht möglich, eine Gruppe unter einem Gerät hinzuzufügen