Oracle Cloud Infrastructure - Dokumentation

Grafana-Plug-in

Dieses Thema enthält Anweisungen für die Installation, Konfiguration und Verwendung der Oracle Cloud Infrastructure-Datenquelle für Grafana.

Dieses Thema enthält Anweisungen zur Installation, Konfiguration und Verwendung der Oracle Cloud Infrastructure-Datenquelle für Grafana, die auch als Grafana-Plug-in bezeichnet wird.

Grafana-Plug-in - Überblick

Grafana ist ein Open-Source-Visualisierungs- und Warntool, das Sie für Analysen und Monitoring von Zeitreihendaten (Metriken) verwenden können. Während Metriken aus Oracle Cloud Infrastructure Monitoring in Metrikdiagrammen über die Konsole angezeigt werden, können Sie Oracle Cloud Infrastructure-Datenquelle für Grafana ("Grafana-Plug-in") verwenden, um Metriken aus Ressourcen über alle Provider in einem einzigen Grafana-Dashboard anzuzeigen.

Voraussetzungen für die Verwendung des Grafana-Plug-ins

  • Ein Oracle Cloud Infrastructure-Account.
  • Ein Benutzer in diesem Account in einer Sicherheitsgruppe mit einer IAM-Policy, die erforderliche Berechtigungen zur Arbeit mit Ressourcen in den Account-Compartments erteilt. Die Policy muss Ihnen Zugriff auf die Metrik-Namespace gewähren, in denen Metriken ausgegeben werden (z.B. Compute) sowie die zugehörigen Ressourcen (z.B. eine Gruppe von Compute -Instanzen). Wenn Sie versuchen, eine Aktion auszuführen, und eine Meldung erhalten, dass Sie keine Berechtigung haben oder nicht autorisiert sind, fragen Sie den Administrator, der Zugriffstyp Ihnen erteilt wurde und in welchem Compartment Sie arbeiten sollen. Für Administratoren: Informationen zu allgemeinen Policys, mit denen Gruppen Zugriff auf Metriken erteilt werden kann, finden Sie unter Metrikzugriff für Gruppen. Um Ressourcen wie Instanzen zum Durchführen von API-Aufrufen zu autorisieren, fügen Sie die Ressourcen über ihre Abgleichsregeln zu einer dynamischen Gruppe hinzu, und erstellen Sie dann eine Policy, die den dynamischen Gruppenzugriff auf Metriken ermöglicht. Um Zugriff über Compartments hinweg zu ermöglichen, erstellen Sie die Policy im Mandanten. Aufgrund des Konzepts der Policy-Vererbung können Instanzen in der angegebenen dynamischen Gruppe dann auf Metriken in jedem Compartment zugreifen. Um den Zugriff auf ein bestimmtes Compartment zu beschränken, geben Sie dieses Compartment anstelle des Mandanten an. Siehe Metrikzugriff für Ressourcen.
  • Compute-Instanzen: Um Metriken auszugeben, muss das Plug-In für das Compute-Instanzmonitoring auf der Instanz aktiviert sein, und Plug-ins müssen ausgeführt werden. Die Instanz muss außerdem über ein Servicegateway oder eine öffentliche IP-Adresse verfügen, um Metriken an den Monitoring-Service zu senden. Weitere Informationen finden Sie unter Monitoring für Compute-Instanzen aktivieren.
  • Erforderliche Schlüssel und Oracle Cloud Infrastructure-IDs (OCIDs). Weitere Informationen finden Sie unter Erforderliche Schlüssel und OCIDs.

Grafana-Plug-in herunterladen und installieren

Hinweis

Grafana muss installiert sein, bevor Sie das Grafana-Plug-in installieren können. Version 3.0 oder höher ist erforderlich.

Die Authentifizierung für den Metrikzugriff hängt davon ab, wo Grafana ausgeführt wird. Wenn Sie Grafana auf einem lokalen Rechner außerhalb von Oracle Cloud Infrastructure ausführen, müssen Sie die Monitoring-API mit der Befehlszeilenschnittstelle (CLI) aufrufen. Wenn Sie Grafana auf einer von Ihnen erstellten Oracle Cloud Infrastructure-Compute-Instanz ausführen, können Sie die Instanz einer dynamischen Gruppe hinzufügen, indem sie eine Abgleichsregel konfigurieren. In allen Szenarien haben Sie die Möglichkeit, die API mit der CLI aufzurufen.

Anweisungen zur Installation des Grafana-Plug-ins (Oracle Cloud Infrastructure-Datenquelle für Grafana) finden Sie unter https://github.com/oracle/oci-grafana-plugin.

Grafana-Plug-in konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie das Grafana-Plug-in hinzufügen und ein Dashboard einrichten.

So konfigurieren Sie das Grafana-Plug-in
Hinweis

Wenn es lokal installiert ist, greift das Grafana-Plug-in auf Metriken zu, indem es Aufrufe an die Monitoring-API durchleitet.

  1. Richten Sie die CLI für den Zugriff auf Oracle Cloud Infrastructure-APIs an.

    Sie müssen zur Authentifizierung auf die Monitoring-API zugreifen.

  2. Navigieren Sie zur Grafana-Homepage unter folgender URL.

    http://localhost:3000

  3. Fügen Sie das Grafana-Plug-in (Oracle Cloud Infrastructure-Datenquelle für Grafana) hinzu.

    Zusätzlich zu den unten aufgeführten Schritten finden Sie weitere Informationen zum Hinzufügen von Datenquellen in den Grafana-Anweisungen unter https://grafana.com/docs/grafana/latest/getting-started/getting-started/.

    1. Klicken Sie in Grafana im Home-Dashboard auf das Zahnradsymbol links.
    2. Klicken Sie auf Datenquelle hinzufügen.
    3. Geben Sie im Filtertextfeld Folgendes ein: oracle-oci-datasource
    4. Wählen Sie in der gefilterten Liste oracle-oci-datasource aus.

    5. Geben Sie auf der Einstellungsseite Ihre Mandanten-OCID, die Standardregion und die Umgebung ein. Wählen Sie für Umgebung die Option lokal aus.

  4. Richten Sie ein Dashboard des Typs "Diagramm" ein.

  5. (Optional) Um den Zugriff auf Metriken aus Oracle Cloud Infrastructure zu bestätigen, aktualisieren Sie Ihre Dashboard-Abfrage ("Metriken") mit einer bestimmten Region, einem Compartment, einem Namespace und einer Metrik. Sie können außerdem eine oder mehrere Dimensionen hinzufügen.

    Herzlichen Glückwunsch. Sie können Ihre Oracle Cloud Infrastructure-Metriken jetzt in Grafana anzeigen.

Umgebungsoptionen

lokal gilt für Grafana-Deployments außerhalb von Oracle Cloud Infrastructure.

OCI-Instanz gilt für Grafana-Deployments in Oracle Cloud Infrastructure-Ressourcen.

Die Datenquelle ist jetzt hinzugefügt, sodass Sie ein Dashboard mit Metriken aus Oracle Cloud Infrastructure einrichten.

Fehler im Plug-in beheben

Wenn die Dashboard-Abfrage ("Metriken") nicht mit Optionen aufgefüllt werden oder wenn beim Zugriff auf Metriken andere Probleme auftreten, ist die IAM-Policy, die für den Zugriff auf Metriken verwendet wird, möglicherweise fehlerhaft, oder sie enthält nicht alle erforderlichen Abgleichsregeln für die dynamische Gruppe (zur Ausführung von Grafana auf einer von Ihnen erstellten Oracle Cloud Infrastructure-Compute-Instanz).

So beheben Sie dieses Problem:

  • Prüfen Sie Ihre IAM-Policy, um sicherzustellen, dass sie die Voraussetzungen erfüllt.
  • Wenn Sie Ihre IAM-Policy aktualisiert haben, starten sie den Grafana-Server neu und aktualisieren die Grafana-Homepage.