L'esportazione/importazione CSV viene utilizzata per le seguenti attività:

Manipolazione di massa: aggiunta di dispositivi, gruppi di lavori e istanze di modelli
Modifica di massa: aggiornamento di dispositivi e lavori (soglie, nomi, intervalli, parametri di lavoro)
Modifica di massa - eliminazione di lavori
Funzionalità dei modelli
Inventario dettagliato comprese le soglie

L'esportazione/importazione CSV considera solo due livelli di gruppo sopra un dispositivo. I dispositivi e i lavori in strutture ad albero più profonde verranno esportati solo con due gruppi sopra.

Per utilizzare la funzione di esportazione, accedere a /root/Configurations e selezionare la funzione appropriata dal menu o fare clic sull'icona di esportazione CSV:

L'importazione e l'esportazione vengono eseguite dall'utente che avvia l'azione o modifica l'oggetto Scheduler (solo esportazione). Quando si importa un file CSV, questo deve avere lo stesso formato di quando è stato creato dalla funzione di esportazione.

Ogni colonna ha un tag (in lettere maiuscole) nella riga di intestazione per identificare il tipo di colonna. I tag descritti nella sezione successiva sono definiti.

CSV - tag di gruppo

Tag	Descrizione
GROUP_NAME_1	Nome del gruppo sotto importazione/esportazione principale
GROUP_NAME_2	Nome del gruppo sotto GROUP_NAME_1 (sopra i dispositivi)

CSV - tag dei dispositivi

Tag	Descrizione
DEVICE_NAME	Nome del dispositivo. Questo tag non deve essere vuoto per le operazioni di aggiunta/aggiornamento
TIPO_DISPOSITIVO	Tipo di dispositivo. Chiavi possibili: firewall, firewall_pix, gateway, host, ids_ips, interfaccia, altro, proxy, stampante, router, server, ssl, switch, vpn, wlan
DEVICE_ADDRESS	Nome DNS o indirizzo IP del dispositivo
DEVICE_SUBNET_MASK	Subnet mask del dispositivo

CSV - tag di lavoro

Tag	Descrizione
JOB_NAME	Nome del lavoro. Questo tag non deve essere vuoto per le operazioni di aggiunta/aggiornamento
JOB_TYPE	Tipo di lavoro. Questo elemento non può essere modificato. Chiavi possibili per l'operazione di aggiunta: dhcp, remote_disk, dns, dns_query, fetchfile, http, ping, imap, remote_nwinterface, parsefile, pop3, remote_process, shell, smtp, snmp, sql, tcp, buslay
JOB_AGENT	Nome di accesso del collettore che eseguirà il lavoro
JOB_INTERVAL	Intervallo in secondi. Valori possibili: 5, 10, 20, 30, 40, 50, 60 (1 minuto), 120 (2 minuti), 180 (3 minuti), 240 (4 minuti), 300 (5 minuti), 360 (6 minuti), 600 (10 minuti), 1800 (30 minuti), 3600 (1 ora), 7200 (2 ore), 21600 (6 ore), 43200 (12 ore), 86400 (1 giorno), 604800 (7 giorni)
JOB_EXECUTION	Valori possibili: avviato, arrestato
JOB_PARAMETERS	Stringa contenente tutti i parametri necessari per eseguire un lavoro. Si noti che \r deve essere codificato come $!r!$ e \n come $!n!$. Esempio per un lavoro ICMP: interval_mode=0&packets=10&bytes=56&icmpid_random=0
JOB_ALARM_LIMITS	Stringa del limite di allarme. Esempio per un lavoro ICMP: WarningCond=Or&Warning1=error_code;<>;0;1;&MajorCond=Or&Major1=packetloss;%3d;100;1;

CSV - Tag PID

Esistono vari tag PID che contengono proprietà e proprietà personalizzate assegnate agli oggetti. Queste colonne vengono create se con l'esportazione viene specificato il contenuto Standard o Completo.

Esempio: PID Numero di serie

CSV - altri tag

Tag	Descrizione
TEMPLATE_NAME	Nome del modello a cui è collegato un dispositivo o un'istanza di lavoro
TYPE	Tipo di oggetto (gruppo, dispositivo, processo), non modificabile
ID	ID oggetto per operazioni di aggiornamento/eliminazione
COMMAND	Valori possibili: ignore: la riga viene ignorata (come se fosse stata eliminata dal file csv) use: se non si aggiunge/aggiorna, utilizzare come padre per aggiungere sotto (necessario per lavori e modelli) add: aggiungi oggetto (per i lavori: un dispositivo deve essere definito con il comando add, use o update) aggiorna: aggiorna la configurazione (i tipi di lavoro non possono essere modificati) delete: è possibile eliminare solo i lavori

CSV - esporta

Per creare un oggetto di esportazione, vai su /root/Configurations e seleziona Add CSV Export:

Esempio di configurazione:

Proprietà	Descrizione
Nome	Nome della configurazione di esportazione
Separatore di colonne	Scegliere uno tra , ; \| : o tabulatore
Gruppo sottostante	Punto di ingresso dell'albero degli oggetti. Gli oggetti sotto questo gruppo vengono esportati. Selezionare il gruppo contenente i dispositivi da esportare
Contenuto	Consente di selezionare la quantità di dati da esportare. I tag GROUP_NAME_1 e GROUP_NAME_2 vengono esportati solo se nella configurazione sono stati selezionati dei gruppi. I tag dei dispositivi vengono esportati solo se sono stati selezionati dei dispositivi. I tag dei lavori vengono esportati solo se sono stati selezionati dei lavori. Se vengono esportati solo i lavori, il tag DEVICE_NAME viene aggiunto a scopo informativo. Base: comprende: 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 Completa: comprende i contenuti di base e DEVICE_SUBNET_MASK, DEVICE_SYSLOG_SOURCE, DEVICE_SYSLOG_LEVEL, DEVICE_WEB_LINK, DEVICE_REMOTE_ACCESS, oltre a tutti i tag PID
Gruppi	Facendo clic su questa casella, il file conterrà anche il nome del gruppo che contiene gli oggetti, nonché il nome del gruppo affiliato
Dispositivi, lavori	In questa sezione è possibile ridurre il numero di voci nel file CSV definendo un filtro come indicato nella configurazione di esempio sopra riportata

Per generare un file di esportazione, passare al nuovo oggetto, fare clic su Genera e premere il pulsante Genera nel pannello di destra:

Dopo la generazione, aprire il CSV con Internet Explorer, Firefox, Excel o qualsiasi applicazione per fogli di calcolo, oppure salvarlo localmente. Modificare i parametri se lo si desidera o lasciarli così come sono.

Esempio di output di un file di esportazione CSV:

CSV - importazione

Passare a /root/Configurations e selezionare Aggiungi importazione CSV:

Configurazione:

Proprietà	Descrizione
Nome	Nome della configurazione di importazione CSV
Separatore di colonne	Scegliere uno tra , ; \| : o tabulazione, a seconda del separatore utilizzato nel file da importare
Gruppo sottostante	Punto di ingresso dell'albero degli oggetti in cui aggiungere gli oggetti sottostanti. Per i comandi di aggiornamento, eliminazione e utilizzo, vengono utilizzati il tipo e l'ID nel file CSV e questa voce di configurazione viene ignorata
File	Il file CSV da importare. Le voci vuote vengono cancellate. Le voci inesistenti non vengono modificate per gli oggetti esistenti e vengono lasciate vuote per gli oggetti aggiunti
Carica file	Area per caricare i file CSV di importazione preparati

Prima di avviare l'importazione, viene eseguito un controllo di coerenza del file che può essere avviato manualmente premendo Controlla. Nella pagina di importazione viene visualizzata una panoramica statistica. Il file di log contiene ulteriori informazioni per ogni riga gestita.

CSV - esempio di importazione

Un file CSV esportato in precedenza può essere utilizzato come modello per l'importazione. È possibile aggiungere nuovi dispositivi, lavori e istanze di modelli di dispositivi o lavori utilizzando la configurazione mostrata di seguito. Dopo l'esportazione, tutti i comandi sono impostati di default su Ignora.

Nell'esempio seguente, due dispositivi con due lavori ciascuno devono essere aggiunti sotto il gruppo esistente Regione Zurigo sotto il gruppo Dispositivi. La colonna ID è stata lasciata dagli oggetti esportati per identificare i gruppi esistenti. La colonna comando è stata modificata da Ignora a Usa per i gruppi e Aggiungi per i nuovi dispositivi e lavori:

Utilizzare qualsiasi oggetto di importazione esistente o crearne uno nuovo con Aggiungi importazione CSV. Lo stesso oggetto di importazione può essere utilizzato per diverse attività di importazione. È possibile creare più oggetti di importazione per future procedure di importazione automatizzate.

Fare clic su Importa per aprire la configurazione di importazione:

Trascinare il CSV preparato nell'area Carica file e fare clic su Verifica:

Se il controllo non va a buon fine, aprire il file di log fornito sotto la sezione Dettagli risultato e correggere gli errori nel file di importazione:

Se il controllo ha avuto esito positivo, verifica gli oggetti elencati nella sezione Dettagli risultato e clicca su Importa:

Al termine dell'importazione, i dettagli dei risultati vengono visualizzati nuovamente:

Gli oggetti risultanti dovrebbero ora apparire sotto il percorso dell'albero di voci selezionato:

CSV - importazione con modelli

Quando si utilizza l'importazione CSV, la colonna TEMPLATE_NAME del file CSV di origine può essere utilizzata per creare istanze di modelli esistenti. Tenere presente quanto segue riguardo all'importazione dei modelli:

La colonna TEMPLATE_NAME viene interpretata solo se per la riga corrispondente viene utilizzato il comando add
L'importazione verifica se esiste esattamente un modello di primo livello del tipo appropriato, altrimenti segnala un errore
I modelli sono supportati per gruppi, dispositivi e lavori
I nuovi oggetti vengono creati come istanze dal modello
I gruppi e i dispositivi vengono aggiunti sotto il genitore corrente
I lavori vengono aggiunti sotto il dispositivo corrente (ultimo aggiunto o definito dal comando "use")
Non è possibile aggiungere un gruppo sotto un dispositivo

Documentazione

Esportazione/importazione di CSV