Oracle Cloud Infrastructure-Dokumentation

Management-Agents zur Erfassung von Prometheus-Metriken einrichten

Der Oracle Cloud Infrastructure Management Agents-Service (Management Agents) unterstützt das Erfassen von Performancemetrikdaten für Zeitreihen aus jeder Ressource, die Metrikdaten im Prometheus-Format bereitstellt. Weitere Informationen zu Prometheus finden Sie in der offiziellen Prometheus-Dokumentation unter Erste Schritte.

Prometheus und Management Agents

In den folgenden Schritten wird beschrieben, wie Prometheus-Metriken mit Management-Agents erfasst werden:

  • Schritt 1. Management Agent installieren mit Zugriff auf den Endpunkt der Prometheus-Metriken.
  • Schritt 2. Prometheus-Metriken aktivieren
  • Schritt 3. Prometheus-Datenquelle konfigurieren
  • Schritt 4. Prometheus-Dashboard erstellen

    Schritt 1: Management-Agent installieren

    Zunächst müssen Sie einen Management Agent installieren, um Agents bei Oracle Cloud Infrastructure (OCI) zu registrieren.
    Je nach Umgebung können Sie eine der folgenden Installationsmöglichkeiten für Management Agent auswählen:
    • Installieren Sie einen Management Agent auf einer OCI-Instanz.

      Wenn Sie über eine OCI-Compute-Instanz verfügen, müssen Sie die Anweisungen befolgen, um den Management Agent auf OCI-Compute-Instanzen zu aktivieren. Informationen zu den Voraussetzungen und zum Installationsprozess finden Sie unter Management-Agents auf Compute-Instanzen bereitstellen.

    • Management Agent in einer Nicht-OCI-Instanz installieren.

      Wenn Sie über eine Standalone-VM verfügen, müssen Sie die Anweisungen befolgen, um einen Management Agent auf einer VM zu installieren. Sie müssen Management Agent auf derselben VM oder auf einer VM mit Zugriff auf den Prometheus-Endpunkt installieren. Informationen zu den Voraussetzungen und dem Installationsprozess finden Sie unter Management-Agents installieren.

      Erstellen Sie eine dynamische Gruppe, und hängen Sie eine Policy an

      Erstellen Sie als Nächstes eine dynamische Management Agent-Gruppe mit der folgenden Policy.
      1. Erstellen Sie eine dynamische Gruppe für die Management Agents, falls sie noch nicht vorhanden ist. Beispiel: Management-Agent-Dynamic-Group. Ersetzen Sie <AGENT_COMPARTMENT_OCID> durch die Compartment-OCID für den Management Agent. 
        ALL {resource.type='managementagent' resource.compartment.id='<AGENT_COMPARTMENT_OCID>'}
      2. Hängen Sie die folgende Policy an, damit der Agent die Metriken im OCI Monitoring-Namespace posten kann. 
        allow dynamic-group Management-Agent-Dynamic-Group to use metrics in compartment <METRIC_COMPARTMENT_OCID> where target.metrics.namespace = '<OCI_MONITORING_NAMESPACE>'
      Hinweis

      Wenn Sie die Metriken sofort anzeigen möchten, müssen Sie den Management Agent neu starten.
      Weitere Informationen zu dynamischen Gruppen finden Sie unter Dynamische Gruppen verwalten und Policys verwalten.

      Schritt 2. Prometheus-Metriken aktivieren

      Um Prometheus-Metriken für die Software oder Hardware zu aktivieren, gehen Sie zu den offiziellen Anweisungen für das, was Sie überwachen möchten, um zu bestimmen, welche Methode verwendet werden soll.

      Beispiel: In diesem Blogpost wird So konfigurieren Sie Docker-Container in Oracle Cloud für die Verwendung von Prometheus-Metriken erläutert. In diesem Beispiel enthalten die Docker-Anweisungen auf der offiziellen Website die neuesten Anweisungen zum Aktivieren von Prometheus in einem Docker-Container.

      Schritt 3. Prometheus-Datenquelle konfigurieren

      Als Nächstes können Sie in Oracle Cloud den Management Agent so konfigurieren, dass Prometheus-Metriken erfasst werden, indem Sie eine Prometheus-Datenquelle in der Oracle Cloud-Konsole hinzufügen und konfigurieren.

      Dieses Video zeigt, wie Sie eine Prometheus-Datenquelle konfigurieren. In diesem Video wird eine Prometheus-Datenquelle für einen Kafka-Service konfiguriert. Der Prozess zum Hinzufügen, Bearbeiten und Konfigurieren einer Datenquelle in der Oracle Cloud-Konsole ist für jede Datenquelle identisch, die Prometheus-Metriken über eine URL bereitstellt.

      So hinzufügen und konfigurieren Sie eine Prometheus-Datenquelle:

      1. Gehen Sie in der Oracle Cloud-Konsole zum Navigationsmenü, wählen Sie Beobachtbarkeit und Management aus, gehen Sie zu Management-Agents, und wählen Sie Agents aus.
      2. Wählen Sie Agents und Gateways aus, wählen Sie das gewünschte Compartment aus, und wählen Sie dann den Agent aus.
      3. Wählen Sie Datenquellen verwalten, Datenquelle hinzufügen aus.
      4. Wählen Sie Prometheus aus der Dropdown-Liste Datenquellentyp aus, fügen Sie den Metrik-Namespace und die URL hinzu, und wählen Sie das Metrik-Compartment aus. Bei Bedarf können Sie Benutzerdefinierte Metrikdimensionen hinzufügen oder optionale Eigenschaften festlegen. Eine Liste der Optionen finden Sie unter Eigenschaften von erforderlichen Datenquellen und Eigenschaften von optionalen Datenquellen.
        Hinweis

        Der Metrik-Namespace und die Werte für das Metrik-Compartment müssen mit den Werten in der Policy übereinstimmen.

      5. Klicken Sie auf Hinzufügen.

        Wenn die Metriken jetzt korrekt konfiguriert sind, werden sie nach einigen Minuten im OCI Monitoring Service angezeigt.

        Hinweis

        Wenn die erforderlichen Policys fehlen, erhalten Sie HTTP 404 NotAuthorized-Fehlermeldungen in den Management Agent-Logs. Weitere Informationen finden Sie unter Dynamische Gruppe erstellen und Policy anhängen.

      So zeigen Sie eine Prometheus-Datenquelle an oder bearbeiten sie:

      Nachdem Sie eine Datenquelle hinzugefügt haben, können Sie zu Datenquellen verwalten gehen und dann die vertikale Ellipse neben der Datenquelle auswählen, die Sie anzeigen oder bearbeiten möchten.

Erforderliche Datenquelleneigenschaften

Die folgenden Eigenschaften sind erforderlich, wenn Sie eine Prometheus-Datenquelle erstellen.

Name Einheiten/Format Beschreibung
URL String Die URL, in der der Prometheus-Exporter seine Metriken veröffentlicht. Unterstützt nur HTTP-Anforderungen. Beispiel:

http://localhost:9100/metrics
Namespace String Der OCI-Monitoring-Namespace, in den die verteilten Metriken hochgeladen werden.
compartmentId String Die OCID des Compartments, in das die Ausschussmetriken hochgeladen werden.

Optionale Datenquelleneigenschaften

Die folgenden Eigenschaften sind optional, wenn Sie eine Prometheus-Datenquelle erstellen. Um einen spezifischeren Bereich von Prometheus-Metriken zu erfassen, können Sie beim Erstellen der Datenquelle eine dieser optionalen Eigenschaften hinzufügen.

Name Einheiten/Format Beschreibung
allowMetrics Zeichenfolge - kommagetrennte Metriknamenliste Der vollständige Satz der gewünschten Ausschussmetriken. Mit dieser Eigenschaft können Sie die Gruppe der hochgeladenen Metriken einschränken, falls erforderlich.
connection-timeout Anzahl in Millisekunden Der Timeout für die Verbindung zum Endpunkt des Prometheus-Exporters.
metricDimensions Zeichenfolge - durch Komma getrennte Eigenschaftsnamenliste Die Namen anderer vom Benutzer bereitgestellter Eigenschaften, ausgedrückt als feste Werte, die als Dimensionen für jeden hochgeladenen Datenpunkt verwendet werden sollen.
Proxy-URL Zeichenfolge - URL Die URL des Netzwerkproxys, der Zugriff auf den Endpunkt "URL erforderlich" des Prometheus Exporters ermöglicht.
Datengrenzwert lesen Anzahl in Kilobyte Das Limit für die gesendeten Daten. Beispiel: Wenn 400 KB eingegeben werden, überschreitet das feste Limit des Management Agent nicht 400 KB Festplattenspeicher.
Lese-Timeout Anzahl in Millisekunden Die Zeitüberschreitung beim Lesen der Antwort vom Endpunkt des Prometheus-Exporters.
resourceGroup Zeichenfolge. Er enthält nur alphanumerische Zeichen, Punkte (.), Unterstriche (_), Bindestriche (-) und Dollarzeichen ($). Die Ressourcengruppe des OCI Monitoring-Service.

Wenn sie angegeben ist, wird die Ressourcengruppe jeder ausgegebenen Metrik zugewiesen.
scheduleMins Ausschussintervall in Minuten Wenn dieser Wert angegeben ist, erfolgt die Datenerfassung oder das Scraping in diesem bestimmten Zeitintervall.

Der Mindestwert ist 1 Minute.

Wenn dieser Wert nicht angegeben ist, ist der Standardwert 5 Minuten.

Hinweis: Eine Senkung des Erfassungsintervalls kann sich positiv auf die CPU-Performance auswirken.

Beispiel: scheduleMins=1

Prometheus-Dashboard erstellen

Nachdem Sie die oben beschriebenen Schritte ausgeführt haben, um den Management Agent zum Exportieren von Prometheus-Metriken einzurichten, können Sie mit dem OCI Management Dashboards-Service ein Dashboard erstellen und die Prometheus-Metriken visualisieren. Sie können ein Metrikdaten-Explorer-Widget für jede Metrik konfigurieren, die Sie visualisieren möchten. Weitere Informationen finden Sie unter Explorer-Widget für Metrikdaten erstellen.