Plugin Grafana
Questo argomento fornisce istruzioni per l'installazione, la configurazione e l'uso dell'origine dati Oracle Cloud Infrastructure per Grafana.
Questo argomento fornisce istruzioni per l'installazione, la configurazione e l'uso dell'origine dati Oracle Cloud Infrastructure per Grafana, altrimenti indicato come plugin Grafana.
Panoramica del plugin Grafana
Grafana è uno strumento di visualizzazione e avviso open source che puoi utilizzare per l'analisi e il monitoraggio dei dati delle serie temporali (metriche). Sebbene le metriche di Oracle Cloud Infrastructure Monitoring siano visibili nei grafici delle metriche tramite la console, puoi utilizzare l'origine dati di Oracle Cloud Infrastructure per Grafana ("plug-in Grafana") per visualizzare le metriche dalle risorse tra i provider su un singolo dashboard Grafana.
Prerequisiti per l'uso del plugin Grafana
- Un account Oracle Cloud Infrastructure.
- Un utente in tale account, in un gruppo di sicurezza con un criterio IAM che concede le autorizzazioni necessarie per l'utilizzo delle risorse nei compartimenti degli account. Il criterio deve fornire l'accesso agli spazi di nomi delle metriche che emettono metriche (ad esempio, Compute) nonché alle risorse correlate (ad esempio un set di istanze di computazione). Se si tenta di eseguire un'azione e si riceve un messaggio che informa che non si dispone dell'autorizzazione o che non si è autorizzati, confermare con l'amministratore il tipo di accesso concesso e il compartimento in cui si dovrebbe lavorare. Amministratori: per i criteri comuni che consentono ai gruppi di accedere alle metriche, vedere Accesso alle metriche per i gruppi. Per autorizzare le risorse, ad esempio le istanze, a effettuare chiamate API, aggiungere le risorse a un gruppo dinamico tramite le regole di corrispondenza, quindi creare un criterio che consenta a tale gruppo dinamico di accedere alle metriche. Per consentire l'accesso tra compartimenti, creare il criterio nella tenancy. A causa del concetto di ereditarietà dei criteri, le istanze nel gruppo dinamico indicato possono quindi accedere alle metriche in qualsiasi compartimento. Per ridurre l'ambito dell'accesso a un determinato compartimento, specificare tale compartimento anziché la tenancy. Vedere Accesso alle metriche per le risorse.
- Istanze di computazione: per emettere metriche, il plugin Monitoraggio istanza di computazione deve essere abilitato nell'istanza e i plugin devono essere in esecuzione. L'istanza deve inoltre disporre di un gateway di servizio o di un indirizzo IP pubblico per inviare le metriche al servizio di monitoraggio. Per ulteriori informazioni, vedere Abilitazione del monitoraggio per le istanze di computazione.
- Chiavi richieste e ID Oracle Cloud Infrastructure (OCID). Per istruzioni, vedere Chiavi e OCID obbligatori.
Scaricare e installare il plugin Grafana
Grafana deve essere installato prima di poter installare il plugin Grafana. Versione 3.0 o successiva obbligatoria.
L'autenticazione per l'accesso alle metriche dipende dalla posizione in cui è in esecuzione Grafana. Se stai eseguendo Grafana su un computer locale al di fuori di Oracle Cloud Infrastructure, devi chiamare l'API di monitoraggio utilizzando l'interfaccia CLI (Command Line Interface). Se stai eseguendo Grafana su un'istanza di computazione di Oracle Cloud Infrastructure creata, puoi aggiungere l'istanza a un gruppo dinamico configurando una regola di corrispondenza. In tutti gli scenari, è possibile chiamare l'API utilizzando l'interfaccia CLI.
Per istruzioni sull'installazione del plugin Grafana (Oracle Cloud Infrastructure Data Source for Grafana), vedere https://github.com/oracle/oci-grafana-plugin.
Configurare il plugin Grafana
In questa sezione viene descritto come aggiungere il plugin Grafana e impostare un dashboard.
Quando viene installato localmente, il plugin Grafana accede alle metriche utilizzando le chiamate all'API di monitoraggio.
-
Imposta la CLI per accedere alle API di Oracle Cloud Infrastructure.
Dovrai accedere all'API di monitoraggio per l'autenticazione.
-
Andare alla home page di Grafana all'URL seguente.
-
Aggiungi il plugin Grafana (origine dati Oracle Cloud Infrastructure per Grafana).
Oltre ai passi riportati di seguito, fare riferimento alle istruzioni Grafana per l'aggiunta di origini dati all'indirizzo https://grafana.com/docs/grafana/latest/getting-started/getting-started/.
- In Grafana, nella Home Dashboard, fare clic sull'icona a forma di ingranaggio a sinistra.
- Fare clic su Aggiungi origine dati
- Nella casella di testo Filtro digitare: oracle-oci-datasource
- Nell'elenco filtrato selezionare oracle-oci-datasource.
-
Nella pagina Impostazioni, immettere l'OCID tenancy, l'area predefinita e l'ambiente. Per Ambiente scegliere locale.
- Impostare un dashboard di tipo "Grafico".
-
(Facoltativo) Per confermare l'accesso alle metriche da Oracle Cloud Infrastructure, aggiornare la vostra query sul dashboard ("Metriche") con un'area, un compartimento, uno spazio di nomi, una metrica specifici. È inoltre possibile aggiungere una o più dimensioni.
Congratulazioni. Ora puoi visualizzare le metriche di Oracle Cloud Infrastructure in Grafana.
locale è per le implementazioni Grafana al di fuori di Oracle Cloud Infrastructure.
L'istanza OCI è per le distribuzioni Grafana sulle risorse Oracle Cloud Infrastructure.
L'origine dati viene ora aggiunta, consentendo di impostare un dashboard che mostra le metriche di Oracle Cloud Infrastructure.
Risolvere i problemi del plugin
Se la query del dashboard ("Metriche") non riesce a popolare le opzioni o se si riscontrano altri problemi di accesso alle metriche, il criterio IAM utilizzato per accedere alle metriche potrebbe non essere corretto o potrebbe non includere tutte le regole di corrispondenza necessarie per il gruppo dinamico (per l'esecuzione di Grafana su un'istanza di computazione Oracle Cloud Infrastructure creata).
Per risolvere il problema, procedere come segue.
- Rivedere il criterio IAM per assicurarsi che corrisponda ai prerequisiti.
- Se è stato aggiornato il criterio IAM, riavviare il server Grafana e aggiornare la home page Grafana.