Report

Ci sono diverse opzioni per dare un contesto ai rapporti, cioè per riempirli con i dati provenienti da host e servizi specifici. Di conseguenza, i rapporti devono essere richiamati in modi diversi per contenere informazioni significative. Se manca il contesto, cioè la specificazione di quali host e servizi devono essere inclusi nel rapporto, 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 sopra: questo ti porta direttamente ai rapporti visualizzati senza ulteriori preselezioni / restrizioni ecc. — quindi solo quei rapporti che hanno un contesto integrato hanno effettivamente senso in questo caso. I rapporti il cui contesto viene creato solo tramite visualizzazioni (filtrate) possono quindi essere tranquillamente esclusi dal menu "Monitor" e dallo snap-in tramite l'opzione "Hide this report in the monitor menu".

Puoi utilizzare le seguenti funzioni per modificare i tuoi rapporti:

Nelle sezioni seguenti trovi una descrizione delle varie opzioni disponibili.

Le cose si complicano un po' se vuoi creare un rapporto completamente nuovo invece di una copia di uno esistente. Ad esempio, qui sotto creerai una semplice panoramica di tutti i servizi problematici sul tuo sito, ovvero tutti i servizi con stato WARN, CRIT o SCONOSCIUTO. Questa panoramica si chiamerà "critical_services".

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

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

Come quando si copia un rapporto esistente, specifica prima un "Unique ID" e un "Title":

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

Con "" e "Save & go to list", il nuovo rapporto verrà aggiunto alla sezione "Customized" dell'elenco panoramico dei rapporti.

Se ora apri questo rapporto con grande entusiasmo, il risultato è deludente. La pagina del rapporto ha un layout iniziale e anche un'intestazione, ma per il resto è vuota. Non è proprio il risultato con cui impressionare il tuo capo…​

Quindi ora devi definire il design del contenuto del rapporto. L'e ti porterà alla pagina per definire il contenuto da includere nel rapporto. La selezione degli elementi del rapporto avviene in tre fasi, ciascuna con un clic su Continue in mezzo.

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 nella pagina seguente. Clicca invece direttamente su Save. Ora effettua la visualizzazione del tuo rapporto:

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

Ora puoi personalizzare in modo flessibile questo semplice rapporto creato da te con elementi aggiuntivi secondo necessità (vedi sotto) e richiamarlo in qualsiasi momento, ad esempio dalla barra laterale.

In quasi ogni fase della creazione del rapporto c'è la possibilità di adattare il contenuto alle tue esigenze.

Nel primo passo, all'inizio, puoi impostare un filtro e limitare il rapporto a un host o a una sorgente dati specifica, come interfacce di rete, aggregazioni BI, sensori e così via:

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

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

Per questo esempio, la selezione degli host è limitata a una cartella e, inoltre, a problemi specifici degli host. Questa restrizione accelera il recupero dei dati, specialmente in ambienti più complessi.

Con "Save & go to list" si accede alla panoramica del rapporto. Il passo successivo è definire il contenuto del rapporto.

Utilizzando l' si accede al contenuto del rapporto:

Apri la modifica del contenuto del rapporto con Reports > Add content. Utilizzalo per aggiungere al rapporto, ad esempio, tabelle, grafici, indici o testo (anche tramite macro o HTTP). Questi contenuti appaiono uno dopo l’altro e determinano quindi anche la lunghezza finale del rapporto.

In Step 1, seleziona l'elemento che desideri, per questo esempio Multiple graphs. Questo ti fornirà, a seconda delle altre impostazioni, più grafici dello stesso tipo disposti uno sotto l'altro. Ad esempio, puoi effettuare una mappatura diretta dei stati degli host.

Continua con Continue. Come sorgente dati per i grafici, in questo esempio, al punto 2 seleziona All services, ovvero tutti i servizi in esecuzione sugli host:

Continua con Continue. Nel passaggio 3 ora potresti limitare il volume dei dati da visualizzare. Questa opzione non è necessaria per l'esempio attuale. Switch nuovamente alla selezione successiva con Continue.

Per il rapporto di esempio, in Graph layout, nella box Properties, specifica che vuoi fornire un titolo per ciascuno dei grafici, composto dal titolo del grafico, dal nome host e dalla descrizione del servizio. Inoltre, imposta il periodo di tempo visualizzato su quattro ore in Graph time range.

Nella box "Context / Search Filters" (Criteri di filtro), puoi limitare il rapporto a determinate caratteristiche dell'host o del servizio. Qui selezioni "CPU utilization" (Criteri di filtro) per "Service" (Intervallo di tempo) in questo esempio.

Cliccando su Save hai completato il primo elemento del rapporto.

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

Cliccando su Save, anche il secondo elemento del rapporto sarà pronto.

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

Con un clic su Save anche questo elemento del rapporto è pronto.

Per rendere la visualizzazione più chiara, aggiungi delle intestazioni:

Apri "Reports > Add content" per modificare il contenuto del rapporto. In "Step 1" seleziona "Heading" come tipo di elemento. Switcha a "Step 2" con "" Continue. Se vuoi, 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à ora posizionata sotto i grafici nell'elenco. Quindi, nell'elenco degli elementi di contenuto, usa il simbolo per trascinare l'intestazione nella posizione desiderata nell'elenco.

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

Sono disponibili elementi di progettazione complementari per strutturare l'aspetto del rapporto, come linee orizzontali, immagini, cornici di pagina e singole righe di testo. Puoi visualizzare questi elementi su tutte le pagine o su pagine specifiche del tuo rapporto.

Per il rapporto di esempio, inserisci una cornice attorno al rapporto. Anche in questo caso, la definizione avviene passo dopo passo, proseguendo ogni volta cliccando su "". Inizia con "Reports > Add page element".

Poiché la cornice deve essere visibile su tutte le pagine, il passaggio successivo non richiede alcuna modifica:

Il nuovo riquadro della pagina viene ora visualizzato 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 rapporto. Per farlo, seleziona l'elemento di pagina One line of text e nel secondo passaggio specifica la posizione in fondo alla pagina, nonché il testo che include le macro desiderate:

I rapporti risultano immediatamente più accattivanti con un aspetto di qualità superiore, ad esempio con l'aggiunta del logo aziendale.

Apri le impostazioni del rapporto con Reports > Edit properties:

Nella seconda box troverai l'Report Properties. Qui puoi configurare i valori relativi al carattere, al formato della pagina, alle impostazioni di ora e data, al layout del rapporto e al nome del file per gli scaricamenti.

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 rapporti.

Nota: attualmente, puoi personalizzare il modello di rapporto esistente in base alle tue esigenze. In alternativa, puoi creare un modello di rapporto completamente nuovo secondo le specifiche della tua azienda, ad esempio per riflettere il design aziendale (CI/CD).

Apri una nuova pianificazione utilizzando Scheduled reports > Add schedule, quindi seleziona il rapporto e clicca su Continue.

Nella box General Options, specifica le impostazioni di base come titolo, ora di creazione, periodo di riferimento e così via:

Sotto "Context / Search Filters" troverai le solite opzioni di filtro, a seconda del rapporto selezionato. Salva quindi la pianificazione per tornare all'elenco dei tuoi rapporti pianificati.

Nell'elenco troverai anche informazioni sull'ultima volta che il rapporto è stato generato/inviato, se si è verificato un errore, quando verrà generato/inviato la prossima volta e alcune altre informazioni (qui mostrate in forma leggermente abbreviata):

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

Nota: i rapporti che sono stati inviati non vengono salvati sul sito.

Invece di inviare il rapporto, puoi anche salvarlo localmente. Per farlo, seleziona "Action - Store locally":

Quindi specifica un nome file e, se vuoi, un titolo per il rapporto. Per poter creare una cronologia dei rapporti, Checkmk mette a disposizione diverse macro (= moduli di testo) invece di sovrascrivere la versione precedente del rapporto ogni volta che ne viene creato uno nuovo.

Puoi accedere alla panoramica di tutti i rapporti salvati localmente nella finestra "Edit Reports" tramite la voce di menu "Reports > Stored reports":

Gli elementi di contenuto vengono elencati quando selezioni "Reports > Add content" durante l'edizione di un rapporto.

Gli elementi della pagina vengono elencati quando selezioni "Reports > Add page element" durante la modifica di un rapporto.