Report

Esistono diverse opzioni per dare ai report un contesto, cioè per riempirli con i dati di host e servizi specifici. Di conseguenza, i report devono essere chiamati in modi diversi per contenere informazioni significative. Se manca il contesto, cioè l'indicazione di quali host e servizi devono essere inclusi nel report, invece dell'output corretto riceverai solo messaggi di errore evidenziati in rosso:

La differenza sta nel luogo in cui viene specificato il contesto:

Ora ripensa allo snap-in Reporting menzionato in precedenza: questo ti porta direttamente ai report renderizzati senza ulteriori preselezioni/restrizioni ecc... quindi solo i report che hanno un contesto integrato hanno effettivamente senso in questo caso. I report il cui contesto viene creato solo tramite le visualizzazioni (filtrate) possono quindi essere tranquillamente esclusi dal menu Monitor e dallo snap-in tramite l'opzione Hide this report in the monitor menu.

Per modificare i tuoi report puoi utilizzare le seguenti funzioni:

Nelle sezioni successive troverai una descrizione delle varie opzioni disponibili.

Le cose si fanno un po' più complesse se vuoi creare un report completamente nuovo invece di una copia di un report esistente. A titolo di esempio, qui di seguito creerai una semplice panoramica di tutti i servizi problematici del tuo sito, cioè tutti i servizi con uno stato WARN, CRIT o SCONOSCIUTO. Questa panoramica sarà intitolata "servizi critici".

Crea un nuovo report nella pagina Edit Reports tramite Reports > Add report.

Nel primo passo, lascia il filtro Select specific object type sulla selezione No restrictions to specific objects e passa direttamente alla pagina di selezione successiva con Continue.

Come per la copia di un report esistente, specifica prima un Unique ID e un Title:

Nella sezione Context / Search Filters, alla voce Service seleziona ora Service states, poi con un clic su Add filter puoi impostare gli stati desiderati:

Con Save & go to list il nuovo report verrà aggiunto alla sezione Customized dell'elenco panoramico dei report.

Se ora richiami questo report con gioia, il risultato è sconfortante: la pagina del report ha un layout iniziale e anche un titolo, ma per il resto è vuota. Non è esattamente il risultato con cui impressionare il tuo capo...

Ora devi definire il design del contenuto del report. Il pulsante ti porterà alla pagina per la definizione del contenuto da includere nel report. La selezione degli elementi del report avviene in tre fasi, ognuna delle quali prevede un click su Continue.

Inizia cliccando su Add content. Per questo esempio, in Step 1 seleziona il tipo di elemento Availability table. Imposta Step 2 su All services e Step 3 su No restrictions to specific objects. Lascia per il momento invariate le altre opzioni della pagina seguente e clicca direttamente su Save. Ora visualizza l'anteprima del tuo report:

A sinistra puoi vedere l'anteprima, in questo caso del report di critical_services. A destra, gli elementi del report sono visualizzati in un elenco. Questi elementi possono essere modificati, copiati, cancellati e riordinati.

Ora puoi personalizzare in modo flessibile questo semplice report creato da te con elementi aggiuntivi a seconda delle necessità (vedi sotto) e richiamarlo in qualsiasi momento, ad es. dalla barra laterale.

In quasi tutte le fasi di creazione del report c'è la possibilità di regolare il contenuto in base alle tue esigenze.

Nella prima fase, all'inizio, puoi impostare un filtro e limitare il report a un host o a una fonte di dati specifici, come interfacce di rete, aggregazioni BI, sensori e così via:

Quindi, inserisci nuovamente i campi Unique ID e Title. Per il titolo puoi anche utilizzare le macro (= moduli di testo) fornite. Poi, scegli un Icon con cui il report deve essere visibile nei menu. Impostando l'opzione Make this report available for other users sul gruppo di contatto, nell'esempio check-mk-notify, darai ai membri del gruppo associato la possibilità di accedere autonomamente al report in qualsiasi momento e di ottenere informazioni per conto proprio.

Nel box Context / Search Filters, come al solito, sono disponibili ampie opzioni di filtraggio, da host specifici a singoli Docker container fino ai valori del monitoraggio Oracle.

In questo esempio, la selezione dell'host è limitata a una cartella e, in aggiunta, a numeri di host specificati. Questa restrizione velocizza il recupero dei dati, soprattutto negli ambienti più complessi.

Con Save & go to list si accede alla panoramica del report. Il passo successivo consiste nel definire il contenuto del report.

Utilizzando il sito puoi accedere al contenuto del report:

Apri la modifica del contenuto del report con Reports > Add content. Utilizza questa funzione per aggiungere al report, ad esempio, tabelle, grafici, sommari o testo (anche tramite macro o HTTP). Questi contenuti appaiono uno dopo l'altro e quindi determinano anche la lunghezza finale del report.

In Step 1, seleziona l'elemento che desideri, ad esempio Multiple graphs. In questo modo otterrai, a seconda delle altre impostazioni, più grafici dello stesso tipo disposti uno sotto l'altro. Ad esempio, puoi mappare un confronto diretto tra gli stati di più host.

Continua con Continue. Come fonte di dati per i grafici, per questo esempio, nel passaggio 2 seleziona All services, cioè tutti i servizi in esecuzione sugli host:

Continua con Continue. Nel passaggio 3 potresti limitare il volume dei dati da visualizzare. Questa opzione non è necessaria per l'esempio attuale. Anche in questo caso, passa alla selezione successiva con Continue.

Per il report di esempio, alla voce Graph layout, nel box Properties, specifica che vuoi fornire un titolo per ogni grafico, composto dal titolo del grafico, dal nome host e dalla descrizione del servizio. Inoltre, alla voce Graph time range, imposta il periodo di tempo visualizzato a quattro ore.

Nel box Context / Search Filters puoi limitare il report alle caratteristiche dell'host o del servizio specificati. In questo esempio, seleziona CPU utilization per Service.

Facendo clic su Save hai completato il primo elemento del report.

Per il secondo grafico di questo esercizio, ricomincia con Reports > Add content e in Step 1 seleziona Metrics graph of a single service. Passa a Step 2 con Continue e limita i filtri di ricerca al nome host e alla descrizione del servizio:

Facendo clic su Save, anche il secondo elemento del report sarà pronto.

Il terzo elemento da creare è una panoramica degli avvisi correnti. La procedura rimane la stessa:

Con un clic su Save anche questo elemento del report è terminato.

Per rendere la visualizzazione più chiara, aggiungi dei titoli:

Apri Reports > Add content per modificare il contenuto del report. In Step 1 seleziona Heading come tipo di elemento. Passa a Step 2 con Continue. Opzionalmente, specifica un livello gerarchico per l'intestazione. Inserisci l'intestazione in The text.

Clicca su Save per tornare alla panoramica. Tuttavia, la nuova intestazione sarà posizionata al di sotto dei grafici nell'elenco. Quindi, nell'elenco degli elementi del contenuto, usa il simbolo per trascinare l'intestazione nella posizione desiderata nell'elenco.

Suggerimento: nell'anteprima potresti vedere delle linee rosse e dei messaggi di errore al posto dei dati reali, perché in questi punti il report nell'editor manca di un contesto, ad esempio la specifica di un host che verrebbe rivelata solo richiamando il report da una visualizzazione appropriata. Se vuoi vedere un'anteprima utilizzabile, filtra semplicemente per un host specifico nelle impostazioni del report nell'area Context / Search Filters. Questo rende la progettazione del report molto più semplice.

Sono disponibili elementi di design complementari per strutturare l'aspetto del report, come linee orizzontali, immagini, cornici di pagina e una singola riga di testo. Puoi visualizzare questi elementi su tutte le pagine del report o su pagine specifiche.

Per il report di esempio, inserisci una cornice intorno al report. Anche in questo caso, la definizione avviene per gradi, ognuno dei quali continua facendo clic su . Inizia con Reports > Add page element.

Poiché la cornice deve essere visibile in tutte le pagine, il passaggio successivo non richiede modifiche:

La nuova cornice della pagina viene ora visualizzata nella panoramica, sia nell'anteprima a sinistra che nella tabella degli elementi statici della pagina a destra.

Suggerimento: puoi anche utilizzare le macro (=moduli di testo) disponibili in Checkmk, ad esempio per creare un altro piè di pagina con i numeri di pagina e il nome del report. Per farlo, seleziona l'elemento di pagina One line of text e nel secondo passaggio specifica la posizione in fondo alla pagina e il testo che include le macro desiderate:

I report appaiono subito più attraenti con un aspetto di qualità superiore, ad esempio con l'aggiunta del logo aziendale.

Apri le impostazioni del report con Reports > Edit properties:

Nel secondo box, troverai la voce Report Properties. Qui è possibile configurare i valori per il font, il formato della pagina, le impostazioni di data e ora, il layout del report e il nome del file per il download.

Copia il logo della tua azienda nella directory ~/local/share/check_mk/reporting/images/ e salvalo come file logo_mk.png. D'ora in poi questo logo verrà visualizzato su tutti i report.

Nota: attualmente è possibile personalizzare il modello di report esistente in base alle proprie esigenze. In alternativa, puoi creare un nuovo modello di report completo in base alle specifiche della tua azienda, ad esempio per riflettere il design aziendale (CI/CD).

Apri un nuovo scheduler utilizzando Scheduled reports > Add schedule, quindi seleziona il report e clicca su Continue.

Nel box General Options puoi specificare le impostazioni di base come il titolo, l'ora di creazione, il periodo di tempo per il reporting e così via:

Alla voce Context / Search Filters troverai le solite opzioni di filtro, a seconda del report selezionato. Salva quindi lo scheduler per tornare all'elenco dei tuoi report schedulati.

Nell'elenco troverai anche informazioni sull'ultima volta che il report è stato generato/inviato, se c'è stato un errore, quando verrà generato/inviato la volta successiva e altre informazioni (qui leggermente abbreviate):

Le voci dell'elenco vengono gestite utilizzando i cinque simboli all'inizio di una voce:

Nota: i report inviati non vengono memorizzati sul sito.

Invece di inviare il report, puoi anche archiviarlo localmente. Per farlo, seleziona Action - Store locally:

Per poter creare una cronologia dei report, Checkmk mette a disposizione diverse macro (= moduli di testo) invece di sovrascrivere la versione precedente del report ogni volta che questo viene creato.

La panoramica di tutti i report archiviati localmente è accessibile nella finestra Edit Reports tramite la voce di menu Reports > Stored reports:

Gli elementi del contenuto sono elencati quando selezioni Reports > Add content durante la modifica di un report.

Gli elementi della pagina sono elencati quando selezioni Reports > Add page element durante la modifica di un report.