Cos'è la documentazione di rete?
La documentazione di rete si riferisce ai processi per tenere traccia dei componenti presenti nella tua infrastruttura. Si tratta dell'hardware, dei cavi, delle versioni del software e dei servizi in esecuzione su ciascun host che compongono la rete interna. La documentazione può essere semplice come un foglio di calcolo con poche informazioni o complessa come uno strumento di documentazione di rete dedicato che automatizza il processo. La maggior parte delle aziende opta per una soluzione intermedia, a seconda delle dimensioni delle reti.
La documentazione di rete di un'azienda può essere composta da numerosi tipi di dati raccolti. Il minimo indispensabile è un elenco dell'hardware in servizio o conservato come backup. Ciò significa il fornitore, la versione dell'hardware, il modello esatto e tutti i nomi e i modelli dei componenti che compongono ogni dispositivo. Switch, router, bridge, cavi di rete e server costituiscono la parte hardware della documentazione di rete.
La parte software è quella più complessa e in continua evoluzione. Il software che cambia raramente, come il firmware, non è l'unico tipo da documentare; tutti i servizi in esecuzione su server, host e dispositivi di rete costituiscono l'intera documentazione software della rete. Questi dati sono soggetti a frequenti modifiche, soprattutto nel caso di ambienti cloud, rendendo il loro monitoraggio un compito impossibile da svolgere manualmente.
Questo è il motivo principale per cui esiste un software di documentazione di rete. Non solo per automatizzare le attività manuali che altrimenti diventerebbero obsolete ogni giorno, ma anche per snellire l'intero processo.
Perché la documentazione di rete è importante?
La documentazione di rete è un'altra parte importante del monitoraggio della rete. Il motivo è semplice: conoscendo le caratteristiche dell'infrastruttura, è possibile monitorarla meglio. Ma questo non è tutto.
Immagina un caso in cui un nuovo ingegnere entra in azienda e non esiste una documentazione di rete. Questo pone un problema al nuovo assunto: non può scoprire rapidamente come è impostata la tua infrastruttura. Impiegare del tempo per imparare come è interconnessa diventa un compito lungo e soggetto a errori, che sarebbe stato evitato con una documentazione di rete chiara. Anche sparsi appunti degli ingegneri precedenti sarebbero stati d'aiuto, anche se non ottimali come documentazione.
Ignorare i vantaggi della documentazione di rete comporta quindi uno spreco di tempo e denaro. Un buon strumento di documentazione di rete avrebbe mantenuto costantemente aggiornato lo stato dell'infrastruttura, lasciando che gli ingegneri si dedicassero a compiti più produttivi.
Ma non si tratta solo di risparmiare tempo e denaro. Occasionalmente può essere necessario effettuare una verifica a causa di procedure interne o di conformità esterna. Avere una documentazione di rete aggiornata rende tutto molto più semplice.
La pianificazione della rete e della topologia di rete richiede l'acquisto di software o hardware. Si tratta di costi elevati che devono essere pianificati e preventivati con motivazioni giustificate. Senza un'adeguata documentazione di rete, si finisce per indovinare se sono necessarie nuove risorse o se sono già presenti e in gran parte inutilizzate. Questa situazione è in netto contrasto con la disponibilità di un software avanzato di monitoraggio della rete, in grado di informarti sui colli di bottiglia e sul raggiungimento della capacità in qualsiasi area della rete. Sapere di cosa disponi e dove ha raggiunto i suoi limiti rende la pianificazione degli aggiornamenti un gioco da ragazzi.
I principali vantaggi della documentazione di rete
È ormai chiaro che la documentazione di rete, e quindi l'implementazione di uno strumento di documentazione di rete, è importante per fare chiarezza e snellire i processi, sia interni che esterni.
La documentazione di rete è vantaggiosa in molti modi. Quando si risolvono i problemi, avere una storia del software e dell'hardware, nonché delle interconnessioni, è di grande importanza per identificare cosa si è rotto. Anche un semplice modello di documentazione di rete a mano sarebbe sufficiente per questo scopo, anche se piuttosto ingombrante.
La documentazione di rete è utile per mantenere aggiornate le SOP (Procedure Operative Standard). Se la documentazione è standardizzata, attraverso l'automazione o la creazione di un modello chiaro, le SOP possono basarsi più facilmente su di essa. Le SOP possono essere seguite anche in modo indipendente, ma avere una documentazione di rete che può essere costruita su ciò che esiste, in qualsiasi momento, senza alcuna speculazione, sarebbe un sistema più conveniente.
Inoltre, lasciare la conoscenza del funzionamento della rete a una o due persone chiave può diventare rapidamente un incubo se non sono disponibili quando ne hai bisogno. Uno strumento di documentazione di rete può sostituirli e permettere a chiunque abbia le normali conoscenze informatiche di intervenire.
Inoltre, la pianificazione della capacità non è più un gioco di ipotesi quando la topologia della rete è aggiornata grazie al software di documentazione di rete. Pianificare con componenti e servizi che non sono più presenti o non sono registrati come in servizio significa creare una disconnessione tra la pianificazione e l'infrastruttura attuale. Questo porta a problemi di ogni tipo e a sprechi di denaro.
In definitiva, avere un'immagine il più possibile completa di ciò che è in funzione in un'infrastruttura è fondamentale per monitorarla correttamente, per creare procedure su di essa e per evitare sprechi di risorse. La documentazione di rete può non essere il processo più affascinante dell'IT, ma è comunque essenziale per un uso corretto delle risorse, comprese quelle umane.
Cosa si deve documentare?
Le procedure di documentazione variano da azienda ad azienda. In linea di massima, ogni buon processo di documentazione di rete prevede alcune fasi fondamentali.
Politica di documentazione di rete
In primo luogo, è necessario che sia in vigore e regolarmente aggiornata una politica su cosa documentare. La politica può essere basata su uno dei numerosi modelli di documentazione di rete esistenti o creata ex novo. È importante che venga seguita e che sia completa.
Pertanto - e qui il software di documentazione di rete automatizzato può essere d'aiuto - disporre di una mappa topologica della rete è il primo passo per costruire un sistema di documentazione di rete. Se la topologia è visiva, come in Checkmk, tanto meglio. Ma anche un semplice elenco può essere un valido punto di partenza per creare la prima documentazione di rete.
Hardware e software da documentare
I dati specifici da documentare variano. Un minimo indispensabile è costituito da tutto l'hardware in funzione, con le relative versioni, le configurazioni, il modo in cui ogni dispositivo è collegato alla rete, se un particolare dispositivo richiede una password, se esiste un backup e la versione del firmware. Se esistono diagrammi della rete, devono essere inclusi anche quelli.
Una volta che l'hardware è stato coperto, il software è il prossimo. Un processo di documentazione di rete completo dovrebbe raccogliere tutte le versioni di software/servizi, su cosa sono in esecuzione e dove, le loro configurazioni e se sono presenti backup e dove.
Se si utilizzano servizi cloud o virtuali, anche questi devono far parte della documentazione finale. Questi devono essere automatizzati attraverso uno strumento di documentazione dell'inventario di rete a causa della loro volatilità.
Poi, va documentato anche il modo in cui tutto è interconnesso. A partire dal piano dei cavi e dal funzionamento dei servizi cloud, fino alla disposizione dei rack dei server e ai diagrammi Wi-Fi. Non vanno dimenticate nemmeno le tabelle di allocazione IP e la configurazione di Active Directory, e lo stesso vale per il DNS e le tabelle di routing.
Idealmente, la documentazione di rete dovrebbe comprendere tutto ciò che consente di ricostruire l'infrastruttura da zero, senza alcuna conoscenza precedente.
Infine, è importante documentare come viene creata la documentazione di rete. Se si utilizza un software per la documentazione di rete, può trattarsi semplicemente di brevi passi su come installarlo e configurarlo. Se si sceglie un approccio più manuale, questo compito può trasformarsi in una serie di pagine wiki o simili, che documentano come raccogliere tutti i dati di cui sopra.
Documentazione di rete per un migliore monitoraggio della rete
La documentazione di rete offre molti vantaggi, come abbiamo visto. Spesso, però, non verrebbe implementata se non fosse automatizzata. Gli strumenti di documentazione di rete aiutano le aziende a impostare la documentazione in modo corretto e semplice. Semplificare la raccolta delle informazioni su host e servizi e presentare la rete come un'interfaccia di facile lettura sono caratteristiche molto apprezzate per la documentazione di rete.
Queste caratteristiche sono naturalmente integrate in un software di documentazione di rete come Checkmk. Grazie all'Auto-Discovery, gli host e i servizi vengono rapidamente aggiunti al monitoraggio e quindi inseriti nella documentazione di rete interna. Grazie alla disponibilità di reportistica, ciò che viene mostrato in Checkmk può essere esportato come documentazione adeguata, rendendo semplice la traduzione delle capacità di monitoraggio di Checkmk in documentazione di rete.
Anche la topologia di rete fa parte di Checkmk ed è un ottimo strumento per mostrare visivamente la documentazione di rete. E non si limita a mostrarla; la topologia può essere interagita, ampliata a piacimento e personalizzata e perfezionata secondo i propri gusti. Prende le funzioni di uno strumento di documentazione dell'inventario di rete e le abbina a funzionalità complete di monitoraggio della rete. Queste caratteristiche rendono la documentazione di rete abbastanza semplice e Checkmk è un ottimo strumento per implementarla.
FAQ
La politica di documentazione di rete si riferisce ai requisiti interni per la documentazione di rete. È un documento che stabilisce cosa deve essere incluso, come deve essere documentato e come mantenere aggiornata la documentazione di rete. Questa politica è particolarmente necessaria quando si compila manualmente la documentazione di rete, ma è importante anche quando si impostano metodi automatizzati. Esistono modelli di documentazione dell'infrastruttura di rete per un inizio più rapido.
La documentazione di rete è scritta in molti modi diversi. Può essere un singolo documento o una serie di documenti collegati tra loro, come in un wiki. Gli esempi di documentazione di rete sono utili per iniziare rapidamente e poi si possono adattare alle proprie esigenze. Gli strumenti di documentazione dell'inventario di rete possono creare un inventario iniziale di host e servizi da esportare come documento e su cui lavorare.