Einrichtung der Beobachtbarkeit für Flotten

Die Protokollierung und Überwachung kann Ihnen bei der Fehlerbehebung unter IBM Cloud® Code Engine helfen und einen Einblick in die Leistung Ihres Workloads geben. Die Einrichtung der Protokollierung und Überwachung für Flotten erfolgt auf Projektebene und unterscheidet sich von anderen Funktionen von Code Engine.

Protokollierung und Überwachung sind optional und können jederzeit nach der Erstellung einer Flotte eingerichtet werden.

Einrichtung der Protokollierung für Flotten

Die Protokollierung für Flotten wird auf Projektebene eingerichtet. Nachdem Sie diese Einrichtungsschritte für ein Projekt durchgeführt haben, ist die Protokollierung für alle Flotten in diesem Projekt verfügbar.

1. Stellen Sie sicher, dass eine Instanz des Cloud Logs-Dienstes vorhanden ist

Sie müssen über eine Instanz des Cloud Logs-Dienstes verfügen, die auf die Region des Projekts Code Engine ausgerichtet ist, in der Ihre Flotten laufen. Um Ihre vorhandenen Cloud Logs-Service-Instanzen zu überprüfen, navigieren Sie zur Seite Logging-Routing in der Benutzeroberfläche und identifizieren Sie die Instanz, die auf die betreffende Region abzielt. Wenn die Region nicht über eine gezielte Protokollierungsinstanz verfügt, folgen Sie den Aufforderungen der Benutzeroberfläche, um eine solche festzulegen.

2. Legen Sie die Berechtigungen für die Cloud Logs-Instanz fest

Vergewissern Sie sich, dass Sie eine Service-ID und einen API-Schlüssel haben, die den Zugriff auf die Cloud Logs-Instanz zuweisen, und legen Sie die erforderlichen Berechtigungen fest.

  1. Erstellen Sie eine Service-ID. Weisen Sie dann der Service-ID eine Zugriffsrichtlinie zu, die auf die Cloud Logs-Instanz in Ihrem Konto abzielt. Weisen Sie dieser Zugriffsrichtlinie die Zugriffsebene Absenderdienst zu.
  2. Erstellen Sie einen API-Schlüssel für die Dienst-ID. Speichern Sie den API-Schlüssel an einem sicheren Ort, damit Sie ihn später wieder aufrufen können.

3. Abrufen des privaten Ingress-Endpunkts für die Cloud Logs-Instanz

Abrufen des privaten Ingress-Endpunkts für die Cloud Logs-Instanz.

  1. Navigieren Sie in der Benutzeroberfläche zur Seite Protokollierungsinstanzen und klicken Sie auf die entsprechende Instanz.
  2. Klicken Sie auf „ Endpunkte “.
  3. Suchen Sie den privaten Ingress-Endpunkt. Speichern Sie diesen Wert an einem sicheren Ort, damit Sie ihn später abrufen können.

4. Erstellen eines virtuellen privaten Endpunkt-Gateways, das eine Verbindung zur Protokollierungsinstanz herstellt

Erstellen Sie ein virtuelles privates Endpunkt-Gateway, das mit der Protokollierungsinstanz verbunden ist. Dieses VPE-Gateway muss in der VPC erstellt werden, in der Ihre Flotten laufen.

  1. Navigieren Sie in der Konsole zur Seite VPE-Gateways.
  2. Klicken Sie auf Erstellen.
  3. Wählen Sie den Standort und die Region, in der Ihre Cloud Logs-Instanz existiert.
  4. Wählen Sie die VPC, in der Ihre Flotten laufen.
  5. Verbinden Sie den Dienst mit Ihrer Cloud Logs-Instanz.
    1. Wählen Sie im Abschnitt Verbindung zu einem Dienst anfordern die Option IBM Cloud Dienst.
    2. Wählen Sie unter Cloud-Serviceangebote die Option Cloud-Protokolle.
    3. Wählen Sie unter Cloud-Service-Regionen die Region aus, in der sich Ihre Cloud Logs-Instanz befindet.
    4. Wählen Sie in der Tabelle die entsprechende Cloud Logs-Instanz aus, um eine Verbindung mit dem VPE herzustellen.
  6. Klicken Sie auf Erstellen.

5. Reservierte IP-Adressen im VPE-Gateway anlegen

Fügen Sie für jede Zone im VPE eine reservierte IP-Adresse zu einem Subnetz hinzu.

  1. Navigieren Sie in der Konsole zur Seite VPE-Gateways.
  2. Klicken Sie auf das VPE, das Sie im vorherigen Schritt erstellt haben.
  3. Klicken Sie auf „ Angehängte Ressourcen verwalten “.
  4. Klicken Sie auf „Reservieren“ oder „IP zuweisen “.
  5. Befolgen Sie die Eingabeaufforderungen, um eine IP-Adresse für ein Subnetz in einer der VPE-Zonen zu reservieren.
  6. Wiederholen Sie diesen Vorgang für ein Subnetz in jeder VPE-Zone.

6. Hinzufügen der Protokollierungswerte zum Standardgeheimnis der Flotte

Fügen Sie die erforderlichen Protokollierungswerte zum Standardgeheimnis der Flotte hinzu.

  1. Gehen Sie in der Konsole auf die Seite Code Engine projects und wählen Sie das Projekt aus, in dem Ihre Flotten laufen.
  2. Klicken Sie auf „Secrets“ und „Configmaps “.
  3. Klicken Sie auf das Geheimnis codeengine-fleet-defaults.
    1. Wenn sie noch nicht erstellt wurde: Klicken Sie auf Erstellen.
    2. Wählen Sie Generisches Geheimnis und klicken Sie dann auf Weiter.
    3. Nennen Sie das Geheimnis codeengine-fleet-defaults. Sie müssen genau diese Bezeichnung und Formatierung verwenden.
  4. Fügen Sie die in der folgenden Tabelle aufgeführten Schlüssel-Wert-Paare hinzu. Beachten Sie, dass die Seiten logging_sender_api_key und logging_ingress_endpoint in früheren Schritten gespeichert wurden.
Protokollierung von Schlüssel-Wert-Paaren für das Standardgeheimnis der Flotte.
Schlüssel Wert
logging_ingress_endpoint Der private Ingress-Endpunkt für die Cloud Logs-Instanz. Dieser Wert wurde in einem früheren Schritt gespeichert.
logging_sender_api_key Der API-Schlüssel für die Service-ID, die auf die Cloud Logs-Instanz abzielt. Dieser Wert wurde in einem früheren Schritt gespeichert.
logging_ingress_port Der Port, der für die Verbindung mit der Cloud Logs-Instanz verwendet wird. Für private VPEs geben Sie bitte 443 an.
logging_level_worker Die Detailtiefe, die Sie in Ihre Mitarbeiterprotokolle aufnehmen möchten. Zu den akzeptierten Ebenen gehören: DEBUG, INFO, WARN, und ERROR. Standardeinstellung: WARN.
logging_level_agent Die Detailtiefe, die Sie in Ihre Flottenagentenprotokolle aufnehmen möchten. Zu den akzeptierten Ebenen gehören: DEBUG, INFO, WARN, und ERROR. Standardeinstellung: WARN.

7. Einsicht in die Logs Ihrer Flotte

Jetzt, wo die Protokollierung für Flotten in Ihrem Code Engine Projekt eingerichtet ist, können Sie Ihre Flottenprotokolle einsehen. Weitere Informationen finden Sie unter Anzeigen von Protokollen und Überwachungsdaten für Fuhrparks.

Einrichtung der Flottenüberwachung

Die Überwachung der Flotten wird auf Projektebene eingerichtet. Nachdem Sie diese Einrichtungsschritte für ein Projekt durchgeführt haben, ist die Überwachung für alle Flotten in diesem Projekt verfügbar.

1. Stellen Sie sicher, dass Sie eine bestehende Clouds Monitoring-Instanz haben

Sie müssen eine Cloud Monitoring Instanz in der gleichen Region des Code Engine Projekts haben, zu dem Ihre Flotte gehört. Um Ihre vorhandenen Cloud Monitoring Service-Instanzen zu überprüfen, navigieren Sie zur Seite Überwachungsinstanzen in der Benutzeroberfläche und identifizieren eine Instanz in der entsprechenden Region. Wenn Sie keine geeignete Instanz haben, folgen Sie den Anweisungen der Benutzeroberfläche, um eine zu erstellen.

2. Abrufen des Schlüssels des Überwachungsagenten

Suchen Sie den Agentenschlüssel für die Überwachungsinstanz.

  1. Navigieren Sie zur Seite Überwachungsinstanzen in der Benutzeroberfläche und klicken Sie auf die entsprechende Instanz. Klicken Sie auf der Seite mit den Instanzdetails auf Aktionen > Schlüssel verwalten und dann auf die Option zum Anzeigen aller Schlüssel im Dashboard.
  2. Klicken Sie auf den Agentenschlüssel, der ein ähnliches Format wie ab1c2345-****-678d9efgh012 haben kann. Klicken Sie dann auf die Option zum Kopieren des vollständigen Agentenschlüssels.
  3. Speichern Sie den Agentenschlüssel an einem sicheren Ort, an dem Sie später darauf zugreifen können.

3. Erstellen eines virtuellen privaten Endpunkt-Gateways, das mit der Überwachungsinstanz verbunden ist

Erstellen Sie ein virtuelles privates Endpunkt-Gateway, das mit der Überwachungsinstanz verbunden ist. Dieses VPE-Gateway muss in der VPC erstellt werden, in der Ihre Flotten laufen.

  1. Navigieren Sie in der Konsole zur Seite VPE-Gateways.
  2. Klicken Sie auf Erstellen.
  3. Wählen Sie den Standort und die Region aus, in der sich Ihre „ Cloud Monitoring “-Instanz befindet.
  4. Wählen Sie die VPC, in der Ihre Flotten laufen.
  5. Verbinden Sie den Dienst mit Ihrer „ Cloud Monitoring “-Instanz.
    1. Wählen Sie im Abschnitt Verbindung zu einem Dienst anfordern die Option IBM Cloud Dienst.
    2. Wählen Sie unter **Cloud-Serviceangebote **Cloud Monitoring.
    3. Wählen Sie unter Cloud-Service-Regionen die Region aus, in der sich Ihre Cloud Monitoring-Instanz befindet.
    4. Wählen Sie aus der Tabelle die entsprechende Cloud Monitoring Instanz aus, um sich mit dem VPE zu verbinden.
  6. Klicken Sie auf Erstellen.

4. Reservierte IP-Adressen im VPE-Gateway anlegen

Fügen Sie für jede Zone im VPE eine reservierte IP-Adresse zu einem Subnetz hinzu.

  1. Navigieren Sie in der Konsole zur Seite VPE-Gateways.
  2. Klicken Sie auf das VPE, das Sie im vorherigen Schritt erstellt haben.
  3. Klicken Sie auf „ Angehängte Ressourcen verwalten “.
  4. Klicken Sie auf „Reservieren“ oder „IP zuweisen “.
  5. Befolgen Sie die Eingabeaufforderungen, um eine IP-Adresse für ein Subnetz in einer der VPE-Zonen zu reservieren.
  6. Wiederholen Sie diesen Vorgang für ein Subnetz in jeder VPE-Zone.

5. Hinzufügen von Überwachungswerten zum Standardgeheimnis der Flotte

  1. Gehen Sie in der Konsole auf die Seite Code Engine projects und wählen Sie das Projekt aus, in dem Ihre Flotten laufen.
  2. Klicken Sie auf „Secrets“ und „Configmaps “.
  3. Klicken Sie auf das Geheimnis codeengine-fleet-defaults.
    1. Wenn sie noch nicht erstellt wurde: Klicken Sie auf Erstellen.
    2. Wählen Sie Generisches Geheimnis und klicken Sie dann auf Weiter.
    3. Nennen Sie das Geheimnis codeengine-fleet-defaults. Sie müssen genau diese Bezeichnung und Formatierung verwenden.
  4. Fügen Sie die in der folgenden Tabelle aufgeführten Schlüssel-Wert-Paare hinzu. Beachten Sie, dass die monitoring_ingestion_key in einem früheren Schritt gespeichert wurde.
Protokollierung von Schlüssel-Wert-Paaren für das Standardgeheimnis der Flotte.
Schlüssel Wert
monitoring_ingestion_region Die Region, in der die Instanz Cloud Monitoring existiert. Beispiel: au-syd.
monitoring_ingestion_key Der Schlüssel des Überwachungsagenten. Dieser Wert wurde in einem früheren Schritt ermittelt.

6. Anzeige der Flottendaten im Überwachungs-Dashboard

Jetzt, wo die Überwachung für Flotten in Ihrem Code Engine Projekt eingerichtet ist, können Sie Ihre Flottenüberwachungsdaten einsehen. Weitere Informationen finden Sie unter Anzeigen von Protokollen und Überwachungsdaten für Fuhrparks.