Usare il rendering di report e immagini
In questa guida si apprenderà come creare report dai dashboard in Grafana gestito di Azure. È possibile configurare l'invio di questi report tramite posta elettronica ai destinatari desiderati in base a una pianificazione regolare o su richiesta.
La generazione di report in formato PDF richiede la funzionalità di rendering delle immagini di Grafana, che acquisisce i pannelli del dashboard come immagini PNG. Grafana gestito di Azure installa automaticamente il renderer di immagini per l'istanza.
Prestazioni di rendering delle immagini
Il rendering delle immagini è un'operazione a elevato utilizzo di CPU. Per eseguire il rendering di un pannello, un'istanza di Grafana gestita di Azure richiede circa 10 secondi, presupponendo che la query di dati venga completata in meno di 1 secondo. Il software Grafana consente un massimo di 200 secondi per generare un intero report. I dashboard non devono contenere più di 20 pannelli se vengono usati nei report PDF. Potrebbe essere necessario ridurre ulteriormente il numero del pannello se si prevede di includere altri artefatti (ad esempio CSV) nei report.
Nota
Se una richiesta di rendering ha superato il limite di 200 secondi, verrà visualizzato un errore "Image Rendering Timeout".
Per l'acquisizione dello schermo negli avvisi, il software Grafana consente solo 30 secondi alle immagini del pannello snapshot prima del timeout. Al massimo tre screenshot possono essere acquisiti entro questo intervallo di tempo. Se si verifica un aumento improvviso del volume di avvisi, alcuni avvisi potrebbero non avere screenshot anche se l'acquisizione dello schermo è stata abilitata.
Nota
L'overload del renderer di immagini Grafana può causare un'instabilità. È possibile ridurre il numero di avvisi che devono includere screenshot impostando solo le annotazioni UID dashboard e ID pannello in tali regole di avviso.
Prerequisiti
Per seguire i passaggi descritti in questa guida, è necessario disporre di:
- Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
- Un'istanza di Grafana gestita di Azure nel piano Standard. Creare una nuova istanza, se non ne è disponibile una.
- Un server SMTP. Se non ne è ancora disponibile uno, è consigliabile usare l'API di posta elettronica di Twilio SendGrid per Azure.
- Configurazione della posta elettronica per l'istanza di Grafana gestita di Azure. Configurare le impostazioni SMTP.
Configurare la creazione di report
Per creare un nuovo report, seguire questa procedura.
- Nella portale di Azure aprire l'area di lavoro Grafana gestita di Azure e selezionare l'URL dell'endpoint.
- Nel portale di Grafana passare a Report report > e selezionare + Crea un nuovo report.
- Completare i passaggi rimanenti nell'interfaccia utente di Grafana.
Esportare il dashboard in FORMATO PDF
Nota
L'interfaccia utente di Grafana può cambiare periodicamente. Questo articolo illustra l'interfaccia Grafana e il flusso utente in un determinato punto. L'esperienza può essere leggermente diversa dagli esempi al momento della lettura di questo documento. In questo caso, fare riferimento alla documentazione di Grafana Labs.
Per creare un nuovo report, seguire questa procedura.
- Nella portale di Azure aprire l'area di lavoro Grafana gestita di Azure e selezionare l'URL dell'endpoint.
- Nel portale di Grafana passare al dashboard da esportare.
- Fare clic sull'icona Condividi dashboard .
- Scegliere un'opzione di layout nella scheda PDF.
- Selezionare Salva come PDF da esportare.
Usare l'immagine negli avvisi
Grafana consente l'acquisizione dello schermo di un pannello che attiva un avviso. I destinatari possono visualizzare l'immagine del pannello direttamente nel messaggio di notifica. Grafana gestito di Azure è attualmente configurato per caricare questi screenshot nella risorsa di archiviazione locale nell'istanza. Solo l'elenco dei punti di contatto nella colonna Carica da disco della tabella Punti di contatto supportati può ricevere le immagini. Inoltre, esiste un limite di tempo di 30 secondi per l'acquisizione di uno screenshot. Se non è possibile completare uno screenshot in tempo, non viene incluso nell'avviso corrispondente. Gli screenshot vengono acquisiti solo per gli avvisi con annotazioni UID dashboard e ID pannello nella regola. È possibile usare queste annotazioni per disabilitare l'acquisizione dello schermo in modo selettivo.
Passaggi successivi
In questa guida pratica si è appreso come usare il rendering di report e immagini. Per informazioni su come creare e configurare dashboard di Grafana, vedere Creare dashboard.