Monitoring für Compute-Instanzen aktivieren

In diesem Thema wird beschrieben, wie Sie Monitoring speziell für die Compute-Instanzmetriken auf Compute-Instanzen aktivieren.

Die Metriken der Compute-Instanz liefern Daten zur Aktivitätsebene und zum Durchsatz der Instanz. Diese Metriken sind erforderlich, um Features wie Autoscaling, Metriken, Alarme und Benachrichtigungen mit Compute-Instanzen zu verwenden. Eine Compute-Instanz gibt diese Metriken nur aus, wenn das Compute Instance Monitoring-Plug-in aktiviert ist und auf der Instanz ausgeführt wird.

Das Compute Instance Monitoring-Plug-in wird von der Oracle Cloud Agent-Software verwaltet.

Unterstützte Images

Compute-Instanzmetriken werden auf aktuellen Plattformimages und auf benutzerdefinierten Images, die auf aktuellen Plattformimages basieren, unterstützt.

Wenn Sie ein älteres Plattformimage verwenden, müssen Sie die Oracle Cloud Agent-Software manuell installieren, bevor Sie das Compute Instance Monitoring-Plug-in verwenden können. Wählen Sie ein Image mit einem Datum nach dem 15. November 2018 aus (mit Ausnahme von Ubuntu, dessen Datum nach dem 28. Februar 2019 liegen muss).

Möglicherweise können Compute-Instanzmetriken auf anderen Images, die die Oracle Cloud Agent-Software unterstützen, erfolgreich aktiviert werden, obwohl das Compute Instance Monitoring-Plug-in nicht auf anderen Betriebssystemen getestet wurde und keine Garantie besteht, dass es funktioniert.

Erforderliche IAM-Policy

Um Oracle Cloud Infrastructure zu verwenden, muss Ihnen ein Administrator in einer Policy Sicherheitszugriff erteilen. Dieser Zugriff ist erforderlich, unabhängig davon, ob Sie die Konsole oder die REST-API mit einem SDK, einer CLI oder einem anderen Tool verwenden. Wenn Sie eine Meldung erhalten, dass Sie keine Berechtigung haben oder nicht autorisiert sind, fragen Sie den Administrator, welcher Zugriffstyp Ihnen erteilt wurde und in welchem Compartment Sie arbeiten sollen.

Administratoren: Weitere Informationen zu den IAM-Policys, die zum Erstellen und Aktualisieren einer Compute-Instanz erforderlich sind, finden Sie unter Instanzen erstellen.

Bevor Sie beginnen

Servicegateways oder öffentliche IP-Adressen: Die Compute-Instanz muss entweder über eine öffentliche IP-Adresse oder über ein Servicegateway verfügen, um Compute-Instanzmetriken an Monitoring senden zu können.

Wenn die Instanz keine öffentliche IP-Adresse hat, richten Sie ein Servicegateway im virtuellen Cloud-Netzwerk (VCN) ein. Mit dem Servicegateway kann die Instanz Compute-Instanzmetriken an Monitoring senden, ohne dass der Traffic über das Internet geleitet wird. Hier finden Sie besondere Hinweise zur Einrichtung des Servicegateways für den Zugriff auf Monitoring:
- Aktivieren Sie beim Erstellen des Servicegateways das Servicelabel Alle <Region>-Services in Oracle Services Network. Es enthält Monitoring.
- Richten Sie beim Einrichten des Routings für das Subnetz mit der Instanz eine Routingregel ein, bei welcher der Zieltyp auf Servicegateway und der Zielservice auf Alle <Region>-Services in Oracle Services Network gesetzt ist.
Nähere Anweisungen dazu finden Sie unter Zugriff auf Oracle-Services: Servicegateway.
Oracle Cloud Agent: Die Oracle Cloud Agent-Software muss auf der Instanz installiert sein. Oracle Cloud Agent wird standardmäßig auf aktuellen Plattformimages installiert. Schritte zur manuellen Installation von Oracle Cloud Agent auf älteren Images finden Sie unter Oracle Cloud Agent-Software installieren.
Compute Instance Monitoring-Plug-in: Damit die Instanz die Compute-Instanzmetriken ausgibt, muss das Compute Instance Monitoring-Plug-in auf der Instanz aktiviert sein, und Plug-ins müssen ausgeführt werden. Weitere Informationen zum Aktivieren und Ausführen von Plug-ins finden Sie unter Oracle Cloud Agent.

Monitoring für neue Compute-Instanzen aktivieren

Um eine neue Compute-Instanz so zu konfigurieren, dass sie die Compute-Instanzmetriken ausgibt, gehen Sie wie folgt vor:

Monitoringfähige Instanzen mit der Konsole erstellen

Befolgen Sie die Schritte unter Instanzen erstellen bis zu den erweiterten Optionen. Stellen Sie sicher, dass die Instanz entweder über eine öffentliche IP-Adresse oder ein Servicegateway verfügt, wie in den Voraussetzungen beschrieben.
Klicken Sie auf Erweiterte Optionen anzeigen.
Wählen Sie auf der Registerkarte Oracle Cloud Agent die Option Compute-Instanzmonitoring aus.

Hinweis

Wenn Sie ein älteres Plattformimage oder ein benutzerdefiniertes Image verwenden, das nicht auf einem aktuellen Plattformimage basiert, müssen Sie die Oracle Cloud Agent-Software manuell installieren. Geben Sie dazu ein cloud-init-Skript an. Weitere Informationen finden Sie unter Oracle Cloud Agent-Software installieren. Vergleichen Sie das Datum des Images mit dem unter Unterstützte Images aufgelisteten Datum.
Klicken Sie auf Erstellen.

Die neu erstellte monitoringfähige Instanz gibt Compute-Instanzmetriken an den Monitoring-Service aus.

Monitoringfähige Instanz mit der API erstellen

Verwenden Sie den Vorgang LaunchInstance. Nehmen Sie folgende Parameter auf:

{
  "agentConfig": {
    "isMonitoringDisabled": false,
    "areAllPluginsDisabled": false,
    "pluginsConfig": [
      {
        "name": "Compute Instance Monitoring",
        "desiredState": "ENABLED"
      }
    ]
  }
}

Stellen Sie sicher, dass die Instanz entweder über eine öffentliche IP-Adresse oder ein Servicegateway verfügt, wie in den Voraussetzungen beschrieben.

Hinweis

Wenn Sie ein älteres Plattformimage oder ein benutzerdefiniertes Image verwenden, das nicht auf einem aktuellen Plattformimage basiert, müssen Sie die Oracle Cloud Agent-Software manuell installieren. Geben Sie dazu ein cloud-init-Skript an. Weitere Informationen finden Sie unter Oracle Cloud Agent-Software installieren. Vergleichen Sie das Datum des Images mit dem unter Unterstützte Images aufgelisteten Datum.

Monitoring für vorhandene Compute-Instanzen aktivieren

Um eine vorhandene Compute-Instanz so zu konfigurieren, dass sie die Compute-Instanzmetriken ausgibt, gehen Sie wie folgt vor.

So aktivieren Sie Monitoring einer vorhandenen Compute-Instanz mit der Konsole

Installieren Sie die Oracle Cloud Agent-Software, wenn sie noch nicht installiert ist.
Aktivieren Sie das Compute Instance Monitoring-Plug-in.
Bestätigen Sie, dass Plug-ins auf der Instanz ausgeführt werden.
Stellen Sie sicher, dass die Instanz entweder über eine öffentliche IP-Adresse oder ein Servicegateway verfügt, wie in den Voraussetzungen beschrieben.
So bestätigen Sie, dass Monitoring aktiviert ist:
1. Gehen Sie zur Seite "Metriken" für die Instanz:
  1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Compute. Klicken Sie unter Compute auf Instanzen.
  2. Klicken Sie auf die gewünschte Instanz.
  3. Klicken Sie unter Ressourcen auf Metriken.
  4. Wählen Sie in der Liste Metrik-Namespace den Eintrag oci_computeagent aus.
2. Wenn Metrikdiagramme mit Daten angezeigt werden, empfängt der Monitoring-Service die Compute-Instanzmetriken von dieser Instanz. Weitere Informationen zu diesen Metriken finden Sie unter Compute-Instanzmetriken.
  
  Wenn Monitoring nicht aktiviert ist (und die Instanz ein unterstütztes Image verwendet), ist eine Schaltfläche zur Aktivierung des Monitorings verfügbar. Klicken Sie auf Monitoring aktivieren.

So aktivieren Sie Monitoring auf einer vorhandenen Compute-Instanz mit der API

Installieren Sie die Oracle Cloud Agent-Software, wenn sie noch nicht installiert ist.

Verwenden Sie den Vorgang UpdateInstance. Nehmen Sie folgende Parameter auf:

{
  "agentConfig": {
    "isMonitoringDisabled": false,
    "areAllPluginsDisabled": false,
    "pluginsConfig": [
      {
        "name": "Compute Instance Monitoring",
        "desiredState": "ENABLED"
      }
    ]
  }
}

Stellen Sie sicher, dass die Instanz entweder über eine öffentliche IP-Adresse oder ein Servicegateway verfügt, wie in den Voraussetzungen beschrieben.

Compute Instance Monitoring-Plug-in verwalten

Damit eine Instanz die Compute-Instanzmetriken ausgibt, muss das Compute Instance Monitoring-Plug-in auf der Instanz aktiviert sein, und Plug-ins müssen ausgeführt werden.

Wenn Sie vorübergehend verhindern möchten, dass die Instanz Compute-Instanzmetriken ausgibt, können Sie das Compute Instance Monitoring-Plug-in deaktivieren. Sie können auch alle Plug-ins stoppen, die auf der Instanz ausgeführt werden, einschließlich des Compute Instance Monitoring-Plug-ins.

Achtung

Funktionen, die vom Plug-in abhängen, wie Monitoring und Autoscaling, sind nicht verfügbar, wenn das Plug-in deaktiviert oder gestoppt ist.

Weitere Informationen zum Aktivieren und Ausführen von Plug-ins finden Sie unter Oracle Cloud Agent.

Fehlerbehebung: Überprüfen, ob Monitoring Ihre Metriken erfasst

Um festzustellen, ob Monitoring die Compute-Instanzmetriken empfängt, können Sie entweder die Instanzmetriken abfragen oder die Instanzeigenschaften anzeigen, um zu bestätigen, dass das Compute Instance Monitoring-Plug-in aktiviert ist und ausgeführt wird.

Konsole verwenden: So ermitteln Sie durch Abfragen der Instanzmetriken, ob Monitoring Metriken empfängt

Öffnen Sie das Navigationsmenü, und klicken Sie auf Compute. Klicken Sie unter Compute auf Instanzen.
Klicken Sie auf die gewünschte Instanz.
Klicken Sie unter Ressourcen auf Metriken.
Wählen Sie in der Liste Metrik-Namespace den Eintrag oci_computeagent aus.

Wenn Metrikdiagramme mit Daten angezeigt werden, empfängt Monitoring die Metriken von dieser Instanz. Weitere Informationen zu diesen Metriken finden Sie unter Compute-Instanzmetriken.

Wenn eine Meldung angezeigt wird, dass Monitoring nicht aktiviert ist oder die Oracle Cloud Agent-Software installiert werden muss, führen Sie diese Aufgaben aus.

Konsole verwenden: So ermitteln Sie, ob das Compute Instance Monitoring-Plug-in aktiviert ist und ausgeführt wird

Öffnen Sie das Navigationsmenü, und klicken Sie auf Compute. Klicken Sie unter Compute auf Instanzen.
Klicken Sie auf die gewünschte Instanz.
Klicken Sie auf die Registerkarte Oracle Cloud Agent.
Überprüfen Sie, ob das Compute Instance Monitoring-Plug-in aktiviert ist und alle Plug-ins ausgeführt werden.

API verwenden: So ermitteln Sie durch Abfragen der Instanzmetriken, ob Monitoring Metriken empfängt

Verwenden Sie den API-Vorgang SummarizeMetricsData. Wenn Metriken zurückgegeben werden, bedeutet dies, dass Monitoring Metriken von der Instanz empfängt.

API verwenden: So ermitteln Sie, ob das Compute Instance Monitoring-Plug-in aktiviert ist und ausgeführt wird

Verwenden Sie den Vorgang GetInstance (bzw. den Vorgang ListInstances für mehrere Instanzen).

Wenn das agentConfig-Objekt in der Antwort die folgenden Werte zurückgibt, bedeutet dies, dass das Compute Instance Monitoring-Plug-in aktiviert ist und alle Plug-ins ausgeführt werden.

{
  "agentConfig": {
    "isMonitoringDisabled": false,
    "areAllPluginsDisabled": false,
    "pluginsConfig": [
      {
        "name": "Compute Instance Monitoring",
        "desiredState": "ENABLED"
      }
    ]
  }
}

Die Metriken für Ihre Instanz werden nicht angezeigt?

Wenn keine Metrikdiagramme angezeigt werden, gibt die Instanz möglicherweise keine Metriken aus. Nachfolgend sind mögliche Ursachen und Lösungen aufgeführt.


Mögliche Ursache	Prüfmethode	Lösung
Das Compute Instance Monitoring-Plug-in ist auf der Instanz deaktiviert, oder Plug-ins wurden gestoppt.	Prüfen Sie die Instanzeigenschaften.	Aktivieren Sie das Compute Instance Monitoring-Plug-in, und starten Sie alle Plug-ins.
Die Instanz kann nicht auf den Monitoring-Service zugreifen, weil das VCN das Internet nicht verwendet.	Prüfen Sie die IP-Adresse der Instanz. Wenn sie nicht öffentlich ist, ist ein Servicegateway erforderlich.	Richten Sie ein Servicegateway ein.
Die Instanz verwendet kein unterstütztes Image.	Prüfen Sie die unterstützten Images.	Erstellen Sie eine Instanz mit einem unterstützten Image.
Ältere Images und benutzerdefinierte Images: Auf der Instanz ist keine Oracle Cloud Agent-Software vorhanden.	Stellen Sie eine Verbindung zur Instanz her, und suchen Sie nach der Software.	Installieren Sie die Oracle Cloud Agent-Software.
Bei der Oracle Cloud Agent-Software ist ein anderer Fehler aufgetreten.	(Nicht zutreffend)	Befolgen Sie die Schritte zur Fehlerbehebung für Oracle Cloud Agent.

Oracle Cloud Infrastructure - Dokumentation